--- /srv/reproducible-results/rbuild-debian/r-b-build.uR9oBWHY/b1/grub2_2.06-13+deb12u1_amd64.changes +++ /srv/reproducible-results/rbuild-debian/r-b-build.uR9oBWHY/b2/grub2_2.06-13+deb12u1_amd64.changes ├── Files │ @@ -1,36 +1,36 @@ │ │ 68101a33c35025a1057c85a26a7db269 12320304 debug optional grub-common-dbgsym_2.06-13+deb12u1_amd64.deb │ 91171573aa5b430d77f5205adad0a00d 2708792 admin optional grub-common_2.06-13+deb12u1_amd64.deb │ - 037d7dec6ca979ab7807a107db5bbbd3 634884 admin optional grub-coreboot-bin_2.06-13+deb12u1_amd64.deb │ + a5167c12e3eaa6e6cc4905999233bbce 635100 admin optional grub-coreboot-bin_2.06-13+deb12u1_amd64.deb │ de4a798d6d0ca6e354da830d2556a081 2907016 debug optional grub-coreboot-dbg_2.06-13+deb12u1_amd64.deb │ e052fbaecdb9dc080d90914a9e20819c 45648 admin optional grub-coreboot_2.06-13+deb12u1_amd64.deb │ - 13d9ee24b39559a1dffa8bc12fe3f3cb 1573932 admin optional grub-efi-amd64-bin_2.06-13+deb12u1_amd64.deb │ + 1d8a1df276ba8b5ffae24180f3a1a57f 1577772 admin optional grub-efi-amd64-bin_2.06-13+deb12u1_amd64.deb │ f25de8f6a25b0ad8cb99e45672af1a9a 3483076 debug optional grub-efi-amd64-dbg_2.06-13+deb12u1_amd64.deb │ 33811d30d11cdb0a43bd065134541c06 184080 admin optional grub-efi-amd64-signed-template_2.06-13+deb12u1_amd64.deb │ 8d310aecf313d9b01a812b336e2fb2d5 45660 admin optional grub-efi-amd64_2.06-13+deb12u1_amd64.deb │ - d3d5647acfe49f9e8c4fd8f39335c1cd 1464108 admin optional grub-efi-ia32-bin_2.06-13+deb12u1_amd64.deb │ + 34a296ef6341a61f908d71505be28e12 1463644 admin optional grub-efi-ia32-bin_2.06-13+deb12u1_amd64.deb │ 6d36a7d187406863c82ff2f6b83ae743 3146512 debug optional grub-efi-ia32-dbg_2.06-13+deb12u1_amd64.deb │ 9980b5769fbcf61bb82b5f30df2d1e44 45688 admin optional grub-efi-ia32_2.06-13+deb12u1_amd64.deb │ f0980b55dc9e0719dc6887a29d830673 2388 admin optional grub-efi_2.06-13+deb12u1_amd64.deb │ 45ec9d4cdae92cfed5ac17b9568b93dd 2720532 debug optional grub-emu-dbg_2.06-13+deb12u1_amd64.deb │ 6032c7fe758dfac5e25eb37007c0eaf4 34364 debug optional grub-emu-dbgsym_2.06-13+deb12u1_amd64.deb │ - fe830ed768b33a8d7fd03f512388ec35 4225668 admin optional grub-emu_2.06-13+deb12u1_amd64.deb │ - e1d6be85381c6c474e23bd98e2c6e6ec 781848 admin optional grub-firmware-qemu_2.06-13+deb12u1_amd64.deb │ - e3d3e11840ba4fc77e8511361f7247e7 621552 admin optional grub-ieee1275-bin_2.06-13+deb12u1_amd64.deb │ + c2fb1bc6939069876ae58dcb228e3c24 4224428 admin optional grub-emu_2.06-13+deb12u1_amd64.deb │ + 6fae06305f06ab4e60cc39b43789490d 781840 admin optional grub-firmware-qemu_2.06-13+deb12u1_amd64.deb │ + f2bf17a0ce82c1091107adf8db9dabdd 621592 admin optional grub-ieee1275-bin_2.06-13+deb12u1_amd64.deb │ 91b07d78b197190a83207a0f03a54369 2873784 debug optional grub-ieee1275-dbg_2.06-13+deb12u1_amd64.deb │ fd01e4c9121918f4d47d399d50056254 45652 admin optional grub-ieee1275_2.06-13+deb12u1_amd64.deb │ 60f4305dbf7fbf4573b257298a92a56f 2360 oldlibs optional grub-linuxbios_2.06-13+deb12u1_amd64.deb │ c6226141cc0a5b9c59602fc0551d6918 425996 debian-installer optional grub-mount-udeb_2.06-13+deb12u1_amd64.udeb │ 9e850e4eafdda07a80d59ed267d4e38d 1197548 debug optional grub-pc-bin-dbgsym_2.06-13+deb12u1_amd64.deb │ - 9c80d5cce9244a0facf425e291115a23 997184 admin optional grub-pc-bin_2.06-13+deb12u1_amd64.deb │ + f5c2c85d1b8779e383743f5f2709efcc 997232 admin optional grub-pc-bin_2.06-13+deb12u1_amd64.deb │ d6a1a3638d3f7b630059697abdb1b426 3133304 debug optional grub-pc-dbg_2.06-13+deb12u1_amd64.deb │ c81d3c72ea365c9aed63c4b8f2d4a7b0 136504 admin optional grub-pc_2.06-13+deb12u1_amd64.deb │ - 6d65323c70feda3de04e4c5571806d1d 2491400 admin optional grub-rescue-pc_2.06-13+deb12u1_amd64.deb │ + addcc524688a0ad426359e382c3161cf 2491368 admin optional grub-rescue-pc_2.06-13+deb12u1_amd64.deb │ 29fef7a425f776b35aed429e985b09f3 2155240 admin optional grub-theme-starfield_2.06-13+deb12u1_amd64.deb │ - 87484c211d43fcce8fa9a2df20763e11 1012768 admin optional grub-xen-bin_2.06-13+deb12u1_amd64.deb │ + 28ea59af7ad9aae9dc21d59268d28568 1012620 admin optional grub-xen-bin_2.06-13+deb12u1_amd64.deb │ af7bd0679206a467758fecdf653a4099 7389024 debug optional grub-xen-dbg_2.06-13+deb12u1_amd64.deb │ - bc483d03d267be95967000c7c7f6afd3 1176788 admin optional grub-xen-host_2.06-13+deb12u1_amd64.deb │ + 826c3947a59a6771bb5855894ce58463 1176408 admin optional grub-xen-host_2.06-13+deb12u1_amd64.deb │ f246e22a1044352b4e6f804f41feba47 45612 admin optional grub-xen_2.06-13+deb12u1_amd64.deb │ b5d79ac7c187f424ca8760253dfe0e2a 1546864 debug optional grub2-common-dbgsym_2.06-13+deb12u1_amd64.deb │ - 09b02294dd973d358211695e963df98d 613996 admin optional grub2-common_2.06-13+deb12u1_amd64.deb │ + d08f312a19a732dbb6d9f78a068f6768 614000 admin optional grub2-common_2.06-13+deb12u1_amd64.deb │ 1dec584f327028dc072476c294b411fa 2364 oldlibs optional grub2_2.06-13+deb12u1_amd64.deb ├── grub-coreboot-bin_2.06-13+deb12u1_amd64.deb │ ├── file list │ │ @@ -1,3 +1,3 @@ │ │ -rw-r--r-- 0 0 0 4 2023-10-02 14:11:34.000000 debian-binary │ │ -rw-r--r-- 0 0 0 7388 2023-10-02 14:11:34.000000 control.tar.xz │ │ --rw-r--r-- 0 0 0 627304 2023-10-02 14:11:34.000000 data.tar.xz │ │ +-rw-r--r-- 0 0 0 627520 2023-10-02 14:11:34.000000 data.tar.xz │ ├── control.tar.xz │ │ ├── control.tar │ │ │ ├── ./md5sums │ │ │ │ ├── ./md5sums │ │ │ │ │┄ Files differ │ ├── data.tar.xz │ │ ├── data.tar │ │ │ ├── file list │ │ │ │ @@ -146,15 +146,15 @@ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3692 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-coreboot/minix2.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3856 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-coreboot/minix2_be.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3692 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-coreboot/minix3.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3856 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-coreboot/minix3_be.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3724 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-coreboot/minix_be.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 5868 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-coreboot/mmap.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 4833 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-coreboot/moddep.lst │ │ │ │ --rwxr-xr-x 0 root (0) root (0) 2581 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-coreboot/modinfo.sh │ │ │ │ +-rwxr-xr-x 0 root (0) root (0) 2579 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-coreboot/modinfo.sh │ │ │ │ -rw-r--r-- 0 root (0) root (0) 2348 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-coreboot/morse.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 27896 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-coreboot/mpi.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 2396 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-coreboot/msdospart.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 2016 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-coreboot/mul_test.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 12892 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-coreboot/multiboot.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 14232 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-coreboot/multiboot2.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 4160 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-coreboot/nativedisk.mod │ │ │ ├── ./usr/lib/grub/i386-coreboot/modinfo.sh │ │ │ │ @@ -1,8 +1,8 @@ │ │ │ │ -#!/bin/bash │ │ │ │ +#!/bin/sh │ │ │ │ │ │ │ │ # User-controllable options │ │ │ │ grub_modinfo_target_cpu=i386 │ │ │ │ grub_modinfo_platform=coreboot │ │ │ │ grub_disk_cache_stats=0 │ │ │ │ grub_boot_time_stats=0 │ │ │ │ grub_have_font_source=1 ├── grub-efi-amd64-bin_2.06-13+deb12u1_amd64.deb │ ├── file list │ │ @@ -1,3 +1,3 @@ │ │ -rw-r--r-- 0 0 0 4 2023-10-02 14:11:34.000000 debian-binary │ │ --rw-r--r-- 0 0 0 7868 2023-10-02 14:11:34.000000 control.tar.xz │ │ --rw-r--r-- 0 0 0 1565872 2023-10-02 14:11:34.000000 data.tar.xz │ │ +-rw-r--r-- 0 0 0 7860 2023-10-02 14:11:34.000000 control.tar.xz │ │ +-rw-r--r-- 0 0 0 1569720 2023-10-02 14:11:34.000000 data.tar.xz │ ├── control.tar.xz │ │ ├── control.tar │ │ │ ├── ./md5sums │ │ │ │ ├── ./md5sums │ │ │ │ │┄ Files differ │ ├── data.tar.xz │ │ ├── data.tar │ │ │ ├── file list │ │ │ │ @@ -157,15 +157,15 @@ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 5576 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-efi/minix2.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 5680 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-efi/minix2_be.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 5608 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-efi/minix3.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 5712 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-efi/minix3_be.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 5552 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-efi/minix_be.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 9320 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-efi/mmap.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 5237 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-efi/moddep.lst │ │ │ │ --rwxr-xr-x 0 root (0) root (0) 2505 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-efi/modinfo.sh │ │ │ │ +-rwxr-xr-x 0 root (0) root (0) 2503 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-efi/modinfo.sh │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-efi/monolithic/ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3854336 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-efi/monolithic/gcdx64.efi │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3862528 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-efi/monolithic/grubnetx64-installer.efi │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3862528 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-efi/monolithic/grubnetx64.efi │ │ │ │ -rw-r--r-- 0 root (0) root (0) 4198400 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-efi/monolithic/grubx64.efi │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3152 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-efi/morse.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 43544 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-efi/mpi.mod │ │ │ ├── ./usr/lib/grub/x86_64-efi/modinfo.sh │ │ │ │ @@ -1,8 +1,8 @@ │ │ │ │ -#!/bin/bash │ │ │ │ +#!/bin/sh │ │ │ │ │ │ │ │ # User-controllable options │ │ │ │ grub_modinfo_target_cpu=x86_64 │ │ │ │ grub_modinfo_platform=efi │ │ │ │ grub_disk_cache_stats=0 │ │ │ │ grub_boot_time_stats=0 │ │ │ │ grub_have_font_source=1 │ │ │ ├── ./usr/lib/grub/x86_64-efi/monolithic/gcdx64.efi │ │ │ │ ├── objdump │ │ │ │ │ @@ -423895,17 +423895,16 @@ │ │ │ │ │ 151ef9: add %al,(%rdx) │ │ │ │ │ 151efb: rclb $0xf8,(%rdx) │ │ │ │ │ 151efe: add $0x0,%al │ │ │ │ │ 151f00: and %al,(%rax) │ │ │ │ │ 151f02: add (%rax),%al │ │ │ │ │ ... │ │ │ │ │ 151f0c: addb $0x29,(%rax) │ │ │ │ │ - 151f0f: test %edx,%esi │ │ │ │ │ - 151f11: push %rdx │ │ │ │ │ - 151f12: hlt │ │ │ │ │ + 151f0f: loopne 0x151ef0 │ │ │ │ │ + 151f11: js 0x151ea6 │ │ │ │ │ 151f13: rex.WRX │ │ │ │ │ 151f14: rex.WRXB and %r9b,0x41(%r14) │ │ │ │ │ 151f18: rex.WRB │ │ │ │ │ 151f19: and %r12b,(%r8) │ │ │ │ │ 151f1c: and %ah,(%rax) │ │ │ │ │ 151f1e: rex.RX │ │ │ │ │ 151f1f: push %r12 │ │ │ ├── ./usr/lib/grub/x86_64-efi/monolithic/grubnetx64-installer.efi │ │ │ │ ├── objdump │ │ │ │ │ @@ -426186,17 +426186,16 @@ │ │ │ │ │ 153ca1: add %al,(%rdx) │ │ │ │ │ 153ca3: rclb $0xf8,(%rdx) │ │ │ │ │ 153ca6: add $0x0,%al │ │ │ │ │ 153ca8: and %al,(%rax) │ │ │ │ │ 153caa: add (%rax),%al │ │ │ │ │ ... │ │ │ │ │ 153cb4: addb $0x29,(%rax) │ │ │ │ │ - 153cb7: mov $0xf,%dh │ │ │ │ │ - 153cb9: push %rbx │ │ │ │ │ - 153cba: hlt │ │ │ │ │ + 153cb7: loop 0x153cd5 │ │ │ │ │ + 153cb9: jns 0x153c4e │ │ │ │ │ 153cbb: rex.WRX │ │ │ │ │ 153cbc: rex.WRXB and %r9b,0x41(%r14) │ │ │ │ │ 153cc0: rex.WRB │ │ │ │ │ 153cc1: and %r12b,(%r8) │ │ │ │ │ 153cc4: and %ah,(%rax) │ │ │ │ │ 153cc6: rex.RX │ │ │ │ │ 153cc7: push %r12 │ │ │ ├── ./usr/lib/grub/x86_64-efi/monolithic/grubnetx64.efi │ │ │ │ ├── objdump │ │ │ │ │ @@ -426185,17 +426185,16 @@ │ │ │ │ │ 153ca1: add %al,(%rdx) │ │ │ │ │ 153ca3: rclb $0xf8,(%rdx) │ │ │ │ │ 153ca6: add $0x0,%al │ │ │ │ │ 153ca8: and %al,(%rax) │ │ │ │ │ 153caa: add (%rax),%al │ │ │ │ │ ... │ │ │ │ │ 153cb4: addb $0x29,(%rax) │ │ │ │ │ - 153cb7: mov $0xf,%dh │ │ │ │ │ - 153cb9: push %rbx │ │ │ │ │ - 153cba: hlt │ │ │ │ │ + 153cb7: loop 0x153cd5 │ │ │ │ │ + 153cb9: jns 0x153c4e │ │ │ │ │ 153cbb: rex.WRX │ │ │ │ │ 153cbc: rex.WRXB and %r9b,0x41(%r14) │ │ │ │ │ 153cc0: rex.WRB │ │ │ │ │ 153cc1: and %r12b,(%r8) │ │ │ │ │ 153cc4: and %ah,(%rax) │ │ │ │ │ 153cc6: rex.RX │ │ │ │ │ 153cc7: push %r12 │ │ │ ├── ./usr/lib/grub/x86_64-efi/monolithic/grubx64.efi │ │ │ │ ├── objdump │ │ │ │ │ @@ -532707,17 +532707,16 @@ │ │ │ │ │ 1a65d1: add %al,(%rdx) │ │ │ │ │ 1a65d3: rclb $0xf8,(%rdx) │ │ │ │ │ 1a65d6: add $0x0,%al │ │ │ │ │ 1a65d8: and %al,(%rax) │ │ │ │ │ 1a65da: add (%rax),%al │ │ │ │ │ ... │ │ │ │ │ 1a65e4: addb $0x29,(%rax) │ │ │ │ │ - 1a65e7: test %edx,%esi │ │ │ │ │ - 1a65e9: push %rdx │ │ │ │ │ - 1a65ea: hlt │ │ │ │ │ + 1a65e7: loopne 0x1a65c8 │ │ │ │ │ + 1a65e9: js 0x1a657e │ │ │ │ │ 1a65eb: rex.WRX │ │ │ │ │ 1a65ec: rex.WRXB and %r9b,0x41(%r14) │ │ │ │ │ 1a65f0: rex.WRB │ │ │ │ │ 1a65f1: and %r12b,(%r8) │ │ │ │ │ 1a65f4: and %ah,(%rax) │ │ │ │ │ 1a65f6: rex.RX │ │ │ │ │ 1a65f7: push %r12 ├── grub-efi-ia32-bin_2.06-13+deb12u1_amd64.deb │ ├── file list │ │ @@ -1,3 +1,3 @@ │ │ -rw-r--r-- 0 0 0 4 2023-10-02 14:11:34.000000 debian-binary │ │ --rw-r--r-- 0 0 0 7888 2023-10-02 14:11:34.000000 control.tar.xz │ │ --rw-r--r-- 0 0 0 1456028 2023-10-02 14:11:34.000000 data.tar.xz │ │ +-rw-r--r-- 0 0 0 7884 2023-10-02 14:11:34.000000 control.tar.xz │ │ +-rw-r--r-- 0 0 0 1455568 2023-10-02 14:11:34.000000 data.tar.xz │ ├── control.tar.xz │ │ ├── control.tar │ │ │ ├── ./md5sums │ │ │ │ ├── ./md5sums │ │ │ │ │┄ Files differ │ ├── data.tar.xz │ │ ├── data.tar │ │ │ ├── file list │ │ │ │ @@ -158,15 +158,15 @@ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3764 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-efi/minix2.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3896 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-efi/minix2_be.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3764 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-efi/minix3.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3896 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-efi/minix3_be.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3764 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-efi/minix_be.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 6876 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-efi/mmap.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 5259 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-efi/moddep.lst │ │ │ │ --rwxr-xr-x 0 root (0) root (0) 2548 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-efi/modinfo.sh │ │ │ │ +-rwxr-xr-x 0 root (0) root (0) 2546 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-efi/modinfo.sh │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-efi/monolithic/ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3444736 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-efi/monolithic/gcdia32.efi │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3756032 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-efi/monolithic/grubia32.efi │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3448832 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-efi/monolithic/grubnetia32-installer.efi │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3448832 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-efi/monolithic/grubnetia32.efi │ │ │ │ -rw-r--r-- 0 root (0) root (0) 2364 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-efi/morse.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 29028 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-efi/mpi.mod │ │ │ ├── ./usr/lib/grub/i386-efi/modinfo.sh │ │ │ │ @@ -1,8 +1,8 @@ │ │ │ │ -#!/bin/bash │ │ │ │ +#!/bin/sh │ │ │ │ │ │ │ │ # User-controllable options │ │ │ │ grub_modinfo_target_cpu=i386 │ │ │ │ grub_modinfo_platform=efi │ │ │ │ grub_disk_cache_stats=0 │ │ │ │ grub_boot_time_stats=0 │ │ │ │ grub_have_font_source=1 │ │ │ ├── ./usr/lib/grub/i386-efi/monolithic/gcdia32.efi │ │ │ │ @@ -60809,15 +60809,15 @@ │ │ │ │ 000ed880: 0000 0000 0000 0000 6408 0000 0501 0000 ........d....... │ │ │ │ 000ed890: 0000 0000 0000 0000 0100 0000 0000 0000 ................ │ │ │ │ 000ed8a0: 1100 0000 0300 0000 0000 0000 0000 0000 ................ │ │ │ │ 000ed8b0: 6c0c 0000 6800 0000 0000 0000 0000 0000 l...h........... │ │ │ │ 000ed8c0: 0100 0000 0000 0000 0100 0000 0888 2500 ..............%. │ │ │ │ 000ed8d0: eb3c 906d 6b66 732e 6661 7400 0204 0100 .<.mkfs.fat..... │ │ │ │ 000ed8e0: 0200 02c0 12f8 0400 2000 0200 0000 0000 ........ ....... │ │ │ │ -000ed8f0: 0000 0000 8000 2961 2d42 ee4e 4f20 4e41 ......)a-B.NO NA │ │ │ │ +000ed8f0: 0000 0000 8000 29d8 3cd4 904e 4f20 4e41 ......).<..NO NA │ │ │ │ 000ed900: 4d45 2020 2020 4641 5431 3220 2020 0e1f ME FAT12 .. │ │ │ │ 000ed910: be5b 7cac 22c0 740b 56b4 0ebb 0700 cd10 .[|.".t.V....... │ │ │ │ 000ed920: 5eeb f032 e4cd 16cd 19eb fe54 6869 7320 ^..2.......This │ │ │ │ 000ed930: 6973 206e 6f74 2061 2062 6f6f 7461 626c is not a bootabl │ │ │ │ 000ed940: 6520 6469 736b 2e20 2050 6c65 6173 6520 e disk. Please │ │ │ │ 000ed950: 696e 7365 7274 2061 2062 6f6f 7461 626c insert a bootabl │ │ │ │ 000ed960: 6520 666c 6f70 7079 2061 6e64 0d0a 7072 e floppy and..pr │ │ │ ├── ./usr/lib/grub/i386-efi/monolithic/grubia32.efi │ │ │ │ @@ -80255,15 +80255,15 @@ │ │ │ │ 001397e0: 0000 0000 0000 0000 4c02 0000 7c00 0000 ........L...|... │ │ │ │ 001397f0: 0000 0000 0000 0000 0100 0000 0000 0000 ................ │ │ │ │ 00139800: 1100 0000 0300 0000 0000 0000 0000 0000 ................ │ │ │ │ 00139810: 1003 0000 5200 0000 0000 0000 0000 0000 ....R........... │ │ │ │ 00139820: 0100 0000 0000 0000 0100 0000 0888 2500 ..............%. │ │ │ │ 00139830: eb3c 906d 6b66 732e 6661 7400 0204 0100 .<.mkfs.fat..... │ │ │ │ 00139840: 0200 02c0 12f8 0400 2000 0200 0000 0000 ........ ....... │ │ │ │ -00139850: 0000 0000 8000 2961 2d42 ee4e 4f20 4e41 ......)a-B.NO NA │ │ │ │ +00139850: 0000 0000 8000 29d8 3cd4 904e 4f20 4e41 ......).<..NO NA │ │ │ │ 00139860: 4d45 2020 2020 4641 5431 3220 2020 0e1f ME FAT12 .. │ │ │ │ 00139870: be5b 7cac 22c0 740b 56b4 0ebb 0700 cd10 .[|.".t.V....... │ │ │ │ 00139880: 5eeb f032 e4cd 16cd 19eb fe54 6869 7320 ^..2.......This │ │ │ │ 00139890: 6973 206e 6f74 2061 2062 6f6f 7461 626c is not a bootabl │ │ │ │ 001398a0: 6520 6469 736b 2e20 2050 6c65 6173 6520 e disk. Please │ │ │ │ 001398b0: 696e 7365 7274 2061 2062 6f6f 7461 626c insert a bootabl │ │ │ │ 001398c0: 6520 666c 6f70 7079 2061 6e64 0d0a 7072 e floppy and..pr │ │ │ ├── ./usr/lib/grub/i386-efi/monolithic/grubnetia32-installer.efi │ │ │ │ @@ -61123,15 +61123,15 @@ │ │ │ │ 000eec20: 0000 0000 0000 0000 b80b 0000 d601 0000 ................ │ │ │ │ 000eec30: 0000 0000 0000 0000 0100 0000 0000 0000 ................ │ │ │ │ 000eec40: 1100 0000 0300 0000 0000 0000 0000 0000 ................ │ │ │ │ 000eec50: f810 0000 6d00 0000 0000 0000 0000 0000 ....m........... │ │ │ │ 000eec60: 0100 0000 0000 0000 0100 0000 0888 2500 ..............%. │ │ │ │ 000eec70: eb3c 906d 6b66 732e 6661 7400 0204 0100 .<.mkfs.fat..... │ │ │ │ 000eec80: 0200 02c0 12f8 0400 2000 0200 0000 0000 ........ ....... │ │ │ │ -000eec90: 0000 0000 8000 29ff b243 ee4e 4f20 4e41 ......)..C.NO NA │ │ │ │ +000eec90: 0000 0000 8000 2926 7ad4 904e 4f20 4e41 ......)&z..NO NA │ │ │ │ 000eeca0: 4d45 2020 2020 4641 5431 3220 2020 0e1f ME FAT12 .. │ │ │ │ 000eecb0: be5b 7cac 22c0 740b 56b4 0ebb 0700 cd10 .[|.".t.V....... │ │ │ │ 000eecc0: 5eeb f032 e4cd 16cd 19eb fe54 6869 7320 ^..2.......This │ │ │ │ 000eecd0: 6973 206e 6f74 2061 2062 6f6f 7461 626c is not a bootabl │ │ │ │ 000eece0: 6520 6469 736b 2e20 2050 6c65 6173 6520 e disk. Please │ │ │ │ 000eecf0: 696e 7365 7274 2061 2062 6f6f 7461 626c insert a bootabl │ │ │ │ 000eed00: 6520 666c 6f70 7079 2061 6e64 0d0a 7072 e floppy and..pr │ │ │ ├── ./usr/lib/grub/i386-efi/monolithic/grubnetia32.efi │ │ │ │ @@ -61123,15 +61123,15 @@ │ │ │ │ 000eec20: 0000 0000 0000 0000 b80b 0000 d601 0000 ................ │ │ │ │ 000eec30: 0000 0000 0000 0000 0100 0000 0000 0000 ................ │ │ │ │ 000eec40: 1100 0000 0300 0000 0000 0000 0000 0000 ................ │ │ │ │ 000eec50: f810 0000 6d00 0000 0000 0000 0000 0000 ....m........... │ │ │ │ 000eec60: 0100 0000 0000 0000 0100 0000 0888 2500 ..............%. │ │ │ │ 000eec70: eb3c 906d 6b66 732e 6661 7400 0204 0100 .<.mkfs.fat..... │ │ │ │ 000eec80: 0200 02c0 12f8 0400 2000 0200 0000 0000 ........ ....... │ │ │ │ -000eec90: 0000 0000 8000 29ff b243 ee4e 4f20 4e41 ......)..C.NO NA │ │ │ │ +000eec90: 0000 0000 8000 2926 7ad4 904e 4f20 4e41 ......)&z..NO NA │ │ │ │ 000eeca0: 4d45 2020 2020 4641 5431 3220 2020 0e1f ME FAT12 .. │ │ │ │ 000eecb0: be5b 7cac 22c0 740b 56b4 0ebb 0700 cd10 .[|.".t.V....... │ │ │ │ 000eecc0: 5eeb f032 e4cd 16cd 19eb fe54 6869 7320 ^..2.......This │ │ │ │ 000eecd0: 6973 206e 6f74 2061 2062 6f6f 7461 626c is not a bootabl │ │ │ │ 000eece0: 6520 6469 736b 2e20 2050 6c65 6173 6520 e disk. Please │ │ │ │ 000eecf0: 696e 7365 7274 2061 2062 6f6f 7461 626c insert a bootabl │ │ │ │ 000eed00: 6520 666c 6f70 7079 2061 6e64 0d0a 7072 e floppy and..pr ├── grub-emu_2.06-13+deb12u1_amd64.deb │ ├── file list │ │ @@ -1,3 +1,3 @@ │ │ -rw-r--r-- 0 0 0 4 2023-10-02 14:11:34.000000 debian-binary │ │ -rw-r--r-- 0 0 0 6204 2023-10-02 14:11:34.000000 control.tar.xz │ │ --rw-r--r-- 0 0 0 4219272 2023-10-02 14:11:34.000000 data.tar.xz │ │ +-rw-r--r-- 0 0 0 4218032 2023-10-02 14:11:34.000000 data.tar.xz │ ├── control.tar.xz │ │ ├── control.tar │ │ │ ├── ./md5sums │ │ │ │ ├── ./md5sums │ │ │ │ │┄ Files differ │ ├── data.tar.xz │ │ ├── data.tar │ │ │ ├── file list │ │ │ │ @@ -125,15 +125,15 @@ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 38664 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-emu/minix.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 39384 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-emu/minix2.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 42024 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-emu/minix2_be.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 39448 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-emu/minix3.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 42504 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-emu/minix3_be.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 40312 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-emu/minix_be.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3694 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-emu/moddep.lst │ │ │ │ --rwxr-xr-x 0 root (0) root (0) 2319 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-emu/modinfo.sh │ │ │ │ +-rwxr-xr-x 0 root (0) root (0) 2317 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-emu/modinfo.sh │ │ │ │ -rw-r--r-- 0 root (0) root (0) 333800 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-emu/mpi.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 23160 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-emu/msdospart.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 11680 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-emu/mul_test.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 568752 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-emu/net.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 32288 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-emu/newc.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 74056 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-emu/nilfs2.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 1021008 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-emu/normal.mod │ │ │ ├── ./usr/lib/grub/x86_64-emu/modinfo.sh │ │ │ │ @@ -1,8 +1,8 @@ │ │ │ │ -#!/bin/bash │ │ │ │ +#!/bin/sh │ │ │ │ │ │ │ │ # User-controllable options │ │ │ │ grub_modinfo_target_cpu=x86_64 │ │ │ │ grub_modinfo_platform=emu │ │ │ │ grub_disk_cache_stats=0 │ │ │ │ grub_boot_time_stats=0 │ │ │ │ grub_have_font_source=1 ├── grub-firmware-qemu_2.06-13+deb12u1_amd64.deb │ ├── file list │ │ @@ -1,3 +1,3 @@ │ │ -rw-r--r-- 0 0 0 4 2023-10-02 14:11:34.000000 debian-binary │ │ -rw-r--r-- 0 0 0 1184 2023-10-02 14:11:34.000000 control.tar.xz │ │ --rw-r--r-- 0 0 0 780472 2023-10-02 14:11:34.000000 data.tar.xz │ │ +-rw-r--r-- 0 0 0 780464 2023-10-02 14:11:34.000000 data.tar.xz │ ├── control.tar.xz │ │ ├── control.tar │ │ │ ├── ./md5sums │ │ │ │ ├── ./md5sums │ │ │ │ │┄ Files differ │ ├── data.tar.xz │ │ ├── data.tar │ │ │ ├── ./usr/share/qemu/grub.bin │ │ │ │ @@ -110441,27 +110441,27 @@ │ │ │ │ 001af680: 0000 0001 0000 0008 2800 0062 6f6f 742f ........(..boot/ │ │ │ │ 001af690: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001af6a0: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001af6b0: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001af6c0: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001af6d0: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001af6e0: 0000 0000 0000 0000 0000 0000 0000 0030 ...............0 │ │ │ │ -001af6f0: 3030 3037 3535 0030 3030 3231 3237 0030 000755.0002127.0 │ │ │ │ -001af700: 3030 3231 3237 0030 3030 3030 3030 3030 002127.000000000 │ │ │ │ -001af710: 3030 0031 3437 3533 3037 3737 3632 0030 00.14753077762.0 │ │ │ │ -001af720: 3132 3430 3100 2035 0000 0000 0000 0000 12401. 5........ │ │ │ │ +001af6f0: 3030 3037 3535 0030 3030 3432 3536 0030 000755.0004256.0 │ │ │ │ +001af700: 3030 3432 3536 0030 3030 3030 3030 3030 004256.000000000 │ │ │ │ +001af710: 3030 0031 3435 3437 3637 3436 3233 0030 00.14547674623.0 │ │ │ │ +001af720: 3132 3431 3500 2035 0000 0000 0000 0000 12415. 5........ │ │ │ │ 001af730: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001af740: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001af750: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001af760: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001af770: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001af780: 0000 0000 0000 0000 0000 0000 7573 7461 ............usta │ │ │ │ -001af790: 7220 2000 7062 7569 6c64 6572 3100 0000 r .pbuilder1... │ │ │ │ +001af790: 7220 2000 7062 7569 6c64 6572 3200 0000 r .pbuilder2... │ │ │ │ 001af7a0: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ -001af7b0: 0000 0000 7062 7569 6c64 6572 3100 0000 ....pbuilder1... │ │ │ │ +001af7b0: 0000 0000 7062 7569 6c64 6572 3200 0000 ....pbuilder2... │ │ │ │ 001af7c0: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001af7d0: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001af7e0: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001af7f0: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001af800: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001af810: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001af820: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ @@ -110473,27 +110473,27 @@ │ │ │ │ 001af880: 0000 0000 0000 0000 0000 0062 6f6f 742f ...........boot/ │ │ │ │ 001af890: 6772 7562 2f00 0000 0000 0000 0000 0000 grub/........... │ │ │ │ 001af8a0: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001af8b0: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001af8c0: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001af8d0: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001af8e0: 0000 0000 0000 0000 0000 0000 0000 0030 ...............0 │ │ │ │ -001af8f0: 3030 3037 3535 0030 3030 3231 3237 0030 000755.0002127.0 │ │ │ │ -001af900: 3030 3231 3237 0030 3030 3030 3030 3030 002127.000000000 │ │ │ │ -001af910: 3030 0031 3437 3533 3037 3737 3632 0030 00.14753077762.0 │ │ │ │ -001af920: 3133 3334 3000 2035 0000 0000 0000 0000 13340. 5........ │ │ │ │ +001af8f0: 3030 3037 3535 0030 3030 3432 3536 0030 000755.0004256.0 │ │ │ │ +001af900: 3030 3432 3536 0030 3030 3030 3030 3030 004256.000000000 │ │ │ │ +001af910: 3030 0031 3435 3437 3637 3436 3233 0030 00.14547674623.0 │ │ │ │ +001af920: 3133 3335 3400 2035 0000 0000 0000 0000 13354. 5........ │ │ │ │ 001af930: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001af940: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001af950: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001af960: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001af970: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001af980: 0000 0000 0000 0000 0000 0000 7573 7461 ............usta │ │ │ │ -001af990: 7220 2000 7062 7569 6c64 6572 3100 0000 r .pbuilder1... │ │ │ │ +001af990: 7220 2000 7062 7569 6c64 6572 3200 0000 r .pbuilder2... │ │ │ │ 001af9a0: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ -001af9b0: 0000 0000 7062 7569 6c64 6572 3100 0000 ....pbuilder1... │ │ │ │ +001af9b0: 0000 0000 7062 7569 6c64 6572 3200 0000 ....pbuilder2... │ │ │ │ 001af9c0: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001af9d0: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001af9e0: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001af9f0: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001afa00: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001afa10: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001afa20: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ @@ -110505,27 +110505,27 @@ │ │ │ │ 001afa80: 0000 0000 0000 0000 0000 0062 6f6f 742f ...........boot/ │ │ │ │ 001afa90: 6772 7562 2f67 7275 622e 6366 6700 0000 grub/grub.cfg... │ │ │ │ 001afaa0: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001afab0: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001afac0: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001afad0: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001afae0: 0000 0000 0000 0000 0000 0000 0000 0030 ...............0 │ │ │ │ -001afaf0: 3030 3036 3434 0030 3030 3231 3237 0030 000644.0002127.0 │ │ │ │ -001afb00: 3030 3231 3237 0030 3030 3030 3030 3132 002127.000000012 │ │ │ │ -001afb10: 3432 0031 3437 3533 3037 3737 3632 0030 42.14753077762.0 │ │ │ │ -001afb20: 3134 3735 3700 2030 0000 0000 0000 0000 14757. 0........ │ │ │ │ +001afaf0: 3030 3036 3434 0030 3030 3432 3536 0030 000644.0004256.0 │ │ │ │ +001afb00: 3030 3432 3536 0030 3030 3030 3030 3132 004256.000000012 │ │ │ │ +001afb10: 3432 0031 3435 3437 3637 3436 3233 0030 42.14547674623.0 │ │ │ │ +001afb20: 3134 3737 3300 2030 0000 0000 0000 0000 14773. 0........ │ │ │ │ 001afb30: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001afb40: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001afb50: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001afb60: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001afb70: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001afb80: 0000 0000 0000 0000 0000 0000 7573 7461 ............usta │ │ │ │ -001afb90: 7220 2000 7062 7569 6c64 6572 3100 0000 r .pbuilder1... │ │ │ │ +001afb90: 7220 2000 7062 7569 6c64 6572 3200 0000 r .pbuilder2... │ │ │ │ 001afba0: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ -001afbb0: 0000 0000 7062 7569 6c64 6572 3100 0000 ....pbuilder1... │ │ │ │ +001afbb0: 0000 0000 7062 7569 6c64 6572 3200 0000 ....pbuilder2... │ │ │ │ 001afbc0: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001afbd0: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001afbe0: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001afbf0: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001afc00: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001afc10: 0000 0000 0000 0000 0000 0000 0000 0000 ................ │ │ │ │ 001afc20: 0000 0000 0000 0000 0000 0000 0000 0000 ................ ├── grub-ieee1275-bin_2.06-13+deb12u1_amd64.deb │ ├── file list │ │ @@ -1,3 +1,3 @@ │ │ -rw-r--r-- 0 0 0 4 2023-10-02 14:11:34.000000 debian-binary │ │ -rw-r--r-- 0 0 0 7364 2023-10-02 14:11:34.000000 control.tar.xz │ │ --rw-r--r-- 0 0 0 613996 2023-10-02 14:11:34.000000 data.tar.xz │ │ +-rw-r--r-- 0 0 0 614036 2023-10-02 14:11:34.000000 data.tar.xz │ ├── control.tar.xz │ │ ├── control.tar │ │ │ ├── ./md5sums │ │ │ │ ├── ./md5sums │ │ │ │ │┄ Files differ │ ├── data.tar.xz │ │ ├── data.tar │ │ │ ├── file list │ │ │ │ @@ -145,15 +145,15 @@ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3692 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-ieee1275/minix2.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3856 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-ieee1275/minix2_be.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3692 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-ieee1275/minix3.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3856 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-ieee1275/minix3_be.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3724 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-ieee1275/minix_be.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 5848 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-ieee1275/mmap.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 4652 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-ieee1275/moddep.lst │ │ │ │ --rwxr-xr-x 0 root (0) root (0) 2581 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-ieee1275/modinfo.sh │ │ │ │ +-rwxr-xr-x 0 root (0) root (0) 2579 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-ieee1275/modinfo.sh │ │ │ │ -rw-r--r-- 0 root (0) root (0) 2348 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-ieee1275/morse.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 27896 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-ieee1275/mpi.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 2396 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-ieee1275/msdospart.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 2016 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-ieee1275/mul_test.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 12732 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-ieee1275/multiboot.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 13832 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-ieee1275/multiboot2.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 2740 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-ieee1275/nand.mod │ │ │ ├── ./usr/lib/grub/i386-ieee1275/modinfo.sh │ │ │ │ @@ -1,8 +1,8 @@ │ │ │ │ -#!/bin/bash │ │ │ │ +#!/bin/sh │ │ │ │ │ │ │ │ # User-controllable options │ │ │ │ grub_modinfo_target_cpu=i386 │ │ │ │ grub_modinfo_platform=ieee1275 │ │ │ │ grub_disk_cache_stats=0 │ │ │ │ grub_boot_time_stats=0 │ │ │ │ grub_have_font_source=1 ├── grub-pc-bin_2.06-13+deb12u1_amd64.deb │ ├── file list │ │ @@ -1,3 +1,3 @@ │ │ -rw-r--r-- 0 0 0 4 2023-10-02 14:11:34.000000 debian-binary │ │ -rw-r--r-- 0 0 0 8416 2023-10-02 14:11:34.000000 control.tar.xz │ │ --rw-r--r-- 0 0 0 988576 2023-10-02 14:11:34.000000 data.tar.xz │ │ +-rw-r--r-- 0 0 0 988624 2023-10-02 14:11:34.000000 data.tar.xz │ ├── control.tar.xz │ │ ├── control.tar │ │ │ ├── ./md5sums │ │ │ │ ├── ./md5sums │ │ │ │ │┄ Files differ │ ├── data.tar.xz │ │ ├── data.tar │ │ │ ├── file list │ │ │ │ @@ -171,15 +171,15 @@ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3692 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-pc/minix2.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3856 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-pc/minix2_be.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3692 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-pc/minix3.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3856 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-pc/minix3_be.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3724 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-pc/minix_be.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 8544 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-pc/mmap.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 5709 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-pc/moddep.lst │ │ │ │ --rwxr-xr-x 0 root (0) root (0) 2567 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-pc/modinfo.sh │ │ │ │ +-rwxr-xr-x 0 root (0) root (0) 2565 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-pc/modinfo.sh │ │ │ │ -rw-r--r-- 0 root (0) root (0) 2348 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-pc/morse.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 27896 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-pc/mpi.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 2396 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-pc/msdospart.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 2016 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-pc/mul_test.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 13920 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-pc/multiboot.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 15068 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-pc/multiboot2.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 4156 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-pc/nativedisk.mod │ │ │ ├── ./usr/lib/grub/i386-pc/modinfo.sh │ │ │ │ @@ -1,8 +1,8 @@ │ │ │ │ -#!/bin/bash │ │ │ │ +#!/bin/sh │ │ │ │ │ │ │ │ # User-controllable options │ │ │ │ grub_modinfo_target_cpu=i386 │ │ │ │ grub_modinfo_platform=pc │ │ │ │ grub_disk_cache_stats=0 │ │ │ │ grub_boot_time_stats=0 │ │ │ │ grub_have_font_source=1 ├── grub-rescue-pc_2.06-13+deb12u1_amd64.deb │ ├── file list │ │ @@ -1,3 +1,3 @@ │ │ -rw-r--r-- 0 0 0 4 2023-10-02 14:11:34.000000 debian-binary │ │ --rw-r--r-- 0 0 0 1028 2023-10-02 14:11:34.000000 control.tar.xz │ │ --rw-r--r-- 0 0 0 2490180 2023-10-02 14:11:34.000000 data.tar.xz │ │ +-rw-r--r-- 0 0 0 1032 2023-10-02 14:11:34.000000 control.tar.xz │ │ +-rw-r--r-- 0 0 0 2490144 2023-10-02 14:11:34.000000 data.tar.xz │ ├── control.tar.xz │ │ ├── control.tar │ │ │ ├── ./md5sums │ │ │ │ ├── ./md5sums │ │ │ │ │┄ Files differ │ ├── data.tar.xz │ │ ├── data.tar │ │ │ ├── ./usr/lib/grub-rescue/grub-rescue-cdrom.iso │ │ │ │ ├── isoinfo -l -i {} │ │ │ │ │ @@ -1,324 +1,324 @@ │ │ │ │ │ │ │ │ │ │ Directory listing of / │ │ │ │ │ -d--------- 0 0 0 2048 Feb 12 2025 [ 19 02] . │ │ │ │ │ -d--------- 0 0 0 2048 Feb 12 2025 [ 19 02] .. │ │ │ │ │ -d--------- 0 0 0 2048 Feb 12 2025 [ 21 02] boot │ │ │ │ │ ----------- 0 0 0 2048 Feb 12 2025 [ 48 00] boot.cat;1 │ │ │ │ │ +d--------- 0 0 0 2048 Jan 11 2024 [ 19 02] . │ │ │ │ │ +d--------- 0 0 0 2048 Jan 11 2024 [ 19 02] .. │ │ │ │ │ +d--------- 0 0 0 2048 Jan 11 2024 [ 21 02] boot │ │ │ │ │ +---------- 0 0 0 2048 Jan 11 2024 [ 48 00] boot.cat;1 │ │ │ │ │ │ │ │ │ │ Directory listing of /boot/ │ │ │ │ │ -d--------- 0 0 0 2048 Feb 12 2025 [ 21 02] . │ │ │ │ │ -d--------- 0 0 0 2048 Feb 12 2025 [ 19 02] .. │ │ │ │ │ -d--------- 0 0 0 2048 Feb 12 2025 [ 22 02] grub │ │ │ │ │ +d--------- 0 0 0 2048 Jan 11 2024 [ 21 02] . │ │ │ │ │ +d--------- 0 0 0 2048 Jan 11 2024 [ 19 02] .. │ │ │ │ │ +d--------- 0 0 0 2048 Jan 11 2024 [ 22 02] grub │ │ │ │ │ │ │ │ │ │ Directory listing of /boot/grub/ │ │ │ │ │ -d--------- 0 0 0 2048 Feb 12 2025 [ 22 02] . │ │ │ │ │ -d--------- 0 0 0 2048 Feb 12 2025 [ 21 02] .. │ │ │ │ │ -d--------- 0 0 0 2048 Feb 12 2025 [ 23 02] fonts │ │ │ │ │ ----------- 0 0 0 1705 Feb 12 2025 [ 1218 00] grub.cfg;1 │ │ │ │ │ -d--------- 0 0 0 38912 Feb 12 2025 [ 24 02] i386-pc │ │ │ │ │ -d--------- 0 0 0 2048 Feb 12 2025 [ 43 02] locale │ │ │ │ │ -d--------- 0 0 0 2048 Feb 12 2025 [ 44 02] roms │ │ │ │ │ +d--------- 0 0 0 2048 Jan 11 2024 [ 22 02] . │ │ │ │ │ +d--------- 0 0 0 2048 Jan 11 2024 [ 21 02] .. │ │ │ │ │ +d--------- 0 0 0 2048 Jan 11 2024 [ 23 02] fonts │ │ │ │ │ +---------- 0 0 0 1705 Jan 11 2024 [ 1218 00] grub.cfg;1 │ │ │ │ │ +d--------- 0 0 0 38912 Jan 11 2024 [ 24 02] i386-pc │ │ │ │ │ +d--------- 0 0 0 2048 Jan 11 2024 [ 43 02] locale │ │ │ │ │ +d--------- 0 0 0 2048 Jan 11 2024 [ 44 02] roms │ │ │ │ │ │ │ │ │ │ Directory listing of /boot/grub/fonts/ │ │ │ │ │ -d--------- 0 0 0 2048 Feb 12 2025 [ 23 02] . │ │ │ │ │ -d--------- 0 0 0 2048 Feb 12 2025 [ 22 02] .. │ │ │ │ │ ----------- 0 0 0 2392304 Feb 12 2025 [ 49 00] unicode.pf2;1 │ │ │ │ │ +d--------- 0 0 0 2048 Jan 11 2024 [ 23 02] . │ │ │ │ │ +d--------- 0 0 0 2048 Jan 11 2024 [ 22 02] .. │ │ │ │ │ +---------- 0 0 0 2392304 Jan 11 2024 [ 49 00] unicode.pf2;1 │ │ │ │ │ │ │ │ │ │ Directory listing of /boot/grub/i386-pc/ │ │ │ │ │ -d--------- 0 0 0 38912 Feb 12 2025 [ 24 02] . │ │ │ │ │ -d--------- 0 0 0 2048 Feb 12 2025 [ 22 02] .. │ │ │ │ │ ----------- 0 0 0 7780 Feb 12 2025 [ 1219 00] 915resol.mod;1 │ │ │ │ │ ----------- 0 0 0 10868 Feb 12 2025 [ 1223 00] acpi.mod;1 │ │ │ │ │ ----------- 0 0 0 1228 Feb 12 2025 [ 1229 00] adler32.mod;1 │ │ │ │ │ ----------- 0 0 0 5568 Feb 12 2025 [ 1230 00] affs.mod;1 │ │ │ │ │ ----------- 0 0 0 6020 Feb 12 2025 [ 1233 00] afs.mod;1 │ │ │ │ │ ----------- 0 0 0 1516 Feb 12 2025 [ 1236 00] afsplitt.mod;1 │ │ │ │ │ ----------- 0 0 0 15392 Feb 12 2025 [ 1237 00] ahci.mod;1 │ │ │ │ │ ----------- 0 0 0 492 Feb 12 2025 [ 1245 00] all_vide.mod;1 │ │ │ │ │ ----------- 0 0 0 956 Feb 12 2025 [ 1246 00] aout.mod;1 │ │ │ │ │ ----------- 0 0 0 2836 Feb 12 2025 [ 1247 00] archelp.mod;1 │ │ │ │ │ ----------- 0 0 0 4068 Feb 12 2025 [ 1249 00] at_keybo.mod;1 │ │ │ │ │ ----------- 0 0 0 5524 Feb 12 2025 [ 1251 00] ata.mod;1 │ │ │ │ │ ----------- 0 0 0 1576 Feb 12 2025 [ 1254 00] backtrac.mod;1 │ │ │ │ │ ----------- 0 0 0 6728 Feb 12 2025 [ 1255 00] bfs.mod;1 │ │ │ │ │ ----------- 0 0 0 4636 Feb 12 2025 [ 1259 00] biosdisk.mod;1 │ │ │ │ │ ----------- 0 0 0 2184 Feb 12 2025 [ 1262 00] bitmap.mod;1 │ │ │ │ │ ----------- 0 0 0 3616 Feb 12 2025 [ 1264 00] bitmap_s.mod;1 │ │ │ │ │ ----------- 0 0 0 1984 Feb 12 2025 [ 1266 00] blocklis.mod;1 │ │ │ │ │ ----------- 0 0 0 2628 Feb 12 2025 [ 1267 00] boot.mod;1 │ │ │ │ │ ----------- 0 0 0 30568 Feb 12 2025 [ 1269 00] bsd.mod;1 │ │ │ │ │ ----------- 0 0 0 2252 Feb 12 2025 [ 1284 00] bswap_te.mod;1 │ │ │ │ │ ----------- 0 0 0 19712 Feb 12 2025 [ 1286 00] btrfs.mod;1 │ │ │ │ │ ----------- 0 0 0 2028 Feb 12 2025 [ 1296 00] bufio.mod;1 │ │ │ │ │ ----------- 0 0 0 2884 Feb 12 2025 [ 1297 00] cat.mod;1 │ │ │ │ │ ----------- 0 0 0 3892 Feb 12 2025 [ 1299 00] cbfs.mod;1 │ │ │ │ │ ----------- 0 0 0 3340 Feb 12 2025 [ 1301 00] cbls.mod;1 │ │ │ │ │ ----------- 0 0 0 2448 Feb 12 2025 [ 1303 00] cbmemc.mod;1 │ │ │ │ │ ----------- 0 0 0 1048 Feb 12 2025 [ 1305 00] cbtable.mod;1 │ │ │ │ │ ----------- 0 0 0 2772 Feb 12 2025 [ 1306 00] cbtime.mod;1 │ │ │ │ │ ----------- 0 0 0 3448 Feb 12 2025 [ 1308 00] chain.mod;1 │ │ │ │ │ ----------- 0 0 0 2960 Feb 12 2025 [ 1310 00] cmdline_.mod;1 │ │ │ │ │ ----------- 0 0 0 1216 Feb 12 2025 [ 1312 00] cmosdump.mod;1 │ │ │ │ │ ----------- 0 0 0 1808 Feb 12 2025 [ 1313 00] cmostest.mod;1 │ │ │ │ │ ----------- 0 0 0 2056 Feb 12 2025 [ 1314 00] cmp.mod;1 │ │ │ │ │ ----------- 0 0 0 4608 Feb 12 2025 [ 1316 00] cmp_test.mod;1 │ │ │ │ │ ----------- 0 0 0 3887 Feb 12 2025 [ 1319 00] command.lst;1 │ │ │ │ │ ----------- 0 0 0 2224 Feb 12 2025 [ 1321 00] configfi.mod;1 │ │ │ │ │ ----------- 0 0 0 2612 Feb 12 2025 [ 1323 00] cpio.mod;1 │ │ │ │ │ ----------- 0 0 0 2680 Feb 12 2025 [ 1325 00] cpio_be.mod;1 │ │ │ │ │ ----------- 0 0 0 1664 Feb 12 2025 [ 1327 00] cpuid.mod;1 │ │ │ │ │ ----------- 0 0 0 1572 Feb 12 2025 [ 1328 00] crc64.mod;1 │ │ │ │ │ ----------- 0 0 0 936 Feb 12 2025 [ 1329 00] crypto.lst;1 │ │ │ │ │ ----------- 0 0 0 4944 Feb 12 2025 [ 1330 00] crypto.mod;1 │ │ │ │ │ ----------- 0 0 0 11900 Feb 12 2025 [ 1333 00] cryptodi.mod;1 │ │ │ │ │ ----------- 0 0 0 3588 Feb 12 2025 [ 1339 00] cs5536.mod;1 │ │ │ │ │ ----------- 0 0 0 1680 Feb 12 2025 [ 1341 00] ctz_test.mod;1 │ │ │ │ │ ----------- 0 0 0 2148 Feb 12 2025 [ 1342 00] date.mod;1 │ │ │ │ │ ----------- 0 0 0 1716 Feb 12 2025 [ 1344 00] datehook.mod;1 │ │ │ │ │ ----------- 0 0 0 2232 Feb 12 2025 [ 1345 00] datetime.mod;1 │ │ │ │ │ ----------- 0 0 0 2332 Feb 12 2025 [ 1347 00] disk.mod;1 │ │ │ │ │ ----------- 0 0 0 9836 Feb 12 2025 [ 1349 00] diskfilt.mod;1 │ │ │ │ │ ----------- 0 0 0 956 Feb 12 2025 [ 1354 00] div.mod;1 │ │ │ │ │ ----------- 0 0 0 5560 Feb 12 2025 [ 1355 00] div_test.mod;1 │ │ │ │ │ ----------- 0 0 0 1772 Feb 12 2025 [ 1358 00] dm_nv.mod;1 │ │ │ │ │ ----------- 0 0 0 5316 Feb 12 2025 [ 1359 00] drivemap.mod;1 │ │ │ │ │ ----------- 0 0 0 1896 Feb 12 2025 [ 1362 00] echo.mod;1 │ │ │ │ │ ----------- 0 0 0 23696 Feb 12 2025 [ 1363 00] efiemu.mod;1 │ │ │ │ │ ----------- 0 0 0 7608 Feb 12 2025 [ 1375 00] efiemu32.o;1 │ │ │ │ │ ----------- 0 0 0 10112 Feb 12 2025 [ 1379 00] efiemu64.o;1 │ │ │ │ │ ----------- 0 0 0 16128 Feb 12 2025 [ 1384 00] ehci.mod;1 │ │ │ │ │ ----------- 0 0 0 4064 Feb 12 2025 [ 1392 00] elf.mod;1 │ │ │ │ │ ----------- 0 0 0 29251 Feb 12 2025 [ 1394 00] eltorito.img;1 │ │ │ │ │ ----------- 0 0 0 1368 Feb 12 2025 [ 1409 00] eval.mod;1 │ │ │ │ │ ----------- 0 0 0 6080 Feb 12 2025 [ 1410 00] exfat.mod;1 │ │ │ │ │ ----------- 0 0 0 1380 Feb 12 2025 [ 1413 00] exfctest.mod;1 │ │ │ │ │ ----------- 0 0 0 6172 Feb 12 2025 [ 1414 00] ext2.mod;1 │ │ │ │ │ ----------- 0 0 0 4640 Feb 12 2025 [ 1418 00] extcmd.mod;1 │ │ │ │ │ ----------- 0 0 0 6460 Feb 12 2025 [ 1421 00] f2fs.mod;1 │ │ │ │ │ ----------- 0 0 0 6192 Feb 12 2025 [ 1425 00] fat.mod;1 │ │ │ │ │ ----------- 0 0 0 16932 Feb 12 2025 [ 1429 00] file.mod;1 │ │ │ │ │ ----------- 0 0 0 13520 Feb 12 2025 [ 1438 00] font.mod;1 │ │ │ │ │ ----------- 0 0 0 2612 Feb 12 2025 [ 1445 00] freedos.mod;1 │ │ │ │ │ ----------- 0 0 0 219 Feb 12 2025 [ 1447 00] fs.lst;1 │ │ │ │ │ ----------- 0 0 0 2920 Feb 12 2025 [ 1448 00] fshelp.mod;1 │ │ │ │ │ ----------- 0 0 0 34168 Feb 12 2025 [ 1450 00] function.mod;1 │ │ │ │ │ ----------- 0 0 0 1612 Feb 12 2025 [ 1467 00] gcry_arc.mod;1 │ │ │ │ │ ----------- 0 0 0 8000 Feb 12 2025 [ 1468 00] gcry_blo.mod;1 │ │ │ │ │ ----------- 0 0 0 33516 Feb 12 2025 [ 1472 00] gcry_cam.mod;1 │ │ │ │ │ ----------- 0 0 0 16356 Feb 12 2025 [ 1489 00] gcry_cas.mod;1 │ │ │ │ │ ----------- 0 0 0 10564 Feb 12 2025 [ 1497 00] gcry_crc.mod;1 │ │ │ │ │ ----------- 0 0 0 19104 Feb 12 2025 [ 1503 00] gcry_des.mod;1 │ │ │ │ │ ----------- 0 0 0 2188 Feb 12 2025 [ 1513 00] gcry_dsa.mod;1 │ │ │ │ │ ----------- 0 0 0 2884 Feb 12 2025 [ 1515 00] gcry_ide.mod;1 │ │ │ │ │ ----------- 0 0 0 3048 Feb 12 2025 [ 1517 00] gcry_md4.mod;1 │ │ │ │ │ ----------- 0 0 0 3668 Feb 12 2025 [ 1519 00] gcry_md5.mod;1 │ │ │ │ │ ----------- 0 0 0 2316 Feb 12 2025 [ 1521 00] gcry_rfc.mod;1 │ │ │ │ │ ----------- 0 0 0 19312 Feb 12 2025 [ 1523 00] gcry_rij.mod;1 │ │ │ │ │ ----------- 0 0 0 8248 Feb 12 2025 [ 1533 00] gcry_rmd.mod;1 │ │ │ │ │ ----------- 0 0 0 1968 Feb 12 2025 [ 1538 00] gcry_rsa.mod;1 │ │ │ │ │ ----------- 0 0 0 14824 Feb 12 2025 [ 1539 00] gcry_see.mod;1 │ │ │ │ │ ----------- 0 0 0 17700 Feb 12 2025 [ 1547 00] gcry_ser.mod;1 │ │ │ │ │ ----------- 0 0 0 8592 Feb 12 2025 [ 1556 00] gcry_sh0.mod;1 │ │ │ │ │ ----------- 0 0 0 4376 Feb 12 2025 [ 1561 00] gcry_sh1.mod;1 │ │ │ │ │ ----------- 0 0 0 8804 Feb 12 2025 [ 1564 00] gcry_sh2.mod;1 │ │ │ │ │ ----------- 0 0 0 12244 Feb 12 2025 [ 1569 00] gcry_tig.mod;1 │ │ │ │ │ ----------- 0 0 0 36816 Feb 12 2025 [ 1575 00] gcry_two.mod;1 │ │ │ │ │ ----------- 0 0 0 24588 Feb 12 2025 [ 1593 00] gcry_whi.mod;1 │ │ │ │ │ ----------- 0 0 0 25036 Feb 12 2025 [ 1606 00] gdb.mod;1 │ │ │ │ │ ----------- 0 0 0 5884 Feb 12 2025 [ 1619 00] geli.mod;1 │ │ │ │ │ ----------- 0 0 0 4860 Feb 12 2025 [ 1622 00] gettext.mod;1 │ │ │ │ │ ----------- 0 0 0 39136 Feb 12 2025 [ 1625 00] gfxmenu.mod;1 │ │ │ │ │ ----------- 0 0 0 9892 Feb 12 2025 [ 1645 00] gfxterm.mod;1 │ │ │ │ │ ----------- 0 0 0 2796 Feb 12 2025 [ 1650 00] gfxterm0.mod;1 │ │ │ │ │ ----------- 0 0 0 4912 Feb 12 2025 [ 1652 00] gfxterm1.mod;1 │ │ │ │ │ ----------- 0 0 0 3740 Feb 12 2025 [ 1655 00] gptsync.mod;1 │ │ │ │ │ ----------- 0 0 0 8784 Feb 12 2025 [ 1657 00] gzio.mod;1 │ │ │ │ │ ----------- 0 0 0 4684 Feb 12 2025 [ 1662 00] halt.mod;1 │ │ │ │ │ ----------- 0 0 0 5168 Feb 12 2025 [ 1665 00] hashsum.mod;1 │ │ │ │ │ ----------- 0 0 0 6560 Feb 12 2025 [ 1668 00] hdparm.mod;1 │ │ │ │ │ ----------- 0 0 0 1140 Feb 12 2025 [ 1672 00] hello.mod;1 │ │ │ │ │ ----------- 0 0 0 2512 Feb 12 2025 [ 1673 00] help.mod;1 │ │ │ │ │ ----------- 0 0 0 3216 Feb 12 2025 [ 1675 00] hexdump.mod;1 │ │ │ │ │ ----------- 0 0 0 7004 Feb 12 2025 [ 1677 00] hfs.mod;1 │ │ │ │ │ ----------- 0 0 0 7848 Feb 12 2025 [ 1681 00] hfsplus.mod;1 │ │ │ │ │ ----------- 0 0 0 2960 Feb 12 2025 [ 1685 00] hfsplusc.mod;1 │ │ │ │ │ ----------- 0 0 0 5700 Feb 12 2025 [ 1687 00] http.mod;1 │ │ │ │ │ ----------- 0 0 0 2468 Feb 12 2025 [ 1690 00] hwmatch.mod;1 │ │ │ │ │ ----------- 0 0 0 2800 Feb 12 2025 [ 1692 00] iorw.mod;1 │ │ │ │ │ ----------- 0 0 0 8488 Feb 12 2025 [ 1694 00] iso9660.mod;1 │ │ │ │ │ ----------- 0 0 0 6092 Feb 12 2025 [ 1699 00] jfs.mod;1 │ │ │ │ │ ----------- 0 0 0 7660 Feb 12 2025 [ 1702 00] jpeg.mod;1 │ │ │ │ │ ----------- 0 0 0 3504 Feb 12 2025 [ 1706 00] json.mod;1 │ │ │ │ │ ----------- 0 0 0 5032 Feb 12 2025 [ 1708 00] keylayou.mod;1 │ │ │ │ │ ----------- 0 0 0 1904 Feb 12 2025 [ 1711 00] keystatu.mod;1 │ │ │ │ │ ----------- 0 0 0 6300 Feb 12 2025 [ 1712 00] ldm.mod;1 │ │ │ │ │ ----------- 0 0 0 14404 Feb 12 2025 [ 1716 00] legacy_p.mod;1 │ │ │ │ │ ----------- 0 0 0 30132 Feb 12 2025 [ 1724 00] legacycf.mod;1 │ │ │ │ │ ----------- 0 0 0 13172 Feb 12 2025 [ 1739 00] linux.mod;1 │ │ │ │ │ ----------- 0 0 0 5524 Feb 12 2025 [ 1746 00] linux16.mod;1 │ │ │ │ │ ----------- 0 0 0 5748 Feb 12 2025 [ 1749 00] loadenv.mod;1 │ │ │ │ │ ----------- 0 0 0 3004 Feb 12 2025 [ 1752 00] loopback.mod;1 │ │ │ │ │ ----------- 0 0 0 3856 Feb 12 2025 [ 1754 00] ls.mod;1 │ │ │ │ │ ----------- 0 0 0 4740 Feb 12 2025 [ 1756 00] lsacpi.mod;1 │ │ │ │ │ ----------- 0 0 0 2236 Feb 12 2025 [ 1759 00] lsapm.mod;1 │ │ │ │ │ ----------- 0 0 0 1820 Feb 12 2025 [ 1761 00] lsmmap.mod;1 │ │ │ │ │ ----------- 0 0 0 4828 Feb 12 2025 [ 1762 00] lspci.mod;1 │ │ │ │ │ ----------- 0 0 0 4356 Feb 12 2025 [ 1765 00] luks.mod;1 │ │ │ │ │ ----------- 0 0 0 14216 Feb 12 2025 [ 1768 00] luks2.mod;1 │ │ │ │ │ ----------- 0 0 0 8472 Feb 12 2025 [ 1775 00] lvm.mod;1 │ │ │ │ │ ----------- 0 0 0 4756 Feb 12 2025 [ 1780 00] lzopio.mod;1 │ │ │ │ │ ----------- 0 0 0 3200 Feb 12 2025 [ 1783 00] macbless.mod;1 │ │ │ │ │ ----------- 0 0 0 7500 Feb 12 2025 [ 1785 00] macho.mod;1 │ │ │ │ │ ----------- 0 0 0 2044 Feb 12 2025 [ 1789 00] mda_text.mod;1 │ │ │ │ │ ----------- 0 0 0 2112 Feb 12 2025 [ 1790 00] mdraid00.mod;1 │ │ │ │ │ ----------- 0 0 0 1968 Feb 12 2025 [ 1792 00] mdraid01.mod;1 │ │ │ │ │ ----------- 0 0 0 1852 Feb 12 2025 [ 1793 00] mdraid1x.mod;1 │ │ │ │ │ ----------- 0 0 0 1988 Feb 12 2025 [ 1794 00] memdisk.mod;1 │ │ │ │ │ ----------- 0 0 0 2824 Feb 12 2025 [ 1795 00] memrw.mod;1 │ │ │ │ │ ----------- 0 0 0 3504 Feb 12 2025 [ 1797 00] minicmd.mod;1 │ │ │ │ │ ----------- 0 0 0 3596 Feb 12 2025 [ 1799 00] minix.mod;1 │ │ │ │ │ ----------- 0 0 0 3692 Feb 12 2025 [ 1801 00] minix2.mod;1 │ │ │ │ │ ----------- 0 0 0 3856 Feb 12 2025 [ 1803 00] minix2_b.mod;1 │ │ │ │ │ ----------- 0 0 0 3692 Feb 12 2025 [ 1805 00] minix3.mod;1 │ │ │ │ │ ----------- 0 0 0 3856 Feb 12 2025 [ 1807 00] minix3_b.mod;1 │ │ │ │ │ ----------- 0 0 0 3724 Feb 12 2025 [ 1809 00] minix_be.mod;1 │ │ │ │ │ ----------- 0 0 0 8544 Feb 12 2025 [ 1811 00] mmap.mod;1 │ │ │ │ │ ----------- 0 0 0 5709 Feb 12 2025 [ 1816 00] moddep.lst;1 │ │ │ │ │ ----------- 0 0 0 2567 Feb 12 2025 [ 1819 00] modinfo.sh;1 │ │ │ │ │ ----------- 0 0 0 2348 Feb 12 2025 [ 1821 00] morse.mod;1 │ │ │ │ │ ----------- 0 0 0 27896 Feb 12 2025 [ 1823 00] mpi.mod;1 │ │ │ │ │ ----------- 0 0 0 2396 Feb 12 2025 [ 1837 00] msdospar.mod;1 │ │ │ │ │ ----------- 0 0 0 2016 Feb 12 2025 [ 1839 00] mul_test.mod;1 │ │ │ │ │ ----------- 0 0 0 13920 Feb 12 2025 [ 1840 00] multibo0.mod;1 │ │ │ │ │ ----------- 0 0 0 15068 Feb 12 2025 [ 1847 00] multibo1.mod;1 │ │ │ │ │ ----------- 0 0 0 4156 Feb 12 2025 [ 1855 00] nativedi.mod;1 │ │ │ │ │ ----------- 0 0 0 57256 Feb 12 2025 [ 1858 00] net.mod;1 │ │ │ │ │ ----------- 0 0 0 2836 Feb 12 2025 [ 1886 00] newc.mod;1 │ │ │ │ │ ----------- 0 0 0 6744 Feb 12 2025 [ 1888 00] nilfs2.mod;1 │ │ │ │ │ ----------- 0 0 0 114896 Feb 12 2025 [ 1892 00] normal.mod;1 │ │ │ │ │ ----------- 0 0 0 10652 Feb 12 2025 [ 1949 00] ntfs.mod;1 │ │ │ │ │ ----------- 0 0 0 4260 Feb 12 2025 [ 1955 00] ntfscomp.mod;1 │ │ │ │ │ ----------- 0 0 0 2504 Feb 12 2025 [ 1958 00] ntldr.mod;1 │ │ │ │ │ ----------- 0 0 0 2676 Feb 12 2025 [ 1960 00] odc.mod;1 │ │ │ │ │ ----------- 0 0 0 1456 Feb 12 2025 [ 1962 00] offsetio.mod;1 │ │ │ │ │ ----------- 0 0 0 10420 Feb 12 2025 [ 1963 00] ohci.mod;1 │ │ │ │ │ ----------- 0 0 0 1584 Feb 12 2025 [ 1969 00] part_aco.mod;1 │ │ │ │ │ ----------- 0 0 0 1812 Feb 12 2025 [ 1970 00] part_ami.mod;1 │ │ │ │ │ ----------- 0 0 0 2052 Feb 12 2025 [ 1971 00] part_app.mod;1 │ │ │ │ │ ----------- 0 0 0 2680 Feb 12 2025 [ 1973 00] part_bsd.mod;1 │ │ │ │ │ ----------- 0 0 0 1708 Feb 12 2025 [ 1975 00] part_dfl.mod;1 │ │ │ │ │ ----------- 0 0 0 1424 Feb 12 2025 [ 1976 00] part_dvh.mod;1 │ │ │ │ │ ----------- 0 0 0 2292 Feb 12 2025 [ 1977 00] part_gpt.mod;1 │ │ │ │ │ ----------- 0 0 0 2280 Feb 12 2025 [ 1979 00] part_msd.mod;1 │ │ │ │ │ ----------- 0 0 0 1732 Feb 12 2025 [ 1981 00] part_pla.mod;1 │ │ │ │ │ ----------- 0 0 0 1452 Feb 12 2025 [ 1982 00] part_su0.mod;1 │ │ │ │ │ ----------- 0 0 0 1580 Feb 12 2025 [ 1983 00] part_su1.mod;1 │ │ │ │ │ ----------- 0 0 0 111 Feb 12 2025 [ 1984 00] partmap.lst;1 │ │ │ │ │ ----------- 0 0 0 17 Feb 12 2025 [ 1985 00] parttool.lst;1 │ │ │ │ │ ----------- 0 0 0 4644 Feb 12 2025 [ 1986 00] parttool.mod;1 │ │ │ │ │ ----------- 0 0 0 1820 Feb 12 2025 [ 1989 00] passwor0.mod;1 │ │ │ │ │ ----------- 0 0 0 2712 Feb 12 2025 [ 1990 00] passwor1.mod;1 │ │ │ │ │ ----------- 0 0 0 4812 Feb 12 2025 [ 1992 00] pata.mod;1 │ │ │ │ │ ----------- 0 0 0 1312 Feb 12 2025 [ 1995 00] pbkdf2.mod;1 │ │ │ │ │ ----------- 0 0 0 2100 Feb 12 2025 [ 1996 00] pbkdf2_t.mod;1 │ │ │ │ │ ----------- 0 0 0 1316 Feb 12 2025 [ 1998 00] pci.mod;1 │ │ │ │ │ ----------- 0 0 0 2416 Feb 12 2025 [ 1999 00] pcidump.mod;1 │ │ │ │ │ ----------- 0 0 0 11376 Feb 12 2025 [ 2001 00] pgp.mod;1 │ │ │ │ │ ----------- 0 0 0 6292 Feb 12 2025 [ 2007 00] plan9.mod;1 │ │ │ │ │ ----------- 0 0 0 2452 Feb 12 2025 [ 2011 00] play.mod;1 │ │ │ │ │ ----------- 0 0 0 8052 Feb 12 2025 [ 2013 00] png.mod;1 │ │ │ │ │ ----------- 0 0 0 1516 Feb 12 2025 [ 2017 00] priority.mod;1 │ │ │ │ │ ----------- 0 0 0 3456 Feb 12 2025 [ 2018 00] probe.mod;1 │ │ │ │ │ ----------- 0 0 0 2284 Feb 12 2025 [ 2020 00] procfs.mod;1 │ │ │ │ │ ----------- 0 0 0 2136 Feb 12 2025 [ 2022 00] progress.mod;1 │ │ │ │ │ ----------- 0 0 0 3680 Feb 12 2025 [ 2024 00] pxe.mod;1 │ │ │ │ │ ----------- 0 0 0 2616 Feb 12 2025 [ 2026 00] pxechain.mod;1 │ │ │ │ │ ----------- 0 0 0 1292 Feb 12 2025 [ 2028 00] raid5rec.mod;1 │ │ │ │ │ ----------- 0 0 0 2204 Feb 12 2025 [ 2029 00] raid6rec.mod;1 │ │ │ │ │ ----------- 0 0 0 2784 Feb 12 2025 [ 2031 00] random.mod;1 │ │ │ │ │ ----------- 0 0 0 1848 Feb 12 2025 [ 2033 00] rdmsr.mod;1 │ │ │ │ │ ----------- 0 0 0 1404 Feb 12 2025 [ 2034 00] read.mod;1 │ │ │ │ │ ----------- 0 0 0 1636 Feb 12 2025 [ 2035 00] reboot.mod;1 │ │ │ │ │ ----------- 0 0 0 51032 Feb 12 2025 [ 2036 00] regexp.mod;1 │ │ │ │ │ ----------- 0 0 0 8788 Feb 12 2025 [ 2061 00] reiserfs.mod;1 │ │ │ │ │ ----------- 0 0 0 14952 Feb 12 2025 [ 2066 00] relocato.mod;1 │ │ │ │ │ ----------- 0 0 0 4052 Feb 12 2025 [ 2074 00] romfs.mod;1 │ │ │ │ │ ----------- 0 0 0 4644 Feb 12 2025 [ 2076 00] scsi.mod;1 │ │ │ │ │ ----------- 0 0 0 3624 Feb 12 2025 [ 2079 00] search.mod;1 │ │ │ │ │ ----------- 0 0 0 3052 Feb 12 2025 [ 2081 00] search_0.mod;1 │ │ │ │ │ ----------- 0 0 0 3156 Feb 12 2025 [ 2083 00] search_1.mod;1 │ │ │ │ │ ----------- 0 0 0 3072 Feb 12 2025 [ 2085 00] search_l.mod;1 │ │ │ │ │ ----------- 0 0 0 7068 Feb 12 2025 [ 2087 00] sendkey.mod;1 │ │ │ │ │ ----------- 0 0 0 7696 Feb 12 2025 [ 2091 00] serial.mod;1 │ │ │ │ │ ----------- 0 0 0 628 Feb 12 2025 [ 2095 00] setjmp.mod;1 │ │ │ │ │ ----------- 0 0 0 1624 Feb 12 2025 [ 2096 00] setjmp_t.mod;1 │ │ │ │ │ ----------- 0 0 0 5224 Feb 12 2025 [ 2097 00] setpci.mod;1 │ │ │ │ │ ----------- 0 0 0 5116 Feb 12 2025 [ 2100 00] sfs.mod;1 │ │ │ │ │ ----------- 0 0 0 2396 Feb 12 2025 [ 2103 00] shift_te.mod;1 │ │ │ │ │ ----------- 0 0 0 6380 Feb 12 2025 [ 2105 00] signatur.mod;1 │ │ │ │ │ ----------- 0 0 0 2144 Feb 12 2025 [ 2109 00] sleep.mod;1 │ │ │ │ │ ----------- 0 0 0 2260 Feb 12 2025 [ 2111 00] sleep_te.mod;1 │ │ │ │ │ ----------- 0 0 0 5564 Feb 12 2025 [ 2113 00] smbios.mod;1 │ │ │ │ │ ----------- 0 0 0 2024 Feb 12 2025 [ 2116 00] spkmodem.mod;1 │ │ │ │ │ ----------- 0 0 0 7132 Feb 12 2025 [ 2117 00] squash4.mod;1 │ │ │ │ │ ----------- 0 0 0 2112 Feb 12 2025 [ 2121 00] strtoull.mod;1 │ │ │ │ │ ----------- 0 0 0 17420 Feb 12 2025 [ 2123 00] syslinux.mod;1 │ │ │ │ │ ----------- 0 0 0 3216 Feb 12 2025 [ 2132 00] tar.mod;1 │ │ │ │ │ ----------- 0 0 0 202 Feb 12 2025 [ 2134 00] terminal.lst;1 │ │ │ │ │ ----------- 0 0 0 4448 Feb 12 2025 [ 2135 00] terminal.mod;1 │ │ │ │ │ ----------- 0 0 0 12356 Feb 12 2025 [ 2138 00] terminfo.mod;1 │ │ │ │ │ ----------- 0 0 0 5000 Feb 12 2025 [ 2145 00] test.mod;1 │ │ │ │ │ ----------- 0 0 0 1272 Feb 12 2025 [ 2148 00] test_blo.mod;1 │ │ │ │ │ ----------- 0 0 0 2736 Feb 12 2025 [ 2149 00] testload.mod;1 │ │ │ │ │ ----------- 0 0 0 2264 Feb 12 2025 [ 2151 00] testspee.mod;1 │ │ │ │ │ ----------- 0 0 0 4920 Feb 12 2025 [ 2153 00] tftp.mod;1 │ │ │ │ │ ----------- 0 0 0 4588 Feb 12 2025 [ 2156 00] tga.mod;1 │ │ │ │ │ ----------- 0 0 0 1456 Feb 12 2025 [ 2159 00] time.mod;1 │ │ │ │ │ ----------- 0 0 0 2352 Feb 12 2025 [ 2160 00] tr.mod;1 │ │ │ │ │ ----------- 0 0 0 1668 Feb 12 2025 [ 2162 00] trig.mod;1 │ │ │ │ │ ----------- 0 0 0 1152 Feb 12 2025 [ 2163 00] true.mod;1 │ │ │ │ │ ----------- 0 0 0 3728 Feb 12 2025 [ 2164 00] truecryp.mod;1 │ │ │ │ │ ----------- 0 0 0 8500 Feb 12 2025 [ 2166 00] udf.mod;1 │ │ │ │ │ ----------- 0 0 0 5332 Feb 12 2025 [ 2171 00] ufs1.mod;1 │ │ │ │ │ ----------- 0 0 0 5716 Feb 12 2025 [ 2174 00] ufs1_be.mod;1 │ │ │ │ │ ----------- 0 0 0 5396 Feb 12 2025 [ 2177 00] ufs2.mod;1 │ │ │ │ │ ----------- 0 0 0 6492 Feb 12 2025 [ 2180 00] uhci.mod;1 │ │ │ │ │ ----------- 0 0 0 10376 Feb 12 2025 [ 2184 00] usb.mod;1 │ │ │ │ │ ----------- 0 0 0 3764 Feb 12 2025 [ 2190 00] usb_keyb.mod;1 │ │ │ │ │ ----------- 0 0 0 6912 Feb 12 2025 [ 2192 00] usbms.mod;1 │ │ │ │ │ ----------- 0 0 0 1916 Feb 12 2025 [ 2196 00] usbseri0.mod;1 │ │ │ │ │ ----------- 0 0 0 2296 Feb 12 2025 [ 2197 00] usbseri1.mod;1 │ │ │ │ │ ----------- 0 0 0 2632 Feb 12 2025 [ 2199 00] usbseri2.mod;1 │ │ │ │ │ ----------- 0 0 0 1460 Feb 12 2025 [ 2201 00] usbseri3.mod;1 │ │ │ │ │ ----------- 0 0 0 3568 Feb 12 2025 [ 2202 00] usbtest.mod;1 │ │ │ │ │ ----------- 0 0 0 9828 Feb 12 2025 [ 2204 00] vbe.mod;1 │ │ │ │ │ ----------- 0 0 0 2652 Feb 12 2025 [ 2209 00] verifier.mod;1 │ │ │ │ │ ----------- 0 0 0 4932 Feb 12 2025 [ 2211 00] vga.mod;1 │ │ │ │ │ ----------- 0 0 0 2140 Feb 12 2025 [ 2214 00] vga_text.mod;1 │ │ │ │ │ ----------- 0 0 0 33 Feb 12 2025 [ 2216 00] video.lst;1 │ │ │ │ │ ----------- 0 0 0 5980 Feb 12 2025 [ 2217 00] video.mod;1 │ │ │ │ │ ----------- 0 0 0 5588 Feb 12 2025 [ 2220 00] video_bo.mod;1 │ │ │ │ │ ----------- 0 0 0 6004 Feb 12 2025 [ 2223 00] video_ci.mod;1 │ │ │ │ │ ----------- 0 0 0 5568 Feb 12 2025 [ 2226 00] video_co.mod;1 │ │ │ │ │ ----------- 0 0 0 21016 Feb 12 2025 [ 2229 00] video_fb.mod;1 │ │ │ │ │ ----------- 0 0 0 3892 Feb 12 2025 [ 2240 00] videoinf.mod;1 │ │ │ │ │ ----------- 0 0 0 4216 Feb 12 2025 [ 2242 00] videote0.mod;1 │ │ │ │ │ ----------- 0 0 0 2284 Feb 12 2025 [ 2245 00] videote1.mod;1 │ │ │ │ │ ----------- 0 0 0 1448 Feb 12 2025 [ 2247 00] wrmsr.mod;1 │ │ │ │ │ ----------- 0 0 0 7484 Feb 12 2025 [ 2248 00] xfs.mod;1 │ │ │ │ │ ----------- 0 0 0 27468 Feb 12 2025 [ 2252 00] xnu.mod;1 │ │ │ │ │ ----------- 0 0 0 2084 Feb 12 2025 [ 2266 00] xnu_uui0.mod;1 │ │ │ │ │ ----------- 0 0 0 1924 Feb 12 2025 [ 2268 00] xnu_uui1.mod;1 │ │ │ │ │ ----------- 0 0 0 15456 Feb 12 2025 [ 2269 00] xzio.mod;1 │ │ │ │ │ ----------- 0 0 0 40256 Feb 12 2025 [ 2277 00] zfs.mod;1 │ │ │ │ │ ----------- 0 0 0 5488 Feb 12 2025 [ 2297 00] zfscrypt.mod;1 │ │ │ │ │ ----------- 0 0 0 6588 Feb 12 2025 [ 2300 00] zfsinfo.mod;1 │ │ │ │ │ ----------- 0 0 0 45868 Feb 12 2025 [ 2304 00] zstd.mod;1 │ │ │ │ │ +d--------- 0 0 0 38912 Jan 11 2024 [ 24 02] . │ │ │ │ │ +d--------- 0 0 0 2048 Jan 11 2024 [ 22 02] .. │ │ │ │ │ +---------- 0 0 0 7780 Jan 11 2024 [ 1219 00] 915resol.mod;1 │ │ │ │ │ +---------- 0 0 0 10868 Jan 11 2024 [ 1223 00] acpi.mod;1 │ │ │ │ │ +---------- 0 0 0 1228 Jan 11 2024 [ 1229 00] adler32.mod;1 │ │ │ │ │ +---------- 0 0 0 5568 Jan 11 2024 [ 1230 00] affs.mod;1 │ │ │ │ │ +---------- 0 0 0 6020 Jan 11 2024 [ 1233 00] afs.mod;1 │ │ │ │ │ +---------- 0 0 0 1516 Jan 11 2024 [ 1236 00] afsplitt.mod;1 │ │ │ │ │ +---------- 0 0 0 15392 Jan 11 2024 [ 1237 00] ahci.mod;1 │ │ │ │ │ +---------- 0 0 0 492 Jan 11 2024 [ 1245 00] all_vide.mod;1 │ │ │ │ │ +---------- 0 0 0 956 Jan 11 2024 [ 1246 00] aout.mod;1 │ │ │ │ │ +---------- 0 0 0 2836 Jan 11 2024 [ 1247 00] archelp.mod;1 │ │ │ │ │ +---------- 0 0 0 4068 Jan 11 2024 [ 1249 00] at_keybo.mod;1 │ │ │ │ │ +---------- 0 0 0 5524 Jan 11 2024 [ 1251 00] ata.mod;1 │ │ │ │ │ +---------- 0 0 0 1576 Jan 11 2024 [ 1254 00] backtrac.mod;1 │ │ │ │ │ +---------- 0 0 0 6728 Jan 11 2024 [ 1255 00] bfs.mod;1 │ │ │ │ │ +---------- 0 0 0 4636 Jan 11 2024 [ 1259 00] biosdisk.mod;1 │ │ │ │ │ +---------- 0 0 0 2184 Jan 11 2024 [ 1262 00] bitmap.mod;1 │ │ │ │ │ +---------- 0 0 0 3616 Jan 11 2024 [ 1264 00] bitmap_s.mod;1 │ │ │ │ │ +---------- 0 0 0 1984 Jan 11 2024 [ 1266 00] blocklis.mod;1 │ │ │ │ │ +---------- 0 0 0 2628 Jan 11 2024 [ 1267 00] boot.mod;1 │ │ │ │ │ +---------- 0 0 0 30568 Jan 11 2024 [ 1269 00] bsd.mod;1 │ │ │ │ │ +---------- 0 0 0 2252 Jan 11 2024 [ 1284 00] bswap_te.mod;1 │ │ │ │ │ +---------- 0 0 0 19712 Jan 11 2024 [ 1286 00] btrfs.mod;1 │ │ │ │ │ +---------- 0 0 0 2028 Jan 11 2024 [ 1296 00] bufio.mod;1 │ │ │ │ │ +---------- 0 0 0 2884 Jan 11 2024 [ 1297 00] cat.mod;1 │ │ │ │ │ +---------- 0 0 0 3892 Jan 11 2024 [ 1299 00] cbfs.mod;1 │ │ │ │ │ +---------- 0 0 0 3340 Jan 11 2024 [ 1301 00] cbls.mod;1 │ │ │ │ │ +---------- 0 0 0 2448 Jan 11 2024 [ 1303 00] cbmemc.mod;1 │ │ │ │ │ +---------- 0 0 0 1048 Jan 11 2024 [ 1305 00] cbtable.mod;1 │ │ │ │ │ +---------- 0 0 0 2772 Jan 11 2024 [ 1306 00] cbtime.mod;1 │ │ │ │ │ +---------- 0 0 0 3448 Jan 11 2024 [ 1308 00] chain.mod;1 │ │ │ │ │ +---------- 0 0 0 2960 Jan 11 2024 [ 1310 00] cmdline_.mod;1 │ │ │ │ │ +---------- 0 0 0 1216 Jan 11 2024 [ 1312 00] cmosdump.mod;1 │ │ │ │ │ +---------- 0 0 0 1808 Jan 11 2024 [ 1313 00] cmostest.mod;1 │ │ │ │ │ +---------- 0 0 0 2056 Jan 11 2024 [ 1314 00] cmp.mod;1 │ │ │ │ │ +---------- 0 0 0 4608 Jan 11 2024 [ 1316 00] cmp_test.mod;1 │ │ │ │ │ +---------- 0 0 0 3887 Jan 11 2024 [ 1319 00] command.lst;1 │ │ │ │ │ +---------- 0 0 0 2224 Jan 11 2024 [ 1321 00] configfi.mod;1 │ │ │ │ │ +---------- 0 0 0 2612 Jan 11 2024 [ 1323 00] cpio.mod;1 │ │ │ │ │ +---------- 0 0 0 2680 Jan 11 2024 [ 1325 00] cpio_be.mod;1 │ │ │ │ │ +---------- 0 0 0 1664 Jan 11 2024 [ 1327 00] cpuid.mod;1 │ │ │ │ │ +---------- 0 0 0 1572 Jan 11 2024 [ 1328 00] crc64.mod;1 │ │ │ │ │ +---------- 0 0 0 936 Jan 11 2024 [ 1329 00] crypto.lst;1 │ │ │ │ │ +---------- 0 0 0 4944 Jan 11 2024 [ 1330 00] crypto.mod;1 │ │ │ │ │ +---------- 0 0 0 11900 Jan 11 2024 [ 1333 00] cryptodi.mod;1 │ │ │ │ │ +---------- 0 0 0 3588 Jan 11 2024 [ 1339 00] cs5536.mod;1 │ │ │ │ │ +---------- 0 0 0 1680 Jan 11 2024 [ 1341 00] ctz_test.mod;1 │ │ │ │ │ +---------- 0 0 0 2148 Jan 11 2024 [ 1342 00] date.mod;1 │ │ │ │ │ +---------- 0 0 0 1716 Jan 11 2024 [ 1344 00] datehook.mod;1 │ │ │ │ │ +---------- 0 0 0 2232 Jan 11 2024 [ 1345 00] datetime.mod;1 │ │ │ │ │ +---------- 0 0 0 2332 Jan 11 2024 [ 1347 00] disk.mod;1 │ │ │ │ │ +---------- 0 0 0 9836 Jan 11 2024 [ 1349 00] diskfilt.mod;1 │ │ │ │ │ +---------- 0 0 0 956 Jan 11 2024 [ 1354 00] div.mod;1 │ │ │ │ │ +---------- 0 0 0 5560 Jan 11 2024 [ 1355 00] div_test.mod;1 │ │ │ │ │ +---------- 0 0 0 1772 Jan 11 2024 [ 1358 00] dm_nv.mod;1 │ │ │ │ │ +---------- 0 0 0 5316 Jan 11 2024 [ 1359 00] drivemap.mod;1 │ │ │ │ │ +---------- 0 0 0 1896 Jan 11 2024 [ 1362 00] echo.mod;1 │ │ │ │ │ +---------- 0 0 0 23696 Jan 11 2024 [ 1363 00] efiemu.mod;1 │ │ │ │ │ +---------- 0 0 0 7608 Jan 11 2024 [ 1375 00] efiemu32.o;1 │ │ │ │ │ +---------- 0 0 0 10112 Jan 11 2024 [ 1379 00] efiemu64.o;1 │ │ │ │ │ +---------- 0 0 0 16128 Jan 11 2024 [ 1384 00] ehci.mod;1 │ │ │ │ │ +---------- 0 0 0 4064 Jan 11 2024 [ 1392 00] elf.mod;1 │ │ │ │ │ +---------- 0 0 0 29251 Jan 11 2024 [ 1394 00] eltorito.img;1 │ │ │ │ │ +---------- 0 0 0 1368 Jan 11 2024 [ 1409 00] eval.mod;1 │ │ │ │ │ +---------- 0 0 0 6080 Jan 11 2024 [ 1410 00] exfat.mod;1 │ │ │ │ │ +---------- 0 0 0 1380 Jan 11 2024 [ 1413 00] exfctest.mod;1 │ │ │ │ │ +---------- 0 0 0 6172 Jan 11 2024 [ 1414 00] ext2.mod;1 │ │ │ │ │ +---------- 0 0 0 4640 Jan 11 2024 [ 1418 00] extcmd.mod;1 │ │ │ │ │ +---------- 0 0 0 6460 Jan 11 2024 [ 1421 00] f2fs.mod;1 │ │ │ │ │ +---------- 0 0 0 6192 Jan 11 2024 [ 1425 00] fat.mod;1 │ │ │ │ │ +---------- 0 0 0 16932 Jan 11 2024 [ 1429 00] file.mod;1 │ │ │ │ │ +---------- 0 0 0 13520 Jan 11 2024 [ 1438 00] font.mod;1 │ │ │ │ │ +---------- 0 0 0 2612 Jan 11 2024 [ 1445 00] freedos.mod;1 │ │ │ │ │ +---------- 0 0 0 219 Jan 11 2024 [ 1447 00] fs.lst;1 │ │ │ │ │ +---------- 0 0 0 2920 Jan 11 2024 [ 1448 00] fshelp.mod;1 │ │ │ │ │ +---------- 0 0 0 34168 Jan 11 2024 [ 1450 00] function.mod;1 │ │ │ │ │ +---------- 0 0 0 1612 Jan 11 2024 [ 1467 00] gcry_arc.mod;1 │ │ │ │ │ +---------- 0 0 0 8000 Jan 11 2024 [ 1468 00] gcry_blo.mod;1 │ │ │ │ │ +---------- 0 0 0 33516 Jan 11 2024 [ 1472 00] gcry_cam.mod;1 │ │ │ │ │ +---------- 0 0 0 16356 Jan 11 2024 [ 1489 00] gcry_cas.mod;1 │ │ │ │ │ +---------- 0 0 0 10564 Jan 11 2024 [ 1497 00] gcry_crc.mod;1 │ │ │ │ │ +---------- 0 0 0 19104 Jan 11 2024 [ 1503 00] gcry_des.mod;1 │ │ │ │ │ +---------- 0 0 0 2188 Jan 11 2024 [ 1513 00] gcry_dsa.mod;1 │ │ │ │ │ +---------- 0 0 0 2884 Jan 11 2024 [ 1515 00] gcry_ide.mod;1 │ │ │ │ │ +---------- 0 0 0 3048 Jan 11 2024 [ 1517 00] gcry_md4.mod;1 │ │ │ │ │ +---------- 0 0 0 3668 Jan 11 2024 [ 1519 00] gcry_md5.mod;1 │ │ │ │ │ +---------- 0 0 0 2316 Jan 11 2024 [ 1521 00] gcry_rfc.mod;1 │ │ │ │ │ +---------- 0 0 0 19312 Jan 11 2024 [ 1523 00] gcry_rij.mod;1 │ │ │ │ │ +---------- 0 0 0 8248 Jan 11 2024 [ 1533 00] gcry_rmd.mod;1 │ │ │ │ │ +---------- 0 0 0 1968 Jan 11 2024 [ 1538 00] gcry_rsa.mod;1 │ │ │ │ │ +---------- 0 0 0 14824 Jan 11 2024 [ 1539 00] gcry_see.mod;1 │ │ │ │ │ +---------- 0 0 0 17700 Jan 11 2024 [ 1547 00] gcry_ser.mod;1 │ │ │ │ │ +---------- 0 0 0 8592 Jan 11 2024 [ 1556 00] gcry_sh0.mod;1 │ │ │ │ │ +---------- 0 0 0 4376 Jan 11 2024 [ 1561 00] gcry_sh1.mod;1 │ │ │ │ │ +---------- 0 0 0 8804 Jan 11 2024 [ 1564 00] gcry_sh2.mod;1 │ │ │ │ │ +---------- 0 0 0 12244 Jan 11 2024 [ 1569 00] gcry_tig.mod;1 │ │ │ │ │ +---------- 0 0 0 36816 Jan 11 2024 [ 1575 00] gcry_two.mod;1 │ │ │ │ │ +---------- 0 0 0 24588 Jan 11 2024 [ 1593 00] gcry_whi.mod;1 │ │ │ │ │ +---------- 0 0 0 25036 Jan 11 2024 [ 1606 00] gdb.mod;1 │ │ │ │ │ +---------- 0 0 0 5884 Jan 11 2024 [ 1619 00] geli.mod;1 │ │ │ │ │ +---------- 0 0 0 4860 Jan 11 2024 [ 1622 00] gettext.mod;1 │ │ │ │ │ +---------- 0 0 0 39136 Jan 11 2024 [ 1625 00] gfxmenu.mod;1 │ │ │ │ │ +---------- 0 0 0 9892 Jan 11 2024 [ 1645 00] gfxterm.mod;1 │ │ │ │ │ +---------- 0 0 0 2796 Jan 11 2024 [ 1650 00] gfxterm0.mod;1 │ │ │ │ │ +---------- 0 0 0 4912 Jan 11 2024 [ 1652 00] gfxterm1.mod;1 │ │ │ │ │ +---------- 0 0 0 3740 Jan 11 2024 [ 1655 00] gptsync.mod;1 │ │ │ │ │ +---------- 0 0 0 8784 Jan 11 2024 [ 1657 00] gzio.mod;1 │ │ │ │ │ +---------- 0 0 0 4684 Jan 11 2024 [ 1662 00] halt.mod;1 │ │ │ │ │ +---------- 0 0 0 5168 Jan 11 2024 [ 1665 00] hashsum.mod;1 │ │ │ │ │ +---------- 0 0 0 6560 Jan 11 2024 [ 1668 00] hdparm.mod;1 │ │ │ │ │ +---------- 0 0 0 1140 Jan 11 2024 [ 1672 00] hello.mod;1 │ │ │ │ │ +---------- 0 0 0 2512 Jan 11 2024 [ 1673 00] help.mod;1 │ │ │ │ │ +---------- 0 0 0 3216 Jan 11 2024 [ 1675 00] hexdump.mod;1 │ │ │ │ │ +---------- 0 0 0 7004 Jan 11 2024 [ 1677 00] hfs.mod;1 │ │ │ │ │ +---------- 0 0 0 7848 Jan 11 2024 [ 1681 00] hfsplus.mod;1 │ │ │ │ │ +---------- 0 0 0 2960 Jan 11 2024 [ 1685 00] hfsplusc.mod;1 │ │ │ │ │ +---------- 0 0 0 5700 Jan 11 2024 [ 1687 00] http.mod;1 │ │ │ │ │ +---------- 0 0 0 2468 Jan 11 2024 [ 1690 00] hwmatch.mod;1 │ │ │ │ │ +---------- 0 0 0 2800 Jan 11 2024 [ 1692 00] iorw.mod;1 │ │ │ │ │ +---------- 0 0 0 8488 Jan 11 2024 [ 1694 00] iso9660.mod;1 │ │ │ │ │ +---------- 0 0 0 6092 Jan 11 2024 [ 1699 00] jfs.mod;1 │ │ │ │ │ +---------- 0 0 0 7660 Jan 11 2024 [ 1702 00] jpeg.mod;1 │ │ │ │ │ +---------- 0 0 0 3504 Jan 11 2024 [ 1706 00] json.mod;1 │ │ │ │ │ +---------- 0 0 0 5032 Jan 11 2024 [ 1708 00] keylayou.mod;1 │ │ │ │ │ +---------- 0 0 0 1904 Jan 11 2024 [ 1711 00] keystatu.mod;1 │ │ │ │ │ +---------- 0 0 0 6300 Jan 11 2024 [ 1712 00] ldm.mod;1 │ │ │ │ │ +---------- 0 0 0 14404 Jan 11 2024 [ 1716 00] legacy_p.mod;1 │ │ │ │ │ +---------- 0 0 0 30132 Jan 11 2024 [ 1724 00] legacycf.mod;1 │ │ │ │ │ +---------- 0 0 0 13172 Jan 11 2024 [ 1739 00] linux.mod;1 │ │ │ │ │ +---------- 0 0 0 5524 Jan 11 2024 [ 1746 00] linux16.mod;1 │ │ │ │ │ +---------- 0 0 0 5748 Jan 11 2024 [ 1749 00] loadenv.mod;1 │ │ │ │ │ +---------- 0 0 0 3004 Jan 11 2024 [ 1752 00] loopback.mod;1 │ │ │ │ │ +---------- 0 0 0 3856 Jan 11 2024 [ 1754 00] ls.mod;1 │ │ │ │ │ +---------- 0 0 0 4740 Jan 11 2024 [ 1756 00] lsacpi.mod;1 │ │ │ │ │ +---------- 0 0 0 2236 Jan 11 2024 [ 1759 00] lsapm.mod;1 │ │ │ │ │ +---------- 0 0 0 1820 Jan 11 2024 [ 1761 00] lsmmap.mod;1 │ │ │ │ │ +---------- 0 0 0 4828 Jan 11 2024 [ 1762 00] lspci.mod;1 │ │ │ │ │ +---------- 0 0 0 4356 Jan 11 2024 [ 1765 00] luks.mod;1 │ │ │ │ │ +---------- 0 0 0 14216 Jan 11 2024 [ 1768 00] luks2.mod;1 │ │ │ │ │ +---------- 0 0 0 8472 Jan 11 2024 [ 1775 00] lvm.mod;1 │ │ │ │ │ +---------- 0 0 0 4756 Jan 11 2024 [ 1780 00] lzopio.mod;1 │ │ │ │ │ +---------- 0 0 0 3200 Jan 11 2024 [ 1783 00] macbless.mod;1 │ │ │ │ │ +---------- 0 0 0 7500 Jan 11 2024 [ 1785 00] macho.mod;1 │ │ │ │ │ +---------- 0 0 0 2044 Jan 11 2024 [ 1789 00] mda_text.mod;1 │ │ │ │ │ +---------- 0 0 0 2112 Jan 11 2024 [ 1790 00] mdraid00.mod;1 │ │ │ │ │ +---------- 0 0 0 1968 Jan 11 2024 [ 1792 00] mdraid01.mod;1 │ │ │ │ │ +---------- 0 0 0 1852 Jan 11 2024 [ 1793 00] mdraid1x.mod;1 │ │ │ │ │ +---------- 0 0 0 1988 Jan 11 2024 [ 1794 00] memdisk.mod;1 │ │ │ │ │ +---------- 0 0 0 2824 Jan 11 2024 [ 1795 00] memrw.mod;1 │ │ │ │ │ +---------- 0 0 0 3504 Jan 11 2024 [ 1797 00] minicmd.mod;1 │ │ │ │ │ +---------- 0 0 0 3596 Jan 11 2024 [ 1799 00] minix.mod;1 │ │ │ │ │ +---------- 0 0 0 3692 Jan 11 2024 [ 1801 00] minix2.mod;1 │ │ │ │ │ +---------- 0 0 0 3856 Jan 11 2024 [ 1803 00] minix2_b.mod;1 │ │ │ │ │ +---------- 0 0 0 3692 Jan 11 2024 [ 1805 00] minix3.mod;1 │ │ │ │ │ +---------- 0 0 0 3856 Jan 11 2024 [ 1807 00] minix3_b.mod;1 │ │ │ │ │ +---------- 0 0 0 3724 Jan 11 2024 [ 1809 00] minix_be.mod;1 │ │ │ │ │ +---------- 0 0 0 8544 Jan 11 2024 [ 1811 00] mmap.mod;1 │ │ │ │ │ +---------- 0 0 0 5709 Jan 11 2024 [ 1816 00] moddep.lst;1 │ │ │ │ │ +---------- 0 0 0 2565 Jan 11 2024 [ 1819 00] modinfo.sh;1 │ │ │ │ │ +---------- 0 0 0 2348 Jan 11 2024 [ 1821 00] morse.mod;1 │ │ │ │ │ +---------- 0 0 0 27896 Jan 11 2024 [ 1823 00] mpi.mod;1 │ │ │ │ │ +---------- 0 0 0 2396 Jan 11 2024 [ 1837 00] msdospar.mod;1 │ │ │ │ │ +---------- 0 0 0 2016 Jan 11 2024 [ 1839 00] mul_test.mod;1 │ │ │ │ │ +---------- 0 0 0 13920 Jan 11 2024 [ 1840 00] multibo0.mod;1 │ │ │ │ │ +---------- 0 0 0 15068 Jan 11 2024 [ 1847 00] multibo1.mod;1 │ │ │ │ │ +---------- 0 0 0 4156 Jan 11 2024 [ 1855 00] nativedi.mod;1 │ │ │ │ │ +---------- 0 0 0 57256 Jan 11 2024 [ 1858 00] net.mod;1 │ │ │ │ │ +---------- 0 0 0 2836 Jan 11 2024 [ 1886 00] newc.mod;1 │ │ │ │ │ +---------- 0 0 0 6744 Jan 11 2024 [ 1888 00] nilfs2.mod;1 │ │ │ │ │ +---------- 0 0 0 114896 Jan 11 2024 [ 1892 00] normal.mod;1 │ │ │ │ │ +---------- 0 0 0 10652 Jan 11 2024 [ 1949 00] ntfs.mod;1 │ │ │ │ │ +---------- 0 0 0 4260 Jan 11 2024 [ 1955 00] ntfscomp.mod;1 │ │ │ │ │ +---------- 0 0 0 2504 Jan 11 2024 [ 1958 00] ntldr.mod;1 │ │ │ │ │ +---------- 0 0 0 2676 Jan 11 2024 [ 1960 00] odc.mod;1 │ │ │ │ │ +---------- 0 0 0 1456 Jan 11 2024 [ 1962 00] offsetio.mod;1 │ │ │ │ │ +---------- 0 0 0 10420 Jan 11 2024 [ 1963 00] ohci.mod;1 │ │ │ │ │ +---------- 0 0 0 1584 Jan 11 2024 [ 1969 00] part_aco.mod;1 │ │ │ │ │ +---------- 0 0 0 1812 Jan 11 2024 [ 1970 00] part_ami.mod;1 │ │ │ │ │ +---------- 0 0 0 2052 Jan 11 2024 [ 1971 00] part_app.mod;1 │ │ │ │ │ +---------- 0 0 0 2680 Jan 11 2024 [ 1973 00] part_bsd.mod;1 │ │ │ │ │ +---------- 0 0 0 1708 Jan 11 2024 [ 1975 00] part_dfl.mod;1 │ │ │ │ │ +---------- 0 0 0 1424 Jan 11 2024 [ 1976 00] part_dvh.mod;1 │ │ │ │ │ +---------- 0 0 0 2292 Jan 11 2024 [ 1977 00] part_gpt.mod;1 │ │ │ │ │ +---------- 0 0 0 2280 Jan 11 2024 [ 1979 00] part_msd.mod;1 │ │ │ │ │ +---------- 0 0 0 1732 Jan 11 2024 [ 1981 00] part_pla.mod;1 │ │ │ │ │ +---------- 0 0 0 1452 Jan 11 2024 [ 1982 00] part_su0.mod;1 │ │ │ │ │ +---------- 0 0 0 1580 Jan 11 2024 [ 1983 00] part_su1.mod;1 │ │ │ │ │ +---------- 0 0 0 111 Jan 11 2024 [ 1984 00] partmap.lst;1 │ │ │ │ │ +---------- 0 0 0 17 Jan 11 2024 [ 1985 00] parttool.lst;1 │ │ │ │ │ +---------- 0 0 0 4644 Jan 11 2024 [ 1986 00] parttool.mod;1 │ │ │ │ │ +---------- 0 0 0 1820 Jan 11 2024 [ 1989 00] passwor0.mod;1 │ │ │ │ │ +---------- 0 0 0 2712 Jan 11 2024 [ 1990 00] passwor1.mod;1 │ │ │ │ │ +---------- 0 0 0 4812 Jan 11 2024 [ 1992 00] pata.mod;1 │ │ │ │ │ +---------- 0 0 0 1312 Jan 11 2024 [ 1995 00] pbkdf2.mod;1 │ │ │ │ │ +---------- 0 0 0 2100 Jan 11 2024 [ 1996 00] pbkdf2_t.mod;1 │ │ │ │ │ +---------- 0 0 0 1316 Jan 11 2024 [ 1998 00] pci.mod;1 │ │ │ │ │ +---------- 0 0 0 2416 Jan 11 2024 [ 1999 00] pcidump.mod;1 │ │ │ │ │ +---------- 0 0 0 11376 Jan 11 2024 [ 2001 00] pgp.mod;1 │ │ │ │ │ +---------- 0 0 0 6292 Jan 11 2024 [ 2007 00] plan9.mod;1 │ │ │ │ │ +---------- 0 0 0 2452 Jan 11 2024 [ 2011 00] play.mod;1 │ │ │ │ │ +---------- 0 0 0 8052 Jan 11 2024 [ 2013 00] png.mod;1 │ │ │ │ │ +---------- 0 0 0 1516 Jan 11 2024 [ 2017 00] priority.mod;1 │ │ │ │ │ +---------- 0 0 0 3456 Jan 11 2024 [ 2018 00] probe.mod;1 │ │ │ │ │ +---------- 0 0 0 2284 Jan 11 2024 [ 2020 00] procfs.mod;1 │ │ │ │ │ +---------- 0 0 0 2136 Jan 11 2024 [ 2022 00] progress.mod;1 │ │ │ │ │ +---------- 0 0 0 3680 Jan 11 2024 [ 2024 00] pxe.mod;1 │ │ │ │ │ +---------- 0 0 0 2616 Jan 11 2024 [ 2026 00] pxechain.mod;1 │ │ │ │ │ +---------- 0 0 0 1292 Jan 11 2024 [ 2028 00] raid5rec.mod;1 │ │ │ │ │ +---------- 0 0 0 2204 Jan 11 2024 [ 2029 00] raid6rec.mod;1 │ │ │ │ │ +---------- 0 0 0 2784 Jan 11 2024 [ 2031 00] random.mod;1 │ │ │ │ │ +---------- 0 0 0 1848 Jan 11 2024 [ 2033 00] rdmsr.mod;1 │ │ │ │ │ +---------- 0 0 0 1404 Jan 11 2024 [ 2034 00] read.mod;1 │ │ │ │ │ +---------- 0 0 0 1636 Jan 11 2024 [ 2035 00] reboot.mod;1 │ │ │ │ │ +---------- 0 0 0 51032 Jan 11 2024 [ 2036 00] regexp.mod;1 │ │ │ │ │ +---------- 0 0 0 8788 Jan 11 2024 [ 2061 00] reiserfs.mod;1 │ │ │ │ │ +---------- 0 0 0 14952 Jan 11 2024 [ 2066 00] relocato.mod;1 │ │ │ │ │ +---------- 0 0 0 4052 Jan 11 2024 [ 2074 00] romfs.mod;1 │ │ │ │ │ +---------- 0 0 0 4644 Jan 11 2024 [ 2076 00] scsi.mod;1 │ │ │ │ │ +---------- 0 0 0 3624 Jan 11 2024 [ 2079 00] search.mod;1 │ │ │ │ │ +---------- 0 0 0 3052 Jan 11 2024 [ 2081 00] search_0.mod;1 │ │ │ │ │ +---------- 0 0 0 3156 Jan 11 2024 [ 2083 00] search_1.mod;1 │ │ │ │ │ +---------- 0 0 0 3072 Jan 11 2024 [ 2085 00] search_l.mod;1 │ │ │ │ │ +---------- 0 0 0 7068 Jan 11 2024 [ 2087 00] sendkey.mod;1 │ │ │ │ │ +---------- 0 0 0 7696 Jan 11 2024 [ 2091 00] serial.mod;1 │ │ │ │ │ +---------- 0 0 0 628 Jan 11 2024 [ 2095 00] setjmp.mod;1 │ │ │ │ │ +---------- 0 0 0 1624 Jan 11 2024 [ 2096 00] setjmp_t.mod;1 │ │ │ │ │ +---------- 0 0 0 5224 Jan 11 2024 [ 2097 00] setpci.mod;1 │ │ │ │ │ +---------- 0 0 0 5116 Jan 11 2024 [ 2100 00] sfs.mod;1 │ │ │ │ │ +---------- 0 0 0 2396 Jan 11 2024 [ 2103 00] shift_te.mod;1 │ │ │ │ │ +---------- 0 0 0 6380 Jan 11 2024 [ 2105 00] signatur.mod;1 │ │ │ │ │ +---------- 0 0 0 2144 Jan 11 2024 [ 2109 00] sleep.mod;1 │ │ │ │ │ +---------- 0 0 0 2260 Jan 11 2024 [ 2111 00] sleep_te.mod;1 │ │ │ │ │ +---------- 0 0 0 5564 Jan 11 2024 [ 2113 00] smbios.mod;1 │ │ │ │ │ +---------- 0 0 0 2024 Jan 11 2024 [ 2116 00] spkmodem.mod;1 │ │ │ │ │ +---------- 0 0 0 7132 Jan 11 2024 [ 2117 00] squash4.mod;1 │ │ │ │ │ +---------- 0 0 0 2112 Jan 11 2024 [ 2121 00] strtoull.mod;1 │ │ │ │ │ +---------- 0 0 0 17420 Jan 11 2024 [ 2123 00] syslinux.mod;1 │ │ │ │ │ +---------- 0 0 0 3216 Jan 11 2024 [ 2132 00] tar.mod;1 │ │ │ │ │ +---------- 0 0 0 202 Jan 11 2024 [ 2134 00] terminal.lst;1 │ │ │ │ │ +---------- 0 0 0 4448 Jan 11 2024 [ 2135 00] terminal.mod;1 │ │ │ │ │ +---------- 0 0 0 12356 Jan 11 2024 [ 2138 00] terminfo.mod;1 │ │ │ │ │ +---------- 0 0 0 5000 Jan 11 2024 [ 2145 00] test.mod;1 │ │ │ │ │ +---------- 0 0 0 1272 Jan 11 2024 [ 2148 00] test_blo.mod;1 │ │ │ │ │ +---------- 0 0 0 2736 Jan 11 2024 [ 2149 00] testload.mod;1 │ │ │ │ │ +---------- 0 0 0 2264 Jan 11 2024 [ 2151 00] testspee.mod;1 │ │ │ │ │ +---------- 0 0 0 4920 Jan 11 2024 [ 2153 00] tftp.mod;1 │ │ │ │ │ +---------- 0 0 0 4588 Jan 11 2024 [ 2156 00] tga.mod;1 │ │ │ │ │ +---------- 0 0 0 1456 Jan 11 2024 [ 2159 00] time.mod;1 │ │ │ │ │ +---------- 0 0 0 2352 Jan 11 2024 [ 2160 00] tr.mod;1 │ │ │ │ │ +---------- 0 0 0 1668 Jan 11 2024 [ 2162 00] trig.mod;1 │ │ │ │ │ +---------- 0 0 0 1152 Jan 11 2024 [ 2163 00] true.mod;1 │ │ │ │ │ +---------- 0 0 0 3728 Jan 11 2024 [ 2164 00] truecryp.mod;1 │ │ │ │ │ +---------- 0 0 0 8500 Jan 11 2024 [ 2166 00] udf.mod;1 │ │ │ │ │ +---------- 0 0 0 5332 Jan 11 2024 [ 2171 00] ufs1.mod;1 │ │ │ │ │ +---------- 0 0 0 5716 Jan 11 2024 [ 2174 00] ufs1_be.mod;1 │ │ │ │ │ +---------- 0 0 0 5396 Jan 11 2024 [ 2177 00] ufs2.mod;1 │ │ │ │ │ +---------- 0 0 0 6492 Jan 11 2024 [ 2180 00] uhci.mod;1 │ │ │ │ │ +---------- 0 0 0 10376 Jan 11 2024 [ 2184 00] usb.mod;1 │ │ │ │ │ +---------- 0 0 0 3764 Jan 11 2024 [ 2190 00] usb_keyb.mod;1 │ │ │ │ │ +---------- 0 0 0 6912 Jan 11 2024 [ 2192 00] usbms.mod;1 │ │ │ │ │ +---------- 0 0 0 1916 Jan 11 2024 [ 2196 00] usbseri0.mod;1 │ │ │ │ │ +---------- 0 0 0 2296 Jan 11 2024 [ 2197 00] usbseri1.mod;1 │ │ │ │ │ +---------- 0 0 0 2632 Jan 11 2024 [ 2199 00] usbseri2.mod;1 │ │ │ │ │ +---------- 0 0 0 1460 Jan 11 2024 [ 2201 00] usbseri3.mod;1 │ │ │ │ │ +---------- 0 0 0 3568 Jan 11 2024 [ 2202 00] usbtest.mod;1 │ │ │ │ │ +---------- 0 0 0 9828 Jan 11 2024 [ 2204 00] vbe.mod;1 │ │ │ │ │ +---------- 0 0 0 2652 Jan 11 2024 [ 2209 00] verifier.mod;1 │ │ │ │ │ +---------- 0 0 0 4932 Jan 11 2024 [ 2211 00] vga.mod;1 │ │ │ │ │ +---------- 0 0 0 2140 Jan 11 2024 [ 2214 00] vga_text.mod;1 │ │ │ │ │ +---------- 0 0 0 33 Jan 11 2024 [ 2216 00] video.lst;1 │ │ │ │ │ +---------- 0 0 0 5980 Jan 11 2024 [ 2217 00] video.mod;1 │ │ │ │ │ +---------- 0 0 0 5588 Jan 11 2024 [ 2220 00] video_bo.mod;1 │ │ │ │ │ +---------- 0 0 0 6004 Jan 11 2024 [ 2223 00] video_ci.mod;1 │ │ │ │ │ +---------- 0 0 0 5568 Jan 11 2024 [ 2226 00] video_co.mod;1 │ │ │ │ │ +---------- 0 0 0 21016 Jan 11 2024 [ 2229 00] video_fb.mod;1 │ │ │ │ │ +---------- 0 0 0 3892 Jan 11 2024 [ 2240 00] videoinf.mod;1 │ │ │ │ │ +---------- 0 0 0 4216 Jan 11 2024 [ 2242 00] videote0.mod;1 │ │ │ │ │ +---------- 0 0 0 2284 Jan 11 2024 [ 2245 00] videote1.mod;1 │ │ │ │ │ +---------- 0 0 0 1448 Jan 11 2024 [ 2247 00] wrmsr.mod;1 │ │ │ │ │ +---------- 0 0 0 7484 Jan 11 2024 [ 2248 00] xfs.mod;1 │ │ │ │ │ +---------- 0 0 0 27468 Jan 11 2024 [ 2252 00] xnu.mod;1 │ │ │ │ │ +---------- 0 0 0 2084 Jan 11 2024 [ 2266 00] xnu_uui0.mod;1 │ │ │ │ │ +---------- 0 0 0 1924 Jan 11 2024 [ 2268 00] xnu_uui1.mod;1 │ │ │ │ │ +---------- 0 0 0 15456 Jan 11 2024 [ 2269 00] xzio.mod;1 │ │ │ │ │ +---------- 0 0 0 40256 Jan 11 2024 [ 2277 00] zfs.mod;1 │ │ │ │ │ +---------- 0 0 0 5488 Jan 11 2024 [ 2297 00] zfscrypt.mod;1 │ │ │ │ │ +---------- 0 0 0 6588 Jan 11 2024 [ 2300 00] zfsinfo.mod;1 │ │ │ │ │ +---------- 0 0 0 45868 Jan 11 2024 [ 2304 00] zstd.mod;1 │ │ │ │ │ │ │ │ │ │ Directory listing of /boot/grub/locale/ │ │ │ │ │ -d--------- 0 0 0 2048 Feb 12 2025 [ 43 02] . │ │ │ │ │ -d--------- 0 0 0 2048 Feb 12 2025 [ 22 02] .. │ │ │ │ │ +d--------- 0 0 0 2048 Jan 11 2024 [ 43 02] . │ │ │ │ │ +d--------- 0 0 0 2048 Jan 11 2024 [ 22 02] .. │ │ │ │ │ │ │ │ │ │ Directory listing of /boot/grub/roms/ │ │ │ │ │ -d--------- 0 0 0 2048 Feb 12 2025 [ 44 02] . │ │ │ │ │ -d--------- 0 0 0 2048 Feb 12 2025 [ 22 02] .. │ │ │ │ │ +d--------- 0 0 0 2048 Jan 11 2024 [ 44 02] . │ │ │ │ │ +d--------- 0 0 0 2048 Jan 11 2024 [ 22 02] .. │ │ │ │ ├── isoinfo -l -i {} -R │ │ │ │ │ @@ -1,324 +1,324 @@ │ │ │ │ │ │ │ │ │ │ Directory listing of / │ │ │ │ │ -dr-xr-xr-x 1 0 0 2048 Feb 12 2025 [ 19 02] . │ │ │ │ │ -dr-xr-xr-x 1 0 0 2048 Feb 12 2025 [ 19 02] .. │ │ │ │ │ -dr-xr-xr-x 1 0 0 2048 Feb 12 2025 [ 21 02] boot │ │ │ │ │ --r--r--r-- 1 0 0 2048 Feb 12 2025 [ 48 00] boot.catalog │ │ │ │ │ +dr-xr-xr-x 1 0 0 2048 Jan 11 2024 [ 19 02] . │ │ │ │ │ +dr-xr-xr-x 1 0 0 2048 Jan 11 2024 [ 19 02] .. │ │ │ │ │ +dr-xr-xr-x 1 0 0 2048 Jan 11 2024 [ 21 02] boot │ │ │ │ │ +-r--r--r-- 1 0 0 2048 Jan 11 2024 [ 48 00] boot.catalog │ │ │ │ │ │ │ │ │ │ Directory listing of /boot/ │ │ │ │ │ -dr-xr-xr-x 1 0 0 2048 Feb 12 2025 [ 21 02] . │ │ │ │ │ -dr-xr-xr-x 1 0 0 2048 Feb 12 2025 [ 19 02] .. │ │ │ │ │ -dr-xr-xr-x 1 0 0 2048 Feb 12 2025 [ 22 02] grub │ │ │ │ │ +dr-xr-xr-x 1 0 0 2048 Jan 11 2024 [ 21 02] . │ │ │ │ │ +dr-xr-xr-x 1 0 0 2048 Jan 11 2024 [ 19 02] .. │ │ │ │ │ +dr-xr-xr-x 1 0 0 2048 Jan 11 2024 [ 22 02] grub │ │ │ │ │ │ │ │ │ │ Directory listing of /boot/grub/ │ │ │ │ │ -dr-xr-xr-x 1 0 0 2048 Feb 12 2025 [ 22 02] . │ │ │ │ │ -dr-xr-xr-x 1 0 0 2048 Feb 12 2025 [ 21 02] .. │ │ │ │ │ -dr-xr-xr-x 1 0 0 2048 Feb 12 2025 [ 23 02] fonts │ │ │ │ │ --r--r--r-- 1 0 0 1705 Feb 12 2025 [ 1218 00] grub.cfg │ │ │ │ │ -dr-xr-xr-x 1 0 0 38912 Feb 12 2025 [ 24 02] i386-pc │ │ │ │ │ -dr-xr-xr-x 1 0 0 2048 Feb 12 2025 [ 43 02] locale │ │ │ │ │ -dr-xr-xr-x 1 0 0 2048 Feb 12 2025 [ 44 02] roms │ │ │ │ │ +dr-xr-xr-x 1 0 0 2048 Jan 11 2024 [ 22 02] . │ │ │ │ │ +dr-xr-xr-x 1 0 0 2048 Jan 11 2024 [ 21 02] .. │ │ │ │ │ +dr-xr-xr-x 1 0 0 2048 Jan 11 2024 [ 23 02] fonts │ │ │ │ │ +-r--r--r-- 1 0 0 1705 Jan 11 2024 [ 1218 00] grub.cfg │ │ │ │ │ +dr-xr-xr-x 1 0 0 38912 Jan 11 2024 [ 24 02] i386-pc │ │ │ │ │ +dr-xr-xr-x 1 0 0 2048 Jan 11 2024 [ 43 02] locale │ │ │ │ │ +dr-xr-xr-x 1 0 0 2048 Jan 11 2024 [ 44 02] roms │ │ │ │ │ │ │ │ │ │ Directory listing of /boot/grub/fonts/ │ │ │ │ │ -dr-xr-xr-x 1 0 0 2048 Feb 12 2025 [ 23 02] . │ │ │ │ │ -dr-xr-xr-x 1 0 0 2048 Feb 12 2025 [ 22 02] .. │ │ │ │ │ --r--r--r-- 1 0 0 2392304 Feb 12 2025 [ 49 00] unicode.pf2 │ │ │ │ │ +dr-xr-xr-x 1 0 0 2048 Jan 11 2024 [ 23 02] . │ │ │ │ │ +dr-xr-xr-x 1 0 0 2048 Jan 11 2024 [ 22 02] .. │ │ │ │ │ +-r--r--r-- 1 0 0 2392304 Jan 11 2024 [ 49 00] unicode.pf2 │ │ │ │ │ │ │ │ │ │ Directory listing of /boot/grub/i386-pc/ │ │ │ │ │ -dr-xr-xr-x 1 0 0 38912 Feb 12 2025 [ 24 02] . │ │ │ │ │ -dr-xr-xr-x 1 0 0 2048 Feb 12 2025 [ 22 02] .. │ │ │ │ │ --r--r--r-- 1 0 0 7780 Feb 12 2025 [ 1219 00] 915resolution.mod │ │ │ │ │ --r--r--r-- 1 0 0 10868 Feb 12 2025 [ 1223 00] acpi.mod │ │ │ │ │ --r--r--r-- 1 0 0 1228 Feb 12 2025 [ 1229 00] adler32.mod │ │ │ │ │ --r--r--r-- 1 0 0 5568 Feb 12 2025 [ 1230 00] affs.mod │ │ │ │ │ --r--r--r-- 1 0 0 6020 Feb 12 2025 [ 1233 00] afs.mod │ │ │ │ │ --r--r--r-- 1 0 0 1516 Feb 12 2025 [ 1236 00] afsplitter.mod │ │ │ │ │ --r--r--r-- 1 0 0 15392 Feb 12 2025 [ 1237 00] ahci.mod │ │ │ │ │ --r--r--r-- 1 0 0 492 Feb 12 2025 [ 1245 00] all_video.mod │ │ │ │ │ --r--r--r-- 1 0 0 956 Feb 12 2025 [ 1246 00] aout.mod │ │ │ │ │ --r--r--r-- 1 0 0 2836 Feb 12 2025 [ 1247 00] archelp.mod │ │ │ │ │ --r--r--r-- 1 0 0 4068 Feb 12 2025 [ 1249 00] at_keyboard.mod │ │ │ │ │ --r--r--r-- 1 0 0 5524 Feb 12 2025 [ 1251 00] ata.mod │ │ │ │ │ --r--r--r-- 1 0 0 1576 Feb 12 2025 [ 1254 00] backtrace.mod │ │ │ │ │ --r--r--r-- 1 0 0 6728 Feb 12 2025 [ 1255 00] bfs.mod │ │ │ │ │ --r--r--r-- 1 0 0 4636 Feb 12 2025 [ 1259 00] biosdisk.mod │ │ │ │ │ --r--r--r-- 1 0 0 2184 Feb 12 2025 [ 1262 00] bitmap.mod │ │ │ │ │ --r--r--r-- 1 0 0 3616 Feb 12 2025 [ 1264 00] bitmap_scale.mod │ │ │ │ │ --r--r--r-- 1 0 0 1984 Feb 12 2025 [ 1266 00] blocklist.mod │ │ │ │ │ --r--r--r-- 1 0 0 2628 Feb 12 2025 [ 1267 00] boot.mod │ │ │ │ │ --r--r--r-- 1 0 0 30568 Feb 12 2025 [ 1269 00] bsd.mod │ │ │ │ │ --r--r--r-- 1 0 0 2252 Feb 12 2025 [ 1284 00] bswap_test.mod │ │ │ │ │ --r--r--r-- 1 0 0 19712 Feb 12 2025 [ 1286 00] btrfs.mod │ │ │ │ │ --r--r--r-- 1 0 0 2028 Feb 12 2025 [ 1296 00] bufio.mod │ │ │ │ │ --r--r--r-- 1 0 0 2884 Feb 12 2025 [ 1297 00] cat.mod │ │ │ │ │ --r--r--r-- 1 0 0 3892 Feb 12 2025 [ 1299 00] cbfs.mod │ │ │ │ │ --r--r--r-- 1 0 0 3340 Feb 12 2025 [ 1301 00] cbls.mod │ │ │ │ │ --r--r--r-- 1 0 0 2448 Feb 12 2025 [ 1303 00] cbmemc.mod │ │ │ │ │ --r--r--r-- 1 0 0 1048 Feb 12 2025 [ 1305 00] cbtable.mod │ │ │ │ │ --r--r--r-- 1 0 0 2772 Feb 12 2025 [ 1306 00] cbtime.mod │ │ │ │ │ --r--r--r-- 1 0 0 3448 Feb 12 2025 [ 1308 00] chain.mod │ │ │ │ │ --r--r--r-- 1 0 0 2960 Feb 12 2025 [ 1310 00] cmdline_cat_test.mod │ │ │ │ │ --r--r--r-- 1 0 0 1216 Feb 12 2025 [ 1312 00] cmosdump.mod │ │ │ │ │ --r--r--r-- 1 0 0 1808 Feb 12 2025 [ 1313 00] cmostest.mod │ │ │ │ │ --r--r--r-- 1 0 0 2056 Feb 12 2025 [ 1314 00] cmp.mod │ │ │ │ │ --r--r--r-- 1 0 0 4608 Feb 12 2025 [ 1316 00] cmp_test.mod │ │ │ │ │ --r--r--r-- 1 0 0 3887 Feb 12 2025 [ 1319 00] command.lst │ │ │ │ │ --r--r--r-- 1 0 0 2224 Feb 12 2025 [ 1321 00] configfile.mod │ │ │ │ │ --r--r--r-- 1 0 0 2612 Feb 12 2025 [ 1323 00] cpio.mod │ │ │ │ │ --r--r--r-- 1 0 0 2680 Feb 12 2025 [ 1325 00] cpio_be.mod │ │ │ │ │ --r--r--r-- 1 0 0 1664 Feb 12 2025 [ 1327 00] cpuid.mod │ │ │ │ │ --r--r--r-- 1 0 0 1572 Feb 12 2025 [ 1328 00] crc64.mod │ │ │ │ │ --r--r--r-- 1 0 0 936 Feb 12 2025 [ 1329 00] crypto.lst │ │ │ │ │ --r--r--r-- 1 0 0 4944 Feb 12 2025 [ 1330 00] crypto.mod │ │ │ │ │ --r--r--r-- 1 0 0 11900 Feb 12 2025 [ 1333 00] cryptodisk.mod │ │ │ │ │ --r--r--r-- 1 0 0 3588 Feb 12 2025 [ 1339 00] cs5536.mod │ │ │ │ │ --r--r--r-- 1 0 0 1680 Feb 12 2025 [ 1341 00] ctz_test.mod │ │ │ │ │ --r--r--r-- 1 0 0 2148 Feb 12 2025 [ 1342 00] date.mod │ │ │ │ │ --r--r--r-- 1 0 0 1716 Feb 12 2025 [ 1344 00] datehook.mod │ │ │ │ │ --r--r--r-- 1 0 0 2232 Feb 12 2025 [ 1345 00] datetime.mod │ │ │ │ │ --r--r--r-- 1 0 0 2332 Feb 12 2025 [ 1347 00] disk.mod │ │ │ │ │ --r--r--r-- 1 0 0 9836 Feb 12 2025 [ 1349 00] diskfilter.mod │ │ │ │ │ --r--r--r-- 1 0 0 956 Feb 12 2025 [ 1354 00] div.mod │ │ │ │ │ --r--r--r-- 1 0 0 5560 Feb 12 2025 [ 1355 00] div_test.mod │ │ │ │ │ --r--r--r-- 1 0 0 1772 Feb 12 2025 [ 1358 00] dm_nv.mod │ │ │ │ │ --r--r--r-- 1 0 0 5316 Feb 12 2025 [ 1359 00] drivemap.mod │ │ │ │ │ --r--r--r-- 1 0 0 1896 Feb 12 2025 [ 1362 00] echo.mod │ │ │ │ │ --r--r--r-- 1 0 0 23696 Feb 12 2025 [ 1363 00] efiemu.mod │ │ │ │ │ --r--r--r-- 1 0 0 7608 Feb 12 2025 [ 1375 00] efiemu32.o │ │ │ │ │ --r--r--r-- 1 0 0 10112 Feb 12 2025 [ 1379 00] efiemu64.o │ │ │ │ │ --r--r--r-- 1 0 0 16128 Feb 12 2025 [ 1384 00] ehci.mod │ │ │ │ │ --r--r--r-- 1 0 0 4064 Feb 12 2025 [ 1392 00] elf.mod │ │ │ │ │ --r--r--r-- 1 0 0 29251 Feb 12 2025 [ 1394 00] eltorito.img │ │ │ │ │ --r--r--r-- 1 0 0 1368 Feb 12 2025 [ 1409 00] eval.mod │ │ │ │ │ --r--r--r-- 1 0 0 6080 Feb 12 2025 [ 1410 00] exfat.mod │ │ │ │ │ --r--r--r-- 1 0 0 1380 Feb 12 2025 [ 1413 00] exfctest.mod │ │ │ │ │ --r--r--r-- 1 0 0 6172 Feb 12 2025 [ 1414 00] ext2.mod │ │ │ │ │ --r--r--r-- 1 0 0 4640 Feb 12 2025 [ 1418 00] extcmd.mod │ │ │ │ │ --r--r--r-- 1 0 0 6460 Feb 12 2025 [ 1421 00] f2fs.mod │ │ │ │ │ --r--r--r-- 1 0 0 6192 Feb 12 2025 [ 1425 00] fat.mod │ │ │ │ │ --r--r--r-- 1 0 0 16932 Feb 12 2025 [ 1429 00] file.mod │ │ │ │ │ --r--r--r-- 1 0 0 13520 Feb 12 2025 [ 1438 00] font.mod │ │ │ │ │ --r--r--r-- 1 0 0 2612 Feb 12 2025 [ 1445 00] freedos.mod │ │ │ │ │ --r--r--r-- 1 0 0 219 Feb 12 2025 [ 1447 00] fs.lst │ │ │ │ │ --r--r--r-- 1 0 0 2920 Feb 12 2025 [ 1448 00] fshelp.mod │ │ │ │ │ --r--r--r-- 1 0 0 34168 Feb 12 2025 [ 1450 00] functional_test.mod │ │ │ │ │ --r--r--r-- 1 0 0 1612 Feb 12 2025 [ 1467 00] gcry_arcfour.mod │ │ │ │ │ --r--r--r-- 1 0 0 8000 Feb 12 2025 [ 1468 00] gcry_blowfish.mod │ │ │ │ │ --r--r--r-- 1 0 0 33516 Feb 12 2025 [ 1472 00] gcry_camellia.mod │ │ │ │ │ --r--r--r-- 1 0 0 16356 Feb 12 2025 [ 1489 00] gcry_cast5.mod │ │ │ │ │ --r--r--r-- 1 0 0 10564 Feb 12 2025 [ 1497 00] gcry_crc.mod │ │ │ │ │ --r--r--r-- 1 0 0 19104 Feb 12 2025 [ 1503 00] gcry_des.mod │ │ │ │ │ --r--r--r-- 1 0 0 2188 Feb 12 2025 [ 1513 00] gcry_dsa.mod │ │ │ │ │ --r--r--r-- 1 0 0 2884 Feb 12 2025 [ 1515 00] gcry_idea.mod │ │ │ │ │ --r--r--r-- 1 0 0 3048 Feb 12 2025 [ 1517 00] gcry_md4.mod │ │ │ │ │ --r--r--r-- 1 0 0 3668 Feb 12 2025 [ 1519 00] gcry_md5.mod │ │ │ │ │ --r--r--r-- 1 0 0 2316 Feb 12 2025 [ 1521 00] gcry_rfc2268.mod │ │ │ │ │ --r--r--r-- 1 0 0 19312 Feb 12 2025 [ 1523 00] gcry_rijndael.mod │ │ │ │ │ --r--r--r-- 1 0 0 8248 Feb 12 2025 [ 1533 00] gcry_rmd160.mod │ │ │ │ │ --r--r--r-- 1 0 0 1968 Feb 12 2025 [ 1538 00] gcry_rsa.mod │ │ │ │ │ --r--r--r-- 1 0 0 14824 Feb 12 2025 [ 1539 00] gcry_seed.mod │ │ │ │ │ --r--r--r-- 1 0 0 17700 Feb 12 2025 [ 1547 00] gcry_serpent.mod │ │ │ │ │ --r--r--r-- 1 0 0 8592 Feb 12 2025 [ 1556 00] gcry_sha1.mod │ │ │ │ │ --r--r--r-- 1 0 0 4376 Feb 12 2025 [ 1561 00] gcry_sha256.mod │ │ │ │ │ --r--r--r-- 1 0 0 8804 Feb 12 2025 [ 1564 00] gcry_sha512.mod │ │ │ │ │ --r--r--r-- 1 0 0 12244 Feb 12 2025 [ 1569 00] gcry_tiger.mod │ │ │ │ │ --r--r--r-- 1 0 0 36816 Feb 12 2025 [ 1575 00] gcry_twofish.mod │ │ │ │ │ --r--r--r-- 1 0 0 24588 Feb 12 2025 [ 1593 00] gcry_whirlpool.mod │ │ │ │ │ --r--r--r-- 1 0 0 25036 Feb 12 2025 [ 1606 00] gdb.mod │ │ │ │ │ --r--r--r-- 1 0 0 5884 Feb 12 2025 [ 1619 00] geli.mod │ │ │ │ │ --r--r--r-- 1 0 0 4860 Feb 12 2025 [ 1622 00] gettext.mod │ │ │ │ │ --r--r--r-- 1 0 0 39136 Feb 12 2025 [ 1625 00] gfxmenu.mod │ │ │ │ │ --r--r--r-- 1 0 0 9892 Feb 12 2025 [ 1645 00] gfxterm.mod │ │ │ │ │ --r--r--r-- 1 0 0 2796 Feb 12 2025 [ 1650 00] gfxterm_background.mod │ │ │ │ │ --r--r--r-- 1 0 0 4912 Feb 12 2025 [ 1652 00] gfxterm_menu.mod │ │ │ │ │ --r--r--r-- 1 0 0 3740 Feb 12 2025 [ 1655 00] gptsync.mod │ │ │ │ │ --r--r--r-- 1 0 0 8784 Feb 12 2025 [ 1657 00] gzio.mod │ │ │ │ │ --r--r--r-- 1 0 0 4684 Feb 12 2025 [ 1662 00] halt.mod │ │ │ │ │ --r--r--r-- 1 0 0 5168 Feb 12 2025 [ 1665 00] hashsum.mod │ │ │ │ │ --r--r--r-- 1 0 0 6560 Feb 12 2025 [ 1668 00] hdparm.mod │ │ │ │ │ --r--r--r-- 1 0 0 1140 Feb 12 2025 [ 1672 00] hello.mod │ │ │ │ │ --r--r--r-- 1 0 0 2512 Feb 12 2025 [ 1673 00] help.mod │ │ │ │ │ --r--r--r-- 1 0 0 3216 Feb 12 2025 [ 1675 00] hexdump.mod │ │ │ │ │ --r--r--r-- 1 0 0 7004 Feb 12 2025 [ 1677 00] hfs.mod │ │ │ │ │ --r--r--r-- 1 0 0 7848 Feb 12 2025 [ 1681 00] hfsplus.mod │ │ │ │ │ --r--r--r-- 1 0 0 2960 Feb 12 2025 [ 1685 00] hfspluscomp.mod │ │ │ │ │ --r--r--r-- 1 0 0 5700 Feb 12 2025 [ 1687 00] http.mod │ │ │ │ │ --r--r--r-- 1 0 0 2468 Feb 12 2025 [ 1690 00] hwmatch.mod │ │ │ │ │ --r--r--r-- 1 0 0 2800 Feb 12 2025 [ 1692 00] iorw.mod │ │ │ │ │ --r--r--r-- 1 0 0 8488 Feb 12 2025 [ 1694 00] iso9660.mod │ │ │ │ │ --r--r--r-- 1 0 0 6092 Feb 12 2025 [ 1699 00] jfs.mod │ │ │ │ │ --r--r--r-- 1 0 0 7660 Feb 12 2025 [ 1702 00] jpeg.mod │ │ │ │ │ --r--r--r-- 1 0 0 3504 Feb 12 2025 [ 1706 00] json.mod │ │ │ │ │ --r--r--r-- 1 0 0 5032 Feb 12 2025 [ 1708 00] keylayouts.mod │ │ │ │ │ --r--r--r-- 1 0 0 1904 Feb 12 2025 [ 1711 00] keystatus.mod │ │ │ │ │ --r--r--r-- 1 0 0 6300 Feb 12 2025 [ 1712 00] ldm.mod │ │ │ │ │ --r--r--r-- 1 0 0 14404 Feb 12 2025 [ 1716 00] legacy_password_test.mod │ │ │ │ │ --r--r--r-- 1 0 0 30132 Feb 12 2025 [ 1724 00] legacycfg.mod │ │ │ │ │ --r--r--r-- 1 0 0 13172 Feb 12 2025 [ 1739 00] linux.mod │ │ │ │ │ --r--r--r-- 1 0 0 5524 Feb 12 2025 [ 1746 00] linux16.mod │ │ │ │ │ --r--r--r-- 1 0 0 5748 Feb 12 2025 [ 1749 00] loadenv.mod │ │ │ │ │ --r--r--r-- 1 0 0 3004 Feb 12 2025 [ 1752 00] loopback.mod │ │ │ │ │ --r--r--r-- 1 0 0 3856 Feb 12 2025 [ 1754 00] ls.mod │ │ │ │ │ --r--r--r-- 1 0 0 4740 Feb 12 2025 [ 1756 00] lsacpi.mod │ │ │ │ │ --r--r--r-- 1 0 0 2236 Feb 12 2025 [ 1759 00] lsapm.mod │ │ │ │ │ --r--r--r-- 1 0 0 1820 Feb 12 2025 [ 1761 00] lsmmap.mod │ │ │ │ │ --r--r--r-- 1 0 0 4828 Feb 12 2025 [ 1762 00] lspci.mod │ │ │ │ │ --r--r--r-- 1 0 0 4356 Feb 12 2025 [ 1765 00] luks.mod │ │ │ │ │ --r--r--r-- 1 0 0 14216 Feb 12 2025 [ 1768 00] luks2.mod │ │ │ │ │ --r--r--r-- 1 0 0 8472 Feb 12 2025 [ 1775 00] lvm.mod │ │ │ │ │ --r--r--r-- 1 0 0 4756 Feb 12 2025 [ 1780 00] lzopio.mod │ │ │ │ │ --r--r--r-- 1 0 0 3200 Feb 12 2025 [ 1783 00] macbless.mod │ │ │ │ │ --r--r--r-- 1 0 0 7500 Feb 12 2025 [ 1785 00] macho.mod │ │ │ │ │ --r--r--r-- 1 0 0 2044 Feb 12 2025 [ 1789 00] mda_text.mod │ │ │ │ │ --r--r--r-- 1 0 0 2112 Feb 12 2025 [ 1790 00] mdraid09.mod │ │ │ │ │ --r--r--r-- 1 0 0 1968 Feb 12 2025 [ 1792 00] mdraid09_be.mod │ │ │ │ │ --r--r--r-- 1 0 0 1852 Feb 12 2025 [ 1793 00] mdraid1x.mod │ │ │ │ │ --r--r--r-- 1 0 0 1988 Feb 12 2025 [ 1794 00] memdisk.mod │ │ │ │ │ --r--r--r-- 1 0 0 2824 Feb 12 2025 [ 1795 00] memrw.mod │ │ │ │ │ --r--r--r-- 1 0 0 3504 Feb 12 2025 [ 1797 00] minicmd.mod │ │ │ │ │ --r--r--r-- 1 0 0 3596 Feb 12 2025 [ 1799 00] minix.mod │ │ │ │ │ --r--r--r-- 1 0 0 3692 Feb 12 2025 [ 1801 00] minix2.mod │ │ │ │ │ --r--r--r-- 1 0 0 3856 Feb 12 2025 [ 1803 00] minix2_be.mod │ │ │ │ │ --r--r--r-- 1 0 0 3692 Feb 12 2025 [ 1805 00] minix3.mod │ │ │ │ │ --r--r--r-- 1 0 0 3856 Feb 12 2025 [ 1807 00] minix3_be.mod │ │ │ │ │ --r--r--r-- 1 0 0 3724 Feb 12 2025 [ 1809 00] minix_be.mod │ │ │ │ │ --r--r--r-- 1 0 0 8544 Feb 12 2025 [ 1811 00] mmap.mod │ │ │ │ │ --r--r--r-- 1 0 0 5709 Feb 12 2025 [ 1816 00] moddep.lst │ │ │ │ │ --r--r--r-- 1 0 0 2567 Feb 12 2025 [ 1819 00] modinfo.sh │ │ │ │ │ --r--r--r-- 1 0 0 2348 Feb 12 2025 [ 1821 00] morse.mod │ │ │ │ │ --r--r--r-- 1 0 0 27896 Feb 12 2025 [ 1823 00] mpi.mod │ │ │ │ │ --r--r--r-- 1 0 0 2396 Feb 12 2025 [ 1837 00] msdospart.mod │ │ │ │ │ --r--r--r-- 1 0 0 2016 Feb 12 2025 [ 1839 00] mul_test.mod │ │ │ │ │ --r--r--r-- 1 0 0 13920 Feb 12 2025 [ 1840 00] multiboot.mod │ │ │ │ │ --r--r--r-- 1 0 0 15068 Feb 12 2025 [ 1847 00] multiboot2.mod │ │ │ │ │ --r--r--r-- 1 0 0 4156 Feb 12 2025 [ 1855 00] nativedisk.mod │ │ │ │ │ --r--r--r-- 1 0 0 57256 Feb 12 2025 [ 1858 00] net.mod │ │ │ │ │ --r--r--r-- 1 0 0 2836 Feb 12 2025 [ 1886 00] newc.mod │ │ │ │ │ --r--r--r-- 1 0 0 6744 Feb 12 2025 [ 1888 00] nilfs2.mod │ │ │ │ │ --r--r--r-- 1 0 0 114896 Feb 12 2025 [ 1892 00] normal.mod │ │ │ │ │ --r--r--r-- 1 0 0 10652 Feb 12 2025 [ 1949 00] ntfs.mod │ │ │ │ │ --r--r--r-- 1 0 0 4260 Feb 12 2025 [ 1955 00] ntfscomp.mod │ │ │ │ │ --r--r--r-- 1 0 0 2504 Feb 12 2025 [ 1958 00] ntldr.mod │ │ │ │ │ --r--r--r-- 1 0 0 2676 Feb 12 2025 [ 1960 00] odc.mod │ │ │ │ │ --r--r--r-- 1 0 0 1456 Feb 12 2025 [ 1962 00] offsetio.mod │ │ │ │ │ --r--r--r-- 1 0 0 10420 Feb 12 2025 [ 1963 00] ohci.mod │ │ │ │ │ --r--r--r-- 1 0 0 1584 Feb 12 2025 [ 1969 00] part_acorn.mod │ │ │ │ │ --r--r--r-- 1 0 0 1812 Feb 12 2025 [ 1970 00] part_amiga.mod │ │ │ │ │ --r--r--r-- 1 0 0 2052 Feb 12 2025 [ 1971 00] part_apple.mod │ │ │ │ │ --r--r--r-- 1 0 0 2680 Feb 12 2025 [ 1973 00] part_bsd.mod │ │ │ │ │ --r--r--r-- 1 0 0 1708 Feb 12 2025 [ 1975 00] part_dfly.mod │ │ │ │ │ --r--r--r-- 1 0 0 1424 Feb 12 2025 [ 1976 00] part_dvh.mod │ │ │ │ │ --r--r--r-- 1 0 0 2292 Feb 12 2025 [ 1977 00] part_gpt.mod │ │ │ │ │ --r--r--r-- 1 0 0 2280 Feb 12 2025 [ 1979 00] part_msdos.mod │ │ │ │ │ --r--r--r-- 1 0 0 1732 Feb 12 2025 [ 1981 00] part_plan.mod │ │ │ │ │ --r--r--r-- 1 0 0 1452 Feb 12 2025 [ 1982 00] part_sun.mod │ │ │ │ │ --r--r--r-- 1 0 0 1580 Feb 12 2025 [ 1983 00] part_sunpc.mod │ │ │ │ │ --r--r--r-- 1 0 0 111 Feb 12 2025 [ 1984 00] partmap.lst │ │ │ │ │ --r--r--r-- 1 0 0 17 Feb 12 2025 [ 1985 00] parttool.lst │ │ │ │ │ --r--r--r-- 1 0 0 4644 Feb 12 2025 [ 1986 00] parttool.mod │ │ │ │ │ --r--r--r-- 1 0 0 1820 Feb 12 2025 [ 1989 00] password.mod │ │ │ │ │ --r--r--r-- 1 0 0 2712 Feb 12 2025 [ 1990 00] password_pbkdf2.mod │ │ │ │ │ --r--r--r-- 1 0 0 4812 Feb 12 2025 [ 1992 00] pata.mod │ │ │ │ │ --r--r--r-- 1 0 0 1312 Feb 12 2025 [ 1995 00] pbkdf2.mod │ │ │ │ │ --r--r--r-- 1 0 0 2100 Feb 12 2025 [ 1996 00] pbkdf2_test.mod │ │ │ │ │ --r--r--r-- 1 0 0 1316 Feb 12 2025 [ 1998 00] pci.mod │ │ │ │ │ --r--r--r-- 1 0 0 2416 Feb 12 2025 [ 1999 00] pcidump.mod │ │ │ │ │ --r--r--r-- 1 0 0 11376 Feb 12 2025 [ 2001 00] pgp.mod │ │ │ │ │ --r--r--r-- 1 0 0 6292 Feb 12 2025 [ 2007 00] plan9.mod │ │ │ │ │ --r--r--r-- 1 0 0 2452 Feb 12 2025 [ 2011 00] play.mod │ │ │ │ │ --r--r--r-- 1 0 0 8052 Feb 12 2025 [ 2013 00] png.mod │ │ │ │ │ --r--r--r-- 1 0 0 1516 Feb 12 2025 [ 2017 00] priority_queue.mod │ │ │ │ │ --r--r--r-- 1 0 0 3456 Feb 12 2025 [ 2018 00] probe.mod │ │ │ │ │ --r--r--r-- 1 0 0 2284 Feb 12 2025 [ 2020 00] procfs.mod │ │ │ │ │ --r--r--r-- 1 0 0 2136 Feb 12 2025 [ 2022 00] progress.mod │ │ │ │ │ --r--r--r-- 1 0 0 3680 Feb 12 2025 [ 2024 00] pxe.mod │ │ │ │ │ --r--r--r-- 1 0 0 2616 Feb 12 2025 [ 2026 00] pxechain.mod │ │ │ │ │ --r--r--r-- 1 0 0 1292 Feb 12 2025 [ 2028 00] raid5rec.mod │ │ │ │ │ --r--r--r-- 1 0 0 2204 Feb 12 2025 [ 2029 00] raid6rec.mod │ │ │ │ │ --r--r--r-- 1 0 0 2784 Feb 12 2025 [ 2031 00] random.mod │ │ │ │ │ --r--r--r-- 1 0 0 1848 Feb 12 2025 [ 2033 00] rdmsr.mod │ │ │ │ │ --r--r--r-- 1 0 0 1404 Feb 12 2025 [ 2034 00] read.mod │ │ │ │ │ --r--r--r-- 1 0 0 1636 Feb 12 2025 [ 2035 00] reboot.mod │ │ │ │ │ --r--r--r-- 1 0 0 51032 Feb 12 2025 [ 2036 00] regexp.mod │ │ │ │ │ --r--r--r-- 1 0 0 8788 Feb 12 2025 [ 2061 00] reiserfs.mod │ │ │ │ │ --r--r--r-- 1 0 0 14952 Feb 12 2025 [ 2066 00] relocator.mod │ │ │ │ │ --r--r--r-- 1 0 0 4052 Feb 12 2025 [ 2074 00] romfs.mod │ │ │ │ │ --r--r--r-- 1 0 0 4644 Feb 12 2025 [ 2076 00] scsi.mod │ │ │ │ │ --r--r--r-- 1 0 0 3624 Feb 12 2025 [ 2079 00] search.mod │ │ │ │ │ --r--r--r-- 1 0 0 3052 Feb 12 2025 [ 2081 00] search_fs_file.mod │ │ │ │ │ --r--r--r-- 1 0 0 3156 Feb 12 2025 [ 2083 00] search_fs_uuid.mod │ │ │ │ │ --r--r--r-- 1 0 0 3072 Feb 12 2025 [ 2085 00] search_label.mod │ │ │ │ │ --r--r--r-- 1 0 0 7068 Feb 12 2025 [ 2087 00] sendkey.mod │ │ │ │ │ --r--r--r-- 1 0 0 7696 Feb 12 2025 [ 2091 00] serial.mod │ │ │ │ │ --r--r--r-- 1 0 0 628 Feb 12 2025 [ 2095 00] setjmp.mod │ │ │ │ │ --r--r--r-- 1 0 0 1624 Feb 12 2025 [ 2096 00] setjmp_test.mod │ │ │ │ │ --r--r--r-- 1 0 0 5224 Feb 12 2025 [ 2097 00] setpci.mod │ │ │ │ │ --r--r--r-- 1 0 0 5116 Feb 12 2025 [ 2100 00] sfs.mod │ │ │ │ │ --r--r--r-- 1 0 0 2396 Feb 12 2025 [ 2103 00] shift_test.mod │ │ │ │ │ --r--r--r-- 1 0 0 6380 Feb 12 2025 [ 2105 00] signature_test.mod │ │ │ │ │ --r--r--r-- 1 0 0 2144 Feb 12 2025 [ 2109 00] sleep.mod │ │ │ │ │ --r--r--r-- 1 0 0 2260 Feb 12 2025 [ 2111 00] sleep_test.mod │ │ │ │ │ --r--r--r-- 1 0 0 5564 Feb 12 2025 [ 2113 00] smbios.mod │ │ │ │ │ --r--r--r-- 1 0 0 2024 Feb 12 2025 [ 2116 00] spkmodem.mod │ │ │ │ │ --r--r--r-- 1 0 0 7132 Feb 12 2025 [ 2117 00] squash4.mod │ │ │ │ │ --r--r--r-- 1 0 0 2112 Feb 12 2025 [ 2121 00] strtoull_test.mod │ │ │ │ │ --r--r--r-- 1 0 0 17420 Feb 12 2025 [ 2123 00] syslinuxcfg.mod │ │ │ │ │ --r--r--r-- 1 0 0 3216 Feb 12 2025 [ 2132 00] tar.mod │ │ │ │ │ --r--r--r-- 1 0 0 202 Feb 12 2025 [ 2134 00] terminal.lst │ │ │ │ │ --r--r--r-- 1 0 0 4448 Feb 12 2025 [ 2135 00] terminal.mod │ │ │ │ │ --r--r--r-- 1 0 0 12356 Feb 12 2025 [ 2138 00] terminfo.mod │ │ │ │ │ --r--r--r-- 1 0 0 5000 Feb 12 2025 [ 2145 00] test.mod │ │ │ │ │ --r--r--r-- 1 0 0 1272 Feb 12 2025 [ 2148 00] test_blockarg.mod │ │ │ │ │ --r--r--r-- 1 0 0 2736 Feb 12 2025 [ 2149 00] testload.mod │ │ │ │ │ --r--r--r-- 1 0 0 2264 Feb 12 2025 [ 2151 00] testspeed.mod │ │ │ │ │ --r--r--r-- 1 0 0 4920 Feb 12 2025 [ 2153 00] tftp.mod │ │ │ │ │ --r--r--r-- 1 0 0 4588 Feb 12 2025 [ 2156 00] tga.mod │ │ │ │ │ --r--r--r-- 1 0 0 1456 Feb 12 2025 [ 2159 00] time.mod │ │ │ │ │ --r--r--r-- 1 0 0 2352 Feb 12 2025 [ 2160 00] tr.mod │ │ │ │ │ --r--r--r-- 1 0 0 1668 Feb 12 2025 [ 2162 00] trig.mod │ │ │ │ │ --r--r--r-- 1 0 0 1152 Feb 12 2025 [ 2163 00] true.mod │ │ │ │ │ --r--r--r-- 1 0 0 3728 Feb 12 2025 [ 2164 00] truecrypt.mod │ │ │ │ │ --r--r--r-- 1 0 0 8500 Feb 12 2025 [ 2166 00] udf.mod │ │ │ │ │ --r--r--r-- 1 0 0 5332 Feb 12 2025 [ 2171 00] ufs1.mod │ │ │ │ │ --r--r--r-- 1 0 0 5716 Feb 12 2025 [ 2174 00] ufs1_be.mod │ │ │ │ │ --r--r--r-- 1 0 0 5396 Feb 12 2025 [ 2177 00] ufs2.mod │ │ │ │ │ --r--r--r-- 1 0 0 6492 Feb 12 2025 [ 2180 00] uhci.mod │ │ │ │ │ --r--r--r-- 1 0 0 10376 Feb 12 2025 [ 2184 00] usb.mod │ │ │ │ │ --r--r--r-- 1 0 0 3764 Feb 12 2025 [ 2190 00] usb_keyboard.mod │ │ │ │ │ --r--r--r-- 1 0 0 6912 Feb 12 2025 [ 2192 00] usbms.mod │ │ │ │ │ --r--r--r-- 1 0 0 1916 Feb 12 2025 [ 2196 00] usbserial_common.mod │ │ │ │ │ --r--r--r-- 1 0 0 2296 Feb 12 2025 [ 2197 00] usbserial_ftdi.mod │ │ │ │ │ --r--r--r-- 1 0 0 2632 Feb 12 2025 [ 2199 00] usbserial_pl2303.mod │ │ │ │ │ --r--r--r-- 1 0 0 1460 Feb 12 2025 [ 2201 00] usbserial_usbdebug.mod │ │ │ │ │ --r--r--r-- 1 0 0 3568 Feb 12 2025 [ 2202 00] usbtest.mod │ │ │ │ │ --r--r--r-- 1 0 0 9828 Feb 12 2025 [ 2204 00] vbe.mod │ │ │ │ │ --r--r--r-- 1 0 0 2652 Feb 12 2025 [ 2209 00] verifiers.mod │ │ │ │ │ --r--r--r-- 1 0 0 4932 Feb 12 2025 [ 2211 00] vga.mod │ │ │ │ │ --r--r--r-- 1 0 0 2140 Feb 12 2025 [ 2214 00] vga_text.mod │ │ │ │ │ --r--r--r-- 1 0 0 33 Feb 12 2025 [ 2216 00] video.lst │ │ │ │ │ --r--r--r-- 1 0 0 5980 Feb 12 2025 [ 2217 00] video.mod │ │ │ │ │ --r--r--r-- 1 0 0 5588 Feb 12 2025 [ 2220 00] video_bochs.mod │ │ │ │ │ --r--r--r-- 1 0 0 6004 Feb 12 2025 [ 2223 00] video_cirrus.mod │ │ │ │ │ --r--r--r-- 1 0 0 5568 Feb 12 2025 [ 2226 00] video_colors.mod │ │ │ │ │ --r--r--r-- 1 0 0 21016 Feb 12 2025 [ 2229 00] video_fb.mod │ │ │ │ │ --r--r--r-- 1 0 0 3892 Feb 12 2025 [ 2240 00] videoinfo.mod │ │ │ │ │ --r--r--r-- 1 0 0 4216 Feb 12 2025 [ 2242 00] videotest.mod │ │ │ │ │ --r--r--r-- 1 0 0 2284 Feb 12 2025 [ 2245 00] videotest_checksum.mod │ │ │ │ │ --r--r--r-- 1 0 0 1448 Feb 12 2025 [ 2247 00] wrmsr.mod │ │ │ │ │ --r--r--r-- 1 0 0 7484 Feb 12 2025 [ 2248 00] xfs.mod │ │ │ │ │ --r--r--r-- 1 0 0 27468 Feb 12 2025 [ 2252 00] xnu.mod │ │ │ │ │ --r--r--r-- 1 0 0 2084 Feb 12 2025 [ 2266 00] xnu_uuid.mod │ │ │ │ │ --r--r--r-- 1 0 0 1924 Feb 12 2025 [ 2268 00] xnu_uuid_test.mod │ │ │ │ │ --r--r--r-- 1 0 0 15456 Feb 12 2025 [ 2269 00] xzio.mod │ │ │ │ │ --r--r--r-- 1 0 0 40256 Feb 12 2025 [ 2277 00] zfs.mod │ │ │ │ │ --r--r--r-- 1 0 0 5488 Feb 12 2025 [ 2297 00] zfscrypt.mod │ │ │ │ │ --r--r--r-- 1 0 0 6588 Feb 12 2025 [ 2300 00] zfsinfo.mod │ │ │ │ │ --r--r--r-- 1 0 0 45868 Feb 12 2025 [ 2304 00] zstd.mod │ │ │ │ │ +dr-xr-xr-x 1 0 0 38912 Jan 11 2024 [ 24 02] . │ │ │ │ │ +dr-xr-xr-x 1 0 0 2048 Jan 11 2024 [ 22 02] .. │ │ │ │ │ +-r--r--r-- 1 0 0 7780 Jan 11 2024 [ 1219 00] 915resolution.mod │ │ │ │ │ +-r--r--r-- 1 0 0 10868 Jan 11 2024 [ 1223 00] acpi.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1228 Jan 11 2024 [ 1229 00] adler32.mod │ │ │ │ │ +-r--r--r-- 1 0 0 5568 Jan 11 2024 [ 1230 00] affs.mod │ │ │ │ │ +-r--r--r-- 1 0 0 6020 Jan 11 2024 [ 1233 00] afs.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1516 Jan 11 2024 [ 1236 00] afsplitter.mod │ │ │ │ │ +-r--r--r-- 1 0 0 15392 Jan 11 2024 [ 1237 00] ahci.mod │ │ │ │ │ +-r--r--r-- 1 0 0 492 Jan 11 2024 [ 1245 00] all_video.mod │ │ │ │ │ +-r--r--r-- 1 0 0 956 Jan 11 2024 [ 1246 00] aout.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2836 Jan 11 2024 [ 1247 00] archelp.mod │ │ │ │ │ +-r--r--r-- 1 0 0 4068 Jan 11 2024 [ 1249 00] at_keyboard.mod │ │ │ │ │ +-r--r--r-- 1 0 0 5524 Jan 11 2024 [ 1251 00] ata.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1576 Jan 11 2024 [ 1254 00] backtrace.mod │ │ │ │ │ +-r--r--r-- 1 0 0 6728 Jan 11 2024 [ 1255 00] bfs.mod │ │ │ │ │ +-r--r--r-- 1 0 0 4636 Jan 11 2024 [ 1259 00] biosdisk.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2184 Jan 11 2024 [ 1262 00] bitmap.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3616 Jan 11 2024 [ 1264 00] bitmap_scale.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1984 Jan 11 2024 [ 1266 00] blocklist.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2628 Jan 11 2024 [ 1267 00] boot.mod │ │ │ │ │ +-r--r--r-- 1 0 0 30568 Jan 11 2024 [ 1269 00] bsd.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2252 Jan 11 2024 [ 1284 00] bswap_test.mod │ │ │ │ │ +-r--r--r-- 1 0 0 19712 Jan 11 2024 [ 1286 00] btrfs.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2028 Jan 11 2024 [ 1296 00] bufio.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2884 Jan 11 2024 [ 1297 00] cat.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3892 Jan 11 2024 [ 1299 00] cbfs.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3340 Jan 11 2024 [ 1301 00] cbls.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2448 Jan 11 2024 [ 1303 00] cbmemc.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1048 Jan 11 2024 [ 1305 00] cbtable.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2772 Jan 11 2024 [ 1306 00] cbtime.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3448 Jan 11 2024 [ 1308 00] chain.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2960 Jan 11 2024 [ 1310 00] cmdline_cat_test.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1216 Jan 11 2024 [ 1312 00] cmosdump.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1808 Jan 11 2024 [ 1313 00] cmostest.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2056 Jan 11 2024 [ 1314 00] cmp.mod │ │ │ │ │ +-r--r--r-- 1 0 0 4608 Jan 11 2024 [ 1316 00] cmp_test.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3887 Jan 11 2024 [ 1319 00] command.lst │ │ │ │ │ +-r--r--r-- 1 0 0 2224 Jan 11 2024 [ 1321 00] configfile.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2612 Jan 11 2024 [ 1323 00] cpio.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2680 Jan 11 2024 [ 1325 00] cpio_be.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1664 Jan 11 2024 [ 1327 00] cpuid.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1572 Jan 11 2024 [ 1328 00] crc64.mod │ │ │ │ │ +-r--r--r-- 1 0 0 936 Jan 11 2024 [ 1329 00] crypto.lst │ │ │ │ │ +-r--r--r-- 1 0 0 4944 Jan 11 2024 [ 1330 00] crypto.mod │ │ │ │ │ +-r--r--r-- 1 0 0 11900 Jan 11 2024 [ 1333 00] cryptodisk.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3588 Jan 11 2024 [ 1339 00] cs5536.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1680 Jan 11 2024 [ 1341 00] ctz_test.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2148 Jan 11 2024 [ 1342 00] date.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1716 Jan 11 2024 [ 1344 00] datehook.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2232 Jan 11 2024 [ 1345 00] datetime.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2332 Jan 11 2024 [ 1347 00] disk.mod │ │ │ │ │ +-r--r--r-- 1 0 0 9836 Jan 11 2024 [ 1349 00] diskfilter.mod │ │ │ │ │ +-r--r--r-- 1 0 0 956 Jan 11 2024 [ 1354 00] div.mod │ │ │ │ │ +-r--r--r-- 1 0 0 5560 Jan 11 2024 [ 1355 00] div_test.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1772 Jan 11 2024 [ 1358 00] dm_nv.mod │ │ │ │ │ +-r--r--r-- 1 0 0 5316 Jan 11 2024 [ 1359 00] drivemap.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1896 Jan 11 2024 [ 1362 00] echo.mod │ │ │ │ │ +-r--r--r-- 1 0 0 23696 Jan 11 2024 [ 1363 00] efiemu.mod │ │ │ │ │ +-r--r--r-- 1 0 0 7608 Jan 11 2024 [ 1375 00] efiemu32.o │ │ │ │ │ +-r--r--r-- 1 0 0 10112 Jan 11 2024 [ 1379 00] efiemu64.o │ │ │ │ │ +-r--r--r-- 1 0 0 16128 Jan 11 2024 [ 1384 00] ehci.mod │ │ │ │ │ +-r--r--r-- 1 0 0 4064 Jan 11 2024 [ 1392 00] elf.mod │ │ │ │ │ +-r--r--r-- 1 0 0 29251 Jan 11 2024 [ 1394 00] eltorito.img │ │ │ │ │ +-r--r--r-- 1 0 0 1368 Jan 11 2024 [ 1409 00] eval.mod │ │ │ │ │ +-r--r--r-- 1 0 0 6080 Jan 11 2024 [ 1410 00] exfat.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1380 Jan 11 2024 [ 1413 00] exfctest.mod │ │ │ │ │ +-r--r--r-- 1 0 0 6172 Jan 11 2024 [ 1414 00] ext2.mod │ │ │ │ │ +-r--r--r-- 1 0 0 4640 Jan 11 2024 [ 1418 00] extcmd.mod │ │ │ │ │ +-r--r--r-- 1 0 0 6460 Jan 11 2024 [ 1421 00] f2fs.mod │ │ │ │ │ +-r--r--r-- 1 0 0 6192 Jan 11 2024 [ 1425 00] fat.mod │ │ │ │ │ +-r--r--r-- 1 0 0 16932 Jan 11 2024 [ 1429 00] file.mod │ │ │ │ │ +-r--r--r-- 1 0 0 13520 Jan 11 2024 [ 1438 00] font.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2612 Jan 11 2024 [ 1445 00] freedos.mod │ │ │ │ │ +-r--r--r-- 1 0 0 219 Jan 11 2024 [ 1447 00] fs.lst │ │ │ │ │ +-r--r--r-- 1 0 0 2920 Jan 11 2024 [ 1448 00] fshelp.mod │ │ │ │ │ +-r--r--r-- 1 0 0 34168 Jan 11 2024 [ 1450 00] functional_test.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1612 Jan 11 2024 [ 1467 00] gcry_arcfour.mod │ │ │ │ │ +-r--r--r-- 1 0 0 8000 Jan 11 2024 [ 1468 00] gcry_blowfish.mod │ │ │ │ │ +-r--r--r-- 1 0 0 33516 Jan 11 2024 [ 1472 00] gcry_camellia.mod │ │ │ │ │ +-r--r--r-- 1 0 0 16356 Jan 11 2024 [ 1489 00] gcry_cast5.mod │ │ │ │ │ +-r--r--r-- 1 0 0 10564 Jan 11 2024 [ 1497 00] gcry_crc.mod │ │ │ │ │ +-r--r--r-- 1 0 0 19104 Jan 11 2024 [ 1503 00] gcry_des.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2188 Jan 11 2024 [ 1513 00] gcry_dsa.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2884 Jan 11 2024 [ 1515 00] gcry_idea.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3048 Jan 11 2024 [ 1517 00] gcry_md4.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3668 Jan 11 2024 [ 1519 00] gcry_md5.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2316 Jan 11 2024 [ 1521 00] gcry_rfc2268.mod │ │ │ │ │ +-r--r--r-- 1 0 0 19312 Jan 11 2024 [ 1523 00] gcry_rijndael.mod │ │ │ │ │ +-r--r--r-- 1 0 0 8248 Jan 11 2024 [ 1533 00] gcry_rmd160.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1968 Jan 11 2024 [ 1538 00] gcry_rsa.mod │ │ │ │ │ +-r--r--r-- 1 0 0 14824 Jan 11 2024 [ 1539 00] gcry_seed.mod │ │ │ │ │ +-r--r--r-- 1 0 0 17700 Jan 11 2024 [ 1547 00] gcry_serpent.mod │ │ │ │ │ +-r--r--r-- 1 0 0 8592 Jan 11 2024 [ 1556 00] gcry_sha1.mod │ │ │ │ │ +-r--r--r-- 1 0 0 4376 Jan 11 2024 [ 1561 00] gcry_sha256.mod │ │ │ │ │ +-r--r--r-- 1 0 0 8804 Jan 11 2024 [ 1564 00] gcry_sha512.mod │ │ │ │ │ +-r--r--r-- 1 0 0 12244 Jan 11 2024 [ 1569 00] gcry_tiger.mod │ │ │ │ │ +-r--r--r-- 1 0 0 36816 Jan 11 2024 [ 1575 00] gcry_twofish.mod │ │ │ │ │ +-r--r--r-- 1 0 0 24588 Jan 11 2024 [ 1593 00] gcry_whirlpool.mod │ │ │ │ │ +-r--r--r-- 1 0 0 25036 Jan 11 2024 [ 1606 00] gdb.mod │ │ │ │ │ +-r--r--r-- 1 0 0 5884 Jan 11 2024 [ 1619 00] geli.mod │ │ │ │ │ +-r--r--r-- 1 0 0 4860 Jan 11 2024 [ 1622 00] gettext.mod │ │ │ │ │ +-r--r--r-- 1 0 0 39136 Jan 11 2024 [ 1625 00] gfxmenu.mod │ │ │ │ │ +-r--r--r-- 1 0 0 9892 Jan 11 2024 [ 1645 00] gfxterm.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2796 Jan 11 2024 [ 1650 00] gfxterm_background.mod │ │ │ │ │ +-r--r--r-- 1 0 0 4912 Jan 11 2024 [ 1652 00] gfxterm_menu.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3740 Jan 11 2024 [ 1655 00] gptsync.mod │ │ │ │ │ +-r--r--r-- 1 0 0 8784 Jan 11 2024 [ 1657 00] gzio.mod │ │ │ │ │ +-r--r--r-- 1 0 0 4684 Jan 11 2024 [ 1662 00] halt.mod │ │ │ │ │ +-r--r--r-- 1 0 0 5168 Jan 11 2024 [ 1665 00] hashsum.mod │ │ │ │ │ +-r--r--r-- 1 0 0 6560 Jan 11 2024 [ 1668 00] hdparm.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1140 Jan 11 2024 [ 1672 00] hello.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2512 Jan 11 2024 [ 1673 00] help.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3216 Jan 11 2024 [ 1675 00] hexdump.mod │ │ │ │ │ +-r--r--r-- 1 0 0 7004 Jan 11 2024 [ 1677 00] hfs.mod │ │ │ │ │ +-r--r--r-- 1 0 0 7848 Jan 11 2024 [ 1681 00] hfsplus.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2960 Jan 11 2024 [ 1685 00] hfspluscomp.mod │ │ │ │ │ +-r--r--r-- 1 0 0 5700 Jan 11 2024 [ 1687 00] http.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2468 Jan 11 2024 [ 1690 00] hwmatch.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2800 Jan 11 2024 [ 1692 00] iorw.mod │ │ │ │ │ +-r--r--r-- 1 0 0 8488 Jan 11 2024 [ 1694 00] iso9660.mod │ │ │ │ │ +-r--r--r-- 1 0 0 6092 Jan 11 2024 [ 1699 00] jfs.mod │ │ │ │ │ +-r--r--r-- 1 0 0 7660 Jan 11 2024 [ 1702 00] jpeg.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3504 Jan 11 2024 [ 1706 00] json.mod │ │ │ │ │ +-r--r--r-- 1 0 0 5032 Jan 11 2024 [ 1708 00] keylayouts.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1904 Jan 11 2024 [ 1711 00] keystatus.mod │ │ │ │ │ +-r--r--r-- 1 0 0 6300 Jan 11 2024 [ 1712 00] ldm.mod │ │ │ │ │ +-r--r--r-- 1 0 0 14404 Jan 11 2024 [ 1716 00] legacy_password_test.mod │ │ │ │ │ +-r--r--r-- 1 0 0 30132 Jan 11 2024 [ 1724 00] legacycfg.mod │ │ │ │ │ +-r--r--r-- 1 0 0 13172 Jan 11 2024 [ 1739 00] linux.mod │ │ │ │ │ +-r--r--r-- 1 0 0 5524 Jan 11 2024 [ 1746 00] linux16.mod │ │ │ │ │ +-r--r--r-- 1 0 0 5748 Jan 11 2024 [ 1749 00] loadenv.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3004 Jan 11 2024 [ 1752 00] loopback.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3856 Jan 11 2024 [ 1754 00] ls.mod │ │ │ │ │ +-r--r--r-- 1 0 0 4740 Jan 11 2024 [ 1756 00] lsacpi.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2236 Jan 11 2024 [ 1759 00] lsapm.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1820 Jan 11 2024 [ 1761 00] lsmmap.mod │ │ │ │ │ +-r--r--r-- 1 0 0 4828 Jan 11 2024 [ 1762 00] lspci.mod │ │ │ │ │ +-r--r--r-- 1 0 0 4356 Jan 11 2024 [ 1765 00] luks.mod │ │ │ │ │ +-r--r--r-- 1 0 0 14216 Jan 11 2024 [ 1768 00] luks2.mod │ │ │ │ │ +-r--r--r-- 1 0 0 8472 Jan 11 2024 [ 1775 00] lvm.mod │ │ │ │ │ +-r--r--r-- 1 0 0 4756 Jan 11 2024 [ 1780 00] lzopio.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3200 Jan 11 2024 [ 1783 00] macbless.mod │ │ │ │ │ +-r--r--r-- 1 0 0 7500 Jan 11 2024 [ 1785 00] macho.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2044 Jan 11 2024 [ 1789 00] mda_text.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2112 Jan 11 2024 [ 1790 00] mdraid09.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1968 Jan 11 2024 [ 1792 00] mdraid09_be.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1852 Jan 11 2024 [ 1793 00] mdraid1x.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1988 Jan 11 2024 [ 1794 00] memdisk.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2824 Jan 11 2024 [ 1795 00] memrw.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3504 Jan 11 2024 [ 1797 00] minicmd.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3596 Jan 11 2024 [ 1799 00] minix.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3692 Jan 11 2024 [ 1801 00] minix2.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3856 Jan 11 2024 [ 1803 00] minix2_be.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3692 Jan 11 2024 [ 1805 00] minix3.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3856 Jan 11 2024 [ 1807 00] minix3_be.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3724 Jan 11 2024 [ 1809 00] minix_be.mod │ │ │ │ │ +-r--r--r-- 1 0 0 8544 Jan 11 2024 [ 1811 00] mmap.mod │ │ │ │ │ +-r--r--r-- 1 0 0 5709 Jan 11 2024 [ 1816 00] moddep.lst │ │ │ │ │ +-r--r--r-- 1 0 0 2565 Jan 11 2024 [ 1819 00] modinfo.sh │ │ │ │ │ +-r--r--r-- 1 0 0 2348 Jan 11 2024 [ 1821 00] morse.mod │ │ │ │ │ +-r--r--r-- 1 0 0 27896 Jan 11 2024 [ 1823 00] mpi.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2396 Jan 11 2024 [ 1837 00] msdospart.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2016 Jan 11 2024 [ 1839 00] mul_test.mod │ │ │ │ │ +-r--r--r-- 1 0 0 13920 Jan 11 2024 [ 1840 00] multiboot.mod │ │ │ │ │ +-r--r--r-- 1 0 0 15068 Jan 11 2024 [ 1847 00] multiboot2.mod │ │ │ │ │ +-r--r--r-- 1 0 0 4156 Jan 11 2024 [ 1855 00] nativedisk.mod │ │ │ │ │ +-r--r--r-- 1 0 0 57256 Jan 11 2024 [ 1858 00] net.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2836 Jan 11 2024 [ 1886 00] newc.mod │ │ │ │ │ +-r--r--r-- 1 0 0 6744 Jan 11 2024 [ 1888 00] nilfs2.mod │ │ │ │ │ +-r--r--r-- 1 0 0 114896 Jan 11 2024 [ 1892 00] normal.mod │ │ │ │ │ +-r--r--r-- 1 0 0 10652 Jan 11 2024 [ 1949 00] ntfs.mod │ │ │ │ │ +-r--r--r-- 1 0 0 4260 Jan 11 2024 [ 1955 00] ntfscomp.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2504 Jan 11 2024 [ 1958 00] ntldr.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2676 Jan 11 2024 [ 1960 00] odc.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1456 Jan 11 2024 [ 1962 00] offsetio.mod │ │ │ │ │ +-r--r--r-- 1 0 0 10420 Jan 11 2024 [ 1963 00] ohci.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1584 Jan 11 2024 [ 1969 00] part_acorn.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1812 Jan 11 2024 [ 1970 00] part_amiga.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2052 Jan 11 2024 [ 1971 00] part_apple.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2680 Jan 11 2024 [ 1973 00] part_bsd.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1708 Jan 11 2024 [ 1975 00] part_dfly.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1424 Jan 11 2024 [ 1976 00] part_dvh.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2292 Jan 11 2024 [ 1977 00] part_gpt.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2280 Jan 11 2024 [ 1979 00] part_msdos.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1732 Jan 11 2024 [ 1981 00] part_plan.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1452 Jan 11 2024 [ 1982 00] part_sun.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1580 Jan 11 2024 [ 1983 00] part_sunpc.mod │ │ │ │ │ +-r--r--r-- 1 0 0 111 Jan 11 2024 [ 1984 00] partmap.lst │ │ │ │ │ +-r--r--r-- 1 0 0 17 Jan 11 2024 [ 1985 00] parttool.lst │ │ │ │ │ +-r--r--r-- 1 0 0 4644 Jan 11 2024 [ 1986 00] parttool.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1820 Jan 11 2024 [ 1989 00] password.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2712 Jan 11 2024 [ 1990 00] password_pbkdf2.mod │ │ │ │ │ +-r--r--r-- 1 0 0 4812 Jan 11 2024 [ 1992 00] pata.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1312 Jan 11 2024 [ 1995 00] pbkdf2.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2100 Jan 11 2024 [ 1996 00] pbkdf2_test.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1316 Jan 11 2024 [ 1998 00] pci.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2416 Jan 11 2024 [ 1999 00] pcidump.mod │ │ │ │ │ +-r--r--r-- 1 0 0 11376 Jan 11 2024 [ 2001 00] pgp.mod │ │ │ │ │ +-r--r--r-- 1 0 0 6292 Jan 11 2024 [ 2007 00] plan9.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2452 Jan 11 2024 [ 2011 00] play.mod │ │ │ │ │ +-r--r--r-- 1 0 0 8052 Jan 11 2024 [ 2013 00] png.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1516 Jan 11 2024 [ 2017 00] priority_queue.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3456 Jan 11 2024 [ 2018 00] probe.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2284 Jan 11 2024 [ 2020 00] procfs.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2136 Jan 11 2024 [ 2022 00] progress.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3680 Jan 11 2024 [ 2024 00] pxe.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2616 Jan 11 2024 [ 2026 00] pxechain.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1292 Jan 11 2024 [ 2028 00] raid5rec.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2204 Jan 11 2024 [ 2029 00] raid6rec.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2784 Jan 11 2024 [ 2031 00] random.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1848 Jan 11 2024 [ 2033 00] rdmsr.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1404 Jan 11 2024 [ 2034 00] read.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1636 Jan 11 2024 [ 2035 00] reboot.mod │ │ │ │ │ +-r--r--r-- 1 0 0 51032 Jan 11 2024 [ 2036 00] regexp.mod │ │ │ │ │ +-r--r--r-- 1 0 0 8788 Jan 11 2024 [ 2061 00] reiserfs.mod │ │ │ │ │ +-r--r--r-- 1 0 0 14952 Jan 11 2024 [ 2066 00] relocator.mod │ │ │ │ │ +-r--r--r-- 1 0 0 4052 Jan 11 2024 [ 2074 00] romfs.mod │ │ │ │ │ +-r--r--r-- 1 0 0 4644 Jan 11 2024 [ 2076 00] scsi.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3624 Jan 11 2024 [ 2079 00] search.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3052 Jan 11 2024 [ 2081 00] search_fs_file.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3156 Jan 11 2024 [ 2083 00] search_fs_uuid.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3072 Jan 11 2024 [ 2085 00] search_label.mod │ │ │ │ │ +-r--r--r-- 1 0 0 7068 Jan 11 2024 [ 2087 00] sendkey.mod │ │ │ │ │ +-r--r--r-- 1 0 0 7696 Jan 11 2024 [ 2091 00] serial.mod │ │ │ │ │ +-r--r--r-- 1 0 0 628 Jan 11 2024 [ 2095 00] setjmp.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1624 Jan 11 2024 [ 2096 00] setjmp_test.mod │ │ │ │ │ +-r--r--r-- 1 0 0 5224 Jan 11 2024 [ 2097 00] setpci.mod │ │ │ │ │ +-r--r--r-- 1 0 0 5116 Jan 11 2024 [ 2100 00] sfs.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2396 Jan 11 2024 [ 2103 00] shift_test.mod │ │ │ │ │ +-r--r--r-- 1 0 0 6380 Jan 11 2024 [ 2105 00] signature_test.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2144 Jan 11 2024 [ 2109 00] sleep.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2260 Jan 11 2024 [ 2111 00] sleep_test.mod │ │ │ │ │ +-r--r--r-- 1 0 0 5564 Jan 11 2024 [ 2113 00] smbios.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2024 Jan 11 2024 [ 2116 00] spkmodem.mod │ │ │ │ │ +-r--r--r-- 1 0 0 7132 Jan 11 2024 [ 2117 00] squash4.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2112 Jan 11 2024 [ 2121 00] strtoull_test.mod │ │ │ │ │ +-r--r--r-- 1 0 0 17420 Jan 11 2024 [ 2123 00] syslinuxcfg.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3216 Jan 11 2024 [ 2132 00] tar.mod │ │ │ │ │ +-r--r--r-- 1 0 0 202 Jan 11 2024 [ 2134 00] terminal.lst │ │ │ │ │ +-r--r--r-- 1 0 0 4448 Jan 11 2024 [ 2135 00] terminal.mod │ │ │ │ │ +-r--r--r-- 1 0 0 12356 Jan 11 2024 [ 2138 00] terminfo.mod │ │ │ │ │ +-r--r--r-- 1 0 0 5000 Jan 11 2024 [ 2145 00] test.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1272 Jan 11 2024 [ 2148 00] test_blockarg.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2736 Jan 11 2024 [ 2149 00] testload.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2264 Jan 11 2024 [ 2151 00] testspeed.mod │ │ │ │ │ +-r--r--r-- 1 0 0 4920 Jan 11 2024 [ 2153 00] tftp.mod │ │ │ │ │ +-r--r--r-- 1 0 0 4588 Jan 11 2024 [ 2156 00] tga.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1456 Jan 11 2024 [ 2159 00] time.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2352 Jan 11 2024 [ 2160 00] tr.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1668 Jan 11 2024 [ 2162 00] trig.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1152 Jan 11 2024 [ 2163 00] true.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3728 Jan 11 2024 [ 2164 00] truecrypt.mod │ │ │ │ │ +-r--r--r-- 1 0 0 8500 Jan 11 2024 [ 2166 00] udf.mod │ │ │ │ │ +-r--r--r-- 1 0 0 5332 Jan 11 2024 [ 2171 00] ufs1.mod │ │ │ │ │ +-r--r--r-- 1 0 0 5716 Jan 11 2024 [ 2174 00] ufs1_be.mod │ │ │ │ │ +-r--r--r-- 1 0 0 5396 Jan 11 2024 [ 2177 00] ufs2.mod │ │ │ │ │ +-r--r--r-- 1 0 0 6492 Jan 11 2024 [ 2180 00] uhci.mod │ │ │ │ │ +-r--r--r-- 1 0 0 10376 Jan 11 2024 [ 2184 00] usb.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3764 Jan 11 2024 [ 2190 00] usb_keyboard.mod │ │ │ │ │ +-r--r--r-- 1 0 0 6912 Jan 11 2024 [ 2192 00] usbms.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1916 Jan 11 2024 [ 2196 00] usbserial_common.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2296 Jan 11 2024 [ 2197 00] usbserial_ftdi.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2632 Jan 11 2024 [ 2199 00] usbserial_pl2303.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1460 Jan 11 2024 [ 2201 00] usbserial_usbdebug.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3568 Jan 11 2024 [ 2202 00] usbtest.mod │ │ │ │ │ +-r--r--r-- 1 0 0 9828 Jan 11 2024 [ 2204 00] vbe.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2652 Jan 11 2024 [ 2209 00] verifiers.mod │ │ │ │ │ +-r--r--r-- 1 0 0 4932 Jan 11 2024 [ 2211 00] vga.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2140 Jan 11 2024 [ 2214 00] vga_text.mod │ │ │ │ │ +-r--r--r-- 1 0 0 33 Jan 11 2024 [ 2216 00] video.lst │ │ │ │ │ +-r--r--r-- 1 0 0 5980 Jan 11 2024 [ 2217 00] video.mod │ │ │ │ │ +-r--r--r-- 1 0 0 5588 Jan 11 2024 [ 2220 00] video_bochs.mod │ │ │ │ │ +-r--r--r-- 1 0 0 6004 Jan 11 2024 [ 2223 00] video_cirrus.mod │ │ │ │ │ +-r--r--r-- 1 0 0 5568 Jan 11 2024 [ 2226 00] video_colors.mod │ │ │ │ │ +-r--r--r-- 1 0 0 21016 Jan 11 2024 [ 2229 00] video_fb.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3892 Jan 11 2024 [ 2240 00] videoinfo.mod │ │ │ │ │ +-r--r--r-- 1 0 0 4216 Jan 11 2024 [ 2242 00] videotest.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2284 Jan 11 2024 [ 2245 00] videotest_checksum.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1448 Jan 11 2024 [ 2247 00] wrmsr.mod │ │ │ │ │ +-r--r--r-- 1 0 0 7484 Jan 11 2024 [ 2248 00] xfs.mod │ │ │ │ │ +-r--r--r-- 1 0 0 27468 Jan 11 2024 [ 2252 00] xnu.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2084 Jan 11 2024 [ 2266 00] xnu_uuid.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1924 Jan 11 2024 [ 2268 00] xnu_uuid_test.mod │ │ │ │ │ +-r--r--r-- 1 0 0 15456 Jan 11 2024 [ 2269 00] xzio.mod │ │ │ │ │ +-r--r--r-- 1 0 0 40256 Jan 11 2024 [ 2277 00] zfs.mod │ │ │ │ │ +-r--r--r-- 1 0 0 5488 Jan 11 2024 [ 2297 00] zfscrypt.mod │ │ │ │ │ +-r--r--r-- 1 0 0 6588 Jan 11 2024 [ 2300 00] zfsinfo.mod │ │ │ │ │ +-r--r--r-- 1 0 0 45868 Jan 11 2024 [ 2304 00] zstd.mod │ │ │ │ │ │ │ │ │ │ Directory listing of /boot/grub/locale/ │ │ │ │ │ -dr-xr-xr-x 1 0 0 2048 Feb 12 2025 [ 43 02] . │ │ │ │ │ -dr-xr-xr-x 1 0 0 2048 Feb 12 2025 [ 22 02] .. │ │ │ │ │ +dr-xr-xr-x 1 0 0 2048 Jan 11 2024 [ 43 02] . │ │ │ │ │ +dr-xr-xr-x 1 0 0 2048 Jan 11 2024 [ 22 02] .. │ │ │ │ │ │ │ │ │ │ Directory listing of /boot/grub/roms/ │ │ │ │ │ -dr-xr-xr-x 1 0 0 2048 Feb 12 2025 [ 44 02] . │ │ │ │ │ -dr-xr-xr-x 1 0 0 2048 Feb 12 2025 [ 22 02] .. │ │ │ │ │ +dr-xr-xr-x 1 0 0 2048 Jan 11 2024 [ 44 02] . │ │ │ │ │ +dr-xr-xr-x 1 0 0 2048 Jan 11 2024 [ 22 02] .. │ │ │ │ ├── file list │ │ │ │ │ @@ -1,297 +1,297 @@ │ │ │ │ │ -dr-xr-xr-x 3 0 0 2048 2025-02-12 10:55:46.000000 . │ │ │ │ │ -dr-xr-xr-x 3 0 0 2048 2025-02-12 10:55:47.000000 boot │ │ │ │ │ -dr-xr-xr-x 6 0 0 2048 2025-02-12 10:55:47.000000 boot/grub │ │ │ │ │ -dr-xr-xr-x 2 0 0 2048 2025-02-12 10:55:47.000000 boot/grub/fonts │ │ │ │ │ -dr-xr-xr-x 2 0 0 38912 2025-02-12 10:55:47.000000 boot/grub/i386-pc │ │ │ │ │ -dr-xr-xr-x 2 0 0 2048 2025-02-12 10:55:47.000000 boot/grub/locale │ │ │ │ │ -dr-xr-xr-x 2 0 0 2048 2025-02-12 10:55:47.000000 boot/grub/roms │ │ │ │ │ --r--r--r-- 1 0 0 2048 2025-02-12 10:55:47.000000 boot.catalog │ │ │ │ │ --r--r--r-- 1 0 0 2392304 2025-02-12 10:55:47.000000 boot/grub/fonts/unicode.pf2 │ │ │ │ │ --r--r--r-- 1 0 0 1705 2025-02-12 10:55:46.000000 boot/grub/grub.cfg │ │ │ │ │ --r--r--r-- 1 0 0 7780 2025-02-12 10:55:47.000000 boot/grub/i386-pc/915resolution.mod │ │ │ │ │ --r--r--r-- 1 0 0 10868 2025-02-12 10:55:47.000000 boot/grub/i386-pc/acpi.mod │ │ │ │ │ --r--r--r-- 1 0 0 1228 2025-02-12 10:55:47.000000 boot/grub/i386-pc/adler32.mod │ │ │ │ │ --r--r--r-- 1 0 0 5568 2025-02-12 10:55:47.000000 boot/grub/i386-pc/affs.mod │ │ │ │ │ --r--r--r-- 1 0 0 6020 2025-02-12 10:55:47.000000 boot/grub/i386-pc/afs.mod │ │ │ │ │ --r--r--r-- 1 0 0 1516 2025-02-12 10:55:47.000000 boot/grub/i386-pc/afsplitter.mod │ │ │ │ │ --r--r--r-- 1 0 0 15392 2025-02-12 10:55:47.000000 boot/grub/i386-pc/ahci.mod │ │ │ │ │ --r--r--r-- 1 0 0 492 2025-02-12 10:55:47.000000 boot/grub/i386-pc/all_video.mod │ │ │ │ │ --r--r--r-- 1 0 0 956 2025-02-12 10:55:47.000000 boot/grub/i386-pc/aout.mod │ │ │ │ │ --r--r--r-- 1 0 0 2836 2025-02-12 10:55:47.000000 boot/grub/i386-pc/archelp.mod │ │ │ │ │ --r--r--r-- 1 0 0 4068 2025-02-12 10:55:47.000000 boot/grub/i386-pc/at_keyboard.mod │ │ │ │ │ --r--r--r-- 1 0 0 5524 2025-02-12 10:55:47.000000 boot/grub/i386-pc/ata.mod │ │ │ │ │ --r--r--r-- 1 0 0 1576 2025-02-12 10:55:47.000000 boot/grub/i386-pc/backtrace.mod │ │ │ │ │ --r--r--r-- 1 0 0 6728 2025-02-12 10:55:47.000000 boot/grub/i386-pc/bfs.mod │ │ │ │ │ --r--r--r-- 1 0 0 4636 2025-02-12 10:55:47.000000 boot/grub/i386-pc/biosdisk.mod │ │ │ │ │ --r--r--r-- 1 0 0 2184 2025-02-12 10:55:47.000000 boot/grub/i386-pc/bitmap.mod │ │ │ │ │ --r--r--r-- 1 0 0 3616 2025-02-12 10:55:47.000000 boot/grub/i386-pc/bitmap_scale.mod │ │ │ │ │ --r--r--r-- 1 0 0 1984 2025-02-12 10:55:47.000000 boot/grub/i386-pc/blocklist.mod │ │ │ │ │ --r--r--r-- 1 0 0 2628 2025-02-12 10:55:47.000000 boot/grub/i386-pc/boot.mod │ │ │ │ │ --r--r--r-- 1 0 0 30568 2025-02-12 10:55:47.000000 boot/grub/i386-pc/bsd.mod │ │ │ │ │ --r--r--r-- 1 0 0 2252 2025-02-12 10:55:47.000000 boot/grub/i386-pc/bswap_test.mod │ │ │ │ │ --r--r--r-- 1 0 0 19712 2025-02-12 10:55:47.000000 boot/grub/i386-pc/btrfs.mod │ │ │ │ │ --r--r--r-- 1 0 0 2028 2025-02-12 10:55:47.000000 boot/grub/i386-pc/bufio.mod │ │ │ │ │ --r--r--r-- 1 0 0 2884 2025-02-12 10:55:47.000000 boot/grub/i386-pc/cat.mod │ │ │ │ │ --r--r--r-- 1 0 0 3892 2025-02-12 10:55:47.000000 boot/grub/i386-pc/cbfs.mod │ │ │ │ │ --r--r--r-- 1 0 0 3340 2025-02-12 10:55:47.000000 boot/grub/i386-pc/cbls.mod │ │ │ │ │ --r--r--r-- 1 0 0 2448 2025-02-12 10:55:47.000000 boot/grub/i386-pc/cbmemc.mod │ │ │ │ │ --r--r--r-- 1 0 0 1048 2025-02-12 10:55:47.000000 boot/grub/i386-pc/cbtable.mod │ │ │ │ │ --r--r--r-- 1 0 0 2772 2025-02-12 10:55:47.000000 boot/grub/i386-pc/cbtime.mod │ │ │ │ │ --r--r--r-- 1 0 0 3448 2025-02-12 10:55:47.000000 boot/grub/i386-pc/chain.mod │ │ │ │ │ --r--r--r-- 1 0 0 2960 2025-02-12 10:55:47.000000 boot/grub/i386-pc/cmdline_cat_test.mod │ │ │ │ │ --r--r--r-- 1 0 0 1216 2025-02-12 10:55:47.000000 boot/grub/i386-pc/cmosdump.mod │ │ │ │ │ --r--r--r-- 1 0 0 1808 2025-02-12 10:55:47.000000 boot/grub/i386-pc/cmostest.mod │ │ │ │ │ --r--r--r-- 1 0 0 2056 2025-02-12 10:55:47.000000 boot/grub/i386-pc/cmp.mod │ │ │ │ │ --r--r--r-- 1 0 0 4608 2025-02-12 10:55:47.000000 boot/grub/i386-pc/cmp_test.mod │ │ │ │ │ --r--r--r-- 1 0 0 3887 2025-02-12 10:55:47.000000 boot/grub/i386-pc/command.lst │ │ │ │ │ --r--r--r-- 1 0 0 2224 2025-02-12 10:55:47.000000 boot/grub/i386-pc/configfile.mod │ │ │ │ │ --r--r--r-- 1 0 0 2612 2025-02-12 10:55:47.000000 boot/grub/i386-pc/cpio.mod │ │ │ │ │ --r--r--r-- 1 0 0 2680 2025-02-12 10:55:47.000000 boot/grub/i386-pc/cpio_be.mod │ │ │ │ │ --r--r--r-- 1 0 0 1664 2025-02-12 10:55:47.000000 boot/grub/i386-pc/cpuid.mod │ │ │ │ │ --r--r--r-- 1 0 0 1572 2025-02-12 10:55:47.000000 boot/grub/i386-pc/crc64.mod │ │ │ │ │ --r--r--r-- 1 0 0 936 2025-02-12 10:55:47.000000 boot/grub/i386-pc/crypto.lst │ │ │ │ │ --r--r--r-- 1 0 0 4944 2025-02-12 10:55:47.000000 boot/grub/i386-pc/crypto.mod │ │ │ │ │ --r--r--r-- 1 0 0 11900 2025-02-12 10:55:47.000000 boot/grub/i386-pc/cryptodisk.mod │ │ │ │ │ --r--r--r-- 1 0 0 3588 2025-02-12 10:55:47.000000 boot/grub/i386-pc/cs5536.mod │ │ │ │ │ --r--r--r-- 1 0 0 1680 2025-02-12 10:55:47.000000 boot/grub/i386-pc/ctz_test.mod │ │ │ │ │ --r--r--r-- 1 0 0 2148 2025-02-12 10:55:47.000000 boot/grub/i386-pc/date.mod │ │ │ │ │ --r--r--r-- 1 0 0 1716 2025-02-12 10:55:47.000000 boot/grub/i386-pc/datehook.mod │ │ │ │ │ --r--r--r-- 1 0 0 2232 2025-02-12 10:55:47.000000 boot/grub/i386-pc/datetime.mod │ │ │ │ │ --r--r--r-- 1 0 0 2332 2025-02-12 10:55:47.000000 boot/grub/i386-pc/disk.mod │ │ │ │ │ --r--r--r-- 1 0 0 9836 2025-02-12 10:55:47.000000 boot/grub/i386-pc/diskfilter.mod │ │ │ │ │ --r--r--r-- 1 0 0 956 2025-02-12 10:55:47.000000 boot/grub/i386-pc/div.mod │ │ │ │ │ --r--r--r-- 1 0 0 5560 2025-02-12 10:55:47.000000 boot/grub/i386-pc/div_test.mod │ │ │ │ │ --r--r--r-- 1 0 0 1772 2025-02-12 10:55:47.000000 boot/grub/i386-pc/dm_nv.mod │ │ │ │ │ --r--r--r-- 1 0 0 5316 2025-02-12 10:55:47.000000 boot/grub/i386-pc/drivemap.mod │ │ │ │ │ --r--r--r-- 1 0 0 1896 2025-02-12 10:55:47.000000 boot/grub/i386-pc/echo.mod │ │ │ │ │ --r--r--r-- 1 0 0 23696 2025-02-12 10:55:47.000000 boot/grub/i386-pc/efiemu.mod │ │ │ │ │ --r--r--r-- 1 0 0 7608 2025-02-12 10:55:47.000000 boot/grub/i386-pc/efiemu32.o │ │ │ │ │ --r--r--r-- 1 0 0 10112 2025-02-12 10:55:47.000000 boot/grub/i386-pc/efiemu64.o │ │ │ │ │ --r--r--r-- 1 0 0 16128 2025-02-12 10:55:47.000000 boot/grub/i386-pc/ehci.mod │ │ │ │ │ --r--r--r-- 1 0 0 4064 2025-02-12 10:55:47.000000 boot/grub/i386-pc/elf.mod │ │ │ │ │ --r--r--r-- 1 0 0 29251 2025-02-12 10:55:47.000000 boot/grub/i386-pc/eltorito.img │ │ │ │ │ --r--r--r-- 1 0 0 1368 2025-02-12 10:55:47.000000 boot/grub/i386-pc/eval.mod │ │ │ │ │ --r--r--r-- 1 0 0 6080 2025-02-12 10:55:47.000000 boot/grub/i386-pc/exfat.mod │ │ │ │ │ --r--r--r-- 1 0 0 1380 2025-02-12 10:55:47.000000 boot/grub/i386-pc/exfctest.mod │ │ │ │ │ --r--r--r-- 1 0 0 6172 2025-02-12 10:55:47.000000 boot/grub/i386-pc/ext2.mod │ │ │ │ │ --r--r--r-- 1 0 0 4640 2025-02-12 10:55:47.000000 boot/grub/i386-pc/extcmd.mod │ │ │ │ │ --r--r--r-- 1 0 0 6460 2025-02-12 10:55:47.000000 boot/grub/i386-pc/f2fs.mod │ │ │ │ │ --r--r--r-- 1 0 0 6192 2025-02-12 10:55:47.000000 boot/grub/i386-pc/fat.mod │ │ │ │ │ --r--r--r-- 1 0 0 16932 2025-02-12 10:55:47.000000 boot/grub/i386-pc/file.mod │ │ │ │ │ --r--r--r-- 1 0 0 13520 2025-02-12 10:55:47.000000 boot/grub/i386-pc/font.mod │ │ │ │ │ --r--r--r-- 1 0 0 2612 2025-02-12 10:55:47.000000 boot/grub/i386-pc/freedos.mod │ │ │ │ │ --r--r--r-- 1 0 0 219 2025-02-12 10:55:47.000000 boot/grub/i386-pc/fs.lst │ │ │ │ │ --r--r--r-- 1 0 0 2920 2025-02-12 10:55:47.000000 boot/grub/i386-pc/fshelp.mod │ │ │ │ │ --r--r--r-- 1 0 0 34168 2025-02-12 10:55:47.000000 boot/grub/i386-pc/functional_test.mod │ │ │ │ │ --r--r--r-- 1 0 0 1612 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gcry_arcfour.mod │ │ │ │ │ --r--r--r-- 1 0 0 8000 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gcry_blowfish.mod │ │ │ │ │ --r--r--r-- 1 0 0 33516 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gcry_camellia.mod │ │ │ │ │ --r--r--r-- 1 0 0 16356 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gcry_cast5.mod │ │ │ │ │ --r--r--r-- 1 0 0 10564 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gcry_crc.mod │ │ │ │ │ --r--r--r-- 1 0 0 19104 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gcry_des.mod │ │ │ │ │ --r--r--r-- 1 0 0 2188 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gcry_dsa.mod │ │ │ │ │ --r--r--r-- 1 0 0 2884 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gcry_idea.mod │ │ │ │ │ --r--r--r-- 1 0 0 3048 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gcry_md4.mod │ │ │ │ │ --r--r--r-- 1 0 0 3668 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gcry_md5.mod │ │ │ │ │ --r--r--r-- 1 0 0 2316 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gcry_rfc2268.mod │ │ │ │ │ --r--r--r-- 1 0 0 19312 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gcry_rijndael.mod │ │ │ │ │ --r--r--r-- 1 0 0 8248 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gcry_rmd160.mod │ │ │ │ │ --r--r--r-- 1 0 0 1968 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gcry_rsa.mod │ │ │ │ │ --r--r--r-- 1 0 0 14824 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gcry_seed.mod │ │ │ │ │ --r--r--r-- 1 0 0 17700 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gcry_serpent.mod │ │ │ │ │ --r--r--r-- 1 0 0 8592 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gcry_sha1.mod │ │ │ │ │ --r--r--r-- 1 0 0 4376 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gcry_sha256.mod │ │ │ │ │ --r--r--r-- 1 0 0 8804 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gcry_sha512.mod │ │ │ │ │ --r--r--r-- 1 0 0 12244 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gcry_tiger.mod │ │ │ │ │ --r--r--r-- 1 0 0 36816 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gcry_twofish.mod │ │ │ │ │ --r--r--r-- 1 0 0 24588 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gcry_whirlpool.mod │ │ │ │ │ --r--r--r-- 1 0 0 25036 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gdb.mod │ │ │ │ │ --r--r--r-- 1 0 0 5884 2025-02-12 10:55:47.000000 boot/grub/i386-pc/geli.mod │ │ │ │ │ --r--r--r-- 1 0 0 4860 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gettext.mod │ │ │ │ │ --r--r--r-- 1 0 0 39136 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gfxmenu.mod │ │ │ │ │ --r--r--r-- 1 0 0 9892 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gfxterm.mod │ │ │ │ │ --r--r--r-- 1 0 0 2796 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gfxterm_background.mod │ │ │ │ │ --r--r--r-- 1 0 0 4912 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gfxterm_menu.mod │ │ │ │ │ --r--r--r-- 1 0 0 3740 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gptsync.mod │ │ │ │ │ --r--r--r-- 1 0 0 8784 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gzio.mod │ │ │ │ │ --r--r--r-- 1 0 0 4684 2025-02-12 10:55:47.000000 boot/grub/i386-pc/halt.mod │ │ │ │ │ --r--r--r-- 1 0 0 5168 2025-02-12 10:55:47.000000 boot/grub/i386-pc/hashsum.mod │ │ │ │ │ --r--r--r-- 1 0 0 6560 2025-02-12 10:55:47.000000 boot/grub/i386-pc/hdparm.mod │ │ │ │ │ --r--r--r-- 1 0 0 1140 2025-02-12 10:55:47.000000 boot/grub/i386-pc/hello.mod │ │ │ │ │ --r--r--r-- 1 0 0 2512 2025-02-12 10:55:47.000000 boot/grub/i386-pc/help.mod │ │ │ │ │ --r--r--r-- 1 0 0 3216 2025-02-12 10:55:47.000000 boot/grub/i386-pc/hexdump.mod │ │ │ │ │ --r--r--r-- 1 0 0 7004 2025-02-12 10:55:47.000000 boot/grub/i386-pc/hfs.mod │ │ │ │ │ --r--r--r-- 1 0 0 7848 2025-02-12 10:55:47.000000 boot/grub/i386-pc/hfsplus.mod │ │ │ │ │ --r--r--r-- 1 0 0 2960 2025-02-12 10:55:47.000000 boot/grub/i386-pc/hfspluscomp.mod │ │ │ │ │ --r--r--r-- 1 0 0 5700 2025-02-12 10:55:47.000000 boot/grub/i386-pc/http.mod │ │ │ │ │ --r--r--r-- 1 0 0 2468 2025-02-12 10:55:47.000000 boot/grub/i386-pc/hwmatch.mod │ │ │ │ │ --r--r--r-- 1 0 0 2800 2025-02-12 10:55:47.000000 boot/grub/i386-pc/iorw.mod │ │ │ │ │ --r--r--r-- 1 0 0 8488 2025-02-12 10:55:47.000000 boot/grub/i386-pc/iso9660.mod │ │ │ │ │ --r--r--r-- 1 0 0 6092 2025-02-12 10:55:47.000000 boot/grub/i386-pc/jfs.mod │ │ │ │ │ --r--r--r-- 1 0 0 7660 2025-02-12 10:55:47.000000 boot/grub/i386-pc/jpeg.mod │ │ │ │ │ --r--r--r-- 1 0 0 3504 2025-02-12 10:55:47.000000 boot/grub/i386-pc/json.mod │ │ │ │ │ --r--r--r-- 1 0 0 5032 2025-02-12 10:55:47.000000 boot/grub/i386-pc/keylayouts.mod │ │ │ │ │ --r--r--r-- 1 0 0 1904 2025-02-12 10:55:47.000000 boot/grub/i386-pc/keystatus.mod │ │ │ │ │ --r--r--r-- 1 0 0 6300 2025-02-12 10:55:47.000000 boot/grub/i386-pc/ldm.mod │ │ │ │ │ --r--r--r-- 1 0 0 14404 2025-02-12 10:55:47.000000 boot/grub/i386-pc/legacy_password_test.mod │ │ │ │ │ --r--r--r-- 1 0 0 30132 2025-02-12 10:55:47.000000 boot/grub/i386-pc/legacycfg.mod │ │ │ │ │ --r--r--r-- 1 0 0 13172 2025-02-12 10:55:47.000000 boot/grub/i386-pc/linux.mod │ │ │ │ │ --r--r--r-- 1 0 0 5524 2025-02-12 10:55:47.000000 boot/grub/i386-pc/linux16.mod │ │ │ │ │ --r--r--r-- 1 0 0 5748 2025-02-12 10:55:47.000000 boot/grub/i386-pc/loadenv.mod │ │ │ │ │ --r--r--r-- 1 0 0 3004 2025-02-12 10:55:47.000000 boot/grub/i386-pc/loopback.mod │ │ │ │ │ --r--r--r-- 1 0 0 3856 2025-02-12 10:55:47.000000 boot/grub/i386-pc/ls.mod │ │ │ │ │ --r--r--r-- 1 0 0 4740 2025-02-12 10:55:47.000000 boot/grub/i386-pc/lsacpi.mod │ │ │ │ │ --r--r--r-- 1 0 0 2236 2025-02-12 10:55:47.000000 boot/grub/i386-pc/lsapm.mod │ │ │ │ │ --r--r--r-- 1 0 0 1820 2025-02-12 10:55:47.000000 boot/grub/i386-pc/lsmmap.mod │ │ │ │ │ --r--r--r-- 1 0 0 4828 2025-02-12 10:55:47.000000 boot/grub/i386-pc/lspci.mod │ │ │ │ │ --r--r--r-- 1 0 0 4356 2025-02-12 10:55:47.000000 boot/grub/i386-pc/luks.mod │ │ │ │ │ --r--r--r-- 1 0 0 14216 2025-02-12 10:55:47.000000 boot/grub/i386-pc/luks2.mod │ │ │ │ │ --r--r--r-- 1 0 0 8472 2025-02-12 10:55:47.000000 boot/grub/i386-pc/lvm.mod │ │ │ │ │ --r--r--r-- 1 0 0 4756 2025-02-12 10:55:47.000000 boot/grub/i386-pc/lzopio.mod │ │ │ │ │ --r--r--r-- 1 0 0 3200 2025-02-12 10:55:47.000000 boot/grub/i386-pc/macbless.mod │ │ │ │ │ --r--r--r-- 1 0 0 7500 2025-02-12 10:55:47.000000 boot/grub/i386-pc/macho.mod │ │ │ │ │ --r--r--r-- 1 0 0 2044 2025-02-12 10:55:47.000000 boot/grub/i386-pc/mda_text.mod │ │ │ │ │ --r--r--r-- 1 0 0 2112 2025-02-12 10:55:47.000000 boot/grub/i386-pc/mdraid09.mod │ │ │ │ │ --r--r--r-- 1 0 0 1968 2025-02-12 10:55:47.000000 boot/grub/i386-pc/mdraid09_be.mod │ │ │ │ │ --r--r--r-- 1 0 0 1852 2025-02-12 10:55:47.000000 boot/grub/i386-pc/mdraid1x.mod │ │ │ │ │ --r--r--r-- 1 0 0 1988 2025-02-12 10:55:47.000000 boot/grub/i386-pc/memdisk.mod │ │ │ │ │ --r--r--r-- 1 0 0 2824 2025-02-12 10:55:47.000000 boot/grub/i386-pc/memrw.mod │ │ │ │ │ --r--r--r-- 1 0 0 3504 2025-02-12 10:55:47.000000 boot/grub/i386-pc/minicmd.mod │ │ │ │ │ --r--r--r-- 1 0 0 3596 2025-02-12 10:55:47.000000 boot/grub/i386-pc/minix.mod │ │ │ │ │ --r--r--r-- 1 0 0 3692 2025-02-12 10:55:47.000000 boot/grub/i386-pc/minix2.mod │ │ │ │ │ --r--r--r-- 1 0 0 3856 2025-02-12 10:55:47.000000 boot/grub/i386-pc/minix2_be.mod │ │ │ │ │ --r--r--r-- 1 0 0 3692 2025-02-12 10:55:47.000000 boot/grub/i386-pc/minix3.mod │ │ │ │ │ --r--r--r-- 1 0 0 3856 2025-02-12 10:55:47.000000 boot/grub/i386-pc/minix3_be.mod │ │ │ │ │ --r--r--r-- 1 0 0 3724 2025-02-12 10:55:47.000000 boot/grub/i386-pc/minix_be.mod │ │ │ │ │ --r--r--r-- 1 0 0 8544 2025-02-12 10:55:47.000000 boot/grub/i386-pc/mmap.mod │ │ │ │ │ --r--r--r-- 1 0 0 5709 2025-02-12 10:55:47.000000 boot/grub/i386-pc/moddep.lst │ │ │ │ │ --r--r--r-- 1 0 0 2567 2025-02-12 10:55:47.000000 boot/grub/i386-pc/modinfo.sh │ │ │ │ │ --r--r--r-- 1 0 0 2348 2025-02-12 10:55:47.000000 boot/grub/i386-pc/morse.mod │ │ │ │ │ --r--r--r-- 1 0 0 27896 2025-02-12 10:55:47.000000 boot/grub/i386-pc/mpi.mod │ │ │ │ │ --r--r--r-- 1 0 0 2396 2025-02-12 10:55:47.000000 boot/grub/i386-pc/msdospart.mod │ │ │ │ │ --r--r--r-- 1 0 0 2016 2025-02-12 10:55:47.000000 boot/grub/i386-pc/mul_test.mod │ │ │ │ │ --r--r--r-- 1 0 0 13920 2025-02-12 10:55:47.000000 boot/grub/i386-pc/multiboot.mod │ │ │ │ │ --r--r--r-- 1 0 0 15068 2025-02-12 10:55:47.000000 boot/grub/i386-pc/multiboot2.mod │ │ │ │ │ --r--r--r-- 1 0 0 4156 2025-02-12 10:55:47.000000 boot/grub/i386-pc/nativedisk.mod │ │ │ │ │ --r--r--r-- 1 0 0 57256 2025-02-12 10:55:47.000000 boot/grub/i386-pc/net.mod │ │ │ │ │ --r--r--r-- 1 0 0 2836 2025-02-12 10:55:47.000000 boot/grub/i386-pc/newc.mod │ │ │ │ │ --r--r--r-- 1 0 0 6744 2025-02-12 10:55:47.000000 boot/grub/i386-pc/nilfs2.mod │ │ │ │ │ --r--r--r-- 1 0 0 114896 2025-02-12 10:55:47.000000 boot/grub/i386-pc/normal.mod │ │ │ │ │ --r--r--r-- 1 0 0 10652 2025-02-12 10:55:47.000000 boot/grub/i386-pc/ntfs.mod │ │ │ │ │ --r--r--r-- 1 0 0 4260 2025-02-12 10:55:47.000000 boot/grub/i386-pc/ntfscomp.mod │ │ │ │ │ --r--r--r-- 1 0 0 2504 2025-02-12 10:55:47.000000 boot/grub/i386-pc/ntldr.mod │ │ │ │ │ --r--r--r-- 1 0 0 2676 2025-02-12 10:55:47.000000 boot/grub/i386-pc/odc.mod │ │ │ │ │ --r--r--r-- 1 0 0 1456 2025-02-12 10:55:47.000000 boot/grub/i386-pc/offsetio.mod │ │ │ │ │ --r--r--r-- 1 0 0 10420 2025-02-12 10:55:47.000000 boot/grub/i386-pc/ohci.mod │ │ │ │ │ --r--r--r-- 1 0 0 1584 2025-02-12 10:55:47.000000 boot/grub/i386-pc/part_acorn.mod │ │ │ │ │ --r--r--r-- 1 0 0 1812 2025-02-12 10:55:47.000000 boot/grub/i386-pc/part_amiga.mod │ │ │ │ │ --r--r--r-- 1 0 0 2052 2025-02-12 10:55:47.000000 boot/grub/i386-pc/part_apple.mod │ │ │ │ │ --r--r--r-- 1 0 0 2680 2025-02-12 10:55:47.000000 boot/grub/i386-pc/part_bsd.mod │ │ │ │ │ --r--r--r-- 1 0 0 1708 2025-02-12 10:55:47.000000 boot/grub/i386-pc/part_dfly.mod │ │ │ │ │ --r--r--r-- 1 0 0 1424 2025-02-12 10:55:47.000000 boot/grub/i386-pc/part_dvh.mod │ │ │ │ │ --r--r--r-- 1 0 0 2292 2025-02-12 10:55:47.000000 boot/grub/i386-pc/part_gpt.mod │ │ │ │ │ --r--r--r-- 1 0 0 2280 2025-02-12 10:55:47.000000 boot/grub/i386-pc/part_msdos.mod │ │ │ │ │ --r--r--r-- 1 0 0 1732 2025-02-12 10:55:47.000000 boot/grub/i386-pc/part_plan.mod │ │ │ │ │ --r--r--r-- 1 0 0 1452 2025-02-12 10:55:47.000000 boot/grub/i386-pc/part_sun.mod │ │ │ │ │ --r--r--r-- 1 0 0 1580 2025-02-12 10:55:47.000000 boot/grub/i386-pc/part_sunpc.mod │ │ │ │ │ --r--r--r-- 1 0 0 111 2025-02-12 10:55:47.000000 boot/grub/i386-pc/partmap.lst │ │ │ │ │ --r--r--r-- 1 0 0 17 2025-02-12 10:55:47.000000 boot/grub/i386-pc/parttool.lst │ │ │ │ │ --r--r--r-- 1 0 0 4644 2025-02-12 10:55:47.000000 boot/grub/i386-pc/parttool.mod │ │ │ │ │ --r--r--r-- 1 0 0 1820 2025-02-12 10:55:47.000000 boot/grub/i386-pc/password.mod │ │ │ │ │ --r--r--r-- 1 0 0 2712 2025-02-12 10:55:47.000000 boot/grub/i386-pc/password_pbkdf2.mod │ │ │ │ │ --r--r--r-- 1 0 0 4812 2025-02-12 10:55:47.000000 boot/grub/i386-pc/pata.mod │ │ │ │ │ --r--r--r-- 1 0 0 1312 2025-02-12 10:55:47.000000 boot/grub/i386-pc/pbkdf2.mod │ │ │ │ │ --r--r--r-- 1 0 0 2100 2025-02-12 10:55:47.000000 boot/grub/i386-pc/pbkdf2_test.mod │ │ │ │ │ --r--r--r-- 1 0 0 1316 2025-02-12 10:55:47.000000 boot/grub/i386-pc/pci.mod │ │ │ │ │ --r--r--r-- 1 0 0 2416 2025-02-12 10:55:47.000000 boot/grub/i386-pc/pcidump.mod │ │ │ │ │ --r--r--r-- 1 0 0 11376 2025-02-12 10:55:47.000000 boot/grub/i386-pc/pgp.mod │ │ │ │ │ --r--r--r-- 1 0 0 6292 2025-02-12 10:55:47.000000 boot/grub/i386-pc/plan9.mod │ │ │ │ │ --r--r--r-- 1 0 0 2452 2025-02-12 10:55:47.000000 boot/grub/i386-pc/play.mod │ │ │ │ │ --r--r--r-- 1 0 0 8052 2025-02-12 10:55:47.000000 boot/grub/i386-pc/png.mod │ │ │ │ │ --r--r--r-- 1 0 0 1516 2025-02-12 10:55:47.000000 boot/grub/i386-pc/priority_queue.mod │ │ │ │ │ --r--r--r-- 1 0 0 3456 2025-02-12 10:55:47.000000 boot/grub/i386-pc/probe.mod │ │ │ │ │ --r--r--r-- 1 0 0 2284 2025-02-12 10:55:47.000000 boot/grub/i386-pc/procfs.mod │ │ │ │ │ --r--r--r-- 1 0 0 2136 2025-02-12 10:55:47.000000 boot/grub/i386-pc/progress.mod │ │ │ │ │ --r--r--r-- 1 0 0 3680 2025-02-12 10:55:47.000000 boot/grub/i386-pc/pxe.mod │ │ │ │ │ --r--r--r-- 1 0 0 2616 2025-02-12 10:55:47.000000 boot/grub/i386-pc/pxechain.mod │ │ │ │ │ --r--r--r-- 1 0 0 1292 2025-02-12 10:55:47.000000 boot/grub/i386-pc/raid5rec.mod │ │ │ │ │ --r--r--r-- 1 0 0 2204 2025-02-12 10:55:47.000000 boot/grub/i386-pc/raid6rec.mod │ │ │ │ │ --r--r--r-- 1 0 0 2784 2025-02-12 10:55:47.000000 boot/grub/i386-pc/random.mod │ │ │ │ │ --r--r--r-- 1 0 0 1848 2025-02-12 10:55:47.000000 boot/grub/i386-pc/rdmsr.mod │ │ │ │ │ --r--r--r-- 1 0 0 1404 2025-02-12 10:55:47.000000 boot/grub/i386-pc/read.mod │ │ │ │ │ --r--r--r-- 1 0 0 1636 2025-02-12 10:55:47.000000 boot/grub/i386-pc/reboot.mod │ │ │ │ │ --r--r--r-- 1 0 0 51032 2025-02-12 10:55:47.000000 boot/grub/i386-pc/regexp.mod │ │ │ │ │ --r--r--r-- 1 0 0 8788 2025-02-12 10:55:47.000000 boot/grub/i386-pc/reiserfs.mod │ │ │ │ │ --r--r--r-- 1 0 0 14952 2025-02-12 10:55:47.000000 boot/grub/i386-pc/relocator.mod │ │ │ │ │ --r--r--r-- 1 0 0 4052 2025-02-12 10:55:47.000000 boot/grub/i386-pc/romfs.mod │ │ │ │ │ --r--r--r-- 1 0 0 4644 2025-02-12 10:55:47.000000 boot/grub/i386-pc/scsi.mod │ │ │ │ │ --r--r--r-- 1 0 0 3624 2025-02-12 10:55:47.000000 boot/grub/i386-pc/search.mod │ │ │ │ │ --r--r--r-- 1 0 0 3052 2025-02-12 10:55:47.000000 boot/grub/i386-pc/search_fs_file.mod │ │ │ │ │ --r--r--r-- 1 0 0 3156 2025-02-12 10:55:47.000000 boot/grub/i386-pc/search_fs_uuid.mod │ │ │ │ │ --r--r--r-- 1 0 0 3072 2025-02-12 10:55:47.000000 boot/grub/i386-pc/search_label.mod │ │ │ │ │ --r--r--r-- 1 0 0 7068 2025-02-12 10:55:47.000000 boot/grub/i386-pc/sendkey.mod │ │ │ │ │ --r--r--r-- 1 0 0 7696 2025-02-12 10:55:47.000000 boot/grub/i386-pc/serial.mod │ │ │ │ │ --r--r--r-- 1 0 0 628 2025-02-12 10:55:47.000000 boot/grub/i386-pc/setjmp.mod │ │ │ │ │ --r--r--r-- 1 0 0 1624 2025-02-12 10:55:47.000000 boot/grub/i386-pc/setjmp_test.mod │ │ │ │ │ --r--r--r-- 1 0 0 5224 2025-02-12 10:55:47.000000 boot/grub/i386-pc/setpci.mod │ │ │ │ │ --r--r--r-- 1 0 0 5116 2025-02-12 10:55:47.000000 boot/grub/i386-pc/sfs.mod │ │ │ │ │ --r--r--r-- 1 0 0 2396 2025-02-12 10:55:47.000000 boot/grub/i386-pc/shift_test.mod │ │ │ │ │ --r--r--r-- 1 0 0 6380 2025-02-12 10:55:47.000000 boot/grub/i386-pc/signature_test.mod │ │ │ │ │ --r--r--r-- 1 0 0 2144 2025-02-12 10:55:47.000000 boot/grub/i386-pc/sleep.mod │ │ │ │ │ --r--r--r-- 1 0 0 2260 2025-02-12 10:55:47.000000 boot/grub/i386-pc/sleep_test.mod │ │ │ │ │ --r--r--r-- 1 0 0 5564 2025-02-12 10:55:47.000000 boot/grub/i386-pc/smbios.mod │ │ │ │ │ --r--r--r-- 1 0 0 2024 2025-02-12 10:55:47.000000 boot/grub/i386-pc/spkmodem.mod │ │ │ │ │ --r--r--r-- 1 0 0 7132 2025-02-12 10:55:47.000000 boot/grub/i386-pc/squash4.mod │ │ │ │ │ --r--r--r-- 1 0 0 2112 2025-02-12 10:55:47.000000 boot/grub/i386-pc/strtoull_test.mod │ │ │ │ │ --r--r--r-- 1 0 0 17420 2025-02-12 10:55:47.000000 boot/grub/i386-pc/syslinuxcfg.mod │ │ │ │ │ --r--r--r-- 1 0 0 3216 2025-02-12 10:55:47.000000 boot/grub/i386-pc/tar.mod │ │ │ │ │ --r--r--r-- 1 0 0 202 2025-02-12 10:55:47.000000 boot/grub/i386-pc/terminal.lst │ │ │ │ │ --r--r--r-- 1 0 0 4448 2025-02-12 10:55:47.000000 boot/grub/i386-pc/terminal.mod │ │ │ │ │ --r--r--r-- 1 0 0 12356 2025-02-12 10:55:47.000000 boot/grub/i386-pc/terminfo.mod │ │ │ │ │ --r--r--r-- 1 0 0 5000 2025-02-12 10:55:47.000000 boot/grub/i386-pc/test.mod │ │ │ │ │ --r--r--r-- 1 0 0 1272 2025-02-12 10:55:47.000000 boot/grub/i386-pc/test_blockarg.mod │ │ │ │ │ --r--r--r-- 1 0 0 2736 2025-02-12 10:55:47.000000 boot/grub/i386-pc/testload.mod │ │ │ │ │ --r--r--r-- 1 0 0 2264 2025-02-12 10:55:47.000000 boot/grub/i386-pc/testspeed.mod │ │ │ │ │ --r--r--r-- 1 0 0 4920 2025-02-12 10:55:47.000000 boot/grub/i386-pc/tftp.mod │ │ │ │ │ --r--r--r-- 1 0 0 4588 2025-02-12 10:55:47.000000 boot/grub/i386-pc/tga.mod │ │ │ │ │ --r--r--r-- 1 0 0 1456 2025-02-12 10:55:47.000000 boot/grub/i386-pc/time.mod │ │ │ │ │ --r--r--r-- 1 0 0 2352 2025-02-12 10:55:47.000000 boot/grub/i386-pc/tr.mod │ │ │ │ │ --r--r--r-- 1 0 0 1668 2025-02-12 10:55:47.000000 boot/grub/i386-pc/trig.mod │ │ │ │ │ --r--r--r-- 1 0 0 1152 2025-02-12 10:55:47.000000 boot/grub/i386-pc/true.mod │ │ │ │ │ --r--r--r-- 1 0 0 3728 2025-02-12 10:55:47.000000 boot/grub/i386-pc/truecrypt.mod │ │ │ │ │ --r--r--r-- 1 0 0 8500 2025-02-12 10:55:47.000000 boot/grub/i386-pc/udf.mod │ │ │ │ │ --r--r--r-- 1 0 0 5332 2025-02-12 10:55:47.000000 boot/grub/i386-pc/ufs1.mod │ │ │ │ │ --r--r--r-- 1 0 0 5716 2025-02-12 10:55:47.000000 boot/grub/i386-pc/ufs1_be.mod │ │ │ │ │ --r--r--r-- 1 0 0 5396 2025-02-12 10:55:47.000000 boot/grub/i386-pc/ufs2.mod │ │ │ │ │ --r--r--r-- 1 0 0 6492 2025-02-12 10:55:47.000000 boot/grub/i386-pc/uhci.mod │ │ │ │ │ --r--r--r-- 1 0 0 10376 2025-02-12 10:55:47.000000 boot/grub/i386-pc/usb.mod │ │ │ │ │ --r--r--r-- 1 0 0 3764 2025-02-12 10:55:47.000000 boot/grub/i386-pc/usb_keyboard.mod │ │ │ │ │ --r--r--r-- 1 0 0 6912 2025-02-12 10:55:47.000000 boot/grub/i386-pc/usbms.mod │ │ │ │ │ --r--r--r-- 1 0 0 1916 2025-02-12 10:55:47.000000 boot/grub/i386-pc/usbserial_common.mod │ │ │ │ │ --r--r--r-- 1 0 0 2296 2025-02-12 10:55:47.000000 boot/grub/i386-pc/usbserial_ftdi.mod │ │ │ │ │ --r--r--r-- 1 0 0 2632 2025-02-12 10:55:47.000000 boot/grub/i386-pc/usbserial_pl2303.mod │ │ │ │ │ --r--r--r-- 1 0 0 1460 2025-02-12 10:55:47.000000 boot/grub/i386-pc/usbserial_usbdebug.mod │ │ │ │ │ --r--r--r-- 1 0 0 3568 2025-02-12 10:55:47.000000 boot/grub/i386-pc/usbtest.mod │ │ │ │ │ --r--r--r-- 1 0 0 9828 2025-02-12 10:55:47.000000 boot/grub/i386-pc/vbe.mod │ │ │ │ │ --r--r--r-- 1 0 0 2652 2025-02-12 10:55:47.000000 boot/grub/i386-pc/verifiers.mod │ │ │ │ │ --r--r--r-- 1 0 0 4932 2025-02-12 10:55:47.000000 boot/grub/i386-pc/vga.mod │ │ │ │ │ --r--r--r-- 1 0 0 2140 2025-02-12 10:55:47.000000 boot/grub/i386-pc/vga_text.mod │ │ │ │ │ --r--r--r-- 1 0 0 33 2025-02-12 10:55:47.000000 boot/grub/i386-pc/video.lst │ │ │ │ │ --r--r--r-- 1 0 0 5980 2025-02-12 10:55:47.000000 boot/grub/i386-pc/video.mod │ │ │ │ │ --r--r--r-- 1 0 0 5588 2025-02-12 10:55:47.000000 boot/grub/i386-pc/video_bochs.mod │ │ │ │ │ --r--r--r-- 1 0 0 6004 2025-02-12 10:55:47.000000 boot/grub/i386-pc/video_cirrus.mod │ │ │ │ │ --r--r--r-- 1 0 0 5568 2025-02-12 10:55:47.000000 boot/grub/i386-pc/video_colors.mod │ │ │ │ │ --r--r--r-- 1 0 0 21016 2025-02-12 10:55:47.000000 boot/grub/i386-pc/video_fb.mod │ │ │ │ │ --r--r--r-- 1 0 0 3892 2025-02-12 10:55:47.000000 boot/grub/i386-pc/videoinfo.mod │ │ │ │ │ --r--r--r-- 1 0 0 4216 2025-02-12 10:55:47.000000 boot/grub/i386-pc/videotest.mod │ │ │ │ │ --r--r--r-- 1 0 0 2284 2025-02-12 10:55:47.000000 boot/grub/i386-pc/videotest_checksum.mod │ │ │ │ │ --r--r--r-- 1 0 0 1448 2025-02-12 10:55:47.000000 boot/grub/i386-pc/wrmsr.mod │ │ │ │ │ --r--r--r-- 1 0 0 7484 2025-02-12 10:55:47.000000 boot/grub/i386-pc/xfs.mod │ │ │ │ │ --r--r--r-- 1 0 0 27468 2025-02-12 10:55:47.000000 boot/grub/i386-pc/xnu.mod │ │ │ │ │ --r--r--r-- 1 0 0 2084 2025-02-12 10:55:47.000000 boot/grub/i386-pc/xnu_uuid.mod │ │ │ │ │ --r--r--r-- 1 0 0 1924 2025-02-12 10:55:47.000000 boot/grub/i386-pc/xnu_uuid_test.mod │ │ │ │ │ --r--r--r-- 1 0 0 15456 2025-02-12 10:55:47.000000 boot/grub/i386-pc/xzio.mod │ │ │ │ │ --r--r--r-- 1 0 0 40256 2025-02-12 10:55:47.000000 boot/grub/i386-pc/zfs.mod │ │ │ │ │ --r--r--r-- 1 0 0 5488 2025-02-12 10:55:47.000000 boot/grub/i386-pc/zfscrypt.mod │ │ │ │ │ --r--r--r-- 1 0 0 6588 2025-02-12 10:55:47.000000 boot/grub/i386-pc/zfsinfo.mod │ │ │ │ │ --r--r--r-- 1 0 0 45868 2025-02-12 10:55:47.000000 boot/grub/i386-pc/zstd.mod │ │ │ │ │ +dr-xr-xr-x 3 0 0 2048 2024-01-11 05:12:18.000000 . │ │ │ │ │ +dr-xr-xr-x 3 0 0 2048 2024-01-11 05:12:18.000000 boot │ │ │ │ │ +dr-xr-xr-x 6 0 0 2048 2024-01-11 05:12:18.000000 boot/grub │ │ │ │ │ +dr-xr-xr-x 2 0 0 2048 2024-01-11 05:12:18.000000 boot/grub/fonts │ │ │ │ │ +dr-xr-xr-x 2 0 0 38912 2024-01-11 05:12:18.000000 boot/grub/i386-pc │ │ │ │ │ +dr-xr-xr-x 2 0 0 2048 2024-01-11 05:12:18.000000 boot/grub/locale │ │ │ │ │ +dr-xr-xr-x 2 0 0 2048 2024-01-11 05:12:18.000000 boot/grub/roms │ │ │ │ │ +-r--r--r-- 1 0 0 2048 2024-01-11 05:12:18.000000 boot.catalog │ │ │ │ │ +-r--r--r-- 1 0 0 2392304 2024-01-11 05:12:18.000000 boot/grub/fonts/unicode.pf2 │ │ │ │ │ +-r--r--r-- 1 0 0 1705 2024-01-11 05:12:18.000000 boot/grub/grub.cfg │ │ │ │ │ +-r--r--r-- 1 0 0 7780 2024-01-11 05:12:18.000000 boot/grub/i386-pc/915resolution.mod │ │ │ │ │ +-r--r--r-- 1 0 0 10868 2024-01-11 05:12:18.000000 boot/grub/i386-pc/acpi.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1228 2024-01-11 05:12:18.000000 boot/grub/i386-pc/adler32.mod │ │ │ │ │ +-r--r--r-- 1 0 0 5568 2024-01-11 05:12:18.000000 boot/grub/i386-pc/affs.mod │ │ │ │ │ +-r--r--r-- 1 0 0 6020 2024-01-11 05:12:18.000000 boot/grub/i386-pc/afs.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1516 2024-01-11 05:12:18.000000 boot/grub/i386-pc/afsplitter.mod │ │ │ │ │ +-r--r--r-- 1 0 0 15392 2024-01-11 05:12:18.000000 boot/grub/i386-pc/ahci.mod │ │ │ │ │ +-r--r--r-- 1 0 0 492 2024-01-11 05:12:18.000000 boot/grub/i386-pc/all_video.mod │ │ │ │ │ +-r--r--r-- 1 0 0 956 2024-01-11 05:12:18.000000 boot/grub/i386-pc/aout.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2836 2024-01-11 05:12:18.000000 boot/grub/i386-pc/archelp.mod │ │ │ │ │ +-r--r--r-- 1 0 0 4068 2024-01-11 05:12:18.000000 boot/grub/i386-pc/at_keyboard.mod │ │ │ │ │ +-r--r--r-- 1 0 0 5524 2024-01-11 05:12:18.000000 boot/grub/i386-pc/ata.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1576 2024-01-11 05:12:18.000000 boot/grub/i386-pc/backtrace.mod │ │ │ │ │ +-r--r--r-- 1 0 0 6728 2024-01-11 05:12:18.000000 boot/grub/i386-pc/bfs.mod │ │ │ │ │ +-r--r--r-- 1 0 0 4636 2024-01-11 05:12:18.000000 boot/grub/i386-pc/biosdisk.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2184 2024-01-11 05:12:18.000000 boot/grub/i386-pc/bitmap.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3616 2024-01-11 05:12:18.000000 boot/grub/i386-pc/bitmap_scale.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1984 2024-01-11 05:12:18.000000 boot/grub/i386-pc/blocklist.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2628 2024-01-11 05:12:18.000000 boot/grub/i386-pc/boot.mod │ │ │ │ │ +-r--r--r-- 1 0 0 30568 2024-01-11 05:12:18.000000 boot/grub/i386-pc/bsd.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2252 2024-01-11 05:12:18.000000 boot/grub/i386-pc/bswap_test.mod │ │ │ │ │ +-r--r--r-- 1 0 0 19712 2024-01-11 05:12:18.000000 boot/grub/i386-pc/btrfs.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2028 2024-01-11 05:12:18.000000 boot/grub/i386-pc/bufio.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2884 2024-01-11 05:12:18.000000 boot/grub/i386-pc/cat.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3892 2024-01-11 05:12:18.000000 boot/grub/i386-pc/cbfs.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3340 2024-01-11 05:12:18.000000 boot/grub/i386-pc/cbls.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2448 2024-01-11 05:12:18.000000 boot/grub/i386-pc/cbmemc.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1048 2024-01-11 05:12:18.000000 boot/grub/i386-pc/cbtable.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2772 2024-01-11 05:12:18.000000 boot/grub/i386-pc/cbtime.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3448 2024-01-11 05:12:18.000000 boot/grub/i386-pc/chain.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2960 2024-01-11 05:12:18.000000 boot/grub/i386-pc/cmdline_cat_test.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1216 2024-01-11 05:12:18.000000 boot/grub/i386-pc/cmosdump.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1808 2024-01-11 05:12:18.000000 boot/grub/i386-pc/cmostest.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2056 2024-01-11 05:12:18.000000 boot/grub/i386-pc/cmp.mod │ │ │ │ │ +-r--r--r-- 1 0 0 4608 2024-01-11 05:12:18.000000 boot/grub/i386-pc/cmp_test.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3887 2024-01-11 05:12:18.000000 boot/grub/i386-pc/command.lst │ │ │ │ │ +-r--r--r-- 1 0 0 2224 2024-01-11 05:12:18.000000 boot/grub/i386-pc/configfile.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2612 2024-01-11 05:12:18.000000 boot/grub/i386-pc/cpio.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2680 2024-01-11 05:12:18.000000 boot/grub/i386-pc/cpio_be.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1664 2024-01-11 05:12:18.000000 boot/grub/i386-pc/cpuid.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1572 2024-01-11 05:12:18.000000 boot/grub/i386-pc/crc64.mod │ │ │ │ │ +-r--r--r-- 1 0 0 936 2024-01-11 05:12:18.000000 boot/grub/i386-pc/crypto.lst │ │ │ │ │ +-r--r--r-- 1 0 0 4944 2024-01-11 05:12:18.000000 boot/grub/i386-pc/crypto.mod │ │ │ │ │ +-r--r--r-- 1 0 0 11900 2024-01-11 05:12:18.000000 boot/grub/i386-pc/cryptodisk.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3588 2024-01-11 05:12:18.000000 boot/grub/i386-pc/cs5536.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1680 2024-01-11 05:12:18.000000 boot/grub/i386-pc/ctz_test.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2148 2024-01-11 05:12:18.000000 boot/grub/i386-pc/date.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1716 2024-01-11 05:12:18.000000 boot/grub/i386-pc/datehook.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2232 2024-01-11 05:12:18.000000 boot/grub/i386-pc/datetime.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2332 2024-01-11 05:12:18.000000 boot/grub/i386-pc/disk.mod │ │ │ │ │ +-r--r--r-- 1 0 0 9836 2024-01-11 05:12:18.000000 boot/grub/i386-pc/diskfilter.mod │ │ │ │ │ +-r--r--r-- 1 0 0 956 2024-01-11 05:12:18.000000 boot/grub/i386-pc/div.mod │ │ │ │ │ +-r--r--r-- 1 0 0 5560 2024-01-11 05:12:18.000000 boot/grub/i386-pc/div_test.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1772 2024-01-11 05:12:18.000000 boot/grub/i386-pc/dm_nv.mod │ │ │ │ │ +-r--r--r-- 1 0 0 5316 2024-01-11 05:12:18.000000 boot/grub/i386-pc/drivemap.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1896 2024-01-11 05:12:18.000000 boot/grub/i386-pc/echo.mod │ │ │ │ │ +-r--r--r-- 1 0 0 23696 2024-01-11 05:12:18.000000 boot/grub/i386-pc/efiemu.mod │ │ │ │ │ +-r--r--r-- 1 0 0 7608 2024-01-11 05:12:18.000000 boot/grub/i386-pc/efiemu32.o │ │ │ │ │ +-r--r--r-- 1 0 0 10112 2024-01-11 05:12:18.000000 boot/grub/i386-pc/efiemu64.o │ │ │ │ │ +-r--r--r-- 1 0 0 16128 2024-01-11 05:12:18.000000 boot/grub/i386-pc/ehci.mod │ │ │ │ │ +-r--r--r-- 1 0 0 4064 2024-01-11 05:12:18.000000 boot/grub/i386-pc/elf.mod │ │ │ │ │ +-r--r--r-- 1 0 0 29251 2024-01-11 05:12:18.000000 boot/grub/i386-pc/eltorito.img │ │ │ │ │ +-r--r--r-- 1 0 0 1368 2024-01-11 05:12:18.000000 boot/grub/i386-pc/eval.mod │ │ │ │ │ +-r--r--r-- 1 0 0 6080 2024-01-11 05:12:18.000000 boot/grub/i386-pc/exfat.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1380 2024-01-11 05:12:18.000000 boot/grub/i386-pc/exfctest.mod │ │ │ │ │ +-r--r--r-- 1 0 0 6172 2024-01-11 05:12:18.000000 boot/grub/i386-pc/ext2.mod │ │ │ │ │ +-r--r--r-- 1 0 0 4640 2024-01-11 05:12:18.000000 boot/grub/i386-pc/extcmd.mod │ │ │ │ │ +-r--r--r-- 1 0 0 6460 2024-01-11 05:12:18.000000 boot/grub/i386-pc/f2fs.mod │ │ │ │ │ +-r--r--r-- 1 0 0 6192 2024-01-11 05:12:18.000000 boot/grub/i386-pc/fat.mod │ │ │ │ │ +-r--r--r-- 1 0 0 16932 2024-01-11 05:12:18.000000 boot/grub/i386-pc/file.mod │ │ │ │ │ +-r--r--r-- 1 0 0 13520 2024-01-11 05:12:18.000000 boot/grub/i386-pc/font.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2612 2024-01-11 05:12:18.000000 boot/grub/i386-pc/freedos.mod │ │ │ │ │ +-r--r--r-- 1 0 0 219 2024-01-11 05:12:18.000000 boot/grub/i386-pc/fs.lst │ │ │ │ │ +-r--r--r-- 1 0 0 2920 2024-01-11 05:12:18.000000 boot/grub/i386-pc/fshelp.mod │ │ │ │ │ +-r--r--r-- 1 0 0 34168 2024-01-11 05:12:18.000000 boot/grub/i386-pc/functional_test.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1612 2024-01-11 05:12:18.000000 boot/grub/i386-pc/gcry_arcfour.mod │ │ │ │ │ +-r--r--r-- 1 0 0 8000 2024-01-11 05:12:18.000000 boot/grub/i386-pc/gcry_blowfish.mod │ │ │ │ │ +-r--r--r-- 1 0 0 33516 2024-01-11 05:12:18.000000 boot/grub/i386-pc/gcry_camellia.mod │ │ │ │ │ +-r--r--r-- 1 0 0 16356 2024-01-11 05:12:18.000000 boot/grub/i386-pc/gcry_cast5.mod │ │ │ │ │ +-r--r--r-- 1 0 0 10564 2024-01-11 05:12:18.000000 boot/grub/i386-pc/gcry_crc.mod │ │ │ │ │ +-r--r--r-- 1 0 0 19104 2024-01-11 05:12:18.000000 boot/grub/i386-pc/gcry_des.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2188 2024-01-11 05:12:18.000000 boot/grub/i386-pc/gcry_dsa.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2884 2024-01-11 05:12:18.000000 boot/grub/i386-pc/gcry_idea.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3048 2024-01-11 05:12:18.000000 boot/grub/i386-pc/gcry_md4.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3668 2024-01-11 05:12:18.000000 boot/grub/i386-pc/gcry_md5.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2316 2024-01-11 05:12:18.000000 boot/grub/i386-pc/gcry_rfc2268.mod │ │ │ │ │ +-r--r--r-- 1 0 0 19312 2024-01-11 05:12:18.000000 boot/grub/i386-pc/gcry_rijndael.mod │ │ │ │ │ +-r--r--r-- 1 0 0 8248 2024-01-11 05:12:18.000000 boot/grub/i386-pc/gcry_rmd160.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1968 2024-01-11 05:12:18.000000 boot/grub/i386-pc/gcry_rsa.mod │ │ │ │ │ +-r--r--r-- 1 0 0 14824 2024-01-11 05:12:18.000000 boot/grub/i386-pc/gcry_seed.mod │ │ │ │ │ +-r--r--r-- 1 0 0 17700 2024-01-11 05:12:18.000000 boot/grub/i386-pc/gcry_serpent.mod │ │ │ │ │ +-r--r--r-- 1 0 0 8592 2024-01-11 05:12:18.000000 boot/grub/i386-pc/gcry_sha1.mod │ │ │ │ │ +-r--r--r-- 1 0 0 4376 2024-01-11 05:12:18.000000 boot/grub/i386-pc/gcry_sha256.mod │ │ │ │ │ +-r--r--r-- 1 0 0 8804 2024-01-11 05:12:18.000000 boot/grub/i386-pc/gcry_sha512.mod │ │ │ │ │ +-r--r--r-- 1 0 0 12244 2024-01-11 05:12:18.000000 boot/grub/i386-pc/gcry_tiger.mod │ │ │ │ │ +-r--r--r-- 1 0 0 36816 2024-01-11 05:12:18.000000 boot/grub/i386-pc/gcry_twofish.mod │ │ │ │ │ +-r--r--r-- 1 0 0 24588 2024-01-11 05:12:18.000000 boot/grub/i386-pc/gcry_whirlpool.mod │ │ │ │ │ +-r--r--r-- 1 0 0 25036 2024-01-11 05:12:18.000000 boot/grub/i386-pc/gdb.mod │ │ │ │ │ +-r--r--r-- 1 0 0 5884 2024-01-11 05:12:18.000000 boot/grub/i386-pc/geli.mod │ │ │ │ │ +-r--r--r-- 1 0 0 4860 2024-01-11 05:12:18.000000 boot/grub/i386-pc/gettext.mod │ │ │ │ │ +-r--r--r-- 1 0 0 39136 2024-01-11 05:12:18.000000 boot/grub/i386-pc/gfxmenu.mod │ │ │ │ │ +-r--r--r-- 1 0 0 9892 2024-01-11 05:12:18.000000 boot/grub/i386-pc/gfxterm.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2796 2024-01-11 05:12:18.000000 boot/grub/i386-pc/gfxterm_background.mod │ │ │ │ │ +-r--r--r-- 1 0 0 4912 2024-01-11 05:12:18.000000 boot/grub/i386-pc/gfxterm_menu.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3740 2024-01-11 05:12:18.000000 boot/grub/i386-pc/gptsync.mod │ │ │ │ │ +-r--r--r-- 1 0 0 8784 2024-01-11 05:12:18.000000 boot/grub/i386-pc/gzio.mod │ │ │ │ │ +-r--r--r-- 1 0 0 4684 2024-01-11 05:12:18.000000 boot/grub/i386-pc/halt.mod │ │ │ │ │ +-r--r--r-- 1 0 0 5168 2024-01-11 05:12:18.000000 boot/grub/i386-pc/hashsum.mod │ │ │ │ │ +-r--r--r-- 1 0 0 6560 2024-01-11 05:12:18.000000 boot/grub/i386-pc/hdparm.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1140 2024-01-11 05:12:18.000000 boot/grub/i386-pc/hello.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2512 2024-01-11 05:12:18.000000 boot/grub/i386-pc/help.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3216 2024-01-11 05:12:18.000000 boot/grub/i386-pc/hexdump.mod │ │ │ │ │ +-r--r--r-- 1 0 0 7004 2024-01-11 05:12:18.000000 boot/grub/i386-pc/hfs.mod │ │ │ │ │ +-r--r--r-- 1 0 0 7848 2024-01-11 05:12:18.000000 boot/grub/i386-pc/hfsplus.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2960 2024-01-11 05:12:18.000000 boot/grub/i386-pc/hfspluscomp.mod │ │ │ │ │ +-r--r--r-- 1 0 0 5700 2024-01-11 05:12:18.000000 boot/grub/i386-pc/http.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2468 2024-01-11 05:12:18.000000 boot/grub/i386-pc/hwmatch.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2800 2024-01-11 05:12:18.000000 boot/grub/i386-pc/iorw.mod │ │ │ │ │ +-r--r--r-- 1 0 0 8488 2024-01-11 05:12:18.000000 boot/grub/i386-pc/iso9660.mod │ │ │ │ │ +-r--r--r-- 1 0 0 6092 2024-01-11 05:12:18.000000 boot/grub/i386-pc/jfs.mod │ │ │ │ │ +-r--r--r-- 1 0 0 7660 2024-01-11 05:12:18.000000 boot/grub/i386-pc/jpeg.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3504 2024-01-11 05:12:18.000000 boot/grub/i386-pc/json.mod │ │ │ │ │ +-r--r--r-- 1 0 0 5032 2024-01-11 05:12:18.000000 boot/grub/i386-pc/keylayouts.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1904 2024-01-11 05:12:18.000000 boot/grub/i386-pc/keystatus.mod │ │ │ │ │ +-r--r--r-- 1 0 0 6300 2024-01-11 05:12:18.000000 boot/grub/i386-pc/ldm.mod │ │ │ │ │ +-r--r--r-- 1 0 0 14404 2024-01-11 05:12:18.000000 boot/grub/i386-pc/legacy_password_test.mod │ │ │ │ │ +-r--r--r-- 1 0 0 30132 2024-01-11 05:12:18.000000 boot/grub/i386-pc/legacycfg.mod │ │ │ │ │ +-r--r--r-- 1 0 0 13172 2024-01-11 05:12:18.000000 boot/grub/i386-pc/linux.mod │ │ │ │ │ +-r--r--r-- 1 0 0 5524 2024-01-11 05:12:18.000000 boot/grub/i386-pc/linux16.mod │ │ │ │ │ +-r--r--r-- 1 0 0 5748 2024-01-11 05:12:18.000000 boot/grub/i386-pc/loadenv.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3004 2024-01-11 05:12:18.000000 boot/grub/i386-pc/loopback.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3856 2024-01-11 05:12:18.000000 boot/grub/i386-pc/ls.mod │ │ │ │ │ +-r--r--r-- 1 0 0 4740 2024-01-11 05:12:18.000000 boot/grub/i386-pc/lsacpi.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2236 2024-01-11 05:12:18.000000 boot/grub/i386-pc/lsapm.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1820 2024-01-11 05:12:18.000000 boot/grub/i386-pc/lsmmap.mod │ │ │ │ │ +-r--r--r-- 1 0 0 4828 2024-01-11 05:12:18.000000 boot/grub/i386-pc/lspci.mod │ │ │ │ │ +-r--r--r-- 1 0 0 4356 2024-01-11 05:12:18.000000 boot/grub/i386-pc/luks.mod │ │ │ │ │ +-r--r--r-- 1 0 0 14216 2024-01-11 05:12:18.000000 boot/grub/i386-pc/luks2.mod │ │ │ │ │ +-r--r--r-- 1 0 0 8472 2024-01-11 05:12:18.000000 boot/grub/i386-pc/lvm.mod │ │ │ │ │ +-r--r--r-- 1 0 0 4756 2024-01-11 05:12:18.000000 boot/grub/i386-pc/lzopio.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3200 2024-01-11 05:12:18.000000 boot/grub/i386-pc/macbless.mod │ │ │ │ │ +-r--r--r-- 1 0 0 7500 2024-01-11 05:12:18.000000 boot/grub/i386-pc/macho.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2044 2024-01-11 05:12:18.000000 boot/grub/i386-pc/mda_text.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2112 2024-01-11 05:12:18.000000 boot/grub/i386-pc/mdraid09.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1968 2024-01-11 05:12:18.000000 boot/grub/i386-pc/mdraid09_be.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1852 2024-01-11 05:12:18.000000 boot/grub/i386-pc/mdraid1x.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1988 2024-01-11 05:12:18.000000 boot/grub/i386-pc/memdisk.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2824 2024-01-11 05:12:18.000000 boot/grub/i386-pc/memrw.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3504 2024-01-11 05:12:18.000000 boot/grub/i386-pc/minicmd.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3596 2024-01-11 05:12:18.000000 boot/grub/i386-pc/minix.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3692 2024-01-11 05:12:18.000000 boot/grub/i386-pc/minix2.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3856 2024-01-11 05:12:18.000000 boot/grub/i386-pc/minix2_be.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3692 2024-01-11 05:12:18.000000 boot/grub/i386-pc/minix3.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3856 2024-01-11 05:12:18.000000 boot/grub/i386-pc/minix3_be.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3724 2024-01-11 05:12:18.000000 boot/grub/i386-pc/minix_be.mod │ │ │ │ │ +-r--r--r-- 1 0 0 8544 2024-01-11 05:12:18.000000 boot/grub/i386-pc/mmap.mod │ │ │ │ │ +-r--r--r-- 1 0 0 5709 2024-01-11 05:12:18.000000 boot/grub/i386-pc/moddep.lst │ │ │ │ │ +-r--r--r-- 1 0 0 2565 2024-01-11 05:12:18.000000 boot/grub/i386-pc/modinfo.sh │ │ │ │ │ +-r--r--r-- 1 0 0 2348 2024-01-11 05:12:18.000000 boot/grub/i386-pc/morse.mod │ │ │ │ │ +-r--r--r-- 1 0 0 27896 2024-01-11 05:12:18.000000 boot/grub/i386-pc/mpi.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2396 2024-01-11 05:12:18.000000 boot/grub/i386-pc/msdospart.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2016 2024-01-11 05:12:18.000000 boot/grub/i386-pc/mul_test.mod │ │ │ │ │ +-r--r--r-- 1 0 0 13920 2024-01-11 05:12:18.000000 boot/grub/i386-pc/multiboot.mod │ │ │ │ │ +-r--r--r-- 1 0 0 15068 2024-01-11 05:12:18.000000 boot/grub/i386-pc/multiboot2.mod │ │ │ │ │ +-r--r--r-- 1 0 0 4156 2024-01-11 05:12:18.000000 boot/grub/i386-pc/nativedisk.mod │ │ │ │ │ +-r--r--r-- 1 0 0 57256 2024-01-11 05:12:18.000000 boot/grub/i386-pc/net.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2836 2024-01-11 05:12:18.000000 boot/grub/i386-pc/newc.mod │ │ │ │ │ +-r--r--r-- 1 0 0 6744 2024-01-11 05:12:18.000000 boot/grub/i386-pc/nilfs2.mod │ │ │ │ │ +-r--r--r-- 1 0 0 114896 2024-01-11 05:12:18.000000 boot/grub/i386-pc/normal.mod │ │ │ │ │ +-r--r--r-- 1 0 0 10652 2024-01-11 05:12:18.000000 boot/grub/i386-pc/ntfs.mod │ │ │ │ │ +-r--r--r-- 1 0 0 4260 2024-01-11 05:12:18.000000 boot/grub/i386-pc/ntfscomp.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2504 2024-01-11 05:12:18.000000 boot/grub/i386-pc/ntldr.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2676 2024-01-11 05:12:18.000000 boot/grub/i386-pc/odc.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1456 2024-01-11 05:12:18.000000 boot/grub/i386-pc/offsetio.mod │ │ │ │ │ +-r--r--r-- 1 0 0 10420 2024-01-11 05:12:18.000000 boot/grub/i386-pc/ohci.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1584 2024-01-11 05:12:18.000000 boot/grub/i386-pc/part_acorn.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1812 2024-01-11 05:12:18.000000 boot/grub/i386-pc/part_amiga.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2052 2024-01-11 05:12:18.000000 boot/grub/i386-pc/part_apple.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2680 2024-01-11 05:12:18.000000 boot/grub/i386-pc/part_bsd.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1708 2024-01-11 05:12:18.000000 boot/grub/i386-pc/part_dfly.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1424 2024-01-11 05:12:18.000000 boot/grub/i386-pc/part_dvh.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2292 2024-01-11 05:12:18.000000 boot/grub/i386-pc/part_gpt.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2280 2024-01-11 05:12:18.000000 boot/grub/i386-pc/part_msdos.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1732 2024-01-11 05:12:18.000000 boot/grub/i386-pc/part_plan.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1452 2024-01-11 05:12:18.000000 boot/grub/i386-pc/part_sun.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1580 2024-01-11 05:12:18.000000 boot/grub/i386-pc/part_sunpc.mod │ │ │ │ │ +-r--r--r-- 1 0 0 111 2024-01-11 05:12:18.000000 boot/grub/i386-pc/partmap.lst │ │ │ │ │ +-r--r--r-- 1 0 0 17 2024-01-11 05:12:18.000000 boot/grub/i386-pc/parttool.lst │ │ │ │ │ +-r--r--r-- 1 0 0 4644 2024-01-11 05:12:18.000000 boot/grub/i386-pc/parttool.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1820 2024-01-11 05:12:18.000000 boot/grub/i386-pc/password.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2712 2024-01-11 05:12:18.000000 boot/grub/i386-pc/password_pbkdf2.mod │ │ │ │ │ +-r--r--r-- 1 0 0 4812 2024-01-11 05:12:18.000000 boot/grub/i386-pc/pata.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1312 2024-01-11 05:12:18.000000 boot/grub/i386-pc/pbkdf2.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2100 2024-01-11 05:12:18.000000 boot/grub/i386-pc/pbkdf2_test.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1316 2024-01-11 05:12:18.000000 boot/grub/i386-pc/pci.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2416 2024-01-11 05:12:18.000000 boot/grub/i386-pc/pcidump.mod │ │ │ │ │ +-r--r--r-- 1 0 0 11376 2024-01-11 05:12:18.000000 boot/grub/i386-pc/pgp.mod │ │ │ │ │ +-r--r--r-- 1 0 0 6292 2024-01-11 05:12:18.000000 boot/grub/i386-pc/plan9.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2452 2024-01-11 05:12:18.000000 boot/grub/i386-pc/play.mod │ │ │ │ │ +-r--r--r-- 1 0 0 8052 2024-01-11 05:12:18.000000 boot/grub/i386-pc/png.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1516 2024-01-11 05:12:18.000000 boot/grub/i386-pc/priority_queue.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3456 2024-01-11 05:12:18.000000 boot/grub/i386-pc/probe.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2284 2024-01-11 05:12:18.000000 boot/grub/i386-pc/procfs.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2136 2024-01-11 05:12:18.000000 boot/grub/i386-pc/progress.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3680 2024-01-11 05:12:18.000000 boot/grub/i386-pc/pxe.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2616 2024-01-11 05:12:18.000000 boot/grub/i386-pc/pxechain.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1292 2024-01-11 05:12:18.000000 boot/grub/i386-pc/raid5rec.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2204 2024-01-11 05:12:18.000000 boot/grub/i386-pc/raid6rec.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2784 2024-01-11 05:12:18.000000 boot/grub/i386-pc/random.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1848 2024-01-11 05:12:18.000000 boot/grub/i386-pc/rdmsr.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1404 2024-01-11 05:12:18.000000 boot/grub/i386-pc/read.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1636 2024-01-11 05:12:18.000000 boot/grub/i386-pc/reboot.mod │ │ │ │ │ +-r--r--r-- 1 0 0 51032 2024-01-11 05:12:18.000000 boot/grub/i386-pc/regexp.mod │ │ │ │ │ +-r--r--r-- 1 0 0 8788 2024-01-11 05:12:18.000000 boot/grub/i386-pc/reiserfs.mod │ │ │ │ │ +-r--r--r-- 1 0 0 14952 2024-01-11 05:12:18.000000 boot/grub/i386-pc/relocator.mod │ │ │ │ │ +-r--r--r-- 1 0 0 4052 2024-01-11 05:12:18.000000 boot/grub/i386-pc/romfs.mod │ │ │ │ │ +-r--r--r-- 1 0 0 4644 2024-01-11 05:12:18.000000 boot/grub/i386-pc/scsi.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3624 2024-01-11 05:12:18.000000 boot/grub/i386-pc/search.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3052 2024-01-11 05:12:18.000000 boot/grub/i386-pc/search_fs_file.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3156 2024-01-11 05:12:18.000000 boot/grub/i386-pc/search_fs_uuid.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3072 2024-01-11 05:12:18.000000 boot/grub/i386-pc/search_label.mod │ │ │ │ │ +-r--r--r-- 1 0 0 7068 2024-01-11 05:12:18.000000 boot/grub/i386-pc/sendkey.mod │ │ │ │ │ +-r--r--r-- 1 0 0 7696 2024-01-11 05:12:18.000000 boot/grub/i386-pc/serial.mod │ │ │ │ │ +-r--r--r-- 1 0 0 628 2024-01-11 05:12:18.000000 boot/grub/i386-pc/setjmp.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1624 2024-01-11 05:12:18.000000 boot/grub/i386-pc/setjmp_test.mod │ │ │ │ │ +-r--r--r-- 1 0 0 5224 2024-01-11 05:12:18.000000 boot/grub/i386-pc/setpci.mod │ │ │ │ │ +-r--r--r-- 1 0 0 5116 2024-01-11 05:12:18.000000 boot/grub/i386-pc/sfs.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2396 2024-01-11 05:12:18.000000 boot/grub/i386-pc/shift_test.mod │ │ │ │ │ +-r--r--r-- 1 0 0 6380 2024-01-11 05:12:18.000000 boot/grub/i386-pc/signature_test.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2144 2024-01-11 05:12:18.000000 boot/grub/i386-pc/sleep.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2260 2024-01-11 05:12:18.000000 boot/grub/i386-pc/sleep_test.mod │ │ │ │ │ +-r--r--r-- 1 0 0 5564 2024-01-11 05:12:18.000000 boot/grub/i386-pc/smbios.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2024 2024-01-11 05:12:18.000000 boot/grub/i386-pc/spkmodem.mod │ │ │ │ │ +-r--r--r-- 1 0 0 7132 2024-01-11 05:12:18.000000 boot/grub/i386-pc/squash4.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2112 2024-01-11 05:12:18.000000 boot/grub/i386-pc/strtoull_test.mod │ │ │ │ │ +-r--r--r-- 1 0 0 17420 2024-01-11 05:12:18.000000 boot/grub/i386-pc/syslinuxcfg.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3216 2024-01-11 05:12:18.000000 boot/grub/i386-pc/tar.mod │ │ │ │ │ +-r--r--r-- 1 0 0 202 2024-01-11 05:12:18.000000 boot/grub/i386-pc/terminal.lst │ │ │ │ │ +-r--r--r-- 1 0 0 4448 2024-01-11 05:12:18.000000 boot/grub/i386-pc/terminal.mod │ │ │ │ │ +-r--r--r-- 1 0 0 12356 2024-01-11 05:12:18.000000 boot/grub/i386-pc/terminfo.mod │ │ │ │ │ +-r--r--r-- 1 0 0 5000 2024-01-11 05:12:18.000000 boot/grub/i386-pc/test.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1272 2024-01-11 05:12:18.000000 boot/grub/i386-pc/test_blockarg.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2736 2024-01-11 05:12:18.000000 boot/grub/i386-pc/testload.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2264 2024-01-11 05:12:18.000000 boot/grub/i386-pc/testspeed.mod │ │ │ │ │ +-r--r--r-- 1 0 0 4920 2024-01-11 05:12:18.000000 boot/grub/i386-pc/tftp.mod │ │ │ │ │ +-r--r--r-- 1 0 0 4588 2024-01-11 05:12:18.000000 boot/grub/i386-pc/tga.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1456 2024-01-11 05:12:18.000000 boot/grub/i386-pc/time.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2352 2024-01-11 05:12:18.000000 boot/grub/i386-pc/tr.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1668 2024-01-11 05:12:18.000000 boot/grub/i386-pc/trig.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1152 2024-01-11 05:12:18.000000 boot/grub/i386-pc/true.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3728 2024-01-11 05:12:18.000000 boot/grub/i386-pc/truecrypt.mod │ │ │ │ │ +-r--r--r-- 1 0 0 8500 2024-01-11 05:12:18.000000 boot/grub/i386-pc/udf.mod │ │ │ │ │ +-r--r--r-- 1 0 0 5332 2024-01-11 05:12:18.000000 boot/grub/i386-pc/ufs1.mod │ │ │ │ │ +-r--r--r-- 1 0 0 5716 2024-01-11 05:12:18.000000 boot/grub/i386-pc/ufs1_be.mod │ │ │ │ │ +-r--r--r-- 1 0 0 5396 2024-01-11 05:12:18.000000 boot/grub/i386-pc/ufs2.mod │ │ │ │ │ +-r--r--r-- 1 0 0 6492 2024-01-11 05:12:18.000000 boot/grub/i386-pc/uhci.mod │ │ │ │ │ +-r--r--r-- 1 0 0 10376 2024-01-11 05:12:18.000000 boot/grub/i386-pc/usb.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3764 2024-01-11 05:12:18.000000 boot/grub/i386-pc/usb_keyboard.mod │ │ │ │ │ +-r--r--r-- 1 0 0 6912 2024-01-11 05:12:18.000000 boot/grub/i386-pc/usbms.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1916 2024-01-11 05:12:18.000000 boot/grub/i386-pc/usbserial_common.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2296 2024-01-11 05:12:18.000000 boot/grub/i386-pc/usbserial_ftdi.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2632 2024-01-11 05:12:18.000000 boot/grub/i386-pc/usbserial_pl2303.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1460 2024-01-11 05:12:18.000000 boot/grub/i386-pc/usbserial_usbdebug.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3568 2024-01-11 05:12:18.000000 boot/grub/i386-pc/usbtest.mod │ │ │ │ │ +-r--r--r-- 1 0 0 9828 2024-01-11 05:12:18.000000 boot/grub/i386-pc/vbe.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2652 2024-01-11 05:12:18.000000 boot/grub/i386-pc/verifiers.mod │ │ │ │ │ +-r--r--r-- 1 0 0 4932 2024-01-11 05:12:18.000000 boot/grub/i386-pc/vga.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2140 2024-01-11 05:12:18.000000 boot/grub/i386-pc/vga_text.mod │ │ │ │ │ +-r--r--r-- 1 0 0 33 2024-01-11 05:12:18.000000 boot/grub/i386-pc/video.lst │ │ │ │ │ +-r--r--r-- 1 0 0 5980 2024-01-11 05:12:18.000000 boot/grub/i386-pc/video.mod │ │ │ │ │ +-r--r--r-- 1 0 0 5588 2024-01-11 05:12:18.000000 boot/grub/i386-pc/video_bochs.mod │ │ │ │ │ +-r--r--r-- 1 0 0 6004 2024-01-11 05:12:18.000000 boot/grub/i386-pc/video_cirrus.mod │ │ │ │ │ +-r--r--r-- 1 0 0 5568 2024-01-11 05:12:18.000000 boot/grub/i386-pc/video_colors.mod │ │ │ │ │ +-r--r--r-- 1 0 0 21016 2024-01-11 05:12:18.000000 boot/grub/i386-pc/video_fb.mod │ │ │ │ │ +-r--r--r-- 1 0 0 3892 2024-01-11 05:12:18.000000 boot/grub/i386-pc/videoinfo.mod │ │ │ │ │ +-r--r--r-- 1 0 0 4216 2024-01-11 05:12:18.000000 boot/grub/i386-pc/videotest.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2284 2024-01-11 05:12:18.000000 boot/grub/i386-pc/videotest_checksum.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1448 2024-01-11 05:12:18.000000 boot/grub/i386-pc/wrmsr.mod │ │ │ │ │ +-r--r--r-- 1 0 0 7484 2024-01-11 05:12:18.000000 boot/grub/i386-pc/xfs.mod │ │ │ │ │ +-r--r--r-- 1 0 0 27468 2024-01-11 05:12:18.000000 boot/grub/i386-pc/xnu.mod │ │ │ │ │ +-r--r--r-- 1 0 0 2084 2024-01-11 05:12:18.000000 boot/grub/i386-pc/xnu_uuid.mod │ │ │ │ │ +-r--r--r-- 1 0 0 1924 2024-01-11 05:12:18.000000 boot/grub/i386-pc/xnu_uuid_test.mod │ │ │ │ │ +-r--r--r-- 1 0 0 15456 2024-01-11 05:12:18.000000 boot/grub/i386-pc/xzio.mod │ │ │ │ │ +-r--r--r-- 1 0 0 40256 2024-01-11 05:12:18.000000 boot/grub/i386-pc/zfs.mod │ │ │ │ │ +-r--r--r-- 1 0 0 5488 2024-01-11 05:12:18.000000 boot/grub/i386-pc/zfscrypt.mod │ │ │ │ │ +-r--r--r-- 1 0 0 6588 2024-01-11 05:12:18.000000 boot/grub/i386-pc/zfsinfo.mod │ │ │ │ │ +-r--r--r-- 1 0 0 45868 2024-01-11 05:12:18.000000 boot/grub/i386-pc/zstd.mod │ │ │ │ ├── boot/grub/i386-pc/modinfo.sh │ │ │ │ │ @@ -1,8 +1,8 @@ │ │ │ │ │ -#!/bin/bash │ │ │ │ │ +#!/bin/sh │ │ │ │ │ │ │ │ │ │ # User-controllable options │ │ │ │ │ grub_modinfo_target_cpu=i386 │ │ │ │ │ grub_modinfo_platform=pc │ │ │ │ │ grub_disk_cache_stats=0 │ │ │ │ │ grub_boot_time_stats=0 │ │ │ │ │ grub_have_font_source=1 │ │ │ ├── ./usr/lib/grub-rescue/grub-rescue-floppy.img │ │ │ │ ├── isoinfo -l -i {} │ │ │ │ │ @@ -1,323 +1,323 @@ │ │ │ │ │ │ │ │ │ │ Directory listing of / │ │ │ │ │ -d--------- 0 0 0 2048 Feb 12 2025 [ 19 02] . │ │ │ │ │ -d--------- 0 0 0 2048 Feb 12 2025 [ 19 02] .. │ │ │ │ │ -d--------- 0 0 0 2048 Feb 12 2025 [ 21 02] boot │ │ │ │ │ ----------- 0 0 0 2048 Feb 12 2025 [ 48 00] boot.cat;1 │ │ │ │ │ +d--------- 0 0 0 2048 Jan 11 2024 [ 19 02] . │ │ │ │ │ +d--------- 0 0 0 2048 Jan 11 2024 [ 19 02] .. │ │ │ │ │ +d--------- 0 0 0 2048 Jan 11 2024 [ 21 02] boot │ │ │ │ │ +---------- 0 0 0 2048 Jan 11 2024 [ 48 00] boot.cat;1 │ │ │ │ │ │ │ │ │ │ Directory listing of /boot/ │ │ │ │ │ -d--------- 0 0 0 2048 Feb 12 2025 [ 21 02] . │ │ │ │ │ -d--------- 0 0 0 2048 Feb 12 2025 [ 19 02] .. │ │ │ │ │ -d--------- 0 0 0 2048 Feb 12 2025 [ 22 02] grub │ │ │ │ │ +d--------- 0 0 0 2048 Jan 11 2024 [ 21 02] . │ │ │ │ │ +d--------- 0 0 0 2048 Jan 11 2024 [ 19 02] .. │ │ │ │ │ +d--------- 0 0 0 2048 Jan 11 2024 [ 22 02] grub │ │ │ │ │ │ │ │ │ │ Directory listing of /boot/grub/ │ │ │ │ │ -d--------- 0 0 0 2048 Feb 12 2025 [ 22 02] . │ │ │ │ │ -d--------- 0 0 0 2048 Feb 12 2025 [ 21 02] .. │ │ │ │ │ -d--------- 0 0 0 2048 Feb 12 2025 [ 23 02] fonts │ │ │ │ │ ----------- 0 0 0 1705 Feb 12 2025 [ 49 00] grub.cfg;1 │ │ │ │ │ -d--------- 0 0 0 38912 Feb 12 2025 [ 24 02] i386-pc │ │ │ │ │ -d--------- 0 0 0 2048 Feb 12 2025 [ 43 02] locale │ │ │ │ │ -d--------- 0 0 0 2048 Feb 12 2025 [ 44 02] roms │ │ │ │ │ +d--------- 0 0 0 2048 Jan 11 2024 [ 22 02] . │ │ │ │ │ +d--------- 0 0 0 2048 Jan 11 2024 [ 21 02] .. │ │ │ │ │ +d--------- 0 0 0 2048 Jan 11 2024 [ 23 02] fonts │ │ │ │ │ +---------- 0 0 0 1705 Jan 11 2024 [ 49 00] grub.cfg;1 │ │ │ │ │ +d--------- 0 0 0 38912 Jan 11 2024 [ 24 02] i386-pc │ │ │ │ │ +d--------- 0 0 0 2048 Jan 11 2024 [ 43 02] locale │ │ │ │ │ +d--------- 0 0 0 2048 Jan 11 2024 [ 44 02] roms │ │ │ │ │ │ │ │ │ │ Directory listing of /boot/grub/fonts/ │ │ │ │ │ -d--------- 0 0 0 2048 Feb 12 2025 [ 23 02] . │ │ │ │ │ -d--------- 0 0 0 2048 Feb 12 2025 [ 22 02] .. │ │ │ │ │ +d--------- 0 0 0 2048 Jan 11 2024 [ 23 02] . │ │ │ │ │ +d--------- 0 0 0 2048 Jan 11 2024 [ 22 02] .. │ │ │ │ │ │ │ │ │ │ Directory listing of /boot/grub/i386-pc/ │ │ │ │ │ -d--------- 0 0 0 38912 Feb 12 2025 [ 24 02] . │ │ │ │ │ -d--------- 0 0 0 2048 Feb 12 2025 [ 22 02] .. │ │ │ │ │ ----------- 0 0 0 3520 Feb 12 2025 [ 50 00] 915resol.mod;1 │ │ │ │ │ ----------- 0 0 0 4404 Feb 12 2025 [ 52 00] acpi.mod;1 │ │ │ │ │ ----------- 0 0 0 548 Feb 12 2025 [ 55 00] adler32.mod;1 │ │ │ │ │ ----------- 0 0 0 2636 Feb 12 2025 [ 56 00] affs.mod;1 │ │ │ │ │ ----------- 0 0 0 3176 Feb 12 2025 [ 58 00] afs.mod;1 │ │ │ │ │ ----------- 0 0 0 832 Feb 12 2025 [ 60 00] afsplitt.mod;1 │ │ │ │ │ ----------- 0 0 0 4920 Feb 12 2025 [ 61 00] ahci.mod;1 │ │ │ │ │ ----------- 0 0 0 236 Feb 12 2025 [ 64 00] all_vide.mod;1 │ │ │ │ │ ----------- 0 0 0 496 Feb 12 2025 [ 65 00] aout.mod;1 │ │ │ │ │ ----------- 0 0 0 1540 Feb 12 2025 [ 66 00] archelp.mod;1 │ │ │ │ │ ----------- 0 0 0 2004 Feb 12 2025 [ 67 00] at_keybo.mod;1 │ │ │ │ │ ----------- 0 0 0 2672 Feb 12 2025 [ 68 00] ata.mod;1 │ │ │ │ │ ----------- 0 0 0 748 Feb 12 2025 [ 70 00] backtrac.mod;1 │ │ │ │ │ ----------- 0 0 0 3580 Feb 12 2025 [ 71 00] bfs.mod;1 │ │ │ │ │ ----------- 0 0 0 2496 Feb 12 2025 [ 73 00] biosdisk.mod;1 │ │ │ │ │ ----------- 0 0 0 1128 Feb 12 2025 [ 75 00] bitmap.mod;1 │ │ │ │ │ ----------- 0 0 0 2020 Feb 12 2025 [ 76 00] bitmap_s.mod;1 │ │ │ │ │ ----------- 0 0 0 1068 Feb 12 2025 [ 77 00] blocklis.mod;1 │ │ │ │ │ ----------- 0 0 0 1180 Feb 12 2025 [ 78 00] boot.mod;1 │ │ │ │ │ ----------- 0 0 0 12244 Feb 12 2025 [ 79 00] bsd.mod;1 │ │ │ │ │ ----------- 0 0 0 1020 Feb 12 2025 [ 85 00] bswap_te.mod;1 │ │ │ │ │ ----------- 0 0 0 9152 Feb 12 2025 [ 86 00] btrfs.mod;1 │ │ │ │ │ ----------- 0 0 0 1040 Feb 12 2025 [ 91 00] bufio.mod;1 │ │ │ │ │ ----------- 0 0 0 1348 Feb 12 2025 [ 92 00] cat.mod;1 │ │ │ │ │ ----------- 0 0 0 1860 Feb 12 2025 [ 93 00] cbfs.mod;1 │ │ │ │ │ ----------- 0 0 0 1180 Feb 12 2025 [ 94 00] cbls.mod;1 │ │ │ │ │ ----------- 0 0 0 976 Feb 12 2025 [ 95 00] cbmemc.mod;1 │ │ │ │ │ ----------- 0 0 0 536 Feb 12 2025 [ 96 00] cbtable.mod;1 │ │ │ │ │ ----------- 0 0 0 1112 Feb 12 2025 [ 97 00] cbtime.mod;1 │ │ │ │ │ ----------- 0 0 0 1596 Feb 12 2025 [ 98 00] chain.mod;1 │ │ │ │ │ ----------- 0 0 0 1160 Feb 12 2025 [ 99 00] cmdline_.mod;1 │ │ │ │ │ ----------- 0 0 0 580 Feb 12 2025 [ 100 00] cmosdump.mod;1 │ │ │ │ │ ----------- 0 0 0 812 Feb 12 2025 [ 101 00] cmostest.mod;1 │ │ │ │ │ ----------- 0 0 0 968 Feb 12 2025 [ 102 00] cmp.mod;1 │ │ │ │ │ ----------- 0 0 0 1780 Feb 12 2025 [ 103 00] cmp_test.mod;1 │ │ │ │ │ ----------- 0 0 0 1456 Feb 12 2025 [ 104 00] command.lst;1 │ │ │ │ │ ----------- 0 0 0 840 Feb 12 2025 [ 105 00] configfi.mod;1 │ │ │ │ │ ----------- 0 0 0 1272 Feb 12 2025 [ 106 00] cpio.mod;1 │ │ │ │ │ ----------- 0 0 0 1300 Feb 12 2025 [ 107 00] cpio_be.mod;1 │ │ │ │ │ ----------- 0 0 0 728 Feb 12 2025 [ 108 00] cpuid.mod;1 │ │ │ │ │ ----------- 0 0 0 800 Feb 12 2025 [ 109 00] crc64.mod;1 │ │ │ │ │ ----------- 0 0 0 416 Feb 12 2025 [ 110 00] crypto.lst;1 │ │ │ │ │ ----------- 0 0 0 2344 Feb 12 2025 [ 111 00] crypto.mod;1 │ │ │ │ │ ----------- 0 0 0 5476 Feb 12 2025 [ 113 00] cryptodi.mod;1 │ │ │ │ │ ----------- 0 0 0 1480 Feb 12 2025 [ 116 00] cs5536.mod;1 │ │ │ │ │ ----------- 0 0 0 816 Feb 12 2025 [ 117 00] ctz_test.mod;1 │ │ │ │ │ ----------- 0 0 0 1040 Feb 12 2025 [ 118 00] date.mod;1 │ │ │ │ │ ----------- 0 0 0 700 Feb 12 2025 [ 119 00] datehook.mod;1 │ │ │ │ │ ----------- 0 0 0 1252 Feb 12 2025 [ 120 00] datetime.mod;1 │ │ │ │ │ ----------- 0 0 0 1300 Feb 12 2025 [ 121 00] disk.mod;1 │ │ │ │ │ ----------- 0 0 0 5340 Feb 12 2025 [ 122 00] diskfilt.mod;1 │ │ │ │ │ ----------- 0 0 0 508 Feb 12 2025 [ 125 00] div.mod;1 │ │ │ │ │ ----------- 0 0 0 2216 Feb 12 2025 [ 126 00] div_test.mod;1 │ │ │ │ │ ----------- 0 0 0 852 Feb 12 2025 [ 128 00] dm_nv.mod;1 │ │ │ │ │ ----------- 0 0 0 2396 Feb 12 2025 [ 129 00] drivemap.mod;1 │ │ │ │ │ ----------- 0 0 0 888 Feb 12 2025 [ 131 00] echo.mod;1 │ │ │ │ │ ----------- 0 0 0 9464 Feb 12 2025 [ 132 00] efiemu.mod;1 │ │ │ │ │ ----------- 0 0 0 3184 Feb 12 2025 [ 137 00] efiemu32.o;1 │ │ │ │ │ ----------- 0 0 0 3424 Feb 12 2025 [ 139 00] efiemu64.o;1 │ │ │ │ │ ----------- 0 0 0 6044 Feb 12 2025 [ 141 00] ehci.mod;1 │ │ │ │ │ ----------- 0 0 0 1888 Feb 12 2025 [ 144 00] elf.mod;1 │ │ │ │ │ ----------- 0 0 0 46703 Feb 12 2025 [ 145 00] eltorito.img;1 │ │ │ │ │ ----------- 0 0 0 652 Feb 12 2025 [ 168 00] eval.mod;1 │ │ │ │ │ ----------- 0 0 0 3428 Feb 12 2025 [ 169 00] exfat.mod;1 │ │ │ │ │ ----------- 0 0 0 556 Feb 12 2025 [ 171 00] exfctest.mod;1 │ │ │ │ │ ----------- 0 0 0 3196 Feb 12 2025 [ 172 00] ext2.mod;1 │ │ │ │ │ ----------- 0 0 0 2440 Feb 12 2025 [ 174 00] extcmd.mod;1 │ │ │ │ │ ----------- 0 0 0 3380 Feb 12 2025 [ 176 00] f2fs.mod;1 │ │ │ │ │ ----------- 0 0 0 3648 Feb 12 2025 [ 178 00] fat.mod;1 │ │ │ │ │ ----------- 0 0 0 5704 Feb 12 2025 [ 180 00] file.mod;1 │ │ │ │ │ ----------- 0 0 0 6508 Feb 12 2025 [ 183 00] font.mod;1 │ │ │ │ │ ----------- 0 0 0 1160 Feb 12 2025 [ 187 00] freedos.mod;1 │ │ │ │ │ ----------- 0 0 0 204 Feb 12 2025 [ 188 00] fs.lst;1 │ │ │ │ │ ----------- 0 0 0 1756 Feb 12 2025 [ 189 00] fshelp.mod;1 │ │ │ │ │ ----------- 0 0 0 8464 Feb 12 2025 [ 190 00] function.mod;1 │ │ │ │ │ ----------- 0 0 0 780 Feb 12 2025 [ 195 00] gcry_arc.mod;1 │ │ │ │ │ ----------- 0 0 0 5500 Feb 12 2025 [ 196 00] gcry_blo.mod;1 │ │ │ │ │ ----------- 0 0 0 8424 Feb 12 2025 [ 199 00] gcry_cam.mod;1 │ │ │ │ │ ----------- 0 0 0 10640 Feb 12 2025 [ 204 00] gcry_cas.mod;1 │ │ │ │ │ ----------- 0 0 0 8624 Feb 12 2025 [ 210 00] gcry_crc.mod;1 │ │ │ │ │ ----------- 0 0 0 4064 Feb 12 2025 [ 215 00] gcry_des.mod;1 │ │ │ │ │ ----------- 0 0 0 936 Feb 12 2025 [ 217 00] gcry_dsa.mod;1 │ │ │ │ │ ----------- 0 0 0 1512 Feb 12 2025 [ 218 00] gcry_ide.mod;1 │ │ │ │ │ ----------- 0 0 0 1448 Feb 12 2025 [ 219 00] gcry_md4.mod;1 │ │ │ │ │ ----------- 0 0 0 1832 Feb 12 2025 [ 220 00] gcry_md5.mod;1 │ │ │ │ │ ----------- 0 0 0 1344 Feb 12 2025 [ 221 00] gcry_rfc.mod;1 │ │ │ │ │ ----------- 0 0 0 7616 Feb 12 2025 [ 222 00] gcry_rij.mod;1 │ │ │ │ │ ----------- 0 0 0 2736 Feb 12 2025 [ 226 00] gcry_rmd.mod;1 │ │ │ │ │ ----------- 0 0 0 880 Feb 12 2025 [ 228 00] gcry_rsa.mod;1 │ │ │ │ │ ----------- 0 0 0 4472 Feb 12 2025 [ 229 00] gcry_see.mod;1 │ │ │ │ │ ----------- 0 0 0 5604 Feb 12 2025 [ 232 00] gcry_ser.mod;1 │ │ │ │ │ ----------- 0 0 0 3176 Feb 12 2025 [ 235 00] gcry_sh0.mod;1 │ │ │ │ │ ----------- 0 0 0 2088 Feb 12 2025 [ 237 00] gcry_sh1.mod;1 │ │ │ │ │ ----------- 0 0 0 3264 Feb 12 2025 [ 239 00] gcry_sh2.mod;1 │ │ │ │ │ ----------- 0 0 0 10260 Feb 12 2025 [ 241 00] gcry_tig.mod;1 │ │ │ │ │ ----------- 0 0 0 9828 Feb 12 2025 [ 247 00] gcry_two.mod;1 │ │ │ │ │ ----------- 0 0 0 6100 Feb 12 2025 [ 252 00] gcry_whi.mod;1 │ │ │ │ │ ----------- 0 0 0 3752 Feb 12 2025 [ 255 00] gdb.mod;1 │ │ │ │ │ ----------- 0 0 0 2656 Feb 12 2025 [ 257 00] geli.mod;1 │ │ │ │ │ ----------- 0 0 0 2128 Feb 12 2025 [ 259 00] gettext.mod;1 │ │ │ │ │ ----------- 0 0 0 15640 Feb 12 2025 [ 261 00] gfxmenu.mod;1 │ │ │ │ │ ----------- 0 0 0 3884 Feb 12 2025 [ 269 00] gfxterm.mod;1 │ │ │ │ │ ----------- 0 0 0 1128 Feb 12 2025 [ 271 00] gfxterm0.mod;1 │ │ │ │ │ ----------- 0 0 0 1848 Feb 12 2025 [ 272 00] gfxterm1.mod;1 │ │ │ │ │ ----------- 0 0 0 1800 Feb 12 2025 [ 273 00] gptsync.mod;1 │ │ │ │ │ ----------- 0 0 0 4524 Feb 12 2025 [ 274 00] gzio.mod;1 │ │ │ │ │ ----------- 0 0 0 2196 Feb 12 2025 [ 277 00] halt.mod;1 │ │ │ │ │ ----------- 0 0 0 2124 Feb 12 2025 [ 279 00] hashsum.mod;1 │ │ │ │ │ ----------- 0 0 0 2916 Feb 12 2025 [ 281 00] hdparm.mod;1 │ │ │ │ │ ----------- 0 0 0 492 Feb 12 2025 [ 283 00] hello.mod;1 │ │ │ │ │ ----------- 0 0 0 1216 Feb 12 2025 [ 284 00] help.mod;1 │ │ │ │ │ ----------- 0 0 0 1508 Feb 12 2025 [ 285 00] hexdump.mod;1 │ │ │ │ │ ----------- 0 0 0 3788 Feb 12 2025 [ 286 00] hfs.mod;1 │ │ │ │ │ ----------- 0 0 0 4016 Feb 12 2025 [ 288 00] hfsplus.mod;1 │ │ │ │ │ ----------- 0 0 0 1536 Feb 12 2025 [ 290 00] hfsplusc.mod;1 │ │ │ │ │ ----------- 0 0 0 2656 Feb 12 2025 [ 291 00] http.mod;1 │ │ │ │ │ ----------- 0 0 0 1164 Feb 12 2025 [ 293 00] hwmatch.mod;1 │ │ │ │ │ ----------- 0 0 0 1152 Feb 12 2025 [ 294 00] iorw.mod;1 │ │ │ │ │ ----------- 0 0 0 4324 Feb 12 2025 [ 295 00] iso9660.mod;1 │ │ │ │ │ ----------- 0 0 0 3332 Feb 12 2025 [ 298 00] jfs.mod;1 │ │ │ │ │ ----------- 0 0 0 3940 Feb 12 2025 [ 300 00] jpeg.mod;1 │ │ │ │ │ ----------- 0 0 0 2028 Feb 12 2025 [ 302 00] json.mod;1 │ │ │ │ │ ----------- 0 0 0 1416 Feb 12 2025 [ 303 00] keylayou.mod;1 │ │ │ │ │ ----------- 0 0 0 780 Feb 12 2025 [ 304 00] keystatu.mod;1 │ │ │ │ │ ----------- 0 0 0 2872 Feb 12 2025 [ 305 00] ldm.mod;1 │ │ │ │ │ ----------- 0 0 0 908 Feb 12 2025 [ 307 00] legacy_p.mod;1 │ │ │ │ │ ----------- 0 0 0 11076 Feb 12 2025 [ 308 00] legacycf.mod;1 │ │ │ │ │ ----------- 0 0 0 6008 Feb 12 2025 [ 314 00] linux.mod;1 │ │ │ │ │ ----------- 0 0 0 2612 Feb 12 2025 [ 317 00] linux16.mod;1 │ │ │ │ │ ----------- 0 0 0 2804 Feb 12 2025 [ 319 00] loadenv.mod;1 │ │ │ │ │ ----------- 0 0 0 1324 Feb 12 2025 [ 321 00] loopback.mod;1 │ │ │ │ │ ----------- 0 0 0 1660 Feb 12 2025 [ 322 00] ls.mod;1 │ │ │ │ │ ----------- 0 0 0 2068 Feb 12 2025 [ 323 00] lsacpi.mod;1 │ │ │ │ │ ----------- 0 0 0 980 Feb 12 2025 [ 325 00] lsapm.mod;1 │ │ │ │ │ ----------- 0 0 0 804 Feb 12 2025 [ 326 00] lsmmap.mod;1 │ │ │ │ │ ----------- 0 0 0 1816 Feb 12 2025 [ 327 00] lspci.mod;1 │ │ │ │ │ ----------- 0 0 0 1984 Feb 12 2025 [ 328 00] luks.mod;1 │ │ │ │ │ ----------- 0 0 0 5868 Feb 12 2025 [ 329 00] luks2.mod;1 │ │ │ │ │ ----------- 0 0 0 3896 Feb 12 2025 [ 332 00] lvm.mod;1 │ │ │ │ │ ----------- 0 0 0 2608 Feb 12 2025 [ 334 00] lzopio.mod;1 │ │ │ │ │ ----------- 0 0 0 1576 Feb 12 2025 [ 336 00] macbless.mod;1 │ │ │ │ │ ----------- 0 0 0 3268 Feb 12 2025 [ 337 00] macho.mod;1 │ │ │ │ │ ----------- 0 0 0 964 Feb 12 2025 [ 339 00] mda_text.mod;1 │ │ │ │ │ ----------- 0 0 0 940 Feb 12 2025 [ 340 00] mdraid00.mod;1 │ │ │ │ │ ----------- 0 0 0 972 Feb 12 2025 [ 341 00] mdraid01.mod;1 │ │ │ │ │ ----------- 0 0 0 896 Feb 12 2025 [ 342 00] mdraid1x.mod;1 │ │ │ │ │ ----------- 0 0 0 888 Feb 12 2025 [ 343 00] memdisk.mod;1 │ │ │ │ │ ----------- 0 0 0 1152 Feb 12 2025 [ 344 00] memrw.mod;1 │ │ │ │ │ ----------- 0 0 0 1544 Feb 12 2025 [ 345 00] minicmd.mod;1 │ │ │ │ │ ----------- 0 0 0 2008 Feb 12 2025 [ 346 00] minix.mod;1 │ │ │ │ │ ----------- 0 0 0 2064 Feb 12 2025 [ 347 00] minix2.mod;1 │ │ │ │ │ ----------- 0 0 0 2132 Feb 12 2025 [ 349 00] minix2_b.mod;1 │ │ │ │ │ ----------- 0 0 0 2032 Feb 12 2025 [ 351 00] minix3.mod;1 │ │ │ │ │ ----------- 0 0 0 2132 Feb 12 2025 [ 352 00] minix3_b.mod;1 │ │ │ │ │ ----------- 0 0 0 2072 Feb 12 2025 [ 354 00] minix_be.mod;1 │ │ │ │ │ ----------- 0 0 0 4176 Feb 12 2025 [ 356 00] mmap.mod;1 │ │ │ │ │ ----------- 0 0 0 2116 Feb 12 2025 [ 359 00] moddep.lst;1 │ │ │ │ │ ----------- 0 0 0 1264 Feb 12 2025 [ 361 00] modinfo.sh;1 │ │ │ │ │ ----------- 0 0 0 708 Feb 12 2025 [ 362 00] morse.mod;1 │ │ │ │ │ ----------- 0 0 0 12848 Feb 12 2025 [ 363 00] mpi.mod;1 │ │ │ │ │ ----------- 0 0 0 1072 Feb 12 2025 [ 370 00] msdospar.mod;1 │ │ │ │ │ ----------- 0 0 0 960 Feb 12 2025 [ 371 00] mul_test.mod;1 │ │ │ │ │ ----------- 0 0 0 6184 Feb 12 2025 [ 372 00] multibo0.mod;1 │ │ │ │ │ ----------- 0 0 0 6628 Feb 12 2025 [ 376 00] multibo1.mod;1 │ │ │ │ │ ----------- 0 0 0 1908 Feb 12 2025 [ 380 00] nativedi.mod;1 │ │ │ │ │ ----------- 0 0 0 24724 Feb 12 2025 [ 381 00] net.mod;1 │ │ │ │ │ ----------- 0 0 0 1396 Feb 12 2025 [ 394 00] newc.mod;1 │ │ │ │ │ ----------- 0 0 0 3356 Feb 12 2025 [ 395 00] nilfs2.mod;1 │ │ │ │ │ ----------- 0 0 0 44536 Feb 12 2025 [ 397 00] normal.mod;1 │ │ │ │ │ ----------- 0 0 0 5748 Feb 12 2025 [ 419 00] ntfs.mod;1 │ │ │ │ │ ----------- 0 0 0 2448 Feb 12 2025 [ 422 00] ntfscomp.mod;1 │ │ │ │ │ ----------- 0 0 0 1076 Feb 12 2025 [ 424 00] ntldr.mod;1 │ │ │ │ │ ----------- 0 0 0 1300 Feb 12 2025 [ 425 00] odc.mod;1 │ │ │ │ │ ----------- 0 0 0 684 Feb 12 2025 [ 426 00] offsetio.mod;1 │ │ │ │ │ ----------- 0 0 0 4456 Feb 12 2025 [ 427 00] ohci.mod;1 │ │ │ │ │ ----------- 0 0 0 816 Feb 12 2025 [ 430 00] part_aco.mod;1 │ │ │ │ │ ----------- 0 0 0 896 Feb 12 2025 [ 431 00] part_ami.mod;1 │ │ │ │ │ ----------- 0 0 0 976 Feb 12 2025 [ 432 00] part_app.mod;1 │ │ │ │ │ ----------- 0 0 0 1272 Feb 12 2025 [ 433 00] part_bsd.mod;1 │ │ │ │ │ ----------- 0 0 0 856 Feb 12 2025 [ 434 00] part_dfl.mod;1 │ │ │ │ │ ----------- 0 0 0 704 Feb 12 2025 [ 435 00] part_dvh.mod;1 │ │ │ │ │ ----------- 0 0 0 1100 Feb 12 2025 [ 436 00] part_gpt.mod;1 │ │ │ │ │ ----------- 0 0 0 1200 Feb 12 2025 [ 437 00] part_msd.mod;1 │ │ │ │ │ ----------- 0 0 0 828 Feb 12 2025 [ 438 00] part_pla.mod;1 │ │ │ │ │ ----------- 0 0 0 732 Feb 12 2025 [ 439 00] part_su0.mod;1 │ │ │ │ │ ----------- 0 0 0 768 Feb 12 2025 [ 440 00] part_su1.mod;1 │ │ │ │ │ ----------- 0 0 0 116 Feb 12 2025 [ 441 00] partmap.lst;1 │ │ │ │ │ ----------- 0 0 0 68 Feb 12 2025 [ 442 00] parttool.lst;1 │ │ │ │ │ ----------- 0 0 0 2052 Feb 12 2025 [ 443 00] parttool.mod;1 │ │ │ │ │ ----------- 0 0 0 832 Feb 12 2025 [ 445 00] passwor0.mod;1 │ │ │ │ │ ----------- 0 0 0 1288 Feb 12 2025 [ 446 00] passwor1.mod;1 │ │ │ │ │ ----------- 0 0 0 2344 Feb 12 2025 [ 447 00] pata.mod;1 │ │ │ │ │ ----------- 0 0 0 684 Feb 12 2025 [ 449 00] pbkdf2.mod;1 │ │ │ │ │ ----------- 0 0 0 928 Feb 12 2025 [ 450 00] pbkdf2_t.mod;1 │ │ │ │ │ ----------- 0 0 0 720 Feb 12 2025 [ 451 00] pci.mod;1 │ │ │ │ │ ----------- 0 0 0 1116 Feb 12 2025 [ 452 00] pcidump.mod;1 │ │ │ │ │ ----------- 0 0 0 4776 Feb 12 2025 [ 453 00] pgp.mod;1 │ │ │ │ │ ----------- 0 0 0 3036 Feb 12 2025 [ 456 00] plan9.mod;1 │ │ │ │ │ ----------- 0 0 0 1212 Feb 12 2025 [ 458 00] play.mod;1 │ │ │ │ │ ----------- 0 0 0 4132 Feb 12 2025 [ 459 00] png.mod;1 │ │ │ │ │ ----------- 0 0 0 800 Feb 12 2025 [ 462 00] priority.mod;1 │ │ │ │ │ ----------- 0 0 0 1472 Feb 12 2025 [ 463 00] probe.mod;1 │ │ │ │ │ ----------- 0 0 0 956 Feb 12 2025 [ 464 00] procfs.mod;1 │ │ │ │ │ ----------- 0 0 0 1096 Feb 12 2025 [ 465 00] progress.mod;1 │ │ │ │ │ ----------- 0 0 0 1548 Feb 12 2025 [ 466 00] pxe.mod;1 │ │ │ │ │ ----------- 0 0 0 1136 Feb 12 2025 [ 467 00] pxechain.mod;1 │ │ │ │ │ ----------- 0 0 0 696 Feb 12 2025 [ 468 00] raid5rec.mod;1 │ │ │ │ │ ----------- 0 0 0 1236 Feb 12 2025 [ 469 00] raid6rec.mod;1 │ │ │ │ │ ----------- 0 0 0 1368 Feb 12 2025 [ 470 00] random.mod;1 │ │ │ │ │ ----------- 0 0 0 856 Feb 12 2025 [ 471 00] rdmsr.mod;1 │ │ │ │ │ ----------- 0 0 0 660 Feb 12 2025 [ 472 00] read.mod;1 │ │ │ │ │ ----------- 0 0 0 736 Feb 12 2025 [ 473 00] reboot.mod;1 │ │ │ │ │ ----------- 0 0 0 26876 Feb 12 2025 [ 474 00] regexp.mod;1 │ │ │ │ │ ----------- 0 0 0 4316 Feb 12 2025 [ 488 00] reiserfs.mod;1 │ │ │ │ │ ----------- 0 0 0 6656 Feb 12 2025 [ 491 00] relocato.mod;1 │ │ │ │ │ ----------- 0 0 0 2152 Feb 12 2025 [ 495 00] romfs.mod;1 │ │ │ │ │ ----------- 0 0 0 2304 Feb 12 2025 [ 497 00] scsi.mod;1 │ │ │ │ │ ----------- 0 0 0 1384 Feb 12 2025 [ 499 00] search.mod;1 │ │ │ │ │ ----------- 0 0 0 1448 Feb 12 2025 [ 500 00] search_0.mod;1 │ │ │ │ │ ----------- 0 0 0 1564 Feb 12 2025 [ 501 00] search_1.mod;1 │ │ │ │ │ ----------- 0 0 0 1484 Feb 12 2025 [ 502 00] search_l.mod;1 │ │ │ │ │ ----------- 0 0 0 2540 Feb 12 2025 [ 503 00] sendkey.mod;1 │ │ │ │ │ ----------- 0 0 0 3176 Feb 12 2025 [ 505 00] serial.mod;1 │ │ │ │ │ ----------- 0 0 0 300 Feb 12 2025 [ 507 00] setjmp.mod;1 │ │ │ │ │ ----------- 0 0 0 676 Feb 12 2025 [ 508 00] setjmp_t.mod;1 │ │ │ │ │ ----------- 0 0 0 2148 Feb 12 2025 [ 509 00] setpci.mod;1 │ │ │ │ │ ----------- 0 0 0 2596 Feb 12 2025 [ 511 00] sfs.mod;1 │ │ │ │ │ ----------- 0 0 0 1124 Feb 12 2025 [ 513 00] shift_te.mod;1 │ │ │ │ │ ----------- 0 0 0 4268 Feb 12 2025 [ 514 00] signatur.mod;1 │ │ │ │ │ ----------- 0 0 0 912 Feb 12 2025 [ 517 00] sleep.mod;1 │ │ │ │ │ ----------- 0 0 0 1104 Feb 12 2025 [ 518 00] sleep_te.mod;1 │ │ │ │ │ ----------- 0 0 0 2332 Feb 12 2025 [ 519 00] smbios.mod;1 │ │ │ │ │ ----------- 0 0 0 804 Feb 12 2025 [ 521 00] spkmodem.mod;1 │ │ │ │ │ ----------- 0 0 0 3808 Feb 12 2025 [ 522 00] squash4.mod;1 │ │ │ │ │ ----------- 0 0 0 916 Feb 12 2025 [ 524 00] strtoull.mod;1 │ │ │ │ │ ----------- 0 0 0 7216 Feb 12 2025 [ 525 00] syslinux.mod;1 │ │ │ │ │ ----------- 0 0 0 1552 Feb 12 2025 [ 529 00] tar.mod;1 │ │ │ │ │ ----------- 0 0 0 164 Feb 12 2025 [ 530 00] terminal.lst;1 │ │ │ │ │ ----------- 0 0 0 1792 Feb 12 2025 [ 531 00] terminal.mod;1 │ │ │ │ │ ----------- 0 0 0 5080 Feb 12 2025 [ 532 00] terminfo.mod;1 │ │ │ │ │ ----------- 0 0 0 2192 Feb 12 2025 [ 535 00] test.mod;1 │ │ │ │ │ ----------- 0 0 0 576 Feb 12 2025 [ 537 00] test_blo.mod;1 │ │ │ │ │ ----------- 0 0 0 1240 Feb 12 2025 [ 538 00] testload.mod;1 │ │ │ │ │ ----------- 0 0 0 1024 Feb 12 2025 [ 539 00] testspee.mod;1 │ │ │ │ │ ----------- 0 0 0 2176 Feb 12 2025 [ 540 00] tftp.mod;1 │ │ │ │ │ ----------- 0 0 0 1796 Feb 12 2025 [ 542 00] tga.mod;1 │ │ │ │ │ ----------- 0 0 0 684 Feb 12 2025 [ 543 00] time.mod;1 │ │ │ │ │ ----------- 0 0 0 1076 Feb 12 2025 [ 544 00] tr.mod;1 │ │ │ │ │ ----------- 0 0 0 788 Feb 12 2025 [ 545 00] trig.mod;1 │ │ │ │ │ ----------- 0 0 0 500 Feb 12 2025 [ 546 00] true.mod;1 │ │ │ │ │ ----------- 0 0 0 1588 Feb 12 2025 [ 547 00] truecryp.mod;1 │ │ │ │ │ ----------- 0 0 0 4372 Feb 12 2025 [ 548 00] udf.mod;1 │ │ │ │ │ ----------- 0 0 0 2648 Feb 12 2025 [ 551 00] ufs1.mod;1 │ │ │ │ │ ----------- 0 0 0 2848 Feb 12 2025 [ 553 00] ufs1_be.mod;1 │ │ │ │ │ ----------- 0 0 0 2732 Feb 12 2025 [ 555 00] ufs2.mod;1 │ │ │ │ │ ----------- 0 0 0 2976 Feb 12 2025 [ 557 00] uhci.mod;1 │ │ │ │ │ ----------- 0 0 0 5168 Feb 12 2025 [ 559 00] usb.mod;1 │ │ │ │ │ ----------- 0 0 0 1796 Feb 12 2025 [ 562 00] usb_keyb.mod;1 │ │ │ │ │ ----------- 0 0 0 2820 Feb 12 2025 [ 563 00] usbms.mod;1 │ │ │ │ │ ----------- 0 0 0 952 Feb 12 2025 [ 565 00] usbseri0.mod;1 │ │ │ │ │ ----------- 0 0 0 1004 Feb 12 2025 [ 566 00] usbseri1.mod;1 │ │ │ │ │ ----------- 0 0 0 1056 Feb 12 2025 [ 567 00] usbseri2.mod;1 │ │ │ │ │ ----------- 0 0 0 612 Feb 12 2025 [ 568 00] usbseri3.mod;1 │ │ │ │ │ ----------- 0 0 0 1760 Feb 12 2025 [ 569 00] usbtest.mod;1 │ │ │ │ │ ----------- 0 0 0 4160 Feb 12 2025 [ 570 00] vbe.mod;1 │ │ │ │ │ ----------- 0 0 0 1300 Feb 12 2025 [ 573 00] verifier.mod;1 │ │ │ │ │ ----------- 0 0 0 1884 Feb 12 2025 [ 574 00] vga.mod;1 │ │ │ │ │ ----------- 0 0 0 1004 Feb 12 2025 [ 575 00] vga_text.mod;1 │ │ │ │ │ ----------- 0 0 0 84 Feb 12 2025 [ 576 00] video.lst;1 │ │ │ │ │ ----------- 0 0 0 2300 Feb 12 2025 [ 577 00] video.mod;1 │ │ │ │ │ ----------- 0 0 0 2128 Feb 12 2025 [ 579 00] video_bo.mod;1 │ │ │ │ │ ----------- 0 0 0 2348 Feb 12 2025 [ 581 00] video_ci.mod;1 │ │ │ │ │ ----------- 0 0 0 2232 Feb 12 2025 [ 583 00] video_co.mod;1 │ │ │ │ │ ----------- 0 0 0 9408 Feb 12 2025 [ 585 00] video_fb.mod;1 │ │ │ │ │ ----------- 0 0 0 1656 Feb 12 2025 [ 590 00] videoinf.mod;1 │ │ │ │ │ ----------- 0 0 0 1648 Feb 12 2025 [ 591 00] videote0.mod;1 │ │ │ │ │ ----------- 0 0 0 892 Feb 12 2025 [ 592 00] videote1.mod;1 │ │ │ │ │ ----------- 0 0 0 724 Feb 12 2025 [ 593 00] wrmsr.mod;1 │ │ │ │ │ ----------- 0 0 0 3708 Feb 12 2025 [ 594 00] xfs.mod;1 │ │ │ │ │ ----------- 0 0 0 11368 Feb 12 2025 [ 596 00] xnu.mod;1 │ │ │ │ │ ----------- 0 0 0 972 Feb 12 2025 [ 602 00] xnu_uui0.mod;1 │ │ │ │ │ ----------- 0 0 0 808 Feb 12 2025 [ 603 00] xnu_uui1.mod;1 │ │ │ │ │ ----------- 0 0 0 8032 Feb 12 2025 [ 604 00] xzio.mod;1 │ │ │ │ │ ----------- 0 0 0 19000 Feb 12 2025 [ 608 00] zfs.mod;1 │ │ │ │ │ ----------- 0 0 0 2700 Feb 12 2025 [ 618 00] zfscrypt.mod;1 │ │ │ │ │ ----------- 0 0 0 2548 Feb 12 2025 [ 620 00] zfsinfo.mod;1 │ │ │ │ │ ----------- 0 0 0 19332 Feb 12 2025 [ 622 00] zstd.mod;1 │ │ │ │ │ +d--------- 0 0 0 38912 Jan 11 2024 [ 24 02] . │ │ │ │ │ +d--------- 0 0 0 2048 Jan 11 2024 [ 22 02] .. │ │ │ │ │ +---------- 0 0 0 3520 Jan 11 2024 [ 50 00] 915resol.mod;1 │ │ │ │ │ +---------- 0 0 0 4404 Jan 11 2024 [ 52 00] acpi.mod;1 │ │ │ │ │ +---------- 0 0 0 548 Jan 11 2024 [ 55 00] adler32.mod;1 │ │ │ │ │ +---------- 0 0 0 2636 Jan 11 2024 [ 56 00] affs.mod;1 │ │ │ │ │ +---------- 0 0 0 3176 Jan 11 2024 [ 58 00] afs.mod;1 │ │ │ │ │ +---------- 0 0 0 832 Jan 11 2024 [ 60 00] afsplitt.mod;1 │ │ │ │ │ +---------- 0 0 0 4920 Jan 11 2024 [ 61 00] ahci.mod;1 │ │ │ │ │ +---------- 0 0 0 236 Jan 11 2024 [ 64 00] all_vide.mod;1 │ │ │ │ │ +---------- 0 0 0 496 Jan 11 2024 [ 65 00] aout.mod;1 │ │ │ │ │ +---------- 0 0 0 1540 Jan 11 2024 [ 66 00] archelp.mod;1 │ │ │ │ │ +---------- 0 0 0 2004 Jan 11 2024 [ 67 00] at_keybo.mod;1 │ │ │ │ │ +---------- 0 0 0 2672 Jan 11 2024 [ 68 00] ata.mod;1 │ │ │ │ │ +---------- 0 0 0 748 Jan 11 2024 [ 70 00] backtrac.mod;1 │ │ │ │ │ +---------- 0 0 0 3580 Jan 11 2024 [ 71 00] bfs.mod;1 │ │ │ │ │ +---------- 0 0 0 2496 Jan 11 2024 [ 73 00] biosdisk.mod;1 │ │ │ │ │ +---------- 0 0 0 1128 Jan 11 2024 [ 75 00] bitmap.mod;1 │ │ │ │ │ +---------- 0 0 0 2020 Jan 11 2024 [ 76 00] bitmap_s.mod;1 │ │ │ │ │ +---------- 0 0 0 1068 Jan 11 2024 [ 77 00] blocklis.mod;1 │ │ │ │ │ +---------- 0 0 0 1180 Jan 11 2024 [ 78 00] boot.mod;1 │ │ │ │ │ +---------- 0 0 0 12244 Jan 11 2024 [ 79 00] bsd.mod;1 │ │ │ │ │ +---------- 0 0 0 1020 Jan 11 2024 [ 85 00] bswap_te.mod;1 │ │ │ │ │ +---------- 0 0 0 9152 Jan 11 2024 [ 86 00] btrfs.mod;1 │ │ │ │ │ +---------- 0 0 0 1040 Jan 11 2024 [ 91 00] bufio.mod;1 │ │ │ │ │ +---------- 0 0 0 1348 Jan 11 2024 [ 92 00] cat.mod;1 │ │ │ │ │ +---------- 0 0 0 1860 Jan 11 2024 [ 93 00] cbfs.mod;1 │ │ │ │ │ +---------- 0 0 0 1180 Jan 11 2024 [ 94 00] cbls.mod;1 │ │ │ │ │ +---------- 0 0 0 976 Jan 11 2024 [ 95 00] cbmemc.mod;1 │ │ │ │ │ +---------- 0 0 0 536 Jan 11 2024 [ 96 00] cbtable.mod;1 │ │ │ │ │ +---------- 0 0 0 1112 Jan 11 2024 [ 97 00] cbtime.mod;1 │ │ │ │ │ +---------- 0 0 0 1596 Jan 11 2024 [ 98 00] chain.mod;1 │ │ │ │ │ +---------- 0 0 0 1160 Jan 11 2024 [ 99 00] cmdline_.mod;1 │ │ │ │ │ +---------- 0 0 0 580 Jan 11 2024 [ 100 00] cmosdump.mod;1 │ │ │ │ │ +---------- 0 0 0 812 Jan 11 2024 [ 101 00] cmostest.mod;1 │ │ │ │ │ +---------- 0 0 0 968 Jan 11 2024 [ 102 00] cmp.mod;1 │ │ │ │ │ +---------- 0 0 0 1780 Jan 11 2024 [ 103 00] cmp_test.mod;1 │ │ │ │ │ +---------- 0 0 0 1456 Jan 11 2024 [ 104 00] command.lst;1 │ │ │ │ │ +---------- 0 0 0 840 Jan 11 2024 [ 105 00] configfi.mod;1 │ │ │ │ │ +---------- 0 0 0 1272 Jan 11 2024 [ 106 00] cpio.mod;1 │ │ │ │ │ +---------- 0 0 0 1300 Jan 11 2024 [ 107 00] cpio_be.mod;1 │ │ │ │ │ +---------- 0 0 0 728 Jan 11 2024 [ 108 00] cpuid.mod;1 │ │ │ │ │ +---------- 0 0 0 800 Jan 11 2024 [ 109 00] crc64.mod;1 │ │ │ │ │ +---------- 0 0 0 416 Jan 11 2024 [ 110 00] crypto.lst;1 │ │ │ │ │ +---------- 0 0 0 2344 Jan 11 2024 [ 111 00] crypto.mod;1 │ │ │ │ │ +---------- 0 0 0 5476 Jan 11 2024 [ 113 00] cryptodi.mod;1 │ │ │ │ │ +---------- 0 0 0 1480 Jan 11 2024 [ 116 00] cs5536.mod;1 │ │ │ │ │ +---------- 0 0 0 816 Jan 11 2024 [ 117 00] ctz_test.mod;1 │ │ │ │ │ +---------- 0 0 0 1040 Jan 11 2024 [ 118 00] date.mod;1 │ │ │ │ │ +---------- 0 0 0 700 Jan 11 2024 [ 119 00] datehook.mod;1 │ │ │ │ │ +---------- 0 0 0 1252 Jan 11 2024 [ 120 00] datetime.mod;1 │ │ │ │ │ +---------- 0 0 0 1300 Jan 11 2024 [ 121 00] disk.mod;1 │ │ │ │ │ +---------- 0 0 0 5340 Jan 11 2024 [ 122 00] diskfilt.mod;1 │ │ │ │ │ +---------- 0 0 0 508 Jan 11 2024 [ 125 00] div.mod;1 │ │ │ │ │ +---------- 0 0 0 2216 Jan 11 2024 [ 126 00] div_test.mod;1 │ │ │ │ │ +---------- 0 0 0 852 Jan 11 2024 [ 128 00] dm_nv.mod;1 │ │ │ │ │ +---------- 0 0 0 2396 Jan 11 2024 [ 129 00] drivemap.mod;1 │ │ │ │ │ +---------- 0 0 0 888 Jan 11 2024 [ 131 00] echo.mod;1 │ │ │ │ │ +---------- 0 0 0 9464 Jan 11 2024 [ 132 00] efiemu.mod;1 │ │ │ │ │ +---------- 0 0 0 3184 Jan 11 2024 [ 137 00] efiemu32.o;1 │ │ │ │ │ +---------- 0 0 0 3424 Jan 11 2024 [ 139 00] efiemu64.o;1 │ │ │ │ │ +---------- 0 0 0 6044 Jan 11 2024 [ 141 00] ehci.mod;1 │ │ │ │ │ +---------- 0 0 0 1888 Jan 11 2024 [ 144 00] elf.mod;1 │ │ │ │ │ +---------- 0 0 0 46703 Jan 11 2024 [ 145 00] eltorito.img;1 │ │ │ │ │ +---------- 0 0 0 652 Jan 11 2024 [ 168 00] eval.mod;1 │ │ │ │ │ +---------- 0 0 0 3428 Jan 11 2024 [ 169 00] exfat.mod;1 │ │ │ │ │ +---------- 0 0 0 556 Jan 11 2024 [ 171 00] exfctest.mod;1 │ │ │ │ │ +---------- 0 0 0 3196 Jan 11 2024 [ 172 00] ext2.mod;1 │ │ │ │ │ +---------- 0 0 0 2440 Jan 11 2024 [ 174 00] extcmd.mod;1 │ │ │ │ │ +---------- 0 0 0 3380 Jan 11 2024 [ 176 00] f2fs.mod;1 │ │ │ │ │ +---------- 0 0 0 3648 Jan 11 2024 [ 178 00] fat.mod;1 │ │ │ │ │ +---------- 0 0 0 5704 Jan 11 2024 [ 180 00] file.mod;1 │ │ │ │ │ +---------- 0 0 0 6508 Jan 11 2024 [ 183 00] font.mod;1 │ │ │ │ │ +---------- 0 0 0 1160 Jan 11 2024 [ 187 00] freedos.mod;1 │ │ │ │ │ +---------- 0 0 0 204 Jan 11 2024 [ 188 00] fs.lst;1 │ │ │ │ │ +---------- 0 0 0 1756 Jan 11 2024 [ 189 00] fshelp.mod;1 │ │ │ │ │ +---------- 0 0 0 8464 Jan 11 2024 [ 190 00] function.mod;1 │ │ │ │ │ +---------- 0 0 0 780 Jan 11 2024 [ 195 00] gcry_arc.mod;1 │ │ │ │ │ +---------- 0 0 0 5500 Jan 11 2024 [ 196 00] gcry_blo.mod;1 │ │ │ │ │ +---------- 0 0 0 8424 Jan 11 2024 [ 199 00] gcry_cam.mod;1 │ │ │ │ │ +---------- 0 0 0 10640 Jan 11 2024 [ 204 00] gcry_cas.mod;1 │ │ │ │ │ +---------- 0 0 0 8624 Jan 11 2024 [ 210 00] gcry_crc.mod;1 │ │ │ │ │ +---------- 0 0 0 4064 Jan 11 2024 [ 215 00] gcry_des.mod;1 │ │ │ │ │ +---------- 0 0 0 936 Jan 11 2024 [ 217 00] gcry_dsa.mod;1 │ │ │ │ │ +---------- 0 0 0 1512 Jan 11 2024 [ 218 00] gcry_ide.mod;1 │ │ │ │ │ +---------- 0 0 0 1448 Jan 11 2024 [ 219 00] gcry_md4.mod;1 │ │ │ │ │ +---------- 0 0 0 1832 Jan 11 2024 [ 220 00] gcry_md5.mod;1 │ │ │ │ │ +---------- 0 0 0 1344 Jan 11 2024 [ 221 00] gcry_rfc.mod;1 │ │ │ │ │ +---------- 0 0 0 7616 Jan 11 2024 [ 222 00] gcry_rij.mod;1 │ │ │ │ │ +---------- 0 0 0 2736 Jan 11 2024 [ 226 00] gcry_rmd.mod;1 │ │ │ │ │ +---------- 0 0 0 880 Jan 11 2024 [ 228 00] gcry_rsa.mod;1 │ │ │ │ │ +---------- 0 0 0 4472 Jan 11 2024 [ 229 00] gcry_see.mod;1 │ │ │ │ │ +---------- 0 0 0 5604 Jan 11 2024 [ 232 00] gcry_ser.mod;1 │ │ │ │ │ +---------- 0 0 0 3176 Jan 11 2024 [ 235 00] gcry_sh0.mod;1 │ │ │ │ │ +---------- 0 0 0 2088 Jan 11 2024 [ 237 00] gcry_sh1.mod;1 │ │ │ │ │ +---------- 0 0 0 3264 Jan 11 2024 [ 239 00] gcry_sh2.mod;1 │ │ │ │ │ +---------- 0 0 0 10260 Jan 11 2024 [ 241 00] gcry_tig.mod;1 │ │ │ │ │ +---------- 0 0 0 9828 Jan 11 2024 [ 247 00] gcry_two.mod;1 │ │ │ │ │ +---------- 0 0 0 6100 Jan 11 2024 [ 252 00] gcry_whi.mod;1 │ │ │ │ │ +---------- 0 0 0 3752 Jan 11 2024 [ 255 00] gdb.mod;1 │ │ │ │ │ +---------- 0 0 0 2656 Jan 11 2024 [ 257 00] geli.mod;1 │ │ │ │ │ +---------- 0 0 0 2128 Jan 11 2024 [ 259 00] gettext.mod;1 │ │ │ │ │ +---------- 0 0 0 15640 Jan 11 2024 [ 261 00] gfxmenu.mod;1 │ │ │ │ │ +---------- 0 0 0 3884 Jan 11 2024 [ 269 00] gfxterm.mod;1 │ │ │ │ │ +---------- 0 0 0 1128 Jan 11 2024 [ 271 00] gfxterm0.mod;1 │ │ │ │ │ +---------- 0 0 0 1848 Jan 11 2024 [ 272 00] gfxterm1.mod;1 │ │ │ │ │ +---------- 0 0 0 1800 Jan 11 2024 [ 273 00] gptsync.mod;1 │ │ │ │ │ +---------- 0 0 0 4524 Jan 11 2024 [ 274 00] gzio.mod;1 │ │ │ │ │ +---------- 0 0 0 2196 Jan 11 2024 [ 277 00] halt.mod;1 │ │ │ │ │ +---------- 0 0 0 2124 Jan 11 2024 [ 279 00] hashsum.mod;1 │ │ │ │ │ +---------- 0 0 0 2916 Jan 11 2024 [ 281 00] hdparm.mod;1 │ │ │ │ │ +---------- 0 0 0 492 Jan 11 2024 [ 283 00] hello.mod;1 │ │ │ │ │ +---------- 0 0 0 1216 Jan 11 2024 [ 284 00] help.mod;1 │ │ │ │ │ +---------- 0 0 0 1508 Jan 11 2024 [ 285 00] hexdump.mod;1 │ │ │ │ │ +---------- 0 0 0 3788 Jan 11 2024 [ 286 00] hfs.mod;1 │ │ │ │ │ +---------- 0 0 0 4016 Jan 11 2024 [ 288 00] hfsplus.mod;1 │ │ │ │ │ +---------- 0 0 0 1536 Jan 11 2024 [ 290 00] hfsplusc.mod;1 │ │ │ │ │ +---------- 0 0 0 2656 Jan 11 2024 [ 291 00] http.mod;1 │ │ │ │ │ +---------- 0 0 0 1164 Jan 11 2024 [ 293 00] hwmatch.mod;1 │ │ │ │ │ +---------- 0 0 0 1152 Jan 11 2024 [ 294 00] iorw.mod;1 │ │ │ │ │ +---------- 0 0 0 4324 Jan 11 2024 [ 295 00] iso9660.mod;1 │ │ │ │ │ +---------- 0 0 0 3332 Jan 11 2024 [ 298 00] jfs.mod;1 │ │ │ │ │ +---------- 0 0 0 3940 Jan 11 2024 [ 300 00] jpeg.mod;1 │ │ │ │ │ +---------- 0 0 0 2028 Jan 11 2024 [ 302 00] json.mod;1 │ │ │ │ │ +---------- 0 0 0 1416 Jan 11 2024 [ 303 00] keylayou.mod;1 │ │ │ │ │ +---------- 0 0 0 780 Jan 11 2024 [ 304 00] keystatu.mod;1 │ │ │ │ │ +---------- 0 0 0 2872 Jan 11 2024 [ 305 00] ldm.mod;1 │ │ │ │ │ +---------- 0 0 0 908 Jan 11 2024 [ 307 00] legacy_p.mod;1 │ │ │ │ │ +---------- 0 0 0 11076 Jan 11 2024 [ 308 00] legacycf.mod;1 │ │ │ │ │ +---------- 0 0 0 6008 Jan 11 2024 [ 314 00] linux.mod;1 │ │ │ │ │ +---------- 0 0 0 2612 Jan 11 2024 [ 317 00] linux16.mod;1 │ │ │ │ │ +---------- 0 0 0 2804 Jan 11 2024 [ 319 00] loadenv.mod;1 │ │ │ │ │ +---------- 0 0 0 1324 Jan 11 2024 [ 321 00] loopback.mod;1 │ │ │ │ │ +---------- 0 0 0 1660 Jan 11 2024 [ 322 00] ls.mod;1 │ │ │ │ │ +---------- 0 0 0 2068 Jan 11 2024 [ 323 00] lsacpi.mod;1 │ │ │ │ │ +---------- 0 0 0 980 Jan 11 2024 [ 325 00] lsapm.mod;1 │ │ │ │ │ +---------- 0 0 0 804 Jan 11 2024 [ 326 00] lsmmap.mod;1 │ │ │ │ │ +---------- 0 0 0 1816 Jan 11 2024 [ 327 00] lspci.mod;1 │ │ │ │ │ +---------- 0 0 0 1984 Jan 11 2024 [ 328 00] luks.mod;1 │ │ │ │ │ +---------- 0 0 0 5868 Jan 11 2024 [ 329 00] luks2.mod;1 │ │ │ │ │ +---------- 0 0 0 3896 Jan 11 2024 [ 332 00] lvm.mod;1 │ │ │ │ │ +---------- 0 0 0 2608 Jan 11 2024 [ 334 00] lzopio.mod;1 │ │ │ │ │ +---------- 0 0 0 1576 Jan 11 2024 [ 336 00] macbless.mod;1 │ │ │ │ │ +---------- 0 0 0 3268 Jan 11 2024 [ 337 00] macho.mod;1 │ │ │ │ │ +---------- 0 0 0 964 Jan 11 2024 [ 339 00] mda_text.mod;1 │ │ │ │ │ +---------- 0 0 0 940 Jan 11 2024 [ 340 00] mdraid00.mod;1 │ │ │ │ │ +---------- 0 0 0 972 Jan 11 2024 [ 341 00] mdraid01.mod;1 │ │ │ │ │ +---------- 0 0 0 896 Jan 11 2024 [ 342 00] mdraid1x.mod;1 │ │ │ │ │ +---------- 0 0 0 888 Jan 11 2024 [ 343 00] memdisk.mod;1 │ │ │ │ │ +---------- 0 0 0 1152 Jan 11 2024 [ 344 00] memrw.mod;1 │ │ │ │ │ +---------- 0 0 0 1544 Jan 11 2024 [ 345 00] minicmd.mod;1 │ │ │ │ │ +---------- 0 0 0 2008 Jan 11 2024 [ 346 00] minix.mod;1 │ │ │ │ │ +---------- 0 0 0 2064 Jan 11 2024 [ 347 00] minix2.mod;1 │ │ │ │ │ +---------- 0 0 0 2132 Jan 11 2024 [ 349 00] minix2_b.mod;1 │ │ │ │ │ +---------- 0 0 0 2032 Jan 11 2024 [ 351 00] minix3.mod;1 │ │ │ │ │ +---------- 0 0 0 2132 Jan 11 2024 [ 352 00] minix3_b.mod;1 │ │ │ │ │ +---------- 0 0 0 2072 Jan 11 2024 [ 354 00] minix_be.mod;1 │ │ │ │ │ +---------- 0 0 0 4176 Jan 11 2024 [ 356 00] mmap.mod;1 │ │ │ │ │ +---------- 0 0 0 2116 Jan 11 2024 [ 359 00] moddep.lst;1 │ │ │ │ │ +---------- 0 0 0 1264 Jan 11 2024 [ 361 00] modinfo.sh;1 │ │ │ │ │ +---------- 0 0 0 708 Jan 11 2024 [ 362 00] morse.mod;1 │ │ │ │ │ +---------- 0 0 0 12848 Jan 11 2024 [ 363 00] mpi.mod;1 │ │ │ │ │ +---------- 0 0 0 1072 Jan 11 2024 [ 370 00] msdospar.mod;1 │ │ │ │ │ +---------- 0 0 0 960 Jan 11 2024 [ 371 00] mul_test.mod;1 │ │ │ │ │ +---------- 0 0 0 6184 Jan 11 2024 [ 372 00] multibo0.mod;1 │ │ │ │ │ +---------- 0 0 0 6628 Jan 11 2024 [ 376 00] multibo1.mod;1 │ │ │ │ │ +---------- 0 0 0 1908 Jan 11 2024 [ 380 00] nativedi.mod;1 │ │ │ │ │ +---------- 0 0 0 24724 Jan 11 2024 [ 381 00] net.mod;1 │ │ │ │ │ +---------- 0 0 0 1396 Jan 11 2024 [ 394 00] newc.mod;1 │ │ │ │ │ +---------- 0 0 0 3356 Jan 11 2024 [ 395 00] nilfs2.mod;1 │ │ │ │ │ +---------- 0 0 0 44536 Jan 11 2024 [ 397 00] normal.mod;1 │ │ │ │ │ +---------- 0 0 0 5748 Jan 11 2024 [ 419 00] ntfs.mod;1 │ │ │ │ │ +---------- 0 0 0 2448 Jan 11 2024 [ 422 00] ntfscomp.mod;1 │ │ │ │ │ +---------- 0 0 0 1076 Jan 11 2024 [ 424 00] ntldr.mod;1 │ │ │ │ │ +---------- 0 0 0 1300 Jan 11 2024 [ 425 00] odc.mod;1 │ │ │ │ │ +---------- 0 0 0 684 Jan 11 2024 [ 426 00] offsetio.mod;1 │ │ │ │ │ +---------- 0 0 0 4456 Jan 11 2024 [ 427 00] ohci.mod;1 │ │ │ │ │ +---------- 0 0 0 816 Jan 11 2024 [ 430 00] part_aco.mod;1 │ │ │ │ │ +---------- 0 0 0 896 Jan 11 2024 [ 431 00] part_ami.mod;1 │ │ │ │ │ +---------- 0 0 0 976 Jan 11 2024 [ 432 00] part_app.mod;1 │ │ │ │ │ +---------- 0 0 0 1272 Jan 11 2024 [ 433 00] part_bsd.mod;1 │ │ │ │ │ +---------- 0 0 0 856 Jan 11 2024 [ 434 00] part_dfl.mod;1 │ │ │ │ │ +---------- 0 0 0 704 Jan 11 2024 [ 435 00] part_dvh.mod;1 │ │ │ │ │ +---------- 0 0 0 1100 Jan 11 2024 [ 436 00] part_gpt.mod;1 │ │ │ │ │ +---------- 0 0 0 1200 Jan 11 2024 [ 437 00] part_msd.mod;1 │ │ │ │ │ +---------- 0 0 0 828 Jan 11 2024 [ 438 00] part_pla.mod;1 │ │ │ │ │ +---------- 0 0 0 732 Jan 11 2024 [ 439 00] part_su0.mod;1 │ │ │ │ │ +---------- 0 0 0 768 Jan 11 2024 [ 440 00] part_su1.mod;1 │ │ │ │ │ +---------- 0 0 0 116 Jan 11 2024 [ 441 00] partmap.lst;1 │ │ │ │ │ +---------- 0 0 0 68 Jan 11 2024 [ 442 00] parttool.lst;1 │ │ │ │ │ +---------- 0 0 0 2052 Jan 11 2024 [ 443 00] parttool.mod;1 │ │ │ │ │ +---------- 0 0 0 832 Jan 11 2024 [ 445 00] passwor0.mod;1 │ │ │ │ │ +---------- 0 0 0 1288 Jan 11 2024 [ 446 00] passwor1.mod;1 │ │ │ │ │ +---------- 0 0 0 2344 Jan 11 2024 [ 447 00] pata.mod;1 │ │ │ │ │ +---------- 0 0 0 684 Jan 11 2024 [ 449 00] pbkdf2.mod;1 │ │ │ │ │ +---------- 0 0 0 928 Jan 11 2024 [ 450 00] pbkdf2_t.mod;1 │ │ │ │ │ +---------- 0 0 0 720 Jan 11 2024 [ 451 00] pci.mod;1 │ │ │ │ │ +---------- 0 0 0 1116 Jan 11 2024 [ 452 00] pcidump.mod;1 │ │ │ │ │ +---------- 0 0 0 4776 Jan 11 2024 [ 453 00] pgp.mod;1 │ │ │ │ │ +---------- 0 0 0 3036 Jan 11 2024 [ 456 00] plan9.mod;1 │ │ │ │ │ +---------- 0 0 0 1212 Jan 11 2024 [ 458 00] play.mod;1 │ │ │ │ │ +---------- 0 0 0 4132 Jan 11 2024 [ 459 00] png.mod;1 │ │ │ │ │ +---------- 0 0 0 800 Jan 11 2024 [ 462 00] priority.mod;1 │ │ │ │ │ +---------- 0 0 0 1472 Jan 11 2024 [ 463 00] probe.mod;1 │ │ │ │ │ +---------- 0 0 0 956 Jan 11 2024 [ 464 00] procfs.mod;1 │ │ │ │ │ +---------- 0 0 0 1096 Jan 11 2024 [ 465 00] progress.mod;1 │ │ │ │ │ +---------- 0 0 0 1548 Jan 11 2024 [ 466 00] pxe.mod;1 │ │ │ │ │ +---------- 0 0 0 1136 Jan 11 2024 [ 467 00] pxechain.mod;1 │ │ │ │ │ +---------- 0 0 0 696 Jan 11 2024 [ 468 00] raid5rec.mod;1 │ │ │ │ │ +---------- 0 0 0 1236 Jan 11 2024 [ 469 00] raid6rec.mod;1 │ │ │ │ │ +---------- 0 0 0 1368 Jan 11 2024 [ 470 00] random.mod;1 │ │ │ │ │ +---------- 0 0 0 856 Jan 11 2024 [ 471 00] rdmsr.mod;1 │ │ │ │ │ +---------- 0 0 0 660 Jan 11 2024 [ 472 00] read.mod;1 │ │ │ │ │ +---------- 0 0 0 736 Jan 11 2024 [ 473 00] reboot.mod;1 │ │ │ │ │ +---------- 0 0 0 26876 Jan 11 2024 [ 474 00] regexp.mod;1 │ │ │ │ │ +---------- 0 0 0 4316 Jan 11 2024 [ 488 00] reiserfs.mod;1 │ │ │ │ │ +---------- 0 0 0 6656 Jan 11 2024 [ 491 00] relocato.mod;1 │ │ │ │ │ +---------- 0 0 0 2152 Jan 11 2024 [ 495 00] romfs.mod;1 │ │ │ │ │ +---------- 0 0 0 2304 Jan 11 2024 [ 497 00] scsi.mod;1 │ │ │ │ │ +---------- 0 0 0 1384 Jan 11 2024 [ 499 00] search.mod;1 │ │ │ │ │ +---------- 0 0 0 1448 Jan 11 2024 [ 500 00] search_0.mod;1 │ │ │ │ │ +---------- 0 0 0 1564 Jan 11 2024 [ 501 00] search_1.mod;1 │ │ │ │ │ +---------- 0 0 0 1484 Jan 11 2024 [ 502 00] search_l.mod;1 │ │ │ │ │ +---------- 0 0 0 2540 Jan 11 2024 [ 503 00] sendkey.mod;1 │ │ │ │ │ +---------- 0 0 0 3176 Jan 11 2024 [ 505 00] serial.mod;1 │ │ │ │ │ +---------- 0 0 0 300 Jan 11 2024 [ 507 00] setjmp.mod;1 │ │ │ │ │ +---------- 0 0 0 676 Jan 11 2024 [ 508 00] setjmp_t.mod;1 │ │ │ │ │ +---------- 0 0 0 2148 Jan 11 2024 [ 509 00] setpci.mod;1 │ │ │ │ │ +---------- 0 0 0 2596 Jan 11 2024 [ 511 00] sfs.mod;1 │ │ │ │ │ +---------- 0 0 0 1124 Jan 11 2024 [ 513 00] shift_te.mod;1 │ │ │ │ │ +---------- 0 0 0 4268 Jan 11 2024 [ 514 00] signatur.mod;1 │ │ │ │ │ +---------- 0 0 0 912 Jan 11 2024 [ 517 00] sleep.mod;1 │ │ │ │ │ +---------- 0 0 0 1104 Jan 11 2024 [ 518 00] sleep_te.mod;1 │ │ │ │ │ +---------- 0 0 0 2332 Jan 11 2024 [ 519 00] smbios.mod;1 │ │ │ │ │ +---------- 0 0 0 804 Jan 11 2024 [ 521 00] spkmodem.mod;1 │ │ │ │ │ +---------- 0 0 0 3808 Jan 11 2024 [ 522 00] squash4.mod;1 │ │ │ │ │ +---------- 0 0 0 916 Jan 11 2024 [ 524 00] strtoull.mod;1 │ │ │ │ │ +---------- 0 0 0 7216 Jan 11 2024 [ 525 00] syslinux.mod;1 │ │ │ │ │ +---------- 0 0 0 1552 Jan 11 2024 [ 529 00] tar.mod;1 │ │ │ │ │ +---------- 0 0 0 164 Jan 11 2024 [ 530 00] terminal.lst;1 │ │ │ │ │ +---------- 0 0 0 1792 Jan 11 2024 [ 531 00] terminal.mod;1 │ │ │ │ │ +---------- 0 0 0 5080 Jan 11 2024 [ 532 00] terminfo.mod;1 │ │ │ │ │ +---------- 0 0 0 2192 Jan 11 2024 [ 535 00] test.mod;1 │ │ │ │ │ +---------- 0 0 0 576 Jan 11 2024 [ 537 00] test_blo.mod;1 │ │ │ │ │ +---------- 0 0 0 1240 Jan 11 2024 [ 538 00] testload.mod;1 │ │ │ │ │ +---------- 0 0 0 1024 Jan 11 2024 [ 539 00] testspee.mod;1 │ │ │ │ │ +---------- 0 0 0 2176 Jan 11 2024 [ 540 00] tftp.mod;1 │ │ │ │ │ +---------- 0 0 0 1796 Jan 11 2024 [ 542 00] tga.mod;1 │ │ │ │ │ +---------- 0 0 0 684 Jan 11 2024 [ 543 00] time.mod;1 │ │ │ │ │ +---------- 0 0 0 1076 Jan 11 2024 [ 544 00] tr.mod;1 │ │ │ │ │ +---------- 0 0 0 788 Jan 11 2024 [ 545 00] trig.mod;1 │ │ │ │ │ +---------- 0 0 0 500 Jan 11 2024 [ 546 00] true.mod;1 │ │ │ │ │ +---------- 0 0 0 1588 Jan 11 2024 [ 547 00] truecryp.mod;1 │ │ │ │ │ +---------- 0 0 0 4372 Jan 11 2024 [ 548 00] udf.mod;1 │ │ │ │ │ +---------- 0 0 0 2648 Jan 11 2024 [ 551 00] ufs1.mod;1 │ │ │ │ │ +---------- 0 0 0 2848 Jan 11 2024 [ 553 00] ufs1_be.mod;1 │ │ │ │ │ +---------- 0 0 0 2732 Jan 11 2024 [ 555 00] ufs2.mod;1 │ │ │ │ │ +---------- 0 0 0 2976 Jan 11 2024 [ 557 00] uhci.mod;1 │ │ │ │ │ +---------- 0 0 0 5168 Jan 11 2024 [ 559 00] usb.mod;1 │ │ │ │ │ +---------- 0 0 0 1796 Jan 11 2024 [ 562 00] usb_keyb.mod;1 │ │ │ │ │ +---------- 0 0 0 2820 Jan 11 2024 [ 563 00] usbms.mod;1 │ │ │ │ │ +---------- 0 0 0 952 Jan 11 2024 [ 565 00] usbseri0.mod;1 │ │ │ │ │ +---------- 0 0 0 1004 Jan 11 2024 [ 566 00] usbseri1.mod;1 │ │ │ │ │ +---------- 0 0 0 1056 Jan 11 2024 [ 567 00] usbseri2.mod;1 │ │ │ │ │ +---------- 0 0 0 612 Jan 11 2024 [ 568 00] usbseri3.mod;1 │ │ │ │ │ +---------- 0 0 0 1760 Jan 11 2024 [ 569 00] usbtest.mod;1 │ │ │ │ │ +---------- 0 0 0 4160 Jan 11 2024 [ 570 00] vbe.mod;1 │ │ │ │ │ +---------- 0 0 0 1300 Jan 11 2024 [ 573 00] verifier.mod;1 │ │ │ │ │ +---------- 0 0 0 1884 Jan 11 2024 [ 574 00] vga.mod;1 │ │ │ │ │ +---------- 0 0 0 1004 Jan 11 2024 [ 575 00] vga_text.mod;1 │ │ │ │ │ +---------- 0 0 0 84 Jan 11 2024 [ 576 00] video.lst;1 │ │ │ │ │ +---------- 0 0 0 2300 Jan 11 2024 [ 577 00] video.mod;1 │ │ │ │ │ +---------- 0 0 0 2128 Jan 11 2024 [ 579 00] video_bo.mod;1 │ │ │ │ │ +---------- 0 0 0 2348 Jan 11 2024 [ 581 00] video_ci.mod;1 │ │ │ │ │ +---------- 0 0 0 2232 Jan 11 2024 [ 583 00] video_co.mod;1 │ │ │ │ │ +---------- 0 0 0 9408 Jan 11 2024 [ 585 00] video_fb.mod;1 │ │ │ │ │ +---------- 0 0 0 1656 Jan 11 2024 [ 590 00] videoinf.mod;1 │ │ │ │ │ +---------- 0 0 0 1648 Jan 11 2024 [ 591 00] videote0.mod;1 │ │ │ │ │ +---------- 0 0 0 892 Jan 11 2024 [ 592 00] videote1.mod;1 │ │ │ │ │ +---------- 0 0 0 724 Jan 11 2024 [ 593 00] wrmsr.mod;1 │ │ │ │ │ +---------- 0 0 0 3708 Jan 11 2024 [ 594 00] xfs.mod;1 │ │ │ │ │ +---------- 0 0 0 11368 Jan 11 2024 [ 596 00] xnu.mod;1 │ │ │ │ │ +---------- 0 0 0 972 Jan 11 2024 [ 602 00] xnu_uui0.mod;1 │ │ │ │ │ +---------- 0 0 0 808 Jan 11 2024 [ 603 00] xnu_uui1.mod;1 │ │ │ │ │ +---------- 0 0 0 8032 Jan 11 2024 [ 604 00] xzio.mod;1 │ │ │ │ │ +---------- 0 0 0 19000 Jan 11 2024 [ 608 00] zfs.mod;1 │ │ │ │ │ +---------- 0 0 0 2700 Jan 11 2024 [ 618 00] zfscrypt.mod;1 │ │ │ │ │ +---------- 0 0 0 2548 Jan 11 2024 [ 620 00] zfsinfo.mod;1 │ │ │ │ │ +---------- 0 0 0 19332 Jan 11 2024 [ 622 00] zstd.mod;1 │ │ │ │ │ │ │ │ │ │ Directory listing of /boot/grub/locale/ │ │ │ │ │ -d--------- 0 0 0 2048 Feb 12 2025 [ 43 02] . │ │ │ │ │ -d--------- 0 0 0 2048 Feb 12 2025 [ 22 02] .. │ │ │ │ │ +d--------- 0 0 0 2048 Jan 11 2024 [ 43 02] . │ │ │ │ │ +d--------- 0 0 0 2048 Jan 11 2024 [ 22 02] .. │ │ │ │ │ │ │ │ │ │ Directory listing of /boot/grub/roms/ │ │ │ │ │ -d--------- 0 0 0 2048 Feb 12 2025 [ 44 02] . │ │ │ │ │ -d--------- 0 0 0 2048 Feb 12 2025 [ 22 02] .. │ │ │ │ │ +d--------- 0 0 0 2048 Jan 11 2024 [ 44 02] . │ │ │ │ │ +d--------- 0 0 0 2048 Jan 11 2024 [ 22 02] .. │ │ │ │ ├── isoinfo -l -i {} -R │ │ │ │ │ @@ -1,323 +1,323 @@ │ │ │ │ │ │ │ │ │ │ Directory listing of / │ │ │ │ │ -dr-xr-xr-x 1 0 0 2048 Feb 12 2025 [ 19 02] . │ │ │ │ │ -dr-xr-xr-x 1 0 0 2048 Feb 12 2025 [ 19 02] .. │ │ │ │ │ -dr-xr-xr-x 1 0 0 2048 Feb 12 2025 [ 21 02] boot │ │ │ │ │ --r--r--r-- 1 0 0 2048 Feb 12 2025 [ 48 00] boot.catalog │ │ │ │ │ +dr-xr-xr-x 1 0 0 2048 Jan 11 2024 [ 19 02] . │ │ │ │ │ +dr-xr-xr-x 1 0 0 2048 Jan 11 2024 [ 19 02] .. │ │ │ │ │ +dr-xr-xr-x 1 0 0 2048 Jan 11 2024 [ 21 02] boot │ │ │ │ │ +-r--r--r-- 1 0 0 2048 Jan 11 2024 [ 48 00] boot.catalog │ │ │ │ │ │ │ │ │ │ Directory listing of /boot/ │ │ │ │ │ -dr-xr-xr-x 1 0 0 2048 Feb 12 2025 [ 21 02] . │ │ │ │ │ -dr-xr-xr-x 1 0 0 2048 Feb 12 2025 [ 19 02] .. │ │ │ │ │ -dr-xr-xr-x 1 0 0 2048 Feb 12 2025 [ 22 02] grub │ │ │ │ │ +dr-xr-xr-x 1 0 0 2048 Jan 11 2024 [ 21 02] . │ │ │ │ │ +dr-xr-xr-x 1 0 0 2048 Jan 11 2024 [ 19 02] .. │ │ │ │ │ +dr-xr-xr-x 1 0 0 2048 Jan 11 2024 [ 22 02] grub │ │ │ │ │ │ │ │ │ │ Directory listing of /boot/grub/ │ │ │ │ │ -dr-xr-xr-x 1 0 0 2048 Feb 12 2025 [ 22 02] . │ │ │ │ │ -dr-xr-xr-x 1 0 0 2048 Feb 12 2025 [ 21 02] .. │ │ │ │ │ -dr-xr-xr-x 1 0 0 2048 Feb 12 2025 [ 23 02] fonts │ │ │ │ │ --r--r--r-- 1 0 0 1705 Feb 12 2025 [ 49 00] grub.cfg │ │ │ │ │ -dr-xr-xr-x 1 0 0 38912 Feb 12 2025 [ 24 02] i386-pc │ │ │ │ │ -dr-xr-xr-x 1 0 0 2048 Feb 12 2025 [ 43 02] locale │ │ │ │ │ -dr-xr-xr-x 1 0 0 2048 Feb 12 2025 [ 44 02] roms │ │ │ │ │ +dr-xr-xr-x 1 0 0 2048 Jan 11 2024 [ 22 02] . │ │ │ │ │ +dr-xr-xr-x 1 0 0 2048 Jan 11 2024 [ 21 02] .. │ │ │ │ │ +dr-xr-xr-x 1 0 0 2048 Jan 11 2024 [ 23 02] fonts │ │ │ │ │ +-r--r--r-- 1 0 0 1705 Jan 11 2024 [ 49 00] grub.cfg │ │ │ │ │ +dr-xr-xr-x 1 0 0 38912 Jan 11 2024 [ 24 02] i386-pc │ │ │ │ │ +dr-xr-xr-x 1 0 0 2048 Jan 11 2024 [ 43 02] locale │ │ │ │ │ +dr-xr-xr-x 1 0 0 2048 Jan 11 2024 [ 44 02] roms │ │ │ │ │ │ │ │ │ │ Directory listing of /boot/grub/fonts/ │ │ │ │ │ -dr-xr-xr-x 1 0 0 2048 Feb 12 2025 [ 23 02] . │ │ │ │ │ -dr-xr-xr-x 1 0 0 2048 Feb 12 2025 [ 22 02] .. │ │ │ │ │ +dr-xr-xr-x 1 0 0 2048 Jan 11 2024 [ 23 02] . │ │ │ │ │ +dr-xr-xr-x 1 0 0 2048 Jan 11 2024 [ 22 02] .. │ │ │ │ │ │ │ │ │ │ Directory listing of /boot/grub/i386-pc/ │ │ │ │ │ -dr-xr-xr-x 1 0 0 38912 Feb 12 2025 [ 24 02] . │ │ │ │ │ -dr-xr-xr-x 1 0 0 2048 Feb 12 2025 [ 22 02] .. │ │ │ │ │ --r-xr-xr-x 1 0 0 3520 Feb 12 2025 [ 50 00] 915resolution.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 4404 Feb 12 2025 [ 52 00] acpi.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 548 Feb 12 2025 [ 55 00] adler32.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2636 Feb 12 2025 [ 56 00] affs.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 3176 Feb 12 2025 [ 58 00] afs.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 832 Feb 12 2025 [ 60 00] afsplitter.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 4920 Feb 12 2025 [ 61 00] ahci.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 236 Feb 12 2025 [ 64 00] all_video.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 496 Feb 12 2025 [ 65 00] aout.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1540 Feb 12 2025 [ 66 00] archelp.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2004 Feb 12 2025 [ 67 00] at_keyboard.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2672 Feb 12 2025 [ 68 00] ata.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 748 Feb 12 2025 [ 70 00] backtrace.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 3580 Feb 12 2025 [ 71 00] bfs.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2496 Feb 12 2025 [ 73 00] biosdisk.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1128 Feb 12 2025 [ 75 00] bitmap.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2020 Feb 12 2025 [ 76 00] bitmap_scale.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1068 Feb 12 2025 [ 77 00] blocklist.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1180 Feb 12 2025 [ 78 00] boot.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 12244 Feb 12 2025 [ 79 00] bsd.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1020 Feb 12 2025 [ 85 00] bswap_test.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 9152 Feb 12 2025 [ 86 00] btrfs.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1040 Feb 12 2025 [ 91 00] bufio.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1348 Feb 12 2025 [ 92 00] cat.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1860 Feb 12 2025 [ 93 00] cbfs.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1180 Feb 12 2025 [ 94 00] cbls.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 976 Feb 12 2025 [ 95 00] cbmemc.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 536 Feb 12 2025 [ 96 00] cbtable.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1112 Feb 12 2025 [ 97 00] cbtime.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1596 Feb 12 2025 [ 98 00] chain.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1160 Feb 12 2025 [ 99 00] cmdline_cat_test.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 580 Feb 12 2025 [ 100 00] cmosdump.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 812 Feb 12 2025 [ 101 00] cmostest.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 968 Feb 12 2025 [ 102 00] cmp.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1780 Feb 12 2025 [ 103 00] cmp_test.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1456 Feb 12 2025 [ 104 00] command.lst │ │ │ │ │ --r-xr-xr-x 1 0 0 840 Feb 12 2025 [ 105 00] configfile.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1272 Feb 12 2025 [ 106 00] cpio.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1300 Feb 12 2025 [ 107 00] cpio_be.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 728 Feb 12 2025 [ 108 00] cpuid.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 800 Feb 12 2025 [ 109 00] crc64.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 416 Feb 12 2025 [ 110 00] crypto.lst │ │ │ │ │ --r-xr-xr-x 1 0 0 2344 Feb 12 2025 [ 111 00] crypto.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 5476 Feb 12 2025 [ 113 00] cryptodisk.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1480 Feb 12 2025 [ 116 00] cs5536.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 816 Feb 12 2025 [ 117 00] ctz_test.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1040 Feb 12 2025 [ 118 00] date.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 700 Feb 12 2025 [ 119 00] datehook.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1252 Feb 12 2025 [ 120 00] datetime.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1300 Feb 12 2025 [ 121 00] disk.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 5340 Feb 12 2025 [ 122 00] diskfilter.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 508 Feb 12 2025 [ 125 00] div.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2216 Feb 12 2025 [ 126 00] div_test.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 852 Feb 12 2025 [ 128 00] dm_nv.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2396 Feb 12 2025 [ 129 00] drivemap.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 888 Feb 12 2025 [ 131 00] echo.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 9464 Feb 12 2025 [ 132 00] efiemu.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 3184 Feb 12 2025 [ 137 00] efiemu32.o │ │ │ │ │ --r-xr-xr-x 1 0 0 3424 Feb 12 2025 [ 139 00] efiemu64.o │ │ │ │ │ --r-xr-xr-x 1 0 0 6044 Feb 12 2025 [ 141 00] ehci.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1888 Feb 12 2025 [ 144 00] elf.mod │ │ │ │ │ --r--r--r-- 1 0 0 46703 Feb 12 2025 [ 145 00] eltorito.img │ │ │ │ │ --r-xr-xr-x 1 0 0 652 Feb 12 2025 [ 168 00] eval.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 3428 Feb 12 2025 [ 169 00] exfat.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 556 Feb 12 2025 [ 171 00] exfctest.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 3196 Feb 12 2025 [ 172 00] ext2.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2440 Feb 12 2025 [ 174 00] extcmd.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 3380 Feb 12 2025 [ 176 00] f2fs.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 3648 Feb 12 2025 [ 178 00] fat.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 5704 Feb 12 2025 [ 180 00] file.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 6508 Feb 12 2025 [ 183 00] font.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1160 Feb 12 2025 [ 187 00] freedos.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 204 Feb 12 2025 [ 188 00] fs.lst │ │ │ │ │ --r-xr-xr-x 1 0 0 1756 Feb 12 2025 [ 189 00] fshelp.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 8464 Feb 12 2025 [ 190 00] functional_test.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 780 Feb 12 2025 [ 195 00] gcry_arcfour.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 5500 Feb 12 2025 [ 196 00] gcry_blowfish.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 8424 Feb 12 2025 [ 199 00] gcry_camellia.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 10640 Feb 12 2025 [ 204 00] gcry_cast5.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 8624 Feb 12 2025 [ 210 00] gcry_crc.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 4064 Feb 12 2025 [ 215 00] gcry_des.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 936 Feb 12 2025 [ 217 00] gcry_dsa.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1512 Feb 12 2025 [ 218 00] gcry_idea.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1448 Feb 12 2025 [ 219 00] gcry_md4.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1832 Feb 12 2025 [ 220 00] gcry_md5.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1344 Feb 12 2025 [ 221 00] gcry_rfc2268.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 7616 Feb 12 2025 [ 222 00] gcry_rijndael.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2736 Feb 12 2025 [ 226 00] gcry_rmd160.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 880 Feb 12 2025 [ 228 00] gcry_rsa.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 4472 Feb 12 2025 [ 229 00] gcry_seed.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 5604 Feb 12 2025 [ 232 00] gcry_serpent.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 3176 Feb 12 2025 [ 235 00] gcry_sha1.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2088 Feb 12 2025 [ 237 00] gcry_sha256.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 3264 Feb 12 2025 [ 239 00] gcry_sha512.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 10260 Feb 12 2025 [ 241 00] gcry_tiger.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 9828 Feb 12 2025 [ 247 00] gcry_twofish.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 6100 Feb 12 2025 [ 252 00] gcry_whirlpool.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 3752 Feb 12 2025 [ 255 00] gdb.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2656 Feb 12 2025 [ 257 00] geli.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2128 Feb 12 2025 [ 259 00] gettext.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 15640 Feb 12 2025 [ 261 00] gfxmenu.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 3884 Feb 12 2025 [ 269 00] gfxterm.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1128 Feb 12 2025 [ 271 00] gfxterm_background.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1848 Feb 12 2025 [ 272 00] gfxterm_menu.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1800 Feb 12 2025 [ 273 00] gptsync.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 4524 Feb 12 2025 [ 274 00] gzio.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2196 Feb 12 2025 [ 277 00] halt.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2124 Feb 12 2025 [ 279 00] hashsum.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2916 Feb 12 2025 [ 281 00] hdparm.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 492 Feb 12 2025 [ 283 00] hello.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1216 Feb 12 2025 [ 284 00] help.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1508 Feb 12 2025 [ 285 00] hexdump.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 3788 Feb 12 2025 [ 286 00] hfs.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 4016 Feb 12 2025 [ 288 00] hfsplus.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1536 Feb 12 2025 [ 290 00] hfspluscomp.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2656 Feb 12 2025 [ 291 00] http.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1164 Feb 12 2025 [ 293 00] hwmatch.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1152 Feb 12 2025 [ 294 00] iorw.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 4324 Feb 12 2025 [ 295 00] iso9660.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 3332 Feb 12 2025 [ 298 00] jfs.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 3940 Feb 12 2025 [ 300 00] jpeg.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2028 Feb 12 2025 [ 302 00] json.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1416 Feb 12 2025 [ 303 00] keylayouts.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 780 Feb 12 2025 [ 304 00] keystatus.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2872 Feb 12 2025 [ 305 00] ldm.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 908 Feb 12 2025 [ 307 00] legacy_password_test.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 11076 Feb 12 2025 [ 308 00] legacycfg.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 6008 Feb 12 2025 [ 314 00] linux.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2612 Feb 12 2025 [ 317 00] linux16.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2804 Feb 12 2025 [ 319 00] loadenv.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1324 Feb 12 2025 [ 321 00] loopback.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1660 Feb 12 2025 [ 322 00] ls.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2068 Feb 12 2025 [ 323 00] lsacpi.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 980 Feb 12 2025 [ 325 00] lsapm.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 804 Feb 12 2025 [ 326 00] lsmmap.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1816 Feb 12 2025 [ 327 00] lspci.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1984 Feb 12 2025 [ 328 00] luks.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 5868 Feb 12 2025 [ 329 00] luks2.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 3896 Feb 12 2025 [ 332 00] lvm.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2608 Feb 12 2025 [ 334 00] lzopio.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1576 Feb 12 2025 [ 336 00] macbless.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 3268 Feb 12 2025 [ 337 00] macho.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 964 Feb 12 2025 [ 339 00] mda_text.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 940 Feb 12 2025 [ 340 00] mdraid09.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 972 Feb 12 2025 [ 341 00] mdraid09_be.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 896 Feb 12 2025 [ 342 00] mdraid1x.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 888 Feb 12 2025 [ 343 00] memdisk.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1152 Feb 12 2025 [ 344 00] memrw.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1544 Feb 12 2025 [ 345 00] minicmd.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2008 Feb 12 2025 [ 346 00] minix.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2064 Feb 12 2025 [ 347 00] minix2.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2132 Feb 12 2025 [ 349 00] minix2_be.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2032 Feb 12 2025 [ 351 00] minix3.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2132 Feb 12 2025 [ 352 00] minix3_be.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2072 Feb 12 2025 [ 354 00] minix_be.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 4176 Feb 12 2025 [ 356 00] mmap.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2116 Feb 12 2025 [ 359 00] moddep.lst │ │ │ │ │ --r-xr-xr-x 1 0 0 1264 Feb 12 2025 [ 361 00] modinfo.sh │ │ │ │ │ --r-xr-xr-x 1 0 0 708 Feb 12 2025 [ 362 00] morse.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 12848 Feb 12 2025 [ 363 00] mpi.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1072 Feb 12 2025 [ 370 00] msdospart.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 960 Feb 12 2025 [ 371 00] mul_test.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 6184 Feb 12 2025 [ 372 00] multiboot.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 6628 Feb 12 2025 [ 376 00] multiboot2.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1908 Feb 12 2025 [ 380 00] nativedisk.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 24724 Feb 12 2025 [ 381 00] net.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1396 Feb 12 2025 [ 394 00] newc.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 3356 Feb 12 2025 [ 395 00] nilfs2.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 44536 Feb 12 2025 [ 397 00] normal.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 5748 Feb 12 2025 [ 419 00] ntfs.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2448 Feb 12 2025 [ 422 00] ntfscomp.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1076 Feb 12 2025 [ 424 00] ntldr.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1300 Feb 12 2025 [ 425 00] odc.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 684 Feb 12 2025 [ 426 00] offsetio.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 4456 Feb 12 2025 [ 427 00] ohci.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 816 Feb 12 2025 [ 430 00] part_acorn.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 896 Feb 12 2025 [ 431 00] part_amiga.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 976 Feb 12 2025 [ 432 00] part_apple.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1272 Feb 12 2025 [ 433 00] part_bsd.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 856 Feb 12 2025 [ 434 00] part_dfly.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 704 Feb 12 2025 [ 435 00] part_dvh.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1100 Feb 12 2025 [ 436 00] part_gpt.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1200 Feb 12 2025 [ 437 00] part_msdos.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 828 Feb 12 2025 [ 438 00] part_plan.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 732 Feb 12 2025 [ 439 00] part_sun.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 768 Feb 12 2025 [ 440 00] part_sunpc.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 116 Feb 12 2025 [ 441 00] partmap.lst │ │ │ │ │ --r-xr-xr-x 1 0 0 68 Feb 12 2025 [ 442 00] parttool.lst │ │ │ │ │ --r-xr-xr-x 1 0 0 2052 Feb 12 2025 [ 443 00] parttool.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 832 Feb 12 2025 [ 445 00] password.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1288 Feb 12 2025 [ 446 00] password_pbkdf2.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2344 Feb 12 2025 [ 447 00] pata.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 684 Feb 12 2025 [ 449 00] pbkdf2.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 928 Feb 12 2025 [ 450 00] pbkdf2_test.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 720 Feb 12 2025 [ 451 00] pci.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1116 Feb 12 2025 [ 452 00] pcidump.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 4776 Feb 12 2025 [ 453 00] pgp.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 3036 Feb 12 2025 [ 456 00] plan9.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1212 Feb 12 2025 [ 458 00] play.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 4132 Feb 12 2025 [ 459 00] png.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 800 Feb 12 2025 [ 462 00] priority_queue.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1472 Feb 12 2025 [ 463 00] probe.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 956 Feb 12 2025 [ 464 00] procfs.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1096 Feb 12 2025 [ 465 00] progress.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1548 Feb 12 2025 [ 466 00] pxe.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1136 Feb 12 2025 [ 467 00] pxechain.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 696 Feb 12 2025 [ 468 00] raid5rec.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1236 Feb 12 2025 [ 469 00] raid6rec.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1368 Feb 12 2025 [ 470 00] random.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 856 Feb 12 2025 [ 471 00] rdmsr.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 660 Feb 12 2025 [ 472 00] read.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 736 Feb 12 2025 [ 473 00] reboot.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 26876 Feb 12 2025 [ 474 00] regexp.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 4316 Feb 12 2025 [ 488 00] reiserfs.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 6656 Feb 12 2025 [ 491 00] relocator.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2152 Feb 12 2025 [ 495 00] romfs.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2304 Feb 12 2025 [ 497 00] scsi.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1384 Feb 12 2025 [ 499 00] search.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1448 Feb 12 2025 [ 500 00] search_fs_file.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1564 Feb 12 2025 [ 501 00] search_fs_uuid.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1484 Feb 12 2025 [ 502 00] search_label.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2540 Feb 12 2025 [ 503 00] sendkey.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 3176 Feb 12 2025 [ 505 00] serial.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 300 Feb 12 2025 [ 507 00] setjmp.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 676 Feb 12 2025 [ 508 00] setjmp_test.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2148 Feb 12 2025 [ 509 00] setpci.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2596 Feb 12 2025 [ 511 00] sfs.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1124 Feb 12 2025 [ 513 00] shift_test.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 4268 Feb 12 2025 [ 514 00] signature_test.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 912 Feb 12 2025 [ 517 00] sleep.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1104 Feb 12 2025 [ 518 00] sleep_test.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2332 Feb 12 2025 [ 519 00] smbios.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 804 Feb 12 2025 [ 521 00] spkmodem.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 3808 Feb 12 2025 [ 522 00] squash4.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 916 Feb 12 2025 [ 524 00] strtoull_test.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 7216 Feb 12 2025 [ 525 00] syslinuxcfg.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1552 Feb 12 2025 [ 529 00] tar.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 164 Feb 12 2025 [ 530 00] terminal.lst │ │ │ │ │ --r-xr-xr-x 1 0 0 1792 Feb 12 2025 [ 531 00] terminal.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 5080 Feb 12 2025 [ 532 00] terminfo.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2192 Feb 12 2025 [ 535 00] test.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 576 Feb 12 2025 [ 537 00] test_blockarg.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1240 Feb 12 2025 [ 538 00] testload.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1024 Feb 12 2025 [ 539 00] testspeed.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2176 Feb 12 2025 [ 540 00] tftp.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1796 Feb 12 2025 [ 542 00] tga.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 684 Feb 12 2025 [ 543 00] time.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1076 Feb 12 2025 [ 544 00] tr.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 788 Feb 12 2025 [ 545 00] trig.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 500 Feb 12 2025 [ 546 00] true.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1588 Feb 12 2025 [ 547 00] truecrypt.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 4372 Feb 12 2025 [ 548 00] udf.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2648 Feb 12 2025 [ 551 00] ufs1.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2848 Feb 12 2025 [ 553 00] ufs1_be.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2732 Feb 12 2025 [ 555 00] ufs2.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2976 Feb 12 2025 [ 557 00] uhci.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 5168 Feb 12 2025 [ 559 00] usb.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1796 Feb 12 2025 [ 562 00] usb_keyboard.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2820 Feb 12 2025 [ 563 00] usbms.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 952 Feb 12 2025 [ 565 00] usbserial_common.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1004 Feb 12 2025 [ 566 00] usbserial_ftdi.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1056 Feb 12 2025 [ 567 00] usbserial_pl2303.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 612 Feb 12 2025 [ 568 00] usbserial_usbdebug.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1760 Feb 12 2025 [ 569 00] usbtest.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 4160 Feb 12 2025 [ 570 00] vbe.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1300 Feb 12 2025 [ 573 00] verifiers.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1884 Feb 12 2025 [ 574 00] vga.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1004 Feb 12 2025 [ 575 00] vga_text.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 84 Feb 12 2025 [ 576 00] video.lst │ │ │ │ │ --r-xr-xr-x 1 0 0 2300 Feb 12 2025 [ 577 00] video.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2128 Feb 12 2025 [ 579 00] video_bochs.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2348 Feb 12 2025 [ 581 00] video_cirrus.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2232 Feb 12 2025 [ 583 00] video_colors.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 9408 Feb 12 2025 [ 585 00] video_fb.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1656 Feb 12 2025 [ 590 00] videoinfo.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1648 Feb 12 2025 [ 591 00] videotest.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 892 Feb 12 2025 [ 592 00] videotest_checksum.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 724 Feb 12 2025 [ 593 00] wrmsr.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 3708 Feb 12 2025 [ 594 00] xfs.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 11368 Feb 12 2025 [ 596 00] xnu.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 972 Feb 12 2025 [ 602 00] xnu_uuid.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 808 Feb 12 2025 [ 603 00] xnu_uuid_test.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 8032 Feb 12 2025 [ 604 00] xzio.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 19000 Feb 12 2025 [ 608 00] zfs.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2700 Feb 12 2025 [ 618 00] zfscrypt.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2548 Feb 12 2025 [ 620 00] zfsinfo.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 19332 Feb 12 2025 [ 622 00] zstd.mod │ │ │ │ │ +dr-xr-xr-x 1 0 0 38912 Jan 11 2024 [ 24 02] . │ │ │ │ │ +dr-xr-xr-x 1 0 0 2048 Jan 11 2024 [ 22 02] .. │ │ │ │ │ +-r-xr-xr-x 1 0 0 3520 Jan 11 2024 [ 50 00] 915resolution.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 4404 Jan 11 2024 [ 52 00] acpi.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 548 Jan 11 2024 [ 55 00] adler32.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2636 Jan 11 2024 [ 56 00] affs.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 3176 Jan 11 2024 [ 58 00] afs.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 832 Jan 11 2024 [ 60 00] afsplitter.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 4920 Jan 11 2024 [ 61 00] ahci.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 236 Jan 11 2024 [ 64 00] all_video.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 496 Jan 11 2024 [ 65 00] aout.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1540 Jan 11 2024 [ 66 00] archelp.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2004 Jan 11 2024 [ 67 00] at_keyboard.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2672 Jan 11 2024 [ 68 00] ata.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 748 Jan 11 2024 [ 70 00] backtrace.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 3580 Jan 11 2024 [ 71 00] bfs.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2496 Jan 11 2024 [ 73 00] biosdisk.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1128 Jan 11 2024 [ 75 00] bitmap.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2020 Jan 11 2024 [ 76 00] bitmap_scale.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1068 Jan 11 2024 [ 77 00] blocklist.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1180 Jan 11 2024 [ 78 00] boot.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 12244 Jan 11 2024 [ 79 00] bsd.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1020 Jan 11 2024 [ 85 00] bswap_test.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 9152 Jan 11 2024 [ 86 00] btrfs.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1040 Jan 11 2024 [ 91 00] bufio.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1348 Jan 11 2024 [ 92 00] cat.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1860 Jan 11 2024 [ 93 00] cbfs.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1180 Jan 11 2024 [ 94 00] cbls.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 976 Jan 11 2024 [ 95 00] cbmemc.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 536 Jan 11 2024 [ 96 00] cbtable.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1112 Jan 11 2024 [ 97 00] cbtime.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1596 Jan 11 2024 [ 98 00] chain.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1160 Jan 11 2024 [ 99 00] cmdline_cat_test.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 580 Jan 11 2024 [ 100 00] cmosdump.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 812 Jan 11 2024 [ 101 00] cmostest.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 968 Jan 11 2024 [ 102 00] cmp.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1780 Jan 11 2024 [ 103 00] cmp_test.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1456 Jan 11 2024 [ 104 00] command.lst │ │ │ │ │ +-r-xr-xr-x 1 0 0 840 Jan 11 2024 [ 105 00] configfile.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1272 Jan 11 2024 [ 106 00] cpio.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1300 Jan 11 2024 [ 107 00] cpio_be.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 728 Jan 11 2024 [ 108 00] cpuid.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 800 Jan 11 2024 [ 109 00] crc64.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 416 Jan 11 2024 [ 110 00] crypto.lst │ │ │ │ │ +-r-xr-xr-x 1 0 0 2344 Jan 11 2024 [ 111 00] crypto.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 5476 Jan 11 2024 [ 113 00] cryptodisk.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1480 Jan 11 2024 [ 116 00] cs5536.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 816 Jan 11 2024 [ 117 00] ctz_test.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1040 Jan 11 2024 [ 118 00] date.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 700 Jan 11 2024 [ 119 00] datehook.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1252 Jan 11 2024 [ 120 00] datetime.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1300 Jan 11 2024 [ 121 00] disk.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 5340 Jan 11 2024 [ 122 00] diskfilter.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 508 Jan 11 2024 [ 125 00] div.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2216 Jan 11 2024 [ 126 00] div_test.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 852 Jan 11 2024 [ 128 00] dm_nv.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2396 Jan 11 2024 [ 129 00] drivemap.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 888 Jan 11 2024 [ 131 00] echo.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 9464 Jan 11 2024 [ 132 00] efiemu.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 3184 Jan 11 2024 [ 137 00] efiemu32.o │ │ │ │ │ +-r-xr-xr-x 1 0 0 3424 Jan 11 2024 [ 139 00] efiemu64.o │ │ │ │ │ +-r-xr-xr-x 1 0 0 6044 Jan 11 2024 [ 141 00] ehci.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1888 Jan 11 2024 [ 144 00] elf.mod │ │ │ │ │ +-r--r--r-- 1 0 0 46703 Jan 11 2024 [ 145 00] eltorito.img │ │ │ │ │ +-r-xr-xr-x 1 0 0 652 Jan 11 2024 [ 168 00] eval.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 3428 Jan 11 2024 [ 169 00] exfat.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 556 Jan 11 2024 [ 171 00] exfctest.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 3196 Jan 11 2024 [ 172 00] ext2.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2440 Jan 11 2024 [ 174 00] extcmd.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 3380 Jan 11 2024 [ 176 00] f2fs.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 3648 Jan 11 2024 [ 178 00] fat.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 5704 Jan 11 2024 [ 180 00] file.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 6508 Jan 11 2024 [ 183 00] font.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1160 Jan 11 2024 [ 187 00] freedos.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 204 Jan 11 2024 [ 188 00] fs.lst │ │ │ │ │ +-r-xr-xr-x 1 0 0 1756 Jan 11 2024 [ 189 00] fshelp.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 8464 Jan 11 2024 [ 190 00] functional_test.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 780 Jan 11 2024 [ 195 00] gcry_arcfour.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 5500 Jan 11 2024 [ 196 00] gcry_blowfish.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 8424 Jan 11 2024 [ 199 00] gcry_camellia.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 10640 Jan 11 2024 [ 204 00] gcry_cast5.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 8624 Jan 11 2024 [ 210 00] gcry_crc.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 4064 Jan 11 2024 [ 215 00] gcry_des.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 936 Jan 11 2024 [ 217 00] gcry_dsa.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1512 Jan 11 2024 [ 218 00] gcry_idea.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1448 Jan 11 2024 [ 219 00] gcry_md4.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1832 Jan 11 2024 [ 220 00] gcry_md5.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1344 Jan 11 2024 [ 221 00] gcry_rfc2268.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 7616 Jan 11 2024 [ 222 00] gcry_rijndael.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2736 Jan 11 2024 [ 226 00] gcry_rmd160.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 880 Jan 11 2024 [ 228 00] gcry_rsa.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 4472 Jan 11 2024 [ 229 00] gcry_seed.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 5604 Jan 11 2024 [ 232 00] gcry_serpent.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 3176 Jan 11 2024 [ 235 00] gcry_sha1.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2088 Jan 11 2024 [ 237 00] gcry_sha256.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 3264 Jan 11 2024 [ 239 00] gcry_sha512.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 10260 Jan 11 2024 [ 241 00] gcry_tiger.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 9828 Jan 11 2024 [ 247 00] gcry_twofish.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 6100 Jan 11 2024 [ 252 00] gcry_whirlpool.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 3752 Jan 11 2024 [ 255 00] gdb.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2656 Jan 11 2024 [ 257 00] geli.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2128 Jan 11 2024 [ 259 00] gettext.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 15640 Jan 11 2024 [ 261 00] gfxmenu.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 3884 Jan 11 2024 [ 269 00] gfxterm.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1128 Jan 11 2024 [ 271 00] gfxterm_background.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1848 Jan 11 2024 [ 272 00] gfxterm_menu.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1800 Jan 11 2024 [ 273 00] gptsync.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 4524 Jan 11 2024 [ 274 00] gzio.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2196 Jan 11 2024 [ 277 00] halt.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2124 Jan 11 2024 [ 279 00] hashsum.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2916 Jan 11 2024 [ 281 00] hdparm.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 492 Jan 11 2024 [ 283 00] hello.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1216 Jan 11 2024 [ 284 00] help.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1508 Jan 11 2024 [ 285 00] hexdump.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 3788 Jan 11 2024 [ 286 00] hfs.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 4016 Jan 11 2024 [ 288 00] hfsplus.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1536 Jan 11 2024 [ 290 00] hfspluscomp.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2656 Jan 11 2024 [ 291 00] http.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1164 Jan 11 2024 [ 293 00] hwmatch.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1152 Jan 11 2024 [ 294 00] iorw.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 4324 Jan 11 2024 [ 295 00] iso9660.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 3332 Jan 11 2024 [ 298 00] jfs.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 3940 Jan 11 2024 [ 300 00] jpeg.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2028 Jan 11 2024 [ 302 00] json.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1416 Jan 11 2024 [ 303 00] keylayouts.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 780 Jan 11 2024 [ 304 00] keystatus.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2872 Jan 11 2024 [ 305 00] ldm.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 908 Jan 11 2024 [ 307 00] legacy_password_test.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 11076 Jan 11 2024 [ 308 00] legacycfg.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 6008 Jan 11 2024 [ 314 00] linux.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2612 Jan 11 2024 [ 317 00] linux16.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2804 Jan 11 2024 [ 319 00] loadenv.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1324 Jan 11 2024 [ 321 00] loopback.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1660 Jan 11 2024 [ 322 00] ls.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2068 Jan 11 2024 [ 323 00] lsacpi.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 980 Jan 11 2024 [ 325 00] lsapm.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 804 Jan 11 2024 [ 326 00] lsmmap.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1816 Jan 11 2024 [ 327 00] lspci.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1984 Jan 11 2024 [ 328 00] luks.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 5868 Jan 11 2024 [ 329 00] luks2.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 3896 Jan 11 2024 [ 332 00] lvm.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2608 Jan 11 2024 [ 334 00] lzopio.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1576 Jan 11 2024 [ 336 00] macbless.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 3268 Jan 11 2024 [ 337 00] macho.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 964 Jan 11 2024 [ 339 00] mda_text.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 940 Jan 11 2024 [ 340 00] mdraid09.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 972 Jan 11 2024 [ 341 00] mdraid09_be.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 896 Jan 11 2024 [ 342 00] mdraid1x.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 888 Jan 11 2024 [ 343 00] memdisk.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1152 Jan 11 2024 [ 344 00] memrw.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1544 Jan 11 2024 [ 345 00] minicmd.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2008 Jan 11 2024 [ 346 00] minix.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2064 Jan 11 2024 [ 347 00] minix2.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2132 Jan 11 2024 [ 349 00] minix2_be.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2032 Jan 11 2024 [ 351 00] minix3.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2132 Jan 11 2024 [ 352 00] minix3_be.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2072 Jan 11 2024 [ 354 00] minix_be.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 4176 Jan 11 2024 [ 356 00] mmap.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2116 Jan 11 2024 [ 359 00] moddep.lst │ │ │ │ │ +-r-xr-xr-x 1 0 0 1264 Jan 11 2024 [ 361 00] modinfo.sh │ │ │ │ │ +-r-xr-xr-x 1 0 0 708 Jan 11 2024 [ 362 00] morse.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 12848 Jan 11 2024 [ 363 00] mpi.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1072 Jan 11 2024 [ 370 00] msdospart.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 960 Jan 11 2024 [ 371 00] mul_test.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 6184 Jan 11 2024 [ 372 00] multiboot.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 6628 Jan 11 2024 [ 376 00] multiboot2.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1908 Jan 11 2024 [ 380 00] nativedisk.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 24724 Jan 11 2024 [ 381 00] net.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1396 Jan 11 2024 [ 394 00] newc.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 3356 Jan 11 2024 [ 395 00] nilfs2.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 44536 Jan 11 2024 [ 397 00] normal.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 5748 Jan 11 2024 [ 419 00] ntfs.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2448 Jan 11 2024 [ 422 00] ntfscomp.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1076 Jan 11 2024 [ 424 00] ntldr.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1300 Jan 11 2024 [ 425 00] odc.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 684 Jan 11 2024 [ 426 00] offsetio.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 4456 Jan 11 2024 [ 427 00] ohci.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 816 Jan 11 2024 [ 430 00] part_acorn.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 896 Jan 11 2024 [ 431 00] part_amiga.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 976 Jan 11 2024 [ 432 00] part_apple.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1272 Jan 11 2024 [ 433 00] part_bsd.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 856 Jan 11 2024 [ 434 00] part_dfly.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 704 Jan 11 2024 [ 435 00] part_dvh.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1100 Jan 11 2024 [ 436 00] part_gpt.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1200 Jan 11 2024 [ 437 00] part_msdos.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 828 Jan 11 2024 [ 438 00] part_plan.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 732 Jan 11 2024 [ 439 00] part_sun.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 768 Jan 11 2024 [ 440 00] part_sunpc.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 116 Jan 11 2024 [ 441 00] partmap.lst │ │ │ │ │ +-r-xr-xr-x 1 0 0 68 Jan 11 2024 [ 442 00] parttool.lst │ │ │ │ │ +-r-xr-xr-x 1 0 0 2052 Jan 11 2024 [ 443 00] parttool.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 832 Jan 11 2024 [ 445 00] password.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1288 Jan 11 2024 [ 446 00] password_pbkdf2.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2344 Jan 11 2024 [ 447 00] pata.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 684 Jan 11 2024 [ 449 00] pbkdf2.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 928 Jan 11 2024 [ 450 00] pbkdf2_test.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 720 Jan 11 2024 [ 451 00] pci.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1116 Jan 11 2024 [ 452 00] pcidump.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 4776 Jan 11 2024 [ 453 00] pgp.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 3036 Jan 11 2024 [ 456 00] plan9.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1212 Jan 11 2024 [ 458 00] play.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 4132 Jan 11 2024 [ 459 00] png.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 800 Jan 11 2024 [ 462 00] priority_queue.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1472 Jan 11 2024 [ 463 00] probe.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 956 Jan 11 2024 [ 464 00] procfs.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1096 Jan 11 2024 [ 465 00] progress.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1548 Jan 11 2024 [ 466 00] pxe.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1136 Jan 11 2024 [ 467 00] pxechain.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 696 Jan 11 2024 [ 468 00] raid5rec.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1236 Jan 11 2024 [ 469 00] raid6rec.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1368 Jan 11 2024 [ 470 00] random.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 856 Jan 11 2024 [ 471 00] rdmsr.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 660 Jan 11 2024 [ 472 00] read.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 736 Jan 11 2024 [ 473 00] reboot.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 26876 Jan 11 2024 [ 474 00] regexp.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 4316 Jan 11 2024 [ 488 00] reiserfs.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 6656 Jan 11 2024 [ 491 00] relocator.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2152 Jan 11 2024 [ 495 00] romfs.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2304 Jan 11 2024 [ 497 00] scsi.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1384 Jan 11 2024 [ 499 00] search.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1448 Jan 11 2024 [ 500 00] search_fs_file.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1564 Jan 11 2024 [ 501 00] search_fs_uuid.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1484 Jan 11 2024 [ 502 00] search_label.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2540 Jan 11 2024 [ 503 00] sendkey.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 3176 Jan 11 2024 [ 505 00] serial.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 300 Jan 11 2024 [ 507 00] setjmp.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 676 Jan 11 2024 [ 508 00] setjmp_test.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2148 Jan 11 2024 [ 509 00] setpci.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2596 Jan 11 2024 [ 511 00] sfs.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1124 Jan 11 2024 [ 513 00] shift_test.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 4268 Jan 11 2024 [ 514 00] signature_test.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 912 Jan 11 2024 [ 517 00] sleep.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1104 Jan 11 2024 [ 518 00] sleep_test.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2332 Jan 11 2024 [ 519 00] smbios.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 804 Jan 11 2024 [ 521 00] spkmodem.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 3808 Jan 11 2024 [ 522 00] squash4.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 916 Jan 11 2024 [ 524 00] strtoull_test.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 7216 Jan 11 2024 [ 525 00] syslinuxcfg.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1552 Jan 11 2024 [ 529 00] tar.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 164 Jan 11 2024 [ 530 00] terminal.lst │ │ │ │ │ +-r-xr-xr-x 1 0 0 1792 Jan 11 2024 [ 531 00] terminal.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 5080 Jan 11 2024 [ 532 00] terminfo.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2192 Jan 11 2024 [ 535 00] test.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 576 Jan 11 2024 [ 537 00] test_blockarg.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1240 Jan 11 2024 [ 538 00] testload.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1024 Jan 11 2024 [ 539 00] testspeed.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2176 Jan 11 2024 [ 540 00] tftp.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1796 Jan 11 2024 [ 542 00] tga.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 684 Jan 11 2024 [ 543 00] time.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1076 Jan 11 2024 [ 544 00] tr.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 788 Jan 11 2024 [ 545 00] trig.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 500 Jan 11 2024 [ 546 00] true.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1588 Jan 11 2024 [ 547 00] truecrypt.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 4372 Jan 11 2024 [ 548 00] udf.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2648 Jan 11 2024 [ 551 00] ufs1.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2848 Jan 11 2024 [ 553 00] ufs1_be.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2732 Jan 11 2024 [ 555 00] ufs2.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2976 Jan 11 2024 [ 557 00] uhci.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 5168 Jan 11 2024 [ 559 00] usb.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1796 Jan 11 2024 [ 562 00] usb_keyboard.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2820 Jan 11 2024 [ 563 00] usbms.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 952 Jan 11 2024 [ 565 00] usbserial_common.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1004 Jan 11 2024 [ 566 00] usbserial_ftdi.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1056 Jan 11 2024 [ 567 00] usbserial_pl2303.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 612 Jan 11 2024 [ 568 00] usbserial_usbdebug.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1760 Jan 11 2024 [ 569 00] usbtest.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 4160 Jan 11 2024 [ 570 00] vbe.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1300 Jan 11 2024 [ 573 00] verifiers.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1884 Jan 11 2024 [ 574 00] vga.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1004 Jan 11 2024 [ 575 00] vga_text.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 84 Jan 11 2024 [ 576 00] video.lst │ │ │ │ │ +-r-xr-xr-x 1 0 0 2300 Jan 11 2024 [ 577 00] video.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2128 Jan 11 2024 [ 579 00] video_bochs.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2348 Jan 11 2024 [ 581 00] video_cirrus.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2232 Jan 11 2024 [ 583 00] video_colors.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 9408 Jan 11 2024 [ 585 00] video_fb.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1656 Jan 11 2024 [ 590 00] videoinfo.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1648 Jan 11 2024 [ 591 00] videotest.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 892 Jan 11 2024 [ 592 00] videotest_checksum.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 724 Jan 11 2024 [ 593 00] wrmsr.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 3708 Jan 11 2024 [ 594 00] xfs.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 11368 Jan 11 2024 [ 596 00] xnu.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 972 Jan 11 2024 [ 602 00] xnu_uuid.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 808 Jan 11 2024 [ 603 00] xnu_uuid_test.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 8032 Jan 11 2024 [ 604 00] xzio.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 19000 Jan 11 2024 [ 608 00] zfs.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2700 Jan 11 2024 [ 618 00] zfscrypt.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2548 Jan 11 2024 [ 620 00] zfsinfo.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 19332 Jan 11 2024 [ 622 00] zstd.mod │ │ │ │ │ │ │ │ │ │ Directory listing of /boot/grub/locale/ │ │ │ │ │ -dr-xr-xr-x 1 0 0 2048 Feb 12 2025 [ 43 02] . │ │ │ │ │ -dr-xr-xr-x 1 0 0 2048 Feb 12 2025 [ 22 02] .. │ │ │ │ │ +dr-xr-xr-x 1 0 0 2048 Jan 11 2024 [ 43 02] . │ │ │ │ │ +dr-xr-xr-x 1 0 0 2048 Jan 11 2024 [ 22 02] .. │ │ │ │ │ │ │ │ │ │ Directory listing of /boot/grub/roms/ │ │ │ │ │ -dr-xr-xr-x 1 0 0 2048 Feb 12 2025 [ 44 02] . │ │ │ │ │ -dr-xr-xr-x 1 0 0 2048 Feb 12 2025 [ 22 02] .. │ │ │ │ │ +dr-xr-xr-x 1 0 0 2048 Jan 11 2024 [ 44 02] . │ │ │ │ │ +dr-xr-xr-x 1 0 0 2048 Jan 11 2024 [ 22 02] .. │ │ │ │ ├── file list │ │ │ │ │ @@ -1,296 +1,296 @@ │ │ │ │ │ -dr-xr-xr-x 3 0 0 2048 2025-02-12 10:55:46.000000 . │ │ │ │ │ -dr-xr-xr-x 3 0 0 2048 2025-02-12 10:55:47.000000 boot │ │ │ │ │ -dr-xr-xr-x 6 0 0 2048 2025-02-12 10:55:51.000000 boot/grub │ │ │ │ │ -dr-xr-xr-x 2 0 0 2048 2025-02-12 10:55:51.000000 boot/grub/fonts │ │ │ │ │ -dr-xr-xr-x 2 0 0 38912 2025-02-12 10:55:51.000000 boot/grub/i386-pc │ │ │ │ │ -dr-xr-xr-x 2 0 0 2048 2025-02-12 10:55:47.000000 boot/grub/locale │ │ │ │ │ -dr-xr-xr-x 2 0 0 2048 2025-02-12 10:55:47.000000 boot/grub/roms │ │ │ │ │ --r--r--r-- 1 0 0 2048 2025-02-12 10:55:51.000000 boot.catalog │ │ │ │ │ --r--r--r-- 1 0 0 1705 2025-02-12 10:55:46.000000 boot/grub/grub.cfg │ │ │ │ │ --r-xr-xr-x 1 0 0 3520 2025-02-12 10:55:47.000000 boot/grub/i386-pc/915resolution.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 4404 2025-02-12 10:55:50.000000 boot/grub/i386-pc/acpi.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 548 2025-02-12 10:55:47.000000 boot/grub/i386-pc/adler32.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2636 2025-02-12 10:55:49.000000 boot/grub/i386-pc/affs.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 3176 2025-02-12 10:55:49.000000 boot/grub/i386-pc/afs.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 832 2025-02-12 10:55:49.000000 boot/grub/i386-pc/afsplitter.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 4920 2025-02-12 10:55:49.000000 boot/grub/i386-pc/ahci.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 236 2025-02-12 10:55:47.000000 boot/grub/i386-pc/all_video.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 496 2025-02-12 10:55:48.000000 boot/grub/i386-pc/aout.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1540 2025-02-12 10:55:49.000000 boot/grub/i386-pc/archelp.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2004 2025-02-12 10:55:47.000000 boot/grub/i386-pc/at_keyboard.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2672 2025-02-12 10:55:49.000000 boot/grub/i386-pc/ata.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 748 2025-02-12 10:55:47.000000 boot/grub/i386-pc/backtrace.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 3580 2025-02-12 10:55:49.000000 boot/grub/i386-pc/bfs.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2496 2025-02-12 10:55:49.000000 boot/grub/i386-pc/biosdisk.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1128 2025-02-12 10:55:47.000000 boot/grub/i386-pc/bitmap.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2020 2025-02-12 10:55:47.000000 boot/grub/i386-pc/bitmap_scale.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1068 2025-02-12 10:55:50.000000 boot/grub/i386-pc/blocklist.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1180 2025-02-12 10:55:50.000000 boot/grub/i386-pc/boot.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 12244 2025-02-12 10:55:48.000000 boot/grub/i386-pc/bsd.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1020 2025-02-12 10:55:47.000000 boot/grub/i386-pc/bswap_test.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 9152 2025-02-12 10:55:49.000000 boot/grub/i386-pc/btrfs.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1040 2025-02-12 10:55:48.000000 boot/grub/i386-pc/bufio.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1348 2025-02-12 10:55:50.000000 boot/grub/i386-pc/cat.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1860 2025-02-12 10:55:49.000000 boot/grub/i386-pc/cbfs.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1180 2025-02-12 10:55:50.000000 boot/grub/i386-pc/cbls.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 976 2025-02-12 10:55:50.000000 boot/grub/i386-pc/cbmemc.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 536 2025-02-12 10:55:50.000000 boot/grub/i386-pc/cbtable.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1112 2025-02-12 10:55:50.000000 boot/grub/i386-pc/cbtime.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1596 2025-02-12 10:55:48.000000 boot/grub/i386-pc/chain.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1160 2025-02-12 10:55:47.000000 boot/grub/i386-pc/cmdline_cat_test.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 580 2025-02-12 10:55:50.000000 boot/grub/i386-pc/cmosdump.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 812 2025-02-12 10:55:50.000000 boot/grub/i386-pc/cmostest.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 968 2025-02-12 10:55:50.000000 boot/grub/i386-pc/cmp.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1780 2025-02-12 10:55:47.000000 boot/grub/i386-pc/cmp_test.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1456 2025-02-12 10:55:51.000000 boot/grub/i386-pc/command.lst │ │ │ │ │ --r-xr-xr-x 1 0 0 840 2025-02-12 10:55:50.000000 boot/grub/i386-pc/configfile.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1272 2025-02-12 10:55:49.000000 boot/grub/i386-pc/cpio.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1300 2025-02-12 10:55:49.000000 boot/grub/i386-pc/cpio_be.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 728 2025-02-12 10:55:50.000000 boot/grub/i386-pc/cpuid.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 800 2025-02-12 10:55:47.000000 boot/grub/i386-pc/crc64.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 416 2025-02-12 10:55:51.000000 boot/grub/i386-pc/crypto.lst │ │ │ │ │ --r-xr-xr-x 1 0 0 2344 2025-02-12 10:55:48.000000 boot/grub/i386-pc/crypto.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 5476 2025-02-12 10:55:49.000000 boot/grub/i386-pc/cryptodisk.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1480 2025-02-12 10:55:51.000000 boot/grub/i386-pc/cs5536.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 816 2025-02-12 10:55:47.000000 boot/grub/i386-pc/ctz_test.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1040 2025-02-12 10:55:50.000000 boot/grub/i386-pc/date.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 700 2025-02-12 10:55:47.000000 boot/grub/i386-pc/datehook.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1252 2025-02-12 10:55:48.000000 boot/grub/i386-pc/datetime.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1300 2025-02-12 10:55:51.000000 boot/grub/i386-pc/disk.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 5340 2025-02-12 10:55:49.000000 boot/grub/i386-pc/diskfilter.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 508 2025-02-12 10:55:47.000000 boot/grub/i386-pc/div.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2216 2025-02-12 10:55:47.000000 boot/grub/i386-pc/div_test.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 852 2025-02-12 10:55:49.000000 boot/grub/i386-pc/dm_nv.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2396 2025-02-12 10:55:50.000000 boot/grub/i386-pc/drivemap.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 888 2025-02-12 10:55:50.000000 boot/grub/i386-pc/echo.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 9464 2025-02-12 10:55:49.000000 boot/grub/i386-pc/efiemu.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 3184 2025-02-12 10:55:51.000000 boot/grub/i386-pc/efiemu32.o │ │ │ │ │ --r-xr-xr-x 1 0 0 3424 2025-02-12 10:55:51.000000 boot/grub/i386-pc/efiemu64.o │ │ │ │ │ --r-xr-xr-x 1 0 0 6044 2025-02-12 10:55:51.000000 boot/grub/i386-pc/ehci.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1888 2025-02-12 10:55:48.000000 boot/grub/i386-pc/elf.mod │ │ │ │ │ --r--r--r-- 1 0 0 46703 2025-02-12 10:55:51.000000 boot/grub/i386-pc/eltorito.img │ │ │ │ │ --r-xr-xr-x 1 0 0 652 2025-02-12 10:55:50.000000 boot/grub/i386-pc/eval.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 3428 2025-02-12 10:55:49.000000 boot/grub/i386-pc/exfat.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 556 2025-02-12 10:55:47.000000 boot/grub/i386-pc/exfctest.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 3196 2025-02-12 10:55:49.000000 boot/grub/i386-pc/ext2.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2440 2025-02-12 10:55:50.000000 boot/grub/i386-pc/extcmd.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 3380 2025-02-12 10:55:49.000000 boot/grub/i386-pc/f2fs.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 3648 2025-02-12 10:55:49.000000 boot/grub/i386-pc/fat.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 5704 2025-02-12 10:55:47.000000 boot/grub/i386-pc/file.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 6508 2025-02-12 10:55:49.000000 boot/grub/i386-pc/font.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1160 2025-02-12 10:55:48.000000 boot/grub/i386-pc/freedos.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 204 2025-02-12 10:55:51.000000 boot/grub/i386-pc/fs.lst │ │ │ │ │ --r-xr-xr-x 1 0 0 1756 2025-02-12 10:55:49.000000 boot/grub/i386-pc/fshelp.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 8464 2025-02-12 10:55:47.000000 boot/grub/i386-pc/functional_test.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 780 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gcry_arcfour.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 5500 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gcry_blowfish.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 8424 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gcry_camellia.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 10640 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gcry_cast5.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 8624 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gcry_crc.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 4064 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gcry_des.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 936 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gcry_dsa.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1512 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gcry_idea.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1448 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gcry_md4.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1832 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gcry_md5.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1344 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gcry_rfc2268.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 7616 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gcry_rijndael.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2736 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gcry_rmd160.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 880 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gcry_rsa.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 4472 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gcry_seed.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 5604 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gcry_serpent.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 3176 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gcry_sha1.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2088 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gcry_sha256.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 3264 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gcry_sha512.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 10260 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gcry_tiger.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 9828 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gcry_twofish.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 6100 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gcry_whirlpool.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 3752 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gdb.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2656 2025-02-12 10:55:49.000000 boot/grub/i386-pc/geli.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2128 2025-02-12 10:55:48.000000 boot/grub/i386-pc/gettext.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 15640 2025-02-12 10:55:48.000000 boot/grub/i386-pc/gfxmenu.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 3884 2025-02-12 10:55:48.000000 boot/grub/i386-pc/gfxterm.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1128 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gfxterm_background.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1848 2025-02-12 10:55:47.000000 boot/grub/i386-pc/gfxterm_menu.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1800 2025-02-12 10:55:50.000000 boot/grub/i386-pc/gptsync.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 4524 2025-02-12 10:55:48.000000 boot/grub/i386-pc/gzio.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2196 2025-02-12 10:55:50.000000 boot/grub/i386-pc/halt.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2124 2025-02-12 10:55:50.000000 boot/grub/i386-pc/hashsum.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2916 2025-02-12 10:55:50.000000 boot/grub/i386-pc/hdparm.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 492 2025-02-12 10:55:48.000000 boot/grub/i386-pc/hello.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1216 2025-02-12 10:55:50.000000 boot/grub/i386-pc/help.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1508 2025-02-12 10:55:50.000000 boot/grub/i386-pc/hexdump.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 3788 2025-02-12 10:55:49.000000 boot/grub/i386-pc/hfs.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 4016 2025-02-12 10:55:49.000000 boot/grub/i386-pc/hfsplus.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1536 2025-02-12 10:55:49.000000 boot/grub/i386-pc/hfspluscomp.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2656 2025-02-12 10:55:47.000000 boot/grub/i386-pc/http.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1164 2025-02-12 10:55:50.000000 boot/grub/i386-pc/hwmatch.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1152 2025-02-12 10:55:50.000000 boot/grub/i386-pc/iorw.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 4324 2025-02-12 10:55:49.000000 boot/grub/i386-pc/iso9660.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 3332 2025-02-12 10:55:49.000000 boot/grub/i386-pc/jfs.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 3940 2025-02-12 10:55:47.000000 boot/grub/i386-pc/jpeg.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2028 2025-02-12 10:55:49.000000 boot/grub/i386-pc/json.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1416 2025-02-12 10:55:47.000000 boot/grub/i386-pc/keylayouts.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 780 2025-02-12 10:55:50.000000 boot/grub/i386-pc/keystatus.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2872 2025-02-12 10:55:49.000000 boot/grub/i386-pc/ldm.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 908 2025-02-12 10:55:47.000000 boot/grub/i386-pc/legacy_password_test.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 11076 2025-02-12 10:55:47.000000 boot/grub/i386-pc/legacycfg.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 6008 2025-02-12 10:55:48.000000 boot/grub/i386-pc/linux.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2612 2025-02-12 10:55:48.000000 boot/grub/i386-pc/linux16.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2804 2025-02-12 10:55:50.000000 boot/grub/i386-pc/loadenv.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1324 2025-02-12 10:55:49.000000 boot/grub/i386-pc/loopback.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1660 2025-02-12 10:55:50.000000 boot/grub/i386-pc/ls.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2068 2025-02-12 10:55:50.000000 boot/grub/i386-pc/lsacpi.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 980 2025-02-12 10:55:47.000000 boot/grub/i386-pc/lsapm.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 804 2025-02-12 10:55:50.000000 boot/grub/i386-pc/lsmmap.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1816 2025-02-12 10:55:50.000000 boot/grub/i386-pc/lspci.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1984 2025-02-12 10:55:49.000000 boot/grub/i386-pc/luks.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 5868 2025-02-12 10:55:49.000000 boot/grub/i386-pc/luks2.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 3896 2025-02-12 10:55:49.000000 boot/grub/i386-pc/lvm.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2608 2025-02-12 10:55:47.000000 boot/grub/i386-pc/lzopio.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1576 2025-02-12 10:55:48.000000 boot/grub/i386-pc/macbless.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 3268 2025-02-12 10:55:48.000000 boot/grub/i386-pc/macho.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 964 2025-02-12 10:55:47.000000 boot/grub/i386-pc/mda_text.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 940 2025-02-12 10:55:49.000000 boot/grub/i386-pc/mdraid09.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 972 2025-02-12 10:55:49.000000 boot/grub/i386-pc/mdraid09_be.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 896 2025-02-12 10:55:49.000000 boot/grub/i386-pc/mdraid1x.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 888 2025-02-12 10:55:49.000000 boot/grub/i386-pc/memdisk.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1152 2025-02-12 10:55:50.000000 boot/grub/i386-pc/memrw.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1544 2025-02-12 10:55:50.000000 boot/grub/i386-pc/minicmd.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2008 2025-02-12 10:55:49.000000 boot/grub/i386-pc/minix.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2064 2025-02-12 10:55:49.000000 boot/grub/i386-pc/minix2.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2132 2025-02-12 10:55:49.000000 boot/grub/i386-pc/minix2_be.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2032 2025-02-12 10:55:49.000000 boot/grub/i386-pc/minix3.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2132 2025-02-12 10:55:49.000000 boot/grub/i386-pc/minix3_be.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2072 2025-02-12 10:55:49.000000 boot/grub/i386-pc/minix_be.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 4176 2025-02-12 10:55:48.000000 boot/grub/i386-pc/mmap.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2116 2025-02-12 10:55:51.000000 boot/grub/i386-pc/moddep.lst │ │ │ │ │ --r-xr-xr-x 1 0 0 1264 2025-02-12 10:55:51.000000 boot/grub/i386-pc/modinfo.sh │ │ │ │ │ --r-xr-xr-x 1 0 0 708 2025-02-12 10:55:50.000000 boot/grub/i386-pc/morse.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 12848 2025-02-12 10:55:47.000000 boot/grub/i386-pc/mpi.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1072 2025-02-12 10:55:48.000000 boot/grub/i386-pc/msdospart.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 960 2025-02-12 10:55:47.000000 boot/grub/i386-pc/mul_test.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 6184 2025-02-12 10:55:48.000000 boot/grub/i386-pc/multiboot.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 6628 2025-02-12 10:55:48.000000 boot/grub/i386-pc/multiboot2.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1908 2025-02-12 10:55:50.000000 boot/grub/i386-pc/nativedisk.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 24724 2025-02-12 10:55:47.000000 boot/grub/i386-pc/net.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1396 2025-02-12 10:55:49.000000 boot/grub/i386-pc/newc.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 3356 2025-02-12 10:55:49.000000 boot/grub/i386-pc/nilfs2.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 44536 2025-02-12 10:55:48.000000 boot/grub/i386-pc/normal.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 5748 2025-02-12 10:55:49.000000 boot/grub/i386-pc/ntfs.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2448 2025-02-12 10:55:49.000000 boot/grub/i386-pc/ntfscomp.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1076 2025-02-12 10:55:48.000000 boot/grub/i386-pc/ntldr.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1300 2025-02-12 10:55:49.000000 boot/grub/i386-pc/odc.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 684 2025-02-12 10:55:48.000000 boot/grub/i386-pc/offsetio.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 4456 2025-02-12 10:55:50.000000 boot/grub/i386-pc/ohci.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 816 2025-02-12 10:55:48.000000 boot/grub/i386-pc/part_acorn.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 896 2025-02-12 10:55:48.000000 boot/grub/i386-pc/part_amiga.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 976 2025-02-12 10:55:48.000000 boot/grub/i386-pc/part_apple.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1272 2025-02-12 10:55:48.000000 boot/grub/i386-pc/part_bsd.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 856 2025-02-12 10:55:48.000000 boot/grub/i386-pc/part_dfly.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 704 2025-02-12 10:55:48.000000 boot/grub/i386-pc/part_dvh.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1100 2025-02-12 10:55:48.000000 boot/grub/i386-pc/part_gpt.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1200 2025-02-12 10:55:48.000000 boot/grub/i386-pc/part_msdos.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 828 2025-02-12 10:55:48.000000 boot/grub/i386-pc/part_plan.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 732 2025-02-12 10:55:48.000000 boot/grub/i386-pc/part_sun.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 768 2025-02-12 10:55:48.000000 boot/grub/i386-pc/part_sunpc.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 116 2025-02-12 10:55:51.000000 boot/grub/i386-pc/partmap.lst │ │ │ │ │ --r-xr-xr-x 1 0 0 68 2025-02-12 10:55:51.000000 boot/grub/i386-pc/parttool.lst │ │ │ │ │ --r-xr-xr-x 1 0 0 2052 2025-02-12 10:55:50.000000 boot/grub/i386-pc/parttool.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 832 2025-02-12 10:55:50.000000 boot/grub/i386-pc/password.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1288 2025-02-12 10:55:50.000000 boot/grub/i386-pc/password_pbkdf2.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2344 2025-02-12 10:55:49.000000 boot/grub/i386-pc/pata.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 684 2025-02-12 10:55:48.000000 boot/grub/i386-pc/pbkdf2.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 928 2025-02-12 10:55:47.000000 boot/grub/i386-pc/pbkdf2_test.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 720 2025-02-12 10:55:50.000000 boot/grub/i386-pc/pci.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1116 2025-02-12 10:55:50.000000 boot/grub/i386-pc/pcidump.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 4776 2025-02-12 10:55:50.000000 boot/grub/i386-pc/pgp.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 3036 2025-02-12 10:55:48.000000 boot/grub/i386-pc/plan9.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1212 2025-02-12 10:55:50.000000 boot/grub/i386-pc/play.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 4132 2025-02-12 10:55:47.000000 boot/grub/i386-pc/png.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 800 2025-02-12 10:55:47.000000 boot/grub/i386-pc/priority_queue.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1472 2025-02-12 10:55:50.000000 boot/grub/i386-pc/probe.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 956 2025-02-12 10:55:49.000000 boot/grub/i386-pc/procfs.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1096 2025-02-12 10:55:47.000000 boot/grub/i386-pc/progress.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1548 2025-02-12 10:55:48.000000 boot/grub/i386-pc/pxe.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1136 2025-02-12 10:55:48.000000 boot/grub/i386-pc/pxechain.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 696 2025-02-12 10:55:49.000000 boot/grub/i386-pc/raid5rec.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1236 2025-02-12 10:55:49.000000 boot/grub/i386-pc/raid6rec.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1368 2025-02-12 10:55:48.000000 boot/grub/i386-pc/random.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 856 2025-02-12 10:55:47.000000 boot/grub/i386-pc/rdmsr.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 660 2025-02-12 10:55:50.000000 boot/grub/i386-pc/read.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 736 2025-02-12 10:55:50.000000 boot/grub/i386-pc/reboot.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 26876 2025-02-12 10:55:50.000000 boot/grub/i386-pc/regexp.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 4316 2025-02-12 10:55:49.000000 boot/grub/i386-pc/reiserfs.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 6656 2025-02-12 10:55:48.000000 boot/grub/i386-pc/relocator.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2152 2025-02-12 10:55:49.000000 boot/grub/i386-pc/romfs.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2304 2025-02-12 10:55:49.000000 boot/grub/i386-pc/scsi.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1384 2025-02-12 10:55:50.000000 boot/grub/i386-pc/search.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1448 2025-02-12 10:55:50.000000 boot/grub/i386-pc/search_fs_file.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1564 2025-02-12 10:55:50.000000 boot/grub/i386-pc/search_fs_uuid.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1484 2025-02-12 10:55:50.000000 boot/grub/i386-pc/search_label.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2540 2025-02-12 10:55:47.000000 boot/grub/i386-pc/sendkey.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 3176 2025-02-12 10:55:47.000000 boot/grub/i386-pc/serial.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 300 2025-02-12 10:55:48.000000 boot/grub/i386-pc/setjmp.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 676 2025-02-12 10:55:47.000000 boot/grub/i386-pc/setjmp_test.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2148 2025-02-12 10:55:50.000000 boot/grub/i386-pc/setpci.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2596 2025-02-12 10:55:49.000000 boot/grub/i386-pc/sfs.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1124 2025-02-12 10:55:47.000000 boot/grub/i386-pc/shift_test.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 4268 2025-02-12 10:55:47.000000 boot/grub/i386-pc/signature_test.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 912 2025-02-12 10:55:50.000000 boot/grub/i386-pc/sleep.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1104 2025-02-12 10:55:47.000000 boot/grub/i386-pc/sleep_test.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2332 2025-02-12 10:55:50.000000 boot/grub/i386-pc/smbios.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 804 2025-02-12 10:55:50.000000 boot/grub/i386-pc/spkmodem.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 3808 2025-02-12 10:55:48.000000 boot/grub/i386-pc/squash4.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 916 2025-02-12 10:55:47.000000 boot/grub/i386-pc/strtoull_test.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 7216 2025-02-12 10:55:47.000000 boot/grub/i386-pc/syslinuxcfg.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1552 2025-02-12 10:55:48.000000 boot/grub/i386-pc/tar.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 164 2025-02-12 10:55:51.000000 boot/grub/i386-pc/terminal.lst │ │ │ │ │ --r-xr-xr-x 1 0 0 1792 2025-02-12 10:55:50.000000 boot/grub/i386-pc/terminal.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 5080 2025-02-12 10:55:47.000000 boot/grub/i386-pc/terminfo.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2192 2025-02-12 10:55:49.000000 boot/grub/i386-pc/test.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 576 2025-02-12 10:55:47.000000 boot/grub/i386-pc/test_blockarg.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1240 2025-02-12 10:55:47.000000 boot/grub/i386-pc/testload.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1024 2025-02-12 10:55:47.000000 boot/grub/i386-pc/testspeed.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2176 2025-02-12 10:55:47.000000 boot/grub/i386-pc/tftp.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1796 2025-02-12 10:55:47.000000 boot/grub/i386-pc/tga.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 684 2025-02-12 10:55:47.000000 boot/grub/i386-pc/time.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1076 2025-02-12 10:55:47.000000 boot/grub/i386-pc/tr.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 788 2025-02-12 10:55:51.000000 boot/grub/i386-pc/trig.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 500 2025-02-12 10:55:49.000000 boot/grub/i386-pc/true.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1588 2025-02-12 10:55:48.000000 boot/grub/i386-pc/truecrypt.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 4372 2025-02-12 10:55:48.000000 boot/grub/i386-pc/udf.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2648 2025-02-12 10:55:48.000000 boot/grub/i386-pc/ufs1.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2848 2025-02-12 10:55:48.000000 boot/grub/i386-pc/ufs1_be.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2732 2025-02-12 10:55:48.000000 boot/grub/i386-pc/ufs2.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2976 2025-02-12 10:55:50.000000 boot/grub/i386-pc/uhci.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 5168 2025-02-12 10:55:51.000000 boot/grub/i386-pc/usb.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1796 2025-02-12 10:55:47.000000 boot/grub/i386-pc/usb_keyboard.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2820 2025-02-12 10:55:49.000000 boot/grub/i386-pc/usbms.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 952 2025-02-12 10:55:51.000000 boot/grub/i386-pc/usbserial_common.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1004 2025-02-12 10:55:51.000000 boot/grub/i386-pc/usbserial_ftdi.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1056 2025-02-12 10:55:51.000000 boot/grub/i386-pc/usbserial_pl2303.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 612 2025-02-12 10:55:50.000000 boot/grub/i386-pc/usbserial_usbdebug.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1760 2025-02-12 10:55:49.000000 boot/grub/i386-pc/usbtest.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 4160 2025-02-12 10:55:47.000000 boot/grub/i386-pc/vbe.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1300 2025-02-12 10:55:50.000000 boot/grub/i386-pc/verifiers.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1884 2025-02-12 10:55:47.000000 boot/grub/i386-pc/vga.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1004 2025-02-12 10:55:47.000000 boot/grub/i386-pc/vga_text.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 84 2025-02-12 10:55:51.000000 boot/grub/i386-pc/video.lst │ │ │ │ │ --r-xr-xr-x 1 0 0 2300 2025-02-12 10:55:47.000000 boot/grub/i386-pc/video.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2128 2025-02-12 10:55:47.000000 boot/grub/i386-pc/video_bochs.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2348 2025-02-12 10:55:47.000000 boot/grub/i386-pc/video_cirrus.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2232 2025-02-12 10:55:47.000000 boot/grub/i386-pc/video_colors.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 9408 2025-02-12 10:55:47.000000 boot/grub/i386-pc/video_fb.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1656 2025-02-12 10:55:50.000000 boot/grub/i386-pc/videoinfo.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 1648 2025-02-12 10:55:49.000000 boot/grub/i386-pc/videotest.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 892 2025-02-12 10:55:47.000000 boot/grub/i386-pc/videotest_checksum.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 724 2025-02-12 10:55:47.000000 boot/grub/i386-pc/wrmsr.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 3708 2025-02-12 10:55:48.000000 boot/grub/i386-pc/xfs.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 11368 2025-02-12 10:55:48.000000 boot/grub/i386-pc/xnu.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 972 2025-02-12 10:55:49.000000 boot/grub/i386-pc/xnu_uuid.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 808 2025-02-12 10:55:47.000000 boot/grub/i386-pc/xnu_uuid_test.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 8032 2025-02-12 10:55:47.000000 boot/grub/i386-pc/xzio.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 19000 2025-02-12 10:55:48.000000 boot/grub/i386-pc/zfs.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2700 2025-02-12 10:55:48.000000 boot/grub/i386-pc/zfscrypt.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 2548 2025-02-12 10:55:48.000000 boot/grub/i386-pc/zfsinfo.mod │ │ │ │ │ --r-xr-xr-x 1 0 0 19332 2025-02-12 10:55:49.000000 boot/grub/i386-pc/zstd.mod │ │ │ │ │ +dr-xr-xr-x 3 0 0 2048 2024-01-11 05:12:18.000000 . │ │ │ │ │ +dr-xr-xr-x 3 0 0 2048 2024-01-11 05:12:18.000000 boot │ │ │ │ │ +dr-xr-xr-x 6 0 0 2048 2024-01-11 05:12:20.000000 boot/grub │ │ │ │ │ +dr-xr-xr-x 2 0 0 2048 2024-01-11 05:12:20.000000 boot/grub/fonts │ │ │ │ │ +dr-xr-xr-x 2 0 0 38912 2024-01-11 05:12:20.000000 boot/grub/i386-pc │ │ │ │ │ +dr-xr-xr-x 2 0 0 2048 2024-01-11 05:12:18.000000 boot/grub/locale │ │ │ │ │ +dr-xr-xr-x 2 0 0 2048 2024-01-11 05:12:18.000000 boot/grub/roms │ │ │ │ │ +-r--r--r-- 1 0 0 2048 2024-01-11 05:12:20.000000 boot.catalog │ │ │ │ │ +-r--r--r-- 1 0 0 1705 2024-01-11 05:12:18.000000 boot/grub/grub.cfg │ │ │ │ │ +-r-xr-xr-x 1 0 0 3520 2024-01-11 05:12:18.000000 boot/grub/i386-pc/915resolution.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 4404 2024-01-11 05:12:20.000000 boot/grub/i386-pc/acpi.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 548 2024-01-11 05:12:19.000000 boot/grub/i386-pc/adler32.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2636 2024-01-11 05:12:19.000000 boot/grub/i386-pc/affs.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 3176 2024-01-11 05:12:19.000000 boot/grub/i386-pc/afs.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 832 2024-01-11 05:12:20.000000 boot/grub/i386-pc/afsplitter.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 4920 2024-01-11 05:12:19.000000 boot/grub/i386-pc/ahci.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 236 2024-01-11 05:12:19.000000 boot/grub/i386-pc/all_video.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 496 2024-01-11 05:12:19.000000 boot/grub/i386-pc/aout.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1540 2024-01-11 05:12:19.000000 boot/grub/i386-pc/archelp.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2004 2024-01-11 05:12:19.000000 boot/grub/i386-pc/at_keyboard.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2672 2024-01-11 05:12:19.000000 boot/grub/i386-pc/ata.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 748 2024-01-11 05:12:19.000000 boot/grub/i386-pc/backtrace.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 3580 2024-01-11 05:12:19.000000 boot/grub/i386-pc/bfs.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2496 2024-01-11 05:12:19.000000 boot/grub/i386-pc/biosdisk.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1128 2024-01-11 05:12:19.000000 boot/grub/i386-pc/bitmap.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2020 2024-01-11 05:12:19.000000 boot/grub/i386-pc/bitmap_scale.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1068 2024-01-11 05:12:20.000000 boot/grub/i386-pc/blocklist.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1180 2024-01-11 05:12:20.000000 boot/grub/i386-pc/boot.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 12244 2024-01-11 05:12:19.000000 boot/grub/i386-pc/bsd.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1020 2024-01-11 05:12:19.000000 boot/grub/i386-pc/bswap_test.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 9152 2024-01-11 05:12:19.000000 boot/grub/i386-pc/btrfs.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1040 2024-01-11 05:12:19.000000 boot/grub/i386-pc/bufio.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1348 2024-01-11 05:12:20.000000 boot/grub/i386-pc/cat.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1860 2024-01-11 05:12:19.000000 boot/grub/i386-pc/cbfs.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1180 2024-01-11 05:12:20.000000 boot/grub/i386-pc/cbls.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 976 2024-01-11 05:12:20.000000 boot/grub/i386-pc/cbmemc.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 536 2024-01-11 05:12:20.000000 boot/grub/i386-pc/cbtable.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1112 2024-01-11 05:12:20.000000 boot/grub/i386-pc/cbtime.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1596 2024-01-11 05:12:19.000000 boot/grub/i386-pc/chain.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1160 2024-01-11 05:12:19.000000 boot/grub/i386-pc/cmdline_cat_test.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 580 2024-01-11 05:12:20.000000 boot/grub/i386-pc/cmosdump.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 812 2024-01-11 05:12:20.000000 boot/grub/i386-pc/cmostest.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 968 2024-01-11 05:12:20.000000 boot/grub/i386-pc/cmp.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1780 2024-01-11 05:12:19.000000 boot/grub/i386-pc/cmp_test.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1456 2024-01-11 05:12:20.000000 boot/grub/i386-pc/command.lst │ │ │ │ │ +-r-xr-xr-x 1 0 0 840 2024-01-11 05:12:20.000000 boot/grub/i386-pc/configfile.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1272 2024-01-11 05:12:19.000000 boot/grub/i386-pc/cpio.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1300 2024-01-11 05:12:19.000000 boot/grub/i386-pc/cpio_be.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 728 2024-01-11 05:12:20.000000 boot/grub/i386-pc/cpuid.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 800 2024-01-11 05:12:19.000000 boot/grub/i386-pc/crc64.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 416 2024-01-11 05:12:20.000000 boot/grub/i386-pc/crypto.lst │ │ │ │ │ +-r-xr-xr-x 1 0 0 2344 2024-01-11 05:12:19.000000 boot/grub/i386-pc/crypto.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 5476 2024-01-11 05:12:20.000000 boot/grub/i386-pc/cryptodisk.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1480 2024-01-11 05:12:20.000000 boot/grub/i386-pc/cs5536.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 816 2024-01-11 05:12:19.000000 boot/grub/i386-pc/ctz_test.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1040 2024-01-11 05:12:20.000000 boot/grub/i386-pc/date.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 700 2024-01-11 05:12:19.000000 boot/grub/i386-pc/datehook.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1252 2024-01-11 05:12:19.000000 boot/grub/i386-pc/datetime.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1300 2024-01-11 05:12:20.000000 boot/grub/i386-pc/disk.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 5340 2024-01-11 05:12:19.000000 boot/grub/i386-pc/diskfilter.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 508 2024-01-11 05:12:19.000000 boot/grub/i386-pc/div.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2216 2024-01-11 05:12:19.000000 boot/grub/i386-pc/div_test.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 852 2024-01-11 05:12:20.000000 boot/grub/i386-pc/dm_nv.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2396 2024-01-11 05:12:20.000000 boot/grub/i386-pc/drivemap.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 888 2024-01-11 05:12:20.000000 boot/grub/i386-pc/echo.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 9464 2024-01-11 05:12:19.000000 boot/grub/i386-pc/efiemu.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 3184 2024-01-11 05:12:20.000000 boot/grub/i386-pc/efiemu32.o │ │ │ │ │ +-r-xr-xr-x 1 0 0 3424 2024-01-11 05:12:20.000000 boot/grub/i386-pc/efiemu64.o │ │ │ │ │ +-r-xr-xr-x 1 0 0 6044 2024-01-11 05:12:20.000000 boot/grub/i386-pc/ehci.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1888 2024-01-11 05:12:19.000000 boot/grub/i386-pc/elf.mod │ │ │ │ │ +-r--r--r-- 1 0 0 46703 2024-01-11 05:12:20.000000 boot/grub/i386-pc/eltorito.img │ │ │ │ │ +-r-xr-xr-x 1 0 0 652 2024-01-11 05:12:20.000000 boot/grub/i386-pc/eval.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 3428 2024-01-11 05:12:19.000000 boot/grub/i386-pc/exfat.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 556 2024-01-11 05:12:19.000000 boot/grub/i386-pc/exfctest.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 3196 2024-01-11 05:12:19.000000 boot/grub/i386-pc/ext2.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2440 2024-01-11 05:12:20.000000 boot/grub/i386-pc/extcmd.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 3380 2024-01-11 05:12:19.000000 boot/grub/i386-pc/f2fs.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 3648 2024-01-11 05:12:19.000000 boot/grub/i386-pc/fat.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 5704 2024-01-11 05:12:19.000000 boot/grub/i386-pc/file.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 6508 2024-01-11 05:12:19.000000 boot/grub/i386-pc/font.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1160 2024-01-11 05:12:19.000000 boot/grub/i386-pc/freedos.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 204 2024-01-11 05:12:20.000000 boot/grub/i386-pc/fs.lst │ │ │ │ │ +-r-xr-xr-x 1 0 0 1756 2024-01-11 05:12:19.000000 boot/grub/i386-pc/fshelp.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 8464 2024-01-11 05:12:19.000000 boot/grub/i386-pc/functional_test.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 780 2024-01-11 05:12:19.000000 boot/grub/i386-pc/gcry_arcfour.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 5500 2024-01-11 05:12:19.000000 boot/grub/i386-pc/gcry_blowfish.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 8424 2024-01-11 05:12:19.000000 boot/grub/i386-pc/gcry_camellia.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 10640 2024-01-11 05:12:19.000000 boot/grub/i386-pc/gcry_cast5.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 8624 2024-01-11 05:12:19.000000 boot/grub/i386-pc/gcry_crc.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 4064 2024-01-11 05:12:19.000000 boot/grub/i386-pc/gcry_des.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 936 2024-01-11 05:12:19.000000 boot/grub/i386-pc/gcry_dsa.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1512 2024-01-11 05:12:19.000000 boot/grub/i386-pc/gcry_idea.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1448 2024-01-11 05:12:19.000000 boot/grub/i386-pc/gcry_md4.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1832 2024-01-11 05:12:19.000000 boot/grub/i386-pc/gcry_md5.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1344 2024-01-11 05:12:19.000000 boot/grub/i386-pc/gcry_rfc2268.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 7616 2024-01-11 05:12:19.000000 boot/grub/i386-pc/gcry_rijndael.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2736 2024-01-11 05:12:19.000000 boot/grub/i386-pc/gcry_rmd160.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 880 2024-01-11 05:12:19.000000 boot/grub/i386-pc/gcry_rsa.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 4472 2024-01-11 05:12:19.000000 boot/grub/i386-pc/gcry_seed.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 5604 2024-01-11 05:12:19.000000 boot/grub/i386-pc/gcry_serpent.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 3176 2024-01-11 05:12:19.000000 boot/grub/i386-pc/gcry_sha1.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2088 2024-01-11 05:12:19.000000 boot/grub/i386-pc/gcry_sha256.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 3264 2024-01-11 05:12:19.000000 boot/grub/i386-pc/gcry_sha512.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 10260 2024-01-11 05:12:18.000000 boot/grub/i386-pc/gcry_tiger.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 9828 2024-01-11 05:12:18.000000 boot/grub/i386-pc/gcry_twofish.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 6100 2024-01-11 05:12:18.000000 boot/grub/i386-pc/gcry_whirlpool.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 3752 2024-01-11 05:12:19.000000 boot/grub/i386-pc/gdb.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2656 2024-01-11 05:12:19.000000 boot/grub/i386-pc/geli.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2128 2024-01-11 05:12:19.000000 boot/grub/i386-pc/gettext.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 15640 2024-01-11 05:12:19.000000 boot/grub/i386-pc/gfxmenu.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 3884 2024-01-11 05:12:19.000000 boot/grub/i386-pc/gfxterm.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1128 2024-01-11 05:12:19.000000 boot/grub/i386-pc/gfxterm_background.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1848 2024-01-11 05:12:19.000000 boot/grub/i386-pc/gfxterm_menu.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1800 2024-01-11 05:12:20.000000 boot/grub/i386-pc/gptsync.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 4524 2024-01-11 05:12:19.000000 boot/grub/i386-pc/gzio.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2196 2024-01-11 05:12:20.000000 boot/grub/i386-pc/halt.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2124 2024-01-11 05:12:20.000000 boot/grub/i386-pc/hashsum.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2916 2024-01-11 05:12:20.000000 boot/grub/i386-pc/hdparm.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 492 2024-01-11 05:12:19.000000 boot/grub/i386-pc/hello.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1216 2024-01-11 05:12:20.000000 boot/grub/i386-pc/help.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1508 2024-01-11 05:12:20.000000 boot/grub/i386-pc/hexdump.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 3788 2024-01-11 05:12:19.000000 boot/grub/i386-pc/hfs.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 4016 2024-01-11 05:12:19.000000 boot/grub/i386-pc/hfsplus.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1536 2024-01-11 05:12:19.000000 boot/grub/i386-pc/hfspluscomp.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2656 2024-01-11 05:12:19.000000 boot/grub/i386-pc/http.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1164 2024-01-11 05:12:20.000000 boot/grub/i386-pc/hwmatch.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1152 2024-01-11 05:12:20.000000 boot/grub/i386-pc/iorw.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 4324 2024-01-11 05:12:19.000000 boot/grub/i386-pc/iso9660.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 3332 2024-01-11 05:12:19.000000 boot/grub/i386-pc/jfs.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 3940 2024-01-11 05:12:19.000000 boot/grub/i386-pc/jpeg.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2028 2024-01-11 05:12:20.000000 boot/grub/i386-pc/json.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1416 2024-01-11 05:12:19.000000 boot/grub/i386-pc/keylayouts.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 780 2024-01-11 05:12:20.000000 boot/grub/i386-pc/keystatus.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2872 2024-01-11 05:12:19.000000 boot/grub/i386-pc/ldm.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 908 2024-01-11 05:12:19.000000 boot/grub/i386-pc/legacy_password_test.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 11076 2024-01-11 05:12:19.000000 boot/grub/i386-pc/legacycfg.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 6008 2024-01-11 05:12:19.000000 boot/grub/i386-pc/linux.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2612 2024-01-11 05:12:19.000000 boot/grub/i386-pc/linux16.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2804 2024-01-11 05:12:20.000000 boot/grub/i386-pc/loadenv.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1324 2024-01-11 05:12:20.000000 boot/grub/i386-pc/loopback.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1660 2024-01-11 05:12:20.000000 boot/grub/i386-pc/ls.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2068 2024-01-11 05:12:20.000000 boot/grub/i386-pc/lsacpi.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 980 2024-01-11 05:12:19.000000 boot/grub/i386-pc/lsapm.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 804 2024-01-11 05:12:20.000000 boot/grub/i386-pc/lsmmap.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1816 2024-01-11 05:12:20.000000 boot/grub/i386-pc/lspci.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1984 2024-01-11 05:12:19.000000 boot/grub/i386-pc/luks.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 5868 2024-01-11 05:12:19.000000 boot/grub/i386-pc/luks2.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 3896 2024-01-11 05:12:19.000000 boot/grub/i386-pc/lvm.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2608 2024-01-11 05:12:19.000000 boot/grub/i386-pc/lzopio.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1576 2024-01-11 05:12:19.000000 boot/grub/i386-pc/macbless.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 3268 2024-01-11 05:12:19.000000 boot/grub/i386-pc/macho.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 964 2024-01-11 05:12:19.000000 boot/grub/i386-pc/mda_text.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 940 2024-01-11 05:12:19.000000 boot/grub/i386-pc/mdraid09.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 972 2024-01-11 05:12:19.000000 boot/grub/i386-pc/mdraid09_be.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 896 2024-01-11 05:12:19.000000 boot/grub/i386-pc/mdraid1x.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 888 2024-01-11 05:12:19.000000 boot/grub/i386-pc/memdisk.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1152 2024-01-11 05:12:20.000000 boot/grub/i386-pc/memrw.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1544 2024-01-11 05:12:20.000000 boot/grub/i386-pc/minicmd.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2008 2024-01-11 05:12:19.000000 boot/grub/i386-pc/minix.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2064 2024-01-11 05:12:19.000000 boot/grub/i386-pc/minix2.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2132 2024-01-11 05:12:19.000000 boot/grub/i386-pc/minix2_be.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2032 2024-01-11 05:12:19.000000 boot/grub/i386-pc/minix3.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2132 2024-01-11 05:12:19.000000 boot/grub/i386-pc/minix3_be.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2072 2024-01-11 05:12:19.000000 boot/grub/i386-pc/minix_be.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 4176 2024-01-11 05:12:19.000000 boot/grub/i386-pc/mmap.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2116 2024-01-11 05:12:20.000000 boot/grub/i386-pc/moddep.lst │ │ │ │ │ +-r-xr-xr-x 1 0 0 1264 2024-01-11 05:12:20.000000 boot/grub/i386-pc/modinfo.sh │ │ │ │ │ +-r-xr-xr-x 1 0 0 708 2024-01-11 05:12:20.000000 boot/grub/i386-pc/morse.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 12848 2024-01-11 05:12:19.000000 boot/grub/i386-pc/mpi.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1072 2024-01-11 05:12:19.000000 boot/grub/i386-pc/msdospart.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 960 2024-01-11 05:12:19.000000 boot/grub/i386-pc/mul_test.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 6184 2024-01-11 05:12:19.000000 boot/grub/i386-pc/multiboot.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 6628 2024-01-11 05:12:19.000000 boot/grub/i386-pc/multiboot2.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1908 2024-01-11 05:12:20.000000 boot/grub/i386-pc/nativedisk.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 24724 2024-01-11 05:12:19.000000 boot/grub/i386-pc/net.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1396 2024-01-11 05:12:19.000000 boot/grub/i386-pc/newc.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 3356 2024-01-11 05:12:19.000000 boot/grub/i386-pc/nilfs2.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 44536 2024-01-11 05:12:19.000000 boot/grub/i386-pc/normal.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 5748 2024-01-11 05:12:19.000000 boot/grub/i386-pc/ntfs.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2448 2024-01-11 05:12:19.000000 boot/grub/i386-pc/ntfscomp.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1076 2024-01-11 05:12:19.000000 boot/grub/i386-pc/ntldr.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1300 2024-01-11 05:12:19.000000 boot/grub/i386-pc/odc.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 684 2024-01-11 05:12:19.000000 boot/grub/i386-pc/offsetio.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 4456 2024-01-11 05:12:20.000000 boot/grub/i386-pc/ohci.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 816 2024-01-11 05:12:19.000000 boot/grub/i386-pc/part_acorn.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 896 2024-01-11 05:12:19.000000 boot/grub/i386-pc/part_amiga.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 976 2024-01-11 05:12:19.000000 boot/grub/i386-pc/part_apple.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1272 2024-01-11 05:12:19.000000 boot/grub/i386-pc/part_bsd.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 856 2024-01-11 05:12:19.000000 boot/grub/i386-pc/part_dfly.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 704 2024-01-11 05:12:19.000000 boot/grub/i386-pc/part_dvh.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1100 2024-01-11 05:12:19.000000 boot/grub/i386-pc/part_gpt.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1200 2024-01-11 05:12:19.000000 boot/grub/i386-pc/part_msdos.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 828 2024-01-11 05:12:19.000000 boot/grub/i386-pc/part_plan.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 732 2024-01-11 05:12:19.000000 boot/grub/i386-pc/part_sun.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 768 2024-01-11 05:12:19.000000 boot/grub/i386-pc/part_sunpc.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 116 2024-01-11 05:12:20.000000 boot/grub/i386-pc/partmap.lst │ │ │ │ │ +-r-xr-xr-x 1 0 0 68 2024-01-11 05:12:20.000000 boot/grub/i386-pc/parttool.lst │ │ │ │ │ +-r-xr-xr-x 1 0 0 2052 2024-01-11 05:12:20.000000 boot/grub/i386-pc/parttool.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 832 2024-01-11 05:12:20.000000 boot/grub/i386-pc/password.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1288 2024-01-11 05:12:20.000000 boot/grub/i386-pc/password_pbkdf2.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2344 2024-01-11 05:12:19.000000 boot/grub/i386-pc/pata.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 684 2024-01-11 05:12:19.000000 boot/grub/i386-pc/pbkdf2.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 928 2024-01-11 05:12:19.000000 boot/grub/i386-pc/pbkdf2_test.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 720 2024-01-11 05:12:20.000000 boot/grub/i386-pc/pci.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1116 2024-01-11 05:12:20.000000 boot/grub/i386-pc/pcidump.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 4776 2024-01-11 05:12:20.000000 boot/grub/i386-pc/pgp.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 3036 2024-01-11 05:12:19.000000 boot/grub/i386-pc/plan9.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1212 2024-01-11 05:12:20.000000 boot/grub/i386-pc/play.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 4132 2024-01-11 05:12:19.000000 boot/grub/i386-pc/png.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 800 2024-01-11 05:12:19.000000 boot/grub/i386-pc/priority_queue.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1472 2024-01-11 05:12:20.000000 boot/grub/i386-pc/probe.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 956 2024-01-11 05:12:19.000000 boot/grub/i386-pc/procfs.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1096 2024-01-11 05:12:19.000000 boot/grub/i386-pc/progress.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1548 2024-01-11 05:12:19.000000 boot/grub/i386-pc/pxe.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1136 2024-01-11 05:12:19.000000 boot/grub/i386-pc/pxechain.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 696 2024-01-11 05:12:19.000000 boot/grub/i386-pc/raid5rec.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1236 2024-01-11 05:12:19.000000 boot/grub/i386-pc/raid6rec.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1368 2024-01-11 05:12:19.000000 boot/grub/i386-pc/random.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 856 2024-01-11 05:12:19.000000 boot/grub/i386-pc/rdmsr.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 660 2024-01-11 05:12:20.000000 boot/grub/i386-pc/read.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 736 2024-01-11 05:12:20.000000 boot/grub/i386-pc/reboot.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 26876 2024-01-11 05:12:20.000000 boot/grub/i386-pc/regexp.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 4316 2024-01-11 05:12:19.000000 boot/grub/i386-pc/reiserfs.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 6656 2024-01-11 05:12:19.000000 boot/grub/i386-pc/relocator.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2152 2024-01-11 05:12:19.000000 boot/grub/i386-pc/romfs.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2304 2024-01-11 05:12:19.000000 boot/grub/i386-pc/scsi.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1384 2024-01-11 05:12:20.000000 boot/grub/i386-pc/search.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1448 2024-01-11 05:12:20.000000 boot/grub/i386-pc/search_fs_file.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1564 2024-01-11 05:12:20.000000 boot/grub/i386-pc/search_fs_uuid.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1484 2024-01-11 05:12:20.000000 boot/grub/i386-pc/search_label.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2540 2024-01-11 05:12:19.000000 boot/grub/i386-pc/sendkey.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 3176 2024-01-11 05:12:19.000000 boot/grub/i386-pc/serial.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 300 2024-01-11 05:12:19.000000 boot/grub/i386-pc/setjmp.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 676 2024-01-11 05:12:19.000000 boot/grub/i386-pc/setjmp_test.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2148 2024-01-11 05:12:20.000000 boot/grub/i386-pc/setpci.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2596 2024-01-11 05:12:19.000000 boot/grub/i386-pc/sfs.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1124 2024-01-11 05:12:19.000000 boot/grub/i386-pc/shift_test.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 4268 2024-01-11 05:12:19.000000 boot/grub/i386-pc/signature_test.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 912 2024-01-11 05:12:20.000000 boot/grub/i386-pc/sleep.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1104 2024-01-11 05:12:19.000000 boot/grub/i386-pc/sleep_test.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2332 2024-01-11 05:12:20.000000 boot/grub/i386-pc/smbios.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 804 2024-01-11 05:12:20.000000 boot/grub/i386-pc/spkmodem.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 3808 2024-01-11 05:12:19.000000 boot/grub/i386-pc/squash4.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 916 2024-01-11 05:12:19.000000 boot/grub/i386-pc/strtoull_test.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 7216 2024-01-11 05:12:19.000000 boot/grub/i386-pc/syslinuxcfg.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1552 2024-01-11 05:12:19.000000 boot/grub/i386-pc/tar.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 164 2024-01-11 05:12:20.000000 boot/grub/i386-pc/terminal.lst │ │ │ │ │ +-r-xr-xr-x 1 0 0 1792 2024-01-11 05:12:20.000000 boot/grub/i386-pc/terminal.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 5080 2024-01-11 05:12:19.000000 boot/grub/i386-pc/terminfo.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2192 2024-01-11 05:12:20.000000 boot/grub/i386-pc/test.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 576 2024-01-11 05:12:19.000000 boot/grub/i386-pc/test_blockarg.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1240 2024-01-11 05:12:19.000000 boot/grub/i386-pc/testload.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1024 2024-01-11 05:12:19.000000 boot/grub/i386-pc/testspeed.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2176 2024-01-11 05:12:19.000000 boot/grub/i386-pc/tftp.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1796 2024-01-11 05:12:19.000000 boot/grub/i386-pc/tga.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 684 2024-01-11 05:12:19.000000 boot/grub/i386-pc/time.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1076 2024-01-11 05:12:19.000000 boot/grub/i386-pc/tr.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 788 2024-01-11 05:12:20.000000 boot/grub/i386-pc/trig.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 500 2024-01-11 05:12:20.000000 boot/grub/i386-pc/true.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1588 2024-01-11 05:12:19.000000 boot/grub/i386-pc/truecrypt.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 4372 2024-01-11 05:12:19.000000 boot/grub/i386-pc/udf.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2648 2024-01-11 05:12:19.000000 boot/grub/i386-pc/ufs1.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2848 2024-01-11 05:12:19.000000 boot/grub/i386-pc/ufs1_be.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2732 2024-01-11 05:12:19.000000 boot/grub/i386-pc/ufs2.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2976 2024-01-11 05:12:20.000000 boot/grub/i386-pc/uhci.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 5168 2024-01-11 05:12:20.000000 boot/grub/i386-pc/usb.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1796 2024-01-11 05:12:19.000000 boot/grub/i386-pc/usb_keyboard.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2820 2024-01-11 05:12:19.000000 boot/grub/i386-pc/usbms.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 952 2024-01-11 05:12:20.000000 boot/grub/i386-pc/usbserial_common.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1004 2024-01-11 05:12:20.000000 boot/grub/i386-pc/usbserial_ftdi.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1056 2024-01-11 05:12:20.000000 boot/grub/i386-pc/usbserial_pl2303.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 612 2024-01-11 05:12:20.000000 boot/grub/i386-pc/usbserial_usbdebug.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1760 2024-01-11 05:12:20.000000 boot/grub/i386-pc/usbtest.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 4160 2024-01-11 05:12:19.000000 boot/grub/i386-pc/vbe.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1300 2024-01-11 05:12:20.000000 boot/grub/i386-pc/verifiers.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1884 2024-01-11 05:12:19.000000 boot/grub/i386-pc/vga.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1004 2024-01-11 05:12:19.000000 boot/grub/i386-pc/vga_text.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 84 2024-01-11 05:12:20.000000 boot/grub/i386-pc/video.lst │ │ │ │ │ +-r-xr-xr-x 1 0 0 2300 2024-01-11 05:12:19.000000 boot/grub/i386-pc/video.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2128 2024-01-11 05:12:19.000000 boot/grub/i386-pc/video_bochs.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2348 2024-01-11 05:12:19.000000 boot/grub/i386-pc/video_cirrus.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2232 2024-01-11 05:12:19.000000 boot/grub/i386-pc/video_colors.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 9408 2024-01-11 05:12:19.000000 boot/grub/i386-pc/video_fb.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1656 2024-01-11 05:12:20.000000 boot/grub/i386-pc/videoinfo.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 1648 2024-01-11 05:12:20.000000 boot/grub/i386-pc/videotest.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 892 2024-01-11 05:12:19.000000 boot/grub/i386-pc/videotest_checksum.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 724 2024-01-11 05:12:19.000000 boot/grub/i386-pc/wrmsr.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 3708 2024-01-11 05:12:19.000000 boot/grub/i386-pc/xfs.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 11368 2024-01-11 05:12:19.000000 boot/grub/i386-pc/xnu.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 972 2024-01-11 05:12:20.000000 boot/grub/i386-pc/xnu_uuid.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 808 2024-01-11 05:12:19.000000 boot/grub/i386-pc/xnu_uuid_test.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 8032 2024-01-11 05:12:19.000000 boot/grub/i386-pc/xzio.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 19000 2024-01-11 05:12:19.000000 boot/grub/i386-pc/zfs.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2700 2024-01-11 05:12:19.000000 boot/grub/i386-pc/zfscrypt.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 2548 2024-01-11 05:12:19.000000 boot/grub/i386-pc/zfsinfo.mod │ │ │ │ │ +-r-xr-xr-x 1 0 0 19332 2024-01-11 05:12:19.000000 boot/grub/i386-pc/zstd.mod │ │ │ │ ├── boot/grub/i386-pc/modinfo.sh │ │ │ │ │ ├── modinfo.sh-content │ │ │ │ │ │ @@ -1,8 +1,8 @@ │ │ │ │ │ │ -#!/bin/bash │ │ │ │ │ │ +#!/bin/sh │ │ │ │ │ │ │ │ │ │ │ │ # User-controllable options │ │ │ │ │ │ grub_modinfo_target_cpu=i386 │ │ │ │ │ │ grub_modinfo_platform=pc │ │ │ │ │ │ grub_disk_cache_stats=0 │ │ │ │ │ │ grub_boot_time_stats=0 │ │ │ │ │ │ grub_have_font_source=1 ├── grub-xen-bin_2.06-13+deb12u1_amd64.deb │ ├── file list │ │ @@ -1,3 +1,3 @@ │ │ -rw-r--r-- 0 0 0 4 2023-10-02 14:11:34.000000 debian-binary │ │ --rw-r--r-- 0 0 0 11648 2023-10-02 14:11:34.000000 control.tar.xz │ │ --rw-r--r-- 0 0 0 1000928 2023-10-02 14:11:34.000000 data.tar.xz │ │ +-rw-r--r-- 0 0 0 11652 2023-10-02 14:11:34.000000 control.tar.xz │ │ +-rw-r--r-- 0 0 0 1000776 2023-10-02 14:11:34.000000 data.tar.xz │ ├── control.tar.xz │ │ ├── control.tar │ │ │ ├── ./md5sums │ │ │ │ ├── ./md5sums │ │ │ │ │┄ Files differ │ ├── data.tar.xz │ │ ├── data.tar │ │ │ ├── file list │ │ │ │ @@ -124,15 +124,15 @@ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3596 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-xen/minix.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3692 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-xen/minix2.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3856 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-xen/minix2_be.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3692 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-xen/minix3.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3856 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-xen/minix3_be.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3724 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-xen/minix_be.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3722 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-xen/moddep.lst │ │ │ │ --rwxr-xr-x 0 root (0) root (0) 2566 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-xen/modinfo.sh │ │ │ │ +-rwxr-xr-x 0 root (0) root (0) 2564 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-xen/modinfo.sh │ │ │ │ -rw-r--r-- 0 root (0) root (0) 27896 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-xen/mpi.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 2396 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-xen/msdospart.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 2016 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-xen/mul_test.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 57252 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-xen/net.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 2836 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-xen/newc.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 6744 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-xen/nilfs2.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 114876 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-xen/normal.mod │ │ │ │ @@ -341,15 +341,15 @@ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3692 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-xen_pvh/minix2.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3856 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-xen_pvh/minix2_be.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3692 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-xen_pvh/minix3.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3856 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-xen_pvh/minix3_be.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3724 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-xen_pvh/minix_be.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 5848 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-xen_pvh/mmap.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3819 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-xen_pvh/moddep.lst │ │ │ │ --rwxr-xr-x 0 root (0) root (0) 2578 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-xen_pvh/modinfo.sh │ │ │ │ +-rwxr-xr-x 0 root (0) root (0) 2576 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-xen_pvh/modinfo.sh │ │ │ │ -rw-r--r-- 0 root (0) root (0) 27896 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-xen_pvh/mpi.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 2396 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-xen_pvh/msdospart.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 2016 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-xen_pvh/mul_test.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 12728 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-xen_pvh/multiboot.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 13828 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-xen_pvh/multiboot2.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 57252 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-xen_pvh/net.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 2836 2023-10-02 14:11:34.000000 ./usr/lib/grub/i386-xen_pvh/newc.mod │ │ │ │ @@ -560,15 +560,15 @@ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 5456 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-xen/minix.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 5576 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-xen/minix2.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 5680 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-xen/minix2_be.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 5608 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-xen/minix3.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 5712 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-xen/minix3_be.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 5552 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-xen/minix_be.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3722 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-xen/moddep.lst │ │ │ │ --rwxr-xr-x 0 root (0) root (0) 2491 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-xen/modinfo.sh │ │ │ │ +-rwxr-xr-x 0 root (0) root (0) 2489 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-xen/modinfo.sh │ │ │ │ -rw-r--r-- 0 root (0) root (0) 43544 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-xen/mpi.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3592 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-xen/msdospart.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 2312 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-xen/mul_test.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 91624 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-xen/net.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 4376 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-xen/newc.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 9688 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-xen/nilfs2.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 174472 2023-10-02 14:11:34.000000 ./usr/lib/grub/x86_64-xen/normal.mod │ │ │ ├── ./usr/lib/grub/i386-xen/modinfo.sh │ │ │ │ @@ -1,8 +1,8 @@ │ │ │ │ -#!/bin/bash │ │ │ │ +#!/bin/sh │ │ │ │ │ │ │ │ # User-controllable options │ │ │ │ grub_modinfo_target_cpu=i386 │ │ │ │ grub_modinfo_platform=xen │ │ │ │ grub_disk_cache_stats=0 │ │ │ │ grub_boot_time_stats=0 │ │ │ │ grub_have_font_source=1 │ │ │ ├── ./usr/lib/grub/i386-xen_pvh/modinfo.sh │ │ │ │ @@ -1,8 +1,8 @@ │ │ │ │ -#!/bin/bash │ │ │ │ +#!/bin/sh │ │ │ │ │ │ │ │ # User-controllable options │ │ │ │ grub_modinfo_target_cpu=i386 │ │ │ │ grub_modinfo_platform=xen_pvh │ │ │ │ grub_disk_cache_stats=0 │ │ │ │ grub_boot_time_stats=0 │ │ │ │ grub_have_font_source=1 │ │ │ ├── ./usr/lib/grub/x86_64-xen/modinfo.sh │ │ │ │ @@ -1,8 +1,8 @@ │ │ │ │ -#!/bin/bash │ │ │ │ +#!/bin/sh │ │ │ │ │ │ │ │ # User-controllable options │ │ │ │ grub_modinfo_target_cpu=x86_64 │ │ │ │ grub_modinfo_platform=xen │ │ │ │ grub_disk_cache_stats=0 │ │ │ │ grub_boot_time_stats=0 │ │ │ │ grub_have_font_source=1 ├── grub-xen-host_2.06-13+deb12u1_amd64.deb │ ├── file list │ │ @@ -1,3 +1,3 @@ │ │ -rw-r--r-- 0 0 0 4 2023-10-02 14:11:34.000000 debian-binary │ │ -rw-r--r-- 0 0 0 1312 2023-10-02 14:11:34.000000 control.tar.xz │ │ --rw-r--r-- 0 0 0 1175284 2023-10-02 14:11:34.000000 data.tar.xz │ │ +-rw-r--r-- 0 0 0 1174904 2023-10-02 14:11:34.000000 data.tar.xz │ ├── control.tar.xz │ │ ├── control.tar │ │ │ ├── ./md5sums │ │ │ │ ├── ./md5sums │ │ │ │ │┄ Files differ │ ├── data.tar.xz │ │ ├── data.tar │ │ │ ├── ./usr/lib/grub-xen/grub-i386-xen.bin │ │ │ │ ├── strings --all --bytes=8 {} │ │ │ │ │ @@ -9047,17 +9047,17 @@ │ │ │ │ │ .rel.rodata │ │ │ │ │ .rodata.str1.1 │ │ │ │ │ .module_license │ │ │ │ │ .moddeps │ │ │ │ │ .modname │ │ │ │ │ grub.cfg │ │ │ │ │ 00000001140 │ │ │ │ │ -14753100355 │ │ │ │ │ -pbuilder1 │ │ │ │ │ -pbuilder1 │ │ │ │ │ +14547675011 │ │ │ │ │ +pbuilder2 │ │ │ │ │ +pbuilder2 │ │ │ │ │ # First search for a suitable grub to chainload │ │ │ │ │ if search -s -f /boot/xen/pvboot-i386.elf ; then │ │ │ │ │ echo "Chainloading (${root})/boot/xen/pvboot-i386.elf" │ │ │ │ │ multiboot "/boot/xen/pvboot-i386.elf" │ │ │ │ │ if search -s -f /xen/pvboot-i386.elf ; then │ │ │ │ │ echo "Chainloading (${root})/xen/pvboot-i386.elf" │ │ │ │ │ multiboot "/xen/pvboot-i386.elf" │ │ │ │ ├── readelf --wide --decompress --hex-dump=mods {} │ │ │ │ │ @@ -91729,27 +91729,27 @@ │ │ │ │ │ 0x00172113 01000000 08280000 67727562 2e636667 .....(..grub.cfg │ │ │ │ │ 0x00172123 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x00172133 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x00172143 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x00172153 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x00172163 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x00172173 00000000 00000000 00000000 30303030 ............0000 │ │ │ │ │ - 0x00172183 36343400 30303032 31323700 30303032 644.0002127.0002 │ │ │ │ │ - 0x00172193 31323700 30303030 30303031 31343000 127.00000001140. │ │ │ │ │ - 0x001721a3 31343735 33313030 33353500 30313330 14753100355.0130 │ │ │ │ │ - 0x001721b3 33330020 30000000 00000000 00000000 33. 0........... │ │ │ │ │ + 0x00172183 36343400 30303034 32353600 30303034 644.0004256.0004 │ │ │ │ │ + 0x00172193 32353600 30303030 30303031 31343000 256.00000001140. │ │ │ │ │ + 0x001721a3 31343534 37363735 30313100 30313330 14547675011.0130 │ │ │ │ │ + 0x001721b3 35360020 30000000 00000000 00000000 56. 0........... │ │ │ │ │ 0x001721c3 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x001721d3 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x001721e3 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x001721f3 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x00172203 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x00172213 00000000 00000000 00757374 61722020 .........ustar │ │ │ │ │ - 0x00172223 00706275 696c6465 72310000 00000000 .pbuilder1...... │ │ │ │ │ + 0x00172223 00706275 696c6465 72320000 00000000 .pbuilder2...... │ │ │ │ │ 0x00172233 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ - 0x00172243 00706275 696c6465 72310000 00000000 .pbuilder1...... │ │ │ │ │ + 0x00172243 00706275 696c6465 72320000 00000000 .pbuilder2...... │ │ │ │ │ 0x00172253 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x00172263 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x00172273 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x00172283 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x00172293 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x001722a3 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x001722b3 00000000 00000000 00000000 00000000 ................ │ │ │ ├── ./usr/lib/grub-xen/grub-i386-xen_pvh.bin │ │ │ │ ├── strings --all --bytes=8 {} │ │ │ │ │ @@ -9334,16 +9334,16 @@ │ │ │ │ │ .rodata.str1.1 │ │ │ │ │ .module_license │ │ │ │ │ .moddeps │ │ │ │ │ .modname │ │ │ │ │ grub.cfg │ │ │ │ │ 00000000350 │ │ │ │ │ 14506547626 │ │ │ │ │ -pbuilder1 │ │ │ │ │ -pbuilder1 │ │ │ │ │ +pbuilder2 │ │ │ │ │ +pbuilder2 │ │ │ │ │ if search -s -f /boot/grub/grub.cfg ; then │ │ │ │ │ echo "Reading (${root})/boot/grub/grub.cfg" │ │ │ │ │ configfile /boot/grub/grub.cfg │ │ │ │ │ if search -s -f /grub/grub.cfg ; then │ │ │ │ │ echo "Reading (${root})/grub/grub.cfg" │ │ │ │ │ configfile /grub/grub.cfg │ │ │ │ │ normal (memdisk)/grub.cfg │ │ │ │ ├── readelf --wide --decompress --hex-dump=mods {} │ │ │ │ │ @@ -93591,27 +93591,27 @@ │ │ │ │ │ 0x0027940b 01000000 08280000 67727562 2e636667 .....(..grub.cfg │ │ │ │ │ 0x0027941b 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x0027942b 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x0027943b 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x0027944b 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x0027945b 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x0027946b 00000000 00000000 00000000 30303030 ............0000 │ │ │ │ │ - 0x0027947b 36343400 30303032 31323700 30303032 644.0002127.0002 │ │ │ │ │ - 0x0027948b 31323700 30303030 30303030 33353000 127.00000000350. │ │ │ │ │ + 0x0027947b 36363400 30303034 32353600 30303034 664.0004256.0004 │ │ │ │ │ + 0x0027948b 32353600 30303030 30303030 33353000 256.00000000350. │ │ │ │ │ 0x0027949b 31343530 36353437 36323600 30313330 14506547626.0130 │ │ │ │ │ - 0x002794ab 35310020 30000000 00000000 00000000 51. 0........... │ │ │ │ │ + 0x002794ab 36370020 30000000 00000000 00000000 67. 0........... │ │ │ │ │ 0x002794bb 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x002794cb 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x002794db 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x002794eb 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x002794fb 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x0027950b 00000000 00000000 00757374 61722020 .........ustar │ │ │ │ │ - 0x0027951b 00706275 696c6465 72310000 00000000 .pbuilder1...... │ │ │ │ │ + 0x0027951b 00706275 696c6465 72320000 00000000 .pbuilder2...... │ │ │ │ │ 0x0027952b 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ - 0x0027953b 00706275 696c6465 72310000 00000000 .pbuilder1...... │ │ │ │ │ + 0x0027953b 00706275 696c6465 72320000 00000000 .pbuilder2...... │ │ │ │ │ 0x0027954b 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x0027955b 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x0027956b 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x0027957b 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x0027958b 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x0027959b 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x002795ab 00000000 00000000 00000000 00000000 ................ │ │ │ ├── ./usr/lib/grub-xen/grub-x86_64-xen.bin │ │ │ │ ├── strings --all --bytes=8 {} │ │ │ │ │ @@ -10373,17 +10373,17 @@ │ │ │ │ │ .rela.rodata │ │ │ │ │ .rodata.str1.1 │ │ │ │ │ .module_license │ │ │ │ │ .moddeps │ │ │ │ │ .modname │ │ │ │ │ grub.cfg │ │ │ │ │ 00000001154 │ │ │ │ │ -14753100355 │ │ │ │ │ -pbuilder1 │ │ │ │ │ -pbuilder1 │ │ │ │ │ +14547675011 │ │ │ │ │ +pbuilder2 │ │ │ │ │ +pbuilder2 │ │ │ │ │ # First search for a suitable grub to chainload │ │ │ │ │ if search -s -f /boot/xen/pvboot-x86_64.elf ; then │ │ │ │ │ echo "Chainloading (${root})/boot/xen/pvboot-x86_64.elf" │ │ │ │ │ multiboot "/boot/xen/pvboot-x86_64.elf" │ │ │ │ │ if search -s -f /xen/pvboot-x86_64.elf ; then │ │ │ │ │ echo "Chainloading (${root})/xen/pvboot-x86_64.elf" │ │ │ │ │ multiboot "/xen/pvboot-x86_64.elf" │ │ │ │ ├── readelf --wide --decompress --hex-dump=mods {} │ │ │ │ │ @@ -127250,28 +127250,28 @@ │ │ │ │ │ 0x001ff9bf 00000000 00000000 01000000 08280000 .............(.. │ │ │ │ │ 0x001ff9cf 67727562 2e636667 00000000 00000000 grub.cfg........ │ │ │ │ │ 0x001ff9df 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x001ff9ef 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x001ff9ff 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x001ffa0f 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x001ffa1f 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ - 0x001ffa2f 00000000 30303030 36343400 30303032 ....0000644.0002 │ │ │ │ │ - 0x001ffa3f 31323700 30303032 31323700 30303030 127.0002127.0000 │ │ │ │ │ - 0x001ffa4f 30303031 31353400 31343735 33313030 0001154.14753100 │ │ │ │ │ - 0x001ffa5f 33353500 30313330 34300020 30000000 355.013040. 0... │ │ │ │ │ + 0x001ffa2f 00000000 30303030 36343400 30303034 ....0000644.0004 │ │ │ │ │ + 0x001ffa3f 32353600 30303034 32353600 30303030 256.0004256.0000 │ │ │ │ │ + 0x001ffa4f 30303031 31353400 31343534 37363735 0001154.14547675 │ │ │ │ │ + 0x001ffa5f 30313100 30313330 36330020 30000000 011.013063. 0... │ │ │ │ │ 0x001ffa6f 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x001ffa7f 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x001ffa8f 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x001ffa9f 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x001ffaaf 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x001ffabf 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x001ffacf 00757374 61722020 00706275 696c6465 .ustar .pbuilde │ │ │ │ │ - 0x001ffadf 72310000 00000000 00000000 00000000 r1.............. │ │ │ │ │ + 0x001ffadf 72320000 00000000 00000000 00000000 r2.............. │ │ │ │ │ 0x001ffaef 00000000 00000000 00706275 696c6465 .........pbuilde │ │ │ │ │ - 0x001ffaff 72310000 00000000 00000000 00000000 r1.............. │ │ │ │ │ + 0x001ffaff 72320000 00000000 00000000 00000000 r2.............. │ │ │ │ │ 0x001ffb0f 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x001ffb1f 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x001ffb2f 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x001ffb3f 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x001ffb4f 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x001ffb5f 00000000 00000000 00000000 00000000 ................ │ │ │ │ │ 0x001ffb6f 00000000 00000000 00000000 00000000 ................ ├── grub2-common_2.06-13+deb12u1_amd64.deb │ ├── file list │ │ @@ -1,3 +1,3 @@ │ │ -rw-r--r-- 0 0 0 4 2023-10-02 14:11:34.000000 debian-binary │ │ --rw-r--r-- 0 0 0 1376 2023-10-02 14:11:34.000000 control.tar.xz │ │ +-rw-r--r-- 0 0 0 1380 2023-10-02 14:11:34.000000 control.tar.xz │ │ -rw-r--r-- 0 0 0 612428 2023-10-02 14:11:34.000000 data.tar.xz │ ├── control.tar.xz │ │ ├── control.tar │ │ │ ├── ./md5sums │ │ │ │ ├── ./md5sums │ │ │ │ │┄ Files differ │ ├── data.tar.xz │ │ ├── data.tar │ │ │ ├── file list │ │ │ │ @@ -20,18 +20,18 @@ │ │ │ │ -rwxr-xr-x 0 root (0) root (0) 1768 2023-10-02 14:11:34.000000 ./usr/share/bug/grub2-common/script │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2023-10-02 14:11:34.000000 ./usr/share/doc/ │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2023-10-02 14:11:34.000000 ./usr/share/grub/ │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2023-10-02 14:11:34.000000 ./usr/share/grub/default/ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 1490 2023-10-02 14:11:34.000000 ./usr/share/grub/default/grub │ │ │ │ -rw-r--r-- 0 root (0) root (0) 186 2023-10-02 14:11:34.000000 ./usr/share/grub/default/grub.md5sum │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2023-10-02 14:11:34.000000 ./usr/share/info/ │ │ │ │ --rw-r--r-- 0 root (0) root (0) 33147 2023-10-02 14:11:34.000000 ./usr/share/info/grub-dev.info.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 90530 2023-10-02 14:11:34.000000 ./usr/share/info/grub.info-1.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 1702 2023-10-02 14:11:34.000000 ./usr/share/info/grub.info-2.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 3377 2023-10-02 14:11:34.000000 ./usr/share/info/grub.info.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 33144 2023-10-02 14:11:34.000000 ./usr/share/info/grub-dev.info.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 90527 2023-10-02 14:11:34.000000 ./usr/share/info/grub.info-1.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 1700 2023-10-02 14:11:34.000000 ./usr/share/info/grub.info-2.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 3379 2023-10-02 14:11:34.000000 ./usr/share/info/grub.info.gz │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2023-10-02 14:11:34.000000 ./usr/share/man/ │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2023-10-02 14:11:34.000000 ./usr/share/man/man8/ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 1957 2023-10-02 14:11:34.000000 ./usr/share/man/man8/grub-install.8.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 931 2023-10-02 14:11:34.000000 ./usr/share/man/man8/grub-reboot.8.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 666 2023-10-02 14:11:34.000000 ./usr/share/man/man8/grub-set-default.8.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 248 2023-10-02 14:11:34.000000 ./usr/share/man/man8/update-grub.8.gz │ │ │ │ lrwxrwxrwx 0 root (0) root (0) 0 2023-10-02 14:11:34.000000 ./usr/sbin/update-grub2 -> update-grub │ │ │ ├── ./usr/share/info/grub-dev.info.gz │ │ │ │ ├── grub-dev.info │ │ │ │ │ @@ -2,6789 +2,6789 @@ │ │ │ │ │ 00000010: 2e69 6e66 6f2c 2070 726f 6475 6365 6420 .info, produced │ │ │ │ │ 00000020: 6279 206d 616b 6569 6e66 6f20 7665 7273 by makeinfo vers │ │ │ │ │ 00000030: 696f 6e20 362e 3820 6672 6f6d 0a67 7275 ion 6.8 from.gru │ │ │ │ │ 00000040: 622d 6465 762e 7465 7869 2e0a 0a54 6869 b-dev.texi...Thi │ │ │ │ │ 00000050: 7320 6465 7665 6c6f 7065 7220 6d61 6e75 s developer manu │ │ │ │ │ 00000060: 616c 2069 7320 666f 7220 474e 5520 4752 al is for GNU GR │ │ │ │ │ 00000070: 5542 2028 7665 7273 696f 6e20 322e 3036 UB (version 2.06 │ │ │ │ │ -00000080: 2c20 3132 2046 6562 7275 6172 7920 3230 , 12 February 20 │ │ │ │ │ -00000090: 3235 292e 0a0a 2020 2043 6f70 7972 6967 25)... Copyrig │ │ │ │ │ -000000a0: 6874 2028 4329 2031 3939 392c 3230 3030 ht (C) 1999,2000 │ │ │ │ │ -000000b0: 2c32 3030 312c 3230 3032 2c32 3030 342c ,2001,2002,2004, │ │ │ │ │ -000000c0: 3230 3035 2c32 3030 362c 3230 3038 2c32 2005,2006,2008,2 │ │ │ │ │ -000000d0: 3030 392c 3230 3130 2c32 3031 310a 4672 009,2010,2011.Fr │ │ │ │ │ -000000e0: 6565 2053 6f66 7477 6172 6520 466f 756e ee Software Foun │ │ │ │ │ -000000f0: 6461 7469 6f6e 2c20 496e 632e 0a0a 2020 dation, Inc... │ │ │ │ │ -00000100: 2020 2050 6572 6d69 7373 696f 6e20 6973 Permission is │ │ │ │ │ -00000110: 2067 7261 6e74 6564 2074 6f20 636f 7079 granted to copy │ │ │ │ │ -00000120: 2c20 6469 7374 7269 6275 7465 2061 6e64 , distribute and │ │ │ │ │ -00000130: 2f6f 7220 6d6f 6469 6679 2074 6869 730a /or modify this. │ │ │ │ │ -00000140: 2020 2020 2064 6f63 756d 656e 7420 756e document un │ │ │ │ │ -00000150: 6465 7220 7468 6520 7465 726d 7320 6f66 der the terms of │ │ │ │ │ -00000160: 2074 6865 2047 4e55 2046 7265 6520 446f the GNU Free Do │ │ │ │ │ -00000170: 6375 6d65 6e74 6174 696f 6e20 4c69 6365 cumentation Lice │ │ │ │ │ -00000180: 6e73 652c 0a20 2020 2020 5665 7273 696f nse,. Versio │ │ │ │ │ -00000190: 6e20 312e 3220 6f72 2061 6e79 206c 6174 n 1.2 or any lat │ │ │ │ │ -000001a0: 6572 2076 6572 7369 6f6e 2070 7562 6c69 er version publi │ │ │ │ │ -000001b0: 7368 6564 2062 7920 7468 6520 4672 6565 shed by the Free │ │ │ │ │ -000001c0: 2053 6f66 7477 6172 650a 2020 2020 2046 Software. F │ │ │ │ │ -000001d0: 6f75 6e64 6174 696f 6e3b 2077 6974 6820 oundation; with │ │ │ │ │ -000001e0: 6e6f 2049 6e76 6172 6961 6e74 2053 6563 no Invariant Sec │ │ │ │ │ -000001f0: 7469 6f6e 732e 0a49 4e46 4f2d 4449 522d tions..INFO-DIR- │ │ │ │ │ -00000200: 5345 4354 494f 4e20 4b65 726e 656c 0a53 SECTION Kernel.S │ │ │ │ │ -00000210: 5441 5254 2d49 4e46 4f2d 4449 522d 454e TART-INFO-DIR-EN │ │ │ │ │ -00000220: 5452 590a 2a20 6772 7562 2d64 6576 3a20 TRY.* grub-dev: │ │ │ │ │ -00000230: 2867 7275 622d 6465 7629 2e20 2020 2020 (grub-dev). │ │ │ │ │ -00000240: 2020 2020 2020 2020 2020 2020 5468 6520 The │ │ │ │ │ -00000250: 4752 616e 6420 556e 6966 6965 6420 426f GRand Unified Bo │ │ │ │ │ -00000260: 6f74 6c6f 6164 6572 2044 6576 0a45 4e44 otloader Dev.END │ │ │ │ │ -00000270: 2d49 4e46 4f2d 4449 522d 454e 5452 590a -INFO-DIR-ENTRY. │ │ │ │ │ -00000280: 0a1f 0a46 696c 653a 2067 7275 622d 6465 ...File: grub-de │ │ │ │ │ -00000290: 762e 696e 666f 2c20 204e 6f64 653a 2054 v.info, Node: T │ │ │ │ │ -000002a0: 6f70 2c20 204e 6578 743a 2047 6574 7469 op, Next: Getti │ │ │ │ │ -000002b0: 6e67 2074 6865 2073 6f75 7263 6520 636f ng the source co │ │ │ │ │ -000002c0: 6465 2c20 2055 703a 2028 6469 7229 0a0a de, Up: (dir).. │ │ │ │ │ -000002d0: 474e 5520 4752 5542 2064 6576 656c 6f70 GNU GRUB develop │ │ │ │ │ -000002e0: 6572 206d 616e 7561 6c0a 2a2a 2a2a 2a2a er manual.****** │ │ │ │ │ +00000080: 2c20 3131 204a 616e 7561 7279 2032 3032 , 11 January 202 │ │ │ │ │ +00000090: 3429 2e0a 0a20 2020 436f 7079 7269 6768 4)... Copyrigh │ │ │ │ │ +000000a0: 7420 2843 2920 3139 3939 2c32 3030 302c t (C) 1999,2000, │ │ │ │ │ +000000b0: 3230 3031 2c32 3030 322c 3230 3034 2c32 2001,2002,2004,2 │ │ │ │ │ +000000c0: 3030 352c 3230 3036 2c32 3030 382c 3230 005,2006,2008,20 │ │ │ │ │ +000000d0: 3039 2c32 3031 302c 3230 3131 0a46 7265 09,2010,2011.Fre │ │ │ │ │ +000000e0: 6520 536f 6674 7761 7265 2046 6f75 6e64 e Software Found │ │ │ │ │ +000000f0: 6174 696f 6e2c 2049 6e63 2e0a 0a20 2020 ation, Inc... │ │ │ │ │ +00000100: 2020 5065 726d 6973 7369 6f6e 2069 7320 Permission is │ │ │ │ │ +00000110: 6772 616e 7465 6420 746f 2063 6f70 792c granted to copy, │ │ │ │ │ +00000120: 2064 6973 7472 6962 7574 6520 616e 642f distribute and/ │ │ │ │ │ +00000130: 6f72 206d 6f64 6966 7920 7468 6973 0a20 or modify this. │ │ │ │ │ +00000140: 2020 2020 646f 6375 6d65 6e74 2075 6e64 document und │ │ │ │ │ +00000150: 6572 2074 6865 2074 6572 6d73 206f 6620 er the terms of │ │ │ │ │ +00000160: 7468 6520 474e 5520 4672 6565 2044 6f63 the GNU Free Doc │ │ │ │ │ +00000170: 756d 656e 7461 7469 6f6e 204c 6963 656e umentation Licen │ │ │ │ │ +00000180: 7365 2c0a 2020 2020 2056 6572 7369 6f6e se,. Version │ │ │ │ │ +00000190: 2031 2e32 206f 7220 616e 7920 6c61 7465 1.2 or any late │ │ │ │ │ +000001a0: 7220 7665 7273 696f 6e20 7075 626c 6973 r version publis │ │ │ │ │ +000001b0: 6865 6420 6279 2074 6865 2046 7265 6520 hed by the Free │ │ │ │ │ +000001c0: 536f 6674 7761 7265 0a20 2020 2020 466f Software. Fo │ │ │ │ │ +000001d0: 756e 6461 7469 6f6e 3b20 7769 7468 206e undation; with n │ │ │ │ │ +000001e0: 6f20 496e 7661 7269 616e 7420 5365 6374 o Invariant Sect │ │ │ │ │ +000001f0: 696f 6e73 2e0a 494e 464f 2d44 4952 2d53 ions..INFO-DIR-S │ │ │ │ │ +00000200: 4543 5449 4f4e 204b 6572 6e65 6c0a 5354 ECTION Kernel.ST │ │ │ │ │ +00000210: 4152 542d 494e 464f 2d44 4952 2d45 4e54 ART-INFO-DIR-ENT │ │ │ │ │ +00000220: 5259 0a2a 2067 7275 622d 6465 763a 2028 RY.* grub-dev: ( │ │ │ │ │ +00000230: 6772 7562 2d64 6576 292e 2020 2020 2020 grub-dev). │ │ │ │ │ +00000240: 2020 2020 2020 2020 2020 2054 6865 2047 The G │ │ │ │ │ +00000250: 5261 6e64 2055 6e69 6669 6564 2042 6f6f Rand Unified Boo │ │ │ │ │ +00000260: 746c 6f61 6465 7220 4465 760a 454e 442d tloader Dev.END- │ │ │ │ │ +00000270: 494e 464f 2d44 4952 2d45 4e54 5259 0a0a INFO-DIR-ENTRY.. │ │ │ │ │ +00000280: 1f0a 4669 6c65 3a20 6772 7562 2d64 6576 ..File: grub-dev │ │ │ │ │ +00000290: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 546f .info, Node: To │ │ │ │ │ +000002a0: 702c 2020 4e65 7874 3a20 4765 7474 696e p, Next: Gettin │ │ │ │ │ +000002b0: 6720 7468 6520 736f 7572 6365 2063 6f64 g the source cod │ │ │ │ │ +000002c0: 652c 2020 5570 3a20 2864 6972 290a 0a47 e, Up: (dir)..G │ │ │ │ │ +000002d0: 4e55 2047 5255 4220 6465 7665 6c6f 7065 NU GRUB develope │ │ │ │ │ +000002e0: 7220 6d61 6e75 616c 0a2a 2a2a 2a2a 2a2a r manual.******* │ │ │ │ │ 000002f0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -00000300: 2a2a 2a0a 0a54 6869 7320 6973 2074 6865 ***..This is the │ │ │ │ │ -00000310: 2064 6576 656c 6f70 6572 2064 6f63 756d developer docum │ │ │ │ │ -00000320: 656e 7461 7469 6f6e 206f 6620 474e 5520 entation of GNU │ │ │ │ │ -00000330: 4752 5542 2c20 7468 6520 4752 616e 6420 GRUB, the GRand │ │ │ │ │ -00000340: 556e 6966 6965 640a 426f 6f74 6c6f 6164 Unified.Bootload │ │ │ │ │ -00000350: 6572 2c20 6120 666c 6578 6962 6c65 2061 er, a flexible a │ │ │ │ │ -00000360: 6e64 2070 6f77 6572 6675 6c20 626f 6f74 nd powerful boot │ │ │ │ │ -00000370: 206c 6f61 6465 7220 7072 6f67 7261 6d20 loader program │ │ │ │ │ -00000380: 666f 7220 6120 7769 6465 2072 616e 6765 for a wide range │ │ │ │ │ -00000390: 0a6f 6620 6172 6368 6974 6563 7475 7265 .of architecture │ │ │ │ │ -000003a0: 732e 0a0a 2020 2054 6869 7320 6564 6974 s... This edit │ │ │ │ │ -000003b0: 696f 6e20 646f 6375 6d65 6e74 7320 7665 ion documents ve │ │ │ │ │ -000003c0: 7273 696f 6e20 322e 3036 2e0a 0a20 2020 rsion 2.06... │ │ │ │ │ -000003d0: 5468 6973 2064 6576 656c 6f70 6572 206d This developer m │ │ │ │ │ -000003e0: 616e 7561 6c20 6973 2066 6f72 2047 4e55 anual is for GNU │ │ │ │ │ -000003f0: 2047 5255 4220 2876 6572 7369 6f6e 2032 GRUB (version 2 │ │ │ │ │ -00000400: 2e30 362c 2031 3220 4665 6272 7561 7279 .06, 12 February │ │ │ │ │ -00000410: 0a32 3032 3529 2e0a 0a20 2020 436f 7079 .2025)... Copy │ │ │ │ │ -00000420: 7269 6768 7420 2843 2920 3139 3939 2c32 right (C) 1999,2 │ │ │ │ │ -00000430: 3030 302c 3230 3031 2c32 3030 322c 3230 000,2001,2002,20 │ │ │ │ │ -00000440: 3034 2c32 3030 352c 3230 3036 2c32 3030 04,2005,2006,200 │ │ │ │ │ -00000450: 382c 3230 3039 2c32 3031 302c 3230 3131 8,2009,2010,2011 │ │ │ │ │ -00000460: 0a46 7265 6520 536f 6674 7761 7265 2046 .Free Software F │ │ │ │ │ -00000470: 6f75 6e64 6174 696f 6e2c 2049 6e63 2e0a oundation, Inc.. │ │ │ │ │ -00000480: 0a20 2020 2020 5065 726d 6973 7369 6f6e . Permission │ │ │ │ │ -00000490: 2069 7320 6772 616e 7465 6420 746f 2063 is granted to c │ │ │ │ │ -000004a0: 6f70 792c 2064 6973 7472 6962 7574 6520 opy, distribute │ │ │ │ │ -000004b0: 616e 642f 6f72 206d 6f64 6966 7920 7468 and/or modify th │ │ │ │ │ -000004c0: 6973 0a20 2020 2020 646f 6375 6d65 6e74 is. document │ │ │ │ │ -000004d0: 2075 6e64 6572 2074 6865 2074 6572 6d73 under the terms │ │ │ │ │ -000004e0: 206f 6620 7468 6520 474e 5520 4672 6565 of the GNU Free │ │ │ │ │ -000004f0: 2044 6f63 756d 656e 7461 7469 6f6e 204c Documentation L │ │ │ │ │ -00000500: 6963 656e 7365 2c0a 2020 2020 2056 6572 icense,. Ver │ │ │ │ │ -00000510: 7369 6f6e 2031 2e32 206f 7220 616e 7920 sion 1.2 or any │ │ │ │ │ -00000520: 6c61 7465 7220 7665 7273 696f 6e20 7075 later version pu │ │ │ │ │ -00000530: 626c 6973 6865 6420 6279 2074 6865 2046 blished by the F │ │ │ │ │ -00000540: 7265 6520 536f 6674 7761 7265 0a20 2020 ree Software. │ │ │ │ │ -00000550: 2020 466f 756e 6461 7469 6f6e 3b20 7769 Foundation; wi │ │ │ │ │ -00000560: 7468 206e 6f20 496e 7661 7269 616e 7420 th no Invariant │ │ │ │ │ -00000570: 5365 6374 696f 6e73 2e0a 0a2a 204d 656e Sections...* Men │ │ │ │ │ -00000580: 753a 0a0a 2a20 4765 7474 696e 6720 7468 u:..* Getting th │ │ │ │ │ -00000590: 6520 736f 7572 6365 2063 6f64 653a 3a0a e source code::. │ │ │ │ │ -000005a0: 2a20 436f 6469 6e67 2073 7479 6c65 3a3a * Coding style:: │ │ │ │ │ -000005b0: 0a2a 2046 696e 6469 6e67 2079 6f75 7220 .* Finding your │ │ │ │ │ -000005c0: 7761 7920 6172 6f75 6e64 3a3a 0a2a 2043 way around::.* C │ │ │ │ │ -000005d0: 6f6e 7472 6962 7574 696e 6720 4368 616e ontributing Chan │ │ │ │ │ -000005e0: 6765 733a 3a0a 2a20 5570 6461 7469 6e67 ges::.* Updating │ │ │ │ │ -000005f0: 2045 7874 6572 6e61 6c20 436f 6465 3a3a External Code:: │ │ │ │ │ -00000600: 0a2a 2050 6f72 7469 6e67 3a3a 0a2a 2045 .* Porting::.* E │ │ │ │ │ -00000610: 7272 6f72 2048 616e 646c 696e 673a 3a0a rror Handling::. │ │ │ │ │ -00000620: 2a20 5374 6163 6b20 616e 6420 6865 6170 * Stack and heap │ │ │ │ │ -00000630: 2073 697a 653a 3a0a 2a20 4249 4f53 2070 size::.* BIOS p │ │ │ │ │ -00000640: 6f72 7420 6d65 6d6f 7279 206d 6170 3a3a ort memory map:: │ │ │ │ │ -00000650: 0a2a 2056 6964 656f 2053 7562 7379 7374 .* Video Subsyst │ │ │ │ │ -00000660: 656d 3a3a 0a2a 2050 4646 3220 466f 6e74 em::.* PFF2 Font │ │ │ │ │ -00000670: 2046 696c 6520 466f 726d 6174 3a3a 0a2a File Format::.* │ │ │ │ │ -00000680: 2047 7261 7068 6963 616c 204d 656e 7520 Graphical Menu │ │ │ │ │ -00000690: 536f 6674 7761 7265 2044 6573 6967 6e3a Software Design: │ │ │ │ │ -000006a0: 3a0a 2a20 5665 7269 6669 6572 7320 6672 :.* Verifiers fr │ │ │ │ │ -000006b0: 616d 6577 6f72 6b3a 3a0a 2a20 4c6f 636b amework::.* Lock │ │ │ │ │ -000006c0: 646f 776e 2066 7261 6d65 776f 726b 3a3a down framework:: │ │ │ │ │ -000006d0: 0a2a 2043 6f70 7969 6e67 2054 6869 7320 .* Copying This │ │ │ │ │ -000006e0: 4d61 6e75 616c 3a3a 2020 2020 2020 2020 Manual:: │ │ │ │ │ -000006f0: 2043 6f70 7969 6e67 2054 6869 7320 4d61 Copying This Ma │ │ │ │ │ -00000700: 6e75 616c 0a2a 2049 6e64 6578 3a3a 0a0a nual.* Index::.. │ │ │ │ │ -00000710: 1f0a 4669 6c65 3a20 6772 7562 2d64 6576 ..File: grub-dev │ │ │ │ │ -00000720: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 4765 .info, Node: Ge │ │ │ │ │ -00000730: 7474 696e 6720 7468 6520 736f 7572 6365 tting the source │ │ │ │ │ -00000740: 2063 6f64 652c 2020 4e65 7874 3a20 436f code, Next: Co │ │ │ │ │ -00000750: 6469 6e67 2073 7479 6c65 2c20 2050 7265 ding style, Pre │ │ │ │ │ -00000760: 763a 2054 6f70 2c20 2055 703a 2054 6f70 v: Top, Up: Top │ │ │ │ │ -00000770: 0a0a 3120 4765 7474 696e 6720 7468 6520 ..1 Getting the │ │ │ │ │ -00000780: 736f 7572 6365 2063 6f64 650a 2a2a 2a2a source code.**** │ │ │ │ │ +00000300: 2a2a 0a0a 5468 6973 2069 7320 7468 6520 **..This is the │ │ │ │ │ +00000310: 6465 7665 6c6f 7065 7220 646f 6375 6d65 developer docume │ │ │ │ │ +00000320: 6e74 6174 696f 6e20 6f66 2047 4e55 2047 ntation of GNU G │ │ │ │ │ +00000330: 5255 422c 2074 6865 2047 5261 6e64 2055 RUB, the GRand U │ │ │ │ │ +00000340: 6e69 6669 6564 0a42 6f6f 746c 6f61 6465 nified.Bootloade │ │ │ │ │ +00000350: 722c 2061 2066 6c65 7869 626c 6520 616e r, a flexible an │ │ │ │ │ +00000360: 6420 706f 7765 7266 756c 2062 6f6f 7420 d powerful boot │ │ │ │ │ +00000370: 6c6f 6164 6572 2070 726f 6772 616d 2066 loader program f │ │ │ │ │ +00000380: 6f72 2061 2077 6964 6520 7261 6e67 650a or a wide range. │ │ │ │ │ +00000390: 6f66 2061 7263 6869 7465 6374 7572 6573 of architectures │ │ │ │ │ +000003a0: 2e0a 0a20 2020 5468 6973 2065 6469 7469 ... This editi │ │ │ │ │ +000003b0: 6f6e 2064 6f63 756d 656e 7473 2076 6572 on documents ver │ │ │ │ │ +000003c0: 7369 6f6e 2032 2e30 362e 0a0a 2020 2054 sion 2.06... T │ │ │ │ │ +000003d0: 6869 7320 6465 7665 6c6f 7065 7220 6d61 his developer ma │ │ │ │ │ +000003e0: 6e75 616c 2069 7320 666f 7220 474e 5520 nual is for GNU │ │ │ │ │ +000003f0: 4752 5542 2028 7665 7273 696f 6e20 322e GRUB (version 2. │ │ │ │ │ +00000400: 3036 2c20 3131 204a 616e 7561 7279 0a32 06, 11 January.2 │ │ │ │ │ +00000410: 3032 3429 2e0a 0a20 2020 436f 7079 7269 024)... Copyri │ │ │ │ │ +00000420: 6768 7420 2843 2920 3139 3939 2c32 3030 ght (C) 1999,200 │ │ │ │ │ +00000430: 302c 3230 3031 2c32 3030 322c 3230 3034 0,2001,2002,2004 │ │ │ │ │ +00000440: 2c32 3030 352c 3230 3036 2c32 3030 382c ,2005,2006,2008, │ │ │ │ │ +00000450: 3230 3039 2c32 3031 302c 3230 3131 0a46 2009,2010,2011.F │ │ │ │ │ +00000460: 7265 6520 536f 6674 7761 7265 2046 6f75 ree Software Fou │ │ │ │ │ +00000470: 6e64 6174 696f 6e2c 2049 6e63 2e0a 0a20 ndation, Inc... │ │ │ │ │ +00000480: 2020 2020 5065 726d 6973 7369 6f6e 2069 Permission i │ │ │ │ │ +00000490: 7320 6772 616e 7465 6420 746f 2063 6f70 s granted to cop │ │ │ │ │ +000004a0: 792c 2064 6973 7472 6962 7574 6520 616e y, distribute an │ │ │ │ │ +000004b0: 642f 6f72 206d 6f64 6966 7920 7468 6973 d/or modify this │ │ │ │ │ +000004c0: 0a20 2020 2020 646f 6375 6d65 6e74 2075 . document u │ │ │ │ │ +000004d0: 6e64 6572 2074 6865 2074 6572 6d73 206f nder the terms o │ │ │ │ │ +000004e0: 6620 7468 6520 474e 5520 4672 6565 2044 f the GNU Free D │ │ │ │ │ +000004f0: 6f63 756d 656e 7461 7469 6f6e 204c 6963 ocumentation Lic │ │ │ │ │ +00000500: 656e 7365 2c0a 2020 2020 2056 6572 7369 ense,. Versi │ │ │ │ │ +00000510: 6f6e 2031 2e32 206f 7220 616e 7920 6c61 on 1.2 or any la │ │ │ │ │ +00000520: 7465 7220 7665 7273 696f 6e20 7075 626c ter version publ │ │ │ │ │ +00000530: 6973 6865 6420 6279 2074 6865 2046 7265 ished by the Fre │ │ │ │ │ +00000540: 6520 536f 6674 7761 7265 0a20 2020 2020 e Software. │ │ │ │ │ +00000550: 466f 756e 6461 7469 6f6e 3b20 7769 7468 Foundation; with │ │ │ │ │ +00000560: 206e 6f20 496e 7661 7269 616e 7420 5365 no Invariant Se │ │ │ │ │ +00000570: 6374 696f 6e73 2e0a 0a2a 204d 656e 753a ctions...* Menu: │ │ │ │ │ +00000580: 0a0a 2a20 4765 7474 696e 6720 7468 6520 ..* Getting the │ │ │ │ │ +00000590: 736f 7572 6365 2063 6f64 653a 3a0a 2a20 source code::.* │ │ │ │ │ +000005a0: 436f 6469 6e67 2073 7479 6c65 3a3a 0a2a Coding style::.* │ │ │ │ │ +000005b0: 2046 696e 6469 6e67 2079 6f75 7220 7761 Finding your wa │ │ │ │ │ +000005c0: 7920 6172 6f75 6e64 3a3a 0a2a 2043 6f6e y around::.* Con │ │ │ │ │ +000005d0: 7472 6962 7574 696e 6720 4368 616e 6765 tributing Change │ │ │ │ │ +000005e0: 733a 3a0a 2a20 5570 6461 7469 6e67 2045 s::.* Updating E │ │ │ │ │ +000005f0: 7874 6572 6e61 6c20 436f 6465 3a3a 0a2a xternal Code::.* │ │ │ │ │ +00000600: 2050 6f72 7469 6e67 3a3a 0a2a 2045 7272 Porting::.* Err │ │ │ │ │ +00000610: 6f72 2048 616e 646c 696e 673a 3a0a 2a20 or Handling::.* │ │ │ │ │ +00000620: 5374 6163 6b20 616e 6420 6865 6170 2073 Stack and heap s │ │ │ │ │ +00000630: 697a 653a 3a0a 2a20 4249 4f53 2070 6f72 ize::.* BIOS por │ │ │ │ │ +00000640: 7420 6d65 6d6f 7279 206d 6170 3a3a 0a2a t memory map::.* │ │ │ │ │ +00000650: 2056 6964 656f 2053 7562 7379 7374 656d Video Subsystem │ │ │ │ │ +00000660: 3a3a 0a2a 2050 4646 3220 466f 6e74 2046 ::.* PFF2 Font F │ │ │ │ │ +00000670: 696c 6520 466f 726d 6174 3a3a 0a2a 2047 ile Format::.* G │ │ │ │ │ +00000680: 7261 7068 6963 616c 204d 656e 7520 536f raphical Menu So │ │ │ │ │ +00000690: 6674 7761 7265 2044 6573 6967 6e3a 3a0a ftware Design::. │ │ │ │ │ +000006a0: 2a20 5665 7269 6669 6572 7320 6672 616d * Verifiers fram │ │ │ │ │ +000006b0: 6577 6f72 6b3a 3a0a 2a20 4c6f 636b 646f ework::.* Lockdo │ │ │ │ │ +000006c0: 776e 2066 7261 6d65 776f 726b 3a3a 0a2a wn framework::.* │ │ │ │ │ +000006d0: 2043 6f70 7969 6e67 2054 6869 7320 4d61 Copying This Ma │ │ │ │ │ +000006e0: 6e75 616c 3a3a 2020 2020 2020 2020 2043 nual:: C │ │ │ │ │ +000006f0: 6f70 7969 6e67 2054 6869 7320 4d61 6e75 opying This Manu │ │ │ │ │ +00000700: 616c 0a2a 2049 6e64 6578 3a3a 0a0a 1f0a al.* Index::.... │ │ │ │ │ +00000710: 4669 6c65 3a20 6772 7562 2d64 6576 2e69 File: grub-dev.i │ │ │ │ │ +00000720: 6e66 6f2c 2020 4e6f 6465 3a20 4765 7474 nfo, Node: Gett │ │ │ │ │ +00000730: 696e 6720 7468 6520 736f 7572 6365 2063 ing the source c │ │ │ │ │ +00000740: 6f64 652c 2020 4e65 7874 3a20 436f 6469 ode, Next: Codi │ │ │ │ │ +00000750: 6e67 2073 7479 6c65 2c20 2050 7265 763a ng style, Prev: │ │ │ │ │ +00000760: 2054 6f70 2c20 2055 703a 2054 6f70 0a0a Top, Up: Top.. │ │ │ │ │ +00000770: 3120 4765 7474 696e 6720 7468 6520 736f 1 Getting the so │ │ │ │ │ +00000780: 7572 6365 2063 6f64 650a 2a2a 2a2a 2a2a urce code.****** │ │ │ │ │ 00000790: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -000007a0: 2a2a 2a2a 2a0a 0a47 5255 4220 6973 206d *****..GRUB is m │ │ │ │ │ -000007b0: 6169 6e74 6169 6e65 6420 7573 696e 6720 aintained using │ │ │ │ │ -000007c0: 7468 6520 3c47 4954 2072 6576 6973 696f the . To fetch:.. │ │ │ │ │ -000007f0: 2020 2020 6769 7420 636c 6f6e 6520 6769 git clone gi │ │ │ │ │ -00000800: 743a 2f2f 6769 742e 7376 2e67 6e75 2e6f t://git.sv.gnu.o │ │ │ │ │ -00000810: 7267 2f67 7275 622e 6769 740a 0a20 2020 rg/grub.git.. │ │ │ │ │ -00000820: 5765 6220 6163 6365 7373 2069 7320 6176 Web access is av │ │ │ │ │ -00000830: 6169 6c61 626c 6520 756e 6465 720a 2020 ailable under. │ │ │ │ │ -00000840: 2020 2068 7474 703a 2f2f 6769 742e 7361 http://git.sa │ │ │ │ │ -00000850: 7661 6e6e 6168 2e67 6e75 2e6f 7267 2f63 vannah.gnu.org/c │ │ │ │ │ -00000860: 6769 742f 6772 7562 2e67 6974 2f0a 0a20 git/grub.git/.. │ │ │ │ │ -00000870: 2020 5468 6520 6272 616e 6368 6573 2061 The branches a │ │ │ │ │ -00000880: 7661 696c 6162 6c65 2061 7265 3a0a 0a27 vailable are:..' │ │ │ │ │ -00000890: 6d61 7374 6572 270a 2020 2020 204d 6169 master'. Mai │ │ │ │ │ -000008a0: 6e20 6465 7665 6c6f 706d 656e 7420 6272 n development br │ │ │ │ │ -000008b0: 616e 6368 2e0a 2767 7275 622d 6c65 6761 anch..'grub-lega │ │ │ │ │ -000008c0: 6379 270a 2020 2020 2047 5255 4220 302e cy'. GRUB 0. │ │ │ │ │ -000008d0: 3937 2063 6f64 6562 6173 652e 2020 4b65 97 codebase. Ke │ │ │ │ │ -000008e0: 7074 2066 6f72 2072 6566 6572 656e 6365 pt for reference │ │ │ │ │ -000008f0: 2061 6e64 206c 6567 616c 2072 6561 736f and legal reaso │ │ │ │ │ -00000900: 6e73 0a27 6d75 6c74 6962 6f6f 7427 0a20 ns.'multiboot'. │ │ │ │ │ -00000910: 2020 2020 4d75 6c74 6962 6f6f 7420 7370 Multiboot sp │ │ │ │ │ -00000920: 6563 6669 6361 7469 6f6e 0a27 6d75 6c74 ecfication.'mult │ │ │ │ │ -00000930: 6962 6f6f 7432 270a 2020 2020 204d 756c iboot2'. Mul │ │ │ │ │ -00000940: 7469 626f 6f74 3220 7370 6563 6669 6361 tiboot2 specfica │ │ │ │ │ -00000950: 7469 6f6e 0a27 6465 7665 6c6f 7065 7220 tion.'developer │ │ │ │ │ -00000960: 6272 616e 6368 6573 270a 2020 2020 2050 branches'. P │ │ │ │ │ -00000970: 7265 6669 7865 6420 7769 7468 2064 6576 refixed with dev │ │ │ │ │ -00000980: 656c 6f70 6572 206e 616d 652e 2020 4576 eloper name. Ev │ │ │ │ │ -00000990: 6572 7920 6465 7665 6c6f 7065 7220 6f66 ery developer of │ │ │ │ │ -000009a0: 2061 2074 6561 6d20 6d61 6e61 6765 730a a team manages. │ │ │ │ │ -000009b0: 2020 2020 2068 6973 206f 776e 2062 7261 his own bra │ │ │ │ │ -000009c0: 6e63 6865 732e 2020 4465 7665 6c6f 7065 nches. Develope │ │ │ │ │ -000009d0: 7220 6272 616e 6368 6573 2064 6f20 6e6f r branches do no │ │ │ │ │ -000009e0: 7420 6e65 6564 2063 6861 6e67 656c 6f67 t need changelog │ │ │ │ │ -000009f0: 0a20 2020 2020 656e 7472 6965 732e 0a0a . entries... │ │ │ │ │ -00000a00: 2020 204f 6e63 6520 796f 7520 6861 7665 Once you have │ │ │ │ │ -00000a10: 2075 7365 6420 2767 6974 2063 6c6f 6e65 used 'git clone │ │ │ │ │ -00000a20: 2720 746f 2066 6574 6368 2061 6e20 696e ' to fetch an in │ │ │ │ │ -00000a30: 6974 6961 6c20 636f 7079 206f 6620 6120 itial copy of a │ │ │ │ │ -00000a40: 6272 616e 6368 2c0a 796f 7520 6361 6e20 branch,.you can │ │ │ │ │ -00000a50: 7573 6520 2767 6974 2070 756c 6c27 2074 use 'git pull' t │ │ │ │ │ -00000a60: 6f20 6b65 6570 2069 7420 7570 2074 6f20 o keep it up to │ │ │ │ │ -00000a70: 6461 7465 2e20 2049 6620 796f 7520 6861 date. If you ha │ │ │ │ │ -00000a80: 7665 206d 6f64 6966 6965 6420 796f 7572 ve modified your │ │ │ │ │ -00000a90: 0a6c 6f63 616c 2076 6572 7369 6f6e 2c20 .local version, │ │ │ │ │ -00000aa0: 796f 7520 6d61 7920 6e65 6564 2074 6f20 you may need to │ │ │ │ │ -00000ab0: 7265 736f 6c76 6520 636f 6e66 6c69 6374 resolve conflict │ │ │ │ │ -00000ac0: 7320 7768 656e 2070 756c 6c69 6e67 2e0a s when pulling.. │ │ │ │ │ -00000ad0: 0a1f 0a46 696c 653a 2067 7275 622d 6465 ...File: grub-de │ │ │ │ │ -00000ae0: 762e 696e 666f 2c20 204e 6f64 653a 2043 v.info, Node: C │ │ │ │ │ -00000af0: 6f64 696e 6720 7374 796c 652c 2020 4e65 oding style, Ne │ │ │ │ │ -00000b00: 7874 3a20 4669 6e64 696e 6720 796f 7572 xt: Finding your │ │ │ │ │ -00000b10: 2077 6179 2061 726f 756e 642c 2020 5072 way around, Pr │ │ │ │ │ -00000b20: 6576 3a20 4765 7474 696e 6720 7468 6520 ev: Getting the │ │ │ │ │ -00000b30: 736f 7572 6365 2063 6f64 652c 2020 5570 source code, Up │ │ │ │ │ -00000b40: 3a20 546f 700a 0a32 2043 6f64 696e 6720 : Top..2 Coding │ │ │ │ │ -00000b50: 7374 796c 650a 2a2a 2a2a 2a2a 2a2a 2a2a style.********** │ │ │ │ │ -00000b60: 2a2a 2a2a 0a0a 4261 7369 6361 6c6c 7920 ****..Basically │ │ │ │ │ -00000b70: 7765 2066 6f6c 6c6f 7720 7468 6520 474e we follow the GN │ │ │ │ │ -00000b80: 5520 436f 6469 6e67 2053 7461 6e64 6172 U Coding Standar │ │ │ │ │ -00000b90: 6473 0a28 6874 7470 3a2f 2f77 7777 2e67 ds.(http://www.g │ │ │ │ │ -00000ba0: 6e75 2e6f 7267 2f70 7265 702f 7374 616e nu.org/prep/stan │ │ │ │ │ -00000bb0: 6461 7264 735f 746f 632e 6874 6d6c 292e dards_toc.html). │ │ │ │ │ -00000bc0: 2020 5765 2064 6566 696e 6520 6164 6469 We define addi │ │ │ │ │ -00000bd0: 7469 6f6e 616c 0a63 6f6e 7665 6e74 696f tional.conventio │ │ │ │ │ -00000be0: 6e73 2066 6f72 2047 5255 4220 6865 7265 ns for GRUB here │ │ │ │ │ -00000bf0: 2e0a 0a2a 204d 656e 753a 0a0a 2a20 4e61 ...* Menu:..* Na │ │ │ │ │ -00000c00: 6d69 6e67 2043 6f6e 7665 6e74 696f 6e73 ming Conventions │ │ │ │ │ -00000c10: 3a3a 0a2a 2046 756e 6374 696f 6e73 3a3a ::.* Functions:: │ │ │ │ │ -00000c20: 0a2a 2056 6172 6961 626c 6573 3a3a 0a2a .* Variables::.* │ │ │ │ │ -00000c30: 2054 7970 6573 3a3a 0a2a 204d 6163 726f Types::.* Macro │ │ │ │ │ -00000c40: 733a 3a0a 2a20 436f 6d6d 656e 7473 3a3a s::.* Comments:: │ │ │ │ │ -00000c50: 0a2a 204d 756c 7469 2d4c 696e 6520 436f .* Multi-Line Co │ │ │ │ │ -00000c60: 6d6d 656e 7473 3a3a 0a0a 1f0a 4669 6c65 mments::....File │ │ │ │ │ -00000c70: 3a20 6772 7562 2d64 6576 2e69 6e66 6f2c : grub-dev.info, │ │ │ │ │ -00000c80: 2020 4e6f 6465 3a20 4e61 6d69 6e67 2043 Node: Naming C │ │ │ │ │ -00000c90: 6f6e 7665 6e74 696f 6e73 2c20 204e 6578 onventions, Nex │ │ │ │ │ -00000ca0: 743a 2046 756e 6374 696f 6e73 2c20 2055 t: Functions, U │ │ │ │ │ -00000cb0: 703a 2043 6f64 696e 6720 7374 796c 650a p: Coding style. │ │ │ │ │ -00000cc0: 0a32 2e31 204e 616d 696e 6720 436f 6e76 .2.1 Naming Conv │ │ │ │ │ -00000cd0: 656e 7469 6f6e 730a 3d3d 3d3d 3d3d 3d3d entions.======== │ │ │ │ │ -00000ce0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a ==============.. │ │ │ │ │ -00000cf0: 416c 6c20 676c 6f62 616c 2073 796d 626f All global symbo │ │ │ │ │ -00000d00: 6c73 2028 692e 652e 2020 6675 6e63 7469 ls (i.e. functi │ │ │ │ │ -00000d10: 6f6e 732c 2076 6172 6961 626c 6573 2c20 ons, variables, │ │ │ │ │ -00000d20: 7479 7065 732c 2061 6e64 206d 6163 726f types, and macro │ │ │ │ │ -00000d30: 7329 206d 7573 740a 6861 7665 2074 6865 s) must.have the │ │ │ │ │ -00000d40: 2070 7265 6669 7820 6772 7562 5f20 6f72 prefix grub_ or │ │ │ │ │ -00000d50: 2047 5255 425f 2e20 2054 6865 2061 6c6c GRUB_. The all │ │ │ │ │ -00000d60: 2063 6170 6974 616c 2066 6f72 6d20 6973 capital form is │ │ │ │ │ -00000d70: 2075 7365 6420 6f6e 6c79 2062 790a 6d61 used only by.ma │ │ │ │ │ -00000d80: 6372 6f73 2e0a 0a1f 0a46 696c 653a 2067 cros.....File: g │ │ │ │ │ -00000d90: 7275 622d 6465 762e 696e 666f 2c20 204e rub-dev.info, N │ │ │ │ │ -00000da0: 6f64 653a 2046 756e 6374 696f 6e73 2c20 ode: Functions, │ │ │ │ │ -00000db0: 204e 6578 743a 2056 6172 6961 626c 6573 Next: Variables │ │ │ │ │ -00000dc0: 2c20 2050 7265 763a 204e 616d 696e 6720 , Prev: Naming │ │ │ │ │ -00000dd0: 436f 6e76 656e 7469 6f6e 732c 2020 5570 Conventions, Up │ │ │ │ │ -00000de0: 3a20 436f 6469 6e67 2073 7479 6c65 0a0a : Coding style.. │ │ │ │ │ -00000df0: 322e 3220 4675 6e63 7469 6f6e 730a 3d3d 2.2 Functions.== │ │ │ │ │ -00000e00: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a49 6620 ===========..If │ │ │ │ │ -00000e10: 6120 6675 6e63 7469 6f6e 2069 7320 676c a function is gl │ │ │ │ │ -00000e20: 6f62 616c 2c20 6974 7320 6e61 6d65 206d obal, its name m │ │ │ │ │ -00000e30: 7573 7420 6265 2070 7265 6669 7865 6420 ust be prefixed │ │ │ │ │ -00000e40: 7769 7468 2067 7275 625f 2061 6e64 206d with grub_ and m │ │ │ │ │ -00000e50: 7573 740a 636f 6e73 6973 7420 6f66 206f ust.consist of o │ │ │ │ │ -00000e60: 6e6c 7920 736d 616c 6c20 6c65 7474 6572 nly small letter │ │ │ │ │ -00000e70: 732e 2020 4966 2074 6865 2066 756e 6374 s. If the funct │ │ │ │ │ -00000e80: 696f 6e20 6265 6c6f 6e67 7320 746f 2061 ion belongs to a │ │ │ │ │ -00000e90: 2073 7065 6369 6669 630a 6675 6e63 7469 specific.functi │ │ │ │ │ -00000ea0: 6f6e 206d 6f64 756c 652c 2074 6865 206e on module, the n │ │ │ │ │ -00000eb0: 616d 6520 6d75 7374 2061 6c73 6f20 6265 ame must also be │ │ │ │ │ -00000ec0: 2070 7265 6669 7865 6420 7769 7468 2074 prefixed with t │ │ │ │ │ -00000ed0: 6865 206d 6f64 756c 6520 6e61 6d65 2e0a he module name.. │ │ │ │ │ -00000ee0: 466f 7220 6578 616d 706c 652c 2069 6620 For example, if │ │ │ │ │ -00000ef0: 6120 6675 6e63 7469 6f6e 2069 7320 666f a function is fo │ │ │ │ │ -00000f00: 7220 6669 6c65 2073 7973 7465 6d73 2c20 r file systems, │ │ │ │ │ -00000f10: 6974 7320 6e61 6d65 2069 7320 7072 6566 its name is pref │ │ │ │ │ -00000f20: 6978 6564 0a77 6974 6820 6772 7562 5f66 ixed.with grub_f │ │ │ │ │ -00000f30: 735f 2e20 2049 6620 6120 6675 6e63 7469 s_. If a functi │ │ │ │ │ -00000f40: 6f6e 2069 7320 666f 7220 4641 5420 6669 on is for FAT fi │ │ │ │ │ -00000f50: 6c65 2073 7973 7465 6d20 6275 7420 6e6f le system but no │ │ │ │ │ -00000f60: 7420 666f 7220 616c 6c0a 6669 6c65 2073 t for all.file s │ │ │ │ │ -00000f70: 7973 7465 6d73 2c20 6974 7320 6e61 6d65 ystems, its name │ │ │ │ │ -00000f80: 2069 7320 7072 6566 6978 6564 2077 6974 is prefixed wit │ │ │ │ │ -00000f90: 6820 6772 7562 5f66 735f 6661 745f 2e20 h grub_fs_fat_. │ │ │ │ │ -00000fa0: 2054 6865 2068 6965 7261 7263 6879 2069 The hierarchy i │ │ │ │ │ -00000fb0: 730a 6e6f 7465 6420 7468 6973 2077 6179 s.noted this way │ │ │ │ │ -00000fc0: 2e0a 0a20 2020 4166 7465 7220 6120 7072 ... After a pr │ │ │ │ │ -00000fd0: 6566 6978 2c20 6120 6675 6e63 7469 6f6e efix, a function │ │ │ │ │ -00000fe0: 206e 616d 6520 6d75 7374 2073 7461 7274 name must start │ │ │ │ │ -00000ff0: 2077 6974 6820 6120 7665 7262 2028 7375 with a verb (su │ │ │ │ │ -00001000: 6368 2061 7320 6765 740a 6f72 2069 7329 ch as get.or is) │ │ │ │ │ -00001010: 2e20 2049 7420 6d75 7374 206e 6f74 2062 . It must not b │ │ │ │ │ -00001020: 6520 6120 6e6f 756e 2e20 2053 6f6d 6520 e a noun. Some │ │ │ │ │ -00001030: 6b69 6e64 206f 6620 6162 6272 6576 6961 kind of abbrevia │ │ │ │ │ -00001040: 7469 6f6e 2069 7320 7065 726d 6974 7465 tion is permitte │ │ │ │ │ -00001050: 642c 0a61 7320 6c6f 6e67 2061 7320 6974 d,.as long as it │ │ │ │ │ -00001060: 2077 6f75 6c64 6e27 7420 6d61 6b65 2063 wouldn't make c │ │ │ │ │ -00001070: 6f64 6520 6c65 7373 2072 6561 6461 626c ode less readabl │ │ │ │ │ -00001080: 6520 2865 2e67 2e20 2069 6e69 7429 2e0a e (e.g. init).. │ │ │ │ │ -00001090: 0a20 2020 4966 2061 2066 756e 6374 696f . If a functio │ │ │ │ │ -000010a0: 6e20 6973 206c 6f63 616c 2c20 6974 7320 n is local, its │ │ │ │ │ -000010b0: 6e61 6d65 206d 6179 206e 6f74 2073 7461 name may not sta │ │ │ │ │ -000010c0: 7274 2077 6974 6820 616e 7920 7072 6566 rt with any pref │ │ │ │ │ -000010d0: 6978 2e20 2049 740a 6d75 7374 2073 7461 ix. It.must sta │ │ │ │ │ -000010e0: 7274 2077 6974 6820 6120 7665 7262 2e0a rt with a verb.. │ │ │ │ │ -000010f0: 0a1f 0a46 696c 653a 2067 7275 622d 6465 ...File: grub-de │ │ │ │ │ -00001100: 762e 696e 666f 2c20 204e 6f64 653a 2056 v.info, Node: V │ │ │ │ │ -00001110: 6172 6961 626c 6573 2c20 204e 6578 743a ariables, Next: │ │ │ │ │ -00001120: 2054 7970 6573 2c20 2050 7265 763a 2046 Types, Prev: F │ │ │ │ │ -00001130: 756e 6374 696f 6e73 2c20 2055 703a 2043 unctions, Up: C │ │ │ │ │ -00001140: 6f64 696e 6720 7374 796c 650a 0a32 2e33 oding style..2.3 │ │ │ │ │ -00001150: 2056 6172 6961 626c 6573 0a3d 3d3d 3d3d Variables.===== │ │ │ │ │ -00001160: 3d3d 3d3d 3d3d 3d3d 0a0a 5468 6520 7275 ========..The ru │ │ │ │ │ -00001170: 6c65 2069 7320 6d6f 7374 6c79 2074 6865 le is mostly the │ │ │ │ │ -00001180: 2073 616d 6520 6173 2066 756e 6374 696f same as functio │ │ │ │ │ -00001190: 6e73 2c20 6173 206e 6f74 6564 2061 626f ns, as noted abo │ │ │ │ │ -000011a0: 7665 2e20 2049 6620 6120 7661 7269 6162 ve. If a variab │ │ │ │ │ -000011b0: 6c65 0a69 7320 676c 6f62 616c 2c20 6974 le.is global, it │ │ │ │ │ -000011c0: 7320 6e61 6d65 206d 7573 7420 6265 2070 s name must be p │ │ │ │ │ -000011d0: 7265 6669 7865 6420 7769 7468 2067 7275 refixed with gru │ │ │ │ │ -000011e0: 625f 2061 6e64 206d 7573 7420 636f 6e73 b_ and must cons │ │ │ │ │ -000011f0: 6973 7420 6f66 206f 6e6c 790a 736d 616c ist of only.smal │ │ │ │ │ -00001200: 6c20 6c65 7474 6572 732e 2020 4966 2074 l letters. If t │ │ │ │ │ -00001210: 6865 2076 6172 6961 626c 6520 6265 6c6f he variable belo │ │ │ │ │ -00001220: 6e67 7320 746f 2061 2073 7065 6369 6669 ngs to a specifi │ │ │ │ │ -00001230: 6320 6675 6e63 7469 6f6e 206d 6f64 756c c function modul │ │ │ │ │ -00001240: 652c 0a74 6865 206e 616d 6520 6d75 7374 e,.the name must │ │ │ │ │ -00001250: 2061 6c73 6f20 6265 2070 7265 6669 7865 also be prefixe │ │ │ │ │ -00001260: 6420 7769 7468 2074 6865 206d 6f64 756c d with the modul │ │ │ │ │ -00001270: 6520 6e61 6d65 2e20 2046 6f72 2065 7861 e name. For exa │ │ │ │ │ -00001280: 6d70 6c65 2c20 6966 2061 0a66 756e 6374 mple, if a.funct │ │ │ │ │ -00001290: 696f 6e20 6973 2066 6f72 2064 796e 616d ion is for dynam │ │ │ │ │ -000012a0: 6963 206c 6f61 6469 6e67 2c20 6974 7320 ic loading, its │ │ │ │ │ -000012b0: 6e61 6d65 2069 7320 7072 6566 6978 6564 name is prefixed │ │ │ │ │ -000012c0: 2077 6974 6820 6772 7562 5f64 6c5f 2e20 with grub_dl_. │ │ │ │ │ -000012d0: 2049 660a 6120 7661 7269 6162 6c65 2069 If.a variable i │ │ │ │ │ -000012e0: 7320 666f 7220 454c 4620 6275 7420 6e6f s for ELF but no │ │ │ │ │ -000012f0: 7420 666f 7220 616c 6c20 6479 6e61 6d69 t for all dynami │ │ │ │ │ -00001300: 6320 6c6f 6164 696e 6720 7379 7374 656d c loading system │ │ │ │ │ -00001310: 732c 2069 7473 206e 616d 650a 6973 2070 s, its name.is p │ │ │ │ │ -00001320: 7265 6669 7865 6420 7769 7468 2067 7275 refixed with gru │ │ │ │ │ -00001330: 625f 646c 5f65 6c66 5f2e 0a0a 2020 2041 b_dl_elf_... A │ │ │ │ │ -00001340: 6674 6572 2061 2070 7265 6669 782c 2061 fter a prefix, a │ │ │ │ │ -00001350: 2076 6172 6961 626c 6520 6e61 6d65 206d variable name m │ │ │ │ │ -00001360: 7573 7420 7374 6172 7420 7769 7468 2061 ust start with a │ │ │ │ │ -00001370: 206e 6f75 6e20 6f72 2061 6e0a 6164 6a65 noun or an.adje │ │ │ │ │ -00001380: 6374 6976 6520 2873 7563 6820 6173 206e ctive (such as n │ │ │ │ │ -00001390: 616d 6520 6f72 206c 6f6e 6729 2061 6e64 ame or long) and │ │ │ │ │ -000013a0: 2069 7420 7368 6f75 6c64 2065 6e64 2077 it should end w │ │ │ │ │ -000013b0: 6974 6820 6120 6e6f 756e 2e20 2053 6f6d ith a noun. Som │ │ │ │ │ -000013c0: 650a 6b69 6e64 206f 6620 6162 6272 6576 e.kind of abbrev │ │ │ │ │ -000013d0: 6961 7469 6f6e 2069 7320 7065 726d 6974 iation is permit │ │ │ │ │ -000013e0: 7465 642c 2061 7320 6c6f 6e67 2061 7320 ted, as long as │ │ │ │ │ -000013f0: 6974 2077 6f75 6c64 6e27 7420 6d61 6b65 it wouldn't make │ │ │ │ │ -00001400: 2063 6f64 6520 6c65 7373 0a72 6561 6461 code less.reada │ │ │ │ │ -00001410: 626c 6520 2865 2e67 2e20 2069 3138 6e29 ble (e.g. i18n) │ │ │ │ │ -00001420: 2e0a 0a20 2020 4966 2061 2076 6172 6961 ... If a varia │ │ │ │ │ -00001430: 626c 6520 6973 2067 6c6f 6261 6c20 696e ble is global in │ │ │ │ │ -00001440: 2074 6865 2073 636f 7065 206f 6620 6120 the scope of a │ │ │ │ │ -00001450: 7369 6e67 6c65 2066 696c 6520 2869 2e65 single file (i.e │ │ │ │ │ -00001460: 2e20 2069 7420 6973 0a64 6563 6c61 7265 . it is.declare │ │ │ │ │ -00001470: 6420 7769 7468 2073 7461 7469 6329 2c20 d with static), │ │ │ │ │ -00001480: 6974 7320 6e61 6d65 206d 6179 206e 6f74 its name may not │ │ │ │ │ -00001490: 2073 7461 7274 2077 6974 6820 616e 7920 start with any │ │ │ │ │ -000014a0: 7072 6566 6978 2e20 2049 7420 6d75 7374 prefix. It must │ │ │ │ │ -000014b0: 0a73 7461 7274 2077 6974 6820 6120 6e6f .start with a no │ │ │ │ │ -000014c0: 756e 206f 7220 616e 2061 646a 6563 7469 un or an adjecti │ │ │ │ │ -000014d0: 7665 2e0a 0a20 2020 4966 2061 2076 6172 ve... If a var │ │ │ │ │ -000014e0: 6961 626c 6520 6973 206c 6f63 616c 2c20 iable is local, │ │ │ │ │ -000014f0: 796f 7520 6d61 7920 6368 6f6f 7365 2061 you may choose a │ │ │ │ │ -00001500: 6e79 2073 686f 7274 6572 206e 616d 652c ny shorter name, │ │ │ │ │ -00001510: 2061 7320 6c6f 6e67 2061 730a 6974 2077 as long as.it w │ │ │ │ │ -00001520: 6f75 6c64 6e27 7420 6d61 6b65 2063 6f64 ouldn't make cod │ │ │ │ │ -00001530: 6520 6c65 7373 2072 6561 6461 626c 6520 e less readable │ │ │ │ │ -00001540: 2865 2e67 2e20 2069 292e 0a0a 1f0a 4669 (e.g. i).....Fi │ │ │ │ │ -00001550: 6c65 3a20 6772 7562 2d64 6576 2e69 6e66 le: grub-dev.inf │ │ │ │ │ -00001560: 6f2c 2020 4e6f 6465 3a20 5479 7065 732c o, Node: Types, │ │ │ │ │ -00001570: 2020 4e65 7874 3a20 4d61 6372 6f73 2c20 Next: Macros, │ │ │ │ │ -00001580: 2050 7265 763a 2056 6172 6961 626c 6573 Prev: Variables │ │ │ │ │ -00001590: 2c20 2055 703a 2043 6f64 696e 6720 7374 , Up: Coding st │ │ │ │ │ -000015a0: 796c 650a 0a32 2e34 2054 7970 6573 0a3d yle..2.4 Types.= │ │ │ │ │ -000015b0: 3d3d 3d3d 3d3d 3d3d 0a0a 5468 6520 6e61 ========..The na │ │ │ │ │ -000015c0: 6d65 206f 6620 6120 7479 7065 206d 7573 me of a type mus │ │ │ │ │ -000015d0: 7420 6265 2070 7265 6669 7865 6420 7769 t be prefixed wi │ │ │ │ │ -000015e0: 7468 2067 7275 625f 2061 6e64 206d 7573 th grub_ and mus │ │ │ │ │ -000015f0: 7420 636f 6e73 6973 7420 6f66 206f 6e6c t consist of onl │ │ │ │ │ -00001600: 790a 736d 616c 6c20 6c65 7474 6572 732e y.small letters. │ │ │ │ │ -00001610: 2020 4966 2074 6865 2074 7970 6520 6265 If the type be │ │ │ │ │ -00001620: 6c6f 6e67 7320 746f 2061 2073 7065 6369 longs to a speci │ │ │ │ │ -00001630: 6669 6320 6675 6e63 7469 6f6e 206d 6f64 fic function mod │ │ │ │ │ -00001640: 756c 652c 2074 6865 0a6e 616d 6520 6d75 ule, the.name mu │ │ │ │ │ -00001650: 7374 2061 6c73 6f20 6265 2070 7265 6669 st also be prefi │ │ │ │ │ -00001660: 7865 6420 7769 7468 2074 6865 206d 6f64 xed with the mod │ │ │ │ │ -00001670: 756c 6520 6e61 6d65 2e20 2046 6f72 2065 ule name. For e │ │ │ │ │ -00001680: 7861 6d70 6c65 2c20 6966 2061 2074 7970 xample, if a typ │ │ │ │ │ -00001690: 650a 6973 2066 6f72 204f 5320 6c6f 6164 e.is for OS load │ │ │ │ │ -000016a0: 6572 732c 2069 7473 206e 616d 6520 6973 ers, its name is │ │ │ │ │ -000016b0: 2070 7265 6669 7865 6420 7769 7468 2067 prefixed with g │ │ │ │ │ -000016c0: 7275 625f 6c6f 6164 6572 5f2e 2020 4966 rub_loader_. If │ │ │ │ │ -000016d0: 2061 2074 7970 6520 6973 0a66 6f72 204d a type is.for M │ │ │ │ │ -000016e0: 756c 7469 626f 6f74 2062 7574 206e 6f74 ultiboot but not │ │ │ │ │ -000016f0: 2066 6f72 2061 6c6c 204f 5320 6c6f 6164 for all OS load │ │ │ │ │ -00001700: 6572 732c 2069 7473 206e 616d 6520 6973 ers, its name is │ │ │ │ │ -00001710: 2070 7265 6669 7865 6420 7769 7468 0a67 prefixed with.g │ │ │ │ │ -00001720: 7275 625f 6c6f 6164 6572 5f6c 696e 7578 rub_loader_linux │ │ │ │ │ -00001730: 5f2e 0a0a 2020 2054 6865 206e 616d 6520 _... The name │ │ │ │ │ -00001740: 6d75 7374 2062 6520 7375 6666 6978 6564 must be suffixed │ │ │ │ │ -00001750: 2077 6974 6820 5f74 2c20 746f 2065 6d70 with _t, to emp │ │ │ │ │ -00001760: 6861 7369 7a65 2074 6865 2066 6163 7420 hasize the fact │ │ │ │ │ -00001770: 7468 6174 2069 7420 6973 2061 0a74 7970 that it is a.typ │ │ │ │ │ -00001780: 6520 6275 7420 6e6f 7420 6120 7661 7269 e but not a vari │ │ │ │ │ -00001790: 6162 6c65 206f 7220 6120 6675 6e63 7469 able or a functi │ │ │ │ │ -000017a0: 6f6e 2e0a 0a1f 0a46 696c 653a 2067 7275 on.....File: gru │ │ │ │ │ -000017b0: 622d 6465 762e 696e 666f 2c20 204e 6f64 b-dev.info, Nod │ │ │ │ │ -000017c0: 653a 204d 6163 726f 732c 2020 4e65 7874 e: Macros, Next │ │ │ │ │ -000017d0: 3a20 436f 6d6d 656e 7473 2c20 2050 7265 : Comments, Pre │ │ │ │ │ -000017e0: 763a 2054 7970 6573 2c20 2055 703a 2043 v: Types, Up: C │ │ │ │ │ -000017f0: 6f64 696e 6720 7374 796c 650a 0a32 2e35 oding style..2.5 │ │ │ │ │ -00001800: 204d 6163 726f 730a 3d3d 3d3d 3d3d 3d3d Macros.======== │ │ │ │ │ -00001810: 3d3d 0a0a 4966 2061 206d 6163 726f 2069 ==..If a macro i │ │ │ │ │ -00001820: 7320 676c 6f62 616c 2c20 6974 7320 6e61 s global, its na │ │ │ │ │ -00001830: 6d65 206d 7573 7420 6265 2070 7265 6669 me must be prefi │ │ │ │ │ -00001840: 7865 6420 7769 7468 2047 5255 425f 2061 xed with GRUB_ a │ │ │ │ │ -00001850: 6e64 206d 7573 740a 636f 6e73 6973 7420 nd must.consist │ │ │ │ │ -00001860: 6f66 206f 6e6c 7920 6c61 7267 6520 6c65 of only large le │ │ │ │ │ -00001870: 7474 6572 732e 2020 4f74 6865 7220 7275 tters. Other ru │ │ │ │ │ -00001880: 6c65 7320 6172 6520 7468 6520 7361 6d65 les are the same │ │ │ │ │ -00001890: 2061 7320 6675 6e63 7469 6f6e 7320 6f72 as functions or │ │ │ │ │ -000018a0: 0a76 6172 6961 626c 6573 2c20 6465 7065 .variables, depe │ │ │ │ │ -000018b0: 6e64 696e 6720 6f6e 2077 6865 7468 6572 nding on whether │ │ │ │ │ -000018c0: 2061 206d 6163 726f 2069 7320 7573 6564 a macro is used │ │ │ │ │ -000018d0: 206c 696b 6520 6120 6675 6e63 7469 6f6e like a function │ │ │ │ │ -000018e0: 206f 7220 610a 7661 7269 6162 6c65 2e0a or a.variable.. │ │ │ │ │ -000018f0: 0a1f 0a46 696c 653a 2067 7275 622d 6465 ...File: grub-de │ │ │ │ │ -00001900: 762e 696e 666f 2c20 204e 6f64 653a 2043 v.info, Node: C │ │ │ │ │ -00001910: 6f6d 6d65 6e74 732c 2020 4e65 7874 3a20 omments, Next: │ │ │ │ │ -00001920: 4d75 6c74 692d 4c69 6e65 2043 6f6d 6d65 Multi-Line Comme │ │ │ │ │ -00001930: 6e74 732c 2020 5072 6576 3a20 4d61 6372 nts, Prev: Macr │ │ │ │ │ -00001940: 6f73 2c20 2055 703a 2043 6f64 696e 6720 os, Up: Coding │ │ │ │ │ -00001950: 7374 796c 650a 0a32 2e36 2043 6f6d 6d65 style..2.6 Comme │ │ │ │ │ -00001960: 6e74 730a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d nts.============ │ │ │ │ │ -00001970: 0a0a 416c 6c20 636f 6d6d 656e 7473 2073 ..All comments s │ │ │ │ │ -00001980: 6861 6c6c 2062 6520 432d 7374 796c 6520 hall be C-style │ │ │ │ │ -00001990: 636f 6d6d 656e 7473 2c20 6f66 2074 6865 comments, of the │ │ │ │ │ -000019a0: 2066 6f72 6d20 272f 2a20 2e2e 2e20 2a2f form '/* ... */ │ │ │ │ │ -000019b0: 272e 2020 410a 636f 6d6d 656e 7420 6361 '. A.comment ca │ │ │ │ │ -000019c0: 6e20 6265 2070 6c61 6365 6420 696d 6d65 n be placed imme │ │ │ │ │ -000019d0: 6469 6174 656c 7920 7072 6563 6564 696e diately precedin │ │ │ │ │ -000019e0: 6720 7468 6520 656e 7469 7479 2069 7420 g the entity it │ │ │ │ │ -000019f0: 6465 7363 7269 6265 7320 6f72 0a69 7420 describes or.it │ │ │ │ │ -00001a00: 6361 6e20 6265 2070 6c61 6365 6420 746f can be placed to │ │ │ │ │ -00001a10: 6765 7468 6572 2077 6974 6820 636f 6465 gether with code │ │ │ │ │ -00001a20: 2c20 7661 7269 6162 6c65 2064 6563 6c61 , variable decla │ │ │ │ │ -00001a30: 7261 7469 6f6e 732c 206f 7220 6f74 6865 rations, or othe │ │ │ │ │ -00001a40: 720a 6e6f 6e2d 636f 6d6d 656e 7420 656e r.non-comment en │ │ │ │ │ -00001a50: 7469 7469 6573 2e20 2048 6f77 6576 6572 tities. However │ │ │ │ │ -00001a60: 2c20 6974 2069 7320 7265 636f 6d6d 656e , it is recommen │ │ │ │ │ -00001a70: 6465 6420 746f 206e 6f74 206d 6978 2076 ded to not mix v │ │ │ │ │ -00001a80: 6172 696f 7573 0a66 6f72 6d73 2065 7370 arious.forms esp │ │ │ │ │ -00001a90: 6563 6961 6c6c 7920 696e 2074 7970 6573 ecially in types │ │ │ │ │ -00001aa0: 2f73 7472 7563 7473 2064 6573 6372 6970 /structs descrip │ │ │ │ │ -00001ab0: 7469 6f6e 732e 0a0a 2020 2041 6363 6570 tions... Accep │ │ │ │ │ -00001ac0: 7461 626c 653a 0a20 2020 2020 2f2a 2054 table:. /* T │ │ │ │ │ -00001ad0: 6865 2070 6167 6520 2320 7468 6174 2069 he page # that i │ │ │ │ │ -00001ae0: 7320 7468 6520 6672 6f6e 7420 6275 6666 s the front buff │ │ │ │ │ -00001af0: 6572 2e20 2a2f 0a20 2020 2020 696e 7420 er. */. int │ │ │ │ │ -00001b00: 6469 7370 6c61 7965 645f 7061 6765 3b0a displayed_page;. │ │ │ │ │ -00001b10: 0a20 2020 2020 696e 7420 7265 6e64 6572 . int render │ │ │ │ │ -00001b20: 5f70 6167 653b 202f 2a20 5468 6520 7061 _page; /* The pa │ │ │ │ │ -00001b30: 6765 2023 2074 6861 7420 6973 2074 6865 ge # that is the │ │ │ │ │ -00001b40: 2062 6163 6b20 6275 6666 6572 2e20 2a2f back buffer. */ │ │ │ │ │ -00001b50: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2d64 ....File: grub-d │ │ │ │ │ -00001b60: 6576 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ev.info, Node: │ │ │ │ │ -00001b70: 4d75 6c74 692d 4c69 6e65 2043 6f6d 6d65 Multi-Line Comme │ │ │ │ │ -00001b80: 6e74 732c 2020 5072 6576 3a20 436f 6d6d nts, Prev: Comm │ │ │ │ │ -00001b90: 656e 7473 2c20 2055 703a 2043 6f64 696e ents, Up: Codin │ │ │ │ │ -00001ba0: 6720 7374 796c 650a 0a32 2e37 204d 756c g style..2.7 Mul │ │ │ │ │ -00001bb0: 7469 2d4c 696e 6520 436f 6d6d 656e 7473 ti-Line Comments │ │ │ │ │ -00001bc0: 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d .=============== │ │ │ │ │ -00001bd0: 3d3d 3d3d 3d3d 3d3d 0a0a 436f 6d6d 656e ========..Commen │ │ │ │ │ -00001be0: 7473 2073 7061 6e6e 696e 6720 6d75 6c74 ts spanning mult │ │ │ │ │ -00001bf0: 6970 6c65 206c 696e 6573 2073 6861 6c6c iple lines shall │ │ │ │ │ -00001c00: 2062 6520 666f 726d 6174 7465 6420 7769 be formatted wi │ │ │ │ │ -00001c10: 7468 2061 6c6c 206c 696e 6573 2061 6674 th all lines aft │ │ │ │ │ -00001c20: 6572 0a74 6865 2066 6972 7374 2061 6c69 er.the first ali │ │ │ │ │ -00001c30: 676e 6564 2077 6974 6820 7468 6520 6669 gned with the fi │ │ │ │ │ -00001c40: 7273 7420 6c69 6e65 2e20 2041 7374 6572 rst line. Aster │ │ │ │ │ -00001c50: 6973 6b20 6368 6172 6163 7465 7273 2073 isk characters s │ │ │ │ │ -00001c60: 686f 756c 6420 6265 0a72 6570 6561 7465 hould be.repeate │ │ │ │ │ -00001c70: 6420 6174 2074 6865 2073 7461 7274 206f d at the start o │ │ │ │ │ -00001c80: 6620 6561 6368 2073 7562 7365 7175 656e f each subsequen │ │ │ │ │ -00001c90: 7420 6c69 6e65 2e0a 0a20 2020 4163 6365 t line... Acce │ │ │ │ │ -00001ca0: 7074 6162 6c65 3a0a 2020 2020 202f 2a0a ptable:. /*. │ │ │ │ │ -00001cb0: 2020 2020 2020 2a20 5468 6973 2069 7320 * This is │ │ │ │ │ -00001cc0: 6120 636f 6d6d 656e 740a 2020 2020 2020 a comment. │ │ │ │ │ -00001cd0: 2a20 7768 6963 6820 7370 616e 7320 6d75 * which spans mu │ │ │ │ │ -00001ce0: 6c74 6970 6c65 206c 696e 6573 2e0a 2020 ltiple lines.. │ │ │ │ │ -00001cf0: 2020 2020 2a20 4974 2069 7320 6c6f 6e67 * It is long │ │ │ │ │ -00001d00: 2e0a 2020 2020 2020 2a2f 0a0a 2020 2055 .. */.. U │ │ │ │ │ -00001d10: 6e61 6363 6570 7461 626c 653a 0a20 2020 nacceptable:. │ │ │ │ │ -00001d20: 2020 2f2a 2054 6869 7320 6973 2061 2063 /* This is a c │ │ │ │ │ -00001d30: 6f6d 6d65 6e74 0a20 2020 2020 2020 2077 omment. w │ │ │ │ │ -00001d40: 6869 6368 2073 7061 6e73 206d 756c 7469 hich spans multi │ │ │ │ │ -00001d50: 706c 6520 6c69 6e65 732e 0a20 2020 2020 ple lines.. │ │ │ │ │ -00001d60: 2020 2049 7420 6973 206c 6f6e 672e 202a It is long. * │ │ │ │ │ -00001d70: 2f0a 0a20 2020 2020 2f2a 0a20 2020 2020 /.. /*. │ │ │ │ │ -00001d80: 202a 2054 6869 7320 6973 2061 2063 6f6d * This is a com │ │ │ │ │ -00001d90: 6d65 6e74 0a20 2020 2020 202a 2077 6869 ment. * whi │ │ │ │ │ -00001da0: 6368 2073 7061 6e73 206d 756c 7469 706c ch spans multipl │ │ │ │ │ -00001db0: 6520 6c69 6e65 732e 0a20 2020 2020 202a e lines.. * │ │ │ │ │ -00001dc0: 2049 7420 6973 206c 6f6e 672e 202a 2f0a It is long. */. │ │ │ │ │ -00001dd0: 0a20 2020 2020 2f2a 2054 6869 7320 6973 . /* This is │ │ │ │ │ -00001de0: 2061 2063 6f6d 6d65 6e74 0a20 2020 2020 a comment. │ │ │ │ │ -00001df0: 202a 2077 6869 6368 2073 7061 6e73 206d * which spans m │ │ │ │ │ -00001e00: 756c 7469 706c 6520 6c69 6e65 732e 0a20 ultiple lines.. │ │ │ │ │ -00001e10: 2020 2020 202a 2049 7420 6973 206c 6f6e * It is lon │ │ │ │ │ -00001e20: 672e 0a20 2020 2020 202a 2f0a 0a20 2020 g.. */.. │ │ │ │ │ -00001e30: 496e 2070 6172 7469 6375 6c61 7220 6669 In particular fi │ │ │ │ │ -00001e40: 7273 7420 756e 6163 6365 7074 6162 6c65 rst unacceptable │ │ │ │ │ -00001e50: 2066 6f72 6d20 6d61 6b65 7320 636f 6d6d form makes comm │ │ │ │ │ -00001e60: 656e 7420 6469 6666 6963 756c 7420 746f ent difficult to │ │ │ │ │ -00001e70: 0a64 6973 7469 6e67 7569 7368 2066 726f .distinguish fro │ │ │ │ │ -00001e80: 6d20 7468 6520 636f 6465 2069 7473 656c m the code itsel │ │ │ │ │ -00001e90: 662e 2020 4573 7065 6369 616c 6c79 2069 f. Especially i │ │ │ │ │ -00001ea0: 6620 6974 2063 6f6e 7461 696e 7320 7468 f it contains th │ │ │ │ │ -00001eb0: 6520 636f 6465 0a73 6e69 7070 6574 7320 e code.snippets │ │ │ │ │ -00001ec0: 616e 642f 6f72 2069 7320 6c6f 6e67 2e20 and/or is long. │ │ │ │ │ -00001ed0: 2053 6f2c 2069 7473 2075 7361 6765 2069 So, its usage i │ │ │ │ │ -00001ee0: 7320 6469 7361 6c6c 6f77 6564 2e0a 0a1f s disallowed.... │ │ │ │ │ -00001ef0: 0a46 696c 653a 2067 7275 622d 6465 762e .File: grub-dev. │ │ │ │ │ -00001f00: 696e 666f 2c20 204e 6f64 653a 2046 696e info, Node: Fin │ │ │ │ │ -00001f10: 6469 6e67 2079 6f75 7220 7761 7920 6172 ding your way ar │ │ │ │ │ -00001f20: 6f75 6e64 2c20 204e 6578 743a 2043 6f6e ound, Next: Con │ │ │ │ │ -00001f30: 7472 6962 7574 696e 6720 4368 616e 6765 tributing Change │ │ │ │ │ -00001f40: 732c 2020 5072 6576 3a20 436f 6469 6e67 s, Prev: Coding │ │ │ │ │ -00001f50: 2073 7479 6c65 2c20 2055 703a 2054 6f70 style, Up: Top │ │ │ │ │ -00001f60: 0a0a 3320 4669 6e64 696e 6720 796f 7572 ..3 Finding your │ │ │ │ │ -00001f70: 2077 6179 2061 726f 756e 640a 2a2a 2a2a way around.**** │ │ │ │ │ +000007a0: 2a2a 2a0a 0a47 5255 4220 6973 206d 6169 ***..GRUB is mai │ │ │ │ │ +000007b0: 6e74 6169 6e65 6420 7573 696e 6720 7468 ntained using th │ │ │ │ │ +000007c0: 6520 3c47 4954 2072 6576 6973 696f 6e20 e . │ │ │ │ │ +000007e0: 2020 546f 2066 6574 6368 3a0a 0a20 2020 To fetch:.. │ │ │ │ │ +000007f0: 2020 6769 7420 636c 6f6e 6520 6769 743a git clone git: │ │ │ │ │ +00000800: 2f2f 6769 742e 7376 2e67 6e75 2e6f 7267 //git.sv.gnu.org │ │ │ │ │ +00000810: 2f67 7275 622e 6769 740a 0a20 2020 5765 /grub.git.. We │ │ │ │ │ +00000820: 6220 6163 6365 7373 2069 7320 6176 6169 b access is avai │ │ │ │ │ +00000830: 6c61 626c 6520 756e 6465 720a 2020 2020 lable under. │ │ │ │ │ +00000840: 2068 7474 703a 2f2f 6769 742e 7361 7661 http://git.sava │ │ │ │ │ +00000850: 6e6e 6168 2e67 6e75 2e6f 7267 2f63 6769 nnah.gnu.org/cgi │ │ │ │ │ +00000860: 742f 6772 7562 2e67 6974 2f0a 0a20 2020 t/grub.git/.. │ │ │ │ │ +00000870: 5468 6520 6272 616e 6368 6573 2061 7661 The branches ava │ │ │ │ │ +00000880: 696c 6162 6c65 2061 7265 3a0a 0a27 6d61 ilable are:..'ma │ │ │ │ │ +00000890: 7374 6572 270a 2020 2020 204d 6169 6e20 ster'. Main │ │ │ │ │ +000008a0: 6465 7665 6c6f 706d 656e 7420 6272 616e development bran │ │ │ │ │ +000008b0: 6368 2e0a 2767 7275 622d 6c65 6761 6379 ch..'grub-legacy │ │ │ │ │ +000008c0: 270a 2020 2020 2047 5255 4220 302e 3937 '. GRUB 0.97 │ │ │ │ │ +000008d0: 2063 6f64 6562 6173 652e 2020 4b65 7074 codebase. Kept │ │ │ │ │ +000008e0: 2066 6f72 2072 6566 6572 656e 6365 2061 for reference a │ │ │ │ │ +000008f0: 6e64 206c 6567 616c 2072 6561 736f 6e73 nd legal reasons │ │ │ │ │ +00000900: 0a27 6d75 6c74 6962 6f6f 7427 0a20 2020 .'multiboot'. │ │ │ │ │ +00000910: 2020 4d75 6c74 6962 6f6f 7420 7370 6563 Multiboot spec │ │ │ │ │ +00000920: 6669 6361 7469 6f6e 0a27 6d75 6c74 6962 fication.'multib │ │ │ │ │ +00000930: 6f6f 7432 270a 2020 2020 204d 756c 7469 oot2'. Multi │ │ │ │ │ +00000940: 626f 6f74 3220 7370 6563 6669 6361 7469 boot2 specficati │ │ │ │ │ +00000950: 6f6e 0a27 6465 7665 6c6f 7065 7220 6272 on.'developer br │ │ │ │ │ +00000960: 616e 6368 6573 270a 2020 2020 2050 7265 anches'. Pre │ │ │ │ │ +00000970: 6669 7865 6420 7769 7468 2064 6576 656c fixed with devel │ │ │ │ │ +00000980: 6f70 6572 206e 616d 652e 2020 4576 6572 oper name. Ever │ │ │ │ │ +00000990: 7920 6465 7665 6c6f 7065 7220 6f66 2061 y developer of a │ │ │ │ │ +000009a0: 2074 6561 6d20 6d61 6e61 6765 730a 2020 team manages. │ │ │ │ │ +000009b0: 2020 2068 6973 206f 776e 2062 7261 6e63 his own branc │ │ │ │ │ +000009c0: 6865 732e 2020 4465 7665 6c6f 7065 7220 hes. Developer │ │ │ │ │ +000009d0: 6272 616e 6368 6573 2064 6f20 6e6f 7420 branches do not │ │ │ │ │ +000009e0: 6e65 6564 2063 6861 6e67 656c 6f67 0a20 need changelog. │ │ │ │ │ +000009f0: 2020 2020 656e 7472 6965 732e 0a0a 2020 entries... │ │ │ │ │ +00000a00: 204f 6e63 6520 796f 7520 6861 7665 2075 Once you have u │ │ │ │ │ +00000a10: 7365 6420 2767 6974 2063 6c6f 6e65 2720 sed 'git clone' │ │ │ │ │ +00000a20: 746f 2066 6574 6368 2061 6e20 696e 6974 to fetch an init │ │ │ │ │ +00000a30: 6961 6c20 636f 7079 206f 6620 6120 6272 ial copy of a br │ │ │ │ │ +00000a40: 616e 6368 2c0a 796f 7520 6361 6e20 7573 anch,.you can us │ │ │ │ │ +00000a50: 6520 2767 6974 2070 756c 6c27 2074 6f20 e 'git pull' to │ │ │ │ │ +00000a60: 6b65 6570 2069 7420 7570 2074 6f20 6461 keep it up to da │ │ │ │ │ +00000a70: 7465 2e20 2049 6620 796f 7520 6861 7665 te. If you have │ │ │ │ │ +00000a80: 206d 6f64 6966 6965 6420 796f 7572 0a6c modified your.l │ │ │ │ │ +00000a90: 6f63 616c 2076 6572 7369 6f6e 2c20 796f ocal version, yo │ │ │ │ │ +00000aa0: 7520 6d61 7920 6e65 6564 2074 6f20 7265 u may need to re │ │ │ │ │ +00000ab0: 736f 6c76 6520 636f 6e66 6c69 6374 7320 solve conflicts │ │ │ │ │ +00000ac0: 7768 656e 2070 756c 6c69 6e67 2e0a 0a1f when pulling.... │ │ │ │ │ +00000ad0: 0a46 696c 653a 2067 7275 622d 6465 762e .File: grub-dev. │ │ │ │ │ +00000ae0: 696e 666f 2c20 204e 6f64 653a 2043 6f64 info, Node: Cod │ │ │ │ │ +00000af0: 696e 6720 7374 796c 652c 2020 4e65 7874 ing style, Next │ │ │ │ │ +00000b00: 3a20 4669 6e64 696e 6720 796f 7572 2077 : Finding your w │ │ │ │ │ +00000b10: 6179 2061 726f 756e 642c 2020 5072 6576 ay around, Prev │ │ │ │ │ +00000b20: 3a20 4765 7474 696e 6720 7468 6520 736f : Getting the so │ │ │ │ │ +00000b30: 7572 6365 2063 6f64 652c 2020 5570 3a20 urce code, Up: │ │ │ │ │ +00000b40: 546f 700a 0a32 2043 6f64 696e 6720 7374 Top..2 Coding st │ │ │ │ │ +00000b50: 796c 650a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a yle.************ │ │ │ │ │ +00000b60: 2a2a 0a0a 4261 7369 6361 6c6c 7920 7765 **..Basically we │ │ │ │ │ +00000b70: 2066 6f6c 6c6f 7720 7468 6520 474e 5520 follow the GNU │ │ │ │ │ +00000b80: 436f 6469 6e67 2053 7461 6e64 6172 6473 Coding Standards │ │ │ │ │ +00000b90: 0a28 6874 7470 3a2f 2f77 7777 2e67 6e75 .(http://www.gnu │ │ │ │ │ +00000ba0: 2e6f 7267 2f70 7265 702f 7374 616e 6461 .org/prep/standa │ │ │ │ │ +00000bb0: 7264 735f 746f 632e 6874 6d6c 292e 2020 rds_toc.html). │ │ │ │ │ +00000bc0: 5765 2064 6566 696e 6520 6164 6469 7469 We define additi │ │ │ │ │ +00000bd0: 6f6e 616c 0a63 6f6e 7665 6e74 696f 6e73 onal.conventions │ │ │ │ │ +00000be0: 2066 6f72 2047 5255 4220 6865 7265 2e0a for GRUB here.. │ │ │ │ │ +00000bf0: 0a2a 204d 656e 753a 0a0a 2a20 4e61 6d69 .* Menu:..* Nami │ │ │ │ │ +00000c00: 6e67 2043 6f6e 7665 6e74 696f 6e73 3a3a ng Conventions:: │ │ │ │ │ +00000c10: 0a2a 2046 756e 6374 696f 6e73 3a3a 0a2a .* Functions::.* │ │ │ │ │ +00000c20: 2056 6172 6961 626c 6573 3a3a 0a2a 2054 Variables::.* T │ │ │ │ │ +00000c30: 7970 6573 3a3a 0a2a 204d 6163 726f 733a ypes::.* Macros: │ │ │ │ │ +00000c40: 3a0a 2a20 436f 6d6d 656e 7473 3a3a 0a2a :.* Comments::.* │ │ │ │ │ +00000c50: 204d 756c 7469 2d4c 696e 6520 436f 6d6d Multi-Line Comm │ │ │ │ │ +00000c60: 656e 7473 3a3a 0a0a 1f0a 4669 6c65 3a20 ents::....File: │ │ │ │ │ +00000c70: 6772 7562 2d64 6576 2e69 6e66 6f2c 2020 grub-dev.info, │ │ │ │ │ +00000c80: 4e6f 6465 3a20 4e61 6d69 6e67 2043 6f6e Node: Naming Con │ │ │ │ │ +00000c90: 7665 6e74 696f 6e73 2c20 204e 6578 743a ventions, Next: │ │ │ │ │ +00000ca0: 2046 756e 6374 696f 6e73 2c20 2055 703a Functions, Up: │ │ │ │ │ +00000cb0: 2043 6f64 696e 6720 7374 796c 650a 0a32 Coding style..2 │ │ │ │ │ +00000cc0: 2e31 204e 616d 696e 6720 436f 6e76 656e .1 Naming Conven │ │ │ │ │ +00000cd0: 7469 6f6e 730a 3d3d 3d3d 3d3d 3d3d 3d3d tions.========== │ │ │ │ │ +00000ce0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 416c ============..Al │ │ │ │ │ +00000cf0: 6c20 676c 6f62 616c 2073 796d 626f 6c73 l global symbols │ │ │ │ │ +00000d00: 2028 692e 652e 2020 6675 6e63 7469 6f6e (i.e. function │ │ │ │ │ +00000d10: 732c 2076 6172 6961 626c 6573 2c20 7479 s, variables, ty │ │ │ │ │ +00000d20: 7065 732c 2061 6e64 206d 6163 726f 7329 pes, and macros) │ │ │ │ │ +00000d30: 206d 7573 740a 6861 7665 2074 6865 2070 must.have the p │ │ │ │ │ +00000d40: 7265 6669 7820 6772 7562 5f20 6f72 2047 refix grub_ or G │ │ │ │ │ +00000d50: 5255 425f 2e20 2054 6865 2061 6c6c 2063 RUB_. The all c │ │ │ │ │ +00000d60: 6170 6974 616c 2066 6f72 6d20 6973 2075 apital form is u │ │ │ │ │ +00000d70: 7365 6420 6f6e 6c79 2062 790a 6d61 6372 sed only by.macr │ │ │ │ │ +00000d80: 6f73 2e0a 0a1f 0a46 696c 653a 2067 7275 os.....File: gru │ │ │ │ │ +00000d90: 622d 6465 762e 696e 666f 2c20 204e 6f64 b-dev.info, Nod │ │ │ │ │ +00000da0: 653a 2046 756e 6374 696f 6e73 2c20 204e e: Functions, N │ │ │ │ │ +00000db0: 6578 743a 2056 6172 6961 626c 6573 2c20 ext: Variables, │ │ │ │ │ +00000dc0: 2050 7265 763a 204e 616d 696e 6720 436f Prev: Naming Co │ │ │ │ │ +00000dd0: 6e76 656e 7469 6f6e 732c 2020 5570 3a20 nventions, Up: │ │ │ │ │ +00000de0: 436f 6469 6e67 2073 7479 6c65 0a0a 322e Coding style..2. │ │ │ │ │ +00000df0: 3220 4675 6e63 7469 6f6e 730a 3d3d 3d3d 2 Functions.==== │ │ │ │ │ +00000e00: 3d3d 3d3d 3d3d 3d3d 3d0a 0a49 6620 6120 =========..If a │ │ │ │ │ +00000e10: 6675 6e63 7469 6f6e 2069 7320 676c 6f62 function is glob │ │ │ │ │ +00000e20: 616c 2c20 6974 7320 6e61 6d65 206d 7573 al, its name mus │ │ │ │ │ +00000e30: 7420 6265 2070 7265 6669 7865 6420 7769 t be prefixed wi │ │ │ │ │ +00000e40: 7468 2067 7275 625f 2061 6e64 206d 7573 th grub_ and mus │ │ │ │ │ +00000e50: 740a 636f 6e73 6973 7420 6f66 206f 6e6c t.consist of onl │ │ │ │ │ +00000e60: 7920 736d 616c 6c20 6c65 7474 6572 732e y small letters. │ │ │ │ │ +00000e70: 2020 4966 2074 6865 2066 756e 6374 696f If the functio │ │ │ │ │ +00000e80: 6e20 6265 6c6f 6e67 7320 746f 2061 2073 n belongs to a s │ │ │ │ │ +00000e90: 7065 6369 6669 630a 6675 6e63 7469 6f6e pecific.function │ │ │ │ │ +00000ea0: 206d 6f64 756c 652c 2074 6865 206e 616d module, the nam │ │ │ │ │ +00000eb0: 6520 6d75 7374 2061 6c73 6f20 6265 2070 e must also be p │ │ │ │ │ +00000ec0: 7265 6669 7865 6420 7769 7468 2074 6865 refixed with the │ │ │ │ │ +00000ed0: 206d 6f64 756c 6520 6e61 6d65 2e0a 466f module name..Fo │ │ │ │ │ +00000ee0: 7220 6578 616d 706c 652c 2069 6620 6120 r example, if a │ │ │ │ │ +00000ef0: 6675 6e63 7469 6f6e 2069 7320 666f 7220 function is for │ │ │ │ │ +00000f00: 6669 6c65 2073 7973 7465 6d73 2c20 6974 file systems, it │ │ │ │ │ +00000f10: 7320 6e61 6d65 2069 7320 7072 6566 6978 s name is prefix │ │ │ │ │ +00000f20: 6564 0a77 6974 6820 6772 7562 5f66 735f ed.with grub_fs_ │ │ │ │ │ +00000f30: 2e20 2049 6620 6120 6675 6e63 7469 6f6e . If a function │ │ │ │ │ +00000f40: 2069 7320 666f 7220 4641 5420 6669 6c65 is for FAT file │ │ │ │ │ +00000f50: 2073 7973 7465 6d20 6275 7420 6e6f 7420 system but not │ │ │ │ │ +00000f60: 666f 7220 616c 6c0a 6669 6c65 2073 7973 for all.file sys │ │ │ │ │ +00000f70: 7465 6d73 2c20 6974 7320 6e61 6d65 2069 tems, its name i │ │ │ │ │ +00000f80: 7320 7072 6566 6978 6564 2077 6974 6820 s prefixed with │ │ │ │ │ +00000f90: 6772 7562 5f66 735f 6661 745f 2e20 2054 grub_fs_fat_. T │ │ │ │ │ +00000fa0: 6865 2068 6965 7261 7263 6879 2069 730a he hierarchy is. │ │ │ │ │ +00000fb0: 6e6f 7465 6420 7468 6973 2077 6179 2e0a noted this way.. │ │ │ │ │ +00000fc0: 0a20 2020 4166 7465 7220 6120 7072 6566 . After a pref │ │ │ │ │ +00000fd0: 6978 2c20 6120 6675 6e63 7469 6f6e 206e ix, a function n │ │ │ │ │ +00000fe0: 616d 6520 6d75 7374 2073 7461 7274 2077 ame must start w │ │ │ │ │ +00000ff0: 6974 6820 6120 7665 7262 2028 7375 6368 ith a verb (such │ │ │ │ │ +00001000: 2061 7320 6765 740a 6f72 2069 7329 2e20 as get.or is). │ │ │ │ │ +00001010: 2049 7420 6d75 7374 206e 6f74 2062 6520 It must not be │ │ │ │ │ +00001020: 6120 6e6f 756e 2e20 2053 6f6d 6520 6b69 a noun. Some ki │ │ │ │ │ +00001030: 6e64 206f 6620 6162 6272 6576 6961 7469 nd of abbreviati │ │ │ │ │ +00001040: 6f6e 2069 7320 7065 726d 6974 7465 642c on is permitted, │ │ │ │ │ +00001050: 0a61 7320 6c6f 6e67 2061 7320 6974 2077 .as long as it w │ │ │ │ │ +00001060: 6f75 6c64 6e27 7420 6d61 6b65 2063 6f64 ouldn't make cod │ │ │ │ │ +00001070: 6520 6c65 7373 2072 6561 6461 626c 6520 e less readable │ │ │ │ │ +00001080: 2865 2e67 2e20 2069 6e69 7429 2e0a 0a20 (e.g. init)... │ │ │ │ │ +00001090: 2020 4966 2061 2066 756e 6374 696f 6e20 If a function │ │ │ │ │ +000010a0: 6973 206c 6f63 616c 2c20 6974 7320 6e61 is local, its na │ │ │ │ │ +000010b0: 6d65 206d 6179 206e 6f74 2073 7461 7274 me may not start │ │ │ │ │ +000010c0: 2077 6974 6820 616e 7920 7072 6566 6978 with any prefix │ │ │ │ │ +000010d0: 2e20 2049 740a 6d75 7374 2073 7461 7274 . It.must start │ │ │ │ │ +000010e0: 2077 6974 6820 6120 7665 7262 2e0a 0a1f with a verb.... │ │ │ │ │ +000010f0: 0a46 696c 653a 2067 7275 622d 6465 762e .File: grub-dev. │ │ │ │ │ +00001100: 696e 666f 2c20 204e 6f64 653a 2056 6172 info, Node: Var │ │ │ │ │ +00001110: 6961 626c 6573 2c20 204e 6578 743a 2054 iables, Next: T │ │ │ │ │ +00001120: 7970 6573 2c20 2050 7265 763a 2046 756e ypes, Prev: Fun │ │ │ │ │ +00001130: 6374 696f 6e73 2c20 2055 703a 2043 6f64 ctions, Up: Cod │ │ │ │ │ +00001140: 696e 6720 7374 796c 650a 0a32 2e33 2056 ing style..2.3 V │ │ │ │ │ +00001150: 6172 6961 626c 6573 0a3d 3d3d 3d3d 3d3d ariables.======= │ │ │ │ │ +00001160: 3d3d 3d3d 3d3d 0a0a 5468 6520 7275 6c65 ======..The rule │ │ │ │ │ +00001170: 2069 7320 6d6f 7374 6c79 2074 6865 2073 is mostly the s │ │ │ │ │ +00001180: 616d 6520 6173 2066 756e 6374 696f 6e73 ame as functions │ │ │ │ │ +00001190: 2c20 6173 206e 6f74 6564 2061 626f 7665 , as noted above │ │ │ │ │ +000011a0: 2e20 2049 6620 6120 7661 7269 6162 6c65 . If a variable │ │ │ │ │ +000011b0: 0a69 7320 676c 6f62 616c 2c20 6974 7320 .is global, its │ │ │ │ │ +000011c0: 6e61 6d65 206d 7573 7420 6265 2070 7265 name must be pre │ │ │ │ │ +000011d0: 6669 7865 6420 7769 7468 2067 7275 625f fixed with grub_ │ │ │ │ │ +000011e0: 2061 6e64 206d 7573 7420 636f 6e73 6973 and must consis │ │ │ │ │ +000011f0: 7420 6f66 206f 6e6c 790a 736d 616c 6c20 t of only.small │ │ │ │ │ +00001200: 6c65 7474 6572 732e 2020 4966 2074 6865 letters. If the │ │ │ │ │ +00001210: 2076 6172 6961 626c 6520 6265 6c6f 6e67 variable belong │ │ │ │ │ +00001220: 7320 746f 2061 2073 7065 6369 6669 6320 s to a specific │ │ │ │ │ +00001230: 6675 6e63 7469 6f6e 206d 6f64 756c 652c function module, │ │ │ │ │ +00001240: 0a74 6865 206e 616d 6520 6d75 7374 2061 .the name must a │ │ │ │ │ +00001250: 6c73 6f20 6265 2070 7265 6669 7865 6420 lso be prefixed │ │ │ │ │ +00001260: 7769 7468 2074 6865 206d 6f64 756c 6520 with the module │ │ │ │ │ +00001270: 6e61 6d65 2e20 2046 6f72 2065 7861 6d70 name. For examp │ │ │ │ │ +00001280: 6c65 2c20 6966 2061 0a66 756e 6374 696f le, if a.functio │ │ │ │ │ +00001290: 6e20 6973 2066 6f72 2064 796e 616d 6963 n is for dynamic │ │ │ │ │ +000012a0: 206c 6f61 6469 6e67 2c20 6974 7320 6e61 loading, its na │ │ │ │ │ +000012b0: 6d65 2069 7320 7072 6566 6978 6564 2077 me is prefixed w │ │ │ │ │ +000012c0: 6974 6820 6772 7562 5f64 6c5f 2e20 2049 ith grub_dl_. I │ │ │ │ │ +000012d0: 660a 6120 7661 7269 6162 6c65 2069 7320 f.a variable is │ │ │ │ │ +000012e0: 666f 7220 454c 4620 6275 7420 6e6f 7420 for ELF but not │ │ │ │ │ +000012f0: 666f 7220 616c 6c20 6479 6e61 6d69 6320 for all dynamic │ │ │ │ │ +00001300: 6c6f 6164 696e 6720 7379 7374 656d 732c loading systems, │ │ │ │ │ +00001310: 2069 7473 206e 616d 650a 6973 2070 7265 its name.is pre │ │ │ │ │ +00001320: 6669 7865 6420 7769 7468 2067 7275 625f fixed with grub_ │ │ │ │ │ +00001330: 646c 5f65 6c66 5f2e 0a0a 2020 2041 6674 dl_elf_... Aft │ │ │ │ │ +00001340: 6572 2061 2070 7265 6669 782c 2061 2076 er a prefix, a v │ │ │ │ │ +00001350: 6172 6961 626c 6520 6e61 6d65 206d 7573 ariable name mus │ │ │ │ │ +00001360: 7420 7374 6172 7420 7769 7468 2061 206e t start with a n │ │ │ │ │ +00001370: 6f75 6e20 6f72 2061 6e0a 6164 6a65 6374 oun or an.adject │ │ │ │ │ +00001380: 6976 6520 2873 7563 6820 6173 206e 616d ive (such as nam │ │ │ │ │ +00001390: 6520 6f72 206c 6f6e 6729 2061 6e64 2069 e or long) and i │ │ │ │ │ +000013a0: 7420 7368 6f75 6c64 2065 6e64 2077 6974 t should end wit │ │ │ │ │ +000013b0: 6820 6120 6e6f 756e 2e20 2053 6f6d 650a h a noun. Some. │ │ │ │ │ +000013c0: 6b69 6e64 206f 6620 6162 6272 6576 6961 kind of abbrevia │ │ │ │ │ +000013d0: 7469 6f6e 2069 7320 7065 726d 6974 7465 tion is permitte │ │ │ │ │ +000013e0: 642c 2061 7320 6c6f 6e67 2061 7320 6974 d, as long as it │ │ │ │ │ +000013f0: 2077 6f75 6c64 6e27 7420 6d61 6b65 2063 wouldn't make c │ │ │ │ │ +00001400: 6f64 6520 6c65 7373 0a72 6561 6461 626c ode less.readabl │ │ │ │ │ +00001410: 6520 2865 2e67 2e20 2069 3138 6e29 2e0a e (e.g. i18n).. │ │ │ │ │ +00001420: 0a20 2020 4966 2061 2076 6172 6961 626c . If a variabl │ │ │ │ │ +00001430: 6520 6973 2067 6c6f 6261 6c20 696e 2074 e is global in t │ │ │ │ │ +00001440: 6865 2073 636f 7065 206f 6620 6120 7369 he scope of a si │ │ │ │ │ +00001450: 6e67 6c65 2066 696c 6520 2869 2e65 2e20 ngle file (i.e. │ │ │ │ │ +00001460: 2069 7420 6973 0a64 6563 6c61 7265 6420 it is.declared │ │ │ │ │ +00001470: 7769 7468 2073 7461 7469 6329 2c20 6974 with static), it │ │ │ │ │ +00001480: 7320 6e61 6d65 206d 6179 206e 6f74 2073 s name may not s │ │ │ │ │ +00001490: 7461 7274 2077 6974 6820 616e 7920 7072 tart with any pr │ │ │ │ │ +000014a0: 6566 6978 2e20 2049 7420 6d75 7374 0a73 efix. It must.s │ │ │ │ │ +000014b0: 7461 7274 2077 6974 6820 6120 6e6f 756e tart with a noun │ │ │ │ │ +000014c0: 206f 7220 616e 2061 646a 6563 7469 7665 or an adjective │ │ │ │ │ +000014d0: 2e0a 0a20 2020 4966 2061 2076 6172 6961 ... If a varia │ │ │ │ │ +000014e0: 626c 6520 6973 206c 6f63 616c 2c20 796f ble is local, yo │ │ │ │ │ +000014f0: 7520 6d61 7920 6368 6f6f 7365 2061 6e79 u may choose any │ │ │ │ │ +00001500: 2073 686f 7274 6572 206e 616d 652c 2061 shorter name, a │ │ │ │ │ +00001510: 7320 6c6f 6e67 2061 730a 6974 2077 6f75 s long as.it wou │ │ │ │ │ +00001520: 6c64 6e27 7420 6d61 6b65 2063 6f64 6520 ldn't make code │ │ │ │ │ +00001530: 6c65 7373 2072 6561 6461 626c 6520 2865 less readable (e │ │ │ │ │ +00001540: 2e67 2e20 2069 292e 0a0a 1f0a 4669 6c65 .g. i).....File │ │ │ │ │ +00001550: 3a20 6772 7562 2d64 6576 2e69 6e66 6f2c : grub-dev.info, │ │ │ │ │ +00001560: 2020 4e6f 6465 3a20 5479 7065 732c 2020 Node: Types, │ │ │ │ │ +00001570: 4e65 7874 3a20 4d61 6372 6f73 2c20 2050 Next: Macros, P │ │ │ │ │ +00001580: 7265 763a 2056 6172 6961 626c 6573 2c20 rev: Variables, │ │ │ │ │ +00001590: 2055 703a 2043 6f64 696e 6720 7374 796c Up: Coding styl │ │ │ │ │ +000015a0: 650a 0a32 2e34 2054 7970 6573 0a3d 3d3d e..2.4 Types.=== │ │ │ │ │ +000015b0: 3d3d 3d3d 3d3d 0a0a 5468 6520 6e61 6d65 ======..The name │ │ │ │ │ +000015c0: 206f 6620 6120 7479 7065 206d 7573 7420 of a type must │ │ │ │ │ +000015d0: 6265 2070 7265 6669 7865 6420 7769 7468 be prefixed with │ │ │ │ │ +000015e0: 2067 7275 625f 2061 6e64 206d 7573 7420 grub_ and must │ │ │ │ │ +000015f0: 636f 6e73 6973 7420 6f66 206f 6e6c 790a consist of only. │ │ │ │ │ +00001600: 736d 616c 6c20 6c65 7474 6572 732e 2020 small letters. │ │ │ │ │ +00001610: 4966 2074 6865 2074 7970 6520 6265 6c6f If the type belo │ │ │ │ │ +00001620: 6e67 7320 746f 2061 2073 7065 6369 6669 ngs to a specifi │ │ │ │ │ +00001630: 6320 6675 6e63 7469 6f6e 206d 6f64 756c c function modul │ │ │ │ │ +00001640: 652c 2074 6865 0a6e 616d 6520 6d75 7374 e, the.name must │ │ │ │ │ +00001650: 2061 6c73 6f20 6265 2070 7265 6669 7865 also be prefixe │ │ │ │ │ +00001660: 6420 7769 7468 2074 6865 206d 6f64 756c d with the modul │ │ │ │ │ +00001670: 6520 6e61 6d65 2e20 2046 6f72 2065 7861 e name. For exa │ │ │ │ │ +00001680: 6d70 6c65 2c20 6966 2061 2074 7970 650a mple, if a type. │ │ │ │ │ +00001690: 6973 2066 6f72 204f 5320 6c6f 6164 6572 is for OS loader │ │ │ │ │ +000016a0: 732c 2069 7473 206e 616d 6520 6973 2070 s, its name is p │ │ │ │ │ +000016b0: 7265 6669 7865 6420 7769 7468 2067 7275 refixed with gru │ │ │ │ │ +000016c0: 625f 6c6f 6164 6572 5f2e 2020 4966 2061 b_loader_. If a │ │ │ │ │ +000016d0: 2074 7970 6520 6973 0a66 6f72 204d 756c type is.for Mul │ │ │ │ │ +000016e0: 7469 626f 6f74 2062 7574 206e 6f74 2066 tiboot but not f │ │ │ │ │ +000016f0: 6f72 2061 6c6c 204f 5320 6c6f 6164 6572 or all OS loader │ │ │ │ │ +00001700: 732c 2069 7473 206e 616d 6520 6973 2070 s, its name is p │ │ │ │ │ +00001710: 7265 6669 7865 6420 7769 7468 0a67 7275 refixed with.gru │ │ │ │ │ +00001720: 625f 6c6f 6164 6572 5f6c 696e 7578 5f2e b_loader_linux_. │ │ │ │ │ +00001730: 0a0a 2020 2054 6865 206e 616d 6520 6d75 .. The name mu │ │ │ │ │ +00001740: 7374 2062 6520 7375 6666 6978 6564 2077 st be suffixed w │ │ │ │ │ +00001750: 6974 6820 5f74 2c20 746f 2065 6d70 6861 ith _t, to empha │ │ │ │ │ +00001760: 7369 7a65 2074 6865 2066 6163 7420 7468 size the fact th │ │ │ │ │ +00001770: 6174 2069 7420 6973 2061 0a74 7970 6520 at it is a.type │ │ │ │ │ +00001780: 6275 7420 6e6f 7420 6120 7661 7269 6162 but not a variab │ │ │ │ │ +00001790: 6c65 206f 7220 6120 6675 6e63 7469 6f6e le or a function │ │ │ │ │ +000017a0: 2e0a 0a1f 0a46 696c 653a 2067 7275 622d .....File: grub- │ │ │ │ │ +000017b0: 6465 762e 696e 666f 2c20 204e 6f64 653a dev.info, Node: │ │ │ │ │ +000017c0: 204d 6163 726f 732c 2020 4e65 7874 3a20 Macros, Next: │ │ │ │ │ +000017d0: 436f 6d6d 656e 7473 2c20 2050 7265 763a Comments, Prev: │ │ │ │ │ +000017e0: 2054 7970 6573 2c20 2055 703a 2043 6f64 Types, Up: Cod │ │ │ │ │ +000017f0: 696e 6720 7374 796c 650a 0a32 2e35 204d ing style..2.5 M │ │ │ │ │ +00001800: 6163 726f 730a 3d3d 3d3d 3d3d 3d3d 3d3d acros.========== │ │ │ │ │ +00001810: 0a0a 4966 2061 206d 6163 726f 2069 7320 ..If a macro is │ │ │ │ │ +00001820: 676c 6f62 616c 2c20 6974 7320 6e61 6d65 global, its name │ │ │ │ │ +00001830: 206d 7573 7420 6265 2070 7265 6669 7865 must be prefixe │ │ │ │ │ +00001840: 6420 7769 7468 2047 5255 425f 2061 6e64 d with GRUB_ and │ │ │ │ │ +00001850: 206d 7573 740a 636f 6e73 6973 7420 6f66 must.consist of │ │ │ │ │ +00001860: 206f 6e6c 7920 6c61 7267 6520 6c65 7474 only large lett │ │ │ │ │ +00001870: 6572 732e 2020 4f74 6865 7220 7275 6c65 ers. Other rule │ │ │ │ │ +00001880: 7320 6172 6520 7468 6520 7361 6d65 2061 s are the same a │ │ │ │ │ +00001890: 7320 6675 6e63 7469 6f6e 7320 6f72 0a76 s functions or.v │ │ │ │ │ +000018a0: 6172 6961 626c 6573 2c20 6465 7065 6e64 ariables, depend │ │ │ │ │ +000018b0: 696e 6720 6f6e 2077 6865 7468 6572 2061 ing on whether a │ │ │ │ │ +000018c0: 206d 6163 726f 2069 7320 7573 6564 206c macro is used l │ │ │ │ │ +000018d0: 696b 6520 6120 6675 6e63 7469 6f6e 206f ike a function o │ │ │ │ │ +000018e0: 7220 610a 7661 7269 6162 6c65 2e0a 0a1f r a.variable.... │ │ │ │ │ +000018f0: 0a46 696c 653a 2067 7275 622d 6465 762e .File: grub-dev. │ │ │ │ │ +00001900: 696e 666f 2c20 204e 6f64 653a 2043 6f6d info, Node: Com │ │ │ │ │ +00001910: 6d65 6e74 732c 2020 4e65 7874 3a20 4d75 ments, Next: Mu │ │ │ │ │ +00001920: 6c74 692d 4c69 6e65 2043 6f6d 6d65 6e74 lti-Line Comment │ │ │ │ │ +00001930: 732c 2020 5072 6576 3a20 4d61 6372 6f73 s, Prev: Macros │ │ │ │ │ +00001940: 2c20 2055 703a 2043 6f64 696e 6720 7374 , Up: Coding st │ │ │ │ │ +00001950: 796c 650a 0a32 2e36 2043 6f6d 6d65 6e74 yle..2.6 Comment │ │ │ │ │ +00001960: 730a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a s.============.. │ │ │ │ │ +00001970: 416c 6c20 636f 6d6d 656e 7473 2073 6861 All comments sha │ │ │ │ │ +00001980: 6c6c 2062 6520 432d 7374 796c 6520 636f ll be C-style co │ │ │ │ │ +00001990: 6d6d 656e 7473 2c20 6f66 2074 6865 2066 mments, of the f │ │ │ │ │ +000019a0: 6f72 6d20 272f 2a20 2e2e 2e20 2a2f 272e orm '/* ... */'. │ │ │ │ │ +000019b0: 2020 410a 636f 6d6d 656e 7420 6361 6e20 A.comment can │ │ │ │ │ +000019c0: 6265 2070 6c61 6365 6420 696d 6d65 6469 be placed immedi │ │ │ │ │ +000019d0: 6174 656c 7920 7072 6563 6564 696e 6720 ately preceding │ │ │ │ │ +000019e0: 7468 6520 656e 7469 7479 2069 7420 6465 the entity it de │ │ │ │ │ +000019f0: 7363 7269 6265 7320 6f72 0a69 7420 6361 scribes or.it ca │ │ │ │ │ +00001a00: 6e20 6265 2070 6c61 6365 6420 746f 6765 n be placed toge │ │ │ │ │ +00001a10: 7468 6572 2077 6974 6820 636f 6465 2c20 ther with code, │ │ │ │ │ +00001a20: 7661 7269 6162 6c65 2064 6563 6c61 7261 variable declara │ │ │ │ │ +00001a30: 7469 6f6e 732c 206f 7220 6f74 6865 720a tions, or other. │ │ │ │ │ +00001a40: 6e6f 6e2d 636f 6d6d 656e 7420 656e 7469 non-comment enti │ │ │ │ │ +00001a50: 7469 6573 2e20 2048 6f77 6576 6572 2c20 ties. However, │ │ │ │ │ +00001a60: 6974 2069 7320 7265 636f 6d6d 656e 6465 it is recommende │ │ │ │ │ +00001a70: 6420 746f 206e 6f74 206d 6978 2076 6172 d to not mix var │ │ │ │ │ +00001a80: 696f 7573 0a66 6f72 6d73 2065 7370 6563 ious.forms espec │ │ │ │ │ +00001a90: 6961 6c6c 7920 696e 2074 7970 6573 2f73 ially in types/s │ │ │ │ │ +00001aa0: 7472 7563 7473 2064 6573 6372 6970 7469 tructs descripti │ │ │ │ │ +00001ab0: 6f6e 732e 0a0a 2020 2041 6363 6570 7461 ons... Accepta │ │ │ │ │ +00001ac0: 626c 653a 0a20 2020 2020 2f2a 2054 6865 ble:. /* The │ │ │ │ │ +00001ad0: 2070 6167 6520 2320 7468 6174 2069 7320 page # that is │ │ │ │ │ +00001ae0: 7468 6520 6672 6f6e 7420 6275 6666 6572 the front buffer │ │ │ │ │ +00001af0: 2e20 2a2f 0a20 2020 2020 696e 7420 6469 . */. int di │ │ │ │ │ +00001b00: 7370 6c61 7965 645f 7061 6765 3b0a 0a20 splayed_page;.. │ │ │ │ │ +00001b10: 2020 2020 696e 7420 7265 6e64 6572 5f70 int render_p │ │ │ │ │ +00001b20: 6167 653b 202f 2a20 5468 6520 7061 6765 age; /* The page │ │ │ │ │ +00001b30: 2023 2074 6861 7420 6973 2074 6865 2062 # that is the b │ │ │ │ │ +00001b40: 6163 6b20 6275 6666 6572 2e20 2a2f 0a0a ack buffer. */.. │ │ │ │ │ +00001b50: 1f0a 4669 6c65 3a20 6772 7562 2d64 6576 ..File: grub-dev │ │ │ │ │ +00001b60: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 4d75 .info, Node: Mu │ │ │ │ │ +00001b70: 6c74 692d 4c69 6e65 2043 6f6d 6d65 6e74 lti-Line Comment │ │ │ │ │ +00001b80: 732c 2020 5072 6576 3a20 436f 6d6d 656e s, Prev: Commen │ │ │ │ │ +00001b90: 7473 2c20 2055 703a 2043 6f64 696e 6720 ts, Up: Coding │ │ │ │ │ +00001ba0: 7374 796c 650a 0a32 2e37 204d 756c 7469 style..2.7 Multi │ │ │ │ │ +00001bb0: 2d4c 696e 6520 436f 6d6d 656e 7473 0a3d -Line Comments.= │ │ │ │ │ +00001bc0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ +00001bd0: 3d3d 3d3d 3d3d 0a0a 436f 6d6d 656e 7473 ======..Comments │ │ │ │ │ +00001be0: 2073 7061 6e6e 696e 6720 6d75 6c74 6970 spanning multip │ │ │ │ │ +00001bf0: 6c65 206c 696e 6573 2073 6861 6c6c 2062 le lines shall b │ │ │ │ │ +00001c00: 6520 666f 726d 6174 7465 6420 7769 7468 e formatted with │ │ │ │ │ +00001c10: 2061 6c6c 206c 696e 6573 2061 6674 6572 all lines after │ │ │ │ │ +00001c20: 0a74 6865 2066 6972 7374 2061 6c69 676e .the first align │ │ │ │ │ +00001c30: 6564 2077 6974 6820 7468 6520 6669 7273 ed with the firs │ │ │ │ │ +00001c40: 7420 6c69 6e65 2e20 2041 7374 6572 6973 t line. Asteris │ │ │ │ │ +00001c50: 6b20 6368 6172 6163 7465 7273 2073 686f k characters sho │ │ │ │ │ +00001c60: 756c 6420 6265 0a72 6570 6561 7465 6420 uld be.repeated │ │ │ │ │ +00001c70: 6174 2074 6865 2073 7461 7274 206f 6620 at the start of │ │ │ │ │ +00001c80: 6561 6368 2073 7562 7365 7175 656e 7420 each subsequent │ │ │ │ │ +00001c90: 6c69 6e65 2e0a 0a20 2020 4163 6365 7074 line... Accept │ │ │ │ │ +00001ca0: 6162 6c65 3a0a 2020 2020 202f 2a0a 2020 able:. /*. │ │ │ │ │ +00001cb0: 2020 2020 2a20 5468 6973 2069 7320 6120 * This is a │ │ │ │ │ +00001cc0: 636f 6d6d 656e 740a 2020 2020 2020 2a20 comment. * │ │ │ │ │ +00001cd0: 7768 6963 6820 7370 616e 7320 6d75 6c74 which spans mult │ │ │ │ │ +00001ce0: 6970 6c65 206c 696e 6573 2e0a 2020 2020 iple lines.. │ │ │ │ │ +00001cf0: 2020 2a20 4974 2069 7320 6c6f 6e67 2e0a * It is long.. │ │ │ │ │ +00001d00: 2020 2020 2020 2a2f 0a0a 2020 2055 6e61 */.. Una │ │ │ │ │ +00001d10: 6363 6570 7461 626c 653a 0a20 2020 2020 cceptable:. │ │ │ │ │ +00001d20: 2f2a 2054 6869 7320 6973 2061 2063 6f6d /* This is a com │ │ │ │ │ +00001d30: 6d65 6e74 0a20 2020 2020 2020 2077 6869 ment. whi │ │ │ │ │ +00001d40: 6368 2073 7061 6e73 206d 756c 7469 706c ch spans multipl │ │ │ │ │ +00001d50: 6520 6c69 6e65 732e 0a20 2020 2020 2020 e lines.. │ │ │ │ │ +00001d60: 2049 7420 6973 206c 6f6e 672e 202a 2f0a It is long. */. │ │ │ │ │ +00001d70: 0a20 2020 2020 2f2a 0a20 2020 2020 202a . /*. * │ │ │ │ │ +00001d80: 2054 6869 7320 6973 2061 2063 6f6d 6d65 This is a comme │ │ │ │ │ +00001d90: 6e74 0a20 2020 2020 202a 2077 6869 6368 nt. * which │ │ │ │ │ +00001da0: 2073 7061 6e73 206d 756c 7469 706c 6520 spans multiple │ │ │ │ │ +00001db0: 6c69 6e65 732e 0a20 2020 2020 202a 2049 lines.. * I │ │ │ │ │ +00001dc0: 7420 6973 206c 6f6e 672e 202a 2f0a 0a20 t is long. */.. │ │ │ │ │ +00001dd0: 2020 2020 2f2a 2054 6869 7320 6973 2061 /* This is a │ │ │ │ │ +00001de0: 2063 6f6d 6d65 6e74 0a20 2020 2020 202a comment. * │ │ │ │ │ +00001df0: 2077 6869 6368 2073 7061 6e73 206d 756c which spans mul │ │ │ │ │ +00001e00: 7469 706c 6520 6c69 6e65 732e 0a20 2020 tiple lines.. │ │ │ │ │ +00001e10: 2020 202a 2049 7420 6973 206c 6f6e 672e * It is long. │ │ │ │ │ +00001e20: 0a20 2020 2020 202a 2f0a 0a20 2020 496e . */.. In │ │ │ │ │ +00001e30: 2070 6172 7469 6375 6c61 7220 6669 7273 particular firs │ │ │ │ │ +00001e40: 7420 756e 6163 6365 7074 6162 6c65 2066 t unacceptable f │ │ │ │ │ +00001e50: 6f72 6d20 6d61 6b65 7320 636f 6d6d 656e orm makes commen │ │ │ │ │ +00001e60: 7420 6469 6666 6963 756c 7420 746f 0a64 t difficult to.d │ │ │ │ │ +00001e70: 6973 7469 6e67 7569 7368 2066 726f 6d20 istinguish from │ │ │ │ │ +00001e80: 7468 6520 636f 6465 2069 7473 656c 662e the code itself. │ │ │ │ │ +00001e90: 2020 4573 7065 6369 616c 6c79 2069 6620 Especially if │ │ │ │ │ +00001ea0: 6974 2063 6f6e 7461 696e 7320 7468 6520 it contains the │ │ │ │ │ +00001eb0: 636f 6465 0a73 6e69 7070 6574 7320 616e code.snippets an │ │ │ │ │ +00001ec0: 642f 6f72 2069 7320 6c6f 6e67 2e20 2053 d/or is long. S │ │ │ │ │ +00001ed0: 6f2c 2069 7473 2075 7361 6765 2069 7320 o, its usage is │ │ │ │ │ +00001ee0: 6469 7361 6c6c 6f77 6564 2e0a 0a1f 0a46 disallowed.....F │ │ │ │ │ +00001ef0: 696c 653a 2067 7275 622d 6465 762e 696e ile: grub-dev.in │ │ │ │ │ +00001f00: 666f 2c20 204e 6f64 653a 2046 696e 6469 fo, Node: Findi │ │ │ │ │ +00001f10: 6e67 2079 6f75 7220 7761 7920 6172 6f75 ng your way arou │ │ │ │ │ +00001f20: 6e64 2c20 204e 6578 743a 2043 6f6e 7472 nd, Next: Contr │ │ │ │ │ +00001f30: 6962 7574 696e 6720 4368 616e 6765 732c ibuting Changes, │ │ │ │ │ +00001f40: 2020 5072 6576 3a20 436f 6469 6e67 2073 Prev: Coding s │ │ │ │ │ +00001f50: 7479 6c65 2c20 2055 703a 2054 6f70 0a0a tyle, Up: Top.. │ │ │ │ │ +00001f60: 3320 4669 6e64 696e 6720 796f 7572 2077 3 Finding your w │ │ │ │ │ +00001f70: 6179 2061 726f 756e 640a 2a2a 2a2a 2a2a ay around.****** │ │ │ │ │ 00001f80: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -00001f90: 2a2a 2a2a 2a0a 0a48 6572 6520 6973 2061 *****..Here is a │ │ │ │ │ -00001fa0: 2062 7269 6566 206d 6170 206f 6620 7468 brief map of th │ │ │ │ │ -00001fb0: 6520 4752 5542 2063 6f64 6520 6261 7365 e GRUB code base │ │ │ │ │ -00001fc0: 2e0a 0a20 2020 4752 5542 2075 7365 7320 ... GRUB uses │ │ │ │ │ -00001fd0: 4175 746f 636f 6e66 2061 6e64 2041 7574 Autoconf and Aut │ │ │ │ │ -00001fe0: 6f6d 616b 652c 2077 6974 6820 6d6f 7374 omake, with most │ │ │ │ │ -00001ff0: 206f 6620 7468 6520 4175 746f 6d61 6b65 of the Automake │ │ │ │ │ -00002000: 2069 6e70 7574 0a67 656e 6572 6174 6564 input.generated │ │ │ │ │ -00002010: 2062 7920 6120 5079 7468 6f6e 2073 6372 by a Python scr │ │ │ │ │ -00002020: 6970 742e 2020 5468 6520 746f 702d 6c65 ipt. The top-le │ │ │ │ │ -00002030: 7665 6c20 6275 696c 6420 7275 6c65 7320 vel build rules │ │ │ │ │ -00002040: 6172 6520 696e 0a27 636f 6e66 6967 7572 are in.'configur │ │ │ │ │ -00002050: 652e 6163 272c 2027 6772 7562 2d63 6f72 e.ac', 'grub-cor │ │ │ │ │ -00002060: 652f 4d61 6b65 6669 6c65 2e63 6f72 652e e/Makefile.core. │ │ │ │ │ -00002070: 6465 6627 2c20 616e 6420 274d 616b 6566 def', and 'Makef │ │ │ │ │ -00002080: 696c 652e 7574 696c 2e64 6566 272e 0a45 ile.util.def'..E │ │ │ │ │ -00002090: 6163 6820 626c 6f63 6b20 696e 2061 2027 ach block in a ' │ │ │ │ │ -000020a0: 2a2e 6465 6627 2066 696c 6520 7265 7072 *.def' file repr │ │ │ │ │ -000020b0: 6573 656e 7473 2061 2062 7569 6c64 2074 esents a build t │ │ │ │ │ -000020c0: 6172 6765 742c 2061 6e64 2073 7065 6369 arget, and speci │ │ │ │ │ -000020d0: 6669 6573 0a74 6865 2073 6f75 7263 6520 fies.the source │ │ │ │ │ -000020e0: 6669 6c65 7320 7573 6564 2074 6f20 6275 files used to bu │ │ │ │ │ -000020f0: 696c 6420 6974 206f 6e20 7661 7269 6f75 ild it on variou │ │ │ │ │ -00002100: 7320 706c 6174 666f 726d 732e 2020 5468 s platforms. Th │ │ │ │ │ -00002110: 6520 272a 2e64 6566 270a 6669 6c65 7320 e '*.def'.files │ │ │ │ │ -00002120: 6172 6520 7072 6f63 6573 7365 6420 696e are processed in │ │ │ │ │ -00002130: 746f 2041 7574 6f6d 616b 6520 696e 7075 to Automake inpu │ │ │ │ │ -00002140: 7420 6279 2027 6765 6e74 706c 2e70 7927 t by 'gentpl.py' │ │ │ │ │ -00002150: 2028 7768 6963 6820 796f 7520 6f6e 6c79 (which you only │ │ │ │ │ -00002160: 0a6e 6565 6420 746f 206c 6f6f 6b20 6174 .need to look at │ │ │ │ │ -00002170: 2069 6620 796f 7520 6172 6520 6578 7465 if you are exte │ │ │ │ │ -00002180: 6e64 696e 6720 7468 6520 6275 696c 6420 nding the build │ │ │ │ │ -00002190: 7379 7374 656d 292e 2020 4966 2079 6f75 system). If you │ │ │ │ │ -000021a0: 2061 7265 0a61 6464 696e 6720 6120 6e65 are.adding a ne │ │ │ │ │ -000021b0: 7720 6d6f 6475 6c65 2077 6869 6368 2066 w module which f │ │ │ │ │ -000021c0: 6f6c 6c6f 7773 2061 6e20 6578 6973 7469 ollows an existi │ │ │ │ │ -000021d0: 6e67 2070 6174 7465 726e 2c20 7375 6368 ng pattern, such │ │ │ │ │ -000021e0: 2061 7320 6120 6e65 770a 636f 6d6d 616e as a new.comman │ │ │ │ │ -000021f0: 6420 6f72 2061 206e 6577 2066 696c 6573 d or a new files │ │ │ │ │ -00002200: 7973 7465 6d20 696d 706c 656d 656e 7461 ystem implementa │ │ │ │ │ -00002210: 7469 6f6e 2c20 6974 2069 7320 7573 7561 tion, it is usua │ │ │ │ │ -00002220: 6c6c 7920 6561 7369 6573 7420 746f 0a67 lly easiest to.g │ │ │ │ │ -00002230: 7265 7020 2767 7275 622d 636f 7265 2f4d rep 'grub-core/M │ │ │ │ │ -00002240: 616b 6566 696c 652e 636f 7265 2e64 6566 akefile.core.def │ │ │ │ │ -00002250: 2720 616e 6420 274d 616b 6566 696c 652e ' and 'Makefile. │ │ │ │ │ -00002260: 7574 696c 2e64 6566 2720 666f 7220 616e util.def' for an │ │ │ │ │ -00002270: 0a65 7869 7374 696e 6720 6578 616d 706c .existing exampl │ │ │ │ │ -00002280: 6520 6f66 2074 6861 7420 7061 7474 6572 e of that patter │ │ │ │ │ -00002290: 6e20 746f 2066 696e 6420 6f75 7420 7768 n to find out wh │ │ │ │ │ -000022a0: 6572 6520 6974 2073 686f 756c 6420 6265 ere it should be │ │ │ │ │ -000022b0: 2061 6464 6564 2e0a 0a20 2020 496e 2067 added... In g │ │ │ │ │ -000022c0: 656e 6572 616c 2c20 636f 6465 2074 6861 eneral, code tha │ │ │ │ │ -000022d0: 7420 6d61 7920 6265 2072 756e 2061 7420 t may be run at │ │ │ │ │ -000022e0: 626f 6f74 2074 696d 6520 6973 2069 6e20 boot time is in │ │ │ │ │ -000022f0: 6120 7375 6264 6972 6563 746f 7279 206f a subdirectory o │ │ │ │ │ -00002300: 660a 2767 7275 622d 636f 7265 272c 2077 f.'grub-core', w │ │ │ │ │ -00002310: 6869 6c65 2063 6f64 6520 7468 6174 2069 hile code that i │ │ │ │ │ -00002320: 7320 6f6e 6c79 2072 756e 2066 726f 6d20 s only run from │ │ │ │ │ -00002330: 7769 7468 696e 2061 2066 756c 6c20 6f70 within a full op │ │ │ │ │ -00002340: 6572 6174 696e 670a 7379 7374 656d 2069 erating.system i │ │ │ │ │ -00002350: 7320 696e 2061 2073 7562 6469 7265 6374 s in a subdirect │ │ │ │ │ -00002360: 6f72 7920 6f66 2074 6865 2074 6f70 206c ory of the top l │ │ │ │ │ -00002370: 6576 656c 2e0a 0a20 2020 4c6f 772d 6c65 evel... Low-le │ │ │ │ │ -00002380: 7665 6c20 626f 6f74 2063 6f64 652c 2073 vel boot code, s │ │ │ │ │ -00002390: 7563 6820 6173 2074 6865 204d 4252 2069 uch as the MBR i │ │ │ │ │ -000023a0: 6d70 6c65 6d65 6e74 6174 696f 6e20 6f6e mplementation on │ │ │ │ │ -000023b0: 2050 4320 4249 4f53 0a73 7973 7465 6d73 PC BIOS.systems │ │ │ │ │ -000023c0: 2c20 6973 2069 6e20 7468 6520 2767 7275 , is in the 'gru │ │ │ │ │ -000023d0: 622d 636f 7265 2f62 6f6f 742f 2720 6469 b-core/boot/' di │ │ │ │ │ -000023e0: 7265 6374 6f72 792e 0a0a 2020 2054 6865 rectory... The │ │ │ │ │ -000023f0: 2047 5255 4220 6b65 726e 656c 2069 7320 GRUB kernel is │ │ │ │ │ -00002400: 696e 2027 6772 7562 2d63 6f72 652f 6b65 in 'grub-core/ke │ │ │ │ │ -00002410: 726e 2f27 2e20 2054 6869 7320 636f 6e74 rn/'. This cont │ │ │ │ │ -00002420: 6169 6e73 2063 6f72 650a 6661 6369 6c69 ains core.facili │ │ │ │ │ -00002430: 7469 6573 2073 7563 6820 6173 2074 6865 ties such as the │ │ │ │ │ -00002440: 2064 6576 6963 652c 2064 6973 6b2c 2061 device, disk, a │ │ │ │ │ -00002450: 6e64 2066 696c 6520 6672 616d 6577 6f72 nd file framewor │ │ │ │ │ -00002460: 6b73 2c20 656e 7669 726f 6e6d 656e 740a ks, environment. │ │ │ │ │ -00002470: 7661 7269 6162 6c65 2068 616e 646c 696e variable handlin │ │ │ │ │ -00002480: 672c 206c 6973 7420 7072 6f63 6573 7369 g, list processi │ │ │ │ │ -00002490: 6e67 2c20 616e 6420 736f 206f 6e2e 2020 ng, and so on. │ │ │ │ │ -000024a0: 5468 6520 6b65 726e 656c 2073 686f 756c The kernel shoul │ │ │ │ │ -000024b0: 640a 636f 6e74 6169 6e20 656e 6f75 6768 d.contain enough │ │ │ │ │ -000024c0: 2074 6f20 6765 7420 7570 2074 6f20 6120 to get up to a │ │ │ │ │ -000024d0: 7265 7363 7565 2070 726f 6d70 742e 2020 rescue prompt. │ │ │ │ │ -000024e0: 4865 6164 6572 2066 696c 6573 2066 6f72 Header files for │ │ │ │ │ -000024f0: 206b 6572 6e65 6c0a 6661 6369 6c69 7469 kernel.faciliti │ │ │ │ │ -00002500: 6573 2c20 616d 6f6e 6720 6f74 6865 7273 es, among others │ │ │ │ │ -00002510: 2c20 6172 6520 696e 2027 696e 636c 7564 , are in 'includ │ │ │ │ │ -00002520: 652f 272e 0a0a 2020 2054 6572 6d69 6e61 e/'... Termina │ │ │ │ │ -00002530: 6c20 696d 706c 656d 656e 7461 7469 6f6e l implementation │ │ │ │ │ -00002540: 7320 6172 6520 696e 2027 6772 7562 2d63 s are in 'grub-c │ │ │ │ │ -00002550: 6f72 652f 7465 726d 2f27 2e0a 0a20 2020 ore/term/'... │ │ │ │ │ -00002560: 4469 736b 2061 6363 6573 7320 636f 6465 Disk access code │ │ │ │ │ -00002570: 2069 7320 7370 7265 6164 2061 6372 6f73 is spread acros │ │ │ │ │ -00002580: 7320 2767 7275 622d 636f 7265 2f64 6973 s 'grub-core/dis │ │ │ │ │ -00002590: 6b2f 2720 2866 6f72 2061 6363 6573 7369 k/' (for accessi │ │ │ │ │ -000025a0: 6e67 0a74 6865 2064 6973 6b20 6465 7669 ng.the disk devi │ │ │ │ │ -000025b0: 6365 7320 7468 656d 7365 6c76 6573 292c ces themselves), │ │ │ │ │ -000025c0: 2027 6772 7562 2d63 6f72 652f 7061 7274 'grub-core/part │ │ │ │ │ -000025d0: 6d61 702f 2720 2866 6f72 2069 6e74 6572 map/' (for inter │ │ │ │ │ -000025e0: 7072 6574 696e 670a 7061 7274 6974 696f preting.partitio │ │ │ │ │ -000025f0: 6e20 7461 626c 6520 6461 7461 292c 2061 n table data), a │ │ │ │ │ -00002600: 6e64 2027 6772 7562 2d63 6f72 652f 6673 nd 'grub-core/fs │ │ │ │ │ -00002610: 2f27 2028 666f 7220 6163 6365 7373 696e /' (for accessin │ │ │ │ │ -00002620: 6720 6669 6c65 7379 7374 656d 7329 2e0a g filesystems).. │ │ │ │ │ -00002630: 4e6f 7465 2074 6861 742c 2077 6974 6820 Note that, with │ │ │ │ │ -00002640: 7468 6520 6f64 6420 7370 6563 6961 6c69 the odd speciali │ │ │ │ │ -00002650: 7365 6420 6578 6365 7074 696f 6e2c 2047 sed exception, G │ │ │ │ │ -00002660: 5255 4220 6f6e 6c79 2063 6f6e 7461 696e RUB only contain │ │ │ │ │ -00002670: 7320 636f 6465 0a74 6f20 5f72 6561 645f s code.to _read_ │ │ │ │ │ -00002680: 2066 726f 6d20 6669 6c65 7379 7374 656d from filesystem │ │ │ │ │ -00002690: 7320 616e 6420 7472 6965 7320 746f 2061 s and tries to a │ │ │ │ │ -000026a0: 766f 6964 2063 6f6e 7461 696e 696e 6720 void containing │ │ │ │ │ -000026b0: 616e 7920 636f 6465 2074 6f0a 5f77 7269 any code to._wri │ │ │ │ │ -000026c0: 7465 5f20 746f 2066 696c 6573 7973 7465 te_ to filesyste │ │ │ │ │ -000026d0: 6d73 3b20 7468 6973 206c 6574 7320 7573 ms; this lets us │ │ │ │ │ -000026e0: 2063 6f6e 6669 6465 6e74 6c79 2061 7373 confidently ass │ │ │ │ │ -000026f0: 7572 6520 7573 6572 7320 7468 6174 2047 ure users that G │ │ │ │ │ -00002700: 5255 420a 6361 6e6e 6f74 2062 6520 7265 RUB.cannot be re │ │ │ │ │ -00002710: 7370 6f6e 7369 626c 6520 666f 7220 6669 sponsible for fi │ │ │ │ │ -00002720: 6c65 7379 7374 656d 2063 6f72 7275 7074 lesystem corrupt │ │ │ │ │ -00002730: 696f 6e2e 0a0a 2020 2050 4349 2061 6e64 ion... PCI and │ │ │ │ │ -00002740: 2055 5342 2062 7573 2068 616e 646c 696e USB bus handlin │ │ │ │ │ -00002750: 6720 6973 2069 6e20 2767 7275 622d 636f g is in 'grub-co │ │ │ │ │ -00002760: 7265 2f62 7573 2f27 2e0a 0a20 2020 5669 re/bus/'... Vi │ │ │ │ │ -00002770: 6465 6f20 6861 6e64 6c69 6e67 2063 6f64 deo handling cod │ │ │ │ │ -00002780: 6520 6973 2069 6e20 2767 7275 622d 636f e is in 'grub-co │ │ │ │ │ -00002790: 7265 2f76 6964 656f 2f27 2e20 2054 6865 re/video/'. The │ │ │ │ │ -000027a0: 2067 7261 7068 6963 616c 206d 656e 750a graphical menu. │ │ │ │ │ -000027b0: 7379 7374 656d 2075 7365 7320 7468 6973 system uses this │ │ │ │ │ -000027c0: 2068 6561 7669 6c79 2c20 6275 7420 6973 heavily, but is │ │ │ │ │ -000027d0: 2069 6e20 6120 7365 7061 7261 7465 2064 in a separate d │ │ │ │ │ -000027e0: 6972 6563 746f 7279 2c0a 2767 7275 622d irectory,.'grub- │ │ │ │ │ -000027f0: 636f 7265 2f67 6678 6d65 6e75 2f27 2e0a core/gfxmenu/'.. │ │ │ │ │ -00002800: 0a20 2020 4d6f 7374 2063 6f6d 6d61 6e64 . Most command │ │ │ │ │ -00002810: 7320 6172 6520 696d 706c 656d 656e 7465 s are implemente │ │ │ │ │ -00002820: 6420 6279 2066 696c 6573 2069 6e20 2767 d by files in 'g │ │ │ │ │ -00002830: 7275 622d 636f 7265 2f63 6f6d 6d61 6e64 rub-core/command │ │ │ │ │ -00002840: 732f 272c 2077 6974 680a 7468 6520 666f s/', with.the fo │ │ │ │ │ -00002850: 6c6c 6f77 696e 6720 6578 6365 7074 696f llowing exceptio │ │ │ │ │ -00002860: 6e73 3a0a 0a20 2020 2a20 4120 6665 7720 ns:.. * A few │ │ │ │ │ -00002870: 636f 7265 2063 6f6d 6d61 6e64 7320 6c69 core commands li │ │ │ │ │ -00002880: 7665 2069 6e20 2767 7275 622d 636f 7265 ve in 'grub-core │ │ │ │ │ -00002890: 2f6b 6572 6e2f 636f 7265 636d 642e 6327 /kern/corecmd.c' │ │ │ │ │ -000028a0: 2e0a 0a20 2020 2a20 436f 6d6d 616e 6473 ... * Commands │ │ │ │ │ -000028b0: 2072 656c 6174 6564 2074 6f20 6e6f 726d related to norm │ │ │ │ │ -000028c0: 616c 206d 6f64 6520 6c69 7665 2075 6e64 al mode live und │ │ │ │ │ -000028d0: 6572 2027 6772 7562 2d63 6f72 652f 6e6f er 'grub-core/no │ │ │ │ │ -000028e0: 726d 616c 2f27 2e0a 0a20 2020 2a20 436f rmal/'... * Co │ │ │ │ │ -000028f0: 6d6d 616e 6473 2074 6861 7420 6c6f 6164 mmands that load │ │ │ │ │ -00002900: 2061 6e64 2062 6f6f 7420 6b65 726e 656c and boot kernel │ │ │ │ │ -00002910: 7320 6c69 7665 2075 6e64 6572 2027 6772 s live under 'gr │ │ │ │ │ -00002920: 7562 2d63 6f72 652f 6c6f 6164 6572 2f27 ub-core/loader/' │ │ │ │ │ -00002930: 2e0a 0a20 2020 2a20 5468 6520 276c 6f6f ... * The 'loo │ │ │ │ │ -00002940: 7062 6163 6b27 2063 6f6d 6d61 6e64 2069 pback' command i │ │ │ │ │ -00002950: 7320 7265 616c 6c79 2061 2064 6973 6b20 s really a disk │ │ │ │ │ -00002960: 6465 7669 6365 2c20 616e 6420 736f 206c device, and so l │ │ │ │ │ -00002970: 6976 6573 2069 6e0a 2020 2020 2027 6772 ives in. 'gr │ │ │ │ │ -00002980: 7562 2d63 6f72 652f 6469 736b 2f6c 6f6f ub-core/disk/loo │ │ │ │ │ -00002990: 7062 6163 6b2e 6327 2e0a 0a20 2020 2a20 pback.c'... * │ │ │ │ │ -000029a0: 5468 6520 2767 6574 7465 7874 2720 636f The 'gettext' co │ │ │ │ │ -000029b0: 6d6d 616e 6420 6c69 7665 7320 756e 6465 mmand lives unde │ │ │ │ │ -000029c0: 7220 2767 7275 622d 636f 7265 2f67 6574 r 'grub-core/get │ │ │ │ │ -000029d0: 7465 7874 2f27 2e0a 0a20 2020 2a20 5468 text/'... * Th │ │ │ │ │ -000029e0: 6520 276c 6f61 6466 6f6e 7427 2061 6e64 e 'loadfont' and │ │ │ │ │ -000029f0: 2027 6c73 666f 6e74 7327 2063 6f6d 6d61 'lsfonts' comma │ │ │ │ │ -00002a00: 6e64 7320 6c69 7665 2075 6e64 6572 2027 nds live under ' │ │ │ │ │ -00002a10: 6772 7562 2d63 6f72 652f 666f 6e74 2f27 grub-core/font/' │ │ │ │ │ -00002a20: 2e0a 0a20 2020 2a20 5468 6520 2773 6572 ... * The 'ser │ │ │ │ │ -00002a30: 6961 6c27 2c20 2774 6572 6d69 6e66 6f27 ial', 'terminfo' │ │ │ │ │ -00002a40: 2c20 616e 6420 2762 6163 6b67 726f 756e , and 'backgroun │ │ │ │ │ -00002a50: 645f 696d 6167 6527 2063 6f6d 6d61 6e64 d_image' command │ │ │ │ │ -00002a60: 7320 6c69 7665 0a20 2020 2020 756e 6465 s live. unde │ │ │ │ │ -00002a70: 7220 2767 7275 622d 636f 7265 2f74 6572 r 'grub-core/ter │ │ │ │ │ -00002a80: 6d2f 272e 0a0a 2020 202a 2054 6865 2027 m/'... * The ' │ │ │ │ │ -00002a90: 6566 6965 6d75 5f2a 2720 636f 6d6d 616e efiemu_*' comman │ │ │ │ │ -00002aa0: 6473 206c 6976 6520 756e 6465 7220 2767 ds live under 'g │ │ │ │ │ -00002ab0: 7275 622d 636f 7265 2f65 6669 656d 752f rub-core/efiemu/ │ │ │ │ │ -00002ac0: 272e 0a0a 2020 202a 204f 532d 6465 7065 '... * OS-depe │ │ │ │ │ -00002ad0: 6e64 656e 7420 636f 6465 2073 686f 756c ndent code shoul │ │ │ │ │ -00002ae0: 6420 6265 2075 6e64 6572 2027 6772 7562 d be under 'grub │ │ │ │ │ -00002af0: 2d63 6f72 652f 6f73 6465 702f 270a 0a20 -core/osdep/'.. │ │ │ │ │ -00002b00: 2020 2a20 5574 696c 6974 7920 7072 6f67 * Utility prog │ │ │ │ │ -00002b10: 7261 6d73 206d 6561 6e74 2074 6f20 6265 rams meant to be │ │ │ │ │ -00002b20: 2072 756e 2066 726f 6d20 6120 6675 6c6c run from a full │ │ │ │ │ -00002b30: 206f 7065 7261 7469 6e67 2073 7973 7465 operating syste │ │ │ │ │ -00002b40: 6d0a 2020 2020 2028 6578 6365 7074 204f m. (except O │ │ │ │ │ -00002b50: 532d 6465 7065 6e64 656e 7420 636f 6465 S-dependent code │ │ │ │ │ -00002b60: 206d 656e 7469 6f6e 6564 2070 7265 7669 mentioned previ │ │ │ │ │ -00002b70: 6f75 736c 7929 2061 7265 2069 6e20 2775 ously) are in 'u │ │ │ │ │ -00002b80: 7469 6c2f 272e 0a0a 2020 2054 6865 7265 til/'... There │ │ │ │ │ -00002b90: 2061 7265 2061 2066 6577 206f 7468 6572 are a few other │ │ │ │ │ -00002ba0: 2073 7065 6369 616c 2d70 7572 706f 7365 special-purpose │ │ │ │ │ -00002bb0: 2065 7863 6570 7469 6f6e 733b 2067 7265 exceptions; gre │ │ │ │ │ -00002bc0: 7020 666f 7220 7468 656d 2069 660a 7468 p for them if.th │ │ │ │ │ -00002bd0: 6579 206d 6174 7465 7220 746f 2079 6f75 ey matter to you │ │ │ │ │ -00002be0: 2e0a 0a1f 0a46 696c 653a 2067 7275 622d .....File: grub- │ │ │ │ │ -00002bf0: 6465 762e 696e 666f 2c20 204e 6f64 653a dev.info, Node: │ │ │ │ │ -00002c00: 2043 6f6e 7472 6962 7574 696e 6720 4368 Contributing Ch │ │ │ │ │ -00002c10: 616e 6765 732c 2020 4e65 7874 3a20 5570 anges, Next: Up │ │ │ │ │ -00002c20: 6461 7469 6e67 2045 7874 6572 6e61 6c20 dating External │ │ │ │ │ -00002c30: 436f 6465 2c20 2050 7265 763a 2046 696e Code, Prev: Fin │ │ │ │ │ -00002c40: 6469 6e67 2079 6f75 7220 7761 7920 6172 ding your way ar │ │ │ │ │ -00002c50: 6f75 6e64 2c20 2055 703a 2054 6f70 0a0a ound, Up: Top.. │ │ │ │ │ -00002c60: 3420 436f 6e74 7269 6275 7469 6e67 2063 4 Contributing c │ │ │ │ │ -00002c70: 6861 6e67 6573 0a2a 2a2a 2a2a 2a2a 2a2a hanges.********* │ │ │ │ │ -00002c80: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a43 *************..C │ │ │ │ │ -00002c90: 6f6e 7472 6962 7574 696e 6720 6368 616e ontributing chan │ │ │ │ │ -00002ca0: 6765 7320 746f 2047 5255 4220 3220 6973 ges to GRUB 2 is │ │ │ │ │ -00002cb0: 2077 656c 636f 6d65 6420 6163 7469 7669 welcomed activi │ │ │ │ │ -00002cc0: 7479 2e20 2048 6f77 6576 6572 2077 6520 ty. However we │ │ │ │ │ -00002cd0: 6861 7665 2061 0a62 6974 206f 6620 636f have a.bit of co │ │ │ │ │ -00002ce0: 6e74 726f 6c20 7768 6174 206b 696e 6420 ntrol what kind │ │ │ │ │ -00002cf0: 6f66 2063 6861 6e67 6573 2077 696c 6c20 of changes will │ │ │ │ │ -00002d00: 6265 2061 6363 6570 7465 6420 746f 2047 be accepted to G │ │ │ │ │ -00002d10: 5255 4220 322e 0a54 6865 7265 666f 7265 RUB 2..Therefore │ │ │ │ │ -00002d20: 2069 7420 6973 2069 6d70 6f72 7461 6e74 it is important │ │ │ │ │ -00002d30: 2074 6f20 6469 7363 7573 7320 796f 7572 to discuss your │ │ │ │ │ -00002d40: 2063 6861 6e67 6573 206f 6e20 6772 7562 changes on grub │ │ │ │ │ -00002d50: 2d64 6576 656c 206d 6169 6c69 6e67 0a6c -devel mailing.l │ │ │ │ │ -00002d60: 6973 7420 2873 6565 204d 6169 6c69 6e67 ist (see Mailing │ │ │ │ │ -00002d70: 4c69 7374 7329 2e20 204f 6e20 7468 6973 Lists). On this │ │ │ │ │ -00002d80: 2070 6167 6520 7468 6572 6520 6172 6520 page there are │ │ │ │ │ -00002d90: 736f 6d65 2062 6173 6963 2064 6574 6169 some basic detai │ │ │ │ │ -00002da0: 6c73 206f 6e0a 7468 6520 6465 7665 6c6f ls on.the develo │ │ │ │ │ -00002db0: 706d 656e 7420 7072 6f63 6573 7320 616e pment process an │ │ │ │ │ -00002dc0: 6420 6163 7469 7669 7469 6573 2e0a 0a20 d activities... │ │ │ │ │ -00002dd0: 2020 4669 7273 7420 6f66 2061 6c6c 2079 First of all y │ │ │ │ │ -00002de0: 6f75 2073 686f 756c 6420 636f 6d65 2075 ou should come u │ │ │ │ │ -00002df0: 7020 7769 7468 2074 6865 2069 6465 6120 p with the idea │ │ │ │ │ -00002e00: 796f 7572 7365 6c66 2077 6861 7420 796f yourself what yo │ │ │ │ │ -00002e10: 7520 7761 6e74 0a74 6f20 636f 6e74 7269 u want.to contri │ │ │ │ │ -00002e20: 6275 7465 2e20 2049 6620 796f 7520 646f bute. If you do │ │ │ │ │ -00002e30: 206e 6f74 2068 6176 6520 7468 6174 2062 not have that b │ │ │ │ │ -00002e40: 6566 6f72 6568 616e 6420 796f 7520 6172 eforehand you ar │ │ │ │ │ -00002e50: 6520 6164 7669 7365 6420 746f 0a73 7475 e advised to.stu │ │ │ │ │ -00002e60: 6479 2074 6869 7320 6d61 6e75 616c 2061 dy this manual a │ │ │ │ │ -00002e70: 6e64 2074 7279 2047 5255 4220 3220 6f75 nd try GRUB 2 ou │ │ │ │ │ -00002e80: 7420 746f 2073 6565 2077 6861 7420 796f t to see what yo │ │ │ │ │ -00002e90: 7520 7468 696e 6b20 6973 206d 6973 7369 u think is missi │ │ │ │ │ -00002ea0: 6e67 0a66 726f 6d20 7468 6572 652e 0a0a ng.from there... │ │ │ │ │ -00002eb0: 2020 2048 6572 6520 6172 6520 6164 6469 Here are addi │ │ │ │ │ -00002ec0: 7469 6f6e 616c 2070 6f69 6e74 6572 733a tional pointers: │ │ │ │ │ -00002ed0: 0a20 2020 2a20 3c68 7474 7073 3a2f 2f73 . * . * .. If │ │ │ │ │ -00002f60: 2079 6f75 2069 6e74 656e 6465 6420 746f you intended to │ │ │ │ │ -00002f70: 206d 616b 6520 6368 616e 6765 7320 746f make changes to │ │ │ │ │ -00002f80: 2047 5255 4220 4c65 6761 6379 2028 3c3d GRUB Legacy (<= │ │ │ │ │ -00002f90: 302e 3937 2920 7468 6f73 6520 6172 6520 0.97) those are │ │ │ │ │ -00002fa0: 6e6f 740a 6163 6365 7074 6564 2061 6e79 not.accepted any │ │ │ │ │ -00002fb0: 6d6f 7265 2e0a 0a2a 204d 656e 753a 0a0a more...* Menu:.. │ │ │ │ │ -00002fc0: 2a20 4765 7474 696e 6720 7374 6172 7465 * Getting starte │ │ │ │ │ -00002fd0: 643a 3a0a 2a20 5479 7069 6361 6c20 4465 d::.* Typical De │ │ │ │ │ -00002fe0: 7665 6c6f 7065 7220 4578 7065 7269 656e veloper Experien │ │ │ │ │ -00002ff0: 6365 3a3a 0a2a 2057 6865 6e20 796f 7520 ce::.* When you │ │ │ │ │ -00003000: 6172 6520 6170 7072 6f76 6564 2066 6f72 are approved for │ │ │ │ │ -00003010: 2077 7269 7465 2061 6363 6573 7320 746f write access to │ │ │ │ │ -00003020: 2070 726f 6a65 6374 2773 2066 696c 6573 project's files │ │ │ │ │ -00003030: 3a3a 0a0a 1f0a 4669 6c65 3a20 6772 7562 ::....File: grub │ │ │ │ │ -00003040: 2d64 6576 2e69 6e66 6f2c 2020 4e6f 6465 -dev.info, Node │ │ │ │ │ -00003050: 3a20 4765 7474 696e 6720 7374 6172 7465 : Getting starte │ │ │ │ │ -00003060: 642c 2020 4e65 7874 3a20 5479 7069 6361 d, Next: Typica │ │ │ │ │ -00003070: 6c20 4465 7665 6c6f 7065 7220 4578 7065 l Developer Expe │ │ │ │ │ -00003080: 7269 656e 6365 2c20 2055 703a 2043 6f6e rience, Up: Con │ │ │ │ │ -00003090: 7472 6962 7574 696e 6720 4368 616e 6765 tributing Change │ │ │ │ │ -000030a0: 730a 0a34 2e31 2047 6574 7469 6e67 2073 s..4.1 Getting s │ │ │ │ │ -000030b0: 7461 7274 6564 0a3d 3d3d 3d3d 3d3d 3d3d tarted.========= │ │ │ │ │ -000030c0: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 2020 202a ==========.. * │ │ │ │ │ -000030d0: 2041 6c77 6179 7320 7573 6520 6c61 7465 Always use late │ │ │ │ │ -000030e0: 7374 2047 5255 4220 3220 736f 7572 6365 st GRUB 2 source │ │ │ │ │ -000030f0: 2063 6f64 652e 2020 536f 2067 6574 2074 code. So get t │ │ │ │ │ -00003100: 6861 7420 6669 7273 742e 0a0a 2020 2020 hat first... │ │ │ │ │ -00003110: 2046 6f72 2064 6576 656c 6f70 6572 7320 For developers │ │ │ │ │ -00003120: 6974 2069 7320 7265 636f 6d6d 656e 6465 it is recommende │ │ │ │ │ -00003130: 6420 616c 7761 7973 2074 6f20 7573 6520 d always to use │ │ │ │ │ -00003140: 7468 6520 6e65 7765 7374 0a20 2020 2020 the newest. │ │ │ │ │ -00003150: 6465 7665 6c6f 706d 656e 7420 7665 7273 development vers │ │ │ │ │ -00003160: 696f 6e20 6f66 2047 5255 4220 322e 2020 ion of GRUB 2. │ │ │ │ │ -00003170: 4966 2064 6576 656c 6f70 6d65 6e74 2074 If development t │ │ │ │ │ -00003180: 616b 6573 2061 206c 6f6e 6720 7065 7269 akes a long peri │ │ │ │ │ -00003190: 6f64 0a20 2020 2020 6f66 2074 696d 652c od. of time, │ │ │ │ │ -000031a0: 2070 6c65 6173 6520 7265 6d65 6d62 6572 please remember │ │ │ │ │ -000031b0: 2074 6f20 6b65 6570 2069 6e20 7379 6e63 to keep in sync │ │ │ │ │ -000031c0: 2077 6974 6820 6e65 7765 7374 2064 6576 with newest dev │ │ │ │ │ -000031d0: 656c 6f70 6d65 6e74 730a 2020 2020 2072 elopments. r │ │ │ │ │ -000031e0: 6567 756c 6172 6c79 2073 6f20 6974 2069 egularly so it i │ │ │ │ │ -000031f0: 7320 6d75 6368 2065 6173 6965 7220 746f s much easier to │ │ │ │ │ -00003200: 2069 6e74 6567 7261 7465 2079 6f75 7220 integrate your │ │ │ │ │ -00003210: 6368 616e 6765 2069 6e20 7468 650a 2020 change in the. │ │ │ │ │ -00003220: 2020 2066 7574 7572 652e 2020 4752 5542 future. GRUB │ │ │ │ │ -00003230: 2032 2069 7320 6265 696e 6720 6465 7665 2 is being deve │ │ │ │ │ -00003240: 6c6f 7065 6420 696e 2061 2047 4954 2072 loped in a GIT r │ │ │ │ │ -00003250: 6570 6f73 6974 6f72 792e 0a0a 2020 2020 epository... │ │ │ │ │ -00003260: 2050 6c65 6173 6520 6368 6563 6b20 5361 Please check Sa │ │ │ │ │ -00003270: 7661 6e6e 6168 2773 2047 5255 4220 7072 vannah's GRUB pr │ │ │ │ │ -00003280: 6f6a 6563 7420 7061 6765 2066 6f72 2064 oject page for d │ │ │ │ │ -00003290: 6574 6169 6c73 2068 6f77 2074 6f20 6765 etails how to ge │ │ │ │ │ -000032a0: 740a 2020 2020 206e 6577 6573 7420 6769 t. newest gi │ │ │ │ │ -000032b0: 743a 2047 5255 4220 3220 6769 7420 5265 t: GRUB 2 git Re │ │ │ │ │ -000032c0: 706f 7369 746f 7279 0a20 2020 2020 2868 pository. (h │ │ │ │ │ -000032d0: 7474 7073 3a2f 2f73 6176 616e 6e61 682e ttps://savannah. │ │ │ │ │ -000032e0: 676e 752e 6f72 672f 6769 742f 3f67 726f gnu.org/git/?gro │ │ │ │ │ -000032f0: 7570 3d67 7275 6229 0a0a 2020 202a 2043 up=grub).. * C │ │ │ │ │ -00003300: 6f6d 7069 6c65 2069 7420 616e 6420 7472 ompile it and tr │ │ │ │ │ -00003310: 7920 6974 206f 7574 2e0a 0a20 2020 2020 y it out... │ │ │ │ │ -00003320: 4974 2069 7320 616c 7761 7973 2067 6f6f It is always goo │ │ │ │ │ -00003330: 6420 6964 6561 2074 6f20 6669 7273 7420 d idea to first │ │ │ │ │ -00003340: 7365 6520 7468 6174 2074 6869 6e67 7320 see that things │ │ │ │ │ -00003350: 776f 726b 2073 6f6d 6568 6f77 2061 6e64 work somehow and │ │ │ │ │ -00003360: 0a20 2020 2020 6166 7465 7220 7468 6174 . after that │ │ │ │ │ -00003370: 2074 6f20 7374 6172 7420 746f 2069 6d70 to start to imp │ │ │ │ │ -00003380: 6c65 6d65 6e74 206e 6577 2066 6561 7475 lement new featu │ │ │ │ │ -00003390: 7265 7320 6f72 2064 6576 656c 6f70 2066 res or develop f │ │ │ │ │ -000033a0: 6978 6573 2074 6f0a 2020 2020 2062 7567 ixes to. bug │ │ │ │ │ -000033b0: 732e 0a0a 2020 202a 2053 7475 6479 2074 s... * Study t │ │ │ │ │ -000033c0: 6865 2063 6f64 652e 0a0a 2020 2020 2054 he code... T │ │ │ │ │ -000033d0: 6865 7265 2061 7265 2073 6f6d 6574 696d here are sometim │ │ │ │ │ -000033e0: 6573 206f 6464 2077 6179 7320 746f 2064 es odd ways to d │ │ │ │ │ -000033f0: 6f20 7468 696e 6773 2069 6e20 4752 5542 o things in GRUB │ │ │ │ │ -00003400: 2032 2063 6f64 6520 6261 7365 2e0a 2020 2 code base.. │ │ │ │ │ -00003410: 2020 2054 6869 7320 6973 206d 6169 6e6c This is mainl │ │ │ │ │ -00003420: 7920 7265 6c61 7465 6420 746f 206c 696d y related to lim │ │ │ │ │ -00003430: 6974 6564 2065 6e76 6972 6f6e 6d65 6e74 ited environment │ │ │ │ │ -00003440: 2077 6865 7265 2047 5255 4220 3220 6973 where GRUB 2 is │ │ │ │ │ -00003450: 2062 6569 6e67 0a20 2020 2020 6578 6563 being. exec │ │ │ │ │ -00003460: 7574 6564 2e20 2059 6f75 2075 7375 616c uted. You usual │ │ │ │ │ -00003470: 6c79 2064 6f20 6e6f 7420 6e65 6564 2074 ly do not need t │ │ │ │ │ -00003480: 6f20 756e 6465 7273 7461 6e64 2069 7420 o understand it │ │ │ │ │ -00003490: 616c 6c20 736f 2069 7420 6973 0a20 2020 all so it is. │ │ │ │ │ -000034a0: 2020 6265 7474 6572 2074 6f20 6f6e 6c79 better to only │ │ │ │ │ -000034b0: 2074 7279 2074 6f20 6c6f 6f6b 2061 7420 try to look at │ │ │ │ │ -000034c0: 706c 6163 6573 2074 6861 7420 7265 6c61 places that rela │ │ │ │ │ -000034d0: 7465 7320 746f 2079 6f75 7220 776f 726b tes to your work │ │ │ │ │ -000034e0: 2e0a 2020 2020 2050 6c65 6173 6520 646f .. Please do │ │ │ │ │ -000034f0: 206e 6f74 2068 6573 6974 6174 6520 746f not hesitate to │ │ │ │ │ -00003500: 2061 736b 2066 6f72 2068 656c 7020 6966 ask for help if │ │ │ │ │ -00003510: 2074 6865 7265 2069 7320 736f 6d65 7468 there is someth │ │ │ │ │ -00003520: 696e 6720 7468 6174 0a20 2020 2020 796f ing that. yo │ │ │ │ │ -00003530: 7520 646f 206e 6f74 2075 6e64 6572 7374 u do not underst │ │ │ │ │ -00003540: 616e 642e 0a0a 2020 202a 2044 6576 656c and... * Devel │ │ │ │ │ -00003550: 6f70 2061 206e 6577 2066 6561 7475 7265 op a new feature │ │ │ │ │ -00003560: 2e0a 0a20 2020 2020 4e6f 7720 7468 6174 ... Now that │ │ │ │ │ -00003570: 2079 6f75 206b 6e6f 7720 7768 6174 2074 you know what t │ │ │ │ │ -00003580: 6f20 646f 2061 6e64 2068 6f77 2069 7420 o do and how it │ │ │ │ │ -00003590: 7368 6f75 6c64 2077 6f72 6b20 696e 2047 should work in G │ │ │ │ │ -000035a0: 5255 4220 3220 636f 6465 0a20 2020 2020 RUB 2 code. │ │ │ │ │ -000035b0: 6261 7365 2c20 706c 6561 7365 2062 6520 base, please be │ │ │ │ │ -000035c0: 6672 6565 2074 6f20 6465 7665 6c6f 7020 free to develop │ │ │ │ │ -000035d0: 6974 2e20 2049 6620 796f 7520 6861 7665 it. If you have │ │ │ │ │ -000035e0: 206e 6f74 2073 6f20 6661 720a 2020 2020 not so far. │ │ │ │ │ -000035f0: 2061 6e6e 6f75 6e63 6564 2079 6f75 7220 announced your │ │ │ │ │ -00003600: 6964 6561 206f 6e20 6772 7562 2d64 6576 idea on grub-dev │ │ │ │ │ -00003610: 656c 206d 6169 6c69 6e67 206c 6973 742c el mailing list, │ │ │ │ │ -00003620: 2070 6c65 6173 6520 646f 2069 7420 6e6f please do it no │ │ │ │ │ -00003630: 772e 0a20 2020 2020 5468 6973 2069 7320 w.. This is │ │ │ │ │ -00003640: 746f 206d 616b 6520 7375 7265 2079 6f75 to make sure you │ │ │ │ │ -00003650: 2061 7265 206e 6f74 2077 6173 7469 6e67 are not wasting │ │ │ │ │ -00003660: 2079 6f75 7220 7469 6d65 2077 6f72 6b69 your time worki │ │ │ │ │ -00003670: 6e67 206f 6e20 7468 650a 2020 2020 2073 ng on the. s │ │ │ │ │ -00003680: 6f6c 7574 696f 6e20 7468 6174 2077 696c olution that wil │ │ │ │ │ -00003690: 6c20 6e6f 7420 6265 2069 6e74 6567 7261 l not be integra │ │ │ │ │ -000036a0: 7465 6420 746f 2047 5255 4220 3220 636f ted to GRUB 2 co │ │ │ │ │ -000036b0: 6465 2062 6173 652e 0a0a 2020 2020 2059 de base... Y │ │ │ │ │ -000036c0: 6f75 206d 6967 6874 2077 616e 7420 746f ou might want to │ │ │ │ │ -000036d0: 2073 7475 6479 206f 7572 2063 6f64 696e study our codin │ │ │ │ │ -000036e0: 6720 7374 796c 6520 6265 666f 7265 2073 g style before s │ │ │ │ │ -000036f0: 7461 7274 696e 670a 2020 2020 2064 6576 tarting. dev │ │ │ │ │ -00003700: 656c 6f70 6d65 6e74 2073 6f20 796f 7520 elopment so you │ │ │ │ │ -00003710: 646f 206e 6f74 206e 6565 6420 746f 2063 do not need to c │ │ │ │ │ -00003720: 6861 6e67 6520 6d75 6368 206f 6620 7468 hange much of th │ │ │ │ │ -00003730: 6520 636f 6465 2077 6865 6e20 796f 7572 e code when your │ │ │ │ │ -00003740: 0a20 2020 2020 7061 7463 6820 6973 2062 . patch is b │ │ │ │ │ -00003750: 6569 6e67 2072 6576 6965 7765 642e 2020 eing reviewed. │ │ │ │ │ -00003760: 2873 6565 202a 6e6f 7465 2043 6f64 696e (see *note Codin │ │ │ │ │ -00003770: 6720 7374 796c 653a 3a29 0a0a 2020 2020 g style::).. │ │ │ │ │ -00003780: 2046 6f72 2065 7665 7279 2061 6363 6570 For every accep │ │ │ │ │ -00003790: 7465 6420 7061 7463 6820 7468 6572 6520 ted patch there │ │ │ │ │ -000037a0: 6861 7320 746f 2065 7869 7374 2061 2043 has to exist a C │ │ │ │ │ -000037b0: 6861 6e67 654c 6f67 2065 6e74 7279 2e20 hangeLog entry. │ │ │ │ │ -000037c0: 204f 7572 0a20 2020 2020 4368 616e 6765 Our. Change │ │ │ │ │ -000037d0: 4c6f 6720 636f 6e73 6973 7420 6f66 2063 Log consist of c │ │ │ │ │ -000037e0: 6861 6e67 6573 2077 6974 6869 6e20 736f hanges within so │ │ │ │ │ -000037f0: 7572 6365 2063 6f64 6520 616e 6420 6172 urce code and ar │ │ │ │ │ -00003800: 6520 6e6f 740a 2020 2020 2064 6573 6372 e not. descr │ │ │ │ │ -00003810: 6962 696e 6720 6162 6f75 7420 7768 6174 ibing about what │ │ │ │ │ -00003820: 2074 6865 2063 6861 6e67 6520 6c6f 6769 the change logi │ │ │ │ │ -00003830: 6361 6c6c 7920 646f 6573 2e20 2050 6c65 cally does. Ple │ │ │ │ │ -00003840: 6173 6520 7365 650a 2020 2020 2065 7861 ase see. exa │ │ │ │ │ -00003850: 6d70 6c65 7320 6672 6f6d 2070 7265 7669 mples from previ │ │ │ │ │ -00003860: 6f75 7320 656e 7472 6965 732e 0a0a 2020 ous entries... │ │ │ │ │ -00003870: 2020 2041 6c73 6f20 7265 6d65 6d62 6572 Also remember │ │ │ │ │ -00003880: 2074 6861 7420 4752 5542 2032 2069 7320 that GRUB 2 is │ │ │ │ │ -00003890: 6c69 6365 6e73 6564 2075 6e64 6572 2047 licensed under G │ │ │ │ │ -000038a0: 504c 7633 206c 6963 656e 7365 2061 6e64 PLv3 license and │ │ │ │ │ -000038b0: 2074 6861 740a 2020 2020 2075 7375 616c that. usual │ │ │ │ │ -000038c0: 6c79 206d 6561 6e73 2074 6861 7420 796f ly means that yo │ │ │ │ │ -000038d0: 7520 6172 6520 6e6f 7420 616c 6c6f 7765 u are not allowe │ │ │ │ │ -000038e0: 6420 746f 2063 6f70 7920 7069 6563 6573 d to copy pieces │ │ │ │ │ -000038f0: 206f 6620 636f 6465 2066 726f 6d0a 2020 of code from. │ │ │ │ │ -00003900: 2020 206f 7468 6572 2070 726f 6a65 6374 other project │ │ │ │ │ -00003910: 732e 2020 4576 656e 2069 6620 7468 6520 s. Even if the │ │ │ │ │ -00003920: 736f 7572 6365 2070 726f 6a65 6374 2773 source project's │ │ │ │ │ -00003930: 206c 6963 656e 7365 2077 6f75 6c64 2062 license would b │ │ │ │ │ -00003940: 650a 2020 2020 2063 6f6d 7061 7469 626c e. compatibl │ │ │ │ │ -00003950: 6520 7769 7468 2047 504c 7633 2c20 706c e with GPLv3, pl │ │ │ │ │ -00003960: 6561 7365 2064 6973 6375 7373 2069 7420 ease discuss it │ │ │ │ │ -00003970: 6265 666f 7265 6861 6e64 206f 6e20 6772 beforehand on gr │ │ │ │ │ -00003980: 7562 2d64 6576 656c 0a20 2020 2020 6d61 ub-devel. ma │ │ │ │ │ -00003990: 696c 696e 6720 6c69 7374 2e0a 0a20 2020 iling list... │ │ │ │ │ -000039a0: 2a20 5465 7374 2079 6f75 7220 6368 616e * Test your chan │ │ │ │ │ -000039b0: 6765 2e0a 0a20 2020 2020 5465 7374 2074 ge... Test t │ │ │ │ │ -000039c0: 6861 7420 796f 7572 2063 6861 6e67 6520 hat your change │ │ │ │ │ -000039d0: 776f 726b 7320 7072 6f70 6572 6c79 2e20 works properly. │ │ │ │ │ -000039e0: 2054 7279 2069 7420 6f75 7420 6120 636f Try it out a co │ │ │ │ │ -000039f0: 7570 6c65 206f 660a 2020 2020 2074 696d uple of. tim │ │ │ │ │ -00003a00: 6573 2c20 7072 6566 6572 6162 6c79 206f es, preferably o │ │ │ │ │ -00003a10: 6e20 6469 6666 6572 656e 7420 7379 7374 n different syst │ │ │ │ │ -00003a20: 656d 732c 2061 6e64 2074 7279 2074 6f20 ems, and try to │ │ │ │ │ -00003a30: 6669 6e64 2070 726f 626c 656d 730a 2020 find problems. │ │ │ │ │ -00003a40: 2020 2077 6974 6820 6974 2e0a 0a20 2020 with it... │ │ │ │ │ -00003a50: 2a20 5075 626c 6973 6820 796f 7572 2063 * Publish your c │ │ │ │ │ -00003a60: 6861 6e67 652e 0a0a 2020 2020 2057 6865 hange... Whe │ │ │ │ │ -00003a70: 6e20 796f 7520 6172 6520 6861 7070 7920 n you are happy │ │ │ │ │ -00003a80: 7769 7468 2079 6f75 7220 6368 616e 6765 with your change │ │ │ │ │ -00003a90: 2c20 6669 7273 7420 6d61 6b65 2073 7572 , first make sur │ │ │ │ │ -00003aa0: 6520 6974 2069 730a 2020 2020 2063 6f6d e it is. com │ │ │ │ │ -00003ab0: 7069 6c61 626c 6520 7769 7468 206c 6174 pilable with lat │ │ │ │ │ -00003ac0: 6573 7420 6465 7665 6c6f 706d 656e 7420 est development │ │ │ │ │ -00003ad0: 7665 7273 696f 6e20 6f66 2047 5255 4220 version of GRUB │ │ │ │ │ -00003ae0: 322e 2020 4166 7465 7220 7468 6174 0a20 2. After that. │ │ │ │ │ -00003af0: 2020 2020 706c 6561 7365 2073 656e 6420 please send │ │ │ │ │ -00003b00: 6120 7061 7463 6820 746f 2067 7275 622d a patch to grub- │ │ │ │ │ -00003b10: 6465 7665 6c20 666f 7220 7265 7669 6577 devel for review │ │ │ │ │ -00003b20: 2e20 2050 6c65 6173 6520 6465 7363 7269 . Please descri │ │ │ │ │ -00003b30: 6265 2069 6e0a 2020 2020 2079 6f75 7220 be in. your │ │ │ │ │ -00003b40: 656d 6169 6c20 7768 7920 796f 7520 6d61 email why you ma │ │ │ │ │ -00003b50: 6465 2074 6865 2063 6861 6e67 652c 2077 de the change, w │ │ │ │ │ -00003b60: 6861 7420 6974 2063 6861 6e67 6573 2061 hat it changes a │ │ │ │ │ -00003b70: 6e64 2073 6f20 6f6e 2e0a 2020 2020 2050 nd so on.. P │ │ │ │ │ -00003b80: 6c65 6173 6520 6265 2070 7265 7061 7265 lease be prepare │ │ │ │ │ -00003b90: 6420 746f 2072 6563 6569 7665 2065 7665 d to receive eve │ │ │ │ │ -00003ba0: 6e20 6469 7363 6f75 7261 6769 6e67 2063 n discouraging c │ │ │ │ │ -00003bb0: 6f6d 6d65 6e74 7320 6162 6f75 7420 796f omments about yo │ │ │ │ │ -00003bc0: 7572 0a20 2020 2020 7061 7463 682e 2020 ur. patch. │ │ │ │ │ -00003bd0: 5468 6572 6520 6973 2075 7375 616c 6c79 There is usually │ │ │ │ │ -00003be0: 2061 7420 6c65 6173 7420 736f 6d65 7468 at least someth │ │ │ │ │ -00003bf0: 696e 6720 7468 6174 206e 6565 6473 2074 ing that needs t │ │ │ │ │ -00003c00: 6f20 6265 0a20 2020 2020 696d 7072 6f76 o be. improv │ │ │ │ │ -00003c10: 6564 2069 6e20 6576 6572 7920 7061 7463 ed in every patc │ │ │ │ │ -00003c20: 682e 0a0a 2020 2020 2050 6c65 6173 6520 h... Please │ │ │ │ │ -00003c30: 7573 6520 756e 6966 6965 6420 6469 6666 use unified diff │ │ │ │ │ -00003c40: 2074 6f20 6d61 6b65 2079 6f75 7220 7061 to make your pa │ │ │ │ │ -00003c50: 7463 6820 2867 6f6f 6420 6d61 7463 6820 tch (good match │ │ │ │ │ -00003c60: 6f66 2061 7267 756d 656e 7473 0a20 2020 of arguments. │ │ │ │ │ -00003c70: 2020 666f 7220 6469 6666 2069 7320 272d for diff is '- │ │ │ │ │ -00003c80: 7072 754e 2729 2e0a 0a20 2020 2a20 5265 pruN')... * Re │ │ │ │ │ -00003c90: 7370 6f6e 6420 746f 2072 6563 6569 7665 spond to receive │ │ │ │ │ -00003ca0: 6420 6665 6564 6261 636b 2e0a 0a20 2020 d feedback... │ │ │ │ │ -00003cb0: 2020 4966 2079 6f75 2061 7265 2061 736b If you are ask │ │ │ │ │ -00003cc0: 6564 2074 6f20 6d6f 6469 6679 2079 6f75 ed to modify you │ │ │ │ │ -00003cd0: 7220 7061 7463 682c 2070 6c65 6173 6520 r patch, please │ │ │ │ │ -00003ce0: 646f 2074 6861 7420 616e 6420 7265 7375 do that and resu │ │ │ │ │ -00003cf0: 626d 6974 0a20 2020 2020 6974 2066 6f72 bmit. it for │ │ │ │ │ -00003d00: 2072 6576 6965 772e 2020 4966 2079 6f75 review. If you │ │ │ │ │ -00003d10: 7220 6368 616e 6765 2069 7320 6c61 7267 r change is larg │ │ │ │ │ -00003d20: 6520 796f 7520 6172 6520 7265 7175 6972 e you are requir │ │ │ │ │ -00003d30: 6564 2074 6f20 7375 626d 6974 0a20 2020 ed to submit. │ │ │ │ │ -00003d40: 2020 6120 636f 7079 7269 6768 7420 6167 a copyright ag │ │ │ │ │ -00003d50: 7265 656d 656e 7420 746f 2046 5346 2e20 reement to FSF. │ │ │ │ │ -00003d60: 506c 6561 7365 206b 6565 7020 696e 206d Please keep in m │ │ │ │ │ -00003d70: 696e 6420 7468 6174 2069 6620 796f 7520 ind that if you │ │ │ │ │ -00003d80: 6172 650a 2020 2020 2061 736b 6564 2074 are. asked t │ │ │ │ │ -00003d90: 6f20 7375 626d 6974 2066 6f72 2063 6f70 o submit for cop │ │ │ │ │ -00003da0: 7972 6967 6874 2061 6772 6565 6d65 6e74 yright agreement │ │ │ │ │ -00003db0: 2c20 7072 6f63 6573 7320 6361 6e20 7461 , process can ta │ │ │ │ │ -00003dc0: 6b65 2073 6f6d 6520 7469 6d65 0a20 2020 ke some time. │ │ │ │ │ -00003dd0: 2020 616e 6420 6973 206d 616e 6461 746f and is mandato │ │ │ │ │ -00003de0: 7279 2069 6e20 6f72 6465 7220 746f 2067 ry in order to g │ │ │ │ │ -00003df0: 6574 2079 6f75 7220 6368 616e 6765 7320 et your changes │ │ │ │ │ -00003e00: 696e 7465 6772 6174 6564 2e0a 0a20 2020 integrated... │ │ │ │ │ -00003e10: 2020 4966 2079 6f75 2061 7265 206e 6f74 If you are not │ │ │ │ │ -00003e20: 206f 6e20 6772 7562 2d64 6576 656c 2074 on grub-devel t │ │ │ │ │ -00003e30: 6f20 7265 7370 6f6e 6420 746f 2071 7565 o respond to que │ │ │ │ │ -00003e40: 7374 696f 6e73 2c20 6d6f 7374 206c 696b stions, most lik │ │ │ │ │ -00003e50: 656c 790a 2020 2020 2079 6f75 7220 7061 ely. your pa │ │ │ │ │ -00003e60: 7463 6820 7769 6c6c 206e 6f74 2062 6520 tch will not be │ │ │ │ │ -00003e70: 6163 6365 7074 6564 2e20 2041 6c73 6f20 accepted. Also │ │ │ │ │ -00003e80: 6966 2070 726f 626c 656d 7320 6172 6973 if problems aris │ │ │ │ │ -00003e90: 6520 6672 6f6d 2079 6f75 720a 2020 2020 e from your. │ │ │ │ │ -00003ea0: 2063 6861 6e67 6573 206c 6174 6572 206f changes later o │ │ │ │ │ -00003eb0: 6e2c 2069 7420 776f 756c 6420 6265 2070 n, it would be p │ │ │ │ │ -00003ec0: 7265 6665 7261 626c 6520 7468 6174 2079 referable that y │ │ │ │ │ -00003ed0: 6f75 2061 6c73 6f20 6669 7820 7468 650a ou also fix the. │ │ │ │ │ -00003ee0: 2020 2020 2070 726f 626c 656d 2e20 2053 problem. S │ │ │ │ │ -00003ef0: 6f20 7374 6179 2061 726f 756e 6420 666f o stay around fo │ │ │ │ │ -00003f00: 7220 6120 7768 696c 652e 0a0a 2020 202a r a while... * │ │ │ │ │ -00003f10: 2059 6f75 7220 7061 7463 6820 6973 2061 Your patch is a │ │ │ │ │ -00003f20: 6363 6570 7465 642e 0a0a 2020 2020 2047 ccepted... G │ │ │ │ │ -00003f30: 6f6f 6420 6a6f 6221 2020 596f 7572 2070 ood job! Your p │ │ │ │ │ -00003f40: 6174 6368 2077 696c 6c20 6e6f 7720 6265 atch will now be │ │ │ │ │ -00003f50: 2069 6e74 6567 7261 7465 6420 696e 746f integrated into │ │ │ │ │ -00003f60: 2047 5255 4220 3220 6d61 696e 6c69 6e65 GRUB 2 mainline │ │ │ │ │ -00003f70: 2c0a 2020 2020 2061 6e64 2069 6620 6974 ,. and if it │ │ │ │ │ -00003f80: 2064 6964 6e27 7420 6272 6561 6b20 616e didn't break an │ │ │ │ │ -00003f90: 7974 6869 6e67 2069 7420 7769 6c6c 2062 ything it will b │ │ │ │ │ -00003fa0: 6520 7075 626c 6963 6c79 2061 7661 696c e publicly avail │ │ │ │ │ -00003fb0: 6162 6c65 2069 6e0a 2020 2020 2074 6865 able in. the │ │ │ │ │ -00003fc0: 206e 6578 7420 7265 6c65 6173 652e 0a0a next release... │ │ │ │ │ -00003fd0: 2020 2020 204e 6f77 2079 6f75 2061 7265 Now you are │ │ │ │ │ -00003fe0: 2077 656c 636f 6d65 2074 6f20 646f 2066 welcome to do f │ │ │ │ │ -00003ff0: 7572 7468 6572 2069 6d70 726f 7665 6d65 urther improveme │ │ │ │ │ -00004000: 6e74 7320 3a29 0a0a 1f0a 4669 6c65 3a20 nts :)....File: │ │ │ │ │ -00004010: 6772 7562 2d64 6576 2e69 6e66 6f2c 2020 grub-dev.info, │ │ │ │ │ -00004020: 4e6f 6465 3a20 5479 7069 6361 6c20 4465 Node: Typical De │ │ │ │ │ -00004030: 7665 6c6f 7065 7220 4578 7065 7269 656e veloper Experien │ │ │ │ │ -00004040: 6365 2c20 204e 6578 743a 2057 6865 6e20 ce, Next: When │ │ │ │ │ -00004050: 796f 7520 6172 6520 6170 7072 6f76 6564 you are approved │ │ │ │ │ -00004060: 2066 6f72 2077 7269 7465 2061 6363 6573 for write acces │ │ │ │ │ -00004070: 7320 746f 2070 726f 6a65 6374 2773 2066 s to project's f │ │ │ │ │ -00004080: 696c 6573 2c20 2050 7265 763a 2047 6574 iles, Prev: Get │ │ │ │ │ -00004090: 7469 6e67 2073 7461 7274 6564 2c20 2055 ting started, U │ │ │ │ │ -000040a0: 703a 2043 6f6e 7472 6962 7574 696e 6720 p: Contributing │ │ │ │ │ -000040b0: 4368 616e 6765 730a 0a34 2e32 2054 7970 Changes..4.2 Typ │ │ │ │ │ -000040c0: 6963 616c 2044 6576 656c 6f70 6572 2045 ical Developer E │ │ │ │ │ -000040d0: 7870 6572 6965 6e63 650a 3d3d 3d3d 3d3d xperience.====== │ │ │ │ │ +00001f90: 2a2a 2a0a 0a48 6572 6520 6973 2061 2062 ***..Here is a b │ │ │ │ │ +00001fa0: 7269 6566 206d 6170 206f 6620 7468 6520 rief map of the │ │ │ │ │ +00001fb0: 4752 5542 2063 6f64 6520 6261 7365 2e0a GRUB code base.. │ │ │ │ │ +00001fc0: 0a20 2020 4752 5542 2075 7365 7320 4175 . GRUB uses Au │ │ │ │ │ +00001fd0: 746f 636f 6e66 2061 6e64 2041 7574 6f6d toconf and Autom │ │ │ │ │ +00001fe0: 616b 652c 2077 6974 6820 6d6f 7374 206f ake, with most o │ │ │ │ │ +00001ff0: 6620 7468 6520 4175 746f 6d61 6b65 2069 f the Automake i │ │ │ │ │ +00002000: 6e70 7574 0a67 656e 6572 6174 6564 2062 nput.generated b │ │ │ │ │ +00002010: 7920 6120 5079 7468 6f6e 2073 6372 6970 y a Python scrip │ │ │ │ │ +00002020: 742e 2020 5468 6520 746f 702d 6c65 7665 t. The top-leve │ │ │ │ │ +00002030: 6c20 6275 696c 6420 7275 6c65 7320 6172 l build rules ar │ │ │ │ │ +00002040: 6520 696e 0a27 636f 6e66 6967 7572 652e e in.'configure. │ │ │ │ │ +00002050: 6163 272c 2027 6772 7562 2d63 6f72 652f ac', 'grub-core/ │ │ │ │ │ +00002060: 4d61 6b65 6669 6c65 2e63 6f72 652e 6465 Makefile.core.de │ │ │ │ │ +00002070: 6627 2c20 616e 6420 274d 616b 6566 696c f', and 'Makefil │ │ │ │ │ +00002080: 652e 7574 696c 2e64 6566 272e 0a45 6163 e.util.def'..Eac │ │ │ │ │ +00002090: 6820 626c 6f63 6b20 696e 2061 2027 2a2e h block in a '*. │ │ │ │ │ +000020a0: 6465 6627 2066 696c 6520 7265 7072 6573 def' file repres │ │ │ │ │ +000020b0: 656e 7473 2061 2062 7569 6c64 2074 6172 ents a build tar │ │ │ │ │ +000020c0: 6765 742c 2061 6e64 2073 7065 6369 6669 get, and specifi │ │ │ │ │ +000020d0: 6573 0a74 6865 2073 6f75 7263 6520 6669 es.the source fi │ │ │ │ │ +000020e0: 6c65 7320 7573 6564 2074 6f20 6275 696c les used to buil │ │ │ │ │ +000020f0: 6420 6974 206f 6e20 7661 7269 6f75 7320 d it on various │ │ │ │ │ +00002100: 706c 6174 666f 726d 732e 2020 5468 6520 platforms. The │ │ │ │ │ +00002110: 272a 2e64 6566 270a 6669 6c65 7320 6172 '*.def'.files ar │ │ │ │ │ +00002120: 6520 7072 6f63 6573 7365 6420 696e 746f e processed into │ │ │ │ │ +00002130: 2041 7574 6f6d 616b 6520 696e 7075 7420 Automake input │ │ │ │ │ +00002140: 6279 2027 6765 6e74 706c 2e70 7927 2028 by 'gentpl.py' ( │ │ │ │ │ +00002150: 7768 6963 6820 796f 7520 6f6e 6c79 0a6e which you only.n │ │ │ │ │ +00002160: 6565 6420 746f 206c 6f6f 6b20 6174 2069 eed to look at i │ │ │ │ │ +00002170: 6620 796f 7520 6172 6520 6578 7465 6e64 f you are extend │ │ │ │ │ +00002180: 696e 6720 7468 6520 6275 696c 6420 7379 ing the build sy │ │ │ │ │ +00002190: 7374 656d 292e 2020 4966 2079 6f75 2061 stem). If you a │ │ │ │ │ +000021a0: 7265 0a61 6464 696e 6720 6120 6e65 7720 re.adding a new │ │ │ │ │ +000021b0: 6d6f 6475 6c65 2077 6869 6368 2066 6f6c module which fol │ │ │ │ │ +000021c0: 6c6f 7773 2061 6e20 6578 6973 7469 6e67 lows an existing │ │ │ │ │ +000021d0: 2070 6174 7465 726e 2c20 7375 6368 2061 pattern, such a │ │ │ │ │ +000021e0: 7320 6120 6e65 770a 636f 6d6d 616e 6420 s a new.command │ │ │ │ │ +000021f0: 6f72 2061 206e 6577 2066 696c 6573 7973 or a new filesys │ │ │ │ │ +00002200: 7465 6d20 696d 706c 656d 656e 7461 7469 tem implementati │ │ │ │ │ +00002210: 6f6e 2c20 6974 2069 7320 7573 7561 6c6c on, it is usuall │ │ │ │ │ +00002220: 7920 6561 7369 6573 7420 746f 0a67 7265 y easiest to.gre │ │ │ │ │ +00002230: 7020 2767 7275 622d 636f 7265 2f4d 616b p 'grub-core/Mak │ │ │ │ │ +00002240: 6566 696c 652e 636f 7265 2e64 6566 2720 efile.core.def' │ │ │ │ │ +00002250: 616e 6420 274d 616b 6566 696c 652e 7574 and 'Makefile.ut │ │ │ │ │ +00002260: 696c 2e64 6566 2720 666f 7220 616e 0a65 il.def' for an.e │ │ │ │ │ +00002270: 7869 7374 696e 6720 6578 616d 706c 6520 xisting example │ │ │ │ │ +00002280: 6f66 2074 6861 7420 7061 7474 6572 6e20 of that pattern │ │ │ │ │ +00002290: 746f 2066 696e 6420 6f75 7420 7768 6572 to find out wher │ │ │ │ │ +000022a0: 6520 6974 2073 686f 756c 6420 6265 2061 e it should be a │ │ │ │ │ +000022b0: 6464 6564 2e0a 0a20 2020 496e 2067 656e dded... In gen │ │ │ │ │ +000022c0: 6572 616c 2c20 636f 6465 2074 6861 7420 eral, code that │ │ │ │ │ +000022d0: 6d61 7920 6265 2072 756e 2061 7420 626f may be run at bo │ │ │ │ │ +000022e0: 6f74 2074 696d 6520 6973 2069 6e20 6120 ot time is in a │ │ │ │ │ +000022f0: 7375 6264 6972 6563 746f 7279 206f 660a subdirectory of. │ │ │ │ │ +00002300: 2767 7275 622d 636f 7265 272c 2077 6869 'grub-core', whi │ │ │ │ │ +00002310: 6c65 2063 6f64 6520 7468 6174 2069 7320 le code that is │ │ │ │ │ +00002320: 6f6e 6c79 2072 756e 2066 726f 6d20 7769 only run from wi │ │ │ │ │ +00002330: 7468 696e 2061 2066 756c 6c20 6f70 6572 thin a full oper │ │ │ │ │ +00002340: 6174 696e 670a 7379 7374 656d 2069 7320 ating.system is │ │ │ │ │ +00002350: 696e 2061 2073 7562 6469 7265 6374 6f72 in a subdirector │ │ │ │ │ +00002360: 7920 6f66 2074 6865 2074 6f70 206c 6576 y of the top lev │ │ │ │ │ +00002370: 656c 2e0a 0a20 2020 4c6f 772d 6c65 7665 el... Low-leve │ │ │ │ │ +00002380: 6c20 626f 6f74 2063 6f64 652c 2073 7563 l boot code, suc │ │ │ │ │ +00002390: 6820 6173 2074 6865 204d 4252 2069 6d70 h as the MBR imp │ │ │ │ │ +000023a0: 6c65 6d65 6e74 6174 696f 6e20 6f6e 2050 lementation on P │ │ │ │ │ +000023b0: 4320 4249 4f53 0a73 7973 7465 6d73 2c20 C BIOS.systems, │ │ │ │ │ +000023c0: 6973 2069 6e20 7468 6520 2767 7275 622d is in the 'grub- │ │ │ │ │ +000023d0: 636f 7265 2f62 6f6f 742f 2720 6469 7265 core/boot/' dire │ │ │ │ │ +000023e0: 6374 6f72 792e 0a0a 2020 2054 6865 2047 ctory... The G │ │ │ │ │ +000023f0: 5255 4220 6b65 726e 656c 2069 7320 696e RUB kernel is in │ │ │ │ │ +00002400: 2027 6772 7562 2d63 6f72 652f 6b65 726e 'grub-core/kern │ │ │ │ │ +00002410: 2f27 2e20 2054 6869 7320 636f 6e74 6169 /'. This contai │ │ │ │ │ +00002420: 6e73 2063 6f72 650a 6661 6369 6c69 7469 ns core.faciliti │ │ │ │ │ +00002430: 6573 2073 7563 6820 6173 2074 6865 2064 es such as the d │ │ │ │ │ +00002440: 6576 6963 652c 2064 6973 6b2c 2061 6e64 evice, disk, and │ │ │ │ │ +00002450: 2066 696c 6520 6672 616d 6577 6f72 6b73 file frameworks │ │ │ │ │ +00002460: 2c20 656e 7669 726f 6e6d 656e 740a 7661 , environment.va │ │ │ │ │ +00002470: 7269 6162 6c65 2068 616e 646c 696e 672c riable handling, │ │ │ │ │ +00002480: 206c 6973 7420 7072 6f63 6573 7369 6e67 list processing │ │ │ │ │ +00002490: 2c20 616e 6420 736f 206f 6e2e 2020 5468 , and so on. Th │ │ │ │ │ +000024a0: 6520 6b65 726e 656c 2073 686f 756c 640a e kernel should. │ │ │ │ │ +000024b0: 636f 6e74 6169 6e20 656e 6f75 6768 2074 contain enough t │ │ │ │ │ +000024c0: 6f20 6765 7420 7570 2074 6f20 6120 7265 o get up to a re │ │ │ │ │ +000024d0: 7363 7565 2070 726f 6d70 742e 2020 4865 scue prompt. He │ │ │ │ │ +000024e0: 6164 6572 2066 696c 6573 2066 6f72 206b ader files for k │ │ │ │ │ +000024f0: 6572 6e65 6c0a 6661 6369 6c69 7469 6573 ernel.facilities │ │ │ │ │ +00002500: 2c20 616d 6f6e 6720 6f74 6865 7273 2c20 , among others, │ │ │ │ │ +00002510: 6172 6520 696e 2027 696e 636c 7564 652f are in 'include/ │ │ │ │ │ +00002520: 272e 0a0a 2020 2054 6572 6d69 6e61 6c20 '... Terminal │ │ │ │ │ +00002530: 696d 706c 656d 656e 7461 7469 6f6e 7320 implementations │ │ │ │ │ +00002540: 6172 6520 696e 2027 6772 7562 2d63 6f72 are in 'grub-cor │ │ │ │ │ +00002550: 652f 7465 726d 2f27 2e0a 0a20 2020 4469 e/term/'... Di │ │ │ │ │ +00002560: 736b 2061 6363 6573 7320 636f 6465 2069 sk access code i │ │ │ │ │ +00002570: 7320 7370 7265 6164 2061 6372 6f73 7320 s spread across │ │ │ │ │ +00002580: 2767 7275 622d 636f 7265 2f64 6973 6b2f 'grub-core/disk/ │ │ │ │ │ +00002590: 2720 2866 6f72 2061 6363 6573 7369 6e67 ' (for accessing │ │ │ │ │ +000025a0: 0a74 6865 2064 6973 6b20 6465 7669 6365 .the disk device │ │ │ │ │ +000025b0: 7320 7468 656d 7365 6c76 6573 292c 2027 s themselves), ' │ │ │ │ │ +000025c0: 6772 7562 2d63 6f72 652f 7061 7274 6d61 grub-core/partma │ │ │ │ │ +000025d0: 702f 2720 2866 6f72 2069 6e74 6572 7072 p/' (for interpr │ │ │ │ │ +000025e0: 6574 696e 670a 7061 7274 6974 696f 6e20 eting.partition │ │ │ │ │ +000025f0: 7461 626c 6520 6461 7461 292c 2061 6e64 table data), and │ │ │ │ │ +00002600: 2027 6772 7562 2d63 6f72 652f 6673 2f27 'grub-core/fs/' │ │ │ │ │ +00002610: 2028 666f 7220 6163 6365 7373 696e 6720 (for accessing │ │ │ │ │ +00002620: 6669 6c65 7379 7374 656d 7329 2e0a 4e6f filesystems)..No │ │ │ │ │ +00002630: 7465 2074 6861 742c 2077 6974 6820 7468 te that, with th │ │ │ │ │ +00002640: 6520 6f64 6420 7370 6563 6961 6c69 7365 e odd specialise │ │ │ │ │ +00002650: 6420 6578 6365 7074 696f 6e2c 2047 5255 d exception, GRU │ │ │ │ │ +00002660: 4220 6f6e 6c79 2063 6f6e 7461 696e 7320 B only contains │ │ │ │ │ +00002670: 636f 6465 0a74 6f20 5f72 6561 645f 2066 code.to _read_ f │ │ │ │ │ +00002680: 726f 6d20 6669 6c65 7379 7374 656d 7320 rom filesystems │ │ │ │ │ +00002690: 616e 6420 7472 6965 7320 746f 2061 766f and tries to avo │ │ │ │ │ +000026a0: 6964 2063 6f6e 7461 696e 696e 6720 616e id containing an │ │ │ │ │ +000026b0: 7920 636f 6465 2074 6f0a 5f77 7269 7465 y code to._write │ │ │ │ │ +000026c0: 5f20 746f 2066 696c 6573 7973 7465 6d73 _ to filesystems │ │ │ │ │ +000026d0: 3b20 7468 6973 206c 6574 7320 7573 2063 ; this lets us c │ │ │ │ │ +000026e0: 6f6e 6669 6465 6e74 6c79 2061 7373 7572 onfidently assur │ │ │ │ │ +000026f0: 6520 7573 6572 7320 7468 6174 2047 5255 e users that GRU │ │ │ │ │ +00002700: 420a 6361 6e6e 6f74 2062 6520 7265 7370 B.cannot be resp │ │ │ │ │ +00002710: 6f6e 7369 626c 6520 666f 7220 6669 6c65 onsible for file │ │ │ │ │ +00002720: 7379 7374 656d 2063 6f72 7275 7074 696f system corruptio │ │ │ │ │ +00002730: 6e2e 0a0a 2020 2050 4349 2061 6e64 2055 n... PCI and U │ │ │ │ │ +00002740: 5342 2062 7573 2068 616e 646c 696e 6720 SB bus handling │ │ │ │ │ +00002750: 6973 2069 6e20 2767 7275 622d 636f 7265 is in 'grub-core │ │ │ │ │ +00002760: 2f62 7573 2f27 2e0a 0a20 2020 5669 6465 /bus/'... Vide │ │ │ │ │ +00002770: 6f20 6861 6e64 6c69 6e67 2063 6f64 6520 o handling code │ │ │ │ │ +00002780: 6973 2069 6e20 2767 7275 622d 636f 7265 is in 'grub-core │ │ │ │ │ +00002790: 2f76 6964 656f 2f27 2e20 2054 6865 2067 /video/'. The g │ │ │ │ │ +000027a0: 7261 7068 6963 616c 206d 656e 750a 7379 raphical menu.sy │ │ │ │ │ +000027b0: 7374 656d 2075 7365 7320 7468 6973 2068 stem uses this h │ │ │ │ │ +000027c0: 6561 7669 6c79 2c20 6275 7420 6973 2069 eavily, but is i │ │ │ │ │ +000027d0: 6e20 6120 7365 7061 7261 7465 2064 6972 n a separate dir │ │ │ │ │ +000027e0: 6563 746f 7279 2c0a 2767 7275 622d 636f ectory,.'grub-co │ │ │ │ │ +000027f0: 7265 2f67 6678 6d65 6e75 2f27 2e0a 0a20 re/gfxmenu/'... │ │ │ │ │ +00002800: 2020 4d6f 7374 2063 6f6d 6d61 6e64 7320 Most commands │ │ │ │ │ +00002810: 6172 6520 696d 706c 656d 656e 7465 6420 are implemented │ │ │ │ │ +00002820: 6279 2066 696c 6573 2069 6e20 2767 7275 by files in 'gru │ │ │ │ │ +00002830: 622d 636f 7265 2f63 6f6d 6d61 6e64 732f b-core/commands/ │ │ │ │ │ +00002840: 272c 2077 6974 680a 7468 6520 666f 6c6c ', with.the foll │ │ │ │ │ +00002850: 6f77 696e 6720 6578 6365 7074 696f 6e73 owing exceptions │ │ │ │ │ +00002860: 3a0a 0a20 2020 2a20 4120 6665 7720 636f :.. * A few co │ │ │ │ │ +00002870: 7265 2063 6f6d 6d61 6e64 7320 6c69 7665 re commands live │ │ │ │ │ +00002880: 2069 6e20 2767 7275 622d 636f 7265 2f6b in 'grub-core/k │ │ │ │ │ +00002890: 6572 6e2f 636f 7265 636d 642e 6327 2e0a ern/corecmd.c'.. │ │ │ │ │ +000028a0: 0a20 2020 2a20 436f 6d6d 616e 6473 2072 . * Commands r │ │ │ │ │ +000028b0: 656c 6174 6564 2074 6f20 6e6f 726d 616c elated to normal │ │ │ │ │ +000028c0: 206d 6f64 6520 6c69 7665 2075 6e64 6572 mode live under │ │ │ │ │ +000028d0: 2027 6772 7562 2d63 6f72 652f 6e6f 726d 'grub-core/norm │ │ │ │ │ +000028e0: 616c 2f27 2e0a 0a20 2020 2a20 436f 6d6d al/'... * Comm │ │ │ │ │ +000028f0: 616e 6473 2074 6861 7420 6c6f 6164 2061 ands that load a │ │ │ │ │ +00002900: 6e64 2062 6f6f 7420 6b65 726e 656c 7320 nd boot kernels │ │ │ │ │ +00002910: 6c69 7665 2075 6e64 6572 2027 6772 7562 live under 'grub │ │ │ │ │ +00002920: 2d63 6f72 652f 6c6f 6164 6572 2f27 2e0a -core/loader/'.. │ │ │ │ │ +00002930: 0a20 2020 2a20 5468 6520 276c 6f6f 7062 . * The 'loopb │ │ │ │ │ +00002940: 6163 6b27 2063 6f6d 6d61 6e64 2069 7320 ack' command is │ │ │ │ │ +00002950: 7265 616c 6c79 2061 2064 6973 6b20 6465 really a disk de │ │ │ │ │ +00002960: 7669 6365 2c20 616e 6420 736f 206c 6976 vice, and so liv │ │ │ │ │ +00002970: 6573 2069 6e0a 2020 2020 2027 6772 7562 es in. 'grub │ │ │ │ │ +00002980: 2d63 6f72 652f 6469 736b 2f6c 6f6f 7062 -core/disk/loopb │ │ │ │ │ +00002990: 6163 6b2e 6327 2e0a 0a20 2020 2a20 5468 ack.c'... * Th │ │ │ │ │ +000029a0: 6520 2767 6574 7465 7874 2720 636f 6d6d e 'gettext' comm │ │ │ │ │ +000029b0: 616e 6420 6c69 7665 7320 756e 6465 7220 and lives under │ │ │ │ │ +000029c0: 2767 7275 622d 636f 7265 2f67 6574 7465 'grub-core/gette │ │ │ │ │ +000029d0: 7874 2f27 2e0a 0a20 2020 2a20 5468 6520 xt/'... * The │ │ │ │ │ +000029e0: 276c 6f61 6466 6f6e 7427 2061 6e64 2027 'loadfont' and ' │ │ │ │ │ +000029f0: 6c73 666f 6e74 7327 2063 6f6d 6d61 6e64 lsfonts' command │ │ │ │ │ +00002a00: 7320 6c69 7665 2075 6e64 6572 2027 6772 s live under 'gr │ │ │ │ │ +00002a10: 7562 2d63 6f72 652f 666f 6e74 2f27 2e0a ub-core/font/'.. │ │ │ │ │ +00002a20: 0a20 2020 2a20 5468 6520 2773 6572 6961 . * The 'seria │ │ │ │ │ +00002a30: 6c27 2c20 2774 6572 6d69 6e66 6f27 2c20 l', 'terminfo', │ │ │ │ │ +00002a40: 616e 6420 2762 6163 6b67 726f 756e 645f and 'background_ │ │ │ │ │ +00002a50: 696d 6167 6527 2063 6f6d 6d61 6e64 7320 image' commands │ │ │ │ │ +00002a60: 6c69 7665 0a20 2020 2020 756e 6465 7220 live. under │ │ │ │ │ +00002a70: 2767 7275 622d 636f 7265 2f74 6572 6d2f 'grub-core/term/ │ │ │ │ │ +00002a80: 272e 0a0a 2020 202a 2054 6865 2027 6566 '... * The 'ef │ │ │ │ │ +00002a90: 6965 6d75 5f2a 2720 636f 6d6d 616e 6473 iemu_*' commands │ │ │ │ │ +00002aa0: 206c 6976 6520 756e 6465 7220 2767 7275 live under 'gru │ │ │ │ │ +00002ab0: 622d 636f 7265 2f65 6669 656d 752f 272e b-core/efiemu/'. │ │ │ │ │ +00002ac0: 0a0a 2020 202a 204f 532d 6465 7065 6e64 .. * OS-depend │ │ │ │ │ +00002ad0: 656e 7420 636f 6465 2073 686f 756c 6420 ent code should │ │ │ │ │ +00002ae0: 6265 2075 6e64 6572 2027 6772 7562 2d63 be under 'grub-c │ │ │ │ │ +00002af0: 6f72 652f 6f73 6465 702f 270a 0a20 2020 ore/osdep/'.. │ │ │ │ │ +00002b00: 2a20 5574 696c 6974 7920 7072 6f67 7261 * Utility progra │ │ │ │ │ +00002b10: 6d73 206d 6561 6e74 2074 6f20 6265 2072 ms meant to be r │ │ │ │ │ +00002b20: 756e 2066 726f 6d20 6120 6675 6c6c 206f un from a full o │ │ │ │ │ +00002b30: 7065 7261 7469 6e67 2073 7973 7465 6d0a perating system. │ │ │ │ │ +00002b40: 2020 2020 2028 6578 6365 7074 204f 532d (except OS- │ │ │ │ │ +00002b50: 6465 7065 6e64 656e 7420 636f 6465 206d dependent code m │ │ │ │ │ +00002b60: 656e 7469 6f6e 6564 2070 7265 7669 6f75 entioned previou │ │ │ │ │ +00002b70: 736c 7929 2061 7265 2069 6e20 2775 7469 sly) are in 'uti │ │ │ │ │ +00002b80: 6c2f 272e 0a0a 2020 2054 6865 7265 2061 l/'... There a │ │ │ │ │ +00002b90: 7265 2061 2066 6577 206f 7468 6572 2073 re a few other s │ │ │ │ │ +00002ba0: 7065 6369 616c 2d70 7572 706f 7365 2065 pecial-purpose e │ │ │ │ │ +00002bb0: 7863 6570 7469 6f6e 733b 2067 7265 7020 xceptions; grep │ │ │ │ │ +00002bc0: 666f 7220 7468 656d 2069 660a 7468 6579 for them if.they │ │ │ │ │ +00002bd0: 206d 6174 7465 7220 746f 2079 6f75 2e0a matter to you.. │ │ │ │ │ +00002be0: 0a1f 0a46 696c 653a 2067 7275 622d 6465 ...File: grub-de │ │ │ │ │ +00002bf0: 762e 696e 666f 2c20 204e 6f64 653a 2043 v.info, Node: C │ │ │ │ │ +00002c00: 6f6e 7472 6962 7574 696e 6720 4368 616e ontributing Chan │ │ │ │ │ +00002c10: 6765 732c 2020 4e65 7874 3a20 5570 6461 ges, Next: Upda │ │ │ │ │ +00002c20: 7469 6e67 2045 7874 6572 6e61 6c20 436f ting External Co │ │ │ │ │ +00002c30: 6465 2c20 2050 7265 763a 2046 696e 6469 de, Prev: Findi │ │ │ │ │ +00002c40: 6e67 2079 6f75 7220 7761 7920 6172 6f75 ng your way arou │ │ │ │ │ +00002c50: 6e64 2c20 2055 703a 2054 6f70 0a0a 3420 nd, Up: Top..4 │ │ │ │ │ +00002c60: 436f 6e74 7269 6275 7469 6e67 2063 6861 Contributing cha │ │ │ │ │ +00002c70: 6e67 6573 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a nges.*********** │ │ │ │ │ +00002c80: 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a43 6f6e ***********..Con │ │ │ │ │ +00002c90: 7472 6962 7574 696e 6720 6368 616e 6765 tributing change │ │ │ │ │ +00002ca0: 7320 746f 2047 5255 4220 3220 6973 2077 s to GRUB 2 is w │ │ │ │ │ +00002cb0: 656c 636f 6d65 6420 6163 7469 7669 7479 elcomed activity │ │ │ │ │ +00002cc0: 2e20 2048 6f77 6576 6572 2077 6520 6861 . However we ha │ │ │ │ │ +00002cd0: 7665 2061 0a62 6974 206f 6620 636f 6e74 ve a.bit of cont │ │ │ │ │ +00002ce0: 726f 6c20 7768 6174 206b 696e 6420 6f66 rol what kind of │ │ │ │ │ +00002cf0: 2063 6861 6e67 6573 2077 696c 6c20 6265 changes will be │ │ │ │ │ +00002d00: 2061 6363 6570 7465 6420 746f 2047 5255 accepted to GRU │ │ │ │ │ +00002d10: 4220 322e 0a54 6865 7265 666f 7265 2069 B 2..Therefore i │ │ │ │ │ +00002d20: 7420 6973 2069 6d70 6f72 7461 6e74 2074 t is important t │ │ │ │ │ +00002d30: 6f20 6469 7363 7573 7320 796f 7572 2063 o discuss your c │ │ │ │ │ +00002d40: 6861 6e67 6573 206f 6e20 6772 7562 2d64 hanges on grub-d │ │ │ │ │ +00002d50: 6576 656c 206d 6169 6c69 6e67 0a6c 6973 evel mailing.lis │ │ │ │ │ +00002d60: 7420 2873 6565 204d 6169 6c69 6e67 4c69 t (see MailingLi │ │ │ │ │ +00002d70: 7374 7329 2e20 204f 6e20 7468 6973 2070 sts). On this p │ │ │ │ │ +00002d80: 6167 6520 7468 6572 6520 6172 6520 736f age there are so │ │ │ │ │ +00002d90: 6d65 2062 6173 6963 2064 6574 6169 6c73 me basic details │ │ │ │ │ +00002da0: 206f 6e0a 7468 6520 6465 7665 6c6f 706d on.the developm │ │ │ │ │ +00002db0: 656e 7420 7072 6f63 6573 7320 616e 6420 ent process and │ │ │ │ │ +00002dc0: 6163 7469 7669 7469 6573 2e0a 0a20 2020 activities... │ │ │ │ │ +00002dd0: 4669 7273 7420 6f66 2061 6c6c 2079 6f75 First of all you │ │ │ │ │ +00002de0: 2073 686f 756c 6420 636f 6d65 2075 7020 should come up │ │ │ │ │ +00002df0: 7769 7468 2074 6865 2069 6465 6120 796f with the idea yo │ │ │ │ │ +00002e00: 7572 7365 6c66 2077 6861 7420 796f 7520 urself what you │ │ │ │ │ +00002e10: 7761 6e74 0a74 6f20 636f 6e74 7269 6275 want.to contribu │ │ │ │ │ +00002e20: 7465 2e20 2049 6620 796f 7520 646f 206e te. If you do n │ │ │ │ │ +00002e30: 6f74 2068 6176 6520 7468 6174 2062 6566 ot have that bef │ │ │ │ │ +00002e40: 6f72 6568 616e 6420 796f 7520 6172 6520 orehand you are │ │ │ │ │ +00002e50: 6164 7669 7365 6420 746f 0a73 7475 6479 advised to.study │ │ │ │ │ +00002e60: 2074 6869 7320 6d61 6e75 616c 2061 6e64 this manual and │ │ │ │ │ +00002e70: 2074 7279 2047 5255 4220 3220 6f75 7420 try GRUB 2 out │ │ │ │ │ +00002e80: 746f 2073 6565 2077 6861 7420 796f 7520 to see what you │ │ │ │ │ +00002e90: 7468 696e 6b20 6973 206d 6973 7369 6e67 think is missing │ │ │ │ │ +00002ea0: 0a66 726f 6d20 7468 6572 652e 0a0a 2020 .from there... │ │ │ │ │ +00002eb0: 2048 6572 6520 6172 6520 6164 6469 7469 Here are additi │ │ │ │ │ +00002ec0: 6f6e 616c 2070 6f69 6e74 6572 733a 0a20 onal pointers:. │ │ │ │ │ +00002ed0: 2020 2a20 3c68 7474 7073 3a2f 2f73 6176 * . * .. If y │ │ │ │ │ +00002f60: 6f75 2069 6e74 656e 6465 6420 746f 206d ou intended to m │ │ │ │ │ +00002f70: 616b 6520 6368 616e 6765 7320 746f 2047 ake changes to G │ │ │ │ │ +00002f80: 5255 4220 4c65 6761 6379 2028 3c3d 302e RUB Legacy (<=0. │ │ │ │ │ +00002f90: 3937 2920 7468 6f73 6520 6172 6520 6e6f 97) those are no │ │ │ │ │ +00002fa0: 740a 6163 6365 7074 6564 2061 6e79 6d6f t.accepted anymo │ │ │ │ │ +00002fb0: 7265 2e0a 0a2a 204d 656e 753a 0a0a 2a20 re...* Menu:..* │ │ │ │ │ +00002fc0: 4765 7474 696e 6720 7374 6172 7465 643a Getting started: │ │ │ │ │ +00002fd0: 3a0a 2a20 5479 7069 6361 6c20 4465 7665 :.* Typical Deve │ │ │ │ │ +00002fe0: 6c6f 7065 7220 4578 7065 7269 656e 6365 loper Experience │ │ │ │ │ +00002ff0: 3a3a 0a2a 2057 6865 6e20 796f 7520 6172 ::.* When you ar │ │ │ │ │ +00003000: 6520 6170 7072 6f76 6564 2066 6f72 2077 e approved for w │ │ │ │ │ +00003010: 7269 7465 2061 6363 6573 7320 746f 2070 rite access to p │ │ │ │ │ +00003020: 726f 6a65 6374 2773 2066 696c 6573 3a3a roject's files:: │ │ │ │ │ +00003030: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2d64 ....File: grub-d │ │ │ │ │ +00003040: 6576 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ev.info, Node: │ │ │ │ │ +00003050: 4765 7474 696e 6720 7374 6172 7465 642c Getting started, │ │ │ │ │ +00003060: 2020 4e65 7874 3a20 5479 7069 6361 6c20 Next: Typical │ │ │ │ │ +00003070: 4465 7665 6c6f 7065 7220 4578 7065 7269 Developer Experi │ │ │ │ │ +00003080: 656e 6365 2c20 2055 703a 2043 6f6e 7472 ence, Up: Contr │ │ │ │ │ +00003090: 6962 7574 696e 6720 4368 616e 6765 730a ibuting Changes. │ │ │ │ │ +000030a0: 0a34 2e31 2047 6574 7469 6e67 2073 7461 .4.1 Getting sta │ │ │ │ │ +000030b0: 7274 6564 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d rted.=========== │ │ │ │ │ +000030c0: 3d3d 3d3d 3d3d 3d3d 0a0a 2020 202a 2041 ========.. * A │ │ │ │ │ +000030d0: 6c77 6179 7320 7573 6520 6c61 7465 7374 lways use latest │ │ │ │ │ +000030e0: 2047 5255 4220 3220 736f 7572 6365 2063 GRUB 2 source c │ │ │ │ │ +000030f0: 6f64 652e 2020 536f 2067 6574 2074 6861 ode. So get tha │ │ │ │ │ +00003100: 7420 6669 7273 742e 0a0a 2020 2020 2046 t first... F │ │ │ │ │ +00003110: 6f72 2064 6576 656c 6f70 6572 7320 6974 or developers it │ │ │ │ │ +00003120: 2069 7320 7265 636f 6d6d 656e 6465 6420 is recommended │ │ │ │ │ +00003130: 616c 7761 7973 2074 6f20 7573 6520 7468 always to use th │ │ │ │ │ +00003140: 6520 6e65 7765 7374 0a20 2020 2020 6465 e newest. de │ │ │ │ │ +00003150: 7665 6c6f 706d 656e 7420 7665 7273 696f velopment versio │ │ │ │ │ +00003160: 6e20 6f66 2047 5255 4220 322e 2020 4966 n of GRUB 2. If │ │ │ │ │ +00003170: 2064 6576 656c 6f70 6d65 6e74 2074 616b development tak │ │ │ │ │ +00003180: 6573 2061 206c 6f6e 6720 7065 7269 6f64 es a long period │ │ │ │ │ +00003190: 0a20 2020 2020 6f66 2074 696d 652c 2070 . of time, p │ │ │ │ │ +000031a0: 6c65 6173 6520 7265 6d65 6d62 6572 2074 lease remember t │ │ │ │ │ +000031b0: 6f20 6b65 6570 2069 6e20 7379 6e63 2077 o keep in sync w │ │ │ │ │ +000031c0: 6974 6820 6e65 7765 7374 2064 6576 656c ith newest devel │ │ │ │ │ +000031d0: 6f70 6d65 6e74 730a 2020 2020 2072 6567 opments. reg │ │ │ │ │ +000031e0: 756c 6172 6c79 2073 6f20 6974 2069 7320 ularly so it is │ │ │ │ │ +000031f0: 6d75 6368 2065 6173 6965 7220 746f 2069 much easier to i │ │ │ │ │ +00003200: 6e74 6567 7261 7465 2079 6f75 7220 6368 ntegrate your ch │ │ │ │ │ +00003210: 616e 6765 2069 6e20 7468 650a 2020 2020 ange in the. │ │ │ │ │ +00003220: 2066 7574 7572 652e 2020 4752 5542 2032 future. GRUB 2 │ │ │ │ │ +00003230: 2069 7320 6265 696e 6720 6465 7665 6c6f is being develo │ │ │ │ │ +00003240: 7065 6420 696e 2061 2047 4954 2072 6570 ped in a GIT rep │ │ │ │ │ +00003250: 6f73 6974 6f72 792e 0a0a 2020 2020 2050 ository... P │ │ │ │ │ +00003260: 6c65 6173 6520 6368 6563 6b20 5361 7661 lease check Sava │ │ │ │ │ +00003270: 6e6e 6168 2773 2047 5255 4220 7072 6f6a nnah's GRUB proj │ │ │ │ │ +00003280: 6563 7420 7061 6765 2066 6f72 2064 6574 ect page for det │ │ │ │ │ +00003290: 6169 6c73 2068 6f77 2074 6f20 6765 740a ails how to get. │ │ │ │ │ +000032a0: 2020 2020 206e 6577 6573 7420 6769 743a newest git: │ │ │ │ │ +000032b0: 2047 5255 4220 3220 6769 7420 5265 706f GRUB 2 git Repo │ │ │ │ │ +000032c0: 7369 746f 7279 0a20 2020 2020 2868 7474 sitory. (htt │ │ │ │ │ +000032d0: 7073 3a2f 2f73 6176 616e 6e61 682e 676e ps://savannah.gn │ │ │ │ │ +000032e0: 752e 6f72 672f 6769 742f 3f67 726f 7570 u.org/git/?group │ │ │ │ │ +000032f0: 3d67 7275 6229 0a0a 2020 202a 2043 6f6d =grub).. * Com │ │ │ │ │ +00003300: 7069 6c65 2069 7420 616e 6420 7472 7920 pile it and try │ │ │ │ │ +00003310: 6974 206f 7574 2e0a 0a20 2020 2020 4974 it out... It │ │ │ │ │ +00003320: 2069 7320 616c 7761 7973 2067 6f6f 6420 is always good │ │ │ │ │ +00003330: 6964 6561 2074 6f20 6669 7273 7420 7365 idea to first se │ │ │ │ │ +00003340: 6520 7468 6174 2074 6869 6e67 7320 776f e that things wo │ │ │ │ │ +00003350: 726b 2073 6f6d 6568 6f77 2061 6e64 0a20 rk somehow and. │ │ │ │ │ +00003360: 2020 2020 6166 7465 7220 7468 6174 2074 after that t │ │ │ │ │ +00003370: 6f20 7374 6172 7420 746f 2069 6d70 6c65 o start to imple │ │ │ │ │ +00003380: 6d65 6e74 206e 6577 2066 6561 7475 7265 ment new feature │ │ │ │ │ +00003390: 7320 6f72 2064 6576 656c 6f70 2066 6978 s or develop fix │ │ │ │ │ +000033a0: 6573 2074 6f0a 2020 2020 2062 7567 732e es to. bugs. │ │ │ │ │ +000033b0: 0a0a 2020 202a 2053 7475 6479 2074 6865 .. * Study the │ │ │ │ │ +000033c0: 2063 6f64 652e 0a0a 2020 2020 2054 6865 code... The │ │ │ │ │ +000033d0: 7265 2061 7265 2073 6f6d 6574 696d 6573 re are sometimes │ │ │ │ │ +000033e0: 206f 6464 2077 6179 7320 746f 2064 6f20 odd ways to do │ │ │ │ │ +000033f0: 7468 696e 6773 2069 6e20 4752 5542 2032 things in GRUB 2 │ │ │ │ │ +00003400: 2063 6f64 6520 6261 7365 2e0a 2020 2020 code base.. │ │ │ │ │ +00003410: 2054 6869 7320 6973 206d 6169 6e6c 7920 This is mainly │ │ │ │ │ +00003420: 7265 6c61 7465 6420 746f 206c 696d 6974 related to limit │ │ │ │ │ +00003430: 6564 2065 6e76 6972 6f6e 6d65 6e74 2077 ed environment w │ │ │ │ │ +00003440: 6865 7265 2047 5255 4220 3220 6973 2062 here GRUB 2 is b │ │ │ │ │ +00003450: 6569 6e67 0a20 2020 2020 6578 6563 7574 eing. execut │ │ │ │ │ +00003460: 6564 2e20 2059 6f75 2075 7375 616c 6c79 ed. You usually │ │ │ │ │ +00003470: 2064 6f20 6e6f 7420 6e65 6564 2074 6f20 do not need to │ │ │ │ │ +00003480: 756e 6465 7273 7461 6e64 2069 7420 616c understand it al │ │ │ │ │ +00003490: 6c20 736f 2069 7420 6973 0a20 2020 2020 l so it is. │ │ │ │ │ +000034a0: 6265 7474 6572 2074 6f20 6f6e 6c79 2074 better to only t │ │ │ │ │ +000034b0: 7279 2074 6f20 6c6f 6f6b 2061 7420 706c ry to look at pl │ │ │ │ │ +000034c0: 6163 6573 2074 6861 7420 7265 6c61 7465 aces that relate │ │ │ │ │ +000034d0: 7320 746f 2079 6f75 7220 776f 726b 2e0a s to your work.. │ │ │ │ │ +000034e0: 2020 2020 2050 6c65 6173 6520 646f 206e Please do n │ │ │ │ │ +000034f0: 6f74 2068 6573 6974 6174 6520 746f 2061 ot hesitate to a │ │ │ │ │ +00003500: 736b 2066 6f72 2068 656c 7020 6966 2074 sk for help if t │ │ │ │ │ +00003510: 6865 7265 2069 7320 736f 6d65 7468 696e here is somethin │ │ │ │ │ +00003520: 6720 7468 6174 0a20 2020 2020 796f 7520 g that. you │ │ │ │ │ +00003530: 646f 206e 6f74 2075 6e64 6572 7374 616e do not understan │ │ │ │ │ +00003540: 642e 0a0a 2020 202a 2044 6576 656c 6f70 d... * Develop │ │ │ │ │ +00003550: 2061 206e 6577 2066 6561 7475 7265 2e0a a new feature.. │ │ │ │ │ +00003560: 0a20 2020 2020 4e6f 7720 7468 6174 2079 . Now that y │ │ │ │ │ +00003570: 6f75 206b 6e6f 7720 7768 6174 2074 6f20 ou know what to │ │ │ │ │ +00003580: 646f 2061 6e64 2068 6f77 2069 7420 7368 do and how it sh │ │ │ │ │ +00003590: 6f75 6c64 2077 6f72 6b20 696e 2047 5255 ould work in GRU │ │ │ │ │ +000035a0: 4220 3220 636f 6465 0a20 2020 2020 6261 B 2 code. ba │ │ │ │ │ +000035b0: 7365 2c20 706c 6561 7365 2062 6520 6672 se, please be fr │ │ │ │ │ +000035c0: 6565 2074 6f20 6465 7665 6c6f 7020 6974 ee to develop it │ │ │ │ │ +000035d0: 2e20 2049 6620 796f 7520 6861 7665 206e . If you have n │ │ │ │ │ +000035e0: 6f74 2073 6f20 6661 720a 2020 2020 2061 ot so far. a │ │ │ │ │ +000035f0: 6e6e 6f75 6e63 6564 2079 6f75 7220 6964 nnounced your id │ │ │ │ │ +00003600: 6561 206f 6e20 6772 7562 2d64 6576 656c ea on grub-devel │ │ │ │ │ +00003610: 206d 6169 6c69 6e67 206c 6973 742c 2070 mailing list, p │ │ │ │ │ +00003620: 6c65 6173 6520 646f 2069 7420 6e6f 772e lease do it now. │ │ │ │ │ +00003630: 0a20 2020 2020 5468 6973 2069 7320 746f . This is to │ │ │ │ │ +00003640: 206d 616b 6520 7375 7265 2079 6f75 2061 make sure you a │ │ │ │ │ +00003650: 7265 206e 6f74 2077 6173 7469 6e67 2079 re not wasting y │ │ │ │ │ +00003660: 6f75 7220 7469 6d65 2077 6f72 6b69 6e67 our time working │ │ │ │ │ +00003670: 206f 6e20 7468 650a 2020 2020 2073 6f6c on the. sol │ │ │ │ │ +00003680: 7574 696f 6e20 7468 6174 2077 696c 6c20 ution that will │ │ │ │ │ +00003690: 6e6f 7420 6265 2069 6e74 6567 7261 7465 not be integrate │ │ │ │ │ +000036a0: 6420 746f 2047 5255 4220 3220 636f 6465 d to GRUB 2 code │ │ │ │ │ +000036b0: 2062 6173 652e 0a0a 2020 2020 2059 6f75 base... You │ │ │ │ │ +000036c0: 206d 6967 6874 2077 616e 7420 746f 2073 might want to s │ │ │ │ │ +000036d0: 7475 6479 206f 7572 2063 6f64 696e 6720 tudy our coding │ │ │ │ │ +000036e0: 7374 796c 6520 6265 666f 7265 2073 7461 style before sta │ │ │ │ │ +000036f0: 7274 696e 670a 2020 2020 2064 6576 656c rting. devel │ │ │ │ │ +00003700: 6f70 6d65 6e74 2073 6f20 796f 7520 646f opment so you do │ │ │ │ │ +00003710: 206e 6f74 206e 6565 6420 746f 2063 6861 not need to cha │ │ │ │ │ +00003720: 6e67 6520 6d75 6368 206f 6620 7468 6520 nge much of the │ │ │ │ │ +00003730: 636f 6465 2077 6865 6e20 796f 7572 0a20 code when your. │ │ │ │ │ +00003740: 2020 2020 7061 7463 6820 6973 2062 6569 patch is bei │ │ │ │ │ +00003750: 6e67 2072 6576 6965 7765 642e 2020 2873 ng reviewed. (s │ │ │ │ │ +00003760: 6565 202a 6e6f 7465 2043 6f64 696e 6720 ee *note Coding │ │ │ │ │ +00003770: 7374 796c 653a 3a29 0a0a 2020 2020 2046 style::).. F │ │ │ │ │ +00003780: 6f72 2065 7665 7279 2061 6363 6570 7465 or every accepte │ │ │ │ │ +00003790: 6420 7061 7463 6820 7468 6572 6520 6861 d patch there ha │ │ │ │ │ +000037a0: 7320 746f 2065 7869 7374 2061 2043 6861 s to exist a Cha │ │ │ │ │ +000037b0: 6e67 654c 6f67 2065 6e74 7279 2e20 204f ngeLog entry. O │ │ │ │ │ +000037c0: 7572 0a20 2020 2020 4368 616e 6765 4c6f ur. ChangeLo │ │ │ │ │ +000037d0: 6720 636f 6e73 6973 7420 6f66 2063 6861 g consist of cha │ │ │ │ │ +000037e0: 6e67 6573 2077 6974 6869 6e20 736f 7572 nges within sour │ │ │ │ │ +000037f0: 6365 2063 6f64 6520 616e 6420 6172 6520 ce code and are │ │ │ │ │ +00003800: 6e6f 740a 2020 2020 2064 6573 6372 6962 not. describ │ │ │ │ │ +00003810: 696e 6720 6162 6f75 7420 7768 6174 2074 ing about what t │ │ │ │ │ +00003820: 6865 2063 6861 6e67 6520 6c6f 6769 6361 he change logica │ │ │ │ │ +00003830: 6c6c 7920 646f 6573 2e20 2050 6c65 6173 lly does. Pleas │ │ │ │ │ +00003840: 6520 7365 650a 2020 2020 2065 7861 6d70 e see. examp │ │ │ │ │ +00003850: 6c65 7320 6672 6f6d 2070 7265 7669 6f75 les from previou │ │ │ │ │ +00003860: 7320 656e 7472 6965 732e 0a0a 2020 2020 s entries... │ │ │ │ │ +00003870: 2041 6c73 6f20 7265 6d65 6d62 6572 2074 Also remember t │ │ │ │ │ +00003880: 6861 7420 4752 5542 2032 2069 7320 6c69 hat GRUB 2 is li │ │ │ │ │ +00003890: 6365 6e73 6564 2075 6e64 6572 2047 504c censed under GPL │ │ │ │ │ +000038a0: 7633 206c 6963 656e 7365 2061 6e64 2074 v3 license and t │ │ │ │ │ +000038b0: 6861 740a 2020 2020 2075 7375 616c 6c79 hat. usually │ │ │ │ │ +000038c0: 206d 6561 6e73 2074 6861 7420 796f 7520 means that you │ │ │ │ │ +000038d0: 6172 6520 6e6f 7420 616c 6c6f 7765 6420 are not allowed │ │ │ │ │ +000038e0: 746f 2063 6f70 7920 7069 6563 6573 206f to copy pieces o │ │ │ │ │ +000038f0: 6620 636f 6465 2066 726f 6d0a 2020 2020 f code from. │ │ │ │ │ +00003900: 206f 7468 6572 2070 726f 6a65 6374 732e other projects. │ │ │ │ │ +00003910: 2020 4576 656e 2069 6620 7468 6520 736f Even if the so │ │ │ │ │ +00003920: 7572 6365 2070 726f 6a65 6374 2773 206c urce project's l │ │ │ │ │ +00003930: 6963 656e 7365 2077 6f75 6c64 2062 650a icense would be. │ │ │ │ │ +00003940: 2020 2020 2063 6f6d 7061 7469 626c 6520 compatible │ │ │ │ │ +00003950: 7769 7468 2047 504c 7633 2c20 706c 6561 with GPLv3, plea │ │ │ │ │ +00003960: 7365 2064 6973 6375 7373 2069 7420 6265 se discuss it be │ │ │ │ │ +00003970: 666f 7265 6861 6e64 206f 6e20 6772 7562 forehand on grub │ │ │ │ │ +00003980: 2d64 6576 656c 0a20 2020 2020 6d61 696c -devel. mail │ │ │ │ │ +00003990: 696e 6720 6c69 7374 2e0a 0a20 2020 2a20 ing list... * │ │ │ │ │ +000039a0: 5465 7374 2079 6f75 7220 6368 616e 6765 Test your change │ │ │ │ │ +000039b0: 2e0a 0a20 2020 2020 5465 7374 2074 6861 ... Test tha │ │ │ │ │ +000039c0: 7420 796f 7572 2063 6861 6e67 6520 776f t your change wo │ │ │ │ │ +000039d0: 726b 7320 7072 6f70 6572 6c79 2e20 2054 rks properly. T │ │ │ │ │ +000039e0: 7279 2069 7420 6f75 7420 6120 636f 7570 ry it out a coup │ │ │ │ │ +000039f0: 6c65 206f 660a 2020 2020 2074 696d 6573 le of. times │ │ │ │ │ +00003a00: 2c20 7072 6566 6572 6162 6c79 206f 6e20 , preferably on │ │ │ │ │ +00003a10: 6469 6666 6572 656e 7420 7379 7374 656d different system │ │ │ │ │ +00003a20: 732c 2061 6e64 2074 7279 2074 6f20 6669 s, and try to fi │ │ │ │ │ +00003a30: 6e64 2070 726f 626c 656d 730a 2020 2020 nd problems. │ │ │ │ │ +00003a40: 2077 6974 6820 6974 2e0a 0a20 2020 2a20 with it... * │ │ │ │ │ +00003a50: 5075 626c 6973 6820 796f 7572 2063 6861 Publish your cha │ │ │ │ │ +00003a60: 6e67 652e 0a0a 2020 2020 2057 6865 6e20 nge... When │ │ │ │ │ +00003a70: 796f 7520 6172 6520 6861 7070 7920 7769 you are happy wi │ │ │ │ │ +00003a80: 7468 2079 6f75 7220 6368 616e 6765 2c20 th your change, │ │ │ │ │ +00003a90: 6669 7273 7420 6d61 6b65 2073 7572 6520 first make sure │ │ │ │ │ +00003aa0: 6974 2069 730a 2020 2020 2063 6f6d 7069 it is. compi │ │ │ │ │ +00003ab0: 6c61 626c 6520 7769 7468 206c 6174 6573 lable with lates │ │ │ │ │ +00003ac0: 7420 6465 7665 6c6f 706d 656e 7420 7665 t development ve │ │ │ │ │ +00003ad0: 7273 696f 6e20 6f66 2047 5255 4220 322e rsion of GRUB 2. │ │ │ │ │ +00003ae0: 2020 4166 7465 7220 7468 6174 0a20 2020 After that. │ │ │ │ │ +00003af0: 2020 706c 6561 7365 2073 656e 6420 6120 please send a │ │ │ │ │ +00003b00: 7061 7463 6820 746f 2067 7275 622d 6465 patch to grub-de │ │ │ │ │ +00003b10: 7665 6c20 666f 7220 7265 7669 6577 2e20 vel for review. │ │ │ │ │ +00003b20: 2050 6c65 6173 6520 6465 7363 7269 6265 Please describe │ │ │ │ │ +00003b30: 2069 6e0a 2020 2020 2079 6f75 7220 656d in. your em │ │ │ │ │ +00003b40: 6169 6c20 7768 7920 796f 7520 6d61 6465 ail why you made │ │ │ │ │ +00003b50: 2074 6865 2063 6861 6e67 652c 2077 6861 the change, wha │ │ │ │ │ +00003b60: 7420 6974 2063 6861 6e67 6573 2061 6e64 t it changes and │ │ │ │ │ +00003b70: 2073 6f20 6f6e 2e0a 2020 2020 2050 6c65 so on.. Ple │ │ │ │ │ +00003b80: 6173 6520 6265 2070 7265 7061 7265 6420 ase be prepared │ │ │ │ │ +00003b90: 746f 2072 6563 6569 7665 2065 7665 6e20 to receive even │ │ │ │ │ +00003ba0: 6469 7363 6f75 7261 6769 6e67 2063 6f6d discouraging com │ │ │ │ │ +00003bb0: 6d65 6e74 7320 6162 6f75 7420 796f 7572 ments about your │ │ │ │ │ +00003bc0: 0a20 2020 2020 7061 7463 682e 2020 5468 . patch. Th │ │ │ │ │ +00003bd0: 6572 6520 6973 2075 7375 616c 6c79 2061 ere is usually a │ │ │ │ │ +00003be0: 7420 6c65 6173 7420 736f 6d65 7468 696e t least somethin │ │ │ │ │ +00003bf0: 6720 7468 6174 206e 6565 6473 2074 6f20 g that needs to │ │ │ │ │ +00003c00: 6265 0a20 2020 2020 696d 7072 6f76 6564 be. improved │ │ │ │ │ +00003c10: 2069 6e20 6576 6572 7920 7061 7463 682e in every patch. │ │ │ │ │ +00003c20: 0a0a 2020 2020 2050 6c65 6173 6520 7573 .. Please us │ │ │ │ │ +00003c30: 6520 756e 6966 6965 6420 6469 6666 2074 e unified diff t │ │ │ │ │ +00003c40: 6f20 6d61 6b65 2079 6f75 7220 7061 7463 o make your patc │ │ │ │ │ +00003c50: 6820 2867 6f6f 6420 6d61 7463 6820 6f66 h (good match of │ │ │ │ │ +00003c60: 2061 7267 756d 656e 7473 0a20 2020 2020 arguments. │ │ │ │ │ +00003c70: 666f 7220 6469 6666 2069 7320 272d 7072 for diff is '-pr │ │ │ │ │ +00003c80: 754e 2729 2e0a 0a20 2020 2a20 5265 7370 uN')... * Resp │ │ │ │ │ +00003c90: 6f6e 6420 746f 2072 6563 6569 7665 6420 ond to received │ │ │ │ │ +00003ca0: 6665 6564 6261 636b 2e0a 0a20 2020 2020 feedback... │ │ │ │ │ +00003cb0: 4966 2079 6f75 2061 7265 2061 736b 6564 If you are asked │ │ │ │ │ +00003cc0: 2074 6f20 6d6f 6469 6679 2079 6f75 7220 to modify your │ │ │ │ │ +00003cd0: 7061 7463 682c 2070 6c65 6173 6520 646f patch, please do │ │ │ │ │ +00003ce0: 2074 6861 7420 616e 6420 7265 7375 626d that and resubm │ │ │ │ │ +00003cf0: 6974 0a20 2020 2020 6974 2066 6f72 2072 it. it for r │ │ │ │ │ +00003d00: 6576 6965 772e 2020 4966 2079 6f75 7220 eview. If your │ │ │ │ │ +00003d10: 6368 616e 6765 2069 7320 6c61 7267 6520 change is large │ │ │ │ │ +00003d20: 796f 7520 6172 6520 7265 7175 6972 6564 you are required │ │ │ │ │ +00003d30: 2074 6f20 7375 626d 6974 0a20 2020 2020 to submit. │ │ │ │ │ +00003d40: 6120 636f 7079 7269 6768 7420 6167 7265 a copyright agre │ │ │ │ │ +00003d50: 656d 656e 7420 746f 2046 5346 2e20 506c ement to FSF. Pl │ │ │ │ │ +00003d60: 6561 7365 206b 6565 7020 696e 206d 696e ease keep in min │ │ │ │ │ +00003d70: 6420 7468 6174 2069 6620 796f 7520 6172 d that if you ar │ │ │ │ │ +00003d80: 650a 2020 2020 2061 736b 6564 2074 6f20 e. asked to │ │ │ │ │ +00003d90: 7375 626d 6974 2066 6f72 2063 6f70 7972 submit for copyr │ │ │ │ │ +00003da0: 6967 6874 2061 6772 6565 6d65 6e74 2c20 ight agreement, │ │ │ │ │ +00003db0: 7072 6f63 6573 7320 6361 6e20 7461 6b65 process can take │ │ │ │ │ +00003dc0: 2073 6f6d 6520 7469 6d65 0a20 2020 2020 some time. │ │ │ │ │ +00003dd0: 616e 6420 6973 206d 616e 6461 746f 7279 and is mandatory │ │ │ │ │ +00003de0: 2069 6e20 6f72 6465 7220 746f 2067 6574 in order to get │ │ │ │ │ +00003df0: 2079 6f75 7220 6368 616e 6765 7320 696e your changes in │ │ │ │ │ +00003e00: 7465 6772 6174 6564 2e0a 0a20 2020 2020 tegrated... │ │ │ │ │ +00003e10: 4966 2079 6f75 2061 7265 206e 6f74 206f If you are not o │ │ │ │ │ +00003e20: 6e20 6772 7562 2d64 6576 656c 2074 6f20 n grub-devel to │ │ │ │ │ +00003e30: 7265 7370 6f6e 6420 746f 2071 7565 7374 respond to quest │ │ │ │ │ +00003e40: 696f 6e73 2c20 6d6f 7374 206c 696b 656c ions, most likel │ │ │ │ │ +00003e50: 790a 2020 2020 2079 6f75 7220 7061 7463 y. your patc │ │ │ │ │ +00003e60: 6820 7769 6c6c 206e 6f74 2062 6520 6163 h will not be ac │ │ │ │ │ +00003e70: 6365 7074 6564 2e20 2041 6c73 6f20 6966 cepted. Also if │ │ │ │ │ +00003e80: 2070 726f 626c 656d 7320 6172 6973 6520 problems arise │ │ │ │ │ +00003e90: 6672 6f6d 2079 6f75 720a 2020 2020 2063 from your. c │ │ │ │ │ +00003ea0: 6861 6e67 6573 206c 6174 6572 206f 6e2c hanges later on, │ │ │ │ │ +00003eb0: 2069 7420 776f 756c 6420 6265 2070 7265 it would be pre │ │ │ │ │ +00003ec0: 6665 7261 626c 6520 7468 6174 2079 6f75 ferable that you │ │ │ │ │ +00003ed0: 2061 6c73 6f20 6669 7820 7468 650a 2020 also fix the. │ │ │ │ │ +00003ee0: 2020 2070 726f 626c 656d 2e20 2053 6f20 problem. So │ │ │ │ │ +00003ef0: 7374 6179 2061 726f 756e 6420 666f 7220 stay around for │ │ │ │ │ +00003f00: 6120 7768 696c 652e 0a0a 2020 202a 2059 a while... * Y │ │ │ │ │ +00003f10: 6f75 7220 7061 7463 6820 6973 2061 6363 our patch is acc │ │ │ │ │ +00003f20: 6570 7465 642e 0a0a 2020 2020 2047 6f6f epted... Goo │ │ │ │ │ +00003f30: 6420 6a6f 6221 2020 596f 7572 2070 6174 d job! Your pat │ │ │ │ │ +00003f40: 6368 2077 696c 6c20 6e6f 7720 6265 2069 ch will now be i │ │ │ │ │ +00003f50: 6e74 6567 7261 7465 6420 696e 746f 2047 ntegrated into G │ │ │ │ │ +00003f60: 5255 4220 3220 6d61 696e 6c69 6e65 2c0a RUB 2 mainline,. │ │ │ │ │ +00003f70: 2020 2020 2061 6e64 2069 6620 6974 2064 and if it d │ │ │ │ │ +00003f80: 6964 6e27 7420 6272 6561 6b20 616e 7974 idn't break anyt │ │ │ │ │ +00003f90: 6869 6e67 2069 7420 7769 6c6c 2062 6520 hing it will be │ │ │ │ │ +00003fa0: 7075 626c 6963 6c79 2061 7661 696c 6162 publicly availab │ │ │ │ │ +00003fb0: 6c65 2069 6e0a 2020 2020 2074 6865 206e le in. the n │ │ │ │ │ +00003fc0: 6578 7420 7265 6c65 6173 652e 0a0a 2020 ext release... │ │ │ │ │ +00003fd0: 2020 204e 6f77 2079 6f75 2061 7265 2077 Now you are w │ │ │ │ │ +00003fe0: 656c 636f 6d65 2074 6f20 646f 2066 7572 elcome to do fur │ │ │ │ │ +00003ff0: 7468 6572 2069 6d70 726f 7665 6d65 6e74 ther improvement │ │ │ │ │ +00004000: 7320 3a29 0a0a 1f0a 4669 6c65 3a20 6772 s :)....File: gr │ │ │ │ │ +00004010: 7562 2d64 6576 2e69 6e66 6f2c 2020 4e6f ub-dev.info, No │ │ │ │ │ +00004020: 6465 3a20 5479 7069 6361 6c20 4465 7665 de: Typical Deve │ │ │ │ │ +00004030: 6c6f 7065 7220 4578 7065 7269 656e 6365 loper Experience │ │ │ │ │ +00004040: 2c20 204e 6578 743a 2057 6865 6e20 796f , Next: When yo │ │ │ │ │ +00004050: 7520 6172 6520 6170 7072 6f76 6564 2066 u are approved f │ │ │ │ │ +00004060: 6f72 2077 7269 7465 2061 6363 6573 7320 or write access │ │ │ │ │ +00004070: 746f 2070 726f 6a65 6374 2773 2066 696c to project's fil │ │ │ │ │ +00004080: 6573 2c20 2050 7265 763a 2047 6574 7469 es, Prev: Getti │ │ │ │ │ +00004090: 6e67 2073 7461 7274 6564 2c20 2055 703a ng started, Up: │ │ │ │ │ +000040a0: 2043 6f6e 7472 6962 7574 696e 6720 4368 Contributing Ch │ │ │ │ │ +000040b0: 616e 6765 730a 0a34 2e32 2054 7970 6963 anges..4.2 Typic │ │ │ │ │ +000040c0: 616c 2044 6576 656c 6f70 6572 2045 7870 al Developer Exp │ │ │ │ │ +000040d0: 6572 6965 6e63 650a 3d3d 3d3d 3d3d 3d3d erience.======== │ │ │ │ │ 000040e0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -000040f0: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 5468 6520 ==========..The │ │ │ │ │ -00004100: 7479 7069 6361 6c20 6578 7065 7269 656e typical experien │ │ │ │ │ -00004110: 6365 2066 6f72 2061 2064 6576 656c 6f70 ce for a develop │ │ │ │ │ -00004120: 6572 2069 6e20 7468 6973 2070 726f 6a65 er in this proje │ │ │ │ │ -00004130: 6374 2069 7320 7468 6520 666f 6c6c 6f77 ct is the follow │ │ │ │ │ -00004140: 696e 673a 0a0a 2020 312e 2059 6f75 2066 ing:.. 1. You f │ │ │ │ │ -00004150: 696e 6420 796f 7572 7365 6c66 2077 616e ind yourself wan │ │ │ │ │ -00004160: 7469 6e67 2074 6f20 646f 2073 6f6d 6574 ting to do somet │ │ │ │ │ -00004170: 6869 6e67 2028 652e 672e 2020 6669 7869 hing (e.g. fixi │ │ │ │ │ -00004180: 6e67 2061 2062 7567 292e 0a20 2032 2e20 ng a bug).. 2. │ │ │ │ │ -00004190: 596f 7520 7368 6f77 2073 6f6d 6520 7265 You show some re │ │ │ │ │ -000041a0: 7375 6c74 2069 6e20 7468 6520 6d61 696c sult in the mail │ │ │ │ │ -000041b0: 696e 6720 6c69 7374 206f 7220 7468 6520 ing list or the │ │ │ │ │ -000041c0: 4952 432e 0a20 2033 2e20 596f 7520 6172 IRC.. 3. You ar │ │ │ │ │ -000041d0: 6520 6765 7474 696e 6720 746f 2062 6520 e getting to be │ │ │ │ │ -000041e0: 6b6e 6f77 6e20 746f 206f 7468 6572 2064 known to other d │ │ │ │ │ -000041f0: 6576 656c 6f70 6572 732e 0a20 2034 2e20 evelopers.. 4. │ │ │ │ │ -00004200: 596f 7520 6163 6375 6d75 6c61 7465 2073 You accumulate s │ │ │ │ │ -00004210: 6967 6e69 6669 6361 6e74 2061 6d6f 756e ignificant amoun │ │ │ │ │ -00004220: 7420 6f66 2063 6f6e 7472 6962 7574 696f t of contributio │ │ │ │ │ -00004230: 6e2c 2073 6f20 636f 7079 7269 6768 740a n, so copyright. │ │ │ │ │ -00004240: 2020 2020 2061 7373 6967 6e6d 656e 7420 assignment │ │ │ │ │ -00004250: 6973 2070 726f 6365 7373 6564 2e0a 2020 is processed.. │ │ │ │ │ -00004260: 352e 2059 6f75 2061 7265 2066 7265 6520 5. You are free │ │ │ │ │ -00004270: 746f 2063 6865 636b 2069 6e20 796f 7572 to check in your │ │ │ │ │ -00004280: 2063 6861 6e67 6573 206f 6e20 796f 7572 changes on your │ │ │ │ │ -00004290: 206f 776e 2c20 6c65 6761 6c6c 790a 2020 own, legally. │ │ │ │ │ -000042a0: 2020 2073 7065 616b 696e 672e 0a0a 2020 speaking... │ │ │ │ │ -000042b0: 2041 7420 7468 6973 2070 6f69 6e74 2c20 At this point, │ │ │ │ │ -000042c0: 6974 2069 7320 7261 7468 6572 2061 6e6e it is rather ann │ │ │ │ │ -000042d0: 6f79 696e 6720 7468 6174 2079 6f75 206f oying that you o │ │ │ │ │ -000042e0: 7567 6874 2074 6f20 6173 6b20 736f 6d65 ught to ask some │ │ │ │ │ -000042f0: 626f 6479 0a65 6c73 6520 6576 6572 7920 body.else every │ │ │ │ │ -00004300: 6368 616e 6765 2074 6f20 6265 2063 6865 change to be che │ │ │ │ │ -00004310: 636b 6564 2069 6e2e 2020 466f 7220 6566 cked in. For ef │ │ │ │ │ -00004320: 6669 6369 656e 6379 2c20 6974 2069 7320 ficiency, it is │ │ │ │ │ -00004330: 6661 7220 6265 7474 6572 2c0a 6966 2079 far better,.if y │ │ │ │ │ -00004340: 6f75 2063 616e 2063 6f6d 6d69 7420 6974 ou can commit it │ │ │ │ │ -00004350: 2079 6f75 7273 656c 662e 2020 5468 6572 yourself. Ther │ │ │ │ │ -00004360: 6566 6f72 652c 206f 7572 2070 6f6c 6963 efore, our polic │ │ │ │ │ -00004370: 7920 6973 2074 6f20 6769 7665 2079 6f75 y is to give you │ │ │ │ │ -00004380: 2074 6865 0a77 7269 7465 2070 6572 6d69 the.write permi │ │ │ │ │ -00004390: 7373 696f 6e20 746f 206f 7572 206f 6666 ssion to our off │ │ │ │ │ -000043a0: 6963 6961 6c20 7265 706f 7369 746f 7279 icial repository │ │ │ │ │ -000043b0: 2c20 6f6e 6365 2079 6f75 2068 6176 6520 , once you have │ │ │ │ │ -000043c0: 7368 6f77 6e20 796f 7572 0a73 6b69 6c6c shown your.skill │ │ │ │ │ -000043d0: 2061 6e64 2077 696c 6c2c 2061 6e64 2074 and will, and t │ │ │ │ │ -000043e0: 6865 2046 5346 2063 6c65 726b 7320 6861 he FSF clerks ha │ │ │ │ │ -000043f0: 7665 2064 6561 6c74 2077 6974 6820 796f ve dealt with yo │ │ │ │ │ -00004400: 7572 2063 6f70 7972 6967 6874 0a61 7373 ur copyright.ass │ │ │ │ │ -00004410: 6967 6e6d 656e 742e 0a0a 1f0a 4669 6c65 ignment.....File │ │ │ │ │ -00004420: 3a20 6772 7562 2d64 6576 2e69 6e66 6f2c : grub-dev.info, │ │ │ │ │ -00004430: 2020 4e6f 6465 3a20 5768 656e 2079 6f75 Node: When you │ │ │ │ │ -00004440: 2061 7265 2061 7070 726f 7665 6420 666f are approved fo │ │ │ │ │ -00004450: 7220 7772 6974 6520 6163 6365 7373 2074 r write access t │ │ │ │ │ -00004460: 6f20 7072 6f6a 6563 7427 7320 6669 6c65 o project's file │ │ │ │ │ -00004470: 732c 2020 5072 6576 3a20 5479 7069 6361 s, Prev: Typica │ │ │ │ │ -00004480: 6c20 4465 7665 6c6f 7065 7220 4578 7065 l Developer Expe │ │ │ │ │ -00004490: 7269 656e 6365 2c20 2055 703a 2043 6f6e rience, Up: Con │ │ │ │ │ -000044a0: 7472 6962 7574 696e 6720 4368 616e 6765 tributing Change │ │ │ │ │ -000044b0: 730a 0a34 2e33 2057 6865 6e20 796f 7520 s..4.3 When you │ │ │ │ │ -000044c0: 6172 6520 6170 7072 6f76 6564 2066 6f72 are approved for │ │ │ │ │ -000044d0: 2077 7269 7465 2061 6363 6573 7320 746f write access to │ │ │ │ │ -000044e0: 2070 726f 6a65 6374 2773 2066 696c 6573 project's files │ │ │ │ │ -000044f0: 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d .=============== │ │ │ │ │ +000040f0: 3d3d 3d3d 3d3d 3d3d 0a0a 5468 6520 7479 ========..The ty │ │ │ │ │ +00004100: 7069 6361 6c20 6578 7065 7269 656e 6365 pical experience │ │ │ │ │ +00004110: 2066 6f72 2061 2064 6576 656c 6f70 6572 for a developer │ │ │ │ │ +00004120: 2069 6e20 7468 6973 2070 726f 6a65 6374 in this project │ │ │ │ │ +00004130: 2069 7320 7468 6520 666f 6c6c 6f77 696e is the followin │ │ │ │ │ +00004140: 673a 0a0a 2020 312e 2059 6f75 2066 696e g:.. 1. You fin │ │ │ │ │ +00004150: 6420 796f 7572 7365 6c66 2077 616e 7469 d yourself wanti │ │ │ │ │ +00004160: 6e67 2074 6f20 646f 2073 6f6d 6574 6869 ng to do somethi │ │ │ │ │ +00004170: 6e67 2028 652e 672e 2020 6669 7869 6e67 ng (e.g. fixing │ │ │ │ │ +00004180: 2061 2062 7567 292e 0a20 2032 2e20 596f a bug).. 2. Yo │ │ │ │ │ +00004190: 7520 7368 6f77 2073 6f6d 6520 7265 7375 u show some resu │ │ │ │ │ +000041a0: 6c74 2069 6e20 7468 6520 6d61 696c 696e lt in the mailin │ │ │ │ │ +000041b0: 6720 6c69 7374 206f 7220 7468 6520 4952 g list or the IR │ │ │ │ │ +000041c0: 432e 0a20 2033 2e20 596f 7520 6172 6520 C.. 3. You are │ │ │ │ │ +000041d0: 6765 7474 696e 6720 746f 2062 6520 6b6e getting to be kn │ │ │ │ │ +000041e0: 6f77 6e20 746f 206f 7468 6572 2064 6576 own to other dev │ │ │ │ │ +000041f0: 656c 6f70 6572 732e 0a20 2034 2e20 596f elopers.. 4. Yo │ │ │ │ │ +00004200: 7520 6163 6375 6d75 6c61 7465 2073 6967 u accumulate sig │ │ │ │ │ +00004210: 6e69 6669 6361 6e74 2061 6d6f 756e 7420 nificant amount │ │ │ │ │ +00004220: 6f66 2063 6f6e 7472 6962 7574 696f 6e2c of contribution, │ │ │ │ │ +00004230: 2073 6f20 636f 7079 7269 6768 740a 2020 so copyright. │ │ │ │ │ +00004240: 2020 2061 7373 6967 6e6d 656e 7420 6973 assignment is │ │ │ │ │ +00004250: 2070 726f 6365 7373 6564 2e0a 2020 352e processed.. 5. │ │ │ │ │ +00004260: 2059 6f75 2061 7265 2066 7265 6520 746f You are free to │ │ │ │ │ +00004270: 2063 6865 636b 2069 6e20 796f 7572 2063 check in your c │ │ │ │ │ +00004280: 6861 6e67 6573 206f 6e20 796f 7572 206f hanges on your o │ │ │ │ │ +00004290: 776e 2c20 6c65 6761 6c6c 790a 2020 2020 wn, legally. │ │ │ │ │ +000042a0: 2073 7065 616b 696e 672e 0a0a 2020 2041 speaking... A │ │ │ │ │ +000042b0: 7420 7468 6973 2070 6f69 6e74 2c20 6974 t this point, it │ │ │ │ │ +000042c0: 2069 7320 7261 7468 6572 2061 6e6e 6f79 is rather annoy │ │ │ │ │ +000042d0: 696e 6720 7468 6174 2079 6f75 206f 7567 ing that you oug │ │ │ │ │ +000042e0: 6874 2074 6f20 6173 6b20 736f 6d65 626f ht to ask somebo │ │ │ │ │ +000042f0: 6479 0a65 6c73 6520 6576 6572 7920 6368 dy.else every ch │ │ │ │ │ +00004300: 616e 6765 2074 6f20 6265 2063 6865 636b ange to be check │ │ │ │ │ +00004310: 6564 2069 6e2e 2020 466f 7220 6566 6669 ed in. For effi │ │ │ │ │ +00004320: 6369 656e 6379 2c20 6974 2069 7320 6661 ciency, it is fa │ │ │ │ │ +00004330: 7220 6265 7474 6572 2c0a 6966 2079 6f75 r better,.if you │ │ │ │ │ +00004340: 2063 616e 2063 6f6d 6d69 7420 6974 2079 can commit it y │ │ │ │ │ +00004350: 6f75 7273 656c 662e 2020 5468 6572 6566 ourself. Theref │ │ │ │ │ +00004360: 6f72 652c 206f 7572 2070 6f6c 6963 7920 ore, our policy │ │ │ │ │ +00004370: 6973 2074 6f20 6769 7665 2079 6f75 2074 is to give you t │ │ │ │ │ +00004380: 6865 0a77 7269 7465 2070 6572 6d69 7373 he.write permiss │ │ │ │ │ +00004390: 696f 6e20 746f 206f 7572 206f 6666 6963 ion to our offic │ │ │ │ │ +000043a0: 6961 6c20 7265 706f 7369 746f 7279 2c20 ial repository, │ │ │ │ │ +000043b0: 6f6e 6365 2079 6f75 2068 6176 6520 7368 once you have sh │ │ │ │ │ +000043c0: 6f77 6e20 796f 7572 0a73 6b69 6c6c 2061 own your.skill a │ │ │ │ │ +000043d0: 6e64 2077 696c 6c2c 2061 6e64 2074 6865 nd will, and the │ │ │ │ │ +000043e0: 2046 5346 2063 6c65 726b 7320 6861 7665 FSF clerks have │ │ │ │ │ +000043f0: 2064 6561 6c74 2077 6974 6820 796f 7572 dealt with your │ │ │ │ │ +00004400: 2063 6f70 7972 6967 6874 0a61 7373 6967 copyright.assig │ │ │ │ │ +00004410: 6e6d 656e 742e 0a0a 1f0a 4669 6c65 3a20 nment.....File: │ │ │ │ │ +00004420: 6772 7562 2d64 6576 2e69 6e66 6f2c 2020 grub-dev.info, │ │ │ │ │ +00004430: 4e6f 6465 3a20 5768 656e 2079 6f75 2061 Node: When you a │ │ │ │ │ +00004440: 7265 2061 7070 726f 7665 6420 666f 7220 re approved for │ │ │ │ │ +00004450: 7772 6974 6520 6163 6365 7373 2074 6f20 write access to │ │ │ │ │ +00004460: 7072 6f6a 6563 7427 7320 6669 6c65 732c project's files, │ │ │ │ │ +00004470: 2020 5072 6576 3a20 5479 7069 6361 6c20 Prev: Typical │ │ │ │ │ +00004480: 4465 7665 6c6f 7065 7220 4578 7065 7269 Developer Experi │ │ │ │ │ +00004490: 656e 6365 2c20 2055 703a 2043 6f6e 7472 ence, Up: Contr │ │ │ │ │ +000044a0: 6962 7574 696e 6720 4368 616e 6765 730a ibuting Changes. │ │ │ │ │ +000044b0: 0a34 2e33 2057 6865 6e20 796f 7520 6172 .4.3 When you ar │ │ │ │ │ +000044c0: 6520 6170 7072 6f76 6564 2066 6f72 2077 e approved for w │ │ │ │ │ +000044d0: 7269 7465 2061 6363 6573 7320 746f 2070 rite access to p │ │ │ │ │ +000044e0: 726f 6a65 6374 2773 2066 696c 6573 0a3d roject's files.= │ │ │ │ │ +000044f0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 00004500: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 00004510: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00004520: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a ==============.. │ │ │ │ │ -00004530: 4173 2079 6f75 206d 6967 6874 206b 6e6f As you might kno │ │ │ │ │ -00004540: 772c 2047 5255 4220 6973 2068 6f73 7465 w, GRUB is hoste │ │ │ │ │ -00004550: 6420 6f6e 0a3c 6874 7470 733a 2f2f 7361 d on., thus the │ │ │ │ │ -00004590: 206d 656d 6265 7273 6869 700a 6973 206d membership.is m │ │ │ │ │ -000045a0: 616e 6167 6564 2062 7920 5361 7661 6e6e anaged by Savann │ │ │ │ │ -000045b0: 6168 2e20 2054 6869 7320 6d65 616e 7320 ah. This means │ │ │ │ │ -000045c0: 7468 6174 2c20 6966 2079 6f75 2077 616e that, if you wan │ │ │ │ │ -000045d0: 7420 746f 2062 6520 6120 6d65 6d62 6572 t to be a member │ │ │ │ │ -000045e0: 206f 660a 7468 6973 2070 726f 6a65 6374 of.this project │ │ │ │ │ -000045f0: 3a0a 0a20 2031 2e20 596f 7520 6e65 6564 :.. 1. You need │ │ │ │ │ -00004600: 2074 6f20 6372 6561 7465 2079 6f75 7220 to create your │ │ │ │ │ -00004610: 6f77 6e20 6163 636f 756e 7420 6f6e 2053 own account on S │ │ │ │ │ -00004620: 6176 616e 6e61 682e 0a20 2032 2e20 596f avannah.. 2. Yo │ │ │ │ │ -00004630: 7520 6361 6e20 7375 626d 6974 2022 5265 u can submit "Re │ │ │ │ │ -00004640: 7175 6573 7420 666f 7220 496e 636c 7573 quest for Inclus │ │ │ │ │ -00004650: 696f 6e22 2066 726f 6d20 224d 7920 4772 ion" from "My Gr │ │ │ │ │ -00004660: 6f75 7073 2220 6f6e 0a20 2020 2020 5361 oups" on. Sa │ │ │ │ │ -00004670: 7661 6e6e 6168 2e0a 0a20 2020 5468 656e vannah... Then │ │ │ │ │ -00004680: 2c20 6f6e 6520 6f66 2074 6865 2061 646d , one of the adm │ │ │ │ │ -00004690: 696e 7320 6361 6e20 6170 7072 6f76 6520 ins can approve │ │ │ │ │ -000046a0: 796f 7572 2072 6571 7565 7374 2c20 616e your request, an │ │ │ │ │ -000046b0: 6420 796f 7520 7769 6c6c 2062 6520 610a d you will be a. │ │ │ │ │ -000046c0: 6d65 6d62 6572 2e20 2049 6620 796f 7520 member. If you │ │ │ │ │ -000046d0: 646f 6e27 7420 7761 6e74 2074 6f20 7573 don't want to us │ │ │ │ │ -000046e0: 6520 7468 6520 5361 7661 6e6e 6168 2069 e the Savannah i │ │ │ │ │ -000046f0: 6e74 6572 6661 6365 2074 6f20 7375 626d nterface to subm │ │ │ │ │ -00004700: 6974 2061 0a72 6571 7565 7374 2c20 796f it a.request, yo │ │ │ │ │ -00004710: 7520 6361 6e20 7369 6d70 6c79 206e 6f74 u can simply not │ │ │ │ │ -00004720: 6966 7920 7468 6520 6164 6d69 6e73 2062 ify the admins b │ │ │ │ │ -00004730: 7920 656d 6169 6c20 6f72 2073 6f6d 6574 y email or somet │ │ │ │ │ -00004740: 6869 6e67 2065 6c73 652c 0a61 6c74 6572 hing else,.alter │ │ │ │ │ -00004750: 6e61 7469 7665 6c79 2e20 2042 7574 2079 natively. But y │ │ │ │ │ -00004760: 6f75 2073 7469 6c6c 206e 6565 6420 746f ou still need to │ │ │ │ │ -00004770: 2063 7265 6174 6520 616e 2061 6363 6f75 create an accou │ │ │ │ │ -00004780: 6e74 2062 6566 6f72 6568 616e 642e 0a0a nt beforehand... │ │ │ │ │ -00004790: 2020 204e 4f54 453a 2077 6520 736f 6d65 NOTE: we some │ │ │ │ │ -000047a0: 7469 6d65 7320 7265 6365 6976 6520 6120 times receive a │ │ │ │ │ -000047b0: 2252 6571 7565 7374 2066 6f72 2049 6e63 "Request for Inc │ │ │ │ │ -000047c0: 6c75 7369 6f6e 2220 6672 6f6d 2061 6e20 lusion" from an │ │ │ │ │ -000047d0: 756e 6b6e 6f77 6e0a 7065 7273 6f6e 2e20 unknown.person. │ │ │ │ │ -000047e0: 2049 6e20 7468 6973 2063 6173 652c 2074 In this case, t │ │ │ │ │ -000047f0: 6865 2072 6571 7565 7374 2077 6f75 6c64 he request would │ │ │ │ │ -00004800: 2062 6520 6a75 7374 2064 6973 6361 7264 be just discard │ │ │ │ │ -00004810: 6564 2c20 7369 6e63 6520 6974 2069 730a ed, since it is. │ │ │ │ │ -00004820: 746f 6f20 6461 6e67 6572 6f75 7320 746f too dangerous to │ │ │ │ │ -00004830: 2061 6c6c 6f77 2061 2073 7472 616e 6765 allow a strange │ │ │ │ │ -00004840: 7220 746f 2062 6520 6120 6d65 6d62 6572 r to be a member │ │ │ │ │ -00004850: 2c20 7768 6963 6820 6175 746f 6d61 7469 , which automati │ │ │ │ │ -00004860: 6361 6c6c 790a 6769 7665 7320 6869 6d20 cally.gives him │ │ │ │ │ -00004870: 6120 636f 6d6d 6974 2072 6967 6874 2074 a commit right t │ │ │ │ │ -00004880: 6f20 7468 6520 7265 706f 7369 746f 7279 o the repository │ │ │ │ │ -00004890: 2c20 626f 7468 2066 6f72 2061 206c 6567 , both for a leg │ │ │ │ │ -000048a0: 616c 2072 6561 736f 6e20 616e 640a 666f al reason and.fo │ │ │ │ │ -000048b0: 7220 6120 7465 6368 6e69 6361 6c20 7265 r a technical re │ │ │ │ │ -000048c0: 6173 6f6e 2e0a 0a20 2020 4966 2079 6f75 ason... If you │ │ │ │ │ -000048d0: 7220 696e 7465 6e74 696f 6e20 6973 2074 r intention is t │ │ │ │ │ -000048e0: 6f20 6a75 7374 2067 6574 2073 7461 7274 o just get start │ │ │ │ │ -000048f0: 6564 2c20 706c 6561 7365 2064 6f20 6e6f ed, please do no │ │ │ │ │ -00004900: 7420 7375 626d 6974 2061 0a69 6e63 6c75 t submit a.inclu │ │ │ │ │ -00004910: 7369 6f6e 2072 6571 7565 7374 2e20 2049 sion request. I │ │ │ │ │ -00004920: 6e73 7465 6164 2c20 706c 6561 7365 2073 nstead, please s │ │ │ │ │ -00004930: 7562 7363 7269 6265 2074 6f20 7468 6520 ubscribe to the │ │ │ │ │ -00004940: 6d61 696c 696e 6720 6c69 7374 2c20 616e mailing list, an │ │ │ │ │ -00004950: 640a 636f 6d6d 756e 6963 6174 6520 6669 d.communicate fi │ │ │ │ │ -00004960: 7273 7420 2865 2e67 2e20 2073 656e 6469 rst (e.g. sendi │ │ │ │ │ -00004970: 6e67 2061 2070 6174 6368 2c20 6173 6b69 ng a patch, aski │ │ │ │ │ -00004980: 6e67 2061 2071 7565 7374 696f 6e2c 2063 ng a question, c │ │ │ │ │ -00004990: 6f6d 6d65 6e74 696e 670a 6f6e 2061 6e6f ommenting.on ano │ │ │ │ │ -000049a0: 7468 6572 206d 6573 7361 6765 2e2e 2e29 ther message...) │ │ │ │ │ -000049b0: 2e0a 0a1f 0a46 696c 653a 2067 7275 622d .....File: grub- │ │ │ │ │ -000049c0: 6465 762e 696e 666f 2c20 204e 6f64 653a dev.info, Node: │ │ │ │ │ -000049d0: 2055 7064 6174 696e 6720 4578 7465 726e Updating Extern │ │ │ │ │ -000049e0: 616c 2043 6f64 652c 2020 4e65 7874 3a20 al Code, Next: │ │ │ │ │ -000049f0: 506f 7274 696e 672c 2020 5072 6576 3a20 Porting, Prev: │ │ │ │ │ -00004a00: 436f 6e74 7269 6275 7469 6e67 2043 6861 Contributing Cha │ │ │ │ │ -00004a10: 6e67 6573 2c20 2055 703a 2054 6f70 0a0a nges, Up: Top.. │ │ │ │ │ -00004a20: 3520 5570 6461 7469 6e67 2065 7874 6572 5 Updating exter │ │ │ │ │ -00004a30: 6e61 6c20 636f 6465 0a2a 2a2a 2a2a 2a2a nal code.******* │ │ │ │ │ -00004a40: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -00004a50: 2a0a 0a47 5255 4220 696e 636c 7564 6573 *..GRUB includes │ │ │ │ │ -00004a60: 2073 6f6d 6520 636f 6465 2066 726f 6d20 some code from │ │ │ │ │ -00004a70: 6f74 6865 7220 7072 6f6a 6563 7473 2c20 other projects, │ │ │ │ │ -00004a80: 616e 6420 6974 2069 7320 736f 6d65 7469 and it is someti │ │ │ │ │ -00004a90: 6d65 730a 6e65 6365 7373 6172 7920 746f mes.necessary to │ │ │ │ │ -00004aa0: 2075 7064 6174 6520 6974 2e0a 0a2a 204d update it...* M │ │ │ │ │ -00004ab0: 656e 753a 0a0a 2a20 476e 756c 6962 3a3a enu:..* Gnulib:: │ │ │ │ │ -00004ac0: 0a2a 206a 736d 6e3a 3a0a 2a20 6d69 6e69 .* jsmn::.* mini │ │ │ │ │ -00004ad0: 6c7a 6f3a 3a0a 0a1f 0a46 696c 653a 2067 lzo::....File: g │ │ │ │ │ -00004ae0: 7275 622d 6465 762e 696e 666f 2c20 204e rub-dev.info, N │ │ │ │ │ -00004af0: 6f64 653a 2047 6e75 6c69 622c 2020 4e65 ode: Gnulib, Ne │ │ │ │ │ -00004b00: 7874 3a20 6a73 6d6e 2c20 2055 703a 2055 xt: jsmn, Up: U │ │ │ │ │ -00004b10: 7064 6174 696e 6720 4578 7465 726e 616c pdating External │ │ │ │ │ -00004b20: 2043 6f64 650a 0a35 2e31 2047 6e75 6c69 Code..5.1 Gnuli │ │ │ │ │ -00004b30: 620a 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 476e b.==========..Gn │ │ │ │ │ -00004b40: 756c 6962 2069 7320 6120 736f 7572 6365 ulib is a source │ │ │ │ │ -00004b50: 2063 6f64 6520 6c69 6272 6172 7920 7468 code library th │ │ │ │ │ -00004b60: 6174 2070 726f 7669 6465 7320 6261 7369 at provides basi │ │ │ │ │ -00004b70: 6320 6675 6e63 7469 6f6e 616c 6974 7920 c functionality │ │ │ │ │ -00004b80: 746f 0a70 726f 6772 616d 7320 616e 6420 to.programs and │ │ │ │ │ -00004b90: 6c69 6272 6172 6965 732e 2020 4d61 6e79 libraries. Many │ │ │ │ │ -00004ba0: 2073 6f66 7477 6172 6520 7061 636b 6167 software packag │ │ │ │ │ -00004bb0: 6573 206d 616b 6520 7573 6520 6f66 2047 es make use of G │ │ │ │ │ -00004bc0: 6e75 6c69 6220 746f 0a61 766f 6964 2072 nulib to.avoid r │ │ │ │ │ -00004bd0: 6569 6e76 656e 7469 6e67 2074 6865 2070 einventing the p │ │ │ │ │ -00004be0: 6f72 7461 6269 6c69 7479 2077 6865 656c ortability wheel │ │ │ │ │ -00004bf0: 2e0a 0a20 2020 4752 5542 2069 6d70 6f72 ... GRUB impor │ │ │ │ │ -00004c00: 7473 2047 6e75 6c69 6220 7573 696e 6720 ts Gnulib using │ │ │ │ │ -00004c10: 6974 7320 2762 6f6f 7473 7472 6170 2720 its 'bootstrap' │ │ │ │ │ -00004c20: 7574 696c 6974 792c 2069 6465 6e74 6966 utility, identif │ │ │ │ │ -00004c30: 7969 6e67 2061 0a70 6172 7469 6375 6c61 ying a.particula │ │ │ │ │ -00004c40: 7220 4769 7420 636f 6d6d 6974 2069 6e20 r Git commit in │ │ │ │ │ -00004c50: 2762 6f6f 7473 7472 6170 2e63 6f6e 6627 'bootstrap.conf' │ │ │ │ │ -00004c60: 2e20 2054 6f20 7570 6772 6164 6520 746f . To upgrade to │ │ │ │ │ -00004c70: 2061 206e 6577 2047 6e75 6c69 620a 636f a new Gnulib.co │ │ │ │ │ -00004c80: 6d6d 6974 2c20 7365 7420 2747 4e55 4c49 mmit, set 'GNULI │ │ │ │ │ -00004c90: 425f 5245 5649 5349 4f4e 2720 696e 2027 B_REVISION' in ' │ │ │ │ │ -00004ca0: 626f 6f74 7374 7261 702e 636f 6e66 2720 bootstrap.conf' │ │ │ │ │ -00004cb0: 746f 2074 6865 206e 6577 2063 6f6d 6d69 to the new commi │ │ │ │ │ -00004cc0: 7420 4944 2c0a 7468 656e 2072 756e 2027 t ID,.then run ' │ │ │ │ │ -00004cd0: 2e2f 626f 6f74 7374 7261 7027 2061 6e64 ./bootstrap' and │ │ │ │ │ -00004ce0: 2077 6861 7465 7665 7220 656c 7365 2079 whatever else y │ │ │ │ │ -00004cf0: 6f75 206e 6565 6420 746f 206d 616b 6520 ou need to make │ │ │ │ │ -00004d00: 7375 7265 2069 7420 776f 726b 732e 0a43 sure it works..C │ │ │ │ │ -00004d10: 6865 636b 2066 6f72 2063 6861 6e67 6573 heck for changes │ │ │ │ │ -00004d20: 2074 6f20 476e 756c 6962 2773 2027 4e45 to Gnulib's 'NE │ │ │ │ │ -00004d30: 5753 2720 6669 6c65 2062 6574 7765 656e WS' file between │ │ │ │ │ -00004d40: 2074 6865 206f 6c64 2061 6e64 206e 6577 the old and new │ │ │ │ │ -00004d50: 0a63 6f6d 6d69 7473 3b20 696e 2073 6f6d .commits; in som │ │ │ │ │ -00004d60: 6520 6361 7365 7320 6974 2077 696c 6c20 e cases it will │ │ │ │ │ -00004d70: 6265 206e 6563 6573 7361 7279 2074 6f20 be necessary to │ │ │ │ │ -00004d80: 6164 6a75 7374 2047 5255 4220 746f 206d adjust GRUB to m │ │ │ │ │ -00004d90: 6174 6368 2e0a 596f 7520 6d61 7920 616c atch..You may al │ │ │ │ │ -00004da0: 736f 206e 6565 6420 746f 2075 7064 6174 so need to updat │ │ │ │ │ -00004db0: 6520 7468 6520 7061 7463 6865 7320 696e e the patches in │ │ │ │ │ -00004dc0: 0a27 6772 7562 2d63 6f72 652f 6c69 622f .'grub-core/lib/ │ │ │ │ │ -00004dd0: 676e 756c 6962 2d70 6174 6368 6573 2f27 gnulib-patches/' │ │ │ │ │ -00004de0: 2e0a 0a20 2020 546f 2061 6464 2061 206e ... To add a n │ │ │ │ │ -00004df0: 6577 2047 6e75 6c69 6220 6d6f 6475 6c65 ew Gnulib module │ │ │ │ │ -00004e00: 206f 7220 7265 6d6f 7665 206f 6e65 2074 or remove one t │ │ │ │ │ -00004e10: 6861 7420 6973 206e 6f20 6c6f 6e67 6572 hat is no longer │ │ │ │ │ -00004e20: 206e 6565 6465 642c 0a63 6861 6e67 6520 needed,.change │ │ │ │ │ -00004e30: 2767 6e75 6c69 625f 6d6f 6475 6c65 7327 'gnulib_modules' │ │ │ │ │ -00004e40: 2069 6e20 2762 6f6f 7473 7472 6170 2e63 in 'bootstrap.c │ │ │ │ │ -00004e50: 6f6e 6627 2e20 2041 6761 696e 2c20 7275 onf'. Again, ru │ │ │ │ │ -00004e60: 6e20 272e 2f62 6f6f 7473 7472 6170 270a n './bootstrap'. │ │ │ │ │ -00004e70: 616e 6420 7768 6174 6576 6572 2065 6c73 and whatever els │ │ │ │ │ -00004e80: 6520 796f 7520 6e65 6564 2074 6f20 6d61 e you need to ma │ │ │ │ │ -00004e90: 6b65 2073 7572 6520 6974 2077 6f72 6b73 ke sure it works │ │ │ │ │ -00004ea0: 2e0a 0a20 2020 426f 6f74 7374 7261 7070 ... Bootstrapp │ │ │ │ │ -00004eb0: 696e 6720 6672 6f6d 2061 6e20 6f6c 6465 ing from an olde │ │ │ │ │ -00004ec0: 7220 6469 7374 7269 6275 7469 6f6e 2063 r distribution c │ │ │ │ │ -00004ed0: 6f6e 7461 696e 696e 6720 6765 7474 6578 ontaining gettex │ │ │ │ │ -00004ee0: 7420 7665 7273 696f 6e20 3c0a 302e 3138 t version <.0.18 │ │ │ │ │ -00004ef0: 2e33 2c20 7769 6c6c 2072 6571 7569 7265 .3, will require │ │ │ │ │ -00004f00: 2061 2070 6174 6368 2073 696d 696c 6172 a patch similar │ │ │ │ │ -00004f10: 2074 6f20 7468 6973 2074 6f20 6265 2061 to this to be a │ │ │ │ │ -00004f20: 7070 6c69 6564 2066 6972 7374 2062 6566 pplied first bef │ │ │ │ │ -00004f30: 6f72 650a 7275 6e6e 696e 6720 7468 6520 ore.running the │ │ │ │ │ -00004f40: 272e 2f62 6f6f 7473 7472 6170 2720 7574 './bootstrap' ut │ │ │ │ │ -00004f50: 696c 6974 793a 0a0a 2020 2020 2064 6966 ility:.. dif │ │ │ │ │ -00004f60: 6620 2d2d 6769 7420 612f 626f 6f74 7374 f --git a/bootst │ │ │ │ │ -00004f70: 7261 702e 636f 6e66 2062 2f62 6f6f 7473 rap.conf b/boots │ │ │ │ │ -00004f80: 7472 6170 2e63 6f6e 660a 2020 2020 2069 trap.conf. i │ │ │ │ │ -00004f90: 6e64 6578 2039 3838 6464 6130 2e2e 6133 ndex 988dda0..a3 │ │ │ │ │ -00004fa0: 3139 3361 3920 3130 3036 3434 0a20 2020 193a9 100644. │ │ │ │ │ -00004fb0: 2020 2d2d 2d20 612f 626f 6f74 7374 7261 --- a/bootstra │ │ │ │ │ -00004fc0: 702e 636f 6e66 0a20 2020 2020 2b2b 2b20 p.conf. +++ │ │ │ │ │ -00004fd0: 622f 626f 6f74 7374 7261 702e 636f 6e66 b/bootstrap.conf │ │ │ │ │ -00004fe0: 0a20 2020 2020 4020 2d36 372c 3720 2b36 . @ -67,7 +6 │ │ │ │ │ -00004ff0: 372c 3720 4020 534b 4950 5f50 4f3d 740a 7,7 @ SKIP_PO=t. │ │ │ │ │ -00005000: 2020 2020 2062 7569 6c64 7265 713d 225c buildreq="\ │ │ │ │ │ -00005010: 0a20 2020 2020 6175 746f 636f 6e66 2020 . autoconf │ │ │ │ │ -00005020: 2032 2e36 330a 2020 2020 2061 7574 6f6d 2.63. autom │ │ │ │ │ -00005030: 616b 6520 2020 312e 3131 0a20 2020 2020 ake 1.11. │ │ │ │ │ -00005040: 2d67 6574 7465 7874 2020 2020 302e 3138 -gettext 0.18 │ │ │ │ │ -00005050: 2e33 0a20 2020 2020 2b67 6574 7465 7874 .3. +gettext │ │ │ │ │ -00005060: 2020 2020 302e 3137 0a20 2020 2020 6769 0.17. gi │ │ │ │ │ -00005070: 7420 2020 2020 2020 2031 2e35 2e35 0a20 t 1.5.5. │ │ │ │ │ -00005080: 2020 2020 7461 7220 2020 2020 2020 202d tar - │ │ │ │ │ -00005090: 0a20 2020 2020 220a 2020 2020 2064 6966 . ". dif │ │ │ │ │ -000050a0: 6620 2d2d 6769 7420 612f 636f 6e66 6967 f --git a/config │ │ │ │ │ -000050b0: 7572 652e 6163 2062 2f63 6f6e 6669 6775 ure.ac b/configu │ │ │ │ │ -000050c0: 7265 2e61 630a 2020 2020 2069 6e64 6578 re.ac. index │ │ │ │ │ -000050d0: 2030 3862 3531 3866 2e2e 3939 6635 6233 08b518f..99f5b3 │ │ │ │ │ -000050e0: 3620 3130 3036 3434 0a20 2020 2020 2d2d 6 100644. -- │ │ │ │ │ -000050f0: 2d20 612f 636f 6e66 6967 7572 652e 6163 - a/configure.ac │ │ │ │ │ -00005100: 0a20 2020 2020 2b2b 2b20 622f 636f 6e66 . +++ b/conf │ │ │ │ │ -00005110: 6967 7572 652e 6163 0a20 2020 2020 4020 igure.ac. @ │ │ │ │ │ -00005120: 2d33 3632 2c37 202b 3336 322c 3720 4020 -362,7 +362,7 @ │ │ │ │ │ -00005130: 4143 5f43 4845 434b 5f50 524f 4728 4841 AC_CHECK_PROG(HA │ │ │ │ │ -00005140: 5645 5f43 5858 2c20 2443 5858 2c20 7965 VE_CXX, $CXX, ye │ │ │ │ │ -00005150: 732c 206e 6f29 0a0a 2020 2020 2041 435f s, no).. AC_ │ │ │ │ │ -00005160: 474e 555f 534f 5552 4345 0a20 2020 2020 GNU_SOURCE. │ │ │ │ │ -00005170: 414d 5f47 4e55 5f47 4554 5445 5854 285b AM_GNU_GETTEXT([ │ │ │ │ │ -00005180: 6578 7465 726e 616c 5d29 0a20 2020 2020 external]). │ │ │ │ │ -00005190: 2d41 4d5f 474e 555f 4745 5454 4558 545f -AM_GNU_GETTEXT_ │ │ │ │ │ -000051a0: 5645 5253 494f 4e28 5b30 2e31 382e 335d VERSION([0.18.3] │ │ │ │ │ -000051b0: 290a 2020 2020 202b 414d 5f47 4e55 5f47 ). +AM_GNU_G │ │ │ │ │ -000051c0: 4554 5445 5854 5f56 4552 5349 4f4e 285b ETTEXT_VERSION([ │ │ │ │ │ -000051d0: 302e 3137 5d29 0a20 2020 2020 4143 5f53 0.17]). AC_S │ │ │ │ │ -000051e0: 5953 5f4c 4152 4745 4649 4c45 0a0a 2020 YS_LARGEFILE.. │ │ │ │ │ -000051f0: 2020 2023 2049 6465 6e74 6966 7920 6368 # Identify ch │ │ │ │ │ -00005200: 6172 6163 7465 7269 7374 6963 7320 6f66 aracteristics of │ │ │ │ │ -00005210: 2074 6865 2068 6f73 7420 6172 6368 6974 the host archit │ │ │ │ │ -00005220: 6563 7475 7265 2e0a 0a0a 2020 2049 7420 ecture.... It │ │ │ │ │ -00005230: 7769 6c6c 2061 6c73 6f20 6265 206e 6563 will also be nec │ │ │ │ │ -00005240: 6573 7361 7279 2074 6f20 6164 6a75 7374 essary to adjust │ │ │ │ │ -00005250: 2074 6865 2070 6174 6368 6573 2069 6e0a the patches in. │ │ │ │ │ -00005260: 2770 6f2f 6765 7474 6578 742d 7061 7463 'po/gettext-patc │ │ │ │ │ -00005270: 6865 732f 2720 746f 2061 7070 6c79 2074 hes/' to apply t │ │ │ │ │ -00005280: 6f20 616e 206f 6c64 6572 2076 6572 7369 o an older versi │ │ │ │ │ -00005290: 6f6e 206f 6620 6765 7474 6578 742e 0a0a on of gettext... │ │ │ │ │ -000052a0: 1f0a 4669 6c65 3a20 6772 7562 2d64 6576 ..File: grub-dev │ │ │ │ │ -000052b0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 6a73 .info, Node: js │ │ │ │ │ -000052c0: 6d6e 2c20 204e 6578 743a 206d 696e 696c mn, Next: minil │ │ │ │ │ -000052d0: 7a6f 2c20 2050 7265 763a 2047 6e75 6c69 zo, Prev: Gnuli │ │ │ │ │ -000052e0: 622c 2020 5570 3a20 5570 6461 7469 6e67 b, Up: Updating │ │ │ │ │ -000052f0: 2045 7874 6572 6e61 6c20 436f 6465 0a0a External Code.. │ │ │ │ │ -00005300: 352e 3220 6a73 6d6e 0a3d 3d3d 3d3d 3d3d 5.2 jsmn.======= │ │ │ │ │ -00005310: 3d0a 0a6a 736d 6e20 6973 2061 206d 696e =..jsmn is a min │ │ │ │ │ -00005320: 696d 616c 6973 7469 6320 4a53 4f4e 2070 imalistic JSON p │ │ │ │ │ -00005330: 6172 7365 7220 7768 6963 6820 6973 2069 arser which is i │ │ │ │ │ -00005340: 6d70 6c65 6d65 6e74 6564 2069 6e20 6120 mplemented in a │ │ │ │ │ -00005350: 7369 6e67 6c65 0a68 6561 6465 7220 6669 single.header fi │ │ │ │ │ -00005360: 6c65 2027 6a73 6d6e 2e68 272e 2020 546f le 'jsmn.h'. To │ │ │ │ │ -00005370: 2069 6d70 6f72 7420 6120 6469 6666 6572 import a differ │ │ │ │ │ -00005380: 656e 7420 7665 7273 696f 6e20 6f66 2074 ent version of t │ │ │ │ │ -00005390: 6865 206a 736d 6e20 7061 7273 6572 2c0a he jsmn parser,. │ │ │ │ │ -000053a0: 796f 7520 6d61 7920 7369 6d70 6c79 2064 you may simply d │ │ │ │ │ -000053b0: 6f77 6e6c 6f61 6420 7468 6520 276a 736d ownload the 'jsm │ │ │ │ │ -000053c0: 6e2e 6827 2068 6561 6465 7220 6672 6f6d n.h' header from │ │ │ │ │ -000053d0: 2074 6865 2064 6573 6972 6564 2074 6167 the desired tag │ │ │ │ │ -000053e0: 206f 720a 636f 6d6d 6974 2074 6f20 7468 or.commit to th │ │ │ │ │ -000053f0: 6520 7461 7267 6574 2064 6972 6563 746f e target directo │ │ │ │ │ -00005400: 7279 3a0a 0a20 2020 2020 6375 726c 202d ry:.. curl - │ │ │ │ │ -00005410: 4c20 6874 7470 733a 2f2f 7261 772e 6769 L https://raw.gi │ │ │ │ │ -00005420: 7468 7562 7573 6572 636f 6e74 656e 742e thubusercontent. │ │ │ │ │ -00005430: 636f 6d2f 7a73 6572 6765 2f6a 736d 6e2f com/zserge/jsmn/ │ │ │ │ │ -00005440: 7631 2e31 2e30 2f6a 736d 6e2e 6820 5c0a v1.1.0/jsmn.h \. │ │ │ │ │ -00005450: 2020 2020 2020 2020 202d 6f20 6772 7562 -o grub │ │ │ │ │ -00005460: 2d63 6f72 652f 6c69 622f 6a73 6f6e 2f6a -core/lib/json/j │ │ │ │ │ -00005470: 736d 6e2e 680a 0a1f 0a46 696c 653a 2067 smn.h....File: g │ │ │ │ │ -00005480: 7275 622d 6465 762e 696e 666f 2c20 204e rub-dev.info, N │ │ │ │ │ -00005490: 6f64 653a 206d 696e 696c 7a6f 2c20 2050 ode: minilzo, P │ │ │ │ │ -000054a0: 7265 763a 206a 736d 6e2c 2020 5570 3a20 rev: jsmn, Up: │ │ │ │ │ -000054b0: 5570 6461 7469 6e67 2045 7874 6572 6e61 Updating Externa │ │ │ │ │ -000054c0: 6c20 436f 6465 0a0a 352e 3320 6d69 6e69 l Code..5.3 mini │ │ │ │ │ -000054d0: 6c7a 6f0a 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a lzo.===========. │ │ │ │ │ -000054e0: 0a6d 696e 694c 5a4f 2069 7320 6120 7665 .miniLZO is a ve │ │ │ │ │ -000054f0: 7279 206c 6967 6874 7765 6967 6874 2073 ry lightweight s │ │ │ │ │ -00005500: 7562 7365 7420 6f66 2074 6865 204c 5a4f ubset of the LZO │ │ │ │ │ -00005510: 206c 6962 7261 7279 2069 6e74 656e 6465 library intende │ │ │ │ │ -00005520: 6420 666f 720a 6561 7379 2069 6e63 6c75 d for.easy inclu │ │ │ │ │ -00005530: 7369 6f6e 2069 6e20 6f74 6865 7220 7072 sion in other pr │ │ │ │ │ -00005540: 6f6a 6563 7473 2e20 2049 7420 6973 2067 ojects. It is g │ │ │ │ │ -00005550: 656e 6572 6174 6564 2061 7574 6f6d 6174 enerated automat │ │ │ │ │ -00005560: 6963 616c 6c79 2066 726f 6d0a 7468 6520 ically from.the │ │ │ │ │ -00005570: 4c5a 4f20 736f 7572 6365 2063 6f64 6520 LZO source code │ │ │ │ │ -00005580: 616e 6420 636f 6e74 6169 6e73 2074 6865 and contains the │ │ │ │ │ -00005590: 206d 6f73 7420 696d 706f 7274 616e 7420 most important │ │ │ │ │ -000055a0: 4c5a 4f20 6675 6e63 7469 6f6e 732e 0a0a LZO functions... │ │ │ │ │ -000055b0: 2020 2054 6f20 7570 6772 6164 6520 746f To upgrade to │ │ │ │ │ -000055c0: 2061 206e 6577 2076 6572 7369 6f6e 206f a new version o │ │ │ │ │ -000055d0: 6620 7468 6520 6d69 6e69 4c5a 4f20 6c69 f the miniLZO li │ │ │ │ │ -000055e0: 6272 6172 792c 2064 6f77 6e6c 6f61 6420 brary, download │ │ │ │ │ -000055f0: 7468 650a 7265 6c65 6173 6520 7461 7262 the.release tarb │ │ │ │ │ -00005600: 616c 6c20 616e 6420 636f 7079 2074 6865 all and copy the │ │ │ │ │ -00005610: 2066 696c 6573 2069 6e74 6f20 7468 6520 files into the │ │ │ │ │ -00005620: 7461 7267 6574 2064 6972 6563 746f 7279 target directory │ │ │ │ │ -00005630: 3a0a 0a20 2020 2020 6375 726c 202d 4c20 :.. curl -L │ │ │ │ │ -00005640: 2d4f 2068 7474 703a 2f2f 7777 772e 6f62 -O http://www.ob │ │ │ │ │ -00005650: 6572 6875 6d65 722e 636f 6d2f 6f70 656e erhumer.com/open │ │ │ │ │ -00005660: 736f 7572 6365 2f6c 7a6f 2f64 6f77 6e6c source/lzo/downl │ │ │ │ │ -00005670: 6f61 642f 6d69 6e69 6c7a 6f2d 322e 3130 oad/minilzo-2.10 │ │ │ │ │ -00005680: 2e74 6172 2e67 7a0a 2020 2020 2074 6172 .tar.gz. tar │ │ │ │ │ -00005690: 202d 7a78 6620 6d69 6e69 6c7a 6f2d 322e -zxf minilzo-2. │ │ │ │ │ -000056a0: 3130 2e74 6172 2e67 7a0a 2020 2020 2072 10.tar.gz. r │ │ │ │ │ -000056b0: 6d20 6d69 6e69 6c7a 6f2d 322e 3130 2f74 m minilzo-2.10/t │ │ │ │ │ -000056c0: 6573 746d 696e 692e 630a 2020 2020 2072 estmini.c. r │ │ │ │ │ -000056d0: 6d20 2d72 2067 7275 622d 636f 7265 2f6c m -r grub-core/l │ │ │ │ │ -000056e0: 6962 2f6d 696e 696c 7a6f 2f2a 0a20 2020 ib/minilzo/*. │ │ │ │ │ -000056f0: 2020 6370 206d 696e 696c 7a6f 2d32 2e31 cp minilzo-2.1 │ │ │ │ │ -00005700: 302f 2a2e 5b68 635d 2067 7275 622d 636f 0/*.[hc] grub-co │ │ │ │ │ -00005710: 7265 2f6c 6962 2f6d 696e 696c 7a6f 0a20 re/lib/minilzo. │ │ │ │ │ -00005720: 2020 2020 726d 202d 7220 6d69 6e69 6c7a rm -r minilz │ │ │ │ │ -00005730: 6f2d 322e 3130 2a0a 0a1f 0a46 696c 653a o-2.10*....File: │ │ │ │ │ -00005740: 2067 7275 622d 6465 762e 696e 666f 2c20 grub-dev.info, │ │ │ │ │ -00005750: 204e 6f64 653a 2050 6f72 7469 6e67 2c20 Node: Porting, │ │ │ │ │ -00005760: 204e 6578 743a 2045 7272 6f72 2048 616e Next: Error Han │ │ │ │ │ -00005770: 646c 696e 672c 2020 5072 6576 3a20 5570 dling, Prev: Up │ │ │ │ │ -00005780: 6461 7469 6e67 2045 7874 6572 6e61 6c20 dating External │ │ │ │ │ -00005790: 436f 6465 2c20 2055 703a 2054 6f70 0a0a Code, Up: Top.. │ │ │ │ │ -000057a0: 3620 506f 7274 696e 670a 2a2a 2a2a 2a2a 6 Porting.****** │ │ │ │ │ -000057b0: 2a2a 2a0a 0a47 5255 4232 2069 7320 6465 ***..GRUB2 is de │ │ │ │ │ -000057c0: 7369 676e 6564 2074 6f20 6265 2065 6173 signed to be eas │ │ │ │ │ -000057d0: 696c 7920 706f 7274 6162 6c65 2061 6363 ily portable acc │ │ │ │ │ -000057e0: 726f 7373 2070 6c61 7466 6f72 6d73 2e20 ross platforms. │ │ │ │ │ -000057f0: 2042 7574 2062 6563 6175 7365 0a6f 6620 But because.of │ │ │ │ │ -00005800: 7468 6520 6e61 7475 7265 206f 6620 626f the nature of bo │ │ │ │ │ -00005810: 6f74 6c6f 6164 6572 2065 7665 7279 206e otloader every n │ │ │ │ │ -00005820: 6577 2070 6f72 7420 6d75 7374 2062 6520 ew port must be │ │ │ │ │ -00005830: 646f 6e65 2073 6570 6172 6174 656c 792e done separately. │ │ │ │ │ -00005840: 0a48 6572 6520 6973 2068 6f77 2049 2064 .Here is how I d │ │ │ │ │ -00005850: 6964 204d 4950 5320 286c 6f6f 6e67 736f id MIPS (loongso │ │ │ │ │ -00005860: 6e20 616e 6420 4152 4329 2061 6e64 2058 n and ARC) and X │ │ │ │ │ -00005870: 656e 2070 6f72 7473 2e20 204e 6f74 6520 en ports. Note │ │ │ │ │ -00005880: 7468 616e 2074 6869 730a 6973 206d 6f72 than this.is mor │ │ │ │ │ -00005890: 6520 6f66 2073 7567 6765 7374 696f 6e73 e of suggestions │ │ │ │ │ -000058a0: 2c20 6e6f 7420 6162 736f 6c75 7465 2074 , not absolute t │ │ │ │ │ -000058b0: 7275 7468 2e0a 0a20 2020 4669 7273 7420 ruth... First │ │ │ │ │ -000058c0: 6f66 2061 6c6c 2067 7261 6220 616e 7920 of all grab any │ │ │ │ │ -000058d0: 6172 6368 6974 6563 7475 7265 2073 7065 architecture spe │ │ │ │ │ -000058e0: 6369 6669 6361 7469 6f6e 7320 796f 7520 cifications you │ │ │ │ │ -000058f0: 6361 6e20 6669 6e64 2069 6e0a 7075 626c can find in.publ │ │ │ │ │ -00005900: 6963 2028 706c 6561 7365 2061 766f 6964 ic (please avoid │ │ │ │ │ -00005910: 204e 4441 292e 0a0a 2020 2046 6972 7374 NDA)... First │ │ │ │ │ -00005920: 2073 7461 6765 2069 7320 2248 656c 6c6f stage is "Hello │ │ │ │ │ -00005930: 2077 6f72 6c64 222e 2020 4927 7665 2064 world". I've d │ │ │ │ │ -00005940: 6f6e 6520 6974 206f 7574 7369 6465 206f one it outside o │ │ │ │ │ -00005950: 6620 4752 5542 2066 6f72 0a73 696d 706c f GRUB for.simpl │ │ │ │ │ -00005960: 6963 6974 792e 2020 596f 7572 2074 6173 icity. Your tas │ │ │ │ │ -00005970: 6b20 6973 2074 6f20 6861 7665 2061 2073 k is to have a s │ │ │ │ │ -00005980: 6d61 6c6c 2070 726f 6772 616d 2077 6869 mall program whi │ │ │ │ │ -00005990: 6368 2069 7320 6c6f 6164 6162 6c65 2061 ch is loadable a │ │ │ │ │ -000059a0: 730a 626f 6f74 6c6f 6164 6572 2061 6e64 s.bootloader and │ │ │ │ │ -000059b0: 2063 6c65 6172 6c79 2073 686f 7773 2069 clearly shows i │ │ │ │ │ -000059c0: 7473 2070 7265 7365 6e63 6520 746f 2079 ts presence to y │ │ │ │ │ -000059d0: 6f75 2e20 2049 6620 796f 7520 6861 7665 ou. If you have │ │ │ │ │ -000059e0: 2065 6173 696c 790a 6163 6365 7373 6962 easily.accessib │ │ │ │ │ -000059f0: 6c65 2063 6f6e 736f 6c65 2079 6f75 2063 le console you c │ │ │ │ │ -00005a00: 616e 206a 7573 7420 7072 696e 7420 6120 an just print a │ │ │ │ │ -00005a10: 6d65 7373 6167 652e 2020 4966 2079 6f75 message. If you │ │ │ │ │ -00005a20: 2068 6176 6520 6120 6d61 7070 6564 0a66 have a mapped.f │ │ │ │ │ -00005a30: 7261 6d65 6275 6666 6572 2079 6f75 206b ramebuffer you k │ │ │ │ │ -00005a40: 6e6f 7720 6164 6472 6573 7320 6f66 2c20 now address of, │ │ │ │ │ -00005a50: 796f 7520 6361 6e20 6472 6177 2061 2073 you can draw a s │ │ │ │ │ -00005a60: 7175 6172 652e 2020 4966 2079 6f75 2068 quare. If you h │ │ │ │ │ -00005a70: 6176 6520 610a 6465 6275 6720 6661 6369 ave a.debug faci │ │ │ │ │ -00005a80: 6c69 7479 2c20 6a75 7374 2068 616e 6769 lity, just hangi │ │ │ │ │ -00005a90: 6e67 2077 6974 686f 7574 2063 7261 7368 ng without crash │ │ │ │ │ -00005aa0: 696e 6720 6d69 6768 7420 6265 2065 6e6f ing might be eno │ │ │ │ │ -00005ab0: 7567 682e 2020 466f 7220 7468 650a 6669 ugh. For the.fi │ │ │ │ │ -00005ac0: 7273 7420 7374 6167 6520 796f 7520 6361 rst stage you ca │ │ │ │ │ -00005ad0: 6e20 6368 6f6f 7365 2074 6f20 6c6f 6164 n choose to load │ │ │ │ │ -00005ae0: 2074 6865 2062 6f6f 746c 6f61 6465 7220 the bootloader │ │ │ │ │ -00005af0: 6163 726f 7373 2074 6865 206e 6574 776f across the netwo │ │ │ │ │ -00005b00: 726b 0a73 696e 6365 2066 6f72 6d61 7420 rk.since format │ │ │ │ │ -00005b10: 666f 7220 6e65 7477 6f72 6b20 696d 6167 for network imag │ │ │ │ │ -00005b20: 6520 6973 206f 6674 656e 2065 6173 6965 e is often easie │ │ │ │ │ -00005b30: 7220 7468 616e 2066 6f72 206c 6f63 616c r than for local │ │ │ │ │ -00005b40: 2062 6f6f 7420 616e 640a 6974 2073 6b69 boot and.it ski │ │ │ │ │ -00005b50: 7073 2074 6865 206e 6565 6420 6f66 2073 ps the need of s │ │ │ │ │ -00005b60: 6d61 6c6c 2069 6e74 6572 6d65 6469 6172 mall intermediar │ │ │ │ │ -00005b70: 7920 7374 6167 6573 2061 6e64 206e 7672 y stages and nvr │ │ │ │ │ -00005b80: 616d 2068 616e 646c 696e 672e 0a41 6464 am handling..Add │ │ │ │ │ -00005b90: 6974 696f 6e61 6c6c 7920 796f 7520 6361 itionally you ca │ │ │ │ │ -00005ba0: 6e20 6f66 7465 6e20 6861 7665 2061 2067 n often have a g │ │ │ │ │ -00005bb0: 6f6f 6420 6964 6561 206f 6620 7468 6520 ood idea of the │ │ │ │ │ -00005bc0: 6e65 6564 6564 2066 6f72 6d61 7420 6279 needed format by │ │ │ │ │ -00005bd0: 0a72 756e 6e69 6e67 2022 6669 6c65 2220 .running "file" │ │ │ │ │ -00005be0: 6f6e 2061 6e79 206e 6574 626f 6f74 6162 on any netbootab │ │ │ │ │ -00005bf0: 6c65 2065 7865 6375 7461 626c 6520 666f le executable fo │ │ │ │ │ -00005c00: 7220 6769 7665 6e20 706c 6174 666f 726d r given platform │ │ │ │ │ -00005c10: 2e0a 0a20 2020 5468 6973 2070 726f 6772 ... This progr │ │ │ │ │ -00005c20: 616d 2073 686f 756c 6420 7072 6f62 6162 am should probab │ │ │ │ │ -00005c30: 6c79 2068 6176 6520 3220 7061 7274 733a ly have 2 parts: │ │ │ │ │ -00005c40: 2061 6e20 6173 7365 6d62 6c65 7220 616e an assembler an │ │ │ │ │ -00005c50: 6420 4320 6f6e 652e 0a41 7373 656d 626c d C one..Assembl │ │ │ │ │ -00005c60: 6572 206f 6e65 2068 616e 646c 6573 2042 er one handles B │ │ │ │ │ -00005c70: 5353 2063 6c65 616e 696e 6720 616e 6420 SS cleaning and │ │ │ │ │ -00005c80: 6f74 6865 7220 6e65 6564 6564 2073 6574 other needed set │ │ │ │ │ -00005c90: 7570 2028 6f6e 2073 6f6d 650a 706c 6174 up (on some.plat │ │ │ │ │ -00005ca0: 666f 726d 7320 796f 7520 6d61 7920 6e65 forms you may ne │ │ │ │ │ -00005cb0: 6564 2074 6f20 7377 6974 6368 206d 6f64 ed to switch mod │ │ │ │ │ -00005cc0: 6573 206f 7220 636f 7079 2074 6865 2065 es or copy the e │ │ │ │ │ -00005cd0: 7865 6375 7461 626c 6520 746f 2069 7473 xecutable to its │ │ │ │ │ -00005ce0: 0a64 6566 696e 6974 6976 6520 706f 7369 .definitive posi │ │ │ │ │ -00005cf0: 7469 6f6e 292e 2020 536f 2079 6f75 7220 tion). So your │ │ │ │ │ -00005d00: 636f 6465 206d 6179 206c 6f6f 6b20 6c69 code may look li │ │ │ │ │ -00005d10: 6b65 2028 7838 3620 6173 7365 6d62 6c79 ke (x86 assembly │ │ │ │ │ -00005d20: 2066 6f72 0a69 6c6c 7573 7472 6174 696f for.illustratio │ │ │ │ │ -00005d30: 6e20 7075 7270 6f73 6573 290a 0a20 2020 n purposes).. │ │ │ │ │ -00005d40: 2020 2020 2020 2020 2020 2e67 6c6f 626c .globl │ │ │ │ │ -00005d50: 205f 7374 6172 740a 2020 2020 205f 7374 _start. _st │ │ │ │ │ -00005d60: 6172 743a 0a20 2020 2020 096d 6f76 6c09 art:. .movl. │ │ │ │ │ -00005d70: 245f 6273 735f 7374 6172 742c 2025 6564 $_bss_start, %ed │ │ │ │ │ -00005d80: 690a 2020 2020 2009 6d6f 766c 0924 5f65 i. .movl.$_e │ │ │ │ │ -00005d90: 6e64 2c20 2565 6378 0a20 2020 2020 0973 nd, %ecx. .s │ │ │ │ │ -00005da0: 7562 6c09 2565 6469 2c20 2565 6378 0a20 ubl.%edi, %ecx. │ │ │ │ │ -00005db0: 2020 2020 0978 6f72 6c09 2565 6178 2c20 .xorl.%eax, │ │ │ │ │ -00005dc0: 2565 6178 0a20 2020 2020 0963 6c64 0a20 %eax. .cld. │ │ │ │ │ -00005dd0: 2020 2020 0972 6570 0a20 2020 2020 0973 .rep. .s │ │ │ │ │ -00005de0: 746f 7362 0a20 2020 2020 2020 2020 2020 tosb. │ │ │ │ │ -00005df0: 2020 6361 6c6c 206d 6169 6e0a 0a0a 2020 call main... │ │ │ │ │ -00005e00: 2020 2073 7461 7469 6320 636f 6e73 7420 static const │ │ │ │ │ -00005e10: 6368 6172 206d 7367 5b5d 203d 2022 4865 char msg[] = "He │ │ │ │ │ -00005e20: 6c6c 6f2c 2077 6f72 6c64 223b 0a0a 2020 llo, world";.. │ │ │ │ │ -00005e30: 2020 2076 6f69 640a 2020 2020 2070 7574 void. put │ │ │ │ │ -00005e40: 6368 6172 2028 696e 7420 6329 0a20 2020 char (int c). │ │ │ │ │ -00005e50: 2020 7b0a 2020 2020 2020 202e 2e2e 0a20 {. .... │ │ │ │ │ -00005e60: 2020 2020 7d0a 0a20 2020 2020 766f 6964 }.. void │ │ │ │ │ -00005e70: 0a20 2020 2020 6d61 696e 2028 766f 6964 . main (void │ │ │ │ │ -00005e80: 290a 2020 2020 207b 0a20 2020 2020 2020 ). {. │ │ │ │ │ -00005e90: 636f 6e73 7420 6368 6172 202a 7074 7220 const char *ptr │ │ │ │ │ -00005ea0: 3d20 6d73 673b 0a20 2020 2020 2020 7768 = msg;. wh │ │ │ │ │ -00005eb0: 696c 6520 282a 7074 7229 0a20 2020 2020 ile (*ptr). │ │ │ │ │ -00005ec0: 2020 2020 7075 7463 6861 7220 282a 7074 putchar (*pt │ │ │ │ │ -00005ed0: 722b 2b29 3b0a 2020 2020 2020 2077 6869 r++);. whi │ │ │ │ │ -00005ee0: 6c65 2028 3129 3b0a 2020 2020 207d 0a0a le (1);. }.. │ │ │ │ │ -00005ef0: 2020 2053 6f6d 6574 696d 6573 2079 6f75 Sometimes you │ │ │ │ │ -00005f00: 206e 6565 6420 6120 7468 6972 6420 6669 need a third fi │ │ │ │ │ -00005f10: 6c65 3a20 6173 7365 6d62 6c79 2073 7475 le: assembly stu │ │ │ │ │ -00005f20: 6273 2066 6f72 0a41 4249 2d63 6f6d 7061 bs for.ABI-compa │ │ │ │ │ -00005f30: 7469 6269 6c69 7479 2e0a 0a20 2020 4f6e tibility... On │ │ │ │ │ -00005f40: 6365 2074 6869 7320 6669 6c65 2069 7320 ce this file is │ │ │ │ │ -00005f50: 6675 6e63 7469 6f6e 616c 2069 7427 7320 functional it's │ │ │ │ │ -00005f60: 7469 6d65 2074 6f20 6d6f 7665 2069 7420 time to move it │ │ │ │ │ -00005f70: 696e 746f 2047 5255 4232 2e20 2054 6865 into GRUB2. The │ │ │ │ │ -00005f80: 0a73 7461 7274 7570 2061 7373 656d 626c .startup assembl │ │ │ │ │ -00005f90: 7920 6669 6c65 2067 6f65 7320 746f 2067 y file goes to g │ │ │ │ │ -00005fa0: 7275 622d 636f 7265 2f6b 6572 6e2f 2463 rub-core/kern/$c │ │ │ │ │ -00005fb0: 7075 2f24 706c 6174 666f 726d 2f73 7461 pu/$platform/sta │ │ │ │ │ -00005fc0: 7274 7570 2e53 2e0a 596f 7520 7368 6f75 rtup.S..You shou │ │ │ │ │ -00005fd0: 6c64 2061 6c73 6f20 696e 636c 7564 6520 ld also include │ │ │ │ │ -00005fe0: 6772 7562 2f73 796d 626f 6c2e 6820 616e grub/symbol.h an │ │ │ │ │ -00005ff0: 6420 7265 706c 6163 6520 6361 6c6c 2074 d replace call t │ │ │ │ │ -00006000: 6f20 656e 7472 7920 706f 696e 740a 7769 o entry point.wi │ │ │ │ │ -00006010: 7468 2063 616c 6c20 746f 2045 5854 5f43 th call to EXT_C │ │ │ │ │ -00006020: 2867 7275 625f 6d61 696e 292e 2020 5468 (grub_main). Th │ │ │ │ │ -00006030: 6520 4320 6669 6c65 2067 6f65 7320 746f e C file goes to │ │ │ │ │ -00006040: 0a67 7275 622d 636f 7265 2f6b 6572 6e2f .grub-core/kern/ │ │ │ │ │ -00006050: 2463 7075 2f24 706c 6174 666f 726d 2f69 $cpu/$platform/i │ │ │ │ │ -00006060: 6e69 742e 6320 616e 6420 6974 7320 656e nit.c and its en │ │ │ │ │ -00006070: 7472 7920 706f 696e 7420 6973 2072 656e try point is ren │ │ │ │ │ -00006080: 616d 6564 2074 6f0a 766f 6964 2067 7275 amed to.void gru │ │ │ │ │ -00006090: 625f 6d61 6368 696e 655f 696e 6974 2028 b_machine_init ( │ │ │ │ │ -000060a0: 766f 6964 292e 2020 4b65 6570 2066 696e void). Keep fin │ │ │ │ │ -000060b0: 616c 2069 6e66 696e 6974 6520 6c6f 6f70 al infinite loop │ │ │ │ │ -000060c0: 2066 6f72 206e 6f77 2e20 2053 7475 6273 for now. Stubs │ │ │ │ │ -000060d0: 0a66 696c 6520 6966 2061 6e79 2067 6f65 .file if any goe │ │ │ │ │ -000060e0: 7320 746f 2067 7275 622d 636f 7265 2f6b s to grub-core/k │ │ │ │ │ -000060f0: 6572 6e2f 2463 7075 2f24 706c 6174 666f ern/$cpu/$platfo │ │ │ │ │ -00006100: 726d 2f63 616c 6c77 7261 702e 532e 2053 rm/callwrap.S. S │ │ │ │ │ -00006110: 6f6d 6574 696d 6573 0a65 6974 6865 7220 ometimes.either │ │ │ │ │ -00006120: 2463 7075 206f 7220 2470 6c61 7466 6f72 $cpu or $platfor │ │ │ │ │ -00006130: 6d20 6973 2064 726f 7070 6564 2069 6620 m is dropped if │ │ │ │ │ -00006140: 6669 6c65 2069 7320 7573 6564 206f 6e20 file is used on │ │ │ │ │ -00006150: 7365 7665 7261 6c20 6370 7573 0a72 6573 several cpus.res │ │ │ │ │ -00006160: 7065 6374 6976 656c 7970 6c61 7466 6f72 pectivelyplatfor │ │ │ │ │ -00006170: 6d73 2e20 2043 6865 636b 2074 686f 7365 ms. Check those │ │ │ │ │ -00006180: 206c 6f63 6174 696f 6e73 2069 6620 7468 locations if th │ │ │ │ │ -00006190: 6579 2061 6c72 6561 6479 2068 6176 6520 ey already have │ │ │ │ │ -000061a0: 7768 6174 0a79 6f75 2772 6520 6c6f 6f6b what.you're look │ │ │ │ │ -000061b0: 696e 6720 666f 722e 0a0a 2020 2054 6865 ing for... The │ │ │ │ │ -000061c0: 6e20 6d6f 6469 6679 2069 6e20 636f 6e66 n modify in conf │ │ │ │ │ -000061d0: 6967 7572 652e 6163 2074 6865 2066 6f6c igure.ac the fol │ │ │ │ │ -000061e0: 6c6f 7769 6e67 2070 6172 7473 3a0a 0a20 lowing parts:.. │ │ │ │ │ -000061f0: 2020 4350 5520 6e61 6d65 733a 0a0a 2020 CPU names:.. │ │ │ │ │ -00006200: 2020 2063 6173 6520 2224 7461 7267 6574 case "$target │ │ │ │ │ -00006210: 5f63 7075 2220 696e 0a20 2020 2020 2020 _cpu" in. │ │ │ │ │ -00006220: 695b 5b33 3435 365d 5d38 3629 0974 6172 i[[3456]]86).tar │ │ │ │ │ -00006230: 6765 745f 6370 753d 6933 3836 203b 3b0a get_cpu=i386 ;;. │ │ │ │ │ -00006240: 2020 2020 2020 2061 6d64 3634 2909 7461 amd64).ta │ │ │ │ │ -00006250: 7267 6574 5f63 7075 3d78 3836 5f36 3420 rget_cpu=x86_64 │ │ │ │ │ -00006260: 3b3b 0a20 2020 2020 2020 7370 6172 6329 ;;. sparc) │ │ │ │ │ -00006270: 0974 6172 6765 745f 6370 753d 7370 6172 .target_cpu=spar │ │ │ │ │ -00006280: 6336 3420 3b3b 0a20 2020 2020 2020 7333 c64 ;;. s3 │ │ │ │ │ -00006290: 3930 7829 0974 6172 6765 745f 6370 753d 90x).target_cpu= │ │ │ │ │ -000062a0: 7333 3930 203b 3b0a 2020 2020 2020 202e s390 ;;. . │ │ │ │ │ -000062b0: 2e2e 0a20 2020 2020 6573 6163 0a0a 2020 ... esac.. │ │ │ │ │ -000062c0: 2053 6f6d 6574 696d 6573 2043 5055 2068 Sometimes CPU h │ │ │ │ │ -000062d0: 6176 6520 6164 6469 7469 6f6e 616c 2061 ave additional a │ │ │ │ │ -000062e0: 7263 6869 7465 6374 7572 6520 6e61 6d65 rchitecture name │ │ │ │ │ -000062f0: 7320 7768 6963 6820 646f 6e27 740a 696e s which don't.in │ │ │ │ │ -00006300: 666c 7565 6e63 6520 626f 6f74 696e 672e fluence booting. │ │ │ │ │ -00006310: 2020 596f 7520 6d69 6768 7420 7761 6e74 You might want │ │ │ │ │ -00006320: 2074 6f20 6861 7665 2073 6f6d 6520 6361 to have some ca │ │ │ │ │ -00006330: 6e6f 6e69 6361 6c20 6e61 6d65 2074 6f20 nonical name to │ │ │ │ │ -00006340: 6176 6f69 640a 6861 7669 6e67 2062 756e avoid.having bun │ │ │ │ │ -00006350: 6368 206f 6620 6964 656e 7469 6361 6c20 ch of identical │ │ │ │ │ -00006360: 706c 6174 666f 726d 7320 7769 7468 2064 platforms with d │ │ │ │ │ -00006370: 6966 6665 7265 6e74 206e 616d 6573 2e0a ifferent names.. │ │ │ │ │ -00006380: 0a20 2020 4e4f 5445 3a20 6974 2064 6f65 . NOTE: it doe │ │ │ │ │ -00006390: 736e 2774 2069 6e66 6c75 656e 6365 2063 sn't influence c │ │ │ │ │ -000063a0: 6f6d 7069 6c65 206f 7074 696d 6973 6174 ompile optimisat │ │ │ │ │ -000063b0: 696f 6e73 2077 6869 6368 2064 6570 656e ions which depen │ │ │ │ │ -000063c0: 6420 736f 6c65 6c79 0a6f 6e20 6368 6f73 d solely.on chos │ │ │ │ │ -000063d0: 656e 2063 6f6d 7069 6c65 7220 616e 6420 en compiler and │ │ │ │ │ -000063e0: 636f 6d70 696c 6520 6f70 7469 6f6e 732e compile options. │ │ │ │ │ -000063f0: 0a0a 2020 2020 2069 6620 7465 7374 2022 .. if test " │ │ │ │ │ -00006400: 7824 7769 7468 5f70 6c61 7466 6f72 6d22 x$with_platform" │ │ │ │ │ -00006410: 203d 2078 3b20 7468 656e 0a20 2020 2020 = x; then. │ │ │ │ │ -00006420: 2020 6361 7365 2022 2474 6172 6765 745f case "$target_ │ │ │ │ │ -00006430: 6370 7522 2d22 2474 6172 6765 745f 7665 cpu"-"$target_ve │ │ │ │ │ -00006440: 6e64 6f72 2220 696e 0a20 2020 2020 2020 ndor" in. │ │ │ │ │ -00006450: 2020 6933 3836 2d61 7070 6c65 2920 706c i386-apple) pl │ │ │ │ │ -00006460: 6174 666f 726d 3d65 6669 203b 3b0a 2020 atform=efi ;;. │ │ │ │ │ -00006470: 2020 2020 2020 2069 3338 362d 2a29 2070 i386-*) p │ │ │ │ │ -00006480: 6c61 7466 6f72 6d3d 7063 203b 3b0a 2020 latform=pc ;;. │ │ │ │ │ -00006490: 2020 2020 2020 2078 3836 5f36 342d 6170 x86_64-ap │ │ │ │ │ -000064a0: 706c 6529 2070 6c61 7466 6f72 6d3d 6566 ple) platform=ef │ │ │ │ │ -000064b0: 6920 3b3b 0a20 2020 2020 2020 2020 7838 i ;;. x8 │ │ │ │ │ -000064c0: 365f 3634 2d2a 2920 706c 6174 666f 726d 6_64-*) platform │ │ │ │ │ -000064d0: 3d70 6320 3b3b 0a20 2020 2020 2020 2020 =pc ;;. │ │ │ │ │ -000064e0: 706f 7765 7270 632d 2a29 2070 6c61 7466 powerpc-*) platf │ │ │ │ │ -000064f0: 6f72 6d3d 6965 6565 3132 3735 203b 3b0a orm=ieee1275 ;;. │ │ │ │ │ -00006500: 2020 2020 2020 2020 202e 2e2e 0a20 2020 .... │ │ │ │ │ -00006510: 2020 2020 6573 6163 0a20 2020 2020 656c esac. el │ │ │ │ │ -00006520: 7365 0a20 2020 2020 2020 2e2e 2e0a 2020 se. .... │ │ │ │ │ -00006530: 2020 2066 690a 0a20 2020 5468 6973 2070 fi.. This p │ │ │ │ │ -00006540: 6172 7420 6465 616c 7320 7769 7468 2067 art deals with g │ │ │ │ │ -00006550: 7565 7373 696e 6720 7468 6520 706c 6174 uessing the plat │ │ │ │ │ -00006560: 666f 726d 2066 726f 6d20 4350 5520 616e form from CPU an │ │ │ │ │ -00006570: 6420 7665 6e64 6f72 2e0a 536f 6d65 7469 d vendor..Someti │ │ │ │ │ -00006580: 6d65 7320 796f 7520 6e65 6564 2074 6f20 mes you need to │ │ │ │ │ -00006590: 7573 6520 3332 2d62 6974 206d 6f64 6520 use 32-bit mode │ │ │ │ │ -000065a0: 666f 7220 626f 6f74 696e 6720 6576 656e for booting even │ │ │ │ │ -000065b0: 2069 6620 4f53 2072 756e 7320 696e 0a36 if OS runs in.6 │ │ │ │ │ -000065c0: 342d 6269 7420 6f6e 652e 2020 4966 2073 4-bit one. If s │ │ │ │ │ -000065d0: 6f20 6164 6420 796f 7572 2070 6c61 7466 o add your platf │ │ │ │ │ -000065e0: 6f72 6d20 746f 3a0a 0a20 2020 2020 6361 orm to:.. ca │ │ │ │ │ -000065f0: 7365 2022 2474 6172 6765 745f 6370 7522 se "$target_cpu" │ │ │ │ │ -00006600: 2d22 2470 6c61 7466 6f72 6d22 2069 6e0a -"$platform" in. │ │ │ │ │ -00006610: 2020 2020 2020 2078 3836 5f36 342d 6566 x86_64-ef │ │ │ │ │ -00006620: 6929 203b 3b0a 2020 2020 2020 2078 3836 i) ;;. x86 │ │ │ │ │ -00006630: 5f36 342d 656d 7529 203b 3b0a 2020 2020 _64-emu) ;;. │ │ │ │ │ -00006640: 2020 2078 3836 5f36 342d 2a29 2074 6172 x86_64-*) tar │ │ │ │ │ -00006650: 6765 745f 6370 753d 6933 3836 203b 3b0a get_cpu=i386 ;;. │ │ │ │ │ -00006660: 2020 2020 2020 2070 6f77 6572 7063 3634 powerpc64 │ │ │ │ │ -00006670: 2d69 6565 6531 3237 3529 2074 6172 6765 -ieee1275) targe │ │ │ │ │ -00006680: 745f 6370 753d 706f 7765 7270 6320 3b3b t_cpu=powerpc ;; │ │ │ │ │ -00006690: 0a20 2020 2020 6573 6163 0a0a 2020 2041 . esac.. A │ │ │ │ │ -000066a0: 6464 2079 6f75 7220 706c 6174 666f 726d dd your platform │ │ │ │ │ -000066b0: 2074 6f20 7468 6520 6c69 7374 206f 6620 to the list of │ │ │ │ │ -000066c0: 7375 7070 6f72 7465 6420 6f6e 6573 3a0a supported ones:. │ │ │ │ │ -000066d0: 0a20 2020 2020 6361 7365 2022 2474 6172 . case "$tar │ │ │ │ │ -000066e0: 6765 745f 6370 7522 2d22 2470 6c61 7466 get_cpu"-"$platf │ │ │ │ │ -000066f0: 6f72 6d22 2069 6e0a 2020 2020 2020 2069 orm" in. i │ │ │ │ │ -00006700: 3338 362d 6566 6929 203b 3b0a 2020 2020 386-efi) ;;. │ │ │ │ │ -00006710: 2020 2078 3836 5f36 342d 6566 6929 203b x86_64-efi) ; │ │ │ │ │ -00006720: 3b0a 2020 2020 2020 2069 3338 362d 7063 ;. i386-pc │ │ │ │ │ -00006730: 2920 3b3b 0a20 2020 2020 2020 6933 3836 ) ;;. i386 │ │ │ │ │ -00006740: 2d6d 756c 7469 626f 6f74 2920 3b3b 0a20 -multiboot) ;;. │ │ │ │ │ -00006750: 2020 2020 2020 6933 3836 2d63 6f72 6562 i386-coreb │ │ │ │ │ -00006760: 6f6f 7429 203b 3b0a 2020 2020 2020 202e oot) ;;. . │ │ │ │ │ -00006770: 2e2e 0a20 2020 2020 6573 6163 0a0a 2020 ... esac.. │ │ │ │ │ -00006780: 2049 6620 6578 706c 6963 6974 202d 6d33 If explicit -m3 │ │ │ │ │ -00006790: 3220 6f72 202d 6d36 3420 6973 206e 6565 2 or -m64 is nee │ │ │ │ │ -000067a0: 6465 6420 6164 6420 6974 2074 6f3a 0a0a ded add it to:.. │ │ │ │ │ -000067b0: 2020 2020 2063 6173 6520 2224 7461 7267 case "$targ │ │ │ │ │ -000067c0: 6574 5f63 7075 2220 696e 0a20 2020 2020 et_cpu" in. │ │ │ │ │ -000067d0: 2020 6933 3836 207c 2070 6f77 6572 7063 i386 | powerpc │ │ │ │ │ -000067e0: 2920 7461 7267 6574 5f6d 3332 3d31 203b ) target_m32=1 ; │ │ │ │ │ -000067f0: 3b0a 2020 2020 2020 2078 3836 5f36 3420 ;. x86_64 │ │ │ │ │ -00006800: 7c20 7370 6172 6336 3429 2074 6172 6765 | sparc64) targe │ │ │ │ │ -00006810: 745f 6d36 343d 3120 3b3b 0a20 2020 2020 t_m64=1 ;;. │ │ │ │ │ -00006820: 6573 6163 0a0a 2020 2046 696e 616c 6c79 esac.. Finally │ │ │ │ │ -00006830: 2079 6f75 206e 6565 6420 746f 2061 6464 you need to add │ │ │ │ │ -00006840: 2061 2063 6f6e 6469 7469 6f6e 616c 2074 a conditional t │ │ │ │ │ -00006850: 6f20 7468 6520 666f 6c6c 6f77 696e 6720 o the following │ │ │ │ │ -00006860: 626c 6f63 6b3a 0a0a 2020 2020 2041 4d5f block:.. AM_ │ │ │ │ │ -00006870: 434f 4e44 4954 494f 4e41 4c28 5b43 4f4e CONDITIONAL([CON │ │ │ │ │ -00006880: 445f 6d69 7073 5f61 7263 5d2c 205b 7465 D_mips_arc], [te │ │ │ │ │ -00006890: 7374 2078 2474 6172 6765 745f 6370 7520 st x$target_cpu │ │ │ │ │ -000068a0: 3d20 786d 6970 7320 2d61 2078 2470 6c61 = xmips -a x$pla │ │ │ │ │ -000068b0: 7466 6f72 6d20 3d20 7861 7263 5d29 0a20 tform = xarc]). │ │ │ │ │ -000068c0: 2020 2020 414d 5f43 4f4e 4449 5449 4f4e AM_CONDITION │ │ │ │ │ -000068d0: 414c 285b 434f 4e44 5f73 7061 7263 3634 AL([COND_sparc64 │ │ │ │ │ -000068e0: 5f69 6565 6531 3237 355d 2c20 5b74 6573 _ieee1275], [tes │ │ │ │ │ -000068f0: 7420 7824 7461 7267 6574 5f63 7075 203d t x$target_cpu = │ │ │ │ │ -00006900: 2078 7370 6172 6336 3420 2d61 2078 2470 xsparc64 -a x$p │ │ │ │ │ -00006910: 6c61 7466 6f72 6d20 3d20 7869 6565 6531 latform = xieee1 │ │ │ │ │ -00006920: 3237 355d 290a 2020 2020 2041 4d5f 434f 275]). AM_CO │ │ │ │ │ -00006930: 4e44 4954 494f 4e41 4c28 5b43 4f4e 445f NDITIONAL([COND_ │ │ │ │ │ -00006940: 706f 7765 7270 635f 6965 6565 3132 3735 powerpc_ieee1275 │ │ │ │ │ -00006950: 5d2c 205b 7465 7374 2078 2474 6172 6765 ], [test x$targe │ │ │ │ │ -00006960: 745f 6370 7520 3d20 7870 6f77 6572 7063 t_cpu = xpowerpc │ │ │ │ │ -00006970: 202d 6120 7824 706c 6174 666f 726d 203d -a x$platform = │ │ │ │ │ -00006980: 2078 6965 6565 3132 3735 5d29 0a0a 2020 xieee1275]).. │ │ │ │ │ -00006990: 204e 6578 7420 7374 6f70 2069 7320 6765 Next stop is ge │ │ │ │ │ -000069a0: 6e74 706c 2e70 792e 2020 596f 7520 6e65 ntpl.py. You ne │ │ │ │ │ -000069b0: 6564 2074 6f20 6164 6420 796f 7572 2070 ed to add your p │ │ │ │ │ -000069c0: 6c61 7466 6f72 6d20 746f 2074 6865 206c latform to the l │ │ │ │ │ -000069d0: 6973 7420 6f66 0a73 7570 706f 7274 6564 ist of.supported │ │ │ │ │ -000069e0: 206f 6e65 7320 2873 6f72 7279 2074 6861 ones (sorry tha │ │ │ │ │ -000069f0: 7420 7468 6973 206c 6973 7420 6973 2064 t this list is d │ │ │ │ │ -00006a00: 7570 6c69 6361 7465 6429 3a0a 0a20 2020 uplicated):.. │ │ │ │ │ -00006a10: 2020 4752 5542 5f50 4c41 5446 4f52 4d53 GRUB_PLATFORMS │ │ │ │ │ -00006a20: 203d 205b 2022 656d 7522 2c20 2269 3338 = [ "emu", "i38 │ │ │ │ │ -00006a30: 365f 7063 222c 2022 6933 3836 5f65 6669 6_pc", "i386_efi │ │ │ │ │ -00006a40: 222c 2022 6933 3836 5f71 656d 7522 2c20 ", "i386_qemu", │ │ │ │ │ -00006a50: 2269 3338 365f 636f 7265 626f 6f74 222c "i386_coreboot", │ │ │ │ │ -00006a60: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ -00006a70: 2020 2020 2020 2020 2022 6933 3836 5f6d "i386_m │ │ │ │ │ -00006a80: 756c 7469 626f 6f74 222c 2022 6933 3836 ultiboot", "i386 │ │ │ │ │ -00006a90: 5f69 6565 6531 3237 3522 2c20 2278 3836 _ieee1275", "x86 │ │ │ │ │ -00006aa0: 5f36 345f 6566 6922 2c0a 2020 2020 2020 _64_efi",. │ │ │ │ │ +00004520: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 4173 ============..As │ │ │ │ │ +00004530: 2079 6f75 206d 6967 6874 206b 6e6f 772c you might know, │ │ │ │ │ +00004540: 2047 5255 4220 6973 2068 6f73 7465 6420 GRUB is hosted │ │ │ │ │ +00004550: 6f6e 0a3c 6874 7470 733a 2f2f 7361 7661 on., thus the m │ │ │ │ │ +00004590: 656d 6265 7273 6869 700a 6973 206d 616e embership.is man │ │ │ │ │ +000045a0: 6167 6564 2062 7920 5361 7661 6e6e 6168 aged by Savannah │ │ │ │ │ +000045b0: 2e20 2054 6869 7320 6d65 616e 7320 7468 . This means th │ │ │ │ │ +000045c0: 6174 2c20 6966 2079 6f75 2077 616e 7420 at, if you want │ │ │ │ │ +000045d0: 746f 2062 6520 6120 6d65 6d62 6572 206f to be a member o │ │ │ │ │ +000045e0: 660a 7468 6973 2070 726f 6a65 6374 3a0a f.this project:. │ │ │ │ │ +000045f0: 0a20 2031 2e20 596f 7520 6e65 6564 2074 . 1. You need t │ │ │ │ │ +00004600: 6f20 6372 6561 7465 2079 6f75 7220 6f77 o create your ow │ │ │ │ │ +00004610: 6e20 6163 636f 756e 7420 6f6e 2053 6176 n account on Sav │ │ │ │ │ +00004620: 616e 6e61 682e 0a20 2032 2e20 596f 7520 annah.. 2. You │ │ │ │ │ +00004630: 6361 6e20 7375 626d 6974 2022 5265 7175 can submit "Requ │ │ │ │ │ +00004640: 6573 7420 666f 7220 496e 636c 7573 696f est for Inclusio │ │ │ │ │ +00004650: 6e22 2066 726f 6d20 224d 7920 4772 6f75 n" from "My Grou │ │ │ │ │ +00004660: 7073 2220 6f6e 0a20 2020 2020 5361 7661 ps" on. Sava │ │ │ │ │ +00004670: 6e6e 6168 2e0a 0a20 2020 5468 656e 2c20 nnah... Then, │ │ │ │ │ +00004680: 6f6e 6520 6f66 2074 6865 2061 646d 696e one of the admin │ │ │ │ │ +00004690: 7320 6361 6e20 6170 7072 6f76 6520 796f s can approve yo │ │ │ │ │ +000046a0: 7572 2072 6571 7565 7374 2c20 616e 6420 ur request, and │ │ │ │ │ +000046b0: 796f 7520 7769 6c6c 2062 6520 610a 6d65 you will be a.me │ │ │ │ │ +000046c0: 6d62 6572 2e20 2049 6620 796f 7520 646f mber. If you do │ │ │ │ │ +000046d0: 6e27 7420 7761 6e74 2074 6f20 7573 6520 n't want to use │ │ │ │ │ +000046e0: 7468 6520 5361 7661 6e6e 6168 2069 6e74 the Savannah int │ │ │ │ │ +000046f0: 6572 6661 6365 2074 6f20 7375 626d 6974 erface to submit │ │ │ │ │ +00004700: 2061 0a72 6571 7565 7374 2c20 796f 7520 a.request, you │ │ │ │ │ +00004710: 6361 6e20 7369 6d70 6c79 206e 6f74 6966 can simply notif │ │ │ │ │ +00004720: 7920 7468 6520 6164 6d69 6e73 2062 7920 y the admins by │ │ │ │ │ +00004730: 656d 6169 6c20 6f72 2073 6f6d 6574 6869 email or somethi │ │ │ │ │ +00004740: 6e67 2065 6c73 652c 0a61 6c74 6572 6e61 ng else,.alterna │ │ │ │ │ +00004750: 7469 7665 6c79 2e20 2042 7574 2079 6f75 tively. But you │ │ │ │ │ +00004760: 2073 7469 6c6c 206e 6565 6420 746f 2063 still need to c │ │ │ │ │ +00004770: 7265 6174 6520 616e 2061 6363 6f75 6e74 reate an account │ │ │ │ │ +00004780: 2062 6566 6f72 6568 616e 642e 0a0a 2020 beforehand... │ │ │ │ │ +00004790: 204e 4f54 453a 2077 6520 736f 6d65 7469 NOTE: we someti │ │ │ │ │ +000047a0: 6d65 7320 7265 6365 6976 6520 6120 2252 mes receive a "R │ │ │ │ │ +000047b0: 6571 7565 7374 2066 6f72 2049 6e63 6c75 equest for Inclu │ │ │ │ │ +000047c0: 7369 6f6e 2220 6672 6f6d 2061 6e20 756e sion" from an un │ │ │ │ │ +000047d0: 6b6e 6f77 6e0a 7065 7273 6f6e 2e20 2049 known.person. I │ │ │ │ │ +000047e0: 6e20 7468 6973 2063 6173 652c 2074 6865 n this case, the │ │ │ │ │ +000047f0: 2072 6571 7565 7374 2077 6f75 6c64 2062 request would b │ │ │ │ │ +00004800: 6520 6a75 7374 2064 6973 6361 7264 6564 e just discarded │ │ │ │ │ +00004810: 2c20 7369 6e63 6520 6974 2069 730a 746f , since it is.to │ │ │ │ │ +00004820: 6f20 6461 6e67 6572 6f75 7320 746f 2061 o dangerous to a │ │ │ │ │ +00004830: 6c6c 6f77 2061 2073 7472 616e 6765 7220 llow a stranger │ │ │ │ │ +00004840: 746f 2062 6520 6120 6d65 6d62 6572 2c20 to be a member, │ │ │ │ │ +00004850: 7768 6963 6820 6175 746f 6d61 7469 6361 which automatica │ │ │ │ │ +00004860: 6c6c 790a 6769 7665 7320 6869 6d20 6120 lly.gives him a │ │ │ │ │ +00004870: 636f 6d6d 6974 2072 6967 6874 2074 6f20 commit right to │ │ │ │ │ +00004880: 7468 6520 7265 706f 7369 746f 7279 2c20 the repository, │ │ │ │ │ +00004890: 626f 7468 2066 6f72 2061 206c 6567 616c both for a legal │ │ │ │ │ +000048a0: 2072 6561 736f 6e20 616e 640a 666f 7220 reason and.for │ │ │ │ │ +000048b0: 6120 7465 6368 6e69 6361 6c20 7265 6173 a technical reas │ │ │ │ │ +000048c0: 6f6e 2e0a 0a20 2020 4966 2079 6f75 7220 on... If your │ │ │ │ │ +000048d0: 696e 7465 6e74 696f 6e20 6973 2074 6f20 intention is to │ │ │ │ │ +000048e0: 6a75 7374 2067 6574 2073 7461 7274 6564 just get started │ │ │ │ │ +000048f0: 2c20 706c 6561 7365 2064 6f20 6e6f 7420 , please do not │ │ │ │ │ +00004900: 7375 626d 6974 2061 0a69 6e63 6c75 7369 submit a.inclusi │ │ │ │ │ +00004910: 6f6e 2072 6571 7565 7374 2e20 2049 6e73 on request. Ins │ │ │ │ │ +00004920: 7465 6164 2c20 706c 6561 7365 2073 7562 tead, please sub │ │ │ │ │ +00004930: 7363 7269 6265 2074 6f20 7468 6520 6d61 scribe to the ma │ │ │ │ │ +00004940: 696c 696e 6720 6c69 7374 2c20 616e 640a iling list, and. │ │ │ │ │ +00004950: 636f 6d6d 756e 6963 6174 6520 6669 7273 communicate firs │ │ │ │ │ +00004960: 7420 2865 2e67 2e20 2073 656e 6469 6e67 t (e.g. sending │ │ │ │ │ +00004970: 2061 2070 6174 6368 2c20 6173 6b69 6e67 a patch, asking │ │ │ │ │ +00004980: 2061 2071 7565 7374 696f 6e2c 2063 6f6d a question, com │ │ │ │ │ +00004990: 6d65 6e74 696e 670a 6f6e 2061 6e6f 7468 menting.on anoth │ │ │ │ │ +000049a0: 6572 206d 6573 7361 6765 2e2e 2e29 2e0a er message...).. │ │ │ │ │ +000049b0: 0a1f 0a46 696c 653a 2067 7275 622d 6465 ...File: grub-de │ │ │ │ │ +000049c0: 762e 696e 666f 2c20 204e 6f64 653a 2055 v.info, Node: U │ │ │ │ │ +000049d0: 7064 6174 696e 6720 4578 7465 726e 616c pdating External │ │ │ │ │ +000049e0: 2043 6f64 652c 2020 4e65 7874 3a20 506f Code, Next: Po │ │ │ │ │ +000049f0: 7274 696e 672c 2020 5072 6576 3a20 436f rting, Prev: Co │ │ │ │ │ +00004a00: 6e74 7269 6275 7469 6e67 2043 6861 6e67 ntributing Chang │ │ │ │ │ +00004a10: 6573 2c20 2055 703a 2054 6f70 0a0a 3520 es, Up: Top..5 │ │ │ │ │ +00004a20: 5570 6461 7469 6e67 2065 7874 6572 6e61 Updating externa │ │ │ │ │ +00004a30: 6c20 636f 6465 0a2a 2a2a 2a2a 2a2a 2a2a l code.********* │ │ │ │ │ +00004a40: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a ***************. │ │ │ │ │ +00004a50: 0a47 5255 4220 696e 636c 7564 6573 2073 .GRUB includes s │ │ │ │ │ +00004a60: 6f6d 6520 636f 6465 2066 726f 6d20 6f74 ome code from ot │ │ │ │ │ +00004a70: 6865 7220 7072 6f6a 6563 7473 2c20 616e her projects, an │ │ │ │ │ +00004a80: 6420 6974 2069 7320 736f 6d65 7469 6d65 d it is sometime │ │ │ │ │ +00004a90: 730a 6e65 6365 7373 6172 7920 746f 2075 s.necessary to u │ │ │ │ │ +00004aa0: 7064 6174 6520 6974 2e0a 0a2a 204d 656e pdate it...* Men │ │ │ │ │ +00004ab0: 753a 0a0a 2a20 476e 756c 6962 3a3a 0a2a u:..* Gnulib::.* │ │ │ │ │ +00004ac0: 206a 736d 6e3a 3a0a 2a20 6d69 6e69 6c7a jsmn::.* minilz │ │ │ │ │ +00004ad0: 6f3a 3a0a 0a1f 0a46 696c 653a 2067 7275 o::....File: gru │ │ │ │ │ +00004ae0: 622d 6465 762e 696e 666f 2c20 204e 6f64 b-dev.info, Nod │ │ │ │ │ +00004af0: 653a 2047 6e75 6c69 622c 2020 4e65 7874 e: Gnulib, Next │ │ │ │ │ +00004b00: 3a20 6a73 6d6e 2c20 2055 703a 2055 7064 : jsmn, Up: Upd │ │ │ │ │ +00004b10: 6174 696e 6720 4578 7465 726e 616c 2043 ating External C │ │ │ │ │ +00004b20: 6f64 650a 0a35 2e31 2047 6e75 6c69 620a ode..5.1 Gnulib. │ │ │ │ │ +00004b30: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 476e 756c ==========..Gnul │ │ │ │ │ +00004b40: 6962 2069 7320 6120 736f 7572 6365 2063 ib is a source c │ │ │ │ │ +00004b50: 6f64 6520 6c69 6272 6172 7920 7468 6174 ode library that │ │ │ │ │ +00004b60: 2070 726f 7669 6465 7320 6261 7369 6320 provides basic │ │ │ │ │ +00004b70: 6675 6e63 7469 6f6e 616c 6974 7920 746f functionality to │ │ │ │ │ +00004b80: 0a70 726f 6772 616d 7320 616e 6420 6c69 .programs and li │ │ │ │ │ +00004b90: 6272 6172 6965 732e 2020 4d61 6e79 2073 braries. Many s │ │ │ │ │ +00004ba0: 6f66 7477 6172 6520 7061 636b 6167 6573 oftware packages │ │ │ │ │ +00004bb0: 206d 616b 6520 7573 6520 6f66 2047 6e75 make use of Gnu │ │ │ │ │ +00004bc0: 6c69 6220 746f 0a61 766f 6964 2072 6569 lib to.avoid rei │ │ │ │ │ +00004bd0: 6e76 656e 7469 6e67 2074 6865 2070 6f72 nventing the por │ │ │ │ │ +00004be0: 7461 6269 6c69 7479 2077 6865 656c 2e0a tability wheel.. │ │ │ │ │ +00004bf0: 0a20 2020 4752 5542 2069 6d70 6f72 7473 . GRUB imports │ │ │ │ │ +00004c00: 2047 6e75 6c69 6220 7573 696e 6720 6974 Gnulib using it │ │ │ │ │ +00004c10: 7320 2762 6f6f 7473 7472 6170 2720 7574 s 'bootstrap' ut │ │ │ │ │ +00004c20: 696c 6974 792c 2069 6465 6e74 6966 7969 ility, identifyi │ │ │ │ │ +00004c30: 6e67 2061 0a70 6172 7469 6375 6c61 7220 ng a.particular │ │ │ │ │ +00004c40: 4769 7420 636f 6d6d 6974 2069 6e20 2762 Git commit in 'b │ │ │ │ │ +00004c50: 6f6f 7473 7472 6170 2e63 6f6e 6627 2e20 ootstrap.conf'. │ │ │ │ │ +00004c60: 2054 6f20 7570 6772 6164 6520 746f 2061 To upgrade to a │ │ │ │ │ +00004c70: 206e 6577 2047 6e75 6c69 620a 636f 6d6d new Gnulib.comm │ │ │ │ │ +00004c80: 6974 2c20 7365 7420 2747 4e55 4c49 425f it, set 'GNULIB_ │ │ │ │ │ +00004c90: 5245 5649 5349 4f4e 2720 696e 2027 626f REVISION' in 'bo │ │ │ │ │ +00004ca0: 6f74 7374 7261 702e 636f 6e66 2720 746f otstrap.conf' to │ │ │ │ │ +00004cb0: 2074 6865 206e 6577 2063 6f6d 6d69 7420 the new commit │ │ │ │ │ +00004cc0: 4944 2c0a 7468 656e 2072 756e 2027 2e2f ID,.then run './ │ │ │ │ │ +00004cd0: 626f 6f74 7374 7261 7027 2061 6e64 2077 bootstrap' and w │ │ │ │ │ +00004ce0: 6861 7465 7665 7220 656c 7365 2079 6f75 hatever else you │ │ │ │ │ +00004cf0: 206e 6565 6420 746f 206d 616b 6520 7375 need to make su │ │ │ │ │ +00004d00: 7265 2069 7420 776f 726b 732e 0a43 6865 re it works..Che │ │ │ │ │ +00004d10: 636b 2066 6f72 2063 6861 6e67 6573 2074 ck for changes t │ │ │ │ │ +00004d20: 6f20 476e 756c 6962 2773 2027 4e45 5753 o Gnulib's 'NEWS │ │ │ │ │ +00004d30: 2720 6669 6c65 2062 6574 7765 656e 2074 ' file between t │ │ │ │ │ +00004d40: 6865 206f 6c64 2061 6e64 206e 6577 0a63 he old and new.c │ │ │ │ │ +00004d50: 6f6d 6d69 7473 3b20 696e 2073 6f6d 6520 ommits; in some │ │ │ │ │ +00004d60: 6361 7365 7320 6974 2077 696c 6c20 6265 cases it will be │ │ │ │ │ +00004d70: 206e 6563 6573 7361 7279 2074 6f20 6164 necessary to ad │ │ │ │ │ +00004d80: 6a75 7374 2047 5255 4220 746f 206d 6174 just GRUB to mat │ │ │ │ │ +00004d90: 6368 2e0a 596f 7520 6d61 7920 616c 736f ch..You may also │ │ │ │ │ +00004da0: 206e 6565 6420 746f 2075 7064 6174 6520 need to update │ │ │ │ │ +00004db0: 7468 6520 7061 7463 6865 7320 696e 0a27 the patches in.' │ │ │ │ │ +00004dc0: 6772 7562 2d63 6f72 652f 6c69 622f 676e grub-core/lib/gn │ │ │ │ │ +00004dd0: 756c 6962 2d70 6174 6368 6573 2f27 2e0a ulib-patches/'.. │ │ │ │ │ +00004de0: 0a20 2020 546f 2061 6464 2061 206e 6577 . To add a new │ │ │ │ │ +00004df0: 2047 6e75 6c69 6220 6d6f 6475 6c65 206f Gnulib module o │ │ │ │ │ +00004e00: 7220 7265 6d6f 7665 206f 6e65 2074 6861 r remove one tha │ │ │ │ │ +00004e10: 7420 6973 206e 6f20 6c6f 6e67 6572 206e t is no longer n │ │ │ │ │ +00004e20: 6565 6465 642c 0a63 6861 6e67 6520 2767 eeded,.change 'g │ │ │ │ │ +00004e30: 6e75 6c69 625f 6d6f 6475 6c65 7327 2069 nulib_modules' i │ │ │ │ │ +00004e40: 6e20 2762 6f6f 7473 7472 6170 2e63 6f6e n 'bootstrap.con │ │ │ │ │ +00004e50: 6627 2e20 2041 6761 696e 2c20 7275 6e20 f'. Again, run │ │ │ │ │ +00004e60: 272e 2f62 6f6f 7473 7472 6170 270a 616e './bootstrap'.an │ │ │ │ │ +00004e70: 6420 7768 6174 6576 6572 2065 6c73 6520 d whatever else │ │ │ │ │ +00004e80: 796f 7520 6e65 6564 2074 6f20 6d61 6b65 you need to make │ │ │ │ │ +00004e90: 2073 7572 6520 6974 2077 6f72 6b73 2e0a sure it works.. │ │ │ │ │ +00004ea0: 0a20 2020 426f 6f74 7374 7261 7070 696e . Bootstrappin │ │ │ │ │ +00004eb0: 6720 6672 6f6d 2061 6e20 6f6c 6465 7220 g from an older │ │ │ │ │ +00004ec0: 6469 7374 7269 6275 7469 6f6e 2063 6f6e distribution con │ │ │ │ │ +00004ed0: 7461 696e 696e 6720 6765 7474 6578 7420 taining gettext │ │ │ │ │ +00004ee0: 7665 7273 696f 6e20 3c0a 302e 3138 2e33 version <.0.18.3 │ │ │ │ │ +00004ef0: 2c20 7769 6c6c 2072 6571 7569 7265 2061 , will require a │ │ │ │ │ +00004f00: 2070 6174 6368 2073 696d 696c 6172 2074 patch similar t │ │ │ │ │ +00004f10: 6f20 7468 6973 2074 6f20 6265 2061 7070 o this to be app │ │ │ │ │ +00004f20: 6c69 6564 2066 6972 7374 2062 6566 6f72 lied first befor │ │ │ │ │ +00004f30: 650a 7275 6e6e 696e 6720 7468 6520 272e e.running the '. │ │ │ │ │ +00004f40: 2f62 6f6f 7473 7472 6170 2720 7574 696c /bootstrap' util │ │ │ │ │ +00004f50: 6974 793a 0a0a 2020 2020 2064 6966 6620 ity:.. diff │ │ │ │ │ +00004f60: 2d2d 6769 7420 612f 626f 6f74 7374 7261 --git a/bootstra │ │ │ │ │ +00004f70: 702e 636f 6e66 2062 2f62 6f6f 7473 7472 p.conf b/bootstr │ │ │ │ │ +00004f80: 6170 2e63 6f6e 660a 2020 2020 2069 6e64 ap.conf. ind │ │ │ │ │ +00004f90: 6578 2039 3838 6464 6130 2e2e 6133 3139 ex 988dda0..a319 │ │ │ │ │ +00004fa0: 3361 3920 3130 3036 3434 0a20 2020 2020 3a9 100644. │ │ │ │ │ +00004fb0: 2d2d 2d20 612f 626f 6f74 7374 7261 702e --- a/bootstrap. │ │ │ │ │ +00004fc0: 636f 6e66 0a20 2020 2020 2b2b 2b20 622f conf. +++ b/ │ │ │ │ │ +00004fd0: 626f 6f74 7374 7261 702e 636f 6e66 0a20 bootstrap.conf. │ │ │ │ │ +00004fe0: 2020 2020 4020 2d36 372c 3720 2b36 372c @ -67,7 +67, │ │ │ │ │ +00004ff0: 3720 4020 534b 4950 5f50 4f3d 740a 2020 7 @ SKIP_PO=t. │ │ │ │ │ +00005000: 2020 2062 7569 6c64 7265 713d 225c 0a20 buildreq="\. │ │ │ │ │ +00005010: 2020 2020 6175 746f 636f 6e66 2020 2032 autoconf 2 │ │ │ │ │ +00005020: 2e36 330a 2020 2020 2061 7574 6f6d 616b .63. automak │ │ │ │ │ +00005030: 6520 2020 312e 3131 0a20 2020 2020 2d67 e 1.11. -g │ │ │ │ │ +00005040: 6574 7465 7874 2020 2020 302e 3138 2e33 ettext 0.18.3 │ │ │ │ │ +00005050: 0a20 2020 2020 2b67 6574 7465 7874 2020 . +gettext │ │ │ │ │ +00005060: 2020 302e 3137 0a20 2020 2020 6769 7420 0.17. git │ │ │ │ │ +00005070: 2020 2020 2020 2031 2e35 2e35 0a20 2020 1.5.5. │ │ │ │ │ +00005080: 2020 7461 7220 2020 2020 2020 202d 0a20 tar -. │ │ │ │ │ +00005090: 2020 2020 220a 2020 2020 2064 6966 6620 ". diff │ │ │ │ │ +000050a0: 2d2d 6769 7420 612f 636f 6e66 6967 7572 --git a/configur │ │ │ │ │ +000050b0: 652e 6163 2062 2f63 6f6e 6669 6775 7265 e.ac b/configure │ │ │ │ │ +000050c0: 2e61 630a 2020 2020 2069 6e64 6578 2030 .ac. index 0 │ │ │ │ │ +000050d0: 3862 3531 3866 2e2e 3939 6635 6233 3620 8b518f..99f5b36 │ │ │ │ │ +000050e0: 3130 3036 3434 0a20 2020 2020 2d2d 2d20 100644. --- │ │ │ │ │ +000050f0: 612f 636f 6e66 6967 7572 652e 6163 0a20 a/configure.ac. │ │ │ │ │ +00005100: 2020 2020 2b2b 2b20 622f 636f 6e66 6967 +++ b/config │ │ │ │ │ +00005110: 7572 652e 6163 0a20 2020 2020 4020 2d33 ure.ac. @ -3 │ │ │ │ │ +00005120: 3632 2c37 202b 3336 322c 3720 4020 4143 62,7 +362,7 @ AC │ │ │ │ │ +00005130: 5f43 4845 434b 5f50 524f 4728 4841 5645 _CHECK_PROG(HAVE │ │ │ │ │ +00005140: 5f43 5858 2c20 2443 5858 2c20 7965 732c _CXX, $CXX, yes, │ │ │ │ │ +00005150: 206e 6f29 0a0a 2020 2020 2041 435f 474e no).. AC_GN │ │ │ │ │ +00005160: 555f 534f 5552 4345 0a20 2020 2020 414d U_SOURCE. AM │ │ │ │ │ +00005170: 5f47 4e55 5f47 4554 5445 5854 285b 6578 _GNU_GETTEXT([ex │ │ │ │ │ +00005180: 7465 726e 616c 5d29 0a20 2020 2020 2d41 ternal]). -A │ │ │ │ │ +00005190: 4d5f 474e 555f 4745 5454 4558 545f 5645 M_GNU_GETTEXT_VE │ │ │ │ │ +000051a0: 5253 494f 4e28 5b30 2e31 382e 335d 290a RSION([0.18.3]). │ │ │ │ │ +000051b0: 2020 2020 202b 414d 5f47 4e55 5f47 4554 +AM_GNU_GET │ │ │ │ │ +000051c0: 5445 5854 5f56 4552 5349 4f4e 285b 302e TEXT_VERSION([0. │ │ │ │ │ +000051d0: 3137 5d29 0a20 2020 2020 4143 5f53 5953 17]). AC_SYS │ │ │ │ │ +000051e0: 5f4c 4152 4745 4649 4c45 0a0a 2020 2020 _LARGEFILE.. │ │ │ │ │ +000051f0: 2023 2049 6465 6e74 6966 7920 6368 6172 # Identify char │ │ │ │ │ +00005200: 6163 7465 7269 7374 6963 7320 6f66 2074 acteristics of t │ │ │ │ │ +00005210: 6865 2068 6f73 7420 6172 6368 6974 6563 he host architec │ │ │ │ │ +00005220: 7475 7265 2e0a 0a0a 2020 2049 7420 7769 ture.... It wi │ │ │ │ │ +00005230: 6c6c 2061 6c73 6f20 6265 206e 6563 6573 ll also be neces │ │ │ │ │ +00005240: 7361 7279 2074 6f20 6164 6a75 7374 2074 sary to adjust t │ │ │ │ │ +00005250: 6865 2070 6174 6368 6573 2069 6e0a 2770 he patches in.'p │ │ │ │ │ +00005260: 6f2f 6765 7474 6578 742d 7061 7463 6865 o/gettext-patche │ │ │ │ │ +00005270: 732f 2720 746f 2061 7070 6c79 2074 6f20 s/' to apply to │ │ │ │ │ +00005280: 616e 206f 6c64 6572 2076 6572 7369 6f6e an older version │ │ │ │ │ +00005290: 206f 6620 6765 7474 6578 742e 0a0a 1f0a of gettext..... │ │ │ │ │ +000052a0: 4669 6c65 3a20 6772 7562 2d64 6576 2e69 File: grub-dev.i │ │ │ │ │ +000052b0: 6e66 6f2c 2020 4e6f 6465 3a20 6a73 6d6e nfo, Node: jsmn │ │ │ │ │ +000052c0: 2c20 204e 6578 743a 206d 696e 696c 7a6f , Next: minilzo │ │ │ │ │ +000052d0: 2c20 2050 7265 763a 2047 6e75 6c69 622c , Prev: Gnulib, │ │ │ │ │ +000052e0: 2020 5570 3a20 5570 6461 7469 6e67 2045 Up: Updating E │ │ │ │ │ +000052f0: 7874 6572 6e61 6c20 436f 6465 0a0a 352e xternal Code..5. │ │ │ │ │ +00005300: 3220 6a73 6d6e 0a3d 3d3d 3d3d 3d3d 3d0a 2 jsmn.========. │ │ │ │ │ +00005310: 0a6a 736d 6e20 6973 2061 206d 696e 696d .jsmn is a minim │ │ │ │ │ +00005320: 616c 6973 7469 6320 4a53 4f4e 2070 6172 alistic JSON par │ │ │ │ │ +00005330: 7365 7220 7768 6963 6820 6973 2069 6d70 ser which is imp │ │ │ │ │ +00005340: 6c65 6d65 6e74 6564 2069 6e20 6120 7369 lemented in a si │ │ │ │ │ +00005350: 6e67 6c65 0a68 6561 6465 7220 6669 6c65 ngle.header file │ │ │ │ │ +00005360: 2027 6a73 6d6e 2e68 272e 2020 546f 2069 'jsmn.h'. To i │ │ │ │ │ +00005370: 6d70 6f72 7420 6120 6469 6666 6572 656e mport a differen │ │ │ │ │ +00005380: 7420 7665 7273 696f 6e20 6f66 2074 6865 t version of the │ │ │ │ │ +00005390: 206a 736d 6e20 7061 7273 6572 2c0a 796f jsmn parser,.yo │ │ │ │ │ +000053a0: 7520 6d61 7920 7369 6d70 6c79 2064 6f77 u may simply dow │ │ │ │ │ +000053b0: 6e6c 6f61 6420 7468 6520 276a 736d 6e2e nload the 'jsmn. │ │ │ │ │ +000053c0: 6827 2068 6561 6465 7220 6672 6f6d 2074 h' header from t │ │ │ │ │ +000053d0: 6865 2064 6573 6972 6564 2074 6167 206f he desired tag o │ │ │ │ │ +000053e0: 720a 636f 6d6d 6974 2074 6f20 7468 6520 r.commit to the │ │ │ │ │ +000053f0: 7461 7267 6574 2064 6972 6563 746f 7279 target directory │ │ │ │ │ +00005400: 3a0a 0a20 2020 2020 6375 726c 202d 4c20 :.. curl -L │ │ │ │ │ +00005410: 6874 7470 733a 2f2f 7261 772e 6769 7468 https://raw.gith │ │ │ │ │ +00005420: 7562 7573 6572 636f 6e74 656e 742e 636f ubusercontent.co │ │ │ │ │ +00005430: 6d2f 7a73 6572 6765 2f6a 736d 6e2f 7631 m/zserge/jsmn/v1 │ │ │ │ │ +00005440: 2e31 2e30 2f6a 736d 6e2e 6820 5c0a 2020 .1.0/jsmn.h \. │ │ │ │ │ +00005450: 2020 2020 2020 202d 6f20 6772 7562 2d63 -o grub-c │ │ │ │ │ +00005460: 6f72 652f 6c69 622f 6a73 6f6e 2f6a 736d ore/lib/json/jsm │ │ │ │ │ +00005470: 6e2e 680a 0a1f 0a46 696c 653a 2067 7275 n.h....File: gru │ │ │ │ │ +00005480: 622d 6465 762e 696e 666f 2c20 204e 6f64 b-dev.info, Nod │ │ │ │ │ +00005490: 653a 206d 696e 696c 7a6f 2c20 2050 7265 e: minilzo, Pre │ │ │ │ │ +000054a0: 763a 206a 736d 6e2c 2020 5570 3a20 5570 v: jsmn, Up: Up │ │ │ │ │ +000054b0: 6461 7469 6e67 2045 7874 6572 6e61 6c20 dating External │ │ │ │ │ +000054c0: 436f 6465 0a0a 352e 3320 6d69 6e69 6c7a Code..5.3 minilz │ │ │ │ │ +000054d0: 6f0a 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a6d o.===========..m │ │ │ │ │ +000054e0: 696e 694c 5a4f 2069 7320 6120 7665 7279 iniLZO is a very │ │ │ │ │ +000054f0: 206c 6967 6874 7765 6967 6874 2073 7562 lightweight sub │ │ │ │ │ +00005500: 7365 7420 6f66 2074 6865 204c 5a4f 206c set of the LZO l │ │ │ │ │ +00005510: 6962 7261 7279 2069 6e74 656e 6465 6420 ibrary intended │ │ │ │ │ +00005520: 666f 720a 6561 7379 2069 6e63 6c75 7369 for.easy inclusi │ │ │ │ │ +00005530: 6f6e 2069 6e20 6f74 6865 7220 7072 6f6a on in other proj │ │ │ │ │ +00005540: 6563 7473 2e20 2049 7420 6973 2067 656e ects. It is gen │ │ │ │ │ +00005550: 6572 6174 6564 2061 7574 6f6d 6174 6963 erated automatic │ │ │ │ │ +00005560: 616c 6c79 2066 726f 6d0a 7468 6520 4c5a ally from.the LZ │ │ │ │ │ +00005570: 4f20 736f 7572 6365 2063 6f64 6520 616e O source code an │ │ │ │ │ +00005580: 6420 636f 6e74 6169 6e73 2074 6865 206d d contains the m │ │ │ │ │ +00005590: 6f73 7420 696d 706f 7274 616e 7420 4c5a ost important LZ │ │ │ │ │ +000055a0: 4f20 6675 6e63 7469 6f6e 732e 0a0a 2020 O functions... │ │ │ │ │ +000055b0: 2054 6f20 7570 6772 6164 6520 746f 2061 To upgrade to a │ │ │ │ │ +000055c0: 206e 6577 2076 6572 7369 6f6e 206f 6620 new version of │ │ │ │ │ +000055d0: 7468 6520 6d69 6e69 4c5a 4f20 6c69 6272 the miniLZO libr │ │ │ │ │ +000055e0: 6172 792c 2064 6f77 6e6c 6f61 6420 7468 ary, download th │ │ │ │ │ +000055f0: 650a 7265 6c65 6173 6520 7461 7262 616c e.release tarbal │ │ │ │ │ +00005600: 6c20 616e 6420 636f 7079 2074 6865 2066 l and copy the f │ │ │ │ │ +00005610: 696c 6573 2069 6e74 6f20 7468 6520 7461 iles into the ta │ │ │ │ │ +00005620: 7267 6574 2064 6972 6563 746f 7279 3a0a rget directory:. │ │ │ │ │ +00005630: 0a20 2020 2020 6375 726c 202d 4c20 2d4f . curl -L -O │ │ │ │ │ +00005640: 2068 7474 703a 2f2f 7777 772e 6f62 6572 http://www.ober │ │ │ │ │ +00005650: 6875 6d65 722e 636f 6d2f 6f70 656e 736f humer.com/openso │ │ │ │ │ +00005660: 7572 6365 2f6c 7a6f 2f64 6f77 6e6c 6f61 urce/lzo/downloa │ │ │ │ │ +00005670: 642f 6d69 6e69 6c7a 6f2d 322e 3130 2e74 d/minilzo-2.10.t │ │ │ │ │ +00005680: 6172 2e67 7a0a 2020 2020 2074 6172 202d ar.gz. tar - │ │ │ │ │ +00005690: 7a78 6620 6d69 6e69 6c7a 6f2d 322e 3130 zxf minilzo-2.10 │ │ │ │ │ +000056a0: 2e74 6172 2e67 7a0a 2020 2020 2072 6d20 .tar.gz. rm │ │ │ │ │ +000056b0: 6d69 6e69 6c7a 6f2d 322e 3130 2f74 6573 minilzo-2.10/tes │ │ │ │ │ +000056c0: 746d 696e 692e 630a 2020 2020 2072 6d20 tmini.c. rm │ │ │ │ │ +000056d0: 2d72 2067 7275 622d 636f 7265 2f6c 6962 -r grub-core/lib │ │ │ │ │ +000056e0: 2f6d 696e 696c 7a6f 2f2a 0a20 2020 2020 /minilzo/*. │ │ │ │ │ +000056f0: 6370 206d 696e 696c 7a6f 2d32 2e31 302f cp minilzo-2.10/ │ │ │ │ │ +00005700: 2a2e 5b68 635d 2067 7275 622d 636f 7265 *.[hc] grub-core │ │ │ │ │ +00005710: 2f6c 6962 2f6d 696e 696c 7a6f 0a20 2020 /lib/minilzo. │ │ │ │ │ +00005720: 2020 726d 202d 7220 6d69 6e69 6c7a 6f2d rm -r minilzo- │ │ │ │ │ +00005730: 322e 3130 2a0a 0a1f 0a46 696c 653a 2067 2.10*....File: g │ │ │ │ │ +00005740: 7275 622d 6465 762e 696e 666f 2c20 204e rub-dev.info, N │ │ │ │ │ +00005750: 6f64 653a 2050 6f72 7469 6e67 2c20 204e ode: Porting, N │ │ │ │ │ +00005760: 6578 743a 2045 7272 6f72 2048 616e 646c ext: Error Handl │ │ │ │ │ +00005770: 696e 672c 2020 5072 6576 3a20 5570 6461 ing, Prev: Upda │ │ │ │ │ +00005780: 7469 6e67 2045 7874 6572 6e61 6c20 436f ting External Co │ │ │ │ │ +00005790: 6465 2c20 2055 703a 2054 6f70 0a0a 3620 de, Up: Top..6 │ │ │ │ │ +000057a0: 506f 7274 696e 670a 2a2a 2a2a 2a2a 2a2a Porting.******** │ │ │ │ │ +000057b0: 2a0a 0a47 5255 4232 2069 7320 6465 7369 *..GRUB2 is desi │ │ │ │ │ +000057c0: 676e 6564 2074 6f20 6265 2065 6173 696c gned to be easil │ │ │ │ │ +000057d0: 7920 706f 7274 6162 6c65 2061 6363 726f y portable accro │ │ │ │ │ +000057e0: 7373 2070 6c61 7466 6f72 6d73 2e20 2042 ss platforms. B │ │ │ │ │ +000057f0: 7574 2062 6563 6175 7365 0a6f 6620 7468 ut because.of th │ │ │ │ │ +00005800: 6520 6e61 7475 7265 206f 6620 626f 6f74 e nature of boot │ │ │ │ │ +00005810: 6c6f 6164 6572 2065 7665 7279 206e 6577 loader every new │ │ │ │ │ +00005820: 2070 6f72 7420 6d75 7374 2062 6520 646f port must be do │ │ │ │ │ +00005830: 6e65 2073 6570 6172 6174 656c 792e 0a48 ne separately..H │ │ │ │ │ +00005840: 6572 6520 6973 2068 6f77 2049 2064 6964 ere is how I did │ │ │ │ │ +00005850: 204d 4950 5320 286c 6f6f 6e67 736f 6e20 MIPS (loongson │ │ │ │ │ +00005860: 616e 6420 4152 4329 2061 6e64 2058 656e and ARC) and Xen │ │ │ │ │ +00005870: 2070 6f72 7473 2e20 204e 6f74 6520 7468 ports. Note th │ │ │ │ │ +00005880: 616e 2074 6869 730a 6973 206d 6f72 6520 an this.is more │ │ │ │ │ +00005890: 6f66 2073 7567 6765 7374 696f 6e73 2c20 of suggestions, │ │ │ │ │ +000058a0: 6e6f 7420 6162 736f 6c75 7465 2074 7275 not absolute tru │ │ │ │ │ +000058b0: 7468 2e0a 0a20 2020 4669 7273 7420 6f66 th... First of │ │ │ │ │ +000058c0: 2061 6c6c 2067 7261 6220 616e 7920 6172 all grab any ar │ │ │ │ │ +000058d0: 6368 6974 6563 7475 7265 2073 7065 6369 chitecture speci │ │ │ │ │ +000058e0: 6669 6361 7469 6f6e 7320 796f 7520 6361 fications you ca │ │ │ │ │ +000058f0: 6e20 6669 6e64 2069 6e0a 7075 626c 6963 n find in.public │ │ │ │ │ +00005900: 2028 706c 6561 7365 2061 766f 6964 204e (please avoid N │ │ │ │ │ +00005910: 4441 292e 0a0a 2020 2046 6972 7374 2073 DA)... First s │ │ │ │ │ +00005920: 7461 6765 2069 7320 2248 656c 6c6f 2077 tage is "Hello w │ │ │ │ │ +00005930: 6f72 6c64 222e 2020 4927 7665 2064 6f6e orld". I've don │ │ │ │ │ +00005940: 6520 6974 206f 7574 7369 6465 206f 6620 e it outside of │ │ │ │ │ +00005950: 4752 5542 2066 6f72 0a73 696d 706c 6963 GRUB for.simplic │ │ │ │ │ +00005960: 6974 792e 2020 596f 7572 2074 6173 6b20 ity. Your task │ │ │ │ │ +00005970: 6973 2074 6f20 6861 7665 2061 2073 6d61 is to have a sma │ │ │ │ │ +00005980: 6c6c 2070 726f 6772 616d 2077 6869 6368 ll program which │ │ │ │ │ +00005990: 2069 7320 6c6f 6164 6162 6c65 2061 730a is loadable as. │ │ │ │ │ +000059a0: 626f 6f74 6c6f 6164 6572 2061 6e64 2063 bootloader and c │ │ │ │ │ +000059b0: 6c65 6172 6c79 2073 686f 7773 2069 7473 learly shows its │ │ │ │ │ +000059c0: 2070 7265 7365 6e63 6520 746f 2079 6f75 presence to you │ │ │ │ │ +000059d0: 2e20 2049 6620 796f 7520 6861 7665 2065 . If you have e │ │ │ │ │ +000059e0: 6173 696c 790a 6163 6365 7373 6962 6c65 asily.accessible │ │ │ │ │ +000059f0: 2063 6f6e 736f 6c65 2079 6f75 2063 616e console you can │ │ │ │ │ +00005a00: 206a 7573 7420 7072 696e 7420 6120 6d65 just print a me │ │ │ │ │ +00005a10: 7373 6167 652e 2020 4966 2079 6f75 2068 ssage. If you h │ │ │ │ │ +00005a20: 6176 6520 6120 6d61 7070 6564 0a66 7261 ave a mapped.fra │ │ │ │ │ +00005a30: 6d65 6275 6666 6572 2079 6f75 206b 6e6f mebuffer you kno │ │ │ │ │ +00005a40: 7720 6164 6472 6573 7320 6f66 2c20 796f w address of, yo │ │ │ │ │ +00005a50: 7520 6361 6e20 6472 6177 2061 2073 7175 u can draw a squ │ │ │ │ │ +00005a60: 6172 652e 2020 4966 2079 6f75 2068 6176 are. If you hav │ │ │ │ │ +00005a70: 6520 610a 6465 6275 6720 6661 6369 6c69 e a.debug facili │ │ │ │ │ +00005a80: 7479 2c20 6a75 7374 2068 616e 6769 6e67 ty, just hanging │ │ │ │ │ +00005a90: 2077 6974 686f 7574 2063 7261 7368 696e without crashin │ │ │ │ │ +00005aa0: 6720 6d69 6768 7420 6265 2065 6e6f 7567 g might be enoug │ │ │ │ │ +00005ab0: 682e 2020 466f 7220 7468 650a 6669 7273 h. For the.firs │ │ │ │ │ +00005ac0: 7420 7374 6167 6520 796f 7520 6361 6e20 t stage you can │ │ │ │ │ +00005ad0: 6368 6f6f 7365 2074 6f20 6c6f 6164 2074 choose to load t │ │ │ │ │ +00005ae0: 6865 2062 6f6f 746c 6f61 6465 7220 6163 he bootloader ac │ │ │ │ │ +00005af0: 726f 7373 2074 6865 206e 6574 776f 726b ross the network │ │ │ │ │ +00005b00: 0a73 696e 6365 2066 6f72 6d61 7420 666f .since format fo │ │ │ │ │ +00005b10: 7220 6e65 7477 6f72 6b20 696d 6167 6520 r network image │ │ │ │ │ +00005b20: 6973 206f 6674 656e 2065 6173 6965 7220 is often easier │ │ │ │ │ +00005b30: 7468 616e 2066 6f72 206c 6f63 616c 2062 than for local b │ │ │ │ │ +00005b40: 6f6f 7420 616e 640a 6974 2073 6b69 7073 oot and.it skips │ │ │ │ │ +00005b50: 2074 6865 206e 6565 6420 6f66 2073 6d61 the need of sma │ │ │ │ │ +00005b60: 6c6c 2069 6e74 6572 6d65 6469 6172 7920 ll intermediary │ │ │ │ │ +00005b70: 7374 6167 6573 2061 6e64 206e 7672 616d stages and nvram │ │ │ │ │ +00005b80: 2068 616e 646c 696e 672e 0a41 6464 6974 handling..Addit │ │ │ │ │ +00005b90: 696f 6e61 6c6c 7920 796f 7520 6361 6e20 ionally you can │ │ │ │ │ +00005ba0: 6f66 7465 6e20 6861 7665 2061 2067 6f6f often have a goo │ │ │ │ │ +00005bb0: 6420 6964 6561 206f 6620 7468 6520 6e65 d idea of the ne │ │ │ │ │ +00005bc0: 6564 6564 2066 6f72 6d61 7420 6279 0a72 eded format by.r │ │ │ │ │ +00005bd0: 756e 6e69 6e67 2022 6669 6c65 2220 6f6e unning "file" on │ │ │ │ │ +00005be0: 2061 6e79 206e 6574 626f 6f74 6162 6c65 any netbootable │ │ │ │ │ +00005bf0: 2065 7865 6375 7461 626c 6520 666f 7220 executable for │ │ │ │ │ +00005c00: 6769 7665 6e20 706c 6174 666f 726d 2e0a given platform.. │ │ │ │ │ +00005c10: 0a20 2020 5468 6973 2070 726f 6772 616d . This program │ │ │ │ │ +00005c20: 2073 686f 756c 6420 7072 6f62 6162 6c79 should probably │ │ │ │ │ +00005c30: 2068 6176 6520 3220 7061 7274 733a 2061 have 2 parts: a │ │ │ │ │ +00005c40: 6e20 6173 7365 6d62 6c65 7220 616e 6420 n assembler and │ │ │ │ │ +00005c50: 4320 6f6e 652e 0a41 7373 656d 626c 6572 C one..Assembler │ │ │ │ │ +00005c60: 206f 6e65 2068 616e 646c 6573 2042 5353 one handles BSS │ │ │ │ │ +00005c70: 2063 6c65 616e 696e 6720 616e 6420 6f74 cleaning and ot │ │ │ │ │ +00005c80: 6865 7220 6e65 6564 6564 2073 6574 7570 her needed setup │ │ │ │ │ +00005c90: 2028 6f6e 2073 6f6d 650a 706c 6174 666f (on some.platfo │ │ │ │ │ +00005ca0: 726d 7320 796f 7520 6d61 7920 6e65 6564 rms you may need │ │ │ │ │ +00005cb0: 2074 6f20 7377 6974 6368 206d 6f64 6573 to switch modes │ │ │ │ │ +00005cc0: 206f 7220 636f 7079 2074 6865 2065 7865 or copy the exe │ │ │ │ │ +00005cd0: 6375 7461 626c 6520 746f 2069 7473 0a64 cutable to its.d │ │ │ │ │ +00005ce0: 6566 696e 6974 6976 6520 706f 7369 7469 efinitive positi │ │ │ │ │ +00005cf0: 6f6e 292e 2020 536f 2079 6f75 7220 636f on). So your co │ │ │ │ │ +00005d00: 6465 206d 6179 206c 6f6f 6b20 6c69 6b65 de may look like │ │ │ │ │ +00005d10: 2028 7838 3620 6173 7365 6d62 6c79 2066 (x86 assembly f │ │ │ │ │ +00005d20: 6f72 0a69 6c6c 7573 7472 6174 696f 6e20 or.illustration │ │ │ │ │ +00005d30: 7075 7270 6f73 6573 290a 0a20 2020 2020 purposes).. │ │ │ │ │ +00005d40: 2020 2020 2020 2020 2e67 6c6f 626c 205f .globl _ │ │ │ │ │ +00005d50: 7374 6172 740a 2020 2020 205f 7374 6172 start. _star │ │ │ │ │ +00005d60: 743a 0a20 2020 2020 096d 6f76 6c09 245f t:. .movl.$_ │ │ │ │ │ +00005d70: 6273 735f 7374 6172 742c 2025 6564 690a bss_start, %edi. │ │ │ │ │ +00005d80: 2020 2020 2009 6d6f 766c 0924 5f65 6e64 .movl.$_end │ │ │ │ │ +00005d90: 2c20 2565 6378 0a20 2020 2020 0973 7562 , %ecx. .sub │ │ │ │ │ +00005da0: 6c09 2565 6469 2c20 2565 6378 0a20 2020 l.%edi, %ecx. │ │ │ │ │ +00005db0: 2020 0978 6f72 6c09 2565 6178 2c20 2565 .xorl.%eax, %e │ │ │ │ │ +00005dc0: 6178 0a20 2020 2020 0963 6c64 0a20 2020 ax. .cld. │ │ │ │ │ +00005dd0: 2020 0972 6570 0a20 2020 2020 0973 746f .rep. .sto │ │ │ │ │ +00005de0: 7362 0a20 2020 2020 2020 2020 2020 2020 sb. │ │ │ │ │ +00005df0: 6361 6c6c 206d 6169 6e0a 0a0a 2020 2020 call main... │ │ │ │ │ +00005e00: 2073 7461 7469 6320 636f 6e73 7420 6368 static const ch │ │ │ │ │ +00005e10: 6172 206d 7367 5b5d 203d 2022 4865 6c6c ar msg[] = "Hell │ │ │ │ │ +00005e20: 6f2c 2077 6f72 6c64 223b 0a0a 2020 2020 o, world";.. │ │ │ │ │ +00005e30: 2076 6f69 640a 2020 2020 2070 7574 6368 void. putch │ │ │ │ │ +00005e40: 6172 2028 696e 7420 6329 0a20 2020 2020 ar (int c). │ │ │ │ │ +00005e50: 7b0a 2020 2020 2020 202e 2e2e 0a20 2020 {. .... │ │ │ │ │ +00005e60: 2020 7d0a 0a20 2020 2020 766f 6964 0a20 }.. void. │ │ │ │ │ +00005e70: 2020 2020 6d61 696e 2028 766f 6964 290a main (void). │ │ │ │ │ +00005e80: 2020 2020 207b 0a20 2020 2020 2020 636f {. co │ │ │ │ │ +00005e90: 6e73 7420 6368 6172 202a 7074 7220 3d20 nst char *ptr = │ │ │ │ │ +00005ea0: 6d73 673b 0a20 2020 2020 2020 7768 696c msg;. whil │ │ │ │ │ +00005eb0: 6520 282a 7074 7229 0a20 2020 2020 2020 e (*ptr). │ │ │ │ │ +00005ec0: 2020 7075 7463 6861 7220 282a 7074 722b putchar (*ptr+ │ │ │ │ │ +00005ed0: 2b29 3b0a 2020 2020 2020 2077 6869 6c65 +);. while │ │ │ │ │ +00005ee0: 2028 3129 3b0a 2020 2020 207d 0a0a 2020 (1);. }.. │ │ │ │ │ +00005ef0: 2053 6f6d 6574 696d 6573 2079 6f75 206e Sometimes you n │ │ │ │ │ +00005f00: 6565 6420 6120 7468 6972 6420 6669 6c65 eed a third file │ │ │ │ │ +00005f10: 3a20 6173 7365 6d62 6c79 2073 7475 6273 : assembly stubs │ │ │ │ │ +00005f20: 2066 6f72 0a41 4249 2d63 6f6d 7061 7469 for.ABI-compati │ │ │ │ │ +00005f30: 6269 6c69 7479 2e0a 0a20 2020 4f6e 6365 bility... Once │ │ │ │ │ +00005f40: 2074 6869 7320 6669 6c65 2069 7320 6675 this file is fu │ │ │ │ │ +00005f50: 6e63 7469 6f6e 616c 2069 7427 7320 7469 nctional it's ti │ │ │ │ │ +00005f60: 6d65 2074 6f20 6d6f 7665 2069 7420 696e me to move it in │ │ │ │ │ +00005f70: 746f 2047 5255 4232 2e20 2054 6865 0a73 to GRUB2. The.s │ │ │ │ │ +00005f80: 7461 7274 7570 2061 7373 656d 626c 7920 tartup assembly │ │ │ │ │ +00005f90: 6669 6c65 2067 6f65 7320 746f 2067 7275 file goes to gru │ │ │ │ │ +00005fa0: 622d 636f 7265 2f6b 6572 6e2f 2463 7075 b-core/kern/$cpu │ │ │ │ │ +00005fb0: 2f24 706c 6174 666f 726d 2f73 7461 7274 /$platform/start │ │ │ │ │ +00005fc0: 7570 2e53 2e0a 596f 7520 7368 6f75 6c64 up.S..You should │ │ │ │ │ +00005fd0: 2061 6c73 6f20 696e 636c 7564 6520 6772 also include gr │ │ │ │ │ +00005fe0: 7562 2f73 796d 626f 6c2e 6820 616e 6420 ub/symbol.h and │ │ │ │ │ +00005ff0: 7265 706c 6163 6520 6361 6c6c 2074 6f20 replace call to │ │ │ │ │ +00006000: 656e 7472 7920 706f 696e 740a 7769 7468 entry point.with │ │ │ │ │ +00006010: 2063 616c 6c20 746f 2045 5854 5f43 2867 call to EXT_C(g │ │ │ │ │ +00006020: 7275 625f 6d61 696e 292e 2020 5468 6520 rub_main). The │ │ │ │ │ +00006030: 4320 6669 6c65 2067 6f65 7320 746f 0a67 C file goes to.g │ │ │ │ │ +00006040: 7275 622d 636f 7265 2f6b 6572 6e2f 2463 rub-core/kern/$c │ │ │ │ │ +00006050: 7075 2f24 706c 6174 666f 726d 2f69 6e69 pu/$platform/ini │ │ │ │ │ +00006060: 742e 6320 616e 6420 6974 7320 656e 7472 t.c and its entr │ │ │ │ │ +00006070: 7920 706f 696e 7420 6973 2072 656e 616d y point is renam │ │ │ │ │ +00006080: 6564 2074 6f0a 766f 6964 2067 7275 625f ed to.void grub_ │ │ │ │ │ +00006090: 6d61 6368 696e 655f 696e 6974 2028 766f machine_init (vo │ │ │ │ │ +000060a0: 6964 292e 2020 4b65 6570 2066 696e 616c id). Keep final │ │ │ │ │ +000060b0: 2069 6e66 696e 6974 6520 6c6f 6f70 2066 infinite loop f │ │ │ │ │ +000060c0: 6f72 206e 6f77 2e20 2053 7475 6273 0a66 or now. Stubs.f │ │ │ │ │ +000060d0: 696c 6520 6966 2061 6e79 2067 6f65 7320 ile if any goes │ │ │ │ │ +000060e0: 746f 2067 7275 622d 636f 7265 2f6b 6572 to grub-core/ker │ │ │ │ │ +000060f0: 6e2f 2463 7075 2f24 706c 6174 666f 726d n/$cpu/$platform │ │ │ │ │ +00006100: 2f63 616c 6c77 7261 702e 532e 2053 6f6d /callwrap.S. Som │ │ │ │ │ +00006110: 6574 696d 6573 0a65 6974 6865 7220 2463 etimes.either $c │ │ │ │ │ +00006120: 7075 206f 7220 2470 6c61 7466 6f72 6d20 pu or $platform │ │ │ │ │ +00006130: 6973 2064 726f 7070 6564 2069 6620 6669 is dropped if fi │ │ │ │ │ +00006140: 6c65 2069 7320 7573 6564 206f 6e20 7365 le is used on se │ │ │ │ │ +00006150: 7665 7261 6c20 6370 7573 0a72 6573 7065 veral cpus.respe │ │ │ │ │ +00006160: 6374 6976 656c 7970 6c61 7466 6f72 6d73 ctivelyplatforms │ │ │ │ │ +00006170: 2e20 2043 6865 636b 2074 686f 7365 206c . Check those l │ │ │ │ │ +00006180: 6f63 6174 696f 6e73 2069 6620 7468 6579 ocations if they │ │ │ │ │ +00006190: 2061 6c72 6561 6479 2068 6176 6520 7768 already have wh │ │ │ │ │ +000061a0: 6174 0a79 6f75 2772 6520 6c6f 6f6b 696e at.you're lookin │ │ │ │ │ +000061b0: 6720 666f 722e 0a0a 2020 2054 6865 6e20 g for... Then │ │ │ │ │ +000061c0: 6d6f 6469 6679 2069 6e20 636f 6e66 6967 modify in config │ │ │ │ │ +000061d0: 7572 652e 6163 2074 6865 2066 6f6c 6c6f ure.ac the follo │ │ │ │ │ +000061e0: 7769 6e67 2070 6172 7473 3a0a 0a20 2020 wing parts:.. │ │ │ │ │ +000061f0: 4350 5520 6e61 6d65 733a 0a0a 2020 2020 CPU names:.. │ │ │ │ │ +00006200: 2063 6173 6520 2224 7461 7267 6574 5f63 case "$target_c │ │ │ │ │ +00006210: 7075 2220 696e 0a20 2020 2020 2020 695b pu" in. i[ │ │ │ │ │ +00006220: 5b33 3435 365d 5d38 3629 0974 6172 6765 [3456]]86).targe │ │ │ │ │ +00006230: 745f 6370 753d 6933 3836 203b 3b0a 2020 t_cpu=i386 ;;. │ │ │ │ │ +00006240: 2020 2020 2061 6d64 3634 2909 7461 7267 amd64).targ │ │ │ │ │ +00006250: 6574 5f63 7075 3d78 3836 5f36 3420 3b3b et_cpu=x86_64 ;; │ │ │ │ │ +00006260: 0a20 2020 2020 2020 7370 6172 6329 0974 . sparc).t │ │ │ │ │ +00006270: 6172 6765 745f 6370 753d 7370 6172 6336 arget_cpu=sparc6 │ │ │ │ │ +00006280: 3420 3b3b 0a20 2020 2020 2020 7333 3930 4 ;;. s390 │ │ │ │ │ +00006290: 7829 0974 6172 6765 745f 6370 753d 7333 x).target_cpu=s3 │ │ │ │ │ +000062a0: 3930 203b 3b0a 2020 2020 2020 202e 2e2e 90 ;;. ... │ │ │ │ │ +000062b0: 0a20 2020 2020 6573 6163 0a0a 2020 2053 . esac.. S │ │ │ │ │ +000062c0: 6f6d 6574 696d 6573 2043 5055 2068 6176 ometimes CPU hav │ │ │ │ │ +000062d0: 6520 6164 6469 7469 6f6e 616c 2061 7263 e additional arc │ │ │ │ │ +000062e0: 6869 7465 6374 7572 6520 6e61 6d65 7320 hitecture names │ │ │ │ │ +000062f0: 7768 6963 6820 646f 6e27 740a 696e 666c which don't.infl │ │ │ │ │ +00006300: 7565 6e63 6520 626f 6f74 696e 672e 2020 uence booting. │ │ │ │ │ +00006310: 596f 7520 6d69 6768 7420 7761 6e74 2074 You might want t │ │ │ │ │ +00006320: 6f20 6861 7665 2073 6f6d 6520 6361 6e6f o have some cano │ │ │ │ │ +00006330: 6e69 6361 6c20 6e61 6d65 2074 6f20 6176 nical name to av │ │ │ │ │ +00006340: 6f69 640a 6861 7669 6e67 2062 756e 6368 oid.having bunch │ │ │ │ │ +00006350: 206f 6620 6964 656e 7469 6361 6c20 706c of identical pl │ │ │ │ │ +00006360: 6174 666f 726d 7320 7769 7468 2064 6966 atforms with dif │ │ │ │ │ +00006370: 6665 7265 6e74 206e 616d 6573 2e0a 0a20 ferent names... │ │ │ │ │ +00006380: 2020 4e4f 5445 3a20 6974 2064 6f65 736e NOTE: it doesn │ │ │ │ │ +00006390: 2774 2069 6e66 6c75 656e 6365 2063 6f6d 't influence com │ │ │ │ │ +000063a0: 7069 6c65 206f 7074 696d 6973 6174 696f pile optimisatio │ │ │ │ │ +000063b0: 6e73 2077 6869 6368 2064 6570 656e 6420 ns which depend │ │ │ │ │ +000063c0: 736f 6c65 6c79 0a6f 6e20 6368 6f73 656e solely.on chosen │ │ │ │ │ +000063d0: 2063 6f6d 7069 6c65 7220 616e 6420 636f compiler and co │ │ │ │ │ +000063e0: 6d70 696c 6520 6f70 7469 6f6e 732e 0a0a mpile options... │ │ │ │ │ +000063f0: 2020 2020 2069 6620 7465 7374 2022 7824 if test "x$ │ │ │ │ │ +00006400: 7769 7468 5f70 6c61 7466 6f72 6d22 203d with_platform" = │ │ │ │ │ +00006410: 2078 3b20 7468 656e 0a20 2020 2020 2020 x; then. │ │ │ │ │ +00006420: 6361 7365 2022 2474 6172 6765 745f 6370 case "$target_cp │ │ │ │ │ +00006430: 7522 2d22 2474 6172 6765 745f 7665 6e64 u"-"$target_vend │ │ │ │ │ +00006440: 6f72 2220 696e 0a20 2020 2020 2020 2020 or" in. │ │ │ │ │ +00006450: 6933 3836 2d61 7070 6c65 2920 706c 6174 i386-apple) plat │ │ │ │ │ +00006460: 666f 726d 3d65 6669 203b 3b0a 2020 2020 form=efi ;;. │ │ │ │ │ +00006470: 2020 2020 2069 3338 362d 2a29 2070 6c61 i386-*) pla │ │ │ │ │ +00006480: 7466 6f72 6d3d 7063 203b 3b0a 2020 2020 tform=pc ;;. │ │ │ │ │ +00006490: 2020 2020 2078 3836 5f36 342d 6170 706c x86_64-appl │ │ │ │ │ +000064a0: 6529 2070 6c61 7466 6f72 6d3d 6566 6920 e) platform=efi │ │ │ │ │ +000064b0: 3b3b 0a20 2020 2020 2020 2020 7838 365f ;;. x86_ │ │ │ │ │ +000064c0: 3634 2d2a 2920 706c 6174 666f 726d 3d70 64-*) platform=p │ │ │ │ │ +000064d0: 6320 3b3b 0a20 2020 2020 2020 2020 706f c ;;. po │ │ │ │ │ +000064e0: 7765 7270 632d 2a29 2070 6c61 7466 6f72 werpc-*) platfor │ │ │ │ │ +000064f0: 6d3d 6965 6565 3132 3735 203b 3b0a 2020 m=ieee1275 ;;. │ │ │ │ │ +00006500: 2020 2020 2020 202e 2e2e 0a20 2020 2020 .... │ │ │ │ │ +00006510: 2020 6573 6163 0a20 2020 2020 656c 7365 esac. else │ │ │ │ │ +00006520: 0a20 2020 2020 2020 2e2e 2e0a 2020 2020 . .... │ │ │ │ │ +00006530: 2066 690a 0a20 2020 5468 6973 2070 6172 fi.. This par │ │ │ │ │ +00006540: 7420 6465 616c 7320 7769 7468 2067 7565 t deals with gue │ │ │ │ │ +00006550: 7373 696e 6720 7468 6520 706c 6174 666f ssing the platfo │ │ │ │ │ +00006560: 726d 2066 726f 6d20 4350 5520 616e 6420 rm from CPU and │ │ │ │ │ +00006570: 7665 6e64 6f72 2e0a 536f 6d65 7469 6d65 vendor..Sometime │ │ │ │ │ +00006580: 7320 796f 7520 6e65 6564 2074 6f20 7573 s you need to us │ │ │ │ │ +00006590: 6520 3332 2d62 6974 206d 6f64 6520 666f e 32-bit mode fo │ │ │ │ │ +000065a0: 7220 626f 6f74 696e 6720 6576 656e 2069 r booting even i │ │ │ │ │ +000065b0: 6620 4f53 2072 756e 7320 696e 0a36 342d f OS runs in.64- │ │ │ │ │ +000065c0: 6269 7420 6f6e 652e 2020 4966 2073 6f20 bit one. If so │ │ │ │ │ +000065d0: 6164 6420 796f 7572 2070 6c61 7466 6f72 add your platfor │ │ │ │ │ +000065e0: 6d20 746f 3a0a 0a20 2020 2020 6361 7365 m to:.. case │ │ │ │ │ +000065f0: 2022 2474 6172 6765 745f 6370 7522 2d22 "$target_cpu"-" │ │ │ │ │ +00006600: 2470 6c61 7466 6f72 6d22 2069 6e0a 2020 $platform" in. │ │ │ │ │ +00006610: 2020 2020 2078 3836 5f36 342d 6566 6929 x86_64-efi) │ │ │ │ │ +00006620: 203b 3b0a 2020 2020 2020 2078 3836 5f36 ;;. x86_6 │ │ │ │ │ +00006630: 342d 656d 7529 203b 3b0a 2020 2020 2020 4-emu) ;;. │ │ │ │ │ +00006640: 2078 3836 5f36 342d 2a29 2074 6172 6765 x86_64-*) targe │ │ │ │ │ +00006650: 745f 6370 753d 6933 3836 203b 3b0a 2020 t_cpu=i386 ;;. │ │ │ │ │ +00006660: 2020 2020 2070 6f77 6572 7063 3634 2d69 powerpc64-i │ │ │ │ │ +00006670: 6565 6531 3237 3529 2074 6172 6765 745f eee1275) target_ │ │ │ │ │ +00006680: 6370 753d 706f 7765 7270 6320 3b3b 0a20 cpu=powerpc ;;. │ │ │ │ │ +00006690: 2020 2020 6573 6163 0a0a 2020 2041 6464 esac.. Add │ │ │ │ │ +000066a0: 2079 6f75 7220 706c 6174 666f 726d 2074 your platform t │ │ │ │ │ +000066b0: 6f20 7468 6520 6c69 7374 206f 6620 7375 o the list of su │ │ │ │ │ +000066c0: 7070 6f72 7465 6420 6f6e 6573 3a0a 0a20 pported ones:.. │ │ │ │ │ +000066d0: 2020 2020 6361 7365 2022 2474 6172 6765 case "$targe │ │ │ │ │ +000066e0: 745f 6370 7522 2d22 2470 6c61 7466 6f72 t_cpu"-"$platfor │ │ │ │ │ +000066f0: 6d22 2069 6e0a 2020 2020 2020 2069 3338 m" in. i38 │ │ │ │ │ +00006700: 362d 6566 6929 203b 3b0a 2020 2020 2020 6-efi) ;;. │ │ │ │ │ +00006710: 2078 3836 5f36 342d 6566 6929 203b 3b0a x86_64-efi) ;;. │ │ │ │ │ +00006720: 2020 2020 2020 2069 3338 362d 7063 2920 i386-pc) │ │ │ │ │ +00006730: 3b3b 0a20 2020 2020 2020 6933 3836 2d6d ;;. i386-m │ │ │ │ │ +00006740: 756c 7469 626f 6f74 2920 3b3b 0a20 2020 ultiboot) ;;. │ │ │ │ │ +00006750: 2020 2020 6933 3836 2d63 6f72 6562 6f6f i386-coreboo │ │ │ │ │ +00006760: 7429 203b 3b0a 2020 2020 2020 202e 2e2e t) ;;. ... │ │ │ │ │ +00006770: 0a20 2020 2020 6573 6163 0a0a 2020 2049 . esac.. I │ │ │ │ │ +00006780: 6620 6578 706c 6963 6974 202d 6d33 3220 f explicit -m32 │ │ │ │ │ +00006790: 6f72 202d 6d36 3420 6973 206e 6565 6465 or -m64 is neede │ │ │ │ │ +000067a0: 6420 6164 6420 6974 2074 6f3a 0a0a 2020 d add it to:.. │ │ │ │ │ +000067b0: 2020 2063 6173 6520 2224 7461 7267 6574 case "$target │ │ │ │ │ +000067c0: 5f63 7075 2220 696e 0a20 2020 2020 2020 _cpu" in. │ │ │ │ │ +000067d0: 6933 3836 207c 2070 6f77 6572 7063 2920 i386 | powerpc) │ │ │ │ │ +000067e0: 7461 7267 6574 5f6d 3332 3d31 203b 3b0a target_m32=1 ;;. │ │ │ │ │ +000067f0: 2020 2020 2020 2078 3836 5f36 3420 7c20 x86_64 | │ │ │ │ │ +00006800: 7370 6172 6336 3429 2074 6172 6765 745f sparc64) target_ │ │ │ │ │ +00006810: 6d36 343d 3120 3b3b 0a20 2020 2020 6573 m64=1 ;;. es │ │ │ │ │ +00006820: 6163 0a0a 2020 2046 696e 616c 6c79 2079 ac.. Finally y │ │ │ │ │ +00006830: 6f75 206e 6565 6420 746f 2061 6464 2061 ou need to add a │ │ │ │ │ +00006840: 2063 6f6e 6469 7469 6f6e 616c 2074 6f20 conditional to │ │ │ │ │ +00006850: 7468 6520 666f 6c6c 6f77 696e 6720 626c the following bl │ │ │ │ │ +00006860: 6f63 6b3a 0a0a 2020 2020 2041 4d5f 434f ock:.. AM_CO │ │ │ │ │ +00006870: 4e44 4954 494f 4e41 4c28 5b43 4f4e 445f NDITIONAL([COND_ │ │ │ │ │ +00006880: 6d69 7073 5f61 7263 5d2c 205b 7465 7374 mips_arc], [test │ │ │ │ │ +00006890: 2078 2474 6172 6765 745f 6370 7520 3d20 x$target_cpu = │ │ │ │ │ +000068a0: 786d 6970 7320 2d61 2078 2470 6c61 7466 xmips -a x$platf │ │ │ │ │ +000068b0: 6f72 6d20 3d20 7861 7263 5d29 0a20 2020 orm = xarc]). │ │ │ │ │ +000068c0: 2020 414d 5f43 4f4e 4449 5449 4f4e 414c AM_CONDITIONAL │ │ │ │ │ +000068d0: 285b 434f 4e44 5f73 7061 7263 3634 5f69 ([COND_sparc64_i │ │ │ │ │ +000068e0: 6565 6531 3237 355d 2c20 5b74 6573 7420 eee1275], [test │ │ │ │ │ +000068f0: 7824 7461 7267 6574 5f63 7075 203d 2078 x$target_cpu = x │ │ │ │ │ +00006900: 7370 6172 6336 3420 2d61 2078 2470 6c61 sparc64 -a x$pla │ │ │ │ │ +00006910: 7466 6f72 6d20 3d20 7869 6565 6531 3237 tform = xieee127 │ │ │ │ │ +00006920: 355d 290a 2020 2020 2041 4d5f 434f 4e44 5]). AM_COND │ │ │ │ │ +00006930: 4954 494f 4e41 4c28 5b43 4f4e 445f 706f ITIONAL([COND_po │ │ │ │ │ +00006940: 7765 7270 635f 6965 6565 3132 3735 5d2c werpc_ieee1275], │ │ │ │ │ +00006950: 205b 7465 7374 2078 2474 6172 6765 745f [test x$target_ │ │ │ │ │ +00006960: 6370 7520 3d20 7870 6f77 6572 7063 202d cpu = xpowerpc - │ │ │ │ │ +00006970: 6120 7824 706c 6174 666f 726d 203d 2078 a x$platform = x │ │ │ │ │ +00006980: 6965 6565 3132 3735 5d29 0a0a 2020 204e ieee1275]).. N │ │ │ │ │ +00006990: 6578 7420 7374 6f70 2069 7320 6765 6e74 ext stop is gent │ │ │ │ │ +000069a0: 706c 2e70 792e 2020 596f 7520 6e65 6564 pl.py. You need │ │ │ │ │ +000069b0: 2074 6f20 6164 6420 796f 7572 2070 6c61 to add your pla │ │ │ │ │ +000069c0: 7466 6f72 6d20 746f 2074 6865 206c 6973 tform to the lis │ │ │ │ │ +000069d0: 7420 6f66 0a73 7570 706f 7274 6564 206f t of.supported o │ │ │ │ │ +000069e0: 6e65 7320 2873 6f72 7279 2074 6861 7420 nes (sorry that │ │ │ │ │ +000069f0: 7468 6973 206c 6973 7420 6973 2064 7570 this list is dup │ │ │ │ │ +00006a00: 6c69 6361 7465 6429 3a0a 0a20 2020 2020 licated):.. │ │ │ │ │ +00006a10: 4752 5542 5f50 4c41 5446 4f52 4d53 203d GRUB_PLATFORMS = │ │ │ │ │ +00006a20: 205b 2022 656d 7522 2c20 2269 3338 365f [ "emu", "i386_ │ │ │ │ │ +00006a30: 7063 222c 2022 6933 3836 5f65 6669 222c pc", "i386_efi", │ │ │ │ │ +00006a40: 2022 6933 3836 5f71 656d 7522 2c20 2269 "i386_qemu", "i │ │ │ │ │ +00006a50: 3338 365f 636f 7265 626f 6f74 222c 0a20 386_coreboot",. │ │ │ │ │ +00006a60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00006a70: 2020 2020 2020 2022 6933 3836 5f6d 756c "i386_mul │ │ │ │ │ +00006a80: 7469 626f 6f74 222c 2022 6933 3836 5f69 tiboot", "i386_i │ │ │ │ │ +00006a90: 6565 6531 3237 3522 2c20 2278 3836 5f36 eee1275", "x86_6 │ │ │ │ │ +00006aa0: 345f 6566 6922 2c0a 2020 2020 2020 2020 4_efi",. │ │ │ │ │ 00006ab0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00006ac0: 2020 226d 6970 735f 6c6f 6f6e 6773 6f6e "mips_loongson │ │ │ │ │ -00006ad0: 222c 2022 7370 6172 6336 345f 6965 6565 ", "sparc64_ieee │ │ │ │ │ -00006ae0: 3132 3735 222c 0a20 2020 2020 2020 2020 1275",. │ │ │ │ │ -00006af0: 2020 2020 2020 2020 2020 2020 2020 2022 " │ │ │ │ │ -00006b00: 706f 7765 7270 635f 6965 6565 3132 3735 powerpc_ieee1275 │ │ │ │ │ -00006b10: 222c 2022 6d69 7073 5f61 7263 222c 2022 ", "mips_arc", " │ │ │ │ │ -00006b20: 6961 3634 5f65 6669 222c 0a20 2020 2020 ia64_efi",. │ │ │ │ │ +00006ac0: 226d 6970 735f 6c6f 6f6e 6773 6f6e 222c "mips_loongson", │ │ │ │ │ +00006ad0: 2022 7370 6172 6336 345f 6965 6565 3132 "sparc64_ieee12 │ │ │ │ │ +00006ae0: 3735 222c 0a20 2020 2020 2020 2020 2020 75",. │ │ │ │ │ +00006af0: 2020 2020 2020 2020 2020 2020 2022 706f "po │ │ │ │ │ +00006b00: 7765 7270 635f 6965 6565 3132 3735 222c werpc_ieee1275", │ │ │ │ │ +00006b10: 2022 6d69 7073 5f61 7263 222c 2022 6961 "mips_arc", "ia │ │ │ │ │ +00006b20: 3634 5f65 6669 222c 0a20 2020 2020 2020 64_efi",. │ │ │ │ │ 00006b30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00006b40: 2020 2022 6d69 7073 5f71 656d 755f 6d69 "mips_qemu_mi │ │ │ │ │ -00006b50: 7073 222c 2022 7333 3930 5f6d 6169 6e66 ps", "s390_mainf │ │ │ │ │ -00006b60: 7261 6d65 2220 5d0a 0a20 2020 596f 7520 rame" ].. You │ │ │ │ │ -00006b70: 6d61 7920 616c 736f 2077 616e 7420 616c may also want al │ │ │ │ │ -00006b80: 7265 6164 7920 746f 2061 6464 206e 6577 ready to add new │ │ │ │ │ -00006b90: 2070 6c61 7466 6f72 6d20 746f 206f 6e65 platform to one │ │ │ │ │ -00006ba0: 206f 7220 7365 7665 7261 6c20 6f66 0a61 or several of.a │ │ │ │ │ -00006bb0: 7661 696c 6162 6c65 2067 726f 7570 732e vailable groups. │ │ │ │ │ -00006bc0: 2020 496e 2070 6172 7469 6375 6c61 7220 In particular │ │ │ │ │ -00006bd0: 7765 2061 6c77 6179 7320 6861 7665 2061 we always have a │ │ │ │ │ -00006be0: 2067 726f 7570 2066 6f72 2065 6163 6820 group for each │ │ │ │ │ -00006bf0: 4350 550a 6576 656e 2077 6865 6e20 6f6e CPU.even when on │ │ │ │ │ -00006c00: 6c79 206f 6e65 2070 6c61 7466 6f72 6d20 ly one platform │ │ │ │ │ -00006c10: 666f 7220 6769 7665 6e20 4350 5520 6973 for given CPU is │ │ │ │ │ -00006c20: 2061 7661 696c 6162 6c65 2e0a 0a20 2020 available... │ │ │ │ │ -00006c30: 5468 656e 2063 6f6d 6573 2067 7275 622d Then comes grub- │ │ │ │ │ -00006c40: 636f 7265 2f4d 616b 6566 696c 652e 636f core/Makefile.co │ │ │ │ │ -00006c50: 7265 2e64 6566 2e20 2049 6e20 7468 6520 re.def. In the │ │ │ │ │ -00006c60: 626c 6f63 6b20 226b 6572 6e65 6c22 2079 block "kernel" y │ │ │ │ │ -00006c70: 6f75 276c 6c0a 6e65 6564 2074 6f20 6465 ou'll.need to de │ │ │ │ │ -00006c80: 6669 6e65 206c 6466 6c61 6773 2066 6f72 fine ldflags for │ │ │ │ │ -00006c90: 2079 6f75 7220 706c 6174 666f 726d 2028 your platform ( │ │ │ │ │ -00006ca0: 2463 7075 5f24 706c 6174 666f 726d 5f6c $cpu_$platform_l │ │ │ │ │ -00006cb0: 6466 6c61 6773 292e 2020 596f 750a 616c dflags). You.al │ │ │ │ │ -00006cc0: 736f 206e 6565 6420 746f 2064 6563 6c61 so need to decla │ │ │ │ │ -00006cd0: 7265 2073 7461 7274 7570 2061 736d 2066 re startup asm f │ │ │ │ │ -00006ce0: 696c 6520 2824 6370 755f 2470 6c61 7466 ile ($cpu_$platf │ │ │ │ │ -00006cf0: 6f72 6d5f 7374 6172 7475 7029 2061 7320 orm_startup) as │ │ │ │ │ -00006d00: 7765 6c6c 0a61 7320 616e 7920 6f74 6865 well.as any othe │ │ │ │ │ -00006d10: 7220 6669 6c65 7320 2865 2e67 2e20 2069 r files (e.g. i │ │ │ │ │ -00006d20: 6e69 742e 6320 616e 6420 6361 6c6c 7772 nit.c and callwr │ │ │ │ │ -00006d30: 6170 2e53 2920 2865 2e67 2e20 2024 6370 ap.S) (e.g. $cp │ │ │ │ │ -00006d40: 755f 2470 6c61 7466 6f72 6d20 3d0a 6b65 u_$platform =.ke │ │ │ │ │ -00006d50: 726e 2f24 6370 752f 2470 6c61 7466 6f72 rn/$cpu/$platfor │ │ │ │ │ -00006d60: 6d2f 696e 6974 2e63 292e 2020 4174 2074 m/init.c). At t │ │ │ │ │ -00006d70: 6869 7320 7374 6167 6520 796f 7520 7769 his stage you wi │ │ │ │ │ -00006d80: 6c6c 2061 6c73 6f20 6e65 6564 2074 6f20 ll also need to │ │ │ │ │ -00006d90: 6164 640a 6475 6d6d 7920 646c 2e63 2061 add.dummy dl.c a │ │ │ │ │ -00006da0: 6e64 2063 6163 6865 2e53 2077 6974 6820 nd cache.S with │ │ │ │ │ -00006db0: 6675 6e63 7469 6f6e 7320 6772 7562 5f65 functions grub_e │ │ │ │ │ -00006dc0: 7272 5f74 0a67 7275 625f 6172 6368 5f64 rr_t.grub_arch_d │ │ │ │ │ -00006dd0: 6c5f 6368 6563 6b5f 6865 6164 6572 2028 l_check_header ( │ │ │ │ │ -00006de0: 766f 6964 202a 6568 6472 292c 2067 7275 void *ehdr), gru │ │ │ │ │ -00006df0: 625f 6572 725f 740a 6772 7562 5f61 7263 b_err_t.grub_arc │ │ │ │ │ -00006e00: 685f 646c 5f72 656c 6f63 6174 655f 7379 h_dl_relocate_sy │ │ │ │ │ -00006e10: 6d62 6f6c 7320 2867 7275 625f 646c 5f74 mbols (grub_dl_t │ │ │ │ │ -00006e20: 206d 6f64 2c20 766f 6964 202a 6568 6472 mod, void *ehdr │ │ │ │ │ -00006e30: 2920 2864 6c2e 6329 2061 6e64 0a76 6f69 ) (dl.c) and.voi │ │ │ │ │ -00006e40: 6420 6772 7562 5f61 7263 685f 7379 6e63 d grub_arch_sync │ │ │ │ │ -00006e50: 5f63 6163 6865 7320 2876 6f69 6420 2a61 _caches (void *a │ │ │ │ │ -00006e60: 6464 7265 7373 2c20 6772 7562 5f73 697a ddress, grub_siz │ │ │ │ │ -00006e70: 655f 7420 6c65 6e29 2028 6361 6368 652e e_t len) (cache. │ │ │ │ │ -00006e80: 5329 2e0a 5468 6579 2077 6f6e 2774 2062 S)..They won't b │ │ │ │ │ -00006e90: 6520 7573 6564 2066 6f72 206e 6f77 2e0a e used for now.. │ │ │ │ │ -00006ea0: 0a20 2020 596f 7520 7769 6c6c 206e 6565 . You will nee │ │ │ │ │ -00006eb0: 6420 746f 2063 7265 6174 6520 6469 7265 d to create dire │ │ │ │ │ -00006ec0: 6374 6f72 7920 696e 636c 7564 652f 2463 ctory include/$c │ │ │ │ │ -00006ed0: 7075 2f24 706c 6174 666f 726d 2061 6e64 pu/$platform and │ │ │ │ │ -00006ee0: 2061 2066 696c 650a 696e 636c 7564 652f a file.include/ │ │ │ │ │ -00006ef0: 2463 7075 2f74 7970 6573 2e68 2e20 2054 $cpu/types.h. T │ │ │ │ │ -00006f00: 6865 206c 6174 6572 2066 6f6c 6f77 696e he later folowin │ │ │ │ │ -00006f10: 6720 7468 6973 2074 656d 706c 6174 653a g this template: │ │ │ │ │ -00006f20: 0a0a 2020 2020 2023 6966 6e64 6566 2047 .. #ifndef G │ │ │ │ │ -00006f30: 5255 425f 5459 5045 535f 4350 555f 4845 RUB_TYPES_CPU_HE │ │ │ │ │ -00006f40: 4144 4552 0a20 2020 2020 2364 6566 696e ADER. #defin │ │ │ │ │ -00006f50: 6520 4752 5542 5f54 5950 4553 5f43 5055 e GRUB_TYPES_CPU │ │ │ │ │ -00006f60: 5f48 4541 4445 5209 310a 0a20 2020 2020 _HEADER.1.. │ │ │ │ │ -00006f70: 2f2a 2054 6865 2073 697a 6520 6f66 2076 /* The size of v │ │ │ │ │ -00006f80: 6f69 6420 2a2e 2020 2a2f 0a20 2020 2020 oid *. */. │ │ │ │ │ -00006f90: 2364 6566 696e 6520 4752 5542 5f54 4152 #define GRUB_TAR │ │ │ │ │ -00006fa0: 4745 545f 5349 5a45 4f46 5f56 4f49 445f GET_SIZEOF_VOID_ │ │ │ │ │ -00006fb0: 5009 340a 0a20 2020 2020 2f2a 2054 6865 P.4.. /* The │ │ │ │ │ -00006fc0: 2073 697a 6520 6f66 206c 6f6e 672e 2020 size of long. │ │ │ │ │ -00006fd0: 2a2f 0a20 2020 2020 2364 6566 696e 6520 */. #define │ │ │ │ │ -00006fe0: 4752 5542 5f54 4152 4745 545f 5349 5a45 GRUB_TARGET_SIZE │ │ │ │ │ -00006ff0: 4f46 5f4c 4f4e 4709 0934 0a0a 2020 2020 OF_LONG..4.. │ │ │ │ │ -00007000: 202f 2a20 6d79 6370 7520 6973 2062 6967 /* mycpu is big │ │ │ │ │ -00007010: 2d65 6e64 6961 6e2e 2020 2a2f 0a20 2020 -endian. */. │ │ │ │ │ -00007020: 2020 2364 6566 696e 6520 4752 5542 5f54 #define GRUB_T │ │ │ │ │ -00007030: 4152 4745 545f 574f 5244 535f 4249 4745 ARGET_WORDS_BIGE │ │ │ │ │ -00007040: 4e44 4941 4e09 310a 2020 2020 202f 2a20 NDIAN.1. /* │ │ │ │ │ -00007050: 416c 7465 726e 6174 6976 656c 793a 206d Alternatively: m │ │ │ │ │ -00007060: 7963 7075 2069 7320 6c69 7474 6c65 2d65 ycpu is little-e │ │ │ │ │ -00007070: 6e64 6961 6e2e 2020 2a2f 0a20 2020 2020 ndian. */. │ │ │ │ │ -00007080: 2375 6e64 6566 2047 5255 425f 5441 5247 #undef GRUB_TARG │ │ │ │ │ -00007090: 4554 5f57 4f52 4453 5f42 4947 454e 4449 ET_WORDS_BIGENDI │ │ │ │ │ -000070a0: 414e 0a0a 2020 2020 2023 656e 6469 6620 AN.. #endif │ │ │ │ │ -000070b0: 2f2a 2021 2047 5255 425f 5459 5045 535f /* ! GRUB_TYPES_ │ │ │ │ │ -000070c0: 4350 555f 4845 4144 4552 202a 2f0a 0a20 CPU_HEADER */.. │ │ │ │ │ -000070d0: 2020 596f 7520 7769 6c6c 2061 6c73 6f20 You will also │ │ │ │ │ -000070e0: 6e65 6564 2074 6f20 6164 6420 6120 6475 need to add a du │ │ │ │ │ -000070f0: 6d6d 7920 6669 6c65 2074 6f20 6461 7465 mmy file to date │ │ │ │ │ -00007100: 7469 6d65 2061 6e64 2073 6574 6a6d 7020 time and setjmp │ │ │ │ │ -00007110: 6d6f 6475 6c65 730a 746f 2061 766f 6964 modules.to avoid │ │ │ │ │ -00007120: 2061 6e79 206f 6620 6974 2068 6176 696e any of it havin │ │ │ │ │ -00007130: 6720 6e6f 2066 696c 6573 2e20 2049 7420 g no files. It │ │ │ │ │ -00007140: 6361 6e20 6265 206a 7573 7420 636f 6d70 can be just comp │ │ │ │ │ -00007150: 6c65 7465 6c79 2065 6d70 7479 2061 740a letely empty at. │ │ │ │ │ -00007160: 7468 6973 2073 7461 6765 2e0a 0a20 2020 this stage... │ │ │ │ │ -00007170: 596f 7527 6c6c 206e 6565 6420 746f 206d You'll need to m │ │ │ │ │ -00007180: 616b 6520 6772 7562 2d6d 6b69 6d61 6765 ake grub-mkimage │ │ │ │ │ -00007190: 2e63 2028 7574 696c 2f67 7275 625f 6d6b .c (util/grub_mk │ │ │ │ │ -000071a0: 696d 6167 652e 6329 2061 7761 7265 206f image.c) aware o │ │ │ │ │ -000071b0: 6620 7468 650a 6e65 6564 6564 2066 6f72 f the.needed for │ │ │ │ │ -000071c0: 6d61 742e 2020 466f 7220 6d6f 7374 2063 mat. For most c │ │ │ │ │ -000071d0: 6f6d 6d6f 6e6c 7920 7573 6564 2066 6f72 ommonly used for │ │ │ │ │ -000071e0: 6d61 7473 206c 696b 6520 454c 462c 2050 mats like ELF, P │ │ │ │ │ -000071f0: 452c 2061 6f75 7420 6f72 2072 6177 0a74 E, aout or raw.t │ │ │ │ │ -00007200: 6865 2073 7570 706f 7274 2069 7320 616c he support is al │ │ │ │ │ -00007210: 7265 6164 7920 7072 6573 656e 7420 616e ready present an │ │ │ │ │ -00007220: 6420 796f 7527 6c6c 206e 6565 6420 746f d you'll need to │ │ │ │ │ -00007230: 206d 616b 6520 6974 2066 6f6c 6c6f 7720 make it follow │ │ │ │ │ -00007240: 7468 650a 6578 6973 7461 6e74 2063 6f64 the.existant cod │ │ │ │ │ -00007250: 6520 7061 7468 7320 666f 7220 796f 7572 e paths for your │ │ │ │ │ -00007260: 2070 6c61 7466 6f72 6d20 6164 6469 6e67 platform adding │ │ │ │ │ -00007270: 2061 646a 7573 746d 656e 7473 2069 6620 adjustments if │ │ │ │ │ -00007280: 6e65 6365 7373 6172 792e 0a57 6865 6e20 necessary..When │ │ │ │ │ -00007290: 646f 6e65 2063 6f6d 7069 6c65 3a0a 0a20 done compile:.. │ │ │ │ │ -000072a0: 2020 2020 2e2f 626f 6f74 7374 7261 700a ./bootstrap. │ │ │ │ │ -000072b0: 2020 2020 202e 2f63 6f6e 6669 6775 7265 ./configure │ │ │ │ │ -000072c0: 202d 2d74 6172 6765 743d 2463 7075 202d --target=$cpu - │ │ │ │ │ -000072d0: 2d77 6974 682d 706c 6174 666f 726d 3d24 -with-platform=$ │ │ │ │ │ -000072e0: 706c 6174 666f 726d 2054 4152 4745 545f platform TARGET_ │ │ │ │ │ -000072f0: 4343 3d2e 2e20 4f42 4a43 4f50 593d 2e2e CC=.. OBJCOPY=.. │ │ │ │ │ -00007300: 2e20 5354 5249 503d 2e2e 2e0a 2020 2020 . STRIP=.... │ │ │ │ │ -00007310: 206d 616b 6520 3e20 2f64 6576 2f6e 756c make > /dev/nul │ │ │ │ │ -00007320: 6c0a 0a20 2020 416e 6420 6372 6561 7465 l.. And create │ │ │ │ │ -00007330: 2069 6d61 6765 0a0a 2020 2020 202e 2f67 image.. ./g │ │ │ │ │ -00007340: 7275 622d 6d6b 696d 6167 6520 2d64 2067 rub-mkimage -d g │ │ │ │ │ -00007350: 7275 622d 636f 7265 202d 4f20 2466 6f72 rub-core -O $for │ │ │ │ │ -00007360: 6d61 745f 6964 202d 6f20 7465 7374 2e69 mat_id -o test.i │ │ │ │ │ -00007370: 6d67 0a0a 2020 2041 6e64 2069 7427 7320 mg.. And it's │ │ │ │ │ -00007380: 7469 6d65 2074 6f20 7465 7374 2079 6f75 time to test you │ │ │ │ │ -00007390: 7220 7465 7374 2e69 6d67 2e0a 0a20 2020 r test.img... │ │ │ │ │ -000073a0: 4966 2069 7420 776f 726b 7320 6e65 7874 If it works next │ │ │ │ │ -000073b0: 2073 7461 6765 2069 7320 746f 2068 6176 stage is to hav │ │ │ │ │ -000073c0: 6520 6865 6170 2c20 636f 6e73 6f6c 6520 e heap, console │ │ │ │ │ -000073d0: 616e 6420 7469 6d65 722e 0a0a 2020 2054 and timer... T │ │ │ │ │ -000073e0: 6f20 6861 7665 2074 6865 2068 6561 7020 o have the heap │ │ │ │ │ -000073f0: 776f 726b 696e 6720 796f 7520 6e65 6564 working you need │ │ │ │ │ -00007400: 2074 6f20 6465 7465 726d 696e 6520 7768 to determine wh │ │ │ │ │ -00007410: 6963 6820 7265 6769 6f6e 7320 6172 650a ich regions are. │ │ │ │ │ -00007420: 7375 6974 6162 6c65 2066 6f72 2068 6561 suitable for hea │ │ │ │ │ -00007430: 7020 7573 6167 652c 2061 6c6c 6f63 6174 p usage, allocat │ │ │ │ │ -00007440: 6520 7468 656d 2066 726f 6d20 6669 726d e them from firm │ │ │ │ │ -00007450: 7761 7265 2061 6e64 206d 6170 2028 6966 ware and map (if │ │ │ │ │ -00007460: 0a61 7070 6c69 6361 626c 6529 2e20 2054 .applicable). T │ │ │ │ │ -00007470: 6865 6e20 6361 6c6c 2067 7275 625f 6d6d hen call grub_mm │ │ │ │ │ -00007480: 5f69 6e69 745f 7265 6769 6f6e 2028 766f _init_region (vo │ │ │ │ │ -00007490: 6973 202a 7374 6172 742c 2067 7275 625f is *start, grub_ │ │ │ │ │ -000074a0: 7369 7a65 5f74 2073 290a 666f 7220 6576 size_t s).for ev │ │ │ │ │ -000074b0: 6572 7920 6f66 2074 6869 7320 7265 6769 ery of this regi │ │ │ │ │ -000074c0: 6f6e 2e20 2041 7320 6120 7368 6f72 7463 on. As a shortc │ │ │ │ │ -000074d0: 7574 2066 6f72 2065 6172 6c79 2070 6f72 ut for early por │ │ │ │ │ -000074e0: 7420 796f 7520 6361 6e20 616c 6c6f 6361 t you can alloca │ │ │ │ │ -000074f0: 7465 0a72 6967 6874 2061 6674 6572 205f te.right after _ │ │ │ │ │ -00007500: 656e 6420 6f72 2068 6176 6520 6120 6269 end or have a bi │ │ │ │ │ -00007510: 6720 7374 6174 6963 2061 7272 6179 2066 g static array f │ │ │ │ │ -00007520: 6f72 2068 6561 702e 2020 4966 2079 6f75 or heap. If you │ │ │ │ │ -00007530: 2064 6f20 796f 7527 6c6c 0a70 726f 6261 do you'll.proba │ │ │ │ │ -00007540: 626c 7920 6e65 6564 2074 6f20 636f 6d65 bly need to come │ │ │ │ │ -00007550: 2062 6163 6b20 746f 2074 6869 7320 6c61 back to this la │ │ │ │ │ -00007560: 7465 722e 2020 4173 2066 6f72 206f 7574 ter. As for out │ │ │ │ │ -00007570: 7075 7420 636f 6e73 6f6c 6520 796f 750a put console you. │ │ │ │ │ -00007580: 7368 6f75 6c64 2064 6973 7469 6e67 7569 should distingui │ │ │ │ │ -00007590: 7368 2062 6574 7765 656e 2061 6e20 6172 sh between an ar │ │ │ │ │ -000075a0: 7261 7920 6f66 2074 6578 742c 2074 6572 ray of text, ter │ │ │ │ │ -000075b0: 6d69 6e66 6f20 6f72 2067 7261 7068 6963 minfo or graphic │ │ │ │ │ -000075c0: 732d 6261 7365 640a 636f 6e73 6f6c 652e s-based.console. │ │ │ │ │ -000075d0: 2020 4d61 6e79 206f 6620 7265 616c 2d77 Many of real-w │ │ │ │ │ -000075e0: 6f72 6c64 2065 7861 6d70 6c65 7320 646f orld examples do │ │ │ │ │ -000075f0: 6e27 7420 6669 7420 7065 7266 6563 746c n't fit perfectl │ │ │ │ │ -00007600: 7920 696e 746f 2061 6e79 206f 660a 7468 y into any of.th │ │ │ │ │ -00007610: 6573 6520 6361 7465 676f 7269 6573 2062 ese categories b │ │ │ │ │ -00007620: 7574 206f 6e65 206f 6620 7468 6520 6d6f ut one of the mo │ │ │ │ │ -00007630: 6465 6c73 2069 7320 6561 7369 6572 2074 dels is easier t │ │ │ │ │ -00007640: 6f20 6265 2075 7365 6420 6173 2062 6173 o be used as bas │ │ │ │ │ -00007650: 652e 2020 496e 0a73 6563 6f6e 6420 616e e. In.second an │ │ │ │ │ -00007660: 6420 7468 6972 6420 6361 7365 2079 6f75 d third case you │ │ │ │ │ -00007670: 2073 686f 756c 6420 6164 6420 796f 7572 should add your │ │ │ │ │ -00007680: 2070 6c61 7466 6f72 6d20 746f 2074 6572 platform to ter │ │ │ │ │ -00007690: 6d69 6e66 6f6b 6572 6e65 6c0a 7265 7370 minfokernel.resp │ │ │ │ │ -000076a0: 6563 7469 7665 6c79 2076 6964 656f 696e ectively videoin │ │ │ │ │ -000076b0: 6b65 726e 656c 2067 726f 7570 2e20 2041 kernel group. A │ │ │ │ │ -000076c0: 2067 6f6f 6420 6578 616d 706c 6520 6f66 good example of │ │ │ │ │ -000076d0: 2061 7272 6179 206f 6620 7465 7874 2069 array of text i │ │ │ │ │ -000076e0: 730a 6933 3836 2d70 6320 286b 6572 6e2f s.i386-pc (kern/ │ │ │ │ │ -000076f0: 6933 3836 2f70 632f 696e 6974 2e63 2061 i386/pc/init.c a │ │ │ │ │ -00007700: 6e64 2074 6572 6d2f 6933 3836 2f70 632f nd term/i386/pc/ │ │ │ │ │ -00007710: 636f 6e73 6f6c 652e 6329 2e20 204f 6620 console.c). Of │ │ │ │ │ -00007720: 7465 726d 696e 666f 0a69 7320 6965 6565 terminfo.is ieee │ │ │ │ │ -00007730: 3132 3735 2028 6b65 726e 2f69 6565 6531 1275 (kern/ieee1 │ │ │ │ │ -00007740: 3237 352f 696e 6974 2e63 2061 6e64 2074 275/init.c and t │ │ │ │ │ -00007750: 6572 6d2f 6965 6565 3132 3735 2f63 6f6e erm/ieee1275/con │ │ │ │ │ -00007760: 736f 6c65 2e63 292e 2020 4f66 0a76 6964 sole.c). Of.vid │ │ │ │ │ -00007770: 656f 2069 7320 6c6f 6f6e 6773 6f6e 2028 eo is loongson ( │ │ │ │ │ -00007780: 6b65 726e 2f6d 6970 732f 6c6f 6f6e 6773 kern/mips/loongs │ │ │ │ │ -00007790: 6f6e 2f69 6e69 742e 6329 2e20 204e 6f74 on/init.c). Not │ │ │ │ │ -000077a0: 6520 7468 6174 2074 6572 6d69 6e66 6f20 e that terminfo │ │ │ │ │ -000077b0: 6861 730a 746f 2062 6520 696e 6974 6564 has.to be inited │ │ │ │ │ -000077c0: 2069 6e20 3220 7374 6167 6573 3a20 6f6e in 2 stages: on │ │ │ │ │ -000077d0: 6520 6265 666f 7265 2028 746f 2067 6574 e before (to get │ │ │ │ │ -000077e0: 2061 7420 6c65 6173 7420 7275 6469 6d65 at least rudime │ │ │ │ │ -000077f0: 6e74 6172 790a 636f 6e73 6f6c 6520 6173 ntary.console as │ │ │ │ │ -00007800: 2065 6172 6c79 2061 7320 706f 7373 6962 early as possib │ │ │ │ │ -00007810: 6c65 2920 616e 6420 616e 6f74 6865 7220 le) and another │ │ │ │ │ -00007820: 6166 7465 7220 7468 6520 6865 6170 2028 after the heap ( │ │ │ │ │ -00007830: 746f 2067 6574 0a66 756c 6c2d 6665 6174 to get.full-feat │ │ │ │ │ -00007840: 7572 6564 2063 6f6e 736f 6c65 292e 2020 ured console). │ │ │ │ │ -00007850: 466f 7220 7468 6520 696e 7075 7420 7468 For the input th │ │ │ │ │ -00007860: 6572 6520 6172 6520 7374 7269 6e67 206f ere are string o │ │ │ │ │ -00007870: 6620 6b65 7973 2c0a 7465 726d 696e 666f f keys,.terminfo │ │ │ │ │ -00007880: 2061 6e64 2064 6972 6563 7420 6861 7264 and direct hard │ │ │ │ │ -00007890: 7761 7265 2e20 2046 6f72 2073 7472 696e ware. For strin │ │ │ │ │ -000078a0: 6720 6f66 206b 6579 7320 6c6f 6f6b 2061 g of keys look a │ │ │ │ │ -000078b0: 7420 6933 3836 2d70 6320 2873 616d 650a t i386-pc (same. │ │ │ │ │ -000078c0: 6669 6c65 7329 2c20 666f 7220 7465 726d files), for term │ │ │ │ │ -000078d0: 696e 666f 2069 6565 6531 3237 3520 2873 info ieee1275 (s │ │ │ │ │ -000078e0: 616d 6520 6669 6c65 7329 2061 6e64 2066 ame files) and f │ │ │ │ │ -000078f0: 6f72 2068 6172 6477 6172 6520 6c6f 6f6e or hardware loon │ │ │ │ │ -00007900: 6773 6f6e 0a28 6b65 726e 2f6d 6970 732f gson.(kern/mips/ │ │ │ │ │ -00007910: 6c6f 6f6e 6773 6f6e 2f69 6e69 742e 6320 loongson/init.c │ │ │ │ │ -00007920: 616e 6420 7465 726d 2f61 745f 6b65 7962 and term/at_keyb │ │ │ │ │ -00007930: 6f61 7264 2e63 292e 0a0a 2020 2046 6f72 oard.c)... For │ │ │ │ │ -00007940: 2074 6865 2074 696d 6572 2079 6f75 276c the timer you'l │ │ │ │ │ -00007950: 6c20 6e65 6564 2074 6f20 6361 6c6c 2067 l need to call g │ │ │ │ │ -00007960: 7275 625f 696e 7374 616c 6c5f 6765 745f rub_install_get_ │ │ │ │ │ -00007970: 7469 6d65 5f6d 7320 282e 2e2e 290a 7769 time_ms (...).wi │ │ │ │ │ -00007980: 7468 2061 7320 736f 6c65 2061 7267 756d th as sole argum │ │ │ │ │ -00007990: 656e 7420 6120 6675 6e63 7469 6f6e 2072 ent a function r │ │ │ │ │ -000079a0: 6574 7572 6e69 6e67 2061 2067 7275 625f eturning a grub_ │ │ │ │ │ -000079b0: 7569 6e74 3634 5f74 206f 6620 6120 6e75 uint64_t of a nu │ │ │ │ │ -000079c0: 6d62 6572 0a6f 6620 6d69 6c6c 6973 6563 mber.of millisec │ │ │ │ │ -000079d0: 6f6e 6473 2065 6c61 7073 6564 2073 696e onds elapsed sin │ │ │ │ │ -000079e0: 6365 2061 7262 6974 7261 7279 2070 6f69 ce arbitrary poi │ │ │ │ │ -000079f0: 6e74 2069 6e20 7468 6520 7061 7374 2e0a nt in the past.. │ │ │ │ │ -00007a00: 0a20 2020 4f6e 6365 2074 6865 7365 2073 . Once these s │ │ │ │ │ -00007a10: 7465 7073 2061 6363 6f6d 706c 6973 6865 teps accomplishe │ │ │ │ │ -00007a20: 6420 796f 7520 6361 6e20 7265 6d6f 7665 d you can remove │ │ │ │ │ -00007a30: 2074 6865 2069 6e69 6669 6e69 7465 206c the inifinite l │ │ │ │ │ -00007a40: 6f6f 7020 616e 640a 796f 7520 7368 6f75 oop and.you shou │ │ │ │ │ -00007a50: 6c64 2062 6520 6162 6c65 2074 6f20 6765 ld be able to ge │ │ │ │ │ -00007a60: 7420 746f 2074 6865 206d 696e 696d 616c t to the minimal │ │ │ │ │ -00007a70: 2063 6f6e 736f 6c65 2e20 204e 6578 7420 console. Next │ │ │ │ │ -00007a80: 7374 6570 2069 7320 746f 2068 6176 650a step is to have. │ │ │ │ │ -00007a90: 6d6f 6475 6c65 206c 6f61 6469 6e67 2077 module loading w │ │ │ │ │ -00007aa0: 6f72 6b69 6e67 2e20 2046 6f72 2074 6869 orking. For thi │ │ │ │ │ -00007ab0: 7320 796f 7527 6c6c 206e 6565 6420 746f s you'll need to │ │ │ │ │ -00007ac0: 2066 696c 6c20 6b65 726e 2f24 6370 752f fill kern/$cpu/ │ │ │ │ │ -00007ad0: 646c 2e63 2061 6e64 0a6b 6572 6e2f 2463 dl.c and.kern/$c │ │ │ │ │ -00007ae0: 7075 2f63 6163 6865 2e53 2077 6974 6820 pu/cache.S with │ │ │ │ │ -00007af0: 7265 616c 2068 616e 646c 696e 6720 6f66 real handling of │ │ │ │ │ -00007b00: 2072 656c 6f63 6174 696f 6e73 2061 6e64 relocations and │ │ │ │ │ -00007b10: 2072 6573 7065 6374 6976 656c 7920 7468 respectively th │ │ │ │ │ -00007b20: 650a 7265 616c 2073 796e 6320 6f66 2049 e.real sync of I │ │ │ │ │ -00007b30: 2061 6e64 2044 2063 6163 6865 732e 2020 and D caches. │ │ │ │ │ -00007b40: 416c 736f 2079 6f75 276c 6c20 6e65 6564 Also you'll need │ │ │ │ │ -00007b50: 2074 6f20 6465 6369 6465 2077 6865 7265 to decide where │ │ │ │ │ -00007b60: 2069 6e20 7468 650a 696d 6167 6520 746f in the.image to │ │ │ │ │ -00007b70: 2073 746f 7265 2074 6865 206d 6f64 756c store the modul │ │ │ │ │ -00007b80: 6573 2e20 2055 7375 616c 2077 6179 2069 es. Usual way i │ │ │ │ │ -00007b90: 7320 746f 2068 6176 6520 6974 2063 6f6e s to have it con │ │ │ │ │ -00007ba0: 6361 7465 6e61 7465 6420 6174 2074 6865 catenated at the │ │ │ │ │ -00007bb0: 0a65 6e64 2e20 2049 6e20 7468 6973 2063 .end. In this c │ │ │ │ │ -00007bc0: 6173 6520 796f 7527 6c6c 206e 6565 6420 ase you'll need │ │ │ │ │ -00007bd0: 746f 206d 6f64 6966 7920 7374 6172 7475 to modify startu │ │ │ │ │ -00007be0: 702e 5320 746f 2063 6f70 7920 6d6f 6475 p.S to copy modu │ │ │ │ │ -00007bf0: 6c65 7320 6f75 740a 6f66 2062 7373 2074 les out.of bss t │ │ │ │ │ -00007c00: 6f20 6c65 7427 7320 7361 7920 414c 4947 o let's say ALIG │ │ │ │ │ -00007c10: 4e5f 5550 2028 5f65 6e64 2c20 3829 2062 N_UP (_end, 8) b │ │ │ │ │ -00007c20: 6566 6f72 6520 636c 6561 6e69 6e67 206f efore cleaning o │ │ │ │ │ -00007c30: 7574 2062 7373 2e20 2059 6f75 276c 6c0a ut bss. You'll. │ │ │ │ │ -00007c40: 7072 6f62 6162 6c79 2066 696e 6420 7573 probably find us │ │ │ │ │ -00007c50: 6566 756c 2074 6f20 6164 6420 746f 7461 eful to add tota │ │ │ │ │ -00007c60: 6c5f 6d6f 6475 6c65 5f73 697a 6520 6669 l_module_size fi │ │ │ │ │ -00007c70: 656c 6420 746f 2073 7461 7274 7570 2e53 eld to startup.S │ │ │ │ │ -00007c80: 2e20 496e 0a69 6e69 742e 6320 796f 7520 . In.init.c you │ │ │ │ │ -00007c90: 6e65 6564 2074 6f20 7365 7420 6772 7562 need to set grub │ │ │ │ │ -00007ca0: 5f6d 6f64 6261 7365 2074 6f20 7468 6520 _modbase to the │ │ │ │ │ -00007cb0: 6164 6472 6573 7320 7768 6572 6520 6d6f address where mo │ │ │ │ │ -00007cc0: 6475 6c65 7320 6361 6e20 6265 0a66 6f75 dules can be.fou │ │ │ │ │ -00007cd0: 6e64 2e20 2059 6f75 206d 6179 206e 6565 nd. You may nee │ │ │ │ │ -00007ce0: 6420 6772 7562 5f6d 6f64 756c 6573 5f67 d grub_modules_g │ │ │ │ │ -00007cf0: 6574 5f65 6e64 2028 2920 746f 2061 766f et_end () to avo │ │ │ │ │ -00007d00: 6964 2064 6563 6c61 7269 6e67 2074 6865 id declaring the │ │ │ │ │ -00007d10: 0a73 7061 6365 206f 6363 7570 6965 6420 .space occupied │ │ │ │ │ -00007d20: 6279 206d 6f64 756c 6573 2061 7320 7573 by modules as us │ │ │ │ │ -00007d30: 6162 6c65 2066 6f72 2068 6561 702e 2020 able for heap. │ │ │ │ │ -00007d40: 596f 7520 6361 6e20 7465 7374 206d 6f64 You can test mod │ │ │ │ │ -00007d50: 756c 6573 0a77 6974 683a 0a0a 2020 2020 ules.with:.. │ │ │ │ │ -00007d60: 202e 2f67 7275 622d 6d6b 696d 6167 6520 ./grub-mkimage │ │ │ │ │ -00007d70: 2d64 2067 7275 622d 636f 7265 202d 4f20 -d grub-core -O │ │ │ │ │ -00007d80: 2466 6f72 6d61 745f 6964 202d 6f20 7465 $format_id -o te │ │ │ │ │ -00007d90: 7374 2e69 6d67 2068 656c 6c6f 0a0a 2020 st.img hello.. │ │ │ │ │ -00007da0: 2061 6e64 2074 6865 6e20 7275 6e6e 696e and then runnin │ │ │ │ │ -00007db0: 6720 2268 656c 6c6f 2220 696e 2074 6865 g "hello" in the │ │ │ │ │ -00007dc0: 2073 6865 6c6c 2e0a 0a20 2020 4f6e 6365 shell... Once │ │ │ │ │ -00007dd0: 2074 6869 7320 776f 726b 732c 2079 6f75 this works, you │ │ │ │ │ -00007de0: 2073 686f 756c 6420 7468 696e 6b20 6f66 should think of │ │ │ │ │ -00007df0: 2069 6d70 6c65 6d65 6e74 696e 6720 6469 implementing di │ │ │ │ │ -00007e00: 736b 2061 6363 6573 732e 2020 4c6f 6f6b sk access. Look │ │ │ │ │ -00007e10: 0a61 726f 756e 6420 6469 736b 2f20 666f .around disk/ fo │ │ │ │ │ -00007e20: 7220 6578 616d 706c 6573 2e0a 0a20 2020 r examples... │ │ │ │ │ -00007e30: 5468 656e 2c20 7665 7279 2069 6d70 6f72 Then, very impor │ │ │ │ │ -00007e40: 7461 6e74 6c79 2c20 796f 7520 7072 6f62 tantly, you prob │ │ │ │ │ -00007e50: 6162 6c79 206e 6565 6420 746f 2069 6d70 ably need to imp │ │ │ │ │ -00007e60: 6c65 6d65 6e74 2074 6865 2061 6374 7561 lement the actua │ │ │ │ │ -00007e70: 6c0a 6c6f 6164 6572 2028 6578 616d 706c l.loader (exampl │ │ │ │ │ -00007e80: 6573 2061 7661 696c 6162 6c65 2069 6e20 es available in │ │ │ │ │ -00007e90: 6c6f 6164 6572 2f29 0a0a 2020 204c 6173 loader/).. Las │ │ │ │ │ -00007ea0: 7420 7374 6570 2074 6f20 6861 7665 206d t step to have m │ │ │ │ │ -00007eb0: 696e 696d 616c 6c79 2075 7361 626c 6520 inimally usable │ │ │ │ │ -00007ec0: 706f 7274 2069 7320 746f 2061 6464 2073 port is to add s │ │ │ │ │ -00007ed0: 7570 706f 7274 2074 6f0a 6772 7562 2d69 upport to.grub-i │ │ │ │ │ -00007ee0: 6e73 7461 6c6c 2074 6f20 7075 7420 4752 nstall to put GR │ │ │ │ │ -00007ef0: 5542 2069 6e20 6120 706c 6163 6520 7768 UB in a place wh │ │ │ │ │ -00007f00: 6572 6520 6669 726d 7761 7265 206f 7220 ere firmware or │ │ │ │ │ -00007f10: 706c 6174 666f 726d 2077 696c 6c20 7069 platform will pi │ │ │ │ │ -00007f20: 636b 0a69 7420 7570 2e0a 0a20 2020 4e65 ck.it up... Ne │ │ │ │ │ -00007f30: 7874 2073 7465 7073 2061 7265 3a20 6669 xt steps are: fi │ │ │ │ │ -00007f40: 6c6c 696e 6720 6461 7465 7469 6d65 2e63 lling datetime.c │ │ │ │ │ -00007f50: 2c20 7365 746a 6d70 2e53 2c20 6e65 7477 , setjmp.S, netw │ │ │ │ │ -00007f60: 6f72 6b20 286e 6574 2f64 7269 7665 7273 ork (net/drivers │ │ │ │ │ -00007f70: 292c 0a76 6964 656f 2028 7669 6465 6f2f ),.video (video/ │ │ │ │ │ -00007f80: 292c 2068 616c 7420 286c 6962 2f29 2c20 ), halt (lib/), │ │ │ │ │ -00007f90: 7265 626f 6f74 2028 6c69 622f 292e 0a0a reboot (lib/)... │ │ │ │ │ -00007fa0: 2020 2050 6c65 6173 6520 6164 6420 796f Please add yo │ │ │ │ │ -00007fb0: 7572 2070 6c61 7466 6f72 6d20 746f 2050 ur platform to P │ │ │ │ │ -00007fc0: 6c61 7466 6f72 6d20 6c69 6d69 7461 7469 latform limitati │ │ │ │ │ -00007fd0: 6f6e 7320 616e 6420 5375 7070 6f72 7465 ons and Supporte │ │ │ │ │ -00007fe0: 640a 6b65 726e 656c 7320 6368 6170 7465 d.kernels chapte │ │ │ │ │ -00007ff0: 7220 696e 2075 7365 7220 646f 6375 6d65 r in user docume │ │ │ │ │ -00008000: 6e74 6174 696f 6e20 616e 6420 6d65 6e74 ntation and ment │ │ │ │ │ -00008010: 696f 6e20 616e 7920 7374 6570 7320 796f ion any steps yo │ │ │ │ │ -00008020: 7520 736b 6970 7065 640a 7768 6963 6820 u skipped.which │ │ │ │ │ -00008030: 7265 7375 6c74 2069 6e20 7265 6475 6365 result in reduce │ │ │ │ │ -00008040: 6420 6665 6174 7572 6573 206f 7220 7065 d features or pe │ │ │ │ │ -00008050: 7266 6f72 6d61 6e63 652e 2020 4865 7265 rformance. Here │ │ │ │ │ -00008060: 2069 7320 7468 6520 7175 6963 6b0a 6368 is the quick.ch │ │ │ │ │ -00008070: 6563 6b6c 6973 7420 6f66 2066 6561 7475 ecklist of featu │ │ │ │ │ -00008080: 7265 732e 2020 536f 6d65 206f 6620 7468 res. Some of th │ │ │ │ │ -00008090: 656d 2061 7265 206c 6573 7320 696d 706f em are less impo │ │ │ │ │ -000080a0: 7274 616e 7420 7468 616e 206f 7468 6572 rtant than other │ │ │ │ │ -000080b0: 7320 616e 640a 736b 6970 7069 6e67 2074 s and.skipping t │ │ │ │ │ -000080c0: 6865 6d20 6973 2063 6f6d 706c 6574 656c hem is completel │ │ │ │ │ -000080d0: 7920 6f6b 2c20 6a75 7374 206e 6565 6473 y ok, just needs │ │ │ │ │ -000080e0: 2074 6f20 6265 206d 656e 7469 6f6e 6564 to be mentioned │ │ │ │ │ -000080f0: 2069 6e20 7573 6572 0a64 6f63 756d 656e in user.documen │ │ │ │ │ -00008100: 7461 7469 6f6e 2e0a 0a20 2020 4368 6563 tation... Chec │ │ │ │ │ -00008110: 6b6c 6973 743a 0a20 2020 2a20 4973 2068 klist:. * Is h │ │ │ │ │ -00008120: 6561 7020 6269 6720 656e 6f75 6768 3f0a eap big enough?. │ │ │ │ │ -00008130: 2020 202a 2057 6869 6368 2063 6861 7273 * Which chars │ │ │ │ │ -00008140: 6574 2069 7320 7375 7070 6f72 7465 6420 et is supported │ │ │ │ │ -00008150: 6279 2063 6f6e 736f 6c65 3f0a 2020 202a by console?. * │ │ │ │ │ -00008160: 2044 6f65 7320 706c 6174 666f 726d 2068 Does platform h │ │ │ │ │ -00008170: 6176 6520 6469 736b 2064 7269 7665 723f ave disk driver? │ │ │ │ │ -00008180: 0a20 2020 2a20 446f 2079 6f75 2068 6176 . * Do you hav │ │ │ │ │ -00008190: 6520 6e65 7477 6f72 6b20 6361 7264 2073 e network card s │ │ │ │ │ -000081a0: 7570 706f 7274 3f0a 2020 202a 2041 7265 upport?. * Are │ │ │ │ │ -000081b0: 2079 6f75 2061 626c 6520 746f 2072 6574 you able to ret │ │ │ │ │ -000081c0: 7269 6576 6520 6461 7465 7469 6d65 2028 rieve datetime ( │ │ │ │ │ -000081d0: 7769 7468 2064 6174 6529 3f0a 2020 202a with date)?. * │ │ │ │ │ -000081e0: 2041 7265 2079 6f75 2061 626c 6520 746f Are you able to │ │ │ │ │ -000081f0: 2073 6574 2064 6174 6574 696d 6520 2877 set datetime (w │ │ │ │ │ -00008200: 6974 6820 6461 7465 293f 0a20 2020 2a20 ith date)?. * │ │ │ │ │ -00008210: 4973 2073 6572 6961 6c20 7375 7070 6f72 Is serial suppor │ │ │ │ │ -00008220: 7465 643f 0a20 2020 2a20 446f 2079 6f75 ted?. * Do you │ │ │ │ │ -00008230: 2068 6176 6520 6469 7265 6374 2064 6973 have direct dis │ │ │ │ │ -00008240: 6b20 7375 7070 6f72 743f 0a20 2020 2a20 k support?. * │ │ │ │ │ -00008250: 446f 2079 6f75 2068 6176 6520 6469 7265 Do you have dire │ │ │ │ │ -00008260: 6374 206b 6579 626f 6172 6420 7375 7070 ct keyboard supp │ │ │ │ │ -00008270: 6f72 743f 0a20 2020 2a20 446f 2079 6f75 ort?. * Do you │ │ │ │ │ -00008280: 2068 6176 6520 5553 4220 7375 7070 6f72 have USB suppor │ │ │ │ │ -00008290: 743f 0a20 2020 2a20 446f 2079 6f75 2073 t?. * Do you s │ │ │ │ │ -000082a0: 7570 706f 7274 206c 6f61 6469 6e67 2074 upport loading t │ │ │ │ │ -000082b0: 6872 6f75 6768 206e 6574 776f 726b 3f0a hrough network?. │ │ │ │ │ -000082c0: 2020 202a 2044 6f20 796f 7520 7375 7070 * Do you supp │ │ │ │ │ -000082d0: 6f72 7420 6c6f 6164 696e 6720 6672 6f6d ort loading from │ │ │ │ │ -000082e0: 2064 6973 6b3f 0a20 2020 2a20 446f 2079 disk?. * Do y │ │ │ │ │ -000082f0: 6f75 2073 7570 706f 7274 2063 6861 696e ou support chain │ │ │ │ │ -00008300: 6c6f 6164 696e 673f 0a20 2020 2a20 446f loading?. * Do │ │ │ │ │ -00008310: 2079 6f75 2073 7570 706f 7274 206e 6574 you support net │ │ │ │ │ -00008320: 776f 726b 2063 6861 696e 6c6f 6164 696e work chainloadin │ │ │ │ │ -00008330: 673f 0a20 2020 2a20 446f 6573 2063 7075 g?. * Does cpu │ │ │ │ │ -00008340: 6964 2063 6f6d 6d61 6e64 2073 7570 706f id command suppo │ │ │ │ │ -00008350: 7274 7320 6368 6563 6b69 6e67 2061 6c6c rts checking all │ │ │ │ │ -00008360: 2043 5055 2066 6561 7475 7265 7320 7468 CPU features th │ │ │ │ │ -00008370: 6174 2074 6865 2075 7365 720a 2020 2020 at the user. │ │ │ │ │ -00008380: 206d 6967 6874 2077 616e 7420 636f 6e64 might want cond │ │ │ │ │ -00008390: 6974 696f 6e61 6c69 7365 206f 6e20 2836 itionalise on (6 │ │ │ │ │ -000083a0: 342d 6269 7420 6d6f 6465 2c20 6879 7065 4-bit mode, hype │ │ │ │ │ -000083b0: 7276 6973 6f72 2c2e 2e2e 290a 2020 202a rvisor,...). * │ │ │ │ │ -000083c0: 2044 6f20 796f 7520 7375 7070 6f72 7420 Do you support │ │ │ │ │ -000083d0: 6869 6e74 733f 2020 486f 7720 7265 6c69 hints? How reli │ │ │ │ │ -000083e0: 6162 6c65 2061 7265 2074 6865 793f 0a20 able are they?. │ │ │ │ │ -000083f0: 2020 2a20 446f 6573 2070 6c61 7466 6f72 * Does platfor │ │ │ │ │ -00008400: 6d20 6861 7665 2041 4350 493f 2049 6620 m have ACPI? If │ │ │ │ │ -00008410: 736f 2064 6f20 2261 6370 6922 2061 6e64 so do "acpi" and │ │ │ │ │ -00008420: 2022 6c73 6163 7069 2220 6d6f 6475 6c65 "lsacpi" module │ │ │ │ │ -00008430: 7320 776f 726b 3f0a 2020 202a 2044 6f20 s work?. * Do │ │ │ │ │ -00008440: 616e 7920 6f66 2070 6c61 7466 6f72 6d2d any of platform- │ │ │ │ │ -00008450: 7370 6563 6966 6963 206f 7065 7261 7469 specific operati │ │ │ │ │ -00008460: 6f6e 7320 6d65 6e74 696f 6e65 6420 696e ons mentioned in │ │ │ │ │ -00008470: 2074 6865 2072 656c 6576 616e 740a 2020 the relevant. │ │ │ │ │ -00008480: 2020 2073 6563 7469 6f6e 206f 6620 7573 section of us │ │ │ │ │ -00008490: 6572 206d 616e 7561 6c20 6d61 6b65 7320 er manual makes │ │ │ │ │ -000084a0: 7365 6e73 6520 6f6e 2079 6f75 7220 706c sense on your pl │ │ │ │ │ -000084b0: 6174 666f 726d 3f0a 2020 202a 2044 6f65 atform?. * Doe │ │ │ │ │ -000084c0: 7320 796f 7572 2070 6c61 7466 6f72 6d20 s your platform │ │ │ │ │ -000084d0: 7375 7070 6f72 7420 5043 493f 2049 6620 support PCI? If │ │ │ │ │ -000084e0: 736f 2069 7320 7468 6572 6520 616e 2061 so is there an a │ │ │ │ │ -000084f0: 7070 726f 7072 6961 7465 0a20 2020 2020 ppropriate. │ │ │ │ │ -00008500: 6472 6976 6572 2066 6f72 2047 5255 423f driver for GRUB? │ │ │ │ │ -00008510: 0a20 2020 2a20 446f 2079 6f75 2073 7570 . * Do you sup │ │ │ │ │ -00008520: 706f 7274 2062 6164 7261 6d3f 0a0a 1f0a port badram?.... │ │ │ │ │ -00008530: 4669 6c65 3a20 6772 7562 2d64 6576 2e69 File: grub-dev.i │ │ │ │ │ -00008540: 6e66 6f2c 2020 4e6f 6465 3a20 4572 726f nfo, Node: Erro │ │ │ │ │ -00008550: 7220 4861 6e64 6c69 6e67 2c20 204e 6578 r Handling, Nex │ │ │ │ │ -00008560: 743a 2053 7461 636b 2061 6e64 2068 6561 t: Stack and hea │ │ │ │ │ -00008570: 7020 7369 7a65 2c20 2050 7265 763a 2050 p size, Prev: P │ │ │ │ │ -00008580: 6f72 7469 6e67 2c20 2055 703a 2054 6f70 orting, Up: Top │ │ │ │ │ -00008590: 0a0a 3720 4572 726f 7220 4861 6e64 6c69 ..7 Error Handli │ │ │ │ │ -000085a0: 6e67 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a ng.************* │ │ │ │ │ -000085b0: 2a2a 2a0a 0a45 7272 6f72 2068 616e 646c ***..Error handl │ │ │ │ │ -000085c0: 696e 6720 696e 2047 5255 4220 3220 6973 ing in GRUB 2 is │ │ │ │ │ -000085d0: 2062 6173 6564 206f 6e20 6578 6365 7074 based on except │ │ │ │ │ -000085e0: 696f 6e20 6861 6e64 6c69 6e67 206d 6f64 ion handling mod │ │ │ │ │ -000085f0: 656c 2e20 2041 7320 430a 6c61 6e67 7561 el. As C.langua │ │ │ │ │ -00008600: 6765 2064 6f65 736e 2774 2064 6972 6563 ge doesn't direc │ │ │ │ │ -00008610: 746c 7920 7375 7070 6f72 7420 6578 6365 tly support exce │ │ │ │ │ -00008620: 7074 696f 6e73 2c20 6578 6365 7074 696f ptions, exceptio │ │ │ │ │ -00008630: 6e20 6861 6e64 6c69 6e67 0a62 6568 6176 n handling.behav │ │ │ │ │ -00008640: 696f 7220 6973 2065 6d75 6c61 7465 6420 ior is emulated │ │ │ │ │ -00008650: 696e 2073 6f66 7477 6172 652e 0a0a 2020 in software... │ │ │ │ │ -00008660: 2057 6865 6e20 6578 6365 7074 696f 6e20 When exception │ │ │ │ │ -00008670: 6973 2072 6169 7365 642c 2066 756e 6374 is raised, funct │ │ │ │ │ -00008680: 696f 6e20 6d75 7374 2072 6574 7572 6e20 ion must return │ │ │ │ │ -00008690: 746f 2063 616c 6c69 6e67 2066 756e 6374 to calling funct │ │ │ │ │ -000086a0: 696f 6e2e 0a49 6620 6361 6c6c 696e 6720 ion..If calling │ │ │ │ │ -000086b0: 6675 6e63 7469 6f6e 2064 6f65 7320 6e6f function does no │ │ │ │ │ -000086c0: 7420 7072 6f76 6964 6520 6861 6e64 6c69 t provide handli │ │ │ │ │ -000086d0: 6e67 206f 6620 7468 6520 6578 6365 7074 ng of the except │ │ │ │ │ -000086e0: 696f 6e20 6974 206d 7573 740a 7265 7475 ion it must.retu │ │ │ │ │ -000086f0: 726e 2062 6163 6b20 746f 2069 7473 2063 rn back to its c │ │ │ │ │ -00008700: 616c 6c69 6e67 2066 756e 6374 696f 6e20 alling function │ │ │ │ │ -00008710: 616e 6420 736f 206f 6e2c 2075 6e74 696c and so on, until │ │ │ │ │ -00008720: 2065 7863 6570 7469 6f6e 2069 730a 6861 exception is.ha │ │ │ │ │ -00008730: 6e64 6c65 642e 2020 4966 2065 7863 6570 ndled. If excep │ │ │ │ │ -00008740: 7469 6f6e 2069 7320 6e6f 7420 6861 6e64 tion is not hand │ │ │ │ │ -00008750: 6c65 6420 6265 666f 7265 2070 726f 6d70 led before promp │ │ │ │ │ -00008760: 7420 6973 2064 6973 706c 6179 6564 2c20 t is displayed, │ │ │ │ │ -00008770: 6572 726f 720a 6d65 7373 6167 6520 7769 error.message wi │ │ │ │ │ -00008780: 6c6c 2062 6520 7368 6f77 6e20 746f 2075 ll be shown to u │ │ │ │ │ -00008790: 7365 722e 0a0a 2020 2045 7863 6570 7469 ser... Excepti │ │ │ │ │ -000087a0: 6f6e 2069 6e66 6f72 6d61 7469 6f6e 2069 on information i │ │ │ │ │ -000087b0: 7320 7374 6f72 6564 206f 6e20 2767 7275 s stored on 'gru │ │ │ │ │ -000087c0: 625f 6572 726e 6f27 2067 6c6f 6261 6c20 b_errno' global │ │ │ │ │ -000087d0: 7661 7269 6162 6c65 2e20 2049 660a 2767 variable. If.'g │ │ │ │ │ -000087e0: 7275 625f 6572 726e 6f27 2076 6172 6961 rub_errno' varia │ │ │ │ │ -000087f0: 626c 6520 636f 6e74 6169 6e73 2076 616c ble contains val │ │ │ │ │ -00008800: 7565 2027 4752 5542 5f45 5252 5f4e 4f4e ue 'GRUB_ERR_NON │ │ │ │ │ -00008810: 4527 2c20 7468 6572 6520 6973 206e 6f20 E', there is no │ │ │ │ │ -00008820: 6163 7469 7665 0a65 7863 6570 7469 6f6e active.exception │ │ │ │ │ -00008830: 2061 6e64 2061 7070 6c69 6361 7469 6f6e and application │ │ │ │ │ -00008840: 2063 616e 2063 6f6e 7469 6e75 6520 6e6f can continue no │ │ │ │ │ -00008850: 726d 616c 2070 726f 6365 7373 696e 672e rmal processing. │ │ │ │ │ -00008860: 2020 5768 656e 0a27 6772 7562 5f65 7272 When.'grub_err │ │ │ │ │ -00008870: 6e6f 2720 6861 7320 6f74 6865 7220 7661 no' has other va │ │ │ │ │ -00008880: 6c75 652c 2069 7420 6973 2072 6571 7569 lue, it is requi │ │ │ │ │ -00008890: 7265 6420 7468 6174 2061 7070 6c69 6361 red that applica │ │ │ │ │ -000088a0: 7469 6f6e 2063 6f64 650a 6569 7468 6572 tion code.either │ │ │ │ │ -000088b0: 2068 616e 646c 6573 2074 6869 7320 6572 handles this er │ │ │ │ │ -000088c0: 726f 7220 6f72 2072 6574 7572 6e73 2069 ror or returns i │ │ │ │ │ -000088d0: 6e73 7461 6e74 6c79 2074 6f20 6361 6c6c nstantly to call │ │ │ │ │ -000088e0: 6572 2e20 2049 6620 6675 6e63 7469 6f6e er. If function │ │ │ │ │ -000088f0: 0a69 7320 7769 7468 2072 6574 7572 6e20 .is with return │ │ │ │ │ -00008900: 7479 7065 2027 6772 7562 5f65 7272 5f74 type 'grub_err_t │ │ │ │ │ -00008910: 2720 6973 2061 626f 7574 2074 6f20 7265 ' is about to re │ │ │ │ │ -00008920: 7475 726e 2027 4752 5542 5f45 5252 5f4e turn 'GRUB_ERR_N │ │ │ │ │ -00008930: 4f4e 4527 2c20 6974 0a73 686f 756c 6420 ONE', it.should │ │ │ │ │ -00008940: 6e6f 7420 7365 7420 2767 7275 625f 6572 not set 'grub_er │ │ │ │ │ -00008950: 726e 6f27 2074 6f20 7468 6174 2076 616c rno' to that val │ │ │ │ │ -00008960: 7565 2e20 204f 6e6c 7920 7365 7420 2767 ue. Only set 'g │ │ │ │ │ -00008970: 7275 625f 6572 726e 6f27 2069 6e0a 6361 rub_errno' in.ca │ │ │ │ │ -00008980: 7365 7320 7768 6572 6520 7468 6572 6520 ses where there │ │ │ │ │ -00008990: 6973 2065 7272 6f72 2073 6974 7561 7469 is error situati │ │ │ │ │ -000089a0: 6f6e 2e0a 0a20 2020 5369 6d70 6c65 2065 on... Simple e │ │ │ │ │ -000089b0: 7863 6570 7469 6f6e 2066 6f72 7761 7264 xception forward │ │ │ │ │ -000089c0: 6572 2e0a 2020 2020 2067 7275 625f 6572 er.. grub_er │ │ │ │ │ -000089d0: 725f 740a 2020 2020 2066 6f72 7761 7264 r_t. forward │ │ │ │ │ -000089e0: 696e 675f 6578 616d 706c 6520 2876 6f69 ing_example (voi │ │ │ │ │ -000089f0: 6429 0a20 2020 2020 7b0a 2020 2020 2020 d). {. │ │ │ │ │ -00008a00: 202f 2a20 4361 6c6c 2066 756e 6374 696f /* Call functio │ │ │ │ │ -00008a10: 6e20 7468 6174 206d 6967 6874 2063 6175 n that might cau │ │ │ │ │ -00008a20: 7365 2065 7863 6570 7469 6f6e 2e20 202a se exception. * │ │ │ │ │ -00008a30: 2f0a 2020 2020 2020 2066 6f6f 6261 7220 /. foobar │ │ │ │ │ -00008a40: 2829 3b0a 0a20 2020 2020 2020 2f2a 204e ();.. /* N │ │ │ │ │ -00008a50: 6f20 7370 6563 6961 6c20 6578 6365 7074 o special except │ │ │ │ │ -00008a60: 696f 6e20 6861 6e64 6c65 722c 206a 7573 ion handler, jus │ │ │ │ │ -00008a70: 7420 666f 7277 6172 6420 706f 7373 6962 t forward possib │ │ │ │ │ -00008a80: 6c65 2065 7863 6570 7469 6f6e 732e 2020 le exceptions. │ │ │ │ │ -00008a90: 2a2f 0a20 2020 2020 2020 6966 2028 6772 */. if (gr │ │ │ │ │ -00008aa0: 7562 5f65 7272 6e6f 2021 3d20 4752 5542 ub_errno != GRUB │ │ │ │ │ -00008ab0: 5f45 5252 5f4e 4f4e 4529 0a20 2020 2020 _ERR_NONE). │ │ │ │ │ -00008ac0: 2020 2020 7b0a 2020 2020 2020 2020 2020 {. │ │ │ │ │ -00008ad0: 2072 6574 7572 6e20 6772 7562 5f65 7272 return grub_err │ │ │ │ │ -00008ae0: 6e6f 3b0a 2020 2020 2020 2020 207d 0a0a no;. }.. │ │ │ │ │ -00008af0: 2020 2020 2020 202f 2a20 416c 6c20 6973 /* All is │ │ │ │ │ -00008b00: 204f 4b2c 2064 6f20 6d6f 7265 2070 726f OK, do more pro │ │ │ │ │ -00008b10: 6365 7373 696e 672e 2020 2a2f 0a0a 2020 cessing. */.. │ │ │ │ │ -00008b20: 2020 2020 202f 2a20 5265 7475 726e 204f /* Return O │ │ │ │ │ -00008b30: 4b20 7369 676e 616c 2c20 746f 2063 616c K signal, to cal │ │ │ │ │ -00008b40: 6c65 722e 2020 2a2f 0a20 2020 2020 2020 ler. */. │ │ │ │ │ -00008b50: 7265 7475 726e 2047 5255 425f 4552 525f return GRUB_ERR_ │ │ │ │ │ -00008b60: 4e4f 4e45 3b0a 2020 2020 207d 0a0a 2020 NONE;. }.. │ │ │ │ │ -00008b70: 2045 7272 6f72 2072 6570 6f72 7469 6e67 Error reporting │ │ │ │ │ -00008b80: 2068 6173 2074 776f 2063 6f6d 706f 6e65 has two compone │ │ │ │ │ -00008b90: 6e74 732c 2074 6865 2061 6374 7561 6c20 nts, the actual │ │ │ │ │ -00008ba0: 6572 726f 7220 636f 6465 2028 6f66 2074 error code (of t │ │ │ │ │ -00008bb0: 7970 650a 2767 7275 625f 6572 725f 7427 ype.'grub_err_t' │ │ │ │ │ -00008bc0: 2920 616e 6420 7465 7874 7561 6c20 6d65 ) and textual me │ │ │ │ │ -00008bd0: 7373 6167 6520 7468 6174 2077 696c 6c20 ssage that will │ │ │ │ │ -00008be0: 6265 2064 6973 706c 6179 6564 2074 6f20 be displayed to │ │ │ │ │ -00008bf0: 7573 6572 2e20 204c 6973 740a 6f66 2076 user. List.of v │ │ │ │ │ -00008c00: 616c 6964 2065 7272 6f72 2063 6f64 6573 alid error codes │ │ │ │ │ -00008c10: 2069 7320 6c69 7374 6564 2069 6e20 6865 is listed in he │ │ │ │ │ -00008c20: 6164 6572 2066 696c 6520 2769 6e63 6c75 ader file 'inclu │ │ │ │ │ -00008c30: 6465 2f67 7275 622f 6572 722e 6827 2e0a de/grub/err.h'.. │ │ │ │ │ -00008c40: 5465 7874 7561 6c20 6572 726f 7220 6d65 Textual error me │ │ │ │ │ -00008c50: 7373 6167 6520 6361 6e20 636f 6e74 6169 ssage can contai │ │ │ │ │ -00008c60: 6e20 616e 7920 7465 7874 7561 6c20 6461 n any textual da │ │ │ │ │ -00008c70: 7461 2e20 2041 7420 7469 6d65 206f 6620 ta. At time of │ │ │ │ │ -00008c80: 7772 6974 696e 672c 0a65 7272 6f72 206d writing,.error m │ │ │ │ │ -00008c90: 6573 7361 6765 2063 616e 2063 6f6e 7461 essage can conta │ │ │ │ │ -00008ca0: 696e 2075 7020 746f 2032 3536 2063 6861 in up to 256 cha │ │ │ │ │ -00008cb0: 7261 6374 6572 7320 2869 6e63 6c75 6469 racters (includi │ │ │ │ │ -00008cc0: 6e67 2074 6572 6d69 6e61 7469 6e67 0a4e ng terminating.N │ │ │ │ │ -00008cd0: 554c 292e 2054 6f20 6561 7365 2065 7272 UL). To ease err │ │ │ │ │ -00008ce0: 6f72 2072 6570 6f72 7469 6e67 2074 6865 or reporting the │ │ │ │ │ -00008cf0: 7265 2069 7320 6120 6865 6c70 6572 2066 re is a helper f │ │ │ │ │ -00008d00: 756e 6374 696f 6e20 2767 7275 625f 6572 unction 'grub_er │ │ │ │ │ -00008d10: 726f 7227 0a74 6861 7420 616c 6c6f 7773 ror'.that allows │ │ │ │ │ -00008d20: 2065 6173 6965 7220 666f 726d 6174 7469 easier formatti │ │ │ │ │ -00008d30: 6e67 206f 6620 6572 726f 7220 6d65 7373 ng of error mess │ │ │ │ │ -00008d40: 6167 6573 2061 6e64 2073 686f 756c 6420 ages and should │ │ │ │ │ -00008d50: 6265 2075 7365 640a 696e 7374 6561 6420 be used.instead │ │ │ │ │ -00008d60: 6f66 2077 7269 7469 6e67 2064 6972 6563 of writing direc │ │ │ │ │ -00008d70: 746c 7920 746f 2067 6c6f 6261 6c20 7661 tly to global va │ │ │ │ │ -00008d80: 7269 6162 6c65 732e 0a0a 2020 2045 7861 riables... Exa │ │ │ │ │ -00008d90: 6d70 6c65 206f 6620 6572 726f 7220 7265 mple of error re │ │ │ │ │ -00008da0: 706f 7274 696e 672e 0a20 2020 2020 6772 porting.. gr │ │ │ │ │ -00008db0: 7562 5f65 7272 5f74 0a20 2020 2020 6661 ub_err_t. fa │ │ │ │ │ -00008dc0: 696c 696e 675f 6578 616d 706c 6520 2829 iling_example () │ │ │ │ │ -00008dd0: 0a20 2020 2020 7b0a 2020 2020 2020 2072 . {. r │ │ │ │ │ -00008de0: 6574 7572 6e20 6772 7562 5f65 7272 6f72 eturn grub_error │ │ │ │ │ -00008df0: 2028 4752 5542 5f45 5252 5f46 494c 455f (GRUB_ERR_FILE_ │ │ │ │ │ -00008e00: 4e4f 545f 464f 554e 442c 0a20 2020 2020 NOT_FOUND,. │ │ │ │ │ +00006b40: 2022 6d69 7073 5f71 656d 755f 6d69 7073 "mips_qemu_mips │ │ │ │ │ +00006b50: 222c 2022 7333 3930 5f6d 6169 6e66 7261 ", "s390_mainfra │ │ │ │ │ +00006b60: 6d65 2220 5d0a 0a20 2020 596f 7520 6d61 me" ].. You ma │ │ │ │ │ +00006b70: 7920 616c 736f 2077 616e 7420 616c 7265 y also want alre │ │ │ │ │ +00006b80: 6164 7920 746f 2061 6464 206e 6577 2070 ady to add new p │ │ │ │ │ +00006b90: 6c61 7466 6f72 6d20 746f 206f 6e65 206f latform to one o │ │ │ │ │ +00006ba0: 7220 7365 7665 7261 6c20 6f66 0a61 7661 r several of.ava │ │ │ │ │ +00006bb0: 696c 6162 6c65 2067 726f 7570 732e 2020 ilable groups. │ │ │ │ │ +00006bc0: 496e 2070 6172 7469 6375 6c61 7220 7765 In particular we │ │ │ │ │ +00006bd0: 2061 6c77 6179 7320 6861 7665 2061 2067 always have a g │ │ │ │ │ +00006be0: 726f 7570 2066 6f72 2065 6163 6820 4350 roup for each CP │ │ │ │ │ +00006bf0: 550a 6576 656e 2077 6865 6e20 6f6e 6c79 U.even when only │ │ │ │ │ +00006c00: 206f 6e65 2070 6c61 7466 6f72 6d20 666f one platform fo │ │ │ │ │ +00006c10: 7220 6769 7665 6e20 4350 5520 6973 2061 r given CPU is a │ │ │ │ │ +00006c20: 7661 696c 6162 6c65 2e0a 0a20 2020 5468 vailable... Th │ │ │ │ │ +00006c30: 656e 2063 6f6d 6573 2067 7275 622d 636f en comes grub-co │ │ │ │ │ +00006c40: 7265 2f4d 616b 6566 696c 652e 636f 7265 re/Makefile.core │ │ │ │ │ +00006c50: 2e64 6566 2e20 2049 6e20 7468 6520 626c .def. In the bl │ │ │ │ │ +00006c60: 6f63 6b20 226b 6572 6e65 6c22 2079 6f75 ock "kernel" you │ │ │ │ │ +00006c70: 276c 6c0a 6e65 6564 2074 6f20 6465 6669 'll.need to defi │ │ │ │ │ +00006c80: 6e65 206c 6466 6c61 6773 2066 6f72 2079 ne ldflags for y │ │ │ │ │ +00006c90: 6f75 7220 706c 6174 666f 726d 2028 2463 our platform ($c │ │ │ │ │ +00006ca0: 7075 5f24 706c 6174 666f 726d 5f6c 6466 pu_$platform_ldf │ │ │ │ │ +00006cb0: 6c61 6773 292e 2020 596f 750a 616c 736f lags). You.also │ │ │ │ │ +00006cc0: 206e 6565 6420 746f 2064 6563 6c61 7265 need to declare │ │ │ │ │ +00006cd0: 2073 7461 7274 7570 2061 736d 2066 696c startup asm fil │ │ │ │ │ +00006ce0: 6520 2824 6370 755f 2470 6c61 7466 6f72 e ($cpu_$platfor │ │ │ │ │ +00006cf0: 6d5f 7374 6172 7475 7029 2061 7320 7765 m_startup) as we │ │ │ │ │ +00006d00: 6c6c 0a61 7320 616e 7920 6f74 6865 7220 ll.as any other │ │ │ │ │ +00006d10: 6669 6c65 7320 2865 2e67 2e20 2069 6e69 files (e.g. ini │ │ │ │ │ +00006d20: 742e 6320 616e 6420 6361 6c6c 7772 6170 t.c and callwrap │ │ │ │ │ +00006d30: 2e53 2920 2865 2e67 2e20 2024 6370 755f .S) (e.g. $cpu_ │ │ │ │ │ +00006d40: 2470 6c61 7466 6f72 6d20 3d0a 6b65 726e $platform =.kern │ │ │ │ │ +00006d50: 2f24 6370 752f 2470 6c61 7466 6f72 6d2f /$cpu/$platform/ │ │ │ │ │ +00006d60: 696e 6974 2e63 292e 2020 4174 2074 6869 init.c). At thi │ │ │ │ │ +00006d70: 7320 7374 6167 6520 796f 7520 7769 6c6c s stage you will │ │ │ │ │ +00006d80: 2061 6c73 6f20 6e65 6564 2074 6f20 6164 also need to ad │ │ │ │ │ +00006d90: 640a 6475 6d6d 7920 646c 2e63 2061 6e64 d.dummy dl.c and │ │ │ │ │ +00006da0: 2063 6163 6865 2e53 2077 6974 6820 6675 cache.S with fu │ │ │ │ │ +00006db0: 6e63 7469 6f6e 7320 6772 7562 5f65 7272 nctions grub_err │ │ │ │ │ +00006dc0: 5f74 0a67 7275 625f 6172 6368 5f64 6c5f _t.grub_arch_dl_ │ │ │ │ │ +00006dd0: 6368 6563 6b5f 6865 6164 6572 2028 766f check_header (vo │ │ │ │ │ +00006de0: 6964 202a 6568 6472 292c 2067 7275 625f id *ehdr), grub_ │ │ │ │ │ +00006df0: 6572 725f 740a 6772 7562 5f61 7263 685f err_t.grub_arch_ │ │ │ │ │ +00006e00: 646c 5f72 656c 6f63 6174 655f 7379 6d62 dl_relocate_symb │ │ │ │ │ +00006e10: 6f6c 7320 2867 7275 625f 646c 5f74 206d ols (grub_dl_t m │ │ │ │ │ +00006e20: 6f64 2c20 766f 6964 202a 6568 6472 2920 od, void *ehdr) │ │ │ │ │ +00006e30: 2864 6c2e 6329 2061 6e64 0a76 6f69 6420 (dl.c) and.void │ │ │ │ │ +00006e40: 6772 7562 5f61 7263 685f 7379 6e63 5f63 grub_arch_sync_c │ │ │ │ │ +00006e50: 6163 6865 7320 2876 6f69 6420 2a61 6464 aches (void *add │ │ │ │ │ +00006e60: 7265 7373 2c20 6772 7562 5f73 697a 655f ress, grub_size_ │ │ │ │ │ +00006e70: 7420 6c65 6e29 2028 6361 6368 652e 5329 t len) (cache.S) │ │ │ │ │ +00006e80: 2e0a 5468 6579 2077 6f6e 2774 2062 6520 ..They won't be │ │ │ │ │ +00006e90: 7573 6564 2066 6f72 206e 6f77 2e0a 0a20 used for now... │ │ │ │ │ +00006ea0: 2020 596f 7520 7769 6c6c 206e 6565 6420 You will need │ │ │ │ │ +00006eb0: 746f 2063 7265 6174 6520 6469 7265 6374 to create direct │ │ │ │ │ +00006ec0: 6f72 7920 696e 636c 7564 652f 2463 7075 ory include/$cpu │ │ │ │ │ +00006ed0: 2f24 706c 6174 666f 726d 2061 6e64 2061 /$platform and a │ │ │ │ │ +00006ee0: 2066 696c 650a 696e 636c 7564 652f 2463 file.include/$c │ │ │ │ │ +00006ef0: 7075 2f74 7970 6573 2e68 2e20 2054 6865 pu/types.h. The │ │ │ │ │ +00006f00: 206c 6174 6572 2066 6f6c 6f77 696e 6720 later folowing │ │ │ │ │ +00006f10: 7468 6973 2074 656d 706c 6174 653a 0a0a this template:.. │ │ │ │ │ +00006f20: 2020 2020 2023 6966 6e64 6566 2047 5255 #ifndef GRU │ │ │ │ │ +00006f30: 425f 5459 5045 535f 4350 555f 4845 4144 B_TYPES_CPU_HEAD │ │ │ │ │ +00006f40: 4552 0a20 2020 2020 2364 6566 696e 6520 ER. #define │ │ │ │ │ +00006f50: 4752 5542 5f54 5950 4553 5f43 5055 5f48 GRUB_TYPES_CPU_H │ │ │ │ │ +00006f60: 4541 4445 5209 310a 0a20 2020 2020 2f2a EADER.1.. /* │ │ │ │ │ +00006f70: 2054 6865 2073 697a 6520 6f66 2076 6f69 The size of voi │ │ │ │ │ +00006f80: 6420 2a2e 2020 2a2f 0a20 2020 2020 2364 d *. */. #d │ │ │ │ │ +00006f90: 6566 696e 6520 4752 5542 5f54 4152 4745 efine GRUB_TARGE │ │ │ │ │ +00006fa0: 545f 5349 5a45 4f46 5f56 4f49 445f 5009 T_SIZEOF_VOID_P. │ │ │ │ │ +00006fb0: 340a 0a20 2020 2020 2f2a 2054 6865 2073 4.. /* The s │ │ │ │ │ +00006fc0: 697a 6520 6f66 206c 6f6e 672e 2020 2a2f ize of long. */ │ │ │ │ │ +00006fd0: 0a20 2020 2020 2364 6566 696e 6520 4752 . #define GR │ │ │ │ │ +00006fe0: 5542 5f54 4152 4745 545f 5349 5a45 4f46 UB_TARGET_SIZEOF │ │ │ │ │ +00006ff0: 5f4c 4f4e 4709 0934 0a0a 2020 2020 202f _LONG..4.. / │ │ │ │ │ +00007000: 2a20 6d79 6370 7520 6973 2062 6967 2d65 * mycpu is big-e │ │ │ │ │ +00007010: 6e64 6961 6e2e 2020 2a2f 0a20 2020 2020 ndian. */. │ │ │ │ │ +00007020: 2364 6566 696e 6520 4752 5542 5f54 4152 #define GRUB_TAR │ │ │ │ │ +00007030: 4745 545f 574f 5244 535f 4249 4745 4e44 GET_WORDS_BIGEND │ │ │ │ │ +00007040: 4941 4e09 310a 2020 2020 202f 2a20 416c IAN.1. /* Al │ │ │ │ │ +00007050: 7465 726e 6174 6976 656c 793a 206d 7963 ternatively: myc │ │ │ │ │ +00007060: 7075 2069 7320 6c69 7474 6c65 2d65 6e64 pu is little-end │ │ │ │ │ +00007070: 6961 6e2e 2020 2a2f 0a20 2020 2020 2375 ian. */. #u │ │ │ │ │ +00007080: 6e64 6566 2047 5255 425f 5441 5247 4554 ndef GRUB_TARGET │ │ │ │ │ +00007090: 5f57 4f52 4453 5f42 4947 454e 4449 414e _WORDS_BIGENDIAN │ │ │ │ │ +000070a0: 0a0a 2020 2020 2023 656e 6469 6620 2f2a .. #endif /* │ │ │ │ │ +000070b0: 2021 2047 5255 425f 5459 5045 535f 4350 ! GRUB_TYPES_CP │ │ │ │ │ +000070c0: 555f 4845 4144 4552 202a 2f0a 0a20 2020 U_HEADER */.. │ │ │ │ │ +000070d0: 596f 7520 7769 6c6c 2061 6c73 6f20 6e65 You will also ne │ │ │ │ │ +000070e0: 6564 2074 6f20 6164 6420 6120 6475 6d6d ed to add a dumm │ │ │ │ │ +000070f0: 7920 6669 6c65 2074 6f20 6461 7465 7469 y file to dateti │ │ │ │ │ +00007100: 6d65 2061 6e64 2073 6574 6a6d 7020 6d6f me and setjmp mo │ │ │ │ │ +00007110: 6475 6c65 730a 746f 2061 766f 6964 2061 dules.to avoid a │ │ │ │ │ +00007120: 6e79 206f 6620 6974 2068 6176 696e 6720 ny of it having │ │ │ │ │ +00007130: 6e6f 2066 696c 6573 2e20 2049 7420 6361 no files. It ca │ │ │ │ │ +00007140: 6e20 6265 206a 7573 7420 636f 6d70 6c65 n be just comple │ │ │ │ │ +00007150: 7465 6c79 2065 6d70 7479 2061 740a 7468 tely empty at.th │ │ │ │ │ +00007160: 6973 2073 7461 6765 2e0a 0a20 2020 596f is stage... Yo │ │ │ │ │ +00007170: 7527 6c6c 206e 6565 6420 746f 206d 616b u'll need to mak │ │ │ │ │ +00007180: 6520 6772 7562 2d6d 6b69 6d61 6765 2e63 e grub-mkimage.c │ │ │ │ │ +00007190: 2028 7574 696c 2f67 7275 625f 6d6b 696d (util/grub_mkim │ │ │ │ │ +000071a0: 6167 652e 6329 2061 7761 7265 206f 6620 age.c) aware of │ │ │ │ │ +000071b0: 7468 650a 6e65 6564 6564 2066 6f72 6d61 the.needed forma │ │ │ │ │ +000071c0: 742e 2020 466f 7220 6d6f 7374 2063 6f6d t. For most com │ │ │ │ │ +000071d0: 6d6f 6e6c 7920 7573 6564 2066 6f72 6d61 monly used forma │ │ │ │ │ +000071e0: 7473 206c 696b 6520 454c 462c 2050 452c ts like ELF, PE, │ │ │ │ │ +000071f0: 2061 6f75 7420 6f72 2072 6177 0a74 6865 aout or raw.the │ │ │ │ │ +00007200: 2073 7570 706f 7274 2069 7320 616c 7265 support is alre │ │ │ │ │ +00007210: 6164 7920 7072 6573 656e 7420 616e 6420 ady present and │ │ │ │ │ +00007220: 796f 7527 6c6c 206e 6565 6420 746f 206d you'll need to m │ │ │ │ │ +00007230: 616b 6520 6974 2066 6f6c 6c6f 7720 7468 ake it follow th │ │ │ │ │ +00007240: 650a 6578 6973 7461 6e74 2063 6f64 6520 e.existant code │ │ │ │ │ +00007250: 7061 7468 7320 666f 7220 796f 7572 2070 paths for your p │ │ │ │ │ +00007260: 6c61 7466 6f72 6d20 6164 6469 6e67 2061 latform adding a │ │ │ │ │ +00007270: 646a 7573 746d 656e 7473 2069 6620 6e65 djustments if ne │ │ │ │ │ +00007280: 6365 7373 6172 792e 0a57 6865 6e20 646f cessary..When do │ │ │ │ │ +00007290: 6e65 2063 6f6d 7069 6c65 3a0a 0a20 2020 ne compile:.. │ │ │ │ │ +000072a0: 2020 2e2f 626f 6f74 7374 7261 700a 2020 ./bootstrap. │ │ │ │ │ +000072b0: 2020 202e 2f63 6f6e 6669 6775 7265 202d ./configure - │ │ │ │ │ +000072c0: 2d74 6172 6765 743d 2463 7075 202d 2d77 -target=$cpu --w │ │ │ │ │ +000072d0: 6974 682d 706c 6174 666f 726d 3d24 706c ith-platform=$pl │ │ │ │ │ +000072e0: 6174 666f 726d 2054 4152 4745 545f 4343 atform TARGET_CC │ │ │ │ │ +000072f0: 3d2e 2e20 4f42 4a43 4f50 593d 2e2e 2e20 =.. OBJCOPY=... │ │ │ │ │ +00007300: 5354 5249 503d 2e2e 2e0a 2020 2020 206d STRIP=.... m │ │ │ │ │ +00007310: 616b 6520 3e20 2f64 6576 2f6e 756c 6c0a ake > /dev/null. │ │ │ │ │ +00007320: 0a20 2020 416e 6420 6372 6561 7465 2069 . And create i │ │ │ │ │ +00007330: 6d61 6765 0a0a 2020 2020 202e 2f67 7275 mage.. ./gru │ │ │ │ │ +00007340: 622d 6d6b 696d 6167 6520 2d64 2067 7275 b-mkimage -d gru │ │ │ │ │ +00007350: 622d 636f 7265 202d 4f20 2466 6f72 6d61 b-core -O $forma │ │ │ │ │ +00007360: 745f 6964 202d 6f20 7465 7374 2e69 6d67 t_id -o test.img │ │ │ │ │ +00007370: 0a0a 2020 2041 6e64 2069 7427 7320 7469 .. And it's ti │ │ │ │ │ +00007380: 6d65 2074 6f20 7465 7374 2079 6f75 7220 me to test your │ │ │ │ │ +00007390: 7465 7374 2e69 6d67 2e0a 0a20 2020 4966 test.img... If │ │ │ │ │ +000073a0: 2069 7420 776f 726b 7320 6e65 7874 2073 it works next s │ │ │ │ │ +000073b0: 7461 6765 2069 7320 746f 2068 6176 6520 tage is to have │ │ │ │ │ +000073c0: 6865 6170 2c20 636f 6e73 6f6c 6520 616e heap, console an │ │ │ │ │ +000073d0: 6420 7469 6d65 722e 0a0a 2020 2054 6f20 d timer... To │ │ │ │ │ +000073e0: 6861 7665 2074 6865 2068 6561 7020 776f have the heap wo │ │ │ │ │ +000073f0: 726b 696e 6720 796f 7520 6e65 6564 2074 rking you need t │ │ │ │ │ +00007400: 6f20 6465 7465 726d 696e 6520 7768 6963 o determine whic │ │ │ │ │ +00007410: 6820 7265 6769 6f6e 7320 6172 650a 7375 h regions are.su │ │ │ │ │ +00007420: 6974 6162 6c65 2066 6f72 2068 6561 7020 itable for heap │ │ │ │ │ +00007430: 7573 6167 652c 2061 6c6c 6f63 6174 6520 usage, allocate │ │ │ │ │ +00007440: 7468 656d 2066 726f 6d20 6669 726d 7761 them from firmwa │ │ │ │ │ +00007450: 7265 2061 6e64 206d 6170 2028 6966 0a61 re and map (if.a │ │ │ │ │ +00007460: 7070 6c69 6361 626c 6529 2e20 2054 6865 pplicable). The │ │ │ │ │ +00007470: 6e20 6361 6c6c 2067 7275 625f 6d6d 5f69 n call grub_mm_i │ │ │ │ │ +00007480: 6e69 745f 7265 6769 6f6e 2028 766f 6973 nit_region (vois │ │ │ │ │ +00007490: 202a 7374 6172 742c 2067 7275 625f 7369 *start, grub_si │ │ │ │ │ +000074a0: 7a65 5f74 2073 290a 666f 7220 6576 6572 ze_t s).for ever │ │ │ │ │ +000074b0: 7920 6f66 2074 6869 7320 7265 6769 6f6e y of this region │ │ │ │ │ +000074c0: 2e20 2041 7320 6120 7368 6f72 7463 7574 . As a shortcut │ │ │ │ │ +000074d0: 2066 6f72 2065 6172 6c79 2070 6f72 7420 for early port │ │ │ │ │ +000074e0: 796f 7520 6361 6e20 616c 6c6f 6361 7465 you can allocate │ │ │ │ │ +000074f0: 0a72 6967 6874 2061 6674 6572 205f 656e .right after _en │ │ │ │ │ +00007500: 6420 6f72 2068 6176 6520 6120 6269 6720 d or have a big │ │ │ │ │ +00007510: 7374 6174 6963 2061 7272 6179 2066 6f72 static array for │ │ │ │ │ +00007520: 2068 6561 702e 2020 4966 2079 6f75 2064 heap. If you d │ │ │ │ │ +00007530: 6f20 796f 7527 6c6c 0a70 726f 6261 626c o you'll.probabl │ │ │ │ │ +00007540: 7920 6e65 6564 2074 6f20 636f 6d65 2062 y need to come b │ │ │ │ │ +00007550: 6163 6b20 746f 2074 6869 7320 6c61 7465 ack to this late │ │ │ │ │ +00007560: 722e 2020 4173 2066 6f72 206f 7574 7075 r. As for outpu │ │ │ │ │ +00007570: 7420 636f 6e73 6f6c 6520 796f 750a 7368 t console you.sh │ │ │ │ │ +00007580: 6f75 6c64 2064 6973 7469 6e67 7569 7368 ould distinguish │ │ │ │ │ +00007590: 2062 6574 7765 656e 2061 6e20 6172 7261 between an arra │ │ │ │ │ +000075a0: 7920 6f66 2074 6578 742c 2074 6572 6d69 y of text, termi │ │ │ │ │ +000075b0: 6e66 6f20 6f72 2067 7261 7068 6963 732d nfo or graphics- │ │ │ │ │ +000075c0: 6261 7365 640a 636f 6e73 6f6c 652e 2020 based.console. │ │ │ │ │ +000075d0: 4d61 6e79 206f 6620 7265 616c 2d77 6f72 Many of real-wor │ │ │ │ │ +000075e0: 6c64 2065 7861 6d70 6c65 7320 646f 6e27 ld examples don' │ │ │ │ │ +000075f0: 7420 6669 7420 7065 7266 6563 746c 7920 t fit perfectly │ │ │ │ │ +00007600: 696e 746f 2061 6e79 206f 660a 7468 6573 into any of.thes │ │ │ │ │ +00007610: 6520 6361 7465 676f 7269 6573 2062 7574 e categories but │ │ │ │ │ +00007620: 206f 6e65 206f 6620 7468 6520 6d6f 6465 one of the mode │ │ │ │ │ +00007630: 6c73 2069 7320 6561 7369 6572 2074 6f20 ls is easier to │ │ │ │ │ +00007640: 6265 2075 7365 6420 6173 2062 6173 652e be used as base. │ │ │ │ │ +00007650: 2020 496e 0a73 6563 6f6e 6420 616e 6420 In.second and │ │ │ │ │ +00007660: 7468 6972 6420 6361 7365 2079 6f75 2073 third case you s │ │ │ │ │ +00007670: 686f 756c 6420 6164 6420 796f 7572 2070 hould add your p │ │ │ │ │ +00007680: 6c61 7466 6f72 6d20 746f 2074 6572 6d69 latform to termi │ │ │ │ │ +00007690: 6e66 6f6b 6572 6e65 6c0a 7265 7370 6563 nfokernel.respec │ │ │ │ │ +000076a0: 7469 7665 6c79 2076 6964 656f 696e 6b65 tively videoinke │ │ │ │ │ +000076b0: 726e 656c 2067 726f 7570 2e20 2041 2067 rnel group. A g │ │ │ │ │ +000076c0: 6f6f 6420 6578 616d 706c 6520 6f66 2061 ood example of a │ │ │ │ │ +000076d0: 7272 6179 206f 6620 7465 7874 2069 730a rray of text is. │ │ │ │ │ +000076e0: 6933 3836 2d70 6320 286b 6572 6e2f 6933 i386-pc (kern/i3 │ │ │ │ │ +000076f0: 3836 2f70 632f 696e 6974 2e63 2061 6e64 86/pc/init.c and │ │ │ │ │ +00007700: 2074 6572 6d2f 6933 3836 2f70 632f 636f term/i386/pc/co │ │ │ │ │ +00007710: 6e73 6f6c 652e 6329 2e20 204f 6620 7465 nsole.c). Of te │ │ │ │ │ +00007720: 726d 696e 666f 0a69 7320 6965 6565 3132 rminfo.is ieee12 │ │ │ │ │ +00007730: 3735 2028 6b65 726e 2f69 6565 6531 3237 75 (kern/ieee127 │ │ │ │ │ +00007740: 352f 696e 6974 2e63 2061 6e64 2074 6572 5/init.c and ter │ │ │ │ │ +00007750: 6d2f 6965 6565 3132 3735 2f63 6f6e 736f m/ieee1275/conso │ │ │ │ │ +00007760: 6c65 2e63 292e 2020 4f66 0a76 6964 656f le.c). Of.video │ │ │ │ │ +00007770: 2069 7320 6c6f 6f6e 6773 6f6e 2028 6b65 is loongson (ke │ │ │ │ │ +00007780: 726e 2f6d 6970 732f 6c6f 6f6e 6773 6f6e rn/mips/loongson │ │ │ │ │ +00007790: 2f69 6e69 742e 6329 2e20 204e 6f74 6520 /init.c). Note │ │ │ │ │ +000077a0: 7468 6174 2074 6572 6d69 6e66 6f20 6861 that terminfo ha │ │ │ │ │ +000077b0: 730a 746f 2062 6520 696e 6974 6564 2069 s.to be inited i │ │ │ │ │ +000077c0: 6e20 3220 7374 6167 6573 3a20 6f6e 6520 n 2 stages: one │ │ │ │ │ +000077d0: 6265 666f 7265 2028 746f 2067 6574 2061 before (to get a │ │ │ │ │ +000077e0: 7420 6c65 6173 7420 7275 6469 6d65 6e74 t least rudiment │ │ │ │ │ +000077f0: 6172 790a 636f 6e73 6f6c 6520 6173 2065 ary.console as e │ │ │ │ │ +00007800: 6172 6c79 2061 7320 706f 7373 6962 6c65 arly as possible │ │ │ │ │ +00007810: 2920 616e 6420 616e 6f74 6865 7220 6166 ) and another af │ │ │ │ │ +00007820: 7465 7220 7468 6520 6865 6170 2028 746f ter the heap (to │ │ │ │ │ +00007830: 2067 6574 0a66 756c 6c2d 6665 6174 7572 get.full-featur │ │ │ │ │ +00007840: 6564 2063 6f6e 736f 6c65 292e 2020 466f ed console). Fo │ │ │ │ │ +00007850: 7220 7468 6520 696e 7075 7420 7468 6572 r the input ther │ │ │ │ │ +00007860: 6520 6172 6520 7374 7269 6e67 206f 6620 e are string of │ │ │ │ │ +00007870: 6b65 7973 2c0a 7465 726d 696e 666f 2061 keys,.terminfo a │ │ │ │ │ +00007880: 6e64 2064 6972 6563 7420 6861 7264 7761 nd direct hardwa │ │ │ │ │ +00007890: 7265 2e20 2046 6f72 2073 7472 696e 6720 re. For string │ │ │ │ │ +000078a0: 6f66 206b 6579 7320 6c6f 6f6b 2061 7420 of keys look at │ │ │ │ │ +000078b0: 6933 3836 2d70 6320 2873 616d 650a 6669 i386-pc (same.fi │ │ │ │ │ +000078c0: 6c65 7329 2c20 666f 7220 7465 726d 696e les), for termin │ │ │ │ │ +000078d0: 666f 2069 6565 6531 3237 3520 2873 616d fo ieee1275 (sam │ │ │ │ │ +000078e0: 6520 6669 6c65 7329 2061 6e64 2066 6f72 e files) and for │ │ │ │ │ +000078f0: 2068 6172 6477 6172 6520 6c6f 6f6e 6773 hardware loongs │ │ │ │ │ +00007900: 6f6e 0a28 6b65 726e 2f6d 6970 732f 6c6f on.(kern/mips/lo │ │ │ │ │ +00007910: 6f6e 6773 6f6e 2f69 6e69 742e 6320 616e ongson/init.c an │ │ │ │ │ +00007920: 6420 7465 726d 2f61 745f 6b65 7962 6f61 d term/at_keyboa │ │ │ │ │ +00007930: 7264 2e63 292e 0a0a 2020 2046 6f72 2074 rd.c)... For t │ │ │ │ │ +00007940: 6865 2074 696d 6572 2079 6f75 276c 6c20 he timer you'll │ │ │ │ │ +00007950: 6e65 6564 2074 6f20 6361 6c6c 2067 7275 need to call gru │ │ │ │ │ +00007960: 625f 696e 7374 616c 6c5f 6765 745f 7469 b_install_get_ti │ │ │ │ │ +00007970: 6d65 5f6d 7320 282e 2e2e 290a 7769 7468 me_ms (...).with │ │ │ │ │ +00007980: 2061 7320 736f 6c65 2061 7267 756d 656e as sole argumen │ │ │ │ │ +00007990: 7420 6120 6675 6e63 7469 6f6e 2072 6574 t a function ret │ │ │ │ │ +000079a0: 7572 6e69 6e67 2061 2067 7275 625f 7569 urning a grub_ui │ │ │ │ │ +000079b0: 6e74 3634 5f74 206f 6620 6120 6e75 6d62 nt64_t of a numb │ │ │ │ │ +000079c0: 6572 0a6f 6620 6d69 6c6c 6973 6563 6f6e er.of millisecon │ │ │ │ │ +000079d0: 6473 2065 6c61 7073 6564 2073 696e 6365 ds elapsed since │ │ │ │ │ +000079e0: 2061 7262 6974 7261 7279 2070 6f69 6e74 arbitrary point │ │ │ │ │ +000079f0: 2069 6e20 7468 6520 7061 7374 2e0a 0a20 in the past... │ │ │ │ │ +00007a00: 2020 4f6e 6365 2074 6865 7365 2073 7465 Once these ste │ │ │ │ │ +00007a10: 7073 2061 6363 6f6d 706c 6973 6865 6420 ps accomplished │ │ │ │ │ +00007a20: 796f 7520 6361 6e20 7265 6d6f 7665 2074 you can remove t │ │ │ │ │ +00007a30: 6865 2069 6e69 6669 6e69 7465 206c 6f6f he inifinite loo │ │ │ │ │ +00007a40: 7020 616e 640a 796f 7520 7368 6f75 6c64 p and.you should │ │ │ │ │ +00007a50: 2062 6520 6162 6c65 2074 6f20 6765 7420 be able to get │ │ │ │ │ +00007a60: 746f 2074 6865 206d 696e 696d 616c 2063 to the minimal c │ │ │ │ │ +00007a70: 6f6e 736f 6c65 2e20 204e 6578 7420 7374 onsole. Next st │ │ │ │ │ +00007a80: 6570 2069 7320 746f 2068 6176 650a 6d6f ep is to have.mo │ │ │ │ │ +00007a90: 6475 6c65 206c 6f61 6469 6e67 2077 6f72 dule loading wor │ │ │ │ │ +00007aa0: 6b69 6e67 2e20 2046 6f72 2074 6869 7320 king. For this │ │ │ │ │ +00007ab0: 796f 7527 6c6c 206e 6565 6420 746f 2066 you'll need to f │ │ │ │ │ +00007ac0: 696c 6c20 6b65 726e 2f24 6370 752f 646c ill kern/$cpu/dl │ │ │ │ │ +00007ad0: 2e63 2061 6e64 0a6b 6572 6e2f 2463 7075 .c and.kern/$cpu │ │ │ │ │ +00007ae0: 2f63 6163 6865 2e53 2077 6974 6820 7265 /cache.S with re │ │ │ │ │ +00007af0: 616c 2068 616e 646c 696e 6720 6f66 2072 al handling of r │ │ │ │ │ +00007b00: 656c 6f63 6174 696f 6e73 2061 6e64 2072 elocations and r │ │ │ │ │ +00007b10: 6573 7065 6374 6976 656c 7920 7468 650a espectively the. │ │ │ │ │ +00007b20: 7265 616c 2073 796e 6320 6f66 2049 2061 real sync of I a │ │ │ │ │ +00007b30: 6e64 2044 2063 6163 6865 732e 2020 416c nd D caches. Al │ │ │ │ │ +00007b40: 736f 2079 6f75 276c 6c20 6e65 6564 2074 so you'll need t │ │ │ │ │ +00007b50: 6f20 6465 6369 6465 2077 6865 7265 2069 o decide where i │ │ │ │ │ +00007b60: 6e20 7468 650a 696d 6167 6520 746f 2073 n the.image to s │ │ │ │ │ +00007b70: 746f 7265 2074 6865 206d 6f64 756c 6573 tore the modules │ │ │ │ │ +00007b80: 2e20 2055 7375 616c 2077 6179 2069 7320 . Usual way is │ │ │ │ │ +00007b90: 746f 2068 6176 6520 6974 2063 6f6e 6361 to have it conca │ │ │ │ │ +00007ba0: 7465 6e61 7465 6420 6174 2074 6865 0a65 tenated at the.e │ │ │ │ │ +00007bb0: 6e64 2e20 2049 6e20 7468 6973 2063 6173 nd. In this cas │ │ │ │ │ +00007bc0: 6520 796f 7527 6c6c 206e 6565 6420 746f e you'll need to │ │ │ │ │ +00007bd0: 206d 6f64 6966 7920 7374 6172 7475 702e modify startup. │ │ │ │ │ +00007be0: 5320 746f 2063 6f70 7920 6d6f 6475 6c65 S to copy module │ │ │ │ │ +00007bf0: 7320 6f75 740a 6f66 2062 7373 2074 6f20 s out.of bss to │ │ │ │ │ +00007c00: 6c65 7427 7320 7361 7920 414c 4947 4e5f let's say ALIGN_ │ │ │ │ │ +00007c10: 5550 2028 5f65 6e64 2c20 3829 2062 6566 UP (_end, 8) bef │ │ │ │ │ +00007c20: 6f72 6520 636c 6561 6e69 6e67 206f 7574 ore cleaning out │ │ │ │ │ +00007c30: 2062 7373 2e20 2059 6f75 276c 6c0a 7072 bss. You'll.pr │ │ │ │ │ +00007c40: 6f62 6162 6c79 2066 696e 6420 7573 6566 obably find usef │ │ │ │ │ +00007c50: 756c 2074 6f20 6164 6420 746f 7461 6c5f ul to add total_ │ │ │ │ │ +00007c60: 6d6f 6475 6c65 5f73 697a 6520 6669 656c module_size fiel │ │ │ │ │ +00007c70: 6420 746f 2073 7461 7274 7570 2e53 2e20 d to startup.S. │ │ │ │ │ +00007c80: 496e 0a69 6e69 742e 6320 796f 7520 6e65 In.init.c you ne │ │ │ │ │ +00007c90: 6564 2074 6f20 7365 7420 6772 7562 5f6d ed to set grub_m │ │ │ │ │ +00007ca0: 6f64 6261 7365 2074 6f20 7468 6520 6164 odbase to the ad │ │ │ │ │ +00007cb0: 6472 6573 7320 7768 6572 6520 6d6f 6475 dress where modu │ │ │ │ │ +00007cc0: 6c65 7320 6361 6e20 6265 0a66 6f75 6e64 les can be.found │ │ │ │ │ +00007cd0: 2e20 2059 6f75 206d 6179 206e 6565 6420 . You may need │ │ │ │ │ +00007ce0: 6772 7562 5f6d 6f64 756c 6573 5f67 6574 grub_modules_get │ │ │ │ │ +00007cf0: 5f65 6e64 2028 2920 746f 2061 766f 6964 _end () to avoid │ │ │ │ │ +00007d00: 2064 6563 6c61 7269 6e67 2074 6865 0a73 declaring the.s │ │ │ │ │ +00007d10: 7061 6365 206f 6363 7570 6965 6420 6279 pace occupied by │ │ │ │ │ +00007d20: 206d 6f64 756c 6573 2061 7320 7573 6162 modules as usab │ │ │ │ │ +00007d30: 6c65 2066 6f72 2068 6561 702e 2020 596f le for heap. Yo │ │ │ │ │ +00007d40: 7520 6361 6e20 7465 7374 206d 6f64 756c u can test modul │ │ │ │ │ +00007d50: 6573 0a77 6974 683a 0a0a 2020 2020 202e es.with:.. . │ │ │ │ │ +00007d60: 2f67 7275 622d 6d6b 696d 6167 6520 2d64 /grub-mkimage -d │ │ │ │ │ +00007d70: 2067 7275 622d 636f 7265 202d 4f20 2466 grub-core -O $f │ │ │ │ │ +00007d80: 6f72 6d61 745f 6964 202d 6f20 7465 7374 ormat_id -o test │ │ │ │ │ +00007d90: 2e69 6d67 2068 656c 6c6f 0a0a 2020 2061 .img hello.. a │ │ │ │ │ +00007da0: 6e64 2074 6865 6e20 7275 6e6e 696e 6720 nd then running │ │ │ │ │ +00007db0: 2268 656c 6c6f 2220 696e 2074 6865 2073 "hello" in the s │ │ │ │ │ +00007dc0: 6865 6c6c 2e0a 0a20 2020 4f6e 6365 2074 hell... Once t │ │ │ │ │ +00007dd0: 6869 7320 776f 726b 732c 2079 6f75 2073 his works, you s │ │ │ │ │ +00007de0: 686f 756c 6420 7468 696e 6b20 6f66 2069 hould think of i │ │ │ │ │ +00007df0: 6d70 6c65 6d65 6e74 696e 6720 6469 736b mplementing disk │ │ │ │ │ +00007e00: 2061 6363 6573 732e 2020 4c6f 6f6b 0a61 access. Look.a │ │ │ │ │ +00007e10: 726f 756e 6420 6469 736b 2f20 666f 7220 round disk/ for │ │ │ │ │ +00007e20: 6578 616d 706c 6573 2e0a 0a20 2020 5468 examples... Th │ │ │ │ │ +00007e30: 656e 2c20 7665 7279 2069 6d70 6f72 7461 en, very importa │ │ │ │ │ +00007e40: 6e74 6c79 2c20 796f 7520 7072 6f62 6162 ntly, you probab │ │ │ │ │ +00007e50: 6c79 206e 6565 6420 746f 2069 6d70 6c65 ly need to imple │ │ │ │ │ +00007e60: 6d65 6e74 2074 6865 2061 6374 7561 6c0a ment the actual. │ │ │ │ │ +00007e70: 6c6f 6164 6572 2028 6578 616d 706c 6573 loader (examples │ │ │ │ │ +00007e80: 2061 7661 696c 6162 6c65 2069 6e20 6c6f available in lo │ │ │ │ │ +00007e90: 6164 6572 2f29 0a0a 2020 204c 6173 7420 ader/).. Last │ │ │ │ │ +00007ea0: 7374 6570 2074 6f20 6861 7665 206d 696e step to have min │ │ │ │ │ +00007eb0: 696d 616c 6c79 2075 7361 626c 6520 706f imally usable po │ │ │ │ │ +00007ec0: 7274 2069 7320 746f 2061 6464 2073 7570 rt is to add sup │ │ │ │ │ +00007ed0: 706f 7274 2074 6f0a 6772 7562 2d69 6e73 port to.grub-ins │ │ │ │ │ +00007ee0: 7461 6c6c 2074 6f20 7075 7420 4752 5542 tall to put GRUB │ │ │ │ │ +00007ef0: 2069 6e20 6120 706c 6163 6520 7768 6572 in a place wher │ │ │ │ │ +00007f00: 6520 6669 726d 7761 7265 206f 7220 706c e firmware or pl │ │ │ │ │ +00007f10: 6174 666f 726d 2077 696c 6c20 7069 636b atform will pick │ │ │ │ │ +00007f20: 0a69 7420 7570 2e0a 0a20 2020 4e65 7874 .it up... Next │ │ │ │ │ +00007f30: 2073 7465 7073 2061 7265 3a20 6669 6c6c steps are: fill │ │ │ │ │ +00007f40: 696e 6720 6461 7465 7469 6d65 2e63 2c20 ing datetime.c, │ │ │ │ │ +00007f50: 7365 746a 6d70 2e53 2c20 6e65 7477 6f72 setjmp.S, networ │ │ │ │ │ +00007f60: 6b20 286e 6574 2f64 7269 7665 7273 292c k (net/drivers), │ │ │ │ │ +00007f70: 0a76 6964 656f 2028 7669 6465 6f2f 292c .video (video/), │ │ │ │ │ +00007f80: 2068 616c 7420 286c 6962 2f29 2c20 7265 halt (lib/), re │ │ │ │ │ +00007f90: 626f 6f74 2028 6c69 622f 292e 0a0a 2020 boot (lib/)... │ │ │ │ │ +00007fa0: 2050 6c65 6173 6520 6164 6420 796f 7572 Please add your │ │ │ │ │ +00007fb0: 2070 6c61 7466 6f72 6d20 746f 2050 6c61 platform to Pla │ │ │ │ │ +00007fc0: 7466 6f72 6d20 6c69 6d69 7461 7469 6f6e tform limitation │ │ │ │ │ +00007fd0: 7320 616e 6420 5375 7070 6f72 7465 640a s and Supported. │ │ │ │ │ +00007fe0: 6b65 726e 656c 7320 6368 6170 7465 7220 kernels chapter │ │ │ │ │ +00007ff0: 696e 2075 7365 7220 646f 6375 6d65 6e74 in user document │ │ │ │ │ +00008000: 6174 696f 6e20 616e 6420 6d65 6e74 696f ation and mentio │ │ │ │ │ +00008010: 6e20 616e 7920 7374 6570 7320 796f 7520 n any steps you │ │ │ │ │ +00008020: 736b 6970 7065 640a 7768 6963 6820 7265 skipped.which re │ │ │ │ │ +00008030: 7375 6c74 2069 6e20 7265 6475 6365 6420 sult in reduced │ │ │ │ │ +00008040: 6665 6174 7572 6573 206f 7220 7065 7266 features or perf │ │ │ │ │ +00008050: 6f72 6d61 6e63 652e 2020 4865 7265 2069 ormance. Here i │ │ │ │ │ +00008060: 7320 7468 6520 7175 6963 6b0a 6368 6563 s the quick.chec │ │ │ │ │ +00008070: 6b6c 6973 7420 6f66 2066 6561 7475 7265 klist of feature │ │ │ │ │ +00008080: 732e 2020 536f 6d65 206f 6620 7468 656d s. Some of them │ │ │ │ │ +00008090: 2061 7265 206c 6573 7320 696d 706f 7274 are less import │ │ │ │ │ +000080a0: 616e 7420 7468 616e 206f 7468 6572 7320 ant than others │ │ │ │ │ +000080b0: 616e 640a 736b 6970 7069 6e67 2074 6865 and.skipping the │ │ │ │ │ +000080c0: 6d20 6973 2063 6f6d 706c 6574 656c 7920 m is completely │ │ │ │ │ +000080d0: 6f6b 2c20 6a75 7374 206e 6565 6473 2074 ok, just needs t │ │ │ │ │ +000080e0: 6f20 6265 206d 656e 7469 6f6e 6564 2069 o be mentioned i │ │ │ │ │ +000080f0: 6e20 7573 6572 0a64 6f63 756d 656e 7461 n user.documenta │ │ │ │ │ +00008100: 7469 6f6e 2e0a 0a20 2020 4368 6563 6b6c tion... Checkl │ │ │ │ │ +00008110: 6973 743a 0a20 2020 2a20 4973 2068 6561 ist:. * Is hea │ │ │ │ │ +00008120: 7020 6269 6720 656e 6f75 6768 3f0a 2020 p big enough?. │ │ │ │ │ +00008130: 202a 2057 6869 6368 2063 6861 7273 6574 * Which charset │ │ │ │ │ +00008140: 2069 7320 7375 7070 6f72 7465 6420 6279 is supported by │ │ │ │ │ +00008150: 2063 6f6e 736f 6c65 3f0a 2020 202a 2044 console?. * D │ │ │ │ │ +00008160: 6f65 7320 706c 6174 666f 726d 2068 6176 oes platform hav │ │ │ │ │ +00008170: 6520 6469 736b 2064 7269 7665 723f 0a20 e disk driver?. │ │ │ │ │ +00008180: 2020 2a20 446f 2079 6f75 2068 6176 6520 * Do you have │ │ │ │ │ +00008190: 6e65 7477 6f72 6b20 6361 7264 2073 7570 network card sup │ │ │ │ │ +000081a0: 706f 7274 3f0a 2020 202a 2041 7265 2079 port?. * Are y │ │ │ │ │ +000081b0: 6f75 2061 626c 6520 746f 2072 6574 7269 ou able to retri │ │ │ │ │ +000081c0: 6576 6520 6461 7465 7469 6d65 2028 7769 eve datetime (wi │ │ │ │ │ +000081d0: 7468 2064 6174 6529 3f0a 2020 202a 2041 th date)?. * A │ │ │ │ │ +000081e0: 7265 2079 6f75 2061 626c 6520 746f 2073 re you able to s │ │ │ │ │ +000081f0: 6574 2064 6174 6574 696d 6520 2877 6974 et datetime (wit │ │ │ │ │ +00008200: 6820 6461 7465 293f 0a20 2020 2a20 4973 h date)?. * Is │ │ │ │ │ +00008210: 2073 6572 6961 6c20 7375 7070 6f72 7465 serial supporte │ │ │ │ │ +00008220: 643f 0a20 2020 2a20 446f 2079 6f75 2068 d?. * Do you h │ │ │ │ │ +00008230: 6176 6520 6469 7265 6374 2064 6973 6b20 ave direct disk │ │ │ │ │ +00008240: 7375 7070 6f72 743f 0a20 2020 2a20 446f support?. * Do │ │ │ │ │ +00008250: 2079 6f75 2068 6176 6520 6469 7265 6374 you have direct │ │ │ │ │ +00008260: 206b 6579 626f 6172 6420 7375 7070 6f72 keyboard suppor │ │ │ │ │ +00008270: 743f 0a20 2020 2a20 446f 2079 6f75 2068 t?. * Do you h │ │ │ │ │ +00008280: 6176 6520 5553 4220 7375 7070 6f72 743f ave USB support? │ │ │ │ │ +00008290: 0a20 2020 2a20 446f 2079 6f75 2073 7570 . * Do you sup │ │ │ │ │ +000082a0: 706f 7274 206c 6f61 6469 6e67 2074 6872 port loading thr │ │ │ │ │ +000082b0: 6f75 6768 206e 6574 776f 726b 3f0a 2020 ough network?. │ │ │ │ │ +000082c0: 202a 2044 6f20 796f 7520 7375 7070 6f72 * Do you suppor │ │ │ │ │ +000082d0: 7420 6c6f 6164 696e 6720 6672 6f6d 2064 t loading from d │ │ │ │ │ +000082e0: 6973 6b3f 0a20 2020 2a20 446f 2079 6f75 isk?. * Do you │ │ │ │ │ +000082f0: 2073 7570 706f 7274 2063 6861 696e 6c6f support chainlo │ │ │ │ │ +00008300: 6164 696e 673f 0a20 2020 2a20 446f 2079 ading?. * Do y │ │ │ │ │ +00008310: 6f75 2073 7570 706f 7274 206e 6574 776f ou support netwo │ │ │ │ │ +00008320: 726b 2063 6861 696e 6c6f 6164 696e 673f rk chainloading? │ │ │ │ │ +00008330: 0a20 2020 2a20 446f 6573 2063 7075 6964 . * Does cpuid │ │ │ │ │ +00008340: 2063 6f6d 6d61 6e64 2073 7570 706f 7274 command support │ │ │ │ │ +00008350: 7320 6368 6563 6b69 6e67 2061 6c6c 2043 s checking all C │ │ │ │ │ +00008360: 5055 2066 6561 7475 7265 7320 7468 6174 PU features that │ │ │ │ │ +00008370: 2074 6865 2075 7365 720a 2020 2020 206d the user. m │ │ │ │ │ +00008380: 6967 6874 2077 616e 7420 636f 6e64 6974 ight want condit │ │ │ │ │ +00008390: 696f 6e61 6c69 7365 206f 6e20 2836 342d ionalise on (64- │ │ │ │ │ +000083a0: 6269 7420 6d6f 6465 2c20 6879 7065 7276 bit mode, hyperv │ │ │ │ │ +000083b0: 6973 6f72 2c2e 2e2e 290a 2020 202a 2044 isor,...). * D │ │ │ │ │ +000083c0: 6f20 796f 7520 7375 7070 6f72 7420 6869 o you support hi │ │ │ │ │ +000083d0: 6e74 733f 2020 486f 7720 7265 6c69 6162 nts? How reliab │ │ │ │ │ +000083e0: 6c65 2061 7265 2074 6865 793f 0a20 2020 le are they?. │ │ │ │ │ +000083f0: 2a20 446f 6573 2070 6c61 7466 6f72 6d20 * Does platform │ │ │ │ │ +00008400: 6861 7665 2041 4350 493f 2049 6620 736f have ACPI? If so │ │ │ │ │ +00008410: 2064 6f20 2261 6370 6922 2061 6e64 2022 do "acpi" and " │ │ │ │ │ +00008420: 6c73 6163 7069 2220 6d6f 6475 6c65 7320 lsacpi" modules │ │ │ │ │ +00008430: 776f 726b 3f0a 2020 202a 2044 6f20 616e work?. * Do an │ │ │ │ │ +00008440: 7920 6f66 2070 6c61 7466 6f72 6d2d 7370 y of platform-sp │ │ │ │ │ +00008450: 6563 6966 6963 206f 7065 7261 7469 6f6e ecific operation │ │ │ │ │ +00008460: 7320 6d65 6e74 696f 6e65 6420 696e 2074 s mentioned in t │ │ │ │ │ +00008470: 6865 2072 656c 6576 616e 740a 2020 2020 he relevant. │ │ │ │ │ +00008480: 2073 6563 7469 6f6e 206f 6620 7573 6572 section of user │ │ │ │ │ +00008490: 206d 616e 7561 6c20 6d61 6b65 7320 7365 manual makes se │ │ │ │ │ +000084a0: 6e73 6520 6f6e 2079 6f75 7220 706c 6174 nse on your plat │ │ │ │ │ +000084b0: 666f 726d 3f0a 2020 202a 2044 6f65 7320 form?. * Does │ │ │ │ │ +000084c0: 796f 7572 2070 6c61 7466 6f72 6d20 7375 your platform su │ │ │ │ │ +000084d0: 7070 6f72 7420 5043 493f 2049 6620 736f pport PCI? If so │ │ │ │ │ +000084e0: 2069 7320 7468 6572 6520 616e 2061 7070 is there an app │ │ │ │ │ +000084f0: 726f 7072 6961 7465 0a20 2020 2020 6472 ropriate. dr │ │ │ │ │ +00008500: 6976 6572 2066 6f72 2047 5255 423f 0a20 iver for GRUB?. │ │ │ │ │ +00008510: 2020 2a20 446f 2079 6f75 2073 7570 706f * Do you suppo │ │ │ │ │ +00008520: 7274 2062 6164 7261 6d3f 0a0a 1f0a 4669 rt badram?....Fi │ │ │ │ │ +00008530: 6c65 3a20 6772 7562 2d64 6576 2e69 6e66 le: grub-dev.inf │ │ │ │ │ +00008540: 6f2c 2020 4e6f 6465 3a20 4572 726f 7220 o, Node: Error │ │ │ │ │ +00008550: 4861 6e64 6c69 6e67 2c20 204e 6578 743a Handling, Next: │ │ │ │ │ +00008560: 2053 7461 636b 2061 6e64 2068 6561 7020 Stack and heap │ │ │ │ │ +00008570: 7369 7a65 2c20 2050 7265 763a 2050 6f72 size, Prev: Por │ │ │ │ │ +00008580: 7469 6e67 2c20 2055 703a 2054 6f70 0a0a ting, Up: Top.. │ │ │ │ │ +00008590: 3720 4572 726f 7220 4861 6e64 6c69 6e67 7 Error Handling │ │ │ │ │ +000085a0: 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a .*************** │ │ │ │ │ +000085b0: 2a0a 0a45 7272 6f72 2068 616e 646c 696e *..Error handlin │ │ │ │ │ +000085c0: 6720 696e 2047 5255 4220 3220 6973 2062 g in GRUB 2 is b │ │ │ │ │ +000085d0: 6173 6564 206f 6e20 6578 6365 7074 696f ased on exceptio │ │ │ │ │ +000085e0: 6e20 6861 6e64 6c69 6e67 206d 6f64 656c n handling model │ │ │ │ │ +000085f0: 2e20 2041 7320 430a 6c61 6e67 7561 6765 . As C.language │ │ │ │ │ +00008600: 2064 6f65 736e 2774 2064 6972 6563 746c doesn't directl │ │ │ │ │ +00008610: 7920 7375 7070 6f72 7420 6578 6365 7074 y support except │ │ │ │ │ +00008620: 696f 6e73 2c20 6578 6365 7074 696f 6e20 ions, exception │ │ │ │ │ +00008630: 6861 6e64 6c69 6e67 0a62 6568 6176 696f handling.behavio │ │ │ │ │ +00008640: 7220 6973 2065 6d75 6c61 7465 6420 696e r is emulated in │ │ │ │ │ +00008650: 2073 6f66 7477 6172 652e 0a0a 2020 2057 software... W │ │ │ │ │ +00008660: 6865 6e20 6578 6365 7074 696f 6e20 6973 hen exception is │ │ │ │ │ +00008670: 2072 6169 7365 642c 2066 756e 6374 696f raised, functio │ │ │ │ │ +00008680: 6e20 6d75 7374 2072 6574 7572 6e20 746f n must return to │ │ │ │ │ +00008690: 2063 616c 6c69 6e67 2066 756e 6374 696f calling functio │ │ │ │ │ +000086a0: 6e2e 0a49 6620 6361 6c6c 696e 6720 6675 n..If calling fu │ │ │ │ │ +000086b0: 6e63 7469 6f6e 2064 6f65 7320 6e6f 7420 nction does not │ │ │ │ │ +000086c0: 7072 6f76 6964 6520 6861 6e64 6c69 6e67 provide handling │ │ │ │ │ +000086d0: 206f 6620 7468 6520 6578 6365 7074 696f of the exceptio │ │ │ │ │ +000086e0: 6e20 6974 206d 7573 740a 7265 7475 726e n it must.return │ │ │ │ │ +000086f0: 2062 6163 6b20 746f 2069 7473 2063 616c back to its cal │ │ │ │ │ +00008700: 6c69 6e67 2066 756e 6374 696f 6e20 616e ling function an │ │ │ │ │ +00008710: 6420 736f 206f 6e2c 2075 6e74 696c 2065 d so on, until e │ │ │ │ │ +00008720: 7863 6570 7469 6f6e 2069 730a 6861 6e64 xception is.hand │ │ │ │ │ +00008730: 6c65 642e 2020 4966 2065 7863 6570 7469 led. If excepti │ │ │ │ │ +00008740: 6f6e 2069 7320 6e6f 7420 6861 6e64 6c65 on is not handle │ │ │ │ │ +00008750: 6420 6265 666f 7265 2070 726f 6d70 7420 d before prompt │ │ │ │ │ +00008760: 6973 2064 6973 706c 6179 6564 2c20 6572 is displayed, er │ │ │ │ │ +00008770: 726f 720a 6d65 7373 6167 6520 7769 6c6c ror.message will │ │ │ │ │ +00008780: 2062 6520 7368 6f77 6e20 746f 2075 7365 be shown to use │ │ │ │ │ +00008790: 722e 0a0a 2020 2045 7863 6570 7469 6f6e r... Exception │ │ │ │ │ +000087a0: 2069 6e66 6f72 6d61 7469 6f6e 2069 7320 information is │ │ │ │ │ +000087b0: 7374 6f72 6564 206f 6e20 2767 7275 625f stored on 'grub_ │ │ │ │ │ +000087c0: 6572 726e 6f27 2067 6c6f 6261 6c20 7661 errno' global va │ │ │ │ │ +000087d0: 7269 6162 6c65 2e20 2049 660a 2767 7275 riable. If.'gru │ │ │ │ │ +000087e0: 625f 6572 726e 6f27 2076 6172 6961 626c b_errno' variabl │ │ │ │ │ +000087f0: 6520 636f 6e74 6169 6e73 2076 616c 7565 e contains value │ │ │ │ │ +00008800: 2027 4752 5542 5f45 5252 5f4e 4f4e 4527 'GRUB_ERR_NONE' │ │ │ │ │ +00008810: 2c20 7468 6572 6520 6973 206e 6f20 6163 , there is no ac │ │ │ │ │ +00008820: 7469 7665 0a65 7863 6570 7469 6f6e 2061 tive.exception a │ │ │ │ │ +00008830: 6e64 2061 7070 6c69 6361 7469 6f6e 2063 nd application c │ │ │ │ │ +00008840: 616e 2063 6f6e 7469 6e75 6520 6e6f 726d an continue norm │ │ │ │ │ +00008850: 616c 2070 726f 6365 7373 696e 672e 2020 al processing. │ │ │ │ │ +00008860: 5768 656e 0a27 6772 7562 5f65 7272 6e6f When.'grub_errno │ │ │ │ │ +00008870: 2720 6861 7320 6f74 6865 7220 7661 6c75 ' has other valu │ │ │ │ │ +00008880: 652c 2069 7420 6973 2072 6571 7569 7265 e, it is require │ │ │ │ │ +00008890: 6420 7468 6174 2061 7070 6c69 6361 7469 d that applicati │ │ │ │ │ +000088a0: 6f6e 2063 6f64 650a 6569 7468 6572 2068 on code.either h │ │ │ │ │ +000088b0: 616e 646c 6573 2074 6869 7320 6572 726f andles this erro │ │ │ │ │ +000088c0: 7220 6f72 2072 6574 7572 6e73 2069 6e73 r or returns ins │ │ │ │ │ +000088d0: 7461 6e74 6c79 2074 6f20 6361 6c6c 6572 tantly to caller │ │ │ │ │ +000088e0: 2e20 2049 6620 6675 6e63 7469 6f6e 0a69 . If function.i │ │ │ │ │ +000088f0: 7320 7769 7468 2072 6574 7572 6e20 7479 s with return ty │ │ │ │ │ +00008900: 7065 2027 6772 7562 5f65 7272 5f74 2720 pe 'grub_err_t' │ │ │ │ │ +00008910: 6973 2061 626f 7574 2074 6f20 7265 7475 is about to retu │ │ │ │ │ +00008920: 726e 2027 4752 5542 5f45 5252 5f4e 4f4e rn 'GRUB_ERR_NON │ │ │ │ │ +00008930: 4527 2c20 6974 0a73 686f 756c 6420 6e6f E', it.should no │ │ │ │ │ +00008940: 7420 7365 7420 2767 7275 625f 6572 726e t set 'grub_errn │ │ │ │ │ +00008950: 6f27 2074 6f20 7468 6174 2076 616c 7565 o' to that value │ │ │ │ │ +00008960: 2e20 204f 6e6c 7920 7365 7420 2767 7275 . Only set 'gru │ │ │ │ │ +00008970: 625f 6572 726e 6f27 2069 6e0a 6361 7365 b_errno' in.case │ │ │ │ │ +00008980: 7320 7768 6572 6520 7468 6572 6520 6973 s where there is │ │ │ │ │ +00008990: 2065 7272 6f72 2073 6974 7561 7469 6f6e error situation │ │ │ │ │ +000089a0: 2e0a 0a20 2020 5369 6d70 6c65 2065 7863 ... Simple exc │ │ │ │ │ +000089b0: 6570 7469 6f6e 2066 6f72 7761 7264 6572 eption forwarder │ │ │ │ │ +000089c0: 2e0a 2020 2020 2067 7275 625f 6572 725f .. grub_err_ │ │ │ │ │ +000089d0: 740a 2020 2020 2066 6f72 7761 7264 696e t. forwardin │ │ │ │ │ +000089e0: 675f 6578 616d 706c 6520 2876 6f69 6429 g_example (void) │ │ │ │ │ +000089f0: 0a20 2020 2020 7b0a 2020 2020 2020 202f . {. / │ │ │ │ │ +00008a00: 2a20 4361 6c6c 2066 756e 6374 696f 6e20 * Call function │ │ │ │ │ +00008a10: 7468 6174 206d 6967 6874 2063 6175 7365 that might cause │ │ │ │ │ +00008a20: 2065 7863 6570 7469 6f6e 2e20 202a 2f0a exception. */. │ │ │ │ │ +00008a30: 2020 2020 2020 2066 6f6f 6261 7220 2829 foobar () │ │ │ │ │ +00008a40: 3b0a 0a20 2020 2020 2020 2f2a 204e 6f20 ;.. /* No │ │ │ │ │ +00008a50: 7370 6563 6961 6c20 6578 6365 7074 696f special exceptio │ │ │ │ │ +00008a60: 6e20 6861 6e64 6c65 722c 206a 7573 7420 n handler, just │ │ │ │ │ +00008a70: 666f 7277 6172 6420 706f 7373 6962 6c65 forward possible │ │ │ │ │ +00008a80: 2065 7863 6570 7469 6f6e 732e 2020 2a2f exceptions. */ │ │ │ │ │ +00008a90: 0a20 2020 2020 2020 6966 2028 6772 7562 . if (grub │ │ │ │ │ +00008aa0: 5f65 7272 6e6f 2021 3d20 4752 5542 5f45 _errno != GRUB_E │ │ │ │ │ +00008ab0: 5252 5f4e 4f4e 4529 0a20 2020 2020 2020 RR_NONE). │ │ │ │ │ +00008ac0: 2020 7b0a 2020 2020 2020 2020 2020 2072 {. r │ │ │ │ │ +00008ad0: 6574 7572 6e20 6772 7562 5f65 7272 6e6f eturn grub_errno │ │ │ │ │ +00008ae0: 3b0a 2020 2020 2020 2020 207d 0a0a 2020 ;. }.. │ │ │ │ │ +00008af0: 2020 2020 202f 2a20 416c 6c20 6973 204f /* All is O │ │ │ │ │ +00008b00: 4b2c 2064 6f20 6d6f 7265 2070 726f 6365 K, do more proce │ │ │ │ │ +00008b10: 7373 696e 672e 2020 2a2f 0a0a 2020 2020 ssing. */.. │ │ │ │ │ +00008b20: 2020 202f 2a20 5265 7475 726e 204f 4b20 /* Return OK │ │ │ │ │ +00008b30: 7369 676e 616c 2c20 746f 2063 616c 6c65 signal, to calle │ │ │ │ │ +00008b40: 722e 2020 2a2f 0a20 2020 2020 2020 7265 r. */. re │ │ │ │ │ +00008b50: 7475 726e 2047 5255 425f 4552 525f 4e4f turn GRUB_ERR_NO │ │ │ │ │ +00008b60: 4e45 3b0a 2020 2020 207d 0a0a 2020 2045 NE;. }.. E │ │ │ │ │ +00008b70: 7272 6f72 2072 6570 6f72 7469 6e67 2068 rror reporting h │ │ │ │ │ +00008b80: 6173 2074 776f 2063 6f6d 706f 6e65 6e74 as two component │ │ │ │ │ +00008b90: 732c 2074 6865 2061 6374 7561 6c20 6572 s, the actual er │ │ │ │ │ +00008ba0: 726f 7220 636f 6465 2028 6f66 2074 7970 ror code (of typ │ │ │ │ │ +00008bb0: 650a 2767 7275 625f 6572 725f 7427 2920 e.'grub_err_t') │ │ │ │ │ +00008bc0: 616e 6420 7465 7874 7561 6c20 6d65 7373 and textual mess │ │ │ │ │ +00008bd0: 6167 6520 7468 6174 2077 696c 6c20 6265 age that will be │ │ │ │ │ +00008be0: 2064 6973 706c 6179 6564 2074 6f20 7573 displayed to us │ │ │ │ │ +00008bf0: 6572 2e20 204c 6973 740a 6f66 2076 616c er. List.of val │ │ │ │ │ +00008c00: 6964 2065 7272 6f72 2063 6f64 6573 2069 id error codes i │ │ │ │ │ +00008c10: 7320 6c69 7374 6564 2069 6e20 6865 6164 s listed in head │ │ │ │ │ +00008c20: 6572 2066 696c 6520 2769 6e63 6c75 6465 er file 'include │ │ │ │ │ +00008c30: 2f67 7275 622f 6572 722e 6827 2e0a 5465 /grub/err.h'..Te │ │ │ │ │ +00008c40: 7874 7561 6c20 6572 726f 7220 6d65 7373 xtual error mess │ │ │ │ │ +00008c50: 6167 6520 6361 6e20 636f 6e74 6169 6e20 age can contain │ │ │ │ │ +00008c60: 616e 7920 7465 7874 7561 6c20 6461 7461 any textual data │ │ │ │ │ +00008c70: 2e20 2041 7420 7469 6d65 206f 6620 7772 . At time of wr │ │ │ │ │ +00008c80: 6974 696e 672c 0a65 7272 6f72 206d 6573 iting,.error mes │ │ │ │ │ +00008c90: 7361 6765 2063 616e 2063 6f6e 7461 696e sage can contain │ │ │ │ │ +00008ca0: 2075 7020 746f 2032 3536 2063 6861 7261 up to 256 chara │ │ │ │ │ +00008cb0: 6374 6572 7320 2869 6e63 6c75 6469 6e67 cters (including │ │ │ │ │ +00008cc0: 2074 6572 6d69 6e61 7469 6e67 0a4e 554c terminating.NUL │ │ │ │ │ +00008cd0: 292e 2054 6f20 6561 7365 2065 7272 6f72 ). To ease error │ │ │ │ │ +00008ce0: 2072 6570 6f72 7469 6e67 2074 6865 7265 reporting there │ │ │ │ │ +00008cf0: 2069 7320 6120 6865 6c70 6572 2066 756e is a helper fun │ │ │ │ │ +00008d00: 6374 696f 6e20 2767 7275 625f 6572 726f ction 'grub_erro │ │ │ │ │ +00008d10: 7227 0a74 6861 7420 616c 6c6f 7773 2065 r'.that allows e │ │ │ │ │ +00008d20: 6173 6965 7220 666f 726d 6174 7469 6e67 asier formatting │ │ │ │ │ +00008d30: 206f 6620 6572 726f 7220 6d65 7373 6167 of error messag │ │ │ │ │ +00008d40: 6573 2061 6e64 2073 686f 756c 6420 6265 es and should be │ │ │ │ │ +00008d50: 2075 7365 640a 696e 7374 6561 6420 6f66 used.instead of │ │ │ │ │ +00008d60: 2077 7269 7469 6e67 2064 6972 6563 746c writing directl │ │ │ │ │ +00008d70: 7920 746f 2067 6c6f 6261 6c20 7661 7269 y to global vari │ │ │ │ │ +00008d80: 6162 6c65 732e 0a0a 2020 2045 7861 6d70 ables... Examp │ │ │ │ │ +00008d90: 6c65 206f 6620 6572 726f 7220 7265 706f le of error repo │ │ │ │ │ +00008da0: 7274 696e 672e 0a20 2020 2020 6772 7562 rting.. grub │ │ │ │ │ +00008db0: 5f65 7272 5f74 0a20 2020 2020 6661 696c _err_t. fail │ │ │ │ │ +00008dc0: 696e 675f 6578 616d 706c 6520 2829 0a20 ing_example (). │ │ │ │ │ +00008dd0: 2020 2020 7b0a 2020 2020 2020 2072 6574 {. ret │ │ │ │ │ +00008de0: 7572 6e20 6772 7562 5f65 7272 6f72 2028 urn grub_error ( │ │ │ │ │ +00008df0: 4752 5542 5f45 5252 5f46 494c 455f 4e4f GRUB_ERR_FILE_NO │ │ │ │ │ +00008e00: 545f 464f 554e 442c 0a20 2020 2020 2020 T_FOUND,. │ │ │ │ │ 00008e10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00008e20: 2020 2020 2022 4661 696c 6564 2074 6f20 "Failed to │ │ │ │ │ -00008e30: 7265 6164 2025 732c 2074 7269 6564 2025 read %s, tried % │ │ │ │ │ -00008e40: 6420 7469 6d65 732e 222c 0a20 2020 2020 d times.",. │ │ │ │ │ +00008e20: 2020 2022 4661 696c 6564 2074 6f20 7265 "Failed to re │ │ │ │ │ +00008e30: 6164 2025 732c 2074 7269 6564 2025 6420 ad %s, tried %d │ │ │ │ │ +00008e40: 7469 6d65 732e 222c 0a20 2020 2020 2020 times.",. │ │ │ │ │ 00008e50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00008e60: 2020 2020 2022 7465 7374 2e74 7874 222c "test.txt", │ │ │ │ │ -00008e70: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ -00008e80: 2020 2020 2020 2020 2020 2031 3029 3b0a 10);. │ │ │ │ │ -00008e90: 2020 2020 207d 0a0a 2020 2049 6620 7468 }.. If th │ │ │ │ │ -00008ea0: 6572 6520 6973 2061 2073 7065 6369 616c ere is a special │ │ │ │ │ -00008eb0: 2072 6561 736f 6e20 7468 6174 2065 7272 reason that err │ │ │ │ │ -00008ec0: 6f72 2063 6f64 6520 646f 6573 206e 6f74 or code does not │ │ │ │ │ -00008ed0: 206e 6565 6420 746f 2062 650a 7461 6b65 need to be.take │ │ │ │ │ -00008ee0: 6e20 6163 636f 756e 742c 2027 6772 7562 n account, 'grub │ │ │ │ │ -00008ef0: 5f65 7272 6e6f 2720 6361 6e20 6265 207a _errno' can be z │ │ │ │ │ -00008f00: 6572 6f65 6420 6261 636b 2074 6f20 2747 eroed back to 'G │ │ │ │ │ -00008f10: 5255 425f 4552 525f 4e4f 4e45 272e 2020 RUB_ERR_NONE'. │ │ │ │ │ -00008f20: 496e 0a63 6173 6573 206c 696b 6520 7468 In.cases like th │ │ │ │ │ -00008f30: 6973 2061 6c6c 2070 7265 7669 6f75 7320 is all previous │ │ │ │ │ -00008f40: 6572 726f 7220 636f 6465 7320 7368 6f75 error codes shou │ │ │ │ │ -00008f50: 6c64 2068 6176 6520 6265 656e 2068 616e ld have been han │ │ │ │ │ -00008f60: 646c 6564 0a63 6f72 7265 6374 6c79 2e20 dled.correctly. │ │ │ │ │ -00008f70: 2054 6869 7320 6d61 6b65 7320 7375 7265 This makes sure │ │ │ │ │ -00008f80: 2074 6861 7420 7468 6572 6520 6172 6520 that there are │ │ │ │ │ -00008f90: 6e6f 2075 6e68 616e 646c 6564 2065 7863 no unhandled exc │ │ │ │ │ -00008fa0: 6570 7469 6f6e 732e 0a0a 2020 2045 7861 eptions... Exa │ │ │ │ │ -00008fb0: 6d70 6c65 206f 6620 7a65 726f 696e 6720 mple of zeroing │ │ │ │ │ -00008fc0: 2767 7275 625f 6572 726e 6f27 2e0a 2020 'grub_errno'.. │ │ │ │ │ -00008fd0: 2020 2067 7275 625f 6572 725f 740a 2020 grub_err_t. │ │ │ │ │ -00008fe0: 2020 2070 726f 6265 5f65 7861 6d70 6c65 probe_example │ │ │ │ │ -00008ff0: 2028 290a 2020 2020 207b 0a20 2020 2020 (). {. │ │ │ │ │ -00009000: 2020 2f2a 2054 7279 2074 6f20 7072 6f62 /* Try to prob │ │ │ │ │ -00009010: 6520 6465 7669 6365 2074 7970 6520 312e e device type 1. │ │ │ │ │ -00009020: 2020 2a2f 0a20 2020 2020 2020 7072 6f62 */. prob │ │ │ │ │ -00009030: 655f 666f 725f 6465 7669 6365 2028 293b e_for_device (); │ │ │ │ │ -00009040: 0a20 2020 2020 2020 6966 2028 6772 7562 . if (grub │ │ │ │ │ -00009050: 5f65 7272 6e6f 203d 3d20 4752 5542 5f45 _errno == GRUB_E │ │ │ │ │ -00009060: 5252 5f4e 4f4e 4529 0a20 2020 2020 2020 RR_NONE). │ │ │ │ │ -00009070: 2020 7b0a 2020 2020 2020 2020 2020 202f {. / │ │ │ │ │ -00009080: 2a20 4465 7669 6365 2074 7970 6520 3120 * Device type 1 │ │ │ │ │ -00009090: 7761 7320 666f 756e 6420 6f6e 2073 7973 was found on sys │ │ │ │ │ -000090a0: 7465 6d2e 2020 2a2f 0a20 2020 2020 2020 tem. */. │ │ │ │ │ -000090b0: 2020 2020 7265 6769 7374 6572 5f64 6576 register_dev │ │ │ │ │ -000090c0: 6963 6520 2829 3b0a 2020 2020 2020 2020 ice ();. │ │ │ │ │ -000090d0: 2020 2072 6574 7572 6e20 4752 5542 5f45 return GRUB_E │ │ │ │ │ -000090e0: 5252 5f4e 4f4e 453b 0a20 2020 2020 2020 RR_NONE;. │ │ │ │ │ -000090f0: 2020 7d0a 2020 2020 2020 202f 2a20 5a65 }. /* Ze │ │ │ │ │ -00009100: 726f 206f 7574 2065 7272 6f72 2063 6f64 ro out error cod │ │ │ │ │ -00009110: 652e 2020 2a2f 0a20 2020 2020 2020 6772 e. */. gr │ │ │ │ │ -00009120: 7562 5f65 7272 6e6f 203d 2047 5255 425f ub_errno = GRUB_ │ │ │ │ │ -00009130: 4552 525f 4e4f 4e45 3b0a 0a20 2020 2020 ERR_NONE;.. │ │ │ │ │ -00009140: 2020 2f2a 204e 6f20 6465 7669 6365 2074 /* No device t │ │ │ │ │ -00009150: 7970 6520 3120 666f 756e 642c 2074 7279 ype 1 found, try │ │ │ │ │ -00009160: 2074 6f20 7072 6f62 6520 6465 7669 6365 to probe device │ │ │ │ │ -00009170: 2074 7970 6520 322e 2020 2a2f 0a20 2020 type 2. */. │ │ │ │ │ -00009180: 2020 2020 7072 6f62 655f 666f 725f 6465 probe_for_de │ │ │ │ │ -00009190: 7669 6365 3220 2829 3b0a 2020 2020 2020 vice2 ();. │ │ │ │ │ -000091a0: 2069 6620 2867 7275 625f 6572 726e 6f20 if (grub_errno │ │ │ │ │ -000091b0: 3d3d 2047 5255 425f 4552 525f 4e4f 4e45 == GRUB_ERR_NONE │ │ │ │ │ -000091c0: 290a 2020 2020 2020 2020 207b 0a20 2020 ). {. │ │ │ │ │ -000091d0: 2020 2020 2020 2020 2f2a 2044 6576 6963 /* Devic │ │ │ │ │ -000091e0: 6520 7479 7065 2032 2077 6173 2066 6f75 e type 2 was fou │ │ │ │ │ -000091f0: 6e64 206f 6e20 7379 7374 656d 2e20 202a nd on system. * │ │ │ │ │ -00009200: 2f0a 2020 2020 2020 2020 2020 2072 6567 /. reg │ │ │ │ │ -00009210: 6973 7465 725f 6465 7669 6365 3220 2829 ister_device2 () │ │ │ │ │ -00009220: 3b0a 2020 2020 2020 2020 2020 2072 6574 ;. ret │ │ │ │ │ -00009230: 7572 6e20 4752 5542 5f45 5252 5f4e 4f4e urn GRUB_ERR_NON │ │ │ │ │ -00009240: 453b 0a20 2020 2020 2020 2020 7d0a 2020 E;. }. │ │ │ │ │ -00009250: 2020 2020 202f 2a20 5a65 726f 206f 7574 /* Zero out │ │ │ │ │ -00009260: 2065 7272 6f72 2063 6f64 652e 2020 2a2f error code. */ │ │ │ │ │ -00009270: 0a20 2020 2020 2020 6772 7562 5f65 7272 . grub_err │ │ │ │ │ -00009280: 6e6f 203d 2047 5255 425f 4552 525f 4e4f no = GRUB_ERR_NO │ │ │ │ │ -00009290: 4e45 3b0a 0a20 2020 2020 2020 2f2a 2052 NE;.. /* R │ │ │ │ │ -000092a0: 6574 7572 6e20 6375 7374 6f6d 2065 7272 eturn custom err │ │ │ │ │ -000092b0: 6f72 206d 6573 7361 6765 2e20 202a 2f0a or message. */. │ │ │ │ │ -000092c0: 2020 2020 2020 2072 6574 7572 6e20 6772 return gr │ │ │ │ │ -000092d0: 7562 5f65 7272 6f72 2028 4752 5542 5f45 ub_error (GRUB_E │ │ │ │ │ -000092e0: 5252 5f55 4e4b 4e4f 574e 5f44 4556 4943 RR_UNKNOWN_DEVIC │ │ │ │ │ -000092f0: 452c 2022 4e6f 2064 6576 6963 6520 7479 E, "No device ty │ │ │ │ │ -00009300: 7065 2031 206f 7220 3220 666f 756e 642e pe 1 or 2 found. │ │ │ │ │ -00009310: 2229 3b0a 2020 2020 207d 0a0a 2020 2053 ");. }.. S │ │ │ │ │ -00009320: 6f6d 6520 7469 6d65 7320 7468 6572 6520 ome times there │ │ │ │ │ -00009330: 6973 2061 206e 6565 6420 746f 2063 6f6e is a need to con │ │ │ │ │ -00009340: 7469 6e75 6520 7072 6f63 6573 7369 6e67 tinue processing │ │ │ │ │ -00009350: 2065 7665 6e20 6966 2074 6865 7265 2069 even if there i │ │ │ │ │ -00009360: 7320 610a 6572 726f 7220 7374 6174 6520 s a.error state │ │ │ │ │ -00009370: 696e 2061 7070 6c69 6361 7469 6f6e 2e20 in application. │ │ │ │ │ -00009380: 2049 6e20 7369 7475 6174 696f 6e73 206c In situations l │ │ │ │ │ -00009390: 696b 6520 7468 6973 2c20 7468 6572 6520 ike this, there │ │ │ │ │ -000093a0: 6973 2061 206e 6565 6465 640a 746f 2073 is a needed.to s │ │ │ │ │ -000093b0: 6176 6520 6f6c 6420 6572 726f 7220 7374 ave old error st │ │ │ │ │ -000093c0: 6174 6520 616e 6420 7468 656e 2063 616c ate and then cal │ │ │ │ │ -000093d0: 6c20 6f74 6865 7220 6675 6e63 7469 6f6e l other function │ │ │ │ │ -000093e0: 7320 7468 6174 206d 6967 6874 2066 6169 s that might fai │ │ │ │ │ -000093f0: 6c2e 0a54 6f20 6169 6420 696e 2074 6869 l..To aid in thi │ │ │ │ │ -00009400: 732c 2074 6865 7265 2069 7320 6120 6572 s, there is a er │ │ │ │ │ -00009410: 726f 7220 7374 6163 6b20 696d 706c 656d ror stack implem │ │ │ │ │ -00009420: 656e 7465 642e 2020 4572 726f 7220 7374 ented. Error st │ │ │ │ │ -00009430: 6174 6520 6361 6e20 6265 0a70 7573 6865 ate can be.pushe │ │ │ │ │ -00009440: 6420 746f 2065 7272 6f72 2073 7461 636b d to error stack │ │ │ │ │ -00009450: 2062 7920 6361 6c6c 696e 6720 6675 6e63 by calling func │ │ │ │ │ -00009460: 7469 6f6e 2027 6772 7562 5f65 7272 6f72 tion 'grub_error │ │ │ │ │ -00009470: 5f70 7573 6820 2829 272e 2020 5768 656e _push ()'. When │ │ │ │ │ -00009480: 0a70 726f 6365 7373 696e 6720 6861 7320 .processing has │ │ │ │ │ -00009490: 6265 656e 2063 6f6d 706c 6574 6564 2c20 been completed, │ │ │ │ │ -000094a0: 2767 7275 625f 6572 726f 725f 706f 7020 'grub_error_pop │ │ │ │ │ -000094b0: 2829 2720 6361 6e20 6265 2075 7365 6420 ()' can be used │ │ │ │ │ -000094c0: 746f 2070 6f70 0a65 7272 6f72 2073 7461 to pop.error sta │ │ │ │ │ -000094d0: 7465 2066 726f 6d20 7374 6163 6b2e 2020 te from stack. │ │ │ │ │ -000094e0: 4572 726f 7220 7374 6163 6b20 636f 6e74 Error stack cont │ │ │ │ │ -000094f0: 6169 6e73 2070 7265 6465 6669 6e65 6420 ains predefined │ │ │ │ │ -00009500: 616d 6f75 6e74 206f 6620 6572 726f 720a amount of error. │ │ │ │ │ -00009510: 7374 6163 6b20 6974 656d 732e 2020 4572 stack items. Er │ │ │ │ │ -00009520: 726f 7220 7374 6163 6b20 6973 2070 726f ror stack is pro │ │ │ │ │ -00009530: 7465 6374 6564 2066 6f72 206f 7665 7266 tected for overf │ │ │ │ │ -00009540: 6c6f 7720 616e 6420 6d61 726b 7320 7468 low and marks th │ │ │ │ │ -00009550: 6573 650a 7369 7475 6174 696f 6e73 2073 ese.situations s │ │ │ │ │ -00009560: 6f20 6f76 6572 666c 6f77 2065 7272 6f72 o overflow error │ │ │ │ │ -00009570: 2064 6f65 7320 6e6f 7420 6765 7420 756e does not get un │ │ │ │ │ -00009580: 7365 656e 2e20 2049 6620 7468 6572 6520 seen. If there │ │ │ │ │ -00009590: 6973 206e 6f20 7370 6163 650a 6176 6169 is no space.avai │ │ │ │ │ -000095a0: 6c61 626c 6520 746f 2073 746f 7265 2065 lable to store e │ │ │ │ │ -000095b0: 7272 6f72 206d 6573 7361 6765 2c20 6974 rror message, it │ │ │ │ │ -000095c0: 2069 7320 7369 6d70 6c79 2064 6973 6361 is simply disca │ │ │ │ │ -000095d0: 7264 6564 2061 6e64 206f 7665 7266 6c6f rded and overflo │ │ │ │ │ -000095e0: 770a 7769 6c6c 2062 6520 6d61 726b 6564 w.will be marked │ │ │ │ │ -000095f0: 2061 7320 6861 7070 656e 6564 2e20 2057 as happened. W │ │ │ │ │ -00009600: 6865 6e20 6f76 6572 666c 6f77 2068 6170 hen overflow hap │ │ │ │ │ -00009610: 7065 6e73 2c20 6974 206d 6f73 7420 6c69 pens, it most li │ │ │ │ │ -00009620: 6b65 6c79 2077 696c 6c0a 636f 7272 7570 kely will.corrup │ │ │ │ │ -00009630: 7420 6572 726f 7220 7374 6163 6b20 636f t error stack co │ │ │ │ │ -00009640: 6e73 6973 7465 6e63 7920 6173 2066 6f72 nsistency as for │ │ │ │ │ -00009650: 2070 7573 6865 6420 6572 726f 7220 7468 pushed error th │ │ │ │ │ -00009660: 6572 6520 6973 206e 6f20 6d61 7463 6869 ere is no matchi │ │ │ │ │ -00009670: 6e67 0a70 6f70 2c20 6275 7420 6f76 6572 ng.pop, but over │ │ │ │ │ -00009680: 666c 6f77 206d 6573 7361 6765 2077 696c flow message wil │ │ │ │ │ -00009690: 6c20 6265 2073 686f 776e 2074 6f20 696e l be shown to in │ │ │ │ │ -000096a0: 666f 726d 2075 7365 7220 6162 6f75 7420 form user about │ │ │ │ │ -000096b0: 7468 650a 7369 7475 6174 696f 6e2e 2020 the.situation. │ │ │ │ │ -000096c0: 4f76 6572 666c 6f77 206d 6573 7361 6765 Overflow message │ │ │ │ │ -000096d0: 2077 696c 6c20 6265 2073 686f 776e 2061 will be shown a │ │ │ │ │ -000096e0: 7420 7469 6d65 2077 6865 6e20 7072 6f6d t time when prom │ │ │ │ │ -000096f0: 7074 2069 7320 6162 6f75 740a 746f 2062 pt is about.to b │ │ │ │ │ -00009700: 6520 6472 6177 6e2e 0a0a 2020 2045 7861 e drawn... Exa │ │ │ │ │ -00009710: 6d70 6c65 2075 7361 6765 206f 6620 6572 mple usage of er │ │ │ │ │ -00009720: 726f 7220 7374 6163 6b2e 0a20 2020 2020 ror stack.. │ │ │ │ │ -00009730: 2f2a 2053 6176 6520 706f 7373 6962 6c65 /* Save possible │ │ │ │ │ -00009740: 206f 6c64 2065 7272 6f72 206d 6573 7361 old error messa │ │ │ │ │ -00009750: 6765 2e20 202a 2f0a 2020 2020 2067 7275 ge. */. gru │ │ │ │ │ -00009760: 625f 6572 726f 725f 7075 7368 2028 293b b_error_push (); │ │ │ │ │ -00009770: 0a0a 2020 2020 202f 2a20 446f 2079 6f75 .. /* Do you │ │ │ │ │ -00009780: 7220 7374 7566 6620 6865 7265 2e20 202a r stuff here. * │ │ │ │ │ -00009790: 2f0a 2020 2020 2063 616c 6c5f 706f 7373 /. call_poss │ │ │ │ │ -000097a0: 6962 6c79 5f66 6169 6c69 6e67 5f66 756e ibly_failing_fun │ │ │ │ │ -000097b0: 6374 696f 6e20 2829 3b0a 0a20 2020 2020 ction ();.. │ │ │ │ │ -000097c0: 6966 2028 6772 7562 5f65 7272 6e6f 2021 if (grub_errno ! │ │ │ │ │ -000097d0: 3d20 4752 5542 5f45 5252 5f4e 4f4e 4529 = GRUB_ERR_NONE) │ │ │ │ │ -000097e0: 0a20 2020 2020 2020 7b0a 2020 2020 2020 . {. │ │ │ │ │ -000097f0: 2020 202f 2a20 496e 666f 726d 2072 6573 /* Inform res │ │ │ │ │ -00009800: 7420 6f66 2074 6865 2063 6f64 6520 7468 t of the code th │ │ │ │ │ -00009810: 6174 2074 6865 7265 2069 7320 6572 726f at there is erro │ │ │ │ │ -00009820: 7220 2867 7275 625f 6572 726e 6f0a 2020 r (grub_errno. │ │ │ │ │ -00009830: 2020 2020 2020 2020 2020 6973 2073 6574 is set │ │ │ │ │ -00009840: 292e 2054 6865 7265 2069 7320 6e6f 2070 ). There is no p │ │ │ │ │ -00009850: 6f70 2068 6572 6520 6173 2077 6520 7761 op here as we wa │ │ │ │ │ -00009860: 6e74 2062 6f74 6820 6572 726f 7220 7374 nt both error st │ │ │ │ │ -00009870: 6174 6573 0a20 2020 2020 2020 2020 2020 ates. │ │ │ │ │ -00009880: 2074 6f20 6265 2064 6973 706c 6179 6564 to be displayed │ │ │ │ │ -00009890: 2e20 202a 2f0a 2020 2020 2020 2020 2072 . */. r │ │ │ │ │ -000098a0: 6574 7572 6e3b 0a20 2020 2020 2020 7d0a eturn;. }. │ │ │ │ │ -000098b0: 0a20 2020 2020 2f2a 2052 6573 746f 7265 . /* Restore │ │ │ │ │ -000098c0: 206f 6c64 2065 7272 6f72 2073 7461 7465 old error state │ │ │ │ │ -000098d0: 2062 7920 706f 7070 696e 6720 7072 6576 by popping prev │ │ │ │ │ -000098e0: 696f 7573 2069 7465 6d20 6672 6f6d 2073 ious item from s │ │ │ │ │ -000098f0: 7461 636b 2e20 2a2f 0a20 2020 2020 6772 tack. */. gr │ │ │ │ │ -00009900: 7562 5f65 7272 6f72 5f70 6f70 2028 293b ub_error_pop (); │ │ │ │ │ -00009910: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2d64 ....File: grub-d │ │ │ │ │ -00009920: 6576 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ev.info, Node: │ │ │ │ │ -00009930: 5374 6163 6b20 616e 6420 6865 6170 2073 Stack and heap s │ │ │ │ │ -00009940: 697a 652c 2020 4e65 7874 3a20 4249 4f53 ize, Next: BIOS │ │ │ │ │ -00009950: 2070 6f72 7420 6d65 6d6f 7279 206d 6170 port memory map │ │ │ │ │ -00009960: 2c20 2050 7265 763a 2045 7272 6f72 2048 , Prev: Error H │ │ │ │ │ -00009970: 616e 646c 696e 672c 2020 5570 3a20 546f andling, Up: To │ │ │ │ │ -00009980: 700a 0a38 2053 7461 636b 2061 6e64 2068 p..8 Stack and h │ │ │ │ │ -00009990: 6561 7020 7369 7a65 0a2a 2a2a 2a2a 2a2a eap size.******* │ │ │ │ │ -000099a0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a **************.. │ │ │ │ │ -000099b0: 4f6e 2065 6d75 2073 7461 636b 2061 6e64 On emu stack and │ │ │ │ │ -000099c0: 2068 6561 7020 6172 6520 6a75 7374 206e heap are just n │ │ │ │ │ -000099d0: 6f72 6d61 6c20 686f 7374 204f 5320 7374 ormal host OS st │ │ │ │ │ -000099e0: 6163 6b20 616e 6420 6865 6170 2e20 2053 ack and heap. S │ │ │ │ │ -000099f0: 7461 636b 2069 730a 7479 7069 6361 6c6c tack is.typicall │ │ │ │ │ -00009a00: 7920 3820 4d69 4220 616c 7468 6f75 6768 y 8 MiB although │ │ │ │ │ -00009a10: 2069 7427 7320 4f53 2d64 6570 656e 6465 it's OS-depende │ │ │ │ │ -00009a20: 6e74 2e0a 0a20 2020 4f6e 2069 3338 362d nt... On i386- │ │ │ │ │ -00009a30: 7063 2c20 6933 3836 2d63 6f72 6562 6f6f pc, i386-coreboo │ │ │ │ │ -00009a40: 742c 2069 3338 362d 7165 6d75 2061 6e64 t, i386-qemu and │ │ │ │ │ -00009a50: 2069 3338 362d 6d75 6c74 6962 6f6f 7420 i386-multiboot │ │ │ │ │ -00009a60: 7468 6520 7374 6163 6b20 6973 0a36 304b the stack is.60K │ │ │ │ │ -00009a70: 6942 2e20 416c 6c20 6176 6169 6c61 626c iB. All availabl │ │ │ │ │ -00009a80: 6520 7370 6163 6520 6265 7477 6565 6e20 e space between │ │ │ │ │ -00009a90: 314d 6942 2061 6e64 2034 4769 4220 6d61 1MiB and 4GiB ma │ │ │ │ │ -00009aa0: 726b 7320 6973 2070 6172 7420 6f66 2068 rks is part of h │ │ │ │ │ -00009ab0: 6561 702e 0a0a 2020 204f 6e20 2a2d 7865 eap... On *-xe │ │ │ │ │ -00009ac0: 6e20 7374 6163 6b20 6973 2034 4d69 422e n stack is 4MiB. │ │ │ │ │ -00009ad0: 2049 6620 636f 6d70 696c 6564 2066 6f72 If compiled for │ │ │ │ │ -00009ae0: 2078 3836 2d36 3420 7769 7468 2047 4343 x86-64 with GCC │ │ │ │ │ -00009af0: 2034 2e34 206f 7220 6c61 7465 720a 6164 4.4 or later.ad │ │ │ │ │ -00009b00: 7265 7373 6162 6c65 2073 7061 6365 2069 ressable space i │ │ │ │ │ -00009b10: 7320 756e 6c69 6d69 7465 642e 2020 5768 s unlimited. Wh │ │ │ │ │ -00009b20: 656e 2063 6f6d 7069 6c65 6420 666f 7220 en compiled for │ │ │ │ │ -00009b30: 7838 362d 3634 2077 6974 6820 6f6c 6465 x86-64 with olde │ │ │ │ │ -00009b40: 7220 4743 430a 7665 7273 696f 6e20 6164 r GCC.version ad │ │ │ │ │ -00009b50: 7265 7373 6162 6c65 2073 7061 6365 2069 ressable space i │ │ │ │ │ -00009b60: 7320 6c69 6d69 7465 6420 746f 2032 4769 s limited to 2Gi │ │ │ │ │ -00009b70: 422e 2057 6865 6e20 636f 6d70 696c 696e B. When compilin │ │ │ │ │ -00009b80: 6720 666f 7220 6933 3836 0a61 6472 6573 g for i386.adres │ │ │ │ │ -00009b90: 7361 626c 6520 7370 6163 6520 6973 206c sable space is l │ │ │ │ │ -00009ba0: 696d 6974 6564 2074 6f20 3447 6942 2e20 imited to 4GiB. │ │ │ │ │ -00009bb0: 416c 6c20 6164 7265 7373 6162 6c65 2070 All adressable p │ │ │ │ │ -00009bc0: 6167 6573 2065 7863 6570 7420 7468 650a ages except the. │ │ │ │ │ -00009bd0: 6f6e 6573 2066 6f72 2073 7461 636b 2c20 ones for stack, │ │ │ │ │ -00009be0: 4752 5542 2062 696e 6172 792c 2073 7065 GRUB binary, spe │ │ │ │ │ -00009bf0: 6369 616c 2070 6167 6573 2061 6e64 2070 cial pages and p │ │ │ │ │ -00009c00: 6167 6520 7461 626c 6520 6172 6520 696e age table are in │ │ │ │ │ -00009c10: 2074 6865 0a68 6561 702e 0a0a 2020 204f the.heap... O │ │ │ │ │ -00009c20: 6e20 2a2d 6566 6920 4752 5542 2075 7365 n *-efi GRUB use │ │ │ │ │ -00009c30: 7320 7361 6d65 2073 7461 636b 2061 7320 s same stack as │ │ │ │ │ -00009c40: 4546 492e 2049 6620 636f 6d70 696c 6564 EFI. If compiled │ │ │ │ │ -00009c50: 2066 6f72 2078 3836 2d36 3420 7769 7468 for x86-64 with │ │ │ │ │ -00009c60: 2047 4343 0a34 2e34 206f 7220 6c61 7465 GCC.4.4 or late │ │ │ │ │ -00009c70: 7220 6164 7265 7373 6162 6c65 2073 7061 r adressable spa │ │ │ │ │ -00009c80: 6365 2069 7320 756e 6c69 6d69 7465 642e ce is unlimited. │ │ │ │ │ -00009c90: 2020 5768 656e 2063 6f6d 7069 6c65 6420 When compiled │ │ │ │ │ -00009ca0: 666f 7220 7838 362d 3634 0a77 6974 6820 for x86-64.with │ │ │ │ │ -00009cb0: 6f6c 6465 7220 4743 4320 7665 7273 696f older GCC versio │ │ │ │ │ -00009cc0: 6e20 6164 7265 7373 6162 6c65 2073 7061 n adressable spa │ │ │ │ │ -00009cd0: 6365 2069 7320 6c69 6d69 7465 6420 746f ce is limited to │ │ │ │ │ -00009ce0: 2032 4769 422e 2046 6f72 2061 6c6c 0a6f 2GiB. For all.o │ │ │ │ │ -00009cf0: 7468 6572 2070 6c61 7466 6f72 6d73 2061 ther platforms a │ │ │ │ │ -00009d00: 6472 6573 7361 626c 6520 7370 6163 6520 dressable space │ │ │ │ │ -00009d10: 6973 206c 696d 6974 6564 2074 6f20 3447 is limited to 4G │ │ │ │ │ -00009d20: 6942 2e20 4752 5542 2061 6c6c 6f63 6174 iB. GRUB allocat │ │ │ │ │ -00009d30: 6573 0a70 6167 6573 2066 726f 6d20 4546 es.pages from EF │ │ │ │ │ -00009d40: 4920 666f 7220 6974 7320 6865 6170 2c20 I for its heap, │ │ │ │ │ -00009d50: 6174 206d 6f73 7420 312e 3620 4769 422e at most 1.6 GiB. │ │ │ │ │ -00009d60: 0a0a 2020 204f 6e20 6933 3836 2d69 6565 .. On i386-iee │ │ │ │ │ -00009d70: 6531 3237 3520 616e 6420 706f 7765 7270 e1275 and powerp │ │ │ │ │ -00009d80: 632d 6965 6565 3132 3735 2047 5255 4220 c-ieee1275 GRUB │ │ │ │ │ -00009d90: 7573 6573 2073 616d 6520 7374 6163 6b20 uses same stack │ │ │ │ │ -00009da0: 6173 0a49 4545 4531 3237 352e 2020 4974 as.IEEE1275. It │ │ │ │ │ -00009db0: 2061 6c6c 6f63 6174 6573 2061 7420 6d6f allocates at mo │ │ │ │ │ -00009dc0: 7374 2033 324d 6942 2066 6f72 2069 7473 st 32MiB for its │ │ │ │ │ -00009dd0: 2068 6561 702e 0a0a 2020 204f 6e20 7370 heap... On sp │ │ │ │ │ -00009de0: 6172 6336 342d 6965 6565 3132 3735 2073 arc64-ieee1275 s │ │ │ │ │ -00009df0: 7461 636b 2069 7320 3235 364b 6942 2061 tack is 256KiB a │ │ │ │ │ -00009e00: 6e64 2068 6561 7020 6973 2032 4d69 422e nd heap is 2MiB. │ │ │ │ │ -00009e10: 0a0a 2020 204f 6e20 6d69 7073 2865 6c29 .. On mips(el) │ │ │ │ │ -00009e20: 2d71 656d 755f 6d69 7073 2061 6e64 206d -qemu_mips and m │ │ │ │ │ -00009e30: 6970 7365 6c2d 6c6f 6f6e 6773 6f6e 2073 ipsel-loongson s │ │ │ │ │ -00009e40: 7461 636b 2069 7320 324d 6942 2028 6576 tack is 2MiB (ev │ │ │ │ │ -00009e50: 6572 7974 6869 6e67 0a62 656c 6f77 2047 erything.below G │ │ │ │ │ -00009e60: 5255 4220 696d 6167 6529 2061 6e64 2065 RUB image) and e │ │ │ │ │ -00009e70: 7665 7279 7468 696e 6720 6162 6f76 6520 verything above │ │ │ │ │ -00009e80: 4752 5542 2069 6d61 6765 2028 6672 6f6d GRUB image (from │ │ │ │ │ -00009e90: 2032 4d69 4220 2b20 6b65 726e 656c 0a73 2MiB + kernel.s │ │ │ │ │ -00009ea0: 697a 6529 2075 6e74 696c 2032 3536 4d69 ize) until 256Mi │ │ │ │ │ -00009eb0: 4220 6973 2070 6172 7420 6f66 2068 6561 B is part of hea │ │ │ │ │ -00009ec0: 702e 0a0a 2020 204f 6e20 6d69 7073 2d61 p... On mips-a │ │ │ │ │ -00009ed0: 7263 2073 7461 636b 2069 7320 324d 6942 rc stack is 2MiB │ │ │ │ │ -00009ee0: 2028 6576 6572 7974 6869 6e67 2062 656c (everything bel │ │ │ │ │ -00009ef0: 6f77 2047 5255 4220 696d 6167 6529 2061 ow GRUB image) a │ │ │ │ │ -00009f00: 6e64 0a65 7665 7279 7468 696e 6720 6162 nd.everything ab │ │ │ │ │ -00009f10: 6f76 6520 4752 5542 2069 6d61 6765 2866 ove GRUB image(f │ │ │ │ │ -00009f20: 726f 6d20 324d 6942 202b 206b 6572 6e65 rom 2MiB + kerne │ │ │ │ │ -00009f30: 6c20 7369 7a65 2920 756e 7469 6c20 3132 l size) until 12 │ │ │ │ │ -00009f40: 384d 6942 2069 730a 7061 7274 206f 6620 8MiB is.part of │ │ │ │ │ -00009f50: 6865 6170 2e0a 0a20 2020 4f6e 206d 6970 heap... On mip │ │ │ │ │ -00009f60: 7365 6c2d 6172 6320 7374 6163 6b20 6973 sel-arc stack is │ │ │ │ │ -00009f70: 2032 4d69 4220 2865 7665 7279 7468 696e 2MiB (everythin │ │ │ │ │ -00009f80: 6720 6265 6c6f 7720 4752 5542 2069 6d61 g below GRUB ima │ │ │ │ │ -00009f90: 6765 2077 6869 6368 2069 7320 6e6f 740a ge which is not. │ │ │ │ │ -00009fa0: 7061 7274 206f 6620 4152 4329 2061 6e64 part of ARC) and │ │ │ │ │ -00009fb0: 2065 7665 7279 7468 696e 6720 6162 6f76 everything abov │ │ │ │ │ -00009fc0: 6520 4752 5542 2069 6d61 6765 2028 6672 e GRUB image (fr │ │ │ │ │ -00009fd0: 6f6d 2037 4d69 4220 2b20 6b65 726e 656c om 7MiB + kernel │ │ │ │ │ -00009fe0: 2073 697a 6529 0a75 6e74 696c 2032 3536 size).until 256 │ │ │ │ │ -00009ff0: 4d69 4220 6973 2070 6172 7420 6f66 2068 MiB is part of h │ │ │ │ │ -0000a000: 6561 702e 0a0a 2020 204f 6e20 6172 6d2d eap... On arm- │ │ │ │ │ -0000a010: 7562 6f6f 7420 7374 6163 6b20 6973 2032 uboot stack is 2 │ │ │ │ │ -0000a020: 3536 4b69 4220 616e 6420 6865 6170 2069 56KiB and heap i │ │ │ │ │ -0000a030: 7320 324d 6942 2e0a 0a20 2020 496e 2073 s 2MiB... In s │ │ │ │ │ -0000a040: 686f 7274 3a0a 0a50 6c61 7466 6f72 6d20 hort:..Platform │ │ │ │ │ -0000a050: 2020 2053 7461 636b 2020 2020 2020 2020 Stack │ │ │ │ │ -0000a060: 2020 2020 2020 4865 6170 0a2d 2d2d 2d2d Heap.----- │ │ │ │ │ +00008e60: 2020 2022 7465 7374 2e74 7874 222c 0a20 "test.txt",. │ │ │ │ │ +00008e70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00008e80: 2020 2020 2020 2020 2031 3029 3b0a 2020 10);. │ │ │ │ │ +00008e90: 2020 207d 0a0a 2020 2049 6620 7468 6572 }.. If ther │ │ │ │ │ +00008ea0: 6520 6973 2061 2073 7065 6369 616c 2072 e is a special r │ │ │ │ │ +00008eb0: 6561 736f 6e20 7468 6174 2065 7272 6f72 eason that error │ │ │ │ │ +00008ec0: 2063 6f64 6520 646f 6573 206e 6f74 206e code does not n │ │ │ │ │ +00008ed0: 6565 6420 746f 2062 650a 7461 6b65 6e20 eed to be.taken │ │ │ │ │ +00008ee0: 6163 636f 756e 742c 2027 6772 7562 5f65 account, 'grub_e │ │ │ │ │ +00008ef0: 7272 6e6f 2720 6361 6e20 6265 207a 6572 rrno' can be zer │ │ │ │ │ +00008f00: 6f65 6420 6261 636b 2074 6f20 2747 5255 oed back to 'GRU │ │ │ │ │ +00008f10: 425f 4552 525f 4e4f 4e45 272e 2020 496e B_ERR_NONE'. In │ │ │ │ │ +00008f20: 0a63 6173 6573 206c 696b 6520 7468 6973 .cases like this │ │ │ │ │ +00008f30: 2061 6c6c 2070 7265 7669 6f75 7320 6572 all previous er │ │ │ │ │ +00008f40: 726f 7220 636f 6465 7320 7368 6f75 6c64 ror codes should │ │ │ │ │ +00008f50: 2068 6176 6520 6265 656e 2068 616e 646c have been handl │ │ │ │ │ +00008f60: 6564 0a63 6f72 7265 6374 6c79 2e20 2054 ed.correctly. T │ │ │ │ │ +00008f70: 6869 7320 6d61 6b65 7320 7375 7265 2074 his makes sure t │ │ │ │ │ +00008f80: 6861 7420 7468 6572 6520 6172 6520 6e6f hat there are no │ │ │ │ │ +00008f90: 2075 6e68 616e 646c 6564 2065 7863 6570 unhandled excep │ │ │ │ │ +00008fa0: 7469 6f6e 732e 0a0a 2020 2045 7861 6d70 tions... Examp │ │ │ │ │ +00008fb0: 6c65 206f 6620 7a65 726f 696e 6720 2767 le of zeroing 'g │ │ │ │ │ +00008fc0: 7275 625f 6572 726e 6f27 2e0a 2020 2020 rub_errno'.. │ │ │ │ │ +00008fd0: 2067 7275 625f 6572 725f 740a 2020 2020 grub_err_t. │ │ │ │ │ +00008fe0: 2070 726f 6265 5f65 7861 6d70 6c65 2028 probe_example ( │ │ │ │ │ +00008ff0: 290a 2020 2020 207b 0a20 2020 2020 2020 ). {. │ │ │ │ │ +00009000: 2f2a 2054 7279 2074 6f20 7072 6f62 6520 /* Try to probe │ │ │ │ │ +00009010: 6465 7669 6365 2074 7970 6520 312e 2020 device type 1. │ │ │ │ │ +00009020: 2a2f 0a20 2020 2020 2020 7072 6f62 655f */. probe_ │ │ │ │ │ +00009030: 666f 725f 6465 7669 6365 2028 293b 0a20 for_device ();. │ │ │ │ │ +00009040: 2020 2020 2020 6966 2028 6772 7562 5f65 if (grub_e │ │ │ │ │ +00009050: 7272 6e6f 203d 3d20 4752 5542 5f45 5252 rrno == GRUB_ERR │ │ │ │ │ +00009060: 5f4e 4f4e 4529 0a20 2020 2020 2020 2020 _NONE). │ │ │ │ │ +00009070: 7b0a 2020 2020 2020 2020 2020 202f 2a20 {. /* │ │ │ │ │ +00009080: 4465 7669 6365 2074 7970 6520 3120 7761 Device type 1 wa │ │ │ │ │ +00009090: 7320 666f 756e 6420 6f6e 2073 7973 7465 s found on syste │ │ │ │ │ +000090a0: 6d2e 2020 2a2f 0a20 2020 2020 2020 2020 m. */. │ │ │ │ │ +000090b0: 2020 7265 6769 7374 6572 5f64 6576 6963 register_devic │ │ │ │ │ +000090c0: 6520 2829 3b0a 2020 2020 2020 2020 2020 e ();. │ │ │ │ │ +000090d0: 2072 6574 7572 6e20 4752 5542 5f45 5252 return GRUB_ERR │ │ │ │ │ +000090e0: 5f4e 4f4e 453b 0a20 2020 2020 2020 2020 _NONE;. │ │ │ │ │ +000090f0: 7d0a 2020 2020 2020 202f 2a20 5a65 726f }. /* Zero │ │ │ │ │ +00009100: 206f 7574 2065 7272 6f72 2063 6f64 652e out error code. │ │ │ │ │ +00009110: 2020 2a2f 0a20 2020 2020 2020 6772 7562 */. grub │ │ │ │ │ +00009120: 5f65 7272 6e6f 203d 2047 5255 425f 4552 _errno = GRUB_ER │ │ │ │ │ +00009130: 525f 4e4f 4e45 3b0a 0a20 2020 2020 2020 R_NONE;.. │ │ │ │ │ +00009140: 2f2a 204e 6f20 6465 7669 6365 2074 7970 /* No device typ │ │ │ │ │ +00009150: 6520 3120 666f 756e 642c 2074 7279 2074 e 1 found, try t │ │ │ │ │ +00009160: 6f20 7072 6f62 6520 6465 7669 6365 2074 o probe device t │ │ │ │ │ +00009170: 7970 6520 322e 2020 2a2f 0a20 2020 2020 ype 2. */. │ │ │ │ │ +00009180: 2020 7072 6f62 655f 666f 725f 6465 7669 probe_for_devi │ │ │ │ │ +00009190: 6365 3220 2829 3b0a 2020 2020 2020 2069 ce2 ();. i │ │ │ │ │ +000091a0: 6620 2867 7275 625f 6572 726e 6f20 3d3d f (grub_errno == │ │ │ │ │ +000091b0: 2047 5255 425f 4552 525f 4e4f 4e45 290a GRUB_ERR_NONE). │ │ │ │ │ +000091c0: 2020 2020 2020 2020 207b 0a20 2020 2020 {. │ │ │ │ │ +000091d0: 2020 2020 2020 2f2a 2044 6576 6963 6520 /* Device │ │ │ │ │ +000091e0: 7479 7065 2032 2077 6173 2066 6f75 6e64 type 2 was found │ │ │ │ │ +000091f0: 206f 6e20 7379 7374 656d 2e20 202a 2f0a on system. */. │ │ │ │ │ +00009200: 2020 2020 2020 2020 2020 2072 6567 6973 regis │ │ │ │ │ +00009210: 7465 725f 6465 7669 6365 3220 2829 3b0a ter_device2 ();. │ │ │ │ │ +00009220: 2020 2020 2020 2020 2020 2072 6574 7572 retur │ │ │ │ │ +00009230: 6e20 4752 5542 5f45 5252 5f4e 4f4e 453b n GRUB_ERR_NONE; │ │ │ │ │ +00009240: 0a20 2020 2020 2020 2020 7d0a 2020 2020 . }. │ │ │ │ │ +00009250: 2020 202f 2a20 5a65 726f 206f 7574 2065 /* Zero out e │ │ │ │ │ +00009260: 7272 6f72 2063 6f64 652e 2020 2a2f 0a20 rror code. */. │ │ │ │ │ +00009270: 2020 2020 2020 6772 7562 5f65 7272 6e6f grub_errno │ │ │ │ │ +00009280: 203d 2047 5255 425f 4552 525f 4e4f 4e45 = GRUB_ERR_NONE │ │ │ │ │ +00009290: 3b0a 0a20 2020 2020 2020 2f2a 2052 6574 ;.. /* Ret │ │ │ │ │ +000092a0: 7572 6e20 6375 7374 6f6d 2065 7272 6f72 urn custom error │ │ │ │ │ +000092b0: 206d 6573 7361 6765 2e20 202a 2f0a 2020 message. */. │ │ │ │ │ +000092c0: 2020 2020 2072 6574 7572 6e20 6772 7562 return grub │ │ │ │ │ +000092d0: 5f65 7272 6f72 2028 4752 5542 5f45 5252 _error (GRUB_ERR │ │ │ │ │ +000092e0: 5f55 4e4b 4e4f 574e 5f44 4556 4943 452c _UNKNOWN_DEVICE, │ │ │ │ │ +000092f0: 2022 4e6f 2064 6576 6963 6520 7479 7065 "No device type │ │ │ │ │ +00009300: 2031 206f 7220 3220 666f 756e 642e 2229 1 or 2 found.") │ │ │ │ │ +00009310: 3b0a 2020 2020 207d 0a0a 2020 2053 6f6d ;. }.. Som │ │ │ │ │ +00009320: 6520 7469 6d65 7320 7468 6572 6520 6973 e times there is │ │ │ │ │ +00009330: 2061 206e 6565 6420 746f 2063 6f6e 7469 a need to conti │ │ │ │ │ +00009340: 6e75 6520 7072 6f63 6573 7369 6e67 2065 nue processing e │ │ │ │ │ +00009350: 7665 6e20 6966 2074 6865 7265 2069 7320 ven if there is │ │ │ │ │ +00009360: 610a 6572 726f 7220 7374 6174 6520 696e a.error state in │ │ │ │ │ +00009370: 2061 7070 6c69 6361 7469 6f6e 2e20 2049 application. I │ │ │ │ │ +00009380: 6e20 7369 7475 6174 696f 6e73 206c 696b n situations lik │ │ │ │ │ +00009390: 6520 7468 6973 2c20 7468 6572 6520 6973 e this, there is │ │ │ │ │ +000093a0: 2061 206e 6565 6465 640a 746f 2073 6176 a needed.to sav │ │ │ │ │ +000093b0: 6520 6f6c 6420 6572 726f 7220 7374 6174 e old error stat │ │ │ │ │ +000093c0: 6520 616e 6420 7468 656e 2063 616c 6c20 e and then call │ │ │ │ │ +000093d0: 6f74 6865 7220 6675 6e63 7469 6f6e 7320 other functions │ │ │ │ │ +000093e0: 7468 6174 206d 6967 6874 2066 6169 6c2e that might fail. │ │ │ │ │ +000093f0: 0a54 6f20 6169 6420 696e 2074 6869 732c .To aid in this, │ │ │ │ │ +00009400: 2074 6865 7265 2069 7320 6120 6572 726f there is a erro │ │ │ │ │ +00009410: 7220 7374 6163 6b20 696d 706c 656d 656e r stack implemen │ │ │ │ │ +00009420: 7465 642e 2020 4572 726f 7220 7374 6174 ted. Error stat │ │ │ │ │ +00009430: 6520 6361 6e20 6265 0a70 7573 6865 6420 e can be.pushed │ │ │ │ │ +00009440: 746f 2065 7272 6f72 2073 7461 636b 2062 to error stack b │ │ │ │ │ +00009450: 7920 6361 6c6c 696e 6720 6675 6e63 7469 y calling functi │ │ │ │ │ +00009460: 6f6e 2027 6772 7562 5f65 7272 6f72 5f70 on 'grub_error_p │ │ │ │ │ +00009470: 7573 6820 2829 272e 2020 5768 656e 0a70 ush ()'. When.p │ │ │ │ │ +00009480: 726f 6365 7373 696e 6720 6861 7320 6265 rocessing has be │ │ │ │ │ +00009490: 656e 2063 6f6d 706c 6574 6564 2c20 2767 en completed, 'g │ │ │ │ │ +000094a0: 7275 625f 6572 726f 725f 706f 7020 2829 rub_error_pop () │ │ │ │ │ +000094b0: 2720 6361 6e20 6265 2075 7365 6420 746f ' can be used to │ │ │ │ │ +000094c0: 2070 6f70 0a65 7272 6f72 2073 7461 7465 pop.error state │ │ │ │ │ +000094d0: 2066 726f 6d20 7374 6163 6b2e 2020 4572 from stack. Er │ │ │ │ │ +000094e0: 726f 7220 7374 6163 6b20 636f 6e74 6169 ror stack contai │ │ │ │ │ +000094f0: 6e73 2070 7265 6465 6669 6e65 6420 616d ns predefined am │ │ │ │ │ +00009500: 6f75 6e74 206f 6620 6572 726f 720a 7374 ount of error.st │ │ │ │ │ +00009510: 6163 6b20 6974 656d 732e 2020 4572 726f ack items. Erro │ │ │ │ │ +00009520: 7220 7374 6163 6b20 6973 2070 726f 7465 r stack is prote │ │ │ │ │ +00009530: 6374 6564 2066 6f72 206f 7665 7266 6c6f cted for overflo │ │ │ │ │ +00009540: 7720 616e 6420 6d61 726b 7320 7468 6573 w and marks thes │ │ │ │ │ +00009550: 650a 7369 7475 6174 696f 6e73 2073 6f20 e.situations so │ │ │ │ │ +00009560: 6f76 6572 666c 6f77 2065 7272 6f72 2064 overflow error d │ │ │ │ │ +00009570: 6f65 7320 6e6f 7420 6765 7420 756e 7365 oes not get unse │ │ │ │ │ +00009580: 656e 2e20 2049 6620 7468 6572 6520 6973 en. If there is │ │ │ │ │ +00009590: 206e 6f20 7370 6163 650a 6176 6169 6c61 no space.availa │ │ │ │ │ +000095a0: 626c 6520 746f 2073 746f 7265 2065 7272 ble to store err │ │ │ │ │ +000095b0: 6f72 206d 6573 7361 6765 2c20 6974 2069 or message, it i │ │ │ │ │ +000095c0: 7320 7369 6d70 6c79 2064 6973 6361 7264 s simply discard │ │ │ │ │ +000095d0: 6564 2061 6e64 206f 7665 7266 6c6f 770a ed and overflow. │ │ │ │ │ +000095e0: 7769 6c6c 2062 6520 6d61 726b 6564 2061 will be marked a │ │ │ │ │ +000095f0: 7320 6861 7070 656e 6564 2e20 2057 6865 s happened. Whe │ │ │ │ │ +00009600: 6e20 6f76 6572 666c 6f77 2068 6170 7065 n overflow happe │ │ │ │ │ +00009610: 6e73 2c20 6974 206d 6f73 7420 6c69 6b65 ns, it most like │ │ │ │ │ +00009620: 6c79 2077 696c 6c0a 636f 7272 7570 7420 ly will.corrupt │ │ │ │ │ +00009630: 6572 726f 7220 7374 6163 6b20 636f 6e73 error stack cons │ │ │ │ │ +00009640: 6973 7465 6e63 7920 6173 2066 6f72 2070 istency as for p │ │ │ │ │ +00009650: 7573 6865 6420 6572 726f 7220 7468 6572 ushed error ther │ │ │ │ │ +00009660: 6520 6973 206e 6f20 6d61 7463 6869 6e67 e is no matching │ │ │ │ │ +00009670: 0a70 6f70 2c20 6275 7420 6f76 6572 666c .pop, but overfl │ │ │ │ │ +00009680: 6f77 206d 6573 7361 6765 2077 696c 6c20 ow message will │ │ │ │ │ +00009690: 6265 2073 686f 776e 2074 6f20 696e 666f be shown to info │ │ │ │ │ +000096a0: 726d 2075 7365 7220 6162 6f75 7420 7468 rm user about th │ │ │ │ │ +000096b0: 650a 7369 7475 6174 696f 6e2e 2020 4f76 e.situation. Ov │ │ │ │ │ +000096c0: 6572 666c 6f77 206d 6573 7361 6765 2077 erflow message w │ │ │ │ │ +000096d0: 696c 6c20 6265 2073 686f 776e 2061 7420 ill be shown at │ │ │ │ │ +000096e0: 7469 6d65 2077 6865 6e20 7072 6f6d 7074 time when prompt │ │ │ │ │ +000096f0: 2069 7320 6162 6f75 740a 746f 2062 6520 is about.to be │ │ │ │ │ +00009700: 6472 6177 6e2e 0a0a 2020 2045 7861 6d70 drawn... Examp │ │ │ │ │ +00009710: 6c65 2075 7361 6765 206f 6620 6572 726f le usage of erro │ │ │ │ │ +00009720: 7220 7374 6163 6b2e 0a20 2020 2020 2f2a r stack.. /* │ │ │ │ │ +00009730: 2053 6176 6520 706f 7373 6962 6c65 206f Save possible o │ │ │ │ │ +00009740: 6c64 2065 7272 6f72 206d 6573 7361 6765 ld error message │ │ │ │ │ +00009750: 2e20 202a 2f0a 2020 2020 2067 7275 625f . */. grub_ │ │ │ │ │ +00009760: 6572 726f 725f 7075 7368 2028 293b 0a0a error_push ();.. │ │ │ │ │ +00009770: 2020 2020 202f 2a20 446f 2079 6f75 7220 /* Do your │ │ │ │ │ +00009780: 7374 7566 6620 6865 7265 2e20 202a 2f0a stuff here. */. │ │ │ │ │ +00009790: 2020 2020 2063 616c 6c5f 706f 7373 6962 call_possib │ │ │ │ │ +000097a0: 6c79 5f66 6169 6c69 6e67 5f66 756e 6374 ly_failing_funct │ │ │ │ │ +000097b0: 696f 6e20 2829 3b0a 0a20 2020 2020 6966 ion ();.. if │ │ │ │ │ +000097c0: 2028 6772 7562 5f65 7272 6e6f 2021 3d20 (grub_errno != │ │ │ │ │ +000097d0: 4752 5542 5f45 5252 5f4e 4f4e 4529 0a20 GRUB_ERR_NONE). │ │ │ │ │ +000097e0: 2020 2020 2020 7b0a 2020 2020 2020 2020 {. │ │ │ │ │ +000097f0: 202f 2a20 496e 666f 726d 2072 6573 7420 /* Inform rest │ │ │ │ │ +00009800: 6f66 2074 6865 2063 6f64 6520 7468 6174 of the code that │ │ │ │ │ +00009810: 2074 6865 7265 2069 7320 6572 726f 7220 there is error │ │ │ │ │ +00009820: 2867 7275 625f 6572 726e 6f0a 2020 2020 (grub_errno. │ │ │ │ │ +00009830: 2020 2020 2020 2020 6973 2073 6574 292e is set). │ │ │ │ │ +00009840: 2054 6865 7265 2069 7320 6e6f 2070 6f70 There is no pop │ │ │ │ │ +00009850: 2068 6572 6520 6173 2077 6520 7761 6e74 here as we want │ │ │ │ │ +00009860: 2062 6f74 6820 6572 726f 7220 7374 6174 both error stat │ │ │ │ │ +00009870: 6573 0a20 2020 2020 2020 2020 2020 2074 es. t │ │ │ │ │ +00009880: 6f20 6265 2064 6973 706c 6179 6564 2e20 o be displayed. │ │ │ │ │ +00009890: 202a 2f0a 2020 2020 2020 2020 2072 6574 */. ret │ │ │ │ │ +000098a0: 7572 6e3b 0a20 2020 2020 2020 7d0a 0a20 urn;. }.. │ │ │ │ │ +000098b0: 2020 2020 2f2a 2052 6573 746f 7265 206f /* Restore o │ │ │ │ │ +000098c0: 6c64 2065 7272 6f72 2073 7461 7465 2062 ld error state b │ │ │ │ │ +000098d0: 7920 706f 7070 696e 6720 7072 6576 696f y popping previo │ │ │ │ │ +000098e0: 7573 2069 7465 6d20 6672 6f6d 2073 7461 us item from sta │ │ │ │ │ +000098f0: 636b 2e20 2a2f 0a20 2020 2020 6772 7562 ck. */. grub │ │ │ │ │ +00009900: 5f65 7272 6f72 5f70 6f70 2028 293b 0a0a _error_pop ();.. │ │ │ │ │ +00009910: 1f0a 4669 6c65 3a20 6772 7562 2d64 6576 ..File: grub-dev │ │ │ │ │ +00009920: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 5374 .info, Node: St │ │ │ │ │ +00009930: 6163 6b20 616e 6420 6865 6170 2073 697a ack and heap siz │ │ │ │ │ +00009940: 652c 2020 4e65 7874 3a20 4249 4f53 2070 e, Next: BIOS p │ │ │ │ │ +00009950: 6f72 7420 6d65 6d6f 7279 206d 6170 2c20 ort memory map, │ │ │ │ │ +00009960: 2050 7265 763a 2045 7272 6f72 2048 616e Prev: Error Han │ │ │ │ │ +00009970: 646c 696e 672c 2020 5570 3a20 546f 700a dling, Up: Top. │ │ │ │ │ +00009980: 0a38 2053 7461 636b 2061 6e64 2068 6561 .8 Stack and hea │ │ │ │ │ +00009990: 7020 7369 7a65 0a2a 2a2a 2a2a 2a2a 2a2a p size.********* │ │ │ │ │ +000099a0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a 4f6e ************..On │ │ │ │ │ +000099b0: 2065 6d75 2073 7461 636b 2061 6e64 2068 emu stack and h │ │ │ │ │ +000099c0: 6561 7020 6172 6520 6a75 7374 206e 6f72 eap are just nor │ │ │ │ │ +000099d0: 6d61 6c20 686f 7374 204f 5320 7374 6163 mal host OS stac │ │ │ │ │ +000099e0: 6b20 616e 6420 6865 6170 2e20 2053 7461 k and heap. Sta │ │ │ │ │ +000099f0: 636b 2069 730a 7479 7069 6361 6c6c 7920 ck is.typically │ │ │ │ │ +00009a00: 3820 4d69 4220 616c 7468 6f75 6768 2069 8 MiB although i │ │ │ │ │ +00009a10: 7427 7320 4f53 2d64 6570 656e 6465 6e74 t's OS-dependent │ │ │ │ │ +00009a20: 2e0a 0a20 2020 4f6e 2069 3338 362d 7063 ... On i386-pc │ │ │ │ │ +00009a30: 2c20 6933 3836 2d63 6f72 6562 6f6f 742c , i386-coreboot, │ │ │ │ │ +00009a40: 2069 3338 362d 7165 6d75 2061 6e64 2069 i386-qemu and i │ │ │ │ │ +00009a50: 3338 362d 6d75 6c74 6962 6f6f 7420 7468 386-multiboot th │ │ │ │ │ +00009a60: 6520 7374 6163 6b20 6973 0a36 304b 6942 e stack is.60KiB │ │ │ │ │ +00009a70: 2e20 416c 6c20 6176 6169 6c61 626c 6520 . All available │ │ │ │ │ +00009a80: 7370 6163 6520 6265 7477 6565 6e20 314d space between 1M │ │ │ │ │ +00009a90: 6942 2061 6e64 2034 4769 4220 6d61 726b iB and 4GiB mark │ │ │ │ │ +00009aa0: 7320 6973 2070 6172 7420 6f66 2068 6561 s is part of hea │ │ │ │ │ +00009ab0: 702e 0a0a 2020 204f 6e20 2a2d 7865 6e20 p... On *-xen │ │ │ │ │ +00009ac0: 7374 6163 6b20 6973 2034 4d69 422e 2049 stack is 4MiB. I │ │ │ │ │ +00009ad0: 6620 636f 6d70 696c 6564 2066 6f72 2078 f compiled for x │ │ │ │ │ +00009ae0: 3836 2d36 3420 7769 7468 2047 4343 2034 86-64 with GCC 4 │ │ │ │ │ +00009af0: 2e34 206f 7220 6c61 7465 720a 6164 7265 .4 or later.adre │ │ │ │ │ +00009b00: 7373 6162 6c65 2073 7061 6365 2069 7320 ssable space is │ │ │ │ │ +00009b10: 756e 6c69 6d69 7465 642e 2020 5768 656e unlimited. When │ │ │ │ │ +00009b20: 2063 6f6d 7069 6c65 6420 666f 7220 7838 compiled for x8 │ │ │ │ │ +00009b30: 362d 3634 2077 6974 6820 6f6c 6465 7220 6-64 with older │ │ │ │ │ +00009b40: 4743 430a 7665 7273 696f 6e20 6164 7265 GCC.version adre │ │ │ │ │ +00009b50: 7373 6162 6c65 2073 7061 6365 2069 7320 ssable space is │ │ │ │ │ +00009b60: 6c69 6d69 7465 6420 746f 2032 4769 422e limited to 2GiB. │ │ │ │ │ +00009b70: 2057 6865 6e20 636f 6d70 696c 696e 6720 When compiling │ │ │ │ │ +00009b80: 666f 7220 6933 3836 0a61 6472 6573 7361 for i386.adressa │ │ │ │ │ +00009b90: 626c 6520 7370 6163 6520 6973 206c 696d ble space is lim │ │ │ │ │ +00009ba0: 6974 6564 2074 6f20 3447 6942 2e20 416c ited to 4GiB. Al │ │ │ │ │ +00009bb0: 6c20 6164 7265 7373 6162 6c65 2070 6167 l adressable pag │ │ │ │ │ +00009bc0: 6573 2065 7863 6570 7420 7468 650a 6f6e es except the.on │ │ │ │ │ +00009bd0: 6573 2066 6f72 2073 7461 636b 2c20 4752 es for stack, GR │ │ │ │ │ +00009be0: 5542 2062 696e 6172 792c 2073 7065 6369 UB binary, speci │ │ │ │ │ +00009bf0: 616c 2070 6167 6573 2061 6e64 2070 6167 al pages and pag │ │ │ │ │ +00009c00: 6520 7461 626c 6520 6172 6520 696e 2074 e table are in t │ │ │ │ │ +00009c10: 6865 0a68 6561 702e 0a0a 2020 204f 6e20 he.heap... On │ │ │ │ │ +00009c20: 2a2d 6566 6920 4752 5542 2075 7365 7320 *-efi GRUB uses │ │ │ │ │ +00009c30: 7361 6d65 2073 7461 636b 2061 7320 4546 same stack as EF │ │ │ │ │ +00009c40: 492e 2049 6620 636f 6d70 696c 6564 2066 I. If compiled f │ │ │ │ │ +00009c50: 6f72 2078 3836 2d36 3420 7769 7468 2047 or x86-64 with G │ │ │ │ │ +00009c60: 4343 0a34 2e34 206f 7220 6c61 7465 7220 CC.4.4 or later │ │ │ │ │ +00009c70: 6164 7265 7373 6162 6c65 2073 7061 6365 adressable space │ │ │ │ │ +00009c80: 2069 7320 756e 6c69 6d69 7465 642e 2020 is unlimited. │ │ │ │ │ +00009c90: 5768 656e 2063 6f6d 7069 6c65 6420 666f When compiled fo │ │ │ │ │ +00009ca0: 7220 7838 362d 3634 0a77 6974 6820 6f6c r x86-64.with ol │ │ │ │ │ +00009cb0: 6465 7220 4743 4320 7665 7273 696f 6e20 der GCC version │ │ │ │ │ +00009cc0: 6164 7265 7373 6162 6c65 2073 7061 6365 adressable space │ │ │ │ │ +00009cd0: 2069 7320 6c69 6d69 7465 6420 746f 2032 is limited to 2 │ │ │ │ │ +00009ce0: 4769 422e 2046 6f72 2061 6c6c 0a6f 7468 GiB. For all.oth │ │ │ │ │ +00009cf0: 6572 2070 6c61 7466 6f72 6d73 2061 6472 er platforms adr │ │ │ │ │ +00009d00: 6573 7361 626c 6520 7370 6163 6520 6973 essable space is │ │ │ │ │ +00009d10: 206c 696d 6974 6564 2074 6f20 3447 6942 limited to 4GiB │ │ │ │ │ +00009d20: 2e20 4752 5542 2061 6c6c 6f63 6174 6573 . GRUB allocates │ │ │ │ │ +00009d30: 0a70 6167 6573 2066 726f 6d20 4546 4920 .pages from EFI │ │ │ │ │ +00009d40: 666f 7220 6974 7320 6865 6170 2c20 6174 for its heap, at │ │ │ │ │ +00009d50: 206d 6f73 7420 312e 3620 4769 422e 0a0a most 1.6 GiB... │ │ │ │ │ +00009d60: 2020 204f 6e20 6933 3836 2d69 6565 6531 On i386-ieee1 │ │ │ │ │ +00009d70: 3237 3520 616e 6420 706f 7765 7270 632d 275 and powerpc- │ │ │ │ │ +00009d80: 6965 6565 3132 3735 2047 5255 4220 7573 ieee1275 GRUB us │ │ │ │ │ +00009d90: 6573 2073 616d 6520 7374 6163 6b20 6173 es same stack as │ │ │ │ │ +00009da0: 0a49 4545 4531 3237 352e 2020 4974 2061 .IEEE1275. It a │ │ │ │ │ +00009db0: 6c6c 6f63 6174 6573 2061 7420 6d6f 7374 llocates at most │ │ │ │ │ +00009dc0: 2033 324d 6942 2066 6f72 2069 7473 2068 32MiB for its h │ │ │ │ │ +00009dd0: 6561 702e 0a0a 2020 204f 6e20 7370 6172 eap... On spar │ │ │ │ │ +00009de0: 6336 342d 6965 6565 3132 3735 2073 7461 c64-ieee1275 sta │ │ │ │ │ +00009df0: 636b 2069 7320 3235 364b 6942 2061 6e64 ck is 256KiB and │ │ │ │ │ +00009e00: 2068 6561 7020 6973 2032 4d69 422e 0a0a heap is 2MiB... │ │ │ │ │ +00009e10: 2020 204f 6e20 6d69 7073 2865 6c29 2d71 On mips(el)-q │ │ │ │ │ +00009e20: 656d 755f 6d69 7073 2061 6e64 206d 6970 emu_mips and mip │ │ │ │ │ +00009e30: 7365 6c2d 6c6f 6f6e 6773 6f6e 2073 7461 sel-loongson sta │ │ │ │ │ +00009e40: 636b 2069 7320 324d 6942 2028 6576 6572 ck is 2MiB (ever │ │ │ │ │ +00009e50: 7974 6869 6e67 0a62 656c 6f77 2047 5255 ything.below GRU │ │ │ │ │ +00009e60: 4220 696d 6167 6529 2061 6e64 2065 7665 B image) and eve │ │ │ │ │ +00009e70: 7279 7468 696e 6720 6162 6f76 6520 4752 rything above GR │ │ │ │ │ +00009e80: 5542 2069 6d61 6765 2028 6672 6f6d 2032 UB image (from 2 │ │ │ │ │ +00009e90: 4d69 4220 2b20 6b65 726e 656c 0a73 697a MiB + kernel.siz │ │ │ │ │ +00009ea0: 6529 2075 6e74 696c 2032 3536 4d69 4220 e) until 256MiB │ │ │ │ │ +00009eb0: 6973 2070 6172 7420 6f66 2068 6561 702e is part of heap. │ │ │ │ │ +00009ec0: 0a0a 2020 204f 6e20 6d69 7073 2d61 7263 .. On mips-arc │ │ │ │ │ +00009ed0: 2073 7461 636b 2069 7320 324d 6942 2028 stack is 2MiB ( │ │ │ │ │ +00009ee0: 6576 6572 7974 6869 6e67 2062 656c 6f77 everything below │ │ │ │ │ +00009ef0: 2047 5255 4220 696d 6167 6529 2061 6e64 GRUB image) and │ │ │ │ │ +00009f00: 0a65 7665 7279 7468 696e 6720 6162 6f76 .everything abov │ │ │ │ │ +00009f10: 6520 4752 5542 2069 6d61 6765 2866 726f e GRUB image(fro │ │ │ │ │ +00009f20: 6d20 324d 6942 202b 206b 6572 6e65 6c20 m 2MiB + kernel │ │ │ │ │ +00009f30: 7369 7a65 2920 756e 7469 6c20 3132 384d size) until 128M │ │ │ │ │ +00009f40: 6942 2069 730a 7061 7274 206f 6620 6865 iB is.part of he │ │ │ │ │ +00009f50: 6170 2e0a 0a20 2020 4f6e 206d 6970 7365 ap... On mipse │ │ │ │ │ +00009f60: 6c2d 6172 6320 7374 6163 6b20 6973 2032 l-arc stack is 2 │ │ │ │ │ +00009f70: 4d69 4220 2865 7665 7279 7468 696e 6720 MiB (everything │ │ │ │ │ +00009f80: 6265 6c6f 7720 4752 5542 2069 6d61 6765 below GRUB image │ │ │ │ │ +00009f90: 2077 6869 6368 2069 7320 6e6f 740a 7061 which is not.pa │ │ │ │ │ +00009fa0: 7274 206f 6620 4152 4329 2061 6e64 2065 rt of ARC) and e │ │ │ │ │ +00009fb0: 7665 7279 7468 696e 6720 6162 6f76 6520 verything above │ │ │ │ │ +00009fc0: 4752 5542 2069 6d61 6765 2028 6672 6f6d GRUB image (from │ │ │ │ │ +00009fd0: 2037 4d69 4220 2b20 6b65 726e 656c 2073 7MiB + kernel s │ │ │ │ │ +00009fe0: 697a 6529 0a75 6e74 696c 2032 3536 4d69 ize).until 256Mi │ │ │ │ │ +00009ff0: 4220 6973 2070 6172 7420 6f66 2068 6561 B is part of hea │ │ │ │ │ +0000a000: 702e 0a0a 2020 204f 6e20 6172 6d2d 7562 p... On arm-ub │ │ │ │ │ +0000a010: 6f6f 7420 7374 6163 6b20 6973 2032 3536 oot stack is 256 │ │ │ │ │ +0000a020: 4b69 4220 616e 6420 6865 6170 2069 7320 KiB and heap is │ │ │ │ │ +0000a030: 324d 6942 2e0a 0a20 2020 496e 2073 686f 2MiB... In sho │ │ │ │ │ +0000a040: 7274 3a0a 0a50 6c61 7466 6f72 6d20 2020 rt:..Platform │ │ │ │ │ +0000a050: 2053 7461 636b 2020 2020 2020 2020 2020 Stack │ │ │ │ │ +0000a060: 2020 2020 4865 6170 0a2d 2d2d 2d2d 2d2d Heap.------- │ │ │ │ │ 0000a070: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 0000a080: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 0000a090: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000a0a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ -0000a0b0: 656d 7520 2020 2020 2020 2020 3820 4d69 emu 8 Mi │ │ │ │ │ -0000a0c0: 4220 2020 2020 2020 2020 2020 2020 203f B ? │ │ │ │ │ -0000a0d0: 0a69 3338 362d 7063 2020 2020 2036 3020 .i386-pc 60 │ │ │ │ │ -0000a0e0: 4b69 4220 2020 2020 2020 2020 2020 2020 KiB │ │ │ │ │ -0000a0f0: 3c20 3420 4769 420a 6933 3836 2d63 6f72 < 4 GiB.i386-cor │ │ │ │ │ -0000a100: 6562 6f6f 7436 3020 4b69 4220 2020 2020 eboot60 KiB │ │ │ │ │ -0000a110: 2020 2020 2020 203c 2034 2047 6942 0a69 < 4 GiB.i │ │ │ │ │ -0000a120: 3338 362d 6d75 6c74 6962 6f6f 7436 3020 386-multiboot60 │ │ │ │ │ -0000a130: 4b69 4220 2020 2020 2020 2020 2020 3c20 KiB < │ │ │ │ │ -0000a140: 3420 4769 420a 6933 3836 2d71 656d 7520 4 GiB.i386-qemu │ │ │ │ │ -0000a150: 2020 3630 204b 6942 2020 2020 2020 2020 60 KiB │ │ │ │ │ -0000a160: 2020 2020 203c 2034 2047 6942 0a2a 2d65 < 4 GiB.*-e │ │ │ │ │ -0000a170: 6669 2020 2020 2020 203f 2020 2020 2020 fi ? │ │ │ │ │ -0000a180: 2020 2020 2020 2020 2020 2020 3c20 312e < 1. │ │ │ │ │ -0000a190: 3620 4769 420a 6933 3836 2d69 6565 6531 6 GiB.i386-ieee1 │ │ │ │ │ -0000a1a0: 3237 353f 2020 2020 2020 2020 2020 2020 275? │ │ │ │ │ -0000a1b0: 2020 2020 203c 2033 3220 4d69 420a 706f < 32 MiB.po │ │ │ │ │ -0000a1c0: 7765 7270 632d 6965 6565 3132 3735 3f20 werpc-ieee1275? │ │ │ │ │ -0000a1d0: 2020 2020 2020 2020 2020 2020 203c 2033 < 3 │ │ │ │ │ -0000a1e0: 3220 4d69 420a 7370 6172 6336 342d 6965 2 MiB.sparc64-ie │ │ │ │ │ -0000a1f0: 6565 3132 3735 3235 364b 6942 2020 2020 ee1275256KiB │ │ │ │ │ -0000a200: 2020 2020 2032 204d 6942 0a61 726d 2d75 2 MiB.arm-u │ │ │ │ │ -0000a210: 626f 6f74 2020 2032 3536 4b69 4220 2020 boot 256KiB │ │ │ │ │ -0000a220: 2020 2020 2020 2020 2020 3220 4d69 420a 2 MiB. │ │ │ │ │ -0000a230: 6d69 7073 2865 6c29 2d71 656d 755f 6d69 mips(el)-qemu_mi │ │ │ │ │ -0000a240: 7073 324d 6942 2020 2020 2020 2020 2032 ps2MiB 2 │ │ │ │ │ -0000a250: 3533 204d 6942 0a6d 6970 7365 6c2d 6c6f 53 MiB.mipsel-lo │ │ │ │ │ -0000a260: 6f6e 6773 6f6e 324d 6942 2020 2020 2020 ongson2MiB │ │ │ │ │ -0000a270: 2020 2020 2020 3235 3320 4d69 420a 6d69 253 MiB.mi │ │ │ │ │ -0000a280: 7073 2d61 7263 2020 2020 324d 6942 2020 ps-arc 2MiB │ │ │ │ │ -0000a290: 2020 2020 2020 2020 2020 2020 2031 3235 125 │ │ │ │ │ -0000a2a0: 204d 6942 0a6d 6970 7365 6c2d 6172 6320 MiB.mipsel-arc │ │ │ │ │ -0000a2b0: 2032 4d69 4220 2020 2020 2020 2020 2020 2MiB │ │ │ │ │ -0000a2c0: 2020 2020 3234 3820 4d69 420a 7838 365f 248 MiB.x86_ │ │ │ │ │ -0000a2d0: 3634 2d78 656e 2020 344d 6942 2020 2020 64-xen 4MiB │ │ │ │ │ -0000a2e0: 2020 2020 2020 2020 2020 2075 6e6c 696d unlim │ │ │ │ │ -0000a2f0: 6974 6564 0a28 4743 4320 3e3d 0a34 2e34 ited.(GCC >=.4.4 │ │ │ │ │ -0000a300: 290a 7838 365f 3634 2d78 656e 2020 344d ).x86_64-xen 4M │ │ │ │ │ -0000a310: 6942 2020 2020 2020 2020 2020 2020 2020 iB │ │ │ │ │ -0000a320: 203c 2032 4769 420a 2847 4343 203c 0a34 < 2GiB.(GCC <.4 │ │ │ │ │ -0000a330: 2e34 290a 6933 3836 2d78 656e 2020 2020 .4).i386-xen │ │ │ │ │ -0000a340: 344d 6942 2020 2020 2020 2020 2020 2020 4MiB │ │ │ │ │ -0000a350: 2020 203c 2034 4769 420a 0a1f 0a46 696c < 4GiB....Fil │ │ │ │ │ -0000a360: 653a 2067 7275 622d 6465 762e 696e 666f e: grub-dev.info │ │ │ │ │ -0000a370: 2c20 204e 6f64 653a 2042 494f 5320 706f , Node: BIOS po │ │ │ │ │ -0000a380: 7274 206d 656d 6f72 7920 6d61 702c 2020 rt memory map, │ │ │ │ │ -0000a390: 4e65 7874 3a20 5669 6465 6f20 5375 6273 Next: Video Subs │ │ │ │ │ -0000a3a0: 7973 7465 6d2c 2020 5072 6576 3a20 5374 ystem, Prev: St │ │ │ │ │ -0000a3b0: 6163 6b20 616e 6420 6865 6170 2073 697a ack and heap siz │ │ │ │ │ -0000a3c0: 652c 2020 5570 3a20 546f 700a 0a39 2042 e, Up: Top..9 B │ │ │ │ │ -0000a3d0: 494f 5320 706f 7274 206d 656d 6f72 7920 IOS port memory │ │ │ │ │ -0000a3e0: 6d61 700a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a map.************ │ │ │ │ │ -0000a3f0: 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a 5374 6172 **********..Star │ │ │ │ │ -0000a400: 7420 2020 2020 2020 456e 6420 2020 2020 t End │ │ │ │ │ -0000a410: 2020 2020 2020 2020 2020 2055 7361 6765 Usage │ │ │ │ │ -0000a420: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ │ +0000a0a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 656d -------------.em │ │ │ │ │ +0000a0b0: 7520 2020 2020 2020 2020 3820 4d69 4220 u 8 MiB │ │ │ │ │ +0000a0c0: 2020 2020 2020 2020 2020 2020 203f 0a69 ?.i │ │ │ │ │ +0000a0d0: 3338 362d 7063 2020 2020 2036 3020 4b69 386-pc 60 Ki │ │ │ │ │ +0000a0e0: 4220 2020 2020 2020 2020 2020 2020 3c20 B < │ │ │ │ │ +0000a0f0: 3420 4769 420a 6933 3836 2d63 6f72 6562 4 GiB.i386-coreb │ │ │ │ │ +0000a100: 6f6f 7436 3020 4b69 4220 2020 2020 2020 oot60 KiB │ │ │ │ │ +0000a110: 2020 2020 203c 2034 2047 6942 0a69 3338 < 4 GiB.i38 │ │ │ │ │ +0000a120: 362d 6d75 6c74 6962 6f6f 7436 3020 4b69 6-multiboot60 Ki │ │ │ │ │ +0000a130: 4220 2020 2020 2020 2020 2020 3c20 3420 B < 4 │ │ │ │ │ +0000a140: 4769 420a 6933 3836 2d71 656d 7520 2020 GiB.i386-qemu │ │ │ │ │ +0000a150: 3630 204b 6942 2020 2020 2020 2020 2020 60 KiB │ │ │ │ │ +0000a160: 2020 203c 2034 2047 6942 0a2a 2d65 6669 < 4 GiB.*-efi │ │ │ │ │ +0000a170: 2020 2020 2020 203f 2020 2020 2020 2020 ? │ │ │ │ │ +0000a180: 2020 2020 2020 2020 2020 3c20 312e 3620 < 1.6 │ │ │ │ │ +0000a190: 4769 420a 6933 3836 2d69 6565 6531 3237 GiB.i386-ieee127 │ │ │ │ │ +0000a1a0: 353f 2020 2020 2020 2020 2020 2020 2020 5? │ │ │ │ │ +0000a1b0: 2020 203c 2033 3220 4d69 420a 706f 7765 < 32 MiB.powe │ │ │ │ │ +0000a1c0: 7270 632d 6965 6565 3132 3735 3f20 2020 rpc-ieee1275? │ │ │ │ │ +0000a1d0: 2020 2020 2020 2020 2020 203c 2033 3220 < 32 │ │ │ │ │ +0000a1e0: 4d69 420a 7370 6172 6336 342d 6965 6565 MiB.sparc64-ieee │ │ │ │ │ +0000a1f0: 3132 3735 3235 364b 6942 2020 2020 2020 1275256KiB │ │ │ │ │ +0000a200: 2020 2032 204d 6942 0a61 726d 2d75 626f 2 MiB.arm-ubo │ │ │ │ │ +0000a210: 6f74 2020 2032 3536 4b69 4220 2020 2020 ot 256KiB │ │ │ │ │ +0000a220: 2020 2020 2020 2020 3220 4d69 420a 6d69 2 MiB.mi │ │ │ │ │ +0000a230: 7073 2865 6c29 2d71 656d 755f 6d69 7073 ps(el)-qemu_mips │ │ │ │ │ +0000a240: 324d 6942 2020 2020 2020 2020 2032 3533 2MiB 253 │ │ │ │ │ +0000a250: 204d 6942 0a6d 6970 7365 6c2d 6c6f 6f6e MiB.mipsel-loon │ │ │ │ │ +0000a260: 6773 6f6e 324d 6942 2020 2020 2020 2020 gson2MiB │ │ │ │ │ +0000a270: 2020 2020 3235 3320 4d69 420a 6d69 7073 253 MiB.mips │ │ │ │ │ +0000a280: 2d61 7263 2020 2020 324d 6942 2020 2020 -arc 2MiB │ │ │ │ │ +0000a290: 2020 2020 2020 2020 2020 2031 3235 204d 125 M │ │ │ │ │ +0000a2a0: 6942 0a6d 6970 7365 6c2d 6172 6320 2032 iB.mipsel-arc 2 │ │ │ │ │ +0000a2b0: 4d69 4220 2020 2020 2020 2020 2020 2020 MiB │ │ │ │ │ +0000a2c0: 2020 3234 3820 4d69 420a 7838 365f 3634 248 MiB.x86_64 │ │ │ │ │ +0000a2d0: 2d78 656e 2020 344d 6942 2020 2020 2020 -xen 4MiB │ │ │ │ │ +0000a2e0: 2020 2020 2020 2020 2075 6e6c 696d 6974 unlimit │ │ │ │ │ +0000a2f0: 6564 0a28 4743 4320 3e3d 0a34 2e34 290a ed.(GCC >=.4.4). │ │ │ │ │ +0000a300: 7838 365f 3634 2d78 656e 2020 344d 6942 x86_64-xen 4MiB │ │ │ │ │ +0000a310: 2020 2020 2020 2020 2020 2020 2020 203c < │ │ │ │ │ +0000a320: 2032 4769 420a 2847 4343 203c 0a34 2e34 2GiB.(GCC <.4.4 │ │ │ │ │ +0000a330: 290a 6933 3836 2d78 656e 2020 2020 344d ).i386-xen 4M │ │ │ │ │ +0000a340: 6942 2020 2020 2020 2020 2020 2020 2020 iB │ │ │ │ │ +0000a350: 203c 2034 4769 420a 0a1f 0a46 696c 653a < 4GiB....File: │ │ │ │ │ +0000a360: 2067 7275 622d 6465 762e 696e 666f 2c20 grub-dev.info, │ │ │ │ │ +0000a370: 204e 6f64 653a 2042 494f 5320 706f 7274 Node: BIOS port │ │ │ │ │ +0000a380: 206d 656d 6f72 7920 6d61 702c 2020 4e65 memory map, Ne │ │ │ │ │ +0000a390: 7874 3a20 5669 6465 6f20 5375 6273 7973 xt: Video Subsys │ │ │ │ │ +0000a3a0: 7465 6d2c 2020 5072 6576 3a20 5374 6163 tem, Prev: Stac │ │ │ │ │ +0000a3b0: 6b20 616e 6420 6865 6170 2073 697a 652c k and heap size, │ │ │ │ │ +0000a3c0: 2020 5570 3a20 546f 700a 0a39 2042 494f Up: Top..9 BIO │ │ │ │ │ +0000a3d0: 5320 706f 7274 206d 656d 6f72 7920 6d61 S port memory ma │ │ │ │ │ +0000a3e0: 700a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a p.************** │ │ │ │ │ +0000a3f0: 2a2a 2a2a 2a2a 2a2a 0a0a 5374 6172 7420 ********..Start │ │ │ │ │ +0000a400: 2020 2020 2020 456e 6420 2020 2020 2020 End │ │ │ │ │ +0000a410: 2020 2020 2020 2020 2055 7361 6765 0a2d Usage.- │ │ │ │ │ +0000a420: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 0000a430: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 0000a440: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 0000a450: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000a460: 2d2d 2d2d 2d0a 3020 2020 2020 2020 2020 -----.0 │ │ │ │ │ -0000a470: 2020 3078 3130 3030 202d 2031 2020 2020 0x1000 - 1 │ │ │ │ │ -0000a480: 2020 2020 2042 494f 5320 616e 6420 7265 BIOS and re │ │ │ │ │ -0000a490: 616c 206d 6f64 6520 696e 7465 7272 7570 al mode interrup │ │ │ │ │ -0000a4a0: 7473 0a30 7830 3742 4520 2020 2020 2030 ts.0x07BE 0 │ │ │ │ │ -0000a4b0: 7830 3746 4620 2020 2020 2020 2020 2020 x07FF │ │ │ │ │ -0000a4c0: 2020 5061 7274 6974 696f 6e20 7461 626c Partition tabl │ │ │ │ │ -0000a4d0: 6520 7061 7373 6564 2074 6f20 616e 6f74 e passed to anot │ │ │ │ │ -0000a4e0: 6865 720a 2020 2020 2020 2020 2020 2020 her. │ │ │ │ │ +0000a460: 2d2d 2d0a 3020 2020 2020 2020 2020 2020 ---.0 │ │ │ │ │ +0000a470: 3078 3130 3030 202d 2031 2020 2020 2020 0x1000 - 1 │ │ │ │ │ +0000a480: 2020 2042 494f 5320 616e 6420 7265 616c BIOS and real │ │ │ │ │ +0000a490: 206d 6f64 6520 696e 7465 7272 7570 7473 mode interrupts │ │ │ │ │ +0000a4a0: 0a30 7830 3742 4520 2020 2020 2030 7830 .0x07BE 0x0 │ │ │ │ │ +0000a4b0: 3746 4620 2020 2020 2020 2020 2020 2020 7FF │ │ │ │ │ +0000a4c0: 5061 7274 6974 696f 6e20 7461 626c 6520 Partition table │ │ │ │ │ +0000a4d0: 7061 7373 6564 2074 6f20 616e 6f74 6865 passed to anothe │ │ │ │ │ +0000a4e0: 720a 2020 2020 2020 2020 2020 2020 2020 r. │ │ │ │ │ 0000a4f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0000a500: 2020 2062 6f6f 7420 6c6f 6164 6572 0a3f boot loader.? │ │ │ │ │ -0000a510: 2020 2020 2020 2020 2020 2030 7832 3030 0x200 │ │ │ │ │ -0000a520: 3020 2d20 3120 2020 2020 2020 2020 5265 0 - 1 Re │ │ │ │ │ -0000a530: 616c 206d 6f64 6520 7374 6163 6b0a 3078 al mode stack.0x │ │ │ │ │ -0000a540: 3743 3030 2020 2020 2020 3078 3744 3030 7C00 0x7D00 │ │ │ │ │ -0000a550: 202d 2031 2020 2020 2020 2020 2042 6f6f - 1 Boo │ │ │ │ │ -0000a560: 7420 7365 6374 6f72 0a30 7838 3030 3020 t sector.0x8000 │ │ │ │ │ -0000a570: 2020 2020 203f 2020 2020 2020 2020 2020 ? │ │ │ │ │ -0000a580: 2020 2020 2020 2020 4752 5542 206b 6572 GRUB ker │ │ │ │ │ -0000a590: 6e65 6c0a 3078 3638 3030 3020 2020 2020 nel.0x68000 │ │ │ │ │ -0000a5a0: 3078 3731 3030 3020 2d20 3120 2020 2020 0x71000 - 1 │ │ │ │ │ -0000a5b0: 2020 2044 6973 6b20 6275 6666 6572 0a3f Disk buffer.? │ │ │ │ │ -0000a5c0: 2020 2020 2020 2020 2020 2030 7838 3030 0x800 │ │ │ │ │ -0000a5d0: 3030 202d 2031 2020 2020 2020 2020 5072 00 - 1 Pr │ │ │ │ │ -0000a5e0: 6f74 6563 7465 6420 6d6f 6465 2073 7461 otected mode sta │ │ │ │ │ -0000a5f0: 636b 0a3f 2020 2020 2020 2020 2020 2030 ck.? 0 │ │ │ │ │ -0000a600: 7841 3030 3030 202d 2031 2020 2020 2020 xA0000 - 1 │ │ │ │ │ -0000a610: 2020 4578 7465 6e64 6564 2042 494f 5320 Extended BIOS │ │ │ │ │ -0000a620: 4461 7461 2041 7265 610a 3078 4130 3030 Data Area.0xA000 │ │ │ │ │ -0000a630: 3020 2020 2020 3078 4330 3030 3020 2d20 0 0xC0000 - │ │ │ │ │ -0000a640: 3120 2020 2020 2020 2056 6964 656f 2052 1 Video R │ │ │ │ │ -0000a650: 414d 0a30 7843 3030 3030 2020 2020 2030 AM.0xC0000 0 │ │ │ │ │ -0000a660: 7831 3030 3030 3020 2d20 3120 2020 2020 x100000 - 1 │ │ │ │ │ -0000a670: 2020 4249 4f53 0a30 7831 3030 3030 3020 BIOS.0x100000 │ │ │ │ │ -0000a680: 2020 203f 2020 2020 2020 2020 2020 2020 ? │ │ │ │ │ -0000a690: 2020 2020 2020 4865 6170 2061 6e64 206d Heap and m │ │ │ │ │ -0000a6a0: 6f64 756c 6520 636f 6465 0a0a 1f0a 4669 odule code....Fi │ │ │ │ │ -0000a6b0: 6c65 3a20 6772 7562 2d64 6576 2e69 6e66 le: grub-dev.inf │ │ │ │ │ -0000a6c0: 6f2c 2020 4e6f 6465 3a20 5669 6465 6f20 o, Node: Video │ │ │ │ │ -0000a6d0: 5375 6273 7973 7465 6d2c 2020 4e65 7874 Subsystem, Next │ │ │ │ │ -0000a6e0: 3a20 5046 4632 2046 6f6e 7420 4669 6c65 : PFF2 Font File │ │ │ │ │ -0000a6f0: 2046 6f72 6d61 742c 2020 5072 6576 3a20 Format, Prev: │ │ │ │ │ -0000a700: 4249 4f53 2070 6f72 7420 6d65 6d6f 7279 BIOS port memory │ │ │ │ │ -0000a710: 206d 6170 2c20 2055 703a 2054 6f70 0a0a map, Up: Top.. │ │ │ │ │ -0000a720: 3130 2056 6964 656f 2053 7562 7379 7374 10 Video Subsyst │ │ │ │ │ -0000a730: 656d 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a em.************* │ │ │ │ │ -0000a740: 2a2a 2a2a 2a0a 0a54 6869 7320 646f 6375 *****..This docu │ │ │ │ │ -0000a750: 6d65 6e74 2063 6f6e 7461 696e 7320 7370 ment contains sp │ │ │ │ │ -0000a760: 6563 6966 6963 6174 696f 6e20 666f 7220 ecification for │ │ │ │ │ -0000a770: 5669 6465 6f20 5375 6273 7973 7465 6d20 Video Subsystem │ │ │ │ │ -0000a780: 666f 7220 4752 5542 322e 0a43 7572 7265 for GRUB2..Curre │ │ │ │ │ -0000a790: 6e74 6c79 206f 6e6c 7920 7468 6520 7573 ntly only the us │ │ │ │ │ -0000a7a0: 6167 6520 696e 7465 7266 6163 6520 6973 age interface is │ │ │ │ │ -0000a7b0: 2064 6573 6372 6962 6564 2069 6e20 7468 described in th │ │ │ │ │ -0000a7c0: 6973 2064 6f63 756d 656e 742e 0a49 6e74 is document..Int │ │ │ │ │ -0000a7d0: 6572 6e61 6c20 7374 7275 6374 7572 6520 ernal structure │ │ │ │ │ -0000a7e0: 6f66 2068 6f77 2076 6964 656f 2064 7269 of how video dri │ │ │ │ │ -0000a7f0: 7665 7273 2061 7265 2072 6567 6973 7465 vers are registe │ │ │ │ │ -0000a800: 7269 6e67 2061 6e64 2068 6f77 2076 6964 ring and how vid │ │ │ │ │ -0000a810: 656f 0a64 7269 7665 7220 6d61 6e61 6765 eo.driver manage │ │ │ │ │ -0000a820: 7220 776f 726b 7320 6172 6520 6e6f 7420 r works are not │ │ │ │ │ -0000a830: 696e 636c 7564 6564 2068 6572 652e 0a0a included here... │ │ │ │ │ -0000a840: 2a20 4d65 6e75 3a0a 0a2a 2056 6964 656f * Menu:..* Video │ │ │ │ │ -0000a850: 2041 5049 3a3a 0a2a 2045 7861 6d70 6c65 API::.* Example │ │ │ │ │ -0000a860: 2075 7361 6765 206f 6620 5669 6465 6f20 usage of Video │ │ │ │ │ -0000a870: 4150 493a 3a0a 2a20 4269 746d 6170 2041 API::.* Bitmap A │ │ │ │ │ -0000a880: 5049 3a3a 0a0a 1f0a 4669 6c65 3a20 6772 PI::....File: gr │ │ │ │ │ -0000a890: 7562 2d64 6576 2e69 6e66 6f2c 2020 4e6f ub-dev.info, No │ │ │ │ │ -0000a8a0: 6465 3a20 5669 6465 6f20 4150 492c 2020 de: Video API, │ │ │ │ │ -0000a8b0: 4e65 7874 3a20 4578 616d 706c 6520 7573 Next: Example us │ │ │ │ │ -0000a8c0: 6167 6520 6f66 2056 6964 656f 2041 5049 age of Video API │ │ │ │ │ -0000a8d0: 2c20 2055 703a 2056 6964 656f 2053 7562 , Up: Video Sub │ │ │ │ │ -0000a8e0: 7379 7374 656d 0a0a 3130 2e31 2056 6964 system..10.1 Vid │ │ │ │ │ -0000a8f0: 656f 2041 5049 0a3d 3d3d 3d3d 3d3d 3d3d eo API.========= │ │ │ │ │ -0000a900: 3d3d 3d3d 3d0a 0a31 302e 312e 3120 6772 =====..10.1.1 gr │ │ │ │ │ -0000a910: 7562 5f76 6964 656f 5f73 6574 7570 0a2d ub_video_setup.- │ │ │ │ │ +0000a500: 2062 6f6f 7420 6c6f 6164 6572 0a3f 2020 boot loader.? │ │ │ │ │ +0000a510: 2020 2020 2020 2020 2030 7832 3030 3020 0x2000 │ │ │ │ │ +0000a520: 2d20 3120 2020 2020 2020 2020 5265 616c - 1 Real │ │ │ │ │ +0000a530: 206d 6f64 6520 7374 6163 6b0a 3078 3743 mode stack.0x7C │ │ │ │ │ +0000a540: 3030 2020 2020 2020 3078 3744 3030 202d 00 0x7D00 - │ │ │ │ │ +0000a550: 2031 2020 2020 2020 2020 2042 6f6f 7420 1 Boot │ │ │ │ │ +0000a560: 7365 6374 6f72 0a30 7838 3030 3020 2020 sector.0x8000 │ │ │ │ │ +0000a570: 2020 203f 2020 2020 2020 2020 2020 2020 ? │ │ │ │ │ +0000a580: 2020 2020 2020 4752 5542 206b 6572 6e65 GRUB kerne │ │ │ │ │ +0000a590: 6c0a 3078 3638 3030 3020 2020 2020 3078 l.0x68000 0x │ │ │ │ │ +0000a5a0: 3731 3030 3020 2d20 3120 2020 2020 2020 71000 - 1 │ │ │ │ │ +0000a5b0: 2044 6973 6b20 6275 6666 6572 0a3f 2020 Disk buffer.? │ │ │ │ │ +0000a5c0: 2020 2020 2020 2020 2030 7838 3030 3030 0x80000 │ │ │ │ │ +0000a5d0: 202d 2031 2020 2020 2020 2020 5072 6f74 - 1 Prot │ │ │ │ │ +0000a5e0: 6563 7465 6420 6d6f 6465 2073 7461 636b ected mode stack │ │ │ │ │ +0000a5f0: 0a3f 2020 2020 2020 2020 2020 2030 7841 .? 0xA │ │ │ │ │ +0000a600: 3030 3030 202d 2031 2020 2020 2020 2020 0000 - 1 │ │ │ │ │ +0000a610: 4578 7465 6e64 6564 2042 494f 5320 4461 Extended BIOS Da │ │ │ │ │ +0000a620: 7461 2041 7265 610a 3078 4130 3030 3020 ta Area.0xA0000 │ │ │ │ │ +0000a630: 2020 2020 3078 4330 3030 3020 2d20 3120 0xC0000 - 1 │ │ │ │ │ +0000a640: 2020 2020 2020 2056 6964 656f 2052 414d Video RAM │ │ │ │ │ +0000a650: 0a30 7843 3030 3030 2020 2020 2030 7831 .0xC0000 0x1 │ │ │ │ │ +0000a660: 3030 3030 3020 2d20 3120 2020 2020 2020 00000 - 1 │ │ │ │ │ +0000a670: 4249 4f53 0a30 7831 3030 3030 3020 2020 BIOS.0x100000 │ │ │ │ │ +0000a680: 203f 2020 2020 2020 2020 2020 2020 2020 ? │ │ │ │ │ +0000a690: 2020 2020 4865 6170 2061 6e64 206d 6f64 Heap and mod │ │ │ │ │ +0000a6a0: 756c 6520 636f 6465 0a0a 1f0a 4669 6c65 ule code....File │ │ │ │ │ +0000a6b0: 3a20 6772 7562 2d64 6576 2e69 6e66 6f2c : grub-dev.info, │ │ │ │ │ +0000a6c0: 2020 4e6f 6465 3a20 5669 6465 6f20 5375 Node: Video Su │ │ │ │ │ +0000a6d0: 6273 7973 7465 6d2c 2020 4e65 7874 3a20 bsystem, Next: │ │ │ │ │ +0000a6e0: 5046 4632 2046 6f6e 7420 4669 6c65 2046 PFF2 Font File F │ │ │ │ │ +0000a6f0: 6f72 6d61 742c 2020 5072 6576 3a20 4249 ormat, Prev: BI │ │ │ │ │ +0000a700: 4f53 2070 6f72 7420 6d65 6d6f 7279 206d OS port memory m │ │ │ │ │ +0000a710: 6170 2c20 2055 703a 2054 6f70 0a0a 3130 ap, Up: Top..10 │ │ │ │ │ +0000a720: 2056 6964 656f 2053 7562 7379 7374 656d Video Subsystem │ │ │ │ │ +0000a730: 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a .*************** │ │ │ │ │ +0000a740: 2a2a 2a0a 0a54 6869 7320 646f 6375 6d65 ***..This docume │ │ │ │ │ +0000a750: 6e74 2063 6f6e 7461 696e 7320 7370 6563 nt contains spec │ │ │ │ │ +0000a760: 6966 6963 6174 696f 6e20 666f 7220 5669 ification for Vi │ │ │ │ │ +0000a770: 6465 6f20 5375 6273 7973 7465 6d20 666f deo Subsystem fo │ │ │ │ │ +0000a780: 7220 4752 5542 322e 0a43 7572 7265 6e74 r GRUB2..Current │ │ │ │ │ +0000a790: 6c79 206f 6e6c 7920 7468 6520 7573 6167 ly only the usag │ │ │ │ │ +0000a7a0: 6520 696e 7465 7266 6163 6520 6973 2064 e interface is d │ │ │ │ │ +0000a7b0: 6573 6372 6962 6564 2069 6e20 7468 6973 escribed in this │ │ │ │ │ +0000a7c0: 2064 6f63 756d 656e 742e 0a49 6e74 6572 document..Inter │ │ │ │ │ +0000a7d0: 6e61 6c20 7374 7275 6374 7572 6520 6f66 nal structure of │ │ │ │ │ +0000a7e0: 2068 6f77 2076 6964 656f 2064 7269 7665 how video drive │ │ │ │ │ +0000a7f0: 7273 2061 7265 2072 6567 6973 7465 7269 rs are registeri │ │ │ │ │ +0000a800: 6e67 2061 6e64 2068 6f77 2076 6964 656f ng and how video │ │ │ │ │ +0000a810: 0a64 7269 7665 7220 6d61 6e61 6765 7220 .driver manager │ │ │ │ │ +0000a820: 776f 726b 7320 6172 6520 6e6f 7420 696e works are not in │ │ │ │ │ +0000a830: 636c 7564 6564 2068 6572 652e 0a0a 2a20 cluded here...* │ │ │ │ │ +0000a840: 4d65 6e75 3a0a 0a2a 2056 6964 656f 2041 Menu:..* Video A │ │ │ │ │ +0000a850: 5049 3a3a 0a2a 2045 7861 6d70 6c65 2075 PI::.* Example u │ │ │ │ │ +0000a860: 7361 6765 206f 6620 5669 6465 6f20 4150 sage of Video AP │ │ │ │ │ +0000a870: 493a 3a0a 2a20 4269 746d 6170 2041 5049 I::.* Bitmap API │ │ │ │ │ +0000a880: 3a3a 0a0a 1f0a 4669 6c65 3a20 6772 7562 ::....File: grub │ │ │ │ │ +0000a890: 2d64 6576 2e69 6e66 6f2c 2020 4e6f 6465 -dev.info, Node │ │ │ │ │ +0000a8a0: 3a20 5669 6465 6f20 4150 492c 2020 4e65 : Video API, Ne │ │ │ │ │ +0000a8b0: 7874 3a20 4578 616d 706c 6520 7573 6167 xt: Example usag │ │ │ │ │ +0000a8c0: 6520 6f66 2056 6964 656f 2041 5049 2c20 e of Video API, │ │ │ │ │ +0000a8d0: 2055 703a 2056 6964 656f 2053 7562 7379 Up: Video Subsy │ │ │ │ │ +0000a8e0: 7374 656d 0a0a 3130 2e31 2056 6964 656f stem..10.1 Video │ │ │ │ │ +0000a8f0: 2041 5049 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d API.=========== │ │ │ │ │ +0000a900: 3d3d 3d0a 0a31 302e 312e 3120 6772 7562 ===..10.1.1 grub │ │ │ │ │ +0000a910: 5f76 6964 656f 5f73 6574 7570 0a2d 2d2d _video_setup.--- │ │ │ │ │ 0000a920: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000a930: 2d2d 2d2d 2d2d 0a0a 2020 202a 2050 726f ------.. * Pro │ │ │ │ │ -0000a940: 746f 7479 7065 3a0a 2020 2020 2020 2020 totype:. │ │ │ │ │ -0000a950: 2020 6772 7562 5f65 7272 5f74 0a20 2020 grub_err_t. │ │ │ │ │ -0000a960: 2020 2020 2020 2067 7275 625f 7669 6465 grub_vide │ │ │ │ │ -0000a970: 6f5f 7365 7475 7020 2875 6e73 6967 6e65 o_setup (unsigne │ │ │ │ │ -0000a980: 6420 696e 7420 7769 6474 682c 2075 6e73 d int width, uns │ │ │ │ │ -0000a990: 6967 6e65 6420 696e 7420 6865 6967 6874 igned int height │ │ │ │ │ -0000a9a0: 2c20 756e 7369 676e 6564 2069 6e74 206d , unsigned int m │ │ │ │ │ -0000a9b0: 6f64 655f 7479 7065 293b 0a20 2020 2a20 ode_type);. * │ │ │ │ │ -0000a9c0: 4465 7363 7269 7074 696f 6e3a 0a0a 2020 Description:.. │ │ │ │ │ -0000a9d0: 2020 2044 7269 7665 7220 7769 6c6c 2075 Driver will u │ │ │ │ │ -0000a9e0: 7365 2069 6e66 6f72 6d61 7469 6f6e 2070 se information p │ │ │ │ │ -0000a9f0: 726f 7669 6465 6420 746f 2069 7420 746f rovided to it to │ │ │ │ │ -0000aa00: 2073 656c 6563 7420 6265 7374 2070 6f73 select best pos │ │ │ │ │ -0000aa10: 7369 626c 650a 2020 2020 2076 6964 656f sible. video │ │ │ │ │ -0000aa20: 206d 6f64 6520 616e 6420 7377 6974 6368 mode and switch │ │ │ │ │ -0000aa30: 2074 6f20 6974 2e20 2053 7570 706f 7274 to it. Support │ │ │ │ │ -0000aa40: 6564 2076 616c 7565 7320 666f 7220 276d ed values for 'm │ │ │ │ │ -0000aa50: 6f64 655f 7479 7065 2720 6172 650a 2020 ode_type' are. │ │ │ │ │ -0000aa60: 2020 2027 4752 5542 5f56 4944 454f 5f4d 'GRUB_VIDEO_M │ │ │ │ │ -0000aa70: 4f44 455f 5459 5045 5f49 4e44 4558 5f43 ODE_TYPE_INDEX_C │ │ │ │ │ -0000aa80: 4f4c 4f52 2720 666f 7220 696e 6465 7820 OLOR' for index │ │ │ │ │ -0000aa90: 636f 6c6f 7220 6d6f 6465 732c 0a20 2020 color modes,. │ │ │ │ │ -0000aaa0: 2020 2747 5255 425f 5649 4445 4f5f 4d4f 'GRUB_VIDEO_MO │ │ │ │ │ -0000aab0: 4445 5f54 5950 455f 5247 4227 2066 6f72 DE_TYPE_RGB' for │ │ │ │ │ -0000aac0: 2064 6972 6563 7420 5247 4220 636f 6c6f direct RGB colo │ │ │ │ │ -0000aad0: 7220 6d6f 6465 7320 616e 640a 2020 2020 r modes and. │ │ │ │ │ -0000aae0: 2027 4752 5542 5f56 4944 454f 5f4d 4f44 'GRUB_VIDEO_MOD │ │ │ │ │ -0000aaf0: 455f 5459 5045 5f44 4f55 424c 455f 4255 E_TYPE_DOUBLE_BU │ │ │ │ │ -0000ab00: 4646 4552 4544 2720 666f 7220 646f 7562 FFERED' for doub │ │ │ │ │ -0000ab10: 6c65 2062 7566 6665 7269 6e67 2e20 2057 le buffering. W │ │ │ │ │ -0000ab20: 6865 6e0a 2020 2020 2072 6571 7565 7374 hen. request │ │ │ │ │ -0000ab30: 696e 6720 5247 4220 6d6f 6465 2c20 6869 ing RGB mode, hi │ │ │ │ │ -0000ab40: 6768 6573 7420 6269 7473 2070 6572 2070 ghest bits per p │ │ │ │ │ -0000ab50: 6978 656c 206d 6f64 6520 7769 6c6c 2062 ixel mode will b │ │ │ │ │ -0000ab60: 6520 7365 6c65 6374 6564 2e0a 2020 2020 e selected.. │ │ │ │ │ -0000ab70: 2057 6865 6e20 7265 7175 6573 7469 6e67 When requesting │ │ │ │ │ -0000ab80: 2049 6e64 6578 2063 6f6c 6f72 206d 6f64 Index color mod │ │ │ │ │ -0000ab90: 652c 206d 6f64 6520 7769 7468 2068 6967 e, mode with hig │ │ │ │ │ -0000aba0: 6865 7374 206e 756d 6265 7220 6f66 0a20 hest number of. │ │ │ │ │ -0000abb0: 2020 2020 636f 6c6f 7273 2077 696c 6c20 colors will │ │ │ │ │ -0000abc0: 6265 2073 656c 6563 7465 642e 2020 4966 be selected. If │ │ │ │ │ -0000abd0: 2061 6c6c 2070 6172 616d 6574 6572 7320 all parameters │ │ │ │ │ -0000abe0: 6172 6520 7370 6563 6966 6965 6420 6173 are specified as │ │ │ │ │ -0000abf0: 207a 6572 6f2c 0a20 2020 2020 7669 6465 zero,. vide │ │ │ │ │ -0000ac00: 6f20 6164 6170 7465 7220 7769 6c6c 2074 o adapter will t │ │ │ │ │ -0000ac10: 7279 2074 6f20 6669 6775 7265 206f 7574 ry to figure out │ │ │ │ │ -0000ac20: 2062 6573 7420 706f 7373 6962 6c65 206d best possible m │ │ │ │ │ -0000ac30: 6f64 6520 616e 640a 2020 2020 2069 6e69 ode and. ini │ │ │ │ │ -0000ac40: 7469 616c 697a 6520 6974 2c20 706c 6174 tialize it, plat │ │ │ │ │ -0000ac50: 666f 726d 2073 7065 6369 6669 6320 6469 form specific di │ │ │ │ │ -0000ac60: 6666 6572 656e 6365 7320 6172 6520 616c fferences are al │ │ │ │ │ -0000ac70: 6c6f 7765 6420 6865 7265 2e20 2049 660a lowed here. If. │ │ │ │ │ -0000ac80: 2020 2020 2074 6865 7265 2069 7320 6e6f there is no │ │ │ │ │ -0000ac90: 206d 6f64 6520 6d61 7463 6869 6e67 2072 mode matching r │ │ │ │ │ -0000aca0: 6571 7565 7374 2c20 6572 726f 7220 5820 equest, error X │ │ │ │ │ -0000acb0: 7769 6c6c 2062 6520 7265 7475 726e 6564 will be returned │ │ │ │ │ -0000acc0: 2e20 2049 660a 2020 2020 2074 6865 7265 . If. there │ │ │ │ │ -0000acd0: 2061 7265 206e 6f20 7072 6f62 6c65 6d73 are no problems │ │ │ │ │ -0000ace0: 2c20 6675 6e63 7469 6f6e 2072 6574 7572 , function retur │ │ │ │ │ -0000acf0: 6e73 2027 4752 5542 5f45 5252 5f4e 4f4e ns 'GRUB_ERR_NON │ │ │ │ │ -0000ad00: 4527 2e0a 0a20 2020 2020 5468 6973 2066 E'... This f │ │ │ │ │ -0000ad10: 756e 6374 696f 6e20 616c 736f 2070 6572 unction also per │ │ │ │ │ -0000ad20: 666f 726d 7320 666f 6c6c 6f77 696e 6720 forms following │ │ │ │ │ -0000ad30: 7461 736b 2075 706f 6e20 7375 6363 6573 task upon succes │ │ │ │ │ -0000ad40: 6675 6c20 6d6f 6465 0a20 2020 2020 7377 ful mode. sw │ │ │ │ │ -0000ad50: 6974 6368 2e20 2041 6374 6976 6520 7265 itch. Active re │ │ │ │ │ -0000ad60: 6e64 6572 696e 6720 7461 7267 6574 2069 ndering target i │ │ │ │ │ -0000ad70: 7320 6368 616e 6765 6420 746f 2073 6372 s changed to scr │ │ │ │ │ -0000ad80: 6565 6e20 616e 6420 7669 6577 706f 7274 een and viewport │ │ │ │ │ -0000ad90: 0a20 2020 2020 6973 206d 6178 696d 697a . is maximiz │ │ │ │ │ -0000ada0: 6564 2074 6f20 616c 6c6f 7720 7768 6f6c ed to allow whol │ │ │ │ │ -0000adb0: 6520 7363 7265 656e 2074 6f20 6265 2075 e screen to be u │ │ │ │ │ -0000adc0: 7365 6420 7768 656e 2070 6572 666f 726d sed when perform │ │ │ │ │ -0000add0: 696e 670a 2020 2020 2067 7261 7068 6963 ing. graphic │ │ │ │ │ -0000ade0: 7320 6f70 6572 6174 696f 6e73 2e20 2049 s operations. I │ │ │ │ │ -0000adf0: 6e20 5247 4220 6d6f 6465 732c 2065 6d75 n RGB modes, emu │ │ │ │ │ -0000ae00: 6c61 7465 6420 7061 6c65 7474 6520 6765 lated palette ge │ │ │ │ │ -0000ae10: 7473 2031 360a 2020 2020 2065 6e74 7269 ts 16. entri │ │ │ │ │ -0000ae20: 6573 2063 6f6e 7461 696e 696e 6720 6465 es containing de │ │ │ │ │ -0000ae30: 6661 756c 7420 7661 6c75 6573 2066 6f72 fault values for │ │ │ │ │ -0000ae40: 2056 4741 2070 616c 6574 7465 2c20 6f74 VGA palette, ot │ │ │ │ │ -0000ae50: 6865 7220 636f 6c6f 7273 2061 7265 0a20 her colors are. │ │ │ │ │ -0000ae60: 2020 2020 6465 6669 6e65 6420 6173 2062 defined as b │ │ │ │ │ -0000ae70: 6c61 636b 2e20 2057 6865 6e20 7377 6974 lack. When swit │ │ │ │ │ -0000ae80: 6368 696e 6720 746f 2049 6e64 6578 6564 ching to Indexed │ │ │ │ │ -0000ae90: 2043 6f6c 6f72 206d 6f64 652c 2064 7269 Color mode, dri │ │ │ │ │ -0000aea0: 7665 7220 6d61 790a 2020 2020 2073 6574 ver may. set │ │ │ │ │ -0000aeb0: 2064 6566 6175 6c74 2056 4741 2070 616c default VGA pal │ │ │ │ │ -0000aec0: 6574 7465 2074 6f20 7363 7265 656e 2069 ette to screen i │ │ │ │ │ -0000aed0: 6620 7468 6520 7669 6465 6f20 6361 7264 f the video card │ │ │ │ │ -0000aee0: 2061 6c6c 6f77 7320 7468 650a 2020 2020 allows the. │ │ │ │ │ -0000aef0: 206f 7065 7261 7469 6f6e 2e0a 0a31 302e operation...10. │ │ │ │ │ -0000af00: 312e 3220 6772 7562 5f76 6964 656f 5f72 1.2 grub_video_r │ │ │ │ │ -0000af10: 6573 746f 7265 0a2d 2d2d 2d2d 2d2d 2d2d estore.--------- │ │ │ │ │ -0000af20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000af30: 0a0a 2020 202a 2050 726f 746f 7479 7065 .. * Prototype │ │ │ │ │ -0000af40: 3a0a 0a20 2020 2020 2020 2020 2067 7275 :.. gru │ │ │ │ │ -0000af50: 625f 6572 725f 740a 2020 2020 2020 2020 b_err_t. │ │ │ │ │ -0000af60: 2020 6772 7562 5f76 6964 656f 5f72 6573 grub_video_res │ │ │ │ │ -0000af70: 746f 7265 2028 766f 6964 293b 0a20 2020 tore (void);. │ │ │ │ │ -0000af80: 2a20 4465 7363 7269 7074 696f 6e3a 0a0a * Description:.. │ │ │ │ │ -0000af90: 2020 2020 2056 6964 656f 2073 7562 7379 Video subsy │ │ │ │ │ -0000afa0: 7374 656d 2077 696c 6c20 6465 696e 6974 stem will deinit │ │ │ │ │ -0000afb0: 6961 6c69 7a65 2061 6374 6976 6174 6564 ialize activated │ │ │ │ │ -0000afc0: 2076 6964 656f 2064 7269 7665 7220 746f video driver to │ │ │ │ │ -0000afd0: 2072 6573 746f 7265 0a20 2020 2020 6f6c restore. ol │ │ │ │ │ -0000afe0: 6420 7374 6174 6520 6f66 2076 6964 656f d state of video │ │ │ │ │ -0000aff0: 2064 6576 6963 652e 2020 5468 6973 2063 device. This c │ │ │ │ │ -0000b000: 616e 2062 6520 7573 6564 2074 6f20 7377 an be used to sw │ │ │ │ │ -0000b010: 6974 6368 2062 6163 6b20 746f 2074 6578 itch back to tex │ │ │ │ │ -0000b020: 740a 2020 2020 206d 6f64 652e 0a0a 3130 t. mode...10 │ │ │ │ │ -0000b030: 2e31 2e33 2067 7275 625f 7669 6465 6f5f .1.3 grub_video_ │ │ │ │ │ -0000b040: 6765 745f 696e 666f 0a2d 2d2d 2d2d 2d2d get_info.------- │ │ │ │ │ +0000a930: 2d2d 2d2d 0a0a 2020 202a 2050 726f 746f ----.. * Proto │ │ │ │ │ +0000a940: 7479 7065 3a0a 2020 2020 2020 2020 2020 type:. │ │ │ │ │ +0000a950: 6772 7562 5f65 7272 5f74 0a20 2020 2020 grub_err_t. │ │ │ │ │ +0000a960: 2020 2020 2067 7275 625f 7669 6465 6f5f grub_video_ │ │ │ │ │ +0000a970: 7365 7475 7020 2875 6e73 6967 6e65 6420 setup (unsigned │ │ │ │ │ +0000a980: 696e 7420 7769 6474 682c 2075 6e73 6967 int width, unsig │ │ │ │ │ +0000a990: 6e65 6420 696e 7420 6865 6967 6874 2c20 ned int height, │ │ │ │ │ +0000a9a0: 756e 7369 676e 6564 2069 6e74 206d 6f64 unsigned int mod │ │ │ │ │ +0000a9b0: 655f 7479 7065 293b 0a20 2020 2a20 4465 e_type);. * De │ │ │ │ │ +0000a9c0: 7363 7269 7074 696f 6e3a 0a0a 2020 2020 scription:.. │ │ │ │ │ +0000a9d0: 2044 7269 7665 7220 7769 6c6c 2075 7365 Driver will use │ │ │ │ │ +0000a9e0: 2069 6e66 6f72 6d61 7469 6f6e 2070 726f information pro │ │ │ │ │ +0000a9f0: 7669 6465 6420 746f 2069 7420 746f 2073 vided to it to s │ │ │ │ │ +0000aa00: 656c 6563 7420 6265 7374 2070 6f73 7369 elect best possi │ │ │ │ │ +0000aa10: 626c 650a 2020 2020 2076 6964 656f 206d ble. video m │ │ │ │ │ +0000aa20: 6f64 6520 616e 6420 7377 6974 6368 2074 ode and switch t │ │ │ │ │ +0000aa30: 6f20 6974 2e20 2053 7570 706f 7274 6564 o it. Supported │ │ │ │ │ +0000aa40: 2076 616c 7565 7320 666f 7220 276d 6f64 values for 'mod │ │ │ │ │ +0000aa50: 655f 7479 7065 2720 6172 650a 2020 2020 e_type' are. │ │ │ │ │ +0000aa60: 2027 4752 5542 5f56 4944 454f 5f4d 4f44 'GRUB_VIDEO_MOD │ │ │ │ │ +0000aa70: 455f 5459 5045 5f49 4e44 4558 5f43 4f4c E_TYPE_INDEX_COL │ │ │ │ │ +0000aa80: 4f52 2720 666f 7220 696e 6465 7820 636f OR' for index co │ │ │ │ │ +0000aa90: 6c6f 7220 6d6f 6465 732c 0a20 2020 2020 lor modes,. │ │ │ │ │ +0000aaa0: 2747 5255 425f 5649 4445 4f5f 4d4f 4445 'GRUB_VIDEO_MODE │ │ │ │ │ +0000aab0: 5f54 5950 455f 5247 4227 2066 6f72 2064 _TYPE_RGB' for d │ │ │ │ │ +0000aac0: 6972 6563 7420 5247 4220 636f 6c6f 7220 irect RGB color │ │ │ │ │ +0000aad0: 6d6f 6465 7320 616e 640a 2020 2020 2027 modes and. ' │ │ │ │ │ +0000aae0: 4752 5542 5f56 4944 454f 5f4d 4f44 455f GRUB_VIDEO_MODE_ │ │ │ │ │ +0000aaf0: 5459 5045 5f44 4f55 424c 455f 4255 4646 TYPE_DOUBLE_BUFF │ │ │ │ │ +0000ab00: 4552 4544 2720 666f 7220 646f 7562 6c65 ERED' for double │ │ │ │ │ +0000ab10: 2062 7566 6665 7269 6e67 2e20 2057 6865 buffering. Whe │ │ │ │ │ +0000ab20: 6e0a 2020 2020 2072 6571 7565 7374 696e n. requestin │ │ │ │ │ +0000ab30: 6720 5247 4220 6d6f 6465 2c20 6869 6768 g RGB mode, high │ │ │ │ │ +0000ab40: 6573 7420 6269 7473 2070 6572 2070 6978 est bits per pix │ │ │ │ │ +0000ab50: 656c 206d 6f64 6520 7769 6c6c 2062 6520 el mode will be │ │ │ │ │ +0000ab60: 7365 6c65 6374 6564 2e0a 2020 2020 2057 selected.. W │ │ │ │ │ +0000ab70: 6865 6e20 7265 7175 6573 7469 6e67 2049 hen requesting I │ │ │ │ │ +0000ab80: 6e64 6578 2063 6f6c 6f72 206d 6f64 652c ndex color mode, │ │ │ │ │ +0000ab90: 206d 6f64 6520 7769 7468 2068 6967 6865 mode with highe │ │ │ │ │ +0000aba0: 7374 206e 756d 6265 7220 6f66 0a20 2020 st number of. │ │ │ │ │ +0000abb0: 2020 636f 6c6f 7273 2077 696c 6c20 6265 colors will be │ │ │ │ │ +0000abc0: 2073 656c 6563 7465 642e 2020 4966 2061 selected. If a │ │ │ │ │ +0000abd0: 6c6c 2070 6172 616d 6574 6572 7320 6172 ll parameters ar │ │ │ │ │ +0000abe0: 6520 7370 6563 6966 6965 6420 6173 207a e specified as z │ │ │ │ │ +0000abf0: 6572 6f2c 0a20 2020 2020 7669 6465 6f20 ero,. video │ │ │ │ │ +0000ac00: 6164 6170 7465 7220 7769 6c6c 2074 7279 adapter will try │ │ │ │ │ +0000ac10: 2074 6f20 6669 6775 7265 206f 7574 2062 to figure out b │ │ │ │ │ +0000ac20: 6573 7420 706f 7373 6962 6c65 206d 6f64 est possible mod │ │ │ │ │ +0000ac30: 6520 616e 640a 2020 2020 2069 6e69 7469 e and. initi │ │ │ │ │ +0000ac40: 616c 697a 6520 6974 2c20 706c 6174 666f alize it, platfo │ │ │ │ │ +0000ac50: 726d 2073 7065 6369 6669 6320 6469 6666 rm specific diff │ │ │ │ │ +0000ac60: 6572 656e 6365 7320 6172 6520 616c 6c6f erences are allo │ │ │ │ │ +0000ac70: 7765 6420 6865 7265 2e20 2049 660a 2020 wed here. If. │ │ │ │ │ +0000ac80: 2020 2074 6865 7265 2069 7320 6e6f 206d there is no m │ │ │ │ │ +0000ac90: 6f64 6520 6d61 7463 6869 6e67 2072 6571 ode matching req │ │ │ │ │ +0000aca0: 7565 7374 2c20 6572 726f 7220 5820 7769 uest, error X wi │ │ │ │ │ +0000acb0: 6c6c 2062 6520 7265 7475 726e 6564 2e20 ll be returned. │ │ │ │ │ +0000acc0: 2049 660a 2020 2020 2074 6865 7265 2061 If. there a │ │ │ │ │ +0000acd0: 7265 206e 6f20 7072 6f62 6c65 6d73 2c20 re no problems, │ │ │ │ │ +0000ace0: 6675 6e63 7469 6f6e 2072 6574 7572 6e73 function returns │ │ │ │ │ +0000acf0: 2027 4752 5542 5f45 5252 5f4e 4f4e 4527 'GRUB_ERR_NONE' │ │ │ │ │ +0000ad00: 2e0a 0a20 2020 2020 5468 6973 2066 756e ... This fun │ │ │ │ │ +0000ad10: 6374 696f 6e20 616c 736f 2070 6572 666f ction also perfo │ │ │ │ │ +0000ad20: 726d 7320 666f 6c6c 6f77 696e 6720 7461 rms following ta │ │ │ │ │ +0000ad30: 736b 2075 706f 6e20 7375 6363 6573 6675 sk upon succesfu │ │ │ │ │ +0000ad40: 6c20 6d6f 6465 0a20 2020 2020 7377 6974 l mode. swit │ │ │ │ │ +0000ad50: 6368 2e20 2041 6374 6976 6520 7265 6e64 ch. Active rend │ │ │ │ │ +0000ad60: 6572 696e 6720 7461 7267 6574 2069 7320 ering target is │ │ │ │ │ +0000ad70: 6368 616e 6765 6420 746f 2073 6372 6565 changed to scree │ │ │ │ │ +0000ad80: 6e20 616e 6420 7669 6577 706f 7274 0a20 n and viewport. │ │ │ │ │ +0000ad90: 2020 2020 6973 206d 6178 696d 697a 6564 is maximized │ │ │ │ │ +0000ada0: 2074 6f20 616c 6c6f 7720 7768 6f6c 6520 to allow whole │ │ │ │ │ +0000adb0: 7363 7265 656e 2074 6f20 6265 2075 7365 screen to be use │ │ │ │ │ +0000adc0: 6420 7768 656e 2070 6572 666f 726d 696e d when performin │ │ │ │ │ +0000add0: 670a 2020 2020 2067 7261 7068 6963 7320 g. graphics │ │ │ │ │ +0000ade0: 6f70 6572 6174 696f 6e73 2e20 2049 6e20 operations. In │ │ │ │ │ +0000adf0: 5247 4220 6d6f 6465 732c 2065 6d75 6c61 RGB modes, emula │ │ │ │ │ +0000ae00: 7465 6420 7061 6c65 7474 6520 6765 7473 ted palette gets │ │ │ │ │ +0000ae10: 2031 360a 2020 2020 2065 6e74 7269 6573 16. entries │ │ │ │ │ +0000ae20: 2063 6f6e 7461 696e 696e 6720 6465 6661 containing defa │ │ │ │ │ +0000ae30: 756c 7420 7661 6c75 6573 2066 6f72 2056 ult values for V │ │ │ │ │ +0000ae40: 4741 2070 616c 6574 7465 2c20 6f74 6865 GA palette, othe │ │ │ │ │ +0000ae50: 7220 636f 6c6f 7273 2061 7265 0a20 2020 r colors are. │ │ │ │ │ +0000ae60: 2020 6465 6669 6e65 6420 6173 2062 6c61 defined as bla │ │ │ │ │ +0000ae70: 636b 2e20 2057 6865 6e20 7377 6974 6368 ck. When switch │ │ │ │ │ +0000ae80: 696e 6720 746f 2049 6e64 6578 6564 2043 ing to Indexed C │ │ │ │ │ +0000ae90: 6f6c 6f72 206d 6f64 652c 2064 7269 7665 olor mode, drive │ │ │ │ │ +0000aea0: 7220 6d61 790a 2020 2020 2073 6574 2064 r may. set d │ │ │ │ │ +0000aeb0: 6566 6175 6c74 2056 4741 2070 616c 6574 efault VGA palet │ │ │ │ │ +0000aec0: 7465 2074 6f20 7363 7265 656e 2069 6620 te to screen if │ │ │ │ │ +0000aed0: 7468 6520 7669 6465 6f20 6361 7264 2061 the video card a │ │ │ │ │ +0000aee0: 6c6c 6f77 7320 7468 650a 2020 2020 206f llows the. o │ │ │ │ │ +0000aef0: 7065 7261 7469 6f6e 2e0a 0a31 302e 312e peration...10.1. │ │ │ │ │ +0000af00: 3220 6772 7562 5f76 6964 656f 5f72 6573 2 grub_video_res │ │ │ │ │ +0000af10: 746f 7265 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d tore.----------- │ │ │ │ │ +0000af20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ +0000af30: 2020 202a 2050 726f 746f 7479 7065 3a0a * Prototype:. │ │ │ │ │ +0000af40: 0a20 2020 2020 2020 2020 2067 7275 625f . grub_ │ │ │ │ │ +0000af50: 6572 725f 740a 2020 2020 2020 2020 2020 err_t. │ │ │ │ │ +0000af60: 6772 7562 5f76 6964 656f 5f72 6573 746f grub_video_resto │ │ │ │ │ +0000af70: 7265 2028 766f 6964 293b 0a20 2020 2a20 re (void);. * │ │ │ │ │ +0000af80: 4465 7363 7269 7074 696f 6e3a 0a0a 2020 Description:.. │ │ │ │ │ +0000af90: 2020 2056 6964 656f 2073 7562 7379 7374 Video subsyst │ │ │ │ │ +0000afa0: 656d 2077 696c 6c20 6465 696e 6974 6961 em will deinitia │ │ │ │ │ +0000afb0: 6c69 7a65 2061 6374 6976 6174 6564 2076 lize activated v │ │ │ │ │ +0000afc0: 6964 656f 2064 7269 7665 7220 746f 2072 ideo driver to r │ │ │ │ │ +0000afd0: 6573 746f 7265 0a20 2020 2020 6f6c 6420 estore. old │ │ │ │ │ +0000afe0: 7374 6174 6520 6f66 2076 6964 656f 2064 state of video d │ │ │ │ │ +0000aff0: 6576 6963 652e 2020 5468 6973 2063 616e evice. This can │ │ │ │ │ +0000b000: 2062 6520 7573 6564 2074 6f20 7377 6974 be used to swit │ │ │ │ │ +0000b010: 6368 2062 6163 6b20 746f 2074 6578 740a ch back to text. │ │ │ │ │ +0000b020: 2020 2020 206d 6f64 652e 0a0a 3130 2e31 mode...10.1 │ │ │ │ │ +0000b030: 2e33 2067 7275 625f 7669 6465 6f5f 6765 .3 grub_video_ge │ │ │ │ │ +0000b040: 745f 696e 666f 0a2d 2d2d 2d2d 2d2d 2d2d t_info.--------- │ │ │ │ │ 0000b050: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000b060: 2d2d 2d0a 0a20 2020 2a20 5072 6f74 6f74 ---.. * Protot │ │ │ │ │ -0000b070: 7970 653a 0a0a 2020 2020 2020 2020 2020 ype:.. │ │ │ │ │ -0000b080: 6772 7562 5f65 7272 5f74 0a20 2020 2020 grub_err_t. │ │ │ │ │ -0000b090: 2020 2020 2067 7275 625f 7669 6465 6f5f grub_video_ │ │ │ │ │ -0000b0a0: 6765 745f 696e 666f 2028 7374 7275 6374 get_info (struct │ │ │ │ │ -0000b0b0: 2067 7275 625f 7669 6465 6f5f 6d6f 6465 grub_video_mode │ │ │ │ │ -0000b0c0: 5f69 6e66 6f20 2a6d 6f64 655f 696e 666f _info *mode_info │ │ │ │ │ -0000b0d0: 293b 0a20 2020 2020 2020 2020 2073 7472 );. str │ │ │ │ │ -0000b0e0: 7563 7420 6772 7562 5f76 6964 656f 5f6d uct grub_video_m │ │ │ │ │ -0000b0f0: 6f64 655f 696e 666f 0a20 2020 2020 2020 ode_info. │ │ │ │ │ -0000b100: 2020 207b 0a20 2020 2020 2020 2020 2020 {. │ │ │ │ │ -0000b110: 202f 2a20 5769 6474 6820 6f66 2074 6865 /* Width of the │ │ │ │ │ -0000b120: 2073 6372 6565 6e2e 2020 2a2f 0a20 2020 screen. */. │ │ │ │ │ -0000b130: 2020 2020 2020 2020 2075 6e73 6967 6e65 unsigne │ │ │ │ │ -0000b140: 6420 696e 7420 7769 6474 683b 0a20 2020 d int width;. │ │ │ │ │ -0000b150: 2020 2020 2020 2020 202f 2a20 4865 6967 /* Heig │ │ │ │ │ -0000b160: 6874 206f 6620 7468 6520 7363 7265 656e ht of the screen │ │ │ │ │ -0000b170: 2e20 202a 2f0a 2020 2020 2020 2020 2020 . */. │ │ │ │ │ -0000b180: 2020 756e 7369 676e 6564 2069 6e74 2068 unsigned int h │ │ │ │ │ -0000b190: 6569 6768 743b 0a20 2020 2020 2020 2020 eight;. │ │ │ │ │ -0000b1a0: 2020 202f 2a20 4d6f 6465 2074 7970 6520 /* Mode type │ │ │ │ │ -0000b1b0: 6269 746d 6173 6b2e 2020 436f 6e74 6169 bitmask. Contai │ │ │ │ │ -0000b1c0: 6e73 2069 6e66 6f72 6d61 7469 6f6e 206c ns information l │ │ │ │ │ -0000b1d0: 696b 6520 6973 2069 7420 496e 6465 7820 ike is it Index │ │ │ │ │ -0000b1e0: 636f 6c6f 7220 6f72 0a20 2020 2020 2020 color or. │ │ │ │ │ -0000b1f0: 2020 2020 2020 2020 5247 4220 6d6f 6465 RGB mode │ │ │ │ │ -0000b200: 2e20 202a 2f0a 2020 2020 2020 2020 2020 . */. │ │ │ │ │ -0000b210: 2020 756e 7369 676e 6564 2069 6e74 206d unsigned int m │ │ │ │ │ -0000b220: 6f64 655f 7479 7065 3b0a 2020 2020 2020 ode_type;. │ │ │ │ │ -0000b230: 2020 2020 2020 2f2a 2042 6974 7320 7065 /* Bits pe │ │ │ │ │ -0000b240: 7220 7069 7865 6c2e 2020 2a2f 0a20 2020 r pixel. */. │ │ │ │ │ -0000b250: 2020 2020 2020 2020 2075 6e73 6967 6e65 unsigne │ │ │ │ │ -0000b260: 6420 696e 7420 6270 703b 0a20 2020 2020 d int bpp;. │ │ │ │ │ -0000b270: 2020 2020 2020 202f 2a20 4279 7465 7320 /* Bytes │ │ │ │ │ -0000b280: 7065 7220 7069 7865 6c2e 2020 2a2f 0a20 per pixel. */. │ │ │ │ │ -0000b290: 2020 2020 2020 2020 2020 2075 6e73 6967 unsig │ │ │ │ │ -0000b2a0: 6e65 6420 696e 7420 6279 7465 735f 7065 ned int bytes_pe │ │ │ │ │ -0000b2b0: 725f 7069 7865 6c3b 0a20 2020 2020 2020 r_pixel;. │ │ │ │ │ -0000b2c0: 2020 2020 202f 2a20 5069 7463 6820 6f66 /* Pitch of │ │ │ │ │ -0000b2d0: 206f 6e65 2073 6361 6e6c 696e 652e 2020 one scanline. │ │ │ │ │ -0000b2e0: 486f 7720 6d61 6e79 2062 7974 6573 2074 How many bytes t │ │ │ │ │ -0000b2f0: 6865 7265 2061 7265 2066 6f72 2073 6361 here are for sca │ │ │ │ │ -0000b300: 6e6c 696e 652e 2020 2a2f 0a20 2020 2020 nline. */. │ │ │ │ │ -0000b310: 2020 2020 2020 2075 6e73 6967 6e65 6420 unsigned │ │ │ │ │ -0000b320: 696e 7420 7069 7463 683b 0a20 2020 2020 int pitch;. │ │ │ │ │ -0000b330: 2020 2020 2020 202f 2a20 496e 2069 6e64 /* In ind │ │ │ │ │ -0000b340: 6578 2063 6f6c 6f72 206d 6f64 652c 206e ex color mode, n │ │ │ │ │ -0000b350: 756d 6265 7220 6f66 2063 6f6c 6f72 732e umber of colors. │ │ │ │ │ -0000b360: 2020 496e 2052 4742 206d 6f64 6520 7468 In RGB mode th │ │ │ │ │ -0000b370: 6973 2069 7320 3235 362e 2020 2a2f 0a20 is is 256. */. │ │ │ │ │ -0000b380: 2020 2020 2020 2020 2020 2075 6e73 6967 unsig │ │ │ │ │ -0000b390: 6e65 6420 696e 7420 6e75 6d62 6572 5f6f ned int number_o │ │ │ │ │ -0000b3a0: 665f 636f 6c6f 7273 3b0a 2020 2020 2020 f_colors;. │ │ │ │ │ -0000b3b0: 2020 2020 2020 2f2a 204f 7074 696d 697a /* Optimiz │ │ │ │ │ -0000b3c0: 6174 696f 6e20 6869 6e74 2068 6f77 2062 ation hint how b │ │ │ │ │ -0000b3d0: 696e 6172 7920 6461 7461 2069 7320 636f inary data is co │ │ │ │ │ -0000b3e0: 6465 642e 2020 2a2f 0a20 2020 2020 2020 ded. */. │ │ │ │ │ -0000b3f0: 2020 2020 2065 6e75 6d20 6772 7562 5f76 enum grub_v │ │ │ │ │ -0000b400: 6964 656f 5f62 6c69 745f 666f 726d 6174 ideo_blit_format │ │ │ │ │ -0000b410: 2062 6c69 745f 666f 726d 6174 3b0a 2020 blit_format;. │ │ │ │ │ -0000b420: 2020 2020 2020 2020 2020 2f2a 2048 6f77 /* How │ │ │ │ │ -0000b430: 206d 616e 7920 6269 7473 2061 7265 2072 many bits are r │ │ │ │ │ -0000b440: 6573 6572 7665 6420 666f 7220 7265 6420 eserved for red │ │ │ │ │ -0000b450: 636f 6c6f 722e 2020 2a2f 0a20 2020 2020 color. */. │ │ │ │ │ -0000b460: 2020 2020 2020 2075 6e73 6967 6e65 6420 unsigned │ │ │ │ │ -0000b470: 696e 7420 7265 645f 6d61 736b 5f73 697a int red_mask_siz │ │ │ │ │ -0000b480: 653b 0a20 2020 2020 2020 2020 2020 202f e;. / │ │ │ │ │ -0000b490: 2a20 5768 6174 2069 7320 6c6f 6361 7469 * What is locati │ │ │ │ │ -0000b4a0: 6f6e 206f 6620 7265 6420 636f 6c6f 7220 on of red color │ │ │ │ │ -0000b4b0: 6269 7473 2e20 2049 6e20 496e 6465 7820 bits. In Index │ │ │ │ │ -0000b4c0: 436f 6c6f 7220 6d6f 6465 2c20 7468 6973 Color mode, this │ │ │ │ │ -0000b4d0: 2069 7320 302e 2020 2a2f 0a20 2020 2020 is 0. */. │ │ │ │ │ -0000b4e0: 2020 2020 2020 2075 6e73 6967 6e65 6420 unsigned │ │ │ │ │ -0000b4f0: 696e 7420 7265 645f 6669 656c 645f 706f int red_field_po │ │ │ │ │ -0000b500: 733b 0a20 2020 2020 2020 2020 2020 202f s;. / │ │ │ │ │ -0000b510: 2a20 486f 7720 6d61 6e79 2062 6974 7320 * How many bits │ │ │ │ │ -0000b520: 6172 6520 7265 7365 7276 6564 2066 6f72 are reserved for │ │ │ │ │ -0000b530: 2067 7265 656e 2063 6f6c 6f72 2e20 202a green color. * │ │ │ │ │ -0000b540: 2f0a 2020 2020 2020 2020 2020 2020 756e /. un │ │ │ │ │ -0000b550: 7369 676e 6564 2069 6e74 2067 7265 656e signed int green │ │ │ │ │ -0000b560: 5f6d 6173 6b5f 7369 7a65 3b0a 2020 2020 _mask_size;. │ │ │ │ │ -0000b570: 2020 2020 2020 2020 2f2a 2057 6861 7420 /* What │ │ │ │ │ -0000b580: 6973 206c 6f63 6174 696f 6e20 6f66 2067 is location of g │ │ │ │ │ -0000b590: 7265 656e 2063 6f6c 6f72 2062 6974 732e reen color bits. │ │ │ │ │ -0000b5a0: 2020 496e 2049 6e64 6578 2043 6f6c 6f72 In Index Color │ │ │ │ │ -0000b5b0: 206d 6f64 652c 2074 6869 7320 6973 2030 mode, this is 0 │ │ │ │ │ -0000b5c0: 2e20 202a 2f0a 2020 2020 2020 2020 2020 . */. │ │ │ │ │ -0000b5d0: 2020 756e 7369 676e 6564 2069 6e74 2067 unsigned int g │ │ │ │ │ -0000b5e0: 7265 656e 5f66 6965 6c64 5f70 6f73 3b0a reen_field_pos;. │ │ │ │ │ -0000b5f0: 2020 2020 2020 2020 2020 2020 2f2a 2048 /* H │ │ │ │ │ -0000b600: 6f77 206d 616e 7920 6269 7473 2061 7265 ow many bits are │ │ │ │ │ -0000b610: 2072 6573 6572 7665 6420 666f 7220 626c reserved for bl │ │ │ │ │ -0000b620: 7565 2063 6f6c 6f72 2e20 202a 2f0a 2020 ue color. */. │ │ │ │ │ -0000b630: 2020 2020 2020 2020 2020 756e 7369 676e unsign │ │ │ │ │ -0000b640: 6564 2069 6e74 2062 6c75 655f 6d61 736b ed int blue_mask │ │ │ │ │ -0000b650: 5f73 697a 653b 0a20 2020 2020 2020 2020 _size;. │ │ │ │ │ -0000b660: 2020 202f 2a20 5768 6174 2069 7320 6c6f /* What is lo │ │ │ │ │ -0000b670: 6361 7469 6f6e 206f 6620 626c 7565 2063 cation of blue c │ │ │ │ │ -0000b680: 6f6c 6f72 2062 6974 732e 2020 496e 2049 olor bits. In I │ │ │ │ │ -0000b690: 6e64 6578 2043 6f6c 6f72 206d 6f64 652c ndex Color mode, │ │ │ │ │ -0000b6a0: 2074 6869 7320 6973 2030 2e20 202a 2f0a this is 0. */. │ │ │ │ │ -0000b6b0: 2020 2020 2020 2020 2020 2020 756e 7369 unsi │ │ │ │ │ -0000b6c0: 676e 6564 2069 6e74 2062 6c75 655f 6669 gned int blue_fi │ │ │ │ │ -0000b6d0: 656c 645f 706f 733b 0a20 2020 2020 2020 eld_pos;. │ │ │ │ │ -0000b6e0: 2020 2020 202f 2a20 486f 7720 6d61 6e79 /* How many │ │ │ │ │ -0000b6f0: 2062 6974 7320 6172 6520 7265 7365 7276 bits are reserv │ │ │ │ │ -0000b700: 6564 2069 6e20 636f 6c6f 722e 2020 2a2f ed in color. */ │ │ │ │ │ -0000b710: 0a20 2020 2020 2020 2020 2020 2075 6e73 . uns │ │ │ │ │ -0000b720: 6967 6e65 6420 696e 7420 7265 7365 7276 igned int reserv │ │ │ │ │ -0000b730: 6564 5f6d 6173 6b5f 7369 7a65 3b0a 2020 ed_mask_size;. │ │ │ │ │ -0000b740: 2020 2020 2020 2020 2020 2f2a 2057 6861 /* Wha │ │ │ │ │ -0000b750: 7420 6973 206c 6f63 6174 696f 6e20 6f66 t is location of │ │ │ │ │ -0000b760: 2072 6573 6572 7665 6420 636f 6c6f 7220 reserved color │ │ │ │ │ -0000b770: 6269 7473 2e20 2049 6e20 496e 6465 7820 bits. In Index │ │ │ │ │ -0000b780: 436f 6c6f 7220 6d6f 6465 2c0a 2020 2020 Color mode,. │ │ │ │ │ -0000b790: 2020 2020 2020 2020 2020 2074 6869 7320 this │ │ │ │ │ -0000b7a0: 6973 2030 2e20 202a 2f0a 2020 2020 2020 is 0. */. │ │ │ │ │ -0000b7b0: 2020 2020 2020 756e 7369 676e 6564 2069 unsigned i │ │ │ │ │ -0000b7c0: 6e74 2072 6573 6572 7665 645f 6669 656c nt reserved_fiel │ │ │ │ │ -0000b7d0: 645f 706f 733b 0a20 2020 2020 2020 2020 d_pos;. │ │ │ │ │ -0000b7e0: 207d 3b0a 2020 202a 2044 6573 6372 6970 };. * Descrip │ │ │ │ │ -0000b7f0: 7469 6f6e 3a0a 0a20 2020 2020 536f 6674 tion:.. Soft │ │ │ │ │ -0000b800: 7761 7265 2064 6576 656c 6f70 6572 2063 ware developer c │ │ │ │ │ -0000b810: 616e 2075 7365 2074 6869 7320 6675 6e63 an use this func │ │ │ │ │ -0000b820: 7469 6f6e 2074 6f20 7175 6572 7920 7072 tion to query pr │ │ │ │ │ -0000b830: 6f70 6572 7469 6573 206f 660a 2020 2020 operties of. │ │ │ │ │ -0000b840: 2061 6374 6976 6520 7265 6e64 6572 696e active renderin │ │ │ │ │ -0000b850: 6720 7461 6765 742e 2020 496e 666f 726d g taget. Inform │ │ │ │ │ -0000b860: 6174 696f 6e20 7072 6f76 6964 6564 2068 ation provided h │ │ │ │ │ -0000b870: 6572 6520 6361 6e20 6265 2075 7365 6420 ere can be used │ │ │ │ │ -0000b880: 6279 0a20 2020 2020 6f74 6865 7220 7061 by. other pa │ │ │ │ │ -0000b890: 7274 7320 6f66 2047 5255 422c 206c 696b rts of GRUB, lik │ │ │ │ │ -0000b8a0: 6520 696d 6167 6520 6c6f 6164 6572 7320 e image loaders │ │ │ │ │ -0000b8b0: 746f 2063 6f6e 7665 7274 206c 6f61 6465 to convert loade │ │ │ │ │ -0000b8c0: 6420 696d 6167 6573 2074 6f0a 2020 2020 d images to. │ │ │ │ │ -0000b8d0: 2063 6f72 7265 6374 2073 6372 6565 6e20 correct screen │ │ │ │ │ -0000b8e0: 666f 726d 6174 2074 6f20 616c 6c6f 7720 format to allow │ │ │ │ │ -0000b8f0: 6d6f 7265 206f 7074 696d 697a 6564 2062 more optimized b │ │ │ │ │ -0000b900: 6c69 7474 6572 7320 746f 2062 6520 7573 litters to be us │ │ │ │ │ -0000b910: 6564 2e0a 2020 2020 2049 6620 7468 6572 ed.. If ther │ │ │ │ │ -0000b920: 6520 7468 6572 6520 6973 206e 6f20 636f e there is no co │ │ │ │ │ -0000b930: 6e66 6967 7572 6564 2076 6964 656f 2064 nfigured video d │ │ │ │ │ -0000b940: 7269 7665 7220 7769 7468 2061 6374 6976 river with activ │ │ │ │ │ -0000b950: 6520 7363 7265 656e 2c0a 2020 2020 2065 e screen,. e │ │ │ │ │ -0000b960: 7272 6f72 2027 4752 5542 5f45 5252 5f42 rror 'GRUB_ERR_B │ │ │ │ │ -0000b970: 4144 5f44 4556 4943 4527 2069 7320 7265 AD_DEVICE' is re │ │ │ │ │ -0000b980: 7475 726e 6564 2c20 6f74 6865 7277 6973 turned, otherwis │ │ │ │ │ -0000b990: 6520 276d 6f64 655f 696e 666f 2720 6973 e 'mode_info' is │ │ │ │ │ -0000b9a0: 0a20 2020 2020 6669 6c6c 6564 2077 6974 . filled wit │ │ │ │ │ -0000b9b0: 6820 7661 6c69 6420 696e 666f 726d 6174 h valid informat │ │ │ │ │ -0000b9c0: 696f 6e20 616e 6420 2747 5255 425f 4552 ion and 'GRUB_ER │ │ │ │ │ -0000b9d0: 525f 4e4f 4e45 2720 6973 2072 6574 7572 R_NONE' is retur │ │ │ │ │ -0000b9e0: 6e65 642e 0a0a 3130 2e31 2e34 2067 7275 ned...10.1.4 gru │ │ │ │ │ -0000b9f0: 625f 7669 6465 6f5f 6765 745f 626c 6974 b_video_get_blit │ │ │ │ │ -0000ba00: 5f66 6f72 6d61 740a 2d2d 2d2d 2d2d 2d2d _format.-------- │ │ │ │ │ +0000b060: 2d0a 0a20 2020 2a20 5072 6f74 6f74 7970 -.. * Prototyp │ │ │ │ │ +0000b070: 653a 0a0a 2020 2020 2020 2020 2020 6772 e:.. gr │ │ │ │ │ +0000b080: 7562 5f65 7272 5f74 0a20 2020 2020 2020 ub_err_t. │ │ │ │ │ +0000b090: 2020 2067 7275 625f 7669 6465 6f5f 6765 grub_video_ge │ │ │ │ │ +0000b0a0: 745f 696e 666f 2028 7374 7275 6374 2067 t_info (struct g │ │ │ │ │ +0000b0b0: 7275 625f 7669 6465 6f5f 6d6f 6465 5f69 rub_video_mode_i │ │ │ │ │ +0000b0c0: 6e66 6f20 2a6d 6f64 655f 696e 666f 293b nfo *mode_info); │ │ │ │ │ +0000b0d0: 0a20 2020 2020 2020 2020 2073 7472 7563 . struc │ │ │ │ │ +0000b0e0: 7420 6772 7562 5f76 6964 656f 5f6d 6f64 t grub_video_mod │ │ │ │ │ +0000b0f0: 655f 696e 666f 0a20 2020 2020 2020 2020 e_info. │ │ │ │ │ +0000b100: 207b 0a20 2020 2020 2020 2020 2020 202f {. / │ │ │ │ │ +0000b110: 2a20 5769 6474 6820 6f66 2074 6865 2073 * Width of the s │ │ │ │ │ +0000b120: 6372 6565 6e2e 2020 2a2f 0a20 2020 2020 creen. */. │ │ │ │ │ +0000b130: 2020 2020 2020 2075 6e73 6967 6e65 6420 unsigned │ │ │ │ │ +0000b140: 696e 7420 7769 6474 683b 0a20 2020 2020 int width;. │ │ │ │ │ +0000b150: 2020 2020 2020 202f 2a20 4865 6967 6874 /* Height │ │ │ │ │ +0000b160: 206f 6620 7468 6520 7363 7265 656e 2e20 of the screen. │ │ │ │ │ +0000b170: 202a 2f0a 2020 2020 2020 2020 2020 2020 */. │ │ │ │ │ +0000b180: 756e 7369 676e 6564 2069 6e74 2068 6569 unsigned int hei │ │ │ │ │ +0000b190: 6768 743b 0a20 2020 2020 2020 2020 2020 ght;. │ │ │ │ │ +0000b1a0: 202f 2a20 4d6f 6465 2074 7970 6520 6269 /* Mode type bi │ │ │ │ │ +0000b1b0: 746d 6173 6b2e 2020 436f 6e74 6169 6e73 tmask. Contains │ │ │ │ │ +0000b1c0: 2069 6e66 6f72 6d61 7469 6f6e 206c 696b information lik │ │ │ │ │ +0000b1d0: 6520 6973 2069 7420 496e 6465 7820 636f e is it Index co │ │ │ │ │ +0000b1e0: 6c6f 7220 6f72 0a20 2020 2020 2020 2020 lor or. │ │ │ │ │ +0000b1f0: 2020 2020 2020 5247 4220 6d6f 6465 2e20 RGB mode. │ │ │ │ │ +0000b200: 202a 2f0a 2020 2020 2020 2020 2020 2020 */. │ │ │ │ │ +0000b210: 756e 7369 676e 6564 2069 6e74 206d 6f64 unsigned int mod │ │ │ │ │ +0000b220: 655f 7479 7065 3b0a 2020 2020 2020 2020 e_type;. │ │ │ │ │ +0000b230: 2020 2020 2f2a 2042 6974 7320 7065 7220 /* Bits per │ │ │ │ │ +0000b240: 7069 7865 6c2e 2020 2a2f 0a20 2020 2020 pixel. */. │ │ │ │ │ +0000b250: 2020 2020 2020 2075 6e73 6967 6e65 6420 unsigned │ │ │ │ │ +0000b260: 696e 7420 6270 703b 0a20 2020 2020 2020 int bpp;. │ │ │ │ │ +0000b270: 2020 2020 202f 2a20 4279 7465 7320 7065 /* Bytes pe │ │ │ │ │ +0000b280: 7220 7069 7865 6c2e 2020 2a2f 0a20 2020 r pixel. */. │ │ │ │ │ +0000b290: 2020 2020 2020 2020 2075 6e73 6967 6e65 unsigne │ │ │ │ │ +0000b2a0: 6420 696e 7420 6279 7465 735f 7065 725f d int bytes_per_ │ │ │ │ │ +0000b2b0: 7069 7865 6c3b 0a20 2020 2020 2020 2020 pixel;. │ │ │ │ │ +0000b2c0: 2020 202f 2a20 5069 7463 6820 6f66 206f /* Pitch of o │ │ │ │ │ +0000b2d0: 6e65 2073 6361 6e6c 696e 652e 2020 486f ne scanline. Ho │ │ │ │ │ +0000b2e0: 7720 6d61 6e79 2062 7974 6573 2074 6865 w many bytes the │ │ │ │ │ +0000b2f0: 7265 2061 7265 2066 6f72 2073 6361 6e6c re are for scanl │ │ │ │ │ +0000b300: 696e 652e 2020 2a2f 0a20 2020 2020 2020 ine. */. │ │ │ │ │ +0000b310: 2020 2020 2075 6e73 6967 6e65 6420 696e unsigned in │ │ │ │ │ +0000b320: 7420 7069 7463 683b 0a20 2020 2020 2020 t pitch;. │ │ │ │ │ +0000b330: 2020 2020 202f 2a20 496e 2069 6e64 6578 /* In index │ │ │ │ │ +0000b340: 2063 6f6c 6f72 206d 6f64 652c 206e 756d color mode, num │ │ │ │ │ +0000b350: 6265 7220 6f66 2063 6f6c 6f72 732e 2020 ber of colors. │ │ │ │ │ +0000b360: 496e 2052 4742 206d 6f64 6520 7468 6973 In RGB mode this │ │ │ │ │ +0000b370: 2069 7320 3235 362e 2020 2a2f 0a20 2020 is 256. */. │ │ │ │ │ +0000b380: 2020 2020 2020 2020 2075 6e73 6967 6e65 unsigne │ │ │ │ │ +0000b390: 6420 696e 7420 6e75 6d62 6572 5f6f 665f d int number_of_ │ │ │ │ │ +0000b3a0: 636f 6c6f 7273 3b0a 2020 2020 2020 2020 colors;. │ │ │ │ │ +0000b3b0: 2020 2020 2f2a 204f 7074 696d 697a 6174 /* Optimizat │ │ │ │ │ +0000b3c0: 696f 6e20 6869 6e74 2068 6f77 2062 696e ion hint how bin │ │ │ │ │ +0000b3d0: 6172 7920 6461 7461 2069 7320 636f 6465 ary data is code │ │ │ │ │ +0000b3e0: 642e 2020 2a2f 0a20 2020 2020 2020 2020 d. */. │ │ │ │ │ +0000b3f0: 2020 2065 6e75 6d20 6772 7562 5f76 6964 enum grub_vid │ │ │ │ │ +0000b400: 656f 5f62 6c69 745f 666f 726d 6174 2062 eo_blit_format b │ │ │ │ │ +0000b410: 6c69 745f 666f 726d 6174 3b0a 2020 2020 lit_format;. │ │ │ │ │ +0000b420: 2020 2020 2020 2020 2f2a 2048 6f77 206d /* How m │ │ │ │ │ +0000b430: 616e 7920 6269 7473 2061 7265 2072 6573 any bits are res │ │ │ │ │ +0000b440: 6572 7665 6420 666f 7220 7265 6420 636f erved for red co │ │ │ │ │ +0000b450: 6c6f 722e 2020 2a2f 0a20 2020 2020 2020 lor. */. │ │ │ │ │ +0000b460: 2020 2020 2075 6e73 6967 6e65 6420 696e unsigned in │ │ │ │ │ +0000b470: 7420 7265 645f 6d61 736b 5f73 697a 653b t red_mask_size; │ │ │ │ │ +0000b480: 0a20 2020 2020 2020 2020 2020 202f 2a20 . /* │ │ │ │ │ +0000b490: 5768 6174 2069 7320 6c6f 6361 7469 6f6e What is location │ │ │ │ │ +0000b4a0: 206f 6620 7265 6420 636f 6c6f 7220 6269 of red color bi │ │ │ │ │ +0000b4b0: 7473 2e20 2049 6e20 496e 6465 7820 436f ts. In Index Co │ │ │ │ │ +0000b4c0: 6c6f 7220 6d6f 6465 2c20 7468 6973 2069 lor mode, this i │ │ │ │ │ +0000b4d0: 7320 302e 2020 2a2f 0a20 2020 2020 2020 s 0. */. │ │ │ │ │ +0000b4e0: 2020 2020 2075 6e73 6967 6e65 6420 696e unsigned in │ │ │ │ │ +0000b4f0: 7420 7265 645f 6669 656c 645f 706f 733b t red_field_pos; │ │ │ │ │ +0000b500: 0a20 2020 2020 2020 2020 2020 202f 2a20 . /* │ │ │ │ │ +0000b510: 486f 7720 6d61 6e79 2062 6974 7320 6172 How many bits ar │ │ │ │ │ +0000b520: 6520 7265 7365 7276 6564 2066 6f72 2067 e reserved for g │ │ │ │ │ +0000b530: 7265 656e 2063 6f6c 6f72 2e20 202a 2f0a reen color. */. │ │ │ │ │ +0000b540: 2020 2020 2020 2020 2020 2020 756e 7369 unsi │ │ │ │ │ +0000b550: 676e 6564 2069 6e74 2067 7265 656e 5f6d gned int green_m │ │ │ │ │ +0000b560: 6173 6b5f 7369 7a65 3b0a 2020 2020 2020 ask_size;. │ │ │ │ │ +0000b570: 2020 2020 2020 2f2a 2057 6861 7420 6973 /* What is │ │ │ │ │ +0000b580: 206c 6f63 6174 696f 6e20 6f66 2067 7265 location of gre │ │ │ │ │ +0000b590: 656e 2063 6f6c 6f72 2062 6974 732e 2020 en color bits. │ │ │ │ │ +0000b5a0: 496e 2049 6e64 6578 2043 6f6c 6f72 206d In Index Color m │ │ │ │ │ +0000b5b0: 6f64 652c 2074 6869 7320 6973 2030 2e20 ode, this is 0. │ │ │ │ │ +0000b5c0: 202a 2f0a 2020 2020 2020 2020 2020 2020 */. │ │ │ │ │ +0000b5d0: 756e 7369 676e 6564 2069 6e74 2067 7265 unsigned int gre │ │ │ │ │ +0000b5e0: 656e 5f66 6965 6c64 5f70 6f73 3b0a 2020 en_field_pos;. │ │ │ │ │ +0000b5f0: 2020 2020 2020 2020 2020 2f2a 2048 6f77 /* How │ │ │ │ │ +0000b600: 206d 616e 7920 6269 7473 2061 7265 2072 many bits are r │ │ │ │ │ +0000b610: 6573 6572 7665 6420 666f 7220 626c 7565 eserved for blue │ │ │ │ │ +0000b620: 2063 6f6c 6f72 2e20 202a 2f0a 2020 2020 color. */. │ │ │ │ │ +0000b630: 2020 2020 2020 2020 756e 7369 676e 6564 unsigned │ │ │ │ │ +0000b640: 2069 6e74 2062 6c75 655f 6d61 736b 5f73 int blue_mask_s │ │ │ │ │ +0000b650: 697a 653b 0a20 2020 2020 2020 2020 2020 ize;. │ │ │ │ │ +0000b660: 202f 2a20 5768 6174 2069 7320 6c6f 6361 /* What is loca │ │ │ │ │ +0000b670: 7469 6f6e 206f 6620 626c 7565 2063 6f6c tion of blue col │ │ │ │ │ +0000b680: 6f72 2062 6974 732e 2020 496e 2049 6e64 or bits. In Ind │ │ │ │ │ +0000b690: 6578 2043 6f6c 6f72 206d 6f64 652c 2074 ex Color mode, t │ │ │ │ │ +0000b6a0: 6869 7320 6973 2030 2e20 202a 2f0a 2020 his is 0. */. │ │ │ │ │ +0000b6b0: 2020 2020 2020 2020 2020 756e 7369 676e unsign │ │ │ │ │ +0000b6c0: 6564 2069 6e74 2062 6c75 655f 6669 656c ed int blue_fiel │ │ │ │ │ +0000b6d0: 645f 706f 733b 0a20 2020 2020 2020 2020 d_pos;. │ │ │ │ │ +0000b6e0: 2020 202f 2a20 486f 7720 6d61 6e79 2062 /* How many b │ │ │ │ │ +0000b6f0: 6974 7320 6172 6520 7265 7365 7276 6564 its are reserved │ │ │ │ │ +0000b700: 2069 6e20 636f 6c6f 722e 2020 2a2f 0a20 in color. */. │ │ │ │ │ +0000b710: 2020 2020 2020 2020 2020 2075 6e73 6967 unsig │ │ │ │ │ +0000b720: 6e65 6420 696e 7420 7265 7365 7276 6564 ned int reserved │ │ │ │ │ +0000b730: 5f6d 6173 6b5f 7369 7a65 3b0a 2020 2020 _mask_size;. │ │ │ │ │ +0000b740: 2020 2020 2020 2020 2f2a 2057 6861 7420 /* What │ │ │ │ │ +0000b750: 6973 206c 6f63 6174 696f 6e20 6f66 2072 is location of r │ │ │ │ │ +0000b760: 6573 6572 7665 6420 636f 6c6f 7220 6269 eserved color bi │ │ │ │ │ +0000b770: 7473 2e20 2049 6e20 496e 6465 7820 436f ts. In Index Co │ │ │ │ │ +0000b780: 6c6f 7220 6d6f 6465 2c0a 2020 2020 2020 lor mode,. │ │ │ │ │ +0000b790: 2020 2020 2020 2020 2074 6869 7320 6973 this is │ │ │ │ │ +0000b7a0: 2030 2e20 202a 2f0a 2020 2020 2020 2020 0. */. │ │ │ │ │ +0000b7b0: 2020 2020 756e 7369 676e 6564 2069 6e74 unsigned int │ │ │ │ │ +0000b7c0: 2072 6573 6572 7665 645f 6669 656c 645f reserved_field_ │ │ │ │ │ +0000b7d0: 706f 733b 0a20 2020 2020 2020 2020 207d pos;. } │ │ │ │ │ +0000b7e0: 3b0a 2020 202a 2044 6573 6372 6970 7469 ;. * Descripti │ │ │ │ │ +0000b7f0: 6f6e 3a0a 0a20 2020 2020 536f 6674 7761 on:.. Softwa │ │ │ │ │ +0000b800: 7265 2064 6576 656c 6f70 6572 2063 616e re developer can │ │ │ │ │ +0000b810: 2075 7365 2074 6869 7320 6675 6e63 7469 use this functi │ │ │ │ │ +0000b820: 6f6e 2074 6f20 7175 6572 7920 7072 6f70 on to query prop │ │ │ │ │ +0000b830: 6572 7469 6573 206f 660a 2020 2020 2061 erties of. a │ │ │ │ │ +0000b840: 6374 6976 6520 7265 6e64 6572 696e 6720 ctive rendering │ │ │ │ │ +0000b850: 7461 6765 742e 2020 496e 666f 726d 6174 taget. Informat │ │ │ │ │ +0000b860: 696f 6e20 7072 6f76 6964 6564 2068 6572 ion provided her │ │ │ │ │ +0000b870: 6520 6361 6e20 6265 2075 7365 6420 6279 e can be used by │ │ │ │ │ +0000b880: 0a20 2020 2020 6f74 6865 7220 7061 7274 . other part │ │ │ │ │ +0000b890: 7320 6f66 2047 5255 422c 206c 696b 6520 s of GRUB, like │ │ │ │ │ +0000b8a0: 696d 6167 6520 6c6f 6164 6572 7320 746f image loaders to │ │ │ │ │ +0000b8b0: 2063 6f6e 7665 7274 206c 6f61 6465 6420 convert loaded │ │ │ │ │ +0000b8c0: 696d 6167 6573 2074 6f0a 2020 2020 2063 images to. c │ │ │ │ │ +0000b8d0: 6f72 7265 6374 2073 6372 6565 6e20 666f orrect screen fo │ │ │ │ │ +0000b8e0: 726d 6174 2074 6f20 616c 6c6f 7720 6d6f rmat to allow mo │ │ │ │ │ +0000b8f0: 7265 206f 7074 696d 697a 6564 2062 6c69 re optimized bli │ │ │ │ │ +0000b900: 7474 6572 7320 746f 2062 6520 7573 6564 tters to be used │ │ │ │ │ +0000b910: 2e0a 2020 2020 2049 6620 7468 6572 6520 .. If there │ │ │ │ │ +0000b920: 7468 6572 6520 6973 206e 6f20 636f 6e66 there is no conf │ │ │ │ │ +0000b930: 6967 7572 6564 2076 6964 656f 2064 7269 igured video dri │ │ │ │ │ +0000b940: 7665 7220 7769 7468 2061 6374 6976 6520 ver with active │ │ │ │ │ +0000b950: 7363 7265 656e 2c0a 2020 2020 2065 7272 screen,. err │ │ │ │ │ +0000b960: 6f72 2027 4752 5542 5f45 5252 5f42 4144 or 'GRUB_ERR_BAD │ │ │ │ │ +0000b970: 5f44 4556 4943 4527 2069 7320 7265 7475 _DEVICE' is retu │ │ │ │ │ +0000b980: 726e 6564 2c20 6f74 6865 7277 6973 6520 rned, otherwise │ │ │ │ │ +0000b990: 276d 6f64 655f 696e 666f 2720 6973 0a20 'mode_info' is. │ │ │ │ │ +0000b9a0: 2020 2020 6669 6c6c 6564 2077 6974 6820 filled with │ │ │ │ │ +0000b9b0: 7661 6c69 6420 696e 666f 726d 6174 696f valid informatio │ │ │ │ │ +0000b9c0: 6e20 616e 6420 2747 5255 425f 4552 525f n and 'GRUB_ERR_ │ │ │ │ │ +0000b9d0: 4e4f 4e45 2720 6973 2072 6574 7572 6e65 NONE' is returne │ │ │ │ │ +0000b9e0: 642e 0a0a 3130 2e31 2e34 2067 7275 625f d...10.1.4 grub_ │ │ │ │ │ +0000b9f0: 7669 6465 6f5f 6765 745f 626c 6974 5f66 video_get_blit_f │ │ │ │ │ +0000ba00: 6f72 6d61 740a 2d2d 2d2d 2d2d 2d2d 2d2d ormat.---------- │ │ │ │ │ 0000ba10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000ba20: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2020 2a20 ---------.. * │ │ │ │ │ -0000ba30: 5072 6f74 6f74 7970 653a 0a0a 2020 2020 Prototype:.. │ │ │ │ │ -0000ba40: 2020 2020 2020 656e 756d 2067 7275 625f enum grub_ │ │ │ │ │ -0000ba50: 7669 6465 6f5f 626c 6974 5f66 6f72 6d61 video_blit_forma │ │ │ │ │ -0000ba60: 740a 2020 2020 2020 2020 2020 6772 7562 t. grub │ │ │ │ │ -0000ba70: 5f76 6964 656f 5f67 6574 5f62 6c69 745f _video_get_blit_ │ │ │ │ │ -0000ba80: 666f 726d 6174 2028 7374 7275 6374 2067 format (struct g │ │ │ │ │ -0000ba90: 7275 625f 7669 6465 6f5f 6d6f 6465 5f69 rub_video_mode_i │ │ │ │ │ -0000baa0: 6e66 6f20 2a6d 6f64 655f 696e 666f 293b nfo *mode_info); │ │ │ │ │ -0000bab0: 0a20 2020 2020 2020 2020 2065 6e75 6d20 . enum │ │ │ │ │ -0000bac0: 6772 7562 5f76 6964 656f 5f62 6c69 745f grub_video_blit_ │ │ │ │ │ -0000bad0: 666f 726d 6174 0a20 2020 2020 2020 2020 format. │ │ │ │ │ -0000bae0: 2020 207b 0a20 2020 2020 2020 2020 2020 {. │ │ │ │ │ -0000baf0: 2020 202f 2a20 466f 6c6c 6f77 2065 7861 /* Follow exa │ │ │ │ │ -0000bb00: 6374 6c79 2066 6965 6c64 2026 206d 6173 ctly field & mas │ │ │ │ │ -0000bb10: 6b20 696e 666f 726d 6174 696f 6e2e 2020 k information. │ │ │ │ │ -0000bb20: 2a2f 0a20 2020 2020 2020 2020 2020 2020 */. │ │ │ │ │ -0000bb30: 2047 5255 425f 5649 4445 4f5f 424c 4954 GRUB_VIDEO_BLIT │ │ │ │ │ -0000bb40: 5f46 4f52 4d41 545f 5247 4241 2c0a 2020 _FORMAT_RGBA,. │ │ │ │ │ -0000bb50: 2020 2020 2020 2020 2020 2020 2f2a 204d /* M │ │ │ │ │ -0000bb60: 616b 6520 6f70 7469 6d69 7a61 7469 6f6e ake optimization │ │ │ │ │ -0000bb70: 2061 7373 756d 7074 696f 6e2e 2020 2a2f assumption. */ │ │ │ │ │ -0000bb80: 0a20 2020 2020 2020 2020 2020 2020 2047 . G │ │ │ │ │ -0000bb90: 5255 425f 5649 4445 4f5f 424c 4954 5f46 RUB_VIDEO_BLIT_F │ │ │ │ │ -0000bba0: 4f52 4d41 545f 5238 4738 4238 4138 2c0a ORMAT_R8G8B8A8,. │ │ │ │ │ -0000bbb0: 2020 2020 2020 2020 2020 2020 2020 2f2a /* │ │ │ │ │ -0000bbc0: 2046 6f6c 6c6f 7720 6578 6163 746c 7920 Follow exactly │ │ │ │ │ -0000bbd0: 6669 656c 6420 2620 6d61 736b 2069 6e66 field & mask inf │ │ │ │ │ -0000bbe0: 6f72 6d61 7469 6f6e 2e20 202a 2f0a 2020 ormation. */. │ │ │ │ │ -0000bbf0: 2020 2020 2020 2020 2020 2020 4752 5542 GRUB │ │ │ │ │ -0000bc00: 5f56 4944 454f 5f42 4c49 545f 464f 524d _VIDEO_BLIT_FORM │ │ │ │ │ -0000bc10: 4154 5f52 4742 2c0a 2020 2020 2020 2020 AT_RGB,. │ │ │ │ │ -0000bc20: 2020 2020 2020 2f2a 204d 616b 6520 6f70 /* Make op │ │ │ │ │ -0000bc30: 7469 6d69 7a61 7469 6f6e 2061 7373 756d timization assum │ │ │ │ │ -0000bc40: 7074 696f 6e2e 2020 2a2f 0a20 2020 2020 ption. */. │ │ │ │ │ -0000bc50: 2020 2020 2020 2020 2047 5255 425f 5649 GRUB_VI │ │ │ │ │ -0000bc60: 4445 4f5f 424c 4954 5f46 4f52 4d41 545f DEO_BLIT_FORMAT_ │ │ │ │ │ -0000bc70: 5238 4738 4238 2c0a 2020 2020 2020 2020 R8G8B8,. │ │ │ │ │ -0000bc80: 2020 2020 2020 2f2a 2057 6865 6e20 6e65 /* When ne │ │ │ │ │ -0000bc90: 6564 6564 2c20 6465 636f 6465 2063 6f6c eded, decode col │ │ │ │ │ -0000bca0: 6f72 206f 7220 6a75 7374 2075 7365 2076 or or just use v │ │ │ │ │ -0000bcb0: 616c 7565 2061 7320 6973 2e20 202a 2f0a alue as is. */. │ │ │ │ │ -0000bcc0: 2020 2020 2020 2020 2020 2020 2020 4752 GR │ │ │ │ │ -0000bcd0: 5542 5f56 4944 454f 5f42 4c49 545f 464f UB_VIDEO_BLIT_FO │ │ │ │ │ -0000bce0: 524d 4154 5f49 4e44 4558 434f 4c4f 520a RMAT_INDEXCOLOR. │ │ │ │ │ -0000bcf0: 2020 2020 2020 2020 2020 2020 7d3b 0a20 };. │ │ │ │ │ -0000bd00: 2020 2a20 4465 7363 7269 7074 696f 6e3a * Description: │ │ │ │ │ -0000bd10: 0a0a 2020 2020 2055 7365 6420 746f 2071 .. Used to q │ │ │ │ │ -0000bd20: 7565 7279 2068 6f77 2064 6174 6120 636f uery how data co │ │ │ │ │ -0000bd30: 756c 6420 6265 206f 7074 696d 697a 6564 uld be optimized │ │ │ │ │ -0000bd40: 2074 6f20 7375 6974 2073 7065 6369 6669 to suit specifi │ │ │ │ │ -0000bd50: 6564 2076 6964 656f 0a20 2020 2020 6d6f ed video. mo │ │ │ │ │ -0000bd60: 6465 2e20 2052 6574 7572 6e73 2065 7861 de. Returns exa │ │ │ │ │ -0000bd70: 6374 2076 6964 656f 2066 6f72 6d61 7420 ct video format │ │ │ │ │ -0000bd80: 7479 7065 2c20 6f72 2061 2067 656e 6572 type, or a gener │ │ │ │ │ -0000bd90: 6963 206f 6e65 2069 6620 7468 6572 650a ic one if there. │ │ │ │ │ -0000bda0: 2020 2020 2069 7320 6e6f 2064 6566 696e is no defin │ │ │ │ │ -0000bdb0: 6974 696f 6e20 666f 7220 7468 6520 7479 ition for the ty │ │ │ │ │ -0000bdc0: 7065 2e20 2046 6f72 2067 656e 6572 6963 pe. For generic │ │ │ │ │ -0000bdd0: 2066 6f72 6d61 7473 2c20 7573 650a 2020 formats, use. │ │ │ │ │ -0000bde0: 2020 2027 6772 7562 5f76 6964 656f 5f67 'grub_video_g │ │ │ │ │ -0000bdf0: 6574 5f69 6e66 6f27 2074 6f20 7175 6572 et_info' to quer │ │ │ │ │ -0000be00: 7920 7669 6465 6f20 636f 6c6f 7220 636f y video color co │ │ │ │ │ -0000be10: 6469 6e67 2073 6574 7469 6e67 732e 0a0a ding settings... │ │ │ │ │ -0000be20: 3130 2e31 2e35 2067 7275 625f 7669 6465 10.1.5 grub_vide │ │ │ │ │ -0000be30: 6f5f 7365 745f 7061 6c65 7474 650a 2d2d o_set_palette.-- │ │ │ │ │ +0000ba20: 2d2d 2d2d 2d2d 2d0a 0a20 2020 2a20 5072 -------.. * Pr │ │ │ │ │ +0000ba30: 6f74 6f74 7970 653a 0a0a 2020 2020 2020 ototype:.. │ │ │ │ │ +0000ba40: 2020 2020 656e 756d 2067 7275 625f 7669 enum grub_vi │ │ │ │ │ +0000ba50: 6465 6f5f 626c 6974 5f66 6f72 6d61 740a deo_blit_format. │ │ │ │ │ +0000ba60: 2020 2020 2020 2020 2020 6772 7562 5f76 grub_v │ │ │ │ │ +0000ba70: 6964 656f 5f67 6574 5f62 6c69 745f 666f ideo_get_blit_fo │ │ │ │ │ +0000ba80: 726d 6174 2028 7374 7275 6374 2067 7275 rmat (struct gru │ │ │ │ │ +0000ba90: 625f 7669 6465 6f5f 6d6f 6465 5f69 6e66 b_video_mode_inf │ │ │ │ │ +0000baa0: 6f20 2a6d 6f64 655f 696e 666f 293b 0a20 o *mode_info);. │ │ │ │ │ +0000bab0: 2020 2020 2020 2020 2065 6e75 6d20 6772 enum gr │ │ │ │ │ +0000bac0: 7562 5f76 6964 656f 5f62 6c69 745f 666f ub_video_blit_fo │ │ │ │ │ +0000bad0: 726d 6174 0a20 2020 2020 2020 2020 2020 rmat. │ │ │ │ │ +0000bae0: 207b 0a20 2020 2020 2020 2020 2020 2020 {. │ │ │ │ │ +0000baf0: 202f 2a20 466f 6c6c 6f77 2065 7861 6374 /* Follow exact │ │ │ │ │ +0000bb00: 6c79 2066 6965 6c64 2026 206d 6173 6b20 ly field & mask │ │ │ │ │ +0000bb10: 696e 666f 726d 6174 696f 6e2e 2020 2a2f information. */ │ │ │ │ │ +0000bb20: 0a20 2020 2020 2020 2020 2020 2020 2047 . G │ │ │ │ │ +0000bb30: 5255 425f 5649 4445 4f5f 424c 4954 5f46 RUB_VIDEO_BLIT_F │ │ │ │ │ +0000bb40: 4f52 4d41 545f 5247 4241 2c0a 2020 2020 ORMAT_RGBA,. │ │ │ │ │ +0000bb50: 2020 2020 2020 2020 2020 2f2a 204d 616b /* Mak │ │ │ │ │ +0000bb60: 6520 6f70 7469 6d69 7a61 7469 6f6e 2061 e optimization a │ │ │ │ │ +0000bb70: 7373 756d 7074 696f 6e2e 2020 2a2f 0a20 ssumption. */. │ │ │ │ │ +0000bb80: 2020 2020 2020 2020 2020 2020 2047 5255 GRU │ │ │ │ │ +0000bb90: 425f 5649 4445 4f5f 424c 4954 5f46 4f52 B_VIDEO_BLIT_FOR │ │ │ │ │ +0000bba0: 4d41 545f 5238 4738 4238 4138 2c0a 2020 MAT_R8G8B8A8,. │ │ │ │ │ +0000bbb0: 2020 2020 2020 2020 2020 2020 2f2a 2046 /* F │ │ │ │ │ +0000bbc0: 6f6c 6c6f 7720 6578 6163 746c 7920 6669 ollow exactly fi │ │ │ │ │ +0000bbd0: 656c 6420 2620 6d61 736b 2069 6e66 6f72 eld & mask infor │ │ │ │ │ +0000bbe0: 6d61 7469 6f6e 2e20 202a 2f0a 2020 2020 mation. */. │ │ │ │ │ +0000bbf0: 2020 2020 2020 2020 2020 4752 5542 5f56 GRUB_V │ │ │ │ │ +0000bc00: 4944 454f 5f42 4c49 545f 464f 524d 4154 IDEO_BLIT_FORMAT │ │ │ │ │ +0000bc10: 5f52 4742 2c0a 2020 2020 2020 2020 2020 _RGB,. │ │ │ │ │ +0000bc20: 2020 2020 2f2a 204d 616b 6520 6f70 7469 /* Make opti │ │ │ │ │ +0000bc30: 6d69 7a61 7469 6f6e 2061 7373 756d 7074 mization assumpt │ │ │ │ │ +0000bc40: 696f 6e2e 2020 2a2f 0a20 2020 2020 2020 ion. */. │ │ │ │ │ +0000bc50: 2020 2020 2020 2047 5255 425f 5649 4445 GRUB_VIDE │ │ │ │ │ +0000bc60: 4f5f 424c 4954 5f46 4f52 4d41 545f 5238 O_BLIT_FORMAT_R8 │ │ │ │ │ +0000bc70: 4738 4238 2c0a 2020 2020 2020 2020 2020 G8B8,. │ │ │ │ │ +0000bc80: 2020 2020 2f2a 2057 6865 6e20 6e65 6564 /* When need │ │ │ │ │ +0000bc90: 6564 2c20 6465 636f 6465 2063 6f6c 6f72 ed, decode color │ │ │ │ │ +0000bca0: 206f 7220 6a75 7374 2075 7365 2076 616c or just use val │ │ │ │ │ +0000bcb0: 7565 2061 7320 6973 2e20 202a 2f0a 2020 ue as is. */. │ │ │ │ │ +0000bcc0: 2020 2020 2020 2020 2020 2020 4752 5542 GRUB │ │ │ │ │ +0000bcd0: 5f56 4944 454f 5f42 4c49 545f 464f 524d _VIDEO_BLIT_FORM │ │ │ │ │ +0000bce0: 4154 5f49 4e44 4558 434f 4c4f 520a 2020 AT_INDEXCOLOR. │ │ │ │ │ +0000bcf0: 2020 2020 2020 2020 2020 7d3b 0a20 2020 };. │ │ │ │ │ +0000bd00: 2a20 4465 7363 7269 7074 696f 6e3a 0a0a * Description:.. │ │ │ │ │ +0000bd10: 2020 2020 2055 7365 6420 746f 2071 7565 Used to que │ │ │ │ │ +0000bd20: 7279 2068 6f77 2064 6174 6120 636f 756c ry how data coul │ │ │ │ │ +0000bd30: 6420 6265 206f 7074 696d 697a 6564 2074 d be optimized t │ │ │ │ │ +0000bd40: 6f20 7375 6974 2073 7065 6369 6669 6564 o suit specified │ │ │ │ │ +0000bd50: 2076 6964 656f 0a20 2020 2020 6d6f 6465 video. mode │ │ │ │ │ +0000bd60: 2e20 2052 6574 7572 6e73 2065 7861 6374 . Returns exact │ │ │ │ │ +0000bd70: 2076 6964 656f 2066 6f72 6d61 7420 7479 video format ty │ │ │ │ │ +0000bd80: 7065 2c20 6f72 2061 2067 656e 6572 6963 pe, or a generic │ │ │ │ │ +0000bd90: 206f 6e65 2069 6620 7468 6572 650a 2020 one if there. │ │ │ │ │ +0000bda0: 2020 2069 7320 6e6f 2064 6566 696e 6974 is no definit │ │ │ │ │ +0000bdb0: 696f 6e20 666f 7220 7468 6520 7479 7065 ion for the type │ │ │ │ │ +0000bdc0: 2e20 2046 6f72 2067 656e 6572 6963 2066 . For generic f │ │ │ │ │ +0000bdd0: 6f72 6d61 7473 2c20 7573 650a 2020 2020 ormats, use. │ │ │ │ │ +0000bde0: 2027 6772 7562 5f76 6964 656f 5f67 6574 'grub_video_get │ │ │ │ │ +0000bdf0: 5f69 6e66 6f27 2074 6f20 7175 6572 7920 _info' to query │ │ │ │ │ +0000be00: 7669 6465 6f20 636f 6c6f 7220 636f 6469 video color codi │ │ │ │ │ +0000be10: 6e67 2073 6574 7469 6e67 732e 0a0a 3130 ng settings...10 │ │ │ │ │ +0000be20: 2e31 2e35 2067 7275 625f 7669 6465 6f5f .1.5 grub_video_ │ │ │ │ │ +0000be30: 7365 745f 7061 6c65 7474 650a 2d2d 2d2d set_palette.---- │ │ │ │ │ 0000be40: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000be50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2020 -----------.. │ │ │ │ │ -0000be60: 2a20 5072 6f74 6f74 7970 653a 0a0a 2020 * Prototype:.. │ │ │ │ │ -0000be70: 2020 2020 2020 2020 6772 7562 5f65 7272 grub_err │ │ │ │ │ -0000be80: 5f74 0a20 2020 2020 2020 2020 2067 7275 _t. gru │ │ │ │ │ -0000be90: 625f 7669 6465 6f5f 7365 745f 7061 6c65 b_video_set_pale │ │ │ │ │ -0000bea0: 7474 6520 2875 6e73 6967 6e65 6420 696e tte (unsigned in │ │ │ │ │ -0000beb0: 7420 7374 6172 742c 2075 6e73 6967 6e65 t start, unsigne │ │ │ │ │ -0000bec0: 6420 696e 7420 636f 756e 742c 2073 7472 d int count, str │ │ │ │ │ -0000bed0: 7563 7420 6772 7562 5f76 6964 656f 5f70 uct grub_video_p │ │ │ │ │ -0000bee0: 616c 6574 7465 5f64 6174 6120 2a70 616c alette_data *pal │ │ │ │ │ -0000bef0: 6574 7465 5f64 6174 6129 3b0a 2020 2020 ette_data);. │ │ │ │ │ -0000bf00: 2020 2020 2020 7374 7275 6374 2067 7275 struct gru │ │ │ │ │ -0000bf10: 625f 7669 6465 6f5f 7061 6c65 7474 655f b_video_palette_ │ │ │ │ │ -0000bf20: 6461 7461 0a20 2020 2020 2020 2020 207b data. { │ │ │ │ │ -0000bf30: 0a20 2020 2020 2020 2020 2020 2020 2067 . g │ │ │ │ │ -0000bf40: 7275 625f 7569 6e74 385f 7420 723b 202f rub_uint8_t r; / │ │ │ │ │ -0000bf50: 2a20 5265 6420 636f 6c6f 7220 7661 6c75 * Red color valu │ │ │ │ │ -0000bf60: 6520 2830 2d32 3535 292e 202a 2f0a 2020 e (0-255). */. │ │ │ │ │ -0000bf70: 2020 2020 2020 2020 2020 2020 6772 7562 grub │ │ │ │ │ -0000bf80: 5f75 696e 7438 5f74 2067 3b20 2f2a 2047 _uint8_t g; /* G │ │ │ │ │ -0000bf90: 7265 656e 2063 6f6c 6f72 2076 616c 7565 reen color value │ │ │ │ │ -0000bfa0: 2028 302d 3235 3529 2e20 2a2f 0a20 2020 (0-255). */. │ │ │ │ │ -0000bfb0: 2020 2020 2020 2020 2020 2067 7275 625f grub_ │ │ │ │ │ -0000bfc0: 7569 6e74 385f 7420 623b 202f 2a20 426c uint8_t b; /* Bl │ │ │ │ │ -0000bfd0: 7565 2063 6f6c 6f72 2076 616c 7565 2028 ue color value ( │ │ │ │ │ -0000bfe0: 302d 3235 3529 2e20 2a2f 0a20 2020 2020 0-255). */. │ │ │ │ │ -0000bff0: 2020 2020 2020 2020 2067 7275 625f 7569 grub_ui │ │ │ │ │ -0000c000: 6e74 385f 7420 613b 202f 2a20 5265 7365 nt8_t a; /* Rese │ │ │ │ │ -0000c010: 7276 6564 2062 6974 7320 7661 6c75 6520 rved bits value │ │ │ │ │ -0000c020: 2830 2d32 3535 292e 202a 2f0a 2020 2020 (0-255). */. │ │ │ │ │ -0000c030: 2020 2020 2020 7d3b 0a20 2020 2a20 4465 };. * De │ │ │ │ │ -0000c040: 7363 7269 7074 696f 6e3a 0a0a 2020 2020 scription:.. │ │ │ │ │ -0000c050: 2055 7365 6420 746f 2073 6574 7570 2069 Used to setup i │ │ │ │ │ -0000c060: 6e64 6578 6564 2063 6f6c 6f72 2070 616c ndexed color pal │ │ │ │ │ -0000c070: 6574 7465 732e 2020 4966 206d 6f64 6520 ettes. If mode │ │ │ │ │ -0000c080: 6973 2052 4742 206d 6f64 652c 2063 6f6c is RGB mode, col │ │ │ │ │ -0000c090: 6f72 730a 2020 2020 2077 696c 6c20 6265 ors. will be │ │ │ │ │ -0000c0a0: 2073 6574 2074 6f20 656d 756c 6174 6564 set to emulated │ │ │ │ │ -0000c0b0: 2070 616c 6574 7465 2064 6174 612e 2020 palette data. │ │ │ │ │ -0000c0c0: 496e 2049 6e64 6578 6564 2043 6f6c 6f72 In Indexed Color │ │ │ │ │ -0000c0d0: 206d 6f64 6573 2c0a 2020 2020 2070 616c modes,. pal │ │ │ │ │ -0000c0e0: 6574 7465 7320 7769 6c6c 2062 6520 7365 ettes will be se │ │ │ │ │ -0000c0f0: 7420 746f 2068 6172 6477 6172 652e 2020 t to hardware. │ │ │ │ │ -0000c100: 436f 6c6f 7220 7661 6c75 6573 2077 696c Color values wil │ │ │ │ │ -0000c110: 6c20 6265 2063 6f6e 7665 7274 6564 0a20 l be converted. │ │ │ │ │ -0000c120: 2020 2020 746f 2073 7569 7420 7265 7175 to suit requ │ │ │ │ │ -0000c130: 6972 656d 656e 7473 206f 6620 7468 6520 irements of the │ │ │ │ │ -0000c140: 7669 6465 6f20 6d6f 6465 2e20 2027 7374 video mode. 'st │ │ │ │ │ -0000c150: 6172 7427 2077 696c 6c20 7465 6c6c 2077 art' will tell w │ │ │ │ │ -0000c160: 6861 740a 2020 2020 2068 6172 6477 6172 hat. hardwar │ │ │ │ │ -0000c170: 6520 636f 6c6f 7220 696e 6465 7820 286f e color index (o │ │ │ │ │ -0000c180: 7220 656d 756c 6174 6564 2063 6f6c 6f72 r emulated color │ │ │ │ │ -0000c190: 2069 6e64 6578 2920 7769 6c6c 2062 6520 index) will be │ │ │ │ │ -0000c1a0: 7365 7420 746f 0a20 2020 2020 6163 636f set to. acco │ │ │ │ │ -0000c1b0: 7264 696e 6720 696e 666f 726d 6174 696f rding informatio │ │ │ │ │ -0000c1c0: 6e20 696e 2066 6972 7374 2069 6e64 6963 n in first indic │ │ │ │ │ -0000c1d0: 6520 6f66 2027 7061 6c65 7474 655f 6461 e of 'palette_da │ │ │ │ │ -0000c1e0: 7461 272c 2061 6674 6572 2074 6861 740a ta', after that. │ │ │ │ │ -0000c1f0: 2020 2020 2062 6f74 6820 6861 7264 7761 both hardwa │ │ │ │ │ -0000c200: 7265 2063 6f6c 6f72 2069 6e64 6578 2061 re color index a │ │ │ │ │ -0000c210: 6e64 2027 7061 6c65 7474 655f 6461 7461 nd 'palette_data │ │ │ │ │ -0000c220: 2720 696e 6465 7820 7769 6c6c 2062 650a ' index will be. │ │ │ │ │ -0000c230: 2020 2020 2069 6e63 7265 6d65 6e74 6564 incremented │ │ │ │ │ -0000c240: 2075 6e74 696c 2027 636f 756e 7427 206e until 'count' n │ │ │ │ │ -0000c250: 756d 6265 7220 6f66 2063 6f6c 6f72 7320 umber of colors │ │ │ │ │ -0000c260: 6861 7665 2062 6565 6e20 7365 742e 0a0a have been set... │ │ │ │ │ -0000c270: 3130 2e31 2e36 2067 7275 625f 7669 6465 10.1.6 grub_vide │ │ │ │ │ -0000c280: 6f5f 6765 745f 7061 6c65 7474 650a 2d2d o_get_palette.-- │ │ │ │ │ +0000be50: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2020 2a20 ---------.. * │ │ │ │ │ +0000be60: 5072 6f74 6f74 7970 653a 0a0a 2020 2020 Prototype:.. │ │ │ │ │ +0000be70: 2020 2020 2020 6772 7562 5f65 7272 5f74 grub_err_t │ │ │ │ │ +0000be80: 0a20 2020 2020 2020 2020 2067 7275 625f . grub_ │ │ │ │ │ +0000be90: 7669 6465 6f5f 7365 745f 7061 6c65 7474 video_set_palett │ │ │ │ │ +0000bea0: 6520 2875 6e73 6967 6e65 6420 696e 7420 e (unsigned int │ │ │ │ │ +0000beb0: 7374 6172 742c 2075 6e73 6967 6e65 6420 start, unsigned │ │ │ │ │ +0000bec0: 696e 7420 636f 756e 742c 2073 7472 7563 int count, struc │ │ │ │ │ +0000bed0: 7420 6772 7562 5f76 6964 656f 5f70 616c t grub_video_pal │ │ │ │ │ +0000bee0: 6574 7465 5f64 6174 6120 2a70 616c 6574 ette_data *palet │ │ │ │ │ +0000bef0: 7465 5f64 6174 6129 3b0a 2020 2020 2020 te_data);. │ │ │ │ │ +0000bf00: 2020 2020 7374 7275 6374 2067 7275 625f struct grub_ │ │ │ │ │ +0000bf10: 7669 6465 6f5f 7061 6c65 7474 655f 6461 video_palette_da │ │ │ │ │ +0000bf20: 7461 0a20 2020 2020 2020 2020 207b 0a20 ta. {. │ │ │ │ │ +0000bf30: 2020 2020 2020 2020 2020 2020 2067 7275 gru │ │ │ │ │ +0000bf40: 625f 7569 6e74 385f 7420 723b 202f 2a20 b_uint8_t r; /* │ │ │ │ │ +0000bf50: 5265 6420 636f 6c6f 7220 7661 6c75 6520 Red color value │ │ │ │ │ +0000bf60: 2830 2d32 3535 292e 202a 2f0a 2020 2020 (0-255). */. │ │ │ │ │ +0000bf70: 2020 2020 2020 2020 2020 6772 7562 5f75 grub_u │ │ │ │ │ +0000bf80: 696e 7438 5f74 2067 3b20 2f2a 2047 7265 int8_t g; /* Gre │ │ │ │ │ +0000bf90: 656e 2063 6f6c 6f72 2076 616c 7565 2028 en color value ( │ │ │ │ │ +0000bfa0: 302d 3235 3529 2e20 2a2f 0a20 2020 2020 0-255). */. │ │ │ │ │ +0000bfb0: 2020 2020 2020 2020 2067 7275 625f 7569 grub_ui │ │ │ │ │ +0000bfc0: 6e74 385f 7420 623b 202f 2a20 426c 7565 nt8_t b; /* Blue │ │ │ │ │ +0000bfd0: 2063 6f6c 6f72 2076 616c 7565 2028 302d color value (0- │ │ │ │ │ +0000bfe0: 3235 3529 2e20 2a2f 0a20 2020 2020 2020 255). */. │ │ │ │ │ +0000bff0: 2020 2020 2020 2067 7275 625f 7569 6e74 grub_uint │ │ │ │ │ +0000c000: 385f 7420 613b 202f 2a20 5265 7365 7276 8_t a; /* Reserv │ │ │ │ │ +0000c010: 6564 2062 6974 7320 7661 6c75 6520 2830 ed bits value (0 │ │ │ │ │ +0000c020: 2d32 3535 292e 202a 2f0a 2020 2020 2020 -255). */. │ │ │ │ │ +0000c030: 2020 2020 7d3b 0a20 2020 2a20 4465 7363 };. * Desc │ │ │ │ │ +0000c040: 7269 7074 696f 6e3a 0a0a 2020 2020 2055 ription:.. U │ │ │ │ │ +0000c050: 7365 6420 746f 2073 6574 7570 2069 6e64 sed to setup ind │ │ │ │ │ +0000c060: 6578 6564 2063 6f6c 6f72 2070 616c 6574 exed color palet │ │ │ │ │ +0000c070: 7465 732e 2020 4966 206d 6f64 6520 6973 tes. If mode is │ │ │ │ │ +0000c080: 2052 4742 206d 6f64 652c 2063 6f6c 6f72 RGB mode, color │ │ │ │ │ +0000c090: 730a 2020 2020 2077 696c 6c20 6265 2073 s. will be s │ │ │ │ │ +0000c0a0: 6574 2074 6f20 656d 756c 6174 6564 2070 et to emulated p │ │ │ │ │ +0000c0b0: 616c 6574 7465 2064 6174 612e 2020 496e alette data. In │ │ │ │ │ +0000c0c0: 2049 6e64 6578 6564 2043 6f6c 6f72 206d Indexed Color m │ │ │ │ │ +0000c0d0: 6f64 6573 2c0a 2020 2020 2070 616c 6574 odes,. palet │ │ │ │ │ +0000c0e0: 7465 7320 7769 6c6c 2062 6520 7365 7420 tes will be set │ │ │ │ │ +0000c0f0: 746f 2068 6172 6477 6172 652e 2020 436f to hardware. Co │ │ │ │ │ +0000c100: 6c6f 7220 7661 6c75 6573 2077 696c 6c20 lor values will │ │ │ │ │ +0000c110: 6265 2063 6f6e 7665 7274 6564 0a20 2020 be converted. │ │ │ │ │ +0000c120: 2020 746f 2073 7569 7420 7265 7175 6972 to suit requir │ │ │ │ │ +0000c130: 656d 656e 7473 206f 6620 7468 6520 7669 ements of the vi │ │ │ │ │ +0000c140: 6465 6f20 6d6f 6465 2e20 2027 7374 6172 deo mode. 'star │ │ │ │ │ +0000c150: 7427 2077 696c 6c20 7465 6c6c 2077 6861 t' will tell wha │ │ │ │ │ +0000c160: 740a 2020 2020 2068 6172 6477 6172 6520 t. hardware │ │ │ │ │ +0000c170: 636f 6c6f 7220 696e 6465 7820 286f 7220 color index (or │ │ │ │ │ +0000c180: 656d 756c 6174 6564 2063 6f6c 6f72 2069 emulated color i │ │ │ │ │ +0000c190: 6e64 6578 2920 7769 6c6c 2062 6520 7365 ndex) will be se │ │ │ │ │ +0000c1a0: 7420 746f 0a20 2020 2020 6163 636f 7264 t to. accord │ │ │ │ │ +0000c1b0: 696e 6720 696e 666f 726d 6174 696f 6e20 ing information │ │ │ │ │ +0000c1c0: 696e 2066 6972 7374 2069 6e64 6963 6520 in first indice │ │ │ │ │ +0000c1d0: 6f66 2027 7061 6c65 7474 655f 6461 7461 of 'palette_data │ │ │ │ │ +0000c1e0: 272c 2061 6674 6572 2074 6861 740a 2020 ', after that. │ │ │ │ │ +0000c1f0: 2020 2062 6f74 6820 6861 7264 7761 7265 both hardware │ │ │ │ │ +0000c200: 2063 6f6c 6f72 2069 6e64 6578 2061 6e64 color index and │ │ │ │ │ +0000c210: 2027 7061 6c65 7474 655f 6461 7461 2720 'palette_data' │ │ │ │ │ +0000c220: 696e 6465 7820 7769 6c6c 2062 650a 2020 index will be. │ │ │ │ │ +0000c230: 2020 2069 6e63 7265 6d65 6e74 6564 2075 incremented u │ │ │ │ │ +0000c240: 6e74 696c 2027 636f 756e 7427 206e 756d ntil 'count' num │ │ │ │ │ +0000c250: 6265 7220 6f66 2063 6f6c 6f72 7320 6861 ber of colors ha │ │ │ │ │ +0000c260: 7665 2062 6565 6e20 7365 742e 0a0a 3130 ve been set...10 │ │ │ │ │ +0000c270: 2e31 2e36 2067 7275 625f 7669 6465 6f5f .1.6 grub_video_ │ │ │ │ │ +0000c280: 6765 745f 7061 6c65 7474 650a 2d2d 2d2d get_palette.---- │ │ │ │ │ 0000c290: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000c2a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2020 -----------.. │ │ │ │ │ -0000c2b0: 2a20 5072 6f74 6f74 7970 653a 0a0a 2020 * Prototype:.. │ │ │ │ │ -0000c2c0: 2020 2020 2020 2020 6772 7562 5f65 7272 grub_err │ │ │ │ │ -0000c2d0: 5f74 0a20 2020 2020 2020 2020 2067 7275 _t. gru │ │ │ │ │ -0000c2e0: 625f 7669 6465 6f5f 6765 745f 7061 6c65 b_video_get_pale │ │ │ │ │ -0000c2f0: 7474 6520 2875 6e73 6967 6e65 6420 696e tte (unsigned in │ │ │ │ │ -0000c300: 7420 7374 6172 742c 2075 6e73 6967 6e65 t start, unsigne │ │ │ │ │ -0000c310: 6420 696e 7420 636f 756e 742c 2073 7472 d int count, str │ │ │ │ │ -0000c320: 7563 7420 6772 7562 5f76 6964 656f 5f70 uct grub_video_p │ │ │ │ │ -0000c330: 616c 6574 7465 5f64 6174 6120 2a70 616c alette_data *pal │ │ │ │ │ -0000c340: 6574 7465 5f64 6174 6129 3b0a 2020 2020 ette_data);. │ │ │ │ │ -0000c350: 2020 2020 2020 7374 7275 6374 2067 7275 struct gru │ │ │ │ │ -0000c360: 625f 7669 6465 6f5f 7061 6c65 7474 655f b_video_palette_ │ │ │ │ │ -0000c370: 6461 7461 0a20 2020 2020 2020 2020 207b data. { │ │ │ │ │ -0000c380: 0a20 2020 2020 2020 2020 2020 2020 2067 . g │ │ │ │ │ -0000c390: 7275 625f 7569 6e74 385f 7420 723b 202f rub_uint8_t r; / │ │ │ │ │ -0000c3a0: 2a20 5265 6420 636f 6c6f 7220 7661 6c75 * Red color valu │ │ │ │ │ -0000c3b0: 6520 2830 2d32 3535 292e 202a 2f0a 2020 e (0-255). */. │ │ │ │ │ -0000c3c0: 2020 2020 2020 2020 2020 2020 6772 7562 grub │ │ │ │ │ -0000c3d0: 5f75 696e 7438 5f74 2067 3b20 2f2a 2047 _uint8_t g; /* G │ │ │ │ │ -0000c3e0: 7265 656e 2063 6f6c 6f72 2076 616c 7565 reen color value │ │ │ │ │ -0000c3f0: 2028 302d 3235 3529 2e20 2a2f 0a20 2020 (0-255). */. │ │ │ │ │ -0000c400: 2020 2020 2020 2020 2020 2067 7275 625f grub_ │ │ │ │ │ -0000c410: 7569 6e74 385f 7420 623b 202f 2a20 426c uint8_t b; /* Bl │ │ │ │ │ -0000c420: 7565 2063 6f6c 6f72 2076 616c 7565 2028 ue color value ( │ │ │ │ │ -0000c430: 302d 3235 3529 2e20 2a2f 0a20 2020 2020 0-255). */. │ │ │ │ │ -0000c440: 2020 2020 2020 2020 2067 7275 625f 7569 grub_ui │ │ │ │ │ -0000c450: 6e74 385f 7420 613b 202f 2a20 5265 7365 nt8_t a; /* Rese │ │ │ │ │ -0000c460: 7276 6564 2062 6974 7320 7661 6c75 6520 rved bits value │ │ │ │ │ -0000c470: 2830 2d32 3535 292e 202a 2f0a 2020 2020 (0-255). */. │ │ │ │ │ -0000c480: 2020 2020 2020 7d3b 0a20 2020 2a20 4465 };. * De │ │ │ │ │ -0000c490: 7363 7269 7074 696f 6e3a 0a0a 2020 2020 scription:.. │ │ │ │ │ -0000c4a0: 2055 7365 6420 746f 2071 7565 7279 2069 Used to query i │ │ │ │ │ -0000c4b0: 6e64 6578 6564 2063 6f6c 6f72 2070 616c ndexed color pal │ │ │ │ │ -0000c4c0: 6574 7465 732e 2020 4966 206d 6f64 6520 ettes. If mode │ │ │ │ │ -0000c4d0: 6973 2052 4742 206d 6f64 652c 2063 6f6c is RGB mode, col │ │ │ │ │ -0000c4e0: 6f72 730a 2020 2020 2077 696c 6c20 6265 ors. will be │ │ │ │ │ -0000c4f0: 2063 6f70 6965 6420 6672 6f6d 2065 6d75 copied from emu │ │ │ │ │ -0000c500: 6c61 7465 6420 7061 6c65 7474 6520 6461 lated palette da │ │ │ │ │ -0000c510: 7461 2e20 2049 6e20 496e 6465 7865 6420 ta. In Indexed │ │ │ │ │ -0000c520: 436f 6c6f 7220 6d6f 6465 732c 0a20 2020 Color modes,. │ │ │ │ │ -0000c530: 2020 7061 6c65 7474 6573 2077 696c 6c20 palettes will │ │ │ │ │ -0000c540: 6265 2072 6561 6420 6672 6f6d 2068 6172 be read from har │ │ │ │ │ -0000c550: 6477 6172 652e 2020 436f 6c6f 7220 7661 dware. Color va │ │ │ │ │ -0000c560: 6c75 6573 2077 696c 6c20 6265 0a20 2020 lues will be. │ │ │ │ │ -0000c570: 2020 636f 6e76 6572 7465 6420 746f 2073 converted to s │ │ │ │ │ -0000c580: 7569 7420 7374 7275 6374 7572 6520 666f uit structure fo │ │ │ │ │ -0000c590: 726d 6174 2e20 2027 7374 6172 7427 2077 rmat. 'start' w │ │ │ │ │ -0000c5a0: 696c 6c20 7465 6c6c 2077 6861 740a 2020 ill tell what. │ │ │ │ │ -0000c5b0: 2020 2068 6172 6477 6172 6520 636f 6c6f hardware colo │ │ │ │ │ -0000c5c0: 7220 696e 6465 7820 286f 7220 656d 756c r index (or emul │ │ │ │ │ -0000c5d0: 6174 6564 2063 6f6c 6f72 2069 6e64 6578 ated color index │ │ │ │ │ -0000c5e0: 2920 7769 6c6c 2062 6520 7573 6564 2061 ) will be used a │ │ │ │ │ -0000c5f0: 7320 610a 2020 2020 2073 6f75 7263 6520 s a. source │ │ │ │ │ -0000c600: 666f 7220 6669 7273 7420 696e 6469 6365 for first indice │ │ │ │ │ -0000c610: 206f 6620 2770 616c 6574 7465 5f64 6174 of 'palette_dat │ │ │ │ │ -0000c620: 6127 2c20 6166 7465 7220 7468 6174 2062 a', after that b │ │ │ │ │ -0000c630: 6f74 6820 6861 7264 7761 7265 0a20 2020 oth hardware. │ │ │ │ │ -0000c640: 2020 636f 6c6f 7220 696e 6465 7820 616e color index an │ │ │ │ │ -0000c650: 6420 2770 616c 6574 7465 5f64 6174 6127 d 'palette_data' │ │ │ │ │ -0000c660: 2069 6e64 6578 2077 696c 6c20 6265 2069 index will be i │ │ │ │ │ -0000c670: 6e63 7265 6d65 6e74 6564 2075 6e74 696c ncremented until │ │ │ │ │ -0000c680: 0a20 2020 2020 2763 6f75 6e74 2720 6e75 . 'count' nu │ │ │ │ │ -0000c690: 6d62 6572 206f 6620 636f 6c6f 7273 2068 mber of colors h │ │ │ │ │ -0000c6a0: 6176 6520 6265 656e 2072 6561 642e 0a0a ave been read... │ │ │ │ │ -0000c6b0: 3130 2e31 2e37 2067 7275 625f 7669 6465 10.1.7 grub_vide │ │ │ │ │ -0000c6c0: 6f5f 7365 745f 6172 6561 5f73 7461 7475 o_set_area_statu │ │ │ │ │ -0000c6d0: 730a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d s.-------------- │ │ │ │ │ +0000c2a0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2020 2a20 ---------.. * │ │ │ │ │ +0000c2b0: 5072 6f74 6f74 7970 653a 0a0a 2020 2020 Prototype:.. │ │ │ │ │ +0000c2c0: 2020 2020 2020 6772 7562 5f65 7272 5f74 grub_err_t │ │ │ │ │ +0000c2d0: 0a20 2020 2020 2020 2020 2067 7275 625f . grub_ │ │ │ │ │ +0000c2e0: 7669 6465 6f5f 6765 745f 7061 6c65 7474 video_get_palett │ │ │ │ │ +0000c2f0: 6520 2875 6e73 6967 6e65 6420 696e 7420 e (unsigned int │ │ │ │ │ +0000c300: 7374 6172 742c 2075 6e73 6967 6e65 6420 start, unsigned │ │ │ │ │ +0000c310: 696e 7420 636f 756e 742c 2073 7472 7563 int count, struc │ │ │ │ │ +0000c320: 7420 6772 7562 5f76 6964 656f 5f70 616c t grub_video_pal │ │ │ │ │ +0000c330: 6574 7465 5f64 6174 6120 2a70 616c 6574 ette_data *palet │ │ │ │ │ +0000c340: 7465 5f64 6174 6129 3b0a 2020 2020 2020 te_data);. │ │ │ │ │ +0000c350: 2020 2020 7374 7275 6374 2067 7275 625f struct grub_ │ │ │ │ │ +0000c360: 7669 6465 6f5f 7061 6c65 7474 655f 6461 video_palette_da │ │ │ │ │ +0000c370: 7461 0a20 2020 2020 2020 2020 207b 0a20 ta. {. │ │ │ │ │ +0000c380: 2020 2020 2020 2020 2020 2020 2067 7275 gru │ │ │ │ │ +0000c390: 625f 7569 6e74 385f 7420 723b 202f 2a20 b_uint8_t r; /* │ │ │ │ │ +0000c3a0: 5265 6420 636f 6c6f 7220 7661 6c75 6520 Red color value │ │ │ │ │ +0000c3b0: 2830 2d32 3535 292e 202a 2f0a 2020 2020 (0-255). */. │ │ │ │ │ +0000c3c0: 2020 2020 2020 2020 2020 6772 7562 5f75 grub_u │ │ │ │ │ +0000c3d0: 696e 7438 5f74 2067 3b20 2f2a 2047 7265 int8_t g; /* Gre │ │ │ │ │ +0000c3e0: 656e 2063 6f6c 6f72 2076 616c 7565 2028 en color value ( │ │ │ │ │ +0000c3f0: 302d 3235 3529 2e20 2a2f 0a20 2020 2020 0-255). */. │ │ │ │ │ +0000c400: 2020 2020 2020 2020 2067 7275 625f 7569 grub_ui │ │ │ │ │ +0000c410: 6e74 385f 7420 623b 202f 2a20 426c 7565 nt8_t b; /* Blue │ │ │ │ │ +0000c420: 2063 6f6c 6f72 2076 616c 7565 2028 302d color value (0- │ │ │ │ │ +0000c430: 3235 3529 2e20 2a2f 0a20 2020 2020 2020 255). */. │ │ │ │ │ +0000c440: 2020 2020 2020 2067 7275 625f 7569 6e74 grub_uint │ │ │ │ │ +0000c450: 385f 7420 613b 202f 2a20 5265 7365 7276 8_t a; /* Reserv │ │ │ │ │ +0000c460: 6564 2062 6974 7320 7661 6c75 6520 2830 ed bits value (0 │ │ │ │ │ +0000c470: 2d32 3535 292e 202a 2f0a 2020 2020 2020 -255). */. │ │ │ │ │ +0000c480: 2020 2020 7d3b 0a20 2020 2a20 4465 7363 };. * Desc │ │ │ │ │ +0000c490: 7269 7074 696f 6e3a 0a0a 2020 2020 2055 ription:.. U │ │ │ │ │ +0000c4a0: 7365 6420 746f 2071 7565 7279 2069 6e64 sed to query ind │ │ │ │ │ +0000c4b0: 6578 6564 2063 6f6c 6f72 2070 616c 6574 exed color palet │ │ │ │ │ +0000c4c0: 7465 732e 2020 4966 206d 6f64 6520 6973 tes. If mode is │ │ │ │ │ +0000c4d0: 2052 4742 206d 6f64 652c 2063 6f6c 6f72 RGB mode, color │ │ │ │ │ +0000c4e0: 730a 2020 2020 2077 696c 6c20 6265 2063 s. will be c │ │ │ │ │ +0000c4f0: 6f70 6965 6420 6672 6f6d 2065 6d75 6c61 opied from emula │ │ │ │ │ +0000c500: 7465 6420 7061 6c65 7474 6520 6461 7461 ted palette data │ │ │ │ │ +0000c510: 2e20 2049 6e20 496e 6465 7865 6420 436f . In Indexed Co │ │ │ │ │ +0000c520: 6c6f 7220 6d6f 6465 732c 0a20 2020 2020 lor modes,. │ │ │ │ │ +0000c530: 7061 6c65 7474 6573 2077 696c 6c20 6265 palettes will be │ │ │ │ │ +0000c540: 2072 6561 6420 6672 6f6d 2068 6172 6477 read from hardw │ │ │ │ │ +0000c550: 6172 652e 2020 436f 6c6f 7220 7661 6c75 are. Color valu │ │ │ │ │ +0000c560: 6573 2077 696c 6c20 6265 0a20 2020 2020 es will be. │ │ │ │ │ +0000c570: 636f 6e76 6572 7465 6420 746f 2073 7569 converted to sui │ │ │ │ │ +0000c580: 7420 7374 7275 6374 7572 6520 666f 726d t structure form │ │ │ │ │ +0000c590: 6174 2e20 2027 7374 6172 7427 2077 696c at. 'start' wil │ │ │ │ │ +0000c5a0: 6c20 7465 6c6c 2077 6861 740a 2020 2020 l tell what. │ │ │ │ │ +0000c5b0: 2068 6172 6477 6172 6520 636f 6c6f 7220 hardware color │ │ │ │ │ +0000c5c0: 696e 6465 7820 286f 7220 656d 756c 6174 index (or emulat │ │ │ │ │ +0000c5d0: 6564 2063 6f6c 6f72 2069 6e64 6578 2920 ed color index) │ │ │ │ │ +0000c5e0: 7769 6c6c 2062 6520 7573 6564 2061 7320 will be used as │ │ │ │ │ +0000c5f0: 610a 2020 2020 2073 6f75 7263 6520 666f a. source fo │ │ │ │ │ +0000c600: 7220 6669 7273 7420 696e 6469 6365 206f r first indice o │ │ │ │ │ +0000c610: 6620 2770 616c 6574 7465 5f64 6174 6127 f 'palette_data' │ │ │ │ │ +0000c620: 2c20 6166 7465 7220 7468 6174 2062 6f74 , after that bot │ │ │ │ │ +0000c630: 6820 6861 7264 7761 7265 0a20 2020 2020 h hardware. │ │ │ │ │ +0000c640: 636f 6c6f 7220 696e 6465 7820 616e 6420 color index and │ │ │ │ │ +0000c650: 2770 616c 6574 7465 5f64 6174 6127 2069 'palette_data' i │ │ │ │ │ +0000c660: 6e64 6578 2077 696c 6c20 6265 2069 6e63 ndex will be inc │ │ │ │ │ +0000c670: 7265 6d65 6e74 6564 2075 6e74 696c 0a20 remented until. │ │ │ │ │ +0000c680: 2020 2020 2763 6f75 6e74 2720 6e75 6d62 'count' numb │ │ │ │ │ +0000c690: 6572 206f 6620 636f 6c6f 7273 2068 6176 er of colors hav │ │ │ │ │ +0000c6a0: 6520 6265 656e 2072 6561 642e 0a0a 3130 e been read...10 │ │ │ │ │ +0000c6b0: 2e31 2e37 2067 7275 625f 7669 6465 6f5f .1.7 grub_video_ │ │ │ │ │ +0000c6c0: 7365 745f 6172 6561 5f73 7461 7475 730a set_area_status. │ │ │ │ │ +0000c6d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 0000c6e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000c6f0: 2d2d 2d0a 0a20 2020 2a20 5072 6f74 6f74 ---.. * Protot │ │ │ │ │ -0000c700: 7970 653a 0a20 2020 2020 2020 2020 2067 ype:. g │ │ │ │ │ -0000c710: 7275 625f 6572 725f 740a 2020 2020 2020 rub_err_t. │ │ │ │ │ -0000c720: 2020 2020 6772 7562 5f76 6964 656f 5f73 grub_video_s │ │ │ │ │ -0000c730: 6574 5f61 7265 615f 7374 6174 7573 2028 et_area_status ( │ │ │ │ │ -0000c740: 6772 7562 5f76 6964 656f 5f61 7265 615f grub_video_area_ │ │ │ │ │ -0000c750: 7374 6174 7573 5f74 2061 7265 615f 7374 status_t area_st │ │ │ │ │ -0000c760: 6174 7573 293b 0a20 2020 2020 2020 2020 atus);. │ │ │ │ │ -0000c770: 2065 6e75 6d20 6772 7562 5f76 6964 656f enum grub_video │ │ │ │ │ -0000c780: 5f61 7265 615f 7374 6174 7573 5f74 0a20 _area_status_t. │ │ │ │ │ -0000c790: 2020 2020 2020 2020 2020 207b 0a20 2020 {. │ │ │ │ │ -0000c7a0: 2020 2020 2020 2020 2020 2047 5255 425f GRUB_ │ │ │ │ │ -0000c7b0: 5649 4445 4f5f 4152 4541 5f44 4953 4142 VIDEO_AREA_DISAB │ │ │ │ │ -0000c7c0: 4c45 442c 0a20 2020 2020 2020 2020 2020 LED,. │ │ │ │ │ -0000c7d0: 2020 2047 5255 425f 5649 4445 4f5f 4152 GRUB_VIDEO_AR │ │ │ │ │ -0000c7e0: 4541 5f45 4e41 424c 4544 0a20 2020 2020 EA_ENABLED. │ │ │ │ │ -0000c7f0: 2020 2020 2020 207d 3b0a 0a20 2020 2a20 };.. * │ │ │ │ │ -0000c800: 4465 7363 7269 7074 696f 6e3a 0a0a 2020 Description:.. │ │ │ │ │ -0000c810: 2020 2055 7365 6420 746f 2073 6574 2061 Used to set a │ │ │ │ │ -0000c820: 7265 6120 6472 6177 696e 6720 6d6f 6465 rea drawing mode │ │ │ │ │ -0000c830: 2066 6f72 2072 6564 7261 7769 6e67 2074 for redrawing t │ │ │ │ │ -0000c840: 6865 2073 7065 6369 6669 6564 2072 6567 he specified reg │ │ │ │ │ -0000c850: 696f 6e2e 0a20 2020 2020 4472 6177 2063 ion.. Draw c │ │ │ │ │ -0000c860: 6f6d 6d61 6e64 7320 6172 6520 7065 7266 ommands are perf │ │ │ │ │ -0000c870: 6f72 6d65 6420 696e 2074 6865 2069 6e74 ormed in the int │ │ │ │ │ -0000c880: 6572 7365 6374 696f 6e20 6f66 2074 6865 ersection of the │ │ │ │ │ -0000c890: 2076 6965 7770 6f72 7420 616e 640a 2020 viewport and. │ │ │ │ │ -0000c8a0: 2020 2074 6865 2072 6567 696f 6e20 6361 the region ca │ │ │ │ │ -0000c8b0: 6c6c 6564 2061 7265 612e 2020 436f 6f72 lled area. Coor │ │ │ │ │ -0000c8c0: 6469 6e61 7465 7320 7265 6d61 696e 2072 dinates remain r │ │ │ │ │ -0000c8d0: 656c 6174 6564 2074 6f20 7468 650a 2020 elated to the. │ │ │ │ │ -0000c8e0: 2020 2076 6965 7770 6f72 742e 2020 4966 viewport. If │ │ │ │ │ -0000c8f0: 2064 7261 7720 636f 6d6d 616e 6473 2074 draw commands t │ │ │ │ │ -0000c900: 7279 2074 6f20 6472 6177 206f 7665 7220 ry to draw over │ │ │ │ │ -0000c910: 7468 6520 6172 6561 2c20 7468 6579 2061 the area, they a │ │ │ │ │ -0000c920: 7265 0a20 2020 2020 636c 6970 7065 642e re. clipped. │ │ │ │ │ -0000c930: 2020 5365 7420 7374 6174 7573 2074 6f20 Set status to │ │ │ │ │ -0000c940: 4449 5341 424c 4544 2069 6620 796f 7520 DISABLED if you │ │ │ │ │ -0000c950: 6e65 6564 2074 6f20 6472 6177 2065 7665 need to draw eve │ │ │ │ │ -0000c960: 7279 7468 696e 672e 0a20 2020 2020 5365 rything.. Se │ │ │ │ │ -0000c970: 7420 7374 6174 7573 2074 6f20 454e 4142 t status to ENAB │ │ │ │ │ -0000c980: 4c45 4420 616e 6420 7265 6769 6f6e 2074 LED and region t │ │ │ │ │ -0000c990: 6f20 7468 6520 6465 7369 7265 6420 7265 o the desired re │ │ │ │ │ -0000c9a0: 6374 616e 676c 6520 746f 2072 6564 7261 ctangle to redra │ │ │ │ │ -0000c9b0: 770a 2020 2020 2065 7665 7279 7468 696e w. everythin │ │ │ │ │ -0000c9c0: 6720 696e 7369 6465 2074 6865 2072 6567 g inside the reg │ │ │ │ │ -0000c9d0: 696f 6e20 6c65 6176 696e 6720 6576 6572 ion leaving ever │ │ │ │ │ -0000c9e0: 7974 6869 6e67 2065 6c73 6520 696e 7461 ything else inta │ │ │ │ │ -0000c9f0: 6374 2e0a 2020 2020 2053 686f 756c 6420 ct.. Should │ │ │ │ │ -0000ca00: 6265 2075 7365 6420 666f 7220 7265 6472 be used for redr │ │ │ │ │ -0000ca10: 6177 696e 6720 6f66 2061 6374 6976 6520 awing of active │ │ │ │ │ -0000ca20: 656c 656d 656e 7473 2e0a 0a31 302e 312e elements...10.1. │ │ │ │ │ -0000ca30: 3820 6772 7562 5f76 6964 656f 5f67 6574 8 grub_video_get │ │ │ │ │ -0000ca40: 5f61 7265 615f 7374 6174 7573 0a2d 2d2d _area_status.--- │ │ │ │ │ +0000c6f0: 2d0a 0a20 2020 2a20 5072 6f74 6f74 7970 -.. * Prototyp │ │ │ │ │ +0000c700: 653a 0a20 2020 2020 2020 2020 2067 7275 e:. gru │ │ │ │ │ +0000c710: 625f 6572 725f 740a 2020 2020 2020 2020 b_err_t. │ │ │ │ │ +0000c720: 2020 6772 7562 5f76 6964 656f 5f73 6574 grub_video_set │ │ │ │ │ +0000c730: 5f61 7265 615f 7374 6174 7573 2028 6772 _area_status (gr │ │ │ │ │ +0000c740: 7562 5f76 6964 656f 5f61 7265 615f 7374 ub_video_area_st │ │ │ │ │ +0000c750: 6174 7573 5f74 2061 7265 615f 7374 6174 atus_t area_stat │ │ │ │ │ +0000c760: 7573 293b 0a20 2020 2020 2020 2020 2065 us);. e │ │ │ │ │ +0000c770: 6e75 6d20 6772 7562 5f76 6964 656f 5f61 num grub_video_a │ │ │ │ │ +0000c780: 7265 615f 7374 6174 7573 5f74 0a20 2020 rea_status_t. │ │ │ │ │ +0000c790: 2020 2020 2020 2020 207b 0a20 2020 2020 {. │ │ │ │ │ +0000c7a0: 2020 2020 2020 2020 2047 5255 425f 5649 GRUB_VI │ │ │ │ │ +0000c7b0: 4445 4f5f 4152 4541 5f44 4953 4142 4c45 DEO_AREA_DISABLE │ │ │ │ │ +0000c7c0: 442c 0a20 2020 2020 2020 2020 2020 2020 D,. │ │ │ │ │ +0000c7d0: 2047 5255 425f 5649 4445 4f5f 4152 4541 GRUB_VIDEO_AREA │ │ │ │ │ +0000c7e0: 5f45 4e41 424c 4544 0a20 2020 2020 2020 _ENABLED. │ │ │ │ │ +0000c7f0: 2020 2020 207d 3b0a 0a20 2020 2a20 4465 };.. * De │ │ │ │ │ +0000c800: 7363 7269 7074 696f 6e3a 0a0a 2020 2020 scription:.. │ │ │ │ │ +0000c810: 2055 7365 6420 746f 2073 6574 2061 7265 Used to set are │ │ │ │ │ +0000c820: 6120 6472 6177 696e 6720 6d6f 6465 2066 a drawing mode f │ │ │ │ │ +0000c830: 6f72 2072 6564 7261 7769 6e67 2074 6865 or redrawing the │ │ │ │ │ +0000c840: 2073 7065 6369 6669 6564 2072 6567 696f specified regio │ │ │ │ │ +0000c850: 6e2e 0a20 2020 2020 4472 6177 2063 6f6d n.. Draw com │ │ │ │ │ +0000c860: 6d61 6e64 7320 6172 6520 7065 7266 6f72 mands are perfor │ │ │ │ │ +0000c870: 6d65 6420 696e 2074 6865 2069 6e74 6572 med in the inter │ │ │ │ │ +0000c880: 7365 6374 696f 6e20 6f66 2074 6865 2076 section of the v │ │ │ │ │ +0000c890: 6965 7770 6f72 7420 616e 640a 2020 2020 iewport and. │ │ │ │ │ +0000c8a0: 2074 6865 2072 6567 696f 6e20 6361 6c6c the region call │ │ │ │ │ +0000c8b0: 6564 2061 7265 612e 2020 436f 6f72 6469 ed area. Coordi │ │ │ │ │ +0000c8c0: 6e61 7465 7320 7265 6d61 696e 2072 656c nates remain rel │ │ │ │ │ +0000c8d0: 6174 6564 2074 6f20 7468 650a 2020 2020 ated to the. │ │ │ │ │ +0000c8e0: 2076 6965 7770 6f72 742e 2020 4966 2064 viewport. If d │ │ │ │ │ +0000c8f0: 7261 7720 636f 6d6d 616e 6473 2074 7279 raw commands try │ │ │ │ │ +0000c900: 2074 6f20 6472 6177 206f 7665 7220 7468 to draw over th │ │ │ │ │ +0000c910: 6520 6172 6561 2c20 7468 6579 2061 7265 e area, they are │ │ │ │ │ +0000c920: 0a20 2020 2020 636c 6970 7065 642e 2020 . clipped. │ │ │ │ │ +0000c930: 5365 7420 7374 6174 7573 2074 6f20 4449 Set status to DI │ │ │ │ │ +0000c940: 5341 424c 4544 2069 6620 796f 7520 6e65 SABLED if you ne │ │ │ │ │ +0000c950: 6564 2074 6f20 6472 6177 2065 7665 7279 ed to draw every │ │ │ │ │ +0000c960: 7468 696e 672e 0a20 2020 2020 5365 7420 thing.. Set │ │ │ │ │ +0000c970: 7374 6174 7573 2074 6f20 454e 4142 4c45 status to ENABLE │ │ │ │ │ +0000c980: 4420 616e 6420 7265 6769 6f6e 2074 6f20 D and region to │ │ │ │ │ +0000c990: 7468 6520 6465 7369 7265 6420 7265 6374 the desired rect │ │ │ │ │ +0000c9a0: 616e 676c 6520 746f 2072 6564 7261 770a angle to redraw. │ │ │ │ │ +0000c9b0: 2020 2020 2065 7665 7279 7468 696e 6720 everything │ │ │ │ │ +0000c9c0: 696e 7369 6465 2074 6865 2072 6567 696f inside the regio │ │ │ │ │ +0000c9d0: 6e20 6c65 6176 696e 6720 6576 6572 7974 n leaving everyt │ │ │ │ │ +0000c9e0: 6869 6e67 2065 6c73 6520 696e 7461 6374 hing else intact │ │ │ │ │ +0000c9f0: 2e0a 2020 2020 2053 686f 756c 6420 6265 .. Should be │ │ │ │ │ +0000ca00: 2075 7365 6420 666f 7220 7265 6472 6177 used for redraw │ │ │ │ │ +0000ca10: 696e 6720 6f66 2061 6374 6976 6520 656c ing of active el │ │ │ │ │ +0000ca20: 656d 656e 7473 2e0a 0a31 302e 312e 3820 ements...10.1.8 │ │ │ │ │ +0000ca30: 6772 7562 5f76 6964 656f 5f67 6574 5f61 grub_video_get_a │ │ │ │ │ +0000ca40: 7265 615f 7374 6174 7573 0a2d 2d2d 2d2d rea_status.----- │ │ │ │ │ 0000ca50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000ca60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ -0000ca70: 2020 202a 2050 726f 746f 7479 7065 3a0a * Prototype:. │ │ │ │ │ -0000ca80: 2020 2020 2020 2020 2020 6772 7562 5f65 grub_e │ │ │ │ │ -0000ca90: 7272 5f72 0a20 2020 2020 2020 2020 2067 rr_r. g │ │ │ │ │ -0000caa0: 7275 625f 7669 6465 6f5f 6765 745f 6172 rub_video_get_ar │ │ │ │ │ -0000cab0: 6561 5f73 7461 7475 7320 2867 7275 625f ea_status (grub_ │ │ │ │ │ -0000cac0: 7669 6465 6f5f 6172 6561 5f73 7461 7475 video_area_statu │ │ │ │ │ -0000cad0: 735f 7420 2a61 7265 615f 7374 6174 7573 s_t *area_status │ │ │ │ │ -0000cae0: 293b 0a0a 2020 202a 2044 6573 6372 6970 );.. * Descrip │ │ │ │ │ -0000caf0: 7469 6f6e 3a20 5573 6564 2074 6f20 7175 tion: Used to qu │ │ │ │ │ -0000cb00: 6572 7920 7468 6520 6172 6561 2073 7461 ery the area sta │ │ │ │ │ -0000cb10: 7475 732e 0a0a 3130 2e31 2e39 2067 7275 tus...10.1.9 gru │ │ │ │ │ -0000cb20: 625f 7669 6465 6f5f 7365 745f 7669 6577 b_video_set_view │ │ │ │ │ -0000cb30: 706f 7274 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d port.----------- │ │ │ │ │ +0000ca60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2020 ------------.. │ │ │ │ │ +0000ca70: 202a 2050 726f 746f 7479 7065 3a0a 2020 * Prototype:. │ │ │ │ │ +0000ca80: 2020 2020 2020 2020 6772 7562 5f65 7272 grub_err │ │ │ │ │ +0000ca90: 5f72 0a20 2020 2020 2020 2020 2067 7275 _r. gru │ │ │ │ │ +0000caa0: 625f 7669 6465 6f5f 6765 745f 6172 6561 b_video_get_area │ │ │ │ │ +0000cab0: 5f73 7461 7475 7320 2867 7275 625f 7669 _status (grub_vi │ │ │ │ │ +0000cac0: 6465 6f5f 6172 6561 5f73 7461 7475 735f deo_area_status_ │ │ │ │ │ +0000cad0: 7420 2a61 7265 615f 7374 6174 7573 293b t *area_status); │ │ │ │ │ +0000cae0: 0a0a 2020 202a 2044 6573 6372 6970 7469 .. * Descripti │ │ │ │ │ +0000caf0: 6f6e 3a20 5573 6564 2074 6f20 7175 6572 on: Used to quer │ │ │ │ │ +0000cb00: 7920 7468 6520 6172 6561 2073 7461 7475 y the area statu │ │ │ │ │ +0000cb10: 732e 0a0a 3130 2e31 2e39 2067 7275 625f s...10.1.9 grub_ │ │ │ │ │ +0000cb20: 7669 6465 6f5f 7365 745f 7669 6577 706f video_set_viewpo │ │ │ │ │ +0000cb30: 7274 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d rt.------------- │ │ │ │ │ 0000cb40: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000cb50: 2d2d 2d0a 0a20 2020 2a20 5072 6f74 6f74 ---.. * Protot │ │ │ │ │ -0000cb60: 7970 653a 0a0a 2020 2020 2020 2020 2020 ype:.. │ │ │ │ │ -0000cb70: 6772 7562 5f65 7272 5f74 0a20 2020 2020 grub_err_t. │ │ │ │ │ -0000cb80: 2020 2020 2067 7275 625f 7669 6465 6f5f grub_video_ │ │ │ │ │ -0000cb90: 7365 745f 7669 6577 706f 7274 2028 756e set_viewport (un │ │ │ │ │ -0000cba0: 7369 676e 6564 2069 6e74 2078 2c20 756e signed int x, un │ │ │ │ │ -0000cbb0: 7369 676e 6564 2069 6e74 2079 2c20 756e signed int y, un │ │ │ │ │ -0000cbc0: 7369 676e 6564 2069 6e74 2077 6964 7468 signed int width │ │ │ │ │ -0000cbd0: 2c20 756e 7369 676e 6564 2069 6e74 2068 , unsigned int h │ │ │ │ │ -0000cbe0: 6569 6768 7429 3b0a 2020 202a 2044 6573 eight);. * Des │ │ │ │ │ -0000cbf0: 6372 6970 7469 6f6e 3a0a 0a20 2020 2020 cription:.. │ │ │ │ │ -0000cc00: 5573 6564 2074 6f20 7370 6563 6966 7920 Used to specify │ │ │ │ │ -0000cc10: 7669 6577 706f 7274 2077 6865 7265 2064 viewport where d │ │ │ │ │ -0000cc20: 7261 7720 636f 6d6d 616e 6473 2061 7265 raw commands are │ │ │ │ │ -0000cc30: 2070 6572 666f 726d 6564 2e20 2057 6865 performed. Whe │ │ │ │ │ -0000cc40: 6e0a 2020 2020 2076 6965 7770 6f72 7420 n. viewport │ │ │ │ │ -0000cc50: 6973 2073 6574 2c20 616c 6c20 6472 6177 is set, all draw │ │ │ │ │ -0000cc60: 2063 6f6d 6d61 6e64 7320 636f 6f72 6469 commands coordi │ │ │ │ │ -0000cc70: 6e61 7465 7320 7265 6c61 7465 2074 6f20 nates relate to │ │ │ │ │ -0000cc80: 7468 6f73 650a 2020 2020 2073 7065 6369 those. speci │ │ │ │ │ -0000cc90: 6669 6564 2062 7920 2778 2720 616e 6420 fied by 'x' and │ │ │ │ │ -0000cca0: 2779 272e 2020 4966 2064 7261 7720 636f 'y'. If draw co │ │ │ │ │ -0000ccb0: 6d6d 616e 6473 2074 7279 2074 6f20 6472 mmands try to dr │ │ │ │ │ -0000ccc0: 6177 206f 7665 720a 2020 2020 2076 6965 aw over. vie │ │ │ │ │ -0000ccd0: 7770 6f72 742c 2074 6865 7920 6172 6520 wport, they are │ │ │ │ │ -0000cce0: 636c 6970 7065 642e 2020 4966 2064 6576 clipped. If dev │ │ │ │ │ -0000ccf0: 656c 6f70 6572 2072 6571 7565 7374 7320 eloper requests │ │ │ │ │ -0000cd00: 6c61 7267 6572 2074 6861 6e0a 2020 2020 larger than. │ │ │ │ │ -0000cd10: 2070 6f73 7369 626c 6520 7669 6577 706f possible viewpo │ │ │ │ │ -0000cd20: 7274 2c20 7769 6474 6820 616e 6420 6865 rt, width and he │ │ │ │ │ -0000cd30: 6967 6874 2077 696c 6c20 6265 2063 6c61 ight will be cla │ │ │ │ │ -0000cd40: 6d70 6564 2074 6f20 6669 7420 7363 7265 mped to fit scre │ │ │ │ │ -0000cd50: 656e 2e0a 2020 2020 2049 6620 2778 2720 en.. If 'x' │ │ │ │ │ -0000cd60: 616e 6420 2779 2720 6172 6520 6f75 7420 and 'y' are out │ │ │ │ │ -0000cd70: 6f66 2062 6f75 6e64 732c 2061 6c6c 2066 of bounds, all f │ │ │ │ │ -0000cd80: 756e 6374 696f 6e73 2064 7261 7769 6e67 unctions drawing │ │ │ │ │ -0000cd90: 2074 6f20 7363 7265 656e 0a20 2020 2020 to screen. │ │ │ │ │ -0000cda0: 7769 6c6c 206e 6f74 2062 6520 6469 7370 will not be disp │ │ │ │ │ -0000cdb0: 6c61 7965 642e 2020 496e 206f 7264 6572 layed. In order │ │ │ │ │ -0000cdc0: 2074 6f20 6d61 7869 6d69 7a65 2076 6965 to maximize vie │ │ │ │ │ -0000cdd0: 7770 6f72 742c 2075 7365 0a20 2020 2020 wport, use. │ │ │ │ │ -0000cde0: 2767 7275 625f 7669 6465 6f5f 6765 745f 'grub_video_get_ │ │ │ │ │ -0000cdf0: 696e 666f 2720 746f 2071 7565 7279 2061 info' to query a │ │ │ │ │ -0000ce00: 6374 7561 6c20 7363 7265 656e 2064 696d ctual screen dim │ │ │ │ │ -0000ce10: 656e 7369 6f6e 7320 616e 6420 7072 6f76 ensions and prov │ │ │ │ │ -0000ce20: 6964 650a 2020 2020 2074 6861 7420 696e ide. that in │ │ │ │ │ -0000ce30: 666f 726d 6174 696f 6e20 746f 2074 6869 formation to thi │ │ │ │ │ -0000ce40: 7320 6675 6e63 7469 6f6e 2e0a 0a31 302e s function...10. │ │ │ │ │ -0000ce50: 312e 3130 2067 7275 625f 7669 6465 6f5f 1.10 grub_video_ │ │ │ │ │ -0000ce60: 6765 745f 7669 6577 706f 7274 0a2d 2d2d get_viewport.--- │ │ │ │ │ +0000cb50: 2d0a 0a20 2020 2a20 5072 6f74 6f74 7970 -.. * Prototyp │ │ │ │ │ +0000cb60: 653a 0a0a 2020 2020 2020 2020 2020 6772 e:.. gr │ │ │ │ │ +0000cb70: 7562 5f65 7272 5f74 0a20 2020 2020 2020 ub_err_t. │ │ │ │ │ +0000cb80: 2020 2067 7275 625f 7669 6465 6f5f 7365 grub_video_se │ │ │ │ │ +0000cb90: 745f 7669 6577 706f 7274 2028 756e 7369 t_viewport (unsi │ │ │ │ │ +0000cba0: 676e 6564 2069 6e74 2078 2c20 756e 7369 gned int x, unsi │ │ │ │ │ +0000cbb0: 676e 6564 2069 6e74 2079 2c20 756e 7369 gned int y, unsi │ │ │ │ │ +0000cbc0: 676e 6564 2069 6e74 2077 6964 7468 2c20 gned int width, │ │ │ │ │ +0000cbd0: 756e 7369 676e 6564 2069 6e74 2068 6569 unsigned int hei │ │ │ │ │ +0000cbe0: 6768 7429 3b0a 2020 202a 2044 6573 6372 ght);. * Descr │ │ │ │ │ +0000cbf0: 6970 7469 6f6e 3a0a 0a20 2020 2020 5573 iption:.. Us │ │ │ │ │ +0000cc00: 6564 2074 6f20 7370 6563 6966 7920 7669 ed to specify vi │ │ │ │ │ +0000cc10: 6577 706f 7274 2077 6865 7265 2064 7261 ewport where dra │ │ │ │ │ +0000cc20: 7720 636f 6d6d 616e 6473 2061 7265 2070 w commands are p │ │ │ │ │ +0000cc30: 6572 666f 726d 6564 2e20 2057 6865 6e0a erformed. When. │ │ │ │ │ +0000cc40: 2020 2020 2076 6965 7770 6f72 7420 6973 viewport is │ │ │ │ │ +0000cc50: 2073 6574 2c20 616c 6c20 6472 6177 2063 set, all draw c │ │ │ │ │ +0000cc60: 6f6d 6d61 6e64 7320 636f 6f72 6469 6e61 ommands coordina │ │ │ │ │ +0000cc70: 7465 7320 7265 6c61 7465 2074 6f20 7468 tes relate to th │ │ │ │ │ +0000cc80: 6f73 650a 2020 2020 2073 7065 6369 6669 ose. specifi │ │ │ │ │ +0000cc90: 6564 2062 7920 2778 2720 616e 6420 2779 ed by 'x' and 'y │ │ │ │ │ +0000cca0: 272e 2020 4966 2064 7261 7720 636f 6d6d '. If draw comm │ │ │ │ │ +0000ccb0: 616e 6473 2074 7279 2074 6f20 6472 6177 ands try to draw │ │ │ │ │ +0000ccc0: 206f 7665 720a 2020 2020 2076 6965 7770 over. viewp │ │ │ │ │ +0000ccd0: 6f72 742c 2074 6865 7920 6172 6520 636c ort, they are cl │ │ │ │ │ +0000cce0: 6970 7065 642e 2020 4966 2064 6576 656c ipped. If devel │ │ │ │ │ +0000ccf0: 6f70 6572 2072 6571 7565 7374 7320 6c61 oper requests la │ │ │ │ │ +0000cd00: 7267 6572 2074 6861 6e0a 2020 2020 2070 rger than. p │ │ │ │ │ +0000cd10: 6f73 7369 626c 6520 7669 6577 706f 7274 ossible viewport │ │ │ │ │ +0000cd20: 2c20 7769 6474 6820 616e 6420 6865 6967 , width and heig │ │ │ │ │ +0000cd30: 6874 2077 696c 6c20 6265 2063 6c61 6d70 ht will be clamp │ │ │ │ │ +0000cd40: 6564 2074 6f20 6669 7420 7363 7265 656e ed to fit screen │ │ │ │ │ +0000cd50: 2e0a 2020 2020 2049 6620 2778 2720 616e .. If 'x' an │ │ │ │ │ +0000cd60: 6420 2779 2720 6172 6520 6f75 7420 6f66 d 'y' are out of │ │ │ │ │ +0000cd70: 2062 6f75 6e64 732c 2061 6c6c 2066 756e bounds, all fun │ │ │ │ │ +0000cd80: 6374 696f 6e73 2064 7261 7769 6e67 2074 ctions drawing t │ │ │ │ │ +0000cd90: 6f20 7363 7265 656e 0a20 2020 2020 7769 o screen. wi │ │ │ │ │ +0000cda0: 6c6c 206e 6f74 2062 6520 6469 7370 6c61 ll not be displa │ │ │ │ │ +0000cdb0: 7965 642e 2020 496e 206f 7264 6572 2074 yed. In order t │ │ │ │ │ +0000cdc0: 6f20 6d61 7869 6d69 7a65 2076 6965 7770 o maximize viewp │ │ │ │ │ +0000cdd0: 6f72 742c 2075 7365 0a20 2020 2020 2767 ort, use. 'g │ │ │ │ │ +0000cde0: 7275 625f 7669 6465 6f5f 6765 745f 696e rub_video_get_in │ │ │ │ │ +0000cdf0: 666f 2720 746f 2071 7565 7279 2061 6374 fo' to query act │ │ │ │ │ +0000ce00: 7561 6c20 7363 7265 656e 2064 696d 656e ual screen dimen │ │ │ │ │ +0000ce10: 7369 6f6e 7320 616e 6420 7072 6f76 6964 sions and provid │ │ │ │ │ +0000ce20: 650a 2020 2020 2074 6861 7420 696e 666f e. that info │ │ │ │ │ +0000ce30: 726d 6174 696f 6e20 746f 2074 6869 7320 rmation to this │ │ │ │ │ +0000ce40: 6675 6e63 7469 6f6e 2e0a 0a31 302e 312e function...10.1. │ │ │ │ │ +0000ce50: 3130 2067 7275 625f 7669 6465 6f5f 6765 10 grub_video_ge │ │ │ │ │ +0000ce60: 745f 7669 6577 706f 7274 0a2d 2d2d 2d2d t_viewport.----- │ │ │ │ │ 0000ce70: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000ce80: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2020 ------------.. │ │ │ │ │ -0000ce90: 202a 2050 726f 746f 7479 7065 3a0a 0a20 * Prototype:.. │ │ │ │ │ -0000cea0: 2020 2020 2020 2020 2067 7275 625f 6572 grub_er │ │ │ │ │ -0000ceb0: 725f 740a 2020 2020 2020 2020 2020 6772 r_t. gr │ │ │ │ │ -0000cec0: 7562 5f76 6964 656f 5f67 6574 5f76 6965 ub_video_get_vie │ │ │ │ │ -0000ced0: 7770 6f72 7420 2875 6e73 6967 6e65 6420 wport (unsigned │ │ │ │ │ -0000cee0: 696e 7420 2a78 2c20 756e 7369 676e 6564 int *x, unsigned │ │ │ │ │ -0000cef0: 2069 6e74 202a 792c 2075 6e73 6967 6e65 int *y, unsigne │ │ │ │ │ -0000cf00: 6420 696e 7420 2a77 6964 7468 2c20 756e d int *width, un │ │ │ │ │ -0000cf10: 7369 676e 6564 2069 6e74 202a 6865 6967 signed int *heig │ │ │ │ │ -0000cf20: 6874 293b 0a20 2020 2a20 4465 7363 7269 ht);. * Descri │ │ │ │ │ -0000cf30: 7074 696f 6e3a 0a0a 2020 2020 2055 7365 ption:.. Use │ │ │ │ │ -0000cf40: 6420 746f 2071 7565 7279 2063 7572 7265 d to query curre │ │ │ │ │ -0000cf50: 6e74 2076 6965 7770 6f72 7420 6469 6d65 nt viewport dime │ │ │ │ │ -0000cf60: 6e73 696f 6e73 2e20 2053 6f66 7477 6172 nsions. Softwar │ │ │ │ │ -0000cf70: 6520 6465 7665 6c6f 7065 7220 6361 6e0a e developer can. │ │ │ │ │ -0000cf80: 2020 2020 2075 7365 2074 6869 7320 746f use this to │ │ │ │ │ -0000cf90: 2063 686f 6f73 6520 6265 7374 2077 6179 choose best way │ │ │ │ │ -0000cfa0: 2074 6f20 7265 6e64 6572 2063 6f6e 7465 to render conte │ │ │ │ │ -0000cfb0: 6e74 7320 6f66 2074 6865 2076 6965 7770 nts of the viewp │ │ │ │ │ -0000cfc0: 6f72 742e 0a0a 3130 2e31 2e31 3120 6772 ort...10.1.11 gr │ │ │ │ │ -0000cfd0: 7562 5f76 6964 656f 5f73 6574 5f72 6567 ub_video_set_reg │ │ │ │ │ -0000cfe0: 696f 6e0a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ion.------------ │ │ │ │ │ -0000cff0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000d000: 2d0a 0a20 2020 2a20 5072 6f74 6f74 7970 -.. * Prototyp │ │ │ │ │ -0000d010: 653a 0a0a 2020 2020 2020 2020 2020 6772 e:.. gr │ │ │ │ │ -0000d020: 7562 5f65 7272 5f74 0a20 2020 2020 2020 ub_err_t. │ │ │ │ │ -0000d030: 2020 2067 7275 625f 7669 6465 6f5f 7365 grub_video_se │ │ │ │ │ -0000d040: 745f 7265 6769 6f6e 2028 756e 7369 676e t_region (unsign │ │ │ │ │ -0000d050: 6564 2069 6e74 2078 2c20 756e 7369 676e ed int x, unsign │ │ │ │ │ -0000d060: 6564 2069 6e74 2079 2c20 756e 7369 676e ed int y, unsign │ │ │ │ │ -0000d070: 6564 2069 6e74 2077 6964 7468 2c20 756e ed int width, un │ │ │ │ │ -0000d080: 7369 676e 6564 2069 6e74 2068 6569 6768 signed int heigh │ │ │ │ │ -0000d090: 7429 3b0a 2020 202a 2044 6573 6372 6970 t);. * Descrip │ │ │ │ │ -0000d0a0: 7469 6f6e 3a0a 0a20 2020 2020 5573 6564 tion:.. Used │ │ │ │ │ -0000d0b0: 2074 6f20 7370 6563 6966 7920 7468 6520 to specify the │ │ │ │ │ -0000d0c0: 7265 6769 6f6e 206f 6620 7468 6520 7363 region of the sc │ │ │ │ │ -0000d0d0: 7265 656e 2077 6869 6368 2073 686f 756c reen which shoul │ │ │ │ │ -0000d0e0: 6420 6265 2072 6564 7261 776e 2e0a 2020 d be redrawn.. │ │ │ │ │ -0000d0f0: 2020 2055 7365 2061 6273 6f6c 7574 6520 Use absolute │ │ │ │ │ -0000d100: 7661 6c75 6573 2e20 2057 6865 6e20 7468 values. When th │ │ │ │ │ -0000d110: 6520 7265 6769 6f6e 2069 7320 7365 7420 e region is set │ │ │ │ │ -0000d120: 616e 6420 6172 6561 2073 7461 7475 7320 and area status │ │ │ │ │ -0000d130: 6973 0a20 2020 2020 454e 4142 4c45 2061 is. ENABLE a │ │ │ │ │ -0000d140: 6c6c 2064 7261 7720 636f 6d6d 616e 6473 ll draw commands │ │ │ │ │ -0000d150: 2077 696c 6c20 6265 2070 6572 666f 726d will be perform │ │ │ │ │ -0000d160: 6564 2069 6e73 6964 6520 7468 6520 696e ed inside the in │ │ │ │ │ -0000d170: 7465 7273 6570 7469 6f6e 0a20 2020 2020 terseption. │ │ │ │ │ -0000d180: 6f66 2072 6567 696f 6e20 616e 6420 7669 of region and vi │ │ │ │ │ -0000d190: 6577 706f 7274 206e 616d 6564 2061 7265 ewport named are │ │ │ │ │ -0000d1a0: 612e 2020 4966 2064 7261 7720 636f 6d6d a. If draw comm │ │ │ │ │ -0000d1b0: 616e 6473 2074 7279 2074 6f20 6472 6177 ands try to draw │ │ │ │ │ -0000d1c0: 0a20 2020 2020 6f76 6572 2076 6965 7770 . over viewp │ │ │ │ │ -0000d1d0: 6f72 742c 2074 6865 7920 6172 6520 636c ort, they are cl │ │ │ │ │ -0000d1e0: 6970 7065 642e 2020 4966 2064 6576 656c ipped. If devel │ │ │ │ │ -0000d1f0: 6f70 6572 2072 6571 7565 7374 7320 6c61 oper requests la │ │ │ │ │ -0000d200: 7267 6572 2074 6861 6e0a 2020 2020 2070 rger than. p │ │ │ │ │ -0000d210: 6f73 7369 626c 6520 7265 6769 6f6e 2c20 ossible region, │ │ │ │ │ -0000d220: 7769 6474 6820 616e 6420 6865 6967 6874 width and height │ │ │ │ │ -0000d230: 2077 696c 6c20 6265 2063 6c61 6d70 6564 will be clamped │ │ │ │ │ -0000d240: 2074 6f20 6669 7420 7363 7265 656e 2e0a to fit screen.. │ │ │ │ │ -0000d250: 2020 2020 2053 686f 756c 6420 6265 2075 Should be u │ │ │ │ │ -0000d260: 7365 6420 666f 7220 7265 6472 6177 696e sed for redrawin │ │ │ │ │ -0000d270: 6720 6f66 2061 6374 6976 6520 656c 656d g of active elem │ │ │ │ │ -0000d280: 656e 7473 2e0a 0a31 302e 312e 3132 2067 ents...10.1.12 g │ │ │ │ │ -0000d290: 7275 625f 7669 6465 6f5f 6765 745f 7265 rub_video_get_re │ │ │ │ │ -0000d2a0: 6769 6f6e 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d gion.----------- │ │ │ │ │ +0000ce80: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2020 202a ----------.. * │ │ │ │ │ +0000ce90: 2050 726f 746f 7479 7065 3a0a 0a20 2020 Prototype:.. │ │ │ │ │ +0000cea0: 2020 2020 2020 2067 7275 625f 6572 725f grub_err_ │ │ │ │ │ +0000ceb0: 740a 2020 2020 2020 2020 2020 6772 7562 t. grub │ │ │ │ │ +0000cec0: 5f76 6964 656f 5f67 6574 5f76 6965 7770 _video_get_viewp │ │ │ │ │ +0000ced0: 6f72 7420 2875 6e73 6967 6e65 6420 696e ort (unsigned in │ │ │ │ │ +0000cee0: 7420 2a78 2c20 756e 7369 676e 6564 2069 t *x, unsigned i │ │ │ │ │ +0000cef0: 6e74 202a 792c 2075 6e73 6967 6e65 6420 nt *y, unsigned │ │ │ │ │ +0000cf00: 696e 7420 2a77 6964 7468 2c20 756e 7369 int *width, unsi │ │ │ │ │ +0000cf10: 676e 6564 2069 6e74 202a 6865 6967 6874 gned int *height │ │ │ │ │ +0000cf20: 293b 0a20 2020 2a20 4465 7363 7269 7074 );. * Descript │ │ │ │ │ +0000cf30: 696f 6e3a 0a0a 2020 2020 2055 7365 6420 ion:.. Used │ │ │ │ │ +0000cf40: 746f 2071 7565 7279 2063 7572 7265 6e74 to query current │ │ │ │ │ +0000cf50: 2076 6965 7770 6f72 7420 6469 6d65 6e73 viewport dimens │ │ │ │ │ +0000cf60: 696f 6e73 2e20 2053 6f66 7477 6172 6520 ions. Software │ │ │ │ │ +0000cf70: 6465 7665 6c6f 7065 7220 6361 6e0a 2020 developer can. │ │ │ │ │ +0000cf80: 2020 2075 7365 2074 6869 7320 746f 2063 use this to c │ │ │ │ │ +0000cf90: 686f 6f73 6520 6265 7374 2077 6179 2074 hoose best way t │ │ │ │ │ +0000cfa0: 6f20 7265 6e64 6572 2063 6f6e 7465 6e74 o render content │ │ │ │ │ +0000cfb0: 7320 6f66 2074 6865 2076 6965 7770 6f72 s of the viewpor │ │ │ │ │ +0000cfc0: 742e 0a0a 3130 2e31 2e31 3120 6772 7562 t...10.1.11 grub │ │ │ │ │ +0000cfd0: 5f76 6964 656f 5f73 6574 5f72 6567 696f _video_set_regio │ │ │ │ │ +0000cfe0: 6e0a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d n.-------------- │ │ │ │ │ +0000cff0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ +0000d000: 0a20 2020 2a20 5072 6f74 6f74 7970 653a . * Prototype: │ │ │ │ │ +0000d010: 0a0a 2020 2020 2020 2020 2020 6772 7562 .. grub │ │ │ │ │ +0000d020: 5f65 7272 5f74 0a20 2020 2020 2020 2020 _err_t. │ │ │ │ │ +0000d030: 2067 7275 625f 7669 6465 6f5f 7365 745f grub_video_set_ │ │ │ │ │ +0000d040: 7265 6769 6f6e 2028 756e 7369 676e 6564 region (unsigned │ │ │ │ │ +0000d050: 2069 6e74 2078 2c20 756e 7369 676e 6564 int x, unsigned │ │ │ │ │ +0000d060: 2069 6e74 2079 2c20 756e 7369 676e 6564 int y, unsigned │ │ │ │ │ +0000d070: 2069 6e74 2077 6964 7468 2c20 756e 7369 int width, unsi │ │ │ │ │ +0000d080: 676e 6564 2069 6e74 2068 6569 6768 7429 gned int height) │ │ │ │ │ +0000d090: 3b0a 2020 202a 2044 6573 6372 6970 7469 ;. * Descripti │ │ │ │ │ +0000d0a0: 6f6e 3a0a 0a20 2020 2020 5573 6564 2074 on:.. Used t │ │ │ │ │ +0000d0b0: 6f20 7370 6563 6966 7920 7468 6520 7265 o specify the re │ │ │ │ │ +0000d0c0: 6769 6f6e 206f 6620 7468 6520 7363 7265 gion of the scre │ │ │ │ │ +0000d0d0: 656e 2077 6869 6368 2073 686f 756c 6420 en which should │ │ │ │ │ +0000d0e0: 6265 2072 6564 7261 776e 2e0a 2020 2020 be redrawn.. │ │ │ │ │ +0000d0f0: 2055 7365 2061 6273 6f6c 7574 6520 7661 Use absolute va │ │ │ │ │ +0000d100: 6c75 6573 2e20 2057 6865 6e20 7468 6520 lues. When the │ │ │ │ │ +0000d110: 7265 6769 6f6e 2069 7320 7365 7420 616e region is set an │ │ │ │ │ +0000d120: 6420 6172 6561 2073 7461 7475 7320 6973 d area status is │ │ │ │ │ +0000d130: 0a20 2020 2020 454e 4142 4c45 2061 6c6c . ENABLE all │ │ │ │ │ +0000d140: 2064 7261 7720 636f 6d6d 616e 6473 2077 draw commands w │ │ │ │ │ +0000d150: 696c 6c20 6265 2070 6572 666f 726d 6564 ill be performed │ │ │ │ │ +0000d160: 2069 6e73 6964 6520 7468 6520 696e 7465 inside the inte │ │ │ │ │ +0000d170: 7273 6570 7469 6f6e 0a20 2020 2020 6f66 rseption. of │ │ │ │ │ +0000d180: 2072 6567 696f 6e20 616e 6420 7669 6577 region and view │ │ │ │ │ +0000d190: 706f 7274 206e 616d 6564 2061 7265 612e port named area. │ │ │ │ │ +0000d1a0: 2020 4966 2064 7261 7720 636f 6d6d 616e If draw comman │ │ │ │ │ +0000d1b0: 6473 2074 7279 2074 6f20 6472 6177 0a20 ds try to draw. │ │ │ │ │ +0000d1c0: 2020 2020 6f76 6572 2076 6965 7770 6f72 over viewpor │ │ │ │ │ +0000d1d0: 742c 2074 6865 7920 6172 6520 636c 6970 t, they are clip │ │ │ │ │ +0000d1e0: 7065 642e 2020 4966 2064 6576 656c 6f70 ped. If develop │ │ │ │ │ +0000d1f0: 6572 2072 6571 7565 7374 7320 6c61 7267 er requests larg │ │ │ │ │ +0000d200: 6572 2074 6861 6e0a 2020 2020 2070 6f73 er than. pos │ │ │ │ │ +0000d210: 7369 626c 6520 7265 6769 6f6e 2c20 7769 sible region, wi │ │ │ │ │ +0000d220: 6474 6820 616e 6420 6865 6967 6874 2077 dth and height w │ │ │ │ │ +0000d230: 696c 6c20 6265 2063 6c61 6d70 6564 2074 ill be clamped t │ │ │ │ │ +0000d240: 6f20 6669 7420 7363 7265 656e 2e0a 2020 o fit screen.. │ │ │ │ │ +0000d250: 2020 2053 686f 756c 6420 6265 2075 7365 Should be use │ │ │ │ │ +0000d260: 6420 666f 7220 7265 6472 6177 696e 6720 d for redrawing │ │ │ │ │ +0000d270: 6f66 2061 6374 6976 6520 656c 656d 656e of active elemen │ │ │ │ │ +0000d280: 7473 2e0a 0a31 302e 312e 3132 2067 7275 ts...10.1.12 gru │ │ │ │ │ +0000d290: 625f 7669 6465 6f5f 6765 745f 7265 6769 b_video_get_regi │ │ │ │ │ +0000d2a0: 6f6e 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d on.------------- │ │ │ │ │ 0000d2b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000d2c0: 2d2d 0a0a 2020 202a 2050 726f 746f 7479 --.. * Prototy │ │ │ │ │ -0000d2d0: 7065 3a0a 0a20 2020 2020 2020 2020 2067 pe:.. g │ │ │ │ │ -0000d2e0: 7275 625f 6572 725f 740a 2020 2020 2020 rub_err_t. │ │ │ │ │ -0000d2f0: 2020 2020 6772 7562 5f76 6964 656f 5f67 grub_video_g │ │ │ │ │ -0000d300: 6574 5f72 6567 696f 6e20 2875 6e73 6967 et_region (unsig │ │ │ │ │ -0000d310: 6e65 6420 696e 7420 2a78 2c20 756e 7369 ned int *x, unsi │ │ │ │ │ -0000d320: 676e 6564 2069 6e74 202a 792c 2075 6e73 gned int *y, uns │ │ │ │ │ -0000d330: 6967 6e65 6420 696e 7420 2a77 6964 7468 igned int *width │ │ │ │ │ -0000d340: 2c20 756e 7369 676e 6564 2069 6e74 202a , unsigned int * │ │ │ │ │ -0000d350: 6865 6967 6874 293b 0a20 2020 2a20 4465 height);. * De │ │ │ │ │ -0000d360: 7363 7269 7074 696f 6e3a 0a0a 2020 2020 scription:.. │ │ │ │ │ -0000d370: 2055 7365 6420 746f 2071 7565 7279 2063 Used to query c │ │ │ │ │ -0000d380: 7572 7265 6e74 2072 6567 696f 6e20 6469 urrent region di │ │ │ │ │ -0000d390: 6d65 6e73 696f 6e73 2e0a 0a31 302e 312e mensions...10.1. │ │ │ │ │ -0000d3a0: 3133 2067 7275 625f 7669 6465 6f5f 6d61 13 grub_video_ma │ │ │ │ │ -0000d3b0: 705f 636f 6c6f 720a 2d2d 2d2d 2d2d 2d2d p_color.-------- │ │ │ │ │ +0000d2c0: 0a0a 2020 202a 2050 726f 746f 7479 7065 .. * Prototype │ │ │ │ │ +0000d2d0: 3a0a 0a20 2020 2020 2020 2020 2067 7275 :.. gru │ │ │ │ │ +0000d2e0: 625f 6572 725f 740a 2020 2020 2020 2020 b_err_t. │ │ │ │ │ +0000d2f0: 2020 6772 7562 5f76 6964 656f 5f67 6574 grub_video_get │ │ │ │ │ +0000d300: 5f72 6567 696f 6e20 2875 6e73 6967 6e65 _region (unsigne │ │ │ │ │ +0000d310: 6420 696e 7420 2a78 2c20 756e 7369 676e d int *x, unsign │ │ │ │ │ +0000d320: 6564 2069 6e74 202a 792c 2075 6e73 6967 ed int *y, unsig │ │ │ │ │ +0000d330: 6e65 6420 696e 7420 2a77 6964 7468 2c20 ned int *width, │ │ │ │ │ +0000d340: 756e 7369 676e 6564 2069 6e74 202a 6865 unsigned int *he │ │ │ │ │ +0000d350: 6967 6874 293b 0a20 2020 2a20 4465 7363 ight);. * Desc │ │ │ │ │ +0000d360: 7269 7074 696f 6e3a 0a0a 2020 2020 2055 ription:.. U │ │ │ │ │ +0000d370: 7365 6420 746f 2071 7565 7279 2063 7572 sed to query cur │ │ │ │ │ +0000d380: 7265 6e74 2072 6567 696f 6e20 6469 6d65 rent region dime │ │ │ │ │ +0000d390: 6e73 696f 6e73 2e0a 0a31 302e 312e 3133 nsions...10.1.13 │ │ │ │ │ +0000d3a0: 2067 7275 625f 7669 6465 6f5f 6d61 705f grub_video_map_ │ │ │ │ │ +0000d3b0: 636f 6c6f 720a 2d2d 2d2d 2d2d 2d2d 2d2d color.---------- │ │ │ │ │ 0000d3c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000d3d0: 2d2d 2d2d 0a0a 2020 202a 2050 726f 746f ----.. * Proto │ │ │ │ │ -0000d3e0: 7479 7065 3a0a 0a20 2020 2020 2020 2020 type:.. │ │ │ │ │ -0000d3f0: 2067 7275 625f 7669 6465 6f5f 636f 6c6f grub_video_colo │ │ │ │ │ -0000d400: 725f 740a 2020 2020 2020 2020 2020 6772 r_t. gr │ │ │ │ │ -0000d410: 7562 5f76 6964 656f 5f6d 6170 5f63 6f6c ub_video_map_col │ │ │ │ │ -0000d420: 6f72 2028 6772 7562 5f75 696e 7433 325f or (grub_uint32_ │ │ │ │ │ -0000d430: 7420 636f 6c6f 725f 6e61 6d65 293b 0a20 t color_name);. │ │ │ │ │ -0000d440: 2020 2a20 4465 7363 7269 7074 696f 6e3a * Description: │ │ │ │ │ -0000d450: 0a0a 2020 2020 204d 6170 2063 6f6c 6f72 .. Map color │ │ │ │ │ -0000d460: 2063 616e 2062 6520 7573 6564 2074 6f20 can be used to │ │ │ │ │ -0000d470: 7375 7070 6f72 7420 636f 6c6f 7220 7468 support color th │ │ │ │ │ -0000d480: 656d 6573 2069 6e20 4752 5542 2e20 5468 emes in GRUB. Th │ │ │ │ │ -0000d490: 6572 6520 7769 6c6c 0a20 2020 2020 6265 ere will. be │ │ │ │ │ -0000d4a0: 2063 6f6c 6c65 6374 696f 6e20 6f66 2063 collection of c │ │ │ │ │ -0000d4b0: 6f6c 6f72 206e 616d 6573 2074 6861 7420 olor names that │ │ │ │ │ -0000d4c0: 6361 6e20 6265 2075 7365 6420 746f 2071 can be used to q │ │ │ │ │ -0000d4d0: 7565 7279 2061 6374 7561 6c0a 2020 2020 uery actual. │ │ │ │ │ -0000d4e0: 2073 6372 6565 6e20 6d61 7070 6564 2063 screen mapped c │ │ │ │ │ -0000d4f0: 6f6c 6f72 2064 6174 612e 2020 4578 616d olor data. Exam │ │ │ │ │ -0000d500: 706c 6573 2063 6f75 6c64 2062 650a 2020 ples could be. │ │ │ │ │ -0000d510: 2020 2027 4752 5542 5f43 4f4c 4f52 5f43 'GRUB_COLOR_C │ │ │ │ │ -0000d520: 4f4e 534f 4c45 5f42 4143 4b47 524f 554e ONSOLE_BACKGROUN │ │ │ │ │ -0000d530: 4427 2c20 2747 5255 425f 434f 4c4f 525f D', 'GRUB_COLOR_ │ │ │ │ │ -0000d540: 434f 4e53 4f4c 455f 5445 5854 272e 2020 CONSOLE_TEXT'. │ │ │ │ │ -0000d550: 5468 650a 2020 2020 2061 6374 7561 6c20 The. actual │ │ │ │ │ -0000d560: 636f 6c6f 7220 6465 6669 6e65 7320 6172 color defines ar │ │ │ │ │ -0000d570: 6520 6e6f 7420 7370 6563 6966 6965 6420 e not specified │ │ │ │ │ -0000d580: 6174 2074 6869 7320 706f 696e 742e 0a0a at this point... │ │ │ │ │ -0000d590: 3130 2e31 2e31 3420 6772 7562 5f76 6964 10.1.14 grub_vid │ │ │ │ │ -0000d5a0: 656f 5f6d 6170 5f72 6762 0a2d 2d2d 2d2d eo_map_rgb.----- │ │ │ │ │ +0000d3d0: 2d2d 0a0a 2020 202a 2050 726f 746f 7479 --.. * Prototy │ │ │ │ │ +0000d3e0: 7065 3a0a 0a20 2020 2020 2020 2020 2067 pe:.. g │ │ │ │ │ +0000d3f0: 7275 625f 7669 6465 6f5f 636f 6c6f 725f rub_video_color_ │ │ │ │ │ +0000d400: 740a 2020 2020 2020 2020 2020 6772 7562 t. grub │ │ │ │ │ +0000d410: 5f76 6964 656f 5f6d 6170 5f63 6f6c 6f72 _video_map_color │ │ │ │ │ +0000d420: 2028 6772 7562 5f75 696e 7433 325f 7420 (grub_uint32_t │ │ │ │ │ +0000d430: 636f 6c6f 725f 6e61 6d65 293b 0a20 2020 color_name);. │ │ │ │ │ +0000d440: 2a20 4465 7363 7269 7074 696f 6e3a 0a0a * Description:.. │ │ │ │ │ +0000d450: 2020 2020 204d 6170 2063 6f6c 6f72 2063 Map color c │ │ │ │ │ +0000d460: 616e 2062 6520 7573 6564 2074 6f20 7375 an be used to su │ │ │ │ │ +0000d470: 7070 6f72 7420 636f 6c6f 7220 7468 656d pport color them │ │ │ │ │ +0000d480: 6573 2069 6e20 4752 5542 2e20 5468 6572 es in GRUB. Ther │ │ │ │ │ +0000d490: 6520 7769 6c6c 0a20 2020 2020 6265 2063 e will. be c │ │ │ │ │ +0000d4a0: 6f6c 6c65 6374 696f 6e20 6f66 2063 6f6c ollection of col │ │ │ │ │ +0000d4b0: 6f72 206e 616d 6573 2074 6861 7420 6361 or names that ca │ │ │ │ │ +0000d4c0: 6e20 6265 2075 7365 6420 746f 2071 7565 n be used to que │ │ │ │ │ +0000d4d0: 7279 2061 6374 7561 6c0a 2020 2020 2073 ry actual. s │ │ │ │ │ +0000d4e0: 6372 6565 6e20 6d61 7070 6564 2063 6f6c creen mapped col │ │ │ │ │ +0000d4f0: 6f72 2064 6174 612e 2020 4578 616d 706c or data. Exampl │ │ │ │ │ +0000d500: 6573 2063 6f75 6c64 2062 650a 2020 2020 es could be. │ │ │ │ │ +0000d510: 2027 4752 5542 5f43 4f4c 4f52 5f43 4f4e 'GRUB_COLOR_CON │ │ │ │ │ +0000d520: 534f 4c45 5f42 4143 4b47 524f 554e 4427 SOLE_BACKGROUND' │ │ │ │ │ +0000d530: 2c20 2747 5255 425f 434f 4c4f 525f 434f , 'GRUB_COLOR_CO │ │ │ │ │ +0000d540: 4e53 4f4c 455f 5445 5854 272e 2020 5468 NSOLE_TEXT'. Th │ │ │ │ │ +0000d550: 650a 2020 2020 2061 6374 7561 6c20 636f e. actual co │ │ │ │ │ +0000d560: 6c6f 7220 6465 6669 6e65 7320 6172 6520 lor defines are │ │ │ │ │ +0000d570: 6e6f 7420 7370 6563 6966 6965 6420 6174 not specified at │ │ │ │ │ +0000d580: 2074 6869 7320 706f 696e 742e 0a0a 3130 this point...10 │ │ │ │ │ +0000d590: 2e31 2e31 3420 6772 7562 5f76 6964 656f .1.14 grub_video │ │ │ │ │ +0000d5a0: 5f6d 6170 5f72 6762 0a2d 2d2d 2d2d 2d2d _map_rgb.------- │ │ │ │ │ 0000d5b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000d5c0: 2d2d 2d2d 2d0a 0a20 2020 2a20 5072 6f74 -----.. * Prot │ │ │ │ │ -0000d5d0: 6f74 7970 653a 0a0a 2020 2020 2020 2020 otype:.. │ │ │ │ │ -0000d5e0: 2020 6772 7562 5f76 6964 656f 5f63 6f6c grub_video_col │ │ │ │ │ -0000d5f0: 6f72 5f74 0a20 2020 2020 2020 2020 2067 or_t. g │ │ │ │ │ -0000d600: 7275 625f 7669 6465 6f5f 6d61 705f 7267 rub_video_map_rg │ │ │ │ │ -0000d610: 6220 2867 7275 625f 7569 6e74 385f 7420 b (grub_uint8_t │ │ │ │ │ -0000d620: 7265 642c 2067 7275 625f 7569 6e74 385f red, grub_uint8_ │ │ │ │ │ -0000d630: 7420 6772 6565 6e2c 2067 7275 625f 7569 t green, grub_ui │ │ │ │ │ -0000d640: 6e74 385f 7420 626c 7565 293b 0a20 2020 nt8_t blue);. │ │ │ │ │ -0000d650: 2a20 4465 7363 7269 7074 696f 6e3a 0a0a * Description:.. │ │ │ │ │ -0000d660: 2020 2020 204d 6170 2052 4742 2076 616c Map RGB val │ │ │ │ │ -0000d670: 7565 7320 746f 2063 6f6d 7061 7469 626c ues to compatibl │ │ │ │ │ -0000d680: 6520 7363 7265 656e 2063 6f6c 6f72 2064 e screen color d │ │ │ │ │ -0000d690: 6174 612e 2020 5661 6c75 6573 2061 7265 ata. Values are │ │ │ │ │ -0000d6a0: 0a20 2020 2020 6578 7065 6374 6564 2074 . expected t │ │ │ │ │ -0000d6b0: 6f20 6265 2069 6e20 7261 6e67 6520 302d o be in range 0- │ │ │ │ │ -0000d6c0: 3235 3520 616e 6420 696e 2052 4742 206d 255 and in RGB m │ │ │ │ │ -0000d6d0: 6f64 6573 2074 6865 7920 7769 6c6c 2062 odes they will b │ │ │ │ │ -0000d6e0: 650a 2020 2020 2063 6f6e 7665 7274 6564 e. converted │ │ │ │ │ -0000d6f0: 2074 6f20 7363 7265 656e 2063 6f6c 6f72 to screen color │ │ │ │ │ -0000d700: 2064 6174 612e 2020 496e 2069 6e64 6578 data. In index │ │ │ │ │ -0000d710: 2063 6f6c 6f72 206d 6f64 6573 2c20 696e color modes, in │ │ │ │ │ -0000d720: 6465 7820 636f 6c6f 720a 2020 2020 2070 dex color. p │ │ │ │ │ -0000d730: 616c 6574 7465 2077 696c 6c20 6265 2073 alette will be s │ │ │ │ │ -0000d740: 6561 7263 6865 6420 666f 7220 7370 6563 earched for spec │ │ │ │ │ -0000d750: 6966 6965 6420 636f 6c6f 7220 616e 6420 ified color and │ │ │ │ │ -0000d760: 7468 656e 2069 6e64 6578 2069 730a 2020 then index is. │ │ │ │ │ -0000d770: 2020 2072 6574 7572 6e65 642e 0a0a 3130 returned...10 │ │ │ │ │ -0000d780: 2e31 2e31 3520 6772 7562 5f76 6964 656f .1.15 grub_video │ │ │ │ │ -0000d790: 5f6d 6170 5f72 6762 610a 2d2d 2d2d 2d2d _map_rgba.------ │ │ │ │ │ +0000d5c0: 2d2d 2d0a 0a20 2020 2a20 5072 6f74 6f74 ---.. * Protot │ │ │ │ │ +0000d5d0: 7970 653a 0a0a 2020 2020 2020 2020 2020 ype:.. │ │ │ │ │ +0000d5e0: 6772 7562 5f76 6964 656f 5f63 6f6c 6f72 grub_video_color │ │ │ │ │ +0000d5f0: 5f74 0a20 2020 2020 2020 2020 2067 7275 _t. gru │ │ │ │ │ +0000d600: 625f 7669 6465 6f5f 6d61 705f 7267 6220 b_video_map_rgb │ │ │ │ │ +0000d610: 2867 7275 625f 7569 6e74 385f 7420 7265 (grub_uint8_t re │ │ │ │ │ +0000d620: 642c 2067 7275 625f 7569 6e74 385f 7420 d, grub_uint8_t │ │ │ │ │ +0000d630: 6772 6565 6e2c 2067 7275 625f 7569 6e74 green, grub_uint │ │ │ │ │ +0000d640: 385f 7420 626c 7565 293b 0a20 2020 2a20 8_t blue);. * │ │ │ │ │ +0000d650: 4465 7363 7269 7074 696f 6e3a 0a0a 2020 Description:.. │ │ │ │ │ +0000d660: 2020 204d 6170 2052 4742 2076 616c 7565 Map RGB value │ │ │ │ │ +0000d670: 7320 746f 2063 6f6d 7061 7469 626c 6520 s to compatible │ │ │ │ │ +0000d680: 7363 7265 656e 2063 6f6c 6f72 2064 6174 screen color dat │ │ │ │ │ +0000d690: 612e 2020 5661 6c75 6573 2061 7265 0a20 a. Values are. │ │ │ │ │ +0000d6a0: 2020 2020 6578 7065 6374 6564 2074 6f20 expected to │ │ │ │ │ +0000d6b0: 6265 2069 6e20 7261 6e67 6520 302d 3235 be in range 0-25 │ │ │ │ │ +0000d6c0: 3520 616e 6420 696e 2052 4742 206d 6f64 5 and in RGB mod │ │ │ │ │ +0000d6d0: 6573 2074 6865 7920 7769 6c6c 2062 650a es they will be. │ │ │ │ │ +0000d6e0: 2020 2020 2063 6f6e 7665 7274 6564 2074 converted t │ │ │ │ │ +0000d6f0: 6f20 7363 7265 656e 2063 6f6c 6f72 2064 o screen color d │ │ │ │ │ +0000d700: 6174 612e 2020 496e 2069 6e64 6578 2063 ata. In index c │ │ │ │ │ +0000d710: 6f6c 6f72 206d 6f64 6573 2c20 696e 6465 olor modes, inde │ │ │ │ │ +0000d720: 7820 636f 6c6f 720a 2020 2020 2070 616c x color. pal │ │ │ │ │ +0000d730: 6574 7465 2077 696c 6c20 6265 2073 6561 ette will be sea │ │ │ │ │ +0000d740: 7263 6865 6420 666f 7220 7370 6563 6966 rched for specif │ │ │ │ │ +0000d750: 6965 6420 636f 6c6f 7220 616e 6420 7468 ied color and th │ │ │ │ │ +0000d760: 656e 2069 6e64 6578 2069 730a 2020 2020 en index is. │ │ │ │ │ +0000d770: 2072 6574 7572 6e65 642e 0a0a 3130 2e31 returned...10.1 │ │ │ │ │ +0000d780: 2e31 3520 6772 7562 5f76 6964 656f 5f6d .15 grub_video_m │ │ │ │ │ +0000d790: 6170 5f72 6762 610a 2d2d 2d2d 2d2d 2d2d ap_rgba.-------- │ │ │ │ │ 0000d7a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000d7b0: 2d2d 2d2d 2d0a 0a20 2020 2a20 5072 6f74 -----.. * Prot │ │ │ │ │ -0000d7c0: 6f74 7970 653a 0a0a 2020 2020 2020 2020 otype:.. │ │ │ │ │ -0000d7d0: 2020 6772 7562 5f76 6964 656f 5f63 6f6c grub_video_col │ │ │ │ │ -0000d7e0: 6f72 5f74 0a20 2020 2020 2020 2020 2067 or_t. g │ │ │ │ │ -0000d7f0: 7275 625f 7669 6465 6f5f 6d61 705f 7267 rub_video_map_rg │ │ │ │ │ -0000d800: 6261 2028 6772 7562 5f75 696e 7438 5f74 ba (grub_uint8_t │ │ │ │ │ -0000d810: 2072 6564 2c20 6772 7562 5f75 696e 7438 red, grub_uint8 │ │ │ │ │ -0000d820: 5f74 2067 7265 656e 2c20 6772 7562 5f75 _t green, grub_u │ │ │ │ │ -0000d830: 696e 7438 5f74 2062 6c75 652c 2067 7275 int8_t blue, gru │ │ │ │ │ -0000d840: 625f 7569 6e74 385f 7420 616c 7068 6129 b_uint8_t alpha) │ │ │ │ │ -0000d850: 3b0a 2020 202a 2044 6573 6372 6970 7469 ;. * Descripti │ │ │ │ │ -0000d860: 6f6e 3a0a 0a20 2020 2020 4d61 7020 5247 on:.. Map RG │ │ │ │ │ -0000d870: 4241 2076 616c 7565 7320 746f 2063 6f6d BA values to com │ │ │ │ │ -0000d880: 7061 7469 626c 6520 7363 7265 656e 2063 patible screen c │ │ │ │ │ -0000d890: 6f6c 6f72 2064 6174 612e 2020 5661 6c75 olor data. Valu │ │ │ │ │ -0000d8a0: 6573 2061 7265 0a20 2020 2020 6578 7065 es are. expe │ │ │ │ │ -0000d8b0: 6374 6564 2074 6f20 6265 2069 6e20 7261 cted to be in ra │ │ │ │ │ -0000d8c0: 6e67 6520 302d 3235 352e 2020 496e 2052 nge 0-255. In R │ │ │ │ │ -0000d8d0: 4742 4120 6d6f 6465 7320 7468 6579 2077 GBA modes they w │ │ │ │ │ -0000d8e0: 696c 6c20 6265 0a20 2020 2020 636f 6e76 ill be. conv │ │ │ │ │ -0000d8f0: 6572 7465 6420 746f 2073 6372 6565 6e20 erted to screen │ │ │ │ │ -0000d900: 636f 6c6f 7220 6461 7461 2e20 2049 6e20 color data. In │ │ │ │ │ -0000d910: 696e 6465 7820 636f 6c6f 7220 6d6f 6465 index color mode │ │ │ │ │ -0000d920: 732c 2069 6e64 6578 2063 6f6c 6f72 0a20 s, index color. │ │ │ │ │ -0000d930: 2020 2020 7061 6c65 7474 6520 7769 6c6c palette will │ │ │ │ │ -0000d940: 2062 6520 7365 6172 6368 6564 2066 6f72 be searched for │ │ │ │ │ -0000d950: 2062 6573 7420 6d61 7463 6869 6e67 2063 best matching c │ │ │ │ │ -0000d960: 6f6c 6f72 2061 6e64 2069 7473 2069 6e64 olor and its ind │ │ │ │ │ -0000d970: 6578 2069 730a 2020 2020 2072 6574 7572 ex is. retur │ │ │ │ │ -0000d980: 6e65 642e 0a0a 3130 2e31 2e31 3620 6772 ned...10.1.16 gr │ │ │ │ │ -0000d990: 7562 5f76 6964 656f 5f75 6e6d 6170 5f63 ub_video_unmap_c │ │ │ │ │ -0000d9a0: 6f6c 6f72 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d olor.----------- │ │ │ │ │ +0000d7b0: 2d2d 2d0a 0a20 2020 2a20 5072 6f74 6f74 ---.. * Protot │ │ │ │ │ +0000d7c0: 7970 653a 0a0a 2020 2020 2020 2020 2020 ype:.. │ │ │ │ │ +0000d7d0: 6772 7562 5f76 6964 656f 5f63 6f6c 6f72 grub_video_color │ │ │ │ │ +0000d7e0: 5f74 0a20 2020 2020 2020 2020 2067 7275 _t. gru │ │ │ │ │ +0000d7f0: 625f 7669 6465 6f5f 6d61 705f 7267 6261 b_video_map_rgba │ │ │ │ │ +0000d800: 2028 6772 7562 5f75 696e 7438 5f74 2072 (grub_uint8_t r │ │ │ │ │ +0000d810: 6564 2c20 6772 7562 5f75 696e 7438 5f74 ed, grub_uint8_t │ │ │ │ │ +0000d820: 2067 7265 656e 2c20 6772 7562 5f75 696e green, grub_uin │ │ │ │ │ +0000d830: 7438 5f74 2062 6c75 652c 2067 7275 625f t8_t blue, grub_ │ │ │ │ │ +0000d840: 7569 6e74 385f 7420 616c 7068 6129 3b0a uint8_t alpha);. │ │ │ │ │ +0000d850: 2020 202a 2044 6573 6372 6970 7469 6f6e * Description │ │ │ │ │ +0000d860: 3a0a 0a20 2020 2020 4d61 7020 5247 4241 :.. Map RGBA │ │ │ │ │ +0000d870: 2076 616c 7565 7320 746f 2063 6f6d 7061 values to compa │ │ │ │ │ +0000d880: 7469 626c 6520 7363 7265 656e 2063 6f6c tible screen col │ │ │ │ │ +0000d890: 6f72 2064 6174 612e 2020 5661 6c75 6573 or data. Values │ │ │ │ │ +0000d8a0: 2061 7265 0a20 2020 2020 6578 7065 6374 are. expect │ │ │ │ │ +0000d8b0: 6564 2074 6f20 6265 2069 6e20 7261 6e67 ed to be in rang │ │ │ │ │ +0000d8c0: 6520 302d 3235 352e 2020 496e 2052 4742 e 0-255. In RGB │ │ │ │ │ +0000d8d0: 4120 6d6f 6465 7320 7468 6579 2077 696c A modes they wil │ │ │ │ │ +0000d8e0: 6c20 6265 0a20 2020 2020 636f 6e76 6572 l be. conver │ │ │ │ │ +0000d8f0: 7465 6420 746f 2073 6372 6565 6e20 636f ted to screen co │ │ │ │ │ +0000d900: 6c6f 7220 6461 7461 2e20 2049 6e20 696e lor data. In in │ │ │ │ │ +0000d910: 6465 7820 636f 6c6f 7220 6d6f 6465 732c dex color modes, │ │ │ │ │ +0000d920: 2069 6e64 6578 2063 6f6c 6f72 0a20 2020 index color. │ │ │ │ │ +0000d930: 2020 7061 6c65 7474 6520 7769 6c6c 2062 palette will b │ │ │ │ │ +0000d940: 6520 7365 6172 6368 6564 2066 6f72 2062 e searched for b │ │ │ │ │ +0000d950: 6573 7420 6d61 7463 6869 6e67 2063 6f6c est matching col │ │ │ │ │ +0000d960: 6f72 2061 6e64 2069 7473 2069 6e64 6578 or and its index │ │ │ │ │ +0000d970: 2069 730a 2020 2020 2072 6574 7572 6e65 is. returne │ │ │ │ │ +0000d980: 642e 0a0a 3130 2e31 2e31 3620 6772 7562 d...10.1.16 grub │ │ │ │ │ +0000d990: 5f76 6964 656f 5f75 6e6d 6170 5f63 6f6c _video_unmap_col │ │ │ │ │ +0000d9a0: 6f72 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d or.------------- │ │ │ │ │ 0000d9b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000d9c0: 2d2d 2d0a 0a20 2020 2a20 5072 6f74 6f74 ---.. * Protot │ │ │ │ │ -0000d9d0: 7970 653a 0a0a 2020 2020 2020 2020 2020 ype:.. │ │ │ │ │ -0000d9e0: 6772 7562 5f65 7272 5f74 0a20 2020 2020 grub_err_t. │ │ │ │ │ -0000d9f0: 2020 2020 2067 7275 625f 7669 6465 6f5f grub_video_ │ │ │ │ │ -0000da00: 756e 6d61 705f 636f 6c6f 7220 2867 7275 unmap_color (gru │ │ │ │ │ -0000da10: 625f 7669 6465 6f5f 636f 6c6f 725f 7420 b_video_color_t │ │ │ │ │ -0000da20: 636f 6c6f 722c 2067 7275 625f 7569 6e74 color, grub_uint │ │ │ │ │ -0000da30: 385f 7420 2a72 6564 2c20 6772 7562 5f75 8_t *red, grub_u │ │ │ │ │ -0000da40: 696e 7438 5f74 202a 6772 6565 6e2c 2067 int8_t *green, g │ │ │ │ │ -0000da50: 7275 625f 7569 6e74 385f 7420 2a62 6c75 rub_uint8_t *blu │ │ │ │ │ -0000da60: 652c 2067 7275 625f 7569 6e74 385f 7420 e, grub_uint8_t │ │ │ │ │ -0000da70: 2a61 6c70 6861 293b 0a20 2020 2a20 4465 *alpha);. * De │ │ │ │ │ -0000da80: 7363 7269 7074 696f 6e3a 0a0a 2020 2020 scription:.. │ │ │ │ │ -0000da90: 2055 6e6d 6170 2063 6f6c 6f72 2076 616c Unmap color val │ │ │ │ │ -0000daa0: 7565 2066 726f 6d20 2763 6f6c 6f72 2720 ue from 'color' │ │ │ │ │ -0000dab0: 746f 2063 6f6c 6f72 2063 6861 6e6e 656c to color channel │ │ │ │ │ -0000dac0: 7320 696e 2027 7265 6427 2c20 2767 7265 s in 'red', 'gre │ │ │ │ │ -0000dad0: 656e 272c 0a20 2020 2020 2762 6c75 6527 en',. 'blue' │ │ │ │ │ -0000dae0: 2061 6e64 2027 616c 7068 6127 2e20 2056 and 'alpha'. V │ │ │ │ │ -0000daf0: 616c 7565 7320 7769 6c6c 2062 6520 696e alues will be in │ │ │ │ │ -0000db00: 2072 616e 6765 2030 2d32 3535 2e20 2041 range 0-255. A │ │ │ │ │ -0000db10: 6374 6976 650a 2020 2020 2072 656e 6465 ctive. rende │ │ │ │ │ -0000db20: 7269 6e67 2074 6172 6765 7420 7769 6c6c ring target will │ │ │ │ │ -0000db30: 2062 6520 7573 6564 2066 6f72 2063 6f6c be used for col │ │ │ │ │ -0000db40: 6f72 2064 6f6d 6169 6e2e 2020 496e 2063 or domain. In c │ │ │ │ │ -0000db50: 6173 6520 616c 7068 610a 2020 2020 2069 ase alpha. i │ │ │ │ │ -0000db60: 6e66 6f72 6d61 7469 6f6e 2069 7320 6e6f nformation is no │ │ │ │ │ -0000db70: 7420 6176 6169 6c61 626c 6520 696e 2072 t available in r │ │ │ │ │ -0000db80: 656e 6465 7269 6e67 2074 6172 6765 742c endering target, │ │ │ │ │ -0000db90: 2069 7420 6973 2061 7373 756d 6564 2074 it is assumed t │ │ │ │ │ -0000dba0: 6f0a 2020 2020 2062 6520 6f70 6171 7565 o. be opaque │ │ │ │ │ -0000dbb0: 2028 6861 7669 6e67 2076 616c 7565 2032 (having value 2 │ │ │ │ │ -0000dbc0: 3535 292e 0a0a 3130 2e31 2e31 3720 6772 55)...10.1.17 gr │ │ │ │ │ -0000dbd0: 7562 5f76 6964 656f 5f66 696c 6c5f 7265 ub_video_fill_re │ │ │ │ │ -0000dbe0: 6374 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ct.------------- │ │ │ │ │ -0000dbf0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ -0000dc00: 0a20 2020 2a20 5072 6f74 6f74 7970 653a . * Prototype: │ │ │ │ │ -0000dc10: 0a0a 2020 2020 2020 2020 2020 6772 7562 .. grub │ │ │ │ │ -0000dc20: 5f65 7272 5f74 0a20 2020 2020 2020 2020 _err_t. │ │ │ │ │ -0000dc30: 2067 7275 625f 7669 6465 6f5f 6669 6c6c grub_video_fill │ │ │ │ │ -0000dc40: 5f72 6563 7420 2867 7275 625f 7669 6465 _rect (grub_vide │ │ │ │ │ -0000dc50: 6f5f 636f 6c6f 725f 7420 636f 6c6f 722c o_color_t color, │ │ │ │ │ -0000dc60: 2069 6e74 2078 2c20 696e 7420 792c 2075 int x, int y, u │ │ │ │ │ -0000dc70: 6e73 6967 6e65 6420 696e 7420 7769 6474 nsigned int widt │ │ │ │ │ -0000dc80: 682c 2075 6e73 6967 6e65 6420 696e 7420 h, unsigned int │ │ │ │ │ -0000dc90: 6865 6967 6874 293b 0a20 2020 2a20 4465 height);. * De │ │ │ │ │ -0000dca0: 7363 7269 7074 696f 6e3a 0a0a 2020 2020 scription:.. │ │ │ │ │ -0000dcb0: 2046 696c 6c20 7370 6563 6966 6965 6420 Fill specified │ │ │ │ │ -0000dcc0: 6172 6561 206c 696d 6974 6564 2062 7920 area limited by │ │ │ │ │ -0000dcd0: 6769 7665 6e20 636f 6f72 6469 6e61 7465 given coordinate │ │ │ │ │ -0000dce0: 7320 7769 7468 696e 2073 7065 6369 6669 s within specifi │ │ │ │ │ -0000dcf0: 6564 0a20 2020 2020 7669 6577 706f 7274 ed. viewport │ │ │ │ │ -0000dd00: 2e20 204e 6567 6174 6976 6520 636f 6f72 . Negative coor │ │ │ │ │ -0000dd10: 6469 6e61 7465 7320 6172 6520 6163 6365 dinates are acce │ │ │ │ │ -0000dd20: 7074 6564 2069 6e20 6f72 6465 7220 746f pted in order to │ │ │ │ │ -0000dd30: 2061 6c6c 6f77 2065 6173 790a 2020 2020 allow easy. │ │ │ │ │ -0000dd40: 206d 6f76 696e 6720 6f66 2072 6563 7461 moving of recta │ │ │ │ │ -0000dd50: 6e67 6c65 2077 6974 6869 6e20 7669 6577 ngle within view │ │ │ │ │ -0000dd60: 706f 7274 2e20 2049 6620 636f 6f72 6469 port. If coordi │ │ │ │ │ -0000dd70: 6e61 7465 7320 6172 6520 6e65 6761 7469 nates are negati │ │ │ │ │ -0000dd80: 7665 2c0a 2020 2020 2061 7265 6120 6f66 ve,. area of │ │ │ │ │ -0000dd90: 2074 6865 2072 6563 7461 6e67 6c65 2077 the rectangle w │ │ │ │ │ -0000dda0: 696c 6c20 6265 2073 6872 696e 6b65 6e20 ill be shrinken │ │ │ │ │ -0000ddb0: 746f 2066 6f6c 6c6f 7720 7369 7a65 206c to follow size l │ │ │ │ │ -0000ddc0: 696d 6974 7320 6f66 2074 6865 0a20 2020 imits of the. │ │ │ │ │ -0000ddd0: 2020 7669 6577 706f 7274 2e0a 0a20 2020 viewport... │ │ │ │ │ -0000dde0: 2020 536f 6674 7761 7265 2064 6576 656c Software devel │ │ │ │ │ -0000ddf0: 6f70 6572 2073 686f 756c 6420 7573 6520 oper should use │ │ │ │ │ -0000de00: 6569 7468 6572 2027 6772 7562 5f76 6964 either 'grub_vid │ │ │ │ │ -0000de10: 656f 5f6d 6170 5f63 6f6c 6f72 272c 0a20 eo_map_color',. │ │ │ │ │ -0000de20: 2020 2020 2767 7275 625f 7669 6465 6f5f 'grub_video_ │ │ │ │ │ -0000de30: 6d61 705f 7267 6227 206f 7220 2767 7275 map_rgb' or 'gru │ │ │ │ │ -0000de40: 625f 7669 6465 6f5f 6d61 705f 7267 6261 b_video_map_rgba │ │ │ │ │ -0000de50: 2720 746f 206d 6170 2072 6571 7565 7374 ' to map request │ │ │ │ │ -0000de60: 6564 0a20 2020 2020 636f 6c6f 7220 746f ed. color to │ │ │ │ │ -0000de70: 2027 636f 6c6f 7227 2070 6172 616d 6574 'color' paramet │ │ │ │ │ -0000de80: 6572 2e0a 0a31 302e 312e 3138 2067 7275 er...10.1.18 gru │ │ │ │ │ -0000de90: 625f 7669 6465 6f5f 626c 6974 5f67 6c79 b_video_blit_gly │ │ │ │ │ -0000dea0: 7068 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ph.------------- │ │ │ │ │ -0000deb0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000dec0: 0a0a 2020 202a 2050 726f 746f 7479 7065 .. * Prototype │ │ │ │ │ -0000ded0: 3a0a 0a20 2020 2020 2020 2020 2067 7275 :.. gru │ │ │ │ │ -0000dee0: 625f 6572 725f 740a 2020 2020 2020 2020 b_err_t. │ │ │ │ │ -0000def0: 2020 6772 7562 5f76 6964 656f 5f62 6c69 grub_video_bli │ │ │ │ │ -0000df00: 745f 676c 7970 6820 2873 7472 7563 7420 t_glyph (struct │ │ │ │ │ -0000df10: 6772 7562 5f66 6f6e 745f 676c 7970 6820 grub_font_glyph │ │ │ │ │ -0000df20: 2a67 6c79 7068 2c20 6772 7562 5f76 6964 *glyph, grub_vid │ │ │ │ │ -0000df30: 656f 5f63 6f6c 6f72 5f74 2063 6f6c 6f72 eo_color_t color │ │ │ │ │ -0000df40: 2c20 696e 7420 782c 2069 6e74 2079 293b , int x, int y); │ │ │ │ │ -0000df50: 0a20 2020 2020 2020 2020 2073 7472 7563 . struc │ │ │ │ │ -0000df60: 7420 6772 7562 5f66 6f6e 745f 676c 7970 t grub_font_glyp │ │ │ │ │ -0000df70: 6820 7b0a 2020 2020 2020 2020 2020 2020 h {. │ │ │ │ │ -0000df80: 2020 2f2a 2054 4244 2e20 2a2f 0a20 2020 /* TBD. */. │ │ │ │ │ -0000df90: 2020 2020 2020 207d 3b0a 2020 202a 2044 };. * D │ │ │ │ │ -0000dfa0: 6573 6372 6970 7469 6f6e 3a0a 0a20 2020 escription:.. │ │ │ │ │ -0000dfb0: 2020 5573 6564 2074 6f20 626c 6974 2067 Used to blit g │ │ │ │ │ -0000dfc0: 6c79 7068 2074 6f20 7669 6577 706f 7274 lyph to viewport │ │ │ │ │ -0000dfd0: 2069 6e20 7370 6563 6966 6965 6420 636f in specified co │ │ │ │ │ -0000dfe0: 6f64 696e 6174 6573 2e20 2049 6620 676c odinates. If gl │ │ │ │ │ -0000dff0: 7970 680a 2020 2020 2069 7320 6174 2065 yph. is at e │ │ │ │ │ -0000e000: 6467 6520 6f66 2076 6965 7770 6f72 742c dge of viewport, │ │ │ │ │ -0000e010: 2070 6978 656c 7320 6f75 7473 6964 6520 pixels outside │ │ │ │ │ -0000e020: 6f66 2076 6965 7770 6f72 7420 7769 6c6c of viewport will │ │ │ │ │ -0000e030: 2062 6520 636c 6970 7065 640a 2020 2020 be clipped. │ │ │ │ │ -0000e040: 206f 7574 2e20 2053 6f66 7477 6172 6520 out. Software │ │ │ │ │ -0000e050: 6465 7665 6c6f 7065 7220 7368 6f75 6c64 developer should │ │ │ │ │ -0000e060: 2075 7365 2065 6974 6865 7220 2767 7275 use either 'gru │ │ │ │ │ -0000e070: 625f 7669 6465 6f5f 6d61 705f 7267 6227 b_video_map_rgb' │ │ │ │ │ -0000e080: 206f 720a 2020 2020 2027 6772 7562 5f76 or. 'grub_v │ │ │ │ │ -0000e090: 6964 656f 5f6d 6170 5f72 6762 6127 2074 ideo_map_rgba' t │ │ │ │ │ -0000e0a0: 6f20 6d61 7020 7265 7175 6573 7465 6420 o map requested │ │ │ │ │ -0000e0b0: 636f 6c6f 7220 746f 2027 636f 6c6f 7227 color to 'color' │ │ │ │ │ -0000e0c0: 2070 6172 616d 6574 6572 2e0a 0a31 302e parameter...10. │ │ │ │ │ -0000e0d0: 312e 3139 2067 7275 625f 7669 6465 6f5f 1.19 grub_video_ │ │ │ │ │ -0000e0e0: 626c 6974 5f62 6974 6d61 700a 2d2d 2d2d blit_bitmap.---- │ │ │ │ │ +0000d9c0: 2d0a 0a20 2020 2a20 5072 6f74 6f74 7970 -.. * Prototyp │ │ │ │ │ +0000d9d0: 653a 0a0a 2020 2020 2020 2020 2020 6772 e:.. gr │ │ │ │ │ +0000d9e0: 7562 5f65 7272 5f74 0a20 2020 2020 2020 ub_err_t. │ │ │ │ │ +0000d9f0: 2020 2067 7275 625f 7669 6465 6f5f 756e grub_video_un │ │ │ │ │ +0000da00: 6d61 705f 636f 6c6f 7220 2867 7275 625f map_color (grub_ │ │ │ │ │ +0000da10: 7669 6465 6f5f 636f 6c6f 725f 7420 636f video_color_t co │ │ │ │ │ +0000da20: 6c6f 722c 2067 7275 625f 7569 6e74 385f lor, grub_uint8_ │ │ │ │ │ +0000da30: 7420 2a72 6564 2c20 6772 7562 5f75 696e t *red, grub_uin │ │ │ │ │ +0000da40: 7438 5f74 202a 6772 6565 6e2c 2067 7275 t8_t *green, gru │ │ │ │ │ +0000da50: 625f 7569 6e74 385f 7420 2a62 6c75 652c b_uint8_t *blue, │ │ │ │ │ +0000da60: 2067 7275 625f 7569 6e74 385f 7420 2a61 grub_uint8_t *a │ │ │ │ │ +0000da70: 6c70 6861 293b 0a20 2020 2a20 4465 7363 lpha);. * Desc │ │ │ │ │ +0000da80: 7269 7074 696f 6e3a 0a0a 2020 2020 2055 ription:.. U │ │ │ │ │ +0000da90: 6e6d 6170 2063 6f6c 6f72 2076 616c 7565 nmap color value │ │ │ │ │ +0000daa0: 2066 726f 6d20 2763 6f6c 6f72 2720 746f from 'color' to │ │ │ │ │ +0000dab0: 2063 6f6c 6f72 2063 6861 6e6e 656c 7320 color channels │ │ │ │ │ +0000dac0: 696e 2027 7265 6427 2c20 2767 7265 656e in 'red', 'green │ │ │ │ │ +0000dad0: 272c 0a20 2020 2020 2762 6c75 6527 2061 ',. 'blue' a │ │ │ │ │ +0000dae0: 6e64 2027 616c 7068 6127 2e20 2056 616c nd 'alpha'. Val │ │ │ │ │ +0000daf0: 7565 7320 7769 6c6c 2062 6520 696e 2072 ues will be in r │ │ │ │ │ +0000db00: 616e 6765 2030 2d32 3535 2e20 2041 6374 ange 0-255. Act │ │ │ │ │ +0000db10: 6976 650a 2020 2020 2072 656e 6465 7269 ive. renderi │ │ │ │ │ +0000db20: 6e67 2074 6172 6765 7420 7769 6c6c 2062 ng target will b │ │ │ │ │ +0000db30: 6520 7573 6564 2066 6f72 2063 6f6c 6f72 e used for color │ │ │ │ │ +0000db40: 2064 6f6d 6169 6e2e 2020 496e 2063 6173 domain. In cas │ │ │ │ │ +0000db50: 6520 616c 7068 610a 2020 2020 2069 6e66 e alpha. inf │ │ │ │ │ +0000db60: 6f72 6d61 7469 6f6e 2069 7320 6e6f 7420 ormation is not │ │ │ │ │ +0000db70: 6176 6169 6c61 626c 6520 696e 2072 656e available in ren │ │ │ │ │ +0000db80: 6465 7269 6e67 2074 6172 6765 742c 2069 dering target, i │ │ │ │ │ +0000db90: 7420 6973 2061 7373 756d 6564 2074 6f0a t is assumed to. │ │ │ │ │ +0000dba0: 2020 2020 2062 6520 6f70 6171 7565 2028 be opaque ( │ │ │ │ │ +0000dbb0: 6861 7669 6e67 2076 616c 7565 2032 3535 having value 255 │ │ │ │ │ +0000dbc0: 292e 0a0a 3130 2e31 2e31 3720 6772 7562 )...10.1.17 grub │ │ │ │ │ +0000dbd0: 5f76 6964 656f 5f66 696c 6c5f 7265 6374 _video_fill_rect │ │ │ │ │ +0000dbe0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ │ +0000dbf0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 -------------.. │ │ │ │ │ +0000dc00: 2020 2a20 5072 6f74 6f74 7970 653a 0a0a * Prototype:.. │ │ │ │ │ +0000dc10: 2020 2020 2020 2020 2020 6772 7562 5f65 grub_e │ │ │ │ │ +0000dc20: 7272 5f74 0a20 2020 2020 2020 2020 2067 rr_t. g │ │ │ │ │ +0000dc30: 7275 625f 7669 6465 6f5f 6669 6c6c 5f72 rub_video_fill_r │ │ │ │ │ +0000dc40: 6563 7420 2867 7275 625f 7669 6465 6f5f ect (grub_video_ │ │ │ │ │ +0000dc50: 636f 6c6f 725f 7420 636f 6c6f 722c 2069 color_t color, i │ │ │ │ │ +0000dc60: 6e74 2078 2c20 696e 7420 792c 2075 6e73 nt x, int y, uns │ │ │ │ │ +0000dc70: 6967 6e65 6420 696e 7420 7769 6474 682c igned int width, │ │ │ │ │ +0000dc80: 2075 6e73 6967 6e65 6420 696e 7420 6865 unsigned int he │ │ │ │ │ +0000dc90: 6967 6874 293b 0a20 2020 2a20 4465 7363 ight);. * Desc │ │ │ │ │ +0000dca0: 7269 7074 696f 6e3a 0a0a 2020 2020 2046 ription:.. F │ │ │ │ │ +0000dcb0: 696c 6c20 7370 6563 6966 6965 6420 6172 ill specified ar │ │ │ │ │ +0000dcc0: 6561 206c 696d 6974 6564 2062 7920 6769 ea limited by gi │ │ │ │ │ +0000dcd0: 7665 6e20 636f 6f72 6469 6e61 7465 7320 ven coordinates │ │ │ │ │ +0000dce0: 7769 7468 696e 2073 7065 6369 6669 6564 within specified │ │ │ │ │ +0000dcf0: 0a20 2020 2020 7669 6577 706f 7274 2e20 . viewport. │ │ │ │ │ +0000dd00: 204e 6567 6174 6976 6520 636f 6f72 6469 Negative coordi │ │ │ │ │ +0000dd10: 6e61 7465 7320 6172 6520 6163 6365 7074 nates are accept │ │ │ │ │ +0000dd20: 6564 2069 6e20 6f72 6465 7220 746f 2061 ed in order to a │ │ │ │ │ +0000dd30: 6c6c 6f77 2065 6173 790a 2020 2020 206d llow easy. m │ │ │ │ │ +0000dd40: 6f76 696e 6720 6f66 2072 6563 7461 6e67 oving of rectang │ │ │ │ │ +0000dd50: 6c65 2077 6974 6869 6e20 7669 6577 706f le within viewpo │ │ │ │ │ +0000dd60: 7274 2e20 2049 6620 636f 6f72 6469 6e61 rt. If coordina │ │ │ │ │ +0000dd70: 7465 7320 6172 6520 6e65 6761 7469 7665 tes are negative │ │ │ │ │ +0000dd80: 2c0a 2020 2020 2061 7265 6120 6f66 2074 ,. area of t │ │ │ │ │ +0000dd90: 6865 2072 6563 7461 6e67 6c65 2077 696c he rectangle wil │ │ │ │ │ +0000dda0: 6c20 6265 2073 6872 696e 6b65 6e20 746f l be shrinken to │ │ │ │ │ +0000ddb0: 2066 6f6c 6c6f 7720 7369 7a65 206c 696d follow size lim │ │ │ │ │ +0000ddc0: 6974 7320 6f66 2074 6865 0a20 2020 2020 its of the. │ │ │ │ │ +0000ddd0: 7669 6577 706f 7274 2e0a 0a20 2020 2020 viewport... │ │ │ │ │ +0000dde0: 536f 6674 7761 7265 2064 6576 656c 6f70 Software develop │ │ │ │ │ +0000ddf0: 6572 2073 686f 756c 6420 7573 6520 6569 er should use ei │ │ │ │ │ +0000de00: 7468 6572 2027 6772 7562 5f76 6964 656f ther 'grub_video │ │ │ │ │ +0000de10: 5f6d 6170 5f63 6f6c 6f72 272c 0a20 2020 _map_color',. │ │ │ │ │ +0000de20: 2020 2767 7275 625f 7669 6465 6f5f 6d61 'grub_video_ma │ │ │ │ │ +0000de30: 705f 7267 6227 206f 7220 2767 7275 625f p_rgb' or 'grub_ │ │ │ │ │ +0000de40: 7669 6465 6f5f 6d61 705f 7267 6261 2720 video_map_rgba' │ │ │ │ │ +0000de50: 746f 206d 6170 2072 6571 7565 7374 6564 to map requested │ │ │ │ │ +0000de60: 0a20 2020 2020 636f 6c6f 7220 746f 2027 . color to ' │ │ │ │ │ +0000de70: 636f 6c6f 7227 2070 6172 616d 6574 6572 color' parameter │ │ │ │ │ +0000de80: 2e0a 0a31 302e 312e 3138 2067 7275 625f ...10.1.18 grub_ │ │ │ │ │ +0000de90: 7669 6465 6f5f 626c 6974 5f67 6c79 7068 video_blit_glyph │ │ │ │ │ +0000dea0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ │ +0000deb0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ +0000dec0: 2020 202a 2050 726f 746f 7479 7065 3a0a * Prototype:. │ │ │ │ │ +0000ded0: 0a20 2020 2020 2020 2020 2067 7275 625f . grub_ │ │ │ │ │ +0000dee0: 6572 725f 740a 2020 2020 2020 2020 2020 err_t. │ │ │ │ │ +0000def0: 6772 7562 5f76 6964 656f 5f62 6c69 745f grub_video_blit_ │ │ │ │ │ +0000df00: 676c 7970 6820 2873 7472 7563 7420 6772 glyph (struct gr │ │ │ │ │ +0000df10: 7562 5f66 6f6e 745f 676c 7970 6820 2a67 ub_font_glyph *g │ │ │ │ │ +0000df20: 6c79 7068 2c20 6772 7562 5f76 6964 656f lyph, grub_video │ │ │ │ │ +0000df30: 5f63 6f6c 6f72 5f74 2063 6f6c 6f72 2c20 _color_t color, │ │ │ │ │ +0000df40: 696e 7420 782c 2069 6e74 2079 293b 0a20 int x, int y);. │ │ │ │ │ +0000df50: 2020 2020 2020 2020 2073 7472 7563 7420 struct │ │ │ │ │ +0000df60: 6772 7562 5f66 6f6e 745f 676c 7970 6820 grub_font_glyph │ │ │ │ │ +0000df70: 7b0a 2020 2020 2020 2020 2020 2020 2020 {. │ │ │ │ │ +0000df80: 2f2a 2054 4244 2e20 2a2f 0a20 2020 2020 /* TBD. */. │ │ │ │ │ +0000df90: 2020 2020 207d 3b0a 2020 202a 2044 6573 };. * Des │ │ │ │ │ +0000dfa0: 6372 6970 7469 6f6e 3a0a 0a20 2020 2020 cription:.. │ │ │ │ │ +0000dfb0: 5573 6564 2074 6f20 626c 6974 2067 6c79 Used to blit gly │ │ │ │ │ +0000dfc0: 7068 2074 6f20 7669 6577 706f 7274 2069 ph to viewport i │ │ │ │ │ +0000dfd0: 6e20 7370 6563 6966 6965 6420 636f 6f64 n specified cood │ │ │ │ │ +0000dfe0: 696e 6174 6573 2e20 2049 6620 676c 7970 inates. If glyp │ │ │ │ │ +0000dff0: 680a 2020 2020 2069 7320 6174 2065 6467 h. is at edg │ │ │ │ │ +0000e000: 6520 6f66 2076 6965 7770 6f72 742c 2070 e of viewport, p │ │ │ │ │ +0000e010: 6978 656c 7320 6f75 7473 6964 6520 6f66 ixels outside of │ │ │ │ │ +0000e020: 2076 6965 7770 6f72 7420 7769 6c6c 2062 viewport will b │ │ │ │ │ +0000e030: 6520 636c 6970 7065 640a 2020 2020 206f e clipped. o │ │ │ │ │ +0000e040: 7574 2e20 2053 6f66 7477 6172 6520 6465 ut. Software de │ │ │ │ │ +0000e050: 7665 6c6f 7065 7220 7368 6f75 6c64 2075 veloper should u │ │ │ │ │ +0000e060: 7365 2065 6974 6865 7220 2767 7275 625f se either 'grub_ │ │ │ │ │ +0000e070: 7669 6465 6f5f 6d61 705f 7267 6227 206f video_map_rgb' o │ │ │ │ │ +0000e080: 720a 2020 2020 2027 6772 7562 5f76 6964 r. 'grub_vid │ │ │ │ │ +0000e090: 656f 5f6d 6170 5f72 6762 6127 2074 6f20 eo_map_rgba' to │ │ │ │ │ +0000e0a0: 6d61 7020 7265 7175 6573 7465 6420 636f map requested co │ │ │ │ │ +0000e0b0: 6c6f 7220 746f 2027 636f 6c6f 7227 2070 lor to 'color' p │ │ │ │ │ +0000e0c0: 6172 616d 6574 6572 2e0a 0a31 302e 312e arameter...10.1. │ │ │ │ │ +0000e0d0: 3139 2067 7275 625f 7669 6465 6f5f 626c 19 grub_video_bl │ │ │ │ │ +0000e0e0: 6974 5f62 6974 6d61 700a 2d2d 2d2d 2d2d it_bitmap.------ │ │ │ │ │ 0000e0f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000e100: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2020 202a ----------.. * │ │ │ │ │ -0000e110: 2050 726f 746f 7479 7065 3a0a 0a20 2020 Prototype:.. │ │ │ │ │ -0000e120: 2020 2020 2020 2067 7275 625f 6572 725f grub_err_ │ │ │ │ │ -0000e130: 740a 2020 2020 2020 2020 2020 6772 7562 t. grub │ │ │ │ │ -0000e140: 5f76 6964 656f 5f62 6c69 745f 6269 746d _video_blit_bitm │ │ │ │ │ -0000e150: 6170 2028 7374 7275 6374 2067 7275 625f ap (struct grub_ │ │ │ │ │ -0000e160: 7669 6465 6f5f 6269 746d 6170 202a 6269 video_bitmap *bi │ │ │ │ │ -0000e170: 746d 6170 2c20 656e 756d 2067 7275 625f tmap, enum grub_ │ │ │ │ │ -0000e180: 7669 6465 6f5f 626c 6974 5f6f 7065 7261 video_blit_opera │ │ │ │ │ -0000e190: 746f 7273 206f 7065 722c 2069 6e74 2078 tors oper, int x │ │ │ │ │ -0000e1a0: 2c20 696e 7420 792c 2069 6e74 206f 6666 , int y, int off │ │ │ │ │ -0000e1b0: 7365 745f 782c 2069 6e74 206f 6666 7365 set_x, int offse │ │ │ │ │ -0000e1c0: 745f 792c 2075 6e73 6967 6e65 6420 696e t_y, unsigned in │ │ │ │ │ -0000e1d0: 7420 7769 6474 682c 2075 6e73 6967 6e65 t width, unsigne │ │ │ │ │ -0000e1e0: 6420 696e 7420 6865 6967 6874 293b 0a20 d int height);. │ │ │ │ │ -0000e1f0: 2020 2020 2020 2020 2073 7472 7563 7420 struct │ │ │ │ │ -0000e200: 6772 7562 5f76 6964 656f 5f62 6974 6d61 grub_video_bitma │ │ │ │ │ -0000e210: 700a 2020 2020 2020 2020 2020 7b0a 2020 p. {. │ │ │ │ │ -0000e220: 2020 2020 2020 2020 2020 2020 2f2a 2054 /* T │ │ │ │ │ -0000e230: 4244 2e20 2a2f 0a20 2020 2020 2020 2020 BD. */. │ │ │ │ │ -0000e240: 207d 3b0a 0a20 2020 2020 2020 2020 2065 };.. e │ │ │ │ │ -0000e250: 6e75 6d20 6772 7562 5f76 6964 656f 5f62 num grub_video_b │ │ │ │ │ -0000e260: 6c69 745f 6f70 6572 6174 6f72 730a 2020 lit_operators. │ │ │ │ │ -0000e270: 2020 2020 2020 2020 2020 7b0a 2020 2020 {. │ │ │ │ │ -0000e280: 2020 2020 2020 2020 2020 4752 5542 5f56 GRUB_V │ │ │ │ │ -0000e290: 4944 454f 5f42 4c49 545f 5245 504c 4143 IDEO_BLIT_REPLAC │ │ │ │ │ -0000e2a0: 452c 0a20 2020 2020 2020 2020 2020 2020 E,. │ │ │ │ │ -0000e2b0: 2047 5255 425f 5649 4445 4f5f 424c 4954 GRUB_VIDEO_BLIT │ │ │ │ │ -0000e2c0: 5f42 4c45 4e44 0a20 2020 2020 2020 2020 _BLEND. │ │ │ │ │ -0000e2d0: 2020 207d 3b0a 2020 202a 2044 6573 6372 };. * Descr │ │ │ │ │ -0000e2e0: 6970 7469 6f6e 3a0a 0a20 2020 2020 5573 iption:.. Us │ │ │ │ │ -0000e2f0: 6564 2074 6f20 626c 6974 2062 6974 6d61 ed to blit bitma │ │ │ │ │ -0000e300: 7020 746f 2076 6965 7770 6f72 7420 696e p to viewport in │ │ │ │ │ -0000e310: 2073 7065 6369 6669 6564 2063 6f6f 7264 specified coord │ │ │ │ │ -0000e320: 696e 6174 6573 2e20 2049 6620 7061 7274 inates. If part │ │ │ │ │ -0000e330: 0a20 2020 2020 6f66 2062 6974 6d61 7020 . of bitmap │ │ │ │ │ -0000e340: 6973 206f 7574 7369 6465 206f 6620 7669 is outside of vi │ │ │ │ │ -0000e350: 6577 706f 7274 2072 6567 696f 6e2c 2069 ewport region, i │ │ │ │ │ -0000e360: 7420 7769 6c6c 2062 6520 636c 6970 7065 t will be clippe │ │ │ │ │ -0000e370: 6420 6f75 742e 0a20 2020 2020 4f66 6673 d out.. Offs │ │ │ │ │ -0000e380: 6574 7320 6166 6665 6374 2062 6974 6d61 ets affect bitma │ │ │ │ │ -0000e390: 7020 706f 7369 7469 6f6e 2077 6865 7265 p position where │ │ │ │ │ -0000e3a0: 2064 6174 6120 7769 6c6c 2062 6520 636f data will be co │ │ │ │ │ -0000e3b0: 7069 6564 2066 726f 6d2e 0a20 2020 2020 pied from.. │ │ │ │ │ -0000e3c0: 4e65 6761 7469 7665 2076 616c 7565 7320 Negative values │ │ │ │ │ -0000e3d0: 666f 7220 626f 7468 2076 6965 7770 6f72 for both viewpor │ │ │ │ │ -0000e3e0: 7420 636f 6f72 6469 6e61 7465 7320 616e t coordinates an │ │ │ │ │ -0000e3f0: 6420 6269 746d 6170 206f 6666 7365 740a d bitmap offset. │ │ │ │ │ -0000e400: 2020 2020 2063 6f6f 7264 696e 6174 6573 coordinates │ │ │ │ │ -0000e410: 2061 7265 2061 6c6c 6f77 6564 2e20 2049 are allowed. I │ │ │ │ │ -0000e420: 6620 6461 7461 2069 7320 6c6f 6f6b 6564 f data is looked │ │ │ │ │ -0000e430: 206f 7574 206f 6620 626f 756e 6473 206f out of bounds o │ │ │ │ │ -0000e440: 660a 2020 2020 2062 6974 6d61 702c 2063 f. bitmap, c │ │ │ │ │ -0000e450: 6f6c 6f72 2076 616c 7565 2077 696c 6c20 olor value will │ │ │ │ │ -0000e460: 6265 2061 7373 756d 6564 2074 6f20 6265 be assumed to be │ │ │ │ │ -0000e470: 2074 7261 6e73 7061 7265 6e74 2e20 2049 transparent. I │ │ │ │ │ -0000e480: 6620 7669 6577 706f 7274 0a20 2020 2020 f viewport. │ │ │ │ │ -0000e490: 636f 6f72 6469 6e61 7465 7320 6172 6520 coordinates are │ │ │ │ │ -0000e4a0: 6e65 6761 7469 7665 2c20 6172 6561 206f negative, area o │ │ │ │ │ -0000e4b0: 6620 7468 6520 626c 6974 7465 6420 7265 f the blitted re │ │ │ │ │ -0000e4c0: 6374 616e 676c 6520 7769 6c6c 2062 650a ctangle will be. │ │ │ │ │ -0000e4d0: 2020 2020 2073 6872 696e 6b65 6e20 746f shrinken to │ │ │ │ │ -0000e4e0: 2066 6f6c 6c6f 7720 7369 7a65 206c 696d follow size lim │ │ │ │ │ -0000e4f0: 6974 7320 6f66 2074 6865 2076 6965 7770 its of the viewp │ │ │ │ │ -0000e500: 6f72 7420 616e 6420 6269 746d 6170 2e0a ort and bitmap.. │ │ │ │ │ -0000e510: 2020 2020 2042 6c69 7474 696e 6720 6f70 Blitting op │ │ │ │ │ -0000e520: 6572 6174 6f72 2027 6f70 6572 2720 7370 erator 'oper' sp │ │ │ │ │ -0000e530: 6563 6966 6965 7320 7368 6f75 6c64 2073 ecifies should s │ │ │ │ │ -0000e540: 6f75 7263 6520 7069 7865 6c20 7265 706c ource pixel repl │ │ │ │ │ -0000e550: 6163 6520 6461 7461 0a20 2020 2020 696e ace data. in │ │ │ │ │ -0000e560: 2073 6372 6565 6e20 6f72 2062 6c65 6e64 screen or blend │ │ │ │ │ -0000e570: 2077 6974 6820 7069 7865 6c20 616c 7068 with pixel alph │ │ │ │ │ -0000e580: 6120 7661 6c75 652e 0a0a 2020 2020 2053 a value... S │ │ │ │ │ -0000e590: 6f66 7477 6172 6520 6465 7665 6c6f 7065 oftware develope │ │ │ │ │ -0000e5a0: 7220 7368 6f75 6c64 2075 7365 2027 6772 r should use 'gr │ │ │ │ │ -0000e5b0: 7562 5f76 6964 656f 5f62 6974 6d61 705f ub_video_bitmap_ │ │ │ │ │ -0000e5c0: 6372 6561 7465 2720 6f72 0a20 2020 2020 create' or. │ │ │ │ │ -0000e5d0: 2767 7275 625f 7669 6465 6f5f 6269 746d 'grub_video_bitm │ │ │ │ │ -0000e5e0: 6170 5f6c 6f61 6427 2074 6f20 6372 6561 ap_load' to crea │ │ │ │ │ -0000e5f0: 7465 206f 7220 6c6f 6164 2062 6974 6d61 te or load bitma │ │ │ │ │ -0000e600: 7020 6461 7461 2e0a 0a31 302e 312e 3230 p data...10.1.20 │ │ │ │ │ -0000e610: 2067 7275 625f 7669 6465 6f5f 626c 6974 grub_video_blit │ │ │ │ │ -0000e620: 5f72 656e 6465 725f 7461 7267 6574 0a2d _render_target.- │ │ │ │ │ +0000e100: 2d2d 2d2d 2d2d 2d2d 0a0a 2020 202a 2050 --------.. * P │ │ │ │ │ +0000e110: 726f 746f 7479 7065 3a0a 0a20 2020 2020 rototype:.. │ │ │ │ │ +0000e120: 2020 2020 2067 7275 625f 6572 725f 740a grub_err_t. │ │ │ │ │ +0000e130: 2020 2020 2020 2020 2020 6772 7562 5f76 grub_v │ │ │ │ │ +0000e140: 6964 656f 5f62 6c69 745f 6269 746d 6170 ideo_blit_bitmap │ │ │ │ │ +0000e150: 2028 7374 7275 6374 2067 7275 625f 7669 (struct grub_vi │ │ │ │ │ +0000e160: 6465 6f5f 6269 746d 6170 202a 6269 746d deo_bitmap *bitm │ │ │ │ │ +0000e170: 6170 2c20 656e 756d 2067 7275 625f 7669 ap, enum grub_vi │ │ │ │ │ +0000e180: 6465 6f5f 626c 6974 5f6f 7065 7261 746f deo_blit_operato │ │ │ │ │ +0000e190: 7273 206f 7065 722c 2069 6e74 2078 2c20 rs oper, int x, │ │ │ │ │ +0000e1a0: 696e 7420 792c 2069 6e74 206f 6666 7365 int y, int offse │ │ │ │ │ +0000e1b0: 745f 782c 2069 6e74 206f 6666 7365 745f t_x, int offset_ │ │ │ │ │ +0000e1c0: 792c 2075 6e73 6967 6e65 6420 696e 7420 y, unsigned int │ │ │ │ │ +0000e1d0: 7769 6474 682c 2075 6e73 6967 6e65 6420 width, unsigned │ │ │ │ │ +0000e1e0: 696e 7420 6865 6967 6874 293b 0a20 2020 int height);. │ │ │ │ │ +0000e1f0: 2020 2020 2020 2073 7472 7563 7420 6772 struct gr │ │ │ │ │ +0000e200: 7562 5f76 6964 656f 5f62 6974 6d61 700a ub_video_bitmap. │ │ │ │ │ +0000e210: 2020 2020 2020 2020 2020 7b0a 2020 2020 {. │ │ │ │ │ +0000e220: 2020 2020 2020 2020 2020 2f2a 2054 4244 /* TBD │ │ │ │ │ +0000e230: 2e20 2a2f 0a20 2020 2020 2020 2020 207d . */. } │ │ │ │ │ +0000e240: 3b0a 0a20 2020 2020 2020 2020 2065 6e75 ;.. enu │ │ │ │ │ +0000e250: 6d20 6772 7562 5f76 6964 656f 5f62 6c69 m grub_video_bli │ │ │ │ │ +0000e260: 745f 6f70 6572 6174 6f72 730a 2020 2020 t_operators. │ │ │ │ │ +0000e270: 2020 2020 2020 2020 7b0a 2020 2020 2020 {. │ │ │ │ │ +0000e280: 2020 2020 2020 2020 4752 5542 5f56 4944 GRUB_VID │ │ │ │ │ +0000e290: 454f 5f42 4c49 545f 5245 504c 4143 452c EO_BLIT_REPLACE, │ │ │ │ │ +0000e2a0: 0a20 2020 2020 2020 2020 2020 2020 2047 . G │ │ │ │ │ +0000e2b0: 5255 425f 5649 4445 4f5f 424c 4954 5f42 RUB_VIDEO_BLIT_B │ │ │ │ │ +0000e2c0: 4c45 4e44 0a20 2020 2020 2020 2020 2020 LEND. │ │ │ │ │ +0000e2d0: 207d 3b0a 2020 202a 2044 6573 6372 6970 };. * Descrip │ │ │ │ │ +0000e2e0: 7469 6f6e 3a0a 0a20 2020 2020 5573 6564 tion:.. Used │ │ │ │ │ +0000e2f0: 2074 6f20 626c 6974 2062 6974 6d61 7020 to blit bitmap │ │ │ │ │ +0000e300: 746f 2076 6965 7770 6f72 7420 696e 2073 to viewport in s │ │ │ │ │ +0000e310: 7065 6369 6669 6564 2063 6f6f 7264 696e pecified coordin │ │ │ │ │ +0000e320: 6174 6573 2e20 2049 6620 7061 7274 0a20 ates. If part. │ │ │ │ │ +0000e330: 2020 2020 6f66 2062 6974 6d61 7020 6973 of bitmap is │ │ │ │ │ +0000e340: 206f 7574 7369 6465 206f 6620 7669 6577 outside of view │ │ │ │ │ +0000e350: 706f 7274 2072 6567 696f 6e2c 2069 7420 port region, it │ │ │ │ │ +0000e360: 7769 6c6c 2062 6520 636c 6970 7065 6420 will be clipped │ │ │ │ │ +0000e370: 6f75 742e 0a20 2020 2020 4f66 6673 6574 out.. Offset │ │ │ │ │ +0000e380: 7320 6166 6665 6374 2062 6974 6d61 7020 s affect bitmap │ │ │ │ │ +0000e390: 706f 7369 7469 6f6e 2077 6865 7265 2064 position where d │ │ │ │ │ +0000e3a0: 6174 6120 7769 6c6c 2062 6520 636f 7069 ata will be copi │ │ │ │ │ +0000e3b0: 6564 2066 726f 6d2e 0a20 2020 2020 4e65 ed from.. Ne │ │ │ │ │ +0000e3c0: 6761 7469 7665 2076 616c 7565 7320 666f gative values fo │ │ │ │ │ +0000e3d0: 7220 626f 7468 2076 6965 7770 6f72 7420 r both viewport │ │ │ │ │ +0000e3e0: 636f 6f72 6469 6e61 7465 7320 616e 6420 coordinates and │ │ │ │ │ +0000e3f0: 6269 746d 6170 206f 6666 7365 740a 2020 bitmap offset. │ │ │ │ │ +0000e400: 2020 2063 6f6f 7264 696e 6174 6573 2061 coordinates a │ │ │ │ │ +0000e410: 7265 2061 6c6c 6f77 6564 2e20 2049 6620 re allowed. If │ │ │ │ │ +0000e420: 6461 7461 2069 7320 6c6f 6f6b 6564 206f data is looked o │ │ │ │ │ +0000e430: 7574 206f 6620 626f 756e 6473 206f 660a ut of bounds of. │ │ │ │ │ +0000e440: 2020 2020 2062 6974 6d61 702c 2063 6f6c bitmap, col │ │ │ │ │ +0000e450: 6f72 2076 616c 7565 2077 696c 6c20 6265 or value will be │ │ │ │ │ +0000e460: 2061 7373 756d 6564 2074 6f20 6265 2074 assumed to be t │ │ │ │ │ +0000e470: 7261 6e73 7061 7265 6e74 2e20 2049 6620 ransparent. If │ │ │ │ │ +0000e480: 7669 6577 706f 7274 0a20 2020 2020 636f viewport. co │ │ │ │ │ +0000e490: 6f72 6469 6e61 7465 7320 6172 6520 6e65 ordinates are ne │ │ │ │ │ +0000e4a0: 6761 7469 7665 2c20 6172 6561 206f 6620 gative, area of │ │ │ │ │ +0000e4b0: 7468 6520 626c 6974 7465 6420 7265 6374 the blitted rect │ │ │ │ │ +0000e4c0: 616e 676c 6520 7769 6c6c 2062 650a 2020 angle will be. │ │ │ │ │ +0000e4d0: 2020 2073 6872 696e 6b65 6e20 746f 2066 shrinken to f │ │ │ │ │ +0000e4e0: 6f6c 6c6f 7720 7369 7a65 206c 696d 6974 ollow size limit │ │ │ │ │ +0000e4f0: 7320 6f66 2074 6865 2076 6965 7770 6f72 s of the viewpor │ │ │ │ │ +0000e500: 7420 616e 6420 6269 746d 6170 2e0a 2020 t and bitmap.. │ │ │ │ │ +0000e510: 2020 2042 6c69 7474 696e 6720 6f70 6572 Blitting oper │ │ │ │ │ +0000e520: 6174 6f72 2027 6f70 6572 2720 7370 6563 ator 'oper' spec │ │ │ │ │ +0000e530: 6966 6965 7320 7368 6f75 6c64 2073 6f75 ifies should sou │ │ │ │ │ +0000e540: 7263 6520 7069 7865 6c20 7265 706c 6163 rce pixel replac │ │ │ │ │ +0000e550: 6520 6461 7461 0a20 2020 2020 696e 2073 e data. in s │ │ │ │ │ +0000e560: 6372 6565 6e20 6f72 2062 6c65 6e64 2077 creen or blend w │ │ │ │ │ +0000e570: 6974 6820 7069 7865 6c20 616c 7068 6120 ith pixel alpha │ │ │ │ │ +0000e580: 7661 6c75 652e 0a0a 2020 2020 2053 6f66 value... Sof │ │ │ │ │ +0000e590: 7477 6172 6520 6465 7665 6c6f 7065 7220 tware developer │ │ │ │ │ +0000e5a0: 7368 6f75 6c64 2075 7365 2027 6772 7562 should use 'grub │ │ │ │ │ +0000e5b0: 5f76 6964 656f 5f62 6974 6d61 705f 6372 _video_bitmap_cr │ │ │ │ │ +0000e5c0: 6561 7465 2720 6f72 0a20 2020 2020 2767 eate' or. 'g │ │ │ │ │ +0000e5d0: 7275 625f 7669 6465 6f5f 6269 746d 6170 rub_video_bitmap │ │ │ │ │ +0000e5e0: 5f6c 6f61 6427 2074 6f20 6372 6561 7465 _load' to create │ │ │ │ │ +0000e5f0: 206f 7220 6c6f 6164 2062 6974 6d61 7020 or load bitmap │ │ │ │ │ +0000e600: 6461 7461 2e0a 0a31 302e 312e 3230 2067 data...10.1.20 g │ │ │ │ │ +0000e610: 7275 625f 7669 6465 6f5f 626c 6974 5f72 rub_video_blit_r │ │ │ │ │ +0000e620: 656e 6465 725f 7461 7267 6574 0a2d 2d2d ender_target.--- │ │ │ │ │ 0000e630: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 0000e640: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000e650: 2d2d 2d2d 0a0a 2020 202a 2050 726f 746f ----.. * Proto │ │ │ │ │ -0000e660: 7479 7065 3a0a 0a20 2020 2020 2020 2020 type:.. │ │ │ │ │ -0000e670: 2067 7275 625f 6572 725f 740a 2020 2020 grub_err_t. │ │ │ │ │ -0000e680: 2020 2020 2020 6772 7562 5f76 6964 656f grub_video │ │ │ │ │ -0000e690: 5f62 6c69 745f 7265 6e64 6572 5f74 6172 _blit_render_tar │ │ │ │ │ -0000e6a0: 6765 7420 2873 7472 7563 7420 6772 7562 get (struct grub │ │ │ │ │ -0000e6b0: 5f76 6964 656f 5f72 656e 6465 725f 7461 _video_render_ta │ │ │ │ │ -0000e6c0: 7267 6574 202a 736f 7572 6365 2c20 656e rget *source, en │ │ │ │ │ -0000e6d0: 756d 2067 7275 625f 7669 6465 6f5f 626c um grub_video_bl │ │ │ │ │ -0000e6e0: 6974 5f6f 7065 7261 746f 7273 206f 7065 it_operators ope │ │ │ │ │ -0000e6f0: 722c 2069 6e74 2078 2c20 696e 7420 792c r, int x, int y, │ │ │ │ │ -0000e700: 2069 6e74 206f 6666 7365 745f 782c 2069 int offset_x, i │ │ │ │ │ -0000e710: 6e74 206f 6666 7365 745f 792c 2075 6e73 nt offset_y, uns │ │ │ │ │ -0000e720: 6967 6e65 6420 696e 7420 7769 6474 682c igned int width, │ │ │ │ │ -0000e730: 2075 6e73 6967 6e65 6420 696e 7420 6865 unsigned int he │ │ │ │ │ -0000e740: 6967 6874 293b 0a20 2020 2020 2020 2020 ight);. │ │ │ │ │ -0000e750: 2073 7472 7563 7420 6772 7562 5f76 6964 struct grub_vid │ │ │ │ │ -0000e760: 656f 5f72 656e 6465 725f 7461 7267 6574 eo_render_target │ │ │ │ │ -0000e770: 207b 0a20 2020 2020 2020 2020 2020 2020 {. │ │ │ │ │ -0000e780: 202f 2a20 5468 6973 2069 7320 7072 6976 /* This is priv │ │ │ │ │ -0000e790: 6174 6520 6461 7461 2066 6f72 2076 6964 ate data for vid │ │ │ │ │ -0000e7a0: 656f 2064 7269 7665 722e 2053 686f 756c eo driver. Shoul │ │ │ │ │ -0000e7b0: 6420 6e6f 7420 6265 2061 6363 6573 7365 d not be accesse │ │ │ │ │ -0000e7c0: 6420 6672 6f6d 2065 6c73 6577 6865 7265 d from elsewhere │ │ │ │ │ -0000e7d0: 2064 6972 6563 746c 792e 2020 2a2f 0a20 directly. */. │ │ │ │ │ -0000e7e0: 2020 2020 2020 2020 207d 3b0a 0a20 2020 };.. │ │ │ │ │ -0000e7f0: 2020 2020 2020 2065 6e75 6d20 6772 7562 enum grub │ │ │ │ │ -0000e800: 5f76 6964 656f 5f62 6c69 745f 6f70 6572 _video_blit_oper │ │ │ │ │ -0000e810: 6174 6f72 730a 2020 2020 2020 2020 2020 ators. │ │ │ │ │ -0000e820: 2020 7b0a 2020 2020 2020 2020 2020 2020 {. │ │ │ │ │ -0000e830: 2020 4752 5542 5f56 4944 454f 5f42 4c49 GRUB_VIDEO_BLI │ │ │ │ │ -0000e840: 545f 5245 504c 4143 452c 0a20 2020 2020 T_REPLACE,. │ │ │ │ │ -0000e850: 2020 2020 2020 2020 2047 5255 425f 5649 GRUB_VI │ │ │ │ │ -0000e860: 4445 4f5f 424c 4954 5f42 4c45 4e44 0a20 DEO_BLIT_BLEND. │ │ │ │ │ -0000e870: 2020 2020 2020 2020 2020 207d 3b0a 2020 };. │ │ │ │ │ -0000e880: 202a 2044 6573 6372 6970 7469 6f6e 3a0a * Description:. │ │ │ │ │ -0000e890: 0a20 2020 2020 5573 6564 2074 6f20 626c . Used to bl │ │ │ │ │ -0000e8a0: 6974 2073 6f75 7263 6520 7265 6e64 6572 it source render │ │ │ │ │ -0000e8b0: 2074 6172 6765 7420 746f 2076 6965 7770 target to viewp │ │ │ │ │ -0000e8c0: 6f72 7420 696e 2073 7065 6369 6669 6564 ort in specified │ │ │ │ │ -0000e8d0: 0a20 2020 2020 636f 6f72 6469 6e61 7465 . coordinate │ │ │ │ │ -0000e8e0: 732e 2020 4966 2070 6172 7420 6f66 2073 s. If part of s │ │ │ │ │ -0000e8f0: 6f75 7263 6520 7265 6e64 6572 2074 6172 ource render tar │ │ │ │ │ -0000e900: 6765 7420 6973 206f 7574 7369 6465 206f get is outside o │ │ │ │ │ -0000e910: 660a 2020 2020 2076 6965 7770 6f72 7420 f. viewport │ │ │ │ │ -0000e920: 7265 6769 6f6e 2c20 6974 2077 696c 6c20 region, it will │ │ │ │ │ -0000e930: 6265 2063 6c69 7070 6564 206f 7574 2e20 be clipped out. │ │ │ │ │ -0000e940: 2049 6620 626c 6974 7469 6e67 206f 7065 If blitting ope │ │ │ │ │ -0000e950: 7261 746f 7220 6973 0a20 2020 2020 7370 rator is. sp │ │ │ │ │ -0000e960: 6563 6966 6965 6420 616e 6420 736f 7572 ecified and sour │ │ │ │ │ -0000e970: 6365 2063 6f6e 7461 696e 7320 616c 7068 ce contains alph │ │ │ │ │ -0000e980: 6120 7661 6c75 6573 2c20 7265 7375 6c74 a values, result │ │ │ │ │ -0000e990: 696e 6720 7069 7865 6c20 636f 6c6f 720a ing pixel color. │ │ │ │ │ -0000e9a0: 2020 2020 2063 6f6d 706f 6e65 6e74 7320 components │ │ │ │ │ -0000e9b0: 7769 6c6c 2062 6520 6361 6c63 756c 6174 will be calculat │ │ │ │ │ -0000e9c0: 6564 2075 7369 6e67 2066 6f72 6d75 6c61 ed using formula │ │ │ │ │ -0000e9d0: 2028 2873 7263 5f63 6f6c 6f72 202a 0a20 ((src_color *. │ │ │ │ │ -0000e9e0: 2020 2020 7372 635f 616c 7068 6129 202b src_alpha) + │ │ │ │ │ -0000e9f0: 2028 6473 745f 636f 6c6f 7220 2a20 2832 (dst_color * (2 │ │ │ │ │ -0000ea00: 3535 202d 2073 7263 5f61 6c70 6861 2929 55 - src_alpha)) │ │ │ │ │ -0000ea10: 202f 2032 3535 2c20 6966 2074 6172 6765 / 255, if targe │ │ │ │ │ -0000ea20: 740a 2020 2020 2062 7566 6665 7220 6861 t. buffer ha │ │ │ │ │ -0000ea30: 7320 616c 7068 612c 2069 7420 7769 6c6c s alpha, it will │ │ │ │ │ -0000ea40: 2062 6520 7365 7420 746f 2073 7263 5f61 be set to src_a │ │ │ │ │ -0000ea50: 6c70 6861 2e20 204f 6666 7365 7473 2061 lpha. Offsets a │ │ │ │ │ -0000ea60: 6666 6563 740a 2020 2020 2072 656e 6465 ffect. rende │ │ │ │ │ -0000ea70: 7220 7461 7267 6574 2070 6f73 6974 696f r target positio │ │ │ │ │ -0000ea80: 6e20 7768 6572 6520 6461 7461 2077 696c n where data wil │ │ │ │ │ -0000ea90: 6c20 6265 2063 6f70 6965 6420 6672 6f6d l be copied from │ │ │ │ │ -0000eaa0: 2e20 2049 6620 6461 7461 2069 730a 2020 . If data is. │ │ │ │ │ -0000eab0: 2020 206c 6f6f 6b65 6420 6f75 7420 6f66 looked out of │ │ │ │ │ -0000eac0: 2062 6f75 6e64 7320 6f66 2072 656e 6465 bounds of rende │ │ │ │ │ -0000ead0: 7220 7461 7267 6574 2c20 636f 6c6f 7220 r target, color │ │ │ │ │ -0000eae0: 7661 6c75 6520 7769 6c6c 2062 6520 6173 value will be as │ │ │ │ │ -0000eaf0: 7375 6d65 640a 2020 2020 2074 6f20 6265 sumed. to be │ │ │ │ │ -0000eb00: 2074 7261 6e73 7061 7265 6e74 2e20 2042 transparent. B │ │ │ │ │ -0000eb10: 6c69 7474 696e 6720 6f70 6572 6174 6f72 litting operator │ │ │ │ │ -0000eb20: 2027 6f70 6572 2720 7370 6563 6966 6965 'oper' specifie │ │ │ │ │ -0000eb30: 7320 7368 6f75 6c64 0a20 2020 2020 736f s should. so │ │ │ │ │ -0000eb40: 7572 6365 2070 6978 656c 2072 6570 6c61 urce pixel repla │ │ │ │ │ -0000eb50: 6365 2064 6174 6120 696e 2073 6372 6565 ce data in scree │ │ │ │ │ -0000eb60: 6e20 6f72 2062 6c65 6e64 2077 6974 6820 n or blend with │ │ │ │ │ -0000eb70: 7069 7865 6c20 616c 7068 610a 2020 2020 pixel alpha. │ │ │ │ │ -0000eb80: 2076 616c 7565 2e0a 0a31 302e 312e 3231 value...10.1.21 │ │ │ │ │ -0000eb90: 2067 7275 625f 7669 6465 6f5f 7363 726f grub_video_scro │ │ │ │ │ -0000eba0: 6c6c 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ll.------------- │ │ │ │ │ -0000ebb0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2020 ------------.. │ │ │ │ │ -0000ebc0: 202a 2050 726f 746f 7479 7065 3a0a 0a20 * Prototype:.. │ │ │ │ │ -0000ebd0: 2020 2020 2020 2020 2067 7275 625f 6572 grub_er │ │ │ │ │ -0000ebe0: 725f 740a 2020 2020 2020 2020 2020 6772 r_t. gr │ │ │ │ │ -0000ebf0: 7562 5f76 6964 656f 5f73 6372 6f6c 6c20 ub_video_scroll │ │ │ │ │ -0000ec00: 2867 7275 625f 7669 6465 6f5f 636f 6c6f (grub_video_colo │ │ │ │ │ -0000ec10: 725f 7420 636f 6c6f 722c 2069 6e74 2064 r_t color, int d │ │ │ │ │ -0000ec20: 782c 2069 6e74 2064 7929 3b0a 2020 202a x, int dy);. * │ │ │ │ │ -0000ec30: 2044 6573 6372 6970 7469 6f6e 3a0a 0a20 Description:.. │ │ │ │ │ -0000ec40: 2020 2020 5573 6564 2074 6f20 7363 726f Used to scro │ │ │ │ │ -0000ec50: 6c6c 2076 6965 7770 6f72 7420 746f 2073 ll viewport to s │ │ │ │ │ -0000ec60: 7065 6369 6669 6564 2064 6972 6563 7469 pecified directi │ │ │ │ │ -0000ec70: 6f6e 2e20 204e 6577 2061 7265 6173 2061 on. New areas a │ │ │ │ │ -0000ec80: 7265 0a20 2020 2020 6669 6c6c 6564 2077 re. filled w │ │ │ │ │ -0000ec90: 6974 6820 7370 6563 6966 6965 6420 636f ith specified co │ │ │ │ │ -0000eca0: 6c6f 722e 2020 5468 6973 2066 756e 6374 lor. This funct │ │ │ │ │ -0000ecb0: 696f 6e20 6973 2075 7365 6420 7768 656e ion is used when │ │ │ │ │ -0000ecc0: 2073 6372 6565 6e20 6973 0a20 2020 2020 screen is. │ │ │ │ │ -0000ecd0: 7363 726f 6c6c 6572 2075 7020 696e 2076 scroller up in v │ │ │ │ │ -0000ece0: 6964 656f 2074 6572 6d69 6e61 6c2e 0a0a ideo terminal... │ │ │ │ │ -0000ecf0: 3130 2e31 2e32 3220 6772 7562 5f76 6964 10.1.22 grub_vid │ │ │ │ │ -0000ed00: 656f 5f73 7761 705f 6275 6666 6572 730a eo_swap_buffers. │ │ │ │ │ +0000e650: 2d2d 0a0a 2020 202a 2050 726f 746f 7479 --.. * Prototy │ │ │ │ │ +0000e660: 7065 3a0a 0a20 2020 2020 2020 2020 2067 pe:.. g │ │ │ │ │ +0000e670: 7275 625f 6572 725f 740a 2020 2020 2020 rub_err_t. │ │ │ │ │ +0000e680: 2020 2020 6772 7562 5f76 6964 656f 5f62 grub_video_b │ │ │ │ │ +0000e690: 6c69 745f 7265 6e64 6572 5f74 6172 6765 lit_render_targe │ │ │ │ │ +0000e6a0: 7420 2873 7472 7563 7420 6772 7562 5f76 t (struct grub_v │ │ │ │ │ +0000e6b0: 6964 656f 5f72 656e 6465 725f 7461 7267 ideo_render_targ │ │ │ │ │ +0000e6c0: 6574 202a 736f 7572 6365 2c20 656e 756d et *source, enum │ │ │ │ │ +0000e6d0: 2067 7275 625f 7669 6465 6f5f 626c 6974 grub_video_blit │ │ │ │ │ +0000e6e0: 5f6f 7065 7261 746f 7273 206f 7065 722c _operators oper, │ │ │ │ │ +0000e6f0: 2069 6e74 2078 2c20 696e 7420 792c 2069 int x, int y, i │ │ │ │ │ +0000e700: 6e74 206f 6666 7365 745f 782c 2069 6e74 nt offset_x, int │ │ │ │ │ +0000e710: 206f 6666 7365 745f 792c 2075 6e73 6967 offset_y, unsig │ │ │ │ │ +0000e720: 6e65 6420 696e 7420 7769 6474 682c 2075 ned int width, u │ │ │ │ │ +0000e730: 6e73 6967 6e65 6420 696e 7420 6865 6967 nsigned int heig │ │ │ │ │ +0000e740: 6874 293b 0a20 2020 2020 2020 2020 2073 ht);. s │ │ │ │ │ +0000e750: 7472 7563 7420 6772 7562 5f76 6964 656f truct grub_video │ │ │ │ │ +0000e760: 5f72 656e 6465 725f 7461 7267 6574 207b _render_target { │ │ │ │ │ +0000e770: 0a20 2020 2020 2020 2020 2020 2020 202f . / │ │ │ │ │ +0000e780: 2a20 5468 6973 2069 7320 7072 6976 6174 * This is privat │ │ │ │ │ +0000e790: 6520 6461 7461 2066 6f72 2076 6964 656f e data for video │ │ │ │ │ +0000e7a0: 2064 7269 7665 722e 2053 686f 756c 6420 driver. Should │ │ │ │ │ +0000e7b0: 6e6f 7420 6265 2061 6363 6573 7365 6420 not be accessed │ │ │ │ │ +0000e7c0: 6672 6f6d 2065 6c73 6577 6865 7265 2064 from elsewhere d │ │ │ │ │ +0000e7d0: 6972 6563 746c 792e 2020 2a2f 0a20 2020 irectly. */. │ │ │ │ │ +0000e7e0: 2020 2020 2020 207d 3b0a 0a20 2020 2020 };.. │ │ │ │ │ +0000e7f0: 2020 2020 2065 6e75 6d20 6772 7562 5f76 enum grub_v │ │ │ │ │ +0000e800: 6964 656f 5f62 6c69 745f 6f70 6572 6174 ideo_blit_operat │ │ │ │ │ +0000e810: 6f72 730a 2020 2020 2020 2020 2020 2020 ors. │ │ │ │ │ +0000e820: 7b0a 2020 2020 2020 2020 2020 2020 2020 {. │ │ │ │ │ +0000e830: 4752 5542 5f56 4944 454f 5f42 4c49 545f GRUB_VIDEO_BLIT_ │ │ │ │ │ +0000e840: 5245 504c 4143 452c 0a20 2020 2020 2020 REPLACE,. │ │ │ │ │ +0000e850: 2020 2020 2020 2047 5255 425f 5649 4445 GRUB_VIDE │ │ │ │ │ +0000e860: 4f5f 424c 4954 5f42 4c45 4e44 0a20 2020 O_BLIT_BLEND. │ │ │ │ │ +0000e870: 2020 2020 2020 2020 207d 3b0a 2020 202a };. * │ │ │ │ │ +0000e880: 2044 6573 6372 6970 7469 6f6e 3a0a 0a20 Description:.. │ │ │ │ │ +0000e890: 2020 2020 5573 6564 2074 6f20 626c 6974 Used to blit │ │ │ │ │ +0000e8a0: 2073 6f75 7263 6520 7265 6e64 6572 2074 source render t │ │ │ │ │ +0000e8b0: 6172 6765 7420 746f 2076 6965 7770 6f72 arget to viewpor │ │ │ │ │ +0000e8c0: 7420 696e 2073 7065 6369 6669 6564 0a20 t in specified. │ │ │ │ │ +0000e8d0: 2020 2020 636f 6f72 6469 6e61 7465 732e coordinates. │ │ │ │ │ +0000e8e0: 2020 4966 2070 6172 7420 6f66 2073 6f75 If part of sou │ │ │ │ │ +0000e8f0: 7263 6520 7265 6e64 6572 2074 6172 6765 rce render targe │ │ │ │ │ +0000e900: 7420 6973 206f 7574 7369 6465 206f 660a t is outside of. │ │ │ │ │ +0000e910: 2020 2020 2076 6965 7770 6f72 7420 7265 viewport re │ │ │ │ │ +0000e920: 6769 6f6e 2c20 6974 2077 696c 6c20 6265 gion, it will be │ │ │ │ │ +0000e930: 2063 6c69 7070 6564 206f 7574 2e20 2049 clipped out. I │ │ │ │ │ +0000e940: 6620 626c 6974 7469 6e67 206f 7065 7261 f blitting opera │ │ │ │ │ +0000e950: 746f 7220 6973 0a20 2020 2020 7370 6563 tor is. spec │ │ │ │ │ +0000e960: 6966 6965 6420 616e 6420 736f 7572 6365 ified and source │ │ │ │ │ +0000e970: 2063 6f6e 7461 696e 7320 616c 7068 6120 contains alpha │ │ │ │ │ +0000e980: 7661 6c75 6573 2c20 7265 7375 6c74 696e values, resultin │ │ │ │ │ +0000e990: 6720 7069 7865 6c20 636f 6c6f 720a 2020 g pixel color. │ │ │ │ │ +0000e9a0: 2020 2063 6f6d 706f 6e65 6e74 7320 7769 components wi │ │ │ │ │ +0000e9b0: 6c6c 2062 6520 6361 6c63 756c 6174 6564 ll be calculated │ │ │ │ │ +0000e9c0: 2075 7369 6e67 2066 6f72 6d75 6c61 2028 using formula ( │ │ │ │ │ +0000e9d0: 2873 7263 5f63 6f6c 6f72 202a 0a20 2020 (src_color *. │ │ │ │ │ +0000e9e0: 2020 7372 635f 616c 7068 6129 202b 2028 src_alpha) + ( │ │ │ │ │ +0000e9f0: 6473 745f 636f 6c6f 7220 2a20 2832 3535 dst_color * (255 │ │ │ │ │ +0000ea00: 202d 2073 7263 5f61 6c70 6861 2929 202f - src_alpha)) / │ │ │ │ │ +0000ea10: 2032 3535 2c20 6966 2074 6172 6765 740a 255, if target. │ │ │ │ │ +0000ea20: 2020 2020 2062 7566 6665 7220 6861 7320 buffer has │ │ │ │ │ +0000ea30: 616c 7068 612c 2069 7420 7769 6c6c 2062 alpha, it will b │ │ │ │ │ +0000ea40: 6520 7365 7420 746f 2073 7263 5f61 6c70 e set to src_alp │ │ │ │ │ +0000ea50: 6861 2e20 204f 6666 7365 7473 2061 6666 ha. Offsets aff │ │ │ │ │ +0000ea60: 6563 740a 2020 2020 2072 656e 6465 7220 ect. render │ │ │ │ │ +0000ea70: 7461 7267 6574 2070 6f73 6974 696f 6e20 target position │ │ │ │ │ +0000ea80: 7768 6572 6520 6461 7461 2077 696c 6c20 where data will │ │ │ │ │ +0000ea90: 6265 2063 6f70 6965 6420 6672 6f6d 2e20 be copied from. │ │ │ │ │ +0000eaa0: 2049 6620 6461 7461 2069 730a 2020 2020 If data is. │ │ │ │ │ +0000eab0: 206c 6f6f 6b65 6420 6f75 7420 6f66 2062 looked out of b │ │ │ │ │ +0000eac0: 6f75 6e64 7320 6f66 2072 656e 6465 7220 ounds of render │ │ │ │ │ +0000ead0: 7461 7267 6574 2c20 636f 6c6f 7220 7661 target, color va │ │ │ │ │ +0000eae0: 6c75 6520 7769 6c6c 2062 6520 6173 7375 lue will be assu │ │ │ │ │ +0000eaf0: 6d65 640a 2020 2020 2074 6f20 6265 2074 med. to be t │ │ │ │ │ +0000eb00: 7261 6e73 7061 7265 6e74 2e20 2042 6c69 ransparent. Bli │ │ │ │ │ +0000eb10: 7474 696e 6720 6f70 6572 6174 6f72 2027 tting operator ' │ │ │ │ │ +0000eb20: 6f70 6572 2720 7370 6563 6966 6965 7320 oper' specifies │ │ │ │ │ +0000eb30: 7368 6f75 6c64 0a20 2020 2020 736f 7572 should. sour │ │ │ │ │ +0000eb40: 6365 2070 6978 656c 2072 6570 6c61 6365 ce pixel replace │ │ │ │ │ +0000eb50: 2064 6174 6120 696e 2073 6372 6565 6e20 data in screen │ │ │ │ │ +0000eb60: 6f72 2062 6c65 6e64 2077 6974 6820 7069 or blend with pi │ │ │ │ │ +0000eb70: 7865 6c20 616c 7068 610a 2020 2020 2076 xel alpha. v │ │ │ │ │ +0000eb80: 616c 7565 2e0a 0a31 302e 312e 3231 2067 alue...10.1.21 g │ │ │ │ │ +0000eb90: 7275 625f 7669 6465 6f5f 7363 726f 6c6c rub_video_scroll │ │ │ │ │ +0000eba0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ │ +0000ebb0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2020 202a ----------.. * │ │ │ │ │ +0000ebc0: 2050 726f 746f 7479 7065 3a0a 0a20 2020 Prototype:.. │ │ │ │ │ +0000ebd0: 2020 2020 2020 2067 7275 625f 6572 725f grub_err_ │ │ │ │ │ +0000ebe0: 740a 2020 2020 2020 2020 2020 6772 7562 t. grub │ │ │ │ │ +0000ebf0: 5f76 6964 656f 5f73 6372 6f6c 6c20 2867 _video_scroll (g │ │ │ │ │ +0000ec00: 7275 625f 7669 6465 6f5f 636f 6c6f 725f rub_video_color_ │ │ │ │ │ +0000ec10: 7420 636f 6c6f 722c 2069 6e74 2064 782c t color, int dx, │ │ │ │ │ +0000ec20: 2069 6e74 2064 7929 3b0a 2020 202a 2044 int dy);. * D │ │ │ │ │ +0000ec30: 6573 6372 6970 7469 6f6e 3a0a 0a20 2020 escription:.. │ │ │ │ │ +0000ec40: 2020 5573 6564 2074 6f20 7363 726f 6c6c Used to scroll │ │ │ │ │ +0000ec50: 2076 6965 7770 6f72 7420 746f 2073 7065 viewport to spe │ │ │ │ │ +0000ec60: 6369 6669 6564 2064 6972 6563 7469 6f6e cified direction │ │ │ │ │ +0000ec70: 2e20 204e 6577 2061 7265 6173 2061 7265 . New areas are │ │ │ │ │ +0000ec80: 0a20 2020 2020 6669 6c6c 6564 2077 6974 . filled wit │ │ │ │ │ +0000ec90: 6820 7370 6563 6966 6965 6420 636f 6c6f h specified colo │ │ │ │ │ +0000eca0: 722e 2020 5468 6973 2066 756e 6374 696f r. This functio │ │ │ │ │ +0000ecb0: 6e20 6973 2075 7365 6420 7768 656e 2073 n is used when s │ │ │ │ │ +0000ecc0: 6372 6565 6e20 6973 0a20 2020 2020 7363 creen is. sc │ │ │ │ │ +0000ecd0: 726f 6c6c 6572 2075 7020 696e 2076 6964 roller up in vid │ │ │ │ │ +0000ece0: 656f 2074 6572 6d69 6e61 6c2e 0a0a 3130 eo terminal...10 │ │ │ │ │ +0000ecf0: 2e31 2e32 3220 6772 7562 5f76 6964 656f .1.22 grub_video │ │ │ │ │ +0000ed00: 5f73 7761 705f 6275 6666 6572 730a 2d2d _swap_buffers.-- │ │ │ │ │ 0000ed10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000ed20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ -0000ed30: 0a20 2020 2a20 5072 6f74 6f74 7970 653a . * Prototype: │ │ │ │ │ -0000ed40: 0a0a 2020 2020 2020 2020 2020 6772 7562 .. grub │ │ │ │ │ -0000ed50: 5f65 7272 5f74 0a20 2020 2020 2020 2020 _err_t. │ │ │ │ │ -0000ed60: 2067 7275 625f 7669 6465 6f5f 7377 6170 grub_video_swap │ │ │ │ │ -0000ed70: 5f62 7566 6665 7273 2028 766f 6964 293b _buffers (void); │ │ │ │ │ -0000ed80: 0a20 2020 2a20 4465 7363 7269 7074 696f . * Descriptio │ │ │ │ │ -0000ed90: 6e3a 0a0a 2020 2020 2049 6620 646f 7562 n:.. If doub │ │ │ │ │ -0000eda0: 6c65 2062 7566 6665 7269 6e67 2069 7320 le buffering is │ │ │ │ │ -0000edb0: 656e 6162 6c65 642c 2074 6869 7320 7377 enabled, this sw │ │ │ │ │ -0000edc0: 6170 7320 6672 6f6e 7462 7566 6665 7220 aps frontbuffer │ │ │ │ │ -0000edd0: 616e 640a 2020 2020 2062 6163 6b62 7566 and. backbuf │ │ │ │ │ -0000ede0: 6665 722c 2069 6e20 6f72 6465 7220 746f fer, in order to │ │ │ │ │ -0000edf0: 2073 686f 7720 7661 6c75 6573 2064 7261 show values dra │ │ │ │ │ -0000ee00: 776e 2074 6f20 6261 636b 2062 7566 6665 wn to back buffe │ │ │ │ │ -0000ee10: 722e 2020 5669 6465 6f0a 2020 2020 2064 r. Video. d │ │ │ │ │ -0000ee20: 7269 7665 7220 6973 2066 7265 6520 746f river is free to │ │ │ │ │ -0000ee30: 2063 686f 6f73 6520 686f 7720 7468 6973 choose how this │ │ │ │ │ -0000ee40: 206f 7065 7261 7469 6f6e 2069 7320 7465 operation is te │ │ │ │ │ -0000ee50: 6368 696e 6361 6c6c 7920 646f 6e65 2e0a chincally done.. │ │ │ │ │ -0000ee60: 0a31 302e 312e 3233 2067 7275 625f 7669 .10.1.23 grub_vi │ │ │ │ │ -0000ee70: 6465 6f5f 6372 6561 7465 5f72 656e 6465 deo_create_rende │ │ │ │ │ -0000ee80: 725f 7461 7267 6574 0a2d 2d2d 2d2d 2d2d r_target.------- │ │ │ │ │ +0000ed20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 -------------.. │ │ │ │ │ +0000ed30: 2020 2a20 5072 6f74 6f74 7970 653a 0a0a * Prototype:.. │ │ │ │ │ +0000ed40: 2020 2020 2020 2020 2020 6772 7562 5f65 grub_e │ │ │ │ │ +0000ed50: 7272 5f74 0a20 2020 2020 2020 2020 2067 rr_t. g │ │ │ │ │ +0000ed60: 7275 625f 7669 6465 6f5f 7377 6170 5f62 rub_video_swap_b │ │ │ │ │ +0000ed70: 7566 6665 7273 2028 766f 6964 293b 0a20 uffers (void);. │ │ │ │ │ +0000ed80: 2020 2a20 4465 7363 7269 7074 696f 6e3a * Description: │ │ │ │ │ +0000ed90: 0a0a 2020 2020 2049 6620 646f 7562 6c65 .. If double │ │ │ │ │ +0000eda0: 2062 7566 6665 7269 6e67 2069 7320 656e buffering is en │ │ │ │ │ +0000edb0: 6162 6c65 642c 2074 6869 7320 7377 6170 abled, this swap │ │ │ │ │ +0000edc0: 7320 6672 6f6e 7462 7566 6665 7220 616e s frontbuffer an │ │ │ │ │ +0000edd0: 640a 2020 2020 2062 6163 6b62 7566 6665 d. backbuffe │ │ │ │ │ +0000ede0: 722c 2069 6e20 6f72 6465 7220 746f 2073 r, in order to s │ │ │ │ │ +0000edf0: 686f 7720 7661 6c75 6573 2064 7261 776e how values drawn │ │ │ │ │ +0000ee00: 2074 6f20 6261 636b 2062 7566 6665 722e to back buffer. │ │ │ │ │ +0000ee10: 2020 5669 6465 6f0a 2020 2020 2064 7269 Video. dri │ │ │ │ │ +0000ee20: 7665 7220 6973 2066 7265 6520 746f 2063 ver is free to c │ │ │ │ │ +0000ee30: 686f 6f73 6520 686f 7720 7468 6973 206f hoose how this o │ │ │ │ │ +0000ee40: 7065 7261 7469 6f6e 2069 7320 7465 6368 peration is tech │ │ │ │ │ +0000ee50: 696e 6361 6c6c 7920 646f 6e65 2e0a 0a31 incally done...1 │ │ │ │ │ +0000ee60: 302e 312e 3233 2067 7275 625f 7669 6465 0.1.23 grub_vide │ │ │ │ │ +0000ee70: 6f5f 6372 6561 7465 5f72 656e 6465 725f o_create_render_ │ │ │ │ │ +0000ee80: 7461 7267 6574 0a2d 2d2d 2d2d 2d2d 2d2d target.--------- │ │ │ │ │ 0000ee90: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000eea0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000eeb0: 0a0a 2020 202a 2050 726f 746f 7479 7065 .. * Prototype │ │ │ │ │ -0000eec0: 3a0a 0a20 2020 2020 2020 2020 2067 7275 :.. gru │ │ │ │ │ -0000eed0: 625f 6572 725f 740a 2020 2020 2020 2020 b_err_t. │ │ │ │ │ -0000eee0: 2020 6772 7562 5f76 6964 656f 5f63 7265 grub_video_cre │ │ │ │ │ -0000eef0: 6174 655f 7265 6e64 6572 5f74 6172 6765 ate_render_targe │ │ │ │ │ -0000ef00: 7420 2873 7472 7563 7420 6772 7562 5f76 t (struct grub_v │ │ │ │ │ -0000ef10: 6964 656f 5f72 656e 6465 725f 7461 7267 ideo_render_targ │ │ │ │ │ -0000ef20: 6574 202a 2a72 6573 756c 742c 2075 6e73 et **result, uns │ │ │ │ │ -0000ef30: 6967 6e65 6420 696e 7420 7769 6474 682c igned int width, │ │ │ │ │ -0000ef40: 2075 6e73 6967 6e65 6420 696e 7420 6865 unsigned int he │ │ │ │ │ -0000ef50: 6967 6874 2c20 756e 7369 676e 6564 2069 ight, unsigned i │ │ │ │ │ -0000ef60: 6e74 206d 6f64 655f 7479 7065 293b 0a20 nt mode_type);. │ │ │ │ │ -0000ef70: 2020 2020 2020 2020 2073 7472 7563 7420 struct │ │ │ │ │ -0000ef80: 6772 7562 5f76 6964 656f 5f72 656e 6465 grub_video_rende │ │ │ │ │ -0000ef90: 725f 7461 7267 6574 207b 0a20 2020 2020 r_target {. │ │ │ │ │ -0000efa0: 2020 2020 2020 2020 202f 2a20 5468 6973 /* This │ │ │ │ │ -0000efb0: 2069 7320 7072 6976 6174 6520 6461 7461 is private data │ │ │ │ │ -0000efc0: 2066 6f72 2076 6964 656f 2064 7269 7665 for video drive │ │ │ │ │ -0000efd0: 722e 2053 686f 756c 6420 6e6f 7420 6265 r. Should not be │ │ │ │ │ -0000efe0: 2061 6363 6573 7365 6420 6672 6f6d 2065 accessed from e │ │ │ │ │ -0000eff0: 6c73 6577 6865 7265 2064 6972 6563 746c lsewhere directl │ │ │ │ │ -0000f000: 792e 2020 2a2f 0a20 2020 2020 2020 2020 y. */. │ │ │ │ │ -0000f010: 207d 3b0a 2020 202a 2044 6573 6372 6970 };. * Descrip │ │ │ │ │ -0000f020: 7469 6f6e 3a0a 0a20 2020 2020 4472 6976 tion:.. Driv │ │ │ │ │ -0000f030: 6572 2077 696c 6c20 7573 6520 696e 666f er will use info │ │ │ │ │ -0000f040: 726d 6174 696f 6e20 7072 6f76 6964 6564 rmation provided │ │ │ │ │ -0000f050: 2074 6f20 6974 2074 6f20 6372 6561 7465 to it to create │ │ │ │ │ -0000f060: 2062 6573 7420 6669 7474 696e 670a 2020 best fitting. │ │ │ │ │ -0000f070: 2020 2072 656e 6465 7220 7461 7267 6574 render target │ │ │ │ │ -0000f080: 2e20 2027 6d6f 6465 5f74 7970 6527 2077 . 'mode_type' w │ │ │ │ │ -0000f090: 696c 6c20 6265 2075 7365 6420 746f 2067 ill be used to g │ │ │ │ │ -0000f0a0: 7569 6465 206f 6e20 7365 6c65 6374 696e uide on selectin │ │ │ │ │ -0000f0b0: 6720 7768 6174 0a20 2020 2020 6665 6174 g what. feat │ │ │ │ │ -0000f0c0: 7572 6573 2061 7265 2077 616e 7465 6420 ures are wanted │ │ │ │ │ -0000f0d0: 666f 7220 7265 6e64 6572 2074 6172 6765 for render targe │ │ │ │ │ -0000f0e0: 742e 2020 5375 7070 6f72 7465 6420 7661 t. Supported va │ │ │ │ │ -0000f0f0: 6c75 6573 2066 6f72 0a20 2020 2020 276d lues for. 'm │ │ │ │ │ -0000f100: 6f64 655f 7479 7065 2720 6172 6520 2747 ode_type' are 'G │ │ │ │ │ -0000f110: 5255 425f 5649 4445 4f5f 4d4f 4445 5f54 RUB_VIDEO_MODE_T │ │ │ │ │ -0000f120: 5950 455f 494e 4445 585f 434f 4c4f 5227 YPE_INDEX_COLOR' │ │ │ │ │ -0000f130: 2066 6f72 2069 6e64 6578 2063 6f6c 6f72 for index color │ │ │ │ │ -0000f140: 0a20 2020 2020 6d6f 6465 732c 2027 4752 . modes, 'GR │ │ │ │ │ -0000f150: 5542 5f56 4944 454f 5f4d 4f44 455f 5459 UB_VIDEO_MODE_TY │ │ │ │ │ -0000f160: 5045 5f52 4742 2720 666f 7220 6469 7265 PE_RGB' for dire │ │ │ │ │ -0000f170: 6374 2052 4742 2063 6f6c 6f72 206d 6f64 ct RGB color mod │ │ │ │ │ -0000f180: 6573 2061 6e64 0a20 2020 2020 2747 5255 es and. 'GRU │ │ │ │ │ -0000f190: 425f 5649 4445 4f5f 4d4f 4445 5f54 5950 B_VIDEO_MODE_TYP │ │ │ │ │ -0000f1a0: 455f 414c 5048 4127 2066 6f72 2061 6c70 E_ALPHA' for alp │ │ │ │ │ -0000f1b0: 6861 2063 6f6d 706f 6e65 6e74 2e0a 0a31 ha component...1 │ │ │ │ │ -0000f1c0: 302e 312e 3234 2067 7275 625f 7669 6465 0.1.24 grub_vide │ │ │ │ │ -0000f1d0: 6f5f 6465 6c65 7465 5f72 656e 6465 725f o_delete_render_ │ │ │ │ │ -0000f1e0: 7461 7267 6574 0a2d 2d2d 2d2d 2d2d 2d2d target.--------- │ │ │ │ │ +0000eea0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ +0000eeb0: 2020 202a 2050 726f 746f 7479 7065 3a0a * Prototype:. │ │ │ │ │ +0000eec0: 0a20 2020 2020 2020 2020 2067 7275 625f . grub_ │ │ │ │ │ +0000eed0: 6572 725f 740a 2020 2020 2020 2020 2020 err_t. │ │ │ │ │ +0000eee0: 6772 7562 5f76 6964 656f 5f63 7265 6174 grub_video_creat │ │ │ │ │ +0000eef0: 655f 7265 6e64 6572 5f74 6172 6765 7420 e_render_target │ │ │ │ │ +0000ef00: 2873 7472 7563 7420 6772 7562 5f76 6964 (struct grub_vid │ │ │ │ │ +0000ef10: 656f 5f72 656e 6465 725f 7461 7267 6574 eo_render_target │ │ │ │ │ +0000ef20: 202a 2a72 6573 756c 742c 2075 6e73 6967 **result, unsig │ │ │ │ │ +0000ef30: 6e65 6420 696e 7420 7769 6474 682c 2075 ned int width, u │ │ │ │ │ +0000ef40: 6e73 6967 6e65 6420 696e 7420 6865 6967 nsigned int heig │ │ │ │ │ +0000ef50: 6874 2c20 756e 7369 676e 6564 2069 6e74 ht, unsigned int │ │ │ │ │ +0000ef60: 206d 6f64 655f 7479 7065 293b 0a20 2020 mode_type);. │ │ │ │ │ +0000ef70: 2020 2020 2020 2073 7472 7563 7420 6772 struct gr │ │ │ │ │ +0000ef80: 7562 5f76 6964 656f 5f72 656e 6465 725f ub_video_render_ │ │ │ │ │ +0000ef90: 7461 7267 6574 207b 0a20 2020 2020 2020 target {. │ │ │ │ │ +0000efa0: 2020 2020 2020 202f 2a20 5468 6973 2069 /* This i │ │ │ │ │ +0000efb0: 7320 7072 6976 6174 6520 6461 7461 2066 s private data f │ │ │ │ │ +0000efc0: 6f72 2076 6964 656f 2064 7269 7665 722e or video driver. │ │ │ │ │ +0000efd0: 2053 686f 756c 6420 6e6f 7420 6265 2061 Should not be a │ │ │ │ │ +0000efe0: 6363 6573 7365 6420 6672 6f6d 2065 6c73 ccessed from els │ │ │ │ │ +0000eff0: 6577 6865 7265 2064 6972 6563 746c 792e ewhere directly. │ │ │ │ │ +0000f000: 2020 2a2f 0a20 2020 2020 2020 2020 207d */. } │ │ │ │ │ +0000f010: 3b0a 2020 202a 2044 6573 6372 6970 7469 ;. * Descripti │ │ │ │ │ +0000f020: 6f6e 3a0a 0a20 2020 2020 4472 6976 6572 on:.. Driver │ │ │ │ │ +0000f030: 2077 696c 6c20 7573 6520 696e 666f 726d will use inform │ │ │ │ │ +0000f040: 6174 696f 6e20 7072 6f76 6964 6564 2074 ation provided t │ │ │ │ │ +0000f050: 6f20 6974 2074 6f20 6372 6561 7465 2062 o it to create b │ │ │ │ │ +0000f060: 6573 7420 6669 7474 696e 670a 2020 2020 est fitting. │ │ │ │ │ +0000f070: 2072 656e 6465 7220 7461 7267 6574 2e20 render target. │ │ │ │ │ +0000f080: 2027 6d6f 6465 5f74 7970 6527 2077 696c 'mode_type' wil │ │ │ │ │ +0000f090: 6c20 6265 2075 7365 6420 746f 2067 7569 l be used to gui │ │ │ │ │ +0000f0a0: 6465 206f 6e20 7365 6c65 6374 696e 6720 de on selecting │ │ │ │ │ +0000f0b0: 7768 6174 0a20 2020 2020 6665 6174 7572 what. featur │ │ │ │ │ +0000f0c0: 6573 2061 7265 2077 616e 7465 6420 666f es are wanted fo │ │ │ │ │ +0000f0d0: 7220 7265 6e64 6572 2074 6172 6765 742e r render target. │ │ │ │ │ +0000f0e0: 2020 5375 7070 6f72 7465 6420 7661 6c75 Supported valu │ │ │ │ │ +0000f0f0: 6573 2066 6f72 0a20 2020 2020 276d 6f64 es for. 'mod │ │ │ │ │ +0000f100: 655f 7479 7065 2720 6172 6520 2747 5255 e_type' are 'GRU │ │ │ │ │ +0000f110: 425f 5649 4445 4f5f 4d4f 4445 5f54 5950 B_VIDEO_MODE_TYP │ │ │ │ │ +0000f120: 455f 494e 4445 585f 434f 4c4f 5227 2066 E_INDEX_COLOR' f │ │ │ │ │ +0000f130: 6f72 2069 6e64 6578 2063 6f6c 6f72 0a20 or index color. │ │ │ │ │ +0000f140: 2020 2020 6d6f 6465 732c 2027 4752 5542 modes, 'GRUB │ │ │ │ │ +0000f150: 5f56 4944 454f 5f4d 4f44 455f 5459 5045 _VIDEO_MODE_TYPE │ │ │ │ │ +0000f160: 5f52 4742 2720 666f 7220 6469 7265 6374 _RGB' for direct │ │ │ │ │ +0000f170: 2052 4742 2063 6f6c 6f72 206d 6f64 6573 RGB color modes │ │ │ │ │ +0000f180: 2061 6e64 0a20 2020 2020 2747 5255 425f and. 'GRUB_ │ │ │ │ │ +0000f190: 5649 4445 4f5f 4d4f 4445 5f54 5950 455f VIDEO_MODE_TYPE_ │ │ │ │ │ +0000f1a0: 414c 5048 4127 2066 6f72 2061 6c70 6861 ALPHA' for alpha │ │ │ │ │ +0000f1b0: 2063 6f6d 706f 6e65 6e74 2e0a 0a31 302e component...10. │ │ │ │ │ +0000f1c0: 312e 3234 2067 7275 625f 7669 6465 6f5f 1.24 grub_video_ │ │ │ │ │ +0000f1d0: 6465 6c65 7465 5f72 656e 6465 725f 7461 delete_render_ta │ │ │ │ │ +0000f1e0: 7267 6574 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d rget.----------- │ │ │ │ │ 0000f1f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000f200: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ -0000f210: 2020 202a 2050 726f 746f 7479 7065 3a0a * Prototype:. │ │ │ │ │ -0000f220: 0a20 2020 2020 2020 2020 2067 7275 625f . grub_ │ │ │ │ │ -0000f230: 6572 725f 740a 2020 2020 2020 2020 2020 err_t. │ │ │ │ │ -0000f240: 6772 7562 5f76 6964 656f 5f64 656c 6574 grub_video_delet │ │ │ │ │ -0000f250: 655f 7265 6e64 6572 5f74 6172 6765 7420 e_render_target │ │ │ │ │ -0000f260: 2873 7472 7563 7420 6772 7562 5f76 6964 (struct grub_vid │ │ │ │ │ -0000f270: 656f 5f72 656e 6465 725f 7461 7267 6574 eo_render_target │ │ │ │ │ -0000f280: 202a 7461 7267 6574 293b 0a20 2020 2a20 *target);. * │ │ │ │ │ -0000f290: 4465 7363 7269 7074 696f 6e3a 0a0a 2020 Description:.. │ │ │ │ │ -0000f2a0: 2020 2055 7365 6420 746f 2064 656c 6574 Used to delet │ │ │ │ │ -0000f2b0: 6520 7072 6576 696f 7573 6c79 2063 7265 e previously cre │ │ │ │ │ -0000f2c0: 6174 6564 2072 656e 6465 7220 7461 7267 ated render targ │ │ │ │ │ -0000f2d0: 6574 2e20 2049 6620 2774 6172 6765 7427 et. If 'target' │ │ │ │ │ -0000f2e0: 0a20 2020 2020 636f 6e74 6169 6e73 2027 . contains ' │ │ │ │ │ -0000f2f0: 4e55 4c4c 2720 706f 696e 7465 722c 206e NULL' pointer, n │ │ │ │ │ -0000f300: 6f74 6869 6e67 2077 696c 6c20 6265 2064 othing will be d │ │ │ │ │ -0000f310: 6f6e 652e 2020 4966 2072 656e 6465 7220 one. If render │ │ │ │ │ -0000f320: 7461 7267 6574 2069 730a 2020 2020 2063 target is. c │ │ │ │ │ -0000f330: 6f72 7265 6374 6c79 2064 6573 7472 6f79 orrectly destroy │ │ │ │ │ -0000f340: 6564 2c20 4752 5542 5f45 5252 5f4e 4f4e ed, GRUB_ERR_NON │ │ │ │ │ -0000f350: 4520 6973 2072 6574 7572 6e65 642e 0a0a E is returned... │ │ │ │ │ -0000f360: 3130 2e31 2e32 3520 6772 7562 5f76 6964 10.1.25 grub_vid │ │ │ │ │ -0000f370: 656f 5f73 6574 5f61 6374 6976 655f 7265 eo_set_active_re │ │ │ │ │ -0000f380: 6e64 6572 5f74 6172 6765 740a 2d2d 2d2d nder_target.---- │ │ │ │ │ +0000f200: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2020 ------------.. │ │ │ │ │ +0000f210: 202a 2050 726f 746f 7479 7065 3a0a 0a20 * Prototype:.. │ │ │ │ │ +0000f220: 2020 2020 2020 2020 2067 7275 625f 6572 grub_er │ │ │ │ │ +0000f230: 725f 740a 2020 2020 2020 2020 2020 6772 r_t. gr │ │ │ │ │ +0000f240: 7562 5f76 6964 656f 5f64 656c 6574 655f ub_video_delete_ │ │ │ │ │ +0000f250: 7265 6e64 6572 5f74 6172 6765 7420 2873 render_target (s │ │ │ │ │ +0000f260: 7472 7563 7420 6772 7562 5f76 6964 656f truct grub_video │ │ │ │ │ +0000f270: 5f72 656e 6465 725f 7461 7267 6574 202a _render_target * │ │ │ │ │ +0000f280: 7461 7267 6574 293b 0a20 2020 2a20 4465 target);. * De │ │ │ │ │ +0000f290: 7363 7269 7074 696f 6e3a 0a0a 2020 2020 scription:.. │ │ │ │ │ +0000f2a0: 2055 7365 6420 746f 2064 656c 6574 6520 Used to delete │ │ │ │ │ +0000f2b0: 7072 6576 696f 7573 6c79 2063 7265 6174 previously creat │ │ │ │ │ +0000f2c0: 6564 2072 656e 6465 7220 7461 7267 6574 ed render target │ │ │ │ │ +0000f2d0: 2e20 2049 6620 2774 6172 6765 7427 0a20 . If 'target'. │ │ │ │ │ +0000f2e0: 2020 2020 636f 6e74 6169 6e73 2027 4e55 contains 'NU │ │ │ │ │ +0000f2f0: 4c4c 2720 706f 696e 7465 722c 206e 6f74 LL' pointer, not │ │ │ │ │ +0000f300: 6869 6e67 2077 696c 6c20 6265 2064 6f6e hing will be don │ │ │ │ │ +0000f310: 652e 2020 4966 2072 656e 6465 7220 7461 e. If render ta │ │ │ │ │ +0000f320: 7267 6574 2069 730a 2020 2020 2063 6f72 rget is. cor │ │ │ │ │ +0000f330: 7265 6374 6c79 2064 6573 7472 6f79 6564 rectly destroyed │ │ │ │ │ +0000f340: 2c20 4752 5542 5f45 5252 5f4e 4f4e 4520 , GRUB_ERR_NONE │ │ │ │ │ +0000f350: 6973 2072 6574 7572 6e65 642e 0a0a 3130 is returned...10 │ │ │ │ │ +0000f360: 2e31 2e32 3520 6772 7562 5f76 6964 656f .1.25 grub_video │ │ │ │ │ +0000f370: 5f73 6574 5f61 6374 6976 655f 7265 6e64 _set_active_rend │ │ │ │ │ +0000f380: 6572 5f74 6172 6765 740a 2d2d 2d2d 2d2d er_target.------ │ │ │ │ │ 0000f390: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 0000f3a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000f3b0: 2d2d 2d2d 2d2d 2d0a 0a20 2020 2a20 5072 -------.. * Pr │ │ │ │ │ -0000f3c0: 6f74 6f74 7970 653a 0a0a 2020 2020 2020 ototype:.. │ │ │ │ │ -0000f3d0: 2020 2020 6772 7562 5f65 7272 5f74 0a20 grub_err_t. │ │ │ │ │ -0000f3e0: 2020 2020 2020 2020 2067 7275 625f 7669 grub_vi │ │ │ │ │ -0000f3f0: 6465 6f5f 7365 745f 6163 7469 7665 5f72 deo_set_active_r │ │ │ │ │ -0000f400: 656e 6465 725f 7461 7267 6574 2028 7374 ender_target (st │ │ │ │ │ -0000f410: 7275 6374 2067 7275 625f 7669 6465 6f5f ruct grub_video_ │ │ │ │ │ -0000f420: 7265 6e64 6572 5f74 6172 6765 7420 2a74 render_target *t │ │ │ │ │ -0000f430: 6172 6765 7429 3b0a 2020 202a 2044 6573 arget);. * Des │ │ │ │ │ -0000f440: 6372 6970 7469 6f6e 3a0a 0a20 2020 2020 cription:.. │ │ │ │ │ -0000f450: 5365 7473 2061 6374 6976 6520 7265 6e64 Sets active rend │ │ │ │ │ -0000f460: 6572 2074 6172 6765 742e 2020 4966 2074 er target. If t │ │ │ │ │ -0000f470: 6869 7320 636f 6d61 6e64 2069 7320 7375 his comand is su │ │ │ │ │ -0000f480: 6363 6573 7366 756c 2061 6c6c 0a20 2020 ccessful all. │ │ │ │ │ -0000f490: 2020 6472 6177 696e 6720 636f 6d6d 616e drawing comman │ │ │ │ │ -0000f4a0: 6473 2077 696c 6c20 6265 2064 6f6e 6520 ds will be done │ │ │ │ │ -0000f4b0: 746f 2073 7065 6369 6669 6564 2027 7461 to specified 'ta │ │ │ │ │ -0000f4c0: 7267 6574 272e 2020 5468 6572 6520 6973 rget'. There is │ │ │ │ │ -0000f4d0: 2061 6c73 6f0a 2020 2020 2073 7065 6369 also. speci │ │ │ │ │ -0000f4e0: 616c 2076 616c 7565 7320 666f 7220 7461 al values for ta │ │ │ │ │ -0000f4f0: 7267 6574 2c20 2747 5255 425f 5649 4445 rget, 'GRUB_VIDE │ │ │ │ │ -0000f500: 4f5f 5245 4e44 4552 5f54 4152 4745 545f O_RENDER_TARGET_ │ │ │ │ │ -0000f510: 4449 5350 4c41 5927 2075 7365 640a 2020 DISPLAY' used. │ │ │ │ │ -0000f520: 2020 2074 6f20 7265 6665 7265 6e63 6520 to reference │ │ │ │ │ -0000f530: 7363 7265 656e 2773 2066 726f 6e74 2062 screen's front b │ │ │ │ │ -0000f540: 7566 6665 722c 0a20 2020 2020 2747 5255 uffer,. 'GRU │ │ │ │ │ -0000f550: 425f 5649 4445 4f5f 5245 4e44 4552 5f54 B_VIDEO_RENDER_T │ │ │ │ │ -0000f560: 4152 4745 545f 4652 4f4e 545f 4255 4646 ARGET_FRONT_BUFF │ │ │ │ │ -0000f570: 4552 2720 7573 6564 2074 6f20 7265 6665 ER' used to refe │ │ │ │ │ -0000f580: 7265 6e63 6520 7363 7265 656e 2773 0a20 rence screen's. │ │ │ │ │ -0000f590: 2020 2020 6672 6f6e 7420 6275 6666 6572 front buffer │ │ │ │ │ -0000f5a0: 2028 616c 6961 7320 666f 7220 2747 5255 (alias for 'GRU │ │ │ │ │ -0000f5b0: 425f 5649 4445 4f5f 5245 4e44 4552 5f54 B_VIDEO_RENDER_T │ │ │ │ │ -0000f5c0: 4152 4745 545f 4449 5350 4c41 5927 2920 ARGET_DISPLAY') │ │ │ │ │ -0000f5d0: 616e 640a 2020 2020 2027 4752 5542 5f56 and. 'GRUB_V │ │ │ │ │ -0000f5e0: 4944 454f 5f52 454e 4445 525f 5441 5247 IDEO_RENDER_TARG │ │ │ │ │ -0000f5f0: 4554 5f42 4143 4b5f 4255 4646 4552 2720 ET_BACK_BUFFER' │ │ │ │ │ -0000f600: 7573 6564 2074 6f20 7265 6665 7265 6e63 used to referenc │ │ │ │ │ -0000f610: 6520 6261 636b 0a20 2020 2020 6275 6666 e back. buff │ │ │ │ │ -0000f620: 6572 2028 6966 2064 6f75 626c 6520 6275 er (if double bu │ │ │ │ │ -0000f630: 6666 6572 696e 6720 6973 2065 6e61 626c ffering is enabl │ │ │ │ │ -0000f640: 6564 292e 2020 4966 2072 656e 6465 7220 ed). If render │ │ │ │ │ -0000f650: 7461 7267 6574 2069 730a 2020 2020 2063 target is. c │ │ │ │ │ -0000f660: 6f72 7265 636c 7479 2073 7769 7463 6865 orreclty switche │ │ │ │ │ -0000f670: 6420 4752 5542 5f45 5252 5f4e 4f4e 4520 d GRUB_ERR_NONE │ │ │ │ │ -0000f680: 6973 2072 6574 7572 6e65 642e 2020 496e is returned. In │ │ │ │ │ -0000f690: 206e 6f20 616e 7920 6576 656e 740a 2020 no any event. │ │ │ │ │ -0000f6a0: 2020 2073 6861 6c6c 2074 6865 7265 2062 shall there b │ │ │ │ │ -0000f6b0: 6520 6e6f 6e20 6472 6177 6162 6c65 2061 e non drawable a │ │ │ │ │ -0000f6c0: 6374 6976 6520 7265 6e64 6572 2074 6172 ctive render tar │ │ │ │ │ -0000f6d0: 6765 742e 0a0a 3130 2e31 2e32 3620 6772 get...10.1.26 gr │ │ │ │ │ -0000f6e0: 7562 5f76 6964 656f 5f67 6574 5f61 6374 ub_video_get_act │ │ │ │ │ -0000f6f0: 6976 655f 7265 6e64 6572 5f74 6172 6765 ive_render_targe │ │ │ │ │ -0000f700: 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d t.-------------- │ │ │ │ │ +0000f3b0: 2d2d 2d2d 2d0a 0a20 2020 2a20 5072 6f74 -----.. * Prot │ │ │ │ │ +0000f3c0: 6f74 7970 653a 0a0a 2020 2020 2020 2020 otype:.. │ │ │ │ │ +0000f3d0: 2020 6772 7562 5f65 7272 5f74 0a20 2020 grub_err_t. │ │ │ │ │ +0000f3e0: 2020 2020 2020 2067 7275 625f 7669 6465 grub_vide │ │ │ │ │ +0000f3f0: 6f5f 7365 745f 6163 7469 7665 5f72 656e o_set_active_ren │ │ │ │ │ +0000f400: 6465 725f 7461 7267 6574 2028 7374 7275 der_target (stru │ │ │ │ │ +0000f410: 6374 2067 7275 625f 7669 6465 6f5f 7265 ct grub_video_re │ │ │ │ │ +0000f420: 6e64 6572 5f74 6172 6765 7420 2a74 6172 nder_target *tar │ │ │ │ │ +0000f430: 6765 7429 3b0a 2020 202a 2044 6573 6372 get);. * Descr │ │ │ │ │ +0000f440: 6970 7469 6f6e 3a0a 0a20 2020 2020 5365 iption:.. Se │ │ │ │ │ +0000f450: 7473 2061 6374 6976 6520 7265 6e64 6572 ts active render │ │ │ │ │ +0000f460: 2074 6172 6765 742e 2020 4966 2074 6869 target. If thi │ │ │ │ │ +0000f470: 7320 636f 6d61 6e64 2069 7320 7375 6363 s comand is succ │ │ │ │ │ +0000f480: 6573 7366 756c 2061 6c6c 0a20 2020 2020 essful all. │ │ │ │ │ +0000f490: 6472 6177 696e 6720 636f 6d6d 616e 6473 drawing commands │ │ │ │ │ +0000f4a0: 2077 696c 6c20 6265 2064 6f6e 6520 746f will be done to │ │ │ │ │ +0000f4b0: 2073 7065 6369 6669 6564 2027 7461 7267 specified 'targ │ │ │ │ │ +0000f4c0: 6574 272e 2020 5468 6572 6520 6973 2061 et'. There is a │ │ │ │ │ +0000f4d0: 6c73 6f0a 2020 2020 2073 7065 6369 616c lso. special │ │ │ │ │ +0000f4e0: 2076 616c 7565 7320 666f 7220 7461 7267 values for targ │ │ │ │ │ +0000f4f0: 6574 2c20 2747 5255 425f 5649 4445 4f5f et, 'GRUB_VIDEO_ │ │ │ │ │ +0000f500: 5245 4e44 4552 5f54 4152 4745 545f 4449 RENDER_TARGET_DI │ │ │ │ │ +0000f510: 5350 4c41 5927 2075 7365 640a 2020 2020 SPLAY' used. │ │ │ │ │ +0000f520: 2074 6f20 7265 6665 7265 6e63 6520 7363 to reference sc │ │ │ │ │ +0000f530: 7265 656e 2773 2066 726f 6e74 2062 7566 reen's front buf │ │ │ │ │ +0000f540: 6665 722c 0a20 2020 2020 2747 5255 425f fer,. 'GRUB_ │ │ │ │ │ +0000f550: 5649 4445 4f5f 5245 4e44 4552 5f54 4152 VIDEO_RENDER_TAR │ │ │ │ │ +0000f560: 4745 545f 4652 4f4e 545f 4255 4646 4552 GET_FRONT_BUFFER │ │ │ │ │ +0000f570: 2720 7573 6564 2074 6f20 7265 6665 7265 ' used to refere │ │ │ │ │ +0000f580: 6e63 6520 7363 7265 656e 2773 0a20 2020 nce screen's. │ │ │ │ │ +0000f590: 2020 6672 6f6e 7420 6275 6666 6572 2028 front buffer ( │ │ │ │ │ +0000f5a0: 616c 6961 7320 666f 7220 2747 5255 425f alias for 'GRUB_ │ │ │ │ │ +0000f5b0: 5649 4445 4f5f 5245 4e44 4552 5f54 4152 VIDEO_RENDER_TAR │ │ │ │ │ +0000f5c0: 4745 545f 4449 5350 4c41 5927 2920 616e GET_DISPLAY') an │ │ │ │ │ +0000f5d0: 640a 2020 2020 2027 4752 5542 5f56 4944 d. 'GRUB_VID │ │ │ │ │ +0000f5e0: 454f 5f52 454e 4445 525f 5441 5247 4554 EO_RENDER_TARGET │ │ │ │ │ +0000f5f0: 5f42 4143 4b5f 4255 4646 4552 2720 7573 _BACK_BUFFER' us │ │ │ │ │ +0000f600: 6564 2074 6f20 7265 6665 7265 6e63 6520 ed to reference │ │ │ │ │ +0000f610: 6261 636b 0a20 2020 2020 6275 6666 6572 back. buffer │ │ │ │ │ +0000f620: 2028 6966 2064 6f75 626c 6520 6275 6666 (if double buff │ │ │ │ │ +0000f630: 6572 696e 6720 6973 2065 6e61 626c 6564 ering is enabled │ │ │ │ │ +0000f640: 292e 2020 4966 2072 656e 6465 7220 7461 ). If render ta │ │ │ │ │ +0000f650: 7267 6574 2069 730a 2020 2020 2063 6f72 rget is. cor │ │ │ │ │ +0000f660: 7265 636c 7479 2073 7769 7463 6865 6420 reclty switched │ │ │ │ │ +0000f670: 4752 5542 5f45 5252 5f4e 4f4e 4520 6973 GRUB_ERR_NONE is │ │ │ │ │ +0000f680: 2072 6574 7572 6e65 642e 2020 496e 206e returned. In n │ │ │ │ │ +0000f690: 6f20 616e 7920 6576 656e 740a 2020 2020 o any event. │ │ │ │ │ +0000f6a0: 2073 6861 6c6c 2074 6865 7265 2062 6520 shall there be │ │ │ │ │ +0000f6b0: 6e6f 6e20 6472 6177 6162 6c65 2061 6374 non drawable act │ │ │ │ │ +0000f6c0: 6976 6520 7265 6e64 6572 2074 6172 6765 ive render targe │ │ │ │ │ +0000f6d0: 742e 0a0a 3130 2e31 2e32 3620 6772 7562 t...10.1.26 grub │ │ │ │ │ +0000f6e0: 5f76 6964 656f 5f67 6574 5f61 6374 6976 _video_get_activ │ │ │ │ │ +0000f6f0: 655f 7265 6e64 6572 5f74 6172 6765 740a e_render_target. │ │ │ │ │ +0000f700: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 0000f710: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000f720: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 -------------.. │ │ │ │ │ -0000f730: 2020 2a20 5072 6f74 6f74 7970 653a 0a0a * Prototype:.. │ │ │ │ │ -0000f740: 2020 2020 2020 2020 2020 6772 7562 5f65 grub_e │ │ │ │ │ -0000f750: 7272 5f74 0a20 2020 2020 2020 2020 2067 rr_t. g │ │ │ │ │ -0000f760: 7275 625f 7669 6465 6f5f 6765 745f 6163 rub_video_get_ac │ │ │ │ │ -0000f770: 7469 7665 5f72 656e 6465 725f 7461 7267 tive_render_targ │ │ │ │ │ -0000f780: 6574 2028 7374 7275 6374 2067 7275 625f et (struct grub_ │ │ │ │ │ -0000f790: 7669 6465 6f5f 7265 6e64 6572 5f74 6172 video_render_tar │ │ │ │ │ -0000f7a0: 6765 7420 2a2a 7461 7267 6574 293b 0a20 get **target);. │ │ │ │ │ -0000f7b0: 2020 2a20 4465 7363 7269 7074 696f 6e3a * Description: │ │ │ │ │ -0000f7c0: 0a0a 2020 2020 2052 6574 7572 6e73 2063 .. Returns c │ │ │ │ │ -0000f7d0: 7572 7265 6e74 6c79 2061 6374 6976 6520 urrently active │ │ │ │ │ -0000f7e0: 7265 6e64 6572 2074 6172 6765 742e 2020 render target. │ │ │ │ │ -0000f7f0: 4974 2072 6574 7572 6e73 2076 616c 7565 It returns value │ │ │ │ │ -0000f800: 2069 6e0a 2020 2020 2027 7461 7267 6574 in. 'target │ │ │ │ │ -0000f810: 2720 7468 6174 2063 616e 2062 6520 7375 ' that can be su │ │ │ │ │ -0000f820: 6273 6571 7565 6e74 6c79 2069 7373 7565 bsequently issue │ │ │ │ │ -0000f830: 6420 6261 636b 2074 6f0a 2020 2020 2027 d back to. ' │ │ │ │ │ -0000f840: 6772 7562 5f76 6964 656f 5f73 6574 5f61 grub_video_set_a │ │ │ │ │ -0000f850: 6374 6976 655f 7265 6e64 6572 5f74 6172 ctive_render_tar │ │ │ │ │ -0000f860: 6765 7427 2e0a 0a1f 0a46 696c 653a 2067 get'.....File: g │ │ │ │ │ -0000f870: 7275 622d 6465 762e 696e 666f 2c20 204e rub-dev.info, N │ │ │ │ │ -0000f880: 6f64 653a 2045 7861 6d70 6c65 2075 7361 ode: Example usa │ │ │ │ │ -0000f890: 6765 206f 6620 5669 6465 6f20 4150 492c ge of Video API, │ │ │ │ │ -0000f8a0: 2020 4e65 7874 3a20 4269 746d 6170 2041 Next: Bitmap A │ │ │ │ │ -0000f8b0: 5049 2c20 2050 7265 763a 2056 6964 656f PI, Prev: Video │ │ │ │ │ -0000f8c0: 2041 5049 2c20 2055 703a 2056 6964 656f API, Up: Video │ │ │ │ │ -0000f8d0: 2053 7562 7379 7374 656d 0a0a 3130 2e32 Subsystem..10.2 │ │ │ │ │ -0000f8e0: 2045 7861 6d70 6c65 2075 7361 6765 206f Example usage o │ │ │ │ │ -0000f8f0: 6620 5669 6465 6f20 4150 490a 3d3d 3d3d f Video API.==== │ │ │ │ │ +0000f720: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2020 -----------.. │ │ │ │ │ +0000f730: 2a20 5072 6f74 6f74 7970 653a 0a0a 2020 * Prototype:.. │ │ │ │ │ +0000f740: 2020 2020 2020 2020 6772 7562 5f65 7272 grub_err │ │ │ │ │ +0000f750: 5f74 0a20 2020 2020 2020 2020 2067 7275 _t. gru │ │ │ │ │ +0000f760: 625f 7669 6465 6f5f 6765 745f 6163 7469 b_video_get_acti │ │ │ │ │ +0000f770: 7665 5f72 656e 6465 725f 7461 7267 6574 ve_render_target │ │ │ │ │ +0000f780: 2028 7374 7275 6374 2067 7275 625f 7669 (struct grub_vi │ │ │ │ │ +0000f790: 6465 6f5f 7265 6e64 6572 5f74 6172 6765 deo_render_targe │ │ │ │ │ +0000f7a0: 7420 2a2a 7461 7267 6574 293b 0a20 2020 t **target);. │ │ │ │ │ +0000f7b0: 2a20 4465 7363 7269 7074 696f 6e3a 0a0a * Description:.. │ │ │ │ │ +0000f7c0: 2020 2020 2052 6574 7572 6e73 2063 7572 Returns cur │ │ │ │ │ +0000f7d0: 7265 6e74 6c79 2061 6374 6976 6520 7265 rently active re │ │ │ │ │ +0000f7e0: 6e64 6572 2074 6172 6765 742e 2020 4974 nder target. It │ │ │ │ │ +0000f7f0: 2072 6574 7572 6e73 2076 616c 7565 2069 returns value i │ │ │ │ │ +0000f800: 6e0a 2020 2020 2027 7461 7267 6574 2720 n. 'target' │ │ │ │ │ +0000f810: 7468 6174 2063 616e 2062 6520 7375 6273 that can be subs │ │ │ │ │ +0000f820: 6571 7565 6e74 6c79 2069 7373 7565 6420 equently issued │ │ │ │ │ +0000f830: 6261 636b 2074 6f0a 2020 2020 2027 6772 back to. 'gr │ │ │ │ │ +0000f840: 7562 5f76 6964 656f 5f73 6574 5f61 6374 ub_video_set_act │ │ │ │ │ +0000f850: 6976 655f 7265 6e64 6572 5f74 6172 6765 ive_render_targe │ │ │ │ │ +0000f860: 7427 2e0a 0a1f 0a46 696c 653a 2067 7275 t'.....File: gru │ │ │ │ │ +0000f870: 622d 6465 762e 696e 666f 2c20 204e 6f64 b-dev.info, Nod │ │ │ │ │ +0000f880: 653a 2045 7861 6d70 6c65 2075 7361 6765 e: Example usage │ │ │ │ │ +0000f890: 206f 6620 5669 6465 6f20 4150 492c 2020 of Video API, │ │ │ │ │ +0000f8a0: 4e65 7874 3a20 4269 746d 6170 2041 5049 Next: Bitmap API │ │ │ │ │ +0000f8b0: 2c20 2050 7265 763a 2056 6964 656f 2041 , Prev: Video A │ │ │ │ │ +0000f8c0: 5049 2c20 2055 703a 2056 6964 656f 2053 PI, Up: Video S │ │ │ │ │ +0000f8d0: 7562 7379 7374 656d 0a0a 3130 2e32 2045 ubsystem..10.2 E │ │ │ │ │ +0000f8e0: 7861 6d70 6c65 2075 7361 6765 206f 6620 xample usage of │ │ │ │ │ +0000f8f0: 5669 6465 6f20 4150 490a 3d3d 3d3d 3d3d Video API.====== │ │ │ │ │ 0000f900: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0000f910: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a31 302e ===========..10. │ │ │ │ │ -0000f920: 322e 3120 4578 616d 706c 6520 6f66 2073 2.1 Example of s │ │ │ │ │ -0000f930: 6372 6565 6e20 7365 7475 700a 2d2d 2d2d creen setup.---- │ │ │ │ │ +0000f910: 3d3d 3d3d 3d3d 3d3d 3d0a 0a31 302e 322e =========..10.2. │ │ │ │ │ +0000f920: 3120 4578 616d 706c 6520 6f66 2073 6372 1 Example of scr │ │ │ │ │ +0000f930: 6565 6e20 7365 7475 700a 2d2d 2d2d 2d2d een setup.------ │ │ │ │ │ 0000f940: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000f950: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2020 2020 ----------.. │ │ │ │ │ -0000f960: 2067 7275 625f 6572 725f 7420 7263 3b0a grub_err_t rc;. │ │ │ │ │ -0000f970: 2020 2020 202f 2a20 5472 7920 746f 2069 /* Try to i │ │ │ │ │ -0000f980: 6e69 7469 616c 697a 6520 7669 6465 6f20 nitialize video │ │ │ │ │ -0000f990: 6d6f 6465 2031 3032 3420 7820 3736 3820 mode 1024 x 768 │ │ │ │ │ -0000f9a0: 7769 7468 2064 6972 6563 7420 5247 422e with direct RGB. │ │ │ │ │ -0000f9b0: 2020 2a2f 0a20 2020 2020 7263 203d 2067 */. rc = g │ │ │ │ │ -0000f9c0: 7275 625f 7669 6465 6f5f 7365 7475 7020 rub_video_setup │ │ │ │ │ -0000f9d0: 2831 3032 342c 2037 3638 2c20 4752 5542 (1024, 768, GRUB │ │ │ │ │ -0000f9e0: 5f56 4944 454f 5f4d 4f44 455f 5459 5045 _VIDEO_MODE_TYPE │ │ │ │ │ -0000f9f0: 5f52 4742 293b 0a20 2020 2020 6966 2028 _RGB);. if ( │ │ │ │ │ -0000fa00: 7263 2021 3d20 4752 5542 5f45 5252 5f4e rc != GRUB_ERR_N │ │ │ │ │ -0000fa10: 4f4e 4529 0a20 2020 2020 7b0a 2020 2020 ONE). {. │ │ │ │ │ -0000fa20: 2020 202f 2a20 4661 6c6c 2062 6163 6b20 /* Fall back │ │ │ │ │ -0000fa30: 746f 2073 7461 6e64 6172 6420 5647 4120 to standard VGA │ │ │ │ │ -0000fa40: 496e 6465 7820 436f 6c6f 7220 6d6f 6465 Index Color mode │ │ │ │ │ -0000fa50: 2e20 202a 2f0a 2020 2020 2020 2072 6320 . */. rc │ │ │ │ │ -0000fa60: 3d20 6772 7562 5f76 6964 656f 5f73 6574 = grub_video_set │ │ │ │ │ -0000fa70: 7570 2028 3634 302c 2034 3830 2c20 4752 up (640, 480, GR │ │ │ │ │ -0000fa80: 5542 5f56 4944 454f 5f4d 4f44 455f 5459 UB_VIDEO_MODE_TY │ │ │ │ │ -0000fa90: 5045 5f49 4e44 4558 293b 0a20 2020 2020 PE_INDEX);. │ │ │ │ │ -0000faa0: 2020 6966 2028 7263 2021 3d20 4752 5542 if (rc != GRUB │ │ │ │ │ -0000fab0: 5f45 5252 5f4e 4f4e 4529 0a20 2020 2020 _ERR_NONE). │ │ │ │ │ -0000fac0: 2020 7b0a 2020 2020 2020 202f 2a20 4861 {. /* Ha │ │ │ │ │ -0000fad0: 6e64 6c65 2065 7272 6f72 2e20 202a 2f0a ndle error. */. │ │ │ │ │ -0000fae0: 2020 2020 2020 207d 0a20 2020 2020 7d0a }. }. │ │ │ │ │ -0000faf0: 0a31 302e 322e 3220 4578 616d 706c 6520 .10.2.2 Example │ │ │ │ │ -0000fb00: 6f66 2073 6574 7469 6e67 2075 7020 636f of setting up co │ │ │ │ │ -0000fb10: 6e73 6f6c 6520 7669 6577 706f 7274 0a2d nsole viewport.- │ │ │ │ │ +0000f950: 2d2d 2d2d 2d2d 2d2d 0a0a 2020 2020 2067 --------.. g │ │ │ │ │ +0000f960: 7275 625f 6572 725f 7420 7263 3b0a 2020 rub_err_t rc;. │ │ │ │ │ +0000f970: 2020 202f 2a20 5472 7920 746f 2069 6e69 /* Try to ini │ │ │ │ │ +0000f980: 7469 616c 697a 6520 7669 6465 6f20 6d6f tialize video mo │ │ │ │ │ +0000f990: 6465 2031 3032 3420 7820 3736 3820 7769 de 1024 x 768 wi │ │ │ │ │ +0000f9a0: 7468 2064 6972 6563 7420 5247 422e 2020 th direct RGB. │ │ │ │ │ +0000f9b0: 2a2f 0a20 2020 2020 7263 203d 2067 7275 */. rc = gru │ │ │ │ │ +0000f9c0: 625f 7669 6465 6f5f 7365 7475 7020 2831 b_video_setup (1 │ │ │ │ │ +0000f9d0: 3032 342c 2037 3638 2c20 4752 5542 5f56 024, 768, GRUB_V │ │ │ │ │ +0000f9e0: 4944 454f 5f4d 4f44 455f 5459 5045 5f52 IDEO_MODE_TYPE_R │ │ │ │ │ +0000f9f0: 4742 293b 0a20 2020 2020 6966 2028 7263 GB);. if (rc │ │ │ │ │ +0000fa00: 2021 3d20 4752 5542 5f45 5252 5f4e 4f4e != GRUB_ERR_NON │ │ │ │ │ +0000fa10: 4529 0a20 2020 2020 7b0a 2020 2020 2020 E). {. │ │ │ │ │ +0000fa20: 202f 2a20 4661 6c6c 2062 6163 6b20 746f /* Fall back to │ │ │ │ │ +0000fa30: 2073 7461 6e64 6172 6420 5647 4120 496e standard VGA In │ │ │ │ │ +0000fa40: 6465 7820 436f 6c6f 7220 6d6f 6465 2e20 dex Color mode. │ │ │ │ │ +0000fa50: 202a 2f0a 2020 2020 2020 2072 6320 3d20 */. rc = │ │ │ │ │ +0000fa60: 6772 7562 5f76 6964 656f 5f73 6574 7570 grub_video_setup │ │ │ │ │ +0000fa70: 2028 3634 302c 2034 3830 2c20 4752 5542 (640, 480, GRUB │ │ │ │ │ +0000fa80: 5f56 4944 454f 5f4d 4f44 455f 5459 5045 _VIDEO_MODE_TYPE │ │ │ │ │ +0000fa90: 5f49 4e44 4558 293b 0a20 2020 2020 2020 _INDEX);. │ │ │ │ │ +0000faa0: 6966 2028 7263 2021 3d20 4752 5542 5f45 if (rc != GRUB_E │ │ │ │ │ +0000fab0: 5252 5f4e 4f4e 4529 0a20 2020 2020 2020 RR_NONE). │ │ │ │ │ +0000fac0: 7b0a 2020 2020 2020 202f 2a20 4861 6e64 {. /* Hand │ │ │ │ │ +0000fad0: 6c65 2065 7272 6f72 2e20 202a 2f0a 2020 le error. */. │ │ │ │ │ +0000fae0: 2020 2020 207d 0a20 2020 2020 7d0a 0a31 }. }..1 │ │ │ │ │ +0000faf0: 302e 322e 3220 4578 616d 706c 6520 6f66 0.2.2 Example of │ │ │ │ │ +0000fb00: 2073 6574 7469 6e67 2075 7020 636f 6e73 setting up cons │ │ │ │ │ +0000fb10: 6f6c 6520 7669 6577 706f 7274 0a2d 2d2d ole viewport.--- │ │ │ │ │ 0000fb20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 0000fb30: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000fb40: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2020 ------------.. │ │ │ │ │ -0000fb50: 2020 2067 7275 625f 7569 6e74 3332 5f74 grub_uint32_t │ │ │ │ │ -0000fb60: 2078 2c20 792c 2077 6964 7468 2c20 6865 x, y, width, he │ │ │ │ │ -0000fb70: 6967 6874 3b0a 2020 2020 2067 7275 625f ight;. grub_ │ │ │ │ │ -0000fb80: 7669 6465 6f5f 636f 6c6f 725f 7420 636f video_color_t co │ │ │ │ │ -0000fb90: 6c6f 723b 0a20 2020 2020 7374 7275 6374 lor;. struct │ │ │ │ │ -0000fba0: 2067 7275 625f 666f 6e74 5f67 6c79 7068 grub_font_glyph │ │ │ │ │ -0000fbb0: 2067 6c79 7068 3b0a 2020 2020 2067 7275 glyph;. gru │ │ │ │ │ -0000fbc0: 625f 6572 725f 7420 7263 3b0a 2020 2020 b_err_t rc;. │ │ │ │ │ -0000fbd0: 202f 2a20 5175 6572 7920 6578 6973 7469 /* Query existi │ │ │ │ │ -0000fbe0: 6e67 2076 6965 7770 6f72 742e 2020 2a2f ng viewport. */ │ │ │ │ │ -0000fbf0: 0a20 2020 2020 6772 7562 5f76 6964 656f . grub_video │ │ │ │ │ -0000fc00: 5f67 6574 5f76 6965 7770 6f72 7420 2826 _get_viewport (& │ │ │ │ │ -0000fc10: 782c 2026 792c 2026 7769 6474 682c 2026 x, &y, &width, & │ │ │ │ │ -0000fc20: 6865 6967 6874 293b 0a20 2020 2020 2f2a height);. /* │ │ │ │ │ -0000fc30: 2046 696c 6c20 6261 636b 6772 6f75 6e64 Fill background │ │ │ │ │ -0000fc40: 2e20 202a 2f0a 2020 2020 2063 6f6c 6f72 . */. color │ │ │ │ │ -0000fc50: 203d 2067 7275 625f 7669 6465 6f5f 6d61 = grub_video_ma │ │ │ │ │ -0000fc60: 705f 636f 6c6f 7220 2847 5255 425f 434f p_color (GRUB_CO │ │ │ │ │ -0000fc70: 4c4f 525f 4241 434b 4752 4f55 4e44 293b LOR_BACKGROUND); │ │ │ │ │ -0000fc80: 0a20 2020 2020 6772 7562 5f76 6964 656f . grub_video │ │ │ │ │ -0000fc90: 5f66 696c 6c5f 7265 6374 2028 636f 6c6f _fill_rect (colo │ │ │ │ │ -0000fca0: 722c 2030 2c20 302c 2077 6964 7468 2c20 r, 0, 0, width, │ │ │ │ │ -0000fcb0: 6865 6967 6874 293b 0a20 2020 2020 2f2a height);. /* │ │ │ │ │ -0000fcc0: 2053 6574 7570 2063 6f6e 736f 6c65 2076 Setup console v │ │ │ │ │ -0000fcd0: 6965 7770 6f72 742e 2020 2a2f 0a20 2020 iewport. */. │ │ │ │ │ -0000fce0: 2020 6772 7562 5f76 6964 656f 5f73 6574 grub_video_set │ │ │ │ │ -0000fcf0: 5f76 6965 7770 6f72 7420 2878 202b 2031 _viewport (x + 1 │ │ │ │ │ -0000fd00: 302c 2079 202b 2031 302c 2077 6964 7468 0, y + 10, width │ │ │ │ │ -0000fd10: 202d 2032 302c 2068 6569 6768 7420 2d20 - 20, height - │ │ │ │ │ -0000fd20: 3230 293b 0a20 2020 2020 6772 7562 5f76 20);. grub_v │ │ │ │ │ -0000fd30: 6964 656f 5f67 6574 5f76 6965 7770 6f72 ideo_get_viewpor │ │ │ │ │ -0000fd40: 7420 2826 782c 2026 792c 2026 7769 6474 t (&x, &y, &widt │ │ │ │ │ -0000fd50: 682c 2026 6865 6967 6874 293b 0a20 2020 h, &height);. │ │ │ │ │ -0000fd60: 2020 636f 6c6f 7220 3d20 6772 7562 5f76 color = grub_v │ │ │ │ │ -0000fd70: 6964 656f 5f6d 6170 5f63 6f6c 6f72 2028 ideo_map_color ( │ │ │ │ │ -0000fd80: 4752 5542 5f43 4f4c 4f52 5f43 4f4e 534f GRUB_COLOR_CONSO │ │ │ │ │ -0000fd90: 4c45 5f42 4143 4b47 524f 554e 4429 3b0a LE_BACKGROUND);. │ │ │ │ │ -0000fda0: 2020 2020 2067 7275 625f 7669 6465 6f5f grub_video_ │ │ │ │ │ -0000fdb0: 6669 6c6c 5f72 6563 7420 2863 6f6c 6f72 fill_rect (color │ │ │ │ │ -0000fdc0: 2c20 302c 2030 2c20 7769 6474 682c 2068 , 0, 0, width, h │ │ │ │ │ -0000fdd0: 6569 6768 7429 3b0a 2020 2020 202f 2a20 eight);. /* │ │ │ │ │ -0000fde0: 4472 6177 2074 6578 7420 746f 2076 6965 Draw text to vie │ │ │ │ │ -0000fdf0: 7770 6f72 742e 2020 2a2f 0a20 2020 2020 wport. */. │ │ │ │ │ -0000fe00: 636f 6c6f 7220 3d20 6772 7562 5f76 6964 color = grub_vid │ │ │ │ │ -0000fe10: 656f 5f6d 6170 5f63 6f6c 6f72 2028 4752 eo_map_color (GR │ │ │ │ │ -0000fe20: 5542 5f43 4f4c 4f52 5f43 4f4e 534f 4c45 UB_COLOR_CONSOLE │ │ │ │ │ -0000fe30: 5f54 4558 5429 3b0a 2020 2020 2067 7275 _TEXT);. gru │ │ │ │ │ -0000fe40: 625f 666f 6e74 5f67 6574 5f67 6c79 7068 b_font_get_glyph │ │ │ │ │ -0000fe50: 2028 2758 272c 2026 676c 7970 6829 3b0a ('X', &glyph);. │ │ │ │ │ -0000fe60: 2020 2020 2067 7275 625f 7669 6465 6f5f grub_video_ │ │ │ │ │ -0000fe70: 626c 6974 5f67 6c79 7068 2028 2667 6c79 blit_glyph (&gly │ │ │ │ │ -0000fe80: 7068 2c20 636f 6c6f 722c 2030 2c20 3029 ph, color, 0, 0) │ │ │ │ │ -0000fe90: 3b0a 0a1f 0a46 696c 653a 2067 7275 622d ;....File: grub- │ │ │ │ │ -0000fea0: 6465 762e 696e 666f 2c20 204e 6f64 653a dev.info, Node: │ │ │ │ │ -0000feb0: 2042 6974 6d61 7020 4150 492c 2020 5072 Bitmap API, Pr │ │ │ │ │ -0000fec0: 6576 3a20 4578 616d 706c 6520 7573 6167 ev: Example usag │ │ │ │ │ -0000fed0: 6520 6f66 2056 6964 656f 2041 5049 2c20 e of Video API, │ │ │ │ │ -0000fee0: 2055 703a 2056 6964 656f 2053 7562 7379 Up: Video Subsy │ │ │ │ │ -0000fef0: 7374 656d 0a0a 3130 2e33 2042 6974 6d61 stem..10.3 Bitma │ │ │ │ │ -0000ff00: 7020 4150 490a 3d3d 3d3d 3d3d 3d3d 3d3d p API.========== │ │ │ │ │ -0000ff10: 3d3d 3d3d 3d0a 0a31 302e 332e 3120 6772 =====..10.3.1 gr │ │ │ │ │ -0000ff20: 7562 5f76 6964 656f 5f62 6974 6d61 705f ub_video_bitmap_ │ │ │ │ │ -0000ff30: 6372 6561 7465 0a2d 2d2d 2d2d 2d2d 2d2d create.--------- │ │ │ │ │ +0000fb40: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2020 2020 ----------.. │ │ │ │ │ +0000fb50: 2067 7275 625f 7569 6e74 3332 5f74 2078 grub_uint32_t x │ │ │ │ │ +0000fb60: 2c20 792c 2077 6964 7468 2c20 6865 6967 , y, width, heig │ │ │ │ │ +0000fb70: 6874 3b0a 2020 2020 2067 7275 625f 7669 ht;. grub_vi │ │ │ │ │ +0000fb80: 6465 6f5f 636f 6c6f 725f 7420 636f 6c6f deo_color_t colo │ │ │ │ │ +0000fb90: 723b 0a20 2020 2020 7374 7275 6374 2067 r;. struct g │ │ │ │ │ +0000fba0: 7275 625f 666f 6e74 5f67 6c79 7068 2067 rub_font_glyph g │ │ │ │ │ +0000fbb0: 6c79 7068 3b0a 2020 2020 2067 7275 625f lyph;. grub_ │ │ │ │ │ +0000fbc0: 6572 725f 7420 7263 3b0a 2020 2020 202f err_t rc;. / │ │ │ │ │ +0000fbd0: 2a20 5175 6572 7920 6578 6973 7469 6e67 * Query existing │ │ │ │ │ +0000fbe0: 2076 6965 7770 6f72 742e 2020 2a2f 0a20 viewport. */. │ │ │ │ │ +0000fbf0: 2020 2020 6772 7562 5f76 6964 656f 5f67 grub_video_g │ │ │ │ │ +0000fc00: 6574 5f76 6965 7770 6f72 7420 2826 782c et_viewport (&x, │ │ │ │ │ +0000fc10: 2026 792c 2026 7769 6474 682c 2026 6865 &y, &width, &he │ │ │ │ │ +0000fc20: 6967 6874 293b 0a20 2020 2020 2f2a 2046 ight);. /* F │ │ │ │ │ +0000fc30: 696c 6c20 6261 636b 6772 6f75 6e64 2e20 ill background. │ │ │ │ │ +0000fc40: 202a 2f0a 2020 2020 2063 6f6c 6f72 203d */. color = │ │ │ │ │ +0000fc50: 2067 7275 625f 7669 6465 6f5f 6d61 705f grub_video_map_ │ │ │ │ │ +0000fc60: 636f 6c6f 7220 2847 5255 425f 434f 4c4f color (GRUB_COLO │ │ │ │ │ +0000fc70: 525f 4241 434b 4752 4f55 4e44 293b 0a20 R_BACKGROUND);. │ │ │ │ │ +0000fc80: 2020 2020 6772 7562 5f76 6964 656f 5f66 grub_video_f │ │ │ │ │ +0000fc90: 696c 6c5f 7265 6374 2028 636f 6c6f 722c ill_rect (color, │ │ │ │ │ +0000fca0: 2030 2c20 302c 2077 6964 7468 2c20 6865 0, 0, width, he │ │ │ │ │ +0000fcb0: 6967 6874 293b 0a20 2020 2020 2f2a 2053 ight);. /* S │ │ │ │ │ +0000fcc0: 6574 7570 2063 6f6e 736f 6c65 2076 6965 etup console vie │ │ │ │ │ +0000fcd0: 7770 6f72 742e 2020 2a2f 0a20 2020 2020 wport. */. │ │ │ │ │ +0000fce0: 6772 7562 5f76 6964 656f 5f73 6574 5f76 grub_video_set_v │ │ │ │ │ +0000fcf0: 6965 7770 6f72 7420 2878 202b 2031 302c iewport (x + 10, │ │ │ │ │ +0000fd00: 2079 202b 2031 302c 2077 6964 7468 202d y + 10, width - │ │ │ │ │ +0000fd10: 2032 302c 2068 6569 6768 7420 2d20 3230 20, height - 20 │ │ │ │ │ +0000fd20: 293b 0a20 2020 2020 6772 7562 5f76 6964 );. grub_vid │ │ │ │ │ +0000fd30: 656f 5f67 6574 5f76 6965 7770 6f72 7420 eo_get_viewport │ │ │ │ │ +0000fd40: 2826 782c 2026 792c 2026 7769 6474 682c (&x, &y, &width, │ │ │ │ │ +0000fd50: 2026 6865 6967 6874 293b 0a20 2020 2020 &height);. │ │ │ │ │ +0000fd60: 636f 6c6f 7220 3d20 6772 7562 5f76 6964 color = grub_vid │ │ │ │ │ +0000fd70: 656f 5f6d 6170 5f63 6f6c 6f72 2028 4752 eo_map_color (GR │ │ │ │ │ +0000fd80: 5542 5f43 4f4c 4f52 5f43 4f4e 534f 4c45 UB_COLOR_CONSOLE │ │ │ │ │ +0000fd90: 5f42 4143 4b47 524f 554e 4429 3b0a 2020 _BACKGROUND);. │ │ │ │ │ +0000fda0: 2020 2067 7275 625f 7669 6465 6f5f 6669 grub_video_fi │ │ │ │ │ +0000fdb0: 6c6c 5f72 6563 7420 2863 6f6c 6f72 2c20 ll_rect (color, │ │ │ │ │ +0000fdc0: 302c 2030 2c20 7769 6474 682c 2068 6569 0, 0, width, hei │ │ │ │ │ +0000fdd0: 6768 7429 3b0a 2020 2020 202f 2a20 4472 ght);. /* Dr │ │ │ │ │ +0000fde0: 6177 2074 6578 7420 746f 2076 6965 7770 aw text to viewp │ │ │ │ │ +0000fdf0: 6f72 742e 2020 2a2f 0a20 2020 2020 636f ort. */. co │ │ │ │ │ +0000fe00: 6c6f 7220 3d20 6772 7562 5f76 6964 656f lor = grub_video │ │ │ │ │ +0000fe10: 5f6d 6170 5f63 6f6c 6f72 2028 4752 5542 _map_color (GRUB │ │ │ │ │ +0000fe20: 5f43 4f4c 4f52 5f43 4f4e 534f 4c45 5f54 _COLOR_CONSOLE_T │ │ │ │ │ +0000fe30: 4558 5429 3b0a 2020 2020 2067 7275 625f EXT);. grub_ │ │ │ │ │ +0000fe40: 666f 6e74 5f67 6574 5f67 6c79 7068 2028 font_get_glyph ( │ │ │ │ │ +0000fe50: 2758 272c 2026 676c 7970 6829 3b0a 2020 'X', &glyph);. │ │ │ │ │ +0000fe60: 2020 2067 7275 625f 7669 6465 6f5f 626c grub_video_bl │ │ │ │ │ +0000fe70: 6974 5f67 6c79 7068 2028 2667 6c79 7068 it_glyph (&glyph │ │ │ │ │ +0000fe80: 2c20 636f 6c6f 722c 2030 2c20 3029 3b0a , color, 0, 0);. │ │ │ │ │ +0000fe90: 0a1f 0a46 696c 653a 2067 7275 622d 6465 ...File: grub-de │ │ │ │ │ +0000fea0: 762e 696e 666f 2c20 204e 6f64 653a 2042 v.info, Node: B │ │ │ │ │ +0000feb0: 6974 6d61 7020 4150 492c 2020 5072 6576 itmap API, Prev │ │ │ │ │ +0000fec0: 3a20 4578 616d 706c 6520 7573 6167 6520 : Example usage │ │ │ │ │ +0000fed0: 6f66 2056 6964 656f 2041 5049 2c20 2055 of Video API, U │ │ │ │ │ +0000fee0: 703a 2056 6964 656f 2053 7562 7379 7374 p: Video Subsyst │ │ │ │ │ +0000fef0: 656d 0a0a 3130 2e33 2042 6974 6d61 7020 em..10.3 Bitmap │ │ │ │ │ +0000ff00: 4150 490a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d API.============ │ │ │ │ │ +0000ff10: 3d3d 3d0a 0a31 302e 332e 3120 6772 7562 ===..10.3.1 grub │ │ │ │ │ +0000ff20: 5f76 6964 656f 5f62 6974 6d61 705f 6372 _video_bitmap_cr │ │ │ │ │ +0000ff30: 6561 7465 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d eate.----------- │ │ │ │ │ 0000ff40: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000ff50: 2d2d 2d2d 2d2d 0a0a 2020 202a 2050 726f ------.. * Pro │ │ │ │ │ -0000ff60: 746f 7479 7065 3a0a 2020 2020 2020 2020 totype:. │ │ │ │ │ -0000ff70: 2020 6772 7562 5f65 7272 5f74 2067 7275 grub_err_t gru │ │ │ │ │ -0000ff80: 625f 7669 6465 6f5f 6269 746d 6170 5f63 b_video_bitmap_c │ │ │ │ │ -0000ff90: 7265 6174 6520 2873 7472 7563 7420 6772 reate (struct gr │ │ │ │ │ -0000ffa0: 7562 5f76 6964 656f 5f62 6974 6d61 7020 ub_video_bitmap │ │ │ │ │ -0000ffb0: 2a2a 6269 746d 6170 2c20 756e 7369 676e **bitmap, unsign │ │ │ │ │ -0000ffc0: 6564 2069 6e74 2077 6964 7468 2c20 756e ed int width, un │ │ │ │ │ -0000ffd0: 7369 676e 6564 2069 6e74 2068 6569 6768 signed int heigh │ │ │ │ │ -0000ffe0: 742c 2065 6e75 6d20 6772 7562 5f76 6964 t, enum grub_vid │ │ │ │ │ -0000fff0: 656f 5f62 6c69 745f 666f 726d 6174 2062 eo_blit_format b │ │ │ │ │ -00010000: 6c69 745f 666f 726d 6174 290a 0a20 2020 lit_format).. │ │ │ │ │ -00010010: 2a20 4465 7363 7269 7074 696f 6e3a 0a0a * Description:.. │ │ │ │ │ -00010020: 2020 2020 2043 7265 6174 6573 2061 206e Creates a n │ │ │ │ │ -00010030: 6577 2062 6974 6d61 7020 7769 7468 2067 ew bitmap with g │ │ │ │ │ -00010040: 6976 656e 2064 696d 656e 7369 6f6e 7320 iven dimensions │ │ │ │ │ -00010050: 616e 6420 626c 6974 7469 6e67 2066 6f72 and blitting for │ │ │ │ │ -00010060: 6d61 742e 0a20 2020 2020 416c 6c6f 6361 mat.. Alloca │ │ │ │ │ -00010070: 7465 6420 6269 746d 6170 2064 6174 6120 ted bitmap data │ │ │ │ │ -00010080: 6361 6e20 7468 656e 2062 6520 6d6f 6469 can then be modi │ │ │ │ │ -00010090: 6669 6564 2066 7265 656c 7920 616e 6420 fied freely and │ │ │ │ │ -000100a0: 6669 6e61 6c6c 790a 2020 2020 2062 6c69 finally. bli │ │ │ │ │ -000100b0: 7474 6564 2077 6974 6820 2767 7275 625f tted with 'grub_ │ │ │ │ │ -000100c0: 7669 6465 6f5f 626c 6974 5f62 6974 6d61 video_blit_bitma │ │ │ │ │ -000100d0: 7027 2074 6f20 7265 6e64 6572 696e 6720 p' to rendering │ │ │ │ │ -000100e0: 7461 7267 6574 2e0a 0a31 302e 332e 3220 target...10.3.2 │ │ │ │ │ -000100f0: 6772 7562 5f76 6964 656f 5f62 6974 6d61 grub_video_bitma │ │ │ │ │ -00010100: 705f 6465 7374 726f 790a 2d2d 2d2d 2d2d p_destroy.------ │ │ │ │ │ +0000ff50: 2d2d 2d2d 0a0a 2020 202a 2050 726f 746f ----.. * Proto │ │ │ │ │ +0000ff60: 7479 7065 3a0a 2020 2020 2020 2020 2020 type:. │ │ │ │ │ +0000ff70: 6772 7562 5f65 7272 5f74 2067 7275 625f grub_err_t grub_ │ │ │ │ │ +0000ff80: 7669 6465 6f5f 6269 746d 6170 5f63 7265 video_bitmap_cre │ │ │ │ │ +0000ff90: 6174 6520 2873 7472 7563 7420 6772 7562 ate (struct grub │ │ │ │ │ +0000ffa0: 5f76 6964 656f 5f62 6974 6d61 7020 2a2a _video_bitmap ** │ │ │ │ │ +0000ffb0: 6269 746d 6170 2c20 756e 7369 676e 6564 bitmap, unsigned │ │ │ │ │ +0000ffc0: 2069 6e74 2077 6964 7468 2c20 756e 7369 int width, unsi │ │ │ │ │ +0000ffd0: 676e 6564 2069 6e74 2068 6569 6768 742c gned int height, │ │ │ │ │ +0000ffe0: 2065 6e75 6d20 6772 7562 5f76 6964 656f enum grub_video │ │ │ │ │ +0000fff0: 5f62 6c69 745f 666f 726d 6174 2062 6c69 _blit_format bli │ │ │ │ │ +00010000: 745f 666f 726d 6174 290a 0a20 2020 2a20 t_format).. * │ │ │ │ │ +00010010: 4465 7363 7269 7074 696f 6e3a 0a0a 2020 Description:.. │ │ │ │ │ +00010020: 2020 2043 7265 6174 6573 2061 206e 6577 Creates a new │ │ │ │ │ +00010030: 2062 6974 6d61 7020 7769 7468 2067 6976 bitmap with giv │ │ │ │ │ +00010040: 656e 2064 696d 656e 7369 6f6e 7320 616e en dimensions an │ │ │ │ │ +00010050: 6420 626c 6974 7469 6e67 2066 6f72 6d61 d blitting forma │ │ │ │ │ +00010060: 742e 0a20 2020 2020 416c 6c6f 6361 7465 t.. Allocate │ │ │ │ │ +00010070: 6420 6269 746d 6170 2064 6174 6120 6361 d bitmap data ca │ │ │ │ │ +00010080: 6e20 7468 656e 2062 6520 6d6f 6469 6669 n then be modifi │ │ │ │ │ +00010090: 6564 2066 7265 656c 7920 616e 6420 6669 ed freely and fi │ │ │ │ │ +000100a0: 6e61 6c6c 790a 2020 2020 2062 6c69 7474 nally. blitt │ │ │ │ │ +000100b0: 6564 2077 6974 6820 2767 7275 625f 7669 ed with 'grub_vi │ │ │ │ │ +000100c0: 6465 6f5f 626c 6974 5f62 6974 6d61 7027 deo_blit_bitmap' │ │ │ │ │ +000100d0: 2074 6f20 7265 6e64 6572 696e 6720 7461 to rendering ta │ │ │ │ │ +000100e0: 7267 6574 2e0a 0a31 302e 332e 3220 6772 rget...10.3.2 gr │ │ │ │ │ +000100f0: 7562 5f76 6964 656f 5f62 6974 6d61 705f ub_video_bitmap_ │ │ │ │ │ +00010100: 6465 7374 726f 790a 2d2d 2d2d 2d2d 2d2d destroy.-------- │ │ │ │ │ 00010110: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00010120: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2020 202a ----------.. * │ │ │ │ │ -00010130: 2050 726f 746f 7479 7065 3a0a 2020 2020 Prototype:. │ │ │ │ │ -00010140: 2020 2020 2020 6772 7562 5f65 7272 5f74 grub_err_t │ │ │ │ │ -00010150: 2067 7275 625f 7669 6465 6f5f 6269 746d grub_video_bitm │ │ │ │ │ -00010160: 6170 5f64 6573 7472 6f79 2028 7374 7275 ap_destroy (stru │ │ │ │ │ -00010170: 6374 2067 7275 625f 7669 6465 6f5f 6269 ct grub_video_bi │ │ │ │ │ -00010180: 746d 6170 202a 6269 746d 6170 293b 0a0a tmap *bitmap);.. │ │ │ │ │ -00010190: 2020 202a 2044 6573 6372 6970 7469 6f6e * Description │ │ │ │ │ -000101a0: 3a0a 0a20 2020 2020 5768 656e 2062 6974 :.. When bit │ │ │ │ │ -000101b0: 6d61 7020 6973 206e 6f20 6c6f 6e67 6572 map is no longer │ │ │ │ │ -000101c0: 206e 6565 6465 642c 2069 7420 6361 6e20 needed, it can │ │ │ │ │ -000101d0: 6265 2066 7265 6564 2066 726f 6d20 6d65 be freed from me │ │ │ │ │ -000101e0: 6d6f 7279 2075 7369 6e67 0a20 2020 2020 mory using. │ │ │ │ │ -000101f0: 7468 6973 2063 6f6d 6d61 6e64 2e20 2027 this command. ' │ │ │ │ │ -00010200: 6269 746d 6170 2720 6973 2070 7265 7669 bitmap' is previ │ │ │ │ │ -00010210: 6f75 736c 7920 616c 6c6f 6361 7465 6420 ously allocated │ │ │ │ │ -00010220: 6269 746d 6170 2077 6974 680a 2020 2020 bitmap with. │ │ │ │ │ -00010230: 2027 6772 7562 5f76 6964 656f 5f62 6974 'grub_video_bit │ │ │ │ │ -00010240: 6d61 705f 6372 6561 7465 2720 6f72 206c map_create' or l │ │ │ │ │ -00010250: 6f61 6465 6420 7769 7468 2027 6772 7562 oaded with 'grub │ │ │ │ │ -00010260: 5f76 6964 656f 5f62 6974 6d61 705f 6c6f _video_bitmap_lo │ │ │ │ │ -00010270: 6164 272e 0a0a 3130 2e33 2e33 2067 7275 ad'...10.3.3 gru │ │ │ │ │ -00010280: 625f 7669 6465 6f5f 6269 746d 6170 5f6c b_video_bitmap_l │ │ │ │ │ -00010290: 6f61 640a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d oad.------------ │ │ │ │ │ -000102a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -000102b0: 2d0a 0a20 2020 2a20 5072 6f74 6f74 7970 -.. * Prototyp │ │ │ │ │ -000102c0: 653a 0a20 2020 2020 2020 2020 2067 7275 e:. gru │ │ │ │ │ -000102d0: 625f 6572 725f 7420 6772 7562 5f76 6964 b_err_t grub_vid │ │ │ │ │ -000102e0: 656f 5f62 6974 6d61 705f 6c6f 6164 2028 eo_bitmap_load ( │ │ │ │ │ -000102f0: 7374 7275 6374 2067 7275 625f 7669 6465 struct grub_vide │ │ │ │ │ -00010300: 6f5f 6269 746d 6170 202a 2a62 6974 6d61 o_bitmap **bitma │ │ │ │ │ -00010310: 702c 2063 6f6e 7374 2063 6861 7220 2a66 p, const char *f │ │ │ │ │ -00010320: 696c 656e 616d 6529 3b0a 0a20 2020 2a20 ilename);.. * │ │ │ │ │ -00010330: 4465 7363 7269 7074 696f 6e3a 0a0a 2020 Description:.. │ │ │ │ │ -00010340: 2020 2054 7269 6573 2074 6f20 6c6f 6164 Tries to load │ │ │ │ │ -00010350: 2067 6976 656e 2062 6974 6d61 7020 2827 given bitmap (' │ │ │ │ │ -00010360: 6669 6c65 6e61 6d65 2729 2075 7369 6e67 filename') using │ │ │ │ │ -00010370: 2072 6567 6973 7465 7265 6420 6269 746d registered bitm │ │ │ │ │ -00010380: 6170 0a20 2020 2020 6c6f 6164 6572 732e ap. loaders. │ │ │ │ │ -00010390: 2020 496e 2063 6173 6520 6269 746d 6170 In case bitmap │ │ │ │ │ -000103a0: 2066 6f72 6d61 7420 6973 206e 6f74 2072 format is not r │ │ │ │ │ -000103b0: 6563 6f67 6e69 7a65 6420 6f72 2073 7570 ecognized or sup │ │ │ │ │ -000103c0: 706f 7274 6564 0a20 2020 2020 6572 726f ported. erro │ │ │ │ │ -000103d0: 7220 2747 5255 425f 4552 525f 4241 445f r 'GRUB_ERR_BAD_ │ │ │ │ │ -000103e0: 4649 4c45 5f54 5950 4527 2069 7320 7265 FILE_TYPE' is re │ │ │ │ │ -000103f0: 7475 726e 6564 2e0a 0a31 302e 332e 3420 turned...10.3.4 │ │ │ │ │ -00010400: 6772 7562 5f76 6964 656f 5f62 6974 6d61 grub_video_bitma │ │ │ │ │ -00010410: 705f 6765 745f 7769 6474 680a 2d2d 2d2d p_get_width.---- │ │ │ │ │ +00010120: 2d2d 2d2d 2d2d 2d2d 0a0a 2020 202a 2050 --------.. * P │ │ │ │ │ +00010130: 726f 746f 7479 7065 3a0a 2020 2020 2020 rototype:. │ │ │ │ │ +00010140: 2020 2020 6772 7562 5f65 7272 5f74 2067 grub_err_t g │ │ │ │ │ +00010150: 7275 625f 7669 6465 6f5f 6269 746d 6170 rub_video_bitmap │ │ │ │ │ +00010160: 5f64 6573 7472 6f79 2028 7374 7275 6374 _destroy (struct │ │ │ │ │ +00010170: 2067 7275 625f 7669 6465 6f5f 6269 746d grub_video_bitm │ │ │ │ │ +00010180: 6170 202a 6269 746d 6170 293b 0a0a 2020 ap *bitmap);.. │ │ │ │ │ +00010190: 202a 2044 6573 6372 6970 7469 6f6e 3a0a * Description:. │ │ │ │ │ +000101a0: 0a20 2020 2020 5768 656e 2062 6974 6d61 . When bitma │ │ │ │ │ +000101b0: 7020 6973 206e 6f20 6c6f 6e67 6572 206e p is no longer n │ │ │ │ │ +000101c0: 6565 6465 642c 2069 7420 6361 6e20 6265 eeded, it can be │ │ │ │ │ +000101d0: 2066 7265 6564 2066 726f 6d20 6d65 6d6f freed from memo │ │ │ │ │ +000101e0: 7279 2075 7369 6e67 0a20 2020 2020 7468 ry using. th │ │ │ │ │ +000101f0: 6973 2063 6f6d 6d61 6e64 2e20 2027 6269 is command. 'bi │ │ │ │ │ +00010200: 746d 6170 2720 6973 2070 7265 7669 6f75 tmap' is previou │ │ │ │ │ +00010210: 736c 7920 616c 6c6f 6361 7465 6420 6269 sly allocated bi │ │ │ │ │ +00010220: 746d 6170 2077 6974 680a 2020 2020 2027 tmap with. ' │ │ │ │ │ +00010230: 6772 7562 5f76 6964 656f 5f62 6974 6d61 grub_video_bitma │ │ │ │ │ +00010240: 705f 6372 6561 7465 2720 6f72 206c 6f61 p_create' or loa │ │ │ │ │ +00010250: 6465 6420 7769 7468 2027 6772 7562 5f76 ded with 'grub_v │ │ │ │ │ +00010260: 6964 656f 5f62 6974 6d61 705f 6c6f 6164 ideo_bitmap_load │ │ │ │ │ +00010270: 272e 0a0a 3130 2e33 2e33 2067 7275 625f '...10.3.3 grub_ │ │ │ │ │ +00010280: 7669 6465 6f5f 6269 746d 6170 5f6c 6f61 video_bitmap_loa │ │ │ │ │ +00010290: 640a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d d.-------------- │ │ │ │ │ +000102a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ +000102b0: 0a20 2020 2a20 5072 6f74 6f74 7970 653a . * Prototype: │ │ │ │ │ +000102c0: 0a20 2020 2020 2020 2020 2067 7275 625f . grub_ │ │ │ │ │ +000102d0: 6572 725f 7420 6772 7562 5f76 6964 656f err_t grub_video │ │ │ │ │ +000102e0: 5f62 6974 6d61 705f 6c6f 6164 2028 7374 _bitmap_load (st │ │ │ │ │ +000102f0: 7275 6374 2067 7275 625f 7669 6465 6f5f ruct grub_video_ │ │ │ │ │ +00010300: 6269 746d 6170 202a 2a62 6974 6d61 702c bitmap **bitmap, │ │ │ │ │ +00010310: 2063 6f6e 7374 2063 6861 7220 2a66 696c const char *fil │ │ │ │ │ +00010320: 656e 616d 6529 3b0a 0a20 2020 2a20 4465 ename);.. * De │ │ │ │ │ +00010330: 7363 7269 7074 696f 6e3a 0a0a 2020 2020 scription:.. │ │ │ │ │ +00010340: 2054 7269 6573 2074 6f20 6c6f 6164 2067 Tries to load g │ │ │ │ │ +00010350: 6976 656e 2062 6974 6d61 7020 2827 6669 iven bitmap ('fi │ │ │ │ │ +00010360: 6c65 6e61 6d65 2729 2075 7369 6e67 2072 lename') using r │ │ │ │ │ +00010370: 6567 6973 7465 7265 6420 6269 746d 6170 egistered bitmap │ │ │ │ │ +00010380: 0a20 2020 2020 6c6f 6164 6572 732e 2020 . loaders. │ │ │ │ │ +00010390: 496e 2063 6173 6520 6269 746d 6170 2066 In case bitmap f │ │ │ │ │ +000103a0: 6f72 6d61 7420 6973 206e 6f74 2072 6563 ormat is not rec │ │ │ │ │ +000103b0: 6f67 6e69 7a65 6420 6f72 2073 7570 706f ognized or suppo │ │ │ │ │ +000103c0: 7274 6564 0a20 2020 2020 6572 726f 7220 rted. error │ │ │ │ │ +000103d0: 2747 5255 425f 4552 525f 4241 445f 4649 'GRUB_ERR_BAD_FI │ │ │ │ │ +000103e0: 4c45 5f54 5950 4527 2069 7320 7265 7475 LE_TYPE' is retu │ │ │ │ │ +000103f0: 726e 6564 2e0a 0a31 302e 332e 3420 6772 rned...10.3.4 gr │ │ │ │ │ +00010400: 7562 5f76 6964 656f 5f62 6974 6d61 705f ub_video_bitmap_ │ │ │ │ │ +00010410: 6765 745f 7769 6474 680a 2d2d 2d2d 2d2d get_width.------ │ │ │ │ │ 00010420: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00010430: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ -00010440: 2020 202a 2050 726f 746f 7479 7065 3a0a * Prototype:. │ │ │ │ │ -00010450: 2020 2020 2020 2020 2020 756e 7369 676e unsign │ │ │ │ │ -00010460: 6564 2069 6e74 2067 7275 625f 7669 6465 ed int grub_vide │ │ │ │ │ -00010470: 6f5f 6269 746d 6170 5f67 6574 5f77 6964 o_bitmap_get_wid │ │ │ │ │ -00010480: 7468 2028 7374 7275 6374 2067 7275 625f th (struct grub_ │ │ │ │ │ -00010490: 7669 6465 6f5f 6269 746d 6170 202a 6269 video_bitmap *bi │ │ │ │ │ -000104a0: 746d 6170 293b 0a0a 2020 202a 2044 6573 tmap);.. * Des │ │ │ │ │ -000104b0: 6372 6970 7469 6f6e 3a0a 0a20 2020 2020 cription:.. │ │ │ │ │ -000104c0: 5265 7475 726e 7320 6269 746d 6170 2077 Returns bitmap w │ │ │ │ │ -000104d0: 6964 7468 2e0a 0a31 302e 332e 3520 6772 idth...10.3.5 gr │ │ │ │ │ -000104e0: 7562 5f76 6964 656f 5f62 6974 6d61 705f ub_video_bitmap_ │ │ │ │ │ -000104f0: 6765 745f 6865 6967 6874 0a2d 2d2d 2d2d get_height.----- │ │ │ │ │ +00010430: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2020 ------------.. │ │ │ │ │ +00010440: 202a 2050 726f 746f 7479 7065 3a0a 2020 * Prototype:. │ │ │ │ │ +00010450: 2020 2020 2020 2020 756e 7369 676e 6564 unsigned │ │ │ │ │ +00010460: 2069 6e74 2067 7275 625f 7669 6465 6f5f int grub_video_ │ │ │ │ │ +00010470: 6269 746d 6170 5f67 6574 5f77 6964 7468 bitmap_get_width │ │ │ │ │ +00010480: 2028 7374 7275 6374 2067 7275 625f 7669 (struct grub_vi │ │ │ │ │ +00010490: 6465 6f5f 6269 746d 6170 202a 6269 746d deo_bitmap *bitm │ │ │ │ │ +000104a0: 6170 293b 0a0a 2020 202a 2044 6573 6372 ap);.. * Descr │ │ │ │ │ +000104b0: 6970 7469 6f6e 3a0a 0a20 2020 2020 5265 iption:.. Re │ │ │ │ │ +000104c0: 7475 726e 7320 6269 746d 6170 2077 6964 turns bitmap wid │ │ │ │ │ +000104d0: 7468 2e0a 0a31 302e 332e 3520 6772 7562 th...10.3.5 grub │ │ │ │ │ +000104e0: 5f76 6964 656f 5f62 6974 6d61 705f 6765 _video_bitmap_ge │ │ │ │ │ +000104f0: 745f 6865 6967 6874 0a2d 2d2d 2d2d 2d2d t_height.------- │ │ │ │ │ 00010500: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00010510: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ -00010520: 2020 202a 2050 726f 746f 7479 7065 3a0a * Prototype:. │ │ │ │ │ -00010530: 2020 2020 2020 2020 2020 756e 7369 676e unsign │ │ │ │ │ -00010540: 6564 2069 6e74 2067 7275 625f 7669 6465 ed int grub_vide │ │ │ │ │ -00010550: 6f5f 6269 746d 6170 5f67 6574 5f68 6569 o_bitmap_get_hei │ │ │ │ │ -00010560: 6768 7420 2873 7472 7563 7420 6772 7562 ght (struct grub │ │ │ │ │ -00010570: 5f76 6964 656f 5f62 6974 6d61 7020 2a62 _video_bitmap *b │ │ │ │ │ -00010580: 6974 6d61 7029 3b0a 0a20 2020 2a20 4465 itmap);.. * De │ │ │ │ │ -00010590: 7363 7269 7074 696f 6e3a 0a0a 2020 2020 scription:.. │ │ │ │ │ -000105a0: 2052 6574 7572 6e20 6269 746d 6170 2068 Return bitmap h │ │ │ │ │ -000105b0: 6569 6768 742e 0a0a 3130 2e33 2e36 2067 eight...10.3.6 g │ │ │ │ │ -000105c0: 7275 625f 7669 6465 6f5f 6269 746d 6170 rub_video_bitmap │ │ │ │ │ -000105d0: 5f67 6574 5f6d 6f64 655f 696e 666f 0a2d _get_mode_info.- │ │ │ │ │ +00010510: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2020 ------------.. │ │ │ │ │ +00010520: 202a 2050 726f 746f 7479 7065 3a0a 2020 * Prototype:. │ │ │ │ │ +00010530: 2020 2020 2020 2020 756e 7369 676e 6564 unsigned │ │ │ │ │ +00010540: 2069 6e74 2067 7275 625f 7669 6465 6f5f int grub_video_ │ │ │ │ │ +00010550: 6269 746d 6170 5f67 6574 5f68 6569 6768 bitmap_get_heigh │ │ │ │ │ +00010560: 7420 2873 7472 7563 7420 6772 7562 5f76 t (struct grub_v │ │ │ │ │ +00010570: 6964 656f 5f62 6974 6d61 7020 2a62 6974 ideo_bitmap *bit │ │ │ │ │ +00010580: 6d61 7029 3b0a 0a20 2020 2a20 4465 7363 map);.. * Desc │ │ │ │ │ +00010590: 7269 7074 696f 6e3a 0a0a 2020 2020 2052 ription:.. R │ │ │ │ │ +000105a0: 6574 7572 6e20 6269 746d 6170 2068 6569 eturn bitmap hei │ │ │ │ │ +000105b0: 6768 742e 0a0a 3130 2e33 2e36 2067 7275 ght...10.3.6 gru │ │ │ │ │ +000105c0: 625f 7669 6465 6f5f 6269 746d 6170 5f67 b_video_bitmap_g │ │ │ │ │ +000105d0: 6574 5f6d 6f64 655f 696e 666f 0a2d 2d2d et_mode_info.--- │ │ │ │ │ 000105e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 000105f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00010600: 2d2d 2d2d 2d0a 0a20 2020 2a20 5072 6f74 -----.. * Prot │ │ │ │ │ -00010610: 6f74 7970 653a 0a20 2020 2020 2020 2020 otype:. │ │ │ │ │ -00010620: 2076 6f69 6420 6772 7562 5f76 6964 656f void grub_video │ │ │ │ │ -00010630: 5f62 6974 6d61 705f 6765 745f 6d6f 6465 _bitmap_get_mode │ │ │ │ │ -00010640: 5f69 6e66 6f20 2873 7472 7563 7420 6772 _info (struct gr │ │ │ │ │ -00010650: 7562 5f76 6964 656f 5f62 6974 6d61 7020 ub_video_bitmap │ │ │ │ │ -00010660: 2a62 6974 6d61 702c 2073 7472 7563 7420 *bitmap, struct │ │ │ │ │ -00010670: 6772 7562 5f76 6964 656f 5f6d 6f64 655f grub_video_mode_ │ │ │ │ │ -00010680: 696e 666f 202a 6d6f 6465 5f69 6e66 6f29 info *mode_info) │ │ │ │ │ -00010690: 3b0a 0a20 2020 2a20 4465 7363 7269 7074 ;.. * Descript │ │ │ │ │ -000106a0: 696f 6e3a 0a0a 2020 2020 2052 6574 7572 ion:.. Retur │ │ │ │ │ -000106b0: 6e73 2062 6974 6d61 7020 666f 726d 6174 ns bitmap format │ │ │ │ │ -000106c0: 2064 6574 6169 6c73 2069 6e20 666f 726d details in form │ │ │ │ │ -000106d0: 206f 6620 2767 7275 625f 7669 6465 6f5f of 'grub_video_ │ │ │ │ │ -000106e0: 6d6f 6465 5f69 6e66 6f27 2e0a 0a31 302e mode_info'...10. │ │ │ │ │ -000106f0: 332e 3720 6772 7562 5f76 6964 656f 5f62 3.7 grub_video_b │ │ │ │ │ -00010700: 6974 6d61 705f 6765 745f 6461 7461 0a2d itmap_get_data.- │ │ │ │ │ +00010600: 2d2d 2d0a 0a20 2020 2a20 5072 6f74 6f74 ---.. * Protot │ │ │ │ │ +00010610: 7970 653a 0a20 2020 2020 2020 2020 2076 ype:. v │ │ │ │ │ +00010620: 6f69 6420 6772 7562 5f76 6964 656f 5f62 oid grub_video_b │ │ │ │ │ +00010630: 6974 6d61 705f 6765 745f 6d6f 6465 5f69 itmap_get_mode_i │ │ │ │ │ +00010640: 6e66 6f20 2873 7472 7563 7420 6772 7562 nfo (struct grub │ │ │ │ │ +00010650: 5f76 6964 656f 5f62 6974 6d61 7020 2a62 _video_bitmap *b │ │ │ │ │ +00010660: 6974 6d61 702c 2073 7472 7563 7420 6772 itmap, struct gr │ │ │ │ │ +00010670: 7562 5f76 6964 656f 5f6d 6f64 655f 696e ub_video_mode_in │ │ │ │ │ +00010680: 666f 202a 6d6f 6465 5f69 6e66 6f29 3b0a fo *mode_info);. │ │ │ │ │ +00010690: 0a20 2020 2a20 4465 7363 7269 7074 696f . * Descriptio │ │ │ │ │ +000106a0: 6e3a 0a0a 2020 2020 2052 6574 7572 6e73 n:.. Returns │ │ │ │ │ +000106b0: 2062 6974 6d61 7020 666f 726d 6174 2064 bitmap format d │ │ │ │ │ +000106c0: 6574 6169 6c73 2069 6e20 666f 726d 206f etails in form o │ │ │ │ │ +000106d0: 6620 2767 7275 625f 7669 6465 6f5f 6d6f f 'grub_video_mo │ │ │ │ │ +000106e0: 6465 5f69 6e66 6f27 2e0a 0a31 302e 332e de_info'...10.3. │ │ │ │ │ +000106f0: 3720 6772 7562 5f76 6964 656f 5f62 6974 7 grub_video_bit │ │ │ │ │ +00010700: 6d61 705f 6765 745f 6461 7461 0a2d 2d2d map_get_data.--- │ │ │ │ │ 00010710: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00010720: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00010730: 0a0a 2020 202a 2050 726f 746f 7479 7065 .. * Prototype │ │ │ │ │ -00010740: 3a0a 2020 2020 2020 2020 2020 766f 6964 :. void │ │ │ │ │ -00010750: 202a 6772 7562 5f76 6964 656f 5f62 6974 *grub_video_bit │ │ │ │ │ -00010760: 6d61 705f 6765 745f 6461 7461 2028 7374 map_get_data (st │ │ │ │ │ -00010770: 7275 6374 2067 7275 625f 7669 6465 6f5f ruct grub_video_ │ │ │ │ │ -00010780: 6269 746d 6170 202a 6269 746d 6170 293b bitmap *bitmap); │ │ │ │ │ -00010790: 0a0a 2020 202a 2044 6573 6372 6970 7469 .. * Descripti │ │ │ │ │ -000107a0: 6f6e 3a0a 0a20 2020 2020 5265 7475 726e on:.. Return │ │ │ │ │ -000107b0: 2070 6f69 6e74 6572 2074 6f20 6269 746d pointer to bitm │ │ │ │ │ -000107c0: 6170 2064 6174 612e 2020 436f 6e74 656e ap data. Conten │ │ │ │ │ -000107d0: 7473 206f 6620 7468 6520 706f 696e 7465 ts of the pointe │ │ │ │ │ -000107e0: 6420 6461 7461 2063 616e 2062 650a 2020 d data can be. │ │ │ │ │ -000107f0: 2020 2066 7265 656c 7920 6d6f 6469 6669 freely modifi │ │ │ │ │ -00010800: 6564 2e20 2054 6865 7265 2069 7320 6e6f ed. There is no │ │ │ │ │ -00010810: 2065 7874 7261 2070 726f 7465 6374 696f extra protectio │ │ │ │ │ -00010820: 6e20 6167 6169 6e73 7420 676f 696e 6720 n against going │ │ │ │ │ -00010830: 6f66 660a 2020 2020 2074 6865 2062 6f75 off. the bou │ │ │ │ │ -00010840: 6e64 7320 736f 2079 6f75 2068 6176 6520 nds so you have │ │ │ │ │ -00010850: 746f 2062 6520 6361 7265 6675 6c6c 2068 to be carefull h │ │ │ │ │ -00010860: 6f77 2074 6f20 6163 6365 7373 2074 6865 ow to access the │ │ │ │ │ -00010870: 2064 6174 612e 0a0a 1f0a 4669 6c65 3a20 data.....File: │ │ │ │ │ -00010880: 6772 7562 2d64 6576 2e69 6e66 6f2c 2020 grub-dev.info, │ │ │ │ │ -00010890: 4e6f 6465 3a20 5046 4632 2046 6f6e 7420 Node: PFF2 Font │ │ │ │ │ -000108a0: 4669 6c65 2046 6f72 6d61 742c 2020 4e65 File Format, Ne │ │ │ │ │ -000108b0: 7874 3a20 4772 6170 6869 6361 6c20 4d65 xt: Graphical Me │ │ │ │ │ -000108c0: 6e75 2053 6f66 7477 6172 6520 4465 7369 nu Software Desi │ │ │ │ │ -000108d0: 676e 2c20 2050 7265 763a 2056 6964 656f gn, Prev: Video │ │ │ │ │ -000108e0: 2053 7562 7379 7374 656d 2c20 2055 703a Subsystem, Up: │ │ │ │ │ -000108f0: 2054 6f70 0a0a 3131 2050 4646 3220 466f Top..11 PFF2 Fo │ │ │ │ │ -00010900: 6e74 2046 696c 6520 466f 726d 6174 0a2a nt File Format.* │ │ │ │ │ +00010720: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ +00010730: 2020 202a 2050 726f 746f 7479 7065 3a0a * Prototype:. │ │ │ │ │ +00010740: 2020 2020 2020 2020 2020 766f 6964 202a void * │ │ │ │ │ +00010750: 6772 7562 5f76 6964 656f 5f62 6974 6d61 grub_video_bitma │ │ │ │ │ +00010760: 705f 6765 745f 6461 7461 2028 7374 7275 p_get_data (stru │ │ │ │ │ +00010770: 6374 2067 7275 625f 7669 6465 6f5f 6269 ct grub_video_bi │ │ │ │ │ +00010780: 746d 6170 202a 6269 746d 6170 293b 0a0a tmap *bitmap);.. │ │ │ │ │ +00010790: 2020 202a 2044 6573 6372 6970 7469 6f6e * Description │ │ │ │ │ +000107a0: 3a0a 0a20 2020 2020 5265 7475 726e 2070 :.. Return p │ │ │ │ │ +000107b0: 6f69 6e74 6572 2074 6f20 6269 746d 6170 ointer to bitmap │ │ │ │ │ +000107c0: 2064 6174 612e 2020 436f 6e74 656e 7473 data. Contents │ │ │ │ │ +000107d0: 206f 6620 7468 6520 706f 696e 7465 6420 of the pointed │ │ │ │ │ +000107e0: 6461 7461 2063 616e 2062 650a 2020 2020 data can be. │ │ │ │ │ +000107f0: 2066 7265 656c 7920 6d6f 6469 6669 6564 freely modified │ │ │ │ │ +00010800: 2e20 2054 6865 7265 2069 7320 6e6f 2065 . There is no e │ │ │ │ │ +00010810: 7874 7261 2070 726f 7465 6374 696f 6e20 xtra protection │ │ │ │ │ +00010820: 6167 6169 6e73 7420 676f 696e 6720 6f66 against going of │ │ │ │ │ +00010830: 660a 2020 2020 2074 6865 2062 6f75 6e64 f. the bound │ │ │ │ │ +00010840: 7320 736f 2079 6f75 2068 6176 6520 746f s so you have to │ │ │ │ │ +00010850: 2062 6520 6361 7265 6675 6c6c 2068 6f77 be carefull how │ │ │ │ │ +00010860: 2074 6f20 6163 6365 7373 2074 6865 2064 to access the d │ │ │ │ │ +00010870: 6174 612e 0a0a 1f0a 4669 6c65 3a20 6772 ata.....File: gr │ │ │ │ │ +00010880: 7562 2d64 6576 2e69 6e66 6f2c 2020 4e6f ub-dev.info, No │ │ │ │ │ +00010890: 6465 3a20 5046 4632 2046 6f6e 7420 4669 de: PFF2 Font Fi │ │ │ │ │ +000108a0: 6c65 2046 6f72 6d61 742c 2020 4e65 7874 le Format, Next │ │ │ │ │ +000108b0: 3a20 4772 6170 6869 6361 6c20 4d65 6e75 : Graphical Menu │ │ │ │ │ +000108c0: 2053 6f66 7477 6172 6520 4465 7369 676e Software Design │ │ │ │ │ +000108d0: 2c20 2050 7265 763a 2056 6964 656f 2053 , Prev: Video S │ │ │ │ │ +000108e0: 7562 7379 7374 656d 2c20 2055 703a 2054 ubsystem, Up: T │ │ │ │ │ +000108f0: 6f70 0a0a 3131 2050 4646 3220 466f 6e74 op..11 PFF2 Font │ │ │ │ │ +00010900: 2046 696c 6520 466f 726d 6174 0a2a 2a2a File Format.*** │ │ │ │ │ 00010910: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -00010920: 2a2a 2a2a 2a2a 2a0a 0a2a 204d 656e 753a *******..* Menu: │ │ │ │ │ -00010930: 0a0a 2a20 496e 7472 6f64 7563 7469 6f6e ..* Introduction │ │ │ │ │ -00010940: 3a3a 0a2a 2046 696c 6520 5374 7275 6374 ::.* File Struct │ │ │ │ │ -00010950: 7572 653a 3a0a 2a20 466f 6e74 204d 6574 ure::.* Font Met │ │ │ │ │ -00010960: 7269 6373 3a3a 0a0a 1f0a 4669 6c65 3a20 rics::....File: │ │ │ │ │ -00010970: 6772 7562 2d64 6576 2e69 6e66 6f2c 2020 grub-dev.info, │ │ │ │ │ -00010980: 4e6f 6465 3a20 496e 7472 6f64 7563 7469 Node: Introducti │ │ │ │ │ -00010990: 6f6e 2c20 204e 6578 743a 2046 696c 6520 on, Next: File │ │ │ │ │ -000109a0: 5374 7275 6374 7572 652c 2020 5570 3a20 Structure, Up: │ │ │ │ │ -000109b0: 5046 4632 2046 6f6e 7420 4669 6c65 2046 PFF2 Font File F │ │ │ │ │ -000109c0: 6f72 6d61 740a 0a31 312e 3120 496e 7472 ormat..11.1 Intr │ │ │ │ │ -000109d0: 6f64 7563 7469 6f6e 0a3d 3d3d 3d3d 3d3d oduction.======= │ │ │ │ │ -000109e0: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 5468 6520 ==========..The │ │ │ │ │ -000109f0: 676f 616c 206f 6620 7468 6973 2066 6f72 goal of this for │ │ │ │ │ -00010a00: 6d61 7420 6973 2074 6f20 7072 6f76 6964 mat is to provid │ │ │ │ │ -00010a10: 6520 6120 6269 746d 6170 2066 6f6e 7420 e a bitmap font │ │ │ │ │ -00010a20: 666f 726d 6174 2074 6861 7420 6973 0a73 format that is.s │ │ │ │ │ -00010a30: 696d 706c 6520 746f 2075 7365 2c20 636f imple to use, co │ │ │ │ │ -00010a40: 6d70 6163 742c 2061 6e64 2063 6c65 616e mpact, and clean │ │ │ │ │ -00010a50: 6c79 2073 7570 706f 7274 7320 556e 6963 ly supports Unic │ │ │ │ │ -00010a60: 6f64 652e 0a0a 3131 2e31 2e31 2047 6f61 ode...11.1.1 Goa │ │ │ │ │ -00010a70: 6c73 206f 6620 7468 6520 4752 5542 2046 ls of the GRUB F │ │ │ │ │ -00010a80: 6f6e 7420 466f 726d 6174 0a2d 2d2d 2d2d ont Format.----- │ │ │ │ │ +00010920: 2a2a 2a2a 2a0a 0a2a 204d 656e 753a 0a0a *****..* Menu:.. │ │ │ │ │ +00010930: 2a20 496e 7472 6f64 7563 7469 6f6e 3a3a * Introduction:: │ │ │ │ │ +00010940: 0a2a 2046 696c 6520 5374 7275 6374 7572 .* File Structur │ │ │ │ │ +00010950: 653a 3a0a 2a20 466f 6e74 204d 6574 7269 e::.* Font Metri │ │ │ │ │ +00010960: 6373 3a3a 0a0a 1f0a 4669 6c65 3a20 6772 cs::....File: gr │ │ │ │ │ +00010970: 7562 2d64 6576 2e69 6e66 6f2c 2020 4e6f ub-dev.info, No │ │ │ │ │ +00010980: 6465 3a20 496e 7472 6f64 7563 7469 6f6e de: Introduction │ │ │ │ │ +00010990: 2c20 204e 6578 743a 2046 696c 6520 5374 , Next: File St │ │ │ │ │ +000109a0: 7275 6374 7572 652c 2020 5570 3a20 5046 ructure, Up: PF │ │ │ │ │ +000109b0: 4632 2046 6f6e 7420 4669 6c65 2046 6f72 F2 Font File For │ │ │ │ │ +000109c0: 6d61 740a 0a31 312e 3120 496e 7472 6f64 mat..11.1 Introd │ │ │ │ │ +000109d0: 7563 7469 6f6e 0a3d 3d3d 3d3d 3d3d 3d3d uction.========= │ │ │ │ │ +000109e0: 3d3d 3d3d 3d3d 3d3d 0a0a 5468 6520 676f ========..The go │ │ │ │ │ +000109f0: 616c 206f 6620 7468 6973 2066 6f72 6d61 al of this forma │ │ │ │ │ +00010a00: 7420 6973 2074 6f20 7072 6f76 6964 6520 t is to provide │ │ │ │ │ +00010a10: 6120 6269 746d 6170 2066 6f6e 7420 666f a bitmap font fo │ │ │ │ │ +00010a20: 726d 6174 2074 6861 7420 6973 0a73 696d rmat that is.sim │ │ │ │ │ +00010a30: 706c 6520 746f 2075 7365 2c20 636f 6d70 ple to use, comp │ │ │ │ │ +00010a40: 6163 742c 2061 6e64 2063 6c65 616e 6c79 act, and cleanly │ │ │ │ │ +00010a50: 2073 7570 706f 7274 7320 556e 6963 6f64 supports Unicod │ │ │ │ │ +00010a60: 652e 0a0a 3131 2e31 2e31 2047 6f61 6c73 e...11.1.1 Goals │ │ │ │ │ +00010a70: 206f 6620 7468 6520 4752 5542 2046 6f6e of the GRUB Fon │ │ │ │ │ +00010a80: 7420 466f 726d 6174 0a2d 2d2d 2d2d 2d2d t Format.------- │ │ │ │ │ 00010a90: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00010aa0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ -00010ab0: 0a20 2020 2a20 5369 6d70 6c65 2074 6f20 . * Simple to │ │ │ │ │ -00010ac0: 7265 6164 2061 6e64 2075 7365 2e20 2053 read and use. S │ │ │ │ │ -00010ad0: 696e 6365 2047 5255 4220 7769 6c6c 206f ince GRUB will o │ │ │ │ │ -00010ae0: 6e6c 7920 6265 2072 6561 6469 6e67 2074 nly be reading t │ │ │ │ │ -00010af0: 6865 2066 6f6e 740a 2020 2020 2066 696c he font. fil │ │ │ │ │ -00010b00: 6573 2c20 7765 2061 7265 206d 6f72 6520 es, we are more │ │ │ │ │ -00010b10: 636f 6e63 6572 6e65 6420 7769 7468 206d concerned with m │ │ │ │ │ -00010b20: 616b 696e 6720 7468 6520 636f 6465 2074 aking the code t │ │ │ │ │ -00010b30: 6f20 7265 6164 2074 6865 2066 6f6e 740a o read the font. │ │ │ │ │ -00010b40: 2020 2020 2073 696d 706c 6520 7468 616e simple than │ │ │ │ │ -00010b50: 2077 6520 6172 6520 7769 7468 2077 7269 we are with wri │ │ │ │ │ -00010b60: 7469 6e67 2074 6865 2066 6f6e 742e 0a0a ting the font... │ │ │ │ │ -00010b70: 2020 202a 2043 6f6d 7061 6374 2073 746f * Compact sto │ │ │ │ │ -00010b80: 7261 6765 2e20 2054 6865 2066 6f6e 7473 rage. The fonts │ │ │ │ │ -00010b90: 2077 696c 6c20 6765 6e65 7261 6c6c 7920 will generally │ │ │ │ │ -00010ba0: 6265 2073 746f 7265 6420 696e 2061 2073 be stored in a s │ │ │ │ │ -00010bb0: 6d61 6c6c 0a20 2020 2020 626f 6f74 2070 mall. boot p │ │ │ │ │ -00010bc0: 6172 7469 7469 6f6e 2077 6865 7265 2047 artition where G │ │ │ │ │ -00010bd0: 5255 4220 6973 206c 6f63 6174 6564 2c20 RUB is located, │ │ │ │ │ -00010be0: 616e 6420 7468 6973 206d 6179 2062 6520 and this may be │ │ │ │ │ -00010bf0: 6f6e 2061 0a20 2020 2020 7265 6d6f 7661 on a. remova │ │ │ │ │ -00010c00: 626c 6520 7374 6f72 6167 6520 6465 7669 ble storage devi │ │ │ │ │ -00010c10: 6365 2073 7563 6820 6173 2061 2043 4420 ce such as a CD │ │ │ │ │ -00010c20: 6f72 2055 5342 2066 6c61 7368 2064 7269 or USB flash dri │ │ │ │ │ -00010c30: 7665 2077 6865 7265 0a20 2020 2020 7370 ve where. sp │ │ │ │ │ -00010c40: 6163 6520 6973 206d 6f72 6520 6c69 6d69 ace is more limi │ │ │ │ │ -00010c50: 7465 6420 7468 616e 2069 7420 6973 206f ted than it is o │ │ │ │ │ -00010c60: 6e20 6d6f 7374 2068 6172 6420 6472 6976 n most hard driv │ │ │ │ │ -00010c70: 6573 2e0a 0a20 2020 2a20 556e 6963 6f64 es... * Unicod │ │ │ │ │ -00010c80: 652e 2020 4752 5542 2073 686f 756c 6420 e. GRUB should │ │ │ │ │ -00010c90: 6e6f 7420 6861 7665 2074 6f20 6465 616c not have to deal │ │ │ │ │ -00010ca0: 2077 6974 6820 6d75 6c74 6970 6c65 2063 with multiple c │ │ │ │ │ -00010cb0: 6861 7261 6374 6572 0a20 2020 2020 656e haracter. en │ │ │ │ │ -00010cc0: 636f 6469 6e67 732e 2020 5468 6520 666f codings. The fo │ │ │ │ │ -00010cd0: 6e74 2073 686f 756c 6420 616c 7761 7973 nt should always │ │ │ │ │ -00010ce0: 2075 7365 2055 6e69 636f 6465 2063 6861 use Unicode cha │ │ │ │ │ -00010cf0: 7261 6374 6572 2063 6f64 6573 2066 6f72 racter codes for │ │ │ │ │ -00010d00: 0a20 2020 2020 7369 6d70 6c65 2069 6e74 . simple int │ │ │ │ │ -00010d10: 6572 6e61 7469 6f6e 616c 697a 6174 696f ernationalizatio │ │ │ │ │ -00010d20: 6e2e 0a0a 3131 2e31 2e32 2057 6879 2041 n...11.1.2 Why A │ │ │ │ │ -00010d30: 6e6f 7468 6572 2046 6f6e 7420 466f 726d nother Font Form │ │ │ │ │ -00010d40: 6174 3f0a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d at?.------------ │ │ │ │ │ +00010aa0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 -------------.. │ │ │ │ │ +00010ab0: 2020 2a20 5369 6d70 6c65 2074 6f20 7265 * Simple to re │ │ │ │ │ +00010ac0: 6164 2061 6e64 2075 7365 2e20 2053 696e ad and use. Sin │ │ │ │ │ +00010ad0: 6365 2047 5255 4220 7769 6c6c 206f 6e6c ce GRUB will onl │ │ │ │ │ +00010ae0: 7920 6265 2072 6561 6469 6e67 2074 6865 y be reading the │ │ │ │ │ +00010af0: 2066 6f6e 740a 2020 2020 2066 696c 6573 font. files │ │ │ │ │ +00010b00: 2c20 7765 2061 7265 206d 6f72 6520 636f , we are more co │ │ │ │ │ +00010b10: 6e63 6572 6e65 6420 7769 7468 206d 616b ncerned with mak │ │ │ │ │ +00010b20: 696e 6720 7468 6520 636f 6465 2074 6f20 ing the code to │ │ │ │ │ +00010b30: 7265 6164 2074 6865 2066 6f6e 740a 2020 read the font. │ │ │ │ │ +00010b40: 2020 2073 696d 706c 6520 7468 616e 2077 simple than w │ │ │ │ │ +00010b50: 6520 6172 6520 7769 7468 2077 7269 7469 e are with writi │ │ │ │ │ +00010b60: 6e67 2074 6865 2066 6f6e 742e 0a0a 2020 ng the font... │ │ │ │ │ +00010b70: 202a 2043 6f6d 7061 6374 2073 746f 7261 * Compact stora │ │ │ │ │ +00010b80: 6765 2e20 2054 6865 2066 6f6e 7473 2077 ge. The fonts w │ │ │ │ │ +00010b90: 696c 6c20 6765 6e65 7261 6c6c 7920 6265 ill generally be │ │ │ │ │ +00010ba0: 2073 746f 7265 6420 696e 2061 2073 6d61 stored in a sma │ │ │ │ │ +00010bb0: 6c6c 0a20 2020 2020 626f 6f74 2070 6172 ll. boot par │ │ │ │ │ +00010bc0: 7469 7469 6f6e 2077 6865 7265 2047 5255 tition where GRU │ │ │ │ │ +00010bd0: 4220 6973 206c 6f63 6174 6564 2c20 616e B is located, an │ │ │ │ │ +00010be0: 6420 7468 6973 206d 6179 2062 6520 6f6e d this may be on │ │ │ │ │ +00010bf0: 2061 0a20 2020 2020 7265 6d6f 7661 626c a. removabl │ │ │ │ │ +00010c00: 6520 7374 6f72 6167 6520 6465 7669 6365 e storage device │ │ │ │ │ +00010c10: 2073 7563 6820 6173 2061 2043 4420 6f72 such as a CD or │ │ │ │ │ +00010c20: 2055 5342 2066 6c61 7368 2064 7269 7665 USB flash drive │ │ │ │ │ +00010c30: 2077 6865 7265 0a20 2020 2020 7370 6163 where. spac │ │ │ │ │ +00010c40: 6520 6973 206d 6f72 6520 6c69 6d69 7465 e is more limite │ │ │ │ │ +00010c50: 6420 7468 616e 2069 7420 6973 206f 6e20 d than it is on │ │ │ │ │ +00010c60: 6d6f 7374 2068 6172 6420 6472 6976 6573 most hard drives │ │ │ │ │ +00010c70: 2e0a 0a20 2020 2a20 556e 6963 6f64 652e ... * Unicode. │ │ │ │ │ +00010c80: 2020 4752 5542 2073 686f 756c 6420 6e6f GRUB should no │ │ │ │ │ +00010c90: 7420 6861 7665 2074 6f20 6465 616c 2077 t have to deal w │ │ │ │ │ +00010ca0: 6974 6820 6d75 6c74 6970 6c65 2063 6861 ith multiple cha │ │ │ │ │ +00010cb0: 7261 6374 6572 0a20 2020 2020 656e 636f racter. enco │ │ │ │ │ +00010cc0: 6469 6e67 732e 2020 5468 6520 666f 6e74 dings. The font │ │ │ │ │ +00010cd0: 2073 686f 756c 6420 616c 7761 7973 2075 should always u │ │ │ │ │ +00010ce0: 7365 2055 6e69 636f 6465 2063 6861 7261 se Unicode chara │ │ │ │ │ +00010cf0: 6374 6572 2063 6f64 6573 2066 6f72 0a20 cter codes for. │ │ │ │ │ +00010d00: 2020 2020 7369 6d70 6c65 2069 6e74 6572 simple inter │ │ │ │ │ +00010d10: 6e61 7469 6f6e 616c 697a 6174 696f 6e2e nationalization. │ │ │ │ │ +00010d20: 0a0a 3131 2e31 2e32 2057 6879 2041 6e6f ..11.1.2 Why Ano │ │ │ │ │ +00010d30: 7468 6572 2046 6f6e 7420 466f 726d 6174 ther Font Format │ │ │ │ │ +00010d40: 3f0a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ?.-------------- │ │ │ │ │ 00010d50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00010d60: 2d2d 2d0a 0a54 6865 7265 2061 7265 206d ---..There are m │ │ │ │ │ -00010d70: 616e 7920 6578 6973 7469 6e67 2062 6974 any existing bit │ │ │ │ │ -00010d80: 6d61 7020 666f 6e74 2066 6f72 6d61 7473 map font formats │ │ │ │ │ -00010d90: 2074 6861 7420 4752 5542 2063 6f75 6c64 that GRUB could │ │ │ │ │ -00010da0: 2075 7365 2e0a 486f 7765 7665 722c 2074 use..However, t │ │ │ │ │ -00010db0: 6865 7265 2061 7265 2061 7370 6563 7473 here are aspects │ │ │ │ │ -00010dc0: 206f 6620 7468 6573 6520 666f 726d 6174 of these format │ │ │ │ │ -00010dd0: 7320 7468 6174 206d 6179 206d 616b 6520 s that may make │ │ │ │ │ -00010de0: 7468 656d 206c 6573 7320 7468 616e 0a73 them less than.s │ │ │ │ │ -00010df0: 7569 7461 626c 6520 666f 7220 7573 6520 uitable for use │ │ │ │ │ -00010e00: 696e 2047 5255 4220 6174 2074 6869 7320 in GRUB at this │ │ │ │ │ -00010e10: 7469 6d65 3a0a 0a27 4244 4627 0a20 2020 time:..'BDF'. │ │ │ │ │ -00010e20: 2020 496e 6566 6669 6369 656e 7420 7374 Inefficient st │ │ │ │ │ -00010e30: 6f72 6167 653b 2075 7365 7320 4153 4349 orage; uses ASCI │ │ │ │ │ -00010e40: 4920 746f 2064 6573 6372 6962 6520 7072 I to describe pr │ │ │ │ │ -00010e50: 6f70 6572 7469 6573 2061 6e64 0a20 2020 operties and. │ │ │ │ │ -00010e60: 2020 6865 7861 6465 6369 6d61 6c20 6e75 hexadecimal nu │ │ │ │ │ -00010e70: 6d62 6572 7320 696e 2041 5343 4949 2066 mbers in ASCII f │ │ │ │ │ -00010e80: 6f72 2074 6865 2062 6974 6d61 7020 726f or the bitmap ro │ │ │ │ │ -00010e90: 7773 2e0a 2750 4346 270a 2020 2020 204d ws..'PCF'. M │ │ │ │ │ -00010ea0: 616e 7920 666f 726d 6174 2076 6172 6961 any format varia │ │ │ │ │ -00010eb0: 7469 6f6e 7320 7375 6368 2061 7320 6279 tions such as by │ │ │ │ │ -00010ec0: 7465 206f 7264 6572 2061 6e64 2062 6974 te order and bit │ │ │ │ │ -00010ed0: 6d61 7020 7061 6464 696e 6720 2872 6f77 map padding (row │ │ │ │ │ -00010ee0: 730a 2020 2020 2070 6164 6465 6420 746f s. padded to │ │ │ │ │ -00010ef0: 2062 7974 652c 2077 6f72 642c 2065 7463 byte, word, etc │ │ │ │ │ -00010f00: 2e29 2020 776f 756c 6420 7265 7375 6c74 .) would result │ │ │ │ │ -00010f10: 2069 6e20 6d6f 7265 2063 6f6d 706c 6578 in more complex │ │ │ │ │ -00010f20: 2063 6f64 6520 746f 0a20 2020 2020 6861 code to. ha │ │ │ │ │ -00010f30: 6e64 6c65 2074 6865 2066 6f6e 7420 666f ndle the font fo │ │ │ │ │ -00010f40: 726d 6174 2e0a 0a1f 0a46 696c 653a 2067 rmat.....File: g │ │ │ │ │ -00010f50: 7275 622d 6465 762e 696e 666f 2c20 204e rub-dev.info, N │ │ │ │ │ -00010f60: 6f64 653a 2046 696c 6520 5374 7275 6374 ode: File Struct │ │ │ │ │ -00010f70: 7572 652c 2020 4e65 7874 3a20 466f 6e74 ure, Next: Font │ │ │ │ │ -00010f80: 204d 6574 7269 6373 2c20 2050 7265 763a Metrics, Prev: │ │ │ │ │ -00010f90: 2049 6e74 726f 6475 6374 696f 6e2c 2020 Introduction, │ │ │ │ │ -00010fa0: 5570 3a20 5046 4632 2046 6f6e 7420 4669 Up: PFF2 Font Fi │ │ │ │ │ -00010fb0: 6c65 2046 6f72 6d61 740a 0a31 312e 3220 le Format..11.2 │ │ │ │ │ -00010fc0: 4669 6c65 2053 7472 7563 7475 7265 0a3d File Structure.= │ │ │ │ │ +00010d60: 2d0a 0a54 6865 7265 2061 7265 206d 616e -..There are man │ │ │ │ │ +00010d70: 7920 6578 6973 7469 6e67 2062 6974 6d61 y existing bitma │ │ │ │ │ +00010d80: 7020 666f 6e74 2066 6f72 6d61 7473 2074 p font formats t │ │ │ │ │ +00010d90: 6861 7420 4752 5542 2063 6f75 6c64 2075 hat GRUB could u │ │ │ │ │ +00010da0: 7365 2e0a 486f 7765 7665 722c 2074 6865 se..However, the │ │ │ │ │ +00010db0: 7265 2061 7265 2061 7370 6563 7473 206f re are aspects o │ │ │ │ │ +00010dc0: 6620 7468 6573 6520 666f 726d 6174 7320 f these formats │ │ │ │ │ +00010dd0: 7468 6174 206d 6179 206d 616b 6520 7468 that may make th │ │ │ │ │ +00010de0: 656d 206c 6573 7320 7468 616e 0a73 7569 em less than.sui │ │ │ │ │ +00010df0: 7461 626c 6520 666f 7220 7573 6520 696e table for use in │ │ │ │ │ +00010e00: 2047 5255 4220 6174 2074 6869 7320 7469 GRUB at this ti │ │ │ │ │ +00010e10: 6d65 3a0a 0a27 4244 4627 0a20 2020 2020 me:..'BDF'. │ │ │ │ │ +00010e20: 496e 6566 6669 6369 656e 7420 7374 6f72 Inefficient stor │ │ │ │ │ +00010e30: 6167 653b 2075 7365 7320 4153 4349 4920 age; uses ASCII │ │ │ │ │ +00010e40: 746f 2064 6573 6372 6962 6520 7072 6f70 to describe prop │ │ │ │ │ +00010e50: 6572 7469 6573 2061 6e64 0a20 2020 2020 erties and. │ │ │ │ │ +00010e60: 6865 7861 6465 6369 6d61 6c20 6e75 6d62 hexadecimal numb │ │ │ │ │ +00010e70: 6572 7320 696e 2041 5343 4949 2066 6f72 ers in ASCII for │ │ │ │ │ +00010e80: 2074 6865 2062 6974 6d61 7020 726f 7773 the bitmap rows │ │ │ │ │ +00010e90: 2e0a 2750 4346 270a 2020 2020 204d 616e ..'PCF'. Man │ │ │ │ │ +00010ea0: 7920 666f 726d 6174 2076 6172 6961 7469 y format variati │ │ │ │ │ +00010eb0: 6f6e 7320 7375 6368 2061 7320 6279 7465 ons such as byte │ │ │ │ │ +00010ec0: 206f 7264 6572 2061 6e64 2062 6974 6d61 order and bitma │ │ │ │ │ +00010ed0: 7020 7061 6464 696e 6720 2872 6f77 730a p padding (rows. │ │ │ │ │ +00010ee0: 2020 2020 2070 6164 6465 6420 746f 2062 padded to b │ │ │ │ │ +00010ef0: 7974 652c 2077 6f72 642c 2065 7463 2e29 yte, word, etc.) │ │ │ │ │ +00010f00: 2020 776f 756c 6420 7265 7375 6c74 2069 would result i │ │ │ │ │ +00010f10: 6e20 6d6f 7265 2063 6f6d 706c 6578 2063 n more complex c │ │ │ │ │ +00010f20: 6f64 6520 746f 0a20 2020 2020 6861 6e64 ode to. hand │ │ │ │ │ +00010f30: 6c65 2074 6865 2066 6f6e 7420 666f 726d le the font form │ │ │ │ │ +00010f40: 6174 2e0a 0a1f 0a46 696c 653a 2067 7275 at.....File: gru │ │ │ │ │ +00010f50: 622d 6465 762e 696e 666f 2c20 204e 6f64 b-dev.info, Nod │ │ │ │ │ +00010f60: 653a 2046 696c 6520 5374 7275 6374 7572 e: File Structur │ │ │ │ │ +00010f70: 652c 2020 4e65 7874 3a20 466f 6e74 204d e, Next: Font M │ │ │ │ │ +00010f80: 6574 7269 6373 2c20 2050 7265 763a 2049 etrics, Prev: I │ │ │ │ │ +00010f90: 6e74 726f 6475 6374 696f 6e2c 2020 5570 ntroduction, Up │ │ │ │ │ +00010fa0: 3a20 5046 4632 2046 6f6e 7420 4669 6c65 : PFF2 Font File │ │ │ │ │ +00010fb0: 2046 6f72 6d61 740a 0a31 312e 3220 4669 Format..11.2 Fi │ │ │ │ │ +00010fc0: 6c65 2053 7472 7563 7475 7265 0a3d 3d3d le Structure.=== │ │ │ │ │ 00010fd0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00010fe0: 3d3d 0a0a 4120 6669 6c65 202a 7365 6374 ==..A file *sect │ │ │ │ │ -00010ff0: 696f 6e2a 2063 6f6e 7369 7374 7320 6f66 ion* consists of │ │ │ │ │ -00011000: 2061 2034 2d62 7974 6520 6e61 6d65 2c20 a 4-byte name, │ │ │ │ │ -00011010: 6120 3332 2d62 6974 2062 6967 2d65 6e64 a 32-bit big-end │ │ │ │ │ -00011020: 6961 6e20 6c65 6e67 7468 0a28 6e6f 7420 ian length.(not │ │ │ │ │ -00011030: 696e 636c 7564 696e 6720 7468 6520 6e61 including the na │ │ │ │ │ -00011040: 6d65 206f 7220 6c65 6e67 7468 292c 2061 me or length), a │ │ │ │ │ -00011050: 6e64 2074 6865 6e20 4c45 4e47 5448 206d nd then LENGTH m │ │ │ │ │ -00011060: 6f72 650a 7365 6374 696f 6e2d 7479 7065 ore.section-type │ │ │ │ │ -00011070: 2d73 7065 6369 6669 6320 6279 7465 732e -specific bytes. │ │ │ │ │ -00011080: 0a0a 2020 2054 6865 2073 7461 6e64 6172 .. The standar │ │ │ │ │ -00011090: 6420 6669 6c65 2065 7874 656e 7369 6f6e d file extension │ │ │ │ │ -000110a0: 2066 6f72 2050 4646 3220 666f 6e74 2066 for PFF2 font f │ │ │ │ │ -000110b0: 696c 6573 2069 7320 272e 7066 3227 2e0a iles is '.pf2'.. │ │ │ │ │ -000110c0: 0a31 312e 322e 3120 5365 6374 696f 6e20 .11.2.1 Section │ │ │ │ │ -000110d0: 5479 7065 730a 2d2d 2d2d 2d2d 2d2d 2d2d Types.---------- │ │ │ │ │ -000110e0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2746 494c ----------..'FIL │ │ │ │ │ -000110f0: 4527 0a20 2020 2020 2a46 696c 6520 7479 E'. *File ty │ │ │ │ │ -00011100: 7065 2049 442a 2028 4153 4349 4920 7374 pe ID* (ASCII st │ │ │ │ │ -00011110: 7269 6e67 292e 2020 5468 6973 206d 7573 ring). This mus │ │ │ │ │ -00011120: 7420 6265 2074 6865 2066 6972 7374 2073 t be the first s │ │ │ │ │ -00011130: 6563 7469 6f6e 2069 6e0a 2020 2020 2074 ection in. t │ │ │ │ │ -00011140: 6865 2066 696c 652e 2020 4974 2068 6173 he file. It has │ │ │ │ │ -00011150: 206c 656e 6774 6820 3420 616e 6420 7468 length 4 and th │ │ │ │ │ -00011160: 6520 636f 6e74 656e 7473 2061 7265 2074 e contents are t │ │ │ │ │ -00011170: 6865 2066 6f75 7220 6279 7465 7320 6f66 he four bytes of │ │ │ │ │ -00011180: 0a20 2020 2020 7468 6520 4153 4349 4920 . the ASCII │ │ │ │ │ -00011190: 7374 7269 6e67 2027 5046 4632 272e 0a0a string 'PFF2'... │ │ │ │ │ -000111a0: 274e 414d 4527 0a20 2020 2020 2a46 6f6e 'NAME'. *Fon │ │ │ │ │ -000111b0: 7420 6e61 6d65 2a20 2841 5343 4949 2073 t name* (ASCII s │ │ │ │ │ -000111c0: 7472 696e 6729 2e20 2054 6869 7320 6973 tring). This is │ │ │ │ │ -000111d0: 2074 6865 2066 756c 6c20 666f 6e74 206e the full font n │ │ │ │ │ -000111e0: 616d 6520 696e 636c 7564 696e 670a 2020 ame including. │ │ │ │ │ -000111f0: 2020 2066 616d 696c 792c 2077 6569 6768 family, weigh │ │ │ │ │ -00011200: 742c 2073 7479 6c65 2c20 616e 6420 706f t, style, and po │ │ │ │ │ -00011210: 696e 7420 7369 7a65 2e20 2046 6f72 2069 int size. For i │ │ │ │ │ -00011220: 6e73 7461 6e63 652c 2022 4865 6c76 6574 nstance, "Helvet │ │ │ │ │ -00011230: 6963 610a 2020 2020 2042 6f6c 6420 4974 ica. Bold It │ │ │ │ │ -00011240: 616c 6963 2031 3422 2e0a 0a27 4641 4d49 alic 14"...'FAMI │ │ │ │ │ -00011250: 270a 2020 2020 202a 466f 6e74 2066 616d '. *Font fam │ │ │ │ │ -00011260: 696c 7920 6e61 6d65 2a20 2841 5343 4949 ily name* (ASCII │ │ │ │ │ -00011270: 2073 7472 696e 6729 2e20 2046 6f72 2069 string). For i │ │ │ │ │ -00011280: 6e73 7461 6e63 652c 2022 4865 6c76 6574 nstance, "Helvet │ │ │ │ │ -00011290: 6963 6122 2e0a 2020 2020 2054 6869 7320 ica".. This │ │ │ │ │ -000112a0: 7368 6f75 6c64 2062 6520 696e 636c 7564 should be includ │ │ │ │ │ -000112b0: 6564 2073 6f20 7468 6174 2069 6e74 656c ed so that intel │ │ │ │ │ -000112c0: 6c69 6765 6e74 2066 6f6e 7420 7375 6273 ligent font subs │ │ │ │ │ -000112d0: 7469 7475 7469 6f6e 2063 616e 0a20 2020 titution can. │ │ │ │ │ -000112e0: 2020 7461 6b65 2070 6c61 6365 2e0a 0a27 take place...' │ │ │ │ │ -000112f0: 5745 4947 270a 2020 2020 202a 466f 6e74 WEIG'. *Font │ │ │ │ │ -00011300: 2077 6569 6768 742a 2028 4153 4349 4920 weight* (ASCII │ │ │ │ │ -00011310: 7374 7269 6e67 292e 2020 5661 6c69 6420 string). Valid │ │ │ │ │ -00011320: 7661 6c75 6573 2061 7265 2027 626f 6c64 values are 'bold │ │ │ │ │ -00011330: 2720 616e 640a 2020 2020 2027 6e6f 726d ' and. 'norm │ │ │ │ │ -00011340: 616c 272e 2020 5468 6973 2073 686f 756c al'. This shoul │ │ │ │ │ -00011350: 6420 6265 2069 6e63 6c75 6465 6420 736f d be included so │ │ │ │ │ -00011360: 2074 6861 7420 696e 7465 6c6c 6967 656e that intelligen │ │ │ │ │ -00011370: 7420 666f 6e74 0a20 2020 2020 7375 6273 t font. subs │ │ │ │ │ -00011380: 7469 7475 7469 6f6e 2063 616e 2074 616b titution can tak │ │ │ │ │ -00011390: 6520 706c 6163 652e 0a0a 2753 4c41 4e27 e place...'SLAN' │ │ │ │ │ -000113a0: 0a20 2020 2020 2a46 6f6e 7420 736c 616e . *Font slan │ │ │ │ │ -000113b0: 742a 2028 4153 4349 4920 7374 7269 6e67 t* (ASCII string │ │ │ │ │ -000113c0: 292e 2020 5661 6c69 6420 7661 6c75 6573 ). Valid values │ │ │ │ │ -000113d0: 2061 7265 2027 6974 616c 6963 2720 616e are 'italic' an │ │ │ │ │ -000113e0: 640a 2020 2020 2027 6e6f 726d 616c 272e d. 'normal'. │ │ │ │ │ -000113f0: 2020 5468 6973 2073 686f 756c 6420 6265 This should be │ │ │ │ │ -00011400: 2069 6e63 6c75 6465 6420 736f 2074 6861 included so tha │ │ │ │ │ -00011410: 7420 696e 7465 6c6c 6967 656e 7420 666f t intelligent fo │ │ │ │ │ -00011420: 6e74 0a20 2020 2020 7375 6273 7469 7475 nt. substitu │ │ │ │ │ -00011430: 7469 6f6e 2063 616e 2074 616b 6520 706c tion can take pl │ │ │ │ │ -00011440: 6163 652e 0a0a 2750 5453 5a27 0a20 2020 ace...'PTSZ'. │ │ │ │ │ -00011450: 2020 2a46 6f6e 7420 706f 696e 7420 7369 *Font point si │ │ │ │ │ -00011460: 7a65 2a20 2875 696e 7431 3662 6529 2e0a ze* (uint16be).. │ │ │ │ │ -00011470: 0a27 4d41 5857 270a 2020 2020 202a 4d61 .'MAXW'. *Ma │ │ │ │ │ -00011480: 7869 6d75 6d20 6368 6172 6163 7465 7220 ximum character │ │ │ │ │ -00011490: 7769 6474 6820 696e 2070 6978 656c 732a width in pixels* │ │ │ │ │ -000114a0: 2028 7569 6e74 3136 6265 292e 0a0a 274d (uint16be)...'M │ │ │ │ │ -000114b0: 4158 4827 0a20 2020 2020 2a4d 6178 696d AXH'. *Maxim │ │ │ │ │ -000114c0: 756d 2063 6861 7261 6374 6572 2068 6569 um character hei │ │ │ │ │ -000114d0: 6768 7420 696e 2070 6978 656c 732a 2028 ght in pixels* ( │ │ │ │ │ -000114e0: 7569 6e74 3136 6265 292e 0a0a 2741 5343 uint16be)...'ASC │ │ │ │ │ -000114f0: 4527 0a20 2020 2020 2a41 7363 656e 7420 E'. *Ascent │ │ │ │ │ -00011500: 696e 2070 6978 656c 732a 2028 7569 6e74 in pixels* (uint │ │ │ │ │ -00011510: 3136 6265 292e 2020 2a4e 6f74 6520 466f 16be). *Note Fo │ │ │ │ │ -00011520: 6e74 204d 6574 7269 6373 3a3a 2c20 666f nt Metrics::, fo │ │ │ │ │ -00011530: 7220 6465 7461 696c 732e 0a0a 2744 4553 r details...'DES │ │ │ │ │ -00011540: 4327 0a20 2020 2020 2a44 6573 6365 6e74 C'. *Descent │ │ │ │ │ -00011550: 2069 6e20 7069 7865 6c73 2a20 2875 696e in pixels* (uin │ │ │ │ │ -00011560: 7431 3662 6529 2e20 202a 4e6f 7465 2046 t16be). *Note F │ │ │ │ │ -00011570: 6f6e 7420 4d65 7472 6963 733a 3a2c 2066 ont Metrics::, f │ │ │ │ │ -00011580: 6f72 2064 6574 6169 6c73 2e0a 0a27 4348 or details...'CH │ │ │ │ │ -00011590: 4958 270a 2020 2020 202a 4368 6172 6163 IX'. *Charac │ │ │ │ │ -000115a0: 7465 7220 696e 6465 782e 2a20 2054 6865 ter index.* The │ │ │ │ │ -000115b0: 2063 6861 7261 6374 6572 2069 6e64 6578 character index │ │ │ │ │ -000115c0: 2062 6567 696e 7320 7769 7468 2061 2033 begins with a 3 │ │ │ │ │ -000115d0: 322d 6269 740a 2020 2020 2062 6967 2d65 2-bit. big-e │ │ │ │ │ -000115e0: 6e64 6961 6e20 756e 7369 676e 6564 2069 ndian unsigned i │ │ │ │ │ -000115f0: 6e74 6567 6572 2069 6e64 6963 6174 696e nteger indicatin │ │ │ │ │ -00011600: 6720 7468 6520 746f 7461 6c20 7369 7a65 g the total size │ │ │ │ │ -00011610: 206f 6620 7468 650a 2020 2020 2073 6563 of the. sec │ │ │ │ │ -00011620: 7469 6f6e 2c20 6e6f 7420 696e 636c 7564 tion, not includ │ │ │ │ │ -00011630: 696e 6720 7468 6973 2073 697a 6520 7661 ing this size va │ │ │ │ │ -00011640: 6c75 652e 2020 466f 7220 6561 6368 2063 lue. For each c │ │ │ │ │ -00011650: 6861 7261 6374 6572 2c20 7468 6572 650a haracter, there. │ │ │ │ │ -00011660: 2020 2020 2069 7320 616e 2069 6e73 7461 is an insta │ │ │ │ │ -00011670: 6e63 6520 6f66 2074 6865 2066 6f6c 6c6f nce of the follo │ │ │ │ │ -00011680: 7769 6e67 2065 6e74 7279 2073 7472 7563 wing entry struc │ │ │ │ │ -00011690: 7475 7265 3a0a 0a20 2020 2020 2020 202a ture:.. * │ │ │ │ │ -000116a0: 202a 556e 6963 6f64 6520 636f 6465 2070 *Unicode code p │ │ │ │ │ -000116b0: 6f69 6e74 2e2a 2020 2833 322d 6269 7420 oint.* (32-bit │ │ │ │ │ -000116c0: 6269 672d 656e 6469 616e 2069 6e74 6567 big-endian integ │ │ │ │ │ -000116d0: 6572 2e29 0a0a 2020 2020 2020 2020 2a20 er.).. * │ │ │ │ │ -000116e0: 2a53 746f 7261 6765 2066 6c61 6773 2e2a *Storage flags.* │ │ │ │ │ -000116f0: 2020 2862 7974 652e 290a 0a20 2020 2020 (byte.).. │ │ │ │ │ -00011700: 2020 2020 2020 2020 2a20 4269 7473 2032 * Bits 2 │ │ │ │ │ -00011710: 2e2e 303a 0a0a 2020 2020 2020 2020 2020 ..0:.. │ │ │ │ │ -00011720: 2020 2020 2049 6620 6571 7561 6c20 746f If equal to │ │ │ │ │ -00011730: 2030 3030 2062 696e 6172 792c 2074 6865 000 binary, the │ │ │ │ │ -00011740: 6e20 7468 6520 6368 6172 6163 7465 7220 n the character │ │ │ │ │ -00011750: 6461 7461 2069 7320 7374 6f72 6564 0a20 data is stored. │ │ │ │ │ -00011760: 2020 2020 2020 2020 2020 2020 2020 756e un │ │ │ │ │ -00011770: 636f 6d70 7265 7373 6564 2062 6567 696e compressed begin │ │ │ │ │ -00011780: 6e69 6e67 2061 7420 7468 6520 6f66 6673 ning at the offs │ │ │ │ │ -00011790: 6574 2069 6e64 6963 6174 6564 2062 7920 et indicated by │ │ │ │ │ -000117a0: 7468 650a 2020 2020 2020 2020 2020 2020 the. │ │ │ │ │ -000117b0: 2020 2063 6861 7261 6374 6572 2773 202a character's * │ │ │ │ │ -000117c0: 6f66 6673 6574 2a20 7661 6c75 652e 0a0a offset* value... │ │ │ │ │ -000117d0: 2020 2020 2020 2020 2020 2020 2020 2049 I │ │ │ │ │ -000117e0: 6620 6571 7561 6c20 746f 2030 3031 2062 f equal to 001 b │ │ │ │ │ -000117f0: 696e 6172 792c 2074 6865 6e20 7468 6520 inary, then the │ │ │ │ │ -00011800: 6368 6172 6163 7465 7220 6461 7461 2069 character data i │ │ │ │ │ -00011810: 7320 7374 6f72 6564 0a20 2020 2020 2020 s stored. │ │ │ │ │ -00011820: 2020 2020 2020 2020 7769 7468 696e 2061 within a │ │ │ │ │ -00011830: 2063 6f6d 7072 6573 7365 6420 6368 6172 compressed char │ │ │ │ │ -00011840: 6163 7465 7220 6465 6669 6e69 7469 6f6e acter definition │ │ │ │ │ -00011850: 2062 6c6f 636b 2074 6861 740a 2020 2020 block that. │ │ │ │ │ -00011860: 2020 2020 2020 2020 2020 2062 6567 696e begin │ │ │ │ │ -00011870: 7320 6174 2074 6865 206f 6666 7365 7420 s at the offset │ │ │ │ │ -00011880: 7769 7468 696e 2074 6865 2066 696c 6520 within the file │ │ │ │ │ -00011890: 696e 6469 6361 7465 6420 6279 2074 6865 indicated by the │ │ │ │ │ -000118a0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ -000118b0: 6368 6172 6163 7465 7227 7320 2a6f 6666 character's *off │ │ │ │ │ -000118c0: 7365 742a 2076 616c 7565 2e0a 0a20 2020 set* value... │ │ │ │ │ -000118d0: 2020 2020 202a 202a 4f66 6673 6574 2e2a * *Offset.* │ │ │ │ │ -000118e0: 2020 2833 322d 6269 7420 6269 672d 656e (32-bit big-en │ │ │ │ │ -000118f0: 6469 616e 2069 6e74 6567 6572 2e29 0a0a dian integer.).. │ │ │ │ │ -00011900: 2020 2020 2020 2020 2020 4120 6d61 726b A mark │ │ │ │ │ -00011910: 6572 2074 6861 7420 696e 6469 6361 7465 er that indicate │ │ │ │ │ -00011920: 7320 7468 6520 7265 6d61 696e 6465 7220 s the remainder │ │ │ │ │ -00011930: 6f66 2074 6865 2066 696c 6520 6973 2064 of the file is d │ │ │ │ │ -00011940: 6174 610a 2020 2020 2020 2020 2020 6163 ata. ac │ │ │ │ │ -00011950: 6365 7373 6564 2076 6961 2074 6865 2063 cessed via the c │ │ │ │ │ -00011960: 6861 7261 6374 6572 2069 6e64 6578 2028 haracter index ( │ │ │ │ │ -00011970: 4348 4958 2920 7365 6374 696f 6e2e 2020 CHIX) section. │ │ │ │ │ -00011980: 5768 656e 2072 6561 6469 6e67 0a20 2020 When reading. │ │ │ │ │ -00011990: 2020 2020 2020 2074 6869 7320 666f 6e74 this font │ │ │ │ │ -000119a0: 2066 696c 652c 2074 6865 2072 6573 7420 file, the rest │ │ │ │ │ -000119b0: 6f66 2074 6865 2066 696c 6520 6361 6e20 of the file can │ │ │ │ │ -000119c0: 6265 2069 676e 6f72 6564 2077 6865 6e0a be ignored when. │ │ │ │ │ -000119d0: 2020 2020 2020 2020 2020 7363 616e 6e69 scanni │ │ │ │ │ -000119e0: 6e67 2074 6865 2073 6563 7469 6f6e 732e ng the sections. │ │ │ │ │ -000119f0: 2020 5468 6520 6c65 6e67 7468 2073 686f The length sho │ │ │ │ │ -00011a00: 756c 6420 6265 2073 6574 2074 6f20 2d31 uld be set to -1 │ │ │ │ │ -00011a10: 0a20 2020 2020 2020 2020 2028 3078 4646 . (0xFF │ │ │ │ │ -00011a20: 4646 4646 4646 292e 0a0a 2020 2020 2020 FFFFFF)... │ │ │ │ │ -00011a30: 2020 2020 5375 7070 6f72 7465 6420 6461 Supported da │ │ │ │ │ -00011a40: 7461 2073 7472 7563 7475 7265 733a 0a0a ta structures:.. │ │ │ │ │ -00011a50: 2020 2020 2020 2020 2020 4368 6172 6163 Charac │ │ │ │ │ -00011a60: 7465 7220 6465 6669 6e69 7469 6f6e 2045 ter definition E │ │ │ │ │ -00011a70: 6163 6820 6368 6172 6163 7465 7220 6465 ach character de │ │ │ │ │ -00011a80: 6669 6e69 7469 6f6e 2063 6f6e 7369 7374 finition consist │ │ │ │ │ -00011a90: 7320 6f66 3a0a 0a20 2020 2020 2020 2020 s of:.. │ │ │ │ │ -00011aa0: 2020 2020 2a20 2a57 6964 7468 2e2a 2020 * *Width.* │ │ │ │ │ -00011ab0: 5769 6474 6820 6f66 2074 6865 2062 6974 Width of the bit │ │ │ │ │ -00011ac0: 6d61 7020 696e 2070 6978 656c 732e 2020 map in pixels. │ │ │ │ │ -00011ad0: 5468 6520 6269 746d 6170 2773 0a20 2020 The bitmap's. │ │ │ │ │ -00011ae0: 2020 2020 2020 2020 2020 2020 6578 7465 exte │ │ │ │ │ -00011af0: 6e74 7320 7265 7072 6573 656e 7420 7468 nts represent th │ │ │ │ │ -00011b00: 6520 676c 7970 6827 7320 626f 756e 6469 e glyph's boundi │ │ │ │ │ -00011b10: 6e67 2062 6f78 2e20 2027 7569 6e74 3136 ng box. 'uint16 │ │ │ │ │ -00011b20: 6265 272e 0a0a 2020 2020 2020 2020 2020 be'... │ │ │ │ │ -00011b30: 2020 202a 202a 4865 6967 6874 2e2a 2020 * *Height.* │ │ │ │ │ -00011b40: 4865 6967 6874 206f 6620 7468 6520 6269 Height of the bi │ │ │ │ │ -00011b50: 746d 6170 2069 6e20 7069 7865 6c73 2e20 tmap in pixels. │ │ │ │ │ -00011b60: 2054 6865 2062 6974 6d61 7027 730a 2020 The bitmap's. │ │ │ │ │ -00011b70: 2020 2020 2020 2020 2020 2020 2065 7874 ext │ │ │ │ │ -00011b80: 656e 7473 2072 6570 7265 7365 6e74 2074 ents represent t │ │ │ │ │ -00011b90: 6865 2067 6c79 7068 2773 2062 6f75 6e64 he glyph's bound │ │ │ │ │ -00011ba0: 696e 6720 626f 782e 2020 2775 696e 7431 ing box. 'uint1 │ │ │ │ │ -00011bb0: 3662 6527 2e0a 0a20 2020 2020 2020 2020 6be'... │ │ │ │ │ -00011bc0: 2020 2020 2a20 2a58 206f 6666 7365 742e * *X offset. │ │ │ │ │ -00011bd0: 2a20 2054 6865 206e 756d 6265 7220 6f66 * The number of │ │ │ │ │ -00011be0: 2070 6978 656c 7320 746f 2073 6869 6674 pixels to shift │ │ │ │ │ -00011bf0: 2074 6865 2062 6974 6d61 7020 6279 0a20 the bitmap by. │ │ │ │ │ -00011c00: 2020 2020 2020 2020 2020 2020 2020 686f ho │ │ │ │ │ -00011c10: 7269 7a6f 6e74 616c 6c79 2062 6566 6f72 rizontally befor │ │ │ │ │ -00011c20: 6520 6472 6177 696e 6720 7468 6520 6368 e drawing the ch │ │ │ │ │ -00011c30: 6172 6163 7465 722e 2020 2769 6e74 3136 aracter. 'int16 │ │ │ │ │ -00011c40: 6265 272e 0a0a 2020 2020 2020 2020 2020 be'... │ │ │ │ │ -00011c50: 2020 202a 202a 5920 6f66 6673 6574 2e2a * *Y offset.* │ │ │ │ │ -00011c60: 2020 5468 6520 6e75 6d62 6572 206f 6620 The number of │ │ │ │ │ -00011c70: 7069 7865 6c73 2074 6f20 7368 6966 7420 pixels to shift │ │ │ │ │ -00011c80: 7468 6520 6269 746d 6170 2062 790a 2020 the bitmap by. │ │ │ │ │ -00011c90: 2020 2020 2020 2020 2020 2020 2076 6572 ver │ │ │ │ │ -00011ca0: 7469 6361 6c6c 7920 6265 666f 7265 2064 tically before d │ │ │ │ │ -00011cb0: 7261 7769 6e67 2074 6865 2063 6861 7261 rawing the chara │ │ │ │ │ -00011cc0: 6374 6572 2e20 2027 696e 7431 3662 6527 cter. 'int16be' │ │ │ │ │ -00011cd0: 2e0a 0a20 2020 2020 2020 2020 2020 2020 ... │ │ │ │ │ -00011ce0: 2a20 2a44 6576 6963 6520 7769 6474 682e * *Device width. │ │ │ │ │ -00011cf0: 2a20 2054 6865 206e 756d 6265 7220 6f66 * The number of │ │ │ │ │ -00011d00: 2070 6978 656c 7320 746f 2061 6476 616e pixels to advan │ │ │ │ │ -00011d10: 6365 0a20 2020 2020 2020 2020 2020 2020 ce. │ │ │ │ │ -00011d20: 2020 686f 7269 7a6f 6e74 616c 6c79 2066 horizontally f │ │ │ │ │ -00011d30: 726f 6d20 7468 6973 2063 6861 7261 6374 rom this charact │ │ │ │ │ -00011d40: 6572 2773 206f 7269 6769 6e20 746f 2074 er's origin to t │ │ │ │ │ -00011d50: 6865 206f 7269 6769 6e0a 2020 2020 2020 he origin. │ │ │ │ │ -00011d60: 2020 2020 2020 2020 206f 6620 7468 6520 of the │ │ │ │ │ -00011d70: 6e65 7874 2063 6861 7261 6374 6572 2e20 next character. │ │ │ │ │ -00011d80: 2027 696e 7431 3662 6527 2e0a 0a20 2020 'int16be'... │ │ │ │ │ -00011d90: 2020 2020 2020 2020 2020 2a20 2a42 6974 * *Bit │ │ │ │ │ -00011da0: 6d61 7020 6461 7461 2e2a 2020 5468 6973 map data.* This │ │ │ │ │ -00011db0: 2069 7320 656e 636f 6465 6420 6173 2061 is encoded as a │ │ │ │ │ -00011dc0: 2073 7472 696e 6720 6f66 2062 6974 732e string of bits. │ │ │ │ │ -00011dd0: 2020 4974 0a20 2020 2020 2020 2020 2020 It. │ │ │ │ │ -00011de0: 2020 2020 6973 206f 7267 616e 697a 6564 is organized │ │ │ │ │ -00011df0: 2061 7320 6120 726f 772d 6d61 6a6f 722c as a row-major, │ │ │ │ │ -00011e00: 2074 6f70 2d64 6f77 6e2c 206c 6566 742d top-down, left- │ │ │ │ │ -00011e10: 746f 2d72 6967 6874 0a20 2020 2020 2020 to-right. │ │ │ │ │ -00011e20: 2020 2020 2020 2020 6269 746d 6170 2e20 bitmap. │ │ │ │ │ -00011e30: 2054 6865 206d 6f73 7420 7369 676e 6966 The most signif │ │ │ │ │ -00011e40: 6963 616e 7420 6269 7420 6f66 2065 6163 icant bit of eac │ │ │ │ │ -00011e50: 6820 6279 7465 2069 7320 7461 6b65 6e0a h byte is taken. │ │ │ │ │ -00011e60: 2020 2020 2020 2020 2020 2020 2020 2074 t │ │ │ │ │ -00011e70: 6f20 6265 2074 6865 206c 6566 746d 6f73 o be the leftmos │ │ │ │ │ -00011e80: 7420 6f72 2075 7070 6572 6d6f 7374 2062 t or uppermost b │ │ │ │ │ -00011e90: 6974 2069 6e20 7468 6520 6279 7465 2e20 it in the byte. │ │ │ │ │ -00011ea0: 2046 6f72 2074 6865 0a20 2020 2020 2020 For the. │ │ │ │ │ -00011eb0: 2020 2020 2020 2020 7361 6b65 206f 6620 sake of │ │ │ │ │ -00011ec0: 636f 6d70 6163 7420 7374 6f72 6167 652c compact storage, │ │ │ │ │ -00011ed0: 2072 6f77 7320 6172 6520 6e6f 7420 7061 rows are not pa │ │ │ │ │ -00011ee0: 6464 6564 2074 6f20 6279 7465 0a20 2020 dded to byte. │ │ │ │ │ -00011ef0: 2020 2020 2020 2020 2020 2020 626f 756e boun │ │ │ │ │ -00011f00: 6461 7269 6573 2028 692e 652e 2c20 6120 daries (i.e., a │ │ │ │ │ -00011f10: 7369 6e67 6c65 2062 7974 6520 6d61 7920 single byte may │ │ │ │ │ -00011f20: 636f 6e74 6169 6e20 6269 7473 0a20 2020 contain bits. │ │ │ │ │ -00011f30: 2020 2020 2020 2020 2020 2020 6265 6c6f belo │ │ │ │ │ -00011f40: 6e67 696e 6720 746f 206d 756c 7469 706c nging to multipl │ │ │ │ │ -00011f50: 6520 726f 7773 292e 2020 5468 6520 6c61 e rows). The la │ │ │ │ │ -00011f60: 7374 2062 7974 6520 6f66 2074 6865 2062 st byte of the b │ │ │ │ │ -00011f70: 6974 6d61 700a 2020 2020 2020 2020 2020 itmap. │ │ │ │ │ -00011f80: 2020 2020 202a 6973 2a20 7061 6464 6564 *is* padded │ │ │ │ │ -00011f90: 2077 6974 6820 7a65 726f 2062 6974 7320 with zero bits │ │ │ │ │ -00011fa0: 696e 2074 6865 2062 6974 7320 706f 7369 in the bits posi │ │ │ │ │ -00011fb0: 7469 6f6e 7320 746f 2074 6865 0a20 2020 tions to the. │ │ │ │ │ -00011fc0: 2020 2020 2020 2020 2020 2020 7269 6768 righ │ │ │ │ │ -00011fd0: 7420 6f66 2074 6865 206c 6173 7420 7573 t of the last us │ │ │ │ │ -00011fe0: 6564 2062 6974 2069 6620 7468 6520 6269 ed bit if the bi │ │ │ │ │ -00011ff0: 746d 6170 2064 6174 6120 646f 6573 206e tmap data does n │ │ │ │ │ -00012000: 6f74 0a20 2020 2020 2020 2020 2020 2020 ot. │ │ │ │ │ -00012010: 2020 6669 6c6c 2074 6865 206c 6173 7420 fill the last │ │ │ │ │ -00012020: 6279 7465 2e0a 0a20 2020 2020 2020 2020 byte... │ │ │ │ │ -00012030: 2020 2020 2020 5468 6520 6c65 6e67 7468 The length │ │ │ │ │ -00012040: 206f 6620 7468 6520 2a62 6974 6d61 7020 of the *bitmap │ │ │ │ │ -00012050: 6461 7461 2a20 6669 656c 6420 6973 2028 data* field is ( │ │ │ │ │ -00012060: 5749 4454 4820 2a20 4845 4947 4854 0a20 WIDTH * HEIGHT. │ │ │ │ │ -00012070: 2020 2020 2020 2020 2020 2020 2020 2b20 + │ │ │ │ │ -00012080: 3729 202f 2038 2075 7369 6e67 2069 6e74 7) / 8 using int │ │ │ │ │ -00012090: 6567 6572 2061 7269 7468 6d65 7469 632c eger arithmetic, │ │ │ │ │ -000120a0: 2077 6869 6368 2069 7320 6571 7569 7661 which is equiva │ │ │ │ │ -000120b0: 6c65 6e74 2074 6f0a 2020 2020 2020 2020 lent to. │ │ │ │ │ -000120c0: 2020 2020 2020 2063 6569 6c28 5749 4454 ceil(WIDT │ │ │ │ │ -000120d0: 4820 2a20 4845 4947 4854 202f 2038 2920 H * HEIGHT / 8) │ │ │ │ │ -000120e0: 7573 696e 6720 7265 616c 206e 756d 6265 using real numbe │ │ │ │ │ -000120f0: 7220 6172 6974 686d 6574 6963 2e0a 0a20 r arithmetic... │ │ │ │ │ -00012100: 2020 2020 2020 2020 2020 2020 2020 4974 It │ │ │ │ │ -00012110: 2072 656d 6169 6e73 2074 6f20 6265 2064 remains to be d │ │ │ │ │ -00012120: 6574 6572 6d69 6e65 6420 7768 6574 6865 etermined whethe │ │ │ │ │ -00012130: 7220 6269 746d 6170 2066 6f6e 7473 2075 r bitmap fonts u │ │ │ │ │ -00012140: 7375 616c 6c79 0a20 2020 2020 2020 2020 sually. │ │ │ │ │ -00012150: 2020 2020 2020 6d61 6b65 2061 6c6c 2067 make all g │ │ │ │ │ -00012160: 6c79 7068 2062 6974 6d61 7073 2074 6865 lyph bitmaps the │ │ │ │ │ -00012170: 2073 616d 6520 6865 6967 6874 2c20 6f72 same height, or │ │ │ │ │ -00012180: 2069 6620 736d 616c 6c65 720a 2020 2020 if smaller. │ │ │ │ │ -00012190: 2020 2020 2020 2020 2020 2067 6c79 7068 glyph │ │ │ │ │ -000121a0: 7320 6172 6520 7374 6f72 6564 2077 6974 s are stored wit │ │ │ │ │ -000121b0: 6820 6269 746d 6170 7320 6861 7669 6e67 h bitmaps having │ │ │ │ │ -000121c0: 2061 206c 6573 7365 7220 6865 6967 6874 a lesser height │ │ │ │ │ -000121d0: 2e0a 2020 2020 2020 2020 2020 2020 2020 .. │ │ │ │ │ -000121e0: 2049 6e20 7468 6520 6c61 7474 6572 2063 In the latter c │ │ │ │ │ -000121f0: 6173 652c 2074 6865 2062 6173 656c 696e ase, the baselin │ │ │ │ │ -00012200: 6520 776f 756c 6420 6861 7665 2074 6f20 e would have to │ │ │ │ │ -00012210: 6265 2075 7365 6420 746f 0a20 2020 2020 be used to. │ │ │ │ │ -00012220: 2020 2020 2020 2020 2020 6361 6c63 756c calcul │ │ │ │ │ -00012230: 6174 6520 7468 6520 6c6f 6361 7469 6f6e ate the location │ │ │ │ │ -00012240: 2074 6865 2062 6974 6d61 7020 7368 6f75 the bitmap shou │ │ │ │ │ -00012250: 6c64 2062 6520 616e 6368 6f72 6564 2061 ld be anchored a │ │ │ │ │ -00012260: 740a 2020 2020 2020 2020 2020 2020 2020 t. │ │ │ │ │ -00012270: 206f 6e20 7363 7265 656e 2e0a 0a1f 0a46 on screen.....F │ │ │ │ │ -00012280: 696c 653a 2067 7275 622d 6465 762e 696e ile: grub-dev.in │ │ │ │ │ -00012290: 666f 2c20 204e 6f64 653a 2046 6f6e 7420 fo, Node: Font │ │ │ │ │ -000122a0: 4d65 7472 6963 732c 2020 5072 6576 3a20 Metrics, Prev: │ │ │ │ │ -000122b0: 4669 6c65 2053 7472 7563 7475 7265 2c20 File Structure, │ │ │ │ │ -000122c0: 2055 703a 2050 4646 3220 466f 6e74 2046 Up: PFF2 Font F │ │ │ │ │ -000122d0: 696c 6520 466f 726d 6174 0a0a 3131 2e33 ile Format..11.3 │ │ │ │ │ -000122e0: 2046 6f6e 7420 4d65 7472 6963 730a 3d3d Font Metrics.== │ │ │ │ │ -000122f0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a ===============. │ │ │ │ │ -00012300: 0a20 2020 2a20 4173 6365 6e74 2e20 2054 . * Ascent. T │ │ │ │ │ -00012310: 6865 2064 6973 7461 6e63 6520 6672 6f6d he distance from │ │ │ │ │ -00012320: 2074 6865 2062 6173 656c 696e 6520 746f the baseline to │ │ │ │ │ -00012330: 2074 6865 2074 6f70 206f 6620 6d6f 7374 the top of most │ │ │ │ │ -00012340: 0a20 2020 2020 6368 6172 6163 7465 7273 . characters │ │ │ │ │ -00012350: 2e20 204e 6f74 6520 7468 6174 2069 6e20 . Note that in │ │ │ │ │ -00012360: 736f 6d65 2063 6173 6573 2063 6861 7261 some cases chara │ │ │ │ │ -00012370: 6374 6572 7320 6d61 7920 6578 7465 6e64 cters may extend │ │ │ │ │ -00012380: 2061 626f 7665 0a20 2020 2020 7468 6520 above. the │ │ │ │ │ -00012390: 6173 6365 6e74 2e0a 0a20 2020 2a20 4465 ascent... * De │ │ │ │ │ -000123a0: 7363 656e 742e 2020 5468 6520 6469 7374 scent. The dist │ │ │ │ │ -000123b0: 616e 6365 2066 726f 6d20 7468 6520 6261 ance from the ba │ │ │ │ │ -000123c0: 7365 6c69 6e65 2074 6f20 7468 6520 626f seline to the bo │ │ │ │ │ -000123d0: 7474 6f6d 206f 6620 6d6f 7374 0a20 2020 ttom of most. │ │ │ │ │ -000123e0: 2020 6368 6172 6163 7465 7273 2e20 204e characters. N │ │ │ │ │ -000123f0: 6f74 6520 7468 6174 2069 6e20 736f 6d65 ote that in some │ │ │ │ │ -00012400: 2063 6173 6573 2063 6861 7261 6374 6572 cases character │ │ │ │ │ -00012410: 7320 6d61 7920 6578 7465 6e64 2062 656c s may extend bel │ │ │ │ │ -00012420: 6f77 0a20 2020 2020 7468 6520 6465 7363 ow. the desc │ │ │ │ │ -00012430: 656e 742e 0a0a 2020 202a 204c 6561 6469 ent... * Leadi │ │ │ │ │ -00012440: 6e67 2e20 2054 6865 2061 6d6f 756e 7420 ng. The amount │ │ │ │ │ -00012450: 6f66 2073 7061 6365 2c20 696e 2070 6978 of space, in pix │ │ │ │ │ -00012460: 656c 732c 2074 6f20 6c65 6176 6520 6265 els, to leave be │ │ │ │ │ -00012470: 7477 6565 6e20 7468 650a 2020 2020 2064 tween the. d │ │ │ │ │ -00012480: 6573 6365 6e74 206f 6620 6f6e 6520 6c69 escent of one li │ │ │ │ │ -00012490: 6e65 206f 6620 7465 7874 2061 6e64 2074 ne of text and t │ │ │ │ │ -000124a0: 6865 2061 7363 656e 7420 6f66 2074 6865 he ascent of the │ │ │ │ │ -000124b0: 206e 6578 7420 6c69 6e65 2e20 2054 6869 next line. Thi │ │ │ │ │ -000124c0: 730a 2020 2020 206d 6574 7269 6373 2069 s. metrics i │ │ │ │ │ -000124d0: 7320 6e6f 7420 7370 6563 6966 6965 6420 s not specified │ │ │ │ │ -000124e0: 696e 2074 6865 2063 7572 7265 6e74 2066 in the current f │ │ │ │ │ -000124f0: 696c 6520 666f 726d 6174 3b20 696e 7374 ile format; inst │ │ │ │ │ -00012500: 6561 642c 2074 6865 0a20 2020 2020 666f ead, the. fo │ │ │ │ │ -00012510: 6e74 2072 656e 6465 7269 6e67 2065 6e67 nt rendering eng │ │ │ │ │ -00012520: 696e 6520 6361 6c63 756c 6174 6573 2061 ine calculates a │ │ │ │ │ -00012530: 2072 6561 736f 6e61 626c 6520 6c65 6164 reasonable lead │ │ │ │ │ -00012540: 696e 6720 7661 6c75 6520 6261 7365 640a ing value based. │ │ │ │ │ -00012550: 2020 2020 206f 6e20 7468 6520 6f74 6865 on the othe │ │ │ │ │ -00012560: 7220 666f 6e74 206d 6574 7269 6373 2e0a r font metrics.. │ │ │ │ │ -00012570: 0a20 2020 2a20 486f 7269 7a6f 6e61 6c20 . * Horizonal │ │ │ │ │ -00012580: 6c65 6164 696e 672e 2020 5468 6520 616d leading. The am │ │ │ │ │ -00012590: 6f75 6e74 206f 6620 7370 6163 652c 2069 ount of space, i │ │ │ │ │ -000125a0: 6e20 7069 7865 6c73 2c20 746f 206c 6561 n pixels, to lea │ │ │ │ │ -000125b0: 7665 0a20 2020 2020 686f 7269 7a6f 6e74 ve. horizont │ │ │ │ │ -000125c0: 616c 6c79 2062 6574 7765 656e 2074 6865 ally between the │ │ │ │ │ -000125d0: 206c 6566 7420 616e 6420 7269 6768 7420 left and right │ │ │ │ │ -000125e0: 6564 6765 7320 6f66 2074 776f 2061 646a edges of two adj │ │ │ │ │ -000125f0: 6163 656e 740a 2020 2020 2067 6c79 7068 acent. glyph │ │ │ │ │ -00012600: 732e 2020 5468 6520 2a64 6576 6963 6520 s. The *device │ │ │ │ │ -00012610: 7769 6474 682a 2066 6965 6c64 2064 6574 width* field det │ │ │ │ │ -00012620: 6572 6d69 6e65 7320 7468 6520 6566 6665 ermines the effe │ │ │ │ │ -00012630: 6374 6976 6520 6c65 6164 696e 670a 2020 ctive leading. │ │ │ │ │ -00012640: 2020 2076 616c 7565 2074 6861 7420 6973 value that is │ │ │ │ │ -00012650: 2075 7365 6420 746f 2072 656e 6465 7220 used to render │ │ │ │ │ -00012660: 7468 6520 666f 6e74 2e0a 0a00 085b 696d the font.....[im │ │ │ │ │ -00012670: 6167 6520 7372 633d 2266 6f6e 745f 6368 age src="font_ch │ │ │ │ │ -00012680: 6172 5f6d 6574 7269 6373 2e70 6e67 2220 ar_metrics.png" │ │ │ │ │ -00012690: 7465 7874 3d22 506c 6561 7365 2066 696c text="Please fil │ │ │ │ │ -000126a0: 6c20 7468 6973 2069 6e2e 2200 085d 0a0a l this in."..].. │ │ │ │ │ -000126b0: 0a20 2020 416e 2069 6c6c 7573 7472 6174 . An illustrat │ │ │ │ │ -000126c0: 696f 6e20 6f66 2068 6f77 2074 6865 2076 ion of how the v │ │ │ │ │ -000126d0: 6172 696f 7573 2066 6f6e 7420 6d65 7472 arious font metr │ │ │ │ │ -000126e0: 6963 7320 6170 706c 7920 746f 2063 6861 ics apply to cha │ │ │ │ │ -000126f0: 7261 6374 6572 732e 0a0a 1f0a 4669 6c65 racters.....File │ │ │ │ │ -00012700: 3a20 6772 7562 2d64 6576 2e69 6e66 6f2c : grub-dev.info, │ │ │ │ │ -00012710: 2020 4e6f 6465 3a20 4772 6170 6869 6361 Node: Graphica │ │ │ │ │ -00012720: 6c20 4d65 6e75 2053 6f66 7477 6172 6520 l Menu Software │ │ │ │ │ -00012730: 4465 7369 676e 2c20 204e 6578 743a 2056 Design, Next: V │ │ │ │ │ -00012740: 6572 6966 6965 7273 2066 7261 6d65 776f erifiers framewo │ │ │ │ │ -00012750: 726b 2c20 2050 7265 763a 2050 4646 3220 rk, Prev: PFF2 │ │ │ │ │ -00012760: 466f 6e74 2046 696c 6520 466f 726d 6174 Font File Format │ │ │ │ │ -00012770: 2c20 2055 703a 2054 6f70 0a0a 3132 2047 , Up: Top..12 G │ │ │ │ │ -00012780: 7261 7068 6963 616c 204d 656e 7520 536f raphical Menu So │ │ │ │ │ -00012790: 6674 7761 7265 2044 6573 6967 6e0a 2a2a ftware Design.** │ │ │ │ │ +00010fe0: 0a0a 4120 6669 6c65 202a 7365 6374 696f ..A file *sectio │ │ │ │ │ +00010ff0: 6e2a 2063 6f6e 7369 7374 7320 6f66 2061 n* consists of a │ │ │ │ │ +00011000: 2034 2d62 7974 6520 6e61 6d65 2c20 6120 4-byte name, a │ │ │ │ │ +00011010: 3332 2d62 6974 2062 6967 2d65 6e64 6961 32-bit big-endia │ │ │ │ │ +00011020: 6e20 6c65 6e67 7468 0a28 6e6f 7420 696e n length.(not in │ │ │ │ │ +00011030: 636c 7564 696e 6720 7468 6520 6e61 6d65 cluding the name │ │ │ │ │ +00011040: 206f 7220 6c65 6e67 7468 292c 2061 6e64 or length), and │ │ │ │ │ +00011050: 2074 6865 6e20 4c45 4e47 5448 206d 6f72 then LENGTH mor │ │ │ │ │ +00011060: 650a 7365 6374 696f 6e2d 7479 7065 2d73 e.section-type-s │ │ │ │ │ +00011070: 7065 6369 6669 6320 6279 7465 732e 0a0a pecific bytes... │ │ │ │ │ +00011080: 2020 2054 6865 2073 7461 6e64 6172 6420 The standard │ │ │ │ │ +00011090: 6669 6c65 2065 7874 656e 7369 6f6e 2066 file extension f │ │ │ │ │ +000110a0: 6f72 2050 4646 3220 666f 6e74 2066 696c or PFF2 font fil │ │ │ │ │ +000110b0: 6573 2069 7320 272e 7066 3227 2e0a 0a31 es is '.pf2'...1 │ │ │ │ │ +000110c0: 312e 322e 3120 5365 6374 696f 6e20 5479 1.2.1 Section Ty │ │ │ │ │ +000110d0: 7065 730a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d pes.------------ │ │ │ │ │ +000110e0: 2d2d 2d2d 2d2d 2d2d 0a0a 2746 494c 4527 --------..'FILE' │ │ │ │ │ +000110f0: 0a20 2020 2020 2a46 696c 6520 7479 7065 . *File type │ │ │ │ │ +00011100: 2049 442a 2028 4153 4349 4920 7374 7269 ID* (ASCII stri │ │ │ │ │ +00011110: 6e67 292e 2020 5468 6973 206d 7573 7420 ng). This must │ │ │ │ │ +00011120: 6265 2074 6865 2066 6972 7374 2073 6563 be the first sec │ │ │ │ │ +00011130: 7469 6f6e 2069 6e0a 2020 2020 2074 6865 tion in. the │ │ │ │ │ +00011140: 2066 696c 652e 2020 4974 2068 6173 206c file. It has l │ │ │ │ │ +00011150: 656e 6774 6820 3420 616e 6420 7468 6520 ength 4 and the │ │ │ │ │ +00011160: 636f 6e74 656e 7473 2061 7265 2074 6865 contents are the │ │ │ │ │ +00011170: 2066 6f75 7220 6279 7465 7320 6f66 0a20 four bytes of. │ │ │ │ │ +00011180: 2020 2020 7468 6520 4153 4349 4920 7374 the ASCII st │ │ │ │ │ +00011190: 7269 6e67 2027 5046 4632 272e 0a0a 274e ring 'PFF2'...'N │ │ │ │ │ +000111a0: 414d 4527 0a20 2020 2020 2a46 6f6e 7420 AME'. *Font │ │ │ │ │ +000111b0: 6e61 6d65 2a20 2841 5343 4949 2073 7472 name* (ASCII str │ │ │ │ │ +000111c0: 696e 6729 2e20 2054 6869 7320 6973 2074 ing). This is t │ │ │ │ │ +000111d0: 6865 2066 756c 6c20 666f 6e74 206e 616d he full font nam │ │ │ │ │ +000111e0: 6520 696e 636c 7564 696e 670a 2020 2020 e including. │ │ │ │ │ +000111f0: 2066 616d 696c 792c 2077 6569 6768 742c family, weight, │ │ │ │ │ +00011200: 2073 7479 6c65 2c20 616e 6420 706f 696e style, and poin │ │ │ │ │ +00011210: 7420 7369 7a65 2e20 2046 6f72 2069 6e73 t size. For ins │ │ │ │ │ +00011220: 7461 6e63 652c 2022 4865 6c76 6574 6963 tance, "Helvetic │ │ │ │ │ +00011230: 610a 2020 2020 2042 6f6c 6420 4974 616c a. Bold Ital │ │ │ │ │ +00011240: 6963 2031 3422 2e0a 0a27 4641 4d49 270a ic 14"...'FAMI'. │ │ │ │ │ +00011250: 2020 2020 202a 466f 6e74 2066 616d 696c *Font famil │ │ │ │ │ +00011260: 7920 6e61 6d65 2a20 2841 5343 4949 2073 y name* (ASCII s │ │ │ │ │ +00011270: 7472 696e 6729 2e20 2046 6f72 2069 6e73 tring). For ins │ │ │ │ │ +00011280: 7461 6e63 652c 2022 4865 6c76 6574 6963 tance, "Helvetic │ │ │ │ │ +00011290: 6122 2e0a 2020 2020 2054 6869 7320 7368 a".. This sh │ │ │ │ │ +000112a0: 6f75 6c64 2062 6520 696e 636c 7564 6564 ould be included │ │ │ │ │ +000112b0: 2073 6f20 7468 6174 2069 6e74 656c 6c69 so that intelli │ │ │ │ │ +000112c0: 6765 6e74 2066 6f6e 7420 7375 6273 7469 gent font substi │ │ │ │ │ +000112d0: 7475 7469 6f6e 2063 616e 0a20 2020 2020 tution can. │ │ │ │ │ +000112e0: 7461 6b65 2070 6c61 6365 2e0a 0a27 5745 take place...'WE │ │ │ │ │ +000112f0: 4947 270a 2020 2020 202a 466f 6e74 2077 IG'. *Font w │ │ │ │ │ +00011300: 6569 6768 742a 2028 4153 4349 4920 7374 eight* (ASCII st │ │ │ │ │ +00011310: 7269 6e67 292e 2020 5661 6c69 6420 7661 ring). Valid va │ │ │ │ │ +00011320: 6c75 6573 2061 7265 2027 626f 6c64 2720 lues are 'bold' │ │ │ │ │ +00011330: 616e 640a 2020 2020 2027 6e6f 726d 616c and. 'normal │ │ │ │ │ +00011340: 272e 2020 5468 6973 2073 686f 756c 6420 '. This should │ │ │ │ │ +00011350: 6265 2069 6e63 6c75 6465 6420 736f 2074 be included so t │ │ │ │ │ +00011360: 6861 7420 696e 7465 6c6c 6967 656e 7420 hat intelligent │ │ │ │ │ +00011370: 666f 6e74 0a20 2020 2020 7375 6273 7469 font. substi │ │ │ │ │ +00011380: 7475 7469 6f6e 2063 616e 2074 616b 6520 tution can take │ │ │ │ │ +00011390: 706c 6163 652e 0a0a 2753 4c41 4e27 0a20 place...'SLAN'. │ │ │ │ │ +000113a0: 2020 2020 2a46 6f6e 7420 736c 616e 742a *Font slant* │ │ │ │ │ +000113b0: 2028 4153 4349 4920 7374 7269 6e67 292e (ASCII string). │ │ │ │ │ +000113c0: 2020 5661 6c69 6420 7661 6c75 6573 2061 Valid values a │ │ │ │ │ +000113d0: 7265 2027 6974 616c 6963 2720 616e 640a re 'italic' and. │ │ │ │ │ +000113e0: 2020 2020 2027 6e6f 726d 616c 272e 2020 'normal'. │ │ │ │ │ +000113f0: 5468 6973 2073 686f 756c 6420 6265 2069 This should be i │ │ │ │ │ +00011400: 6e63 6c75 6465 6420 736f 2074 6861 7420 ncluded so that │ │ │ │ │ +00011410: 696e 7465 6c6c 6967 656e 7420 666f 6e74 intelligent font │ │ │ │ │ +00011420: 0a20 2020 2020 7375 6273 7469 7475 7469 . substituti │ │ │ │ │ +00011430: 6f6e 2063 616e 2074 616b 6520 706c 6163 on can take plac │ │ │ │ │ +00011440: 652e 0a0a 2750 5453 5a27 0a20 2020 2020 e...'PTSZ'. │ │ │ │ │ +00011450: 2a46 6f6e 7420 706f 696e 7420 7369 7a65 *Font point size │ │ │ │ │ +00011460: 2a20 2875 696e 7431 3662 6529 2e0a 0a27 * (uint16be)...' │ │ │ │ │ +00011470: 4d41 5857 270a 2020 2020 202a 4d61 7869 MAXW'. *Maxi │ │ │ │ │ +00011480: 6d75 6d20 6368 6172 6163 7465 7220 7769 mum character wi │ │ │ │ │ +00011490: 6474 6820 696e 2070 6978 656c 732a 2028 dth in pixels* ( │ │ │ │ │ +000114a0: 7569 6e74 3136 6265 292e 0a0a 274d 4158 uint16be)...'MAX │ │ │ │ │ +000114b0: 4827 0a20 2020 2020 2a4d 6178 696d 756d H'. *Maximum │ │ │ │ │ +000114c0: 2063 6861 7261 6374 6572 2068 6569 6768 character heigh │ │ │ │ │ +000114d0: 7420 696e 2070 6978 656c 732a 2028 7569 t in pixels* (ui │ │ │ │ │ +000114e0: 6e74 3136 6265 292e 0a0a 2741 5343 4527 nt16be)...'ASCE' │ │ │ │ │ +000114f0: 0a20 2020 2020 2a41 7363 656e 7420 696e . *Ascent in │ │ │ │ │ +00011500: 2070 6978 656c 732a 2028 7569 6e74 3136 pixels* (uint16 │ │ │ │ │ +00011510: 6265 292e 2020 2a4e 6f74 6520 466f 6e74 be). *Note Font │ │ │ │ │ +00011520: 204d 6574 7269 6373 3a3a 2c20 666f 7220 Metrics::, for │ │ │ │ │ +00011530: 6465 7461 696c 732e 0a0a 2744 4553 4327 details...'DESC' │ │ │ │ │ +00011540: 0a20 2020 2020 2a44 6573 6365 6e74 2069 . *Descent i │ │ │ │ │ +00011550: 6e20 7069 7865 6c73 2a20 2875 696e 7431 n pixels* (uint1 │ │ │ │ │ +00011560: 3662 6529 2e20 202a 4e6f 7465 2046 6f6e 6be). *Note Fon │ │ │ │ │ +00011570: 7420 4d65 7472 6963 733a 3a2c 2066 6f72 t Metrics::, for │ │ │ │ │ +00011580: 2064 6574 6169 6c73 2e0a 0a27 4348 4958 details...'CHIX │ │ │ │ │ +00011590: 270a 2020 2020 202a 4368 6172 6163 7465 '. *Characte │ │ │ │ │ +000115a0: 7220 696e 6465 782e 2a20 2054 6865 2063 r index.* The c │ │ │ │ │ +000115b0: 6861 7261 6374 6572 2069 6e64 6578 2062 haracter index b │ │ │ │ │ +000115c0: 6567 696e 7320 7769 7468 2061 2033 322d egins with a 32- │ │ │ │ │ +000115d0: 6269 740a 2020 2020 2062 6967 2d65 6e64 bit. big-end │ │ │ │ │ +000115e0: 6961 6e20 756e 7369 676e 6564 2069 6e74 ian unsigned int │ │ │ │ │ +000115f0: 6567 6572 2069 6e64 6963 6174 696e 6720 eger indicating │ │ │ │ │ +00011600: 7468 6520 746f 7461 6c20 7369 7a65 206f the total size o │ │ │ │ │ +00011610: 6620 7468 650a 2020 2020 2073 6563 7469 f the. secti │ │ │ │ │ +00011620: 6f6e 2c20 6e6f 7420 696e 636c 7564 696e on, not includin │ │ │ │ │ +00011630: 6720 7468 6973 2073 697a 6520 7661 6c75 g this size valu │ │ │ │ │ +00011640: 652e 2020 466f 7220 6561 6368 2063 6861 e. For each cha │ │ │ │ │ +00011650: 7261 6374 6572 2c20 7468 6572 650a 2020 racter, there. │ │ │ │ │ +00011660: 2020 2069 7320 616e 2069 6e73 7461 6e63 is an instanc │ │ │ │ │ +00011670: 6520 6f66 2074 6865 2066 6f6c 6c6f 7769 e of the followi │ │ │ │ │ +00011680: 6e67 2065 6e74 7279 2073 7472 7563 7475 ng entry structu │ │ │ │ │ +00011690: 7265 3a0a 0a20 2020 2020 2020 202a 202a re:.. * * │ │ │ │ │ +000116a0: 556e 6963 6f64 6520 636f 6465 2070 6f69 Unicode code poi │ │ │ │ │ +000116b0: 6e74 2e2a 2020 2833 322d 6269 7420 6269 nt.* (32-bit bi │ │ │ │ │ +000116c0: 672d 656e 6469 616e 2069 6e74 6567 6572 g-endian integer │ │ │ │ │ +000116d0: 2e29 0a0a 2020 2020 2020 2020 2a20 2a53 .).. * *S │ │ │ │ │ +000116e0: 746f 7261 6765 2066 6c61 6773 2e2a 2020 torage flags.* │ │ │ │ │ +000116f0: 2862 7974 652e 290a 0a20 2020 2020 2020 (byte.).. │ │ │ │ │ +00011700: 2020 2020 2020 2a20 4269 7473 2032 2e2e * Bits 2.. │ │ │ │ │ +00011710: 303a 0a0a 2020 2020 2020 2020 2020 2020 0:.. │ │ │ │ │ +00011720: 2020 2049 6620 6571 7561 6c20 746f 2030 If equal to 0 │ │ │ │ │ +00011730: 3030 2062 696e 6172 792c 2074 6865 6e20 00 binary, then │ │ │ │ │ +00011740: 7468 6520 6368 6172 6163 7465 7220 6461 the character da │ │ │ │ │ +00011750: 7461 2069 7320 7374 6f72 6564 0a20 2020 ta is stored. │ │ │ │ │ +00011760: 2020 2020 2020 2020 2020 2020 756e 636f unco │ │ │ │ │ +00011770: 6d70 7265 7373 6564 2062 6567 696e 6e69 mpressed beginni │ │ │ │ │ +00011780: 6e67 2061 7420 7468 6520 6f66 6673 6574 ng at the offset │ │ │ │ │ +00011790: 2069 6e64 6963 6174 6564 2062 7920 7468 indicated by th │ │ │ │ │ +000117a0: 650a 2020 2020 2020 2020 2020 2020 2020 e. │ │ │ │ │ +000117b0: 2063 6861 7261 6374 6572 2773 202a 6f66 character's *of │ │ │ │ │ +000117c0: 6673 6574 2a20 7661 6c75 652e 0a0a 2020 fset* value... │ │ │ │ │ +000117d0: 2020 2020 2020 2020 2020 2020 2049 6620 If │ │ │ │ │ +000117e0: 6571 7561 6c20 746f 2030 3031 2062 696e equal to 001 bin │ │ │ │ │ +000117f0: 6172 792c 2074 6865 6e20 7468 6520 6368 ary, then the ch │ │ │ │ │ +00011800: 6172 6163 7465 7220 6461 7461 2069 7320 aracter data is │ │ │ │ │ +00011810: 7374 6f72 6564 0a20 2020 2020 2020 2020 stored. │ │ │ │ │ +00011820: 2020 2020 2020 7769 7468 696e 2061 2063 within a c │ │ │ │ │ +00011830: 6f6d 7072 6573 7365 6420 6368 6172 6163 ompressed charac │ │ │ │ │ +00011840: 7465 7220 6465 6669 6e69 7469 6f6e 2062 ter definition b │ │ │ │ │ +00011850: 6c6f 636b 2074 6861 740a 2020 2020 2020 lock that. │ │ │ │ │ +00011860: 2020 2020 2020 2020 2062 6567 696e 7320 begins │ │ │ │ │ +00011870: 6174 2074 6865 206f 6666 7365 7420 7769 at the offset wi │ │ │ │ │ +00011880: 7468 696e 2074 6865 2066 696c 6520 696e thin the file in │ │ │ │ │ +00011890: 6469 6361 7465 6420 6279 2074 6865 0a20 dicated by the. │ │ │ │ │ +000118a0: 2020 2020 2020 2020 2020 2020 2020 6368 ch │ │ │ │ │ +000118b0: 6172 6163 7465 7227 7320 2a6f 6666 7365 aracter's *offse │ │ │ │ │ +000118c0: 742a 2076 616c 7565 2e0a 0a20 2020 2020 t* value... │ │ │ │ │ +000118d0: 2020 202a 202a 4f66 6673 6574 2e2a 2020 * *Offset.* │ │ │ │ │ +000118e0: 2833 322d 6269 7420 6269 672d 656e 6469 (32-bit big-endi │ │ │ │ │ +000118f0: 616e 2069 6e74 6567 6572 2e29 0a0a 2020 an integer.).. │ │ │ │ │ +00011900: 2020 2020 2020 2020 4120 6d61 726b 6572 A marker │ │ │ │ │ +00011910: 2074 6861 7420 696e 6469 6361 7465 7320 that indicates │ │ │ │ │ +00011920: 7468 6520 7265 6d61 696e 6465 7220 6f66 the remainder of │ │ │ │ │ +00011930: 2074 6865 2066 696c 6520 6973 2064 6174 the file is dat │ │ │ │ │ +00011940: 610a 2020 2020 2020 2020 2020 6163 6365 a. acce │ │ │ │ │ +00011950: 7373 6564 2076 6961 2074 6865 2063 6861 ssed via the cha │ │ │ │ │ +00011960: 7261 6374 6572 2069 6e64 6578 2028 4348 racter index (CH │ │ │ │ │ +00011970: 4958 2920 7365 6374 696f 6e2e 2020 5768 IX) section. Wh │ │ │ │ │ +00011980: 656e 2072 6561 6469 6e67 0a20 2020 2020 en reading. │ │ │ │ │ +00011990: 2020 2020 2074 6869 7320 666f 6e74 2066 this font f │ │ │ │ │ +000119a0: 696c 652c 2074 6865 2072 6573 7420 6f66 ile, the rest of │ │ │ │ │ +000119b0: 2074 6865 2066 696c 6520 6361 6e20 6265 the file can be │ │ │ │ │ +000119c0: 2069 676e 6f72 6564 2077 6865 6e0a 2020 ignored when. │ │ │ │ │ +000119d0: 2020 2020 2020 2020 7363 616e 6e69 6e67 scanning │ │ │ │ │ +000119e0: 2074 6865 2073 6563 7469 6f6e 732e 2020 the sections. │ │ │ │ │ +000119f0: 5468 6520 6c65 6e67 7468 2073 686f 756c The length shoul │ │ │ │ │ +00011a00: 6420 6265 2073 6574 2074 6f20 2d31 0a20 d be set to -1. │ │ │ │ │ +00011a10: 2020 2020 2020 2020 2028 3078 4646 4646 (0xFFFF │ │ │ │ │ +00011a20: 4646 4646 292e 0a0a 2020 2020 2020 2020 FFFF)... │ │ │ │ │ +00011a30: 2020 5375 7070 6f72 7465 6420 6461 7461 Supported data │ │ │ │ │ +00011a40: 2073 7472 7563 7475 7265 733a 0a0a 2020 structures:.. │ │ │ │ │ +00011a50: 2020 2020 2020 2020 4368 6172 6163 7465 Characte │ │ │ │ │ +00011a60: 7220 6465 6669 6e69 7469 6f6e 2045 6163 r definition Eac │ │ │ │ │ +00011a70: 6820 6368 6172 6163 7465 7220 6465 6669 h character defi │ │ │ │ │ +00011a80: 6e69 7469 6f6e 2063 6f6e 7369 7374 7320 nition consists │ │ │ │ │ +00011a90: 6f66 3a0a 0a20 2020 2020 2020 2020 2020 of:.. │ │ │ │ │ +00011aa0: 2020 2a20 2a57 6964 7468 2e2a 2020 5769 * *Width.* Wi │ │ │ │ │ +00011ab0: 6474 6820 6f66 2074 6865 2062 6974 6d61 dth of the bitma │ │ │ │ │ +00011ac0: 7020 696e 2070 6978 656c 732e 2020 5468 p in pixels. Th │ │ │ │ │ +00011ad0: 6520 6269 746d 6170 2773 0a20 2020 2020 e bitmap's. │ │ │ │ │ +00011ae0: 2020 2020 2020 2020 2020 6578 7465 6e74 extent │ │ │ │ │ +00011af0: 7320 7265 7072 6573 656e 7420 7468 6520 s represent the │ │ │ │ │ +00011b00: 676c 7970 6827 7320 626f 756e 6469 6e67 glyph's bounding │ │ │ │ │ +00011b10: 2062 6f78 2e20 2027 7569 6e74 3136 6265 box. 'uint16be │ │ │ │ │ +00011b20: 272e 0a0a 2020 2020 2020 2020 2020 2020 '... │ │ │ │ │ +00011b30: 202a 202a 4865 6967 6874 2e2a 2020 4865 * *Height.* He │ │ │ │ │ +00011b40: 6967 6874 206f 6620 7468 6520 6269 746d ight of the bitm │ │ │ │ │ +00011b50: 6170 2069 6e20 7069 7865 6c73 2e20 2054 ap in pixels. T │ │ │ │ │ +00011b60: 6865 2062 6974 6d61 7027 730a 2020 2020 he bitmap's. │ │ │ │ │ +00011b70: 2020 2020 2020 2020 2020 2065 7874 656e exten │ │ │ │ │ +00011b80: 7473 2072 6570 7265 7365 6e74 2074 6865 ts represent the │ │ │ │ │ +00011b90: 2067 6c79 7068 2773 2062 6f75 6e64 696e glyph's boundin │ │ │ │ │ +00011ba0: 6720 626f 782e 2020 2775 696e 7431 3662 g box. 'uint16b │ │ │ │ │ +00011bb0: 6527 2e0a 0a20 2020 2020 2020 2020 2020 e'... │ │ │ │ │ +00011bc0: 2020 2a20 2a58 206f 6666 7365 742e 2a20 * *X offset.* │ │ │ │ │ +00011bd0: 2054 6865 206e 756d 6265 7220 6f66 2070 The number of p │ │ │ │ │ +00011be0: 6978 656c 7320 746f 2073 6869 6674 2074 ixels to shift t │ │ │ │ │ +00011bf0: 6865 2062 6974 6d61 7020 6279 0a20 2020 he bitmap by. │ │ │ │ │ +00011c00: 2020 2020 2020 2020 2020 2020 686f 7269 hori │ │ │ │ │ +00011c10: 7a6f 6e74 616c 6c79 2062 6566 6f72 6520 zontally before │ │ │ │ │ +00011c20: 6472 6177 696e 6720 7468 6520 6368 6172 drawing the char │ │ │ │ │ +00011c30: 6163 7465 722e 2020 2769 6e74 3136 6265 acter. 'int16be │ │ │ │ │ +00011c40: 272e 0a0a 2020 2020 2020 2020 2020 2020 '... │ │ │ │ │ +00011c50: 202a 202a 5920 6f66 6673 6574 2e2a 2020 * *Y offset.* │ │ │ │ │ +00011c60: 5468 6520 6e75 6d62 6572 206f 6620 7069 The number of pi │ │ │ │ │ +00011c70: 7865 6c73 2074 6f20 7368 6966 7420 7468 xels to shift th │ │ │ │ │ +00011c80: 6520 6269 746d 6170 2062 790a 2020 2020 e bitmap by. │ │ │ │ │ +00011c90: 2020 2020 2020 2020 2020 2076 6572 7469 verti │ │ │ │ │ +00011ca0: 6361 6c6c 7920 6265 666f 7265 2064 7261 cally before dra │ │ │ │ │ +00011cb0: 7769 6e67 2074 6865 2063 6861 7261 6374 wing the charact │ │ │ │ │ +00011cc0: 6572 2e20 2027 696e 7431 3662 6527 2e0a er. 'int16be'.. │ │ │ │ │ +00011cd0: 0a20 2020 2020 2020 2020 2020 2020 2a20 . * │ │ │ │ │ +00011ce0: 2a44 6576 6963 6520 7769 6474 682e 2a20 *Device width.* │ │ │ │ │ +00011cf0: 2054 6865 206e 756d 6265 7220 6f66 2070 The number of p │ │ │ │ │ +00011d00: 6978 656c 7320 746f 2061 6476 616e 6365 ixels to advance │ │ │ │ │ +00011d10: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +00011d20: 686f 7269 7a6f 6e74 616c 6c79 2066 726f horizontally fro │ │ │ │ │ +00011d30: 6d20 7468 6973 2063 6861 7261 6374 6572 m this character │ │ │ │ │ +00011d40: 2773 206f 7269 6769 6e20 746f 2074 6865 's origin to the │ │ │ │ │ +00011d50: 206f 7269 6769 6e0a 2020 2020 2020 2020 origin. │ │ │ │ │ +00011d60: 2020 2020 2020 206f 6620 7468 6520 6e65 of the ne │ │ │ │ │ +00011d70: 7874 2063 6861 7261 6374 6572 2e20 2027 xt character. ' │ │ │ │ │ +00011d80: 696e 7431 3662 6527 2e0a 0a20 2020 2020 int16be'... │ │ │ │ │ +00011d90: 2020 2020 2020 2020 2a20 2a42 6974 6d61 * *Bitma │ │ │ │ │ +00011da0: 7020 6461 7461 2e2a 2020 5468 6973 2069 p data.* This i │ │ │ │ │ +00011db0: 7320 656e 636f 6465 6420 6173 2061 2073 s encoded as a s │ │ │ │ │ +00011dc0: 7472 696e 6720 6f66 2062 6974 732e 2020 tring of bits. │ │ │ │ │ +00011dd0: 4974 0a20 2020 2020 2020 2020 2020 2020 It. │ │ │ │ │ +00011de0: 2020 6973 206f 7267 616e 697a 6564 2061 is organized a │ │ │ │ │ +00011df0: 7320 6120 726f 772d 6d61 6a6f 722c 2074 s a row-major, t │ │ │ │ │ +00011e00: 6f70 2d64 6f77 6e2c 206c 6566 742d 746f op-down, left-to │ │ │ │ │ +00011e10: 2d72 6967 6874 0a20 2020 2020 2020 2020 -right. │ │ │ │ │ +00011e20: 2020 2020 2020 6269 746d 6170 2e20 2054 bitmap. T │ │ │ │ │ +00011e30: 6865 206d 6f73 7420 7369 676e 6966 6963 he most signific │ │ │ │ │ +00011e40: 616e 7420 6269 7420 6f66 2065 6163 6820 ant bit of each │ │ │ │ │ +00011e50: 6279 7465 2069 7320 7461 6b65 6e0a 2020 byte is taken. │ │ │ │ │ +00011e60: 2020 2020 2020 2020 2020 2020 2074 6f20 to │ │ │ │ │ +00011e70: 6265 2074 6865 206c 6566 746d 6f73 7420 be the leftmost │ │ │ │ │ +00011e80: 6f72 2075 7070 6572 6d6f 7374 2062 6974 or uppermost bit │ │ │ │ │ +00011e90: 2069 6e20 7468 6520 6279 7465 2e20 2046 in the byte. F │ │ │ │ │ +00011ea0: 6f72 2074 6865 0a20 2020 2020 2020 2020 or the. │ │ │ │ │ +00011eb0: 2020 2020 2020 7361 6b65 206f 6620 636f sake of co │ │ │ │ │ +00011ec0: 6d70 6163 7420 7374 6f72 6167 652c 2072 mpact storage, r │ │ │ │ │ +00011ed0: 6f77 7320 6172 6520 6e6f 7420 7061 6464 ows are not padd │ │ │ │ │ +00011ee0: 6564 2074 6f20 6279 7465 0a20 2020 2020 ed to byte. │ │ │ │ │ +00011ef0: 2020 2020 2020 2020 2020 626f 756e 6461 bounda │ │ │ │ │ +00011f00: 7269 6573 2028 692e 652e 2c20 6120 7369 ries (i.e., a si │ │ │ │ │ +00011f10: 6e67 6c65 2062 7974 6520 6d61 7920 636f ngle byte may co │ │ │ │ │ +00011f20: 6e74 6169 6e20 6269 7473 0a20 2020 2020 ntain bits. │ │ │ │ │ +00011f30: 2020 2020 2020 2020 2020 6265 6c6f 6e67 belong │ │ │ │ │ +00011f40: 696e 6720 746f 206d 756c 7469 706c 6520 ing to multiple │ │ │ │ │ +00011f50: 726f 7773 292e 2020 5468 6520 6c61 7374 rows). The last │ │ │ │ │ +00011f60: 2062 7974 6520 6f66 2074 6865 2062 6974 byte of the bit │ │ │ │ │ +00011f70: 6d61 700a 2020 2020 2020 2020 2020 2020 map. │ │ │ │ │ +00011f80: 2020 202a 6973 2a20 7061 6464 6564 2077 *is* padded w │ │ │ │ │ +00011f90: 6974 6820 7a65 726f 2062 6974 7320 696e ith zero bits in │ │ │ │ │ +00011fa0: 2074 6865 2062 6974 7320 706f 7369 7469 the bits positi │ │ │ │ │ +00011fb0: 6f6e 7320 746f 2074 6865 0a20 2020 2020 ons to the. │ │ │ │ │ +00011fc0: 2020 2020 2020 2020 2020 7269 6768 7420 right │ │ │ │ │ +00011fd0: 6f66 2074 6865 206c 6173 7420 7573 6564 of the last used │ │ │ │ │ +00011fe0: 2062 6974 2069 6620 7468 6520 6269 746d bit if the bitm │ │ │ │ │ +00011ff0: 6170 2064 6174 6120 646f 6573 206e 6f74 ap data does not │ │ │ │ │ +00012000: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +00012010: 6669 6c6c 2074 6865 206c 6173 7420 6279 fill the last by │ │ │ │ │ +00012020: 7465 2e0a 0a20 2020 2020 2020 2020 2020 te... │ │ │ │ │ +00012030: 2020 2020 5468 6520 6c65 6e67 7468 206f The length o │ │ │ │ │ +00012040: 6620 7468 6520 2a62 6974 6d61 7020 6461 f the *bitmap da │ │ │ │ │ +00012050: 7461 2a20 6669 656c 6420 6973 2028 5749 ta* field is (WI │ │ │ │ │ +00012060: 4454 4820 2a20 4845 4947 4854 0a20 2020 DTH * HEIGHT. │ │ │ │ │ +00012070: 2020 2020 2020 2020 2020 2020 2b20 3729 + 7) │ │ │ │ │ +00012080: 202f 2038 2075 7369 6e67 2069 6e74 6567 / 8 using integ │ │ │ │ │ +00012090: 6572 2061 7269 7468 6d65 7469 632c 2077 er arithmetic, w │ │ │ │ │ +000120a0: 6869 6368 2069 7320 6571 7569 7661 6c65 hich is equivale │ │ │ │ │ +000120b0: 6e74 2074 6f0a 2020 2020 2020 2020 2020 nt to. │ │ │ │ │ +000120c0: 2020 2020 2063 6569 6c28 5749 4454 4820 ceil(WIDTH │ │ │ │ │ +000120d0: 2a20 4845 4947 4854 202f 2038 2920 7573 * HEIGHT / 8) us │ │ │ │ │ +000120e0: 696e 6720 7265 616c 206e 756d 6265 7220 ing real number │ │ │ │ │ +000120f0: 6172 6974 686d 6574 6963 2e0a 0a20 2020 arithmetic... │ │ │ │ │ +00012100: 2020 2020 2020 2020 2020 2020 4974 2072 It r │ │ │ │ │ +00012110: 656d 6169 6e73 2074 6f20 6265 2064 6574 emains to be det │ │ │ │ │ +00012120: 6572 6d69 6e65 6420 7768 6574 6865 7220 ermined whether │ │ │ │ │ +00012130: 6269 746d 6170 2066 6f6e 7473 2075 7375 bitmap fonts usu │ │ │ │ │ +00012140: 616c 6c79 0a20 2020 2020 2020 2020 2020 ally. │ │ │ │ │ +00012150: 2020 2020 6d61 6b65 2061 6c6c 2067 6c79 make all gly │ │ │ │ │ +00012160: 7068 2062 6974 6d61 7073 2074 6865 2073 ph bitmaps the s │ │ │ │ │ +00012170: 616d 6520 6865 6967 6874 2c20 6f72 2069 ame height, or i │ │ │ │ │ +00012180: 6620 736d 616c 6c65 720a 2020 2020 2020 f smaller. │ │ │ │ │ +00012190: 2020 2020 2020 2020 2067 6c79 7068 7320 glyphs │ │ │ │ │ +000121a0: 6172 6520 7374 6f72 6564 2077 6974 6820 are stored with │ │ │ │ │ +000121b0: 6269 746d 6170 7320 6861 7669 6e67 2061 bitmaps having a │ │ │ │ │ +000121c0: 206c 6573 7365 7220 6865 6967 6874 2e0a lesser height.. │ │ │ │ │ +000121d0: 2020 2020 2020 2020 2020 2020 2020 2049 I │ │ │ │ │ +000121e0: 6e20 7468 6520 6c61 7474 6572 2063 6173 n the latter cas │ │ │ │ │ +000121f0: 652c 2074 6865 2062 6173 656c 696e 6520 e, the baseline │ │ │ │ │ +00012200: 776f 756c 6420 6861 7665 2074 6f20 6265 would have to be │ │ │ │ │ +00012210: 2075 7365 6420 746f 0a20 2020 2020 2020 used to. │ │ │ │ │ +00012220: 2020 2020 2020 2020 6361 6c63 756c 6174 calculat │ │ │ │ │ +00012230: 6520 7468 6520 6c6f 6361 7469 6f6e 2074 e the location t │ │ │ │ │ +00012240: 6865 2062 6974 6d61 7020 7368 6f75 6c64 he bitmap should │ │ │ │ │ +00012250: 2062 6520 616e 6368 6f72 6564 2061 740a be anchored at. │ │ │ │ │ +00012260: 2020 2020 2020 2020 2020 2020 2020 206f o │ │ │ │ │ +00012270: 6e20 7363 7265 656e 2e0a 0a1f 0a46 696c n screen.....Fil │ │ │ │ │ +00012280: 653a 2067 7275 622d 6465 762e 696e 666f e: grub-dev.info │ │ │ │ │ +00012290: 2c20 204e 6f64 653a 2046 6f6e 7420 4d65 , Node: Font Me │ │ │ │ │ +000122a0: 7472 6963 732c 2020 5072 6576 3a20 4669 trics, Prev: Fi │ │ │ │ │ +000122b0: 6c65 2053 7472 7563 7475 7265 2c20 2055 le Structure, U │ │ │ │ │ +000122c0: 703a 2050 4646 3220 466f 6e74 2046 696c p: PFF2 Font Fil │ │ │ │ │ +000122d0: 6520 466f 726d 6174 0a0a 3131 2e33 2046 e Format..11.3 F │ │ │ │ │ +000122e0: 6f6e 7420 4d65 7472 6963 730a 3d3d 3d3d ont Metrics.==== │ │ │ │ │ +000122f0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a20 =============.. │ │ │ │ │ +00012300: 2020 2a20 4173 6365 6e74 2e20 2054 6865 * Ascent. The │ │ │ │ │ +00012310: 2064 6973 7461 6e63 6520 6672 6f6d 2074 distance from t │ │ │ │ │ +00012320: 6865 2062 6173 656c 696e 6520 746f 2074 he baseline to t │ │ │ │ │ +00012330: 6865 2074 6f70 206f 6620 6d6f 7374 0a20 he top of most. │ │ │ │ │ +00012340: 2020 2020 6368 6172 6163 7465 7273 2e20 characters. │ │ │ │ │ +00012350: 204e 6f74 6520 7468 6174 2069 6e20 736f Note that in so │ │ │ │ │ +00012360: 6d65 2063 6173 6573 2063 6861 7261 6374 me cases charact │ │ │ │ │ +00012370: 6572 7320 6d61 7920 6578 7465 6e64 2061 ers may extend a │ │ │ │ │ +00012380: 626f 7665 0a20 2020 2020 7468 6520 6173 bove. the as │ │ │ │ │ +00012390: 6365 6e74 2e0a 0a20 2020 2a20 4465 7363 cent... * Desc │ │ │ │ │ +000123a0: 656e 742e 2020 5468 6520 6469 7374 616e ent. The distan │ │ │ │ │ +000123b0: 6365 2066 726f 6d20 7468 6520 6261 7365 ce from the base │ │ │ │ │ +000123c0: 6c69 6e65 2074 6f20 7468 6520 626f 7474 line to the bott │ │ │ │ │ +000123d0: 6f6d 206f 6620 6d6f 7374 0a20 2020 2020 om of most. │ │ │ │ │ +000123e0: 6368 6172 6163 7465 7273 2e20 204e 6f74 characters. Not │ │ │ │ │ +000123f0: 6520 7468 6174 2069 6e20 736f 6d65 2063 e that in some c │ │ │ │ │ +00012400: 6173 6573 2063 6861 7261 6374 6572 7320 ases characters │ │ │ │ │ +00012410: 6d61 7920 6578 7465 6e64 2062 656c 6f77 may extend below │ │ │ │ │ +00012420: 0a20 2020 2020 7468 6520 6465 7363 656e . the descen │ │ │ │ │ +00012430: 742e 0a0a 2020 202a 204c 6561 6469 6e67 t... * Leading │ │ │ │ │ +00012440: 2e20 2054 6865 2061 6d6f 756e 7420 6f66 . The amount of │ │ │ │ │ +00012450: 2073 7061 6365 2c20 696e 2070 6978 656c space, in pixel │ │ │ │ │ +00012460: 732c 2074 6f20 6c65 6176 6520 6265 7477 s, to leave betw │ │ │ │ │ +00012470: 6565 6e20 7468 650a 2020 2020 2064 6573 een the. des │ │ │ │ │ +00012480: 6365 6e74 206f 6620 6f6e 6520 6c69 6e65 cent of one line │ │ │ │ │ +00012490: 206f 6620 7465 7874 2061 6e64 2074 6865 of text and the │ │ │ │ │ +000124a0: 2061 7363 656e 7420 6f66 2074 6865 206e ascent of the n │ │ │ │ │ +000124b0: 6578 7420 6c69 6e65 2e20 2054 6869 730a ext line. This. │ │ │ │ │ +000124c0: 2020 2020 206d 6574 7269 6373 2069 7320 metrics is │ │ │ │ │ +000124d0: 6e6f 7420 7370 6563 6966 6965 6420 696e not specified in │ │ │ │ │ +000124e0: 2074 6865 2063 7572 7265 6e74 2066 696c the current fil │ │ │ │ │ +000124f0: 6520 666f 726d 6174 3b20 696e 7374 6561 e format; instea │ │ │ │ │ +00012500: 642c 2074 6865 0a20 2020 2020 666f 6e74 d, the. font │ │ │ │ │ +00012510: 2072 656e 6465 7269 6e67 2065 6e67 696e rendering engin │ │ │ │ │ +00012520: 6520 6361 6c63 756c 6174 6573 2061 2072 e calculates a r │ │ │ │ │ +00012530: 6561 736f 6e61 626c 6520 6c65 6164 696e easonable leadin │ │ │ │ │ +00012540: 6720 7661 6c75 6520 6261 7365 640a 2020 g value based. │ │ │ │ │ +00012550: 2020 206f 6e20 7468 6520 6f74 6865 7220 on the other │ │ │ │ │ +00012560: 666f 6e74 206d 6574 7269 6373 2e0a 0a20 font metrics... │ │ │ │ │ +00012570: 2020 2a20 486f 7269 7a6f 6e61 6c20 6c65 * Horizonal le │ │ │ │ │ +00012580: 6164 696e 672e 2020 5468 6520 616d 6f75 ading. The amou │ │ │ │ │ +00012590: 6e74 206f 6620 7370 6163 652c 2069 6e20 nt of space, in │ │ │ │ │ +000125a0: 7069 7865 6c73 2c20 746f 206c 6561 7665 pixels, to leave │ │ │ │ │ +000125b0: 0a20 2020 2020 686f 7269 7a6f 6e74 616c . horizontal │ │ │ │ │ +000125c0: 6c79 2062 6574 7765 656e 2074 6865 206c ly between the l │ │ │ │ │ +000125d0: 6566 7420 616e 6420 7269 6768 7420 6564 eft and right ed │ │ │ │ │ +000125e0: 6765 7320 6f66 2074 776f 2061 646a 6163 ges of two adjac │ │ │ │ │ +000125f0: 656e 740a 2020 2020 2067 6c79 7068 732e ent. glyphs. │ │ │ │ │ +00012600: 2020 5468 6520 2a64 6576 6963 6520 7769 The *device wi │ │ │ │ │ +00012610: 6474 682a 2066 6965 6c64 2064 6574 6572 dth* field deter │ │ │ │ │ +00012620: 6d69 6e65 7320 7468 6520 6566 6665 6374 mines the effect │ │ │ │ │ +00012630: 6976 6520 6c65 6164 696e 670a 2020 2020 ive leading. │ │ │ │ │ +00012640: 2076 616c 7565 2074 6861 7420 6973 2075 value that is u │ │ │ │ │ +00012650: 7365 6420 746f 2072 656e 6465 7220 7468 sed to render th │ │ │ │ │ +00012660: 6520 666f 6e74 2e0a 0a00 085b 696d 6167 e font.....[imag │ │ │ │ │ +00012670: 6520 7372 633d 2266 6f6e 745f 6368 6172 e src="font_char │ │ │ │ │ +00012680: 5f6d 6574 7269 6373 2e70 6e67 2220 7465 _metrics.png" te │ │ │ │ │ +00012690: 7874 3d22 506c 6561 7365 2066 696c 6c20 xt="Please fill │ │ │ │ │ +000126a0: 7468 6973 2069 6e2e 2200 085d 0a0a 0a20 this in."..]... │ │ │ │ │ +000126b0: 2020 416e 2069 6c6c 7573 7472 6174 696f An illustratio │ │ │ │ │ +000126c0: 6e20 6f66 2068 6f77 2074 6865 2076 6172 n of how the var │ │ │ │ │ +000126d0: 696f 7573 2066 6f6e 7420 6d65 7472 6963 ious font metric │ │ │ │ │ +000126e0: 7320 6170 706c 7920 746f 2063 6861 7261 s apply to chara │ │ │ │ │ +000126f0: 6374 6572 732e 0a0a 1f0a 4669 6c65 3a20 cters.....File: │ │ │ │ │ +00012700: 6772 7562 2d64 6576 2e69 6e66 6f2c 2020 grub-dev.info, │ │ │ │ │ +00012710: 4e6f 6465 3a20 4772 6170 6869 6361 6c20 Node: Graphical │ │ │ │ │ +00012720: 4d65 6e75 2053 6f66 7477 6172 6520 4465 Menu Software De │ │ │ │ │ +00012730: 7369 676e 2c20 204e 6578 743a 2056 6572 sign, Next: Ver │ │ │ │ │ +00012740: 6966 6965 7273 2066 7261 6d65 776f 726b ifiers framework │ │ │ │ │ +00012750: 2c20 2050 7265 763a 2050 4646 3220 466f , Prev: PFF2 Fo │ │ │ │ │ +00012760: 6e74 2046 696c 6520 466f 726d 6174 2c20 nt File Format, │ │ │ │ │ +00012770: 2055 703a 2054 6f70 0a0a 3132 2047 7261 Up: Top..12 Gra │ │ │ │ │ +00012780: 7068 6963 616c 204d 656e 7520 536f 6674 phical Menu Soft │ │ │ │ │ +00012790: 7761 7265 2044 6573 6967 6e0a 2a2a 2a2a ware Design.**** │ │ │ │ │ 000127a0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -000127b0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a ***************. │ │ │ │ │ -000127c0: 0a2a 204d 656e 753a 0a0a 2a20 496e 7472 .* Menu:..* Intr │ │ │ │ │ -000127d0: 6f64 7563 7469 6f6e 5f32 3a3a 0a2a 2053 oduction_2::.* S │ │ │ │ │ -000127e0: 7461 7274 7570 2053 6571 7565 6e63 653a tartup Sequence: │ │ │ │ │ -000127f0: 3a0a 2a20 4755 4920 436f 6d70 6f6e 656e :.* GUI Componen │ │ │ │ │ -00012800: 7473 3a3a 0a2a 2043 6f6d 6d61 6e64 204c ts::.* Command L │ │ │ │ │ -00012810: 696e 6520 5769 6e64 6f77 3a3a 0a0a 1f0a ine Window::.... │ │ │ │ │ -00012820: 4669 6c65 3a20 6772 7562 2d64 6576 2e69 File: grub-dev.i │ │ │ │ │ -00012830: 6e66 6f2c 2020 4e6f 6465 3a20 496e 7472 nfo, Node: Intr │ │ │ │ │ -00012840: 6f64 7563 7469 6f6e 5f32 2c20 204e 6578 oduction_2, Nex │ │ │ │ │ -00012850: 743a 2053 7461 7274 7570 2053 6571 7565 t: Startup Seque │ │ │ │ │ -00012860: 6e63 652c 2020 5570 3a20 4772 6170 6869 nce, Up: Graphi │ │ │ │ │ -00012870: 6361 6c20 4d65 6e75 2053 6f66 7477 6172 cal Menu Softwar │ │ │ │ │ -00012880: 6520 4465 7369 676e 0a0a 3132 2e31 2049 e Design..12.1 I │ │ │ │ │ -00012890: 6e74 726f 6475 6374 696f 6e0a 3d3d 3d3d ntroduction.==== │ │ │ │ │ -000128a0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a54 =============..T │ │ │ │ │ -000128b0: 6865 2027 6766 786d 656e 7527 206d 6f64 he 'gfxmenu' mod │ │ │ │ │ -000128c0: 756c 6520 7072 6f76 6964 6573 2061 2067 ule provides a g │ │ │ │ │ -000128d0: 7261 7068 6963 616c 206d 656e 7520 696e raphical menu in │ │ │ │ │ -000128e0: 7465 7266 6163 6520 666f 7220 4752 5542 terface for GRUB │ │ │ │ │ -000128f0: 2032 2e20 2049 740a 6675 6e63 7469 6f6e 2. It.function │ │ │ │ │ -00012900: 7320 6173 2061 6e20 616c 7465 726e 6174 s as an alternat │ │ │ │ │ -00012910: 6976 6520 746f 2074 6865 206d 656e 7520 ive to the menu │ │ │ │ │ -00012920: 696e 7465 7266 6163 6520 7072 6f76 6964 interface provid │ │ │ │ │ -00012930: 6564 2062 7920 7468 650a 276e 6f72 6d61 ed by the.'norma │ │ │ │ │ -00012940: 6c27 206d 6f64 756c 652c 2077 6869 6368 l' module, which │ │ │ │ │ -00012950: 2075 7365 7320 7468 6520 6772 7562 2074 uses the grub t │ │ │ │ │ -00012960: 6572 6d69 6e61 6c20 696e 7465 7266 6163 erminal interfac │ │ │ │ │ -00012970: 6520 746f 2064 6973 706c 6179 2061 0a6d e to display a.m │ │ │ │ │ -00012980: 656e 7520 6f6e 2061 2063 6861 7261 6374 enu on a charact │ │ │ │ │ -00012990: 6572 2d6f 7269 656e 7465 6420 7465 726d er-oriented term │ │ │ │ │ -000129a0: 696e 616c 2e0a 0a20 2020 5468 6520 6772 inal... The gr │ │ │ │ │ -000129b0: 6170 6869 6361 6c20 6d65 6e75 2075 7365 aphical menu use │ │ │ │ │ -000129c0: 7320 7468 6520 4752 5542 2076 6964 656f s the GRUB video │ │ │ │ │ -000129d0: 2041 5049 2c20 7768 6963 6820 6973 2063 API, which is c │ │ │ │ │ -000129e0: 7572 7265 6e74 6c79 2066 6f72 0a74 6865 urrently for.the │ │ │ │ │ -000129f0: 2056 4553 4120 4249 4f53 2065 7874 656e VESA BIOS exten │ │ │ │ │ -00012a00: 7369 6f6e 7320 2856 4245 2920 322e 302b sions (VBE) 2.0+ │ │ │ │ │ -00012a10: 2e20 2054 6869 7320 6973 2073 7570 706f . This is suppo │ │ │ │ │ -00012a20: 7274 6564 206f 6e20 7468 6520 6933 3836 rted on the i386 │ │ │ │ │ -00012a30: 2d70 630a 706c 6174 666f 726d 2e20 2048 -pc.platform. H │ │ │ │ │ -00012a40: 6f77 6576 6572 2c20 7468 6520 6772 6170 owever, the grap │ │ │ │ │ -00012a50: 6869 6361 6c20 6d65 6e75 2069 7473 656c hical menu itsel │ │ │ │ │ -00012a60: 6620 646f 6573 206e 6f74 2064 6570 656e f does not depen │ │ │ │ │ -00012a70: 6420 6f6e 2075 7369 6e67 0a56 4245 2c20 d on using.VBE, │ │ │ │ │ -00012a80: 736f 2069 6620 616e 6f74 6865 7220 4752 so if another GR │ │ │ │ │ -00012a90: 5542 2076 6964 656f 2064 7269 7665 7220 UB video driver │ │ │ │ │ -00012aa0: 7765 7265 2069 6d70 6c65 6d65 6e74 6564 were implemented │ │ │ │ │ -00012ab0: 2c20 7468 6520 2767 6678 6d65 6e75 270a , the 'gfxmenu'. │ │ │ │ │ -00012ac0: 6772 6170 6869 6361 6c20 6d65 6e75 2077 graphical menu w │ │ │ │ │ -00012ad0: 6f75 6c64 2077 6f72 6b20 6f6e 2074 6865 ould work on the │ │ │ │ │ -00012ae0: 206e 6577 2076 6964 656f 2064 7269 7665 new video drive │ │ │ │ │ -00012af0: 7220 6173 2077 656c 6c2e 0a0a 1f0a 4669 r as well.....Fi │ │ │ │ │ -00012b00: 6c65 3a20 6772 7562 2d64 6576 2e69 6e66 le: grub-dev.inf │ │ │ │ │ -00012b10: 6f2c 2020 4e6f 6465 3a20 5374 6172 7475 o, Node: Startu │ │ │ │ │ -00012b20: 7020 5365 7175 656e 6365 2c20 204e 6578 p Sequence, Nex │ │ │ │ │ -00012b30: 743a 2047 5549 2043 6f6d 706f 6e65 6e74 t: GUI Component │ │ │ │ │ -00012b40: 732c 2020 5072 6576 3a20 496e 7472 6f64 s, Prev: Introd │ │ │ │ │ -00012b50: 7563 7469 6f6e 5f32 2c20 2055 703a 2047 uction_2, Up: G │ │ │ │ │ -00012b60: 7261 7068 6963 616c 204d 656e 7520 536f raphical Menu So │ │ │ │ │ -00012b70: 6674 7761 7265 2044 6573 6967 6e0a 0a31 ftware Design..1 │ │ │ │ │ -00012b80: 322e 3220 5374 6172 7475 7020 5365 7175 2.2 Startup Sequ │ │ │ │ │ -00012b90: 656e 6365 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d ence.=========== │ │ │ │ │ -00012ba0: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 2020 202a ==========.. * │ │ │ │ │ -00012bb0: 2067 7275 625f 656e 7465 725f 6e6f 726d grub_enter_norm │ │ │ │ │ -00012bc0: 616c 5f6d 6f64 6520 5b6e 6f72 6d61 6c2f al_mode [normal/ │ │ │ │ │ -00012bd0: 6d61 696e 2e63 5d0a 2020 202a 2067 7275 main.c]. * gru │ │ │ │ │ -00012be0: 625f 6e6f 726d 616c 5f65 7865 6375 7465 b_normal_execute │ │ │ │ │ -00012bf0: 205b 6e6f 726d 616c 2f6d 6169 6e2e 635d [normal/main.c] │ │ │ │ │ -00012c00: 0a20 2020 2a20 7265 6164 5f63 6f6e 6669 . * read_confi │ │ │ │ │ -00012c10: 675f 6669 6c65 205b 6e6f 726d 616c 2f6d g_file [normal/m │ │ │ │ │ -00012c20: 6169 6e2e 635d 0a20 2020 2a20 2857 6865 ain.c]. * (Whe │ │ │ │ │ -00012c30: 6e20 2767 6678 6d65 6e75 2e6d 6f64 2720 n 'gfxmenu.mod' │ │ │ │ │ -00012c40: 6973 206c 6f61 6465 6420 7769 7468 2027 is loaded with ' │ │ │ │ │ -00012c50: 696e 736d 6f64 272c 2069 7420 7769 6c6c insmod', it will │ │ │ │ │ -00012c60: 2063 616c 6c0a 2020 2020 2027 6772 7562 call. 'grub │ │ │ │ │ -00012c70: 5f6d 656e 755f 7669 6577 6572 5f72 6567 _menu_viewer_reg │ │ │ │ │ -00012c80: 6973 7465 7228 2927 2074 6f20 7265 6769 ister()' to regi │ │ │ │ │ -00012c90: 7374 6572 2069 7473 656c 662e 290a 2020 ster itself.). │ │ │ │ │ -00012ca0: 202a 2047 5255 425f 4d4f 445f 494e 4954 * GRUB_MOD_INIT │ │ │ │ │ -00012cb0: 2028 6766 786d 656e 7529 205b 6766 786d (gfxmenu) [gfxm │ │ │ │ │ -00012cc0: 656e 752f 6766 786d 656e 752e 635d 0a20 enu/gfxmenu.c]. │ │ │ │ │ -00012cd0: 2020 2a20 6772 7562 5f6d 656e 755f 7669 * grub_menu_vi │ │ │ │ │ -00012ce0: 6577 6572 5f72 6567 6973 7465 7220 5b6b ewer_register [k │ │ │ │ │ -00012cf0: 6572 6e2f 6d65 6e75 5f76 6965 7765 722e ern/menu_viewer. │ │ │ │ │ -00012d00: 635d 0a20 2020 2a20 6772 7562 5f6d 656e c]. * grub_men │ │ │ │ │ -00012d10: 755f 7669 6577 6572 5f73 686f 775f 6d65 u_viewer_show_me │ │ │ │ │ -00012d20: 6e75 205b 6b65 726e 2f6d 656e 755f 7669 nu [kern/menu_vi │ │ │ │ │ -00012d30: 6577 6572 2e63 5d0a 2020 202a 2067 6574 ewer.c]. * get │ │ │ │ │ -00012d40: 5f63 7572 7265 6e74 5f6d 656e 755f 7669 _current_menu_vi │ │ │ │ │ -00012d50: 6577 6572 2829 205b 6b65 726e 2f6d 656e ewer() [kern/men │ │ │ │ │ -00012d60: 755f 7669 6577 6572 2e63 5d0a 2020 202a u_viewer.c]. * │ │ │ │ │ -00012d70: 2073 686f 775f 6d65 6e75 2829 205b 6766 show_menu() [gf │ │ │ │ │ -00012d80: 786d 656e 752f 6766 786d 656e 752e 635d xmenu/gfxmenu.c] │ │ │ │ │ -00012d90: 0a20 2020 2a20 6772 7562 5f67 6678 6d65 . * grub_gfxme │ │ │ │ │ -00012da0: 6e75 5f6d 6f64 656c 5f6e 6577 205b 6766 nu_model_new [gf │ │ │ │ │ -00012db0: 786d 656e 752f 6d6f 6465 6c2e 635d 0a20 xmenu/model.c]. │ │ │ │ │ -00012dc0: 2020 2a20 6772 7562 5f67 6678 6d65 6e75 * grub_gfxmenu │ │ │ │ │ -00012dd0: 5f76 6965 775f 6e65 7720 5b67 6678 6d65 _view_new [gfxme │ │ │ │ │ -00012de0: 6e75 2f76 6965 772e 635d 0a20 2020 2a20 nu/view.c]. * │ │ │ │ │ -00012df0: 7365 745f 6772 6170 6869 6373 5f6d 6f64 set_graphics_mod │ │ │ │ │ -00012e00: 6520 5b67 6678 6d65 6e75 2f76 6965 772e e [gfxmenu/view. │ │ │ │ │ -00012e10: 635d 0a20 2020 2a20 6772 7562 5f67 6678 c]. * grub_gfx │ │ │ │ │ -00012e20: 6d65 6e75 5f76 6965 775f 6c6f 6164 5f74 menu_view_load_t │ │ │ │ │ -00012e30: 6865 6d65 205b 6766 786d 656e 752f 7468 heme [gfxmenu/th │ │ │ │ │ -00012e40: 656d 655f 6c6f 6164 6572 2e63 5d0a 0a1f eme_loader.c]... │ │ │ │ │ -00012e50: 0a46 696c 653a 2067 7275 622d 6465 762e .File: grub-dev. │ │ │ │ │ -00012e60: 696e 666f 2c20 204e 6f64 653a 2047 5549 info, Node: GUI │ │ │ │ │ -00012e70: 2043 6f6d 706f 6e65 6e74 732c 2020 4e65 Components, Ne │ │ │ │ │ -00012e80: 7874 3a20 436f 6d6d 616e 6420 4c69 6e65 xt: Command Line │ │ │ │ │ -00012e90: 2057 696e 646f 772c 2020 5072 6576 3a20 Window, Prev: │ │ │ │ │ -00012ea0: 5374 6172 7475 7020 5365 7175 656e 6365 Startup Sequence │ │ │ │ │ -00012eb0: 2c20 2055 703a 2047 7261 7068 6963 616c , Up: Graphical │ │ │ │ │ -00012ec0: 204d 656e 7520 536f 6674 7761 7265 2044 Menu Software D │ │ │ │ │ -00012ed0: 6573 6967 6e0a 0a31 322e 3320 4755 4920 esign..12.3 GUI │ │ │ │ │ -00012ee0: 436f 6d70 6f6e 656e 7473 0a3d 3d3d 3d3d Components.===== │ │ │ │ │ -00012ef0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a ==============.. │ │ │ │ │ -00012f00: 5468 6520 6772 6170 6869 6361 6c20 6d65 The graphical me │ │ │ │ │ -00012f10: 6e75 2069 6d70 6c65 6d65 6e74 7320 6120 nu implements a │ │ │ │ │ -00012f20: 4755 4920 636f 6d70 6f6e 656e 7420 7379 GUI component sy │ │ │ │ │ -00012f30: 7374 656d 2074 6861 7420 7375 7070 6f72 stem that suppor │ │ │ │ │ -00012f40: 7473 2061 0a63 6f6e 7461 696e 6572 2d62 ts a.container-b │ │ │ │ │ -00012f50: 6173 6564 206c 6179 6f75 7420 7379 7374 ased layout syst │ │ │ │ │ -00012f60: 656d 2e20 2043 6f6d 706f 6e65 6e74 7320 em. Components │ │ │ │ │ -00012f70: 6361 6e20 6265 2061 6464 6564 2074 6f20 can be added to │ │ │ │ │ -00012f80: 636f 6e74 6169 6e65 7273 2c0a 616e 6420 containers,.and │ │ │ │ │ -00012f90: 636f 6e74 6169 6e65 7273 2028 7768 6963 containers (whic │ │ │ │ │ -00012fa0: 6820 6172 6520 6120 7479 7065 206f 6620 h are a type of │ │ │ │ │ -00012fb0: 636f 6d70 6f6e 656e 7429 2063 616e 2074 component) can t │ │ │ │ │ -00012fc0: 6865 6e20 6265 2061 6464 6564 2074 6f0a hen be added to. │ │ │ │ │ -00012fd0: 6f74 6865 7220 636f 6e74 6169 6e65 7273 other containers │ │ │ │ │ -00012fe0: 2c20 746f 2066 6f72 6d20 6120 7472 6565 , to form a tree │ │ │ │ │ -00012ff0: 206f 6620 636f 6d70 6f6e 656e 7473 2e20 of components. │ │ │ │ │ -00013000: 2043 7572 7265 6e74 6c79 2c20 7468 6520 Currently, the │ │ │ │ │ -00013010: 726f 6f74 0a63 6f6d 706f 6e65 6e74 206f root.component o │ │ │ │ │ -00013020: 6620 7468 6973 2074 7265 6520 6973 2061 f this tree is a │ │ │ │ │ -00013030: 2027 6361 6e76 6173 2720 636f 6d70 6f6e 'canvas' compon │ │ │ │ │ -00013040: 656e 742c 2077 6869 6368 2061 6c6c 6f77 ent, which allow │ │ │ │ │ -00013050: 7320 6d61 6e75 616c 0a6c 6179 6f75 7420 s manual.layout │ │ │ │ │ -00013060: 6f66 2069 7473 2063 6869 6c64 2063 6f6d of its child com │ │ │ │ │ -00013070: 706f 6e65 6e74 732e 0a0a 2020 2043 6f6d ponents... Com │ │ │ │ │ -00013080: 706f 6e65 6e74 7320 286e 6f6e 2d63 6f6e ponents (non-con │ │ │ │ │ -00013090: 7461 696e 6572 293a 0a0a 2020 202a 206c tainer):.. * l │ │ │ │ │ -000130a0: 6162 656c 0a20 2020 2a20 696d 6167 650a abel. * image. │ │ │ │ │ -000130b0: 2020 202a 2070 726f 6772 6573 735f 6261 * progress_ba │ │ │ │ │ -000130c0: 720a 2020 202a 2063 6972 6375 6c61 725f r. * circular_ │ │ │ │ │ -000130d0: 7072 6f67 7265 7373 0a20 2020 2a20 6c69 progress. * li │ │ │ │ │ -000130e0: 7374 2028 6375 7272 656e 746c 7920 6861 st (currently ha │ │ │ │ │ -000130f0: 7264 2063 6f64 6564 2074 6f20 6265 2061 rd coded to be a │ │ │ │ │ -00013100: 2062 6f6f 7420 6d65 6e75 206c 6973 7429 boot menu list) │ │ │ │ │ -00013110: 0a0a 2020 2043 6f6e 7461 696e 6572 733a .. Containers: │ │ │ │ │ -00013120: 0a0a 2020 202a 2063 616e 7661 730a 2020 .. * canvas. │ │ │ │ │ -00013130: 202a 2068 626f 780a 2020 202a 2076 626f * hbox. * vbo │ │ │ │ │ -00013140: 780a 0a20 2020 5468 6520 4755 4920 636f x.. The GUI co │ │ │ │ │ -00013150: 6d70 6f6e 656e 7420 696e 7374 616e 6365 mponent instance │ │ │ │ │ -00013160: 7320 6172 6520 6372 6561 7465 6420 6279 s are created by │ │ │ │ │ -00013170: 2074 6865 2074 6865 6d65 206c 6f61 6465 the theme loade │ │ │ │ │ -00013180: 7220 696e 0a27 6766 786d 656e 752f 7468 r in.'gfxmenu/th │ │ │ │ │ -00013190: 656d 655f 6c6f 6164 6572 2e63 2720 7768 eme_loader.c' wh │ │ │ │ │ -000131a0: 656e 2061 2074 6865 6d65 2069 7320 6c6f en a theme is lo │ │ │ │ │ -000131b0: 6164 6564 2e20 2054 6865 6d65 2066 696c aded. Theme fil │ │ │ │ │ -000131c0: 6573 2073 7065 6369 6679 0a73 7461 7465 es specify.state │ │ │ │ │ -000131d0: 6d65 6e74 7320 7375 6368 2061 7320 272b ments such as '+ │ │ │ │ │ -000131e0: 7662 6f78 7b20 2b6c 6162 656c 207b 2074 vbox{ +label { t │ │ │ │ │ -000131f0: 6578 743d 2248 656c 6c6f 2220 7d20 2b6c ext="Hello" } +l │ │ │ │ │ -00013200: 6162 656c 7b20 7465 7874 3d22 576f 726c abel{ text="Worl │ │ │ │ │ -00013210: 6422 0a7d 207d 2720 746f 2061 6464 2063 d".} }' to add c │ │ │ │ │ -00013220: 6f6d 706f 6e65 6e74 7320 746f 2074 6865 omponents to the │ │ │ │ │ -00013230: 2063 6f6d 706f 6e65 6e74 2074 7265 6520 component tree │ │ │ │ │ -00013240: 726f 6f74 2e20 2042 7920 6e65 7374 696e root. By nestin │ │ │ │ │ -00013250: 6720 7468 650a 636f 6d70 6f6e 656e 7420 g the.component │ │ │ │ │ -00013260: 6372 6561 7469 6f6e 2073 7461 7465 6d65 creation stateme │ │ │ │ │ -00013270: 6e74 7320 696e 2074 6865 2074 6865 6d65 nts in the theme │ │ │ │ │ -00013280: 2066 696c 652c 2074 6865 2069 6e73 7461 file, the insta │ │ │ │ │ -00013290: 6e74 6961 7465 640a 636f 6d70 6f6e 656e ntiated.componen │ │ │ │ │ -000132a0: 7473 2061 7265 206e 6573 7465 6420 7468 ts are nested th │ │ │ │ │ -000132b0: 6520 7361 6d65 2077 6179 2e0a 0a20 2020 e same way... │ │ │ │ │ -000132c0: 5768 656e 2061 2063 6f6d 706f 6e65 6e74 When a component │ │ │ │ │ -000132d0: 2069 7320 6164 6465 6420 746f 2061 2063 is added to a c │ │ │ │ │ -000132e0: 6f6e 7461 696e 6572 2c20 7468 6174 206e ontainer, that n │ │ │ │ │ -000132f0: 6577 2063 6869 6c64 2069 730a 636f 6e73 ew child is.cons │ │ │ │ │ -00013300: 6964 6572 6564 202a 6f77 6e65 642a 2062 idered *owned* b │ │ │ │ │ -00013310: 7920 7468 6520 636f 6e74 6169 6e65 722e y the container. │ │ │ │ │ -00013320: 2020 4772 6561 7420 6361 7265 2073 686f Great care sho │ │ │ │ │ -00013330: 756c 6420 6265 2074 616b 656e 2069 6620 uld be taken if │ │ │ │ │ -00013340: 7468 650a 6361 6c6c 6572 2072 6574 6169 the.caller retai │ │ │ │ │ -00013350: 6e73 2061 2072 6566 6572 656e 6365 2074 ns a reference t │ │ │ │ │ -00013360: 6f20 7468 6520 6368 696c 6420 636f 6d70 o the child comp │ │ │ │ │ -00013370: 6f6e 656e 742c 2073 696e 6365 2069 7420 onent, since it │ │ │ │ │ -00013380: 7769 6c6c 2062 650a 6465 7374 726f 7965 will be.destroye │ │ │ │ │ -00013390: 6420 6966 2069 7473 2070 6172 656e 7420 d if its parent │ │ │ │ │ -000133a0: 636f 6e74 6169 6e65 7220 6973 2064 6573 container is des │ │ │ │ │ -000133b0: 7472 6f79 6564 2e20 2041 2062 6574 7465 troyed. A bette │ │ │ │ │ -000133c0: 7220 6368 6f69 6365 2069 6e73 7465 6164 r choice instead │ │ │ │ │ -000133d0: 0a6f 6620 7374 6f72 696e 6720 6120 706f .of storing a po │ │ │ │ │ -000133e0: 696e 7465 7220 746f 2074 6865 2063 6869 inter to the chi │ │ │ │ │ -000133f0: 6c64 2063 6f6d 706f 6e65 6e74 2069 7320 ld component is │ │ │ │ │ -00013400: 746f 2075 7365 2074 6865 2063 6f6d 706f to use the compo │ │ │ │ │ -00013410: 6e65 6e74 2049 440a 746f 2066 696e 6420 nent ID.to find │ │ │ │ │ -00013420: 7468 6520 6465 7369 7265 6420 636f 6d70 the desired comp │ │ │ │ │ -00013430: 6f6e 656e 742e 2020 436f 6d70 6f6e 656e onent. Componen │ │ │ │ │ -00013440: 7420 4944 7320 646f 206e 6f74 2068 6176 t IDs do not hav │ │ │ │ │ -00013450: 6520 746f 2062 6520 756e 6971 7565 0a28 e to be unique.( │ │ │ │ │ -00013460: 6974 2069 7320 6f66 7465 6e20 7573 6566 it is often usef │ │ │ │ │ -00013470: 756c 2074 6f20 6861 7665 206d 756c 7469 ul to have multi │ │ │ │ │ -00013480: 706c 6520 636f 6d70 6f6e 656e 7473 2077 ple components w │ │ │ │ │ -00013490: 6974 6820 616e 2049 4420 6f66 0a22 5f5f ith an ID of."__ │ │ │ │ │ -000134a0: 7469 6d65 6f75 745f 5f22 2c20 666f 7220 timeout__", for │ │ │ │ │ -000134b0: 696e 7374 616e 6365 292e 0a0a 2020 2049 instance)... I │ │ │ │ │ -000134c0: 6e20 6f72 6465 7220 746f 2061 6363 6573 n order to acces │ │ │ │ │ -000134d0: 7320 616e 6420 7573 6520 636f 6d70 6f6e s and use compon │ │ │ │ │ -000134e0: 656e 7473 2069 6e20 7468 6520 636f 6d70 ents in the comp │ │ │ │ │ -000134f0: 6f6e 656e 7420 7472 6565 2c20 7468 6572 onent tree, ther │ │ │ │ │ -00013500: 650a 6172 6520 7477 6f20 6675 6e63 7469 e.are two functi │ │ │ │ │ -00013510: 6f6e 7320 2864 6566 696e 6564 2069 6e20 ons (defined in │ │ │ │ │ -00013520: 2767 6678 6d65 6e75 2f67 7569 5f75 7469 'gfxmenu/gui_uti │ │ │ │ │ -00013530: 6c2e 6327 2920 7468 6174 2061 7265 0a70 l.c') that are.p │ │ │ │ │ -00013540: 6172 7469 6375 6c61 726c 7920 7573 6566 articularly usef │ │ │ │ │ -00013550: 756c 3a0a 0a20 2020 2a20 2767 7275 625f ul:.. * 'grub_ │ │ │ │ │ -00013560: 6775 695f 6669 6e64 5f62 795f 6964 2028 gui_find_by_id ( │ │ │ │ │ -00013570: 726f 6f74 2c20 6964 2c20 6361 6c6c 6261 root, id, callba │ │ │ │ │ -00013580: 636b 2c20 7573 6572 6461 7461 2927 3a0a ck, userdata)':. │ │ │ │ │ -00013590: 0a20 2020 2020 5468 6973 2066 756e 6374 . This funct │ │ │ │ │ -000135a0: 696f 6e20 6563 7572 7369 7665 6c79 2074 ion ecursively t │ │ │ │ │ -000135b0: 7261 7665 7273 6573 2074 6865 2063 6f6d raverses the com │ │ │ │ │ -000135c0: 706f 6e65 6e74 2074 7265 6520 726f 6f74 ponent tree root │ │ │ │ │ -000135d0: 6564 2061 740a 2020 2020 2052 4f4f 542c ed at. ROOT, │ │ │ │ │ -000135e0: 2061 6e64 2066 6f72 2065 7665 7279 2063 and for every c │ │ │ │ │ -000135f0: 6f6d 706f 6e65 6e74 2074 6861 7420 6861 omponent that ha │ │ │ │ │ -00013600: 7320 616e 2049 4420 6571 7561 6c20 746f s an ID equal to │ │ │ │ │ -00013610: 2049 442c 2063 616c 6c73 2074 6865 0a20 ID, calls the. │ │ │ │ │ -00013620: 2020 2020 6675 6e63 7469 6f6e 2070 6f69 function poi │ │ │ │ │ -00013630: 6e74 6564 2074 6f20 6279 2043 414c 4c42 nted to by CALLB │ │ │ │ │ -00013640: 4143 4b20 7769 7468 2074 6865 206d 6174 ACK with the mat │ │ │ │ │ -00013650: 6368 696e 6720 636f 6d70 6f6e 656e 7420 ching component │ │ │ │ │ -00013660: 616e 6420 7468 650a 2020 2020 2076 6f69 and the. voi │ │ │ │ │ -00013670: 6420 706f 696e 7465 7220 5553 4552 4441 d pointer USERDA │ │ │ │ │ -00013680: 5441 2061 7320 6172 6775 6d65 6e74 732e TA as arguments. │ │ │ │ │ -00013690: 2020 5468 6520 6361 6c6c 6261 636b 2066 The callback f │ │ │ │ │ -000136a0: 756e 6374 696f 6e20 6361 6e20 646f 0a20 unction can do. │ │ │ │ │ -000136b0: 2020 2020 7768 6174 6576 6572 2069 7320 whatever is │ │ │ │ │ -000136c0: 6465 7369 7265 6420 746f 2075 7365 2074 desired to use t │ │ │ │ │ -000136d0: 6865 2063 6f6d 706f 6e65 6e74 2070 6173 he component pas │ │ │ │ │ -000136e0: 7365 6420 696e 2e0a 0a20 2020 2a20 2767 sed in... * 'g │ │ │ │ │ -000136f0: 7275 625f 6775 695f 6974 6572 6174 655f rub_gui_iterate_ │ │ │ │ │ -00013700: 7265 6375 7273 6976 656c 7920 2872 6f6f recursively (roo │ │ │ │ │ -00013710: 742c 2063 616c 6c62 6163 6b2c 2075 7365 t, callback, use │ │ │ │ │ -00013720: 7264 6174 6129 273a 0a0a 2020 2020 2054 rdata)':.. T │ │ │ │ │ -00013730: 6869 7320 6675 6e63 7469 6f6e 2063 616c his function cal │ │ │ │ │ -00013740: 6c73 2074 6865 2066 756e 6374 696f 6e20 ls the function │ │ │ │ │ -00013750: 706f 696e 7465 6420 746f 2062 7920 4341 pointed to by CA │ │ │ │ │ -00013760: 4c4c 4241 434b 2066 6f72 2065 7665 7279 LLBACK for every │ │ │ │ │ -00013770: 0a20 2020 2020 636f 6d70 6f6e 656e 7420 . component │ │ │ │ │ -00013780: 7468 6174 2069 7320 6120 6465 7363 656e that is a descen │ │ │ │ │ -00013790: 6461 6e74 206f 6620 524f 4f54 2069 6e20 dant of ROOT in │ │ │ │ │ -000137a0: 7468 6520 636f 6d70 6f6e 656e 7420 7472 the component tr │ │ │ │ │ -000137b0: 6565 2e20 2057 6865 6e0a 2020 2020 2074 ee. When. t │ │ │ │ │ -000137c0: 6865 2063 616c 6c62 6163 6b20 6675 6e63 he callback func │ │ │ │ │ -000137d0: 7469 6f6e 2069 7320 6361 6c6c 6564 2c20 tion is called, │ │ │ │ │ -000137e0: 7468 6520 636f 6d70 6f6e 656e 7420 616e the component an │ │ │ │ │ -000137f0: 6420 7468 6520 766f 6964 2070 6f69 6e74 d the void point │ │ │ │ │ -00013800: 6572 0a20 2020 2020 5553 4552 4441 5441 er. USERDATA │ │ │ │ │ -00013810: 2061 7320 6172 6775 6d65 6e74 732e 2020 as arguments. │ │ │ │ │ -00013820: 5468 6520 6361 6c6c 6261 636b 2066 756e The callback fun │ │ │ │ │ -00013830: 6374 696f 6e20 6361 6e20 646f 2077 6861 ction can do wha │ │ │ │ │ -00013840: 7465 7665 7220 6973 0a20 2020 2020 6465 tever is. de │ │ │ │ │ -00013850: 7369 7265 6420 746f 2075 7365 2074 6865 sired to use the │ │ │ │ │ -00013860: 2063 6f6d 706f 6e65 6e74 2070 6173 7365 component passe │ │ │ │ │ -00013870: 6420 696e 2e0a 0a1f 0a46 696c 653a 2067 d in.....File: g │ │ │ │ │ -00013880: 7275 622d 6465 762e 696e 666f 2c20 204e rub-dev.info, N │ │ │ │ │ -00013890: 6f64 653a 2043 6f6d 6d61 6e64 204c 696e ode: Command Lin │ │ │ │ │ -000138a0: 6520 5769 6e64 6f77 2c20 2050 7265 763a e Window, Prev: │ │ │ │ │ -000138b0: 2047 5549 2043 6f6d 706f 6e65 6e74 732c GUI Components, │ │ │ │ │ -000138c0: 2020 5570 3a20 4772 6170 6869 6361 6c20 Up: Graphical │ │ │ │ │ -000138d0: 4d65 6e75 2053 6f66 7477 6172 6520 4465 Menu Software De │ │ │ │ │ -000138e0: 7369 676e 0a0a 3132 2e34 2043 6f6d 6d61 sign..12.4 Comma │ │ │ │ │ -000138f0: 6e64 204c 696e 6520 5769 6e64 6f77 0a3d nd Line Window.= │ │ │ │ │ +000127b0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a2a *************..* │ │ │ │ │ +000127c0: 204d 656e 753a 0a0a 2a20 496e 7472 6f64 Menu:..* Introd │ │ │ │ │ +000127d0: 7563 7469 6f6e 5f32 3a3a 0a2a 2053 7461 uction_2::.* Sta │ │ │ │ │ +000127e0: 7274 7570 2053 6571 7565 6e63 653a 3a0a rtup Sequence::. │ │ │ │ │ +000127f0: 2a20 4755 4920 436f 6d70 6f6e 656e 7473 * GUI Components │ │ │ │ │ +00012800: 3a3a 0a2a 2043 6f6d 6d61 6e64 204c 696e ::.* Command Lin │ │ │ │ │ +00012810: 6520 5769 6e64 6f77 3a3a 0a0a 1f0a 4669 e Window::....Fi │ │ │ │ │ +00012820: 6c65 3a20 6772 7562 2d64 6576 2e69 6e66 le: grub-dev.inf │ │ │ │ │ +00012830: 6f2c 2020 4e6f 6465 3a20 496e 7472 6f64 o, Node: Introd │ │ │ │ │ +00012840: 7563 7469 6f6e 5f32 2c20 204e 6578 743a uction_2, Next: │ │ │ │ │ +00012850: 2053 7461 7274 7570 2053 6571 7565 6e63 Startup Sequenc │ │ │ │ │ +00012860: 652c 2020 5570 3a20 4772 6170 6869 6361 e, Up: Graphica │ │ │ │ │ +00012870: 6c20 4d65 6e75 2053 6f66 7477 6172 6520 l Menu Software │ │ │ │ │ +00012880: 4465 7369 676e 0a0a 3132 2e31 2049 6e74 Design..12.1 Int │ │ │ │ │ +00012890: 726f 6475 6374 696f 6e0a 3d3d 3d3d 3d3d roduction.====== │ │ │ │ │ +000128a0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a54 6865 ===========..The │ │ │ │ │ +000128b0: 2027 6766 786d 656e 7527 206d 6f64 756c 'gfxmenu' modul │ │ │ │ │ +000128c0: 6520 7072 6f76 6964 6573 2061 2067 7261 e provides a gra │ │ │ │ │ +000128d0: 7068 6963 616c 206d 656e 7520 696e 7465 phical menu inte │ │ │ │ │ +000128e0: 7266 6163 6520 666f 7220 4752 5542 2032 rface for GRUB 2 │ │ │ │ │ +000128f0: 2e20 2049 740a 6675 6e63 7469 6f6e 7320 . It.functions │ │ │ │ │ +00012900: 6173 2061 6e20 616c 7465 726e 6174 6976 as an alternativ │ │ │ │ │ +00012910: 6520 746f 2074 6865 206d 656e 7520 696e e to the menu in │ │ │ │ │ +00012920: 7465 7266 6163 6520 7072 6f76 6964 6564 terface provided │ │ │ │ │ +00012930: 2062 7920 7468 650a 276e 6f72 6d61 6c27 by the.'normal' │ │ │ │ │ +00012940: 206d 6f64 756c 652c 2077 6869 6368 2075 module, which u │ │ │ │ │ +00012950: 7365 7320 7468 6520 6772 7562 2074 6572 ses the grub ter │ │ │ │ │ +00012960: 6d69 6e61 6c20 696e 7465 7266 6163 6520 minal interface │ │ │ │ │ +00012970: 746f 2064 6973 706c 6179 2061 0a6d 656e to display a.men │ │ │ │ │ +00012980: 7520 6f6e 2061 2063 6861 7261 6374 6572 u on a character │ │ │ │ │ +00012990: 2d6f 7269 656e 7465 6420 7465 726d 696e -oriented termin │ │ │ │ │ +000129a0: 616c 2e0a 0a20 2020 5468 6520 6772 6170 al... The grap │ │ │ │ │ +000129b0: 6869 6361 6c20 6d65 6e75 2075 7365 7320 hical menu uses │ │ │ │ │ +000129c0: 7468 6520 4752 5542 2076 6964 656f 2041 the GRUB video A │ │ │ │ │ +000129d0: 5049 2c20 7768 6963 6820 6973 2063 7572 PI, which is cur │ │ │ │ │ +000129e0: 7265 6e74 6c79 2066 6f72 0a74 6865 2056 rently for.the V │ │ │ │ │ +000129f0: 4553 4120 4249 4f53 2065 7874 656e 7369 ESA BIOS extensi │ │ │ │ │ +00012a00: 6f6e 7320 2856 4245 2920 322e 302b 2e20 ons (VBE) 2.0+. │ │ │ │ │ +00012a10: 2054 6869 7320 6973 2073 7570 706f 7274 This is support │ │ │ │ │ +00012a20: 6564 206f 6e20 7468 6520 6933 3836 2d70 ed on the i386-p │ │ │ │ │ +00012a30: 630a 706c 6174 666f 726d 2e20 2048 6f77 c.platform. How │ │ │ │ │ +00012a40: 6576 6572 2c20 7468 6520 6772 6170 6869 ever, the graphi │ │ │ │ │ +00012a50: 6361 6c20 6d65 6e75 2069 7473 656c 6620 cal menu itself │ │ │ │ │ +00012a60: 646f 6573 206e 6f74 2064 6570 656e 6420 does not depend │ │ │ │ │ +00012a70: 6f6e 2075 7369 6e67 0a56 4245 2c20 736f on using.VBE, so │ │ │ │ │ +00012a80: 2069 6620 616e 6f74 6865 7220 4752 5542 if another GRUB │ │ │ │ │ +00012a90: 2076 6964 656f 2064 7269 7665 7220 7765 video driver we │ │ │ │ │ +00012aa0: 7265 2069 6d70 6c65 6d65 6e74 6564 2c20 re implemented, │ │ │ │ │ +00012ab0: 7468 6520 2767 6678 6d65 6e75 270a 6772 the 'gfxmenu'.gr │ │ │ │ │ +00012ac0: 6170 6869 6361 6c20 6d65 6e75 2077 6f75 aphical menu wou │ │ │ │ │ +00012ad0: 6c64 2077 6f72 6b20 6f6e 2074 6865 206e ld work on the n │ │ │ │ │ +00012ae0: 6577 2076 6964 656f 2064 7269 7665 7220 ew video driver │ │ │ │ │ +00012af0: 6173 2077 656c 6c2e 0a0a 1f0a 4669 6c65 as well.....File │ │ │ │ │ +00012b00: 3a20 6772 7562 2d64 6576 2e69 6e66 6f2c : grub-dev.info, │ │ │ │ │ +00012b10: 2020 4e6f 6465 3a20 5374 6172 7475 7020 Node: Startup │ │ │ │ │ +00012b20: 5365 7175 656e 6365 2c20 204e 6578 743a Sequence, Next: │ │ │ │ │ +00012b30: 2047 5549 2043 6f6d 706f 6e65 6e74 732c GUI Components, │ │ │ │ │ +00012b40: 2020 5072 6576 3a20 496e 7472 6f64 7563 Prev: Introduc │ │ │ │ │ +00012b50: 7469 6f6e 5f32 2c20 2055 703a 2047 7261 tion_2, Up: Gra │ │ │ │ │ +00012b60: 7068 6963 616c 204d 656e 7520 536f 6674 phical Menu Soft │ │ │ │ │ +00012b70: 7761 7265 2044 6573 6967 6e0a 0a31 322e ware Design..12. │ │ │ │ │ +00012b80: 3220 5374 6172 7475 7020 5365 7175 656e 2 Startup Sequen │ │ │ │ │ +00012b90: 6365 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ce.============= │ │ │ │ │ +00012ba0: 3d3d 3d3d 3d3d 3d3d 0a0a 2020 202a 2067 ========.. * g │ │ │ │ │ +00012bb0: 7275 625f 656e 7465 725f 6e6f 726d 616c rub_enter_normal │ │ │ │ │ +00012bc0: 5f6d 6f64 6520 5b6e 6f72 6d61 6c2f 6d61 _mode [normal/ma │ │ │ │ │ +00012bd0: 696e 2e63 5d0a 2020 202a 2067 7275 625f in.c]. * grub_ │ │ │ │ │ +00012be0: 6e6f 726d 616c 5f65 7865 6375 7465 205b normal_execute [ │ │ │ │ │ +00012bf0: 6e6f 726d 616c 2f6d 6169 6e2e 635d 0a20 normal/main.c]. │ │ │ │ │ +00012c00: 2020 2a20 7265 6164 5f63 6f6e 6669 675f * read_config_ │ │ │ │ │ +00012c10: 6669 6c65 205b 6e6f 726d 616c 2f6d 6169 file [normal/mai │ │ │ │ │ +00012c20: 6e2e 635d 0a20 2020 2a20 2857 6865 6e20 n.c]. * (When │ │ │ │ │ +00012c30: 2767 6678 6d65 6e75 2e6d 6f64 2720 6973 'gfxmenu.mod' is │ │ │ │ │ +00012c40: 206c 6f61 6465 6420 7769 7468 2027 696e loaded with 'in │ │ │ │ │ +00012c50: 736d 6f64 272c 2069 7420 7769 6c6c 2063 smod', it will c │ │ │ │ │ +00012c60: 616c 6c0a 2020 2020 2027 6772 7562 5f6d all. 'grub_m │ │ │ │ │ +00012c70: 656e 755f 7669 6577 6572 5f72 6567 6973 enu_viewer_regis │ │ │ │ │ +00012c80: 7465 7228 2927 2074 6f20 7265 6769 7374 ter()' to regist │ │ │ │ │ +00012c90: 6572 2069 7473 656c 662e 290a 2020 202a er itself.). * │ │ │ │ │ +00012ca0: 2047 5255 425f 4d4f 445f 494e 4954 2028 GRUB_MOD_INIT ( │ │ │ │ │ +00012cb0: 6766 786d 656e 7529 205b 6766 786d 656e gfxmenu) [gfxmen │ │ │ │ │ +00012cc0: 752f 6766 786d 656e 752e 635d 0a20 2020 u/gfxmenu.c]. │ │ │ │ │ +00012cd0: 2a20 6772 7562 5f6d 656e 755f 7669 6577 * grub_menu_view │ │ │ │ │ +00012ce0: 6572 5f72 6567 6973 7465 7220 5b6b 6572 er_register [ker │ │ │ │ │ +00012cf0: 6e2f 6d65 6e75 5f76 6965 7765 722e 635d n/menu_viewer.c] │ │ │ │ │ +00012d00: 0a20 2020 2a20 6772 7562 5f6d 656e 755f . * grub_menu_ │ │ │ │ │ +00012d10: 7669 6577 6572 5f73 686f 775f 6d65 6e75 viewer_show_menu │ │ │ │ │ +00012d20: 205b 6b65 726e 2f6d 656e 755f 7669 6577 [kern/menu_view │ │ │ │ │ +00012d30: 6572 2e63 5d0a 2020 202a 2067 6574 5f63 er.c]. * get_c │ │ │ │ │ +00012d40: 7572 7265 6e74 5f6d 656e 755f 7669 6577 urrent_menu_view │ │ │ │ │ +00012d50: 6572 2829 205b 6b65 726e 2f6d 656e 755f er() [kern/menu_ │ │ │ │ │ +00012d60: 7669 6577 6572 2e63 5d0a 2020 202a 2073 viewer.c]. * s │ │ │ │ │ +00012d70: 686f 775f 6d65 6e75 2829 205b 6766 786d how_menu() [gfxm │ │ │ │ │ +00012d80: 656e 752f 6766 786d 656e 752e 635d 0a20 enu/gfxmenu.c]. │ │ │ │ │ +00012d90: 2020 2a20 6772 7562 5f67 6678 6d65 6e75 * grub_gfxmenu │ │ │ │ │ +00012da0: 5f6d 6f64 656c 5f6e 6577 205b 6766 786d _model_new [gfxm │ │ │ │ │ +00012db0: 656e 752f 6d6f 6465 6c2e 635d 0a20 2020 enu/model.c]. │ │ │ │ │ +00012dc0: 2a20 6772 7562 5f67 6678 6d65 6e75 5f76 * grub_gfxmenu_v │ │ │ │ │ +00012dd0: 6965 775f 6e65 7720 5b67 6678 6d65 6e75 iew_new [gfxmenu │ │ │ │ │ +00012de0: 2f76 6965 772e 635d 0a20 2020 2a20 7365 /view.c]. * se │ │ │ │ │ +00012df0: 745f 6772 6170 6869 6373 5f6d 6f64 6520 t_graphics_mode │ │ │ │ │ +00012e00: 5b67 6678 6d65 6e75 2f76 6965 772e 635d [gfxmenu/view.c] │ │ │ │ │ +00012e10: 0a20 2020 2a20 6772 7562 5f67 6678 6d65 . * grub_gfxme │ │ │ │ │ +00012e20: 6e75 5f76 6965 775f 6c6f 6164 5f74 6865 nu_view_load_the │ │ │ │ │ +00012e30: 6d65 205b 6766 786d 656e 752f 7468 656d me [gfxmenu/them │ │ │ │ │ +00012e40: 655f 6c6f 6164 6572 2e63 5d0a 0a1f 0a46 e_loader.c]....F │ │ │ │ │ +00012e50: 696c 653a 2067 7275 622d 6465 762e 696e ile: grub-dev.in │ │ │ │ │ +00012e60: 666f 2c20 204e 6f64 653a 2047 5549 2043 fo, Node: GUI C │ │ │ │ │ +00012e70: 6f6d 706f 6e65 6e74 732c 2020 4e65 7874 omponents, Next │ │ │ │ │ +00012e80: 3a20 436f 6d6d 616e 6420 4c69 6e65 2057 : Command Line W │ │ │ │ │ +00012e90: 696e 646f 772c 2020 5072 6576 3a20 5374 indow, Prev: St │ │ │ │ │ +00012ea0: 6172 7475 7020 5365 7175 656e 6365 2c20 artup Sequence, │ │ │ │ │ +00012eb0: 2055 703a 2047 7261 7068 6963 616c 204d Up: Graphical M │ │ │ │ │ +00012ec0: 656e 7520 536f 6674 7761 7265 2044 6573 enu Software Des │ │ │ │ │ +00012ed0: 6967 6e0a 0a31 322e 3320 4755 4920 436f ign..12.3 GUI Co │ │ │ │ │ +00012ee0: 6d70 6f6e 656e 7473 0a3d 3d3d 3d3d 3d3d mponents.======= │ │ │ │ │ +00012ef0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 5468 ============..Th │ │ │ │ │ +00012f00: 6520 6772 6170 6869 6361 6c20 6d65 6e75 e graphical menu │ │ │ │ │ +00012f10: 2069 6d70 6c65 6d65 6e74 7320 6120 4755 implements a GU │ │ │ │ │ +00012f20: 4920 636f 6d70 6f6e 656e 7420 7379 7374 I component syst │ │ │ │ │ +00012f30: 656d 2074 6861 7420 7375 7070 6f72 7473 em that supports │ │ │ │ │ +00012f40: 2061 0a63 6f6e 7461 696e 6572 2d62 6173 a.container-bas │ │ │ │ │ +00012f50: 6564 206c 6179 6f75 7420 7379 7374 656d ed layout system │ │ │ │ │ +00012f60: 2e20 2043 6f6d 706f 6e65 6e74 7320 6361 . Components ca │ │ │ │ │ +00012f70: 6e20 6265 2061 6464 6564 2074 6f20 636f n be added to co │ │ │ │ │ +00012f80: 6e74 6169 6e65 7273 2c0a 616e 6420 636f ntainers,.and co │ │ │ │ │ +00012f90: 6e74 6169 6e65 7273 2028 7768 6963 6820 ntainers (which │ │ │ │ │ +00012fa0: 6172 6520 6120 7479 7065 206f 6620 636f are a type of co │ │ │ │ │ +00012fb0: 6d70 6f6e 656e 7429 2063 616e 2074 6865 mponent) can the │ │ │ │ │ +00012fc0: 6e20 6265 2061 6464 6564 2074 6f0a 6f74 n be added to.ot │ │ │ │ │ +00012fd0: 6865 7220 636f 6e74 6169 6e65 7273 2c20 her containers, │ │ │ │ │ +00012fe0: 746f 2066 6f72 6d20 6120 7472 6565 206f to form a tree o │ │ │ │ │ +00012ff0: 6620 636f 6d70 6f6e 656e 7473 2e20 2043 f components. C │ │ │ │ │ +00013000: 7572 7265 6e74 6c79 2c20 7468 6520 726f urrently, the ro │ │ │ │ │ +00013010: 6f74 0a63 6f6d 706f 6e65 6e74 206f 6620 ot.component of │ │ │ │ │ +00013020: 7468 6973 2074 7265 6520 6973 2061 2027 this tree is a ' │ │ │ │ │ +00013030: 6361 6e76 6173 2720 636f 6d70 6f6e 656e canvas' componen │ │ │ │ │ +00013040: 742c 2077 6869 6368 2061 6c6c 6f77 7320 t, which allows │ │ │ │ │ +00013050: 6d61 6e75 616c 0a6c 6179 6f75 7420 6f66 manual.layout of │ │ │ │ │ +00013060: 2069 7473 2063 6869 6c64 2063 6f6d 706f its child compo │ │ │ │ │ +00013070: 6e65 6e74 732e 0a0a 2020 2043 6f6d 706f nents... Compo │ │ │ │ │ +00013080: 6e65 6e74 7320 286e 6f6e 2d63 6f6e 7461 nents (non-conta │ │ │ │ │ +00013090: 696e 6572 293a 0a0a 2020 202a 206c 6162 iner):.. * lab │ │ │ │ │ +000130a0: 656c 0a20 2020 2a20 696d 6167 650a 2020 el. * image. │ │ │ │ │ +000130b0: 202a 2070 726f 6772 6573 735f 6261 720a * progress_bar. │ │ │ │ │ +000130c0: 2020 202a 2063 6972 6375 6c61 725f 7072 * circular_pr │ │ │ │ │ +000130d0: 6f67 7265 7373 0a20 2020 2a20 6c69 7374 ogress. * list │ │ │ │ │ +000130e0: 2028 6375 7272 656e 746c 7920 6861 7264 (currently hard │ │ │ │ │ +000130f0: 2063 6f64 6564 2074 6f20 6265 2061 2062 coded to be a b │ │ │ │ │ +00013100: 6f6f 7420 6d65 6e75 206c 6973 7429 0a0a oot menu list).. │ │ │ │ │ +00013110: 2020 2043 6f6e 7461 696e 6572 733a 0a0a Containers:.. │ │ │ │ │ +00013120: 2020 202a 2063 616e 7661 730a 2020 202a * canvas. * │ │ │ │ │ +00013130: 2068 626f 780a 2020 202a 2076 626f 780a hbox. * vbox. │ │ │ │ │ +00013140: 0a20 2020 5468 6520 4755 4920 636f 6d70 . The GUI comp │ │ │ │ │ +00013150: 6f6e 656e 7420 696e 7374 616e 6365 7320 onent instances │ │ │ │ │ +00013160: 6172 6520 6372 6561 7465 6420 6279 2074 are created by t │ │ │ │ │ +00013170: 6865 2074 6865 6d65 206c 6f61 6465 7220 he theme loader │ │ │ │ │ +00013180: 696e 0a27 6766 786d 656e 752f 7468 656d in.'gfxmenu/them │ │ │ │ │ +00013190: 655f 6c6f 6164 6572 2e63 2720 7768 656e e_loader.c' when │ │ │ │ │ +000131a0: 2061 2074 6865 6d65 2069 7320 6c6f 6164 a theme is load │ │ │ │ │ +000131b0: 6564 2e20 2054 6865 6d65 2066 696c 6573 ed. Theme files │ │ │ │ │ +000131c0: 2073 7065 6369 6679 0a73 7461 7465 6d65 specify.stateme │ │ │ │ │ +000131d0: 6e74 7320 7375 6368 2061 7320 272b 7662 nts such as '+vb │ │ │ │ │ +000131e0: 6f78 7b20 2b6c 6162 656c 207b 2074 6578 ox{ +label { tex │ │ │ │ │ +000131f0: 743d 2248 656c 6c6f 2220 7d20 2b6c 6162 t="Hello" } +lab │ │ │ │ │ +00013200: 656c 7b20 7465 7874 3d22 576f 726c 6422 el{ text="World" │ │ │ │ │ +00013210: 0a7d 207d 2720 746f 2061 6464 2063 6f6d .} }' to add com │ │ │ │ │ +00013220: 706f 6e65 6e74 7320 746f 2074 6865 2063 ponents to the c │ │ │ │ │ +00013230: 6f6d 706f 6e65 6e74 2074 7265 6520 726f omponent tree ro │ │ │ │ │ +00013240: 6f74 2e20 2042 7920 6e65 7374 696e 6720 ot. By nesting │ │ │ │ │ +00013250: 7468 650a 636f 6d70 6f6e 656e 7420 6372 the.component cr │ │ │ │ │ +00013260: 6561 7469 6f6e 2073 7461 7465 6d65 6e74 eation statement │ │ │ │ │ +00013270: 7320 696e 2074 6865 2074 6865 6d65 2066 s in the theme f │ │ │ │ │ +00013280: 696c 652c 2074 6865 2069 6e73 7461 6e74 ile, the instant │ │ │ │ │ +00013290: 6961 7465 640a 636f 6d70 6f6e 656e 7473 iated.components │ │ │ │ │ +000132a0: 2061 7265 206e 6573 7465 6420 7468 6520 are nested the │ │ │ │ │ +000132b0: 7361 6d65 2077 6179 2e0a 0a20 2020 5768 same way... Wh │ │ │ │ │ +000132c0: 656e 2061 2063 6f6d 706f 6e65 6e74 2069 en a component i │ │ │ │ │ +000132d0: 7320 6164 6465 6420 746f 2061 2063 6f6e s added to a con │ │ │ │ │ +000132e0: 7461 696e 6572 2c20 7468 6174 206e 6577 tainer, that new │ │ │ │ │ +000132f0: 2063 6869 6c64 2069 730a 636f 6e73 6964 child is.consid │ │ │ │ │ +00013300: 6572 6564 202a 6f77 6e65 642a 2062 7920 ered *owned* by │ │ │ │ │ +00013310: 7468 6520 636f 6e74 6169 6e65 722e 2020 the container. │ │ │ │ │ +00013320: 4772 6561 7420 6361 7265 2073 686f 756c Great care shoul │ │ │ │ │ +00013330: 6420 6265 2074 616b 656e 2069 6620 7468 d be taken if th │ │ │ │ │ +00013340: 650a 6361 6c6c 6572 2072 6574 6169 6e73 e.caller retains │ │ │ │ │ +00013350: 2061 2072 6566 6572 656e 6365 2074 6f20 a reference to │ │ │ │ │ +00013360: 7468 6520 6368 696c 6420 636f 6d70 6f6e the child compon │ │ │ │ │ +00013370: 656e 742c 2073 696e 6365 2069 7420 7769 ent, since it wi │ │ │ │ │ +00013380: 6c6c 2062 650a 6465 7374 726f 7965 6420 ll be.destroyed │ │ │ │ │ +00013390: 6966 2069 7473 2070 6172 656e 7420 636f if its parent co │ │ │ │ │ +000133a0: 6e74 6169 6e65 7220 6973 2064 6573 7472 ntainer is destr │ │ │ │ │ +000133b0: 6f79 6564 2e20 2041 2062 6574 7465 7220 oyed. A better │ │ │ │ │ +000133c0: 6368 6f69 6365 2069 6e73 7465 6164 0a6f choice instead.o │ │ │ │ │ +000133d0: 6620 7374 6f72 696e 6720 6120 706f 696e f storing a poin │ │ │ │ │ +000133e0: 7465 7220 746f 2074 6865 2063 6869 6c64 ter to the child │ │ │ │ │ +000133f0: 2063 6f6d 706f 6e65 6e74 2069 7320 746f component is to │ │ │ │ │ +00013400: 2075 7365 2074 6865 2063 6f6d 706f 6e65 use the compone │ │ │ │ │ +00013410: 6e74 2049 440a 746f 2066 696e 6420 7468 nt ID.to find th │ │ │ │ │ +00013420: 6520 6465 7369 7265 6420 636f 6d70 6f6e e desired compon │ │ │ │ │ +00013430: 656e 742e 2020 436f 6d70 6f6e 656e 7420 ent. Component │ │ │ │ │ +00013440: 4944 7320 646f 206e 6f74 2068 6176 6520 IDs do not have │ │ │ │ │ +00013450: 746f 2062 6520 756e 6971 7565 0a28 6974 to be unique.(it │ │ │ │ │ +00013460: 2069 7320 6f66 7465 6e20 7573 6566 756c is often useful │ │ │ │ │ +00013470: 2074 6f20 6861 7665 206d 756c 7469 706c to have multipl │ │ │ │ │ +00013480: 6520 636f 6d70 6f6e 656e 7473 2077 6974 e components wit │ │ │ │ │ +00013490: 6820 616e 2049 4420 6f66 0a22 5f5f 7469 h an ID of."__ti │ │ │ │ │ +000134a0: 6d65 6f75 745f 5f22 2c20 666f 7220 696e meout__", for in │ │ │ │ │ +000134b0: 7374 616e 6365 292e 0a0a 2020 2049 6e20 stance)... In │ │ │ │ │ +000134c0: 6f72 6465 7220 746f 2061 6363 6573 7320 order to access │ │ │ │ │ +000134d0: 616e 6420 7573 6520 636f 6d70 6f6e 656e and use componen │ │ │ │ │ +000134e0: 7473 2069 6e20 7468 6520 636f 6d70 6f6e ts in the compon │ │ │ │ │ +000134f0: 656e 7420 7472 6565 2c20 7468 6572 650a ent tree, there. │ │ │ │ │ +00013500: 6172 6520 7477 6f20 6675 6e63 7469 6f6e are two function │ │ │ │ │ +00013510: 7320 2864 6566 696e 6564 2069 6e20 2767 s (defined in 'g │ │ │ │ │ +00013520: 6678 6d65 6e75 2f67 7569 5f75 7469 6c2e fxmenu/gui_util. │ │ │ │ │ +00013530: 6327 2920 7468 6174 2061 7265 0a70 6172 c') that are.par │ │ │ │ │ +00013540: 7469 6375 6c61 726c 7920 7573 6566 756c ticularly useful │ │ │ │ │ +00013550: 3a0a 0a20 2020 2a20 2767 7275 625f 6775 :.. * 'grub_gu │ │ │ │ │ +00013560: 695f 6669 6e64 5f62 795f 6964 2028 726f i_find_by_id (ro │ │ │ │ │ +00013570: 6f74 2c20 6964 2c20 6361 6c6c 6261 636b ot, id, callback │ │ │ │ │ +00013580: 2c20 7573 6572 6461 7461 2927 3a0a 0a20 , userdata)':.. │ │ │ │ │ +00013590: 2020 2020 5468 6973 2066 756e 6374 696f This functio │ │ │ │ │ +000135a0: 6e20 6563 7572 7369 7665 6c79 2074 7261 n ecursively tra │ │ │ │ │ +000135b0: 7665 7273 6573 2074 6865 2063 6f6d 706f verses the compo │ │ │ │ │ +000135c0: 6e65 6e74 2074 7265 6520 726f 6f74 6564 nent tree rooted │ │ │ │ │ +000135d0: 2061 740a 2020 2020 2052 4f4f 542c 2061 at. ROOT, a │ │ │ │ │ +000135e0: 6e64 2066 6f72 2065 7665 7279 2063 6f6d nd for every com │ │ │ │ │ +000135f0: 706f 6e65 6e74 2074 6861 7420 6861 7320 ponent that has │ │ │ │ │ +00013600: 616e 2049 4420 6571 7561 6c20 746f 2049 an ID equal to I │ │ │ │ │ +00013610: 442c 2063 616c 6c73 2074 6865 0a20 2020 D, calls the. │ │ │ │ │ +00013620: 2020 6675 6e63 7469 6f6e 2070 6f69 6e74 function point │ │ │ │ │ +00013630: 6564 2074 6f20 6279 2043 414c 4c42 4143 ed to by CALLBAC │ │ │ │ │ +00013640: 4b20 7769 7468 2074 6865 206d 6174 6368 K with the match │ │ │ │ │ +00013650: 696e 6720 636f 6d70 6f6e 656e 7420 616e ing component an │ │ │ │ │ +00013660: 6420 7468 650a 2020 2020 2076 6f69 6420 d the. void │ │ │ │ │ +00013670: 706f 696e 7465 7220 5553 4552 4441 5441 pointer USERDATA │ │ │ │ │ +00013680: 2061 7320 6172 6775 6d65 6e74 732e 2020 as arguments. │ │ │ │ │ +00013690: 5468 6520 6361 6c6c 6261 636b 2066 756e The callback fun │ │ │ │ │ +000136a0: 6374 696f 6e20 6361 6e20 646f 0a20 2020 ction can do. │ │ │ │ │ +000136b0: 2020 7768 6174 6576 6572 2069 7320 6465 whatever is de │ │ │ │ │ +000136c0: 7369 7265 6420 746f 2075 7365 2074 6865 sired to use the │ │ │ │ │ +000136d0: 2063 6f6d 706f 6e65 6e74 2070 6173 7365 component passe │ │ │ │ │ +000136e0: 6420 696e 2e0a 0a20 2020 2a20 2767 7275 d in... * 'gru │ │ │ │ │ +000136f0: 625f 6775 695f 6974 6572 6174 655f 7265 b_gui_iterate_re │ │ │ │ │ +00013700: 6375 7273 6976 656c 7920 2872 6f6f 742c cursively (root, │ │ │ │ │ +00013710: 2063 616c 6c62 6163 6b2c 2075 7365 7264 callback, userd │ │ │ │ │ +00013720: 6174 6129 273a 0a0a 2020 2020 2054 6869 ata)':.. Thi │ │ │ │ │ +00013730: 7320 6675 6e63 7469 6f6e 2063 616c 6c73 s function calls │ │ │ │ │ +00013740: 2074 6865 2066 756e 6374 696f 6e20 706f the function po │ │ │ │ │ +00013750: 696e 7465 6420 746f 2062 7920 4341 4c4c inted to by CALL │ │ │ │ │ +00013760: 4241 434b 2066 6f72 2065 7665 7279 0a20 BACK for every. │ │ │ │ │ +00013770: 2020 2020 636f 6d70 6f6e 656e 7420 7468 component th │ │ │ │ │ +00013780: 6174 2069 7320 6120 6465 7363 656e 6461 at is a descenda │ │ │ │ │ +00013790: 6e74 206f 6620 524f 4f54 2069 6e20 7468 nt of ROOT in th │ │ │ │ │ +000137a0: 6520 636f 6d70 6f6e 656e 7420 7472 6565 e component tree │ │ │ │ │ +000137b0: 2e20 2057 6865 6e0a 2020 2020 2074 6865 . When. the │ │ │ │ │ +000137c0: 2063 616c 6c62 6163 6b20 6675 6e63 7469 callback functi │ │ │ │ │ +000137d0: 6f6e 2069 7320 6361 6c6c 6564 2c20 7468 on is called, th │ │ │ │ │ +000137e0: 6520 636f 6d70 6f6e 656e 7420 616e 6420 e component and │ │ │ │ │ +000137f0: 7468 6520 766f 6964 2070 6f69 6e74 6572 the void pointer │ │ │ │ │ +00013800: 0a20 2020 2020 5553 4552 4441 5441 2061 . USERDATA a │ │ │ │ │ +00013810: 7320 6172 6775 6d65 6e74 732e 2020 5468 s arguments. Th │ │ │ │ │ +00013820: 6520 6361 6c6c 6261 636b 2066 756e 6374 e callback funct │ │ │ │ │ +00013830: 696f 6e20 6361 6e20 646f 2077 6861 7465 ion can do whate │ │ │ │ │ +00013840: 7665 7220 6973 0a20 2020 2020 6465 7369 ver is. desi │ │ │ │ │ +00013850: 7265 6420 746f 2075 7365 2074 6865 2063 red to use the c │ │ │ │ │ +00013860: 6f6d 706f 6e65 6e74 2070 6173 7365 6420 omponent passed │ │ │ │ │ +00013870: 696e 2e0a 0a1f 0a46 696c 653a 2067 7275 in.....File: gru │ │ │ │ │ +00013880: 622d 6465 762e 696e 666f 2c20 204e 6f64 b-dev.info, Nod │ │ │ │ │ +00013890: 653a 2043 6f6d 6d61 6e64 204c 696e 6520 e: Command Line │ │ │ │ │ +000138a0: 5769 6e64 6f77 2c20 2050 7265 763a 2047 Window, Prev: G │ │ │ │ │ +000138b0: 5549 2043 6f6d 706f 6e65 6e74 732c 2020 UI Components, │ │ │ │ │ +000138c0: 5570 3a20 4772 6170 6869 6361 6c20 4d65 Up: Graphical Me │ │ │ │ │ +000138d0: 6e75 2053 6f66 7477 6172 6520 4465 7369 nu Software Desi │ │ │ │ │ +000138e0: 676e 0a0a 3132 2e34 2043 6f6d 6d61 6e64 gn..12.4 Command │ │ │ │ │ +000138f0: 204c 696e 6520 5769 6e64 6f77 0a3d 3d3d Line Window.=== │ │ │ │ │ 00013900: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00013910: 3d3d 3d3d 3d3d 3d0a 0a54 6865 2074 6572 =======..The ter │ │ │ │ │ -00013920: 6d69 6e61 6c20 7769 6e64 6f77 2075 7365 minal window use │ │ │ │ │ -00013930: 6420 746f 2070 726f 7669 6465 2063 6f6d d to provide com │ │ │ │ │ -00013940: 6d61 6e64 206c 696e 6520 6163 6365 7373 mand line access │ │ │ │ │ -00013950: 2077 6974 6869 6e20 7468 650a 6772 6170 within the.grap │ │ │ │ │ -00013960: 6869 6361 6c20 6d65 6e75 2069 7320 6d61 hical menu is ma │ │ │ │ │ -00013970: 6e61 6765 6420 6279 2027 6766 786d 656e naged by 'gfxmen │ │ │ │ │ -00013980: 752f 7669 6577 2e63 272e 2020 5468 6520 u/view.c'. The │ │ │ │ │ -00013990: 2767 6678 7465 726d 2720 7465 726d 696e 'gfxterm' termin │ │ │ │ │ -000139a0: 616c 0a69 7320 7573 6564 2c20 616e 6420 al.is used, and │ │ │ │ │ -000139b0: 6974 2068 6173 2062 6565 6e20 6d6f 6469 it has been modi │ │ │ │ │ -000139c0: 6669 6564 2074 6f20 616c 6c6f 7720 7265 fied to allow re │ │ │ │ │ -000139d0: 6e64 6572 696e 6720 746f 2061 6e20 6f66 ndering to an of │ │ │ │ │ -000139e0: 6673 6372 6565 6e0a 7265 6e64 6572 2074 fscreen.render t │ │ │ │ │ -000139f0: 6172 6765 7420 746f 2061 6c6c 6f77 2069 arget to allow i │ │ │ │ │ -00013a00: 7420 746f 2062 6520 636f 6d70 6f73 6564 t to be composed │ │ │ │ │ -00013a10: 2069 6e74 6f20 7468 6520 646f 7562 6c65 into the double │ │ │ │ │ -00013a20: 2062 7566 6665 7269 6e67 0a73 7973 7465 buffering.syste │ │ │ │ │ -00013a30: 6d20 7468 6174 2074 6865 2067 7261 7068 m that the graph │ │ │ │ │ -00013a40: 6963 616c 206d 656e 7520 7669 6577 2075 ical menu view u │ │ │ │ │ -00013a50: 7365 732e 2020 5468 6973 2069 7320 6261 ses. This is ba │ │ │ │ │ -00013a60: 6420 666f 7220 7065 7266 6f72 6d61 6e63 d for performanc │ │ │ │ │ -00013a70: 652c 0a68 6f77 6576 6572 2c20 736f 2069 e,.however, so i │ │ │ │ │ -00013a80: 7420 776f 756c 6420 7072 6f62 6162 6c79 t would probably │ │ │ │ │ -00013a90: 2062 6520 6120 676f 6f64 2069 6465 6120 be a good idea │ │ │ │ │ -00013aa0: 746f 206d 616b 6520 6974 2070 6f73 7369 to make it possi │ │ │ │ │ -00013ab0: 626c 6520 746f 0a74 656d 706f 7261 7269 ble to.temporari │ │ │ │ │ -00013ac0: 6c79 2064 6973 6162 6c65 2064 6f75 626c ly disable doubl │ │ │ │ │ -00013ad0: 6520 6275 6666 6572 696e 6720 6173 206c e buffering as l │ │ │ │ │ -00013ae0: 6f6e 6720 6173 2074 6865 2074 6572 6d69 ong as the termi │ │ │ │ │ -00013af0: 6e61 6c20 7769 6e64 6f77 2069 730a 7669 nal window is.vi │ │ │ │ │ -00013b00: 7369 626c 652e 2020 5468 6572 6520 6172 sible. There ar │ │ │ │ │ -00013b10: 6520 7374 696c 6c20 756e 7265 736f 6c76 e still unresolv │ │ │ │ │ -00013b20: 6564 2070 726f 626c 656d 7320 7468 6174 ed problems that │ │ │ │ │ -00013b30: 206f 6363 7572 2077 6865 6e20 636f 6d6d occur when comm │ │ │ │ │ -00013b40: 616e 6473 0a61 7265 2065 7865 6375 7465 ands.are execute │ │ │ │ │ -00013b50: 6420 6672 6f6d 2074 6865 2074 6572 6d69 d from the termi │ │ │ │ │ -00013b60: 6e61 6c20 7769 6e64 6f77 2074 6861 7420 nal window that │ │ │ │ │ -00013b70: 6368 616e 6765 2074 6865 2067 7261 7068 change the graph │ │ │ │ │ -00013b80: 6963 7320 6d6f 6465 2e0a 4974 2773 2070 ics mode..It's p │ │ │ │ │ -00013b90: 6f73 7369 626c 6520 7468 6174 206d 616b ossible that mak │ │ │ │ │ -00013ba0: 696e 6720 2767 7275 625f 7669 6465 6f5f ing 'grub_video_ │ │ │ │ │ -00013bb0: 7265 7374 6f72 6528 2927 2072 6574 7572 restore()' retur │ │ │ │ │ -00013bc0: 6e20 746f 2074 6865 2067 7261 7068 6963 n to the graphic │ │ │ │ │ -00013bd0: 730a 6d6f 6465 2074 6861 7420 7761 7320 s.mode that was │ │ │ │ │ -00013be0: 696e 2075 7365 2062 6566 6f72 6520 2767 in use before 'g │ │ │ │ │ -00013bf0: 7275 625f 7669 6465 6f5f 7365 7475 7028 rub_video_setup( │ │ │ │ │ -00013c00: 2927 2077 6173 2063 616c 6c65 6420 6d69 )' was called mi │ │ │ │ │ -00013c10: 6768 7420 6669 780a 736f 6d65 206f 6620 ght fix.some of │ │ │ │ │ -00013c20: 7468 6520 7072 6f62 6c65 6d73 2e0a 0a1f the problems.... │ │ │ │ │ -00013c30: 0a46 696c 653a 2067 7275 622d 6465 762e .File: grub-dev. │ │ │ │ │ -00013c40: 696e 666f 2c20 204e 6f64 653a 2056 6572 info, Node: Ver │ │ │ │ │ -00013c50: 6966 6965 7273 2066 7261 6d65 776f 726b ifiers framework │ │ │ │ │ -00013c60: 2c20 204e 6578 743a 204c 6f63 6b64 6f77 , Next: Lockdow │ │ │ │ │ -00013c70: 6e20 6672 616d 6577 6f72 6b2c 2020 5072 n framework, Pr │ │ │ │ │ -00013c80: 6576 3a20 4772 6170 6869 6361 6c20 4d65 ev: Graphical Me │ │ │ │ │ -00013c90: 6e75 2053 6f66 7477 6172 6520 4465 7369 nu Software Desi │ │ │ │ │ -00013ca0: 676e 2c20 2055 703a 2054 6f70 0a0a 3133 gn, Up: Top..13 │ │ │ │ │ -00013cb0: 2056 6572 6966 6965 7273 2066 7261 6d65 Verifiers frame │ │ │ │ │ -00013cc0: 776f 726b 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a work.*********** │ │ │ │ │ -00013cd0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a54 6f20 ***********..To │ │ │ │ │ -00013ce0: 7265 6769 7374 6572 2079 6f75 7220 6f77 register your ow │ │ │ │ │ -00013cf0: 6e20 7665 7269 6669 6572 2063 616c 6c20 n verifier call │ │ │ │ │ -00013d00: 2767 7275 625f 7665 7269 6669 6572 5f72 'grub_verifier_r │ │ │ │ │ -00013d10: 6567 6973 7465 7227 2077 6974 6820 610a egister' with a. │ │ │ │ │ -00013d20: 7374 7275 6374 7572 6520 706f 696e 7469 structure pointi │ │ │ │ │ -00013d30: 6e67 2074 6f20 796f 7572 2066 756e 6374 ng to your funct │ │ │ │ │ -00013d40: 696f 6e73 2e0a 0a20 2020 5468 6520 696e ions... The in │ │ │ │ │ -00013d50: 7465 7266 6163 6520 6973 2069 6e73 7069 terface is inspi │ │ │ │ │ -00013d60: 7265 6420 6279 2074 6865 2068 6173 6820 red by the hash │ │ │ │ │ -00013d70: 696e 7465 7266 6163 6520 7769 7468 0a27 interface with.' │ │ │ │ │ -00013d80: 696e 6974 272f 2777 7269 7465 272f 2766 init'/'write'/'f │ │ │ │ │ -00013d90: 696e 6927 2e0a 0a20 2020 5468 6572 6520 ini'... There │ │ │ │ │ -00013da0: 6172 6520 6573 7365 6e74 6961 6c6c 7920 are essentially │ │ │ │ │ -00013db0: 3220 7761 7973 206f 6620 7573 696e 6720 2 ways of using │ │ │ │ │ -00013dc0: 6974 2c20 6861 7368 696e 6720 616e 6420 it, hashing and │ │ │ │ │ -00013dd0: 7768 6f6c 652d 6669 6c65 0a76 6572 6966 whole-file.verif │ │ │ │ │ -00013de0: 6963 6174 696f 6e2e 0a0a 2020 2057 6974 ication... Wit │ │ │ │ │ -00013df0: 6820 7468 6520 6861 7368 696e 6720 6170 h the hashing ap │ │ │ │ │ -00013e00: 7072 6f61 6368 3a20 4475 7269 6e67 2027 proach: During ' │ │ │ │ │ -00013e10: 696e 6974 2720 796f 7520 6465 6369 6465 init' you decide │ │ │ │ │ -00013e20: 2077 6865 7468 6572 2079 6f75 2077 616e whether you wan │ │ │ │ │ -00013e30: 740a 746f 2063 6865 636b 2074 6865 2067 t.to check the g │ │ │ │ │ -00013e40: 6976 656e 2066 696c 6520 616e 6420 696e iven file and in │ │ │ │ │ -00013e50: 6974 2063 6f6e 7465 7874 2e20 2049 6e20 it context. In │ │ │ │ │ -00013e60: 2777 7269 7465 2720 796f 7520 7570 6461 'write' you upda │ │ │ │ │ -00013e70: 7465 2079 6f75 720a 6861 7368 696e 6720 te your.hashing │ │ │ │ │ -00013e80: 7374 6174 652e 2020 496e 2027 6669 6e69 state. In 'fini │ │ │ │ │ -00013e90: 2720 796f 7520 6368 6563 6b20 7468 6174 ' you check that │ │ │ │ │ -00013ea0: 2074 6865 2068 6173 6820 6d61 7463 6865 the hash matche │ │ │ │ │ -00013eb0: 7320 7468 6520 6578 7065 6374 6564 0a76 s the expected.v │ │ │ │ │ -00013ec0: 616c 7565 2f70 6173 7365 7320 736f 6d65 alue/passes some │ │ │ │ │ -00013ed0: 2063 6865 636b 2f2e 2e2e 0a0a 2020 2057 check/..... W │ │ │ │ │ -00013ee0: 6974 6820 7768 6f6c 652d 6669 6c65 2076 ith whole-file v │ │ │ │ │ -00013ef0: 6572 6966 6963 6174 696f 6e3a 2044 7572 erification: Dur │ │ │ │ │ -00013f00: 696e 6720 2769 6e69 7427 2079 6f75 2064 ing 'init' you d │ │ │ │ │ -00013f10: 6563 6964 6520 7768 6574 6865 7220 796f ecide whether yo │ │ │ │ │ -00013f20: 750a 7761 6e74 2074 6f20 6368 6563 6b20 u.want to check │ │ │ │ │ -00013f30: 7468 6520 6769 7665 6e20 6669 6c65 2061 the given file a │ │ │ │ │ -00013f40: 6e64 2069 6e69 7420 636f 6e74 6578 742e nd init context. │ │ │ │ │ -00013f50: 2020 496e 2027 7772 6974 6527 2079 6f75 In 'write' you │ │ │ │ │ -00013f60: 2076 6572 6966 790a 7468 6520 6669 6c65 verify.the file │ │ │ │ │ -00013f70: 2061 6e64 2072 6574 7572 6e20 616e 2065 and return an e │ │ │ │ │ -00013f80: 7272 6f72 2069 6620 6974 2066 6169 6c73 rror if it fails │ │ │ │ │ -00013f90: 2e20 2059 6f75 2064 6f6e 2774 2068 6176 . You don't hav │ │ │ │ │ -00013fa0: 6520 2766 696e 6927 2e0a 0a20 2020 4164 e 'fini'... Ad │ │ │ │ │ -00013fb0: 6469 7469 6f6e 616c 2027 7665 7269 6679 ditional 'verify │ │ │ │ │ -00013fc0: 5f73 7472 696e 6727 2072 6563 6569 7665 _string' receive │ │ │ │ │ -00013fd0: 7320 7661 7269 6f75 7320 7374 7269 6e67 s various string │ │ │ │ │ -00013fe0: 7320 6c69 6b65 206b 6572 6e65 6c0a 7061 s like kernel.pa │ │ │ │ │ -00013ff0: 7261 6d65 7465 7273 2074 6f20 7665 7269 rameters to veri │ │ │ │ │ -00014000: 6679 2e20 2052 6574 7572 6e69 6e67 206e fy. Returning n │ │ │ │ │ -00014010: 6f20 6572 726f 7220 6d65 616e 7320 7375 o error means su │ │ │ │ │ -00014020: 6363 6573 7366 756c 2076 6572 6966 6963 ccessful verific │ │ │ │ │ -00014030: 6174 696f 6e0a 616e 6420 616e 2065 7272 ation.and an err │ │ │ │ │ -00014040: 6f72 2073 746f 7073 2074 6865 2063 7572 or stops the cur │ │ │ │ │ -00014050: 7265 6e74 2061 6374 696f 6e2e 0a0a 2020 rent action... │ │ │ │ │ -00014060: 2044 6574 6169 6c65 6420 6465 7363 7269 Detailed descri │ │ │ │ │ -00014070: 7074 696f 6e20 6f66 2074 6865 2041 5049 ption of the API │ │ │ │ │ -00014080: 3a0a 0a20 2020 4576 6572 7920 7469 6d65 :.. Every time │ │ │ │ │ -00014090: 2061 2066 696c 6520 6973 206f 7065 6e65 a file is opene │ │ │ │ │ -000140a0: 6420 796f 7572 2027 696e 6974 2720 6675 d your 'init' fu │ │ │ │ │ -000140b0: 6e63 7469 6f6e 2069 7320 6361 6c6c 6564 nction is called │ │ │ │ │ -000140c0: 2077 6974 6820 6669 6c65 0a64 6573 6372 with file.descr │ │ │ │ │ -000140d0: 6970 746f 7220 616e 6420 6669 6c65 2074 iptor and file t │ │ │ │ │ -000140e0: 7970 652e 2020 596f 7572 2066 756e 6374 ype. Your funct │ │ │ │ │ -000140f0: 696f 6e20 6361 6e20 6861 7665 2074 6865 ion can have the │ │ │ │ │ -00014100: 2066 6f6c 6c6f 7769 6e67 0a6f 7574 636f following.outco │ │ │ │ │ -00014110: 6d65 733a 0a0a 2020 202a 2072 6574 7572 mes:.. * retur │ │ │ │ │ -00014120: 6e69 6e67 206e 6f20 6572 726f 7220 616e ning no error an │ │ │ │ │ -00014130: 6420 7365 7474 696e 6720 272a 666c 6167 d setting '*flag │ │ │ │ │ -00014140: 7327 2074 6f0a 2020 2020 2027 4752 5542 s' to. 'GRUB │ │ │ │ │ -00014150: 5f56 4552 4946 595f 464c 4147 535f 4445 _VERIFY_FLAGS_DE │ │ │ │ │ -00014160: 4645 525f 4155 5448 272e 2020 496e 2074 FER_AUTH'. In t │ │ │ │ │ -00014170: 6869 7320 6361 7365 2076 6572 6966 6963 his case verific │ │ │ │ │ -00014180: 6174 696f 6e20 6973 0a20 2020 2020 6465 ation is. de │ │ │ │ │ -00014190: 6665 7272 6564 2074 6f20 6f74 6865 7220 ferred to other │ │ │ │ │ -000141a0: 6163 7469 7665 2076 6572 6966 6965 7273 active verifiers │ │ │ │ │ -000141b0: 2e20 2056 6572 6966 6963 6174 696f 6e20 . Verification │ │ │ │ │ -000141c0: 6661 696c 7320 6966 206e 6f62 6f64 790a fails if nobody. │ │ │ │ │ -000141d0: 2020 2020 2063 6172 6573 206f 7220 7365 cares or se │ │ │ │ │ -000141e0: 6c65 6374 6564 2076 6572 6966 6965 7220 lected verifier │ │ │ │ │ -000141f0: 6661 696c 732e 0a0a 2020 202a 2072 6574 fails... * ret │ │ │ │ │ -00014200: 7572 6e69 6e67 206e 6f20 6572 726f 7220 urning no error │ │ │ │ │ -00014210: 616e 6420 7365 7474 696e 6720 272a 666c and setting '*fl │ │ │ │ │ -00014220: 6167 7327 2074 6f0a 2020 2020 2027 4752 ags' to. 'GR │ │ │ │ │ -00014230: 5542 5f56 4552 4946 595f 464c 4147 535f UB_VERIFY_FLAGS_ │ │ │ │ │ -00014240: 534b 4950 5f56 4552 4946 4943 4154 494f SKIP_VERIFICATIO │ │ │ │ │ -00014250: 4e27 2e20 2049 6e20 7468 6973 2063 6173 N'. In this cas │ │ │ │ │ -00014260: 6520 796f 7572 2076 6572 6966 6965 720a e your verifier. │ │ │ │ │ -00014270: 2020 2020 2077 696c 6c20 6e6f 7420 6265 will not be │ │ │ │ │ -00014280: 2063 616c 6c65 6420 616e 796d 6f72 6520 called anymore │ │ │ │ │ -00014290: 616e 6420 6974 2069 7320 6173 7375 6d65 and it is assume │ │ │ │ │ -000142a0: 6420 746f 2068 6176 6520 736b 6970 7065 d to have skippe │ │ │ │ │ -000142b0: 640a 2020 2020 2076 6572 6966 6963 6174 d. verificat │ │ │ │ │ -000142c0: 696f 6e2e 0a0a 2020 202a 2072 6574 7572 ion... * retur │ │ │ │ │ -000142d0: 6e69 6e67 206e 6f20 6572 726f 7220 616e ning no error an │ │ │ │ │ -000142e0: 6420 6e6f 7420 7365 7474 696e 6720 272a d not setting '* │ │ │ │ │ -000142f0: 666c 6167 7327 2074 6f0a 2020 2020 2027 flags' to. ' │ │ │ │ │ -00014300: 4752 5542 5f56 4552 4946 595f 464c 4147 GRUB_VERIFY_FLAG │ │ │ │ │ -00014310: 535f 534b 4950 5f56 4552 4946 4943 4154 S_SKIP_VERIFICAT │ │ │ │ │ -00014320: 494f 4e27 2049 6e20 7468 6973 2063 6173 ION' In this cas │ │ │ │ │ -00014330: 6520 7665 7269 6669 6361 7469 6f6e 2069 e verification i │ │ │ │ │ -00014340: 730a 2020 2020 2064 6f6e 6520 6173 2064 s. done as d │ │ │ │ │ -00014350: 6573 6372 6962 6564 2069 6e20 7468 6520 escribed in the │ │ │ │ │ -00014360: 666f 6c6c 6f77 696e 6720 7365 6374 696f following sectio │ │ │ │ │ -00014370: 6e2e 0a0a 2020 202a 2072 6574 7572 6e69 n... * returni │ │ │ │ │ -00014380: 6e67 2061 6e20 6572 726f 722e 2020 5468 ng an error. Th │ │ │ │ │ -00014390: 656e 206f 7065 6e69 6e67 206f 6620 7468 en opening of th │ │ │ │ │ -000143a0: 6520 6669 6c65 2077 696c 6c20 6661 696c e file will fail │ │ │ │ │ -000143b0: 2064 7565 2074 6f0a 2020 2020 2066 6169 due to. fai │ │ │ │ │ -000143c0: 6c65 6420 7665 7269 6669 6361 7469 6f6e led verification │ │ │ │ │ -000143d0: 2e0a 0a20 2020 496e 2074 6865 2074 6869 ... In the thi │ │ │ │ │ -000143e0: 7264 2063 6173 6520 796f 7572 2027 7772 rd case your 'wr │ │ │ │ │ -000143f0: 6974 6527 2077 696c 6c20 6265 2063 616c ite' will be cal │ │ │ │ │ -00014400: 6c65 6420 7769 7468 2063 6875 6e6b 7320 led with chunks │ │ │ │ │ -00014410: 6f66 2074 6865 0a66 696c 652e 2020 4966 of the.file. If │ │ │ │ │ -00014420: 2079 6f75 206e 6565 6420 7468 6520 7768 you need the wh │ │ │ │ │ -00014430: 6f6c 6520 6669 6c65 2069 6e20 6120 7369 ole file in a si │ │ │ │ │ -00014440: 6e67 6c65 2063 6875 6e6b 2074 6865 6e20 ngle chunk then │ │ │ │ │ -00014450: 6475 7269 6e67 2027 696e 6974 270a 7365 during 'init'.se │ │ │ │ │ -00014460: 7420 7468 6520 6269 7420 2747 5255 425f t the bit 'GRUB_ │ │ │ │ │ -00014470: 5645 5249 4659 5f46 4c41 4753 5f53 494e VERIFY_FLAGS_SIN │ │ │ │ │ -00014480: 474c 455f 4348 554e 4b27 2069 6e20 272a GLE_CHUNK' in '* │ │ │ │ │ -00014490: 666c 6167 7327 2e20 2044 7572 696e 6720 flags'. During │ │ │ │ │ -000144a0: 2769 6e69 7427 0a79 6f75 206d 6179 2073 'init'.you may s │ │ │ │ │ -000144b0: 6574 2027 2a63 6f6e 7465 7874 2720 6966 et '*context' if │ │ │ │ │ -000144c0: 2079 6f75 206e 6565 6420 6164 6469 7469 you need additi │ │ │ │ │ -000144d0: 6f6e 616c 2063 6f6e 7465 7874 2e20 2041 onal context. A │ │ │ │ │ -000144e0: 7420 6576 6572 790a 6974 6572 6174 696f t every.iteratio │ │ │ │ │ -000144f0: 6e20 796f 7520 6d61 7920 7265 7475 726e n you may return │ │ │ │ │ -00014500: 2061 6e20 6572 726f 7220 616e 6420 7468 an error and th │ │ │ │ │ -00014510: 6520 6669 6c65 2077 696c 6c20 6265 2063 e file will be c │ │ │ │ │ -00014520: 6f6e 7369 6465 7265 6420 6173 0a68 6176 onsidered as.hav │ │ │ │ │ -00014530: 696e 6720 6661 696c 6564 2074 6865 2076 ing failed the v │ │ │ │ │ -00014540: 6572 6966 6963 6174 696f 6e2e 2020 4966 erification. If │ │ │ │ │ -00014550: 2079 6f75 2072 6574 7572 6e20 6e6f 2065 you return no e │ │ │ │ │ -00014560: 7272 6f72 2074 6865 6e0a 7665 7269 6669 rror then.verifi │ │ │ │ │ -00014570: 6361 7469 6f6e 2063 6f6e 7469 6e75 6573 cation continues │ │ │ │ │ -00014580: 2e0a 0a20 2020 4f70 7469 6f6e 616c 6c79 ... Optionally │ │ │ │ │ -00014590: 2061 7420 7468 6520 656e 6420 6f66 2074 at the end of t │ │ │ │ │ -000145a0: 6865 2066 696c 6520 2766 696e 6927 2c20 he file 'fini', │ │ │ │ │ -000145b0: 6966 2069 7420 6578 6973 7473 2c20 6973 if it exists, is │ │ │ │ │ -000145c0: 2063 616c 6c65 640a 7769 7468 206a 7573 called.with jus │ │ │ │ │ -000145d0: 7420 7468 6520 636f 6e74 6578 742e 2020 t the context. │ │ │ │ │ -000145e0: 4966 2079 6f75 2072 6574 7572 6e20 6e6f If you return no │ │ │ │ │ -000145f0: 2065 7272 6f72 2064 7572 696e 6720 616e error during an │ │ │ │ │ -00014600: 7920 6f66 2027 696e 6974 272c 0a27 7772 y of 'init',.'wr │ │ │ │ │ -00014610: 6974 6527 2061 6e64 2027 6669 6e69 2720 ite' and 'fini' │ │ │ │ │ -00014620: 7468 656e 2074 6865 2066 696c 6520 6973 then the file is │ │ │ │ │ -00014630: 2063 6f6e 7369 6465 7265 6420 6173 2068 considered as h │ │ │ │ │ -00014640: 6176 696e 6720 7375 6363 6564 6564 0a76 aving succeded.v │ │ │ │ │ -00014650: 6572 6966 6963 6174 696f 6e2e 0a0a 1f0a erification..... │ │ │ │ │ -00014660: 4669 6c65 3a20 6772 7562 2d64 6576 2e69 File: grub-dev.i │ │ │ │ │ -00014670: 6e66 6f2c 2020 4e6f 6465 3a20 4c6f 636b nfo, Node: Lock │ │ │ │ │ -00014680: 646f 776e 2066 7261 6d65 776f 726b 2c20 down framework, │ │ │ │ │ -00014690: 204e 6578 743a 2043 6f70 7969 6e67 2054 Next: Copying T │ │ │ │ │ -000146a0: 6869 7320 4d61 6e75 616c 2c20 2050 7265 his Manual, Pre │ │ │ │ │ -000146b0: 763a 2056 6572 6966 6965 7273 2066 7261 v: Verifiers fra │ │ │ │ │ -000146c0: 6d65 776f 726b 2c20 2055 703a 2054 6f70 mework, Up: Top │ │ │ │ │ -000146d0: 0a0a 3134 204c 6f63 6b64 6f77 6e20 6672 ..14 Lockdown fr │ │ │ │ │ -000146e0: 616d 6577 6f72 6b0a 2a2a 2a2a 2a2a 2a2a amework.******** │ │ │ │ │ -000146f0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a54 *************..T │ │ │ │ │ -00014700: 6865 2047 5255 4220 6361 6e20 6265 206c he GRUB can be l │ │ │ │ │ -00014710: 6f63 6b65 6420 646f 776e 2c20 7768 6963 ocked down, whic │ │ │ │ │ -00014720: 6820 6973 2061 2072 6573 7472 6963 7465 h is a restricte │ │ │ │ │ -00014730: 6420 6d6f 6465 2077 6865 7265 2073 6f6d d mode where som │ │ │ │ │ -00014740: 650a 6f70 6572 6174 696f 6e73 2061 7265 e.operations are │ │ │ │ │ -00014750: 206e 6f74 2061 6c6c 6f77 6564 2e20 2046 not allowed. F │ │ │ │ │ -00014760: 6f72 2069 6e73 7461 6e63 652c 2073 6f6d or instance, som │ │ │ │ │ -00014770: 6520 636f 6d6d 616e 6473 2063 616e 6e6f e commands canno │ │ │ │ │ -00014780: 7420 6265 2075 7365 640a 7768 656e 2074 t be used.when t │ │ │ │ │ -00014790: 6865 2047 5255 4220 6973 206c 6f63 6b65 he GRUB is locke │ │ │ │ │ -000147a0: 6420 646f 776e 2e0a 0a20 2020 5468 6520 d down... The │ │ │ │ │ -000147b0: 6675 6e63 7469 6f6e 2027 6772 7562 5f6c function 'grub_l │ │ │ │ │ -000147c0: 6f63 6b64 6f77 6e28 2927 2069 7320 7573 ockdown()' is us │ │ │ │ │ -000147d0: 6564 2074 6f20 6c6f 636b 646f 776e 2047 ed to lockdown G │ │ │ │ │ -000147e0: 5255 4220 616e 6420 7468 650a 6675 6e63 RUB and the.func │ │ │ │ │ -000147f0: 7469 6f6e 2027 6772 7562 5f69 735f 6c6f tion 'grub_is_lo │ │ │ │ │ -00014800: 636b 646f 776e 2829 2720 6675 6e63 7469 ckdown()' functi │ │ │ │ │ -00014810: 6f6e 2063 616e 2062 6520 7573 6564 2074 on can be used t │ │ │ │ │ -00014820: 6f20 6368 6563 6b20 7768 6574 6865 720a o check whether. │ │ │ │ │ -00014830: 6c6f 636b 646f 776e 2069 7320 656e 6162 lockdown is enab │ │ │ │ │ -00014840: 6c65 6420 6f72 206e 6f74 2e20 2057 6865 led or not. Whe │ │ │ │ │ -00014850: 6e20 656e 6162 6c65 642c 2074 6865 2066 n enabled, the f │ │ │ │ │ -00014860: 756e 6374 696f 6e20 7265 7475 726e 730a unction returns. │ │ │ │ │ -00014870: 2747 5255 425f 4c4f 434b 444f 574e 5f45 'GRUB_LOCKDOWN_E │ │ │ │ │ -00014880: 4e41 424c 4544 2720 616e 6420 2747 5255 NABLED' and 'GRU │ │ │ │ │ -00014890: 425f 4c4f 434b 444f 574e 5f44 4953 4142 B_LOCKDOWN_DISAB │ │ │ │ │ -000148a0: 4c45 4427 2077 6865 6e20 6973 206e 6f74 LED' when is not │ │ │ │ │ -000148b0: 0a65 6e61 626c 6564 2e0a 0a20 2020 5468 .enabled... Th │ │ │ │ │ -000148c0: 6520 666f 6c6c 6f77 696e 6720 6675 6e63 e following func │ │ │ │ │ -000148d0: 7469 6f6e 7320 6361 6e20 6265 2075 7365 tions can be use │ │ │ │ │ -000148e0: 6420 746f 2072 6567 6973 7465 7220 7468 d to register th │ │ │ │ │ -000148f0: 6520 636f 6d6d 616e 6473 2074 6861 7420 e commands that │ │ │ │ │ -00014900: 6361 6e0a 6f6e 6c79 2062 6520 7573 6564 can.only be used │ │ │ │ │ -00014910: 2077 6865 6e20 6c6f 636b 646f 776e 2069 when lockdown i │ │ │ │ │ -00014920: 7320 6469 7361 626c 6564 3a0a 0a20 2020 s disabled:.. │ │ │ │ │ -00014930: 2a20 2767 7275 625f 636d 645f 6c6f 636b * 'grub_cmd_lock │ │ │ │ │ -00014940: 646f 776e 2829 2720 7265 6769 7374 6572 down()' register │ │ │ │ │ -00014950: 7320 636f 6d6d 616e 6420 7768 6963 6820 s command which │ │ │ │ │ -00014960: 7368 6f75 6c64 206e 6f74 2072 756e 2077 should not run w │ │ │ │ │ -00014970: 6865 6e0a 2020 2020 2074 6865 2047 5255 hen. the GRU │ │ │ │ │ -00014980: 4220 6973 2069 6e20 6c6f 636b 646f 776e B is in lockdown │ │ │ │ │ -00014990: 206d 6f64 652e 0a0a 2020 202a 2027 6772 mode... * 'gr │ │ │ │ │ -000149a0: 7562 5f63 6d64 5f6c 6f63 6b64 6f77 6e28 ub_cmd_lockdown( │ │ │ │ │ -000149b0: 2927 2072 6567 6973 7465 7273 2065 7874 )' registers ext │ │ │ │ │ -000149c0: 656e 6465 6420 636f 6d6d 616e 6420 7768 ended command wh │ │ │ │ │ -000149d0: 6963 6820 7368 6f75 6c64 206e 6f74 0a20 ich should not. │ │ │ │ │ -000149e0: 2020 2020 7275 6e20 7768 656e 2074 6865 run when the │ │ │ │ │ -000149f0: 2047 5255 4220 6973 2069 6e20 6c6f 636b GRUB is in lock │ │ │ │ │ -00014a00: 646f 776e 206d 6f64 652e 0a0a 1f0a 4669 down mode.....Fi │ │ │ │ │ -00014a10: 6c65 3a20 6772 7562 2d64 6576 2e69 6e66 le: grub-dev.inf │ │ │ │ │ -00014a20: 6f2c 2020 4e6f 6465 3a20 436f 7079 696e o, Node: Copyin │ │ │ │ │ -00014a30: 6720 5468 6973 204d 616e 7561 6c2c 2020 g This Manual, │ │ │ │ │ -00014a40: 4e65 7874 3a20 496e 6465 782c 2020 5072 Next: Index, Pr │ │ │ │ │ -00014a50: 6576 3a20 4c6f 636b 646f 776e 2066 7261 ev: Lockdown fra │ │ │ │ │ -00014a60: 6d65 776f 726b 2c20 2055 703a 2054 6f70 mework, Up: Top │ │ │ │ │ -00014a70: 0a0a 4170 7065 6e64 6978 2041 2043 6f70 ..Appendix A Cop │ │ │ │ │ -00014a80: 7969 6e67 2054 6869 7320 4d61 6e75 616c ying This Manual │ │ │ │ │ -00014a90: 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a .*************** │ │ │ │ │ -00014aa0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a ***************. │ │ │ │ │ -00014ab0: 0a2a 204d 656e 753a 0a0a 2a20 474e 5520 .* Menu:..* GNU │ │ │ │ │ -00014ac0: 4672 6565 2044 6f63 756d 656e 7461 7469 Free Documentati │ │ │ │ │ -00014ad0: 6f6e 204c 6963 656e 7365 3a3a 2020 4c69 on License:: Li │ │ │ │ │ -00014ae0: 6365 6e73 6520 666f 7220 636f 7079 696e cense for copyin │ │ │ │ │ -00014af0: 6720 7468 6973 206d 616e 7561 6c2e 0a0a g this manual... │ │ │ │ │ -00014b00: 1f0a 4669 6c65 3a20 6772 7562 2d64 6576 ..File: grub-dev │ │ │ │ │ -00014b10: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 474e .info, Node: GN │ │ │ │ │ -00014b20: 5520 4672 6565 2044 6f63 756d 656e 7461 U Free Documenta │ │ │ │ │ -00014b30: 7469 6f6e 204c 6963 656e 7365 2c20 2055 tion License, U │ │ │ │ │ -00014b40: 703a 2043 6f70 7969 6e67 2054 6869 7320 p: Copying This │ │ │ │ │ -00014b50: 4d61 6e75 616c 0a0a 412e 3120 474e 5520 Manual..A.1 GNU │ │ │ │ │ -00014b60: 4672 6565 2044 6f63 756d 656e 7461 7469 Free Documentati │ │ │ │ │ -00014b70: 6f6e 204c 6963 656e 7365 0a3d 3d3d 3d3d on License.===== │ │ │ │ │ +00013910: 3d3d 3d3d 3d0a 0a54 6865 2074 6572 6d69 =====..The termi │ │ │ │ │ +00013920: 6e61 6c20 7769 6e64 6f77 2075 7365 6420 nal window used │ │ │ │ │ +00013930: 746f 2070 726f 7669 6465 2063 6f6d 6d61 to provide comma │ │ │ │ │ +00013940: 6e64 206c 696e 6520 6163 6365 7373 2077 nd line access w │ │ │ │ │ +00013950: 6974 6869 6e20 7468 650a 6772 6170 6869 ithin the.graphi │ │ │ │ │ +00013960: 6361 6c20 6d65 6e75 2069 7320 6d61 6e61 cal menu is mana │ │ │ │ │ +00013970: 6765 6420 6279 2027 6766 786d 656e 752f ged by 'gfxmenu/ │ │ │ │ │ +00013980: 7669 6577 2e63 272e 2020 5468 6520 2767 view.c'. The 'g │ │ │ │ │ +00013990: 6678 7465 726d 2720 7465 726d 696e 616c fxterm' terminal │ │ │ │ │ +000139a0: 0a69 7320 7573 6564 2c20 616e 6420 6974 .is used, and it │ │ │ │ │ +000139b0: 2068 6173 2062 6565 6e20 6d6f 6469 6669 has been modifi │ │ │ │ │ +000139c0: 6564 2074 6f20 616c 6c6f 7720 7265 6e64 ed to allow rend │ │ │ │ │ +000139d0: 6572 696e 6720 746f 2061 6e20 6f66 6673 ering to an offs │ │ │ │ │ +000139e0: 6372 6565 6e0a 7265 6e64 6572 2074 6172 creen.render tar │ │ │ │ │ +000139f0: 6765 7420 746f 2061 6c6c 6f77 2069 7420 get to allow it │ │ │ │ │ +00013a00: 746f 2062 6520 636f 6d70 6f73 6564 2069 to be composed i │ │ │ │ │ +00013a10: 6e74 6f20 7468 6520 646f 7562 6c65 2062 nto the double b │ │ │ │ │ +00013a20: 7566 6665 7269 6e67 0a73 7973 7465 6d20 uffering.system │ │ │ │ │ +00013a30: 7468 6174 2074 6865 2067 7261 7068 6963 that the graphic │ │ │ │ │ +00013a40: 616c 206d 656e 7520 7669 6577 2075 7365 al menu view use │ │ │ │ │ +00013a50: 732e 2020 5468 6973 2069 7320 6261 6420 s. This is bad │ │ │ │ │ +00013a60: 666f 7220 7065 7266 6f72 6d61 6e63 652c for performance, │ │ │ │ │ +00013a70: 0a68 6f77 6576 6572 2c20 736f 2069 7420 .however, so it │ │ │ │ │ +00013a80: 776f 756c 6420 7072 6f62 6162 6c79 2062 would probably b │ │ │ │ │ +00013a90: 6520 6120 676f 6f64 2069 6465 6120 746f e a good idea to │ │ │ │ │ +00013aa0: 206d 616b 6520 6974 2070 6f73 7369 626c make it possibl │ │ │ │ │ +00013ab0: 6520 746f 0a74 656d 706f 7261 7269 6c79 e to.temporarily │ │ │ │ │ +00013ac0: 2064 6973 6162 6c65 2064 6f75 626c 6520 disable double │ │ │ │ │ +00013ad0: 6275 6666 6572 696e 6720 6173 206c 6f6e buffering as lon │ │ │ │ │ +00013ae0: 6720 6173 2074 6865 2074 6572 6d69 6e61 g as the termina │ │ │ │ │ +00013af0: 6c20 7769 6e64 6f77 2069 730a 7669 7369 l window is.visi │ │ │ │ │ +00013b00: 626c 652e 2020 5468 6572 6520 6172 6520 ble. There are │ │ │ │ │ +00013b10: 7374 696c 6c20 756e 7265 736f 6c76 6564 still unresolved │ │ │ │ │ +00013b20: 2070 726f 626c 656d 7320 7468 6174 206f problems that o │ │ │ │ │ +00013b30: 6363 7572 2077 6865 6e20 636f 6d6d 616e ccur when comman │ │ │ │ │ +00013b40: 6473 0a61 7265 2065 7865 6375 7465 6420 ds.are executed │ │ │ │ │ +00013b50: 6672 6f6d 2074 6865 2074 6572 6d69 6e61 from the termina │ │ │ │ │ +00013b60: 6c20 7769 6e64 6f77 2074 6861 7420 6368 l window that ch │ │ │ │ │ +00013b70: 616e 6765 2074 6865 2067 7261 7068 6963 ange the graphic │ │ │ │ │ +00013b80: 7320 6d6f 6465 2e0a 4974 2773 2070 6f73 s mode..It's pos │ │ │ │ │ +00013b90: 7369 626c 6520 7468 6174 206d 616b 696e sible that makin │ │ │ │ │ +00013ba0: 6720 2767 7275 625f 7669 6465 6f5f 7265 g 'grub_video_re │ │ │ │ │ +00013bb0: 7374 6f72 6528 2927 2072 6574 7572 6e20 store()' return │ │ │ │ │ +00013bc0: 746f 2074 6865 2067 7261 7068 6963 730a to the graphics. │ │ │ │ │ +00013bd0: 6d6f 6465 2074 6861 7420 7761 7320 696e mode that was in │ │ │ │ │ +00013be0: 2075 7365 2062 6566 6f72 6520 2767 7275 use before 'gru │ │ │ │ │ +00013bf0: 625f 7669 6465 6f5f 7365 7475 7028 2927 b_video_setup()' │ │ │ │ │ +00013c00: 2077 6173 2063 616c 6c65 6420 6d69 6768 was called migh │ │ │ │ │ +00013c10: 7420 6669 780a 736f 6d65 206f 6620 7468 t fix.some of th │ │ │ │ │ +00013c20: 6520 7072 6f62 6c65 6d73 2e0a 0a1f 0a46 e problems.....F │ │ │ │ │ +00013c30: 696c 653a 2067 7275 622d 6465 762e 696e ile: grub-dev.in │ │ │ │ │ +00013c40: 666f 2c20 204e 6f64 653a 2056 6572 6966 fo, Node: Verif │ │ │ │ │ +00013c50: 6965 7273 2066 7261 6d65 776f 726b 2c20 iers framework, │ │ │ │ │ +00013c60: 204e 6578 743a 204c 6f63 6b64 6f77 6e20 Next: Lockdown │ │ │ │ │ +00013c70: 6672 616d 6577 6f72 6b2c 2020 5072 6576 framework, Prev │ │ │ │ │ +00013c80: 3a20 4772 6170 6869 6361 6c20 4d65 6e75 : Graphical Menu │ │ │ │ │ +00013c90: 2053 6f66 7477 6172 6520 4465 7369 676e Software Design │ │ │ │ │ +00013ca0: 2c20 2055 703a 2054 6f70 0a0a 3133 2056 , Up: Top..13 V │ │ │ │ │ +00013cb0: 6572 6966 6965 7273 2066 7261 6d65 776f erifiers framewo │ │ │ │ │ +00013cc0: 726b 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a rk.************* │ │ │ │ │ +00013cd0: 2a2a 2a2a 2a2a 2a2a 2a0a 0a54 6f20 7265 *********..To re │ │ │ │ │ +00013ce0: 6769 7374 6572 2079 6f75 7220 6f77 6e20 gister your own │ │ │ │ │ +00013cf0: 7665 7269 6669 6572 2063 616c 6c20 2767 verifier call 'g │ │ │ │ │ +00013d00: 7275 625f 7665 7269 6669 6572 5f72 6567 rub_verifier_reg │ │ │ │ │ +00013d10: 6973 7465 7227 2077 6974 6820 610a 7374 ister' with a.st │ │ │ │ │ +00013d20: 7275 6374 7572 6520 706f 696e 7469 6e67 ructure pointing │ │ │ │ │ +00013d30: 2074 6f20 796f 7572 2066 756e 6374 696f to your functio │ │ │ │ │ +00013d40: 6e73 2e0a 0a20 2020 5468 6520 696e 7465 ns... The inte │ │ │ │ │ +00013d50: 7266 6163 6520 6973 2069 6e73 7069 7265 rface is inspire │ │ │ │ │ +00013d60: 6420 6279 2074 6865 2068 6173 6820 696e d by the hash in │ │ │ │ │ +00013d70: 7465 7266 6163 6520 7769 7468 0a27 696e terface with.'in │ │ │ │ │ +00013d80: 6974 272f 2777 7269 7465 272f 2766 696e it'/'write'/'fin │ │ │ │ │ +00013d90: 6927 2e0a 0a20 2020 5468 6572 6520 6172 i'... There ar │ │ │ │ │ +00013da0: 6520 6573 7365 6e74 6961 6c6c 7920 3220 e essentially 2 │ │ │ │ │ +00013db0: 7761 7973 206f 6620 7573 696e 6720 6974 ways of using it │ │ │ │ │ +00013dc0: 2c20 6861 7368 696e 6720 616e 6420 7768 , hashing and wh │ │ │ │ │ +00013dd0: 6f6c 652d 6669 6c65 0a76 6572 6966 6963 ole-file.verific │ │ │ │ │ +00013de0: 6174 696f 6e2e 0a0a 2020 2057 6974 6820 ation... With │ │ │ │ │ +00013df0: 7468 6520 6861 7368 696e 6720 6170 7072 the hashing appr │ │ │ │ │ +00013e00: 6f61 6368 3a20 4475 7269 6e67 2027 696e oach: During 'in │ │ │ │ │ +00013e10: 6974 2720 796f 7520 6465 6369 6465 2077 it' you decide w │ │ │ │ │ +00013e20: 6865 7468 6572 2079 6f75 2077 616e 740a hether you want. │ │ │ │ │ +00013e30: 746f 2063 6865 636b 2074 6865 2067 6976 to check the giv │ │ │ │ │ +00013e40: 656e 2066 696c 6520 616e 6420 696e 6974 en file and init │ │ │ │ │ +00013e50: 2063 6f6e 7465 7874 2e20 2049 6e20 2777 context. In 'w │ │ │ │ │ +00013e60: 7269 7465 2720 796f 7520 7570 6461 7465 rite' you update │ │ │ │ │ +00013e70: 2079 6f75 720a 6861 7368 696e 6720 7374 your.hashing st │ │ │ │ │ +00013e80: 6174 652e 2020 496e 2027 6669 6e69 2720 ate. In 'fini' │ │ │ │ │ +00013e90: 796f 7520 6368 6563 6b20 7468 6174 2074 you check that t │ │ │ │ │ +00013ea0: 6865 2068 6173 6820 6d61 7463 6865 7320 he hash matches │ │ │ │ │ +00013eb0: 7468 6520 6578 7065 6374 6564 0a76 616c the expected.val │ │ │ │ │ +00013ec0: 7565 2f70 6173 7365 7320 736f 6d65 2063 ue/passes some c │ │ │ │ │ +00013ed0: 6865 636b 2f2e 2e2e 0a0a 2020 2057 6974 heck/..... Wit │ │ │ │ │ +00013ee0: 6820 7768 6f6c 652d 6669 6c65 2076 6572 h whole-file ver │ │ │ │ │ +00013ef0: 6966 6963 6174 696f 6e3a 2044 7572 696e ification: Durin │ │ │ │ │ +00013f00: 6720 2769 6e69 7427 2079 6f75 2064 6563 g 'init' you dec │ │ │ │ │ +00013f10: 6964 6520 7768 6574 6865 7220 796f 750a ide whether you. │ │ │ │ │ +00013f20: 7761 6e74 2074 6f20 6368 6563 6b20 7468 want to check th │ │ │ │ │ +00013f30: 6520 6769 7665 6e20 6669 6c65 2061 6e64 e given file and │ │ │ │ │ +00013f40: 2069 6e69 7420 636f 6e74 6578 742e 2020 init context. │ │ │ │ │ +00013f50: 496e 2027 7772 6974 6527 2079 6f75 2076 In 'write' you v │ │ │ │ │ +00013f60: 6572 6966 790a 7468 6520 6669 6c65 2061 erify.the file a │ │ │ │ │ +00013f70: 6e64 2072 6574 7572 6e20 616e 2065 7272 nd return an err │ │ │ │ │ +00013f80: 6f72 2069 6620 6974 2066 6169 6c73 2e20 or if it fails. │ │ │ │ │ +00013f90: 2059 6f75 2064 6f6e 2774 2068 6176 6520 You don't have │ │ │ │ │ +00013fa0: 2766 696e 6927 2e0a 0a20 2020 4164 6469 'fini'... Addi │ │ │ │ │ +00013fb0: 7469 6f6e 616c 2027 7665 7269 6679 5f73 tional 'verify_s │ │ │ │ │ +00013fc0: 7472 696e 6727 2072 6563 6569 7665 7320 tring' receives │ │ │ │ │ +00013fd0: 7661 7269 6f75 7320 7374 7269 6e67 7320 various strings │ │ │ │ │ +00013fe0: 6c69 6b65 206b 6572 6e65 6c0a 7061 7261 like kernel.para │ │ │ │ │ +00013ff0: 6d65 7465 7273 2074 6f20 7665 7269 6679 meters to verify │ │ │ │ │ +00014000: 2e20 2052 6574 7572 6e69 6e67 206e 6f20 . Returning no │ │ │ │ │ +00014010: 6572 726f 7220 6d65 616e 7320 7375 6363 error means succ │ │ │ │ │ +00014020: 6573 7366 756c 2076 6572 6966 6963 6174 essful verificat │ │ │ │ │ +00014030: 696f 6e0a 616e 6420 616e 2065 7272 6f72 ion.and an error │ │ │ │ │ +00014040: 2073 746f 7073 2074 6865 2063 7572 7265 stops the curre │ │ │ │ │ +00014050: 6e74 2061 6374 696f 6e2e 0a0a 2020 2044 nt action... D │ │ │ │ │ +00014060: 6574 6169 6c65 6420 6465 7363 7269 7074 etailed descript │ │ │ │ │ +00014070: 696f 6e20 6f66 2074 6865 2041 5049 3a0a ion of the API:. │ │ │ │ │ +00014080: 0a20 2020 4576 6572 7920 7469 6d65 2061 . Every time a │ │ │ │ │ +00014090: 2066 696c 6520 6973 206f 7065 6e65 6420 file is opened │ │ │ │ │ +000140a0: 796f 7572 2027 696e 6974 2720 6675 6e63 your 'init' func │ │ │ │ │ +000140b0: 7469 6f6e 2069 7320 6361 6c6c 6564 2077 tion is called w │ │ │ │ │ +000140c0: 6974 6820 6669 6c65 0a64 6573 6372 6970 ith file.descrip │ │ │ │ │ +000140d0: 746f 7220 616e 6420 6669 6c65 2074 7970 tor and file typ │ │ │ │ │ +000140e0: 652e 2020 596f 7572 2066 756e 6374 696f e. Your functio │ │ │ │ │ +000140f0: 6e20 6361 6e20 6861 7665 2074 6865 2066 n can have the f │ │ │ │ │ +00014100: 6f6c 6c6f 7769 6e67 0a6f 7574 636f 6d65 ollowing.outcome │ │ │ │ │ +00014110: 733a 0a0a 2020 202a 2072 6574 7572 6e69 s:.. * returni │ │ │ │ │ +00014120: 6e67 206e 6f20 6572 726f 7220 616e 6420 ng no error and │ │ │ │ │ +00014130: 7365 7474 696e 6720 272a 666c 6167 7327 setting '*flags' │ │ │ │ │ +00014140: 2074 6f0a 2020 2020 2027 4752 5542 5f56 to. 'GRUB_V │ │ │ │ │ +00014150: 4552 4946 595f 464c 4147 535f 4445 4645 ERIFY_FLAGS_DEFE │ │ │ │ │ +00014160: 525f 4155 5448 272e 2020 496e 2074 6869 R_AUTH'. In thi │ │ │ │ │ +00014170: 7320 6361 7365 2076 6572 6966 6963 6174 s case verificat │ │ │ │ │ +00014180: 696f 6e20 6973 0a20 2020 2020 6465 6665 ion is. defe │ │ │ │ │ +00014190: 7272 6564 2074 6f20 6f74 6865 7220 6163 rred to other ac │ │ │ │ │ +000141a0: 7469 7665 2076 6572 6966 6965 7273 2e20 tive verifiers. │ │ │ │ │ +000141b0: 2056 6572 6966 6963 6174 696f 6e20 6661 Verification fa │ │ │ │ │ +000141c0: 696c 7320 6966 206e 6f62 6f64 790a 2020 ils if nobody. │ │ │ │ │ +000141d0: 2020 2063 6172 6573 206f 7220 7365 6c65 cares or sele │ │ │ │ │ +000141e0: 6374 6564 2076 6572 6966 6965 7220 6661 cted verifier fa │ │ │ │ │ +000141f0: 696c 732e 0a0a 2020 202a 2072 6574 7572 ils... * retur │ │ │ │ │ +00014200: 6e69 6e67 206e 6f20 6572 726f 7220 616e ning no error an │ │ │ │ │ +00014210: 6420 7365 7474 696e 6720 272a 666c 6167 d setting '*flag │ │ │ │ │ +00014220: 7327 2074 6f0a 2020 2020 2027 4752 5542 s' to. 'GRUB │ │ │ │ │ +00014230: 5f56 4552 4946 595f 464c 4147 535f 534b _VERIFY_FLAGS_SK │ │ │ │ │ +00014240: 4950 5f56 4552 4946 4943 4154 494f 4e27 IP_VERIFICATION' │ │ │ │ │ +00014250: 2e20 2049 6e20 7468 6973 2063 6173 6520 . In this case │ │ │ │ │ +00014260: 796f 7572 2076 6572 6966 6965 720a 2020 your verifier. │ │ │ │ │ +00014270: 2020 2077 696c 6c20 6e6f 7420 6265 2063 will not be c │ │ │ │ │ +00014280: 616c 6c65 6420 616e 796d 6f72 6520 616e alled anymore an │ │ │ │ │ +00014290: 6420 6974 2069 7320 6173 7375 6d65 6420 d it is assumed │ │ │ │ │ +000142a0: 746f 2068 6176 6520 736b 6970 7065 640a to have skipped. │ │ │ │ │ +000142b0: 2020 2020 2076 6572 6966 6963 6174 696f verificatio │ │ │ │ │ +000142c0: 6e2e 0a0a 2020 202a 2072 6574 7572 6e69 n... * returni │ │ │ │ │ +000142d0: 6e67 206e 6f20 6572 726f 7220 616e 6420 ng no error and │ │ │ │ │ +000142e0: 6e6f 7420 7365 7474 696e 6720 272a 666c not setting '*fl │ │ │ │ │ +000142f0: 6167 7327 2074 6f0a 2020 2020 2027 4752 ags' to. 'GR │ │ │ │ │ +00014300: 5542 5f56 4552 4946 595f 464c 4147 535f UB_VERIFY_FLAGS_ │ │ │ │ │ +00014310: 534b 4950 5f56 4552 4946 4943 4154 494f SKIP_VERIFICATIO │ │ │ │ │ +00014320: 4e27 2049 6e20 7468 6973 2063 6173 6520 N' In this case │ │ │ │ │ +00014330: 7665 7269 6669 6361 7469 6f6e 2069 730a verification is. │ │ │ │ │ +00014340: 2020 2020 2064 6f6e 6520 6173 2064 6573 done as des │ │ │ │ │ +00014350: 6372 6962 6564 2069 6e20 7468 6520 666f cribed in the fo │ │ │ │ │ +00014360: 6c6c 6f77 696e 6720 7365 6374 696f 6e2e llowing section. │ │ │ │ │ +00014370: 0a0a 2020 202a 2072 6574 7572 6e69 6e67 .. * returning │ │ │ │ │ +00014380: 2061 6e20 6572 726f 722e 2020 5468 656e an error. Then │ │ │ │ │ +00014390: 206f 7065 6e69 6e67 206f 6620 7468 6520 opening of the │ │ │ │ │ +000143a0: 6669 6c65 2077 696c 6c20 6661 696c 2064 file will fail d │ │ │ │ │ +000143b0: 7565 2074 6f0a 2020 2020 2066 6169 6c65 ue to. faile │ │ │ │ │ +000143c0: 6420 7665 7269 6669 6361 7469 6f6e 2e0a d verification.. │ │ │ │ │ +000143d0: 0a20 2020 496e 2074 6865 2074 6869 7264 . In the third │ │ │ │ │ +000143e0: 2063 6173 6520 796f 7572 2027 7772 6974 case your 'writ │ │ │ │ │ +000143f0: 6527 2077 696c 6c20 6265 2063 616c 6c65 e' will be calle │ │ │ │ │ +00014400: 6420 7769 7468 2063 6875 6e6b 7320 6f66 d with chunks of │ │ │ │ │ +00014410: 2074 6865 0a66 696c 652e 2020 4966 2079 the.file. If y │ │ │ │ │ +00014420: 6f75 206e 6565 6420 7468 6520 7768 6f6c ou need the whol │ │ │ │ │ +00014430: 6520 6669 6c65 2069 6e20 6120 7369 6e67 e file in a sing │ │ │ │ │ +00014440: 6c65 2063 6875 6e6b 2074 6865 6e20 6475 le chunk then du │ │ │ │ │ +00014450: 7269 6e67 2027 696e 6974 270a 7365 7420 ring 'init'.set │ │ │ │ │ +00014460: 7468 6520 6269 7420 2747 5255 425f 5645 the bit 'GRUB_VE │ │ │ │ │ +00014470: 5249 4659 5f46 4c41 4753 5f53 494e 474c RIFY_FLAGS_SINGL │ │ │ │ │ +00014480: 455f 4348 554e 4b27 2069 6e20 272a 666c E_CHUNK' in '*fl │ │ │ │ │ +00014490: 6167 7327 2e20 2044 7572 696e 6720 2769 ags'. During 'i │ │ │ │ │ +000144a0: 6e69 7427 0a79 6f75 206d 6179 2073 6574 nit'.you may set │ │ │ │ │ +000144b0: 2027 2a63 6f6e 7465 7874 2720 6966 2079 '*context' if y │ │ │ │ │ +000144c0: 6f75 206e 6565 6420 6164 6469 7469 6f6e ou need addition │ │ │ │ │ +000144d0: 616c 2063 6f6e 7465 7874 2e20 2041 7420 al context. At │ │ │ │ │ +000144e0: 6576 6572 790a 6974 6572 6174 696f 6e20 every.iteration │ │ │ │ │ +000144f0: 796f 7520 6d61 7920 7265 7475 726e 2061 you may return a │ │ │ │ │ +00014500: 6e20 6572 726f 7220 616e 6420 7468 6520 n error and the │ │ │ │ │ +00014510: 6669 6c65 2077 696c 6c20 6265 2063 6f6e file will be con │ │ │ │ │ +00014520: 7369 6465 7265 6420 6173 0a68 6176 696e sidered as.havin │ │ │ │ │ +00014530: 6720 6661 696c 6564 2074 6865 2076 6572 g failed the ver │ │ │ │ │ +00014540: 6966 6963 6174 696f 6e2e 2020 4966 2079 ification. If y │ │ │ │ │ +00014550: 6f75 2072 6574 7572 6e20 6e6f 2065 7272 ou return no err │ │ │ │ │ +00014560: 6f72 2074 6865 6e0a 7665 7269 6669 6361 or then.verifica │ │ │ │ │ +00014570: 7469 6f6e 2063 6f6e 7469 6e75 6573 2e0a tion continues.. │ │ │ │ │ +00014580: 0a20 2020 4f70 7469 6f6e 616c 6c79 2061 . Optionally a │ │ │ │ │ +00014590: 7420 7468 6520 656e 6420 6f66 2074 6865 t the end of the │ │ │ │ │ +000145a0: 2066 696c 6520 2766 696e 6927 2c20 6966 file 'fini', if │ │ │ │ │ +000145b0: 2069 7420 6578 6973 7473 2c20 6973 2063 it exists, is c │ │ │ │ │ +000145c0: 616c 6c65 640a 7769 7468 206a 7573 7420 alled.with just │ │ │ │ │ +000145d0: 7468 6520 636f 6e74 6578 742e 2020 4966 the context. If │ │ │ │ │ +000145e0: 2079 6f75 2072 6574 7572 6e20 6e6f 2065 you return no e │ │ │ │ │ +000145f0: 7272 6f72 2064 7572 696e 6720 616e 7920 rror during any │ │ │ │ │ +00014600: 6f66 2027 696e 6974 272c 0a27 7772 6974 of 'init',.'writ │ │ │ │ │ +00014610: 6527 2061 6e64 2027 6669 6e69 2720 7468 e' and 'fini' th │ │ │ │ │ +00014620: 656e 2074 6865 2066 696c 6520 6973 2063 en the file is c │ │ │ │ │ +00014630: 6f6e 7369 6465 7265 6420 6173 2068 6176 onsidered as hav │ │ │ │ │ +00014640: 696e 6720 7375 6363 6564 6564 0a76 6572 ing succeded.ver │ │ │ │ │ +00014650: 6966 6963 6174 696f 6e2e 0a0a 1f0a 4669 ification.....Fi │ │ │ │ │ +00014660: 6c65 3a20 6772 7562 2d64 6576 2e69 6e66 le: grub-dev.inf │ │ │ │ │ +00014670: 6f2c 2020 4e6f 6465 3a20 4c6f 636b 646f o, Node: Lockdo │ │ │ │ │ +00014680: 776e 2066 7261 6d65 776f 726b 2c20 204e wn framework, N │ │ │ │ │ +00014690: 6578 743a 2043 6f70 7969 6e67 2054 6869 ext: Copying Thi │ │ │ │ │ +000146a0: 7320 4d61 6e75 616c 2c20 2050 7265 763a s Manual, Prev: │ │ │ │ │ +000146b0: 2056 6572 6966 6965 7273 2066 7261 6d65 Verifiers frame │ │ │ │ │ +000146c0: 776f 726b 2c20 2055 703a 2054 6f70 0a0a work, Up: Top.. │ │ │ │ │ +000146d0: 3134 204c 6f63 6b64 6f77 6e20 6672 616d 14 Lockdown fram │ │ │ │ │ +000146e0: 6577 6f72 6b0a 2a2a 2a2a 2a2a 2a2a 2a2a ework.********** │ │ │ │ │ +000146f0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a54 6865 ***********..The │ │ │ │ │ +00014700: 2047 5255 4220 6361 6e20 6265 206c 6f63 GRUB can be loc │ │ │ │ │ +00014710: 6b65 6420 646f 776e 2c20 7768 6963 6820 ked down, which │ │ │ │ │ +00014720: 6973 2061 2072 6573 7472 6963 7465 6420 is a restricted │ │ │ │ │ +00014730: 6d6f 6465 2077 6865 7265 2073 6f6d 650a mode where some. │ │ │ │ │ +00014740: 6f70 6572 6174 696f 6e73 2061 7265 206e operations are n │ │ │ │ │ +00014750: 6f74 2061 6c6c 6f77 6564 2e20 2046 6f72 ot allowed. For │ │ │ │ │ +00014760: 2069 6e73 7461 6e63 652c 2073 6f6d 6520 instance, some │ │ │ │ │ +00014770: 636f 6d6d 616e 6473 2063 616e 6e6f 7420 commands cannot │ │ │ │ │ +00014780: 6265 2075 7365 640a 7768 656e 2074 6865 be used.when the │ │ │ │ │ +00014790: 2047 5255 4220 6973 206c 6f63 6b65 6420 GRUB is locked │ │ │ │ │ +000147a0: 646f 776e 2e0a 0a20 2020 5468 6520 6675 down... The fu │ │ │ │ │ +000147b0: 6e63 7469 6f6e 2027 6772 7562 5f6c 6f63 nction 'grub_loc │ │ │ │ │ +000147c0: 6b64 6f77 6e28 2927 2069 7320 7573 6564 kdown()' is used │ │ │ │ │ +000147d0: 2074 6f20 6c6f 636b 646f 776e 2047 5255 to lockdown GRU │ │ │ │ │ +000147e0: 4220 616e 6420 7468 650a 6675 6e63 7469 B and the.functi │ │ │ │ │ +000147f0: 6f6e 2027 6772 7562 5f69 735f 6c6f 636b on 'grub_is_lock │ │ │ │ │ +00014800: 646f 776e 2829 2720 6675 6e63 7469 6f6e down()' function │ │ │ │ │ +00014810: 2063 616e 2062 6520 7573 6564 2074 6f20 can be used to │ │ │ │ │ +00014820: 6368 6563 6b20 7768 6574 6865 720a 6c6f check whether.lo │ │ │ │ │ +00014830: 636b 646f 776e 2069 7320 656e 6162 6c65 ckdown is enable │ │ │ │ │ +00014840: 6420 6f72 206e 6f74 2e20 2057 6865 6e20 d or not. When │ │ │ │ │ +00014850: 656e 6162 6c65 642c 2074 6865 2066 756e enabled, the fun │ │ │ │ │ +00014860: 6374 696f 6e20 7265 7475 726e 730a 2747 ction returns.'G │ │ │ │ │ +00014870: 5255 425f 4c4f 434b 444f 574e 5f45 4e41 RUB_LOCKDOWN_ENA │ │ │ │ │ +00014880: 424c 4544 2720 616e 6420 2747 5255 425f BLED' and 'GRUB_ │ │ │ │ │ +00014890: 4c4f 434b 444f 574e 5f44 4953 4142 4c45 LOCKDOWN_DISABLE │ │ │ │ │ +000148a0: 4427 2077 6865 6e20 6973 206e 6f74 0a65 D' when is not.e │ │ │ │ │ +000148b0: 6e61 626c 6564 2e0a 0a20 2020 5468 6520 nabled... The │ │ │ │ │ +000148c0: 666f 6c6c 6f77 696e 6720 6675 6e63 7469 following functi │ │ │ │ │ +000148d0: 6f6e 7320 6361 6e20 6265 2075 7365 6420 ons can be used │ │ │ │ │ +000148e0: 746f 2072 6567 6973 7465 7220 7468 6520 to register the │ │ │ │ │ +000148f0: 636f 6d6d 616e 6473 2074 6861 7420 6361 commands that ca │ │ │ │ │ +00014900: 6e0a 6f6e 6c79 2062 6520 7573 6564 2077 n.only be used w │ │ │ │ │ +00014910: 6865 6e20 6c6f 636b 646f 776e 2069 7320 hen lockdown is │ │ │ │ │ +00014920: 6469 7361 626c 6564 3a0a 0a20 2020 2a20 disabled:.. * │ │ │ │ │ +00014930: 2767 7275 625f 636d 645f 6c6f 636b 646f 'grub_cmd_lockdo │ │ │ │ │ +00014940: 776e 2829 2720 7265 6769 7374 6572 7320 wn()' registers │ │ │ │ │ +00014950: 636f 6d6d 616e 6420 7768 6963 6820 7368 command which sh │ │ │ │ │ +00014960: 6f75 6c64 206e 6f74 2072 756e 2077 6865 ould not run whe │ │ │ │ │ +00014970: 6e0a 2020 2020 2074 6865 2047 5255 4220 n. the GRUB │ │ │ │ │ +00014980: 6973 2069 6e20 6c6f 636b 646f 776e 206d is in lockdown m │ │ │ │ │ +00014990: 6f64 652e 0a0a 2020 202a 2027 6772 7562 ode... * 'grub │ │ │ │ │ +000149a0: 5f63 6d64 5f6c 6f63 6b64 6f77 6e28 2927 _cmd_lockdown()' │ │ │ │ │ +000149b0: 2072 6567 6973 7465 7273 2065 7874 656e registers exten │ │ │ │ │ +000149c0: 6465 6420 636f 6d6d 616e 6420 7768 6963 ded command whic │ │ │ │ │ +000149d0: 6820 7368 6f75 6c64 206e 6f74 0a20 2020 h should not. │ │ │ │ │ +000149e0: 2020 7275 6e20 7768 656e 2074 6865 2047 run when the G │ │ │ │ │ +000149f0: 5255 4220 6973 2069 6e20 6c6f 636b 646f RUB is in lockdo │ │ │ │ │ +00014a00: 776e 206d 6f64 652e 0a0a 1f0a 4669 6c65 wn mode.....File │ │ │ │ │ +00014a10: 3a20 6772 7562 2d64 6576 2e69 6e66 6f2c : grub-dev.info, │ │ │ │ │ +00014a20: 2020 4e6f 6465 3a20 436f 7079 696e 6720 Node: Copying │ │ │ │ │ +00014a30: 5468 6973 204d 616e 7561 6c2c 2020 4e65 This Manual, Ne │ │ │ │ │ +00014a40: 7874 3a20 496e 6465 782c 2020 5072 6576 xt: Index, Prev │ │ │ │ │ +00014a50: 3a20 4c6f 636b 646f 776e 2066 7261 6d65 : Lockdown frame │ │ │ │ │ +00014a60: 776f 726b 2c20 2055 703a 2054 6f70 0a0a work, Up: Top.. │ │ │ │ │ +00014a70: 4170 7065 6e64 6978 2041 2043 6f70 7969 Appendix A Copyi │ │ │ │ │ +00014a80: 6e67 2054 6869 7320 4d61 6e75 616c 0a2a ng This Manual.* │ │ │ │ │ +00014a90: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ +00014aa0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a2a *************..* │ │ │ │ │ +00014ab0: 204d 656e 753a 0a0a 2a20 474e 5520 4672 Menu:..* GNU Fr │ │ │ │ │ +00014ac0: 6565 2044 6f63 756d 656e 7461 7469 6f6e ee Documentation │ │ │ │ │ +00014ad0: 204c 6963 656e 7365 3a3a 2020 4c69 6365 License:: Lice │ │ │ │ │ +00014ae0: 6e73 6520 666f 7220 636f 7079 696e 6720 nse for copying │ │ │ │ │ +00014af0: 7468 6973 206d 616e 7561 6c2e 0a0a 1f0a this manual..... │ │ │ │ │ +00014b00: 4669 6c65 3a20 6772 7562 2d64 6576 2e69 File: grub-dev.i │ │ │ │ │ +00014b10: 6e66 6f2c 2020 4e6f 6465 3a20 474e 5520 nfo, Node: GNU │ │ │ │ │ +00014b20: 4672 6565 2044 6f63 756d 656e 7461 7469 Free Documentati │ │ │ │ │ +00014b30: 6f6e 204c 6963 656e 7365 2c20 2055 703a on License, Up: │ │ │ │ │ +00014b40: 2043 6f70 7969 6e67 2054 6869 7320 4d61 Copying This Ma │ │ │ │ │ +00014b50: 6e75 616c 0a0a 412e 3120 474e 5520 4672 nual..A.1 GNU Fr │ │ │ │ │ +00014b60: 6565 2044 6f63 756d 656e 7461 7469 6f6e ee Documentation │ │ │ │ │ +00014b70: 204c 6963 656e 7365 0a3d 3d3d 3d3d 3d3d License.======= │ │ │ │ │ 00014b80: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00014b90: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a20 =============.. │ │ │ │ │ +00014b90: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a20 2020 ===========.. │ │ │ │ │ 00014ba0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00014bb0: 2020 2020 2056 6572 7369 6f6e 2031 2e32 Version 1.2 │ │ │ │ │ -00014bc0: 2c20 4e6f 7665 6d62 6572 2032 3030 320a , November 2002. │ │ │ │ │ -00014bd0: 0a20 2020 2020 436f 7079 7269 6768 7420 . Copyright │ │ │ │ │ -00014be0: 2843 2920 3230 3030 2c32 3030 312c 3230 (C) 2000,2001,20 │ │ │ │ │ -00014bf0: 3032 2046 7265 6520 536f 6674 7761 7265 02 Free Software │ │ │ │ │ -00014c00: 2046 6f75 6e64 6174 696f 6e2c 2049 6e63 Foundation, Inc │ │ │ │ │ -00014c10: 2e0a 2020 2020 2035 3120 4672 616e 6b6c .. 51 Frankl │ │ │ │ │ -00014c20: 696e 2053 742c 2046 6966 7468 2046 6c6f in St, Fifth Flo │ │ │ │ │ -00014c30: 6f72 2c20 426f 7374 6f6e 2c20 4d41 2020 or, Boston, MA │ │ │ │ │ -00014c40: 3032 3131 302d 3133 3031 2c20 5553 410a 02110-1301, USA. │ │ │ │ │ -00014c50: 0a20 2020 2020 4576 6572 796f 6e65 2069 . Everyone i │ │ │ │ │ -00014c60: 7320 7065 726d 6974 7465 6420 746f 2063 s permitted to c │ │ │ │ │ -00014c70: 6f70 7920 616e 6420 6469 7374 7269 6275 opy and distribu │ │ │ │ │ -00014c80: 7465 2076 6572 6261 7469 6d20 636f 7069 te verbatim copi │ │ │ │ │ -00014c90: 6573 0a20 2020 2020 6f66 2074 6869 7320 es. of this │ │ │ │ │ -00014ca0: 6c69 6365 6e73 6520 646f 6375 6d65 6e74 license document │ │ │ │ │ -00014cb0: 2c20 6275 7420 6368 616e 6769 6e67 2069 , but changing i │ │ │ │ │ -00014cc0: 7420 6973 206e 6f74 2061 6c6c 6f77 6564 t is not allowed │ │ │ │ │ -00014cd0: 2e0a 0a20 2030 2e20 5052 4541 4d42 4c45 ... 0. PREAMBLE │ │ │ │ │ -00014ce0: 0a0a 2020 2020 2054 6865 2070 7572 706f .. The purpo │ │ │ │ │ -00014cf0: 7365 206f 6620 7468 6973 204c 6963 656e se of this Licen │ │ │ │ │ -00014d00: 7365 2069 7320 746f 206d 616b 6520 6120 se is to make a │ │ │ │ │ -00014d10: 6d61 6e75 616c 2c20 7465 7874 626f 6f6b manual, textbook │ │ │ │ │ -00014d20: 2c20 6f72 206f 7468 6572 0a20 2020 2020 , or other. │ │ │ │ │ -00014d30: 6675 6e63 7469 6f6e 616c 2061 6e64 2075 functional and u │ │ │ │ │ -00014d40: 7365 6675 6c20 646f 6375 6d65 6e74 2022 seful document " │ │ │ │ │ -00014d50: 6672 6565 2220 696e 2074 6865 2073 656e free" in the sen │ │ │ │ │ -00014d60: 7365 206f 6620 6672 6565 646f 6d3a 2074 se of freedom: t │ │ │ │ │ -00014d70: 6f0a 2020 2020 2061 7373 7572 6520 6576 o. assure ev │ │ │ │ │ -00014d80: 6572 796f 6e65 2074 6865 2065 6666 6563 eryone the effec │ │ │ │ │ -00014d90: 7469 7665 2066 7265 6564 6f6d 2074 6f20 tive freedom to │ │ │ │ │ -00014da0: 636f 7079 2061 6e64 2072 6564 6973 7472 copy and redistr │ │ │ │ │ -00014db0: 6962 7574 6520 6974 2c0a 2020 2020 2077 ibute it,. w │ │ │ │ │ -00014dc0: 6974 6820 6f72 2077 6974 686f 7574 206d ith or without m │ │ │ │ │ -00014dd0: 6f64 6966 7969 6e67 2069 742c 2065 6974 odifying it, eit │ │ │ │ │ -00014de0: 6865 7220 636f 6d6d 6572 6369 616c 6c79 her commercially │ │ │ │ │ -00014df0: 206f 720a 2020 2020 206e 6f6e 636f 6d6d or. noncomm │ │ │ │ │ -00014e00: 6572 6369 616c 6c79 2e20 2053 6563 6f6e ercially. Secon │ │ │ │ │ -00014e10: 6461 7269 6c79 2c20 7468 6973 204c 6963 darily, this Lic │ │ │ │ │ -00014e20: 656e 7365 2070 7265 7365 7276 6573 2066 ense preserves f │ │ │ │ │ -00014e30: 6f72 2074 6865 0a20 2020 2020 6175 7468 or the. auth │ │ │ │ │ -00014e40: 6f72 2061 6e64 2070 7562 6c69 7368 6572 or and publisher │ │ │ │ │ -00014e50: 2061 2077 6179 2074 6f20 6765 7420 6372 a way to get cr │ │ │ │ │ -00014e60: 6564 6974 2066 6f72 2074 6865 6972 2077 edit for their w │ │ │ │ │ -00014e70: 6f72 6b2c 2077 6869 6c65 206e 6f74 0a20 ork, while not. │ │ │ │ │ -00014e80: 2020 2020 6265 696e 6720 636f 6e73 6964 being consid │ │ │ │ │ -00014e90: 6572 6564 2072 6573 706f 6e73 6962 6c65 ered responsible │ │ │ │ │ -00014ea0: 2066 6f72 206d 6f64 6966 6963 6174 696f for modificatio │ │ │ │ │ -00014eb0: 6e73 206d 6164 6520 6279 206f 7468 6572 ns made by other │ │ │ │ │ -00014ec0: 732e 0a0a 2020 2020 2054 6869 7320 4c69 s... This Li │ │ │ │ │ -00014ed0: 6365 6e73 6520 6973 2061 206b 696e 6420 cense is a kind │ │ │ │ │ -00014ee0: 6f66 2022 636f 7079 6c65 6674 222c 2077 of "copyleft", w │ │ │ │ │ -00014ef0: 6869 6368 206d 6561 6e73 2074 6861 7420 hich means that │ │ │ │ │ -00014f00: 6465 7269 7661 7469 7665 0a20 2020 2020 derivative. │ │ │ │ │ -00014f10: 776f 726b 7320 6f66 2074 6865 2064 6f63 works of the doc │ │ │ │ │ -00014f20: 756d 656e 7420 6d75 7374 2074 6865 6d73 ument must thems │ │ │ │ │ -00014f30: 656c 7665 7320 6265 2066 7265 6520 696e elves be free in │ │ │ │ │ -00014f40: 2074 6865 2073 616d 6520 7365 6e73 652e the same sense. │ │ │ │ │ -00014f50: 0a20 2020 2020 4974 2063 6f6d 706c 656d . It complem │ │ │ │ │ -00014f60: 656e 7473 2074 6865 2047 4e55 2047 656e ents the GNU Gen │ │ │ │ │ -00014f70: 6572 616c 2050 7562 6c69 6320 4c69 6365 eral Public Lice │ │ │ │ │ -00014f80: 6e73 652c 2077 6869 6368 2069 7320 6120 nse, which is a │ │ │ │ │ -00014f90: 636f 7079 6c65 6674 0a20 2020 2020 6c69 copyleft. li │ │ │ │ │ -00014fa0: 6365 6e73 6520 6465 7369 676e 6564 2066 cense designed f │ │ │ │ │ -00014fb0: 6f72 2066 7265 6520 736f 6674 7761 7265 or free software │ │ │ │ │ -00014fc0: 2e0a 0a20 2020 2020 5765 2068 6176 6520 ... We have │ │ │ │ │ -00014fd0: 6465 7369 676e 6564 2074 6869 7320 4c69 designed this Li │ │ │ │ │ -00014fe0: 6365 6e73 6520 696e 206f 7264 6572 2074 cense in order t │ │ │ │ │ -00014ff0: 6f20 7573 6520 6974 2066 6f72 206d 616e o use it for man │ │ │ │ │ -00015000: 7561 6c73 2066 6f72 0a20 2020 2020 6672 uals for. fr │ │ │ │ │ -00015010: 6565 2073 6f66 7477 6172 652c 2062 6563 ee software, bec │ │ │ │ │ -00015020: 6175 7365 2066 7265 6520 736f 6674 7761 ause free softwa │ │ │ │ │ -00015030: 7265 206e 6565 6473 2066 7265 6520 646f re needs free do │ │ │ │ │ -00015040: 6375 6d65 6e74 6174 696f 6e3a 2061 0a20 cumentation: a. │ │ │ │ │ -00015050: 2020 2020 6672 6565 2070 726f 6772 616d free program │ │ │ │ │ -00015060: 2073 686f 756c 6420 636f 6d65 2077 6974 should come wit │ │ │ │ │ -00015070: 6820 6d61 6e75 616c 7320 7072 6f76 6964 h manuals provid │ │ │ │ │ -00015080: 696e 6720 7468 6520 7361 6d65 2066 7265 ing the same fre │ │ │ │ │ -00015090: 6564 6f6d 730a 2020 2020 2074 6861 7420 edoms. that │ │ │ │ │ -000150a0: 7468 6520 736f 6674 7761 7265 2064 6f65 the software doe │ │ │ │ │ -000150b0: 732e 2020 4275 7420 7468 6973 204c 6963 s. But this Lic │ │ │ │ │ -000150c0: 656e 7365 2069 7320 6e6f 7420 6c69 6d69 ense is not limi │ │ │ │ │ -000150d0: 7465 6420 746f 0a20 2020 2020 736f 6674 ted to. soft │ │ │ │ │ -000150e0: 7761 7265 206d 616e 7561 6c73 3b20 6974 ware manuals; it │ │ │ │ │ -000150f0: 2063 616e 2062 6520 7573 6564 2066 6f72 can be used for │ │ │ │ │ -00015100: 2061 6e79 2074 6578 7475 616c 2077 6f72 any textual wor │ │ │ │ │ -00015110: 6b2c 2072 6567 6172 646c 6573 730a 2020 k, regardless. │ │ │ │ │ -00015120: 2020 206f 6620 7375 626a 6563 7420 6d61 of subject ma │ │ │ │ │ -00015130: 7474 6572 206f 7220 7768 6574 6865 7220 tter or whether │ │ │ │ │ -00015140: 6974 2069 7320 7075 626c 6973 6865 6420 it is published │ │ │ │ │ -00015150: 6173 2061 2070 7269 6e74 6564 2062 6f6f as a printed boo │ │ │ │ │ -00015160: 6b2e 2020 5765 0a20 2020 2020 7265 636f k. We. reco │ │ │ │ │ -00015170: 6d6d 656e 6420 7468 6973 204c 6963 656e mmend this Licen │ │ │ │ │ -00015180: 7365 2070 7269 6e63 6970 616c 6c79 2066 se principally f │ │ │ │ │ -00015190: 6f72 2077 6f72 6b73 2077 686f 7365 2070 or works whose p │ │ │ │ │ -000151a0: 7572 706f 7365 2069 730a 2020 2020 2069 urpose is. i │ │ │ │ │ -000151b0: 6e73 7472 7563 7469 6f6e 206f 7220 7265 nstruction or re │ │ │ │ │ -000151c0: 6665 7265 6e63 652e 0a0a 2020 312e 2041 ference... 1. A │ │ │ │ │ -000151d0: 5050 4c49 4341 4249 4c49 5459 2041 4e44 PPLICABILITY AND │ │ │ │ │ -000151e0: 2044 4546 494e 4954 494f 4e53 0a0a 2020 DEFINITIONS.. │ │ │ │ │ -000151f0: 2020 2054 6869 7320 4c69 6365 6e73 6520 This License │ │ │ │ │ -00015200: 6170 706c 6965 7320 746f 2061 6e79 206d applies to any m │ │ │ │ │ -00015210: 616e 7561 6c20 6f72 206f 7468 6572 2077 anual or other w │ │ │ │ │ -00015220: 6f72 6b2c 2069 6e20 616e 7920 6d65 6469 ork, in any medi │ │ │ │ │ -00015230: 756d 2c0a 2020 2020 2074 6861 7420 636f um,. that co │ │ │ │ │ -00015240: 6e74 6169 6e73 2061 206e 6f74 6963 6520 ntains a notice │ │ │ │ │ -00015250: 706c 6163 6564 2062 7920 7468 6520 636f placed by the co │ │ │ │ │ -00015260: 7079 7269 6768 7420 686f 6c64 6572 2073 pyright holder s │ │ │ │ │ -00015270: 6179 696e 6720 6974 2063 616e 0a20 2020 aying it can. │ │ │ │ │ -00015280: 2020 6265 2064 6973 7472 6962 7574 6564 be distributed │ │ │ │ │ -00015290: 2075 6e64 6572 2074 6865 2074 6572 6d73 under the terms │ │ │ │ │ -000152a0: 206f 6620 7468 6973 204c 6963 656e 7365 of this License │ │ │ │ │ -000152b0: 2e20 2053 7563 6820 6120 6e6f 7469 6365 . Such a notice │ │ │ │ │ -000152c0: 0a20 2020 2020 6772 616e 7473 2061 2077 . grants a w │ │ │ │ │ -000152d0: 6f72 6c64 2d77 6964 652c 2072 6f79 616c orld-wide, royal │ │ │ │ │ -000152e0: 7479 2d66 7265 6520 6c69 6365 6e73 652c ty-free license, │ │ │ │ │ -000152f0: 2075 6e6c 696d 6974 6564 2069 6e20 6475 unlimited in du │ │ │ │ │ -00015300: 7261 7469 6f6e 2c0a 2020 2020 2074 6f20 ration,. to │ │ │ │ │ -00015310: 7573 6520 7468 6174 2077 6f72 6b20 756e use that work un │ │ │ │ │ -00015320: 6465 7220 7468 6520 636f 6e64 6974 696f der the conditio │ │ │ │ │ -00015330: 6e73 2073 7461 7465 6420 6865 7265 696e ns stated herein │ │ │ │ │ -00015340: 2e20 2054 6865 0a20 2020 2020 2244 6f63 . The. "Doc │ │ │ │ │ -00015350: 756d 656e 7422 2c20 6265 6c6f 772c 2072 ument", below, r │ │ │ │ │ -00015360: 6566 6572 7320 746f 2061 6e79 2073 7563 efers to any suc │ │ │ │ │ -00015370: 6820 6d61 6e75 616c 206f 7220 776f 726b h manual or work │ │ │ │ │ -00015380: 2e20 2041 6e79 206d 656d 6265 720a 2020 . Any member. │ │ │ │ │ -00015390: 2020 206f 6620 7468 6520 7075 626c 6963 of the public │ │ │ │ │ -000153a0: 2069 7320 6120 6c69 6365 6e73 6565 2c20 is a licensee, │ │ │ │ │ -000153b0: 616e 6420 6973 2061 6464 7265 7373 6564 and is addressed │ │ │ │ │ -000153c0: 2061 7320 2279 6f75 222e 2020 596f 7520 as "you". You │ │ │ │ │ -000153d0: 6163 6365 7074 0a20 2020 2020 7468 6520 accept. the │ │ │ │ │ -000153e0: 6c69 6365 6e73 6520 6966 2079 6f75 2063 license if you c │ │ │ │ │ -000153f0: 6f70 792c 206d 6f64 6966 7920 6f72 2064 opy, modify or d │ │ │ │ │ -00015400: 6973 7472 6962 7574 6520 7468 6520 776f istribute the wo │ │ │ │ │ -00015410: 726b 2069 6e20 6120 7761 790a 2020 2020 rk in a way. │ │ │ │ │ -00015420: 2072 6571 7569 7269 6e67 2070 6572 6d69 requiring permi │ │ │ │ │ -00015430: 7373 696f 6e20 756e 6465 7220 636f 7079 ssion under copy │ │ │ │ │ -00015440: 7269 6768 7420 6c61 772e 0a0a 2020 2020 right law... │ │ │ │ │ -00015450: 2041 2022 4d6f 6469 6669 6564 2056 6572 A "Modified Ver │ │ │ │ │ -00015460: 7369 6f6e 2220 6f66 2074 6865 2044 6f63 sion" of the Doc │ │ │ │ │ -00015470: 756d 656e 7420 6d65 616e 7320 616e 7920 ument means any │ │ │ │ │ -00015480: 776f 726b 2063 6f6e 7461 696e 696e 6720 work containing │ │ │ │ │ -00015490: 7468 650a 2020 2020 2044 6f63 756d 656e the. Documen │ │ │ │ │ -000154a0: 7420 6f72 2061 2070 6f72 7469 6f6e 206f t or a portion o │ │ │ │ │ -000154b0: 6620 6974 2c20 6569 7468 6572 2063 6f70 f it, either cop │ │ │ │ │ -000154c0: 6965 6420 7665 7262 6174 696d 2c20 6f72 ied verbatim, or │ │ │ │ │ -000154d0: 2077 6974 680a 2020 2020 206d 6f64 6966 with. modif │ │ │ │ │ -000154e0: 6963 6174 696f 6e73 2061 6e64 2f6f 7220 ications and/or │ │ │ │ │ -000154f0: 7472 616e 736c 6174 6564 2069 6e74 6f20 translated into │ │ │ │ │ -00015500: 616e 6f74 6865 7220 6c61 6e67 7561 6765 another language │ │ │ │ │ -00015510: 2e0a 0a20 2020 2020 4120 2253 6563 6f6e ... A "Secon │ │ │ │ │ -00015520: 6461 7279 2053 6563 7469 6f6e 2220 6973 dary Section" is │ │ │ │ │ -00015530: 2061 206e 616d 6564 2061 7070 656e 6469 a named appendi │ │ │ │ │ -00015540: 7820 6f72 2061 2066 726f 6e74 2d6d 6174 x or a front-mat │ │ │ │ │ -00015550: 7465 7220 7365 6374 696f 6e0a 2020 2020 ter section. │ │ │ │ │ -00015560: 206f 6620 7468 6520 446f 6375 6d65 6e74 of the Document │ │ │ │ │ -00015570: 2074 6861 7420 6465 616c 7320 6578 636c that deals excl │ │ │ │ │ -00015580: 7573 6976 656c 7920 7769 7468 2074 6865 usively with the │ │ │ │ │ -00015590: 2072 656c 6174 696f 6e73 6869 7020 6f66 relationship of │ │ │ │ │ -000155a0: 2074 6865 0a20 2020 2020 7075 626c 6973 the. publis │ │ │ │ │ -000155b0: 6865 7273 206f 7220 6175 7468 6f72 7320 hers or authors │ │ │ │ │ -000155c0: 6f66 2074 6865 2044 6f63 756d 656e 7420 of the Document │ │ │ │ │ -000155d0: 746f 2074 6865 2044 6f63 756d 656e 7427 to the Document' │ │ │ │ │ -000155e0: 7320 6f76 6572 616c 6c0a 2020 2020 2073 s overall. s │ │ │ │ │ -000155f0: 7562 6a65 6374 2028 6f72 2074 6f20 7265 ubject (or to re │ │ │ │ │ -00015600: 6c61 7465 6420 6d61 7474 6572 7329 2061 lated matters) a │ │ │ │ │ -00015610: 6e64 2063 6f6e 7461 696e 7320 6e6f 7468 nd contains noth │ │ │ │ │ -00015620: 696e 6720 7468 6174 2063 6f75 6c64 0a20 ing that could. │ │ │ │ │ -00015630: 2020 2020 6661 6c6c 2064 6972 6563 746c fall directl │ │ │ │ │ -00015640: 7920 7769 7468 696e 2074 6861 7420 6f76 y within that ov │ │ │ │ │ -00015650: 6572 616c 6c20 7375 626a 6563 742e 2020 erall subject. │ │ │ │ │ -00015660: 2854 6875 732c 2069 6620 7468 6520 446f (Thus, if the Do │ │ │ │ │ -00015670: 6375 6d65 6e74 0a20 2020 2020 6973 2069 cument. is i │ │ │ │ │ -00015680: 6e20 7061 7274 2061 2074 6578 7462 6f6f n part a textboo │ │ │ │ │ -00015690: 6b20 6f66 206d 6174 6865 6d61 7469 6373 k of mathematics │ │ │ │ │ -000156a0: 2c20 6120 5365 636f 6e64 6172 7920 5365 , a Secondary Se │ │ │ │ │ -000156b0: 6374 696f 6e20 6d61 7920 6e6f 740a 2020 ction may not. │ │ │ │ │ -000156c0: 2020 2065 7870 6c61 696e 2061 6e79 206d explain any m │ │ │ │ │ -000156d0: 6174 6865 6d61 7469 6373 2e29 2020 5468 athematics.) Th │ │ │ │ │ -000156e0: 6520 7265 6c61 7469 6f6e 7368 6970 2063 e relationship c │ │ │ │ │ -000156f0: 6f75 6c64 2062 6520 6120 6d61 7474 6572 ould be a matter │ │ │ │ │ -00015700: 206f 660a 2020 2020 2068 6973 746f 7269 of. histori │ │ │ │ │ -00015710: 6361 6c20 636f 6e6e 6563 7469 6f6e 2077 cal connection w │ │ │ │ │ -00015720: 6974 6820 7468 6520 7375 626a 6563 7420 ith the subject │ │ │ │ │ -00015730: 6f72 2077 6974 6820 7265 6c61 7465 6420 or with related │ │ │ │ │ -00015740: 6d61 7474 6572 732c 206f 720a 2020 2020 matters, or. │ │ │ │ │ -00015750: 206f 6620 6c65 6761 6c2c 2063 6f6d 6d65 of legal, comme │ │ │ │ │ -00015760: 7263 6961 6c2c 2070 6869 6c6f 736f 7068 rcial, philosoph │ │ │ │ │ -00015770: 6963 616c 2c20 6574 6869 6361 6c20 6f72 ical, ethical or │ │ │ │ │ -00015780: 2070 6f6c 6974 6963 616c 2070 6f73 6974 political posit │ │ │ │ │ -00015790: 696f 6e0a 2020 2020 2072 6567 6172 6469 ion. regardi │ │ │ │ │ -000157a0: 6e67 2074 6865 6d2e 0a0a 2020 2020 2054 ng them... T │ │ │ │ │ -000157b0: 6865 2022 496e 7661 7269 616e 7420 5365 he "Invariant Se │ │ │ │ │ -000157c0: 6374 696f 6e73 2220 6172 6520 6365 7274 ctions" are cert │ │ │ │ │ -000157d0: 6169 6e20 5365 636f 6e64 6172 7920 5365 ain Secondary Se │ │ │ │ │ -000157e0: 6374 696f 6e73 2077 686f 7365 0a20 2020 ctions whose. │ │ │ │ │ -000157f0: 2020 7469 746c 6573 2061 7265 2064 6573 titles are des │ │ │ │ │ -00015800: 6967 6e61 7465 642c 2061 7320 6265 696e ignated, as bein │ │ │ │ │ -00015810: 6720 7468 6f73 6520 6f66 2049 6e76 6172 g those of Invar │ │ │ │ │ -00015820: 6961 6e74 2053 6563 7469 6f6e 732c 2069 iant Sections, i │ │ │ │ │ -00015830: 6e20 7468 650a 2020 2020 206e 6f74 6963 n the. notic │ │ │ │ │ -00015840: 6520 7468 6174 2073 6179 7320 7468 6174 e that says that │ │ │ │ │ -00015850: 2074 6865 2044 6f63 756d 656e 7420 6973 the Document is │ │ │ │ │ -00015860: 2072 656c 6561 7365 6420 756e 6465 7220 released under │ │ │ │ │ -00015870: 7468 6973 204c 6963 656e 7365 2e0a 2020 this License.. │ │ │ │ │ -00015880: 2020 2049 6620 6120 7365 6374 696f 6e20 If a section │ │ │ │ │ -00015890: 646f 6573 206e 6f74 2066 6974 2074 6865 does not fit the │ │ │ │ │ -000158a0: 2061 626f 7665 2064 6566 696e 6974 696f above definitio │ │ │ │ │ -000158b0: 6e20 6f66 2053 6563 6f6e 6461 7279 2074 n of Secondary t │ │ │ │ │ -000158c0: 6865 6e20 6974 0a20 2020 2020 6973 206e hen it. is n │ │ │ │ │ -000158d0: 6f74 2061 6c6c 6f77 6564 2074 6f20 6265 ot allowed to be │ │ │ │ │ -000158e0: 2064 6573 6967 6e61 7465 6420 6173 2049 designated as I │ │ │ │ │ -000158f0: 6e76 6172 6961 6e74 2e20 2054 6865 2044 nvariant. The D │ │ │ │ │ -00015900: 6f63 756d 656e 7420 6d61 790a 2020 2020 ocument may. │ │ │ │ │ -00015910: 2063 6f6e 7461 696e 207a 6572 6f20 496e contain zero In │ │ │ │ │ -00015920: 7661 7269 616e 7420 5365 6374 696f 6e73 variant Sections │ │ │ │ │ -00015930: 2e20 2049 6620 7468 6520 446f 6375 6d65 . If the Docume │ │ │ │ │ -00015940: 6e74 2064 6f65 7320 6e6f 7420 6964 656e nt does not iden │ │ │ │ │ -00015950: 7469 6679 0a20 2020 2020 616e 7920 496e tify. any In │ │ │ │ │ -00015960: 7661 7269 616e 7420 5365 6374 696f 6e73 variant Sections │ │ │ │ │ -00015970: 2074 6865 6e20 7468 6572 6520 6172 6520 then there are │ │ │ │ │ -00015980: 6e6f 6e65 2e0a 0a20 2020 2020 5468 6520 none... The │ │ │ │ │ -00015990: 2243 6f76 6572 2054 6578 7473 2220 6172 "Cover Texts" ar │ │ │ │ │ -000159a0: 6520 6365 7274 6169 6e20 7368 6f72 7420 e certain short │ │ │ │ │ -000159b0: 7061 7373 6167 6573 206f 6620 7465 7874 passages of text │ │ │ │ │ -000159c0: 2074 6861 7420 6172 650a 2020 2020 206c that are. l │ │ │ │ │ -000159d0: 6973 7465 642c 2061 7320 4672 6f6e 742d isted, as Front- │ │ │ │ │ -000159e0: 436f 7665 7220 5465 7874 7320 6f72 2042 Cover Texts or B │ │ │ │ │ -000159f0: 6163 6b2d 436f 7665 7220 5465 7874 732c ack-Cover Texts, │ │ │ │ │ -00015a00: 2069 6e20 7468 6520 6e6f 7469 6365 0a20 in the notice. │ │ │ │ │ -00015a10: 2020 2020 7468 6174 2073 6179 7320 7468 that says th │ │ │ │ │ -00015a20: 6174 2074 6865 2044 6f63 756d 656e 7420 at the Document │ │ │ │ │ -00015a30: 6973 2072 656c 6561 7365 6420 756e 6465 is released unde │ │ │ │ │ -00015a40: 7220 7468 6973 204c 6963 656e 7365 2e20 r this License. │ │ │ │ │ -00015a50: 2041 0a20 2020 2020 4672 6f6e 742d 436f A. Front-Co │ │ │ │ │ -00015a60: 7665 7220 5465 7874 206d 6179 2062 6520 ver Text may be │ │ │ │ │ -00015a70: 6174 206d 6f73 7420 3520 776f 7264 732c at most 5 words, │ │ │ │ │ -00015a80: 2061 6e64 2061 2042 6163 6b2d 436f 7665 and a Back-Cove │ │ │ │ │ -00015a90: 7220 5465 7874 206d 6179 0a20 2020 2020 r Text may. │ │ │ │ │ -00015aa0: 6265 2061 7420 6d6f 7374 2032 3520 776f be at most 25 wo │ │ │ │ │ -00015ab0: 7264 732e 0a0a 2020 2020 2041 2022 5472 rds... A "Tr │ │ │ │ │ -00015ac0: 616e 7370 6172 656e 7422 2063 6f70 7920 ansparent" copy │ │ │ │ │ -00015ad0: 6f66 2074 6865 2044 6f63 756d 656e 7420 of the Document │ │ │ │ │ -00015ae0: 6d65 616e 7320 6120 6d61 6368 696e 652d means a machine- │ │ │ │ │ -00015af0: 7265 6164 6162 6c65 2063 6f70 792c 0a20 readable copy,. │ │ │ │ │ -00015b00: 2020 2020 7265 7072 6573 656e 7465 6420 represented │ │ │ │ │ -00015b10: 696e 2061 2066 6f72 6d61 7420 7768 6f73 in a format whos │ │ │ │ │ -00015b20: 6520 7370 6563 6966 6963 6174 696f 6e20 e specification │ │ │ │ │ -00015b30: 6973 2061 7661 696c 6162 6c65 2074 6f20 is available to │ │ │ │ │ -00015b40: 7468 650a 2020 2020 2067 656e 6572 616c the. general │ │ │ │ │ -00015b50: 2070 7562 6c69 632c 2074 6861 7420 6973 public, that is │ │ │ │ │ -00015b60: 2073 7569 7461 626c 6520 666f 7220 7265 suitable for re │ │ │ │ │ -00015b70: 7669 7369 6e67 2074 6865 2064 6f63 756d vising the docum │ │ │ │ │ -00015b80: 656e 740a 2020 2020 2073 7472 6169 6768 ent. straigh │ │ │ │ │ -00015b90: 7466 6f72 7761 7264 6c79 2077 6974 6820 tforwardly with │ │ │ │ │ -00015ba0: 6765 6e65 7269 6320 7465 7874 2065 6469 generic text edi │ │ │ │ │ -00015bb0: 746f 7273 206f 7220 2866 6f72 2069 6d61 tors or (for ima │ │ │ │ │ -00015bc0: 6765 7320 636f 6d70 6f73 6564 0a20 2020 ges composed. │ │ │ │ │ -00015bd0: 2020 6f66 2070 6978 656c 7329 2067 656e of pixels) gen │ │ │ │ │ -00015be0: 6572 6963 2070 6169 6e74 2070 726f 6772 eric paint progr │ │ │ │ │ -00015bf0: 616d 7320 6f72 2028 666f 7220 6472 6177 ams or (for draw │ │ │ │ │ -00015c00: 696e 6773 2920 736f 6d65 2077 6964 656c ings) some widel │ │ │ │ │ -00015c10: 790a 2020 2020 2061 7661 696c 6162 6c65 y. available │ │ │ │ │ -00015c20: 2064 7261 7769 6e67 2065 6469 746f 722c drawing editor, │ │ │ │ │ -00015c30: 2061 6e64 2074 6861 7420 6973 2073 7569 and that is sui │ │ │ │ │ -00015c40: 7461 626c 6520 666f 7220 696e 7075 7420 table for input │ │ │ │ │ -00015c50: 746f 2074 6578 740a 2020 2020 2066 6f72 to text. for │ │ │ │ │ -00015c60: 6d61 7474 6572 7320 6f72 2066 6f72 2061 matters or for a │ │ │ │ │ -00015c70: 7574 6f6d 6174 6963 2074 7261 6e73 6c61 utomatic transla │ │ │ │ │ -00015c80: 7469 6f6e 2074 6f20 6120 7661 7269 6574 tion to a variet │ │ │ │ │ -00015c90: 7920 6f66 2066 6f72 6d61 7473 0a20 2020 y of formats. │ │ │ │ │ -00015ca0: 2020 7375 6974 6162 6c65 2066 6f72 2069 suitable for i │ │ │ │ │ -00015cb0: 6e70 7574 2074 6f20 7465 7874 2066 6f72 nput to text for │ │ │ │ │ -00015cc0: 6d61 7474 6572 732e 2020 4120 636f 7079 matters. A copy │ │ │ │ │ -00015cd0: 206d 6164 6520 696e 2061 6e20 6f74 6865 made in an othe │ │ │ │ │ -00015ce0: 7277 6973 650a 2020 2020 2054 7261 6e73 rwise. Trans │ │ │ │ │ -00015cf0: 7061 7265 6e74 2066 696c 6520 666f 726d parent file form │ │ │ │ │ -00015d00: 6174 2077 686f 7365 206d 6172 6b75 702c at whose markup, │ │ │ │ │ -00015d10: 206f 7220 6162 7365 6e63 6520 6f66 206d or absence of m │ │ │ │ │ -00015d20: 6172 6b75 702c 2068 6173 0a20 2020 2020 arkup, has. │ │ │ │ │ -00015d30: 6265 656e 2061 7272 616e 6765 6420 746f been arranged to │ │ │ │ │ -00015d40: 2074 6877 6172 7420 6f72 2064 6973 636f thwart or disco │ │ │ │ │ -00015d50: 7572 6167 6520 7375 6273 6571 7565 6e74 urage subsequent │ │ │ │ │ -00015d60: 206d 6f64 6966 6963 6174 696f 6e20 6279 modification by │ │ │ │ │ -00015d70: 0a20 2020 2020 7265 6164 6572 7320 6973 . readers is │ │ │ │ │ -00015d80: 206e 6f74 2054 7261 6e73 7061 7265 6e74 not Transparent │ │ │ │ │ -00015d90: 2e20 2041 6e20 696d 6167 6520 666f 726d . An image form │ │ │ │ │ -00015da0: 6174 2069 7320 6e6f 7420 5472 616e 7370 at is not Transp │ │ │ │ │ -00015db0: 6172 656e 7420 6966 0a20 2020 2020 7573 arent if. us │ │ │ │ │ -00015dc0: 6564 2066 6f72 2061 6e79 2073 7562 7374 ed for any subst │ │ │ │ │ -00015dd0: 616e 7469 616c 2061 6d6f 756e 7420 6f66 antial amount of │ │ │ │ │ -00015de0: 2074 6578 742e 2020 4120 636f 7079 2074 text. A copy t │ │ │ │ │ -00015df0: 6861 7420 6973 206e 6f74 0a20 2020 2020 hat is not. │ │ │ │ │ -00015e00: 2254 7261 6e73 7061 7265 6e74 2220 6973 "Transparent" is │ │ │ │ │ -00015e10: 2063 616c 6c65 6420 224f 7061 7175 6522 called "Opaque" │ │ │ │ │ -00015e20: 2e0a 0a20 2020 2020 4578 616d 706c 6573 ... Examples │ │ │ │ │ -00015e30: 206f 6620 7375 6974 6162 6c65 2066 6f72 of suitable for │ │ │ │ │ -00015e40: 6d61 7473 2066 6f72 2054 7261 6e73 7061 mats for Transpa │ │ │ │ │ -00015e50: 7265 6e74 2063 6f70 6965 7320 696e 636c rent copies incl │ │ │ │ │ -00015e60: 7564 6520 706c 6169 6e0a 2020 2020 2041 ude plain. A │ │ │ │ │ -00015e70: 5343 4949 2077 6974 686f 7574 206d 6172 SCII without mar │ │ │ │ │ -00015e80: 6b75 702c 2054 6578 696e 666f 2069 6e70 kup, Texinfo inp │ │ │ │ │ -00015e90: 7574 2066 6f72 6d61 742c 204c 6154 6558 ut format, LaTeX │ │ │ │ │ -00015ea0: 2069 6e70 7574 2066 6f72 6d61 742c 0a20 input format,. │ │ │ │ │ -00015eb0: 2020 2020 5347 4d4c 206f 7220 584d 4c20 SGML or XML │ │ │ │ │ -00015ec0: 7573 696e 6720 6120 7075 626c 6963 6c79 using a publicly │ │ │ │ │ -00015ed0: 2061 7661 696c 6162 6c65 2044 5444 2c20 available DTD, │ │ │ │ │ -00015ee0: 616e 6420 7374 616e 6461 7264 2d63 6f6e and standard-con │ │ │ │ │ -00015ef0: 666f 726d 696e 670a 2020 2020 2073 696d forming. sim │ │ │ │ │ -00015f00: 706c 6520 4854 4d4c 2c20 506f 7374 5363 ple HTML, PostSc │ │ │ │ │ -00015f10: 7269 7074 206f 7220 5044 4620 6465 7369 ript or PDF desi │ │ │ │ │ -00015f20: 676e 6564 2066 6f72 2068 756d 616e 206d gned for human m │ │ │ │ │ -00015f30: 6f64 6966 6963 6174 696f 6e2e 0a20 2020 odification.. │ │ │ │ │ -00015f40: 2020 4578 616d 706c 6573 206f 6620 7472 Examples of tr │ │ │ │ │ -00015f50: 616e 7370 6172 656e 7420 696d 6167 6520 ansparent image │ │ │ │ │ -00015f60: 666f 726d 6174 7320 696e 636c 7564 6520 formats include │ │ │ │ │ -00015f70: 504e 472c 2058 4346 2061 6e64 204a 5047 PNG, XCF and JPG │ │ │ │ │ -00015f80: 2e0a 2020 2020 204f 7061 7175 6520 666f .. Opaque fo │ │ │ │ │ -00015f90: 726d 6174 7320 696e 636c 7564 6520 7072 rmats include pr │ │ │ │ │ -00015fa0: 6f70 7269 6574 6172 7920 666f 726d 6174 oprietary format │ │ │ │ │ -00015fb0: 7320 7468 6174 2063 616e 2062 6520 7265 s that can be re │ │ │ │ │ -00015fc0: 6164 2061 6e64 0a20 2020 2020 6564 6974 ad and. edit │ │ │ │ │ -00015fd0: 6564 206f 6e6c 7920 6279 2070 726f 7072 ed only by propr │ │ │ │ │ -00015fe0: 6965 7461 7279 2077 6f72 6420 7072 6f63 ietary word proc │ │ │ │ │ -00015ff0: 6573 736f 7273 2c20 5347 4d4c 206f 7220 essors, SGML or │ │ │ │ │ -00016000: 584d 4c20 666f 7220 7768 6963 680a 2020 XML for which. │ │ │ │ │ -00016010: 2020 2074 6865 2044 5444 2061 6e64 2f6f the DTD and/o │ │ │ │ │ -00016020: 7220 7072 6f63 6573 7369 6e67 2074 6f6f r processing too │ │ │ │ │ -00016030: 6c73 2061 7265 206e 6f74 2067 656e 6572 ls are not gener │ │ │ │ │ -00016040: 616c 6c79 2061 7661 696c 6162 6c65 2c20 ally available, │ │ │ │ │ -00016050: 616e 640a 2020 2020 2074 6865 206d 6163 and. the mac │ │ │ │ │ -00016060: 6869 6e65 2d67 656e 6572 6174 6564 2048 hine-generated H │ │ │ │ │ -00016070: 544d 4c2c 2050 6f73 7453 6372 6970 7420 TML, PostScript │ │ │ │ │ -00016080: 6f72 2050 4446 2070 726f 6475 6365 6420 or PDF produced │ │ │ │ │ -00016090: 6279 2073 6f6d 6520 776f 7264 0a20 2020 by some word. │ │ │ │ │ -000160a0: 2020 7072 6f63 6573 736f 7273 2066 6f72 processors for │ │ │ │ │ -000160b0: 206f 7574 7075 7420 7075 7270 6f73 6573 output purposes │ │ │ │ │ -000160c0: 206f 6e6c 792e 0a0a 2020 2020 2054 6865 only... The │ │ │ │ │ -000160d0: 2022 5469 746c 6520 5061 6765 2220 6d65 "Title Page" me │ │ │ │ │ -000160e0: 616e 732c 2066 6f72 2061 2070 7269 6e74 ans, for a print │ │ │ │ │ -000160f0: 6564 2062 6f6f 6b2c 2074 6865 2074 6974 ed book, the tit │ │ │ │ │ -00016100: 6c65 2070 6167 6520 6974 7365 6c66 2c0a le page itself,. │ │ │ │ │ -00016110: 2020 2020 2070 6c75 7320 7375 6368 2066 plus such f │ │ │ │ │ -00016120: 6f6c 6c6f 7769 6e67 2070 6167 6573 2061 ollowing pages a │ │ │ │ │ -00016130: 7320 6172 6520 6e65 6564 6564 2074 6f20 s are needed to │ │ │ │ │ -00016140: 686f 6c64 2c20 6c65 6769 626c 792c 2074 hold, legibly, t │ │ │ │ │ -00016150: 6865 0a20 2020 2020 6d61 7465 7269 616c he. material │ │ │ │ │ -00016160: 2074 6869 7320 4c69 6365 6e73 6520 7265 this License re │ │ │ │ │ -00016170: 7175 6972 6573 2074 6f20 6170 7065 6172 quires to appear │ │ │ │ │ -00016180: 2069 6e20 7468 6520 7469 746c 6520 7061 in the title pa │ │ │ │ │ -00016190: 6765 2e20 2046 6f72 0a20 2020 2020 776f ge. For. wo │ │ │ │ │ -000161a0: 726b 7320 696e 2066 6f72 6d61 7473 2077 rks in formats w │ │ │ │ │ -000161b0: 6869 6368 2064 6f20 6e6f 7420 6861 7665 hich do not have │ │ │ │ │ -000161c0: 2061 6e79 2074 6974 6c65 2070 6167 6520 any title page │ │ │ │ │ -000161d0: 6173 2073 7563 682c 2022 5469 746c 650a as such, "Title. │ │ │ │ │ -000161e0: 2020 2020 2050 6167 6522 206d 6561 6e73 Page" means │ │ │ │ │ -000161f0: 2074 6865 2074 6578 7420 6e65 6172 2074 the text near t │ │ │ │ │ -00016200: 6865 206d 6f73 7420 7072 6f6d 696e 656e he most prominen │ │ │ │ │ -00016210: 7420 6170 7065 6172 616e 6365 206f 6620 t appearance of │ │ │ │ │ -00016220: 7468 650a 2020 2020 2077 6f72 6b27 7320 the. work's │ │ │ │ │ -00016230: 7469 746c 652c 2070 7265 6365 6469 6e67 title, preceding │ │ │ │ │ -00016240: 2074 6865 2062 6567 696e 6e69 6e67 206f the beginning o │ │ │ │ │ -00016250: 6620 7468 6520 626f 6479 206f 6620 7468 f the body of th │ │ │ │ │ -00016260: 6520 7465 7874 2e0a 0a20 2020 2020 4120 e text... A │ │ │ │ │ -00016270: 7365 6374 696f 6e20 2245 6e74 6974 6c65 section "Entitle │ │ │ │ │ -00016280: 6420 5859 5a22 206d 6561 6e73 2061 206e d XYZ" means a n │ │ │ │ │ -00016290: 616d 6564 2073 7562 756e 6974 206f 6620 amed subunit of │ │ │ │ │ -000162a0: 7468 6520 446f 6375 6d65 6e74 0a20 2020 the Document. │ │ │ │ │ -000162b0: 2020 7768 6f73 6520 7469 746c 6520 6569 whose title ei │ │ │ │ │ -000162c0: 7468 6572 2069 7320 7072 6563 6973 656c ther is precisel │ │ │ │ │ -000162d0: 7920 5859 5a20 6f72 2063 6f6e 7461 696e y XYZ or contain │ │ │ │ │ -000162e0: 7320 5859 5a20 696e 2070 6172 656e 7468 s XYZ in parenth │ │ │ │ │ -000162f0: 6573 6573 0a20 2020 2020 666f 6c6c 6f77 eses. follow │ │ │ │ │ -00016300: 696e 6720 7465 7874 2074 6861 7420 7472 ing text that tr │ │ │ │ │ -00016310: 616e 736c 6174 6573 2058 595a 2069 6e20 anslates XYZ in │ │ │ │ │ -00016320: 616e 6f74 6865 7220 6c61 6e67 7561 6765 another language │ │ │ │ │ -00016330: 2e20 2028 4865 7265 2058 595a 0a20 2020 . (Here XYZ. │ │ │ │ │ -00016340: 2020 7374 616e 6473 2066 6f72 2061 2073 stands for a s │ │ │ │ │ -00016350: 7065 6369 6669 6320 7365 6374 696f 6e20 pecific section │ │ │ │ │ -00016360: 6e61 6d65 206d 656e 7469 6f6e 6564 2062 name mentioned b │ │ │ │ │ -00016370: 656c 6f77 2c20 7375 6368 2061 730a 2020 elow, such as. │ │ │ │ │ -00016380: 2020 2022 4163 6b6e 6f77 6c65 6467 656d "Acknowledgem │ │ │ │ │ -00016390: 656e 7473 222c 2022 4465 6469 6361 7469 ents", "Dedicati │ │ │ │ │ -000163a0: 6f6e 7322 2c20 2245 6e64 6f72 7365 6d65 ons", "Endorseme │ │ │ │ │ -000163b0: 6e74 7322 2c20 6f72 2022 4869 7374 6f72 nts", or "Histor │ │ │ │ │ -000163c0: 7922 2e29 0a20 2020 2020 546f 2022 5072 y".). To "Pr │ │ │ │ │ -000163d0: 6573 6572 7665 2074 6865 2054 6974 6c65 eserve the Title │ │ │ │ │ -000163e0: 2220 6f66 2073 7563 6820 6120 7365 6374 " of such a sect │ │ │ │ │ -000163f0: 696f 6e20 7768 656e 2079 6f75 206d 6f64 ion when you mod │ │ │ │ │ -00016400: 6966 7920 7468 650a 2020 2020 2044 6f63 ify the. Doc │ │ │ │ │ -00016410: 756d 656e 7420 6d65 616e 7320 7468 6174 ument means that │ │ │ │ │ -00016420: 2069 7420 7265 6d61 696e 7320 6120 7365 it remains a se │ │ │ │ │ -00016430: 6374 696f 6e20 2245 6e74 6974 6c65 6420 ction "Entitled │ │ │ │ │ -00016440: 5859 5a22 2061 6363 6f72 6469 6e67 0a20 XYZ" according. │ │ │ │ │ -00016450: 2020 2020 746f 2074 6869 7320 6465 6669 to this defi │ │ │ │ │ -00016460: 6e69 7469 6f6e 2e0a 0a20 2020 2020 5468 nition... Th │ │ │ │ │ -00016470: 6520 446f 6375 6d65 6e74 206d 6179 2069 e Document may i │ │ │ │ │ -00016480: 6e63 6c75 6465 2057 6172 7261 6e74 7920 nclude Warranty │ │ │ │ │ -00016490: 4469 7363 6c61 696d 6572 7320 6e65 7874 Disclaimers next │ │ │ │ │ -000164a0: 2074 6f20 7468 6520 6e6f 7469 6365 0a20 to the notice. │ │ │ │ │ -000164b0: 2020 2020 7768 6963 6820 7374 6174 6573 which states │ │ │ │ │ -000164c0: 2074 6861 7420 7468 6973 204c 6963 656e that this Licen │ │ │ │ │ -000164d0: 7365 2061 7070 6c69 6573 2074 6f20 7468 se applies to th │ │ │ │ │ -000164e0: 6520 446f 6375 6d65 6e74 2e20 2054 6865 e Document. The │ │ │ │ │ -000164f0: 7365 0a20 2020 2020 5761 7272 616e 7479 se. Warranty │ │ │ │ │ -00016500: 2044 6973 636c 6169 6d65 7273 2061 7265 Disclaimers are │ │ │ │ │ -00016510: 2063 6f6e 7369 6465 7265 6420 746f 2062 considered to b │ │ │ │ │ -00016520: 6520 696e 636c 7564 6564 2062 7920 7265 e included by re │ │ │ │ │ -00016530: 6665 7265 6e63 6520 696e 0a20 2020 2020 ference in. │ │ │ │ │ -00016540: 7468 6973 204c 6963 656e 7365 2c20 6275 this License, bu │ │ │ │ │ -00016550: 7420 6f6e 6c79 2061 7320 7265 6761 7264 t only as regard │ │ │ │ │ -00016560: 7320 6469 7363 6c61 696d 696e 6720 7761 s disclaiming wa │ │ │ │ │ -00016570: 7272 616e 7469 6573 3a20 616e 7920 6f74 rranties: any ot │ │ │ │ │ -00016580: 6865 720a 2020 2020 2069 6d70 6c69 6361 her. implica │ │ │ │ │ -00016590: 7469 6f6e 2074 6861 7420 7468 6573 6520 tion that these │ │ │ │ │ -000165a0: 5761 7272 616e 7479 2044 6973 636c 6169 Warranty Disclai │ │ │ │ │ -000165b0: 6d65 7273 206d 6179 2068 6176 6520 6973 mers may have is │ │ │ │ │ -000165c0: 2076 6f69 6420 616e 640a 2020 2020 2068 void and. h │ │ │ │ │ -000165d0: 6173 206e 6f20 6566 6665 6374 206f 6e20 as no effect on │ │ │ │ │ -000165e0: 7468 6520 6d65 616e 696e 6720 6f66 2074 the meaning of t │ │ │ │ │ -000165f0: 6869 7320 4c69 6365 6e73 652e 0a0a 2020 his License... │ │ │ │ │ -00016600: 322e 2056 4552 4241 5449 4d20 434f 5059 2. VERBATIM COPY │ │ │ │ │ -00016610: 494e 470a 0a20 2020 2020 596f 7520 6d61 ING.. You ma │ │ │ │ │ -00016620: 7920 636f 7079 2061 6e64 2064 6973 7472 y copy and distr │ │ │ │ │ -00016630: 6962 7574 6520 7468 6520 446f 6375 6d65 ibute the Docume │ │ │ │ │ -00016640: 6e74 2069 6e20 616e 7920 6d65 6469 756d nt in any medium │ │ │ │ │ -00016650: 2c20 6569 7468 6572 0a20 2020 2020 636f , either. co │ │ │ │ │ -00016660: 6d6d 6572 6369 616c 6c79 206f 7220 6e6f mmercially or no │ │ │ │ │ -00016670: 6e63 6f6d 6d65 7263 6961 6c6c 792c 2070 ncommercially, p │ │ │ │ │ -00016680: 726f 7669 6465 6420 7468 6174 2074 6869 rovided that thi │ │ │ │ │ -00016690: 7320 4c69 6365 6e73 652c 2074 6865 0a20 s License, the. │ │ │ │ │ -000166a0: 2020 2020 636f 7079 7269 6768 7420 6e6f copyright no │ │ │ │ │ -000166b0: 7469 6365 732c 2061 6e64 2074 6865 206c tices, and the l │ │ │ │ │ -000166c0: 6963 656e 7365 206e 6f74 6963 6520 7361 icense notice sa │ │ │ │ │ -000166d0: 7969 6e67 2074 6869 7320 4c69 6365 6e73 ying this Licens │ │ │ │ │ -000166e0: 650a 2020 2020 2061 7070 6c69 6573 2074 e. applies t │ │ │ │ │ -000166f0: 6f20 7468 6520 446f 6375 6d65 6e74 2061 o the Document a │ │ │ │ │ -00016700: 7265 2072 6570 726f 6475 6365 6420 696e re reproduced in │ │ │ │ │ -00016710: 2061 6c6c 2063 6f70 6965 732c 2061 6e64 all copies, and │ │ │ │ │ -00016720: 2074 6861 7420 796f 750a 2020 2020 2061 that you. a │ │ │ │ │ -00016730: 6464 206e 6f20 6f74 6865 7220 636f 6e64 dd no other cond │ │ │ │ │ -00016740: 6974 696f 6e73 2077 6861 7473 6f65 7665 itions whatsoeve │ │ │ │ │ -00016750: 7220 746f 2074 686f 7365 206f 6620 7468 r to those of th │ │ │ │ │ -00016760: 6973 204c 6963 656e 7365 2e20 2059 6f75 is License. You │ │ │ │ │ -00016770: 0a20 2020 2020 6d61 7920 6e6f 7420 7573 . may not us │ │ │ │ │ -00016780: 6520 7465 6368 6e69 6361 6c20 6d65 6173 e technical meas │ │ │ │ │ -00016790: 7572 6573 2074 6f20 6f62 7374 7275 6374 ures to obstruct │ │ │ │ │ -000167a0: 206f 7220 636f 6e74 726f 6c20 7468 6520 or control the │ │ │ │ │ -000167b0: 7265 6164 696e 670a 2020 2020 206f 7220 reading. or │ │ │ │ │ -000167c0: 6675 7274 6865 7220 636f 7079 696e 6720 further copying │ │ │ │ │ -000167d0: 6f66 2074 6865 2063 6f70 6965 7320 796f of the copies yo │ │ │ │ │ -000167e0: 7520 6d61 6b65 206f 7220 6469 7374 7269 u make or distri │ │ │ │ │ -000167f0: 6275 7465 2e20 2048 6f77 6576 6572 2c0a bute. However,. │ │ │ │ │ -00016800: 2020 2020 2079 6f75 206d 6179 2061 6363 you may acc │ │ │ │ │ -00016810: 6570 7420 636f 6d70 656e 7361 7469 6f6e ept compensation │ │ │ │ │ -00016820: 2069 6e20 6578 6368 616e 6765 2066 6f72 in exchange for │ │ │ │ │ -00016830: 2063 6f70 6965 732e 2020 4966 2079 6f75 copies. If you │ │ │ │ │ -00016840: 0a20 2020 2020 6469 7374 7269 6275 7465 . distribute │ │ │ │ │ -00016850: 2061 206c 6172 6765 2065 6e6f 7567 6820 a large enough │ │ │ │ │ -00016860: 6e75 6d62 6572 206f 6620 636f 7069 6573 number of copies │ │ │ │ │ -00016870: 2079 6f75 206d 7573 7420 616c 736f 2066 you must also f │ │ │ │ │ -00016880: 6f6c 6c6f 7720 7468 650a 2020 2020 2063 ollow the. c │ │ │ │ │ -00016890: 6f6e 6469 7469 6f6e 7320 696e 2073 6563 onditions in sec │ │ │ │ │ -000168a0: 7469 6f6e 2033 2e0a 0a20 2020 2020 596f tion 3... Yo │ │ │ │ │ -000168b0: 7520 6d61 7920 616c 736f 206c 656e 6420 u may also lend │ │ │ │ │ -000168c0: 636f 7069 6573 2c20 756e 6465 7220 7468 copies, under th │ │ │ │ │ -000168d0: 6520 7361 6d65 2063 6f6e 6469 7469 6f6e e same condition │ │ │ │ │ -000168e0: 7320 7374 6174 6564 2061 626f 7665 2c0a s stated above,. │ │ │ │ │ -000168f0: 2020 2020 2061 6e64 2079 6f75 206d 6179 and you may │ │ │ │ │ -00016900: 2070 7562 6c69 636c 7920 6469 7370 6c61 publicly displa │ │ │ │ │ -00016910: 7920 636f 7069 6573 2e0a 0a20 2033 2e20 y copies... 3. │ │ │ │ │ -00016920: 434f 5059 494e 4720 494e 2051 5541 4e54 COPYING IN QUANT │ │ │ │ │ -00016930: 4954 590a 0a20 2020 2020 4966 2079 6f75 ITY.. If you │ │ │ │ │ -00016940: 2070 7562 6c69 7368 2070 7269 6e74 6564 publish printed │ │ │ │ │ -00016950: 2063 6f70 6965 7320 286f 7220 636f 7069 copies (or copi │ │ │ │ │ -00016960: 6573 2069 6e20 6d65 6469 6120 7468 6174 es in media that │ │ │ │ │ -00016970: 2063 6f6d 6d6f 6e6c 790a 2020 2020 2068 commonly. h │ │ │ │ │ -00016980: 6176 6520 7072 696e 7465 6420 636f 7665 ave printed cove │ │ │ │ │ -00016990: 7273 2920 6f66 2074 6865 2044 6f63 756d rs) of the Docum │ │ │ │ │ -000169a0: 656e 742c 206e 756d 6265 7269 6e67 206d ent, numbering m │ │ │ │ │ -000169b0: 6f72 6520 7468 616e 2031 3030 2c20 616e ore than 100, an │ │ │ │ │ -000169c0: 640a 2020 2020 2074 6865 2044 6f63 756d d. the Docum │ │ │ │ │ -000169d0: 656e 7427 7320 6c69 6365 6e73 6520 6e6f ent's license no │ │ │ │ │ -000169e0: 7469 6365 2072 6571 7569 7265 7320 436f tice requires Co │ │ │ │ │ -000169f0: 7665 7220 5465 7874 732c 2079 6f75 206d ver Texts, you m │ │ │ │ │ -00016a00: 7573 740a 2020 2020 2065 6e63 6c6f 7365 ust. enclose │ │ │ │ │ -00016a10: 2074 6865 2063 6f70 6965 7320 696e 2063 the copies in c │ │ │ │ │ -00016a20: 6f76 6572 7320 7468 6174 2063 6172 7279 overs that carry │ │ │ │ │ -00016a30: 2c20 636c 6561 726c 7920 616e 6420 6c65 , clearly and le │ │ │ │ │ -00016a40: 6769 626c 792c 2061 6c6c 0a20 2020 2020 gibly, all. │ │ │ │ │ -00016a50: 7468 6573 6520 436f 7665 7220 5465 7874 these Cover Text │ │ │ │ │ -00016a60: 733a 2046 726f 6e74 2d43 6f76 6572 2054 s: Front-Cover T │ │ │ │ │ -00016a70: 6578 7473 206f 6e20 7468 6520 6672 6f6e exts on the fron │ │ │ │ │ -00016a80: 7420 636f 7665 722c 2061 6e64 0a20 2020 t cover, and. │ │ │ │ │ -00016a90: 2020 4261 636b 2d43 6f76 6572 2054 6578 Back-Cover Tex │ │ │ │ │ -00016aa0: 7473 206f 6e20 7468 6520 6261 636b 2063 ts on the back c │ │ │ │ │ -00016ab0: 6f76 6572 2e20 2042 6f74 6820 636f 7665 over. Both cove │ │ │ │ │ -00016ac0: 7273 206d 7573 7420 616c 736f 2063 6c65 rs must also cle │ │ │ │ │ -00016ad0: 6172 6c79 0a20 2020 2020 616e 6420 6c65 arly. and le │ │ │ │ │ -00016ae0: 6769 626c 7920 6964 656e 7469 6679 2079 gibly identify y │ │ │ │ │ -00016af0: 6f75 2061 7320 7468 6520 7075 626c 6973 ou as the publis │ │ │ │ │ -00016b00: 6865 7220 6f66 2074 6865 7365 2063 6f70 her of these cop │ │ │ │ │ -00016b10: 6965 732e 2020 5468 650a 2020 2020 2066 ies. The. f │ │ │ │ │ -00016b20: 726f 6e74 2063 6f76 6572 206d 7573 7420 ront cover must │ │ │ │ │ -00016b30: 7072 6573 656e 7420 7468 6520 6675 6c6c present the full │ │ │ │ │ -00016b40: 2074 6974 6c65 2077 6974 6820 616c 6c20 title with all │ │ │ │ │ -00016b50: 776f 7264 7320 6f66 2074 6865 2074 6974 words of the tit │ │ │ │ │ -00016b60: 6c65 0a20 2020 2020 6571 7561 6c6c 7920 le. equally │ │ │ │ │ -00016b70: 7072 6f6d 696e 656e 7420 616e 6420 7669 prominent and vi │ │ │ │ │ -00016b80: 7369 626c 652e 2020 596f 7520 6d61 7920 sible. You may │ │ │ │ │ -00016b90: 6164 6420 6f74 6865 7220 6d61 7465 7269 add other materi │ │ │ │ │ -00016ba0: 616c 206f 6e20 7468 650a 2020 2020 2063 al on the. c │ │ │ │ │ -00016bb0: 6f76 6572 7320 696e 2061 6464 6974 696f overs in additio │ │ │ │ │ -00016bc0: 6e2e 2020 436f 7079 696e 6720 7769 7468 n. Copying with │ │ │ │ │ -00016bd0: 2063 6861 6e67 6573 206c 696d 6974 6564 changes limited │ │ │ │ │ -00016be0: 2074 6f20 7468 6520 636f 7665 7273 2c20 to the covers, │ │ │ │ │ -00016bf0: 6173 0a20 2020 2020 6c6f 6e67 2061 7320 as. long as │ │ │ │ │ -00016c00: 7468 6579 2070 7265 7365 7276 6520 7468 they preserve th │ │ │ │ │ -00016c10: 6520 7469 746c 6520 6f66 2074 6865 2044 e title of the D │ │ │ │ │ -00016c20: 6f63 756d 656e 7420 616e 6420 7361 7469 ocument and sati │ │ │ │ │ -00016c30: 7366 7920 7468 6573 650a 2020 2020 2063 sfy these. c │ │ │ │ │ -00016c40: 6f6e 6469 7469 6f6e 732c 2063 616e 2062 onditions, can b │ │ │ │ │ -00016c50: 6520 7472 6561 7465 6420 6173 2076 6572 e treated as ver │ │ │ │ │ -00016c60: 6261 7469 6d20 636f 7079 696e 6720 696e batim copying in │ │ │ │ │ -00016c70: 206f 7468 6572 2072 6573 7065 6374 732e other respects. │ │ │ │ │ -00016c80: 0a0a 2020 2020 2049 6620 7468 6520 7265 .. If the re │ │ │ │ │ -00016c90: 7175 6972 6564 2074 6578 7473 2066 6f72 quired texts for │ │ │ │ │ -00016ca0: 2065 6974 6865 7220 636f 7665 7220 6172 either cover ar │ │ │ │ │ -00016cb0: 6520 746f 6f20 766f 6c75 6d69 6e6f 7573 e too voluminous │ │ │ │ │ -00016cc0: 2074 6f20 6669 740a 2020 2020 206c 6567 to fit. leg │ │ │ │ │ -00016cd0: 6962 6c79 2c20 796f 7520 7368 6f75 6c64 ibly, you should │ │ │ │ │ -00016ce0: 2070 7574 2074 6865 2066 6972 7374 206f put the first o │ │ │ │ │ -00016cf0: 6e65 7320 6c69 7374 6564 2028 6173 206d nes listed (as m │ │ │ │ │ -00016d00: 616e 7920 6173 2066 6974 0a20 2020 2020 any as fit. │ │ │ │ │ -00016d10: 7265 6173 6f6e 6162 6c79 2920 6f6e 2074 reasonably) on t │ │ │ │ │ -00016d20: 6865 2061 6374 7561 6c20 636f 7665 722c he actual cover, │ │ │ │ │ -00016d30: 2061 6e64 2063 6f6e 7469 6e75 6520 7468 and continue th │ │ │ │ │ -00016d40: 6520 7265 7374 206f 6e74 6f0a 2020 2020 e rest onto. │ │ │ │ │ -00016d50: 2061 646a 6163 656e 7420 7061 6765 732e adjacent pages. │ │ │ │ │ -00016d60: 0a0a 2020 2020 2049 6620 796f 7520 7075 .. If you pu │ │ │ │ │ -00016d70: 626c 6973 6820 6f72 2064 6973 7472 6962 blish or distrib │ │ │ │ │ -00016d80: 7574 6520 4f70 6171 7565 2063 6f70 6965 ute Opaque copie │ │ │ │ │ -00016d90: 7320 6f66 2074 6865 2044 6f63 756d 656e s of the Documen │ │ │ │ │ -00016da0: 740a 2020 2020 206e 756d 6265 7269 6e67 t. numbering │ │ │ │ │ -00016db0: 206d 6f72 6520 7468 616e 2031 3030 2c20 more than 100, │ │ │ │ │ -00016dc0: 796f 7520 6d75 7374 2065 6974 6865 7220 you must either │ │ │ │ │ -00016dd0: 696e 636c 7564 6520 6120 6d61 6368 696e include a machin │ │ │ │ │ -00016de0: 652d 7265 6164 6162 6c65 0a20 2020 2020 e-readable. │ │ │ │ │ -00016df0: 5472 616e 7370 6172 656e 7420 636f 7079 Transparent copy │ │ │ │ │ -00016e00: 2061 6c6f 6e67 2077 6974 6820 6561 6368 along with each │ │ │ │ │ -00016e10: 204f 7061 7175 6520 636f 7079 2c20 6f72 Opaque copy, or │ │ │ │ │ -00016e20: 2073 7461 7465 2069 6e20 6f72 2077 6974 state in or wit │ │ │ │ │ -00016e30: 680a 2020 2020 2065 6163 6820 4f70 6171 h. each Opaq │ │ │ │ │ -00016e40: 7565 2063 6f70 7920 6120 636f 6d70 7574 ue copy a comput │ │ │ │ │ -00016e50: 6572 2d6e 6574 776f 726b 206c 6f63 6174 er-network locat │ │ │ │ │ -00016e60: 696f 6e20 6672 6f6d 2077 6869 6368 2074 ion from which t │ │ │ │ │ -00016e70: 6865 2067 656e 6572 616c 0a20 2020 2020 he general. │ │ │ │ │ -00016e80: 6e65 7477 6f72 6b2d 7573 696e 6720 7075 network-using pu │ │ │ │ │ -00016e90: 626c 6963 2068 6173 2061 6363 6573 7320 blic has access │ │ │ │ │ -00016ea0: 746f 2064 6f77 6e6c 6f61 6420 7573 696e to download usin │ │ │ │ │ -00016eb0: 6720 7075 626c 6963 2d73 7461 6e64 6172 g public-standar │ │ │ │ │ -00016ec0: 640a 2020 2020 206e 6574 776f 726b 2070 d. network p │ │ │ │ │ -00016ed0: 726f 746f 636f 6c73 2061 2063 6f6d 706c rotocols a compl │ │ │ │ │ -00016ee0: 6574 6520 5472 616e 7370 6172 656e 7420 ete Transparent │ │ │ │ │ -00016ef0: 636f 7079 206f 6620 7468 6520 446f 6375 copy of the Docu │ │ │ │ │ -00016f00: 6d65 6e74 2c20 6672 6565 0a20 2020 2020 ment, free. │ │ │ │ │ -00016f10: 6f66 2061 6464 6564 206d 6174 6572 6961 of added materia │ │ │ │ │ -00016f20: 6c2e 2020 4966 2079 6f75 2075 7365 2074 l. If you use t │ │ │ │ │ -00016f30: 6865 206c 6174 7465 7220 6f70 7469 6f6e he latter option │ │ │ │ │ -00016f40: 2c20 796f 7520 6d75 7374 2074 616b 650a , you must take. │ │ │ │ │ -00016f50: 2020 2020 2072 6561 736f 6e61 626c 7920 reasonably │ │ │ │ │ -00016f60: 7072 7564 656e 7420 7374 6570 732c 2077 prudent steps, w │ │ │ │ │ -00016f70: 6865 6e20 796f 7520 6265 6769 6e20 6469 hen you begin di │ │ │ │ │ -00016f80: 7374 7269 6275 7469 6f6e 206f 6620 4f70 stribution of Op │ │ │ │ │ -00016f90: 6171 7565 0a20 2020 2020 636f 7069 6573 aque. copies │ │ │ │ │ -00016fa0: 2069 6e20 7175 616e 7469 7479 2c20 746f in quantity, to │ │ │ │ │ -00016fb0: 2065 6e73 7572 6520 7468 6174 2074 6869 ensure that thi │ │ │ │ │ -00016fc0: 7320 5472 616e 7370 6172 656e 7420 636f s Transparent co │ │ │ │ │ -00016fd0: 7079 2077 696c 6c0a 2020 2020 2072 656d py will. rem │ │ │ │ │ -00016fe0: 6169 6e20 7468 7573 2061 6363 6573 7369 ain thus accessi │ │ │ │ │ -00016ff0: 626c 6520 6174 2074 6865 2073 7461 7465 ble at the state │ │ │ │ │ -00017000: 6420 6c6f 6361 7469 6f6e 2075 6e74 696c d location until │ │ │ │ │ -00017010: 2061 7420 6c65 6173 7420 6f6e 650a 2020 at least one. │ │ │ │ │ -00017020: 2020 2079 6561 7220 6166 7465 7220 7468 year after th │ │ │ │ │ -00017030: 6520 6c61 7374 2074 696d 6520 796f 7520 e last time you │ │ │ │ │ -00017040: 6469 7374 7269 6275 7465 2061 6e20 4f70 distribute an Op │ │ │ │ │ -00017050: 6171 7565 2063 6f70 7920 2864 6972 6563 aque copy (direc │ │ │ │ │ -00017060: 746c 7920 6f72 0a20 2020 2020 7468 726f tly or. thro │ │ │ │ │ -00017070: 7567 6820 796f 7572 2061 6765 6e74 7320 ugh your agents │ │ │ │ │ -00017080: 6f72 2072 6574 6169 6c65 7273 2920 6f66 or retailers) of │ │ │ │ │ -00017090: 2074 6861 7420 6564 6974 696f 6e20 746f that edition to │ │ │ │ │ -000170a0: 2074 6865 2070 7562 6c69 632e 0a0a 2020 the public... │ │ │ │ │ -000170b0: 2020 2049 7420 6973 2072 6571 7565 7374 It is request │ │ │ │ │ -000170c0: 6564 2c20 6275 7420 6e6f 7420 7265 7175 ed, but not requ │ │ │ │ │ -000170d0: 6972 6564 2c20 7468 6174 2079 6f75 2063 ired, that you c │ │ │ │ │ -000170e0: 6f6e 7461 6374 2074 6865 2061 7574 686f ontact the autho │ │ │ │ │ -000170f0: 7273 206f 660a 2020 2020 2074 6865 2044 rs of. the D │ │ │ │ │ -00017100: 6f63 756d 656e 7420 7765 6c6c 2062 6566 ocument well bef │ │ │ │ │ -00017110: 6f72 6520 7265 6469 7374 7269 6275 7469 ore redistributi │ │ │ │ │ -00017120: 6e67 2061 6e79 206c 6172 6765 206e 756d ng any large num │ │ │ │ │ -00017130: 6265 7220 6f66 2063 6f70 6965 732c 0a20 ber of copies,. │ │ │ │ │ -00017140: 2020 2020 746f 2067 6976 6520 7468 656d to give them │ │ │ │ │ -00017150: 2061 2063 6861 6e63 6520 746f 2070 726f a chance to pro │ │ │ │ │ -00017160: 7669 6465 2079 6f75 2077 6974 6820 616e vide you with an │ │ │ │ │ -00017170: 2075 7064 6174 6564 2076 6572 7369 6f6e updated version │ │ │ │ │ -00017180: 206f 6620 7468 650a 2020 2020 2044 6f63 of the. Doc │ │ │ │ │ -00017190: 756d 656e 742e 0a0a 2020 342e 204d 4f44 ument... 4. MOD │ │ │ │ │ -000171a0: 4946 4943 4154 494f 4e53 0a0a 2020 2020 IFICATIONS.. │ │ │ │ │ -000171b0: 2059 6f75 206d 6179 2063 6f70 7920 616e You may copy an │ │ │ │ │ -000171c0: 6420 6469 7374 7269 6275 7465 2061 204d d distribute a M │ │ │ │ │ -000171d0: 6f64 6966 6965 6420 5665 7273 696f 6e20 odified Version │ │ │ │ │ -000171e0: 6f66 2074 6865 2044 6f63 756d 656e 740a of the Document. │ │ │ │ │ -000171f0: 2020 2020 2075 6e64 6572 2074 6865 2063 under the c │ │ │ │ │ -00017200: 6f6e 6469 7469 6f6e 7320 6f66 2073 6563 onditions of sec │ │ │ │ │ -00017210: 7469 6f6e 7320 3220 616e 6420 3320 6162 tions 2 and 3 ab │ │ │ │ │ -00017220: 6f76 652c 2070 726f 7669 6465 6420 7468 ove, provided th │ │ │ │ │ -00017230: 6174 2079 6f75 0a20 2020 2020 7265 6c65 at you. rele │ │ │ │ │ -00017240: 6173 6520 7468 6520 4d6f 6469 6669 6564 ase the Modified │ │ │ │ │ -00017250: 2056 6572 7369 6f6e 2075 6e64 6572 2070 Version under p │ │ │ │ │ -00017260: 7265 6369 7365 6c79 2074 6869 7320 4c69 recisely this Li │ │ │ │ │ -00017270: 6365 6e73 652c 2077 6974 6820 7468 650a cense, with the. │ │ │ │ │ -00017280: 2020 2020 204d 6f64 6966 6965 6420 5665 Modified Ve │ │ │ │ │ -00017290: 7273 696f 6e20 6669 6c6c 696e 6720 7468 rsion filling th │ │ │ │ │ -000172a0: 6520 726f 6c65 206f 6620 7468 6520 446f e role of the Do │ │ │ │ │ -000172b0: 6375 6d65 6e74 2c20 7468 7573 206c 6963 cument, thus lic │ │ │ │ │ -000172c0: 656e 7369 6e67 0a20 2020 2020 6469 7374 ensing. dist │ │ │ │ │ -000172d0: 7269 6275 7469 6f6e 2061 6e64 206d 6f64 ribution and mod │ │ │ │ │ -000172e0: 6966 6963 6174 696f 6e20 6f66 2074 6865 ification of the │ │ │ │ │ -000172f0: 204d 6f64 6966 6965 6420 5665 7273 696f Modified Versio │ │ │ │ │ -00017300: 6e20 746f 2077 686f 6576 6572 0a20 2020 n to whoever. │ │ │ │ │ -00017310: 2020 706f 7373 6573 7365 7320 6120 636f possesses a co │ │ │ │ │ -00017320: 7079 206f 6620 6974 2e20 2049 6e20 6164 py of it. In ad │ │ │ │ │ -00017330: 6469 7469 6f6e 2c20 796f 7520 6d75 7374 dition, you must │ │ │ │ │ -00017340: 2064 6f20 7468 6573 6520 7468 696e 6773 do these things │ │ │ │ │ -00017350: 2069 6e0a 2020 2020 2074 6865 204d 6f64 in. the Mod │ │ │ │ │ -00017360: 6966 6965 6420 5665 7273 696f 6e3a 0a0a ified Version:.. │ │ │ │ │ -00017370: 2020 2020 2020 2041 2e20 5573 6520 696e A. Use in │ │ │ │ │ -00017380: 2074 6865 2054 6974 6c65 2050 6167 6520 the Title Page │ │ │ │ │ -00017390: 2861 6e64 206f 6e20 7468 6520 636f 7665 (and on the cove │ │ │ │ │ -000173a0: 7273 2c20 6966 2061 6e79 2920 6120 7469 rs, if any) a ti │ │ │ │ │ -000173b0: 746c 650a 2020 2020 2020 2020 2020 6469 tle. di │ │ │ │ │ -000173c0: 7374 696e 6374 2066 726f 6d20 7468 6174 stinct from that │ │ │ │ │ -000173d0: 206f 6620 7468 6520 446f 6375 6d65 6e74 of the Document │ │ │ │ │ -000173e0: 2c20 616e 6420 6672 6f6d 2074 686f 7365 , and from those │ │ │ │ │ -000173f0: 206f 6620 7072 6576 696f 7573 0a20 2020 of previous. │ │ │ │ │ -00017400: 2020 2020 2020 2076 6572 7369 6f6e 7320 versions │ │ │ │ │ -00017410: 2877 6869 6368 2073 686f 756c 642c 2069 (which should, i │ │ │ │ │ -00017420: 6620 7468 6572 6520 7765 7265 2061 6e79 f there were any │ │ │ │ │ -00017430: 2c20 6265 206c 6973 7465 6420 696e 2074 , be listed in t │ │ │ │ │ -00017440: 6865 0a20 2020 2020 2020 2020 2048 6973 he. His │ │ │ │ │ -00017450: 746f 7279 2073 6563 7469 6f6e 206f 6620 tory section of │ │ │ │ │ -00017460: 7468 6520 446f 6375 6d65 6e74 292e 2020 the Document). │ │ │ │ │ -00017470: 596f 7520 6d61 7920 7573 6520 7468 6520 You may use the │ │ │ │ │ -00017480: 7361 6d65 2074 6974 6c65 0a20 2020 2020 same title. │ │ │ │ │ -00017490: 2020 2020 2061 7320 6120 7072 6576 696f as a previo │ │ │ │ │ -000174a0: 7573 2076 6572 7369 6f6e 2069 6620 7468 us version if th │ │ │ │ │ -000174b0: 6520 6f72 6967 696e 616c 2070 7562 6c69 e original publi │ │ │ │ │ -000174c0: 7368 6572 206f 6620 7468 6174 0a20 2020 sher of that. │ │ │ │ │ -000174d0: 2020 2020 2020 2076 6572 7369 6f6e 2067 version g │ │ │ │ │ -000174e0: 6976 6573 2070 6572 6d69 7373 696f 6e2e ives permission. │ │ │ │ │ -000174f0: 0a0a 2020 2020 2020 2042 2e20 4c69 7374 .. B. List │ │ │ │ │ -00017500: 206f 6e20 7468 6520 5469 746c 6520 5061 on the Title Pa │ │ │ │ │ -00017510: 6765 2c20 6173 2061 7574 686f 7273 2c20 ge, as authors, │ │ │ │ │ -00017520: 6f6e 6520 6f72 206d 6f72 6520 7065 7273 one or more pers │ │ │ │ │ -00017530: 6f6e 7320 6f72 0a20 2020 2020 2020 2020 ons or. │ │ │ │ │ -00017540: 2065 6e74 6974 6965 7320 7265 7370 6f6e entities respon │ │ │ │ │ -00017550: 7369 626c 6520 666f 7220 6175 7468 6f72 sible for author │ │ │ │ │ -00017560: 7368 6970 206f 6620 7468 6520 6d6f 6469 ship of the modi │ │ │ │ │ -00017570: 6669 6361 7469 6f6e 7320 696e 0a20 2020 fications in. │ │ │ │ │ -00017580: 2020 2020 2020 2074 6865 204d 6f64 6966 the Modif │ │ │ │ │ -00017590: 6965 6420 5665 7273 696f 6e2c 2074 6f67 ied Version, tog │ │ │ │ │ -000175a0: 6574 6865 7220 7769 7468 2061 7420 6c65 ether with at le │ │ │ │ │ -000175b0: 6173 7420 6669 7665 206f 6620 7468 650a ast five of the. │ │ │ │ │ -000175c0: 2020 2020 2020 2020 2020 7072 696e 6369 princi │ │ │ │ │ -000175d0: 7061 6c20 6175 7468 6f72 7320 6f66 2074 pal authors of t │ │ │ │ │ -000175e0: 6865 2044 6f63 756d 656e 7420 2861 6c6c he Document (all │ │ │ │ │ -000175f0: 206f 6620 6974 7320 7072 696e 6369 7061 of its principa │ │ │ │ │ -00017600: 6c0a 2020 2020 2020 2020 2020 6175 7468 l. auth │ │ │ │ │ -00017610: 6f72 732c 2069 6620 6974 2068 6173 2066 ors, if it has f │ │ │ │ │ -00017620: 6577 6572 2074 6861 6e20 6669 7665 292c ewer than five), │ │ │ │ │ -00017630: 2075 6e6c 6573 7320 7468 6579 2072 656c unless they rel │ │ │ │ │ -00017640: 6561 7365 2079 6f75 0a20 2020 2020 2020 ease you. │ │ │ │ │ -00017650: 2020 2066 726f 6d20 7468 6973 2072 6571 from this req │ │ │ │ │ -00017660: 7569 7265 6d65 6e74 2e0a 0a20 2020 2020 uirement... │ │ │ │ │ -00017670: 2020 432e 2053 7461 7465 206f 6e20 7468 C. State on th │ │ │ │ │ -00017680: 6520 5469 746c 6520 7061 6765 2074 6865 e Title page the │ │ │ │ │ -00017690: 206e 616d 6520 6f66 2074 6865 2070 7562 name of the pub │ │ │ │ │ -000176a0: 6c69 7368 6572 206f 6620 7468 650a 2020 lisher of the. │ │ │ │ │ -000176b0: 2020 2020 2020 2020 4d6f 6469 6669 6564 Modified │ │ │ │ │ -000176c0: 2056 6572 7369 6f6e 2c20 6173 2074 6865 Version, as the │ │ │ │ │ -000176d0: 2070 7562 6c69 7368 6572 2e0a 0a20 2020 publisher... │ │ │ │ │ -000176e0: 2020 2020 442e 2050 7265 7365 7276 6520 D. Preserve │ │ │ │ │ -000176f0: 616c 6c20 7468 6520 636f 7079 7269 6768 all the copyrigh │ │ │ │ │ -00017700: 7420 6e6f 7469 6365 7320 6f66 2074 6865 t notices of the │ │ │ │ │ -00017710: 2044 6f63 756d 656e 742e 0a0a 2020 2020 Document... │ │ │ │ │ -00017720: 2020 2045 2e20 4164 6420 616e 2061 7070 E. Add an app │ │ │ │ │ -00017730: 726f 7072 6961 7465 2063 6f70 7972 6967 ropriate copyrig │ │ │ │ │ -00017740: 6874 206e 6f74 6963 6520 666f 7220 796f ht notice for yo │ │ │ │ │ -00017750: 7572 206d 6f64 6966 6963 6174 696f 6e73 ur modifications │ │ │ │ │ -00017760: 0a20 2020 2020 2020 2020 2061 646a 6163 . adjac │ │ │ │ │ -00017770: 656e 7420 746f 2074 6865 206f 7468 6572 ent to the other │ │ │ │ │ -00017780: 2063 6f70 7972 6967 6874 206e 6f74 6963 copyright notic │ │ │ │ │ -00017790: 6573 2e0a 0a20 2020 2020 2020 462e 2049 es... F. I │ │ │ │ │ -000177a0: 6e63 6c75 6465 2c20 696d 6d65 6469 6174 nclude, immediat │ │ │ │ │ -000177b0: 656c 7920 6166 7465 7220 7468 6520 636f ely after the co │ │ │ │ │ -000177c0: 7079 7269 6768 7420 6e6f 7469 6365 732c pyright notices, │ │ │ │ │ -000177d0: 2061 206c 6963 656e 7365 0a20 2020 2020 a license. │ │ │ │ │ -000177e0: 2020 2020 206e 6f74 6963 6520 6769 7669 notice givi │ │ │ │ │ -000177f0: 6e67 2074 6865 2070 7562 6c69 6320 7065 ng the public pe │ │ │ │ │ -00017800: 726d 6973 7369 6f6e 2074 6f20 7573 6520 rmission to use │ │ │ │ │ -00017810: 7468 6520 4d6f 6469 6669 6564 0a20 2020 the Modified. │ │ │ │ │ -00017820: 2020 2020 2020 2056 6572 7369 6f6e 2075 Version u │ │ │ │ │ -00017830: 6e64 6572 2074 6865 2074 6572 6d73 206f nder the terms o │ │ │ │ │ -00017840: 6620 7468 6973 204c 6963 656e 7365 2c20 f this License, │ │ │ │ │ -00017850: 696e 2074 6865 2066 6f72 6d20 7368 6f77 in the form show │ │ │ │ │ -00017860: 6e20 696e 0a20 2020 2020 2020 2020 2074 n in. t │ │ │ │ │ -00017870: 6865 2041 6464 656e 6475 6d20 6265 6c6f he Addendum belo │ │ │ │ │ -00017880: 772e 0a0a 2020 2020 2020 2047 2e20 5072 w... G. Pr │ │ │ │ │ -00017890: 6573 6572 7665 2069 6e20 7468 6174 206c eserve in that l │ │ │ │ │ -000178a0: 6963 656e 7365 206e 6f74 6963 6520 7468 icense notice th │ │ │ │ │ -000178b0: 6520 6675 6c6c 206c 6973 7473 206f 6620 e full lists of │ │ │ │ │ -000178c0: 496e 7661 7269 616e 740a 2020 2020 2020 Invariant. │ │ │ │ │ -000178d0: 2020 2020 5365 6374 696f 6e73 2061 6e64 Sections and │ │ │ │ │ -000178e0: 2072 6571 7569 7265 6420 436f 7665 7220 required Cover │ │ │ │ │ -000178f0: 5465 7874 7320 6769 7665 6e20 696e 2074 Texts given in t │ │ │ │ │ -00017900: 6865 2044 6f63 756d 656e 7427 730a 2020 he Document's. │ │ │ │ │ -00017910: 2020 2020 2020 2020 6c69 6365 6e73 6520 license │ │ │ │ │ -00017920: 6e6f 7469 6365 2e0a 0a20 2020 2020 2020 notice... │ │ │ │ │ -00017930: 482e 2049 6e63 6c75 6465 2061 6e20 756e H. Include an un │ │ │ │ │ -00017940: 616c 7465 7265 6420 636f 7079 206f 6620 altered copy of │ │ │ │ │ -00017950: 7468 6973 204c 6963 656e 7365 2e0a 0a20 this License... │ │ │ │ │ -00017960: 2020 2020 2020 492e 2050 7265 7365 7276 I. Preserv │ │ │ │ │ -00017970: 6520 7468 6520 7365 6374 696f 6e20 456e e the section En │ │ │ │ │ -00017980: 7469 746c 6564 2022 4869 7374 6f72 7922 titled "History" │ │ │ │ │ -00017990: 2c20 5072 6573 6572 7665 2069 7473 2054 , Preserve its T │ │ │ │ │ -000179a0: 6974 6c65 2c0a 2020 2020 2020 2020 2020 itle,. │ │ │ │ │ -000179b0: 616e 6420 6164 6420 746f 2069 7420 616e and add to it an │ │ │ │ │ -000179c0: 2069 7465 6d20 7374 6174 696e 6720 6174 item stating at │ │ │ │ │ -000179d0: 206c 6561 7374 2074 6865 2074 6974 6c65 least the title │ │ │ │ │ -000179e0: 2c20 7965 6172 2c20 6e65 770a 2020 2020 , year, new. │ │ │ │ │ -000179f0: 2020 2020 2020 6175 7468 6f72 732c 2061 authors, a │ │ │ │ │ -00017a00: 6e64 2070 7562 6c69 7368 6572 206f 6620 nd publisher of │ │ │ │ │ -00017a10: 7468 6520 4d6f 6469 6669 6564 2056 6572 the Modified Ver │ │ │ │ │ -00017a20: 7369 6f6e 2061 7320 6769 7665 6e20 6f6e sion as given on │ │ │ │ │ -00017a30: 2074 6865 0a20 2020 2020 2020 2020 2054 the. T │ │ │ │ │ -00017a40: 6974 6c65 2050 6167 652e 2020 4966 2074 itle Page. If t │ │ │ │ │ -00017a50: 6865 7265 2069 7320 6e6f 2073 6563 7469 here is no secti │ │ │ │ │ -00017a60: 6f6e 2045 6e74 6974 6c65 6420 2248 6973 on Entitled "His │ │ │ │ │ -00017a70: 746f 7279 2220 696e 2074 6865 0a20 2020 tory" in the. │ │ │ │ │ -00017a80: 2020 2020 2020 2044 6f63 756d 656e 742c Document, │ │ │ │ │ -00017a90: 2063 7265 6174 6520 6f6e 6520 7374 6174 create one stat │ │ │ │ │ -00017aa0: 696e 6720 7468 6520 7469 746c 652c 2079 ing the title, y │ │ │ │ │ -00017ab0: 6561 722c 2061 7574 686f 7273 2c20 616e ear, authors, an │ │ │ │ │ -00017ac0: 640a 2020 2020 2020 2020 2020 7075 626c d. publ │ │ │ │ │ -00017ad0: 6973 6865 7220 6f66 2074 6865 2044 6f63 isher of the Doc │ │ │ │ │ -00017ae0: 756d 656e 7420 6173 2067 6976 656e 206f ument as given o │ │ │ │ │ -00017af0: 6e20 6974 7320 5469 746c 6520 5061 6765 n its Title Page │ │ │ │ │ -00017b00: 2c20 7468 656e 2061 6464 0a20 2020 2020 , then add. │ │ │ │ │ -00017b10: 2020 2020 2061 6e20 6974 656d 2064 6573 an item des │ │ │ │ │ -00017b20: 6372 6962 696e 6720 7468 6520 4d6f 6469 cribing the Modi │ │ │ │ │ -00017b30: 6669 6564 2056 6572 7369 6f6e 2061 7320 fied Version as │ │ │ │ │ -00017b40: 7374 6174 6564 2069 6e20 7468 650a 2020 stated in the. │ │ │ │ │ -00017b50: 2020 2020 2020 2020 7072 6576 696f 7573 previous │ │ │ │ │ -00017b60: 2073 656e 7465 6e63 652e 0a0a 2020 2020 sentence... │ │ │ │ │ -00017b70: 2020 204a 2e20 5072 6573 6572 7665 2074 J. Preserve t │ │ │ │ │ -00017b80: 6865 206e 6574 776f 726b 206c 6f63 6174 he network locat │ │ │ │ │ -00017b90: 696f 6e2c 2069 6620 616e 792c 2067 6976 ion, if any, giv │ │ │ │ │ -00017ba0: 656e 2069 6e20 7468 6520 446f 6375 6d65 en in the Docume │ │ │ │ │ -00017bb0: 6e74 0a20 2020 2020 2020 2020 2066 6f72 nt. for │ │ │ │ │ -00017bc0: 2070 7562 6c69 6320 6163 6365 7373 2074 public access t │ │ │ │ │ -00017bd0: 6f20 6120 5472 616e 7370 6172 656e 7420 o a Transparent │ │ │ │ │ -00017be0: 636f 7079 206f 6620 7468 6520 446f 6375 copy of the Docu │ │ │ │ │ -00017bf0: 6d65 6e74 2c20 616e 640a 2020 2020 2020 ment, and. │ │ │ │ │ -00017c00: 2020 2020 6c69 6b65 7769 7365 2074 6865 likewise the │ │ │ │ │ -00017c10: 206e 6574 776f 726b 206c 6f63 6174 696f network locatio │ │ │ │ │ -00017c20: 6e73 2067 6976 656e 2069 6e20 7468 6520 ns given in the │ │ │ │ │ -00017c30: 446f 6375 6d65 6e74 2066 6f72 0a20 2020 Document for. │ │ │ │ │ -00017c40: 2020 2020 2020 2070 7265 7669 6f75 7320 previous │ │ │ │ │ -00017c50: 7665 7273 696f 6e73 2069 7420 7761 7320 versions it was │ │ │ │ │ -00017c60: 6261 7365 6420 6f6e 2e20 2054 6865 7365 based on. These │ │ │ │ │ -00017c70: 206d 6179 2062 6520 706c 6163 6564 2069 may be placed i │ │ │ │ │ -00017c80: 6e20 7468 650a 2020 2020 2020 2020 2020 n the. │ │ │ │ │ -00017c90: 2248 6973 746f 7279 2220 7365 6374 696f "History" sectio │ │ │ │ │ -00017ca0: 6e2e 2020 596f 7520 6d61 7920 6f6d 6974 n. You may omit │ │ │ │ │ -00017cb0: 2061 206e 6574 776f 726b 206c 6f63 6174 a network locat │ │ │ │ │ -00017cc0: 696f 6e20 666f 7220 6120 776f 726b 0a20 ion for a work. │ │ │ │ │ -00017cd0: 2020 2020 2020 2020 2074 6861 7420 7761 that wa │ │ │ │ │ -00017ce0: 7320 7075 626c 6973 6865 6420 6174 206c s published at l │ │ │ │ │ -00017cf0: 6561 7374 2066 6f75 7220 7965 6172 7320 east four years │ │ │ │ │ -00017d00: 6265 666f 7265 2074 6865 2044 6f63 756d before the Docum │ │ │ │ │ -00017d10: 656e 740a 2020 2020 2020 2020 2020 6974 ent. it │ │ │ │ │ -00017d20: 7365 6c66 2c20 6f72 2069 6620 7468 6520 self, or if the │ │ │ │ │ -00017d30: 6f72 6967 696e 616c 2070 7562 6c69 7368 original publish │ │ │ │ │ -00017d40: 6572 206f 6620 7468 6520 7665 7273 696f er of the versio │ │ │ │ │ -00017d50: 6e20 6974 2072 6566 6572 730a 2020 2020 n it refers. │ │ │ │ │ -00017d60: 2020 2020 2020 746f 2067 6976 6573 2070 to gives p │ │ │ │ │ -00017d70: 6572 6d69 7373 696f 6e2e 0a0a 2020 2020 ermission... │ │ │ │ │ -00017d80: 2020 204b 2e20 466f 7220 616e 7920 7365 K. For any se │ │ │ │ │ -00017d90: 6374 696f 6e20 456e 7469 746c 6564 2022 ction Entitled " │ │ │ │ │ -00017da0: 4163 6b6e 6f77 6c65 6467 656d 656e 7473 Acknowledgements │ │ │ │ │ -00017db0: 2220 6f72 2022 4465 6469 6361 7469 6f6e " or "Dedication │ │ │ │ │ -00017dc0: 7322 2c0a 2020 2020 2020 2020 2020 5072 s",. Pr │ │ │ │ │ -00017dd0: 6573 6572 7665 2074 6865 2054 6974 6c65 eserve the Title │ │ │ │ │ -00017de0: 206f 6620 7468 6520 7365 6374 696f 6e2c of the section, │ │ │ │ │ -00017df0: 2061 6e64 2070 7265 7365 7276 6520 696e and preserve in │ │ │ │ │ -00017e00: 2074 6865 2073 6563 7469 6f6e 0a20 2020 the section. │ │ │ │ │ -00017e10: 2020 2020 2020 2061 6c6c 2074 6865 2073 all the s │ │ │ │ │ -00017e20: 7562 7374 616e 6365 2061 6e64 2074 6f6e ubstance and ton │ │ │ │ │ -00017e30: 6520 6f66 2065 6163 6820 6f66 2074 6865 e of each of the │ │ │ │ │ -00017e40: 2063 6f6e 7472 6962 7574 6f72 0a20 2020 contributor. │ │ │ │ │ -00017e50: 2020 2020 2020 2061 636b 6e6f 776c 6564 acknowled │ │ │ │ │ -00017e60: 6765 6d65 6e74 7320 616e 642f 6f72 2064 gements and/or d │ │ │ │ │ -00017e70: 6564 6963 6174 696f 6e73 2067 6976 656e edications given │ │ │ │ │ -00017e80: 2074 6865 7265 696e 2e0a 0a20 2020 2020 therein... │ │ │ │ │ -00017e90: 2020 4c2e 2050 7265 7365 7276 6520 616c L. Preserve al │ │ │ │ │ -00017ea0: 6c20 7468 6520 496e 7661 7269 616e 7420 l the Invariant │ │ │ │ │ -00017eb0: 5365 6374 696f 6e73 206f 6620 7468 6520 Sections of the │ │ │ │ │ -00017ec0: 446f 6375 6d65 6e74 2c20 756e 616c 7465 Document, unalte │ │ │ │ │ -00017ed0: 7265 640a 2020 2020 2020 2020 2020 696e red. in │ │ │ │ │ -00017ee0: 2074 6865 6972 2074 6578 7420 616e 6420 their text and │ │ │ │ │ -00017ef0: 696e 2074 6865 6972 2074 6974 6c65 732e in their titles. │ │ │ │ │ -00017f00: 2020 5365 6374 696f 6e20 6e75 6d62 6572 Section number │ │ │ │ │ -00017f10: 7320 6f72 2074 6865 0a20 2020 2020 2020 s or the. │ │ │ │ │ -00017f20: 2020 2065 7175 6976 616c 656e 7420 6172 equivalent ar │ │ │ │ │ -00017f30: 6520 6e6f 7420 636f 6e73 6964 6572 6564 e not considered │ │ │ │ │ -00017f40: 2070 6172 7420 6f66 2074 6865 2073 6563 part of the sec │ │ │ │ │ -00017f50: 7469 6f6e 2074 6974 6c65 732e 0a0a 2020 tion titles... │ │ │ │ │ -00017f60: 2020 2020 204d 2e20 4465 6c65 7465 2061 M. Delete a │ │ │ │ │ -00017f70: 6e79 2073 6563 7469 6f6e 2045 6e74 6974 ny section Entit │ │ │ │ │ -00017f80: 6c65 6420 2245 6e64 6f72 7365 6d65 6e74 led "Endorsement │ │ │ │ │ -00017f90: 7322 2e20 2053 7563 6820 6120 7365 6374 s". Such a sect │ │ │ │ │ -00017fa0: 696f 6e0a 2020 2020 2020 2020 2020 6d61 ion. ma │ │ │ │ │ -00017fb0: 7920 6e6f 7420 6265 2069 6e63 6c75 6465 y not be include │ │ │ │ │ -00017fc0: 6420 696e 2074 6865 204d 6f64 6966 6965 d in the Modifie │ │ │ │ │ -00017fd0: 6420 5665 7273 696f 6e2e 0a0a 2020 2020 d Version... │ │ │ │ │ -00017fe0: 2020 204e 2e20 446f 206e 6f74 2072 6574 N. Do not ret │ │ │ │ │ -00017ff0: 6974 6c65 2061 6e79 2065 7869 7374 696e itle any existin │ │ │ │ │ -00018000: 6720 7365 6374 696f 6e20 746f 2062 6520 g section to be │ │ │ │ │ -00018010: 456e 7469 746c 6564 0a20 2020 2020 2020 Entitled. │ │ │ │ │ -00018020: 2020 2022 456e 646f 7273 656d 656e 7473 "Endorsements │ │ │ │ │ -00018030: 2220 6f72 2074 6f20 636f 6e66 6c69 6374 " or to conflict │ │ │ │ │ -00018040: 2069 6e20 7469 746c 6520 7769 7468 2061 in title with a │ │ │ │ │ -00018050: 6e79 2049 6e76 6172 6961 6e74 0a20 2020 ny Invariant. │ │ │ │ │ -00018060: 2020 2020 2020 2053 6563 7469 6f6e 2e0a Section.. │ │ │ │ │ -00018070: 0a20 2020 2020 2020 4f2e 2050 7265 7365 . O. Prese │ │ │ │ │ -00018080: 7276 6520 616e 7920 5761 7272 616e 7479 rve any Warranty │ │ │ │ │ -00018090: 2044 6973 636c 6169 6d65 7273 2e0a 0a20 Disclaimers... │ │ │ │ │ -000180a0: 2020 2020 4966 2074 6865 204d 6f64 6966 If the Modif │ │ │ │ │ -000180b0: 6965 6420 5665 7273 696f 6e20 696e 636c ied Version incl │ │ │ │ │ -000180c0: 7564 6573 206e 6577 2066 726f 6e74 2d6d udes new front-m │ │ │ │ │ -000180d0: 6174 7465 7220 7365 6374 696f 6e73 206f atter sections o │ │ │ │ │ -000180e0: 720a 2020 2020 2061 7070 656e 6469 6365 r. appendice │ │ │ │ │ -000180f0: 7320 7468 6174 2071 7561 6c69 6679 2061 s that qualify a │ │ │ │ │ -00018100: 7320 5365 636f 6e64 6172 7920 5365 6374 s Secondary Sect │ │ │ │ │ -00018110: 696f 6e73 2061 6e64 2063 6f6e 7461 696e ions and contain │ │ │ │ │ -00018120: 206e 6f0a 2020 2020 206d 6174 6572 6961 no. materia │ │ │ │ │ -00018130: 6c20 636f 7069 6564 2066 726f 6d20 7468 l copied from th │ │ │ │ │ -00018140: 6520 446f 6375 6d65 6e74 2c20 796f 7520 e Document, you │ │ │ │ │ -00018150: 6d61 7920 6174 2079 6f75 7220 6f70 7469 may at your opti │ │ │ │ │ -00018160: 6f6e 2064 6573 6967 6e61 7465 0a20 2020 on designate. │ │ │ │ │ -00018170: 2020 736f 6d65 206f 7220 616c 6c20 6f66 some or all of │ │ │ │ │ -00018180: 2074 6865 7365 2073 6563 7469 6f6e 7320 these sections │ │ │ │ │ -00018190: 6173 2069 6e76 6172 6961 6e74 2e20 2054 as invariant. T │ │ │ │ │ -000181a0: 6f20 646f 2074 6869 732c 2061 6464 2074 o do this, add t │ │ │ │ │ -000181b0: 6865 6972 0a20 2020 2020 7469 746c 6573 heir. titles │ │ │ │ │ -000181c0: 2074 6f20 7468 6520 6c69 7374 206f 6620 to the list of │ │ │ │ │ -000181d0: 496e 7661 7269 616e 7420 5365 6374 696f Invariant Sectio │ │ │ │ │ -000181e0: 6e73 2069 6e20 7468 6520 4d6f 6469 6669 ns in the Modifi │ │ │ │ │ -000181f0: 6564 2056 6572 7369 6f6e 2773 0a20 2020 ed Version's. │ │ │ │ │ -00018200: 2020 6c69 6365 6e73 6520 6e6f 7469 6365 license notice │ │ │ │ │ -00018210: 2e20 2054 6865 7365 2074 6974 6c65 7320 . These titles │ │ │ │ │ -00018220: 6d75 7374 2062 6520 6469 7374 696e 6374 must be distinct │ │ │ │ │ -00018230: 2066 726f 6d20 616e 7920 6f74 6865 720a from any other. │ │ │ │ │ -00018240: 2020 2020 2073 6563 7469 6f6e 2074 6974 section tit │ │ │ │ │ -00018250: 6c65 732e 0a0a 2020 2020 2059 6f75 206d les... You m │ │ │ │ │ -00018260: 6179 2061 6464 2061 2073 6563 7469 6f6e ay add a section │ │ │ │ │ -00018270: 2045 6e74 6974 6c65 6420 2245 6e64 6f72 Entitled "Endor │ │ │ │ │ -00018280: 7365 6d65 6e74 7322 2c20 7072 6f76 6964 sements", provid │ │ │ │ │ -00018290: 6564 2069 7420 636f 6e74 6169 6e73 0a20 ed it contains. │ │ │ │ │ -000182a0: 2020 2020 6e6f 7468 696e 6720 6275 7420 nothing but │ │ │ │ │ -000182b0: 656e 646f 7273 656d 656e 7473 206f 6620 endorsements of │ │ │ │ │ -000182c0: 796f 7572 204d 6f64 6966 6965 6420 5665 your Modified Ve │ │ │ │ │ -000182d0: 7273 696f 6e20 6279 2076 6172 696f 7573 rsion by various │ │ │ │ │ -000182e0: 0a20 2020 2020 7061 7274 6965 732d 2d66 . parties--f │ │ │ │ │ -000182f0: 6f72 2065 7861 6d70 6c65 2c20 7374 6174 or example, stat │ │ │ │ │ -00018300: 656d 656e 7473 206f 6620 7065 6572 2072 ements of peer r │ │ │ │ │ -00018310: 6576 6965 7720 6f72 2074 6861 7420 7468 eview or that th │ │ │ │ │ -00018320: 6520 7465 7874 0a20 2020 2020 6861 7320 e text. has │ │ │ │ │ -00018330: 6265 656e 2061 7070 726f 7665 6420 6279 been approved by │ │ │ │ │ -00018340: 2061 6e20 6f72 6761 6e69 7a61 7469 6f6e an organization │ │ │ │ │ -00018350: 2061 7320 7468 6520 6175 7468 6f72 6974 as the authorit │ │ │ │ │ -00018360: 6174 6976 650a 2020 2020 2064 6566 696e ative. defin │ │ │ │ │ -00018370: 6974 696f 6e20 6f66 2061 2073 7461 6e64 ition of a stand │ │ │ │ │ -00018380: 6172 642e 0a0a 2020 2020 2059 6f75 206d ard... You m │ │ │ │ │ -00018390: 6179 2061 6464 2061 2070 6173 7361 6765 ay add a passage │ │ │ │ │ -000183a0: 206f 6620 7570 2074 6f20 6669 7665 2077 of up to five w │ │ │ │ │ -000183b0: 6f72 6473 2061 7320 6120 4672 6f6e 742d ords as a Front- │ │ │ │ │ -000183c0: 436f 7665 7220 5465 7874 2c0a 2020 2020 Cover Text,. │ │ │ │ │ -000183d0: 2061 6e64 2061 2070 6173 7361 6765 206f and a passage o │ │ │ │ │ -000183e0: 6620 7570 2074 6f20 3235 2077 6f72 6473 f up to 25 words │ │ │ │ │ -000183f0: 2061 7320 6120 4261 636b 2d43 6f76 6572 as a Back-Cover │ │ │ │ │ -00018400: 2054 6578 742c 2074 6f20 7468 6520 656e Text, to the en │ │ │ │ │ -00018410: 6420 6f66 0a20 2020 2020 7468 6520 6c69 d of. the li │ │ │ │ │ -00018420: 7374 206f 6620 436f 7665 7220 5465 7874 st of Cover Text │ │ │ │ │ -00018430: 7320 696e 2074 6865 204d 6f64 6966 6965 s in the Modifie │ │ │ │ │ -00018440: 6420 5665 7273 696f 6e2e 2020 4f6e 6c79 d Version. Only │ │ │ │ │ -00018450: 206f 6e65 2070 6173 7361 6765 0a20 2020 one passage. │ │ │ │ │ -00018460: 2020 6f66 2046 726f 6e74 2d43 6f76 6572 of Front-Cover │ │ │ │ │ -00018470: 2054 6578 7420 616e 6420 6f6e 6520 6f66 Text and one of │ │ │ │ │ -00018480: 2042 6163 6b2d 436f 7665 7220 5465 7874 Back-Cover Text │ │ │ │ │ -00018490: 206d 6179 2062 6520 6164 6465 6420 6279 may be added by │ │ │ │ │ -000184a0: 2028 6f72 0a20 2020 2020 7468 726f 7567 (or. throug │ │ │ │ │ -000184b0: 6820 6172 7261 6e67 656d 656e 7473 206d h arrangements m │ │ │ │ │ -000184c0: 6164 6520 6279 2920 616e 7920 6f6e 6520 ade by) any one │ │ │ │ │ -000184d0: 656e 7469 7479 2e20 2049 6620 7468 6520 entity. If the │ │ │ │ │ -000184e0: 446f 6375 6d65 6e74 0a20 2020 2020 616c Document. al │ │ │ │ │ -000184f0: 7265 6164 7920 696e 636c 7564 6573 2061 ready includes a │ │ │ │ │ -00018500: 2063 6f76 6572 2074 6578 7420 666f 7220 cover text for │ │ │ │ │ -00018510: 7468 6520 7361 6d65 2063 6f76 6572 2c20 the same cover, │ │ │ │ │ -00018520: 7072 6576 696f 7573 6c79 2061 6464 6564 previously added │ │ │ │ │ -00018530: 0a20 2020 2020 6279 2079 6f75 206f 7220 . by you or │ │ │ │ │ -00018540: 6279 2061 7272 616e 6765 6d65 6e74 206d by arrangement m │ │ │ │ │ -00018550: 6164 6520 6279 2074 6865 2073 616d 6520 ade by the same │ │ │ │ │ -00018560: 656e 7469 7479 2079 6f75 2061 7265 2061 entity you are a │ │ │ │ │ -00018570: 6374 696e 6720 6f6e 0a20 2020 2020 6265 cting on. be │ │ │ │ │ -00018580: 6861 6c66 206f 662c 2079 6f75 206d 6179 half of, you may │ │ │ │ │ -00018590: 206e 6f74 2061 6464 2061 6e6f 7468 6572 not add another │ │ │ │ │ -000185a0: 3b20 6275 7420 796f 7520 6d61 7920 7265 ; but you may re │ │ │ │ │ -000185b0: 706c 6163 6520 7468 6520 6f6c 640a 2020 place the old. │ │ │ │ │ -000185c0: 2020 206f 6e65 2c20 6f6e 2065 7870 6c69 one, on expli │ │ │ │ │ -000185d0: 6369 7420 7065 726d 6973 7369 6f6e 2066 cit permission f │ │ │ │ │ -000185e0: 726f 6d20 7468 6520 7072 6576 696f 7573 rom the previous │ │ │ │ │ -000185f0: 2070 7562 6c69 7368 6572 2074 6861 7420 publisher that │ │ │ │ │ -00018600: 6164 6465 640a 2020 2020 2074 6865 206f added. the o │ │ │ │ │ -00018610: 6c64 206f 6e65 2e0a 0a20 2020 2020 5468 ld one... Th │ │ │ │ │ -00018620: 6520 6175 7468 6f72 2873 2920 616e 6420 e author(s) and │ │ │ │ │ -00018630: 7075 626c 6973 6865 7228 7329 206f 6620 publisher(s) of │ │ │ │ │ -00018640: 7468 6520 446f 6375 6d65 6e74 2064 6f20 the Document do │ │ │ │ │ -00018650: 6e6f 7420 6279 2074 6869 730a 2020 2020 not by this. │ │ │ │ │ -00018660: 204c 6963 656e 7365 2067 6976 6520 7065 License give pe │ │ │ │ │ -00018670: 726d 6973 7369 6f6e 2074 6f20 7573 6520 rmission to use │ │ │ │ │ -00018680: 7468 6569 7220 6e61 6d65 7320 666f 7220 their names for │ │ │ │ │ -00018690: 7075 626c 6963 6974 7920 666f 7220 6f72 publicity for or │ │ │ │ │ -000186a0: 2074 6f0a 2020 2020 2061 7373 6572 7420 to. assert │ │ │ │ │ -000186b0: 6f72 2069 6d70 6c79 2065 6e64 6f72 7365 or imply endorse │ │ │ │ │ -000186c0: 6d65 6e74 206f 6620 616e 7920 4d6f 6469 ment of any Modi │ │ │ │ │ -000186d0: 6669 6564 2056 6572 7369 6f6e 2e0a 0a20 fied Version... │ │ │ │ │ -000186e0: 2035 2e20 434f 4d42 494e 494e 4720 444f 5. COMBINING DO │ │ │ │ │ -000186f0: 4355 4d45 4e54 530a 0a20 2020 2020 596f CUMENTS.. Yo │ │ │ │ │ -00018700: 7520 6d61 7920 636f 6d62 696e 6520 7468 u may combine th │ │ │ │ │ -00018710: 6520 446f 6375 6d65 6e74 2077 6974 6820 e Document with │ │ │ │ │ -00018720: 6f74 6865 7220 646f 6375 6d65 6e74 7320 other documents │ │ │ │ │ -00018730: 7265 6c65 6173 6564 2075 6e64 6572 0a20 released under. │ │ │ │ │ -00018740: 2020 2020 7468 6973 204c 6963 656e 7365 this License │ │ │ │ │ -00018750: 2c20 756e 6465 7220 7468 6520 7465 726d , under the term │ │ │ │ │ -00018760: 7320 6465 6669 6e65 6420 696e 2073 6563 s defined in sec │ │ │ │ │ -00018770: 7469 6f6e 2034 2061 626f 7665 2066 6f72 tion 4 above for │ │ │ │ │ -00018780: 0a20 2020 2020 6d6f 6469 6669 6564 2076 . modified v │ │ │ │ │ -00018790: 6572 7369 6f6e 732c 2070 726f 7669 6465 ersions, provide │ │ │ │ │ -000187a0: 6420 7468 6174 2079 6f75 2069 6e63 6c75 d that you inclu │ │ │ │ │ -000187b0: 6465 2069 6e20 7468 6520 636f 6d62 696e de in the combin │ │ │ │ │ -000187c0: 6174 696f 6e20 616c 6c0a 2020 2020 206f ation all. o │ │ │ │ │ -000187d0: 6620 7468 6520 496e 7661 7269 616e 7420 f the Invariant │ │ │ │ │ -000187e0: 5365 6374 696f 6e73 206f 6620 616c 6c20 Sections of all │ │ │ │ │ -000187f0: 6f66 2074 6865 206f 7269 6769 6e61 6c20 of the original │ │ │ │ │ -00018800: 646f 6375 6d65 6e74 732c 0a20 2020 2020 documents,. │ │ │ │ │ -00018810: 756e 6d6f 6469 6669 6564 2c20 616e 6420 unmodified, and │ │ │ │ │ -00018820: 6c69 7374 2074 6865 6d20 616c 6c20 6173 list them all as │ │ │ │ │ -00018830: 2049 6e76 6172 6961 6e74 2053 6563 7469 Invariant Secti │ │ │ │ │ -00018840: 6f6e 7320 6f66 2079 6f75 720a 2020 2020 ons of your. │ │ │ │ │ -00018850: 2063 6f6d 6269 6e65 6420 776f 726b 2069 combined work i │ │ │ │ │ -00018860: 6e20 6974 7320 6c69 6365 6e73 6520 6e6f n its license no │ │ │ │ │ -00018870: 7469 6365 2c20 616e 6420 7468 6174 2079 tice, and that y │ │ │ │ │ -00018880: 6f75 2070 7265 7365 7276 6520 616c 6c0a ou preserve all. │ │ │ │ │ -00018890: 2020 2020 2074 6865 6972 2057 6172 7261 their Warra │ │ │ │ │ -000188a0: 6e74 7920 4469 7363 6c61 696d 6572 732e nty Disclaimers. │ │ │ │ │ -000188b0: 0a0a 2020 2020 2054 6865 2063 6f6d 6269 .. The combi │ │ │ │ │ -000188c0: 6e65 6420 776f 726b 206e 6565 6420 6f6e ned work need on │ │ │ │ │ -000188d0: 6c79 2063 6f6e 7461 696e 206f 6e65 2063 ly contain one c │ │ │ │ │ -000188e0: 6f70 7920 6f66 2074 6869 7320 4c69 6365 opy of this Lice │ │ │ │ │ -000188f0: 6e73 652c 2061 6e64 0a20 2020 2020 6d75 nse, and. mu │ │ │ │ │ -00018900: 6c74 6970 6c65 2069 6465 6e74 6963 616c ltiple identical │ │ │ │ │ -00018910: 2049 6e76 6172 6961 6e74 2053 6563 7469 Invariant Secti │ │ │ │ │ -00018920: 6f6e 7320 6d61 7920 6265 2072 6570 6c61 ons may be repla │ │ │ │ │ -00018930: 6365 6420 7769 7468 2061 2073 696e 676c ced with a singl │ │ │ │ │ -00018940: 650a 2020 2020 2063 6f70 792e 2020 4966 e. copy. If │ │ │ │ │ -00018950: 2074 6865 7265 2061 7265 206d 756c 7469 there are multi │ │ │ │ │ -00018960: 706c 6520 496e 7661 7269 616e 7420 5365 ple Invariant Se │ │ │ │ │ -00018970: 6374 696f 6e73 2077 6974 6820 7468 6520 ctions with the │ │ │ │ │ -00018980: 7361 6d65 206e 616d 650a 2020 2020 2062 same name. b │ │ │ │ │ -00018990: 7574 2064 6966 6665 7265 6e74 2063 6f6e ut different con │ │ │ │ │ -000189a0: 7465 6e74 732c 206d 616b 6520 7468 6520 tents, make the │ │ │ │ │ -000189b0: 7469 746c 6520 6f66 2065 6163 6820 7375 title of each su │ │ │ │ │ -000189c0: 6368 2073 6563 7469 6f6e 2075 6e69 7175 ch section uniqu │ │ │ │ │ -000189d0: 650a 2020 2020 2062 7920 6164 6469 6e67 e. by adding │ │ │ │ │ -000189e0: 2061 7420 7468 6520 656e 6420 6f66 2069 at the end of i │ │ │ │ │ -000189f0: 742c 2069 6e20 7061 7265 6e74 6865 7365 t, in parenthese │ │ │ │ │ -00018a00: 732c 2074 6865 206e 616d 6520 6f66 2074 s, the name of t │ │ │ │ │ -00018a10: 6865 0a20 2020 2020 6f72 6967 696e 616c he. original │ │ │ │ │ -00018a20: 2061 7574 686f 7220 6f72 2070 7562 6c69 author or publi │ │ │ │ │ -00018a30: 7368 6572 206f 6620 7468 6174 2073 6563 sher of that sec │ │ │ │ │ -00018a40: 7469 6f6e 2069 6620 6b6e 6f77 6e2c 206f tion if known, o │ │ │ │ │ -00018a50: 7220 656c 7365 2061 0a20 2020 2020 756e r else a. un │ │ │ │ │ -00018a60: 6971 7565 206e 756d 6265 722e 2020 4d61 ique number. Ma │ │ │ │ │ -00018a70: 6b65 2074 6865 2073 616d 6520 6164 6a75 ke the same adju │ │ │ │ │ -00018a80: 7374 6d65 6e74 2074 6f20 7468 6520 7365 stment to the se │ │ │ │ │ -00018a90: 6374 696f 6e20 7469 746c 6573 2069 6e0a ction titles in. │ │ │ │ │ -00018aa0: 2020 2020 2074 6865 206c 6973 7420 6f66 the list of │ │ │ │ │ -00018ab0: 2049 6e76 6172 6961 6e74 2053 6563 7469 Invariant Secti │ │ │ │ │ -00018ac0: 6f6e 7320 696e 2074 6865 206c 6963 656e ons in the licen │ │ │ │ │ -00018ad0: 7365 206e 6f74 6963 6520 6f66 2074 6865 se notice of the │ │ │ │ │ -00018ae0: 0a20 2020 2020 636f 6d62 696e 6564 2077 . combined w │ │ │ │ │ -00018af0: 6f72 6b2e 0a0a 2020 2020 2049 6e20 7468 ork... In th │ │ │ │ │ -00018b00: 6520 636f 6d62 696e 6174 696f 6e2c 2079 e combination, y │ │ │ │ │ -00018b10: 6f75 206d 7573 7420 636f 6d62 696e 6520 ou must combine │ │ │ │ │ -00018b20: 616e 7920 7365 6374 696f 6e73 2045 6e74 any sections Ent │ │ │ │ │ -00018b30: 6974 6c65 640a 2020 2020 2022 4869 7374 itled. "Hist │ │ │ │ │ -00018b40: 6f72 7922 2069 6e20 7468 6520 7661 7269 ory" in the vari │ │ │ │ │ -00018b50: 6f75 7320 6f72 6967 696e 616c 2064 6f63 ous original doc │ │ │ │ │ -00018b60: 756d 656e 7473 2c20 666f 726d 696e 6720 uments, forming │ │ │ │ │ -00018b70: 6f6e 6520 7365 6374 696f 6e0a 2020 2020 one section. │ │ │ │ │ -00018b80: 2045 6e74 6974 6c65 6420 2248 6973 746f Entitled "Histo │ │ │ │ │ -00018b90: 7279 223b 206c 696b 6577 6973 6520 636f ry"; likewise co │ │ │ │ │ -00018ba0: 6d62 696e 6520 616e 7920 7365 6374 696f mbine any sectio │ │ │ │ │ -00018bb0: 6e73 2045 6e74 6974 6c65 640a 2020 2020 ns Entitled. │ │ │ │ │ -00018bc0: 2022 4163 6b6e 6f77 6c65 6467 656d 656e "Acknowledgemen │ │ │ │ │ -00018bd0: 7473 222c 2061 6e64 2061 6e79 2073 6563 ts", and any sec │ │ │ │ │ -00018be0: 7469 6f6e 7320 456e 7469 746c 6564 2022 tions Entitled " │ │ │ │ │ -00018bf0: 4465 6469 6361 7469 6f6e 7322 2e20 2059 Dedications". Y │ │ │ │ │ -00018c00: 6f75 0a20 2020 2020 6d75 7374 2064 656c ou. must del │ │ │ │ │ -00018c10: 6574 6520 616c 6c20 7365 6374 696f 6e73 ete all sections │ │ │ │ │ -00018c20: 2045 6e74 6974 6c65 6420 2245 6e64 6f72 Entitled "Endor │ │ │ │ │ -00018c30: 7365 6d65 6e74 732e 220a 0a20 2036 2e20 sements.".. 6. │ │ │ │ │ -00018c40: 434f 4c4c 4543 5449 4f4e 5320 4f46 2044 COLLECTIONS OF D │ │ │ │ │ -00018c50: 4f43 554d 454e 5453 0a0a 2020 2020 2059 OCUMENTS.. Y │ │ │ │ │ -00018c60: 6f75 206d 6179 206d 616b 6520 6120 636f ou may make a co │ │ │ │ │ -00018c70: 6c6c 6563 7469 6f6e 2063 6f6e 7369 7374 llection consist │ │ │ │ │ -00018c80: 696e 6720 6f66 2074 6865 2044 6f63 756d ing of the Docum │ │ │ │ │ -00018c90: 656e 7420 616e 6420 6f74 6865 720a 2020 ent and other. │ │ │ │ │ -00018ca0: 2020 2064 6f63 756d 656e 7473 2072 656c documents rel │ │ │ │ │ -00018cb0: 6561 7365 6420 756e 6465 7220 7468 6973 eased under this │ │ │ │ │ -00018cc0: 204c 6963 656e 7365 2c20 616e 6420 7265 License, and re │ │ │ │ │ -00018cd0: 706c 6163 6520 7468 6520 696e 6469 7669 place the indivi │ │ │ │ │ -00018ce0: 6475 616c 0a20 2020 2020 636f 7069 6573 dual. copies │ │ │ │ │ -00018cf0: 206f 6620 7468 6973 204c 6963 656e 7365 of this License │ │ │ │ │ -00018d00: 2069 6e20 7468 6520 7661 7269 6f75 7320 in the various │ │ │ │ │ -00018d10: 646f 6375 6d65 6e74 7320 7769 7468 2061 documents with a │ │ │ │ │ -00018d20: 2073 696e 676c 6520 636f 7079 0a20 2020 single copy. │ │ │ │ │ -00018d30: 2020 7468 6174 2069 7320 696e 636c 7564 that is includ │ │ │ │ │ -00018d40: 6564 2069 6e20 7468 6520 636f 6c6c 6563 ed in the collec │ │ │ │ │ -00018d50: 7469 6f6e 2c20 7072 6f76 6964 6564 2074 tion, provided t │ │ │ │ │ -00018d60: 6861 7420 796f 7520 666f 6c6c 6f77 2074 hat you follow t │ │ │ │ │ -00018d70: 6865 0a20 2020 2020 7275 6c65 7320 6f66 he. rules of │ │ │ │ │ -00018d80: 2074 6869 7320 4c69 6365 6e73 6520 666f this License fo │ │ │ │ │ -00018d90: 7220 7665 7262 6174 696d 2063 6f70 7969 r verbatim copyi │ │ │ │ │ -00018da0: 6e67 206f 6620 6561 6368 206f 6620 7468 ng of each of th │ │ │ │ │ -00018db0: 6520 646f 6375 6d65 6e74 730a 2020 2020 e documents. │ │ │ │ │ -00018dc0: 2069 6e20 616c 6c20 6f74 6865 7220 7265 in all other re │ │ │ │ │ -00018dd0: 7370 6563 7473 2e0a 0a20 2020 2020 596f spects... Yo │ │ │ │ │ -00018de0: 7520 6d61 7920 6578 7472 6163 7420 6120 u may extract a │ │ │ │ │ -00018df0: 7369 6e67 6c65 2064 6f63 756d 656e 7420 single document │ │ │ │ │ -00018e00: 6672 6f6d 2073 7563 6820 6120 636f 6c6c from such a coll │ │ │ │ │ -00018e10: 6563 7469 6f6e 2c20 616e 640a 2020 2020 ection, and. │ │ │ │ │ -00018e20: 2064 6973 7472 6962 7574 6520 6974 2069 distribute it i │ │ │ │ │ -00018e30: 6e64 6976 6964 7561 6c6c 7920 756e 6465 ndividually unde │ │ │ │ │ -00018e40: 7220 7468 6973 204c 6963 656e 7365 2c20 r this License, │ │ │ │ │ -00018e50: 7072 6f76 6964 6564 2079 6f75 2069 6e73 provided you ins │ │ │ │ │ -00018e60: 6572 740a 2020 2020 2061 2063 6f70 7920 ert. a copy │ │ │ │ │ -00018e70: 6f66 2074 6869 7320 4c69 6365 6e73 6520 of this License │ │ │ │ │ -00018e80: 696e 746f 2074 6865 2065 7874 7261 6374 into the extract │ │ │ │ │ -00018e90: 6564 2064 6f63 756d 656e 742c 2061 6e64 ed document, and │ │ │ │ │ -00018ea0: 2066 6f6c 6c6f 7720 7468 6973 0a20 2020 follow this. │ │ │ │ │ -00018eb0: 2020 4c69 6365 6e73 6520 696e 2061 6c6c License in all │ │ │ │ │ -00018ec0: 206f 7468 6572 2072 6573 7065 6374 7320 other respects │ │ │ │ │ -00018ed0: 7265 6761 7264 696e 6720 7665 7262 6174 regarding verbat │ │ │ │ │ -00018ee0: 696d 2063 6f70 7969 6e67 206f 6620 7468 im copying of th │ │ │ │ │ -00018ef0: 6174 0a20 2020 2020 646f 6375 6d65 6e74 at. document │ │ │ │ │ -00018f00: 2e0a 0a20 2037 2e20 4147 4752 4547 4154 ... 7. AGGREGAT │ │ │ │ │ -00018f10: 494f 4e20 5749 5448 2049 4e44 4550 454e ION WITH INDEPEN │ │ │ │ │ -00018f20: 4445 4e54 2057 4f52 4b53 0a0a 2020 2020 DENT WORKS.. │ │ │ │ │ -00018f30: 2041 2063 6f6d 7069 6c61 7469 6f6e 206f A compilation o │ │ │ │ │ -00018f40: 6620 7468 6520 446f 6375 6d65 6e74 206f f the Document o │ │ │ │ │ -00018f50: 7220 6974 7320 6465 7269 7661 7469 7665 r its derivative │ │ │ │ │ -00018f60: 7320 7769 7468 206f 7468 6572 0a20 2020 s with other. │ │ │ │ │ -00018f70: 2020 7365 7061 7261 7465 2061 6e64 2069 separate and i │ │ │ │ │ -00018f80: 6e64 6570 656e 6465 6e74 2064 6f63 756d ndependent docum │ │ │ │ │ -00018f90: 656e 7473 206f 7220 776f 726b 732c 2069 ents or works, i │ │ │ │ │ -00018fa0: 6e20 6f72 206f 6e20 6120 766f 6c75 6d65 n or on a volume │ │ │ │ │ -00018fb0: 206f 6620 610a 2020 2020 2073 746f 7261 of a. stora │ │ │ │ │ -00018fc0: 6765 206f 7220 6469 7374 7269 6275 7469 ge or distributi │ │ │ │ │ -00018fd0: 6f6e 206d 6564 6975 6d2c 2069 7320 6361 on medium, is ca │ │ │ │ │ -00018fe0: 6c6c 6564 2061 6e20 2261 6767 7265 6761 lled an "aggrega │ │ │ │ │ -00018ff0: 7465 2220 6966 2074 6865 0a20 2020 2020 te" if the. │ │ │ │ │ -00019000: 636f 7079 7269 6768 7420 7265 7375 6c74 copyright result │ │ │ │ │ -00019010: 696e 6720 6672 6f6d 2074 6865 2063 6f6d ing from the com │ │ │ │ │ -00019020: 7069 6c61 7469 6f6e 2069 7320 6e6f 7420 pilation is not │ │ │ │ │ -00019030: 7573 6564 2074 6f20 6c69 6d69 7420 7468 used to limit th │ │ │ │ │ -00019040: 650a 2020 2020 206c 6567 616c 2072 6967 e. legal rig │ │ │ │ │ -00019050: 6874 7320 6f66 2074 6865 2063 6f6d 7069 hts of the compi │ │ │ │ │ -00019060: 6c61 7469 6f6e 2773 2075 7365 7273 2062 lation's users b │ │ │ │ │ -00019070: 6579 6f6e 6420 7768 6174 2074 6865 2069 eyond what the i │ │ │ │ │ -00019080: 6e64 6976 6964 7561 6c0a 2020 2020 2077 ndividual. w │ │ │ │ │ -00019090: 6f72 6b73 2070 6572 6d69 742e 2020 5768 orks permit. Wh │ │ │ │ │ -000190a0: 656e 2074 6865 2044 6f63 756d 656e 7420 en the Document │ │ │ │ │ -000190b0: 6973 2069 6e63 6c75 6465 6420 696e 2061 is included in a │ │ │ │ │ -000190c0: 6e20 6167 6772 6567 6174 652c 2074 6869 n aggregate, thi │ │ │ │ │ -000190d0: 730a 2020 2020 204c 6963 656e 7365 2064 s. License d │ │ │ │ │ -000190e0: 6f65 7320 6e6f 7420 6170 706c 7920 746f oes not apply to │ │ │ │ │ -000190f0: 2074 6865 206f 7468 6572 2077 6f72 6b73 the other works │ │ │ │ │ -00019100: 2069 6e20 7468 6520 6167 6772 6567 6174 in the aggregat │ │ │ │ │ -00019110: 6520 7768 6963 680a 2020 2020 2061 7265 e which. are │ │ │ │ │ -00019120: 206e 6f74 2074 6865 6d73 656c 7665 7320 not themselves │ │ │ │ │ -00019130: 6465 7269 7661 7469 7665 2077 6f72 6b73 derivative works │ │ │ │ │ -00019140: 206f 6620 7468 6520 446f 6375 6d65 6e74 of the Document │ │ │ │ │ -00019150: 2e0a 0a20 2020 2020 4966 2074 6865 2043 ... If the C │ │ │ │ │ -00019160: 6f76 6572 2054 6578 7420 7265 7175 6972 over Text requir │ │ │ │ │ -00019170: 656d 656e 7420 6f66 2073 6563 7469 6f6e ement of section │ │ │ │ │ -00019180: 2033 2069 7320 6170 706c 6963 6162 6c65 3 is applicable │ │ │ │ │ -00019190: 2074 6f20 7468 6573 650a 2020 2020 2063 to these. c │ │ │ │ │ -000191a0: 6f70 6965 7320 6f66 2074 6865 2044 6f63 opies of the Doc │ │ │ │ │ -000191b0: 756d 656e 742c 2074 6865 6e20 6966 2074 ument, then if t │ │ │ │ │ -000191c0: 6865 2044 6f63 756d 656e 7420 6973 206c he Document is l │ │ │ │ │ -000191d0: 6573 7320 7468 616e 206f 6e65 2068 616c ess than one hal │ │ │ │ │ -000191e0: 660a 2020 2020 206f 6620 7468 6520 656e f. of the en │ │ │ │ │ -000191f0: 7469 7265 2061 6767 7265 6761 7465 2c20 tire aggregate, │ │ │ │ │ -00019200: 7468 6520 446f 6375 6d65 6e74 2773 2043 the Document's C │ │ │ │ │ -00019210: 6f76 6572 2054 6578 7473 206d 6179 2062 over Texts may b │ │ │ │ │ -00019220: 6520 706c 6163 6564 0a20 2020 2020 6f6e e placed. on │ │ │ │ │ -00019230: 2063 6f76 6572 7320 7468 6174 2062 7261 covers that bra │ │ │ │ │ -00019240: 636b 6574 2074 6865 2044 6f63 756d 656e cket the Documen │ │ │ │ │ -00019250: 7420 7769 7468 696e 2074 6865 2061 6767 t within the agg │ │ │ │ │ -00019260: 7265 6761 7465 2c20 6f72 2074 6865 0a20 regate, or the. │ │ │ │ │ -00019270: 2020 2020 656c 6563 7472 6f6e 6963 2065 electronic e │ │ │ │ │ -00019280: 7175 6976 616c 656e 7420 6f66 2063 6f76 quivalent of cov │ │ │ │ │ -00019290: 6572 7320 6966 2074 6865 2044 6f63 756d ers if the Docum │ │ │ │ │ -000192a0: 656e 7420 6973 2069 6e20 656c 6563 7472 ent is in electr │ │ │ │ │ -000192b0: 6f6e 6963 0a20 2020 2020 666f 726d 2e20 onic. form. │ │ │ │ │ -000192c0: 204f 7468 6572 7769 7365 2074 6865 7920 Otherwise they │ │ │ │ │ -000192d0: 6d75 7374 2061 7070 6561 7220 6f6e 2070 must appear on p │ │ │ │ │ -000192e0: 7269 6e74 6564 2063 6f76 6572 7320 7468 rinted covers th │ │ │ │ │ -000192f0: 6174 2062 7261 636b 6574 0a20 2020 2020 at bracket. │ │ │ │ │ -00019300: 7468 6520 7768 6f6c 6520 6167 6772 6567 the whole aggreg │ │ │ │ │ -00019310: 6174 652e 0a0a 2020 382e 2054 5241 4e53 ate... 8. TRANS │ │ │ │ │ -00019320: 4c41 5449 4f4e 0a0a 2020 2020 2054 7261 LATION.. Tra │ │ │ │ │ -00019330: 6e73 6c61 7469 6f6e 2069 7320 636f 6e73 nslation is cons │ │ │ │ │ -00019340: 6964 6572 6564 2061 206b 696e 6420 6f66 idered a kind of │ │ │ │ │ -00019350: 206d 6f64 6966 6963 6174 696f 6e2c 2073 modification, s │ │ │ │ │ -00019360: 6f20 796f 7520 6d61 790a 2020 2020 2064 o you may. d │ │ │ │ │ -00019370: 6973 7472 6962 7574 6520 7472 616e 736c istribute transl │ │ │ │ │ -00019380: 6174 696f 6e73 206f 6620 7468 6520 446f ations of the Do │ │ │ │ │ -00019390: 6375 6d65 6e74 2075 6e64 6572 2074 6865 cument under the │ │ │ │ │ -000193a0: 2074 6572 6d73 206f 6620 7365 6374 696f terms of sectio │ │ │ │ │ -000193b0: 6e0a 2020 2020 2034 2e20 2052 6570 6c61 n. 4. Repla │ │ │ │ │ -000193c0: 6369 6e67 2049 6e76 6172 6961 6e74 2053 cing Invariant S │ │ │ │ │ -000193d0: 6563 7469 6f6e 7320 7769 7468 2074 7261 ections with tra │ │ │ │ │ -000193e0: 6e73 6c61 7469 6f6e 7320 7265 7175 6972 nslations requir │ │ │ │ │ -000193f0: 6573 2073 7065 6369 616c 0a20 2020 2020 es special. │ │ │ │ │ -00019400: 7065 726d 6973 7369 6f6e 2066 726f 6d20 permission from │ │ │ │ │ -00019410: 7468 6569 7220 636f 7079 7269 6768 7420 their copyright │ │ │ │ │ -00019420: 686f 6c64 6572 732c 2062 7574 2079 6f75 holders, but you │ │ │ │ │ -00019430: 206d 6179 2069 6e63 6c75 6465 0a20 2020 may include. │ │ │ │ │ -00019440: 2020 7472 616e 736c 6174 696f 6e73 206f translations o │ │ │ │ │ -00019450: 6620 736f 6d65 206f 7220 616c 6c20 496e f some or all In │ │ │ │ │ -00019460: 7661 7269 616e 7420 5365 6374 696f 6e73 variant Sections │ │ │ │ │ -00019470: 2069 6e20 6164 6469 7469 6f6e 2074 6f20 in addition to │ │ │ │ │ -00019480: 7468 650a 2020 2020 206f 7269 6769 6e61 the. origina │ │ │ │ │ -00019490: 6c20 7665 7273 696f 6e73 206f 6620 7468 l versions of th │ │ │ │ │ -000194a0: 6573 6520 496e 7661 7269 616e 7420 5365 ese Invariant Se │ │ │ │ │ -000194b0: 6374 696f 6e73 2e20 2059 6f75 206d 6179 ctions. You may │ │ │ │ │ -000194c0: 2069 6e63 6c75 6465 2061 0a20 2020 2020 include a. │ │ │ │ │ -000194d0: 7472 616e 736c 6174 696f 6e20 6f66 2074 translation of t │ │ │ │ │ -000194e0: 6869 7320 4c69 6365 6e73 652c 2061 6e64 his License, and │ │ │ │ │ -000194f0: 2061 6c6c 2074 6865 206c 6963 656e 7365 all the license │ │ │ │ │ -00019500: 206e 6f74 6963 6573 2069 6e20 7468 650a notices in the. │ │ │ │ │ -00019510: 2020 2020 2044 6f63 756d 656e 742c 2061 Document, a │ │ │ │ │ -00019520: 6e64 2061 6e79 2057 6172 7261 6e74 7920 nd any Warranty │ │ │ │ │ -00019530: 4469 7363 6c61 696d 6572 732c 2070 726f Disclaimers, pro │ │ │ │ │ -00019540: 7669 6465 6420 7468 6174 2079 6f75 2061 vided that you a │ │ │ │ │ -00019550: 6c73 6f0a 2020 2020 2069 6e63 6c75 6465 lso. include │ │ │ │ │ -00019560: 2074 6865 206f 7269 6769 6e61 6c20 456e the original En │ │ │ │ │ -00019570: 676c 6973 6820 7665 7273 696f 6e20 6f66 glish version of │ │ │ │ │ -00019580: 2074 6869 7320 4c69 6365 6e73 6520 616e this License an │ │ │ │ │ -00019590: 6420 7468 650a 2020 2020 206f 7269 6769 d the. origi │ │ │ │ │ -000195a0: 6e61 6c20 7665 7273 696f 6e73 206f 6620 nal versions of │ │ │ │ │ -000195b0: 7468 6f73 6520 6e6f 7469 6365 7320 616e those notices an │ │ │ │ │ -000195c0: 6420 6469 7363 6c61 696d 6572 732e 2020 d disclaimers. │ │ │ │ │ -000195d0: 496e 2063 6173 6520 6f66 2061 0a20 2020 In case of a. │ │ │ │ │ -000195e0: 2020 6469 7361 6772 6565 6d65 6e74 2062 disagreement b │ │ │ │ │ -000195f0: 6574 7765 656e 2074 6865 2074 7261 6e73 etween the trans │ │ │ │ │ -00019600: 6c61 7469 6f6e 2061 6e64 2074 6865 206f lation and the o │ │ │ │ │ -00019610: 7269 6769 6e61 6c20 7665 7273 696f 6e20 riginal version │ │ │ │ │ -00019620: 6f66 0a20 2020 2020 7468 6973 204c 6963 of. this Lic │ │ │ │ │ -00019630: 656e 7365 206f 7220 6120 6e6f 7469 6365 ense or a notice │ │ │ │ │ -00019640: 206f 7220 6469 7363 6c61 696d 6572 2c20 or disclaimer, │ │ │ │ │ -00019650: 7468 6520 6f72 6967 696e 616c 2076 6572 the original ver │ │ │ │ │ -00019660: 7369 6f6e 2077 696c 6c0a 2020 2020 2070 sion will. p │ │ │ │ │ -00019670: 7265 7661 696c 2e0a 0a20 2020 2020 4966 revail... If │ │ │ │ │ -00019680: 2061 2073 6563 7469 6f6e 2069 6e20 7468 a section in th │ │ │ │ │ -00019690: 6520 446f 6375 6d65 6e74 2069 7320 456e e Document is En │ │ │ │ │ -000196a0: 7469 746c 6564 2022 4163 6b6e 6f77 6c65 titled "Acknowle │ │ │ │ │ -000196b0: 6467 656d 656e 7473 222c 0a20 2020 2020 dgements",. │ │ │ │ │ -000196c0: 2244 6564 6963 6174 696f 6e73 222c 206f "Dedications", o │ │ │ │ │ -000196d0: 7220 2248 6973 746f 7279 222c 2074 6865 r "History", the │ │ │ │ │ -000196e0: 2072 6571 7569 7265 6d65 6e74 2028 7365 requirement (se │ │ │ │ │ -000196f0: 6374 696f 6e20 3429 2074 6f0a 2020 2020 ction 4) to. │ │ │ │ │ -00019700: 2050 7265 7365 7276 6520 6974 7320 5469 Preserve its Ti │ │ │ │ │ -00019710: 746c 6520 2873 6563 7469 6f6e 2031 2920 tle (section 1) │ │ │ │ │ -00019720: 7769 6c6c 2074 7970 6963 616c 6c79 2072 will typically r │ │ │ │ │ -00019730: 6571 7569 7265 2063 6861 6e67 696e 6720 equire changing │ │ │ │ │ -00019740: 7468 650a 2020 2020 2061 6374 7561 6c20 the. actual │ │ │ │ │ -00019750: 7469 746c 652e 0a0a 2020 392e 2054 4552 title... 9. TER │ │ │ │ │ -00019760: 4d49 4e41 5449 4f4e 0a0a 2020 2020 2059 MINATION.. Y │ │ │ │ │ -00019770: 6f75 206d 6179 206e 6f74 2063 6f70 792c ou may not copy, │ │ │ │ │ -00019780: 206d 6f64 6966 792c 2073 7562 6c69 6365 modify, sublice │ │ │ │ │ -00019790: 6e73 652c 206f 7220 6469 7374 7269 6275 nse, or distribu │ │ │ │ │ -000197a0: 7465 2074 6865 2044 6f63 756d 656e 740a te the Document. │ │ │ │ │ -000197b0: 2020 2020 2065 7863 6570 7420 6173 2065 except as e │ │ │ │ │ -000197c0: 7870 7265 7373 6c79 2070 726f 7669 6465 xpressly provide │ │ │ │ │ -000197d0: 6420 666f 7220 756e 6465 7220 7468 6973 d for under this │ │ │ │ │ -000197e0: 204c 6963 656e 7365 2e20 2041 6e79 206f License. Any o │ │ │ │ │ -000197f0: 7468 6572 0a20 2020 2020 6174 7465 6d70 ther. attemp │ │ │ │ │ -00019800: 7420 746f 2063 6f70 792c 206d 6f64 6966 t to copy, modif │ │ │ │ │ -00019810: 792c 2073 7562 6c69 6365 6e73 6520 6f72 y, sublicense or │ │ │ │ │ -00019820: 2064 6973 7472 6962 7574 6520 7468 6520 distribute the │ │ │ │ │ -00019830: 446f 6375 6d65 6e74 2069 730a 2020 2020 Document is. │ │ │ │ │ -00019840: 2076 6f69 642c 2061 6e64 2077 696c 6c20 void, and will │ │ │ │ │ -00019850: 6175 746f 6d61 7469 6361 6c6c 7920 7465 automatically te │ │ │ │ │ -00019860: 726d 696e 6174 6520 796f 7572 2072 6967 rminate your rig │ │ │ │ │ -00019870: 6874 7320 756e 6465 7220 7468 6973 0a20 hts under this. │ │ │ │ │ -00019880: 2020 2020 4c69 6365 6e73 652e 2020 486f License. Ho │ │ │ │ │ -00019890: 7765 7665 722c 2070 6172 7469 6573 2077 wever, parties w │ │ │ │ │ -000198a0: 686f 2068 6176 6520 7265 6365 6976 6564 ho have received │ │ │ │ │ -000198b0: 2063 6f70 6965 732c 206f 7220 7269 6768 copies, or righ │ │ │ │ │ -000198c0: 7473 2c0a 2020 2020 2066 726f 6d20 796f ts,. from yo │ │ │ │ │ -000198d0: 7520 756e 6465 7220 7468 6973 204c 6963 u under this Lic │ │ │ │ │ -000198e0: 656e 7365 2077 696c 6c20 6e6f 7420 6861 ense will not ha │ │ │ │ │ -000198f0: 7665 2074 6865 6972 206c 6963 656e 7365 ve their license │ │ │ │ │ -00019900: 7320 7465 726d 696e 6174 6564 0a20 2020 s terminated. │ │ │ │ │ -00019910: 2020 736f 206c 6f6e 6720 6173 2073 7563 so long as suc │ │ │ │ │ -00019920: 6820 7061 7274 6965 7320 7265 6d61 696e h parties remain │ │ │ │ │ -00019930: 2069 6e20 6675 6c6c 2063 6f6d 706c 6961 in full complia │ │ │ │ │ -00019940: 6e63 652e 0a0a 2020 3130 2e20 4655 5455 nce... 10. FUTU │ │ │ │ │ -00019950: 5245 2052 4556 4953 494f 4e53 204f 4620 RE REVISIONS OF │ │ │ │ │ -00019960: 5448 4953 204c 4943 454e 5345 0a0a 2020 THIS LICENSE.. │ │ │ │ │ -00019970: 2020 2054 6865 2046 7265 6520 536f 6674 The Free Soft │ │ │ │ │ -00019980: 7761 7265 2046 6f75 6e64 6174 696f 6e20 ware Foundation │ │ │ │ │ -00019990: 6d61 7920 7075 626c 6973 6820 6e65 772c may publish new, │ │ │ │ │ -000199a0: 2072 6576 6973 6564 2076 6572 7369 6f6e revised version │ │ │ │ │ -000199b0: 7320 6f66 0a20 2020 2020 7468 6520 474e s of. the GN │ │ │ │ │ -000199c0: 5520 4672 6565 2044 6f63 756d 656e 7461 U Free Documenta │ │ │ │ │ -000199d0: 7469 6f6e 204c 6963 656e 7365 2066 726f tion License fro │ │ │ │ │ -000199e0: 6d20 7469 6d65 2074 6f20 7469 6d65 2e20 m time to time. │ │ │ │ │ -000199f0: 2053 7563 6820 6e65 770a 2020 2020 2076 Such new. v │ │ │ │ │ -00019a00: 6572 7369 6f6e 7320 7769 6c6c 2062 6520 ersions will be │ │ │ │ │ -00019a10: 7369 6d69 6c61 7220 696e 2073 7069 7269 similar in spiri │ │ │ │ │ -00019a20: 7420 746f 2074 6865 2070 7265 7365 6e74 t to the present │ │ │ │ │ -00019a30: 2076 6572 7369 6f6e 2c20 6275 7420 6d61 version, but ma │ │ │ │ │ -00019a40: 790a 2020 2020 2064 6966 6665 7220 696e y. differ in │ │ │ │ │ -00019a50: 2064 6574 6169 6c20 746f 2061 6464 7265 detail to addre │ │ │ │ │ -00019a60: 7373 206e 6577 2070 726f 626c 656d 7320 ss new problems │ │ │ │ │ -00019a70: 6f72 2063 6f6e 6365 726e 732e 2020 5365 or concerns. Se │ │ │ │ │ -00019a80: 650a 2020 2020 203c 6874 7470 3a2f 2f77 e. ... Eac │ │ │ │ │ -00019ab0: 6820 7665 7273 696f 6e20 6f66 2074 6865 h version of the │ │ │ │ │ -00019ac0: 204c 6963 656e 7365 2069 7320 6769 7665 License is give │ │ │ │ │ -00019ad0: 6e20 6120 6469 7374 696e 6775 6973 6869 n a distinguishi │ │ │ │ │ -00019ae0: 6e67 2076 6572 7369 6f6e 0a20 2020 2020 ng version. │ │ │ │ │ -00019af0: 6e75 6d62 6572 2e20 2049 6620 7468 6520 number. If the │ │ │ │ │ -00019b00: 446f 6375 6d65 6e74 2073 7065 6369 6669 Document specifi │ │ │ │ │ -00019b10: 6573 2074 6861 7420 6120 7061 7274 6963 es that a partic │ │ │ │ │ -00019b20: 756c 6172 206e 756d 6265 7265 640a 2020 ular numbered. │ │ │ │ │ -00019b30: 2020 2076 6572 7369 6f6e 206f 6620 7468 version of th │ │ │ │ │ -00019b40: 6973 204c 6963 656e 7365 2022 6f72 2061 is License "or a │ │ │ │ │ -00019b50: 6e79 206c 6174 6572 2076 6572 7369 6f6e ny later version │ │ │ │ │ -00019b60: 2220 6170 706c 6965 7320 746f 2069 742c " applies to it, │ │ │ │ │ -00019b70: 2079 6f75 0a20 2020 2020 6861 7665 2074 you. have t │ │ │ │ │ -00019b80: 6865 206f 7074 696f 6e20 6f66 2066 6f6c he option of fol │ │ │ │ │ -00019b90: 6c6f 7769 6e67 2074 6865 2074 6572 6d73 lowing the terms │ │ │ │ │ -00019ba0: 2061 6e64 2063 6f6e 6469 7469 6f6e 7320 and conditions │ │ │ │ │ -00019bb0: 6569 7468 6572 206f 660a 2020 2020 2074 either of. t │ │ │ │ │ -00019bc0: 6861 7420 7370 6563 6966 6965 6420 7665 hat specified ve │ │ │ │ │ -00019bd0: 7273 696f 6e20 6f72 206f 6620 616e 7920 rsion or of any │ │ │ │ │ -00019be0: 6c61 7465 7220 7665 7273 696f 6e20 7468 later version th │ │ │ │ │ -00019bf0: 6174 2068 6173 2062 6565 6e0a 2020 2020 at has been. │ │ │ │ │ -00019c00: 2070 7562 6c69 7368 6564 2028 6e6f 7420 published (not │ │ │ │ │ -00019c10: 6173 2061 2064 7261 6674 2920 6279 2074 as a draft) by t │ │ │ │ │ -00019c20: 6865 2046 7265 6520 536f 6674 7761 7265 he Free Software │ │ │ │ │ -00019c30: 2046 6f75 6e64 6174 696f 6e2e 2020 4966 Foundation. If │ │ │ │ │ -00019c40: 2074 6865 0a20 2020 2020 446f 6375 6d65 the. Docume │ │ │ │ │ -00019c50: 6e74 2064 6f65 7320 6e6f 7420 7370 6563 nt does not spec │ │ │ │ │ -00019c60: 6966 7920 6120 7665 7273 696f 6e20 6e75 ify a version nu │ │ │ │ │ -00019c70: 6d62 6572 206f 6620 7468 6973 204c 6963 mber of this Lic │ │ │ │ │ -00019c80: 656e 7365 2c20 796f 7520 6d61 790a 2020 ense, you may. │ │ │ │ │ -00019c90: 2020 2063 686f 6f73 6520 616e 7920 7665 choose any ve │ │ │ │ │ -00019ca0: 7273 696f 6e20 6576 6572 2070 7562 6c69 rsion ever publi │ │ │ │ │ -00019cb0: 7368 6564 2028 6e6f 7420 6173 2061 2064 shed (not as a d │ │ │ │ │ -00019cc0: 7261 6674 2920 6279 2074 6865 2046 7265 raft) by the Fre │ │ │ │ │ -00019cd0: 650a 2020 2020 2053 6f66 7477 6172 6520 e. Software │ │ │ │ │ -00019ce0: 466f 756e 6461 7469 6f6e 2e0a 0a41 2e31 Foundation...A.1 │ │ │ │ │ -00019cf0: 2e31 2041 4444 454e 4455 4d3a 2048 6f77 .1 ADDENDUM: How │ │ │ │ │ -00019d00: 2074 6f20 7573 6520 7468 6973 204c 6963 to use this Lic │ │ │ │ │ -00019d10: 656e 7365 2066 6f72 2079 6f75 7220 646f ense for your do │ │ │ │ │ -00019d20: 6375 6d65 6e74 730a 2d2d 2d2d 2d2d 2d2d cuments.-------- │ │ │ │ │ +00014bb0: 2020 2056 6572 7369 6f6e 2031 2e32 2c20 Version 1.2, │ │ │ │ │ +00014bc0: 4e6f 7665 6d62 6572 2032 3030 320a 0a20 November 2002.. │ │ │ │ │ +00014bd0: 2020 2020 436f 7079 7269 6768 7420 2843 Copyright (C │ │ │ │ │ +00014be0: 2920 3230 3030 2c32 3030 312c 3230 3032 ) 2000,2001,2002 │ │ │ │ │ +00014bf0: 2046 7265 6520 536f 6674 7761 7265 2046 Free Software F │ │ │ │ │ +00014c00: 6f75 6e64 6174 696f 6e2c 2049 6e63 2e0a oundation, Inc.. │ │ │ │ │ +00014c10: 2020 2020 2035 3120 4672 616e 6b6c 696e 51 Franklin │ │ │ │ │ +00014c20: 2053 742c 2046 6966 7468 2046 6c6f 6f72 St, Fifth Floor │ │ │ │ │ +00014c30: 2c20 426f 7374 6f6e 2c20 4d41 2020 3032 , Boston, MA 02 │ │ │ │ │ +00014c40: 3131 302d 3133 3031 2c20 5553 410a 0a20 110-1301, USA.. │ │ │ │ │ +00014c50: 2020 2020 4576 6572 796f 6e65 2069 7320 Everyone is │ │ │ │ │ +00014c60: 7065 726d 6974 7465 6420 746f 2063 6f70 permitted to cop │ │ │ │ │ +00014c70: 7920 616e 6420 6469 7374 7269 6275 7465 y and distribute │ │ │ │ │ +00014c80: 2076 6572 6261 7469 6d20 636f 7069 6573 verbatim copies │ │ │ │ │ +00014c90: 0a20 2020 2020 6f66 2074 6869 7320 6c69 . of this li │ │ │ │ │ +00014ca0: 6365 6e73 6520 646f 6375 6d65 6e74 2c20 cense document, │ │ │ │ │ +00014cb0: 6275 7420 6368 616e 6769 6e67 2069 7420 but changing it │ │ │ │ │ +00014cc0: 6973 206e 6f74 2061 6c6c 6f77 6564 2e0a is not allowed.. │ │ │ │ │ +00014cd0: 0a20 2030 2e20 5052 4541 4d42 4c45 0a0a . 0. PREAMBLE.. │ │ │ │ │ +00014ce0: 2020 2020 2054 6865 2070 7572 706f 7365 The purpose │ │ │ │ │ +00014cf0: 206f 6620 7468 6973 204c 6963 656e 7365 of this License │ │ │ │ │ +00014d00: 2069 7320 746f 206d 616b 6520 6120 6d61 is to make a ma │ │ │ │ │ +00014d10: 6e75 616c 2c20 7465 7874 626f 6f6b 2c20 nual, textbook, │ │ │ │ │ +00014d20: 6f72 206f 7468 6572 0a20 2020 2020 6675 or other. fu │ │ │ │ │ +00014d30: 6e63 7469 6f6e 616c 2061 6e64 2075 7365 nctional and use │ │ │ │ │ +00014d40: 6675 6c20 646f 6375 6d65 6e74 2022 6672 ful document "fr │ │ │ │ │ +00014d50: 6565 2220 696e 2074 6865 2073 656e 7365 ee" in the sense │ │ │ │ │ +00014d60: 206f 6620 6672 6565 646f 6d3a 2074 6f0a of freedom: to. │ │ │ │ │ +00014d70: 2020 2020 2061 7373 7572 6520 6576 6572 assure ever │ │ │ │ │ +00014d80: 796f 6e65 2074 6865 2065 6666 6563 7469 yone the effecti │ │ │ │ │ +00014d90: 7665 2066 7265 6564 6f6d 2074 6f20 636f ve freedom to co │ │ │ │ │ +00014da0: 7079 2061 6e64 2072 6564 6973 7472 6962 py and redistrib │ │ │ │ │ +00014db0: 7574 6520 6974 2c0a 2020 2020 2077 6974 ute it,. wit │ │ │ │ │ +00014dc0: 6820 6f72 2077 6974 686f 7574 206d 6f64 h or without mod │ │ │ │ │ +00014dd0: 6966 7969 6e67 2069 742c 2065 6974 6865 ifying it, eithe │ │ │ │ │ +00014de0: 7220 636f 6d6d 6572 6369 616c 6c79 206f r commercially o │ │ │ │ │ +00014df0: 720a 2020 2020 206e 6f6e 636f 6d6d 6572 r. noncommer │ │ │ │ │ +00014e00: 6369 616c 6c79 2e20 2053 6563 6f6e 6461 cially. Seconda │ │ │ │ │ +00014e10: 7269 6c79 2c20 7468 6973 204c 6963 656e rily, this Licen │ │ │ │ │ +00014e20: 7365 2070 7265 7365 7276 6573 2066 6f72 se preserves for │ │ │ │ │ +00014e30: 2074 6865 0a20 2020 2020 6175 7468 6f72 the. author │ │ │ │ │ +00014e40: 2061 6e64 2070 7562 6c69 7368 6572 2061 and publisher a │ │ │ │ │ +00014e50: 2077 6179 2074 6f20 6765 7420 6372 6564 way to get cred │ │ │ │ │ +00014e60: 6974 2066 6f72 2074 6865 6972 2077 6f72 it for their wor │ │ │ │ │ +00014e70: 6b2c 2077 6869 6c65 206e 6f74 0a20 2020 k, while not. │ │ │ │ │ +00014e80: 2020 6265 696e 6720 636f 6e73 6964 6572 being consider │ │ │ │ │ +00014e90: 6564 2072 6573 706f 6e73 6962 6c65 2066 ed responsible f │ │ │ │ │ +00014ea0: 6f72 206d 6f64 6966 6963 6174 696f 6e73 or modifications │ │ │ │ │ +00014eb0: 206d 6164 6520 6279 206f 7468 6572 732e made by others. │ │ │ │ │ +00014ec0: 0a0a 2020 2020 2054 6869 7320 4c69 6365 .. This Lice │ │ │ │ │ +00014ed0: 6e73 6520 6973 2061 206b 696e 6420 6f66 nse is a kind of │ │ │ │ │ +00014ee0: 2022 636f 7079 6c65 6674 222c 2077 6869 "copyleft", whi │ │ │ │ │ +00014ef0: 6368 206d 6561 6e73 2074 6861 7420 6465 ch means that de │ │ │ │ │ +00014f00: 7269 7661 7469 7665 0a20 2020 2020 776f rivative. wo │ │ │ │ │ +00014f10: 726b 7320 6f66 2074 6865 2064 6f63 756d rks of the docum │ │ │ │ │ +00014f20: 656e 7420 6d75 7374 2074 6865 6d73 656c ent must themsel │ │ │ │ │ +00014f30: 7665 7320 6265 2066 7265 6520 696e 2074 ves be free in t │ │ │ │ │ +00014f40: 6865 2073 616d 6520 7365 6e73 652e 0a20 he same sense.. │ │ │ │ │ +00014f50: 2020 2020 4974 2063 6f6d 706c 656d 656e It complemen │ │ │ │ │ +00014f60: 7473 2074 6865 2047 4e55 2047 656e 6572 ts the GNU Gener │ │ │ │ │ +00014f70: 616c 2050 7562 6c69 6320 4c69 6365 6e73 al Public Licens │ │ │ │ │ +00014f80: 652c 2077 6869 6368 2069 7320 6120 636f e, which is a co │ │ │ │ │ +00014f90: 7079 6c65 6674 0a20 2020 2020 6c69 6365 pyleft. lice │ │ │ │ │ +00014fa0: 6e73 6520 6465 7369 676e 6564 2066 6f72 nse designed for │ │ │ │ │ +00014fb0: 2066 7265 6520 736f 6674 7761 7265 2e0a free software.. │ │ │ │ │ +00014fc0: 0a20 2020 2020 5765 2068 6176 6520 6465 . We have de │ │ │ │ │ +00014fd0: 7369 676e 6564 2074 6869 7320 4c69 6365 signed this Lice │ │ │ │ │ +00014fe0: 6e73 6520 696e 206f 7264 6572 2074 6f20 nse in order to │ │ │ │ │ +00014ff0: 7573 6520 6974 2066 6f72 206d 616e 7561 use it for manua │ │ │ │ │ +00015000: 6c73 2066 6f72 0a20 2020 2020 6672 6565 ls for. free │ │ │ │ │ +00015010: 2073 6f66 7477 6172 652c 2062 6563 6175 software, becau │ │ │ │ │ +00015020: 7365 2066 7265 6520 736f 6674 7761 7265 se free software │ │ │ │ │ +00015030: 206e 6565 6473 2066 7265 6520 646f 6375 needs free docu │ │ │ │ │ +00015040: 6d65 6e74 6174 696f 6e3a 2061 0a20 2020 mentation: a. │ │ │ │ │ +00015050: 2020 6672 6565 2070 726f 6772 616d 2073 free program s │ │ │ │ │ +00015060: 686f 756c 6420 636f 6d65 2077 6974 6820 hould come with │ │ │ │ │ +00015070: 6d61 6e75 616c 7320 7072 6f76 6964 696e manuals providin │ │ │ │ │ +00015080: 6720 7468 6520 7361 6d65 2066 7265 6564 g the same freed │ │ │ │ │ +00015090: 6f6d 730a 2020 2020 2074 6861 7420 7468 oms. that th │ │ │ │ │ +000150a0: 6520 736f 6674 7761 7265 2064 6f65 732e e software does. │ │ │ │ │ +000150b0: 2020 4275 7420 7468 6973 204c 6963 656e But this Licen │ │ │ │ │ +000150c0: 7365 2069 7320 6e6f 7420 6c69 6d69 7465 se is not limite │ │ │ │ │ +000150d0: 6420 746f 0a20 2020 2020 736f 6674 7761 d to. softwa │ │ │ │ │ +000150e0: 7265 206d 616e 7561 6c73 3b20 6974 2063 re manuals; it c │ │ │ │ │ +000150f0: 616e 2062 6520 7573 6564 2066 6f72 2061 an be used for a │ │ │ │ │ +00015100: 6e79 2074 6578 7475 616c 2077 6f72 6b2c ny textual work, │ │ │ │ │ +00015110: 2072 6567 6172 646c 6573 730a 2020 2020 regardless. │ │ │ │ │ +00015120: 206f 6620 7375 626a 6563 7420 6d61 7474 of subject matt │ │ │ │ │ +00015130: 6572 206f 7220 7768 6574 6865 7220 6974 er or whether it │ │ │ │ │ +00015140: 2069 7320 7075 626c 6973 6865 6420 6173 is published as │ │ │ │ │ +00015150: 2061 2070 7269 6e74 6564 2062 6f6f 6b2e a printed book. │ │ │ │ │ +00015160: 2020 5765 0a20 2020 2020 7265 636f 6d6d We. recomm │ │ │ │ │ +00015170: 656e 6420 7468 6973 204c 6963 656e 7365 end this License │ │ │ │ │ +00015180: 2070 7269 6e63 6970 616c 6c79 2066 6f72 principally for │ │ │ │ │ +00015190: 2077 6f72 6b73 2077 686f 7365 2070 7572 works whose pur │ │ │ │ │ +000151a0: 706f 7365 2069 730a 2020 2020 2069 6e73 pose is. ins │ │ │ │ │ +000151b0: 7472 7563 7469 6f6e 206f 7220 7265 6665 truction or refe │ │ │ │ │ +000151c0: 7265 6e63 652e 0a0a 2020 312e 2041 5050 rence... 1. APP │ │ │ │ │ +000151d0: 4c49 4341 4249 4c49 5459 2041 4e44 2044 LICABILITY AND D │ │ │ │ │ +000151e0: 4546 494e 4954 494f 4e53 0a0a 2020 2020 EFINITIONS.. │ │ │ │ │ +000151f0: 2054 6869 7320 4c69 6365 6e73 6520 6170 This License ap │ │ │ │ │ +00015200: 706c 6965 7320 746f 2061 6e79 206d 616e plies to any man │ │ │ │ │ +00015210: 7561 6c20 6f72 206f 7468 6572 2077 6f72 ual or other wor │ │ │ │ │ +00015220: 6b2c 2069 6e20 616e 7920 6d65 6469 756d k, in any medium │ │ │ │ │ +00015230: 2c0a 2020 2020 2074 6861 7420 636f 6e74 ,. that cont │ │ │ │ │ +00015240: 6169 6e73 2061 206e 6f74 6963 6520 706c ains a notice pl │ │ │ │ │ +00015250: 6163 6564 2062 7920 7468 6520 636f 7079 aced by the copy │ │ │ │ │ +00015260: 7269 6768 7420 686f 6c64 6572 2073 6179 right holder say │ │ │ │ │ +00015270: 696e 6720 6974 2063 616e 0a20 2020 2020 ing it can. │ │ │ │ │ +00015280: 6265 2064 6973 7472 6962 7574 6564 2075 be distributed u │ │ │ │ │ +00015290: 6e64 6572 2074 6865 2074 6572 6d73 206f nder the terms o │ │ │ │ │ +000152a0: 6620 7468 6973 204c 6963 656e 7365 2e20 f this License. │ │ │ │ │ +000152b0: 2053 7563 6820 6120 6e6f 7469 6365 0a20 Such a notice. │ │ │ │ │ +000152c0: 2020 2020 6772 616e 7473 2061 2077 6f72 grants a wor │ │ │ │ │ +000152d0: 6c64 2d77 6964 652c 2072 6f79 616c 7479 ld-wide, royalty │ │ │ │ │ +000152e0: 2d66 7265 6520 6c69 6365 6e73 652c 2075 -free license, u │ │ │ │ │ +000152f0: 6e6c 696d 6974 6564 2069 6e20 6475 7261 nlimited in dura │ │ │ │ │ +00015300: 7469 6f6e 2c0a 2020 2020 2074 6f20 7573 tion,. to us │ │ │ │ │ +00015310: 6520 7468 6174 2077 6f72 6b20 756e 6465 e that work unde │ │ │ │ │ +00015320: 7220 7468 6520 636f 6e64 6974 696f 6e73 r the conditions │ │ │ │ │ +00015330: 2073 7461 7465 6420 6865 7265 696e 2e20 stated herein. │ │ │ │ │ +00015340: 2054 6865 0a20 2020 2020 2244 6f63 756d The. "Docum │ │ │ │ │ +00015350: 656e 7422 2c20 6265 6c6f 772c 2072 6566 ent", below, ref │ │ │ │ │ +00015360: 6572 7320 746f 2061 6e79 2073 7563 6820 ers to any such │ │ │ │ │ +00015370: 6d61 6e75 616c 206f 7220 776f 726b 2e20 manual or work. │ │ │ │ │ +00015380: 2041 6e79 206d 656d 6265 720a 2020 2020 Any member. │ │ │ │ │ +00015390: 206f 6620 7468 6520 7075 626c 6963 2069 of the public i │ │ │ │ │ +000153a0: 7320 6120 6c69 6365 6e73 6565 2c20 616e s a licensee, an │ │ │ │ │ +000153b0: 6420 6973 2061 6464 7265 7373 6564 2061 d is addressed a │ │ │ │ │ +000153c0: 7320 2279 6f75 222e 2020 596f 7520 6163 s "you". You ac │ │ │ │ │ +000153d0: 6365 7074 0a20 2020 2020 7468 6520 6c69 cept. the li │ │ │ │ │ +000153e0: 6365 6e73 6520 6966 2079 6f75 2063 6f70 cense if you cop │ │ │ │ │ +000153f0: 792c 206d 6f64 6966 7920 6f72 2064 6973 y, modify or dis │ │ │ │ │ +00015400: 7472 6962 7574 6520 7468 6520 776f 726b tribute the work │ │ │ │ │ +00015410: 2069 6e20 6120 7761 790a 2020 2020 2072 in a way. r │ │ │ │ │ +00015420: 6571 7569 7269 6e67 2070 6572 6d69 7373 equiring permiss │ │ │ │ │ +00015430: 696f 6e20 756e 6465 7220 636f 7079 7269 ion under copyri │ │ │ │ │ +00015440: 6768 7420 6c61 772e 0a0a 2020 2020 2041 ght law... A │ │ │ │ │ +00015450: 2022 4d6f 6469 6669 6564 2056 6572 7369 "Modified Versi │ │ │ │ │ +00015460: 6f6e 2220 6f66 2074 6865 2044 6f63 756d on" of the Docum │ │ │ │ │ +00015470: 656e 7420 6d65 616e 7320 616e 7920 776f ent means any wo │ │ │ │ │ +00015480: 726b 2063 6f6e 7461 696e 696e 6720 7468 rk containing th │ │ │ │ │ +00015490: 650a 2020 2020 2044 6f63 756d 656e 7420 e. Document │ │ │ │ │ +000154a0: 6f72 2061 2070 6f72 7469 6f6e 206f 6620 or a portion of │ │ │ │ │ +000154b0: 6974 2c20 6569 7468 6572 2063 6f70 6965 it, either copie │ │ │ │ │ +000154c0: 6420 7665 7262 6174 696d 2c20 6f72 2077 d verbatim, or w │ │ │ │ │ +000154d0: 6974 680a 2020 2020 206d 6f64 6966 6963 ith. modific │ │ │ │ │ +000154e0: 6174 696f 6e73 2061 6e64 2f6f 7220 7472 ations and/or tr │ │ │ │ │ +000154f0: 616e 736c 6174 6564 2069 6e74 6f20 616e anslated into an │ │ │ │ │ +00015500: 6f74 6865 7220 6c61 6e67 7561 6765 2e0a other language.. │ │ │ │ │ +00015510: 0a20 2020 2020 4120 2253 6563 6f6e 6461 . A "Seconda │ │ │ │ │ +00015520: 7279 2053 6563 7469 6f6e 2220 6973 2061 ry Section" is a │ │ │ │ │ +00015530: 206e 616d 6564 2061 7070 656e 6469 7820 named appendix │ │ │ │ │ +00015540: 6f72 2061 2066 726f 6e74 2d6d 6174 7465 or a front-matte │ │ │ │ │ +00015550: 7220 7365 6374 696f 6e0a 2020 2020 206f r section. o │ │ │ │ │ +00015560: 6620 7468 6520 446f 6375 6d65 6e74 2074 f the Document t │ │ │ │ │ +00015570: 6861 7420 6465 616c 7320 6578 636c 7573 hat deals exclus │ │ │ │ │ +00015580: 6976 656c 7920 7769 7468 2074 6865 2072 ively with the r │ │ │ │ │ +00015590: 656c 6174 696f 6e73 6869 7020 6f66 2074 elationship of t │ │ │ │ │ +000155a0: 6865 0a20 2020 2020 7075 626c 6973 6865 he. publishe │ │ │ │ │ +000155b0: 7273 206f 7220 6175 7468 6f72 7320 6f66 rs or authors of │ │ │ │ │ +000155c0: 2074 6865 2044 6f63 756d 656e 7420 746f the Document to │ │ │ │ │ +000155d0: 2074 6865 2044 6f63 756d 656e 7427 7320 the Document's │ │ │ │ │ +000155e0: 6f76 6572 616c 6c0a 2020 2020 2073 7562 overall. sub │ │ │ │ │ +000155f0: 6a65 6374 2028 6f72 2074 6f20 7265 6c61 ject (or to rela │ │ │ │ │ +00015600: 7465 6420 6d61 7474 6572 7329 2061 6e64 ted matters) and │ │ │ │ │ +00015610: 2063 6f6e 7461 696e 7320 6e6f 7468 696e contains nothin │ │ │ │ │ +00015620: 6720 7468 6174 2063 6f75 6c64 0a20 2020 g that could. │ │ │ │ │ +00015630: 2020 6661 6c6c 2064 6972 6563 746c 7920 fall directly │ │ │ │ │ +00015640: 7769 7468 696e 2074 6861 7420 6f76 6572 within that over │ │ │ │ │ +00015650: 616c 6c20 7375 626a 6563 742e 2020 2854 all subject. (T │ │ │ │ │ +00015660: 6875 732c 2069 6620 7468 6520 446f 6375 hus, if the Docu │ │ │ │ │ +00015670: 6d65 6e74 0a20 2020 2020 6973 2069 6e20 ment. is in │ │ │ │ │ +00015680: 7061 7274 2061 2074 6578 7462 6f6f 6b20 part a textbook │ │ │ │ │ +00015690: 6f66 206d 6174 6865 6d61 7469 6373 2c20 of mathematics, │ │ │ │ │ +000156a0: 6120 5365 636f 6e64 6172 7920 5365 6374 a Secondary Sect │ │ │ │ │ +000156b0: 696f 6e20 6d61 7920 6e6f 740a 2020 2020 ion may not. │ │ │ │ │ +000156c0: 2065 7870 6c61 696e 2061 6e79 206d 6174 explain any mat │ │ │ │ │ +000156d0: 6865 6d61 7469 6373 2e29 2020 5468 6520 hematics.) The │ │ │ │ │ +000156e0: 7265 6c61 7469 6f6e 7368 6970 2063 6f75 relationship cou │ │ │ │ │ +000156f0: 6c64 2062 6520 6120 6d61 7474 6572 206f ld be a matter o │ │ │ │ │ +00015700: 660a 2020 2020 2068 6973 746f 7269 6361 f. historica │ │ │ │ │ +00015710: 6c20 636f 6e6e 6563 7469 6f6e 2077 6974 l connection wit │ │ │ │ │ +00015720: 6820 7468 6520 7375 626a 6563 7420 6f72 h the subject or │ │ │ │ │ +00015730: 2077 6974 6820 7265 6c61 7465 6420 6d61 with related ma │ │ │ │ │ +00015740: 7474 6572 732c 206f 720a 2020 2020 206f tters, or. o │ │ │ │ │ +00015750: 6620 6c65 6761 6c2c 2063 6f6d 6d65 7263 f legal, commerc │ │ │ │ │ +00015760: 6961 6c2c 2070 6869 6c6f 736f 7068 6963 ial, philosophic │ │ │ │ │ +00015770: 616c 2c20 6574 6869 6361 6c20 6f72 2070 al, ethical or p │ │ │ │ │ +00015780: 6f6c 6974 6963 616c 2070 6f73 6974 696f olitical positio │ │ │ │ │ +00015790: 6e0a 2020 2020 2072 6567 6172 6469 6e67 n. regarding │ │ │ │ │ +000157a0: 2074 6865 6d2e 0a0a 2020 2020 2054 6865 them... The │ │ │ │ │ +000157b0: 2022 496e 7661 7269 616e 7420 5365 6374 "Invariant Sect │ │ │ │ │ +000157c0: 696f 6e73 2220 6172 6520 6365 7274 6169 ions" are certai │ │ │ │ │ +000157d0: 6e20 5365 636f 6e64 6172 7920 5365 6374 n Secondary Sect │ │ │ │ │ +000157e0: 696f 6e73 2077 686f 7365 0a20 2020 2020 ions whose. │ │ │ │ │ +000157f0: 7469 746c 6573 2061 7265 2064 6573 6967 titles are desig │ │ │ │ │ +00015800: 6e61 7465 642c 2061 7320 6265 696e 6720 nated, as being │ │ │ │ │ +00015810: 7468 6f73 6520 6f66 2049 6e76 6172 6961 those of Invaria │ │ │ │ │ +00015820: 6e74 2053 6563 7469 6f6e 732c 2069 6e20 nt Sections, in │ │ │ │ │ +00015830: 7468 650a 2020 2020 206e 6f74 6963 6520 the. notice │ │ │ │ │ +00015840: 7468 6174 2073 6179 7320 7468 6174 2074 that says that t │ │ │ │ │ +00015850: 6865 2044 6f63 756d 656e 7420 6973 2072 he Document is r │ │ │ │ │ +00015860: 656c 6561 7365 6420 756e 6465 7220 7468 eleased under th │ │ │ │ │ +00015870: 6973 204c 6963 656e 7365 2e0a 2020 2020 is License.. │ │ │ │ │ +00015880: 2049 6620 6120 7365 6374 696f 6e20 646f If a section do │ │ │ │ │ +00015890: 6573 206e 6f74 2066 6974 2074 6865 2061 es not fit the a │ │ │ │ │ +000158a0: 626f 7665 2064 6566 696e 6974 696f 6e20 bove definition │ │ │ │ │ +000158b0: 6f66 2053 6563 6f6e 6461 7279 2074 6865 of Secondary the │ │ │ │ │ +000158c0: 6e20 6974 0a20 2020 2020 6973 206e 6f74 n it. is not │ │ │ │ │ +000158d0: 2061 6c6c 6f77 6564 2074 6f20 6265 2064 allowed to be d │ │ │ │ │ +000158e0: 6573 6967 6e61 7465 6420 6173 2049 6e76 esignated as Inv │ │ │ │ │ +000158f0: 6172 6961 6e74 2e20 2054 6865 2044 6f63 ariant. The Doc │ │ │ │ │ +00015900: 756d 656e 7420 6d61 790a 2020 2020 2063 ument may. c │ │ │ │ │ +00015910: 6f6e 7461 696e 207a 6572 6f20 496e 7661 ontain zero Inva │ │ │ │ │ +00015920: 7269 616e 7420 5365 6374 696f 6e73 2e20 riant Sections. │ │ │ │ │ +00015930: 2049 6620 7468 6520 446f 6375 6d65 6e74 If the Document │ │ │ │ │ +00015940: 2064 6f65 7320 6e6f 7420 6964 656e 7469 does not identi │ │ │ │ │ +00015950: 6679 0a20 2020 2020 616e 7920 496e 7661 fy. any Inva │ │ │ │ │ +00015960: 7269 616e 7420 5365 6374 696f 6e73 2074 riant Sections t │ │ │ │ │ +00015970: 6865 6e20 7468 6572 6520 6172 6520 6e6f hen there are no │ │ │ │ │ +00015980: 6e65 2e0a 0a20 2020 2020 5468 6520 2243 ne... The "C │ │ │ │ │ +00015990: 6f76 6572 2054 6578 7473 2220 6172 6520 over Texts" are │ │ │ │ │ +000159a0: 6365 7274 6169 6e20 7368 6f72 7420 7061 certain short pa │ │ │ │ │ +000159b0: 7373 6167 6573 206f 6620 7465 7874 2074 ssages of text t │ │ │ │ │ +000159c0: 6861 7420 6172 650a 2020 2020 206c 6973 hat are. lis │ │ │ │ │ +000159d0: 7465 642c 2061 7320 4672 6f6e 742d 436f ted, as Front-Co │ │ │ │ │ +000159e0: 7665 7220 5465 7874 7320 6f72 2042 6163 ver Texts or Bac │ │ │ │ │ +000159f0: 6b2d 436f 7665 7220 5465 7874 732c 2069 k-Cover Texts, i │ │ │ │ │ +00015a00: 6e20 7468 6520 6e6f 7469 6365 0a20 2020 n the notice. │ │ │ │ │ +00015a10: 2020 7468 6174 2073 6179 7320 7468 6174 that says that │ │ │ │ │ +00015a20: 2074 6865 2044 6f63 756d 656e 7420 6973 the Document is │ │ │ │ │ +00015a30: 2072 656c 6561 7365 6420 756e 6465 7220 released under │ │ │ │ │ +00015a40: 7468 6973 204c 6963 656e 7365 2e20 2041 this License. A │ │ │ │ │ +00015a50: 0a20 2020 2020 4672 6f6e 742d 436f 7665 . Front-Cove │ │ │ │ │ +00015a60: 7220 5465 7874 206d 6179 2062 6520 6174 r Text may be at │ │ │ │ │ +00015a70: 206d 6f73 7420 3520 776f 7264 732c 2061 most 5 words, a │ │ │ │ │ +00015a80: 6e64 2061 2042 6163 6b2d 436f 7665 7220 nd a Back-Cover │ │ │ │ │ +00015a90: 5465 7874 206d 6179 0a20 2020 2020 6265 Text may. be │ │ │ │ │ +00015aa0: 2061 7420 6d6f 7374 2032 3520 776f 7264 at most 25 word │ │ │ │ │ +00015ab0: 732e 0a0a 2020 2020 2041 2022 5472 616e s... A "Tran │ │ │ │ │ +00015ac0: 7370 6172 656e 7422 2063 6f70 7920 6f66 sparent" copy of │ │ │ │ │ +00015ad0: 2074 6865 2044 6f63 756d 656e 7420 6d65 the Document me │ │ │ │ │ +00015ae0: 616e 7320 6120 6d61 6368 696e 652d 7265 ans a machine-re │ │ │ │ │ +00015af0: 6164 6162 6c65 2063 6f70 792c 0a20 2020 adable copy,. │ │ │ │ │ +00015b00: 2020 7265 7072 6573 656e 7465 6420 696e represented in │ │ │ │ │ +00015b10: 2061 2066 6f72 6d61 7420 7768 6f73 6520 a format whose │ │ │ │ │ +00015b20: 7370 6563 6966 6963 6174 696f 6e20 6973 specification is │ │ │ │ │ +00015b30: 2061 7661 696c 6162 6c65 2074 6f20 7468 available to th │ │ │ │ │ +00015b40: 650a 2020 2020 2067 656e 6572 616c 2070 e. general p │ │ │ │ │ +00015b50: 7562 6c69 632c 2074 6861 7420 6973 2073 ublic, that is s │ │ │ │ │ +00015b60: 7569 7461 626c 6520 666f 7220 7265 7669 uitable for revi │ │ │ │ │ +00015b70: 7369 6e67 2074 6865 2064 6f63 756d 656e sing the documen │ │ │ │ │ +00015b80: 740a 2020 2020 2073 7472 6169 6768 7466 t. straightf │ │ │ │ │ +00015b90: 6f72 7761 7264 6c79 2077 6974 6820 6765 orwardly with ge │ │ │ │ │ +00015ba0: 6e65 7269 6320 7465 7874 2065 6469 746f neric text edito │ │ │ │ │ +00015bb0: 7273 206f 7220 2866 6f72 2069 6d61 6765 rs or (for image │ │ │ │ │ +00015bc0: 7320 636f 6d70 6f73 6564 0a20 2020 2020 s composed. │ │ │ │ │ +00015bd0: 6f66 2070 6978 656c 7329 2067 656e 6572 of pixels) gener │ │ │ │ │ +00015be0: 6963 2070 6169 6e74 2070 726f 6772 616d ic paint program │ │ │ │ │ +00015bf0: 7320 6f72 2028 666f 7220 6472 6177 696e s or (for drawin │ │ │ │ │ +00015c00: 6773 2920 736f 6d65 2077 6964 656c 790a gs) some widely. │ │ │ │ │ +00015c10: 2020 2020 2061 7661 696c 6162 6c65 2064 available d │ │ │ │ │ +00015c20: 7261 7769 6e67 2065 6469 746f 722c 2061 rawing editor, a │ │ │ │ │ +00015c30: 6e64 2074 6861 7420 6973 2073 7569 7461 nd that is suita │ │ │ │ │ +00015c40: 626c 6520 666f 7220 696e 7075 7420 746f ble for input to │ │ │ │ │ +00015c50: 2074 6578 740a 2020 2020 2066 6f72 6d61 text. forma │ │ │ │ │ +00015c60: 7474 6572 7320 6f72 2066 6f72 2061 7574 tters or for aut │ │ │ │ │ +00015c70: 6f6d 6174 6963 2074 7261 6e73 6c61 7469 omatic translati │ │ │ │ │ +00015c80: 6f6e 2074 6f20 6120 7661 7269 6574 7920 on to a variety │ │ │ │ │ +00015c90: 6f66 2066 6f72 6d61 7473 0a20 2020 2020 of formats. │ │ │ │ │ +00015ca0: 7375 6974 6162 6c65 2066 6f72 2069 6e70 suitable for inp │ │ │ │ │ +00015cb0: 7574 2074 6f20 7465 7874 2066 6f72 6d61 ut to text forma │ │ │ │ │ +00015cc0: 7474 6572 732e 2020 4120 636f 7079 206d tters. A copy m │ │ │ │ │ +00015cd0: 6164 6520 696e 2061 6e20 6f74 6865 7277 ade in an otherw │ │ │ │ │ +00015ce0: 6973 650a 2020 2020 2054 7261 6e73 7061 ise. Transpa │ │ │ │ │ +00015cf0: 7265 6e74 2066 696c 6520 666f 726d 6174 rent file format │ │ │ │ │ +00015d00: 2077 686f 7365 206d 6172 6b75 702c 206f whose markup, o │ │ │ │ │ +00015d10: 7220 6162 7365 6e63 6520 6f66 206d 6172 r absence of mar │ │ │ │ │ +00015d20: 6b75 702c 2068 6173 0a20 2020 2020 6265 kup, has. be │ │ │ │ │ +00015d30: 656e 2061 7272 616e 6765 6420 746f 2074 en arranged to t │ │ │ │ │ +00015d40: 6877 6172 7420 6f72 2064 6973 636f 7572 hwart or discour │ │ │ │ │ +00015d50: 6167 6520 7375 6273 6571 7565 6e74 206d age subsequent m │ │ │ │ │ +00015d60: 6f64 6966 6963 6174 696f 6e20 6279 0a20 odification by. │ │ │ │ │ +00015d70: 2020 2020 7265 6164 6572 7320 6973 206e readers is n │ │ │ │ │ +00015d80: 6f74 2054 7261 6e73 7061 7265 6e74 2e20 ot Transparent. │ │ │ │ │ +00015d90: 2041 6e20 696d 6167 6520 666f 726d 6174 An image format │ │ │ │ │ +00015da0: 2069 7320 6e6f 7420 5472 616e 7370 6172 is not Transpar │ │ │ │ │ +00015db0: 656e 7420 6966 0a20 2020 2020 7573 6564 ent if. used │ │ │ │ │ +00015dc0: 2066 6f72 2061 6e79 2073 7562 7374 616e for any substan │ │ │ │ │ +00015dd0: 7469 616c 2061 6d6f 756e 7420 6f66 2074 tial amount of t │ │ │ │ │ +00015de0: 6578 742e 2020 4120 636f 7079 2074 6861 ext. A copy tha │ │ │ │ │ +00015df0: 7420 6973 206e 6f74 0a20 2020 2020 2254 t is not. "T │ │ │ │ │ +00015e00: 7261 6e73 7061 7265 6e74 2220 6973 2063 ransparent" is c │ │ │ │ │ +00015e10: 616c 6c65 6420 224f 7061 7175 6522 2e0a alled "Opaque".. │ │ │ │ │ +00015e20: 0a20 2020 2020 4578 616d 706c 6573 206f . Examples o │ │ │ │ │ +00015e30: 6620 7375 6974 6162 6c65 2066 6f72 6d61 f suitable forma │ │ │ │ │ +00015e40: 7473 2066 6f72 2054 7261 6e73 7061 7265 ts for Transpare │ │ │ │ │ +00015e50: 6e74 2063 6f70 6965 7320 696e 636c 7564 nt copies includ │ │ │ │ │ +00015e60: 6520 706c 6169 6e0a 2020 2020 2041 5343 e plain. ASC │ │ │ │ │ +00015e70: 4949 2077 6974 686f 7574 206d 6172 6b75 II without marku │ │ │ │ │ +00015e80: 702c 2054 6578 696e 666f 2069 6e70 7574 p, Texinfo input │ │ │ │ │ +00015e90: 2066 6f72 6d61 742c 204c 6154 6558 2069 format, LaTeX i │ │ │ │ │ +00015ea0: 6e70 7574 2066 6f72 6d61 742c 0a20 2020 nput format,. │ │ │ │ │ +00015eb0: 2020 5347 4d4c 206f 7220 584d 4c20 7573 SGML or XML us │ │ │ │ │ +00015ec0: 696e 6720 6120 7075 626c 6963 6c79 2061 ing a publicly a │ │ │ │ │ +00015ed0: 7661 696c 6162 6c65 2044 5444 2c20 616e vailable DTD, an │ │ │ │ │ +00015ee0: 6420 7374 616e 6461 7264 2d63 6f6e 666f d standard-confo │ │ │ │ │ +00015ef0: 726d 696e 670a 2020 2020 2073 696d 706c rming. simpl │ │ │ │ │ +00015f00: 6520 4854 4d4c 2c20 506f 7374 5363 7269 e HTML, PostScri │ │ │ │ │ +00015f10: 7074 206f 7220 5044 4620 6465 7369 676e pt or PDF design │ │ │ │ │ +00015f20: 6564 2066 6f72 2068 756d 616e 206d 6f64 ed for human mod │ │ │ │ │ +00015f30: 6966 6963 6174 696f 6e2e 0a20 2020 2020 ification.. │ │ │ │ │ +00015f40: 4578 616d 706c 6573 206f 6620 7472 616e Examples of tran │ │ │ │ │ +00015f50: 7370 6172 656e 7420 696d 6167 6520 666f sparent image fo │ │ │ │ │ +00015f60: 726d 6174 7320 696e 636c 7564 6520 504e rmats include PN │ │ │ │ │ +00015f70: 472c 2058 4346 2061 6e64 204a 5047 2e0a G, XCF and JPG.. │ │ │ │ │ +00015f80: 2020 2020 204f 7061 7175 6520 666f 726d Opaque form │ │ │ │ │ +00015f90: 6174 7320 696e 636c 7564 6520 7072 6f70 ats include prop │ │ │ │ │ +00015fa0: 7269 6574 6172 7920 666f 726d 6174 7320 rietary formats │ │ │ │ │ +00015fb0: 7468 6174 2063 616e 2062 6520 7265 6164 that can be read │ │ │ │ │ +00015fc0: 2061 6e64 0a20 2020 2020 6564 6974 6564 and. edited │ │ │ │ │ +00015fd0: 206f 6e6c 7920 6279 2070 726f 7072 6965 only by proprie │ │ │ │ │ +00015fe0: 7461 7279 2077 6f72 6420 7072 6f63 6573 tary word proces │ │ │ │ │ +00015ff0: 736f 7273 2c20 5347 4d4c 206f 7220 584d sors, SGML or XM │ │ │ │ │ +00016000: 4c20 666f 7220 7768 6963 680a 2020 2020 L for which. │ │ │ │ │ +00016010: 2074 6865 2044 5444 2061 6e64 2f6f 7220 the DTD and/or │ │ │ │ │ +00016020: 7072 6f63 6573 7369 6e67 2074 6f6f 6c73 processing tools │ │ │ │ │ +00016030: 2061 7265 206e 6f74 2067 656e 6572 616c are not general │ │ │ │ │ +00016040: 6c79 2061 7661 696c 6162 6c65 2c20 616e ly available, an │ │ │ │ │ +00016050: 640a 2020 2020 2074 6865 206d 6163 6869 d. the machi │ │ │ │ │ +00016060: 6e65 2d67 656e 6572 6174 6564 2048 544d ne-generated HTM │ │ │ │ │ +00016070: 4c2c 2050 6f73 7453 6372 6970 7420 6f72 L, PostScript or │ │ │ │ │ +00016080: 2050 4446 2070 726f 6475 6365 6420 6279 PDF produced by │ │ │ │ │ +00016090: 2073 6f6d 6520 776f 7264 0a20 2020 2020 some word. │ │ │ │ │ +000160a0: 7072 6f63 6573 736f 7273 2066 6f72 206f processors for o │ │ │ │ │ +000160b0: 7574 7075 7420 7075 7270 6f73 6573 206f utput purposes o │ │ │ │ │ +000160c0: 6e6c 792e 0a0a 2020 2020 2054 6865 2022 nly... The " │ │ │ │ │ +000160d0: 5469 746c 6520 5061 6765 2220 6d65 616e Title Page" mean │ │ │ │ │ +000160e0: 732c 2066 6f72 2061 2070 7269 6e74 6564 s, for a printed │ │ │ │ │ +000160f0: 2062 6f6f 6b2c 2074 6865 2074 6974 6c65 book, the title │ │ │ │ │ +00016100: 2070 6167 6520 6974 7365 6c66 2c0a 2020 page itself,. │ │ │ │ │ +00016110: 2020 2070 6c75 7320 7375 6368 2066 6f6c plus such fol │ │ │ │ │ +00016120: 6c6f 7769 6e67 2070 6167 6573 2061 7320 lowing pages as │ │ │ │ │ +00016130: 6172 6520 6e65 6564 6564 2074 6f20 686f are needed to ho │ │ │ │ │ +00016140: 6c64 2c20 6c65 6769 626c 792c 2074 6865 ld, legibly, the │ │ │ │ │ +00016150: 0a20 2020 2020 6d61 7465 7269 616c 2074 . material t │ │ │ │ │ +00016160: 6869 7320 4c69 6365 6e73 6520 7265 7175 his License requ │ │ │ │ │ +00016170: 6972 6573 2074 6f20 6170 7065 6172 2069 ires to appear i │ │ │ │ │ +00016180: 6e20 7468 6520 7469 746c 6520 7061 6765 n the title page │ │ │ │ │ +00016190: 2e20 2046 6f72 0a20 2020 2020 776f 726b . For. work │ │ │ │ │ +000161a0: 7320 696e 2066 6f72 6d61 7473 2077 6869 s in formats whi │ │ │ │ │ +000161b0: 6368 2064 6f20 6e6f 7420 6861 7665 2061 ch do not have a │ │ │ │ │ +000161c0: 6e79 2074 6974 6c65 2070 6167 6520 6173 ny title page as │ │ │ │ │ +000161d0: 2073 7563 682c 2022 5469 746c 650a 2020 such, "Title. │ │ │ │ │ +000161e0: 2020 2050 6167 6522 206d 6561 6e73 2074 Page" means t │ │ │ │ │ +000161f0: 6865 2074 6578 7420 6e65 6172 2074 6865 he text near the │ │ │ │ │ +00016200: 206d 6f73 7420 7072 6f6d 696e 656e 7420 most prominent │ │ │ │ │ +00016210: 6170 7065 6172 616e 6365 206f 6620 7468 appearance of th │ │ │ │ │ +00016220: 650a 2020 2020 2077 6f72 6b27 7320 7469 e. work's ti │ │ │ │ │ +00016230: 746c 652c 2070 7265 6365 6469 6e67 2074 tle, preceding t │ │ │ │ │ +00016240: 6865 2062 6567 696e 6e69 6e67 206f 6620 he beginning of │ │ │ │ │ +00016250: 7468 6520 626f 6479 206f 6620 7468 6520 the body of the │ │ │ │ │ +00016260: 7465 7874 2e0a 0a20 2020 2020 4120 7365 text... A se │ │ │ │ │ +00016270: 6374 696f 6e20 2245 6e74 6974 6c65 6420 ction "Entitled │ │ │ │ │ +00016280: 5859 5a22 206d 6561 6e73 2061 206e 616d XYZ" means a nam │ │ │ │ │ +00016290: 6564 2073 7562 756e 6974 206f 6620 7468 ed subunit of th │ │ │ │ │ +000162a0: 6520 446f 6375 6d65 6e74 0a20 2020 2020 e Document. │ │ │ │ │ +000162b0: 7768 6f73 6520 7469 746c 6520 6569 7468 whose title eith │ │ │ │ │ +000162c0: 6572 2069 7320 7072 6563 6973 656c 7920 er is precisely │ │ │ │ │ +000162d0: 5859 5a20 6f72 2063 6f6e 7461 696e 7320 XYZ or contains │ │ │ │ │ +000162e0: 5859 5a20 696e 2070 6172 656e 7468 6573 XYZ in parenthes │ │ │ │ │ +000162f0: 6573 0a20 2020 2020 666f 6c6c 6f77 696e es. followin │ │ │ │ │ +00016300: 6720 7465 7874 2074 6861 7420 7472 616e g text that tran │ │ │ │ │ +00016310: 736c 6174 6573 2058 595a 2069 6e20 616e slates XYZ in an │ │ │ │ │ +00016320: 6f74 6865 7220 6c61 6e67 7561 6765 2e20 other language. │ │ │ │ │ +00016330: 2028 4865 7265 2058 595a 0a20 2020 2020 (Here XYZ. │ │ │ │ │ +00016340: 7374 616e 6473 2066 6f72 2061 2073 7065 stands for a spe │ │ │ │ │ +00016350: 6369 6669 6320 7365 6374 696f 6e20 6e61 cific section na │ │ │ │ │ +00016360: 6d65 206d 656e 7469 6f6e 6564 2062 656c me mentioned bel │ │ │ │ │ +00016370: 6f77 2c20 7375 6368 2061 730a 2020 2020 ow, such as. │ │ │ │ │ +00016380: 2022 4163 6b6e 6f77 6c65 6467 656d 656e "Acknowledgemen │ │ │ │ │ +00016390: 7473 222c 2022 4465 6469 6361 7469 6f6e ts", "Dedication │ │ │ │ │ +000163a0: 7322 2c20 2245 6e64 6f72 7365 6d65 6e74 s", "Endorsement │ │ │ │ │ +000163b0: 7322 2c20 6f72 2022 4869 7374 6f72 7922 s", or "History" │ │ │ │ │ +000163c0: 2e29 0a20 2020 2020 546f 2022 5072 6573 .). To "Pres │ │ │ │ │ +000163d0: 6572 7665 2074 6865 2054 6974 6c65 2220 erve the Title" │ │ │ │ │ +000163e0: 6f66 2073 7563 6820 6120 7365 6374 696f of such a sectio │ │ │ │ │ +000163f0: 6e20 7768 656e 2079 6f75 206d 6f64 6966 n when you modif │ │ │ │ │ +00016400: 7920 7468 650a 2020 2020 2044 6f63 756d y the. Docum │ │ │ │ │ +00016410: 656e 7420 6d65 616e 7320 7468 6174 2069 ent means that i │ │ │ │ │ +00016420: 7420 7265 6d61 696e 7320 6120 7365 6374 t remains a sect │ │ │ │ │ +00016430: 696f 6e20 2245 6e74 6974 6c65 6420 5859 ion "Entitled XY │ │ │ │ │ +00016440: 5a22 2061 6363 6f72 6469 6e67 0a20 2020 Z" according. │ │ │ │ │ +00016450: 2020 746f 2074 6869 7320 6465 6669 6e69 to this defini │ │ │ │ │ +00016460: 7469 6f6e 2e0a 0a20 2020 2020 5468 6520 tion... The │ │ │ │ │ +00016470: 446f 6375 6d65 6e74 206d 6179 2069 6e63 Document may inc │ │ │ │ │ +00016480: 6c75 6465 2057 6172 7261 6e74 7920 4469 lude Warranty Di │ │ │ │ │ +00016490: 7363 6c61 696d 6572 7320 6e65 7874 2074 sclaimers next t │ │ │ │ │ +000164a0: 6f20 7468 6520 6e6f 7469 6365 0a20 2020 o the notice. │ │ │ │ │ +000164b0: 2020 7768 6963 6820 7374 6174 6573 2074 which states t │ │ │ │ │ +000164c0: 6861 7420 7468 6973 204c 6963 656e 7365 hat this License │ │ │ │ │ +000164d0: 2061 7070 6c69 6573 2074 6f20 7468 6520 applies to the │ │ │ │ │ +000164e0: 446f 6375 6d65 6e74 2e20 2054 6865 7365 Document. These │ │ │ │ │ +000164f0: 0a20 2020 2020 5761 7272 616e 7479 2044 . Warranty D │ │ │ │ │ +00016500: 6973 636c 6169 6d65 7273 2061 7265 2063 isclaimers are c │ │ │ │ │ +00016510: 6f6e 7369 6465 7265 6420 746f 2062 6520 onsidered to be │ │ │ │ │ +00016520: 696e 636c 7564 6564 2062 7920 7265 6665 included by refe │ │ │ │ │ +00016530: 7265 6e63 6520 696e 0a20 2020 2020 7468 rence in. th │ │ │ │ │ +00016540: 6973 204c 6963 656e 7365 2c20 6275 7420 is License, but │ │ │ │ │ +00016550: 6f6e 6c79 2061 7320 7265 6761 7264 7320 only as regards │ │ │ │ │ +00016560: 6469 7363 6c61 696d 696e 6720 7761 7272 disclaiming warr │ │ │ │ │ +00016570: 616e 7469 6573 3a20 616e 7920 6f74 6865 anties: any othe │ │ │ │ │ +00016580: 720a 2020 2020 2069 6d70 6c69 6361 7469 r. implicati │ │ │ │ │ +00016590: 6f6e 2074 6861 7420 7468 6573 6520 5761 on that these Wa │ │ │ │ │ +000165a0: 7272 616e 7479 2044 6973 636c 6169 6d65 rranty Disclaime │ │ │ │ │ +000165b0: 7273 206d 6179 2068 6176 6520 6973 2076 rs may have is v │ │ │ │ │ +000165c0: 6f69 6420 616e 640a 2020 2020 2068 6173 oid and. has │ │ │ │ │ +000165d0: 206e 6f20 6566 6665 6374 206f 6e20 7468 no effect on th │ │ │ │ │ +000165e0: 6520 6d65 616e 696e 6720 6f66 2074 6869 e meaning of thi │ │ │ │ │ +000165f0: 7320 4c69 6365 6e73 652e 0a0a 2020 322e s License... 2. │ │ │ │ │ +00016600: 2056 4552 4241 5449 4d20 434f 5059 494e VERBATIM COPYIN │ │ │ │ │ +00016610: 470a 0a20 2020 2020 596f 7520 6d61 7920 G.. You may │ │ │ │ │ +00016620: 636f 7079 2061 6e64 2064 6973 7472 6962 copy and distrib │ │ │ │ │ +00016630: 7574 6520 7468 6520 446f 6375 6d65 6e74 ute the Document │ │ │ │ │ +00016640: 2069 6e20 616e 7920 6d65 6469 756d 2c20 in any medium, │ │ │ │ │ +00016650: 6569 7468 6572 0a20 2020 2020 636f 6d6d either. comm │ │ │ │ │ +00016660: 6572 6369 616c 6c79 206f 7220 6e6f 6e63 ercially or nonc │ │ │ │ │ +00016670: 6f6d 6d65 7263 6961 6c6c 792c 2070 726f ommercially, pro │ │ │ │ │ +00016680: 7669 6465 6420 7468 6174 2074 6869 7320 vided that this │ │ │ │ │ +00016690: 4c69 6365 6e73 652c 2074 6865 0a20 2020 License, the. │ │ │ │ │ +000166a0: 2020 636f 7079 7269 6768 7420 6e6f 7469 copyright noti │ │ │ │ │ +000166b0: 6365 732c 2061 6e64 2074 6865 206c 6963 ces, and the lic │ │ │ │ │ +000166c0: 656e 7365 206e 6f74 6963 6520 7361 7969 ense notice sayi │ │ │ │ │ +000166d0: 6e67 2074 6869 7320 4c69 6365 6e73 650a ng this License. │ │ │ │ │ +000166e0: 2020 2020 2061 7070 6c69 6573 2074 6f20 applies to │ │ │ │ │ +000166f0: 7468 6520 446f 6375 6d65 6e74 2061 7265 the Document are │ │ │ │ │ +00016700: 2072 6570 726f 6475 6365 6420 696e 2061 reproduced in a │ │ │ │ │ +00016710: 6c6c 2063 6f70 6965 732c 2061 6e64 2074 ll copies, and t │ │ │ │ │ +00016720: 6861 7420 796f 750a 2020 2020 2061 6464 hat you. add │ │ │ │ │ +00016730: 206e 6f20 6f74 6865 7220 636f 6e64 6974 no other condit │ │ │ │ │ +00016740: 696f 6e73 2077 6861 7473 6f65 7665 7220 ions whatsoever │ │ │ │ │ +00016750: 746f 2074 686f 7365 206f 6620 7468 6973 to those of this │ │ │ │ │ +00016760: 204c 6963 656e 7365 2e20 2059 6f75 0a20 License. You. │ │ │ │ │ +00016770: 2020 2020 6d61 7920 6e6f 7420 7573 6520 may not use │ │ │ │ │ +00016780: 7465 6368 6e69 6361 6c20 6d65 6173 7572 technical measur │ │ │ │ │ +00016790: 6573 2074 6f20 6f62 7374 7275 6374 206f es to obstruct o │ │ │ │ │ +000167a0: 7220 636f 6e74 726f 6c20 7468 6520 7265 r control the re │ │ │ │ │ +000167b0: 6164 696e 670a 2020 2020 206f 7220 6675 ading. or fu │ │ │ │ │ +000167c0: 7274 6865 7220 636f 7079 696e 6720 6f66 rther copying of │ │ │ │ │ +000167d0: 2074 6865 2063 6f70 6965 7320 796f 7520 the copies you │ │ │ │ │ +000167e0: 6d61 6b65 206f 7220 6469 7374 7269 6275 make or distribu │ │ │ │ │ +000167f0: 7465 2e20 2048 6f77 6576 6572 2c0a 2020 te. However,. │ │ │ │ │ +00016800: 2020 2079 6f75 206d 6179 2061 6363 6570 you may accep │ │ │ │ │ +00016810: 7420 636f 6d70 656e 7361 7469 6f6e 2069 t compensation i │ │ │ │ │ +00016820: 6e20 6578 6368 616e 6765 2066 6f72 2063 n exchange for c │ │ │ │ │ +00016830: 6f70 6965 732e 2020 4966 2079 6f75 0a20 opies. If you. │ │ │ │ │ +00016840: 2020 2020 6469 7374 7269 6275 7465 2061 distribute a │ │ │ │ │ +00016850: 206c 6172 6765 2065 6e6f 7567 6820 6e75 large enough nu │ │ │ │ │ +00016860: 6d62 6572 206f 6620 636f 7069 6573 2079 mber of copies y │ │ │ │ │ +00016870: 6f75 206d 7573 7420 616c 736f 2066 6f6c ou must also fol │ │ │ │ │ +00016880: 6c6f 7720 7468 650a 2020 2020 2063 6f6e low the. con │ │ │ │ │ +00016890: 6469 7469 6f6e 7320 696e 2073 6563 7469 ditions in secti │ │ │ │ │ +000168a0: 6f6e 2033 2e0a 0a20 2020 2020 596f 7520 on 3... You │ │ │ │ │ +000168b0: 6d61 7920 616c 736f 206c 656e 6420 636f may also lend co │ │ │ │ │ +000168c0: 7069 6573 2c20 756e 6465 7220 7468 6520 pies, under the │ │ │ │ │ +000168d0: 7361 6d65 2063 6f6e 6469 7469 6f6e 7320 same conditions │ │ │ │ │ +000168e0: 7374 6174 6564 2061 626f 7665 2c0a 2020 stated above,. │ │ │ │ │ +000168f0: 2020 2061 6e64 2079 6f75 206d 6179 2070 and you may p │ │ │ │ │ +00016900: 7562 6c69 636c 7920 6469 7370 6c61 7920 ublicly display │ │ │ │ │ +00016910: 636f 7069 6573 2e0a 0a20 2033 2e20 434f copies... 3. CO │ │ │ │ │ +00016920: 5059 494e 4720 494e 2051 5541 4e54 4954 PYING IN QUANTIT │ │ │ │ │ +00016930: 590a 0a20 2020 2020 4966 2079 6f75 2070 Y.. If you p │ │ │ │ │ +00016940: 7562 6c69 7368 2070 7269 6e74 6564 2063 ublish printed c │ │ │ │ │ +00016950: 6f70 6965 7320 286f 7220 636f 7069 6573 opies (or copies │ │ │ │ │ +00016960: 2069 6e20 6d65 6469 6120 7468 6174 2063 in media that c │ │ │ │ │ +00016970: 6f6d 6d6f 6e6c 790a 2020 2020 2068 6176 ommonly. hav │ │ │ │ │ +00016980: 6520 7072 696e 7465 6420 636f 7665 7273 e printed covers │ │ │ │ │ +00016990: 2920 6f66 2074 6865 2044 6f63 756d 656e ) of the Documen │ │ │ │ │ +000169a0: 742c 206e 756d 6265 7269 6e67 206d 6f72 t, numbering mor │ │ │ │ │ +000169b0: 6520 7468 616e 2031 3030 2c20 616e 640a e than 100, and. │ │ │ │ │ +000169c0: 2020 2020 2074 6865 2044 6f63 756d 656e the Documen │ │ │ │ │ +000169d0: 7427 7320 6c69 6365 6e73 6520 6e6f 7469 t's license noti │ │ │ │ │ +000169e0: 6365 2072 6571 7569 7265 7320 436f 7665 ce requires Cove │ │ │ │ │ +000169f0: 7220 5465 7874 732c 2079 6f75 206d 7573 r Texts, you mus │ │ │ │ │ +00016a00: 740a 2020 2020 2065 6e63 6c6f 7365 2074 t. enclose t │ │ │ │ │ +00016a10: 6865 2063 6f70 6965 7320 696e 2063 6f76 he copies in cov │ │ │ │ │ +00016a20: 6572 7320 7468 6174 2063 6172 7279 2c20 ers that carry, │ │ │ │ │ +00016a30: 636c 6561 726c 7920 616e 6420 6c65 6769 clearly and legi │ │ │ │ │ +00016a40: 626c 792c 2061 6c6c 0a20 2020 2020 7468 bly, all. th │ │ │ │ │ +00016a50: 6573 6520 436f 7665 7220 5465 7874 733a ese Cover Texts: │ │ │ │ │ +00016a60: 2046 726f 6e74 2d43 6f76 6572 2054 6578 Front-Cover Tex │ │ │ │ │ +00016a70: 7473 206f 6e20 7468 6520 6672 6f6e 7420 ts on the front │ │ │ │ │ +00016a80: 636f 7665 722c 2061 6e64 0a20 2020 2020 cover, and. │ │ │ │ │ +00016a90: 4261 636b 2d43 6f76 6572 2054 6578 7473 Back-Cover Texts │ │ │ │ │ +00016aa0: 206f 6e20 7468 6520 6261 636b 2063 6f76 on the back cov │ │ │ │ │ +00016ab0: 6572 2e20 2042 6f74 6820 636f 7665 7273 er. Both covers │ │ │ │ │ +00016ac0: 206d 7573 7420 616c 736f 2063 6c65 6172 must also clear │ │ │ │ │ +00016ad0: 6c79 0a20 2020 2020 616e 6420 6c65 6769 ly. and legi │ │ │ │ │ +00016ae0: 626c 7920 6964 656e 7469 6679 2079 6f75 bly identify you │ │ │ │ │ +00016af0: 2061 7320 7468 6520 7075 626c 6973 6865 as the publishe │ │ │ │ │ +00016b00: 7220 6f66 2074 6865 7365 2063 6f70 6965 r of these copie │ │ │ │ │ +00016b10: 732e 2020 5468 650a 2020 2020 2066 726f s. The. fro │ │ │ │ │ +00016b20: 6e74 2063 6f76 6572 206d 7573 7420 7072 nt cover must pr │ │ │ │ │ +00016b30: 6573 656e 7420 7468 6520 6675 6c6c 2074 esent the full t │ │ │ │ │ +00016b40: 6974 6c65 2077 6974 6820 616c 6c20 776f itle with all wo │ │ │ │ │ +00016b50: 7264 7320 6f66 2074 6865 2074 6974 6c65 rds of the title │ │ │ │ │ +00016b60: 0a20 2020 2020 6571 7561 6c6c 7920 7072 . equally pr │ │ │ │ │ +00016b70: 6f6d 696e 656e 7420 616e 6420 7669 7369 ominent and visi │ │ │ │ │ +00016b80: 626c 652e 2020 596f 7520 6d61 7920 6164 ble. You may ad │ │ │ │ │ +00016b90: 6420 6f74 6865 7220 6d61 7465 7269 616c d other material │ │ │ │ │ +00016ba0: 206f 6e20 7468 650a 2020 2020 2063 6f76 on the. cov │ │ │ │ │ +00016bb0: 6572 7320 696e 2061 6464 6974 696f 6e2e ers in addition. │ │ │ │ │ +00016bc0: 2020 436f 7079 696e 6720 7769 7468 2063 Copying with c │ │ │ │ │ +00016bd0: 6861 6e67 6573 206c 696d 6974 6564 2074 hanges limited t │ │ │ │ │ +00016be0: 6f20 7468 6520 636f 7665 7273 2c20 6173 o the covers, as │ │ │ │ │ +00016bf0: 0a20 2020 2020 6c6f 6e67 2061 7320 7468 . long as th │ │ │ │ │ +00016c00: 6579 2070 7265 7365 7276 6520 7468 6520 ey preserve the │ │ │ │ │ +00016c10: 7469 746c 6520 6f66 2074 6865 2044 6f63 title of the Doc │ │ │ │ │ +00016c20: 756d 656e 7420 616e 6420 7361 7469 7366 ument and satisf │ │ │ │ │ +00016c30: 7920 7468 6573 650a 2020 2020 2063 6f6e y these. con │ │ │ │ │ +00016c40: 6469 7469 6f6e 732c 2063 616e 2062 6520 ditions, can be │ │ │ │ │ +00016c50: 7472 6561 7465 6420 6173 2076 6572 6261 treated as verba │ │ │ │ │ +00016c60: 7469 6d20 636f 7079 696e 6720 696e 206f tim copying in o │ │ │ │ │ +00016c70: 7468 6572 2072 6573 7065 6374 732e 0a0a ther respects... │ │ │ │ │ +00016c80: 2020 2020 2049 6620 7468 6520 7265 7175 If the requ │ │ │ │ │ +00016c90: 6972 6564 2074 6578 7473 2066 6f72 2065 ired texts for e │ │ │ │ │ +00016ca0: 6974 6865 7220 636f 7665 7220 6172 6520 ither cover are │ │ │ │ │ +00016cb0: 746f 6f20 766f 6c75 6d69 6e6f 7573 2074 too voluminous t │ │ │ │ │ +00016cc0: 6f20 6669 740a 2020 2020 206c 6567 6962 o fit. legib │ │ │ │ │ +00016cd0: 6c79 2c20 796f 7520 7368 6f75 6c64 2070 ly, you should p │ │ │ │ │ +00016ce0: 7574 2074 6865 2066 6972 7374 206f 6e65 ut the first one │ │ │ │ │ +00016cf0: 7320 6c69 7374 6564 2028 6173 206d 616e s listed (as man │ │ │ │ │ +00016d00: 7920 6173 2066 6974 0a20 2020 2020 7265 y as fit. re │ │ │ │ │ +00016d10: 6173 6f6e 6162 6c79 2920 6f6e 2074 6865 asonably) on the │ │ │ │ │ +00016d20: 2061 6374 7561 6c20 636f 7665 722c 2061 actual cover, a │ │ │ │ │ +00016d30: 6e64 2063 6f6e 7469 6e75 6520 7468 6520 nd continue the │ │ │ │ │ +00016d40: 7265 7374 206f 6e74 6f0a 2020 2020 2061 rest onto. a │ │ │ │ │ +00016d50: 646a 6163 656e 7420 7061 6765 732e 0a0a djacent pages... │ │ │ │ │ +00016d60: 2020 2020 2049 6620 796f 7520 7075 626c If you publ │ │ │ │ │ +00016d70: 6973 6820 6f72 2064 6973 7472 6962 7574 ish or distribut │ │ │ │ │ +00016d80: 6520 4f70 6171 7565 2063 6f70 6965 7320 e Opaque copies │ │ │ │ │ +00016d90: 6f66 2074 6865 2044 6f63 756d 656e 740a of the Document. │ │ │ │ │ +00016da0: 2020 2020 206e 756d 6265 7269 6e67 206d numbering m │ │ │ │ │ +00016db0: 6f72 6520 7468 616e 2031 3030 2c20 796f ore than 100, yo │ │ │ │ │ +00016dc0: 7520 6d75 7374 2065 6974 6865 7220 696e u must either in │ │ │ │ │ +00016dd0: 636c 7564 6520 6120 6d61 6368 696e 652d clude a machine- │ │ │ │ │ +00016de0: 7265 6164 6162 6c65 0a20 2020 2020 5472 readable. Tr │ │ │ │ │ +00016df0: 616e 7370 6172 656e 7420 636f 7079 2061 ansparent copy a │ │ │ │ │ +00016e00: 6c6f 6e67 2077 6974 6820 6561 6368 204f long with each O │ │ │ │ │ +00016e10: 7061 7175 6520 636f 7079 2c20 6f72 2073 paque copy, or s │ │ │ │ │ +00016e20: 7461 7465 2069 6e20 6f72 2077 6974 680a tate in or with. │ │ │ │ │ +00016e30: 2020 2020 2065 6163 6820 4f70 6171 7565 each Opaque │ │ │ │ │ +00016e40: 2063 6f70 7920 6120 636f 6d70 7574 6572 copy a computer │ │ │ │ │ +00016e50: 2d6e 6574 776f 726b 206c 6f63 6174 696f -network locatio │ │ │ │ │ +00016e60: 6e20 6672 6f6d 2077 6869 6368 2074 6865 n from which the │ │ │ │ │ +00016e70: 2067 656e 6572 616c 0a20 2020 2020 6e65 general. ne │ │ │ │ │ +00016e80: 7477 6f72 6b2d 7573 696e 6720 7075 626c twork-using publ │ │ │ │ │ +00016e90: 6963 2068 6173 2061 6363 6573 7320 746f ic has access to │ │ │ │ │ +00016ea0: 2064 6f77 6e6c 6f61 6420 7573 696e 6720 download using │ │ │ │ │ +00016eb0: 7075 626c 6963 2d73 7461 6e64 6172 640a public-standard. │ │ │ │ │ +00016ec0: 2020 2020 206e 6574 776f 726b 2070 726f network pro │ │ │ │ │ +00016ed0: 746f 636f 6c73 2061 2063 6f6d 706c 6574 tocols a complet │ │ │ │ │ +00016ee0: 6520 5472 616e 7370 6172 656e 7420 636f e Transparent co │ │ │ │ │ +00016ef0: 7079 206f 6620 7468 6520 446f 6375 6d65 py of the Docume │ │ │ │ │ +00016f00: 6e74 2c20 6672 6565 0a20 2020 2020 6f66 nt, free. of │ │ │ │ │ +00016f10: 2061 6464 6564 206d 6174 6572 6961 6c2e added material. │ │ │ │ │ +00016f20: 2020 4966 2079 6f75 2075 7365 2074 6865 If you use the │ │ │ │ │ +00016f30: 206c 6174 7465 7220 6f70 7469 6f6e 2c20 latter option, │ │ │ │ │ +00016f40: 796f 7520 6d75 7374 2074 616b 650a 2020 you must take. │ │ │ │ │ +00016f50: 2020 2072 6561 736f 6e61 626c 7920 7072 reasonably pr │ │ │ │ │ +00016f60: 7564 656e 7420 7374 6570 732c 2077 6865 udent steps, whe │ │ │ │ │ +00016f70: 6e20 796f 7520 6265 6769 6e20 6469 7374 n you begin dist │ │ │ │ │ +00016f80: 7269 6275 7469 6f6e 206f 6620 4f70 6171 ribution of Opaq │ │ │ │ │ +00016f90: 7565 0a20 2020 2020 636f 7069 6573 2069 ue. copies i │ │ │ │ │ +00016fa0: 6e20 7175 616e 7469 7479 2c20 746f 2065 n quantity, to e │ │ │ │ │ +00016fb0: 6e73 7572 6520 7468 6174 2074 6869 7320 nsure that this │ │ │ │ │ +00016fc0: 5472 616e 7370 6172 656e 7420 636f 7079 Transparent copy │ │ │ │ │ +00016fd0: 2077 696c 6c0a 2020 2020 2072 656d 6169 will. remai │ │ │ │ │ +00016fe0: 6e20 7468 7573 2061 6363 6573 7369 626c n thus accessibl │ │ │ │ │ +00016ff0: 6520 6174 2074 6865 2073 7461 7465 6420 e at the stated │ │ │ │ │ +00017000: 6c6f 6361 7469 6f6e 2075 6e74 696c 2061 location until a │ │ │ │ │ +00017010: 7420 6c65 6173 7420 6f6e 650a 2020 2020 t least one. │ │ │ │ │ +00017020: 2079 6561 7220 6166 7465 7220 7468 6520 year after the │ │ │ │ │ +00017030: 6c61 7374 2074 696d 6520 796f 7520 6469 last time you di │ │ │ │ │ +00017040: 7374 7269 6275 7465 2061 6e20 4f70 6171 stribute an Opaq │ │ │ │ │ +00017050: 7565 2063 6f70 7920 2864 6972 6563 746c ue copy (directl │ │ │ │ │ +00017060: 7920 6f72 0a20 2020 2020 7468 726f 7567 y or. throug │ │ │ │ │ +00017070: 6820 796f 7572 2061 6765 6e74 7320 6f72 h your agents or │ │ │ │ │ +00017080: 2072 6574 6169 6c65 7273 2920 6f66 2074 retailers) of t │ │ │ │ │ +00017090: 6861 7420 6564 6974 696f 6e20 746f 2074 hat edition to t │ │ │ │ │ +000170a0: 6865 2070 7562 6c69 632e 0a0a 2020 2020 he public... │ │ │ │ │ +000170b0: 2049 7420 6973 2072 6571 7565 7374 6564 It is requested │ │ │ │ │ +000170c0: 2c20 6275 7420 6e6f 7420 7265 7175 6972 , but not requir │ │ │ │ │ +000170d0: 6564 2c20 7468 6174 2079 6f75 2063 6f6e ed, that you con │ │ │ │ │ +000170e0: 7461 6374 2074 6865 2061 7574 686f 7273 tact the authors │ │ │ │ │ +000170f0: 206f 660a 2020 2020 2074 6865 2044 6f63 of. the Doc │ │ │ │ │ +00017100: 756d 656e 7420 7765 6c6c 2062 6566 6f72 ument well befor │ │ │ │ │ +00017110: 6520 7265 6469 7374 7269 6275 7469 6e67 e redistributing │ │ │ │ │ +00017120: 2061 6e79 206c 6172 6765 206e 756d 6265 any large numbe │ │ │ │ │ +00017130: 7220 6f66 2063 6f70 6965 732c 0a20 2020 r of copies,. │ │ │ │ │ +00017140: 2020 746f 2067 6976 6520 7468 656d 2061 to give them a │ │ │ │ │ +00017150: 2063 6861 6e63 6520 746f 2070 726f 7669 chance to provi │ │ │ │ │ +00017160: 6465 2079 6f75 2077 6974 6820 616e 2075 de you with an u │ │ │ │ │ +00017170: 7064 6174 6564 2076 6572 7369 6f6e 206f pdated version o │ │ │ │ │ +00017180: 6620 7468 650a 2020 2020 2044 6f63 756d f the. Docum │ │ │ │ │ +00017190: 656e 742e 0a0a 2020 342e 204d 4f44 4946 ent... 4. MODIF │ │ │ │ │ +000171a0: 4943 4154 494f 4e53 0a0a 2020 2020 2059 ICATIONS.. Y │ │ │ │ │ +000171b0: 6f75 206d 6179 2063 6f70 7920 616e 6420 ou may copy and │ │ │ │ │ +000171c0: 6469 7374 7269 6275 7465 2061 204d 6f64 distribute a Mod │ │ │ │ │ +000171d0: 6966 6965 6420 5665 7273 696f 6e20 6f66 ified Version of │ │ │ │ │ +000171e0: 2074 6865 2044 6f63 756d 656e 740a 2020 the Document. │ │ │ │ │ +000171f0: 2020 2075 6e64 6572 2074 6865 2063 6f6e under the con │ │ │ │ │ +00017200: 6469 7469 6f6e 7320 6f66 2073 6563 7469 ditions of secti │ │ │ │ │ +00017210: 6f6e 7320 3220 616e 6420 3320 6162 6f76 ons 2 and 3 abov │ │ │ │ │ +00017220: 652c 2070 726f 7669 6465 6420 7468 6174 e, provided that │ │ │ │ │ +00017230: 2079 6f75 0a20 2020 2020 7265 6c65 6173 you. releas │ │ │ │ │ +00017240: 6520 7468 6520 4d6f 6469 6669 6564 2056 e the Modified V │ │ │ │ │ +00017250: 6572 7369 6f6e 2075 6e64 6572 2070 7265 ersion under pre │ │ │ │ │ +00017260: 6369 7365 6c79 2074 6869 7320 4c69 6365 cisely this Lice │ │ │ │ │ +00017270: 6e73 652c 2077 6974 6820 7468 650a 2020 nse, with the. │ │ │ │ │ +00017280: 2020 204d 6f64 6966 6965 6420 5665 7273 Modified Vers │ │ │ │ │ +00017290: 696f 6e20 6669 6c6c 696e 6720 7468 6520 ion filling the │ │ │ │ │ +000172a0: 726f 6c65 206f 6620 7468 6520 446f 6375 role of the Docu │ │ │ │ │ +000172b0: 6d65 6e74 2c20 7468 7573 206c 6963 656e ment, thus licen │ │ │ │ │ +000172c0: 7369 6e67 0a20 2020 2020 6469 7374 7269 sing. distri │ │ │ │ │ +000172d0: 6275 7469 6f6e 2061 6e64 206d 6f64 6966 bution and modif │ │ │ │ │ +000172e0: 6963 6174 696f 6e20 6f66 2074 6865 204d ication of the M │ │ │ │ │ +000172f0: 6f64 6966 6965 6420 5665 7273 696f 6e20 odified Version │ │ │ │ │ +00017300: 746f 2077 686f 6576 6572 0a20 2020 2020 to whoever. │ │ │ │ │ +00017310: 706f 7373 6573 7365 7320 6120 636f 7079 possesses a copy │ │ │ │ │ +00017320: 206f 6620 6974 2e20 2049 6e20 6164 6469 of it. In addi │ │ │ │ │ +00017330: 7469 6f6e 2c20 796f 7520 6d75 7374 2064 tion, you must d │ │ │ │ │ +00017340: 6f20 7468 6573 6520 7468 696e 6773 2069 o these things i │ │ │ │ │ +00017350: 6e0a 2020 2020 2074 6865 204d 6f64 6966 n. the Modif │ │ │ │ │ +00017360: 6965 6420 5665 7273 696f 6e3a 0a0a 2020 ied Version:.. │ │ │ │ │ +00017370: 2020 2020 2041 2e20 5573 6520 696e 2074 A. Use in t │ │ │ │ │ +00017380: 6865 2054 6974 6c65 2050 6167 6520 2861 he Title Page (a │ │ │ │ │ +00017390: 6e64 206f 6e20 7468 6520 636f 7665 7273 nd on the covers │ │ │ │ │ +000173a0: 2c20 6966 2061 6e79 2920 6120 7469 746c , if any) a titl │ │ │ │ │ +000173b0: 650a 2020 2020 2020 2020 2020 6469 7374 e. dist │ │ │ │ │ +000173c0: 696e 6374 2066 726f 6d20 7468 6174 206f inct from that o │ │ │ │ │ +000173d0: 6620 7468 6520 446f 6375 6d65 6e74 2c20 f the Document, │ │ │ │ │ +000173e0: 616e 6420 6672 6f6d 2074 686f 7365 206f and from those o │ │ │ │ │ +000173f0: 6620 7072 6576 696f 7573 0a20 2020 2020 f previous. │ │ │ │ │ +00017400: 2020 2020 2076 6572 7369 6f6e 7320 2877 versions (w │ │ │ │ │ +00017410: 6869 6368 2073 686f 756c 642c 2069 6620 hich should, if │ │ │ │ │ +00017420: 7468 6572 6520 7765 7265 2061 6e79 2c20 there were any, │ │ │ │ │ +00017430: 6265 206c 6973 7465 6420 696e 2074 6865 be listed in the │ │ │ │ │ +00017440: 0a20 2020 2020 2020 2020 2048 6973 746f . Histo │ │ │ │ │ +00017450: 7279 2073 6563 7469 6f6e 206f 6620 7468 ry section of th │ │ │ │ │ +00017460: 6520 446f 6375 6d65 6e74 292e 2020 596f e Document). Yo │ │ │ │ │ +00017470: 7520 6d61 7920 7573 6520 7468 6520 7361 u may use the sa │ │ │ │ │ +00017480: 6d65 2074 6974 6c65 0a20 2020 2020 2020 me title. │ │ │ │ │ +00017490: 2020 2061 7320 6120 7072 6576 696f 7573 as a previous │ │ │ │ │ +000174a0: 2076 6572 7369 6f6e 2069 6620 7468 6520 version if the │ │ │ │ │ +000174b0: 6f72 6967 696e 616c 2070 7562 6c69 7368 original publish │ │ │ │ │ +000174c0: 6572 206f 6620 7468 6174 0a20 2020 2020 er of that. │ │ │ │ │ +000174d0: 2020 2020 2076 6572 7369 6f6e 2067 6976 version giv │ │ │ │ │ +000174e0: 6573 2070 6572 6d69 7373 696f 6e2e 0a0a es permission... │ │ │ │ │ +000174f0: 2020 2020 2020 2042 2e20 4c69 7374 206f B. List o │ │ │ │ │ +00017500: 6e20 7468 6520 5469 746c 6520 5061 6765 n the Title Page │ │ │ │ │ +00017510: 2c20 6173 2061 7574 686f 7273 2c20 6f6e , as authors, on │ │ │ │ │ +00017520: 6520 6f72 206d 6f72 6520 7065 7273 6f6e e or more person │ │ │ │ │ +00017530: 7320 6f72 0a20 2020 2020 2020 2020 2065 s or. e │ │ │ │ │ +00017540: 6e74 6974 6965 7320 7265 7370 6f6e 7369 ntities responsi │ │ │ │ │ +00017550: 626c 6520 666f 7220 6175 7468 6f72 7368 ble for authorsh │ │ │ │ │ +00017560: 6970 206f 6620 7468 6520 6d6f 6469 6669 ip of the modifi │ │ │ │ │ +00017570: 6361 7469 6f6e 7320 696e 0a20 2020 2020 cations in. │ │ │ │ │ +00017580: 2020 2020 2074 6865 204d 6f64 6966 6965 the Modifie │ │ │ │ │ +00017590: 6420 5665 7273 696f 6e2c 2074 6f67 6574 d Version, toget │ │ │ │ │ +000175a0: 6865 7220 7769 7468 2061 7420 6c65 6173 her with at leas │ │ │ │ │ +000175b0: 7420 6669 7665 206f 6620 7468 650a 2020 t five of the. │ │ │ │ │ +000175c0: 2020 2020 2020 2020 7072 696e 6369 7061 principa │ │ │ │ │ +000175d0: 6c20 6175 7468 6f72 7320 6f66 2074 6865 l authors of the │ │ │ │ │ +000175e0: 2044 6f63 756d 656e 7420 2861 6c6c 206f Document (all o │ │ │ │ │ +000175f0: 6620 6974 7320 7072 696e 6369 7061 6c0a f its principal. │ │ │ │ │ +00017600: 2020 2020 2020 2020 2020 6175 7468 6f72 author │ │ │ │ │ +00017610: 732c 2069 6620 6974 2068 6173 2066 6577 s, if it has few │ │ │ │ │ +00017620: 6572 2074 6861 6e20 6669 7665 292c 2075 er than five), u │ │ │ │ │ +00017630: 6e6c 6573 7320 7468 6579 2072 656c 6561 nless they relea │ │ │ │ │ +00017640: 7365 2079 6f75 0a20 2020 2020 2020 2020 se you. │ │ │ │ │ +00017650: 2066 726f 6d20 7468 6973 2072 6571 7569 from this requi │ │ │ │ │ +00017660: 7265 6d65 6e74 2e0a 0a20 2020 2020 2020 rement... │ │ │ │ │ +00017670: 432e 2053 7461 7465 206f 6e20 7468 6520 C. State on the │ │ │ │ │ +00017680: 5469 746c 6520 7061 6765 2074 6865 206e Title page the n │ │ │ │ │ +00017690: 616d 6520 6f66 2074 6865 2070 7562 6c69 ame of the publi │ │ │ │ │ +000176a0: 7368 6572 206f 6620 7468 650a 2020 2020 sher of the. │ │ │ │ │ +000176b0: 2020 2020 2020 4d6f 6469 6669 6564 2056 Modified V │ │ │ │ │ +000176c0: 6572 7369 6f6e 2c20 6173 2074 6865 2070 ersion, as the p │ │ │ │ │ +000176d0: 7562 6c69 7368 6572 2e0a 0a20 2020 2020 ublisher... │ │ │ │ │ +000176e0: 2020 442e 2050 7265 7365 7276 6520 616c D. Preserve al │ │ │ │ │ +000176f0: 6c20 7468 6520 636f 7079 7269 6768 7420 l the copyright │ │ │ │ │ +00017700: 6e6f 7469 6365 7320 6f66 2074 6865 2044 notices of the D │ │ │ │ │ +00017710: 6f63 756d 656e 742e 0a0a 2020 2020 2020 ocument... │ │ │ │ │ +00017720: 2045 2e20 4164 6420 616e 2061 7070 726f E. Add an appro │ │ │ │ │ +00017730: 7072 6961 7465 2063 6f70 7972 6967 6874 priate copyright │ │ │ │ │ +00017740: 206e 6f74 6963 6520 666f 7220 796f 7572 notice for your │ │ │ │ │ +00017750: 206d 6f64 6966 6963 6174 696f 6e73 0a20 modifications. │ │ │ │ │ +00017760: 2020 2020 2020 2020 2061 646a 6163 656e adjacen │ │ │ │ │ +00017770: 7420 746f 2074 6865 206f 7468 6572 2063 t to the other c │ │ │ │ │ +00017780: 6f70 7972 6967 6874 206e 6f74 6963 6573 opyright notices │ │ │ │ │ +00017790: 2e0a 0a20 2020 2020 2020 462e 2049 6e63 ... F. Inc │ │ │ │ │ +000177a0: 6c75 6465 2c20 696d 6d65 6469 6174 656c lude, immediatel │ │ │ │ │ +000177b0: 7920 6166 7465 7220 7468 6520 636f 7079 y after the copy │ │ │ │ │ +000177c0: 7269 6768 7420 6e6f 7469 6365 732c 2061 right notices, a │ │ │ │ │ +000177d0: 206c 6963 656e 7365 0a20 2020 2020 2020 license. │ │ │ │ │ +000177e0: 2020 206e 6f74 6963 6520 6769 7669 6e67 notice giving │ │ │ │ │ +000177f0: 2074 6865 2070 7562 6c69 6320 7065 726d the public perm │ │ │ │ │ +00017800: 6973 7369 6f6e 2074 6f20 7573 6520 7468 ission to use th │ │ │ │ │ +00017810: 6520 4d6f 6469 6669 6564 0a20 2020 2020 e Modified. │ │ │ │ │ +00017820: 2020 2020 2056 6572 7369 6f6e 2075 6e64 Version und │ │ │ │ │ +00017830: 6572 2074 6865 2074 6572 6d73 206f 6620 er the terms of │ │ │ │ │ +00017840: 7468 6973 204c 6963 656e 7365 2c20 696e this License, in │ │ │ │ │ +00017850: 2074 6865 2066 6f72 6d20 7368 6f77 6e20 the form shown │ │ │ │ │ +00017860: 696e 0a20 2020 2020 2020 2020 2074 6865 in. the │ │ │ │ │ +00017870: 2041 6464 656e 6475 6d20 6265 6c6f 772e Addendum below. │ │ │ │ │ +00017880: 0a0a 2020 2020 2020 2047 2e20 5072 6573 .. G. Pres │ │ │ │ │ +00017890: 6572 7665 2069 6e20 7468 6174 206c 6963 erve in that lic │ │ │ │ │ +000178a0: 656e 7365 206e 6f74 6963 6520 7468 6520 ense notice the │ │ │ │ │ +000178b0: 6675 6c6c 206c 6973 7473 206f 6620 496e full lists of In │ │ │ │ │ +000178c0: 7661 7269 616e 740a 2020 2020 2020 2020 variant. │ │ │ │ │ +000178d0: 2020 5365 6374 696f 6e73 2061 6e64 2072 Sections and r │ │ │ │ │ +000178e0: 6571 7569 7265 6420 436f 7665 7220 5465 equired Cover Te │ │ │ │ │ +000178f0: 7874 7320 6769 7665 6e20 696e 2074 6865 xts given in the │ │ │ │ │ +00017900: 2044 6f63 756d 656e 7427 730a 2020 2020 Document's. │ │ │ │ │ +00017910: 2020 2020 2020 6c69 6365 6e73 6520 6e6f license no │ │ │ │ │ +00017920: 7469 6365 2e0a 0a20 2020 2020 2020 482e tice... H. │ │ │ │ │ +00017930: 2049 6e63 6c75 6465 2061 6e20 756e 616c Include an unal │ │ │ │ │ +00017940: 7465 7265 6420 636f 7079 206f 6620 7468 tered copy of th │ │ │ │ │ +00017950: 6973 204c 6963 656e 7365 2e0a 0a20 2020 is License... │ │ │ │ │ +00017960: 2020 2020 492e 2050 7265 7365 7276 6520 I. Preserve │ │ │ │ │ +00017970: 7468 6520 7365 6374 696f 6e20 456e 7469 the section Enti │ │ │ │ │ +00017980: 746c 6564 2022 4869 7374 6f72 7922 2c20 tled "History", │ │ │ │ │ +00017990: 5072 6573 6572 7665 2069 7473 2054 6974 Preserve its Tit │ │ │ │ │ +000179a0: 6c65 2c0a 2020 2020 2020 2020 2020 616e le,. an │ │ │ │ │ +000179b0: 6420 6164 6420 746f 2069 7420 616e 2069 d add to it an i │ │ │ │ │ +000179c0: 7465 6d20 7374 6174 696e 6720 6174 206c tem stating at l │ │ │ │ │ +000179d0: 6561 7374 2074 6865 2074 6974 6c65 2c20 east the title, │ │ │ │ │ +000179e0: 7965 6172 2c20 6e65 770a 2020 2020 2020 year, new. │ │ │ │ │ +000179f0: 2020 2020 6175 7468 6f72 732c 2061 6e64 authors, and │ │ │ │ │ +00017a00: 2070 7562 6c69 7368 6572 206f 6620 7468 publisher of th │ │ │ │ │ +00017a10: 6520 4d6f 6469 6669 6564 2056 6572 7369 e Modified Versi │ │ │ │ │ +00017a20: 6f6e 2061 7320 6769 7665 6e20 6f6e 2074 on as given on t │ │ │ │ │ +00017a30: 6865 0a20 2020 2020 2020 2020 2054 6974 he. Tit │ │ │ │ │ +00017a40: 6c65 2050 6167 652e 2020 4966 2074 6865 le Page. If the │ │ │ │ │ +00017a50: 7265 2069 7320 6e6f 2073 6563 7469 6f6e re is no section │ │ │ │ │ +00017a60: 2045 6e74 6974 6c65 6420 2248 6973 746f Entitled "Histo │ │ │ │ │ +00017a70: 7279 2220 696e 2074 6865 0a20 2020 2020 ry" in the. │ │ │ │ │ +00017a80: 2020 2020 2044 6f63 756d 656e 742c 2063 Document, c │ │ │ │ │ +00017a90: 7265 6174 6520 6f6e 6520 7374 6174 696e reate one statin │ │ │ │ │ +00017aa0: 6720 7468 6520 7469 746c 652c 2079 6561 g the title, yea │ │ │ │ │ +00017ab0: 722c 2061 7574 686f 7273 2c20 616e 640a r, authors, and. │ │ │ │ │ +00017ac0: 2020 2020 2020 2020 2020 7075 626c 6973 publis │ │ │ │ │ +00017ad0: 6865 7220 6f66 2074 6865 2044 6f63 756d her of the Docum │ │ │ │ │ +00017ae0: 656e 7420 6173 2067 6976 656e 206f 6e20 ent as given on │ │ │ │ │ +00017af0: 6974 7320 5469 746c 6520 5061 6765 2c20 its Title Page, │ │ │ │ │ +00017b00: 7468 656e 2061 6464 0a20 2020 2020 2020 then add. │ │ │ │ │ +00017b10: 2020 2061 6e20 6974 656d 2064 6573 6372 an item descr │ │ │ │ │ +00017b20: 6962 696e 6720 7468 6520 4d6f 6469 6669 ibing the Modifi │ │ │ │ │ +00017b30: 6564 2056 6572 7369 6f6e 2061 7320 7374 ed Version as st │ │ │ │ │ +00017b40: 6174 6564 2069 6e20 7468 650a 2020 2020 ated in the. │ │ │ │ │ +00017b50: 2020 2020 2020 7072 6576 696f 7573 2073 previous s │ │ │ │ │ +00017b60: 656e 7465 6e63 652e 0a0a 2020 2020 2020 entence... │ │ │ │ │ +00017b70: 204a 2e20 5072 6573 6572 7665 2074 6865 J. Preserve the │ │ │ │ │ +00017b80: 206e 6574 776f 726b 206c 6f63 6174 696f network locatio │ │ │ │ │ +00017b90: 6e2c 2069 6620 616e 792c 2067 6976 656e n, if any, given │ │ │ │ │ +00017ba0: 2069 6e20 7468 6520 446f 6375 6d65 6e74 in the Document │ │ │ │ │ +00017bb0: 0a20 2020 2020 2020 2020 2066 6f72 2070 . for p │ │ │ │ │ +00017bc0: 7562 6c69 6320 6163 6365 7373 2074 6f20 ublic access to │ │ │ │ │ +00017bd0: 6120 5472 616e 7370 6172 656e 7420 636f a Transparent co │ │ │ │ │ +00017be0: 7079 206f 6620 7468 6520 446f 6375 6d65 py of the Docume │ │ │ │ │ +00017bf0: 6e74 2c20 616e 640a 2020 2020 2020 2020 nt, and. │ │ │ │ │ +00017c00: 2020 6c69 6b65 7769 7365 2074 6865 206e likewise the n │ │ │ │ │ +00017c10: 6574 776f 726b 206c 6f63 6174 696f 6e73 etwork locations │ │ │ │ │ +00017c20: 2067 6976 656e 2069 6e20 7468 6520 446f given in the Do │ │ │ │ │ +00017c30: 6375 6d65 6e74 2066 6f72 0a20 2020 2020 cument for. │ │ │ │ │ +00017c40: 2020 2020 2070 7265 7669 6f75 7320 7665 previous ve │ │ │ │ │ +00017c50: 7273 696f 6e73 2069 7420 7761 7320 6261 rsions it was ba │ │ │ │ │ +00017c60: 7365 6420 6f6e 2e20 2054 6865 7365 206d sed on. These m │ │ │ │ │ +00017c70: 6179 2062 6520 706c 6163 6564 2069 6e20 ay be placed in │ │ │ │ │ +00017c80: 7468 650a 2020 2020 2020 2020 2020 2248 the. "H │ │ │ │ │ +00017c90: 6973 746f 7279 2220 7365 6374 696f 6e2e istory" section. │ │ │ │ │ +00017ca0: 2020 596f 7520 6d61 7920 6f6d 6974 2061 You may omit a │ │ │ │ │ +00017cb0: 206e 6574 776f 726b 206c 6f63 6174 696f network locatio │ │ │ │ │ +00017cc0: 6e20 666f 7220 6120 776f 726b 0a20 2020 n for a work. │ │ │ │ │ +00017cd0: 2020 2020 2020 2074 6861 7420 7761 7320 that was │ │ │ │ │ +00017ce0: 7075 626c 6973 6865 6420 6174 206c 6561 published at lea │ │ │ │ │ +00017cf0: 7374 2066 6f75 7220 7965 6172 7320 6265 st four years be │ │ │ │ │ +00017d00: 666f 7265 2074 6865 2044 6f63 756d 656e fore the Documen │ │ │ │ │ +00017d10: 740a 2020 2020 2020 2020 2020 6974 7365 t. itse │ │ │ │ │ +00017d20: 6c66 2c20 6f72 2069 6620 7468 6520 6f72 lf, or if the or │ │ │ │ │ +00017d30: 6967 696e 616c 2070 7562 6c69 7368 6572 iginal publisher │ │ │ │ │ +00017d40: 206f 6620 7468 6520 7665 7273 696f 6e20 of the version │ │ │ │ │ +00017d50: 6974 2072 6566 6572 730a 2020 2020 2020 it refers. │ │ │ │ │ +00017d60: 2020 2020 746f 2067 6976 6573 2070 6572 to gives per │ │ │ │ │ +00017d70: 6d69 7373 696f 6e2e 0a0a 2020 2020 2020 mission... │ │ │ │ │ +00017d80: 204b 2e20 466f 7220 616e 7920 7365 6374 K. For any sect │ │ │ │ │ +00017d90: 696f 6e20 456e 7469 746c 6564 2022 4163 ion Entitled "Ac │ │ │ │ │ +00017da0: 6b6e 6f77 6c65 6467 656d 656e 7473 2220 knowledgements" │ │ │ │ │ +00017db0: 6f72 2022 4465 6469 6361 7469 6f6e 7322 or "Dedications" │ │ │ │ │ +00017dc0: 2c0a 2020 2020 2020 2020 2020 5072 6573 ,. Pres │ │ │ │ │ +00017dd0: 6572 7665 2074 6865 2054 6974 6c65 206f erve the Title o │ │ │ │ │ +00017de0: 6620 7468 6520 7365 6374 696f 6e2c 2061 f the section, a │ │ │ │ │ +00017df0: 6e64 2070 7265 7365 7276 6520 696e 2074 nd preserve in t │ │ │ │ │ +00017e00: 6865 2073 6563 7469 6f6e 0a20 2020 2020 he section. │ │ │ │ │ +00017e10: 2020 2020 2061 6c6c 2074 6865 2073 7562 all the sub │ │ │ │ │ +00017e20: 7374 616e 6365 2061 6e64 2074 6f6e 6520 stance and tone │ │ │ │ │ +00017e30: 6f66 2065 6163 6820 6f66 2074 6865 2063 of each of the c │ │ │ │ │ +00017e40: 6f6e 7472 6962 7574 6f72 0a20 2020 2020 ontributor. │ │ │ │ │ +00017e50: 2020 2020 2061 636b 6e6f 776c 6564 6765 acknowledge │ │ │ │ │ +00017e60: 6d65 6e74 7320 616e 642f 6f72 2064 6564 ments and/or ded │ │ │ │ │ +00017e70: 6963 6174 696f 6e73 2067 6976 656e 2074 ications given t │ │ │ │ │ +00017e80: 6865 7265 696e 2e0a 0a20 2020 2020 2020 herein... │ │ │ │ │ +00017e90: 4c2e 2050 7265 7365 7276 6520 616c 6c20 L. Preserve all │ │ │ │ │ +00017ea0: 7468 6520 496e 7661 7269 616e 7420 5365 the Invariant Se │ │ │ │ │ +00017eb0: 6374 696f 6e73 206f 6620 7468 6520 446f ctions of the Do │ │ │ │ │ +00017ec0: 6375 6d65 6e74 2c20 756e 616c 7465 7265 cument, unaltere │ │ │ │ │ +00017ed0: 640a 2020 2020 2020 2020 2020 696e 2074 d. in t │ │ │ │ │ +00017ee0: 6865 6972 2074 6578 7420 616e 6420 696e heir text and in │ │ │ │ │ +00017ef0: 2074 6865 6972 2074 6974 6c65 732e 2020 their titles. │ │ │ │ │ +00017f00: 5365 6374 696f 6e20 6e75 6d62 6572 7320 Section numbers │ │ │ │ │ +00017f10: 6f72 2074 6865 0a20 2020 2020 2020 2020 or the. │ │ │ │ │ +00017f20: 2065 7175 6976 616c 656e 7420 6172 6520 equivalent are │ │ │ │ │ +00017f30: 6e6f 7420 636f 6e73 6964 6572 6564 2070 not considered p │ │ │ │ │ +00017f40: 6172 7420 6f66 2074 6865 2073 6563 7469 art of the secti │ │ │ │ │ +00017f50: 6f6e 2074 6974 6c65 732e 0a0a 2020 2020 on titles... │ │ │ │ │ +00017f60: 2020 204d 2e20 4465 6c65 7465 2061 6e79 M. Delete any │ │ │ │ │ +00017f70: 2073 6563 7469 6f6e 2045 6e74 6974 6c65 section Entitle │ │ │ │ │ +00017f80: 6420 2245 6e64 6f72 7365 6d65 6e74 7322 d "Endorsements" │ │ │ │ │ +00017f90: 2e20 2053 7563 6820 6120 7365 6374 696f . Such a sectio │ │ │ │ │ +00017fa0: 6e0a 2020 2020 2020 2020 2020 6d61 7920 n. may │ │ │ │ │ +00017fb0: 6e6f 7420 6265 2069 6e63 6c75 6465 6420 not be included │ │ │ │ │ +00017fc0: 696e 2074 6865 204d 6f64 6966 6965 6420 in the Modified │ │ │ │ │ +00017fd0: 5665 7273 696f 6e2e 0a0a 2020 2020 2020 Version... │ │ │ │ │ +00017fe0: 204e 2e20 446f 206e 6f74 2072 6574 6974 N. Do not retit │ │ │ │ │ +00017ff0: 6c65 2061 6e79 2065 7869 7374 696e 6720 le any existing │ │ │ │ │ +00018000: 7365 6374 696f 6e20 746f 2062 6520 456e section to be En │ │ │ │ │ +00018010: 7469 746c 6564 0a20 2020 2020 2020 2020 titled. │ │ │ │ │ +00018020: 2022 456e 646f 7273 656d 656e 7473 2220 "Endorsements" │ │ │ │ │ +00018030: 6f72 2074 6f20 636f 6e66 6c69 6374 2069 or to conflict i │ │ │ │ │ +00018040: 6e20 7469 746c 6520 7769 7468 2061 6e79 n title with any │ │ │ │ │ +00018050: 2049 6e76 6172 6961 6e74 0a20 2020 2020 Invariant. │ │ │ │ │ +00018060: 2020 2020 2053 6563 7469 6f6e 2e0a 0a20 Section... │ │ │ │ │ +00018070: 2020 2020 2020 4f2e 2050 7265 7365 7276 O. Preserv │ │ │ │ │ +00018080: 6520 616e 7920 5761 7272 616e 7479 2044 e any Warranty D │ │ │ │ │ +00018090: 6973 636c 6169 6d65 7273 2e0a 0a20 2020 isclaimers... │ │ │ │ │ +000180a0: 2020 4966 2074 6865 204d 6f64 6966 6965 If the Modifie │ │ │ │ │ +000180b0: 6420 5665 7273 696f 6e20 696e 636c 7564 d Version includ │ │ │ │ │ +000180c0: 6573 206e 6577 2066 726f 6e74 2d6d 6174 es new front-mat │ │ │ │ │ +000180d0: 7465 7220 7365 6374 696f 6e73 206f 720a ter sections or. │ │ │ │ │ +000180e0: 2020 2020 2061 7070 656e 6469 6365 7320 appendices │ │ │ │ │ +000180f0: 7468 6174 2071 7561 6c69 6679 2061 7320 that qualify as │ │ │ │ │ +00018100: 5365 636f 6e64 6172 7920 5365 6374 696f Secondary Sectio │ │ │ │ │ +00018110: 6e73 2061 6e64 2063 6f6e 7461 696e 206e ns and contain n │ │ │ │ │ +00018120: 6f0a 2020 2020 206d 6174 6572 6961 6c20 o. material │ │ │ │ │ +00018130: 636f 7069 6564 2066 726f 6d20 7468 6520 copied from the │ │ │ │ │ +00018140: 446f 6375 6d65 6e74 2c20 796f 7520 6d61 Document, you ma │ │ │ │ │ +00018150: 7920 6174 2079 6f75 7220 6f70 7469 6f6e y at your option │ │ │ │ │ +00018160: 2064 6573 6967 6e61 7465 0a20 2020 2020 designate. │ │ │ │ │ +00018170: 736f 6d65 206f 7220 616c 6c20 6f66 2074 some or all of t │ │ │ │ │ +00018180: 6865 7365 2073 6563 7469 6f6e 7320 6173 hese sections as │ │ │ │ │ +00018190: 2069 6e76 6172 6961 6e74 2e20 2054 6f20 invariant. To │ │ │ │ │ +000181a0: 646f 2074 6869 732c 2061 6464 2074 6865 do this, add the │ │ │ │ │ +000181b0: 6972 0a20 2020 2020 7469 746c 6573 2074 ir. titles t │ │ │ │ │ +000181c0: 6f20 7468 6520 6c69 7374 206f 6620 496e o the list of In │ │ │ │ │ +000181d0: 7661 7269 616e 7420 5365 6374 696f 6e73 variant Sections │ │ │ │ │ +000181e0: 2069 6e20 7468 6520 4d6f 6469 6669 6564 in the Modified │ │ │ │ │ +000181f0: 2056 6572 7369 6f6e 2773 0a20 2020 2020 Version's. │ │ │ │ │ +00018200: 6c69 6365 6e73 6520 6e6f 7469 6365 2e20 license notice. │ │ │ │ │ +00018210: 2054 6865 7365 2074 6974 6c65 7320 6d75 These titles mu │ │ │ │ │ +00018220: 7374 2062 6520 6469 7374 696e 6374 2066 st be distinct f │ │ │ │ │ +00018230: 726f 6d20 616e 7920 6f74 6865 720a 2020 rom any other. │ │ │ │ │ +00018240: 2020 2073 6563 7469 6f6e 2074 6974 6c65 section title │ │ │ │ │ +00018250: 732e 0a0a 2020 2020 2059 6f75 206d 6179 s... You may │ │ │ │ │ +00018260: 2061 6464 2061 2073 6563 7469 6f6e 2045 add a section E │ │ │ │ │ +00018270: 6e74 6974 6c65 6420 2245 6e64 6f72 7365 ntitled "Endorse │ │ │ │ │ +00018280: 6d65 6e74 7322 2c20 7072 6f76 6964 6564 ments", provided │ │ │ │ │ +00018290: 2069 7420 636f 6e74 6169 6e73 0a20 2020 it contains. │ │ │ │ │ +000182a0: 2020 6e6f 7468 696e 6720 6275 7420 656e nothing but en │ │ │ │ │ +000182b0: 646f 7273 656d 656e 7473 206f 6620 796f dorsements of yo │ │ │ │ │ +000182c0: 7572 204d 6f64 6966 6965 6420 5665 7273 ur Modified Vers │ │ │ │ │ +000182d0: 696f 6e20 6279 2076 6172 696f 7573 0a20 ion by various. │ │ │ │ │ +000182e0: 2020 2020 7061 7274 6965 732d 2d66 6f72 parties--for │ │ │ │ │ +000182f0: 2065 7861 6d70 6c65 2c20 7374 6174 656d example, statem │ │ │ │ │ +00018300: 656e 7473 206f 6620 7065 6572 2072 6576 ents of peer rev │ │ │ │ │ +00018310: 6965 7720 6f72 2074 6861 7420 7468 6520 iew or that the │ │ │ │ │ +00018320: 7465 7874 0a20 2020 2020 6861 7320 6265 text. has be │ │ │ │ │ +00018330: 656e 2061 7070 726f 7665 6420 6279 2061 en approved by a │ │ │ │ │ +00018340: 6e20 6f72 6761 6e69 7a61 7469 6f6e 2061 n organization a │ │ │ │ │ +00018350: 7320 7468 6520 6175 7468 6f72 6974 6174 s the authoritat │ │ │ │ │ +00018360: 6976 650a 2020 2020 2064 6566 696e 6974 ive. definit │ │ │ │ │ +00018370: 696f 6e20 6f66 2061 2073 7461 6e64 6172 ion of a standar │ │ │ │ │ +00018380: 642e 0a0a 2020 2020 2059 6f75 206d 6179 d... You may │ │ │ │ │ +00018390: 2061 6464 2061 2070 6173 7361 6765 206f add a passage o │ │ │ │ │ +000183a0: 6620 7570 2074 6f20 6669 7665 2077 6f72 f up to five wor │ │ │ │ │ +000183b0: 6473 2061 7320 6120 4672 6f6e 742d 436f ds as a Front-Co │ │ │ │ │ +000183c0: 7665 7220 5465 7874 2c0a 2020 2020 2061 ver Text,. a │ │ │ │ │ +000183d0: 6e64 2061 2070 6173 7361 6765 206f 6620 nd a passage of │ │ │ │ │ +000183e0: 7570 2074 6f20 3235 2077 6f72 6473 2061 up to 25 words a │ │ │ │ │ +000183f0: 7320 6120 4261 636b 2d43 6f76 6572 2054 s a Back-Cover T │ │ │ │ │ +00018400: 6578 742c 2074 6f20 7468 6520 656e 6420 ext, to the end │ │ │ │ │ +00018410: 6f66 0a20 2020 2020 7468 6520 6c69 7374 of. the list │ │ │ │ │ +00018420: 206f 6620 436f 7665 7220 5465 7874 7320 of Cover Texts │ │ │ │ │ +00018430: 696e 2074 6865 204d 6f64 6966 6965 6420 in the Modified │ │ │ │ │ +00018440: 5665 7273 696f 6e2e 2020 4f6e 6c79 206f Version. Only o │ │ │ │ │ +00018450: 6e65 2070 6173 7361 6765 0a20 2020 2020 ne passage. │ │ │ │ │ +00018460: 6f66 2046 726f 6e74 2d43 6f76 6572 2054 of Front-Cover T │ │ │ │ │ +00018470: 6578 7420 616e 6420 6f6e 6520 6f66 2042 ext and one of B │ │ │ │ │ +00018480: 6163 6b2d 436f 7665 7220 5465 7874 206d ack-Cover Text m │ │ │ │ │ +00018490: 6179 2062 6520 6164 6465 6420 6279 2028 ay be added by ( │ │ │ │ │ +000184a0: 6f72 0a20 2020 2020 7468 726f 7567 6820 or. through │ │ │ │ │ +000184b0: 6172 7261 6e67 656d 656e 7473 206d 6164 arrangements mad │ │ │ │ │ +000184c0: 6520 6279 2920 616e 7920 6f6e 6520 656e e by) any one en │ │ │ │ │ +000184d0: 7469 7479 2e20 2049 6620 7468 6520 446f tity. If the Do │ │ │ │ │ +000184e0: 6375 6d65 6e74 0a20 2020 2020 616c 7265 cument. alre │ │ │ │ │ +000184f0: 6164 7920 696e 636c 7564 6573 2061 2063 ady includes a c │ │ │ │ │ +00018500: 6f76 6572 2074 6578 7420 666f 7220 7468 over text for th │ │ │ │ │ +00018510: 6520 7361 6d65 2063 6f76 6572 2c20 7072 e same cover, pr │ │ │ │ │ +00018520: 6576 696f 7573 6c79 2061 6464 6564 0a20 eviously added. │ │ │ │ │ +00018530: 2020 2020 6279 2079 6f75 206f 7220 6279 by you or by │ │ │ │ │ +00018540: 2061 7272 616e 6765 6d65 6e74 206d 6164 arrangement mad │ │ │ │ │ +00018550: 6520 6279 2074 6865 2073 616d 6520 656e e by the same en │ │ │ │ │ +00018560: 7469 7479 2079 6f75 2061 7265 2061 6374 tity you are act │ │ │ │ │ +00018570: 696e 6720 6f6e 0a20 2020 2020 6265 6861 ing on. beha │ │ │ │ │ +00018580: 6c66 206f 662c 2079 6f75 206d 6179 206e lf of, you may n │ │ │ │ │ +00018590: 6f74 2061 6464 2061 6e6f 7468 6572 3b20 ot add another; │ │ │ │ │ +000185a0: 6275 7420 796f 7520 6d61 7920 7265 706c but you may repl │ │ │ │ │ +000185b0: 6163 6520 7468 6520 6f6c 640a 2020 2020 ace the old. │ │ │ │ │ +000185c0: 206f 6e65 2c20 6f6e 2065 7870 6c69 6369 one, on explici │ │ │ │ │ +000185d0: 7420 7065 726d 6973 7369 6f6e 2066 726f t permission fro │ │ │ │ │ +000185e0: 6d20 7468 6520 7072 6576 696f 7573 2070 m the previous p │ │ │ │ │ +000185f0: 7562 6c69 7368 6572 2074 6861 7420 6164 ublisher that ad │ │ │ │ │ +00018600: 6465 640a 2020 2020 2074 6865 206f 6c64 ded. the old │ │ │ │ │ +00018610: 206f 6e65 2e0a 0a20 2020 2020 5468 6520 one... The │ │ │ │ │ +00018620: 6175 7468 6f72 2873 2920 616e 6420 7075 author(s) and pu │ │ │ │ │ +00018630: 626c 6973 6865 7228 7329 206f 6620 7468 blisher(s) of th │ │ │ │ │ +00018640: 6520 446f 6375 6d65 6e74 2064 6f20 6e6f e Document do no │ │ │ │ │ +00018650: 7420 6279 2074 6869 730a 2020 2020 204c t by this. L │ │ │ │ │ +00018660: 6963 656e 7365 2067 6976 6520 7065 726d icense give perm │ │ │ │ │ +00018670: 6973 7369 6f6e 2074 6f20 7573 6520 7468 ission to use th │ │ │ │ │ +00018680: 6569 7220 6e61 6d65 7320 666f 7220 7075 eir names for pu │ │ │ │ │ +00018690: 626c 6963 6974 7920 666f 7220 6f72 2074 blicity for or t │ │ │ │ │ +000186a0: 6f0a 2020 2020 2061 7373 6572 7420 6f72 o. assert or │ │ │ │ │ +000186b0: 2069 6d70 6c79 2065 6e64 6f72 7365 6d65 imply endorseme │ │ │ │ │ +000186c0: 6e74 206f 6620 616e 7920 4d6f 6469 6669 nt of any Modifi │ │ │ │ │ +000186d0: 6564 2056 6572 7369 6f6e 2e0a 0a20 2035 ed Version... 5 │ │ │ │ │ +000186e0: 2e20 434f 4d42 494e 494e 4720 444f 4355 . COMBINING DOCU │ │ │ │ │ +000186f0: 4d45 4e54 530a 0a20 2020 2020 596f 7520 MENTS.. You │ │ │ │ │ +00018700: 6d61 7920 636f 6d62 696e 6520 7468 6520 may combine the │ │ │ │ │ +00018710: 446f 6375 6d65 6e74 2077 6974 6820 6f74 Document with ot │ │ │ │ │ +00018720: 6865 7220 646f 6375 6d65 6e74 7320 7265 her documents re │ │ │ │ │ +00018730: 6c65 6173 6564 2075 6e64 6572 0a20 2020 leased under. │ │ │ │ │ +00018740: 2020 7468 6973 204c 6963 656e 7365 2c20 this License, │ │ │ │ │ +00018750: 756e 6465 7220 7468 6520 7465 726d 7320 under the terms │ │ │ │ │ +00018760: 6465 6669 6e65 6420 696e 2073 6563 7469 defined in secti │ │ │ │ │ +00018770: 6f6e 2034 2061 626f 7665 2066 6f72 0a20 on 4 above for. │ │ │ │ │ +00018780: 2020 2020 6d6f 6469 6669 6564 2076 6572 modified ver │ │ │ │ │ +00018790: 7369 6f6e 732c 2070 726f 7669 6465 6420 sions, provided │ │ │ │ │ +000187a0: 7468 6174 2079 6f75 2069 6e63 6c75 6465 that you include │ │ │ │ │ +000187b0: 2069 6e20 7468 6520 636f 6d62 696e 6174 in the combinat │ │ │ │ │ +000187c0: 696f 6e20 616c 6c0a 2020 2020 206f 6620 ion all. of │ │ │ │ │ +000187d0: 7468 6520 496e 7661 7269 616e 7420 5365 the Invariant Se │ │ │ │ │ +000187e0: 6374 696f 6e73 206f 6620 616c 6c20 6f66 ctions of all of │ │ │ │ │ +000187f0: 2074 6865 206f 7269 6769 6e61 6c20 646f the original do │ │ │ │ │ +00018800: 6375 6d65 6e74 732c 0a20 2020 2020 756e cuments,. un │ │ │ │ │ +00018810: 6d6f 6469 6669 6564 2c20 616e 6420 6c69 modified, and li │ │ │ │ │ +00018820: 7374 2074 6865 6d20 616c 6c20 6173 2049 st them all as I │ │ │ │ │ +00018830: 6e76 6172 6961 6e74 2053 6563 7469 6f6e nvariant Section │ │ │ │ │ +00018840: 7320 6f66 2079 6f75 720a 2020 2020 2063 s of your. c │ │ │ │ │ +00018850: 6f6d 6269 6e65 6420 776f 726b 2069 6e20 ombined work in │ │ │ │ │ +00018860: 6974 7320 6c69 6365 6e73 6520 6e6f 7469 its license noti │ │ │ │ │ +00018870: 6365 2c20 616e 6420 7468 6174 2079 6f75 ce, and that you │ │ │ │ │ +00018880: 2070 7265 7365 7276 6520 616c 6c0a 2020 preserve all. │ │ │ │ │ +00018890: 2020 2074 6865 6972 2057 6172 7261 6e74 their Warrant │ │ │ │ │ +000188a0: 7920 4469 7363 6c61 696d 6572 732e 0a0a y Disclaimers... │ │ │ │ │ +000188b0: 2020 2020 2054 6865 2063 6f6d 6269 6e65 The combine │ │ │ │ │ +000188c0: 6420 776f 726b 206e 6565 6420 6f6e 6c79 d work need only │ │ │ │ │ +000188d0: 2063 6f6e 7461 696e 206f 6e65 2063 6f70 contain one cop │ │ │ │ │ +000188e0: 7920 6f66 2074 6869 7320 4c69 6365 6e73 y of this Licens │ │ │ │ │ +000188f0: 652c 2061 6e64 0a20 2020 2020 6d75 6c74 e, and. mult │ │ │ │ │ +00018900: 6970 6c65 2069 6465 6e74 6963 616c 2049 iple identical I │ │ │ │ │ +00018910: 6e76 6172 6961 6e74 2053 6563 7469 6f6e nvariant Section │ │ │ │ │ +00018920: 7320 6d61 7920 6265 2072 6570 6c61 6365 s may be replace │ │ │ │ │ +00018930: 6420 7769 7468 2061 2073 696e 676c 650a d with a single. │ │ │ │ │ +00018940: 2020 2020 2063 6f70 792e 2020 4966 2074 copy. If t │ │ │ │ │ +00018950: 6865 7265 2061 7265 206d 756c 7469 706c here are multipl │ │ │ │ │ +00018960: 6520 496e 7661 7269 616e 7420 5365 6374 e Invariant Sect │ │ │ │ │ +00018970: 696f 6e73 2077 6974 6820 7468 6520 7361 ions with the sa │ │ │ │ │ +00018980: 6d65 206e 616d 650a 2020 2020 2062 7574 me name. but │ │ │ │ │ +00018990: 2064 6966 6665 7265 6e74 2063 6f6e 7465 different conte │ │ │ │ │ +000189a0: 6e74 732c 206d 616b 6520 7468 6520 7469 nts, make the ti │ │ │ │ │ +000189b0: 746c 6520 6f66 2065 6163 6820 7375 6368 tle of each such │ │ │ │ │ +000189c0: 2073 6563 7469 6f6e 2075 6e69 7175 650a section unique. │ │ │ │ │ +000189d0: 2020 2020 2062 7920 6164 6469 6e67 2061 by adding a │ │ │ │ │ +000189e0: 7420 7468 6520 656e 6420 6f66 2069 742c t the end of it, │ │ │ │ │ +000189f0: 2069 6e20 7061 7265 6e74 6865 7365 732c in parentheses, │ │ │ │ │ +00018a00: 2074 6865 206e 616d 6520 6f66 2074 6865 the name of the │ │ │ │ │ +00018a10: 0a20 2020 2020 6f72 6967 696e 616c 2061 . original a │ │ │ │ │ +00018a20: 7574 686f 7220 6f72 2070 7562 6c69 7368 uthor or publish │ │ │ │ │ +00018a30: 6572 206f 6620 7468 6174 2073 6563 7469 er of that secti │ │ │ │ │ +00018a40: 6f6e 2069 6620 6b6e 6f77 6e2c 206f 7220 on if known, or │ │ │ │ │ +00018a50: 656c 7365 2061 0a20 2020 2020 756e 6971 else a. uniq │ │ │ │ │ +00018a60: 7565 206e 756d 6265 722e 2020 4d61 6b65 ue number. Make │ │ │ │ │ +00018a70: 2074 6865 2073 616d 6520 6164 6a75 7374 the same adjust │ │ │ │ │ +00018a80: 6d65 6e74 2074 6f20 7468 6520 7365 6374 ment to the sect │ │ │ │ │ +00018a90: 696f 6e20 7469 746c 6573 2069 6e0a 2020 ion titles in. │ │ │ │ │ +00018aa0: 2020 2074 6865 206c 6973 7420 6f66 2049 the list of I │ │ │ │ │ +00018ab0: 6e76 6172 6961 6e74 2053 6563 7469 6f6e nvariant Section │ │ │ │ │ +00018ac0: 7320 696e 2074 6865 206c 6963 656e 7365 s in the license │ │ │ │ │ +00018ad0: 206e 6f74 6963 6520 6f66 2074 6865 0a20 notice of the. │ │ │ │ │ +00018ae0: 2020 2020 636f 6d62 696e 6564 2077 6f72 combined wor │ │ │ │ │ +00018af0: 6b2e 0a0a 2020 2020 2049 6e20 7468 6520 k... In the │ │ │ │ │ +00018b00: 636f 6d62 696e 6174 696f 6e2c 2079 6f75 combination, you │ │ │ │ │ +00018b10: 206d 7573 7420 636f 6d62 696e 6520 616e must combine an │ │ │ │ │ +00018b20: 7920 7365 6374 696f 6e73 2045 6e74 6974 y sections Entit │ │ │ │ │ +00018b30: 6c65 640a 2020 2020 2022 4869 7374 6f72 led. "Histor │ │ │ │ │ +00018b40: 7922 2069 6e20 7468 6520 7661 7269 6f75 y" in the variou │ │ │ │ │ +00018b50: 7320 6f72 6967 696e 616c 2064 6f63 756d s original docum │ │ │ │ │ +00018b60: 656e 7473 2c20 666f 726d 696e 6720 6f6e ents, forming on │ │ │ │ │ +00018b70: 6520 7365 6374 696f 6e0a 2020 2020 2045 e section. E │ │ │ │ │ +00018b80: 6e74 6974 6c65 6420 2248 6973 746f 7279 ntitled "History │ │ │ │ │ +00018b90: 223b 206c 696b 6577 6973 6520 636f 6d62 "; likewise comb │ │ │ │ │ +00018ba0: 696e 6520 616e 7920 7365 6374 696f 6e73 ine any sections │ │ │ │ │ +00018bb0: 2045 6e74 6974 6c65 640a 2020 2020 2022 Entitled. " │ │ │ │ │ +00018bc0: 4163 6b6e 6f77 6c65 6467 656d 656e 7473 Acknowledgements │ │ │ │ │ +00018bd0: 222c 2061 6e64 2061 6e79 2073 6563 7469 ", and any secti │ │ │ │ │ +00018be0: 6f6e 7320 456e 7469 746c 6564 2022 4465 ons Entitled "De │ │ │ │ │ +00018bf0: 6469 6361 7469 6f6e 7322 2e20 2059 6f75 dications". You │ │ │ │ │ +00018c00: 0a20 2020 2020 6d75 7374 2064 656c 6574 . must delet │ │ │ │ │ +00018c10: 6520 616c 6c20 7365 6374 696f 6e73 2045 e all sections E │ │ │ │ │ +00018c20: 6e74 6974 6c65 6420 2245 6e64 6f72 7365 ntitled "Endorse │ │ │ │ │ +00018c30: 6d65 6e74 732e 220a 0a20 2036 2e20 434f ments.".. 6. CO │ │ │ │ │ +00018c40: 4c4c 4543 5449 4f4e 5320 4f46 2044 4f43 LLECTIONS OF DOC │ │ │ │ │ +00018c50: 554d 454e 5453 0a0a 2020 2020 2059 6f75 UMENTS.. You │ │ │ │ │ +00018c60: 206d 6179 206d 616b 6520 6120 636f 6c6c may make a coll │ │ │ │ │ +00018c70: 6563 7469 6f6e 2063 6f6e 7369 7374 696e ection consistin │ │ │ │ │ +00018c80: 6720 6f66 2074 6865 2044 6f63 756d 656e g of the Documen │ │ │ │ │ +00018c90: 7420 616e 6420 6f74 6865 720a 2020 2020 t and other. │ │ │ │ │ +00018ca0: 2064 6f63 756d 656e 7473 2072 656c 6561 documents relea │ │ │ │ │ +00018cb0: 7365 6420 756e 6465 7220 7468 6973 204c sed under this L │ │ │ │ │ +00018cc0: 6963 656e 7365 2c20 616e 6420 7265 706c icense, and repl │ │ │ │ │ +00018cd0: 6163 6520 7468 6520 696e 6469 7669 6475 ace the individu │ │ │ │ │ +00018ce0: 616c 0a20 2020 2020 636f 7069 6573 206f al. copies o │ │ │ │ │ +00018cf0: 6620 7468 6973 204c 6963 656e 7365 2069 f this License i │ │ │ │ │ +00018d00: 6e20 7468 6520 7661 7269 6f75 7320 646f n the various do │ │ │ │ │ +00018d10: 6375 6d65 6e74 7320 7769 7468 2061 2073 cuments with a s │ │ │ │ │ +00018d20: 696e 676c 6520 636f 7079 0a20 2020 2020 ingle copy. │ │ │ │ │ +00018d30: 7468 6174 2069 7320 696e 636c 7564 6564 that is included │ │ │ │ │ +00018d40: 2069 6e20 7468 6520 636f 6c6c 6563 7469 in the collecti │ │ │ │ │ +00018d50: 6f6e 2c20 7072 6f76 6964 6564 2074 6861 on, provided tha │ │ │ │ │ +00018d60: 7420 796f 7520 666f 6c6c 6f77 2074 6865 t you follow the │ │ │ │ │ +00018d70: 0a20 2020 2020 7275 6c65 7320 6f66 2074 . rules of t │ │ │ │ │ +00018d80: 6869 7320 4c69 6365 6e73 6520 666f 7220 his License for │ │ │ │ │ +00018d90: 7665 7262 6174 696d 2063 6f70 7969 6e67 verbatim copying │ │ │ │ │ +00018da0: 206f 6620 6561 6368 206f 6620 7468 6520 of each of the │ │ │ │ │ +00018db0: 646f 6375 6d65 6e74 730a 2020 2020 2069 documents. i │ │ │ │ │ +00018dc0: 6e20 616c 6c20 6f74 6865 7220 7265 7370 n all other resp │ │ │ │ │ +00018dd0: 6563 7473 2e0a 0a20 2020 2020 596f 7520 ects... You │ │ │ │ │ +00018de0: 6d61 7920 6578 7472 6163 7420 6120 7369 may extract a si │ │ │ │ │ +00018df0: 6e67 6c65 2064 6f63 756d 656e 7420 6672 ngle document fr │ │ │ │ │ +00018e00: 6f6d 2073 7563 6820 6120 636f 6c6c 6563 om such a collec │ │ │ │ │ +00018e10: 7469 6f6e 2c20 616e 640a 2020 2020 2064 tion, and. d │ │ │ │ │ +00018e20: 6973 7472 6962 7574 6520 6974 2069 6e64 istribute it ind │ │ │ │ │ +00018e30: 6976 6964 7561 6c6c 7920 756e 6465 7220 ividually under │ │ │ │ │ +00018e40: 7468 6973 204c 6963 656e 7365 2c20 7072 this License, pr │ │ │ │ │ +00018e50: 6f76 6964 6564 2079 6f75 2069 6e73 6572 ovided you inser │ │ │ │ │ +00018e60: 740a 2020 2020 2061 2063 6f70 7920 6f66 t. a copy of │ │ │ │ │ +00018e70: 2074 6869 7320 4c69 6365 6e73 6520 696e this License in │ │ │ │ │ +00018e80: 746f 2074 6865 2065 7874 7261 6374 6564 to the extracted │ │ │ │ │ +00018e90: 2064 6f63 756d 656e 742c 2061 6e64 2066 document, and f │ │ │ │ │ +00018ea0: 6f6c 6c6f 7720 7468 6973 0a20 2020 2020 ollow this. │ │ │ │ │ +00018eb0: 4c69 6365 6e73 6520 696e 2061 6c6c 206f License in all o │ │ │ │ │ +00018ec0: 7468 6572 2072 6573 7065 6374 7320 7265 ther respects re │ │ │ │ │ +00018ed0: 6761 7264 696e 6720 7665 7262 6174 696d garding verbatim │ │ │ │ │ +00018ee0: 2063 6f70 7969 6e67 206f 6620 7468 6174 copying of that │ │ │ │ │ +00018ef0: 0a20 2020 2020 646f 6375 6d65 6e74 2e0a . document.. │ │ │ │ │ +00018f00: 0a20 2037 2e20 4147 4752 4547 4154 494f . 7. AGGREGATIO │ │ │ │ │ +00018f10: 4e20 5749 5448 2049 4e44 4550 454e 4445 N WITH INDEPENDE │ │ │ │ │ +00018f20: 4e54 2057 4f52 4b53 0a0a 2020 2020 2041 NT WORKS.. A │ │ │ │ │ +00018f30: 2063 6f6d 7069 6c61 7469 6f6e 206f 6620 compilation of │ │ │ │ │ +00018f40: 7468 6520 446f 6375 6d65 6e74 206f 7220 the Document or │ │ │ │ │ +00018f50: 6974 7320 6465 7269 7661 7469 7665 7320 its derivatives │ │ │ │ │ +00018f60: 7769 7468 206f 7468 6572 0a20 2020 2020 with other. │ │ │ │ │ +00018f70: 7365 7061 7261 7465 2061 6e64 2069 6e64 separate and ind │ │ │ │ │ +00018f80: 6570 656e 6465 6e74 2064 6f63 756d 656e ependent documen │ │ │ │ │ +00018f90: 7473 206f 7220 776f 726b 732c 2069 6e20 ts or works, in │ │ │ │ │ +00018fa0: 6f72 206f 6e20 6120 766f 6c75 6d65 206f or on a volume o │ │ │ │ │ +00018fb0: 6620 610a 2020 2020 2073 746f 7261 6765 f a. storage │ │ │ │ │ +00018fc0: 206f 7220 6469 7374 7269 6275 7469 6f6e or distribution │ │ │ │ │ +00018fd0: 206d 6564 6975 6d2c 2069 7320 6361 6c6c medium, is call │ │ │ │ │ +00018fe0: 6564 2061 6e20 2261 6767 7265 6761 7465 ed an "aggregate │ │ │ │ │ +00018ff0: 2220 6966 2074 6865 0a20 2020 2020 636f " if the. co │ │ │ │ │ +00019000: 7079 7269 6768 7420 7265 7375 6c74 696e pyright resultin │ │ │ │ │ +00019010: 6720 6672 6f6d 2074 6865 2063 6f6d 7069 g from the compi │ │ │ │ │ +00019020: 6c61 7469 6f6e 2069 7320 6e6f 7420 7573 lation is not us │ │ │ │ │ +00019030: 6564 2074 6f20 6c69 6d69 7420 7468 650a ed to limit the. │ │ │ │ │ +00019040: 2020 2020 206c 6567 616c 2072 6967 6874 legal right │ │ │ │ │ +00019050: 7320 6f66 2074 6865 2063 6f6d 7069 6c61 s of the compila │ │ │ │ │ +00019060: 7469 6f6e 2773 2075 7365 7273 2062 6579 tion's users bey │ │ │ │ │ +00019070: 6f6e 6420 7768 6174 2074 6865 2069 6e64 ond what the ind │ │ │ │ │ +00019080: 6976 6964 7561 6c0a 2020 2020 2077 6f72 ividual. wor │ │ │ │ │ +00019090: 6b73 2070 6572 6d69 742e 2020 5768 656e ks permit. When │ │ │ │ │ +000190a0: 2074 6865 2044 6f63 756d 656e 7420 6973 the Document is │ │ │ │ │ +000190b0: 2069 6e63 6c75 6465 6420 696e 2061 6e20 included in an │ │ │ │ │ +000190c0: 6167 6772 6567 6174 652c 2074 6869 730a aggregate, this. │ │ │ │ │ +000190d0: 2020 2020 204c 6963 656e 7365 2064 6f65 License doe │ │ │ │ │ +000190e0: 7320 6e6f 7420 6170 706c 7920 746f 2074 s not apply to t │ │ │ │ │ +000190f0: 6865 206f 7468 6572 2077 6f72 6b73 2069 he other works i │ │ │ │ │ +00019100: 6e20 7468 6520 6167 6772 6567 6174 6520 n the aggregate │ │ │ │ │ +00019110: 7768 6963 680a 2020 2020 2061 7265 206e which. are n │ │ │ │ │ +00019120: 6f74 2074 6865 6d73 656c 7665 7320 6465 ot themselves de │ │ │ │ │ +00019130: 7269 7661 7469 7665 2077 6f72 6b73 206f rivative works o │ │ │ │ │ +00019140: 6620 7468 6520 446f 6375 6d65 6e74 2e0a f the Document.. │ │ │ │ │ +00019150: 0a20 2020 2020 4966 2074 6865 2043 6f76 . If the Cov │ │ │ │ │ +00019160: 6572 2054 6578 7420 7265 7175 6972 656d er Text requirem │ │ │ │ │ +00019170: 656e 7420 6f66 2073 6563 7469 6f6e 2033 ent of section 3 │ │ │ │ │ +00019180: 2069 7320 6170 706c 6963 6162 6c65 2074 is applicable t │ │ │ │ │ +00019190: 6f20 7468 6573 650a 2020 2020 2063 6f70 o these. cop │ │ │ │ │ +000191a0: 6965 7320 6f66 2074 6865 2044 6f63 756d ies of the Docum │ │ │ │ │ +000191b0: 656e 742c 2074 6865 6e20 6966 2074 6865 ent, then if the │ │ │ │ │ +000191c0: 2044 6f63 756d 656e 7420 6973 206c 6573 Document is les │ │ │ │ │ +000191d0: 7320 7468 616e 206f 6e65 2068 616c 660a s than one half. │ │ │ │ │ +000191e0: 2020 2020 206f 6620 7468 6520 656e 7469 of the enti │ │ │ │ │ +000191f0: 7265 2061 6767 7265 6761 7465 2c20 7468 re aggregate, th │ │ │ │ │ +00019200: 6520 446f 6375 6d65 6e74 2773 2043 6f76 e Document's Cov │ │ │ │ │ +00019210: 6572 2054 6578 7473 206d 6179 2062 6520 er Texts may be │ │ │ │ │ +00019220: 706c 6163 6564 0a20 2020 2020 6f6e 2063 placed. on c │ │ │ │ │ +00019230: 6f76 6572 7320 7468 6174 2062 7261 636b overs that brack │ │ │ │ │ +00019240: 6574 2074 6865 2044 6f63 756d 656e 7420 et the Document │ │ │ │ │ +00019250: 7769 7468 696e 2074 6865 2061 6767 7265 within the aggre │ │ │ │ │ +00019260: 6761 7465 2c20 6f72 2074 6865 0a20 2020 gate, or the. │ │ │ │ │ +00019270: 2020 656c 6563 7472 6f6e 6963 2065 7175 electronic equ │ │ │ │ │ +00019280: 6976 616c 656e 7420 6f66 2063 6f76 6572 ivalent of cover │ │ │ │ │ +00019290: 7320 6966 2074 6865 2044 6f63 756d 656e s if the Documen │ │ │ │ │ +000192a0: 7420 6973 2069 6e20 656c 6563 7472 6f6e t is in electron │ │ │ │ │ +000192b0: 6963 0a20 2020 2020 666f 726d 2e20 204f ic. form. O │ │ │ │ │ +000192c0: 7468 6572 7769 7365 2074 6865 7920 6d75 therwise they mu │ │ │ │ │ +000192d0: 7374 2061 7070 6561 7220 6f6e 2070 7269 st appear on pri │ │ │ │ │ +000192e0: 6e74 6564 2063 6f76 6572 7320 7468 6174 nted covers that │ │ │ │ │ +000192f0: 2062 7261 636b 6574 0a20 2020 2020 7468 bracket. th │ │ │ │ │ +00019300: 6520 7768 6f6c 6520 6167 6772 6567 6174 e whole aggregat │ │ │ │ │ +00019310: 652e 0a0a 2020 382e 2054 5241 4e53 4c41 e... 8. TRANSLA │ │ │ │ │ +00019320: 5449 4f4e 0a0a 2020 2020 2054 7261 6e73 TION.. Trans │ │ │ │ │ +00019330: 6c61 7469 6f6e 2069 7320 636f 6e73 6964 lation is consid │ │ │ │ │ +00019340: 6572 6564 2061 206b 696e 6420 6f66 206d ered a kind of m │ │ │ │ │ +00019350: 6f64 6966 6963 6174 696f 6e2c 2073 6f20 odification, so │ │ │ │ │ +00019360: 796f 7520 6d61 790a 2020 2020 2064 6973 you may. dis │ │ │ │ │ +00019370: 7472 6962 7574 6520 7472 616e 736c 6174 tribute translat │ │ │ │ │ +00019380: 696f 6e73 206f 6620 7468 6520 446f 6375 ions of the Docu │ │ │ │ │ +00019390: 6d65 6e74 2075 6e64 6572 2074 6865 2074 ment under the t │ │ │ │ │ +000193a0: 6572 6d73 206f 6620 7365 6374 696f 6e0a erms of section. │ │ │ │ │ +000193b0: 2020 2020 2034 2e20 2052 6570 6c61 6369 4. Replaci │ │ │ │ │ +000193c0: 6e67 2049 6e76 6172 6961 6e74 2053 6563 ng Invariant Sec │ │ │ │ │ +000193d0: 7469 6f6e 7320 7769 7468 2074 7261 6e73 tions with trans │ │ │ │ │ +000193e0: 6c61 7469 6f6e 7320 7265 7175 6972 6573 lations requires │ │ │ │ │ +000193f0: 2073 7065 6369 616c 0a20 2020 2020 7065 special. pe │ │ │ │ │ +00019400: 726d 6973 7369 6f6e 2066 726f 6d20 7468 rmission from th │ │ │ │ │ +00019410: 6569 7220 636f 7079 7269 6768 7420 686f eir copyright ho │ │ │ │ │ +00019420: 6c64 6572 732c 2062 7574 2079 6f75 206d lders, but you m │ │ │ │ │ +00019430: 6179 2069 6e63 6c75 6465 0a20 2020 2020 ay include. │ │ │ │ │ +00019440: 7472 616e 736c 6174 696f 6e73 206f 6620 translations of │ │ │ │ │ +00019450: 736f 6d65 206f 7220 616c 6c20 496e 7661 some or all Inva │ │ │ │ │ +00019460: 7269 616e 7420 5365 6374 696f 6e73 2069 riant Sections i │ │ │ │ │ +00019470: 6e20 6164 6469 7469 6f6e 2074 6f20 7468 n addition to th │ │ │ │ │ +00019480: 650a 2020 2020 206f 7269 6769 6e61 6c20 e. original │ │ │ │ │ +00019490: 7665 7273 696f 6e73 206f 6620 7468 6573 versions of thes │ │ │ │ │ +000194a0: 6520 496e 7661 7269 616e 7420 5365 6374 e Invariant Sect │ │ │ │ │ +000194b0: 696f 6e73 2e20 2059 6f75 206d 6179 2069 ions. You may i │ │ │ │ │ +000194c0: 6e63 6c75 6465 2061 0a20 2020 2020 7472 nclude a. tr │ │ │ │ │ +000194d0: 616e 736c 6174 696f 6e20 6f66 2074 6869 anslation of thi │ │ │ │ │ +000194e0: 7320 4c69 6365 6e73 652c 2061 6e64 2061 s License, and a │ │ │ │ │ +000194f0: 6c6c 2074 6865 206c 6963 656e 7365 206e ll the license n │ │ │ │ │ +00019500: 6f74 6963 6573 2069 6e20 7468 650a 2020 otices in the. │ │ │ │ │ +00019510: 2020 2044 6f63 756d 656e 742c 2061 6e64 Document, and │ │ │ │ │ +00019520: 2061 6e79 2057 6172 7261 6e74 7920 4469 any Warranty Di │ │ │ │ │ +00019530: 7363 6c61 696d 6572 732c 2070 726f 7669 sclaimers, provi │ │ │ │ │ +00019540: 6465 6420 7468 6174 2079 6f75 2061 6c73 ded that you als │ │ │ │ │ +00019550: 6f0a 2020 2020 2069 6e63 6c75 6465 2074 o. include t │ │ │ │ │ +00019560: 6865 206f 7269 6769 6e61 6c20 456e 676c he original Engl │ │ │ │ │ +00019570: 6973 6820 7665 7273 696f 6e20 6f66 2074 ish version of t │ │ │ │ │ +00019580: 6869 7320 4c69 6365 6e73 6520 616e 6420 his License and │ │ │ │ │ +00019590: 7468 650a 2020 2020 206f 7269 6769 6e61 the. origina │ │ │ │ │ +000195a0: 6c20 7665 7273 696f 6e73 206f 6620 7468 l versions of th │ │ │ │ │ +000195b0: 6f73 6520 6e6f 7469 6365 7320 616e 6420 ose notices and │ │ │ │ │ +000195c0: 6469 7363 6c61 696d 6572 732e 2020 496e disclaimers. In │ │ │ │ │ +000195d0: 2063 6173 6520 6f66 2061 0a20 2020 2020 case of a. │ │ │ │ │ +000195e0: 6469 7361 6772 6565 6d65 6e74 2062 6574 disagreement bet │ │ │ │ │ +000195f0: 7765 656e 2074 6865 2074 7261 6e73 6c61 ween the transla │ │ │ │ │ +00019600: 7469 6f6e 2061 6e64 2074 6865 206f 7269 tion and the ori │ │ │ │ │ +00019610: 6769 6e61 6c20 7665 7273 696f 6e20 6f66 ginal version of │ │ │ │ │ +00019620: 0a20 2020 2020 7468 6973 204c 6963 656e . this Licen │ │ │ │ │ +00019630: 7365 206f 7220 6120 6e6f 7469 6365 206f se or a notice o │ │ │ │ │ +00019640: 7220 6469 7363 6c61 696d 6572 2c20 7468 r disclaimer, th │ │ │ │ │ +00019650: 6520 6f72 6967 696e 616c 2076 6572 7369 e original versi │ │ │ │ │ +00019660: 6f6e 2077 696c 6c0a 2020 2020 2070 7265 on will. pre │ │ │ │ │ +00019670: 7661 696c 2e0a 0a20 2020 2020 4966 2061 vail... If a │ │ │ │ │ +00019680: 2073 6563 7469 6f6e 2069 6e20 7468 6520 section in the │ │ │ │ │ +00019690: 446f 6375 6d65 6e74 2069 7320 456e 7469 Document is Enti │ │ │ │ │ +000196a0: 746c 6564 2022 4163 6b6e 6f77 6c65 6467 tled "Acknowledg │ │ │ │ │ +000196b0: 656d 656e 7473 222c 0a20 2020 2020 2244 ements",. "D │ │ │ │ │ +000196c0: 6564 6963 6174 696f 6e73 222c 206f 7220 edications", or │ │ │ │ │ +000196d0: 2248 6973 746f 7279 222c 2074 6865 2072 "History", the r │ │ │ │ │ +000196e0: 6571 7569 7265 6d65 6e74 2028 7365 6374 equirement (sect │ │ │ │ │ +000196f0: 696f 6e20 3429 2074 6f0a 2020 2020 2050 ion 4) to. P │ │ │ │ │ +00019700: 7265 7365 7276 6520 6974 7320 5469 746c reserve its Titl │ │ │ │ │ +00019710: 6520 2873 6563 7469 6f6e 2031 2920 7769 e (section 1) wi │ │ │ │ │ +00019720: 6c6c 2074 7970 6963 616c 6c79 2072 6571 ll typically req │ │ │ │ │ +00019730: 7569 7265 2063 6861 6e67 696e 6720 7468 uire changing th │ │ │ │ │ +00019740: 650a 2020 2020 2061 6374 7561 6c20 7469 e. actual ti │ │ │ │ │ +00019750: 746c 652e 0a0a 2020 392e 2054 4552 4d49 tle... 9. TERMI │ │ │ │ │ +00019760: 4e41 5449 4f4e 0a0a 2020 2020 2059 6f75 NATION.. You │ │ │ │ │ +00019770: 206d 6179 206e 6f74 2063 6f70 792c 206d may not copy, m │ │ │ │ │ +00019780: 6f64 6966 792c 2073 7562 6c69 6365 6e73 odify, sublicens │ │ │ │ │ +00019790: 652c 206f 7220 6469 7374 7269 6275 7465 e, or distribute │ │ │ │ │ +000197a0: 2074 6865 2044 6f63 756d 656e 740a 2020 the Document. │ │ │ │ │ +000197b0: 2020 2065 7863 6570 7420 6173 2065 7870 except as exp │ │ │ │ │ +000197c0: 7265 7373 6c79 2070 726f 7669 6465 6420 ressly provided │ │ │ │ │ +000197d0: 666f 7220 756e 6465 7220 7468 6973 204c for under this L │ │ │ │ │ +000197e0: 6963 656e 7365 2e20 2041 6e79 206f 7468 icense. Any oth │ │ │ │ │ +000197f0: 6572 0a20 2020 2020 6174 7465 6d70 7420 er. attempt │ │ │ │ │ +00019800: 746f 2063 6f70 792c 206d 6f64 6966 792c to copy, modify, │ │ │ │ │ +00019810: 2073 7562 6c69 6365 6e73 6520 6f72 2064 sublicense or d │ │ │ │ │ +00019820: 6973 7472 6962 7574 6520 7468 6520 446f istribute the Do │ │ │ │ │ +00019830: 6375 6d65 6e74 2069 730a 2020 2020 2076 cument is. v │ │ │ │ │ +00019840: 6f69 642c 2061 6e64 2077 696c 6c20 6175 oid, and will au │ │ │ │ │ +00019850: 746f 6d61 7469 6361 6c6c 7920 7465 726d tomatically term │ │ │ │ │ +00019860: 696e 6174 6520 796f 7572 2072 6967 6874 inate your right │ │ │ │ │ +00019870: 7320 756e 6465 7220 7468 6973 0a20 2020 s under this. │ │ │ │ │ +00019880: 2020 4c69 6365 6e73 652e 2020 486f 7765 License. Howe │ │ │ │ │ +00019890: 7665 722c 2070 6172 7469 6573 2077 686f ver, parties who │ │ │ │ │ +000198a0: 2068 6176 6520 7265 6365 6976 6564 2063 have received c │ │ │ │ │ +000198b0: 6f70 6965 732c 206f 7220 7269 6768 7473 opies, or rights │ │ │ │ │ +000198c0: 2c0a 2020 2020 2066 726f 6d20 796f 7520 ,. from you │ │ │ │ │ +000198d0: 756e 6465 7220 7468 6973 204c 6963 656e under this Licen │ │ │ │ │ +000198e0: 7365 2077 696c 6c20 6e6f 7420 6861 7665 se will not have │ │ │ │ │ +000198f0: 2074 6865 6972 206c 6963 656e 7365 7320 their licenses │ │ │ │ │ +00019900: 7465 726d 696e 6174 6564 0a20 2020 2020 terminated. │ │ │ │ │ +00019910: 736f 206c 6f6e 6720 6173 2073 7563 6820 so long as such │ │ │ │ │ +00019920: 7061 7274 6965 7320 7265 6d61 696e 2069 parties remain i │ │ │ │ │ +00019930: 6e20 6675 6c6c 2063 6f6d 706c 6961 6e63 n full complianc │ │ │ │ │ +00019940: 652e 0a0a 2020 3130 2e20 4655 5455 5245 e... 10. FUTURE │ │ │ │ │ +00019950: 2052 4556 4953 494f 4e53 204f 4620 5448 REVISIONS OF TH │ │ │ │ │ +00019960: 4953 204c 4943 454e 5345 0a0a 2020 2020 IS LICENSE.. │ │ │ │ │ +00019970: 2054 6865 2046 7265 6520 536f 6674 7761 The Free Softwa │ │ │ │ │ +00019980: 7265 2046 6f75 6e64 6174 696f 6e20 6d61 re Foundation ma │ │ │ │ │ +00019990: 7920 7075 626c 6973 6820 6e65 772c 2072 y publish new, r │ │ │ │ │ +000199a0: 6576 6973 6564 2076 6572 7369 6f6e 7320 evised versions │ │ │ │ │ +000199b0: 6f66 0a20 2020 2020 7468 6520 474e 5520 of. the GNU │ │ │ │ │ +000199c0: 4672 6565 2044 6f63 756d 656e 7461 7469 Free Documentati │ │ │ │ │ +000199d0: 6f6e 204c 6963 656e 7365 2066 726f 6d20 on License from │ │ │ │ │ +000199e0: 7469 6d65 2074 6f20 7469 6d65 2e20 2053 time to time. S │ │ │ │ │ +000199f0: 7563 6820 6e65 770a 2020 2020 2076 6572 uch new. ver │ │ │ │ │ +00019a00: 7369 6f6e 7320 7769 6c6c 2062 6520 7369 sions will be si │ │ │ │ │ +00019a10: 6d69 6c61 7220 696e 2073 7069 7269 7420 milar in spirit │ │ │ │ │ +00019a20: 746f 2074 6865 2070 7265 7365 6e74 2076 to the present v │ │ │ │ │ +00019a30: 6572 7369 6f6e 2c20 6275 7420 6d61 790a ersion, but may. │ │ │ │ │ +00019a40: 2020 2020 2064 6966 6665 7220 696e 2064 differ in d │ │ │ │ │ +00019a50: 6574 6169 6c20 746f 2061 6464 7265 7373 etail to address │ │ │ │ │ +00019a60: 206e 6577 2070 726f 626c 656d 7320 6f72 new problems or │ │ │ │ │ +00019a70: 2063 6f6e 6365 726e 732e 2020 5365 650a concerns. See. │ │ │ │ │ +00019a80: 2020 2020 203c 6874 7470 3a2f 2f77 7777 ... Each │ │ │ │ │ +00019ab0: 7665 7273 696f 6e20 6f66 2074 6865 204c version of the L │ │ │ │ │ +00019ac0: 6963 656e 7365 2069 7320 6769 7665 6e20 icense is given │ │ │ │ │ +00019ad0: 6120 6469 7374 696e 6775 6973 6869 6e67 a distinguishing │ │ │ │ │ +00019ae0: 2076 6572 7369 6f6e 0a20 2020 2020 6e75 version. nu │ │ │ │ │ +00019af0: 6d62 6572 2e20 2049 6620 7468 6520 446f mber. If the Do │ │ │ │ │ +00019b00: 6375 6d65 6e74 2073 7065 6369 6669 6573 cument specifies │ │ │ │ │ +00019b10: 2074 6861 7420 6120 7061 7274 6963 756c that a particul │ │ │ │ │ +00019b20: 6172 206e 756d 6265 7265 640a 2020 2020 ar numbered. │ │ │ │ │ +00019b30: 2076 6572 7369 6f6e 206f 6620 7468 6973 version of this │ │ │ │ │ +00019b40: 204c 6963 656e 7365 2022 6f72 2061 6e79 License "or any │ │ │ │ │ +00019b50: 206c 6174 6572 2076 6572 7369 6f6e 2220 later version" │ │ │ │ │ +00019b60: 6170 706c 6965 7320 746f 2069 742c 2079 applies to it, y │ │ │ │ │ +00019b70: 6f75 0a20 2020 2020 6861 7665 2074 6865 ou. have the │ │ │ │ │ +00019b80: 206f 7074 696f 6e20 6f66 2066 6f6c 6c6f option of follo │ │ │ │ │ +00019b90: 7769 6e67 2074 6865 2074 6572 6d73 2061 wing the terms a │ │ │ │ │ +00019ba0: 6e64 2063 6f6e 6469 7469 6f6e 7320 6569 nd conditions ei │ │ │ │ │ +00019bb0: 7468 6572 206f 660a 2020 2020 2074 6861 ther of. tha │ │ │ │ │ +00019bc0: 7420 7370 6563 6966 6965 6420 7665 7273 t specified vers │ │ │ │ │ +00019bd0: 696f 6e20 6f72 206f 6620 616e 7920 6c61 ion or of any la │ │ │ │ │ +00019be0: 7465 7220 7665 7273 696f 6e20 7468 6174 ter version that │ │ │ │ │ +00019bf0: 2068 6173 2062 6565 6e0a 2020 2020 2070 has been. p │ │ │ │ │ +00019c00: 7562 6c69 7368 6564 2028 6e6f 7420 6173 ublished (not as │ │ │ │ │ +00019c10: 2061 2064 7261 6674 2920 6279 2074 6865 a draft) by the │ │ │ │ │ +00019c20: 2046 7265 6520 536f 6674 7761 7265 2046 Free Software F │ │ │ │ │ +00019c30: 6f75 6e64 6174 696f 6e2e 2020 4966 2074 oundation. If t │ │ │ │ │ +00019c40: 6865 0a20 2020 2020 446f 6375 6d65 6e74 he. Document │ │ │ │ │ +00019c50: 2064 6f65 7320 6e6f 7420 7370 6563 6966 does not specif │ │ │ │ │ +00019c60: 7920 6120 7665 7273 696f 6e20 6e75 6d62 y a version numb │ │ │ │ │ +00019c70: 6572 206f 6620 7468 6973 204c 6963 656e er of this Licen │ │ │ │ │ +00019c80: 7365 2c20 796f 7520 6d61 790a 2020 2020 se, you may. │ │ │ │ │ +00019c90: 2063 686f 6f73 6520 616e 7920 7665 7273 choose any vers │ │ │ │ │ +00019ca0: 696f 6e20 6576 6572 2070 7562 6c69 7368 ion ever publish │ │ │ │ │ +00019cb0: 6564 2028 6e6f 7420 6173 2061 2064 7261 ed (not as a dra │ │ │ │ │ +00019cc0: 6674 2920 6279 2074 6865 2046 7265 650a ft) by the Free. │ │ │ │ │ +00019cd0: 2020 2020 2053 6f66 7477 6172 6520 466f Software Fo │ │ │ │ │ +00019ce0: 756e 6461 7469 6f6e 2e0a 0a41 2e31 2e31 undation...A.1.1 │ │ │ │ │ +00019cf0: 2041 4444 454e 4455 4d3a 2048 6f77 2074 ADDENDUM: How t │ │ │ │ │ +00019d00: 6f20 7573 6520 7468 6973 204c 6963 656e o use this Licen │ │ │ │ │ +00019d10: 7365 2066 6f72 2079 6f75 7220 646f 6375 se for your docu │ │ │ │ │ +00019d20: 6d65 6e74 730a 2d2d 2d2d 2d2d 2d2d 2d2d ments.---------- │ │ │ │ │ 00019d30: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 00019d40: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 00019d50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00019d60: 2d2d 0a0a 546f 2075 7365 2074 6869 7320 --..To use this │ │ │ │ │ -00019d70: 4c69 6365 6e73 6520 696e 2061 2064 6f63 License in a doc │ │ │ │ │ -00019d80: 756d 656e 7420 796f 7520 6861 7665 2077 ument you have w │ │ │ │ │ -00019d90: 7269 7474 656e 2c20 696e 636c 7564 6520 ritten, include │ │ │ │ │ -00019da0: 6120 636f 7079 206f 660a 7468 6520 4c69 a copy of.the Li │ │ │ │ │ -00019db0: 6365 6e73 6520 696e 2074 6865 2064 6f63 cense in the doc │ │ │ │ │ -00019dc0: 756d 656e 7420 616e 6420 7075 7420 7468 ument and put th │ │ │ │ │ -00019dd0: 6520 666f 6c6c 6f77 696e 6720 636f 7079 e following copy │ │ │ │ │ -00019de0: 7269 6768 7420 616e 6420 6c69 6365 6e73 right and licens │ │ │ │ │ -00019df0: 650a 6e6f 7469 6365 7320 6a75 7374 2061 e.notices just a │ │ │ │ │ -00019e00: 6674 6572 2074 6865 2074 6974 6c65 2070 fter the title p │ │ │ │ │ -00019e10: 6167 653a 0a0a 2020 2020 2020 2043 6f70 age:.. Cop │ │ │ │ │ -00019e20: 7972 6967 6874 2028 4329 2020 5945 4152 yright (C) YEAR │ │ │ │ │ -00019e30: 2020 594f 5552 204e 414d 452e 0a20 2020 YOUR NAME.. │ │ │ │ │ -00019e40: 2020 2020 5065 726d 6973 7369 6f6e 2069 Permission i │ │ │ │ │ -00019e50: 7320 6772 616e 7465 6420 746f 2063 6f70 s granted to cop │ │ │ │ │ -00019e60: 792c 2064 6973 7472 6962 7574 6520 616e y, distribute an │ │ │ │ │ -00019e70: 642f 6f72 206d 6f64 6966 7920 7468 6973 d/or modify this │ │ │ │ │ -00019e80: 2064 6f63 756d 656e 740a 2020 2020 2020 document. │ │ │ │ │ -00019e90: 2075 6e64 6572 2074 6865 2074 6572 6d73 under the terms │ │ │ │ │ -00019ea0: 206f 6620 7468 6520 474e 5520 4672 6565 of the GNU Free │ │ │ │ │ -00019eb0: 2044 6f63 756d 656e 7461 7469 6f6e 204c Documentation L │ │ │ │ │ -00019ec0: 6963 656e 7365 2c20 5665 7273 696f 6e20 icense, Version │ │ │ │ │ -00019ed0: 312e 320a 2020 2020 2020 206f 7220 616e 1.2. or an │ │ │ │ │ -00019ee0: 7920 6c61 7465 7220 7665 7273 696f 6e20 y later version │ │ │ │ │ -00019ef0: 7075 626c 6973 6865 6420 6279 2074 6865 published by the │ │ │ │ │ -00019f00: 2046 7265 6520 536f 6674 7761 7265 2046 Free Software F │ │ │ │ │ -00019f10: 6f75 6e64 6174 696f 6e3b 0a20 2020 2020 oundation;. │ │ │ │ │ -00019f20: 2020 7769 7468 206e 6f20 496e 7661 7269 with no Invari │ │ │ │ │ -00019f30: 616e 7420 5365 6374 696f 6e73 2c20 6e6f ant Sections, no │ │ │ │ │ -00019f40: 2046 726f 6e74 2d43 6f76 6572 2054 6578 Front-Cover Tex │ │ │ │ │ -00019f50: 7473 2c20 616e 6420 6e6f 2042 6163 6b2d ts, and no Back- │ │ │ │ │ -00019f60: 436f 7665 720a 2020 2020 2020 2054 6578 Cover. Tex │ │ │ │ │ -00019f70: 7473 2e20 2041 2063 6f70 7920 6f66 2074 ts. A copy of t │ │ │ │ │ -00019f80: 6865 206c 6963 656e 7365 2069 7320 696e he license is in │ │ │ │ │ -00019f90: 636c 7564 6564 2069 6e20 7468 6520 7365 cluded in the se │ │ │ │ │ -00019fa0: 6374 696f 6e20 656e 7469 746c 6564 2060 ction entitled ` │ │ │ │ │ -00019fb0: 6047 4e55 0a20 2020 2020 2020 4672 6565 `GNU. Free │ │ │ │ │ -00019fc0: 2044 6f63 756d 656e 7461 7469 6f6e 204c Documentation L │ │ │ │ │ -00019fd0: 6963 656e 7365 2727 2e0a 0a20 2020 4966 icense''... If │ │ │ │ │ -00019fe0: 2079 6f75 2068 6176 6520 496e 7661 7269 you have Invari │ │ │ │ │ -00019ff0: 616e 7420 5365 6374 696f 6e73 2c20 4672 ant Sections, Fr │ │ │ │ │ -0001a000: 6f6e 742d 436f 7665 7220 5465 7874 7320 ont-Cover Texts │ │ │ │ │ -0001a010: 616e 6420 4261 636b 2d43 6f76 6572 0a54 and Back-Cover.T │ │ │ │ │ -0001a020: 6578 7473 2c20 7265 706c 6163 6520 7468 exts, replace th │ │ │ │ │ -0001a030: 6520 2277 6974 682e 2e2e 5465 7874 732e e "with...Texts. │ │ │ │ │ -0001a040: 2220 206c 696e 6520 7769 7468 2074 6869 " line with thi │ │ │ │ │ -0001a050: 733a 0a0a 2020 2020 2020 2020 2077 6974 s:.. wit │ │ │ │ │ -0001a060: 6820 7468 6520 496e 7661 7269 616e 7420 h the Invariant │ │ │ │ │ -0001a070: 5365 6374 696f 6e73 2062 6569 6e67 204c Sections being L │ │ │ │ │ -0001a080: 4953 5420 5448 4549 5220 5449 544c 4553 IST THEIR TITLES │ │ │ │ │ -0001a090: 2c20 7769 7468 0a20 2020 2020 2020 2020 , with. │ │ │ │ │ -0001a0a0: 7468 6520 4672 6f6e 742d 436f 7665 7220 the Front-Cover │ │ │ │ │ -0001a0b0: 5465 7874 7320 6265 696e 6720 4c49 5354 Texts being LIST │ │ │ │ │ -0001a0c0: 2c20 616e 6420 7769 7468 2074 6865 2042 , and with the B │ │ │ │ │ -0001a0d0: 6163 6b2d 436f 7665 7220 5465 7874 730a ack-Cover Texts. │ │ │ │ │ -0001a0e0: 2020 2020 2020 2020 2062 6569 6e67 204c being L │ │ │ │ │ -0001a0f0: 4953 542e 0a0a 2020 2049 6620 796f 7520 IST... If you │ │ │ │ │ -0001a100: 6861 7665 2049 6e76 6172 6961 6e74 2053 have Invariant S │ │ │ │ │ -0001a110: 6563 7469 6f6e 7320 7769 7468 6f75 7420 ections without │ │ │ │ │ -0001a120: 436f 7665 7220 5465 7874 732c 206f 7220 Cover Texts, or │ │ │ │ │ -0001a130: 736f 6d65 206f 7468 6572 0a63 6f6d 6269 some other.combi │ │ │ │ │ -0001a140: 6e61 7469 6f6e 206f 6620 7468 6520 7468 nation of the th │ │ │ │ │ -0001a150: 7265 652c 206d 6572 6765 2074 686f 7365 ree, merge those │ │ │ │ │ -0001a160: 2074 776f 2061 6c74 6572 6e61 7469 7665 two alternative │ │ │ │ │ -0001a170: 7320 746f 2073 7569 7420 7468 650a 7369 s to suit the.si │ │ │ │ │ -0001a180: 7475 6174 696f 6e2e 0a0a 2020 2049 6620 tuation... If │ │ │ │ │ -0001a190: 796f 7572 2064 6f63 756d 656e 7420 636f your document co │ │ │ │ │ -0001a1a0: 6e74 6169 6e73 206e 6f6e 7472 6976 6961 ntains nontrivia │ │ │ │ │ -0001a1b0: 6c20 6578 616d 706c 6573 206f 6620 7072 l examples of pr │ │ │ │ │ -0001a1c0: 6f67 7261 6d20 636f 6465 2c20 7765 0a72 ogram code, we.r │ │ │ │ │ -0001a1d0: 6563 6f6d 6d65 6e64 2072 656c 6561 7369 ecommend releasi │ │ │ │ │ -0001a1e0: 6e67 2074 6865 7365 2065 7861 6d70 6c65 ng these example │ │ │ │ │ -0001a1f0: 7320 696e 2070 6172 616c 6c65 6c20 756e s in parallel un │ │ │ │ │ -0001a200: 6465 7220 796f 7572 2063 686f 6963 6520 der your choice │ │ │ │ │ -0001a210: 6f66 2066 7265 650a 736f 6674 7761 7265 of free.software │ │ │ │ │ -0001a220: 206c 6963 656e 7365 2c20 7375 6368 2061 license, such a │ │ │ │ │ -0001a230: 7320 7468 6520 474e 5520 4765 6e65 7261 s the GNU Genera │ │ │ │ │ -0001a240: 6c20 5075 626c 6963 204c 6963 656e 7365 l Public License │ │ │ │ │ -0001a250: 2c20 746f 2070 6572 6d69 740a 7468 6569 , to permit.thei │ │ │ │ │ -0001a260: 7220 7573 6520 696e 2066 7265 6520 736f r use in free so │ │ │ │ │ -0001a270: 6674 7761 7265 2e0a 0a1f 0a46 696c 653a ftware.....File: │ │ │ │ │ -0001a280: 2067 7275 622d 6465 762e 696e 666f 2c20 grub-dev.info, │ │ │ │ │ -0001a290: 204e 6f64 653a 2049 6e64 6578 2c20 2050 Node: Index, P │ │ │ │ │ -0001a2a0: 7265 763a 2043 6f70 7969 6e67 2054 6869 rev: Copying Thi │ │ │ │ │ -0001a2b0: 7320 4d61 6e75 616c 2c20 2055 703a 2054 s Manual, Up: T │ │ │ │ │ -0001a2c0: 6f70 0a0a 496e 6465 780a 2a2a 2a2a 2a0a op..Index.*****. │ │ │ │ │ -0001a2d0: 0a00 085b 696e 6465 7800 085d 0a2a 204d ...[index..].* M │ │ │ │ │ -0001a2e0: 656e 753a 0a0a 2a20 4644 4c2c 2047 4e55 enu:..* FDL, GNU │ │ │ │ │ -0001a2f0: 2046 7265 6520 446f 6375 6d65 6e74 6174 Free Documentat │ │ │ │ │ -0001a300: 696f 6e20 4c69 6365 6e73 653a 2020 2047 ion License: G │ │ │ │ │ -0001a310: 4e55 2046 7265 6520 446f 6375 6d65 6e74 NU Free Document │ │ │ │ │ -0001a320: 6174 696f 6e20 4c69 6365 6e73 652e 0a20 ation License.. │ │ │ │ │ +00019d60: 0a0a 546f 2075 7365 2074 6869 7320 4c69 ..To use this Li │ │ │ │ │ +00019d70: 6365 6e73 6520 696e 2061 2064 6f63 756d cense in a docum │ │ │ │ │ +00019d80: 656e 7420 796f 7520 6861 7665 2077 7269 ent you have wri │ │ │ │ │ +00019d90: 7474 656e 2c20 696e 636c 7564 6520 6120 tten, include a │ │ │ │ │ +00019da0: 636f 7079 206f 660a 7468 6520 4c69 6365 copy of.the Lice │ │ │ │ │ +00019db0: 6e73 6520 696e 2074 6865 2064 6f63 756d nse in the docum │ │ │ │ │ +00019dc0: 656e 7420 616e 6420 7075 7420 7468 6520 ent and put the │ │ │ │ │ +00019dd0: 666f 6c6c 6f77 696e 6720 636f 7079 7269 following copyri │ │ │ │ │ +00019de0: 6768 7420 616e 6420 6c69 6365 6e73 650a ght and license. │ │ │ │ │ +00019df0: 6e6f 7469 6365 7320 6a75 7374 2061 6674 notices just aft │ │ │ │ │ +00019e00: 6572 2074 6865 2074 6974 6c65 2070 6167 er the title pag │ │ │ │ │ +00019e10: 653a 0a0a 2020 2020 2020 2043 6f70 7972 e:.. Copyr │ │ │ │ │ +00019e20: 6967 6874 2028 4329 2020 5945 4152 2020 ight (C) YEAR │ │ │ │ │ +00019e30: 594f 5552 204e 414d 452e 0a20 2020 2020 YOUR NAME.. │ │ │ │ │ +00019e40: 2020 5065 726d 6973 7369 6f6e 2069 7320 Permission is │ │ │ │ │ +00019e50: 6772 616e 7465 6420 746f 2063 6f70 792c granted to copy, │ │ │ │ │ +00019e60: 2064 6973 7472 6962 7574 6520 616e 642f distribute and/ │ │ │ │ │ +00019e70: 6f72 206d 6f64 6966 7920 7468 6973 2064 or modify this d │ │ │ │ │ +00019e80: 6f63 756d 656e 740a 2020 2020 2020 2075 ocument. u │ │ │ │ │ +00019e90: 6e64 6572 2074 6865 2074 6572 6d73 206f nder the terms o │ │ │ │ │ +00019ea0: 6620 7468 6520 474e 5520 4672 6565 2044 f the GNU Free D │ │ │ │ │ +00019eb0: 6f63 756d 656e 7461 7469 6f6e 204c 6963 ocumentation Lic │ │ │ │ │ +00019ec0: 656e 7365 2c20 5665 7273 696f 6e20 312e ense, Version 1. │ │ │ │ │ +00019ed0: 320a 2020 2020 2020 206f 7220 616e 7920 2. or any │ │ │ │ │ +00019ee0: 6c61 7465 7220 7665 7273 696f 6e20 7075 later version pu │ │ │ │ │ +00019ef0: 626c 6973 6865 6420 6279 2074 6865 2046 blished by the F │ │ │ │ │ +00019f00: 7265 6520 536f 6674 7761 7265 2046 6f75 ree Software Fou │ │ │ │ │ +00019f10: 6e64 6174 696f 6e3b 0a20 2020 2020 2020 ndation;. │ │ │ │ │ +00019f20: 7769 7468 206e 6f20 496e 7661 7269 616e with no Invarian │ │ │ │ │ +00019f30: 7420 5365 6374 696f 6e73 2c20 6e6f 2046 t Sections, no F │ │ │ │ │ +00019f40: 726f 6e74 2d43 6f76 6572 2054 6578 7473 ront-Cover Texts │ │ │ │ │ +00019f50: 2c20 616e 6420 6e6f 2042 6163 6b2d 436f , and no Back-Co │ │ │ │ │ +00019f60: 7665 720a 2020 2020 2020 2054 6578 7473 ver. Texts │ │ │ │ │ +00019f70: 2e20 2041 2063 6f70 7920 6f66 2074 6865 . A copy of the │ │ │ │ │ +00019f80: 206c 6963 656e 7365 2069 7320 696e 636c license is incl │ │ │ │ │ +00019f90: 7564 6564 2069 6e20 7468 6520 7365 6374 uded in the sect │ │ │ │ │ +00019fa0: 696f 6e20 656e 7469 746c 6564 2060 6047 ion entitled ``G │ │ │ │ │ +00019fb0: 4e55 0a20 2020 2020 2020 4672 6565 2044 NU. Free D │ │ │ │ │ +00019fc0: 6f63 756d 656e 7461 7469 6f6e 204c 6963 ocumentation Lic │ │ │ │ │ +00019fd0: 656e 7365 2727 2e0a 0a20 2020 4966 2079 ense''... If y │ │ │ │ │ +00019fe0: 6f75 2068 6176 6520 496e 7661 7269 616e ou have Invarian │ │ │ │ │ +00019ff0: 7420 5365 6374 696f 6e73 2c20 4672 6f6e t Sections, Fron │ │ │ │ │ +0001a000: 742d 436f 7665 7220 5465 7874 7320 616e t-Cover Texts an │ │ │ │ │ +0001a010: 6420 4261 636b 2d43 6f76 6572 0a54 6578 d Back-Cover.Tex │ │ │ │ │ +0001a020: 7473 2c20 7265 706c 6163 6520 7468 6520 ts, replace the │ │ │ │ │ +0001a030: 2277 6974 682e 2e2e 5465 7874 732e 2220 "with...Texts." │ │ │ │ │ +0001a040: 206c 696e 6520 7769 7468 2074 6869 733a line with this: │ │ │ │ │ +0001a050: 0a0a 2020 2020 2020 2020 2077 6974 6820 .. with │ │ │ │ │ +0001a060: 7468 6520 496e 7661 7269 616e 7420 5365 the Invariant Se │ │ │ │ │ +0001a070: 6374 696f 6e73 2062 6569 6e67 204c 4953 ctions being LIS │ │ │ │ │ +0001a080: 5420 5448 4549 5220 5449 544c 4553 2c20 T THEIR TITLES, │ │ │ │ │ +0001a090: 7769 7468 0a20 2020 2020 2020 2020 7468 with. th │ │ │ │ │ +0001a0a0: 6520 4672 6f6e 742d 436f 7665 7220 5465 e Front-Cover Te │ │ │ │ │ +0001a0b0: 7874 7320 6265 696e 6720 4c49 5354 2c20 xts being LIST, │ │ │ │ │ +0001a0c0: 616e 6420 7769 7468 2074 6865 2042 6163 and with the Bac │ │ │ │ │ +0001a0d0: 6b2d 436f 7665 7220 5465 7874 730a 2020 k-Cover Texts. │ │ │ │ │ +0001a0e0: 2020 2020 2020 2062 6569 6e67 204c 4953 being LIS │ │ │ │ │ +0001a0f0: 542e 0a0a 2020 2049 6620 796f 7520 6861 T... If you ha │ │ │ │ │ +0001a100: 7665 2049 6e76 6172 6961 6e74 2053 6563 ve Invariant Sec │ │ │ │ │ +0001a110: 7469 6f6e 7320 7769 7468 6f75 7420 436f tions without Co │ │ │ │ │ +0001a120: 7665 7220 5465 7874 732c 206f 7220 736f ver Texts, or so │ │ │ │ │ +0001a130: 6d65 206f 7468 6572 0a63 6f6d 6269 6e61 me other.combina │ │ │ │ │ +0001a140: 7469 6f6e 206f 6620 7468 6520 7468 7265 tion of the thre │ │ │ │ │ +0001a150: 652c 206d 6572 6765 2074 686f 7365 2074 e, merge those t │ │ │ │ │ +0001a160: 776f 2061 6c74 6572 6e61 7469 7665 7320 wo alternatives │ │ │ │ │ +0001a170: 746f 2073 7569 7420 7468 650a 7369 7475 to suit the.situ │ │ │ │ │ +0001a180: 6174 696f 6e2e 0a0a 2020 2049 6620 796f ation... If yo │ │ │ │ │ +0001a190: 7572 2064 6f63 756d 656e 7420 636f 6e74 ur document cont │ │ │ │ │ +0001a1a0: 6169 6e73 206e 6f6e 7472 6976 6961 6c20 ains nontrivial │ │ │ │ │ +0001a1b0: 6578 616d 706c 6573 206f 6620 7072 6f67 examples of prog │ │ │ │ │ +0001a1c0: 7261 6d20 636f 6465 2c20 7765 0a72 6563 ram code, we.rec │ │ │ │ │ +0001a1d0: 6f6d 6d65 6e64 2072 656c 6561 7369 6e67 ommend releasing │ │ │ │ │ +0001a1e0: 2074 6865 7365 2065 7861 6d70 6c65 7320 these examples │ │ │ │ │ +0001a1f0: 696e 2070 6172 616c 6c65 6c20 756e 6465 in parallel unde │ │ │ │ │ +0001a200: 7220 796f 7572 2063 686f 6963 6520 6f66 r your choice of │ │ │ │ │ +0001a210: 2066 7265 650a 736f 6674 7761 7265 206c free.software l │ │ │ │ │ +0001a220: 6963 656e 7365 2c20 7375 6368 2061 7320 icense, such as │ │ │ │ │ +0001a230: 7468 6520 474e 5520 4765 6e65 7261 6c20 the GNU General │ │ │ │ │ +0001a240: 5075 626c 6963 204c 6963 656e 7365 2c20 Public License, │ │ │ │ │ +0001a250: 746f 2070 6572 6d69 740a 7468 6569 7220 to permit.their │ │ │ │ │ +0001a260: 7573 6520 696e 2066 7265 6520 736f 6674 use in free soft │ │ │ │ │ +0001a270: 7761 7265 2e0a 0a1f 0a46 696c 653a 2067 ware.....File: g │ │ │ │ │ +0001a280: 7275 622d 6465 762e 696e 666f 2c20 204e rub-dev.info, N │ │ │ │ │ +0001a290: 6f64 653a 2049 6e64 6578 2c20 2050 7265 ode: Index, Pre │ │ │ │ │ +0001a2a0: 763a 2043 6f70 7969 6e67 2054 6869 7320 v: Copying This │ │ │ │ │ +0001a2b0: 4d61 6e75 616c 2c20 2055 703a 2054 6f70 Manual, Up: Top │ │ │ │ │ +0001a2c0: 0a0a 496e 6465 780a 2a2a 2a2a 2a0a 0a00 ..Index.*****... │ │ │ │ │ +0001a2d0: 085b 696e 6465 7800 085d 0a2a 204d 656e .[index..].* Men │ │ │ │ │ +0001a2e0: 753a 0a0a 2a20 4644 4c2c 2047 4e55 2046 u:..* FDL, GNU F │ │ │ │ │ +0001a2f0: 7265 6520 446f 6375 6d65 6e74 6174 696f ree Documentatio │ │ │ │ │ +0001a300: 6e20 4c69 6365 6e73 653a 2020 2047 4e55 n License: GNU │ │ │ │ │ +0001a310: 2046 7265 6520 446f 6375 6d65 6e74 6174 Free Documentat │ │ │ │ │ +0001a320: 696f 6e20 4c69 6365 6e73 652e 0a20 2020 ion License.. │ │ │ │ │ 0001a330: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0001a340: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0001a350: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0001a360: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ │ -0001a370: 6c69 6e65 2036 290a 0a0a 1f0a 5461 6720 line 6).....Tag │ │ │ │ │ -0001a380: 5461 626c 653a 0a4e 6f64 653a 2054 6f70 Table:.Node: Top │ │ │ │ │ -0001a390: 7f36 3431 0a4e 6f64 653a 2047 6574 7469 .641.Node: Getti │ │ │ │ │ -0001a3a0: 6e67 2074 6865 2073 6f75 7263 6520 636f ng the source co │ │ │ │ │ -0001a3b0: 6465 7f31 3830 380a 4e6f 6465 3a20 436f de.1808.Node: Co │ │ │ │ │ -0001a3c0: 6469 6e67 2073 7479 6c65 7f32 3736 390a ding style.2769. │ │ │ │ │ -0001a3d0: 4e6f 6465 3a20 4e61 6d69 6e67 2043 6f6e Node: Naming Con │ │ │ │ │ -0001a3e0: 7665 6e74 696f 6e73 7f33 3137 380a 4e6f ventions.3178.No │ │ │ │ │ -0001a3f0: 6465 3a20 4675 6e63 7469 6f6e 737f 3334 de: Functions.34 │ │ │ │ │ -0001a400: 3633 0a4e 6f64 653a 2056 6172 6961 626c 63.Node: Variabl │ │ │ │ │ -0001a410: 6573 7f34 3333 370a 4e6f 6465 3a20 5479 es.4337.Node: Ty │ │ │ │ │ -0001a420: 7065 737f 3534 3532 0a4e 6f64 653a 204d pes.5452.Node: M │ │ │ │ │ -0001a430: 6163 726f 737f 3630 3533 0a4e 6f64 653a acros.6053.Node: │ │ │ │ │ -0001a440: 2043 6f6d 6d65 6e74 737f 3633 3835 0a4e Comments.6385.N │ │ │ │ │ -0001a450: 6f64 653a 204d 756c 7469 2d4c 696e 6520 ode: Multi-Line │ │ │ │ │ -0001a460: 436f 6d6d 656e 7473 7f36 3939 340a 4e6f Comments.6994.No │ │ │ │ │ -0001a470: 6465 3a20 4669 6e64 696e 6720 796f 7572 de: Finding your │ │ │ │ │ -0001a480: 2077 6179 2061 726f 756e 647f 3739 3139 way around.7919 │ │ │ │ │ -0001a490: 0a4e 6f64 653a 2043 6f6e 7472 6962 7574 .Node: Contribut │ │ │ │ │ -0001a4a0: 696e 6720 4368 616e 6765 737f 3131 3233 ing Changes.1123 │ │ │ │ │ -0001a4b0: 350a 4e6f 6465 3a20 4765 7474 696e 6720 5.Node: Getting │ │ │ │ │ -0001a4c0: 7374 6172 7465 647f 3132 3334 300a 4e6f started.12340.No │ │ │ │ │ -0001a4d0: 6465 3a20 5479 7069 6361 6c20 4465 7665 de: Typical Deve │ │ │ │ │ -0001a4e0: 6c6f 7065 7220 4578 7065 7269 656e 6365 loper Experience │ │ │ │ │ -0001a4f0: 7f31 3633 3932 0a4e 6f64 653a 2057 6865 .16392.Node: Whe │ │ │ │ │ -0001a500: 6e20 796f 7520 6172 6520 6170 7072 6f76 n you are approv │ │ │ │ │ -0001a510: 6564 2066 6f72 2077 7269 7465 2061 6363 ed for write acc │ │ │ │ │ -0001a520: 6573 7320 746f 2070 726f 6a65 6374 2773 ess to project's │ │ │ │ │ -0001a530: 2066 696c 6573 7f31 3734 3334 0a4e 6f64 files.17434.Nod │ │ │ │ │ -0001a540: 653a 2055 7064 6174 696e 6720 4578 7465 e: Updating Exte │ │ │ │ │ -0001a550: 726e 616c 2043 6f64 657f 3138 3836 370a rnal Code.18867. │ │ │ │ │ -0001a560: 4e6f 6465 3a20 476e 756c 6962 7f31 3931 Node: Gnulib.191 │ │ │ │ │ -0001a570: 3539 0a4e 6f64 653a 206a 736d 6e7f 3231 59.Node: jsmn.21 │ │ │ │ │ -0001a580: 3135 320a 4e6f 6465 3a20 6d69 6e69 6c7a 152.Node: minilz │ │ │ │ │ -0001a590: 6f7f 3231 3632 330a 4e6f 6465 3a20 506f o.21623.Node: Po │ │ │ │ │ -0001a5a0: 7274 696e 677f 3232 3332 390a 4e6f 6465 rting.22329.Node │ │ │ │ │ -0001a5b0: 3a20 4572 726f 7220 4861 6e64 6c69 6e67 : Error Handling │ │ │ │ │ -0001a5c0: 7f33 3430 3934 0a4e 6f64 653a 2053 7461 .34094.Node: Sta │ │ │ │ │ -0001a5d0: 636b 2061 6e64 2068 6561 7020 7369 7a65 ck and heap size │ │ │ │ │ -0001a5e0: 7f33 3931 3836 0a4e 6f64 653a 2042 494f .39186.Node: BIO │ │ │ │ │ -0001a5f0: 5320 706f 7274 206d 656d 6f72 7920 6d61 S port memory ma │ │ │ │ │ -0001a600: 707f 3431 3831 390a 4e6f 6465 3a20 5669 p.41819.Node: Vi │ │ │ │ │ -0001a610: 6465 6f20 5375 6273 7973 7465 6d7f 3432 deo Subsystem.42 │ │ │ │ │ -0001a620: 3636 380a 4e6f 6465 3a20 5669 6465 6f20 668.Node: Video │ │ │ │ │ -0001a630: 4150 497f 3433 3134 320a 4e6f 6465 3a20 API.43142.Node: │ │ │ │ │ -0001a640: 4578 616d 706c 6520 7573 6167 6520 6f66 Example usage of │ │ │ │ │ -0001a650: 2056 6964 656f 2041 5049 7f36 3335 3931 Video API.63591 │ │ │ │ │ -0001a660: 0a4e 6f64 653a 2042 6974 6d61 7020 4150 .Node: Bitmap AP │ │ │ │ │ -0001a670: 497f 3635 3137 310a 4e6f 6465 3a20 5046 I.65171.Node: PF │ │ │ │ │ -0001a680: 4632 2046 6f6e 7420 4669 6c65 2046 6f72 F2 Font File For │ │ │ │ │ -0001a690: 6d61 747f 3637 3730 340a 4e6f 6465 3a20 mat.67704.Node: │ │ │ │ │ -0001a6a0: 496e 7472 6f64 7563 7469 6f6e 7f36 3739 Introduction.679 │ │ │ │ │ -0001a6b0: 3434 0a4e 6f64 653a 2046 696c 6520 5374 44.Node: File St │ │ │ │ │ -0001a6c0: 7275 6374 7572 657f 3639 3434 370a 4e6f ructure.69447.No │ │ │ │ │ -0001a6d0: 6465 3a20 466f 6e74 204d 6574 7269 6373 de: Font Metrics │ │ │ │ │ -0001a6e0: 7f37 3433 3635 0a4e 6f64 653a 2047 7261 .74365.Node: Gra │ │ │ │ │ -0001a6f0: 7068 6963 616c 204d 656e 7520 536f 6674 phical Menu Soft │ │ │ │ │ -0001a700: 7761 7265 2044 6573 6967 6e7f 3735 3531 ware Design.7551 │ │ │ │ │ -0001a710: 340a 4e6f 6465 3a20 496e 7472 6f64 7563 4.Node: Introduc │ │ │ │ │ -0001a720: 7469 6f6e 5f32 7f37 3538 3036 0a4e 6f64 tion_2.75806.Nod │ │ │ │ │ -0001a730: 653a 2053 7461 7274 7570 2053 6571 7565 e: Startup Seque │ │ │ │ │ -0001a740: 6e63 657f 3736 3534 300a 4e6f 6465 3a20 nce.76540.Node: │ │ │ │ │ -0001a750: 4755 4920 436f 6d70 6f6e 656e 7473 7f37 GUI Components.7 │ │ │ │ │ -0001a760: 3733 3931 0a4e 6f64 653a 2043 6f6d 6d61 7391.Node: Comma │ │ │ │ │ -0001a770: 6e64 204c 696e 6520 5769 6e64 6f77 7f37 nd Line Window.7 │ │ │ │ │ -0001a780: 3939 3931 0a4e 6f64 653a 2056 6572 6966 9991.Node: Verif │ │ │ │ │ -0001a790: 6965 7273 2066 7261 6d65 776f 726b 7f38 iers framework.8 │ │ │ │ │ -0001a7a0: 3039 3433 0a4e 6f64 653a 204c 6f63 6b64 0943.Node: Lockd │ │ │ │ │ -0001a7b0: 6f77 6e20 6672 616d 6577 6f72 6b7f 3833 own framework.83 │ │ │ │ │ -0001a7c0: 3535 300a 4e6f 6465 3a20 436f 7079 696e 550.Node: Copyin │ │ │ │ │ -0001a7d0: 6720 5468 6973 204d 616e 7561 6c7f 3834 g This Manual.84 │ │ │ │ │ -0001a7e0: 3439 320a 4e6f 6465 3a20 474e 5520 4672 492.Node: GNU Fr │ │ │ │ │ -0001a7f0: 6565 2044 6f63 756d 656e 7461 7469 6f6e ee Documentation │ │ │ │ │ -0001a800: 204c 6963 656e 7365 7f38 3437 3336 0a4e License.84736.N │ │ │ │ │ -0001a810: 6f64 653a 2049 6e64 6578 7f31 3037 3132 ode: Index.10712 │ │ │ │ │ -0001a820: 390a 1f0a 456e 6420 5461 6720 5461 626c 9...End Tag Tabl │ │ │ │ │ -0001a830: 650a 0a1f 0a4c 6f63 616c 2056 6172 6961 e....Local Varia │ │ │ │ │ -0001a840: 626c 6573 3a0a 636f 6469 6e67 3a20 7574 bles:.coding: ut │ │ │ │ │ -0001a850: 662d 380a 456e 643a 0a f-8.End:. │ │ │ │ │ +0001a360: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ +0001a370: 6e65 2036 290a 0a0a 1f0a 5461 6720 5461 ne 6).....Tag Ta │ │ │ │ │ +0001a380: 626c 653a 0a4e 6f64 653a 2054 6f70 7f36 ble:.Node: Top.6 │ │ │ │ │ +0001a390: 3430 0a4e 6f64 653a 2047 6574 7469 6e67 40.Node: Getting │ │ │ │ │ +0001a3a0: 2074 6865 2073 6f75 7263 6520 636f 6465 the source code │ │ │ │ │ +0001a3b0: 7f31 3830 360a 4e6f 6465 3a20 436f 6469 .1806.Node: Codi │ │ │ │ │ +0001a3c0: 6e67 2073 7479 6c65 7f32 3736 370a 4e6f ng style.2767.No │ │ │ │ │ +0001a3d0: 6465 3a20 4e61 6d69 6e67 2043 6f6e 7665 de: Naming Conve │ │ │ │ │ +0001a3e0: 6e74 696f 6e73 7f33 3137 360a 4e6f 6465 ntions.3176.Node │ │ │ │ │ +0001a3f0: 3a20 4675 6e63 7469 6f6e 737f 3334 3631 : Functions.3461 │ │ │ │ │ +0001a400: 0a4e 6f64 653a 2056 6172 6961 626c 6573 .Node: Variables │ │ │ │ │ +0001a410: 7f34 3333 350a 4e6f 6465 3a20 5479 7065 .4335.Node: Type │ │ │ │ │ +0001a420: 737f 3534 3530 0a4e 6f64 653a 204d 6163 s.5450.Node: Mac │ │ │ │ │ +0001a430: 726f 737f 3630 3531 0a4e 6f64 653a 2043 ros.6051.Node: C │ │ │ │ │ +0001a440: 6f6d 6d65 6e74 737f 3633 3833 0a4e 6f64 omments.6383.Nod │ │ │ │ │ +0001a450: 653a 204d 756c 7469 2d4c 696e 6520 436f e: Multi-Line Co │ │ │ │ │ +0001a460: 6d6d 656e 7473 7f36 3939 320a 4e6f 6465 mments.6992.Node │ │ │ │ │ +0001a470: 3a20 4669 6e64 696e 6720 796f 7572 2077 : Finding your w │ │ │ │ │ +0001a480: 6179 2061 726f 756e 647f 3739 3137 0a4e ay around.7917.N │ │ │ │ │ +0001a490: 6f64 653a 2043 6f6e 7472 6962 7574 696e ode: Contributin │ │ │ │ │ +0001a4a0: 6720 4368 616e 6765 737f 3131 3233 330a g Changes.11233. │ │ │ │ │ +0001a4b0: 4e6f 6465 3a20 4765 7474 696e 6720 7374 Node: Getting st │ │ │ │ │ +0001a4c0: 6172 7465 647f 3132 3333 380a 4e6f 6465 arted.12338.Node │ │ │ │ │ +0001a4d0: 3a20 5479 7069 6361 6c20 4465 7665 6c6f : Typical Develo │ │ │ │ │ +0001a4e0: 7065 7220 4578 7065 7269 656e 6365 7f31 per Experience.1 │ │ │ │ │ +0001a4f0: 3633 3930 0a4e 6f64 653a 2057 6865 6e20 6390.Node: When │ │ │ │ │ +0001a500: 796f 7520 6172 6520 6170 7072 6f76 6564 you are approved │ │ │ │ │ +0001a510: 2066 6f72 2077 7269 7465 2061 6363 6573 for write acces │ │ │ │ │ +0001a520: 7320 746f 2070 726f 6a65 6374 2773 2066 s to project's f │ │ │ │ │ +0001a530: 696c 6573 7f31 3734 3332 0a4e 6f64 653a iles.17432.Node: │ │ │ │ │ +0001a540: 2055 7064 6174 696e 6720 4578 7465 726e Updating Extern │ │ │ │ │ +0001a550: 616c 2043 6f64 657f 3138 3836 350a 4e6f al Code.18865.No │ │ │ │ │ +0001a560: 6465 3a20 476e 756c 6962 7f31 3931 3537 de: Gnulib.19157 │ │ │ │ │ +0001a570: 0a4e 6f64 653a 206a 736d 6e7f 3231 3135 .Node: jsmn.2115 │ │ │ │ │ +0001a580: 300a 4e6f 6465 3a20 6d69 6e69 6c7a 6f7f 0.Node: minilzo. │ │ │ │ │ +0001a590: 3231 3632 310a 4e6f 6465 3a20 506f 7274 21621.Node: Port │ │ │ │ │ +0001a5a0: 696e 677f 3232 3332 370a 4e6f 6465 3a20 ing.22327.Node: │ │ │ │ │ +0001a5b0: 4572 726f 7220 4861 6e64 6c69 6e67 7f33 Error Handling.3 │ │ │ │ │ +0001a5c0: 3430 3932 0a4e 6f64 653a 2053 7461 636b 4092.Node: Stack │ │ │ │ │ +0001a5d0: 2061 6e64 2068 6561 7020 7369 7a65 7f33 and heap size.3 │ │ │ │ │ +0001a5e0: 3931 3834 0a4e 6f64 653a 2042 494f 5320 9184.Node: BIOS │ │ │ │ │ +0001a5f0: 706f 7274 206d 656d 6f72 7920 6d61 707f port memory map. │ │ │ │ │ +0001a600: 3431 3831 370a 4e6f 6465 3a20 5669 6465 41817.Node: Vide │ │ │ │ │ +0001a610: 6f20 5375 6273 7973 7465 6d7f 3432 3636 o Subsystem.4266 │ │ │ │ │ +0001a620: 360a 4e6f 6465 3a20 5669 6465 6f20 4150 6.Node: Video AP │ │ │ │ │ +0001a630: 497f 3433 3134 300a 4e6f 6465 3a20 4578 I.43140.Node: Ex │ │ │ │ │ +0001a640: 616d 706c 6520 7573 6167 6520 6f66 2056 ample usage of V │ │ │ │ │ +0001a650: 6964 656f 2041 5049 7f36 3335 3839 0a4e ideo API.63589.N │ │ │ │ │ +0001a660: 6f64 653a 2042 6974 6d61 7020 4150 497f ode: Bitmap API. │ │ │ │ │ +0001a670: 3635 3136 390a 4e6f 6465 3a20 5046 4632 65169.Node: PFF2 │ │ │ │ │ +0001a680: 2046 6f6e 7420 4669 6c65 2046 6f72 6d61 Font File Forma │ │ │ │ │ +0001a690: 747f 3637 3730 320a 4e6f 6465 3a20 496e t.67702.Node: In │ │ │ │ │ +0001a6a0: 7472 6f64 7563 7469 6f6e 7f36 3739 3432 troduction.67942 │ │ │ │ │ +0001a6b0: 0a4e 6f64 653a 2046 696c 6520 5374 7275 .Node: File Stru │ │ │ │ │ +0001a6c0: 6374 7572 657f 3639 3434 350a 4e6f 6465 cture.69445.Node │ │ │ │ │ +0001a6d0: 3a20 466f 6e74 204d 6574 7269 6373 7f37 : Font Metrics.7 │ │ │ │ │ +0001a6e0: 3433 3633 0a4e 6f64 653a 2047 7261 7068 4363.Node: Graph │ │ │ │ │ +0001a6f0: 6963 616c 204d 656e 7520 536f 6674 7761 ical Menu Softwa │ │ │ │ │ +0001a700: 7265 2044 6573 6967 6e7f 3735 3531 320a re Design.75512. │ │ │ │ │ +0001a710: 4e6f 6465 3a20 496e 7472 6f64 7563 7469 Node: Introducti │ │ │ │ │ +0001a720: 6f6e 5f32 7f37 3538 3034 0a4e 6f64 653a on_2.75804.Node: │ │ │ │ │ +0001a730: 2053 7461 7274 7570 2053 6571 7565 6e63 Startup Sequenc │ │ │ │ │ +0001a740: 657f 3736 3533 380a 4e6f 6465 3a20 4755 e.76538.Node: GU │ │ │ │ │ +0001a750: 4920 436f 6d70 6f6e 656e 7473 7f37 3733 I Components.773 │ │ │ │ │ +0001a760: 3839 0a4e 6f64 653a 2043 6f6d 6d61 6e64 89.Node: Command │ │ │ │ │ +0001a770: 204c 696e 6520 5769 6e64 6f77 7f37 3939 Line Window.799 │ │ │ │ │ +0001a780: 3839 0a4e 6f64 653a 2056 6572 6966 6965 89.Node: Verifie │ │ │ │ │ +0001a790: 7273 2066 7261 6d65 776f 726b 7f38 3039 rs framework.809 │ │ │ │ │ +0001a7a0: 3431 0a4e 6f64 653a 204c 6f63 6b64 6f77 41.Node: Lockdow │ │ │ │ │ +0001a7b0: 6e20 6672 616d 6577 6f72 6b7f 3833 3534 n framework.8354 │ │ │ │ │ +0001a7c0: 380a 4e6f 6465 3a20 436f 7079 696e 6720 8.Node: Copying │ │ │ │ │ +0001a7d0: 5468 6973 204d 616e 7561 6c7f 3834 3439 This Manual.8449 │ │ │ │ │ +0001a7e0: 300a 4e6f 6465 3a20 474e 5520 4672 6565 0.Node: GNU Free │ │ │ │ │ +0001a7f0: 2044 6f63 756d 656e 7461 7469 6f6e 204c Documentation L │ │ │ │ │ +0001a800: 6963 656e 7365 7f38 3437 3334 0a4e 6f64 icense.84734.Nod │ │ │ │ │ +0001a810: 653a 2049 6e64 6578 7f31 3037 3132 370a e: Index.107127. │ │ │ │ │ +0001a820: 1f0a 456e 6420 5461 6720 5461 626c 650a ..End Tag Table. │ │ │ │ │ +0001a830: 0a1f 0a4c 6f63 616c 2056 6172 6961 626c ...Local Variabl │ │ │ │ │ +0001a840: 6573 3a0a 636f 6469 6e67 3a20 7574 662d es:.coding: utf- │ │ │ │ │ +0001a850: 380a 456e 643a 0a 8.End:. │ │ │ ├── ./usr/share/info/grub.info-1.gz │ │ │ │ ├── grub.info-1 │ │ │ │ │ @@ -1,19456 +1,19455 @@ │ │ │ │ │ 00000000: 5468 6973 2069 7320 6772 7562 2e69 6e66 This is grub.inf │ │ │ │ │ 00000010: 6f2c 2070 726f 6475 6365 6420 6279 206d o, produced by m │ │ │ │ │ 00000020: 616b 6569 6e66 6f20 7665 7273 696f 6e20 akeinfo version │ │ │ │ │ 00000030: 362e 3820 6672 6f6d 2067 7275 622e 7465 6.8 from grub.te │ │ │ │ │ 00000040: 7869 2e0a 0a54 6869 7320 6d61 6e75 616c xi...This manual │ │ │ │ │ 00000050: 2069 7320 666f 7220 474e 5520 4752 5542 is for GNU GRUB │ │ │ │ │ 00000060: 2028 7665 7273 696f 6e20 322e 3036 2c20 (version 2.06, │ │ │ │ │ -00000070: 3132 2046 6562 7275 6172 7920 3230 3235 12 February 2025 │ │ │ │ │ -00000080: 292e 0a0a 2020 2043 6f70 7972 6967 6874 )... Copyright │ │ │ │ │ -00000090: 2028 4329 0a31 3939 392c 3230 3030 2c32 (C).1999,2000,2 │ │ │ │ │ -000000a0: 3030 312c 3230 3032 2c32 3030 342c 3230 001,2002,2004,20 │ │ │ │ │ -000000b0: 3036 2c32 3030 382c 3230 3039 2c32 3031 06,2008,2009,201 │ │ │ │ │ -000000c0: 302c 3230 3131 2c32 3031 322c 3230 3133 0,2011,2012,2013 │ │ │ │ │ -000000d0: 2046 7265 650a 536f 6674 7761 7265 2046 Free.Software F │ │ │ │ │ -000000e0: 6f75 6e64 6174 696f 6e2c 2049 6e63 2e0a oundation, Inc.. │ │ │ │ │ -000000f0: 0a20 2020 2020 5065 726d 6973 7369 6f6e . Permission │ │ │ │ │ -00000100: 2069 7320 6772 616e 7465 6420 746f 2063 is granted to c │ │ │ │ │ -00000110: 6f70 792c 2064 6973 7472 6962 7574 6520 opy, distribute │ │ │ │ │ -00000120: 616e 642f 6f72 206d 6f64 6966 7920 7468 and/or modify th │ │ │ │ │ -00000130: 6973 0a20 2020 2020 646f 6375 6d65 6e74 is. document │ │ │ │ │ -00000140: 2075 6e64 6572 2074 6865 2074 6572 6d73 under the terms │ │ │ │ │ -00000150: 206f 6620 7468 6520 474e 5520 4672 6565 of the GNU Free │ │ │ │ │ -00000160: 2044 6f63 756d 656e 7461 7469 6f6e 204c Documentation L │ │ │ │ │ -00000170: 6963 656e 7365 2c0a 2020 2020 2056 6572 icense,. Ver │ │ │ │ │ -00000180: 7369 6f6e 2031 2e32 206f 7220 616e 7920 sion 1.2 or any │ │ │ │ │ -00000190: 6c61 7465 7220 7665 7273 696f 6e20 7075 later version pu │ │ │ │ │ -000001a0: 626c 6973 6865 6420 6279 2074 6865 2046 blished by the F │ │ │ │ │ -000001b0: 7265 6520 536f 6674 7761 7265 0a20 2020 ree Software. │ │ │ │ │ -000001c0: 2020 466f 756e 6461 7469 6f6e 3b20 7769 Foundation; wi │ │ │ │ │ -000001d0: 7468 206e 6f20 496e 7661 7269 616e 7420 th no Invariant │ │ │ │ │ -000001e0: 5365 6374 696f 6e73 2e0a 494e 464f 2d44 Sections..INFO-D │ │ │ │ │ -000001f0: 4952 2d53 4543 5449 4f4e 204b 6572 6e65 IR-SECTION Kerne │ │ │ │ │ -00000200: 6c0a 5354 4152 542d 494e 464f 2d44 4952 l.START-INFO-DIR │ │ │ │ │ -00000210: 2d45 4e54 5259 0a2a 2047 5255 423a 2028 -ENTRY.* GRUB: ( │ │ │ │ │ -00000220: 6772 7562 292e 2020 2020 2020 2020 2020 grub). │ │ │ │ │ -00000230: 2020 2020 2020 2054 6865 2047 5261 6e64 The GRand │ │ │ │ │ -00000240: 2055 6e69 6669 6564 2042 6f6f 746c 6f61 Unified Bootloa │ │ │ │ │ -00000250: 6465 720a 2a20 6772 7562 2d69 6e73 7461 der.* grub-insta │ │ │ │ │ -00000260: 6c6c 3a20 2867 7275 6229 496e 766f 6b69 ll: (grub)Invoki │ │ │ │ │ -00000270: 6e67 2067 7275 622d 696e 7374 616c 6c2e ng grub-install. │ │ │ │ │ -00000280: 2020 2020 496e 7374 616c 6c20 4752 5542 Install GRUB │ │ │ │ │ -00000290: 206f 6e20 796f 7572 2064 7269 7665 0a2a on your drive.* │ │ │ │ │ -000002a0: 2067 7275 622d 6d6b 636f 6e66 6967 3a20 grub-mkconfig: │ │ │ │ │ -000002b0: 2867 7275 6229 496e 766f 6b69 6e67 2067 (grub)Invoking g │ │ │ │ │ -000002c0: 7275 622d 6d6b 636f 6e66 6967 2e20 2047 rub-mkconfig. G │ │ │ │ │ -000002d0: 656e 6572 6174 6520 4752 5542 2063 6f6e enerate GRUB con │ │ │ │ │ -000002e0: 6669 6775 7261 7469 6f6e 0a2a 2067 7275 figuration.* gru │ │ │ │ │ -000002f0: 622d 6d6b 7061 7373 7764 2d70 626b 6466 b-mkpasswd-pbkdf │ │ │ │ │ -00000300: 323a 2028 6772 7562 2949 6e76 6f6b 696e 2: (grub)Invokin │ │ │ │ │ -00000310: 6720 6772 7562 2d6d 6b70 6173 7377 642d g grub-mkpasswd- │ │ │ │ │ -00000320: 7062 6b64 6632 2e0a 2a20 6772 7562 2d6d pbkdf2..* grub-m │ │ │ │ │ -00000330: 6b72 656c 7061 7468 3a20 2867 7275 6229 krelpath: (grub) │ │ │ │ │ -00000340: 496e 766f 6b69 6e67 2067 7275 622d 6d6b Invoking grub-mk │ │ │ │ │ -00000350: 7265 6c70 6174 682e 0a2a 2067 7275 622d relpath..* grub- │ │ │ │ │ -00000360: 6d6b 7265 7363 7565 3a20 2867 7275 6229 mkrescue: (grub) │ │ │ │ │ -00000370: 496e 766f 6b69 6e67 2067 7275 622d 6d6b Invoking grub-mk │ │ │ │ │ -00000380: 7265 7363 7565 2e20 204d 616b 6520 6120 rescue. Make a │ │ │ │ │ -00000390: 4752 5542 2072 6573 6375 6520 696d 6167 GRUB rescue imag │ │ │ │ │ -000003a0: 650a 2a20 6772 7562 2d6d 6f75 6e74 3a20 e.* grub-mount: │ │ │ │ │ -000003b0: 2867 7275 6229 496e 766f 6b69 6e67 2067 (grub)Invoking g │ │ │ │ │ -000003c0: 7275 622d 6d6f 756e 742e 2020 2020 2020 rub-mount. │ │ │ │ │ -000003d0: 2020 4d6f 756e 7420 6120 6669 6c65 2073 Mount a file s │ │ │ │ │ -000003e0: 7973 7465 6d20 7573 696e 6720 4752 5542 ystem using GRUB │ │ │ │ │ -000003f0: 0a2a 2067 7275 622d 7072 6f62 653a 2028 .* grub-probe: ( │ │ │ │ │ -00000400: 6772 7562 2949 6e76 6f6b 696e 6720 6772 grub)Invoking gr │ │ │ │ │ -00000410: 7562 2d70 726f 6265 2e20 2020 2020 2020 ub-probe. │ │ │ │ │ -00000420: 2050 726f 6265 2064 6576 6963 6520 696e Probe device in │ │ │ │ │ -00000430: 666f 726d 6174 696f 6e0a 2a20 6772 7562 formation.* grub │ │ │ │ │ -00000440: 2d73 6372 6970 742d 6368 6563 6b3a 2028 -script-check: ( │ │ │ │ │ -00000450: 6772 7562 2949 6e76 6f6b 696e 6720 6772 grub)Invoking gr │ │ │ │ │ -00000460: 7562 2d73 6372 6970 742d 6368 6563 6b2e ub-script-check. │ │ │ │ │ -00000470: 0a45 4e44 2d49 4e46 4f2d 4449 522d 454e .END-INFO-DIR-EN │ │ │ │ │ -00000480: 5452 590a 0a1f 0a46 696c 653a 2067 7275 TRY....File: gru │ │ │ │ │ -00000490: 622e 696e 666f 2c20 204e 6f64 653a 2054 b.info, Node: T │ │ │ │ │ -000004a0: 6f70 2c20 204e 6578 743a 2049 6e74 726f op, Next: Intro │ │ │ │ │ -000004b0: 6475 6374 696f 6e2c 2020 5570 3a20 2864 duction, Up: (d │ │ │ │ │ -000004c0: 6972 290a 0a47 4e55 2047 5255 4220 6d61 ir)..GNU GRUB ma │ │ │ │ │ -000004d0: 6e75 616c 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a nual.*********** │ │ │ │ │ -000004e0: 2a2a 2a2a 0a0a 5468 6973 2069 7320 7468 ****..This is th │ │ │ │ │ -000004f0: 6520 646f 6375 6d65 6e74 6174 696f 6e20 e documentation │ │ │ │ │ -00000500: 6f66 2047 4e55 2047 5255 422c 2074 6865 of GNU GRUB, the │ │ │ │ │ -00000510: 2047 5261 6e64 2055 6e69 6669 6564 2042 GRand Unified B │ │ │ │ │ -00000520: 6f6f 746c 6f61 6465 722c 2061 0a66 6c65 ootloader, a.fle │ │ │ │ │ -00000530: 7869 626c 6520 616e 6420 706f 7765 7266 xible and powerf │ │ │ │ │ -00000540: 756c 2062 6f6f 7420 6c6f 6164 6572 2070 ul boot loader p │ │ │ │ │ -00000550: 726f 6772 616d 2066 6f72 2061 2077 6964 rogram for a wid │ │ │ │ │ -00000560: 6520 7261 6e67 6520 6f66 0a61 7263 6869 e range of.archi │ │ │ │ │ -00000570: 7465 6374 7572 6573 2e0a 0a20 2020 5468 tectures... Th │ │ │ │ │ -00000580: 6973 2065 6469 7469 6f6e 2064 6f63 756d is edition docum │ │ │ │ │ -00000590: 656e 7473 2076 6572 7369 6f6e 2032 2e30 ents version 2.0 │ │ │ │ │ -000005a0: 362e 0a0a 2020 2054 6869 7320 6d61 6e75 6... This manu │ │ │ │ │ -000005b0: 616c 2069 7320 666f 7220 474e 5520 4752 al is for GNU GR │ │ │ │ │ -000005c0: 5542 2028 7665 7273 696f 6e20 322e 3036 UB (version 2.06 │ │ │ │ │ -000005d0: 2c20 3132 2046 6562 7275 6172 7920 3230 , 12 February 20 │ │ │ │ │ -000005e0: 3235 292e 0a0a 2020 2043 6f70 7972 6967 25)... Copyrig │ │ │ │ │ -000005f0: 6874 2028 4329 0a31 3939 392c 3230 3030 ht (C).1999,2000 │ │ │ │ │ -00000600: 2c32 3030 312c 3230 3032 2c32 3030 342c ,2001,2002,2004, │ │ │ │ │ -00000610: 3230 3036 2c32 3030 382c 3230 3039 2c32 2006,2008,2009,2 │ │ │ │ │ -00000620: 3031 302c 3230 3131 2c32 3031 322c 3230 010,2011,2012,20 │ │ │ │ │ -00000630: 3133 2046 7265 650a 536f 6674 7761 7265 13 Free.Software │ │ │ │ │ -00000640: 2046 6f75 6e64 6174 696f 6e2c 2049 6e63 Foundation, Inc │ │ │ │ │ -00000650: 2e0a 0a20 2020 2020 5065 726d 6973 7369 ... Permissi │ │ │ │ │ -00000660: 6f6e 2069 7320 6772 616e 7465 6420 746f on is granted to │ │ │ │ │ -00000670: 2063 6f70 792c 2064 6973 7472 6962 7574 copy, distribut │ │ │ │ │ -00000680: 6520 616e 642f 6f72 206d 6f64 6966 7920 e and/or modify │ │ │ │ │ -00000690: 7468 6973 0a20 2020 2020 646f 6375 6d65 this. docume │ │ │ │ │ -000006a0: 6e74 2075 6e64 6572 2074 6865 2074 6572 nt under the ter │ │ │ │ │ -000006b0: 6d73 206f 6620 7468 6520 474e 5520 4672 ms of the GNU Fr │ │ │ │ │ -000006c0: 6565 2044 6f63 756d 656e 7461 7469 6f6e ee Documentation │ │ │ │ │ -000006d0: 204c 6963 656e 7365 2c0a 2020 2020 2056 License,. V │ │ │ │ │ -000006e0: 6572 7369 6f6e 2031 2e32 206f 7220 616e ersion 1.2 or an │ │ │ │ │ -000006f0: 7920 6c61 7465 7220 7665 7273 696f 6e20 y later version │ │ │ │ │ -00000700: 7075 626c 6973 6865 6420 6279 2074 6865 published by the │ │ │ │ │ -00000710: 2046 7265 6520 536f 6674 7761 7265 0a20 Free Software. │ │ │ │ │ -00000720: 2020 2020 466f 756e 6461 7469 6f6e 3b20 Foundation; │ │ │ │ │ -00000730: 7769 7468 206e 6f20 496e 7661 7269 616e with no Invarian │ │ │ │ │ -00000740: 7420 5365 6374 696f 6e73 2e0a 0a2a 204d t Sections...* M │ │ │ │ │ -00000750: 656e 753a 0a0a 2a20 496e 7472 6f64 7563 enu:..* Introduc │ │ │ │ │ -00000760: 7469 6f6e 3a3a 2020 2020 2020 2020 2020 tion:: │ │ │ │ │ -00000770: 2020 2020 2020 4361 7074 7572 696e 6720 Capturing │ │ │ │ │ -00000780: 7468 6520 7370 6972 6974 206f 6620 4752 the spirit of GR │ │ │ │ │ -00000790: 5542 0a2a 204e 616d 696e 6720 636f 6e76 UB.* Naming conv │ │ │ │ │ -000007a0: 656e 7469 6f6e 3a3a 2020 2020 2020 2020 ention:: │ │ │ │ │ -000007b0: 2020 204e 616d 6573 206f 6620 796f 7572 Names of your │ │ │ │ │ -000007c0: 2064 7269 7665 7320 696e 2047 5255 420a drives in GRUB. │ │ │ │ │ -000007d0: 2a20 4f53 2d73 7065 6369 6669 6320 6e6f * OS-specific no │ │ │ │ │ -000007e0: 7465 7320 6162 6f75 7420 6772 7562 2074 tes about grub t │ │ │ │ │ -000007f0: 6f6f 6c73 3a3a 0a20 2020 2020 2020 2020 ools::. │ │ │ │ │ +00000070: 3131 204a 616e 7561 7279 2032 3032 3429 11 January 2024) │ │ │ │ │ +00000080: 2e0a 0a20 2020 436f 7079 7269 6768 7420 ... Copyright │ │ │ │ │ +00000090: 2843 290a 3139 3939 2c32 3030 302c 3230 (C).1999,2000,20 │ │ │ │ │ +000000a0: 3031 2c32 3030 322c 3230 3034 2c32 3030 01,2002,2004,200 │ │ │ │ │ +000000b0: 362c 3230 3038 2c32 3030 392c 3230 3130 6,2008,2009,2010 │ │ │ │ │ +000000c0: 2c32 3031 312c 3230 3132 2c32 3031 3320 ,2011,2012,2013 │ │ │ │ │ +000000d0: 4672 6565 0a53 6f66 7477 6172 6520 466f Free.Software Fo │ │ │ │ │ +000000e0: 756e 6461 7469 6f6e 2c20 496e 632e 0a0a undation, Inc... │ │ │ │ │ +000000f0: 2020 2020 2050 6572 6d69 7373 696f 6e20 Permission │ │ │ │ │ +00000100: 6973 2067 7261 6e74 6564 2074 6f20 636f is granted to co │ │ │ │ │ +00000110: 7079 2c20 6469 7374 7269 6275 7465 2061 py, distribute a │ │ │ │ │ +00000120: 6e64 2f6f 7220 6d6f 6469 6679 2074 6869 nd/or modify thi │ │ │ │ │ +00000130: 730a 2020 2020 2064 6f63 756d 656e 7420 s. document │ │ │ │ │ +00000140: 756e 6465 7220 7468 6520 7465 726d 7320 under the terms │ │ │ │ │ +00000150: 6f66 2074 6865 2047 4e55 2046 7265 6520 of the GNU Free │ │ │ │ │ +00000160: 446f 6375 6d65 6e74 6174 696f 6e20 4c69 Documentation Li │ │ │ │ │ +00000170: 6365 6e73 652c 0a20 2020 2020 5665 7273 cense,. Vers │ │ │ │ │ +00000180: 696f 6e20 312e 3220 6f72 2061 6e79 206c ion 1.2 or any l │ │ │ │ │ +00000190: 6174 6572 2076 6572 7369 6f6e 2070 7562 ater version pub │ │ │ │ │ +000001a0: 6c69 7368 6564 2062 7920 7468 6520 4672 lished by the Fr │ │ │ │ │ +000001b0: 6565 2053 6f66 7477 6172 650a 2020 2020 ee Software. │ │ │ │ │ +000001c0: 2046 6f75 6e64 6174 696f 6e3b 2077 6974 Foundation; wit │ │ │ │ │ +000001d0: 6820 6e6f 2049 6e76 6172 6961 6e74 2053 h no Invariant S │ │ │ │ │ +000001e0: 6563 7469 6f6e 732e 0a49 4e46 4f2d 4449 ections..INFO-DI │ │ │ │ │ +000001f0: 522d 5345 4354 494f 4e20 4b65 726e 656c R-SECTION Kernel │ │ │ │ │ +00000200: 0a53 5441 5254 2d49 4e46 4f2d 4449 522d .START-INFO-DIR- │ │ │ │ │ +00000210: 454e 5452 590a 2a20 4752 5542 3a20 2867 ENTRY.* GRUB: (g │ │ │ │ │ +00000220: 7275 6229 2e20 2020 2020 2020 2020 2020 rub). │ │ │ │ │ +00000230: 2020 2020 2020 5468 6520 4752 616e 6420 The GRand │ │ │ │ │ +00000240: 556e 6966 6965 6420 426f 6f74 6c6f 6164 Unified Bootload │ │ │ │ │ +00000250: 6572 0a2a 2067 7275 622d 696e 7374 616c er.* grub-instal │ │ │ │ │ +00000260: 6c3a 2028 6772 7562 2949 6e76 6f6b 696e l: (grub)Invokin │ │ │ │ │ +00000270: 6720 6772 7562 2d69 6e73 7461 6c6c 2e20 g grub-install. │ │ │ │ │ +00000280: 2020 2049 6e73 7461 6c6c 2047 5255 4220 Install GRUB │ │ │ │ │ +00000290: 6f6e 2079 6f75 7220 6472 6976 650a 2a20 on your drive.* │ │ │ │ │ +000002a0: 6772 7562 2d6d 6b63 6f6e 6669 673a 2028 grub-mkconfig: ( │ │ │ │ │ +000002b0: 6772 7562 2949 6e76 6f6b 696e 6720 6772 grub)Invoking gr │ │ │ │ │ +000002c0: 7562 2d6d 6b63 6f6e 6669 672e 2020 4765 ub-mkconfig. Ge │ │ │ │ │ +000002d0: 6e65 7261 7465 2047 5255 4220 636f 6e66 nerate GRUB conf │ │ │ │ │ +000002e0: 6967 7572 6174 696f 6e0a 2a20 6772 7562 iguration.* grub │ │ │ │ │ +000002f0: 2d6d 6b70 6173 7377 642d 7062 6b64 6632 -mkpasswd-pbkdf2 │ │ │ │ │ +00000300: 3a20 2867 7275 6229 496e 766f 6b69 6e67 : (grub)Invoking │ │ │ │ │ +00000310: 2067 7275 622d 6d6b 7061 7373 7764 2d70 grub-mkpasswd-p │ │ │ │ │ +00000320: 626b 6466 322e 0a2a 2067 7275 622d 6d6b bkdf2..* grub-mk │ │ │ │ │ +00000330: 7265 6c70 6174 683a 2028 6772 7562 2949 relpath: (grub)I │ │ │ │ │ +00000340: 6e76 6f6b 696e 6720 6772 7562 2d6d 6b72 nvoking grub-mkr │ │ │ │ │ +00000350: 656c 7061 7468 2e0a 2a20 6772 7562 2d6d elpath..* grub-m │ │ │ │ │ +00000360: 6b72 6573 6375 653a 2028 6772 7562 2949 krescue: (grub)I │ │ │ │ │ +00000370: 6e76 6f6b 696e 6720 6772 7562 2d6d 6b72 nvoking grub-mkr │ │ │ │ │ +00000380: 6573 6375 652e 2020 4d61 6b65 2061 2047 escue. Make a G │ │ │ │ │ +00000390: 5255 4220 7265 7363 7565 2069 6d61 6765 RUB rescue image │ │ │ │ │ +000003a0: 0a2a 2067 7275 622d 6d6f 756e 743a 2028 .* grub-mount: ( │ │ │ │ │ +000003b0: 6772 7562 2949 6e76 6f6b 696e 6720 6772 grub)Invoking gr │ │ │ │ │ +000003c0: 7562 2d6d 6f75 6e74 2e20 2020 2020 2020 ub-mount. │ │ │ │ │ +000003d0: 204d 6f75 6e74 2061 2066 696c 6520 7379 Mount a file sy │ │ │ │ │ +000003e0: 7374 656d 2075 7369 6e67 2047 5255 420a stem using GRUB. │ │ │ │ │ +000003f0: 2a20 6772 7562 2d70 726f 6265 3a20 2867 * grub-probe: (g │ │ │ │ │ +00000400: 7275 6229 496e 766f 6b69 6e67 2067 7275 rub)Invoking gru │ │ │ │ │ +00000410: 622d 7072 6f62 652e 2020 2020 2020 2020 b-probe. │ │ │ │ │ +00000420: 5072 6f62 6520 6465 7669 6365 2069 6e66 Probe device inf │ │ │ │ │ +00000430: 6f72 6d61 7469 6f6e 0a2a 2067 7275 622d ormation.* grub- │ │ │ │ │ +00000440: 7363 7269 7074 2d63 6865 636b 3a20 2867 script-check: (g │ │ │ │ │ +00000450: 7275 6229 496e 766f 6b69 6e67 2067 7275 rub)Invoking gru │ │ │ │ │ +00000460: 622d 7363 7269 7074 2d63 6865 636b 2e0a b-script-check.. │ │ │ │ │ +00000470: 454e 442d 494e 464f 2d44 4952 2d45 4e54 END-INFO-DIR-ENT │ │ │ │ │ +00000480: 5259 0a0a 1f0a 4669 6c65 3a20 6772 7562 RY....File: grub │ │ │ │ │ +00000490: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 546f .info, Node: To │ │ │ │ │ +000004a0: 702c 2020 4e65 7874 3a20 496e 7472 6f64 p, Next: Introd │ │ │ │ │ +000004b0: 7563 7469 6f6e 2c20 2055 703a 2028 6469 uction, Up: (di │ │ │ │ │ +000004c0: 7229 0a0a 474e 5520 4752 5542 206d 616e r)..GNU GRUB man │ │ │ │ │ +000004d0: 7561 6c0a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a ual.************ │ │ │ │ │ +000004e0: 2a2a 2a0a 0a54 6869 7320 6973 2074 6865 ***..This is the │ │ │ │ │ +000004f0: 2064 6f63 756d 656e 7461 7469 6f6e 206f documentation o │ │ │ │ │ +00000500: 6620 474e 5520 4752 5542 2c20 7468 6520 f GNU GRUB, the │ │ │ │ │ +00000510: 4752 616e 6420 556e 6966 6965 6420 426f GRand Unified Bo │ │ │ │ │ +00000520: 6f74 6c6f 6164 6572 2c20 610a 666c 6578 otloader, a.flex │ │ │ │ │ +00000530: 6962 6c65 2061 6e64 2070 6f77 6572 6675 ible and powerfu │ │ │ │ │ +00000540: 6c20 626f 6f74 206c 6f61 6465 7220 7072 l boot loader pr │ │ │ │ │ +00000550: 6f67 7261 6d20 666f 7220 6120 7769 6465 ogram for a wide │ │ │ │ │ +00000560: 2072 616e 6765 206f 660a 6172 6368 6974 range of.archit │ │ │ │ │ +00000570: 6563 7475 7265 732e 0a0a 2020 2054 6869 ectures... Thi │ │ │ │ │ +00000580: 7320 6564 6974 696f 6e20 646f 6375 6d65 s edition docume │ │ │ │ │ +00000590: 6e74 7320 7665 7273 696f 6e20 322e 3036 nts version 2.06 │ │ │ │ │ +000005a0: 2e0a 0a20 2020 5468 6973 206d 616e 7561 ... This manua │ │ │ │ │ +000005b0: 6c20 6973 2066 6f72 2047 4e55 2047 5255 l is for GNU GRU │ │ │ │ │ +000005c0: 4220 2876 6572 7369 6f6e 2032 2e30 362c B (version 2.06, │ │ │ │ │ +000005d0: 2031 3120 4a61 6e75 6172 7920 3230 3234 11 January 2024 │ │ │ │ │ +000005e0: 292e 0a0a 2020 2043 6f70 7972 6967 6874 )... Copyright │ │ │ │ │ +000005f0: 2028 4329 0a31 3939 392c 3230 3030 2c32 (C).1999,2000,2 │ │ │ │ │ +00000600: 3030 312c 3230 3032 2c32 3030 342c 3230 001,2002,2004,20 │ │ │ │ │ +00000610: 3036 2c32 3030 382c 3230 3039 2c32 3031 06,2008,2009,201 │ │ │ │ │ +00000620: 302c 3230 3131 2c32 3031 322c 3230 3133 0,2011,2012,2013 │ │ │ │ │ +00000630: 2046 7265 650a 536f 6674 7761 7265 2046 Free.Software F │ │ │ │ │ +00000640: 6f75 6e64 6174 696f 6e2c 2049 6e63 2e0a oundation, Inc.. │ │ │ │ │ +00000650: 0a20 2020 2020 5065 726d 6973 7369 6f6e . Permission │ │ │ │ │ +00000660: 2069 7320 6772 616e 7465 6420 746f 2063 is granted to c │ │ │ │ │ +00000670: 6f70 792c 2064 6973 7472 6962 7574 6520 opy, distribute │ │ │ │ │ +00000680: 616e 642f 6f72 206d 6f64 6966 7920 7468 and/or modify th │ │ │ │ │ +00000690: 6973 0a20 2020 2020 646f 6375 6d65 6e74 is. document │ │ │ │ │ +000006a0: 2075 6e64 6572 2074 6865 2074 6572 6d73 under the terms │ │ │ │ │ +000006b0: 206f 6620 7468 6520 474e 5520 4672 6565 of the GNU Free │ │ │ │ │ +000006c0: 2044 6f63 756d 656e 7461 7469 6f6e 204c Documentation L │ │ │ │ │ +000006d0: 6963 656e 7365 2c0a 2020 2020 2056 6572 icense,. Ver │ │ │ │ │ +000006e0: 7369 6f6e 2031 2e32 206f 7220 616e 7920 sion 1.2 or any │ │ │ │ │ +000006f0: 6c61 7465 7220 7665 7273 696f 6e20 7075 later version pu │ │ │ │ │ +00000700: 626c 6973 6865 6420 6279 2074 6865 2046 blished by the F │ │ │ │ │ +00000710: 7265 6520 536f 6674 7761 7265 0a20 2020 ree Software. │ │ │ │ │ +00000720: 2020 466f 756e 6461 7469 6f6e 3b20 7769 Foundation; wi │ │ │ │ │ +00000730: 7468 206e 6f20 496e 7661 7269 616e 7420 th no Invariant │ │ │ │ │ +00000740: 5365 6374 696f 6e73 2e0a 0a2a 204d 656e Sections...* Men │ │ │ │ │ +00000750: 753a 0a0a 2a20 496e 7472 6f64 7563 7469 u:..* Introducti │ │ │ │ │ +00000760: 6f6e 3a3a 2020 2020 2020 2020 2020 2020 on:: │ │ │ │ │ +00000770: 2020 2020 4361 7074 7572 696e 6720 7468 Capturing th │ │ │ │ │ +00000780: 6520 7370 6972 6974 206f 6620 4752 5542 e spirit of GRUB │ │ │ │ │ +00000790: 0a2a 204e 616d 696e 6720 636f 6e76 656e .* Naming conven │ │ │ │ │ +000007a0: 7469 6f6e 3a3a 2020 2020 2020 2020 2020 tion:: │ │ │ │ │ +000007b0: 204e 616d 6573 206f 6620 796f 7572 2064 Names of your d │ │ │ │ │ +000007c0: 7269 7665 7320 696e 2047 5255 420a 2a20 rives in GRUB.* │ │ │ │ │ +000007d0: 4f53 2d73 7065 6369 6669 6320 6e6f 7465 OS-specific note │ │ │ │ │ +000007e0: 7320 6162 6f75 7420 6772 7562 2074 6f6f s about grub too │ │ │ │ │ +000007f0: 6c73 3a3a 0a20 2020 2020 2020 2020 2020 ls::. │ │ │ │ │ 00000800: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000810: 2020 2020 2020 2053 6f6d 6520 6e6f 7465 Some note │ │ │ │ │ -00000820: 7320 6162 6f75 7420 4f53 2d73 7065 6369 s about OS-speci │ │ │ │ │ -00000830: 6669 6320 6265 6861 7669 6f75 7220 6f66 fic behaviour of │ │ │ │ │ -00000840: 2047 5255 420a 2020 2020 2020 2020 2020 GRUB. │ │ │ │ │ +00000810: 2020 2020 2053 6f6d 6520 6e6f 7465 7320 Some notes │ │ │ │ │ +00000820: 6162 6f75 7420 4f53 2d73 7065 6369 6669 about OS-specifi │ │ │ │ │ +00000830: 6320 6265 6861 7669 6f75 7220 6f66 2047 c behaviour of G │ │ │ │ │ +00000840: 5255 420a 2020 2020 2020 2020 2020 2020 RUB. │ │ │ │ │ 00000850: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000860: 2020 2020 2020 746f 6f6c 730a 2a20 496e tools.* In │ │ │ │ │ -00000870: 7374 616c 6c61 7469 6f6e 3a3a 2020 2020 stallation:: │ │ │ │ │ -00000880: 2020 2020 2020 2020 2020 2020 496e 7374 Inst │ │ │ │ │ -00000890: 616c 6c69 6e67 2047 5255 4220 6f6e 2079 alling GRUB on y │ │ │ │ │ -000008a0: 6f75 7220 6472 6976 650a 2a20 426f 6f74 our drive.* Boot │ │ │ │ │ -000008b0: 696e 673a 3a20 2020 2020 2020 2020 2020 ing:: │ │ │ │ │ -000008c0: 2020 2020 2020 2020 2020 486f 7720 746f How to │ │ │ │ │ -000008d0: 2062 6f6f 7420 6469 6666 6572 656e 7420 boot different │ │ │ │ │ -000008e0: 6f70 6572 6174 696e 6720 7379 7374 656d operating system │ │ │ │ │ -000008f0: 730a 2a20 436f 6e66 6967 7572 6174 696f s.* Configuratio │ │ │ │ │ -00000900: 6e3a 3a20 2020 2020 2020 2020 2020 2020 n:: │ │ │ │ │ -00000910: 2020 5772 6974 696e 6720 796f 7572 206f Writing your o │ │ │ │ │ -00000920: 776e 2063 6f6e 6669 6775 7261 7469 6f6e wn configuration │ │ │ │ │ -00000930: 2066 696c 650a 2a20 5468 656d 6520 6669 file.* Theme fi │ │ │ │ │ -00000940: 6c65 2066 6f72 6d61 743a 3a20 2020 2020 le format:: │ │ │ │ │ -00000950: 2020 2020 2020 466f 726d 6174 206f 6620 Format of │ │ │ │ │ -00000960: 4752 5542 2074 6865 6d65 2066 696c 6573 GRUB theme files │ │ │ │ │ -00000970: 0a2a 204e 6574 776f 726b 3a3a 2020 2020 .* Network:: │ │ │ │ │ -00000980: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000990: 2044 6f77 6e6c 6f61 6469 6e67 204f 5320 Downloading OS │ │ │ │ │ -000009a0: 696d 6167 6573 2066 726f 6d20 6120 6e65 images from a ne │ │ │ │ │ -000009b0: 7477 6f72 6b0a 2a20 5365 7269 616c 2074 twork.* Serial t │ │ │ │ │ -000009c0: 6572 6d69 6e61 6c3a 3a20 2020 2020 2020 erminal:: │ │ │ │ │ -000009d0: 2020 2020 2020 5573 696e 6720 4752 5542 Using GRUB │ │ │ │ │ -000009e0: 2076 6961 2061 2073 6572 6961 6c20 6c69 via a serial li │ │ │ │ │ -000009f0: 6e65 0a2a 2056 656e 646f 7220 706f 7765 ne.* Vendor powe │ │ │ │ │ -00000a00: 722d 6f6e 206b 6579 733a 3a20 2020 2020 r-on keys:: │ │ │ │ │ -00000a10: 2020 2043 6861 6e67 696e 6720 4752 5542 Changing GRUB │ │ │ │ │ -00000a20: 2062 6568 6176 696f 7572 206f 6e20 7665 behaviour on ve │ │ │ │ │ -00000a30: 6e64 6f72 2070 6f77 6572 2d6f 6e20 6b65 ndor power-on ke │ │ │ │ │ -00000a40: 7973 0a2a 2049 6d61 6765 733a 3a20 2020 ys.* Images:: │ │ │ │ │ +00000860: 2020 2020 746f 6f6c 730a 2a20 496e 7374 tools.* Inst │ │ │ │ │ +00000870: 616c 6c61 7469 6f6e 3a3a 2020 2020 2020 allation:: │ │ │ │ │ +00000880: 2020 2020 2020 2020 2020 496e 7374 616c Instal │ │ │ │ │ +00000890: 6c69 6e67 2047 5255 4220 6f6e 2079 6f75 ling GRUB on you │ │ │ │ │ +000008a0: 7220 6472 6976 650a 2a20 426f 6f74 696e r drive.* Bootin │ │ │ │ │ +000008b0: 673a 3a20 2020 2020 2020 2020 2020 2020 g:: │ │ │ │ │ +000008c0: 2020 2020 2020 2020 486f 7720 746f 2062 How to b │ │ │ │ │ +000008d0: 6f6f 7420 6469 6666 6572 656e 7420 6f70 oot different op │ │ │ │ │ +000008e0: 6572 6174 696e 6720 7379 7374 656d 730a erating systems. │ │ │ │ │ +000008f0: 2a20 436f 6e66 6967 7572 6174 696f 6e3a * Configuration: │ │ │ │ │ +00000900: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00000910: 5772 6974 696e 6720 796f 7572 206f 776e Writing your own │ │ │ │ │ +00000920: 2063 6f6e 6669 6775 7261 7469 6f6e 2066 configuration f │ │ │ │ │ +00000930: 696c 650a 2a20 5468 656d 6520 6669 6c65 ile.* Theme file │ │ │ │ │ +00000940: 2066 6f72 6d61 743a 3a20 2020 2020 2020 format:: │ │ │ │ │ +00000950: 2020 2020 466f 726d 6174 206f 6620 4752 Format of GR │ │ │ │ │ +00000960: 5542 2074 6865 6d65 2066 696c 6573 0a2a UB theme files.* │ │ │ │ │ +00000970: 204e 6574 776f 726b 3a3a 2020 2020 2020 Network:: │ │ │ │ │ +00000980: 2020 2020 2020 2020 2020 2020 2020 2044 D │ │ │ │ │ +00000990: 6f77 6e6c 6f61 6469 6e67 204f 5320 696d ownloading OS im │ │ │ │ │ +000009a0: 6167 6573 2066 726f 6d20 6120 6e65 7477 ages from a netw │ │ │ │ │ +000009b0: 6f72 6b0a 2a20 5365 7269 616c 2074 6572 ork.* Serial ter │ │ │ │ │ +000009c0: 6d69 6e61 6c3a 3a20 2020 2020 2020 2020 minal:: │ │ │ │ │ +000009d0: 2020 2020 5573 696e 6720 4752 5542 2076 Using GRUB v │ │ │ │ │ +000009e0: 6961 2061 2073 6572 6961 6c20 6c69 6e65 ia a serial line │ │ │ │ │ +000009f0: 0a2a 2056 656e 646f 7220 706f 7765 722d .* Vendor power- │ │ │ │ │ +00000a00: 6f6e 206b 6579 733a 3a20 2020 2020 2020 on keys:: │ │ │ │ │ +00000a10: 2043 6861 6e67 696e 6720 4752 5542 2062 Changing GRUB b │ │ │ │ │ +00000a20: 6568 6176 696f 7572 206f 6e20 7665 6e64 ehaviour on vend │ │ │ │ │ +00000a30: 6f72 2070 6f77 6572 2d6f 6e20 6b65 7973 or power-on keys │ │ │ │ │ +00000a40: 0a2a 2049 6d61 6765 733a 3a20 2020 2020 .* Images:: │ │ │ │ │ 00000a50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000a60: 2020 2047 5255 4220 696d 6167 6520 6669 GRUB image fi │ │ │ │ │ -00000a70: 6c65 730a 2a20 436f 7265 2069 6d61 6765 les.* Core image │ │ │ │ │ -00000a80: 2073 697a 6520 6c69 6d69 7461 7469 6f6e size limitation │ │ │ │ │ -00000a90: 3a3a 2020 4752 5542 2069 6d61 6765 2066 :: GRUB image f │ │ │ │ │ -00000aa0: 696c 6573 2073 697a 6520 6c69 6d69 7461 iles size limita │ │ │ │ │ -00000ab0: 7469 6f6e 730a 2a20 4669 6c65 7379 7374 tions.* Filesyst │ │ │ │ │ -00000ac0: 656d 3a3a 2020 2020 2020 2020 2020 2020 em:: │ │ │ │ │ -00000ad0: 2020 2020 2020 4669 6c65 7379 7374 656d Filesystem │ │ │ │ │ -00000ae0: 2073 796e 7461 7820 616e 6420 7365 6d61 syntax and sema │ │ │ │ │ -00000af0: 6e74 6963 730a 2a20 496e 7465 7266 6163 ntics.* Interfac │ │ │ │ │ -00000b00: 653a 3a20 2020 2020 2020 2020 2020 2020 e:: │ │ │ │ │ -00000b10: 2020 2020 2020 5468 6520 6d65 6e75 2061 The menu a │ │ │ │ │ -00000b20: 6e64 2074 6865 2063 6f6d 6d61 6e64 2d6c nd the command-l │ │ │ │ │ -00000b30: 696e 650a 2a20 456e 7669 726f 6e6d 656e ine.* Environmen │ │ │ │ │ -00000b40: 743a 3a20 2020 2020 2020 2020 2020 2020 t:: │ │ │ │ │ -00000b50: 2020 2020 4752 5542 2065 6e76 6972 6f6e GRUB environ │ │ │ │ │ -00000b60: 6d65 6e74 2076 6172 6961 626c 6573 0a2a ment variables.* │ │ │ │ │ -00000b70: 2043 6f6d 6d61 6e64 733a 3a20 2020 2020 Commands:: │ │ │ │ │ -00000b80: 2020 2020 2020 2020 2020 2020 2020 2054 T │ │ │ │ │ -00000b90: 6865 206c 6973 7420 6f66 2061 7661 696c he list of avail │ │ │ │ │ -00000ba0: 6162 6c65 2062 7569 6c74 696e 2063 6f6d able builtin com │ │ │ │ │ -00000bb0: 6d61 6e64 730a 2a20 496e 7465 726e 6174 mands.* Internat │ │ │ │ │ -00000bc0: 696f 6e61 6c69 7361 7469 6f6e 3a3a 2020 ionalisation:: │ │ │ │ │ -00000bd0: 2020 2020 2020 546f 7069 6373 2072 656c Topics rel │ │ │ │ │ -00000be0: 6174 696e 6720 746f 206c 616e 6775 6167 ating to languag │ │ │ │ │ -00000bf0: 6520 7375 7070 6f72 740a 2a20 5365 6375 e support.* Secu │ │ │ │ │ -00000c00: 7269 7479 3a3a 2020 2020 2020 2020 2020 rity:: │ │ │ │ │ -00000c10: 2020 2020 2020 2020 2020 4175 7468 656e Authen │ │ │ │ │ -00000c20: 7469 6361 7469 6f6e 2c20 6175 7468 6f72 tication, author │ │ │ │ │ -00000c30: 6973 6174 696f 6e2c 2061 6e64 2073 6967 isation, and sig │ │ │ │ │ -00000c40: 6e61 7475 7265 730a 2a20 506c 6174 666f natures.* Platfo │ │ │ │ │ -00000c50: 726d 206c 696d 6974 6174 696f 6e73 3a3a rm limitations:: │ │ │ │ │ -00000c60: 2020 2020 2020 2020 5468 6520 6c69 7374 The list │ │ │ │ │ -00000c70: 206f 6620 706c 6174 666f 726d 2d73 7065 of platform-spe │ │ │ │ │ -00000c80: 6369 6669 6320 6c69 6d69 7461 7469 6f6e cific limitation │ │ │ │ │ -00000c90: 730a 2a20 506c 6174 666f 726d 2d73 7065 s.* Platform-spe │ │ │ │ │ -00000ca0: 6369 6669 6320 6f70 6572 6174 696f 6e73 cific operations │ │ │ │ │ -00000cb0: 3a3a 2050 6c61 7466 6f72 6d2d 7370 6563 :: Platform-spec │ │ │ │ │ -00000cc0: 6966 6963 206f 7065 7261 7469 6f6e 730a ific operations. │ │ │ │ │ -00000cd0: 2a20 5375 7070 6f72 7465 6420 6b65 726e * Supported kern │ │ │ │ │ -00000ce0: 656c 733a 3a20 2020 2020 2020 2020 2020 els:: │ │ │ │ │ -00000cf0: 5468 6520 6c69 7374 206f 6620 7375 7070 The list of supp │ │ │ │ │ -00000d00: 6f72 7465 6420 6b65 726e 656c 730a 2a20 orted kernels.* │ │ │ │ │ -00000d10: 5472 6f75 626c 6573 686f 6f74 696e 673a Troubleshooting: │ │ │ │ │ -00000d20: 3a20 2020 2020 2020 2020 2020 2020 4572 : Er │ │ │ │ │ -00000d30: 726f 7220 6d65 7373 6167 6573 2070 726f ror messages pro │ │ │ │ │ -00000d40: 6475 6365 6420 6279 2047 5255 420a 2a20 duced by GRUB.* │ │ │ │ │ -00000d50: 496e 766f 6b69 6e67 2067 7275 622d 696e Invoking grub-in │ │ │ │ │ -00000d60: 7374 616c 6c3a 3a20 2020 2020 2020 486f stall:: Ho │ │ │ │ │ -00000d70: 7720 746f 2075 7365 2074 6865 2047 5255 w to use the GRU │ │ │ │ │ -00000d80: 4220 696e 7374 616c 6c65 720a 2a20 496e B installer.* In │ │ │ │ │ -00000d90: 766f 6b69 6e67 2067 7275 622d 6d6b 636f voking grub-mkco │ │ │ │ │ -00000da0: 6e66 6967 3a3a 2020 2020 2020 4765 6e65 nfig:: Gene │ │ │ │ │ -00000db0: 7261 7465 2061 2047 5255 4220 636f 6e66 rate a GRUB conf │ │ │ │ │ -00000dc0: 6967 7572 6174 696f 6e20 6669 6c65 0a2a iguration file.* │ │ │ │ │ -00000dd0: 2049 6e76 6f6b 696e 6720 6772 7562 2d6d Invoking grub-m │ │ │ │ │ -00000de0: 6b70 6173 7377 642d 7062 6b64 6632 3a3a kpasswd-pbkdf2:: │ │ │ │ │ -00000df0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ -00000e00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000e10: 2047 656e 6572 6174 6520 4752 5542 2070 Generate GRUB p │ │ │ │ │ -00000e20: 6173 7377 6f72 6420 6861 7368 6573 0a2a assword hashes.* │ │ │ │ │ -00000e30: 2049 6e76 6f6b 696e 6720 6772 7562 2d6d Invoking grub-m │ │ │ │ │ -00000e40: 6b72 656c 7061 7468 3a3a 2020 2020 204d krelpath:: M │ │ │ │ │ -00000e50: 616b 6520 7379 7374 656d 2070 6174 6820 ake system path │ │ │ │ │ -00000e60: 7265 6c61 7469 7665 2074 6f20 6974 7320 relative to its │ │ │ │ │ -00000e70: 726f 6f74 0a2a 2049 6e76 6f6b 696e 6720 root.* Invoking │ │ │ │ │ -00000e80: 6772 7562 2d6d 6b72 6573 6375 653a 3a20 grub-mkrescue:: │ │ │ │ │ -00000e90: 2020 2020 204d 616b 6520 6120 4752 5542 Make a GRUB │ │ │ │ │ -00000ea0: 2072 6573 6375 6520 696d 6167 650a 2a20 rescue image.* │ │ │ │ │ -00000eb0: 496e 766f 6b69 6e67 2067 7275 622d 6d6f Invoking grub-mo │ │ │ │ │ -00000ec0: 756e 743a 3a20 2020 2020 2020 2020 4d6f unt:: Mo │ │ │ │ │ -00000ed0: 756e 7420 6120 6669 6c65 2073 7973 7465 unt a file syste │ │ │ │ │ -00000ee0: 6d20 7573 696e 6720 4752 5542 0a2a 2049 m using GRUB.* I │ │ │ │ │ -00000ef0: 6e76 6f6b 696e 6720 6772 7562 2d70 726f nvoking grub-pro │ │ │ │ │ -00000f00: 6265 3a3a 2020 2020 2020 2020 2050 726f be:: Pro │ │ │ │ │ -00000f10: 6265 2064 6576 6963 6520 696e 666f 726d be device inform │ │ │ │ │ -00000f20: 6174 696f 6e20 666f 7220 4752 5542 0a2a ation for GRUB.* │ │ │ │ │ -00000f30: 2049 6e76 6f6b 696e 6720 6772 7562 2d73 Invoking grub-s │ │ │ │ │ -00000f40: 6372 6970 742d 6368 6563 6b3a 3a20 2043 cript-check:: C │ │ │ │ │ -00000f50: 6865 636b 2047 5255 4220 7363 7269 7074 heck GRUB script │ │ │ │ │ -00000f60: 2066 696c 6520 666f 7220 7379 6e74 6178 file for syntax │ │ │ │ │ -00000f70: 2065 7272 6f72 730a 2a20 4f62 7461 696e errors.* Obtain │ │ │ │ │ -00000f80: 696e 6720 616e 6420 4275 696c 6469 6e67 ing and Building │ │ │ │ │ -00000f90: 2047 5255 423a 3a20 486f 7720 746f 206f GRUB:: How to o │ │ │ │ │ -00000fa0: 6274 6169 6e20 616e 6420 6275 696c 6420 btain and build │ │ │ │ │ -00000fb0: 4752 5542 0a2a 2052 6570 6f72 7469 6e67 GRUB.* Reporting │ │ │ │ │ -00000fc0: 2062 7567 733a 3a20 2020 2020 2020 2020 bugs:: │ │ │ │ │ -00000fd0: 2020 2020 2057 6865 7265 2079 6f75 2073 Where you s │ │ │ │ │ -00000fe0: 686f 756c 6420 7365 6e64 2061 2062 7567 hould send a bug │ │ │ │ │ -00000ff0: 2072 6570 6f72 740a 2a20 4675 7475 7265 report.* Future │ │ │ │ │ -00001000: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ │ -00001010: 2020 2020 2020 2020 536f 6d65 2066 7574 Some fut │ │ │ │ │ -00001020: 7572 6520 706c 616e 7320 6f6e 2047 5255 ure plans on GRU │ │ │ │ │ -00001030: 420a 2a20 436f 7079 696e 6720 5468 6973 B.* Copying This │ │ │ │ │ -00001040: 204d 616e 7561 6c3a 3a20 2020 2020 2020 Manual:: │ │ │ │ │ -00001050: 2020 436f 7079 696e 6720 5468 6973 204d Copying This M │ │ │ │ │ -00001060: 616e 7561 6c0a 2a20 496e 6465 783a 3a0a anual.* Index::. │ │ │ │ │ -00001070: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ -00001080: 666f 2c20 204e 6f64 653a 2049 6e74 726f fo, Node: Intro │ │ │ │ │ -00001090: 6475 6374 696f 6e2c 2020 4e65 7874 3a20 duction, Next: │ │ │ │ │ -000010a0: 4e61 6d69 6e67 2063 6f6e 7665 6e74 696f Naming conventio │ │ │ │ │ -000010b0: 6e2c 2020 5072 6576 3a20 546f 702c 2020 n, Prev: Top, │ │ │ │ │ -000010c0: 5570 3a20 546f 700a 0a31 2049 6e74 726f Up: Top..1 Intro │ │ │ │ │ -000010d0: 6475 6374 696f 6e20 746f 2047 5255 420a duction to GRUB. │ │ │ │ │ +00000a60: 2047 5255 4220 696d 6167 6520 6669 6c65 GRUB image file │ │ │ │ │ +00000a70: 730a 2a20 436f 7265 2069 6d61 6765 2073 s.* Core image s │ │ │ │ │ +00000a80: 697a 6520 6c69 6d69 7461 7469 6f6e 3a3a ize limitation:: │ │ │ │ │ +00000a90: 2020 4752 5542 2069 6d61 6765 2066 696c GRUB image fil │ │ │ │ │ +00000aa0: 6573 2073 697a 6520 6c69 6d69 7461 7469 es size limitati │ │ │ │ │ +00000ab0: 6f6e 730a 2a20 4669 6c65 7379 7374 656d ons.* Filesystem │ │ │ │ │ +00000ac0: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ │ +00000ad0: 2020 2020 4669 6c65 7379 7374 656d 2073 Filesystem s │ │ │ │ │ +00000ae0: 796e 7461 7820 616e 6420 7365 6d61 6e74 yntax and semant │ │ │ │ │ +00000af0: 6963 730a 2a20 496e 7465 7266 6163 653a ics.* Interface: │ │ │ │ │ +00000b00: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00000b10: 2020 2020 5468 6520 6d65 6e75 2061 6e64 The menu and │ │ │ │ │ +00000b20: 2074 6865 2063 6f6d 6d61 6e64 2d6c 696e the command-lin │ │ │ │ │ +00000b30: 650a 2a20 456e 7669 726f 6e6d 656e 743a e.* Environment: │ │ │ │ │ +00000b40: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00000b50: 2020 4752 5542 2065 6e76 6972 6f6e 6d65 GRUB environme │ │ │ │ │ +00000b60: 6e74 2076 6172 6961 626c 6573 0a2a 2043 nt variables.* C │ │ │ │ │ +00000b70: 6f6d 6d61 6e64 733a 3a20 2020 2020 2020 ommands:: │ │ │ │ │ +00000b80: 2020 2020 2020 2020 2020 2020 2054 6865 The │ │ │ │ │ +00000b90: 206c 6973 7420 6f66 2061 7661 696c 6162 list of availab │ │ │ │ │ +00000ba0: 6c65 2062 7569 6c74 696e 2063 6f6d 6d61 le builtin comma │ │ │ │ │ +00000bb0: 6e64 730a 2a20 496e 7465 726e 6174 696f nds.* Internatio │ │ │ │ │ +00000bc0: 6e61 6c69 7361 7469 6f6e 3a3a 2020 2020 nalisation:: │ │ │ │ │ +00000bd0: 2020 2020 546f 7069 6373 2072 656c 6174 Topics relat │ │ │ │ │ +00000be0: 696e 6720 746f 206c 616e 6775 6167 6520 ing to language │ │ │ │ │ +00000bf0: 7375 7070 6f72 740a 2a20 5365 6375 7269 support.* Securi │ │ │ │ │ +00000c00: 7479 3a3a 2020 2020 2020 2020 2020 2020 ty:: │ │ │ │ │ +00000c10: 2020 2020 2020 2020 4175 7468 656e 7469 Authenti │ │ │ │ │ +00000c20: 6361 7469 6f6e 2c20 6175 7468 6f72 6973 cation, authoris │ │ │ │ │ +00000c30: 6174 696f 6e2c 2061 6e64 2073 6967 6e61 ation, and signa │ │ │ │ │ +00000c40: 7475 7265 730a 2a20 506c 6174 666f 726d tures.* Platform │ │ │ │ │ +00000c50: 206c 696d 6974 6174 696f 6e73 3a3a 2020 limitations:: │ │ │ │ │ +00000c60: 2020 2020 2020 5468 6520 6c69 7374 206f The list o │ │ │ │ │ +00000c70: 6620 706c 6174 666f 726d 2d73 7065 6369 f platform-speci │ │ │ │ │ +00000c80: 6669 6320 6c69 6d69 7461 7469 6f6e 730a fic limitations. │ │ │ │ │ +00000c90: 2a20 506c 6174 666f 726d 2d73 7065 6369 * Platform-speci │ │ │ │ │ +00000ca0: 6669 6320 6f70 6572 6174 696f 6e73 3a3a fic operations:: │ │ │ │ │ +00000cb0: 2050 6c61 7466 6f72 6d2d 7370 6563 6966 Platform-specif │ │ │ │ │ +00000cc0: 6963 206f 7065 7261 7469 6f6e 730a 2a20 ic operations.* │ │ │ │ │ +00000cd0: 5375 7070 6f72 7465 6420 6b65 726e 656c Supported kernel │ │ │ │ │ +00000ce0: 733a 3a20 2020 2020 2020 2020 2020 5468 s:: Th │ │ │ │ │ +00000cf0: 6520 6c69 7374 206f 6620 7375 7070 6f72 e list of suppor │ │ │ │ │ +00000d00: 7465 6420 6b65 726e 656c 730a 2a20 5472 ted kernels.* Tr │ │ │ │ │ +00000d10: 6f75 626c 6573 686f 6f74 696e 673a 3a20 oubleshooting:: │ │ │ │ │ +00000d20: 2020 2020 2020 2020 2020 2020 4572 726f Erro │ │ │ │ │ +00000d30: 7220 6d65 7373 6167 6573 2070 726f 6475 r messages produ │ │ │ │ │ +00000d40: 6365 6420 6279 2047 5255 420a 2a20 496e ced by GRUB.* In │ │ │ │ │ +00000d50: 766f 6b69 6e67 2067 7275 622d 696e 7374 voking grub-inst │ │ │ │ │ +00000d60: 616c 6c3a 3a20 2020 2020 2020 486f 7720 all:: How │ │ │ │ │ +00000d70: 746f 2075 7365 2074 6865 2047 5255 4220 to use the GRUB │ │ │ │ │ +00000d80: 696e 7374 616c 6c65 720a 2a20 496e 766f installer.* Invo │ │ │ │ │ +00000d90: 6b69 6e67 2067 7275 622d 6d6b 636f 6e66 king grub-mkconf │ │ │ │ │ +00000da0: 6967 3a3a 2020 2020 2020 4765 6e65 7261 ig:: Genera │ │ │ │ │ +00000db0: 7465 2061 2047 5255 4220 636f 6e66 6967 te a GRUB config │ │ │ │ │ +00000dc0: 7572 6174 696f 6e20 6669 6c65 0a2a 2049 uration file.* I │ │ │ │ │ +00000dd0: 6e76 6f6b 696e 6720 6772 7562 2d6d 6b70 nvoking grub-mkp │ │ │ │ │ +00000de0: 6173 7377 642d 7062 6b64 6632 3a3a 0a20 asswd-pbkdf2::. │ │ │ │ │ +00000df0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00000e00: 2020 2020 2020 2020 2020 2020 2020 2047 G │ │ │ │ │ +00000e10: 656e 6572 6174 6520 4752 5542 2070 6173 enerate GRUB pas │ │ │ │ │ +00000e20: 7377 6f72 6420 6861 7368 6573 0a2a 2049 sword hashes.* I │ │ │ │ │ +00000e30: 6e76 6f6b 696e 6720 6772 7562 2d6d 6b72 nvoking grub-mkr │ │ │ │ │ +00000e40: 656c 7061 7468 3a3a 2020 2020 204d 616b elpath:: Mak │ │ │ │ │ +00000e50: 6520 7379 7374 656d 2070 6174 6820 7265 e system path re │ │ │ │ │ +00000e60: 6c61 7469 7665 2074 6f20 6974 7320 726f lative to its ro │ │ │ │ │ +00000e70: 6f74 0a2a 2049 6e76 6f6b 696e 6720 6772 ot.* Invoking gr │ │ │ │ │ +00000e80: 7562 2d6d 6b72 6573 6375 653a 3a20 2020 ub-mkrescue:: │ │ │ │ │ +00000e90: 2020 204d 616b 6520 6120 4752 5542 2072 Make a GRUB r │ │ │ │ │ +00000ea0: 6573 6375 6520 696d 6167 650a 2a20 496e escue image.* In │ │ │ │ │ +00000eb0: 766f 6b69 6e67 2067 7275 622d 6d6f 756e voking grub-moun │ │ │ │ │ +00000ec0: 743a 3a20 2020 2020 2020 2020 4d6f 756e t:: Moun │ │ │ │ │ +00000ed0: 7420 6120 6669 6c65 2073 7973 7465 6d20 t a file system │ │ │ │ │ +00000ee0: 7573 696e 6720 4752 5542 0a2a 2049 6e76 using GRUB.* Inv │ │ │ │ │ +00000ef0: 6f6b 696e 6720 6772 7562 2d70 726f 6265 oking grub-probe │ │ │ │ │ +00000f00: 3a3a 2020 2020 2020 2020 2050 726f 6265 :: Probe │ │ │ │ │ +00000f10: 2064 6576 6963 6520 696e 666f 726d 6174 device informat │ │ │ │ │ +00000f20: 696f 6e20 666f 7220 4752 5542 0a2a 2049 ion for GRUB.* I │ │ │ │ │ +00000f30: 6e76 6f6b 696e 6720 6772 7562 2d73 6372 nvoking grub-scr │ │ │ │ │ +00000f40: 6970 742d 6368 6563 6b3a 3a20 2043 6865 ipt-check:: Che │ │ │ │ │ +00000f50: 636b 2047 5255 4220 7363 7269 7074 2066 ck GRUB script f │ │ │ │ │ +00000f60: 696c 6520 666f 7220 7379 6e74 6178 2065 ile for syntax e │ │ │ │ │ +00000f70: 7272 6f72 730a 2a20 4f62 7461 696e 696e rrors.* Obtainin │ │ │ │ │ +00000f80: 6720 616e 6420 4275 696c 6469 6e67 2047 g and Building G │ │ │ │ │ +00000f90: 5255 423a 3a20 486f 7720 746f 206f 6274 RUB:: How to obt │ │ │ │ │ +00000fa0: 6169 6e20 616e 6420 6275 696c 6420 4752 ain and build GR │ │ │ │ │ +00000fb0: 5542 0a2a 2052 6570 6f72 7469 6e67 2062 UB.* Reporting b │ │ │ │ │ +00000fc0: 7567 733a 3a20 2020 2020 2020 2020 2020 ugs:: │ │ │ │ │ +00000fd0: 2020 2057 6865 7265 2079 6f75 2073 686f Where you sho │ │ │ │ │ +00000fe0: 756c 6420 7365 6e64 2061 2062 7567 2072 uld send a bug r │ │ │ │ │ +00000ff0: 6570 6f72 740a 2a20 4675 7475 7265 3a3a eport.* Future:: │ │ │ │ │ +00001000: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00001010: 2020 2020 2020 536f 6d65 2066 7574 7572 Some futur │ │ │ │ │ +00001020: 6520 706c 616e 7320 6f6e 2047 5255 420a e plans on GRUB. │ │ │ │ │ +00001030: 2a20 436f 7079 696e 6720 5468 6973 204d * Copying This M │ │ │ │ │ +00001040: 616e 7561 6c3a 3a20 2020 2020 2020 2020 anual:: │ │ │ │ │ +00001050: 436f 7079 696e 6720 5468 6973 204d 616e Copying This Man │ │ │ │ │ +00001060: 7561 6c0a 2a20 496e 6465 783a 3a0a 0a1f ual.* Index::... │ │ │ │ │ +00001070: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ +00001080: 2c20 204e 6f64 653a 2049 6e74 726f 6475 , Node: Introdu │ │ │ │ │ +00001090: 6374 696f 6e2c 2020 4e65 7874 3a20 4e61 ction, Next: Na │ │ │ │ │ +000010a0: 6d69 6e67 2063 6f6e 7665 6e74 696f 6e2c ming convention, │ │ │ │ │ +000010b0: 2020 5072 6576 3a20 546f 702c 2020 5570 Prev: Top, Up │ │ │ │ │ +000010c0: 3a20 546f 700a 0a31 2049 6e74 726f 6475 : Top..1 Introdu │ │ │ │ │ +000010d0: 6374 696f 6e20 746f 2047 5255 420a 2a2a ction to GRUB.** │ │ │ │ │ 000010e0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -000010f0: 2a2a 2a2a 2a2a 0a0a 2a20 4d65 6e75 3a0a ******..* Menu:. │ │ │ │ │ -00001100: 0a2a 204f 7665 7276 6965 773a 3a20 2020 .* Overview:: │ │ │ │ │ -00001110: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001120: 2057 6861 7420 6578 6163 746c 7920 4752 What exactly GR │ │ │ │ │ -00001130: 5542 2069 7320 616e 6420 686f 7720 746f UB is and how to │ │ │ │ │ -00001140: 2075 7365 2069 740a 2a20 4869 7374 6f72 use it.* Histor │ │ │ │ │ -00001150: 793a 3a20 2020 2020 2020 2020 2020 2020 y:: │ │ │ │ │ -00001160: 2020 2020 2020 2020 4672 6f6d 206d 6167 From mag │ │ │ │ │ -00001170: 676f 7420 746f 2068 6f75 7365 2066 6c79 got to house fly │ │ │ │ │ -00001180: 0a2a 2043 6861 6e67 6573 2066 726f 6d20 .* Changes from │ │ │ │ │ -00001190: 4752 5542 204c 6567 6163 793a 3a20 2020 GRUB Legacy:: │ │ │ │ │ -000011a0: 2044 6966 6665 7265 6e63 6573 2066 726f Differences fro │ │ │ │ │ -000011b0: 6d20 7072 6576 696f 7573 2076 6572 7369 m previous versi │ │ │ │ │ -000011c0: 6f6e 730a 2a20 4665 6174 7572 6573 3a3a ons.* Features:: │ │ │ │ │ +000010f0: 2a2a 2a2a 0a0a 2a20 4d65 6e75 3a0a 0a2a ****..* Menu:..* │ │ │ │ │ +00001100: 204f 7665 7276 6965 773a 3a20 2020 2020 Overview:: │ │ │ │ │ +00001110: 2020 2020 2020 2020 2020 2020 2020 2057 W │ │ │ │ │ +00001120: 6861 7420 6578 6163 746c 7920 4752 5542 hat exactly GRUB │ │ │ │ │ +00001130: 2069 7320 616e 6420 686f 7720 746f 2075 is and how to u │ │ │ │ │ +00001140: 7365 2069 740a 2a20 4869 7374 6f72 793a se it.* History: │ │ │ │ │ +00001150: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00001160: 2020 2020 2020 4672 6f6d 206d 6167 676f From maggo │ │ │ │ │ +00001170: 7420 746f 2068 6f75 7365 2066 6c79 0a2a t to house fly.* │ │ │ │ │ +00001180: 2043 6861 6e67 6573 2066 726f 6d20 4752 Changes from GR │ │ │ │ │ +00001190: 5542 204c 6567 6163 793a 3a20 2020 2044 UB Legacy:: D │ │ │ │ │ +000011a0: 6966 6665 7265 6e63 6573 2066 726f 6d20 ifferences from │ │ │ │ │ +000011b0: 7072 6576 696f 7573 2076 6572 7369 6f6e previous version │ │ │ │ │ +000011c0: 730a 2a20 4665 6174 7572 6573 3a3a 2020 s.* Features:: │ │ │ │ │ 000011d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000011e0: 2020 2020 4752 5542 2066 6561 7475 7265 GRUB feature │ │ │ │ │ -000011f0: 730a 2a20 526f 6c65 206f 6620 6120 626f s.* Role of a bo │ │ │ │ │ -00001200: 6f74 206c 6f61 6465 723a 3a20 2020 2020 ot loader:: │ │ │ │ │ -00001210: 2020 5468 6520 726f 6c65 206f 6620 6120 The role of a │ │ │ │ │ -00001220: 626f 6f74 206c 6f61 6465 720a 0a1f 0a46 boot loader....F │ │ │ │ │ -00001230: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ -00001240: 204e 6f64 653a 204f 7665 7276 6965 772c Node: Overview, │ │ │ │ │ -00001250: 2020 4e65 7874 3a20 4869 7374 6f72 792c Next: History, │ │ │ │ │ -00001260: 2020 5570 3a20 496e 7472 6f64 7563 7469 Up: Introducti │ │ │ │ │ -00001270: 6f6e 0a0a 312e 3120 4f76 6572 7669 6577 on..1.1 Overview │ │ │ │ │ -00001280: 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a42 .============..B │ │ │ │ │ -00001290: 7269 6566 6c79 2c20 6120 2262 6f6f 7420 riefly, a "boot │ │ │ │ │ -000012a0: 6c6f 6164 6572 2220 6973 2074 6865 2066 loader" is the f │ │ │ │ │ -000012b0: 6972 7374 2073 6f66 7477 6172 6520 7072 irst software pr │ │ │ │ │ -000012c0: 6f67 7261 6d20 7468 6174 2072 756e 7320 ogram that runs │ │ │ │ │ -000012d0: 7768 656e 2061 0a63 6f6d 7075 7465 7220 when a.computer │ │ │ │ │ -000012e0: 7374 6172 7473 2e20 2049 7420 6973 2072 starts. It is r │ │ │ │ │ -000012f0: 6573 706f 6e73 6962 6c65 2066 6f72 206c esponsible for l │ │ │ │ │ -00001300: 6f61 6469 6e67 2061 6e64 2074 7261 6e73 oading and trans │ │ │ │ │ -00001310: 6665 7272 696e 6720 636f 6e74 726f 6c0a ferring control. │ │ │ │ │ -00001320: 746f 2061 6e20 6f70 6572 6174 696e 6720 to an operating │ │ │ │ │ -00001330: 7379 7374 656d 2022 6b65 726e 656c 2220 system "kernel" │ │ │ │ │ -00001340: 736f 6674 7761 7265 2028 7375 6368 2061 software (such a │ │ │ │ │ -00001350: 7320 4c69 6e75 7820 6f72 2047 4e55 204d s Linux or GNU M │ │ │ │ │ -00001360: 6163 6829 2e0a 5468 6520 6b65 726e 656c ach)..The kernel │ │ │ │ │ -00001370: 2c20 696e 2074 7572 6e2c 2069 6e69 7469 , in turn, initi │ │ │ │ │ -00001380: 616c 697a 6573 2074 6865 2072 6573 7420 alizes the rest │ │ │ │ │ -00001390: 6f66 2074 6865 206f 7065 7261 7469 6e67 of the operating │ │ │ │ │ -000013a0: 2073 7973 7465 6d20 2865 2e67 2e0a 6120 system (e.g..a │ │ │ │ │ -000013b0: 474e 5520 7379 7374 656d 292e 0a0a 2020 GNU system)... │ │ │ │ │ -000013c0: 2047 4e55 2047 5255 4220 6973 2061 2076 GNU GRUB is a v │ │ │ │ │ -000013d0: 6572 7920 706f 7765 7266 756c 2062 6f6f ery powerful boo │ │ │ │ │ -000013e0: 7420 6c6f 6164 6572 2c20 7768 6963 6820 t loader, which │ │ │ │ │ -000013f0: 6361 6e20 6c6f 6164 2061 2077 6964 650a can load a wide. │ │ │ │ │ -00001400: 7661 7269 6574 7920 6f66 2066 7265 6520 variety of free │ │ │ │ │ -00001410: 6f70 6572 6174 696e 6720 7379 7374 656d operating system │ │ │ │ │ -00001420: 732c 2061 7320 7765 6c6c 2061 7320 7072 s, as well as pr │ │ │ │ │ -00001430: 6f70 7269 6574 6172 7920 6f70 6572 6174 oprietary operat │ │ │ │ │ -00001440: 696e 670a 7379 7374 656d 7320 7769 7468 ing.systems with │ │ │ │ │ -00001450: 2063 6861 696e 2d6c 6f61 6469 6e67 2831 chain-loading(1 │ │ │ │ │ -00001460: 2920 282a 6e6f 7465 204f 7665 7276 6965 ) (*note Overvie │ │ │ │ │ -00001470: 772d 466f 6f74 6e6f 7465 2d31 3a3a 292e w-Footnote-1::). │ │ │ │ │ -00001480: 2020 4752 5542 2069 730a 6465 7369 676e GRUB is.design │ │ │ │ │ -00001490: 6564 2074 6f20 6164 6472 6573 7320 7468 ed to address th │ │ │ │ │ -000014a0: 6520 636f 6d70 6c65 7869 7479 206f 6620 e complexity of │ │ │ │ │ -000014b0: 626f 6f74 696e 6720 6120 7065 7273 6f6e booting a person │ │ │ │ │ -000014c0: 616c 2063 6f6d 7075 7465 723b 2062 6f74 al computer; bot │ │ │ │ │ -000014d0: 680a 7468 6520 7072 6f67 7261 6d20 616e h.the program an │ │ │ │ │ -000014e0: 6420 7468 6973 206d 616e 7561 6c20 6172 d this manual ar │ │ │ │ │ -000014f0: 6520 7469 6768 746c 7920 626f 756e 6420 e tightly bound │ │ │ │ │ -00001500: 746f 2074 6861 7420 636f 6d70 7574 6572 to that computer │ │ │ │ │ -00001510: 2070 6c61 7466 6f72 6d2c 0a61 6c74 686f platform,.altho │ │ │ │ │ -00001520: 7567 6820 706f 7274 696e 6720 746f 206f ugh porting to o │ │ │ │ │ -00001530: 7468 6572 2070 6c61 7466 6f72 6d73 206d ther platforms m │ │ │ │ │ -00001540: 6179 2062 6520 6164 6472 6573 7365 6420 ay be addressed │ │ │ │ │ -00001550: 696e 2074 6865 2066 7574 7572 652e 0a0a in the future... │ │ │ │ │ -00001560: 2020 204f 6e65 206f 6620 7468 6520 696d One of the im │ │ │ │ │ -00001570: 706f 7274 616e 7420 6665 6174 7572 6573 portant features │ │ │ │ │ -00001580: 2069 6e20 4752 5542 2069 7320 666c 6578 in GRUB is flex │ │ │ │ │ -00001590: 6962 696c 6974 793b 2047 5255 420a 756e ibility; GRUB.un │ │ │ │ │ -000015a0: 6465 7273 7461 6e64 7320 6669 6c65 7379 derstands filesy │ │ │ │ │ -000015b0: 7374 656d 7320 616e 6420 6b65 726e 656c stems and kernel │ │ │ │ │ -000015c0: 2065 7865 6375 7461 626c 6520 666f 726d executable form │ │ │ │ │ -000015d0: 6174 732c 2073 6f20 796f 7520 6361 6e20 ats, so you can │ │ │ │ │ -000015e0: 6c6f 6164 0a61 6e20 6172 6269 7472 6172 load.an arbitrar │ │ │ │ │ -000015f0: 7920 6f70 6572 6174 696e 6720 7379 7374 y operating syst │ │ │ │ │ -00001600: 656d 2074 6865 2077 6179 2079 6f75 206c em the way you l │ │ │ │ │ -00001610: 696b 652c 2077 6974 686f 7574 2072 6563 ike, without rec │ │ │ │ │ -00001620: 6f72 6469 6e67 2074 6865 0a70 6879 7369 ording the.physi │ │ │ │ │ -00001630: 6361 6c20 706f 7369 7469 6f6e 206f 6620 cal position of │ │ │ │ │ -00001640: 796f 7572 206b 6572 6e65 6c20 6f6e 2074 your kernel on t │ │ │ │ │ -00001650: 6865 2064 6973 6b2e 2020 5468 7573 2079 he disk. Thus y │ │ │ │ │ -00001660: 6f75 2063 616e 206c 6f61 6420 7468 650a ou can load the. │ │ │ │ │ -00001670: 6b65 726e 656c 206a 7573 7420 6279 2073 kernel just by s │ │ │ │ │ -00001680: 7065 6369 6679 696e 6720 6974 7320 6669 pecifying its fi │ │ │ │ │ -00001690: 6c65 206e 616d 6520 616e 6420 7468 6520 le name and the │ │ │ │ │ -000016a0: 6472 6976 6520 616e 6420 7061 7274 6974 drive and partit │ │ │ │ │ -000016b0: 696f 6e0a 7768 6572 6520 7468 6520 6b65 ion.where the ke │ │ │ │ │ -000016c0: 726e 656c 2072 6573 6964 6573 2e0a 0a20 rnel resides... │ │ │ │ │ -000016d0: 2020 5768 656e 2062 6f6f 7469 6e67 2077 When booting w │ │ │ │ │ -000016e0: 6974 6820 4752 5542 2c20 796f 7520 6361 ith GRUB, you ca │ │ │ │ │ -000016f0: 6e20 7573 6520 6569 7468 6572 2061 2063 n use either a c │ │ │ │ │ -00001700: 6f6d 6d61 6e64 2d6c 696e 6520 696e 7465 ommand-line inte │ │ │ │ │ -00001710: 7266 6163 650a 282a 6e6f 7465 2043 6f6d rface.(*note Com │ │ │ │ │ -00001720: 6d61 6e64 2d6c 696e 6520 696e 7465 7266 mand-line interf │ │ │ │ │ -00001730: 6163 653a 3a29 2c20 6f72 2061 206d 656e ace::), or a men │ │ │ │ │ -00001740: 7520 696e 7465 7266 6163 6520 282a 6e6f u interface (*no │ │ │ │ │ -00001750: 7465 204d 656e 750a 696e 7465 7266 6163 te Menu.interfac │ │ │ │ │ -00001760: 653a 3a29 2e20 2055 7369 6e67 2074 6865 e::). Using the │ │ │ │ │ -00001770: 2063 6f6d 6d61 6e64 2d6c 696e 6520 696e command-line in │ │ │ │ │ -00001780: 7465 7266 6163 652c 2079 6f75 2074 7970 terface, you typ │ │ │ │ │ -00001790: 6520 7468 6520 6472 6976 650a 7370 6563 e the drive.spec │ │ │ │ │ -000017a0: 6966 6963 6174 696f 6e20 616e 6420 6669 ification and fi │ │ │ │ │ -000017b0: 6c65 206e 616d 6520 6f66 2074 6865 206b le name of the k │ │ │ │ │ -000017c0: 6572 6e65 6c20 6d61 6e75 616c 6c79 2e20 ernel manually. │ │ │ │ │ -000017d0: 2049 6e20 7468 6520 6d65 6e75 0a69 6e74 In the menu.int │ │ │ │ │ -000017e0: 6572 6661 6365 2c20 796f 7520 6a75 7374 erface, you just │ │ │ │ │ -000017f0: 2073 656c 6563 7420 616e 204f 5320 7573 select an OS us │ │ │ │ │ -00001800: 696e 6720 7468 6520 6172 726f 7720 6b65 ing the arrow ke │ │ │ │ │ -00001810: 7973 2e20 2054 6865 206d 656e 7520 6973 ys. The menu is │ │ │ │ │ -00001820: 0a62 6173 6564 206f 6e20 6120 636f 6e66 .based on a conf │ │ │ │ │ -00001830: 6967 7572 6174 696f 6e20 6669 6c65 2077 iguration file w │ │ │ │ │ -00001840: 6869 6368 2079 6f75 2070 7265 7061 7265 hich you prepare │ │ │ │ │ -00001850: 2062 6566 6f72 6568 616e 6420 282a 6e6f beforehand (*no │ │ │ │ │ -00001860: 7465 0a43 6f6e 6669 6775 7261 7469 6f6e te.Configuration │ │ │ │ │ -00001870: 3a3a 292e 2020 5768 696c 6520 696e 2074 ::). While in t │ │ │ │ │ -00001880: 6865 206d 656e 752c 2079 6f75 2063 616e he menu, you can │ │ │ │ │ -00001890: 2073 7769 7463 6820 746f 2074 6865 2063 switch to the c │ │ │ │ │ -000018a0: 6f6d 6d61 6e64 2d6c 696e 650a 6d6f 6465 ommand-line.mode │ │ │ │ │ -000018b0: 2c20 616e 6420 7669 6365 2d76 6572 7361 , and vice-versa │ │ │ │ │ -000018c0: 2e20 2059 6f75 2063 616e 2065 7665 6e20 . You can even │ │ │ │ │ -000018d0: 6564 6974 206d 656e 7520 656e 7472 6965 edit menu entrie │ │ │ │ │ -000018e0: 7320 6265 666f 7265 2075 7369 6e67 2074 s before using t │ │ │ │ │ -000018f0: 6865 6d2e 0a0a 2020 2049 6e20 7468 6520 hem... In the │ │ │ │ │ -00001900: 666f 6c6c 6f77 696e 6720 6368 6170 7465 following chapte │ │ │ │ │ -00001910: 7273 2c20 796f 7520 7769 6c6c 206c 6561 rs, you will lea │ │ │ │ │ -00001920: 726e 2068 6f77 2074 6f20 7370 6563 6966 rn how to specif │ │ │ │ │ -00001930: 7920 6120 6472 6976 652c 2061 0a70 6172 y a drive, a.par │ │ │ │ │ -00001940: 7469 7469 6f6e 2c20 616e 6420 6120 6669 tition, and a fi │ │ │ │ │ -00001950: 6c65 206e 616d 6520 282a 6e6f 7465 204e le name (*note N │ │ │ │ │ -00001960: 616d 696e 6720 636f 6e76 656e 7469 6f6e aming convention │ │ │ │ │ -00001970: 3a3a 2920 746f 2047 5255 422c 2068 6f77 ::) to GRUB, how │ │ │ │ │ -00001980: 2074 6f0a 696e 7374 616c 6c20 4752 5542 to.install GRUB │ │ │ │ │ -00001990: 206f 6e20 796f 7572 2064 7269 7665 2028 on your drive ( │ │ │ │ │ -000019a0: 2a6e 6f74 6520 496e 7374 616c 6c61 7469 *note Installati │ │ │ │ │ -000019b0: 6f6e 3a3a 292c 2061 6e64 2068 6f77 2074 on::), and how t │ │ │ │ │ -000019c0: 6f20 626f 6f74 2079 6f75 720a 4f53 6573 o boot your.OSes │ │ │ │ │ -000019d0: 2028 2a6e 6f74 6520 426f 6f74 696e 673a (*note Booting: │ │ │ │ │ -000019e0: 3a29 2c20 7374 6570 2062 7920 7374 6570 :), step by step │ │ │ │ │ -000019f0: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ -00001a00: 696e 666f 2c20 204e 6f64 653a 204f 7665 info, Node: Ove │ │ │ │ │ -00001a10: 7276 6965 772d 466f 6f74 6e6f 7465 732c rview-Footnotes, │ │ │ │ │ -00001a20: 2020 5570 3a20 4f76 6572 7669 6577 0a0a Up: Overview.. │ │ │ │ │ -00001a30: 2020 2028 3129 2022 6368 6169 6e2d 6c6f (1) "chain-lo │ │ │ │ │ -00001a40: 6164 2220 6973 2074 6865 206d 6563 6861 ad" is the mecha │ │ │ │ │ -00001a50: 6e69 736d 2066 6f72 206c 6f61 6469 6e67 nism for loading │ │ │ │ │ -00001a60: 2075 6e73 7570 706f 7274 6564 206f 7065 unsupported ope │ │ │ │ │ -00001a70: 7261 7469 6e67 0a73 7973 7465 6d73 2062 rating.systems b │ │ │ │ │ -00001a80: 7920 6c6f 6164 696e 6720 616e 6f74 6865 y loading anothe │ │ │ │ │ -00001a90: 7220 626f 6f74 206c 6f61 6465 722e 2020 r boot loader. │ │ │ │ │ -00001aa0: 4974 2069 7320 7479 7069 6361 6c6c 7920 It is typically │ │ │ │ │ -00001ab0: 7573 6564 2066 6f72 0a6c 6f61 6469 6e67 used for.loading │ │ │ │ │ -00001ac0: 2044 4f53 206f 7220 5769 6e64 6f77 732e DOS or Windows. │ │ │ │ │ -00001ad0: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ -00001ae0: 6e66 6f2c 2020 4e6f 6465 3a20 4869 7374 nfo, Node: Hist │ │ │ │ │ -00001af0: 6f72 792c 2020 4e65 7874 3a20 4368 616e ory, Next: Chan │ │ │ │ │ -00001b00: 6765 7320 6672 6f6d 2047 5255 4220 4c65 ges from GRUB Le │ │ │ │ │ -00001b10: 6761 6379 2c20 2050 7265 763a 204f 7665 gacy, Prev: Ove │ │ │ │ │ -00001b20: 7276 6965 772c 2020 5570 3a20 496e 7472 rview, Up: Intr │ │ │ │ │ -00001b30: 6f64 7563 7469 6f6e 0a0a 312e 3220 4869 oduction..1.2 Hi │ │ │ │ │ -00001b40: 7374 6f72 7920 6f66 2047 5255 420a 3d3d story of GRUB.== │ │ │ │ │ -00001b50: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00001b60: 3d0a 0a47 5255 4220 6f72 6967 696e 6174 =..GRUB originat │ │ │ │ │ -00001b70: 6564 2069 6e20 3139 3935 2077 6865 6e20 ed in 1995 when │ │ │ │ │ -00001b80: 4572 6963 6820 426f 6c65 796e 2077 6173 Erich Boleyn was │ │ │ │ │ -00001b90: 2074 7279 696e 6720 746f 2062 6f6f 7420 trying to boot │ │ │ │ │ -00001ba0: 7468 6520 474e 550a 4875 7264 2077 6974 the GNU.Hurd wit │ │ │ │ │ -00001bb0: 6820 7468 6520 556e 6976 6572 7369 7479 h the University │ │ │ │ │ -00001bc0: 206f 6620 5574 6168 2773 204d 6163 6820 of Utah's Mach │ │ │ │ │ -00001bd0: 3420 6d69 6372 6f6b 6572 6e65 6c20 286e 4 microkernel (n │ │ │ │ │ -00001be0: 6f77 206b 6e6f 776e 2061 7320 474e 550a ow known as GNU. │ │ │ │ │ -00001bf0: 4d61 6368 292e 2020 4572 6963 6820 616e Mach). Erich an │ │ │ │ │ -00001c00: 6420 4272 6961 6e20 466f 7264 2064 6573 d Brian Ford des │ │ │ │ │ -00001c10: 6967 6e65 6420 7468 6520 4d75 6c74 6962 igned the Multib │ │ │ │ │ -00001c20: 6f6f 7420 5370 6563 6966 6963 6174 696f oot Specificatio │ │ │ │ │ -00001c30: 6e20 282a 6e6f 7465 0a4d 756c 7469 626f n (*note.Multibo │ │ │ │ │ -00001c40: 6f74 2053 7065 6369 6669 6361 7469 6f6e ot Specification │ │ │ │ │ -00001c50: 3a20 286d 756c 7469 626f 6f74 2954 6f70 : (multiboot)Top │ │ │ │ │ -00001c60: 2e29 2c20 6265 6361 7573 6520 7468 6579 .), because they │ │ │ │ │ -00001c70: 2077 6572 6520 6465 7465 726d 696e 6564 were determined │ │ │ │ │ -00001c80: 0a6e 6f74 2074 6f20 6164 6420 746f 2074 .not to add to t │ │ │ │ │ -00001c90: 6865 206c 6172 6765 206e 756d 6265 7220 he large number │ │ │ │ │ -00001ca0: 6f66 206d 7574 7561 6c6c 792d 696e 636f of mutually-inco │ │ │ │ │ -00001cb0: 6d70 6174 6962 6c65 2050 4320 626f 6f74 mpatible PC boot │ │ │ │ │ -00001cc0: 206d 6574 686f 6473 2e0a 0a20 2020 4572 methods... Er │ │ │ │ │ -00001cd0: 6963 6820 7468 656e 2062 6567 616e 206d ich then began m │ │ │ │ │ -00001ce0: 6f64 6966 7969 6e67 2074 6865 2046 7265 odifying the Fre │ │ │ │ │ -00001cf0: 6542 5344 2062 6f6f 7420 6c6f 6164 6572 eBSD boot loader │ │ │ │ │ -00001d00: 2073 6f20 7468 6174 2069 7420 776f 756c so that it woul │ │ │ │ │ -00001d10: 640a 756e 6465 7273 7461 6e64 204d 756c d.understand Mul │ │ │ │ │ -00001d20: 7469 626f 6f74 2e20 2048 6520 736f 6f6e tiboot. He soon │ │ │ │ │ -00001d30: 2072 6561 6c69 7a65 6420 7468 6174 2069 realized that i │ │ │ │ │ -00001d40: 7420 776f 756c 6420 6265 2061 206c 6f74 t would be a lot │ │ │ │ │ -00001d50: 2065 6173 6965 7220 746f 0a77 7269 7465 easier to.write │ │ │ │ │ -00001d60: 2068 6973 206f 776e 2062 6f6f 7420 6c6f his own boot lo │ │ │ │ │ -00001d70: 6164 6572 2066 726f 6d20 7363 7261 7463 ader from scratc │ │ │ │ │ -00001d80: 6820 7468 616e 2074 6f20 6b65 6570 2077 h than to keep w │ │ │ │ │ -00001d90: 6f72 6b69 6e67 206f 6e20 7468 650a 4672 orking on the.Fr │ │ │ │ │ -00001da0: 6565 4253 4420 626f 6f74 206c 6f61 6465 eeBSD boot loade │ │ │ │ │ -00001db0: 722c 2061 6e64 2073 6f20 4752 5542 2077 r, and so GRUB w │ │ │ │ │ -00001dc0: 6173 2062 6f72 6e2e 0a0a 2020 2045 7269 as born... Eri │ │ │ │ │ -00001dd0: 6368 2061 6464 6564 206d 616e 7920 6665 ch added many fe │ │ │ │ │ -00001de0: 6174 7572 6573 2074 6f20 4752 5542 2c20 atures to GRUB, │ │ │ │ │ -00001df0: 6275 7420 6f74 6865 7220 7072 696f 7269 but other priori │ │ │ │ │ -00001e00: 7469 6573 2070 7265 7665 6e74 6564 2068 ties prevented h │ │ │ │ │ -00001e10: 696d 0a66 726f 6d20 6b65 6570 696e 6720 im.from keeping │ │ │ │ │ -00001e20: 7570 2077 6974 6820 7468 6520 6465 6d61 up with the dema │ │ │ │ │ -00001e30: 6e64 7320 6f66 2069 7473 2071 7569 636b nds of its quick │ │ │ │ │ -00001e40: 6c79 2d65 7870 616e 6469 6e67 2075 7365 ly-expanding use │ │ │ │ │ -00001e50: 7220 6261 7365 2e20 2049 6e0a 3139 3939 r base. In.1999 │ │ │ │ │ -00001e60: 2c20 476f 7264 6f6e 204d 6174 7a69 676b , Gordon Matzigk │ │ │ │ │ -00001e70: 6569 7420 616e 6420 596f 7368 696e 6f72 eit and Yoshinor │ │ │ │ │ -00001e80: 6920 4b2e 204f 6b75 6a69 2061 646f 7074 i K. Okuji adopt │ │ │ │ │ -00001e90: 6564 2047 5255 4220 6173 2061 6e0a 6f66 ed GRUB as an.of │ │ │ │ │ -00001ea0: 6669 6369 616c 2047 4e55 2070 6163 6b61 ficial GNU packa │ │ │ │ │ -00001eb0: 6765 2c20 616e 6420 6f70 656e 6564 2069 ge, and opened i │ │ │ │ │ -00001ec0: 7473 2064 6576 656c 6f70 6d65 6e74 2062 ts development b │ │ │ │ │ -00001ed0: 7920 6d61 6b69 6e67 2074 6865 206c 6174 y making the lat │ │ │ │ │ -00001ee0: 6573 740a 736f 7572 6365 7320 6176 6169 est.sources avai │ │ │ │ │ -00001ef0: 6c61 626c 6520 7669 6120 616e 6f6e 796d lable via anonym │ │ │ │ │ -00001f00: 6f75 7320 4356 532e 202a 4e6f 7465 204f ous CVS. *Note O │ │ │ │ │ -00001f10: 6274 6169 6e69 6e67 2061 6e64 2042 7569 btaining and Bui │ │ │ │ │ -00001f20: 6c64 696e 670a 4752 5542 3a3a 2c20 666f lding.GRUB::, fo │ │ │ │ │ -00001f30: 7220 6d6f 7265 2069 6e66 6f72 6d61 7469 r more informati │ │ │ │ │ -00001f40: 6f6e 2e0a 0a20 2020 4f76 6572 2074 6865 on... Over the │ │ │ │ │ -00001f50: 206e 6578 7420 6665 7720 7965 6172 732c next few years, │ │ │ │ │ -00001f60: 2047 5255 4220 7761 7320 6578 7465 6e64 GRUB was extend │ │ │ │ │ -00001f70: 6564 2074 6f20 6d65 6574 206d 616e 7920 ed to meet many │ │ │ │ │ -00001f80: 6e65 6564 732c 2062 7574 2069 740a 7175 needs, but it.qu │ │ │ │ │ -00001f90: 6963 6b6c 7920 6265 6361 6d65 2063 6c65 ickly became cle │ │ │ │ │ -00001fa0: 6172 2074 6861 7420 6974 7320 6465 7369 ar that its desi │ │ │ │ │ -00001fb0: 676e 2077 6173 206e 6f74 206b 6565 7069 gn was not keepi │ │ │ │ │ -00001fc0: 6e67 2075 7020 7769 7468 2074 6865 0a65 ng up with the.e │ │ │ │ │ -00001fd0: 7874 656e 7369 6f6e 7320 6265 696e 6720 xtensions being │ │ │ │ │ -00001fe0: 6d61 6465 2074 6f20 6974 2c20 616e 6420 made to it, and │ │ │ │ │ -00001ff0: 7765 2072 6561 6368 6564 2074 6865 2070 we reached the p │ │ │ │ │ -00002000: 6f69 6e74 2077 6865 7265 2069 7420 7761 oint where it wa │ │ │ │ │ -00002010: 7320 7665 7279 0a64 6966 6669 6375 6c74 s very.difficult │ │ │ │ │ -00002020: 2074 6f20 6d61 6b65 2061 6e79 2066 7572 to make any fur │ │ │ │ │ -00002030: 7468 6572 2063 6861 6e67 6573 2077 6974 ther changes wit │ │ │ │ │ -00002040: 686f 7574 2062 7265 616b 696e 6720 6578 hout breaking ex │ │ │ │ │ -00002050: 6973 7469 6e67 0a66 6561 7475 7265 732e isting.features. │ │ │ │ │ -00002060: 2020 4172 6f75 6e64 2032 3030 322c 2059 Around 2002, Y │ │ │ │ │ -00002070: 6f73 6869 6e6f 7269 204b 2e20 4f6b 756a oshinori K. Okuj │ │ │ │ │ -00002080: 6920 7374 6172 7465 6420 776f 726b 206f i started work o │ │ │ │ │ -00002090: 6e20 5055 5041 0a28 5072 656c 696d 696e n PUPA.(Prelimin │ │ │ │ │ -000020a0: 6172 7920 556e 6976 6572 7361 6c20 5072 ary Universal Pr │ │ │ │ │ -000020b0: 6f67 7261 6d6d 696e 6720 4172 6368 6974 ogramming Archit │ │ │ │ │ -000020c0: 6563 7475 7265 2066 6f72 2047 4e55 2047 ecture for GNU G │ │ │ │ │ -000020d0: 5255 4229 2c20 6169 6d69 6e67 2074 6f0a RUB), aiming to. │ │ │ │ │ -000020e0: 7265 7772 6974 6520 7468 6520 636f 7265 rewrite the core │ │ │ │ │ -000020f0: 206f 6620 4752 5542 2074 6f20 6d61 6b65 of GRUB to make │ │ │ │ │ -00002100: 2069 7420 636c 6561 6e65 722c 2073 6166 it cleaner, saf │ │ │ │ │ -00002110: 6572 2c20 6d6f 7265 2072 6f62 7573 742c er, more robust, │ │ │ │ │ -00002120: 2061 6e64 0a6d 6f72 6520 706f 7765 7266 and.more powerf │ │ │ │ │ -00002130: 756c 2e20 2050 5550 4120 7761 7320 6576 ul. PUPA was ev │ │ │ │ │ -00002140: 656e 7475 616c 6c79 2072 656e 616d 6564 entually renamed │ │ │ │ │ -00002150: 2074 6f20 4752 5542 2032 2c20 616e 6420 to GRUB 2, and │ │ │ │ │ -00002160: 7468 6520 6f72 6967 696e 616c 0a76 6572 the original.ver │ │ │ │ │ -00002170: 7369 6f6e 206f 6620 4752 5542 2077 6173 sion of GRUB was │ │ │ │ │ -00002180: 2072 656e 616d 6564 2074 6f20 4752 5542 renamed to GRUB │ │ │ │ │ -00002190: 204c 6567 6163 792e 2020 536d 616c 6c20 Legacy. Small │ │ │ │ │ -000021a0: 616d 6f75 6e74 7320 6f66 0a6d 6169 6e74 amounts of.maint │ │ │ │ │ -000021b0: 656e 616e 6365 2063 6f6e 7469 6e75 6564 enance continued │ │ │ │ │ -000021c0: 2074 6f20 6265 2064 6f6e 6520 6f6e 2047 to be done on G │ │ │ │ │ -000021d0: 5255 4220 4c65 6761 6379 2c20 6275 7420 RUB Legacy, but │ │ │ │ │ -000021e0: 7468 6520 6c61 7374 2072 656c 6561 7365 the last release │ │ │ │ │ -000021f0: 0a28 302e 3937 2920 7761 7320 6d61 6465 .(0.97) was made │ │ │ │ │ -00002200: 2069 6e20 3230 3035 2061 6e64 2061 7420 in 2005 and at │ │ │ │ │ -00002210: 7468 6520 7469 6d65 206f 6620 7772 6974 the time of writ │ │ │ │ │ -00002220: 696e 6720 6974 2073 6565 6d73 2075 6e6c ing it seems unl │ │ │ │ │ -00002230: 696b 656c 790a 7468 6174 2074 6865 7265 ikely.that there │ │ │ │ │ -00002240: 2077 696c 6c20 6265 2061 6e6f 7468 6572 will be another │ │ │ │ │ -00002250: 2e0a 0a20 2020 4279 2061 726f 756e 6420 ... By around │ │ │ │ │ -00002260: 3230 3037 2c20 474e 552f 4c69 6e75 7820 2007, GNU/Linux │ │ │ │ │ -00002270: 6469 7374 7269 6275 7469 6f6e 7320 7374 distributions st │ │ │ │ │ -00002280: 6172 7465 6420 746f 2075 7365 2047 5255 arted to use GRU │ │ │ │ │ -00002290: 4220 3220 746f 0a6c 696d 6974 6564 2065 B 2 to.limited e │ │ │ │ │ -000022a0: 7874 656e 7473 2c20 616e 6420 6279 2074 xtents, and by t │ │ │ │ │ -000022b0: 6865 2065 6e64 206f 6620 3230 3039 206d he end of 2009 m │ │ │ │ │ -000022c0: 756c 7469 706c 6520 6d61 6a6f 7220 6469 ultiple major di │ │ │ │ │ -000022d0: 7374 7269 6275 7469 6f6e 730a 7765 7265 stributions.were │ │ │ │ │ -000022e0: 2069 6e73 7461 6c6c 696e 6720 6974 2062 installing it b │ │ │ │ │ -000022f0: 7920 6465 6661 756c 742e 0a0a 1f0a 4669 y default.....Fi │ │ │ │ │ -00002300: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ -00002310: 4e6f 6465 3a20 4368 616e 6765 7320 6672 Node: Changes fr │ │ │ │ │ -00002320: 6f6d 2047 5255 4220 4c65 6761 6379 2c20 om GRUB Legacy, │ │ │ │ │ -00002330: 204e 6578 743a 2046 6561 7475 7265 732c Next: Features, │ │ │ │ │ -00002340: 2020 5072 6576 3a20 4869 7374 6f72 792c Prev: History, │ │ │ │ │ -00002350: 2020 5570 3a20 496e 7472 6f64 7563 7469 Up: Introducti │ │ │ │ │ -00002360: 6f6e 0a0a 312e 3320 4469 6666 6572 656e on..1.3 Differen │ │ │ │ │ -00002370: 6365 7320 6672 6f6d 2070 7265 7669 6f75 ces from previou │ │ │ │ │ -00002380: 7320 7665 7273 696f 6e73 0a3d 3d3d 3d3d s versions.===== │ │ │ │ │ +000011e0: 2020 4752 5542 2066 6561 7475 7265 730a GRUB features. │ │ │ │ │ +000011f0: 2a20 526f 6c65 206f 6620 6120 626f 6f74 * Role of a boot │ │ │ │ │ +00001200: 206c 6f61 6465 723a 3a20 2020 2020 2020 loader:: │ │ │ │ │ +00001210: 5468 6520 726f 6c65 206f 6620 6120 626f The role of a bo │ │ │ │ │ +00001220: 6f74 206c 6f61 6465 720a 0a1f 0a46 696c ot loader....Fil │ │ │ │ │ +00001230: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ +00001240: 6f64 653a 204f 7665 7276 6965 772c 2020 ode: Overview, │ │ │ │ │ +00001250: 4e65 7874 3a20 4869 7374 6f72 792c 2020 Next: History, │ │ │ │ │ +00001260: 5570 3a20 496e 7472 6f64 7563 7469 6f6e Up: Introduction │ │ │ │ │ +00001270: 0a0a 312e 3120 4f76 6572 7669 6577 0a3d ..1.1 Overview.= │ │ │ │ │ +00001280: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a42 7269 ===========..Bri │ │ │ │ │ +00001290: 6566 6c79 2c20 6120 2262 6f6f 7420 6c6f efly, a "boot lo │ │ │ │ │ +000012a0: 6164 6572 2220 6973 2074 6865 2066 6972 ader" is the fir │ │ │ │ │ +000012b0: 7374 2073 6f66 7477 6172 6520 7072 6f67 st software prog │ │ │ │ │ +000012c0: 7261 6d20 7468 6174 2072 756e 7320 7768 ram that runs wh │ │ │ │ │ +000012d0: 656e 2061 0a63 6f6d 7075 7465 7220 7374 en a.computer st │ │ │ │ │ +000012e0: 6172 7473 2e20 2049 7420 6973 2072 6573 arts. It is res │ │ │ │ │ +000012f0: 706f 6e73 6962 6c65 2066 6f72 206c 6f61 ponsible for loa │ │ │ │ │ +00001300: 6469 6e67 2061 6e64 2074 7261 6e73 6665 ding and transfe │ │ │ │ │ +00001310: 7272 696e 6720 636f 6e74 726f 6c0a 746f rring control.to │ │ │ │ │ +00001320: 2061 6e20 6f70 6572 6174 696e 6720 7379 an operating sy │ │ │ │ │ +00001330: 7374 656d 2022 6b65 726e 656c 2220 736f stem "kernel" so │ │ │ │ │ +00001340: 6674 7761 7265 2028 7375 6368 2061 7320 ftware (such as │ │ │ │ │ +00001350: 4c69 6e75 7820 6f72 2047 4e55 204d 6163 Linux or GNU Mac │ │ │ │ │ +00001360: 6829 2e0a 5468 6520 6b65 726e 656c 2c20 h)..The kernel, │ │ │ │ │ +00001370: 696e 2074 7572 6e2c 2069 6e69 7469 616c in turn, initial │ │ │ │ │ +00001380: 697a 6573 2074 6865 2072 6573 7420 6f66 izes the rest of │ │ │ │ │ +00001390: 2074 6865 206f 7065 7261 7469 6e67 2073 the operating s │ │ │ │ │ +000013a0: 7973 7465 6d20 2865 2e67 2e0a 6120 474e ystem (e.g..a GN │ │ │ │ │ +000013b0: 5520 7379 7374 656d 292e 0a0a 2020 2047 U system)... G │ │ │ │ │ +000013c0: 4e55 2047 5255 4220 6973 2061 2076 6572 NU GRUB is a ver │ │ │ │ │ +000013d0: 7920 706f 7765 7266 756c 2062 6f6f 7420 y powerful boot │ │ │ │ │ +000013e0: 6c6f 6164 6572 2c20 7768 6963 6820 6361 loader, which ca │ │ │ │ │ +000013f0: 6e20 6c6f 6164 2061 2077 6964 650a 7661 n load a wide.va │ │ │ │ │ +00001400: 7269 6574 7920 6f66 2066 7265 6520 6f70 riety of free op │ │ │ │ │ +00001410: 6572 6174 696e 6720 7379 7374 656d 732c erating systems, │ │ │ │ │ +00001420: 2061 7320 7765 6c6c 2061 7320 7072 6f70 as well as prop │ │ │ │ │ +00001430: 7269 6574 6172 7920 6f70 6572 6174 696e rietary operatin │ │ │ │ │ +00001440: 670a 7379 7374 656d 7320 7769 7468 2063 g.systems with c │ │ │ │ │ +00001450: 6861 696e 2d6c 6f61 6469 6e67 2831 2920 hain-loading(1) │ │ │ │ │ +00001460: 282a 6e6f 7465 204f 7665 7276 6965 772d (*note Overview- │ │ │ │ │ +00001470: 466f 6f74 6e6f 7465 2d31 3a3a 292e 2020 Footnote-1::). │ │ │ │ │ +00001480: 4752 5542 2069 730a 6465 7369 676e 6564 GRUB is.designed │ │ │ │ │ +00001490: 2074 6f20 6164 6472 6573 7320 7468 6520 to address the │ │ │ │ │ +000014a0: 636f 6d70 6c65 7869 7479 206f 6620 626f complexity of bo │ │ │ │ │ +000014b0: 6f74 696e 6720 6120 7065 7273 6f6e 616c oting a personal │ │ │ │ │ +000014c0: 2063 6f6d 7075 7465 723b 2062 6f74 680a computer; both. │ │ │ │ │ +000014d0: 7468 6520 7072 6f67 7261 6d20 616e 6420 the program and │ │ │ │ │ +000014e0: 7468 6973 206d 616e 7561 6c20 6172 6520 this manual are │ │ │ │ │ +000014f0: 7469 6768 746c 7920 626f 756e 6420 746f tightly bound to │ │ │ │ │ +00001500: 2074 6861 7420 636f 6d70 7574 6572 2070 that computer p │ │ │ │ │ +00001510: 6c61 7466 6f72 6d2c 0a61 6c74 686f 7567 latform,.althoug │ │ │ │ │ +00001520: 6820 706f 7274 696e 6720 746f 206f 7468 h porting to oth │ │ │ │ │ +00001530: 6572 2070 6c61 7466 6f72 6d73 206d 6179 er platforms may │ │ │ │ │ +00001540: 2062 6520 6164 6472 6573 7365 6420 696e be addressed in │ │ │ │ │ +00001550: 2074 6865 2066 7574 7572 652e 0a0a 2020 the future... │ │ │ │ │ +00001560: 204f 6e65 206f 6620 7468 6520 696d 706f One of the impo │ │ │ │ │ +00001570: 7274 616e 7420 6665 6174 7572 6573 2069 rtant features i │ │ │ │ │ +00001580: 6e20 4752 5542 2069 7320 666c 6578 6962 n GRUB is flexib │ │ │ │ │ +00001590: 696c 6974 793b 2047 5255 420a 756e 6465 ility; GRUB.unde │ │ │ │ │ +000015a0: 7273 7461 6e64 7320 6669 6c65 7379 7374 rstands filesyst │ │ │ │ │ +000015b0: 656d 7320 616e 6420 6b65 726e 656c 2065 ems and kernel e │ │ │ │ │ +000015c0: 7865 6375 7461 626c 6520 666f 726d 6174 xecutable format │ │ │ │ │ +000015d0: 732c 2073 6f20 796f 7520 6361 6e20 6c6f s, so you can lo │ │ │ │ │ +000015e0: 6164 0a61 6e20 6172 6269 7472 6172 7920 ad.an arbitrary │ │ │ │ │ +000015f0: 6f70 6572 6174 696e 6720 7379 7374 656d operating system │ │ │ │ │ +00001600: 2074 6865 2077 6179 2079 6f75 206c 696b the way you lik │ │ │ │ │ +00001610: 652c 2077 6974 686f 7574 2072 6563 6f72 e, without recor │ │ │ │ │ +00001620: 6469 6e67 2074 6865 0a70 6879 7369 6361 ding the.physica │ │ │ │ │ +00001630: 6c20 706f 7369 7469 6f6e 206f 6620 796f l position of yo │ │ │ │ │ +00001640: 7572 206b 6572 6e65 6c20 6f6e 2074 6865 ur kernel on the │ │ │ │ │ +00001650: 2064 6973 6b2e 2020 5468 7573 2079 6f75 disk. Thus you │ │ │ │ │ +00001660: 2063 616e 206c 6f61 6420 7468 650a 6b65 can load the.ke │ │ │ │ │ +00001670: 726e 656c 206a 7573 7420 6279 2073 7065 rnel just by spe │ │ │ │ │ +00001680: 6369 6679 696e 6720 6974 7320 6669 6c65 cifying its file │ │ │ │ │ +00001690: 206e 616d 6520 616e 6420 7468 6520 6472 name and the dr │ │ │ │ │ +000016a0: 6976 6520 616e 6420 7061 7274 6974 696f ive and partitio │ │ │ │ │ +000016b0: 6e0a 7768 6572 6520 7468 6520 6b65 726e n.where the kern │ │ │ │ │ +000016c0: 656c 2072 6573 6964 6573 2e0a 0a20 2020 el resides... │ │ │ │ │ +000016d0: 5768 656e 2062 6f6f 7469 6e67 2077 6974 When booting wit │ │ │ │ │ +000016e0: 6820 4752 5542 2c20 796f 7520 6361 6e20 h GRUB, you can │ │ │ │ │ +000016f0: 7573 6520 6569 7468 6572 2061 2063 6f6d use either a com │ │ │ │ │ +00001700: 6d61 6e64 2d6c 696e 6520 696e 7465 7266 mand-line interf │ │ │ │ │ +00001710: 6163 650a 282a 6e6f 7465 2043 6f6d 6d61 ace.(*note Comma │ │ │ │ │ +00001720: 6e64 2d6c 696e 6520 696e 7465 7266 6163 nd-line interfac │ │ │ │ │ +00001730: 653a 3a29 2c20 6f72 2061 206d 656e 7520 e::), or a menu │ │ │ │ │ +00001740: 696e 7465 7266 6163 6520 282a 6e6f 7465 interface (*note │ │ │ │ │ +00001750: 204d 656e 750a 696e 7465 7266 6163 653a Menu.interface: │ │ │ │ │ +00001760: 3a29 2e20 2055 7369 6e67 2074 6865 2063 :). Using the c │ │ │ │ │ +00001770: 6f6d 6d61 6e64 2d6c 696e 6520 696e 7465 ommand-line inte │ │ │ │ │ +00001780: 7266 6163 652c 2079 6f75 2074 7970 6520 rface, you type │ │ │ │ │ +00001790: 7468 6520 6472 6976 650a 7370 6563 6966 the drive.specif │ │ │ │ │ +000017a0: 6963 6174 696f 6e20 616e 6420 6669 6c65 ication and file │ │ │ │ │ +000017b0: 206e 616d 6520 6f66 2074 6865 206b 6572 name of the ker │ │ │ │ │ +000017c0: 6e65 6c20 6d61 6e75 616c 6c79 2e20 2049 nel manually. I │ │ │ │ │ +000017d0: 6e20 7468 6520 6d65 6e75 0a69 6e74 6572 n the menu.inter │ │ │ │ │ +000017e0: 6661 6365 2c20 796f 7520 6a75 7374 2073 face, you just s │ │ │ │ │ +000017f0: 656c 6563 7420 616e 204f 5320 7573 696e elect an OS usin │ │ │ │ │ +00001800: 6720 7468 6520 6172 726f 7720 6b65 7973 g the arrow keys │ │ │ │ │ +00001810: 2e20 2054 6865 206d 656e 7520 6973 0a62 . The menu is.b │ │ │ │ │ +00001820: 6173 6564 206f 6e20 6120 636f 6e66 6967 ased on a config │ │ │ │ │ +00001830: 7572 6174 696f 6e20 6669 6c65 2077 6869 uration file whi │ │ │ │ │ +00001840: 6368 2079 6f75 2070 7265 7061 7265 2062 ch you prepare b │ │ │ │ │ +00001850: 6566 6f72 6568 616e 6420 282a 6e6f 7465 eforehand (*note │ │ │ │ │ +00001860: 0a43 6f6e 6669 6775 7261 7469 6f6e 3a3a .Configuration:: │ │ │ │ │ +00001870: 292e 2020 5768 696c 6520 696e 2074 6865 ). While in the │ │ │ │ │ +00001880: 206d 656e 752c 2079 6f75 2063 616e 2073 menu, you can s │ │ │ │ │ +00001890: 7769 7463 6820 746f 2074 6865 2063 6f6d witch to the com │ │ │ │ │ +000018a0: 6d61 6e64 2d6c 696e 650a 6d6f 6465 2c20 mand-line.mode, │ │ │ │ │ +000018b0: 616e 6420 7669 6365 2d76 6572 7361 2e20 and vice-versa. │ │ │ │ │ +000018c0: 2059 6f75 2063 616e 2065 7665 6e20 6564 You can even ed │ │ │ │ │ +000018d0: 6974 206d 656e 7520 656e 7472 6965 7320 it menu entries │ │ │ │ │ +000018e0: 6265 666f 7265 2075 7369 6e67 2074 6865 before using the │ │ │ │ │ +000018f0: 6d2e 0a0a 2020 2049 6e20 7468 6520 666f m... In the fo │ │ │ │ │ +00001900: 6c6c 6f77 696e 6720 6368 6170 7465 7273 llowing chapters │ │ │ │ │ +00001910: 2c20 796f 7520 7769 6c6c 206c 6561 726e , you will learn │ │ │ │ │ +00001920: 2068 6f77 2074 6f20 7370 6563 6966 7920 how to specify │ │ │ │ │ +00001930: 6120 6472 6976 652c 2061 0a70 6172 7469 a drive, a.parti │ │ │ │ │ +00001940: 7469 6f6e 2c20 616e 6420 6120 6669 6c65 tion, and a file │ │ │ │ │ +00001950: 206e 616d 6520 282a 6e6f 7465 204e 616d name (*note Nam │ │ │ │ │ +00001960: 696e 6720 636f 6e76 656e 7469 6f6e 3a3a ing convention:: │ │ │ │ │ +00001970: 2920 746f 2047 5255 422c 2068 6f77 2074 ) to GRUB, how t │ │ │ │ │ +00001980: 6f0a 696e 7374 616c 6c20 4752 5542 206f o.install GRUB o │ │ │ │ │ +00001990: 6e20 796f 7572 2064 7269 7665 2028 2a6e n your drive (*n │ │ │ │ │ +000019a0: 6f74 6520 496e 7374 616c 6c61 7469 6f6e ote Installation │ │ │ │ │ +000019b0: 3a3a 292c 2061 6e64 2068 6f77 2074 6f20 ::), and how to │ │ │ │ │ +000019c0: 626f 6f74 2079 6f75 720a 4f53 6573 2028 boot your.OSes ( │ │ │ │ │ +000019d0: 2a6e 6f74 6520 426f 6f74 696e 673a 3a29 *note Booting::) │ │ │ │ │ +000019e0: 2c20 7374 6570 2062 7920 7374 6570 2e0a , step by step.. │ │ │ │ │ +000019f0: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ +00001a00: 666f 2c20 204e 6f64 653a 204f 7665 7276 fo, Node: Overv │ │ │ │ │ +00001a10: 6965 772d 466f 6f74 6e6f 7465 732c 2020 iew-Footnotes, │ │ │ │ │ +00001a20: 5570 3a20 4f76 6572 7669 6577 0a0a 2020 Up: Overview.. │ │ │ │ │ +00001a30: 2028 3129 2022 6368 6169 6e2d 6c6f 6164 (1) "chain-load │ │ │ │ │ +00001a40: 2220 6973 2074 6865 206d 6563 6861 6e69 " is the mechani │ │ │ │ │ +00001a50: 736d 2066 6f72 206c 6f61 6469 6e67 2075 sm for loading u │ │ │ │ │ +00001a60: 6e73 7570 706f 7274 6564 206f 7065 7261 nsupported opera │ │ │ │ │ +00001a70: 7469 6e67 0a73 7973 7465 6d73 2062 7920 ting.systems by │ │ │ │ │ +00001a80: 6c6f 6164 696e 6720 616e 6f74 6865 7220 loading another │ │ │ │ │ +00001a90: 626f 6f74 206c 6f61 6465 722e 2020 4974 boot loader. It │ │ │ │ │ +00001aa0: 2069 7320 7479 7069 6361 6c6c 7920 7573 is typically us │ │ │ │ │ +00001ab0: 6564 2066 6f72 0a6c 6f61 6469 6e67 2044 ed for.loading D │ │ │ │ │ +00001ac0: 4f53 206f 7220 5769 6e64 6f77 732e 0a0a OS or Windows... │ │ │ │ │ +00001ad0: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ +00001ae0: 6f2c 2020 4e6f 6465 3a20 4869 7374 6f72 o, Node: Histor │ │ │ │ │ +00001af0: 792c 2020 4e65 7874 3a20 4368 616e 6765 y, Next: Change │ │ │ │ │ +00001b00: 7320 6672 6f6d 2047 5255 4220 4c65 6761 s from GRUB Lega │ │ │ │ │ +00001b10: 6379 2c20 2050 7265 763a 204f 7665 7276 cy, Prev: Overv │ │ │ │ │ +00001b20: 6965 772c 2020 5570 3a20 496e 7472 6f64 iew, Up: Introd │ │ │ │ │ +00001b30: 7563 7469 6f6e 0a0a 312e 3220 4869 7374 uction..1.2 Hist │ │ │ │ │ +00001b40: 6f72 7920 6f66 2047 5255 420a 3d3d 3d3d ory of GRUB.==== │ │ │ │ │ +00001b50: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a ===============. │ │ │ │ │ +00001b60: 0a47 5255 4220 6f72 6967 696e 6174 6564 .GRUB originated │ │ │ │ │ +00001b70: 2069 6e20 3139 3935 2077 6865 6e20 4572 in 1995 when Er │ │ │ │ │ +00001b80: 6963 6820 426f 6c65 796e 2077 6173 2074 ich Boleyn was t │ │ │ │ │ +00001b90: 7279 696e 6720 746f 2062 6f6f 7420 7468 rying to boot th │ │ │ │ │ +00001ba0: 6520 474e 550a 4875 7264 2077 6974 6820 e GNU.Hurd with │ │ │ │ │ +00001bb0: 7468 6520 556e 6976 6572 7369 7479 206f the University o │ │ │ │ │ +00001bc0: 6620 5574 6168 2773 204d 6163 6820 3420 f Utah's Mach 4 │ │ │ │ │ +00001bd0: 6d69 6372 6f6b 6572 6e65 6c20 286e 6f77 microkernel (now │ │ │ │ │ +00001be0: 206b 6e6f 776e 2061 7320 474e 550a 4d61 known as GNU.Ma │ │ │ │ │ +00001bf0: 6368 292e 2020 4572 6963 6820 616e 6420 ch). Erich and │ │ │ │ │ +00001c00: 4272 6961 6e20 466f 7264 2064 6573 6967 Brian Ford desig │ │ │ │ │ +00001c10: 6e65 6420 7468 6520 4d75 6c74 6962 6f6f ned the Multiboo │ │ │ │ │ +00001c20: 7420 5370 6563 6966 6963 6174 696f 6e20 t Specification │ │ │ │ │ +00001c30: 282a 6e6f 7465 0a4d 756c 7469 626f 6f74 (*note.Multiboot │ │ │ │ │ +00001c40: 2053 7065 6369 6669 6361 7469 6f6e 3a20 Specification: │ │ │ │ │ +00001c50: 286d 756c 7469 626f 6f74 2954 6f70 2e29 (multiboot)Top.) │ │ │ │ │ +00001c60: 2c20 6265 6361 7573 6520 7468 6579 2077 , because they w │ │ │ │ │ +00001c70: 6572 6520 6465 7465 726d 696e 6564 0a6e ere determined.n │ │ │ │ │ +00001c80: 6f74 2074 6f20 6164 6420 746f 2074 6865 ot to add to the │ │ │ │ │ +00001c90: 206c 6172 6765 206e 756d 6265 7220 6f66 large number of │ │ │ │ │ +00001ca0: 206d 7574 7561 6c6c 792d 696e 636f 6d70 mutually-incomp │ │ │ │ │ +00001cb0: 6174 6962 6c65 2050 4320 626f 6f74 206d atible PC boot m │ │ │ │ │ +00001cc0: 6574 686f 6473 2e0a 0a20 2020 4572 6963 ethods... Eric │ │ │ │ │ +00001cd0: 6820 7468 656e 2062 6567 616e 206d 6f64 h then began mod │ │ │ │ │ +00001ce0: 6966 7969 6e67 2074 6865 2046 7265 6542 ifying the FreeB │ │ │ │ │ +00001cf0: 5344 2062 6f6f 7420 6c6f 6164 6572 2073 SD boot loader s │ │ │ │ │ +00001d00: 6f20 7468 6174 2069 7420 776f 756c 640a o that it would. │ │ │ │ │ +00001d10: 756e 6465 7273 7461 6e64 204d 756c 7469 understand Multi │ │ │ │ │ +00001d20: 626f 6f74 2e20 2048 6520 736f 6f6e 2072 boot. He soon r │ │ │ │ │ +00001d30: 6561 6c69 7a65 6420 7468 6174 2069 7420 ealized that it │ │ │ │ │ +00001d40: 776f 756c 6420 6265 2061 206c 6f74 2065 would be a lot e │ │ │ │ │ +00001d50: 6173 6965 7220 746f 0a77 7269 7465 2068 asier to.write h │ │ │ │ │ +00001d60: 6973 206f 776e 2062 6f6f 7420 6c6f 6164 is own boot load │ │ │ │ │ +00001d70: 6572 2066 726f 6d20 7363 7261 7463 6820 er from scratch │ │ │ │ │ +00001d80: 7468 616e 2074 6f20 6b65 6570 2077 6f72 than to keep wor │ │ │ │ │ +00001d90: 6b69 6e67 206f 6e20 7468 650a 4672 6565 king on the.Free │ │ │ │ │ +00001da0: 4253 4420 626f 6f74 206c 6f61 6465 722c BSD boot loader, │ │ │ │ │ +00001db0: 2061 6e64 2073 6f20 4752 5542 2077 6173 and so GRUB was │ │ │ │ │ +00001dc0: 2062 6f72 6e2e 0a0a 2020 2045 7269 6368 born... Erich │ │ │ │ │ +00001dd0: 2061 6464 6564 206d 616e 7920 6665 6174 added many feat │ │ │ │ │ +00001de0: 7572 6573 2074 6f20 4752 5542 2c20 6275 ures to GRUB, bu │ │ │ │ │ +00001df0: 7420 6f74 6865 7220 7072 696f 7269 7469 t other prioriti │ │ │ │ │ +00001e00: 6573 2070 7265 7665 6e74 6564 2068 696d es prevented him │ │ │ │ │ +00001e10: 0a66 726f 6d20 6b65 6570 696e 6720 7570 .from keeping up │ │ │ │ │ +00001e20: 2077 6974 6820 7468 6520 6465 6d61 6e64 with the demand │ │ │ │ │ +00001e30: 7320 6f66 2069 7473 2071 7569 636b 6c79 s of its quickly │ │ │ │ │ +00001e40: 2d65 7870 616e 6469 6e67 2075 7365 7220 -expanding user │ │ │ │ │ +00001e50: 6261 7365 2e20 2049 6e0a 3139 3939 2c20 base. In.1999, │ │ │ │ │ +00001e60: 476f 7264 6f6e 204d 6174 7a69 676b 6569 Gordon Matzigkei │ │ │ │ │ +00001e70: 7420 616e 6420 596f 7368 696e 6f72 6920 t and Yoshinori │ │ │ │ │ +00001e80: 4b2e 204f 6b75 6a69 2061 646f 7074 6564 K. Okuji adopted │ │ │ │ │ +00001e90: 2047 5255 4220 6173 2061 6e0a 6f66 6669 GRUB as an.offi │ │ │ │ │ +00001ea0: 6369 616c 2047 4e55 2070 6163 6b61 6765 cial GNU package │ │ │ │ │ +00001eb0: 2c20 616e 6420 6f70 656e 6564 2069 7473 , and opened its │ │ │ │ │ +00001ec0: 2064 6576 656c 6f70 6d65 6e74 2062 7920 development by │ │ │ │ │ +00001ed0: 6d61 6b69 6e67 2074 6865 206c 6174 6573 making the lates │ │ │ │ │ +00001ee0: 740a 736f 7572 6365 7320 6176 6169 6c61 t.sources availa │ │ │ │ │ +00001ef0: 626c 6520 7669 6120 616e 6f6e 796d 6f75 ble via anonymou │ │ │ │ │ +00001f00: 7320 4356 532e 202a 4e6f 7465 204f 6274 s CVS. *Note Obt │ │ │ │ │ +00001f10: 6169 6e69 6e67 2061 6e64 2042 7569 6c64 aining and Build │ │ │ │ │ +00001f20: 696e 670a 4752 5542 3a3a 2c20 666f 7220 ing.GRUB::, for │ │ │ │ │ +00001f30: 6d6f 7265 2069 6e66 6f72 6d61 7469 6f6e more information │ │ │ │ │ +00001f40: 2e0a 0a20 2020 4f76 6572 2074 6865 206e ... Over the n │ │ │ │ │ +00001f50: 6578 7420 6665 7720 7965 6172 732c 2047 ext few years, G │ │ │ │ │ +00001f60: 5255 4220 7761 7320 6578 7465 6e64 6564 RUB was extended │ │ │ │ │ +00001f70: 2074 6f20 6d65 6574 206d 616e 7920 6e65 to meet many ne │ │ │ │ │ +00001f80: 6564 732c 2062 7574 2069 740a 7175 6963 eds, but it.quic │ │ │ │ │ +00001f90: 6b6c 7920 6265 6361 6d65 2063 6c65 6172 kly became clear │ │ │ │ │ +00001fa0: 2074 6861 7420 6974 7320 6465 7369 676e that its design │ │ │ │ │ +00001fb0: 2077 6173 206e 6f74 206b 6565 7069 6e67 was not keeping │ │ │ │ │ +00001fc0: 2075 7020 7769 7468 2074 6865 0a65 7874 up with the.ext │ │ │ │ │ +00001fd0: 656e 7369 6f6e 7320 6265 696e 6720 6d61 ensions being ma │ │ │ │ │ +00001fe0: 6465 2074 6f20 6974 2c20 616e 6420 7765 de to it, and we │ │ │ │ │ +00001ff0: 2072 6561 6368 6564 2074 6865 2070 6f69 reached the poi │ │ │ │ │ +00002000: 6e74 2077 6865 7265 2069 7420 7761 7320 nt where it was │ │ │ │ │ +00002010: 7665 7279 0a64 6966 6669 6375 6c74 2074 very.difficult t │ │ │ │ │ +00002020: 6f20 6d61 6b65 2061 6e79 2066 7572 7468 o make any furth │ │ │ │ │ +00002030: 6572 2063 6861 6e67 6573 2077 6974 686f er changes witho │ │ │ │ │ +00002040: 7574 2062 7265 616b 696e 6720 6578 6973 ut breaking exis │ │ │ │ │ +00002050: 7469 6e67 0a66 6561 7475 7265 732e 2020 ting.features. │ │ │ │ │ +00002060: 4172 6f75 6e64 2032 3030 322c 2059 6f73 Around 2002, Yos │ │ │ │ │ +00002070: 6869 6e6f 7269 204b 2e20 4f6b 756a 6920 hinori K. Okuji │ │ │ │ │ +00002080: 7374 6172 7465 6420 776f 726b 206f 6e20 started work on │ │ │ │ │ +00002090: 5055 5041 0a28 5072 656c 696d 696e 6172 PUPA.(Preliminar │ │ │ │ │ +000020a0: 7920 556e 6976 6572 7361 6c20 5072 6f67 y Universal Prog │ │ │ │ │ +000020b0: 7261 6d6d 696e 6720 4172 6368 6974 6563 ramming Architec │ │ │ │ │ +000020c0: 7475 7265 2066 6f72 2047 4e55 2047 5255 ture for GNU GRU │ │ │ │ │ +000020d0: 4229 2c20 6169 6d69 6e67 2074 6f0a 7265 B), aiming to.re │ │ │ │ │ +000020e0: 7772 6974 6520 7468 6520 636f 7265 206f write the core o │ │ │ │ │ +000020f0: 6620 4752 5542 2074 6f20 6d61 6b65 2069 f GRUB to make i │ │ │ │ │ +00002100: 7420 636c 6561 6e65 722c 2073 6166 6572 t cleaner, safer │ │ │ │ │ +00002110: 2c20 6d6f 7265 2072 6f62 7573 742c 2061 , more robust, a │ │ │ │ │ +00002120: 6e64 0a6d 6f72 6520 706f 7765 7266 756c nd.more powerful │ │ │ │ │ +00002130: 2e20 2050 5550 4120 7761 7320 6576 656e . PUPA was even │ │ │ │ │ +00002140: 7475 616c 6c79 2072 656e 616d 6564 2074 tually renamed t │ │ │ │ │ +00002150: 6f20 4752 5542 2032 2c20 616e 6420 7468 o GRUB 2, and th │ │ │ │ │ +00002160: 6520 6f72 6967 696e 616c 0a76 6572 7369 e original.versi │ │ │ │ │ +00002170: 6f6e 206f 6620 4752 5542 2077 6173 2072 on of GRUB was r │ │ │ │ │ +00002180: 656e 616d 6564 2074 6f20 4752 5542 204c enamed to GRUB L │ │ │ │ │ +00002190: 6567 6163 792e 2020 536d 616c 6c20 616d egacy. Small am │ │ │ │ │ +000021a0: 6f75 6e74 7320 6f66 0a6d 6169 6e74 656e ounts of.mainten │ │ │ │ │ +000021b0: 616e 6365 2063 6f6e 7469 6e75 6564 2074 ance continued t │ │ │ │ │ +000021c0: 6f20 6265 2064 6f6e 6520 6f6e 2047 5255 o be done on GRU │ │ │ │ │ +000021d0: 4220 4c65 6761 6379 2c20 6275 7420 7468 B Legacy, but th │ │ │ │ │ +000021e0: 6520 6c61 7374 2072 656c 6561 7365 0a28 e last release.( │ │ │ │ │ +000021f0: 302e 3937 2920 7761 7320 6d61 6465 2069 0.97) was made i │ │ │ │ │ +00002200: 6e20 3230 3035 2061 6e64 2061 7420 7468 n 2005 and at th │ │ │ │ │ +00002210: 6520 7469 6d65 206f 6620 7772 6974 696e e time of writin │ │ │ │ │ +00002220: 6720 6974 2073 6565 6d73 2075 6e6c 696b g it seems unlik │ │ │ │ │ +00002230: 656c 790a 7468 6174 2074 6865 7265 2077 ely.that there w │ │ │ │ │ +00002240: 696c 6c20 6265 2061 6e6f 7468 6572 2e0a ill be another.. │ │ │ │ │ +00002250: 0a20 2020 4279 2061 726f 756e 6420 3230 . By around 20 │ │ │ │ │ +00002260: 3037 2c20 474e 552f 4c69 6e75 7820 6469 07, GNU/Linux di │ │ │ │ │ +00002270: 7374 7269 6275 7469 6f6e 7320 7374 6172 stributions star │ │ │ │ │ +00002280: 7465 6420 746f 2075 7365 2047 5255 4220 ted to use GRUB │ │ │ │ │ +00002290: 3220 746f 0a6c 696d 6974 6564 2065 7874 2 to.limited ext │ │ │ │ │ +000022a0: 656e 7473 2c20 616e 6420 6279 2074 6865 ents, and by the │ │ │ │ │ +000022b0: 2065 6e64 206f 6620 3230 3039 206d 756c end of 2009 mul │ │ │ │ │ +000022c0: 7469 706c 6520 6d61 6a6f 7220 6469 7374 tiple major dist │ │ │ │ │ +000022d0: 7269 6275 7469 6f6e 730a 7765 7265 2069 ributions.were i │ │ │ │ │ +000022e0: 6e73 7461 6c6c 696e 6720 6974 2062 7920 nstalling it by │ │ │ │ │ +000022f0: 6465 6661 756c 742e 0a0a 1f0a 4669 6c65 default.....File │ │ │ │ │ +00002300: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ +00002310: 6465 3a20 4368 616e 6765 7320 6672 6f6d de: Changes from │ │ │ │ │ +00002320: 2047 5255 4220 4c65 6761 6379 2c20 204e GRUB Legacy, N │ │ │ │ │ +00002330: 6578 743a 2046 6561 7475 7265 732c 2020 ext: Features, │ │ │ │ │ +00002340: 5072 6576 3a20 4869 7374 6f72 792c 2020 Prev: History, │ │ │ │ │ +00002350: 5570 3a20 496e 7472 6f64 7563 7469 6f6e Up: Introduction │ │ │ │ │ +00002360: 0a0a 312e 3320 4469 6666 6572 656e 6365 ..1.3 Difference │ │ │ │ │ +00002370: 7320 6672 6f6d 2070 7265 7669 6f75 7320 s from previous │ │ │ │ │ +00002380: 7665 7273 696f 6e73 0a3d 3d3d 3d3d 3d3d versions.======= │ │ │ │ │ 00002390: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -000023a0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -000023b0: 3d0a 0a47 5255 4220 3220 6973 2061 2072 =..GRUB 2 is a r │ │ │ │ │ -000023c0: 6577 7269 7465 206f 6620 4752 5542 2028 ewrite of GRUB ( │ │ │ │ │ -000023d0: 2a6e 6f74 6520 4869 7374 6f72 793a 3a29 *note History::) │ │ │ │ │ -000023e0: 2c20 616c 7468 6f75 6768 2069 7420 7368 , although it sh │ │ │ │ │ -000023f0: 6172 6573 206d 616e 790a 6368 6172 6163 ares many.charac │ │ │ │ │ -00002400: 7465 7269 7374 6963 7320 7769 7468 2074 teristics with t │ │ │ │ │ -00002410: 6865 2070 7265 7669 6f75 7320 7665 7273 he previous vers │ │ │ │ │ -00002420: 696f 6e2c 206e 6f77 206b 6e6f 776e 2061 ion, now known a │ │ │ │ │ -00002430: 7320 4752 5542 204c 6567 6163 792e 0a55 s GRUB Legacy..U │ │ │ │ │ -00002440: 7365 7273 206f 6620 4752 5542 204c 6567 sers of GRUB Leg │ │ │ │ │ -00002450: 6163 7920 6d61 7920 6e65 6564 2073 6f6d acy may need som │ │ │ │ │ -00002460: 6520 6775 6964 616e 6365 2074 6f20 6669 e guidance to fi │ │ │ │ │ -00002470: 6e64 2074 6865 6972 2077 6179 2061 726f nd their way aro │ │ │ │ │ -00002480: 756e 640a 7468 6973 206e 6577 2076 6572 und.this new ver │ │ │ │ │ -00002490: 7369 6f6e 2e0a 0a20 2020 2a20 5468 6520 sion... * The │ │ │ │ │ -000024a0: 636f 6e66 6967 7572 6174 696f 6e20 6669 configuration fi │ │ │ │ │ -000024b0: 6c65 2068 6173 2061 206e 6577 206e 616d le has a new nam │ │ │ │ │ -000024c0: 6520 2827 6772 7562 2e63 6667 2720 7261 e ('grub.cfg' ra │ │ │ │ │ -000024d0: 7468 6572 2074 6861 6e0a 2020 2020 2027 ther than. ' │ │ │ │ │ -000024e0: 6d65 6e75 2e6c 7374 2720 6f72 2027 6772 menu.lst' or 'gr │ │ │ │ │ -000024f0: 7562 2e63 6f6e 6627 292c 206e 6577 2073 ub.conf'), new s │ │ │ │ │ -00002500: 796e 7461 7820 282a 6e6f 7465 2043 6f6e yntax (*note Con │ │ │ │ │ -00002510: 6669 6775 7261 7469 6f6e 3a3a 2920 616e figuration::) an │ │ │ │ │ -00002520: 640a 2020 2020 206d 616e 7920 6e65 7720 d. many new │ │ │ │ │ -00002530: 636f 6d6d 616e 6473 2028 2a6e 6f74 6520 commands (*note │ │ │ │ │ -00002540: 436f 6d6d 616e 6473 3a3a 292e 2020 436f Commands::). Co │ │ │ │ │ -00002550: 6e66 6967 7572 6174 696f 6e20 6361 6e6e nfiguration cann │ │ │ │ │ -00002560: 6f74 2062 650a 2020 2020 2063 6f70 6965 ot be. copie │ │ │ │ │ -00002570: 6420 6f76 6572 2064 6972 6563 746c 792c d over directly, │ │ │ │ │ -00002580: 2061 6c74 686f 7567 6820 6d6f 7374 2047 although most G │ │ │ │ │ -00002590: 5255 4220 4c65 6761 6379 2075 7365 7273 RUB Legacy users │ │ │ │ │ -000025a0: 2073 686f 756c 6420 6e6f 740a 2020 2020 should not. │ │ │ │ │ -000025b0: 2066 696e 6420 7468 6520 7379 6e74 6178 find the syntax │ │ │ │ │ -000025c0: 2074 6f6f 2073 7572 7072 6973 696e 672e too surprising. │ │ │ │ │ -000025d0: 0a0a 2020 202a 2027 6772 7562 2e63 6667 .. * 'grub.cfg │ │ │ │ │ -000025e0: 2720 6973 2074 7970 6963 616c 6c79 2061 ' is typically a │ │ │ │ │ -000025f0: 7574 6f6d 6174 6963 616c 6c79 2067 656e utomatically gen │ │ │ │ │ -00002600: 6572 6174 6564 2062 7920 2767 7275 622d erated by 'grub- │ │ │ │ │ -00002610: 6d6b 636f 6e66 6967 270a 2020 2020 2028 mkconfig'. ( │ │ │ │ │ -00002620: 2a6e 6f74 6520 5369 6d70 6c65 2063 6f6e *note Simple con │ │ │ │ │ -00002630: 6669 6775 7261 7469 6f6e 3a3a 292e 2020 figuration::). │ │ │ │ │ -00002640: 5468 6973 206d 616b 6573 2069 7420 6561 This makes it ea │ │ │ │ │ -00002650: 7369 6572 2074 6f20 6861 6e64 6c65 0a20 sier to handle. │ │ │ │ │ -00002660: 2020 2020 7665 7273 696f 6e65 6420 6b65 versioned ke │ │ │ │ │ -00002670: 726e 656c 2075 7067 7261 6465 732e 0a0a rnel upgrades... │ │ │ │ │ -00002680: 2020 202a 2050 6172 7469 7469 6f6e 206e * Partition n │ │ │ │ │ -00002690: 756d 6265 7273 2069 6e20 4752 5542 2064 umbers in GRUB d │ │ │ │ │ -000026a0: 6576 6963 6520 6e61 6d65 7320 6e6f 7720 evice names now │ │ │ │ │ -000026b0: 7374 6172 7420 6174 2031 2c20 6e6f 7420 start at 1, not │ │ │ │ │ -000026c0: 3020 282a 6e6f 7465 0a20 2020 2020 4e61 0 (*note. Na │ │ │ │ │ -000026d0: 6d69 6e67 2063 6f6e 7665 6e74 696f 6e3a ming convention: │ │ │ │ │ -000026e0: 3a29 2e0a 0a20 2020 2a20 5468 6520 636f :)... * The co │ │ │ │ │ -000026f0: 6e66 6967 7572 6174 696f 6e20 6669 6c65 nfiguration file │ │ │ │ │ -00002700: 2069 7320 6e6f 7720 7772 6974 7465 6e20 is now written │ │ │ │ │ -00002710: 696e 2073 6f6d 6574 6869 6e67 2063 6c6f in something clo │ │ │ │ │ -00002720: 7365 7220 746f 2061 2066 756c 6c0a 2020 ser to a full. │ │ │ │ │ -00002730: 2020 2073 6372 6970 7469 6e67 206c 616e scripting lan │ │ │ │ │ -00002740: 6775 6167 653a 2076 6172 6961 626c 6573 guage: variables │ │ │ │ │ -00002750: 2c20 636f 6e64 6974 696f 6e61 6c73 2c20 , conditionals, │ │ │ │ │ -00002760: 616e 6420 6c6f 6f70 7320 6172 650a 2020 and loops are. │ │ │ │ │ -00002770: 2020 2061 7661 696c 6162 6c65 2e0a 0a20 available... │ │ │ │ │ -00002780: 2020 2a20 4120 736d 616c 6c20 616d 6f75 * A small amou │ │ │ │ │ -00002790: 6e74 206f 6620 7065 7273 6973 7465 6e74 nt of persistent │ │ │ │ │ -000027a0: 2073 746f 7261 6765 2069 7320 6176 6169 storage is avai │ │ │ │ │ -000027b0: 6c61 626c 6520 6163 726f 7373 2072 6562 lable across reb │ │ │ │ │ -000027c0: 6f6f 7473 2c0a 2020 2020 2075 7369 6e67 oots,. using │ │ │ │ │ -000027d0: 2074 6865 2027 7361 7665 5f65 6e76 2720 the 'save_env' │ │ │ │ │ -000027e0: 616e 6420 276c 6f61 645f 656e 7627 2063 and 'load_env' c │ │ │ │ │ -000027f0: 6f6d 6d61 6e64 7320 696e 2047 5255 4220 ommands in GRUB │ │ │ │ │ -00002800: 616e 6420 7468 650a 2020 2020 2027 6772 and the. 'gr │ │ │ │ │ -00002810: 7562 2d65 6469 7465 6e76 2720 7574 696c ub-editenv' util │ │ │ │ │ -00002820: 6974 792e 2020 5468 6973 2069 7320 6e6f ity. This is no │ │ │ │ │ -00002830: 7420 6176 6169 6c61 626c 6520 696e 2061 t available in a │ │ │ │ │ -00002840: 6c6c 0a20 2020 2020 636f 6e66 6967 7572 ll. configur │ │ │ │ │ -00002850: 6174 696f 6e73 2028 2a6e 6f74 6520 456e ations (*note En │ │ │ │ │ -00002860: 7669 726f 6e6d 656e 7420 626c 6f63 6b3a vironment block: │ │ │ │ │ -00002870: 3a29 2e0a 0a20 2020 2a20 4752 5542 2032 :)... * GRUB 2 │ │ │ │ │ -00002880: 2068 6173 206d 6f72 6520 7265 6c69 6162 has more reliab │ │ │ │ │ -00002890: 6c65 2077 6179 7320 746f 2066 696e 6420 le ways to find │ │ │ │ │ -000028a0: 6974 7320 6f77 6e20 6669 6c65 7320 616e its own files an │ │ │ │ │ -000028b0: 6420 7468 6f73 6520 6f66 0a20 2020 2020 d those of. │ │ │ │ │ -000028c0: 7461 7267 6574 206b 6572 6e65 6c73 206f target kernels o │ │ │ │ │ -000028d0: 6e20 6d75 6c74 6970 6c65 2d64 6973 6b20 n multiple-disk │ │ │ │ │ -000028e0: 7379 7374 656d 732c 2061 6e64 2068 6173 systems, and has │ │ │ │ │ -000028f0: 2063 6f6d 6d61 6e64 7320 282a 6e6f 7465 commands (*note │ │ │ │ │ -00002900: 0a20 2020 2020 7365 6172 6368 3a3a 2920 . search::) │ │ │ │ │ -00002910: 746f 2066 696e 6420 6465 7669 6365 7320 to find devices │ │ │ │ │ -00002920: 7573 696e 6720 6669 6c65 2073 7973 7465 using file syste │ │ │ │ │ -00002930: 6d20 6c61 6265 6c73 206f 7220 556e 6976 m labels or Univ │ │ │ │ │ -00002940: 6572 7361 6c6c 790a 2020 2020 2055 6e69 ersally. Uni │ │ │ │ │ -00002950: 7175 6520 4964 656e 7469 6669 6572 7320 que Identifiers │ │ │ │ │ -00002960: 2855 5549 4473 292e 0a0a 2020 202a 2047 (UUIDs)... * G │ │ │ │ │ -00002970: 5255 4220 3220 6973 2061 7661 696c 6162 RUB 2 is availab │ │ │ │ │ -00002980: 6c65 2066 6f72 2073 6576 6572 616c 206f le for several o │ │ │ │ │ -00002990: 7468 6572 2074 7970 6573 206f 6620 7379 ther types of sy │ │ │ │ │ -000029a0: 7374 656d 2069 6e20 6164 6469 7469 6f6e stem in addition │ │ │ │ │ -000029b0: 0a20 2020 2020 746f 2074 6865 2050 4320 . to the PC │ │ │ │ │ -000029c0: 4249 4f53 2073 7973 7465 6d73 2073 7570 BIOS systems sup │ │ │ │ │ -000029d0: 706f 7274 6564 2062 7920 4752 5542 204c ported by GRUB L │ │ │ │ │ -000029e0: 6567 6163 793a 2050 4320 4546 492c 2050 egacy: PC EFI, P │ │ │ │ │ -000029f0: 430a 2020 2020 2063 6f72 6562 6f6f 742c C. coreboot, │ │ │ │ │ -00002a00: 2050 6f77 6572 5043 2c20 5350 4152 432c PowerPC, SPARC, │ │ │ │ │ -00002a10: 2061 6e64 204d 4950 5320 4c65 6d6f 7465 and MIPS Lemote │ │ │ │ │ -00002a20: 2059 6565 6c6f 6f6e 6720 6172 6520 616c Yeeloong are al │ │ │ │ │ -00002a30: 6c0a 2020 2020 2073 7570 706f 7274 6564 l. supported │ │ │ │ │ -00002a40: 2e0a 0a20 2020 2a20 4d61 6e79 206d 6f72 ... * Many mor │ │ │ │ │ -00002a50: 6520 6669 6c65 2073 7973 7465 6d73 2061 e file systems a │ │ │ │ │ -00002a60: 7265 2073 7570 706f 7274 6564 2c20 696e re supported, in │ │ │ │ │ -00002a70: 636c 7564 696e 6720 6275 7420 6e6f 7420 cluding but not │ │ │ │ │ -00002a80: 6c69 6d69 7465 6420 746f 0a20 2020 2020 limited to. │ │ │ │ │ -00002a90: 6578 7434 2c20 4846 532b 2c20 616e 6420 ext4, HFS+, and │ │ │ │ │ -00002aa0: 4e54 4653 2e0a 0a20 2020 2a20 4752 5542 NTFS... * GRUB │ │ │ │ │ -00002ab0: 2032 2063 616e 2072 6561 6420 6669 6c65 2 can read file │ │ │ │ │ -00002ac0: 7320 6469 7265 6374 6c79 2066 726f 6d20 s directly from │ │ │ │ │ -00002ad0: 4c56 4d20 616e 6420 5241 4944 2064 6576 LVM and RAID dev │ │ │ │ │ -00002ae0: 6963 6573 2e0a 0a20 2020 2a20 4120 6772 ices... * A gr │ │ │ │ │ -00002af0: 6170 6869 6361 6c20 7465 726d 696e 616c aphical terminal │ │ │ │ │ -00002b00: 2061 6e64 2061 2067 7261 7068 6963 616c and a graphical │ │ │ │ │ -00002b10: 206d 656e 7520 7379 7374 656d 2061 7265 menu system are │ │ │ │ │ -00002b20: 2061 7661 696c 6162 6c65 2e0a 0a20 2020 available... │ │ │ │ │ -00002b30: 2a20 4752 5542 2032 2773 2069 6e74 6572 * GRUB 2's inter │ │ │ │ │ -00002b40: 6661 6365 2063 616e 2062 6520 7472 616e face can be tran │ │ │ │ │ -00002b50: 736c 6174 6564 2c20 696e 636c 7564 696e slated, includin │ │ │ │ │ -00002b60: 6720 6d65 6e75 2065 6e74 7279 206e 616d g menu entry nam │ │ │ │ │ -00002b70: 6573 2e0a 0a20 2020 2a20 5468 6520 696d es... * The im │ │ │ │ │ -00002b80: 6167 6520 6669 6c65 7320 282a 6e6f 7465 age files (*note │ │ │ │ │ -00002b90: 2049 6d61 6765 733a 3a29 2074 6861 7420 Images::) that │ │ │ │ │ -00002ba0: 6d61 6b65 2075 7020 4752 5542 2068 6176 make up GRUB hav │ │ │ │ │ -00002bb0: 6520 6265 656e 0a20 2020 2020 7265 6f72 e been. reor │ │ │ │ │ -00002bc0: 6761 6e69 7365 643b 2053 7461 6765 2031 ganised; Stage 1 │ │ │ │ │ -00002bd0: 2c20 5374 6167 6520 312e 352c 2061 6e64 , Stage 1.5, and │ │ │ │ │ -00002be0: 2053 7461 6765 2032 2061 7265 206e 6f20 Stage 2 are no │ │ │ │ │ -00002bf0: 6d6f 7265 2e0a 0a20 2020 2a20 4752 5542 more... * GRUB │ │ │ │ │ -00002c00: 2032 2070 7574 7320 6d61 6e79 2066 6163 2 puts many fac │ │ │ │ │ -00002c10: 696c 6974 6965 7320 696e 2064 796e 616d ilities in dynam │ │ │ │ │ -00002c20: 6963 616c 6c79 206c 6f61 6465 6420 6d6f ically loaded mo │ │ │ │ │ -00002c30: 6475 6c65 732c 2061 6c6c 6f77 696e 670a dules, allowing. │ │ │ │ │ -00002c40: 2020 2020 2074 6865 2063 6f72 6520 696d the core im │ │ │ │ │ -00002c50: 6167 6520 746f 2062 6520 736d 616c 6c65 age to be smalle │ │ │ │ │ -00002c60: 722c 2061 6e64 2061 6c6c 6f77 696e 6720 r, and allowing │ │ │ │ │ -00002c70: 7468 6520 636f 7265 2069 6d61 6765 2074 the core image t │ │ │ │ │ -00002c80: 6f20 6265 0a20 2020 2020 6275 696c 7420 o be. built │ │ │ │ │ -00002c90: 696e 206d 6f72 6520 666c 6578 6962 6c65 in more flexible │ │ │ │ │ -00002ca0: 2077 6179 732e 0a0a 1f0a 4669 6c65 3a20 ways.....File: │ │ │ │ │ -00002cb0: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ -00002cc0: 3a20 4665 6174 7572 6573 2c20 204e 6578 : Features, Nex │ │ │ │ │ -00002cd0: 743a 2052 6f6c 6520 6f66 2061 2062 6f6f t: Role of a boo │ │ │ │ │ -00002ce0: 7420 6c6f 6164 6572 2c20 2050 7265 763a t loader, Prev: │ │ │ │ │ -00002cf0: 2043 6861 6e67 6573 2066 726f 6d20 4752 Changes from GR │ │ │ │ │ -00002d00: 5542 204c 6567 6163 792c 2020 5570 3a20 UB Legacy, Up: │ │ │ │ │ -00002d10: 496e 7472 6f64 7563 7469 6f6e 0a0a 312e Introduction..1. │ │ │ │ │ -00002d20: 3420 4752 5542 2066 6561 7475 7265 730a 4 GRUB features. │ │ │ │ │ -00002d30: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00002d40: 3d0a 0a54 6865 2070 7269 6d61 7279 2072 =..The primary r │ │ │ │ │ -00002d50: 6571 7569 7265 6d65 6e74 2066 6f72 2047 equirement for G │ │ │ │ │ -00002d60: 5255 4220 6973 2074 6861 7420 6974 2062 RUB is that it b │ │ │ │ │ -00002d70: 6520 636f 6d70 6c69 616e 7420 7769 7468 e compliant with │ │ │ │ │ -00002d80: 2074 6865 0a22 4d75 6c74 6962 6f6f 7420 the."Multiboot │ │ │ │ │ -00002d90: 5370 6563 6966 6963 6174 696f 6e22 2c20 Specification", │ │ │ │ │ -00002da0: 7768 6963 6820 6973 2064 6573 6372 6962 which is describ │ │ │ │ │ -00002db0: 6564 2069 6e20 2a6e 6f74 6520 4d75 6c74 ed in *note Mult │ │ │ │ │ -00002dc0: 6962 6f6f 740a 5370 6563 6966 6963 6174 iboot.Specificat │ │ │ │ │ -00002dd0: 696f 6e3a 2028 6d75 6c74 6962 6f6f 7429 ion: (multiboot) │ │ │ │ │ -00002de0: 546f 702e 0a0a 2020 2054 6865 206f 7468 Top... The oth │ │ │ │ │ -00002df0: 6572 2067 6f61 6c73 2c20 6c69 7374 6564 er goals, listed │ │ │ │ │ -00002e00: 2069 6e20 6170 7072 6f78 696d 6174 6520 in approximate │ │ │ │ │ -00002e10: 6f72 6465 7220 6f66 2069 6d70 6f72 7461 order of importa │ │ │ │ │ -00002e20: 6e63 652c 2061 7265 3a0a 0a20 2020 2a20 nce, are:.. * │ │ │ │ │ -00002e30: 4261 7369 6320 6675 6e63 7469 6f6e 7320 Basic functions │ │ │ │ │ -00002e40: 6d75 7374 2062 6520 7374 7261 6967 6874 must be straight │ │ │ │ │ -00002e50: 666f 7277 6172 6420 666f 7220 656e 642d forward for end- │ │ │ │ │ -00002e60: 7573 6572 732e 0a0a 2020 202a 2052 6963 users... * Ric │ │ │ │ │ -00002e70: 6820 6675 6e63 7469 6f6e 616c 6974 7920 h functionality │ │ │ │ │ -00002e80: 746f 2073 7570 706f 7274 206b 6572 6e65 to support kerne │ │ │ │ │ -00002e90: 6c20 6578 7065 7274 7320 616e 6420 6465 l experts and de │ │ │ │ │ -00002ea0: 7369 676e 6572 732e 0a0a 2020 202a 2042 signers... * B │ │ │ │ │ -00002eb0: 6163 6b77 6172 6420 636f 6d70 6174 6962 ackward compatib │ │ │ │ │ -00002ec0: 696c 6974 7920 666f 7220 626f 6f74 696e ility for bootin │ │ │ │ │ -00002ed0: 6720 4672 6565 4253 442c 204e 6574 4253 g FreeBSD, NetBS │ │ │ │ │ -00002ee0: 442c 204f 7065 6e42 5344 2c20 616e 640a D, OpenBSD, and. │ │ │ │ │ -00002ef0: 2020 2020 204c 696e 7578 2e20 2050 726f Linux. Pro │ │ │ │ │ -00002f00: 7072 6965 7461 7279 206b 6572 6e65 6c73 prietary kernels │ │ │ │ │ -00002f10: 2028 7375 6368 2061 7320 444f 532c 2057 (such as DOS, W │ │ │ │ │ -00002f20: 696e 646f 7773 204e 542c 2061 6e64 204f indows NT, and O │ │ │ │ │ -00002f30: 532f 3229 2061 7265 0a20 2020 2020 7375 S/2) are. su │ │ │ │ │ -00002f40: 7070 6f72 7465 6420 7669 6120 6120 6368 pported via a ch │ │ │ │ │ -00002f50: 6169 6e2d 6c6f 6164 696e 6720 6675 6e63 ain-loading func │ │ │ │ │ -00002f60: 7469 6f6e 2e0a 0a20 2020 4578 6365 7074 tion... Except │ │ │ │ │ -00002f70: 2066 6f72 2073 7065 6369 6669 6320 636f for specific co │ │ │ │ │ -00002f80: 6d70 6174 6962 696c 6974 7920 6d6f 6465 mpatibility mode │ │ │ │ │ -00002f90: 7320 2863 6861 696e 2d6c 6f61 6469 6e67 s (chain-loading │ │ │ │ │ -00002fa0: 2061 6e64 2074 6865 204c 696e 7578 0a22 and the Linux." │ │ │ │ │ -00002fb0: 7069 6767 7962 6163 6b22 2066 6f72 6d61 piggyback" forma │ │ │ │ │ -00002fc0: 7429 2c20 616c 6c20 6b65 726e 656c 7320 t), all kernels │ │ │ │ │ -00002fd0: 7769 6c6c 2062 6520 7374 6172 7465 6420 will be started │ │ │ │ │ -00002fe0: 696e 206d 7563 6820 7468 6520 7361 6d65 in much the same │ │ │ │ │ -00002ff0: 2073 7461 7465 0a61 7320 696e 2074 6865 state.as in the │ │ │ │ │ -00003000: 204d 756c 7469 626f 6f74 2053 7065 6369 Multiboot Speci │ │ │ │ │ -00003010: 6669 6361 7469 6f6e 2e20 204f 6e6c 7920 fication. Only │ │ │ │ │ -00003020: 6b65 726e 656c 7320 6c6f 6164 6564 2061 kernels loaded a │ │ │ │ │ -00003030: 7420 3120 6d65 6761 6279 7465 206f 720a t 1 megabyte or. │ │ │ │ │ -00003040: 6162 6f76 6520 6172 6520 7072 6573 656e above are presen │ │ │ │ │ -00003050: 746c 7920 7375 7070 6f72 7465 642e 2020 tly supported. │ │ │ │ │ -00003060: 416e 7920 6174 7465 6d70 7420 746f 206c Any attempt to l │ │ │ │ │ -00003070: 6f61 6420 6265 6c6f 7720 7468 6174 2062 oad below that b │ │ │ │ │ -00003080: 6f75 6e64 6172 790a 7769 6c6c 2073 696d oundary.will sim │ │ │ │ │ -00003090: 706c 7920 7265 7375 6c74 2069 6e20 696d ply result in im │ │ │ │ │ -000030a0: 6d65 6469 6174 6520 6661 696c 7572 6520 mediate failure │ │ │ │ │ -000030b0: 616e 6420 616e 2065 7272 6f72 206d 6573 and an error mes │ │ │ │ │ -000030c0: 7361 6765 2072 6570 6f72 7469 6e67 0a74 sage reporting.t │ │ │ │ │ -000030d0: 6865 2070 726f 626c 656d 2e0a 0a20 2020 he problem... │ │ │ │ │ -000030e0: 496e 2061 6464 6974 696f 6e20 746f 2074 In addition to t │ │ │ │ │ -000030f0: 6865 2072 6571 7569 7265 6d65 6e74 7320 he requirements │ │ │ │ │ -00003100: 6162 6f76 652c 2047 5255 4220 6861 7320 above, GRUB has │ │ │ │ │ -00003110: 7468 6520 666f 6c6c 6f77 696e 670a 6665 the following.fe │ │ │ │ │ -00003120: 6174 7572 6573 2028 6e6f 7465 2074 6861 atures (note tha │ │ │ │ │ -00003130: 7420 7468 6520 4d75 6c74 6962 6f6f 7420 t the Multiboot │ │ │ │ │ -00003140: 5370 6563 6966 6963 6174 696f 6e20 646f Specification do │ │ │ │ │ -00003150: 6573 6e27 7420 7265 7175 6972 6520 616c esn't require al │ │ │ │ │ -00003160: 6c20 7468 650a 6665 6174 7572 6573 2074 l the.features t │ │ │ │ │ -00003170: 6861 7420 4752 5542 2073 7570 706f 7274 hat GRUB support │ │ │ │ │ -00003180: 7329 3a0a 0a52 6563 6f67 6e69 7a65 206d s):..Recognize m │ │ │ │ │ -00003190: 756c 7469 706c 6520 6578 6563 7574 6162 ultiple executab │ │ │ │ │ -000031a0: 6c65 2066 6f72 6d61 7473 0a20 2020 2020 le formats. │ │ │ │ │ -000031b0: 5375 7070 6f72 7420 6d61 6e79 206f 6620 Support many of │ │ │ │ │ -000031c0: 7468 6520 2261 2e6f 7574 2220 7661 7269 the "a.out" vari │ │ │ │ │ -000031d0: 616e 7473 2070 6c75 7320 2245 4c46 222e ants plus "ELF". │ │ │ │ │ -000031e0: 2053 796d 626f 6c20 7461 626c 6573 2061 Symbol tables a │ │ │ │ │ -000031f0: 7265 0a20 2020 2020 616c 736f 206c 6f61 re. also loa │ │ │ │ │ -00003200: 6465 642e 0a0a 5375 7070 6f72 7420 6e6f ded...Support no │ │ │ │ │ -00003210: 6e2d 4d75 6c74 6962 6f6f 7420 6b65 726e n-Multiboot kern │ │ │ │ │ -00003220: 656c 730a 2020 2020 2053 7570 706f 7274 els. Support │ │ │ │ │ -00003230: 206d 616e 7920 6f66 2074 6865 2076 6172 many of the var │ │ │ │ │ -00003240: 696f 7573 2066 7265 6520 3332 2d62 6974 ious free 32-bit │ │ │ │ │ -00003250: 206b 6572 6e65 6c73 2074 6861 7420 6c61 kernels that la │ │ │ │ │ -00003260: 636b 204d 756c 7469 626f 6f74 0a20 2020 ck Multiboot. │ │ │ │ │ -00003270: 2020 636f 6d70 6c69 616e 6365 2028 7072 compliance (pr │ │ │ │ │ -00003280: 696d 6172 696c 7920 4672 6565 4253 442c imarily FreeBSD, │ │ │ │ │ -00003290: 204e 6574 4253 4428 3129 2028 2a6e 6f74 NetBSD(1) (*not │ │ │ │ │ -000032a0: 650a 2020 2020 2046 6561 7475 7265 732d e. Features- │ │ │ │ │ -000032b0: 466f 6f74 6e6f 7465 2d31 3a3a 292c 204f Footnote-1::), O │ │ │ │ │ -000032c0: 7065 6e42 5344 2c20 616e 6420 4c69 6e75 penBSD, and Linu │ │ │ │ │ -000032d0: 7829 2e20 2043 6861 696e 2d6c 6f61 6469 x). Chain-loadi │ │ │ │ │ -000032e0: 6e67 206f 660a 2020 2020 206f 7468 6572 ng of. other │ │ │ │ │ -000032f0: 2062 6f6f 7420 6c6f 6164 6572 7320 6973 boot loaders is │ │ │ │ │ -00003300: 2061 6c73 6f20 7375 7070 6f72 7465 642e also supported. │ │ │ │ │ -00003310: 0a0a 4c6f 6164 206d 756c 7469 706c 6573 ..Load multiples │ │ │ │ │ -00003320: 206d 6f64 756c 6573 0a20 2020 2020 4675 modules. Fu │ │ │ │ │ -00003330: 6c6c 7920 7375 7070 6f72 7420 7468 6520 lly support the │ │ │ │ │ -00003340: 4d75 6c74 6962 6f6f 7420 6665 6174 7572 Multiboot featur │ │ │ │ │ -00003350: 6520 6f66 206c 6f61 6469 6e67 206d 756c e of loading mul │ │ │ │ │ -00003360: 7469 706c 6520 6d6f 6475 6c65 732e 0a0a tiple modules... │ │ │ │ │ -00003370: 4c6f 6164 2061 2063 6f6e 6669 6775 7261 Load a configura │ │ │ │ │ -00003380: 7469 6f6e 2066 696c 650a 2020 2020 2053 tion file. S │ │ │ │ │ -00003390: 7570 706f 7274 2061 2068 756d 616e 2d72 upport a human-r │ │ │ │ │ -000033a0: 6561 6461 626c 6520 7465 7874 2063 6f6e eadable text con │ │ │ │ │ -000033b0: 6669 6775 7261 7469 6f6e 2066 696c 6520 figuration file │ │ │ │ │ -000033c0: 7769 7468 2070 7265 7365 7420 626f 6f74 with preset boot │ │ │ │ │ -000033d0: 0a20 2020 2020 636f 6d6d 616e 6473 2e20 . commands. │ │ │ │ │ -000033e0: 2059 6f75 2063 616e 2061 6c73 6f20 6c6f You can also lo │ │ │ │ │ -000033f0: 6164 2061 6e6f 7468 6572 2063 6f6e 6669 ad another confi │ │ │ │ │ -00003400: 6775 7261 7469 6f6e 2066 696c 6520 6479 guration file dy │ │ │ │ │ -00003410: 6e61 6d69 6361 6c6c 790a 2020 2020 2061 namically. a │ │ │ │ │ -00003420: 6e64 2065 6d62 6564 2061 2070 7265 7365 nd embed a prese │ │ │ │ │ -00003430: 7420 636f 6e66 6967 7572 6174 696f 6e20 t configuration │ │ │ │ │ -00003440: 6669 6c65 2069 6e20 6120 4752 5542 2069 file in a GRUB i │ │ │ │ │ -00003450: 6d61 6765 2066 696c 652e 2020 5468 650a mage file. The. │ │ │ │ │ -00003460: 2020 2020 206c 6973 7420 6f66 2063 6f6d list of com │ │ │ │ │ -00003470: 6d61 6e64 7320 282a 6e6f 7465 2043 6f6d mands (*note Com │ │ │ │ │ -00003480: 6d61 6e64 733a 3a29 2061 7265 2061 2073 mands::) are a s │ │ │ │ │ -00003490: 7570 6572 7365 7420 6f66 2074 686f 7365 uperset of those │ │ │ │ │ -000034a0: 0a20 2020 2020 7375 7070 6f72 7465 6420 . supported │ │ │ │ │ -000034b0: 6f6e 2074 6865 2063 6f6d 6d61 6e64 2d6c on the command-l │ │ │ │ │ -000034c0: 696e 652e 2020 416e 2065 7861 6d70 6c65 ine. An example │ │ │ │ │ -000034d0: 2063 6f6e 6669 6775 7261 7469 6f6e 2066 configuration f │ │ │ │ │ -000034e0: 696c 6520 6973 0a20 2020 2020 7072 6f76 ile is. prov │ │ │ │ │ -000034f0: 6964 6564 2069 6e20 2a6e 6f74 6520 436f ided in *note Co │ │ │ │ │ -00003500: 6e66 6967 7572 6174 696f 6e3a 3a2e 0a0a nfiguration::... │ │ │ │ │ -00003510: 5072 6f76 6964 6520 6120 6d65 6e75 2069 Provide a menu i │ │ │ │ │ -00003520: 6e74 6572 6661 6365 0a20 2020 2020 4120 nterface. A │ │ │ │ │ -00003530: 6d65 6e75 2069 6e74 6572 6661 6365 206c menu interface l │ │ │ │ │ -00003540: 6973 7469 6e67 2070 7265 7365 7420 626f isting preset bo │ │ │ │ │ -00003550: 6f74 2063 6f6d 6d61 6e64 732c 2077 6974 ot commands, wit │ │ │ │ │ -00003560: 6820 6120 7072 6f67 7261 6d6d 6162 6c65 h a programmable │ │ │ │ │ -00003570: 0a20 2020 2020 7469 6d65 6f75 742c 2069 . timeout, i │ │ │ │ │ -00003580: 7320 6176 6169 6c61 626c 652e 2020 5468 s available. Th │ │ │ │ │ -00003590: 6572 6520 6973 206e 6f20 6669 7865 6420 ere is no fixed │ │ │ │ │ -000035a0: 6c69 6d69 7420 6f6e 2074 6865 206e 756d limit on the num │ │ │ │ │ -000035b0: 6265 7220 6f66 0a20 2020 2020 626f 6f74 ber of. boot │ │ │ │ │ -000035c0: 2065 6e74 7269 6573 2c20 616e 6420 7468 entries, and th │ │ │ │ │ -000035d0: 6520 6375 7272 656e 7420 696d 706c 656d e current implem │ │ │ │ │ -000035e0: 656e 7461 7469 6f6e 2068 6173 2073 7061 entation has spa │ │ │ │ │ -000035f0: 6365 2066 6f72 2073 6576 6572 616c 0a20 ce for several. │ │ │ │ │ -00003600: 2020 2020 6875 6e64 7265 642e 0a0a 4861 hundred...Ha │ │ │ │ │ -00003610: 7665 2061 2066 6c65 7869 626c 6520 636f ve a flexible co │ │ │ │ │ -00003620: 6d6d 616e 642d 6c69 6e65 2069 6e74 6572 mmand-line inter │ │ │ │ │ -00003630: 6661 6365 0a20 2020 2020 4120 6661 6972 face. A fair │ │ │ │ │ -00003640: 6c79 2066 6c65 7869 626c 6520 636f 6d6d ly flexible comm │ │ │ │ │ -00003650: 616e 642d 6c69 6e65 2069 6e74 6572 6661 and-line interfa │ │ │ │ │ -00003660: 6365 2c20 6163 6365 7373 6962 6c65 2066 ce, accessible f │ │ │ │ │ -00003670: 726f 6d20 7468 6520 6d65 6e75 2c0a 2020 rom the menu,. │ │ │ │ │ -00003680: 2020 2069 7320 6176 6169 6c61 626c 6520 is available │ │ │ │ │ -00003690: 746f 2065 6469 7420 616e 7920 7072 6573 to edit any pres │ │ │ │ │ -000036a0: 6574 2063 6f6d 6d61 6e64 732c 206f 7220 et commands, or │ │ │ │ │ -000036b0: 7772 6974 6520 6120 6e65 7720 626f 6f74 write a new boot │ │ │ │ │ -000036c0: 0a20 2020 2020 636f 6d6d 616e 6420 7365 . command se │ │ │ │ │ -000036d0: 7420 6672 6f6d 2073 6372 6174 6368 2e20 t from scratch. │ │ │ │ │ -000036e0: 2049 6620 6e6f 2063 6f6e 6669 6775 7261 If no configura │ │ │ │ │ -000036f0: 7469 6f6e 2066 696c 6520 6973 2070 7265 tion file is pre │ │ │ │ │ -00003700: 7365 6e74 2c0a 2020 2020 2047 5255 4220 sent,. GRUB │ │ │ │ │ -00003710: 6472 6f70 7320 746f 2074 6865 2063 6f6d drops to the com │ │ │ │ │ -00003720: 6d61 6e64 2d6c 696e 652e 0a0a 2020 2020 mand-line... │ │ │ │ │ -00003730: 2054 6865 206c 6973 7420 6f66 2063 6f6d The list of com │ │ │ │ │ -00003740: 6d61 6e64 7320 282a 6e6f 7465 2043 6f6d mands (*note Com │ │ │ │ │ -00003750: 6d61 6e64 733a 3a29 2061 7265 2061 2073 mands::) are a s │ │ │ │ │ -00003760: 7562 7365 7420 6f66 2074 686f 7365 0a20 ubset of those. │ │ │ │ │ -00003770: 2020 2020 7375 7070 6f72 7465 6420 666f supported fo │ │ │ │ │ -00003780: 7220 636f 6e66 6967 7572 6174 696f 6e20 r configuration │ │ │ │ │ -00003790: 6669 6c65 732e 2020 4564 6974 696e 6720 files. Editing │ │ │ │ │ -000037a0: 636f 6d6d 616e 6473 2063 6c6f 7365 6c79 commands closely │ │ │ │ │ -000037b0: 0a20 2020 2020 7265 7365 6d62 6c65 7320 . resembles │ │ │ │ │ -000037c0: 7468 6520 4261 7368 2063 6f6d 6d61 6e64 the Bash command │ │ │ │ │ -000037d0: 2d6c 696e 6520 282a 6e6f 7465 2042 6173 -line (*note Bas │ │ │ │ │ -000037e0: 683a 2028 6665 6174 7572 6573 2943 6f6d h: (features)Com │ │ │ │ │ -000037f0: 6d61 6e64 204c 696e 650a 2020 2020 2045 mand Line. E │ │ │ │ │ -00003800: 6469 7469 6e67 2e29 2c20 7769 7468 203c diting.), with < │ │ │ │ │ -00003810: 5441 423e 2d63 6f6d 706c 6574 696f 6e20 TAB>-completion │ │ │ │ │ -00003820: 6f66 2063 6f6d 6d61 6e64 732c 2064 6576 of commands, dev │ │ │ │ │ -00003830: 6963 6573 2c20 7061 7274 6974 696f 6e73 ices, partitions │ │ │ │ │ -00003840: 2c0a 2020 2020 2061 6e64 2066 696c 6573 ,. and files │ │ │ │ │ -00003850: 2069 6e20 6120 6469 7265 6374 6f72 7920 in a directory │ │ │ │ │ -00003860: 6465 7065 6e64 696e 6720 6f6e 2063 6f6e depending on con │ │ │ │ │ -00003870: 7465 7874 2e0a 0a53 7570 706f 7274 206d text...Support m │ │ │ │ │ -00003880: 756c 7469 706c 6520 6669 6c65 7379 7374 ultiple filesyst │ │ │ │ │ -00003890: 656d 2074 7970 6573 0a20 2020 2020 5375 em types. Su │ │ │ │ │ -000038a0: 7070 6f72 7420 6d75 6c74 6970 6c65 2066 pport multiple f │ │ │ │ │ -000038b0: 696c 6573 7973 7465 6d20 7479 7065 7320 ilesystem types │ │ │ │ │ -000038c0: 7472 616e 7370 6172 656e 746c 792c 2070 transparently, p │ │ │ │ │ -000038d0: 6c75 7320 6120 7573 6566 756c 0a20 2020 lus a useful. │ │ │ │ │ -000038e0: 2020 6578 706c 6963 6974 2062 6c6f 636b explicit block │ │ │ │ │ -000038f0: 6c69 7374 206e 6f74 6174 696f 6e2e 2020 list notation. │ │ │ │ │ -00003900: 5468 6520 6375 7272 656e 746c 7920 7375 The currently su │ │ │ │ │ -00003910: 7070 6f72 7465 6420 6669 6c65 7379 7374 pported filesyst │ │ │ │ │ -00003920: 656d 0a20 2020 2020 7479 7065 7320 6172 em. types ar │ │ │ │ │ -00003930: 6520 2241 6d69 6761 2046 6173 7420 4669 e "Amiga Fast Fi │ │ │ │ │ -00003940: 6c65 5379 7374 656d 2028 4146 4653 2922 leSystem (AFFS)" │ │ │ │ │ -00003950: 2c20 2241 7468 654f 5320 6673 222c 2022 , "AtheOS fs", " │ │ │ │ │ -00003960: 4265 4653 222c 0a20 2020 2020 2242 7472 BeFS",. "Btr │ │ │ │ │ -00003970: 4653 2220 2869 6e63 6c75 6469 6e67 2072 FS" (including r │ │ │ │ │ -00003980: 6169 6430 2c20 7261 6964 312c 2072 6169 aid0, raid1, rai │ │ │ │ │ -00003990: 6431 302c 2067 7a69 7020 616e 6420 6c7a d10, gzip and lz │ │ │ │ │ -000039a0: 6f29 2c20 2263 7069 6f22 0a20 2020 2020 o), "cpio". │ │ │ │ │ -000039b0: 286c 6974 746c 652d 2061 6e64 2062 6967 (little- and big │ │ │ │ │ -000039c0: 2d65 6e64 6961 6e20 6269 6e2c 206f 6463 -endian bin, odc │ │ │ │ │ -000039d0: 2061 6e64 206e 6577 6320 7661 7269 616e and newc varian │ │ │ │ │ -000039e0: 7473 292c 2022 4c69 6e75 780a 2020 2020 ts), "Linux. │ │ │ │ │ -000039f0: 2065 7874 322f 6578 7433 2f65 7874 3422 ext2/ext3/ext4" │ │ │ │ │ -00003a00: 2c20 2244 4f53 2046 4154 3132 2f46 4154 , "DOS FAT12/FAT │ │ │ │ │ -00003a10: 3136 2f46 4154 3332 222c 2022 6578 4641 16/FAT32", "exFA │ │ │ │ │ -00003a20: 5422 2c20 2246 3246 5322 2c20 2248 4653 T", "F2FS", "HFS │ │ │ │ │ -00003a30: 222c 0a20 2020 2020 2248 4653 2b22 2c20 ",. "HFS+", │ │ │ │ │ -00003a40: 2249 534f 3936 3630 2220 2869 6e63 6c75 "ISO9660" (inclu │ │ │ │ │ -00003a50: 6469 6e67 204a 6f6c 6965 742c 2052 6f63 ding Joliet, Roc │ │ │ │ │ -00003a60: 6b2d 7269 6467 6520 616e 6420 6d75 6c74 k-ridge and mult │ │ │ │ │ -00003a70: 692d 6368 756e 6b0a 2020 2020 2066 696c i-chunk. fil │ │ │ │ │ -00003a80: 6573 292c 2022 4a46 5322 2c20 224d 696e es), "JFS", "Min │ │ │ │ │ -00003a90: 6978 2066 7322 2028 7665 7273 696f 6e73 ix fs" (versions │ │ │ │ │ -00003aa0: 2031 2c20 3220 616e 6420 3329 2c20 226e 1, 2 and 3), "n │ │ │ │ │ -00003ab0: 696c 6673 3222 2c20 224e 5446 5322 0a20 ilfs2", "NTFS". │ │ │ │ │ -00003ac0: 2020 2020 2869 6e63 6c75 6469 6e67 2063 (including c │ │ │ │ │ -00003ad0: 6f6d 7072 6573 7369 6f6e 292c 2022 5265 ompression), "Re │ │ │ │ │ -00003ae0: 6973 6572 4653 222c 2022 524f 4d46 5322 iserFS", "ROMFS" │ │ │ │ │ -00003af0: 2c20 2241 6d69 6761 2053 6d61 7274 0a20 , "Amiga Smart. │ │ │ │ │ -00003b00: 2020 2020 4669 6c65 5379 7374 656d 2028 FileSystem ( │ │ │ │ │ -00003b10: 5346 5329 222c 2022 5371 7561 7368 3422 SFS)", "Squash4" │ │ │ │ │ -00003b20: 2c20 2274 6172 222c 2022 5544 4622 2c20 , "tar", "UDF", │ │ │ │ │ -00003b30: 2242 5344 2055 4653 2f55 4653 3222 2c20 "BSD UFS/UFS2", │ │ │ │ │ -00003b40: 2258 4653 222c 0a20 2020 2020 616e 6420 "XFS",. and │ │ │ │ │ -00003b50: 225a 4653 2220 2869 6e63 6c75 6469 6e67 "ZFS" (including │ │ │ │ │ -00003b60: 206c 7a6a 622c 2067 7a69 702c 207a 6c65 lzjb, gzip, zle │ │ │ │ │ -00003b70: 2c20 6d69 7272 6f72 2c20 7374 7269 7065 , mirror, stripe │ │ │ │ │ -00003b80: 2c20 7261 6964 7a31 2f32 2f33 0a20 2020 , raidz1/2/3. │ │ │ │ │ -00003b90: 2020 616e 6420 656e 6372 7970 7469 6f6e and encryption │ │ │ │ │ -00003ba0: 2069 6e20 4145 532d 4343 4d20 616e 6420 in AES-CCM and │ │ │ │ │ -00003bb0: 4145 532d 4743 4d29 2e20 2a4e 6f74 6520 AES-GCM). *Note │ │ │ │ │ -00003bc0: 4669 6c65 7379 7374 656d 3a3a 2c20 666f Filesystem::, fo │ │ │ │ │ -00003bd0: 720a 2020 2020 206d 6f72 6520 696e 666f r. more info │ │ │ │ │ -00003be0: 726d 6174 696f 6e2e 0a0a 5375 7070 6f72 rmation...Suppor │ │ │ │ │ -00003bf0: 7420 6175 746f 6d61 7469 6320 6465 636f t automatic deco │ │ │ │ │ -00003c00: 6d70 7265 7373 696f 6e0a 2020 2020 2043 mpression. C │ │ │ │ │ -00003c10: 616e 2064 6563 6f6d 7072 6573 7320 6669 an decompress fi │ │ │ │ │ -00003c20: 6c65 7320 7768 6963 6820 7765 7265 2063 les which were c │ │ │ │ │ -00003c30: 6f6d 7072 6573 7365 6420 6279 2027 677a ompressed by 'gz │ │ │ │ │ -00003c40: 6970 2720 6f72 2027 787a 2728 3229 0a20 ip' or 'xz'(2). │ │ │ │ │ -00003c50: 2020 2020 282a 6e6f 7465 2046 6561 7475 (*note Featu │ │ │ │ │ -00003c60: 7265 732d 466f 6f74 6e6f 7465 2d32 3a3a res-Footnote-2:: │ │ │ │ │ -00003c70: 292e 2020 5468 6973 2066 756e 6374 696f ). This functio │ │ │ │ │ -00003c80: 6e20 6973 2062 6f74 6820 6175 746f 6d61 n is both automa │ │ │ │ │ -00003c90: 7469 6320 616e 640a 2020 2020 2074 7261 tic and. tra │ │ │ │ │ -00003ca0: 6e73 7061 7265 6e74 2074 6f20 7468 6520 nsparent to the │ │ │ │ │ -00003cb0: 7573 6572 2028 692e 652e 2020 616c 6c20 user (i.e. all │ │ │ │ │ -00003cc0: 6675 6e63 7469 6f6e 7320 6f70 6572 6174 functions operat │ │ │ │ │ -00003cd0: 6520 7570 6f6e 2074 6865 0a20 2020 2020 e upon the. │ │ │ │ │ -00003ce0: 756e 636f 6d70 7265 7373 6564 2063 6f6e uncompressed con │ │ │ │ │ -00003cf0: 7465 6e74 7320 6f66 2074 6865 2073 7065 tents of the spe │ │ │ │ │ -00003d00: 6369 6669 6564 2066 696c 6573 292e 2020 cified files). │ │ │ │ │ -00003d10: 5468 6973 2067 7265 6174 6c79 0a20 2020 This greatly. │ │ │ │ │ -00003d20: 2020 7265 6475 6365 7320 6120 6669 6c65 reduces a file │ │ │ │ │ -00003d30: 2073 697a 6520 616e 6420 6c6f 6164 696e size and loadin │ │ │ │ │ -00003d40: 6720 7469 6d65 2c20 6120 7061 7274 6963 g time, a partic │ │ │ │ │ -00003d50: 756c 6172 6c79 2067 7265 6174 2062 656e ularly great ben │ │ │ │ │ -00003d60: 6566 6974 0a20 2020 2020 666f 7220 666c efit. for fl │ │ │ │ │ -00003d70: 6f70 7069 6573 2e28 3329 2020 282a 6e6f oppies.(3) (*no │ │ │ │ │ -00003d80: 7465 2046 6561 7475 7265 732d 466f 6f74 te Features-Foot │ │ │ │ │ -00003d90: 6e6f 7465 2d33 3a3a 290a 0a20 2020 2020 note-3::).. │ │ │ │ │ -00003da0: 4974 2069 7320 636f 6e63 6569 7661 626c It is conceivabl │ │ │ │ │ -00003db0: 6520 7468 6174 2073 6f6d 6520 6b65 726e e that some kern │ │ │ │ │ -00003dc0: 656c 206d 6f64 756c 6573 2073 686f 756c el modules shoul │ │ │ │ │ -00003dd0: 6420 6265 206c 6f61 6465 6420 696e 2061 d be loaded in a │ │ │ │ │ -00003de0: 0a20 2020 2020 636f 6d70 7265 7373 6564 . compressed │ │ │ │ │ -00003df0: 2073 7461 7465 2c20 736f 2061 2064 6966 state, so a dif │ │ │ │ │ -00003e00: 6665 7265 6e74 206d 6f64 756c 652d 6c6f ferent module-lo │ │ │ │ │ -00003e10: 6164 696e 6720 636f 6d6d 616e 6420 6361 ading command ca │ │ │ │ │ -00003e20: 6e20 6265 0a20 2020 2020 7370 6563 6966 n be. specif │ │ │ │ │ -00003e30: 6965 6420 746f 2061 766f 6964 2075 6e63 ied to avoid unc │ │ │ │ │ -00003e40: 6f6d 7072 6573 7369 6e67 2074 6865 206d ompressing the m │ │ │ │ │ -00003e50: 6f64 756c 6573 2e0a 0a41 6363 6573 7320 odules...Access │ │ │ │ │ -00003e60: 6461 7461 206f 6e20 616e 7920 696e 7374 data on any inst │ │ │ │ │ -00003e70: 616c 6c65 6420 6465 7669 6365 0a20 2020 alled device. │ │ │ │ │ -00003e80: 2020 5375 7070 6f72 7420 7265 6164 696e Support readin │ │ │ │ │ -00003e90: 6720 6461 7461 2066 726f 6d20 616e 7920 g data from any │ │ │ │ │ -00003ea0: 6f72 2061 6c6c 2066 6c6f 7070 6965 7320 or all floppies │ │ │ │ │ -00003eb0: 6f72 2068 6172 6420 6469 736b 2873 290a or hard disk(s). │ │ │ │ │ -00003ec0: 2020 2020 2072 6563 6f67 6e69 7a65 6420 recognized │ │ │ │ │ -00003ed0: 6279 2074 6865 2042 494f 532c 2069 6e64 by the BIOS, ind │ │ │ │ │ -00003ee0: 6570 656e 6465 6e74 206f 6620 7468 6520 ependent of the │ │ │ │ │ -00003ef0: 7365 7474 696e 6720 6f66 2074 6865 2072 setting of the r │ │ │ │ │ -00003f00: 6f6f 740a 2020 2020 2064 6576 6963 652e oot. device. │ │ │ │ │ -00003f10: 0a0a 4265 2069 6e64 6570 656e 6465 6e74 ..Be independent │ │ │ │ │ -00003f20: 206f 6620 6472 6976 6520 6765 6f6d 6574 of drive geomet │ │ │ │ │ -00003f30: 7279 2074 7261 6e73 6c61 7469 6f6e 730a ry translations. │ │ │ │ │ -00003f40: 2020 2020 2055 6e6c 696b 6520 6d61 6e79 Unlike many │ │ │ │ │ -00003f50: 206f 7468 6572 2062 6f6f 7420 6c6f 6164 other boot load │ │ │ │ │ -00003f60: 6572 732c 2047 5255 4220 6d61 6b65 7320 ers, GRUB makes │ │ │ │ │ -00003f70: 7468 6520 7061 7274 6963 756c 6172 2064 the particular d │ │ │ │ │ -00003f80: 7269 7665 0a20 2020 2020 7472 616e 736c rive. transl │ │ │ │ │ -00003f90: 6174 696f 6e20 6972 7265 6c65 7661 6e74 ation irrelevant │ │ │ │ │ -00003fa0: 2e20 2041 2064 7269 7665 2069 6e73 7461 . A drive insta │ │ │ │ │ -00003fb0: 6c6c 6564 2061 6e64 2072 756e 6e69 6e67 lled and running │ │ │ │ │ -00003fc0: 2077 6974 6820 6f6e 650a 2020 2020 2074 with one. t │ │ │ │ │ -00003fd0: 7261 6e73 6c61 7469 6f6e 206d 6179 2062 ranslation may b │ │ │ │ │ -00003fe0: 6520 636f 6e76 6572 7465 6420 746f 2061 e converted to a │ │ │ │ │ -00003ff0: 6e6f 7468 6572 2074 7261 6e73 6c61 7469 nother translati │ │ │ │ │ -00004000: 6f6e 2077 6974 686f 7574 2061 6e79 0a20 on without any. │ │ │ │ │ -00004010: 2020 2020 6164 7665 7273 6520 6566 6665 adverse effe │ │ │ │ │ -00004020: 6374 7320 6f72 2063 6861 6e67 6573 2069 cts or changes i │ │ │ │ │ -00004030: 6e20 4752 5542 2773 2063 6f6e 6669 6775 n GRUB's configu │ │ │ │ │ -00004040: 7261 7469 6f6e 2e0a 0a44 6574 6563 7420 ration...Detect │ │ │ │ │ -00004050: 616c 6c20 696e 7374 616c 6c65 6420 5241 all installed RA │ │ │ │ │ -00004060: 4d0a 2020 2020 2047 5255 4220 6361 6e20 M. GRUB can │ │ │ │ │ -00004070: 6765 6e65 7261 6c6c 7920 6669 6e64 2061 generally find a │ │ │ │ │ -00004080: 6c6c 2074 6865 2069 6e73 7461 6c6c 6564 ll the installed │ │ │ │ │ -00004090: 2052 414d 206f 6e20 6120 5043 2d63 6f6d RAM on a PC-com │ │ │ │ │ -000040a0: 7061 7469 626c 650a 2020 2020 206d 6163 patible. mac │ │ │ │ │ -000040b0: 6869 6e65 2e20 2049 7420 7573 6573 2061 hine. It uses a │ │ │ │ │ -000040c0: 6e20 6164 7661 6e63 6564 2042 494f 5320 n advanced BIOS │ │ │ │ │ -000040d0: 7175 6572 7920 7465 6368 6e69 7175 6520 query technique │ │ │ │ │ -000040e0: 666f 7220 6669 6e64 696e 6720 616c 6c0a for finding all. │ │ │ │ │ -000040f0: 2020 2020 206d 656d 6f72 7920 7265 6769 memory regi │ │ │ │ │ -00004100: 6f6e 732e 2020 4173 2064 6573 6372 6962 ons. As describ │ │ │ │ │ -00004110: 6564 206f 6e20 7468 6520 4d75 6c74 6962 ed on the Multib │ │ │ │ │ -00004120: 6f6f 7420 5370 6563 6966 6963 6174 696f oot Specificatio │ │ │ │ │ -00004130: 6e20 282a 6e6f 7465 0a20 2020 2020 4d75 n (*note. Mu │ │ │ │ │ -00004140: 6c74 6962 6f6f 7420 5370 6563 6966 6963 ltiboot Specific │ │ │ │ │ -00004150: 6174 696f 6e3a 2028 6d75 6c74 6962 6f6f ation: (multiboo │ │ │ │ │ -00004160: 7429 546f 702e 292c 206e 6f74 2061 6c6c t)Top.), not all │ │ │ │ │ -00004170: 206b 6572 6e65 6c73 206d 616b 6520 7573 kernels make us │ │ │ │ │ -00004180: 650a 2020 2020 206f 6620 7468 6973 2069 e. of this i │ │ │ │ │ -00004190: 6e66 6f72 6d61 7469 6f6e 2c20 6275 7420 nformation, but │ │ │ │ │ -000041a0: 4752 5542 2070 726f 7669 6465 7320 6974 GRUB provides it │ │ │ │ │ -000041b0: 2066 6f72 2074 686f 7365 2077 686f 2064 for those who d │ │ │ │ │ -000041c0: 6f2e 0a0a 5375 7070 6f72 7420 4c6f 6769 o...Support Logi │ │ │ │ │ -000041d0: 6361 6c20 426c 6f63 6b20 4164 6472 6573 cal Block Addres │ │ │ │ │ -000041e0: 7320 6d6f 6465 0a20 2020 2020 496e 2074 s mode. In t │ │ │ │ │ -000041f0: 7261 6469 7469 6f6e 616c 2064 6973 6b20 raditional disk │ │ │ │ │ -00004200: 6361 6c6c 7320 2863 616c 6c65 6420 2243 calls (called "C │ │ │ │ │ -00004210: 4853 206d 6f64 6522 292c 2074 6865 7265 HS mode"), there │ │ │ │ │ -00004220: 2069 7320 6120 6765 6f6d 6574 7279 0a20 is a geometry. │ │ │ │ │ -00004230: 2020 2020 7472 616e 736c 6174 696f 6e20 translation │ │ │ │ │ -00004240: 7072 6f62 6c65 6d2c 2074 6861 7420 6973 problem, that is │ │ │ │ │ -00004250: 2c20 7468 6520 4249 4f53 2063 616e 6e6f , the BIOS canno │ │ │ │ │ -00004260: 7420 6163 6365 7373 206f 7665 7220 3130 t access over 10 │ │ │ │ │ -00004270: 3234 0a20 2020 2020 6379 6c69 6e64 6572 24. cylinder │ │ │ │ │ -00004280: 732c 2073 6f20 7468 6520 6163 6365 7373 s, so the access │ │ │ │ │ -00004290: 6962 6c65 2073 7061 6365 2069 7320 6c69 ible space is li │ │ │ │ │ -000042a0: 6d69 7465 6420 746f 2061 7420 6c65 6173 mited to at leas │ │ │ │ │ -000042b0: 7420 3530 3820 4d42 0a20 2020 2020 616e t 508 MB. an │ │ │ │ │ -000042c0: 6420 746f 2061 7420 6d6f 7374 2038 4742 d to at most 8GB │ │ │ │ │ -000042d0: 2e20 4752 5542 2063 616e 2774 2075 6e69 . GRUB can't uni │ │ │ │ │ -000042e0: 7665 7273 616c 6c79 2073 6f6c 7665 2074 versally solve t │ │ │ │ │ -000042f0: 6869 7320 7072 6f62 6c65 6d2c 2061 730a his problem, as. │ │ │ │ │ -00004300: 2020 2020 2074 6865 7265 2069 7320 6e6f there is no │ │ │ │ │ -00004310: 2073 7461 6e64 6172 6420 696e 7465 7266 standard interf │ │ │ │ │ -00004320: 6163 6520 7573 6564 2069 6e20 616c 6c20 ace used in all │ │ │ │ │ -00004330: 6d61 6368 696e 6573 2e20 2048 6f77 6576 machines. Howev │ │ │ │ │ -00004340: 6572 2c0a 2020 2020 2073 6576 6572 616c er,. several │ │ │ │ │ -00004350: 206e 6577 6572 206d 6163 6869 6e65 7320 newer machines │ │ │ │ │ -00004360: 6861 7665 2074 6865 206e 6577 2069 6e74 have the new int │ │ │ │ │ -00004370: 6572 6661 6365 2c20 4c6f 6769 6361 6c20 erface, Logical │ │ │ │ │ -00004380: 426c 6f63 6b0a 2020 2020 2041 6464 7265 Block. Addre │ │ │ │ │ -00004390: 7373 2028 224c 4241 2229 206d 6f64 652e ss ("LBA") mode. │ │ │ │ │ -000043a0: 2020 4752 5542 2061 7574 6f6d 6174 6963 GRUB automatic │ │ │ │ │ -000043b0: 616c 6c79 2064 6574 6563 7473 2069 6620 ally detects if │ │ │ │ │ -000043c0: 4c42 4120 6d6f 6465 2069 730a 2020 2020 LBA mode is. │ │ │ │ │ -000043d0: 2061 7661 696c 6162 6c65 2061 6e64 2075 available and u │ │ │ │ │ -000043e0: 7365 7320 6974 2069 6620 6176 6169 6c61 ses it if availa │ │ │ │ │ -000043f0: 626c 652e 2020 496e 204c 4241 206d 6f64 ble. In LBA mod │ │ │ │ │ -00004400: 652c 2047 5255 4220 6361 6e20 6163 6365 e, GRUB can acce │ │ │ │ │ -00004410: 7373 0a20 2020 2020 7468 6520 656e 7469 ss. the enti │ │ │ │ │ -00004420: 7265 2064 6973 6b2e 0a0a 5375 7070 6f72 re disk...Suppor │ │ │ │ │ -00004430: 7420 6e65 7477 6f72 6b20 626f 6f74 696e t network bootin │ │ │ │ │ -00004440: 670a 2020 2020 2047 5255 4220 6973 2062 g. GRUB is b │ │ │ │ │ -00004450: 6173 6963 616c 6c79 2061 2064 6973 6b2d asically a disk- │ │ │ │ │ -00004460: 6261 7365 6420 626f 6f74 206c 6f61 6465 based boot loade │ │ │ │ │ -00004470: 7220 6275 7420 616c 736f 2068 6173 206e r but also has n │ │ │ │ │ -00004480: 6574 776f 726b 0a20 2020 2020 7375 7070 etwork. supp │ │ │ │ │ -00004490: 6f72 742e 2020 596f 7520 6361 6e20 6c6f ort. You can lo │ │ │ │ │ -000044a0: 6164 204f 5320 696d 6167 6573 2066 726f ad OS images fro │ │ │ │ │ -000044b0: 6d20 6120 6e65 7477 6f72 6b20 6279 2075 m a network by u │ │ │ │ │ -000044c0: 7369 6e67 2074 6865 2022 5446 5450 220a sing the "TFTP". │ │ │ │ │ -000044d0: 2020 2020 2070 726f 746f 636f 6c2e 0a0a protocol... │ │ │ │ │ -000044e0: 5375 7070 6f72 7420 7265 6d6f 7465 2074 Support remote t │ │ │ │ │ -000044f0: 6572 6d69 6e61 6c73 0a20 2020 2020 546f erminals. To │ │ │ │ │ -00004500: 2073 7570 706f 7274 2063 6f6d 7075 7465 support compute │ │ │ │ │ -00004510: 7273 2077 6974 6820 6e6f 2063 6f6e 736f rs with no conso │ │ │ │ │ -00004520: 6c65 2c20 4752 5542 2070 726f 7669 6465 le, GRUB provide │ │ │ │ │ -00004530: 7320 7265 6d6f 7465 2074 6572 6d69 6e61 s remote termina │ │ │ │ │ -00004540: 6c0a 2020 2020 2073 7570 706f 7274 2c20 l. support, │ │ │ │ │ -00004550: 736f 2074 6861 7420 796f 7520 6361 6e20 so that you can │ │ │ │ │ -00004560: 636f 6e74 726f 6c20 4752 5542 2066 726f control GRUB fro │ │ │ │ │ -00004570: 6d20 6120 7265 6d6f 7465 2068 6f73 742e m a remote host. │ │ │ │ │ -00004580: 2020 4f6e 6c79 0a20 2020 2020 7365 7269 Only. seri │ │ │ │ │ -00004590: 616c 2074 6572 6d69 6e61 6c20 7375 7070 al terminal supp │ │ │ │ │ -000045a0: 6f72 7420 6973 2069 6d70 6c65 6d65 6e74 ort is implement │ │ │ │ │ -000045b0: 6564 2061 7420 7468 6520 6d6f 6d65 6e74 ed at the moment │ │ │ │ │ -000045c0: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ -000045d0: 696e 666f 2c20 204e 6f64 653a 2046 6561 info, Node: Fea │ │ │ │ │ -000045e0: 7475 7265 732d 466f 6f74 6e6f 7465 732c tures-Footnotes, │ │ │ │ │ -000045f0: 2020 5570 3a20 4665 6174 7572 6573 0a0a Up: Features.. │ │ │ │ │ -00004600: 2020 2028 3129 2054 6865 204e 6574 4253 (1) The NetBS │ │ │ │ │ -00004610: 442f 6933 3836 206b 6572 6e65 6c20 6973 D/i386 kernel is │ │ │ │ │ -00004620: 204d 756c 7469 626f 6f74 2d63 6f6d 706c Multiboot-compl │ │ │ │ │ -00004630: 6961 6e74 2c20 6275 7420 6c61 636b 7320 iant, but lacks │ │ │ │ │ -00004640: 7375 7070 6f72 740a 666f 7220 4d75 6c74 support.for Mult │ │ │ │ │ -00004650: 6962 6f6f 7420 6d6f 6475 6c65 732e 0a0a iboot modules... │ │ │ │ │ -00004660: 2020 2028 3229 204f 6e6c 7920 4352 4333 (2) Only CRC3 │ │ │ │ │ -00004670: 3220 6461 7461 2069 6e74 6567 7269 7479 2 data integrity │ │ │ │ │ -00004680: 2063 6865 636b 2069 7320 7375 7070 6f72 check is suppor │ │ │ │ │ -00004690: 7465 6420 2878 7a20 6465 6661 756c 7420 ted (xz default │ │ │ │ │ -000046a0: 6973 2043 5243 3634 0a73 6f20 6f6e 6520 is CRC64.so one │ │ │ │ │ -000046b0: 7368 6f75 6c64 2075 7365 202d 6368 6563 should use -chec │ │ │ │ │ -000046c0: 6b3d 6372 6333 3220 6f70 7469 6f6e 292e k=crc32 option). │ │ │ │ │ -000046d0: 2020 4c5a 4d41 2042 434a 2066 696c 7465 LZMA BCJ filte │ │ │ │ │ -000046e0: 7273 2061 7265 2073 7570 706f 7274 6564 rs are supported │ │ │ │ │ -000046f0: 2e0a 0a20 2020 2833 2920 5468 6572 6520 ... (3) There │ │ │ │ │ -00004700: 6172 6520 6120 6665 7720 7061 7468 6f6c are a few pathol │ │ │ │ │ -00004710: 6f67 6963 616c 2063 6173 6573 2077 6865 ogical cases whe │ │ │ │ │ -00004720: 7265 206c 6f61 6469 6e67 2061 2076 6572 re loading a ver │ │ │ │ │ -00004730: 7920 6261 646c 790a 6f72 6761 6e69 7a65 y badly.organize │ │ │ │ │ -00004740: 6420 454c 4620 6b65 726e 656c 206d 6967 d ELF kernel mig │ │ │ │ │ -00004750: 6874 2074 616b 6520 6c6f 6e67 6572 2c20 ht take longer, │ │ │ │ │ -00004760: 6275 7420 696e 2070 7261 6374 6963 6520 but in practice │ │ │ │ │ -00004770: 7468 6973 206e 6576 6572 0a68 6170 7065 this never.happe │ │ │ │ │ -00004780: 6e2e 0a0a 1f0a 4669 6c65 3a20 6772 7562 n.....File: grub │ │ │ │ │ -00004790: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 526f .info, Node: Ro │ │ │ │ │ -000047a0: 6c65 206f 6620 6120 626f 6f74 206c 6f61 le of a boot loa │ │ │ │ │ -000047b0: 6465 722c 2020 5072 6576 3a20 4665 6174 der, Prev: Feat │ │ │ │ │ -000047c0: 7572 6573 2c20 2055 703a 2049 6e74 726f ures, Up: Intro │ │ │ │ │ -000047d0: 6475 6374 696f 6e0a 0a31 2e35 2054 6865 duction..1.5 The │ │ │ │ │ -000047e0: 2072 6f6c 6520 6f66 2061 2062 6f6f 7420 role of a boot │ │ │ │ │ -000047f0: 6c6f 6164 6572 0a3d 3d3d 3d3d 3d3d 3d3d loader.========= │ │ │ │ │ +000023a0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a ===============. │ │ │ │ │ +000023b0: 0a47 5255 4220 3220 6973 2061 2072 6577 .GRUB 2 is a rew │ │ │ │ │ +000023c0: 7269 7465 206f 6620 4752 5542 2028 2a6e rite of GRUB (*n │ │ │ │ │ +000023d0: 6f74 6520 4869 7374 6f72 793a 3a29 2c20 ote History::), │ │ │ │ │ +000023e0: 616c 7468 6f75 6768 2069 7420 7368 6172 although it shar │ │ │ │ │ +000023f0: 6573 206d 616e 790a 6368 6172 6163 7465 es many.characte │ │ │ │ │ +00002400: 7269 7374 6963 7320 7769 7468 2074 6865 ristics with the │ │ │ │ │ +00002410: 2070 7265 7669 6f75 7320 7665 7273 696f previous versio │ │ │ │ │ +00002420: 6e2c 206e 6f77 206b 6e6f 776e 2061 7320 n, now known as │ │ │ │ │ +00002430: 4752 5542 204c 6567 6163 792e 0a55 7365 GRUB Legacy..Use │ │ │ │ │ +00002440: 7273 206f 6620 4752 5542 204c 6567 6163 rs of GRUB Legac │ │ │ │ │ +00002450: 7920 6d61 7920 6e65 6564 2073 6f6d 6520 y may need some │ │ │ │ │ +00002460: 6775 6964 616e 6365 2074 6f20 6669 6e64 guidance to find │ │ │ │ │ +00002470: 2074 6865 6972 2077 6179 2061 726f 756e their way aroun │ │ │ │ │ +00002480: 640a 7468 6973 206e 6577 2076 6572 7369 d.this new versi │ │ │ │ │ +00002490: 6f6e 2e0a 0a20 2020 2a20 5468 6520 636f on... * The co │ │ │ │ │ +000024a0: 6e66 6967 7572 6174 696f 6e20 6669 6c65 nfiguration file │ │ │ │ │ +000024b0: 2068 6173 2061 206e 6577 206e 616d 6520 has a new name │ │ │ │ │ +000024c0: 2827 6772 7562 2e63 6667 2720 7261 7468 ('grub.cfg' rath │ │ │ │ │ +000024d0: 6572 2074 6861 6e0a 2020 2020 2027 6d65 er than. 'me │ │ │ │ │ +000024e0: 6e75 2e6c 7374 2720 6f72 2027 6772 7562 nu.lst' or 'grub │ │ │ │ │ +000024f0: 2e63 6f6e 6627 292c 206e 6577 2073 796e .conf'), new syn │ │ │ │ │ +00002500: 7461 7820 282a 6e6f 7465 2043 6f6e 6669 tax (*note Confi │ │ │ │ │ +00002510: 6775 7261 7469 6f6e 3a3a 2920 616e 640a guration::) and. │ │ │ │ │ +00002520: 2020 2020 206d 616e 7920 6e65 7720 636f many new co │ │ │ │ │ +00002530: 6d6d 616e 6473 2028 2a6e 6f74 6520 436f mmands (*note Co │ │ │ │ │ +00002540: 6d6d 616e 6473 3a3a 292e 2020 436f 6e66 mmands::). Conf │ │ │ │ │ +00002550: 6967 7572 6174 696f 6e20 6361 6e6e 6f74 iguration cannot │ │ │ │ │ +00002560: 2062 650a 2020 2020 2063 6f70 6965 6420 be. copied │ │ │ │ │ +00002570: 6f76 6572 2064 6972 6563 746c 792c 2061 over directly, a │ │ │ │ │ +00002580: 6c74 686f 7567 6820 6d6f 7374 2047 5255 lthough most GRU │ │ │ │ │ +00002590: 4220 4c65 6761 6379 2075 7365 7273 2073 B Legacy users s │ │ │ │ │ +000025a0: 686f 756c 6420 6e6f 740a 2020 2020 2066 hould not. f │ │ │ │ │ +000025b0: 696e 6420 7468 6520 7379 6e74 6178 2074 ind the syntax t │ │ │ │ │ +000025c0: 6f6f 2073 7572 7072 6973 696e 672e 0a0a oo surprising... │ │ │ │ │ +000025d0: 2020 202a 2027 6772 7562 2e63 6667 2720 * 'grub.cfg' │ │ │ │ │ +000025e0: 6973 2074 7970 6963 616c 6c79 2061 7574 is typically aut │ │ │ │ │ +000025f0: 6f6d 6174 6963 616c 6c79 2067 656e 6572 omatically gener │ │ │ │ │ +00002600: 6174 6564 2062 7920 2767 7275 622d 6d6b ated by 'grub-mk │ │ │ │ │ +00002610: 636f 6e66 6967 270a 2020 2020 2028 2a6e config'. (*n │ │ │ │ │ +00002620: 6f74 6520 5369 6d70 6c65 2063 6f6e 6669 ote Simple confi │ │ │ │ │ +00002630: 6775 7261 7469 6f6e 3a3a 292e 2020 5468 guration::). Th │ │ │ │ │ +00002640: 6973 206d 616b 6573 2069 7420 6561 7369 is makes it easi │ │ │ │ │ +00002650: 6572 2074 6f20 6861 6e64 6c65 0a20 2020 er to handle. │ │ │ │ │ +00002660: 2020 7665 7273 696f 6e65 6420 6b65 726e versioned kern │ │ │ │ │ +00002670: 656c 2075 7067 7261 6465 732e 0a0a 2020 el upgrades... │ │ │ │ │ +00002680: 202a 2050 6172 7469 7469 6f6e 206e 756d * Partition num │ │ │ │ │ +00002690: 6265 7273 2069 6e20 4752 5542 2064 6576 bers in GRUB dev │ │ │ │ │ +000026a0: 6963 6520 6e61 6d65 7320 6e6f 7720 7374 ice names now st │ │ │ │ │ +000026b0: 6172 7420 6174 2031 2c20 6e6f 7420 3020 art at 1, not 0 │ │ │ │ │ +000026c0: 282a 6e6f 7465 0a20 2020 2020 4e61 6d69 (*note. Nami │ │ │ │ │ +000026d0: 6e67 2063 6f6e 7665 6e74 696f 6e3a 3a29 ng convention::) │ │ │ │ │ +000026e0: 2e0a 0a20 2020 2a20 5468 6520 636f 6e66 ... * The conf │ │ │ │ │ +000026f0: 6967 7572 6174 696f 6e20 6669 6c65 2069 iguration file i │ │ │ │ │ +00002700: 7320 6e6f 7720 7772 6974 7465 6e20 696e s now written in │ │ │ │ │ +00002710: 2073 6f6d 6574 6869 6e67 2063 6c6f 7365 something close │ │ │ │ │ +00002720: 7220 746f 2061 2066 756c 6c0a 2020 2020 r to a full. │ │ │ │ │ +00002730: 2073 6372 6970 7469 6e67 206c 616e 6775 scripting langu │ │ │ │ │ +00002740: 6167 653a 2076 6172 6961 626c 6573 2c20 age: variables, │ │ │ │ │ +00002750: 636f 6e64 6974 696f 6e61 6c73 2c20 616e conditionals, an │ │ │ │ │ +00002760: 6420 6c6f 6f70 7320 6172 650a 2020 2020 d loops are. │ │ │ │ │ +00002770: 2061 7661 696c 6162 6c65 2e0a 0a20 2020 available... │ │ │ │ │ +00002780: 2a20 4120 736d 616c 6c20 616d 6f75 6e74 * A small amount │ │ │ │ │ +00002790: 206f 6620 7065 7273 6973 7465 6e74 2073 of persistent s │ │ │ │ │ +000027a0: 746f 7261 6765 2069 7320 6176 6169 6c61 torage is availa │ │ │ │ │ +000027b0: 626c 6520 6163 726f 7373 2072 6562 6f6f ble across reboo │ │ │ │ │ +000027c0: 7473 2c0a 2020 2020 2075 7369 6e67 2074 ts,. using t │ │ │ │ │ +000027d0: 6865 2027 7361 7665 5f65 6e76 2720 616e he 'save_env' an │ │ │ │ │ +000027e0: 6420 276c 6f61 645f 656e 7627 2063 6f6d d 'load_env' com │ │ │ │ │ +000027f0: 6d61 6e64 7320 696e 2047 5255 4220 616e mands in GRUB an │ │ │ │ │ +00002800: 6420 7468 650a 2020 2020 2027 6772 7562 d the. 'grub │ │ │ │ │ +00002810: 2d65 6469 7465 6e76 2720 7574 696c 6974 -editenv' utilit │ │ │ │ │ +00002820: 792e 2020 5468 6973 2069 7320 6e6f 7420 y. This is not │ │ │ │ │ +00002830: 6176 6169 6c61 626c 6520 696e 2061 6c6c available in all │ │ │ │ │ +00002840: 0a20 2020 2020 636f 6e66 6967 7572 6174 . configurat │ │ │ │ │ +00002850: 696f 6e73 2028 2a6e 6f74 6520 456e 7669 ions (*note Envi │ │ │ │ │ +00002860: 726f 6e6d 656e 7420 626c 6f63 6b3a 3a29 ronment block::) │ │ │ │ │ +00002870: 2e0a 0a20 2020 2a20 4752 5542 2032 2068 ... * GRUB 2 h │ │ │ │ │ +00002880: 6173 206d 6f72 6520 7265 6c69 6162 6c65 as more reliable │ │ │ │ │ +00002890: 2077 6179 7320 746f 2066 696e 6420 6974 ways to find it │ │ │ │ │ +000028a0: 7320 6f77 6e20 6669 6c65 7320 616e 6420 s own files and │ │ │ │ │ +000028b0: 7468 6f73 6520 6f66 0a20 2020 2020 7461 those of. ta │ │ │ │ │ +000028c0: 7267 6574 206b 6572 6e65 6c73 206f 6e20 rget kernels on │ │ │ │ │ +000028d0: 6d75 6c74 6970 6c65 2d64 6973 6b20 7379 multiple-disk sy │ │ │ │ │ +000028e0: 7374 656d 732c 2061 6e64 2068 6173 2063 stems, and has c │ │ │ │ │ +000028f0: 6f6d 6d61 6e64 7320 282a 6e6f 7465 0a20 ommands (*note. │ │ │ │ │ +00002900: 2020 2020 7365 6172 6368 3a3a 2920 746f search::) to │ │ │ │ │ +00002910: 2066 696e 6420 6465 7669 6365 7320 7573 find devices us │ │ │ │ │ +00002920: 696e 6720 6669 6c65 2073 7973 7465 6d20 ing file system │ │ │ │ │ +00002930: 6c61 6265 6c73 206f 7220 556e 6976 6572 labels or Univer │ │ │ │ │ +00002940: 7361 6c6c 790a 2020 2020 2055 6e69 7175 sally. Uniqu │ │ │ │ │ +00002950: 6520 4964 656e 7469 6669 6572 7320 2855 e Identifiers (U │ │ │ │ │ +00002960: 5549 4473 292e 0a0a 2020 202a 2047 5255 UIDs)... * GRU │ │ │ │ │ +00002970: 4220 3220 6973 2061 7661 696c 6162 6c65 B 2 is available │ │ │ │ │ +00002980: 2066 6f72 2073 6576 6572 616c 206f 7468 for several oth │ │ │ │ │ +00002990: 6572 2074 7970 6573 206f 6620 7379 7374 er types of syst │ │ │ │ │ +000029a0: 656d 2069 6e20 6164 6469 7469 6f6e 0a20 em in addition. │ │ │ │ │ +000029b0: 2020 2020 746f 2074 6865 2050 4320 4249 to the PC BI │ │ │ │ │ +000029c0: 4f53 2073 7973 7465 6d73 2073 7570 706f OS systems suppo │ │ │ │ │ +000029d0: 7274 6564 2062 7920 4752 5542 204c 6567 rted by GRUB Leg │ │ │ │ │ +000029e0: 6163 793a 2050 4320 4546 492c 2050 430a acy: PC EFI, PC. │ │ │ │ │ +000029f0: 2020 2020 2063 6f72 6562 6f6f 742c 2050 coreboot, P │ │ │ │ │ +00002a00: 6f77 6572 5043 2c20 5350 4152 432c 2061 owerPC, SPARC, a │ │ │ │ │ +00002a10: 6e64 204d 4950 5320 4c65 6d6f 7465 2059 nd MIPS Lemote Y │ │ │ │ │ +00002a20: 6565 6c6f 6f6e 6720 6172 6520 616c 6c0a eeloong are all. │ │ │ │ │ +00002a30: 2020 2020 2073 7570 706f 7274 6564 2e0a supported.. │ │ │ │ │ +00002a40: 0a20 2020 2a20 4d61 6e79 206d 6f72 6520 . * Many more │ │ │ │ │ +00002a50: 6669 6c65 2073 7973 7465 6d73 2061 7265 file systems are │ │ │ │ │ +00002a60: 2073 7570 706f 7274 6564 2c20 696e 636c supported, incl │ │ │ │ │ +00002a70: 7564 696e 6720 6275 7420 6e6f 7420 6c69 uding but not li │ │ │ │ │ +00002a80: 6d69 7465 6420 746f 0a20 2020 2020 6578 mited to. ex │ │ │ │ │ +00002a90: 7434 2c20 4846 532b 2c20 616e 6420 4e54 t4, HFS+, and NT │ │ │ │ │ +00002aa0: 4653 2e0a 0a20 2020 2a20 4752 5542 2032 FS... * GRUB 2 │ │ │ │ │ +00002ab0: 2063 616e 2072 6561 6420 6669 6c65 7320 can read files │ │ │ │ │ +00002ac0: 6469 7265 6374 6c79 2066 726f 6d20 4c56 directly from LV │ │ │ │ │ +00002ad0: 4d20 616e 6420 5241 4944 2064 6576 6963 M and RAID devic │ │ │ │ │ +00002ae0: 6573 2e0a 0a20 2020 2a20 4120 6772 6170 es... * A grap │ │ │ │ │ +00002af0: 6869 6361 6c20 7465 726d 696e 616c 2061 hical terminal a │ │ │ │ │ +00002b00: 6e64 2061 2067 7261 7068 6963 616c 206d nd a graphical m │ │ │ │ │ +00002b10: 656e 7520 7379 7374 656d 2061 7265 2061 enu system are a │ │ │ │ │ +00002b20: 7661 696c 6162 6c65 2e0a 0a20 2020 2a20 vailable... * │ │ │ │ │ +00002b30: 4752 5542 2032 2773 2069 6e74 6572 6661 GRUB 2's interfa │ │ │ │ │ +00002b40: 6365 2063 616e 2062 6520 7472 616e 736c ce can be transl │ │ │ │ │ +00002b50: 6174 6564 2c20 696e 636c 7564 696e 6720 ated, including │ │ │ │ │ +00002b60: 6d65 6e75 2065 6e74 7279 206e 616d 6573 menu entry names │ │ │ │ │ +00002b70: 2e0a 0a20 2020 2a20 5468 6520 696d 6167 ... * The imag │ │ │ │ │ +00002b80: 6520 6669 6c65 7320 282a 6e6f 7465 2049 e files (*note I │ │ │ │ │ +00002b90: 6d61 6765 733a 3a29 2074 6861 7420 6d61 mages::) that ma │ │ │ │ │ +00002ba0: 6b65 2075 7020 4752 5542 2068 6176 6520 ke up GRUB have │ │ │ │ │ +00002bb0: 6265 656e 0a20 2020 2020 7265 6f72 6761 been. reorga │ │ │ │ │ +00002bc0: 6e69 7365 643b 2053 7461 6765 2031 2c20 nised; Stage 1, │ │ │ │ │ +00002bd0: 5374 6167 6520 312e 352c 2061 6e64 2053 Stage 1.5, and S │ │ │ │ │ +00002be0: 7461 6765 2032 2061 7265 206e 6f20 6d6f tage 2 are no mo │ │ │ │ │ +00002bf0: 7265 2e0a 0a20 2020 2a20 4752 5542 2032 re... * GRUB 2 │ │ │ │ │ +00002c00: 2070 7574 7320 6d61 6e79 2066 6163 696c puts many facil │ │ │ │ │ +00002c10: 6974 6965 7320 696e 2064 796e 616d 6963 ities in dynamic │ │ │ │ │ +00002c20: 616c 6c79 206c 6f61 6465 6420 6d6f 6475 ally loaded modu │ │ │ │ │ +00002c30: 6c65 732c 2061 6c6c 6f77 696e 670a 2020 les, allowing. │ │ │ │ │ +00002c40: 2020 2074 6865 2063 6f72 6520 696d 6167 the core imag │ │ │ │ │ +00002c50: 6520 746f 2062 6520 736d 616c 6c65 722c e to be smaller, │ │ │ │ │ +00002c60: 2061 6e64 2061 6c6c 6f77 696e 6720 7468 and allowing th │ │ │ │ │ +00002c70: 6520 636f 7265 2069 6d61 6765 2074 6f20 e core image to │ │ │ │ │ +00002c80: 6265 0a20 2020 2020 6275 696c 7420 696e be. built in │ │ │ │ │ +00002c90: 206d 6f72 6520 666c 6578 6962 6c65 2077 more flexible w │ │ │ │ │ +00002ca0: 6179 732e 0a0a 1f0a 4669 6c65 3a20 6772 ays.....File: gr │ │ │ │ │ +00002cb0: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ +00002cc0: 4665 6174 7572 6573 2c20 204e 6578 743a Features, Next: │ │ │ │ │ +00002cd0: 2052 6f6c 6520 6f66 2061 2062 6f6f 7420 Role of a boot │ │ │ │ │ +00002ce0: 6c6f 6164 6572 2c20 2050 7265 763a 2043 loader, Prev: C │ │ │ │ │ +00002cf0: 6861 6e67 6573 2066 726f 6d20 4752 5542 hanges from GRUB │ │ │ │ │ +00002d00: 204c 6567 6163 792c 2020 5570 3a20 496e Legacy, Up: In │ │ │ │ │ +00002d10: 7472 6f64 7563 7469 6f6e 0a0a 312e 3420 troduction..1.4 │ │ │ │ │ +00002d20: 4752 5542 2066 6561 7475 7265 730a 3d3d GRUB features.== │ │ │ │ │ +00002d30: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a ===============. │ │ │ │ │ +00002d40: 0a54 6865 2070 7269 6d61 7279 2072 6571 .The primary req │ │ │ │ │ +00002d50: 7569 7265 6d65 6e74 2066 6f72 2047 5255 uirement for GRU │ │ │ │ │ +00002d60: 4220 6973 2074 6861 7420 6974 2062 6520 B is that it be │ │ │ │ │ +00002d70: 636f 6d70 6c69 616e 7420 7769 7468 2074 compliant with t │ │ │ │ │ +00002d80: 6865 0a22 4d75 6c74 6962 6f6f 7420 5370 he."Multiboot Sp │ │ │ │ │ +00002d90: 6563 6966 6963 6174 696f 6e22 2c20 7768 ecification", wh │ │ │ │ │ +00002da0: 6963 6820 6973 2064 6573 6372 6962 6564 ich is described │ │ │ │ │ +00002db0: 2069 6e20 2a6e 6f74 6520 4d75 6c74 6962 in *note Multib │ │ │ │ │ +00002dc0: 6f6f 740a 5370 6563 6966 6963 6174 696f oot.Specificatio │ │ │ │ │ +00002dd0: 6e3a 2028 6d75 6c74 6962 6f6f 7429 546f n: (multiboot)To │ │ │ │ │ +00002de0: 702e 0a0a 2020 2054 6865 206f 7468 6572 p... The other │ │ │ │ │ +00002df0: 2067 6f61 6c73 2c20 6c69 7374 6564 2069 goals, listed i │ │ │ │ │ +00002e00: 6e20 6170 7072 6f78 696d 6174 6520 6f72 n approximate or │ │ │ │ │ +00002e10: 6465 7220 6f66 2069 6d70 6f72 7461 6e63 der of importanc │ │ │ │ │ +00002e20: 652c 2061 7265 3a0a 0a20 2020 2a20 4261 e, are:.. * Ba │ │ │ │ │ +00002e30: 7369 6320 6675 6e63 7469 6f6e 7320 6d75 sic functions mu │ │ │ │ │ +00002e40: 7374 2062 6520 7374 7261 6967 6874 666f st be straightfo │ │ │ │ │ +00002e50: 7277 6172 6420 666f 7220 656e 642d 7573 rward for end-us │ │ │ │ │ +00002e60: 6572 732e 0a0a 2020 202a 2052 6963 6820 ers... * Rich │ │ │ │ │ +00002e70: 6675 6e63 7469 6f6e 616c 6974 7920 746f functionality to │ │ │ │ │ +00002e80: 2073 7570 706f 7274 206b 6572 6e65 6c20 support kernel │ │ │ │ │ +00002e90: 6578 7065 7274 7320 616e 6420 6465 7369 experts and desi │ │ │ │ │ +00002ea0: 676e 6572 732e 0a0a 2020 202a 2042 6163 gners... * Bac │ │ │ │ │ +00002eb0: 6b77 6172 6420 636f 6d70 6174 6962 696c kward compatibil │ │ │ │ │ +00002ec0: 6974 7920 666f 7220 626f 6f74 696e 6720 ity for booting │ │ │ │ │ +00002ed0: 4672 6565 4253 442c 204e 6574 4253 442c FreeBSD, NetBSD, │ │ │ │ │ +00002ee0: 204f 7065 6e42 5344 2c20 616e 640a 2020 OpenBSD, and. │ │ │ │ │ +00002ef0: 2020 204c 696e 7578 2e20 2050 726f 7072 Linux. Propr │ │ │ │ │ +00002f00: 6965 7461 7279 206b 6572 6e65 6c73 2028 ietary kernels ( │ │ │ │ │ +00002f10: 7375 6368 2061 7320 444f 532c 2057 696e such as DOS, Win │ │ │ │ │ +00002f20: 646f 7773 204e 542c 2061 6e64 204f 532f dows NT, and OS/ │ │ │ │ │ +00002f30: 3229 2061 7265 0a20 2020 2020 7375 7070 2) are. supp │ │ │ │ │ +00002f40: 6f72 7465 6420 7669 6120 6120 6368 6169 orted via a chai │ │ │ │ │ +00002f50: 6e2d 6c6f 6164 696e 6720 6675 6e63 7469 n-loading functi │ │ │ │ │ +00002f60: 6f6e 2e0a 0a20 2020 4578 6365 7074 2066 on... Except f │ │ │ │ │ +00002f70: 6f72 2073 7065 6369 6669 6320 636f 6d70 or specific comp │ │ │ │ │ +00002f80: 6174 6962 696c 6974 7920 6d6f 6465 7320 atibility modes │ │ │ │ │ +00002f90: 2863 6861 696e 2d6c 6f61 6469 6e67 2061 (chain-loading a │ │ │ │ │ +00002fa0: 6e64 2074 6865 204c 696e 7578 0a22 7069 nd the Linux."pi │ │ │ │ │ +00002fb0: 6767 7962 6163 6b22 2066 6f72 6d61 7429 ggyback" format) │ │ │ │ │ +00002fc0: 2c20 616c 6c20 6b65 726e 656c 7320 7769 , all kernels wi │ │ │ │ │ +00002fd0: 6c6c 2062 6520 7374 6172 7465 6420 696e ll be started in │ │ │ │ │ +00002fe0: 206d 7563 6820 7468 6520 7361 6d65 2073 much the same s │ │ │ │ │ +00002ff0: 7461 7465 0a61 7320 696e 2074 6865 204d tate.as in the M │ │ │ │ │ +00003000: 756c 7469 626f 6f74 2053 7065 6369 6669 ultiboot Specifi │ │ │ │ │ +00003010: 6361 7469 6f6e 2e20 204f 6e6c 7920 6b65 cation. Only ke │ │ │ │ │ +00003020: 726e 656c 7320 6c6f 6164 6564 2061 7420 rnels loaded at │ │ │ │ │ +00003030: 3120 6d65 6761 6279 7465 206f 720a 6162 1 megabyte or.ab │ │ │ │ │ +00003040: 6f76 6520 6172 6520 7072 6573 656e 746c ove are presentl │ │ │ │ │ +00003050: 7920 7375 7070 6f72 7465 642e 2020 416e y supported. An │ │ │ │ │ +00003060: 7920 6174 7465 6d70 7420 746f 206c 6f61 y attempt to loa │ │ │ │ │ +00003070: 6420 6265 6c6f 7720 7468 6174 2062 6f75 d below that bou │ │ │ │ │ +00003080: 6e64 6172 790a 7769 6c6c 2073 696d 706c ndary.will simpl │ │ │ │ │ +00003090: 7920 7265 7375 6c74 2069 6e20 696d 6d65 y result in imme │ │ │ │ │ +000030a0: 6469 6174 6520 6661 696c 7572 6520 616e diate failure an │ │ │ │ │ +000030b0: 6420 616e 2065 7272 6f72 206d 6573 7361 d an error messa │ │ │ │ │ +000030c0: 6765 2072 6570 6f72 7469 6e67 0a74 6865 ge reporting.the │ │ │ │ │ +000030d0: 2070 726f 626c 656d 2e0a 0a20 2020 496e problem... In │ │ │ │ │ +000030e0: 2061 6464 6974 696f 6e20 746f 2074 6865 addition to the │ │ │ │ │ +000030f0: 2072 6571 7569 7265 6d65 6e74 7320 6162 requirements ab │ │ │ │ │ +00003100: 6f76 652c 2047 5255 4220 6861 7320 7468 ove, GRUB has th │ │ │ │ │ +00003110: 6520 666f 6c6c 6f77 696e 670a 6665 6174 e following.feat │ │ │ │ │ +00003120: 7572 6573 2028 6e6f 7465 2074 6861 7420 ures (note that │ │ │ │ │ +00003130: 7468 6520 4d75 6c74 6962 6f6f 7420 5370 the Multiboot Sp │ │ │ │ │ +00003140: 6563 6966 6963 6174 696f 6e20 646f 6573 ecification does │ │ │ │ │ +00003150: 6e27 7420 7265 7175 6972 6520 616c 6c20 n't require all │ │ │ │ │ +00003160: 7468 650a 6665 6174 7572 6573 2074 6861 the.features tha │ │ │ │ │ +00003170: 7420 4752 5542 2073 7570 706f 7274 7329 t GRUB supports) │ │ │ │ │ +00003180: 3a0a 0a52 6563 6f67 6e69 7a65 206d 756c :..Recognize mul │ │ │ │ │ +00003190: 7469 706c 6520 6578 6563 7574 6162 6c65 tiple executable │ │ │ │ │ +000031a0: 2066 6f72 6d61 7473 0a20 2020 2020 5375 formats. Su │ │ │ │ │ +000031b0: 7070 6f72 7420 6d61 6e79 206f 6620 7468 pport many of th │ │ │ │ │ +000031c0: 6520 2261 2e6f 7574 2220 7661 7269 616e e "a.out" varian │ │ │ │ │ +000031d0: 7473 2070 6c75 7320 2245 4c46 222e 2053 ts plus "ELF". S │ │ │ │ │ +000031e0: 796d 626f 6c20 7461 626c 6573 2061 7265 ymbol tables are │ │ │ │ │ +000031f0: 0a20 2020 2020 616c 736f 206c 6f61 6465 . also loade │ │ │ │ │ +00003200: 642e 0a0a 5375 7070 6f72 7420 6e6f 6e2d d...Support non- │ │ │ │ │ +00003210: 4d75 6c74 6962 6f6f 7420 6b65 726e 656c Multiboot kernel │ │ │ │ │ +00003220: 730a 2020 2020 2053 7570 706f 7274 206d s. Support m │ │ │ │ │ +00003230: 616e 7920 6f66 2074 6865 2076 6172 696f any of the vario │ │ │ │ │ +00003240: 7573 2066 7265 6520 3332 2d62 6974 206b us free 32-bit k │ │ │ │ │ +00003250: 6572 6e65 6c73 2074 6861 7420 6c61 636b ernels that lack │ │ │ │ │ +00003260: 204d 756c 7469 626f 6f74 0a20 2020 2020 Multiboot. │ │ │ │ │ +00003270: 636f 6d70 6c69 616e 6365 2028 7072 696d compliance (prim │ │ │ │ │ +00003280: 6172 696c 7920 4672 6565 4253 442c 204e arily FreeBSD, N │ │ │ │ │ +00003290: 6574 4253 4428 3129 2028 2a6e 6f74 650a etBSD(1) (*note. │ │ │ │ │ +000032a0: 2020 2020 2046 6561 7475 7265 732d 466f Features-Fo │ │ │ │ │ +000032b0: 6f74 6e6f 7465 2d31 3a3a 292c 204f 7065 otnote-1::), Ope │ │ │ │ │ +000032c0: 6e42 5344 2c20 616e 6420 4c69 6e75 7829 nBSD, and Linux) │ │ │ │ │ +000032d0: 2e20 2043 6861 696e 2d6c 6f61 6469 6e67 . Chain-loading │ │ │ │ │ +000032e0: 206f 660a 2020 2020 206f 7468 6572 2062 of. other b │ │ │ │ │ +000032f0: 6f6f 7420 6c6f 6164 6572 7320 6973 2061 oot loaders is a │ │ │ │ │ +00003300: 6c73 6f20 7375 7070 6f72 7465 642e 0a0a lso supported... │ │ │ │ │ +00003310: 4c6f 6164 206d 756c 7469 706c 6573 206d Load multiples m │ │ │ │ │ +00003320: 6f64 756c 6573 0a20 2020 2020 4675 6c6c odules. Full │ │ │ │ │ +00003330: 7920 7375 7070 6f72 7420 7468 6520 4d75 y support the Mu │ │ │ │ │ +00003340: 6c74 6962 6f6f 7420 6665 6174 7572 6520 ltiboot feature │ │ │ │ │ +00003350: 6f66 206c 6f61 6469 6e67 206d 756c 7469 of loading multi │ │ │ │ │ +00003360: 706c 6520 6d6f 6475 6c65 732e 0a0a 4c6f ple modules...Lo │ │ │ │ │ +00003370: 6164 2061 2063 6f6e 6669 6775 7261 7469 ad a configurati │ │ │ │ │ +00003380: 6f6e 2066 696c 650a 2020 2020 2053 7570 on file. Sup │ │ │ │ │ +00003390: 706f 7274 2061 2068 756d 616e 2d72 6561 port a human-rea │ │ │ │ │ +000033a0: 6461 626c 6520 7465 7874 2063 6f6e 6669 dable text confi │ │ │ │ │ +000033b0: 6775 7261 7469 6f6e 2066 696c 6520 7769 guration file wi │ │ │ │ │ +000033c0: 7468 2070 7265 7365 7420 626f 6f74 0a20 th preset boot. │ │ │ │ │ +000033d0: 2020 2020 636f 6d6d 616e 6473 2e20 2059 commands. Y │ │ │ │ │ +000033e0: 6f75 2063 616e 2061 6c73 6f20 6c6f 6164 ou can also load │ │ │ │ │ +000033f0: 2061 6e6f 7468 6572 2063 6f6e 6669 6775 another configu │ │ │ │ │ +00003400: 7261 7469 6f6e 2066 696c 6520 6479 6e61 ration file dyna │ │ │ │ │ +00003410: 6d69 6361 6c6c 790a 2020 2020 2061 6e64 mically. and │ │ │ │ │ +00003420: 2065 6d62 6564 2061 2070 7265 7365 7420 embed a preset │ │ │ │ │ +00003430: 636f 6e66 6967 7572 6174 696f 6e20 6669 configuration fi │ │ │ │ │ +00003440: 6c65 2069 6e20 6120 4752 5542 2069 6d61 le in a GRUB ima │ │ │ │ │ +00003450: 6765 2066 696c 652e 2020 5468 650a 2020 ge file. The. │ │ │ │ │ +00003460: 2020 206c 6973 7420 6f66 2063 6f6d 6d61 list of comma │ │ │ │ │ +00003470: 6e64 7320 282a 6e6f 7465 2043 6f6d 6d61 nds (*note Comma │ │ │ │ │ +00003480: 6e64 733a 3a29 2061 7265 2061 2073 7570 nds::) are a sup │ │ │ │ │ +00003490: 6572 7365 7420 6f66 2074 686f 7365 0a20 erset of those. │ │ │ │ │ +000034a0: 2020 2020 7375 7070 6f72 7465 6420 6f6e supported on │ │ │ │ │ +000034b0: 2074 6865 2063 6f6d 6d61 6e64 2d6c 696e the command-lin │ │ │ │ │ +000034c0: 652e 2020 416e 2065 7861 6d70 6c65 2063 e. An example c │ │ │ │ │ +000034d0: 6f6e 6669 6775 7261 7469 6f6e 2066 696c onfiguration fil │ │ │ │ │ +000034e0: 6520 6973 0a20 2020 2020 7072 6f76 6964 e is. provid │ │ │ │ │ +000034f0: 6564 2069 6e20 2a6e 6f74 6520 436f 6e66 ed in *note Conf │ │ │ │ │ +00003500: 6967 7572 6174 696f 6e3a 3a2e 0a0a 5072 iguration::...Pr │ │ │ │ │ +00003510: 6f76 6964 6520 6120 6d65 6e75 2069 6e74 ovide a menu int │ │ │ │ │ +00003520: 6572 6661 6365 0a20 2020 2020 4120 6d65 erface. A me │ │ │ │ │ +00003530: 6e75 2069 6e74 6572 6661 6365 206c 6973 nu interface lis │ │ │ │ │ +00003540: 7469 6e67 2070 7265 7365 7420 626f 6f74 ting preset boot │ │ │ │ │ +00003550: 2063 6f6d 6d61 6e64 732c 2077 6974 6820 commands, with │ │ │ │ │ +00003560: 6120 7072 6f67 7261 6d6d 6162 6c65 0a20 a programmable. │ │ │ │ │ +00003570: 2020 2020 7469 6d65 6f75 742c 2069 7320 timeout, is │ │ │ │ │ +00003580: 6176 6169 6c61 626c 652e 2020 5468 6572 available. Ther │ │ │ │ │ +00003590: 6520 6973 206e 6f20 6669 7865 6420 6c69 e is no fixed li │ │ │ │ │ +000035a0: 6d69 7420 6f6e 2074 6865 206e 756d 6265 mit on the numbe │ │ │ │ │ +000035b0: 7220 6f66 0a20 2020 2020 626f 6f74 2065 r of. boot e │ │ │ │ │ +000035c0: 6e74 7269 6573 2c20 616e 6420 7468 6520 ntries, and the │ │ │ │ │ +000035d0: 6375 7272 656e 7420 696d 706c 656d 656e current implemen │ │ │ │ │ +000035e0: 7461 7469 6f6e 2068 6173 2073 7061 6365 tation has space │ │ │ │ │ +000035f0: 2066 6f72 2073 6576 6572 616c 0a20 2020 for several. │ │ │ │ │ +00003600: 2020 6875 6e64 7265 642e 0a0a 4861 7665 hundred...Have │ │ │ │ │ +00003610: 2061 2066 6c65 7869 626c 6520 636f 6d6d a flexible comm │ │ │ │ │ +00003620: 616e 642d 6c69 6e65 2069 6e74 6572 6661 and-line interfa │ │ │ │ │ +00003630: 6365 0a20 2020 2020 4120 6661 6972 6c79 ce. A fairly │ │ │ │ │ +00003640: 2066 6c65 7869 626c 6520 636f 6d6d 616e flexible comman │ │ │ │ │ +00003650: 642d 6c69 6e65 2069 6e74 6572 6661 6365 d-line interface │ │ │ │ │ +00003660: 2c20 6163 6365 7373 6962 6c65 2066 726f , accessible fro │ │ │ │ │ +00003670: 6d20 7468 6520 6d65 6e75 2c0a 2020 2020 m the menu,. │ │ │ │ │ +00003680: 2069 7320 6176 6169 6c61 626c 6520 746f is available to │ │ │ │ │ +00003690: 2065 6469 7420 616e 7920 7072 6573 6574 edit any preset │ │ │ │ │ +000036a0: 2063 6f6d 6d61 6e64 732c 206f 7220 7772 commands, or wr │ │ │ │ │ +000036b0: 6974 6520 6120 6e65 7720 626f 6f74 0a20 ite a new boot. │ │ │ │ │ +000036c0: 2020 2020 636f 6d6d 616e 6420 7365 7420 command set │ │ │ │ │ +000036d0: 6672 6f6d 2073 6372 6174 6368 2e20 2049 from scratch. I │ │ │ │ │ +000036e0: 6620 6e6f 2063 6f6e 6669 6775 7261 7469 f no configurati │ │ │ │ │ +000036f0: 6f6e 2066 696c 6520 6973 2070 7265 7365 on file is prese │ │ │ │ │ +00003700: 6e74 2c0a 2020 2020 2047 5255 4220 6472 nt,. GRUB dr │ │ │ │ │ +00003710: 6f70 7320 746f 2074 6865 2063 6f6d 6d61 ops to the comma │ │ │ │ │ +00003720: 6e64 2d6c 696e 652e 0a0a 2020 2020 2054 nd-line... T │ │ │ │ │ +00003730: 6865 206c 6973 7420 6f66 2063 6f6d 6d61 he list of comma │ │ │ │ │ +00003740: 6e64 7320 282a 6e6f 7465 2043 6f6d 6d61 nds (*note Comma │ │ │ │ │ +00003750: 6e64 733a 3a29 2061 7265 2061 2073 7562 nds::) are a sub │ │ │ │ │ +00003760: 7365 7420 6f66 2074 686f 7365 0a20 2020 set of those. │ │ │ │ │ +00003770: 2020 7375 7070 6f72 7465 6420 666f 7220 supported for │ │ │ │ │ +00003780: 636f 6e66 6967 7572 6174 696f 6e20 6669 configuration fi │ │ │ │ │ +00003790: 6c65 732e 2020 4564 6974 696e 6720 636f les. Editing co │ │ │ │ │ +000037a0: 6d6d 616e 6473 2063 6c6f 7365 6c79 0a20 mmands closely. │ │ │ │ │ +000037b0: 2020 2020 7265 7365 6d62 6c65 7320 7468 resembles th │ │ │ │ │ +000037c0: 6520 4261 7368 2063 6f6d 6d61 6e64 2d6c e Bash command-l │ │ │ │ │ +000037d0: 696e 6520 282a 6e6f 7465 2042 6173 683a ine (*note Bash: │ │ │ │ │ +000037e0: 2028 6665 6174 7572 6573 2943 6f6d 6d61 (features)Comma │ │ │ │ │ +000037f0: 6e64 204c 696e 650a 2020 2020 2045 6469 nd Line. Edi │ │ │ │ │ +00003800: 7469 6e67 2e29 2c20 7769 7468 203c 5441 ting.), with -completion of │ │ │ │ │ +00003820: 2063 6f6d 6d61 6e64 732c 2064 6576 6963 commands, devic │ │ │ │ │ +00003830: 6573 2c20 7061 7274 6974 696f 6e73 2c0a es, partitions,. │ │ │ │ │ +00003840: 2020 2020 2061 6e64 2066 696c 6573 2069 and files i │ │ │ │ │ +00003850: 6e20 6120 6469 7265 6374 6f72 7920 6465 n a directory de │ │ │ │ │ +00003860: 7065 6e64 696e 6720 6f6e 2063 6f6e 7465 pending on conte │ │ │ │ │ +00003870: 7874 2e0a 0a53 7570 706f 7274 206d 756c xt...Support mul │ │ │ │ │ +00003880: 7469 706c 6520 6669 6c65 7379 7374 656d tiple filesystem │ │ │ │ │ +00003890: 2074 7970 6573 0a20 2020 2020 5375 7070 types. Supp │ │ │ │ │ +000038a0: 6f72 7420 6d75 6c74 6970 6c65 2066 696c ort multiple fil │ │ │ │ │ +000038b0: 6573 7973 7465 6d20 7479 7065 7320 7472 esystem types tr │ │ │ │ │ +000038c0: 616e 7370 6172 656e 746c 792c 2070 6c75 ansparently, plu │ │ │ │ │ +000038d0: 7320 6120 7573 6566 756c 0a20 2020 2020 s a useful. │ │ │ │ │ +000038e0: 6578 706c 6963 6974 2062 6c6f 636b 6c69 explicit blockli │ │ │ │ │ +000038f0: 7374 206e 6f74 6174 696f 6e2e 2020 5468 st notation. Th │ │ │ │ │ +00003900: 6520 6375 7272 656e 746c 7920 7375 7070 e currently supp │ │ │ │ │ +00003910: 6f72 7465 6420 6669 6c65 7379 7374 656d orted filesystem │ │ │ │ │ +00003920: 0a20 2020 2020 7479 7065 7320 6172 6520 . types are │ │ │ │ │ +00003930: 2241 6d69 6761 2046 6173 7420 4669 6c65 "Amiga Fast File │ │ │ │ │ +00003940: 5379 7374 656d 2028 4146 4653 2922 2c20 System (AFFS)", │ │ │ │ │ +00003950: 2241 7468 654f 5320 6673 222c 2022 4265 "AtheOS fs", "Be │ │ │ │ │ +00003960: 4653 222c 0a20 2020 2020 2242 7472 4653 FS",. "BtrFS │ │ │ │ │ +00003970: 2220 2869 6e63 6c75 6469 6e67 2072 6169 " (including rai │ │ │ │ │ +00003980: 6430 2c20 7261 6964 312c 2072 6169 6431 d0, raid1, raid1 │ │ │ │ │ +00003990: 302c 2067 7a69 7020 616e 6420 6c7a 6f29 0, gzip and lzo) │ │ │ │ │ +000039a0: 2c20 2263 7069 6f22 0a20 2020 2020 286c , "cpio". (l │ │ │ │ │ +000039b0: 6974 746c 652d 2061 6e64 2062 6967 2d65 ittle- and big-e │ │ │ │ │ +000039c0: 6e64 6961 6e20 6269 6e2c 206f 6463 2061 ndian bin, odc a │ │ │ │ │ +000039d0: 6e64 206e 6577 6320 7661 7269 616e 7473 nd newc variants │ │ │ │ │ +000039e0: 292c 2022 4c69 6e75 780a 2020 2020 2065 ), "Linux. e │ │ │ │ │ +000039f0: 7874 322f 6578 7433 2f65 7874 3422 2c20 xt2/ext3/ext4", │ │ │ │ │ +00003a00: 2244 4f53 2046 4154 3132 2f46 4154 3136 "DOS FAT12/FAT16 │ │ │ │ │ +00003a10: 2f46 4154 3332 222c 2022 6578 4641 5422 /FAT32", "exFAT" │ │ │ │ │ +00003a20: 2c20 2246 3246 5322 2c20 2248 4653 222c , "F2FS", "HFS", │ │ │ │ │ +00003a30: 0a20 2020 2020 2248 4653 2b22 2c20 2249 . "HFS+", "I │ │ │ │ │ +00003a40: 534f 3936 3630 2220 2869 6e63 6c75 6469 SO9660" (includi │ │ │ │ │ +00003a50: 6e67 204a 6f6c 6965 742c 2052 6f63 6b2d ng Joliet, Rock- │ │ │ │ │ +00003a60: 7269 6467 6520 616e 6420 6d75 6c74 692d ridge and multi- │ │ │ │ │ +00003a70: 6368 756e 6b0a 2020 2020 2066 696c 6573 chunk. files │ │ │ │ │ +00003a80: 292c 2022 4a46 5322 2c20 224d 696e 6978 ), "JFS", "Minix │ │ │ │ │ +00003a90: 2066 7322 2028 7665 7273 696f 6e73 2031 fs" (versions 1 │ │ │ │ │ +00003aa0: 2c20 3220 616e 6420 3329 2c20 226e 696c , 2 and 3), "nil │ │ │ │ │ +00003ab0: 6673 3222 2c20 224e 5446 5322 0a20 2020 fs2", "NTFS". │ │ │ │ │ +00003ac0: 2020 2869 6e63 6c75 6469 6e67 2063 6f6d (including com │ │ │ │ │ +00003ad0: 7072 6573 7369 6f6e 292c 2022 5265 6973 pression), "Reis │ │ │ │ │ +00003ae0: 6572 4653 222c 2022 524f 4d46 5322 2c20 erFS", "ROMFS", │ │ │ │ │ +00003af0: 2241 6d69 6761 2053 6d61 7274 0a20 2020 "Amiga Smart. │ │ │ │ │ +00003b00: 2020 4669 6c65 5379 7374 656d 2028 5346 FileSystem (SF │ │ │ │ │ +00003b10: 5329 222c 2022 5371 7561 7368 3422 2c20 S)", "Squash4", │ │ │ │ │ +00003b20: 2274 6172 222c 2022 5544 4622 2c20 2242 "tar", "UDF", "B │ │ │ │ │ +00003b30: 5344 2055 4653 2f55 4653 3222 2c20 2258 SD UFS/UFS2", "X │ │ │ │ │ +00003b40: 4653 222c 0a20 2020 2020 616e 6420 225a FS",. and "Z │ │ │ │ │ +00003b50: 4653 2220 2869 6e63 6c75 6469 6e67 206c FS" (including l │ │ │ │ │ +00003b60: 7a6a 622c 2067 7a69 702c 207a 6c65 2c20 zjb, gzip, zle, │ │ │ │ │ +00003b70: 6d69 7272 6f72 2c20 7374 7269 7065 2c20 mirror, stripe, │ │ │ │ │ +00003b80: 7261 6964 7a31 2f32 2f33 0a20 2020 2020 raidz1/2/3. │ │ │ │ │ +00003b90: 616e 6420 656e 6372 7970 7469 6f6e 2069 and encryption i │ │ │ │ │ +00003ba0: 6e20 4145 532d 4343 4d20 616e 6420 4145 n AES-CCM and AE │ │ │ │ │ +00003bb0: 532d 4743 4d29 2e20 2a4e 6f74 6520 4669 S-GCM). *Note Fi │ │ │ │ │ +00003bc0: 6c65 7379 7374 656d 3a3a 2c20 666f 720a lesystem::, for. │ │ │ │ │ +00003bd0: 2020 2020 206d 6f72 6520 696e 666f 726d more inform │ │ │ │ │ +00003be0: 6174 696f 6e2e 0a0a 5375 7070 6f72 7420 ation...Support │ │ │ │ │ +00003bf0: 6175 746f 6d61 7469 6320 6465 636f 6d70 automatic decomp │ │ │ │ │ +00003c00: 7265 7373 696f 6e0a 2020 2020 2043 616e ression. Can │ │ │ │ │ +00003c10: 2064 6563 6f6d 7072 6573 7320 6669 6c65 decompress file │ │ │ │ │ +00003c20: 7320 7768 6963 6820 7765 7265 2063 6f6d s which were com │ │ │ │ │ +00003c30: 7072 6573 7365 6420 6279 2027 677a 6970 pressed by 'gzip │ │ │ │ │ +00003c40: 2720 6f72 2027 787a 2728 3229 0a20 2020 ' or 'xz'(2). │ │ │ │ │ +00003c50: 2020 282a 6e6f 7465 2046 6561 7475 7265 (*note Feature │ │ │ │ │ +00003c60: 732d 466f 6f74 6e6f 7465 2d32 3a3a 292e s-Footnote-2::). │ │ │ │ │ +00003c70: 2020 5468 6973 2066 756e 6374 696f 6e20 This function │ │ │ │ │ +00003c80: 6973 2062 6f74 6820 6175 746f 6d61 7469 is both automati │ │ │ │ │ +00003c90: 6320 616e 640a 2020 2020 2074 7261 6e73 c and. trans │ │ │ │ │ +00003ca0: 7061 7265 6e74 2074 6f20 7468 6520 7573 parent to the us │ │ │ │ │ +00003cb0: 6572 2028 692e 652e 2020 616c 6c20 6675 er (i.e. all fu │ │ │ │ │ +00003cc0: 6e63 7469 6f6e 7320 6f70 6572 6174 6520 nctions operate │ │ │ │ │ +00003cd0: 7570 6f6e 2074 6865 0a20 2020 2020 756e upon the. un │ │ │ │ │ +00003ce0: 636f 6d70 7265 7373 6564 2063 6f6e 7465 compressed conte │ │ │ │ │ +00003cf0: 6e74 7320 6f66 2074 6865 2073 7065 6369 nts of the speci │ │ │ │ │ +00003d00: 6669 6564 2066 696c 6573 292e 2020 5468 fied files). Th │ │ │ │ │ +00003d10: 6973 2067 7265 6174 6c79 0a20 2020 2020 is greatly. │ │ │ │ │ +00003d20: 7265 6475 6365 7320 6120 6669 6c65 2073 reduces a file s │ │ │ │ │ +00003d30: 697a 6520 616e 6420 6c6f 6164 696e 6720 ize and loading │ │ │ │ │ +00003d40: 7469 6d65 2c20 6120 7061 7274 6963 756c time, a particul │ │ │ │ │ +00003d50: 6172 6c79 2067 7265 6174 2062 656e 6566 arly great benef │ │ │ │ │ +00003d60: 6974 0a20 2020 2020 666f 7220 666c 6f70 it. for flop │ │ │ │ │ +00003d70: 7069 6573 2e28 3329 2020 282a 6e6f 7465 pies.(3) (*note │ │ │ │ │ +00003d80: 2046 6561 7475 7265 732d 466f 6f74 6e6f Features-Footno │ │ │ │ │ +00003d90: 7465 2d33 3a3a 290a 0a20 2020 2020 4974 te-3::).. It │ │ │ │ │ +00003da0: 2069 7320 636f 6e63 6569 7661 626c 6520 is conceivable │ │ │ │ │ +00003db0: 7468 6174 2073 6f6d 6520 6b65 726e 656c that some kernel │ │ │ │ │ +00003dc0: 206d 6f64 756c 6573 2073 686f 756c 6420 modules should │ │ │ │ │ +00003dd0: 6265 206c 6f61 6465 6420 696e 2061 0a20 be loaded in a. │ │ │ │ │ +00003de0: 2020 2020 636f 6d70 7265 7373 6564 2073 compressed s │ │ │ │ │ +00003df0: 7461 7465 2c20 736f 2061 2064 6966 6665 tate, so a diffe │ │ │ │ │ +00003e00: 7265 6e74 206d 6f64 756c 652d 6c6f 6164 rent module-load │ │ │ │ │ +00003e10: 696e 6720 636f 6d6d 616e 6420 6361 6e20 ing command can │ │ │ │ │ +00003e20: 6265 0a20 2020 2020 7370 6563 6966 6965 be. specifie │ │ │ │ │ +00003e30: 6420 746f 2061 766f 6964 2075 6e63 6f6d d to avoid uncom │ │ │ │ │ +00003e40: 7072 6573 7369 6e67 2074 6865 206d 6f64 pressing the mod │ │ │ │ │ +00003e50: 756c 6573 2e0a 0a41 6363 6573 7320 6461 ules...Access da │ │ │ │ │ +00003e60: 7461 206f 6e20 616e 7920 696e 7374 616c ta on any instal │ │ │ │ │ +00003e70: 6c65 6420 6465 7669 6365 0a20 2020 2020 led device. │ │ │ │ │ +00003e80: 5375 7070 6f72 7420 7265 6164 696e 6720 Support reading │ │ │ │ │ +00003e90: 6461 7461 2066 726f 6d20 616e 7920 6f72 data from any or │ │ │ │ │ +00003ea0: 2061 6c6c 2066 6c6f 7070 6965 7320 6f72 all floppies or │ │ │ │ │ +00003eb0: 2068 6172 6420 6469 736b 2873 290a 2020 hard disk(s). │ │ │ │ │ +00003ec0: 2020 2072 6563 6f67 6e69 7a65 6420 6279 recognized by │ │ │ │ │ +00003ed0: 2074 6865 2042 494f 532c 2069 6e64 6570 the BIOS, indep │ │ │ │ │ +00003ee0: 656e 6465 6e74 206f 6620 7468 6520 7365 endent of the se │ │ │ │ │ +00003ef0: 7474 696e 6720 6f66 2074 6865 2072 6f6f tting of the roo │ │ │ │ │ +00003f00: 740a 2020 2020 2064 6576 6963 652e 0a0a t. device... │ │ │ │ │ +00003f10: 4265 2069 6e64 6570 656e 6465 6e74 206f Be independent o │ │ │ │ │ +00003f20: 6620 6472 6976 6520 6765 6f6d 6574 7279 f drive geometry │ │ │ │ │ +00003f30: 2074 7261 6e73 6c61 7469 6f6e 730a 2020 translations. │ │ │ │ │ +00003f40: 2020 2055 6e6c 696b 6520 6d61 6e79 206f Unlike many o │ │ │ │ │ +00003f50: 7468 6572 2062 6f6f 7420 6c6f 6164 6572 ther boot loader │ │ │ │ │ +00003f60: 732c 2047 5255 4220 6d61 6b65 7320 7468 s, GRUB makes th │ │ │ │ │ +00003f70: 6520 7061 7274 6963 756c 6172 2064 7269 e particular dri │ │ │ │ │ +00003f80: 7665 0a20 2020 2020 7472 616e 736c 6174 ve. translat │ │ │ │ │ +00003f90: 696f 6e20 6972 7265 6c65 7661 6e74 2e20 ion irrelevant. │ │ │ │ │ +00003fa0: 2041 2064 7269 7665 2069 6e73 7461 6c6c A drive install │ │ │ │ │ +00003fb0: 6564 2061 6e64 2072 756e 6e69 6e67 2077 ed and running w │ │ │ │ │ +00003fc0: 6974 6820 6f6e 650a 2020 2020 2074 7261 ith one. tra │ │ │ │ │ +00003fd0: 6e73 6c61 7469 6f6e 206d 6179 2062 6520 nslation may be │ │ │ │ │ +00003fe0: 636f 6e76 6572 7465 6420 746f 2061 6e6f converted to ano │ │ │ │ │ +00003ff0: 7468 6572 2074 7261 6e73 6c61 7469 6f6e ther translation │ │ │ │ │ +00004000: 2077 6974 686f 7574 2061 6e79 0a20 2020 without any. │ │ │ │ │ +00004010: 2020 6164 7665 7273 6520 6566 6665 6374 adverse effect │ │ │ │ │ +00004020: 7320 6f72 2063 6861 6e67 6573 2069 6e20 s or changes in │ │ │ │ │ +00004030: 4752 5542 2773 2063 6f6e 6669 6775 7261 GRUB's configura │ │ │ │ │ +00004040: 7469 6f6e 2e0a 0a44 6574 6563 7420 616c tion...Detect al │ │ │ │ │ +00004050: 6c20 696e 7374 616c 6c65 6420 5241 4d0a l installed RAM. │ │ │ │ │ +00004060: 2020 2020 2047 5255 4220 6361 6e20 6765 GRUB can ge │ │ │ │ │ +00004070: 6e65 7261 6c6c 7920 6669 6e64 2061 6c6c nerally find all │ │ │ │ │ +00004080: 2074 6865 2069 6e73 7461 6c6c 6564 2052 the installed R │ │ │ │ │ +00004090: 414d 206f 6e20 6120 5043 2d63 6f6d 7061 AM on a PC-compa │ │ │ │ │ +000040a0: 7469 626c 650a 2020 2020 206d 6163 6869 tible. machi │ │ │ │ │ +000040b0: 6e65 2e20 2049 7420 7573 6573 2061 6e20 ne. It uses an │ │ │ │ │ +000040c0: 6164 7661 6e63 6564 2042 494f 5320 7175 advanced BIOS qu │ │ │ │ │ +000040d0: 6572 7920 7465 6368 6e69 7175 6520 666f ery technique fo │ │ │ │ │ +000040e0: 7220 6669 6e64 696e 6720 616c 6c0a 2020 r finding all. │ │ │ │ │ +000040f0: 2020 206d 656d 6f72 7920 7265 6769 6f6e memory region │ │ │ │ │ +00004100: 732e 2020 4173 2064 6573 6372 6962 6564 s. As described │ │ │ │ │ +00004110: 206f 6e20 7468 6520 4d75 6c74 6962 6f6f on the Multiboo │ │ │ │ │ +00004120: 7420 5370 6563 6966 6963 6174 696f 6e20 t Specification │ │ │ │ │ +00004130: 282a 6e6f 7465 0a20 2020 2020 4d75 6c74 (*note. Mult │ │ │ │ │ +00004140: 6962 6f6f 7420 5370 6563 6966 6963 6174 iboot Specificat │ │ │ │ │ +00004150: 696f 6e3a 2028 6d75 6c74 6962 6f6f 7429 ion: (multiboot) │ │ │ │ │ +00004160: 546f 702e 292c 206e 6f74 2061 6c6c 206b Top.), not all k │ │ │ │ │ +00004170: 6572 6e65 6c73 206d 616b 6520 7573 650a ernels make use. │ │ │ │ │ +00004180: 2020 2020 206f 6620 7468 6973 2069 6e66 of this inf │ │ │ │ │ +00004190: 6f72 6d61 7469 6f6e 2c20 6275 7420 4752 ormation, but GR │ │ │ │ │ +000041a0: 5542 2070 726f 7669 6465 7320 6974 2066 UB provides it f │ │ │ │ │ +000041b0: 6f72 2074 686f 7365 2077 686f 2064 6f2e or those who do. │ │ │ │ │ +000041c0: 0a0a 5375 7070 6f72 7420 4c6f 6769 6361 ..Support Logica │ │ │ │ │ +000041d0: 6c20 426c 6f63 6b20 4164 6472 6573 7320 l Block Address │ │ │ │ │ +000041e0: 6d6f 6465 0a20 2020 2020 496e 2074 7261 mode. In tra │ │ │ │ │ +000041f0: 6469 7469 6f6e 616c 2064 6973 6b20 6361 ditional disk ca │ │ │ │ │ +00004200: 6c6c 7320 2863 616c 6c65 6420 2243 4853 lls (called "CHS │ │ │ │ │ +00004210: 206d 6f64 6522 292c 2074 6865 7265 2069 mode"), there i │ │ │ │ │ +00004220: 7320 6120 6765 6f6d 6574 7279 0a20 2020 s a geometry. │ │ │ │ │ +00004230: 2020 7472 616e 736c 6174 696f 6e20 7072 translation pr │ │ │ │ │ +00004240: 6f62 6c65 6d2c 2074 6861 7420 6973 2c20 oblem, that is, │ │ │ │ │ +00004250: 7468 6520 4249 4f53 2063 616e 6e6f 7420 the BIOS cannot │ │ │ │ │ +00004260: 6163 6365 7373 206f 7665 7220 3130 3234 access over 1024 │ │ │ │ │ +00004270: 0a20 2020 2020 6379 6c69 6e64 6572 732c . cylinders, │ │ │ │ │ +00004280: 2073 6f20 7468 6520 6163 6365 7373 6962 so the accessib │ │ │ │ │ +00004290: 6c65 2073 7061 6365 2069 7320 6c69 6d69 le space is limi │ │ │ │ │ +000042a0: 7465 6420 746f 2061 7420 6c65 6173 7420 ted to at least │ │ │ │ │ +000042b0: 3530 3820 4d42 0a20 2020 2020 616e 6420 508 MB. and │ │ │ │ │ +000042c0: 746f 2061 7420 6d6f 7374 2038 4742 2e20 to at most 8GB. │ │ │ │ │ +000042d0: 4752 5542 2063 616e 2774 2075 6e69 7665 GRUB can't unive │ │ │ │ │ +000042e0: 7273 616c 6c79 2073 6f6c 7665 2074 6869 rsally solve thi │ │ │ │ │ +000042f0: 7320 7072 6f62 6c65 6d2c 2061 730a 2020 s problem, as. │ │ │ │ │ +00004300: 2020 2074 6865 7265 2069 7320 6e6f 2073 there is no s │ │ │ │ │ +00004310: 7461 6e64 6172 6420 696e 7465 7266 6163 tandard interfac │ │ │ │ │ +00004320: 6520 7573 6564 2069 6e20 616c 6c20 6d61 e used in all ma │ │ │ │ │ +00004330: 6368 696e 6573 2e20 2048 6f77 6576 6572 chines. However │ │ │ │ │ +00004340: 2c0a 2020 2020 2073 6576 6572 616c 206e ,. several n │ │ │ │ │ +00004350: 6577 6572 206d 6163 6869 6e65 7320 6861 ewer machines ha │ │ │ │ │ +00004360: 7665 2074 6865 206e 6577 2069 6e74 6572 ve the new inter │ │ │ │ │ +00004370: 6661 6365 2c20 4c6f 6769 6361 6c20 426c face, Logical Bl │ │ │ │ │ +00004380: 6f63 6b0a 2020 2020 2041 6464 7265 7373 ock. Address │ │ │ │ │ +00004390: 2028 224c 4241 2229 206d 6f64 652e 2020 ("LBA") mode. │ │ │ │ │ +000043a0: 4752 5542 2061 7574 6f6d 6174 6963 616c GRUB automatical │ │ │ │ │ +000043b0: 6c79 2064 6574 6563 7473 2069 6620 4c42 ly detects if LB │ │ │ │ │ +000043c0: 4120 6d6f 6465 2069 730a 2020 2020 2061 A mode is. a │ │ │ │ │ +000043d0: 7661 696c 6162 6c65 2061 6e64 2075 7365 vailable and use │ │ │ │ │ +000043e0: 7320 6974 2069 6620 6176 6169 6c61 626c s it if availabl │ │ │ │ │ +000043f0: 652e 2020 496e 204c 4241 206d 6f64 652c e. In LBA mode, │ │ │ │ │ +00004400: 2047 5255 4220 6361 6e20 6163 6365 7373 GRUB can access │ │ │ │ │ +00004410: 0a20 2020 2020 7468 6520 656e 7469 7265 . the entire │ │ │ │ │ +00004420: 2064 6973 6b2e 0a0a 5375 7070 6f72 7420 disk...Support │ │ │ │ │ +00004430: 6e65 7477 6f72 6b20 626f 6f74 696e 670a network booting. │ │ │ │ │ +00004440: 2020 2020 2047 5255 4220 6973 2062 6173 GRUB is bas │ │ │ │ │ +00004450: 6963 616c 6c79 2061 2064 6973 6b2d 6261 ically a disk-ba │ │ │ │ │ +00004460: 7365 6420 626f 6f74 206c 6f61 6465 7220 sed boot loader │ │ │ │ │ +00004470: 6275 7420 616c 736f 2068 6173 206e 6574 but also has net │ │ │ │ │ +00004480: 776f 726b 0a20 2020 2020 7375 7070 6f72 work. suppor │ │ │ │ │ +00004490: 742e 2020 596f 7520 6361 6e20 6c6f 6164 t. You can load │ │ │ │ │ +000044a0: 204f 5320 696d 6167 6573 2066 726f 6d20 OS images from │ │ │ │ │ +000044b0: 6120 6e65 7477 6f72 6b20 6279 2075 7369 a network by usi │ │ │ │ │ +000044c0: 6e67 2074 6865 2022 5446 5450 220a 2020 ng the "TFTP". │ │ │ │ │ +000044d0: 2020 2070 726f 746f 636f 6c2e 0a0a 5375 protocol...Su │ │ │ │ │ +000044e0: 7070 6f72 7420 7265 6d6f 7465 2074 6572 pport remote ter │ │ │ │ │ +000044f0: 6d69 6e61 6c73 0a20 2020 2020 546f 2073 minals. To s │ │ │ │ │ +00004500: 7570 706f 7274 2063 6f6d 7075 7465 7273 upport computers │ │ │ │ │ +00004510: 2077 6974 6820 6e6f 2063 6f6e 736f 6c65 with no console │ │ │ │ │ +00004520: 2c20 4752 5542 2070 726f 7669 6465 7320 , GRUB provides │ │ │ │ │ +00004530: 7265 6d6f 7465 2074 6572 6d69 6e61 6c0a remote terminal. │ │ │ │ │ +00004540: 2020 2020 2073 7570 706f 7274 2c20 736f support, so │ │ │ │ │ +00004550: 2074 6861 7420 796f 7520 6361 6e20 636f that you can co │ │ │ │ │ +00004560: 6e74 726f 6c20 4752 5542 2066 726f 6d20 ntrol GRUB from │ │ │ │ │ +00004570: 6120 7265 6d6f 7465 2068 6f73 742e 2020 a remote host. │ │ │ │ │ +00004580: 4f6e 6c79 0a20 2020 2020 7365 7269 616c Only. serial │ │ │ │ │ +00004590: 2074 6572 6d69 6e61 6c20 7375 7070 6f72 terminal suppor │ │ │ │ │ +000045a0: 7420 6973 2069 6d70 6c65 6d65 6e74 6564 t is implemented │ │ │ │ │ +000045b0: 2061 7420 7468 6520 6d6f 6d65 6e74 2e0a at the moment.. │ │ │ │ │ +000045c0: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ +000045d0: 666f 2c20 204e 6f64 653a 2046 6561 7475 fo, Node: Featu │ │ │ │ │ +000045e0: 7265 732d 466f 6f74 6e6f 7465 732c 2020 res-Footnotes, │ │ │ │ │ +000045f0: 5570 3a20 4665 6174 7572 6573 0a0a 2020 Up: Features.. │ │ │ │ │ +00004600: 2028 3129 2054 6865 204e 6574 4253 442f (1) The NetBSD/ │ │ │ │ │ +00004610: 6933 3836 206b 6572 6e65 6c20 6973 204d i386 kernel is M │ │ │ │ │ +00004620: 756c 7469 626f 6f74 2d63 6f6d 706c 6961 ultiboot-complia │ │ │ │ │ +00004630: 6e74 2c20 6275 7420 6c61 636b 7320 7375 nt, but lacks su │ │ │ │ │ +00004640: 7070 6f72 740a 666f 7220 4d75 6c74 6962 pport.for Multib │ │ │ │ │ +00004650: 6f6f 7420 6d6f 6475 6c65 732e 0a0a 2020 oot modules... │ │ │ │ │ +00004660: 2028 3229 204f 6e6c 7920 4352 4333 3220 (2) Only CRC32 │ │ │ │ │ +00004670: 6461 7461 2069 6e74 6567 7269 7479 2063 data integrity c │ │ │ │ │ +00004680: 6865 636b 2069 7320 7375 7070 6f72 7465 heck is supporte │ │ │ │ │ +00004690: 6420 2878 7a20 6465 6661 756c 7420 6973 d (xz default is │ │ │ │ │ +000046a0: 2043 5243 3634 0a73 6f20 6f6e 6520 7368 CRC64.so one sh │ │ │ │ │ +000046b0: 6f75 6c64 2075 7365 202d 6368 6563 6b3d ould use -check= │ │ │ │ │ +000046c0: 6372 6333 3220 6f70 7469 6f6e 292e 2020 crc32 option). │ │ │ │ │ +000046d0: 4c5a 4d41 2042 434a 2066 696c 7465 7273 LZMA BCJ filters │ │ │ │ │ +000046e0: 2061 7265 2073 7570 706f 7274 6564 2e0a are supported.. │ │ │ │ │ +000046f0: 0a20 2020 2833 2920 5468 6572 6520 6172 . (3) There ar │ │ │ │ │ +00004700: 6520 6120 6665 7720 7061 7468 6f6c 6f67 e a few patholog │ │ │ │ │ +00004710: 6963 616c 2063 6173 6573 2077 6865 7265 ical cases where │ │ │ │ │ +00004720: 206c 6f61 6469 6e67 2061 2076 6572 7920 loading a very │ │ │ │ │ +00004730: 6261 646c 790a 6f72 6761 6e69 7a65 6420 badly.organized │ │ │ │ │ +00004740: 454c 4620 6b65 726e 656c 206d 6967 6874 ELF kernel might │ │ │ │ │ +00004750: 2074 616b 6520 6c6f 6e67 6572 2c20 6275 take longer, bu │ │ │ │ │ +00004760: 7420 696e 2070 7261 6374 6963 6520 7468 t in practice th │ │ │ │ │ +00004770: 6973 206e 6576 6572 0a68 6170 7065 6e2e is never.happen. │ │ │ │ │ +00004780: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ +00004790: 6e66 6f2c 2020 4e6f 6465 3a20 526f 6c65 nfo, Node: Role │ │ │ │ │ +000047a0: 206f 6620 6120 626f 6f74 206c 6f61 6465 of a boot loade │ │ │ │ │ +000047b0: 722c 2020 5072 6576 3a20 4665 6174 7572 r, Prev: Featur │ │ │ │ │ +000047c0: 6573 2c20 2055 703a 2049 6e74 726f 6475 es, Up: Introdu │ │ │ │ │ +000047d0: 6374 696f 6e0a 0a31 2e35 2054 6865 2072 ction..1.5 The r │ │ │ │ │ +000047e0: 6f6c 6520 6f66 2061 2062 6f6f 7420 6c6f ole of a boot lo │ │ │ │ │ +000047f0: 6164 6572 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d ader.=========== │ │ │ │ │ 00004800: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00004810: 3d3d 3d3d 0a0a 5468 6520 666f 6c6c 6f77 ====..The follow │ │ │ │ │ -00004820: 696e 6720 6973 2061 2071 756f 7461 7469 ing is a quotati │ │ │ │ │ -00004830: 6f6e 2066 726f 6d20 476f 7264 6f6e 204d on from Gordon M │ │ │ │ │ -00004840: 6174 7a69 676b 6569 742c 2061 2047 5255 atzigkeit, a GRU │ │ │ │ │ -00004850: 4220 6661 6e61 7469 633a 0a0a 2020 2020 B fanatic:.. │ │ │ │ │ -00004860: 2053 6f6d 6520 7065 6f70 6c65 206c 696b Some people lik │ │ │ │ │ -00004870: 6520 746f 2061 636b 6e6f 776c 6564 6765 e to acknowledge │ │ │ │ │ -00004880: 2062 6f74 6820 7468 6520 6f70 6572 6174 both the operat │ │ │ │ │ -00004890: 696e 6720 7379 7374 656d 2061 6e64 0a20 ing system and. │ │ │ │ │ -000048a0: 2020 2020 6b65 726e 656c 2077 6865 6e20 kernel when │ │ │ │ │ -000048b0: 7468 6579 2074 616c 6b20 6162 6f75 7420 they talk about │ │ │ │ │ -000048c0: 7468 6569 7220 636f 6d70 7574 6572 732c their computers, │ │ │ │ │ -000048d0: 2073 6f20 7468 6579 206d 6967 6874 2073 so they might s │ │ │ │ │ -000048e0: 6179 2074 6865 790a 2020 2020 2075 7365 ay they. use │ │ │ │ │ -000048f0: 2022 474e 552f 4c69 6e75 7822 206f 7220 "GNU/Linux" or │ │ │ │ │ -00004900: 2247 4e55 2f48 7572 6422 2e20 204f 7468 "GNU/Hurd". Oth │ │ │ │ │ -00004910: 6572 2070 656f 706c 6520 7365 656d 2074 er people seem t │ │ │ │ │ -00004920: 6f20 7468 696e 6b20 7468 6174 2074 6865 o think that the │ │ │ │ │ -00004930: 0a20 2020 2020 6b65 726e 656c 2069 7320 . kernel is │ │ │ │ │ -00004940: 7468 6520 6d6f 7374 2069 6d70 6f72 7461 the most importa │ │ │ │ │ -00004950: 6e74 2070 6172 7420 6f66 2074 6865 2073 nt part of the s │ │ │ │ │ -00004960: 7973 7465 6d2c 2073 6f20 7468 6579 206c ystem, so they l │ │ │ │ │ -00004970: 696b 6520 746f 0a20 2020 2020 6361 6c6c ike to. call │ │ │ │ │ -00004980: 2074 6865 6972 2047 4e55 206f 7065 7261 their GNU opera │ │ │ │ │ -00004990: 7469 6e67 2073 7973 7465 6d73 2022 4c69 ting systems "Li │ │ │ │ │ -000049a0: 6e75 7820 7379 7374 656d 732e 220a 0a20 nux systems.".. │ │ │ │ │ -000049b0: 2020 2020 492c 2070 6572 736f 6e61 6c6c I, personall │ │ │ │ │ -000049c0: 792c 2062 656c 6965 7665 2074 6861 7420 y, believe that │ │ │ │ │ -000049d0: 7468 6973 2069 7320 6120 6772 6176 6520 this is a grave │ │ │ │ │ -000049e0: 696e 6a75 7374 6963 652c 2062 6563 6175 injustice, becau │ │ │ │ │ -000049f0: 7365 2074 6865 0a20 2020 2020 5f62 6f6f se the. _boo │ │ │ │ │ -00004a00: 7420 6c6f 6164 6572 5f20 6973 2074 6865 t loader_ is the │ │ │ │ │ -00004a10: 206d 6f73 7420 696d 706f 7274 616e 7420 most important │ │ │ │ │ -00004a20: 736f 6674 7761 7265 206f 6620 616c 6c2e software of all. │ │ │ │ │ -00004a30: 2020 4920 7573 6564 2074 6f0a 2020 2020 I used to. │ │ │ │ │ -00004a40: 2072 6566 6572 2074 6f20 7468 6520 6162 refer to the ab │ │ │ │ │ -00004a50: 6f76 6520 7379 7374 656d 7320 6173 2065 ove systems as e │ │ │ │ │ -00004a60: 6974 6865 7220 224c 494c 4f22 2831 2920 ither "LILO"(1) │ │ │ │ │ -00004a70: 282a 6e6f 7465 2052 6f6c 6520 6f66 2061 (*note Role of a │ │ │ │ │ -00004a80: 0a20 2020 2020 626f 6f74 206c 6f61 6465 . boot loade │ │ │ │ │ -00004a90: 722d 466f 6f74 6e6f 7465 2d31 3a3a 2920 r-Footnote-1::) │ │ │ │ │ -00004aa0: 6f72 2022 4752 5542 2220 7379 7374 656d or "GRUB" system │ │ │ │ │ -00004ab0: 732e 0a0a 2020 2020 2055 6e66 6f72 7475 s... Unfortu │ │ │ │ │ -00004ac0: 6e61 7465 6c79 2c20 6e6f 626f 6479 2065 nately, nobody e │ │ │ │ │ -00004ad0: 7665 7220 756e 6465 7273 746f 6f64 2077 ver understood w │ │ │ │ │ -00004ae0: 6861 7420 4920 7761 7320 7461 6c6b 696e hat I was talkin │ │ │ │ │ -00004af0: 6720 6162 6f75 743b 206e 6f77 0a20 2020 g about; now. │ │ │ │ │ -00004b00: 2020 4920 6a75 7374 2075 7365 2074 6865 I just use the │ │ │ │ │ -00004b10: 2077 6f72 6420 2247 4e55 2220 6173 2061 word "GNU" as a │ │ │ │ │ -00004b20: 2070 7365 7564 6f6e 796d 2066 6f72 2047 pseudonym for G │ │ │ │ │ -00004b30: 5255 422e 0a0a 2020 2020 2053 6f2c 2069 RUB... So, i │ │ │ │ │ -00004b40: 6620 796f 7520 6576 6572 2068 6561 7220 f you ever hear │ │ │ │ │ -00004b50: 7065 6f70 6c65 2074 616c 6b69 6e67 2061 people talking a │ │ │ │ │ -00004b60: 626f 7574 2074 6865 6972 2061 6c6c 6567 bout their alleg │ │ │ │ │ -00004b70: 6564 2022 474e 5522 0a20 2020 2020 7379 ed "GNU". sy │ │ │ │ │ -00004b80: 7374 656d 732c 2072 656d 656d 6265 7220 stems, remember │ │ │ │ │ -00004b90: 7468 6174 2074 6865 7920 6172 6520 6163 that they are ac │ │ │ │ │ -00004ba0: 7475 616c 6c79 2070 6179 696e 6720 686f tually paying ho │ │ │ │ │ -00004bb0: 6d61 6765 2074 6f20 7468 6520 6265 7374 mage to the best │ │ │ │ │ -00004bc0: 0a20 2020 2020 626f 6f74 206c 6f61 6465 . boot loade │ │ │ │ │ -00004bd0: 7220 6172 6f75 6e64 2e2e 2e20 4752 5542 r around... GRUB │ │ │ │ │ -00004be0: 210a 0a20 2020 5765 2c20 7468 6520 4752 !.. We, the GR │ │ │ │ │ -00004bf0: 5542 206d 6169 6e74 6169 6e65 7273 2c20 UB maintainers, │ │ │ │ │ -00004c00: 646f 206e 6f74 2028 7573 7561 6c6c 7929 do not (usually) │ │ │ │ │ -00004c10: 2065 6e63 6f75 7261 6765 2047 6f72 646f encourage Gordo │ │ │ │ │ -00004c20: 6e27 7320 6c65 7665 6c0a 6f66 2066 616e n's level.of fan │ │ │ │ │ -00004c30: 6174 6963 6973 6d2c 2062 7574 2069 7420 aticism, but it │ │ │ │ │ -00004c40: 6865 6c70 7320 746f 2072 656d 656d 6265 helps to remembe │ │ │ │ │ -00004c50: 7220 7468 6174 2062 6f6f 7420 6c6f 6164 r that boot load │ │ │ │ │ -00004c60: 6572 7320 6465 7365 7276 650a 7265 636f ers deserve.reco │ │ │ │ │ -00004c70: 676e 6974 696f 6e2e 2020 5765 2068 6f70 gnition. We hop │ │ │ │ │ -00004c80: 6520 7468 6174 2079 6f75 2065 6e6a 6f79 e that you enjoy │ │ │ │ │ -00004c90: 2075 7369 6e67 2047 4e55 2047 5255 4220 using GNU GRUB │ │ │ │ │ -00004ca0: 6173 206d 7563 6820 6173 2077 6520 6469 as much as we di │ │ │ │ │ -00004cb0: 640a 7772 6974 696e 6720 6974 2e0a 0a1f d.writing it.... │ │ │ │ │ -00004cc0: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ -00004cd0: 2c20 204e 6f64 653a 2052 6f6c 6520 6f66 , Node: Role of │ │ │ │ │ -00004ce0: 2061 2062 6f6f 7420 6c6f 6164 6572 2d46 a boot loader-F │ │ │ │ │ -00004cf0: 6f6f 746e 6f74 6573 2c20 2055 703a 2052 ootnotes, Up: R │ │ │ │ │ -00004d00: 6f6c 6520 6f66 2061 2062 6f6f 7420 6c6f ole of a boot lo │ │ │ │ │ -00004d10: 6164 6572 0a0a 2020 2028 3129 2054 6865 ader.. (1) The │ │ │ │ │ -00004d20: 204c 496e 7578 204c 4f61 6465 722c 2061 LInux LOader, a │ │ │ │ │ -00004d30: 2062 6f6f 7420 6c6f 6164 6572 2074 6861 boot loader tha │ │ │ │ │ -00004d40: 7420 6576 6572 7962 6f64 7920 7573 6573 t everybody uses │ │ │ │ │ -00004d50: 2c20 6275 7420 6e6f 626f 6479 0a6c 696b , but nobody.lik │ │ │ │ │ -00004d60: 6573 2e0a 0a1f 0a46 696c 653a 2067 7275 es.....File: gru │ │ │ │ │ -00004d70: 622e 696e 666f 2c20 204e 6f64 653a 204e b.info, Node: N │ │ │ │ │ -00004d80: 616d 696e 6720 636f 6e76 656e 7469 6f6e aming convention │ │ │ │ │ -00004d90: 2c20 204e 6578 743a 204f 532d 7370 6563 , Next: OS-spec │ │ │ │ │ -00004da0: 6966 6963 206e 6f74 6573 2061 626f 7574 ific notes about │ │ │ │ │ -00004db0: 2067 7275 6220 746f 6f6c 732c 2020 5072 grub tools, Pr │ │ │ │ │ -00004dc0: 6576 3a20 496e 7472 6f64 7563 7469 6f6e ev: Introduction │ │ │ │ │ -00004dd0: 2c20 2055 703a 2054 6f70 0a0a 3220 4e61 , Up: Top..2 Na │ │ │ │ │ -00004de0: 6d69 6e67 2063 6f6e 7665 6e74 696f 6e0a ming convention. │ │ │ │ │ +00004810: 3d3d 0a0a 5468 6520 666f 6c6c 6f77 696e ==..The followin │ │ │ │ │ +00004820: 6720 6973 2061 2071 756f 7461 7469 6f6e g is a quotation │ │ │ │ │ +00004830: 2066 726f 6d20 476f 7264 6f6e 204d 6174 from Gordon Mat │ │ │ │ │ +00004840: 7a69 676b 6569 742c 2061 2047 5255 4220 zigkeit, a GRUB │ │ │ │ │ +00004850: 6661 6e61 7469 633a 0a0a 2020 2020 2053 fanatic:.. S │ │ │ │ │ +00004860: 6f6d 6520 7065 6f70 6c65 206c 696b 6520 ome people like │ │ │ │ │ +00004870: 746f 2061 636b 6e6f 776c 6564 6765 2062 to acknowledge b │ │ │ │ │ +00004880: 6f74 6820 7468 6520 6f70 6572 6174 696e oth the operatin │ │ │ │ │ +00004890: 6720 7379 7374 656d 2061 6e64 0a20 2020 g system and. │ │ │ │ │ +000048a0: 2020 6b65 726e 656c 2077 6865 6e20 7468 kernel when th │ │ │ │ │ +000048b0: 6579 2074 616c 6b20 6162 6f75 7420 7468 ey talk about th │ │ │ │ │ +000048c0: 6569 7220 636f 6d70 7574 6572 732c 2073 eir computers, s │ │ │ │ │ +000048d0: 6f20 7468 6579 206d 6967 6874 2073 6179 o they might say │ │ │ │ │ +000048e0: 2074 6865 790a 2020 2020 2075 7365 2022 they. use " │ │ │ │ │ +000048f0: 474e 552f 4c69 6e75 7822 206f 7220 2247 GNU/Linux" or "G │ │ │ │ │ +00004900: 4e55 2f48 7572 6422 2e20 204f 7468 6572 NU/Hurd". Other │ │ │ │ │ +00004910: 2070 656f 706c 6520 7365 656d 2074 6f20 people seem to │ │ │ │ │ +00004920: 7468 696e 6b20 7468 6174 2074 6865 0a20 think that the. │ │ │ │ │ +00004930: 2020 2020 6b65 726e 656c 2069 7320 7468 kernel is th │ │ │ │ │ +00004940: 6520 6d6f 7374 2069 6d70 6f72 7461 6e74 e most important │ │ │ │ │ +00004950: 2070 6172 7420 6f66 2074 6865 2073 7973 part of the sys │ │ │ │ │ +00004960: 7465 6d2c 2073 6f20 7468 6579 206c 696b tem, so they lik │ │ │ │ │ +00004970: 6520 746f 0a20 2020 2020 6361 6c6c 2074 e to. call t │ │ │ │ │ +00004980: 6865 6972 2047 4e55 206f 7065 7261 7469 heir GNU operati │ │ │ │ │ +00004990: 6e67 2073 7973 7465 6d73 2022 4c69 6e75 ng systems "Linu │ │ │ │ │ +000049a0: 7820 7379 7374 656d 732e 220a 0a20 2020 x systems.".. │ │ │ │ │ +000049b0: 2020 492c 2070 6572 736f 6e61 6c6c 792c I, personally, │ │ │ │ │ +000049c0: 2062 656c 6965 7665 2074 6861 7420 7468 believe that th │ │ │ │ │ +000049d0: 6973 2069 7320 6120 6772 6176 6520 696e is is a grave in │ │ │ │ │ +000049e0: 6a75 7374 6963 652c 2062 6563 6175 7365 justice, because │ │ │ │ │ +000049f0: 2074 6865 0a20 2020 2020 5f62 6f6f 7420 the. _boot │ │ │ │ │ +00004a00: 6c6f 6164 6572 5f20 6973 2074 6865 206d loader_ is the m │ │ │ │ │ +00004a10: 6f73 7420 696d 706f 7274 616e 7420 736f ost important so │ │ │ │ │ +00004a20: 6674 7761 7265 206f 6620 616c 6c2e 2020 ftware of all. │ │ │ │ │ +00004a30: 4920 7573 6564 2074 6f0a 2020 2020 2072 I used to. r │ │ │ │ │ +00004a40: 6566 6572 2074 6f20 7468 6520 6162 6f76 efer to the abov │ │ │ │ │ +00004a50: 6520 7379 7374 656d 7320 6173 2065 6974 e systems as eit │ │ │ │ │ +00004a60: 6865 7220 224c 494c 4f22 2831 2920 282a her "LILO"(1) (* │ │ │ │ │ +00004a70: 6e6f 7465 2052 6f6c 6520 6f66 2061 0a20 note Role of a. │ │ │ │ │ +00004a80: 2020 2020 626f 6f74 206c 6f61 6465 722d boot loader- │ │ │ │ │ +00004a90: 466f 6f74 6e6f 7465 2d31 3a3a 2920 6f72 Footnote-1::) or │ │ │ │ │ +00004aa0: 2022 4752 5542 2220 7379 7374 656d 732e "GRUB" systems. │ │ │ │ │ +00004ab0: 0a0a 2020 2020 2055 6e66 6f72 7475 6e61 .. Unfortuna │ │ │ │ │ +00004ac0: 7465 6c79 2c20 6e6f 626f 6479 2065 7665 tely, nobody eve │ │ │ │ │ +00004ad0: 7220 756e 6465 7273 746f 6f64 2077 6861 r understood wha │ │ │ │ │ +00004ae0: 7420 4920 7761 7320 7461 6c6b 696e 6720 t I was talking │ │ │ │ │ +00004af0: 6162 6f75 743b 206e 6f77 0a20 2020 2020 about; now. │ │ │ │ │ +00004b00: 4920 6a75 7374 2075 7365 2074 6865 2077 I just use the w │ │ │ │ │ +00004b10: 6f72 6420 2247 4e55 2220 6173 2061 2070 ord "GNU" as a p │ │ │ │ │ +00004b20: 7365 7564 6f6e 796d 2066 6f72 2047 5255 seudonym for GRU │ │ │ │ │ +00004b30: 422e 0a0a 2020 2020 2053 6f2c 2069 6620 B... So, if │ │ │ │ │ +00004b40: 796f 7520 6576 6572 2068 6561 7220 7065 you ever hear pe │ │ │ │ │ +00004b50: 6f70 6c65 2074 616c 6b69 6e67 2061 626f ople talking abo │ │ │ │ │ +00004b60: 7574 2074 6865 6972 2061 6c6c 6567 6564 ut their alleged │ │ │ │ │ +00004b70: 2022 474e 5522 0a20 2020 2020 7379 7374 "GNU". syst │ │ │ │ │ +00004b80: 656d 732c 2072 656d 656d 6265 7220 7468 ems, remember th │ │ │ │ │ +00004b90: 6174 2074 6865 7920 6172 6520 6163 7475 at they are actu │ │ │ │ │ +00004ba0: 616c 6c79 2070 6179 696e 6720 686f 6d61 ally paying homa │ │ │ │ │ +00004bb0: 6765 2074 6f20 7468 6520 6265 7374 0a20 ge to the best. │ │ │ │ │ +00004bc0: 2020 2020 626f 6f74 206c 6f61 6465 7220 boot loader │ │ │ │ │ +00004bd0: 6172 6f75 6e64 2e2e 2e20 4752 5542 210a around... GRUB!. │ │ │ │ │ +00004be0: 0a20 2020 5765 2c20 7468 6520 4752 5542 . We, the GRUB │ │ │ │ │ +00004bf0: 206d 6169 6e74 6169 6e65 7273 2c20 646f maintainers, do │ │ │ │ │ +00004c00: 206e 6f74 2028 7573 7561 6c6c 7929 2065 not (usually) e │ │ │ │ │ +00004c10: 6e63 6f75 7261 6765 2047 6f72 646f 6e27 ncourage Gordon' │ │ │ │ │ +00004c20: 7320 6c65 7665 6c0a 6f66 2066 616e 6174 s level.of fanat │ │ │ │ │ +00004c30: 6963 6973 6d2c 2062 7574 2069 7420 6865 icism, but it he │ │ │ │ │ +00004c40: 6c70 7320 746f 2072 656d 656d 6265 7220 lps to remember │ │ │ │ │ +00004c50: 7468 6174 2062 6f6f 7420 6c6f 6164 6572 that boot loader │ │ │ │ │ +00004c60: 7320 6465 7365 7276 650a 7265 636f 676e s deserve.recogn │ │ │ │ │ +00004c70: 6974 696f 6e2e 2020 5765 2068 6f70 6520 ition. We hope │ │ │ │ │ +00004c80: 7468 6174 2079 6f75 2065 6e6a 6f79 2075 that you enjoy u │ │ │ │ │ +00004c90: 7369 6e67 2047 4e55 2047 5255 4220 6173 sing GNU GRUB as │ │ │ │ │ +00004ca0: 206d 7563 6820 6173 2077 6520 6469 640a much as we did. │ │ │ │ │ +00004cb0: 7772 6974 696e 6720 6974 2e0a 0a1f 0a46 writing it.....F │ │ │ │ │ +00004cc0: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ +00004cd0: 204e 6f64 653a 2052 6f6c 6520 6f66 2061 Node: Role of a │ │ │ │ │ +00004ce0: 2062 6f6f 7420 6c6f 6164 6572 2d46 6f6f boot loader-Foo │ │ │ │ │ +00004cf0: 746e 6f74 6573 2c20 2055 703a 2052 6f6c tnotes, Up: Rol │ │ │ │ │ +00004d00: 6520 6f66 2061 2062 6f6f 7420 6c6f 6164 e of a boot load │ │ │ │ │ +00004d10: 6572 0a0a 2020 2028 3129 2054 6865 204c er.. (1) The L │ │ │ │ │ +00004d20: 496e 7578 204c 4f61 6465 722c 2061 2062 Inux LOader, a b │ │ │ │ │ +00004d30: 6f6f 7420 6c6f 6164 6572 2074 6861 7420 oot loader that │ │ │ │ │ +00004d40: 6576 6572 7962 6f64 7920 7573 6573 2c20 everybody uses, │ │ │ │ │ +00004d50: 6275 7420 6e6f 626f 6479 0a6c 696b 6573 but nobody.likes │ │ │ │ │ +00004d60: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ +00004d70: 696e 666f 2c20 204e 6f64 653a 204e 616d info, Node: Nam │ │ │ │ │ +00004d80: 696e 6720 636f 6e76 656e 7469 6f6e 2c20 ing convention, │ │ │ │ │ +00004d90: 204e 6578 743a 204f 532d 7370 6563 6966 Next: OS-specif │ │ │ │ │ +00004da0: 6963 206e 6f74 6573 2061 626f 7574 2067 ic notes about g │ │ │ │ │ +00004db0: 7275 6220 746f 6f6c 732c 2020 5072 6576 rub tools, Prev │ │ │ │ │ +00004dc0: 3a20 496e 7472 6f64 7563 7469 6f6e 2c20 : Introduction, │ │ │ │ │ +00004dd0: 2055 703a 2054 6f70 0a0a 3220 4e61 6d69 Up: Top..2 Nami │ │ │ │ │ +00004de0: 6e67 2063 6f6e 7665 6e74 696f 6e0a 2a2a ng convention.** │ │ │ │ │ 00004df0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -00004e00: 2a2a 2a0a 0a54 6865 2064 6576 6963 6520 ***..The device │ │ │ │ │ -00004e10: 7379 6e74 6178 2075 7365 6420 696e 2047 syntax used in G │ │ │ │ │ -00004e20: 5255 4220 6973 2061 2077 6565 2062 6974 RUB is a wee bit │ │ │ │ │ -00004e30: 2064 6966 6665 7265 6e74 2066 726f 6d20 different from │ │ │ │ │ -00004e40: 7768 6174 2079 6f75 206d 6179 0a68 6176 what you may.hav │ │ │ │ │ -00004e50: 6520 7365 656e 2062 6566 6f72 6520 696e e seen before in │ │ │ │ │ -00004e60: 2079 6f75 7220 6f70 6572 6174 696e 6720 your operating │ │ │ │ │ -00004e70: 7379 7374 656d 2873 292c 2061 6e64 2079 system(s), and y │ │ │ │ │ -00004e80: 6f75 206e 6565 6420 746f 206b 6e6f 7720 ou need to know │ │ │ │ │ -00004e90: 6974 2073 6f0a 7468 6174 2079 6f75 2063 it so.that you c │ │ │ │ │ -00004ea0: 616e 2073 7065 6369 6679 2061 2064 7269 an specify a dri │ │ │ │ │ -00004eb0: 7665 2f70 6172 7469 7469 6f6e 2e0a 0a20 ve/partition... │ │ │ │ │ -00004ec0: 2020 4c6f 6f6b 2061 7420 7468 6520 666f Look at the fo │ │ │ │ │ -00004ed0: 6c6c 6f77 696e 6720 6578 616d 706c 6573 llowing examples │ │ │ │ │ -00004ee0: 2061 6e64 2065 7870 6c61 6e61 7469 6f6e and explanation │ │ │ │ │ -00004ef0: 733a 0a0a 2020 2020 2028 6664 3029 0a0a s:.. (fd0).. │ │ │ │ │ -00004f00: 2020 2046 6972 7374 206f 6620 616c 6c2c First of all, │ │ │ │ │ -00004f10: 2047 5255 4220 7265 7175 6972 6573 2074 GRUB requires t │ │ │ │ │ -00004f20: 6861 7420 7468 6520 6465 7669 6365 206e hat the device n │ │ │ │ │ -00004f30: 616d 6520 6265 2065 6e63 6c6f 7365 6420 ame be enclosed │ │ │ │ │ -00004f40: 7769 7468 2027 2827 0a61 6e64 2027 2927 with '('.and ')' │ │ │ │ │ -00004f50: 2e20 2054 6865 2027 6664 2720 7061 7274 . The 'fd' part │ │ │ │ │ -00004f60: 206d 6561 6e73 2074 6861 7420 6974 2069 means that it i │ │ │ │ │ -00004f70: 7320 6120 666c 6f70 7079 2064 6973 6b2e s a floppy disk. │ │ │ │ │ -00004f80: 2020 5468 6520 6e75 6d62 6572 2027 3027 The number '0' │ │ │ │ │ -00004f90: 0a69 7320 7468 6520 6472 6976 6520 6e75 .is the drive nu │ │ │ │ │ -00004fa0: 6d62 6572 2c20 7768 6963 6820 6973 2063 mber, which is c │ │ │ │ │ -00004fb0: 6f75 6e74 6564 2066 726f 6d20 5f7a 6572 ounted from _zer │ │ │ │ │ -00004fc0: 6f5f 2e20 2054 6869 7320 6578 7072 6573 o_. This expres │ │ │ │ │ -00004fd0: 7369 6f6e 0a6d 6561 6e73 2074 6861 7420 sion.means that │ │ │ │ │ -00004fe0: 4752 5542 2077 696c 6c20 7573 6520 7468 GRUB will use th │ │ │ │ │ -00004ff0: 6520 7768 6f6c 6520 666c 6f70 7079 2064 e whole floppy d │ │ │ │ │ -00005000: 6973 6b2e 0a0a 2020 2020 2028 6864 302c isk... (hd0, │ │ │ │ │ -00005010: 6d73 646f 7332 290a 0a20 2020 4865 7265 msdos2).. Here │ │ │ │ │ -00005020: 2c20 2768 6427 206d 6561 6e73 2069 7420 , 'hd' means it │ │ │ │ │ -00005030: 6973 2061 2068 6172 6420 6469 736b 2064 is a hard disk d │ │ │ │ │ -00005040: 7269 7665 2e20 2054 6865 2066 6972 7374 rive. The first │ │ │ │ │ -00005050: 2069 6e74 6567 6572 2027 3027 0a69 6e64 integer '0'.ind │ │ │ │ │ -00005060: 6963 6174 6573 2074 6865 2064 7269 7665 icates the drive │ │ │ │ │ -00005070: 206e 756d 6265 722c 2074 6861 7420 6973 number, that is │ │ │ │ │ -00005080: 2c20 7468 6520 6669 7273 7420 6861 7264 , the first hard │ │ │ │ │ -00005090: 2064 6973 6b2c 2074 6865 2073 7472 696e disk, the strin │ │ │ │ │ -000050a0: 670a 276d 7364 6f73 2720 696e 6469 6361 g.'msdos' indica │ │ │ │ │ -000050b0: 7465 7320 7468 6520 7061 7274 6974 696f tes the partitio │ │ │ │ │ -000050c0: 6e20 7363 6865 6d65 2c20 7768 696c 6520 n scheme, while │ │ │ │ │ -000050d0: 7468 6520 7365 636f 6e64 2069 6e74 6567 the second integ │ │ │ │ │ -000050e0: 6572 2c20 2732 272c 0a69 6e64 6963 6174 er, '2',.indicat │ │ │ │ │ -000050f0: 6573 2074 6865 2070 6172 7469 7469 6f6e es the partition │ │ │ │ │ -00005100: 206e 756d 6265 7220 286f 7220 7468 6520 number (or the │ │ │ │ │ -00005110: 5043 2073 6c69 6365 206e 756d 6265 7220 PC slice number │ │ │ │ │ -00005120: 696e 2074 6865 2042 5344 0a74 6572 6d69 in the BSD.termi │ │ │ │ │ -00005130: 6e6f 6c6f 6779 292e 2020 5468 6520 7061 nology). The pa │ │ │ │ │ -00005140: 7274 6974 696f 6e20 6e75 6d62 6572 7320 rtition numbers │ │ │ │ │ -00005150: 6172 6520 636f 756e 7465 6420 6672 6f6d are counted from │ │ │ │ │ -00005160: 205f 6f6e 655f 2c20 6e6f 7420 6672 6f6d _one_, not from │ │ │ │ │ -00005170: 0a7a 6572 6f20 2861 7320 7761 7320 7468 .zero (as was th │ │ │ │ │ -00005180: 6520 6361 7365 2069 6e20 7072 6576 696f e case in previo │ │ │ │ │ -00005190: 7573 2076 6572 7369 6f6e 7320 6f66 2047 us versions of G │ │ │ │ │ -000051a0: 5255 4229 2e20 5468 6973 2065 7870 7265 RUB). This expre │ │ │ │ │ -000051b0: 7373 696f 6e0a 6d65 616e 7320 7468 6520 ssion.means the │ │ │ │ │ -000051c0: 7365 636f 6e64 2070 6172 7469 7469 6f6e second partition │ │ │ │ │ -000051d0: 206f 6620 7468 6520 6669 7273 7420 6861 of the first ha │ │ │ │ │ -000051e0: 7264 2064 6973 6b20 6472 6976 652e 2020 rd disk drive. │ │ │ │ │ -000051f0: 496e 2074 6869 7320 6361 7365 2c0a 4752 In this case,.GR │ │ │ │ │ -00005200: 5542 2075 7365 7320 6f6e 6520 7061 7274 UB uses one part │ │ │ │ │ -00005210: 6974 696f 6e20 6f66 2074 6865 2064 6973 ition of the dis │ │ │ │ │ -00005220: 6b2c 2069 6e73 7465 6164 206f 6620 7468 k, instead of th │ │ │ │ │ -00005230: 6520 7768 6f6c 6520 6469 736b 2e0a 0a20 e whole disk... │ │ │ │ │ -00005240: 2020 2020 2868 6430 2c6d 7364 6f73 3529 (hd0,msdos5) │ │ │ │ │ -00005250: 0a0a 2020 2054 6869 7320 7370 6563 6966 .. This specif │ │ │ │ │ -00005260: 6965 7320 7468 6520 6669 7273 7420 2265 ies the first "e │ │ │ │ │ -00005270: 7874 656e 6465 6420 7061 7274 6974 696f xtended partitio │ │ │ │ │ -00005280: 6e22 206f 6620 7468 6520 6669 7273 7420 n" of the first │ │ │ │ │ -00005290: 6861 7264 2064 6973 6b0a 6472 6976 652e hard disk.drive. │ │ │ │ │ -000052a0: 2020 4e6f 7465 2074 6861 7420 7468 6520 Note that the │ │ │ │ │ -000052b0: 7061 7274 6974 696f 6e20 6e75 6d62 6572 partition number │ │ │ │ │ -000052c0: 7320 666f 7220 6578 7465 6e64 6564 2070 s for extended p │ │ │ │ │ -000052d0: 6172 7469 7469 6f6e 7320 6172 650a 636f artitions are.co │ │ │ │ │ -000052e0: 756e 7465 6420 6672 6f6d 2027 3527 2c20 unted from '5', │ │ │ │ │ -000052f0: 7265 6761 7264 6c65 7373 206f 6620 7468 regardless of th │ │ │ │ │ -00005300: 6520 6163 7475 616c 206e 756d 6265 7220 e actual number │ │ │ │ │ -00005310: 6f66 2070 7269 6d61 7279 2070 6172 7469 of primary parti │ │ │ │ │ -00005320: 7469 6f6e 730a 6f6e 2079 6f75 7220 6861 tions.on your ha │ │ │ │ │ -00005330: 7264 2064 6973 6b2e 0a0a 2020 2020 2028 rd disk... ( │ │ │ │ │ -00005340: 6864 312c 6d73 646f 7331 2c62 7364 3129 hd1,msdos1,bsd1) │ │ │ │ │ -00005350: 0a0a 2020 2054 6869 7320 6d65 616e 7320 .. This means │ │ │ │ │ -00005360: 7468 6520 4253 4420 2761 2720 7061 7274 the BSD 'a' part │ │ │ │ │ -00005370: 6974 696f 6e20 6f6e 2066 6972 7374 2050 ition on first P │ │ │ │ │ -00005380: 4320 736c 6963 6520 6e75 6d62 6572 206f C slice number o │ │ │ │ │ -00005390: 6620 7468 650a 7365 636f 6e64 2068 6172 f the.second har │ │ │ │ │ -000053a0: 6420 6469 736b 2e0a 0a20 2020 4f66 2063 d disk... Of c │ │ │ │ │ -000053b0: 6f75 7273 652c 2074 6f20 6163 7475 616c ourse, to actual │ │ │ │ │ -000053c0: 6c79 2061 6363 6573 7320 7468 6520 6469 ly access the di │ │ │ │ │ -000053d0: 736b 7320 6f72 2070 6172 7469 7469 6f6e sks or partition │ │ │ │ │ -000053e0: 7320 7769 7468 2047 5255 422c 2079 6f75 s with GRUB, you │ │ │ │ │ -000053f0: 0a6e 6565 6420 746f 2075 7365 2074 6865 .need to use the │ │ │ │ │ -00005400: 2064 6576 6963 6520 7370 6563 6966 6963 device specific │ │ │ │ │ -00005410: 6174 696f 6e20 696e 2061 2063 6f6d 6d61 ation in a comma │ │ │ │ │ -00005420: 6e64 2c20 6c69 6b65 2027 7365 7420 726f nd, like 'set ro │ │ │ │ │ -00005430: 6f74 3d28 6664 3029 270a 6f72 2027 7061 ot=(fd0)'.or 'pa │ │ │ │ │ -00005440: 7274 746f 6f6c 2028 6864 302c 6d73 646f rttool (hd0,msdo │ │ │ │ │ -00005450: 7333 2920 6869 6464 656e 2d27 2e20 2054 s3) hidden-'. T │ │ │ │ │ -00005460: 6f20 6865 6c70 2079 6f75 2066 696e 6420 o help you find │ │ │ │ │ -00005470: 6f75 7420 7768 6963 6820 6e75 6d62 6572 out which number │ │ │ │ │ -00005480: 0a73 7065 6369 6669 6573 2061 2070 6172 .specifies a par │ │ │ │ │ -00005490: 7469 7469 6f6e 2079 6f75 2077 616e 742c tition you want, │ │ │ │ │ -000054a0: 2074 6865 2047 5255 4220 636f 6d6d 616e the GRUB comman │ │ │ │ │ -000054b0: 642d 6c69 6e65 2028 2a6e 6f74 650a 436f d-line (*note.Co │ │ │ │ │ -000054c0: 6d6d 616e 642d 6c69 6e65 2069 6e74 6572 mmand-line inter │ │ │ │ │ -000054d0: 6661 6365 3a3a 2920 6f70 7469 6f6e 7320 face::) options │ │ │ │ │ -000054e0: 6861 7665 2061 7267 756d 656e 7420 636f have argument co │ │ │ │ │ -000054f0: 6d70 6c65 7469 6f6e 2e20 2054 6869 7320 mpletion. This │ │ │ │ │ -00005500: 6d65 616e 730a 7468 6174 2c20 666f 7220 means.that, for │ │ │ │ │ -00005510: 6578 616d 706c 652c 2079 6f75 206f 6e6c example, you onl │ │ │ │ │ -00005520: 7920 6e65 6564 2074 6f20 7479 7065 0a0a y need to type.. │ │ │ │ │ -00005530: 2020 2020 2073 6574 2072 6f6f 743d 280a set root=(. │ │ │ │ │ -00005540: 0a20 2020 666f 6c6c 6f77 6564 2062 7920 . followed by │ │ │ │ │ -00005550: 6120 3c54 4142 3e2c 2061 6e64 2047 5255 a , and GRU │ │ │ │ │ -00005560: 4220 7769 6c6c 2064 6973 706c 6179 2074 B will display t │ │ │ │ │ -00005570: 6865 206c 6973 7420 6f66 2064 7269 7665 he list of drive │ │ │ │ │ -00005580: 732c 0a70 6172 7469 7469 6f6e 732c 206f s,.partitions, o │ │ │ │ │ -00005590: 7220 6669 6c65 206e 616d 6573 2e20 2053 r file names. S │ │ │ │ │ -000055a0: 6f20 6974 2073 686f 756c 6420 6265 2071 o it should be q │ │ │ │ │ -000055b0: 7569 7465 2065 6173 7920 746f 2064 6574 uite easy to det │ │ │ │ │ -000055c0: 6572 6d69 6e65 2074 6865 0a6e 616d 6520 ermine the.name │ │ │ │ │ -000055d0: 6f66 2079 6f75 7220 7461 7267 6574 2070 of your target p │ │ │ │ │ -000055e0: 6172 7469 7469 6f6e 2c20 6576 656e 2077 artition, even w │ │ │ │ │ -000055f0: 6974 6820 6d69 6e69 6d61 6c20 6b6e 6f77 ith minimal know │ │ │ │ │ -00005600: 6c65 6467 6520 6f66 2074 6865 0a73 796e ledge of the.syn │ │ │ │ │ -00005610: 7461 782e 0a0a 2020 204e 6f74 6520 7468 tax... Note th │ │ │ │ │ -00005620: 6174 2047 5255 4220 646f 6573 205f 6e6f at GRUB does _no │ │ │ │ │ -00005630: 745f 2064 6973 7469 6e67 7569 7368 2049 t_ distinguish I │ │ │ │ │ -00005640: 4445 2066 726f 6d20 5343 5349 202d 2069 DE from SCSI - i │ │ │ │ │ -00005650: 7420 7369 6d70 6c79 0a63 6f75 6e74 7320 t simply.counts │ │ │ │ │ -00005660: 7468 6520 6472 6976 6520 6e75 6d62 6572 the drive number │ │ │ │ │ -00005670: 7320 6672 6f6d 207a 6572 6f2c 2072 6567 s from zero, reg │ │ │ │ │ -00005680: 6172 646c 6573 7320 6f66 2074 6865 6972 ardless of their │ │ │ │ │ -00005690: 2074 7970 652e 2020 4e6f 726d 616c 6c79 type. Normally │ │ │ │ │ -000056a0: 2c0a 616e 7920 4944 4520 6472 6976 6520 ,.any IDE drive │ │ │ │ │ -000056b0: 6e75 6d62 6572 2069 7320 6c65 7373 2074 number is less t │ │ │ │ │ -000056c0: 6861 6e20 616e 7920 5343 5349 2064 7269 han any SCSI dri │ │ │ │ │ -000056d0: 7665 206e 756d 6265 722c 2061 6c74 686f ve number, altho │ │ │ │ │ -000056e0: 7567 6820 7468 6174 0a69 7320 6e6f 7420 ugh that.is not │ │ │ │ │ -000056f0: 7472 7565 2069 6620 796f 7520 6368 616e true if you chan │ │ │ │ │ -00005700: 6765 2074 6865 2062 6f6f 7420 7365 7175 ge the boot sequ │ │ │ │ │ -00005710: 656e 6365 2062 7920 7377 6170 7069 6e67 ence by swapping │ │ │ │ │ -00005720: 2049 4445 2061 6e64 2053 4353 490a 6472 IDE and SCSI.dr │ │ │ │ │ -00005730: 6976 6573 2069 6e20 796f 7572 2042 494f ives in your BIO │ │ │ │ │ -00005740: 532e 0a0a 2020 204e 6f77 2074 6865 2071 S... Now the q │ │ │ │ │ -00005750: 7565 7374 696f 6e20 6973 2c20 686f 7720 uestion is, how │ │ │ │ │ -00005760: 746f 2073 7065 6369 6679 2061 2066 696c to specify a fil │ │ │ │ │ -00005770: 653f 2020 4167 6169 6e2c 2063 6f6e 7369 e? Again, consi │ │ │ │ │ -00005780: 6465 7220 616e 0a65 7861 6d70 6c65 3a0a der an.example:. │ │ │ │ │ -00005790: 0a20 2020 2020 2868 6430 2c6d 7364 6f73 . (hd0,msdos │ │ │ │ │ -000057a0: 3129 2f76 6d6c 696e 757a 0a0a 2020 2054 1)/vmlinuz.. T │ │ │ │ │ -000057b0: 6869 7320 7370 6563 6966 6965 7320 7468 his specifies th │ │ │ │ │ -000057c0: 6520 6669 6c65 206e 616d 6564 2027 766d e file named 'vm │ │ │ │ │ -000057d0: 6c69 6e75 7a27 2c20 666f 756e 6420 6f6e linuz', found on │ │ │ │ │ -000057e0: 2074 6865 2066 6972 7374 2070 6172 7469 the first parti │ │ │ │ │ -000057f0: 7469 6f6e 0a6f 6620 7468 6520 6669 7273 tion.of the firs │ │ │ │ │ -00005800: 7420 6861 7264 2064 6973 6b20 6472 6976 t hard disk driv │ │ │ │ │ -00005810: 652e 2020 4e6f 7465 2074 6861 7420 7468 e. Note that th │ │ │ │ │ -00005820: 6520 6172 6775 6d65 6e74 2063 6f6d 706c e argument compl │ │ │ │ │ -00005830: 6574 696f 6e20 776f 726b 730a 7769 7468 etion works.with │ │ │ │ │ -00005840: 2066 696c 6520 6e61 6d65 732c 2074 6f6f file names, too │ │ │ │ │ -00005850: 2e0a 0a20 2020 5468 6174 2077 6173 2065 ... That was e │ │ │ │ │ -00005860: 6173 792c 2061 646d 6974 2069 742e 2020 asy, admit it. │ │ │ │ │ -00005870: 4e6f 7720 7265 6164 2074 6865 206e 6578 Now read the nex │ │ │ │ │ -00005880: 7420 6368 6170 7465 722c 2074 6f20 6669 t chapter, to fi │ │ │ │ │ -00005890: 6e64 206f 7574 2068 6f77 0a74 6f20 6163 nd out how.to ac │ │ │ │ │ -000058a0: 7475 616c 6c79 2069 6e73 7461 6c6c 2047 tually install G │ │ │ │ │ -000058b0: 5255 4220 6f6e 2079 6f75 7220 6472 6976 RUB on your driv │ │ │ │ │ -000058c0: 652e 0a0a 1f0a 4669 6c65 3a20 6772 7562 e.....File: grub │ │ │ │ │ -000058d0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 4f53 .info, Node: OS │ │ │ │ │ -000058e0: 2d73 7065 6369 6669 6320 6e6f 7465 7320 -specific notes │ │ │ │ │ -000058f0: 6162 6f75 7420 6772 7562 2074 6f6f 6c73 about grub tools │ │ │ │ │ -00005900: 2c20 204e 6578 743a 2049 6e73 7461 6c6c , Next: Install │ │ │ │ │ -00005910: 6174 696f 6e2c 2020 5072 6576 3a20 4e61 ation, Prev: Na │ │ │ │ │ -00005920: 6d69 6e67 2063 6f6e 7665 6e74 696f 6e2c ming convention, │ │ │ │ │ -00005930: 2020 5570 3a20 546f 700a 0a33 204f 532d Up: Top..3 OS- │ │ │ │ │ -00005940: 7370 6563 6966 6963 206e 6f74 6573 2061 specific notes a │ │ │ │ │ -00005950: 626f 7574 2067 7275 6220 746f 6f6c 730a bout grub tools. │ │ │ │ │ +00004e00: 2a0a 0a54 6865 2064 6576 6963 6520 7379 *..The device sy │ │ │ │ │ +00004e10: 6e74 6178 2075 7365 6420 696e 2047 5255 ntax used in GRU │ │ │ │ │ +00004e20: 4220 6973 2061 2077 6565 2062 6974 2064 B is a wee bit d │ │ │ │ │ +00004e30: 6966 6665 7265 6e74 2066 726f 6d20 7768 ifferent from wh │ │ │ │ │ +00004e40: 6174 2079 6f75 206d 6179 0a68 6176 6520 at you may.have │ │ │ │ │ +00004e50: 7365 656e 2062 6566 6f72 6520 696e 2079 seen before in y │ │ │ │ │ +00004e60: 6f75 7220 6f70 6572 6174 696e 6720 7379 our operating sy │ │ │ │ │ +00004e70: 7374 656d 2873 292c 2061 6e64 2079 6f75 stem(s), and you │ │ │ │ │ +00004e80: 206e 6565 6420 746f 206b 6e6f 7720 6974 need to know it │ │ │ │ │ +00004e90: 2073 6f0a 7468 6174 2079 6f75 2063 616e so.that you can │ │ │ │ │ +00004ea0: 2073 7065 6369 6679 2061 2064 7269 7665 specify a drive │ │ │ │ │ +00004eb0: 2f70 6172 7469 7469 6f6e 2e0a 0a20 2020 /partition... │ │ │ │ │ +00004ec0: 4c6f 6f6b 2061 7420 7468 6520 666f 6c6c Look at the foll │ │ │ │ │ +00004ed0: 6f77 696e 6720 6578 616d 706c 6573 2061 owing examples a │ │ │ │ │ +00004ee0: 6e64 2065 7870 6c61 6e61 7469 6f6e 733a nd explanations: │ │ │ │ │ +00004ef0: 0a0a 2020 2020 2028 6664 3029 0a0a 2020 .. (fd0).. │ │ │ │ │ +00004f00: 2046 6972 7374 206f 6620 616c 6c2c 2047 First of all, G │ │ │ │ │ +00004f10: 5255 4220 7265 7175 6972 6573 2074 6861 RUB requires tha │ │ │ │ │ +00004f20: 7420 7468 6520 6465 7669 6365 206e 616d t the device nam │ │ │ │ │ +00004f30: 6520 6265 2065 6e63 6c6f 7365 6420 7769 e be enclosed wi │ │ │ │ │ +00004f40: 7468 2027 2827 0a61 6e64 2027 2927 2e20 th '('.and ')'. │ │ │ │ │ +00004f50: 2054 6865 2027 6664 2720 7061 7274 206d The 'fd' part m │ │ │ │ │ +00004f60: 6561 6e73 2074 6861 7420 6974 2069 7320 eans that it is │ │ │ │ │ +00004f70: 6120 666c 6f70 7079 2064 6973 6b2e 2020 a floppy disk. │ │ │ │ │ +00004f80: 5468 6520 6e75 6d62 6572 2027 3027 0a69 The number '0'.i │ │ │ │ │ +00004f90: 7320 7468 6520 6472 6976 6520 6e75 6d62 s the drive numb │ │ │ │ │ +00004fa0: 6572 2c20 7768 6963 6820 6973 2063 6f75 er, which is cou │ │ │ │ │ +00004fb0: 6e74 6564 2066 726f 6d20 5f7a 6572 6f5f nted from _zero_ │ │ │ │ │ +00004fc0: 2e20 2054 6869 7320 6578 7072 6573 7369 . This expressi │ │ │ │ │ +00004fd0: 6f6e 0a6d 6561 6e73 2074 6861 7420 4752 on.means that GR │ │ │ │ │ +00004fe0: 5542 2077 696c 6c20 7573 6520 7468 6520 UB will use the │ │ │ │ │ +00004ff0: 7768 6f6c 6520 666c 6f70 7079 2064 6973 whole floppy dis │ │ │ │ │ +00005000: 6b2e 0a0a 2020 2020 2028 6864 302c 6d73 k... (hd0,ms │ │ │ │ │ +00005010: 646f 7332 290a 0a20 2020 4865 7265 2c20 dos2).. Here, │ │ │ │ │ +00005020: 2768 6427 206d 6561 6e73 2069 7420 6973 'hd' means it is │ │ │ │ │ +00005030: 2061 2068 6172 6420 6469 736b 2064 7269 a hard disk dri │ │ │ │ │ +00005040: 7665 2e20 2054 6865 2066 6972 7374 2069 ve. The first i │ │ │ │ │ +00005050: 6e74 6567 6572 2027 3027 0a69 6e64 6963 nteger '0'.indic │ │ │ │ │ +00005060: 6174 6573 2074 6865 2064 7269 7665 206e ates the drive n │ │ │ │ │ +00005070: 756d 6265 722c 2074 6861 7420 6973 2c20 umber, that is, │ │ │ │ │ +00005080: 7468 6520 6669 7273 7420 6861 7264 2064 the first hard d │ │ │ │ │ +00005090: 6973 6b2c 2074 6865 2073 7472 696e 670a isk, the string. │ │ │ │ │ +000050a0: 276d 7364 6f73 2720 696e 6469 6361 7465 'msdos' indicate │ │ │ │ │ +000050b0: 7320 7468 6520 7061 7274 6974 696f 6e20 s the partition │ │ │ │ │ +000050c0: 7363 6865 6d65 2c20 7768 696c 6520 7468 scheme, while th │ │ │ │ │ +000050d0: 6520 7365 636f 6e64 2069 6e74 6567 6572 e second integer │ │ │ │ │ +000050e0: 2c20 2732 272c 0a69 6e64 6963 6174 6573 , '2',.indicates │ │ │ │ │ +000050f0: 2074 6865 2070 6172 7469 7469 6f6e 206e the partition n │ │ │ │ │ +00005100: 756d 6265 7220 286f 7220 7468 6520 5043 umber (or the PC │ │ │ │ │ +00005110: 2073 6c69 6365 206e 756d 6265 7220 696e slice number in │ │ │ │ │ +00005120: 2074 6865 2042 5344 0a74 6572 6d69 6e6f the BSD.termino │ │ │ │ │ +00005130: 6c6f 6779 292e 2020 5468 6520 7061 7274 logy). The part │ │ │ │ │ +00005140: 6974 696f 6e20 6e75 6d62 6572 7320 6172 ition numbers ar │ │ │ │ │ +00005150: 6520 636f 756e 7465 6420 6672 6f6d 205f e counted from _ │ │ │ │ │ +00005160: 6f6e 655f 2c20 6e6f 7420 6672 6f6d 0a7a one_, not from.z │ │ │ │ │ +00005170: 6572 6f20 2861 7320 7761 7320 7468 6520 ero (as was the │ │ │ │ │ +00005180: 6361 7365 2069 6e20 7072 6576 696f 7573 case in previous │ │ │ │ │ +00005190: 2076 6572 7369 6f6e 7320 6f66 2047 5255 versions of GRU │ │ │ │ │ +000051a0: 4229 2e20 5468 6973 2065 7870 7265 7373 B). This express │ │ │ │ │ +000051b0: 696f 6e0a 6d65 616e 7320 7468 6520 7365 ion.means the se │ │ │ │ │ +000051c0: 636f 6e64 2070 6172 7469 7469 6f6e 206f cond partition o │ │ │ │ │ +000051d0: 6620 7468 6520 6669 7273 7420 6861 7264 f the first hard │ │ │ │ │ +000051e0: 2064 6973 6b20 6472 6976 652e 2020 496e disk drive. In │ │ │ │ │ +000051f0: 2074 6869 7320 6361 7365 2c0a 4752 5542 this case,.GRUB │ │ │ │ │ +00005200: 2075 7365 7320 6f6e 6520 7061 7274 6974 uses one partit │ │ │ │ │ +00005210: 696f 6e20 6f66 2074 6865 2064 6973 6b2c ion of the disk, │ │ │ │ │ +00005220: 2069 6e73 7465 6164 206f 6620 7468 6520 instead of the │ │ │ │ │ +00005230: 7768 6f6c 6520 6469 736b 2e0a 0a20 2020 whole disk... │ │ │ │ │ +00005240: 2020 2868 6430 2c6d 7364 6f73 3529 0a0a (hd0,msdos5).. │ │ │ │ │ +00005250: 2020 2054 6869 7320 7370 6563 6966 6965 This specifie │ │ │ │ │ +00005260: 7320 7468 6520 6669 7273 7420 2265 7874 s the first "ext │ │ │ │ │ +00005270: 656e 6465 6420 7061 7274 6974 696f 6e22 ended partition" │ │ │ │ │ +00005280: 206f 6620 7468 6520 6669 7273 7420 6861 of the first ha │ │ │ │ │ +00005290: 7264 2064 6973 6b0a 6472 6976 652e 2020 rd disk.drive. │ │ │ │ │ +000052a0: 4e6f 7465 2074 6861 7420 7468 6520 7061 Note that the pa │ │ │ │ │ +000052b0: 7274 6974 696f 6e20 6e75 6d62 6572 7320 rtition numbers │ │ │ │ │ +000052c0: 666f 7220 6578 7465 6e64 6564 2070 6172 for extended par │ │ │ │ │ +000052d0: 7469 7469 6f6e 7320 6172 650a 636f 756e titions are.coun │ │ │ │ │ +000052e0: 7465 6420 6672 6f6d 2027 3527 2c20 7265 ted from '5', re │ │ │ │ │ +000052f0: 6761 7264 6c65 7373 206f 6620 7468 6520 gardless of the │ │ │ │ │ +00005300: 6163 7475 616c 206e 756d 6265 7220 6f66 actual number of │ │ │ │ │ +00005310: 2070 7269 6d61 7279 2070 6172 7469 7469 primary partiti │ │ │ │ │ +00005320: 6f6e 730a 6f6e 2079 6f75 7220 6861 7264 ons.on your hard │ │ │ │ │ +00005330: 2064 6973 6b2e 0a0a 2020 2020 2028 6864 disk... (hd │ │ │ │ │ +00005340: 312c 6d73 646f 7331 2c62 7364 3129 0a0a 1,msdos1,bsd1).. │ │ │ │ │ +00005350: 2020 2054 6869 7320 6d65 616e 7320 7468 This means th │ │ │ │ │ +00005360: 6520 4253 4420 2761 2720 7061 7274 6974 e BSD 'a' partit │ │ │ │ │ +00005370: 696f 6e20 6f6e 2066 6972 7374 2050 4320 ion on first PC │ │ │ │ │ +00005380: 736c 6963 6520 6e75 6d62 6572 206f 6620 slice number of │ │ │ │ │ +00005390: 7468 650a 7365 636f 6e64 2068 6172 6420 the.second hard │ │ │ │ │ +000053a0: 6469 736b 2e0a 0a20 2020 4f66 2063 6f75 disk... Of cou │ │ │ │ │ +000053b0: 7273 652c 2074 6f20 6163 7475 616c 6c79 rse, to actually │ │ │ │ │ +000053c0: 2061 6363 6573 7320 7468 6520 6469 736b access the disk │ │ │ │ │ +000053d0: 7320 6f72 2070 6172 7469 7469 6f6e 7320 s or partitions │ │ │ │ │ +000053e0: 7769 7468 2047 5255 422c 2079 6f75 0a6e with GRUB, you.n │ │ │ │ │ +000053f0: 6565 6420 746f 2075 7365 2074 6865 2064 eed to use the d │ │ │ │ │ +00005400: 6576 6963 6520 7370 6563 6966 6963 6174 evice specificat │ │ │ │ │ +00005410: 696f 6e20 696e 2061 2063 6f6d 6d61 6e64 ion in a command │ │ │ │ │ +00005420: 2c20 6c69 6b65 2027 7365 7420 726f 6f74 , like 'set root │ │ │ │ │ +00005430: 3d28 6664 3029 270a 6f72 2027 7061 7274 =(fd0)'.or 'part │ │ │ │ │ +00005440: 746f 6f6c 2028 6864 302c 6d73 646f 7333 tool (hd0,msdos3 │ │ │ │ │ +00005450: 2920 6869 6464 656e 2d27 2e20 2054 6f20 ) hidden-'. To │ │ │ │ │ +00005460: 6865 6c70 2079 6f75 2066 696e 6420 6f75 help you find ou │ │ │ │ │ +00005470: 7420 7768 6963 6820 6e75 6d62 6572 0a73 t which number.s │ │ │ │ │ +00005480: 7065 6369 6669 6573 2061 2070 6172 7469 pecifies a parti │ │ │ │ │ +00005490: 7469 6f6e 2079 6f75 2077 616e 742c 2074 tion you want, t │ │ │ │ │ +000054a0: 6865 2047 5255 4220 636f 6d6d 616e 642d he GRUB command- │ │ │ │ │ +000054b0: 6c69 6e65 2028 2a6e 6f74 650a 436f 6d6d line (*note.Comm │ │ │ │ │ +000054c0: 616e 642d 6c69 6e65 2069 6e74 6572 6661 and-line interfa │ │ │ │ │ +000054d0: 6365 3a3a 2920 6f70 7469 6f6e 7320 6861 ce::) options ha │ │ │ │ │ +000054e0: 7665 2061 7267 756d 656e 7420 636f 6d70 ve argument comp │ │ │ │ │ +000054f0: 6c65 7469 6f6e 2e20 2054 6869 7320 6d65 letion. This me │ │ │ │ │ +00005500: 616e 730a 7468 6174 2c20 666f 7220 6578 ans.that, for ex │ │ │ │ │ +00005510: 616d 706c 652c 2079 6f75 206f 6e6c 7920 ample, you only │ │ │ │ │ +00005520: 6e65 6564 2074 6f20 7479 7065 0a0a 2020 need to type.. │ │ │ │ │ +00005530: 2020 2073 6574 2072 6f6f 743d 280a 0a20 set root=(.. │ │ │ │ │ +00005540: 2020 666f 6c6c 6f77 6564 2062 7920 6120 followed by a │ │ │ │ │ +00005550: 3c54 4142 3e2c 2061 6e64 2047 5255 4220 , and GRUB │ │ │ │ │ +00005560: 7769 6c6c 2064 6973 706c 6179 2074 6865 will display the │ │ │ │ │ +00005570: 206c 6973 7420 6f66 2064 7269 7665 732c list of drives, │ │ │ │ │ +00005580: 0a70 6172 7469 7469 6f6e 732c 206f 7220 .partitions, or │ │ │ │ │ +00005590: 6669 6c65 206e 616d 6573 2e20 2053 6f20 file names. So │ │ │ │ │ +000055a0: 6974 2073 686f 756c 6420 6265 2071 7569 it should be qui │ │ │ │ │ +000055b0: 7465 2065 6173 7920 746f 2064 6574 6572 te easy to deter │ │ │ │ │ +000055c0: 6d69 6e65 2074 6865 0a6e 616d 6520 6f66 mine the.name of │ │ │ │ │ +000055d0: 2079 6f75 7220 7461 7267 6574 2070 6172 your target par │ │ │ │ │ +000055e0: 7469 7469 6f6e 2c20 6576 656e 2077 6974 tition, even wit │ │ │ │ │ +000055f0: 6820 6d69 6e69 6d61 6c20 6b6e 6f77 6c65 h minimal knowle │ │ │ │ │ +00005600: 6467 6520 6f66 2074 6865 0a73 796e 7461 dge of the.synta │ │ │ │ │ +00005610: 782e 0a0a 2020 204e 6f74 6520 7468 6174 x... Note that │ │ │ │ │ +00005620: 2047 5255 4220 646f 6573 205f 6e6f 745f GRUB does _not_ │ │ │ │ │ +00005630: 2064 6973 7469 6e67 7569 7368 2049 4445 distinguish IDE │ │ │ │ │ +00005640: 2066 726f 6d20 5343 5349 202d 2069 7420 from SCSI - it │ │ │ │ │ +00005650: 7369 6d70 6c79 0a63 6f75 6e74 7320 7468 simply.counts th │ │ │ │ │ +00005660: 6520 6472 6976 6520 6e75 6d62 6572 7320 e drive numbers │ │ │ │ │ +00005670: 6672 6f6d 207a 6572 6f2c 2072 6567 6172 from zero, regar │ │ │ │ │ +00005680: 646c 6573 7320 6f66 2074 6865 6972 2074 dless of their t │ │ │ │ │ +00005690: 7970 652e 2020 4e6f 726d 616c 6c79 2c0a ype. Normally,. │ │ │ │ │ +000056a0: 616e 7920 4944 4520 6472 6976 6520 6e75 any IDE drive nu │ │ │ │ │ +000056b0: 6d62 6572 2069 7320 6c65 7373 2074 6861 mber is less tha │ │ │ │ │ +000056c0: 6e20 616e 7920 5343 5349 2064 7269 7665 n any SCSI drive │ │ │ │ │ +000056d0: 206e 756d 6265 722c 2061 6c74 686f 7567 number, althoug │ │ │ │ │ +000056e0: 6820 7468 6174 0a69 7320 6e6f 7420 7472 h that.is not tr │ │ │ │ │ +000056f0: 7565 2069 6620 796f 7520 6368 616e 6765 ue if you change │ │ │ │ │ +00005700: 2074 6865 2062 6f6f 7420 7365 7175 656e the boot sequen │ │ │ │ │ +00005710: 6365 2062 7920 7377 6170 7069 6e67 2049 ce by swapping I │ │ │ │ │ +00005720: 4445 2061 6e64 2053 4353 490a 6472 6976 DE and SCSI.driv │ │ │ │ │ +00005730: 6573 2069 6e20 796f 7572 2042 494f 532e es in your BIOS. │ │ │ │ │ +00005740: 0a0a 2020 204e 6f77 2074 6865 2071 7565 .. Now the que │ │ │ │ │ +00005750: 7374 696f 6e20 6973 2c20 686f 7720 746f stion is, how to │ │ │ │ │ +00005760: 2073 7065 6369 6679 2061 2066 696c 653f specify a file? │ │ │ │ │ +00005770: 2020 4167 6169 6e2c 2063 6f6e 7369 6465 Again, conside │ │ │ │ │ +00005780: 7220 616e 0a65 7861 6d70 6c65 3a0a 0a20 r an.example:.. │ │ │ │ │ +00005790: 2020 2020 2868 6430 2c6d 7364 6f73 3129 (hd0,msdos1) │ │ │ │ │ +000057a0: 2f76 6d6c 696e 757a 0a0a 2020 2054 6869 /vmlinuz.. Thi │ │ │ │ │ +000057b0: 7320 7370 6563 6966 6965 7320 7468 6520 s specifies the │ │ │ │ │ +000057c0: 6669 6c65 206e 616d 6564 2027 766d 6c69 file named 'vmli │ │ │ │ │ +000057d0: 6e75 7a27 2c20 666f 756e 6420 6f6e 2074 nuz', found on t │ │ │ │ │ +000057e0: 6865 2066 6972 7374 2070 6172 7469 7469 he first partiti │ │ │ │ │ +000057f0: 6f6e 0a6f 6620 7468 6520 6669 7273 7420 on.of the first │ │ │ │ │ +00005800: 6861 7264 2064 6973 6b20 6472 6976 652e hard disk drive. │ │ │ │ │ +00005810: 2020 4e6f 7465 2074 6861 7420 7468 6520 Note that the │ │ │ │ │ +00005820: 6172 6775 6d65 6e74 2063 6f6d 706c 6574 argument complet │ │ │ │ │ +00005830: 696f 6e20 776f 726b 730a 7769 7468 2066 ion works.with f │ │ │ │ │ +00005840: 696c 6520 6e61 6d65 732c 2074 6f6f 2e0a ile names, too.. │ │ │ │ │ +00005850: 0a20 2020 5468 6174 2077 6173 2065 6173 . That was eas │ │ │ │ │ +00005860: 792c 2061 646d 6974 2069 742e 2020 4e6f y, admit it. No │ │ │ │ │ +00005870: 7720 7265 6164 2074 6865 206e 6578 7420 w read the next │ │ │ │ │ +00005880: 6368 6170 7465 722c 2074 6f20 6669 6e64 chapter, to find │ │ │ │ │ +00005890: 206f 7574 2068 6f77 0a74 6f20 6163 7475 out how.to actu │ │ │ │ │ +000058a0: 616c 6c79 2069 6e73 7461 6c6c 2047 5255 ally install GRU │ │ │ │ │ +000058b0: 4220 6f6e 2079 6f75 7220 6472 6976 652e B on your drive. │ │ │ │ │ +000058c0: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ +000058d0: 6e66 6f2c 2020 4e6f 6465 3a20 4f53 2d73 nfo, Node: OS-s │ │ │ │ │ +000058e0: 7065 6369 6669 6320 6e6f 7465 7320 6162 pecific notes ab │ │ │ │ │ +000058f0: 6f75 7420 6772 7562 2074 6f6f 6c73 2c20 out grub tools, │ │ │ │ │ +00005900: 204e 6578 743a 2049 6e73 7461 6c6c 6174 Next: Installat │ │ │ │ │ +00005910: 696f 6e2c 2020 5072 6576 3a20 4e61 6d69 ion, Prev: Nami │ │ │ │ │ +00005920: 6e67 2063 6f6e 7665 6e74 696f 6e2c 2020 ng convention, │ │ │ │ │ +00005930: 5570 3a20 546f 700a 0a33 204f 532d 7370 Up: Top..3 OS-sp │ │ │ │ │ +00005940: 6563 6966 6963 206e 6f74 6573 2061 626f ecific notes abo │ │ │ │ │ +00005950: 7574 2067 7275 6220 746f 6f6c 730a 2a2a ut grub tools.** │ │ │ │ │ 00005960: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ 00005970: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -00005980: 2a2a 2a2a 0a0a 4f6e 204f 5320 7768 6963 ****..On OS whic │ │ │ │ │ -00005990: 6820 6861 7665 2064 6576 6963 6520 6e6f h have device no │ │ │ │ │ -000059a0: 6465 7320 7369 6d69 6c61 7220 746f 2055 des similar to U │ │ │ │ │ -000059b0: 6e69 782d 6c69 6b65 204f 5320 4752 5542 nix-like OS GRUB │ │ │ │ │ -000059c0: 2074 6f6f 6c73 2075 7365 2074 6865 0a4f tools use the.O │ │ │ │ │ -000059d0: 5320 6e61 6d65 2e20 2045 2e67 2e20 2066 S name. E.g. f │ │ │ │ │ -000059e0: 6f72 2047 4e55 2f4c 696e 7578 3a0a 0a20 or GNU/Linux:.. │ │ │ │ │ -000059f0: 2020 2020 2320 6772 7562 2d69 6e73 7461 # grub-insta │ │ │ │ │ -00005a00: 6c6c 202f 6465 762f 7364 610a 0a20 2020 ll /dev/sda.. │ │ │ │ │ -00005a10: 4f6e 2041 524f 5320 7765 2075 7365 2061 On AROS we use a │ │ │ │ │ -00005a20: 6e6f 7468 6572 2073 796e 7461 782e 2020 nother syntax. │ │ │ │ │ -00005a30: 466f 7220 766f 6c75 6d65 733a 0a0a 2020 For volumes:.. │ │ │ │ │ -00005a40: 2020 202f 2f3a 3c76 6f6c 756d 6520 6e61 //:.. E.g... │ │ │ │ │ -00005a60: 2020 202f 2f3a 4448 300a 0a20 2020 466f //:DH0.. Fo │ │ │ │ │ -00005a70: 7220 6469 736b 7320 7765 2075 7365 2073 r disks we use s │ │ │ │ │ -00005a80: 796e 7461 783a 0a20 2020 2020 2f2f 3a3c yntax:. //:< │ │ │ │ │ -00005a90: 6472 6976 6572 206e 616d 653e 2f75 6e69 driver name>/uni │ │ │ │ │ -00005aa0: 742f 666c 6167 730a 0a20 2020 452e 672e t/flags.. E.g. │ │ │ │ │ -00005ab0: 0a0a 2020 2020 2023 2067 7275 622d 696e .. # grub-in │ │ │ │ │ -00005ac0: 7374 616c 6c20 2f2f 3a61 7461 2e64 6576 stall //:ata.dev │ │ │ │ │ -00005ad0: 6963 652f 302f 300a 0a20 2020 4f6e 2057 ice/0/0.. On W │ │ │ │ │ -00005ae0: 696e 646f 7773 2077 6520 7573 6520 554e indows we use UN │ │ │ │ │ -00005af0: 4320 7061 7468 2e20 2046 6f72 2076 6f6c C path. For vol │ │ │ │ │ -00005b00: 756d 6573 2069 7427 7320 7479 7069 6361 umes it's typica │ │ │ │ │ -00005b10: 6c6c 790a 0a20 2020 2020 5c5c 3f5c 566f lly.. \\?\Vo │ │ │ │ │ -00005b20: 6c75 6d65 7b3c 4755 4944 3e7d 0a20 2020 lume{}. │ │ │ │ │ -00005b30: 2020 5c5c 3f5c 3c64 7269 7665 206c 6574 \\?\:.. E.g... │ │ │ │ │ -00005b50: 2020 2020 205c 5c3f 5c56 6f6c 756d 657b \\?\Volume{ │ │ │ │ │ -00005b60: 3137 6633 3464 3530 2d63 6636 342d 3462 17f34d50-cf64-4b │ │ │ │ │ -00005b70: 3032 2d38 3030 652d 3531 6437 3963 3361 02-800e-51d79c3a │ │ │ │ │ -00005b80: 6132 6666 7d0a 2020 2020 205c 5c3f 5c43 a2ff}. \\?\C │ │ │ │ │ -00005b90: 3a0a 0a20 2020 466f 7220 6469 736b 7320 :.. For disks │ │ │ │ │ -00005ba0: 6974 2773 0a0a 2020 2020 205c 5c3f 5c50 it's.. \\?\P │ │ │ │ │ -00005bb0: 6879 7369 6361 6c44 7269 7665 3c6e 756d hysicalDrive.. E.g... │ │ │ │ │ -00005bd0: 2020 2020 2320 6772 7562 2d69 6e73 7461 # grub-insta │ │ │ │ │ -00005be0: 6c6c 205c 5c3f 5c50 6879 7369 6361 6c44 ll \\?\PhysicalD │ │ │ │ │ -00005bf0: 7269 7665 300a 0a20 2020 4265 7761 7265 rive0.. Beware │ │ │ │ │ -00005c00: 2074 6861 7420 796f 7520 6d61 7920 6e65 that you may ne │ │ │ │ │ -00005c10: 6564 2074 6f20 6675 7274 6865 7220 6573 ed to further es │ │ │ │ │ -00005c20: 6361 7065 2074 6865 2062 6163 6b73 6c61 cape the backsla │ │ │ │ │ -00005c30: 7368 6573 2064 6570 656e 6469 6e67 0a6f shes depending.o │ │ │ │ │ -00005c40: 6e20 796f 7572 2073 6865 6c6c 2e0a 0a20 n your shell... │ │ │ │ │ -00005c50: 2020 5768 656e 2063 6f6d 7069 6c65 6420 When compiled │ │ │ │ │ -00005c60: 7769 7468 2063 7967 7769 6e20 7375 7070 with cygwin supp │ │ │ │ │ -00005c70: 6f72 7420 7468 656e 2063 7967 7769 6e20 ort then cygwin │ │ │ │ │ -00005c80: 6472 6976 6520 6e61 6d65 7320 6172 650a drive names are. │ │ │ │ │ -00005c90: 6175 746f 6d61 7469 6361 6c6c 7920 7768 automatically wh │ │ │ │ │ -00005ca0: 656e 206e 6565 6465 642e 2020 452e 672e en needed. E.g. │ │ │ │ │ -00005cb0: 0a0a 2020 2020 2023 2067 7275 622d 696e .. # grub-in │ │ │ │ │ -00005cc0: 7374 616c 6c20 2f64 6576 2f73 6461 0a0a stall /dev/sda.. │ │ │ │ │ -00005cd0: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ -00005ce0: 6f2c 2020 4e6f 6465 3a20 496e 7374 616c o, Node: Instal │ │ │ │ │ -00005cf0: 6c61 7469 6f6e 2c20 204e 6578 743a 2042 lation, Next: B │ │ │ │ │ -00005d00: 6f6f 7469 6e67 2c20 2050 7265 763a 204f ooting, Prev: O │ │ │ │ │ -00005d10: 532d 7370 6563 6966 6963 206e 6f74 6573 S-specific notes │ │ │ │ │ -00005d20: 2061 626f 7574 2067 7275 6220 746f 6f6c about grub tool │ │ │ │ │ -00005d30: 732c 2020 5570 3a20 546f 700a 0a34 2049 s, Up: Top..4 I │ │ │ │ │ -00005d40: 6e73 7461 6c6c 6174 696f 6e0a 2a2a 2a2a nstallation.**** │ │ │ │ │ -00005d50: 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a 496e 206f **********..In o │ │ │ │ │ -00005d60: 7264 6572 2074 6f20 696e 7374 616c 6c20 rder to install │ │ │ │ │ -00005d70: 4752 5542 2061 7320 796f 7572 2062 6f6f GRUB as your boo │ │ │ │ │ -00005d80: 7420 6c6f 6164 6572 2c20 796f 7520 6e65 t loader, you ne │ │ │ │ │ -00005d90: 6564 2074 6f20 6669 7273 7420 696e 7374 ed to first inst │ │ │ │ │ -00005da0: 616c 6c0a 7468 6520 4752 5542 2073 7973 all.the GRUB sys │ │ │ │ │ -00005db0: 7465 6d20 616e 6420 7574 696c 6974 6965 tem and utilitie │ │ │ │ │ -00005dc0: 7320 756e 6465 7220 796f 7572 2055 4e49 s under your UNI │ │ │ │ │ -00005dd0: 582d 6c69 6b65 206f 7065 7261 7469 6e67 X-like operating │ │ │ │ │ -00005de0: 2073 7973 7465 6d0a 282a 6e6f 7465 204f system.(*note O │ │ │ │ │ -00005df0: 6274 6169 6e69 6e67 2061 6e64 2042 7569 btaining and Bui │ │ │ │ │ -00005e00: 6c64 696e 6720 4752 5542 3a3a 292e 2020 lding GRUB::). │ │ │ │ │ -00005e10: 596f 7520 6361 6e20 646f 2074 6869 7320 You can do this │ │ │ │ │ -00005e20: 6569 7468 6572 2066 726f 6d20 7468 650a either from the. │ │ │ │ │ -00005e30: 736f 7572 6365 2074 6172 6261 6c6c 2c20 source tarball, │ │ │ │ │ -00005e40: 6f72 2061 7320 6120 7061 636b 6167 6520 or as a package │ │ │ │ │ -00005e50: 666f 7220 796f 7572 204f 532e 0a0a 2020 for your OS... │ │ │ │ │ -00005e60: 2041 6674 6572 2079 6f75 2068 6176 6520 After you have │ │ │ │ │ -00005e70: 646f 6e65 2074 6861 742c 2079 6f75 206e done that, you n │ │ │ │ │ -00005e80: 6565 6420 746f 2069 6e73 7461 6c6c 2074 eed to install t │ │ │ │ │ -00005e90: 6865 2062 6f6f 7420 6c6f 6164 6572 206f he boot loader o │ │ │ │ │ -00005ea0: 6e20 610a 6472 6976 6520 2866 6c6f 7070 n a.drive (flopp │ │ │ │ │ -00005eb0: 7920 6f72 2068 6172 6420 6469 736b 2920 y or hard disk) │ │ │ │ │ -00005ec0: 6279 2075 7369 6e67 2074 6865 2075 7469 by using the uti │ │ │ │ │ -00005ed0: 6c69 7479 2027 6772 7562 2d69 6e73 7461 lity 'grub-insta │ │ │ │ │ -00005ee0: 6c6c 2720 282a 6e6f 7465 0a49 6e76 6f6b ll' (*note.Invok │ │ │ │ │ -00005ef0: 696e 6720 6772 7562 2d69 6e73 7461 6c6c ing grub-install │ │ │ │ │ -00005f00: 3a3a 2920 6f6e 2061 2055 4e49 582d 6c69 ::) on a UNIX-li │ │ │ │ │ -00005f10: 6b65 204f 532e 0a0a 2020 2047 5255 4220 ke OS... GRUB │ │ │ │ │ -00005f20: 636f 6d65 7320 7769 7468 2062 6f6f 7420 comes with boot │ │ │ │ │ -00005f30: 696d 6167 6573 2c20 7768 6963 6820 6172 images, which ar │ │ │ │ │ -00005f40: 6520 6e6f 726d 616c 6c79 2070 7574 2069 e normally put i │ │ │ │ │ -00005f50: 6e20 7468 6520 6469 7265 6374 6f72 790a n the directory. │ │ │ │ │ -00005f60: 272f 7573 722f 6c69 622f 6772 7562 2f3c '/usr/lib/grub/< │ │ │ │ │ -00005f70: 6370 753e 2d3c 706c 6174 666f 726d 3e27 cpu>-' │ │ │ │ │ -00005f80: 2028 666f 7220 4249 4f53 2d62 6173 6564 (for BIOS-based │ │ │ │ │ -00005f90: 206d 6163 6869 6e65 730a 272f 7573 722f machines.'/usr/ │ │ │ │ │ -00005fa0: 6c69 622f 6772 7562 2f69 3338 362d 7063 lib/grub/i386-pc │ │ │ │ │ -00005fb0: 2729 2e20 2048 6572 6561 6674 6572 2c20 '). Hereafter, │ │ │ │ │ -00005fc0: 7468 6520 6469 7265 6374 6f72 7920 7768 the directory wh │ │ │ │ │ -00005fd0: 6572 6520 4752 5542 2069 6d61 6765 730a ere GRUB images. │ │ │ │ │ -00005fe0: 6172 6520 696e 6974 6961 6c6c 7920 706c are initially pl │ │ │ │ │ -00005ff0: 6163 6564 2028 6e6f 726d 616c 6c79 2027 aced (normally ' │ │ │ │ │ -00006000: 2f75 7372 2f6c 6962 2f67 7275 622f 3c63 /usr/lib/grub/-') │ │ │ │ │ -00006020: 2077 696c 6c20 6265 0a63 616c 6c65 6420 will be.called │ │ │ │ │ -00006030: 7468 6520 2269 6d61 6765 2064 6972 6563 the "image direc │ │ │ │ │ -00006040: 746f 7279 222c 2061 6e64 2074 6865 2064 tory", and the d │ │ │ │ │ -00006050: 6972 6563 746f 7279 2077 6865 7265 2074 irectory where t │ │ │ │ │ -00006060: 6865 2062 6f6f 7420 6c6f 6164 6572 0a6e he boot loader.n │ │ │ │ │ -00006070: 6565 6473 2074 6f20 6669 6e64 2074 6865 eeds to find the │ │ │ │ │ -00006080: 6d20 2875 7375 616c 6c79 2027 2f62 6f6f m (usually '/boo │ │ │ │ │ -00006090: 7427 2920 7769 6c6c 2062 6520 6361 6c6c t') will be call │ │ │ │ │ -000060a0: 6564 2074 6865 2022 626f 6f74 0a64 6972 ed the "boot.dir │ │ │ │ │ -000060b0: 6563 746f 7279 222e 0a0a 2a20 4d65 6e75 ectory"...* Menu │ │ │ │ │ -000060c0: 3a0a 0a2a 2049 6e73 7461 6c6c 696e 6720 :..* Installing │ │ │ │ │ -000060d0: 4752 5542 2075 7369 6e67 2067 7275 622d GRUB using grub- │ │ │ │ │ -000060e0: 696e 7374 616c 6c3a 3a0a 2a20 4d61 6b69 install::.* Maki │ │ │ │ │ -000060f0: 6e67 2061 2047 5255 4220 626f 6f74 6162 ng a GRUB bootab │ │ │ │ │ -00006100: 6c65 2043 442d 524f 4d3a 3a0a 2a20 4465 le CD-ROM::.* De │ │ │ │ │ -00006110: 7669 6365 206d 6170 3a3a 0a2a 2042 494f vice map::.* BIO │ │ │ │ │ -00006120: 5320 696e 7374 616c 6c61 7469 6f6e 3a3a S installation:: │ │ │ │ │ -00006130: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ -00006140: 6e66 6f2c 2020 4e6f 6465 3a20 496e 7374 nfo, Node: Inst │ │ │ │ │ -00006150: 616c 6c69 6e67 2047 5255 4220 7573 696e alling GRUB usin │ │ │ │ │ -00006160: 6720 6772 7562 2d69 6e73 7461 6c6c 2c20 g grub-install, │ │ │ │ │ -00006170: 204e 6578 743a 204d 616b 696e 6720 6120 Next: Making a │ │ │ │ │ -00006180: 4752 5542 2062 6f6f 7461 626c 6520 4344 GRUB bootable CD │ │ │ │ │ -00006190: 2d52 4f4d 2c20 2055 703a 2049 6e73 7461 -ROM, Up: Insta │ │ │ │ │ -000061a0: 6c6c 6174 696f 6e0a 0a34 2e31 2049 6e73 llation..4.1 Ins │ │ │ │ │ -000061b0: 7461 6c6c 696e 6720 4752 5542 2075 7369 talling GRUB usi │ │ │ │ │ -000061c0: 6e67 2067 7275 622d 696e 7374 616c 6c0a ng grub-install. │ │ │ │ │ +00005980: 2a2a 0a0a 4f6e 204f 5320 7768 6963 6820 **..On OS which │ │ │ │ │ +00005990: 6861 7665 2064 6576 6963 6520 6e6f 6465 have device node │ │ │ │ │ +000059a0: 7320 7369 6d69 6c61 7220 746f 2055 6e69 s similar to Uni │ │ │ │ │ +000059b0: 782d 6c69 6b65 204f 5320 4752 5542 2074 x-like OS GRUB t │ │ │ │ │ +000059c0: 6f6f 6c73 2075 7365 2074 6865 0a4f 5320 ools use the.OS │ │ │ │ │ +000059d0: 6e61 6d65 2e20 2045 2e67 2e20 2066 6f72 name. E.g. for │ │ │ │ │ +000059e0: 2047 4e55 2f4c 696e 7578 3a0a 0a20 2020 GNU/Linux:.. │ │ │ │ │ +000059f0: 2020 2320 6772 7562 2d69 6e73 7461 6c6c # grub-install │ │ │ │ │ +00005a00: 202f 6465 762f 7364 610a 0a20 2020 4f6e /dev/sda.. On │ │ │ │ │ +00005a10: 2041 524f 5320 7765 2075 7365 2061 6e6f AROS we use ano │ │ │ │ │ +00005a20: 7468 6572 2073 796e 7461 782e 2020 466f ther syntax. Fo │ │ │ │ │ +00005a30: 7220 766f 6c75 6d65 733a 0a0a 2020 2020 r volumes:.. │ │ │ │ │ +00005a40: 202f 2f3a 3c76 6f6c 756d 6520 6e61 6d65 //:.. E.g... │ │ │ │ │ +00005a60: 202f 2f3a 4448 300a 0a20 2020 466f 7220 //:DH0.. For │ │ │ │ │ +00005a70: 6469 736b 7320 7765 2075 7365 2073 796e disks we use syn │ │ │ │ │ +00005a80: 7461 783a 0a20 2020 2020 2f2f 3a3c 6472 tax:. //:/unit/ │ │ │ │ │ +00005aa0: 666c 6167 730a 0a20 2020 452e 672e 0a0a flags.. E.g... │ │ │ │ │ +00005ab0: 2020 2020 2023 2067 7275 622d 696e 7374 # grub-inst │ │ │ │ │ +00005ac0: 616c 6c20 2f2f 3a61 7461 2e64 6576 6963 all //:ata.devic │ │ │ │ │ +00005ad0: 652f 302f 300a 0a20 2020 4f6e 2057 696e e/0/0.. On Win │ │ │ │ │ +00005ae0: 646f 7773 2077 6520 7573 6520 554e 4320 dows we use UNC │ │ │ │ │ +00005af0: 7061 7468 2e20 2046 6f72 2076 6f6c 756d path. For volum │ │ │ │ │ +00005b00: 6573 2069 7427 7320 7479 7069 6361 6c6c es it's typicall │ │ │ │ │ +00005b10: 790a 0a20 2020 2020 5c5c 3f5c 566f 6c75 y.. \\?\Volu │ │ │ │ │ +00005b20: 6d65 7b3c 4755 4944 3e7d 0a20 2020 2020 me{}. │ │ │ │ │ +00005b30: 5c5c 3f5c 3c64 7269 7665 206c 6574 7465 \\?\:.. E.g... │ │ │ │ │ +00005b50: 2020 205c 5c3f 5c56 6f6c 756d 657b 3137 \\?\Volume{17 │ │ │ │ │ +00005b60: 6633 3464 3530 2d63 6636 342d 3462 3032 f34d50-cf64-4b02 │ │ │ │ │ +00005b70: 2d38 3030 652d 3531 6437 3963 3361 6132 -800e-51d79c3aa2 │ │ │ │ │ +00005b80: 6666 7d0a 2020 2020 205c 5c3f 5c43 3a0a ff}. \\?\C:. │ │ │ │ │ +00005b90: 0a20 2020 466f 7220 6469 736b 7320 6974 . For disks it │ │ │ │ │ +00005ba0: 2773 0a0a 2020 2020 205c 5c3f 5c50 6879 's.. \\?\Phy │ │ │ │ │ +00005bb0: 7369 6361 6c44 7269 7665 3c6e 756d 6265 sicalDrive.. E.g... │ │ │ │ │ +00005bd0: 2020 2320 6772 7562 2d69 6e73 7461 6c6c # grub-install │ │ │ │ │ +00005be0: 205c 5c3f 5c50 6879 7369 6361 6c44 7269 \\?\PhysicalDri │ │ │ │ │ +00005bf0: 7665 300a 0a20 2020 4265 7761 7265 2074 ve0.. Beware t │ │ │ │ │ +00005c00: 6861 7420 796f 7520 6d61 7920 6e65 6564 hat you may need │ │ │ │ │ +00005c10: 2074 6f20 6675 7274 6865 7220 6573 6361 to further esca │ │ │ │ │ +00005c20: 7065 2074 6865 2062 6163 6b73 6c61 7368 pe the backslash │ │ │ │ │ +00005c30: 6573 2064 6570 656e 6469 6e67 0a6f 6e20 es depending.on │ │ │ │ │ +00005c40: 796f 7572 2073 6865 6c6c 2e0a 0a20 2020 your shell... │ │ │ │ │ +00005c50: 5768 656e 2063 6f6d 7069 6c65 6420 7769 When compiled wi │ │ │ │ │ +00005c60: 7468 2063 7967 7769 6e20 7375 7070 6f72 th cygwin suppor │ │ │ │ │ +00005c70: 7420 7468 656e 2063 7967 7769 6e20 6472 t then cygwin dr │ │ │ │ │ +00005c80: 6976 6520 6e61 6d65 7320 6172 650a 6175 ive names are.au │ │ │ │ │ +00005c90: 746f 6d61 7469 6361 6c6c 7920 7768 656e tomatically when │ │ │ │ │ +00005ca0: 206e 6565 6465 642e 2020 452e 672e 0a0a needed. E.g... │ │ │ │ │ +00005cb0: 2020 2020 2023 2067 7275 622d 696e 7374 # grub-inst │ │ │ │ │ +00005cc0: 616c 6c20 2f64 6576 2f73 6461 0a0a 1f0a all /dev/sda.... │ │ │ │ │ +00005cd0: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ +00005ce0: 2020 4e6f 6465 3a20 496e 7374 616c 6c61 Node: Installa │ │ │ │ │ +00005cf0: 7469 6f6e 2c20 204e 6578 743a 2042 6f6f tion, Next: Boo │ │ │ │ │ +00005d00: 7469 6e67 2c20 2050 7265 763a 204f 532d ting, Prev: OS- │ │ │ │ │ +00005d10: 7370 6563 6966 6963 206e 6f74 6573 2061 specific notes a │ │ │ │ │ +00005d20: 626f 7574 2067 7275 6220 746f 6f6c 732c bout grub tools, │ │ │ │ │ +00005d30: 2020 5570 3a20 546f 700a 0a34 2049 6e73 Up: Top..4 Ins │ │ │ │ │ +00005d40: 7461 6c6c 6174 696f 6e0a 2a2a 2a2a 2a2a tallation.****** │ │ │ │ │ +00005d50: 2a2a 2a2a 2a2a 2a2a 0a0a 496e 206f 7264 ********..In ord │ │ │ │ │ +00005d60: 6572 2074 6f20 696e 7374 616c 6c20 4752 er to install GR │ │ │ │ │ +00005d70: 5542 2061 7320 796f 7572 2062 6f6f 7420 UB as your boot │ │ │ │ │ +00005d80: 6c6f 6164 6572 2c20 796f 7520 6e65 6564 loader, you need │ │ │ │ │ +00005d90: 2074 6f20 6669 7273 7420 696e 7374 616c to first instal │ │ │ │ │ +00005da0: 6c0a 7468 6520 4752 5542 2073 7973 7465 l.the GRUB syste │ │ │ │ │ +00005db0: 6d20 616e 6420 7574 696c 6974 6965 7320 m and utilities │ │ │ │ │ +00005dc0: 756e 6465 7220 796f 7572 2055 4e49 582d under your UNIX- │ │ │ │ │ +00005dd0: 6c69 6b65 206f 7065 7261 7469 6e67 2073 like operating s │ │ │ │ │ +00005de0: 7973 7465 6d0a 282a 6e6f 7465 204f 6274 ystem.(*note Obt │ │ │ │ │ +00005df0: 6169 6e69 6e67 2061 6e64 2042 7569 6c64 aining and Build │ │ │ │ │ +00005e00: 696e 6720 4752 5542 3a3a 292e 2020 596f ing GRUB::). Yo │ │ │ │ │ +00005e10: 7520 6361 6e20 646f 2074 6869 7320 6569 u can do this ei │ │ │ │ │ +00005e20: 7468 6572 2066 726f 6d20 7468 650a 736f ther from the.so │ │ │ │ │ +00005e30: 7572 6365 2074 6172 6261 6c6c 2c20 6f72 urce tarball, or │ │ │ │ │ +00005e40: 2061 7320 6120 7061 636b 6167 6520 666f as a package fo │ │ │ │ │ +00005e50: 7220 796f 7572 204f 532e 0a0a 2020 2041 r your OS... A │ │ │ │ │ +00005e60: 6674 6572 2079 6f75 2068 6176 6520 646f fter you have do │ │ │ │ │ +00005e70: 6e65 2074 6861 742c 2079 6f75 206e 6565 ne that, you nee │ │ │ │ │ +00005e80: 6420 746f 2069 6e73 7461 6c6c 2074 6865 d to install the │ │ │ │ │ +00005e90: 2062 6f6f 7420 6c6f 6164 6572 206f 6e20 boot loader on │ │ │ │ │ +00005ea0: 610a 6472 6976 6520 2866 6c6f 7070 7920 a.drive (floppy │ │ │ │ │ +00005eb0: 6f72 2068 6172 6420 6469 736b 2920 6279 or hard disk) by │ │ │ │ │ +00005ec0: 2075 7369 6e67 2074 6865 2075 7469 6c69 using the utili │ │ │ │ │ +00005ed0: 7479 2027 6772 7562 2d69 6e73 7461 6c6c ty 'grub-install │ │ │ │ │ +00005ee0: 2720 282a 6e6f 7465 0a49 6e76 6f6b 696e ' (*note.Invokin │ │ │ │ │ +00005ef0: 6720 6772 7562 2d69 6e73 7461 6c6c 3a3a g grub-install:: │ │ │ │ │ +00005f00: 2920 6f6e 2061 2055 4e49 582d 6c69 6b65 ) on a UNIX-like │ │ │ │ │ +00005f10: 204f 532e 0a0a 2020 2047 5255 4220 636f OS... GRUB co │ │ │ │ │ +00005f20: 6d65 7320 7769 7468 2062 6f6f 7420 696d mes with boot im │ │ │ │ │ +00005f30: 6167 6573 2c20 7768 6963 6820 6172 6520 ages, which are │ │ │ │ │ +00005f40: 6e6f 726d 616c 6c79 2070 7574 2069 6e20 normally put in │ │ │ │ │ +00005f50: 7468 6520 6469 7265 6374 6f72 790a 272f the directory.'/ │ │ │ │ │ +00005f60: 7573 722f 6c69 622f 6772 7562 2f3c 6370 usr/lib/grub/-' ( │ │ │ │ │ +00005f80: 666f 7220 4249 4f53 2d62 6173 6564 206d for BIOS-based m │ │ │ │ │ +00005f90: 6163 6869 6e65 730a 272f 7573 722f 6c69 achines.'/usr/li │ │ │ │ │ +00005fa0: 622f 6772 7562 2f69 3338 362d 7063 2729 b/grub/i386-pc') │ │ │ │ │ +00005fb0: 2e20 2048 6572 6561 6674 6572 2c20 7468 . Hereafter, th │ │ │ │ │ +00005fc0: 6520 6469 7265 6374 6f72 7920 7768 6572 e directory wher │ │ │ │ │ +00005fd0: 6520 4752 5542 2069 6d61 6765 730a 6172 e GRUB images.ar │ │ │ │ │ +00005fe0: 6520 696e 6974 6961 6c6c 7920 706c 6163 e initially plac │ │ │ │ │ +00005ff0: 6564 2028 6e6f 726d 616c 6c79 2027 2f75 ed (normally '/u │ │ │ │ │ +00006000: 7372 2f6c 6962 2f67 7275 622f 3c63 7075 sr/lib/grub/-') w │ │ │ │ │ +00006020: 696c 6c20 6265 0a63 616c 6c65 6420 7468 ill be.called th │ │ │ │ │ +00006030: 6520 2269 6d61 6765 2064 6972 6563 746f e "image directo │ │ │ │ │ +00006040: 7279 222c 2061 6e64 2074 6865 2064 6972 ry", and the dir │ │ │ │ │ +00006050: 6563 746f 7279 2077 6865 7265 2074 6865 ectory where the │ │ │ │ │ +00006060: 2062 6f6f 7420 6c6f 6164 6572 0a6e 6565 boot loader.nee │ │ │ │ │ +00006070: 6473 2074 6f20 6669 6e64 2074 6865 6d20 ds to find them │ │ │ │ │ +00006080: 2875 7375 616c 6c79 2027 2f62 6f6f 7427 (usually '/boot' │ │ │ │ │ +00006090: 2920 7769 6c6c 2062 6520 6361 6c6c 6564 ) will be called │ │ │ │ │ +000060a0: 2074 6865 2022 626f 6f74 0a64 6972 6563 the "boot.direc │ │ │ │ │ +000060b0: 746f 7279 222e 0a0a 2a20 4d65 6e75 3a0a tory"...* Menu:. │ │ │ │ │ +000060c0: 0a2a 2049 6e73 7461 6c6c 696e 6720 4752 .* Installing GR │ │ │ │ │ +000060d0: 5542 2075 7369 6e67 2067 7275 622d 696e UB using grub-in │ │ │ │ │ +000060e0: 7374 616c 6c3a 3a0a 2a20 4d61 6b69 6e67 stall::.* Making │ │ │ │ │ +000060f0: 2061 2047 5255 4220 626f 6f74 6162 6c65 a GRUB bootable │ │ │ │ │ +00006100: 2043 442d 524f 4d3a 3a0a 2a20 4465 7669 CD-ROM::.* Devi │ │ │ │ │ +00006110: 6365 206d 6170 3a3a 0a2a 2042 494f 5320 ce map::.* BIOS │ │ │ │ │ +00006120: 696e 7374 616c 6c61 7469 6f6e 3a3a 0a0a installation::.. │ │ │ │ │ +00006130: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ +00006140: 6f2c 2020 4e6f 6465 3a20 496e 7374 616c o, Node: Instal │ │ │ │ │ +00006150: 6c69 6e67 2047 5255 4220 7573 696e 6720 ling GRUB using │ │ │ │ │ +00006160: 6772 7562 2d69 6e73 7461 6c6c 2c20 204e grub-install, N │ │ │ │ │ +00006170: 6578 743a 204d 616b 696e 6720 6120 4752 ext: Making a GR │ │ │ │ │ +00006180: 5542 2062 6f6f 7461 626c 6520 4344 2d52 UB bootable CD-R │ │ │ │ │ +00006190: 4f4d 2c20 2055 703a 2049 6e73 7461 6c6c OM, Up: Install │ │ │ │ │ +000061a0: 6174 696f 6e0a 0a34 2e31 2049 6e73 7461 ation..4.1 Insta │ │ │ │ │ +000061b0: 6c6c 696e 6720 4752 5542 2075 7369 6e67 lling GRUB using │ │ │ │ │ +000061c0: 2067 7275 622d 696e 7374 616c 6c0a 3d3d grub-install.== │ │ │ │ │ 000061d0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 000061e0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -000061f0: 3d3d 3d3d 3d3d 0a0a 466f 7220 696e 666f ======..For info │ │ │ │ │ -00006200: 726d 6174 696f 6e20 6f6e 2077 6865 7265 rmation on where │ │ │ │ │ -00006210: 2047 5255 4220 7368 6f75 6c64 2062 6520 GRUB should be │ │ │ │ │ -00006220: 696e 7374 616c 6c65 6420 6f6e 2050 4320 installed on PC │ │ │ │ │ -00006230: 4249 4f53 2070 6c61 7466 6f72 6d73 2c0a BIOS platforms,. │ │ │ │ │ -00006240: 2a6e 6f74 6520 4249 4f53 2069 6e73 7461 *note BIOS insta │ │ │ │ │ -00006250: 6c6c 6174 696f 6e3a 3a2e 0a0a 2020 2049 llation::... I │ │ │ │ │ -00006260: 6e20 6f72 6465 7220 746f 2069 6e73 7461 n order to insta │ │ │ │ │ -00006270: 6c6c 2047 5255 4220 756e 6465 7220 6120 ll GRUB under a │ │ │ │ │ -00006280: 554e 4958 2d6c 696b 6520 4f53 2028 7375 UNIX-like OS (su │ │ │ │ │ -00006290: 6368 2061 7320 474e 5529 2c20 696e 766f ch as GNU), invo │ │ │ │ │ -000062a0: 6b65 0a74 6865 2070 726f 6772 616d 2027 ke.the program ' │ │ │ │ │ -000062b0: 6772 7562 2d69 6e73 7461 6c6c 2720 282a grub-install' (* │ │ │ │ │ -000062c0: 6e6f 7465 2049 6e76 6f6b 696e 6720 6772 note Invoking gr │ │ │ │ │ -000062d0: 7562 2d69 6e73 7461 6c6c 3a3a 2920 6173 ub-install::) as │ │ │ │ │ -000062e0: 2074 6865 0a73 7570 6572 7573 6572 2028 the.superuser ( │ │ │ │ │ -000062f0: 2272 6f6f 7422 292e 0a0a 2020 2054 6865 "root")... The │ │ │ │ │ -00006300: 2075 7361 6765 2069 7320 6261 7369 6361 usage is basica │ │ │ │ │ -00006310: 6c6c 7920 7665 7279 2073 696d 706c 652e lly very simple. │ │ │ │ │ -00006320: 2020 596f 7520 6f6e 6c79 206e 6565 6420 You only need │ │ │ │ │ -00006330: 746f 2073 7065 6369 6679 206f 6e65 0a61 to specify one.a │ │ │ │ │ -00006340: 7267 756d 656e 7420 746f 2074 6865 2070 rgument to the p │ │ │ │ │ -00006350: 726f 6772 616d 2c20 6e61 6d65 6c79 2c20 rogram, namely, │ │ │ │ │ -00006360: 7768 6572 6520 746f 2069 6e73 7461 6c6c where to install │ │ │ │ │ -00006370: 2074 6865 2062 6f6f 7420 6c6f 6164 6572 the boot loader │ │ │ │ │ -00006380: 2e20 2054 6865 0a61 7267 756d 656e 7420 . The.argument │ │ │ │ │ -00006390: 6861 7320 746f 2062 6520 6569 7468 6572 has to be either │ │ │ │ │ -000063a0: 2061 2064 6576 6963 6520 6669 6c65 2028 a device file ( │ │ │ │ │ -000063b0: 6c69 6b65 2027 2f64 6576 2f68 6461 2729 like '/dev/hda') │ │ │ │ │ -000063c0: 2e20 2046 6f72 2065 7861 6d70 6c65 2c0a . For example,. │ │ │ │ │ -000063d0: 756e 6465 7220 4c69 6e75 7820 7468 6520 under Linux the │ │ │ │ │ -000063e0: 666f 6c6c 6f77 696e 6720 7769 6c6c 2069 following will i │ │ │ │ │ -000063f0: 6e73 7461 6c6c 2047 5255 4220 696e 746f nstall GRUB into │ │ │ │ │ -00006400: 2074 6865 204d 4252 206f 6620 7468 6520 the MBR of the │ │ │ │ │ -00006410: 6669 7273 740a 4944 4520 6469 736b 3a0a first.IDE disk:. │ │ │ │ │ -00006420: 0a20 2020 2020 2320 6772 7562 2d69 6e73 . # grub-ins │ │ │ │ │ -00006430: 7461 6c6c 202f 6465 762f 7364 610a 0a20 tall /dev/sda.. │ │ │ │ │ -00006440: 2020 4c69 6b65 7769 7365 2c20 756e 6465 Likewise, unde │ │ │ │ │ -00006450: 7220 474e 552f 4875 7264 2c20 7468 6973 r GNU/Hurd, this │ │ │ │ │ -00006460: 2068 6173 2074 6865 2073 616d 6520 6566 has the same ef │ │ │ │ │ -00006470: 6665 6374 3a0a 0a20 2020 2020 2320 6772 fect:.. # gr │ │ │ │ │ -00006480: 7562 2d69 6e73 7461 6c6c 202f 6465 762f ub-install /dev/ │ │ │ │ │ -00006490: 6864 300a 0a20 2020 4275 7420 616c 6c20 hd0.. But all │ │ │ │ │ -000064a0: 7468 6520 6162 6f76 6520 6578 616d 706c the above exampl │ │ │ │ │ -000064b0: 6573 2061 7373 756d 6520 7468 6174 2047 es assume that G │ │ │ │ │ -000064c0: 5255 4220 7368 6f75 6c64 2070 7574 2069 RUB should put i │ │ │ │ │ -000064d0: 6d61 6765 7320 756e 6465 720a 7468 6520 mages under.the │ │ │ │ │ -000064e0: 272f 626f 6f74 2720 6469 7265 6374 6f72 '/boot' director │ │ │ │ │ -000064f0: 792e 2020 4966 2079 6f75 2077 616e 7420 y. If you want │ │ │ │ │ -00006500: 4752 5542 2074 6f20 7075 7420 696d 6167 GRUB to put imag │ │ │ │ │ -00006510: 6573 2075 6e64 6572 2061 2064 6972 6563 es under a direc │ │ │ │ │ -00006520: 746f 7279 0a6f 7468 6572 2074 6861 6e20 tory.other than │ │ │ │ │ -00006530: 272f 626f 6f74 272c 2079 6f75 206e 6565 '/boot', you nee │ │ │ │ │ -00006540: 6420 746f 2073 7065 6369 6679 2074 6865 d to specify the │ │ │ │ │ -00006550: 206f 7074 696f 6e20 272d 2d62 6f6f 742d option '--boot- │ │ │ │ │ -00006560: 6469 7265 6374 6f72 7927 2e0a 5468 6520 directory'..The │ │ │ │ │ -00006570: 7479 7069 6361 6c20 7573 6167 6520 6973 typical usage is │ │ │ │ │ -00006580: 2074 6861 7420 796f 7520 6372 6561 7465 that you create │ │ │ │ │ -00006590: 2061 2047 5255 4220 626f 6f74 2066 6c6f a GRUB boot flo │ │ │ │ │ -000065a0: 7070 7920 7769 7468 2061 0a66 696c 6573 ppy with a.files │ │ │ │ │ -000065b0: 7973 7465 6d2e 2020 4865 7265 2069 7320 ystem. Here is │ │ │ │ │ -000065c0: 616e 2065 7861 6d70 6c65 3a0a 0a20 2020 an example:.. │ │ │ │ │ -000065d0: 2020 2320 6d6b 6532 6673 202f 6465 762f # mke2fs /dev/ │ │ │ │ │ -000065e0: 6664 300a 2020 2020 2023 206d 6f75 6e74 fd0. # mount │ │ │ │ │ -000065f0: 202d 7420 6578 7432 202f 6465 762f 6664 -t ext2 /dev/fd │ │ │ │ │ -00006600: 3020 2f6d 6e74 0a20 2020 2020 2320 6d6b 0 /mnt. # mk │ │ │ │ │ -00006610: 6469 7220 2f6d 6e74 2f62 6f6f 740a 2020 dir /mnt/boot. │ │ │ │ │ -00006620: 2020 2023 2067 7275 622d 696e 7374 616c # grub-instal │ │ │ │ │ -00006630: 6c20 2d2d 626f 6f74 2d64 6972 6563 746f l --boot-directo │ │ │ │ │ -00006640: 7279 3d2f 6d6e 742f 626f 6f74 202f 6465 ry=/mnt/boot /de │ │ │ │ │ -00006650: 762f 6664 300a 2020 2020 2023 2075 6d6f v/fd0. # umo │ │ │ │ │ -00006660: 756e 7420 2f6d 6e74 0a0a 2020 2053 6f6d unt /mnt.. Som │ │ │ │ │ -00006670: 6520 4249 4f53 6573 2068 6176 6520 6120 e BIOSes have a │ │ │ │ │ -00006680: 6275 6720 6f66 2065 7870 6f73 696e 6720 bug of exposing │ │ │ │ │ -00006690: 7468 6520 6669 7273 7420 7061 7274 6974 the first partit │ │ │ │ │ -000066a0: 696f 6e20 6f66 2061 2055 5342 2064 7269 ion of a USB dri │ │ │ │ │ -000066b0: 7665 0a61 7320 6120 666c 6f70 7079 2069 ve.as a floppy i │ │ │ │ │ -000066c0: 6e73 7465 6164 206f 6620 6578 706f 7369 nstead of exposi │ │ │ │ │ -000066d0: 6e67 2074 6865 2055 5342 2064 7269 7665 ng the USB drive │ │ │ │ │ -000066e0: 2061 7320 6120 6861 7264 2064 6973 6b20 as a hard disk │ │ │ │ │ -000066f0: 2874 6865 7920 6361 6c6c 0a69 7420 2255 (they call.it "U │ │ │ │ │ -00006700: 5342 2d46 4444 2220 626f 6f74 292e 2020 SB-FDD" boot). │ │ │ │ │ -00006710: 496e 2073 7563 6820 6361 7365 732c 2079 In such cases, y │ │ │ │ │ -00006720: 6f75 206e 6565 6420 746f 2069 6e73 7461 ou need to insta │ │ │ │ │ -00006730: 6c6c 206c 696b 6520 7468 6973 3a0a 0a20 ll like this:.. │ │ │ │ │ -00006740: 2020 2020 2320 6c6f 7365 7475 7020 2f64 # losetup /d │ │ │ │ │ -00006750: 6576 2f6c 6f6f 7030 202f 6465 762f 7364 ev/loop0 /dev/sd │ │ │ │ │ -00006760: 6231 0a20 2020 2020 2320 6d6f 756e 7420 b1. # mount │ │ │ │ │ -00006770: 2f64 6576 2f6c 6f6f 7030 202f 6d6e 742f /dev/loop0 /mnt/ │ │ │ │ │ -00006780: 7573 620a 2020 2020 2023 2067 7275 622d usb. # grub- │ │ │ │ │ -00006790: 696e 7374 616c 6c20 2d2d 626f 6f74 2d64 install --boot-d │ │ │ │ │ -000067a0: 6972 6563 746f 7279 3d2f 6d6e 742f 7573 irectory=/mnt/us │ │ │ │ │ -000067b0: 622f 6275 6762 696f 7320 2d2d 666f 7263 b/bugbios --forc │ │ │ │ │ -000067c0: 6520 2d2d 616c 6c6f 772d 666c 6f70 7079 e --allow-floppy │ │ │ │ │ -000067d0: 202f 6465 762f 6c6f 6f70 300a 0a20 2020 /dev/loop0.. │ │ │ │ │ -000067e0: 5468 6973 2069 6e73 7461 6c6c 2064 6f65 This install doe │ │ │ │ │ -000067f0: 736e 2774 2063 6f6e 666c 6963 7420 7769 sn't conflict wi │ │ │ │ │ -00006800: 7468 2073 7461 6e64 6172 6420 696e 7374 th standard inst │ │ │ │ │ -00006810: 616c 6c20 6173 206c 6f6e 6720 6173 2074 all as long as t │ │ │ │ │ -00006820: 6865 790a 6172 6520 696e 2073 6570 6172 hey.are in separ │ │ │ │ │ -00006830: 6174 6520 6469 7265 6374 6f72 6965 732e ate directories. │ │ │ │ │ -00006840: 0a0a 2020 204f 6e20 4546 4920 7379 7374 .. On EFI syst │ │ │ │ │ -00006850: 656d 7320 666f 7220 6669 7865 6420 6469 ems for fixed di │ │ │ │ │ -00006860: 736b 2069 6e73 7461 6c6c 2079 6f75 2068 sk install you h │ │ │ │ │ -00006870: 6176 6520 746f 206d 6f75 6e74 2045 4649 ave to mount EFI │ │ │ │ │ -00006880: 2053 7973 7465 6d0a 5061 7274 6974 696f System.Partitio │ │ │ │ │ -00006890: 6e2e 2020 4966 2079 6f75 206d 6f75 6e74 n. If you mount │ │ │ │ │ -000068a0: 2069 7420 6174 2027 2f62 6f6f 742f 6566 it at '/boot/ef │ │ │ │ │ -000068b0: 6927 2074 6865 6e20 796f 7520 646f 6e27 i' then you don' │ │ │ │ │ -000068c0: 7420 6e65 6564 2061 6e79 0a73 7065 6369 t need any.speci │ │ │ │ │ -000068d0: 616c 2061 7267 756d 656e 7473 3a0a 0a20 al arguments:.. │ │ │ │ │ -000068e0: 2020 2020 2320 6772 7562 2d69 6e73 7461 # grub-insta │ │ │ │ │ -000068f0: 6c6c 0a0a 2020 204f 7468 6572 7769 7365 ll.. Otherwise │ │ │ │ │ -00006900: 2079 6f75 206e 6565 6420 746f 2073 7065 you need to spe │ │ │ │ │ -00006910: 6369 6679 2077 6865 7265 2079 6f75 7220 cify where your │ │ │ │ │ -00006920: 4546 4920 5379 7374 656d 2070 6172 7469 EFI System parti │ │ │ │ │ -00006930: 7469 6f6e 2069 730a 6d6f 756e 7465 643a tion is.mounted: │ │ │ │ │ -00006940: 0a0a 2020 2020 2023 2067 7275 622d 696e .. # grub-in │ │ │ │ │ -00006950: 7374 616c 6c20 2d2d 6566 692d 6469 7265 stall --efi-dire │ │ │ │ │ -00006960: 6374 6f72 793d 2f6d 6e74 2f65 6669 0a0a ctory=/mnt/efi.. │ │ │ │ │ -00006970: 2020 2046 6f72 2072 656d 6f76 6162 6c65 For removable │ │ │ │ │ -00006980: 2069 6e73 7461 6c6c 7320 796f 7520 6861 installs you ha │ │ │ │ │ -00006990: 7665 2074 6f20 7573 6520 272d 2d72 656d ve to use '--rem │ │ │ │ │ -000069a0: 6f76 6162 6c65 2720 616e 6420 7370 6563 ovable' and spec │ │ │ │ │ -000069b0: 6966 7920 626f 7468 0a27 2d2d 626f 6f74 ify both.'--boot │ │ │ │ │ -000069c0: 2d64 6972 6563 746f 7279 2720 616e 6420 -directory' and │ │ │ │ │ -000069d0: 272d 2d65 6669 2d64 6972 6563 746f 7279 '--efi-directory │ │ │ │ │ -000069e0: 273a 0a0a 2020 2020 2023 2067 7275 622d ':.. # grub- │ │ │ │ │ -000069f0: 696e 7374 616c 6c20 2d2d 6566 692d 6469 install --efi-di │ │ │ │ │ -00006a00: 7265 6374 6f72 793d 2f6d 6e74 2f75 7362 rectory=/mnt/usb │ │ │ │ │ -00006a10: 202d 2d62 6f6f 742d 6469 7265 6374 6f72 --boot-director │ │ │ │ │ -00006a20: 793d 2f6d 6e74 2f75 7362 2f62 6f6f 7420 y=/mnt/usb/boot │ │ │ │ │ -00006a30: 2d2d 7265 6d6f 7661 626c 650a 0a1f 0a46 --removable....F │ │ │ │ │ -00006a40: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ -00006a50: 204e 6f64 653a 204d 616b 696e 6720 6120 Node: Making a │ │ │ │ │ -00006a60: 4752 5542 2062 6f6f 7461 626c 6520 4344 GRUB bootable CD │ │ │ │ │ -00006a70: 2d52 4f4d 2c20 204e 6578 743a 2044 6576 -ROM, Next: Dev │ │ │ │ │ -00006a80: 6963 6520 6d61 702c 2020 5072 6576 3a20 ice map, Prev: │ │ │ │ │ -00006a90: 496e 7374 616c 6c69 6e67 2047 5255 4220 Installing GRUB │ │ │ │ │ -00006aa0: 7573 696e 6720 6772 7562 2d69 6e73 7461 using grub-insta │ │ │ │ │ -00006ab0: 6c6c 2c20 2055 703a 2049 6e73 7461 6c6c ll, Up: Install │ │ │ │ │ -00006ac0: 6174 696f 6e0a 0a34 2e32 204d 616b 696e ation..4.2 Makin │ │ │ │ │ -00006ad0: 6720 6120 4752 5542 2062 6f6f 7461 626c g a GRUB bootabl │ │ │ │ │ -00006ae0: 6520 4344 2d52 4f4d 0a3d 3d3d 3d3d 3d3d e CD-ROM.======= │ │ │ │ │ +000061f0: 3d3d 3d3d 0a0a 466f 7220 696e 666f 726d ====..For inform │ │ │ │ │ +00006200: 6174 696f 6e20 6f6e 2077 6865 7265 2047 ation on where G │ │ │ │ │ +00006210: 5255 4220 7368 6f75 6c64 2062 6520 696e RUB should be in │ │ │ │ │ +00006220: 7374 616c 6c65 6420 6f6e 2050 4320 4249 stalled on PC BI │ │ │ │ │ +00006230: 4f53 2070 6c61 7466 6f72 6d73 2c0a 2a6e OS platforms,.*n │ │ │ │ │ +00006240: 6f74 6520 4249 4f53 2069 6e73 7461 6c6c ote BIOS install │ │ │ │ │ +00006250: 6174 696f 6e3a 3a2e 0a0a 2020 2049 6e20 ation::... In │ │ │ │ │ +00006260: 6f72 6465 7220 746f 2069 6e73 7461 6c6c order to install │ │ │ │ │ +00006270: 2047 5255 4220 756e 6465 7220 6120 554e GRUB under a UN │ │ │ │ │ +00006280: 4958 2d6c 696b 6520 4f53 2028 7375 6368 IX-like OS (such │ │ │ │ │ +00006290: 2061 7320 474e 5529 2c20 696e 766f 6b65 as GNU), invoke │ │ │ │ │ +000062a0: 0a74 6865 2070 726f 6772 616d 2027 6772 .the program 'gr │ │ │ │ │ +000062b0: 7562 2d69 6e73 7461 6c6c 2720 282a 6e6f ub-install' (*no │ │ │ │ │ +000062c0: 7465 2049 6e76 6f6b 696e 6720 6772 7562 te Invoking grub │ │ │ │ │ +000062d0: 2d69 6e73 7461 6c6c 3a3a 2920 6173 2074 -install::) as t │ │ │ │ │ +000062e0: 6865 0a73 7570 6572 7573 6572 2028 2272 he.superuser ("r │ │ │ │ │ +000062f0: 6f6f 7422 292e 0a0a 2020 2054 6865 2075 oot")... The u │ │ │ │ │ +00006300: 7361 6765 2069 7320 6261 7369 6361 6c6c sage is basicall │ │ │ │ │ +00006310: 7920 7665 7279 2073 696d 706c 652e 2020 y very simple. │ │ │ │ │ +00006320: 596f 7520 6f6e 6c79 206e 6565 6420 746f You only need to │ │ │ │ │ +00006330: 2073 7065 6369 6679 206f 6e65 0a61 7267 specify one.arg │ │ │ │ │ +00006340: 756d 656e 7420 746f 2074 6865 2070 726f ument to the pro │ │ │ │ │ +00006350: 6772 616d 2c20 6e61 6d65 6c79 2c20 7768 gram, namely, wh │ │ │ │ │ +00006360: 6572 6520 746f 2069 6e73 7461 6c6c 2074 ere to install t │ │ │ │ │ +00006370: 6865 2062 6f6f 7420 6c6f 6164 6572 2e20 he boot loader. │ │ │ │ │ +00006380: 2054 6865 0a61 7267 756d 656e 7420 6861 The.argument ha │ │ │ │ │ +00006390: 7320 746f 2062 6520 6569 7468 6572 2061 s to be either a │ │ │ │ │ +000063a0: 2064 6576 6963 6520 6669 6c65 2028 6c69 device file (li │ │ │ │ │ +000063b0: 6b65 2027 2f64 6576 2f68 6461 2729 2e20 ke '/dev/hda'). │ │ │ │ │ +000063c0: 2046 6f72 2065 7861 6d70 6c65 2c0a 756e For example,.un │ │ │ │ │ +000063d0: 6465 7220 4c69 6e75 7820 7468 6520 666f der Linux the fo │ │ │ │ │ +000063e0: 6c6c 6f77 696e 6720 7769 6c6c 2069 6e73 llowing will ins │ │ │ │ │ +000063f0: 7461 6c6c 2047 5255 4220 696e 746f 2074 tall GRUB into t │ │ │ │ │ +00006400: 6865 204d 4252 206f 6620 7468 6520 6669 he MBR of the fi │ │ │ │ │ +00006410: 7273 740a 4944 4520 6469 736b 3a0a 0a20 rst.IDE disk:.. │ │ │ │ │ +00006420: 2020 2020 2320 6772 7562 2d69 6e73 7461 # grub-insta │ │ │ │ │ +00006430: 6c6c 202f 6465 762f 7364 610a 0a20 2020 ll /dev/sda.. │ │ │ │ │ +00006440: 4c69 6b65 7769 7365 2c20 756e 6465 7220 Likewise, under │ │ │ │ │ +00006450: 474e 552f 4875 7264 2c20 7468 6973 2068 GNU/Hurd, this h │ │ │ │ │ +00006460: 6173 2074 6865 2073 616d 6520 6566 6665 as the same effe │ │ │ │ │ +00006470: 6374 3a0a 0a20 2020 2020 2320 6772 7562 ct:.. # grub │ │ │ │ │ +00006480: 2d69 6e73 7461 6c6c 202f 6465 762f 6864 -install /dev/hd │ │ │ │ │ +00006490: 300a 0a20 2020 4275 7420 616c 6c20 7468 0.. But all th │ │ │ │ │ +000064a0: 6520 6162 6f76 6520 6578 616d 706c 6573 e above examples │ │ │ │ │ +000064b0: 2061 7373 756d 6520 7468 6174 2047 5255 assume that GRU │ │ │ │ │ +000064c0: 4220 7368 6f75 6c64 2070 7574 2069 6d61 B should put ima │ │ │ │ │ +000064d0: 6765 7320 756e 6465 720a 7468 6520 272f ges under.the '/ │ │ │ │ │ +000064e0: 626f 6f74 2720 6469 7265 6374 6f72 792e boot' directory. │ │ │ │ │ +000064f0: 2020 4966 2079 6f75 2077 616e 7420 4752 If you want GR │ │ │ │ │ +00006500: 5542 2074 6f20 7075 7420 696d 6167 6573 UB to put images │ │ │ │ │ +00006510: 2075 6e64 6572 2061 2064 6972 6563 746f under a directo │ │ │ │ │ +00006520: 7279 0a6f 7468 6572 2074 6861 6e20 272f ry.other than '/ │ │ │ │ │ +00006530: 626f 6f74 272c 2079 6f75 206e 6565 6420 boot', you need │ │ │ │ │ +00006540: 746f 2073 7065 6369 6679 2074 6865 206f to specify the o │ │ │ │ │ +00006550: 7074 696f 6e20 272d 2d62 6f6f 742d 6469 ption '--boot-di │ │ │ │ │ +00006560: 7265 6374 6f72 7927 2e0a 5468 6520 7479 rectory'..The ty │ │ │ │ │ +00006570: 7069 6361 6c20 7573 6167 6520 6973 2074 pical usage is t │ │ │ │ │ +00006580: 6861 7420 796f 7520 6372 6561 7465 2061 hat you create a │ │ │ │ │ +00006590: 2047 5255 4220 626f 6f74 2066 6c6f 7070 GRUB boot flopp │ │ │ │ │ +000065a0: 7920 7769 7468 2061 0a66 696c 6573 7973 y with a.filesys │ │ │ │ │ +000065b0: 7465 6d2e 2020 4865 7265 2069 7320 616e tem. Here is an │ │ │ │ │ +000065c0: 2065 7861 6d70 6c65 3a0a 0a20 2020 2020 example:.. │ │ │ │ │ +000065d0: 2320 6d6b 6532 6673 202f 6465 762f 6664 # mke2fs /dev/fd │ │ │ │ │ +000065e0: 300a 2020 2020 2023 206d 6f75 6e74 202d 0. # mount - │ │ │ │ │ +000065f0: 7420 6578 7432 202f 6465 762f 6664 3020 t ext2 /dev/fd0 │ │ │ │ │ +00006600: 2f6d 6e74 0a20 2020 2020 2320 6d6b 6469 /mnt. # mkdi │ │ │ │ │ +00006610: 7220 2f6d 6e74 2f62 6f6f 740a 2020 2020 r /mnt/boot. │ │ │ │ │ +00006620: 2023 2067 7275 622d 696e 7374 616c 6c20 # grub-install │ │ │ │ │ +00006630: 2d2d 626f 6f74 2d64 6972 6563 746f 7279 --boot-directory │ │ │ │ │ +00006640: 3d2f 6d6e 742f 626f 6f74 202f 6465 762f =/mnt/boot /dev/ │ │ │ │ │ +00006650: 6664 300a 2020 2020 2023 2075 6d6f 756e fd0. # umoun │ │ │ │ │ +00006660: 7420 2f6d 6e74 0a0a 2020 2053 6f6d 6520 t /mnt.. Some │ │ │ │ │ +00006670: 4249 4f53 6573 2068 6176 6520 6120 6275 BIOSes have a bu │ │ │ │ │ +00006680: 6720 6f66 2065 7870 6f73 696e 6720 7468 g of exposing th │ │ │ │ │ +00006690: 6520 6669 7273 7420 7061 7274 6974 696f e first partitio │ │ │ │ │ +000066a0: 6e20 6f66 2061 2055 5342 2064 7269 7665 n of a USB drive │ │ │ │ │ +000066b0: 0a61 7320 6120 666c 6f70 7079 2069 6e73 .as a floppy ins │ │ │ │ │ +000066c0: 7465 6164 206f 6620 6578 706f 7369 6e67 tead of exposing │ │ │ │ │ +000066d0: 2074 6865 2055 5342 2064 7269 7665 2061 the USB drive a │ │ │ │ │ +000066e0: 7320 6120 6861 7264 2064 6973 6b20 2874 s a hard disk (t │ │ │ │ │ +000066f0: 6865 7920 6361 6c6c 0a69 7420 2255 5342 hey call.it "USB │ │ │ │ │ +00006700: 2d46 4444 2220 626f 6f74 292e 2020 496e -FDD" boot). In │ │ │ │ │ +00006710: 2073 7563 6820 6361 7365 732c 2079 6f75 such cases, you │ │ │ │ │ +00006720: 206e 6565 6420 746f 2069 6e73 7461 6c6c need to install │ │ │ │ │ +00006730: 206c 696b 6520 7468 6973 3a0a 0a20 2020 like this:.. │ │ │ │ │ +00006740: 2020 2320 6c6f 7365 7475 7020 2f64 6576 # losetup /dev │ │ │ │ │ +00006750: 2f6c 6f6f 7030 202f 6465 762f 7364 6231 /loop0 /dev/sdb1 │ │ │ │ │ +00006760: 0a20 2020 2020 2320 6d6f 756e 7420 2f64 . # mount /d │ │ │ │ │ +00006770: 6576 2f6c 6f6f 7030 202f 6d6e 742f 7573 ev/loop0 /mnt/us │ │ │ │ │ +00006780: 620a 2020 2020 2023 2067 7275 622d 696e b. # grub-in │ │ │ │ │ +00006790: 7374 616c 6c20 2d2d 626f 6f74 2d64 6972 stall --boot-dir │ │ │ │ │ +000067a0: 6563 746f 7279 3d2f 6d6e 742f 7573 622f ectory=/mnt/usb/ │ │ │ │ │ +000067b0: 6275 6762 696f 7320 2d2d 666f 7263 6520 bugbios --force │ │ │ │ │ +000067c0: 2d2d 616c 6c6f 772d 666c 6f70 7079 202f --allow-floppy / │ │ │ │ │ +000067d0: 6465 762f 6c6f 6f70 300a 0a20 2020 5468 dev/loop0.. Th │ │ │ │ │ +000067e0: 6973 2069 6e73 7461 6c6c 2064 6f65 736e is install doesn │ │ │ │ │ +000067f0: 2774 2063 6f6e 666c 6963 7420 7769 7468 't conflict with │ │ │ │ │ +00006800: 2073 7461 6e64 6172 6420 696e 7374 616c standard instal │ │ │ │ │ +00006810: 6c20 6173 206c 6f6e 6720 6173 2074 6865 l as long as the │ │ │ │ │ +00006820: 790a 6172 6520 696e 2073 6570 6172 6174 y.are in separat │ │ │ │ │ +00006830: 6520 6469 7265 6374 6f72 6965 732e 0a0a e directories... │ │ │ │ │ +00006840: 2020 204f 6e20 4546 4920 7379 7374 656d On EFI system │ │ │ │ │ +00006850: 7320 666f 7220 6669 7865 6420 6469 736b s for fixed disk │ │ │ │ │ +00006860: 2069 6e73 7461 6c6c 2079 6f75 2068 6176 install you hav │ │ │ │ │ +00006870: 6520 746f 206d 6f75 6e74 2045 4649 2053 e to mount EFI S │ │ │ │ │ +00006880: 7973 7465 6d0a 5061 7274 6974 696f 6e2e ystem.Partition. │ │ │ │ │ +00006890: 2020 4966 2079 6f75 206d 6f75 6e74 2069 If you mount i │ │ │ │ │ +000068a0: 7420 6174 2027 2f62 6f6f 742f 6566 6927 t at '/boot/efi' │ │ │ │ │ +000068b0: 2074 6865 6e20 796f 7520 646f 6e27 7420 then you don't │ │ │ │ │ +000068c0: 6e65 6564 2061 6e79 0a73 7065 6369 616c need any.special │ │ │ │ │ +000068d0: 2061 7267 756d 656e 7473 3a0a 0a20 2020 arguments:.. │ │ │ │ │ +000068e0: 2020 2320 6772 7562 2d69 6e73 7461 6c6c # grub-install │ │ │ │ │ +000068f0: 0a0a 2020 204f 7468 6572 7769 7365 2079 .. Otherwise y │ │ │ │ │ +00006900: 6f75 206e 6565 6420 746f 2073 7065 6369 ou need to speci │ │ │ │ │ +00006910: 6679 2077 6865 7265 2079 6f75 7220 4546 fy where your EF │ │ │ │ │ +00006920: 4920 5379 7374 656d 2070 6172 7469 7469 I System partiti │ │ │ │ │ +00006930: 6f6e 2069 730a 6d6f 756e 7465 643a 0a0a on is.mounted:.. │ │ │ │ │ +00006940: 2020 2020 2023 2067 7275 622d 696e 7374 # grub-inst │ │ │ │ │ +00006950: 616c 6c20 2d2d 6566 692d 6469 7265 6374 all --efi-direct │ │ │ │ │ +00006960: 6f72 793d 2f6d 6e74 2f65 6669 0a0a 2020 ory=/mnt/efi.. │ │ │ │ │ +00006970: 2046 6f72 2072 656d 6f76 6162 6c65 2069 For removable i │ │ │ │ │ +00006980: 6e73 7461 6c6c 7320 796f 7520 6861 7665 nstalls you have │ │ │ │ │ +00006990: 2074 6f20 7573 6520 272d 2d72 656d 6f76 to use '--remov │ │ │ │ │ +000069a0: 6162 6c65 2720 616e 6420 7370 6563 6966 able' and specif │ │ │ │ │ +000069b0: 7920 626f 7468 0a27 2d2d 626f 6f74 2d64 y both.'--boot-d │ │ │ │ │ +000069c0: 6972 6563 746f 7279 2720 616e 6420 272d irectory' and '- │ │ │ │ │ +000069d0: 2d65 6669 2d64 6972 6563 746f 7279 273a -efi-directory': │ │ │ │ │ +000069e0: 0a0a 2020 2020 2023 2067 7275 622d 696e .. # grub-in │ │ │ │ │ +000069f0: 7374 616c 6c20 2d2d 6566 692d 6469 7265 stall --efi-dire │ │ │ │ │ +00006a00: 6374 6f72 793d 2f6d 6e74 2f75 7362 202d ctory=/mnt/usb - │ │ │ │ │ +00006a10: 2d62 6f6f 742d 6469 7265 6374 6f72 793d -boot-directory= │ │ │ │ │ +00006a20: 2f6d 6e74 2f75 7362 2f62 6f6f 7420 2d2d /mnt/usb/boot -- │ │ │ │ │ +00006a30: 7265 6d6f 7661 626c 650a 0a1f 0a46 696c removable....Fil │ │ │ │ │ +00006a40: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ +00006a50: 6f64 653a 204d 616b 696e 6720 6120 4752 ode: Making a GR │ │ │ │ │ +00006a60: 5542 2062 6f6f 7461 626c 6520 4344 2d52 UB bootable CD-R │ │ │ │ │ +00006a70: 4f4d 2c20 204e 6578 743a 2044 6576 6963 OM, Next: Devic │ │ │ │ │ +00006a80: 6520 6d61 702c 2020 5072 6576 3a20 496e e map, Prev: In │ │ │ │ │ +00006a90: 7374 616c 6c69 6e67 2047 5255 4220 7573 stalling GRUB us │ │ │ │ │ +00006aa0: 696e 6720 6772 7562 2d69 6e73 7461 6c6c ing grub-install │ │ │ │ │ +00006ab0: 2c20 2055 703a 2049 6e73 7461 6c6c 6174 , Up: Installat │ │ │ │ │ +00006ac0: 696f 6e0a 0a34 2e32 204d 616b 696e 6720 ion..4.2 Making │ │ │ │ │ +00006ad0: 6120 4752 5542 2062 6f6f 7461 626c 6520 a GRUB bootable │ │ │ │ │ +00006ae0: 4344 2d52 4f4d 0a3d 3d3d 3d3d 3d3d 3d3d CD-ROM.========= │ │ │ │ │ 00006af0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00006b00: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 4752 5542 ==========..GRUB │ │ │ │ │ -00006b10: 2073 7570 706f 7274 7320 7468 6520 226e supports the "n │ │ │ │ │ -00006b20: 6f20 656d 756c 6174 696f 6e20 6d6f 6465 o emulation mode │ │ │ │ │ -00006b30: 2220 696e 2074 6865 2045 6c20 546f 7269 " in the El Tori │ │ │ │ │ -00006b40: 746f 2073 7065 6369 6669 6361 7469 6f6e to specification │ │ │ │ │ -00006b50: 2831 290a 282a 6e6f 7465 204d 616b 696e (1).(*note Makin │ │ │ │ │ -00006b60: 6720 6120 4752 5542 2062 6f6f 7461 626c g a GRUB bootabl │ │ │ │ │ -00006b70: 6520 4344 2d52 4f4d 2d46 6f6f 746e 6f74 e CD-ROM-Footnot │ │ │ │ │ -00006b80: 652d 313a 3a29 2e20 2054 6869 7320 6d65 e-1::). This me │ │ │ │ │ -00006b90: 616e 7320 7468 6174 2079 6f75 0a63 616e ans that you.can │ │ │ │ │ -00006ba0: 2075 7365 2074 6865 2077 686f 6c65 2043 use the whole C │ │ │ │ │ -00006bb0: 442d 524f 4d20 6672 6f6d 2047 5255 4220 D-ROM from GRUB │ │ │ │ │ -00006bc0: 616e 6420 796f 7520 646f 6e27 7420 6861 and you don't ha │ │ │ │ │ -00006bd0: 7665 2074 6f20 6d61 6b65 2061 2066 6c6f ve to make a flo │ │ │ │ │ -00006be0: 7070 790a 6f72 2068 6172 6420 6469 736b ppy.or hard disk │ │ │ │ │ -00006bf0: 2069 6d61 6765 2066 696c 652c 2077 6869 image file, whi │ │ │ │ │ -00006c00: 6368 2063 616e 2063 6175 7365 2063 6f6d ch can cause com │ │ │ │ │ -00006c10: 7061 7469 6269 6c69 7479 2070 726f 626c patibility probl │ │ │ │ │ -00006c20: 656d 732e 0a0a 2020 2046 6f72 2062 6f6f ems... For boo │ │ │ │ │ -00006c30: 7469 6e67 2066 726f 6d20 6120 4344 2d52 ting from a CD-R │ │ │ │ │ -00006c40: 4f4d 2c20 4752 5542 2075 7365 7320 6120 OM, GRUB uses a │ │ │ │ │ -00006c50: 7370 6563 6961 6c20 696d 6167 6520 6361 special image ca │ │ │ │ │ -00006c60: 6c6c 6564 0a27 6364 626f 6f74 2e69 6d67 lled.'cdboot.img │ │ │ │ │ -00006c70: 272c 2077 6869 6368 2069 7320 636f 6e63 ', which is conc │ │ │ │ │ -00006c80: 6174 656e 6174 6564 2077 6974 6820 2763 atenated with 'c │ │ │ │ │ -00006c90: 6f72 652e 696d 6727 2e20 2054 6865 2027 ore.img'. The ' │ │ │ │ │ -00006ca0: 636f 7265 2e69 6d67 270a 7573 6564 2066 core.img'.used f │ │ │ │ │ -00006cb0: 6f72 2074 6869 7320 7368 6f75 6c64 2062 or this should b │ │ │ │ │ -00006cc0: 6520 6275 696c 7420 7769 7468 2061 7420 e built with at │ │ │ │ │ -00006cd0: 6c65 6173 7420 7468 6520 2769 736f 3936 least the 'iso96 │ │ │ │ │ -00006ce0: 3630 2720 616e 6420 2762 696f 7364 6973 60' and 'biosdis │ │ │ │ │ -00006cf0: 6b27 0a6d 6f64 756c 6573 2e20 2059 6f75 k'.modules. You │ │ │ │ │ -00006d00: 7220 626f 6f74 6162 6c65 2043 442d 524f r bootable CD-RO │ │ │ │ │ -00006d10: 4d20 7769 6c6c 2075 7375 616c 6c79 2061 M will usually a │ │ │ │ │ -00006d20: 6c73 6f20 6e65 6564 2074 6f20 696e 636c lso need to incl │ │ │ │ │ -00006d30: 7564 6520 610a 636f 6e66 6967 7572 6174 ude a.configurat │ │ │ │ │ -00006d40: 696f 6e20 6669 6c65 2027 6772 7562 2e63 ion file 'grub.c │ │ │ │ │ -00006d50: 6667 2720 616e 6420 736f 6d65 206f 7468 fg' and some oth │ │ │ │ │ -00006d60: 6572 2047 5255 4220 6d6f 6475 6c65 732e er GRUB modules. │ │ │ │ │ -00006d70: 0a0a 2020 2054 6f20 6d61 6b65 2061 2073 .. To make a s │ │ │ │ │ -00006d80: 696d 706c 6520 6765 6e65 7269 6320 4752 imple generic GR │ │ │ │ │ -00006d90: 5542 2072 6573 6375 6520 4344 2c20 796f UB rescue CD, yo │ │ │ │ │ -00006da0: 7520 6361 6e20 7573 6520 7468 650a 2767 u can use the.'g │ │ │ │ │ -00006db0: 7275 622d 6d6b 7265 7363 7565 2720 7072 rub-mkrescue' pr │ │ │ │ │ -00006dc0: 6f67 7261 6d20 282a 6e6f 7465 2049 6e76 ogram (*note Inv │ │ │ │ │ -00006dd0: 6f6b 696e 6720 6772 7562 2d6d 6b72 6573 oking grub-mkres │ │ │ │ │ -00006de0: 6375 653a 3a29 3a0a 0a20 2020 2020 2420 cue::):.. $ │ │ │ │ │ -00006df0: 6772 7562 2d6d 6b72 6573 6375 6520 2d6f grub-mkrescue -o │ │ │ │ │ -00006e00: 2067 7275 622e 6973 6f0a 0a20 2020 596f grub.iso.. Yo │ │ │ │ │ -00006e10: 7520 7769 6c6c 206f 6674 656e 206e 6565 u will often nee │ │ │ │ │ -00006e20: 6420 746f 2069 6e63 6c75 6465 206f 7468 d to include oth │ │ │ │ │ -00006e30: 6572 2066 696c 6573 2069 6e20 796f 7572 er files in your │ │ │ │ │ -00006e40: 2069 6d61 6765 2e20 2054 6f20 646f 0a74 image. To do.t │ │ │ │ │ -00006e50: 6869 732c 2066 6972 7374 206d 616b 6520 his, first make │ │ │ │ │ -00006e60: 6120 746f 7020 6469 7265 6374 6f72 7920 a top directory │ │ │ │ │ -00006e70: 666f 7220 7468 6520 626f 6f74 6162 6c65 for the bootable │ │ │ │ │ -00006e80: 2069 6d61 6765 2c20 7361 792c 2027 6973 image, say, 'is │ │ │ │ │ -00006e90: 6f27 3a0a 0a20 2020 2020 2420 6d6b 6469 o':.. $ mkdi │ │ │ │ │ -00006ea0: 7220 6973 6f0a 0a20 2020 4d61 6b65 2061 r iso.. Make a │ │ │ │ │ -00006eb0: 2064 6972 6563 746f 7279 2066 6f72 2047 directory for G │ │ │ │ │ -00006ec0: 5255 423a 0a0a 2020 2020 2024 206d 6b64 RUB:.. $ mkd │ │ │ │ │ -00006ed0: 6972 202d 7020 6973 6f2f 626f 6f74 2f67 ir -p iso/boot/g │ │ │ │ │ -00006ee0: 7275 620a 0a20 2020 4966 2064 6573 6972 rub.. If desir │ │ │ │ │ -00006ef0: 6564 2c20 6d61 6b65 2074 6865 2063 6f6e ed, make the con │ │ │ │ │ -00006f00: 6669 6720 6669 6c65 2027 6772 7562 2e63 fig file 'grub.c │ │ │ │ │ -00006f10: 6667 2720 756e 6465 7220 2769 736f 2f62 fg' under 'iso/b │ │ │ │ │ -00006f20: 6f6f 742f 6772 7562 270a 282a 6e6f 7465 oot/grub'.(*note │ │ │ │ │ -00006f30: 2043 6f6e 6669 6775 7261 7469 6f6e 3a3a Configuration:: │ │ │ │ │ -00006f40: 292c 2061 6e64 2063 6f70 7920 616e 7920 ), and copy any │ │ │ │ │ -00006f50: 6669 6c65 7320 616e 6420 6469 7265 6374 files and direct │ │ │ │ │ -00006f60: 6f72 6965 7320 666f 7220 7468 6520 6469 ories for the di │ │ │ │ │ -00006f70: 7363 0a74 6f20 7468 6520 6469 7265 6374 sc.to the direct │ │ │ │ │ -00006f80: 6f72 7920 2769 736f 2f27 2e0a 0a20 2020 ory 'iso/'... │ │ │ │ │ -00006f90: 4669 6e61 6c6c 792c 206d 616b 6520 7468 Finally, make th │ │ │ │ │ -00006fa0: 6520 696d 6167 653a 0a0a 2020 2020 2024 e image:.. $ │ │ │ │ │ -00006fb0: 2067 7275 622d 6d6b 7265 7363 7565 202d grub-mkrescue - │ │ │ │ │ -00006fc0: 6f20 6772 7562 2e69 736f 2069 736f 0a0a o grub.iso iso.. │ │ │ │ │ -00006fd0: 2020 2054 6869 7320 7072 6f64 7563 6573 This produces │ │ │ │ │ -00006fe0: 2061 2066 696c 6520 6e61 6d65 6420 2767 a file named 'g │ │ │ │ │ -00006ff0: 7275 622e 6973 6f27 2c20 7768 6963 6820 rub.iso', which │ │ │ │ │ -00007000: 7468 656e 2063 616e 2062 6520 6275 726e then can be burn │ │ │ │ │ -00007010: 6564 2069 6e74 6f0a 6120 4344 2028 6f72 ed into.a CD (or │ │ │ │ │ -00007020: 2061 2044 5644 292c 206f 7220 7772 6974 a DVD), or writ │ │ │ │ │ -00007030: 7465 6e20 746f 2061 2055 5342 206d 6173 ten to a USB mas │ │ │ │ │ -00007040: 7320 7374 6f72 6167 6520 6465 7669 6365 s storage device │ │ │ │ │ -00007050: 2e0a 0a20 2020 5468 6520 726f 6f74 2064 ... The root d │ │ │ │ │ -00007060: 6576 6963 6520 7769 6c6c 2062 6520 7365 evice will be se │ │ │ │ │ -00007070: 7420 7570 2061 7070 726f 7072 6961 7465 t up appropriate │ │ │ │ │ -00007080: 6c79 206f 6e20 656e 7465 7269 6e67 2079 ly on entering y │ │ │ │ │ -00007090: 6f75 720a 2767 7275 622e 6366 6727 2063 our.'grub.cfg' c │ │ │ │ │ -000070a0: 6f6e 6669 6775 7261 7469 6f6e 2066 696c onfiguration fil │ │ │ │ │ -000070b0: 652c 2073 6f20 796f 7520 6361 6e20 7265 e, so you can re │ │ │ │ │ -000070c0: 6665 7220 746f 2066 696c 6520 6e61 6d65 fer to file name │ │ │ │ │ -000070d0: 7320 6f6e 2074 6865 2043 440a 7769 7468 s on the CD.with │ │ │ │ │ -000070e0: 6f75 7420 6e65 6564 696e 6720 746f 2075 out needing to u │ │ │ │ │ -000070f0: 7365 2061 6e20 6578 706c 6963 6974 2064 se an explicit d │ │ │ │ │ -00007100: 6576 6963 6520 6e61 6d65 2e20 2054 6869 evice name. Thi │ │ │ │ │ -00007110: 7320 6d61 6b65 7320 6974 2065 6173 6965 s makes it easie │ │ │ │ │ -00007120: 7220 746f 0a70 726f 6475 6365 2072 6573 r to.produce res │ │ │ │ │ -00007130: 6375 6520 696d 6167 6573 2074 6861 7420 cue images that │ │ │ │ │ -00007140: 7769 6c6c 2077 6f72 6b20 6f6e 2062 6f74 will work on bot │ │ │ │ │ -00007150: 6820 6f70 7469 6361 6c20 6472 6976 6573 h optical drives │ │ │ │ │ -00007160: 2061 6e64 2055 5342 206d 6173 730a 7374 and USB mass.st │ │ │ │ │ -00007170: 6f72 6167 6520 6465 7669 6365 732e 0a0a orage devices... │ │ │ │ │ -00007180: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ -00007190: 6f2c 2020 4e6f 6465 3a20 4d61 6b69 6e67 o, Node: Making │ │ │ │ │ -000071a0: 2061 2047 5255 4220 626f 6f74 6162 6c65 a GRUB bootable │ │ │ │ │ -000071b0: 2043 442d 524f 4d2d 466f 6f74 6e6f 7465 CD-ROM-Footnote │ │ │ │ │ -000071c0: 732c 2020 5570 3a20 4d61 6b69 6e67 2061 s, Up: Making a │ │ │ │ │ -000071d0: 2047 5255 4220 626f 6f74 6162 6c65 2043 GRUB bootable C │ │ │ │ │ -000071e0: 442d 524f 4d0a 0a20 2020 2831 2920 456c D-ROM.. (1) El │ │ │ │ │ -000071f0: 2054 6f72 6974 6f20 6973 2061 2073 7065 Torito is a spe │ │ │ │ │ -00007200: 6369 6669 6361 7469 6f6e 2066 6f72 2062 cification for b │ │ │ │ │ -00007210: 6f6f 7461 626c 6520 4344 2075 7369 6e67 ootable CD using │ │ │ │ │ -00007220: 2042 494f 530a 6675 6e63 7469 6f6e 732e BIOS.functions. │ │ │ │ │ -00007230: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ -00007240: 6e66 6f2c 2020 4e6f 6465 3a20 4465 7669 nfo, Node: Devi │ │ │ │ │ -00007250: 6365 206d 6170 2c20 204e 6578 743a 2042 ce map, Next: B │ │ │ │ │ -00007260: 494f 5320 696e 7374 616c 6c61 7469 6f6e IOS installation │ │ │ │ │ -00007270: 2c20 2050 7265 763a 204d 616b 696e 6720 , Prev: Making │ │ │ │ │ -00007280: 6120 4752 5542 2062 6f6f 7461 626c 6520 a GRUB bootable │ │ │ │ │ -00007290: 4344 2d52 4f4d 2c20 2055 703a 2049 6e73 CD-ROM, Up: Ins │ │ │ │ │ -000072a0: 7461 6c6c 6174 696f 6e0a 0a34 2e33 2054 tallation..4.3 T │ │ │ │ │ -000072b0: 6865 206d 6170 2062 6574 7765 656e 2042 he map between B │ │ │ │ │ -000072c0: 494f 5320 6472 6976 6573 2061 6e64 204f IOS drives and O │ │ │ │ │ -000072d0: 5320 6465 7669 6365 730a 3d3d 3d3d 3d3d S devices.====== │ │ │ │ │ +00006b00: 3d3d 3d3d 3d3d 3d3d 0a0a 4752 5542 2073 ========..GRUB s │ │ │ │ │ +00006b10: 7570 706f 7274 7320 7468 6520 226e 6f20 upports the "no │ │ │ │ │ +00006b20: 656d 756c 6174 696f 6e20 6d6f 6465 2220 emulation mode" │ │ │ │ │ +00006b30: 696e 2074 6865 2045 6c20 546f 7269 746f in the El Torito │ │ │ │ │ +00006b40: 2073 7065 6369 6669 6361 7469 6f6e 2831 specification(1 │ │ │ │ │ +00006b50: 290a 282a 6e6f 7465 204d 616b 696e 6720 ).(*note Making │ │ │ │ │ +00006b60: 6120 4752 5542 2062 6f6f 7461 626c 6520 a GRUB bootable │ │ │ │ │ +00006b70: 4344 2d52 4f4d 2d46 6f6f 746e 6f74 652d CD-ROM-Footnote- │ │ │ │ │ +00006b80: 313a 3a29 2e20 2054 6869 7320 6d65 616e 1::). This mean │ │ │ │ │ +00006b90: 7320 7468 6174 2079 6f75 0a63 616e 2075 s that you.can u │ │ │ │ │ +00006ba0: 7365 2074 6865 2077 686f 6c65 2043 442d se the whole CD- │ │ │ │ │ +00006bb0: 524f 4d20 6672 6f6d 2047 5255 4220 616e ROM from GRUB an │ │ │ │ │ +00006bc0: 6420 796f 7520 646f 6e27 7420 6861 7665 d you don't have │ │ │ │ │ +00006bd0: 2074 6f20 6d61 6b65 2061 2066 6c6f 7070 to make a flopp │ │ │ │ │ +00006be0: 790a 6f72 2068 6172 6420 6469 736b 2069 y.or hard disk i │ │ │ │ │ +00006bf0: 6d61 6765 2066 696c 652c 2077 6869 6368 mage file, which │ │ │ │ │ +00006c00: 2063 616e 2063 6175 7365 2063 6f6d 7061 can cause compa │ │ │ │ │ +00006c10: 7469 6269 6c69 7479 2070 726f 626c 656d tibility problem │ │ │ │ │ +00006c20: 732e 0a0a 2020 2046 6f72 2062 6f6f 7469 s... For booti │ │ │ │ │ +00006c30: 6e67 2066 726f 6d20 6120 4344 2d52 4f4d ng from a CD-ROM │ │ │ │ │ +00006c40: 2c20 4752 5542 2075 7365 7320 6120 7370 , GRUB uses a sp │ │ │ │ │ +00006c50: 6563 6961 6c20 696d 6167 6520 6361 6c6c ecial image call │ │ │ │ │ +00006c60: 6564 0a27 6364 626f 6f74 2e69 6d67 272c ed.'cdboot.img', │ │ │ │ │ +00006c70: 2077 6869 6368 2069 7320 636f 6e63 6174 which is concat │ │ │ │ │ +00006c80: 656e 6174 6564 2077 6974 6820 2763 6f72 enated with 'cor │ │ │ │ │ +00006c90: 652e 696d 6727 2e20 2054 6865 2027 636f e.img'. The 'co │ │ │ │ │ +00006ca0: 7265 2e69 6d67 270a 7573 6564 2066 6f72 re.img'.used for │ │ │ │ │ +00006cb0: 2074 6869 7320 7368 6f75 6c64 2062 6520 this should be │ │ │ │ │ +00006cc0: 6275 696c 7420 7769 7468 2061 7420 6c65 built with at le │ │ │ │ │ +00006cd0: 6173 7420 7468 6520 2769 736f 3936 3630 ast the 'iso9660 │ │ │ │ │ +00006ce0: 2720 616e 6420 2762 696f 7364 6973 6b27 ' and 'biosdisk' │ │ │ │ │ +00006cf0: 0a6d 6f64 756c 6573 2e20 2059 6f75 7220 .modules. Your │ │ │ │ │ +00006d00: 626f 6f74 6162 6c65 2043 442d 524f 4d20 bootable CD-ROM │ │ │ │ │ +00006d10: 7769 6c6c 2075 7375 616c 6c79 2061 6c73 will usually als │ │ │ │ │ +00006d20: 6f20 6e65 6564 2074 6f20 696e 636c 7564 o need to includ │ │ │ │ │ +00006d30: 6520 610a 636f 6e66 6967 7572 6174 696f e a.configuratio │ │ │ │ │ +00006d40: 6e20 6669 6c65 2027 6772 7562 2e63 6667 n file 'grub.cfg │ │ │ │ │ +00006d50: 2720 616e 6420 736f 6d65 206f 7468 6572 ' and some other │ │ │ │ │ +00006d60: 2047 5255 4220 6d6f 6475 6c65 732e 0a0a GRUB modules... │ │ │ │ │ +00006d70: 2020 2054 6f20 6d61 6b65 2061 2073 696d To make a sim │ │ │ │ │ +00006d80: 706c 6520 6765 6e65 7269 6320 4752 5542 ple generic GRUB │ │ │ │ │ +00006d90: 2072 6573 6375 6520 4344 2c20 796f 7520 rescue CD, you │ │ │ │ │ +00006da0: 6361 6e20 7573 6520 7468 650a 2767 7275 can use the.'gru │ │ │ │ │ +00006db0: 622d 6d6b 7265 7363 7565 2720 7072 6f67 b-mkrescue' prog │ │ │ │ │ +00006dc0: 7261 6d20 282a 6e6f 7465 2049 6e76 6f6b ram (*note Invok │ │ │ │ │ +00006dd0: 696e 6720 6772 7562 2d6d 6b72 6573 6375 ing grub-mkrescu │ │ │ │ │ +00006de0: 653a 3a29 3a0a 0a20 2020 2020 2420 6772 e::):.. $ gr │ │ │ │ │ +00006df0: 7562 2d6d 6b72 6573 6375 6520 2d6f 2067 ub-mkrescue -o g │ │ │ │ │ +00006e00: 7275 622e 6973 6f0a 0a20 2020 596f 7520 rub.iso.. You │ │ │ │ │ +00006e10: 7769 6c6c 206f 6674 656e 206e 6565 6420 will often need │ │ │ │ │ +00006e20: 746f 2069 6e63 6c75 6465 206f 7468 6572 to include other │ │ │ │ │ +00006e30: 2066 696c 6573 2069 6e20 796f 7572 2069 files in your i │ │ │ │ │ +00006e40: 6d61 6765 2e20 2054 6f20 646f 0a74 6869 mage. To do.thi │ │ │ │ │ +00006e50: 732c 2066 6972 7374 206d 616b 6520 6120 s, first make a │ │ │ │ │ +00006e60: 746f 7020 6469 7265 6374 6f72 7920 666f top directory fo │ │ │ │ │ +00006e70: 7220 7468 6520 626f 6f74 6162 6c65 2069 r the bootable i │ │ │ │ │ +00006e80: 6d61 6765 2c20 7361 792c 2027 6973 6f27 mage, say, 'iso' │ │ │ │ │ +00006e90: 3a0a 0a20 2020 2020 2420 6d6b 6469 7220 :.. $ mkdir │ │ │ │ │ +00006ea0: 6973 6f0a 0a20 2020 4d61 6b65 2061 2064 iso.. Make a d │ │ │ │ │ +00006eb0: 6972 6563 746f 7279 2066 6f72 2047 5255 irectory for GRU │ │ │ │ │ +00006ec0: 423a 0a0a 2020 2020 2024 206d 6b64 6972 B:.. $ mkdir │ │ │ │ │ +00006ed0: 202d 7020 6973 6f2f 626f 6f74 2f67 7275 -p iso/boot/gru │ │ │ │ │ +00006ee0: 620a 0a20 2020 4966 2064 6573 6972 6564 b.. If desired │ │ │ │ │ +00006ef0: 2c20 6d61 6b65 2074 6865 2063 6f6e 6669 , make the confi │ │ │ │ │ +00006f00: 6720 6669 6c65 2027 6772 7562 2e63 6667 g file 'grub.cfg │ │ │ │ │ +00006f10: 2720 756e 6465 7220 2769 736f 2f62 6f6f ' under 'iso/boo │ │ │ │ │ +00006f20: 742f 6772 7562 270a 282a 6e6f 7465 2043 t/grub'.(*note C │ │ │ │ │ +00006f30: 6f6e 6669 6775 7261 7469 6f6e 3a3a 292c onfiguration::), │ │ │ │ │ +00006f40: 2061 6e64 2063 6f70 7920 616e 7920 6669 and copy any fi │ │ │ │ │ +00006f50: 6c65 7320 616e 6420 6469 7265 6374 6f72 les and director │ │ │ │ │ +00006f60: 6965 7320 666f 7220 7468 6520 6469 7363 ies for the disc │ │ │ │ │ +00006f70: 0a74 6f20 7468 6520 6469 7265 6374 6f72 .to the director │ │ │ │ │ +00006f80: 7920 2769 736f 2f27 2e0a 0a20 2020 4669 y 'iso/'... Fi │ │ │ │ │ +00006f90: 6e61 6c6c 792c 206d 616b 6520 7468 6520 nally, make the │ │ │ │ │ +00006fa0: 696d 6167 653a 0a0a 2020 2020 2024 2067 image:.. $ g │ │ │ │ │ +00006fb0: 7275 622d 6d6b 7265 7363 7565 202d 6f20 rub-mkrescue -o │ │ │ │ │ +00006fc0: 6772 7562 2e69 736f 2069 736f 0a0a 2020 grub.iso iso.. │ │ │ │ │ +00006fd0: 2054 6869 7320 7072 6f64 7563 6573 2061 This produces a │ │ │ │ │ +00006fe0: 2066 696c 6520 6e61 6d65 6420 2767 7275 file named 'gru │ │ │ │ │ +00006ff0: 622e 6973 6f27 2c20 7768 6963 6820 7468 b.iso', which th │ │ │ │ │ +00007000: 656e 2063 616e 2062 6520 6275 726e 6564 en can be burned │ │ │ │ │ +00007010: 2069 6e74 6f0a 6120 4344 2028 6f72 2061 into.a CD (or a │ │ │ │ │ +00007020: 2044 5644 292c 206f 7220 7772 6974 7465 DVD), or writte │ │ │ │ │ +00007030: 6e20 746f 2061 2055 5342 206d 6173 7320 n to a USB mass │ │ │ │ │ +00007040: 7374 6f72 6167 6520 6465 7669 6365 2e0a storage device.. │ │ │ │ │ +00007050: 0a20 2020 5468 6520 726f 6f74 2064 6576 . The root dev │ │ │ │ │ +00007060: 6963 6520 7769 6c6c 2062 6520 7365 7420 ice will be set │ │ │ │ │ +00007070: 7570 2061 7070 726f 7072 6961 7465 6c79 up appropriately │ │ │ │ │ +00007080: 206f 6e20 656e 7465 7269 6e67 2079 6f75 on entering you │ │ │ │ │ +00007090: 720a 2767 7275 622e 6366 6727 2063 6f6e r.'grub.cfg' con │ │ │ │ │ +000070a0: 6669 6775 7261 7469 6f6e 2066 696c 652c figuration file, │ │ │ │ │ +000070b0: 2073 6f20 796f 7520 6361 6e20 7265 6665 so you can refe │ │ │ │ │ +000070c0: 7220 746f 2066 696c 6520 6e61 6d65 7320 r to file names │ │ │ │ │ +000070d0: 6f6e 2074 6865 2043 440a 7769 7468 6f75 on the CD.withou │ │ │ │ │ +000070e0: 7420 6e65 6564 696e 6720 746f 2075 7365 t needing to use │ │ │ │ │ +000070f0: 2061 6e20 6578 706c 6963 6974 2064 6576 an explicit dev │ │ │ │ │ +00007100: 6963 6520 6e61 6d65 2e20 2054 6869 7320 ice name. This │ │ │ │ │ +00007110: 6d61 6b65 7320 6974 2065 6173 6965 7220 makes it easier │ │ │ │ │ +00007120: 746f 0a70 726f 6475 6365 2072 6573 6375 to.produce rescu │ │ │ │ │ +00007130: 6520 696d 6167 6573 2074 6861 7420 7769 e images that wi │ │ │ │ │ +00007140: 6c6c 2077 6f72 6b20 6f6e 2062 6f74 6820 ll work on both │ │ │ │ │ +00007150: 6f70 7469 6361 6c20 6472 6976 6573 2061 optical drives a │ │ │ │ │ +00007160: 6e64 2055 5342 206d 6173 730a 7374 6f72 nd USB mass.stor │ │ │ │ │ +00007170: 6167 6520 6465 7669 6365 732e 0a0a 1f0a age devices..... │ │ │ │ │ +00007180: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ +00007190: 2020 4e6f 6465 3a20 4d61 6b69 6e67 2061 Node: Making a │ │ │ │ │ +000071a0: 2047 5255 4220 626f 6f74 6162 6c65 2043 GRUB bootable C │ │ │ │ │ +000071b0: 442d 524f 4d2d 466f 6f74 6e6f 7465 732c D-ROM-Footnotes, │ │ │ │ │ +000071c0: 2020 5570 3a20 4d61 6b69 6e67 2061 2047 Up: Making a G │ │ │ │ │ +000071d0: 5255 4220 626f 6f74 6162 6c65 2043 442d RUB bootable CD- │ │ │ │ │ +000071e0: 524f 4d0a 0a20 2020 2831 2920 456c 2054 ROM.. (1) El T │ │ │ │ │ +000071f0: 6f72 6974 6f20 6973 2061 2073 7065 6369 orito is a speci │ │ │ │ │ +00007200: 6669 6361 7469 6f6e 2066 6f72 2062 6f6f fication for boo │ │ │ │ │ +00007210: 7461 626c 6520 4344 2075 7369 6e67 2042 table CD using B │ │ │ │ │ +00007220: 494f 530a 6675 6e63 7469 6f6e 732e 0a0a IOS.functions... │ │ │ │ │ +00007230: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ +00007240: 6f2c 2020 4e6f 6465 3a20 4465 7669 6365 o, Node: Device │ │ │ │ │ +00007250: 206d 6170 2c20 204e 6578 743a 2042 494f map, Next: BIO │ │ │ │ │ +00007260: 5320 696e 7374 616c 6c61 7469 6f6e 2c20 S installation, │ │ │ │ │ +00007270: 2050 7265 763a 204d 616b 696e 6720 6120 Prev: Making a │ │ │ │ │ +00007280: 4752 5542 2062 6f6f 7461 626c 6520 4344 GRUB bootable CD │ │ │ │ │ +00007290: 2d52 4f4d 2c20 2055 703a 2049 6e73 7461 -ROM, Up: Insta │ │ │ │ │ +000072a0: 6c6c 6174 696f 6e0a 0a34 2e33 2054 6865 llation..4.3 The │ │ │ │ │ +000072b0: 206d 6170 2062 6574 7765 656e 2042 494f map between BIO │ │ │ │ │ +000072c0: 5320 6472 6976 6573 2061 6e64 204f 5320 S drives and OS │ │ │ │ │ +000072d0: 6465 7669 6365 730a 3d3d 3d3d 3d3d 3d3d devices.======== │ │ │ │ │ 000072e0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 000072f0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00007300: 3d3d 3d3d 3d3d 3d3d 0a0a 4966 2074 6865 ========..If the │ │ │ │ │ -00007310: 2064 6576 6963 6520 6d61 7020 6669 6c65 device map file │ │ │ │ │ -00007320: 2065 7869 7374 732c 2074 6865 2047 5255 exists, the GRU │ │ │ │ │ -00007330: 4220 7574 696c 6974 6965 7320 2827 6772 B utilities ('gr │ │ │ │ │ -00007340: 7562 2d70 726f 6265 272c 2065 7463 2e29 ub-probe', etc.) │ │ │ │ │ -00007350: 0a72 6561 6420 6974 2074 6f20 6d61 7020 .read it to map │ │ │ │ │ -00007360: 4249 4f53 2064 7269 7665 7320 746f 204f BIOS drives to O │ │ │ │ │ -00007370: 5320 6465 7669 6365 732e 2020 5468 6973 S devices. This │ │ │ │ │ -00007380: 2066 696c 6520 636f 6e73 6973 7473 206f file consists o │ │ │ │ │ -00007390: 6620 6c69 6e65 730a 6c69 6b65 2074 6869 f lines.like thi │ │ │ │ │ -000073a0: 733a 0a0a 2020 2020 2028 4445 5649 4345 s:.. (DEVICE │ │ │ │ │ -000073b0: 2920 4649 4c45 0a0a 2020 2044 4556 4943 ) FILE.. DEVIC │ │ │ │ │ -000073c0: 4520 6973 2061 2064 7269 7665 2073 7065 E is a drive spe │ │ │ │ │ -000073d0: 6369 6669 6564 2069 6e20 7468 6520 4752 cified in the GR │ │ │ │ │ -000073e0: 5542 2073 796e 7461 7820 282a 6e6f 7465 UB syntax (*note │ │ │ │ │ -000073f0: 2044 6576 6963 650a 7379 6e74 6178 3a3a Device.syntax:: │ │ │ │ │ -00007400: 292c 2061 6e64 2046 494c 4520 6973 2061 ), and FILE is a │ │ │ │ │ -00007410: 6e20 4f53 2066 696c 652c 2077 6869 6368 n OS file, which │ │ │ │ │ -00007420: 2069 7320 6e6f 726d 616c 6c79 2061 2064 is normally a d │ │ │ │ │ -00007430: 6576 6963 6520 6669 6c65 2e0a 0a20 2020 evice file... │ │ │ │ │ -00007440: 4869 7374 6f72 6963 616c 6c79 2c20 7468 Historically, th │ │ │ │ │ -00007450: 6520 6465 7669 6365 206d 6170 2066 696c e device map fil │ │ │ │ │ -00007460: 6520 7761 7320 7573 6564 2062 6563 6175 e was used becau │ │ │ │ │ -00007470: 7365 2047 5255 4220 6465 7669 6365 206e se GRUB device n │ │ │ │ │ -00007480: 616d 6573 0a68 6164 2074 6f20 6265 2075 ames.had to be u │ │ │ │ │ -00007490: 7365 6420 696e 2074 6865 2063 6f6e 6669 sed in the confi │ │ │ │ │ -000074a0: 6775 7261 7469 6f6e 2066 696c 652c 2061 guration file, a │ │ │ │ │ -000074b0: 6e64 2074 6865 7920 7765 7265 2064 6572 nd they were der │ │ │ │ │ -000074c0: 6976 6564 2066 726f 6d0a 4249 4f53 2064 ived from.BIOS d │ │ │ │ │ -000074d0: 7269 7665 206e 756d 6265 7273 2e20 2054 rive numbers. T │ │ │ │ │ -000074e0: 6865 206d 6170 2062 6574 7765 656e 2042 he map between B │ │ │ │ │ -000074f0: 494f 5320 6472 6976 6573 2061 6e64 204f IOS drives and O │ │ │ │ │ -00007500: 5320 6465 7669 6365 7320 6361 6e6e 6f74 S devices cannot │ │ │ │ │ -00007510: 0a61 6c77 6179 7320 6265 2067 7565 7373 .always be guess │ │ │ │ │ -00007520: 6564 2063 6f72 7265 6374 6c79 3a20 666f ed correctly: fo │ │ │ │ │ -00007530: 7220 6578 616d 706c 652c 2047 5255 4220 r example, GRUB │ │ │ │ │ -00007540: 7769 6c6c 2067 6574 2074 6865 206f 7264 will get the ord │ │ │ │ │ -00007550: 6572 2077 726f 6e67 0a69 6620 796f 7520 er wrong.if you │ │ │ │ │ -00007560: 6578 6368 616e 6765 2074 6865 2062 6f6f exchange the boo │ │ │ │ │ -00007570: 7420 7365 7175 656e 6365 2062 6574 7765 t sequence betwe │ │ │ │ │ -00007580: 656e 2049 4445 2061 6e64 2053 4353 4920 en IDE and SCSI │ │ │ │ │ -00007590: 696e 2079 6f75 7220 4249 4f53 2e0a 0a20 in your BIOS... │ │ │ │ │ -000075a0: 2020 556e 666f 7274 756e 6174 656c 792c Unfortunately, │ │ │ │ │ -000075b0: 2065 7665 6e20 4f53 2064 6576 6963 6520 even OS device │ │ │ │ │ -000075c0: 6e61 6d65 7320 6172 6520 6e6f 7420 616c names are not al │ │ │ │ │ -000075d0: 7761 7973 2073 7461 626c 652e 2020 4d6f ways stable. Mo │ │ │ │ │ -000075e0: 6465 726e 0a76 6572 7369 6f6e 7320 6f66 dern.versions of │ │ │ │ │ -000075f0: 2074 6865 204c 696e 7578 206b 6572 6e65 the Linux kerne │ │ │ │ │ -00007600: 6c20 6d61 7920 7072 6f62 6520 6472 6976 l may probe driv │ │ │ │ │ -00007610: 6573 2069 6e20 6120 6469 6666 6572 656e es in a differen │ │ │ │ │ -00007620: 7420 6f72 6465 7220 6672 6f6d 0a62 6f6f t order from.boo │ │ │ │ │ -00007630: 7420 746f 2062 6f6f 742c 2061 6e64 2074 t to boot, and t │ │ │ │ │ -00007640: 6865 2070 7265 6669 7820 2827 2f64 6576 he prefix ('/dev │ │ │ │ │ -00007650: 2f68 642a 2720 7665 7273 7573 2027 2f64 /hd*' versus '/d │ │ │ │ │ -00007660: 6576 2f73 642a 2729 206d 6179 2063 6861 ev/sd*') may cha │ │ │ │ │ -00007670: 6e67 650a 6465 7065 6e64 696e 6720 6f6e nge.depending on │ │ │ │ │ -00007680: 2074 6865 2064 7269 7665 7220 7375 6273 the driver subs │ │ │ │ │ -00007690: 7973 7465 6d20 696e 2075 7365 2e20 2041 ystem in use. A │ │ │ │ │ -000076a0: 7320 6120 7265 7375 6c74 2c20 7468 6520 s a result, the │ │ │ │ │ -000076b0: 6465 7669 6365 206d 6170 0a66 696c 6520 device map.file │ │ │ │ │ -000076c0: 7265 7175 6972 6564 2066 7265 7175 656e required frequen │ │ │ │ │ -000076d0: 7420 6564 6974 696e 6720 6f6e 2073 6f6d t editing on som │ │ │ │ │ -000076e0: 6520 7379 7374 656d 732e 0a0a 2020 2047 e systems... G │ │ │ │ │ -000076f0: 5255 4220 6176 6f69 6473 2074 6869 7320 RUB avoids this │ │ │ │ │ -00007700: 7072 6f62 6c65 6d20 6e6f 7761 6461 7973 problem nowadays │ │ │ │ │ -00007710: 2062 7920 7573 696e 6720 5555 4944 7320 by using UUIDs │ │ │ │ │ -00007720: 6f72 2066 696c 6520 7379 7374 656d 0a6c or file system.l │ │ │ │ │ -00007730: 6162 656c 7320 7768 656e 2067 656e 6572 abels when gener │ │ │ │ │ -00007740: 6174 696e 6720 2767 7275 622e 6366 6727 ating 'grub.cfg' │ │ │ │ │ -00007750: 2c20 616e 6420 7765 2061 6476 6973 6520 , and we advise │ │ │ │ │ -00007760: 7468 6174 2079 6f75 2064 6f20 7468 6520 that you do the │ │ │ │ │ -00007770: 7361 6d65 0a66 6f72 2061 6e79 2063 7573 same.for any cus │ │ │ │ │ -00007780: 746f 6d20 6d65 6e75 2065 6e74 7269 6573 tom menu entries │ │ │ │ │ -00007790: 2079 6f75 2077 7269 7465 2e20 2049 6620 you write. If │ │ │ │ │ -000077a0: 7468 6520 6465 7669 6365 206d 6170 2066 the device map f │ │ │ │ │ -000077b0: 696c 6520 646f 6573 206e 6f74 0a65 7869 ile does not.exi │ │ │ │ │ -000077c0: 7374 2c20 7468 656e 2074 6865 2047 5255 st, then the GRU │ │ │ │ │ -000077d0: 4220 7574 696c 6974 6965 7320 7769 6c6c B utilities will │ │ │ │ │ -000077e0: 2061 7373 756d 6520 6120 7465 6d70 6f72 assume a tempor │ │ │ │ │ -000077f0: 6172 7920 6465 7669 6365 206d 6170 206f ary device map o │ │ │ │ │ -00007800: 6e20 7468 650a 666c 792e 2020 5468 6973 n the.fly. This │ │ │ │ │ -00007810: 2069 7320 6f66 7465 6e20 676f 6f64 2065 is often good e │ │ │ │ │ -00007820: 6e6f 7567 682c 2070 6172 7469 6375 6c61 nough, particula │ │ │ │ │ -00007830: 726c 7920 696e 2074 6865 2063 6f6d 6d6f rly in the commo │ │ │ │ │ -00007840: 6e20 6361 7365 206f 660a 7369 6e67 6c65 n case of.single │ │ │ │ │ -00007850: 2d64 6973 6b20 7379 7374 656d 732e 0a0a -disk systems... │ │ │ │ │ -00007860: 2020 2048 6f77 6576 6572 2c20 7468 6520 However, the │ │ │ │ │ -00007870: 6465 7669 6365 206d 6170 2066 696c 6520 device map file │ │ │ │ │ -00007880: 6973 206e 6f74 2065 6e74 6972 656c 7920 is not entirely │ │ │ │ │ -00007890: 6f62 736f 6c65 7465 2079 6574 2c20 616e obsolete yet, an │ │ │ │ │ -000078a0: 6420 6974 2069 730a 7573 6564 2066 6f72 d it is.used for │ │ │ │ │ -000078b0: 206f 7665 7272 6964 696e 6720 7768 656e overriding when │ │ │ │ │ -000078c0: 2063 7572 7265 6e74 2065 6e76 6972 6f6e current environ │ │ │ │ │ -000078d0: 6d65 6e74 2069 7320 6469 6666 6572 656e ment is differen │ │ │ │ │ -000078e0: 7420 6672 6f6d 2074 6865 206f 6e65 0a6f t from the one.o │ │ │ │ │ -000078f0: 6e20 626f 6f74 2e20 204d 6f73 7420 636f n boot. Most co │ │ │ │ │ -00007900: 6d6d 6f6e 2063 6173 6520 6973 2069 6620 mmon case is if │ │ │ │ │ -00007910: 796f 7520 7573 6520 6120 7061 7274 6974 you use a partit │ │ │ │ │ -00007920: 696f 6e20 6f72 206c 6f67 6963 616c 2076 ion or logical v │ │ │ │ │ -00007930: 6f6c 756d 650a 6173 2061 2064 6973 6b20 olume.as a disk │ │ │ │ │ -00007940: 666f 7220 7669 7274 7561 6c20 6d61 6368 for virtual mach │ │ │ │ │ -00007950: 696e 652e 2020 596f 7520 6361 6e20 7075 ine. You can pu │ │ │ │ │ -00007960: 7420 616e 7920 636f 6d6d 656e 7473 2069 t any comments i │ │ │ │ │ -00007970: 6e20 7468 6520 6669 6c65 2069 660a 6e65 n the file if.ne │ │ │ │ │ -00007980: 6564 6564 2c20 6173 2074 6865 2047 5255 eded, as the GRU │ │ │ │ │ -00007990: 4220 7574 696c 6974 6965 7320 6173 7375 B utilities assu │ │ │ │ │ -000079a0: 6d65 2074 6861 7420 6120 6c69 6e65 2069 me that a line i │ │ │ │ │ -000079b0: 7320 6a75 7374 2061 2063 6f6d 6d65 6e74 s just a comment │ │ │ │ │ -000079c0: 2069 660a 7468 6520 6669 7273 7420 6368 if.the first ch │ │ │ │ │ -000079d0: 6172 6163 7465 7220 6973 2027 2327 2e0a aracter is '#'.. │ │ │ │ │ -000079e0: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ -000079f0: 666f 2c20 204e 6f64 653a 2042 494f 5320 fo, Node: BIOS │ │ │ │ │ -00007a00: 696e 7374 616c 6c61 7469 6f6e 2c20 2050 installation, P │ │ │ │ │ -00007a10: 7265 763a 2044 6576 6963 6520 6d61 702c rev: Device map, │ │ │ │ │ -00007a20: 2020 5570 3a20 496e 7374 616c 6c61 7469 Up: Installati │ │ │ │ │ -00007a30: 6f6e 0a0a 342e 3420 4249 4f53 2069 6e73 on..4.4 BIOS ins │ │ │ │ │ -00007a40: 7461 6c6c 6174 696f 6e0a 3d3d 3d3d 3d3d tallation.====== │ │ │ │ │ -00007a50: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a ===============. │ │ │ │ │ -00007a60: 0a4d 4252 0a3d 3d3d 0a0a 5468 6520 7061 .MBR.===..The pa │ │ │ │ │ -00007a70: 7274 6974 696f 6e20 7461 626c 6520 666f rtition table fo │ │ │ │ │ -00007a80: 726d 6174 2074 7261 6469 7469 6f6e 616c rmat traditional │ │ │ │ │ -00007a90: 6c79 2075 7365 6420 6f6e 2050 4320 4249 ly used on PC BI │ │ │ │ │ -00007aa0: 4f53 2070 6c61 7466 6f72 6d73 2069 730a OS platforms is. │ │ │ │ │ -00007ab0: 6361 6c6c 6564 2074 6865 204d 6173 7465 called the Maste │ │ │ │ │ -00007ac0: 7220 426f 6f74 2052 6563 6f72 6420 284d r Boot Record (M │ │ │ │ │ -00007ad0: 4252 2920 666f 726d 6174 3b20 7468 6973 BR) format; this │ │ │ │ │ -00007ae0: 2069 7320 7468 6520 666f 726d 6174 2074 is the format t │ │ │ │ │ -00007af0: 6861 740a 616c 6c6f 7773 2075 7020 746f hat.allows up to │ │ │ │ │ -00007b00: 2066 6f75 7220 7072 696d 6172 7920 7061 four primary pa │ │ │ │ │ -00007b10: 7274 6974 696f 6e73 2061 6e64 2061 6464 rtitions and add │ │ │ │ │ -00007b20: 6974 696f 6e61 6c20 6c6f 6769 6361 6c20 itional logical │ │ │ │ │ -00007b30: 7061 7274 6974 696f 6e73 2e0a 5769 7468 partitions..With │ │ │ │ │ -00007b40: 2074 6869 7320 7061 7274 6974 696f 6e20 this partition │ │ │ │ │ -00007b50: 7461 626c 6520 666f 726d 6174 2c20 7468 table format, th │ │ │ │ │ -00007b60: 6572 6520 6172 6520 7477 6f20 7761 7973 ere are two ways │ │ │ │ │ -00007b70: 2074 6f20 696e 7374 616c 6c20 4752 5542 to install GRUB │ │ │ │ │ -00007b80: 3a20 6974 0a63 616e 2062 6520 656d 6265 : it.can be embe │ │ │ │ │ -00007b90: 6464 6564 2069 6e20 7468 6520 6172 6561 dded in the area │ │ │ │ │ -00007ba0: 2062 6574 7765 656e 2074 6865 204d 4252 between the MBR │ │ │ │ │ -00007bb0: 2061 6e64 2074 6865 2066 6972 7374 2070 and the first p │ │ │ │ │ -00007bc0: 6172 7469 7469 6f6e 0a28 6361 6c6c 6564 artition.(called │ │ │ │ │ -00007bd0: 2062 7920 7661 7269 6f75 7320 6e61 6d65 by various name │ │ │ │ │ -00007be0: 732c 2073 7563 6820 6173 2074 6865 2022 s, such as the " │ │ │ │ │ -00007bf0: 626f 6f74 2074 7261 636b 222c 2022 4d42 boot track", "MB │ │ │ │ │ -00007c00: 5220 6761 7022 2c20 6f72 0a22 656d 6265 R gap", or."embe │ │ │ │ │ -00007c10: 6464 696e 6720 6172 6561 222c 2061 6e64 dding area", and │ │ │ │ │ -00007c20: 2077 6869 6368 2069 7320 7573 7561 6c6c which is usuall │ │ │ │ │ -00007c30: 7920 6174 206c 6561 7374 2031 3030 3020 y at least 1000 │ │ │ │ │ -00007c40: 4b69 4229 2c20 6f72 2074 6865 2063 6f72 KiB), or the cor │ │ │ │ │ -00007c50: 650a 696d 6167 6520 6361 6e20 6265 2069 e.image can be i │ │ │ │ │ -00007c60: 6e73 7461 6c6c 6564 2069 6e20 6120 6669 nstalled in a fi │ │ │ │ │ -00007c70: 6c65 2073 7973 7465 6d20 616e 6420 6120 le system and a │ │ │ │ │ -00007c80: 6c69 7374 206f 6620 7468 6520 626c 6f63 list of the bloc │ │ │ │ │ -00007c90: 6b73 2074 6861 740a 6d61 6b65 2069 7420 ks that.make it │ │ │ │ │ -00007ca0: 7570 2063 616e 2062 6520 7374 6f72 6564 up can be stored │ │ │ │ │ -00007cb0: 2069 6e20 7468 6520 6669 7273 7420 7365 in the first se │ │ │ │ │ -00007cc0: 6374 6f72 206f 6620 7468 6174 2070 6172 ctor of that par │ │ │ │ │ -00007cd0: 7469 7469 6f6e 2e0a 0a20 2020 4d6f 6465 tition... Mode │ │ │ │ │ -00007ce0: 726e 2074 6f6f 6c73 2075 7375 616c 6c79 rn tools usually │ │ │ │ │ -00007cf0: 206c 6561 7665 204d 4252 2067 6170 206f leave MBR gap o │ │ │ │ │ -00007d00: 6620 6174 206c 6561 7374 2031 3032 3320 f at least 1023 │ │ │ │ │ -00007d10: 4b69 422e 2054 6869 7320 616d 6f75 6e74 KiB. This amount │ │ │ │ │ -00007d20: 0a69 7320 7375 6666 6963 6965 6e74 2074 .is sufficient t │ │ │ │ │ -00007d30: 6f20 636f 7665 7220 6d6f 7374 2063 6f6e o cover most con │ │ │ │ │ -00007d40: 6669 6775 7261 7469 6f6e 732e 2020 4865 figurations. He │ │ │ │ │ -00007d50: 6e63 6520 7468 6973 2076 616c 7565 2069 nce this value i │ │ │ │ │ -00007d60: 730a 7265 636f 6d6d 656e 6465 6420 6279 s.recommended by │ │ │ │ │ -00007d70: 2074 6865 2047 5255 4220 7465 616d 2e0a the GRUB team.. │ │ │ │ │ -00007d80: 0a20 2020 4869 7374 6f72 6963 616c 6c79 . Historically │ │ │ │ │ -00007d90: 206d 616e 7920 746f 6f6c 7320 6c65 6674 many tools left │ │ │ │ │ -00007da0: 206f 6e6c 7920 3331 204b 6942 206f 6620 only 31 KiB of │ │ │ │ │ -00007db0: 7370 6163 652e 2020 5468 6973 2069 7320 space. This is │ │ │ │ │ -00007dc0: 6e6f 740a 656e 6f75 6768 2074 6f20 7061 not.enough to pa │ │ │ │ │ -00007dd0: 7273 6520 7265 6c69 6162 6c79 2064 6966 rse reliably dif │ │ │ │ │ -00007de0: 6669 6375 6c74 2073 7472 7563 7475 7265 ficult structure │ │ │ │ │ -00007df0: 7320 6c69 6b65 2042 7472 6673 2c20 5a46 s like Btrfs, ZF │ │ │ │ │ -00007e00: 532c 2052 4149 4420 6f72 0a4c 564d 2c20 S, RAID or.LVM, │ │ │ │ │ -00007e10: 6f72 2074 6f20 7573 6520 6469 6666 6963 or to use diffic │ │ │ │ │ -00007e20: 756c 7420 6469 736b 2061 6363 6573 7320 ult disk access │ │ │ │ │ -00007e30: 6d65 7468 6f64 7320 6c69 6b65 2061 6863 methods like ahc │ │ │ │ │ -00007e40: 692e 2020 4865 6e63 6520 4752 5542 2077 i. Hence GRUB w │ │ │ │ │ -00007e50: 696c 6c0a 7761 726e 2069 6620 6174 7465 ill.warn if atte │ │ │ │ │ -00007e60: 6d70 7465 6420 746f 2069 6e73 7461 6c6c mpted to install │ │ │ │ │ -00007e70: 2069 6e74 6f20 736d 616c 6c20 4d42 5220 into small MBR │ │ │ │ │ -00007e80: 6761 7020 6578 6365 7074 2069 6e20 6120 gap except in a │ │ │ │ │ -00007e90: 736d 616c 6c20 6e75 6d62 6572 0a6f 6620 small number.of │ │ │ │ │ -00007ea0: 636f 6e66 6967 7572 6174 696f 6e73 2074 configurations t │ │ │ │ │ -00007eb0: 6861 7420 7765 7265 2067 7261 6e64 6661 hat were grandfa │ │ │ │ │ -00007ec0: 7468 6572 6564 2e20 2054 6865 2067 7261 thered. The gra │ │ │ │ │ -00007ed0: 6e64 6661 7468 6572 6564 2063 6f6e 6669 ndfathered confi │ │ │ │ │ -00007ee0: 670a 6d75 7374 3a0a 0a20 2020 2a20 7573 g.must:.. * us │ │ │ │ │ -00007ef0: 6520 6269 6f73 6469 736b 2061 7320 6469 e biosdisk as di │ │ │ │ │ -00007f00: 736b 2061 6363 6573 7320 6d6f 6475 6c65 sk access module │ │ │ │ │ -00007f10: 2066 6f72 2027 2f62 6f6f 7427 202a 206e for '/boot' * n │ │ │ │ │ -00007f20: 6f74 2075 7365 2061 6e79 0a61 6464 6974 ot use any.addit │ │ │ │ │ -00007f30: 696f 6e61 6c20 7061 7274 6974 696f 6e20 ional partition │ │ │ │ │ -00007f40: 6d61 7073 2074 6f20 6163 6365 7373 2027 maps to access ' │ │ │ │ │ -00007f50: 2f62 6f6f 7427 202a 2027 2f62 6f6f 7427 /boot' * '/boot' │ │ │ │ │ -00007f60: 206d 7573 7420 6265 206f 6e20 6f6e 6520 must be on one │ │ │ │ │ -00007f70: 6f66 0a66 6f6c 6c6f 7769 6e67 2066 696c of.following fil │ │ │ │ │ -00007f80: 6573 7973 7465 6d73 3a20 2a20 4146 4653 esystems: * AFFS │ │ │ │ │ -00007f90: 2c20 4146 532c 2042 4653 2c20 6370 696f , AFS, BFS, cpio │ │ │ │ │ -00007fa0: 2c20 6e65 7763 2c20 6f64 632c 2065 7874 , newc, odc, ext │ │ │ │ │ -00007fb0: 322f 332f 342c 2046 4154 2c0a 6578 4641 2/3/4, FAT,.exFA │ │ │ │ │ -00007fc0: 542c 2046 3246 532c 2048 4653 2c20 756e T, F2FS, HFS, un │ │ │ │ │ -00007fd0: 636f 6d70 7265 7373 6564 2048 4653 2b2c compressed HFS+, │ │ │ │ │ -00007fe0: 2049 534f 3936 3630 2c20 4a46 532c 204d ISO9660, JFS, M │ │ │ │ │ -00007ff0: 696e 6978 2c20 4d69 6e69 7832 2c0a 4d69 inix, Minix2,.Mi │ │ │ │ │ -00008000: 6e69 7833 2c20 4e49 4c46 5332 2c20 4e54 nix3, NILFS2, NT │ │ │ │ │ -00008010: 4653 2c20 5265 6973 6572 4653 2c20 524f FS, ReiserFS, RO │ │ │ │ │ -00008020: 4d46 532c 2053 4653 2c20 7461 722c 2055 MFS, SFS, tar, U │ │ │ │ │ -00008030: 4446 2c20 5546 5331 2c20 5546 5332 2c20 DF, UFS1, UFS2, │ │ │ │ │ -00008040: 5846 530a 0a20 2020 4d42 5220 6761 7020 XFS.. MBR gap │ │ │ │ │ -00008050: 6861 7320 6665 7720 7465 6368 6e69 6361 has few technica │ │ │ │ │ -00008060: 6c20 7072 6f62 6c65 6d73 2e20 2054 6865 l problems. The │ │ │ │ │ -00008070: 7265 2069 7320 6e6f 2077 6179 2074 6f20 re is no way to │ │ │ │ │ -00008080: 7265 7365 7276 6520 7370 6163 650a 696e reserve space.in │ │ │ │ │ -00008090: 2074 6865 2065 6d62 6564 6469 6e67 2061 the embedding a │ │ │ │ │ -000080a0: 7265 6120 7769 7468 2063 6f6d 706c 6574 rea with complet │ │ │ │ │ -000080b0: 6520 7361 6665 7479 2c20 616e 6420 736f e safety, and so │ │ │ │ │ -000080c0: 6d65 2070 726f 7072 6965 7461 7279 0a73 me proprietary.s │ │ │ │ │ -000080d0: 6f66 7477 6172 6520 6973 206b 6e6f 776e oftware is known │ │ │ │ │ -000080e0: 2074 6f20 7573 6520 6974 2074 6f20 6d61 to use it to ma │ │ │ │ │ -000080f0: 6b65 2069 7420 6469 6666 6963 756c 7420 ke it difficult │ │ │ │ │ -00008100: 666f 7220 7573 6572 7320 746f 2077 6f72 for users to wor │ │ │ │ │ -00008110: 6b0a 6172 6f75 6e64 206c 6963 656e 7369 k.around licensi │ │ │ │ │ -00008120: 6e67 2072 6573 7472 6963 7469 6f6e 732e ng restrictions. │ │ │ │ │ -00008130: 2020 4752 5542 2077 6f72 6b73 2069 7420 GRUB works it │ │ │ │ │ -00008140: 6172 6f75 6e64 2062 7920 6465 7465 6374 around by detect │ │ │ │ │ -00008150: 696e 670a 7365 6374 6f72 7320 6279 206f ing.sectors by o │ │ │ │ │ -00008160: 7468 6572 2073 6f66 7477 6172 6520 616e ther software an │ │ │ │ │ -00008170: 6420 6176 6f69 6469 6e67 2074 6865 6d20 d avoiding them │ │ │ │ │ -00008180: 616e 6420 7072 6f74 6563 7469 6e67 2069 and protecting i │ │ │ │ │ -00008190: 7473 206f 776e 0a73 6563 746f 7273 2075 ts own.sectors u │ │ │ │ │ -000081a0: 7369 6e67 2052 6565 642d 536f 6c6f 6d6f sing Reed-Solomo │ │ │ │ │ -000081b0: 6e20 656e 636f 6469 6e67 2e0a 0a20 2020 n encoding... │ │ │ │ │ -000081c0: 4752 5542 2074 6561 6d20 7265 636f 6d6d GRUB team recomm │ │ │ │ │ -000081d0: 656e 6473 2068 6176 696e 6720 4d42 5220 ends having MBR │ │ │ │ │ -000081e0: 6761 7020 6f66 2061 7420 6c65 6173 7420 gap of at least │ │ │ │ │ -000081f0: 3130 3030 204b 6942 0a0a 2020 2053 686f 1000 KiB.. Sho │ │ │ │ │ -00008200: 756c 6420 6974 2062 6520 6e6f 7420 706f uld it be not po │ │ │ │ │ -00008210: 7373 6962 6c65 2047 5255 4220 6861 7320 ssible GRUB has │ │ │ │ │ -00008220: 7375 7070 6f72 7420 666f 7220 6120 6661 support for a fa │ │ │ │ │ -00008230: 6c6c 6261 636b 2073 6f6c 7574 696f 6e0a llback solution. │ │ │ │ │ -00008240: 7768 6963 6820 6973 2068 6561 7669 6c79 which is heavily │ │ │ │ │ -00008250: 2072 6563 6f6d 6d65 6e64 6564 2061 6761 recommended aga │ │ │ │ │ -00008260: 696e 7374 2e20 2049 6e73 7461 6c6c 696e inst. Installin │ │ │ │ │ -00008270: 6720 746f 2061 2066 696c 6573 7973 7465 g to a filesyste │ │ │ │ │ -00008280: 6d20 6d65 616e 730a 7468 6174 2047 5255 m means.that GRU │ │ │ │ │ -00008290: 4220 6973 2076 756c 6e65 7261 626c 6520 B is vulnerable │ │ │ │ │ -000082a0: 746f 2069 7473 2062 6c6f 636b 7320 6265 to its blocks be │ │ │ │ │ -000082b0: 696e 6720 6d6f 7665 6420 6172 6f75 6e64 ing moved around │ │ │ │ │ -000082c0: 2062 7920 6669 6c65 7379 7374 656d 0a66 by filesystem.f │ │ │ │ │ -000082d0: 6561 7475 7265 7320 7375 6368 2061 7320 eatures such as │ │ │ │ │ -000082e0: 7461 696c 2070 6163 6b69 6e67 2c20 6f72 tail packing, or │ │ │ │ │ -000082f0: 2065 7665 6e20 6279 2061 6767 7265 7373 even by aggress │ │ │ │ │ -00008300: 6976 6520 6673 636b 0a69 6d70 6c65 6d65 ive fsck.impleme │ │ │ │ │ -00008310: 6e74 6174 696f 6e73 2c20 736f 2074 6869 ntations, so thi │ │ │ │ │ -00008320: 7320 6170 7072 6f61 6368 2069 7320 7175 s approach is qu │ │ │ │ │ -00008330: 6974 6520 6672 6167 696c 653b 2061 6e64 ite fragile; and │ │ │ │ │ -00008340: 2074 6869 7320 6170 7072 6f61 6368 0a63 this approach.c │ │ │ │ │ -00008350: 616e 206f 6e6c 7920 6265 2075 7365 6420 an only be used │ │ │ │ │ -00008360: 6966 2074 6865 2027 2f62 6f6f 7427 2066 if the '/boot' f │ │ │ │ │ -00008370: 696c 6573 7973 7465 6d20 6973 206f 6e20 ilesystem is on │ │ │ │ │ -00008380: 7468 6520 7361 6d65 2064 6973 6b20 7468 the same disk th │ │ │ │ │ -00008390: 6174 2074 6865 0a42 494f 5320 626f 6f74 at the.BIOS boot │ │ │ │ │ -000083a0: 7320 6672 6f6d 2c20 736f 2074 6861 7420 s from, so that │ │ │ │ │ -000083b0: 4752 5542 2064 6f65 7320 6e6f 7420 6861 GRUB does not ha │ │ │ │ │ -000083c0: 7665 2074 6f20 7265 6c79 206f 6e20 6775 ve to rely on gu │ │ │ │ │ -000083d0: 6573 7369 6e67 2042 494f 530a 6472 6976 essing BIOS.driv │ │ │ │ │ -000083e0: 6520 6e75 6d62 6572 732e 0a0a 2020 2054 e numbers... T │ │ │ │ │ -000083f0: 6865 2047 5255 4220 6465 7665 6c6f 706d he GRUB developm │ │ │ │ │ -00008400: 656e 7420 7465 616d 2067 656e 6572 616c ent team general │ │ │ │ │ -00008410: 6c79 2072 6563 6f6d 6d65 6e64 7320 656d ly recommends em │ │ │ │ │ -00008420: 6265 6464 696e 6720 4752 5542 2062 6566 bedding GRUB bef │ │ │ │ │ -00008430: 6f72 650a 7468 6520 6669 7273 7420 7061 ore.the first pa │ │ │ │ │ -00008440: 7274 6974 696f 6e2c 2075 6e6c 6573 7320 rtition, unless │ │ │ │ │ -00008450: 796f 7520 6861 7665 2073 7065 6369 616c you have special │ │ │ │ │ -00008460: 2072 6571 7569 7265 6d65 6e74 732e 2020 requirements. │ │ │ │ │ -00008470: 596f 7520 6d75 7374 0a65 6e73 7572 6520 You must.ensure │ │ │ │ │ -00008480: 7468 6174 2074 6865 2066 6972 7374 2070 that the first p │ │ │ │ │ -00008490: 6172 7469 7469 6f6e 2073 7461 7274 7320 artition starts │ │ │ │ │ -000084a0: 6174 206c 6561 7374 2031 3030 3020 4b69 at least 1000 Ki │ │ │ │ │ -000084b0: 4220 2832 3030 3020 7365 6374 6f72 7329 B (2000 sectors) │ │ │ │ │ -000084c0: 0a66 726f 6d20 7468 6520 7374 6172 7420 .from the start │ │ │ │ │ -000084d0: 6f66 2074 6865 2064 6973 6b3b 206f 6e20 of the disk; on │ │ │ │ │ -000084e0: 6d6f 6465 726e 2064 6973 6b73 2c20 6974 modern disks, it │ │ │ │ │ -000084f0: 2069 7320 6f66 7465 6e20 6120 7065 7266 is often a perf │ │ │ │ │ -00008500: 6f72 6d61 6e63 650a 6164 7661 6e74 6167 ormance.advantag │ │ │ │ │ -00008510: 6520 746f 2061 6c69 676e 2070 6172 7469 e to align parti │ │ │ │ │ -00008520: 7469 6f6e 7320 6f6e 206c 6172 6765 7220 tions on larger │ │ │ │ │ -00008530: 626f 756e 6461 7269 6573 2061 6e79 7761 boundaries anywa │ │ │ │ │ -00008540: 792c 2073 6f20 7468 6520 6669 7273 740a y, so the first. │ │ │ │ │ -00008550: 7061 7274 6974 696f 6e20 6d69 6768 7420 partition might │ │ │ │ │ -00008560: 7374 6172 7420 3120 4d69 4220 6672 6f6d start 1 MiB from │ │ │ │ │ -00008570: 2074 6865 2073 7461 7274 206f 6620 7468 the start of th │ │ │ │ │ -00008580: 6520 6469 736b 2e0a 0a47 5054 0a3d 3d3d e disk...GPT.=== │ │ │ │ │ -00008590: 0a0a 536f 6d65 206e 6577 6572 2073 7973 ..Some newer sys │ │ │ │ │ -000085a0: 7465 6d73 2075 7365 2074 6865 2047 5549 tems use the GUI │ │ │ │ │ -000085b0: 4420 5061 7274 6974 696f 6e20 5461 626c D Partition Tabl │ │ │ │ │ -000085c0: 6520 2847 5054 2920 666f 726d 6174 2e20 e (GPT) format. │ │ │ │ │ -000085d0: 2054 6869 7320 7761 730a 7370 6563 6966 This was.specif │ │ │ │ │ -000085e0: 6965 6420 6173 2070 6172 7420 6f66 2074 ied as part of t │ │ │ │ │ -000085f0: 6865 2045 7874 656e 7369 626c 6520 4669 he Extensible Fi │ │ │ │ │ -00008600: 726d 7761 7265 2049 6e74 6572 6661 6365 rmware Interface │ │ │ │ │ -00008610: 2028 4546 4929 2c20 6275 7420 6974 2063 (EFI), but it c │ │ │ │ │ -00008620: 616e 0a61 6c73 6f20 6265 2075 7365 6420 an.also be used │ │ │ │ │ -00008630: 6f6e 2042 494f 5320 706c 6174 666f 726d on BIOS platform │ │ │ │ │ -00008640: 7320 6966 2073 7973 7465 6d20 736f 6674 s if system soft │ │ │ │ │ -00008650: 7761 7265 2073 7570 706f 7274 7320 6974 ware supports it │ │ │ │ │ -00008660: 3b20 666f 720a 6578 616d 706c 652c 2047 ; for.example, G │ │ │ │ │ -00008670: 5255 4220 616e 6420 474e 552f 4c69 6e75 RUB and GNU/Linu │ │ │ │ │ -00008680: 7820 6361 6e20 6265 2075 7365 6420 696e x can be used in │ │ │ │ │ -00008690: 2074 6869 7320 636f 6e66 6967 7572 6174 this configurat │ │ │ │ │ -000086a0: 696f 6e2e 2020 5769 7468 0a74 6869 7320 ion. With.this │ │ │ │ │ -000086b0: 666f 726d 6174 2c20 6974 2069 7320 706f format, it is po │ │ │ │ │ -000086c0: 7373 6962 6c65 2074 6f20 7265 7365 7276 ssible to reserv │ │ │ │ │ -000086d0: 6520 6120 7768 6f6c 6520 7061 7274 6974 e a whole partit │ │ │ │ │ -000086e0: 696f 6e20 666f 7220 4752 5542 2c0a 6361 ion for GRUB,.ca │ │ │ │ │ -000086f0: 6c6c 6564 2074 6865 2042 494f 5320 426f lled the BIOS Bo │ │ │ │ │ -00008700: 6f74 2050 6172 7469 7469 6f6e 2e20 2047 ot Partition. G │ │ │ │ │ -00008710: 5255 4220 6361 6e20 7468 656e 2062 6520 RUB can then be │ │ │ │ │ -00008720: 656d 6265 6464 6564 2069 6e74 6f20 7468 embedded into th │ │ │ │ │ -00008730: 6174 0a70 6172 7469 7469 6f6e 2077 6974 at.partition wit │ │ │ │ │ -00008740: 686f 7574 2074 6865 2072 6973 6b20 6f66 hout the risk of │ │ │ │ │ -00008750: 2062 6569 6e67 206f 7665 7277 7269 7474 being overwritt │ │ │ │ │ -00008760: 656e 2062 7920 6f74 6865 7220 736f 6674 en by other soft │ │ │ │ │ -00008770: 7761 7265 2061 6e64 0a77 6974 686f 7574 ware and.without │ │ │ │ │ -00008780: 2062 6569 6e67 2063 6f6e 7461 696e 6564 being contained │ │ │ │ │ -00008790: 2069 6e20 6120 6669 6c65 7379 7374 656d in a filesystem │ │ │ │ │ -000087a0: 2077 6869 6368 206d 6967 6874 206d 6f76 which might mov │ │ │ │ │ -000087b0: 6520 6974 7320 626c 6f63 6b73 0a61 726f e its blocks.aro │ │ │ │ │ -000087c0: 756e 642e 0a0a 2020 2057 6865 6e20 6372 und... When cr │ │ │ │ │ -000087d0: 6561 7469 6e67 2061 2042 494f 5320 426f eating a BIOS Bo │ │ │ │ │ -000087e0: 6f74 2050 6172 7469 7469 6f6e 206f 6e20 ot Partition on │ │ │ │ │ -000087f0: 6120 4750 5420 7379 7374 656d 2c20 796f a GPT system, yo │ │ │ │ │ -00008800: 7520 7368 6f75 6c64 206d 616b 650a 7375 u should make.su │ │ │ │ │ -00008810: 7265 2074 6861 7420 6974 2069 7320 6174 re that it is at │ │ │ │ │ -00008820: 206c 6561 7374 2033 3120 4b69 4220 696e least 31 KiB in │ │ │ │ │ -00008830: 2073 697a 652e 2020 2847 5054 2d66 6f72 size. (GPT-for │ │ │ │ │ -00008840: 6d61 7474 6564 2064 6973 6b73 2061 7265 matted disks are │ │ │ │ │ -00008850: 206e 6f74 0a75 7375 616c 6c79 2070 6172 not.usually par │ │ │ │ │ -00008860: 7469 6375 6c61 726c 7920 736d 616c 6c2c ticularly small, │ │ │ │ │ -00008870: 2073 6f20 7765 2072 6563 6f6d 6d65 6e64 so we recommend │ │ │ │ │ -00008880: 2074 6861 7420 796f 7520 6d61 6b65 2069 that you make i │ │ │ │ │ -00008890: 7420 6c61 7267 6572 2074 6861 6e0a 7468 t larger than.th │ │ │ │ │ -000088a0: 6520 6261 7265 206d 696e 696d 756d 2c20 e bare minimum, │ │ │ │ │ -000088b0: 7375 6368 2061 7320 3120 4d69 422c 2074 such as 1 MiB, t │ │ │ │ │ -000088c0: 6f20 616c 6c6f 7720 706c 656e 7479 206f o allow plenty o │ │ │ │ │ -000088d0: 6620 726f 6f6d 2066 6f72 2067 726f 7774 f room for growt │ │ │ │ │ -000088e0: 682e 290a 596f 7520 6d75 7374 2061 6c73 h.).You must als │ │ │ │ │ -000088f0: 6f20 6d61 6b65 2073 7572 6520 7468 6174 o make sure that │ │ │ │ │ -00008900: 2069 7420 6861 7320 7468 6520 7072 6f70 it has the prop │ │ │ │ │ -00008910: 6572 2070 6172 7469 7469 6f6e 2074 7970 er partition typ │ │ │ │ │ -00008920: 652e 2020 5573 696e 670a 474e 5520 5061 e. Using.GNU Pa │ │ │ │ │ -00008930: 7274 6564 2c20 796f 7520 6361 6e20 7365 rted, you can se │ │ │ │ │ -00008940: 7420 7468 6973 2075 7369 6e67 2061 2063 t this using a c │ │ │ │ │ -00008950: 6f6d 6d61 6e64 2073 7563 6820 6173 2074 ommand such as t │ │ │ │ │ -00008960: 6865 2066 6f6c 6c6f 7769 6e67 3a0a 0a20 he following:.. │ │ │ │ │ -00008970: 2020 2020 2320 7061 7274 6564 202f 6465 # parted /de │ │ │ │ │ -00008980: 762f 4449 534b 2073 6574 2050 4152 5449 v/DISK set PARTI │ │ │ │ │ -00008990: 5449 4f4e 2d4e 554d 4245 5220 6269 6f73 TION-NUMBER bios │ │ │ │ │ -000089a0: 5f67 7275 6220 6f6e 0a0a 2020 2049 6620 _grub on.. If │ │ │ │ │ -000089b0: 796f 7520 6172 6520 7573 696e 6720 6764 you are using gd │ │ │ │ │ -000089c0: 6973 6b2c 2073 6574 2074 6865 2070 6172 isk, set the par │ │ │ │ │ -000089d0: 7469 7469 6f6e 2074 7970 6520 746f 2027 tition type to ' │ │ │ │ │ -000089e0: 3078 4546 3032 272e 2020 5769 7468 0a70 0xEF02'. With.p │ │ │ │ │ -000089f0: 6172 7469 7469 6f6e 696e 6720 7072 6f67 artitioning prog │ │ │ │ │ -00008a00: 7261 6d73 2074 6861 7420 7265 7175 6972 rams that requir │ │ │ │ │ -00008a10: 6520 7365 7474 696e 6720 7468 6520 4755 e setting the GU │ │ │ │ │ -00008a20: 4944 2064 6972 6563 746c 792c 2069 7420 ID directly, it │ │ │ │ │ -00008a30: 7368 6f75 6c64 0a62 6520 2732 3136 3836 should.be '21686 │ │ │ │ │ -00008a40: 3134 382d 3634 3439 2d36 6536 662d 3734 148-6449-6e6f-74 │ │ │ │ │ -00008a50: 3465 3635 3635 3634 3435 3436 3439 272e 4e656564454649'. │ │ │ │ │ -00008a60: 0a0a 2020 202a 4361 7574 696f 6e3a 2a20 .. *Caution:* │ │ │ │ │ -00008a70: 4265 2076 6572 7920 6361 7265 6675 6c20 Be very careful │ │ │ │ │ -00008a80: 7768 6963 6820 7061 7274 6974 696f 6e20 which partition │ │ │ │ │ -00008a90: 796f 7520 7365 6c65 6374 2120 2057 6865 you select! Whe │ │ │ │ │ -00008aa0: 6e20 4752 5542 0a66 696e 6473 2061 2042 n GRUB.finds a B │ │ │ │ │ -00008ab0: 494f 5320 426f 6f74 2050 6172 7469 7469 IOS Boot Partiti │ │ │ │ │ -00008ac0: 6f6e 2064 7572 696e 6720 696e 7374 616c on during instal │ │ │ │ │ -00008ad0: 6c61 7469 6f6e 2c20 6974 2077 696c 6c20 lation, it will │ │ │ │ │ -00008ae0: 6175 746f 6d61 7469 6361 6c6c 790a 6f76 automatically.ov │ │ │ │ │ -00008af0: 6572 7772 6974 6520 7061 7274 206f 6620 erwrite part of │ │ │ │ │ -00008b00: 6974 2e20 204d 616b 6520 7375 7265 2074 it. Make sure t │ │ │ │ │ -00008b10: 6861 7420 7468 6520 7061 7274 6974 696f hat the partitio │ │ │ │ │ -00008b20: 6e20 646f 6573 206e 6f74 2063 6f6e 7461 n does not conta │ │ │ │ │ -00008b30: 696e 2061 6e79 0a6f 7468 6572 2064 6174 in any.other dat │ │ │ │ │ -00008b40: 612e 0a0a 1f0a 4669 6c65 3a20 6772 7562 a.....File: grub │ │ │ │ │ -00008b50: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 426f .info, Node: Bo │ │ │ │ │ -00008b60: 6f74 696e 672c 2020 4e65 7874 3a20 436f oting, Next: Co │ │ │ │ │ -00008b70: 6e66 6967 7572 6174 696f 6e2c 2020 5072 nfiguration, Pr │ │ │ │ │ -00008b80: 6576 3a20 496e 7374 616c 6c61 7469 6f6e ev: Installation │ │ │ │ │ -00008b90: 2c20 2055 703a 2054 6f70 0a0a 3520 426f , Up: Top..5 Bo │ │ │ │ │ -00008ba0: 6f74 696e 670a 2a2a 2a2a 2a2a 2a2a 2a0a oting.*********. │ │ │ │ │ -00008bb0: 0a47 5255 4220 6361 6e20 6c6f 6164 204d .GRUB can load M │ │ │ │ │ -00008bc0: 756c 7469 626f 6f74 2d63 6f6d 706c 6961 ultiboot-complia │ │ │ │ │ -00008bd0: 6e74 206b 6572 6e65 6c73 2069 6e20 6120 nt kernels in a │ │ │ │ │ -00008be0: 636f 6e73 6973 7465 6e74 2077 6179 2c20 consistent way, │ │ │ │ │ -00008bf0: 6275 7420 666f 720a 736f 6d65 2066 7265 but for.some fre │ │ │ │ │ -00008c00: 6520 6f70 6572 6174 696e 6720 7379 7374 e operating syst │ │ │ │ │ -00008c10: 656d 7320 796f 7520 6e65 6564 2074 6f20 ems you need to │ │ │ │ │ -00008c20: 7573 6520 736f 6d65 204f 532d 7370 6563 use some OS-spec │ │ │ │ │ -00008c30: 6966 6963 206d 6167 6963 2e0a 0a2a 204d ific magic...* M │ │ │ │ │ -00008c40: 656e 753a 0a0a 2a20 4765 6e65 7261 6c20 enu:..* General │ │ │ │ │ -00008c50: 626f 6f74 206d 6574 686f 6473 3a3a 2020 boot methods:: │ │ │ │ │ -00008c60: 2020 2020 2020 486f 7720 746f 2062 6f6f How to boo │ │ │ │ │ -00008c70: 7420 4f53 6573 2077 6974 6820 4752 5542 t OSes with GRUB │ │ │ │ │ -00008c80: 2067 656e 6572 616c 6c79 0a2a 204c 6f6f generally.* Loo │ │ │ │ │ -00008c90: 7062 6163 6b20 626f 6f74 696e 673a 3a20 pback booting:: │ │ │ │ │ -00008ca0: 2020 2020 2020 2020 2020 204e 6f74 6573 Notes │ │ │ │ │ -00008cb0: 206f 6e20 626f 6f74 696e 6720 6672 6f6d on booting from │ │ │ │ │ -00008cc0: 206c 6f6f 7062 6163 6b73 0a2a 204c 564d loopbacks.* LVM │ │ │ │ │ -00008cd0: 2063 6163 6865 2062 6f6f 7469 6e67 3a3a cache booting:: │ │ │ │ │ -00008ce0: 2020 2020 2020 2020 2020 204e 6f74 6573 Notes │ │ │ │ │ -00008cf0: 206f 6e20 626f 6f74 696e 6720 6672 6f6d on booting from │ │ │ │ │ -00008d00: 204c 564d 2063 6163 6865 206c 6f67 6963 LVM cache logic │ │ │ │ │ -00008d10: 616c 2076 6f6c 756d 650a 2a20 4f53 2d73 al volume.* OS-s │ │ │ │ │ -00008d20: 7065 6369 6669 6320 6e6f 7465 733a 3a20 pecific notes:: │ │ │ │ │ -00008d30: 2020 2020 2020 2020 2020 4e6f 7465 7320 Notes │ │ │ │ │ -00008d40: 6f6e 2073 6f6d 6520 6f70 6572 6174 696e on some operatin │ │ │ │ │ -00008d50: 6720 7379 7374 656d 730a 0a1f 0a46 696c g systems....Fil │ │ │ │ │ -00008d60: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ -00008d70: 6f64 653a 2047 656e 6572 616c 2062 6f6f ode: General boo │ │ │ │ │ -00008d80: 7420 6d65 7468 6f64 732c 2020 4e65 7874 t methods, Next │ │ │ │ │ -00008d90: 3a20 4c6f 6f70 6261 636b 2062 6f6f 7469 : Loopback booti │ │ │ │ │ -00008da0: 6e67 2c20 2055 703a 2042 6f6f 7469 6e67 ng, Up: Booting │ │ │ │ │ -00008db0: 0a0a 352e 3120 486f 7720 746f 2062 6f6f ..5.1 How to boo │ │ │ │ │ -00008dc0: 7420 6f70 6572 6174 696e 6720 7379 7374 t operating syst │ │ │ │ │ -00008dd0: 656d 730a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ems.============ │ │ │ │ │ +00007300: 3d3d 3d3d 3d3d 0a0a 4966 2074 6865 2064 ======..If the d │ │ │ │ │ +00007310: 6576 6963 6520 6d61 7020 6669 6c65 2065 evice map file e │ │ │ │ │ +00007320: 7869 7374 732c 2074 6865 2047 5255 4220 xists, the GRUB │ │ │ │ │ +00007330: 7574 696c 6974 6965 7320 2827 6772 7562 utilities ('grub │ │ │ │ │ +00007340: 2d70 726f 6265 272c 2065 7463 2e29 0a72 -probe', etc.).r │ │ │ │ │ +00007350: 6561 6420 6974 2074 6f20 6d61 7020 4249 ead it to map BI │ │ │ │ │ +00007360: 4f53 2064 7269 7665 7320 746f 204f 5320 OS drives to OS │ │ │ │ │ +00007370: 6465 7669 6365 732e 2020 5468 6973 2066 devices. This f │ │ │ │ │ +00007380: 696c 6520 636f 6e73 6973 7473 206f 6620 ile consists of │ │ │ │ │ +00007390: 6c69 6e65 730a 6c69 6b65 2074 6869 733a lines.like this: │ │ │ │ │ +000073a0: 0a0a 2020 2020 2028 4445 5649 4345 2920 .. (DEVICE) │ │ │ │ │ +000073b0: 4649 4c45 0a0a 2020 2044 4556 4943 4520 FILE.. DEVICE │ │ │ │ │ +000073c0: 6973 2061 2064 7269 7665 2073 7065 6369 is a drive speci │ │ │ │ │ +000073d0: 6669 6564 2069 6e20 7468 6520 4752 5542 fied in the GRUB │ │ │ │ │ +000073e0: 2073 796e 7461 7820 282a 6e6f 7465 2044 syntax (*note D │ │ │ │ │ +000073f0: 6576 6963 650a 7379 6e74 6178 3a3a 292c evice.syntax::), │ │ │ │ │ +00007400: 2061 6e64 2046 494c 4520 6973 2061 6e20 and FILE is an │ │ │ │ │ +00007410: 4f53 2066 696c 652c 2077 6869 6368 2069 OS file, which i │ │ │ │ │ +00007420: 7320 6e6f 726d 616c 6c79 2061 2064 6576 s normally a dev │ │ │ │ │ +00007430: 6963 6520 6669 6c65 2e0a 0a20 2020 4869 ice file... Hi │ │ │ │ │ +00007440: 7374 6f72 6963 616c 6c79 2c20 7468 6520 storically, the │ │ │ │ │ +00007450: 6465 7669 6365 206d 6170 2066 696c 6520 device map file │ │ │ │ │ +00007460: 7761 7320 7573 6564 2062 6563 6175 7365 was used because │ │ │ │ │ +00007470: 2047 5255 4220 6465 7669 6365 206e 616d GRUB device nam │ │ │ │ │ +00007480: 6573 0a68 6164 2074 6f20 6265 2075 7365 es.had to be use │ │ │ │ │ +00007490: 6420 696e 2074 6865 2063 6f6e 6669 6775 d in the configu │ │ │ │ │ +000074a0: 7261 7469 6f6e 2066 696c 652c 2061 6e64 ration file, and │ │ │ │ │ +000074b0: 2074 6865 7920 7765 7265 2064 6572 6976 they were deriv │ │ │ │ │ +000074c0: 6564 2066 726f 6d0a 4249 4f53 2064 7269 ed from.BIOS dri │ │ │ │ │ +000074d0: 7665 206e 756d 6265 7273 2e20 2054 6865 ve numbers. The │ │ │ │ │ +000074e0: 206d 6170 2062 6574 7765 656e 2042 494f map between BIO │ │ │ │ │ +000074f0: 5320 6472 6976 6573 2061 6e64 204f 5320 S drives and OS │ │ │ │ │ +00007500: 6465 7669 6365 7320 6361 6e6e 6f74 0a61 devices cannot.a │ │ │ │ │ +00007510: 6c77 6179 7320 6265 2067 7565 7373 6564 lways be guessed │ │ │ │ │ +00007520: 2063 6f72 7265 6374 6c79 3a20 666f 7220 correctly: for │ │ │ │ │ +00007530: 6578 616d 706c 652c 2047 5255 4220 7769 example, GRUB wi │ │ │ │ │ +00007540: 6c6c 2067 6574 2074 6865 206f 7264 6572 ll get the order │ │ │ │ │ +00007550: 2077 726f 6e67 0a69 6620 796f 7520 6578 wrong.if you ex │ │ │ │ │ +00007560: 6368 616e 6765 2074 6865 2062 6f6f 7420 change the boot │ │ │ │ │ +00007570: 7365 7175 656e 6365 2062 6574 7765 656e sequence between │ │ │ │ │ +00007580: 2049 4445 2061 6e64 2053 4353 4920 696e IDE and SCSI in │ │ │ │ │ +00007590: 2079 6f75 7220 4249 4f53 2e0a 0a20 2020 your BIOS... │ │ │ │ │ +000075a0: 556e 666f 7274 756e 6174 656c 792c 2065 Unfortunately, e │ │ │ │ │ +000075b0: 7665 6e20 4f53 2064 6576 6963 6520 6e61 ven OS device na │ │ │ │ │ +000075c0: 6d65 7320 6172 6520 6e6f 7420 616c 7761 mes are not alwa │ │ │ │ │ +000075d0: 7973 2073 7461 626c 652e 2020 4d6f 6465 ys stable. Mode │ │ │ │ │ +000075e0: 726e 0a76 6572 7369 6f6e 7320 6f66 2074 rn.versions of t │ │ │ │ │ +000075f0: 6865 204c 696e 7578 206b 6572 6e65 6c20 he Linux kernel │ │ │ │ │ +00007600: 6d61 7920 7072 6f62 6520 6472 6976 6573 may probe drives │ │ │ │ │ +00007610: 2069 6e20 6120 6469 6666 6572 656e 7420 in a different │ │ │ │ │ +00007620: 6f72 6465 7220 6672 6f6d 0a62 6f6f 7420 order from.boot │ │ │ │ │ +00007630: 746f 2062 6f6f 742c 2061 6e64 2074 6865 to boot, and the │ │ │ │ │ +00007640: 2070 7265 6669 7820 2827 2f64 6576 2f68 prefix ('/dev/h │ │ │ │ │ +00007650: 642a 2720 7665 7273 7573 2027 2f64 6576 d*' versus '/dev │ │ │ │ │ +00007660: 2f73 642a 2729 206d 6179 2063 6861 6e67 /sd*') may chang │ │ │ │ │ +00007670: 650a 6465 7065 6e64 696e 6720 6f6e 2074 e.depending on t │ │ │ │ │ +00007680: 6865 2064 7269 7665 7220 7375 6273 7973 he driver subsys │ │ │ │ │ +00007690: 7465 6d20 696e 2075 7365 2e20 2041 7320 tem in use. As │ │ │ │ │ +000076a0: 6120 7265 7375 6c74 2c20 7468 6520 6465 a result, the de │ │ │ │ │ +000076b0: 7669 6365 206d 6170 0a66 696c 6520 7265 vice map.file re │ │ │ │ │ +000076c0: 7175 6972 6564 2066 7265 7175 656e 7420 quired frequent │ │ │ │ │ +000076d0: 6564 6974 696e 6720 6f6e 2073 6f6d 6520 editing on some │ │ │ │ │ +000076e0: 7379 7374 656d 732e 0a0a 2020 2047 5255 systems... GRU │ │ │ │ │ +000076f0: 4220 6176 6f69 6473 2074 6869 7320 7072 B avoids this pr │ │ │ │ │ +00007700: 6f62 6c65 6d20 6e6f 7761 6461 7973 2062 oblem nowadays b │ │ │ │ │ +00007710: 7920 7573 696e 6720 5555 4944 7320 6f72 y using UUIDs or │ │ │ │ │ +00007720: 2066 696c 6520 7379 7374 656d 0a6c 6162 file system.lab │ │ │ │ │ +00007730: 656c 7320 7768 656e 2067 656e 6572 6174 els when generat │ │ │ │ │ +00007740: 696e 6720 2767 7275 622e 6366 6727 2c20 ing 'grub.cfg', │ │ │ │ │ +00007750: 616e 6420 7765 2061 6476 6973 6520 7468 and we advise th │ │ │ │ │ +00007760: 6174 2079 6f75 2064 6f20 7468 6520 7361 at you do the sa │ │ │ │ │ +00007770: 6d65 0a66 6f72 2061 6e79 2063 7573 746f me.for any custo │ │ │ │ │ +00007780: 6d20 6d65 6e75 2065 6e74 7269 6573 2079 m menu entries y │ │ │ │ │ +00007790: 6f75 2077 7269 7465 2e20 2049 6620 7468 ou write. If th │ │ │ │ │ +000077a0: 6520 6465 7669 6365 206d 6170 2066 696c e device map fil │ │ │ │ │ +000077b0: 6520 646f 6573 206e 6f74 0a65 7869 7374 e does not.exist │ │ │ │ │ +000077c0: 2c20 7468 656e 2074 6865 2047 5255 4220 , then the GRUB │ │ │ │ │ +000077d0: 7574 696c 6974 6965 7320 7769 6c6c 2061 utilities will a │ │ │ │ │ +000077e0: 7373 756d 6520 6120 7465 6d70 6f72 6172 ssume a temporar │ │ │ │ │ +000077f0: 7920 6465 7669 6365 206d 6170 206f 6e20 y device map on │ │ │ │ │ +00007800: 7468 650a 666c 792e 2020 5468 6973 2069 the.fly. This i │ │ │ │ │ +00007810: 7320 6f66 7465 6e20 676f 6f64 2065 6e6f s often good eno │ │ │ │ │ +00007820: 7567 682c 2070 6172 7469 6375 6c61 726c ugh, particularl │ │ │ │ │ +00007830: 7920 696e 2074 6865 2063 6f6d 6d6f 6e20 y in the common │ │ │ │ │ +00007840: 6361 7365 206f 660a 7369 6e67 6c65 2d64 case of.single-d │ │ │ │ │ +00007850: 6973 6b20 7379 7374 656d 732e 0a0a 2020 isk systems... │ │ │ │ │ +00007860: 2048 6f77 6576 6572 2c20 7468 6520 6465 However, the de │ │ │ │ │ +00007870: 7669 6365 206d 6170 2066 696c 6520 6973 vice map file is │ │ │ │ │ +00007880: 206e 6f74 2065 6e74 6972 656c 7920 6f62 not entirely ob │ │ │ │ │ +00007890: 736f 6c65 7465 2079 6574 2c20 616e 6420 solete yet, and │ │ │ │ │ +000078a0: 6974 2069 730a 7573 6564 2066 6f72 206f it is.used for o │ │ │ │ │ +000078b0: 7665 7272 6964 696e 6720 7768 656e 2063 verriding when c │ │ │ │ │ +000078c0: 7572 7265 6e74 2065 6e76 6972 6f6e 6d65 urrent environme │ │ │ │ │ +000078d0: 6e74 2069 7320 6469 6666 6572 656e 7420 nt is different │ │ │ │ │ +000078e0: 6672 6f6d 2074 6865 206f 6e65 0a6f 6e20 from the one.on │ │ │ │ │ +000078f0: 626f 6f74 2e20 204d 6f73 7420 636f 6d6d boot. Most comm │ │ │ │ │ +00007900: 6f6e 2063 6173 6520 6973 2069 6620 796f on case is if yo │ │ │ │ │ +00007910: 7520 7573 6520 6120 7061 7274 6974 696f u use a partitio │ │ │ │ │ +00007920: 6e20 6f72 206c 6f67 6963 616c 2076 6f6c n or logical vol │ │ │ │ │ +00007930: 756d 650a 6173 2061 2064 6973 6b20 666f ume.as a disk fo │ │ │ │ │ +00007940: 7220 7669 7274 7561 6c20 6d61 6368 696e r virtual machin │ │ │ │ │ +00007950: 652e 2020 596f 7520 6361 6e20 7075 7420 e. You can put │ │ │ │ │ +00007960: 616e 7920 636f 6d6d 656e 7473 2069 6e20 any comments in │ │ │ │ │ +00007970: 7468 6520 6669 6c65 2069 660a 6e65 6564 the file if.need │ │ │ │ │ +00007980: 6564 2c20 6173 2074 6865 2047 5255 4220 ed, as the GRUB │ │ │ │ │ +00007990: 7574 696c 6974 6965 7320 6173 7375 6d65 utilities assume │ │ │ │ │ +000079a0: 2074 6861 7420 6120 6c69 6e65 2069 7320 that a line is │ │ │ │ │ +000079b0: 6a75 7374 2061 2063 6f6d 6d65 6e74 2069 just a comment i │ │ │ │ │ +000079c0: 660a 7468 6520 6669 7273 7420 6368 6172 f.the first char │ │ │ │ │ +000079d0: 6163 7465 7220 6973 2027 2327 2e0a 0a1f acter is '#'.... │ │ │ │ │ +000079e0: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ +000079f0: 2c20 204e 6f64 653a 2042 494f 5320 696e , Node: BIOS in │ │ │ │ │ +00007a00: 7374 616c 6c61 7469 6f6e 2c20 2050 7265 stallation, Pre │ │ │ │ │ +00007a10: 763a 2044 6576 6963 6520 6d61 702c 2020 v: Device map, │ │ │ │ │ +00007a20: 5570 3a20 496e 7374 616c 6c61 7469 6f6e Up: Installation │ │ │ │ │ +00007a30: 0a0a 342e 3420 4249 4f53 2069 6e73 7461 ..4.4 BIOS insta │ │ │ │ │ +00007a40: 6c6c 6174 696f 6e0a 3d3d 3d3d 3d3d 3d3d llation.======== │ │ │ │ │ +00007a50: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a4d =============..M │ │ │ │ │ +00007a60: 4252 0a3d 3d3d 0a0a 5468 6520 7061 7274 BR.===..The part │ │ │ │ │ +00007a70: 6974 696f 6e20 7461 626c 6520 666f 726d ition table form │ │ │ │ │ +00007a80: 6174 2074 7261 6469 7469 6f6e 616c 6c79 at traditionally │ │ │ │ │ +00007a90: 2075 7365 6420 6f6e 2050 4320 4249 4f53 used on PC BIOS │ │ │ │ │ +00007aa0: 2070 6c61 7466 6f72 6d73 2069 730a 6361 platforms is.ca │ │ │ │ │ +00007ab0: 6c6c 6564 2074 6865 204d 6173 7465 7220 lled the Master │ │ │ │ │ +00007ac0: 426f 6f74 2052 6563 6f72 6420 284d 4252 Boot Record (MBR │ │ │ │ │ +00007ad0: 2920 666f 726d 6174 3b20 7468 6973 2069 ) format; this i │ │ │ │ │ +00007ae0: 7320 7468 6520 666f 726d 6174 2074 6861 s the format tha │ │ │ │ │ +00007af0: 740a 616c 6c6f 7773 2075 7020 746f 2066 t.allows up to f │ │ │ │ │ +00007b00: 6f75 7220 7072 696d 6172 7920 7061 7274 our primary part │ │ │ │ │ +00007b10: 6974 696f 6e73 2061 6e64 2061 6464 6974 itions and addit │ │ │ │ │ +00007b20: 696f 6e61 6c20 6c6f 6769 6361 6c20 7061 ional logical pa │ │ │ │ │ +00007b30: 7274 6974 696f 6e73 2e0a 5769 7468 2074 rtitions..With t │ │ │ │ │ +00007b40: 6869 7320 7061 7274 6974 696f 6e20 7461 his partition ta │ │ │ │ │ +00007b50: 626c 6520 666f 726d 6174 2c20 7468 6572 ble format, ther │ │ │ │ │ +00007b60: 6520 6172 6520 7477 6f20 7761 7973 2074 e are two ways t │ │ │ │ │ +00007b70: 6f20 696e 7374 616c 6c20 4752 5542 3a20 o install GRUB: │ │ │ │ │ +00007b80: 6974 0a63 616e 2062 6520 656d 6265 6464 it.can be embedd │ │ │ │ │ +00007b90: 6564 2069 6e20 7468 6520 6172 6561 2062 ed in the area b │ │ │ │ │ +00007ba0: 6574 7765 656e 2074 6865 204d 4252 2061 etween the MBR a │ │ │ │ │ +00007bb0: 6e64 2074 6865 2066 6972 7374 2070 6172 nd the first par │ │ │ │ │ +00007bc0: 7469 7469 6f6e 0a28 6361 6c6c 6564 2062 tition.(called b │ │ │ │ │ +00007bd0: 7920 7661 7269 6f75 7320 6e61 6d65 732c y various names, │ │ │ │ │ +00007be0: 2073 7563 6820 6173 2074 6865 2022 626f such as the "bo │ │ │ │ │ +00007bf0: 6f74 2074 7261 636b 222c 2022 4d42 5220 ot track", "MBR │ │ │ │ │ +00007c00: 6761 7022 2c20 6f72 0a22 656d 6265 6464 gap", or."embedd │ │ │ │ │ +00007c10: 696e 6720 6172 6561 222c 2061 6e64 2077 ing area", and w │ │ │ │ │ +00007c20: 6869 6368 2069 7320 7573 7561 6c6c 7920 hich is usually │ │ │ │ │ +00007c30: 6174 206c 6561 7374 2031 3030 3020 4b69 at least 1000 Ki │ │ │ │ │ +00007c40: 4229 2c20 6f72 2074 6865 2063 6f72 650a B), or the core. │ │ │ │ │ +00007c50: 696d 6167 6520 6361 6e20 6265 2069 6e73 image can be ins │ │ │ │ │ +00007c60: 7461 6c6c 6564 2069 6e20 6120 6669 6c65 talled in a file │ │ │ │ │ +00007c70: 2073 7973 7465 6d20 616e 6420 6120 6c69 system and a li │ │ │ │ │ +00007c80: 7374 206f 6620 7468 6520 626c 6f63 6b73 st of the blocks │ │ │ │ │ +00007c90: 2074 6861 740a 6d61 6b65 2069 7420 7570 that.make it up │ │ │ │ │ +00007ca0: 2063 616e 2062 6520 7374 6f72 6564 2069 can be stored i │ │ │ │ │ +00007cb0: 6e20 7468 6520 6669 7273 7420 7365 6374 n the first sect │ │ │ │ │ +00007cc0: 6f72 206f 6620 7468 6174 2070 6172 7469 or of that parti │ │ │ │ │ +00007cd0: 7469 6f6e 2e0a 0a20 2020 4d6f 6465 726e tion... Modern │ │ │ │ │ +00007ce0: 2074 6f6f 6c73 2075 7375 616c 6c79 206c tools usually l │ │ │ │ │ +00007cf0: 6561 7665 204d 4252 2067 6170 206f 6620 eave MBR gap of │ │ │ │ │ +00007d00: 6174 206c 6561 7374 2031 3032 3320 4b69 at least 1023 Ki │ │ │ │ │ +00007d10: 422e 2054 6869 7320 616d 6f75 6e74 0a69 B. This amount.i │ │ │ │ │ +00007d20: 7320 7375 6666 6963 6965 6e74 2074 6f20 s sufficient to │ │ │ │ │ +00007d30: 636f 7665 7220 6d6f 7374 2063 6f6e 6669 cover most confi │ │ │ │ │ +00007d40: 6775 7261 7469 6f6e 732e 2020 4865 6e63 gurations. Henc │ │ │ │ │ +00007d50: 6520 7468 6973 2076 616c 7565 2069 730a e this value is. │ │ │ │ │ +00007d60: 7265 636f 6d6d 656e 6465 6420 6279 2074 recommended by t │ │ │ │ │ +00007d70: 6865 2047 5255 4220 7465 616d 2e0a 0a20 he GRUB team... │ │ │ │ │ +00007d80: 2020 4869 7374 6f72 6963 616c 6c79 206d Historically m │ │ │ │ │ +00007d90: 616e 7920 746f 6f6c 7320 6c65 6674 206f any tools left o │ │ │ │ │ +00007da0: 6e6c 7920 3331 204b 6942 206f 6620 7370 nly 31 KiB of sp │ │ │ │ │ +00007db0: 6163 652e 2020 5468 6973 2069 7320 6e6f ace. This is no │ │ │ │ │ +00007dc0: 740a 656e 6f75 6768 2074 6f20 7061 7273 t.enough to pars │ │ │ │ │ +00007dd0: 6520 7265 6c69 6162 6c79 2064 6966 6669 e reliably diffi │ │ │ │ │ +00007de0: 6375 6c74 2073 7472 7563 7475 7265 7320 cult structures │ │ │ │ │ +00007df0: 6c69 6b65 2042 7472 6673 2c20 5a46 532c like Btrfs, ZFS, │ │ │ │ │ +00007e00: 2052 4149 4420 6f72 0a4c 564d 2c20 6f72 RAID or.LVM, or │ │ │ │ │ +00007e10: 2074 6f20 7573 6520 6469 6666 6963 756c to use difficul │ │ │ │ │ +00007e20: 7420 6469 736b 2061 6363 6573 7320 6d65 t disk access me │ │ │ │ │ +00007e30: 7468 6f64 7320 6c69 6b65 2061 6863 692e thods like ahci. │ │ │ │ │ +00007e40: 2020 4865 6e63 6520 4752 5542 2077 696c Hence GRUB wil │ │ │ │ │ +00007e50: 6c0a 7761 726e 2069 6620 6174 7465 6d70 l.warn if attemp │ │ │ │ │ +00007e60: 7465 6420 746f 2069 6e73 7461 6c6c 2069 ted to install i │ │ │ │ │ +00007e70: 6e74 6f20 736d 616c 6c20 4d42 5220 6761 nto small MBR ga │ │ │ │ │ +00007e80: 7020 6578 6365 7074 2069 6e20 6120 736d p except in a sm │ │ │ │ │ +00007e90: 616c 6c20 6e75 6d62 6572 0a6f 6620 636f all number.of co │ │ │ │ │ +00007ea0: 6e66 6967 7572 6174 696f 6e73 2074 6861 nfigurations tha │ │ │ │ │ +00007eb0: 7420 7765 7265 2067 7261 6e64 6661 7468 t were grandfath │ │ │ │ │ +00007ec0: 6572 6564 2e20 2054 6865 2067 7261 6e64 ered. The grand │ │ │ │ │ +00007ed0: 6661 7468 6572 6564 2063 6f6e 6669 670a fathered config. │ │ │ │ │ +00007ee0: 6d75 7374 3a0a 0a20 2020 2a20 7573 6520 must:.. * use │ │ │ │ │ +00007ef0: 6269 6f73 6469 736b 2061 7320 6469 736b biosdisk as disk │ │ │ │ │ +00007f00: 2061 6363 6573 7320 6d6f 6475 6c65 2066 access module f │ │ │ │ │ +00007f10: 6f72 2027 2f62 6f6f 7427 202a 206e 6f74 or '/boot' * not │ │ │ │ │ +00007f20: 2075 7365 2061 6e79 0a61 6464 6974 696f use any.additio │ │ │ │ │ +00007f30: 6e61 6c20 7061 7274 6974 696f 6e20 6d61 nal partition ma │ │ │ │ │ +00007f40: 7073 2074 6f20 6163 6365 7373 2027 2f62 ps to access '/b │ │ │ │ │ +00007f50: 6f6f 7427 202a 2027 2f62 6f6f 7427 206d oot' * '/boot' m │ │ │ │ │ +00007f60: 7573 7420 6265 206f 6e20 6f6e 6520 6f66 ust be on one of │ │ │ │ │ +00007f70: 0a66 6f6c 6c6f 7769 6e67 2066 696c 6573 .following files │ │ │ │ │ +00007f80: 7973 7465 6d73 3a20 2a20 4146 4653 2c20 ystems: * AFFS, │ │ │ │ │ +00007f90: 4146 532c 2042 4653 2c20 6370 696f 2c20 AFS, BFS, cpio, │ │ │ │ │ +00007fa0: 6e65 7763 2c20 6f64 632c 2065 7874 322f newc, odc, ext2/ │ │ │ │ │ +00007fb0: 332f 342c 2046 4154 2c0a 6578 4641 542c 3/4, FAT,.exFAT, │ │ │ │ │ +00007fc0: 2046 3246 532c 2048 4653 2c20 756e 636f F2FS, HFS, unco │ │ │ │ │ +00007fd0: 6d70 7265 7373 6564 2048 4653 2b2c 2049 mpressed HFS+, I │ │ │ │ │ +00007fe0: 534f 3936 3630 2c20 4a46 532c 204d 696e SO9660, JFS, Min │ │ │ │ │ +00007ff0: 6978 2c20 4d69 6e69 7832 2c0a 4d69 6e69 ix, Minix2,.Mini │ │ │ │ │ +00008000: 7833 2c20 4e49 4c46 5332 2c20 4e54 4653 x3, NILFS2, NTFS │ │ │ │ │ +00008010: 2c20 5265 6973 6572 4653 2c20 524f 4d46 , ReiserFS, ROMF │ │ │ │ │ +00008020: 532c 2053 4653 2c20 7461 722c 2055 4446 S, SFS, tar, UDF │ │ │ │ │ +00008030: 2c20 5546 5331 2c20 5546 5332 2c20 5846 , UFS1, UFS2, XF │ │ │ │ │ +00008040: 530a 0a20 2020 4d42 5220 6761 7020 6861 S.. MBR gap ha │ │ │ │ │ +00008050: 7320 6665 7720 7465 6368 6e69 6361 6c20 s few technical │ │ │ │ │ +00008060: 7072 6f62 6c65 6d73 2e20 2054 6865 7265 problems. There │ │ │ │ │ +00008070: 2069 7320 6e6f 2077 6179 2074 6f20 7265 is no way to re │ │ │ │ │ +00008080: 7365 7276 6520 7370 6163 650a 696e 2074 serve space.in t │ │ │ │ │ +00008090: 6865 2065 6d62 6564 6469 6e67 2061 7265 he embedding are │ │ │ │ │ +000080a0: 6120 7769 7468 2063 6f6d 706c 6574 6520 a with complete │ │ │ │ │ +000080b0: 7361 6665 7479 2c20 616e 6420 736f 6d65 safety, and some │ │ │ │ │ +000080c0: 2070 726f 7072 6965 7461 7279 0a73 6f66 proprietary.sof │ │ │ │ │ +000080d0: 7477 6172 6520 6973 206b 6e6f 776e 2074 tware is known t │ │ │ │ │ +000080e0: 6f20 7573 6520 6974 2074 6f20 6d61 6b65 o use it to make │ │ │ │ │ +000080f0: 2069 7420 6469 6666 6963 756c 7420 666f it difficult fo │ │ │ │ │ +00008100: 7220 7573 6572 7320 746f 2077 6f72 6b0a r users to work. │ │ │ │ │ +00008110: 6172 6f75 6e64 206c 6963 656e 7369 6e67 around licensing │ │ │ │ │ +00008120: 2072 6573 7472 6963 7469 6f6e 732e 2020 restrictions. │ │ │ │ │ +00008130: 4752 5542 2077 6f72 6b73 2069 7420 6172 GRUB works it ar │ │ │ │ │ +00008140: 6f75 6e64 2062 7920 6465 7465 6374 696e ound by detectin │ │ │ │ │ +00008150: 670a 7365 6374 6f72 7320 6279 206f 7468 g.sectors by oth │ │ │ │ │ +00008160: 6572 2073 6f66 7477 6172 6520 616e 6420 er software and │ │ │ │ │ +00008170: 6176 6f69 6469 6e67 2074 6865 6d20 616e avoiding them an │ │ │ │ │ +00008180: 6420 7072 6f74 6563 7469 6e67 2069 7473 d protecting its │ │ │ │ │ +00008190: 206f 776e 0a73 6563 746f 7273 2075 7369 own.sectors usi │ │ │ │ │ +000081a0: 6e67 2052 6565 642d 536f 6c6f 6d6f 6e20 ng Reed-Solomon │ │ │ │ │ +000081b0: 656e 636f 6469 6e67 2e0a 0a20 2020 4752 encoding... GR │ │ │ │ │ +000081c0: 5542 2074 6561 6d20 7265 636f 6d6d 656e UB team recommen │ │ │ │ │ +000081d0: 6473 2068 6176 696e 6720 4d42 5220 6761 ds having MBR ga │ │ │ │ │ +000081e0: 7020 6f66 2061 7420 6c65 6173 7420 3130 p of at least 10 │ │ │ │ │ +000081f0: 3030 204b 6942 0a0a 2020 2053 686f 756c 00 KiB.. Shoul │ │ │ │ │ +00008200: 6420 6974 2062 6520 6e6f 7420 706f 7373 d it be not poss │ │ │ │ │ +00008210: 6962 6c65 2047 5255 4220 6861 7320 7375 ible GRUB has su │ │ │ │ │ +00008220: 7070 6f72 7420 666f 7220 6120 6661 6c6c pport for a fall │ │ │ │ │ +00008230: 6261 636b 2073 6f6c 7574 696f 6e0a 7768 back solution.wh │ │ │ │ │ +00008240: 6963 6820 6973 2068 6561 7669 6c79 2072 ich is heavily r │ │ │ │ │ +00008250: 6563 6f6d 6d65 6e64 6564 2061 6761 696e ecommended again │ │ │ │ │ +00008260: 7374 2e20 2049 6e73 7461 6c6c 696e 6720 st. Installing │ │ │ │ │ +00008270: 746f 2061 2066 696c 6573 7973 7465 6d20 to a filesystem │ │ │ │ │ +00008280: 6d65 616e 730a 7468 6174 2047 5255 4220 means.that GRUB │ │ │ │ │ +00008290: 6973 2076 756c 6e65 7261 626c 6520 746f is vulnerable to │ │ │ │ │ +000082a0: 2069 7473 2062 6c6f 636b 7320 6265 696e its blocks bein │ │ │ │ │ +000082b0: 6720 6d6f 7665 6420 6172 6f75 6e64 2062 g moved around b │ │ │ │ │ +000082c0: 7920 6669 6c65 7379 7374 656d 0a66 6561 y filesystem.fea │ │ │ │ │ +000082d0: 7475 7265 7320 7375 6368 2061 7320 7461 tures such as ta │ │ │ │ │ +000082e0: 696c 2070 6163 6b69 6e67 2c20 6f72 2065 il packing, or e │ │ │ │ │ +000082f0: 7665 6e20 6279 2061 6767 7265 7373 6976 ven by aggressiv │ │ │ │ │ +00008300: 6520 6673 636b 0a69 6d70 6c65 6d65 6e74 e fsck.implement │ │ │ │ │ +00008310: 6174 696f 6e73 2c20 736f 2074 6869 7320 ations, so this │ │ │ │ │ +00008320: 6170 7072 6f61 6368 2069 7320 7175 6974 approach is quit │ │ │ │ │ +00008330: 6520 6672 6167 696c 653b 2061 6e64 2074 e fragile; and t │ │ │ │ │ +00008340: 6869 7320 6170 7072 6f61 6368 0a63 616e his approach.can │ │ │ │ │ +00008350: 206f 6e6c 7920 6265 2075 7365 6420 6966 only be used if │ │ │ │ │ +00008360: 2074 6865 2027 2f62 6f6f 7427 2066 696c the '/boot' fil │ │ │ │ │ +00008370: 6573 7973 7465 6d20 6973 206f 6e20 7468 esystem is on th │ │ │ │ │ +00008380: 6520 7361 6d65 2064 6973 6b20 7468 6174 e same disk that │ │ │ │ │ +00008390: 2074 6865 0a42 494f 5320 626f 6f74 7320 the.BIOS boots │ │ │ │ │ +000083a0: 6672 6f6d 2c20 736f 2074 6861 7420 4752 from, so that GR │ │ │ │ │ +000083b0: 5542 2064 6f65 7320 6e6f 7420 6861 7665 UB does not have │ │ │ │ │ +000083c0: 2074 6f20 7265 6c79 206f 6e20 6775 6573 to rely on gues │ │ │ │ │ +000083d0: 7369 6e67 2042 494f 530a 6472 6976 6520 sing BIOS.drive │ │ │ │ │ +000083e0: 6e75 6d62 6572 732e 0a0a 2020 2054 6865 numbers... The │ │ │ │ │ +000083f0: 2047 5255 4220 6465 7665 6c6f 706d 656e GRUB developmen │ │ │ │ │ +00008400: 7420 7465 616d 2067 656e 6572 616c 6c79 t team generally │ │ │ │ │ +00008410: 2072 6563 6f6d 6d65 6e64 7320 656d 6265 recommends embe │ │ │ │ │ +00008420: 6464 696e 6720 4752 5542 2062 6566 6f72 dding GRUB befor │ │ │ │ │ +00008430: 650a 7468 6520 6669 7273 7420 7061 7274 e.the first part │ │ │ │ │ +00008440: 6974 696f 6e2c 2075 6e6c 6573 7320 796f ition, unless yo │ │ │ │ │ +00008450: 7520 6861 7665 2073 7065 6369 616c 2072 u have special r │ │ │ │ │ +00008460: 6571 7569 7265 6d65 6e74 732e 2020 596f equirements. Yo │ │ │ │ │ +00008470: 7520 6d75 7374 0a65 6e73 7572 6520 7468 u must.ensure th │ │ │ │ │ +00008480: 6174 2074 6865 2066 6972 7374 2070 6172 at the first par │ │ │ │ │ +00008490: 7469 7469 6f6e 2073 7461 7274 7320 6174 tition starts at │ │ │ │ │ +000084a0: 206c 6561 7374 2031 3030 3020 4b69 4220 least 1000 KiB │ │ │ │ │ +000084b0: 2832 3030 3020 7365 6374 6f72 7329 0a66 (2000 sectors).f │ │ │ │ │ +000084c0: 726f 6d20 7468 6520 7374 6172 7420 6f66 rom the start of │ │ │ │ │ +000084d0: 2074 6865 2064 6973 6b3b 206f 6e20 6d6f the disk; on mo │ │ │ │ │ +000084e0: 6465 726e 2064 6973 6b73 2c20 6974 2069 dern disks, it i │ │ │ │ │ +000084f0: 7320 6f66 7465 6e20 6120 7065 7266 6f72 s often a perfor │ │ │ │ │ +00008500: 6d61 6e63 650a 6164 7661 6e74 6167 6520 mance.advantage │ │ │ │ │ +00008510: 746f 2061 6c69 676e 2070 6172 7469 7469 to align partiti │ │ │ │ │ +00008520: 6f6e 7320 6f6e 206c 6172 6765 7220 626f ons on larger bo │ │ │ │ │ +00008530: 756e 6461 7269 6573 2061 6e79 7761 792c undaries anyway, │ │ │ │ │ +00008540: 2073 6f20 7468 6520 6669 7273 740a 7061 so the first.pa │ │ │ │ │ +00008550: 7274 6974 696f 6e20 6d69 6768 7420 7374 rtition might st │ │ │ │ │ +00008560: 6172 7420 3120 4d69 4220 6672 6f6d 2074 art 1 MiB from t │ │ │ │ │ +00008570: 6865 2073 7461 7274 206f 6620 7468 6520 he start of the │ │ │ │ │ +00008580: 6469 736b 2e0a 0a47 5054 0a3d 3d3d 0a0a disk...GPT.===.. │ │ │ │ │ +00008590: 536f 6d65 206e 6577 6572 2073 7973 7465 Some newer syste │ │ │ │ │ +000085a0: 6d73 2075 7365 2074 6865 2047 5549 4420 ms use the GUID │ │ │ │ │ +000085b0: 5061 7274 6974 696f 6e20 5461 626c 6520 Partition Table │ │ │ │ │ +000085c0: 2847 5054 2920 666f 726d 6174 2e20 2054 (GPT) format. T │ │ │ │ │ +000085d0: 6869 7320 7761 730a 7370 6563 6966 6965 his was.specifie │ │ │ │ │ +000085e0: 6420 6173 2070 6172 7420 6f66 2074 6865 d as part of the │ │ │ │ │ +000085f0: 2045 7874 656e 7369 626c 6520 4669 726d Extensible Firm │ │ │ │ │ +00008600: 7761 7265 2049 6e74 6572 6661 6365 2028 ware Interface ( │ │ │ │ │ +00008610: 4546 4929 2c20 6275 7420 6974 2063 616e EFI), but it can │ │ │ │ │ +00008620: 0a61 6c73 6f20 6265 2075 7365 6420 6f6e .also be used on │ │ │ │ │ +00008630: 2042 494f 5320 706c 6174 666f 726d 7320 BIOS platforms │ │ │ │ │ +00008640: 6966 2073 7973 7465 6d20 736f 6674 7761 if system softwa │ │ │ │ │ +00008650: 7265 2073 7570 706f 7274 7320 6974 3b20 re supports it; │ │ │ │ │ +00008660: 666f 720a 6578 616d 706c 652c 2047 5255 for.example, GRU │ │ │ │ │ +00008670: 4220 616e 6420 474e 552f 4c69 6e75 7820 B and GNU/Linux │ │ │ │ │ +00008680: 6361 6e20 6265 2075 7365 6420 696e 2074 can be used in t │ │ │ │ │ +00008690: 6869 7320 636f 6e66 6967 7572 6174 696f his configuratio │ │ │ │ │ +000086a0: 6e2e 2020 5769 7468 0a74 6869 7320 666f n. With.this fo │ │ │ │ │ +000086b0: 726d 6174 2c20 6974 2069 7320 706f 7373 rmat, it is poss │ │ │ │ │ +000086c0: 6962 6c65 2074 6f20 7265 7365 7276 6520 ible to reserve │ │ │ │ │ +000086d0: 6120 7768 6f6c 6520 7061 7274 6974 696f a whole partitio │ │ │ │ │ +000086e0: 6e20 666f 7220 4752 5542 2c0a 6361 6c6c n for GRUB,.call │ │ │ │ │ +000086f0: 6564 2074 6865 2042 494f 5320 426f 6f74 ed the BIOS Boot │ │ │ │ │ +00008700: 2050 6172 7469 7469 6f6e 2e20 2047 5255 Partition. GRU │ │ │ │ │ +00008710: 4220 6361 6e20 7468 656e 2062 6520 656d B can then be em │ │ │ │ │ +00008720: 6265 6464 6564 2069 6e74 6f20 7468 6174 bedded into that │ │ │ │ │ +00008730: 0a70 6172 7469 7469 6f6e 2077 6974 686f .partition witho │ │ │ │ │ +00008740: 7574 2074 6865 2072 6973 6b20 6f66 2062 ut the risk of b │ │ │ │ │ +00008750: 6569 6e67 206f 7665 7277 7269 7474 656e eing overwritten │ │ │ │ │ +00008760: 2062 7920 6f74 6865 7220 736f 6674 7761 by other softwa │ │ │ │ │ +00008770: 7265 2061 6e64 0a77 6974 686f 7574 2062 re and.without b │ │ │ │ │ +00008780: 6569 6e67 2063 6f6e 7461 696e 6564 2069 eing contained i │ │ │ │ │ +00008790: 6e20 6120 6669 6c65 7379 7374 656d 2077 n a filesystem w │ │ │ │ │ +000087a0: 6869 6368 206d 6967 6874 206d 6f76 6520 hich might move │ │ │ │ │ +000087b0: 6974 7320 626c 6f63 6b73 0a61 726f 756e its blocks.aroun │ │ │ │ │ +000087c0: 642e 0a0a 2020 2057 6865 6e20 6372 6561 d... When crea │ │ │ │ │ +000087d0: 7469 6e67 2061 2042 494f 5320 426f 6f74 ting a BIOS Boot │ │ │ │ │ +000087e0: 2050 6172 7469 7469 6f6e 206f 6e20 6120 Partition on a │ │ │ │ │ +000087f0: 4750 5420 7379 7374 656d 2c20 796f 7520 GPT system, you │ │ │ │ │ +00008800: 7368 6f75 6c64 206d 616b 650a 7375 7265 should make.sure │ │ │ │ │ +00008810: 2074 6861 7420 6974 2069 7320 6174 206c that it is at l │ │ │ │ │ +00008820: 6561 7374 2033 3120 4b69 4220 696e 2073 east 31 KiB in s │ │ │ │ │ +00008830: 697a 652e 2020 2847 5054 2d66 6f72 6d61 ize. (GPT-forma │ │ │ │ │ +00008840: 7474 6564 2064 6973 6b73 2061 7265 206e tted disks are n │ │ │ │ │ +00008850: 6f74 0a75 7375 616c 6c79 2070 6172 7469 ot.usually parti │ │ │ │ │ +00008860: 6375 6c61 726c 7920 736d 616c 6c2c 2073 cularly small, s │ │ │ │ │ +00008870: 6f20 7765 2072 6563 6f6d 6d65 6e64 2074 o we recommend t │ │ │ │ │ +00008880: 6861 7420 796f 7520 6d61 6b65 2069 7420 hat you make it │ │ │ │ │ +00008890: 6c61 7267 6572 2074 6861 6e0a 7468 6520 larger than.the │ │ │ │ │ +000088a0: 6261 7265 206d 696e 696d 756d 2c20 7375 bare minimum, su │ │ │ │ │ +000088b0: 6368 2061 7320 3120 4d69 422c 2074 6f20 ch as 1 MiB, to │ │ │ │ │ +000088c0: 616c 6c6f 7720 706c 656e 7479 206f 6620 allow plenty of │ │ │ │ │ +000088d0: 726f 6f6d 2066 6f72 2067 726f 7774 682e room for growth. │ │ │ │ │ +000088e0: 290a 596f 7520 6d75 7374 2061 6c73 6f20 ).You must also │ │ │ │ │ +000088f0: 6d61 6b65 2073 7572 6520 7468 6174 2069 make sure that i │ │ │ │ │ +00008900: 7420 6861 7320 7468 6520 7072 6f70 6572 t has the proper │ │ │ │ │ +00008910: 2070 6172 7469 7469 6f6e 2074 7970 652e partition type. │ │ │ │ │ +00008920: 2020 5573 696e 670a 474e 5520 5061 7274 Using.GNU Part │ │ │ │ │ +00008930: 6564 2c20 796f 7520 6361 6e20 7365 7420 ed, you can set │ │ │ │ │ +00008940: 7468 6973 2075 7369 6e67 2061 2063 6f6d this using a com │ │ │ │ │ +00008950: 6d61 6e64 2073 7563 6820 6173 2074 6865 mand such as the │ │ │ │ │ +00008960: 2066 6f6c 6c6f 7769 6e67 3a0a 0a20 2020 following:.. │ │ │ │ │ +00008970: 2020 2320 7061 7274 6564 202f 6465 762f # parted /dev/ │ │ │ │ │ +00008980: 4449 534b 2073 6574 2050 4152 5449 5449 DISK set PARTITI │ │ │ │ │ +00008990: 4f4e 2d4e 554d 4245 5220 6269 6f73 5f67 ON-NUMBER bios_g │ │ │ │ │ +000089a0: 7275 6220 6f6e 0a0a 2020 2049 6620 796f rub on.. If yo │ │ │ │ │ +000089b0: 7520 6172 6520 7573 696e 6720 6764 6973 u are using gdis │ │ │ │ │ +000089c0: 6b2c 2073 6574 2074 6865 2070 6172 7469 k, set the parti │ │ │ │ │ +000089d0: 7469 6f6e 2074 7970 6520 746f 2027 3078 tion type to '0x │ │ │ │ │ +000089e0: 4546 3032 272e 2020 5769 7468 0a70 6172 EF02'. With.par │ │ │ │ │ +000089f0: 7469 7469 6f6e 696e 6720 7072 6f67 7261 titioning progra │ │ │ │ │ +00008a00: 6d73 2074 6861 7420 7265 7175 6972 6520 ms that require │ │ │ │ │ +00008a10: 7365 7474 696e 6720 7468 6520 4755 4944 setting the GUID │ │ │ │ │ +00008a20: 2064 6972 6563 746c 792c 2069 7420 7368 directly, it sh │ │ │ │ │ +00008a30: 6f75 6c64 0a62 6520 2732 3136 3836 3134 ould.be '2168614 │ │ │ │ │ +00008a40: 382d 3634 3439 2d36 6536 662d 3734 3465 8-6449-6e6f-744e │ │ │ │ │ +00008a50: 3635 3635 3634 3435 3436 3439 272e 0a0a 656564454649'... │ │ │ │ │ +00008a60: 2020 202a 4361 7574 696f 6e3a 2a20 4265 *Caution:* Be │ │ │ │ │ +00008a70: 2076 6572 7920 6361 7265 6675 6c20 7768 very careful wh │ │ │ │ │ +00008a80: 6963 6820 7061 7274 6974 696f 6e20 796f ich partition yo │ │ │ │ │ +00008a90: 7520 7365 6c65 6374 2120 2057 6865 6e20 u select! When │ │ │ │ │ +00008aa0: 4752 5542 0a66 696e 6473 2061 2042 494f GRUB.finds a BIO │ │ │ │ │ +00008ab0: 5320 426f 6f74 2050 6172 7469 7469 6f6e S Boot Partition │ │ │ │ │ +00008ac0: 2064 7572 696e 6720 696e 7374 616c 6c61 during installa │ │ │ │ │ +00008ad0: 7469 6f6e 2c20 6974 2077 696c 6c20 6175 tion, it will au │ │ │ │ │ +00008ae0: 746f 6d61 7469 6361 6c6c 790a 6f76 6572 tomatically.over │ │ │ │ │ +00008af0: 7772 6974 6520 7061 7274 206f 6620 6974 write part of it │ │ │ │ │ +00008b00: 2e20 204d 616b 6520 7375 7265 2074 6861 . Make sure tha │ │ │ │ │ +00008b10: 7420 7468 6520 7061 7274 6974 696f 6e20 t the partition │ │ │ │ │ +00008b20: 646f 6573 206e 6f74 2063 6f6e 7461 696e does not contain │ │ │ │ │ +00008b30: 2061 6e79 0a6f 7468 6572 2064 6174 612e any.other data. │ │ │ │ │ +00008b40: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ +00008b50: 6e66 6f2c 2020 4e6f 6465 3a20 426f 6f74 nfo, Node: Boot │ │ │ │ │ +00008b60: 696e 672c 2020 4e65 7874 3a20 436f 6e66 ing, Next: Conf │ │ │ │ │ +00008b70: 6967 7572 6174 696f 6e2c 2020 5072 6576 iguration, Prev │ │ │ │ │ +00008b80: 3a20 496e 7374 616c 6c61 7469 6f6e 2c20 : Installation, │ │ │ │ │ +00008b90: 2055 703a 2054 6f70 0a0a 3520 426f 6f74 Up: Top..5 Boot │ │ │ │ │ +00008ba0: 696e 670a 2a2a 2a2a 2a2a 2a2a 2a0a 0a47 ing.*********..G │ │ │ │ │ +00008bb0: 5255 4220 6361 6e20 6c6f 6164 204d 756c RUB can load Mul │ │ │ │ │ +00008bc0: 7469 626f 6f74 2d63 6f6d 706c 6961 6e74 tiboot-compliant │ │ │ │ │ +00008bd0: 206b 6572 6e65 6c73 2069 6e20 6120 636f kernels in a co │ │ │ │ │ +00008be0: 6e73 6973 7465 6e74 2077 6179 2c20 6275 nsistent way, bu │ │ │ │ │ +00008bf0: 7420 666f 720a 736f 6d65 2066 7265 6520 t for.some free │ │ │ │ │ +00008c00: 6f70 6572 6174 696e 6720 7379 7374 656d operating system │ │ │ │ │ +00008c10: 7320 796f 7520 6e65 6564 2074 6f20 7573 s you need to us │ │ │ │ │ +00008c20: 6520 736f 6d65 204f 532d 7370 6563 6966 e some OS-specif │ │ │ │ │ +00008c30: 6963 206d 6167 6963 2e0a 0a2a 204d 656e ic magic...* Men │ │ │ │ │ +00008c40: 753a 0a0a 2a20 4765 6e65 7261 6c20 626f u:..* General bo │ │ │ │ │ +00008c50: 6f74 206d 6574 686f 6473 3a3a 2020 2020 ot methods:: │ │ │ │ │ +00008c60: 2020 2020 486f 7720 746f 2062 6f6f 7420 How to boot │ │ │ │ │ +00008c70: 4f53 6573 2077 6974 6820 4752 5542 2067 OSes with GRUB g │ │ │ │ │ +00008c80: 656e 6572 616c 6c79 0a2a 204c 6f6f 7062 enerally.* Loopb │ │ │ │ │ +00008c90: 6163 6b20 626f 6f74 696e 673a 3a20 2020 ack booting:: │ │ │ │ │ +00008ca0: 2020 2020 2020 2020 204e 6f74 6573 206f Notes o │ │ │ │ │ +00008cb0: 6e20 626f 6f74 696e 6720 6672 6f6d 206c n booting from l │ │ │ │ │ +00008cc0: 6f6f 7062 6163 6b73 0a2a 204c 564d 2063 oopbacks.* LVM c │ │ │ │ │ +00008cd0: 6163 6865 2062 6f6f 7469 6e67 3a3a 2020 ache booting:: │ │ │ │ │ +00008ce0: 2020 2020 2020 2020 204e 6f74 6573 206f Notes o │ │ │ │ │ +00008cf0: 6e20 626f 6f74 696e 6720 6672 6f6d 204c n booting from L │ │ │ │ │ +00008d00: 564d 2063 6163 6865 206c 6f67 6963 616c VM cache logical │ │ │ │ │ +00008d10: 2076 6f6c 756d 650a 2a20 4f53 2d73 7065 volume.* OS-spe │ │ │ │ │ +00008d20: 6369 6669 6320 6e6f 7465 733a 3a20 2020 cific notes:: │ │ │ │ │ +00008d30: 2020 2020 2020 2020 4e6f 7465 7320 6f6e Notes on │ │ │ │ │ +00008d40: 2073 6f6d 6520 6f70 6572 6174 696e 6720 some operating │ │ │ │ │ +00008d50: 7379 7374 656d 730a 0a1f 0a46 696c 653a systems....File: │ │ │ │ │ +00008d60: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ +00008d70: 653a 2047 656e 6572 616c 2062 6f6f 7420 e: General boot │ │ │ │ │ +00008d80: 6d65 7468 6f64 732c 2020 4e65 7874 3a20 methods, Next: │ │ │ │ │ +00008d90: 4c6f 6f70 6261 636b 2062 6f6f 7469 6e67 Loopback booting │ │ │ │ │ +00008da0: 2c20 2055 703a 2042 6f6f 7469 6e67 0a0a , Up: Booting.. │ │ │ │ │ +00008db0: 352e 3120 486f 7720 746f 2062 6f6f 7420 5.1 How to boot │ │ │ │ │ +00008dc0: 6f70 6572 6174 696e 6720 7379 7374 656d operating system │ │ │ │ │ +00008dd0: 730a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d s.============== │ │ │ │ │ 00008de0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00008df0: 3d3d 3d3d 3d0a 0a47 5255 4220 6861 7320 =====..GRUB has │ │ │ │ │ -00008e00: 7477 6f20 6469 7374 696e 6374 2062 6f6f two distinct boo │ │ │ │ │ -00008e10: 7420 6d65 7468 6f64 732e 2020 4f6e 6520 t methods. One │ │ │ │ │ -00008e20: 6f66 2074 6865 2074 776f 2069 7320 746f of the two is to │ │ │ │ │ -00008e30: 206c 6f61 6420 616e 0a6f 7065 7261 7469 load an.operati │ │ │ │ │ -00008e40: 6e67 2073 7973 7465 6d20 6469 7265 6374 ng system direct │ │ │ │ │ -00008e50: 6c79 2c20 616e 6420 7468 6520 6f74 6865 ly, and the othe │ │ │ │ │ -00008e60: 7220 6973 2074 6f20 6368 6169 6e2d 6c6f r is to chain-lo │ │ │ │ │ -00008e70: 6164 2061 6e6f 7468 6572 2062 6f6f 740a ad another boot. │ │ │ │ │ -00008e80: 6c6f 6164 6572 2077 6869 6368 2074 6865 loader which the │ │ │ │ │ -00008e90: 6e20 7769 6c6c 206c 6f61 6420 616e 206f n will load an o │ │ │ │ │ -00008ea0: 7065 7261 7469 6e67 2073 7973 7465 6d20 perating system │ │ │ │ │ -00008eb0: 6163 7475 616c 6c79 2e20 2047 656e 6572 actually. Gener │ │ │ │ │ -00008ec0: 616c 6c79 0a73 7065 616b 696e 672c 2074 ally.speaking, t │ │ │ │ │ -00008ed0: 6865 2066 6f72 6d65 7220 6973 206d 6f72 he former is mor │ │ │ │ │ -00008ee0: 6520 6465 7369 7261 626c 652c 2062 6563 e desirable, bec │ │ │ │ │ -00008ef0: 6175 7365 2079 6f75 2064 6f6e 2774 206e ause you don't n │ │ │ │ │ -00008f00: 6565 6420 746f 0a69 6e73 7461 6c6c 206f eed to.install o │ │ │ │ │ -00008f10: 7220 6d61 696e 7461 696e 206f 7468 6572 r maintain other │ │ │ │ │ -00008f20: 2062 6f6f 7420 6c6f 6164 6572 7320 616e boot loaders an │ │ │ │ │ -00008f30: 6420 4752 5542 2069 7320 666c 6578 6962 d GRUB is flexib │ │ │ │ │ -00008f40: 6c65 2065 6e6f 7567 6820 746f 0a6c 6f61 le enough to.loa │ │ │ │ │ -00008f50: 6420 616e 206f 7065 7261 7469 6e67 2073 d an operating s │ │ │ │ │ -00008f60: 7973 7465 6d20 6672 6f6d 2061 6e20 6172 ystem from an ar │ │ │ │ │ -00008f70: 6269 7472 6172 7920 6469 736b 2f70 6172 bitrary disk/par │ │ │ │ │ -00008f80: 7469 7469 6f6e 2e20 2048 6f77 6576 6572 tition. However │ │ │ │ │ -00008f90: 2c20 7468 650a 6c61 7474 6572 2069 7320 , the.latter is │ │ │ │ │ -00008fa0: 736f 6d65 7469 6d65 7320 7265 7175 6972 sometimes requir │ │ │ │ │ -00008fb0: 6564 2c20 7369 6e63 6520 4752 5542 2064 ed, since GRUB d │ │ │ │ │ -00008fc0: 6f65 736e 2774 2073 7570 706f 7274 2061 oesn't support a │ │ │ │ │ -00008fd0: 6c6c 2074 6865 0a65 7869 7374 696e 6720 ll the.existing │ │ │ │ │ -00008fe0: 6f70 6572 6174 696e 6720 7379 7374 656d operating system │ │ │ │ │ -00008ff0: 7320 6e61 7469 7665 6c79 2e0a 0a2a 204d s natively...* M │ │ │ │ │ -00009000: 656e 753a 0a0a 2a20 4c6f 6164 696e 6720 enu:..* Loading │ │ │ │ │ -00009010: 616e 206f 7065 7261 7469 6e67 2073 7973 an operating sys │ │ │ │ │ -00009020: 7465 6d20 6469 7265 6374 6c79 3a3a 0a2a tem directly::.* │ │ │ │ │ -00009030: 2043 6861 696e 2d6c 6f61 6469 6e67 3a3a Chain-loading:: │ │ │ │ │ -00009040: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ -00009050: 6e66 6f2c 2020 4e6f 6465 3a20 4c6f 6164 nfo, Node: Load │ │ │ │ │ -00009060: 696e 6720 616e 206f 7065 7261 7469 6e67 ing an operating │ │ │ │ │ -00009070: 2073 7973 7465 6d20 6469 7265 6374 6c79 system directly │ │ │ │ │ -00009080: 2c20 204e 6578 743a 2043 6861 696e 2d6c , Next: Chain-l │ │ │ │ │ -00009090: 6f61 6469 6e67 2c20 2055 703a 2047 656e oading, Up: Gen │ │ │ │ │ -000090a0: 6572 616c 2062 6f6f 7420 6d65 7468 6f64 eral boot method │ │ │ │ │ -000090b0: 730a 0a35 2e31 2e31 2048 6f77 2074 6f20 s..5.1.1 How to │ │ │ │ │ -000090c0: 626f 6f74 2061 6e20 4f53 2064 6972 6563 boot an OS direc │ │ │ │ │ -000090d0: 746c 7920 7769 7468 2047 5255 420a 2d2d tly with GRUB.-- │ │ │ │ │ +00008df0: 3d3d 3d0a 0a47 5255 4220 6861 7320 7477 ===..GRUB has tw │ │ │ │ │ +00008e00: 6f20 6469 7374 696e 6374 2062 6f6f 7420 o distinct boot │ │ │ │ │ +00008e10: 6d65 7468 6f64 732e 2020 4f6e 6520 6f66 methods. One of │ │ │ │ │ +00008e20: 2074 6865 2074 776f 2069 7320 746f 206c the two is to l │ │ │ │ │ +00008e30: 6f61 6420 616e 0a6f 7065 7261 7469 6e67 oad an.operating │ │ │ │ │ +00008e40: 2073 7973 7465 6d20 6469 7265 6374 6c79 system directly │ │ │ │ │ +00008e50: 2c20 616e 6420 7468 6520 6f74 6865 7220 , and the other │ │ │ │ │ +00008e60: 6973 2074 6f20 6368 6169 6e2d 6c6f 6164 is to chain-load │ │ │ │ │ +00008e70: 2061 6e6f 7468 6572 2062 6f6f 740a 6c6f another boot.lo │ │ │ │ │ +00008e80: 6164 6572 2077 6869 6368 2074 6865 6e20 ader which then │ │ │ │ │ +00008e90: 7769 6c6c 206c 6f61 6420 616e 206f 7065 will load an ope │ │ │ │ │ +00008ea0: 7261 7469 6e67 2073 7973 7465 6d20 6163 rating system ac │ │ │ │ │ +00008eb0: 7475 616c 6c79 2e20 2047 656e 6572 616c tually. General │ │ │ │ │ +00008ec0: 6c79 0a73 7065 616b 696e 672c 2074 6865 ly.speaking, the │ │ │ │ │ +00008ed0: 2066 6f72 6d65 7220 6973 206d 6f72 6520 former is more │ │ │ │ │ +00008ee0: 6465 7369 7261 626c 652c 2062 6563 6175 desirable, becau │ │ │ │ │ +00008ef0: 7365 2079 6f75 2064 6f6e 2774 206e 6565 se you don't nee │ │ │ │ │ +00008f00: 6420 746f 0a69 6e73 7461 6c6c 206f 7220 d to.install or │ │ │ │ │ +00008f10: 6d61 696e 7461 696e 206f 7468 6572 2062 maintain other b │ │ │ │ │ +00008f20: 6f6f 7420 6c6f 6164 6572 7320 616e 6420 oot loaders and │ │ │ │ │ +00008f30: 4752 5542 2069 7320 666c 6578 6962 6c65 GRUB is flexible │ │ │ │ │ +00008f40: 2065 6e6f 7567 6820 746f 0a6c 6f61 6420 enough to.load │ │ │ │ │ +00008f50: 616e 206f 7065 7261 7469 6e67 2073 7973 an operating sys │ │ │ │ │ +00008f60: 7465 6d20 6672 6f6d 2061 6e20 6172 6269 tem from an arbi │ │ │ │ │ +00008f70: 7472 6172 7920 6469 736b 2f70 6172 7469 trary disk/parti │ │ │ │ │ +00008f80: 7469 6f6e 2e20 2048 6f77 6576 6572 2c20 tion. However, │ │ │ │ │ +00008f90: 7468 650a 6c61 7474 6572 2069 7320 736f the.latter is so │ │ │ │ │ +00008fa0: 6d65 7469 6d65 7320 7265 7175 6972 6564 metimes required │ │ │ │ │ +00008fb0: 2c20 7369 6e63 6520 4752 5542 2064 6f65 , since GRUB doe │ │ │ │ │ +00008fc0: 736e 2774 2073 7570 706f 7274 2061 6c6c sn't support all │ │ │ │ │ +00008fd0: 2074 6865 0a65 7869 7374 696e 6720 6f70 the.existing op │ │ │ │ │ +00008fe0: 6572 6174 696e 6720 7379 7374 656d 7320 erating systems │ │ │ │ │ +00008ff0: 6e61 7469 7665 6c79 2e0a 0a2a 204d 656e natively...* Men │ │ │ │ │ +00009000: 753a 0a0a 2a20 4c6f 6164 696e 6720 616e u:..* Loading an │ │ │ │ │ +00009010: 206f 7065 7261 7469 6e67 2073 7973 7465 operating syste │ │ │ │ │ +00009020: 6d20 6469 7265 6374 6c79 3a3a 0a2a 2043 m directly::.* C │ │ │ │ │ +00009030: 6861 696e 2d6c 6f61 6469 6e67 3a3a 0a0a hain-loading::.. │ │ │ │ │ +00009040: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ +00009050: 6f2c 2020 4e6f 6465 3a20 4c6f 6164 696e o, Node: Loadin │ │ │ │ │ +00009060: 6720 616e 206f 7065 7261 7469 6e67 2073 g an operating s │ │ │ │ │ +00009070: 7973 7465 6d20 6469 7265 6374 6c79 2c20 ystem directly, │ │ │ │ │ +00009080: 204e 6578 743a 2043 6861 696e 2d6c 6f61 Next: Chain-loa │ │ │ │ │ +00009090: 6469 6e67 2c20 2055 703a 2047 656e 6572 ding, Up: Gener │ │ │ │ │ +000090a0: 616c 2062 6f6f 7420 6d65 7468 6f64 730a al boot methods. │ │ │ │ │ +000090b0: 0a35 2e31 2e31 2048 6f77 2074 6f20 626f .5.1.1 How to bo │ │ │ │ │ +000090c0: 6f74 2061 6e20 4f53 2064 6972 6563 746c ot an OS directl │ │ │ │ │ +000090d0: 7920 7769 7468 2047 5255 420a 2d2d 2d2d y with GRUB.---- │ │ │ │ │ 000090e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 000090f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00009100: 2d2d 2d2d 2d2d 2d2d 0a0a 4d75 6c74 6962 --------..Multib │ │ │ │ │ -00009110: 6f6f 7420 282a 6e6f 7465 204d 756c 7469 oot (*note Multi │ │ │ │ │ -00009120: 626f 6f74 2053 7065 6369 6669 6361 7469 boot Specificati │ │ │ │ │ -00009130: 6f6e 3a20 286d 756c 7469 626f 6f74 2954 on: (multiboot)T │ │ │ │ │ -00009140: 6f70 2e29 2069 7320 7468 6520 6e61 7469 op.) is the nati │ │ │ │ │ -00009150: 7665 0a66 6f72 6d61 7420 7375 7070 6f72 ve.format suppor │ │ │ │ │ -00009160: 7465 6420 6279 2047 5255 422e 2046 6f72 ted by GRUB. For │ │ │ │ │ -00009170: 2074 6865 2073 616b 6520 6f66 2063 6f6e the sake of con │ │ │ │ │ -00009180: 7665 6e69 656e 6365 2c20 7468 6572 6520 venience, there │ │ │ │ │ -00009190: 6973 2061 6c73 6f0a 7375 7070 6f72 7420 is also.support │ │ │ │ │ -000091a0: 666f 7220 4c69 6e75 782c 2046 7265 6542 for Linux, FreeB │ │ │ │ │ -000091b0: 5344 2c20 4e65 7442 5344 2061 6e64 204f SD, NetBSD and O │ │ │ │ │ -000091c0: 7065 6e42 5344 2e20 4966 2079 6f75 2077 penBSD. If you w │ │ │ │ │ -000091d0: 616e 7420 746f 2062 6f6f 740a 6f74 6865 ant to boot.othe │ │ │ │ │ -000091e0: 7220 6f70 6572 6174 696e 6720 7379 7374 r operating syst │ │ │ │ │ -000091f0: 656d 732c 2079 6f75 2077 696c 6c20 6861 ems, you will ha │ │ │ │ │ -00009200: 7665 2074 6f20 6368 6169 6e2d 6c6f 6164 ve to chain-load │ │ │ │ │ -00009210: 2074 6865 6d20 282a 6e6f 7465 0a43 6861 them (*note.Cha │ │ │ │ │ -00009220: 696e 2d6c 6f61 6469 6e67 3a3a 292e 0a0a in-loading::)... │ │ │ │ │ -00009230: 2020 2046 4958 4d45 3a20 7468 6973 2073 FIXME: this s │ │ │ │ │ -00009240: 6563 7469 6f6e 2069 7320 696e 636f 6d70 ection is incomp │ │ │ │ │ -00009250: 6c65 7465 2e0a 0a20 2031 2e20 5275 6e20 lete... 1. Run │ │ │ │ │ -00009260: 7468 6520 636f 6d6d 616e 6420 2762 6f6f the command 'boo │ │ │ │ │ -00009270: 7427 2028 2a6e 6f74 6520 626f 6f74 3a3a t' (*note boot:: │ │ │ │ │ -00009280: 292e 0a0a 2020 2048 6f77 6576 6572 2c20 )... However, │ │ │ │ │ -00009290: 444f 5320 616e 6420 5769 6e64 6f77 7320 DOS and Windows │ │ │ │ │ -000092a0: 6861 7665 2073 6f6d 6520 6465 6669 6369 have some defici │ │ │ │ │ -000092b0: 656e 6369 6573 2c20 736f 2079 6f75 206d encies, so you m │ │ │ │ │ -000092c0: 6967 6874 2068 6176 6520 746f 0a75 7365 ight have to.use │ │ │ │ │ -000092d0: 206d 6f72 6520 636f 6d70 6c69 6361 7465 more complicate │ │ │ │ │ -000092e0: 6420 696e 7374 7275 6374 696f 6e73 2e20 d instructions. │ │ │ │ │ -000092f0: 202a 4e6f 7465 2044 4f53 2f57 696e 646f *Note DOS/Windo │ │ │ │ │ -00009300: 7773 3a3a 2c20 666f 7220 6d6f 7265 0a69 ws::, for more.i │ │ │ │ │ -00009310: 6e66 6f72 6d61 7469 6f6e 2e0a 0a1f 0a46 nformation.....F │ │ │ │ │ -00009320: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ -00009330: 204e 6f64 653a 2043 6861 696e 2d6c 6f61 Node: Chain-loa │ │ │ │ │ -00009340: 6469 6e67 2c20 2050 7265 763a 204c 6f61 ding, Prev: Loa │ │ │ │ │ -00009350: 6469 6e67 2061 6e20 6f70 6572 6174 696e ding an operatin │ │ │ │ │ -00009360: 6720 7379 7374 656d 2064 6972 6563 746c g system directl │ │ │ │ │ -00009370: 792c 2020 5570 3a20 4765 6e65 7261 6c20 y, Up: General │ │ │ │ │ -00009380: 626f 6f74 206d 6574 686f 6473 0a0a 352e boot methods..5. │ │ │ │ │ -00009390: 312e 3220 4368 6169 6e2d 6c6f 6164 696e 1.2 Chain-loadin │ │ │ │ │ -000093a0: 6720 616e 204f 530a 2d2d 2d2d 2d2d 2d2d g an OS.-------- │ │ │ │ │ -000093b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -000093c0: 2d0a 0a4f 7065 7261 7469 6e67 2073 7973 -..Operating sys │ │ │ │ │ -000093d0: 7465 6d73 2074 6861 7420 646f 206e 6f74 tems that do not │ │ │ │ │ -000093e0: 2073 7570 706f 7274 204d 756c 7469 626f support Multibo │ │ │ │ │ -000093f0: 6f74 2061 6e64 2064 6f20 6e6f 7420 6861 ot and do not ha │ │ │ │ │ -00009400: 7665 2073 7065 6369 6669 630a 7375 7070 ve specific.supp │ │ │ │ │ -00009410: 6f72 7420 696e 2047 5255 4220 2873 7065 ort in GRUB (spe │ │ │ │ │ -00009420: 6369 6669 6320 7375 7070 6f72 7420 6973 cific support is │ │ │ │ │ -00009430: 2061 7661 696c 6162 6c65 2066 6f72 204c available for L │ │ │ │ │ -00009440: 696e 7578 2c20 4672 6565 4253 442c 0a4e inux, FreeBSD,.N │ │ │ │ │ -00009450: 6574 4253 4420 616e 6420 4f70 656e 4253 etBSD and OpenBS │ │ │ │ │ -00009460: 4429 206d 7573 7420 6265 2063 6861 696e D) must be chain │ │ │ │ │ -00009470: 2d6c 6f61 6465 642c 2077 6869 6368 2069 -loaded, which i │ │ │ │ │ -00009480: 6e76 6f6c 7665 7320 6c6f 6164 696e 6720 nvolves loading │ │ │ │ │ -00009490: 616e 6f74 6865 720a 626f 6f74 206c 6f61 another.boot loa │ │ │ │ │ -000094a0: 6465 7220 616e 6420 6a75 6d70 696e 6720 der and jumping │ │ │ │ │ -000094b0: 746f 2069 7420 696e 2072 6561 6c20 6d6f to it in real mo │ │ │ │ │ -000094c0: 6465 2e0a 0a20 2020 5468 6520 2763 6861 de... The 'cha │ │ │ │ │ -000094d0: 696e 6c6f 6164 6572 2720 636f 6d6d 616e inloader' comman │ │ │ │ │ -000094e0: 6420 282a 6e6f 7465 2063 6861 696e 6c6f d (*note chainlo │ │ │ │ │ -000094f0: 6164 6572 3a3a 2920 6973 2075 7365 6420 ader::) is used │ │ │ │ │ -00009500: 746f 2073 6574 2074 6869 730a 7570 2e20 to set this.up. │ │ │ │ │ -00009510: 2049 7420 6973 206e 6f72 6d61 6c6c 7920 It is normally │ │ │ │ │ -00009520: 616c 736f 206e 6563 6573 7361 7279 2074 also necessary t │ │ │ │ │ -00009530: 6f20 6c6f 6164 2073 6f6d 6520 4752 5542 o load some GRUB │ │ │ │ │ -00009540: 206d 6f64 756c 6573 2061 6e64 2073 6574 modules and set │ │ │ │ │ -00009550: 2074 6865 0a61 7070 726f 7072 6961 7465 the.appropriate │ │ │ │ │ -00009560: 2072 6f6f 7420 6465 7669 6365 2e20 2050 root device. P │ │ │ │ │ -00009570: 7574 7469 6e67 2074 6869 7320 746f 6765 utting this toge │ │ │ │ │ -00009580: 7468 6572 2c20 7765 2067 6574 2073 6f6d ther, we get som │ │ │ │ │ -00009590: 6574 6869 6e67 206c 696b 650a 7468 6973 ething like.this │ │ │ │ │ -000095a0: 2c20 666f 7220 6120 5769 6e64 6f77 7320 , for a Windows │ │ │ │ │ -000095b0: 7379 7374 656d 206f 6e20 7468 6520 6669 system on the fi │ │ │ │ │ -000095c0: 7273 7420 7061 7274 6974 696f 6e20 6f66 rst partition of │ │ │ │ │ -000095d0: 2074 6865 2066 6972 7374 2068 6172 640a the first hard. │ │ │ │ │ -000095e0: 6469 736b 3a0a 0a6d 656e 7565 6e74 7279 disk:..menuentry │ │ │ │ │ -000095f0: 2022 5769 6e64 6f77 7322 207b 0a09 696e "Windows" {..in │ │ │ │ │ -00009600: 736d 6f64 2063 6861 696e 0a09 696e 736d smod chain..insm │ │ │ │ │ -00009610: 6f64 206e 7466 730a 0973 6574 2072 6f6f od ntfs..set roo │ │ │ │ │ -00009620: 743d 2868 6430 2c31 290a 0963 6861 696e t=(hd0,1)..chain │ │ │ │ │ -00009630: 6c6f 6164 6572 202b 310a 7d0a 0a20 2020 loader +1.}.. │ │ │ │ │ -00009640: 4f6e 2073 7973 7465 6d73 2077 6974 6820 On systems with │ │ │ │ │ -00009650: 6d75 6c74 6970 6c65 2068 6172 6420 6469 multiple hard di │ │ │ │ │ -00009660: 736b 732c 2061 6e20 6164 6469 7469 6f6e sks, an addition │ │ │ │ │ -00009670: 616c 2077 6f72 6b61 726f 756e 6420 6d61 al workaround ma │ │ │ │ │ -00009680: 7920 6265 0a72 6571 7569 7265 642e 2020 y be.required. │ │ │ │ │ -00009690: 2a4e 6f74 6520 444f 532f 5769 6e64 6f77 *Note DOS/Window │ │ │ │ │ -000096a0: 733a 3a2e 0a0a 2020 2043 6861 696e 2d6c s::... Chain-l │ │ │ │ │ -000096b0: 6f61 6469 6e67 2069 7320 6f6e 6c79 2073 oading is only s │ │ │ │ │ -000096c0: 7570 706f 7274 6564 206f 6e20 5043 2042 upported on PC B │ │ │ │ │ -000096d0: 494f 5320 616e 6420 4546 4920 706c 6174 IOS and EFI plat │ │ │ │ │ -000096e0: 666f 726d 732e 0a0a 1f0a 4669 6c65 3a20 forms.....File: │ │ │ │ │ -000096f0: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ -00009700: 3a20 4c6f 6f70 6261 636b 2062 6f6f 7469 : Loopback booti │ │ │ │ │ -00009710: 6e67 2c20 204e 6578 743a 204c 564d 2063 ng, Next: LVM c │ │ │ │ │ -00009720: 6163 6865 2062 6f6f 7469 6e67 2c20 2050 ache booting, P │ │ │ │ │ -00009730: 7265 763a 2047 656e 6572 616c 2062 6f6f rev: General boo │ │ │ │ │ -00009740: 7420 6d65 7468 6f64 732c 2020 5570 3a20 t methods, Up: │ │ │ │ │ -00009750: 426f 6f74 696e 670a 0a35 2e32 204c 6f6f Booting..5.2 Loo │ │ │ │ │ -00009760: 7062 6163 6b20 626f 6f74 696e 670a 3d3d pback booting.== │ │ │ │ │ +00009100: 2d2d 2d2d 2d2d 0a0a 4d75 6c74 6962 6f6f ------..Multiboo │ │ │ │ │ +00009110: 7420 282a 6e6f 7465 204d 756c 7469 626f t (*note Multibo │ │ │ │ │ +00009120: 6f74 2053 7065 6369 6669 6361 7469 6f6e ot Specification │ │ │ │ │ +00009130: 3a20 286d 756c 7469 626f 6f74 2954 6f70 : (multiboot)Top │ │ │ │ │ +00009140: 2e29 2069 7320 7468 6520 6e61 7469 7665 .) is the native │ │ │ │ │ +00009150: 0a66 6f72 6d61 7420 7375 7070 6f72 7465 .format supporte │ │ │ │ │ +00009160: 6420 6279 2047 5255 422e 2046 6f72 2074 d by GRUB. For t │ │ │ │ │ +00009170: 6865 2073 616b 6520 6f66 2063 6f6e 7665 he sake of conve │ │ │ │ │ +00009180: 6e69 656e 6365 2c20 7468 6572 6520 6973 nience, there is │ │ │ │ │ +00009190: 2061 6c73 6f0a 7375 7070 6f72 7420 666f also.support fo │ │ │ │ │ +000091a0: 7220 4c69 6e75 782c 2046 7265 6542 5344 r Linux, FreeBSD │ │ │ │ │ +000091b0: 2c20 4e65 7442 5344 2061 6e64 204f 7065 , NetBSD and Ope │ │ │ │ │ +000091c0: 6e42 5344 2e20 4966 2079 6f75 2077 616e nBSD. If you wan │ │ │ │ │ +000091d0: 7420 746f 2062 6f6f 740a 6f74 6865 7220 t to boot.other │ │ │ │ │ +000091e0: 6f70 6572 6174 696e 6720 7379 7374 656d operating system │ │ │ │ │ +000091f0: 732c 2079 6f75 2077 696c 6c20 6861 7665 s, you will have │ │ │ │ │ +00009200: 2074 6f20 6368 6169 6e2d 6c6f 6164 2074 to chain-load t │ │ │ │ │ +00009210: 6865 6d20 282a 6e6f 7465 0a43 6861 696e hem (*note.Chain │ │ │ │ │ +00009220: 2d6c 6f61 6469 6e67 3a3a 292e 0a0a 2020 -loading::)... │ │ │ │ │ +00009230: 2046 4958 4d45 3a20 7468 6973 2073 6563 FIXME: this sec │ │ │ │ │ +00009240: 7469 6f6e 2069 7320 696e 636f 6d70 6c65 tion is incomple │ │ │ │ │ +00009250: 7465 2e0a 0a20 2031 2e20 5275 6e20 7468 te... 1. Run th │ │ │ │ │ +00009260: 6520 636f 6d6d 616e 6420 2762 6f6f 7427 e command 'boot' │ │ │ │ │ +00009270: 2028 2a6e 6f74 6520 626f 6f74 3a3a 292e (*note boot::). │ │ │ │ │ +00009280: 0a0a 2020 2048 6f77 6576 6572 2c20 444f .. However, DO │ │ │ │ │ +00009290: 5320 616e 6420 5769 6e64 6f77 7320 6861 S and Windows ha │ │ │ │ │ +000092a0: 7665 2073 6f6d 6520 6465 6669 6369 656e ve some deficien │ │ │ │ │ +000092b0: 6369 6573 2c20 736f 2079 6f75 206d 6967 cies, so you mig │ │ │ │ │ +000092c0: 6874 2068 6176 6520 746f 0a75 7365 206d ht have to.use m │ │ │ │ │ +000092d0: 6f72 6520 636f 6d70 6c69 6361 7465 6420 ore complicated │ │ │ │ │ +000092e0: 696e 7374 7275 6374 696f 6e73 2e20 202a instructions. * │ │ │ │ │ +000092f0: 4e6f 7465 2044 4f53 2f57 696e 646f 7773 Note DOS/Windows │ │ │ │ │ +00009300: 3a3a 2c20 666f 7220 6d6f 7265 0a69 6e66 ::, for more.inf │ │ │ │ │ +00009310: 6f72 6d61 7469 6f6e 2e0a 0a1f 0a46 696c ormation.....Fil │ │ │ │ │ +00009320: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ +00009330: 6f64 653a 2043 6861 696e 2d6c 6f61 6469 ode: Chain-loadi │ │ │ │ │ +00009340: 6e67 2c20 2050 7265 763a 204c 6f61 6469 ng, Prev: Loadi │ │ │ │ │ +00009350: 6e67 2061 6e20 6f70 6572 6174 696e 6720 ng an operating │ │ │ │ │ +00009360: 7379 7374 656d 2064 6972 6563 746c 792c system directly, │ │ │ │ │ +00009370: 2020 5570 3a20 4765 6e65 7261 6c20 626f Up: General bo │ │ │ │ │ +00009380: 6f74 206d 6574 686f 6473 0a0a 352e 312e ot methods..5.1. │ │ │ │ │ +00009390: 3220 4368 6169 6e2d 6c6f 6164 696e 6720 2 Chain-loading │ │ │ │ │ +000093a0: 616e 204f 530a 2d2d 2d2d 2d2d 2d2d 2d2d an OS.---------- │ │ │ │ │ +000093b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ +000093c0: 0a4f 7065 7261 7469 6e67 2073 7973 7465 .Operating syste │ │ │ │ │ +000093d0: 6d73 2074 6861 7420 646f 206e 6f74 2073 ms that do not s │ │ │ │ │ +000093e0: 7570 706f 7274 204d 756c 7469 626f 6f74 upport Multiboot │ │ │ │ │ +000093f0: 2061 6e64 2064 6f20 6e6f 7420 6861 7665 and do not have │ │ │ │ │ +00009400: 2073 7065 6369 6669 630a 7375 7070 6f72 specific.suppor │ │ │ │ │ +00009410: 7420 696e 2047 5255 4220 2873 7065 6369 t in GRUB (speci │ │ │ │ │ +00009420: 6669 6320 7375 7070 6f72 7420 6973 2061 fic support is a │ │ │ │ │ +00009430: 7661 696c 6162 6c65 2066 6f72 204c 696e vailable for Lin │ │ │ │ │ +00009440: 7578 2c20 4672 6565 4253 442c 0a4e 6574 ux, FreeBSD,.Net │ │ │ │ │ +00009450: 4253 4420 616e 6420 4f70 656e 4253 4429 BSD and OpenBSD) │ │ │ │ │ +00009460: 206d 7573 7420 6265 2063 6861 696e 2d6c must be chain-l │ │ │ │ │ +00009470: 6f61 6465 642c 2077 6869 6368 2069 6e76 oaded, which inv │ │ │ │ │ +00009480: 6f6c 7665 7320 6c6f 6164 696e 6720 616e olves loading an │ │ │ │ │ +00009490: 6f74 6865 720a 626f 6f74 206c 6f61 6465 other.boot loade │ │ │ │ │ +000094a0: 7220 616e 6420 6a75 6d70 696e 6720 746f r and jumping to │ │ │ │ │ +000094b0: 2069 7420 696e 2072 6561 6c20 6d6f 6465 it in real mode │ │ │ │ │ +000094c0: 2e0a 0a20 2020 5468 6520 2763 6861 696e ... The 'chain │ │ │ │ │ +000094d0: 6c6f 6164 6572 2720 636f 6d6d 616e 6420 loader' command │ │ │ │ │ +000094e0: 282a 6e6f 7465 2063 6861 696e 6c6f 6164 (*note chainload │ │ │ │ │ +000094f0: 6572 3a3a 2920 6973 2075 7365 6420 746f er::) is used to │ │ │ │ │ +00009500: 2073 6574 2074 6869 730a 7570 2e20 2049 set this.up. I │ │ │ │ │ +00009510: 7420 6973 206e 6f72 6d61 6c6c 7920 616c t is normally al │ │ │ │ │ +00009520: 736f 206e 6563 6573 7361 7279 2074 6f20 so necessary to │ │ │ │ │ +00009530: 6c6f 6164 2073 6f6d 6520 4752 5542 206d load some GRUB m │ │ │ │ │ +00009540: 6f64 756c 6573 2061 6e64 2073 6574 2074 odules and set t │ │ │ │ │ +00009550: 6865 0a61 7070 726f 7072 6961 7465 2072 he.appropriate r │ │ │ │ │ +00009560: 6f6f 7420 6465 7669 6365 2e20 2050 7574 oot device. Put │ │ │ │ │ +00009570: 7469 6e67 2074 6869 7320 746f 6765 7468 ting this togeth │ │ │ │ │ +00009580: 6572 2c20 7765 2067 6574 2073 6f6d 6574 er, we get somet │ │ │ │ │ +00009590: 6869 6e67 206c 696b 650a 7468 6973 2c20 hing like.this, │ │ │ │ │ +000095a0: 666f 7220 6120 5769 6e64 6f77 7320 7379 for a Windows sy │ │ │ │ │ +000095b0: 7374 656d 206f 6e20 7468 6520 6669 7273 stem on the firs │ │ │ │ │ +000095c0: 7420 7061 7274 6974 696f 6e20 6f66 2074 t partition of t │ │ │ │ │ +000095d0: 6865 2066 6972 7374 2068 6172 640a 6469 he first hard.di │ │ │ │ │ +000095e0: 736b 3a0a 0a6d 656e 7565 6e74 7279 2022 sk:..menuentry " │ │ │ │ │ +000095f0: 5769 6e64 6f77 7322 207b 0a09 696e 736d Windows" {..insm │ │ │ │ │ +00009600: 6f64 2063 6861 696e 0a09 696e 736d 6f64 od chain..insmod │ │ │ │ │ +00009610: 206e 7466 730a 0973 6574 2072 6f6f 743d ntfs..set root= │ │ │ │ │ +00009620: 2868 6430 2c31 290a 0963 6861 696e 6c6f (hd0,1)..chainlo │ │ │ │ │ +00009630: 6164 6572 202b 310a 7d0a 0a20 2020 4f6e ader +1.}.. On │ │ │ │ │ +00009640: 2073 7973 7465 6d73 2077 6974 6820 6d75 systems with mu │ │ │ │ │ +00009650: 6c74 6970 6c65 2068 6172 6420 6469 736b ltiple hard disk │ │ │ │ │ +00009660: 732c 2061 6e20 6164 6469 7469 6f6e 616c s, an additional │ │ │ │ │ +00009670: 2077 6f72 6b61 726f 756e 6420 6d61 7920 workaround may │ │ │ │ │ +00009680: 6265 0a72 6571 7569 7265 642e 2020 2a4e be.required. *N │ │ │ │ │ +00009690: 6f74 6520 444f 532f 5769 6e64 6f77 733a ote DOS/Windows: │ │ │ │ │ +000096a0: 3a2e 0a0a 2020 2043 6861 696e 2d6c 6f61 :... Chain-loa │ │ │ │ │ +000096b0: 6469 6e67 2069 7320 6f6e 6c79 2073 7570 ding is only sup │ │ │ │ │ +000096c0: 706f 7274 6564 206f 6e20 5043 2042 494f ported on PC BIO │ │ │ │ │ +000096d0: 5320 616e 6420 4546 4920 706c 6174 666f S and EFI platfo │ │ │ │ │ +000096e0: 726d 732e 0a0a 1f0a 4669 6c65 3a20 6772 rms.....File: gr │ │ │ │ │ +000096f0: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ +00009700: 4c6f 6f70 6261 636b 2062 6f6f 7469 6e67 Loopback booting │ │ │ │ │ +00009710: 2c20 204e 6578 743a 204c 564d 2063 6163 , Next: LVM cac │ │ │ │ │ +00009720: 6865 2062 6f6f 7469 6e67 2c20 2050 7265 he booting, Pre │ │ │ │ │ +00009730: 763a 2047 656e 6572 616c 2062 6f6f 7420 v: General boot │ │ │ │ │ +00009740: 6d65 7468 6f64 732c 2020 5570 3a20 426f methods, Up: Bo │ │ │ │ │ +00009750: 6f74 696e 670a 0a35 2e32 204c 6f6f 7062 oting..5.2 Loopb │ │ │ │ │ +00009760: 6163 6b20 626f 6f74 696e 670a 3d3d 3d3d ack booting.==== │ │ │ │ │ 00009770: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00009780: 3d3d 0a0a 4752 5542 2069 7320 6162 6c65 ==..GRUB is able │ │ │ │ │ -00009790: 2074 6f20 7265 6164 2066 726f 6d20 616e to read from an │ │ │ │ │ -000097a0: 2069 6d61 6765 2028 6265 2069 7420 6f6e image (be it on │ │ │ │ │ -000097b0: 6520 6f66 2043 4420 6f72 2048 4444 2920 e of CD or HDD) │ │ │ │ │ -000097c0: 7374 6f72 6564 206f 6e0a 616e 7920 6f66 stored on.any of │ │ │ │ │ -000097d0: 2069 7473 2061 6363 6573 7369 626c 6520 its accessible │ │ │ │ │ -000097e0: 7374 6f72 6167 6573 2028 7265 6665 7220 storages (refer │ │ │ │ │ -000097f0: 746f 202a 6e6f 7465 206c 6f6f 7062 6163 to *note loopbac │ │ │ │ │ -00009800: 6b3a 3a20 636f 6d6d 616e 6429 2e0a 486f k:: command)..Ho │ │ │ │ │ -00009810: 7765 7665 7220 7468 6520 4f53 2069 7473 wever the OS its │ │ │ │ │ -00009820: 656c 6620 7368 6f75 6c64 2062 6520 6162 elf should be ab │ │ │ │ │ -00009830: 6c65 2074 6f20 6669 6e64 2069 7473 2072 le to find its r │ │ │ │ │ -00009840: 6f6f 742e 2020 5468 6973 2075 7375 616c oot. This usual │ │ │ │ │ -00009850: 6c79 0a69 6e76 6f6c 7665 7320 7275 6e6e ly.involves runn │ │ │ │ │ -00009860: 696e 6720 6120 7573 6572 7370 6163 6520 ing a userspace │ │ │ │ │ -00009870: 7072 6f67 7261 6d20 7275 6e6e 696e 6720 program running │ │ │ │ │ -00009880: 6265 666f 7265 2074 6865 2072 6561 6c20 before the real │ │ │ │ │ -00009890: 726f 6f74 2069 730a 6469 7363 6f76 6572 root is.discover │ │ │ │ │ -000098a0: 6564 2e20 2054 6869 7320 6973 2061 6368 ed. This is ach │ │ │ │ │ -000098b0: 6965 7665 6420 6279 2047 5255 4220 6c6f ieved by GRUB lo │ │ │ │ │ -000098c0: 6164 696e 6720 6120 7370 6563 6961 6c6c ading a speciall │ │ │ │ │ -000098d0: 7920 6d61 6465 2073 6d61 6c6c 0a69 6d61 y made small.ima │ │ │ │ │ -000098e0: 6765 2061 6e64 2070 6173 7369 6e67 2069 ge and passing i │ │ │ │ │ -000098f0: 7420 6173 2072 616d 6469 736b 2074 6f20 t as ramdisk to │ │ │ │ │ -00009900: 7468 6520 6b65 726e 656c 2e20 2054 6869 the kernel. Thi │ │ │ │ │ -00009910: 7320 6973 2061 6368 6965 7665 6420 6279 s is achieved by │ │ │ │ │ -00009920: 0a63 6f6d 6d61 6e64 7320 276b 6672 6565 .commands 'kfree │ │ │ │ │ -00009930: 6273 645f 6d6f 6475 6c65 272c 2027 6b6e bsd_module', 'kn │ │ │ │ │ -00009940: 6574 6273 645f 6d6f 6475 6c65 5f65 6c66 etbsd_module_elf │ │ │ │ │ -00009950: 272c 2027 6b6f 7065 6e62 7364 5f72 616d ', 'kopenbsd_ram │ │ │ │ │ -00009960: 6469 736b 272c 0a27 696e 6974 7264 2720 disk',.'initrd' │ │ │ │ │ -00009970: 282a 6e6f 7465 2069 6e69 7472 643a 3a29 (*note initrd::) │ │ │ │ │ -00009980: 2c20 2769 6e69 7472 6431 3627 2028 2a6e , 'initrd16' (*n │ │ │ │ │ -00009990: 6f74 6520 696e 6974 7264 3a3a 292c 0a27 ote initrd::),.' │ │ │ │ │ -000099a0: 6d75 6c74 6962 6f6f 745f 6d6f 6475 6c65 multiboot_module │ │ │ │ │ -000099b0: 272c 2027 6d75 6c74 6962 6f6f 7432 5f6d ', 'multiboot2_m │ │ │ │ │ -000099c0: 6f64 756c 6527 206f 7220 2778 6e75 5f72 odule' or 'xnu_r │ │ │ │ │ -000099d0: 616d 6469 736b 2720 6465 7065 6e64 696e amdisk' dependin │ │ │ │ │ -000099e0: 6720 6f6e 0a74 6865 206c 6f61 6465 722e g on.the loader. │ │ │ │ │ -000099f0: 2020 4e6f 7465 2074 6861 7420 666f 7220 Note that for │ │ │ │ │ -00009a00: 6b6e 6574 6273 6420 7468 6520 696d 6167 knetbsd the imag │ │ │ │ │ -00009a10: 6520 6d75 7374 2062 6520 7075 7420 696e e must be put in │ │ │ │ │ -00009a20: 7369 6465 0a6d 696e 6972 6f6f 742e 6b6d side.miniroot.km │ │ │ │ │ -00009a30: 6f64 2061 6e64 2074 6865 2077 686f 6c65 od and the whole │ │ │ │ │ -00009a40: 206d 696e 6972 6f6f 742e 6b6d 6f64 2068 miniroot.kmod h │ │ │ │ │ -00009a50: 6173 2074 6f20 6265 206c 6f61 6465 642e as to be loaded. │ │ │ │ │ -00009a60: 2020 496e 206b 6f70 656e 6273 640a 7061 In kopenbsd.pa │ │ │ │ │ -00009a70: 796c 6f61 6420 7468 6973 2069 7320 6469 yload this is di │ │ │ │ │ -00009a80: 7361 626c 6564 2062 7920 6465 6661 756c sabled by defaul │ │ │ │ │ -00009a90: 742e 2020 4164 6974 696f 6e61 6c6c 7920 t. Aditionally │ │ │ │ │ -00009aa0: 6265 6861 7669 6f75 7220 6f66 2069 6e69 behaviour of ini │ │ │ │ │ -00009ab0: 7469 616c 0a72 616d 6469 736b 2064 6570 tial.ramdisk dep │ │ │ │ │ -00009ac0: 656e 6473 206f 6e20 636f 6d6d 616e 6420 ends on command │ │ │ │ │ -00009ad0: 6c69 6e65 206f 7074 696f 6e73 2e20 2053 line options. S │ │ │ │ │ -00009ae0: 6576 6572 616c 2064 6973 7472 6962 7574 everal distribut │ │ │ │ │ -00009af0: 6f72 7320 7072 6f76 6964 650a 7468 6520 ors provide.the │ │ │ │ │ -00009b00: 696d 6167 6520 666f 7220 7468 6973 2070 image for this p │ │ │ │ │ -00009b10: 7572 706f 7365 206f 7220 6974 2773 2069 urpose or it's i │ │ │ │ │ -00009b20: 6e74 6567 7261 7465 6420 696e 2074 6865 ntegrated in the │ │ │ │ │ -00009b30: 6972 2073 7461 6e64 6172 6420 7261 6d64 ir standard ramd │ │ │ │ │ -00009b40: 6973 6b0a 616e 6420 6163 7469 7661 7465 isk.and activate │ │ │ │ │ -00009b50: 6420 6279 2073 7065 6369 616c 206f 7074 d by special opt │ │ │ │ │ -00009b60: 696f 6e2e 2020 436f 6e73 756c 7420 796f ion. Consult yo │ │ │ │ │ -00009b70: 7572 206b 6572 6e65 6c20 616e 6420 6469 ur kernel and di │ │ │ │ │ -00009b80: 7374 7269 6275 7469 6f6e 0a6d 616e 7561 stribution.manua │ │ │ │ │ -00009b90: 6c20 666f 7220 6d6f 7265 2064 6574 6169 l for more detai │ │ │ │ │ -00009ba0: 6c73 2e20 204f 7468 6572 206c 6f61 6465 ls. Other loade │ │ │ │ │ -00009bb0: 7273 206c 696b 6520 6170 706c 656c 6f61 rs like appleloa │ │ │ │ │ -00009bc0: 6465 722c 2063 6861 696e 6c6f 6164 6572 der, chainloader │ │ │ │ │ -00009bd0: 0a28 4249 4f53 2c20 4546 492c 2063 6f72 .(BIOS, EFI, cor │ │ │ │ │ -00009be0: 6562 6f6f 7429 2c20 6672 6565 646f 732c eboot), freedos, │ │ │ │ │ -00009bf0: 206e 746c 6472 2061 6e64 2070 6c61 6e39 ntldr and plan9 │ │ │ │ │ -00009c00: 2070 726f 7669 6465 206e 6f20 706f 7373 provide no poss │ │ │ │ │ -00009c10: 6962 696c 6974 790a 6f66 206c 6f61 6469 ibility.of loadi │ │ │ │ │ -00009c20: 6e67 2069 6e69 7469 616c 2072 616d 6469 ng initial ramdi │ │ │ │ │ -00009c30: 736b 2061 6e64 2061 7320 6661 7220 6173 sk and as far as │ │ │ │ │ -00009c40: 2061 7574 686f 7220 6973 2061 7761 7265 author is aware │ │ │ │ │ -00009c50: 2074 6865 2070 6179 6c6f 6164 7320 696e the payloads in │ │ │ │ │ -00009c60: 0a71 7565 7374 696f 6e20 646f 6e27 7420 .question don't │ │ │ │ │ -00009c70: 7375 7070 6f72 7420 6569 7468 6572 2069 support either i │ │ │ │ │ -00009c80: 6e69 7469 616c 2072 616d 6469 736b 206f nitial ramdisk o │ │ │ │ │ -00009c90: 7220 6469 7363 6f76 6572 696e 6720 6c6f r discovering lo │ │ │ │ │ -00009ca0: 6f70 6261 636b 0a62 6f6f 7420 696e 206f opback.boot in o │ │ │ │ │ -00009cb0: 7468 6572 2077 6179 2061 6e64 2061 7320 ther way and as │ │ │ │ │ -00009cc0: 7375 6368 206e 6f74 2062 6f6f 7461 626c such not bootabl │ │ │ │ │ -00009cd0: 6520 7468 6973 2077 6179 2e20 2050 6c65 e this way. Ple │ │ │ │ │ -00009ce0: 6173 6520 636f 6e73 6964 6572 0a61 6c74 ase consider.alt │ │ │ │ │ -00009cf0: 6572 6e61 7469 7665 2062 6f6f 7420 6d65 ernative boot me │ │ │ │ │ -00009d00: 7468 6f64 7320 6c69 6b65 2063 6f70 7969 thods like copyi │ │ │ │ │ -00009d10: 6e67 2061 6c6c 2066 696c 6573 2066 726f ng all files fro │ │ │ │ │ -00009d20: 6d20 7468 6520 696d 6167 6520 746f 2061 m the image to a │ │ │ │ │ -00009d30: 6374 7561 6c0a 7061 7274 6974 696f 6e2e ctual.partition. │ │ │ │ │ -00009d40: 2020 436f 6e73 756c 7420 796f 7572 204f Consult your O │ │ │ │ │ -00009d50: 5320 646f 6375 6d65 6e74 6174 696f 6e20 S documentation │ │ │ │ │ -00009d60: 666f 7220 6d6f 7265 2064 6574 6169 6c73 for more details │ │ │ │ │ -00009d70: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ -00009d80: 6e66 6f2c 2020 4e6f 6465 3a20 4c56 4d20 nfo, Node: LVM │ │ │ │ │ -00009d90: 6361 6368 6520 626f 6f74 696e 672c 2020 cache booting, │ │ │ │ │ -00009da0: 4e65 7874 3a20 4f53 2d73 7065 6369 6669 Next: OS-specifi │ │ │ │ │ -00009db0: 6320 6e6f 7465 732c 2020 5072 6576 3a20 c notes, Prev: │ │ │ │ │ -00009dc0: 4c6f 6f70 6261 636b 2062 6f6f 7469 6e67 Loopback booting │ │ │ │ │ -00009dd0: 2c20 2055 703a 2042 6f6f 7469 6e67 0a0a , Up: Booting.. │ │ │ │ │ -00009de0: 352e 3320 426f 6f74 696e 6720 6672 6f6d 5.3 Booting from │ │ │ │ │ -00009df0: 204c 564d 2063 6163 6865 206c 6f67 6963 LVM cache logic │ │ │ │ │ -00009e00: 616c 2076 6f6c 756d 650a 3d3d 3d3d 3d3d al volume.====== │ │ │ │ │ +00009780: 0a0a 4752 5542 2069 7320 6162 6c65 2074 ..GRUB is able t │ │ │ │ │ +00009790: 6f20 7265 6164 2066 726f 6d20 616e 2069 o read from an i │ │ │ │ │ +000097a0: 6d61 6765 2028 6265 2069 7420 6f6e 6520 mage (be it one │ │ │ │ │ +000097b0: 6f66 2043 4420 6f72 2048 4444 2920 7374 of CD or HDD) st │ │ │ │ │ +000097c0: 6f72 6564 206f 6e0a 616e 7920 6f66 2069 ored on.any of i │ │ │ │ │ +000097d0: 7473 2061 6363 6573 7369 626c 6520 7374 ts accessible st │ │ │ │ │ +000097e0: 6f72 6167 6573 2028 7265 6665 7220 746f orages (refer to │ │ │ │ │ +000097f0: 202a 6e6f 7465 206c 6f6f 7062 6163 6b3a *note loopback: │ │ │ │ │ +00009800: 3a20 636f 6d6d 616e 6429 2e0a 486f 7765 : command)..Howe │ │ │ │ │ +00009810: 7665 7220 7468 6520 4f53 2069 7473 656c ver the OS itsel │ │ │ │ │ +00009820: 6620 7368 6f75 6c64 2062 6520 6162 6c65 f should be able │ │ │ │ │ +00009830: 2074 6f20 6669 6e64 2069 7473 2072 6f6f to find its roo │ │ │ │ │ +00009840: 742e 2020 5468 6973 2075 7375 616c 6c79 t. This usually │ │ │ │ │ +00009850: 0a69 6e76 6f6c 7665 7320 7275 6e6e 696e .involves runnin │ │ │ │ │ +00009860: 6720 6120 7573 6572 7370 6163 6520 7072 g a userspace pr │ │ │ │ │ +00009870: 6f67 7261 6d20 7275 6e6e 696e 6720 6265 ogram running be │ │ │ │ │ +00009880: 666f 7265 2074 6865 2072 6561 6c20 726f fore the real ro │ │ │ │ │ +00009890: 6f74 2069 730a 6469 7363 6f76 6572 6564 ot is.discovered │ │ │ │ │ +000098a0: 2e20 2054 6869 7320 6973 2061 6368 6965 . This is achie │ │ │ │ │ +000098b0: 7665 6420 6279 2047 5255 4220 6c6f 6164 ved by GRUB load │ │ │ │ │ +000098c0: 696e 6720 6120 7370 6563 6961 6c6c 7920 ing a specially │ │ │ │ │ +000098d0: 6d61 6465 2073 6d61 6c6c 0a69 6d61 6765 made small.image │ │ │ │ │ +000098e0: 2061 6e64 2070 6173 7369 6e67 2069 7420 and passing it │ │ │ │ │ +000098f0: 6173 2072 616d 6469 736b 2074 6f20 7468 as ramdisk to th │ │ │ │ │ +00009900: 6520 6b65 726e 656c 2e20 2054 6869 7320 e kernel. This │ │ │ │ │ +00009910: 6973 2061 6368 6965 7665 6420 6279 0a63 is achieved by.c │ │ │ │ │ +00009920: 6f6d 6d61 6e64 7320 276b 6672 6565 6273 ommands 'kfreebs │ │ │ │ │ +00009930: 645f 6d6f 6475 6c65 272c 2027 6b6e 6574 d_module', 'knet │ │ │ │ │ +00009940: 6273 645f 6d6f 6475 6c65 5f65 6c66 272c bsd_module_elf', │ │ │ │ │ +00009950: 2027 6b6f 7065 6e62 7364 5f72 616d 6469 'kopenbsd_ramdi │ │ │ │ │ +00009960: 736b 272c 0a27 696e 6974 7264 2720 282a sk',.'initrd' (* │ │ │ │ │ +00009970: 6e6f 7465 2069 6e69 7472 643a 3a29 2c20 note initrd::), │ │ │ │ │ +00009980: 2769 6e69 7472 6431 3627 2028 2a6e 6f74 'initrd16' (*not │ │ │ │ │ +00009990: 6520 696e 6974 7264 3a3a 292c 0a27 6d75 e initrd::),.'mu │ │ │ │ │ +000099a0: 6c74 6962 6f6f 745f 6d6f 6475 6c65 272c ltiboot_module', │ │ │ │ │ +000099b0: 2027 6d75 6c74 6962 6f6f 7432 5f6d 6f64 'multiboot2_mod │ │ │ │ │ +000099c0: 756c 6527 206f 7220 2778 6e75 5f72 616d ule' or 'xnu_ram │ │ │ │ │ +000099d0: 6469 736b 2720 6465 7065 6e64 696e 6720 disk' depending │ │ │ │ │ +000099e0: 6f6e 0a74 6865 206c 6f61 6465 722e 2020 on.the loader. │ │ │ │ │ +000099f0: 4e6f 7465 2074 6861 7420 666f 7220 6b6e Note that for kn │ │ │ │ │ +00009a00: 6574 6273 6420 7468 6520 696d 6167 6520 etbsd the image │ │ │ │ │ +00009a10: 6d75 7374 2062 6520 7075 7420 696e 7369 must be put insi │ │ │ │ │ +00009a20: 6465 0a6d 696e 6972 6f6f 742e 6b6d 6f64 de.miniroot.kmod │ │ │ │ │ +00009a30: 2061 6e64 2074 6865 2077 686f 6c65 206d and the whole m │ │ │ │ │ +00009a40: 696e 6972 6f6f 742e 6b6d 6f64 2068 6173 iniroot.kmod has │ │ │ │ │ +00009a50: 2074 6f20 6265 206c 6f61 6465 642e 2020 to be loaded. │ │ │ │ │ +00009a60: 496e 206b 6f70 656e 6273 640a 7061 796c In kopenbsd.payl │ │ │ │ │ +00009a70: 6f61 6420 7468 6973 2069 7320 6469 7361 oad this is disa │ │ │ │ │ +00009a80: 626c 6564 2062 7920 6465 6661 756c 742e bled by default. │ │ │ │ │ +00009a90: 2020 4164 6974 696f 6e61 6c6c 7920 6265 Aditionally be │ │ │ │ │ +00009aa0: 6861 7669 6f75 7220 6f66 2069 6e69 7469 haviour of initi │ │ │ │ │ +00009ab0: 616c 0a72 616d 6469 736b 2064 6570 656e al.ramdisk depen │ │ │ │ │ +00009ac0: 6473 206f 6e20 636f 6d6d 616e 6420 6c69 ds on command li │ │ │ │ │ +00009ad0: 6e65 206f 7074 696f 6e73 2e20 2053 6576 ne options. Sev │ │ │ │ │ +00009ae0: 6572 616c 2064 6973 7472 6962 7574 6f72 eral distributor │ │ │ │ │ +00009af0: 7320 7072 6f76 6964 650a 7468 6520 696d s provide.the im │ │ │ │ │ +00009b00: 6167 6520 666f 7220 7468 6973 2070 7572 age for this pur │ │ │ │ │ +00009b10: 706f 7365 206f 7220 6974 2773 2069 6e74 pose or it's int │ │ │ │ │ +00009b20: 6567 7261 7465 6420 696e 2074 6865 6972 egrated in their │ │ │ │ │ +00009b30: 2073 7461 6e64 6172 6420 7261 6d64 6973 standard ramdis │ │ │ │ │ +00009b40: 6b0a 616e 6420 6163 7469 7661 7465 6420 k.and activated │ │ │ │ │ +00009b50: 6279 2073 7065 6369 616c 206f 7074 696f by special optio │ │ │ │ │ +00009b60: 6e2e 2020 436f 6e73 756c 7420 796f 7572 n. Consult your │ │ │ │ │ +00009b70: 206b 6572 6e65 6c20 616e 6420 6469 7374 kernel and dist │ │ │ │ │ +00009b80: 7269 6275 7469 6f6e 0a6d 616e 7561 6c20 ribution.manual │ │ │ │ │ +00009b90: 666f 7220 6d6f 7265 2064 6574 6169 6c73 for more details │ │ │ │ │ +00009ba0: 2e20 204f 7468 6572 206c 6f61 6465 7273 . Other loaders │ │ │ │ │ +00009bb0: 206c 696b 6520 6170 706c 656c 6f61 6465 like appleloade │ │ │ │ │ +00009bc0: 722c 2063 6861 696e 6c6f 6164 6572 0a28 r, chainloader.( │ │ │ │ │ +00009bd0: 4249 4f53 2c20 4546 492c 2063 6f72 6562 BIOS, EFI, coreb │ │ │ │ │ +00009be0: 6f6f 7429 2c20 6672 6565 646f 732c 206e oot), freedos, n │ │ │ │ │ +00009bf0: 746c 6472 2061 6e64 2070 6c61 6e39 2070 tldr and plan9 p │ │ │ │ │ +00009c00: 726f 7669 6465 206e 6f20 706f 7373 6962 rovide no possib │ │ │ │ │ +00009c10: 696c 6974 790a 6f66 206c 6f61 6469 6e67 ility.of loading │ │ │ │ │ +00009c20: 2069 6e69 7469 616c 2072 616d 6469 736b initial ramdisk │ │ │ │ │ +00009c30: 2061 6e64 2061 7320 6661 7220 6173 2061 and as far as a │ │ │ │ │ +00009c40: 7574 686f 7220 6973 2061 7761 7265 2074 uthor is aware t │ │ │ │ │ +00009c50: 6865 2070 6179 6c6f 6164 7320 696e 0a71 he payloads in.q │ │ │ │ │ +00009c60: 7565 7374 696f 6e20 646f 6e27 7420 7375 uestion don't su │ │ │ │ │ +00009c70: 7070 6f72 7420 6569 7468 6572 2069 6e69 pport either ini │ │ │ │ │ +00009c80: 7469 616c 2072 616d 6469 736b 206f 7220 tial ramdisk or │ │ │ │ │ +00009c90: 6469 7363 6f76 6572 696e 6720 6c6f 6f70 discovering loop │ │ │ │ │ +00009ca0: 6261 636b 0a62 6f6f 7420 696e 206f 7468 back.boot in oth │ │ │ │ │ +00009cb0: 6572 2077 6179 2061 6e64 2061 7320 7375 er way and as su │ │ │ │ │ +00009cc0: 6368 206e 6f74 2062 6f6f 7461 626c 6520 ch not bootable │ │ │ │ │ +00009cd0: 7468 6973 2077 6179 2e20 2050 6c65 6173 this way. Pleas │ │ │ │ │ +00009ce0: 6520 636f 6e73 6964 6572 0a61 6c74 6572 e consider.alter │ │ │ │ │ +00009cf0: 6e61 7469 7665 2062 6f6f 7420 6d65 7468 native boot meth │ │ │ │ │ +00009d00: 6f64 7320 6c69 6b65 2063 6f70 7969 6e67 ods like copying │ │ │ │ │ +00009d10: 2061 6c6c 2066 696c 6573 2066 726f 6d20 all files from │ │ │ │ │ +00009d20: 7468 6520 696d 6167 6520 746f 2061 6374 the image to act │ │ │ │ │ +00009d30: 7561 6c0a 7061 7274 6974 696f 6e2e 2020 ual.partition. │ │ │ │ │ +00009d40: 436f 6e73 756c 7420 796f 7572 204f 5320 Consult your OS │ │ │ │ │ +00009d50: 646f 6375 6d65 6e74 6174 696f 6e20 666f documentation fo │ │ │ │ │ +00009d60: 7220 6d6f 7265 2064 6574 6169 6c73 0a0a r more details.. │ │ │ │ │ +00009d70: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ +00009d80: 6f2c 2020 4e6f 6465 3a20 4c56 4d20 6361 o, Node: LVM ca │ │ │ │ │ +00009d90: 6368 6520 626f 6f74 696e 672c 2020 4e65 che booting, Ne │ │ │ │ │ +00009da0: 7874 3a20 4f53 2d73 7065 6369 6669 6320 xt: OS-specific │ │ │ │ │ +00009db0: 6e6f 7465 732c 2020 5072 6576 3a20 4c6f notes, Prev: Lo │ │ │ │ │ +00009dc0: 6f70 6261 636b 2062 6f6f 7469 6e67 2c20 opback booting, │ │ │ │ │ +00009dd0: 2055 703a 2042 6f6f 7469 6e67 0a0a 352e Up: Booting..5. │ │ │ │ │ +00009de0: 3320 426f 6f74 696e 6720 6672 6f6d 204c 3 Booting from L │ │ │ │ │ +00009df0: 564d 2063 6163 6865 206c 6f67 6963 616c VM cache logical │ │ │ │ │ +00009e00: 2076 6f6c 756d 650a 3d3d 3d3d 3d3d 3d3d volume.======== │ │ │ │ │ 00009e10: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 00009e20: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00009e30: 3d3d 3d0a 0a54 6865 204c 564d 2063 6163 ===..The LVM cac │ │ │ │ │ -00009e40: 6865 206c 6f67 6963 616c 2076 6f6c 756d he logical volum │ │ │ │ │ -00009e50: 6520 6973 2074 6865 206c 6f67 6963 616c e is the logical │ │ │ │ │ -00009e60: 2076 6f6c 756d 6520 636f 6e73 6973 7469 volume consisti │ │ │ │ │ -00009e70: 6e67 206f 6620 7468 650a 6f72 6967 696e ng of the.origin │ │ │ │ │ -00009e80: 616c 2061 6e64 2074 6865 2063 6163 6865 al and the cache │ │ │ │ │ -00009e90: 2070 6f6f 6c20 6c6f 6769 6361 6c20 766f pool logical vo │ │ │ │ │ -00009ea0: 6c75 6d65 2e20 2054 6865 206f 7269 6769 lume. The origi │ │ │ │ │ -00009eb0: 6e61 6c20 6973 2075 7375 616c 6c79 206f nal is usually o │ │ │ │ │ -00009ec0: 6e0a 6120 6c61 7267 6572 2061 6e64 2073 n.a larger and s │ │ │ │ │ -00009ed0: 6c6f 7765 7220 7374 6f72 6167 6520 6465 lower storage de │ │ │ │ │ -00009ee0: 7669 6365 2077 6869 6c65 2074 6865 2063 vice while the c │ │ │ │ │ -00009ef0: 6163 6865 2070 6f6f 6c20 6973 206f 6e20 ache pool is on │ │ │ │ │ -00009f00: 6120 736d 616c 6c65 720a 616e 6420 6661 a smaller.and fa │ │ │ │ │ -00009f10: 7374 6572 206f 6e65 2e20 2054 6865 2070 ster one. The p │ │ │ │ │ -00009f20: 6572 666f 726d 616e 6365 206f 6620 7468 erformance of th │ │ │ │ │ -00009f30: 6520 6f72 6967 696e 616c 2076 6f6c 756d e original volum │ │ │ │ │ -00009f40: 6520 6361 6e20 6265 2069 6d70 726f 7665 e can be improve │ │ │ │ │ -00009f50: 640a 6279 2073 746f 7269 6e67 2074 6865 d.by storing the │ │ │ │ │ -00009f60: 2066 7265 7175 656e 746c 7920 7573 6564 frequently used │ │ │ │ │ -00009f70: 2064 6174 6120 6f6e 2074 6865 2063 6163 data on the cac │ │ │ │ │ -00009f80: 6865 2070 6f6f 6c20 746f 2075 7469 6c69 he pool to utili │ │ │ │ │ -00009f90: 7a65 2074 6865 0a67 7265 6174 6572 2070 ze the.greater p │ │ │ │ │ -00009fa0: 6572 666f 726d 616e 6365 206f 6620 6661 erformance of fa │ │ │ │ │ -00009fb0: 7374 6572 2064 6576 6963 652e 0a0a 2020 ster device... │ │ │ │ │ -00009fc0: 2047 5255 4220 626f 6f74 7320 6672 6f6d GRUB boots from │ │ │ │ │ -00009fd0: 204c 564d 2063 6163 6865 206c 6f67 6963 LVM cache logic │ │ │ │ │ -00009fe0: 616c 2076 6f6c 756d 6520 6d65 7265 6c79 al volume merely │ │ │ │ │ -00009ff0: 2062 7920 7265 6164 696e 6720 6974 2773 by reading it's │ │ │ │ │ -0000a000: 0a6f 7269 6769 6e61 6c20 6c6f 6769 6361 .original logica │ │ │ │ │ -0000a010: 6c20 766f 6c75 6d65 2073 6f20 7468 6174 l volume so that │ │ │ │ │ -0000a020: 2064 6972 7479 2064 6174 6120 696e 2063 dirty data in c │ │ │ │ │ -0000a030: 6163 6865 2070 6f6f 6c20 766f 6c75 6d65 ache pool volume │ │ │ │ │ -0000a040: 2069 730a 6469 7372 6567 6172 6465 642e is.disregarded. │ │ │ │ │ -0000a050: 2020 5468 6973 2069 7320 6e6f 7420 6120 This is not a │ │ │ │ │ -0000a060: 7072 6f62 6c65 6d20 666f 7220 2277 7269 problem for "wri │ │ │ │ │ -0000a070: 7465 7468 726f 7567 6822 2063 6163 6865 tethrough" cache │ │ │ │ │ -0000a080: 206d 6f64 6520 6173 2069 740a 656e 7375 mode as it.ensu │ │ │ │ │ -0000a090: 7265 7320 7468 6174 2061 6e79 2064 6174 res that any dat │ │ │ │ │ -0000a0a0: 6120 7772 6974 7465 6e20 7769 6c6c 2062 a written will b │ │ │ │ │ -0000a0b0: 6520 7374 6f72 6564 2062 6f74 6820 6f6e e stored both on │ │ │ │ │ -0000a0c0: 2074 6865 2063 6163 6865 2061 6e64 2074 the cache and t │ │ │ │ │ -0000a0d0: 6865 0a6f 7269 6769 6e20 4c56 2e20 466f he.origin LV. Fo │ │ │ │ │ -0000a0e0: 7220 7468 6520 6f74 6865 7220 6361 6368 r the other cach │ │ │ │ │ -0000a0f0: 6520 6d6f 6465 2022 7772 6974 6562 6163 e mode "writebac │ │ │ │ │ -0000a100: 6b22 2c20 7768 6963 6820 6465 6c61 7973 k", which delays │ │ │ │ │ -0000a110: 2077 7269 7469 6e67 0a66 726f 6d20 7468 writing.from th │ │ │ │ │ -0000a120: 6520 6361 6368 6520 706f 6f6c 2062 6163 e cache pool bac │ │ │ │ │ -0000a130: 6b20 746f 2074 6865 206f 7269 6769 6e20 k to the origin │ │ │ │ │ -0000a140: 4c56 2074 6f20 626f 6f73 7420 7065 7266 LV to boost perf │ │ │ │ │ -0000a150: 6f72 6d61 6e63 652c 2047 5255 4220 6d61 ormance, GRUB ma │ │ │ │ │ -0000a160: 790a 6661 696c 2074 6f20 626f 6f74 2069 y.fail to boot i │ │ │ │ │ -0000a170: 6e20 7468 6520 7761 6b65 206f 6620 6163 n the wake of ac │ │ │ │ │ -0000a180: 6369 6465 6e74 616c 2070 6f77 6572 206f cidental power o │ │ │ │ │ -0000a190: 7574 6167 6520 6475 6520 746f 2069 7427 utage due to it' │ │ │ │ │ -0000a1a0: 730a 696e 6162 696c 6974 7920 746f 2061 s.inability to a │ │ │ │ │ -0000a1b0: 7373 656d 626c 6520 7468 6520 6361 6368 ssemble the cach │ │ │ │ │ -0000a1c0: 6520 6465 7669 6365 2066 6f72 2072 6561 e device for rea │ │ │ │ │ -0000a1d0: 6469 6e67 2074 6865 2072 6571 7569 7265 ding the require │ │ │ │ │ -0000a1e0: 6420 6469 7274 790a 6461 7461 206c 6566 d dirty.data lef │ │ │ │ │ -0000a1f0: 7420 6265 6869 6e64 2e20 2054 6865 2073 t behind. The s │ │ │ │ │ -0000a200: 6974 7561 7469 6f6e 2077 696c 6c20 6265 ituation will be │ │ │ │ │ -0000a210: 2069 6d70 726f 7665 6420 6166 7465 7220 improved after │ │ │ │ │ -0000a220: 6164 6469 6e67 2066 756c 6c0a 7375 7070 adding full.supp │ │ │ │ │ -0000a230: 6f72 7420 746f 2074 6865 204c 564d 2063 ort to the LVM c │ │ │ │ │ -0000a240: 6163 6865 206c 6f67 6963 616c 2076 6f6c ache logical vol │ │ │ │ │ -0000a250: 756d 6520 696e 2074 6865 2066 7574 7572 ume in the futur │ │ │ │ │ -0000a260: 652e 0a0a 1f0a 4669 6c65 3a20 6772 7562 e.....File: grub │ │ │ │ │ -0000a270: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 4f53 .info, Node: OS │ │ │ │ │ -0000a280: 2d73 7065 6369 6669 6320 6e6f 7465 732c -specific notes, │ │ │ │ │ -0000a290: 2020 5072 6576 3a20 4c56 4d20 6361 6368 Prev: LVM cach │ │ │ │ │ -0000a2a0: 6520 626f 6f74 696e 672c 2020 5570 3a20 e booting, Up: │ │ │ │ │ -0000a2b0: 426f 6f74 696e 670a 0a35 2e34 2053 6f6d Booting..5.4 Som │ │ │ │ │ -0000a2c0: 6520 6361 7665 6174 7320 6f6e 204f 532d e caveats on OS- │ │ │ │ │ -0000a2d0: 7370 6563 6966 6963 2069 7373 7565 730a specific issues. │ │ │ │ │ +00009e30: 3d0a 0a54 6865 204c 564d 2063 6163 6865 =..The LVM cache │ │ │ │ │ +00009e40: 206c 6f67 6963 616c 2076 6f6c 756d 6520 logical volume │ │ │ │ │ +00009e50: 6973 2074 6865 206c 6f67 6963 616c 2076 is the logical v │ │ │ │ │ +00009e60: 6f6c 756d 6520 636f 6e73 6973 7469 6e67 olume consisting │ │ │ │ │ +00009e70: 206f 6620 7468 650a 6f72 6967 696e 616c of the.original │ │ │ │ │ +00009e80: 2061 6e64 2074 6865 2063 6163 6865 2070 and the cache p │ │ │ │ │ +00009e90: 6f6f 6c20 6c6f 6769 6361 6c20 766f 6c75 ool logical volu │ │ │ │ │ +00009ea0: 6d65 2e20 2054 6865 206f 7269 6769 6e61 me. The origina │ │ │ │ │ +00009eb0: 6c20 6973 2075 7375 616c 6c79 206f 6e0a l is usually on. │ │ │ │ │ +00009ec0: 6120 6c61 7267 6572 2061 6e64 2073 6c6f a larger and slo │ │ │ │ │ +00009ed0: 7765 7220 7374 6f72 6167 6520 6465 7669 wer storage devi │ │ │ │ │ +00009ee0: 6365 2077 6869 6c65 2074 6865 2063 6163 ce while the cac │ │ │ │ │ +00009ef0: 6865 2070 6f6f 6c20 6973 206f 6e20 6120 he pool is on a │ │ │ │ │ +00009f00: 736d 616c 6c65 720a 616e 6420 6661 7374 smaller.and fast │ │ │ │ │ +00009f10: 6572 206f 6e65 2e20 2054 6865 2070 6572 er one. The per │ │ │ │ │ +00009f20: 666f 726d 616e 6365 206f 6620 7468 6520 formance of the │ │ │ │ │ +00009f30: 6f72 6967 696e 616c 2076 6f6c 756d 6520 original volume │ │ │ │ │ +00009f40: 6361 6e20 6265 2069 6d70 726f 7665 640a can be improved. │ │ │ │ │ +00009f50: 6279 2073 746f 7269 6e67 2074 6865 2066 by storing the f │ │ │ │ │ +00009f60: 7265 7175 656e 746c 7920 7573 6564 2064 requently used d │ │ │ │ │ +00009f70: 6174 6120 6f6e 2074 6865 2063 6163 6865 ata on the cache │ │ │ │ │ +00009f80: 2070 6f6f 6c20 746f 2075 7469 6c69 7a65 pool to utilize │ │ │ │ │ +00009f90: 2074 6865 0a67 7265 6174 6572 2070 6572 the.greater per │ │ │ │ │ +00009fa0: 666f 726d 616e 6365 206f 6620 6661 7374 formance of fast │ │ │ │ │ +00009fb0: 6572 2064 6576 6963 652e 0a0a 2020 2047 er device... G │ │ │ │ │ +00009fc0: 5255 4220 626f 6f74 7320 6672 6f6d 204c RUB boots from L │ │ │ │ │ +00009fd0: 564d 2063 6163 6865 206c 6f67 6963 616c VM cache logical │ │ │ │ │ +00009fe0: 2076 6f6c 756d 6520 6d65 7265 6c79 2062 volume merely b │ │ │ │ │ +00009ff0: 7920 7265 6164 696e 6720 6974 2773 0a6f y reading it's.o │ │ │ │ │ +0000a000: 7269 6769 6e61 6c20 6c6f 6769 6361 6c20 riginal logical │ │ │ │ │ +0000a010: 766f 6c75 6d65 2073 6f20 7468 6174 2064 volume so that d │ │ │ │ │ +0000a020: 6972 7479 2064 6174 6120 696e 2063 6163 irty data in cac │ │ │ │ │ +0000a030: 6865 2070 6f6f 6c20 766f 6c75 6d65 2069 he pool volume i │ │ │ │ │ +0000a040: 730a 6469 7372 6567 6172 6465 642e 2020 s.disregarded. │ │ │ │ │ +0000a050: 5468 6973 2069 7320 6e6f 7420 6120 7072 This is not a pr │ │ │ │ │ +0000a060: 6f62 6c65 6d20 666f 7220 2277 7269 7465 oblem for "write │ │ │ │ │ +0000a070: 7468 726f 7567 6822 2063 6163 6865 206d through" cache m │ │ │ │ │ +0000a080: 6f64 6520 6173 2069 740a 656e 7375 7265 ode as it.ensure │ │ │ │ │ +0000a090: 7320 7468 6174 2061 6e79 2064 6174 6120 s that any data │ │ │ │ │ +0000a0a0: 7772 6974 7465 6e20 7769 6c6c 2062 6520 written will be │ │ │ │ │ +0000a0b0: 7374 6f72 6564 2062 6f74 6820 6f6e 2074 stored both on t │ │ │ │ │ +0000a0c0: 6865 2063 6163 6865 2061 6e64 2074 6865 he cache and the │ │ │ │ │ +0000a0d0: 0a6f 7269 6769 6e20 4c56 2e20 466f 7220 .origin LV. For │ │ │ │ │ +0000a0e0: 7468 6520 6f74 6865 7220 6361 6368 6520 the other cache │ │ │ │ │ +0000a0f0: 6d6f 6465 2022 7772 6974 6562 6163 6b22 mode "writeback" │ │ │ │ │ +0000a100: 2c20 7768 6963 6820 6465 6c61 7973 2077 , which delays w │ │ │ │ │ +0000a110: 7269 7469 6e67 0a66 726f 6d20 7468 6520 riting.from the │ │ │ │ │ +0000a120: 6361 6368 6520 706f 6f6c 2062 6163 6b20 cache pool back │ │ │ │ │ +0000a130: 746f 2074 6865 206f 7269 6769 6e20 4c56 to the origin LV │ │ │ │ │ +0000a140: 2074 6f20 626f 6f73 7420 7065 7266 6f72 to boost perfor │ │ │ │ │ +0000a150: 6d61 6e63 652c 2047 5255 4220 6d61 790a mance, GRUB may. │ │ │ │ │ +0000a160: 6661 696c 2074 6f20 626f 6f74 2069 6e20 fail to boot in │ │ │ │ │ +0000a170: 7468 6520 7761 6b65 206f 6620 6163 6369 the wake of acci │ │ │ │ │ +0000a180: 6465 6e74 616c 2070 6f77 6572 206f 7574 dental power out │ │ │ │ │ +0000a190: 6167 6520 6475 6520 746f 2069 7427 730a age due to it's. │ │ │ │ │ +0000a1a0: 696e 6162 696c 6974 7920 746f 2061 7373 inability to ass │ │ │ │ │ +0000a1b0: 656d 626c 6520 7468 6520 6361 6368 6520 emble the cache │ │ │ │ │ +0000a1c0: 6465 7669 6365 2066 6f72 2072 6561 6469 device for readi │ │ │ │ │ +0000a1d0: 6e67 2074 6865 2072 6571 7569 7265 6420 ng the required │ │ │ │ │ +0000a1e0: 6469 7274 790a 6461 7461 206c 6566 7420 dirty.data left │ │ │ │ │ +0000a1f0: 6265 6869 6e64 2e20 2054 6865 2073 6974 behind. The sit │ │ │ │ │ +0000a200: 7561 7469 6f6e 2077 696c 6c20 6265 2069 uation will be i │ │ │ │ │ +0000a210: 6d70 726f 7665 6420 6166 7465 7220 6164 mproved after ad │ │ │ │ │ +0000a220: 6469 6e67 2066 756c 6c0a 7375 7070 6f72 ding full.suppor │ │ │ │ │ +0000a230: 7420 746f 2074 6865 204c 564d 2063 6163 t to the LVM cac │ │ │ │ │ +0000a240: 6865 206c 6f67 6963 616c 2076 6f6c 756d he logical volum │ │ │ │ │ +0000a250: 6520 696e 2074 6865 2066 7574 7572 652e e in the future. │ │ │ │ │ +0000a260: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ +0000a270: 6e66 6f2c 2020 4e6f 6465 3a20 4f53 2d73 nfo, Node: OS-s │ │ │ │ │ +0000a280: 7065 6369 6669 6320 6e6f 7465 732c 2020 pecific notes, │ │ │ │ │ +0000a290: 5072 6576 3a20 4c56 4d20 6361 6368 6520 Prev: LVM cache │ │ │ │ │ +0000a2a0: 626f 6f74 696e 672c 2020 5570 3a20 426f booting, Up: Bo │ │ │ │ │ +0000a2b0: 6f74 696e 670a 0a35 2e34 2053 6f6d 6520 oting..5.4 Some │ │ │ │ │ +0000a2c0: 6361 7665 6174 7320 6f6e 204f 532d 7370 caveats on OS-sp │ │ │ │ │ +0000a2d0: 6563 6966 6963 2069 7373 7565 730a 3d3d ecific issues.== │ │ │ │ │ 0000a2e0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 0000a2f0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0000a300: 3d3d 3d3d 3d3d 0a0a 4865 7265 2c20 7765 ======..Here, we │ │ │ │ │ -0000a310: 2064 6573 6372 6962 6520 736f 6d65 2063 describe some c │ │ │ │ │ -0000a320: 6176 6561 7473 206f 6e20 7365 7665 7261 aveats on severa │ │ │ │ │ -0000a330: 6c20 6f70 6572 6174 696e 6720 7379 7374 l operating syst │ │ │ │ │ -0000a340: 656d 732e 0a0a 2a20 4d65 6e75 3a0a 0a2a ems...* Menu:..* │ │ │ │ │ -0000a350: 2047 4e55 2f48 7572 643a 3a0a 2a20 474e GNU/Hurd::.* GN │ │ │ │ │ -0000a360: 552f 4c69 6e75 783a 3a0a 2a20 4e65 7442 U/Linux::.* NetB │ │ │ │ │ -0000a370: 5344 3a3a 0a2a 2044 4f53 2f57 696e 646f SD::.* DOS/Windo │ │ │ │ │ -0000a380: 7773 3a3a 0a0a 1f0a 4669 6c65 3a20 6772 ws::....File: gr │ │ │ │ │ -0000a390: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ -0000a3a0: 474e 552f 4875 7264 2c20 204e 6578 743a GNU/Hurd, Next: │ │ │ │ │ -0000a3b0: 2047 4e55 2f4c 696e 7578 2c20 2055 703a GNU/Linux, Up: │ │ │ │ │ -0000a3c0: 204f 532d 7370 6563 6966 6963 206e 6f74 OS-specific not │ │ │ │ │ -0000a3d0: 6573 0a0a 352e 342e 3120 474e 552f 4875 es..5.4.1 GNU/Hu │ │ │ │ │ -0000a3e0: 7264 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d rd.------------- │ │ │ │ │ -0000a3f0: 2d0a 0a53 696e 6365 2047 4e55 2f48 7572 -..Since GNU/Hur │ │ │ │ │ -0000a400: 6420 6973 204d 756c 7469 626f 6f74 2d63 d is Multiboot-c │ │ │ │ │ -0000a410: 6f6d 706c 6961 6e74 2c20 6974 2069 7320 ompliant, it is │ │ │ │ │ -0000a420: 6561 7379 2074 6f20 626f 6f74 2069 743b easy to boot it; │ │ │ │ │ -0000a430: 2074 6865 7265 2069 730a 6e6f 7468 696e there is.nothin │ │ │ │ │ -0000a440: 6720 7370 6563 6961 6c20 6162 6f75 7420 g special about │ │ │ │ │ -0000a450: 6974 2e20 2042 7574 2064 6f20 6e6f 7420 it. But do not │ │ │ │ │ -0000a460: 666f 7267 6574 2074 6861 7420 796f 7520 forget that you │ │ │ │ │ -0000a470: 6861 7665 2074 6f20 7370 6563 6966 7920 have to specify │ │ │ │ │ -0000a480: 610a 726f 6f74 2070 6172 7469 7469 6f6e a.root partition │ │ │ │ │ -0000a490: 2074 6f20 7468 6520 6b65 726e 656c 2e0a to the kernel.. │ │ │ │ │ -0000a4a0: 0a20 2031 2e20 5365 7420 4752 5542 2773 . 1. Set GRUB's │ │ │ │ │ -0000a4b0: 2072 6f6f 7420 6465 7669 6365 2074 6f20 root device to │ │ │ │ │ -0000a4c0: 7468 6520 7361 6d65 2064 7269 7665 2061 the same drive a │ │ │ │ │ -0000a4d0: 7320 474e 552f 4875 7264 2773 2e20 2054 s GNU/Hurd's. T │ │ │ │ │ -0000a4e0: 6865 0a20 2020 2020 636f 6d6d 616e 6420 he. command │ │ │ │ │ -0000a4f0: 2773 6561 7263 6820 2d2d 7365 743d 726f 'search --set=ro │ │ │ │ │ -0000a500: 6f74 202d 2d66 696c 6520 2f62 6f6f 742f ot --file /boot/ │ │ │ │ │ -0000a510: 676e 756d 6163 682e 677a 2720 6f72 2073 gnumach.gz' or s │ │ │ │ │ -0000a520: 696d 696c 6172 206d 6179 0a20 2020 2020 imilar may. │ │ │ │ │ -0000a530: 6865 6c70 2079 6f75 2028 2a6e 6f74 6520 help you (*note │ │ │ │ │ -0000a540: 7365 6172 6368 3a3a 292e 0a0a 2020 322e search::)... 2. │ │ │ │ │ -0000a550: 204c 6f61 6420 7468 6520 6b65 726e 656c Load the kernel │ │ │ │ │ -0000a560: 2061 6e64 2074 6865 206d 6f64 756c 6573 and the modules │ │ │ │ │ -0000a570: 2c20 6c69 6b65 2074 6869 733a 0a0a 2020 , like this:.. │ │ │ │ │ -0000a580: 2020 2020 2020 2020 6772 7562 3e20 6d75 grub> mu │ │ │ │ │ -0000a590: 6c74 6962 6f6f 7420 2f62 6f6f 742f 676e ltiboot /boot/gn │ │ │ │ │ -0000a5a0: 756d 6163 682e 677a 2072 6f6f 743d 6465 umach.gz root=de │ │ │ │ │ -0000a5b0: 7669 6365 3a68 6430 7331 0a20 2020 2020 vice:hd0s1. │ │ │ │ │ -0000a5c0: 2020 2020 2067 7275 623e 206d 6f64 756c grub> modul │ │ │ │ │ -0000a5d0: 6520 202f 6875 7264 2f65 7874 3266 732e e /hurd/ext2fs. │ │ │ │ │ -0000a5e0: 7374 6174 6963 2065 7874 3266 7320 2d2d static ext2fs -- │ │ │ │ │ -0000a5f0: 7265 6164 6f6e 6c79 205c 0a20 2020 2020 readonly \. │ │ │ │ │ +0000a300: 3d3d 3d3d 0a0a 4865 7265 2c20 7765 2064 ====..Here, we d │ │ │ │ │ +0000a310: 6573 6372 6962 6520 736f 6d65 2063 6176 escribe some cav │ │ │ │ │ +0000a320: 6561 7473 206f 6e20 7365 7665 7261 6c20 eats on several │ │ │ │ │ +0000a330: 6f70 6572 6174 696e 6720 7379 7374 656d operating system │ │ │ │ │ +0000a340: 732e 0a0a 2a20 4d65 6e75 3a0a 0a2a 2047 s...* Menu:..* G │ │ │ │ │ +0000a350: 4e55 2f48 7572 643a 3a0a 2a20 474e 552f NU/Hurd::.* GNU/ │ │ │ │ │ +0000a360: 4c69 6e75 783a 3a0a 2a20 4e65 7442 5344 Linux::.* NetBSD │ │ │ │ │ +0000a370: 3a3a 0a2a 2044 4f53 2f57 696e 646f 7773 ::.* DOS/Windows │ │ │ │ │ +0000a380: 3a3a 0a0a 1f0a 4669 6c65 3a20 6772 7562 ::....File: grub │ │ │ │ │ +0000a390: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 474e .info, Node: GN │ │ │ │ │ +0000a3a0: 552f 4875 7264 2c20 204e 6578 743a 2047 U/Hurd, Next: G │ │ │ │ │ +0000a3b0: 4e55 2f4c 696e 7578 2c20 2055 703a 204f NU/Linux, Up: O │ │ │ │ │ +0000a3c0: 532d 7370 6563 6966 6963 206e 6f74 6573 S-specific notes │ │ │ │ │ +0000a3d0: 0a0a 352e 342e 3120 474e 552f 4875 7264 ..5.4.1 GNU/Hurd │ │ │ │ │ +0000a3e0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a .--------------. │ │ │ │ │ +0000a3f0: 0a53 696e 6365 2047 4e55 2f48 7572 6420 .Since GNU/Hurd │ │ │ │ │ +0000a400: 6973 204d 756c 7469 626f 6f74 2d63 6f6d is Multiboot-com │ │ │ │ │ +0000a410: 706c 6961 6e74 2c20 6974 2069 7320 6561 pliant, it is ea │ │ │ │ │ +0000a420: 7379 2074 6f20 626f 6f74 2069 743b 2074 sy to boot it; t │ │ │ │ │ +0000a430: 6865 7265 2069 730a 6e6f 7468 696e 6720 here is.nothing │ │ │ │ │ +0000a440: 7370 6563 6961 6c20 6162 6f75 7420 6974 special about it │ │ │ │ │ +0000a450: 2e20 2042 7574 2064 6f20 6e6f 7420 666f . But do not fo │ │ │ │ │ +0000a460: 7267 6574 2074 6861 7420 796f 7520 6861 rget that you ha │ │ │ │ │ +0000a470: 7665 2074 6f20 7370 6563 6966 7920 610a ve to specify a. │ │ │ │ │ +0000a480: 726f 6f74 2070 6172 7469 7469 6f6e 2074 root partition t │ │ │ │ │ +0000a490: 6f20 7468 6520 6b65 726e 656c 2e0a 0a20 o the kernel... │ │ │ │ │ +0000a4a0: 2031 2e20 5365 7420 4752 5542 2773 2072 1. Set GRUB's r │ │ │ │ │ +0000a4b0: 6f6f 7420 6465 7669 6365 2074 6f20 7468 oot device to th │ │ │ │ │ +0000a4c0: 6520 7361 6d65 2064 7269 7665 2061 7320 e same drive as │ │ │ │ │ +0000a4d0: 474e 552f 4875 7264 2773 2e20 2054 6865 GNU/Hurd's. The │ │ │ │ │ +0000a4e0: 0a20 2020 2020 636f 6d6d 616e 6420 2773 . command 's │ │ │ │ │ +0000a4f0: 6561 7263 6820 2d2d 7365 743d 726f 6f74 earch --set=root │ │ │ │ │ +0000a500: 202d 2d66 696c 6520 2f62 6f6f 742f 676e --file /boot/gn │ │ │ │ │ +0000a510: 756d 6163 682e 677a 2720 6f72 2073 696d umach.gz' or sim │ │ │ │ │ +0000a520: 696c 6172 206d 6179 0a20 2020 2020 6865 ilar may. he │ │ │ │ │ +0000a530: 6c70 2079 6f75 2028 2a6e 6f74 6520 7365 lp you (*note se │ │ │ │ │ +0000a540: 6172 6368 3a3a 292e 0a0a 2020 322e 204c arch::)... 2. L │ │ │ │ │ +0000a550: 6f61 6420 7468 6520 6b65 726e 656c 2061 oad the kernel a │ │ │ │ │ +0000a560: 6e64 2074 6865 206d 6f64 756c 6573 2c20 nd the modules, │ │ │ │ │ +0000a570: 6c69 6b65 2074 6869 733a 0a0a 2020 2020 like this:.. │ │ │ │ │ +0000a580: 2020 2020 2020 6772 7562 3e20 6d75 6c74 grub> mult │ │ │ │ │ +0000a590: 6962 6f6f 7420 2f62 6f6f 742f 676e 756d iboot /boot/gnum │ │ │ │ │ +0000a5a0: 6163 682e 677a 2072 6f6f 743d 6465 7669 ach.gz root=devi │ │ │ │ │ +0000a5b0: 6365 3a68 6430 7331 0a20 2020 2020 2020 ce:hd0s1. │ │ │ │ │ +0000a5c0: 2020 2067 7275 623e 206d 6f64 756c 6520 grub> module │ │ │ │ │ +0000a5d0: 202f 6875 7264 2f65 7874 3266 732e 7374 /hurd/ext2fs.st │ │ │ │ │ +0000a5e0: 6174 6963 2065 7874 3266 7320 2d2d 7265 atic ext2fs --re │ │ │ │ │ +0000a5f0: 6164 6f6e 6c79 205c 0a20 2020 2020 2020 adonly \. │ │ │ │ │ 0000a600: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0000a610: 2020 2020 2020 2020 2d2d 6d75 6c74 6962 --multib │ │ │ │ │ -0000a620: 6f6f 742d 636f 6d6d 616e 642d 6c69 6e65 oot-command-line │ │ │ │ │ -0000a630: 3d27 247b 6b65 726e 656c 2d63 6f6d 6d61 ='${kernel-comma │ │ │ │ │ -0000a640: 6e64 2d6c 696e 657d 2720 5c0a 2020 2020 nd-line}' \. │ │ │ │ │ +0000a610: 2020 2020 2020 2d2d 6d75 6c74 6962 6f6f --multiboo │ │ │ │ │ +0000a620: 742d 636f 6d6d 616e 642d 6c69 6e65 3d27 t-command-line=' │ │ │ │ │ +0000a630: 247b 6b65 726e 656c 2d63 6f6d 6d61 6e64 ${kernel-command │ │ │ │ │ +0000a640: 2d6c 696e 657d 2720 5c0a 2020 2020 2020 -line}' \. │ │ │ │ │ 0000a650: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0000a660: 2020 2020 2020 2020 202d 2d68 6f73 742d --host- │ │ │ │ │ -0000a670: 7072 6976 2d70 6f72 743d 2724 7b68 6f73 priv-port='${hos │ │ │ │ │ -0000a680: 742d 706f 7274 7d27 205c 0a20 2020 2020 t-port}' \. │ │ │ │ │ +0000a660: 2020 2020 2020 202d 2d68 6f73 742d 7072 --host-pr │ │ │ │ │ +0000a670: 6976 2d70 6f72 743d 2724 7b68 6f73 742d iv-port='${host- │ │ │ │ │ +0000a680: 706f 7274 7d27 205c 0a20 2020 2020 2020 port}' \. │ │ │ │ │ 0000a690: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0000a6a0: 2020 2020 2020 2020 2d2d 6465 7669 6365 --device │ │ │ │ │ -0000a6b0: 2d6d 6173 7465 722d 706f 7274 3d27 247b -master-port='${ │ │ │ │ │ -0000a6c0: 6465 7669 6365 2d70 6f72 747d 2720 5c0a device-port}' \. │ │ │ │ │ +0000a6a0: 2020 2020 2020 2d2d 6465 7669 6365 2d6d --device-m │ │ │ │ │ +0000a6b0: 6173 7465 722d 706f 7274 3d27 247b 6465 aster-port='${de │ │ │ │ │ +0000a6c0: 7669 6365 2d70 6f72 747d 2720 5c0a 2020 vice-port}' \. │ │ │ │ │ 0000a6d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0000a6e0: 2020 2020 2020 2020 2020 2020 202d 2d65 --e │ │ │ │ │ -0000a6f0: 7865 632d 7365 7276 6572 2d74 6173 6b3d xec-server-task= │ │ │ │ │ -0000a700: 2724 7b65 7865 632d 7461 736b 7d27 202d '${exec-task}' - │ │ │ │ │ -0000a710: 5420 7479 7065 6420 2724 7b72 6f6f 747d T typed '${root} │ │ │ │ │ -0000a720: 2720 5c0a 2020 2020 2020 2020 2020 2020 ' \. │ │ │ │ │ -0000a730: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0000a740: 2027 2428 7461 736b 2d63 7265 6174 6529 '$(task-create) │ │ │ │ │ -0000a750: 2720 2724 2874 6173 6b2d 7265 7375 6d65 ' '$(task-resume │ │ │ │ │ -0000a760: 2927 0a20 2020 2020 2020 2020 2067 7275 )'. gru │ │ │ │ │ -0000a770: 623e 206d 6f64 756c 6520 2f6c 6962 2f6c b> module /lib/l │ │ │ │ │ -0000a780: 642e 736f 2e31 2065 7865 6320 2f68 7572 d.so.1 exec /hur │ │ │ │ │ -0000a790: 642f 6578 6563 2027 2428 6578 6563 2d74 d/exec '$(exec-t │ │ │ │ │ -0000a7a0: 6173 6b3d 7461 736b 2d63 7265 6174 6529 ask=task-create) │ │ │ │ │ -0000a7b0: 270a 0a20 2033 2e20 4669 6e61 6c6c 792c '.. 3. Finally, │ │ │ │ │ -0000a7c0: 2072 756e 2074 6865 2063 6f6d 6d61 6e64 run the command │ │ │ │ │ -0000a7d0: 2027 626f 6f74 2720 282a 6e6f 7465 2062 'boot' (*note b │ │ │ │ │ -0000a7e0: 6f6f 743a 3a29 2e0a 0a1f 0a46 696c 653a oot::).....File: │ │ │ │ │ -0000a7f0: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ -0000a800: 653a 2047 4e55 2f4c 696e 7578 2c20 204e e: GNU/Linux, N │ │ │ │ │ -0000a810: 6578 743a 204e 6574 4253 442c 2020 5072 ext: NetBSD, Pr │ │ │ │ │ -0000a820: 6576 3a20 474e 552f 4875 7264 2c20 2055 ev: GNU/Hurd, U │ │ │ │ │ -0000a830: 703a 204f 532d 7370 6563 6966 6963 206e p: OS-specific n │ │ │ │ │ -0000a840: 6f74 6573 0a0a 352e 342e 3220 474e 552f otes..5.4.2 GNU/ │ │ │ │ │ -0000a850: 4c69 6e75 780a 2d2d 2d2d 2d2d 2d2d 2d2d Linux.---------- │ │ │ │ │ -0000a860: 2d2d 2d2d 2d0a 0a49 7420 6973 2072 656c -----..It is rel │ │ │ │ │ -0000a870: 6174 6976 656c 7920 6561 7379 2074 6f20 atively easy to │ │ │ │ │ -0000a880: 626f 6f74 2047 4e55 2f4c 696e 7578 2066 boot GNU/Linux f │ │ │ │ │ -0000a890: 726f 6d20 4752 5542 2c20 6265 6361 7573 rom GRUB, becaus │ │ │ │ │ -0000a8a0: 6520 6974 2073 6f6d 6577 6861 740a 7265 e it somewhat.re │ │ │ │ │ -0000a8b0: 7365 6d62 6c65 7320 746f 2062 6f6f 7420 sembles to boot │ │ │ │ │ -0000a8c0: 6120 4d75 6c74 6962 6f6f 742d 636f 6d70 a Multiboot-comp │ │ │ │ │ -0000a8d0: 6c69 616e 7420 4f53 2e0a 0a20 2031 2e20 liant OS... 1. │ │ │ │ │ -0000a8e0: 5365 7420 4752 5542 2773 2072 6f6f 7420 Set GRUB's root │ │ │ │ │ -0000a8f0: 6465 7669 6365 2074 6f20 7468 6520 7361 device to the sa │ │ │ │ │ -0000a900: 6d65 2064 7269 7665 2061 7320 474e 552f me drive as GNU/ │ │ │ │ │ -0000a910: 4c69 6e75 7827 732e 2020 5468 650a 2020 Linux's. The. │ │ │ │ │ -0000a920: 2020 2063 6f6d 6d61 6e64 2027 7365 6172 command 'sear │ │ │ │ │ -0000a930: 6368 202d 2d73 6574 3d72 6f6f 7420 2d2d ch --set=root -- │ │ │ │ │ -0000a940: 6669 6c65 202f 766d 6c69 6e75 7a27 206f file /vmlinuz' o │ │ │ │ │ -0000a950: 7220 7369 6d69 6c61 7220 6d61 7920 6865 r similar may he │ │ │ │ │ -0000a960: 6c70 2079 6f75 0a20 2020 2020 282a 6e6f lp you. (*no │ │ │ │ │ -0000a970: 7465 2073 6561 7263 683a 3a29 2e0a 0a20 te search::)... │ │ │ │ │ -0000a980: 2032 2e20 4c6f 6164 2074 6865 206b 6572 2. Load the ker │ │ │ │ │ -0000a990: 6e65 6c20 7573 696e 6720 7468 6520 636f nel using the co │ │ │ │ │ -0000a9a0: 6d6d 616e 6420 276c 696e 7578 2720 282a mmand 'linux' (* │ │ │ │ │ -0000a9b0: 6e6f 7465 206c 696e 7578 3a3a 293a 0a0a note linux::):.. │ │ │ │ │ -0000a9c0: 2020 2020 2020 2020 2020 6772 7562 3e20 grub> │ │ │ │ │ -0000a9d0: 6c69 6e75 7820 2f76 6d6c 696e 757a 2072 linux /vmlinuz r │ │ │ │ │ -0000a9e0: 6f6f 743d 2f64 6576 2f73 6461 310a 0a20 oot=/dev/sda1.. │ │ │ │ │ -0000a9f0: 2020 2020 4966 2079 6f75 206e 6565 6420 If you need │ │ │ │ │ -0000aa00: 746f 2073 7065 6369 6679 2073 6f6d 6520 to specify some │ │ │ │ │ -0000aa10: 6b65 726e 656c 2070 6172 616d 6574 6572 kernel parameter │ │ │ │ │ -0000aa20: 732c 206a 7573 7420 6170 7065 6e64 2074 s, just append t │ │ │ │ │ -0000aa30: 6865 6d20 746f 0a20 2020 2020 7468 6520 hem to. the │ │ │ │ │ -0000aa40: 636f 6d6d 616e 642e 2020 466f 7220 6578 command. For ex │ │ │ │ │ -0000aa50: 616d 706c 652c 2074 6f20 7365 7420 2761 ample, to set 'a │ │ │ │ │ -0000aa60: 6370 6927 2074 6f20 276f 6666 272c 2064 cpi' to 'off', d │ │ │ │ │ -0000aa70: 6f20 7468 6973 3a0a 0a20 2020 2020 2020 o this:.. │ │ │ │ │ -0000aa80: 2020 2067 7275 623e 206c 696e 7578 202f grub> linux / │ │ │ │ │ -0000aa90: 766d 6c69 6e75 7a20 726f 6f74 3d2f 6465 vmlinuz root=/de │ │ │ │ │ -0000aaa0: 762f 7364 6131 2061 6370 693d 6f66 660a v/sda1 acpi=off. │ │ │ │ │ -0000aab0: 0a20 2020 2020 5365 6520 7468 6520 646f . See the do │ │ │ │ │ -0000aac0: 6375 6d65 6e74 6174 696f 6e20 696e 2074 cumentation in t │ │ │ │ │ -0000aad0: 6865 204c 696e 7578 2073 6f75 7263 6520 he Linux source │ │ │ │ │ -0000aae0: 7472 6565 2066 6f72 2063 6f6d 706c 6574 tree for complet │ │ │ │ │ -0000aaf0: 650a 2020 2020 2069 6e66 6f72 6d61 7469 e. informati │ │ │ │ │ -0000ab00: 6f6e 206f 6e20 7468 6520 6176 6169 6c61 on on the availa │ │ │ │ │ -0000ab10: 626c 6520 6f70 7469 6f6e 732e 0a0a 2020 ble options... │ │ │ │ │ -0000ab20: 2020 2057 6974 6820 276c 696e 7578 2720 With 'linux' │ │ │ │ │ -0000ab30: 4752 5542 2075 7365 7320 3332 2d62 6974 GRUB uses 32-bit │ │ │ │ │ -0000ab40: 2070 726f 746f 636f 6c2e 2020 536f 6d65 protocol. Some │ │ │ │ │ -0000ab50: 2042 494f 5320 7365 7276 6963 6573 206c BIOS services l │ │ │ │ │ -0000ab60: 696b 650a 2020 2020 2041 504d 206f 7220 ike. APM or │ │ │ │ │ -0000ab70: 4544 4420 6172 656e 2774 2061 7661 696c EDD aren't avail │ │ │ │ │ -0000ab80: 6162 6c65 2077 6974 6820 7468 6973 2070 able with this p │ │ │ │ │ -0000ab90: 726f 746f 636f 6c2e 2020 496e 2074 6869 rotocol. In thi │ │ │ │ │ -0000aba0: 7320 6361 7365 2079 6f75 0a20 2020 2020 s case you. │ │ │ │ │ -0000abb0: 6e65 6564 2074 6f20 7573 6520 276c 696e need to use 'lin │ │ │ │ │ -0000abc0: 7578 3136 270a 0a20 2020 2020 2020 2020 ux16'.. │ │ │ │ │ -0000abd0: 2067 7275 623e 206c 696e 7578 3136 202f grub> linux16 / │ │ │ │ │ -0000abe0: 766d 6c69 6e75 7a20 726f 6f74 3d2f 6465 vmlinuz root=/de │ │ │ │ │ -0000abf0: 762f 7364 6131 2061 6370 693d 6f66 660a v/sda1 acpi=off. │ │ │ │ │ -0000ac00: 0a20 2033 2e20 4966 2079 6f75 2075 7365 . 3. If you use │ │ │ │ │ -0000ac10: 2061 6e20 696e 6974 7264 2c20 6578 6563 an initrd, exec │ │ │ │ │ -0000ac20: 7574 6520 7468 6520 636f 6d6d 616e 6420 ute the command │ │ │ │ │ -0000ac30: 2769 6e69 7472 6427 2028 2a6e 6f74 6520 'initrd' (*note │ │ │ │ │ -0000ac40: 696e 6974 7264 3a3a 290a 2020 2020 2061 initrd::). a │ │ │ │ │ -0000ac50: 6674 6572 2027 6c69 6e75 7827 3a0a 0a20 fter 'linux':.. │ │ │ │ │ -0000ac60: 2020 2020 2020 2020 2067 7275 623e 2069 grub> i │ │ │ │ │ -0000ac70: 6e69 7472 6420 2f69 6e69 7472 640a 0a20 nitrd /initrd.. │ │ │ │ │ -0000ac80: 2020 2020 4966 2079 6f75 2075 7365 6420 If you used │ │ │ │ │ -0000ac90: 276c 696e 7578 3136 2720 796f 7520 6e65 'linux16' you ne │ │ │ │ │ -0000aca0: 6564 2074 6f20 7573 6520 2769 6e69 7472 ed to use 'initr │ │ │ │ │ -0000acb0: 6431 3627 3a0a 0a20 2020 2020 2020 2020 d16':.. │ │ │ │ │ -0000acc0: 2067 7275 623e 2069 6e69 7472 6431 3620 grub> initrd16 │ │ │ │ │ -0000acd0: 2f69 6e69 7472 640a 0a20 2034 2e20 4669 /initrd.. 4. Fi │ │ │ │ │ -0000ace0: 6e61 6c6c 792c 2072 756e 2074 6865 2063 nally, run the c │ │ │ │ │ -0000acf0: 6f6d 6d61 6e64 2027 626f 6f74 2720 282a ommand 'boot' (* │ │ │ │ │ -0000ad00: 6e6f 7465 2062 6f6f 743a 3a29 2e0a 0a1f note boot::).... │ │ │ │ │ -0000ad10: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ -0000ad20: 2c20 204e 6f64 653a 204e 6574 4253 442c , Node: NetBSD, │ │ │ │ │ -0000ad30: 2020 4e65 7874 3a20 444f 532f 5769 6e64 Next: DOS/Wind │ │ │ │ │ -0000ad40: 6f77 732c 2020 5072 6576 3a20 474e 552f ows, Prev: GNU/ │ │ │ │ │ -0000ad50: 4c69 6e75 782c 2020 5570 3a20 4f53 2d73 Linux, Up: OS-s │ │ │ │ │ -0000ad60: 7065 6369 6669 6320 6e6f 7465 730a 0a35 pecific notes..5 │ │ │ │ │ -0000ad70: 2e34 2e33 204e 6574 4253 440a 2d2d 2d2d .4.3 NetBSD.---- │ │ │ │ │ -0000ad80: 2d2d 2d2d 2d2d 2d2d 0a0a 426f 6f74 696e --------..Bootin │ │ │ │ │ -0000ad90: 6720 6120 4e65 7442 5344 206b 6572 6e65 g a NetBSD kerne │ │ │ │ │ -0000ada0: 6c20 6672 6f6d 2047 5255 4220 6973 2061 l from GRUB is a │ │ │ │ │ -0000adb0: 6c73 6f20 7265 6c61 7469 7665 6c79 2065 lso relatively e │ │ │ │ │ -0000adc0: 6173 793a 2066 6972 7374 2073 6574 0a47 asy: first set.G │ │ │ │ │ -0000add0: 5255 4227 7320 726f 6f74 2064 6576 6963 RUB's root devic │ │ │ │ │ -0000ade0: 652c 2074 6865 6e20 6c6f 6164 2074 6865 e, then load the │ │ │ │ │ -0000adf0: 206b 6572 6e65 6c20 616e 6420 7468 6520 kernel and the │ │ │ │ │ -0000ae00: 6d6f 6475 6c65 732c 2061 6e64 2066 696e modules, and fin │ │ │ │ │ -0000ae10: 616c 6c79 0a72 756e 2027 626f 6f74 272e ally.run 'boot'. │ │ │ │ │ -0000ae20: 0a0a 2020 312e 2053 6574 2047 5255 4227 .. 1. Set GRUB' │ │ │ │ │ -0000ae30: 7320 726f 6f74 2064 6576 6963 6520 746f s root device to │ │ │ │ │ -0000ae40: 2074 6865 2070 6172 7469 7469 6f6e 2068 the partition h │ │ │ │ │ -0000ae50: 6f6c 6469 6e67 2074 6865 204e 6574 4253 olding the NetBS │ │ │ │ │ -0000ae60: 4420 726f 6f74 0a20 2020 2020 6669 6c65 D root. file │ │ │ │ │ -0000ae70: 2073 7973 7465 6d2e 2020 466f 7220 6120 system. For a │ │ │ │ │ -0000ae80: 6469 736b 2077 6974 6820 6120 4e65 7442 disk with a NetB │ │ │ │ │ -0000ae90: 5344 2064 6973 6b20 6c61 6265 6c2c 2074 SD disk label, t │ │ │ │ │ -0000aea0: 6869 7320 6973 2075 7375 616c 6c79 0a20 his is usually. │ │ │ │ │ -0000aeb0: 2020 2020 7468 6520 6669 7273 7420 7061 the first pa │ │ │ │ │ -0000aec0: 7274 6974 696f 6e20 2861 3a29 2e20 2049 rtition (a:). I │ │ │ │ │ -0000aed0: 6e20 7468 6174 2063 6173 652c 2061 6e64 n that case, and │ │ │ │ │ -0000aee0: 2061 7373 756d 696e 6720 7468 6174 2074 assuming that t │ │ │ │ │ -0000aef0: 6865 0a20 2020 2020 7061 7274 6974 696f he. partitio │ │ │ │ │ -0000af00: 6e20 6973 206f 6e20 7468 6520 6669 7273 n is on the firs │ │ │ │ │ -0000af10: 7420 6861 7264 2064 6973 6b2c 2073 6574 t hard disk, set │ │ │ │ │ -0000af20: 2047 5255 4227 7320 726f 6f74 2064 6576 GRUB's root dev │ │ │ │ │ -0000af30: 6963 6520 6173 0a20 2020 2020 666f 6c6c ice as. foll │ │ │ │ │ -0000af40: 6f77 733a 0a0a 2020 2020 2020 2020 2020 ows:.. │ │ │ │ │ -0000af50: 6772 7562 3e20 696e 736d 6f64 2070 6172 grub> insmod par │ │ │ │ │ -0000af60: 745f 6273 640a 2020 2020 2020 2020 2020 t_bsd. │ │ │ │ │ -0000af70: 6772 7562 3e20 7365 7420 726f 6f74 3d28 grub> set root=( │ │ │ │ │ -0000af80: 6864 302c 6e65 7462 7364 3129 0a0a 2020 hd0,netbsd1).. │ │ │ │ │ -0000af90: 2020 2046 6f72 2061 2064 6973 6b20 7769 For a disk wi │ │ │ │ │ -0000afa0: 7468 2061 2047 5549 4420 5061 7274 6974 th a GUID Partit │ │ │ │ │ -0000afb0: 696f 6e20 5461 626c 6520 2847 5054 292c ion Table (GPT), │ │ │ │ │ -0000afc0: 2061 6e64 2061 7373 756d 696e 6720 7468 and assuming th │ │ │ │ │ -0000afd0: 6174 2074 6865 0a20 2020 2020 4e65 7442 at the. NetB │ │ │ │ │ -0000afe0: 5344 2072 6f6f 7420 7061 7274 6974 696f SD root partitio │ │ │ │ │ -0000aff0: 6e20 6973 2074 6865 2074 6869 7264 2047 n is the third G │ │ │ │ │ -0000b000: 5054 2070 6172 7469 7469 6f6e 2c20 646f PT partition, do │ │ │ │ │ -0000b010: 2074 6869 733a 0a0a 2020 2020 2020 2020 this:.. │ │ │ │ │ -0000b020: 2020 6772 7562 3e20 696e 736d 6f64 2070 grub> insmod p │ │ │ │ │ -0000b030: 6172 745f 6770 740a 2020 2020 2020 2020 art_gpt. │ │ │ │ │ -0000b040: 2020 6772 7562 3e20 7365 7420 726f 6f74 grub> set root │ │ │ │ │ -0000b050: 3d28 6864 302c 6770 7433 290a 0a20 2032 =(hd0,gpt3).. 2 │ │ │ │ │ -0000b060: 2e20 4c6f 6164 2074 6865 206b 6572 6e65 . Load the kerne │ │ │ │ │ -0000b070: 6c20 7573 696e 6720 7468 6520 636f 6d6d l using the comm │ │ │ │ │ -0000b080: 616e 6420 276b 6e65 7462 7364 273a 0a0a and 'knetbsd':.. │ │ │ │ │ -0000b090: 2020 2020 2020 2020 2020 6772 7562 3e20 grub> │ │ │ │ │ -0000b0a0: 6b6e 6574 6273 6420 2f6e 6574 6273 640a knetbsd /netbsd. │ │ │ │ │ -0000b0b0: 0a20 2020 2020 5661 7269 6f75 7320 6f70 . Various op │ │ │ │ │ -0000b0c0: 7469 6f6e 7320 6d61 7920 6265 2067 6976 tions may be giv │ │ │ │ │ -0000b0d0: 656e 2074 6f20 276b 6e65 7462 7364 272e en to 'knetbsd'. │ │ │ │ │ -0000b0e0: 2020 5468 6573 6520 6f70 7469 6f6e 7320 These options │ │ │ │ │ -0000b0f0: 6172 652c 2066 6f72 0a20 2020 2020 7468 are, for. th │ │ │ │ │ -0000b100: 6520 6d6f 7374 2070 6172 742c 2074 6865 e most part, the │ │ │ │ │ -0000b110: 2073 616d 6520 6173 2069 6e20 7468 6520 same as in the │ │ │ │ │ -0000b120: 4e65 7442 5344 2062 6f6f 7420 6c6f 6164 NetBSD boot load │ │ │ │ │ -0000b130: 6572 2e20 2046 6f72 0a20 2020 2020 696e er. For. in │ │ │ │ │ -0000b140: 7374 616e 6365 2c20 746f 2062 6f6f 7420 stance, to boot │ │ │ │ │ -0000b150: 7468 6520 7379 7374 656d 2069 6e20 7369 the system in si │ │ │ │ │ -0000b160: 6e67 6c65 2d75 7365 7220 6d6f 6465 2061 ngle-user mode a │ │ │ │ │ -0000b170: 6e64 2077 6974 6820 7665 7262 6f73 650a nd with verbose. │ │ │ │ │ -0000b180: 2020 2020 206d 6573 7361 6765 732c 2064 messages, d │ │ │ │ │ -0000b190: 6f20 7468 6973 3a0a 0a20 2020 2020 2020 o this:.. │ │ │ │ │ -0000b1a0: 2020 2067 7275 623e 206b 6e65 7462 7364 grub> knetbsd │ │ │ │ │ -0000b1b0: 202f 6e65 7462 7364 202d 7320 2d76 0a0a /netbsd -s -v.. │ │ │ │ │ -0000b1c0: 2020 332e 2049 6620 6e65 6564 6564 2c20 3. If needed, │ │ │ │ │ -0000b1d0: 6c6f 6164 206b 6572 6e65 6c20 6d6f 6475 load kernel modu │ │ │ │ │ -0000b1e0: 6c65 7320 7769 7468 2074 6865 2063 6f6d les with the com │ │ │ │ │ -0000b1f0: 6d61 6e64 0a20 2020 2020 276b 6e65 7462 mand. 'knetb │ │ │ │ │ -0000b200: 7364 5f6d 6f64 756c 655f 656c 6627 2e20 sd_module_elf'. │ │ │ │ │ -0000b210: 2041 2074 7970 6963 616c 2065 7861 6d70 A typical examp │ │ │ │ │ -0000b220: 6c65 2069 7320 7468 6520 6d6f 6475 6c65 le is the module │ │ │ │ │ -0000b230: 2066 6f72 2074 6865 2072 6f6f 740a 2020 for the root. │ │ │ │ │ -0000b240: 2020 2066 696c 6520 7379 7374 656d 3a0a file system:. │ │ │ │ │ -0000b250: 0a20 2020 2020 2020 2020 2067 7275 623e . grub> │ │ │ │ │ -0000b260: 206b 6e65 7462 7364 5f6d 6f64 756c 655f knetbsd_module_ │ │ │ │ │ -0000b270: 656c 6620 2f73 7461 6e64 2f61 6d64 3634 elf /stand/amd64 │ │ │ │ │ -0000b280: 2f36 2e30 2f6d 6f64 756c 6573 2f66 6673 /6.0/modules/ffs │ │ │ │ │ -0000b290: 2f66 6673 2e6b 6d6f 640a 0a20 2034 2e20 /ffs.kmod.. 4. │ │ │ │ │ -0000b2a0: 4669 6e61 6c6c 792c 2072 756e 2074 6865 Finally, run the │ │ │ │ │ -0000b2b0: 2063 6f6d 6d61 6e64 2027 626f 6f74 2720 command 'boot' │ │ │ │ │ -0000b2c0: 282a 6e6f 7465 2062 6f6f 743a 3a29 2e0a (*note boot::).. │ │ │ │ │ -0000b2d0: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ -0000b2e0: 666f 2c20 204e 6f64 653a 2044 4f53 2f57 fo, Node: DOS/W │ │ │ │ │ -0000b2f0: 696e 646f 7773 2c20 2050 7265 763a 204e indows, Prev: N │ │ │ │ │ -0000b300: 6574 4253 442c 2020 5570 3a20 4f53 2d73 etBSD, Up: OS-s │ │ │ │ │ -0000b310: 7065 6369 6669 6320 6e6f 7465 730a 0a35 pecific notes..5 │ │ │ │ │ -0000b320: 2e34 2e34 2044 4f53 2f57 696e 646f 7773 .4.4 DOS/Windows │ │ │ │ │ -0000b330: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ │ -0000b340: 2d2d 0a0a 4752 5542 2063 616e 6e6f 7420 --..GRUB cannot │ │ │ │ │ -0000b350: 626f 6f74 2044 4f53 206f 7220 5769 6e64 boot DOS or Wind │ │ │ │ │ -0000b360: 6f77 7320 6469 7265 6374 6c79 2c20 736f ows directly, so │ │ │ │ │ -0000b370: 2079 6f75 206d 7573 7420 6368 6169 6e2d you must chain- │ │ │ │ │ -0000b380: 6c6f 6164 2074 6865 6d0a 282a 6e6f 7465 load them.(*note │ │ │ │ │ -0000b390: 2043 6861 696e 2d6c 6f61 6469 6e67 3a3a Chain-loading:: │ │ │ │ │ -0000b3a0: 292e 2020 486f 7765 7665 722c 2074 6865 ). However, the │ │ │ │ │ -0000b3b0: 6972 2062 6f6f 7420 6c6f 6164 6572 7320 ir boot loaders │ │ │ │ │ -0000b3c0: 6861 7665 2073 6f6d 6520 6372 6974 6963 have some critic │ │ │ │ │ -0000b3d0: 616c 0a64 6566 6963 6965 6e63 6965 732c al.deficiencies, │ │ │ │ │ -0000b3e0: 2073 6f20 6974 206d 6179 206e 6f74 2077 so it may not w │ │ │ │ │ -0000b3f0: 6f72 6b20 746f 206a 7573 7420 6368 6169 ork to just chai │ │ │ │ │ -0000b400: 6e2d 6c6f 6164 2074 6865 6d2e 2020 546f n-load them. To │ │ │ │ │ -0000b410: 206f 7665 7263 6f6d 650a 7468 6520 7072 overcome.the pr │ │ │ │ │ -0000b420: 6f62 6c65 6d73 2c20 4752 5542 2070 726f oblems, GRUB pro │ │ │ │ │ -0000b430: 7669 6465 7320 796f 7520 7769 7468 2074 vides you with t │ │ │ │ │ -0000b440: 776f 2068 656c 7065 7220 6675 6e63 7469 wo helper functi │ │ │ │ │ -0000b450: 6f6e 732e 0a0a 2020 2049 6620 796f 7520 ons... If you │ │ │ │ │ -0000b460: 6861 7665 2069 6e73 7461 6c6c 6564 2044 have installed D │ │ │ │ │ -0000b470: 4f53 2028 6f72 2057 696e 646f 7773 2920 OS (or Windows) │ │ │ │ │ -0000b480: 6f6e 2061 206e 6f6e 2d66 6972 7374 2068 on a non-first h │ │ │ │ │ -0000b490: 6172 6420 6469 736b 2c20 796f 750a 6861 ard disk, you.ha │ │ │ │ │ -0000b4a0: 7665 2074 6f20 7573 6520 7468 6520 6469 ve to use the di │ │ │ │ │ -0000b4b0: 736b 2073 7761 7070 696e 6720 7465 6368 sk swapping tech │ │ │ │ │ -0000b4c0: 6e69 7175 652c 2062 6563 6175 7365 2074 nique, because t │ │ │ │ │ -0000b4d0: 6861 7420 4f53 2063 616e 6e6f 7420 626f hat OS cannot bo │ │ │ │ │ -0000b4e0: 6f74 0a66 726f 6d20 616e 7920 6469 736b ot.from any disk │ │ │ │ │ -0000b4f0: 7320 6275 7420 7468 6520 6669 7273 7420 s but the first │ │ │ │ │ -0000b500: 6f6e 652e 2020 5468 6520 776f 726b 6172 one. The workar │ │ │ │ │ -0000b510: 6f75 6e64 2075 7365 6420 696e 2047 5255 ound used in GRU │ │ │ │ │ -0000b520: 4220 6973 2074 6865 0a63 6f6d 6d61 6e64 B is the.command │ │ │ │ │ -0000b530: 2027 6472 6976 656d 6170 2720 282a 6e6f 'drivemap' (*no │ │ │ │ │ -0000b540: 7465 2064 7269 7665 6d61 703a 3a29 2c20 te drivemap::), │ │ │ │ │ -0000b550: 6c69 6b65 2074 6869 733a 0a0a 2020 2020 like this:.. │ │ │ │ │ -0000b560: 2064 7269 7665 6d61 7020 2d73 2028 6864 drivemap -s (hd │ │ │ │ │ -0000b570: 3029 2028 6864 3129 0a0a 2020 2054 6869 0) (hd1).. Thi │ │ │ │ │ -0000b580: 7320 7065 7266 6f72 6d73 2061 2022 7669 s performs a "vi │ │ │ │ │ -0000b590: 7274 7561 6c22 2073 7761 7020 6265 7477 rtual" swap betw │ │ │ │ │ -0000b5a0: 6565 6e20 796f 7572 2066 6972 7374 2061 een your first a │ │ │ │ │ -0000b5b0: 6e64 2073 6563 6f6e 6420 6861 7264 0a64 nd second hard.d │ │ │ │ │ -0000b5c0: 7269 7665 2e0a 0a20 2020 2a43 6175 7469 rive... *Cauti │ │ │ │ │ -0000b5d0: 6f6e 3a2a 2054 6869 7320 6973 2065 6666 on:* This is eff │ │ │ │ │ -0000b5e0: 6563 7469 7665 206f 6e6c 7920 6966 2044 ective only if D │ │ │ │ │ -0000b5f0: 4f53 2028 6f72 2057 696e 646f 7773 2920 OS (or Windows) │ │ │ │ │ -0000b600: 7573 6573 2042 494f 5320 746f 0a61 6363 uses BIOS to.acc │ │ │ │ │ -0000b610: 6573 7320 7468 6520 7377 6170 7065 6420 ess the swapped │ │ │ │ │ -0000b620: 6469 736b 732e 2020 4966 2074 6861 7420 disks. If that │ │ │ │ │ -0000b630: 4f53 2075 7365 7320 6120 7370 6563 6961 OS uses a specia │ │ │ │ │ -0000b640: 6c20 6472 6976 6572 2066 6f72 2074 6865 l driver for the │ │ │ │ │ -0000b650: 0a64 6973 6b73 2c20 7468 6973 2070 726f .disks, this pro │ │ │ │ │ -0000b660: 6261 626c 7920 776f 6e27 7420 776f 726b bably won't work │ │ │ │ │ -0000b670: 2e0a 0a20 2020 416e 6f74 6865 7220 7072 ... Another pr │ │ │ │ │ -0000b680: 6f62 6c65 6d20 6172 6973 6573 2069 6620 oblem arises if │ │ │ │ │ -0000b690: 796f 7520 696e 7374 616c 6c65 6420 6d6f you installed mo │ │ │ │ │ -0000b6a0: 7265 2074 6861 6e20 6f6e 6520 7365 7420 re than one set │ │ │ │ │ -0000b6b0: 6f66 0a44 4f53 2f57 696e 646f 7773 206f of.DOS/Windows o │ │ │ │ │ -0000b6c0: 6e74 6f20 6f6e 6520 6469 736b 2c20 6265 nto one disk, be │ │ │ │ │ -0000b6d0: 6361 7573 6520 7468 6579 2063 6f75 6c64 cause they could │ │ │ │ │ -0000b6e0: 2062 6520 636f 6e66 7573 6564 2069 6620 be confused if │ │ │ │ │ -0000b6f0: 7468 6572 6520 6172 650a 6d6f 7265 2074 there are.more t │ │ │ │ │ -0000b700: 6861 6e20 6f6e 6520 7072 696d 6172 7920 han one primary │ │ │ │ │ -0000b710: 7061 7274 6974 696f 6e73 2066 6f72 2044 partitions for D │ │ │ │ │ -0000b720: 4f53 2f57 696e 646f 7773 2e20 2043 6572 OS/Windows. Cer │ │ │ │ │ -0000b730: 7461 696e 6c79 2079 6f75 2073 686f 756c tainly you shoul │ │ │ │ │ -0000b740: 640a 6176 6f69 6420 646f 696e 6720 7468 d.avoid doing th │ │ │ │ │ -0000b750: 6973 2c20 6275 7420 7468 6572 6520 6973 is, but there is │ │ │ │ │ -0000b760: 2061 2073 6f6c 7574 696f 6e20 6966 2079 a solution if y │ │ │ │ │ -0000b770: 6f75 2064 6f20 7761 6e74 2074 6f20 646f ou do want to do │ │ │ │ │ -0000b780: 2073 6f2e 2020 5573 650a 7468 6520 7061 so. Use.the pa │ │ │ │ │ -0000b790: 7274 6974 696f 6e20 6869 6469 6e67 2f75 rtition hiding/u │ │ │ │ │ -0000b7a0: 6e68 6964 696e 6720 7465 6368 6e69 7175 nhiding techniqu │ │ │ │ │ -0000b7b0: 652e 0a0a 2020 2049 6620 4752 5542 2022 e... If GRUB " │ │ │ │ │ -0000b7c0: 6869 6465 7322 2061 2044 4f53 2028 6f72 hides" a DOS (or │ │ │ │ │ -0000b7d0: 2057 696e 646f 7773 2920 7061 7274 6974 Windows) partit │ │ │ │ │ -0000b7e0: 696f 6e20 282a 6e6f 7465 2070 6172 7474 ion (*note partt │ │ │ │ │ -0000b7f0: 6f6f 6c3a 3a29 2c20 444f 530a 286f 7220 ool::), DOS.(or │ │ │ │ │ -0000b800: 5769 6e64 6f77 7329 2077 696c 6c20 6967 Windows) will ig │ │ │ │ │ -0000b810: 6e6f 7265 2074 6865 2070 6172 7469 7469 nore the partiti │ │ │ │ │ -0000b820: 6f6e 2e20 2049 6620 4752 5542 2022 756e on. If GRUB "un │ │ │ │ │ -0000b830: 6869 6465 7322 2061 2044 4f53 2028 6f72 hides" a DOS (or │ │ │ │ │ -0000b840: 0a57 696e 646f 7773 2920 7061 7274 6974 .Windows) partit │ │ │ │ │ -0000b850: 696f 6e2c 2044 4f53 2028 6f72 2057 696e ion, DOS (or Win │ │ │ │ │ -0000b860: 646f 7773 2920 7769 6c6c 2064 6574 6563 dows) will detec │ │ │ │ │ -0000b870: 7420 7468 6520 7061 7274 6974 696f 6e2e t the partition. │ │ │ │ │ -0000b880: 2020 5468 7573 2c0a 6966 2079 6f75 2068 Thus,.if you h │ │ │ │ │ -0000b890: 6176 6520 696e 7374 616c 6c65 6420 444f ave installed DO │ │ │ │ │ -0000b8a0: 5320 286f 7220 5769 6e64 6f77 7329 206f S (or Windows) o │ │ │ │ │ -0000b8b0: 6e20 7468 6520 6669 7273 7420 616e 6420 n the first and │ │ │ │ │ -0000b8c0: 7468 6520 7365 636f 6e64 0a70 6172 7469 the second.parti │ │ │ │ │ -0000b8d0: 7469 6f6e 206f 6620 7468 6520 6669 7273 tion of the firs │ │ │ │ │ -0000b8e0: 7420 6861 7264 2064 6973 6b2c 2061 6e64 t hard disk, and │ │ │ │ │ -0000b8f0: 2079 6f75 2077 616e 7420 746f 2062 6f6f you want to boo │ │ │ │ │ -0000b900: 7420 7468 6520 636f 7079 206f 6e20 7468 t the copy on th │ │ │ │ │ -0000b910: 650a 6669 7273 7420 7061 7274 6974 696f e.first partitio │ │ │ │ │ -0000b920: 6e2c 2064 6f20 7468 6520 666f 6c6c 6f77 n, do the follow │ │ │ │ │ -0000b930: 696e 673a 0a0a 2020 2020 2070 6172 7474 ing:.. partt │ │ │ │ │ -0000b940: 6f6f 6c20 2868 6430 2c31 2920 6869 6464 ool (hd0,1) hidd │ │ │ │ │ -0000b950: 656e 2d0a 2020 2020 2070 6172 7474 6f6f en-. parttoo │ │ │ │ │ -0000b960: 6c20 2868 6430 2c32 2920 6869 6464 656e l (hd0,2) hidden │ │ │ │ │ -0000b970: 2b0a 2020 2020 2073 6574 2072 6f6f 743d +. set root= │ │ │ │ │ -0000b980: 2868 6430 2c31 290a 2020 2020 2063 6861 (hd0,1). cha │ │ │ │ │ -0000b990: 696e 6c6f 6164 6572 202b 310a 2020 2020 inloader +1. │ │ │ │ │ -0000b9a0: 2070 6172 7474 6f6f 6c20 247b 726f 6f74 parttool ${root │ │ │ │ │ -0000b9b0: 7d20 626f 6f74 2b0a 2020 2020 2062 6f6f } boot+. boo │ │ │ │ │ -0000b9c0: 740a 0a1f 0a46 696c 653a 2067 7275 622e t....File: grub. │ │ │ │ │ -0000b9d0: 696e 666f 2c20 204e 6f64 653a 2043 6f6e info, Node: Con │ │ │ │ │ -0000b9e0: 6669 6775 7261 7469 6f6e 2c20 204e 6578 figuration, Nex │ │ │ │ │ -0000b9f0: 743a 2054 6865 6d65 2066 696c 6520 666f t: Theme file fo │ │ │ │ │ -0000ba00: 726d 6174 2c20 2050 7265 763a 2042 6f6f rmat, Prev: Boo │ │ │ │ │ -0000ba10: 7469 6e67 2c20 2055 703a 2054 6f70 0a0a ting, Up: Top.. │ │ │ │ │ -0000ba20: 3620 5772 6974 696e 6720 796f 7572 206f 6 Writing your o │ │ │ │ │ -0000ba30: 776e 2063 6f6e 6669 6775 7261 7469 6f6e wn configuration │ │ │ │ │ -0000ba40: 2066 696c 650a 2a2a 2a2a 2a2a 2a2a 2a2a file.********** │ │ │ │ │ +0000a6e0: 2020 2020 2020 2020 2020 202d 2d65 7865 --exe │ │ │ │ │ +0000a6f0: 632d 7365 7276 6572 2d74 6173 6b3d 2724 c-server-task='$ │ │ │ │ │ +0000a700: 7b65 7865 632d 7461 736b 7d27 202d 5420 {exec-task}' -T │ │ │ │ │ +0000a710: 7479 7065 6420 2724 7b72 6f6f 747d 2720 typed '${root}' │ │ │ │ │ +0000a720: 5c0a 2020 2020 2020 2020 2020 2020 2020 \. │ │ │ │ │ +0000a730: 2020 2020 2020 2020 2020 2020 2020 2027 ' │ │ │ │ │ +0000a740: 2428 7461 736b 2d63 7265 6174 6529 2720 $(task-create)' │ │ │ │ │ +0000a750: 2724 2874 6173 6b2d 7265 7375 6d65 2927 '$(task-resume)' │ │ │ │ │ +0000a760: 0a20 2020 2020 2020 2020 2067 7275 623e . grub> │ │ │ │ │ +0000a770: 206d 6f64 756c 6520 2f6c 6962 2f6c 642e module /lib/ld. │ │ │ │ │ +0000a780: 736f 2e31 2065 7865 6320 2f68 7572 642f so.1 exec /hurd/ │ │ │ │ │ +0000a790: 6578 6563 2027 2428 6578 6563 2d74 6173 exec '$(exec-tas │ │ │ │ │ +0000a7a0: 6b3d 7461 736b 2d63 7265 6174 6529 270a k=task-create)'. │ │ │ │ │ +0000a7b0: 0a20 2033 2e20 4669 6e61 6c6c 792c 2072 . 3. Finally, r │ │ │ │ │ +0000a7c0: 756e 2074 6865 2063 6f6d 6d61 6e64 2027 un the command ' │ │ │ │ │ +0000a7d0: 626f 6f74 2720 282a 6e6f 7465 2062 6f6f boot' (*note boo │ │ │ │ │ +0000a7e0: 743a 3a29 2e0a 0a1f 0a46 696c 653a 2067 t::).....File: g │ │ │ │ │ +0000a7f0: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ +0000a800: 2047 4e55 2f4c 696e 7578 2c20 204e 6578 GNU/Linux, Nex │ │ │ │ │ +0000a810: 743a 204e 6574 4253 442c 2020 5072 6576 t: NetBSD, Prev │ │ │ │ │ +0000a820: 3a20 474e 552f 4875 7264 2c20 2055 703a : GNU/Hurd, Up: │ │ │ │ │ +0000a830: 204f 532d 7370 6563 6966 6963 206e 6f74 OS-specific not │ │ │ │ │ +0000a840: 6573 0a0a 352e 342e 3220 474e 552f 4c69 es..5.4.2 GNU/Li │ │ │ │ │ +0000a850: 6e75 780a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d nux.------------ │ │ │ │ │ +0000a860: 2d2d 2d0a 0a49 7420 6973 2072 656c 6174 ---..It is relat │ │ │ │ │ +0000a870: 6976 656c 7920 6561 7379 2074 6f20 626f ively easy to bo │ │ │ │ │ +0000a880: 6f74 2047 4e55 2f4c 696e 7578 2066 726f ot GNU/Linux fro │ │ │ │ │ +0000a890: 6d20 4752 5542 2c20 6265 6361 7573 6520 m GRUB, because │ │ │ │ │ +0000a8a0: 6974 2073 6f6d 6577 6861 740a 7265 7365 it somewhat.rese │ │ │ │ │ +0000a8b0: 6d62 6c65 7320 746f 2062 6f6f 7420 6120 mbles to boot a │ │ │ │ │ +0000a8c0: 4d75 6c74 6962 6f6f 742d 636f 6d70 6c69 Multiboot-compli │ │ │ │ │ +0000a8d0: 616e 7420 4f53 2e0a 0a20 2031 2e20 5365 ant OS... 1. Se │ │ │ │ │ +0000a8e0: 7420 4752 5542 2773 2072 6f6f 7420 6465 t GRUB's root de │ │ │ │ │ +0000a8f0: 7669 6365 2074 6f20 7468 6520 7361 6d65 vice to the same │ │ │ │ │ +0000a900: 2064 7269 7665 2061 7320 474e 552f 4c69 drive as GNU/Li │ │ │ │ │ +0000a910: 6e75 7827 732e 2020 5468 650a 2020 2020 nux's. The. │ │ │ │ │ +0000a920: 2063 6f6d 6d61 6e64 2027 7365 6172 6368 command 'search │ │ │ │ │ +0000a930: 202d 2d73 6574 3d72 6f6f 7420 2d2d 6669 --set=root --fi │ │ │ │ │ +0000a940: 6c65 202f 766d 6c69 6e75 7a27 206f 7220 le /vmlinuz' or │ │ │ │ │ +0000a950: 7369 6d69 6c61 7220 6d61 7920 6865 6c70 similar may help │ │ │ │ │ +0000a960: 2079 6f75 0a20 2020 2020 282a 6e6f 7465 you. (*note │ │ │ │ │ +0000a970: 2073 6561 7263 683a 3a29 2e0a 0a20 2032 search::)... 2 │ │ │ │ │ +0000a980: 2e20 4c6f 6164 2074 6865 206b 6572 6e65 . Load the kerne │ │ │ │ │ +0000a990: 6c20 7573 696e 6720 7468 6520 636f 6d6d l using the comm │ │ │ │ │ +0000a9a0: 616e 6420 276c 696e 7578 2720 282a 6e6f and 'linux' (*no │ │ │ │ │ +0000a9b0: 7465 206c 696e 7578 3a3a 293a 0a0a 2020 te linux::):.. │ │ │ │ │ +0000a9c0: 2020 2020 2020 2020 6772 7562 3e20 6c69 grub> li │ │ │ │ │ +0000a9d0: 6e75 7820 2f76 6d6c 696e 757a 2072 6f6f nux /vmlinuz roo │ │ │ │ │ +0000a9e0: 743d 2f64 6576 2f73 6461 310a 0a20 2020 t=/dev/sda1.. │ │ │ │ │ +0000a9f0: 2020 4966 2079 6f75 206e 6565 6420 746f If you need to │ │ │ │ │ +0000aa00: 2073 7065 6369 6679 2073 6f6d 6520 6b65 specify some ke │ │ │ │ │ +0000aa10: 726e 656c 2070 6172 616d 6574 6572 732c rnel parameters, │ │ │ │ │ +0000aa20: 206a 7573 7420 6170 7065 6e64 2074 6865 just append the │ │ │ │ │ +0000aa30: 6d20 746f 0a20 2020 2020 7468 6520 636f m to. the co │ │ │ │ │ +0000aa40: 6d6d 616e 642e 2020 466f 7220 6578 616d mmand. For exam │ │ │ │ │ +0000aa50: 706c 652c 2074 6f20 7365 7420 2761 6370 ple, to set 'acp │ │ │ │ │ +0000aa60: 6927 2074 6f20 276f 6666 272c 2064 6f20 i' to 'off', do │ │ │ │ │ +0000aa70: 7468 6973 3a0a 0a20 2020 2020 2020 2020 this:.. │ │ │ │ │ +0000aa80: 2067 7275 623e 206c 696e 7578 202f 766d grub> linux /vm │ │ │ │ │ +0000aa90: 6c69 6e75 7a20 726f 6f74 3d2f 6465 762f linuz root=/dev/ │ │ │ │ │ +0000aaa0: 7364 6131 2061 6370 693d 6f66 660a 0a20 sda1 acpi=off.. │ │ │ │ │ +0000aab0: 2020 2020 5365 6520 7468 6520 646f 6375 See the docu │ │ │ │ │ +0000aac0: 6d65 6e74 6174 696f 6e20 696e 2074 6865 mentation in the │ │ │ │ │ +0000aad0: 204c 696e 7578 2073 6f75 7263 6520 7472 Linux source tr │ │ │ │ │ +0000aae0: 6565 2066 6f72 2063 6f6d 706c 6574 650a ee for complete. │ │ │ │ │ +0000aaf0: 2020 2020 2069 6e66 6f72 6d61 7469 6f6e information │ │ │ │ │ +0000ab00: 206f 6e20 7468 6520 6176 6169 6c61 626c on the availabl │ │ │ │ │ +0000ab10: 6520 6f70 7469 6f6e 732e 0a0a 2020 2020 e options... │ │ │ │ │ +0000ab20: 2057 6974 6820 276c 696e 7578 2720 4752 With 'linux' GR │ │ │ │ │ +0000ab30: 5542 2075 7365 7320 3332 2d62 6974 2070 UB uses 32-bit p │ │ │ │ │ +0000ab40: 726f 746f 636f 6c2e 2020 536f 6d65 2042 rotocol. Some B │ │ │ │ │ +0000ab50: 494f 5320 7365 7276 6963 6573 206c 696b IOS services lik │ │ │ │ │ +0000ab60: 650a 2020 2020 2041 504d 206f 7220 4544 e. APM or ED │ │ │ │ │ +0000ab70: 4420 6172 656e 2774 2061 7661 696c 6162 D aren't availab │ │ │ │ │ +0000ab80: 6c65 2077 6974 6820 7468 6973 2070 726f le with this pro │ │ │ │ │ +0000ab90: 746f 636f 6c2e 2020 496e 2074 6869 7320 tocol. In this │ │ │ │ │ +0000aba0: 6361 7365 2079 6f75 0a20 2020 2020 6e65 case you. ne │ │ │ │ │ +0000abb0: 6564 2074 6f20 7573 6520 276c 696e 7578 ed to use 'linux │ │ │ │ │ +0000abc0: 3136 270a 0a20 2020 2020 2020 2020 2067 16'.. g │ │ │ │ │ +0000abd0: 7275 623e 206c 696e 7578 3136 202f 766d rub> linux16 /vm │ │ │ │ │ +0000abe0: 6c69 6e75 7a20 726f 6f74 3d2f 6465 762f linuz root=/dev/ │ │ │ │ │ +0000abf0: 7364 6131 2061 6370 693d 6f66 660a 0a20 sda1 acpi=off.. │ │ │ │ │ +0000ac00: 2033 2e20 4966 2079 6f75 2075 7365 2061 3. If you use a │ │ │ │ │ +0000ac10: 6e20 696e 6974 7264 2c20 6578 6563 7574 n initrd, execut │ │ │ │ │ +0000ac20: 6520 7468 6520 636f 6d6d 616e 6420 2769 e the command 'i │ │ │ │ │ +0000ac30: 6e69 7472 6427 2028 2a6e 6f74 6520 696e nitrd' (*note in │ │ │ │ │ +0000ac40: 6974 7264 3a3a 290a 2020 2020 2061 6674 itrd::). aft │ │ │ │ │ +0000ac50: 6572 2027 6c69 6e75 7827 3a0a 0a20 2020 er 'linux':.. │ │ │ │ │ +0000ac60: 2020 2020 2020 2067 7275 623e 2069 6e69 grub> ini │ │ │ │ │ +0000ac70: 7472 6420 2f69 6e69 7472 640a 0a20 2020 trd /initrd.. │ │ │ │ │ +0000ac80: 2020 4966 2079 6f75 2075 7365 6420 276c If you used 'l │ │ │ │ │ +0000ac90: 696e 7578 3136 2720 796f 7520 6e65 6564 inux16' you need │ │ │ │ │ +0000aca0: 2074 6f20 7573 6520 2769 6e69 7472 6431 to use 'initrd1 │ │ │ │ │ +0000acb0: 3627 3a0a 0a20 2020 2020 2020 2020 2067 6':.. g │ │ │ │ │ +0000acc0: 7275 623e 2069 6e69 7472 6431 3620 2f69 rub> initrd16 /i │ │ │ │ │ +0000acd0: 6e69 7472 640a 0a20 2034 2e20 4669 6e61 nitrd.. 4. Fina │ │ │ │ │ +0000ace0: 6c6c 792c 2072 756e 2074 6865 2063 6f6d lly, run the com │ │ │ │ │ +0000acf0: 6d61 6e64 2027 626f 6f74 2720 282a 6e6f mand 'boot' (*no │ │ │ │ │ +0000ad00: 7465 2062 6f6f 743a 3a29 2e0a 0a1f 0a46 te boot::).....F │ │ │ │ │ +0000ad10: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ +0000ad20: 204e 6f64 653a 204e 6574 4253 442c 2020 Node: NetBSD, │ │ │ │ │ +0000ad30: 4e65 7874 3a20 444f 532f 5769 6e64 6f77 Next: DOS/Window │ │ │ │ │ +0000ad40: 732c 2020 5072 6576 3a20 474e 552f 4c69 s, Prev: GNU/Li │ │ │ │ │ +0000ad50: 6e75 782c 2020 5570 3a20 4f53 2d73 7065 nux, Up: OS-spe │ │ │ │ │ +0000ad60: 6369 6669 6320 6e6f 7465 730a 0a35 2e34 cific notes..5.4 │ │ │ │ │ +0000ad70: 2e33 204e 6574 4253 440a 2d2d 2d2d 2d2d .3 NetBSD.------ │ │ │ │ │ +0000ad80: 2d2d 2d2d 2d2d 0a0a 426f 6f74 696e 6720 ------..Booting │ │ │ │ │ +0000ad90: 6120 4e65 7442 5344 206b 6572 6e65 6c20 a NetBSD kernel │ │ │ │ │ +0000ada0: 6672 6f6d 2047 5255 4220 6973 2061 6c73 from GRUB is als │ │ │ │ │ +0000adb0: 6f20 7265 6c61 7469 7665 6c79 2065 6173 o relatively eas │ │ │ │ │ +0000adc0: 793a 2066 6972 7374 2073 6574 0a47 5255 y: first set.GRU │ │ │ │ │ +0000add0: 4227 7320 726f 6f74 2064 6576 6963 652c B's root device, │ │ │ │ │ +0000ade0: 2074 6865 6e20 6c6f 6164 2074 6865 206b then load the k │ │ │ │ │ +0000adf0: 6572 6e65 6c20 616e 6420 7468 6520 6d6f ernel and the mo │ │ │ │ │ +0000ae00: 6475 6c65 732c 2061 6e64 2066 696e 616c dules, and final │ │ │ │ │ +0000ae10: 6c79 0a72 756e 2027 626f 6f74 272e 0a0a ly.run 'boot'... │ │ │ │ │ +0000ae20: 2020 312e 2053 6574 2047 5255 4227 7320 1. Set GRUB's │ │ │ │ │ +0000ae30: 726f 6f74 2064 6576 6963 6520 746f 2074 root device to t │ │ │ │ │ +0000ae40: 6865 2070 6172 7469 7469 6f6e 2068 6f6c he partition hol │ │ │ │ │ +0000ae50: 6469 6e67 2074 6865 204e 6574 4253 4420 ding the NetBSD │ │ │ │ │ +0000ae60: 726f 6f74 0a20 2020 2020 6669 6c65 2073 root. file s │ │ │ │ │ +0000ae70: 7973 7465 6d2e 2020 466f 7220 6120 6469 ystem. For a di │ │ │ │ │ +0000ae80: 736b 2077 6974 6820 6120 4e65 7442 5344 sk with a NetBSD │ │ │ │ │ +0000ae90: 2064 6973 6b20 6c61 6265 6c2c 2074 6869 disk label, thi │ │ │ │ │ +0000aea0: 7320 6973 2075 7375 616c 6c79 0a20 2020 s is usually. │ │ │ │ │ +0000aeb0: 2020 7468 6520 6669 7273 7420 7061 7274 the first part │ │ │ │ │ +0000aec0: 6974 696f 6e20 2861 3a29 2e20 2049 6e20 ition (a:). In │ │ │ │ │ +0000aed0: 7468 6174 2063 6173 652c 2061 6e64 2061 that case, and a │ │ │ │ │ +0000aee0: 7373 756d 696e 6720 7468 6174 2074 6865 ssuming that the │ │ │ │ │ +0000aef0: 0a20 2020 2020 7061 7274 6974 696f 6e20 . partition │ │ │ │ │ +0000af00: 6973 206f 6e20 7468 6520 6669 7273 7420 is on the first │ │ │ │ │ +0000af10: 6861 7264 2064 6973 6b2c 2073 6574 2047 hard disk, set G │ │ │ │ │ +0000af20: 5255 4227 7320 726f 6f74 2064 6576 6963 RUB's root devic │ │ │ │ │ +0000af30: 6520 6173 0a20 2020 2020 666f 6c6c 6f77 e as. follow │ │ │ │ │ +0000af40: 733a 0a0a 2020 2020 2020 2020 2020 6772 s:.. gr │ │ │ │ │ +0000af50: 7562 3e20 696e 736d 6f64 2070 6172 745f ub> insmod part_ │ │ │ │ │ +0000af60: 6273 640a 2020 2020 2020 2020 2020 6772 bsd. gr │ │ │ │ │ +0000af70: 7562 3e20 7365 7420 726f 6f74 3d28 6864 ub> set root=(hd │ │ │ │ │ +0000af80: 302c 6e65 7462 7364 3129 0a0a 2020 2020 0,netbsd1).. │ │ │ │ │ +0000af90: 2046 6f72 2061 2064 6973 6b20 7769 7468 For a disk with │ │ │ │ │ +0000afa0: 2061 2047 5549 4420 5061 7274 6974 696f a GUID Partitio │ │ │ │ │ +0000afb0: 6e20 5461 626c 6520 2847 5054 292c 2061 n Table (GPT), a │ │ │ │ │ +0000afc0: 6e64 2061 7373 756d 696e 6720 7468 6174 nd assuming that │ │ │ │ │ +0000afd0: 2074 6865 0a20 2020 2020 4e65 7442 5344 the. NetBSD │ │ │ │ │ +0000afe0: 2072 6f6f 7420 7061 7274 6974 696f 6e20 root partition │ │ │ │ │ +0000aff0: 6973 2074 6865 2074 6869 7264 2047 5054 is the third GPT │ │ │ │ │ +0000b000: 2070 6172 7469 7469 6f6e 2c20 646f 2074 partition, do t │ │ │ │ │ +0000b010: 6869 733a 0a0a 2020 2020 2020 2020 2020 his:.. │ │ │ │ │ +0000b020: 6772 7562 3e20 696e 736d 6f64 2070 6172 grub> insmod par │ │ │ │ │ +0000b030: 745f 6770 740a 2020 2020 2020 2020 2020 t_gpt. │ │ │ │ │ +0000b040: 6772 7562 3e20 7365 7420 726f 6f74 3d28 grub> set root=( │ │ │ │ │ +0000b050: 6864 302c 6770 7433 290a 0a20 2032 2e20 hd0,gpt3).. 2. │ │ │ │ │ +0000b060: 4c6f 6164 2074 6865 206b 6572 6e65 6c20 Load the kernel │ │ │ │ │ +0000b070: 7573 696e 6720 7468 6520 636f 6d6d 616e using the comman │ │ │ │ │ +0000b080: 6420 276b 6e65 7462 7364 273a 0a0a 2020 d 'knetbsd':.. │ │ │ │ │ +0000b090: 2020 2020 2020 2020 6772 7562 3e20 6b6e grub> kn │ │ │ │ │ +0000b0a0: 6574 6273 6420 2f6e 6574 6273 640a 0a20 etbsd /netbsd.. │ │ │ │ │ +0000b0b0: 2020 2020 5661 7269 6f75 7320 6f70 7469 Various opti │ │ │ │ │ +0000b0c0: 6f6e 7320 6d61 7920 6265 2067 6976 656e ons may be given │ │ │ │ │ +0000b0d0: 2074 6f20 276b 6e65 7462 7364 272e 2020 to 'knetbsd'. │ │ │ │ │ +0000b0e0: 5468 6573 6520 6f70 7469 6f6e 7320 6172 These options ar │ │ │ │ │ +0000b0f0: 652c 2066 6f72 0a20 2020 2020 7468 6520 e, for. the │ │ │ │ │ +0000b100: 6d6f 7374 2070 6172 742c 2074 6865 2073 most part, the s │ │ │ │ │ +0000b110: 616d 6520 6173 2069 6e20 7468 6520 4e65 ame as in the Ne │ │ │ │ │ +0000b120: 7442 5344 2062 6f6f 7420 6c6f 6164 6572 tBSD boot loader │ │ │ │ │ +0000b130: 2e20 2046 6f72 0a20 2020 2020 696e 7374 . For. inst │ │ │ │ │ +0000b140: 616e 6365 2c20 746f 2062 6f6f 7420 7468 ance, to boot th │ │ │ │ │ +0000b150: 6520 7379 7374 656d 2069 6e20 7369 6e67 e system in sing │ │ │ │ │ +0000b160: 6c65 2d75 7365 7220 6d6f 6465 2061 6e64 le-user mode and │ │ │ │ │ +0000b170: 2077 6974 6820 7665 7262 6f73 650a 2020 with verbose. │ │ │ │ │ +0000b180: 2020 206d 6573 7361 6765 732c 2064 6f20 messages, do │ │ │ │ │ +0000b190: 7468 6973 3a0a 0a20 2020 2020 2020 2020 this:.. │ │ │ │ │ +0000b1a0: 2067 7275 623e 206b 6e65 7462 7364 202f grub> knetbsd / │ │ │ │ │ +0000b1b0: 6e65 7462 7364 202d 7320 2d76 0a0a 2020 netbsd -s -v.. │ │ │ │ │ +0000b1c0: 332e 2049 6620 6e65 6564 6564 2c20 6c6f 3. If needed, lo │ │ │ │ │ +0000b1d0: 6164 206b 6572 6e65 6c20 6d6f 6475 6c65 ad kernel module │ │ │ │ │ +0000b1e0: 7320 7769 7468 2074 6865 2063 6f6d 6d61 s with the comma │ │ │ │ │ +0000b1f0: 6e64 0a20 2020 2020 276b 6e65 7462 7364 nd. 'knetbsd │ │ │ │ │ +0000b200: 5f6d 6f64 756c 655f 656c 6627 2e20 2041 _module_elf'. A │ │ │ │ │ +0000b210: 2074 7970 6963 616c 2065 7861 6d70 6c65 typical example │ │ │ │ │ +0000b220: 2069 7320 7468 6520 6d6f 6475 6c65 2066 is the module f │ │ │ │ │ +0000b230: 6f72 2074 6865 2072 6f6f 740a 2020 2020 or the root. │ │ │ │ │ +0000b240: 2066 696c 6520 7379 7374 656d 3a0a 0a20 file system:.. │ │ │ │ │ +0000b250: 2020 2020 2020 2020 2067 7275 623e 206b grub> k │ │ │ │ │ +0000b260: 6e65 7462 7364 5f6d 6f64 756c 655f 656c netbsd_module_el │ │ │ │ │ +0000b270: 6620 2f73 7461 6e64 2f61 6d64 3634 2f36 f /stand/amd64/6 │ │ │ │ │ +0000b280: 2e30 2f6d 6f64 756c 6573 2f66 6673 2f66 .0/modules/ffs/f │ │ │ │ │ +0000b290: 6673 2e6b 6d6f 640a 0a20 2034 2e20 4669 fs.kmod.. 4. Fi │ │ │ │ │ +0000b2a0: 6e61 6c6c 792c 2072 756e 2074 6865 2063 nally, run the c │ │ │ │ │ +0000b2b0: 6f6d 6d61 6e64 2027 626f 6f74 2720 282a ommand 'boot' (* │ │ │ │ │ +0000b2c0: 6e6f 7465 2062 6f6f 743a 3a29 2e0a 0a1f note boot::).... │ │ │ │ │ +0000b2d0: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ +0000b2e0: 2c20 204e 6f64 653a 2044 4f53 2f57 696e , Node: DOS/Win │ │ │ │ │ +0000b2f0: 646f 7773 2c20 2050 7265 763a 204e 6574 dows, Prev: Net │ │ │ │ │ +0000b300: 4253 442c 2020 5570 3a20 4f53 2d73 7065 BSD, Up: OS-spe │ │ │ │ │ +0000b310: 6369 6669 6320 6e6f 7465 730a 0a35 2e34 cific notes..5.4 │ │ │ │ │ +0000b320: 2e34 2044 4f53 2f57 696e 646f 7773 0a2d .4 DOS/Windows.- │ │ │ │ │ +0000b330: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ +0000b340: 0a0a 4752 5542 2063 616e 6e6f 7420 626f ..GRUB cannot bo │ │ │ │ │ +0000b350: 6f74 2044 4f53 206f 7220 5769 6e64 6f77 ot DOS or Window │ │ │ │ │ +0000b360: 7320 6469 7265 6374 6c79 2c20 736f 2079 s directly, so y │ │ │ │ │ +0000b370: 6f75 206d 7573 7420 6368 6169 6e2d 6c6f ou must chain-lo │ │ │ │ │ +0000b380: 6164 2074 6865 6d0a 282a 6e6f 7465 2043 ad them.(*note C │ │ │ │ │ +0000b390: 6861 696e 2d6c 6f61 6469 6e67 3a3a 292e hain-loading::). │ │ │ │ │ +0000b3a0: 2020 486f 7765 7665 722c 2074 6865 6972 However, their │ │ │ │ │ +0000b3b0: 2062 6f6f 7420 6c6f 6164 6572 7320 6861 boot loaders ha │ │ │ │ │ +0000b3c0: 7665 2073 6f6d 6520 6372 6974 6963 616c ve some critical │ │ │ │ │ +0000b3d0: 0a64 6566 6963 6965 6e63 6965 732c 2073 .deficiencies, s │ │ │ │ │ +0000b3e0: 6f20 6974 206d 6179 206e 6f74 2077 6f72 o it may not wor │ │ │ │ │ +0000b3f0: 6b20 746f 206a 7573 7420 6368 6169 6e2d k to just chain- │ │ │ │ │ +0000b400: 6c6f 6164 2074 6865 6d2e 2020 546f 206f load them. To o │ │ │ │ │ +0000b410: 7665 7263 6f6d 650a 7468 6520 7072 6f62 vercome.the prob │ │ │ │ │ +0000b420: 6c65 6d73 2c20 4752 5542 2070 726f 7669 lems, GRUB provi │ │ │ │ │ +0000b430: 6465 7320 796f 7520 7769 7468 2074 776f des you with two │ │ │ │ │ +0000b440: 2068 656c 7065 7220 6675 6e63 7469 6f6e helper function │ │ │ │ │ +0000b450: 732e 0a0a 2020 2049 6620 796f 7520 6861 s... If you ha │ │ │ │ │ +0000b460: 7665 2069 6e73 7461 6c6c 6564 2044 4f53 ve installed DOS │ │ │ │ │ +0000b470: 2028 6f72 2057 696e 646f 7773 2920 6f6e (or Windows) on │ │ │ │ │ +0000b480: 2061 206e 6f6e 2d66 6972 7374 2068 6172 a non-first har │ │ │ │ │ +0000b490: 6420 6469 736b 2c20 796f 750a 6861 7665 d disk, you.have │ │ │ │ │ +0000b4a0: 2074 6f20 7573 6520 7468 6520 6469 736b to use the disk │ │ │ │ │ +0000b4b0: 2073 7761 7070 696e 6720 7465 6368 6e69 swapping techni │ │ │ │ │ +0000b4c0: 7175 652c 2062 6563 6175 7365 2074 6861 que, because tha │ │ │ │ │ +0000b4d0: 7420 4f53 2063 616e 6e6f 7420 626f 6f74 t OS cannot boot │ │ │ │ │ +0000b4e0: 0a66 726f 6d20 616e 7920 6469 736b 7320 .from any disks │ │ │ │ │ +0000b4f0: 6275 7420 7468 6520 6669 7273 7420 6f6e but the first on │ │ │ │ │ +0000b500: 652e 2020 5468 6520 776f 726b 6172 6f75 e. The workarou │ │ │ │ │ +0000b510: 6e64 2075 7365 6420 696e 2047 5255 4220 nd used in GRUB │ │ │ │ │ +0000b520: 6973 2074 6865 0a63 6f6d 6d61 6e64 2027 is the.command ' │ │ │ │ │ +0000b530: 6472 6976 656d 6170 2720 282a 6e6f 7465 drivemap' (*note │ │ │ │ │ +0000b540: 2064 7269 7665 6d61 703a 3a29 2c20 6c69 drivemap::), li │ │ │ │ │ +0000b550: 6b65 2074 6869 733a 0a0a 2020 2020 2064 ke this:.. d │ │ │ │ │ +0000b560: 7269 7665 6d61 7020 2d73 2028 6864 3029 rivemap -s (hd0) │ │ │ │ │ +0000b570: 2028 6864 3129 0a0a 2020 2054 6869 7320 (hd1).. This │ │ │ │ │ +0000b580: 7065 7266 6f72 6d73 2061 2022 7669 7274 performs a "virt │ │ │ │ │ +0000b590: 7561 6c22 2073 7761 7020 6265 7477 6565 ual" swap betwee │ │ │ │ │ +0000b5a0: 6e20 796f 7572 2066 6972 7374 2061 6e64 n your first and │ │ │ │ │ +0000b5b0: 2073 6563 6f6e 6420 6861 7264 0a64 7269 second hard.dri │ │ │ │ │ +0000b5c0: 7665 2e0a 0a20 2020 2a43 6175 7469 6f6e ve... *Caution │ │ │ │ │ +0000b5d0: 3a2a 2054 6869 7320 6973 2065 6666 6563 :* This is effec │ │ │ │ │ +0000b5e0: 7469 7665 206f 6e6c 7920 6966 2044 4f53 tive only if DOS │ │ │ │ │ +0000b5f0: 2028 6f72 2057 696e 646f 7773 2920 7573 (or Windows) us │ │ │ │ │ +0000b600: 6573 2042 494f 5320 746f 0a61 6363 6573 es BIOS to.acces │ │ │ │ │ +0000b610: 7320 7468 6520 7377 6170 7065 6420 6469 s the swapped di │ │ │ │ │ +0000b620: 736b 732e 2020 4966 2074 6861 7420 4f53 sks. If that OS │ │ │ │ │ +0000b630: 2075 7365 7320 6120 7370 6563 6961 6c20 uses a special │ │ │ │ │ +0000b640: 6472 6976 6572 2066 6f72 2074 6865 0a64 driver for the.d │ │ │ │ │ +0000b650: 6973 6b73 2c20 7468 6973 2070 726f 6261 isks, this proba │ │ │ │ │ +0000b660: 626c 7920 776f 6e27 7420 776f 726b 2e0a bly won't work.. │ │ │ │ │ +0000b670: 0a20 2020 416e 6f74 6865 7220 7072 6f62 . Another prob │ │ │ │ │ +0000b680: 6c65 6d20 6172 6973 6573 2069 6620 796f lem arises if yo │ │ │ │ │ +0000b690: 7520 696e 7374 616c 6c65 6420 6d6f 7265 u installed more │ │ │ │ │ +0000b6a0: 2074 6861 6e20 6f6e 6520 7365 7420 6f66 than one set of │ │ │ │ │ +0000b6b0: 0a44 4f53 2f57 696e 646f 7773 206f 6e74 .DOS/Windows ont │ │ │ │ │ +0000b6c0: 6f20 6f6e 6520 6469 736b 2c20 6265 6361 o one disk, beca │ │ │ │ │ +0000b6d0: 7573 6520 7468 6579 2063 6f75 6c64 2062 use they could b │ │ │ │ │ +0000b6e0: 6520 636f 6e66 7573 6564 2069 6620 7468 e confused if th │ │ │ │ │ +0000b6f0: 6572 6520 6172 650a 6d6f 7265 2074 6861 ere are.more tha │ │ │ │ │ +0000b700: 6e20 6f6e 6520 7072 696d 6172 7920 7061 n one primary pa │ │ │ │ │ +0000b710: 7274 6974 696f 6e73 2066 6f72 2044 4f53 rtitions for DOS │ │ │ │ │ +0000b720: 2f57 696e 646f 7773 2e20 2043 6572 7461 /Windows. Certa │ │ │ │ │ +0000b730: 696e 6c79 2079 6f75 2073 686f 756c 640a inly you should. │ │ │ │ │ +0000b740: 6176 6f69 6420 646f 696e 6720 7468 6973 avoid doing this │ │ │ │ │ +0000b750: 2c20 6275 7420 7468 6572 6520 6973 2061 , but there is a │ │ │ │ │ +0000b760: 2073 6f6c 7574 696f 6e20 6966 2079 6f75 solution if you │ │ │ │ │ +0000b770: 2064 6f20 7761 6e74 2074 6f20 646f 2073 do want to do s │ │ │ │ │ +0000b780: 6f2e 2020 5573 650a 7468 6520 7061 7274 o. Use.the part │ │ │ │ │ +0000b790: 6974 696f 6e20 6869 6469 6e67 2f75 6e68 ition hiding/unh │ │ │ │ │ +0000b7a0: 6964 696e 6720 7465 6368 6e69 7175 652e iding technique. │ │ │ │ │ +0000b7b0: 0a0a 2020 2049 6620 4752 5542 2022 6869 .. If GRUB "hi │ │ │ │ │ +0000b7c0: 6465 7322 2061 2044 4f53 2028 6f72 2057 des" a DOS (or W │ │ │ │ │ +0000b7d0: 696e 646f 7773 2920 7061 7274 6974 696f indows) partitio │ │ │ │ │ +0000b7e0: 6e20 282a 6e6f 7465 2070 6172 7474 6f6f n (*note parttoo │ │ │ │ │ +0000b7f0: 6c3a 3a29 2c20 444f 530a 286f 7220 5769 l::), DOS.(or Wi │ │ │ │ │ +0000b800: 6e64 6f77 7329 2077 696c 6c20 6967 6e6f ndows) will igno │ │ │ │ │ +0000b810: 7265 2074 6865 2070 6172 7469 7469 6f6e re the partition │ │ │ │ │ +0000b820: 2e20 2049 6620 4752 5542 2022 756e 6869 . If GRUB "unhi │ │ │ │ │ +0000b830: 6465 7322 2061 2044 4f53 2028 6f72 0a57 des" a DOS (or.W │ │ │ │ │ +0000b840: 696e 646f 7773 2920 7061 7274 6974 696f indows) partitio │ │ │ │ │ +0000b850: 6e2c 2044 4f53 2028 6f72 2057 696e 646f n, DOS (or Windo │ │ │ │ │ +0000b860: 7773 2920 7769 6c6c 2064 6574 6563 7420 ws) will detect │ │ │ │ │ +0000b870: 7468 6520 7061 7274 6974 696f 6e2e 2020 the partition. │ │ │ │ │ +0000b880: 5468 7573 2c0a 6966 2079 6f75 2068 6176 Thus,.if you hav │ │ │ │ │ +0000b890: 6520 696e 7374 616c 6c65 6420 444f 5320 e installed DOS │ │ │ │ │ +0000b8a0: 286f 7220 5769 6e64 6f77 7329 206f 6e20 (or Windows) on │ │ │ │ │ +0000b8b0: 7468 6520 6669 7273 7420 616e 6420 7468 the first and th │ │ │ │ │ +0000b8c0: 6520 7365 636f 6e64 0a70 6172 7469 7469 e second.partiti │ │ │ │ │ +0000b8d0: 6f6e 206f 6620 7468 6520 6669 7273 7420 on of the first │ │ │ │ │ +0000b8e0: 6861 7264 2064 6973 6b2c 2061 6e64 2079 hard disk, and y │ │ │ │ │ +0000b8f0: 6f75 2077 616e 7420 746f 2062 6f6f 7420 ou want to boot │ │ │ │ │ +0000b900: 7468 6520 636f 7079 206f 6e20 7468 650a the copy on the. │ │ │ │ │ +0000b910: 6669 7273 7420 7061 7274 6974 696f 6e2c first partition, │ │ │ │ │ +0000b920: 2064 6f20 7468 6520 666f 6c6c 6f77 696e do the followin │ │ │ │ │ +0000b930: 673a 0a0a 2020 2020 2070 6172 7474 6f6f g:.. parttoo │ │ │ │ │ +0000b940: 6c20 2868 6430 2c31 2920 6869 6464 656e l (hd0,1) hidden │ │ │ │ │ +0000b950: 2d0a 2020 2020 2070 6172 7474 6f6f 6c20 -. parttool │ │ │ │ │ +0000b960: 2868 6430 2c32 2920 6869 6464 656e 2b0a (hd0,2) hidden+. │ │ │ │ │ +0000b970: 2020 2020 2073 6574 2072 6f6f 743d 2868 set root=(h │ │ │ │ │ +0000b980: 6430 2c31 290a 2020 2020 2063 6861 696e d0,1). chain │ │ │ │ │ +0000b990: 6c6f 6164 6572 202b 310a 2020 2020 2070 loader +1. p │ │ │ │ │ +0000b9a0: 6172 7474 6f6f 6c20 247b 726f 6f74 7d20 arttool ${root} │ │ │ │ │ +0000b9b0: 626f 6f74 2b0a 2020 2020 2062 6f6f 740a boot+. boot. │ │ │ │ │ +0000b9c0: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ +0000b9d0: 666f 2c20 204e 6f64 653a 2043 6f6e 6669 fo, Node: Confi │ │ │ │ │ +0000b9e0: 6775 7261 7469 6f6e 2c20 204e 6578 743a guration, Next: │ │ │ │ │ +0000b9f0: 2054 6865 6d65 2066 696c 6520 666f 726d Theme file form │ │ │ │ │ +0000ba00: 6174 2c20 2050 7265 763a 2042 6f6f 7469 at, Prev: Booti │ │ │ │ │ +0000ba10: 6e67 2c20 2055 703a 2054 6f70 0a0a 3620 ng, Up: Top..6 │ │ │ │ │ +0000ba20: 5772 6974 696e 6720 796f 7572 206f 776e Writing your own │ │ │ │ │ +0000ba30: 2063 6f6e 6669 6775 7261 7469 6f6e 2066 configuration f │ │ │ │ │ +0000ba40: 696c 650a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a ile.************ │ │ │ │ │ 0000ba50: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -0000ba60: 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a47 5255 ***********..GRU │ │ │ │ │ -0000ba70: 4220 6973 2063 6f6e 6669 6775 7265 6420 B is configured │ │ │ │ │ -0000ba80: 7573 696e 6720 2767 7275 622e 6366 6727 using 'grub.cfg' │ │ │ │ │ -0000ba90: 2c20 7573 7561 6c6c 7920 6c6f 6361 7465 , usually locate │ │ │ │ │ -0000baa0: 6420 756e 6465 7220 272f 626f 6f74 2f67 d under '/boot/g │ │ │ │ │ -0000bab0: 7275 6227 2e0a 5468 6973 2066 696c 6520 rub'..This file │ │ │ │ │ -0000bac0: 6973 2071 7569 7465 2066 6c65 7869 626c is quite flexibl │ │ │ │ │ -0000bad0: 652c 2062 7574 206d 6f73 7420 7573 6572 e, but most user │ │ │ │ │ -0000bae0: 7320 7769 6c6c 206e 6f74 206e 6565 6420 s will not need │ │ │ │ │ -0000baf0: 746f 2077 7269 7465 2074 6865 0a77 686f to write the.who │ │ │ │ │ -0000bb00: 6c65 2074 6869 6e67 2062 7920 6861 6e64 le thing by hand │ │ │ │ │ -0000bb10: 2e0a 0a2a 204d 656e 753a 0a0a 2a20 5369 ...* Menu:..* Si │ │ │ │ │ -0000bb20: 6d70 6c65 2063 6f6e 6669 6775 7261 7469 mple configurati │ │ │ │ │ -0000bb30: 6f6e 3a3a 2020 2020 2020 2020 2020 2020 on:: │ │ │ │ │ -0000bb40: 5265 636f 6d6d 656e 6465 6420 666f 7220 Recommended for │ │ │ │ │ -0000bb50: 6d6f 7374 2075 7365 7273 0a2a 2052 6f6f most users.* Roo │ │ │ │ │ -0000bb60: 7420 4964 656e 7469 6663 6174 696f 6e20 t Identifcation │ │ │ │ │ -0000bb70: 4865 7572 6973 7469 6373 3a3a 2020 2053 Heuristics:: S │ │ │ │ │ -0000bb80: 756d 6d61 7279 206f 6e20 686f 7720 7468 ummary on how th │ │ │ │ │ -0000bb90: 6520 726f 6f74 2066 696c 6520 7379 7374 e root file syst │ │ │ │ │ -0000bba0: 656d 2069 7320 6964 656e 7469 6669 6564 em is identified │ │ │ │ │ -0000bbb0: 2e0a 2a20 5368 656c 6c2d 6c69 6b65 2073 ..* Shell-like s │ │ │ │ │ -0000bbc0: 6372 6970 7469 6e67 3a3a 2020 2020 2020 cripting:: │ │ │ │ │ -0000bbd0: 2020 2020 2020 466f 7220 706f 7765 7220 For power │ │ │ │ │ -0000bbe0: 7573 6572 7320 616e 6420 6465 7665 6c6f users and develo │ │ │ │ │ -0000bbf0: 7065 7273 0a2a 204d 756c 7469 2d62 6f6f pers.* Multi-boo │ │ │ │ │ -0000bc00: 7420 6d61 6e75 616c 2063 6f6e 6669 673a t manual config: │ │ │ │ │ -0000bc10: 3a20 2020 2020 2020 2046 6f72 206e 6f6e : For non │ │ │ │ │ -0000bc20: 2d73 7461 6e64 6172 6420 6d75 6c74 692d -standard multi- │ │ │ │ │ -0000bc30: 4f53 2073 6365 6e61 7269 6f73 0a2a 2045 OS scenarios.* E │ │ │ │ │ -0000bc40: 6d62 6564 6465 6420 636f 6e66 6967 7572 mbedded configur │ │ │ │ │ -0000bc50: 6174 696f 6e3a 3a20 2020 2020 2020 2020 ation:: │ │ │ │ │ -0000bc60: 2045 6d62 6564 6469 6e67 2061 2063 6f6e Embedding a con │ │ │ │ │ -0000bc70: 6669 6775 7261 7469 6f6e 2066 696c 6520 figuration file │ │ │ │ │ -0000bc80: 696e 746f 2047 5255 420a 0a1f 0a46 696c into GRUB....Fil │ │ │ │ │ -0000bc90: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ -0000bca0: 6f64 653a 2053 696d 706c 6520 636f 6e66 ode: Simple conf │ │ │ │ │ -0000bcb0: 6967 7572 6174 696f 6e2c 2020 4e65 7874 iguration, Next │ │ │ │ │ -0000bcc0: 3a20 526f 6f74 2049 6465 6e74 6966 6361 : Root Identifca │ │ │ │ │ -0000bcd0: 7469 6f6e 2048 6575 7269 7374 6963 732c tion Heuristics, │ │ │ │ │ -0000bce0: 2020 5570 3a20 436f 6e66 6967 7572 6174 Up: Configurat │ │ │ │ │ -0000bcf0: 696f 6e0a 0a36 2e31 2053 696d 706c 6520 ion..6.1 Simple │ │ │ │ │ -0000bd00: 636f 6e66 6967 7572 6174 696f 6e20 6861 configuration ha │ │ │ │ │ -0000bd10: 6e64 6c69 6e67 0a3d 3d3d 3d3d 3d3d 3d3d ndling.========= │ │ │ │ │ +0000ba60: 2a2a 2a2a 2a2a 2a2a 2a0a 0a47 5255 4220 *********..GRUB │ │ │ │ │ +0000ba70: 6973 2063 6f6e 6669 6775 7265 6420 7573 is configured us │ │ │ │ │ +0000ba80: 696e 6720 2767 7275 622e 6366 6727 2c20 ing 'grub.cfg', │ │ │ │ │ +0000ba90: 7573 7561 6c6c 7920 6c6f 6361 7465 6420 usually located │ │ │ │ │ +0000baa0: 756e 6465 7220 272f 626f 6f74 2f67 7275 under '/boot/gru │ │ │ │ │ +0000bab0: 6227 2e0a 5468 6973 2066 696c 6520 6973 b'..This file is │ │ │ │ │ +0000bac0: 2071 7569 7465 2066 6c65 7869 626c 652c quite flexible, │ │ │ │ │ +0000bad0: 2062 7574 206d 6f73 7420 7573 6572 7320 but most users │ │ │ │ │ +0000bae0: 7769 6c6c 206e 6f74 206e 6565 6420 746f will not need to │ │ │ │ │ +0000baf0: 2077 7269 7465 2074 6865 0a77 686f 6c65 write the.whole │ │ │ │ │ +0000bb00: 2074 6869 6e67 2062 7920 6861 6e64 2e0a thing by hand.. │ │ │ │ │ +0000bb10: 0a2a 204d 656e 753a 0a0a 2a20 5369 6d70 .* Menu:..* Simp │ │ │ │ │ +0000bb20: 6c65 2063 6f6e 6669 6775 7261 7469 6f6e le configuration │ │ │ │ │ +0000bb30: 3a3a 2020 2020 2020 2020 2020 2020 5265 :: Re │ │ │ │ │ +0000bb40: 636f 6d6d 656e 6465 6420 666f 7220 6d6f commended for mo │ │ │ │ │ +0000bb50: 7374 2075 7365 7273 0a2a 2052 6f6f 7420 st users.* Root │ │ │ │ │ +0000bb60: 4964 656e 7469 6663 6174 696f 6e20 4865 Identifcation He │ │ │ │ │ +0000bb70: 7572 6973 7469 6373 3a3a 2020 2053 756d uristics:: Sum │ │ │ │ │ +0000bb80: 6d61 7279 206f 6e20 686f 7720 7468 6520 mary on how the │ │ │ │ │ +0000bb90: 726f 6f74 2066 696c 6520 7379 7374 656d root file system │ │ │ │ │ +0000bba0: 2069 7320 6964 656e 7469 6669 6564 2e0a is identified.. │ │ │ │ │ +0000bbb0: 2a20 5368 656c 6c2d 6c69 6b65 2073 6372 * Shell-like scr │ │ │ │ │ +0000bbc0: 6970 7469 6e67 3a3a 2020 2020 2020 2020 ipting:: │ │ │ │ │ +0000bbd0: 2020 2020 466f 7220 706f 7765 7220 7573 For power us │ │ │ │ │ +0000bbe0: 6572 7320 616e 6420 6465 7665 6c6f 7065 ers and develope │ │ │ │ │ +0000bbf0: 7273 0a2a 204d 756c 7469 2d62 6f6f 7420 rs.* Multi-boot │ │ │ │ │ +0000bc00: 6d61 6e75 616c 2063 6f6e 6669 673a 3a20 manual config:: │ │ │ │ │ +0000bc10: 2020 2020 2020 2046 6f72 206e 6f6e 2d73 For non-s │ │ │ │ │ +0000bc20: 7461 6e64 6172 6420 6d75 6c74 692d 4f53 tandard multi-OS │ │ │ │ │ +0000bc30: 2073 6365 6e61 7269 6f73 0a2a 2045 6d62 scenarios.* Emb │ │ │ │ │ +0000bc40: 6564 6465 6420 636f 6e66 6967 7572 6174 edded configurat │ │ │ │ │ +0000bc50: 696f 6e3a 3a20 2020 2020 2020 2020 2045 ion:: E │ │ │ │ │ +0000bc60: 6d62 6564 6469 6e67 2061 2063 6f6e 6669 mbedding a confi │ │ │ │ │ +0000bc70: 6775 7261 7469 6f6e 2066 696c 6520 696e guration file in │ │ │ │ │ +0000bc80: 746f 2047 5255 420a 0a1f 0a46 696c 653a to GRUB....File: │ │ │ │ │ +0000bc90: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ +0000bca0: 653a 2053 696d 706c 6520 636f 6e66 6967 e: Simple config │ │ │ │ │ +0000bcb0: 7572 6174 696f 6e2c 2020 4e65 7874 3a20 uration, Next: │ │ │ │ │ +0000bcc0: 526f 6f74 2049 6465 6e74 6966 6361 7469 Root Identifcati │ │ │ │ │ +0000bcd0: 6f6e 2048 6575 7269 7374 6963 732c 2020 on Heuristics, │ │ │ │ │ +0000bce0: 5570 3a20 436f 6e66 6967 7572 6174 696f Up: Configuratio │ │ │ │ │ +0000bcf0: 6e0a 0a36 2e31 2053 696d 706c 6520 636f n..6.1 Simple co │ │ │ │ │ +0000bd00: 6e66 6967 7572 6174 696f 6e20 6861 6e64 nfiguration hand │ │ │ │ │ +0000bd10: 6c69 6e67 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d ling.=========== │ │ │ │ │ 0000bd20: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0000bd30: 3d3d 3d3d 3d3d 3d3d 0a0a 5468 6520 7072 ========..The pr │ │ │ │ │ -0000bd40: 6f67 7261 6d20 2767 7275 622d 6d6b 636f ogram 'grub-mkco │ │ │ │ │ -0000bd50: 6e66 6967 2720 282a 6e6f 7465 2049 6e76 nfig' (*note Inv │ │ │ │ │ -0000bd60: 6f6b 696e 6720 6772 7562 2d6d 6b63 6f6e oking grub-mkcon │ │ │ │ │ -0000bd70: 6669 673a 3a29 2067 656e 6572 6174 6573 fig::) generates │ │ │ │ │ -0000bd80: 0a27 6772 7562 2e63 6667 2720 6669 6c65 .'grub.cfg' file │ │ │ │ │ -0000bd90: 7320 7375 6974 6162 6c65 2066 6f72 206d s suitable for m │ │ │ │ │ -0000bda0: 6f73 7420 6361 7365 732e 2020 4974 2069 ost cases. It i │ │ │ │ │ -0000bdb0: 7320 7375 6974 6162 6c65 2066 6f72 2075 s suitable for u │ │ │ │ │ -0000bdc0: 7365 2077 6865 6e0a 7570 6772 6164 696e se when.upgradin │ │ │ │ │ -0000bdd0: 6720 6120 6469 7374 7269 6275 7469 6f6e g a distribution │ │ │ │ │ -0000bde0: 2c20 616e 6420 7769 6c6c 2064 6973 636f , and will disco │ │ │ │ │ -0000bdf0: 7665 7220 6176 6169 6c61 626c 6520 6b65 ver available ke │ │ │ │ │ -0000be00: 726e 656c 7320 616e 640a 6174 7465 6d70 rnels and.attemp │ │ │ │ │ -0000be10: 7420 746f 2067 656e 6572 6174 6520 6d65 t to generate me │ │ │ │ │ -0000be20: 6e75 2065 6e74 7269 6573 2066 6f72 2074 nu entries for t │ │ │ │ │ -0000be30: 6865 6d2e 0a0a 2020 2027 6772 7562 2d6d hem... 'grub-m │ │ │ │ │ -0000be40: 6b63 6f6e 6669 6727 2064 6f65 7320 6861 kconfig' does ha │ │ │ │ │ -0000be50: 7665 2073 6f6d 6520 6c69 6d69 7461 7469 ve some limitati │ │ │ │ │ -0000be60: 6f6e 732e 2020 5768 696c 6520 6164 6469 ons. While addi │ │ │ │ │ -0000be70: 6e67 2065 7874 7261 0a63 7573 746f 6d20 ng extra.custom │ │ │ │ │ -0000be80: 6d65 6e75 2065 6e74 7269 6573 2074 6f20 menu entries to │ │ │ │ │ -0000be90: 7468 6520 656e 6420 6f66 2074 6865 206c the end of the l │ │ │ │ │ -0000bea0: 6973 7420 6361 6e20 6265 2064 6f6e 6520 ist can be done │ │ │ │ │ -0000beb0: 6279 2065 6469 7469 6e67 0a27 2f65 7463 by editing.'/etc │ │ │ │ │ -0000bec0: 2f67 7275 622e 642f 3430 5f63 7573 746f /grub.d/40_custo │ │ │ │ │ -0000bed0: 6d27 206f 7220 6372 6561 7469 6e67 2027 m' or creating ' │ │ │ │ │ -0000bee0: 2f62 6f6f 742f 6772 7562 2f63 7573 746f /boot/grub/custo │ │ │ │ │ -0000bef0: 6d2e 6366 6727 2c20 6368 616e 6769 6e67 m.cfg', changing │ │ │ │ │ -0000bf00: 0a74 6865 206f 7264 6572 206f 6620 6d65 .the order of me │ │ │ │ │ -0000bf10: 6e75 2065 6e74 7269 6573 206f 7220 6368 nu entries or ch │ │ │ │ │ -0000bf20: 616e 6769 6e67 2074 6865 6972 2074 6974 anging their tit │ │ │ │ │ -0000bf30: 6c65 7320 6d61 7920 7265 7175 6972 6520 les may require │ │ │ │ │ -0000bf40: 6d61 6b69 6e67 0a63 6f6d 706c 6578 2063 making.complex c │ │ │ │ │ -0000bf50: 6861 6e67 6573 2074 6f20 7368 656c 6c20 hanges to shell │ │ │ │ │ -0000bf60: 7363 7269 7074 7320 7374 6f72 6564 2069 scripts stored i │ │ │ │ │ -0000bf70: 6e20 272f 6574 632f 6772 7562 2e64 2f27 n '/etc/grub.d/' │ │ │ │ │ -0000bf80: 2e20 2054 6869 7320 6d61 7920 6265 0a69 . This may be.i │ │ │ │ │ -0000bf90: 6d70 726f 7665 6420 696e 2074 6865 2066 mproved in the f │ │ │ │ │ -0000bfa0: 7574 7572 652e 2020 496e 2074 6865 206d uture. In the m │ │ │ │ │ -0000bfb0: 6561 6e74 696d 652c 2074 686f 7365 2077 eantime, those w │ │ │ │ │ -0000bfc0: 686f 2066 6565 6c20 7468 6174 2069 7420 ho feel that it │ │ │ │ │ -0000bfd0: 776f 756c 640a 6265 2065 6173 6965 7220 would.be easier │ │ │ │ │ -0000bfe0: 746f 2077 7269 7465 2027 6772 7562 2e63 to write 'grub.c │ │ │ │ │ -0000bff0: 6667 2720 6469 7265 6374 6c79 2061 7265 fg' directly are │ │ │ │ │ -0000c000: 2065 6e63 6f75 7261 6765 6420 746f 2064 encouraged to d │ │ │ │ │ -0000c010: 6f20 736f 2028 2a6e 6f74 650a 426f 6f74 o so (*note.Boot │ │ │ │ │ -0000c020: 696e 673a 3a2c 2061 6e64 202a 6e6f 7465 ing::, and *note │ │ │ │ │ -0000c030: 2053 6865 6c6c 2d6c 696b 6520 7363 7269 Shell-like scri │ │ │ │ │ -0000c040: 7074 696e 673a 3a29 2c20 616e 6420 746f pting::), and to │ │ │ │ │ -0000c050: 2064 6973 6162 6c65 2061 6e79 2073 7973 disable any sys │ │ │ │ │ -0000c060: 7465 6d0a 7072 6f76 6964 6564 2062 7920 tem.provided by │ │ │ │ │ -0000c070: 7468 6569 7220 6469 7374 7269 6275 7469 their distributi │ │ │ │ │ -0000c080: 6f6e 2074 6f20 6175 746f 6d61 7469 6361 on to automatica │ │ │ │ │ -0000c090: 6c6c 7920 7275 6e20 2767 7275 622d 6d6b lly run 'grub-mk │ │ │ │ │ -0000c0a0: 636f 6e66 6967 272e 0a0a 2020 2054 6865 config'... The │ │ │ │ │ -0000c0b0: 2066 696c 6520 272f 6574 632f 6465 6661 file '/etc/defa │ │ │ │ │ -0000c0c0: 756c 742f 6772 7562 2720 636f 6e74 726f ult/grub' contro │ │ │ │ │ -0000c0d0: 6c73 2074 6865 206f 7065 7261 7469 6f6e ls the operation │ │ │ │ │ -0000c0e0: 206f 660a 2767 7275 622d 6d6b 636f 6e66 of.'grub-mkconf │ │ │ │ │ -0000c0f0: 6967 272e 2020 4974 2069 7320 736f 7572 ig'. It is sour │ │ │ │ │ -0000c100: 6365 6420 6279 2061 2073 6865 6c6c 2073 ced by a shell s │ │ │ │ │ -0000c110: 6372 6970 742c 2061 6e64 2073 6f20 6d75 cript, and so mu │ │ │ │ │ -0000c120: 7374 2062 6520 7661 6c69 640a 504f 5349 st be valid.POSI │ │ │ │ │ -0000c130: 5820 7368 656c 6c20 696e 7075 743b 206e X shell input; n │ │ │ │ │ -0000c140: 6f72 6d61 6c6c 792c 2069 7420 7769 6c6c ormally, it will │ │ │ │ │ -0000c150: 206a 7573 7420 6265 2061 2073 6571 7565 just be a seque │ │ │ │ │ -0000c160: 6e63 6520 6f66 2027 4b45 593d 7661 6c75 nce of 'KEY=valu │ │ │ │ │ -0000c170: 6527 0a6c 696e 6573 2c20 6275 7420 6966 e'.lines, but if │ │ │ │ │ -0000c180: 2074 6865 2076 616c 7565 2063 6f6e 7461 the value conta │ │ │ │ │ -0000c190: 696e 7320 7370 6163 6573 206f 7220 6f74 ins spaces or ot │ │ │ │ │ -0000c1a0: 6865 7220 7370 6563 6961 6c20 6368 6172 her special char │ │ │ │ │ -0000c1b0: 6163 7465 7273 2074 6865 6e0a 6974 206d acters then.it m │ │ │ │ │ -0000c1c0: 7573 7420 6265 2071 756f 7465 642e 2020 ust be quoted. │ │ │ │ │ -0000c1d0: 466f 7220 6578 616d 706c 653a 0a0a 2020 For example:.. │ │ │ │ │ -0000c1e0: 2020 2047 5255 425f 5445 524d 494e 414c GRUB_TERMINAL │ │ │ │ │ -0000c1f0: 5f49 4e50 5554 3d22 636f 6e73 6f6c 6520 _INPUT="console │ │ │ │ │ -0000c200: 7365 7269 616c 220a 0a20 2020 5661 6c69 serial".. Vali │ │ │ │ │ -0000c210: 6420 6b65 7973 2069 6e20 272f 6574 632f d keys in '/etc/ │ │ │ │ │ -0000c220: 6465 6661 756c 742f 6772 7562 2720 6172 default/grub' ar │ │ │ │ │ -0000c230: 6520 6173 2066 6f6c 6c6f 7773 3a0a 0a27 e as follows:..' │ │ │ │ │ -0000c240: 4752 5542 5f44 4546 4155 4c54 270a 2020 GRUB_DEFAULT'. │ │ │ │ │ -0000c250: 2020 2054 6865 2064 6566 6175 6c74 206d The default m │ │ │ │ │ -0000c260: 656e 7520 656e 7472 792e 2020 5468 6973 enu entry. This │ │ │ │ │ -0000c270: 206d 6179 2062 6520 6120 6e75 6d62 6572 may be a number │ │ │ │ │ -0000c280: 2c20 696e 2077 6869 6368 2063 6173 6520 , in which case │ │ │ │ │ -0000c290: 6974 0a20 2020 2020 6964 656e 7469 6669 it. identifi │ │ │ │ │ -0000c2a0: 6573 2074 6865 204e 7468 2065 6e74 7279 es the Nth entry │ │ │ │ │ -0000c2b0: 2069 6e20 7468 6520 6765 6e65 7261 7465 in the generate │ │ │ │ │ -0000c2c0: 6420 6d65 6e75 2063 6f75 6e74 6564 2066 d menu counted f │ │ │ │ │ -0000c2d0: 726f 6d20 7a65 726f 2c0a 2020 2020 206f rom zero,. o │ │ │ │ │ -0000c2e0: 7220 7468 6520 7469 746c 6520 6f66 2061 r the title of a │ │ │ │ │ -0000c2f0: 206d 656e 7520 656e 7472 792c 206f 7220 menu entry, or │ │ │ │ │ -0000c300: 7468 6520 7370 6563 6961 6c20 7374 7269 the special stri │ │ │ │ │ -0000c310: 6e67 2027 7361 7665 6427 2e20 2055 7369 ng 'saved'. Usi │ │ │ │ │ -0000c320: 6e67 0a20 2020 2020 7468 6520 6964 206d ng. the id m │ │ │ │ │ -0000c330: 6179 2062 6520 7573 6566 756c 2069 6620 ay be useful if │ │ │ │ │ -0000c340: 796f 7520 7761 6e74 2074 6f20 7365 7420 you want to set │ │ │ │ │ -0000c350: 6120 6d65 6e75 2065 6e74 7279 2061 7320 a menu entry as │ │ │ │ │ -0000c360: 7468 6520 6465 6661 756c 740a 2020 2020 the default. │ │ │ │ │ -0000c370: 2065 7665 6e20 7468 6f75 6768 2074 6865 even though the │ │ │ │ │ -0000c380: 7265 206d 6179 2062 6520 6120 7661 7269 re may be a vari │ │ │ │ │ -0000c390: 6162 6c65 206e 756d 6265 7220 6f66 2065 able number of e │ │ │ │ │ -0000c3a0: 6e74 7269 6573 2062 6566 6f72 6520 6974 ntries before it │ │ │ │ │ -0000c3b0: 2e0a 0a20 2020 2020 466f 7220 6578 616d ... For exam │ │ │ │ │ -0000c3c0: 706c 652c 2069 6620 796f 7520 6861 7665 ple, if you have │ │ │ │ │ -0000c3d0: 3a0a 0a20 2020 2020 6d65 6e75 656e 7472 :.. menuentr │ │ │ │ │ -0000c3e0: 7920 2745 7861 6d70 6c65 2047 4e55 2f4c y 'Example GNU/L │ │ │ │ │ -0000c3f0: 696e 7578 2064 6973 7472 6962 7574 696f inux distributio │ │ │ │ │ -0000c400: 6e27 202d 2d63 6c61 7373 2067 6e75 2d6c n' --class gnu-l │ │ │ │ │ -0000c410: 696e 7578 202d 2d69 6420 6578 616d 706c inux --id exampl │ │ │ │ │ -0000c420: 652d 676e 752d 6c69 6e75 7820 7b0a 2020 e-gnu-linux {. │ │ │ │ │ -0000c430: 2020 2009 2e2e 2e0a 2020 2020 207d 0a0a ..... }.. │ │ │ │ │ -0000c440: 2020 2020 2074 6865 6e20 796f 7520 6361 then you ca │ │ │ │ │ -0000c450: 6e20 6d61 6b65 2074 6869 7320 7468 6520 n make this the │ │ │ │ │ -0000c460: 6465 6661 756c 7420 7573 696e 673a 0a0a default using:.. │ │ │ │ │ -0000c470: 2020 2020 2020 2020 2020 4752 5542 5f44 GRUB_D │ │ │ │ │ -0000c480: 4546 4155 4c54 3d65 7861 6d70 6c65 2d67 EFAULT=example-g │ │ │ │ │ -0000c490: 6e75 2d6c 696e 7578 0a0a 2020 2020 2050 nu-linux.. P │ │ │ │ │ -0000c4a0: 7265 7669 6f75 736c 7920 6974 2077 6173 reviously it was │ │ │ │ │ -0000c4b0: 2064 6f63 756d 656e 7465 6420 7468 6520 documented the │ │ │ │ │ -0000c4c0: 7761 7920 746f 2075 7365 2065 6e74 7279 way to use entry │ │ │ │ │ -0000c4d0: 2074 6974 6c65 2e20 2057 6869 6c65 0a20 title. While. │ │ │ │ │ -0000c4e0: 2020 2020 7468 6973 2073 7469 6c6c 2077 this still w │ │ │ │ │ -0000c4f0: 6f72 6b73 2069 7427 7320 6e6f 7420 7265 orks it's not re │ │ │ │ │ -0000c500: 636f 6d6d 656e 6465 6420 7369 6e63 6520 commended since │ │ │ │ │ -0000c510: 7469 746c 6573 206f 6674 656e 2063 6f6e titles often con │ │ │ │ │ -0000c520: 7461 696e 0a20 2020 2020 756e 7374 6162 tain. unstab │ │ │ │ │ -0000c530: 6c65 2064 6576 6963 6520 6e61 6d65 7320 le device names │ │ │ │ │ -0000c540: 616e 6420 6d61 7920 6265 2074 7261 6e73 and may be trans │ │ │ │ │ -0000c550: 6c61 7465 640a 0a20 2020 2020 4966 2079 lated.. If y │ │ │ │ │ -0000c560: 6f75 2073 6574 2074 6869 7320 746f 2027 ou set this to ' │ │ │ │ │ -0000c570: 7361 7665 6427 2c20 7468 656e 2074 6865 saved', then the │ │ │ │ │ -0000c580: 2064 6566 6175 6c74 206d 656e 7520 656e default menu en │ │ │ │ │ -0000c590: 7472 7920 7769 6c6c 2062 650a 2020 2020 try will be. │ │ │ │ │ -0000c5a0: 2074 6861 7420 7361 7665 6420 6279 2027 that saved by ' │ │ │ │ │ -0000c5b0: 4752 5542 5f53 4156 4544 4546 4155 4c54 GRUB_SAVEDEFAULT │ │ │ │ │ -0000c5c0: 2720 6f72 2027 6772 7562 2d73 6574 2d64 ' or 'grub-set-d │ │ │ │ │ -0000c5d0: 6566 6175 6c74 272e 2020 5468 6973 0a20 efault'. This. │ │ │ │ │ -0000c5e0: 2020 2020 7265 6c69 6573 206f 6e20 7468 relies on th │ │ │ │ │ -0000c5f0: 6520 656e 7669 726f 6e6d 656e 7420 626c e environment bl │ │ │ │ │ -0000c600: 6f63 6b2c 2077 6869 6368 206d 6179 206e ock, which may n │ │ │ │ │ -0000c610: 6f74 2062 6520 6176 6169 6c61 626c 6520 ot be available │ │ │ │ │ -0000c620: 696e 2061 6c6c 0a20 2020 2020 7369 7475 in all. situ │ │ │ │ │ -0000c630: 6174 696f 6e73 2028 2a6e 6f74 6520 456e ations (*note En │ │ │ │ │ -0000c640: 7669 726f 6e6d 656e 7420 626c 6f63 6b3a vironment block: │ │ │ │ │ -0000c650: 3a29 2e0a 0a20 2020 2020 5468 6520 6465 :)... The de │ │ │ │ │ -0000c660: 6661 756c 7420 6973 2027 3027 2e0a 0a27 fault is '0'...' │ │ │ │ │ -0000c670: 4752 5542 5f53 4156 4544 4546 4155 4c54 GRUB_SAVEDEFAULT │ │ │ │ │ -0000c680: 270a 2020 2020 2049 6620 7468 6973 206f '. If this o │ │ │ │ │ -0000c690: 7074 696f 6e20 6973 2073 6574 2074 6f20 ption is set to │ │ │ │ │ -0000c6a0: 2774 7275 6527 2c20 7468 656e 2c20 7768 'true', then, wh │ │ │ │ │ -0000c6b0: 656e 2061 6e20 656e 7472 7920 6973 2073 en an entry is s │ │ │ │ │ -0000c6c0: 656c 6563 7465 642c 0a20 2020 2020 7361 elected,. sa │ │ │ │ │ -0000c6d0: 7665 2069 7420 6173 2061 206e 6577 2064 ve it as a new d │ │ │ │ │ -0000c6e0: 6566 6175 6c74 2065 6e74 7279 2066 6f72 efault entry for │ │ │ │ │ -0000c6f0: 2075 7365 2062 7920 6675 7475 7265 2072 use by future r │ │ │ │ │ -0000c700: 756e 7320 6f66 2047 5255 422e 2054 6869 uns of GRUB. Thi │ │ │ │ │ -0000c710: 730a 2020 2020 2069 7320 6f6e 6c79 2075 s. is only u │ │ │ │ │ -0000c720: 7365 6675 6c20 6966 2027 4752 5542 5f44 seful if 'GRUB_D │ │ │ │ │ -0000c730: 4546 4155 4c54 3d73 6176 6564 273b 2069 EFAULT=saved'; i │ │ │ │ │ -0000c740: 7420 6973 2061 2073 6570 6172 6174 6520 t is a separate │ │ │ │ │ -0000c750: 6f70 7469 6f6e 0a20 2020 2020 6265 6361 option. beca │ │ │ │ │ -0000c760: 7573 6520 2747 5255 425f 4445 4641 554c use 'GRUB_DEFAUL │ │ │ │ │ -0000c770: 543d 7361 7665 6427 2069 7320 7573 6566 T=saved' is usef │ │ │ │ │ -0000c780: 756c 2077 6974 686f 7574 2074 6869 7320 ul without this │ │ │ │ │ -0000c790: 6f70 7469 6f6e 2c20 696e 0a20 2020 2020 option, in. │ │ │ │ │ -0000c7a0: 636f 6e6a 756e 6374 696f 6e20 7769 7468 conjunction with │ │ │ │ │ -0000c7b0: 2027 6772 7562 2d73 6574 2d64 6566 6175 'grub-set-defau │ │ │ │ │ -0000c7c0: 6c74 272e 2020 556e 7365 7420 6279 2064 lt'. Unset by d │ │ │ │ │ -0000c7d0: 6566 6175 6c74 2e20 2054 6869 730a 2020 efault. This. │ │ │ │ │ -0000c7e0: 2020 206f 7074 696f 6e20 7265 6c69 6573 option relies │ │ │ │ │ -0000c7f0: 206f 6e20 7468 6520 656e 7669 726f 6e6d on the environm │ │ │ │ │ -0000c800: 656e 7420 626c 6f63 6b2c 2077 6869 6368 ent block, which │ │ │ │ │ -0000c810: 206d 6179 206e 6f74 2062 6520 6176 6169 may not be avai │ │ │ │ │ -0000c820: 6c61 626c 650a 2020 2020 2069 6e20 616c lable. in al │ │ │ │ │ -0000c830: 6c20 7369 7475 6174 696f 6e73 2028 2a6e l situations (*n │ │ │ │ │ -0000c840: 6f74 6520 456e 7669 726f 6e6d 656e 7420 ote Environment │ │ │ │ │ -0000c850: 626c 6f63 6b3a 3a29 2e0a 0a27 4752 5542 block::)...'GRUB │ │ │ │ │ -0000c860: 5f54 494d 454f 5554 270a 2020 2020 2042 _TIMEOUT'. B │ │ │ │ │ -0000c870: 6f6f 7420 7468 6520 6465 6661 756c 7420 oot the default │ │ │ │ │ -0000c880: 656e 7472 7920 7468 6973 206d 616e 7920 entry this many │ │ │ │ │ -0000c890: 7365 636f 6e64 7320 6166 7465 7220 7468 seconds after th │ │ │ │ │ -0000c8a0: 6520 6d65 6e75 2069 730a 2020 2020 2064 e menu is. d │ │ │ │ │ -0000c8b0: 6973 706c 6179 6564 2c20 756e 6c65 7373 isplayed, unless │ │ │ │ │ -0000c8c0: 2061 206b 6579 2069 7320 7072 6573 7365 a key is presse │ │ │ │ │ -0000c8d0: 642e 2020 5468 6520 6465 6661 756c 7420 d. The default │ │ │ │ │ -0000c8e0: 6973 2027 3527 2e20 2053 6574 2074 6f0a is '5'. Set to. │ │ │ │ │ -0000c8f0: 2020 2020 2027 3027 2074 6f20 626f 6f74 '0' to boot │ │ │ │ │ -0000c900: 2069 6d6d 6564 6961 7465 6c79 2077 6974 immediately wit │ │ │ │ │ -0000c910: 686f 7574 2064 6973 706c 6179 696e 6720 hout displaying │ │ │ │ │ -0000c920: 7468 6520 6d65 6e75 2c20 6f72 2074 6f20 the menu, or to │ │ │ │ │ -0000c930: 272d 3127 2074 6f0a 2020 2020 2077 6169 '-1' to. wai │ │ │ │ │ -0000c940: 7420 696e 6465 6669 6e69 7465 6c79 2e0a t indefinitely.. │ │ │ │ │ -0000c950: 0a20 2020 2020 4966 2027 4752 5542 5f54 . If 'GRUB_T │ │ │ │ │ -0000c960: 494d 454f 5554 5f53 5459 4c45 2720 6973 IMEOUT_STYLE' is │ │ │ │ │ -0000c970: 2073 6574 2074 6f20 2763 6f75 6e74 646f set to 'countdo │ │ │ │ │ -0000c980: 776e 2720 6f72 2027 6869 6464 656e 272c wn' or 'hidden', │ │ │ │ │ -0000c990: 2074 6865 0a20 2020 2020 7469 6d65 6f75 the. timeou │ │ │ │ │ -0000c9a0: 7420 6973 2069 6e73 7465 6164 2063 6f75 t is instead cou │ │ │ │ │ -0000c9b0: 6e74 6564 2062 6566 6f72 6520 7468 6520 nted before the │ │ │ │ │ -0000c9c0: 6d65 6e75 2069 7320 6469 7370 6c61 7965 menu is displaye │ │ │ │ │ -0000c9d0: 642e 0a0a 2747 5255 425f 5449 4d45 4f55 d...'GRUB_TIMEOU │ │ │ │ │ -0000c9e0: 545f 5354 594c 4527 0a20 2020 2020 4966 T_STYLE'. If │ │ │ │ │ -0000c9f0: 2074 6869 7320 6f70 7469 6f6e 2069 7320 this option is │ │ │ │ │ -0000ca00: 756e 7365 7420 6f72 2073 6574 2074 6f20 unset or set to │ │ │ │ │ -0000ca10: 276d 656e 7527 2c20 7468 656e 2047 5255 'menu', then GRU │ │ │ │ │ -0000ca20: 4220 7769 6c6c 2064 6973 706c 6179 0a20 B will display. │ │ │ │ │ -0000ca30: 2020 2020 7468 6520 6d65 6e75 2061 6e64 the menu and │ │ │ │ │ -0000ca40: 2074 6865 6e20 7761 6974 2066 6f72 2074 then wait for t │ │ │ │ │ -0000ca50: 6865 2074 696d 656f 7574 2073 6574 2062 he timeout set b │ │ │ │ │ -0000ca60: 7920 2747 5255 425f 5449 4d45 4f55 5427 y 'GRUB_TIMEOUT' │ │ │ │ │ -0000ca70: 2074 6f0a 2020 2020 2065 7870 6972 6520 to. expire │ │ │ │ │ -0000ca80: 6265 666f 7265 2062 6f6f 7469 6e67 2074 before booting t │ │ │ │ │ -0000ca90: 6865 2064 6566 6175 6c74 2065 6e74 7279 he default entry │ │ │ │ │ -0000caa0: 2e20 2050 7265 7373 696e 6720 6120 6b65 . Pressing a ke │ │ │ │ │ -0000cab0: 7920 696e 7465 7272 7570 7473 0a20 2020 y interrupts. │ │ │ │ │ -0000cac0: 2020 7468 6520 7469 6d65 6f75 742e 0a0a the timeout... │ │ │ │ │ -0000cad0: 2020 2020 2049 6620 7468 6973 206f 7074 If this opt │ │ │ │ │ -0000cae0: 696f 6e20 6973 2073 6574 2074 6f20 2763 ion is set to 'c │ │ │ │ │ -0000caf0: 6f75 6e74 646f 776e 2720 6f72 2027 6869 ountdown' or 'hi │ │ │ │ │ -0000cb00: 6464 656e 272c 2074 6865 6e2c 2062 6566 dden', then, bef │ │ │ │ │ -0000cb10: 6f72 650a 2020 2020 2064 6973 706c 6179 ore. display │ │ │ │ │ -0000cb20: 696e 6720 7468 6520 6d65 6e75 2c20 4752 ing the menu, GR │ │ │ │ │ -0000cb30: 5542 2077 696c 6c20 7761 6974 2066 6f72 UB will wait for │ │ │ │ │ -0000cb40: 2074 6865 2074 696d 656f 7574 2073 6574 the timeout set │ │ │ │ │ -0000cb50: 2062 790a 2020 2020 2027 4752 5542 5f54 by. 'GRUB_T │ │ │ │ │ -0000cb60: 494d 454f 5554 2720 746f 2065 7870 6972 IMEOUT' to expir │ │ │ │ │ -0000cb70: 652e 2020 4966 203c 4553 433e 206f 7220 e. If or │ │ │ │ │ -0000cb80: 3c46 343e 2061 7265 2070 7265 7373 6564 are pressed │ │ │ │ │ -0000cb90: 2c20 6f72 203c 5348 4946 543e 0a20 2020 , or . │ │ │ │ │ -0000cba0: 2020 6973 2068 656c 6420 646f 776e 2064 is held down d │ │ │ │ │ -0000cbb0: 7572 696e 6720 7468 6174 2074 696d 652c uring that time, │ │ │ │ │ -0000cbc0: 2069 7420 7769 6c6c 2064 6973 706c 6179 it will display │ │ │ │ │ -0000cbd0: 2074 6865 206d 656e 7520 616e 6420 7761 the menu and wa │ │ │ │ │ -0000cbe0: 6974 0a20 2020 2020 666f 7220 696e 7075 it. for inpu │ │ │ │ │ -0000cbf0: 742e 2020 4966 2061 2068 6f74 6b65 7920 t. If a hotkey │ │ │ │ │ -0000cc00: 6173 736f 6369 6174 6564 2077 6974 6820 associated with │ │ │ │ │ -0000cc10: 6120 6d65 6e75 2065 6e74 7279 2069 7320 a menu entry is │ │ │ │ │ -0000cc20: 7072 6573 7365 642c 2069 740a 2020 2020 pressed, it. │ │ │ │ │ -0000cc30: 2077 696c 6c20 626f 6f74 2074 6865 2061 will boot the a │ │ │ │ │ -0000cc40: 7373 6f63 6961 7465 6420 6d65 6e75 2065 ssociated menu e │ │ │ │ │ -0000cc50: 6e74 7279 2069 6d6d 6564 6961 7465 6c79 ntry immediately │ │ │ │ │ -0000cc60: 2e20 2049 6620 7468 6520 7469 6d65 6f75 . If the timeou │ │ │ │ │ -0000cc70: 740a 2020 2020 2065 7870 6972 6573 2062 t. expires b │ │ │ │ │ -0000cc80: 6566 6f72 6520 6569 7468 6572 206f 6620 efore either of │ │ │ │ │ -0000cc90: 7468 6573 6520 6861 7070 656e 732c 2069 these happens, i │ │ │ │ │ -0000cca0: 7420 7769 6c6c 2062 6f6f 7420 7468 6520 t will boot the │ │ │ │ │ -0000ccb0: 6465 6661 756c 740a 2020 2020 2065 6e74 default. ent │ │ │ │ │ -0000ccc0: 7279 2e20 2049 6e20 7468 6520 2763 6f75 ry. In the 'cou │ │ │ │ │ -0000ccd0: 6e74 646f 776e 2720 6361 7365 2c20 6974 ntdown' case, it │ │ │ │ │ -0000cce0: 2077 696c 6c20 7368 6f77 2061 206f 6e65 will show a one │ │ │ │ │ -0000ccf0: 2d6c 696e 6520 696e 6469 6361 7469 6f6e -line indication │ │ │ │ │ -0000cd00: 0a20 2020 2020 6f66 2074 6865 2072 656d . of the rem │ │ │ │ │ -0000cd10: 6169 6e69 6e67 2074 696d 652e 0a0a 2747 aining time...'G │ │ │ │ │ -0000cd20: 5255 425f 4445 4641 554c 545f 4255 5454 RUB_DEFAULT_BUTT │ │ │ │ │ -0000cd30: 4f4e 270a 2747 5255 425f 5449 4d45 4f55 ON'.'GRUB_TIMEOU │ │ │ │ │ -0000cd40: 545f 4255 5454 4f4e 270a 2747 5255 425f T_BUTTON'.'GRUB_ │ │ │ │ │ -0000cd50: 5449 4d45 4f55 545f 5354 594c 455f 4255 TIMEOUT_STYLE_BU │ │ │ │ │ -0000cd60: 5454 4f4e 270a 2747 5255 425f 4255 5454 TTON'.'GRUB_BUTT │ │ │ │ │ -0000cd70: 4f4e 5f43 4d4f 535f 4144 4452 4553 5327 ON_CMOS_ADDRESS' │ │ │ │ │ -0000cd80: 0a20 2020 2020 5661 7269 616e 7473 206f . Variants o │ │ │ │ │ -0000cd90: 6620 7468 6520 636f 7272 6573 706f 6e64 f the correspond │ │ │ │ │ -0000cda0: 696e 6720 7661 7269 6162 6c65 7320 7769 ing variables wi │ │ │ │ │ -0000cdb0: 7468 6f75 7420 7468 6520 275f 4255 5454 thout the '_BUTT │ │ │ │ │ -0000cdc0: 4f4e 270a 2020 2020 2073 7566 6669 782c ON'. suffix, │ │ │ │ │ -0000cdd0: 2075 7365 6420 746f 2073 7570 706f 7274 used to support │ │ │ │ │ -0000cde0: 2076 656e 646f 722d 7370 6563 6966 6963 vendor-specific │ │ │ │ │ -0000cdf0: 2070 6f77 6572 2062 7574 746f 6e73 2e20 power buttons. │ │ │ │ │ -0000ce00: 202a 4e6f 7465 0a20 2020 2020 5665 6e64 *Note. Vend │ │ │ │ │ -0000ce10: 6f72 2070 6f77 6572 2d6f 6e20 6b65 7973 or power-on keys │ │ │ │ │ -0000ce20: 3a3a 2e0a 0a27 4752 5542 5f44 4953 5452 ::...'GRUB_DISTR │ │ │ │ │ -0000ce30: 4942 5554 4f52 270a 2020 2020 2053 6574 IBUTOR'. Set │ │ │ │ │ -0000ce40: 2062 7920 6469 7374 7269 6275 746f 7273 by distributors │ │ │ │ │ -0000ce50: 206f 6620 4752 5542 2074 6f20 7468 6569 of GRUB to thei │ │ │ │ │ -0000ce60: 7220 6964 656e 7469 6679 696e 6720 6e61 r identifying na │ │ │ │ │ -0000ce70: 6d65 2e20 2054 6869 7320 6973 0a20 2020 me. This is. │ │ │ │ │ -0000ce80: 2020 7573 6564 2074 6f20 6765 6e65 7261 used to genera │ │ │ │ │ -0000ce90: 7465 206d 6f72 6520 696e 666f 726d 6174 te more informat │ │ │ │ │ -0000cea0: 6976 6520 6d65 6e75 2065 6e74 7279 2074 ive menu entry t │ │ │ │ │ -0000ceb0: 6974 6c65 732e 0a0a 2747 5255 425f 5445 itles...'GRUB_TE │ │ │ │ │ -0000cec0: 524d 494e 414c 5f49 4e50 5554 270a 2020 RMINAL_INPUT'. │ │ │ │ │ -0000ced0: 2020 2053 656c 6563 7420 7468 6520 7465 Select the te │ │ │ │ │ -0000cee0: 726d 696e 616c 2069 6e70 7574 2064 6576 rminal input dev │ │ │ │ │ -0000cef0: 6963 652e 2020 596f 7520 6d61 7920 7365 ice. You may se │ │ │ │ │ -0000cf00: 6c65 6374 206d 756c 7469 706c 6520 6465 lect multiple de │ │ │ │ │ -0000cf10: 7669 6365 730a 2020 2020 2068 6572 652c vices. here, │ │ │ │ │ -0000cf20: 2073 6570 6172 6174 6564 2062 7920 7370 separated by sp │ │ │ │ │ -0000cf30: 6163 6573 2e0a 0a20 2020 2020 5661 6c69 aces... Vali │ │ │ │ │ -0000cf40: 6420 7465 726d 696e 616c 2069 6e70 7574 d terminal input │ │ │ │ │ -0000cf50: 206e 616d 6573 2064 6570 656e 6420 6f6e names depend on │ │ │ │ │ -0000cf60: 2074 6865 2070 6c61 7466 6f72 6d2c 2062 the platform, b │ │ │ │ │ -0000cf70: 7574 206d 6179 2069 6e63 6c75 6465 0a20 ut may include. │ │ │ │ │ -0000cf80: 2020 2020 2763 6f6e 736f 6c65 2720 286e 'console' (n │ │ │ │ │ -0000cf90: 6174 6976 6520 706c 6174 666f 726d 2063 ative platform c │ │ │ │ │ -0000cfa0: 6f6e 736f 6c65 292c 2027 7365 7269 616c onsole), 'serial │ │ │ │ │ -0000cfb0: 2720 2873 6572 6961 6c20 7465 726d 696e ' (serial termin │ │ │ │ │ -0000cfc0: 616c 292c 0a20 2020 2020 2773 6572 6961 al),. 'seria │ │ │ │ │ -0000cfd0: 6c5f 3c70 6f72 743e 2720 2873 6572 6961 l_' (seria │ │ │ │ │ -0000cfe0: 6c20 7465 726d 696e 616c 2077 6974 6820 l terminal with │ │ │ │ │ -0000cff0: 6578 706c 6963 6974 2070 6f72 7420 7365 explicit port se │ │ │ │ │ -0000d000: 6c65 6374 696f 6e29 2c0a 2020 2020 2027 lection),. ' │ │ │ │ │ -0000d010: 6174 5f6b 6579 626f 6172 6427 2028 5043 at_keyboard' (PC │ │ │ │ │ -0000d020: 2041 5420 6b65 7962 6f61 7264 292c 206f AT keyboard), o │ │ │ │ │ -0000d030: 7220 2775 7362 5f6b 6579 626f 6172 6427 r 'usb_keyboard' │ │ │ │ │ -0000d040: 2028 5553 4220 6b65 7962 6f61 7264 0a20 (USB keyboard. │ │ │ │ │ -0000d050: 2020 2020 7573 696e 6720 7468 6520 4849 using the HI │ │ │ │ │ -0000d060: 4420 426f 6f74 2050 726f 746f 636f 6c2c D Boot Protocol, │ │ │ │ │ -0000d070: 2066 6f72 2063 6173 6573 2077 6865 7265 for cases where │ │ │ │ │ -0000d080: 2074 6865 2066 6972 6d77 6172 6520 646f the firmware do │ │ │ │ │ -0000d090: 6573 206e 6f74 0a20 2020 2020 6861 6e64 es not. hand │ │ │ │ │ -0000d0a0: 6c65 2074 6869 7329 2e0a 0a20 2020 2020 le this)... │ │ │ │ │ -0000d0b0: 5468 6520 6465 6661 756c 7420 6973 2074 The default is t │ │ │ │ │ -0000d0c0: 6f20 7573 6520 7468 6520 706c 6174 666f o use the platfo │ │ │ │ │ -0000d0d0: 726d 2773 206e 6174 6976 6520 7465 726d rm's native term │ │ │ │ │ -0000d0e0: 696e 616c 2069 6e70 7574 2e0a 0a27 4752 inal input...'GR │ │ │ │ │ -0000d0f0: 5542 5f54 4552 4d49 4e41 4c5f 4f55 5450 UB_TERMINAL_OUTP │ │ │ │ │ -0000d100: 5554 270a 2020 2020 2053 656c 6563 7420 UT'. Select │ │ │ │ │ -0000d110: 7468 6520 7465 726d 696e 616c 206f 7574 the terminal out │ │ │ │ │ -0000d120: 7075 7420 6465 7669 6365 2e20 2059 6f75 put device. You │ │ │ │ │ -0000d130: 206d 6179 2073 656c 6563 7420 6d75 6c74 may select mult │ │ │ │ │ -0000d140: 6970 6c65 2064 6576 6963 6573 0a20 2020 iple devices. │ │ │ │ │ -0000d150: 2020 6865 7265 2c20 7365 7061 7261 7465 here, separate │ │ │ │ │ -0000d160: 6420 6279 2073 7061 6365 732e 0a0a 2020 d by spaces... │ │ │ │ │ -0000d170: 2020 2056 616c 6964 2074 6572 6d69 6e61 Valid termina │ │ │ │ │ -0000d180: 6c20 6f75 7470 7574 206e 616d 6573 2064 l output names d │ │ │ │ │ -0000d190: 6570 656e 6420 6f6e 2074 6865 2070 6c61 epend on the pla │ │ │ │ │ -0000d1a0: 7466 6f72 6d2c 2062 7574 206d 6179 2069 tform, but may i │ │ │ │ │ -0000d1b0: 6e63 6c75 6465 0a20 2020 2020 2763 6f6e nclude. 'con │ │ │ │ │ -0000d1c0: 736f 6c65 2720 286e 6174 6976 6520 706c sole' (native pl │ │ │ │ │ -0000d1d0: 6174 666f 726d 2063 6f6e 736f 6c65 292c atform console), │ │ │ │ │ -0000d1e0: 2027 7365 7269 616c 2720 2873 6572 6961 'serial' (seria │ │ │ │ │ -0000d1f0: 6c20 7465 726d 696e 616c 292c 0a20 2020 l terminal),. │ │ │ │ │ -0000d200: 2020 2773 6572 6961 6c5f 3c70 6f72 743e 'serial_ │ │ │ │ │ -0000d210: 2720 2873 6572 6961 6c20 7465 726d 696e ' (serial termin │ │ │ │ │ -0000d220: 616c 2077 6974 6820 6578 706c 6963 6974 al with explicit │ │ │ │ │ -0000d230: 2070 6f72 7420 7365 6c65 6374 696f 6e29 port selection) │ │ │ │ │ -0000d240: 2c0a 2020 2020 2027 6766 7874 6572 6d27 ,. 'gfxterm' │ │ │ │ │ -0000d250: 2028 6772 6170 6869 6373 2d6d 6f64 6520 (graphics-mode │ │ │ │ │ -0000d260: 6f75 7470 7574 292c 2027 7667 615f 7465 output), 'vga_te │ │ │ │ │ -0000d270: 7874 2720 2856 4741 2074 6578 7420 6f75 xt' (VGA text ou │ │ │ │ │ -0000d280: 7470 7574 292c 0a20 2020 2020 276d 6461 tput),. 'mda │ │ │ │ │ -0000d290: 5f74 6578 7427 2028 4d44 4120 7465 7874 _text' (MDA text │ │ │ │ │ -0000d2a0: 206f 7574 7075 7429 2c20 276d 6f72 7365 output), 'morse │ │ │ │ │ -0000d2b0: 2720 284d 6f72 7365 2d63 6f64 696e 6720 ' (Morse-coding │ │ │ │ │ -0000d2c0: 7573 696e 6720 7379 7374 656d 0a20 2020 using system. │ │ │ │ │ -0000d2d0: 2020 6265 6570 6572 2920 6f72 2027 7370 beeper) or 'sp │ │ │ │ │ -0000d2e0: 6b6d 6f64 656d 2720 2873 696d 706c 6520 kmodem' (simple │ │ │ │ │ -0000d2f0: 6461 7461 2070 726f 746f 636f 6c20 7573 data protocol us │ │ │ │ │ -0000d300: 696e 6720 7379 7374 656d 2073 7065 616b ing system speak │ │ │ │ │ -0000d310: 6572 292e 0a0a 2020 2020 2027 7370 6b6d er)... 'spkm │ │ │ │ │ -0000d320: 6f64 656d 2720 6973 2075 7365 6675 6c20 odem' is useful │ │ │ │ │ -0000d330: 7768 656e 206e 6f20 7365 7269 616c 2070 when no serial p │ │ │ │ │ -0000d340: 6f72 7420 6973 2061 7661 696c 6162 6c65 ort is available │ │ │ │ │ -0000d350: 2e20 2043 6f6e 6e65 6374 2074 6865 0a20 . Connect the. │ │ │ │ │ -0000d360: 2020 2020 6f75 7470 7574 206f 6620 7365 output of se │ │ │ │ │ -0000d370: 6e64 696e 6720 7379 7374 656d 2028 7768 nding system (wh │ │ │ │ │ -0000d380: 6572 6520 4752 5542 2069 7320 7275 6e6e ere GRUB is runn │ │ │ │ │ -0000d390: 696e 6729 2074 6f20 6c69 6e65 2d69 6e20 ing) to line-in │ │ │ │ │ -0000d3a0: 6f66 0a20 2020 2020 7265 6365 6976 696e of. receivin │ │ │ │ │ -0000d3b0: 6720 7379 7374 656d 2028 7573 7561 6c6c g system (usuall │ │ │ │ │ -0000d3c0: 7920 6465 7665 6c6f 7065 7220 6d61 6368 y developer mach │ │ │ │ │ -0000d3d0: 696e 6529 2e20 204f 6e20 7265 6365 6976 ine). On receiv │ │ │ │ │ -0000d3e0: 696e 6720 7379 7374 656d 0a20 2020 2020 ing system. │ │ │ │ │ -0000d3f0: 636f 6d70 696c 6520 2773 706b 6d6f 6465 compile 'spkmode │ │ │ │ │ -0000d400: 6d2d 7265 6376 2720 6672 6f6d 2027 7574 m-recv' from 'ut │ │ │ │ │ -0000d410: 696c 2f73 706b 6d6f 6465 6d2d 7265 6376 il/spkmodem-recv │ │ │ │ │ -0000d420: 2e63 2720 616e 6420 7275 6e3a 0a0a 2020 .c' and run:.. │ │ │ │ │ -0000d430: 2020 2020 2020 2020 7061 7265 636f 7264 parecord │ │ │ │ │ -0000d440: 202d 2d63 6861 6e6e 656c 733d 3120 2d2d --channels=1 -- │ │ │ │ │ -0000d450: 7261 7465 3d34 3830 3030 202d 2d66 6f72 rate=48000 --for │ │ │ │ │ -0000d460: 6d61 743d 7331 366c 6520 7c20 2e2f 7370 mat=s16le | ./sp │ │ │ │ │ -0000d470: 6b6d 6f64 656d 2d72 6563 760a 0a20 2020 kmodem-recv.. │ │ │ │ │ -0000d480: 2020 5468 6520 6465 6661 756c 7420 6973 The default is │ │ │ │ │ -0000d490: 2074 6f20 7573 6520 7468 6520 706c 6174 to use the plat │ │ │ │ │ -0000d4a0: 666f 726d 2773 206e 6174 6976 6520 7465 form's native te │ │ │ │ │ -0000d4b0: 726d 696e 616c 206f 7574 7075 742e 0a0a rminal output... │ │ │ │ │ -0000d4c0: 2747 5255 425f 5445 524d 494e 414c 270a 'GRUB_TERMINAL'. │ │ │ │ │ -0000d4d0: 2020 2020 2049 6620 7468 6973 206f 7074 If this opt │ │ │ │ │ -0000d4e0: 696f 6e20 6973 2073 6574 2c20 6974 206f ion is set, it o │ │ │ │ │ -0000d4f0: 7665 7272 6964 6573 2062 6f74 6820 2747 verrides both 'G │ │ │ │ │ -0000d500: 5255 425f 5445 524d 494e 414c 5f49 4e50 RUB_TERMINAL_INP │ │ │ │ │ -0000d510: 5554 2720 616e 640a 2020 2020 2027 4752 UT' and. 'GR │ │ │ │ │ -0000d520: 5542 5f54 4552 4d49 4e41 4c5f 4f55 5450 UB_TERMINAL_OUTP │ │ │ │ │ -0000d530: 5554 2720 746f 2074 6865 2073 616d 6520 UT' to the same │ │ │ │ │ -0000d540: 7661 6c75 652e 0a0a 2747 5255 425f 5345 value...'GRUB_SE │ │ │ │ │ -0000d550: 5249 414c 5f43 4f4d 4d41 4e44 270a 2020 RIAL_COMMAND'. │ │ │ │ │ -0000d560: 2020 2041 2063 6f6d 6d61 6e64 2074 6f20 A command to │ │ │ │ │ -0000d570: 636f 6e66 6967 7572 6520 7468 6520 7365 configure the se │ │ │ │ │ -0000d580: 7269 616c 2070 6f72 7420 7768 656e 2075 rial port when u │ │ │ │ │ -0000d590: 7369 6e67 2074 6865 2073 6572 6961 6c0a sing the serial. │ │ │ │ │ -0000d5a0: 2020 2020 2063 6f6e 736f 6c65 2e20 202a console. * │ │ │ │ │ -0000d5b0: 4e6f 7465 2073 6572 6961 6c3a 3a2e 2020 Note serial::. │ │ │ │ │ -0000d5c0: 4465 6661 756c 7473 2074 6f20 2773 6572 Defaults to 'ser │ │ │ │ │ -0000d5d0: 6961 6c27 2e0a 0a27 4752 5542 5f43 4d44 ial'...'GRUB_CMD │ │ │ │ │ -0000d5e0: 4c49 4e45 5f4c 494e 5558 270a 2020 2020 LINE_LINUX'. │ │ │ │ │ -0000d5f0: 2043 6f6d 6d61 6e64 2d6c 696e 6520 6172 Command-line ar │ │ │ │ │ -0000d600: 6775 6d65 6e74 7320 746f 2061 6464 2074 guments to add t │ │ │ │ │ -0000d610: 6f20 6d65 6e75 2065 6e74 7269 6573 2066 o menu entries f │ │ │ │ │ -0000d620: 6f72 2074 6865 204c 696e 7578 206b 6572 or the Linux ker │ │ │ │ │ -0000d630: 6e65 6c2e 0a0a 2747 5255 425f 434d 444c nel...'GRUB_CMDL │ │ │ │ │ -0000d640: 494e 455f 4c49 4e55 585f 4445 4641 554c INE_LINUX_DEFAUL │ │ │ │ │ -0000d650: 5427 0a20 2020 2020 556e 6c65 7373 2027 T'. Unless ' │ │ │ │ │ -0000d660: 4752 5542 5f44 4953 4142 4c45 5f52 4543 GRUB_DISABLE_REC │ │ │ │ │ -0000d670: 4f56 4552 5927 2069 7320 7365 7420 746f OVERY' is set to │ │ │ │ │ -0000d680: 2027 7472 7565 272c 2074 776f 206d 656e 'true', two men │ │ │ │ │ -0000d690: 7520 656e 7472 6965 730a 2020 2020 2077 u entries. w │ │ │ │ │ -0000d6a0: 696c 6c20 6265 2067 656e 6572 6174 6564 ill be generated │ │ │ │ │ -0000d6b0: 2066 6f72 2065 6163 6820 4c69 6e75 7820 for each Linux │ │ │ │ │ -0000d6c0: 6b65 726e 656c 3a20 6f6e 6520 6465 6661 kernel: one defa │ │ │ │ │ -0000d6d0: 756c 7420 656e 7472 7920 616e 6420 6f6e ult entry and on │ │ │ │ │ -0000d6e0: 650a 2020 2020 2065 6e74 7279 2066 6f72 e. entry for │ │ │ │ │ -0000d6f0: 2072 6563 6f76 6572 7920 6d6f 6465 2e20 recovery mode. │ │ │ │ │ -0000d700: 2054 6869 7320 6f70 7469 6f6e 206c 6973 This option lis │ │ │ │ │ -0000d710: 7473 2063 6f6d 6d61 6e64 2d6c 696e 6520 ts command-line │ │ │ │ │ -0000d720: 6172 6775 6d65 6e74 730a 2020 2020 2074 arguments. t │ │ │ │ │ -0000d730: 6f20 6164 6420 6f6e 6c79 2074 6f20 7468 o add only to th │ │ │ │ │ -0000d740: 6520 6465 6661 756c 7420 6d65 6e75 2065 e default menu e │ │ │ │ │ -0000d750: 6e74 7279 2c20 6166 7465 7220 7468 6f73 ntry, after thos │ │ │ │ │ -0000d760: 6520 6c69 7374 6564 2069 6e0a 2020 2020 e listed in. │ │ │ │ │ -0000d770: 2027 4752 5542 5f43 4d44 4c49 4e45 5f4c 'GRUB_CMDLINE_L │ │ │ │ │ -0000d780: 494e 5558 272e 0a0a 2747 5255 425f 434d INUX'...'GRUB_CM │ │ │ │ │ -0000d790: 444c 494e 455f 4e45 5442 5344 270a 2747 DLINE_NETBSD'.'G │ │ │ │ │ -0000d7a0: 5255 425f 434d 444c 494e 455f 4e45 5442 RUB_CMDLINE_NETB │ │ │ │ │ -0000d7b0: 5344 5f44 4546 4155 4c54 270a 2020 2020 SD_DEFAULT'. │ │ │ │ │ -0000d7c0: 2041 7320 2747 5255 425f 434d 444c 494e As 'GRUB_CMDLIN │ │ │ │ │ -0000d7d0: 455f 4c49 4e55 5827 2061 6e64 2027 4752 E_LINUX' and 'GR │ │ │ │ │ -0000d7e0: 5542 5f43 4d44 4c49 4e45 5f4c 494e 5558 UB_CMDLINE_LINUX │ │ │ │ │ -0000d7f0: 5f44 4546 4155 4c54 272c 2062 7574 2066 _DEFAULT', but f │ │ │ │ │ -0000d800: 6f72 0a20 2020 2020 4e65 7442 5344 2e0a or. NetBSD.. │ │ │ │ │ -0000d810: 0a27 4752 5542 5f43 4d44 4c49 4e45 5f47 .'GRUB_CMDLINE_G │ │ │ │ │ -0000d820: 4e55 4d41 4348 270a 2020 2020 2041 7320 NUMACH'. As │ │ │ │ │ -0000d830: 2747 5255 425f 434d 444c 494e 455f 4c49 'GRUB_CMDLINE_LI │ │ │ │ │ -0000d840: 4e55 5827 2c20 6275 7420 666f 7220 474e NUX', but for GN │ │ │ │ │ -0000d850: 5520 4d61 6368 2e0a 0a27 4752 5542 5f43 U Mach...'GRUB_C │ │ │ │ │ -0000d860: 4d44 4c49 4e45 5f58 454e 270a 2747 5255 MDLINE_XEN'.'GRU │ │ │ │ │ -0000d870: 425f 434d 444c 494e 455f 5845 4e5f 4445 B_CMDLINE_XEN_DE │ │ │ │ │ -0000d880: 4641 554c 5427 0a20 2020 2020 5468 6520 FAULT'. The │ │ │ │ │ -0000d890: 7661 6c75 6573 206f 6620 7468 6573 6520 values of these │ │ │ │ │ -0000d8a0: 6f70 7469 6f6e 7320 6172 6520 7061 7373 options are pass │ │ │ │ │ -0000d8b0: 6564 2074 6f20 5865 6e20 6879 7065 7276 ed to Xen hyperv │ │ │ │ │ -0000d8c0: 6973 6f72 2058 656e 206d 656e 750a 2020 isor Xen menu. │ │ │ │ │ -0000d8d0: 2020 2065 6e74 7269 6573 2c20 666f 7220 entries, for │ │ │ │ │ -0000d8e0: 616c 6c20 7265 7370 6563 7469 7665 6c79 all respectively │ │ │ │ │ -0000d8f0: 206e 6f72 6d61 6c20 656e 7472 6965 732e normal entries. │ │ │ │ │ -0000d900: 0a0a 2747 5255 425f 434d 444c 494e 455f ..'GRUB_CMDLINE_ │ │ │ │ │ -0000d910: 4c49 4e55 585f 5845 4e5f 5245 504c 4143 LINUX_XEN_REPLAC │ │ │ │ │ -0000d920: 4527 0a27 4752 5542 5f43 4d44 4c49 4e45 E'.'GRUB_CMDLINE │ │ │ │ │ -0000d930: 5f4c 494e 5558 5f58 454e 5f52 4550 4c41 _LINUX_XEN_REPLA │ │ │ │ │ -0000d940: 4345 5f44 4546 4155 4c54 270a 2020 2020 CE_DEFAULT'. │ │ │ │ │ -0000d950: 2054 6865 2076 616c 7565 7320 6f66 2074 The values of t │ │ │ │ │ -0000d960: 6865 7365 206f 7074 696f 6e73 2072 6570 hese options rep │ │ │ │ │ -0000d970: 6c61 6365 2074 6865 2076 616c 7565 7320 lace the values │ │ │ │ │ -0000d980: 6f66 0a20 2020 2020 2747 5255 425f 434d of. 'GRUB_CM │ │ │ │ │ -0000d990: 444c 494e 455f 4c49 4e55 5827 2061 6e64 DLINE_LINUX' and │ │ │ │ │ -0000d9a0: 2027 4752 5542 5f43 4d44 4c49 4e45 5f4c 'GRUB_CMDLINE_L │ │ │ │ │ -0000d9b0: 494e 5558 5f44 4546 4155 4c54 2720 666f INUX_DEFAULT' fo │ │ │ │ │ -0000d9c0: 7220 4c69 6e75 7820 616e 640a 2020 2020 r Linux and. │ │ │ │ │ -0000d9d0: 2058 656e 206d 656e 7520 656e 7472 6965 Xen menu entrie │ │ │ │ │ -0000d9e0: 732e 0a0a 2747 5255 425f 4541 524c 595f s...'GRUB_EARLY_ │ │ │ │ │ -0000d9f0: 494e 4954 5244 5f4c 494e 5558 5f43 5553 INITRD_LINUX_CUS │ │ │ │ │ -0000da00: 544f 4d27 0a27 4752 5542 5f45 4152 4c59 TOM'.'GRUB_EARLY │ │ │ │ │ -0000da10: 5f49 4e49 5452 445f 4c49 4e55 585f 5354 _INITRD_LINUX_ST │ │ │ │ │ -0000da20: 4f43 4b27 0a20 2020 2020 4c69 7374 206f OCK'. List o │ │ │ │ │ -0000da30: 6620 7370 6163 652d 7365 7061 7261 7465 f space-separate │ │ │ │ │ -0000da40: 6420 6561 726c 7920 696e 6974 7264 2069 d early initrd i │ │ │ │ │ -0000da50: 6d61 6765 7320 746f 2062 6520 6c6f 6164 mages to be load │ │ │ │ │ -0000da60: 6564 2066 726f 6d0a 2020 2020 2027 2f62 ed from. '/b │ │ │ │ │ -0000da70: 6f6f 7427 2e20 2054 6869 7320 6973 2066 oot'. This is f │ │ │ │ │ -0000da80: 6f72 206c 6f61 6469 6e67 2074 6869 6e67 or loading thing │ │ │ │ │ -0000da90: 7320 6c69 6b65 2043 5055 206d 6963 726f s like CPU micro │ │ │ │ │ -0000daa0: 636f 6465 2c20 6669 726d 7761 7265 2c0a code, firmware,. │ │ │ │ │ -0000dab0: 2020 2020 2041 4350 4920 7461 626c 6573 ACPI tables │ │ │ │ │ -0000dac0: 2c20 6372 7970 746f 206b 6579 732c 2061 , crypto keys, a │ │ │ │ │ -0000dad0: 6e64 2073 6f20 6f6e 2e20 2054 6865 7365 nd so on. These │ │ │ │ │ -0000dae0: 2065 6172 6c79 2069 6d61 6765 7320 7769 early images wi │ │ │ │ │ -0000daf0: 6c6c 2062 650a 2020 2020 206c 6f61 6465 ll be. loade │ │ │ │ │ -0000db00: 6420 696e 2074 6865 206f 7264 6572 2064 d in the order d │ │ │ │ │ -0000db10: 6563 6c61 7265 642c 2061 6e64 2061 6c6c eclared, and all │ │ │ │ │ -0000db20: 2077 696c 6c20 6265 206c 6f61 6465 6420 will be loaded │ │ │ │ │ -0000db30: 6265 666f 7265 2074 6865 0a20 2020 2020 before the. │ │ │ │ │ -0000db40: 6163 7475 616c 2066 756e 6374 696f 6e61 actual functiona │ │ │ │ │ -0000db50: 6c20 696e 6974 7264 2069 6d61 6765 2e0a l initrd image.. │ │ │ │ │ -0000db60: 0a20 2020 2020 2747 5255 425f 4541 524c . 'GRUB_EARL │ │ │ │ │ -0000db70: 595f 494e 4954 5244 5f4c 494e 5558 5f53 Y_INITRD_LINUX_S │ │ │ │ │ -0000db80: 544f 434b 2720 6973 2066 6f72 2079 6f75 TOCK' is for you │ │ │ │ │ -0000db90: 7220 6469 7374 7269 6275 7469 6f6e 2074 r distribution t │ │ │ │ │ -0000dba0: 6f20 6465 636c 6172 650a 2020 2020 2069 o declare. i │ │ │ │ │ -0000dbb0: 6d61 6765 7320 7468 6174 2061 7265 2070 mages that are p │ │ │ │ │ -0000dbc0: 726f 7669 6465 6420 6279 2074 6865 2064 rovided by the d │ │ │ │ │ -0000dbd0: 6973 7472 6962 7574 696f 6e2e 2020 4974 istribution. It │ │ │ │ │ -0000dbe0: 2073 686f 756c 6420 6e6f 7420 6265 0a20 should not be. │ │ │ │ │ -0000dbf0: 2020 2020 6d6f 6469 6669 6564 2077 6974 modified wit │ │ │ │ │ -0000dc00: 686f 7574 2075 6e64 6572 7374 616e 6469 hout understandi │ │ │ │ │ -0000dc10: 6e67 2074 6865 2063 6f6e 7365 7175 656e ng the consequen │ │ │ │ │ -0000dc20: 6365 732e 2020 5468 6579 2077 696c 6c20 ces. They will │ │ │ │ │ -0000dc30: 6265 0a20 2020 2020 6c6f 6164 6564 2066 be. loaded f │ │ │ │ │ -0000dc40: 6972 7374 2e0a 0a20 2020 2020 2747 5255 irst... 'GRU │ │ │ │ │ -0000dc50: 425f 4541 524c 595f 494e 4954 5244 5f4c B_EARLY_INITRD_L │ │ │ │ │ -0000dc60: 494e 5558 5f43 5553 544f 4d27 2069 7320 INUX_CUSTOM' is │ │ │ │ │ -0000dc70: 666f 7220 796f 7572 2063 7573 746f 6d20 for your custom │ │ │ │ │ -0000dc80: 6372 6561 7465 6420 696d 6167 6573 2e0a created images.. │ │ │ │ │ -0000dc90: 0a20 2020 2020 5468 6520 6465 6661 756c . The defaul │ │ │ │ │ -0000dca0: 7420 7374 6f63 6b20 696d 6167 6573 2061 t stock images a │ │ │ │ │ -0000dcb0: 7265 2061 7320 666f 6c6c 6f77 732c 2074 re as follows, t │ │ │ │ │ -0000dcc0: 686f 7567 6820 7468 6579 206d 6179 2062 hough they may b │ │ │ │ │ -0000dcd0: 650a 2020 2020 206f 7665 7272 6964 6465 e. overridde │ │ │ │ │ -0000dce0: 6e20 6279 2079 6f75 7220 6469 7374 7269 n by your distri │ │ │ │ │ -0000dcf0: 6275 7469 6f6e 3a0a 2020 2020 2020 2020 bution:. │ │ │ │ │ -0000dd00: 2020 696e 7465 6c2d 7563 2e69 6d67 2069 intel-uc.img i │ │ │ │ │ -0000dd10: 6e74 656c 2d75 636f 6465 2e69 6d67 2061 ntel-ucode.img a │ │ │ │ │ -0000dd20: 6d64 2d75 632e 696d 6720 616d 642d 7563 md-uc.img amd-uc │ │ │ │ │ -0000dd30: 6f64 652e 696d 6720 6561 726c 795f 7563 ode.img early_uc │ │ │ │ │ -0000dd40: 6f64 652e 6370 696f 206d 6963 726f 636f ode.cpio microco │ │ │ │ │ -0000dd50: 6465 2e63 7069 6f0a 0a27 4752 5542 5f44 de.cpio..'GRUB_D │ │ │ │ │ -0000dd60: 4953 4142 4c45 5f4c 494e 5558 5f55 5549 ISABLE_LINUX_UUI │ │ │ │ │ -0000dd70: 4427 0a20 2020 2020 4e6f 726d 616c 6c79 D'. Normally │ │ │ │ │ -0000dd80: 2c20 2767 7275 622d 6d6b 636f 6e66 6967 , 'grub-mkconfig │ │ │ │ │ -0000dd90: 2720 7769 6c6c 2067 656e 6572 6174 6520 ' will generate │ │ │ │ │ -0000dda0: 6d65 6e75 2065 6e74 7269 6573 2074 6861 menu entries tha │ │ │ │ │ -0000ddb0: 7420 7573 650a 2020 2020 2075 6e69 7665 t use. unive │ │ │ │ │ -0000ddc0: 7273 616c 6c79 2d75 6e69 7175 6520 6964 rsally-unique id │ │ │ │ │ -0000ddd0: 656e 7469 6669 6572 7320 2855 5549 4473 entifiers (UUIDs │ │ │ │ │ -0000dde0: 2920 746f 2069 6465 6e74 6966 7920 7468 ) to identify th │ │ │ │ │ -0000ddf0: 6520 726f 6f74 0a20 2020 2020 6669 6c65 e root. file │ │ │ │ │ -0000de00: 7379 7374 656d 2074 6f20 7468 6520 4c69 system to the Li │ │ │ │ │ -0000de10: 6e75 7820 6b65 726e 656c 2c20 7573 696e nux kernel, usin │ │ │ │ │ -0000de20: 6720 6120 2772 6f6f 743d 5555 4944 3d2e g a 'root=UUID=. │ │ │ │ │ -0000de30: 2e2e 2720 6b65 726e 656c 0a20 2020 2020 ..' kernel. │ │ │ │ │ -0000de40: 7061 7261 6d65 7465 722e 2020 5468 6973 parameter. This │ │ │ │ │ -0000de50: 2069 7320 7573 7561 6c6c 7920 6d6f 7265 is usually more │ │ │ │ │ -0000de60: 2072 656c 6961 626c 652c 2062 7574 2069 reliable, but i │ │ │ │ │ -0000de70: 6e20 736f 6d65 2063 6173 6573 2069 7420 n some cases it │ │ │ │ │ -0000de80: 6d61 790a 2020 2020 206e 6f74 2062 6520 may. not be │ │ │ │ │ -0000de90: 6170 7072 6f70 7269 6174 652e 2020 546f appropriate. To │ │ │ │ │ -0000dea0: 2064 6973 6162 6c65 2074 6865 2075 7365 disable the use │ │ │ │ │ -0000deb0: 206f 6620 5555 4944 732c 2073 6574 2074 of UUIDs, set t │ │ │ │ │ -0000dec0: 6869 7320 6f70 7469 6f6e 0a20 2020 2020 his option. │ │ │ │ │ -0000ded0: 746f 2027 7472 7565 272e 0a0a 2747 5255 to 'true'...'GRU │ │ │ │ │ -0000dee0: 425f 4449 5341 424c 455f 4c49 4e55 585f B_DISABLE_LINUX_ │ │ │ │ │ -0000def0: 5041 5254 5555 4944 270a 2020 2020 2049 PARTUUID'. I │ │ │ │ │ -0000df00: 6620 2767 7275 622d 6d6b 636f 6e66 6967 f 'grub-mkconfig │ │ │ │ │ -0000df10: 2720 6361 6e6e 6f74 2069 6465 6e74 6966 ' cannot identif │ │ │ │ │ -0000df20: 7920 7468 6520 726f 6f74 2066 696c 6573 y the root files │ │ │ │ │ -0000df30: 7973 7465 6d20 7669 6120 6974 730a 2020 ystem via its. │ │ │ │ │ -0000df40: 2020 2075 6e69 7665 7273 616c 6c79 2d75 universally-u │ │ │ │ │ -0000df50: 6e69 7175 6520 696e 6465 6e74 6966 6965 nique indentifie │ │ │ │ │ -0000df60: 7220 2855 5549 4429 2c20 2767 7275 622d r (UUID), 'grub- │ │ │ │ │ -0000df70: 6d6b 636f 6e66 6967 2720 6361 6e20 7573 mkconfig' can us │ │ │ │ │ -0000df80: 6520 7468 650a 2020 2020 2055 5549 4420 e the. UUID │ │ │ │ │ -0000df90: 6f66 2074 6865 2070 6172 7469 7469 6f6e of the partition │ │ │ │ │ -0000dfa0: 2063 6f6e 7461 696e 696e 6720 7468 6520 containing the │ │ │ │ │ -0000dfb0: 6669 6c65 7379 7374 656d 2074 6f20 6964 filesystem to id │ │ │ │ │ -0000dfc0: 656e 7469 6679 2074 6865 0a20 2020 2020 entify the. │ │ │ │ │ -0000dfd0: 726f 6f74 2066 696c 6573 7973 7465 6d20 root filesystem │ │ │ │ │ -0000dfe0: 746f 2074 6865 204c 696e 7578 206b 6572 to the Linux ker │ │ │ │ │ -0000dff0: 6e65 6c20 7669 6120 6120 2772 6f6f 743d nel via a 'root= │ │ │ │ │ -0000e000: 5041 5254 5555 4944 3d2e 2e2e 270a 2020 PARTUUID=...'. │ │ │ │ │ -0000e010: 2020 206b 6572 6e65 6c20 7061 7261 6d65 kernel parame │ │ │ │ │ -0000e020: 7465 722e 2020 5468 6973 2069 7320 6e6f ter. This is no │ │ │ │ │ -0000e030: 7420 6173 2072 656c 6961 626c 6520 6173 t as reliable as │ │ │ │ │ -0000e040: 2075 7369 6e67 2074 6865 2066 696c 6573 using the files │ │ │ │ │ -0000e050: 7973 7465 6d0a 2020 2020 2055 5549 442c ystem. UUID, │ │ │ │ │ -0000e060: 2062 7574 2069 7320 6d6f 7265 2072 656c but is more rel │ │ │ │ │ -0000e070: 6961 626c 6520 7468 616e 2075 7369 6e67 iable than using │ │ │ │ │ -0000e080: 2074 6865 204c 696e 7578 2064 6576 6963 the Linux devic │ │ │ │ │ -0000e090: 6520 6e61 6d65 732e 2020 5768 656e 0a20 e names. When. │ │ │ │ │ -0000e0a0: 2020 2020 2747 5255 425f 4449 5341 424c 'GRUB_DISABL │ │ │ │ │ -0000e0b0: 455f 4c49 4e55 585f 5041 5254 5555 4944 E_LINUX_PARTUUID │ │ │ │ │ -0000e0c0: 2720 6973 2073 6574 2074 6f20 2766 616c ' is set to 'fal │ │ │ │ │ -0000e0d0: 7365 272c 2074 6865 204c 696e 7578 206b se', the Linux k │ │ │ │ │ -0000e0e0: 6572 6e65 6c0a 2020 2020 2076 6572 7369 ernel. versi │ │ │ │ │ -0000e0f0: 6f6e 206d 7573 7420 6265 2032 2e36 2e33 on must be 2.6.3 │ │ │ │ │ -0000e100: 3720 2833 2e31 3020 666f 7220 7379 7374 7 (3.10 for syst │ │ │ │ │ -0000e110: 656d 7320 7573 696e 6720 7468 6520 4d53 ems using the MS │ │ │ │ │ -0000e120: 444f 5320 7061 7274 6974 696f 6e0a 2020 DOS partition. │ │ │ │ │ -0000e130: 2020 2073 6368 656d 6529 206f 7220 6e65 scheme) or ne │ │ │ │ │ -0000e140: 7765 722e 2020 5468 6973 206f 7074 696f wer. This optio │ │ │ │ │ -0000e150: 6e20 6465 6661 756c 7473 2074 6f20 2774 n defaults to 't │ │ │ │ │ -0000e160: 7275 6527 2e20 2054 6f20 656e 6162 6c65 rue'. To enable │ │ │ │ │ -0000e170: 2074 6865 0a20 2020 2020 7573 6520 6f66 the. use of │ │ │ │ │ -0000e180: 2070 6172 7469 7469 6f6e 2055 5549 4473 partition UUIDs │ │ │ │ │ -0000e190: 2c20 7365 7420 7468 6973 206f 7074 696f , set this optio │ │ │ │ │ -0000e1a0: 6e20 746f 2027 6661 6c73 6527 2e0a 0a27 n to 'false'...' │ │ │ │ │ -0000e1b0: 4752 5542 5f44 4953 4142 4c45 5f52 4543 GRUB_DISABLE_REC │ │ │ │ │ -0000e1c0: 4f56 4552 5927 0a20 2020 2020 4966 2074 OVERY'. If t │ │ │ │ │ -0000e1d0: 6869 7320 6f70 7469 6f6e 2069 7320 7365 his option is se │ │ │ │ │ -0000e1e0: 7420 746f 2027 7472 7565 272c 2064 6973 t to 'true', dis │ │ │ │ │ -0000e1f0: 6162 6c65 2074 6865 2067 656e 6572 6174 able the generat │ │ │ │ │ -0000e200: 696f 6e20 6f66 2072 6563 6f76 6572 790a ion of recovery. │ │ │ │ │ -0000e210: 2020 2020 206d 6f64 6520 6d65 6e75 2065 mode menu e │ │ │ │ │ -0000e220: 6e74 7269 6573 2e0a 0a27 4752 5542 5f44 ntries...'GRUB_D │ │ │ │ │ -0000e230: 4953 4142 4c45 5f55 5549 4427 0a20 2020 ISABLE_UUID'. │ │ │ │ │ -0000e240: 2020 4e6f 726d 616c 6c79 2c20 2767 7275 Normally, 'gru │ │ │ │ │ -0000e250: 622d 6d6b 636f 6e66 6967 2720 7769 6c6c b-mkconfig' will │ │ │ │ │ -0000e260: 2067 656e 6572 6174 6520 6d65 6e75 2065 generate menu e │ │ │ │ │ -0000e270: 6e74 7269 6573 2074 6861 7420 7573 650a ntries that use. │ │ │ │ │ -0000e280: 2020 2020 2075 6e69 7665 7273 616c 6c79 universally │ │ │ │ │ -0000e290: 2d75 6e69 7175 6520 6964 656e 7469 6669 -unique identifi │ │ │ │ │ -0000e2a0: 6572 7320 2855 5549 4473 2920 746f 2069 ers (UUIDs) to i │ │ │ │ │ -0000e2b0: 6465 6e74 6966 7920 7661 7269 6f75 730a dentify various. │ │ │ │ │ -0000e2c0: 2020 2020 2066 696c 6573 7973 7465 6d73 filesystems │ │ │ │ │ -0000e2d0: 2074 6f20 7365 6172 6368 2066 6f72 2066 to search for f │ │ │ │ │ -0000e2e0: 696c 6573 2e20 2054 6869 7320 6973 2075 iles. This is u │ │ │ │ │ -0000e2f0: 7375 616c 6c79 206d 6f72 6520 7265 6c69 sually more reli │ │ │ │ │ -0000e300: 6162 6c65 2c0a 2020 2020 2062 7574 2069 able,. but i │ │ │ │ │ -0000e310: 6e20 736f 6d65 2063 6173 6573 2069 7420 n some cases it │ │ │ │ │ -0000e320: 6d61 7920 6e6f 7420 6265 2061 7070 726f may not be appro │ │ │ │ │ -0000e330: 7072 6961 7465 2e20 2054 6f20 6469 7361 priate. To disa │ │ │ │ │ -0000e340: 626c 6520 7468 6973 2075 7365 0a20 2020 ble this use. │ │ │ │ │ -0000e350: 2020 6f66 2055 5549 4473 2c20 7365 7420 of UUIDs, set │ │ │ │ │ -0000e360: 7468 6973 206f 7074 696f 6e20 746f 2027 this option to ' │ │ │ │ │ -0000e370: 7472 7565 272e 2020 5365 7474 696e 6720 true'. Setting │ │ │ │ │ -0000e380: 7468 6973 206f 7074 696f 6e20 746f 0a20 this option to. │ │ │ │ │ -0000e390: 2020 2020 2774 7275 6527 2c20 7769 6c6c 'true', will │ │ │ │ │ -0000e3a0: 2061 6c73 6f20 7365 7420 7468 6520 6f70 also set the op │ │ │ │ │ -0000e3b0: 7469 6f6e 7320 2747 5255 425f 4449 5341 tions 'GRUB_DISA │ │ │ │ │ -0000e3c0: 424c 455f 4c49 4e55 585f 5555 4944 2720 BLE_LINUX_UUID' │ │ │ │ │ -0000e3d0: 616e 640a 2020 2020 2027 4752 5542 5f44 and. 'GRUB_D │ │ │ │ │ -0000e3e0: 4953 4142 4c45 5f4c 494e 5558 5f50 4152 ISABLE_LINUX_PAR │ │ │ │ │ -0000e3f0: 5455 5549 4427 2074 6f20 2774 7275 6527 TUUID' to 'true' │ │ │ │ │ -0000e400: 2c20 756e 6c65 7373 2074 6865 7920 6861 , unless they ha │ │ │ │ │ -0000e410: 7665 2062 6565 6e0a 2020 2020 2065 7870 ve been. exp │ │ │ │ │ -0000e420: 6c69 6369 6c74 7920 7365 7420 746f 2027 licilty set to ' │ │ │ │ │ -0000e430: 6661 6c73 6527 2e0a 0a27 4752 5542 5f56 false'...'GRUB_V │ │ │ │ │ -0000e440: 4944 454f 5f42 4143 4b45 4e44 270a 2020 IDEO_BACKEND'. │ │ │ │ │ -0000e450: 2020 2049 6620 6772 6170 6869 6361 6c20 If graphical │ │ │ │ │ -0000e460: 7669 6465 6f20 7375 7070 6f72 7420 6973 video support is │ │ │ │ │ -0000e470: 2072 6571 7569 7265 642c 2065 6974 6865 required, eithe │ │ │ │ │ -0000e480: 7220 6265 6361 7573 6520 7468 650a 2020 r because the. │ │ │ │ │ -0000e490: 2020 2027 6766 7874 6572 6d27 2067 7261 'gfxterm' gra │ │ │ │ │ -0000e4a0: 7068 6963 616c 2074 6572 6d69 6e61 6c20 phical terminal │ │ │ │ │ -0000e4b0: 6973 2069 6e20 7573 6520 6f72 2062 6563 is in use or bec │ │ │ │ │ -0000e4c0: 6175 7365 0a20 2020 2020 2747 5255 425f ause. 'GRUB_ │ │ │ │ │ -0000e4d0: 4746 5850 4159 4c4f 4144 5f4c 494e 5558 GFXPAYLOAD_LINUX │ │ │ │ │ -0000e4e0: 2720 6973 2073 6574 2c20 7468 656e 2027 ' is set, then ' │ │ │ │ │ -0000e4f0: 6772 7562 2d6d 6b63 6f6e 6669 6727 2077 grub-mkconfig' w │ │ │ │ │ -0000e500: 696c 6c20 6e6f 726d 616c 6c79 0a20 2020 ill normally. │ │ │ │ │ -0000e510: 2020 6c6f 6164 2061 6c6c 2061 7661 696c load all avail │ │ │ │ │ -0000e520: 6162 6c65 2047 5255 4220 7669 6465 6f20 able GRUB video │ │ │ │ │ -0000e530: 6472 6976 6572 7320 616e 6420 7573 6520 drivers and use │ │ │ │ │ -0000e540: 7468 6520 6f6e 6520 6d6f 7374 0a20 2020 the one most. │ │ │ │ │ -0000e550: 2020 6170 7072 6f70 7269 6174 6520 666f appropriate fo │ │ │ │ │ -0000e560: 7220 796f 7572 2068 6172 6477 6172 652e r your hardware. │ │ │ │ │ -0000e570: 2020 4966 2079 6f75 206e 6565 6420 746f If you need to │ │ │ │ │ -0000e580: 206f 7665 7272 6964 6520 7468 6973 2066 override this f │ │ │ │ │ -0000e590: 6f72 0a20 2020 2020 736f 6d65 2072 6561 or. some rea │ │ │ │ │ -0000e5a0: 736f 6e2c 2074 6865 6e20 796f 7520 6361 son, then you ca │ │ │ │ │ -0000e5b0: 6e20 7365 7420 7468 6973 206f 7074 696f n set this optio │ │ │ │ │ -0000e5c0: 6e2e 0a0a 2020 2020 2041 6674 6572 2027 n... After ' │ │ │ │ │ -0000e5d0: 6772 7562 2d69 6e73 7461 6c6c 2720 6861 grub-install' ha │ │ │ │ │ -0000e5e0: 7320 6265 656e 2072 756e 2c20 7468 6520 s been run, the │ │ │ │ │ -0000e5f0: 6176 6169 6c61 626c 6520 7669 6465 6f20 available video │ │ │ │ │ -0000e600: 6472 6976 6572 7320 6172 650a 2020 2020 drivers are. │ │ │ │ │ -0000e610: 206c 6973 7465 6420 696e 2027 2f62 6f6f listed in '/boo │ │ │ │ │ -0000e620: 742f 6772 7562 2f76 6964 656f 2e6c 7374 t/grub/video.lst │ │ │ │ │ -0000e630: 272e 0a0a 2747 5255 425f 4746 584d 4f44 '...'GRUB_GFXMOD │ │ │ │ │ -0000e640: 4527 0a20 2020 2020 5365 7420 7468 6520 E'. Set the │ │ │ │ │ -0000e650: 7265 736f 6c75 7469 6f6e 2075 7365 6420 resolution used │ │ │ │ │ -0000e660: 6f6e 2074 6865 2027 6766 7874 6572 6d27 on the 'gfxterm' │ │ │ │ │ -0000e670: 2067 7261 7068 6963 616c 2074 6572 6d69 graphical termi │ │ │ │ │ -0000e680: 6e61 6c2e 2020 4e6f 7465 0a20 2020 2020 nal. Note. │ │ │ │ │ -0000e690: 7468 6174 2079 6f75 2063 616e 206f 6e6c that you can onl │ │ │ │ │ -0000e6a0: 7920 7573 6520 6d6f 6465 7320 7768 6963 y use modes whic │ │ │ │ │ -0000e6b0: 6820 796f 7572 2067 7261 7068 6963 7320 h your graphics │ │ │ │ │ -0000e6c0: 6361 7264 2073 7570 706f 7274 7320 7669 card supports vi │ │ │ │ │ -0000e6d0: 610a 2020 2020 2056 4553 4120 4249 4f53 a. VESA BIOS │ │ │ │ │ -0000e6e0: 2045 7874 656e 7369 6f6e 7320 2856 4245 Extensions (VBE │ │ │ │ │ -0000e6f0: 292c 2073 6f20 666f 7220 6578 616d 706c ), so for exampl │ │ │ │ │ -0000e700: 6520 6e61 7469 7665 204c 4344 2070 616e e native LCD pan │ │ │ │ │ -0000e710: 656c 0a20 2020 2020 7265 736f 6c75 7469 el. resoluti │ │ │ │ │ -0000e720: 6f6e 7320 6d61 7920 6e6f 7420 6265 2061 ons may not be a │ │ │ │ │ -0000e730: 7661 696c 6162 6c65 2e20 2054 6865 2064 vailable. The d │ │ │ │ │ -0000e740: 6566 6175 6c74 2069 7320 2761 7574 6f27 efault is 'auto' │ │ │ │ │ -0000e750: 2c20 7768 6963 680a 2020 2020 2074 7269 , which. tri │ │ │ │ │ -0000e760: 6573 2074 6f20 7365 6c65 6374 2061 2070 es to select a p │ │ │ │ │ -0000e770: 7265 6665 7272 6564 2072 6573 6f6c 7574 referred resolut │ │ │ │ │ -0000e780: 696f 6e2e 2020 2a4e 6f74 6520 6766 786d ion. *Note gfxm │ │ │ │ │ -0000e790: 6f64 653a 3a2e 0a0a 2747 5255 425f 4241 ode::...'GRUB_BA │ │ │ │ │ -0000e7a0: 434b 4752 4f55 4e44 270a 2020 2020 2053 CKGROUND'. S │ │ │ │ │ -0000e7b0: 6574 2061 2062 6163 6b67 726f 756e 6420 et a background │ │ │ │ │ -0000e7c0: 696d 6167 6520 666f 7220 7573 6520 7769 image for use wi │ │ │ │ │ -0000e7d0: 7468 2074 6865 2027 6766 7874 6572 6d27 th the 'gfxterm' │ │ │ │ │ -0000e7e0: 2067 7261 7068 6963 616c 0a20 2020 2020 graphical. │ │ │ │ │ -0000e7f0: 7465 726d 696e 616c 2e20 2054 6865 2076 terminal. The v │ │ │ │ │ -0000e800: 616c 7565 206f 6620 7468 6973 206f 7074 alue of this opt │ │ │ │ │ -0000e810: 696f 6e20 6d75 7374 2062 6520 6120 6669 ion must be a fi │ │ │ │ │ -0000e820: 6c65 2072 6561 6461 626c 6520 6279 2047 le readable by G │ │ │ │ │ -0000e830: 5255 420a 2020 2020 2061 7420 626f 6f74 RUB. at boot │ │ │ │ │ -0000e840: 2074 696d 652c 2061 6e64 2069 7420 6d75 time, and it mu │ │ │ │ │ -0000e850: 7374 2065 6e64 2077 6974 6820 272e 706e st end with '.pn │ │ │ │ │ -0000e860: 6727 2c20 272e 7467 6127 2c20 272e 6a70 g', '.tga', '.jp │ │ │ │ │ -0000e870: 6727 2c20 6f72 0a20 2020 2020 272e 6a70 g', or. '.jp │ │ │ │ │ -0000e880: 6567 272e 2020 5468 6520 696d 6167 6520 eg'. The image │ │ │ │ │ -0000e890: 7769 6c6c 2062 6520 7363 616c 6564 2069 will be scaled i │ │ │ │ │ -0000e8a0: 6620 6e65 6365 7373 6172 7920 746f 2066 f necessary to f │ │ │ │ │ -0000e8b0: 6974 2074 6865 2073 6372 6565 6e2e 0a20 it the screen.. │ │ │ │ │ -0000e8c0: 2020 2020 496d 6167 6520 6865 6967 6874 Image height │ │ │ │ │ -0000e8d0: 2061 6e64 2077 6964 7468 2077 696c 6c20 and width will │ │ │ │ │ -0000e8e0: 6265 2072 6573 7472 6963 7465 6420 6279 be restricted by │ │ │ │ │ -0000e8f0: 2061 6e20 6172 7469 6669 6369 616c 206c an artificial l │ │ │ │ │ -0000e900: 696d 6974 206f 660a 2020 2020 2031 3633 imit of. 163 │ │ │ │ │ -0000e910: 3834 2e0a 0a27 4752 5542 5f54 4845 4d45 84...'GRUB_THEME │ │ │ │ │ -0000e920: 270a 2020 2020 2053 6574 2061 2074 6865 '. Set a the │ │ │ │ │ -0000e930: 6d65 2066 6f72 2075 7365 2077 6974 6820 me for use with │ │ │ │ │ -0000e940: 7468 6520 2767 6678 7465 726d 2720 6772 the 'gfxterm' gr │ │ │ │ │ -0000e950: 6170 6869 6361 6c20 7465 726d 696e 616c aphical terminal │ │ │ │ │ -0000e960: 2e0a 0a27 4752 5542 5f47 4658 5041 594c ...'GRUB_GFXPAYL │ │ │ │ │ -0000e970: 4f41 445f 4c49 4e55 5827 0a20 2020 2020 OAD_LINUX'. │ │ │ │ │ -0000e980: 5365 7420 746f 2027 7465 7874 2720 746f Set to 'text' to │ │ │ │ │ -0000e990: 2066 6f72 6365 2074 6865 204c 696e 7578 force the Linux │ │ │ │ │ -0000e9a0: 206b 6572 6e65 6c20 746f 2062 6f6f 7420 kernel to boot │ │ │ │ │ -0000e9b0: 696e 206e 6f72 6d61 6c20 7465 7874 0a20 in normal text. │ │ │ │ │ -0000e9c0: 2020 2020 6d6f 6465 2c20 276b 6565 7027 mode, 'keep' │ │ │ │ │ -0000e9d0: 2074 6f20 7072 6573 6572 7665 2074 6865 to preserve the │ │ │ │ │ -0000e9e0: 2067 7261 7068 6963 7320 6d6f 6465 2073 graphics mode s │ │ │ │ │ -0000e9f0: 6574 2075 7369 6e67 0a20 2020 2020 2747 et using. 'G │ │ │ │ │ -0000ea00: 5255 425f 4746 584d 4f44 4527 2c20 2757 RUB_GFXMODE', 'W │ │ │ │ │ -0000ea10: 4944 5448 7848 4549 4748 5427 5b27 7844 IDTHxHEIGHT'['xD │ │ │ │ │ -0000ea20: 4550 5448 275d 2074 6f20 7365 7420 6120 EPTH'] to set a │ │ │ │ │ -0000ea30: 7061 7274 6963 756c 6172 0a20 2020 2020 particular. │ │ │ │ │ -0000ea40: 6772 6170 6869 6373 206d 6f64 652c 206f graphics mode, o │ │ │ │ │ -0000ea50: 7220 6120 7365 7175 656e 6365 206f 6620 r a sequence of │ │ │ │ │ -0000ea60: 7468 6573 6520 7365 7061 7261 7465 6420 these separated │ │ │ │ │ -0000ea70: 6279 2063 6f6d 6d61 7320 6f72 0a20 2020 by commas or. │ │ │ │ │ -0000ea80: 2020 7365 6d69 636f 6c6f 6e73 2074 6f20 semicolons to │ │ │ │ │ -0000ea90: 7472 7920 7365 7665 7261 6c20 6d6f 6465 try several mode │ │ │ │ │ -0000eaa0: 7320 696e 2073 6571 7565 6e63 652e 2020 s in sequence. │ │ │ │ │ -0000eab0: 2a4e 6f74 6520 6766 7870 6179 6c6f 6164 *Note gfxpayload │ │ │ │ │ -0000eac0: 3a3a 2e0a 0a20 2020 2020 4465 7065 6e64 ::... Depend │ │ │ │ │ -0000ead0: 696e 6720 6f6e 2079 6f75 7220 6b65 726e ing on your kern │ │ │ │ │ -0000eae0: 656c 2c20 796f 7572 2064 6973 7472 6962 el, your distrib │ │ │ │ │ -0000eaf0: 7574 696f 6e2c 2079 6f75 7220 6772 6170 ution, your grap │ │ │ │ │ -0000eb00: 6869 6373 2063 6172 642c 0a20 2020 2020 hics card,. │ │ │ │ │ -0000eb10: 616e 6420 7468 6520 7068 6173 6520 6f66 and the phase of │ │ │ │ │ -0000eb20: 2074 6865 206d 6f6f 6e2c 206e 6f74 6520 the moon, note │ │ │ │ │ -0000eb30: 7468 6174 2075 7369 6e67 2074 6869 7320 that using this │ │ │ │ │ -0000eb40: 6f70 7469 6f6e 206d 6179 2063 6175 7365 option may cause │ │ │ │ │ -0000eb50: 0a20 2020 2020 474e 552f 4c69 6e75 7820 . GNU/Linux │ │ │ │ │ -0000eb60: 746f 2073 7566 6665 7220 6672 6f6d 2076 to suffer from v │ │ │ │ │ -0000eb70: 6172 696f 7573 2064 6973 706c 6179 2070 arious display p │ │ │ │ │ -0000eb80: 726f 626c 656d 732c 2070 6172 7469 6375 roblems, particu │ │ │ │ │ -0000eb90: 6c61 726c 790a 2020 2020 2064 7572 696e larly. durin │ │ │ │ │ -0000eba0: 6720 7468 6520 6561 726c 7920 7061 7274 g the early part │ │ │ │ │ -0000ebb0: 206f 6620 7468 6520 626f 6f74 2073 6571 of the boot seq │ │ │ │ │ -0000ebc0: 7565 6e63 652e 2020 4966 2079 6f75 2068 uence. If you h │ │ │ │ │ -0000ebd0: 6176 6520 7072 6f62 6c65 6d73 2c0a 2020 ave problems,. │ │ │ │ │ -0000ebe0: 2020 2073 6574 2074 6869 7320 6f70 7469 set this opti │ │ │ │ │ -0000ebf0: 6f6e 2074 6f20 2774 6578 7427 2061 6e64 on to 'text' and │ │ │ │ │ -0000ec00: 2047 5255 4220 7769 6c6c 2074 656c 6c20 GRUB will tell │ │ │ │ │ -0000ec10: 4c69 6e75 7820 746f 2062 6f6f 7420 696e Linux to boot in │ │ │ │ │ -0000ec20: 0a20 2020 2020 6e6f 726d 616c 2074 6578 . normal tex │ │ │ │ │ -0000ec30: 7420 6d6f 6465 2e0a 0a27 4752 5542 5f44 t mode...'GRUB_D │ │ │ │ │ -0000ec40: 4953 4142 4c45 5f4f 535f 5052 4f42 4552 ISABLE_OS_PROBER │ │ │ │ │ -0000ec50: 270a 2020 2020 2054 6865 2027 6772 7562 '. The 'grub │ │ │ │ │ -0000ec60: 2d6d 6b63 6f6e 6669 6727 2068 6173 2061 -mkconfig' has a │ │ │ │ │ -0000ec70: 2066 6561 7475 7265 2074 6f20 7573 6520 feature to use │ │ │ │ │ -0000ec80: 7468 6520 6578 7465 726e 616c 2027 6f73 the external 'os │ │ │ │ │ -0000ec90: 2d70 726f 6265 7227 0a20 2020 2020 7072 -prober'. pr │ │ │ │ │ -0000eca0: 6f67 7261 6d20 746f 2064 6973 636f 7665 ogram to discove │ │ │ │ │ -0000ecb0: 7220 6f74 6865 7220 6f70 6572 6174 696e r other operatin │ │ │ │ │ -0000ecc0: 6720 7379 7374 656d 7320 696e 7374 616c g systems instal │ │ │ │ │ -0000ecd0: 6c65 6420 6f6e 2074 6865 2073 616d 650a led on the same. │ │ │ │ │ -0000ece0: 2020 2020 206d 6163 6869 6e65 2061 6e64 machine and │ │ │ │ │ -0000ecf0: 2067 656e 6572 6174 6520 6170 7072 6f70 generate approp │ │ │ │ │ -0000ed00: 7269 6174 6520 6d65 6e75 2065 6e74 7269 riate menu entri │ │ │ │ │ -0000ed10: 6573 2066 6f72 2074 6865 6d2e 2020 4974 es for them. It │ │ │ │ │ -0000ed20: 2069 730a 2020 2020 2064 6973 6162 6c65 is. disable │ │ │ │ │ -0000ed30: 6420 6279 2064 6566 6175 6c74 2073 696e d by default sin │ │ │ │ │ -0000ed40: 6365 2061 7574 6f6d 6174 6963 2061 6e64 ce automatic and │ │ │ │ │ -0000ed50: 2073 696c 656e 7420 6578 6563 7574 696f silent executio │ │ │ │ │ -0000ed60: 6e20 6f66 0a20 2020 2020 276f 732d 7072 n of. 'os-pr │ │ │ │ │ -0000ed70: 6f62 6572 272c 2061 6e64 2063 7265 6174 ober', and creat │ │ │ │ │ -0000ed80: 696e 6720 626f 6f74 2065 6e74 7269 6573 ing boot entries │ │ │ │ │ -0000ed90: 2062 6173 6564 206f 6e20 7468 6174 2064 based on that d │ │ │ │ │ -0000eda0: 6174 612c 2069 7320 610a 2020 2020 2070 ata, is a. p │ │ │ │ │ -0000edb0: 6f74 656e 7469 616c 2061 7474 6163 6b20 otential attack │ │ │ │ │ -0000edc0: 7665 6374 6f72 2e20 2053 6574 2074 6869 vector. Set thi │ │ │ │ │ -0000edd0: 7320 6f70 7469 6f6e 2074 6f20 2766 616c s option to 'fal │ │ │ │ │ -0000ede0: 7365 2720 746f 2065 6e61 626c 6520 7468 se' to enable th │ │ │ │ │ -0000edf0: 6973 0a20 2020 2020 6665 6174 7572 6520 is. feature │ │ │ │ │ -0000ee00: 696e 2074 6865 2027 6772 7562 2d6d 6b63 in the 'grub-mkc │ │ │ │ │ -0000ee10: 6f6e 6669 6727 2063 6f6d 6d61 6e64 2e0a onfig' command.. │ │ │ │ │ -0000ee20: 0a27 4752 5542 5f4f 535f 5052 4f42 4552 .'GRUB_OS_PROBER │ │ │ │ │ -0000ee30: 5f53 4b49 505f 4c49 5354 270a 2020 2020 _SKIP_LIST'. │ │ │ │ │ -0000ee40: 204c 6973 7420 6f66 2073 7061 6365 2d73 List of space-s │ │ │ │ │ -0000ee50: 6570 6172 6174 6564 2046 5320 5555 4944 eparated FS UUID │ │ │ │ │ -0000ee60: 7320 6f66 2066 696c 6573 7973 7465 6d73 s of filesystems │ │ │ │ │ -0000ee70: 2074 6f20 6265 2069 676e 6f72 6564 2066 to be ignored f │ │ │ │ │ -0000ee80: 726f 6d0a 2020 2020 206f 732d 7072 6f62 rom. os-prob │ │ │ │ │ -0000ee90: 6572 206f 7574 7075 742e 2020 466f 7220 er output. For │ │ │ │ │ -0000eea0: 6566 6920 6368 6169 6e6c 6f61 6465 7273 efi chainloaders │ │ │ │ │ -0000eeb0: 2069 7427 7320 3c55 5549 443e 403c 4546 it's @..'GRUB_D │ │ │ │ │ -0000eed0: 4953 4142 4c45 5f53 5542 4d45 4e55 270a ISABLE_SUBMENU'. │ │ │ │ │ -0000eee0: 2020 2020 204e 6f72 6d61 6c6c 792c 2027 Normally, ' │ │ │ │ │ -0000eef0: 6772 7562 2d6d 6b63 6f6e 6669 6727 2077 grub-mkconfig' w │ │ │ │ │ -0000ef00: 696c 6c20 6765 6e65 7261 7465 2074 6f70 ill generate top │ │ │ │ │ -0000ef10: 206c 6576 656c 206d 656e 7520 656e 7472 level menu entr │ │ │ │ │ -0000ef20: 7920 666f 720a 2020 2020 2074 6865 206b y for. the k │ │ │ │ │ -0000ef30: 6572 6e65 6c20 7769 7468 2068 6967 6865 ernel with highe │ │ │ │ │ -0000ef40: 7374 2076 6572 7369 6f6e 206e 756d 6265 st version numbe │ │ │ │ │ -0000ef50: 7220 616e 6420 7075 7420 616c 6c20 6f74 r and put all ot │ │ │ │ │ -0000ef60: 6865 7220 666f 756e 640a 2020 2020 206b her found. k │ │ │ │ │ -0000ef70: 6572 6e65 6c73 206f 7220 616c 7465 726e ernels or altern │ │ │ │ │ -0000ef80: 6174 6976 6520 6d65 6e75 2065 6e74 7269 ative menu entri │ │ │ │ │ -0000ef90: 6573 2066 6f72 2072 6563 6f76 6572 7920 es for recovery │ │ │ │ │ -0000efa0: 6d6f 6465 2069 6e20 7375 626d 656e 752e mode in submenu. │ │ │ │ │ -0000efb0: 0a20 2020 2020 466f 7220 656e 7472 6965 . For entrie │ │ │ │ │ -0000efc0: 7320 7265 7475 726e 6564 2062 7920 276f s returned by 'o │ │ │ │ │ -0000efd0: 732d 7072 6f62 6572 2720 6669 7273 7420 s-prober' first │ │ │ │ │ -0000efe0: 656e 7472 7920 7769 6c6c 2062 6520 7075 entry will be pu │ │ │ │ │ -0000eff0: 7420 6f6e 2074 6f70 0a20 2020 2020 6c65 t on top. le │ │ │ │ │ -0000f000: 7665 6c20 616e 6420 616c 6c20 6f74 6865 vel and all othe │ │ │ │ │ -0000f010: 7273 2069 6e20 7375 626d 656e 752e 2020 rs in submenu. │ │ │ │ │ -0000f020: 4966 2074 6869 7320 6f70 7469 6f6e 2069 If this option i │ │ │ │ │ -0000f030: 7320 7365 7420 746f 2027 7472 7565 272c s set to 'true', │ │ │ │ │ -0000f040: 0a20 2020 2020 666c 6174 206d 656e 7520 . flat menu │ │ │ │ │ -0000f050: 7769 7468 2061 6c6c 2065 6e74 7269 6573 with all entries │ │ │ │ │ -0000f060: 206f 6e20 746f 7020 6c65 7665 6c20 7769 on top level wi │ │ │ │ │ -0000f070: 6c6c 2062 6520 6765 6e65 7261 7465 6420 ll be generated │ │ │ │ │ -0000f080: 696e 7374 6561 642e 0a20 2020 2020 4368 instead.. Ch │ │ │ │ │ -0000f090: 616e 6769 6e67 2074 6869 7320 6f70 7469 anging this opti │ │ │ │ │ -0000f0a0: 6f6e 2077 696c 6c20 7265 7175 6972 6520 on will require │ │ │ │ │ -0000f0b0: 6368 616e 6769 6e67 2065 7869 7374 696e changing existin │ │ │ │ │ -0000f0c0: 6720 7661 6c75 6573 206f 660a 2020 2020 g values of. │ │ │ │ │ -0000f0d0: 2027 4752 5542 5f44 4546 4155 4c54 272c 'GRUB_DEFAULT', │ │ │ │ │ -0000f0e0: 2027 6661 6c6c 6261 636b 2720 282a 6e6f 'fallback' (*no │ │ │ │ │ -0000f0f0: 7465 2066 616c 6c62 6163 6b3a 3a29 2061 te fallback::) a │ │ │ │ │ -0000f100: 6e64 2027 6465 6661 756c 7427 2028 2a6e nd 'default' (*n │ │ │ │ │ -0000f110: 6f74 650a 2020 2020 2064 6566 6175 6c74 ote. default │ │ │ │ │ -0000f120: 3a3a 2920 656e 7669 726f 6e6d 656e 7420 ::) environment │ │ │ │ │ -0000f130: 7661 7269 6162 6c65 7320 6173 2077 656c variables as wel │ │ │ │ │ -0000f140: 6c20 6173 2073 6176 6564 2064 6566 6175 l as saved defau │ │ │ │ │ -0000f150: 6c74 2065 6e74 7279 0a20 2020 2020 7573 lt entry. us │ │ │ │ │ -0000f160: 696e 6720 2767 7275 622d 7365 742d 6465 ing 'grub-set-de │ │ │ │ │ -0000f170: 6661 756c 7427 2061 6e64 2076 616c 7565 fault' and value │ │ │ │ │ -0000f180: 2075 7365 6420 7769 7468 2027 6772 7562 used with 'grub │ │ │ │ │ -0000f190: 2d72 6562 6f6f 7427 2e0a 0a27 4752 5542 -reboot'...'GRUB │ │ │ │ │ -0000f1a0: 5f45 4e41 424c 455f 4352 5950 544f 4449 _ENABLE_CRYPTODI │ │ │ │ │ -0000f1b0: 534b 270a 2020 2020 2049 6620 7365 7420 SK'. If set │ │ │ │ │ -0000f1c0: 746f 2027 7927 2c20 2767 7275 622d 6d6b to 'y', 'grub-mk │ │ │ │ │ -0000f1d0: 636f 6e66 6967 2720 616e 6420 2767 7275 config' and 'gru │ │ │ │ │ -0000f1e0: 622d 696e 7374 616c 6c27 2077 696c 6c20 b-install' will │ │ │ │ │ -0000f1f0: 6368 6563 6b20 666f 720a 2020 2020 2065 check for. e │ │ │ │ │ -0000f200: 6e63 7279 7074 6564 2064 6973 6b73 2061 ncrypted disks a │ │ │ │ │ -0000f210: 6e64 2067 656e 6572 6174 6520 6164 6469 nd generate addi │ │ │ │ │ -0000f220: 7469 6f6e 616c 2063 6f6d 6d61 6e64 7320 tional commands │ │ │ │ │ -0000f230: 6e65 6564 6564 2074 6f20 6163 6365 7373 needed to access │ │ │ │ │ -0000f240: 0a20 2020 2020 7468 656d 2064 7572 696e . them durin │ │ │ │ │ -0000f250: 6720 626f 6f74 2e20 204e 6f74 6520 7468 g boot. Note th │ │ │ │ │ -0000f260: 6174 2069 6e20 7468 6973 2063 6173 6520 at in this case │ │ │ │ │ -0000f270: 756e 6174 7465 6e64 6564 2062 6f6f 7420 unattended boot │ │ │ │ │ -0000f280: 6973 206e 6f74 0a20 2020 2020 706f 7373 is not. poss │ │ │ │ │ -0000f290: 6962 6c65 2062 6563 6175 7365 2047 5255 ible because GRU │ │ │ │ │ -0000f2a0: 4220 7769 6c6c 2077 6169 7420 666f 7220 B will wait for │ │ │ │ │ -0000f2b0: 7061 7373 7068 7261 7365 2074 6f20 756e passphrase to un │ │ │ │ │ -0000f2c0: 6c6f 636b 2065 6e63 7279 7074 6564 0a20 lock encrypted. │ │ │ │ │ -0000f2d0: 2020 2020 636f 6e74 6169 6e65 722e 0a0a container... │ │ │ │ │ -0000f2e0: 2747 5255 425f 494e 4954 5f54 554e 4527 'GRUB_INIT_TUNE' │ │ │ │ │ -0000f2f0: 0a20 2020 2020 506c 6179 2061 2074 756e . Play a tun │ │ │ │ │ -0000f300: 6520 6f6e 2074 6865 2073 7065 616b 6572 e on the speaker │ │ │ │ │ -0000f310: 2077 6865 6e20 4752 5542 2073 7461 7274 when GRUB start │ │ │ │ │ -0000f320: 732e 2020 5468 6973 2069 7320 7061 7274 s. This is part │ │ │ │ │ -0000f330: 6963 756c 6172 6c79 0a20 2020 2020 7573 icularly. us │ │ │ │ │ -0000f340: 6566 756c 2066 6f72 2075 7365 7273 2075 eful for users u │ │ │ │ │ -0000f350: 6e61 626c 6520 746f 2073 6565 2074 6865 nable to see the │ │ │ │ │ -0000f360: 2073 6372 6565 6e2e 2020 5468 6520 7661 screen. The va │ │ │ │ │ -0000f370: 6c75 6520 6f66 2074 6869 730a 2020 2020 lue of this. │ │ │ │ │ -0000f380: 206f 7074 696f 6e20 6973 2070 6173 7365 option is passe │ │ │ │ │ -0000f390: 6420 6469 7265 6374 6c79 2074 6f20 2a6e d directly to *n │ │ │ │ │ -0000f3a0: 6f74 6520 706c 6179 3a3a 2e0a 0a27 4752 ote play::...'GR │ │ │ │ │ -0000f3b0: 5542 5f42 4144 5241 4d27 0a20 2020 2020 UB_BADRAM'. │ │ │ │ │ -0000f3c0: 4966 2074 6869 7320 6f70 7469 6f6e 2069 If this option i │ │ │ │ │ -0000f3d0: 7320 7365 742c 2047 5255 4220 7769 6c6c s set, GRUB will │ │ │ │ │ -0000f3e0: 2069 7373 7565 2061 202a 6e6f 7465 2062 issue a *note b │ │ │ │ │ -0000f3f0: 6164 7261 6d3a 3a20 636f 6d6d 616e 6420 adram:: command │ │ │ │ │ -0000f400: 746f 0a20 2020 2020 6669 6c74 6572 206f to. filter o │ │ │ │ │ -0000f410: 7574 2073 7065 6369 6669 6564 2072 6567 ut specified reg │ │ │ │ │ -0000f420: 696f 6e73 206f 6620 5241 4d2e 0a0a 2747 ions of RAM...'G │ │ │ │ │ -0000f430: 5255 425f 5052 454c 4f41 445f 4d4f 4455 RUB_PRELOAD_MODU │ │ │ │ │ -0000f440: 4c45 5327 0a20 2020 2020 5468 6973 206f LES'. This o │ │ │ │ │ -0000f450: 7074 696f 6e20 6d61 7920 6265 2073 6574 ption may be set │ │ │ │ │ -0000f460: 2074 6f20 6120 6c69 7374 206f 6620 4752 to a list of GR │ │ │ │ │ -0000f470: 5542 206d 6f64 756c 6520 6e61 6d65 7320 UB module names │ │ │ │ │ -0000f480: 7365 7061 7261 7465 6420 6279 0a20 2020 separated by. │ │ │ │ │ -0000f490: 2020 7370 6163 6573 2e20 2045 6163 6820 spaces. Each │ │ │ │ │ -0000f4a0: 6d6f 6475 6c65 2077 696c 6c20 6265 206c module will be l │ │ │ │ │ -0000f4b0: 6f61 6465 6420 6173 2065 6172 6c79 2061 oaded as early a │ │ │ │ │ -0000f4c0: 7320 706f 7373 6962 6c65 2c20 6174 2074 s possible, at t │ │ │ │ │ -0000f4d0: 6865 0a20 2020 2020 7374 6172 7420 6f66 he. start of │ │ │ │ │ -0000f4e0: 2027 6772 7562 2e63 6667 272e 0a0a 2747 'grub.cfg'...'G │ │ │ │ │ -0000f4f0: 5255 425f 5245 434f 5244 4641 494c 5f54 RUB_RECORDFAIL_T │ │ │ │ │ -0000f500: 494d 454f 5554 270a 2020 2020 2049 6620 IMEOUT'. If │ │ │ │ │ -0000f510: 7468 6973 206f 7074 696f 6e20 6973 2073 this option is s │ │ │ │ │ -0000f520: 6574 2c20 6974 206f 7665 7272 6964 6573 et, it overrides │ │ │ │ │ -0000f530: 2074 6865 2064 6566 6175 6c74 2072 6563 the default rec │ │ │ │ │ -0000f540: 6f72 6466 6169 6c20 7365 7474 696e 672e ordfail setting. │ │ │ │ │ -0000f550: 0a20 2020 2020 4120 7365 7474 696e 6720 . A setting │ │ │ │ │ -0000f560: 6f66 202d 3120 6361 7573 6573 2047 5255 of -1 causes GRU │ │ │ │ │ -0000f570: 4220 746f 2077 6169 7420 666f 7220 7573 B to wait for us │ │ │ │ │ -0000f580: 6572 2069 6e70 7574 2069 6e64 6566 696e er input indefin │ │ │ │ │ -0000f590: 6974 656c 792e 0a20 2020 2020 486f 7765 itely.. Howe │ │ │ │ │ -0000f5a0: 7665 722c 2061 2066 616c 7365 2070 6f73 ver, a false pos │ │ │ │ │ -0000f5b0: 6974 6976 6520 696e 2074 6865 2072 6563 itive in the rec │ │ │ │ │ -0000f5c0: 6f72 6466 6169 6c20 6d65 6368 616e 6973 ordfail mechanis │ │ │ │ │ -0000f5d0: 6d20 6d61 7920 6f63 6375 7220 6966 0a20 m may occur if. │ │ │ │ │ -0000f5e0: 2020 2020 706f 7765 7220 6973 206c 6f73 power is los │ │ │ │ │ -0000f5f0: 7420 6475 7269 6e67 2062 6f6f 7420 6265 t during boot be │ │ │ │ │ -0000f600: 666f 7265 2062 6f6f 7420 7375 6363 6573 fore boot succes │ │ │ │ │ -0000f610: 7320 6973 2072 6563 6f72 6465 6420 696e s is recorded in │ │ │ │ │ -0000f620: 0a20 2020 2020 7573 6572 7370 6163 652e . userspace. │ │ │ │ │ -0000f630: 2020 5468 6520 6465 6661 756c 7420 7365 The default se │ │ │ │ │ -0000f640: 7474 696e 6720 6973 2033 302c 2077 6869 tting is 30, whi │ │ │ │ │ -0000f650: 6368 2063 6175 7365 7320 4752 5542 2074 ch causes GRUB t │ │ │ │ │ -0000f660: 6f20 7761 6974 0a20 2020 2020 666f 7220 o wait. for │ │ │ │ │ -0000f670: 7573 6572 2069 6e70 7574 2066 6f72 2074 user input for t │ │ │ │ │ -0000f680: 6869 7274 7920 7365 636f 6e64 7320 6265 hirty seconds be │ │ │ │ │ -0000f690: 666f 7265 2063 6f6e 7469 6e75 696e 672e fore continuing. │ │ │ │ │ -0000f6a0: 2020 5468 6973 2064 6566 6175 6c74 0a20 This default. │ │ │ │ │ -0000f6b0: 2020 2020 616c 6c6f 7773 2069 6e74 6572 allows inter │ │ │ │ │ -0000f6c0: 6163 7469 7665 2075 7365 7273 2074 6865 active users the │ │ │ │ │ -0000f6d0: 206f 7070 6f72 7475 6e69 7479 2074 6f20 opportunity to │ │ │ │ │ -0000f6e0: 7377 6974 6368 2074 6f20 6120 6469 6666 switch to a diff │ │ │ │ │ -0000f6f0: 6572 656e 742c 0a20 2020 2020 776f 726b erent,. work │ │ │ │ │ -0000f700: 696e 6720 6b65 726e 656c 2c20 7768 696c ing kernel, whil │ │ │ │ │ -0000f710: 6520 6176 6f69 6469 6e67 2061 2066 616c e avoiding a fal │ │ │ │ │ -0000f720: 7365 2070 6f73 6974 6976 6520 6361 7573 se positive caus │ │ │ │ │ -0000f730: 696e 6720 7468 6520 626f 6f74 2074 6f0a ing the boot to. │ │ │ │ │ -0000f740: 2020 2020 2062 6c6f 636b 2069 6e64 6566 block indef │ │ │ │ │ -0000f750: 696e 6974 656c 7920 6f6e 2068 6561 646c initely on headl │ │ │ │ │ -0000f760: 6573 7320 616e 6420 6170 706c 6961 6e63 ess and applianc │ │ │ │ │ -0000f770: 6520 7379 7374 656d 7320 7768 6572 6520 e systems where │ │ │ │ │ -0000f780: 6163 6365 7373 0a20 2020 2020 746f 2061 access. to a │ │ │ │ │ -0000f790: 2063 6f6e 736f 6c65 2069 7320 7265 7374 console is rest │ │ │ │ │ -0000f7a0: 7269 6374 6564 206f 7220 6c69 6d69 7465 ricted or limite │ │ │ │ │ -0000f7b0: 642e 0a0a 2020 2020 2054 6869 7320 6f70 d... This op │ │ │ │ │ -0000f7c0: 7469 6f6e 2069 7320 6f6e 6c79 2065 6666 tion is only eff │ │ │ │ │ -0000f7d0: 6563 7469 7665 2077 6865 6e20 4752 5542 ective when GRUB │ │ │ │ │ -0000f7e0: 2077 6173 2063 6f6e 6669 6775 7265 6420 was configured │ │ │ │ │ -0000f7f0: 7769 7468 2074 6865 0a20 2020 2020 272d with the. '- │ │ │ │ │ -0000f800: 2d65 6e61 626c 652d 7175 6963 6b2d 626f -enable-quick-bo │ │ │ │ │ -0000f810: 6f74 2720 6f70 7469 6f6e 2e0a 0a27 4752 ot' option...'GR │ │ │ │ │ -0000f820: 5542 5f52 4543 4f56 4552 595f 5449 544c UB_RECOVERY_TITL │ │ │ │ │ -0000f830: 4527 0a20 2020 2020 5468 6973 206f 7074 E'. This opt │ │ │ │ │ -0000f840: 696f 6e20 7365 7473 2074 6865 2045 6e67 ion sets the Eng │ │ │ │ │ -0000f850: 6c69 7368 2074 6578 7420 6f66 2074 6865 lish text of the │ │ │ │ │ -0000f860: 2073 7472 696e 6720 7468 6174 2077 696c string that wil │ │ │ │ │ -0000f870: 6c20 6265 0a20 2020 2020 6469 7370 6c61 l be. displa │ │ │ │ │ -0000f880: 7965 6420 696e 2070 6172 656e 7468 6573 yed in parenthes │ │ │ │ │ -0000f890: 6573 2074 6f20 696e 6469 6361 7465 2074 es to indicate t │ │ │ │ │ -0000f8a0: 6861 7420 6120 626f 6f74 206f 7074 696f hat a boot optio │ │ │ │ │ -0000f8b0: 6e20 6973 2070 726f 7669 6465 640a 2020 n is provided. │ │ │ │ │ -0000f8c0: 2020 2074 6f20 6865 6c70 2075 7365 7273 to help users │ │ │ │ │ -0000f8d0: 2072 6563 6f76 6572 2061 2062 726f 6b65 recover a broke │ │ │ │ │ -0000f8e0: 6e20 7379 7374 656d 2e20 2054 6865 2064 n system. The d │ │ │ │ │ -0000f8f0: 6566 6175 6c74 2069 7320 2272 6563 6f76 efault is "recov │ │ │ │ │ -0000f900: 6572 790a 2020 2020 206d 6f64 6522 2e0a ery. mode".. │ │ │ │ │ -0000f910: 0a20 2020 5468 6520 666f 6c6c 6f77 696e . The followin │ │ │ │ │ -0000f920: 6720 6f70 7469 6f6e 7320 6172 6520 7374 g options are st │ │ │ │ │ -0000f930: 696c 6c20 6163 6365 7074 6564 2066 6f72 ill accepted for │ │ │ │ │ -0000f940: 2063 6f6d 7061 7469 6269 6c69 7479 2077 compatibility w │ │ │ │ │ -0000f950: 6974 680a 6578 6973 7469 6e67 2063 6f6e ith.existing con │ │ │ │ │ -0000f960: 6669 6775 7261 7469 6f6e 732c 2062 7574 figurations, but │ │ │ │ │ -0000f970: 2068 6176 6520 6265 7474 6572 2072 6570 have better rep │ │ │ │ │ -0000f980: 6c61 6365 6d65 6e74 733a 0a0a 2747 5255 lacements:..'GRU │ │ │ │ │ -0000f990: 425f 4849 4444 454e 5f54 494d 454f 5554 B_HIDDEN_TIMEOUT │ │ │ │ │ -0000f9a0: 270a 2020 2020 2057 6169 7420 7468 6973 '. Wait this │ │ │ │ │ -0000f9b0: 206d 616e 7920 7365 636f 6e64 7320 6265 many seconds be │ │ │ │ │ -0000f9c0: 666f 7265 2064 6973 706c 6179 696e 6720 fore displaying │ │ │ │ │ -0000f9d0: 7468 6520 6d65 6e75 2e20 2049 6620 3c45 the menu. If or. │ │ │ │ │ -0000f9f0: 2061 7265 2070 7265 7373 6564 2c20 6f72 are pressed, or │ │ │ │ │ -0000fa00: 203c 5348 4946 543e 2069 7320 6865 6c64 is held │ │ │ │ │ -0000fa10: 2064 6f77 6e20 6475 7269 6e67 2074 6861 down during tha │ │ │ │ │ -0000fa20: 7420 7469 6d65 2c20 6469 7370 6c61 790a t time, display. │ │ │ │ │ -0000fa30: 2020 2020 2074 6865 206d 656e 7520 616e the menu an │ │ │ │ │ -0000fa40: 6420 7761 6974 2066 6f72 2069 6e70 7574 d wait for input │ │ │ │ │ -0000fa50: 2061 6363 6f72 6469 6e67 2074 6f20 2747 according to 'G │ │ │ │ │ -0000fa60: 5255 425f 5449 4d45 4f55 5427 2e20 2049 RUB_TIMEOUT'. I │ │ │ │ │ -0000fa70: 6620 610a 2020 2020 2068 6f74 6b65 7920 f a. hotkey │ │ │ │ │ -0000fa80: 6173 736f 6369 6174 6564 2077 6974 6820 associated with │ │ │ │ │ -0000fa90: 6120 6d65 6e75 2065 6e74 7279 2069 7320 a menu entry is │ │ │ │ │ -0000faa0: 7072 6573 7365 642c 2062 6f6f 7420 7468 pressed, boot th │ │ │ │ │ -0000fab0: 6520 6173 736f 6369 6174 6564 0a20 2020 e associated. │ │ │ │ │ -0000fac0: 2020 6d65 6e75 2065 6e74 7279 2069 6d6d menu entry imm │ │ │ │ │ -0000fad0: 6564 6961 7465 6c79 2e20 2049 6620 7468 ediately. If th │ │ │ │ │ -0000fae0: 6520 7469 6d65 6f75 7420 6578 7069 7265 e timeout expire │ │ │ │ │ -0000faf0: 7320 6265 666f 7265 2065 6974 6865 7220 s before either │ │ │ │ │ -0000fb00: 6f66 0a20 2020 2020 7468 6573 6520 6861 of. these ha │ │ │ │ │ -0000fb10: 7070 656e 732c 2064 6973 706c 6179 2074 ppens, display t │ │ │ │ │ -0000fb20: 6865 206d 656e 7520 666f 7220 7468 6520 he menu for the │ │ │ │ │ -0000fb30: 6e75 6d62 6572 206f 6620 7365 636f 6e64 number of second │ │ │ │ │ -0000fb40: 7320 7370 6563 6966 6965 640a 2020 2020 s specified. │ │ │ │ │ -0000fb50: 2069 6e20 2747 5255 425f 5449 4d45 4f55 in 'GRUB_TIMEOU │ │ │ │ │ -0000fb60: 5427 2062 6566 6f72 6520 626f 6f74 696e T' before bootin │ │ │ │ │ -0000fb70: 6720 7468 6520 6465 6661 756c 7420 656e g the default en │ │ │ │ │ -0000fb80: 7472 792e 0a0a 2020 2020 2049 6620 796f try... If yo │ │ │ │ │ -0000fb90: 7520 7365 7420 2747 5255 425f 4849 4444 u set 'GRUB_HIDD │ │ │ │ │ -0000fba0: 454e 5f54 494d 454f 5554 272c 2079 6f75 EN_TIMEOUT', you │ │ │ │ │ -0000fbb0: 2073 686f 756c 6420 616c 736f 2073 6574 should also set │ │ │ │ │ -0000fbc0: 0a20 2020 2020 2747 5255 425f 5449 4d45 . 'GRUB_TIME │ │ │ │ │ -0000fbd0: 4f55 543d 3027 2073 6f20 7468 6174 2074 OUT=0' so that t │ │ │ │ │ -0000fbe0: 6865 206d 656e 7520 6973 206e 6f74 2064 he menu is not d │ │ │ │ │ -0000fbf0: 6973 706c 6179 6564 2061 7420 616c 6c20 isplayed at all │ │ │ │ │ -0000fc00: 756e 6c65 7373 0a20 2020 2020 3c45 5343 unless. or are pr │ │ │ │ │ -0000fc20: 6573 7365 642c 206f 7220 3c53 4849 4654 essed, or is held down.. │ │ │ │ │ -0000fc40: 0a20 2020 2020 5468 6973 206f 7074 696f . This optio │ │ │ │ │ -0000fc50: 6e20 6973 2075 6e73 6574 2062 7920 6465 n is unset by de │ │ │ │ │ -0000fc60: 6661 756c 742c 2061 6e64 2069 7320 6465 fault, and is de │ │ │ │ │ -0000fc70: 7072 6563 6174 6564 2069 6e20 6661 766f precated in favo │ │ │ │ │ -0000fc80: 7572 206f 6620 7468 650a 2020 2020 206c ur of the. l │ │ │ │ │ -0000fc90: 6573 7320 636f 6e66 7573 696e 6720 2747 ess confusing 'G │ │ │ │ │ -0000fca0: 5255 425f 5449 4d45 4f55 545f 5354 594c RUB_TIMEOUT_STYL │ │ │ │ │ -0000fcb0: 453d 636f 756e 7464 6f77 6e27 206f 720a E=countdown' or. │ │ │ │ │ -0000fcc0: 2020 2020 2027 4752 5542 5f54 494d 454f 'GRUB_TIMEO │ │ │ │ │ -0000fcd0: 5554 5f53 5459 4c45 3d68 6964 6465 6e27 UT_STYLE=hidden' │ │ │ │ │ -0000fce0: 2e0a 0a27 4752 5542 5f48 4944 4445 4e5f ...'GRUB_HIDDEN_ │ │ │ │ │ -0000fcf0: 5449 4d45 4f55 545f 5155 4945 5427 0a20 TIMEOUT_QUIET'. │ │ │ │ │ -0000fd00: 2020 2020 496e 2063 6f6e 6a75 6e63 7469 In conjuncti │ │ │ │ │ -0000fd10: 6f6e 2077 6974 6820 2747 5255 425f 4849 on with 'GRUB_HI │ │ │ │ │ -0000fd20: 4444 454e 5f54 494d 454f 5554 272c 2073 DDEN_TIMEOUT', s │ │ │ │ │ -0000fd30: 6574 2074 6869 7320 746f 2027 7472 7565 et this to 'true │ │ │ │ │ -0000fd40: 2720 746f 0a20 2020 2020 7375 7070 7265 ' to. suppre │ │ │ │ │ -0000fd50: 7373 2074 6865 2076 6572 626f 7365 2063 ss the verbose c │ │ │ │ │ -0000fd60: 6f75 6e74 646f 776e 2077 6869 6c65 2077 ountdown while w │ │ │ │ │ -0000fd70: 6169 7469 6e67 2066 6f72 2061 206b 6579 aiting for a key │ │ │ │ │ -0000fd80: 2074 6f20 6265 0a20 2020 2020 7072 6573 to be. pres │ │ │ │ │ -0000fd90: 7365 6420 6265 666f 7265 2064 6973 706c sed before displ │ │ │ │ │ -0000fda0: 6179 696e 6720 7468 6520 6d65 6e75 2e0a aying the menu.. │ │ │ │ │ -0000fdb0: 0a20 2020 2020 5468 6973 206f 7074 696f . This optio │ │ │ │ │ -0000fdc0: 6e20 6973 2075 6e73 6574 2062 7920 6465 n is unset by de │ │ │ │ │ -0000fdd0: 6661 756c 742c 2061 6e64 2069 7320 6465 fault, and is de │ │ │ │ │ -0000fde0: 7072 6563 6174 6564 2069 6e20 6661 766f precated in favo │ │ │ │ │ -0000fdf0: 7572 206f 6620 7468 650a 2020 2020 206c ur of the. l │ │ │ │ │ -0000fe00: 6573 7320 636f 6e66 7573 696e 6720 2747 ess confusing 'G │ │ │ │ │ -0000fe10: 5255 425f 5449 4d45 4f55 545f 5354 594c RUB_TIMEOUT_STYL │ │ │ │ │ -0000fe20: 453d 636f 756e 7464 6f77 6e27 2e0a 0a27 E=countdown'...' │ │ │ │ │ -0000fe30: 4752 5542 5f48 4944 4445 4e5f 5449 4d45 GRUB_HIDDEN_TIME │ │ │ │ │ -0000fe40: 4f55 545f 4255 5454 4f4e 270a 2020 2020 OUT_BUTTON'. │ │ │ │ │ -0000fe50: 2056 6172 6961 6e74 206f 6620 2747 5255 Variant of 'GRU │ │ │ │ │ -0000fe60: 425f 4849 4444 454e 5f54 494d 454f 5554 B_HIDDEN_TIMEOUT │ │ │ │ │ -0000fe70: 272c 2075 7365 6420 746f 2073 7570 706f ', used to suppo │ │ │ │ │ -0000fe80: 7274 2076 656e 646f 722d 7370 6563 6966 rt vendor-specif │ │ │ │ │ -0000fe90: 6963 0a20 2020 2020 706f 7765 7220 6275 ic. power bu │ │ │ │ │ -0000fea0: 7474 6f6e 732e 2020 2a4e 6f74 6520 5665 ttons. *Note Ve │ │ │ │ │ -0000feb0: 6e64 6f72 2070 6f77 6572 2d6f 6e20 6b65 ndor power-on ke │ │ │ │ │ -0000fec0: 7973 3a3a 2e0a 0a20 2020 2020 5468 6973 ys::... This │ │ │ │ │ -0000fed0: 206f 7074 696f 6e20 6973 2075 6e73 6574 option is unset │ │ │ │ │ -0000fee0: 2062 7920 6465 6661 756c 742c 2061 6e64 by default, and │ │ │ │ │ -0000fef0: 2069 7320 6465 7072 6563 6174 6564 2069 is deprecated i │ │ │ │ │ -0000ff00: 6e20 6661 766f 7572 206f 6620 7468 650a n favour of the. │ │ │ │ │ -0000ff10: 2020 2020 206c 6573 7320 636f 6e66 7573 less confus │ │ │ │ │ -0000ff20: 696e 6720 2747 5255 425f 5449 4d45 4f55 ing 'GRUB_TIMEOU │ │ │ │ │ -0000ff30: 545f 5354 594c 453d 636f 756e 7464 6f77 T_STYLE=countdow │ │ │ │ │ -0000ff40: 6e27 206f 720a 2020 2020 2027 4752 5542 n' or. 'GRUB │ │ │ │ │ -0000ff50: 5f54 494d 454f 5554 5f53 5459 4c45 3d68 _TIMEOUT_STYLE=h │ │ │ │ │ -0000ff60: 6964 6465 6e27 2e0a 0a20 2020 466f 7220 idden'... For │ │ │ │ │ -0000ff70: 6d6f 7265 2064 6574 6169 6c65 6420 6375 more detailed cu │ │ │ │ │ -0000ff80: 7374 6f6d 6973 6174 696f 6e20 6f66 2027 stomisation of ' │ │ │ │ │ -0000ff90: 6772 7562 2d6d 6b63 6f6e 6669 6727 2773 grub-mkconfig''s │ │ │ │ │ -0000ffa0: 206f 7574 7075 742c 2079 6f75 206d 6179 output, you may │ │ │ │ │ -0000ffb0: 0a65 6469 7420 7468 6520 7363 7269 7074 .edit the script │ │ │ │ │ -0000ffc0: 7320 696e 2027 2f65 7463 2f67 7275 622e s in '/etc/grub. │ │ │ │ │ -0000ffd0: 6427 2064 6972 6563 746c 792e 2020 272f d' directly. '/ │ │ │ │ │ -0000ffe0: 6574 632f 6772 7562 2e64 2f34 305f 6375 etc/grub.d/40_cu │ │ │ │ │ -0000fff0: 7374 6f6d 2720 6973 0a70 6172 7469 6375 stom' is.particu │ │ │ │ │ -00010000: 6c61 726c 7920 7573 6566 756c 2066 6f72 larly useful for │ │ │ │ │ -00010010: 2061 6464 696e 6720 656e 7469 7265 2063 adding entire c │ │ │ │ │ -00010020: 7573 746f 6d20 6d65 6e75 2065 6e74 7269 ustom menu entri │ │ │ │ │ -00010030: 6573 3b20 7369 6d70 6c79 2074 7970 650a es; simply type. │ │ │ │ │ -00010040: 7468 6520 6d65 6e75 2065 6e74 7269 6573 the menu entries │ │ │ │ │ -00010050: 2079 6f75 2077 616e 7420 746f 2061 6464 you want to add │ │ │ │ │ -00010060: 2061 7420 7468 6520 656e 6420 6f66 2074 at the end of t │ │ │ │ │ -00010070: 6861 7420 6669 6c65 2c20 6d61 6b69 6e67 hat file, making │ │ │ │ │ -00010080: 2073 7572 6520 746f 0a6c 6561 7665 2061 sure to.leave a │ │ │ │ │ -00010090: 7420 6c65 6173 7420 7468 6520 6669 7273 t least the firs │ │ │ │ │ -000100a0: 7420 7477 6f20 6c69 6e65 7320 696e 7461 t two lines inta │ │ │ │ │ -000100b0: 6374 2e0a 0a1f 0a46 696c 653a 2067 7275 ct.....File: gru │ │ │ │ │ -000100c0: 622e 696e 666f 2c20 204e 6f64 653a 2052 b.info, Node: R │ │ │ │ │ -000100d0: 6f6f 7420 4964 656e 7469 6663 6174 696f oot Identifcatio │ │ │ │ │ -000100e0: 6e20 4865 7572 6973 7469 6373 2c20 204e n Heuristics, N │ │ │ │ │ -000100f0: 6578 743a 2053 6865 6c6c 2d6c 696b 6520 ext: Shell-like │ │ │ │ │ -00010100: 7363 7269 7074 696e 672c 2020 5072 6576 scripting, Prev │ │ │ │ │ -00010110: 3a20 5369 6d70 6c65 2063 6f6e 6669 6775 : Simple configu │ │ │ │ │ -00010120: 7261 7469 6f6e 2c20 2055 703a 2043 6f6e ration, Up: Con │ │ │ │ │ -00010130: 6669 6775 7261 7469 6f6e 0a0a 362e 3220 figuration..6.2 │ │ │ │ │ -00010140: 526f 6f74 2049 6465 6e74 6966 6361 7469 Root Identifcati │ │ │ │ │ -00010150: 6f6e 2048 6575 7269 7374 6963 730a 3d3d on Heuristics.== │ │ │ │ │ +0000bd30: 3d3d 3d3d 3d3d 0a0a 5468 6520 7072 6f67 ======..The prog │ │ │ │ │ +0000bd40: 7261 6d20 2767 7275 622d 6d6b 636f 6e66 ram 'grub-mkconf │ │ │ │ │ +0000bd50: 6967 2720 282a 6e6f 7465 2049 6e76 6f6b ig' (*note Invok │ │ │ │ │ +0000bd60: 696e 6720 6772 7562 2d6d 6b63 6f6e 6669 ing grub-mkconfi │ │ │ │ │ +0000bd70: 673a 3a29 2067 656e 6572 6174 6573 0a27 g::) generates.' │ │ │ │ │ +0000bd80: 6772 7562 2e63 6667 2720 6669 6c65 7320 grub.cfg' files │ │ │ │ │ +0000bd90: 7375 6974 6162 6c65 2066 6f72 206d 6f73 suitable for mos │ │ │ │ │ +0000bda0: 7420 6361 7365 732e 2020 4974 2069 7320 t cases. It is │ │ │ │ │ +0000bdb0: 7375 6974 6162 6c65 2066 6f72 2075 7365 suitable for use │ │ │ │ │ +0000bdc0: 2077 6865 6e0a 7570 6772 6164 696e 6720 when.upgrading │ │ │ │ │ +0000bdd0: 6120 6469 7374 7269 6275 7469 6f6e 2c20 a distribution, │ │ │ │ │ +0000bde0: 616e 6420 7769 6c6c 2064 6973 636f 7665 and will discove │ │ │ │ │ +0000bdf0: 7220 6176 6169 6c61 626c 6520 6b65 726e r available kern │ │ │ │ │ +0000be00: 656c 7320 616e 640a 6174 7465 6d70 7420 els and.attempt │ │ │ │ │ +0000be10: 746f 2067 656e 6572 6174 6520 6d65 6e75 to generate menu │ │ │ │ │ +0000be20: 2065 6e74 7269 6573 2066 6f72 2074 6865 entries for the │ │ │ │ │ +0000be30: 6d2e 0a0a 2020 2027 6772 7562 2d6d 6b63 m... 'grub-mkc │ │ │ │ │ +0000be40: 6f6e 6669 6727 2064 6f65 7320 6861 7665 onfig' does have │ │ │ │ │ +0000be50: 2073 6f6d 6520 6c69 6d69 7461 7469 6f6e some limitation │ │ │ │ │ +0000be60: 732e 2020 5768 696c 6520 6164 6469 6e67 s. While adding │ │ │ │ │ +0000be70: 2065 7874 7261 0a63 7573 746f 6d20 6d65 extra.custom me │ │ │ │ │ +0000be80: 6e75 2065 6e74 7269 6573 2074 6f20 7468 nu entries to th │ │ │ │ │ +0000be90: 6520 656e 6420 6f66 2074 6865 206c 6973 e end of the lis │ │ │ │ │ +0000bea0: 7420 6361 6e20 6265 2064 6f6e 6520 6279 t can be done by │ │ │ │ │ +0000beb0: 2065 6469 7469 6e67 0a27 2f65 7463 2f67 editing.'/etc/g │ │ │ │ │ +0000bec0: 7275 622e 642f 3430 5f63 7573 746f 6d27 rub.d/40_custom' │ │ │ │ │ +0000bed0: 206f 7220 6372 6561 7469 6e67 2027 2f62 or creating '/b │ │ │ │ │ +0000bee0: 6f6f 742f 6772 7562 2f63 7573 746f 6d2e oot/grub/custom. │ │ │ │ │ +0000bef0: 6366 6727 2c20 6368 616e 6769 6e67 0a74 cfg', changing.t │ │ │ │ │ +0000bf00: 6865 206f 7264 6572 206f 6620 6d65 6e75 he order of menu │ │ │ │ │ +0000bf10: 2065 6e74 7269 6573 206f 7220 6368 616e entries or chan │ │ │ │ │ +0000bf20: 6769 6e67 2074 6865 6972 2074 6974 6c65 ging their title │ │ │ │ │ +0000bf30: 7320 6d61 7920 7265 7175 6972 6520 6d61 s may require ma │ │ │ │ │ +0000bf40: 6b69 6e67 0a63 6f6d 706c 6578 2063 6861 king.complex cha │ │ │ │ │ +0000bf50: 6e67 6573 2074 6f20 7368 656c 6c20 7363 nges to shell sc │ │ │ │ │ +0000bf60: 7269 7074 7320 7374 6f72 6564 2069 6e20 ripts stored in │ │ │ │ │ +0000bf70: 272f 6574 632f 6772 7562 2e64 2f27 2e20 '/etc/grub.d/'. │ │ │ │ │ +0000bf80: 2054 6869 7320 6d61 7920 6265 0a69 6d70 This may be.imp │ │ │ │ │ +0000bf90: 726f 7665 6420 696e 2074 6865 2066 7574 roved in the fut │ │ │ │ │ +0000bfa0: 7572 652e 2020 496e 2074 6865 206d 6561 ure. In the mea │ │ │ │ │ +0000bfb0: 6e74 696d 652c 2074 686f 7365 2077 686f ntime, those who │ │ │ │ │ +0000bfc0: 2066 6565 6c20 7468 6174 2069 7420 776f feel that it wo │ │ │ │ │ +0000bfd0: 756c 640a 6265 2065 6173 6965 7220 746f uld.be easier to │ │ │ │ │ +0000bfe0: 2077 7269 7465 2027 6772 7562 2e63 6667 write 'grub.cfg │ │ │ │ │ +0000bff0: 2720 6469 7265 6374 6c79 2061 7265 2065 ' directly are e │ │ │ │ │ +0000c000: 6e63 6f75 7261 6765 6420 746f 2064 6f20 ncouraged to do │ │ │ │ │ +0000c010: 736f 2028 2a6e 6f74 650a 426f 6f74 696e so (*note.Bootin │ │ │ │ │ +0000c020: 673a 3a2c 2061 6e64 202a 6e6f 7465 2053 g::, and *note S │ │ │ │ │ +0000c030: 6865 6c6c 2d6c 696b 6520 7363 7269 7074 hell-like script │ │ │ │ │ +0000c040: 696e 673a 3a29 2c20 616e 6420 746f 2064 ing::), and to d │ │ │ │ │ +0000c050: 6973 6162 6c65 2061 6e79 2073 7973 7465 isable any syste │ │ │ │ │ +0000c060: 6d0a 7072 6f76 6964 6564 2062 7920 7468 m.provided by th │ │ │ │ │ +0000c070: 6569 7220 6469 7374 7269 6275 7469 6f6e eir distribution │ │ │ │ │ +0000c080: 2074 6f20 6175 746f 6d61 7469 6361 6c6c to automaticall │ │ │ │ │ +0000c090: 7920 7275 6e20 2767 7275 622d 6d6b 636f y run 'grub-mkco │ │ │ │ │ +0000c0a0: 6e66 6967 272e 0a0a 2020 2054 6865 2066 nfig'... The f │ │ │ │ │ +0000c0b0: 696c 6520 272f 6574 632f 6465 6661 756c ile '/etc/defaul │ │ │ │ │ +0000c0c0: 742f 6772 7562 2720 636f 6e74 726f 6c73 t/grub' controls │ │ │ │ │ +0000c0d0: 2074 6865 206f 7065 7261 7469 6f6e 206f the operation o │ │ │ │ │ +0000c0e0: 660a 2767 7275 622d 6d6b 636f 6e66 6967 f.'grub-mkconfig │ │ │ │ │ +0000c0f0: 272e 2020 4974 2069 7320 736f 7572 6365 '. It is source │ │ │ │ │ +0000c100: 6420 6279 2061 2073 6865 6c6c 2073 6372 d by a shell scr │ │ │ │ │ +0000c110: 6970 742c 2061 6e64 2073 6f20 6d75 7374 ipt, and so must │ │ │ │ │ +0000c120: 2062 6520 7661 6c69 640a 504f 5349 5820 be valid.POSIX │ │ │ │ │ +0000c130: 7368 656c 6c20 696e 7075 743b 206e 6f72 shell input; nor │ │ │ │ │ +0000c140: 6d61 6c6c 792c 2069 7420 7769 6c6c 206a mally, it will j │ │ │ │ │ +0000c150: 7573 7420 6265 2061 2073 6571 7565 6e63 ust be a sequenc │ │ │ │ │ +0000c160: 6520 6f66 2027 4b45 593d 7661 6c75 6527 e of 'KEY=value' │ │ │ │ │ +0000c170: 0a6c 696e 6573 2c20 6275 7420 6966 2074 .lines, but if t │ │ │ │ │ +0000c180: 6865 2076 616c 7565 2063 6f6e 7461 696e he value contain │ │ │ │ │ +0000c190: 7320 7370 6163 6573 206f 7220 6f74 6865 s spaces or othe │ │ │ │ │ +0000c1a0: 7220 7370 6563 6961 6c20 6368 6172 6163 r special charac │ │ │ │ │ +0000c1b0: 7465 7273 2074 6865 6e0a 6974 206d 7573 ters then.it mus │ │ │ │ │ +0000c1c0: 7420 6265 2071 756f 7465 642e 2020 466f t be quoted. Fo │ │ │ │ │ +0000c1d0: 7220 6578 616d 706c 653a 0a0a 2020 2020 r example:.. │ │ │ │ │ +0000c1e0: 2047 5255 425f 5445 524d 494e 414c 5f49 GRUB_TERMINAL_I │ │ │ │ │ +0000c1f0: 4e50 5554 3d22 636f 6e73 6f6c 6520 7365 NPUT="console se │ │ │ │ │ +0000c200: 7269 616c 220a 0a20 2020 5661 6c69 6420 rial".. Valid │ │ │ │ │ +0000c210: 6b65 7973 2069 6e20 272f 6574 632f 6465 keys in '/etc/de │ │ │ │ │ +0000c220: 6661 756c 742f 6772 7562 2720 6172 6520 fault/grub' are │ │ │ │ │ +0000c230: 6173 2066 6f6c 6c6f 7773 3a0a 0a27 4752 as follows:..'GR │ │ │ │ │ +0000c240: 5542 5f44 4546 4155 4c54 270a 2020 2020 UB_DEFAULT'. │ │ │ │ │ +0000c250: 2054 6865 2064 6566 6175 6c74 206d 656e The default men │ │ │ │ │ +0000c260: 7520 656e 7472 792e 2020 5468 6973 206d u entry. This m │ │ │ │ │ +0000c270: 6179 2062 6520 6120 6e75 6d62 6572 2c20 ay be a number, │ │ │ │ │ +0000c280: 696e 2077 6869 6368 2063 6173 6520 6974 in which case it │ │ │ │ │ +0000c290: 0a20 2020 2020 6964 656e 7469 6669 6573 . identifies │ │ │ │ │ +0000c2a0: 2074 6865 204e 7468 2065 6e74 7279 2069 the Nth entry i │ │ │ │ │ +0000c2b0: 6e20 7468 6520 6765 6e65 7261 7465 6420 n the generated │ │ │ │ │ +0000c2c0: 6d65 6e75 2063 6f75 6e74 6564 2066 726f menu counted fro │ │ │ │ │ +0000c2d0: 6d20 7a65 726f 2c0a 2020 2020 206f 7220 m zero,. or │ │ │ │ │ +0000c2e0: 7468 6520 7469 746c 6520 6f66 2061 206d the title of a m │ │ │ │ │ +0000c2f0: 656e 7520 656e 7472 792c 206f 7220 7468 enu entry, or th │ │ │ │ │ +0000c300: 6520 7370 6563 6961 6c20 7374 7269 6e67 e special string │ │ │ │ │ +0000c310: 2027 7361 7665 6427 2e20 2055 7369 6e67 'saved'. Using │ │ │ │ │ +0000c320: 0a20 2020 2020 7468 6520 6964 206d 6179 . the id may │ │ │ │ │ +0000c330: 2062 6520 7573 6566 756c 2069 6620 796f be useful if yo │ │ │ │ │ +0000c340: 7520 7761 6e74 2074 6f20 7365 7420 6120 u want to set a │ │ │ │ │ +0000c350: 6d65 6e75 2065 6e74 7279 2061 7320 7468 menu entry as th │ │ │ │ │ +0000c360: 6520 6465 6661 756c 740a 2020 2020 2065 e default. e │ │ │ │ │ +0000c370: 7665 6e20 7468 6f75 6768 2074 6865 7265 ven though there │ │ │ │ │ +0000c380: 206d 6179 2062 6520 6120 7661 7269 6162 may be a variab │ │ │ │ │ +0000c390: 6c65 206e 756d 6265 7220 6f66 2065 6e74 le number of ent │ │ │ │ │ +0000c3a0: 7269 6573 2062 6566 6f72 6520 6974 2e0a ries before it.. │ │ │ │ │ +0000c3b0: 0a20 2020 2020 466f 7220 6578 616d 706c . For exampl │ │ │ │ │ +0000c3c0: 652c 2069 6620 796f 7520 6861 7665 3a0a e, if you have:. │ │ │ │ │ +0000c3d0: 0a20 2020 2020 6d65 6e75 656e 7472 7920 . menuentry │ │ │ │ │ +0000c3e0: 2745 7861 6d70 6c65 2047 4e55 2f4c 696e 'Example GNU/Lin │ │ │ │ │ +0000c3f0: 7578 2064 6973 7472 6962 7574 696f 6e27 ux distribution' │ │ │ │ │ +0000c400: 202d 2d63 6c61 7373 2067 6e75 2d6c 696e --class gnu-lin │ │ │ │ │ +0000c410: 7578 202d 2d69 6420 6578 616d 706c 652d ux --id example- │ │ │ │ │ +0000c420: 676e 752d 6c69 6e75 7820 7b0a 2020 2020 gnu-linux {. │ │ │ │ │ +0000c430: 2009 2e2e 2e0a 2020 2020 207d 0a0a 2020 ..... }.. │ │ │ │ │ +0000c440: 2020 2074 6865 6e20 796f 7520 6361 6e20 then you can │ │ │ │ │ +0000c450: 6d61 6b65 2074 6869 7320 7468 6520 6465 make this the de │ │ │ │ │ +0000c460: 6661 756c 7420 7573 696e 673a 0a0a 2020 fault using:.. │ │ │ │ │ +0000c470: 2020 2020 2020 2020 4752 5542 5f44 4546 GRUB_DEF │ │ │ │ │ +0000c480: 4155 4c54 3d65 7861 6d70 6c65 2d67 6e75 AULT=example-gnu │ │ │ │ │ +0000c490: 2d6c 696e 7578 0a0a 2020 2020 2050 7265 -linux.. Pre │ │ │ │ │ +0000c4a0: 7669 6f75 736c 7920 6974 2077 6173 2064 viously it was d │ │ │ │ │ +0000c4b0: 6f63 756d 656e 7465 6420 7468 6520 7761 ocumented the wa │ │ │ │ │ +0000c4c0: 7920 746f 2075 7365 2065 6e74 7279 2074 y to use entry t │ │ │ │ │ +0000c4d0: 6974 6c65 2e20 2057 6869 6c65 0a20 2020 itle. While. │ │ │ │ │ +0000c4e0: 2020 7468 6973 2073 7469 6c6c 2077 6f72 this still wor │ │ │ │ │ +0000c4f0: 6b73 2069 7427 7320 6e6f 7420 7265 636f ks it's not reco │ │ │ │ │ +0000c500: 6d6d 656e 6465 6420 7369 6e63 6520 7469 mmended since ti │ │ │ │ │ +0000c510: 746c 6573 206f 6674 656e 2063 6f6e 7461 tles often conta │ │ │ │ │ +0000c520: 696e 0a20 2020 2020 756e 7374 6162 6c65 in. unstable │ │ │ │ │ +0000c530: 2064 6576 6963 6520 6e61 6d65 7320 616e device names an │ │ │ │ │ +0000c540: 6420 6d61 7920 6265 2074 7261 6e73 6c61 d may be transla │ │ │ │ │ +0000c550: 7465 640a 0a20 2020 2020 4966 2079 6f75 ted.. If you │ │ │ │ │ +0000c560: 2073 6574 2074 6869 7320 746f 2027 7361 set this to 'sa │ │ │ │ │ +0000c570: 7665 6427 2c20 7468 656e 2074 6865 2064 ved', then the d │ │ │ │ │ +0000c580: 6566 6175 6c74 206d 656e 7520 656e 7472 efault menu entr │ │ │ │ │ +0000c590: 7920 7769 6c6c 2062 650a 2020 2020 2074 y will be. t │ │ │ │ │ +0000c5a0: 6861 7420 7361 7665 6420 6279 2027 4752 hat saved by 'GR │ │ │ │ │ +0000c5b0: 5542 5f53 4156 4544 4546 4155 4c54 2720 UB_SAVEDEFAULT' │ │ │ │ │ +0000c5c0: 6f72 2027 6772 7562 2d73 6574 2d64 6566 or 'grub-set-def │ │ │ │ │ +0000c5d0: 6175 6c74 272e 2020 5468 6973 0a20 2020 ault'. This. │ │ │ │ │ +0000c5e0: 2020 7265 6c69 6573 206f 6e20 7468 6520 relies on the │ │ │ │ │ +0000c5f0: 656e 7669 726f 6e6d 656e 7420 626c 6f63 environment bloc │ │ │ │ │ +0000c600: 6b2c 2077 6869 6368 206d 6179 206e 6f74 k, which may not │ │ │ │ │ +0000c610: 2062 6520 6176 6169 6c61 626c 6520 696e be available in │ │ │ │ │ +0000c620: 2061 6c6c 0a20 2020 2020 7369 7475 6174 all. situat │ │ │ │ │ +0000c630: 696f 6e73 2028 2a6e 6f74 6520 456e 7669 ions (*note Envi │ │ │ │ │ +0000c640: 726f 6e6d 656e 7420 626c 6f63 6b3a 3a29 ronment block::) │ │ │ │ │ +0000c650: 2e0a 0a20 2020 2020 5468 6520 6465 6661 ... The defa │ │ │ │ │ +0000c660: 756c 7420 6973 2027 3027 2e0a 0a27 4752 ult is '0'...'GR │ │ │ │ │ +0000c670: 5542 5f53 4156 4544 4546 4155 4c54 270a UB_SAVEDEFAULT'. │ │ │ │ │ +0000c680: 2020 2020 2049 6620 7468 6973 206f 7074 If this opt │ │ │ │ │ +0000c690: 696f 6e20 6973 2073 6574 2074 6f20 2774 ion is set to 't │ │ │ │ │ +0000c6a0: 7275 6527 2c20 7468 656e 2c20 7768 656e rue', then, when │ │ │ │ │ +0000c6b0: 2061 6e20 656e 7472 7920 6973 2073 656c an entry is sel │ │ │ │ │ +0000c6c0: 6563 7465 642c 0a20 2020 2020 7361 7665 ected,. save │ │ │ │ │ +0000c6d0: 2069 7420 6173 2061 206e 6577 2064 6566 it as a new def │ │ │ │ │ +0000c6e0: 6175 6c74 2065 6e74 7279 2066 6f72 2075 ault entry for u │ │ │ │ │ +0000c6f0: 7365 2062 7920 6675 7475 7265 2072 756e se by future run │ │ │ │ │ +0000c700: 7320 6f66 2047 5255 422e 2054 6869 730a s of GRUB. This. │ │ │ │ │ +0000c710: 2020 2020 2069 7320 6f6e 6c79 2075 7365 is only use │ │ │ │ │ +0000c720: 6675 6c20 6966 2027 4752 5542 5f44 4546 ful if 'GRUB_DEF │ │ │ │ │ +0000c730: 4155 4c54 3d73 6176 6564 273b 2069 7420 AULT=saved'; it │ │ │ │ │ +0000c740: 6973 2061 2073 6570 6172 6174 6520 6f70 is a separate op │ │ │ │ │ +0000c750: 7469 6f6e 0a20 2020 2020 6265 6361 7573 tion. becaus │ │ │ │ │ +0000c760: 6520 2747 5255 425f 4445 4641 554c 543d e 'GRUB_DEFAULT= │ │ │ │ │ +0000c770: 7361 7665 6427 2069 7320 7573 6566 756c saved' is useful │ │ │ │ │ +0000c780: 2077 6974 686f 7574 2074 6869 7320 6f70 without this op │ │ │ │ │ +0000c790: 7469 6f6e 2c20 696e 0a20 2020 2020 636f tion, in. co │ │ │ │ │ +0000c7a0: 6e6a 756e 6374 696f 6e20 7769 7468 2027 njunction with ' │ │ │ │ │ +0000c7b0: 6772 7562 2d73 6574 2d64 6566 6175 6c74 grub-set-default │ │ │ │ │ +0000c7c0: 272e 2020 556e 7365 7420 6279 2064 6566 '. Unset by def │ │ │ │ │ +0000c7d0: 6175 6c74 2e20 2054 6869 730a 2020 2020 ault. This. │ │ │ │ │ +0000c7e0: 206f 7074 696f 6e20 7265 6c69 6573 206f option relies o │ │ │ │ │ +0000c7f0: 6e20 7468 6520 656e 7669 726f 6e6d 656e n the environmen │ │ │ │ │ +0000c800: 7420 626c 6f63 6b2c 2077 6869 6368 206d t block, which m │ │ │ │ │ +0000c810: 6179 206e 6f74 2062 6520 6176 6169 6c61 ay not be availa │ │ │ │ │ +0000c820: 626c 650a 2020 2020 2069 6e20 616c 6c20 ble. in all │ │ │ │ │ +0000c830: 7369 7475 6174 696f 6e73 2028 2a6e 6f74 situations (*not │ │ │ │ │ +0000c840: 6520 456e 7669 726f 6e6d 656e 7420 626c e Environment bl │ │ │ │ │ +0000c850: 6f63 6b3a 3a29 2e0a 0a27 4752 5542 5f54 ock::)...'GRUB_T │ │ │ │ │ +0000c860: 494d 454f 5554 270a 2020 2020 2042 6f6f IMEOUT'. Boo │ │ │ │ │ +0000c870: 7420 7468 6520 6465 6661 756c 7420 656e t the default en │ │ │ │ │ +0000c880: 7472 7920 7468 6973 206d 616e 7920 7365 try this many se │ │ │ │ │ +0000c890: 636f 6e64 7320 6166 7465 7220 7468 6520 conds after the │ │ │ │ │ +0000c8a0: 6d65 6e75 2069 730a 2020 2020 2064 6973 menu is. dis │ │ │ │ │ +0000c8b0: 706c 6179 6564 2c20 756e 6c65 7373 2061 played, unless a │ │ │ │ │ +0000c8c0: 206b 6579 2069 7320 7072 6573 7365 642e key is pressed. │ │ │ │ │ +0000c8d0: 2020 5468 6520 6465 6661 756c 7420 6973 The default is │ │ │ │ │ +0000c8e0: 2027 3527 2e20 2053 6574 2074 6f0a 2020 '5'. Set to. │ │ │ │ │ +0000c8f0: 2020 2027 3027 2074 6f20 626f 6f74 2069 '0' to boot i │ │ │ │ │ +0000c900: 6d6d 6564 6961 7465 6c79 2077 6974 686f mmediately witho │ │ │ │ │ +0000c910: 7574 2064 6973 706c 6179 696e 6720 7468 ut displaying th │ │ │ │ │ +0000c920: 6520 6d65 6e75 2c20 6f72 2074 6f20 272d e menu, or to '- │ │ │ │ │ +0000c930: 3127 2074 6f0a 2020 2020 2077 6169 7420 1' to. wait │ │ │ │ │ +0000c940: 696e 6465 6669 6e69 7465 6c79 2e0a 0a20 indefinitely... │ │ │ │ │ +0000c950: 2020 2020 4966 2027 4752 5542 5f54 494d If 'GRUB_TIM │ │ │ │ │ +0000c960: 454f 5554 5f53 5459 4c45 2720 6973 2073 EOUT_STYLE' is s │ │ │ │ │ +0000c970: 6574 2074 6f20 2763 6f75 6e74 646f 776e et to 'countdown │ │ │ │ │ +0000c980: 2720 6f72 2027 6869 6464 656e 272c 2074 ' or 'hidden', t │ │ │ │ │ +0000c990: 6865 0a20 2020 2020 7469 6d65 6f75 7420 he. timeout │ │ │ │ │ +0000c9a0: 6973 2069 6e73 7465 6164 2063 6f75 6e74 is instead count │ │ │ │ │ +0000c9b0: 6564 2062 6566 6f72 6520 7468 6520 6d65 ed before the me │ │ │ │ │ +0000c9c0: 6e75 2069 7320 6469 7370 6c61 7965 642e nu is displayed. │ │ │ │ │ +0000c9d0: 0a0a 2747 5255 425f 5449 4d45 4f55 545f ..'GRUB_TIMEOUT_ │ │ │ │ │ +0000c9e0: 5354 594c 4527 0a20 2020 2020 4966 2074 STYLE'. If t │ │ │ │ │ +0000c9f0: 6869 7320 6f70 7469 6f6e 2069 7320 756e his option is un │ │ │ │ │ +0000ca00: 7365 7420 6f72 2073 6574 2074 6f20 276d set or set to 'm │ │ │ │ │ +0000ca10: 656e 7527 2c20 7468 656e 2047 5255 4220 enu', then GRUB │ │ │ │ │ +0000ca20: 7769 6c6c 2064 6973 706c 6179 0a20 2020 will display. │ │ │ │ │ +0000ca30: 2020 7468 6520 6d65 6e75 2061 6e64 2074 the menu and t │ │ │ │ │ +0000ca40: 6865 6e20 7761 6974 2066 6f72 2074 6865 hen wait for the │ │ │ │ │ +0000ca50: 2074 696d 656f 7574 2073 6574 2062 7920 timeout set by │ │ │ │ │ +0000ca60: 2747 5255 425f 5449 4d45 4f55 5427 2074 'GRUB_TIMEOUT' t │ │ │ │ │ +0000ca70: 6f0a 2020 2020 2065 7870 6972 6520 6265 o. expire be │ │ │ │ │ +0000ca80: 666f 7265 2062 6f6f 7469 6e67 2074 6865 fore booting the │ │ │ │ │ +0000ca90: 2064 6566 6175 6c74 2065 6e74 7279 2e20 default entry. │ │ │ │ │ +0000caa0: 2050 7265 7373 696e 6720 6120 6b65 7920 Pressing a key │ │ │ │ │ +0000cab0: 696e 7465 7272 7570 7473 0a20 2020 2020 interrupts. │ │ │ │ │ +0000cac0: 7468 6520 7469 6d65 6f75 742e 0a0a 2020 the timeout... │ │ │ │ │ +0000cad0: 2020 2049 6620 7468 6973 206f 7074 696f If this optio │ │ │ │ │ +0000cae0: 6e20 6973 2073 6574 2074 6f20 2763 6f75 n is set to 'cou │ │ │ │ │ +0000caf0: 6e74 646f 776e 2720 6f72 2027 6869 6464 ntdown' or 'hidd │ │ │ │ │ +0000cb00: 656e 272c 2074 6865 6e2c 2062 6566 6f72 en', then, befor │ │ │ │ │ +0000cb10: 650a 2020 2020 2064 6973 706c 6179 696e e. displayin │ │ │ │ │ +0000cb20: 6720 7468 6520 6d65 6e75 2c20 4752 5542 g the menu, GRUB │ │ │ │ │ +0000cb30: 2077 696c 6c20 7761 6974 2066 6f72 2074 will wait for t │ │ │ │ │ +0000cb40: 6865 2074 696d 656f 7574 2073 6574 2062 he timeout set b │ │ │ │ │ +0000cb50: 790a 2020 2020 2027 4752 5542 5f54 494d y. 'GRUB_TIM │ │ │ │ │ +0000cb60: 454f 5554 2720 746f 2065 7870 6972 652e EOUT' to expire. │ │ │ │ │ +0000cb70: 2020 4966 203c 4553 433e 206f 7220 3c46 If or are pressed, │ │ │ │ │ +0000cb90: 6f72 203c 5348 4946 543e 0a20 2020 2020 or . │ │ │ │ │ +0000cba0: 6973 2068 656c 6420 646f 776e 2064 7572 is held down dur │ │ │ │ │ +0000cbb0: 696e 6720 7468 6174 2074 696d 652c 2069 ing that time, i │ │ │ │ │ +0000cbc0: 7420 7769 6c6c 2064 6973 706c 6179 2074 t will display t │ │ │ │ │ +0000cbd0: 6865 206d 656e 7520 616e 6420 7761 6974 he menu and wait │ │ │ │ │ +0000cbe0: 0a20 2020 2020 666f 7220 696e 7075 742e . for input. │ │ │ │ │ +0000cbf0: 2020 4966 2061 2068 6f74 6b65 7920 6173 If a hotkey as │ │ │ │ │ +0000cc00: 736f 6369 6174 6564 2077 6974 6820 6120 sociated with a │ │ │ │ │ +0000cc10: 6d65 6e75 2065 6e74 7279 2069 7320 7072 menu entry is pr │ │ │ │ │ +0000cc20: 6573 7365 642c 2069 740a 2020 2020 2077 essed, it. w │ │ │ │ │ +0000cc30: 696c 6c20 626f 6f74 2074 6865 2061 7373 ill boot the ass │ │ │ │ │ +0000cc40: 6f63 6961 7465 6420 6d65 6e75 2065 6e74 ociated menu ent │ │ │ │ │ +0000cc50: 7279 2069 6d6d 6564 6961 7465 6c79 2e20 ry immediately. │ │ │ │ │ +0000cc60: 2049 6620 7468 6520 7469 6d65 6f75 740a If the timeout. │ │ │ │ │ +0000cc70: 2020 2020 2065 7870 6972 6573 2062 6566 expires bef │ │ │ │ │ +0000cc80: 6f72 6520 6569 7468 6572 206f 6620 7468 ore either of th │ │ │ │ │ +0000cc90: 6573 6520 6861 7070 656e 732c 2069 7420 ese happens, it │ │ │ │ │ +0000cca0: 7769 6c6c 2062 6f6f 7420 7468 6520 6465 will boot the de │ │ │ │ │ +0000ccb0: 6661 756c 740a 2020 2020 2065 6e74 7279 fault. entry │ │ │ │ │ +0000ccc0: 2e20 2049 6e20 7468 6520 2763 6f75 6e74 . In the 'count │ │ │ │ │ +0000ccd0: 646f 776e 2720 6361 7365 2c20 6974 2077 down' case, it w │ │ │ │ │ +0000cce0: 696c 6c20 7368 6f77 2061 206f 6e65 2d6c ill show a one-l │ │ │ │ │ +0000ccf0: 696e 6520 696e 6469 6361 7469 6f6e 0a20 ine indication. │ │ │ │ │ +0000cd00: 2020 2020 6f66 2074 6865 2072 656d 6169 of the remai │ │ │ │ │ +0000cd10: 6e69 6e67 2074 696d 652e 0a0a 2747 5255 ning time...'GRU │ │ │ │ │ +0000cd20: 425f 4445 4641 554c 545f 4255 5454 4f4e B_DEFAULT_BUTTON │ │ │ │ │ +0000cd30: 270a 2747 5255 425f 5449 4d45 4f55 545f '.'GRUB_TIMEOUT_ │ │ │ │ │ +0000cd40: 4255 5454 4f4e 270a 2747 5255 425f 5449 BUTTON'.'GRUB_TI │ │ │ │ │ +0000cd50: 4d45 4f55 545f 5354 594c 455f 4255 5454 MEOUT_STYLE_BUTT │ │ │ │ │ +0000cd60: 4f4e 270a 2747 5255 425f 4255 5454 4f4e ON'.'GRUB_BUTTON │ │ │ │ │ +0000cd70: 5f43 4d4f 535f 4144 4452 4553 5327 0a20 _CMOS_ADDRESS'. │ │ │ │ │ +0000cd80: 2020 2020 5661 7269 616e 7473 206f 6620 Variants of │ │ │ │ │ +0000cd90: 7468 6520 636f 7272 6573 706f 6e64 696e the correspondin │ │ │ │ │ +0000cda0: 6720 7661 7269 6162 6c65 7320 7769 7468 g variables with │ │ │ │ │ +0000cdb0: 6f75 7420 7468 6520 275f 4255 5454 4f4e out the '_BUTTON │ │ │ │ │ +0000cdc0: 270a 2020 2020 2073 7566 6669 782c 2075 '. suffix, u │ │ │ │ │ +0000cdd0: 7365 6420 746f 2073 7570 706f 7274 2076 sed to support v │ │ │ │ │ +0000cde0: 656e 646f 722d 7370 6563 6966 6963 2070 endor-specific p │ │ │ │ │ +0000cdf0: 6f77 6572 2062 7574 746f 6e73 2e20 202a ower buttons. * │ │ │ │ │ +0000ce00: 4e6f 7465 0a20 2020 2020 5665 6e64 6f72 Note. Vendor │ │ │ │ │ +0000ce10: 2070 6f77 6572 2d6f 6e20 6b65 7973 3a3a power-on keys:: │ │ │ │ │ +0000ce20: 2e0a 0a27 4752 5542 5f44 4953 5452 4942 ...'GRUB_DISTRIB │ │ │ │ │ +0000ce30: 5554 4f52 270a 2020 2020 2053 6574 2062 UTOR'. Set b │ │ │ │ │ +0000ce40: 7920 6469 7374 7269 6275 746f 7273 206f y distributors o │ │ │ │ │ +0000ce50: 6620 4752 5542 2074 6f20 7468 6569 7220 f GRUB to their │ │ │ │ │ +0000ce60: 6964 656e 7469 6679 696e 6720 6e61 6d65 identifying name │ │ │ │ │ +0000ce70: 2e20 2054 6869 7320 6973 0a20 2020 2020 . This is. │ │ │ │ │ +0000ce80: 7573 6564 2074 6f20 6765 6e65 7261 7465 used to generate │ │ │ │ │ +0000ce90: 206d 6f72 6520 696e 666f 726d 6174 6976 more informativ │ │ │ │ │ +0000cea0: 6520 6d65 6e75 2065 6e74 7279 2074 6974 e menu entry tit │ │ │ │ │ +0000ceb0: 6c65 732e 0a0a 2747 5255 425f 5445 524d les...'GRUB_TERM │ │ │ │ │ +0000cec0: 494e 414c 5f49 4e50 5554 270a 2020 2020 INAL_INPUT'. │ │ │ │ │ +0000ced0: 2053 656c 6563 7420 7468 6520 7465 726d Select the term │ │ │ │ │ +0000cee0: 696e 616c 2069 6e70 7574 2064 6576 6963 inal input devic │ │ │ │ │ +0000cef0: 652e 2020 596f 7520 6d61 7920 7365 6c65 e. You may sele │ │ │ │ │ +0000cf00: 6374 206d 756c 7469 706c 6520 6465 7669 ct multiple devi │ │ │ │ │ +0000cf10: 6365 730a 2020 2020 2068 6572 652c 2073 ces. here, s │ │ │ │ │ +0000cf20: 6570 6172 6174 6564 2062 7920 7370 6163 eparated by spac │ │ │ │ │ +0000cf30: 6573 2e0a 0a20 2020 2020 5661 6c69 6420 es... Valid │ │ │ │ │ +0000cf40: 7465 726d 696e 616c 2069 6e70 7574 206e terminal input n │ │ │ │ │ +0000cf50: 616d 6573 2064 6570 656e 6420 6f6e 2074 ames depend on t │ │ │ │ │ +0000cf60: 6865 2070 6c61 7466 6f72 6d2c 2062 7574 he platform, but │ │ │ │ │ +0000cf70: 206d 6179 2069 6e63 6c75 6465 0a20 2020 may include. │ │ │ │ │ +0000cf80: 2020 2763 6f6e 736f 6c65 2720 286e 6174 'console' (nat │ │ │ │ │ +0000cf90: 6976 6520 706c 6174 666f 726d 2063 6f6e ive platform con │ │ │ │ │ +0000cfa0: 736f 6c65 292c 2027 7365 7269 616c 2720 sole), 'serial' │ │ │ │ │ +0000cfb0: 2873 6572 6961 6c20 7465 726d 696e 616c (serial terminal │ │ │ │ │ +0000cfc0: 292c 0a20 2020 2020 2773 6572 6961 6c5f ),. 'serial_ │ │ │ │ │ +0000cfd0: 3c70 6f72 743e 2720 2873 6572 6961 6c20 ' (serial │ │ │ │ │ +0000cfe0: 7465 726d 696e 616c 2077 6974 6820 6578 terminal with ex │ │ │ │ │ +0000cff0: 706c 6963 6974 2070 6f72 7420 7365 6c65 plicit port sele │ │ │ │ │ +0000d000: 6374 696f 6e29 2c0a 2020 2020 2027 6174 ction),. 'at │ │ │ │ │ +0000d010: 5f6b 6579 626f 6172 6427 2028 5043 2041 _keyboard' (PC A │ │ │ │ │ +0000d020: 5420 6b65 7962 6f61 7264 292c 206f 7220 T keyboard), or │ │ │ │ │ +0000d030: 2775 7362 5f6b 6579 626f 6172 6427 2028 'usb_keyboard' ( │ │ │ │ │ +0000d040: 5553 4220 6b65 7962 6f61 7264 0a20 2020 USB keyboard. │ │ │ │ │ +0000d050: 2020 7573 696e 6720 7468 6520 4849 4420 using the HID │ │ │ │ │ +0000d060: 426f 6f74 2050 726f 746f 636f 6c2c 2066 Boot Protocol, f │ │ │ │ │ +0000d070: 6f72 2063 6173 6573 2077 6865 7265 2074 or cases where t │ │ │ │ │ +0000d080: 6865 2066 6972 6d77 6172 6520 646f 6573 he firmware does │ │ │ │ │ +0000d090: 206e 6f74 0a20 2020 2020 6861 6e64 6c65 not. handle │ │ │ │ │ +0000d0a0: 2074 6869 7329 2e0a 0a20 2020 2020 5468 this)... Th │ │ │ │ │ +0000d0b0: 6520 6465 6661 756c 7420 6973 2074 6f20 e default is to │ │ │ │ │ +0000d0c0: 7573 6520 7468 6520 706c 6174 666f 726d use the platform │ │ │ │ │ +0000d0d0: 2773 206e 6174 6976 6520 7465 726d 696e 's native termin │ │ │ │ │ +0000d0e0: 616c 2069 6e70 7574 2e0a 0a27 4752 5542 al input...'GRUB │ │ │ │ │ +0000d0f0: 5f54 4552 4d49 4e41 4c5f 4f55 5450 5554 _TERMINAL_OUTPUT │ │ │ │ │ +0000d100: 270a 2020 2020 2053 656c 6563 7420 7468 '. Select th │ │ │ │ │ +0000d110: 6520 7465 726d 696e 616c 206f 7574 7075 e terminal outpu │ │ │ │ │ +0000d120: 7420 6465 7669 6365 2e20 2059 6f75 206d t device. You m │ │ │ │ │ +0000d130: 6179 2073 656c 6563 7420 6d75 6c74 6970 ay select multip │ │ │ │ │ +0000d140: 6c65 2064 6576 6963 6573 0a20 2020 2020 le devices. │ │ │ │ │ +0000d150: 6865 7265 2c20 7365 7061 7261 7465 6420 here, separated │ │ │ │ │ +0000d160: 6279 2073 7061 6365 732e 0a0a 2020 2020 by spaces... │ │ │ │ │ +0000d170: 2056 616c 6964 2074 6572 6d69 6e61 6c20 Valid terminal │ │ │ │ │ +0000d180: 6f75 7470 7574 206e 616d 6573 2064 6570 output names dep │ │ │ │ │ +0000d190: 656e 6420 6f6e 2074 6865 2070 6c61 7466 end on the platf │ │ │ │ │ +0000d1a0: 6f72 6d2c 2062 7574 206d 6179 2069 6e63 orm, but may inc │ │ │ │ │ +0000d1b0: 6c75 6465 0a20 2020 2020 2763 6f6e 736f lude. 'conso │ │ │ │ │ +0000d1c0: 6c65 2720 286e 6174 6976 6520 706c 6174 le' (native plat │ │ │ │ │ +0000d1d0: 666f 726d 2063 6f6e 736f 6c65 292c 2027 form console), ' │ │ │ │ │ +0000d1e0: 7365 7269 616c 2720 2873 6572 6961 6c20 serial' (serial │ │ │ │ │ +0000d1f0: 7465 726d 696e 616c 292c 0a20 2020 2020 terminal),. │ │ │ │ │ +0000d200: 2773 6572 6961 6c5f 3c70 6f72 743e 2720 'serial_' │ │ │ │ │ +0000d210: 2873 6572 6961 6c20 7465 726d 696e 616c (serial terminal │ │ │ │ │ +0000d220: 2077 6974 6820 6578 706c 6963 6974 2070 with explicit p │ │ │ │ │ +0000d230: 6f72 7420 7365 6c65 6374 696f 6e29 2c0a ort selection),. │ │ │ │ │ +0000d240: 2020 2020 2027 6766 7874 6572 6d27 2028 'gfxterm' ( │ │ │ │ │ +0000d250: 6772 6170 6869 6373 2d6d 6f64 6520 6f75 graphics-mode ou │ │ │ │ │ +0000d260: 7470 7574 292c 2027 7667 615f 7465 7874 tput), 'vga_text │ │ │ │ │ +0000d270: 2720 2856 4741 2074 6578 7420 6f75 7470 ' (VGA text outp │ │ │ │ │ +0000d280: 7574 292c 0a20 2020 2020 276d 6461 5f74 ut),. 'mda_t │ │ │ │ │ +0000d290: 6578 7427 2028 4d44 4120 7465 7874 206f ext' (MDA text o │ │ │ │ │ +0000d2a0: 7574 7075 7429 2c20 276d 6f72 7365 2720 utput), 'morse' │ │ │ │ │ +0000d2b0: 284d 6f72 7365 2d63 6f64 696e 6720 7573 (Morse-coding us │ │ │ │ │ +0000d2c0: 696e 6720 7379 7374 656d 0a20 2020 2020 ing system. │ │ │ │ │ +0000d2d0: 6265 6570 6572 2920 6f72 2027 7370 6b6d beeper) or 'spkm │ │ │ │ │ +0000d2e0: 6f64 656d 2720 2873 696d 706c 6520 6461 odem' (simple da │ │ │ │ │ +0000d2f0: 7461 2070 726f 746f 636f 6c20 7573 696e ta protocol usin │ │ │ │ │ +0000d300: 6720 7379 7374 656d 2073 7065 616b 6572 g system speaker │ │ │ │ │ +0000d310: 292e 0a0a 2020 2020 2027 7370 6b6d 6f64 )... 'spkmod │ │ │ │ │ +0000d320: 656d 2720 6973 2075 7365 6675 6c20 7768 em' is useful wh │ │ │ │ │ +0000d330: 656e 206e 6f20 7365 7269 616c 2070 6f72 en no serial por │ │ │ │ │ +0000d340: 7420 6973 2061 7661 696c 6162 6c65 2e20 t is available. │ │ │ │ │ +0000d350: 2043 6f6e 6e65 6374 2074 6865 0a20 2020 Connect the. │ │ │ │ │ +0000d360: 2020 6f75 7470 7574 206f 6620 7365 6e64 output of send │ │ │ │ │ +0000d370: 696e 6720 7379 7374 656d 2028 7768 6572 ing system (wher │ │ │ │ │ +0000d380: 6520 4752 5542 2069 7320 7275 6e6e 696e e GRUB is runnin │ │ │ │ │ +0000d390: 6729 2074 6f20 6c69 6e65 2d69 6e20 6f66 g) to line-in of │ │ │ │ │ +0000d3a0: 0a20 2020 2020 7265 6365 6976 696e 6720 . receiving │ │ │ │ │ +0000d3b0: 7379 7374 656d 2028 7573 7561 6c6c 7920 system (usually │ │ │ │ │ +0000d3c0: 6465 7665 6c6f 7065 7220 6d61 6368 696e developer machin │ │ │ │ │ +0000d3d0: 6529 2e20 204f 6e20 7265 6365 6976 696e e). On receivin │ │ │ │ │ +0000d3e0: 6720 7379 7374 656d 0a20 2020 2020 636f g system. co │ │ │ │ │ +0000d3f0: 6d70 696c 6520 2773 706b 6d6f 6465 6d2d mpile 'spkmodem- │ │ │ │ │ +0000d400: 7265 6376 2720 6672 6f6d 2027 7574 696c recv' from 'util │ │ │ │ │ +0000d410: 2f73 706b 6d6f 6465 6d2d 7265 6376 2e63 /spkmodem-recv.c │ │ │ │ │ +0000d420: 2720 616e 6420 7275 6e3a 0a0a 2020 2020 ' and run:.. │ │ │ │ │ +0000d430: 2020 2020 2020 7061 7265 636f 7264 202d parecord - │ │ │ │ │ +0000d440: 2d63 6861 6e6e 656c 733d 3120 2d2d 7261 -channels=1 --ra │ │ │ │ │ +0000d450: 7465 3d34 3830 3030 202d 2d66 6f72 6d61 te=48000 --forma │ │ │ │ │ +0000d460: 743d 7331 366c 6520 7c20 2e2f 7370 6b6d t=s16le | ./spkm │ │ │ │ │ +0000d470: 6f64 656d 2d72 6563 760a 0a20 2020 2020 odem-recv.. │ │ │ │ │ +0000d480: 5468 6520 6465 6661 756c 7420 6973 2074 The default is t │ │ │ │ │ +0000d490: 6f20 7573 6520 7468 6520 706c 6174 666f o use the platfo │ │ │ │ │ +0000d4a0: 726d 2773 206e 6174 6976 6520 7465 726d rm's native term │ │ │ │ │ +0000d4b0: 696e 616c 206f 7574 7075 742e 0a0a 2747 inal output...'G │ │ │ │ │ +0000d4c0: 5255 425f 5445 524d 494e 414c 270a 2020 RUB_TERMINAL'. │ │ │ │ │ +0000d4d0: 2020 2049 6620 7468 6973 206f 7074 696f If this optio │ │ │ │ │ +0000d4e0: 6e20 6973 2073 6574 2c20 6974 206f 7665 n is set, it ove │ │ │ │ │ +0000d4f0: 7272 6964 6573 2062 6f74 6820 2747 5255 rrides both 'GRU │ │ │ │ │ +0000d500: 425f 5445 524d 494e 414c 5f49 4e50 5554 B_TERMINAL_INPUT │ │ │ │ │ +0000d510: 2720 616e 640a 2020 2020 2027 4752 5542 ' and. 'GRUB │ │ │ │ │ +0000d520: 5f54 4552 4d49 4e41 4c5f 4f55 5450 5554 _TERMINAL_OUTPUT │ │ │ │ │ +0000d530: 2720 746f 2074 6865 2073 616d 6520 7661 ' to the same va │ │ │ │ │ +0000d540: 6c75 652e 0a0a 2747 5255 425f 5345 5249 lue...'GRUB_SERI │ │ │ │ │ +0000d550: 414c 5f43 4f4d 4d41 4e44 270a 2020 2020 AL_COMMAND'. │ │ │ │ │ +0000d560: 2041 2063 6f6d 6d61 6e64 2074 6f20 636f A command to co │ │ │ │ │ +0000d570: 6e66 6967 7572 6520 7468 6520 7365 7269 nfigure the seri │ │ │ │ │ +0000d580: 616c 2070 6f72 7420 7768 656e 2075 7369 al port when usi │ │ │ │ │ +0000d590: 6e67 2074 6865 2073 6572 6961 6c0a 2020 ng the serial. │ │ │ │ │ +0000d5a0: 2020 2063 6f6e 736f 6c65 2e20 202a 4e6f console. *No │ │ │ │ │ +0000d5b0: 7465 2073 6572 6961 6c3a 3a2e 2020 4465 te serial::. De │ │ │ │ │ +0000d5c0: 6661 756c 7473 2074 6f20 2773 6572 6961 faults to 'seria │ │ │ │ │ +0000d5d0: 6c27 2e0a 0a27 4752 5542 5f43 4d44 4c49 l'...'GRUB_CMDLI │ │ │ │ │ +0000d5e0: 4e45 5f4c 494e 5558 270a 2020 2020 2043 NE_LINUX'. C │ │ │ │ │ +0000d5f0: 6f6d 6d61 6e64 2d6c 696e 6520 6172 6775 ommand-line argu │ │ │ │ │ +0000d600: 6d65 6e74 7320 746f 2061 6464 2074 6f20 ments to add to │ │ │ │ │ +0000d610: 6d65 6e75 2065 6e74 7269 6573 2066 6f72 menu entries for │ │ │ │ │ +0000d620: 2074 6865 204c 696e 7578 206b 6572 6e65 the Linux kerne │ │ │ │ │ +0000d630: 6c2e 0a0a 2747 5255 425f 434d 444c 494e l...'GRUB_CMDLIN │ │ │ │ │ +0000d640: 455f 4c49 4e55 585f 4445 4641 554c 5427 E_LINUX_DEFAULT' │ │ │ │ │ +0000d650: 0a20 2020 2020 556e 6c65 7373 2027 4752 . Unless 'GR │ │ │ │ │ +0000d660: 5542 5f44 4953 4142 4c45 5f52 4543 4f56 UB_DISABLE_RECOV │ │ │ │ │ +0000d670: 4552 5927 2069 7320 7365 7420 746f 2027 ERY' is set to ' │ │ │ │ │ +0000d680: 7472 7565 272c 2074 776f 206d 656e 7520 true', two menu │ │ │ │ │ +0000d690: 656e 7472 6965 730a 2020 2020 2077 696c entries. wil │ │ │ │ │ +0000d6a0: 6c20 6265 2067 656e 6572 6174 6564 2066 l be generated f │ │ │ │ │ +0000d6b0: 6f72 2065 6163 6820 4c69 6e75 7820 6b65 or each Linux ke │ │ │ │ │ +0000d6c0: 726e 656c 3a20 6f6e 6520 6465 6661 756c rnel: one defaul │ │ │ │ │ +0000d6d0: 7420 656e 7472 7920 616e 6420 6f6e 650a t entry and one. │ │ │ │ │ +0000d6e0: 2020 2020 2065 6e74 7279 2066 6f72 2072 entry for r │ │ │ │ │ +0000d6f0: 6563 6f76 6572 7920 6d6f 6465 2e20 2054 ecovery mode. T │ │ │ │ │ +0000d700: 6869 7320 6f70 7469 6f6e 206c 6973 7473 his option lists │ │ │ │ │ +0000d710: 2063 6f6d 6d61 6e64 2d6c 696e 6520 6172 command-line ar │ │ │ │ │ +0000d720: 6775 6d65 6e74 730a 2020 2020 2074 6f20 guments. to │ │ │ │ │ +0000d730: 6164 6420 6f6e 6c79 2074 6f20 7468 6520 add only to the │ │ │ │ │ +0000d740: 6465 6661 756c 7420 6d65 6e75 2065 6e74 default menu ent │ │ │ │ │ +0000d750: 7279 2c20 6166 7465 7220 7468 6f73 6520 ry, after those │ │ │ │ │ +0000d760: 6c69 7374 6564 2069 6e0a 2020 2020 2027 listed in. ' │ │ │ │ │ +0000d770: 4752 5542 5f43 4d44 4c49 4e45 5f4c 494e GRUB_CMDLINE_LIN │ │ │ │ │ +0000d780: 5558 272e 0a0a 2747 5255 425f 434d 444c UX'...'GRUB_CMDL │ │ │ │ │ +0000d790: 494e 455f 4e45 5442 5344 270a 2747 5255 INE_NETBSD'.'GRU │ │ │ │ │ +0000d7a0: 425f 434d 444c 494e 455f 4e45 5442 5344 B_CMDLINE_NETBSD │ │ │ │ │ +0000d7b0: 5f44 4546 4155 4c54 270a 2020 2020 2041 _DEFAULT'. A │ │ │ │ │ +0000d7c0: 7320 2747 5255 425f 434d 444c 494e 455f s 'GRUB_CMDLINE_ │ │ │ │ │ +0000d7d0: 4c49 4e55 5827 2061 6e64 2027 4752 5542 LINUX' and 'GRUB │ │ │ │ │ +0000d7e0: 5f43 4d44 4c49 4e45 5f4c 494e 5558 5f44 _CMDLINE_LINUX_D │ │ │ │ │ +0000d7f0: 4546 4155 4c54 272c 2062 7574 2066 6f72 EFAULT', but for │ │ │ │ │ +0000d800: 0a20 2020 2020 4e65 7442 5344 2e0a 0a27 . NetBSD...' │ │ │ │ │ +0000d810: 4752 5542 5f43 4d44 4c49 4e45 5f47 4e55 GRUB_CMDLINE_GNU │ │ │ │ │ +0000d820: 4d41 4348 270a 2020 2020 2041 7320 2747 MACH'. As 'G │ │ │ │ │ +0000d830: 5255 425f 434d 444c 494e 455f 4c49 4e55 RUB_CMDLINE_LINU │ │ │ │ │ +0000d840: 5827 2c20 6275 7420 666f 7220 474e 5520 X', but for GNU │ │ │ │ │ +0000d850: 4d61 6368 2e0a 0a27 4752 5542 5f43 4d44 Mach...'GRUB_CMD │ │ │ │ │ +0000d860: 4c49 4e45 5f58 454e 270a 2747 5255 425f LINE_XEN'.'GRUB_ │ │ │ │ │ +0000d870: 434d 444c 494e 455f 5845 4e5f 4445 4641 CMDLINE_XEN_DEFA │ │ │ │ │ +0000d880: 554c 5427 0a20 2020 2020 5468 6520 7661 ULT'. The va │ │ │ │ │ +0000d890: 6c75 6573 206f 6620 7468 6573 6520 6f70 lues of these op │ │ │ │ │ +0000d8a0: 7469 6f6e 7320 6172 6520 7061 7373 6564 tions are passed │ │ │ │ │ +0000d8b0: 2074 6f20 5865 6e20 6879 7065 7276 6973 to Xen hypervis │ │ │ │ │ +0000d8c0: 6f72 2058 656e 206d 656e 750a 2020 2020 or Xen menu. │ │ │ │ │ +0000d8d0: 2065 6e74 7269 6573 2c20 666f 7220 616c entries, for al │ │ │ │ │ +0000d8e0: 6c20 7265 7370 6563 7469 7665 6c79 206e l respectively n │ │ │ │ │ +0000d8f0: 6f72 6d61 6c20 656e 7472 6965 732e 0a0a ormal entries... │ │ │ │ │ +0000d900: 2747 5255 425f 434d 444c 494e 455f 4c49 'GRUB_CMDLINE_LI │ │ │ │ │ +0000d910: 4e55 585f 5845 4e5f 5245 504c 4143 4527 NUX_XEN_REPLACE' │ │ │ │ │ +0000d920: 0a27 4752 5542 5f43 4d44 4c49 4e45 5f4c .'GRUB_CMDLINE_L │ │ │ │ │ +0000d930: 494e 5558 5f58 454e 5f52 4550 4c41 4345 INUX_XEN_REPLACE │ │ │ │ │ +0000d940: 5f44 4546 4155 4c54 270a 2020 2020 2054 _DEFAULT'. T │ │ │ │ │ +0000d950: 6865 2076 616c 7565 7320 6f66 2074 6865 he values of the │ │ │ │ │ +0000d960: 7365 206f 7074 696f 6e73 2072 6570 6c61 se options repla │ │ │ │ │ +0000d970: 6365 2074 6865 2076 616c 7565 7320 6f66 ce the values of │ │ │ │ │ +0000d980: 0a20 2020 2020 2747 5255 425f 434d 444c . 'GRUB_CMDL │ │ │ │ │ +0000d990: 494e 455f 4c49 4e55 5827 2061 6e64 2027 INE_LINUX' and ' │ │ │ │ │ +0000d9a0: 4752 5542 5f43 4d44 4c49 4e45 5f4c 494e GRUB_CMDLINE_LIN │ │ │ │ │ +0000d9b0: 5558 5f44 4546 4155 4c54 2720 666f 7220 UX_DEFAULT' for │ │ │ │ │ +0000d9c0: 4c69 6e75 7820 616e 640a 2020 2020 2058 Linux and. X │ │ │ │ │ +0000d9d0: 656e 206d 656e 7520 656e 7472 6965 732e en menu entries. │ │ │ │ │ +0000d9e0: 0a0a 2747 5255 425f 4541 524c 595f 494e ..'GRUB_EARLY_IN │ │ │ │ │ +0000d9f0: 4954 5244 5f4c 494e 5558 5f43 5553 544f ITRD_LINUX_CUSTO │ │ │ │ │ +0000da00: 4d27 0a27 4752 5542 5f45 4152 4c59 5f49 M'.'GRUB_EARLY_I │ │ │ │ │ +0000da10: 4e49 5452 445f 4c49 4e55 585f 5354 4f43 NITRD_LINUX_STOC │ │ │ │ │ +0000da20: 4b27 0a20 2020 2020 4c69 7374 206f 6620 K'. List of │ │ │ │ │ +0000da30: 7370 6163 652d 7365 7061 7261 7465 6420 space-separated │ │ │ │ │ +0000da40: 6561 726c 7920 696e 6974 7264 2069 6d61 early initrd ima │ │ │ │ │ +0000da50: 6765 7320 746f 2062 6520 6c6f 6164 6564 ges to be loaded │ │ │ │ │ +0000da60: 2066 726f 6d0a 2020 2020 2027 2f62 6f6f from. '/boo │ │ │ │ │ +0000da70: 7427 2e20 2054 6869 7320 6973 2066 6f72 t'. This is for │ │ │ │ │ +0000da80: 206c 6f61 6469 6e67 2074 6869 6e67 7320 loading things │ │ │ │ │ +0000da90: 6c69 6b65 2043 5055 206d 6963 726f 636f like CPU microco │ │ │ │ │ +0000daa0: 6465 2c20 6669 726d 7761 7265 2c0a 2020 de, firmware,. │ │ │ │ │ +0000dab0: 2020 2041 4350 4920 7461 626c 6573 2c20 ACPI tables, │ │ │ │ │ +0000dac0: 6372 7970 746f 206b 6579 732c 2061 6e64 crypto keys, and │ │ │ │ │ +0000dad0: 2073 6f20 6f6e 2e20 2054 6865 7365 2065 so on. These e │ │ │ │ │ +0000dae0: 6172 6c79 2069 6d61 6765 7320 7769 6c6c arly images will │ │ │ │ │ +0000daf0: 2062 650a 2020 2020 206c 6f61 6465 6420 be. loaded │ │ │ │ │ +0000db00: 696e 2074 6865 206f 7264 6572 2064 6563 in the order dec │ │ │ │ │ +0000db10: 6c61 7265 642c 2061 6e64 2061 6c6c 2077 lared, and all w │ │ │ │ │ +0000db20: 696c 6c20 6265 206c 6f61 6465 6420 6265 ill be loaded be │ │ │ │ │ +0000db30: 666f 7265 2074 6865 0a20 2020 2020 6163 fore the. ac │ │ │ │ │ +0000db40: 7475 616c 2066 756e 6374 696f 6e61 6c20 tual functional │ │ │ │ │ +0000db50: 696e 6974 7264 2069 6d61 6765 2e0a 0a20 initrd image... │ │ │ │ │ +0000db60: 2020 2020 2747 5255 425f 4541 524c 595f 'GRUB_EARLY_ │ │ │ │ │ +0000db70: 494e 4954 5244 5f4c 494e 5558 5f53 544f INITRD_LINUX_STO │ │ │ │ │ +0000db80: 434b 2720 6973 2066 6f72 2079 6f75 7220 CK' is for your │ │ │ │ │ +0000db90: 6469 7374 7269 6275 7469 6f6e 2074 6f20 distribution to │ │ │ │ │ +0000dba0: 6465 636c 6172 650a 2020 2020 2069 6d61 declare. ima │ │ │ │ │ +0000dbb0: 6765 7320 7468 6174 2061 7265 2070 726f ges that are pro │ │ │ │ │ +0000dbc0: 7669 6465 6420 6279 2074 6865 2064 6973 vided by the dis │ │ │ │ │ +0000dbd0: 7472 6962 7574 696f 6e2e 2020 4974 2073 tribution. It s │ │ │ │ │ +0000dbe0: 686f 756c 6420 6e6f 7420 6265 0a20 2020 hould not be. │ │ │ │ │ +0000dbf0: 2020 6d6f 6469 6669 6564 2077 6974 686f modified witho │ │ │ │ │ +0000dc00: 7574 2075 6e64 6572 7374 616e 6469 6e67 ut understanding │ │ │ │ │ +0000dc10: 2074 6865 2063 6f6e 7365 7175 656e 6365 the consequence │ │ │ │ │ +0000dc20: 732e 2020 5468 6579 2077 696c 6c20 6265 s. They will be │ │ │ │ │ +0000dc30: 0a20 2020 2020 6c6f 6164 6564 2066 6972 . loaded fir │ │ │ │ │ +0000dc40: 7374 2e0a 0a20 2020 2020 2747 5255 425f st... 'GRUB_ │ │ │ │ │ +0000dc50: 4541 524c 595f 494e 4954 5244 5f4c 494e EARLY_INITRD_LIN │ │ │ │ │ +0000dc60: 5558 5f43 5553 544f 4d27 2069 7320 666f UX_CUSTOM' is fo │ │ │ │ │ +0000dc70: 7220 796f 7572 2063 7573 746f 6d20 6372 r your custom cr │ │ │ │ │ +0000dc80: 6561 7465 6420 696d 6167 6573 2e0a 0a20 eated images... │ │ │ │ │ +0000dc90: 2020 2020 5468 6520 6465 6661 756c 7420 The default │ │ │ │ │ +0000dca0: 7374 6f63 6b20 696d 6167 6573 2061 7265 stock images are │ │ │ │ │ +0000dcb0: 2061 7320 666f 6c6c 6f77 732c 2074 686f as follows, tho │ │ │ │ │ +0000dcc0: 7567 6820 7468 6579 206d 6179 2062 650a ugh they may be. │ │ │ │ │ +0000dcd0: 2020 2020 206f 7665 7272 6964 6465 6e20 overridden │ │ │ │ │ +0000dce0: 6279 2079 6f75 7220 6469 7374 7269 6275 by your distribu │ │ │ │ │ +0000dcf0: 7469 6f6e 3a0a 2020 2020 2020 2020 2020 tion:. │ │ │ │ │ +0000dd00: 696e 7465 6c2d 7563 2e69 6d67 2069 6e74 intel-uc.img int │ │ │ │ │ +0000dd10: 656c 2d75 636f 6465 2e69 6d67 2061 6d64 el-ucode.img amd │ │ │ │ │ +0000dd20: 2d75 632e 696d 6720 616d 642d 7563 6f64 -uc.img amd-ucod │ │ │ │ │ +0000dd30: 652e 696d 6720 6561 726c 795f 7563 6f64 e.img early_ucod │ │ │ │ │ +0000dd40: 652e 6370 696f 206d 6963 726f 636f 6465 e.cpio microcode │ │ │ │ │ +0000dd50: 2e63 7069 6f0a 0a27 4752 5542 5f44 4953 .cpio..'GRUB_DIS │ │ │ │ │ +0000dd60: 4142 4c45 5f4c 494e 5558 5f55 5549 4427 ABLE_LINUX_UUID' │ │ │ │ │ +0000dd70: 0a20 2020 2020 4e6f 726d 616c 6c79 2c20 . Normally, │ │ │ │ │ +0000dd80: 2767 7275 622d 6d6b 636f 6e66 6967 2720 'grub-mkconfig' │ │ │ │ │ +0000dd90: 7769 6c6c 2067 656e 6572 6174 6520 6d65 will generate me │ │ │ │ │ +0000dda0: 6e75 2065 6e74 7269 6573 2074 6861 7420 nu entries that │ │ │ │ │ +0000ddb0: 7573 650a 2020 2020 2075 6e69 7665 7273 use. univers │ │ │ │ │ +0000ddc0: 616c 6c79 2d75 6e69 7175 6520 6964 656e ally-unique iden │ │ │ │ │ +0000ddd0: 7469 6669 6572 7320 2855 5549 4473 2920 tifiers (UUIDs) │ │ │ │ │ +0000dde0: 746f 2069 6465 6e74 6966 7920 7468 6520 to identify the │ │ │ │ │ +0000ddf0: 726f 6f74 0a20 2020 2020 6669 6c65 7379 root. filesy │ │ │ │ │ +0000de00: 7374 656d 2074 6f20 7468 6520 4c69 6e75 stem to the Linu │ │ │ │ │ +0000de10: 7820 6b65 726e 656c 2c20 7573 696e 6720 x kernel, using │ │ │ │ │ +0000de20: 6120 2772 6f6f 743d 5555 4944 3d2e 2e2e a 'root=UUID=... │ │ │ │ │ +0000de30: 2720 6b65 726e 656c 0a20 2020 2020 7061 ' kernel. pa │ │ │ │ │ +0000de40: 7261 6d65 7465 722e 2020 5468 6973 2069 rameter. This i │ │ │ │ │ +0000de50: 7320 7573 7561 6c6c 7920 6d6f 7265 2072 s usually more r │ │ │ │ │ +0000de60: 656c 6961 626c 652c 2062 7574 2069 6e20 eliable, but in │ │ │ │ │ +0000de70: 736f 6d65 2063 6173 6573 2069 7420 6d61 some cases it ma │ │ │ │ │ +0000de80: 790a 2020 2020 206e 6f74 2062 6520 6170 y. not be ap │ │ │ │ │ +0000de90: 7072 6f70 7269 6174 652e 2020 546f 2064 propriate. To d │ │ │ │ │ +0000dea0: 6973 6162 6c65 2074 6865 2075 7365 206f isable the use o │ │ │ │ │ +0000deb0: 6620 5555 4944 732c 2073 6574 2074 6869 f UUIDs, set thi │ │ │ │ │ +0000dec0: 7320 6f70 7469 6f6e 0a20 2020 2020 746f s option. to │ │ │ │ │ +0000ded0: 2027 7472 7565 272e 0a0a 2747 5255 425f 'true'...'GRUB_ │ │ │ │ │ +0000dee0: 4449 5341 424c 455f 4c49 4e55 585f 5041 DISABLE_LINUX_PA │ │ │ │ │ +0000def0: 5254 5555 4944 270a 2020 2020 2049 6620 RTUUID'. If │ │ │ │ │ +0000df00: 2767 7275 622d 6d6b 636f 6e66 6967 2720 'grub-mkconfig' │ │ │ │ │ +0000df10: 6361 6e6e 6f74 2069 6465 6e74 6966 7920 cannot identify │ │ │ │ │ +0000df20: 7468 6520 726f 6f74 2066 696c 6573 7973 the root filesys │ │ │ │ │ +0000df30: 7465 6d20 7669 6120 6974 730a 2020 2020 tem via its. │ │ │ │ │ +0000df40: 2075 6e69 7665 7273 616c 6c79 2d75 6e69 universally-uni │ │ │ │ │ +0000df50: 7175 6520 696e 6465 6e74 6966 6965 7220 que indentifier │ │ │ │ │ +0000df60: 2855 5549 4429 2c20 2767 7275 622d 6d6b (UUID), 'grub-mk │ │ │ │ │ +0000df70: 636f 6e66 6967 2720 6361 6e20 7573 6520 config' can use │ │ │ │ │ +0000df80: 7468 650a 2020 2020 2055 5549 4420 6f66 the. UUID of │ │ │ │ │ +0000df90: 2074 6865 2070 6172 7469 7469 6f6e 2063 the partition c │ │ │ │ │ +0000dfa0: 6f6e 7461 696e 696e 6720 7468 6520 6669 ontaining the fi │ │ │ │ │ +0000dfb0: 6c65 7379 7374 656d 2074 6f20 6964 656e lesystem to iden │ │ │ │ │ +0000dfc0: 7469 6679 2074 6865 0a20 2020 2020 726f tify the. ro │ │ │ │ │ +0000dfd0: 6f74 2066 696c 6573 7973 7465 6d20 746f ot filesystem to │ │ │ │ │ +0000dfe0: 2074 6865 204c 696e 7578 206b 6572 6e65 the Linux kerne │ │ │ │ │ +0000dff0: 6c20 7669 6120 6120 2772 6f6f 743d 5041 l via a 'root=PA │ │ │ │ │ +0000e000: 5254 5555 4944 3d2e 2e2e 270a 2020 2020 RTUUID=...'. │ │ │ │ │ +0000e010: 206b 6572 6e65 6c20 7061 7261 6d65 7465 kernel paramete │ │ │ │ │ +0000e020: 722e 2020 5468 6973 2069 7320 6e6f 7420 r. This is not │ │ │ │ │ +0000e030: 6173 2072 656c 6961 626c 6520 6173 2075 as reliable as u │ │ │ │ │ +0000e040: 7369 6e67 2074 6865 2066 696c 6573 7973 sing the filesys │ │ │ │ │ +0000e050: 7465 6d0a 2020 2020 2055 5549 442c 2062 tem. UUID, b │ │ │ │ │ +0000e060: 7574 2069 7320 6d6f 7265 2072 656c 6961 ut is more relia │ │ │ │ │ +0000e070: 626c 6520 7468 616e 2075 7369 6e67 2074 ble than using t │ │ │ │ │ +0000e080: 6865 204c 696e 7578 2064 6576 6963 6520 he Linux device │ │ │ │ │ +0000e090: 6e61 6d65 732e 2020 5768 656e 0a20 2020 names. When. │ │ │ │ │ +0000e0a0: 2020 2747 5255 425f 4449 5341 424c 455f 'GRUB_DISABLE_ │ │ │ │ │ +0000e0b0: 4c49 4e55 585f 5041 5254 5555 4944 2720 LINUX_PARTUUID' │ │ │ │ │ +0000e0c0: 6973 2073 6574 2074 6f20 2766 616c 7365 is set to 'false │ │ │ │ │ +0000e0d0: 272c 2074 6865 204c 696e 7578 206b 6572 ', the Linux ker │ │ │ │ │ +0000e0e0: 6e65 6c0a 2020 2020 2076 6572 7369 6f6e nel. version │ │ │ │ │ +0000e0f0: 206d 7573 7420 6265 2032 2e36 2e33 3720 must be 2.6.37 │ │ │ │ │ +0000e100: 2833 2e31 3020 666f 7220 7379 7374 656d (3.10 for system │ │ │ │ │ +0000e110: 7320 7573 696e 6720 7468 6520 4d53 444f s using the MSDO │ │ │ │ │ +0000e120: 5320 7061 7274 6974 696f 6e0a 2020 2020 S partition. │ │ │ │ │ +0000e130: 2073 6368 656d 6529 206f 7220 6e65 7765 scheme) or newe │ │ │ │ │ +0000e140: 722e 2020 5468 6973 206f 7074 696f 6e20 r. This option │ │ │ │ │ +0000e150: 6465 6661 756c 7473 2074 6f20 2774 7275 defaults to 'tru │ │ │ │ │ +0000e160: 6527 2e20 2054 6f20 656e 6162 6c65 2074 e'. To enable t │ │ │ │ │ +0000e170: 6865 0a20 2020 2020 7573 6520 6f66 2070 he. use of p │ │ │ │ │ +0000e180: 6172 7469 7469 6f6e 2055 5549 4473 2c20 artition UUIDs, │ │ │ │ │ +0000e190: 7365 7420 7468 6973 206f 7074 696f 6e20 set this option │ │ │ │ │ +0000e1a0: 746f 2027 6661 6c73 6527 2e0a 0a27 4752 to 'false'...'GR │ │ │ │ │ +0000e1b0: 5542 5f44 4953 4142 4c45 5f52 4543 4f56 UB_DISABLE_RECOV │ │ │ │ │ +0000e1c0: 4552 5927 0a20 2020 2020 4966 2074 6869 ERY'. If thi │ │ │ │ │ +0000e1d0: 7320 6f70 7469 6f6e 2069 7320 7365 7420 s option is set │ │ │ │ │ +0000e1e0: 746f 2027 7472 7565 272c 2064 6973 6162 to 'true', disab │ │ │ │ │ +0000e1f0: 6c65 2074 6865 2067 656e 6572 6174 696f le the generatio │ │ │ │ │ +0000e200: 6e20 6f66 2072 6563 6f76 6572 790a 2020 n of recovery. │ │ │ │ │ +0000e210: 2020 206d 6f64 6520 6d65 6e75 2065 6e74 mode menu ent │ │ │ │ │ +0000e220: 7269 6573 2e0a 0a27 4752 5542 5f44 4953 ries...'GRUB_DIS │ │ │ │ │ +0000e230: 4142 4c45 5f55 5549 4427 0a20 2020 2020 ABLE_UUID'. │ │ │ │ │ +0000e240: 4e6f 726d 616c 6c79 2c20 2767 7275 622d Normally, 'grub- │ │ │ │ │ +0000e250: 6d6b 636f 6e66 6967 2720 7769 6c6c 2067 mkconfig' will g │ │ │ │ │ +0000e260: 656e 6572 6174 6520 6d65 6e75 2065 6e74 enerate menu ent │ │ │ │ │ +0000e270: 7269 6573 2074 6861 7420 7573 650a 2020 ries that use. │ │ │ │ │ +0000e280: 2020 2075 6e69 7665 7273 616c 6c79 2d75 universally-u │ │ │ │ │ +0000e290: 6e69 7175 6520 6964 656e 7469 6669 6572 nique identifier │ │ │ │ │ +0000e2a0: 7320 2855 5549 4473 2920 746f 2069 6465 s (UUIDs) to ide │ │ │ │ │ +0000e2b0: 6e74 6966 7920 7661 7269 6f75 730a 2020 ntify various. │ │ │ │ │ +0000e2c0: 2020 2066 696c 6573 7973 7465 6d73 2074 filesystems t │ │ │ │ │ +0000e2d0: 6f20 7365 6172 6368 2066 6f72 2066 696c o search for fil │ │ │ │ │ +0000e2e0: 6573 2e20 2054 6869 7320 6973 2075 7375 es. This is usu │ │ │ │ │ +0000e2f0: 616c 6c79 206d 6f72 6520 7265 6c69 6162 ally more reliab │ │ │ │ │ +0000e300: 6c65 2c0a 2020 2020 2062 7574 2069 6e20 le,. but in │ │ │ │ │ +0000e310: 736f 6d65 2063 6173 6573 2069 7420 6d61 some cases it ma │ │ │ │ │ +0000e320: 7920 6e6f 7420 6265 2061 7070 726f 7072 y not be appropr │ │ │ │ │ +0000e330: 6961 7465 2e20 2054 6f20 6469 7361 626c iate. To disabl │ │ │ │ │ +0000e340: 6520 7468 6973 2075 7365 0a20 2020 2020 e this use. │ │ │ │ │ +0000e350: 6f66 2055 5549 4473 2c20 7365 7420 7468 of UUIDs, set th │ │ │ │ │ +0000e360: 6973 206f 7074 696f 6e20 746f 2027 7472 is option to 'tr │ │ │ │ │ +0000e370: 7565 272e 2020 5365 7474 696e 6720 7468 ue'. Setting th │ │ │ │ │ +0000e380: 6973 206f 7074 696f 6e20 746f 0a20 2020 is option to. │ │ │ │ │ +0000e390: 2020 2774 7275 6527 2c20 7769 6c6c 2061 'true', will a │ │ │ │ │ +0000e3a0: 6c73 6f20 7365 7420 7468 6520 6f70 7469 lso set the opti │ │ │ │ │ +0000e3b0: 6f6e 7320 2747 5255 425f 4449 5341 424c ons 'GRUB_DISABL │ │ │ │ │ +0000e3c0: 455f 4c49 4e55 585f 5555 4944 2720 616e E_LINUX_UUID' an │ │ │ │ │ +0000e3d0: 640a 2020 2020 2027 4752 5542 5f44 4953 d. 'GRUB_DIS │ │ │ │ │ +0000e3e0: 4142 4c45 5f4c 494e 5558 5f50 4152 5455 ABLE_LINUX_PARTU │ │ │ │ │ +0000e3f0: 5549 4427 2074 6f20 2774 7275 6527 2c20 UID' to 'true', │ │ │ │ │ +0000e400: 756e 6c65 7373 2074 6865 7920 6861 7665 unless they have │ │ │ │ │ +0000e410: 2062 6565 6e0a 2020 2020 2065 7870 6c69 been. expli │ │ │ │ │ +0000e420: 6369 6c74 7920 7365 7420 746f 2027 6661 cilty set to 'fa │ │ │ │ │ +0000e430: 6c73 6527 2e0a 0a27 4752 5542 5f56 4944 lse'...'GRUB_VID │ │ │ │ │ +0000e440: 454f 5f42 4143 4b45 4e44 270a 2020 2020 EO_BACKEND'. │ │ │ │ │ +0000e450: 2049 6620 6772 6170 6869 6361 6c20 7669 If graphical vi │ │ │ │ │ +0000e460: 6465 6f20 7375 7070 6f72 7420 6973 2072 deo support is r │ │ │ │ │ +0000e470: 6571 7569 7265 642c 2065 6974 6865 7220 equired, either │ │ │ │ │ +0000e480: 6265 6361 7573 6520 7468 650a 2020 2020 because the. │ │ │ │ │ +0000e490: 2027 6766 7874 6572 6d27 2067 7261 7068 'gfxterm' graph │ │ │ │ │ +0000e4a0: 6963 616c 2074 6572 6d69 6e61 6c20 6973 ical terminal is │ │ │ │ │ +0000e4b0: 2069 6e20 7573 6520 6f72 2062 6563 6175 in use or becau │ │ │ │ │ +0000e4c0: 7365 0a20 2020 2020 2747 5255 425f 4746 se. 'GRUB_GF │ │ │ │ │ +0000e4d0: 5850 4159 4c4f 4144 5f4c 494e 5558 2720 XPAYLOAD_LINUX' │ │ │ │ │ +0000e4e0: 6973 2073 6574 2c20 7468 656e 2027 6772 is set, then 'gr │ │ │ │ │ +0000e4f0: 7562 2d6d 6b63 6f6e 6669 6727 2077 696c ub-mkconfig' wil │ │ │ │ │ +0000e500: 6c20 6e6f 726d 616c 6c79 0a20 2020 2020 l normally. │ │ │ │ │ +0000e510: 6c6f 6164 2061 6c6c 2061 7661 696c 6162 load all availab │ │ │ │ │ +0000e520: 6c65 2047 5255 4220 7669 6465 6f20 6472 le GRUB video dr │ │ │ │ │ +0000e530: 6976 6572 7320 616e 6420 7573 6520 7468 ivers and use th │ │ │ │ │ +0000e540: 6520 6f6e 6520 6d6f 7374 0a20 2020 2020 e one most. │ │ │ │ │ +0000e550: 6170 7072 6f70 7269 6174 6520 666f 7220 appropriate for │ │ │ │ │ +0000e560: 796f 7572 2068 6172 6477 6172 652e 2020 your hardware. │ │ │ │ │ +0000e570: 4966 2079 6f75 206e 6565 6420 746f 206f If you need to o │ │ │ │ │ +0000e580: 7665 7272 6964 6520 7468 6973 2066 6f72 verride this for │ │ │ │ │ +0000e590: 0a20 2020 2020 736f 6d65 2072 6561 736f . some reaso │ │ │ │ │ +0000e5a0: 6e2c 2074 6865 6e20 796f 7520 6361 6e20 n, then you can │ │ │ │ │ +0000e5b0: 7365 7420 7468 6973 206f 7074 696f 6e2e set this option. │ │ │ │ │ +0000e5c0: 0a0a 2020 2020 2041 6674 6572 2027 6772 .. After 'gr │ │ │ │ │ +0000e5d0: 7562 2d69 6e73 7461 6c6c 2720 6861 7320 ub-install' has │ │ │ │ │ +0000e5e0: 6265 656e 2072 756e 2c20 7468 6520 6176 been run, the av │ │ │ │ │ +0000e5f0: 6169 6c61 626c 6520 7669 6465 6f20 6472 ailable video dr │ │ │ │ │ +0000e600: 6976 6572 7320 6172 650a 2020 2020 206c ivers are. l │ │ │ │ │ +0000e610: 6973 7465 6420 696e 2027 2f62 6f6f 742f isted in '/boot/ │ │ │ │ │ +0000e620: 6772 7562 2f76 6964 656f 2e6c 7374 272e grub/video.lst'. │ │ │ │ │ +0000e630: 0a0a 2747 5255 425f 4746 584d 4f44 4527 ..'GRUB_GFXMODE' │ │ │ │ │ +0000e640: 0a20 2020 2020 5365 7420 7468 6520 7265 . Set the re │ │ │ │ │ +0000e650: 736f 6c75 7469 6f6e 2075 7365 6420 6f6e solution used on │ │ │ │ │ +0000e660: 2074 6865 2027 6766 7874 6572 6d27 2067 the 'gfxterm' g │ │ │ │ │ +0000e670: 7261 7068 6963 616c 2074 6572 6d69 6e61 raphical termina │ │ │ │ │ +0000e680: 6c2e 2020 4e6f 7465 0a20 2020 2020 7468 l. Note. th │ │ │ │ │ +0000e690: 6174 2079 6f75 2063 616e 206f 6e6c 7920 at you can only │ │ │ │ │ +0000e6a0: 7573 6520 6d6f 6465 7320 7768 6963 6820 use modes which │ │ │ │ │ +0000e6b0: 796f 7572 2067 7261 7068 6963 7320 6361 your graphics ca │ │ │ │ │ +0000e6c0: 7264 2073 7570 706f 7274 7320 7669 610a rd supports via. │ │ │ │ │ +0000e6d0: 2020 2020 2056 4553 4120 4249 4f53 2045 VESA BIOS E │ │ │ │ │ +0000e6e0: 7874 656e 7369 6f6e 7320 2856 4245 292c xtensions (VBE), │ │ │ │ │ +0000e6f0: 2073 6f20 666f 7220 6578 616d 706c 6520 so for example │ │ │ │ │ +0000e700: 6e61 7469 7665 204c 4344 2070 616e 656c native LCD panel │ │ │ │ │ +0000e710: 0a20 2020 2020 7265 736f 6c75 7469 6f6e . resolution │ │ │ │ │ +0000e720: 7320 6d61 7920 6e6f 7420 6265 2061 7661 s may not be ava │ │ │ │ │ +0000e730: 696c 6162 6c65 2e20 2054 6865 2064 6566 ilable. The def │ │ │ │ │ +0000e740: 6175 6c74 2069 7320 2761 7574 6f27 2c20 ault is 'auto', │ │ │ │ │ +0000e750: 7768 6963 680a 2020 2020 2074 7269 6573 which. tries │ │ │ │ │ +0000e760: 2074 6f20 7365 6c65 6374 2061 2070 7265 to select a pre │ │ │ │ │ +0000e770: 6665 7272 6564 2072 6573 6f6c 7574 696f ferred resolutio │ │ │ │ │ +0000e780: 6e2e 2020 2a4e 6f74 6520 6766 786d 6f64 n. *Note gfxmod │ │ │ │ │ +0000e790: 653a 3a2e 0a0a 2747 5255 425f 4241 434b e::...'GRUB_BACK │ │ │ │ │ +0000e7a0: 4752 4f55 4e44 270a 2020 2020 2053 6574 GROUND'. Set │ │ │ │ │ +0000e7b0: 2061 2062 6163 6b67 726f 756e 6420 696d a background im │ │ │ │ │ +0000e7c0: 6167 6520 666f 7220 7573 6520 7769 7468 age for use with │ │ │ │ │ +0000e7d0: 2074 6865 2027 6766 7874 6572 6d27 2067 the 'gfxterm' g │ │ │ │ │ +0000e7e0: 7261 7068 6963 616c 0a20 2020 2020 7465 raphical. te │ │ │ │ │ +0000e7f0: 726d 696e 616c 2e20 2054 6865 2076 616c rminal. The val │ │ │ │ │ +0000e800: 7565 206f 6620 7468 6973 206f 7074 696f ue of this optio │ │ │ │ │ +0000e810: 6e20 6d75 7374 2062 6520 6120 6669 6c65 n must be a file │ │ │ │ │ +0000e820: 2072 6561 6461 626c 6520 6279 2047 5255 readable by GRU │ │ │ │ │ +0000e830: 420a 2020 2020 2061 7420 626f 6f74 2074 B. at boot t │ │ │ │ │ +0000e840: 696d 652c 2061 6e64 2069 7420 6d75 7374 ime, and it must │ │ │ │ │ +0000e850: 2065 6e64 2077 6974 6820 272e 706e 6727 end with '.png' │ │ │ │ │ +0000e860: 2c20 272e 7467 6127 2c20 272e 6a70 6727 , '.tga', '.jpg' │ │ │ │ │ +0000e870: 2c20 6f72 0a20 2020 2020 272e 6a70 6567 , or. '.jpeg │ │ │ │ │ +0000e880: 272e 2020 5468 6520 696d 6167 6520 7769 '. The image wi │ │ │ │ │ +0000e890: 6c6c 2062 6520 7363 616c 6564 2069 6620 ll be scaled if │ │ │ │ │ +0000e8a0: 6e65 6365 7373 6172 7920 746f 2066 6974 necessary to fit │ │ │ │ │ +0000e8b0: 2074 6865 2073 6372 6565 6e2e 0a20 2020 the screen.. │ │ │ │ │ +0000e8c0: 2020 496d 6167 6520 6865 6967 6874 2061 Image height a │ │ │ │ │ +0000e8d0: 6e64 2077 6964 7468 2077 696c 6c20 6265 nd width will be │ │ │ │ │ +0000e8e0: 2072 6573 7472 6963 7465 6420 6279 2061 restricted by a │ │ │ │ │ +0000e8f0: 6e20 6172 7469 6669 6369 616c 206c 696d n artificial lim │ │ │ │ │ +0000e900: 6974 206f 660a 2020 2020 2031 3633 3834 it of. 16384 │ │ │ │ │ +0000e910: 2e0a 0a27 4752 5542 5f54 4845 4d45 270a ...'GRUB_THEME'. │ │ │ │ │ +0000e920: 2020 2020 2053 6574 2061 2074 6865 6d65 Set a theme │ │ │ │ │ +0000e930: 2066 6f72 2075 7365 2077 6974 6820 7468 for use with th │ │ │ │ │ +0000e940: 6520 2767 6678 7465 726d 2720 6772 6170 e 'gfxterm' grap │ │ │ │ │ +0000e950: 6869 6361 6c20 7465 726d 696e 616c 2e0a hical terminal.. │ │ │ │ │ +0000e960: 0a27 4752 5542 5f47 4658 5041 594c 4f41 .'GRUB_GFXPAYLOA │ │ │ │ │ +0000e970: 445f 4c49 4e55 5827 0a20 2020 2020 5365 D_LINUX'. Se │ │ │ │ │ +0000e980: 7420 746f 2027 7465 7874 2720 746f 2066 t to 'text' to f │ │ │ │ │ +0000e990: 6f72 6365 2074 6865 204c 696e 7578 206b orce the Linux k │ │ │ │ │ +0000e9a0: 6572 6e65 6c20 746f 2062 6f6f 7420 696e ernel to boot in │ │ │ │ │ +0000e9b0: 206e 6f72 6d61 6c20 7465 7874 0a20 2020 normal text. │ │ │ │ │ +0000e9c0: 2020 6d6f 6465 2c20 276b 6565 7027 2074 mode, 'keep' t │ │ │ │ │ +0000e9d0: 6f20 7072 6573 6572 7665 2074 6865 2067 o preserve the g │ │ │ │ │ +0000e9e0: 7261 7068 6963 7320 6d6f 6465 2073 6574 raphics mode set │ │ │ │ │ +0000e9f0: 2075 7369 6e67 0a20 2020 2020 2747 5255 using. 'GRU │ │ │ │ │ +0000ea00: 425f 4746 584d 4f44 4527 2c20 2757 4944 B_GFXMODE', 'WID │ │ │ │ │ +0000ea10: 5448 7848 4549 4748 5427 5b27 7844 4550 THxHEIGHT'['xDEP │ │ │ │ │ +0000ea20: 5448 275d 2074 6f20 7365 7420 6120 7061 TH'] to set a pa │ │ │ │ │ +0000ea30: 7274 6963 756c 6172 0a20 2020 2020 6772 rticular. gr │ │ │ │ │ +0000ea40: 6170 6869 6373 206d 6f64 652c 206f 7220 aphics mode, or │ │ │ │ │ +0000ea50: 6120 7365 7175 656e 6365 206f 6620 7468 a sequence of th │ │ │ │ │ +0000ea60: 6573 6520 7365 7061 7261 7465 6420 6279 ese separated by │ │ │ │ │ +0000ea70: 2063 6f6d 6d61 7320 6f72 0a20 2020 2020 commas or. │ │ │ │ │ +0000ea80: 7365 6d69 636f 6c6f 6e73 2074 6f20 7472 semicolons to tr │ │ │ │ │ +0000ea90: 7920 7365 7665 7261 6c20 6d6f 6465 7320 y several modes │ │ │ │ │ +0000eaa0: 696e 2073 6571 7565 6e63 652e 2020 2a4e in sequence. *N │ │ │ │ │ +0000eab0: 6f74 6520 6766 7870 6179 6c6f 6164 3a3a ote gfxpayload:: │ │ │ │ │ +0000eac0: 2e0a 0a20 2020 2020 4465 7065 6e64 696e ... Dependin │ │ │ │ │ +0000ead0: 6720 6f6e 2079 6f75 7220 6b65 726e 656c g on your kernel │ │ │ │ │ +0000eae0: 2c20 796f 7572 2064 6973 7472 6962 7574 , your distribut │ │ │ │ │ +0000eaf0: 696f 6e2c 2079 6f75 7220 6772 6170 6869 ion, your graphi │ │ │ │ │ +0000eb00: 6373 2063 6172 642c 0a20 2020 2020 616e cs card,. an │ │ │ │ │ +0000eb10: 6420 7468 6520 7068 6173 6520 6f66 2074 d the phase of t │ │ │ │ │ +0000eb20: 6865 206d 6f6f 6e2c 206e 6f74 6520 7468 he moon, note th │ │ │ │ │ +0000eb30: 6174 2075 7369 6e67 2074 6869 7320 6f70 at using this op │ │ │ │ │ +0000eb40: 7469 6f6e 206d 6179 2063 6175 7365 0a20 tion may cause. │ │ │ │ │ +0000eb50: 2020 2020 474e 552f 4c69 6e75 7820 746f GNU/Linux to │ │ │ │ │ +0000eb60: 2073 7566 6665 7220 6672 6f6d 2076 6172 suffer from var │ │ │ │ │ +0000eb70: 696f 7573 2064 6973 706c 6179 2070 726f ious display pro │ │ │ │ │ +0000eb80: 626c 656d 732c 2070 6172 7469 6375 6c61 blems, particula │ │ │ │ │ +0000eb90: 726c 790a 2020 2020 2064 7572 696e 6720 rly. during │ │ │ │ │ +0000eba0: 7468 6520 6561 726c 7920 7061 7274 206f the early part o │ │ │ │ │ +0000ebb0: 6620 7468 6520 626f 6f74 2073 6571 7565 f the boot seque │ │ │ │ │ +0000ebc0: 6e63 652e 2020 4966 2079 6f75 2068 6176 nce. If you hav │ │ │ │ │ +0000ebd0: 6520 7072 6f62 6c65 6d73 2c0a 2020 2020 e problems,. │ │ │ │ │ +0000ebe0: 2073 6574 2074 6869 7320 6f70 7469 6f6e set this option │ │ │ │ │ +0000ebf0: 2074 6f20 2774 6578 7427 2061 6e64 2047 to 'text' and G │ │ │ │ │ +0000ec00: 5255 4220 7769 6c6c 2074 656c 6c20 4c69 RUB will tell Li │ │ │ │ │ +0000ec10: 6e75 7820 746f 2062 6f6f 7420 696e 0a20 nux to boot in. │ │ │ │ │ +0000ec20: 2020 2020 6e6f 726d 616c 2074 6578 7420 normal text │ │ │ │ │ +0000ec30: 6d6f 6465 2e0a 0a27 4752 5542 5f44 4953 mode...'GRUB_DIS │ │ │ │ │ +0000ec40: 4142 4c45 5f4f 535f 5052 4f42 4552 270a ABLE_OS_PROBER'. │ │ │ │ │ +0000ec50: 2020 2020 2054 6865 2027 6772 7562 2d6d The 'grub-m │ │ │ │ │ +0000ec60: 6b63 6f6e 6669 6727 2068 6173 2061 2066 kconfig' has a f │ │ │ │ │ +0000ec70: 6561 7475 7265 2074 6f20 7573 6520 7468 eature to use th │ │ │ │ │ +0000ec80: 6520 6578 7465 726e 616c 2027 6f73 2d70 e external 'os-p │ │ │ │ │ +0000ec90: 726f 6265 7227 0a20 2020 2020 7072 6f67 rober'. prog │ │ │ │ │ +0000eca0: 7261 6d20 746f 2064 6973 636f 7665 7220 ram to discover │ │ │ │ │ +0000ecb0: 6f74 6865 7220 6f70 6572 6174 696e 6720 other operating │ │ │ │ │ +0000ecc0: 7379 7374 656d 7320 696e 7374 616c 6c65 systems installe │ │ │ │ │ +0000ecd0: 6420 6f6e 2074 6865 2073 616d 650a 2020 d on the same. │ │ │ │ │ +0000ece0: 2020 206d 6163 6869 6e65 2061 6e64 2067 machine and g │ │ │ │ │ +0000ecf0: 656e 6572 6174 6520 6170 7072 6f70 7269 enerate appropri │ │ │ │ │ +0000ed00: 6174 6520 6d65 6e75 2065 6e74 7269 6573 ate menu entries │ │ │ │ │ +0000ed10: 2066 6f72 2074 6865 6d2e 2020 4974 2069 for them. It i │ │ │ │ │ +0000ed20: 730a 2020 2020 2064 6973 6162 6c65 6420 s. disabled │ │ │ │ │ +0000ed30: 6279 2064 6566 6175 6c74 2073 696e 6365 by default since │ │ │ │ │ +0000ed40: 2061 7574 6f6d 6174 6963 2061 6e64 2073 automatic and s │ │ │ │ │ +0000ed50: 696c 656e 7420 6578 6563 7574 696f 6e20 ilent execution │ │ │ │ │ +0000ed60: 6f66 0a20 2020 2020 276f 732d 7072 6f62 of. 'os-prob │ │ │ │ │ +0000ed70: 6572 272c 2061 6e64 2063 7265 6174 696e er', and creatin │ │ │ │ │ +0000ed80: 6720 626f 6f74 2065 6e74 7269 6573 2062 g boot entries b │ │ │ │ │ +0000ed90: 6173 6564 206f 6e20 7468 6174 2064 6174 ased on that dat │ │ │ │ │ +0000eda0: 612c 2069 7320 610a 2020 2020 2070 6f74 a, is a. pot │ │ │ │ │ +0000edb0: 656e 7469 616c 2061 7474 6163 6b20 7665 ential attack ve │ │ │ │ │ +0000edc0: 6374 6f72 2e20 2053 6574 2074 6869 7320 ctor. Set this │ │ │ │ │ +0000edd0: 6f70 7469 6f6e 2074 6f20 2766 616c 7365 option to 'false │ │ │ │ │ +0000ede0: 2720 746f 2065 6e61 626c 6520 7468 6973 ' to enable this │ │ │ │ │ +0000edf0: 0a20 2020 2020 6665 6174 7572 6520 696e . feature in │ │ │ │ │ +0000ee00: 2074 6865 2027 6772 7562 2d6d 6b63 6f6e the 'grub-mkcon │ │ │ │ │ +0000ee10: 6669 6727 2063 6f6d 6d61 6e64 2e0a 0a27 fig' command...' │ │ │ │ │ +0000ee20: 4752 5542 5f4f 535f 5052 4f42 4552 5f53 GRUB_OS_PROBER_S │ │ │ │ │ +0000ee30: 4b49 505f 4c49 5354 270a 2020 2020 204c KIP_LIST'. L │ │ │ │ │ +0000ee40: 6973 7420 6f66 2073 7061 6365 2d73 6570 ist of space-sep │ │ │ │ │ +0000ee50: 6172 6174 6564 2046 5320 5555 4944 7320 arated FS UUIDs │ │ │ │ │ +0000ee60: 6f66 2066 696c 6573 7973 7465 6d73 2074 of filesystems t │ │ │ │ │ +0000ee70: 6f20 6265 2069 676e 6f72 6564 2066 726f o be ignored fro │ │ │ │ │ +0000ee80: 6d0a 2020 2020 206f 732d 7072 6f62 6572 m. os-prober │ │ │ │ │ +0000ee90: 206f 7574 7075 742e 2020 466f 7220 6566 output. For ef │ │ │ │ │ +0000eea0: 6920 6368 6169 6e6c 6f61 6465 7273 2069 i chainloaders i │ │ │ │ │ +0000eeb0: 7427 7320 3c55 5549 443e 403c 4546 4920 t's @..'GRUB_DIS │ │ │ │ │ +0000eed0: 4142 4c45 5f53 5542 4d45 4e55 270a 2020 ABLE_SUBMENU'. │ │ │ │ │ +0000eee0: 2020 204e 6f72 6d61 6c6c 792c 2027 6772 Normally, 'gr │ │ │ │ │ +0000eef0: 7562 2d6d 6b63 6f6e 6669 6727 2077 696c ub-mkconfig' wil │ │ │ │ │ +0000ef00: 6c20 6765 6e65 7261 7465 2074 6f70 206c l generate top l │ │ │ │ │ +0000ef10: 6576 656c 206d 656e 7520 656e 7472 7920 evel menu entry │ │ │ │ │ +0000ef20: 666f 720a 2020 2020 2074 6865 206b 6572 for. the ker │ │ │ │ │ +0000ef30: 6e65 6c20 7769 7468 2068 6967 6865 7374 nel with highest │ │ │ │ │ +0000ef40: 2076 6572 7369 6f6e 206e 756d 6265 7220 version number │ │ │ │ │ +0000ef50: 616e 6420 7075 7420 616c 6c20 6f74 6865 and put all othe │ │ │ │ │ +0000ef60: 7220 666f 756e 640a 2020 2020 206b 6572 r found. ker │ │ │ │ │ +0000ef70: 6e65 6c73 206f 7220 616c 7465 726e 6174 nels or alternat │ │ │ │ │ +0000ef80: 6976 6520 6d65 6e75 2065 6e74 7269 6573 ive menu entries │ │ │ │ │ +0000ef90: 2066 6f72 2072 6563 6f76 6572 7920 6d6f for recovery mo │ │ │ │ │ +0000efa0: 6465 2069 6e20 7375 626d 656e 752e 0a20 de in submenu.. │ │ │ │ │ +0000efb0: 2020 2020 466f 7220 656e 7472 6965 7320 For entries │ │ │ │ │ +0000efc0: 7265 7475 726e 6564 2062 7920 276f 732d returned by 'os- │ │ │ │ │ +0000efd0: 7072 6f62 6572 2720 6669 7273 7420 656e prober' first en │ │ │ │ │ +0000efe0: 7472 7920 7769 6c6c 2062 6520 7075 7420 try will be put │ │ │ │ │ +0000eff0: 6f6e 2074 6f70 0a20 2020 2020 6c65 7665 on top. leve │ │ │ │ │ +0000f000: 6c20 616e 6420 616c 6c20 6f74 6865 7273 l and all others │ │ │ │ │ +0000f010: 2069 6e20 7375 626d 656e 752e 2020 4966 in submenu. If │ │ │ │ │ +0000f020: 2074 6869 7320 6f70 7469 6f6e 2069 7320 this option is │ │ │ │ │ +0000f030: 7365 7420 746f 2027 7472 7565 272c 0a20 set to 'true',. │ │ │ │ │ +0000f040: 2020 2020 666c 6174 206d 656e 7520 7769 flat menu wi │ │ │ │ │ +0000f050: 7468 2061 6c6c 2065 6e74 7269 6573 206f th all entries o │ │ │ │ │ +0000f060: 6e20 746f 7020 6c65 7665 6c20 7769 6c6c n top level will │ │ │ │ │ +0000f070: 2062 6520 6765 6e65 7261 7465 6420 696e be generated in │ │ │ │ │ +0000f080: 7374 6561 642e 0a20 2020 2020 4368 616e stead.. Chan │ │ │ │ │ +0000f090: 6769 6e67 2074 6869 7320 6f70 7469 6f6e ging this option │ │ │ │ │ +0000f0a0: 2077 696c 6c20 7265 7175 6972 6520 6368 will require ch │ │ │ │ │ +0000f0b0: 616e 6769 6e67 2065 7869 7374 696e 6720 anging existing │ │ │ │ │ +0000f0c0: 7661 6c75 6573 206f 660a 2020 2020 2027 values of. ' │ │ │ │ │ +0000f0d0: 4752 5542 5f44 4546 4155 4c54 272c 2027 GRUB_DEFAULT', ' │ │ │ │ │ +0000f0e0: 6661 6c6c 6261 636b 2720 282a 6e6f 7465 fallback' (*note │ │ │ │ │ +0000f0f0: 2066 616c 6c62 6163 6b3a 3a29 2061 6e64 fallback::) and │ │ │ │ │ +0000f100: 2027 6465 6661 756c 7427 2028 2a6e 6f74 'default' (*not │ │ │ │ │ +0000f110: 650a 2020 2020 2064 6566 6175 6c74 3a3a e. default:: │ │ │ │ │ +0000f120: 2920 656e 7669 726f 6e6d 656e 7420 7661 ) environment va │ │ │ │ │ +0000f130: 7269 6162 6c65 7320 6173 2077 656c 6c20 riables as well │ │ │ │ │ +0000f140: 6173 2073 6176 6564 2064 6566 6175 6c74 as saved default │ │ │ │ │ +0000f150: 2065 6e74 7279 0a20 2020 2020 7573 696e entry. usin │ │ │ │ │ +0000f160: 6720 2767 7275 622d 7365 742d 6465 6661 g 'grub-set-defa │ │ │ │ │ +0000f170: 756c 7427 2061 6e64 2076 616c 7565 2075 ult' and value u │ │ │ │ │ +0000f180: 7365 6420 7769 7468 2027 6772 7562 2d72 sed with 'grub-r │ │ │ │ │ +0000f190: 6562 6f6f 7427 2e0a 0a27 4752 5542 5f45 eboot'...'GRUB_E │ │ │ │ │ +0000f1a0: 4e41 424c 455f 4352 5950 544f 4449 534b NABLE_CRYPTODISK │ │ │ │ │ +0000f1b0: 270a 2020 2020 2049 6620 7365 7420 746f '. If set to │ │ │ │ │ +0000f1c0: 2027 7927 2c20 2767 7275 622d 6d6b 636f 'y', 'grub-mkco │ │ │ │ │ +0000f1d0: 6e66 6967 2720 616e 6420 2767 7275 622d nfig' and 'grub- │ │ │ │ │ +0000f1e0: 696e 7374 616c 6c27 2077 696c 6c20 6368 install' will ch │ │ │ │ │ +0000f1f0: 6563 6b20 666f 720a 2020 2020 2065 6e63 eck for. enc │ │ │ │ │ +0000f200: 7279 7074 6564 2064 6973 6b73 2061 6e64 rypted disks and │ │ │ │ │ +0000f210: 2067 656e 6572 6174 6520 6164 6469 7469 generate additi │ │ │ │ │ +0000f220: 6f6e 616c 2063 6f6d 6d61 6e64 7320 6e65 onal commands ne │ │ │ │ │ +0000f230: 6564 6564 2074 6f20 6163 6365 7373 0a20 eded to access. │ │ │ │ │ +0000f240: 2020 2020 7468 656d 2064 7572 696e 6720 them during │ │ │ │ │ +0000f250: 626f 6f74 2e20 204e 6f74 6520 7468 6174 boot. Note that │ │ │ │ │ +0000f260: 2069 6e20 7468 6973 2063 6173 6520 756e in this case un │ │ │ │ │ +0000f270: 6174 7465 6e64 6564 2062 6f6f 7420 6973 attended boot is │ │ │ │ │ +0000f280: 206e 6f74 0a20 2020 2020 706f 7373 6962 not. possib │ │ │ │ │ +0000f290: 6c65 2062 6563 6175 7365 2047 5255 4220 le because GRUB │ │ │ │ │ +0000f2a0: 7769 6c6c 2077 6169 7420 666f 7220 7061 will wait for pa │ │ │ │ │ +0000f2b0: 7373 7068 7261 7365 2074 6f20 756e 6c6f ssphrase to unlo │ │ │ │ │ +0000f2c0: 636b 2065 6e63 7279 7074 6564 0a20 2020 ck encrypted. │ │ │ │ │ +0000f2d0: 2020 636f 6e74 6169 6e65 722e 0a0a 2747 container...'G │ │ │ │ │ +0000f2e0: 5255 425f 494e 4954 5f54 554e 4527 0a20 RUB_INIT_TUNE'. │ │ │ │ │ +0000f2f0: 2020 2020 506c 6179 2061 2074 756e 6520 Play a tune │ │ │ │ │ +0000f300: 6f6e 2074 6865 2073 7065 616b 6572 2077 on the speaker w │ │ │ │ │ +0000f310: 6865 6e20 4752 5542 2073 7461 7274 732e hen GRUB starts. │ │ │ │ │ +0000f320: 2020 5468 6973 2069 7320 7061 7274 6963 This is partic │ │ │ │ │ +0000f330: 756c 6172 6c79 0a20 2020 2020 7573 6566 ularly. usef │ │ │ │ │ +0000f340: 756c 2066 6f72 2075 7365 7273 2075 6e61 ul for users una │ │ │ │ │ +0000f350: 626c 6520 746f 2073 6565 2074 6865 2073 ble to see the s │ │ │ │ │ +0000f360: 6372 6565 6e2e 2020 5468 6520 7661 6c75 creen. The valu │ │ │ │ │ +0000f370: 6520 6f66 2074 6869 730a 2020 2020 206f e of this. o │ │ │ │ │ +0000f380: 7074 696f 6e20 6973 2070 6173 7365 6420 ption is passed │ │ │ │ │ +0000f390: 6469 7265 6374 6c79 2074 6f20 2a6e 6f74 directly to *not │ │ │ │ │ +0000f3a0: 6520 706c 6179 3a3a 2e0a 0a27 4752 5542 e play::...'GRUB │ │ │ │ │ +0000f3b0: 5f42 4144 5241 4d27 0a20 2020 2020 4966 _BADRAM'. If │ │ │ │ │ +0000f3c0: 2074 6869 7320 6f70 7469 6f6e 2069 7320 this option is │ │ │ │ │ +0000f3d0: 7365 742c 2047 5255 4220 7769 6c6c 2069 set, GRUB will i │ │ │ │ │ +0000f3e0: 7373 7565 2061 202a 6e6f 7465 2062 6164 ssue a *note bad │ │ │ │ │ +0000f3f0: 7261 6d3a 3a20 636f 6d6d 616e 6420 746f ram:: command to │ │ │ │ │ +0000f400: 0a20 2020 2020 6669 6c74 6572 206f 7574 . filter out │ │ │ │ │ +0000f410: 2073 7065 6369 6669 6564 2072 6567 696f specified regio │ │ │ │ │ +0000f420: 6e73 206f 6620 5241 4d2e 0a0a 2747 5255 ns of RAM...'GRU │ │ │ │ │ +0000f430: 425f 5052 454c 4f41 445f 4d4f 4455 4c45 B_PRELOAD_MODULE │ │ │ │ │ +0000f440: 5327 0a20 2020 2020 5468 6973 206f 7074 S'. This opt │ │ │ │ │ +0000f450: 696f 6e20 6d61 7920 6265 2073 6574 2074 ion may be set t │ │ │ │ │ +0000f460: 6f20 6120 6c69 7374 206f 6620 4752 5542 o a list of GRUB │ │ │ │ │ +0000f470: 206d 6f64 756c 6520 6e61 6d65 7320 7365 module names se │ │ │ │ │ +0000f480: 7061 7261 7465 6420 6279 0a20 2020 2020 parated by. │ │ │ │ │ +0000f490: 7370 6163 6573 2e20 2045 6163 6820 6d6f spaces. Each mo │ │ │ │ │ +0000f4a0: 6475 6c65 2077 696c 6c20 6265 206c 6f61 dule will be loa │ │ │ │ │ +0000f4b0: 6465 6420 6173 2065 6172 6c79 2061 7320 ded as early as │ │ │ │ │ +0000f4c0: 706f 7373 6962 6c65 2c20 6174 2074 6865 possible, at the │ │ │ │ │ +0000f4d0: 0a20 2020 2020 7374 6172 7420 6f66 2027 . start of ' │ │ │ │ │ +0000f4e0: 6772 7562 2e63 6667 272e 0a0a 2747 5255 grub.cfg'...'GRU │ │ │ │ │ +0000f4f0: 425f 5245 434f 5244 4641 494c 5f54 494d B_RECORDFAIL_TIM │ │ │ │ │ +0000f500: 454f 5554 270a 2020 2020 2049 6620 7468 EOUT'. If th │ │ │ │ │ +0000f510: 6973 206f 7074 696f 6e20 6973 2073 6574 is option is set │ │ │ │ │ +0000f520: 2c20 6974 206f 7665 7272 6964 6573 2074 , it overrides t │ │ │ │ │ +0000f530: 6865 2064 6566 6175 6c74 2072 6563 6f72 he default recor │ │ │ │ │ +0000f540: 6466 6169 6c20 7365 7474 696e 672e 0a20 dfail setting.. │ │ │ │ │ +0000f550: 2020 2020 4120 7365 7474 696e 6720 6f66 A setting of │ │ │ │ │ +0000f560: 202d 3120 6361 7573 6573 2047 5255 4220 -1 causes GRUB │ │ │ │ │ +0000f570: 746f 2077 6169 7420 666f 7220 7573 6572 to wait for user │ │ │ │ │ +0000f580: 2069 6e70 7574 2069 6e64 6566 696e 6974 input indefinit │ │ │ │ │ +0000f590: 656c 792e 0a20 2020 2020 486f 7765 7665 ely.. Howeve │ │ │ │ │ +0000f5a0: 722c 2061 2066 616c 7365 2070 6f73 6974 r, a false posit │ │ │ │ │ +0000f5b0: 6976 6520 696e 2074 6865 2072 6563 6f72 ive in the recor │ │ │ │ │ +0000f5c0: 6466 6169 6c20 6d65 6368 616e 6973 6d20 dfail mechanism │ │ │ │ │ +0000f5d0: 6d61 7920 6f63 6375 7220 6966 0a20 2020 may occur if. │ │ │ │ │ +0000f5e0: 2020 706f 7765 7220 6973 206c 6f73 7420 power is lost │ │ │ │ │ +0000f5f0: 6475 7269 6e67 2062 6f6f 7420 6265 666f during boot befo │ │ │ │ │ +0000f600: 7265 2062 6f6f 7420 7375 6363 6573 7320 re boot success │ │ │ │ │ +0000f610: 6973 2072 6563 6f72 6465 6420 696e 0a20 is recorded in. │ │ │ │ │ +0000f620: 2020 2020 7573 6572 7370 6163 652e 2020 userspace. │ │ │ │ │ +0000f630: 5468 6520 6465 6661 756c 7420 7365 7474 The default sett │ │ │ │ │ +0000f640: 696e 6720 6973 2033 302c 2077 6869 6368 ing is 30, which │ │ │ │ │ +0000f650: 2063 6175 7365 7320 4752 5542 2074 6f20 causes GRUB to │ │ │ │ │ +0000f660: 7761 6974 0a20 2020 2020 666f 7220 7573 wait. for us │ │ │ │ │ +0000f670: 6572 2069 6e70 7574 2066 6f72 2074 6869 er input for thi │ │ │ │ │ +0000f680: 7274 7920 7365 636f 6e64 7320 6265 666f rty seconds befo │ │ │ │ │ +0000f690: 7265 2063 6f6e 7469 6e75 696e 672e 2020 re continuing. │ │ │ │ │ +0000f6a0: 5468 6973 2064 6566 6175 6c74 0a20 2020 This default. │ │ │ │ │ +0000f6b0: 2020 616c 6c6f 7773 2069 6e74 6572 6163 allows interac │ │ │ │ │ +0000f6c0: 7469 7665 2075 7365 7273 2074 6865 206f tive users the o │ │ │ │ │ +0000f6d0: 7070 6f72 7475 6e69 7479 2074 6f20 7377 pportunity to sw │ │ │ │ │ +0000f6e0: 6974 6368 2074 6f20 6120 6469 6666 6572 itch to a differ │ │ │ │ │ +0000f6f0: 656e 742c 0a20 2020 2020 776f 726b 696e ent,. workin │ │ │ │ │ +0000f700: 6720 6b65 726e 656c 2c20 7768 696c 6520 g kernel, while │ │ │ │ │ +0000f710: 6176 6f69 6469 6e67 2061 2066 616c 7365 avoiding a false │ │ │ │ │ +0000f720: 2070 6f73 6974 6976 6520 6361 7573 696e positive causin │ │ │ │ │ +0000f730: 6720 7468 6520 626f 6f74 2074 6f0a 2020 g the boot to. │ │ │ │ │ +0000f740: 2020 2062 6c6f 636b 2069 6e64 6566 696e block indefin │ │ │ │ │ +0000f750: 6974 656c 7920 6f6e 2068 6561 646c 6573 itely on headles │ │ │ │ │ +0000f760: 7320 616e 6420 6170 706c 6961 6e63 6520 s and appliance │ │ │ │ │ +0000f770: 7379 7374 656d 7320 7768 6572 6520 6163 systems where ac │ │ │ │ │ +0000f780: 6365 7373 0a20 2020 2020 746f 2061 2063 cess. to a c │ │ │ │ │ +0000f790: 6f6e 736f 6c65 2069 7320 7265 7374 7269 onsole is restri │ │ │ │ │ +0000f7a0: 6374 6564 206f 7220 6c69 6d69 7465 642e cted or limited. │ │ │ │ │ +0000f7b0: 0a0a 2020 2020 2054 6869 7320 6f70 7469 .. This opti │ │ │ │ │ +0000f7c0: 6f6e 2069 7320 6f6e 6c79 2065 6666 6563 on is only effec │ │ │ │ │ +0000f7d0: 7469 7665 2077 6865 6e20 4752 5542 2077 tive when GRUB w │ │ │ │ │ +0000f7e0: 6173 2063 6f6e 6669 6775 7265 6420 7769 as configured wi │ │ │ │ │ +0000f7f0: 7468 2074 6865 0a20 2020 2020 272d 2d65 th the. '--e │ │ │ │ │ +0000f800: 6e61 626c 652d 7175 6963 6b2d 626f 6f74 nable-quick-boot │ │ │ │ │ +0000f810: 2720 6f70 7469 6f6e 2e0a 0a27 4752 5542 ' option...'GRUB │ │ │ │ │ +0000f820: 5f52 4543 4f56 4552 595f 5449 544c 4527 _RECOVERY_TITLE' │ │ │ │ │ +0000f830: 0a20 2020 2020 5468 6973 206f 7074 696f . This optio │ │ │ │ │ +0000f840: 6e20 7365 7473 2074 6865 2045 6e67 6c69 n sets the Engli │ │ │ │ │ +0000f850: 7368 2074 6578 7420 6f66 2074 6865 2073 sh text of the s │ │ │ │ │ +0000f860: 7472 696e 6720 7468 6174 2077 696c 6c20 tring that will │ │ │ │ │ +0000f870: 6265 0a20 2020 2020 6469 7370 6c61 7965 be. displaye │ │ │ │ │ +0000f880: 6420 696e 2070 6172 656e 7468 6573 6573 d in parentheses │ │ │ │ │ +0000f890: 2074 6f20 696e 6469 6361 7465 2074 6861 to indicate tha │ │ │ │ │ +0000f8a0: 7420 6120 626f 6f74 206f 7074 696f 6e20 t a boot option │ │ │ │ │ +0000f8b0: 6973 2070 726f 7669 6465 640a 2020 2020 is provided. │ │ │ │ │ +0000f8c0: 2074 6f20 6865 6c70 2075 7365 7273 2072 to help users r │ │ │ │ │ +0000f8d0: 6563 6f76 6572 2061 2062 726f 6b65 6e20 ecover a broken │ │ │ │ │ +0000f8e0: 7379 7374 656d 2e20 2054 6865 2064 6566 system. The def │ │ │ │ │ +0000f8f0: 6175 6c74 2069 7320 2272 6563 6f76 6572 ault is "recover │ │ │ │ │ +0000f900: 790a 2020 2020 206d 6f64 6522 2e0a 0a20 y. mode"... │ │ │ │ │ +0000f910: 2020 5468 6520 666f 6c6c 6f77 696e 6720 The following │ │ │ │ │ +0000f920: 6f70 7469 6f6e 7320 6172 6520 7374 696c options are stil │ │ │ │ │ +0000f930: 6c20 6163 6365 7074 6564 2066 6f72 2063 l accepted for c │ │ │ │ │ +0000f940: 6f6d 7061 7469 6269 6c69 7479 2077 6974 ompatibility wit │ │ │ │ │ +0000f950: 680a 6578 6973 7469 6e67 2063 6f6e 6669 h.existing confi │ │ │ │ │ +0000f960: 6775 7261 7469 6f6e 732c 2062 7574 2068 gurations, but h │ │ │ │ │ +0000f970: 6176 6520 6265 7474 6572 2072 6570 6c61 ave better repla │ │ │ │ │ +0000f980: 6365 6d65 6e74 733a 0a0a 2747 5255 425f cements:..'GRUB_ │ │ │ │ │ +0000f990: 4849 4444 454e 5f54 494d 454f 5554 270a HIDDEN_TIMEOUT'. │ │ │ │ │ +0000f9a0: 2020 2020 2057 6169 7420 7468 6973 206d Wait this m │ │ │ │ │ +0000f9b0: 616e 7920 7365 636f 6e64 7320 6265 666f any seconds befo │ │ │ │ │ +0000f9c0: 7265 2064 6973 706c 6179 696e 6720 7468 re displaying th │ │ │ │ │ +0000f9d0: 6520 6d65 6e75 2e20 2049 6620 3c45 5343 e menu. If or. a │ │ │ │ │ +0000f9f0: 7265 2070 7265 7373 6564 2c20 6f72 203c re pressed, or < │ │ │ │ │ +0000fa00: 5348 4946 543e 2069 7320 6865 6c64 2064 SHIFT> is held d │ │ │ │ │ +0000fa10: 6f77 6e20 6475 7269 6e67 2074 6861 7420 own during that │ │ │ │ │ +0000fa20: 7469 6d65 2c20 6469 7370 6c61 790a 2020 time, display. │ │ │ │ │ +0000fa30: 2020 2074 6865 206d 656e 7520 616e 6420 the menu and │ │ │ │ │ +0000fa40: 7761 6974 2066 6f72 2069 6e70 7574 2061 wait for input a │ │ │ │ │ +0000fa50: 6363 6f72 6469 6e67 2074 6f20 2747 5255 ccording to 'GRU │ │ │ │ │ +0000fa60: 425f 5449 4d45 4f55 5427 2e20 2049 6620 B_TIMEOUT'. If │ │ │ │ │ +0000fa70: 610a 2020 2020 2068 6f74 6b65 7920 6173 a. hotkey as │ │ │ │ │ +0000fa80: 736f 6369 6174 6564 2077 6974 6820 6120 sociated with a │ │ │ │ │ +0000fa90: 6d65 6e75 2065 6e74 7279 2069 7320 7072 menu entry is pr │ │ │ │ │ +0000faa0: 6573 7365 642c 2062 6f6f 7420 7468 6520 essed, boot the │ │ │ │ │ +0000fab0: 6173 736f 6369 6174 6564 0a20 2020 2020 associated. │ │ │ │ │ +0000fac0: 6d65 6e75 2065 6e74 7279 2069 6d6d 6564 menu entry immed │ │ │ │ │ +0000fad0: 6961 7465 6c79 2e20 2049 6620 7468 6520 iately. If the │ │ │ │ │ +0000fae0: 7469 6d65 6f75 7420 6578 7069 7265 7320 timeout expires │ │ │ │ │ +0000faf0: 6265 666f 7265 2065 6974 6865 7220 6f66 before either of │ │ │ │ │ +0000fb00: 0a20 2020 2020 7468 6573 6520 6861 7070 . these happ │ │ │ │ │ +0000fb10: 656e 732c 2064 6973 706c 6179 2074 6865 ens, display the │ │ │ │ │ +0000fb20: 206d 656e 7520 666f 7220 7468 6520 6e75 menu for the nu │ │ │ │ │ +0000fb30: 6d62 6572 206f 6620 7365 636f 6e64 7320 mber of seconds │ │ │ │ │ +0000fb40: 7370 6563 6966 6965 640a 2020 2020 2069 specified. i │ │ │ │ │ +0000fb50: 6e20 2747 5255 425f 5449 4d45 4f55 5427 n 'GRUB_TIMEOUT' │ │ │ │ │ +0000fb60: 2062 6566 6f72 6520 626f 6f74 696e 6720 before booting │ │ │ │ │ +0000fb70: 7468 6520 6465 6661 756c 7420 656e 7472 the default entr │ │ │ │ │ +0000fb80: 792e 0a0a 2020 2020 2049 6620 796f 7520 y... If you │ │ │ │ │ +0000fb90: 7365 7420 2747 5255 425f 4849 4444 454e set 'GRUB_HIDDEN │ │ │ │ │ +0000fba0: 5f54 494d 454f 5554 272c 2079 6f75 2073 _TIMEOUT', you s │ │ │ │ │ +0000fbb0: 686f 756c 6420 616c 736f 2073 6574 0a20 hould also set. │ │ │ │ │ +0000fbc0: 2020 2020 2747 5255 425f 5449 4d45 4f55 'GRUB_TIMEOU │ │ │ │ │ +0000fbd0: 543d 3027 2073 6f20 7468 6174 2074 6865 T=0' so that the │ │ │ │ │ +0000fbe0: 206d 656e 7520 6973 206e 6f74 2064 6973 menu is not dis │ │ │ │ │ +0000fbf0: 706c 6179 6564 2061 7420 616c 6c20 756e played at all un │ │ │ │ │ +0000fc00: 6c65 7373 0a20 2020 2020 3c45 5343 3e20 less. │ │ │ │ │ +0000fc10: 6f72 203c 4634 3e20 6172 6520 7072 6573 or are pres │ │ │ │ │ +0000fc20: 7365 642c 206f 7220 3c53 4849 4654 3e20 sed, or │ │ │ │ │ +0000fc30: 6973 2068 656c 6420 646f 776e 2e0a 0a20 is held down... │ │ │ │ │ +0000fc40: 2020 2020 5468 6973 206f 7074 696f 6e20 This option │ │ │ │ │ +0000fc50: 6973 2075 6e73 6574 2062 7920 6465 6661 is unset by defa │ │ │ │ │ +0000fc60: 756c 742c 2061 6e64 2069 7320 6465 7072 ult, and is depr │ │ │ │ │ +0000fc70: 6563 6174 6564 2069 6e20 6661 766f 7572 ecated in favour │ │ │ │ │ +0000fc80: 206f 6620 7468 650a 2020 2020 206c 6573 of the. les │ │ │ │ │ +0000fc90: 7320 636f 6e66 7573 696e 6720 2747 5255 s confusing 'GRU │ │ │ │ │ +0000fca0: 425f 5449 4d45 4f55 545f 5354 594c 453d B_TIMEOUT_STYLE= │ │ │ │ │ +0000fcb0: 636f 756e 7464 6f77 6e27 206f 720a 2020 countdown' or. │ │ │ │ │ +0000fcc0: 2020 2027 4752 5542 5f54 494d 454f 5554 'GRUB_TIMEOUT │ │ │ │ │ +0000fcd0: 5f53 5459 4c45 3d68 6964 6465 6e27 2e0a _STYLE=hidden'.. │ │ │ │ │ +0000fce0: 0a27 4752 5542 5f48 4944 4445 4e5f 5449 .'GRUB_HIDDEN_TI │ │ │ │ │ +0000fcf0: 4d45 4f55 545f 5155 4945 5427 0a20 2020 MEOUT_QUIET'. │ │ │ │ │ +0000fd00: 2020 496e 2063 6f6e 6a75 6e63 7469 6f6e In conjunction │ │ │ │ │ +0000fd10: 2077 6974 6820 2747 5255 425f 4849 4444 with 'GRUB_HIDD │ │ │ │ │ +0000fd20: 454e 5f54 494d 454f 5554 272c 2073 6574 EN_TIMEOUT', set │ │ │ │ │ +0000fd30: 2074 6869 7320 746f 2027 7472 7565 2720 this to 'true' │ │ │ │ │ +0000fd40: 746f 0a20 2020 2020 7375 7070 7265 7373 to. suppress │ │ │ │ │ +0000fd50: 2074 6865 2076 6572 626f 7365 2063 6f75 the verbose cou │ │ │ │ │ +0000fd60: 6e74 646f 776e 2077 6869 6c65 2077 6169 ntdown while wai │ │ │ │ │ +0000fd70: 7469 6e67 2066 6f72 2061 206b 6579 2074 ting for a key t │ │ │ │ │ +0000fd80: 6f20 6265 0a20 2020 2020 7072 6573 7365 o be. presse │ │ │ │ │ +0000fd90: 6420 6265 666f 7265 2064 6973 706c 6179 d before display │ │ │ │ │ +0000fda0: 696e 6720 7468 6520 6d65 6e75 2e0a 0a20 ing the menu... │ │ │ │ │ +0000fdb0: 2020 2020 5468 6973 206f 7074 696f 6e20 This option │ │ │ │ │ +0000fdc0: 6973 2075 6e73 6574 2062 7920 6465 6661 is unset by defa │ │ │ │ │ +0000fdd0: 756c 742c 2061 6e64 2069 7320 6465 7072 ult, and is depr │ │ │ │ │ +0000fde0: 6563 6174 6564 2069 6e20 6661 766f 7572 ecated in favour │ │ │ │ │ +0000fdf0: 206f 6620 7468 650a 2020 2020 206c 6573 of the. les │ │ │ │ │ +0000fe00: 7320 636f 6e66 7573 696e 6720 2747 5255 s confusing 'GRU │ │ │ │ │ +0000fe10: 425f 5449 4d45 4f55 545f 5354 594c 453d B_TIMEOUT_STYLE= │ │ │ │ │ +0000fe20: 636f 756e 7464 6f77 6e27 2e0a 0a27 4752 countdown'...'GR │ │ │ │ │ +0000fe30: 5542 5f48 4944 4445 4e5f 5449 4d45 4f55 UB_HIDDEN_TIMEOU │ │ │ │ │ +0000fe40: 545f 4255 5454 4f4e 270a 2020 2020 2056 T_BUTTON'. V │ │ │ │ │ +0000fe50: 6172 6961 6e74 206f 6620 2747 5255 425f ariant of 'GRUB_ │ │ │ │ │ +0000fe60: 4849 4444 454e 5f54 494d 454f 5554 272c HIDDEN_TIMEOUT', │ │ │ │ │ +0000fe70: 2075 7365 6420 746f 2073 7570 706f 7274 used to support │ │ │ │ │ +0000fe80: 2076 656e 646f 722d 7370 6563 6966 6963 vendor-specific │ │ │ │ │ +0000fe90: 0a20 2020 2020 706f 7765 7220 6275 7474 . power butt │ │ │ │ │ +0000fea0: 6f6e 732e 2020 2a4e 6f74 6520 5665 6e64 ons. *Note Vend │ │ │ │ │ +0000feb0: 6f72 2070 6f77 6572 2d6f 6e20 6b65 7973 or power-on keys │ │ │ │ │ +0000fec0: 3a3a 2e0a 0a20 2020 2020 5468 6973 206f ::... This o │ │ │ │ │ +0000fed0: 7074 696f 6e20 6973 2075 6e73 6574 2062 ption is unset b │ │ │ │ │ +0000fee0: 7920 6465 6661 756c 742c 2061 6e64 2069 y default, and i │ │ │ │ │ +0000fef0: 7320 6465 7072 6563 6174 6564 2069 6e20 s deprecated in │ │ │ │ │ +0000ff00: 6661 766f 7572 206f 6620 7468 650a 2020 favour of the. │ │ │ │ │ +0000ff10: 2020 206c 6573 7320 636f 6e66 7573 696e less confusin │ │ │ │ │ +0000ff20: 6720 2747 5255 425f 5449 4d45 4f55 545f g 'GRUB_TIMEOUT_ │ │ │ │ │ +0000ff30: 5354 594c 453d 636f 756e 7464 6f77 6e27 STYLE=countdown' │ │ │ │ │ +0000ff40: 206f 720a 2020 2020 2027 4752 5542 5f54 or. 'GRUB_T │ │ │ │ │ +0000ff50: 494d 454f 5554 5f53 5459 4c45 3d68 6964 IMEOUT_STYLE=hid │ │ │ │ │ +0000ff60: 6465 6e27 2e0a 0a20 2020 466f 7220 6d6f den'... For mo │ │ │ │ │ +0000ff70: 7265 2064 6574 6169 6c65 6420 6375 7374 re detailed cust │ │ │ │ │ +0000ff80: 6f6d 6973 6174 696f 6e20 6f66 2027 6772 omisation of 'gr │ │ │ │ │ +0000ff90: 7562 2d6d 6b63 6f6e 6669 6727 2773 206f ub-mkconfig''s o │ │ │ │ │ +0000ffa0: 7574 7075 742c 2079 6f75 206d 6179 0a65 utput, you may.e │ │ │ │ │ +0000ffb0: 6469 7420 7468 6520 7363 7269 7074 7320 dit the scripts │ │ │ │ │ +0000ffc0: 696e 2027 2f65 7463 2f67 7275 622e 6427 in '/etc/grub.d' │ │ │ │ │ +0000ffd0: 2064 6972 6563 746c 792e 2020 272f 6574 directly. '/et │ │ │ │ │ +0000ffe0: 632f 6772 7562 2e64 2f34 305f 6375 7374 c/grub.d/40_cust │ │ │ │ │ +0000fff0: 6f6d 2720 6973 0a70 6172 7469 6375 6c61 om' is.particula │ │ │ │ │ +00010000: 726c 7920 7573 6566 756c 2066 6f72 2061 rly useful for a │ │ │ │ │ +00010010: 6464 696e 6720 656e 7469 7265 2063 7573 dding entire cus │ │ │ │ │ +00010020: 746f 6d20 6d65 6e75 2065 6e74 7269 6573 tom menu entries │ │ │ │ │ +00010030: 3b20 7369 6d70 6c79 2074 7970 650a 7468 ; simply type.th │ │ │ │ │ +00010040: 6520 6d65 6e75 2065 6e74 7269 6573 2079 e menu entries y │ │ │ │ │ +00010050: 6f75 2077 616e 7420 746f 2061 6464 2061 ou want to add a │ │ │ │ │ +00010060: 7420 7468 6520 656e 6420 6f66 2074 6861 t the end of tha │ │ │ │ │ +00010070: 7420 6669 6c65 2c20 6d61 6b69 6e67 2073 t file, making s │ │ │ │ │ +00010080: 7572 6520 746f 0a6c 6561 7665 2061 7420 ure to.leave at │ │ │ │ │ +00010090: 6c65 6173 7420 7468 6520 6669 7273 7420 least the first │ │ │ │ │ +000100a0: 7477 6f20 6c69 6e65 7320 696e 7461 6374 two lines intact │ │ │ │ │ +000100b0: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ +000100c0: 696e 666f 2c20 204e 6f64 653a 2052 6f6f info, Node: Roo │ │ │ │ │ +000100d0: 7420 4964 656e 7469 6663 6174 696f 6e20 t Identifcation │ │ │ │ │ +000100e0: 4865 7572 6973 7469 6373 2c20 204e 6578 Heuristics, Nex │ │ │ │ │ +000100f0: 743a 2053 6865 6c6c 2d6c 696b 6520 7363 t: Shell-like sc │ │ │ │ │ +00010100: 7269 7074 696e 672c 2020 5072 6576 3a20 ripting, Prev: │ │ │ │ │ +00010110: 5369 6d70 6c65 2063 6f6e 6669 6775 7261 Simple configura │ │ │ │ │ +00010120: 7469 6f6e 2c20 2055 703a 2043 6f6e 6669 tion, Up: Confi │ │ │ │ │ +00010130: 6775 7261 7469 6f6e 0a0a 362e 3220 526f guration..6.2 Ro │ │ │ │ │ +00010140: 6f74 2049 6465 6e74 6966 6361 7469 6f6e ot Identifcation │ │ │ │ │ +00010150: 2048 6575 7269 7374 6963 730a 3d3d 3d3d Heuristics.==== │ │ │ │ │ 00010160: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00010170: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a ===============. │ │ │ │ │ -00010180: 0a49 6620 7468 6520 7461 7267 6574 206f .If the target o │ │ │ │ │ -00010190: 7065 7261 7469 6e67 2073 7973 7465 6d20 perating system │ │ │ │ │ -000101a0: 7573 6573 2074 6865 204c 696e 7578 206b uses the Linux k │ │ │ │ │ -000101b0: 6572 6e65 6c2c 2027 6772 7562 2d6d 6b63 ernel, 'grub-mkc │ │ │ │ │ -000101c0: 6f6e 6669 6727 0a61 7474 656d 7074 7320 onfig'.attempts │ │ │ │ │ -000101d0: 746f 2069 6465 6e74 6966 7920 7468 6520 to identify the │ │ │ │ │ -000101e0: 726f 6f74 2066 696c 6520 7379 7374 656d root file system │ │ │ │ │ -000101f0: 2076 6961 2061 2068 6575 7269 7374 6963 via a heuristic │ │ │ │ │ -00010200: 2061 6c67 6f69 7274 686d 2e0a 5468 6973 algoirthm..This │ │ │ │ │ -00010210: 2061 6c67 6f72 6974 686d 2073 656c 6563 algorithm selec │ │ │ │ │ -00010220: 7473 2074 6865 2069 6465 6e74 6966 6963 ts the identific │ │ │ │ │ -00010230: 6174 696f 6e20 6d65 7468 6f64 206f 6620 ation method of │ │ │ │ │ -00010240: 7468 6520 726f 6f74 2066 696c 6520 7379 the root file sy │ │ │ │ │ -00010250: 7374 656d 0a62 7920 636f 6e73 6964 6572 stem.by consider │ │ │ │ │ -00010260: 696e 6720 7468 7265 6520 6661 6374 6f72 ing three factor │ │ │ │ │ -00010270: 732e 2020 5468 6520 6669 7273 7420 6973 s. The first is │ │ │ │ │ -00010280: 2069 6620 616e 2069 6e69 7472 6420 666f if an initrd fo │ │ │ │ │ -00010290: 7220 7468 6520 7461 7267 6574 0a6f 7065 r the target.ope │ │ │ │ │ -000102a0: 7261 7469 6e67 2073 7973 7465 6d20 6973 rating system is │ │ │ │ │ -000102b0: 2061 6c73 6f20 7072 6573 656e 742e 2020 also present. │ │ │ │ │ -000102c0: 5468 6520 7365 636f 6e64 2069 730a 2747 The second is.'G │ │ │ │ │ -000102d0: 5255 425f 4449 5341 424c 455f 4c49 4e55 RUB_DISABLE_LINU │ │ │ │ │ -000102e0: 585f 5555 4944 2720 616e 6420 6966 2073 X_UUID' and if s │ │ │ │ │ -000102f0: 6574 2074 6f20 2774 7275 6527 2c20 7072 et to 'true', pr │ │ │ │ │ -00010300: 6576 656e 7473 2027 6772 7562 2d6d 6b63 events 'grub-mkc │ │ │ │ │ -00010310: 6f6e 6669 6727 0a66 726f 6d20 6964 656e onfig'.from iden │ │ │ │ │ -00010320: 7469 6679 696e 6720 7468 6520 726f 6f74 tifying the root │ │ │ │ │ -00010330: 2066 696c 6520 7379 7374 656d 2062 7920 file system by │ │ │ │ │ -00010340: 6974 7320 5555 4944 2e20 5468 6520 7468 its UUID. The th │ │ │ │ │ -00010350: 6972 6420 6973 0a27 4752 5542 5f44 4953 ird is.'GRUB_DIS │ │ │ │ │ -00010360: 4142 4c45 5f4c 494e 5558 5f50 4152 5455 ABLE_LINUX_PARTU │ │ │ │ │ -00010370: 5549 4427 2061 6e64 2069 6620 7365 7420 UID' and if set │ │ │ │ │ -00010380: 746f 2027 7472 7565 272c 2070 7265 7665 to 'true', preve │ │ │ │ │ -00010390: 6e74 730a 2767 7275 622d 6d6b 636f 6e66 nts.'grub-mkconf │ │ │ │ │ -000103a0: 6967 2720 6672 6f6d 2069 6465 6e74 6966 ig' from identif │ │ │ │ │ -000103b0: 7969 6e67 2074 6865 2072 6f6f 7420 6669 ying the root fi │ │ │ │ │ -000103c0: 6c65 2073 7973 7465 6d20 7669 6120 7468 le system via th │ │ │ │ │ -000103d0: 6520 5555 4944 206f 660a 6974 7320 656e e UUID of.its en │ │ │ │ │ -000103e0: 636c 6f73 696e 6720 7061 7274 6974 696f closing partitio │ │ │ │ │ -000103f0: 6e2e 2020 4966 2074 6865 2076 6172 6961 n. If the varia │ │ │ │ │ -00010400: 626c 6573 2061 7265 2061 7373 6967 6e65 bles are assigne │ │ │ │ │ -00010410: 6420 616e 7920 6f74 6865 7220 7661 6c75 d any other valu │ │ │ │ │ -00010420: 652c 0a74 6861 7420 7661 6c75 6520 6973 e,.that value is │ │ │ │ │ -00010430: 2063 6f6e 7369 6465 7265 6420 6571 7569 considered equi │ │ │ │ │ -00010440: 7661 6c65 6e74 2074 6f20 2766 616c 7365 valent to 'false │ │ │ │ │ -00010450: 272e 2020 5468 6520 7661 7269 6162 6c65 '. The variable │ │ │ │ │ -00010460: 7320 6172 6520 616c 736f 0a63 6f6e 7369 s are also.consi │ │ │ │ │ -00010470: 6465 7265 6420 746f 2062 6520 7365 7420 dered to be set │ │ │ │ │ -00010480: 746f 2027 6661 6c73 6527 2069 6620 7468 to 'false' if th │ │ │ │ │ -00010490: 6579 2061 7265 206e 6f74 2073 6574 2e0a ey are not set.. │ │ │ │ │ -000104a0: 0a20 2020 5768 656e 2062 6f6f 7469 6e67 . When booting │ │ │ │ │ -000104b0: 2c20 7468 6520 4c69 6e75 7820 6b65 726e , the Linux kern │ │ │ │ │ -000104c0: 656c 2077 696c 6c20 6465 6c65 6761 7465 el will delegate │ │ │ │ │ -000104d0: 2074 6865 2074 6173 6b20 6f66 206d 6f75 the task of mou │ │ │ │ │ -000104e0: 6e74 696e 6720 7468 650a 726f 6f74 2066 nting the.root f │ │ │ │ │ -000104f0: 696c 6573 7973 7465 6d20 746f 2074 6865 ilesystem to the │ │ │ │ │ -00010500: 2069 6e69 7472 642e 2020 4d6f 7374 2069 initrd. Most i │ │ │ │ │ -00010510: 6e69 7472 6420 696d 6167 6573 2064 6574 nitrd images det │ │ │ │ │ -00010520: 6572 6d69 6e65 2074 6865 2072 6f6f 740a ermine the root. │ │ │ │ │ -00010530: 6669 6c65 2073 7973 7465 6d20 6279 2063 file system by c │ │ │ │ │ -00010540: 6865 636b 696e 6720 7468 6520 4c69 6e75 hecking the Linu │ │ │ │ │ -00010550: 7820 6b65 726e 656c 2773 2063 6f6d 6d61 x kernel's comma │ │ │ │ │ -00010560: 6e64 2d6c 696e 6520 666f 7220 7468 6520 nd-line for the │ │ │ │ │ -00010570: 2772 6f6f 7427 0a6b 6579 2061 6e64 2075 'root'.key and u │ │ │ │ │ -00010580: 7365 2069 7473 2076 616c 7565 2061 7320 se its value as │ │ │ │ │ -00010590: 7468 6520 6964 656e 7469 6669 6361 7469 the identificati │ │ │ │ │ -000105a0: 6f6e 206d 6574 686f 6420 6f66 2074 6865 on method of the │ │ │ │ │ -000105b0: 2072 6f6f 7420 6669 6c65 0a73 7973 7465 root file.syste │ │ │ │ │ -000105c0: 6d2e 2020 546f 2069 6d70 726f 7665 2074 m. To improve t │ │ │ │ │ -000105d0: 6865 2072 656c 6961 6269 6c69 7479 206f he reliability o │ │ │ │ │ -000105e0: 6620 626f 6f74 696e 672c 206d 6f73 7420 f booting, most │ │ │ │ │ -000105f0: 696e 6974 7264 2069 6d61 6765 7320 616c initrd images al │ │ │ │ │ -00010600: 736f 0a61 6c6c 6f77 2074 6865 2072 6f6f so.allow the roo │ │ │ │ │ -00010610: 7420 6669 6c65 2073 7973 7465 6d20 746f t file system to │ │ │ │ │ -00010620: 2062 6520 6964 656e 7469 6669 6564 2062 be identified b │ │ │ │ │ -00010630: 7920 6974 7320 5555 4944 2e20 4265 6361 y its UUID. Beca │ │ │ │ │ -00010640: 7573 6520 6f66 2074 6869 730a 6265 6861 use of this.beha │ │ │ │ │ -00010650: 7669 6f72 2c20 7468 6520 2767 7275 622d vior, the 'grub- │ │ │ │ │ -00010660: 6d6b 636f 6e66 6967 2720 636f 6d6d 616e mkconfig' comman │ │ │ │ │ -00010670: 6420 7769 6c6c 2073 6574 2027 726f 6f74 d will set 'root │ │ │ │ │ -00010680: 2720 746f 2027 726f 6f74 3d55 5549 443d ' to 'root=UUID= │ │ │ │ │ -00010690: 2e2e 2e27 0a74 6f20 7072 6f76 6964 6520 ...'.to provide │ │ │ │ │ -000106a0: 7468 6520 696e 6974 7264 2077 6974 6820 the initrd with │ │ │ │ │ -000106b0: 7468 6520 6669 6c65 7379 7374 656d 2055 the filesystem U │ │ │ │ │ -000106c0: 5549 4420 6f66 2074 6865 2072 6f6f 7420 UID of the root │ │ │ │ │ -000106d0: 6669 6c65 2073 7973 7465 6d2e 0a0a 2020 file system... │ │ │ │ │ -000106e0: 2049 6620 6e6f 2069 6e69 7472 6420 6973 If no initrd is │ │ │ │ │ -000106f0: 2064 6574 6563 7465 6420 6f72 2027 4752 detected or 'GR │ │ │ │ │ -00010700: 5542 5f44 4953 4142 4c45 5f4c 494e 5558 UB_DISABLE_LINUX │ │ │ │ │ -00010710: 5f55 5549 4427 2069 7320 7365 7420 746f _UUID' is set to │ │ │ │ │ -00010720: 0a27 7472 7565 2720 7468 656e 2027 6772 .'true' then 'gr │ │ │ │ │ -00010730: 7562 2d63 6f6d 6d61 6e64 2720 7769 6c6c ub-command' will │ │ │ │ │ -00010740: 2069 6465 6e74 6966 7920 7468 6520 726f identify the ro │ │ │ │ │ -00010750: 6f74 2066 696c 6573 7973 7465 6d20 6279 ot filesystem by │ │ │ │ │ -00010760: 2073 6574 7469 6e67 0a74 6865 206b 6572 setting.the ker │ │ │ │ │ -00010770: 6e65 6c20 636f 6d6d 616e 642d 6c69 6e65 nel command-line │ │ │ │ │ -00010780: 2076 6172 6961 626c 6520 2772 6f6f 7427 variable 'root' │ │ │ │ │ -00010790: 2074 6f20 2772 6f6f 743d 5041 5254 5555 to 'root=PARTUU │ │ │ │ │ -000107a0: 4944 3d2e 2e2e 2720 756e 6c65 7373 0a27 ID=...' unless.' │ │ │ │ │ -000107b0: 4752 5542 5f44 4953 4142 4c45 5f4c 494e GRUB_DISABLE_LIN │ │ │ │ │ -000107c0: 5558 5f50 4152 5455 5549 4427 2069 7320 UX_PARTUUID' is │ │ │ │ │ -000107d0: 616c 736f 2073 6574 2074 6f20 2774 7275 also set to 'tru │ │ │ │ │ -000107e0: 6527 2e20 2049 660a 2747 5255 425f 4449 e'. If.'GRUB_DI │ │ │ │ │ -000107f0: 5341 424c 455f 4c49 4e55 585f 5041 5254 SABLE_LINUX_PART │ │ │ │ │ -00010800: 5555 4944 2720 6973 2061 6c73 6f20 7365 UUID' is also se │ │ │ │ │ -00010810: 7420 746f 2027 7472 7565 272c 2027 6772 t to 'true', 'gr │ │ │ │ │ -00010820: 7562 2d63 6f6d 6d61 6e64 2720 7769 6c6c ub-command' will │ │ │ │ │ -00010830: 0a69 6465 6e74 6966 7920 6279 2069 7473 .identify by its │ │ │ │ │ -00010840: 204c 696e 7578 2064 6576 6963 6520 6e61 Linux device na │ │ │ │ │ -00010850: 6d65 2e0a 0a20 2020 5468 6520 666f 6c6c me... The foll │ │ │ │ │ -00010860: 6f77 696e 6720 7461 626c 6520 7375 6d6d owing table summ │ │ │ │ │ -00010870: 6172 697a 6573 2074 6865 2062 6568 6176 arizes the behav │ │ │ │ │ -00010880: 696f 7220 6f66 2074 6865 2027 6772 7562 ior of the 'grub │ │ │ │ │ -00010890: 2d6d 6b63 6f6e 6669 6727 0a63 6f6d 6d61 -mkconfig'.comma │ │ │ │ │ -000108a0: 6e64 2e0a 0a49 6e69 7472 6420 2020 2020 nd...Initrd │ │ │ │ │ -000108b0: 4752 5542 5f44 4953 4142 4c45 5f4c 494e GRUB_DISABLE_LIN │ │ │ │ │ -000108c0: 5558 5f50 4152 5455 5549 4420 2020 4752 UX_PARTUUID GR │ │ │ │ │ -000108d0: 5542 5f44 4953 4142 4c45 5f4c 494e 5558 UB_DISABLE_LINUX │ │ │ │ │ -000108e0: 5f55 5549 4420 2020 4c69 6e75 7820 526f _UUID Linux Ro │ │ │ │ │ -000108f0: 6f74 0a64 6574 6563 7465 6420 2020 5365 ot.detected Se │ │ │ │ │ -00010900: 7420 546f 2020 2020 2020 2020 2020 2020 t To │ │ │ │ │ -00010910: 2020 2020 2020 2020 2020 2020 5365 7420 Set │ │ │ │ │ -00010920: 546f 2020 2020 2020 2020 2020 2020 2020 To │ │ │ │ │ -00010930: 2020 2020 2020 4944 204d 6574 686f 640a ID Method. │ │ │ │ │ +00010170: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a49 =============..I │ │ │ │ │ +00010180: 6620 7468 6520 7461 7267 6574 206f 7065 f the target ope │ │ │ │ │ +00010190: 7261 7469 6e67 2073 7973 7465 6d20 7573 rating system us │ │ │ │ │ +000101a0: 6573 2074 6865 204c 696e 7578 206b 6572 es the Linux ker │ │ │ │ │ +000101b0: 6e65 6c2c 2027 6772 7562 2d6d 6b63 6f6e nel, 'grub-mkcon │ │ │ │ │ +000101c0: 6669 6727 0a61 7474 656d 7074 7320 746f fig'.attempts to │ │ │ │ │ +000101d0: 2069 6465 6e74 6966 7920 7468 6520 726f identify the ro │ │ │ │ │ +000101e0: 6f74 2066 696c 6520 7379 7374 656d 2076 ot file system v │ │ │ │ │ +000101f0: 6961 2061 2068 6575 7269 7374 6963 2061 ia a heuristic a │ │ │ │ │ +00010200: 6c67 6f69 7274 686d 2e0a 5468 6973 2061 lgoirthm..This a │ │ │ │ │ +00010210: 6c67 6f72 6974 686d 2073 656c 6563 7473 lgorithm selects │ │ │ │ │ +00010220: 2074 6865 2069 6465 6e74 6966 6963 6174 the identificat │ │ │ │ │ +00010230: 696f 6e20 6d65 7468 6f64 206f 6620 7468 ion method of th │ │ │ │ │ +00010240: 6520 726f 6f74 2066 696c 6520 7379 7374 e root file syst │ │ │ │ │ +00010250: 656d 0a62 7920 636f 6e73 6964 6572 696e em.by considerin │ │ │ │ │ +00010260: 6720 7468 7265 6520 6661 6374 6f72 732e g three factors. │ │ │ │ │ +00010270: 2020 5468 6520 6669 7273 7420 6973 2069 The first is i │ │ │ │ │ +00010280: 6620 616e 2069 6e69 7472 6420 666f 7220 f an initrd for │ │ │ │ │ +00010290: 7468 6520 7461 7267 6574 0a6f 7065 7261 the target.opera │ │ │ │ │ +000102a0: 7469 6e67 2073 7973 7465 6d20 6973 2061 ting system is a │ │ │ │ │ +000102b0: 6c73 6f20 7072 6573 656e 742e 2020 5468 lso present. Th │ │ │ │ │ +000102c0: 6520 7365 636f 6e64 2069 730a 2747 5255 e second is.'GRU │ │ │ │ │ +000102d0: 425f 4449 5341 424c 455f 4c49 4e55 585f B_DISABLE_LINUX_ │ │ │ │ │ +000102e0: 5555 4944 2720 616e 6420 6966 2073 6574 UUID' and if set │ │ │ │ │ +000102f0: 2074 6f20 2774 7275 6527 2c20 7072 6576 to 'true', prev │ │ │ │ │ +00010300: 656e 7473 2027 6772 7562 2d6d 6b63 6f6e ents 'grub-mkcon │ │ │ │ │ +00010310: 6669 6727 0a66 726f 6d20 6964 656e 7469 fig'.from identi │ │ │ │ │ +00010320: 6679 696e 6720 7468 6520 726f 6f74 2066 fying the root f │ │ │ │ │ +00010330: 696c 6520 7379 7374 656d 2062 7920 6974 ile system by it │ │ │ │ │ +00010340: 7320 5555 4944 2e20 5468 6520 7468 6972 s UUID. The thir │ │ │ │ │ +00010350: 6420 6973 0a27 4752 5542 5f44 4953 4142 d is.'GRUB_DISAB │ │ │ │ │ +00010360: 4c45 5f4c 494e 5558 5f50 4152 5455 5549 LE_LINUX_PARTUUI │ │ │ │ │ +00010370: 4427 2061 6e64 2069 6620 7365 7420 746f D' and if set to │ │ │ │ │ +00010380: 2027 7472 7565 272c 2070 7265 7665 6e74 'true', prevent │ │ │ │ │ +00010390: 730a 2767 7275 622d 6d6b 636f 6e66 6967 s.'grub-mkconfig │ │ │ │ │ +000103a0: 2720 6672 6f6d 2069 6465 6e74 6966 7969 ' from identifyi │ │ │ │ │ +000103b0: 6e67 2074 6865 2072 6f6f 7420 6669 6c65 ng the root file │ │ │ │ │ +000103c0: 2073 7973 7465 6d20 7669 6120 7468 6520 system via the │ │ │ │ │ +000103d0: 5555 4944 206f 660a 6974 7320 656e 636c UUID of.its encl │ │ │ │ │ +000103e0: 6f73 696e 6720 7061 7274 6974 696f 6e2e osing partition. │ │ │ │ │ +000103f0: 2020 4966 2074 6865 2076 6172 6961 626c If the variabl │ │ │ │ │ +00010400: 6573 2061 7265 2061 7373 6967 6e65 6420 es are assigned │ │ │ │ │ +00010410: 616e 7920 6f74 6865 7220 7661 6c75 652c any other value, │ │ │ │ │ +00010420: 0a74 6861 7420 7661 6c75 6520 6973 2063 .that value is c │ │ │ │ │ +00010430: 6f6e 7369 6465 7265 6420 6571 7569 7661 onsidered equiva │ │ │ │ │ +00010440: 6c65 6e74 2074 6f20 2766 616c 7365 272e lent to 'false'. │ │ │ │ │ +00010450: 2020 5468 6520 7661 7269 6162 6c65 7320 The variables │ │ │ │ │ +00010460: 6172 6520 616c 736f 0a63 6f6e 7369 6465 are also.conside │ │ │ │ │ +00010470: 7265 6420 746f 2062 6520 7365 7420 746f red to be set to │ │ │ │ │ +00010480: 2027 6661 6c73 6527 2069 6620 7468 6579 'false' if they │ │ │ │ │ +00010490: 2061 7265 206e 6f74 2073 6574 2e0a 0a20 are not set... │ │ │ │ │ +000104a0: 2020 5768 656e 2062 6f6f 7469 6e67 2c20 When booting, │ │ │ │ │ +000104b0: 7468 6520 4c69 6e75 7820 6b65 726e 656c the Linux kernel │ │ │ │ │ +000104c0: 2077 696c 6c20 6465 6c65 6761 7465 2074 will delegate t │ │ │ │ │ +000104d0: 6865 2074 6173 6b20 6f66 206d 6f75 6e74 he task of mount │ │ │ │ │ +000104e0: 696e 6720 7468 650a 726f 6f74 2066 696c ing the.root fil │ │ │ │ │ +000104f0: 6573 7973 7465 6d20 746f 2074 6865 2069 esystem to the i │ │ │ │ │ +00010500: 6e69 7472 642e 2020 4d6f 7374 2069 6e69 nitrd. Most ini │ │ │ │ │ +00010510: 7472 6420 696d 6167 6573 2064 6574 6572 trd images deter │ │ │ │ │ +00010520: 6d69 6e65 2074 6865 2072 6f6f 740a 6669 mine the root.fi │ │ │ │ │ +00010530: 6c65 2073 7973 7465 6d20 6279 2063 6865 le system by che │ │ │ │ │ +00010540: 636b 696e 6720 7468 6520 4c69 6e75 7820 cking the Linux │ │ │ │ │ +00010550: 6b65 726e 656c 2773 2063 6f6d 6d61 6e64 kernel's command │ │ │ │ │ +00010560: 2d6c 696e 6520 666f 7220 7468 6520 2772 -line for the 'r │ │ │ │ │ +00010570: 6f6f 7427 0a6b 6579 2061 6e64 2075 7365 oot'.key and use │ │ │ │ │ +00010580: 2069 7473 2076 616c 7565 2061 7320 7468 its value as th │ │ │ │ │ +00010590: 6520 6964 656e 7469 6669 6361 7469 6f6e e identification │ │ │ │ │ +000105a0: 206d 6574 686f 6420 6f66 2074 6865 2072 method of the r │ │ │ │ │ +000105b0: 6f6f 7420 6669 6c65 0a73 7973 7465 6d2e oot file.system. │ │ │ │ │ +000105c0: 2020 546f 2069 6d70 726f 7665 2074 6865 To improve the │ │ │ │ │ +000105d0: 2072 656c 6961 6269 6c69 7479 206f 6620 reliability of │ │ │ │ │ +000105e0: 626f 6f74 696e 672c 206d 6f73 7420 696e booting, most in │ │ │ │ │ +000105f0: 6974 7264 2069 6d61 6765 7320 616c 736f itrd images also │ │ │ │ │ +00010600: 0a61 6c6c 6f77 2074 6865 2072 6f6f 7420 .allow the root │ │ │ │ │ +00010610: 6669 6c65 2073 7973 7465 6d20 746f 2062 file system to b │ │ │ │ │ +00010620: 6520 6964 656e 7469 6669 6564 2062 7920 e identified by │ │ │ │ │ +00010630: 6974 7320 5555 4944 2e20 4265 6361 7573 its UUID. Becaus │ │ │ │ │ +00010640: 6520 6f66 2074 6869 730a 6265 6861 7669 e of this.behavi │ │ │ │ │ +00010650: 6f72 2c20 7468 6520 2767 7275 622d 6d6b or, the 'grub-mk │ │ │ │ │ +00010660: 636f 6e66 6967 2720 636f 6d6d 616e 6420 config' command │ │ │ │ │ +00010670: 7769 6c6c 2073 6574 2027 726f 6f74 2720 will set 'root' │ │ │ │ │ +00010680: 746f 2027 726f 6f74 3d55 5549 443d 2e2e to 'root=UUID=.. │ │ │ │ │ +00010690: 2e27 0a74 6f20 7072 6f76 6964 6520 7468 .'.to provide th │ │ │ │ │ +000106a0: 6520 696e 6974 7264 2077 6974 6820 7468 e initrd with th │ │ │ │ │ +000106b0: 6520 6669 6c65 7379 7374 656d 2055 5549 e filesystem UUI │ │ │ │ │ +000106c0: 4420 6f66 2074 6865 2072 6f6f 7420 6669 D of the root fi │ │ │ │ │ +000106d0: 6c65 2073 7973 7465 6d2e 0a0a 2020 2049 le system... I │ │ │ │ │ +000106e0: 6620 6e6f 2069 6e69 7472 6420 6973 2064 f no initrd is d │ │ │ │ │ +000106f0: 6574 6563 7465 6420 6f72 2027 4752 5542 etected or 'GRUB │ │ │ │ │ +00010700: 5f44 4953 4142 4c45 5f4c 494e 5558 5f55 _DISABLE_LINUX_U │ │ │ │ │ +00010710: 5549 4427 2069 7320 7365 7420 746f 0a27 UID' is set to.' │ │ │ │ │ +00010720: 7472 7565 2720 7468 656e 2027 6772 7562 true' then 'grub │ │ │ │ │ +00010730: 2d63 6f6d 6d61 6e64 2720 7769 6c6c 2069 -command' will i │ │ │ │ │ +00010740: 6465 6e74 6966 7920 7468 6520 726f 6f74 dentify the root │ │ │ │ │ +00010750: 2066 696c 6573 7973 7465 6d20 6279 2073 filesystem by s │ │ │ │ │ +00010760: 6574 7469 6e67 0a74 6865 206b 6572 6e65 etting.the kerne │ │ │ │ │ +00010770: 6c20 636f 6d6d 616e 642d 6c69 6e65 2076 l command-line v │ │ │ │ │ +00010780: 6172 6961 626c 6520 2772 6f6f 7427 2074 ariable 'root' t │ │ │ │ │ +00010790: 6f20 2772 6f6f 743d 5041 5254 5555 4944 o 'root=PARTUUID │ │ │ │ │ +000107a0: 3d2e 2e2e 2720 756e 6c65 7373 0a27 4752 =...' unless.'GR │ │ │ │ │ +000107b0: 5542 5f44 4953 4142 4c45 5f4c 494e 5558 UB_DISABLE_LINUX │ │ │ │ │ +000107c0: 5f50 4152 5455 5549 4427 2069 7320 616c _PARTUUID' is al │ │ │ │ │ +000107d0: 736f 2073 6574 2074 6f20 2774 7275 6527 so set to 'true' │ │ │ │ │ +000107e0: 2e20 2049 660a 2747 5255 425f 4449 5341 . If.'GRUB_DISA │ │ │ │ │ +000107f0: 424c 455f 4c49 4e55 585f 5041 5254 5555 BLE_LINUX_PARTUU │ │ │ │ │ +00010800: 4944 2720 6973 2061 6c73 6f20 7365 7420 ID' is also set │ │ │ │ │ +00010810: 746f 2027 7472 7565 272c 2027 6772 7562 to 'true', 'grub │ │ │ │ │ +00010820: 2d63 6f6d 6d61 6e64 2720 7769 6c6c 0a69 -command' will.i │ │ │ │ │ +00010830: 6465 6e74 6966 7920 6279 2069 7473 204c dentify by its L │ │ │ │ │ +00010840: 696e 7578 2064 6576 6963 6520 6e61 6d65 inux device name │ │ │ │ │ +00010850: 2e0a 0a20 2020 5468 6520 666f 6c6c 6f77 ... The follow │ │ │ │ │ +00010860: 696e 6720 7461 626c 6520 7375 6d6d 6172 ing table summar │ │ │ │ │ +00010870: 697a 6573 2074 6865 2062 6568 6176 696f izes the behavio │ │ │ │ │ +00010880: 7220 6f66 2074 6865 2027 6772 7562 2d6d r of the 'grub-m │ │ │ │ │ +00010890: 6b63 6f6e 6669 6727 0a63 6f6d 6d61 6e64 kconfig'.command │ │ │ │ │ +000108a0: 2e0a 0a49 6e69 7472 6420 2020 2020 4752 ...Initrd GR │ │ │ │ │ +000108b0: 5542 5f44 4953 4142 4c45 5f4c 494e 5558 UB_DISABLE_LINUX │ │ │ │ │ +000108c0: 5f50 4152 5455 5549 4420 2020 4752 5542 _PARTUUID GRUB │ │ │ │ │ +000108d0: 5f44 4953 4142 4c45 5f4c 494e 5558 5f55 _DISABLE_LINUX_U │ │ │ │ │ +000108e0: 5549 4420 2020 4c69 6e75 7820 526f 6f74 UID Linux Root │ │ │ │ │ +000108f0: 0a64 6574 6563 7465 6420 2020 5365 7420 .detected Set │ │ │ │ │ +00010900: 546f 2020 2020 2020 2020 2020 2020 2020 To │ │ │ │ │ +00010910: 2020 2020 2020 2020 2020 5365 7420 546f Set To │ │ │ │ │ +00010920: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00010930: 2020 2020 4944 204d 6574 686f 640a 2d2d ID Method.-- │ │ │ │ │ 00010940: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 00010950: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 00010960: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 00010970: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00010980: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00010990: 0a66 616c 7365 2020 2020 2020 6661 6c73 .false fals │ │ │ │ │ -000109a0: 6520 2020 2020 2020 2020 2020 2020 2020 e │ │ │ │ │ -000109b0: 2020 2020 2020 2020 2020 6661 6c73 6520 false │ │ │ │ │ +00010980: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a66 --------------.f │ │ │ │ │ +00010990: 616c 7365 2020 2020 2020 6661 6c73 6520 alse false │ │ │ │ │ +000109a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +000109b0: 2020 2020 2020 2020 6661 6c73 6520 2020 false │ │ │ │ │ 000109c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000109d0: 2020 2020 7061 7274 2055 5549 440a 6661 part UUID.fa │ │ │ │ │ -000109e0: 6c73 6520 2020 2020 2066 616c 7365 2020 lse false │ │ │ │ │ +000109d0: 2020 7061 7274 2055 5549 440a 6661 6c73 part UUID.fals │ │ │ │ │ +000109e0: 6520 2020 2020 2066 616c 7365 2020 2020 e false │ │ │ │ │ 000109f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00010a00: 2020 2020 2020 2074 7275 6520 2020 2020 true │ │ │ │ │ -00010a10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00010a20: 2070 6172 7420 5555 4944 0a66 616c 7365 part UUID.false │ │ │ │ │ -00010a30: 2020 2020 2020 7472 7565 2020 2020 2020 true │ │ │ │ │ +00010a00: 2020 2020 2074 7275 6520 2020 2020 2020 true │ │ │ │ │ +00010a10: 2020 2020 2020 2020 2020 2020 2020 2070 p │ │ │ │ │ +00010a20: 6172 7420 5555 4944 0a66 616c 7365 2020 art UUID.false │ │ │ │ │ +00010a30: 2020 2020 7472 7565 2020 2020 2020 2020 true │ │ │ │ │ 00010a40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00010a50: 2020 2020 6661 6c73 6520 2020 2020 2020 false │ │ │ │ │ -00010a60: 2020 2020 2020 2020 2020 2020 2020 6465 de │ │ │ │ │ -00010a70: 7620 6e61 6d65 0a66 616c 7365 2020 2020 v name.false │ │ │ │ │ -00010a80: 2020 7472 7565 2020 2020 2020 2020 2020 true │ │ │ │ │ -00010a90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00010aa0: 7472 7565 2020 2020 2020 2020 2020 2020 true │ │ │ │ │ -00010ab0: 2020 2020 2020 2020 2020 6465 7620 6e61 dev na │ │ │ │ │ -00010ac0: 6d65 0a74 7275 6520 2020 2020 2020 6661 me.true fa │ │ │ │ │ -00010ad0: 6c73 6520 2020 2020 2020 2020 2020 2020 lse │ │ │ │ │ -00010ae0: 2020 2020 2020 2020 2020 2020 6661 6c73 fals │ │ │ │ │ -00010af0: 6520 2020 2020 2020 2020 2020 2020 2020 e │ │ │ │ │ -00010b00: 2020 2020 2020 6673 2055 5549 440a 7472 fs UUID.tr │ │ │ │ │ -00010b10: 7565 2020 2020 2020 2066 616c 7365 2020 ue false │ │ │ │ │ +00010a50: 2020 6661 6c73 6520 2020 2020 2020 2020 false │ │ │ │ │ +00010a60: 2020 2020 2020 2020 2020 2020 6465 7620 dev │ │ │ │ │ +00010a70: 6e61 6d65 0a66 616c 7365 2020 2020 2020 name.false │ │ │ │ │ +00010a80: 7472 7565 2020 2020 2020 2020 2020 2020 true │ │ │ │ │ +00010a90: 2020 2020 2020 2020 2020 2020 2020 7472 tr │ │ │ │ │ +00010aa0: 7565 2020 2020 2020 2020 2020 2020 2020 ue │ │ │ │ │ +00010ab0: 2020 2020 2020 2020 6465 7620 6e61 6d65 dev name │ │ │ │ │ +00010ac0: 0a74 7275 6520 2020 2020 2020 6661 6c73 .true fals │ │ │ │ │ +00010ad0: 6520 2020 2020 2020 2020 2020 2020 2020 e │ │ │ │ │ +00010ae0: 2020 2020 2020 2020 2020 6661 6c73 6520 false │ │ │ │ │ +00010af0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00010b00: 2020 2020 6673 2055 5549 440a 7472 7565 fs UUID.true │ │ │ │ │ +00010b10: 2020 2020 2020 2066 616c 7365 2020 2020 false │ │ │ │ │ 00010b20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00010b30: 2020 2020 2020 2074 7275 6520 2020 2020 true │ │ │ │ │ -00010b40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00010b50: 2070 6172 7420 5555 4944 0a74 7275 6520 part UUID.true │ │ │ │ │ -00010b60: 2020 2020 2020 7472 7565 2020 2020 2020 true │ │ │ │ │ +00010b30: 2020 2020 2074 7275 6520 2020 2020 2020 true │ │ │ │ │ +00010b40: 2020 2020 2020 2020 2020 2020 2020 2070 p │ │ │ │ │ +00010b50: 6172 7420 5555 4944 0a74 7275 6520 2020 art UUID.true │ │ │ │ │ +00010b60: 2020 2020 7472 7565 2020 2020 2020 2020 true │ │ │ │ │ 00010b70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00010b80: 2020 2020 6661 6c73 6520 2020 2020 2020 false │ │ │ │ │ -00010b90: 2020 2020 2020 2020 2020 2020 2020 6673 fs │ │ │ │ │ -00010ba0: 2055 5549 440a 7472 7565 2020 2020 2020 UUID.true │ │ │ │ │ -00010bb0: 2074 7275 6520 2020 2020 2020 2020 2020 true │ │ │ │ │ -00010bc0: 2020 2020 2020 2020 2020 2020 2020 2074 t │ │ │ │ │ -00010bd0: 7275 6520 2020 2020 2020 2020 2020 2020 rue │ │ │ │ │ -00010be0: 2020 2020 2020 2020 2064 6576 206e 616d dev nam │ │ │ │ │ -00010bf0: 650a 0a20 2020 5265 6d65 6d62 6572 2c20 e.. Remember, │ │ │ │ │ -00010c00: 2747 5255 425f 4449 5341 424c 455f 4c49 'GRUB_DISABLE_LI │ │ │ │ │ -00010c10: 4e55 585f 5041 5254 5555 4944 2720 616e NUX_PARTUUID' an │ │ │ │ │ -00010c20: 6420 2747 5255 425f 4449 5341 424c 455f d 'GRUB_DISABLE_ │ │ │ │ │ -00010c30: 4c49 4e55 585f 5555 4944 270a 6172 6520 LINUX_UUID'.are │ │ │ │ │ -00010c40: 616c 736f 2063 6f6e 7369 6465 7265 6420 also considered │ │ │ │ │ -00010c50: 746f 2062 6520 7365 7420 746f 2027 6661 to be set to 'fa │ │ │ │ │ -00010c60: 6c73 6527 2077 6865 6e20 7468 6579 2061 lse' when they a │ │ │ │ │ -00010c70: 7265 2075 6e73 6574 2e0a 0a1f 0a46 696c re unset.....Fil │ │ │ │ │ -00010c80: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ -00010c90: 6f64 653a 2053 6865 6c6c 2d6c 696b 6520 ode: Shell-like │ │ │ │ │ -00010ca0: 7363 7269 7074 696e 672c 2020 4e65 7874 scripting, Next │ │ │ │ │ -00010cb0: 3a20 4d75 6c74 692d 626f 6f74 206d 616e : Multi-boot man │ │ │ │ │ -00010cc0: 7561 6c20 636f 6e66 6967 2c20 2050 7265 ual config, Pre │ │ │ │ │ -00010cd0: 763a 2052 6f6f 7420 4964 656e 7469 6663 v: Root Identifc │ │ │ │ │ -00010ce0: 6174 696f 6e20 4865 7572 6973 7469 6373 ation Heuristics │ │ │ │ │ -00010cf0: 2c20 2055 703a 2043 6f6e 6669 6775 7261 , Up: Configura │ │ │ │ │ -00010d00: 7469 6f6e 0a0a 362e 3320 5772 6974 696e tion..6.3 Writin │ │ │ │ │ -00010d10: 6720 6675 6c6c 2063 6f6e 6669 6775 7261 g full configura │ │ │ │ │ -00010d20: 7469 6f6e 2066 696c 6573 2064 6972 6563 tion files direc │ │ │ │ │ -00010d30: 746c 790a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d tly.============ │ │ │ │ │ +00010b80: 2020 6661 6c73 6520 2020 2020 2020 2020 false │ │ │ │ │ +00010b90: 2020 2020 2020 2020 2020 2020 6673 2055 fs U │ │ │ │ │ +00010ba0: 5549 440a 7472 7565 2020 2020 2020 2074 UID.true t │ │ │ │ │ +00010bb0: 7275 6520 2020 2020 2020 2020 2020 2020 rue │ │ │ │ │ +00010bc0: 2020 2020 2020 2020 2020 2020 2074 7275 tru │ │ │ │ │ +00010bd0: 6520 2020 2020 2020 2020 2020 2020 2020 e │ │ │ │ │ +00010be0: 2020 2020 2020 2064 6576 206e 616d 650a dev name. │ │ │ │ │ +00010bf0: 0a20 2020 5265 6d65 6d62 6572 2c20 2747 . Remember, 'G │ │ │ │ │ +00010c00: 5255 425f 4449 5341 424c 455f 4c49 4e55 RUB_DISABLE_LINU │ │ │ │ │ +00010c10: 585f 5041 5254 5555 4944 2720 616e 6420 X_PARTUUID' and │ │ │ │ │ +00010c20: 2747 5255 425f 4449 5341 424c 455f 4c49 'GRUB_DISABLE_LI │ │ │ │ │ +00010c30: 4e55 585f 5555 4944 270a 6172 6520 616c NUX_UUID'.are al │ │ │ │ │ +00010c40: 736f 2063 6f6e 7369 6465 7265 6420 746f so considered to │ │ │ │ │ +00010c50: 2062 6520 7365 7420 746f 2027 6661 6c73 be set to 'fals │ │ │ │ │ +00010c60: 6527 2077 6865 6e20 7468 6579 2061 7265 e' when they are │ │ │ │ │ +00010c70: 2075 6e73 6574 2e0a 0a1f 0a46 696c 653a unset.....File: │ │ │ │ │ +00010c80: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ +00010c90: 653a 2053 6865 6c6c 2d6c 696b 6520 7363 e: Shell-like sc │ │ │ │ │ +00010ca0: 7269 7074 696e 672c 2020 4e65 7874 3a20 ripting, Next: │ │ │ │ │ +00010cb0: 4d75 6c74 692d 626f 6f74 206d 616e 7561 Multi-boot manua │ │ │ │ │ +00010cc0: 6c20 636f 6e66 6967 2c20 2050 7265 763a l config, Prev: │ │ │ │ │ +00010cd0: 2052 6f6f 7420 4964 656e 7469 6663 6174 Root Identifcat │ │ │ │ │ +00010ce0: 696f 6e20 4865 7572 6973 7469 6373 2c20 ion Heuristics, │ │ │ │ │ +00010cf0: 2055 703a 2043 6f6e 6669 6775 7261 7469 Up: Configurati │ │ │ │ │ +00010d00: 6f6e 0a0a 362e 3320 5772 6974 696e 6720 on..6.3 Writing │ │ │ │ │ +00010d10: 6675 6c6c 2063 6f6e 6669 6775 7261 7469 full configurati │ │ │ │ │ +00010d20: 6f6e 2066 696c 6573 2064 6972 6563 746c on files directl │ │ │ │ │ +00010d30: 790a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d y.============== │ │ │ │ │ 00010d40: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00010d50: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00010d60: 3d0a 0a27 6772 7562 2e63 6667 2720 6973 =..'grub.cfg' is │ │ │ │ │ -00010d70: 2077 7269 7474 656e 2069 6e20 4752 5542 written in GRUB │ │ │ │ │ -00010d80: 2773 2062 7569 6c74 2d69 6e20 7363 7269 's built-in scri │ │ │ │ │ -00010d90: 7074 696e 6720 6c61 6e67 7561 6765 2c20 pting language, │ │ │ │ │ -00010da0: 7768 6963 6820 6861 7320 610a 7379 6e74 which has a.synt │ │ │ │ │ -00010db0: 6178 2071 7569 7465 2073 696d 696c 6172 ax quite similar │ │ │ │ │ -00010dc0: 2074 6f20 7468 6174 206f 6620 474e 5520 to that of GNU │ │ │ │ │ -00010dd0: 4261 7368 2061 6e64 206f 7468 6572 2042 Bash and other B │ │ │ │ │ -00010de0: 6f75 726e 6520 7368 656c 6c0a 6465 7269 ourne shell.deri │ │ │ │ │ -00010df0: 7661 7469 7665 732e 0a0a 576f 7264 730a vatives...Words. │ │ │ │ │ -00010e00: 3d3d 3d3d 3d0a 0a41 2022 776f 7264 2220 =====..A "word" │ │ │ │ │ -00010e10: 6973 2061 2073 6571 7565 6e63 6520 6f66 is a sequence of │ │ │ │ │ -00010e20: 2063 6861 7261 6374 6572 7320 636f 6e73 characters cons │ │ │ │ │ -00010e30: 6964 6572 6564 2061 7320 6120 7369 6e67 idered as a sing │ │ │ │ │ -00010e40: 6c65 2075 6e69 7420 6279 0a47 5255 422e le unit by.GRUB. │ │ │ │ │ -00010e50: 2057 6f72 6473 2061 7265 2073 6570 6172 Words are separ │ │ │ │ │ -00010e60: 6174 6564 2062 7920 226d 6574 6163 6861 ated by "metacha │ │ │ │ │ -00010e70: 7261 6374 6572 7322 2c20 7768 6963 6820 racters", which │ │ │ │ │ -00010e80: 6172 6520 7468 6520 666f 6c6c 6f77 696e are the followin │ │ │ │ │ -00010e90: 670a 706c 7573 2073 7061 6365 2c20 7461 g.plus space, ta │ │ │ │ │ -00010ea0: 622c 2061 6e64 206e 6577 6c69 6e65 3a0a b, and newline:. │ │ │ │ │ -00010eb0: 0a20 2020 2020 7b20 7d20 7c20 2620 2420 . { } | & $ │ │ │ │ │ -00010ec0: 3b20 3c20 3e0a 0a20 2020 5175 6f74 696e ; < >.. Quotin │ │ │ │ │ -00010ed0: 6720 6d61 7920 6265 2075 7365 6420 746f g may be used to │ │ │ │ │ -00010ee0: 2069 6e63 6c75 6465 206d 6574 6163 6861 include metacha │ │ │ │ │ -00010ef0: 7261 6374 6572 7320 696e 2077 6f72 6473 racters in words │ │ │ │ │ -00010f00: 3b20 7365 6520 6265 6c6f 772e 0a0a 5265 ; see below...Re │ │ │ │ │ -00010f10: 7365 7276 6564 2077 6f72 6473 0a3d 3d3d served words.=== │ │ │ │ │ -00010f20: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a52 6573 ===========..Res │ │ │ │ │ -00010f30: 6572 7665 6420 776f 7264 7320 6861 7665 erved words have │ │ │ │ │ -00010f40: 2061 2073 7065 6369 616c 206d 6561 6e69 a special meani │ │ │ │ │ -00010f50: 6e67 2074 6f20 4752 5542 2e20 5468 6520 ng to GRUB. The │ │ │ │ │ -00010f60: 666f 6c6c 6f77 696e 6720 776f 7264 7320 following words │ │ │ │ │ -00010f70: 6172 650a 7265 636f 676e 6973 6564 2061 are.recognised a │ │ │ │ │ -00010f80: 7320 7265 7365 7276 6564 2077 6865 6e20 s reserved when │ │ │ │ │ -00010f90: 756e 7175 6f74 6564 2061 6e64 2065 6974 unquoted and eit │ │ │ │ │ -00010fa0: 6865 7220 7468 6520 6669 7273 7420 776f her the first wo │ │ │ │ │ -00010fb0: 7264 206f 6620 610a 7369 6d70 6c65 2063 rd of a.simple c │ │ │ │ │ -00010fc0: 6f6d 6d61 6e64 206f 7220 7468 6520 7468 ommand or the th │ │ │ │ │ -00010fd0: 6972 6420 776f 7264 206f 6620 6120 2766 ird word of a 'f │ │ │ │ │ -00010fe0: 6f72 2720 636f 6d6d 616e 643a 0a0a 2020 or' command:.. │ │ │ │ │ -00010ff0: 2020 2021 205b 5b20 5d5d 207b 207d 0a20 ! [[ ]] { }. │ │ │ │ │ -00011000: 2020 2020 6361 7365 2064 6f20 646f 6e65 case do done │ │ │ │ │ -00011010: 2065 6c69 6620 656c 7365 2065 7361 6320 elif else esac │ │ │ │ │ -00011020: 6669 2066 6f72 2066 756e 6374 696f 6e0a fi for function. │ │ │ │ │ -00011030: 2020 2020 2069 6620 696e 206d 656e 7565 if in menue │ │ │ │ │ -00011040: 6e74 7279 2073 656c 6563 7420 7468 656e ntry select then │ │ │ │ │ -00011050: 2074 696d 6520 756e 7469 6c20 7768 696c time until whil │ │ │ │ │ -00011060: 650a 0a20 2020 4e6f 7420 616c 6c20 6f66 e.. Not all of │ │ │ │ │ -00011070: 2074 6865 7365 2072 6573 6572 7665 6420 these reserved │ │ │ │ │ -00011080: 776f 7264 7320 6861 7665 2061 2075 7365 words have a use │ │ │ │ │ -00011090: 6675 6c20 7075 7270 6f73 6520 7965 743b ful purpose yet; │ │ │ │ │ -000110a0: 2073 6f6d 6520 6172 650a 7265 7365 7276 some are.reserv │ │ │ │ │ -000110b0: 6564 2066 6f72 2066 7574 7572 6520 6578 ed for future ex │ │ │ │ │ -000110c0: 7061 6e73 696f 6e2e 0a0a 5175 6f74 696e pansion...Quotin │ │ │ │ │ -000110d0: 670a 3d3d 3d3d 3d3d 3d0a 0a51 756f 7469 g.=======..Quoti │ │ │ │ │ -000110e0: 6e67 2069 7320 7573 6564 2074 6f20 7265 ng is used to re │ │ │ │ │ -000110f0: 6d6f 7665 2074 6865 2073 7065 6369 616c move the special │ │ │ │ │ -00011100: 206d 6561 6e69 6e67 206f 6620 6365 7274 meaning of cert │ │ │ │ │ -00011110: 6169 6e20 6368 6172 6163 7465 7273 206f ain characters o │ │ │ │ │ -00011120: 720a 776f 7264 732e 2020 4974 2063 616e r.words. It can │ │ │ │ │ -00011130: 2062 6520 7573 6564 2074 6f20 7472 6561 be used to trea │ │ │ │ │ -00011140: 7420 6d65 7461 6368 6172 6163 7465 7273 t metacharacters │ │ │ │ │ -00011150: 2061 7320 7061 7274 206f 6620 6120 776f as part of a wo │ │ │ │ │ -00011160: 7264 2c20 746f 0a70 7265 7665 6e74 2072 rd, to.prevent r │ │ │ │ │ -00011170: 6573 6572 7665 6420 776f 7264 7320 6672 eserved words fr │ │ │ │ │ -00011180: 6f6d 2062 6569 6e67 2072 6563 6f67 6e69 om being recogni │ │ │ │ │ -00011190: 7365 6420 6173 2073 7563 682c 2061 6e64 sed as such, and │ │ │ │ │ -000111a0: 2074 6f20 7072 6576 656e 740a 7661 7269 to prevent.vari │ │ │ │ │ -000111b0: 6162 6c65 2065 7870 616e 7369 6f6e 2e0a able expansion.. │ │ │ │ │ -000111c0: 0a20 2020 5468 6572 6520 6172 6520 7468 . There are th │ │ │ │ │ -000111d0: 7265 6520 7175 6f74 696e 6720 6d65 6368 ree quoting mech │ │ │ │ │ -000111e0: 616e 6973 6d73 3a20 7468 6520 6573 6361 anisms: the esca │ │ │ │ │ -000111f0: 7065 2063 6861 7261 6374 6572 2c20 7369 pe character, si │ │ │ │ │ -00011200: 6e67 6c65 0a71 756f 7465 732c 2061 6e64 ngle.quotes, and │ │ │ │ │ -00011210: 2064 6f75 626c 6520 7175 6f74 6573 2e0a double quotes.. │ │ │ │ │ -00011220: 0a20 2020 4120 6e6f 6e2d 7175 6f74 6564 . A non-quoted │ │ │ │ │ -00011230: 2062 6163 6b73 6c61 7368 2028 5c29 2069 backslash (\) i │ │ │ │ │ -00011240: 7320 7468 6520 2265 7363 6170 6520 6368 s the "escape ch │ │ │ │ │ -00011250: 6172 6163 7465 7222 2e20 2049 7420 7072 aracter". It pr │ │ │ │ │ -00011260: 6573 6572 7665 730a 7468 6520 6c69 7465 eserves.the lite │ │ │ │ │ -00011270: 7261 6c20 7661 6c75 6520 6f66 2074 6865 ral value of the │ │ │ │ │ -00011280: 206e 6578 7420 6368 6172 6163 7465 7220 next character │ │ │ │ │ -00011290: 7468 6174 2066 6f6c 6c6f 7773 2c20 7769 that follows, wi │ │ │ │ │ -000112a0: 7468 2074 6865 2065 7863 6570 7469 6f6e th the exception │ │ │ │ │ -000112b0: 0a6f 6620 6e65 776c 696e 652e 0a0a 2020 .of newline... │ │ │ │ │ -000112c0: 2045 6e63 6c6f 7369 6e67 2063 6861 7261 Enclosing chara │ │ │ │ │ -000112d0: 6374 6572 7320 696e 2073 696e 676c 6520 cters in single │ │ │ │ │ -000112e0: 7175 6f74 6573 2070 7265 7365 7276 6573 quotes preserves │ │ │ │ │ -000112f0: 2074 6865 206c 6974 6572 616c 2076 616c the literal val │ │ │ │ │ -00011300: 7565 206f 660a 6561 6368 2063 6861 7261 ue of.each chara │ │ │ │ │ -00011310: 6374 6572 2077 6974 6869 6e20 7468 6520 cter within the │ │ │ │ │ -00011320: 7175 6f74 6573 2e20 2041 2073 696e 676c quotes. A singl │ │ │ │ │ -00011330: 6520 7175 6f74 6520 6d61 7920 6e6f 7420 e quote may not │ │ │ │ │ -00011340: 6f63 6375 7220 6265 7477 6565 6e0a 7369 occur between.si │ │ │ │ │ -00011350: 6e67 6c65 2071 756f 7465 732c 2065 7665 ngle quotes, eve │ │ │ │ │ -00011360: 6e20 7768 656e 2070 7265 6365 6465 6420 n when preceded │ │ │ │ │ -00011370: 6279 2061 2062 6163 6b73 6c61 7368 2e0a by a backslash.. │ │ │ │ │ -00011380: 0a20 2020 456e 636c 6f73 696e 6720 6368 . Enclosing ch │ │ │ │ │ -00011390: 6172 6163 7465 7273 2069 6e20 646f 7562 aracters in doub │ │ │ │ │ -000113a0: 6c65 2071 756f 7465 7320 7072 6573 6572 le quotes preser │ │ │ │ │ -000113b0: 7665 7320 7468 6520 6c69 7465 7261 6c20 ves the literal │ │ │ │ │ -000113c0: 7661 6c75 6520 6f66 0a61 6c6c 2063 6861 value of.all cha │ │ │ │ │ -000113d0: 7261 6374 6572 7320 7769 7468 696e 2074 racters within t │ │ │ │ │ -000113e0: 6865 2071 756f 7465 732c 2077 6974 6820 he quotes, with │ │ │ │ │ -000113f0: 7468 6520 6578 6365 7074 696f 6e20 6f66 the exception of │ │ │ │ │ -00011400: 2027 2427 2061 6e64 2027 5c27 2e0a 5468 '$' and '\'..Th │ │ │ │ │ -00011410: 6520 2724 2720 6368 6172 6163 7465 7220 e '$' character │ │ │ │ │ -00011420: 7265 7461 696e 7320 6974 7320 7370 6563 retains its spec │ │ │ │ │ -00011430: 6961 6c20 6d65 616e 696e 6720 7769 7468 ial meaning with │ │ │ │ │ -00011440: 696e 2064 6f75 626c 6520 7175 6f74 6573 in double quotes │ │ │ │ │ -00011450: 2e20 2054 6865 0a62 6163 6b73 6c61 7368 . The.backslash │ │ │ │ │ -00011460: 2072 6574 6169 6e73 2069 7473 2073 7065 retains its spe │ │ │ │ │ -00011470: 6369 616c 206d 6561 6e69 6e67 206f 6e6c cial meaning onl │ │ │ │ │ -00011480: 7920 7768 656e 2066 6f6c 6c6f 7765 6420 y when followed │ │ │ │ │ -00011490: 6279 206f 6e65 206f 6620 7468 650a 666f by one of the.fo │ │ │ │ │ -000114a0: 6c6c 6f77 696e 6720 6368 6172 6163 7465 llowing characte │ │ │ │ │ -000114b0: 7273 3a20 2724 272c 2027 2227 2c20 275c rs: '$', '"', '\ │ │ │ │ │ -000114c0: 272c 206f 7220 6e65 776c 696e 652e 2020 ', or newline. │ │ │ │ │ -000114d0: 4120 6261 636b 736c 6173 682d 6e65 776c A backslash-newl │ │ │ │ │ -000114e0: 696e 650a 7061 6972 2069 7320 7472 6561 ine.pair is trea │ │ │ │ │ -000114f0: 7465 6420 6173 2061 206c 696e 6520 636f ted as a line co │ │ │ │ │ -00011500: 6e74 696e 7561 7469 6f6e 2028 7468 6174 ntinuation (that │ │ │ │ │ -00011510: 2069 732c 2069 7420 6973 2072 656d 6f76 is, it is remov │ │ │ │ │ -00011520: 6564 2066 726f 6d20 7468 650a 696e 7075 ed from the.inpu │ │ │ │ │ -00011530: 7420 7374 7265 616d 2061 6e64 2065 6666 t stream and eff │ │ │ │ │ -00011540: 6563 7469 7665 6c79 2069 676e 6f72 6564 ectively ignored │ │ │ │ │ -00011550: 2831 2920 282a 6e6f 7465 2053 6865 6c6c (1) (*note Shell │ │ │ │ │ -00011560: 2d6c 696b 650a 7363 7269 7074 696e 672d -like.scripting- │ │ │ │ │ -00011570: 466f 6f74 6e6f 7465 2d31 3a3a 2929 2e20 Footnote-1::)). │ │ │ │ │ -00011580: 2041 2064 6f75 626c 6520 7175 6f74 6520 A double quote │ │ │ │ │ -00011590: 6d61 7920 6265 2071 756f 7465 6420 7769 may be quoted wi │ │ │ │ │ -000115a0: 7468 696e 2064 6f75 626c 650a 7175 6f74 thin double.quot │ │ │ │ │ -000115b0: 6573 2062 7920 7072 6563 6564 696e 6720 es by preceding │ │ │ │ │ -000115c0: 6974 2077 6974 6820 6120 6261 636b 736c it with a backsl │ │ │ │ │ -000115d0: 6173 682e 0a0a 5661 7269 6162 6c65 2065 ash...Variable e │ │ │ │ │ -000115e0: 7870 616e 7369 6f6e 0a3d 3d3d 3d3d 3d3d xpansion.======= │ │ │ │ │ -000115f0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a54 6865 ===========..The │ │ │ │ │ -00011600: 2027 2427 2063 6861 7261 6374 6572 2069 '$' character i │ │ │ │ │ -00011610: 6e74 726f 6475 6365 7320 7661 7269 6162 ntroduces variab │ │ │ │ │ -00011620: 6c65 2065 7870 616e 7369 6f6e 2e20 2054 le expansion. T │ │ │ │ │ -00011630: 6865 2076 6172 6961 626c 6520 6e61 6d65 he variable name │ │ │ │ │ -00011640: 2074 6f0a 6265 2065 7870 616e 6465 6420 to.be expanded │ │ │ │ │ -00011650: 6d61 7920 6265 2065 6e63 6c6f 7365 6420 may be enclosed │ │ │ │ │ -00011660: 696e 2062 7261 6365 732c 2077 6869 6368 in braces, which │ │ │ │ │ -00011670: 2061 7265 206f 7074 696f 6e61 6c20 6275 are optional bu │ │ │ │ │ -00011680: 7420 7365 7276 6520 746f 0a70 726f 7465 t serve to.prote │ │ │ │ │ -00011690: 6374 2074 6865 2076 6172 6961 626c 6520 ct the variable │ │ │ │ │ -000116a0: 746f 2062 6520 6578 7061 6e64 6564 2066 to be expanded f │ │ │ │ │ -000116b0: 726f 6d20 6368 6172 6163 7465 7273 2069 rom characters i │ │ │ │ │ -000116c0: 6d6d 6564 6961 7465 6c79 0a66 6f6c 6c6f mmediately.follo │ │ │ │ │ -000116d0: 7769 6e67 2069 7420 7768 6963 6820 636f wing it which co │ │ │ │ │ -000116e0: 756c 6420 6265 2069 6e74 6572 7072 6574 uld be interpret │ │ │ │ │ -000116f0: 6564 2061 7320 7061 7274 206f 6620 7468 ed as part of th │ │ │ │ │ -00011700: 6520 6e61 6d65 2e0a 0a20 2020 4e6f 726d e name... Norm │ │ │ │ │ -00011710: 616c 2076 6172 6961 626c 6520 6e61 6d65 al variable name │ │ │ │ │ -00011720: 7320 6265 6769 6e20 7769 7468 2061 6e20 s begin with an │ │ │ │ │ -00011730: 616c 7068 6162 6574 6963 2063 6861 7261 alphabetic chara │ │ │ │ │ -00011740: 6374 6572 2c20 666f 6c6c 6f77 6564 2062 cter, followed b │ │ │ │ │ -00011750: 790a 7a65 726f 206f 7220 6d6f 7265 2061 y.zero or more a │ │ │ │ │ -00011760: 6c70 6861 6e75 6d65 7269 6320 6368 6172 lphanumeric char │ │ │ │ │ -00011770: 6163 7465 7273 2e20 2054 6865 7365 206e acters. These n │ │ │ │ │ -00011780: 616d 6573 2072 6566 6572 2074 6f20 656e ames refer to en │ │ │ │ │ -00011790: 7472 6965 7320 696e 0a74 6865 2047 5255 tries in.the GRU │ │ │ │ │ -000117a0: 4220 656e 7669 726f 6e6d 656e 7420 282a B environment (* │ │ │ │ │ -000117b0: 6e6f 7465 2045 6e76 6972 6f6e 6d65 6e74 note Environment │ │ │ │ │ -000117c0: 3a3a 292e 0a0a 2020 2050 6f73 6974 696f ::)... Positio │ │ │ │ │ -000117d0: 6e61 6c20 7661 7269 6162 6c65 206e 616d nal variable nam │ │ │ │ │ -000117e0: 6573 2063 6f6e 7369 7374 206f 6620 6f6e es consist of on │ │ │ │ │ -000117f0: 6520 6f72 206d 6f72 6520 6469 6769 7473 e or more digits │ │ │ │ │ -00011800: 2e20 2054 6865 790a 7265 7072 6573 656e . They.represen │ │ │ │ │ -00011810: 7420 7061 7261 6d65 7465 7273 2070 6173 t parameters pas │ │ │ │ │ -00011820: 7365 6420 746f 2066 756e 6374 696f 6e20 sed to function │ │ │ │ │ -00011830: 6361 6c6c 732c 2077 6974 6820 2724 3127 calls, with '$1' │ │ │ │ │ -00011840: 2072 6570 7265 7365 6e74 696e 670a 7468 representing.th │ │ │ │ │ -00011850: 6520 6669 7273 7420 7061 7261 6d65 7465 e first paramete │ │ │ │ │ -00011860: 722c 2061 6e64 2073 6f20 6f6e 2e0a 0a20 r, and so on... │ │ │ │ │ -00011870: 2020 5468 6520 7370 6563 6961 6c20 7661 The special va │ │ │ │ │ -00011880: 7269 6162 6c65 206e 616d 6520 273f 2720 riable name '?' │ │ │ │ │ -00011890: 6578 7061 6e64 7320 746f 2074 6865 2065 expands to the e │ │ │ │ │ -000118a0: 7869 7420 7374 6174 7573 206f 6620 7468 xit status of th │ │ │ │ │ -000118b0: 6520 6d6f 7374 0a72 6563 656e 746c 7920 e most.recently │ │ │ │ │ -000118c0: 6578 6563 7574 6564 2063 6f6d 6d61 6e64 executed command │ │ │ │ │ -000118d0: 2e20 2057 6865 6e20 706f 7369 7469 6f6e . When position │ │ │ │ │ -000118e0: 616c 2076 6172 6961 626c 6520 6e61 6d65 al variable name │ │ │ │ │ -000118f0: 7320 6172 6520 6163 7469 7665 2c0a 6f74 s are active,.ot │ │ │ │ │ -00011900: 6865 7220 7370 6563 6961 6c20 7661 7269 her special vari │ │ │ │ │ -00011910: 6162 6c65 206e 616d 6573 2027 4027 2c20 able names '@', │ │ │ │ │ -00011920: 272a 2720 616e 6420 2723 2720 6172 6520 '*' and '#' are │ │ │ │ │ -00011930: 6465 6669 6e65 6420 616e 6420 7468 6579 defined and they │ │ │ │ │ -00011940: 0a65 7870 616e 6420 746f 2061 6c6c 2070 .expand to all p │ │ │ │ │ -00011950: 6f73 6974 696f 6e61 6c20 7061 7261 6d65 ositional parame │ │ │ │ │ -00011960: 7465 7273 2077 6974 6820 6e65 6365 7373 ters with necess │ │ │ │ │ -00011970: 6172 7920 7175 6f74 696e 672c 2070 6f73 ary quoting, pos │ │ │ │ │ -00011980: 6974 696f 6e61 6c0a 7061 7261 6d65 7465 itional.paramete │ │ │ │ │ -00011990: 7273 2077 6974 686f 7574 2061 6e79 2071 rs without any q │ │ │ │ │ -000119a0: 756f 7469 6e67 2c20 616e 6420 706f 7369 uoting, and posi │ │ │ │ │ -000119b0: 7469 6f6e 616c 2070 6172 616d 6574 6572 tional parameter │ │ │ │ │ -000119c0: 2063 6f75 6e74 0a72 6573 7065 6374 6976 count.respectiv │ │ │ │ │ -000119d0: 656c 792e 0a0a 436f 6d6d 656e 7473 0a3d ely...Comments.= │ │ │ │ │ -000119e0: 3d3d 3d3d 3d3d 3d0a 0a41 2077 6f72 6420 =======..A word │ │ │ │ │ -000119f0: 6265 6769 6e6e 696e 6720 7769 7468 2027 beginning with ' │ │ │ │ │ -00011a00: 2327 2063 6175 7365 7320 7468 6174 2077 #' causes that w │ │ │ │ │ -00011a10: 6f72 6420 616e 6420 616c 6c20 7265 6d61 ord and all rema │ │ │ │ │ -00011a20: 696e 696e 6720 6368 6172 6163 7465 7273 ining characters │ │ │ │ │ -00011a30: 0a6f 6e20 7468 6174 206c 696e 6520 746f .on that line to │ │ │ │ │ -00011a40: 2062 6520 6967 6e6f 7265 642e 0a0a 5369 be ignored...Si │ │ │ │ │ -00011a50: 6d70 6c65 2063 6f6d 6d61 6e64 730a 3d3d mple commands.== │ │ │ │ │ -00011a60: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a41 =============..A │ │ │ │ │ -00011a70: 2022 7369 6d70 6c65 2063 6f6d 6d61 6e64 "simple command │ │ │ │ │ -00011a80: 2220 6973 2061 2073 6571 7565 6e63 6520 " is a sequence │ │ │ │ │ -00011a90: 6f66 2077 6f72 6473 2073 6570 6172 6174 of words separat │ │ │ │ │ -00011aa0: 6564 2062 7920 7370 6163 6573 206f 7220 ed by spaces or │ │ │ │ │ -00011ab0: 7461 6273 0a61 6e64 2074 6572 6d69 6e61 tabs.and termina │ │ │ │ │ -00011ac0: 7465 6420 6279 2061 2073 656d 6963 6f6c ted by a semicol │ │ │ │ │ -00011ad0: 6f6e 206f 7220 6120 6e65 776c 696e 652e on or a newline. │ │ │ │ │ -00011ae0: 2020 5468 6520 6669 7273 7420 776f 7264 The first word │ │ │ │ │ -00011af0: 2073 7065 6369 6669 6573 0a74 6865 2063 specifies.the c │ │ │ │ │ -00011b00: 6f6d 6d61 6e64 2074 6f20 6265 2065 7865 ommand to be exe │ │ │ │ │ -00011b10: 6375 7465 642e 2020 5468 6520 7265 6d61 cuted. The rema │ │ │ │ │ -00011b20: 696e 696e 6720 776f 7264 7320 6172 6520 ining words are │ │ │ │ │ -00011b30: 7061 7373 6564 2061 7320 6172 6775 6d65 passed as argume │ │ │ │ │ -00011b40: 6e74 730a 746f 2074 6865 2069 6e76 6f6b nts.to the invok │ │ │ │ │ -00011b50: 6564 2063 6f6d 6d61 6e64 2e0a 0a20 2020 ed command... │ │ │ │ │ -00011b60: 5468 6520 7265 7475 726e 2076 616c 7565 The return value │ │ │ │ │ -00011b70: 206f 6620 6120 7369 6d70 6c65 2063 6f6d of a simple com │ │ │ │ │ -00011b80: 6d61 6e64 2069 7320 6974 7320 6578 6974 mand is its exit │ │ │ │ │ -00011b90: 2073 7461 7475 732e 2020 4966 2074 6865 status. If the │ │ │ │ │ -00011ba0: 0a72 6573 6572 7665 6420 776f 7264 2027 .reserved word ' │ │ │ │ │ -00011bb0: 2127 2070 7265 6365 6465 7320 7468 6520 !' precedes the │ │ │ │ │ -00011bc0: 636f 6d6d 616e 642c 2074 6865 6e20 7468 command, then th │ │ │ │ │ -00011bd0: 6520 7265 7475 726e 2076 616c 7565 2069 e return value i │ │ │ │ │ -00011be0: 7320 696e 7374 6561 640a 7468 6520 6c6f s instead.the lo │ │ │ │ │ -00011bf0: 6769 6361 6c20 6e65 6761 7469 6f6e 206f gical negation o │ │ │ │ │ -00011c00: 6620 7468 6520 636f 6d6d 616e 6427 7320 f the command's │ │ │ │ │ -00011c10: 6578 6974 2073 7461 7475 732e 0a0a 436f exit status...Co │ │ │ │ │ -00011c20: 6d70 6f75 6e64 2063 6f6d 6d61 6e64 730a mpound commands. │ │ │ │ │ -00011c30: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00011c40: 3d0a 0a41 2022 636f 6d70 6f75 6e64 2063 =..A "compound c │ │ │ │ │ -00011c50: 6f6d 6d61 6e64 2220 6973 206f 6e65 206f ommand" is one o │ │ │ │ │ -00011c60: 6620 7468 6520 666f 6c6c 6f77 696e 673a f the following: │ │ │ │ │ -00011c70: 0a0a 666f 7220 4e41 4d45 2069 6e20 574f ..for NAME in WO │ │ │ │ │ -00011c80: 5244 202e 2e2e 3b20 646f 204c 4953 543b RD ...; do LIST; │ │ │ │ │ -00011c90: 2064 6f6e 650a 2020 2020 2054 6865 206c done. The l │ │ │ │ │ -00011ca0: 6973 7420 6f66 2077 6f72 6473 2066 6f6c ist of words fol │ │ │ │ │ -00011cb0: 6c6f 7769 6e67 2027 696e 2720 6973 2065 lowing 'in' is e │ │ │ │ │ -00011cc0: 7870 616e 6465 642c 2067 656e 6572 6174 xpanded, generat │ │ │ │ │ -00011cd0: 696e 6720 6120 6c69 7374 206f 660a 2020 ing a list of. │ │ │ │ │ -00011ce0: 2020 2069 7465 6d73 2e20 2054 6865 2076 items. The v │ │ │ │ │ -00011cf0: 6172 6961 626c 6520 4e41 4d45 2069 7320 ariable NAME is │ │ │ │ │ -00011d00: 7365 7420 746f 2065 6163 6820 656c 656d set to each elem │ │ │ │ │ -00011d10: 656e 7420 6f66 2074 6869 7320 6c69 7374 ent of this list │ │ │ │ │ -00011d20: 2069 6e0a 2020 2020 2074 7572 6e2c 2061 in. turn, a │ │ │ │ │ -00011d30: 6e64 204c 4953 5420 6973 2065 7865 6375 nd LIST is execu │ │ │ │ │ -00011d40: 7465 6420 6561 6368 2074 696d 652e 2020 ted each time. │ │ │ │ │ -00011d50: 5468 6520 7265 7475 726e 2076 616c 7565 The return value │ │ │ │ │ -00011d60: 2069 7320 7468 6520 6578 6974 0a20 2020 is the exit. │ │ │ │ │ -00011d70: 2020 7374 6174 7573 206f 6620 7468 6520 status of the │ │ │ │ │ -00011d80: 6c61 7374 2063 6f6d 6d61 6e64 2074 6861 last command tha │ │ │ │ │ -00011d90: 7420 6578 6563 7574 6573 2e20 2049 6620 t executes. If │ │ │ │ │ -00011da0: 7468 6520 6578 7061 6e73 696f 6e20 6f66 the expansion of │ │ │ │ │ -00011db0: 2074 6865 0a20 2020 2020 6974 656d 7320 the. items │ │ │ │ │ -00011dc0: 666f 6c6c 6f77 696e 6720 2769 6e27 2072 following 'in' r │ │ │ │ │ -00011dd0: 6573 756c 7473 2069 6e20 616e 2065 6d70 esults in an emp │ │ │ │ │ -00011de0: 7479 206c 6973 742c 206e 6f20 636f 6d6d ty list, no comm │ │ │ │ │ -00011df0: 616e 6473 2061 7265 0a20 2020 2020 6578 ands are. ex │ │ │ │ │ -00011e00: 6563 7574 6564 2c20 616e 6420 7468 6520 ecuted, and the │ │ │ │ │ -00011e10: 7265 7475 726e 2073 7461 7475 7320 6973 return status is │ │ │ │ │ -00011e20: 2030 2e0a 0a69 6620 4c49 5354 3b20 7468 0...if LIST; th │ │ │ │ │ -00011e30: 656e 204c 4953 543b 205b 656c 6966 204c en LIST; [elif L │ │ │ │ │ -00011e40: 4953 543b 2074 6865 6e20 4c49 5354 3b5d IST; then LIST;] │ │ │ │ │ -00011e50: 202e 2e2e 205b 656c 7365 204c 4953 543b ... [else LIST; │ │ │ │ │ -00011e60: 5d20 6669 0a20 2020 2020 5468 6520 2769 ] fi. The 'i │ │ │ │ │ -00011e70: 6627 204c 4953 5420 6973 2065 7865 6375 f' LIST is execu │ │ │ │ │ -00011e80: 7465 642e 2020 4966 2069 7473 2065 7869 ted. If its exi │ │ │ │ │ -00011e90: 7420 7374 6174 7573 2069 7320 7a65 726f t status is zero │ │ │ │ │ -00011ea0: 2c20 7468 6520 2774 6865 6e27 0a20 2020 , the 'then'. │ │ │ │ │ -00011eb0: 2020 4c49 5354 2069 7320 6578 6563 7574 LIST is execut │ │ │ │ │ -00011ec0: 6564 2e20 204f 7468 6572 7769 7365 2c20 ed. Otherwise, │ │ │ │ │ -00011ed0: 6561 6368 2027 656c 6966 2720 4c49 5354 each 'elif' LIST │ │ │ │ │ -00011ee0: 2069 7320 6578 6563 7574 6564 2069 6e20 is executed in │ │ │ │ │ -00011ef0: 7475 726e 2c0a 2020 2020 2061 6e64 2069 turn,. and i │ │ │ │ │ -00011f00: 6620 6974 7320 6578 6974 2073 7461 7475 f its exit statu │ │ │ │ │ -00011f10: 7320 6973 207a 6572 6f2c 2074 6865 2063 s is zero, the c │ │ │ │ │ -00011f20: 6f72 7265 7370 6f6e 6469 6e67 2027 7468 orresponding 'th │ │ │ │ │ -00011f30: 656e 2720 4c49 5354 2069 730a 2020 2020 en' LIST is. │ │ │ │ │ -00011f40: 2065 7865 6375 7465 6420 616e 6420 7468 executed and th │ │ │ │ │ -00011f50: 6520 636f 6d6d 616e 6420 636f 6d70 6c65 e command comple │ │ │ │ │ -00011f60: 7465 732e 2020 4f74 6865 7277 6973 652c tes. Otherwise, │ │ │ │ │ -00011f70: 2074 6865 2027 656c 7365 2720 4c49 5354 the 'else' LIST │ │ │ │ │ -00011f80: 2069 730a 2020 2020 2065 7865 6375 7465 is. execute │ │ │ │ │ -00011f90: 642c 2069 6620 7072 6573 656e 742e 2020 d, if present. │ │ │ │ │ -00011fa0: 5468 6520 6578 6974 2073 7461 7475 7320 The exit status │ │ │ │ │ -00011fb0: 6973 2074 6865 2065 7869 7420 7374 6174 is the exit stat │ │ │ │ │ -00011fc0: 7573 206f 6620 7468 650a 2020 2020 206c us of the. l │ │ │ │ │ -00011fd0: 6173 7420 636f 6d6d 616e 6420 6578 6563 ast command exec │ │ │ │ │ -00011fe0: 7574 6564 2c20 6f72 207a 6572 6f20 6966 uted, or zero if │ │ │ │ │ -00011ff0: 206e 6f20 636f 6e64 6974 696f 6e20 7465 no condition te │ │ │ │ │ -00012000: 7374 6564 2074 7275 652e 0a0a 7768 696c sted true...whil │ │ │ │ │ -00012010: 6520 434f 4e44 3b20 646f 204c 4953 543b e COND; do LIST; │ │ │ │ │ -00012020: 2064 6f6e 650a 756e 7469 6c20 434f 4e44 done.until COND │ │ │ │ │ -00012030: 3b20 646f 204c 4953 543b 2064 6f6e 650a ; do LIST; done. │ │ │ │ │ -00012040: 2020 2020 2054 6865 2027 7768 696c 6527 The 'while' │ │ │ │ │ -00012050: 2063 6f6d 6d61 6e64 2063 6f6e 7469 6e75 command continu │ │ │ │ │ -00012060: 6f75 736c 7920 6578 6563 7574 6573 2074 ously executes t │ │ │ │ │ -00012070: 6865 2027 646f 2720 4c49 5354 2061 7320 he 'do' LIST as │ │ │ │ │ -00012080: 6c6f 6e67 2061 730a 2020 2020 2074 6865 long as. the │ │ │ │ │ -00012090: 206c 6173 7420 636f 6d6d 616e 6420 696e last command in │ │ │ │ │ -000120a0: 2043 4f4e 4420 7265 7475 726e 7320 616e COND returns an │ │ │ │ │ -000120b0: 2065 7869 7420 7374 6174 7573 206f 6620 exit status of │ │ │ │ │ -000120c0: 7a65 726f 2e20 2054 6865 0a20 2020 2020 zero. The. │ │ │ │ │ -000120d0: 2775 6e74 696c 2720 636f 6d6d 616e 6420 'until' command │ │ │ │ │ -000120e0: 6973 2069 6465 6e74 6963 616c 2074 6f20 is identical to │ │ │ │ │ -000120f0: 7468 6520 2777 6869 6c65 2720 636f 6d6d the 'while' comm │ │ │ │ │ -00012100: 616e 642c 2065 7863 6570 7420 7468 6174 and, except that │ │ │ │ │ -00012110: 0a20 2020 2020 7468 6520 7465 7374 2069 . the test i │ │ │ │ │ -00012120: 7320 6e65 6761 7465 643b 2074 6865 2027 s negated; the ' │ │ │ │ │ -00012130: 646f 2720 4c49 5354 2069 7320 6578 6563 do' LIST is exec │ │ │ │ │ -00012140: 7574 6564 2061 7320 6c6f 6e67 2061 7320 uted as long as │ │ │ │ │ -00012150: 7468 6520 6c61 7374 0a20 2020 2020 636f the last. co │ │ │ │ │ -00012160: 6d6d 616e 6420 696e 2043 4f4e 4420 7265 mmand in COND re │ │ │ │ │ -00012170: 7475 726e 7320 6120 6e6f 6e2d 7a65 726f turns a non-zero │ │ │ │ │ -00012180: 2065 7869 7420 7374 6174 7573 2e20 2054 exit status. T │ │ │ │ │ -00012190: 6865 2065 7869 7420 7374 6174 7573 206f he exit status o │ │ │ │ │ -000121a0: 660a 2020 2020 2074 6865 2027 7768 696c f. the 'whil │ │ │ │ │ -000121b0: 6527 2061 6e64 2027 756e 7469 6c27 2063 e' and 'until' c │ │ │ │ │ -000121c0: 6f6d 6d61 6e64 7320 6973 2074 6865 2065 ommands is the e │ │ │ │ │ -000121d0: 7869 7420 7374 6174 7573 206f 6620 7468 xit status of th │ │ │ │ │ -000121e0: 6520 6c61 7374 0a20 2020 2020 2764 6f27 e last. 'do' │ │ │ │ │ -000121f0: 204c 4953 5420 636f 6d6d 616e 6420 6578 LIST command ex │ │ │ │ │ -00012200: 6563 7574 6564 2c20 6f72 207a 6572 6f20 ecuted, or zero │ │ │ │ │ -00012210: 6966 206e 6f6e 6520 7761 7320 6578 6563 if none was exec │ │ │ │ │ -00012220: 7574 6564 2e0a 0a66 756e 6374 696f 6e20 uted...function │ │ │ │ │ -00012230: 4e41 4d45 207b 2043 4f4d 4d41 4e44 3b20 NAME { COMMAND; │ │ │ │ │ -00012240: 2e2e 2e20 7d0a 2020 2020 2054 6869 7320 ... }. This │ │ │ │ │ -00012250: 6465 6669 6e65 7320 6120 6675 6e63 7469 defines a functi │ │ │ │ │ -00012260: 6f6e 206e 616d 6564 204e 414d 452e 2020 on named NAME. │ │ │ │ │ -00012270: 5468 6520 2262 6f64 7922 206f 6620 7468 The "body" of th │ │ │ │ │ -00012280: 6520 6675 6e63 7469 6f6e 2069 730a 2020 e function is. │ │ │ │ │ -00012290: 2020 2074 6865 206c 6973 7420 6f66 2063 the list of c │ │ │ │ │ -000122a0: 6f6d 6d61 6e64 7320 7769 7468 696e 2062 ommands within b │ │ │ │ │ -000122b0: 7261 6365 732c 2065 6163 6820 6f66 2077 races, each of w │ │ │ │ │ -000122c0: 6869 6368 206d 7573 7420 6265 0a20 2020 hich must be. │ │ │ │ │ -000122d0: 2020 7465 726d 696e 6174 6564 2077 6974 terminated wit │ │ │ │ │ -000122e0: 6820 6120 7365 6d69 636f 6c6f 6e20 6f72 h a semicolon or │ │ │ │ │ -000122f0: 2061 206e 6577 6c69 6e65 2e20 2054 6869 a newline. Thi │ │ │ │ │ -00012300: 7320 6c69 7374 206f 6620 636f 6d6d 616e s list of comman │ │ │ │ │ -00012310: 6473 0a20 2020 2020 7769 6c6c 2062 6520 ds. will be │ │ │ │ │ -00012320: 6578 6563 7574 6564 2077 6865 6e65 7665 executed wheneve │ │ │ │ │ -00012330: 7220 4e41 4d45 2069 7320 7370 6563 6966 r NAME is specif │ │ │ │ │ -00012340: 6965 6420 6173 2074 6865 206e 616d 6520 ied as the name │ │ │ │ │ -00012350: 6f66 2061 2073 696d 706c 650a 2020 2020 of a simple. │ │ │ │ │ -00012360: 2063 6f6d 6d61 6e64 2e20 2046 756e 6374 command. Funct │ │ │ │ │ -00012370: 696f 6e20 6465 6669 6e69 7469 6f6e 7320 ion definitions │ │ │ │ │ -00012380: 646f 206e 6f74 2061 6666 6563 7420 7468 do not affect th │ │ │ │ │ -00012390: 6520 6578 6974 2073 7461 7475 7320 696e e exit status in │ │ │ │ │ -000123a0: 0a20 2020 2020 2724 3f27 2e20 2057 6865 . '$?'. Whe │ │ │ │ │ -000123b0: 6e20 6578 6563 7574 6564 2c20 7468 6520 n executed, the │ │ │ │ │ -000123c0: 6578 6974 2073 7461 7475 7320 6f66 2061 exit status of a │ │ │ │ │ -000123d0: 2066 756e 6374 696f 6e20 6973 2074 6865 function is the │ │ │ │ │ -000123e0: 2065 7869 740a 2020 2020 2073 7461 7475 exit. statu │ │ │ │ │ -000123f0: 7320 6f66 2074 6865 206c 6173 7420 636f s of the last co │ │ │ │ │ -00012400: 6d6d 616e 6420 6578 6563 7574 6564 2069 mmand executed i │ │ │ │ │ -00012410: 6e20 7468 6520 626f 6479 2e0a 0a6d 656e n the body...men │ │ │ │ │ -00012420: 7565 6e74 7279 2054 4954 4c45 205b 272d uentry TITLE ['- │ │ │ │ │ -00012430: 2d63 6c61 7373 3d63 6c61 7373 2720 2e2e -class=class' .. │ │ │ │ │ -00012440: 2e5d 205b 272d 2d75 7365 7273 3d75 7365 .] ['--users=use │ │ │ │ │ -00012450: 7273 275d 205b 272d 2d75 6e72 6573 7472 rs'] ['--unrestr │ │ │ │ │ -00012460: 6963 7465 6427 5d20 5b27 2d2d 686f 746b icted'] ['--hotk │ │ │ │ │ -00012470: 6579 3d6b 6579 275d 205b 272d 2d69 643d ey=key'] ['--id= │ │ │ │ │ -00012480: 6964 275d 207b 2043 4f4d 4d41 4e44 3b20 id'] { COMMAND; │ │ │ │ │ -00012490: 2e2e 2e20 7d0a 2020 2020 202a 4e6f 7465 ... }. *Note │ │ │ │ │ -000124a0: 206d 656e 7565 6e74 7279 3a3a 2e0a 0a42 menuentry::...B │ │ │ │ │ -000124b0: 7569 6c74 2d69 6e20 436f 6d6d 616e 6473 uilt-in Commands │ │ │ │ │ -000124c0: 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d .=============== │ │ │ │ │ -000124d0: 3d3d 0a0a 536f 6d65 2062 7569 6c74 2d69 ==..Some built-i │ │ │ │ │ -000124e0: 6e20 636f 6d6d 616e 6473 2061 7265 2061 n commands are a │ │ │ │ │ -000124f0: 6c73 6f20 7072 6f76 6964 6564 2062 7920 lso provided by │ │ │ │ │ -00012500: 4752 5542 2073 6372 6970 7420 746f 2068 GRUB script to h │ │ │ │ │ -00012510: 656c 7020 7363 7269 7074 0a77 7269 7465 elp script.write │ │ │ │ │ -00012520: 7273 2070 6572 666f 726d 2061 6374 696f rs perform actio │ │ │ │ │ -00012530: 6e73 2074 6861 7420 6172 6520 6f74 6865 ns that are othe │ │ │ │ │ -00012540: 7277 6973 6520 6e6f 7420 706f 7373 6962 rwise not possib │ │ │ │ │ -00012550: 6c65 2e20 2046 6f72 2065 7861 6d70 6c65 le. For example │ │ │ │ │ -00012560: 2c0a 7468 6573 6520 696e 636c 7564 6520 ,.these include │ │ │ │ │ -00012570: 636f 6d6d 616e 6473 2074 6f20 6a75 6d70 commands to jump │ │ │ │ │ -00012580: 206f 7574 206f 6620 6120 6c6f 6f70 2077 out of a loop w │ │ │ │ │ -00012590: 6974 686f 7574 2066 756c 6c79 2063 6f6d ithout fully com │ │ │ │ │ -000125a0: 706c 6574 696e 670a 6974 2c20 6574 632e pleting.it, etc. │ │ │ │ │ -000125b0: 0a0a 6272 6561 6b20 5b27 6e27 5d0a 2020 ..break ['n']. │ │ │ │ │ -000125c0: 2020 2045 7869 7420 6672 6f6d 2077 6974 Exit from wit │ │ │ │ │ -000125d0: 6869 6e20 6120 2766 6f72 272c 2027 7768 hin a 'for', 'wh │ │ │ │ │ -000125e0: 696c 6527 2c20 6f72 2027 756e 7469 6c27 ile', or 'until' │ │ │ │ │ -000125f0: 206c 6f6f 702e 2020 4966 2027 6e27 2069 loop. If 'n' i │ │ │ │ │ -00012600: 730a 2020 2020 2073 7065 6369 6669 6564 s. specified │ │ │ │ │ -00012610: 2c20 6272 6561 6b20 276e 2720 6c65 7665 , break 'n' leve │ │ │ │ │ -00012620: 6c73 2e20 2027 6e27 206d 7573 7420 6265 ls. 'n' must be │ │ │ │ │ -00012630: 2067 7265 6174 6572 2074 6861 6e20 6f72 greater than or │ │ │ │ │ -00012640: 2065 7175 616c 2074 6f0a 2020 2020 2031 equal to. 1 │ │ │ │ │ -00012650: 2e20 2049 6620 276e 2720 6973 2067 7265 . If 'n' is gre │ │ │ │ │ -00012660: 6174 6572 2074 6861 6e20 7468 6520 6e75 ater than the nu │ │ │ │ │ -00012670: 6d62 6572 206f 6620 656e 636c 6f73 696e mber of enclosin │ │ │ │ │ -00012680: 6720 6c6f 6f70 732c 2061 6c6c 0a20 2020 g loops, all. │ │ │ │ │ -00012690: 2020 656e 636c 6f73 696e 6720 6c6f 6f70 enclosing loop │ │ │ │ │ -000126a0: 7320 6172 6520 6578 6974 6564 2e20 2054 s are exited. T │ │ │ │ │ -000126b0: 6865 2072 6574 7572 6e20 7661 6c75 6520 he return value │ │ │ │ │ -000126c0: 6973 2030 2075 6e6c 6573 7320 276e 2720 is 0 unless 'n' │ │ │ │ │ -000126d0: 6973 0a20 2020 2020 6e6f 7420 6772 6561 is. not grea │ │ │ │ │ -000126e0: 7465 7220 7468 616e 206f 7220 6571 7561 ter than or equa │ │ │ │ │ -000126f0: 6c20 746f 2031 2e0a 0a63 6f6e 7469 6e75 l to 1...continu │ │ │ │ │ -00012700: 6520 5b27 6e27 5d0a 2020 2020 2052 6573 e ['n']. Res │ │ │ │ │ -00012710: 756d 6520 7468 6520 6e65 7874 2069 7465 ume the next ite │ │ │ │ │ -00012720: 7261 7469 6f6e 206f 6620 7468 6520 656e ration of the en │ │ │ │ │ -00012730: 636c 6f73 696e 6720 2766 6f72 272c 2027 closing 'for', ' │ │ │ │ │ -00012740: 7768 696c 6527 206f 720a 2020 2020 2027 while' or. ' │ │ │ │ │ -00012750: 756e 7469 6c27 206c 6f6f 702e 2020 4966 until' loop. If │ │ │ │ │ -00012760: 2027 6e27 2069 7320 7370 6563 6966 6965 'n' is specifie │ │ │ │ │ -00012770: 642c 2072 6573 756d 6520 6174 2074 6865 d, resume at the │ │ │ │ │ -00012780: 2027 6e27 7468 2065 6e63 6c6f 7369 6e67 'n'th enclosing │ │ │ │ │ -00012790: 0a20 2020 2020 6c6f 6f70 2e20 2027 6e27 . loop. 'n' │ │ │ │ │ -000127a0: 206d 7573 7420 6265 2067 7265 6174 6572 must be greater │ │ │ │ │ -000127b0: 2074 6861 6e20 6f72 2065 7175 616c 2074 than or equal t │ │ │ │ │ -000127c0: 6f20 312e 2020 4966 2027 6e27 2069 7320 o 1. If 'n' is │ │ │ │ │ -000127d0: 6772 6561 7465 720a 2020 2020 2074 6861 greater. tha │ │ │ │ │ -000127e0: 6e20 7468 6520 6e75 6d62 6572 206f 6620 n the number of │ │ │ │ │ -000127f0: 656e 636c 6f73 696e 6720 6c6f 6f70 732c enclosing loops, │ │ │ │ │ -00012800: 2074 6865 206c 6173 7420 656e 636c 6f73 the last enclos │ │ │ │ │ -00012810: 696e 6720 6c6f 6f70 2028 7468 650a 2020 ing loop (the. │ │ │ │ │ -00012820: 2020 2022 746f 702d 6c65 7665 6c22 206c "top-level" l │ │ │ │ │ -00012830: 6f6f 7029 2069 7320 7265 7375 6d65 642e oop) is resumed. │ │ │ │ │ -00012840: 2020 5468 6520 7265 7475 726e 2076 616c The return val │ │ │ │ │ -00012850: 7565 2069 7320 3020 756e 6c65 7373 2027 ue is 0 unless ' │ │ │ │ │ -00012860: 6e27 2069 730a 2020 2020 206e 6f74 2067 n' is. not g │ │ │ │ │ -00012870: 7265 6174 6572 2074 6861 6e20 6f72 2065 reater than or e │ │ │ │ │ -00012880: 7175 616c 2074 6f20 312e 0a0a 7265 7475 qual to 1...retu │ │ │ │ │ -00012890: 726e 205b 276e 275d 0a20 2020 2020 4361 rn ['n']. Ca │ │ │ │ │ -000128a0: 7573 6573 2061 2066 756e 6374 696f 6e20 uses a function │ │ │ │ │ -000128b0: 746f 2065 7869 7420 7769 7468 2074 6865 to exit with the │ │ │ │ │ -000128c0: 2072 6574 7572 6e20 7661 6c75 6520 7370 return value sp │ │ │ │ │ -000128d0: 6563 6966 6965 6420 6279 2027 6e27 2e0a ecified by 'n'.. │ │ │ │ │ -000128e0: 2020 2020 2049 6620 276e 2720 6973 206f If 'n' is o │ │ │ │ │ -000128f0: 6d69 7474 6564 2c20 7468 6520 7265 7475 mitted, the retu │ │ │ │ │ -00012900: 726e 2073 7461 7475 7320 6973 2074 6861 rn status is tha │ │ │ │ │ -00012910: 7420 6f66 2074 6865 206c 6173 7420 636f t of the last co │ │ │ │ │ -00012920: 6d6d 616e 640a 2020 2020 2065 7865 6375 mmand. execu │ │ │ │ │ -00012930: 7465 6420 696e 2074 6865 2066 756e 6374 ted in the funct │ │ │ │ │ -00012940: 696f 6e20 626f 6479 2e20 2049 6620 7573 ion body. If us │ │ │ │ │ -00012950: 6564 206f 7574 7369 6465 2061 2066 756e ed outside a fun │ │ │ │ │ -00012960: 6374 696f 6e20 7468 650a 2020 2020 2072 ction the. r │ │ │ │ │ -00012970: 6574 7572 6e20 7374 6174 7573 2069 7320 eturn status is │ │ │ │ │ -00012980: 6661 6c73 652e 0a0a 7365 7470 6172 616d false...setparam │ │ │ │ │ -00012990: 7320 5b27 6172 6727 5d20 2e2e 2e0a 2020 s ['arg'] .... │ │ │ │ │ -000129a0: 2020 2052 6570 6c61 6365 2070 6f73 6974 Replace posit │ │ │ │ │ -000129b0: 696f 6e61 6c20 7061 7261 6d65 7465 7273 ional parameters │ │ │ │ │ -000129c0: 2073 7461 7274 696e 6720 7769 7468 2027 starting with ' │ │ │ │ │ -000129d0: 2431 2720 7769 7468 2061 7267 756d 656e $1' with argumen │ │ │ │ │ -000129e0: 7473 2074 6f0a 2020 2020 2027 7365 7470 ts to. 'setp │ │ │ │ │ -000129f0: 6172 616d 7327 2e0a 0a73 6869 6674 205b arams'...shift [ │ │ │ │ │ -00012a00: 276e 275d 0a20 2020 2020 5468 6520 706f 'n']. The po │ │ │ │ │ -00012a10: 7369 7469 6f6e 616c 2070 6172 616d 6574 sitional paramet │ │ │ │ │ -00012a20: 6572 7320 6672 6f6d 2027 6e27 2b31 202e ers from 'n'+1 . │ │ │ │ │ -00012a30: 2e2e 2061 7265 2072 656e 616d 6564 2074 .. are renamed t │ │ │ │ │ -00012a40: 6f20 2724 3127 2e2e 2e2e 0a20 2020 2020 o '$1'..... │ │ │ │ │ -00012a50: 5061 7261 6d65 7465 7273 2072 6570 7265 Parameters repre │ │ │ │ │ -00012a60: 7365 6e74 6564 2062 7920 7468 6520 6e75 sented by the nu │ │ │ │ │ -00012a70: 6d62 6572 7320 2724 2327 2064 6f77 6e20 mbers '$#' down │ │ │ │ │ -00012a80: 746f 2027 2423 272d 276e 272b 3120 6172 to '$#'-'n'+1 ar │ │ │ │ │ -00012a90: 650a 2020 2020 2075 6e73 6574 2e20 2027 e. unset. ' │ │ │ │ │ -00012aa0: 6e27 206d 7573 7420 6265 2061 206e 6f6e n' must be a non │ │ │ │ │ -00012ab0: 2d6e 6567 6174 6976 6520 6e75 6d62 6572 -negative number │ │ │ │ │ -00012ac0: 206c 6573 7320 7468 616e 206f 7220 6571 less than or eq │ │ │ │ │ -00012ad0: 7561 6c20 746f 0a20 2020 2020 2724 2327 ual to. '$#' │ │ │ │ │ -00012ae0: 2e20 2049 6620 276e 2720 6973 2030 2c20 . If 'n' is 0, │ │ │ │ │ -00012af0: 6e6f 2070 6172 616d 6574 6572 7320 6172 no parameters ar │ │ │ │ │ -00012b00: 6520 6368 616e 6765 642e 2020 4966 2027 e changed. If ' │ │ │ │ │ -00012b10: 6e27 2069 7320 6e6f 740a 2020 2020 2067 n' is not. g │ │ │ │ │ -00012b20: 6976 656e 2c20 6974 2069 7320 6173 7375 iven, it is assu │ │ │ │ │ -00012b30: 6d65 6420 746f 2062 6520 312e 2020 4966 med to be 1. If │ │ │ │ │ -00012b40: 2027 6e27 2069 7320 6772 6561 7465 7220 'n' is greater │ │ │ │ │ -00012b50: 7468 616e 2027 2423 272c 2074 6865 0a20 than '$#', the. │ │ │ │ │ -00012b60: 2020 2020 706f 7369 7469 6f6e 616c 2070 positional p │ │ │ │ │ -00012b70: 6172 616d 6574 6572 7320 6172 6520 6e6f arameters are no │ │ │ │ │ -00012b80: 7420 6368 616e 6765 642e 2020 5468 6520 t changed. The │ │ │ │ │ -00012b90: 7265 7475 726e 2073 7461 7475 7320 6973 return status is │ │ │ │ │ -00012ba0: 0a20 2020 2020 6772 6561 7465 7220 7468 . greater th │ │ │ │ │ -00012bb0: 616e 207a 6572 6f20 6966 2027 6e27 2069 an zero if 'n' i │ │ │ │ │ -00012bc0: 7320 6772 6561 7465 7220 7468 616e 2027 s greater than ' │ │ │ │ │ -00012bd0: 2423 2720 6f72 206c 6573 7320 7468 616e $#' or less than │ │ │ │ │ -00012be0: 207a 6572 6f3b 0a20 2020 2020 6f74 6865 zero;. othe │ │ │ │ │ -00012bf0: 7277 6973 6520 302e 0a0a 1f0a 4669 6c65 rwise 0.....File │ │ │ │ │ -00012c00: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ -00012c10: 6465 3a20 5368 656c 6c2d 6c69 6b65 2073 de: Shell-like s │ │ │ │ │ -00012c20: 6372 6970 7469 6e67 2d46 6f6f 746e 6f74 cripting-Footnot │ │ │ │ │ -00012c30: 6573 2c20 2055 703a 2053 6865 6c6c 2d6c es, Up: Shell-l │ │ │ │ │ -00012c40: 696b 6520 7363 7269 7074 696e 670a 0a20 ike scripting.. │ │ │ │ │ -00012c50: 2020 2831 2920 4375 7272 656e 746c 7920 (1) Currently │ │ │ │ │ -00012c60: 6120 6261 636b 736c 6173 682d 6e65 776c a backslash-newl │ │ │ │ │ -00012c70: 696e 6520 7061 6972 2077 6974 6869 6e20 ine pair within │ │ │ │ │ -00012c80: 6120 7661 7269 6162 6c65 206e 616d 6520 a variable name │ │ │ │ │ -00012c90: 6973 206e 6f74 0a68 616e 646c 6564 2070 is not.handled p │ │ │ │ │ -00012ca0: 726f 7065 726c 792c 2073 6f20 7573 6520 roperly, so use │ │ │ │ │ -00012cb0: 7468 6973 2066 6561 7475 7265 2077 6974 this feature wit │ │ │ │ │ -00012cc0: 6820 736f 6d65 2063 6172 652e 0a0a 1f0a h some care..... │ │ │ │ │ -00012cd0: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ -00012ce0: 2020 4e6f 6465 3a20 4d75 6c74 692d 626f Node: Multi-bo │ │ │ │ │ -00012cf0: 6f74 206d 616e 7561 6c20 636f 6e66 6967 ot manual config │ │ │ │ │ -00012d00: 2c20 204e 6578 743a 2045 6d62 6564 6465 , Next: Embedde │ │ │ │ │ -00012d10: 6420 636f 6e66 6967 7572 6174 696f 6e2c d configuration, │ │ │ │ │ -00012d20: 2020 5072 6576 3a20 5368 656c 6c2d 6c69 Prev: Shell-li │ │ │ │ │ -00012d30: 6b65 2073 6372 6970 7469 6e67 2c20 2055 ke scripting, U │ │ │ │ │ -00012d40: 703a 2043 6f6e 6669 6775 7261 7469 6f6e p: Configuration │ │ │ │ │ -00012d50: 0a0a 362e 3420 4d75 6c74 692d 626f 6f74 ..6.4 Multi-boot │ │ │ │ │ -00012d60: 206d 616e 7561 6c20 636f 6e66 6967 0a3d manual config.= │ │ │ │ │ +00010d50: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a ===============. │ │ │ │ │ +00010d60: 0a27 6772 7562 2e63 6667 2720 6973 2077 .'grub.cfg' is w │ │ │ │ │ +00010d70: 7269 7474 656e 2069 6e20 4752 5542 2773 ritten in GRUB's │ │ │ │ │ +00010d80: 2062 7569 6c74 2d69 6e20 7363 7269 7074 built-in script │ │ │ │ │ +00010d90: 696e 6720 6c61 6e67 7561 6765 2c20 7768 ing language, wh │ │ │ │ │ +00010da0: 6963 6820 6861 7320 610a 7379 6e74 6178 ich has a.syntax │ │ │ │ │ +00010db0: 2071 7569 7465 2073 696d 696c 6172 2074 quite similar t │ │ │ │ │ +00010dc0: 6f20 7468 6174 206f 6620 474e 5520 4261 o that of GNU Ba │ │ │ │ │ +00010dd0: 7368 2061 6e64 206f 7468 6572 2042 6f75 sh and other Bou │ │ │ │ │ +00010de0: 726e 6520 7368 656c 6c0a 6465 7269 7661 rne shell.deriva │ │ │ │ │ +00010df0: 7469 7665 732e 0a0a 576f 7264 730a 3d3d tives...Words.== │ │ │ │ │ +00010e00: 3d3d 3d0a 0a41 2022 776f 7264 2220 6973 ===..A "word" is │ │ │ │ │ +00010e10: 2061 2073 6571 7565 6e63 6520 6f66 2063 a sequence of c │ │ │ │ │ +00010e20: 6861 7261 6374 6572 7320 636f 6e73 6964 haracters consid │ │ │ │ │ +00010e30: 6572 6564 2061 7320 6120 7369 6e67 6c65 ered as a single │ │ │ │ │ +00010e40: 2075 6e69 7420 6279 0a47 5255 422e 2057 unit by.GRUB. W │ │ │ │ │ +00010e50: 6f72 6473 2061 7265 2073 6570 6172 6174 ords are separat │ │ │ │ │ +00010e60: 6564 2062 7920 226d 6574 6163 6861 7261 ed by "metachara │ │ │ │ │ +00010e70: 6374 6572 7322 2c20 7768 6963 6820 6172 cters", which ar │ │ │ │ │ +00010e80: 6520 7468 6520 666f 6c6c 6f77 696e 670a e the following. │ │ │ │ │ +00010e90: 706c 7573 2073 7061 6365 2c20 7461 622c plus space, tab, │ │ │ │ │ +00010ea0: 2061 6e64 206e 6577 6c69 6e65 3a0a 0a20 and newline:.. │ │ │ │ │ +00010eb0: 2020 2020 7b20 7d20 7c20 2620 2420 3b20 { } | & $ ; │ │ │ │ │ +00010ec0: 3c20 3e0a 0a20 2020 5175 6f74 696e 6720 < >.. Quoting │ │ │ │ │ +00010ed0: 6d61 7920 6265 2075 7365 6420 746f 2069 may be used to i │ │ │ │ │ +00010ee0: 6e63 6c75 6465 206d 6574 6163 6861 7261 nclude metachara │ │ │ │ │ +00010ef0: 6374 6572 7320 696e 2077 6f72 6473 3b20 cters in words; │ │ │ │ │ +00010f00: 7365 6520 6265 6c6f 772e 0a0a 5265 7365 see below...Rese │ │ │ │ │ +00010f10: 7276 6564 2077 6f72 6473 0a3d 3d3d 3d3d rved words.===== │ │ │ │ │ +00010f20: 3d3d 3d3d 3d3d 3d3d 3d0a 0a52 6573 6572 =========..Reser │ │ │ │ │ +00010f30: 7665 6420 776f 7264 7320 6861 7665 2061 ved words have a │ │ │ │ │ +00010f40: 2073 7065 6369 616c 206d 6561 6e69 6e67 special meaning │ │ │ │ │ +00010f50: 2074 6f20 4752 5542 2e20 5468 6520 666f to GRUB. The fo │ │ │ │ │ +00010f60: 6c6c 6f77 696e 6720 776f 7264 7320 6172 llowing words ar │ │ │ │ │ +00010f70: 650a 7265 636f 676e 6973 6564 2061 7320 e.recognised as │ │ │ │ │ +00010f80: 7265 7365 7276 6564 2077 6865 6e20 756e reserved when un │ │ │ │ │ +00010f90: 7175 6f74 6564 2061 6e64 2065 6974 6865 quoted and eithe │ │ │ │ │ +00010fa0: 7220 7468 6520 6669 7273 7420 776f 7264 r the first word │ │ │ │ │ +00010fb0: 206f 6620 610a 7369 6d70 6c65 2063 6f6d of a.simple com │ │ │ │ │ +00010fc0: 6d61 6e64 206f 7220 7468 6520 7468 6972 mand or the thir │ │ │ │ │ +00010fd0: 6420 776f 7264 206f 6620 6120 2766 6f72 d word of a 'for │ │ │ │ │ +00010fe0: 2720 636f 6d6d 616e 643a 0a0a 2020 2020 ' command:.. │ │ │ │ │ +00010ff0: 2021 205b 5b20 5d5d 207b 207d 0a20 2020 ! [[ ]] { }. │ │ │ │ │ +00011000: 2020 6361 7365 2064 6f20 646f 6e65 2065 case do done e │ │ │ │ │ +00011010: 6c69 6620 656c 7365 2065 7361 6320 6669 lif else esac fi │ │ │ │ │ +00011020: 2066 6f72 2066 756e 6374 696f 6e0a 2020 for function. │ │ │ │ │ +00011030: 2020 2069 6620 696e 206d 656e 7565 6e74 if in menuent │ │ │ │ │ +00011040: 7279 2073 656c 6563 7420 7468 656e 2074 ry select then t │ │ │ │ │ +00011050: 696d 6520 756e 7469 6c20 7768 696c 650a ime until while. │ │ │ │ │ +00011060: 0a20 2020 4e6f 7420 616c 6c20 6f66 2074 . Not all of t │ │ │ │ │ +00011070: 6865 7365 2072 6573 6572 7665 6420 776f hese reserved wo │ │ │ │ │ +00011080: 7264 7320 6861 7665 2061 2075 7365 6675 rds have a usefu │ │ │ │ │ +00011090: 6c20 7075 7270 6f73 6520 7965 743b 2073 l purpose yet; s │ │ │ │ │ +000110a0: 6f6d 6520 6172 650a 7265 7365 7276 6564 ome are.reserved │ │ │ │ │ +000110b0: 2066 6f72 2066 7574 7572 6520 6578 7061 for future expa │ │ │ │ │ +000110c0: 6e73 696f 6e2e 0a0a 5175 6f74 696e 670a nsion...Quoting. │ │ │ │ │ +000110d0: 3d3d 3d3d 3d3d 3d0a 0a51 756f 7469 6e67 =======..Quoting │ │ │ │ │ +000110e0: 2069 7320 7573 6564 2074 6f20 7265 6d6f is used to remo │ │ │ │ │ +000110f0: 7665 2074 6865 2073 7065 6369 616c 206d ve the special m │ │ │ │ │ +00011100: 6561 6e69 6e67 206f 6620 6365 7274 6169 eaning of certai │ │ │ │ │ +00011110: 6e20 6368 6172 6163 7465 7273 206f 720a n characters or. │ │ │ │ │ +00011120: 776f 7264 732e 2020 4974 2063 616e 2062 words. It can b │ │ │ │ │ +00011130: 6520 7573 6564 2074 6f20 7472 6561 7420 e used to treat │ │ │ │ │ +00011140: 6d65 7461 6368 6172 6163 7465 7273 2061 metacharacters a │ │ │ │ │ +00011150: 7320 7061 7274 206f 6620 6120 776f 7264 s part of a word │ │ │ │ │ +00011160: 2c20 746f 0a70 7265 7665 6e74 2072 6573 , to.prevent res │ │ │ │ │ +00011170: 6572 7665 6420 776f 7264 7320 6672 6f6d erved words from │ │ │ │ │ +00011180: 2062 6569 6e67 2072 6563 6f67 6e69 7365 being recognise │ │ │ │ │ +00011190: 6420 6173 2073 7563 682c 2061 6e64 2074 d as such, and t │ │ │ │ │ +000111a0: 6f20 7072 6576 656e 740a 7661 7269 6162 o prevent.variab │ │ │ │ │ +000111b0: 6c65 2065 7870 616e 7369 6f6e 2e0a 0a20 le expansion... │ │ │ │ │ +000111c0: 2020 5468 6572 6520 6172 6520 7468 7265 There are thre │ │ │ │ │ +000111d0: 6520 7175 6f74 696e 6720 6d65 6368 616e e quoting mechan │ │ │ │ │ +000111e0: 6973 6d73 3a20 7468 6520 6573 6361 7065 isms: the escape │ │ │ │ │ +000111f0: 2063 6861 7261 6374 6572 2c20 7369 6e67 character, sing │ │ │ │ │ +00011200: 6c65 0a71 756f 7465 732c 2061 6e64 2064 le.quotes, and d │ │ │ │ │ +00011210: 6f75 626c 6520 7175 6f74 6573 2e0a 0a20 ouble quotes... │ │ │ │ │ +00011220: 2020 4120 6e6f 6e2d 7175 6f74 6564 2062 A non-quoted b │ │ │ │ │ +00011230: 6163 6b73 6c61 7368 2028 5c29 2069 7320 ackslash (\) is │ │ │ │ │ +00011240: 7468 6520 2265 7363 6170 6520 6368 6172 the "escape char │ │ │ │ │ +00011250: 6163 7465 7222 2e20 2049 7420 7072 6573 acter". It pres │ │ │ │ │ +00011260: 6572 7665 730a 7468 6520 6c69 7465 7261 erves.the litera │ │ │ │ │ +00011270: 6c20 7661 6c75 6520 6f66 2074 6865 206e l value of the n │ │ │ │ │ +00011280: 6578 7420 6368 6172 6163 7465 7220 7468 ext character th │ │ │ │ │ +00011290: 6174 2066 6f6c 6c6f 7773 2c20 7769 7468 at follows, with │ │ │ │ │ +000112a0: 2074 6865 2065 7863 6570 7469 6f6e 0a6f the exception.o │ │ │ │ │ +000112b0: 6620 6e65 776c 696e 652e 0a0a 2020 2045 f newline... E │ │ │ │ │ +000112c0: 6e63 6c6f 7369 6e67 2063 6861 7261 6374 nclosing charact │ │ │ │ │ +000112d0: 6572 7320 696e 2073 696e 676c 6520 7175 ers in single qu │ │ │ │ │ +000112e0: 6f74 6573 2070 7265 7365 7276 6573 2074 otes preserves t │ │ │ │ │ +000112f0: 6865 206c 6974 6572 616c 2076 616c 7565 he literal value │ │ │ │ │ +00011300: 206f 660a 6561 6368 2063 6861 7261 6374 of.each charact │ │ │ │ │ +00011310: 6572 2077 6974 6869 6e20 7468 6520 7175 er within the qu │ │ │ │ │ +00011320: 6f74 6573 2e20 2041 2073 696e 676c 6520 otes. A single │ │ │ │ │ +00011330: 7175 6f74 6520 6d61 7920 6e6f 7420 6f63 quote may not oc │ │ │ │ │ +00011340: 6375 7220 6265 7477 6565 6e0a 7369 6e67 cur between.sing │ │ │ │ │ +00011350: 6c65 2071 756f 7465 732c 2065 7665 6e20 le quotes, even │ │ │ │ │ +00011360: 7768 656e 2070 7265 6365 6465 6420 6279 when preceded by │ │ │ │ │ +00011370: 2061 2062 6163 6b73 6c61 7368 2e0a 0a20 a backslash... │ │ │ │ │ +00011380: 2020 456e 636c 6f73 696e 6720 6368 6172 Enclosing char │ │ │ │ │ +00011390: 6163 7465 7273 2069 6e20 646f 7562 6c65 acters in double │ │ │ │ │ +000113a0: 2071 756f 7465 7320 7072 6573 6572 7665 quotes preserve │ │ │ │ │ +000113b0: 7320 7468 6520 6c69 7465 7261 6c20 7661 s the literal va │ │ │ │ │ +000113c0: 6c75 6520 6f66 0a61 6c6c 2063 6861 7261 lue of.all chara │ │ │ │ │ +000113d0: 6374 6572 7320 7769 7468 696e 2074 6865 cters within the │ │ │ │ │ +000113e0: 2071 756f 7465 732c 2077 6974 6820 7468 quotes, with th │ │ │ │ │ +000113f0: 6520 6578 6365 7074 696f 6e20 6f66 2027 e exception of ' │ │ │ │ │ +00011400: 2427 2061 6e64 2027 5c27 2e0a 5468 6520 $' and '\'..The │ │ │ │ │ +00011410: 2724 2720 6368 6172 6163 7465 7220 7265 '$' character re │ │ │ │ │ +00011420: 7461 696e 7320 6974 7320 7370 6563 6961 tains its specia │ │ │ │ │ +00011430: 6c20 6d65 616e 696e 6720 7769 7468 696e l meaning within │ │ │ │ │ +00011440: 2064 6f75 626c 6520 7175 6f74 6573 2e20 double quotes. │ │ │ │ │ +00011450: 2054 6865 0a62 6163 6b73 6c61 7368 2072 The.backslash r │ │ │ │ │ +00011460: 6574 6169 6e73 2069 7473 2073 7065 6369 etains its speci │ │ │ │ │ +00011470: 616c 206d 6561 6e69 6e67 206f 6e6c 7920 al meaning only │ │ │ │ │ +00011480: 7768 656e 2066 6f6c 6c6f 7765 6420 6279 when followed by │ │ │ │ │ +00011490: 206f 6e65 206f 6620 7468 650a 666f 6c6c one of the.foll │ │ │ │ │ +000114a0: 6f77 696e 6720 6368 6172 6163 7465 7273 owing characters │ │ │ │ │ +000114b0: 3a20 2724 272c 2027 2227 2c20 275c 272c : '$', '"', '\', │ │ │ │ │ +000114c0: 206f 7220 6e65 776c 696e 652e 2020 4120 or newline. A │ │ │ │ │ +000114d0: 6261 636b 736c 6173 682d 6e65 776c 696e backslash-newlin │ │ │ │ │ +000114e0: 650a 7061 6972 2069 7320 7472 6561 7465 e.pair is treate │ │ │ │ │ +000114f0: 6420 6173 2061 206c 696e 6520 636f 6e74 d as a line cont │ │ │ │ │ +00011500: 696e 7561 7469 6f6e 2028 7468 6174 2069 inuation (that i │ │ │ │ │ +00011510: 732c 2069 7420 6973 2072 656d 6f76 6564 s, it is removed │ │ │ │ │ +00011520: 2066 726f 6d20 7468 650a 696e 7075 7420 from the.input │ │ │ │ │ +00011530: 7374 7265 616d 2061 6e64 2065 6666 6563 stream and effec │ │ │ │ │ +00011540: 7469 7665 6c79 2069 676e 6f72 6564 2831 tively ignored(1 │ │ │ │ │ +00011550: 2920 282a 6e6f 7465 2053 6865 6c6c 2d6c ) (*note Shell-l │ │ │ │ │ +00011560: 696b 650a 7363 7269 7074 696e 672d 466f ike.scripting-Fo │ │ │ │ │ +00011570: 6f74 6e6f 7465 2d31 3a3a 2929 2e20 2041 otnote-1::)). A │ │ │ │ │ +00011580: 2064 6f75 626c 6520 7175 6f74 6520 6d61 double quote ma │ │ │ │ │ +00011590: 7920 6265 2071 756f 7465 6420 7769 7468 y be quoted with │ │ │ │ │ +000115a0: 696e 2064 6f75 626c 650a 7175 6f74 6573 in double.quotes │ │ │ │ │ +000115b0: 2062 7920 7072 6563 6564 696e 6720 6974 by preceding it │ │ │ │ │ +000115c0: 2077 6974 6820 6120 6261 636b 736c 6173 with a backslas │ │ │ │ │ +000115d0: 682e 0a0a 5661 7269 6162 6c65 2065 7870 h...Variable exp │ │ │ │ │ +000115e0: 616e 7369 6f6e 0a3d 3d3d 3d3d 3d3d 3d3d ansion.========= │ │ │ │ │ +000115f0: 3d3d 3d3d 3d3d 3d3d 3d0a 0a54 6865 2027 =========..The ' │ │ │ │ │ +00011600: 2427 2063 6861 7261 6374 6572 2069 6e74 $' character int │ │ │ │ │ +00011610: 726f 6475 6365 7320 7661 7269 6162 6c65 roduces variable │ │ │ │ │ +00011620: 2065 7870 616e 7369 6f6e 2e20 2054 6865 expansion. The │ │ │ │ │ +00011630: 2076 6172 6961 626c 6520 6e61 6d65 2074 variable name t │ │ │ │ │ +00011640: 6f0a 6265 2065 7870 616e 6465 6420 6d61 o.be expanded ma │ │ │ │ │ +00011650: 7920 6265 2065 6e63 6c6f 7365 6420 696e y be enclosed in │ │ │ │ │ +00011660: 2062 7261 6365 732c 2077 6869 6368 2061 braces, which a │ │ │ │ │ +00011670: 7265 206f 7074 696f 6e61 6c20 6275 7420 re optional but │ │ │ │ │ +00011680: 7365 7276 6520 746f 0a70 726f 7465 6374 serve to.protect │ │ │ │ │ +00011690: 2074 6865 2076 6172 6961 626c 6520 746f the variable to │ │ │ │ │ +000116a0: 2062 6520 6578 7061 6e64 6564 2066 726f be expanded fro │ │ │ │ │ +000116b0: 6d20 6368 6172 6163 7465 7273 2069 6d6d m characters imm │ │ │ │ │ +000116c0: 6564 6961 7465 6c79 0a66 6f6c 6c6f 7769 ediately.followi │ │ │ │ │ +000116d0: 6e67 2069 7420 7768 6963 6820 636f 756c ng it which coul │ │ │ │ │ +000116e0: 6420 6265 2069 6e74 6572 7072 6574 6564 d be interpreted │ │ │ │ │ +000116f0: 2061 7320 7061 7274 206f 6620 7468 6520 as part of the │ │ │ │ │ +00011700: 6e61 6d65 2e0a 0a20 2020 4e6f 726d 616c name... Normal │ │ │ │ │ +00011710: 2076 6172 6961 626c 6520 6e61 6d65 7320 variable names │ │ │ │ │ +00011720: 6265 6769 6e20 7769 7468 2061 6e20 616c begin with an al │ │ │ │ │ +00011730: 7068 6162 6574 6963 2063 6861 7261 6374 phabetic charact │ │ │ │ │ +00011740: 6572 2c20 666f 6c6c 6f77 6564 2062 790a er, followed by. │ │ │ │ │ +00011750: 7a65 726f 206f 7220 6d6f 7265 2061 6c70 zero or more alp │ │ │ │ │ +00011760: 6861 6e75 6d65 7269 6320 6368 6172 6163 hanumeric charac │ │ │ │ │ +00011770: 7465 7273 2e20 2054 6865 7365 206e 616d ters. These nam │ │ │ │ │ +00011780: 6573 2072 6566 6572 2074 6f20 656e 7472 es refer to entr │ │ │ │ │ +00011790: 6965 7320 696e 0a74 6865 2047 5255 4220 ies in.the GRUB │ │ │ │ │ +000117a0: 656e 7669 726f 6e6d 656e 7420 282a 6e6f environment (*no │ │ │ │ │ +000117b0: 7465 2045 6e76 6972 6f6e 6d65 6e74 3a3a te Environment:: │ │ │ │ │ +000117c0: 292e 0a0a 2020 2050 6f73 6974 696f 6e61 )... Positiona │ │ │ │ │ +000117d0: 6c20 7661 7269 6162 6c65 206e 616d 6573 l variable names │ │ │ │ │ +000117e0: 2063 6f6e 7369 7374 206f 6620 6f6e 6520 consist of one │ │ │ │ │ +000117f0: 6f72 206d 6f72 6520 6469 6769 7473 2e20 or more digits. │ │ │ │ │ +00011800: 2054 6865 790a 7265 7072 6573 656e 7420 They.represent │ │ │ │ │ +00011810: 7061 7261 6d65 7465 7273 2070 6173 7365 parameters passe │ │ │ │ │ +00011820: 6420 746f 2066 756e 6374 696f 6e20 6361 d to function ca │ │ │ │ │ +00011830: 6c6c 732c 2077 6974 6820 2724 3127 2072 lls, with '$1' r │ │ │ │ │ +00011840: 6570 7265 7365 6e74 696e 670a 7468 6520 epresenting.the │ │ │ │ │ +00011850: 6669 7273 7420 7061 7261 6d65 7465 722c first parameter, │ │ │ │ │ +00011860: 2061 6e64 2073 6f20 6f6e 2e0a 0a20 2020 and so on... │ │ │ │ │ +00011870: 5468 6520 7370 6563 6961 6c20 7661 7269 The special vari │ │ │ │ │ +00011880: 6162 6c65 206e 616d 6520 273f 2720 6578 able name '?' ex │ │ │ │ │ +00011890: 7061 6e64 7320 746f 2074 6865 2065 7869 pands to the exi │ │ │ │ │ +000118a0: 7420 7374 6174 7573 206f 6620 7468 6520 t status of the │ │ │ │ │ +000118b0: 6d6f 7374 0a72 6563 656e 746c 7920 6578 most.recently ex │ │ │ │ │ +000118c0: 6563 7574 6564 2063 6f6d 6d61 6e64 2e20 ecuted command. │ │ │ │ │ +000118d0: 2057 6865 6e20 706f 7369 7469 6f6e 616c When positional │ │ │ │ │ +000118e0: 2076 6172 6961 626c 6520 6e61 6d65 7320 variable names │ │ │ │ │ +000118f0: 6172 6520 6163 7469 7665 2c0a 6f74 6865 are active,.othe │ │ │ │ │ +00011900: 7220 7370 6563 6961 6c20 7661 7269 6162 r special variab │ │ │ │ │ +00011910: 6c65 206e 616d 6573 2027 4027 2c20 272a le names '@', '* │ │ │ │ │ +00011920: 2720 616e 6420 2723 2720 6172 6520 6465 ' and '#' are de │ │ │ │ │ +00011930: 6669 6e65 6420 616e 6420 7468 6579 0a65 fined and they.e │ │ │ │ │ +00011940: 7870 616e 6420 746f 2061 6c6c 2070 6f73 xpand to all pos │ │ │ │ │ +00011950: 6974 696f 6e61 6c20 7061 7261 6d65 7465 itional paramete │ │ │ │ │ +00011960: 7273 2077 6974 6820 6e65 6365 7373 6172 rs with necessar │ │ │ │ │ +00011970: 7920 7175 6f74 696e 672c 2070 6f73 6974 y quoting, posit │ │ │ │ │ +00011980: 696f 6e61 6c0a 7061 7261 6d65 7465 7273 ional.parameters │ │ │ │ │ +00011990: 2077 6974 686f 7574 2061 6e79 2071 756f without any quo │ │ │ │ │ +000119a0: 7469 6e67 2c20 616e 6420 706f 7369 7469 ting, and positi │ │ │ │ │ +000119b0: 6f6e 616c 2070 6172 616d 6574 6572 2063 onal parameter c │ │ │ │ │ +000119c0: 6f75 6e74 0a72 6573 7065 6374 6976 656c ount.respectivel │ │ │ │ │ +000119d0: 792e 0a0a 436f 6d6d 656e 7473 0a3d 3d3d y...Comments.=== │ │ │ │ │ +000119e0: 3d3d 3d3d 3d0a 0a41 2077 6f72 6420 6265 =====..A word be │ │ │ │ │ +000119f0: 6769 6e6e 696e 6720 7769 7468 2027 2327 ginning with '#' │ │ │ │ │ +00011a00: 2063 6175 7365 7320 7468 6174 2077 6f72 causes that wor │ │ │ │ │ +00011a10: 6420 616e 6420 616c 6c20 7265 6d61 696e d and all remain │ │ │ │ │ +00011a20: 696e 6720 6368 6172 6163 7465 7273 0a6f ing characters.o │ │ │ │ │ +00011a30: 6e20 7468 6174 206c 696e 6520 746f 2062 n that line to b │ │ │ │ │ +00011a40: 6520 6967 6e6f 7265 642e 0a0a 5369 6d70 e ignored...Simp │ │ │ │ │ +00011a50: 6c65 2063 6f6d 6d61 6e64 730a 3d3d 3d3d le commands.==== │ │ │ │ │ +00011a60: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a41 2022 ===========..A " │ │ │ │ │ +00011a70: 7369 6d70 6c65 2063 6f6d 6d61 6e64 2220 simple command" │ │ │ │ │ +00011a80: 6973 2061 2073 6571 7565 6e63 6520 6f66 is a sequence of │ │ │ │ │ +00011a90: 2077 6f72 6473 2073 6570 6172 6174 6564 words separated │ │ │ │ │ +00011aa0: 2062 7920 7370 6163 6573 206f 7220 7461 by spaces or ta │ │ │ │ │ +00011ab0: 6273 0a61 6e64 2074 6572 6d69 6e61 7465 bs.and terminate │ │ │ │ │ +00011ac0: 6420 6279 2061 2073 656d 6963 6f6c 6f6e d by a semicolon │ │ │ │ │ +00011ad0: 206f 7220 6120 6e65 776c 696e 652e 2020 or a newline. │ │ │ │ │ +00011ae0: 5468 6520 6669 7273 7420 776f 7264 2073 The first word s │ │ │ │ │ +00011af0: 7065 6369 6669 6573 0a74 6865 2063 6f6d pecifies.the com │ │ │ │ │ +00011b00: 6d61 6e64 2074 6f20 6265 2065 7865 6375 mand to be execu │ │ │ │ │ +00011b10: 7465 642e 2020 5468 6520 7265 6d61 696e ted. The remain │ │ │ │ │ +00011b20: 696e 6720 776f 7264 7320 6172 6520 7061 ing words are pa │ │ │ │ │ +00011b30: 7373 6564 2061 7320 6172 6775 6d65 6e74 ssed as argument │ │ │ │ │ +00011b40: 730a 746f 2074 6865 2069 6e76 6f6b 6564 s.to the invoked │ │ │ │ │ +00011b50: 2063 6f6d 6d61 6e64 2e0a 0a20 2020 5468 command... Th │ │ │ │ │ +00011b60: 6520 7265 7475 726e 2076 616c 7565 206f e return value o │ │ │ │ │ +00011b70: 6620 6120 7369 6d70 6c65 2063 6f6d 6d61 f a simple comma │ │ │ │ │ +00011b80: 6e64 2069 7320 6974 7320 6578 6974 2073 nd is its exit s │ │ │ │ │ +00011b90: 7461 7475 732e 2020 4966 2074 6865 0a72 tatus. If the.r │ │ │ │ │ +00011ba0: 6573 6572 7665 6420 776f 7264 2027 2127 eserved word '!' │ │ │ │ │ +00011bb0: 2070 7265 6365 6465 7320 7468 6520 636f precedes the co │ │ │ │ │ +00011bc0: 6d6d 616e 642c 2074 6865 6e20 7468 6520 mmand, then the │ │ │ │ │ +00011bd0: 7265 7475 726e 2076 616c 7565 2069 7320 return value is │ │ │ │ │ +00011be0: 696e 7374 6561 640a 7468 6520 6c6f 6769 instead.the logi │ │ │ │ │ +00011bf0: 6361 6c20 6e65 6761 7469 6f6e 206f 6620 cal negation of │ │ │ │ │ +00011c00: 7468 6520 636f 6d6d 616e 6427 7320 6578 the command's ex │ │ │ │ │ +00011c10: 6974 2073 7461 7475 732e 0a0a 436f 6d70 it status...Comp │ │ │ │ │ +00011c20: 6f75 6e64 2063 6f6d 6d61 6e64 730a 3d3d ound commands.== │ │ │ │ │ +00011c30: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a ===============. │ │ │ │ │ +00011c40: 0a41 2022 636f 6d70 6f75 6e64 2063 6f6d .A "compound com │ │ │ │ │ +00011c50: 6d61 6e64 2220 6973 206f 6e65 206f 6620 mand" is one of │ │ │ │ │ +00011c60: 7468 6520 666f 6c6c 6f77 696e 673a 0a0a the following:.. │ │ │ │ │ +00011c70: 666f 7220 4e41 4d45 2069 6e20 574f 5244 for NAME in WORD │ │ │ │ │ +00011c80: 202e 2e2e 3b20 646f 204c 4953 543b 2064 ...; do LIST; d │ │ │ │ │ +00011c90: 6f6e 650a 2020 2020 2054 6865 206c 6973 one. The lis │ │ │ │ │ +00011ca0: 7420 6f66 2077 6f72 6473 2066 6f6c 6c6f t of words follo │ │ │ │ │ +00011cb0: 7769 6e67 2027 696e 2720 6973 2065 7870 wing 'in' is exp │ │ │ │ │ +00011cc0: 616e 6465 642c 2067 656e 6572 6174 696e anded, generatin │ │ │ │ │ +00011cd0: 6720 6120 6c69 7374 206f 660a 2020 2020 g a list of. │ │ │ │ │ +00011ce0: 2069 7465 6d73 2e20 2054 6865 2076 6172 items. The var │ │ │ │ │ +00011cf0: 6961 626c 6520 4e41 4d45 2069 7320 7365 iable NAME is se │ │ │ │ │ +00011d00: 7420 746f 2065 6163 6820 656c 656d 656e t to each elemen │ │ │ │ │ +00011d10: 7420 6f66 2074 6869 7320 6c69 7374 2069 t of this list i │ │ │ │ │ +00011d20: 6e0a 2020 2020 2074 7572 6e2c 2061 6e64 n. turn, and │ │ │ │ │ +00011d30: 204c 4953 5420 6973 2065 7865 6375 7465 LIST is execute │ │ │ │ │ +00011d40: 6420 6561 6368 2074 696d 652e 2020 5468 d each time. Th │ │ │ │ │ +00011d50: 6520 7265 7475 726e 2076 616c 7565 2069 e return value i │ │ │ │ │ +00011d60: 7320 7468 6520 6578 6974 0a20 2020 2020 s the exit. │ │ │ │ │ +00011d70: 7374 6174 7573 206f 6620 7468 6520 6c61 status of the la │ │ │ │ │ +00011d80: 7374 2063 6f6d 6d61 6e64 2074 6861 7420 st command that │ │ │ │ │ +00011d90: 6578 6563 7574 6573 2e20 2049 6620 7468 executes. If th │ │ │ │ │ +00011da0: 6520 6578 7061 6e73 696f 6e20 6f66 2074 e expansion of t │ │ │ │ │ +00011db0: 6865 0a20 2020 2020 6974 656d 7320 666f he. items fo │ │ │ │ │ +00011dc0: 6c6c 6f77 696e 6720 2769 6e27 2072 6573 llowing 'in' res │ │ │ │ │ +00011dd0: 756c 7473 2069 6e20 616e 2065 6d70 7479 ults in an empty │ │ │ │ │ +00011de0: 206c 6973 742c 206e 6f20 636f 6d6d 616e list, no comman │ │ │ │ │ +00011df0: 6473 2061 7265 0a20 2020 2020 6578 6563 ds are. exec │ │ │ │ │ +00011e00: 7574 6564 2c20 616e 6420 7468 6520 7265 uted, and the re │ │ │ │ │ +00011e10: 7475 726e 2073 7461 7475 7320 6973 2030 turn status is 0 │ │ │ │ │ +00011e20: 2e0a 0a69 6620 4c49 5354 3b20 7468 656e ...if LIST; then │ │ │ │ │ +00011e30: 204c 4953 543b 205b 656c 6966 204c 4953 LIST; [elif LIS │ │ │ │ │ +00011e40: 543b 2074 6865 6e20 4c49 5354 3b5d 202e T; then LIST;] . │ │ │ │ │ +00011e50: 2e2e 205b 656c 7365 204c 4953 543b 5d20 .. [else LIST;] │ │ │ │ │ +00011e60: 6669 0a20 2020 2020 5468 6520 2769 6627 fi. The 'if' │ │ │ │ │ +00011e70: 204c 4953 5420 6973 2065 7865 6375 7465 LIST is execute │ │ │ │ │ +00011e80: 642e 2020 4966 2069 7473 2065 7869 7420 d. If its exit │ │ │ │ │ +00011e90: 7374 6174 7573 2069 7320 7a65 726f 2c20 status is zero, │ │ │ │ │ +00011ea0: 7468 6520 2774 6865 6e27 0a20 2020 2020 the 'then'. │ │ │ │ │ +00011eb0: 4c49 5354 2069 7320 6578 6563 7574 6564 LIST is executed │ │ │ │ │ +00011ec0: 2e20 204f 7468 6572 7769 7365 2c20 6561 . Otherwise, ea │ │ │ │ │ +00011ed0: 6368 2027 656c 6966 2720 4c49 5354 2069 ch 'elif' LIST i │ │ │ │ │ +00011ee0: 7320 6578 6563 7574 6564 2069 6e20 7475 s executed in tu │ │ │ │ │ +00011ef0: 726e 2c0a 2020 2020 2061 6e64 2069 6620 rn,. and if │ │ │ │ │ +00011f00: 6974 7320 6578 6974 2073 7461 7475 7320 its exit status │ │ │ │ │ +00011f10: 6973 207a 6572 6f2c 2074 6865 2063 6f72 is zero, the cor │ │ │ │ │ +00011f20: 7265 7370 6f6e 6469 6e67 2027 7468 656e responding 'then │ │ │ │ │ +00011f30: 2720 4c49 5354 2069 730a 2020 2020 2065 ' LIST is. e │ │ │ │ │ +00011f40: 7865 6375 7465 6420 616e 6420 7468 6520 xecuted and the │ │ │ │ │ +00011f50: 636f 6d6d 616e 6420 636f 6d70 6c65 7465 command complete │ │ │ │ │ +00011f60: 732e 2020 4f74 6865 7277 6973 652c 2074 s. Otherwise, t │ │ │ │ │ +00011f70: 6865 2027 656c 7365 2720 4c49 5354 2069 he 'else' LIST i │ │ │ │ │ +00011f80: 730a 2020 2020 2065 7865 6375 7465 642c s. executed, │ │ │ │ │ +00011f90: 2069 6620 7072 6573 656e 742e 2020 5468 if present. Th │ │ │ │ │ +00011fa0: 6520 6578 6974 2073 7461 7475 7320 6973 e exit status is │ │ │ │ │ +00011fb0: 2074 6865 2065 7869 7420 7374 6174 7573 the exit status │ │ │ │ │ +00011fc0: 206f 6620 7468 650a 2020 2020 206c 6173 of the. las │ │ │ │ │ +00011fd0: 7420 636f 6d6d 616e 6420 6578 6563 7574 t command execut │ │ │ │ │ +00011fe0: 6564 2c20 6f72 207a 6572 6f20 6966 206e ed, or zero if n │ │ │ │ │ +00011ff0: 6f20 636f 6e64 6974 696f 6e20 7465 7374 o condition test │ │ │ │ │ +00012000: 6564 2074 7275 652e 0a0a 7768 696c 6520 ed true...while │ │ │ │ │ +00012010: 434f 4e44 3b20 646f 204c 4953 543b 2064 COND; do LIST; d │ │ │ │ │ +00012020: 6f6e 650a 756e 7469 6c20 434f 4e44 3b20 one.until COND; │ │ │ │ │ +00012030: 646f 204c 4953 543b 2064 6f6e 650a 2020 do LIST; done. │ │ │ │ │ +00012040: 2020 2054 6865 2027 7768 696c 6527 2063 The 'while' c │ │ │ │ │ +00012050: 6f6d 6d61 6e64 2063 6f6e 7469 6e75 6f75 ommand continuou │ │ │ │ │ +00012060: 736c 7920 6578 6563 7574 6573 2074 6865 sly executes the │ │ │ │ │ +00012070: 2027 646f 2720 4c49 5354 2061 7320 6c6f 'do' LIST as lo │ │ │ │ │ +00012080: 6e67 2061 730a 2020 2020 2074 6865 206c ng as. the l │ │ │ │ │ +00012090: 6173 7420 636f 6d6d 616e 6420 696e 2043 ast command in C │ │ │ │ │ +000120a0: 4f4e 4420 7265 7475 726e 7320 616e 2065 OND returns an e │ │ │ │ │ +000120b0: 7869 7420 7374 6174 7573 206f 6620 7a65 xit status of ze │ │ │ │ │ +000120c0: 726f 2e20 2054 6865 0a20 2020 2020 2775 ro. The. 'u │ │ │ │ │ +000120d0: 6e74 696c 2720 636f 6d6d 616e 6420 6973 ntil' command is │ │ │ │ │ +000120e0: 2069 6465 6e74 6963 616c 2074 6f20 7468 identical to th │ │ │ │ │ +000120f0: 6520 2777 6869 6c65 2720 636f 6d6d 616e e 'while' comman │ │ │ │ │ +00012100: 642c 2065 7863 6570 7420 7468 6174 0a20 d, except that. │ │ │ │ │ +00012110: 2020 2020 7468 6520 7465 7374 2069 7320 the test is │ │ │ │ │ +00012120: 6e65 6761 7465 643b 2074 6865 2027 646f negated; the 'do │ │ │ │ │ +00012130: 2720 4c49 5354 2069 7320 6578 6563 7574 ' LIST is execut │ │ │ │ │ +00012140: 6564 2061 7320 6c6f 6e67 2061 7320 7468 ed as long as th │ │ │ │ │ +00012150: 6520 6c61 7374 0a20 2020 2020 636f 6d6d e last. comm │ │ │ │ │ +00012160: 616e 6420 696e 2043 4f4e 4420 7265 7475 and in COND retu │ │ │ │ │ +00012170: 726e 7320 6120 6e6f 6e2d 7a65 726f 2065 rns a non-zero e │ │ │ │ │ +00012180: 7869 7420 7374 6174 7573 2e20 2054 6865 xit status. The │ │ │ │ │ +00012190: 2065 7869 7420 7374 6174 7573 206f 660a exit status of. │ │ │ │ │ +000121a0: 2020 2020 2074 6865 2027 7768 696c 6527 the 'while' │ │ │ │ │ +000121b0: 2061 6e64 2027 756e 7469 6c27 2063 6f6d and 'until' com │ │ │ │ │ +000121c0: 6d61 6e64 7320 6973 2074 6865 2065 7869 mands is the exi │ │ │ │ │ +000121d0: 7420 7374 6174 7573 206f 6620 7468 6520 t status of the │ │ │ │ │ +000121e0: 6c61 7374 0a20 2020 2020 2764 6f27 204c last. 'do' L │ │ │ │ │ +000121f0: 4953 5420 636f 6d6d 616e 6420 6578 6563 IST command exec │ │ │ │ │ +00012200: 7574 6564 2c20 6f72 207a 6572 6f20 6966 uted, or zero if │ │ │ │ │ +00012210: 206e 6f6e 6520 7761 7320 6578 6563 7574 none was execut │ │ │ │ │ +00012220: 6564 2e0a 0a66 756e 6374 696f 6e20 4e41 ed...function NA │ │ │ │ │ +00012230: 4d45 207b 2043 4f4d 4d41 4e44 3b20 2e2e ME { COMMAND; .. │ │ │ │ │ +00012240: 2e20 7d0a 2020 2020 2054 6869 7320 6465 . }. This de │ │ │ │ │ +00012250: 6669 6e65 7320 6120 6675 6e63 7469 6f6e fines a function │ │ │ │ │ +00012260: 206e 616d 6564 204e 414d 452e 2020 5468 named NAME. Th │ │ │ │ │ +00012270: 6520 2262 6f64 7922 206f 6620 7468 6520 e "body" of the │ │ │ │ │ +00012280: 6675 6e63 7469 6f6e 2069 730a 2020 2020 function is. │ │ │ │ │ +00012290: 2074 6865 206c 6973 7420 6f66 2063 6f6d the list of com │ │ │ │ │ +000122a0: 6d61 6e64 7320 7769 7468 696e 2062 7261 mands within bra │ │ │ │ │ +000122b0: 6365 732c 2065 6163 6820 6f66 2077 6869 ces, each of whi │ │ │ │ │ +000122c0: 6368 206d 7573 7420 6265 0a20 2020 2020 ch must be. │ │ │ │ │ +000122d0: 7465 726d 696e 6174 6564 2077 6974 6820 terminated with │ │ │ │ │ +000122e0: 6120 7365 6d69 636f 6c6f 6e20 6f72 2061 a semicolon or a │ │ │ │ │ +000122f0: 206e 6577 6c69 6e65 2e20 2054 6869 7320 newline. This │ │ │ │ │ +00012300: 6c69 7374 206f 6620 636f 6d6d 616e 6473 list of commands │ │ │ │ │ +00012310: 0a20 2020 2020 7769 6c6c 2062 6520 6578 . will be ex │ │ │ │ │ +00012320: 6563 7574 6564 2077 6865 6e65 7665 7220 ecuted whenever │ │ │ │ │ +00012330: 4e41 4d45 2069 7320 7370 6563 6966 6965 NAME is specifie │ │ │ │ │ +00012340: 6420 6173 2074 6865 206e 616d 6520 6f66 d as the name of │ │ │ │ │ +00012350: 2061 2073 696d 706c 650a 2020 2020 2063 a simple. c │ │ │ │ │ +00012360: 6f6d 6d61 6e64 2e20 2046 756e 6374 696f ommand. Functio │ │ │ │ │ +00012370: 6e20 6465 6669 6e69 7469 6f6e 7320 646f n definitions do │ │ │ │ │ +00012380: 206e 6f74 2061 6666 6563 7420 7468 6520 not affect the │ │ │ │ │ +00012390: 6578 6974 2073 7461 7475 7320 696e 0a20 exit status in. │ │ │ │ │ +000123a0: 2020 2020 2724 3f27 2e20 2057 6865 6e20 '$?'. When │ │ │ │ │ +000123b0: 6578 6563 7574 6564 2c20 7468 6520 6578 executed, the ex │ │ │ │ │ +000123c0: 6974 2073 7461 7475 7320 6f66 2061 2066 it status of a f │ │ │ │ │ +000123d0: 756e 6374 696f 6e20 6973 2074 6865 2065 unction is the e │ │ │ │ │ +000123e0: 7869 740a 2020 2020 2073 7461 7475 7320 xit. status │ │ │ │ │ +000123f0: 6f66 2074 6865 206c 6173 7420 636f 6d6d of the last comm │ │ │ │ │ +00012400: 616e 6420 6578 6563 7574 6564 2069 6e20 and executed in │ │ │ │ │ +00012410: 7468 6520 626f 6479 2e0a 0a6d 656e 7565 the body...menue │ │ │ │ │ +00012420: 6e74 7279 2054 4954 4c45 205b 272d 2d63 ntry TITLE ['--c │ │ │ │ │ +00012430: 6c61 7373 3d63 6c61 7373 2720 2e2e 2e5d lass=class' ...] │ │ │ │ │ +00012440: 205b 272d 2d75 7365 7273 3d75 7365 7273 ['--users=users │ │ │ │ │ +00012450: 275d 205b 272d 2d75 6e72 6573 7472 6963 '] ['--unrestric │ │ │ │ │ +00012460: 7465 6427 5d20 5b27 2d2d 686f 746b 6579 ted'] ['--hotkey │ │ │ │ │ +00012470: 3d6b 6579 275d 205b 272d 2d69 643d 6964 =key'] ['--id=id │ │ │ │ │ +00012480: 275d 207b 2043 4f4d 4d41 4e44 3b20 2e2e '] { COMMAND; .. │ │ │ │ │ +00012490: 2e20 7d0a 2020 2020 202a 4e6f 7465 206d . }. *Note m │ │ │ │ │ +000124a0: 656e 7565 6e74 7279 3a3a 2e0a 0a42 7569 enuentry::...Bui │ │ │ │ │ +000124b0: 6c74 2d69 6e20 436f 6d6d 616e 6473 0a3d lt-in Commands.= │ │ │ │ │ +000124c0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ +000124d0: 0a0a 536f 6d65 2062 7569 6c74 2d69 6e20 ..Some built-in │ │ │ │ │ +000124e0: 636f 6d6d 616e 6473 2061 7265 2061 6c73 commands are als │ │ │ │ │ +000124f0: 6f20 7072 6f76 6964 6564 2062 7920 4752 o provided by GR │ │ │ │ │ +00012500: 5542 2073 6372 6970 7420 746f 2068 656c UB script to hel │ │ │ │ │ +00012510: 7020 7363 7269 7074 0a77 7269 7465 7273 p script.writers │ │ │ │ │ +00012520: 2070 6572 666f 726d 2061 6374 696f 6e73 perform actions │ │ │ │ │ +00012530: 2074 6861 7420 6172 6520 6f74 6865 7277 that are otherw │ │ │ │ │ +00012540: 6973 6520 6e6f 7420 706f 7373 6962 6c65 ise not possible │ │ │ │ │ +00012550: 2e20 2046 6f72 2065 7861 6d70 6c65 2c0a . For example,. │ │ │ │ │ +00012560: 7468 6573 6520 696e 636c 7564 6520 636f these include co │ │ │ │ │ +00012570: 6d6d 616e 6473 2074 6f20 6a75 6d70 206f mmands to jump o │ │ │ │ │ +00012580: 7574 206f 6620 6120 6c6f 6f70 2077 6974 ut of a loop wit │ │ │ │ │ +00012590: 686f 7574 2066 756c 6c79 2063 6f6d 706c hout fully compl │ │ │ │ │ +000125a0: 6574 696e 670a 6974 2c20 6574 632e 0a0a eting.it, etc... │ │ │ │ │ +000125b0: 6272 6561 6b20 5b27 6e27 5d0a 2020 2020 break ['n']. │ │ │ │ │ +000125c0: 2045 7869 7420 6672 6f6d 2077 6974 6869 Exit from withi │ │ │ │ │ +000125d0: 6e20 6120 2766 6f72 272c 2027 7768 696c n a 'for', 'whil │ │ │ │ │ +000125e0: 6527 2c20 6f72 2027 756e 7469 6c27 206c e', or 'until' l │ │ │ │ │ +000125f0: 6f6f 702e 2020 4966 2027 6e27 2069 730a oop. If 'n' is. │ │ │ │ │ +00012600: 2020 2020 2073 7065 6369 6669 6564 2c20 specified, │ │ │ │ │ +00012610: 6272 6561 6b20 276e 2720 6c65 7665 6c73 break 'n' levels │ │ │ │ │ +00012620: 2e20 2027 6e27 206d 7573 7420 6265 2067 . 'n' must be g │ │ │ │ │ +00012630: 7265 6174 6572 2074 6861 6e20 6f72 2065 reater than or e │ │ │ │ │ +00012640: 7175 616c 2074 6f0a 2020 2020 2031 2e20 qual to. 1. │ │ │ │ │ +00012650: 2049 6620 276e 2720 6973 2067 7265 6174 If 'n' is great │ │ │ │ │ +00012660: 6572 2074 6861 6e20 7468 6520 6e75 6d62 er than the numb │ │ │ │ │ +00012670: 6572 206f 6620 656e 636c 6f73 696e 6720 er of enclosing │ │ │ │ │ +00012680: 6c6f 6f70 732c 2061 6c6c 0a20 2020 2020 loops, all. │ │ │ │ │ +00012690: 656e 636c 6f73 696e 6720 6c6f 6f70 7320 enclosing loops │ │ │ │ │ +000126a0: 6172 6520 6578 6974 6564 2e20 2054 6865 are exited. The │ │ │ │ │ +000126b0: 2072 6574 7572 6e20 7661 6c75 6520 6973 return value is │ │ │ │ │ +000126c0: 2030 2075 6e6c 6573 7320 276e 2720 6973 0 unless 'n' is │ │ │ │ │ +000126d0: 0a20 2020 2020 6e6f 7420 6772 6561 7465 . not greate │ │ │ │ │ +000126e0: 7220 7468 616e 206f 7220 6571 7561 6c20 r than or equal │ │ │ │ │ +000126f0: 746f 2031 2e0a 0a63 6f6e 7469 6e75 6520 to 1...continue │ │ │ │ │ +00012700: 5b27 6e27 5d0a 2020 2020 2052 6573 756d ['n']. Resum │ │ │ │ │ +00012710: 6520 7468 6520 6e65 7874 2069 7465 7261 e the next itera │ │ │ │ │ +00012720: 7469 6f6e 206f 6620 7468 6520 656e 636c tion of the encl │ │ │ │ │ +00012730: 6f73 696e 6720 2766 6f72 272c 2027 7768 osing 'for', 'wh │ │ │ │ │ +00012740: 696c 6527 206f 720a 2020 2020 2027 756e ile' or. 'un │ │ │ │ │ +00012750: 7469 6c27 206c 6f6f 702e 2020 4966 2027 til' loop. If ' │ │ │ │ │ +00012760: 6e27 2069 7320 7370 6563 6966 6965 642c n' is specified, │ │ │ │ │ +00012770: 2072 6573 756d 6520 6174 2074 6865 2027 resume at the ' │ │ │ │ │ +00012780: 6e27 7468 2065 6e63 6c6f 7369 6e67 0a20 n'th enclosing. │ │ │ │ │ +00012790: 2020 2020 6c6f 6f70 2e20 2027 6e27 206d loop. 'n' m │ │ │ │ │ +000127a0: 7573 7420 6265 2067 7265 6174 6572 2074 ust be greater t │ │ │ │ │ +000127b0: 6861 6e20 6f72 2065 7175 616c 2074 6f20 han or equal to │ │ │ │ │ +000127c0: 312e 2020 4966 2027 6e27 2069 7320 6772 1. If 'n' is gr │ │ │ │ │ +000127d0: 6561 7465 720a 2020 2020 2074 6861 6e20 eater. than │ │ │ │ │ +000127e0: 7468 6520 6e75 6d62 6572 206f 6620 656e the number of en │ │ │ │ │ +000127f0: 636c 6f73 696e 6720 6c6f 6f70 732c 2074 closing loops, t │ │ │ │ │ +00012800: 6865 206c 6173 7420 656e 636c 6f73 696e he last enclosin │ │ │ │ │ +00012810: 6720 6c6f 6f70 2028 7468 650a 2020 2020 g loop (the. │ │ │ │ │ +00012820: 2022 746f 702d 6c65 7665 6c22 206c 6f6f "top-level" loo │ │ │ │ │ +00012830: 7029 2069 7320 7265 7375 6d65 642e 2020 p) is resumed. │ │ │ │ │ +00012840: 5468 6520 7265 7475 726e 2076 616c 7565 The return value │ │ │ │ │ +00012850: 2069 7320 3020 756e 6c65 7373 2027 6e27 is 0 unless 'n' │ │ │ │ │ +00012860: 2069 730a 2020 2020 206e 6f74 2067 7265 is. not gre │ │ │ │ │ +00012870: 6174 6572 2074 6861 6e20 6f72 2065 7175 ater than or equ │ │ │ │ │ +00012880: 616c 2074 6f20 312e 0a0a 7265 7475 726e al to 1...return │ │ │ │ │ +00012890: 205b 276e 275d 0a20 2020 2020 4361 7573 ['n']. Caus │ │ │ │ │ +000128a0: 6573 2061 2066 756e 6374 696f 6e20 746f es a function to │ │ │ │ │ +000128b0: 2065 7869 7420 7769 7468 2074 6865 2072 exit with the r │ │ │ │ │ +000128c0: 6574 7572 6e20 7661 6c75 6520 7370 6563 eturn value spec │ │ │ │ │ +000128d0: 6966 6965 6420 6279 2027 6e27 2e0a 2020 ified by 'n'.. │ │ │ │ │ +000128e0: 2020 2049 6620 276e 2720 6973 206f 6d69 If 'n' is omi │ │ │ │ │ +000128f0: 7474 6564 2c20 7468 6520 7265 7475 726e tted, the return │ │ │ │ │ +00012900: 2073 7461 7475 7320 6973 2074 6861 7420 status is that │ │ │ │ │ +00012910: 6f66 2074 6865 206c 6173 7420 636f 6d6d of the last comm │ │ │ │ │ +00012920: 616e 640a 2020 2020 2065 7865 6375 7465 and. execute │ │ │ │ │ +00012930: 6420 696e 2074 6865 2066 756e 6374 696f d in the functio │ │ │ │ │ +00012940: 6e20 626f 6479 2e20 2049 6620 7573 6564 n body. If used │ │ │ │ │ +00012950: 206f 7574 7369 6465 2061 2066 756e 6374 outside a funct │ │ │ │ │ +00012960: 696f 6e20 7468 650a 2020 2020 2072 6574 ion the. ret │ │ │ │ │ +00012970: 7572 6e20 7374 6174 7573 2069 7320 6661 urn status is fa │ │ │ │ │ +00012980: 6c73 652e 0a0a 7365 7470 6172 616d 7320 lse...setparams │ │ │ │ │ +00012990: 5b27 6172 6727 5d20 2e2e 2e0a 2020 2020 ['arg'] .... │ │ │ │ │ +000129a0: 2052 6570 6c61 6365 2070 6f73 6974 696f Replace positio │ │ │ │ │ +000129b0: 6e61 6c20 7061 7261 6d65 7465 7273 2073 nal parameters s │ │ │ │ │ +000129c0: 7461 7274 696e 6720 7769 7468 2027 2431 tarting with '$1 │ │ │ │ │ +000129d0: 2720 7769 7468 2061 7267 756d 656e 7473 ' with arguments │ │ │ │ │ +000129e0: 2074 6f0a 2020 2020 2027 7365 7470 6172 to. 'setpar │ │ │ │ │ +000129f0: 616d 7327 2e0a 0a73 6869 6674 205b 276e ams'...shift ['n │ │ │ │ │ +00012a00: 275d 0a20 2020 2020 5468 6520 706f 7369 ']. The posi │ │ │ │ │ +00012a10: 7469 6f6e 616c 2070 6172 616d 6574 6572 tional parameter │ │ │ │ │ +00012a20: 7320 6672 6f6d 2027 6e27 2b31 202e 2e2e s from 'n'+1 ... │ │ │ │ │ +00012a30: 2061 7265 2072 656e 616d 6564 2074 6f20 are renamed to │ │ │ │ │ +00012a40: 2724 3127 2e2e 2e2e 0a20 2020 2020 5061 '$1'..... Pa │ │ │ │ │ +00012a50: 7261 6d65 7465 7273 2072 6570 7265 7365 rameters represe │ │ │ │ │ +00012a60: 6e74 6564 2062 7920 7468 6520 6e75 6d62 nted by the numb │ │ │ │ │ +00012a70: 6572 7320 2724 2327 2064 6f77 6e20 746f ers '$#' down to │ │ │ │ │ +00012a80: 2027 2423 272d 276e 272b 3120 6172 650a '$#'-'n'+1 are. │ │ │ │ │ +00012a90: 2020 2020 2075 6e73 6574 2e20 2027 6e27 unset. 'n' │ │ │ │ │ +00012aa0: 206d 7573 7420 6265 2061 206e 6f6e 2d6e must be a non-n │ │ │ │ │ +00012ab0: 6567 6174 6976 6520 6e75 6d62 6572 206c egative number l │ │ │ │ │ +00012ac0: 6573 7320 7468 616e 206f 7220 6571 7561 ess than or equa │ │ │ │ │ +00012ad0: 6c20 746f 0a20 2020 2020 2724 2327 2e20 l to. '$#'. │ │ │ │ │ +00012ae0: 2049 6620 276e 2720 6973 2030 2c20 6e6f If 'n' is 0, no │ │ │ │ │ +00012af0: 2070 6172 616d 6574 6572 7320 6172 6520 parameters are │ │ │ │ │ +00012b00: 6368 616e 6765 642e 2020 4966 2027 6e27 changed. If 'n' │ │ │ │ │ +00012b10: 2069 7320 6e6f 740a 2020 2020 2067 6976 is not. giv │ │ │ │ │ +00012b20: 656e 2c20 6974 2069 7320 6173 7375 6d65 en, it is assume │ │ │ │ │ +00012b30: 6420 746f 2062 6520 312e 2020 4966 2027 d to be 1. If ' │ │ │ │ │ +00012b40: 6e27 2069 7320 6772 6561 7465 7220 7468 n' is greater th │ │ │ │ │ +00012b50: 616e 2027 2423 272c 2074 6865 0a20 2020 an '$#', the. │ │ │ │ │ +00012b60: 2020 706f 7369 7469 6f6e 616c 2070 6172 positional par │ │ │ │ │ +00012b70: 616d 6574 6572 7320 6172 6520 6e6f 7420 ameters are not │ │ │ │ │ +00012b80: 6368 616e 6765 642e 2020 5468 6520 7265 changed. The re │ │ │ │ │ +00012b90: 7475 726e 2073 7461 7475 7320 6973 0a20 turn status is. │ │ │ │ │ +00012ba0: 2020 2020 6772 6561 7465 7220 7468 616e greater than │ │ │ │ │ +00012bb0: 207a 6572 6f20 6966 2027 6e27 2069 7320 zero if 'n' is │ │ │ │ │ +00012bc0: 6772 6561 7465 7220 7468 616e 2027 2423 greater than '$# │ │ │ │ │ +00012bd0: 2720 6f72 206c 6573 7320 7468 616e 207a ' or less than z │ │ │ │ │ +00012be0: 6572 6f3b 0a20 2020 2020 6f74 6865 7277 ero;. otherw │ │ │ │ │ +00012bf0: 6973 6520 302e 0a0a 1f0a 4669 6c65 3a20 ise 0.....File: │ │ │ │ │ +00012c00: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ +00012c10: 3a20 5368 656c 6c2d 6c69 6b65 2073 6372 : Shell-like scr │ │ │ │ │ +00012c20: 6970 7469 6e67 2d46 6f6f 746e 6f74 6573 ipting-Footnotes │ │ │ │ │ +00012c30: 2c20 2055 703a 2053 6865 6c6c 2d6c 696b , Up: Shell-lik │ │ │ │ │ +00012c40: 6520 7363 7269 7074 696e 670a 0a20 2020 e scripting.. │ │ │ │ │ +00012c50: 2831 2920 4375 7272 656e 746c 7920 6120 (1) Currently a │ │ │ │ │ +00012c60: 6261 636b 736c 6173 682d 6e65 776c 696e backslash-newlin │ │ │ │ │ +00012c70: 6520 7061 6972 2077 6974 6869 6e20 6120 e pair within a │ │ │ │ │ +00012c80: 7661 7269 6162 6c65 206e 616d 6520 6973 variable name is │ │ │ │ │ +00012c90: 206e 6f74 0a68 616e 646c 6564 2070 726f not.handled pro │ │ │ │ │ +00012ca0: 7065 726c 792c 2073 6f20 7573 6520 7468 perly, so use th │ │ │ │ │ +00012cb0: 6973 2066 6561 7475 7265 2077 6974 6820 is feature with │ │ │ │ │ +00012cc0: 736f 6d65 2063 6172 652e 0a0a 1f0a 4669 some care.....Fi │ │ │ │ │ +00012cd0: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ +00012ce0: 4e6f 6465 3a20 4d75 6c74 692d 626f 6f74 Node: Multi-boot │ │ │ │ │ +00012cf0: 206d 616e 7561 6c20 636f 6e66 6967 2c20 manual config, │ │ │ │ │ +00012d00: 204e 6578 743a 2045 6d62 6564 6465 6420 Next: Embedded │ │ │ │ │ +00012d10: 636f 6e66 6967 7572 6174 696f 6e2c 2020 configuration, │ │ │ │ │ +00012d20: 5072 6576 3a20 5368 656c 6c2d 6c69 6b65 Prev: Shell-like │ │ │ │ │ +00012d30: 2073 6372 6970 7469 6e67 2c20 2055 703a scripting, Up: │ │ │ │ │ +00012d40: 2043 6f6e 6669 6775 7261 7469 6f6e 0a0a Configuration.. │ │ │ │ │ +00012d50: 362e 3420 4d75 6c74 692d 626f 6f74 206d 6.4 Multi-boot m │ │ │ │ │ +00012d60: 616e 7561 6c20 636f 6e66 6967 0a3d 3d3d anual config.=== │ │ │ │ │ 00012d70: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00012d80: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a43 7572 ===========..Cur │ │ │ │ │ -00012d90: 7265 6e74 6c79 2061 7574 6f67 656e 6572 rently autogener │ │ │ │ │ -00012da0: 6174 696e 6720 636f 6e66 6967 2066 696c ating config fil │ │ │ │ │ -00012db0: 6573 2066 6f72 206d 756c 7469 2d62 6f6f es for multi-boo │ │ │ │ │ -00012dc0: 7420 656e 7669 726f 6e6d 656e 7473 0a64 t environments.d │ │ │ │ │ -00012dd0: 6570 656e 6473 206f 6e20 6f73 2d70 726f epends on os-pro │ │ │ │ │ -00012de0: 6265 7220 616e 6420 6861 7320 7365 7665 ber and has seve │ │ │ │ │ -00012df0: 7261 6c20 7368 6f72 7463 6f6d 696e 6773 ral shortcomings │ │ │ │ │ -00012e00: 2e20 2044 7565 2074 6f20 7468 6174 2069 . Due to that i │ │ │ │ │ -00012e10: 7420 6973 0a64 6973 6162 6c65 6420 6279 t is.disabled by │ │ │ │ │ -00012e20: 2064 6566 6175 6c74 2e20 2049 7420 6973 default. It is │ │ │ │ │ -00012e30: 2061 6476 6973 6564 2074 6f20 7573 6520 advised to use │ │ │ │ │ -00012e40: 7468 6520 706f 7765 7220 6f66 2047 5255 the power of GRU │ │ │ │ │ -00012e50: 4220 7379 6e74 6178 2061 6e64 0a64 6f20 B syntax and.do │ │ │ │ │ -00012e60: 6974 2079 6f75 7273 656c 662e 2020 4120 it yourself. A │ │ │ │ │ -00012e70: 706f 7373 6962 6c65 2063 6f6e 6669 6775 possible configu │ │ │ │ │ -00012e80: 7261 7469 6f6e 2069 7320 6465 7461 696c ration is detail │ │ │ │ │ -00012e90: 6564 2068 6572 652c 2066 6565 6c20 6672 ed here, feel fr │ │ │ │ │ -00012ea0: 6565 2074 6f0a 6164 6a75 7374 2074 6f20 ee to.adjust to │ │ │ │ │ -00012eb0: 796f 7572 206e 6565 6473 2e0a 0a20 2020 your needs... │ │ │ │ │ -00012ec0: 4669 7273 7420 6372 6561 7465 2061 2073 First create a s │ │ │ │ │ -00012ed0: 6570 6172 6174 6520 4752 5542 2070 6172 eparate GRUB par │ │ │ │ │ -00012ee0: 7469 7469 6f6e 2c20 6269 6720 656e 6f75 tition, big enou │ │ │ │ │ -00012ef0: 6768 2074 6f20 686f 6c64 2047 5255 422e gh to hold GRUB. │ │ │ │ │ -00012f00: 2053 6f6d 650a 6f66 2074 6865 2066 6f6c Some.of the fol │ │ │ │ │ -00012f10: 6c6f 7769 6e67 2065 6e74 7269 6573 2073 lowing entries s │ │ │ │ │ -00012f20: 686f 7720 686f 7720 746f 206c 6f61 6420 how how to load │ │ │ │ │ -00012f30: 4f53 2069 6e73 7461 6c6c 6572 2069 6d61 OS installer ima │ │ │ │ │ -00012f40: 6765 7320 6672 6f6d 2074 6869 730a 7361 ges from this.sa │ │ │ │ │ -00012f50: 6d65 2070 6172 7469 7469 6f6e 2c20 666f me partition, fo │ │ │ │ │ -00012f60: 7220 7468 6174 2079 6f75 206f 6276 696f r that you obvio │ │ │ │ │ -00012f70: 7573 6c79 206e 6565 6420 746f 206d 616b usly need to mak │ │ │ │ │ -00012f80: 6520 7468 6520 7061 7274 6974 696f 6e20 e the partition │ │ │ │ │ -00012f90: 6c61 7267 650a 656e 6f75 6768 2074 6f20 large.enough to │ │ │ │ │ -00012fa0: 686f 6c64 2074 686f 7365 2069 6d61 6765 hold those image │ │ │ │ │ -00012fb0: 7320 6173 2077 656c 6c2e 2020 4d6f 756e s as well. Moun │ │ │ │ │ -00012fc0: 7420 7468 6973 2070 6172 7469 7469 6f6e t this partition │ │ │ │ │ -00012fd0: 206f 6e2f 6d6e 742f 626f 6f74 0a61 6e64 on/mnt/boot.and │ │ │ │ │ -00012fe0: 2064 6973 6162 6c65 2047 5255 4220 696e disable GRUB in │ │ │ │ │ -00012ff0: 2061 6c6c 204f 5365 7320 616e 6420 6d61 all OSes and ma │ │ │ │ │ -00013000: 6e75 616c 6c79 2069 6e73 7461 6c6c 2073 nually install s │ │ │ │ │ -00013010: 656c 662d 636f 6d70 696c 6564 206c 6174 elf-compiled lat │ │ │ │ │ -00013020: 6573 740a 4752 5542 2077 6974 683a 0a0a est.GRUB with:.. │ │ │ │ │ -00013030: 2020 2027 6772 7562 2d69 6e73 7461 6c6c 'grub-install │ │ │ │ │ -00013040: 202d 2d62 6f6f 742d 6469 7265 6374 6f72 --boot-director │ │ │ │ │ -00013050: 793d 2f6d 6e74 2f62 6f6f 7420 2f64 6576 y=/mnt/boot /dev │ │ │ │ │ -00013060: 2f73 6461 270a 0a20 2020 496e 2061 6c6c /sda'.. In all │ │ │ │ │ -00013070: 2074 6865 204f 5365 7320 696e 7374 616c the OSes instal │ │ │ │ │ -00013080: 6c20 4752 5542 2074 6f6f 6c73 2062 7574 l GRUB tools but │ │ │ │ │ -00013090: 2064 6973 6162 6c65 2069 6e73 7461 6c6c disable install │ │ │ │ │ -000130a0: 696e 6720 4752 5542 2069 6e0a 626f 6f74 ing GRUB in.boot │ │ │ │ │ -000130b0: 7365 6374 6f72 2c20 736f 2079 6f75 276c sector, so you'l │ │ │ │ │ -000130c0: 6c20 6861 7665 206d 656e 752e 6c73 7420 l have menu.lst │ │ │ │ │ -000130d0: 616e 6420 6772 7562 2e63 6667 2061 7661 and grub.cfg ava │ │ │ │ │ -000130e0: 696c 6162 6c65 2066 6f72 2075 7365 2e0a ilable for use.. │ │ │ │ │ -000130f0: 416c 736f 2064 6973 6162 6c65 206f 732d Also disable os- │ │ │ │ │ -00013100: 7072 6f62 6572 2075 7365 2062 7920 7365 prober use by se │ │ │ │ │ -00013110: 7474 696e 673a 0a0a 2020 2027 4752 5542 tting:.. 'GRUB │ │ │ │ │ -00013120: 5f44 4953 4142 4c45 5f4f 535f 5052 4f42 _DISABLE_OS_PROB │ │ │ │ │ -00013130: 4552 3d74 7275 6527 0a0a 2020 2069 6e20 ER=true'.. in │ │ │ │ │ -00013140: 2f65 7463 2f64 6566 6175 6c74 2f67 7275 /etc/default/gru │ │ │ │ │ -00013150: 620a 0a20 2020 5468 656e 2077 7269 7465 b.. Then write │ │ │ │ │ -00013160: 2061 2067 7275 622e 6366 6720 282f 6d6e a grub.cfg (/mn │ │ │ │ │ -00013170: 742f 626f 6f74 2f67 7275 622f 6772 7562 t/boot/grub/grub │ │ │ │ │ -00013180: 2e63 6667 293a 0a0a 0a20 2020 2020 6d65 .cfg):... me │ │ │ │ │ -00013190: 6e75 656e 7472 7920 224f 5320 7573 696e nuentry "OS usin │ │ │ │ │ -000131a0: 6720 6772 7562 3222 207b 0a20 2020 2020 g grub2" {. │ │ │ │ │ -000131b0: 2020 2069 6e73 6d6f 6420 7866 730a 2020 insmod xfs. │ │ │ │ │ -000131c0: 2020 2020 2020 7365 6172 6368 202d 2d73 search --s │ │ │ │ │ -000131d0: 6574 3d72 6f6f 7420 2d2d 6c61 6265 6c20 et=root --label │ │ │ │ │ -000131e0: 4f53 3120 2d2d 6869 6e74 2068 6430 2c6d OS1 --hint hd0,m │ │ │ │ │ -000131f0: 7364 6f73 380a 2020 2020 2020 2020 636f sdos8. co │ │ │ │ │ -00013200: 6e66 6967 6669 6c65 202f 626f 6f74 2f67 nfigfile /boot/g │ │ │ │ │ -00013210: 7275 622f 6772 7562 2e63 6667 0a20 2020 rub/grub.cfg. │ │ │ │ │ -00013220: 2020 7d0a 0a20 2020 2020 6d65 6e75 656e }.. menuen │ │ │ │ │ -00013230: 7472 7920 224f 5320 7573 696e 6720 6772 try "OS using gr │ │ │ │ │ -00013240: 7562 322d 6c65 6761 6379 2220 7b0a 2020 ub2-legacy" {. │ │ │ │ │ -00013250: 2020 2020 2020 696e 736d 6f64 2065 7874 insmod ext │ │ │ │ │ -00013260: 320a 2020 2020 2020 2020 7365 6172 6368 2. search │ │ │ │ │ -00013270: 202d 2d73 6574 3d72 6f6f 7420 2d2d 6c61 --set=root --la │ │ │ │ │ -00013280: 6265 6c20 4f53 3220 2d2d 6869 6e74 2068 bel OS2 --hint h │ │ │ │ │ -00013290: 6430 2c6d 7364 6f73 360a 2020 2020 2020 d0,msdos6. │ │ │ │ │ -000132a0: 2020 6c65 6761 6379 5f63 6f6e 6669 6766 legacy_configf │ │ │ │ │ -000132b0: 696c 6520 2f62 6f6f 742f 6772 7562 2f6d ile /boot/grub/m │ │ │ │ │ -000132c0: 656e 752e 6c73 740a 2020 2020 207d 0a0a enu.lst. }.. │ │ │ │ │ -000132d0: 2020 2020 206d 656e 7565 6e74 7279 2022 menuentry " │ │ │ │ │ -000132e0: 5769 6e64 6f77 7320 5850 2220 7b0a 2020 Windows XP" {. │ │ │ │ │ -000132f0: 2020 2020 2020 696e 736d 6f64 206e 7466 insmod ntf │ │ │ │ │ -00013300: 730a 2020 2020 2020 2020 7365 6172 6368 s. search │ │ │ │ │ -00013310: 202d 2d73 6574 3d72 6f6f 7420 2d2d 6c61 --set=root --la │ │ │ │ │ -00013320: 6265 6c20 5749 4e44 4f57 535f 5850 202d bel WINDOWS_XP - │ │ │ │ │ -00013330: 2d68 696e 7420 6864 302c 6d73 646f 7331 -hint hd0,msdos1 │ │ │ │ │ -00013340: 0a20 2020 2020 2020 206e 746c 6472 202f . ntldr / │ │ │ │ │ -00013350: 6e74 6c64 720a 2020 2020 207d 0a0a 2020 ntldr. }.. │ │ │ │ │ -00013360: 2020 206d 656e 7565 6e74 7279 2022 5769 menuentry "Wi │ │ │ │ │ -00013370: 6e64 6f77 7320 3722 207b 0a20 2020 2020 ndows 7" {. │ │ │ │ │ -00013380: 2020 2069 6e73 6d6f 6420 6e74 6673 0a20 insmod ntfs. │ │ │ │ │ -00013390: 2020 2020 2020 2073 6561 7263 6820 2d2d search -- │ │ │ │ │ -000133a0: 7365 743d 726f 6f74 202d 2d6c 6162 656c set=root --label │ │ │ │ │ -000133b0: 2057 494e 444f 5753 5f37 202d 2d68 696e WINDOWS_7 --hin │ │ │ │ │ -000133c0: 7420 6864 302c 6d73 646f 7332 0a20 2020 t hd0,msdos2. │ │ │ │ │ -000133d0: 2020 2020 206e 746c 6472 202f 626f 6f74 ntldr /boot │ │ │ │ │ -000133e0: 6d67 720a 2020 2020 207d 0a0a 2020 2020 mgr. }.. │ │ │ │ │ -000133f0: 206d 656e 7565 6e74 7279 2022 4672 6565 menuentry "Free │ │ │ │ │ -00013400: 4253 4422 207b 0a20 2020 2020 2020 2020 BSD" {. │ │ │ │ │ -00013410: 2020 2020 2020 696e 736d 6f64 207a 6673 insmod zfs │ │ │ │ │ -00013420: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ -00013430: 7365 6172 6368 202d 2d73 6574 3d72 6f6f search --set=roo │ │ │ │ │ -00013440: 7420 2d2d 6c61 6265 6c20 6672 6565 706f t --label freepo │ │ │ │ │ -00013450: 6f6c 202d 2d68 696e 7420 6864 302c 6d73 ol --hint hd0,ms │ │ │ │ │ -00013460: 646f 7337 0a20 2020 2020 2020 2020 2020 dos7. │ │ │ │ │ -00013470: 2020 2020 6b66 7265 6562 7364 202f 6672 kfreebsd /fr │ │ │ │ │ -00013480: 6565 6273 6440 2f62 6f6f 742f 6b65 726e eebsd@/boot/kern │ │ │ │ │ -00013490: 656c 2f6b 6572 6e65 6c0a 2020 2020 2020 el/kernel. │ │ │ │ │ -000134a0: 2020 2020 2020 2020 206b 6672 6565 6273 kfreebs │ │ │ │ │ -000134b0: 645f 6d6f 6475 6c65 5f65 6c66 202f 6672 d_module_elf /fr │ │ │ │ │ -000134c0: 6565 6273 6440 2f62 6f6f 742f 6b65 726e eebsd@/boot/kern │ │ │ │ │ -000134d0: 656c 2f6f 7065 6e73 6f6c 6172 6973 2e6b el/opensolaris.k │ │ │ │ │ -000134e0: 6f0a 2020 2020 2020 2020 2020 2020 2020 o. │ │ │ │ │ -000134f0: 206b 6672 6565 6273 645f 6d6f 6475 6c65 kfreebsd_module │ │ │ │ │ -00013500: 5f65 6c66 202f 6672 6565 6273 6440 2f62 _elf /freebsd@/b │ │ │ │ │ -00013510: 6f6f 742f 6b65 726e 656c 2f7a 6673 2e6b oot/kernel/zfs.k │ │ │ │ │ -00013520: 6f0a 2020 2020 2020 2020 2020 2020 2020 o. │ │ │ │ │ -00013530: 206b 6672 6565 6273 645f 6d6f 6475 6c65 kfreebsd_module │ │ │ │ │ -00013540: 202f 6672 6565 6273 6440 2f62 6f6f 742f /freebsd@/boot/ │ │ │ │ │ -00013550: 7a66 732f 7a70 6f6f 6c2e 6361 6368 6520 zfs/zpool.cache │ │ │ │ │ -00013560: 7479 7065 3d2f 626f 6f74 2f7a 6673 2f7a type=/boot/zfs/z │ │ │ │ │ -00013570: 706f 6f6c 2e63 6163 6865 0a20 2020 2020 pool.cache. │ │ │ │ │ -00013580: 2020 2020 2020 2020 2020 7365 7420 6b46 set kF │ │ │ │ │ -00013590: 7265 6542 5344 2e76 6673 2e72 6f6f 742e reeBSD.vfs.root. │ │ │ │ │ -000135a0: 6d6f 756e 7466 726f 6d3d 7a66 733a 6672 mountfrom=zfs:fr │ │ │ │ │ -000135b0: 6565 706f 6f6c 2f66 7265 6562 7364 0a20 eepool/freebsd. │ │ │ │ │ -000135c0: 2020 2020 2020 2020 2020 2020 2020 7365 se │ │ │ │ │ -000135d0: 7420 6b46 7265 6542 5344 2e68 772e 7073 t kFreeBSD.hw.ps │ │ │ │ │ -000135e0: 6d2e 7379 6e61 7074 6963 735f 7375 7070 m.synaptics_supp │ │ │ │ │ -000135f0: 6f72 743d 310a 2020 2020 207d 0a0a 2020 ort=1. }.. │ │ │ │ │ -00013600: 2020 206d 656e 7565 6e74 7279 2022 6578 menuentry "ex │ │ │ │ │ -00013610: 7065 7269 6d65 6e74 616c 2047 5255 4222 perimental GRUB" │ │ │ │ │ -00013620: 207b 0a20 2020 2020 2020 2020 2020 2020 {. │ │ │ │ │ -00013630: 2020 7365 6172 6368 202d 2d73 6574 3d72 search --set=r │ │ │ │ │ -00013640: 6f6f 7420 2d2d 6c61 6265 6c20 4752 5542 oot --label GRUB │ │ │ │ │ -00013650: 202d 2d68 696e 7420 6864 302c 6d73 646f --hint hd0,msdo │ │ │ │ │ -00013660: 7335 0a20 2020 2020 2020 2020 2020 2020 s5. │ │ │ │ │ -00013670: 2020 6d75 6c74 6962 6f6f 7420 2f65 7870 multiboot /exp │ │ │ │ │ -00013680: 6572 696d 656e 7461 6c2f 6772 7562 2f69 erimental/grub/i │ │ │ │ │ -00013690: 3338 362d 7063 2f63 6f72 652e 696d 670a 386-pc/core.img. │ │ │ │ │ -000136a0: 2020 2020 207d 0a0a 2020 2020 206d 656e }.. men │ │ │ │ │ -000136b0: 7565 6e74 7279 2022 4665 646f 7261 2031 uentry "Fedora 1 │ │ │ │ │ -000136c0: 3620 696e 7374 616c 6c65 7222 207b 0a20 6 installer" {. │ │ │ │ │ -000136d0: 2020 2020 2020 2020 2020 2020 2020 7365 se │ │ │ │ │ -000136e0: 6172 6368 202d 2d73 6574 3d72 6f6f 7420 arch --set=root │ │ │ │ │ -000136f0: 2d2d 6c61 6265 6c20 4752 5542 202d 2d68 --label GRUB --h │ │ │ │ │ -00013700: 696e 7420 6864 302c 6d73 646f 7335 0a20 int hd0,msdos5. │ │ │ │ │ -00013710: 2020 2020 2020 2020 2020 2020 2020 6c69 li │ │ │ │ │ -00013720: 6e75 7820 2f66 6564 6f72 612f 766d 6c69 nux /fedora/vmli │ │ │ │ │ -00013730: 6e75 7a20 6c61 6e67 3d65 6e5f 5553 206b nuz lang=en_US k │ │ │ │ │ -00013740: 6579 6d61 703d 7367 2072 6573 6f6c 7574 eymap=sg resolut │ │ │ │ │ -00013750: 696f 6e3d 3132 3830 7838 3030 0a20 2020 ion=1280x800. │ │ │ │ │ -00013760: 2020 2020 2020 2020 2020 2020 696e 6974 init │ │ │ │ │ -00013770: 7264 202f 6665 646f 7261 2f69 6e69 7472 rd /fedora/initr │ │ │ │ │ -00013780: 642e 696d 670a 2020 2020 207d 0a0a 2020 d.img. }.. │ │ │ │ │ -00013790: 2020 206d 656e 7565 6e74 7279 2022 4665 menuentry "Fe │ │ │ │ │ -000137a0: 646f 7261 2072 6177 6869 6465 2069 6e73 dora rawhide ins │ │ │ │ │ -000137b0: 7461 6c6c 6572 2220 7b0a 2020 2020 2020 taller" {. │ │ │ │ │ -000137c0: 2020 2020 2020 2020 2073 6561 7263 6820 search │ │ │ │ │ -000137d0: 2d2d 7365 743d 726f 6f74 202d 2d6c 6162 --set=root --lab │ │ │ │ │ -000137e0: 656c 2047 5255 4220 2d2d 6869 6e74 2068 el GRUB --hint h │ │ │ │ │ -000137f0: 6430 2c6d 7364 6f73 350a 2020 2020 2020 d0,msdos5. │ │ │ │ │ -00013800: 2020 2020 2020 2020 206c 696e 7578 202f linux / │ │ │ │ │ -00013810: 6665 646f 7261 2f76 6d6c 696e 757a 2072 fedora/vmlinuz r │ │ │ │ │ -00013820: 6570 6f3d 6674 703a 2f2f 6d69 7272 6f72 epo=ftp://mirror │ │ │ │ │ -00013830: 2e73 7769 7463 682e 6368 2f6d 6972 726f .switch.ch/mirro │ │ │ │ │ -00013840: 722f 6665 646f 7261 2f6c 696e 7578 2f64 r/fedora/linux/d │ │ │ │ │ -00013850: 6576 656c 6f70 6d65 6e74 2f72 6177 6869 evelopment/rawhi │ │ │ │ │ -00013860: 6465 2f78 3836 5f36 3420 6c61 6e67 3d65 de/x86_64 lang=e │ │ │ │ │ -00013870: 6e5f 5553 206b 6579 6d61 703d 7367 2072 n_US keymap=sg r │ │ │ │ │ -00013880: 6573 6f6c 7574 696f 6e3d 3132 3830 7838 esolution=1280x8 │ │ │ │ │ -00013890: 3030 0a20 2020 2020 2020 2020 2020 2020 00. │ │ │ │ │ -000138a0: 2020 696e 6974 7264 202f 6665 646f 7261 initrd /fedora │ │ │ │ │ -000138b0: 2f69 6e69 7472 642e 696d 670a 2020 2020 /initrd.img. │ │ │ │ │ -000138c0: 207d 0a0a 2020 2020 206d 656e 7565 6e74 }.. menuent │ │ │ │ │ -000138d0: 7279 2022 4465 6269 616e 2073 6964 2069 ry "Debian sid i │ │ │ │ │ -000138e0: 6e73 7461 6c6c 6572 2220 7b0a 2020 2020 nstaller" {. │ │ │ │ │ -000138f0: 2020 2020 2020 2020 2020 2073 6561 7263 searc │ │ │ │ │ -00013900: 6820 2d2d 7365 743d 726f 6f74 202d 2d6c h --set=root --l │ │ │ │ │ -00013910: 6162 656c 2047 5255 4220 2d2d 6869 6e74 abel GRUB --hint │ │ │ │ │ -00013920: 2068 6430 2c6d 7364 6f73 350a 2020 2020 hd0,msdos5. │ │ │ │ │ -00013930: 2020 2020 2020 2020 2020 206c 696e 7578 linux │ │ │ │ │ -00013940: 202f 6465 6269 616e 2f64 6973 7473 2f73 /debian/dists/s │ │ │ │ │ -00013950: 6964 2f6d 6169 6e2f 696e 7374 616c 6c65 id/main/installe │ │ │ │ │ -00013960: 722d 616d 6436 342f 6375 7272 656e 742f r-amd64/current/ │ │ │ │ │ -00013970: 696d 6167 6573 2f68 642d 6d65 6469 612f images/hd-media/ │ │ │ │ │ -00013980: 766d 6c69 6e75 7a0a 2020 2020 2020 2020 vmlinuz. │ │ │ │ │ -00013990: 2020 2020 2020 2069 6e69 7472 6420 2f64 initrd /d │ │ │ │ │ -000139a0: 6562 6961 6e2f 6469 7374 732f 7369 642f ebian/dists/sid/ │ │ │ │ │ -000139b0: 6d61 696e 2f69 6e73 7461 6c6c 6572 2d61 main/installer-a │ │ │ │ │ -000139c0: 6d64 3634 2f63 7572 7265 6e74 2f69 6d61 md64/current/ima │ │ │ │ │ -000139d0: 6765 732f 6864 2d6d 6564 6961 2f69 6e69 ges/hd-media/ini │ │ │ │ │ -000139e0: 7472 642e 677a 0a20 2020 2020 7d0a 0a0a trd.gz. }... │ │ │ │ │ -000139f0: 2020 204e 6f74 6573 3a0a 2020 202a 2041 Notes:. * A │ │ │ │ │ -00013a00: 7267 756d 656e 7420 746f 2073 6561 7263 rgument to searc │ │ │ │ │ -00013a10: 6820 6166 7465 7220 2d6c 6162 656c 2069 h after -label i │ │ │ │ │ -00013a20: 7320 4653 204c 4142 454c 2e20 596f 7520 s FS LABEL. You │ │ │ │ │ -00013a30: 6361 6e20 616c 736f 2075 7365 2055 5549 can also use UUI │ │ │ │ │ -00013a40: 4473 0a20 2020 2020 7769 7468 202d 6673 Ds. with -fs │ │ │ │ │ -00013a50: 2d75 7569 6420 5555 4944 2069 6e73 7465 -uuid UUID inste │ │ │ │ │ -00013a60: 6164 206f 6620 2d6c 6162 656c 204c 4142 ad of -label LAB │ │ │ │ │ -00013a70: 454c 2e20 596f 7520 636f 756c 6420 616c EL. You could al │ │ │ │ │ -00013a80: 736f 2075 7365 0a20 2020 2020 6469 7265 so use. dire │ │ │ │ │ -00013a90: 6374 2027 726f 6f74 3d68 6430 2c6d 7364 ct 'root=hd0,msd │ │ │ │ │ -00013aa0: 6f73 5827 2062 7574 2074 6869 7320 6973 osX' but this is │ │ │ │ │ -00013ab0: 206e 6f74 2072 6563 6f6d 6d65 6e64 6564 not recommended │ │ │ │ │ -00013ac0: 2064 7565 2074 6f20 6465 7669 6365 0a20 due to device. │ │ │ │ │ -00013ad0: 2020 2020 6e61 6d65 2069 6e73 7461 6269 name instabi │ │ │ │ │ -00013ae0: 6c69 7479 2e0a 0a1f 0a46 696c 653a 2067 lity.....File: g │ │ │ │ │ -00013af0: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ -00013b00: 2045 6d62 6564 6465 6420 636f 6e66 6967 Embedded config │ │ │ │ │ -00013b10: 7572 6174 696f 6e2c 2020 5072 6576 3a20 uration, Prev: │ │ │ │ │ -00013b20: 4d75 6c74 692d 626f 6f74 206d 616e 7561 Multi-boot manua │ │ │ │ │ -00013b30: 6c20 636f 6e66 6967 2c20 2055 703a 2043 l config, Up: C │ │ │ │ │ -00013b40: 6f6e 6669 6775 7261 7469 6f6e 0a0a 362e onfiguration..6. │ │ │ │ │ -00013b50: 3520 456d 6265 6464 696e 6720 6120 636f 5 Embedding a co │ │ │ │ │ -00013b60: 6e66 6967 7572 6174 696f 6e20 6669 6c65 nfiguration file │ │ │ │ │ -00013b70: 2069 6e74 6f20 4752 5542 0a3d 3d3d 3d3d into GRUB.===== │ │ │ │ │ +00012d80: 3d3d 3d3d 3d3d 3d3d 3d0a 0a43 7572 7265 =========..Curre │ │ │ │ │ +00012d90: 6e74 6c79 2061 7574 6f67 656e 6572 6174 ntly autogenerat │ │ │ │ │ +00012da0: 696e 6720 636f 6e66 6967 2066 696c 6573 ing config files │ │ │ │ │ +00012db0: 2066 6f72 206d 756c 7469 2d62 6f6f 7420 for multi-boot │ │ │ │ │ +00012dc0: 656e 7669 726f 6e6d 656e 7473 0a64 6570 environments.dep │ │ │ │ │ +00012dd0: 656e 6473 206f 6e20 6f73 2d70 726f 6265 ends on os-probe │ │ │ │ │ +00012de0: 7220 616e 6420 6861 7320 7365 7665 7261 r and has severa │ │ │ │ │ +00012df0: 6c20 7368 6f72 7463 6f6d 696e 6773 2e20 l shortcomings. │ │ │ │ │ +00012e00: 2044 7565 2074 6f20 7468 6174 2069 7420 Due to that it │ │ │ │ │ +00012e10: 6973 0a64 6973 6162 6c65 6420 6279 2064 is.disabled by d │ │ │ │ │ +00012e20: 6566 6175 6c74 2e20 2049 7420 6973 2061 efault. It is a │ │ │ │ │ +00012e30: 6476 6973 6564 2074 6f20 7573 6520 7468 dvised to use th │ │ │ │ │ +00012e40: 6520 706f 7765 7220 6f66 2047 5255 4220 e power of GRUB │ │ │ │ │ +00012e50: 7379 6e74 6178 2061 6e64 0a64 6f20 6974 syntax and.do it │ │ │ │ │ +00012e60: 2079 6f75 7273 656c 662e 2020 4120 706f yourself. A po │ │ │ │ │ +00012e70: 7373 6962 6c65 2063 6f6e 6669 6775 7261 ssible configura │ │ │ │ │ +00012e80: 7469 6f6e 2069 7320 6465 7461 696c 6564 tion is detailed │ │ │ │ │ +00012e90: 2068 6572 652c 2066 6565 6c20 6672 6565 here, feel free │ │ │ │ │ +00012ea0: 2074 6f0a 6164 6a75 7374 2074 6f20 796f to.adjust to yo │ │ │ │ │ +00012eb0: 7572 206e 6565 6473 2e0a 0a20 2020 4669 ur needs... Fi │ │ │ │ │ +00012ec0: 7273 7420 6372 6561 7465 2061 2073 6570 rst create a sep │ │ │ │ │ +00012ed0: 6172 6174 6520 4752 5542 2070 6172 7469 arate GRUB parti │ │ │ │ │ +00012ee0: 7469 6f6e 2c20 6269 6720 656e 6f75 6768 tion, big enough │ │ │ │ │ +00012ef0: 2074 6f20 686f 6c64 2047 5255 422e 2053 to hold GRUB. S │ │ │ │ │ +00012f00: 6f6d 650a 6f66 2074 6865 2066 6f6c 6c6f ome.of the follo │ │ │ │ │ +00012f10: 7769 6e67 2065 6e74 7269 6573 2073 686f wing entries sho │ │ │ │ │ +00012f20: 7720 686f 7720 746f 206c 6f61 6420 4f53 w how to load OS │ │ │ │ │ +00012f30: 2069 6e73 7461 6c6c 6572 2069 6d61 6765 installer image │ │ │ │ │ +00012f40: 7320 6672 6f6d 2074 6869 730a 7361 6d65 s from this.same │ │ │ │ │ +00012f50: 2070 6172 7469 7469 6f6e 2c20 666f 7220 partition, for │ │ │ │ │ +00012f60: 7468 6174 2079 6f75 206f 6276 696f 7573 that you obvious │ │ │ │ │ +00012f70: 6c79 206e 6565 6420 746f 206d 616b 6520 ly need to make │ │ │ │ │ +00012f80: 7468 6520 7061 7274 6974 696f 6e20 6c61 the partition la │ │ │ │ │ +00012f90: 7267 650a 656e 6f75 6768 2074 6f20 686f rge.enough to ho │ │ │ │ │ +00012fa0: 6c64 2074 686f 7365 2069 6d61 6765 7320 ld those images │ │ │ │ │ +00012fb0: 6173 2077 656c 6c2e 2020 4d6f 756e 7420 as well. Mount │ │ │ │ │ +00012fc0: 7468 6973 2070 6172 7469 7469 6f6e 206f this partition o │ │ │ │ │ +00012fd0: 6e2f 6d6e 742f 626f 6f74 0a61 6e64 2064 n/mnt/boot.and d │ │ │ │ │ +00012fe0: 6973 6162 6c65 2047 5255 4220 696e 2061 isable GRUB in a │ │ │ │ │ +00012ff0: 6c6c 204f 5365 7320 616e 6420 6d61 6e75 ll OSes and manu │ │ │ │ │ +00013000: 616c 6c79 2069 6e73 7461 6c6c 2073 656c ally install sel │ │ │ │ │ +00013010: 662d 636f 6d70 696c 6564 206c 6174 6573 f-compiled lates │ │ │ │ │ +00013020: 740a 4752 5542 2077 6974 683a 0a0a 2020 t.GRUB with:.. │ │ │ │ │ +00013030: 2027 6772 7562 2d69 6e73 7461 6c6c 202d 'grub-install - │ │ │ │ │ +00013040: 2d62 6f6f 742d 6469 7265 6374 6f72 793d -boot-directory= │ │ │ │ │ +00013050: 2f6d 6e74 2f62 6f6f 7420 2f64 6576 2f73 /mnt/boot /dev/s │ │ │ │ │ +00013060: 6461 270a 0a20 2020 496e 2061 6c6c 2074 da'.. In all t │ │ │ │ │ +00013070: 6865 204f 5365 7320 696e 7374 616c 6c20 he OSes install │ │ │ │ │ +00013080: 4752 5542 2074 6f6f 6c73 2062 7574 2064 GRUB tools but d │ │ │ │ │ +00013090: 6973 6162 6c65 2069 6e73 7461 6c6c 696e isable installin │ │ │ │ │ +000130a0: 6720 4752 5542 2069 6e0a 626f 6f74 7365 g GRUB in.bootse │ │ │ │ │ +000130b0: 6374 6f72 2c20 736f 2079 6f75 276c 6c20 ctor, so you'll │ │ │ │ │ +000130c0: 6861 7665 206d 656e 752e 6c73 7420 616e have menu.lst an │ │ │ │ │ +000130d0: 6420 6772 7562 2e63 6667 2061 7661 696c d grub.cfg avail │ │ │ │ │ +000130e0: 6162 6c65 2066 6f72 2075 7365 2e0a 416c able for use..Al │ │ │ │ │ +000130f0: 736f 2064 6973 6162 6c65 206f 732d 7072 so disable os-pr │ │ │ │ │ +00013100: 6f62 6572 2075 7365 2062 7920 7365 7474 ober use by sett │ │ │ │ │ +00013110: 696e 673a 0a0a 2020 2027 4752 5542 5f44 ing:.. 'GRUB_D │ │ │ │ │ +00013120: 4953 4142 4c45 5f4f 535f 5052 4f42 4552 ISABLE_OS_PROBER │ │ │ │ │ +00013130: 3d74 7275 6527 0a0a 2020 2069 6e20 2f65 =true'.. in /e │ │ │ │ │ +00013140: 7463 2f64 6566 6175 6c74 2f67 7275 620a tc/default/grub. │ │ │ │ │ +00013150: 0a20 2020 5468 656e 2077 7269 7465 2061 . Then write a │ │ │ │ │ +00013160: 2067 7275 622e 6366 6720 282f 6d6e 742f grub.cfg (/mnt/ │ │ │ │ │ +00013170: 626f 6f74 2f67 7275 622f 6772 7562 2e63 boot/grub/grub.c │ │ │ │ │ +00013180: 6667 293a 0a0a 0a20 2020 2020 6d65 6e75 fg):... menu │ │ │ │ │ +00013190: 656e 7472 7920 224f 5320 7573 696e 6720 entry "OS using │ │ │ │ │ +000131a0: 6772 7562 3222 207b 0a20 2020 2020 2020 grub2" {. │ │ │ │ │ +000131b0: 2069 6e73 6d6f 6420 7866 730a 2020 2020 insmod xfs. │ │ │ │ │ +000131c0: 2020 2020 7365 6172 6368 202d 2d73 6574 search --set │ │ │ │ │ +000131d0: 3d72 6f6f 7420 2d2d 6c61 6265 6c20 4f53 =root --label OS │ │ │ │ │ +000131e0: 3120 2d2d 6869 6e74 2068 6430 2c6d 7364 1 --hint hd0,msd │ │ │ │ │ +000131f0: 6f73 380a 2020 2020 2020 2020 636f 6e66 os8. conf │ │ │ │ │ +00013200: 6967 6669 6c65 202f 626f 6f74 2f67 7275 igfile /boot/gru │ │ │ │ │ +00013210: 622f 6772 7562 2e63 6667 0a20 2020 2020 b/grub.cfg. │ │ │ │ │ +00013220: 7d0a 0a20 2020 2020 6d65 6e75 656e 7472 }.. menuentr │ │ │ │ │ +00013230: 7920 224f 5320 7573 696e 6720 6772 7562 y "OS using grub │ │ │ │ │ +00013240: 322d 6c65 6761 6379 2220 7b0a 2020 2020 2-legacy" {. │ │ │ │ │ +00013250: 2020 2020 696e 736d 6f64 2065 7874 320a insmod ext2. │ │ │ │ │ +00013260: 2020 2020 2020 2020 7365 6172 6368 202d search - │ │ │ │ │ +00013270: 2d73 6574 3d72 6f6f 7420 2d2d 6c61 6265 -set=root --labe │ │ │ │ │ +00013280: 6c20 4f53 3220 2d2d 6869 6e74 2068 6430 l OS2 --hint hd0 │ │ │ │ │ +00013290: 2c6d 7364 6f73 360a 2020 2020 2020 2020 ,msdos6. │ │ │ │ │ +000132a0: 6c65 6761 6379 5f63 6f6e 6669 6766 696c legacy_configfil │ │ │ │ │ +000132b0: 6520 2f62 6f6f 742f 6772 7562 2f6d 656e e /boot/grub/men │ │ │ │ │ +000132c0: 752e 6c73 740a 2020 2020 207d 0a0a 2020 u.lst. }.. │ │ │ │ │ +000132d0: 2020 206d 656e 7565 6e74 7279 2022 5769 menuentry "Wi │ │ │ │ │ +000132e0: 6e64 6f77 7320 5850 2220 7b0a 2020 2020 ndows XP" {. │ │ │ │ │ +000132f0: 2020 2020 696e 736d 6f64 206e 7466 730a insmod ntfs. │ │ │ │ │ +00013300: 2020 2020 2020 2020 7365 6172 6368 202d search - │ │ │ │ │ +00013310: 2d73 6574 3d72 6f6f 7420 2d2d 6c61 6265 -set=root --labe │ │ │ │ │ +00013320: 6c20 5749 4e44 4f57 535f 5850 202d 2d68 l WINDOWS_XP --h │ │ │ │ │ +00013330: 696e 7420 6864 302c 6d73 646f 7331 0a20 int hd0,msdos1. │ │ │ │ │ +00013340: 2020 2020 2020 206e 746c 6472 202f 6e74 ntldr /nt │ │ │ │ │ +00013350: 6c64 720a 2020 2020 207d 0a0a 2020 2020 ldr. }.. │ │ │ │ │ +00013360: 206d 656e 7565 6e74 7279 2022 5769 6e64 menuentry "Wind │ │ │ │ │ +00013370: 6f77 7320 3722 207b 0a20 2020 2020 2020 ows 7" {. │ │ │ │ │ +00013380: 2069 6e73 6d6f 6420 6e74 6673 0a20 2020 insmod ntfs. │ │ │ │ │ +00013390: 2020 2020 2073 6561 7263 6820 2d2d 7365 search --se │ │ │ │ │ +000133a0: 743d 726f 6f74 202d 2d6c 6162 656c 2057 t=root --label W │ │ │ │ │ +000133b0: 494e 444f 5753 5f37 202d 2d68 696e 7420 INDOWS_7 --hint │ │ │ │ │ +000133c0: 6864 302c 6d73 646f 7332 0a20 2020 2020 hd0,msdos2. │ │ │ │ │ +000133d0: 2020 206e 746c 6472 202f 626f 6f74 6d67 ntldr /bootmg │ │ │ │ │ +000133e0: 720a 2020 2020 207d 0a0a 2020 2020 206d r. }.. m │ │ │ │ │ +000133f0: 656e 7565 6e74 7279 2022 4672 6565 4253 enuentry "FreeBS │ │ │ │ │ +00013400: 4422 207b 0a20 2020 2020 2020 2020 2020 D" {. │ │ │ │ │ +00013410: 2020 2020 696e 736d 6f64 207a 6673 0a20 insmod zfs. │ │ │ │ │ +00013420: 2020 2020 2020 2020 2020 2020 2020 7365 se │ │ │ │ │ +00013430: 6172 6368 202d 2d73 6574 3d72 6f6f 7420 arch --set=root │ │ │ │ │ +00013440: 2d2d 6c61 6265 6c20 6672 6565 706f 6f6c --label freepool │ │ │ │ │ +00013450: 202d 2d68 696e 7420 6864 302c 6d73 646f --hint hd0,msdo │ │ │ │ │ +00013460: 7337 0a20 2020 2020 2020 2020 2020 2020 s7. │ │ │ │ │ +00013470: 2020 6b66 7265 6562 7364 202f 6672 6565 kfreebsd /free │ │ │ │ │ +00013480: 6273 6440 2f62 6f6f 742f 6b65 726e 656c bsd@/boot/kernel │ │ │ │ │ +00013490: 2f6b 6572 6e65 6c0a 2020 2020 2020 2020 /kernel. │ │ │ │ │ +000134a0: 2020 2020 2020 206b 6672 6565 6273 645f kfreebsd_ │ │ │ │ │ +000134b0: 6d6f 6475 6c65 5f65 6c66 202f 6672 6565 module_elf /free │ │ │ │ │ +000134c0: 6273 6440 2f62 6f6f 742f 6b65 726e 656c bsd@/boot/kernel │ │ │ │ │ +000134d0: 2f6f 7065 6e73 6f6c 6172 6973 2e6b 6f0a /opensolaris.ko. │ │ │ │ │ +000134e0: 2020 2020 2020 2020 2020 2020 2020 206b k │ │ │ │ │ +000134f0: 6672 6565 6273 645f 6d6f 6475 6c65 5f65 freebsd_module_e │ │ │ │ │ +00013500: 6c66 202f 6672 6565 6273 6440 2f62 6f6f lf /freebsd@/boo │ │ │ │ │ +00013510: 742f 6b65 726e 656c 2f7a 6673 2e6b 6f0a t/kernel/zfs.ko. │ │ │ │ │ +00013520: 2020 2020 2020 2020 2020 2020 2020 206b k │ │ │ │ │ +00013530: 6672 6565 6273 645f 6d6f 6475 6c65 202f freebsd_module / │ │ │ │ │ +00013540: 6672 6565 6273 6440 2f62 6f6f 742f 7a66 freebsd@/boot/zf │ │ │ │ │ +00013550: 732f 7a70 6f6f 6c2e 6361 6368 6520 7479 s/zpool.cache ty │ │ │ │ │ +00013560: 7065 3d2f 626f 6f74 2f7a 6673 2f7a 706f pe=/boot/zfs/zpo │ │ │ │ │ +00013570: 6f6c 2e63 6163 6865 0a20 2020 2020 2020 ol.cache. │ │ │ │ │ +00013580: 2020 2020 2020 2020 7365 7420 6b46 7265 set kFre │ │ │ │ │ +00013590: 6542 5344 2e76 6673 2e72 6f6f 742e 6d6f eBSD.vfs.root.mo │ │ │ │ │ +000135a0: 756e 7466 726f 6d3d 7a66 733a 6672 6565 untfrom=zfs:free │ │ │ │ │ +000135b0: 706f 6f6c 2f66 7265 6562 7364 0a20 2020 pool/freebsd. │ │ │ │ │ +000135c0: 2020 2020 2020 2020 2020 2020 7365 7420 set │ │ │ │ │ +000135d0: 6b46 7265 6542 5344 2e68 772e 7073 6d2e kFreeBSD.hw.psm. │ │ │ │ │ +000135e0: 7379 6e61 7074 6963 735f 7375 7070 6f72 synaptics_suppor │ │ │ │ │ +000135f0: 743d 310a 2020 2020 207d 0a0a 2020 2020 t=1. }.. │ │ │ │ │ +00013600: 206d 656e 7565 6e74 7279 2022 6578 7065 menuentry "expe │ │ │ │ │ +00013610: 7269 6d65 6e74 616c 2047 5255 4222 207b rimental GRUB" { │ │ │ │ │ +00013620: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +00013630: 7365 6172 6368 202d 2d73 6574 3d72 6f6f search --set=roo │ │ │ │ │ +00013640: 7420 2d2d 6c61 6265 6c20 4752 5542 202d t --label GRUB - │ │ │ │ │ +00013650: 2d68 696e 7420 6864 302c 6d73 646f 7335 -hint hd0,msdos5 │ │ │ │ │ +00013660: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +00013670: 6d75 6c74 6962 6f6f 7420 2f65 7870 6572 multiboot /exper │ │ │ │ │ +00013680: 696d 656e 7461 6c2f 6772 7562 2f69 3338 imental/grub/i38 │ │ │ │ │ +00013690: 362d 7063 2f63 6f72 652e 696d 670a 2020 6-pc/core.img. │ │ │ │ │ +000136a0: 2020 207d 0a0a 2020 2020 206d 656e 7565 }.. menue │ │ │ │ │ +000136b0: 6e74 7279 2022 4665 646f 7261 2031 3620 ntry "Fedora 16 │ │ │ │ │ +000136c0: 696e 7374 616c 6c65 7222 207b 0a20 2020 installer" {. │ │ │ │ │ +000136d0: 2020 2020 2020 2020 2020 2020 7365 6172 sear │ │ │ │ │ +000136e0: 6368 202d 2d73 6574 3d72 6f6f 7420 2d2d ch --set=root -- │ │ │ │ │ +000136f0: 6c61 6265 6c20 4752 5542 202d 2d68 696e label GRUB --hin │ │ │ │ │ +00013700: 7420 6864 302c 6d73 646f 7335 0a20 2020 t hd0,msdos5. │ │ │ │ │ +00013710: 2020 2020 2020 2020 2020 2020 6c69 6e75 linu │ │ │ │ │ +00013720: 7820 2f66 6564 6f72 612f 766d 6c69 6e75 x /fedora/vmlinu │ │ │ │ │ +00013730: 7a20 6c61 6e67 3d65 6e5f 5553 206b 6579 z lang=en_US key │ │ │ │ │ +00013740: 6d61 703d 7367 2072 6573 6f6c 7574 696f map=sg resolutio │ │ │ │ │ +00013750: 6e3d 3132 3830 7838 3030 0a20 2020 2020 n=1280x800. │ │ │ │ │ +00013760: 2020 2020 2020 2020 2020 696e 6974 7264 initrd │ │ │ │ │ +00013770: 202f 6665 646f 7261 2f69 6e69 7472 642e /fedora/initrd. │ │ │ │ │ +00013780: 696d 670a 2020 2020 207d 0a0a 2020 2020 img. }.. │ │ │ │ │ +00013790: 206d 656e 7565 6e74 7279 2022 4665 646f menuentry "Fedo │ │ │ │ │ +000137a0: 7261 2072 6177 6869 6465 2069 6e73 7461 ra rawhide insta │ │ │ │ │ +000137b0: 6c6c 6572 2220 7b0a 2020 2020 2020 2020 ller" {. │ │ │ │ │ +000137c0: 2020 2020 2020 2073 6561 7263 6820 2d2d search -- │ │ │ │ │ +000137d0: 7365 743d 726f 6f74 202d 2d6c 6162 656c set=root --label │ │ │ │ │ +000137e0: 2047 5255 4220 2d2d 6869 6e74 2068 6430 GRUB --hint hd0 │ │ │ │ │ +000137f0: 2c6d 7364 6f73 350a 2020 2020 2020 2020 ,msdos5. │ │ │ │ │ +00013800: 2020 2020 2020 206c 696e 7578 202f 6665 linux /fe │ │ │ │ │ +00013810: 646f 7261 2f76 6d6c 696e 757a 2072 6570 dora/vmlinuz rep │ │ │ │ │ +00013820: 6f3d 6674 703a 2f2f 6d69 7272 6f72 2e73 o=ftp://mirror.s │ │ │ │ │ +00013830: 7769 7463 682e 6368 2f6d 6972 726f 722f witch.ch/mirror/ │ │ │ │ │ +00013840: 6665 646f 7261 2f6c 696e 7578 2f64 6576 fedora/linux/dev │ │ │ │ │ +00013850: 656c 6f70 6d65 6e74 2f72 6177 6869 6465 elopment/rawhide │ │ │ │ │ +00013860: 2f78 3836 5f36 3420 6c61 6e67 3d65 6e5f /x86_64 lang=en_ │ │ │ │ │ +00013870: 5553 206b 6579 6d61 703d 7367 2072 6573 US keymap=sg res │ │ │ │ │ +00013880: 6f6c 7574 696f 6e3d 3132 3830 7838 3030 olution=1280x800 │ │ │ │ │ +00013890: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +000138a0: 696e 6974 7264 202f 6665 646f 7261 2f69 initrd /fedora/i │ │ │ │ │ +000138b0: 6e69 7472 642e 696d 670a 2020 2020 207d nitrd.img. } │ │ │ │ │ +000138c0: 0a0a 2020 2020 206d 656e 7565 6e74 7279 .. menuentry │ │ │ │ │ +000138d0: 2022 4465 6269 616e 2073 6964 2069 6e73 "Debian sid ins │ │ │ │ │ +000138e0: 7461 6c6c 6572 2220 7b0a 2020 2020 2020 taller" {. │ │ │ │ │ +000138f0: 2020 2020 2020 2020 2073 6561 7263 6820 search │ │ │ │ │ +00013900: 2d2d 7365 743d 726f 6f74 202d 2d6c 6162 --set=root --lab │ │ │ │ │ +00013910: 656c 2047 5255 4220 2d2d 6869 6e74 2068 el GRUB --hint h │ │ │ │ │ +00013920: 6430 2c6d 7364 6f73 350a 2020 2020 2020 d0,msdos5. │ │ │ │ │ +00013930: 2020 2020 2020 2020 206c 696e 7578 202f linux / │ │ │ │ │ +00013940: 6465 6269 616e 2f64 6973 7473 2f73 6964 debian/dists/sid │ │ │ │ │ +00013950: 2f6d 6169 6e2f 696e 7374 616c 6c65 722d /main/installer- │ │ │ │ │ +00013960: 616d 6436 342f 6375 7272 656e 742f 696d amd64/current/im │ │ │ │ │ +00013970: 6167 6573 2f68 642d 6d65 6469 612f 766d ages/hd-media/vm │ │ │ │ │ +00013980: 6c69 6e75 7a0a 2020 2020 2020 2020 2020 linuz. │ │ │ │ │ +00013990: 2020 2020 2069 6e69 7472 6420 2f64 6562 initrd /deb │ │ │ │ │ +000139a0: 6961 6e2f 6469 7374 732f 7369 642f 6d61 ian/dists/sid/ma │ │ │ │ │ +000139b0: 696e 2f69 6e73 7461 6c6c 6572 2d61 6d64 in/installer-amd │ │ │ │ │ +000139c0: 3634 2f63 7572 7265 6e74 2f69 6d61 6765 64/current/image │ │ │ │ │ +000139d0: 732f 6864 2d6d 6564 6961 2f69 6e69 7472 s/hd-media/initr │ │ │ │ │ +000139e0: 642e 677a 0a20 2020 2020 7d0a 0a0a 2020 d.gz. }... │ │ │ │ │ +000139f0: 204e 6f74 6573 3a0a 2020 202a 2041 7267 Notes:. * Arg │ │ │ │ │ +00013a00: 756d 656e 7420 746f 2073 6561 7263 6820 ument to search │ │ │ │ │ +00013a10: 6166 7465 7220 2d6c 6162 656c 2069 7320 after -label is │ │ │ │ │ +00013a20: 4653 204c 4142 454c 2e20 596f 7520 6361 FS LABEL. You ca │ │ │ │ │ +00013a30: 6e20 616c 736f 2075 7365 2055 5549 4473 n also use UUIDs │ │ │ │ │ +00013a40: 0a20 2020 2020 7769 7468 202d 6673 2d75 . with -fs-u │ │ │ │ │ +00013a50: 7569 6420 5555 4944 2069 6e73 7465 6164 uid UUID instead │ │ │ │ │ +00013a60: 206f 6620 2d6c 6162 656c 204c 4142 454c of -label LABEL │ │ │ │ │ +00013a70: 2e20 596f 7520 636f 756c 6420 616c 736f . You could also │ │ │ │ │ +00013a80: 2075 7365 0a20 2020 2020 6469 7265 6374 use. direct │ │ │ │ │ +00013a90: 2027 726f 6f74 3d68 6430 2c6d 7364 6f73 'root=hd0,msdos │ │ │ │ │ +00013aa0: 5827 2062 7574 2074 6869 7320 6973 206e X' but this is n │ │ │ │ │ +00013ab0: 6f74 2072 6563 6f6d 6d65 6e64 6564 2064 ot recommended d │ │ │ │ │ +00013ac0: 7565 2074 6f20 6465 7669 6365 0a20 2020 ue to device. │ │ │ │ │ +00013ad0: 2020 6e61 6d65 2069 6e73 7461 6269 6c69 name instabili │ │ │ │ │ +00013ae0: 7479 2e0a 0a1f 0a46 696c 653a 2067 7275 ty.....File: gru │ │ │ │ │ +00013af0: 622e 696e 666f 2c20 204e 6f64 653a 2045 b.info, Node: E │ │ │ │ │ +00013b00: 6d62 6564 6465 6420 636f 6e66 6967 7572 mbedded configur │ │ │ │ │ +00013b10: 6174 696f 6e2c 2020 5072 6576 3a20 4d75 ation, Prev: Mu │ │ │ │ │ +00013b20: 6c74 692d 626f 6f74 206d 616e 7561 6c20 lti-boot manual │ │ │ │ │ +00013b30: 636f 6e66 6967 2c20 2055 703a 2043 6f6e config, Up: Con │ │ │ │ │ +00013b40: 6669 6775 7261 7469 6f6e 0a0a 362e 3520 figuration..6.5 │ │ │ │ │ +00013b50: 456d 6265 6464 696e 6720 6120 636f 6e66 Embedding a conf │ │ │ │ │ +00013b60: 6967 7572 6174 696f 6e20 6669 6c65 2069 iguration file i │ │ │ │ │ +00013b70: 6e74 6f20 4752 5542 0a3d 3d3d 3d3d 3d3d nto GRUB.======= │ │ │ │ │ 00013b80: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 00013b90: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00013ba0: 3d3d 3d3d 3d3d 3d0a 0a47 5255 4220 7375 =======..GRUB su │ │ │ │ │ -00013bb0: 7070 6f72 7473 2065 6d62 6564 6469 6e67 pports embedding │ │ │ │ │ -00013bc0: 2061 2063 6f6e 6669 6775 7261 7469 6f6e a configuration │ │ │ │ │ -00013bd0: 2066 696c 6520 6469 7265 6374 6c79 2069 file directly i │ │ │ │ │ -00013be0: 6e74 6f20 7468 6520 636f 7265 0a69 6d61 nto the core.ima │ │ │ │ │ -00013bf0: 6765 2c20 736f 2074 6861 7420 6974 2069 ge, so that it i │ │ │ │ │ -00013c00: 7320 6c6f 6164 6564 2062 6566 6f72 6520 s loaded before │ │ │ │ │ -00013c10: 656e 7465 7269 6e67 206e 6f72 6d61 6c20 entering normal │ │ │ │ │ -00013c20: 6d6f 6465 2e20 2054 6869 7320 6973 0a75 mode. This is.u │ │ │ │ │ -00013c30: 7365 6675 6c2c 2066 6f72 2065 7861 6d70 seful, for examp │ │ │ │ │ -00013c40: 6c65 2c20 7768 656e 2069 7420 6973 206e le, when it is n │ │ │ │ │ -00013c50: 6f74 2073 7472 6169 6768 7466 6f72 7761 ot straightforwa │ │ │ │ │ -00013c60: 7264 2074 6f20 6669 6e64 2074 6865 2072 rd to find the r │ │ │ │ │ -00013c70: 6561 6c0a 636f 6e66 6967 7572 6174 696f eal.configuratio │ │ │ │ │ -00013c80: 6e20 6669 6c65 2c20 6f72 2077 6865 6e20 n file, or when │ │ │ │ │ -00013c90: 796f 7520 6e65 6564 2074 6f20 6465 6275 you need to debu │ │ │ │ │ -00013ca0: 6720 7072 6f62 6c65 6d73 2077 6974 6820 g problems with │ │ │ │ │ -00013cb0: 6c6f 6164 696e 6720 7468 6174 0a66 696c loading that.fil │ │ │ │ │ -00013cc0: 652e 2020 2767 7275 622d 696e 7374 616c e. 'grub-instal │ │ │ │ │ -00013cd0: 6c27 2075 7365 7320 7468 6973 2066 6561 l' uses this fea │ │ │ │ │ -00013ce0: 7475 7265 2077 6865 6e20 6974 2069 7320 ture when it is │ │ │ │ │ -00013cf0: 6e6f 7420 7573 696e 6720 4249 4f53 2064 not using BIOS d │ │ │ │ │ -00013d00: 6973 6b0a 6675 6e63 7469 6f6e 7320 6f72 isk.functions or │ │ │ │ │ -00013d10: 2077 6865 6e20 696e 7374 616c 6c69 6e67 when installing │ │ │ │ │ -00013d20: 2074 6f20 6120 6469 6666 6572 656e 7420 to a different │ │ │ │ │ -00013d30: 6469 736b 2066 726f 6d20 7468 6520 6f6e disk from the on │ │ │ │ │ -00013d40: 6520 636f 6e74 6169 6e69 6e67 0a27 2f62 e containing.'/b │ │ │ │ │ -00013d50: 6f6f 742f 6772 7562 272c 2069 6e20 7768 oot/grub', in wh │ │ │ │ │ -00013d60: 6963 6820 6361 7365 2069 7420 6e65 6564 ich case it need │ │ │ │ │ -00013d70: 7320 746f 2075 7365 2074 6865 2027 7365 s to use the 'se │ │ │ │ │ -00013d80: 6172 6368 2720 636f 6d6d 616e 6420 282a arch' command (* │ │ │ │ │ -00013d90: 6e6f 7465 0a73 6561 7263 683a 3a29 2074 note.search::) t │ │ │ │ │ -00013da0: 6f20 6669 6e64 2027 2f62 6f6f 742f 6772 o find '/boot/gr │ │ │ │ │ -00013db0: 7562 272e 0a0a 2020 2054 6f20 656d 6265 ub'... To embe │ │ │ │ │ -00013dc0: 6420 6120 636f 6e66 6967 7572 6174 696f d a configuratio │ │ │ │ │ -00013dd0: 6e20 6669 6c65 2c20 7573 6520 7468 6520 n file, use the │ │ │ │ │ -00013de0: 272d 6327 206f 7074 696f 6e20 746f 2027 '-c' option to ' │ │ │ │ │ -00013df0: 6772 7562 2d6d 6b69 6d61 6765 272e 0a54 grub-mkimage'..T │ │ │ │ │ -00013e00: 6865 2066 696c 6520 6973 2063 6f70 6965 he file is copie │ │ │ │ │ -00013e10: 6420 696e 746f 2074 6865 2063 6f72 6520 d into the core │ │ │ │ │ -00013e20: 696d 6167 652c 2073 6f20 6974 206d 6179 image, so it may │ │ │ │ │ -00013e30: 2072 6573 6964 6520 616e 7977 6865 7265 reside anywhere │ │ │ │ │ -00013e40: 206f 6e20 7468 650a 6669 6c65 2073 7973 on the.file sys │ │ │ │ │ -00013e50: 7465 6d2c 2061 6e64 206d 6179 2062 6520 tem, and may be │ │ │ │ │ -00013e60: 7265 6d6f 7665 6420 6166 7465 7220 7275 removed after ru │ │ │ │ │ -00013e70: 6e6e 696e 6720 2767 7275 622d 6d6b 696d nning 'grub-mkim │ │ │ │ │ -00013e80: 6167 6527 2e0a 0a20 2020 4166 7465 7220 age'... After │ │ │ │ │ -00013e90: 7468 6520 656d 6265 6464 6564 2063 6f6e the embedded con │ │ │ │ │ -00013ea0: 6669 6775 7261 7469 6f6e 2066 696c 6520 figuration file │ │ │ │ │ -00013eb0: 2869 6620 616e 7929 2069 7320 6578 6563 (if any) is exec │ │ │ │ │ -00013ec0: 7574 6564 2c20 4752 5542 2077 696c 6c0a uted, GRUB will. │ │ │ │ │ -00013ed0: 6c6f 6164 2074 6865 2027 6e6f 726d 616c load the 'normal │ │ │ │ │ -00013ee0: 2720 6d6f 6475 6c65 2028 2a6e 6f74 6520 ' module (*note │ │ │ │ │ -00013ef0: 6e6f 726d 616c 3a3a 292c 2077 6869 6368 normal::), which │ │ │ │ │ -00013f00: 2077 696c 6c20 7468 656e 2072 6561 6420 will then read │ │ │ │ │ -00013f10: 7468 6520 7265 616c 0a63 6f6e 6669 6775 the real.configu │ │ │ │ │ -00013f20: 7261 7469 6f6e 2066 696c 6520 6672 6f6d ration file from │ │ │ │ │ -00013f30: 2027 2470 7265 6669 782f 6772 7562 2e63 '$prefix/grub.c │ │ │ │ │ -00013f40: 6667 272e 2020 4279 2074 6869 7320 706f fg'. By this po │ │ │ │ │ -00013f50: 696e 742c 2074 6865 2027 726f 6f74 270a int, the 'root'. │ │ │ │ │ -00013f60: 7661 7269 6162 6c65 2077 696c 6c20 616c variable will al │ │ │ │ │ -00013f70: 736f 2068 6176 6520 6265 656e 2073 6574 so have been set │ │ │ │ │ -00013f80: 2074 6f20 7468 6520 726f 6f74 2064 6576 to the root dev │ │ │ │ │ -00013f90: 6963 6520 6e61 6d65 2e20 2046 6f72 2065 ice name. For e │ │ │ │ │ -00013fa0: 7861 6d70 6c65 2c0a 2770 7265 6669 7827 xample,.'prefix' │ │ │ │ │ -00013fb0: 206d 6967 6874 2062 6520 7365 7420 746f might be set to │ │ │ │ │ -00013fc0: 2027 2868 6430 2c31 292f 626f 6f74 2f67 '(hd0,1)/boot/g │ │ │ │ │ -00013fd0: 7275 6227 2c20 616e 6420 2772 6f6f 7427 rub', and 'root' │ │ │ │ │ -00013fe0: 206d 6967 6874 2062 6520 7365 7420 746f might be set to │ │ │ │ │ -00013ff0: 0a27 6864 302c 3127 2e20 2054 6875 732c .'hd0,1'. Thus, │ │ │ │ │ -00014000: 2069 6e20 6d6f 7374 2063 6173 6573 2c20 in most cases, │ │ │ │ │ -00014010: 7468 6520 656d 6265 6464 6564 2063 6f6e the embedded con │ │ │ │ │ -00014020: 6669 6775 7261 7469 6f6e 2066 696c 6520 figuration file │ │ │ │ │ -00014030: 6f6e 6c79 0a6e 6565 6473 2074 6f20 7365 only.needs to se │ │ │ │ │ -00014040: 7420 7468 6520 2770 7265 6669 7827 2061 t the 'prefix' a │ │ │ │ │ -00014050: 6e64 2027 726f 6f74 2720 7661 7269 6162 nd 'root' variab │ │ │ │ │ -00014060: 6c65 732c 2061 6e64 2074 6865 6e20 6472 les, and then dr │ │ │ │ │ -00014070: 6f70 2074 6872 6f75 6768 2074 6f0a 4752 op through to.GR │ │ │ │ │ -00014080: 5542 2773 206e 6f72 6d61 6c20 7072 6f63 UB's normal proc │ │ │ │ │ -00014090: 6573 7369 6e67 2e20 2041 2074 7970 6963 essing. A typic │ │ │ │ │ -000140a0: 616c 2065 7861 6d70 6c65 206f 6620 7468 al example of th │ │ │ │ │ -000140b0: 6973 206d 6967 6874 206c 6f6f 6b20 6c69 is might look li │ │ │ │ │ -000140c0: 6b65 0a74 6869 733a 0a0a 2020 2020 2073 ke.this:.. s │ │ │ │ │ -000140d0: 6561 7263 682e 6673 5f75 7569 6420 3031 earch.fs_uuid 01 │ │ │ │ │ -000140e0: 3233 3435 3637 2d38 3961 622d 6364 6566 234567-89ab-cdef │ │ │ │ │ -000140f0: 2d30 3132 332d 3435 3637 3839 6162 6364 -0123-456789abcd │ │ │ │ │ -00014100: 6566 2072 6f6f 740a 2020 2020 2073 6574 ef root. set │ │ │ │ │ -00014110: 2070 7265 6669 783d 2824 726f 6f74 292f prefix=($root)/ │ │ │ │ │ -00014120: 626f 6f74 2f67 7275 620a 0a20 2020 2854 boot/grub.. (T │ │ │ │ │ -00014130: 6865 2027 7365 6172 6368 5f66 735f 7575 he 'search_fs_uu │ │ │ │ │ -00014140: 6964 2720 6d6f 6475 6c65 206d 7573 7420 id' module must │ │ │ │ │ -00014150: 6265 2069 6e63 6c75 6465 6420 696e 2074 be included in t │ │ │ │ │ -00014160: 6865 2063 6f72 6520 696d 6167 6520 666f he core image fo │ │ │ │ │ -00014170: 720a 7468 6973 2065 7861 6d70 6c65 2074 r.this example t │ │ │ │ │ -00014180: 6f20 776f 726b 2e29 0a0a 2020 2049 6e20 o work.).. In │ │ │ │ │ -00014190: 6d6f 7265 2063 6f6d 706c 6578 2063 6173 more complex cas │ │ │ │ │ -000141a0: 6573 2c20 6974 206d 6179 2062 6520 7573 es, it may be us │ │ │ │ │ -000141b0: 6566 756c 2074 6f20 7265 6164 206f 7468 eful to read oth │ │ │ │ │ -000141c0: 6572 2063 6f6e 6669 6775 7261 7469 6f6e er configuration │ │ │ │ │ -000141d0: 0a66 696c 6573 2064 6972 6563 746c 7920 .files directly │ │ │ │ │ -000141e0: 6672 6f6d 2074 6865 2065 6d62 6564 6465 from the embedde │ │ │ │ │ -000141f0: 6420 636f 6e66 6967 7572 6174 696f 6e20 d configuration │ │ │ │ │ -00014200: 6669 6c65 2e20 2054 6869 7320 616c 6c6f file. This allo │ │ │ │ │ -00014210: 7773 2073 7563 680a 7468 696e 6773 2061 ws such.things a │ │ │ │ │ -00014220: 7320 7265 6164 696e 6720 6669 6c65 7320 s reading files │ │ │ │ │ -00014230: 6e6f 7420 6361 6c6c 6564 2027 6772 7562 not called 'grub │ │ │ │ │ -00014240: 2e63 6667 272c 206f 7220 7265 6164 696e .cfg', or readin │ │ │ │ │ -00014250: 6720 6669 6c65 7320 6672 6f6d 2061 0a64 g files from a.d │ │ │ │ │ -00014260: 6972 6563 746f 7279 206f 7468 6572 2074 irectory other t │ │ │ │ │ -00014270: 6861 6e20 7468 6174 2077 6865 7265 2047 han that where G │ │ │ │ │ -00014280: 5255 4227 7320 6c6f 6164 6162 6c65 206d RUB's loadable m │ │ │ │ │ -00014290: 6f64 756c 6573 2061 7265 2069 6e73 7461 odules are insta │ │ │ │ │ -000142a0: 6c6c 6564 2e0a 546f 2064 6f20 7468 6973 lled..To do this │ │ │ │ │ -000142b0: 2c20 696e 636c 7564 6520 7468 6520 2763 , include the 'c │ │ │ │ │ -000142c0: 6f6e 6669 6766 696c 6527 2061 6e64 2027 onfigfile' and ' │ │ │ │ │ -000142d0: 6e6f 726d 616c 2720 6d6f 6475 6c65 7320 normal' modules │ │ │ │ │ -000142e0: 696e 2074 6865 2063 6f72 650a 696d 6167 in the core.imag │ │ │ │ │ -000142f0: 652c 2061 6e64 2065 6d62 6564 2061 2063 e, and embed a c │ │ │ │ │ -00014300: 6f6e 6669 6775 7261 7469 6f6e 2066 696c onfiguration fil │ │ │ │ │ -00014310: 6520 7468 6174 2075 7365 7320 7468 6520 e that uses the │ │ │ │ │ -00014320: 2763 6f6e 6669 6766 696c 6527 2063 6f6d 'configfile' com │ │ │ │ │ -00014330: 6d61 6e64 0a74 6f20 6c6f 6164 2061 6e6f mand.to load ano │ │ │ │ │ -00014340: 7468 6572 2066 696c 652e 2020 5468 6520 ther file. The │ │ │ │ │ -00014350: 666f 6c6c 6f77 696e 6720 6578 616d 706c following exampl │ │ │ │ │ -00014360: 6520 6f66 2074 6869 7320 616c 736f 2072 e of this also r │ │ │ │ │ -00014370: 6571 7569 7265 7320 7468 650a 2765 6368 equires the.'ech │ │ │ │ │ -00014380: 6f27 2c20 2773 6561 7263 685f 6c61 6265 o', 'search_labe │ │ │ │ │ -00014390: 6c27 2c20 616e 6420 2774 6573 7427 206d l', and 'test' m │ │ │ │ │ -000143a0: 6f64 756c 6573 2074 6f20 6265 2069 6e63 odules to be inc │ │ │ │ │ -000143b0: 6c75 6465 6420 696e 2074 6865 2063 6f72 luded in the cor │ │ │ │ │ -000143c0: 650a 696d 6167 653a 0a0a 2020 2020 2073 e.image:.. s │ │ │ │ │ -000143d0: 6561 7263 682e 6673 5f6c 6162 656c 2067 earch.fs_label g │ │ │ │ │ -000143e0: 7275 6220 726f 6f74 0a20 2020 2020 6966 rub root. if │ │ │ │ │ -000143f0: 205b 202d 6520 2f62 6f6f 742f 6772 7562 [ -e /boot/grub │ │ │ │ │ -00014400: 2f65 7861 6d70 6c65 2f74 6573 7431 2e63 /example/test1.c │ │ │ │ │ -00014410: 6667 205d 3b20 7468 656e 0a20 2020 2020 fg ]; then. │ │ │ │ │ -00014420: 2020 2020 7365 7420 7072 6566 6978 3d28 set prefix=( │ │ │ │ │ -00014430: 2472 6f6f 7429 2f62 6f6f 742f 6772 7562 $root)/boot/grub │ │ │ │ │ -00014440: 0a20 2020 2020 2020 2020 636f 6e66 6967 . config │ │ │ │ │ -00014450: 6669 6c65 202f 626f 6f74 2f67 7275 622f file /boot/grub/ │ │ │ │ │ -00014460: 6578 616d 706c 652f 7465 7374 312e 6366 example/test1.cf │ │ │ │ │ -00014470: 670a 2020 2020 2065 6c73 650a 2020 2020 g. else. │ │ │ │ │ -00014480: 2020 2020 2069 6620 5b20 2d65 202f 626f if [ -e /bo │ │ │ │ │ -00014490: 6f74 2f67 7275 622f 6578 616d 706c 652f ot/grub/example/ │ │ │ │ │ -000144a0: 7465 7374 322e 6366 6720 5d3b 2074 6865 test2.cfg ]; the │ │ │ │ │ -000144b0: 6e0a 2020 2020 2020 2020 2020 2020 2073 n. s │ │ │ │ │ -000144c0: 6574 2070 7265 6669 783d 2824 726f 6f74 et prefix=($root │ │ │ │ │ -000144d0: 292f 626f 6f74 2f67 7275 620a 2020 2020 )/boot/grub. │ │ │ │ │ -000144e0: 2020 2020 2020 2020 2063 6f6e 6669 6766 configf │ │ │ │ │ -000144f0: 696c 6520 2f62 6f6f 742f 6772 7562 2f65 ile /boot/grub/e │ │ │ │ │ -00014500: 7861 6d70 6c65 2f74 6573 7432 2e63 6667 xample/test2.cfg │ │ │ │ │ -00014510: 0a20 2020 2020 2020 2020 656c 7365 0a20 . else. │ │ │ │ │ -00014520: 2020 2020 2020 2020 2020 2020 6563 686f echo │ │ │ │ │ -00014530: 2022 436f 756c 6420 6e6f 7420 6669 6e64 "Could not find │ │ │ │ │ -00014540: 2061 6e20 6578 616d 706c 6520 636f 6e66 an example conf │ │ │ │ │ -00014550: 6967 7572 6174 696f 6e20 6669 6c65 2122 iguration file!" │ │ │ │ │ -00014560: 0a20 2020 2020 2020 2020 6669 0a20 2020 . fi. │ │ │ │ │ -00014570: 2020 6669 0a0a 2020 2054 6865 2065 6d62 fi.. The emb │ │ │ │ │ -00014580: 6564 6465 6420 636f 6e66 6967 7572 6174 edded configurat │ │ │ │ │ -00014590: 696f 6e20 6669 6c65 206d 6179 206e 6f74 ion file may not │ │ │ │ │ -000145a0: 2063 6f6e 7461 696e 206d 656e 7520 656e contain menu en │ │ │ │ │ -000145b0: 7472 6965 730a 6469 7265 6374 6c79 2c20 tries.directly, │ │ │ │ │ -000145c0: 6275 7420 6d61 7920 6f6e 6c79 2072 6561 but may only rea │ │ │ │ │ -000145d0: 6420 7468 656d 2066 726f 6d20 656c 7365 d them from else │ │ │ │ │ -000145e0: 7768 6572 6520 7573 696e 6720 2763 6f6e where using 'con │ │ │ │ │ -000145f0: 6669 6766 696c 6527 2e0a 0a1f 0a46 696c figfile'.....Fil │ │ │ │ │ -00014600: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ -00014610: 6f64 653a 2054 6865 6d65 2066 696c 6520 ode: Theme file │ │ │ │ │ -00014620: 666f 726d 6174 2c20 204e 6578 743a 204e format, Next: N │ │ │ │ │ -00014630: 6574 776f 726b 2c20 2050 7265 763a 2043 etwork, Prev: C │ │ │ │ │ -00014640: 6f6e 6669 6775 7261 7469 6f6e 2c20 2055 onfiguration, U │ │ │ │ │ -00014650: 703a 2054 6f70 0a0a 3720 5468 656d 6520 p: Top..7 Theme │ │ │ │ │ -00014660: 6669 6c65 2066 6f72 6d61 740a 2a2a 2a2a file format.**** │ │ │ │ │ -00014670: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a ***************. │ │ │ │ │ -00014680: 0a37 2e31 2049 6e74 726f 6475 6374 696f .7.1 Introductio │ │ │ │ │ -00014690: 6e0a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d n.============== │ │ │ │ │ -000146a0: 3d3d 0a0a 5468 6520 4752 5542 2067 7261 ==..The GRUB gra │ │ │ │ │ -000146b0: 7068 6963 616c 206d 656e 7520 7375 7070 phical menu supp │ │ │ │ │ -000146c0: 6f72 7473 2074 6865 6d65 7320 7468 6174 orts themes that │ │ │ │ │ -000146d0: 2063 616e 2063 7573 746f 6d69 7a65 2074 can customize t │ │ │ │ │ -000146e0: 6865 206c 6179 6f75 740a 616e 6420 6170 he layout.and ap │ │ │ │ │ -000146f0: 7065 6172 616e 6365 206f 6620 7468 6520 pearance of the │ │ │ │ │ -00014700: 4752 5542 2062 6f6f 7420 6d65 6e75 2e20 GRUB boot menu. │ │ │ │ │ -00014710: 2054 6865 2074 6865 6d65 2069 7320 636f The theme is co │ │ │ │ │ -00014720: 6e66 6967 7572 6564 2074 6872 6f75 6768 nfigured through │ │ │ │ │ -00014730: 2061 0a70 6c61 696e 2074 6578 7420 6669 a.plain text fi │ │ │ │ │ -00014740: 6c65 2074 6861 7420 7370 6563 6966 6965 le that specifie │ │ │ │ │ -00014750: 7320 7468 6520 6c61 796f 7574 206f 6620 s the layout of │ │ │ │ │ -00014760: 7468 6520 7661 7269 6f75 7320 4755 4920 the various GUI │ │ │ │ │ -00014770: 636f 6d70 6f6e 656e 7473 0a28 696e 636c components.(incl │ │ │ │ │ -00014780: 7564 696e 6720 7468 6520 626f 6f74 206d uding the boot m │ │ │ │ │ -00014790: 656e 752c 2074 696d 656f 7574 2070 726f enu, timeout pro │ │ │ │ │ -000147a0: 6772 6573 7320 6261 722c 2061 6e64 2074 gress bar, and t │ │ │ │ │ -000147b0: 6578 7420 6d65 7373 6167 6573 2920 6173 ext messages) as │ │ │ │ │ -000147c0: 0a77 656c 6c20 6173 2074 6865 2061 7070 .well as the app │ │ │ │ │ -000147d0: 6561 7261 6e63 6520 7573 696e 6720 636f earance using co │ │ │ │ │ -000147e0: 6c6f 7273 2c20 666f 6e74 732c 2061 6e64 lors, fonts, and │ │ │ │ │ -000147f0: 2069 6d61 6765 732e 2020 4578 616d 706c images. Exampl │ │ │ │ │ -00014800: 6520 6973 0a61 7661 696c 6162 6c65 2069 e is.available i │ │ │ │ │ -00014810: 6e20 646f 6373 2f65 7861 6d70 6c65 5f74 n docs/example_t │ │ │ │ │ -00014820: 6865 6d65 2e74 7874 0a0a 372e 3220 5468 heme.txt..7.2 Th │ │ │ │ │ -00014830: 656d 6520 456c 656d 656e 7473 0a3d 3d3d eme Elements.=== │ │ │ │ │ -00014840: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a ===============. │ │ │ │ │ -00014850: 0a37 2e32 2e31 2043 6f6c 6f72 730a 2d2d .7.2.1 Colors.-- │ │ │ │ │ -00014860: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 436f 6c6f ----------..Colo │ │ │ │ │ -00014870: 7273 2063 616e 2062 6520 7370 6563 6966 rs can be specif │ │ │ │ │ -00014880: 6965 6420 696e 2073 6576 6572 616c 2077 ied in several w │ │ │ │ │ -00014890: 6179 733a 0a0a 2020 202a 2048 544d 4c2d ays:.. * HTML- │ │ │ │ │ -000148a0: 7374 796c 6520 2223 5252 4747 4242 2220 style "#RRGGBB" │ │ │ │ │ -000148b0: 6f72 2022 2352 4742 2220 666f 726d 6174 or "#RGB" format │ │ │ │ │ -000148c0: 2c20 7768 6572 6520 2a52 2a2c 202a 472a , where *R*, *G* │ │ │ │ │ -000148d0: 2c20 616e 6420 2a42 2a20 6172 650a 2020 , and *B* are. │ │ │ │ │ -000148e0: 2020 2068 6578 6164 6563 696d 616c 2064 hexadecimal d │ │ │ │ │ -000148f0: 6967 6974 7320 2865 2e67 2e2c 2022 2338 igits (e.g., "#8 │ │ │ │ │ -00014900: 3839 3946 4622 290a 2020 202a 2061 7320 899FF"). * as │ │ │ │ │ -00014910: 636f 6d6d 612d 7365 7061 7261 7465 6420 comma-separated │ │ │ │ │ -00014920: 6465 6369 6d61 6c20 5247 4220 7661 6c75 decimal RGB valu │ │ │ │ │ -00014930: 6573 2028 652e 672e 2c20 2231 3238 2c20 es (e.g., "128, │ │ │ │ │ -00014940: 3132 382c 2032 3535 2229 0a20 2020 2a20 128, 255"). * │ │ │ │ │ -00014950: 7769 7468 2022 5356 4720 312e 3020 636f with "SVG 1.0 co │ │ │ │ │ -00014960: 6c6f 7220 6e61 6d65 7322 2028 652e 672e lor names" (e.g. │ │ │ │ │ -00014970: 2c20 2263 6f72 6e66 6c6f 7765 7262 6c75 , "cornflowerblu │ │ │ │ │ -00014980: 6522 2920 7768 6963 6820 6d75 7374 2062 e") which must b │ │ │ │ │ -00014990: 650a 2020 2020 2073 7065 6369 6669 6564 e. specified │ │ │ │ │ -000149a0: 2069 6e20 6c6f 7765 7263 6173 652e 0a0a in lowercase... │ │ │ │ │ -000149b0: 372e 322e 3220 466f 6e74 730a 2d2d 2d2d 7.2.2 Fonts.---- │ │ │ │ │ -000149c0: 2d2d 2d2d 2d2d 2d0a 0a54 6865 2066 6f6e -------..The fon │ │ │ │ │ -000149d0: 7473 2047 5255 4220 7573 6573 2022 5046 ts GRUB uses "PF │ │ │ │ │ -000149e0: 4632 2066 6f6e 7420 666f 726d 6174 2220 F2 font format" │ │ │ │ │ -000149f0: 6269 746d 6170 2066 6f6e 7473 2e20 2046 bitmap fonts. F │ │ │ │ │ -00014a00: 6f6e 7473 2061 7265 0a73 7065 6369 6669 onts are.specifi │ │ │ │ │ -00014a10: 6564 2077 6974 6820 6675 6c6c 2066 6f6e ed with full fon │ │ │ │ │ -00014a20: 7420 6e61 6d65 732e 2020 4375 7272 656e t names. Curren │ │ │ │ │ -00014a30: 746c 7920 7468 6572 6520 6973 206e 6f20 tly there is no │ │ │ │ │ -00014a40: 7072 6f76 6973 696f 6e20 666f 7220 610a provision for a. │ │ │ │ │ -00014a50: 7072 6566 6572 656e 6365 206c 6973 7420 preference list │ │ │ │ │ -00014a60: 6f66 2066 6f6e 7473 2c20 6f72 2064 6572 of fonts, or der │ │ │ │ │ -00014a70: 6976 696e 6720 6f6e 6520 666f 6e74 2066 iving one font f │ │ │ │ │ -00014a80: 726f 6d20 616e 6f74 6865 722e 2020 466f rom another. Fo │ │ │ │ │ -00014a90: 6e74 7320 6172 650a 6c6f 6164 6564 2077 nts are.loaded w │ │ │ │ │ -00014aa0: 6974 6820 7468 6520 226c 6f61 6466 6f6e ith the "loadfon │ │ │ │ │ -00014ab0: 7422 2063 6f6d 6d61 6e64 2069 6e20 4752 t" command in GR │ │ │ │ │ -00014ac0: 5542 2028 2a6e 6f74 6520 6c6f 6164 666f UB (*note loadfo │ │ │ │ │ -00014ad0: 6e74 3a3a 292e 2020 546f 2073 6565 0a74 nt::). To see.t │ │ │ │ │ -00014ae0: 6865 206c 6973 7420 6f66 206c 6f61 6465 he list of loade │ │ │ │ │ -00014af0: 6420 666f 6e74 732c 2065 7865 6375 7465 d fonts, execute │ │ │ │ │ -00014b00: 2074 6865 2022 6c73 666f 6e74 7322 2063 the "lsfonts" c │ │ │ │ │ -00014b10: 6f6d 6d61 6e64 2028 2a6e 6f74 650a 6c73 ommand (*note.ls │ │ │ │ │ -00014b20: 666f 6e74 733a 3a29 2e20 2049 6620 7468 fonts::). If th │ │ │ │ │ -00014b30: 6572 6520 6172 6520 746f 6f20 6d61 6e79 ere are too many │ │ │ │ │ -00014b40: 2066 6f6e 7473 2074 6f20 6669 7420 6f6e fonts to fit on │ │ │ │ │ -00014b50: 2073 6372 6565 6e2c 2064 6f20 2273 6574 screen, do "set │ │ │ │ │ -00014b60: 0a70 6167 6572 3d31 2220 6265 666f 7265 .pager=1" before │ │ │ │ │ -00014b70: 2065 7865 6375 7469 6e67 2022 6c73 666f executing "lsfo │ │ │ │ │ -00014b80: 6e74 7322 2e0a 0a37 2e32 2e33 2050 726f nts"...7.2.3 Pro │ │ │ │ │ -00014b90: 6772 6573 7320 4261 720a 2d2d 2d2d 2d2d gress Bar.------ │ │ │ │ │ -00014ba0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 4669 ------------..Fi │ │ │ │ │ -00014bb0: 6775 7265 2037 2e31 0a0a 4669 6775 7265 gure 7.1..Figure │ │ │ │ │ -00014bc0: 2037 2e32 0a0a 5072 6f67 7265 7373 2062 7.2..Progress b │ │ │ │ │ -00014bd0: 6172 7320 6172 6520 7573 6564 2074 6f20 ars are used to │ │ │ │ │ -00014be0: 6469 7370 6c61 7920 7468 6520 7265 6d61 display the rema │ │ │ │ │ -00014bf0: 696e 696e 6720 7469 6d65 2062 6566 6f72 ining time befor │ │ │ │ │ -00014c00: 6520 4752 5542 2062 6f6f 7473 0a74 6865 e GRUB boots.the │ │ │ │ │ -00014c10: 2064 6566 6175 6c74 206d 656e 7520 656e default menu en │ │ │ │ │ -00014c20: 7472 792e 2020 546f 2063 7265 6174 6520 try. To create │ │ │ │ │ -00014c30: 6120 7072 6f67 7265 7373 2062 6172 2074 a progress bar t │ │ │ │ │ -00014c40: 6861 7420 7769 6c6c 2064 6973 706c 6179 hat will display │ │ │ │ │ -00014c50: 2074 6865 0a72 656d 6169 6e69 6e67 2074 the.remaining t │ │ │ │ │ -00014c60: 696d 6520 6265 666f 7265 2061 7574 6f6d ime before autom │ │ │ │ │ -00014c70: 6174 6963 2062 6f6f 742c 2073 696d 706c atic boot, simpl │ │ │ │ │ -00014c80: 7920 6372 6561 7465 2061 2022 7072 6f67 y create a "prog │ │ │ │ │ -00014c90: 7265 7373 5f62 6172 220a 636f 6d70 6f6e ress_bar".compon │ │ │ │ │ -00014ca0: 656e 7420 7769 7468 2074 6865 2069 6420 ent with the id │ │ │ │ │ -00014cb0: 225f 5f74 696d 656f 7574 5f5f 222e 2020 "__timeout__". │ │ │ │ │ -00014cc0: 5468 6973 2069 6e64 6963 6174 6573 2074 This indicates t │ │ │ │ │ -00014cd0: 6f20 4752 5542 2074 6861 7420 7468 650a o GRUB that the. │ │ │ │ │ -00014ce0: 7072 6f67 7265 7373 2062 6172 2073 686f progress bar sho │ │ │ │ │ -00014cf0: 756c 6420 6265 2075 7064 6174 6564 2061 uld be updated a │ │ │ │ │ -00014d00: 7320 7469 6d65 2070 6173 7365 732c 2061 s time passes, a │ │ │ │ │ -00014d10: 6e64 2069 7420 7368 6f75 6c64 2062 6520 nd it should be │ │ │ │ │ -00014d20: 6d61 6465 0a69 6e76 6973 6962 6c65 2069 made.invisible i │ │ │ │ │ -00014d30: 6620 7468 6520 636f 756e 7464 6f77 6e20 f the countdown │ │ │ │ │ -00014d40: 746f 2061 7574 6f6d 6174 6963 2062 6f6f to automatic boo │ │ │ │ │ -00014d50: 7420 6973 2069 6e74 6572 7275 7074 6564 t is interrupted │ │ │ │ │ -00014d60: 2062 7920 7468 6520 7573 6572 2e0a 0a20 by the user... │ │ │ │ │ -00014d70: 2020 5072 6f67 7265 7373 2062 6172 7320 Progress bars │ │ │ │ │ -00014d80: 6d61 7920 6f70 7469 6f6e 616c 6c79 2068 may optionally h │ │ │ │ │ -00014d90: 6176 6520 7465 7874 2064 6973 706c 6179 ave text display │ │ │ │ │ -00014da0: 6564 206f 6e20 7468 656d 2e20 2054 6869 ed on them. Thi │ │ │ │ │ -00014db0: 7320 7465 7874 0a69 7320 636f 6e74 726f s text.is contro │ │ │ │ │ -00014dc0: 6c6c 6564 2062 7920 7661 7269 6162 6c65 lled by variable │ │ │ │ │ -00014dd0: 2022 7465 7874 2220 7768 6963 6820 636f "text" which co │ │ │ │ │ -00014de0: 6e74 6169 6e73 2061 2070 7269 6e74 6620 ntains a printf │ │ │ │ │ -00014df0: 7465 6d70 6c61 7465 2077 6974 680a 7468 template with.th │ │ │ │ │ -00014e00: 6520 6f6e 6c79 2061 7267 756d 656e 7420 e only argument │ │ │ │ │ -00014e10: 2564 2069 7320 7468 6520 6e75 6d62 6572 %d is the number │ │ │ │ │ -00014e20: 206f 6620 7365 636f 6e64 7320 7265 6d61 of seconds rema │ │ │ │ │ -00014e30: 696e 696e 672e 2020 4164 6469 7469 6f6e ining. Addition │ │ │ │ │ -00014e40: 616c 6c79 0a73 7065 6369 616c 2076 616c ally.special val │ │ │ │ │ -00014e50: 7565 7320 2240 5449 4d45 4f55 545f 4e4f ues "@TIMEOUT_NO │ │ │ │ │ -00014e60: 5449 4649 4341 5449 4f4e 5f53 484f 5254 TIFICATION_SHORT │ │ │ │ │ -00014e70: 4022 2c0a 2240 5449 4d45 4f55 545f 4e4f @",."@TIMEOUT_NO │ │ │ │ │ -00014e80: 5449 4649 4341 5449 4f4e 5f4d 4944 444c TIFICATION_MIDDL │ │ │ │ │ -00014e90: 4540 222c 2022 4054 494d 454f 5554 5f4e E@", "@TIMEOUT_N │ │ │ │ │ -00014ea0: 4f54 4946 4943 4154 494f 4e5f 4c4f 4e47 OTIFICATION_LONG │ │ │ │ │ -00014eb0: 4022 2061 7265 0a72 6570 6c61 6365 6420 @" are.replaced │ │ │ │ │ -00014ec0: 7769 7468 2073 7461 6e64 6172 6420 616e with standard an │ │ │ │ │ -00014ed0: 6420 7472 616e 736c 6174 6564 2074 656d d translated tem │ │ │ │ │ -00014ee0: 706c 6174 6573 2e0a 0a37 2e32 2e34 2043 plates...7.2.4 C │ │ │ │ │ -00014ef0: 6972 6375 6c61 7220 5072 6f67 7265 7373 ircular Progress │ │ │ │ │ -00014f00: 2049 6e64 6963 6174 6f72 0a2d 2d2d 2d2d Indicator.----- │ │ │ │ │ +00013ba0: 3d3d 3d3d 3d0a 0a47 5255 4220 7375 7070 =====..GRUB supp │ │ │ │ │ +00013bb0: 6f72 7473 2065 6d62 6564 6469 6e67 2061 orts embedding a │ │ │ │ │ +00013bc0: 2063 6f6e 6669 6775 7261 7469 6f6e 2066 configuration f │ │ │ │ │ +00013bd0: 696c 6520 6469 7265 6374 6c79 2069 6e74 ile directly int │ │ │ │ │ +00013be0: 6f20 7468 6520 636f 7265 0a69 6d61 6765 o the core.image │ │ │ │ │ +00013bf0: 2c20 736f 2074 6861 7420 6974 2069 7320 , so that it is │ │ │ │ │ +00013c00: 6c6f 6164 6564 2062 6566 6f72 6520 656e loaded before en │ │ │ │ │ +00013c10: 7465 7269 6e67 206e 6f72 6d61 6c20 6d6f tering normal mo │ │ │ │ │ +00013c20: 6465 2e20 2054 6869 7320 6973 0a75 7365 de. This is.use │ │ │ │ │ +00013c30: 6675 6c2c 2066 6f72 2065 7861 6d70 6c65 ful, for example │ │ │ │ │ +00013c40: 2c20 7768 656e 2069 7420 6973 206e 6f74 , when it is not │ │ │ │ │ +00013c50: 2073 7472 6169 6768 7466 6f72 7761 7264 straightforward │ │ │ │ │ +00013c60: 2074 6f20 6669 6e64 2074 6865 2072 6561 to find the rea │ │ │ │ │ +00013c70: 6c0a 636f 6e66 6967 7572 6174 696f 6e20 l.configuration │ │ │ │ │ +00013c80: 6669 6c65 2c20 6f72 2077 6865 6e20 796f file, or when yo │ │ │ │ │ +00013c90: 7520 6e65 6564 2074 6f20 6465 6275 6720 u need to debug │ │ │ │ │ +00013ca0: 7072 6f62 6c65 6d73 2077 6974 6820 6c6f problems with lo │ │ │ │ │ +00013cb0: 6164 696e 6720 7468 6174 0a66 696c 652e ading that.file. │ │ │ │ │ +00013cc0: 2020 2767 7275 622d 696e 7374 616c 6c27 'grub-install' │ │ │ │ │ +00013cd0: 2075 7365 7320 7468 6973 2066 6561 7475 uses this featu │ │ │ │ │ +00013ce0: 7265 2077 6865 6e20 6974 2069 7320 6e6f re when it is no │ │ │ │ │ +00013cf0: 7420 7573 696e 6720 4249 4f53 2064 6973 t using BIOS dis │ │ │ │ │ +00013d00: 6b0a 6675 6e63 7469 6f6e 7320 6f72 2077 k.functions or w │ │ │ │ │ +00013d10: 6865 6e20 696e 7374 616c 6c69 6e67 2074 hen installing t │ │ │ │ │ +00013d20: 6f20 6120 6469 6666 6572 656e 7420 6469 o a different di │ │ │ │ │ +00013d30: 736b 2066 726f 6d20 7468 6520 6f6e 6520 sk from the one │ │ │ │ │ +00013d40: 636f 6e74 6169 6e69 6e67 0a27 2f62 6f6f containing.'/boo │ │ │ │ │ +00013d50: 742f 6772 7562 272c 2069 6e20 7768 6963 t/grub', in whic │ │ │ │ │ +00013d60: 6820 6361 7365 2069 7420 6e65 6564 7320 h case it needs │ │ │ │ │ +00013d70: 746f 2075 7365 2074 6865 2027 7365 6172 to use the 'sear │ │ │ │ │ +00013d80: 6368 2720 636f 6d6d 616e 6420 282a 6e6f ch' command (*no │ │ │ │ │ +00013d90: 7465 0a73 6561 7263 683a 3a29 2074 6f20 te.search::) to │ │ │ │ │ +00013da0: 6669 6e64 2027 2f62 6f6f 742f 6772 7562 find '/boot/grub │ │ │ │ │ +00013db0: 272e 0a0a 2020 2054 6f20 656d 6265 6420 '... To embed │ │ │ │ │ +00013dc0: 6120 636f 6e66 6967 7572 6174 696f 6e20 a configuration │ │ │ │ │ +00013dd0: 6669 6c65 2c20 7573 6520 7468 6520 272d file, use the '- │ │ │ │ │ +00013de0: 6327 206f 7074 696f 6e20 746f 2027 6772 c' option to 'gr │ │ │ │ │ +00013df0: 7562 2d6d 6b69 6d61 6765 272e 0a54 6865 ub-mkimage'..The │ │ │ │ │ +00013e00: 2066 696c 6520 6973 2063 6f70 6965 6420 file is copied │ │ │ │ │ +00013e10: 696e 746f 2074 6865 2063 6f72 6520 696d into the core im │ │ │ │ │ +00013e20: 6167 652c 2073 6f20 6974 206d 6179 2072 age, so it may r │ │ │ │ │ +00013e30: 6573 6964 6520 616e 7977 6865 7265 206f eside anywhere o │ │ │ │ │ +00013e40: 6e20 7468 650a 6669 6c65 2073 7973 7465 n the.file syste │ │ │ │ │ +00013e50: 6d2c 2061 6e64 206d 6179 2062 6520 7265 m, and may be re │ │ │ │ │ +00013e60: 6d6f 7665 6420 6166 7465 7220 7275 6e6e moved after runn │ │ │ │ │ +00013e70: 696e 6720 2767 7275 622d 6d6b 696d 6167 ing 'grub-mkimag │ │ │ │ │ +00013e80: 6527 2e0a 0a20 2020 4166 7465 7220 7468 e'... After th │ │ │ │ │ +00013e90: 6520 656d 6265 6464 6564 2063 6f6e 6669 e embedded confi │ │ │ │ │ +00013ea0: 6775 7261 7469 6f6e 2066 696c 6520 2869 guration file (i │ │ │ │ │ +00013eb0: 6620 616e 7929 2069 7320 6578 6563 7574 f any) is execut │ │ │ │ │ +00013ec0: 6564 2c20 4752 5542 2077 696c 6c0a 6c6f ed, GRUB will.lo │ │ │ │ │ +00013ed0: 6164 2074 6865 2027 6e6f 726d 616c 2720 ad the 'normal' │ │ │ │ │ +00013ee0: 6d6f 6475 6c65 2028 2a6e 6f74 6520 6e6f module (*note no │ │ │ │ │ +00013ef0: 726d 616c 3a3a 292c 2077 6869 6368 2077 rmal::), which w │ │ │ │ │ +00013f00: 696c 6c20 7468 656e 2072 6561 6420 7468 ill then read th │ │ │ │ │ +00013f10: 6520 7265 616c 0a63 6f6e 6669 6775 7261 e real.configura │ │ │ │ │ +00013f20: 7469 6f6e 2066 696c 6520 6672 6f6d 2027 tion file from ' │ │ │ │ │ +00013f30: 2470 7265 6669 782f 6772 7562 2e63 6667 $prefix/grub.cfg │ │ │ │ │ +00013f40: 272e 2020 4279 2074 6869 7320 706f 696e '. By this poin │ │ │ │ │ +00013f50: 742c 2074 6865 2027 726f 6f74 270a 7661 t, the 'root'.va │ │ │ │ │ +00013f60: 7269 6162 6c65 2077 696c 6c20 616c 736f riable will also │ │ │ │ │ +00013f70: 2068 6176 6520 6265 656e 2073 6574 2074 have been set t │ │ │ │ │ +00013f80: 6f20 7468 6520 726f 6f74 2064 6576 6963 o the root devic │ │ │ │ │ +00013f90: 6520 6e61 6d65 2e20 2046 6f72 2065 7861 e name. For exa │ │ │ │ │ +00013fa0: 6d70 6c65 2c0a 2770 7265 6669 7827 206d mple,.'prefix' m │ │ │ │ │ +00013fb0: 6967 6874 2062 6520 7365 7420 746f 2027 ight be set to ' │ │ │ │ │ +00013fc0: 2868 6430 2c31 292f 626f 6f74 2f67 7275 (hd0,1)/boot/gru │ │ │ │ │ +00013fd0: 6227 2c20 616e 6420 2772 6f6f 7427 206d b', and 'root' m │ │ │ │ │ +00013fe0: 6967 6874 2062 6520 7365 7420 746f 0a27 ight be set to.' │ │ │ │ │ +00013ff0: 6864 302c 3127 2e20 2054 6875 732c 2069 hd0,1'. Thus, i │ │ │ │ │ +00014000: 6e20 6d6f 7374 2063 6173 6573 2c20 7468 n most cases, th │ │ │ │ │ +00014010: 6520 656d 6265 6464 6564 2063 6f6e 6669 e embedded confi │ │ │ │ │ +00014020: 6775 7261 7469 6f6e 2066 696c 6520 6f6e guration file on │ │ │ │ │ +00014030: 6c79 0a6e 6565 6473 2074 6f20 7365 7420 ly.needs to set │ │ │ │ │ +00014040: 7468 6520 2770 7265 6669 7827 2061 6e64 the 'prefix' and │ │ │ │ │ +00014050: 2027 726f 6f74 2720 7661 7269 6162 6c65 'root' variable │ │ │ │ │ +00014060: 732c 2061 6e64 2074 6865 6e20 6472 6f70 s, and then drop │ │ │ │ │ +00014070: 2074 6872 6f75 6768 2074 6f0a 4752 5542 through to.GRUB │ │ │ │ │ +00014080: 2773 206e 6f72 6d61 6c20 7072 6f63 6573 's normal proces │ │ │ │ │ +00014090: 7369 6e67 2e20 2041 2074 7970 6963 616c sing. A typical │ │ │ │ │ +000140a0: 2065 7861 6d70 6c65 206f 6620 7468 6973 example of this │ │ │ │ │ +000140b0: 206d 6967 6874 206c 6f6f 6b20 6c69 6b65 might look like │ │ │ │ │ +000140c0: 0a74 6869 733a 0a0a 2020 2020 2073 6561 .this:.. sea │ │ │ │ │ +000140d0: 7263 682e 6673 5f75 7569 6420 3031 3233 rch.fs_uuid 0123 │ │ │ │ │ +000140e0: 3435 3637 2d38 3961 622d 6364 6566 2d30 4567-89ab-cdef-0 │ │ │ │ │ +000140f0: 3132 332d 3435 3637 3839 6162 6364 6566 123-456789abcdef │ │ │ │ │ +00014100: 2072 6f6f 740a 2020 2020 2073 6574 2070 root. set p │ │ │ │ │ +00014110: 7265 6669 783d 2824 726f 6f74 292f 626f refix=($root)/bo │ │ │ │ │ +00014120: 6f74 2f67 7275 620a 0a20 2020 2854 6865 ot/grub.. (The │ │ │ │ │ +00014130: 2027 7365 6172 6368 5f66 735f 7575 6964 'search_fs_uuid │ │ │ │ │ +00014140: 2720 6d6f 6475 6c65 206d 7573 7420 6265 ' module must be │ │ │ │ │ +00014150: 2069 6e63 6c75 6465 6420 696e 2074 6865 included in the │ │ │ │ │ +00014160: 2063 6f72 6520 696d 6167 6520 666f 720a core image for. │ │ │ │ │ +00014170: 7468 6973 2065 7861 6d70 6c65 2074 6f20 this example to │ │ │ │ │ +00014180: 776f 726b 2e29 0a0a 2020 2049 6e20 6d6f work.).. In mo │ │ │ │ │ +00014190: 7265 2063 6f6d 706c 6578 2063 6173 6573 re complex cases │ │ │ │ │ +000141a0: 2c20 6974 206d 6179 2062 6520 7573 6566 , it may be usef │ │ │ │ │ +000141b0: 756c 2074 6f20 7265 6164 206f 7468 6572 ul to read other │ │ │ │ │ +000141c0: 2063 6f6e 6669 6775 7261 7469 6f6e 0a66 configuration.f │ │ │ │ │ +000141d0: 696c 6573 2064 6972 6563 746c 7920 6672 iles directly fr │ │ │ │ │ +000141e0: 6f6d 2074 6865 2065 6d62 6564 6465 6420 om the embedded │ │ │ │ │ +000141f0: 636f 6e66 6967 7572 6174 696f 6e20 6669 configuration fi │ │ │ │ │ +00014200: 6c65 2e20 2054 6869 7320 616c 6c6f 7773 le. This allows │ │ │ │ │ +00014210: 2073 7563 680a 7468 696e 6773 2061 7320 such.things as │ │ │ │ │ +00014220: 7265 6164 696e 6720 6669 6c65 7320 6e6f reading files no │ │ │ │ │ +00014230: 7420 6361 6c6c 6564 2027 6772 7562 2e63 t called 'grub.c │ │ │ │ │ +00014240: 6667 272c 206f 7220 7265 6164 696e 6720 fg', or reading │ │ │ │ │ +00014250: 6669 6c65 7320 6672 6f6d 2061 0a64 6972 files from a.dir │ │ │ │ │ +00014260: 6563 746f 7279 206f 7468 6572 2074 6861 ectory other tha │ │ │ │ │ +00014270: 6e20 7468 6174 2077 6865 7265 2047 5255 n that where GRU │ │ │ │ │ +00014280: 4227 7320 6c6f 6164 6162 6c65 206d 6f64 B's loadable mod │ │ │ │ │ +00014290: 756c 6573 2061 7265 2069 6e73 7461 6c6c ules are install │ │ │ │ │ +000142a0: 6564 2e0a 546f 2064 6f20 7468 6973 2c20 ed..To do this, │ │ │ │ │ +000142b0: 696e 636c 7564 6520 7468 6520 2763 6f6e include the 'con │ │ │ │ │ +000142c0: 6669 6766 696c 6527 2061 6e64 2027 6e6f figfile' and 'no │ │ │ │ │ +000142d0: 726d 616c 2720 6d6f 6475 6c65 7320 696e rmal' modules in │ │ │ │ │ +000142e0: 2074 6865 2063 6f72 650a 696d 6167 652c the core.image, │ │ │ │ │ +000142f0: 2061 6e64 2065 6d62 6564 2061 2063 6f6e and embed a con │ │ │ │ │ +00014300: 6669 6775 7261 7469 6f6e 2066 696c 6520 figuration file │ │ │ │ │ +00014310: 7468 6174 2075 7365 7320 7468 6520 2763 that uses the 'c │ │ │ │ │ +00014320: 6f6e 6669 6766 696c 6527 2063 6f6d 6d61 onfigfile' comma │ │ │ │ │ +00014330: 6e64 0a74 6f20 6c6f 6164 2061 6e6f 7468 nd.to load anoth │ │ │ │ │ +00014340: 6572 2066 696c 652e 2020 5468 6520 666f er file. The fo │ │ │ │ │ +00014350: 6c6c 6f77 696e 6720 6578 616d 706c 6520 llowing example │ │ │ │ │ +00014360: 6f66 2074 6869 7320 616c 736f 2072 6571 of this also req │ │ │ │ │ +00014370: 7569 7265 7320 7468 650a 2765 6368 6f27 uires the.'echo' │ │ │ │ │ +00014380: 2c20 2773 6561 7263 685f 6c61 6265 6c27 , 'search_label' │ │ │ │ │ +00014390: 2c20 616e 6420 2774 6573 7427 206d 6f64 , and 'test' mod │ │ │ │ │ +000143a0: 756c 6573 2074 6f20 6265 2069 6e63 6c75 ules to be inclu │ │ │ │ │ +000143b0: 6465 6420 696e 2074 6865 2063 6f72 650a ded in the core. │ │ │ │ │ +000143c0: 696d 6167 653a 0a0a 2020 2020 2073 6561 image:.. sea │ │ │ │ │ +000143d0: 7263 682e 6673 5f6c 6162 656c 2067 7275 rch.fs_label gru │ │ │ │ │ +000143e0: 6220 726f 6f74 0a20 2020 2020 6966 205b b root. if [ │ │ │ │ │ +000143f0: 202d 6520 2f62 6f6f 742f 6772 7562 2f65 -e /boot/grub/e │ │ │ │ │ +00014400: 7861 6d70 6c65 2f74 6573 7431 2e63 6667 xample/test1.cfg │ │ │ │ │ +00014410: 205d 3b20 7468 656e 0a20 2020 2020 2020 ]; then. │ │ │ │ │ +00014420: 2020 7365 7420 7072 6566 6978 3d28 2472 set prefix=($r │ │ │ │ │ +00014430: 6f6f 7429 2f62 6f6f 742f 6772 7562 0a20 oot)/boot/grub. │ │ │ │ │ +00014440: 2020 2020 2020 2020 636f 6e66 6967 6669 configfi │ │ │ │ │ +00014450: 6c65 202f 626f 6f74 2f67 7275 622f 6578 le /boot/grub/ex │ │ │ │ │ +00014460: 616d 706c 652f 7465 7374 312e 6366 670a ample/test1.cfg. │ │ │ │ │ +00014470: 2020 2020 2065 6c73 650a 2020 2020 2020 else. │ │ │ │ │ +00014480: 2020 2069 6620 5b20 2d65 202f 626f 6f74 if [ -e /boot │ │ │ │ │ +00014490: 2f67 7275 622f 6578 616d 706c 652f 7465 /grub/example/te │ │ │ │ │ +000144a0: 7374 322e 6366 6720 5d3b 2074 6865 6e0a st2.cfg ]; then. │ │ │ │ │ +000144b0: 2020 2020 2020 2020 2020 2020 2073 6574 set │ │ │ │ │ +000144c0: 2070 7265 6669 783d 2824 726f 6f74 292f prefix=($root)/ │ │ │ │ │ +000144d0: 626f 6f74 2f67 7275 620a 2020 2020 2020 boot/grub. │ │ │ │ │ +000144e0: 2020 2020 2020 2063 6f6e 6669 6766 696c configfil │ │ │ │ │ +000144f0: 6520 2f62 6f6f 742f 6772 7562 2f65 7861 e /boot/grub/exa │ │ │ │ │ +00014500: 6d70 6c65 2f74 6573 7432 2e63 6667 0a20 mple/test2.cfg. │ │ │ │ │ +00014510: 2020 2020 2020 2020 656c 7365 0a20 2020 else. │ │ │ │ │ +00014520: 2020 2020 2020 2020 2020 6563 686f 2022 echo " │ │ │ │ │ +00014530: 436f 756c 6420 6e6f 7420 6669 6e64 2061 Could not find a │ │ │ │ │ +00014540: 6e20 6578 616d 706c 6520 636f 6e66 6967 n example config │ │ │ │ │ +00014550: 7572 6174 696f 6e20 6669 6c65 2122 0a20 uration file!". │ │ │ │ │ +00014560: 2020 2020 2020 2020 6669 0a20 2020 2020 fi. │ │ │ │ │ +00014570: 6669 0a0a 2020 2054 6865 2065 6d62 6564 fi.. The embed │ │ │ │ │ +00014580: 6465 6420 636f 6e66 6967 7572 6174 696f ded configuratio │ │ │ │ │ +00014590: 6e20 6669 6c65 206d 6179 206e 6f74 2063 n file may not c │ │ │ │ │ +000145a0: 6f6e 7461 696e 206d 656e 7520 656e 7472 ontain menu entr │ │ │ │ │ +000145b0: 6965 730a 6469 7265 6374 6c79 2c20 6275 ies.directly, bu │ │ │ │ │ +000145c0: 7420 6d61 7920 6f6e 6c79 2072 6561 6420 t may only read │ │ │ │ │ +000145d0: 7468 656d 2066 726f 6d20 656c 7365 7768 them from elsewh │ │ │ │ │ +000145e0: 6572 6520 7573 696e 6720 2763 6f6e 6669 ere using 'confi │ │ │ │ │ +000145f0: 6766 696c 6527 2e0a 0a1f 0a46 696c 653a gfile'.....File: │ │ │ │ │ +00014600: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ +00014610: 653a 2054 6865 6d65 2066 696c 6520 666f e: Theme file fo │ │ │ │ │ +00014620: 726d 6174 2c20 204e 6578 743a 204e 6574 rmat, Next: Net │ │ │ │ │ +00014630: 776f 726b 2c20 2050 7265 763a 2043 6f6e work, Prev: Con │ │ │ │ │ +00014640: 6669 6775 7261 7469 6f6e 2c20 2055 703a figuration, Up: │ │ │ │ │ +00014650: 2054 6f70 0a0a 3720 5468 656d 6520 6669 Top..7 Theme fi │ │ │ │ │ +00014660: 6c65 2066 6f72 6d61 740a 2a2a 2a2a 2a2a le format.****** │ │ │ │ │ +00014670: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a37 *************..7 │ │ │ │ │ +00014680: 2e31 2049 6e74 726f 6475 6374 696f 6e0a .1 Introduction. │ │ │ │ │ +00014690: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ +000146a0: 0a0a 5468 6520 4752 5542 2067 7261 7068 ..The GRUB graph │ │ │ │ │ +000146b0: 6963 616c 206d 656e 7520 7375 7070 6f72 ical menu suppor │ │ │ │ │ +000146c0: 7473 2074 6865 6d65 7320 7468 6174 2063 ts themes that c │ │ │ │ │ +000146d0: 616e 2063 7573 746f 6d69 7a65 2074 6865 an customize the │ │ │ │ │ +000146e0: 206c 6179 6f75 740a 616e 6420 6170 7065 layout.and appe │ │ │ │ │ +000146f0: 6172 616e 6365 206f 6620 7468 6520 4752 arance of the GR │ │ │ │ │ +00014700: 5542 2062 6f6f 7420 6d65 6e75 2e20 2054 UB boot menu. T │ │ │ │ │ +00014710: 6865 2074 6865 6d65 2069 7320 636f 6e66 he theme is conf │ │ │ │ │ +00014720: 6967 7572 6564 2074 6872 6f75 6768 2061 igured through a │ │ │ │ │ +00014730: 0a70 6c61 696e 2074 6578 7420 6669 6c65 .plain text file │ │ │ │ │ +00014740: 2074 6861 7420 7370 6563 6966 6965 7320 that specifies │ │ │ │ │ +00014750: 7468 6520 6c61 796f 7574 206f 6620 7468 the layout of th │ │ │ │ │ +00014760: 6520 7661 7269 6f75 7320 4755 4920 636f e various GUI co │ │ │ │ │ +00014770: 6d70 6f6e 656e 7473 0a28 696e 636c 7564 mponents.(includ │ │ │ │ │ +00014780: 696e 6720 7468 6520 626f 6f74 206d 656e ing the boot men │ │ │ │ │ +00014790: 752c 2074 696d 656f 7574 2070 726f 6772 u, timeout progr │ │ │ │ │ +000147a0: 6573 7320 6261 722c 2061 6e64 2074 6578 ess bar, and tex │ │ │ │ │ +000147b0: 7420 6d65 7373 6167 6573 2920 6173 0a77 t messages) as.w │ │ │ │ │ +000147c0: 656c 6c20 6173 2074 6865 2061 7070 6561 ell as the appea │ │ │ │ │ +000147d0: 7261 6e63 6520 7573 696e 6720 636f 6c6f rance using colo │ │ │ │ │ +000147e0: 7273 2c20 666f 6e74 732c 2061 6e64 2069 rs, fonts, and i │ │ │ │ │ +000147f0: 6d61 6765 732e 2020 4578 616d 706c 6520 mages. Example │ │ │ │ │ +00014800: 6973 0a61 7661 696c 6162 6c65 2069 6e20 is.available in │ │ │ │ │ +00014810: 646f 6373 2f65 7861 6d70 6c65 5f74 6865 docs/example_the │ │ │ │ │ +00014820: 6d65 2e74 7874 0a0a 372e 3220 5468 656d me.txt..7.2 Them │ │ │ │ │ +00014830: 6520 456c 656d 656e 7473 0a3d 3d3d 3d3d e Elements.===== │ │ │ │ │ +00014840: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a37 =============..7 │ │ │ │ │ +00014850: 2e32 2e31 2043 6f6c 6f72 730a 2d2d 2d2d .2.1 Colors.---- │ │ │ │ │ +00014860: 2d2d 2d2d 2d2d 2d2d 0a0a 436f 6c6f 7273 --------..Colors │ │ │ │ │ +00014870: 2063 616e 2062 6520 7370 6563 6966 6965 can be specifie │ │ │ │ │ +00014880: 6420 696e 2073 6576 6572 616c 2077 6179 d in several way │ │ │ │ │ +00014890: 733a 0a0a 2020 202a 2048 544d 4c2d 7374 s:.. * HTML-st │ │ │ │ │ +000148a0: 796c 6520 2223 5252 4747 4242 2220 6f72 yle "#RRGGBB" or │ │ │ │ │ +000148b0: 2022 2352 4742 2220 666f 726d 6174 2c20 "#RGB" format, │ │ │ │ │ +000148c0: 7768 6572 6520 2a52 2a2c 202a 472a 2c20 where *R*, *G*, │ │ │ │ │ +000148d0: 616e 6420 2a42 2a20 6172 650a 2020 2020 and *B* are. │ │ │ │ │ +000148e0: 2068 6578 6164 6563 696d 616c 2064 6967 hexadecimal dig │ │ │ │ │ +000148f0: 6974 7320 2865 2e67 2e2c 2022 2338 3839 its (e.g., "#889 │ │ │ │ │ +00014900: 3946 4622 290a 2020 202a 2061 7320 636f 9FF"). * as co │ │ │ │ │ +00014910: 6d6d 612d 7365 7061 7261 7465 6420 6465 mma-separated de │ │ │ │ │ +00014920: 6369 6d61 6c20 5247 4220 7661 6c75 6573 cimal RGB values │ │ │ │ │ +00014930: 2028 652e 672e 2c20 2231 3238 2c20 3132 (e.g., "128, 12 │ │ │ │ │ +00014940: 382c 2032 3535 2229 0a20 2020 2a20 7769 8, 255"). * wi │ │ │ │ │ +00014950: 7468 2022 5356 4720 312e 3020 636f 6c6f th "SVG 1.0 colo │ │ │ │ │ +00014960: 7220 6e61 6d65 7322 2028 652e 672e 2c20 r names" (e.g., │ │ │ │ │ +00014970: 2263 6f72 6e66 6c6f 7765 7262 6c75 6522 "cornflowerblue" │ │ │ │ │ +00014980: 2920 7768 6963 6820 6d75 7374 2062 650a ) which must be. │ │ │ │ │ +00014990: 2020 2020 2073 7065 6369 6669 6564 2069 specified i │ │ │ │ │ +000149a0: 6e20 6c6f 7765 7263 6173 652e 0a0a 372e n lowercase...7. │ │ │ │ │ +000149b0: 322e 3220 466f 6e74 730a 2d2d 2d2d 2d2d 2.2 Fonts.------ │ │ │ │ │ +000149c0: 2d2d 2d2d 2d0a 0a54 6865 2066 6f6e 7473 -----..The fonts │ │ │ │ │ +000149d0: 2047 5255 4220 7573 6573 2022 5046 4632 GRUB uses "PFF2 │ │ │ │ │ +000149e0: 2066 6f6e 7420 666f 726d 6174 2220 6269 font format" bi │ │ │ │ │ +000149f0: 746d 6170 2066 6f6e 7473 2e20 2046 6f6e tmap fonts. Fon │ │ │ │ │ +00014a00: 7473 2061 7265 0a73 7065 6369 6669 6564 ts are.specified │ │ │ │ │ +00014a10: 2077 6974 6820 6675 6c6c 2066 6f6e 7420 with full font │ │ │ │ │ +00014a20: 6e61 6d65 732e 2020 4375 7272 656e 746c names. Currentl │ │ │ │ │ +00014a30: 7920 7468 6572 6520 6973 206e 6f20 7072 y there is no pr │ │ │ │ │ +00014a40: 6f76 6973 696f 6e20 666f 7220 610a 7072 ovision for a.pr │ │ │ │ │ +00014a50: 6566 6572 656e 6365 206c 6973 7420 6f66 eference list of │ │ │ │ │ +00014a60: 2066 6f6e 7473 2c20 6f72 2064 6572 6976 fonts, or deriv │ │ │ │ │ +00014a70: 696e 6720 6f6e 6520 666f 6e74 2066 726f ing one font fro │ │ │ │ │ +00014a80: 6d20 616e 6f74 6865 722e 2020 466f 6e74 m another. Font │ │ │ │ │ +00014a90: 7320 6172 650a 6c6f 6164 6564 2077 6974 s are.loaded wit │ │ │ │ │ +00014aa0: 6820 7468 6520 226c 6f61 6466 6f6e 7422 h the "loadfont" │ │ │ │ │ +00014ab0: 2063 6f6d 6d61 6e64 2069 6e20 4752 5542 command in GRUB │ │ │ │ │ +00014ac0: 2028 2a6e 6f74 6520 6c6f 6164 666f 6e74 (*note loadfont │ │ │ │ │ +00014ad0: 3a3a 292e 2020 546f 2073 6565 0a74 6865 ::). To see.the │ │ │ │ │ +00014ae0: 206c 6973 7420 6f66 206c 6f61 6465 6420 list of loaded │ │ │ │ │ +00014af0: 666f 6e74 732c 2065 7865 6375 7465 2074 fonts, execute t │ │ │ │ │ +00014b00: 6865 2022 6c73 666f 6e74 7322 2063 6f6d he "lsfonts" com │ │ │ │ │ +00014b10: 6d61 6e64 2028 2a6e 6f74 650a 6c73 666f mand (*note.lsfo │ │ │ │ │ +00014b20: 6e74 733a 3a29 2e20 2049 6620 7468 6572 nts::). If ther │ │ │ │ │ +00014b30: 6520 6172 6520 746f 6f20 6d61 6e79 2066 e are too many f │ │ │ │ │ +00014b40: 6f6e 7473 2074 6f20 6669 7420 6f6e 2073 onts to fit on s │ │ │ │ │ +00014b50: 6372 6565 6e2c 2064 6f20 2273 6574 0a70 creen, do "set.p │ │ │ │ │ +00014b60: 6167 6572 3d31 2220 6265 666f 7265 2065 ager=1" before e │ │ │ │ │ +00014b70: 7865 6375 7469 6e67 2022 6c73 666f 6e74 xecuting "lsfont │ │ │ │ │ +00014b80: 7322 2e0a 0a37 2e32 2e33 2050 726f 6772 s"...7.2.3 Progr │ │ │ │ │ +00014b90: 6573 7320 4261 720a 2d2d 2d2d 2d2d 2d2d ess Bar.-------- │ │ │ │ │ +00014ba0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 4669 6775 ----------..Figu │ │ │ │ │ +00014bb0: 7265 2037 2e31 0a0a 4669 6775 7265 2037 re 7.1..Figure 7 │ │ │ │ │ +00014bc0: 2e32 0a0a 5072 6f67 7265 7373 2062 6172 .2..Progress bar │ │ │ │ │ +00014bd0: 7320 6172 6520 7573 6564 2074 6f20 6469 s are used to di │ │ │ │ │ +00014be0: 7370 6c61 7920 7468 6520 7265 6d61 696e splay the remain │ │ │ │ │ +00014bf0: 696e 6720 7469 6d65 2062 6566 6f72 6520 ing time before │ │ │ │ │ +00014c00: 4752 5542 2062 6f6f 7473 0a74 6865 2064 GRUB boots.the d │ │ │ │ │ +00014c10: 6566 6175 6c74 206d 656e 7520 656e 7472 efault menu entr │ │ │ │ │ +00014c20: 792e 2020 546f 2063 7265 6174 6520 6120 y. To create a │ │ │ │ │ +00014c30: 7072 6f67 7265 7373 2062 6172 2074 6861 progress bar tha │ │ │ │ │ +00014c40: 7420 7769 6c6c 2064 6973 706c 6179 2074 t will display t │ │ │ │ │ +00014c50: 6865 0a72 656d 6169 6e69 6e67 2074 696d he.remaining tim │ │ │ │ │ +00014c60: 6520 6265 666f 7265 2061 7574 6f6d 6174 e before automat │ │ │ │ │ +00014c70: 6963 2062 6f6f 742c 2073 696d 706c 7920 ic boot, simply │ │ │ │ │ +00014c80: 6372 6561 7465 2061 2022 7072 6f67 7265 create a "progre │ │ │ │ │ +00014c90: 7373 5f62 6172 220a 636f 6d70 6f6e 656e ss_bar".componen │ │ │ │ │ +00014ca0: 7420 7769 7468 2074 6865 2069 6420 225f t with the id "_ │ │ │ │ │ +00014cb0: 5f74 696d 656f 7574 5f5f 222e 2020 5468 _timeout__". Th │ │ │ │ │ +00014cc0: 6973 2069 6e64 6963 6174 6573 2074 6f20 is indicates to │ │ │ │ │ +00014cd0: 4752 5542 2074 6861 7420 7468 650a 7072 GRUB that the.pr │ │ │ │ │ +00014ce0: 6f67 7265 7373 2062 6172 2073 686f 756c ogress bar shoul │ │ │ │ │ +00014cf0: 6420 6265 2075 7064 6174 6564 2061 7320 d be updated as │ │ │ │ │ +00014d00: 7469 6d65 2070 6173 7365 732c 2061 6e64 time passes, and │ │ │ │ │ +00014d10: 2069 7420 7368 6f75 6c64 2062 6520 6d61 it should be ma │ │ │ │ │ +00014d20: 6465 0a69 6e76 6973 6962 6c65 2069 6620 de.invisible if │ │ │ │ │ +00014d30: 7468 6520 636f 756e 7464 6f77 6e20 746f the countdown to │ │ │ │ │ +00014d40: 2061 7574 6f6d 6174 6963 2062 6f6f 7420 automatic boot │ │ │ │ │ +00014d50: 6973 2069 6e74 6572 7275 7074 6564 2062 is interrupted b │ │ │ │ │ +00014d60: 7920 7468 6520 7573 6572 2e0a 0a20 2020 y the user... │ │ │ │ │ +00014d70: 5072 6f67 7265 7373 2062 6172 7320 6d61 Progress bars ma │ │ │ │ │ +00014d80: 7920 6f70 7469 6f6e 616c 6c79 2068 6176 y optionally hav │ │ │ │ │ +00014d90: 6520 7465 7874 2064 6973 706c 6179 6564 e text displayed │ │ │ │ │ +00014da0: 206f 6e20 7468 656d 2e20 2054 6869 7320 on them. This │ │ │ │ │ +00014db0: 7465 7874 0a69 7320 636f 6e74 726f 6c6c text.is controll │ │ │ │ │ +00014dc0: 6564 2062 7920 7661 7269 6162 6c65 2022 ed by variable " │ │ │ │ │ +00014dd0: 7465 7874 2220 7768 6963 6820 636f 6e74 text" which cont │ │ │ │ │ +00014de0: 6169 6e73 2061 2070 7269 6e74 6620 7465 ains a printf te │ │ │ │ │ +00014df0: 6d70 6c61 7465 2077 6974 680a 7468 6520 mplate with.the │ │ │ │ │ +00014e00: 6f6e 6c79 2061 7267 756d 656e 7420 2564 only argument %d │ │ │ │ │ +00014e10: 2069 7320 7468 6520 6e75 6d62 6572 206f is the number o │ │ │ │ │ +00014e20: 6620 7365 636f 6e64 7320 7265 6d61 696e f seconds remain │ │ │ │ │ +00014e30: 696e 672e 2020 4164 6469 7469 6f6e 616c ing. Additional │ │ │ │ │ +00014e40: 6c79 0a73 7065 6369 616c 2076 616c 7565 ly.special value │ │ │ │ │ +00014e50: 7320 2240 5449 4d45 4f55 545f 4e4f 5449 s "@TIMEOUT_NOTI │ │ │ │ │ +00014e60: 4649 4341 5449 4f4e 5f53 484f 5254 4022 FICATION_SHORT@" │ │ │ │ │ +00014e70: 2c0a 2240 5449 4d45 4f55 545f 4e4f 5449 ,."@TIMEOUT_NOTI │ │ │ │ │ +00014e80: 4649 4341 5449 4f4e 5f4d 4944 444c 4540 FICATION_MIDDLE@ │ │ │ │ │ +00014e90: 222c 2022 4054 494d 454f 5554 5f4e 4f54 ", "@TIMEOUT_NOT │ │ │ │ │ +00014ea0: 4946 4943 4154 494f 4e5f 4c4f 4e47 4022 IFICATION_LONG@" │ │ │ │ │ +00014eb0: 2061 7265 0a72 6570 6c61 6365 6420 7769 are.replaced wi │ │ │ │ │ +00014ec0: 7468 2073 7461 6e64 6172 6420 616e 6420 th standard and │ │ │ │ │ +00014ed0: 7472 616e 736c 6174 6564 2074 656d 706c translated templ │ │ │ │ │ +00014ee0: 6174 6573 2e0a 0a37 2e32 2e34 2043 6972 ates...7.2.4 Cir │ │ │ │ │ +00014ef0: 6375 6c61 7220 5072 6f67 7265 7373 2049 cular Progress I │ │ │ │ │ +00014f00: 6e64 6963 6174 6f72 0a2d 2d2d 2d2d 2d2d ndicator.------- │ │ │ │ │ 00014f10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00014f20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 5468 ------------..Th │ │ │ │ │ -00014f30: 6520 6369 7263 756c 6172 2070 726f 6772 e circular progr │ │ │ │ │ -00014f40: 6573 7320 696e 6469 6361 746f 7220 6675 ess indicator fu │ │ │ │ │ -00014f50: 6e63 7469 6f6e 7320 7369 6d69 6c61 726c nctions similarl │ │ │ │ │ -00014f60: 7920 746f 2074 6865 2070 726f 6772 6573 y to the progres │ │ │ │ │ -00014f70: 7320 6261 722e 0a57 6865 6e20 6769 7665 s bar..When give │ │ │ │ │ -00014f80: 6e20 616e 2069 6420 6f66 2022 5f5f 7469 n an id of "__ti │ │ │ │ │ -00014f90: 6d65 6f75 745f 5f22 2c20 4752 5542 2075 meout__", GRUB u │ │ │ │ │ -00014fa0: 7064 6174 6573 2074 6865 2063 6972 6375 pdates the circu │ │ │ │ │ -00014fb0: 6c61 7220 7072 6f67 7265 7373 0a69 6e64 lar progress.ind │ │ │ │ │ -00014fc0: 6963 6174 6f72 2773 2076 616c 7565 2074 icator's value t │ │ │ │ │ -00014fd0: 6f20 696e 6469 6361 7465 2074 6865 2074 o indicate the t │ │ │ │ │ -00014fe0: 696d 6520 7265 6d61 696e 696e 672e 2020 ime remaining. │ │ │ │ │ -00014ff0: 466f 7220 7468 6520 6369 7263 756c 6172 For the circular │ │ │ │ │ -00015000: 0a70 726f 6772 6573 7320 696e 6469 6361 .progress indica │ │ │ │ │ -00015010: 746f 722c 2074 6865 7265 2061 7265 2074 tor, there are t │ │ │ │ │ -00015020: 776f 2069 6d61 6765 7320 7573 6564 2074 wo images used t │ │ │ │ │ -00015030: 6f20 7265 6e64 6572 2069 743a 2074 6865 o render it: the │ │ │ │ │ -00015040: 202a 6365 6e74 6572 2a0a 696d 6167 652c *center*.image, │ │ │ │ │ -00015050: 2061 6e64 2074 6865 202a 7469 636b 2a20 and the *tick* │ │ │ │ │ -00015060: 696d 6167 652e 2020 5468 6520 6365 6e74 image. The cent │ │ │ │ │ -00015070: 6572 2069 6d61 6765 2069 7320 7265 6e64 er image is rend │ │ │ │ │ -00015080: 6572 6564 2069 6e20 7468 6520 6365 6e74 ered in the cent │ │ │ │ │ -00015090: 6572 0a6f 6620 7468 6520 636f 6d70 6f6e er.of the compon │ │ │ │ │ -000150a0: 656e 742c 2077 6869 6c65 2074 6865 2074 ent, while the t │ │ │ │ │ -000150b0: 6963 6b20 696d 6167 6520 6973 2075 7365 ick image is use │ │ │ │ │ -000150c0: 6420 746f 2072 656e 6465 7220 6561 6368 d to render each │ │ │ │ │ -000150d0: 206d 6172 6b20 616c 6f6e 670a 7468 6520 mark along.the │ │ │ │ │ -000150e0: 6369 7263 756d 6665 7265 6e63 6520 6f66 circumference of │ │ │ │ │ -000150f0: 2074 6865 2069 6e64 6963 6174 6f72 2e0a the indicator.. │ │ │ │ │ -00015100: 0a37 2e32 2e35 204c 6162 656c 730a 2d2d .7.2.5 Labels.-- │ │ │ │ │ -00015110: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 5465 7874 ----------..Text │ │ │ │ │ -00015120: 206c 6162 656c 7320 6361 6e20 6265 2070 labels can be p │ │ │ │ │ -00015130: 6c61 6365 6420 6f6e 2074 6865 2062 6f6f laced on the boo │ │ │ │ │ -00015140: 7420 7363 7265 656e 2e20 2054 6865 2066 t screen. The f │ │ │ │ │ -00015150: 6f6e 742c 2063 6f6c 6f72 2c20 616e 640a ont, color, and. │ │ │ │ │ -00015160: 686f 7269 7a6f 6e74 616c 2061 6c69 676e horizontal align │ │ │ │ │ -00015170: 6d65 6e74 2063 616e 2062 6520 7370 6563 ment can be spec │ │ │ │ │ -00015180: 6966 6965 6420 666f 7220 6c61 6265 6c73 ified for labels │ │ │ │ │ -00015190: 2e20 2049 6620 6120 6c61 6265 6c20 6973 . If a label is │ │ │ │ │ -000151a0: 2067 6976 656e 0a74 6865 2069 6420 225f given.the id "_ │ │ │ │ │ -000151b0: 5f74 696d 656f 7574 5f5f 222c 2074 6865 _timeout__", the │ │ │ │ │ -000151c0: 6e20 7468 6520 2274 6578 7422 2070 726f n the "text" pro │ │ │ │ │ -000151d0: 7065 7274 7920 666f 7220 7468 6174 206c perty for that l │ │ │ │ │ -000151e0: 6162 656c 2069 7320 616c 736f 0a75 7064 abel is also.upd │ │ │ │ │ -000151f0: 6174 6564 2077 6974 6820 6120 6d65 7373 ated with a mess │ │ │ │ │ -00015200: 6167 6520 696e 666f 726d 696e 6720 7468 age informing th │ │ │ │ │ -00015210: 6520 7573 6572 206f 6620 7468 6520 6e75 e user of the nu │ │ │ │ │ -00015220: 6d62 6572 206f 6620 7365 636f 6e64 730a mber of seconds. │ │ │ │ │ -00015230: 7265 6d61 696e 696e 6720 756e 7469 6c20 remaining until │ │ │ │ │ -00015240: 6175 746f 6d61 7469 6320 626f 6f74 2e20 automatic boot. │ │ │ │ │ -00015250: 2054 6869 7320 6973 2075 7365 6675 6c20 This is useful │ │ │ │ │ -00015260: 696e 2063 6173 6520 796f 7520 7761 6e74 in case you want │ │ │ │ │ -00015270: 2074 6865 0a74 6578 7420 6469 7370 6c61 the.text displa │ │ │ │ │ -00015280: 7965 6420 736f 6d65 7768 6572 6520 656c yed somewhere el │ │ │ │ │ -00015290: 7365 2069 6e73 7465 6164 206f 6620 6469 se instead of di │ │ │ │ │ -000152a0: 7265 6374 6c79 206f 6e20 7468 6520 7072 rectly on the pr │ │ │ │ │ -000152b0: 6f67 7265 7373 2062 6172 2e0a 0a37 2e32 ogress bar...7.2 │ │ │ │ │ -000152c0: 2e36 2042 6f6f 7420 4d65 6e75 0a2d 2d2d .6 Boot Menu.--- │ │ │ │ │ -000152d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 5468 ------------..Th │ │ │ │ │ -000152e0: 6520 626f 6f74 206d 656e 7520 7768 6572 e boot menu wher │ │ │ │ │ -000152f0: 6520 4752 5542 2064 6973 706c 6179 7320 e GRUB displays │ │ │ │ │ -00015300: 7468 6520 6d65 6e75 2065 6e74 7269 6573 the menu entries │ │ │ │ │ -00015310: 2066 726f 6d20 7468 6520 2267 7275 622e from the "grub. │ │ │ │ │ -00015320: 6366 6722 0a66 696c 652e 2020 4974 2069 cfg".file. It i │ │ │ │ │ -00015330: 7320 6120 6c69 7374 206f 6620 6974 656d s a list of item │ │ │ │ │ -00015340: 732c 2077 6865 7265 2065 6163 6820 6974 s, where each it │ │ │ │ │ -00015350: 656d 2068 6173 2061 2074 6974 6c65 2061 em has a title a │ │ │ │ │ -00015360: 6e64 2061 6e0a 6f70 7469 6f6e 616c 2069 nd an.optional i │ │ │ │ │ -00015370: 636f 6e2e 2020 5468 6520 6963 6f6e 2069 con. The icon i │ │ │ │ │ -00015380: 7320 7365 6c65 6374 6564 2062 6173 6564 s selected based │ │ │ │ │ -00015390: 206f 6e20 7468 6520 2a63 6c61 7373 6573 on the *classes │ │ │ │ │ -000153a0: 2a20 7370 6563 6966 6965 640a 666f 7220 * specified.for │ │ │ │ │ -000153b0: 7468 6520 6d65 6e75 2065 6e74 7279 2e20 the menu entry. │ │ │ │ │ -000153c0: 2049 6620 7468 6572 6520 6973 2061 2050 If there is a P │ │ │ │ │ -000153d0: 4e47 2066 696c 6520 6e61 6d65 6420 226d NG file named "m │ │ │ │ │ -000153e0: 7963 6c61 7373 2e70 6e67 2220 696e 2074 yclass.png" in t │ │ │ │ │ -000153f0: 6865 0a22 6772 7562 2f74 6865 6d65 732f he."grub/themes/ │ │ │ │ │ -00015400: 6963 6f6e 7322 2064 6972 6563 746f 7279 icons" directory │ │ │ │ │ -00015410: 2c20 6974 2077 696c 6c20 6265 2064 6973 , it will be dis │ │ │ │ │ -00015420: 706c 6179 6564 2066 6f72 2069 7465 6d73 played for items │ │ │ │ │ -00015430: 2077 6869 6368 2068 6176 650a 7468 6520 which have.the │ │ │ │ │ -00015440: 636c 6173 7320 2a6d 7963 6c61 7373 2a2e class *myclass*. │ │ │ │ │ -00015450: 2020 5468 6520 626f 6f74 206d 656e 7520 The boot menu │ │ │ │ │ -00015460: 6361 6e20 6265 2063 7573 746f 6d69 7a65 can be customize │ │ │ │ │ -00015470: 6420 696e 2073 6576 6572 616c 2077 6179 d in several way │ │ │ │ │ -00015480: 732c 0a73 7563 6820 6173 2074 6865 2066 s,.such as the f │ │ │ │ │ -00015490: 6f6e 7420 616e 6420 636f 6c6f 7220 7573 ont and color us │ │ │ │ │ -000154a0: 6564 2066 6f72 2074 6865 206d 656e 7520 ed for the menu │ │ │ │ │ -000154b0: 656e 7472 7920 7469 746c 652c 2061 6e64 entry title, and │ │ │ │ │ -000154c0: 2062 790a 7370 6563 6966 7969 6e67 2073 by.specifying s │ │ │ │ │ -000154d0: 7479 6c65 6420 626f 7865 7320 666f 7220 tyled boxes for │ │ │ │ │ -000154e0: 7468 6520 6d65 6e75 2069 7473 656c 6620 the menu itself │ │ │ │ │ -000154f0: 616e 6420 666f 7220 7468 6520 7365 6c65 and for the sele │ │ │ │ │ -00015500: 6374 6564 2069 7465 6d0a 6869 6768 6c69 cted item.highli │ │ │ │ │ -00015510: 6768 742e 0a0a 372e 322e 3720 5374 796c ght...7.2.7 Styl │ │ │ │ │ -00015520: 6564 2042 6f78 6573 0a2d 2d2d 2d2d 2d2d ed Boxes.------- │ │ │ │ │ -00015530: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a4f 6e65 -----------..One │ │ │ │ │ -00015540: 206f 6620 7468 6520 6d6f 7374 2069 6d70 of the most imp │ │ │ │ │ -00015550: 6f72 7461 6e74 2066 6561 7475 7265 7320 ortant features │ │ │ │ │ -00015560: 666f 7220 6375 7374 6f6d 697a 696e 6720 for customizing │ │ │ │ │ -00015570: 7468 6520 6c61 796f 7574 2069 7320 7468 the layout is th │ │ │ │ │ -00015580: 6520 7573 650a 6f66 202a 7374 796c 6564 e use.of *styled │ │ │ │ │ -00015590: 2062 6f78 6573 2a2e 2020 4120 7374 796c boxes*. A styl │ │ │ │ │ -000155a0: 6564 2062 6f78 2069 7320 636f 6d70 6f73 ed box is compos │ │ │ │ │ -000155b0: 6564 206f 6620 3920 7265 6374 616e 6775 ed of 9 rectangu │ │ │ │ │ -000155c0: 6c61 7220 2861 6e64 0a70 6f74 656e 7469 lar (and.potenti │ │ │ │ │ -000155d0: 616c 6c79 2065 6d70 7479 2920 7265 6769 ally empty) regi │ │ │ │ │ -000155e0: 6f6e 732c 2077 6869 6368 2061 7265 2075 ons, which are u │ │ │ │ │ -000155f0: 7365 6420 746f 2073 6561 6d6c 6573 736c sed to seamlessl │ │ │ │ │ -00015600: 7920 6472 6177 2074 6865 2073 7479 6c65 y draw the style │ │ │ │ │ -00015610: 640a 626f 7820 6f6e 2073 6372 6565 6e3a d.box on screen: │ │ │ │ │ -00015620: 0a0a 4e6f 7274 6877 6573 7420 286e 7729 ..Northwest (nw) │ │ │ │ │ -00015630: 2020 2020 2020 2020 204e 6f72 7468 2028 North ( │ │ │ │ │ -00015640: 6e29 2020 2020 2020 2020 2020 2020 2020 n) │ │ │ │ │ -00015650: 4e6f 7274 6865 6173 7420 286e 6529 0a57 Northeast (ne).W │ │ │ │ │ -00015660: 6573 7420 2877 2920 2020 2020 2020 2020 est (w) │ │ │ │ │ -00015670: 2020 2020 2020 4365 6e74 6572 2028 6329 Center (c) │ │ │ │ │ -00015680: 2020 2020 2020 2020 2020 2020 2045 6173 Eas │ │ │ │ │ -00015690: 7420 2865 290a 536f 7574 6877 6573 7420 t (e).Southwest │ │ │ │ │ -000156a0: 2873 7729 2020 2020 2020 2020 2053 6f75 (sw) Sou │ │ │ │ │ -000156b0: 7468 2028 7329 2020 2020 2020 2020 2020 th (s) │ │ │ │ │ -000156c0: 2020 2020 536f 7574 6865 6173 7420 2873 Southeast (s │ │ │ │ │ -000156d0: 6529 0a0a 2020 2054 6f20 7375 7070 6f72 e).. To suppor │ │ │ │ │ -000156e0: 7420 616e 7920 7369 7a65 206f 6620 626f t any size of bo │ │ │ │ │ -000156f0: 7820 6f6e 2073 6372 6565 6e2c 2074 6865 x on screen, the │ │ │ │ │ -00015700: 2063 656e 7465 7220 736c 6963 6520 616e center slice an │ │ │ │ │ -00015710: 6420 7468 6520 736c 6963 6573 0a66 6f72 d the slices.for │ │ │ │ │ -00015720: 2074 6865 2074 6f70 2c20 626f 7474 6f6d the top, bottom │ │ │ │ │ -00015730: 2c20 616e 6420 7369 6465 7320 6172 6520 , and sides are │ │ │ │ │ -00015740: 616c 6c20 7363 616c 6564 2074 6f20 7468 all scaled to th │ │ │ │ │ -00015750: 6520 636f 7272 6563 7420 7369 7a65 2066 e correct size f │ │ │ │ │ -00015760: 6f72 0a74 6865 2063 6f6d 706f 6e65 6e74 or.the component │ │ │ │ │ -00015770: 206f 6e20 7363 7265 656e 2c20 7573 696e on screen, usin │ │ │ │ │ -00015780: 6720 7468 6520 666f 6c6c 6f77 696e 6720 g the following │ │ │ │ │ -00015790: 7275 6c65 733a 0a0a 2020 312e 2054 6865 rules:.. 1. The │ │ │ │ │ -000157a0: 2065 6467 6520 736c 6963 6573 2028 6e6f edge slices (no │ │ │ │ │ -000157b0: 7274 682c 2073 6f75 7468 2c20 6561 7374 rth, south, east │ │ │ │ │ -000157c0: 2c20 616e 6420 7765 7374 2920 6172 6520 , and west) are │ │ │ │ │ -000157d0: 7363 616c 6564 2069 6e20 7468 650a 2020 scaled in the. │ │ │ │ │ -000157e0: 2020 2064 6972 6563 7469 6f6e 206f 6620 direction of │ │ │ │ │ -000157f0: 7468 6520 6564 6765 2074 6865 7920 6172 the edge they ar │ │ │ │ │ -00015800: 6520 6164 6a61 6365 6e74 2074 6f2e 2020 e adjacent to. │ │ │ │ │ -00015810: 466f 7220 696e 7374 616e 6365 2c20 7468 For instance, th │ │ │ │ │ -00015820: 6520 7765 7374 0a20 2020 2020 736c 6963 e west. slic │ │ │ │ │ -00015830: 6520 6973 2073 6361 6c65 6420 7665 7274 e is scaled vert │ │ │ │ │ -00015840: 6963 616c 6c79 2e0a 2020 322e 2054 6865 ically.. 2. The │ │ │ │ │ -00015850: 2063 6f72 6e65 7220 736c 6963 6573 2028 corner slices ( │ │ │ │ │ -00015860: 6e6f 7274 6877 6573 742c 206e 6f72 7468 northwest, north │ │ │ │ │ -00015870: 6561 7374 2c20 736f 7574 6865 6173 742c east, southeast, │ │ │ │ │ -00015880: 2061 6e64 2073 6f75 7468 7765 7374 290a and southwest). │ │ │ │ │ -00015890: 2020 2020 2061 7265 206e 6f74 2073 6361 are not sca │ │ │ │ │ -000158a0: 6c65 642e 0a20 2033 2e20 5468 6520 6365 led.. 3. The ce │ │ │ │ │ -000158b0: 6e74 6572 2073 6c69 6365 2069 7320 7363 nter slice is sc │ │ │ │ │ -000158c0: 616c 6564 2074 6f20 6669 6c6c 2074 6865 aled to fill the │ │ │ │ │ -000158d0: 2072 656d 6169 6e69 6e67 2073 7061 6365 remaining space │ │ │ │ │ -000158e0: 2069 6e20 7468 650a 2020 2020 206d 6964 in the. mid │ │ │ │ │ -000158f0: 646c 652e 0a0a 2020 2041 7320 616e 2065 dle... As an e │ │ │ │ │ -00015900: 7861 6d70 6c65 206f 6620 686f 7720 616e xample of how an │ │ │ │ │ -00015910: 2069 6d61 6765 206d 6967 6874 2062 6520 image might be │ │ │ │ │ -00015920: 736c 6963 6564 2075 702c 2063 6f6e 7369 sliced up, consi │ │ │ │ │ -00015930: 6465 7220 7468 6520 7374 796c 6564 0a62 der the styled.b │ │ │ │ │ -00015940: 6f78 2075 7365 6420 666f 7220 6120 7465 ox used for a te │ │ │ │ │ -00015950: 726d 696e 616c 2076 6965 772e 0a0a 4669 rminal view...Fi │ │ │ │ │ -00015960: 6775 7265 2037 2e33 0a0a 372e 322e 3820 gure 7.3..7.2.8 │ │ │ │ │ -00015970: 4372 6561 7469 6e67 2053 7479 6c65 6420 Creating Styled │ │ │ │ │ -00015980: 426f 7820 496d 6167 6573 0a2d 2d2d 2d2d Box Images.----- │ │ │ │ │ +00014f20: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 5468 6520 ----------..The │ │ │ │ │ +00014f30: 6369 7263 756c 6172 2070 726f 6772 6573 circular progres │ │ │ │ │ +00014f40: 7320 696e 6469 6361 746f 7220 6675 6e63 s indicator func │ │ │ │ │ +00014f50: 7469 6f6e 7320 7369 6d69 6c61 726c 7920 tions similarly │ │ │ │ │ +00014f60: 746f 2074 6865 2070 726f 6772 6573 7320 to the progress │ │ │ │ │ +00014f70: 6261 722e 0a57 6865 6e20 6769 7665 6e20 bar..When given │ │ │ │ │ +00014f80: 616e 2069 6420 6f66 2022 5f5f 7469 6d65 an id of "__time │ │ │ │ │ +00014f90: 6f75 745f 5f22 2c20 4752 5542 2075 7064 out__", GRUB upd │ │ │ │ │ +00014fa0: 6174 6573 2074 6865 2063 6972 6375 6c61 ates the circula │ │ │ │ │ +00014fb0: 7220 7072 6f67 7265 7373 0a69 6e64 6963 r progress.indic │ │ │ │ │ +00014fc0: 6174 6f72 2773 2076 616c 7565 2074 6f20 ator's value to │ │ │ │ │ +00014fd0: 696e 6469 6361 7465 2074 6865 2074 696d indicate the tim │ │ │ │ │ +00014fe0: 6520 7265 6d61 696e 696e 672e 2020 466f e remaining. Fo │ │ │ │ │ +00014ff0: 7220 7468 6520 6369 7263 756c 6172 0a70 r the circular.p │ │ │ │ │ +00015000: 726f 6772 6573 7320 696e 6469 6361 746f rogress indicato │ │ │ │ │ +00015010: 722c 2074 6865 7265 2061 7265 2074 776f r, there are two │ │ │ │ │ +00015020: 2069 6d61 6765 7320 7573 6564 2074 6f20 images used to │ │ │ │ │ +00015030: 7265 6e64 6572 2069 743a 2074 6865 202a render it: the * │ │ │ │ │ +00015040: 6365 6e74 6572 2a0a 696d 6167 652c 2061 center*.image, a │ │ │ │ │ +00015050: 6e64 2074 6865 202a 7469 636b 2a20 696d nd the *tick* im │ │ │ │ │ +00015060: 6167 652e 2020 5468 6520 6365 6e74 6572 age. The center │ │ │ │ │ +00015070: 2069 6d61 6765 2069 7320 7265 6e64 6572 image is render │ │ │ │ │ +00015080: 6564 2069 6e20 7468 6520 6365 6e74 6572 ed in the center │ │ │ │ │ +00015090: 0a6f 6620 7468 6520 636f 6d70 6f6e 656e .of the componen │ │ │ │ │ +000150a0: 742c 2077 6869 6c65 2074 6865 2074 6963 t, while the tic │ │ │ │ │ +000150b0: 6b20 696d 6167 6520 6973 2075 7365 6420 k image is used │ │ │ │ │ +000150c0: 746f 2072 656e 6465 7220 6561 6368 206d to render each m │ │ │ │ │ +000150d0: 6172 6b20 616c 6f6e 670a 7468 6520 6369 ark along.the ci │ │ │ │ │ +000150e0: 7263 756d 6665 7265 6e63 6520 6f66 2074 rcumference of t │ │ │ │ │ +000150f0: 6865 2069 6e64 6963 6174 6f72 2e0a 0a37 he indicator...7 │ │ │ │ │ +00015100: 2e32 2e35 204c 6162 656c 730a 2d2d 2d2d .2.5 Labels.---- │ │ │ │ │ +00015110: 2d2d 2d2d 2d2d 2d2d 0a0a 5465 7874 206c --------..Text l │ │ │ │ │ +00015120: 6162 656c 7320 6361 6e20 6265 2070 6c61 abels can be pla │ │ │ │ │ +00015130: 6365 6420 6f6e 2074 6865 2062 6f6f 7420 ced on the boot │ │ │ │ │ +00015140: 7363 7265 656e 2e20 2054 6865 2066 6f6e screen. The fon │ │ │ │ │ +00015150: 742c 2063 6f6c 6f72 2c20 616e 640a 686f t, color, and.ho │ │ │ │ │ +00015160: 7269 7a6f 6e74 616c 2061 6c69 676e 6d65 rizontal alignme │ │ │ │ │ +00015170: 6e74 2063 616e 2062 6520 7370 6563 6966 nt can be specif │ │ │ │ │ +00015180: 6965 6420 666f 7220 6c61 6265 6c73 2e20 ied for labels. │ │ │ │ │ +00015190: 2049 6620 6120 6c61 6265 6c20 6973 2067 If a label is g │ │ │ │ │ +000151a0: 6976 656e 0a74 6865 2069 6420 225f 5f74 iven.the id "__t │ │ │ │ │ +000151b0: 696d 656f 7574 5f5f 222c 2074 6865 6e20 imeout__", then │ │ │ │ │ +000151c0: 7468 6520 2274 6578 7422 2070 726f 7065 the "text" prope │ │ │ │ │ +000151d0: 7274 7920 666f 7220 7468 6174 206c 6162 rty for that lab │ │ │ │ │ +000151e0: 656c 2069 7320 616c 736f 0a75 7064 6174 el is also.updat │ │ │ │ │ +000151f0: 6564 2077 6974 6820 6120 6d65 7373 6167 ed with a messag │ │ │ │ │ +00015200: 6520 696e 666f 726d 696e 6720 7468 6520 e informing the │ │ │ │ │ +00015210: 7573 6572 206f 6620 7468 6520 6e75 6d62 user of the numb │ │ │ │ │ +00015220: 6572 206f 6620 7365 636f 6e64 730a 7265 er of seconds.re │ │ │ │ │ +00015230: 6d61 696e 696e 6720 756e 7469 6c20 6175 maining until au │ │ │ │ │ +00015240: 746f 6d61 7469 6320 626f 6f74 2e20 2054 tomatic boot. T │ │ │ │ │ +00015250: 6869 7320 6973 2075 7365 6675 6c20 696e his is useful in │ │ │ │ │ +00015260: 2063 6173 6520 796f 7520 7761 6e74 2074 case you want t │ │ │ │ │ +00015270: 6865 0a74 6578 7420 6469 7370 6c61 7965 he.text displaye │ │ │ │ │ +00015280: 6420 736f 6d65 7768 6572 6520 656c 7365 d somewhere else │ │ │ │ │ +00015290: 2069 6e73 7465 6164 206f 6620 6469 7265 instead of dire │ │ │ │ │ +000152a0: 6374 6c79 206f 6e20 7468 6520 7072 6f67 ctly on the prog │ │ │ │ │ +000152b0: 7265 7373 2062 6172 2e0a 0a37 2e32 2e36 ress bar...7.2.6 │ │ │ │ │ +000152c0: 2042 6f6f 7420 4d65 6e75 0a2d 2d2d 2d2d Boot Menu.----- │ │ │ │ │ +000152d0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 5468 6520 ----------..The │ │ │ │ │ +000152e0: 626f 6f74 206d 656e 7520 7768 6572 6520 boot menu where │ │ │ │ │ +000152f0: 4752 5542 2064 6973 706c 6179 7320 7468 GRUB displays th │ │ │ │ │ +00015300: 6520 6d65 6e75 2065 6e74 7269 6573 2066 e menu entries f │ │ │ │ │ +00015310: 726f 6d20 7468 6520 2267 7275 622e 6366 rom the "grub.cf │ │ │ │ │ +00015320: 6722 0a66 696c 652e 2020 4974 2069 7320 g".file. It is │ │ │ │ │ +00015330: 6120 6c69 7374 206f 6620 6974 656d 732c a list of items, │ │ │ │ │ +00015340: 2077 6865 7265 2065 6163 6820 6974 656d where each item │ │ │ │ │ +00015350: 2068 6173 2061 2074 6974 6c65 2061 6e64 has a title and │ │ │ │ │ +00015360: 2061 6e0a 6f70 7469 6f6e 616c 2069 636f an.optional ico │ │ │ │ │ +00015370: 6e2e 2020 5468 6520 6963 6f6e 2069 7320 n. The icon is │ │ │ │ │ +00015380: 7365 6c65 6374 6564 2062 6173 6564 206f selected based o │ │ │ │ │ +00015390: 6e20 7468 6520 2a63 6c61 7373 6573 2a20 n the *classes* │ │ │ │ │ +000153a0: 7370 6563 6966 6965 640a 666f 7220 7468 specified.for th │ │ │ │ │ +000153b0: 6520 6d65 6e75 2065 6e74 7279 2e20 2049 e menu entry. I │ │ │ │ │ +000153c0: 6620 7468 6572 6520 6973 2061 2050 4e47 f there is a PNG │ │ │ │ │ +000153d0: 2066 696c 6520 6e61 6d65 6420 226d 7963 file named "myc │ │ │ │ │ +000153e0: 6c61 7373 2e70 6e67 2220 696e 2074 6865 lass.png" in the │ │ │ │ │ +000153f0: 0a22 6772 7562 2f74 6865 6d65 732f 6963 ."grub/themes/ic │ │ │ │ │ +00015400: 6f6e 7322 2064 6972 6563 746f 7279 2c20 ons" directory, │ │ │ │ │ +00015410: 6974 2077 696c 6c20 6265 2064 6973 706c it will be displ │ │ │ │ │ +00015420: 6179 6564 2066 6f72 2069 7465 6d73 2077 ayed for items w │ │ │ │ │ +00015430: 6869 6368 2068 6176 650a 7468 6520 636c hich have.the cl │ │ │ │ │ +00015440: 6173 7320 2a6d 7963 6c61 7373 2a2e 2020 ass *myclass*. │ │ │ │ │ +00015450: 5468 6520 626f 6f74 206d 656e 7520 6361 The boot menu ca │ │ │ │ │ +00015460: 6e20 6265 2063 7573 746f 6d69 7a65 6420 n be customized │ │ │ │ │ +00015470: 696e 2073 6576 6572 616c 2077 6179 732c in several ways, │ │ │ │ │ +00015480: 0a73 7563 6820 6173 2074 6865 2066 6f6e .such as the fon │ │ │ │ │ +00015490: 7420 616e 6420 636f 6c6f 7220 7573 6564 t and color used │ │ │ │ │ +000154a0: 2066 6f72 2074 6865 206d 656e 7520 656e for the menu en │ │ │ │ │ +000154b0: 7472 7920 7469 746c 652c 2061 6e64 2062 try title, and b │ │ │ │ │ +000154c0: 790a 7370 6563 6966 7969 6e67 2073 7479 y.specifying sty │ │ │ │ │ +000154d0: 6c65 6420 626f 7865 7320 666f 7220 7468 led boxes for th │ │ │ │ │ +000154e0: 6520 6d65 6e75 2069 7473 656c 6620 616e e menu itself an │ │ │ │ │ +000154f0: 6420 666f 7220 7468 6520 7365 6c65 6374 d for the select │ │ │ │ │ +00015500: 6564 2069 7465 6d0a 6869 6768 6c69 6768 ed item.highligh │ │ │ │ │ +00015510: 742e 0a0a 372e 322e 3720 5374 796c 6564 t...7.2.7 Styled │ │ │ │ │ +00015520: 2042 6f78 6573 0a2d 2d2d 2d2d 2d2d 2d2d Boxes.--------- │ │ │ │ │ +00015530: 2d2d 2d2d 2d2d 2d2d 2d0a 0a4f 6e65 206f ---------..One o │ │ │ │ │ +00015540: 6620 7468 6520 6d6f 7374 2069 6d70 6f72 f the most impor │ │ │ │ │ +00015550: 7461 6e74 2066 6561 7475 7265 7320 666f tant features fo │ │ │ │ │ +00015560: 7220 6375 7374 6f6d 697a 696e 6720 7468 r customizing th │ │ │ │ │ +00015570: 6520 6c61 796f 7574 2069 7320 7468 6520 e layout is the │ │ │ │ │ +00015580: 7573 650a 6f66 202a 7374 796c 6564 2062 use.of *styled b │ │ │ │ │ +00015590: 6f78 6573 2a2e 2020 4120 7374 796c 6564 oxes*. A styled │ │ │ │ │ +000155a0: 2062 6f78 2069 7320 636f 6d70 6f73 6564 box is composed │ │ │ │ │ +000155b0: 206f 6620 3920 7265 6374 616e 6775 6c61 of 9 rectangula │ │ │ │ │ +000155c0: 7220 2861 6e64 0a70 6f74 656e 7469 616c r (and.potential │ │ │ │ │ +000155d0: 6c79 2065 6d70 7479 2920 7265 6769 6f6e ly empty) region │ │ │ │ │ +000155e0: 732c 2077 6869 6368 2061 7265 2075 7365 s, which are use │ │ │ │ │ +000155f0: 6420 746f 2073 6561 6d6c 6573 736c 7920 d to seamlessly │ │ │ │ │ +00015600: 6472 6177 2074 6865 2073 7479 6c65 640a draw the styled. │ │ │ │ │ +00015610: 626f 7820 6f6e 2073 6372 6565 6e3a 0a0a box on screen:.. │ │ │ │ │ +00015620: 4e6f 7274 6877 6573 7420 286e 7729 2020 Northwest (nw) │ │ │ │ │ +00015630: 2020 2020 2020 204e 6f72 7468 2028 6e29 North (n) │ │ │ │ │ +00015640: 2020 2020 2020 2020 2020 2020 2020 4e6f No │ │ │ │ │ +00015650: 7274 6865 6173 7420 286e 6529 0a57 6573 rtheast (ne).Wes │ │ │ │ │ +00015660: 7420 2877 2920 2020 2020 2020 2020 2020 t (w) │ │ │ │ │ +00015670: 2020 2020 4365 6e74 6572 2028 6329 2020 Center (c) │ │ │ │ │ +00015680: 2020 2020 2020 2020 2020 2045 6173 7420 East │ │ │ │ │ +00015690: 2865 290a 536f 7574 6877 6573 7420 2873 (e).Southwest (s │ │ │ │ │ +000156a0: 7729 2020 2020 2020 2020 2053 6f75 7468 w) South │ │ │ │ │ +000156b0: 2028 7329 2020 2020 2020 2020 2020 2020 (s) │ │ │ │ │ +000156c0: 2020 536f 7574 6865 6173 7420 2873 6529 Southeast (se) │ │ │ │ │ +000156d0: 0a0a 2020 2054 6f20 7375 7070 6f72 7420 .. To support │ │ │ │ │ +000156e0: 616e 7920 7369 7a65 206f 6620 626f 7820 any size of box │ │ │ │ │ +000156f0: 6f6e 2073 6372 6565 6e2c 2074 6865 2063 on screen, the c │ │ │ │ │ +00015700: 656e 7465 7220 736c 6963 6520 616e 6420 enter slice and │ │ │ │ │ +00015710: 7468 6520 736c 6963 6573 0a66 6f72 2074 the slices.for t │ │ │ │ │ +00015720: 6865 2074 6f70 2c20 626f 7474 6f6d 2c20 he top, bottom, │ │ │ │ │ +00015730: 616e 6420 7369 6465 7320 6172 6520 616c and sides are al │ │ │ │ │ +00015740: 6c20 7363 616c 6564 2074 6f20 7468 6520 l scaled to the │ │ │ │ │ +00015750: 636f 7272 6563 7420 7369 7a65 2066 6f72 correct size for │ │ │ │ │ +00015760: 0a74 6865 2063 6f6d 706f 6e65 6e74 206f .the component o │ │ │ │ │ +00015770: 6e20 7363 7265 656e 2c20 7573 696e 6720 n screen, using │ │ │ │ │ +00015780: 7468 6520 666f 6c6c 6f77 696e 6720 7275 the following ru │ │ │ │ │ +00015790: 6c65 733a 0a0a 2020 312e 2054 6865 2065 les:.. 1. The e │ │ │ │ │ +000157a0: 6467 6520 736c 6963 6573 2028 6e6f 7274 dge slices (nort │ │ │ │ │ +000157b0: 682c 2073 6f75 7468 2c20 6561 7374 2c20 h, south, east, │ │ │ │ │ +000157c0: 616e 6420 7765 7374 2920 6172 6520 7363 and west) are sc │ │ │ │ │ +000157d0: 616c 6564 2069 6e20 7468 650a 2020 2020 aled in the. │ │ │ │ │ +000157e0: 2064 6972 6563 7469 6f6e 206f 6620 7468 direction of th │ │ │ │ │ +000157f0: 6520 6564 6765 2074 6865 7920 6172 6520 e edge they are │ │ │ │ │ +00015800: 6164 6a61 6365 6e74 2074 6f2e 2020 466f adjacent to. Fo │ │ │ │ │ +00015810: 7220 696e 7374 616e 6365 2c20 7468 6520 r instance, the │ │ │ │ │ +00015820: 7765 7374 0a20 2020 2020 736c 6963 6520 west. slice │ │ │ │ │ +00015830: 6973 2073 6361 6c65 6420 7665 7274 6963 is scaled vertic │ │ │ │ │ +00015840: 616c 6c79 2e0a 2020 322e 2054 6865 2063 ally.. 2. The c │ │ │ │ │ +00015850: 6f72 6e65 7220 736c 6963 6573 2028 6e6f orner slices (no │ │ │ │ │ +00015860: 7274 6877 6573 742c 206e 6f72 7468 6561 rthwest, northea │ │ │ │ │ +00015870: 7374 2c20 736f 7574 6865 6173 742c 2061 st, southeast, a │ │ │ │ │ +00015880: 6e64 2073 6f75 7468 7765 7374 290a 2020 nd southwest). │ │ │ │ │ +00015890: 2020 2061 7265 206e 6f74 2073 6361 6c65 are not scale │ │ │ │ │ +000158a0: 642e 0a20 2033 2e20 5468 6520 6365 6e74 d.. 3. The cent │ │ │ │ │ +000158b0: 6572 2073 6c69 6365 2069 7320 7363 616c er slice is scal │ │ │ │ │ +000158c0: 6564 2074 6f20 6669 6c6c 2074 6865 2072 ed to fill the r │ │ │ │ │ +000158d0: 656d 6169 6e69 6e67 2073 7061 6365 2069 emaining space i │ │ │ │ │ +000158e0: 6e20 7468 650a 2020 2020 206d 6964 646c n the. middl │ │ │ │ │ +000158f0: 652e 0a0a 2020 2041 7320 616e 2065 7861 e... As an exa │ │ │ │ │ +00015900: 6d70 6c65 206f 6620 686f 7720 616e 2069 mple of how an i │ │ │ │ │ +00015910: 6d61 6765 206d 6967 6874 2062 6520 736c mage might be sl │ │ │ │ │ +00015920: 6963 6564 2075 702c 2063 6f6e 7369 6465 iced up, conside │ │ │ │ │ +00015930: 7220 7468 6520 7374 796c 6564 0a62 6f78 r the styled.box │ │ │ │ │ +00015940: 2075 7365 6420 666f 7220 6120 7465 726d used for a term │ │ │ │ │ +00015950: 696e 616c 2076 6965 772e 0a0a 4669 6775 inal view...Figu │ │ │ │ │ +00015960: 7265 2037 2e33 0a0a 372e 322e 3820 4372 re 7.3..7.2.8 Cr │ │ │ │ │ +00015970: 6561 7469 6e67 2053 7479 6c65 6420 426f eating Styled Bo │ │ │ │ │ +00015980: 7820 496d 6167 6573 0a2d 2d2d 2d2d 2d2d x Images.------- │ │ │ │ │ 00015990: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -000159a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a54 6865 -----------..The │ │ │ │ │ -000159b0: 2049 6e6b 7363 6170 655f 2073 6361 6c61 Inkscape_ scala │ │ │ │ │ -000159c0: 626c 6520 7665 6374 6f72 2067 7261 7068 ble vector graph │ │ │ │ │ -000159d0: 6963 7320 6564 6974 6f72 2069 7320 6120 ics editor is a │ │ │ │ │ -000159e0: 7665 7279 2075 7365 6675 6c20 746f 6f6c very useful tool │ │ │ │ │ -000159f0: 2066 6f72 0a63 7265 6174 696e 6720 7374 for.creating st │ │ │ │ │ -00015a00: 796c 6564 2062 6f78 2069 6d61 6765 732e yled box images. │ │ │ │ │ -00015a10: 2020 4f6e 6520 7072 6f63 6573 7320 7468 One process th │ │ │ │ │ -00015a20: 6174 2077 6f72 6b73 2077 656c 6c20 666f at works well fo │ │ │ │ │ -00015a30: 7220 736c 6963 696e 6720 610a 6472 6177 r slicing a.draw │ │ │ │ │ -00015a40: 696e 6720 696e 746f 2074 6865 206e 6563 ing into the nec │ │ │ │ │ -00015a50: 6573 7361 7279 2069 6d61 6765 2073 6c69 essary image sli │ │ │ │ │ -00015a60: 6365 7320 6973 3a0a 0a20 2031 2e20 4372 ces is:.. 1. Cr │ │ │ │ │ -00015a70: 6561 7465 206f 7220 6f70 656e 2074 6865 eate or open the │ │ │ │ │ -00015a80: 2064 7261 7769 6e67 2079 6f75 2764 206c drawing you'd l │ │ │ │ │ -00015a90: 696b 6520 7573 652e 0a20 2032 2e20 4372 ike use.. 2. Cr │ │ │ │ │ -00015aa0: 6561 7465 2061 206e 6577 206c 6179 6572 eate a new layer │ │ │ │ │ -00015ab0: 206f 6e20 7468 6520 746f 7020 6f66 2074 on the top of t │ │ │ │ │ -00015ac0: 6865 206c 6179 6572 2073 7461 636b 2e20 he layer stack. │ │ │ │ │ -00015ad0: 204d 616b 6520 6974 2076 6973 6962 6c65 Make it visible │ │ │ │ │ -00015ae0: 2e0a 2020 2020 2053 656c 6563 7420 7468 .. Select th │ │ │ │ │ -00015af0: 6973 206c 6179 6572 2061 7320 7468 6520 is layer as the │ │ │ │ │ -00015b00: 6375 7272 656e 7420 6c61 7965 722e 0a20 current layer.. │ │ │ │ │ -00015b10: 2033 2e20 4472 6177 2039 2072 6563 7461 3. Draw 9 recta │ │ │ │ │ -00015b20: 6e67 6c65 7320 6f6e 2079 6f75 7220 6472 ngles on your dr │ │ │ │ │ -00015b30: 6177 696e 6720 7768 6572 6520 796f 7527 awing where you' │ │ │ │ │ -00015b40: 6420 6c69 6b65 2074 6865 2073 6c69 6365 d like the slice │ │ │ │ │ -00015b50: 7320 746f 0a20 2020 2020 6265 2e20 2043 s to. be. C │ │ │ │ │ -00015b60: 6c65 6172 2074 6865 2066 696c 6c20 6f70 lear the fill op │ │ │ │ │ -00015b70: 7469 6f6e 2c20 616e 6420 7365 7420 7468 tion, and set th │ │ │ │ │ -00015b80: 6520 7374 726f 6b65 2074 6f20 3120 7069 e stroke to 1 pi │ │ │ │ │ -00015b90: 7865 6c20 7769 6465 0a20 2020 2020 736f xel wide. so │ │ │ │ │ -00015ba0: 6c69 6420 7374 726f 6b65 2e20 2054 6865 lid stroke. The │ │ │ │ │ -00015bb0: 2063 6f72 6e65 7273 206f 6620 7468 6520 corners of the │ │ │ │ │ -00015bc0: 736c 6963 6573 206d 7573 7420 6d65 6574 slices must meet │ │ │ │ │ -00015bd0: 2070 7265 6369 7365 6c79 3b20 6966 2069 precisely; if i │ │ │ │ │ -00015be0: 740a 2020 2020 2069 7320 6f66 6620 6279 t. is off by │ │ │ │ │ -00015bf0: 2061 2073 696e 676c 6520 7069 7865 6c2c a single pixel, │ │ │ │ │ -00015c00: 2069 7420 7769 6c6c 2070 726f 6261 626c it will probabl │ │ │ │ │ -00015c10: 7920 6265 2065 7669 6465 6e74 2077 6865 y be evident whe │ │ │ │ │ -00015c20: 6e20 7468 650a 2020 2020 2073 7479 6c65 n the. style │ │ │ │ │ -00015c30: 6420 626f 7820 6973 2072 656e 6465 7265 d box is rendere │ │ │ │ │ -00015c40: 6420 696e 2074 6865 2047 5255 4220 6d65 d in the GRUB me │ │ │ │ │ -00015c50: 6e75 2e20 2059 6f75 2073 686f 756c 6420 nu. You should │ │ │ │ │ -00015c60: 7072 6f62 6162 6c79 2067 6f20 746f 0a20 probably go to. │ │ │ │ │ -00015c70: 2020 2020 4669 6c65 207c 2044 6f63 756d File | Docum │ │ │ │ │ -00015c80: 656e 7420 5072 6f70 6572 7469 6573 207c ent Properties | │ │ │ │ │ -00015c90: 2047 7269 6473 2061 6e64 2065 6e61 626c Grids and enabl │ │ │ │ │ -00015ca0: 6520 6120 6772 6964 206f 7220 6372 6561 e a grid or crea │ │ │ │ │ -00015cb0: 7465 2061 0a20 2020 2020 6775 6964 6520 te a. guide │ │ │ │ │ -00015cc0: 2863 6c69 636b 206f 6e20 6f6e 6520 6f66 (click on one of │ │ │ │ │ -00015cd0: 2074 6865 2072 756c 6572 7320 6e65 7874 the rulers next │ │ │ │ │ -00015ce0: 2074 6f20 7468 6520 6472 6177 696e 6720 to the drawing │ │ │ │ │ -00015cf0: 616e 6420 6472 6167 206f 7665 720a 2020 and drag over. │ │ │ │ │ -00015d00: 2020 2074 6865 2064 7261 7769 6e67 3b20 the drawing; │ │ │ │ │ -00015d10: 7265 6c65 6173 6520 7468 6520 6d6f 7573 release the mous │ │ │ │ │ -00015d20: 6520 6275 7474 6f6e 2074 6f20 706c 6163 e button to plac │ │ │ │ │ -00015d30: 6520 7468 6520 6775 6964 6529 2074 6f20 e the guide) to │ │ │ │ │ -00015d40: 6865 6c70 0a20 2020 2020 706c 6163 6520 help. place │ │ │ │ │ -00015d50: 7468 6520 7265 6374 616e 676c 6573 2070 the rectangles p │ │ │ │ │ -00015d60: 7265 6369 7365 6c79 2e0a 2020 342e 2052 recisely.. 4. R │ │ │ │ │ -00015d70: 6967 6874 2063 6c69 636b 206f 6e20 7468 ight click on th │ │ │ │ │ -00015d80: 6520 6365 6e74 6572 2073 6c69 6365 2072 e center slice r │ │ │ │ │ -00015d90: 6563 7461 6e67 6c65 2061 6e64 2063 686f ectangle and cho │ │ │ │ │ -00015da0: 6f73 6520 4f62 6a65 6374 0a20 2020 2020 ose Object. │ │ │ │ │ -00015db0: 5072 6f70 6572 7469 6573 2e20 2043 6861 Properties. Cha │ │ │ │ │ -00015dc0: 6e67 6520 7468 6520 2249 6422 2074 6f20 nge the "Id" to │ │ │ │ │ -00015dd0: 2273 6c69 6365 5f63 2220 616e 6420 636c "slice_c" and cl │ │ │ │ │ -00015de0: 6963 6b20 5365 742e 2020 5265 7065 6174 ick Set. Repeat │ │ │ │ │ -00015df0: 0a20 2020 2020 7468 6973 2066 6f72 2074 . this for t │ │ │ │ │ -00015e00: 6865 2072 656d 6169 6e69 6e67 2038 2072 he remaining 8 r │ │ │ │ │ -00015e10: 6563 7461 6e67 6c65 732c 2067 6976 696e ectangles, givin │ │ │ │ │ -00015e20: 6720 7468 656d 2049 6420 7661 6c75 6573 g them Id values │ │ │ │ │ -00015e30: 206f 660a 2020 2020 2022 736c 6963 655f of. "slice_ │ │ │ │ │ -00015e40: 6e22 2c20 2273 6c69 6365 5f6e 6522 2c20 n", "slice_ne", │ │ │ │ │ -00015e50: 2273 6c69 6365 5f65 222c 2061 6e64 2073 "slice_e", and s │ │ │ │ │ -00015e60: 6f20 6f6e 2061 6363 6f72 6469 6e67 2074 o on according t │ │ │ │ │ -00015e70: 6f20 7468 650a 2020 2020 206c 6f63 6174 o the. locat │ │ │ │ │ -00015e80: 696f 6e2e 0a20 2035 2e20 5361 7665 2074 ion.. 5. Save t │ │ │ │ │ -00015e90: 6865 2064 7261 7769 6e67 2e0a 2020 362e he drawing.. 6. │ │ │ │ │ -00015ea0: 2053 656c 6563 7420 616c 6c20 7468 6520 Select all the │ │ │ │ │ -00015eb0: 736c 6963 6520 7265 6374 616e 676c 6573 slice rectangles │ │ │ │ │ -00015ec0: 2e20 2057 6974 6820 7468 6520 736c 6963 . With the slic │ │ │ │ │ -00015ed0: 6520 6c61 7965 7220 7365 6c65 6374 6564 e layer selected │ │ │ │ │ -00015ee0: 2c0a 2020 2020 2079 6f75 2063 616e 2073 ,. you can s │ │ │ │ │ -00015ef0: 696d 706c 7920 7072 6573 7320 4374 726c imply press Ctrl │ │ │ │ │ -00015f00: 2b41 2074 6f20 7365 6c65 6374 2061 6c6c +A to select all │ │ │ │ │ -00015f10: 2072 6563 7461 6e67 6c65 732e 2020 5468 rectangles. Th │ │ │ │ │ -00015f20: 6520 7374 6174 7573 0a20 2020 2020 6261 e status. ba │ │ │ │ │ -00015f30: 7220 7368 6f75 6c64 2069 6e64 6963 6174 r should indicat │ │ │ │ │ -00015f40: 6520 7468 6174 2039 2072 6563 7461 6e67 e that 9 rectang │ │ │ │ │ -00015f50: 6c65 7320 6172 6520 7365 6c65 6374 6564 les are selected │ │ │ │ │ -00015f60: 2e0a 2020 372e 2043 6c69 636b 2074 6865 .. 7. Click the │ │ │ │ │ -00015f70: 206c 6179 6572 2068 6964 6520 6963 6f6e layer hide icon │ │ │ │ │ -00015f80: 2066 6f72 2074 6865 2073 6c69 6365 206c for the slice l │ │ │ │ │ -00015f90: 6179 6572 2069 6e20 7468 6520 6c61 7965 ayer in the laye │ │ │ │ │ -00015fa0: 7220 7061 6c65 7474 652e 0a20 2020 2020 r palette.. │ │ │ │ │ -00015fb0: 5468 6520 7265 6374 616e 676c 6573 2077 The rectangles w │ │ │ │ │ -00015fc0: 696c 6c20 7265 6d61 696e 2073 656c 6563 ill remain selec │ │ │ │ │ -00015fd0: 7465 642c 2065 7665 6e20 7468 6f75 6768 ted, even though │ │ │ │ │ -00015fe0: 2074 6865 7920 6172 6520 6869 6464 656e they are hidden │ │ │ │ │ -00015ff0: 2e0a 2020 382e 2043 686f 6f73 6520 4669 .. 8. Choose Fi │ │ │ │ │ -00016000: 6c65 207c 2045 7870 6f72 7420 4269 746d le | Export Bitm │ │ │ │ │ -00016010: 6170 2061 6e64 2063 6865 636b 2074 6865 ap and check the │ │ │ │ │ -00016020: 202a 4261 7463 6820 6578 706f 7274 2039 *Batch export 9 │ │ │ │ │ -00016030: 2073 656c 6563 7465 640a 2020 2020 206f selected. o │ │ │ │ │ -00016040: 626a 6563 7473 2a20 626f 782e 2020 4d61 bjects* box. Ma │ │ │ │ │ -00016050: 6b65 2073 7572 6520 7468 6174 202a 4869 ke sure that *Hi │ │ │ │ │ -00016060: 6465 2061 6c6c 2065 7863 6570 7420 7365 de all except se │ │ │ │ │ -00016070: 6c65 6374 6564 2a20 6973 0a20 2020 2020 lected* is. │ │ │ │ │ -00016080: 756e 6368 6563 6b65 642e 2020 636c 6963 unchecked. clic │ │ │ │ │ -00016090: 6b20 2a45 7870 6f72 742a 2e20 2054 6869 k *Export*. Thi │ │ │ │ │ -000160a0: 7320 7769 6c6c 2063 7265 6174 6520 504e s will create PN │ │ │ │ │ -000160b0: 4720 6669 6c65 7320 696e 2074 6865 2073 G files in the s │ │ │ │ │ -000160c0: 616d 650a 2020 2020 2064 6972 6563 746f ame. directo │ │ │ │ │ -000160d0: 7279 2061 7320 7468 6520 6472 6177 696e ry as the drawin │ │ │ │ │ -000160e0: 672c 206e 616d 6564 2061 6674 6572 2074 g, named after t │ │ │ │ │ -000160f0: 6865 2073 6c69 6365 732e 2020 5468 6573 he slices. Thes │ │ │ │ │ -00016100: 6520 6361 6e20 6e6f 7720 6265 0a20 2020 e can now be. │ │ │ │ │ -00016110: 2020 7573 6564 2066 6f72 2061 2073 7479 used for a sty │ │ │ │ │ -00016120: 6c65 6420 626f 7820 696e 2061 2047 5255 led box in a GRU │ │ │ │ │ -00016130: 4220 7468 656d 652e 0a0a 372e 3320 5468 B theme...7.3 Th │ │ │ │ │ -00016140: 656d 6520 4669 6c65 204d 616e 7561 6c0a eme File Manual. │ │ │ │ │ +000159a0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a54 6865 2049 ---------..The I │ │ │ │ │ +000159b0: 6e6b 7363 6170 655f 2073 6361 6c61 626c nkscape_ scalabl │ │ │ │ │ +000159c0: 6520 7665 6374 6f72 2067 7261 7068 6963 e vector graphic │ │ │ │ │ +000159d0: 7320 6564 6974 6f72 2069 7320 6120 7665 s editor is a ve │ │ │ │ │ +000159e0: 7279 2075 7365 6675 6c20 746f 6f6c 2066 ry useful tool f │ │ │ │ │ +000159f0: 6f72 0a63 7265 6174 696e 6720 7374 796c or.creating styl │ │ │ │ │ +00015a00: 6564 2062 6f78 2069 6d61 6765 732e 2020 ed box images. │ │ │ │ │ +00015a10: 4f6e 6520 7072 6f63 6573 7320 7468 6174 One process that │ │ │ │ │ +00015a20: 2077 6f72 6b73 2077 656c 6c20 666f 7220 works well for │ │ │ │ │ +00015a30: 736c 6963 696e 6720 610a 6472 6177 696e slicing a.drawin │ │ │ │ │ +00015a40: 6720 696e 746f 2074 6865 206e 6563 6573 g into the neces │ │ │ │ │ +00015a50: 7361 7279 2069 6d61 6765 2073 6c69 6365 sary image slice │ │ │ │ │ +00015a60: 7320 6973 3a0a 0a20 2031 2e20 4372 6561 s is:.. 1. Crea │ │ │ │ │ +00015a70: 7465 206f 7220 6f70 656e 2074 6865 2064 te or open the d │ │ │ │ │ +00015a80: 7261 7769 6e67 2079 6f75 2764 206c 696b rawing you'd lik │ │ │ │ │ +00015a90: 6520 7573 652e 0a20 2032 2e20 4372 6561 e use.. 2. Crea │ │ │ │ │ +00015aa0: 7465 2061 206e 6577 206c 6179 6572 206f te a new layer o │ │ │ │ │ +00015ab0: 6e20 7468 6520 746f 7020 6f66 2074 6865 n the top of the │ │ │ │ │ +00015ac0: 206c 6179 6572 2073 7461 636b 2e20 204d layer stack. M │ │ │ │ │ +00015ad0: 616b 6520 6974 2076 6973 6962 6c65 2e0a ake it visible.. │ │ │ │ │ +00015ae0: 2020 2020 2053 656c 6563 7420 7468 6973 Select this │ │ │ │ │ +00015af0: 206c 6179 6572 2061 7320 7468 6520 6375 layer as the cu │ │ │ │ │ +00015b00: 7272 656e 7420 6c61 7965 722e 0a20 2033 rrent layer.. 3 │ │ │ │ │ +00015b10: 2e20 4472 6177 2039 2072 6563 7461 6e67 . Draw 9 rectang │ │ │ │ │ +00015b20: 6c65 7320 6f6e 2079 6f75 7220 6472 6177 les on your draw │ │ │ │ │ +00015b30: 696e 6720 7768 6572 6520 796f 7527 6420 ing where you'd │ │ │ │ │ +00015b40: 6c69 6b65 2074 6865 2073 6c69 6365 7320 like the slices │ │ │ │ │ +00015b50: 746f 0a20 2020 2020 6265 2e20 2043 6c65 to. be. Cle │ │ │ │ │ +00015b60: 6172 2074 6865 2066 696c 6c20 6f70 7469 ar the fill opti │ │ │ │ │ +00015b70: 6f6e 2c20 616e 6420 7365 7420 7468 6520 on, and set the │ │ │ │ │ +00015b80: 7374 726f 6b65 2074 6f20 3120 7069 7865 stroke to 1 pixe │ │ │ │ │ +00015b90: 6c20 7769 6465 0a20 2020 2020 736f 6c69 l wide. soli │ │ │ │ │ +00015ba0: 6420 7374 726f 6b65 2e20 2054 6865 2063 d stroke. The c │ │ │ │ │ +00015bb0: 6f72 6e65 7273 206f 6620 7468 6520 736c orners of the sl │ │ │ │ │ +00015bc0: 6963 6573 206d 7573 7420 6d65 6574 2070 ices must meet p │ │ │ │ │ +00015bd0: 7265 6369 7365 6c79 3b20 6966 2069 740a recisely; if it. │ │ │ │ │ +00015be0: 2020 2020 2069 7320 6f66 6620 6279 2061 is off by a │ │ │ │ │ +00015bf0: 2073 696e 676c 6520 7069 7865 6c2c 2069 single pixel, i │ │ │ │ │ +00015c00: 7420 7769 6c6c 2070 726f 6261 626c 7920 t will probably │ │ │ │ │ +00015c10: 6265 2065 7669 6465 6e74 2077 6865 6e20 be evident when │ │ │ │ │ +00015c20: 7468 650a 2020 2020 2073 7479 6c65 6420 the. styled │ │ │ │ │ +00015c30: 626f 7820 6973 2072 656e 6465 7265 6420 box is rendered │ │ │ │ │ +00015c40: 696e 2074 6865 2047 5255 4220 6d65 6e75 in the GRUB menu │ │ │ │ │ +00015c50: 2e20 2059 6f75 2073 686f 756c 6420 7072 . You should pr │ │ │ │ │ +00015c60: 6f62 6162 6c79 2067 6f20 746f 0a20 2020 obably go to. │ │ │ │ │ +00015c70: 2020 4669 6c65 207c 2044 6f63 756d 656e File | Documen │ │ │ │ │ +00015c80: 7420 5072 6f70 6572 7469 6573 207c 2047 t Properties | G │ │ │ │ │ +00015c90: 7269 6473 2061 6e64 2065 6e61 626c 6520 rids and enable │ │ │ │ │ +00015ca0: 6120 6772 6964 206f 7220 6372 6561 7465 a grid or create │ │ │ │ │ +00015cb0: 2061 0a20 2020 2020 6775 6964 6520 2863 a. guide (c │ │ │ │ │ +00015cc0: 6c69 636b 206f 6e20 6f6e 6520 6f66 2074 lick on one of t │ │ │ │ │ +00015cd0: 6865 2072 756c 6572 7320 6e65 7874 2074 he rulers next t │ │ │ │ │ +00015ce0: 6f20 7468 6520 6472 6177 696e 6720 616e o the drawing an │ │ │ │ │ +00015cf0: 6420 6472 6167 206f 7665 720a 2020 2020 d drag over. │ │ │ │ │ +00015d00: 2074 6865 2064 7261 7769 6e67 3b20 7265 the drawing; re │ │ │ │ │ +00015d10: 6c65 6173 6520 7468 6520 6d6f 7573 6520 lease the mouse │ │ │ │ │ +00015d20: 6275 7474 6f6e 2074 6f20 706c 6163 6520 button to place │ │ │ │ │ +00015d30: 7468 6520 6775 6964 6529 2074 6f20 6865 the guide) to he │ │ │ │ │ +00015d40: 6c70 0a20 2020 2020 706c 6163 6520 7468 lp. place th │ │ │ │ │ +00015d50: 6520 7265 6374 616e 676c 6573 2070 7265 e rectangles pre │ │ │ │ │ +00015d60: 6369 7365 6c79 2e0a 2020 342e 2052 6967 cisely.. 4. Rig │ │ │ │ │ +00015d70: 6874 2063 6c69 636b 206f 6e20 7468 6520 ht click on the │ │ │ │ │ +00015d80: 6365 6e74 6572 2073 6c69 6365 2072 6563 center slice rec │ │ │ │ │ +00015d90: 7461 6e67 6c65 2061 6e64 2063 686f 6f73 tangle and choos │ │ │ │ │ +00015da0: 6520 4f62 6a65 6374 0a20 2020 2020 5072 e Object. Pr │ │ │ │ │ +00015db0: 6f70 6572 7469 6573 2e20 2043 6861 6e67 operties. Chang │ │ │ │ │ +00015dc0: 6520 7468 6520 2249 6422 2074 6f20 2273 e the "Id" to "s │ │ │ │ │ +00015dd0: 6c69 6365 5f63 2220 616e 6420 636c 6963 lice_c" and clic │ │ │ │ │ +00015de0: 6b20 5365 742e 2020 5265 7065 6174 0a20 k Set. Repeat. │ │ │ │ │ +00015df0: 2020 2020 7468 6973 2066 6f72 2074 6865 this for the │ │ │ │ │ +00015e00: 2072 656d 6169 6e69 6e67 2038 2072 6563 remaining 8 rec │ │ │ │ │ +00015e10: 7461 6e67 6c65 732c 2067 6976 696e 6720 tangles, giving │ │ │ │ │ +00015e20: 7468 656d 2049 6420 7661 6c75 6573 206f them Id values o │ │ │ │ │ +00015e30: 660a 2020 2020 2022 736c 6963 655f 6e22 f. "slice_n" │ │ │ │ │ +00015e40: 2c20 2273 6c69 6365 5f6e 6522 2c20 2273 , "slice_ne", "s │ │ │ │ │ +00015e50: 6c69 6365 5f65 222c 2061 6e64 2073 6f20 lice_e", and so │ │ │ │ │ +00015e60: 6f6e 2061 6363 6f72 6469 6e67 2074 6f20 on according to │ │ │ │ │ +00015e70: 7468 650a 2020 2020 206c 6f63 6174 696f the. locatio │ │ │ │ │ +00015e80: 6e2e 0a20 2035 2e20 5361 7665 2074 6865 n.. 5. Save the │ │ │ │ │ +00015e90: 2064 7261 7769 6e67 2e0a 2020 362e 2053 drawing.. 6. S │ │ │ │ │ +00015ea0: 656c 6563 7420 616c 6c20 7468 6520 736c elect all the sl │ │ │ │ │ +00015eb0: 6963 6520 7265 6374 616e 676c 6573 2e20 ice rectangles. │ │ │ │ │ +00015ec0: 2057 6974 6820 7468 6520 736c 6963 6520 With the slice │ │ │ │ │ +00015ed0: 6c61 7965 7220 7365 6c65 6374 6564 2c0a layer selected,. │ │ │ │ │ +00015ee0: 2020 2020 2079 6f75 2063 616e 2073 696d you can sim │ │ │ │ │ +00015ef0: 706c 7920 7072 6573 7320 4374 726c 2b41 ply press Ctrl+A │ │ │ │ │ +00015f00: 2074 6f20 7365 6c65 6374 2061 6c6c 2072 to select all r │ │ │ │ │ +00015f10: 6563 7461 6e67 6c65 732e 2020 5468 6520 ectangles. The │ │ │ │ │ +00015f20: 7374 6174 7573 0a20 2020 2020 6261 7220 status. bar │ │ │ │ │ +00015f30: 7368 6f75 6c64 2069 6e64 6963 6174 6520 should indicate │ │ │ │ │ +00015f40: 7468 6174 2039 2072 6563 7461 6e67 6c65 that 9 rectangle │ │ │ │ │ +00015f50: 7320 6172 6520 7365 6c65 6374 6564 2e0a s are selected.. │ │ │ │ │ +00015f60: 2020 372e 2043 6c69 636b 2074 6865 206c 7. Click the l │ │ │ │ │ +00015f70: 6179 6572 2068 6964 6520 6963 6f6e 2066 ayer hide icon f │ │ │ │ │ +00015f80: 6f72 2074 6865 2073 6c69 6365 206c 6179 or the slice lay │ │ │ │ │ +00015f90: 6572 2069 6e20 7468 6520 6c61 7965 7220 er in the layer │ │ │ │ │ +00015fa0: 7061 6c65 7474 652e 0a20 2020 2020 5468 palette.. Th │ │ │ │ │ +00015fb0: 6520 7265 6374 616e 676c 6573 2077 696c e rectangles wil │ │ │ │ │ +00015fc0: 6c20 7265 6d61 696e 2073 656c 6563 7465 l remain selecte │ │ │ │ │ +00015fd0: 642c 2065 7665 6e20 7468 6f75 6768 2074 d, even though t │ │ │ │ │ +00015fe0: 6865 7920 6172 6520 6869 6464 656e 2e0a hey are hidden.. │ │ │ │ │ +00015ff0: 2020 382e 2043 686f 6f73 6520 4669 6c65 8. Choose File │ │ │ │ │ +00016000: 207c 2045 7870 6f72 7420 4269 746d 6170 | Export Bitmap │ │ │ │ │ +00016010: 2061 6e64 2063 6865 636b 2074 6865 202a and check the * │ │ │ │ │ +00016020: 4261 7463 6820 6578 706f 7274 2039 2073 Batch export 9 s │ │ │ │ │ +00016030: 656c 6563 7465 640a 2020 2020 206f 626a elected. obj │ │ │ │ │ +00016040: 6563 7473 2a20 626f 782e 2020 4d61 6b65 ects* box. Make │ │ │ │ │ +00016050: 2073 7572 6520 7468 6174 202a 4869 6465 sure that *Hide │ │ │ │ │ +00016060: 2061 6c6c 2065 7863 6570 7420 7365 6c65 all except sele │ │ │ │ │ +00016070: 6374 6564 2a20 6973 0a20 2020 2020 756e cted* is. un │ │ │ │ │ +00016080: 6368 6563 6b65 642e 2020 636c 6963 6b20 checked. click │ │ │ │ │ +00016090: 2a45 7870 6f72 742a 2e20 2054 6869 7320 *Export*. This │ │ │ │ │ +000160a0: 7769 6c6c 2063 7265 6174 6520 504e 4720 will create PNG │ │ │ │ │ +000160b0: 6669 6c65 7320 696e 2074 6865 2073 616d files in the sam │ │ │ │ │ +000160c0: 650a 2020 2020 2064 6972 6563 746f 7279 e. directory │ │ │ │ │ +000160d0: 2061 7320 7468 6520 6472 6177 696e 672c as the drawing, │ │ │ │ │ +000160e0: 206e 616d 6564 2061 6674 6572 2074 6865 named after the │ │ │ │ │ +000160f0: 2073 6c69 6365 732e 2020 5468 6573 6520 slices. These │ │ │ │ │ +00016100: 6361 6e20 6e6f 7720 6265 0a20 2020 2020 can now be. │ │ │ │ │ +00016110: 7573 6564 2066 6f72 2061 2073 7479 6c65 used for a style │ │ │ │ │ +00016120: 6420 626f 7820 696e 2061 2047 5255 4220 d box in a GRUB │ │ │ │ │ +00016130: 7468 656d 652e 0a0a 372e 3320 5468 656d theme...7.3 Them │ │ │ │ │ +00016140: 6520 4669 6c65 204d 616e 7561 6c0a 3d3d e File Manual.== │ │ │ │ │ 00016150: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00016160: 3d3d 3d3d 3d0a 0a54 6865 2074 6865 6d65 =====..The theme │ │ │ │ │ -00016170: 2066 696c 6520 6973 2061 2070 6c61 696e file is a plain │ │ │ │ │ -00016180: 2074 6578 7420 6669 6c65 2e20 204c 696e text file. Lin │ │ │ │ │ -00016190: 6573 2074 6861 7420 6265 6769 6e20 7769 es that begin wi │ │ │ │ │ -000161a0: 7468 2022 2322 2061 7265 0a69 676e 6f72 th "#" are.ignor │ │ │ │ │ -000161b0: 6564 2061 6e64 2063 6f6e 7369 6465 7265 ed and considere │ │ │ │ │ -000161c0: 6420 636f 6d6d 656e 7473 2e20 2028 4e6f d comments. (No │ │ │ │ │ -000161d0: 7465 3a20 5468 6973 206d 6179 206e 6f74 te: This may not │ │ │ │ │ -000161e0: 2062 6520 7468 6520 6361 7365 2069 6620 be the case if │ │ │ │ │ -000161f0: 7468 650a 7072 6576 696f 7573 206c 696e the.previous lin │ │ │ │ │ -00016200: 6520 656e 6465 6420 7768 6572 6520 6120 e ended where a │ │ │ │ │ -00016210: 7661 6c75 6520 7761 7320 6578 7065 6374 value was expect │ │ │ │ │ -00016220: 6564 2e29 0a0a 2020 2054 6865 2074 6865 ed.).. The the │ │ │ │ │ -00016230: 6d65 2066 696c 6520 636f 6e74 6169 6e73 me file contains │ │ │ │ │ -00016240: 2074 776f 2074 7970 6573 206f 6620 7374 two types of st │ │ │ │ │ -00016250: 6174 656d 656e 7473 3a0a 2020 312e 2047 atements:. 1. G │ │ │ │ │ -00016260: 6c6f 6261 6c20 7072 6f70 6572 7469 6573 lobal properties │ │ │ │ │ -00016270: 2e0a 2020 322e 2043 6f6d 706f 6e65 6e74 .. 2. Component │ │ │ │ │ -00016280: 2063 6f6e 7374 7275 6374 696f 6e2e 0a0a construction... │ │ │ │ │ -00016290: 372e 332e 3120 476c 6f62 616c 2050 726f 7.3.1 Global Pro │ │ │ │ │ -000162a0: 7065 7274 6965 730a 2d2d 2d2d 2d2d 2d2d perties.-------- │ │ │ │ │ -000162b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ -000162c0: 0a37 2e33 2e32 2046 6f72 6d61 740a 2d2d .7.3.2 Format.-- │ │ │ │ │ -000162d0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 476c 6f62 ----------..Glob │ │ │ │ │ -000162e0: 616c 2070 726f 7065 7274 6965 7320 6172 al properties ar │ │ │ │ │ -000162f0: 6520 7370 6563 6966 6965 6420 7769 7468 e specified with │ │ │ │ │ -00016300: 2074 6865 2073 696d 706c 6520 666f 726d the simple form │ │ │ │ │ -00016310: 6174 3a0a 2020 202a 206e 616d 6531 3a20 at:. * name1: │ │ │ │ │ -00016320: 7661 6c75 6531 0a20 2020 2a20 6e61 6d65 value1. * name │ │ │ │ │ -00016330: 323a 2022 7661 6c75 6520 7768 6963 6820 2: "value which │ │ │ │ │ -00016340: 6d61 7920 636f 6e74 6169 6e20 7370 6163 may contain spac │ │ │ │ │ -00016350: 6573 220a 2020 202a 206e 616d 6533 3a20 es". * name3: │ │ │ │ │ -00016360: 2338 3846 0a0a 2020 2049 6e20 7468 6973 #88F.. In this │ │ │ │ │ -00016370: 2065 7861 6d70 6c65 2c20 6e61 6d65 3320 example, name3 │ │ │ │ │ -00016380: 6973 2061 7373 6967 6e65 6420 6120 636f is assigned a co │ │ │ │ │ -00016390: 6c6f 7220 7661 6c75 652e 0a0a 372e 332e lor value...7.3. │ │ │ │ │ -000163a0: 3320 476c 6f62 616c 2050 726f 7065 7274 3 Global Propert │ │ │ │ │ -000163b0: 7920 4c69 7374 0a2d 2d2d 2d2d 2d2d 2d2d y List.--------- │ │ │ │ │ -000163c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -000163d0: 2d0a 0a74 6974 6c65 2d74 6578 7420 2020 -..title-text │ │ │ │ │ -000163e0: 2020 2020 2020 2020 2020 5370 6563 6966 Specif │ │ │ │ │ -000163f0: 6965 7320 7468 6520 7465 7874 2074 6f20 ies the text to │ │ │ │ │ -00016400: 6469 7370 6c61 7920 6174 2074 6865 2074 display at the t │ │ │ │ │ -00016410: 6f70 0a20 2020 2020 2020 2020 2020 2020 op. │ │ │ │ │ -00016420: 2020 2020 2020 2020 2020 6365 6e74 6572 center │ │ │ │ │ -00016430: 206f 6620 7468 6520 7363 7265 656e 2061 of the screen a │ │ │ │ │ -00016440: 7320 6120 7469 746c 652e 0a74 6974 6c65 s a title..title │ │ │ │ │ -00016450: 2d66 6f6e 7420 2020 2020 2020 2020 2020 -font │ │ │ │ │ -00016460: 2020 4465 6669 6e65 7320 7468 6520 666f Defines the fo │ │ │ │ │ -00016470: 6e74 2075 7365 6420 666f 7220 7468 6520 nt used for the │ │ │ │ │ -00016480: 7469 746c 650a 2020 2020 2020 2020 2020 title. │ │ │ │ │ -00016490: 2020 2020 2020 2020 2020 2020 206d 6573 mes │ │ │ │ │ -000164a0: 7361 6765 2061 7420 7468 6520 746f 7020 sage at the top │ │ │ │ │ -000164b0: 6f66 2074 6865 2073 6372 6565 6e2e 0a74 of the screen..t │ │ │ │ │ -000164c0: 6974 6c65 2d63 6f6c 6f72 2020 2020 2020 itle-color │ │ │ │ │ -000164d0: 2020 2020 2020 4465 6669 6e65 7320 7468 Defines th │ │ │ │ │ -000164e0: 6520 636f 6c6f 7220 6f66 2074 6865 2074 e color of the t │ │ │ │ │ -000164f0: 6974 6c65 206d 6573 7361 6765 2e0a 6d65 itle message..me │ │ │ │ │ -00016500: 7373 6167 652d 666f 6e74 2020 2020 2020 ssage-font │ │ │ │ │ -00016510: 2020 2020 2043 7572 7265 6e74 6c79 2075 Currently u │ │ │ │ │ -00016520: 6e75 7365 642e 2020 4c65 6674 2066 6f72 nused. Left for │ │ │ │ │ -00016530: 2062 6163 6b77 6172 640a 2020 2020 2020 backward. │ │ │ │ │ -00016540: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00016550: 2063 6f6d 7061 7469 6269 6c69 7479 2e0a compatibility.. │ │ │ │ │ -00016560: 6d65 7373 6167 652d 636f 6c6f 7220 2020 message-color │ │ │ │ │ -00016570: 2020 2020 2020 2043 7572 7265 6e74 6c79 Currently │ │ │ │ │ -00016580: 2075 6e75 7365 642e 2020 4c65 6674 2066 unused. Left f │ │ │ │ │ -00016590: 6f72 2062 6163 6b77 6172 640a 2020 2020 or backward. │ │ │ │ │ +00016160: 3d3d 3d0a 0a54 6865 2074 6865 6d65 2066 ===..The theme f │ │ │ │ │ +00016170: 696c 6520 6973 2061 2070 6c61 696e 2074 ile is a plain t │ │ │ │ │ +00016180: 6578 7420 6669 6c65 2e20 204c 696e 6573 ext file. Lines │ │ │ │ │ +00016190: 2074 6861 7420 6265 6769 6e20 7769 7468 that begin with │ │ │ │ │ +000161a0: 2022 2322 2061 7265 0a69 676e 6f72 6564 "#" are.ignored │ │ │ │ │ +000161b0: 2061 6e64 2063 6f6e 7369 6465 7265 6420 and considered │ │ │ │ │ +000161c0: 636f 6d6d 656e 7473 2e20 2028 4e6f 7465 comments. (Note │ │ │ │ │ +000161d0: 3a20 5468 6973 206d 6179 206e 6f74 2062 : This may not b │ │ │ │ │ +000161e0: 6520 7468 6520 6361 7365 2069 6620 7468 e the case if th │ │ │ │ │ +000161f0: 650a 7072 6576 696f 7573 206c 696e 6520 e.previous line │ │ │ │ │ +00016200: 656e 6465 6420 7768 6572 6520 6120 7661 ended where a va │ │ │ │ │ +00016210: 6c75 6520 7761 7320 6578 7065 6374 6564 lue was expected │ │ │ │ │ +00016220: 2e29 0a0a 2020 2054 6865 2074 6865 6d65 .).. The theme │ │ │ │ │ +00016230: 2066 696c 6520 636f 6e74 6169 6e73 2074 file contains t │ │ │ │ │ +00016240: 776f 2074 7970 6573 206f 6620 7374 6174 wo types of stat │ │ │ │ │ +00016250: 656d 656e 7473 3a0a 2020 312e 2047 6c6f ements:. 1. Glo │ │ │ │ │ +00016260: 6261 6c20 7072 6f70 6572 7469 6573 2e0a bal properties.. │ │ │ │ │ +00016270: 2020 322e 2043 6f6d 706f 6e65 6e74 2063 2. Component c │ │ │ │ │ +00016280: 6f6e 7374 7275 6374 696f 6e2e 0a0a 372e onstruction...7. │ │ │ │ │ +00016290: 332e 3120 476c 6f62 616c 2050 726f 7065 3.1 Global Prope │ │ │ │ │ +000162a0: 7274 6965 730a 2d2d 2d2d 2d2d 2d2d 2d2d rties.---------- │ │ │ │ │ +000162b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a37 -------------..7 │ │ │ │ │ +000162c0: 2e33 2e32 2046 6f72 6d61 740a 2d2d 2d2d .3.2 Format.---- │ │ │ │ │ +000162d0: 2d2d 2d2d 2d2d 2d2d 0a0a 476c 6f62 616c --------..Global │ │ │ │ │ +000162e0: 2070 726f 7065 7274 6965 7320 6172 6520 properties are │ │ │ │ │ +000162f0: 7370 6563 6966 6965 6420 7769 7468 2074 specified with t │ │ │ │ │ +00016300: 6865 2073 696d 706c 6520 666f 726d 6174 he simple format │ │ │ │ │ +00016310: 3a0a 2020 202a 206e 616d 6531 3a20 7661 :. * name1: va │ │ │ │ │ +00016320: 6c75 6531 0a20 2020 2a20 6e61 6d65 323a lue1. * name2: │ │ │ │ │ +00016330: 2022 7661 6c75 6520 7768 6963 6820 6d61 "value which ma │ │ │ │ │ +00016340: 7920 636f 6e74 6169 6e20 7370 6163 6573 y contain spaces │ │ │ │ │ +00016350: 220a 2020 202a 206e 616d 6533 3a20 2338 ". * name3: #8 │ │ │ │ │ +00016360: 3846 0a0a 2020 2049 6e20 7468 6973 2065 8F.. In this e │ │ │ │ │ +00016370: 7861 6d70 6c65 2c20 6e61 6d65 3320 6973 xample, name3 is │ │ │ │ │ +00016380: 2061 7373 6967 6e65 6420 6120 636f 6c6f assigned a colo │ │ │ │ │ +00016390: 7220 7661 6c75 652e 0a0a 372e 332e 3320 r value...7.3.3 │ │ │ │ │ +000163a0: 476c 6f62 616c 2050 726f 7065 7274 7920 Global Property │ │ │ │ │ +000163b0: 4c69 7374 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d List.----------- │ │ │ │ │ +000163c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ +000163d0: 0a74 6974 6c65 2d74 6578 7420 2020 2020 .title-text │ │ │ │ │ +000163e0: 2020 2020 2020 2020 5370 6563 6966 6965 Specifie │ │ │ │ │ +000163f0: 7320 7468 6520 7465 7874 2074 6f20 6469 s the text to di │ │ │ │ │ +00016400: 7370 6c61 7920 6174 2074 6865 2074 6f70 splay at the top │ │ │ │ │ +00016410: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +00016420: 2020 2020 2020 2020 6365 6e74 6572 206f center o │ │ │ │ │ +00016430: 6620 7468 6520 7363 7265 656e 2061 7320 f the screen as │ │ │ │ │ +00016440: 6120 7469 746c 652e 0a74 6974 6c65 2d66 a title..title-f │ │ │ │ │ +00016450: 6f6e 7420 2020 2020 2020 2020 2020 2020 ont │ │ │ │ │ +00016460: 4465 6669 6e65 7320 7468 6520 666f 6e74 Defines the font │ │ │ │ │ +00016470: 2075 7365 6420 666f 7220 7468 6520 7469 used for the ti │ │ │ │ │ +00016480: 746c 650a 2020 2020 2020 2020 2020 2020 tle. │ │ │ │ │ +00016490: 2020 2020 2020 2020 2020 206d 6573 7361 messa │ │ │ │ │ +000164a0: 6765 2061 7420 7468 6520 746f 7020 6f66 ge at the top of │ │ │ │ │ +000164b0: 2074 6865 2073 6372 6565 6e2e 0a74 6974 the screen..tit │ │ │ │ │ +000164c0: 6c65 2d63 6f6c 6f72 2020 2020 2020 2020 le-color │ │ │ │ │ +000164d0: 2020 2020 4465 6669 6e65 7320 7468 6520 Defines the │ │ │ │ │ +000164e0: 636f 6c6f 7220 6f66 2074 6865 2074 6974 color of the tit │ │ │ │ │ +000164f0: 6c65 206d 6573 7361 6765 2e0a 6d65 7373 le message..mess │ │ │ │ │ +00016500: 6167 652d 666f 6e74 2020 2020 2020 2020 age-font │ │ │ │ │ +00016510: 2020 2043 7572 7265 6e74 6c79 2075 6e75 Currently unu │ │ │ │ │ +00016520: 7365 642e 2020 4c65 6674 2066 6f72 2062 sed. Left for b │ │ │ │ │ +00016530: 6163 6b77 6172 640a 2020 2020 2020 2020 ackward. │ │ │ │ │ +00016540: 2020 2020 2020 2020 2020 2020 2020 2063 c │ │ │ │ │ +00016550: 6f6d 7061 7469 6269 6c69 7479 2e0a 6d65 ompatibility..me │ │ │ │ │ +00016560: 7373 6167 652d 636f 6c6f 7220 2020 2020 ssage-color │ │ │ │ │ +00016570: 2020 2020 2043 7572 7265 6e74 6c79 2075 Currently u │ │ │ │ │ +00016580: 6e75 7365 642e 2020 4c65 6674 2066 6f72 nused. Left for │ │ │ │ │ +00016590: 2062 6163 6b77 6172 640a 2020 2020 2020 backward. │ │ │ │ │ 000165a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000165b0: 2020 2063 6f6d 7061 7469 6269 6c69 7479 compatibility │ │ │ │ │ -000165c0: 2e0a 6d65 7373 6167 652d 6267 2d63 6f6c ..message-bg-col │ │ │ │ │ -000165d0: 6f72 2020 2020 2020 2043 7572 7265 6e74 or Current │ │ │ │ │ -000165e0: 6c79 2075 6e75 7365 642e 2020 4c65 6674 ly unused. Left │ │ │ │ │ -000165f0: 2066 6f72 2062 6163 6b77 6172 640a 2020 for backward. │ │ │ │ │ +000165b0: 2063 6f6d 7061 7469 6269 6c69 7479 2e0a compatibility.. │ │ │ │ │ +000165c0: 6d65 7373 6167 652d 6267 2d63 6f6c 6f72 message-bg-color │ │ │ │ │ +000165d0: 2020 2020 2020 2043 7572 7265 6e74 6c79 Currently │ │ │ │ │ +000165e0: 2075 6e75 7365 642e 2020 4c65 6674 2066 unused. Left f │ │ │ │ │ +000165f0: 6f72 2062 6163 6b77 6172 640a 2020 2020 or backward. │ │ │ │ │ 00016600: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00016610: 2020 2020 2063 6f6d 7061 7469 6269 6c69 compatibili │ │ │ │ │ -00016620: 7479 2e0a 6465 736b 746f 702d 696d 6167 ty..desktop-imag │ │ │ │ │ -00016630: 6520 2020 2020 2020 2020 2053 7065 6369 e Speci │ │ │ │ │ -00016640: 6669 6573 2074 6865 2069 6d61 6765 2074 fies the image t │ │ │ │ │ -00016650: 6f20 7573 6520 6173 2074 6865 0a20 2020 o use as the. │ │ │ │ │ +00016610: 2020 2063 6f6d 7061 7469 6269 6c69 7479 compatibility │ │ │ │ │ +00016620: 2e0a 6465 736b 746f 702d 696d 6167 6520 ..desktop-image │ │ │ │ │ +00016630: 2020 2020 2020 2020 2053 7065 6369 6669 Specifi │ │ │ │ │ +00016640: 6573 2074 6865 2069 6d61 6765 2074 6f20 es the image to │ │ │ │ │ +00016650: 7573 6520 6173 2074 6865 0a20 2020 2020 use as the. │ │ │ │ │ 00016660: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00016670: 2020 2020 6261 636b 6772 6f75 6e64 2e20 background. │ │ │ │ │ -00016680: 2049 7420 7769 6c6c 2062 6520 7363 616c It will be scal │ │ │ │ │ -00016690: 6564 2074 6f20 6669 7420 7468 650a 2020 ed to fit the. │ │ │ │ │ +00016670: 2020 6261 636b 6772 6f75 6e64 2e20 2049 background. I │ │ │ │ │ +00016680: 7420 7769 6c6c 2062 6520 7363 616c 6564 t will be scaled │ │ │ │ │ +00016690: 2074 6f20 6669 7420 7468 650a 2020 2020 to fit the. │ │ │ │ │ 000166a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000166b0: 2020 2020 2073 6372 6565 6e20 7369 7a65 screen size │ │ │ │ │ -000166c0: 206f 7220 7072 6f70 6f72 7469 6f6e 616c or proportional │ │ │ │ │ -000166d0: 6c79 2073 6361 6c65 640a 2020 2020 2020 ly scaled. │ │ │ │ │ -000166e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000166f0: 2064 6570 656e 6469 6e67 206f 6e20 7468 depending on th │ │ │ │ │ -00016700: 6520 7363 616c 6520 6d65 7468 6f64 2e0a e scale method.. │ │ │ │ │ -00016710: 6465 736b 746f 702d 696d 6167 652d 7363 desktop-image-sc │ │ │ │ │ -00016720: 616c 652d 6d65 7468 6f64 5370 6563 6966 ale-methodSpecif │ │ │ │ │ -00016730: 6965 7320 7468 6520 7363 616c 696e 6720 ies the scaling │ │ │ │ │ -00016740: 6d65 7468 6f64 2066 6f72 2074 6865 0a20 method for the. │ │ │ │ │ +000166b0: 2020 2073 6372 6565 6e20 7369 7a65 206f screen size o │ │ │ │ │ +000166c0: 7220 7072 6f70 6f72 7469 6f6e 616c 6c79 r proportionally │ │ │ │ │ +000166d0: 2073 6361 6c65 640a 2020 2020 2020 2020 scaled. │ │ │ │ │ +000166e0: 2020 2020 2020 2020 2020 2020 2020 2064 d │ │ │ │ │ +000166f0: 6570 656e 6469 6e67 206f 6e20 7468 6520 epending on the │ │ │ │ │ +00016700: 7363 616c 6520 6d65 7468 6f64 2e0a 6465 scale method..de │ │ │ │ │ +00016710: 736b 746f 702d 696d 6167 652d 7363 616c sktop-image-scal │ │ │ │ │ +00016720: 652d 6d65 7468 6f64 5370 6563 6966 6965 e-methodSpecifie │ │ │ │ │ +00016730: 7320 7468 6520 7363 616c 696e 6720 6d65 s the scaling me │ │ │ │ │ +00016740: 7468 6f64 2066 6f72 2074 6865 0a20 2020 thod for the. │ │ │ │ │ 00016750: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00016760: 2020 2020 2020 2a64 6573 6b74 6f70 2d69 *desktop-i │ │ │ │ │ -00016770: 6d61 6765 2a2e 2020 4f70 7469 6f6e 7320 mage*. Options │ │ │ │ │ -00016780: 6172 6520 2273 7472 6574 6368 222c 0a20 are "stretch",. │ │ │ │ │ +00016760: 2020 2020 2a64 6573 6b74 6f70 2d69 6d61 *desktop-ima │ │ │ │ │ +00016770: 6765 2a2e 2020 4f70 7469 6f6e 7320 6172 ge*. Options ar │ │ │ │ │ +00016780: 6520 2273 7472 6574 6368 222c 0a20 2020 e "stretch",. │ │ │ │ │ 00016790: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000167a0: 2020 2020 2020 2263 726f 7022 2c20 2270 "crop", "p │ │ │ │ │ -000167b0: 6164 6469 6e67 222c 2022 6669 7477 6964 adding", "fitwid │ │ │ │ │ -000167c0: 7468 222c 0a20 2020 2020 2020 2020 2020 th",. │ │ │ │ │ -000167d0: 2020 2020 2020 2020 2020 2020 2266 6974 "fit │ │ │ │ │ -000167e0: 6865 6967 6874 222e 2020 2273 7472 6574 height". "stret │ │ │ │ │ -000167f0: 6368 2220 666f 7220 6669 7474 696e 6720 ch" for fitting │ │ │ │ │ -00016800: 7468 650a 2020 2020 2020 2020 2020 2020 the. │ │ │ │ │ -00016810: 2020 2020 2020 2020 2020 2073 6372 6565 scree │ │ │ │ │ -00016820: 6e20 7369 7a65 2e20 204f 7468 6572 7769 n size. Otherwi │ │ │ │ │ -00016830: 7365 2069 7420 6973 0a20 2020 2020 2020 se it is. │ │ │ │ │ -00016840: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00016850: 7072 6f70 6f72 7469 6f6e 616c 2073 6361 proportional sca │ │ │ │ │ -00016860: 6c69 6e67 206f 6620 6120 7061 7274 206f ling of a part o │ │ │ │ │ -00016870: 660a 2020 2020 2020 2020 2020 2020 2020 f. │ │ │ │ │ -00016880: 2020 2020 2020 2020 202a 6465 736b 746f *deskto │ │ │ │ │ -00016890: 702d 696d 6167 652a 2074 6f20 7468 6520 p-image* to the │ │ │ │ │ -000168a0: 7061 7274 206f 6620 7468 650a 2020 2020 part of the. │ │ │ │ │ +000167a0: 2020 2020 2263 726f 7022 2c20 2270 6164 "crop", "pad │ │ │ │ │ +000167b0: 6469 6e67 222c 2022 6669 7477 6964 7468 ding", "fitwidth │ │ │ │ │ +000167c0: 222c 0a20 2020 2020 2020 2020 2020 2020 ",. │ │ │ │ │ +000167d0: 2020 2020 2020 2020 2020 2266 6974 6865 "fithe │ │ │ │ │ +000167e0: 6967 6874 222e 2020 2273 7472 6574 6368 ight". "stretch │ │ │ │ │ +000167f0: 2220 666f 7220 6669 7474 696e 6720 7468 " for fitting th │ │ │ │ │ +00016800: 650a 2020 2020 2020 2020 2020 2020 2020 e. │ │ │ │ │ +00016810: 2020 2020 2020 2020 2073 6372 6565 6e20 screen │ │ │ │ │ +00016820: 7369 7a65 2e20 204f 7468 6572 7769 7365 size. Otherwise │ │ │ │ │ +00016830: 2069 7420 6973 0a20 2020 2020 2020 2020 it is. │ │ │ │ │ +00016840: 2020 2020 2020 2020 2020 2020 2020 7072 pr │ │ │ │ │ +00016850: 6f70 6f72 7469 6f6e 616c 2073 6361 6c69 oportional scali │ │ │ │ │ +00016860: 6e67 206f 6620 6120 7061 7274 206f 660a ng of a part of. │ │ │ │ │ +00016870: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00016880: 2020 2020 2020 202a 6465 736b 746f 702d *desktop- │ │ │ │ │ +00016890: 696d 6167 652a 2074 6f20 7468 6520 7061 image* to the pa │ │ │ │ │ +000168a0: 7274 206f 6620 7468 650a 2020 2020 2020 rt of the. │ │ │ │ │ 000168b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000168c0: 2020 2073 6372 6565 6e2e 2020 2263 726f screen. "cro │ │ │ │ │ -000168d0: 7022 2070 6172 7420 6f66 2074 6865 0a20 p" part of the. │ │ │ │ │ +000168c0: 2073 6372 6565 6e2e 2020 2263 726f 7022 screen. "crop" │ │ │ │ │ +000168d0: 2070 6172 7420 6f66 2074 6865 0a20 2020 part of the. │ │ │ │ │ 000168e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000168f0: 2020 2020 2020 2a64 6573 6b74 6f70 2d69 *desktop-i │ │ │ │ │ -00016900: 6d61 6765 2a20 7769 6c6c 2062 6520 7072 mage* will be pr │ │ │ │ │ -00016910: 6f70 6f72 7469 6f6e 616c 6c79 0a20 2020 oportionally. │ │ │ │ │ +000168f0: 2020 2020 2a64 6573 6b74 6f70 2d69 6d61 *desktop-ima │ │ │ │ │ +00016900: 6765 2a20 7769 6c6c 2062 6520 7072 6f70 ge* will be prop │ │ │ │ │ +00016910: 6f72 7469 6f6e 616c 6c79 0a20 2020 2020 ortionally. │ │ │ │ │ 00016920: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00016930: 2020 2020 7363 616c 6564 2074 6f20 6669 scaled to fi │ │ │ │ │ -00016940: 7420 7468 6520 7363 7265 656e 2073 697a t the screen siz │ │ │ │ │ -00016950: 6573 2e0a 2020 2020 2020 2020 2020 2020 es.. │ │ │ │ │ -00016960: 2020 2020 2020 2020 2020 2022 7061 6464 "padd │ │ │ │ │ -00016970: 696e 6722 2074 6865 2065 6e74 6972 6520 ing" the entire │ │ │ │ │ -00016980: 2a64 6573 6b74 6f70 2d69 6d61 6765 2a20 *desktop-image* │ │ │ │ │ -00016990: 7769 6c6c 0a20 2020 2020 2020 2020 2020 will. │ │ │ │ │ -000169a0: 2020 2020 2020 2020 2020 2020 6265 2063 be c │ │ │ │ │ -000169b0: 6f6e 7461 696e 6564 206f 6e20 7468 6520 ontained on the │ │ │ │ │ -000169c0: 7363 7265 656e 2e20 2022 6669 7477 6964 screen. "fitwid │ │ │ │ │ -000169d0: 7468 220a 2020 2020 2020 2020 2020 2020 th". │ │ │ │ │ -000169e0: 2020 2020 2020 2020 2020 2066 6f72 2066 for f │ │ │ │ │ -000169f0: 6974 7469 6e67 2074 6865 202a 6465 736b itting the *desk │ │ │ │ │ -00016a00: 746f 702d 696d 6167 652a 2773 2077 6964 top-image*'s wid │ │ │ │ │ -00016a10: 7468 0a20 2020 2020 2020 2020 2020 2020 th. │ │ │ │ │ -00016a20: 2020 2020 2020 2020 2020 7769 7468 2073 with s │ │ │ │ │ -00016a30: 6372 6565 6e20 7769 6474 682e 2020 2266 creen width. "f │ │ │ │ │ -00016a40: 6974 6865 6967 6874 2220 666f 720a 2020 itheight" for. │ │ │ │ │ +00016930: 2020 7363 616c 6564 2074 6f20 6669 7420 scaled to fit │ │ │ │ │ +00016940: 7468 6520 7363 7265 656e 2073 697a 6573 the screen sizes │ │ │ │ │ +00016950: 2e0a 2020 2020 2020 2020 2020 2020 2020 .. │ │ │ │ │ +00016960: 2020 2020 2020 2020 2022 7061 6464 696e "paddin │ │ │ │ │ +00016970: 6722 2074 6865 2065 6e74 6972 6520 2a64 g" the entire *d │ │ │ │ │ +00016980: 6573 6b74 6f70 2d69 6d61 6765 2a20 7769 esktop-image* wi │ │ │ │ │ +00016990: 6c6c 0a20 2020 2020 2020 2020 2020 2020 ll. │ │ │ │ │ +000169a0: 2020 2020 2020 2020 2020 6265 2063 6f6e be con │ │ │ │ │ +000169b0: 7461 696e 6564 206f 6e20 7468 6520 7363 tained on the sc │ │ │ │ │ +000169c0: 7265 656e 2e20 2022 6669 7477 6964 7468 reen. "fitwidth │ │ │ │ │ +000169d0: 220a 2020 2020 2020 2020 2020 2020 2020 ". │ │ │ │ │ +000169e0: 2020 2020 2020 2020 2066 6f72 2066 6974 for fit │ │ │ │ │ +000169f0: 7469 6e67 2074 6865 202a 6465 736b 746f ting the *deskto │ │ │ │ │ +00016a00: 702d 696d 6167 652a 2773 2077 6964 7468 p-image*'s width │ │ │ │ │ +00016a10: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +00016a20: 2020 2020 2020 2020 7769 7468 2073 6372 with scr │ │ │ │ │ +00016a30: 6565 6e20 7769 6474 682e 2020 2266 6974 een width. "fit │ │ │ │ │ +00016a40: 6865 6967 6874 2220 666f 720a 2020 2020 height" for. │ │ │ │ │ 00016a50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00016a60: 2020 2020 2066 6974 7469 6e67 2074 6865 fitting the │ │ │ │ │ -00016a70: 202a 6465 736b 746f 702d 696d 6167 652a *desktop-image* │ │ │ │ │ -00016a80: 2773 2068 6569 6768 7420 7769 7468 0a20 's height with. │ │ │ │ │ +00016a60: 2020 2066 6974 7469 6e67 2074 6865 202a fitting the * │ │ │ │ │ +00016a70: 6465 736b 746f 702d 696d 6167 652a 2773 desktop-image*'s │ │ │ │ │ +00016a80: 2068 6569 6768 7420 7769 7468 0a20 2020 height with. │ │ │ │ │ 00016a90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00016aa0: 2020 2020 2020 7468 6520 7363 7265 656e the screen │ │ │ │ │ -00016ab0: 2068 6569 6768 742e 2020 4465 6661 756c height. Defaul │ │ │ │ │ -00016ac0: 7420 6973 2022 7374 7265 7463 6822 2e0a t is "stretch".. │ │ │ │ │ -00016ad0: 6465 736b 746f 702d 696d 6167 652d 682d desktop-image-h- │ │ │ │ │ -00016ae0: 616c 6967 6e20 2053 7065 6369 6669 6573 align Specifies │ │ │ │ │ -00016af0: 2074 6865 2068 6f72 697a 6f6e 7461 6c20 the horizontal │ │ │ │ │ -00016b00: 616c 6967 6e6d 656e 7420 6f66 2074 6865 alignment of the │ │ │ │ │ -00016b10: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ -00016b20: 2020 2020 2020 2020 2a64 6573 6b74 6f70 *desktop │ │ │ │ │ -00016b30: 2d69 6d61 6765 2a20 6966 0a20 2020 2020 -image* if. │ │ │ │ │ +00016aa0: 2020 2020 7468 6520 7363 7265 656e 2068 the screen h │ │ │ │ │ +00016ab0: 6569 6768 742e 2020 4465 6661 756c 7420 eight. Default │ │ │ │ │ +00016ac0: 6973 2022 7374 7265 7463 6822 2e0a 6465 is "stretch"..de │ │ │ │ │ +00016ad0: 736b 746f 702d 696d 6167 652d 682d 616c sktop-image-h-al │ │ │ │ │ +00016ae0: 6967 6e20 2053 7065 6369 6669 6573 2074 ign Specifies t │ │ │ │ │ +00016af0: 6865 2068 6f72 697a 6f6e 7461 6c20 616c he horizontal al │ │ │ │ │ +00016b00: 6967 6e6d 656e 7420 6f66 2074 6865 0a20 ignment of the. │ │ │ │ │ +00016b10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00016b20: 2020 2020 2020 2a64 6573 6b74 6f70 2d69 *desktop-i │ │ │ │ │ +00016b30: 6d61 6765 2a20 6966 0a20 2020 2020 2020 mage* if. │ │ │ │ │ 00016b40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00016b50: 2020 2a64 6573 6b74 6f70 2d69 6d61 6765 *desktop-image │ │ │ │ │ -00016b60: 2d73 6361 6c65 2d6d 6574 686f 642a 2069 -scale-method* i │ │ │ │ │ -00016b70: 736e 2774 2065 7175 6561 6c0a 2020 2020 sn't equeal. │ │ │ │ │ +00016b50: 2a64 6573 6b74 6f70 2d69 6d61 6765 2d73 *desktop-image-s │ │ │ │ │ +00016b60: 6361 6c65 2d6d 6574 686f 642a 2069 736e cale-method* isn │ │ │ │ │ +00016b70: 2774 2065 7175 6561 6c0a 2020 2020 2020 't equeal. │ │ │ │ │ 00016b80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00016b90: 2020 2074 6f20 2273 7472 6574 6368 222e to "stretch". │ │ │ │ │ -00016ba0: 2020 4f70 7469 6f6e 7320 6172 6520 226c Options are "l │ │ │ │ │ -00016bb0: 6566 7422 2c0a 2020 2020 2020 2020 2020 eft",. │ │ │ │ │ -00016bc0: 2020 2020 2020 2020 2020 2020 2022 6365 "ce │ │ │ │ │ -00016bd0: 6e74 6572 222c 2022 7269 6768 7422 2e20 nter", "right". │ │ │ │ │ -00016be0: 2044 6566 6175 6c74 2069 7320 2263 656e Default is "cen │ │ │ │ │ -00016bf0: 7465 7222 2e0a 6465 736b 746f 702d 696d ter"..desktop-im │ │ │ │ │ -00016c00: 6167 652d 762d 616c 6967 6e20 2053 7065 age-v-align Spe │ │ │ │ │ -00016c10: 6369 6669 6573 2074 6865 2076 6572 7469 cifies the verti │ │ │ │ │ -00016c20: 6361 6c20 616c 6967 6e6d 656e 7420 6f66 cal alignment of │ │ │ │ │ -00016c30: 2074 6865 0a20 2020 2020 2020 2020 2020 the. │ │ │ │ │ -00016c40: 2020 2020 2020 2020 2020 2020 2a64 6573 *des │ │ │ │ │ -00016c50: 6b74 6f70 2d69 6d61 6765 2a20 6966 0a20 ktop-image* if. │ │ │ │ │ +00016b90: 2074 6f20 2273 7472 6574 6368 222e 2020 to "stretch". │ │ │ │ │ +00016ba0: 4f70 7469 6f6e 7320 6172 6520 226c 6566 Options are "lef │ │ │ │ │ +00016bb0: 7422 2c0a 2020 2020 2020 2020 2020 2020 t",. │ │ │ │ │ +00016bc0: 2020 2020 2020 2020 2020 2022 6365 6e74 "cent │ │ │ │ │ +00016bd0: 6572 222c 2022 7269 6768 7422 2e20 2044 er", "right". D │ │ │ │ │ +00016be0: 6566 6175 6c74 2069 7320 2263 656e 7465 efault is "cente │ │ │ │ │ +00016bf0: 7222 2e0a 6465 736b 746f 702d 696d 6167 r"..desktop-imag │ │ │ │ │ +00016c00: 652d 762d 616c 6967 6e20 2053 7065 6369 e-v-align Speci │ │ │ │ │ +00016c10: 6669 6573 2074 6865 2076 6572 7469 6361 fies the vertica │ │ │ │ │ +00016c20: 6c20 616c 6967 6e6d 656e 7420 6f66 2074 l alignment of t │ │ │ │ │ +00016c30: 6865 0a20 2020 2020 2020 2020 2020 2020 he. │ │ │ │ │ +00016c40: 2020 2020 2020 2020 2020 2a64 6573 6b74 *deskt │ │ │ │ │ +00016c50: 6f70 2d69 6d61 6765 2a20 6966 0a20 2020 op-image* if. │ │ │ │ │ 00016c60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00016c70: 2020 2020 2020 2a64 6573 6b74 6f70 2d69 *desktop-i │ │ │ │ │ -00016c80: 6d61 6765 2d73 6361 6c65 2d6d 6574 686f mage-scale-metho │ │ │ │ │ -00016c90: 642a 2069 736e 2774 2065 7175 6561 6c0a d* isn't equeal. │ │ │ │ │ +00016c70: 2020 2020 2a64 6573 6b74 6f70 2d69 6d61 *desktop-ima │ │ │ │ │ +00016c80: 6765 2d73 6361 6c65 2d6d 6574 686f 642a ge-scale-method* │ │ │ │ │ +00016c90: 2069 736e 2774 2065 7175 6561 6c0a 2020 isn't equeal. │ │ │ │ │ 00016ca0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00016cb0: 2020 2020 2020 2074 6f20 2273 7472 6574 to "stret │ │ │ │ │ -00016cc0: 6368 222e 2020 4f70 7469 6f6e 7320 6172 ch". Options ar │ │ │ │ │ -00016cd0: 6520 2274 6f70 222c 0a20 2020 2020 2020 e "top",. │ │ │ │ │ -00016ce0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00016cf0: 2263 656e 7465 7222 2c20 2262 6f74 746f "center", "botto │ │ │ │ │ -00016d00: 6d22 2e20 2044 6566 6175 6c74 2069 7320 m". Default is │ │ │ │ │ -00016d10: 2263 656e 7465 7222 2e0a 6465 736b 746f "center"..deskto │ │ │ │ │ -00016d20: 702d 636f 6c6f 7220 2020 2020 2020 2020 p-color │ │ │ │ │ -00016d30: 2053 7065 6369 6669 6573 2074 6865 2063 Specifies the c │ │ │ │ │ -00016d40: 6f6c 6f72 2066 6f72 2074 6865 2062 6163 olor for the bac │ │ │ │ │ -00016d50: 6b67 726f 756e 6420 6966 0a20 2020 2020 kground if. │ │ │ │ │ +00016cb0: 2020 2020 2074 6f20 2273 7472 6574 6368 to "stretch │ │ │ │ │ +00016cc0: 222e 2020 4f70 7469 6f6e 7320 6172 6520 ". Options are │ │ │ │ │ +00016cd0: 2274 6f70 222c 0a20 2020 2020 2020 2020 "top",. │ │ │ │ │ +00016ce0: 2020 2020 2020 2020 2020 2020 2020 2263 "c │ │ │ │ │ +00016cf0: 656e 7465 7222 2c20 2262 6f74 746f 6d22 enter", "bottom" │ │ │ │ │ +00016d00: 2e20 2044 6566 6175 6c74 2069 7320 2263 . Default is "c │ │ │ │ │ +00016d10: 656e 7465 7222 2e0a 6465 736b 746f 702d enter"..desktop- │ │ │ │ │ +00016d20: 636f 6c6f 7220 2020 2020 2020 2020 2053 color S │ │ │ │ │ +00016d30: 7065 6369 6669 6573 2074 6865 2063 6f6c pecifies the col │ │ │ │ │ +00016d40: 6f72 2066 6f72 2074 6865 2062 6163 6b67 or for the backg │ │ │ │ │ +00016d50: 726f 756e 6420 6966 0a20 2020 2020 2020 round if. │ │ │ │ │ 00016d60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00016d70: 2020 2a64 6573 6b74 6f70 2d69 6d61 6765 *desktop-image │ │ │ │ │ -00016d80: 2a20 6973 206e 6f74 2073 7065 6369 6669 * is not specifi │ │ │ │ │ -00016d90: 6564 2e0a 7465 726d 696e 616c 2d62 6f78 ed..terminal-box │ │ │ │ │ -00016da0: 2020 2020 2020 2020 2020 2053 7065 6369 Speci │ │ │ │ │ -00016db0: 6669 6573 2074 6865 2066 696c 6520 6e61 fies the file na │ │ │ │ │ -00016dc0: 6d65 2070 6174 7465 726e 2066 6f72 2074 me pattern for t │ │ │ │ │ -00016dd0: 6865 0a20 2020 2020 2020 2020 2020 2020 he. │ │ │ │ │ -00016de0: 2020 2020 2020 2020 2020 7374 796c 6564 styled │ │ │ │ │ -00016df0: 2062 6f78 2073 6c69 6365 7320 7573 6564 box slices used │ │ │ │ │ -00016e00: 2066 6f72 2074 6865 2063 6f6d 6d61 6e64 for the command │ │ │ │ │ -00016e10: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ -00016e20: 2020 2020 2020 2020 6c69 6e65 2074 6572 line ter │ │ │ │ │ -00016e30: 6d69 6e61 6c20 7769 6e64 6f77 2e20 2046 minal window. F │ │ │ │ │ -00016e40: 6f72 2065 7861 6d70 6c65 2c0a 2020 2020 or example,. │ │ │ │ │ +00016d70: 2a64 6573 6b74 6f70 2d69 6d61 6765 2a20 *desktop-image* │ │ │ │ │ +00016d80: 6973 206e 6f74 2073 7065 6369 6669 6564 is not specified │ │ │ │ │ +00016d90: 2e0a 7465 726d 696e 616c 2d62 6f78 2020 ..terminal-box │ │ │ │ │ +00016da0: 2020 2020 2020 2020 2053 7065 6369 6669 Specifi │ │ │ │ │ +00016db0: 6573 2074 6865 2066 696c 6520 6e61 6d65 es the file name │ │ │ │ │ +00016dc0: 2070 6174 7465 726e 2066 6f72 2074 6865 pattern for the │ │ │ │ │ +00016dd0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +00016de0: 2020 2020 2020 2020 7374 796c 6564 2062 styled b │ │ │ │ │ +00016df0: 6f78 2073 6c69 6365 7320 7573 6564 2066 ox slices used f │ │ │ │ │ +00016e00: 6f72 2074 6865 2063 6f6d 6d61 6e64 0a20 or the command. │ │ │ │ │ +00016e10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00016e20: 2020 2020 2020 6c69 6e65 2074 6572 6d69 line termi │ │ │ │ │ +00016e30: 6e61 6c20 7769 6e64 6f77 2e20 2046 6f72 nal window. For │ │ │ │ │ +00016e40: 2065 7861 6d70 6c65 2c0a 2020 2020 2020 example,. │ │ │ │ │ 00016e50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00016e60: 2020 2022 7465 726d 696e 616c 2d62 6f78 "terminal-box │ │ │ │ │ -00016e70: 3a20 7465 726d 696e 616c 5f2a 2e70 6e67 : terminal_*.png │ │ │ │ │ -00016e80: 2220 7769 6c6c 2075 7365 0a20 2020 2020 " will use. │ │ │ │ │ +00016e60: 2022 7465 726d 696e 616c 2d62 6f78 3a20 "terminal-box: │ │ │ │ │ +00016e70: 7465 726d 696e 616c 5f2a 2e70 6e67 2220 terminal_*.png" │ │ │ │ │ +00016e80: 7769 6c6c 2075 7365 0a20 2020 2020 2020 will use. │ │ │ │ │ 00016e90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00016ea0: 2020 7468 6520 696d 6167 6573 2022 7465 the images "te │ │ │ │ │ -00016eb0: 726d 696e 616c 5f63 2e70 6e67 2220 6173 rminal_c.png" as │ │ │ │ │ -00016ec0: 2074 6865 2063 656e 7465 720a 2020 2020 the center. │ │ │ │ │ +00016ea0: 7468 6520 696d 6167 6573 2022 7465 726d the images "term │ │ │ │ │ +00016eb0: 696e 616c 5f63 2e70 6e67 2220 6173 2074 inal_c.png" as t │ │ │ │ │ +00016ec0: 6865 2063 656e 7465 720a 2020 2020 2020 he center. │ │ │ │ │ 00016ed0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00016ee0: 2020 2061 7265 612c 2022 7465 726d 696e area, "termin │ │ │ │ │ -00016ef0: 616c 5f6e 2e70 6e67 2220 6173 2074 6865 al_n.png" as the │ │ │ │ │ -00016f00: 206e 6f72 7468 2028 746f 7029 0a20 2020 north (top). │ │ │ │ │ +00016ee0: 2061 7265 612c 2022 7465 726d 696e 616c area, "terminal │ │ │ │ │ +00016ef0: 5f6e 2e70 6e67 2220 6173 2074 6865 206e _n.png" as the n │ │ │ │ │ +00016f00: 6f72 7468 2028 746f 7029 0a20 2020 2020 orth (top). │ │ │ │ │ 00016f10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00016f20: 2020 2020 6564 6765 2c20 2274 6572 6d69 edge, "termi │ │ │ │ │ -00016f30: 6e61 6c5f 6e77 2e70 6e67 2220 6173 2074 nal_nw.png" as t │ │ │ │ │ -00016f40: 6865 206e 6f72 7468 7765 7374 0a20 2020 he northwest. │ │ │ │ │ +00016f20: 2020 6564 6765 2c20 2274 6572 6d69 6e61 edge, "termina │ │ │ │ │ +00016f30: 6c5f 6e77 2e70 6e67 2220 6173 2074 6865 l_nw.png" as the │ │ │ │ │ +00016f40: 206e 6f72 7468 7765 7374 0a20 2020 2020 northwest. │ │ │ │ │ 00016f50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00016f60: 2020 2020 2875 7070 6572 206c 6566 7429 (upper left) │ │ │ │ │ -00016f70: 2063 6f72 6e65 722c 2061 6e64 2073 6f20 corner, and so │ │ │ │ │ -00016f80: 6f6e 2e20 2049 6620 7468 650a 2020 2020 on. If the. │ │ │ │ │ +00016f60: 2020 2875 7070 6572 206c 6566 7429 2063 (upper left) c │ │ │ │ │ +00016f70: 6f72 6e65 722c 2061 6e64 2073 6f20 6f6e orner, and so on │ │ │ │ │ +00016f80: 2e20 2049 6620 7468 650a 2020 2020 2020 . If the. │ │ │ │ │ 00016f90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00016fa0: 2020 2069 6d61 6765 2066 6f72 2061 6e79 image for any │ │ │ │ │ -00016fb0: 2073 6c69 6365 2069 7320 6e6f 7420 666f slice is not fo │ │ │ │ │ -00016fc0: 756e 642c 2069 7420 7769 6c6c 0a20 2020 und, it will. │ │ │ │ │ +00016fa0: 2069 6d61 6765 2066 6f72 2061 6e79 2073 image for any s │ │ │ │ │ +00016fb0: 6c69 6365 2069 7320 6e6f 7420 666f 756e lice is not foun │ │ │ │ │ +00016fc0: 642c 2069 7420 7769 6c6c 0a20 2020 2020 d, it will. │ │ │ │ │ 00016fd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00016fe0: 2020 2020 7369 6d70 6c79 2062 6520 6c65 simply be le │ │ │ │ │ -00016ff0: 6674 2065 6d70 7479 2e0a 7465 726d 696e ft empty..termin │ │ │ │ │ -00017000: 616c 2d62 6f72 6465 7220 2020 2020 2020 al-border │ │ │ │ │ -00017010: 2053 7065 6369 6669 6573 2074 6865 2062 Specifies the b │ │ │ │ │ -00017020: 6f72 6465 7220 7769 6474 6820 6f66 2074 order width of t │ │ │ │ │ -00017030: 6865 0a20 2020 2020 2020 2020 2020 2020 he. │ │ │ │ │ -00017040: 2020 2020 2020 2020 2020 7465 726d 696e termin │ │ │ │ │ -00017050: 616c 2077 696e 646f 772e 0a74 6572 6d69 al window..termi │ │ │ │ │ -00017060: 6e61 6c2d 6c65 6674 2020 2020 2020 2020 nal-left │ │ │ │ │ -00017070: 2020 5370 6563 6966 6965 7320 7468 6520 Specifies the │ │ │ │ │ -00017080: 6c65 6674 2063 6f6f 7264 696e 6174 6520 left coordinate │ │ │ │ │ -00017090: 6f66 2074 6865 0a20 2020 2020 2020 2020 of the. │ │ │ │ │ -000170a0: 2020 2020 2020 2020 2020 2020 2020 7465 te │ │ │ │ │ -000170b0: 726d 696e 616c 2077 696e 646f 772e 0a74 rminal window..t │ │ │ │ │ -000170c0: 6572 6d69 6e61 6c2d 746f 7020 2020 2020 erminal-top │ │ │ │ │ -000170d0: 2020 2020 2020 5370 6563 6966 6965 7320 Specifies │ │ │ │ │ -000170e0: 7468 6520 746f 7020 636f 6f72 6469 6e61 the top coordina │ │ │ │ │ -000170f0: 7465 206f 6620 7468 650a 2020 2020 2020 te of the. │ │ │ │ │ -00017100: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00017110: 2074 6572 6d69 6e61 6c20 7769 6e64 6f77 terminal window │ │ │ │ │ -00017120: 2e0a 7465 726d 696e 616c 2d77 6964 7468 ..terminal-width │ │ │ │ │ -00017130: 2020 2020 2020 2020 2053 7065 6369 6669 Specifi │ │ │ │ │ -00017140: 6573 2074 6865 2077 6964 7468 206f 6620 es the width of │ │ │ │ │ -00017150: 7468 6520 7465 726d 696e 616c 0a20 2020 the terminal. │ │ │ │ │ +00016fe0: 2020 7369 6d70 6c79 2062 6520 6c65 6674 simply be left │ │ │ │ │ +00016ff0: 2065 6d70 7479 2e0a 7465 726d 696e 616c empty..terminal │ │ │ │ │ +00017000: 2d62 6f72 6465 7220 2020 2020 2020 2053 -border S │ │ │ │ │ +00017010: 7065 6369 6669 6573 2074 6865 2062 6f72 pecifies the bor │ │ │ │ │ +00017020: 6465 7220 7769 6474 6820 6f66 2074 6865 der width of the │ │ │ │ │ +00017030: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +00017040: 2020 2020 2020 2020 7465 726d 696e 616c terminal │ │ │ │ │ +00017050: 2077 696e 646f 772e 0a74 6572 6d69 6e61 window..termina │ │ │ │ │ +00017060: 6c2d 6c65 6674 2020 2020 2020 2020 2020 l-left │ │ │ │ │ +00017070: 5370 6563 6966 6965 7320 7468 6520 6c65 Specifies the le │ │ │ │ │ +00017080: 6674 2063 6f6f 7264 696e 6174 6520 6f66 ft coordinate of │ │ │ │ │ +00017090: 2074 6865 0a20 2020 2020 2020 2020 2020 the. │ │ │ │ │ +000170a0: 2020 2020 2020 2020 2020 2020 7465 726d term │ │ │ │ │ +000170b0: 696e 616c 2077 696e 646f 772e 0a74 6572 inal window..ter │ │ │ │ │ +000170c0: 6d69 6e61 6c2d 746f 7020 2020 2020 2020 minal-top │ │ │ │ │ +000170d0: 2020 2020 5370 6563 6966 6965 7320 7468 Specifies th │ │ │ │ │ +000170e0: 6520 746f 7020 636f 6f72 6469 6e61 7465 e top coordinate │ │ │ │ │ +000170f0: 206f 6620 7468 650a 2020 2020 2020 2020 of the. │ │ │ │ │ +00017100: 2020 2020 2020 2020 2020 2020 2020 2074 t │ │ │ │ │ +00017110: 6572 6d69 6e61 6c20 7769 6e64 6f77 2e0a erminal window.. │ │ │ │ │ +00017120: 7465 726d 696e 616c 2d77 6964 7468 2020 terminal-width │ │ │ │ │ +00017130: 2020 2020 2020 2053 7065 6369 6669 6573 Specifies │ │ │ │ │ +00017140: 2074 6865 2077 6964 7468 206f 6620 7468 the width of th │ │ │ │ │ +00017150: 6520 7465 726d 696e 616c 0a20 2020 2020 e terminal. │ │ │ │ │ 00017160: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00017170: 2020 2020 7769 6e64 6f77 2e0a 7465 726d window..term │ │ │ │ │ -00017180: 696e 616c 2d68 6569 6768 7420 2020 2020 inal-height │ │ │ │ │ -00017190: 2020 2053 7065 6369 6669 6573 2074 6865 Specifies the │ │ │ │ │ -000171a0: 2068 6569 6768 7420 6f66 2074 6865 2074 height of the t │ │ │ │ │ -000171b0: 6572 6d69 6e61 6c0a 2020 2020 2020 2020 erminal. │ │ │ │ │ -000171c0: 2020 2020 2020 2020 2020 2020 2020 2077 w │ │ │ │ │ -000171d0: 696e 646f 772e 0a0a 372e 332e 3420 436f indow...7.3.4 Co │ │ │ │ │ -000171e0: 6d70 6f6e 656e 7420 436f 6e73 7472 7563 mponent Construc │ │ │ │ │ -000171f0: 7469 6f6e 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d tion.----------- │ │ │ │ │ -00017200: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00017210: 2d0a 0a47 7265 6174 6572 2063 7573 746f -..Greater custo │ │ │ │ │ -00017220: 6d69 7a61 6269 6c69 7479 2063 6f6d 6573 mizability comes │ │ │ │ │ -00017230: 2069 7320 7072 6f76 6964 6564 2062 7920 is provided by │ │ │ │ │ -00017240: 636f 6d70 6f6e 656e 7473 2e20 2041 2074 components. A t │ │ │ │ │ -00017250: 7265 6520 6f66 0a63 6f6d 706f 6e65 6e74 ree of.component │ │ │ │ │ -00017260: 7320 666f 726d 7320 7468 6520 7573 6572 s forms the user │ │ │ │ │ -00017270: 2069 6e74 6572 6661 6365 2e20 202a 436f interface. *Co │ │ │ │ │ -00017280: 6e74 6169 6e65 7273 2a20 6172 6520 636f ntainers* are co │ │ │ │ │ -00017290: 6d70 6f6e 656e 7473 2074 6861 740a 6361 mponents that.ca │ │ │ │ │ -000172a0: 6e20 636f 6e74 6169 6e20 6f74 6865 7220 n contain other │ │ │ │ │ -000172b0: 636f 6d70 6f6e 656e 7473 2c20 616e 6420 components, and │ │ │ │ │ -000172c0: 7468 6572 6520 6973 2061 6c77 6179 7320 there is always │ │ │ │ │ -000172d0: 6120 7369 6e67 6c65 2072 6f6f 740a 636f a single root.co │ │ │ │ │ -000172e0: 6d70 6f6e 656e 7420 7768 6963 6820 6973 mponent which is │ │ │ │ │ -000172f0: 2061 6e20 696e 7374 616e 6365 206f 6620 an instance of │ │ │ │ │ -00017300: 6120 2a63 616e 7661 732a 2063 6f6e 7461 a *canvas* conta │ │ │ │ │ -00017310: 696e 6572 2e0a 0a20 2020 436f 6d70 6f6e iner... Compon │ │ │ │ │ -00017320: 656e 7473 2061 7265 2063 7265 6174 6564 ents are created │ │ │ │ │ -00017330: 2069 6e20 7468 6520 7468 656d 6520 6669 in the theme fi │ │ │ │ │ -00017340: 6c65 2062 7920 7072 6566 6978 696e 6720 le by prefixing │ │ │ │ │ -00017350: 7468 6520 7479 7065 206f 660a 636f 6d70 the type of.comp │ │ │ │ │ -00017360: 6f6e 656e 7420 7769 7468 2061 2027 2b27 onent with a '+' │ │ │ │ │ -00017370: 2073 6967 6e3a 0a0a 2020 2027 202b 206c sign:.. ' + l │ │ │ │ │ -00017380: 6162 656c 207b 2074 6578 743d 2247 5255 abel { text="GRU │ │ │ │ │ -00017390: 4222 2066 6f6e 743d 2261 7175 6920 3131 B" font="aqui 11 │ │ │ │ │ -000173a0: 2220 636f 6c6f 723d 2223 3846 4622 207d " color="#8FF" } │ │ │ │ │ -000173b0: 2027 0a0a 2020 2070 726f 7065 7274 6965 '.. propertie │ │ │ │ │ -000173c0: 7320 6f66 2061 2063 6f6d 706f 6e65 6e74 s of a component │ │ │ │ │ -000173d0: 2061 7265 2073 7065 6369 6669 6564 2061 are specified a │ │ │ │ │ -000173e0: 7320 226e 616d 6520 3d20 7661 6c75 6522 s "name = value" │ │ │ │ │ -000173f0: 2028 7768 6974 6573 7061 6365 0a73 7572 (whitespace.sur │ │ │ │ │ -00017400: 726f 756e 6469 6e67 2074 6f6b 656e 7320 rounding tokens │ │ │ │ │ -00017410: 6973 206f 7074 696f 6e61 6c20 616e 6420 is optional and │ │ │ │ │ -00017420: 6973 2069 676e 6f72 6564 2920 7768 6572 is ignored) wher │ │ │ │ │ -00017430: 6520 2a76 616c 7565 2a20 6d61 7920 6265 e *value* may be │ │ │ │ │ -00017440: 3a0a 2020 202a 2061 2073 696e 676c 6520 :. * a single │ │ │ │ │ -00017450: 776f 7264 2028 652e 672e 2c20 2261 6c69 word (e.g., "ali │ │ │ │ │ -00017460: 676e 203d 2063 656e 7465 7222 2c20 2263 gn = center", "c │ │ │ │ │ -00017470: 6f6c 6f72 203d 2023 4646 3830 3830 2229 olor = #FF8080") │ │ │ │ │ -00017480: 2c0a 2020 202a 2061 2071 756f 7465 6420 ,. * a quoted │ │ │ │ │ -00017490: 7374 7269 6e67 2028 652e 672e 2c20 2274 string (e.g., "t │ │ │ │ │ -000174a0: 6578 7420 3d20 2248 656c 6c6f 2c20 576f ext = "Hello, Wo │ │ │ │ │ -000174b0: 726c 6421 2222 292c 206f 720a 2020 202a rld!""), or. * │ │ │ │ │ -000174c0: 2061 2074 7570 6c65 2028 652e 672e 2c20 a tuple (e.g., │ │ │ │ │ -000174d0: 2270 7265 6665 7272 6564 5f73 697a 6520 "preferred_size │ │ │ │ │ -000174e0: 3d20 2831 3230 2c20 3830 2922 292e 0a0a = (120, 80)")... │ │ │ │ │ -000174f0: 372e 332e 3520 436f 6d70 6f6e 656e 7420 7.3.5 Component │ │ │ │ │ -00017500: 4c69 7374 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d List.----------- │ │ │ │ │ -00017510: 2d2d 2d2d 2d2d 2d2d 2d0a 0a54 6865 2066 ---------..The f │ │ │ │ │ -00017520: 6f6c 6c6f 7769 6e67 2069 7320 6120 6c69 ollowing is a li │ │ │ │ │ -00017530: 7374 206f 6620 7468 6520 636f 6d70 6f6e st of the compon │ │ │ │ │ -00017540: 656e 7473 2061 6e64 2074 6865 2070 726f ents and the pro │ │ │ │ │ -00017550: 7065 7274 6965 7320 7468 6579 0a73 7570 perties they.sup │ │ │ │ │ -00017560: 706f 7274 2e0a 0a20 2020 2a20 6c61 6265 port... * labe │ │ │ │ │ -00017570: 6c20 4120 6c61 6265 6c20 6469 7370 6c61 l A label displa │ │ │ │ │ -00017580: 7973 2061 206c 696e 6520 6f66 2074 6578 ys a line of tex │ │ │ │ │ -00017590: 742e 0a0a 2020 2020 2050 726f 7065 7274 t... Propert │ │ │ │ │ -000175a0: 6965 733a 0a20 2020 2020 6964 2020 2020 ies:. id │ │ │ │ │ -000175b0: 2020 2020 2020 2020 2053 6574 2074 6f20 Set to │ │ │ │ │ -000175c0: 225f 5f74 696d 656f 7574 5f5f 2220 746f "__timeout__" to │ │ │ │ │ -000175d0: 2064 6973 706c 6179 2074 6865 2074 696d display the tim │ │ │ │ │ -000175e0: 6520 656c 6170 7365 640a 2020 2020 2020 e elapsed. │ │ │ │ │ -000175f0: 2020 2020 2020 2020 2020 2020 2020 746f to │ │ │ │ │ -00017600: 2061 6e20 6175 746f 6d61 7469 6361 6c20 an automatical │ │ │ │ │ -00017610: 626f 6f74 206f 6620 7468 6520 6465 6661 boot of the defa │ │ │ │ │ -00017620: 756c 7420 656e 7472 792e 0a20 2020 2020 ult entry.. │ │ │ │ │ -00017630: 7465 7874 2020 2020 2020 2020 2020 2054 text T │ │ │ │ │ -00017640: 6865 2074 6578 7420 746f 2064 6973 706c he text to displ │ │ │ │ │ -00017650: 6179 2e20 2049 6620 2269 6422 2069 7320 ay. If "id" is │ │ │ │ │ -00017660: 7365 7420 746f 0a20 2020 2020 2020 2020 set to. │ │ │ │ │ -00017670: 2020 2020 2020 2020 2020 2022 5f5f 7469 "__ti │ │ │ │ │ -00017680: 6d65 6f75 745f 5f22 2061 6e64 206e 6f20 meout__" and no │ │ │ │ │ -00017690: 2274 6578 7422 2070 726f 7065 7274 7920 "text" property │ │ │ │ │ -000176a0: 6973 2073 6574 2074 6865 6e0a 2020 2020 is set then. │ │ │ │ │ -000176b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000176c0: 7468 6520 616d 6f75 6e74 206f 6620 7365 the amount of se │ │ │ │ │ -000176d0: 636f 6e64 7320 7769 6c6c 2062 6520 7368 conds will be sh │ │ │ │ │ -000176e0: 6f77 6e2e 2020 4966 2073 6574 2074 6f0a own. If set to. │ │ │ │ │ +00017170: 2020 7769 6e64 6f77 2e0a 7465 726d 696e window..termin │ │ │ │ │ +00017180: 616c 2d68 6569 6768 7420 2020 2020 2020 al-height │ │ │ │ │ +00017190: 2053 7065 6369 6669 6573 2074 6865 2068 Specifies the h │ │ │ │ │ +000171a0: 6569 6768 7420 6f66 2074 6865 2074 6572 eight of the ter │ │ │ │ │ +000171b0: 6d69 6e61 6c0a 2020 2020 2020 2020 2020 minal. │ │ │ │ │ +000171c0: 2020 2020 2020 2020 2020 2020 2077 696e win │ │ │ │ │ +000171d0: 646f 772e 0a0a 372e 332e 3420 436f 6d70 dow...7.3.4 Comp │ │ │ │ │ +000171e0: 6f6e 656e 7420 436f 6e73 7472 7563 7469 onent Constructi │ │ │ │ │ +000171f0: 6f6e 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d on.------------- │ │ │ │ │ +00017200: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ +00017210: 0a47 7265 6174 6572 2063 7573 746f 6d69 .Greater customi │ │ │ │ │ +00017220: 7a61 6269 6c69 7479 2063 6f6d 6573 2069 zability comes i │ │ │ │ │ +00017230: 7320 7072 6f76 6964 6564 2062 7920 636f s provided by co │ │ │ │ │ +00017240: 6d70 6f6e 656e 7473 2e20 2041 2074 7265 mponents. A tre │ │ │ │ │ +00017250: 6520 6f66 0a63 6f6d 706f 6e65 6e74 7320 e of.components │ │ │ │ │ +00017260: 666f 726d 7320 7468 6520 7573 6572 2069 forms the user i │ │ │ │ │ +00017270: 6e74 6572 6661 6365 2e20 202a 436f 6e74 nterface. *Cont │ │ │ │ │ +00017280: 6169 6e65 7273 2a20 6172 6520 636f 6d70 ainers* are comp │ │ │ │ │ +00017290: 6f6e 656e 7473 2074 6861 740a 6361 6e20 onents that.can │ │ │ │ │ +000172a0: 636f 6e74 6169 6e20 6f74 6865 7220 636f contain other co │ │ │ │ │ +000172b0: 6d70 6f6e 656e 7473 2c20 616e 6420 7468 mponents, and th │ │ │ │ │ +000172c0: 6572 6520 6973 2061 6c77 6179 7320 6120 ere is always a │ │ │ │ │ +000172d0: 7369 6e67 6c65 2072 6f6f 740a 636f 6d70 single root.comp │ │ │ │ │ +000172e0: 6f6e 656e 7420 7768 6963 6820 6973 2061 onent which is a │ │ │ │ │ +000172f0: 6e20 696e 7374 616e 6365 206f 6620 6120 n instance of a │ │ │ │ │ +00017300: 2a63 616e 7661 732a 2063 6f6e 7461 696e *canvas* contain │ │ │ │ │ +00017310: 6572 2e0a 0a20 2020 436f 6d70 6f6e 656e er... Componen │ │ │ │ │ +00017320: 7473 2061 7265 2063 7265 6174 6564 2069 ts are created i │ │ │ │ │ +00017330: 6e20 7468 6520 7468 656d 6520 6669 6c65 n the theme file │ │ │ │ │ +00017340: 2062 7920 7072 6566 6978 696e 6720 7468 by prefixing th │ │ │ │ │ +00017350: 6520 7479 7065 206f 660a 636f 6d70 6f6e e type of.compon │ │ │ │ │ +00017360: 656e 7420 7769 7468 2061 2027 2b27 2073 ent with a '+' s │ │ │ │ │ +00017370: 6967 6e3a 0a0a 2020 2027 202b 206c 6162 ign:.. ' + lab │ │ │ │ │ +00017380: 656c 207b 2074 6578 743d 2247 5255 4222 el { text="GRUB" │ │ │ │ │ +00017390: 2066 6f6e 743d 2261 7175 6920 3131 2220 font="aqui 11" │ │ │ │ │ +000173a0: 636f 6c6f 723d 2223 3846 4622 207d 2027 color="#8FF" } ' │ │ │ │ │ +000173b0: 0a0a 2020 2070 726f 7065 7274 6965 7320 .. properties │ │ │ │ │ +000173c0: 6f66 2061 2063 6f6d 706f 6e65 6e74 2061 of a component a │ │ │ │ │ +000173d0: 7265 2073 7065 6369 6669 6564 2061 7320 re specified as │ │ │ │ │ +000173e0: 226e 616d 6520 3d20 7661 6c75 6522 2028 "name = value" ( │ │ │ │ │ +000173f0: 7768 6974 6573 7061 6365 0a73 7572 726f whitespace.surro │ │ │ │ │ +00017400: 756e 6469 6e67 2074 6f6b 656e 7320 6973 unding tokens is │ │ │ │ │ +00017410: 206f 7074 696f 6e61 6c20 616e 6420 6973 optional and is │ │ │ │ │ +00017420: 2069 676e 6f72 6564 2920 7768 6572 6520 ignored) where │ │ │ │ │ +00017430: 2a76 616c 7565 2a20 6d61 7920 6265 3a0a *value* may be:. │ │ │ │ │ +00017440: 2020 202a 2061 2073 696e 676c 6520 776f * a single wo │ │ │ │ │ +00017450: 7264 2028 652e 672e 2c20 2261 6c69 676e rd (e.g., "align │ │ │ │ │ +00017460: 203d 2063 656e 7465 7222 2c20 2263 6f6c = center", "col │ │ │ │ │ +00017470: 6f72 203d 2023 4646 3830 3830 2229 2c0a or = #FF8080"),. │ │ │ │ │ +00017480: 2020 202a 2061 2071 756f 7465 6420 7374 * a quoted st │ │ │ │ │ +00017490: 7269 6e67 2028 652e 672e 2c20 2274 6578 ring (e.g., "tex │ │ │ │ │ +000174a0: 7420 3d20 2248 656c 6c6f 2c20 576f 726c t = "Hello, Worl │ │ │ │ │ +000174b0: 6421 2222 292c 206f 720a 2020 202a 2061 d!""), or. * a │ │ │ │ │ +000174c0: 2074 7570 6c65 2028 652e 672e 2c20 2270 tuple (e.g., "p │ │ │ │ │ +000174d0: 7265 6665 7272 6564 5f73 697a 6520 3d20 referred_size = │ │ │ │ │ +000174e0: 2831 3230 2c20 3830 2922 292e 0a0a 372e (120, 80)")...7. │ │ │ │ │ +000174f0: 332e 3520 436f 6d70 6f6e 656e 7420 4c69 3.5 Component Li │ │ │ │ │ +00017500: 7374 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d st.------------- │ │ │ │ │ +00017510: 2d2d 2d2d 2d2d 2d0a 0a54 6865 2066 6f6c -------..The fol │ │ │ │ │ +00017520: 6c6f 7769 6e67 2069 7320 6120 6c69 7374 lowing is a list │ │ │ │ │ +00017530: 206f 6620 7468 6520 636f 6d70 6f6e 656e of the componen │ │ │ │ │ +00017540: 7473 2061 6e64 2074 6865 2070 726f 7065 ts and the prope │ │ │ │ │ +00017550: 7274 6965 7320 7468 6579 0a73 7570 706f rties they.suppo │ │ │ │ │ +00017560: 7274 2e0a 0a20 2020 2a20 6c61 6265 6c20 rt... * label │ │ │ │ │ +00017570: 4120 6c61 6265 6c20 6469 7370 6c61 7973 A label displays │ │ │ │ │ +00017580: 2061 206c 696e 6520 6f66 2074 6578 742e a line of text. │ │ │ │ │ +00017590: 0a0a 2020 2020 2050 726f 7065 7274 6965 .. Propertie │ │ │ │ │ +000175a0: 733a 0a20 2020 2020 6964 2020 2020 2020 s:. id │ │ │ │ │ +000175b0: 2020 2020 2020 2053 6574 2074 6f20 225f Set to "_ │ │ │ │ │ +000175c0: 5f74 696d 656f 7574 5f5f 2220 746f 2064 _timeout__" to d │ │ │ │ │ +000175d0: 6973 706c 6179 2074 6865 2074 696d 6520 isplay the time │ │ │ │ │ +000175e0: 656c 6170 7365 640a 2020 2020 2020 2020 elapsed. │ │ │ │ │ +000175f0: 2020 2020 2020 2020 2020 2020 746f 2061 to a │ │ │ │ │ +00017600: 6e20 6175 746f 6d61 7469 6361 6c20 626f n automatical bo │ │ │ │ │ +00017610: 6f74 206f 6620 7468 6520 6465 6661 756c ot of the defaul │ │ │ │ │ +00017620: 7420 656e 7472 792e 0a20 2020 2020 7465 t entry.. te │ │ │ │ │ +00017630: 7874 2020 2020 2020 2020 2020 2054 6865 xt The │ │ │ │ │ +00017640: 2074 6578 7420 746f 2064 6973 706c 6179 text to display │ │ │ │ │ +00017650: 2e20 2049 6620 2269 6422 2069 7320 7365 . If "id" is se │ │ │ │ │ +00017660: 7420 746f 0a20 2020 2020 2020 2020 2020 t to. │ │ │ │ │ +00017670: 2020 2020 2020 2020 2022 5f5f 7469 6d65 "__time │ │ │ │ │ +00017680: 6f75 745f 5f22 2061 6e64 206e 6f20 2274 out__" and no "t │ │ │ │ │ +00017690: 6578 7422 2070 726f 7065 7274 7920 6973 ext" property is │ │ │ │ │ +000176a0: 2073 6574 2074 6865 6e0a 2020 2020 2020 set then. │ │ │ │ │ +000176b0: 2020 2020 2020 2020 2020 2020 2020 7468 th │ │ │ │ │ +000176c0: 6520 616d 6f75 6e74 206f 6620 7365 636f e amount of seco │ │ │ │ │ +000176d0: 6e64 7320 7769 6c6c 2062 6520 7368 6f77 nds will be show │ │ │ │ │ +000176e0: 6e2e 2020 4966 2073 6574 2074 6f0a 2020 n. If set to. │ │ │ │ │ 000176f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00017700: 2020 2020 2240 4b45 594d 4150 5f53 484f "@KEYMAP_SHO │ │ │ │ │ -00017710: 5254 4022 2c20 2240 4b45 594d 4150 5f4d RT@", "@KEYMAP_M │ │ │ │ │ -00017720: 4944 444c 4540 2220 6f72 0a20 2020 2020 IDDLE@" or. │ │ │ │ │ -00017730: 2020 2020 2020 2020 2020 2020 2020 2022 " │ │ │ │ │ -00017740: 404b 4559 4d41 505f 4c4f 4e47 4022 2074 @KEYMAP_LONG@" t │ │ │ │ │ -00017750: 6865 6e20 7072 6564 6566 696e 6564 2068 hen predefined h │ │ │ │ │ -00017760: 6f74 6b65 790a 2020 2020 2020 2020 2020 otkey. │ │ │ │ │ -00017770: 2020 2020 2020 2020 2020 696e 666f 726d inform │ │ │ │ │ -00017780: 6174 696f 6e20 7769 6c6c 2062 6520 7368 ation will be sh │ │ │ │ │ -00017790: 6f77 6e2e 0a20 2020 2020 666f 6e74 2020 own.. font │ │ │ │ │ -000177a0: 2020 2020 2020 2020 2054 6865 2066 6f6e The fon │ │ │ │ │ -000177b0: 7420 746f 2075 7365 2066 6f72 2074 6578 t to use for tex │ │ │ │ │ -000177c0: 7420 6469 7370 6c61 792e 0a20 2020 2020 t display.. │ │ │ │ │ -000177d0: 636f 6c6f 7220 2020 2020 2020 2020 2054 color T │ │ │ │ │ -000177e0: 6865 2063 6f6c 6f72 206f 6620 7468 6520 he color of the │ │ │ │ │ -000177f0: 7465 7874 2e0a 2020 2020 2061 6c69 676e text.. align │ │ │ │ │ -00017800: 2020 2020 2020 2020 2020 5468 6520 686f The ho │ │ │ │ │ -00017810: 7269 7a6f 6e74 616c 2061 6c69 676e 6d65 rizontal alignme │ │ │ │ │ -00017820: 6e74 206f 6620 7468 6520 7465 7874 2077 nt of the text w │ │ │ │ │ -00017830: 6974 6869 6e20 7468 650a 2020 2020 2020 ithin the. │ │ │ │ │ -00017840: 2020 2020 2020 2020 2020 2020 2020 636f co │ │ │ │ │ -00017850: 6d70 6f6e 656e 742e 2020 4f70 7469 6f6e mponent. Option │ │ │ │ │ -00017860: 7320 6172 6520 226c 6566 7422 2c20 2263 s are "left", "c │ │ │ │ │ -00017870: 656e 7465 7222 2061 6e64 0a20 2020 2020 enter" and. │ │ │ │ │ -00017880: 2020 2020 2020 2020 2020 2020 2020 2022 " │ │ │ │ │ -00017890: 7269 6768 7422 2e0a 2020 2020 2076 6973 right".. vis │ │ │ │ │ -000178a0: 6962 6c65 2020 2020 2020 2020 5365 7420 ible Set │ │ │ │ │ -000178b0: 746f 2022 6661 6c73 6522 2074 6f20 6869 to "false" to hi │ │ │ │ │ -000178c0: 6465 2074 6865 206c 6162 656c 2e0a 0a20 de the label... │ │ │ │ │ -000178d0: 2020 2a20 696d 6167 6520 4120 636f 6d70 * image A comp │ │ │ │ │ -000178e0: 6f6e 656e 7420 7468 6174 2064 6973 706c onent that displ │ │ │ │ │ -000178f0: 6179 7320 616e 2069 6d61 6765 2e20 2054 ays an image. T │ │ │ │ │ -00017900: 6865 2069 6d61 6765 2069 7320 7363 616c he image is scal │ │ │ │ │ -00017910: 6564 2074 6f0a 2020 2020 2066 6974 2074 ed to. fit t │ │ │ │ │ -00017920: 6865 2063 6f6d 706f 6e65 6e74 2e0a 0a20 he component... │ │ │ │ │ -00017930: 2020 2020 5072 6f70 6572 7469 6573 3a0a Properties:. │ │ │ │ │ -00017940: 0a20 2020 2020 6669 6c65 2020 2020 2020 . file │ │ │ │ │ -00017950: 2020 2020 2054 6865 2066 756c 6c20 7061 The full pa │ │ │ │ │ -00017960: 7468 2074 6f20 7468 6520 696d 6167 6520 th to the image │ │ │ │ │ -00017970: 6669 6c65 2074 6f20 6c6f 6164 2e0a 0a20 file to load... │ │ │ │ │ -00017980: 2020 2a20 7072 6f67 7265 7373 5f62 6172 * progress_bar │ │ │ │ │ -00017990: 2044 6973 706c 6179 7320 6120 686f 7269 Displays a hori │ │ │ │ │ -000179a0: 7a6f 6e74 616c 6c79 206f 7269 656e 7465 zontally oriente │ │ │ │ │ -000179b0: 6420 7072 6f67 7265 7373 2062 6172 2e20 d progress bar. │ │ │ │ │ -000179c0: 2049 7420 6361 6e0a 2020 2020 2062 6520 It can. be │ │ │ │ │ -000179d0: 7265 6e64 6572 6564 2075 7369 6e67 2073 rendered using s │ │ │ │ │ -000179e0: 696d 706c 6520 736f 6c69 6420 6669 6c6c imple solid fill │ │ │ │ │ -000179f0: 6564 2072 6563 7461 6e67 6c65 732c 206f ed rectangles, o │ │ │ │ │ -00017a00: 7220 7573 696e 6720 6120 7061 6972 0a20 r using a pair. │ │ │ │ │ -00017a10: 2020 2020 6f66 2070 6978 6d61 7020 7374 of pixmap st │ │ │ │ │ -00017a20: 796c 6564 2062 6f78 6573 2e0a 0a20 2020 yled boxes... │ │ │ │ │ -00017a30: 2020 5072 6f70 6572 7469 6573 3a0a 0a20 Properties:.. │ │ │ │ │ -00017a40: 2020 2020 6964 2020 2020 2020 2020 2020 id │ │ │ │ │ -00017a50: 2020 2053 6574 2074 6f20 225f 5f74 696d Set to "__tim │ │ │ │ │ -00017a60: 656f 7574 5f5f 2220 746f 2064 6973 706c eout__" to displ │ │ │ │ │ -00017a70: 6179 2074 6865 2074 696d 6520 656c 6170 ay the time elap │ │ │ │ │ -00017a80: 7365 640a 2020 2020 2020 2020 2020 2020 sed. │ │ │ │ │ -00017a90: 2020 2020 2020 2020 746f 2061 6e20 6175 to an au │ │ │ │ │ -00017aa0: 746f 6d61 7469 6361 6c20 626f 6f74 206f tomatical boot o │ │ │ │ │ -00017ab0: 6620 7468 6520 6465 6661 756c 7420 656e f the default en │ │ │ │ │ -00017ac0: 7472 792e 0a20 2020 2020 6667 5f63 6f6c try.. fg_col │ │ │ │ │ -00017ad0: 6f72 2020 2020 2020 2054 6865 2066 6f72 or The for │ │ │ │ │ -00017ae0: 6567 726f 756e 6420 636f 6c6f 7220 666f eground color fo │ │ │ │ │ -00017af0: 7220 706c 6169 6e20 736f 6c69 6420 636f r plain solid co │ │ │ │ │ -00017b00: 6c6f 720a 2020 2020 2020 2020 2020 2020 lor. │ │ │ │ │ -00017b10: 2020 2020 2020 2020 7265 6e64 6572 696e renderin │ │ │ │ │ -00017b20: 672e 0a20 2020 2020 6267 5f63 6f6c 6f72 g.. bg_color │ │ │ │ │ -00017b30: 2020 2020 2020 2054 6865 2062 6163 6b67 The backg │ │ │ │ │ -00017b40: 726f 756e 6420 636f 6c6f 7220 666f 7220 round color for │ │ │ │ │ -00017b50: 706c 6169 6e20 736f 6c69 6420 636f 6c6f plain solid colo │ │ │ │ │ -00017b60: 720a 2020 2020 2020 2020 2020 2020 2020 r. │ │ │ │ │ -00017b70: 2020 2020 2020 7265 6e64 6572 696e 672e rendering. │ │ │ │ │ -00017b80: 0a20 2020 2020 626f 7264 6572 5f63 6f6c . border_col │ │ │ │ │ -00017b90: 6f72 2020 2054 6865 2062 6f72 6465 7220 or The border │ │ │ │ │ -00017ba0: 636f 6c6f 7220 666f 7220 706c 6169 6e20 color for plain │ │ │ │ │ -00017bb0: 736f 6c69 6420 636f 6c6f 720a 2020 2020 solid color. │ │ │ │ │ -00017bc0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00017bd0: 7265 6e64 6572 696e 672e 0a20 2020 2020 rendering.. │ │ │ │ │ -00017be0: 7465 7874 5f63 6f6c 6f72 2020 2020 2054 text_color T │ │ │ │ │ -00017bf0: 6865 2074 6578 7420 636f 6c6f 722e 0a20 he text color.. │ │ │ │ │ -00017c00: 2020 2020 6261 725f 7374 796c 6520 2020 bar_style │ │ │ │ │ -00017c10: 2020 2054 6865 2073 7479 6c65 6420 626f The styled bo │ │ │ │ │ -00017c20: 7820 7370 6563 6966 6963 6174 696f 6e20 x specification │ │ │ │ │ -00017c30: 666f 7220 7468 6520 6672 616d 6520 6f66 for the frame of │ │ │ │ │ -00017c40: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ -00017c50: 2020 2020 2074 6865 2070 726f 6772 6573 the progres │ │ │ │ │ -00017c60: 7320 6261 722e 2020 4578 616d 706c 653a s bar. Example: │ │ │ │ │ -00017c70: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ -00017c80: 2020 2020 2022 7072 6f67 7265 7373 5f66 "progress_f │ │ │ │ │ -00017c90: 7261 6d65 5f2a 2e70 6e67 2220 4966 2074 rame_*.png" If t │ │ │ │ │ -00017ca0: 6865 2076 616c 7565 2069 7320 6571 7561 he value is equa │ │ │ │ │ -00017cb0: 6c20 746f 0a20 2020 2020 2020 2020 2020 l to. │ │ │ │ │ -00017cc0: 2020 2020 2020 2020 2022 6869 6768 6c69 "highli │ │ │ │ │ -00017cd0: 6768 745f 7374 796c 6522 2074 6865 6e20 ght_style" then │ │ │ │ │ -00017ce0: 6e6f 2073 7479 6c65 6420 626f 7865 7320 no styled boxes │ │ │ │ │ -00017cf0: 7769 6c6c 2062 650a 2020 2020 2020 2020 will be. │ │ │ │ │ -00017d00: 2020 2020 2020 2020 2020 2020 7368 6f77 show │ │ │ │ │ -00017d10: 6e2e 0a20 2020 2020 6869 6768 6c69 6768 n.. highligh │ │ │ │ │ -00017d20: 745f 7374 796c 6554 6865 2073 7479 6c65 t_styleThe style │ │ │ │ │ -00017d30: 6420 626f 7820 7370 6563 6966 6963 6174 d box specificat │ │ │ │ │ -00017d40: 696f 6e20 666f 7220 7468 6520 6869 6768 ion for the high │ │ │ │ │ -00017d50: 6c69 6768 7465 640a 2020 2020 2020 2020 lighted. │ │ │ │ │ -00017d60: 2020 2020 2020 2020 2020 2020 7265 6769 regi │ │ │ │ │ -00017d70: 6f6e 206f 6620 7468 6520 7072 6f67 7265 on of the progre │ │ │ │ │ -00017d80: 7373 2062 6172 2e20 2054 6869 7320 626f ss bar. This bo │ │ │ │ │ -00017d90: 7820 7769 6c6c 2062 650a 2020 2020 2020 x will be. │ │ │ │ │ -00017da0: 2020 2020 2020 2020 2020 2020 2020 7573 us │ │ │ │ │ -00017db0: 6564 2074 6f20 7061 696e 7420 6a75 7374 ed to paint just │ │ │ │ │ -00017dc0: 2074 6865 2068 6967 686c 6967 6874 6564 the highlighted │ │ │ │ │ -00017dd0: 2072 6567 696f 6e20 6f66 2074 6865 0a20 region of the. │ │ │ │ │ +00017700: 2020 2240 4b45 594d 4150 5f53 484f 5254 "@KEYMAP_SHORT │ │ │ │ │ +00017710: 4022 2c20 2240 4b45 594d 4150 5f4d 4944 @", "@KEYMAP_MID │ │ │ │ │ +00017720: 444c 4540 2220 6f72 0a20 2020 2020 2020 DLE@" or. │ │ │ │ │ +00017730: 2020 2020 2020 2020 2020 2020 2022 404b "@K │ │ │ │ │ +00017740: 4559 4d41 505f 4c4f 4e47 4022 2074 6865 EYMAP_LONG@" the │ │ │ │ │ +00017750: 6e20 7072 6564 6566 696e 6564 2068 6f74 n predefined hot │ │ │ │ │ +00017760: 6b65 790a 2020 2020 2020 2020 2020 2020 key. │ │ │ │ │ +00017770: 2020 2020 2020 2020 696e 666f 726d 6174 informat │ │ │ │ │ +00017780: 696f 6e20 7769 6c6c 2062 6520 7368 6f77 ion will be show │ │ │ │ │ +00017790: 6e2e 0a20 2020 2020 666f 6e74 2020 2020 n.. font │ │ │ │ │ +000177a0: 2020 2020 2020 2054 6865 2066 6f6e 7420 The font │ │ │ │ │ +000177b0: 746f 2075 7365 2066 6f72 2074 6578 7420 to use for text │ │ │ │ │ +000177c0: 6469 7370 6c61 792e 0a20 2020 2020 636f display.. co │ │ │ │ │ +000177d0: 6c6f 7220 2020 2020 2020 2020 2054 6865 lor The │ │ │ │ │ +000177e0: 2063 6f6c 6f72 206f 6620 7468 6520 7465 color of the te │ │ │ │ │ +000177f0: 7874 2e0a 2020 2020 2061 6c69 676e 2020 xt.. align │ │ │ │ │ +00017800: 2020 2020 2020 2020 5468 6520 686f 7269 The hori │ │ │ │ │ +00017810: 7a6f 6e74 616c 2061 6c69 676e 6d65 6e74 zontal alignment │ │ │ │ │ +00017820: 206f 6620 7468 6520 7465 7874 2077 6974 of the text wit │ │ │ │ │ +00017830: 6869 6e20 7468 650a 2020 2020 2020 2020 hin the. │ │ │ │ │ +00017840: 2020 2020 2020 2020 2020 2020 636f 6d70 comp │ │ │ │ │ +00017850: 6f6e 656e 742e 2020 4f70 7469 6f6e 7320 onent. Options │ │ │ │ │ +00017860: 6172 6520 226c 6566 7422 2c20 2263 656e are "left", "cen │ │ │ │ │ +00017870: 7465 7222 2061 6e64 0a20 2020 2020 2020 ter" and. │ │ │ │ │ +00017880: 2020 2020 2020 2020 2020 2020 2022 7269 "ri │ │ │ │ │ +00017890: 6768 7422 2e0a 2020 2020 2076 6973 6962 ght".. visib │ │ │ │ │ +000178a0: 6c65 2020 2020 2020 2020 5365 7420 746f le Set to │ │ │ │ │ +000178b0: 2022 6661 6c73 6522 2074 6f20 6869 6465 "false" to hide │ │ │ │ │ +000178c0: 2074 6865 206c 6162 656c 2e0a 0a20 2020 the label... │ │ │ │ │ +000178d0: 2a20 696d 6167 6520 4120 636f 6d70 6f6e * image A compon │ │ │ │ │ +000178e0: 656e 7420 7468 6174 2064 6973 706c 6179 ent that display │ │ │ │ │ +000178f0: 7320 616e 2069 6d61 6765 2e20 2054 6865 s an image. The │ │ │ │ │ +00017900: 2069 6d61 6765 2069 7320 7363 616c 6564 image is scaled │ │ │ │ │ +00017910: 2074 6f0a 2020 2020 2066 6974 2074 6865 to. fit the │ │ │ │ │ +00017920: 2063 6f6d 706f 6e65 6e74 2e0a 0a20 2020 component... │ │ │ │ │ +00017930: 2020 5072 6f70 6572 7469 6573 3a0a 0a20 Properties:.. │ │ │ │ │ +00017940: 2020 2020 6669 6c65 2020 2020 2020 2020 file │ │ │ │ │ +00017950: 2020 2054 6865 2066 756c 6c20 7061 7468 The full path │ │ │ │ │ +00017960: 2074 6f20 7468 6520 696d 6167 6520 6669 to the image fi │ │ │ │ │ +00017970: 6c65 2074 6f20 6c6f 6164 2e0a 0a20 2020 le to load... │ │ │ │ │ +00017980: 2a20 7072 6f67 7265 7373 5f62 6172 2044 * progress_bar D │ │ │ │ │ +00017990: 6973 706c 6179 7320 6120 686f 7269 7a6f isplays a horizo │ │ │ │ │ +000179a0: 6e74 616c 6c79 206f 7269 656e 7465 6420 ntally oriented │ │ │ │ │ +000179b0: 7072 6f67 7265 7373 2062 6172 2e20 2049 progress bar. I │ │ │ │ │ +000179c0: 7420 6361 6e0a 2020 2020 2062 6520 7265 t can. be re │ │ │ │ │ +000179d0: 6e64 6572 6564 2075 7369 6e67 2073 696d ndered using sim │ │ │ │ │ +000179e0: 706c 6520 736f 6c69 6420 6669 6c6c 6564 ple solid filled │ │ │ │ │ +000179f0: 2072 6563 7461 6e67 6c65 732c 206f 7220 rectangles, or │ │ │ │ │ +00017a00: 7573 696e 6720 6120 7061 6972 0a20 2020 using a pair. │ │ │ │ │ +00017a10: 2020 6f66 2070 6978 6d61 7020 7374 796c of pixmap styl │ │ │ │ │ +00017a20: 6564 2062 6f78 6573 2e0a 0a20 2020 2020 ed boxes... │ │ │ │ │ +00017a30: 5072 6f70 6572 7469 6573 3a0a 0a20 2020 Properties:.. │ │ │ │ │ +00017a40: 2020 6964 2020 2020 2020 2020 2020 2020 id │ │ │ │ │ +00017a50: 2053 6574 2074 6f20 225f 5f74 696d 656f Set to "__timeo │ │ │ │ │ +00017a60: 7574 5f5f 2220 746f 2064 6973 706c 6179 ut__" to display │ │ │ │ │ +00017a70: 2074 6865 2074 696d 6520 656c 6170 7365 the time elapse │ │ │ │ │ +00017a80: 640a 2020 2020 2020 2020 2020 2020 2020 d. │ │ │ │ │ +00017a90: 2020 2020 2020 746f 2061 6e20 6175 746f to an auto │ │ │ │ │ +00017aa0: 6d61 7469 6361 6c20 626f 6f74 206f 6620 matical boot of │ │ │ │ │ +00017ab0: 7468 6520 6465 6661 756c 7420 656e 7472 the default entr │ │ │ │ │ +00017ac0: 792e 0a20 2020 2020 6667 5f63 6f6c 6f72 y.. fg_color │ │ │ │ │ +00017ad0: 2020 2020 2020 2054 6865 2066 6f72 6567 The foreg │ │ │ │ │ +00017ae0: 726f 756e 6420 636f 6c6f 7220 666f 7220 round color for │ │ │ │ │ +00017af0: 706c 6169 6e20 736f 6c69 6420 636f 6c6f plain solid colo │ │ │ │ │ +00017b00: 720a 2020 2020 2020 2020 2020 2020 2020 r. │ │ │ │ │ +00017b10: 2020 2020 2020 7265 6e64 6572 696e 672e rendering. │ │ │ │ │ +00017b20: 0a20 2020 2020 6267 5f63 6f6c 6f72 2020 . bg_color │ │ │ │ │ +00017b30: 2020 2020 2054 6865 2062 6163 6b67 726f The backgro │ │ │ │ │ +00017b40: 756e 6420 636f 6c6f 7220 666f 7220 706c und color for pl │ │ │ │ │ +00017b50: 6169 6e20 736f 6c69 6420 636f 6c6f 720a ain solid color. │ │ │ │ │ +00017b60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00017b70: 2020 2020 7265 6e64 6572 696e 672e 0a20 rendering.. │ │ │ │ │ +00017b80: 2020 2020 626f 7264 6572 5f63 6f6c 6f72 border_color │ │ │ │ │ +00017b90: 2020 2054 6865 2062 6f72 6465 7220 636f The border co │ │ │ │ │ +00017ba0: 6c6f 7220 666f 7220 706c 6169 6e20 736f lor for plain so │ │ │ │ │ +00017bb0: 6c69 6420 636f 6c6f 720a 2020 2020 2020 lid color. │ │ │ │ │ +00017bc0: 2020 2020 2020 2020 2020 2020 2020 7265 re │ │ │ │ │ +00017bd0: 6e64 6572 696e 672e 0a20 2020 2020 7465 ndering.. te │ │ │ │ │ +00017be0: 7874 5f63 6f6c 6f72 2020 2020 2054 6865 xt_color The │ │ │ │ │ +00017bf0: 2074 6578 7420 636f 6c6f 722e 0a20 2020 text color.. │ │ │ │ │ +00017c00: 2020 6261 725f 7374 796c 6520 2020 2020 bar_style │ │ │ │ │ +00017c10: 2054 6865 2073 7479 6c65 6420 626f 7820 The styled box │ │ │ │ │ +00017c20: 7370 6563 6966 6963 6174 696f 6e20 666f specification fo │ │ │ │ │ +00017c30: 7220 7468 6520 6672 616d 6520 6f66 0a20 r the frame of. │ │ │ │ │ +00017c40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00017c50: 2020 2074 6865 2070 726f 6772 6573 7320 the progress │ │ │ │ │ +00017c60: 6261 722e 2020 4578 616d 706c 653a 0a20 bar. Example:. │ │ │ │ │ +00017c70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00017c80: 2020 2022 7072 6f67 7265 7373 5f66 7261 "progress_fra │ │ │ │ │ +00017c90: 6d65 5f2a 2e70 6e67 2220 4966 2074 6865 me_*.png" If the │ │ │ │ │ +00017ca0: 2076 616c 7565 2069 7320 6571 7561 6c20 value is equal │ │ │ │ │ +00017cb0: 746f 0a20 2020 2020 2020 2020 2020 2020 to. │ │ │ │ │ +00017cc0: 2020 2020 2020 2022 6869 6768 6c69 6768 "highligh │ │ │ │ │ +00017cd0: 745f 7374 796c 6522 2074 6865 6e20 6e6f t_style" then no │ │ │ │ │ +00017ce0: 2073 7479 6c65 6420 626f 7865 7320 7769 styled boxes wi │ │ │ │ │ +00017cf0: 6c6c 2062 650a 2020 2020 2020 2020 2020 ll be. │ │ │ │ │ +00017d00: 2020 2020 2020 2020 2020 7368 6f77 6e2e shown. │ │ │ │ │ +00017d10: 0a20 2020 2020 6869 6768 6c69 6768 745f . highlight_ │ │ │ │ │ +00017d20: 7374 796c 6554 6865 2073 7479 6c65 6420 styleThe styled │ │ │ │ │ +00017d30: 626f 7820 7370 6563 6966 6963 6174 696f box specificatio │ │ │ │ │ +00017d40: 6e20 666f 7220 7468 6520 6869 6768 6c69 n for the highli │ │ │ │ │ +00017d50: 6768 7465 640a 2020 2020 2020 2020 2020 ghted. │ │ │ │ │ +00017d60: 2020 2020 2020 2020 2020 7265 6769 6f6e region │ │ │ │ │ +00017d70: 206f 6620 7468 6520 7072 6f67 7265 7373 of the progress │ │ │ │ │ +00017d80: 2062 6172 2e20 2054 6869 7320 626f 7820 bar. This box │ │ │ │ │ +00017d90: 7769 6c6c 2062 650a 2020 2020 2020 2020 will be. │ │ │ │ │ +00017da0: 2020 2020 2020 2020 2020 2020 7573 6564 used │ │ │ │ │ +00017db0: 2074 6f20 7061 696e 7420 6a75 7374 2074 to paint just t │ │ │ │ │ +00017dc0: 6865 2068 6967 686c 6967 6874 6564 2072 he highlighted r │ │ │ │ │ +00017dd0: 6567 696f 6e20 6f66 2074 6865 0a20 2020 egion of the. │ │ │ │ │ 00017de0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00017df0: 2020 2062 6172 2c20 616e 6420 7769 6c6c bar, and will │ │ │ │ │ -00017e00: 2062 6520 696e 6372 6561 7365 6420 696e be increased in │ │ │ │ │ -00017e10: 2073 697a 6520 6173 2074 6865 2062 6172 size as the bar │ │ │ │ │ -00017e20: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ -00017e30: 2020 2020 206e 6561 7273 2063 6f6d 706c nears compl │ │ │ │ │ -00017e40: 6574 696f 6e2e 2020 4578 616d 706c 653a etion. Example: │ │ │ │ │ -00017e50: 2022 7072 6f67 7265 7373 5f68 6c5f 2a2e "progress_hl_*. │ │ │ │ │ -00017e60: 706e 6722 2e0a 2020 2020 2020 2020 2020 png".. │ │ │ │ │ -00017e70: 2020 2020 2020 2020 2020 4966 2074 6865 If the │ │ │ │ │ -00017e80: 2076 616c 7565 2069 7320 6571 7561 6c20 value is equal │ │ │ │ │ -00017e90: 746f 2022 6261 725f 7374 796c 6522 2074 to "bar_style" t │ │ │ │ │ -00017ea0: 6865 6e20 6e6f 0a20 2020 2020 2020 2020 hen no. │ │ │ │ │ -00017eb0: 2020 2020 2020 2020 2020 2073 7479 6c65 style │ │ │ │ │ -00017ec0: 6420 626f 7865 7320 7769 6c6c 2062 6520 d boxes will be │ │ │ │ │ -00017ed0: 7368 6f77 6e2e 0a20 2020 2020 6869 6768 shown.. high │ │ │ │ │ -00017ee0: 6c69 6768 745f 6f76 6572 6c61 7949 6620 light_overlayIf │ │ │ │ │ -00017ef0: 7468 6973 206f 7074 696f 6e20 6973 2073 this option is s │ │ │ │ │ -00017f00: 6574 2074 6f20 2274 7275 6522 2074 6865 et to "true" the │ │ │ │ │ -00017f10: 6e20 7468 650a 2020 2020 2020 2020 2020 n the. │ │ │ │ │ -00017f20: 2020 2020 2020 2020 2020 6869 6768 6c69 highli │ │ │ │ │ -00017f30: 6768 7420 626f 7820 7369 6465 2073 6c69 ght box side sli │ │ │ │ │ -00017f40: 6365 7320 2865 7665 7279 2073 6c69 6365 ces (every slice │ │ │ │ │ -00017f50: 2065 7863 6570 740a 2020 2020 2020 2020 except. │ │ │ │ │ -00017f60: 2020 2020 2020 2020 2020 2020 7468 6520 the │ │ │ │ │ -00017f70: 6365 6e74 6572 2073 6c69 6365 2920 7769 center slice) wi │ │ │ │ │ -00017f80: 6c6c 206f 7665 726c 6179 2074 6865 2066 ll overlay the f │ │ │ │ │ -00017f90: 7261 6d65 2062 6f78 0a20 2020 2020 2020 rame box. │ │ │ │ │ -00017fa0: 2020 2020 2020 2020 2020 2020 2073 6964 sid │ │ │ │ │ -00017fb0: 6520 736c 6963 6573 2e20 2041 6e64 2074 e slices. And t │ │ │ │ │ -00017fc0: 6865 2063 656e 7465 7220 736c 6963 6520 he center slice │ │ │ │ │ -00017fd0: 6f66 2074 6865 0a20 2020 2020 2020 2020 of the. │ │ │ │ │ -00017fe0: 2020 2020 2020 2020 2020 2068 6967 686c highl │ │ │ │ │ -00017ff0: 6967 6874 2062 6f78 2063 616e 206d 6f76 ight box can mov │ │ │ │ │ -00018000: 6520 616c 6c20 7468 6520 7761 7920 2866 e all the way (f │ │ │ │ │ -00018010: 726f 6d20 746f 7020 746f 0a20 2020 2020 rom top to. │ │ │ │ │ -00018020: 2020 2020 2020 2020 2020 2020 2020 2062 b │ │ │ │ │ -00018030: 6f74 746f 6d29 2c20 6265 696e 6720 6472 ottom), being dr │ │ │ │ │ -00018040: 6177 6e20 6f6e 2074 6865 2063 656e 7465 awn on the cente │ │ │ │ │ -00018050: 7220 736c 6963 6520 6f66 2074 6865 0a20 r slice of the. │ │ │ │ │ +00017df0: 2062 6172 2c20 616e 6420 7769 6c6c 2062 bar, and will b │ │ │ │ │ +00017e00: 6520 696e 6372 6561 7365 6420 696e 2073 e increased in s │ │ │ │ │ +00017e10: 697a 6520 6173 2074 6865 2062 6172 0a20 ize as the bar. │ │ │ │ │ +00017e20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00017e30: 2020 206e 6561 7273 2063 6f6d 706c 6574 nears complet │ │ │ │ │ +00017e40: 696f 6e2e 2020 4578 616d 706c 653a 2022 ion. Example: " │ │ │ │ │ +00017e50: 7072 6f67 7265 7373 5f68 6c5f 2a2e 706e progress_hl_*.pn │ │ │ │ │ +00017e60: 6722 2e0a 2020 2020 2020 2020 2020 2020 g".. │ │ │ │ │ +00017e70: 2020 2020 2020 2020 4966 2074 6865 2076 If the v │ │ │ │ │ +00017e80: 616c 7565 2069 7320 6571 7561 6c20 746f alue is equal to │ │ │ │ │ +00017e90: 2022 6261 725f 7374 796c 6522 2074 6865 "bar_style" the │ │ │ │ │ +00017ea0: 6e20 6e6f 0a20 2020 2020 2020 2020 2020 n no. │ │ │ │ │ +00017eb0: 2020 2020 2020 2020 2073 7479 6c65 6420 styled │ │ │ │ │ +00017ec0: 626f 7865 7320 7769 6c6c 2062 6520 7368 boxes will be sh │ │ │ │ │ +00017ed0: 6f77 6e2e 0a20 2020 2020 6869 6768 6c69 own.. highli │ │ │ │ │ +00017ee0: 6768 745f 6f76 6572 6c61 7949 6620 7468 ght_overlayIf th │ │ │ │ │ +00017ef0: 6973 206f 7074 696f 6e20 6973 2073 6574 is option is set │ │ │ │ │ +00017f00: 2074 6f20 2274 7275 6522 2074 6865 6e20 to "true" then │ │ │ │ │ +00017f10: 7468 650a 2020 2020 2020 2020 2020 2020 the. │ │ │ │ │ +00017f20: 2020 2020 2020 2020 6869 6768 6c69 6768 highligh │ │ │ │ │ +00017f30: 7420 626f 7820 7369 6465 2073 6c69 6365 t box side slice │ │ │ │ │ +00017f40: 7320 2865 7665 7279 2073 6c69 6365 2065 s (every slice e │ │ │ │ │ +00017f50: 7863 6570 740a 2020 2020 2020 2020 2020 xcept. │ │ │ │ │ +00017f60: 2020 2020 2020 2020 2020 7468 6520 6365 the ce │ │ │ │ │ +00017f70: 6e74 6572 2073 6c69 6365 2920 7769 6c6c nter slice) will │ │ │ │ │ +00017f80: 206f 7665 726c 6179 2074 6865 2066 7261 overlay the fra │ │ │ │ │ +00017f90: 6d65 2062 6f78 0a20 2020 2020 2020 2020 me box. │ │ │ │ │ +00017fa0: 2020 2020 2020 2020 2020 2073 6964 6520 side │ │ │ │ │ +00017fb0: 736c 6963 6573 2e20 2041 6e64 2074 6865 slices. And the │ │ │ │ │ +00017fc0: 2063 656e 7465 7220 736c 6963 6520 6f66 center slice of │ │ │ │ │ +00017fd0: 2074 6865 0a20 2020 2020 2020 2020 2020 the. │ │ │ │ │ +00017fe0: 2020 2020 2020 2020 2068 6967 686c 6967 highlig │ │ │ │ │ +00017ff0: 6874 2062 6f78 2063 616e 206d 6f76 6520 ht box can move │ │ │ │ │ +00018000: 616c 6c20 7468 6520 7761 7920 2866 726f all the way (fro │ │ │ │ │ +00018010: 6d20 746f 7020 746f 0a20 2020 2020 2020 m top to. │ │ │ │ │ +00018020: 2020 2020 2020 2020 2020 2020 2062 6f74 bot │ │ │ │ │ +00018030: 746f 6d29 2c20 6265 696e 6720 6472 6177 tom), being draw │ │ │ │ │ +00018040: 6e20 6f6e 2074 6865 2063 656e 7465 7220 n on the center │ │ │ │ │ +00018050: 736c 6963 6520 6f66 2074 6865 0a20 2020 slice of the. │ │ │ │ │ 00018060: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018070: 2020 2066 7261 6d65 2062 6f78 2e20 2054 frame box. T │ │ │ │ │ -00018080: 6861 7420 7761 7920 7765 2063 616e 206d hat way we can m │ │ │ │ │ -00018090: 616b 6520 6120 7072 6f67 7265 7373 2062 ake a progress b │ │ │ │ │ -000180a0: 6172 0a20 2020 2020 2020 2020 2020 2020 ar. │ │ │ │ │ -000180b0: 2020 2020 2020 2077 6974 6820 726f 756e with roun │ │ │ │ │ -000180c0: 642d 7368 6170 6564 2065 6467 6573 2073 d-shaped edges s │ │ │ │ │ -000180d0: 6f20 7468 6572 6520 776f 6e27 7420 6265 o there won't be │ │ │ │ │ -000180e0: 2061 2066 7265 650a 2020 2020 2020 2020 a free. │ │ │ │ │ -000180f0: 2020 2020 2020 2020 2020 2020 7370 6163 spac │ │ │ │ │ -00018100: 6520 6672 6f6d 2074 6865 2068 6967 686c e from the highl │ │ │ │ │ -00018110: 6967 6874 2074 6f20 7468 6520 6672 616d ight to the fram │ │ │ │ │ -00018120: 6520 696e 2074 6f70 2061 6e64 0a20 2020 e in top and. │ │ │ │ │ -00018130: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018140: 2062 6f74 746f 6d20 7363 726f 6c6c 6261 bottom scrollba │ │ │ │ │ -00018150: 7220 706f 7369 7469 6f6e 732e 2020 4465 r positions. De │ │ │ │ │ -00018160: 6661 756c 7420 6973 2022 6661 6c73 6522 fault is "false" │ │ │ │ │ -00018170: 2e0a 2020 2020 2066 6f6e 7420 2020 2020 .. font │ │ │ │ │ -00018180: 2020 2020 2020 5468 6520 666f 6e74 2074 The font t │ │ │ │ │ -00018190: 6f20 7573 6520 666f 7220 7072 6f67 7265 o use for progre │ │ │ │ │ -000181a0: 7373 2062 6172 2e0a 2020 2020 2074 6578 ss bar.. tex │ │ │ │ │ -000181b0: 7420 2020 2020 2020 2020 2020 5468 6520 t The │ │ │ │ │ -000181c0: 7465 7874 2074 6f20 6469 7370 6c61 7920 text to display │ │ │ │ │ -000181d0: 6f6e 2074 6865 2070 726f 6772 6573 7320 on the progress │ │ │ │ │ -000181e0: 6261 722e 2020 4966 2074 6865 0a20 2020 bar. If the. │ │ │ │ │ -000181f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018200: 2070 726f 6772 6573 7320 6261 7227 7320 progress bar's │ │ │ │ │ -00018210: 4944 2069 7320 7365 7420 746f 2022 5f5f ID is set to "__ │ │ │ │ │ -00018220: 7469 6d65 6f75 745f 5f22 2061 6e64 0a20 timeout__" and. │ │ │ │ │ +00018070: 2066 7261 6d65 2062 6f78 2e20 2054 6861 frame box. Tha │ │ │ │ │ +00018080: 7420 7761 7920 7765 2063 616e 206d 616b t way we can mak │ │ │ │ │ +00018090: 6520 6120 7072 6f67 7265 7373 2062 6172 e a progress bar │ │ │ │ │ +000180a0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +000180b0: 2020 2020 2077 6974 6820 726f 756e 642d with round- │ │ │ │ │ +000180c0: 7368 6170 6564 2065 6467 6573 2073 6f20 shaped edges so │ │ │ │ │ +000180d0: 7468 6572 6520 776f 6e27 7420 6265 2061 there won't be a │ │ │ │ │ +000180e0: 2066 7265 650a 2020 2020 2020 2020 2020 free. │ │ │ │ │ +000180f0: 2020 2020 2020 2020 2020 7370 6163 6520 space │ │ │ │ │ +00018100: 6672 6f6d 2074 6865 2068 6967 686c 6967 from the highlig │ │ │ │ │ +00018110: 6874 2074 6f20 7468 6520 6672 616d 6520 ht to the frame │ │ │ │ │ +00018120: 696e 2074 6f70 2061 6e64 0a20 2020 2020 in top and. │ │ │ │ │ +00018130: 2020 2020 2020 2020 2020 2020 2020 2062 b │ │ │ │ │ +00018140: 6f74 746f 6d20 7363 726f 6c6c 6261 7220 ottom scrollbar │ │ │ │ │ +00018150: 706f 7369 7469 6f6e 732e 2020 4465 6661 positions. Defa │ │ │ │ │ +00018160: 756c 7420 6973 2022 6661 6c73 6522 2e0a ult is "false".. │ │ │ │ │ +00018170: 2020 2020 2066 6f6e 7420 2020 2020 2020 font │ │ │ │ │ +00018180: 2020 2020 5468 6520 666f 6e74 2074 6f20 The font to │ │ │ │ │ +00018190: 7573 6520 666f 7220 7072 6f67 7265 7373 use for progress │ │ │ │ │ +000181a0: 2062 6172 2e0a 2020 2020 2074 6578 7420 bar.. text │ │ │ │ │ +000181b0: 2020 2020 2020 2020 2020 5468 6520 7465 The te │ │ │ │ │ +000181c0: 7874 2074 6f20 6469 7370 6c61 7920 6f6e xt to display on │ │ │ │ │ +000181d0: 2074 6865 2070 726f 6772 6573 7320 6261 the progress ba │ │ │ │ │ +000181e0: 722e 2020 4966 2074 6865 0a20 2020 2020 r. If the. │ │ │ │ │ +000181f0: 2020 2020 2020 2020 2020 2020 2020 2070 p │ │ │ │ │ +00018200: 726f 6772 6573 7320 6261 7227 7320 4944 rogress bar's ID │ │ │ │ │ +00018210: 2069 7320 7365 7420 746f 2022 5f5f 7469 is set to "__ti │ │ │ │ │ +00018220: 6d65 6f75 745f 5f22 2061 6e64 0a20 2020 meout__" and. │ │ │ │ │ 00018230: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018240: 2020 2074 6865 2076 616c 7565 206f 6620 the value of │ │ │ │ │ -00018250: 7468 6973 2070 726f 7065 7274 7920 6973 this property is │ │ │ │ │ -00018260: 2073 6574 2074 6f0a 2020 2020 2020 2020 set to. │ │ │ │ │ -00018270: 2020 2020 2020 2020 2020 2020 2240 5449 "@TI │ │ │ │ │ -00018280: 4d45 4f55 545f 4e4f 5449 4649 4341 5449 MEOUT_NOTIFICATI │ │ │ │ │ -00018290: 4f4e 5f53 484f 5254 4022 2c0a 2020 2020 ON_SHORT@",. │ │ │ │ │ -000182a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000182b0: 2240 5449 4d45 4f55 545f 4e4f 5449 4649 "@TIMEOUT_NOTIFI │ │ │ │ │ -000182c0: 4341 5449 4f4e 5f4d 4944 444c 4540 2220 CATION_MIDDLE@" │ │ │ │ │ -000182d0: 6f72 0a20 2020 2020 2020 2020 2020 2020 or. │ │ │ │ │ -000182e0: 2020 2020 2020 2022 4054 494d 454f 5554 "@TIMEOUT │ │ │ │ │ -000182f0: 5f4e 4f54 4946 4943 4154 494f 4e5f 4c4f _NOTIFICATION_LO │ │ │ │ │ -00018300: 4e47 4022 2c20 7468 656e 2047 5255 4220 NG@", then GRUB │ │ │ │ │ -00018310: 7769 6c6c 0a20 2020 2020 2020 2020 2020 will. │ │ │ │ │ -00018320: 2020 2020 2020 2020 2075 7064 6174 6520 update │ │ │ │ │ -00018330: 7468 6973 2070 726f 7065 7274 7920 7769 this property wi │ │ │ │ │ -00018340: 7468 2061 6e20 696e 666f 726d 6174 6976 th an informativ │ │ │ │ │ -00018350: 6520 6d65 7373 6167 650a 2020 2020 2020 e message. │ │ │ │ │ -00018360: 2020 2020 2020 2020 2020 2020 2020 6173 as │ │ │ │ │ -00018370: 2074 6865 2074 696d 656f 7574 2061 7070 the timeout app │ │ │ │ │ -00018380: 726f 6163 6865 732e 0a0a 2020 202a 2063 roaches... * c │ │ │ │ │ -00018390: 6972 6375 6c61 725f 7072 6f67 7265 7373 ircular_progress │ │ │ │ │ -000183a0: 2044 6973 706c 6179 7320 6120 6369 7263 Displays a circ │ │ │ │ │ -000183b0: 756c 6172 2070 726f 6772 6573 7320 696e ular progress in │ │ │ │ │ -000183c0: 6469 6361 746f 722e 2020 5468 650a 2020 dicator. The. │ │ │ │ │ -000183d0: 2020 2061 7070 6561 7261 6e63 6520 6f66 appearance of │ │ │ │ │ -000183e0: 2074 6869 7320 636f 6d70 6f6e 656e 7420 this component │ │ │ │ │ -000183f0: 6973 2064 6574 6572 6d69 6e65 6420 6279 is determined by │ │ │ │ │ -00018400: 2074 776f 2069 6d61 6765 733a 2074 6865 two images: the │ │ │ │ │ -00018410: 0a20 2020 2020 2a63 656e 7465 722a 2069 . *center* i │ │ │ │ │ -00018420: 6d61 6765 2061 6e64 2074 6865 202a 7469 mage and the *ti │ │ │ │ │ -00018430: 636b 2a20 696d 6167 652e 2020 5468 6520 ck* image. The │ │ │ │ │ -00018440: 6365 6e74 6572 2069 6d61 6765 2069 7320 center image is │ │ │ │ │ -00018450: 6765 6e65 7261 6c6c 790a 2020 2020 206c generally. l │ │ │ │ │ -00018460: 6172 6765 7220 616e 6420 7769 6c6c 2062 arger and will b │ │ │ │ │ -00018470: 6520 6472 6177 6e20 696e 2074 6865 2063 e drawn in the c │ │ │ │ │ -00018480: 656e 7465 7220 6f66 2074 6865 2063 6f6d enter of the com │ │ │ │ │ -00018490: 706f 6e65 6e74 2e20 2041 726f 756e 640a ponent. Around. │ │ │ │ │ -000184a0: 2020 2020 2074 6865 2063 6972 6375 6d66 the circumf │ │ │ │ │ -000184b0: 6572 656e 6365 206f 6620 6120 6369 7263 erence of a circ │ │ │ │ │ -000184c0: 6c65 2077 6974 6869 6e20 7468 6520 636f le within the co │ │ │ │ │ -000184d0: 6d70 6f6e 656e 742c 2074 6865 2074 6963 mponent, the tic │ │ │ │ │ -000184e0: 6b20 696d 6167 650a 2020 2020 2077 696c k image. wil │ │ │ │ │ -000184f0: 6c20 6265 2064 7261 776e 2061 2063 6572 l be drawn a cer │ │ │ │ │ -00018500: 7461 696e 206e 756d 6265 7220 6f66 2074 tain number of t │ │ │ │ │ -00018510: 696d 6573 2c20 6465 7065 6e64 696e 6720 imes, depending │ │ │ │ │ -00018520: 6f6e 2074 6865 0a20 2020 2020 7072 6f70 on the. prop │ │ │ │ │ -00018530: 6572 7469 6573 206f 6620 7468 6520 636f erties of the co │ │ │ │ │ -00018540: 6d70 6f6e 656e 742e 0a0a 2020 2020 2050 mponent... P │ │ │ │ │ -00018550: 726f 7065 7274 6965 733a 0a0a 2020 2020 roperties:.. │ │ │ │ │ -00018560: 2069 6420 2020 2020 2020 2020 2020 2020 id │ │ │ │ │ -00018570: 2020 2020 2020 2020 5365 7420 746f 2022 Set to " │ │ │ │ │ -00018580: 5f5f 7469 6d65 6f75 745f 5f22 2074 6f20 __timeout__" to │ │ │ │ │ -00018590: 6469 7370 6c61 7920 7468 6520 7469 6d65 display the time │ │ │ │ │ -000185a0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ -000185b0: 2020 2020 2020 2020 2020 2020 2065 6c61 ela │ │ │ │ │ -000185c0: 7073 6564 2074 6f20 616e 2061 7574 6f6d psed to an autom │ │ │ │ │ -000185d0: 6174 6963 616c 2062 6f6f 7420 6f66 2074 atical boot of t │ │ │ │ │ -000185e0: 6865 0a20 2020 2020 2020 2020 2020 2020 he. │ │ │ │ │ -000185f0: 2020 2020 2020 2020 2020 2020 2020 2064 d │ │ │ │ │ -00018600: 6566 6175 6c74 2065 6e74 7279 2e0a 2020 efault entry.. │ │ │ │ │ -00018610: 2020 2063 656e 7465 725f 6269 746d 6170 center_bitmap │ │ │ │ │ -00018620: 2020 2020 2020 2020 2020 5468 6520 6669 The fi │ │ │ │ │ -00018630: 6c65 206e 616d 6520 6f66 2074 6865 2069 le name of the i │ │ │ │ │ -00018640: 6d61 6765 2074 6f20 6472 6177 2069 6e20 mage to draw in │ │ │ │ │ -00018650: 7468 650a 2020 2020 2020 2020 2020 2020 the. │ │ │ │ │ -00018660: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018670: 6365 6e74 6572 206f 6620 7468 6520 636f center of the co │ │ │ │ │ -00018680: 6d70 6f6e 656e 742e 0a20 2020 2020 7469 mponent.. ti │ │ │ │ │ -00018690: 636b 5f62 6974 6d61 7020 2020 2020 2020 ck_bitmap │ │ │ │ │ -000186a0: 2020 2020 2054 6865 2066 696c 6520 6e61 The file na │ │ │ │ │ -000186b0: 6d65 206f 6620 7468 6520 696d 6167 6520 me of the image │ │ │ │ │ -000186c0: 746f 2064 7261 7720 666f 720a 2020 2020 to draw for. │ │ │ │ │ +00018240: 2074 6865 2076 616c 7565 206f 6620 7468 the value of th │ │ │ │ │ +00018250: 6973 2070 726f 7065 7274 7920 6973 2073 is property is s │ │ │ │ │ +00018260: 6574 2074 6f0a 2020 2020 2020 2020 2020 et to. │ │ │ │ │ +00018270: 2020 2020 2020 2020 2020 2240 5449 4d45 "@TIME │ │ │ │ │ +00018280: 4f55 545f 4e4f 5449 4649 4341 5449 4f4e OUT_NOTIFICATION │ │ │ │ │ +00018290: 5f53 484f 5254 4022 2c0a 2020 2020 2020 _SHORT@",. │ │ │ │ │ +000182a0: 2020 2020 2020 2020 2020 2020 2020 2240 "@ │ │ │ │ │ +000182b0: 5449 4d45 4f55 545f 4e4f 5449 4649 4341 TIMEOUT_NOTIFICA │ │ │ │ │ +000182c0: 5449 4f4e 5f4d 4944 444c 4540 2220 6f72 TION_MIDDLE@" or │ │ │ │ │ +000182d0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +000182e0: 2020 2020 2022 4054 494d 454f 5554 5f4e "@TIMEOUT_N │ │ │ │ │ +000182f0: 4f54 4946 4943 4154 494f 4e5f 4c4f 4e47 OTIFICATION_LONG │ │ │ │ │ +00018300: 4022 2c20 7468 656e 2047 5255 4220 7769 @", then GRUB wi │ │ │ │ │ +00018310: 6c6c 0a20 2020 2020 2020 2020 2020 2020 ll. │ │ │ │ │ +00018320: 2020 2020 2020 2075 7064 6174 6520 7468 update th │ │ │ │ │ +00018330: 6973 2070 726f 7065 7274 7920 7769 7468 is property with │ │ │ │ │ +00018340: 2061 6e20 696e 666f 726d 6174 6976 6520 an informative │ │ │ │ │ +00018350: 6d65 7373 6167 650a 2020 2020 2020 2020 message. │ │ │ │ │ +00018360: 2020 2020 2020 2020 2020 2020 6173 2074 as t │ │ │ │ │ +00018370: 6865 2074 696d 656f 7574 2061 7070 726f he timeout appro │ │ │ │ │ +00018380: 6163 6865 732e 0a0a 2020 202a 2063 6972 aches... * cir │ │ │ │ │ +00018390: 6375 6c61 725f 7072 6f67 7265 7373 2044 cular_progress D │ │ │ │ │ +000183a0: 6973 706c 6179 7320 6120 6369 7263 756c isplays a circul │ │ │ │ │ +000183b0: 6172 2070 726f 6772 6573 7320 696e 6469 ar progress indi │ │ │ │ │ +000183c0: 6361 746f 722e 2020 5468 650a 2020 2020 cator. The. │ │ │ │ │ +000183d0: 2061 7070 6561 7261 6e63 6520 6f66 2074 appearance of t │ │ │ │ │ +000183e0: 6869 7320 636f 6d70 6f6e 656e 7420 6973 his component is │ │ │ │ │ +000183f0: 2064 6574 6572 6d69 6e65 6420 6279 2074 determined by t │ │ │ │ │ +00018400: 776f 2069 6d61 6765 733a 2074 6865 0a20 wo images: the. │ │ │ │ │ +00018410: 2020 2020 2a63 656e 7465 722a 2069 6d61 *center* ima │ │ │ │ │ +00018420: 6765 2061 6e64 2074 6865 202a 7469 636b ge and the *tick │ │ │ │ │ +00018430: 2a20 696d 6167 652e 2020 5468 6520 6365 * image. The ce │ │ │ │ │ +00018440: 6e74 6572 2069 6d61 6765 2069 7320 6765 nter image is ge │ │ │ │ │ +00018450: 6e65 7261 6c6c 790a 2020 2020 206c 6172 nerally. lar │ │ │ │ │ +00018460: 6765 7220 616e 6420 7769 6c6c 2062 6520 ger and will be │ │ │ │ │ +00018470: 6472 6177 6e20 696e 2074 6865 2063 656e drawn in the cen │ │ │ │ │ +00018480: 7465 7220 6f66 2074 6865 2063 6f6d 706f ter of the compo │ │ │ │ │ +00018490: 6e65 6e74 2e20 2041 726f 756e 640a 2020 nent. Around. │ │ │ │ │ +000184a0: 2020 2074 6865 2063 6972 6375 6d66 6572 the circumfer │ │ │ │ │ +000184b0: 656e 6365 206f 6620 6120 6369 7263 6c65 ence of a circle │ │ │ │ │ +000184c0: 2077 6974 6869 6e20 7468 6520 636f 6d70 within the comp │ │ │ │ │ +000184d0: 6f6e 656e 742c 2074 6865 2074 6963 6b20 onent, the tick │ │ │ │ │ +000184e0: 696d 6167 650a 2020 2020 2077 696c 6c20 image. will │ │ │ │ │ +000184f0: 6265 2064 7261 776e 2061 2063 6572 7461 be drawn a certa │ │ │ │ │ +00018500: 696e 206e 756d 6265 7220 6f66 2074 696d in number of tim │ │ │ │ │ +00018510: 6573 2c20 6465 7065 6e64 696e 6720 6f6e es, depending on │ │ │ │ │ +00018520: 2074 6865 0a20 2020 2020 7072 6f70 6572 the. proper │ │ │ │ │ +00018530: 7469 6573 206f 6620 7468 6520 636f 6d70 ties of the comp │ │ │ │ │ +00018540: 6f6e 656e 742e 0a0a 2020 2020 2050 726f onent... Pro │ │ │ │ │ +00018550: 7065 7274 6965 733a 0a0a 2020 2020 2069 perties:.. i │ │ │ │ │ +00018560: 6420 2020 2020 2020 2020 2020 2020 2020 d │ │ │ │ │ +00018570: 2020 2020 2020 5365 7420 746f 2022 5f5f Set to "__ │ │ │ │ │ +00018580: 7469 6d65 6f75 745f 5f22 2074 6f20 6469 timeout__" to di │ │ │ │ │ +00018590: 7370 6c61 7920 7468 6520 7469 6d65 0a20 splay the time. │ │ │ │ │ +000185a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +000185b0: 2020 2020 2020 2020 2020 2065 6c61 7073 elaps │ │ │ │ │ +000185c0: 6564 2074 6f20 616e 2061 7574 6f6d 6174 ed to an automat │ │ │ │ │ +000185d0: 6963 616c 2062 6f6f 7420 6f66 2074 6865 ical boot of the │ │ │ │ │ +000185e0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +000185f0: 2020 2020 2020 2020 2020 2020 2064 6566 def │ │ │ │ │ +00018600: 6175 6c74 2065 6e74 7279 2e0a 2020 2020 ault entry.. │ │ │ │ │ +00018610: 2063 656e 7465 725f 6269 746d 6170 2020 center_bitmap │ │ │ │ │ +00018620: 2020 2020 2020 2020 5468 6520 6669 6c65 The file │ │ │ │ │ +00018630: 206e 616d 6520 6f66 2074 6865 2069 6d61 name of the ima │ │ │ │ │ +00018640: 6765 2074 6f20 6472 6177 2069 6e20 7468 ge to draw in th │ │ │ │ │ +00018650: 650a 2020 2020 2020 2020 2020 2020 2020 e. │ │ │ │ │ +00018660: 2020 2020 2020 2020 2020 2020 2020 6365 ce │ │ │ │ │ +00018670: 6e74 6572 206f 6620 7468 6520 636f 6d70 nter of the comp │ │ │ │ │ +00018680: 6f6e 656e 742e 0a20 2020 2020 7469 636b onent.. tick │ │ │ │ │ +00018690: 5f62 6974 6d61 7020 2020 2020 2020 2020 _bitmap │ │ │ │ │ +000186a0: 2020 2054 6865 2066 696c 6520 6e61 6d65 The file name │ │ │ │ │ +000186b0: 206f 6620 7468 6520 696d 6167 6520 746f of the image to │ │ │ │ │ +000186c0: 2064 7261 7720 666f 720a 2020 2020 2020 draw for. │ │ │ │ │ 000186d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000186e0: 2020 2020 2020 2020 7468 6520 7469 636b the tick │ │ │ │ │ -000186f0: 206d 6172 6b73 2e0a 2020 2020 206e 756d marks.. num │ │ │ │ │ -00018700: 5f74 6963 6b73 2020 2020 2020 2020 2020 _ticks │ │ │ │ │ -00018710: 2020 2020 5468 6520 6e75 6d62 6572 206f The number o │ │ │ │ │ -00018720: 6620 7469 636b 7320 7468 6174 206d 616b f ticks that mak │ │ │ │ │ -00018730: 6520 7570 2061 2066 756c 6c0a 2020 2020 e up a full. │ │ │ │ │ +000186e0: 2020 2020 2020 7468 6520 7469 636b 206d the tick m │ │ │ │ │ +000186f0: 6172 6b73 2e0a 2020 2020 206e 756d 5f74 arks.. num_t │ │ │ │ │ +00018700: 6963 6b73 2020 2020 2020 2020 2020 2020 icks │ │ │ │ │ +00018710: 2020 5468 6520 6e75 6d62 6572 206f 6620 The number of │ │ │ │ │ +00018720: 7469 636b 7320 7468 6174 206d 616b 6520 ticks that make │ │ │ │ │ +00018730: 7570 2061 2066 756c 6c0a 2020 2020 2020 up a full. │ │ │ │ │ 00018740: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018750: 2020 2020 2020 2020 6369 7263 6c65 2e0a circle.. │ │ │ │ │ -00018760: 2020 2020 2074 6963 6b73 5f64 6973 6170 ticks_disap │ │ │ │ │ -00018770: 7065 6172 2020 2020 2020 2020 426f 6f6c pear Bool │ │ │ │ │ -00018780: 6561 6e20 7661 6c75 6520 696e 6469 6361 ean value indica │ │ │ │ │ -00018790: 7469 6e67 2077 6865 7468 6572 2074 6963 ting whether tic │ │ │ │ │ -000187a0: 6b0a 2020 2020 2020 2020 2020 2020 2020 k. │ │ │ │ │ -000187b0: 2020 2020 2020 2020 2020 2020 2020 6d61 ma │ │ │ │ │ -000187c0: 726b 7320 7368 6f75 6c64 2070 726f 6772 rks should progr │ │ │ │ │ -000187d0: 6573 7369 7665 6c79 2061 7070 6561 722c essively appear, │ │ │ │ │ -000187e0: 206f 720a 2020 2020 2020 2020 2020 2020 or. │ │ │ │ │ -000187f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018800: 7072 6f67 7265 7373 6976 656c 7920 6469 progressively di │ │ │ │ │ -00018810: 7361 7070 6561 7220 6173 202a 7661 6c75 sappear as *valu │ │ │ │ │ -00018820: 652a 0a20 2020 2020 2020 2020 2020 2020 e*. │ │ │ │ │ -00018830: 2020 2020 2020 2020 2020 2020 2020 2061 a │ │ │ │ │ -00018840: 7070 726f 6163 6865 7320 2a65 6e64 2a2e pproaches *end*. │ │ │ │ │ -00018850: 2020 5370 6563 6966 7920 2274 7275 6522 Specify "true" │ │ │ │ │ -00018860: 206f 720a 2020 2020 2020 2020 2020 2020 or. │ │ │ │ │ -00018870: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018880: 2266 616c 7365 222e 2020 4465 6661 756c "false". Defaul │ │ │ │ │ -00018890: 7420 6973 2022 6661 6c73 6522 2e0a 2020 t is "false".. │ │ │ │ │ -000188a0: 2020 2073 7461 7274 5f61 6e67 6c65 2020 start_angle │ │ │ │ │ -000188b0: 2020 2020 2020 2020 2020 5468 6520 706f The po │ │ │ │ │ -000188c0: 7369 7469 6f6e 206f 6620 7468 6520 6669 sition of the fi │ │ │ │ │ -000188d0: 7273 7420 7469 636b 206d 6172 6b20 746f rst tick mark to │ │ │ │ │ -000188e0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ -000188f0: 2020 2020 2020 2020 2020 2020 2061 7070 app │ │ │ │ │ -00018900: 6561 7220 6f72 2064 6973 6170 7065 6172 ear or disappear │ │ │ │ │ -00018910: 2e20 204d 6561 7375 7265 6420 696e 0a20 . Measured in. │ │ │ │ │ +00018750: 2020 2020 2020 6369 7263 6c65 2e0a 2020 circle.. │ │ │ │ │ +00018760: 2020 2074 6963 6b73 5f64 6973 6170 7065 ticks_disappe │ │ │ │ │ +00018770: 6172 2020 2020 2020 2020 426f 6f6c 6561 ar Boolea │ │ │ │ │ +00018780: 6e20 7661 6c75 6520 696e 6469 6361 7469 n value indicati │ │ │ │ │ +00018790: 6e67 2077 6865 7468 6572 2074 6963 6b0a ng whether tick. │ │ │ │ │ +000187a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +000187b0: 2020 2020 2020 2020 2020 2020 6d61 726b mark │ │ │ │ │ +000187c0: 7320 7368 6f75 6c64 2070 726f 6772 6573 s should progres │ │ │ │ │ +000187d0: 7369 7665 6c79 2061 7070 6561 722c 206f sively appear, o │ │ │ │ │ +000187e0: 720a 2020 2020 2020 2020 2020 2020 2020 r. │ │ │ │ │ +000187f0: 2020 2020 2020 2020 2020 2020 2020 7072 pr │ │ │ │ │ +00018800: 6f67 7265 7373 6976 656c 7920 6469 7361 ogressively disa │ │ │ │ │ +00018810: 7070 6561 7220 6173 202a 7661 6c75 652a ppear as *value* │ │ │ │ │ +00018820: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +00018830: 2020 2020 2020 2020 2020 2020 2061 7070 app │ │ │ │ │ +00018840: 726f 6163 6865 7320 2a65 6e64 2a2e 2020 roaches *end*. │ │ │ │ │ +00018850: 5370 6563 6966 7920 2274 7275 6522 206f Specify "true" o │ │ │ │ │ +00018860: 720a 2020 2020 2020 2020 2020 2020 2020 r. │ │ │ │ │ +00018870: 2020 2020 2020 2020 2020 2020 2020 2266 "f │ │ │ │ │ +00018880: 616c 7365 222e 2020 4465 6661 756c 7420 alse". Default │ │ │ │ │ +00018890: 6973 2022 6661 6c73 6522 2e0a 2020 2020 is "false".. │ │ │ │ │ +000188a0: 2073 7461 7274 5f61 6e67 6c65 2020 2020 start_angle │ │ │ │ │ +000188b0: 2020 2020 2020 2020 5468 6520 706f 7369 The posi │ │ │ │ │ +000188c0: 7469 6f6e 206f 6620 7468 6520 6669 7273 tion of the firs │ │ │ │ │ +000188d0: 7420 7469 636b 206d 6172 6b20 746f 0a20 t tick mark to. │ │ │ │ │ +000188e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +000188f0: 2020 2020 2020 2020 2020 2061 7070 6561 appea │ │ │ │ │ +00018900: 7220 6f72 2064 6973 6170 7065 6172 2e20 r or disappear. │ │ │ │ │ +00018910: 204d 6561 7375 7265 6420 696e 0a20 2020 Measured in. │ │ │ │ │ 00018920: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018930: 2020 2020 2020 2020 2020 2022 7061 7272 "parr │ │ │ │ │ -00018940: 6f74 7322 2c20 3120 2270 6172 726f 7422 ots", 1 "parrot" │ │ │ │ │ -00018950: 203d 2031 202f 2032 3536 206f 6620 7468 = 1 / 256 of th │ │ │ │ │ -00018960: 650a 2020 2020 2020 2020 2020 2020 2020 e. │ │ │ │ │ -00018970: 2020 2020 2020 2020 2020 2020 2020 6675 fu │ │ │ │ │ -00018980: 6c6c 2063 6972 636c 652e 2020 5573 6520 ll circle. Use │ │ │ │ │ -00018990: 7661 6c75 6573 2022 7878 7820 6465 6722 values "xxx deg" │ │ │ │ │ -000189a0: 206f 720a 2020 2020 2020 2020 2020 2020 or. │ │ │ │ │ -000189b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000189c0: 2278 7878 205c 7863 325c 7862 3022 2074 "xxx \xc2\xb0" t │ │ │ │ │ -000189d0: 6f20 7365 7420 7468 6520 616e 676c 6520 o set the angle │ │ │ │ │ -000189e0: 696e 0a20 2020 2020 2020 2020 2020 2020 in. │ │ │ │ │ -000189f0: 2020 2020 2020 2020 2020 2020 2020 2064 d │ │ │ │ │ -00018a00: 6567 7265 6573 2e0a 0a20 2020 2a20 626f egrees... * bo │ │ │ │ │ -00018a10: 6f74 5f6d 656e 7520 4469 7370 6c61 7973 ot_menu Displays │ │ │ │ │ -00018a20: 2074 6865 2047 5255 4220 626f 6f74 206d the GRUB boot m │ │ │ │ │ -00018a30: 656e 752e 2020 4974 2061 6c6c 6f77 7320 enu. It allows │ │ │ │ │ -00018a40: 7365 6c65 6374 696e 6720 6974 656d 730a selecting items. │ │ │ │ │ -00018a50: 2020 2020 2061 6e64 2065 7865 6375 7469 and executi │ │ │ │ │ -00018a60: 6e67 2074 6865 6d2e 0a0a 2020 2020 2050 ng them... P │ │ │ │ │ -00018a70: 726f 7065 7274 6965 733a 0a0a 2020 2020 roperties:.. │ │ │ │ │ -00018a80: 2069 7465 6d5f 666f 6e74 2020 2020 2020 item_font │ │ │ │ │ -00018a90: 2020 2020 2020 2020 2020 2020 2020 2054 T │ │ │ │ │ -00018aa0: 6865 2066 6f6e 7420 746f 2075 7365 2066 he font to use f │ │ │ │ │ -00018ab0: 6f72 2074 6865 206d 656e 7520 6974 656d or the menu item │ │ │ │ │ -00018ac0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +00018930: 2020 2020 2020 2020 2022 7061 7272 6f74 "parrot │ │ │ │ │ +00018940: 7322 2c20 3120 2270 6172 726f 7422 203d s", 1 "parrot" = │ │ │ │ │ +00018950: 2031 202f 2032 3536 206f 6620 7468 650a 1 / 256 of the. │ │ │ │ │ +00018960: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00018970: 2020 2020 2020 2020 2020 2020 6675 6c6c full │ │ │ │ │ +00018980: 2063 6972 636c 652e 2020 5573 6520 7661 circle. Use va │ │ │ │ │ +00018990: 6c75 6573 2022 7878 7820 6465 6722 206f lues "xxx deg" o │ │ │ │ │ +000189a0: 720a 2020 2020 2020 2020 2020 2020 2020 r. │ │ │ │ │ +000189b0: 2020 2020 2020 2020 2020 2020 2020 2278 "x │ │ │ │ │ +000189c0: 7878 205c 7863 325c 7862 3022 2074 6f20 xx \xc2\xb0" to │ │ │ │ │ +000189d0: 7365 7420 7468 6520 616e 676c 6520 696e set the angle in │ │ │ │ │ +000189e0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +000189f0: 2020 2020 2020 2020 2020 2020 2064 6567 deg │ │ │ │ │ +00018a00: 7265 6573 2e0a 0a20 2020 2a20 626f 6f74 rees... * boot │ │ │ │ │ +00018a10: 5f6d 656e 7520 4469 7370 6c61 7973 2074 _menu Displays t │ │ │ │ │ +00018a20: 6865 2047 5255 4220 626f 6f74 206d 656e he GRUB boot men │ │ │ │ │ +00018a30: 752e 2020 4974 2061 6c6c 6f77 7320 7365 u. It allows se │ │ │ │ │ +00018a40: 6c65 6374 696e 6720 6974 656d 730a 2020 lecting items. │ │ │ │ │ +00018a50: 2020 2061 6e64 2065 7865 6375 7469 6e67 and executing │ │ │ │ │ +00018a60: 2074 6865 6d2e 0a0a 2020 2020 2050 726f them... Pro │ │ │ │ │ +00018a70: 7065 7274 6965 733a 0a0a 2020 2020 2069 perties:.. i │ │ │ │ │ +00018a80: 7465 6d5f 666f 6e74 2020 2020 2020 2020 tem_font │ │ │ │ │ +00018a90: 2020 2020 2020 2020 2020 2020 2054 6865 The │ │ │ │ │ +00018aa0: 2066 6f6e 7420 746f 2075 7365 2066 6f72 font to use for │ │ │ │ │ +00018ab0: 2074 6865 206d 656e 7520 6974 656d 0a20 the menu item. │ │ │ │ │ +00018ac0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00018ad0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018ae0: 2020 2020 7469 746c 6573 2e0a 2020 2020 titles.. │ │ │ │ │ -00018af0: 2073 656c 6563 7465 645f 6974 656d 5f66 selected_item_f │ │ │ │ │ -00018b00: 6f6e 7420 2020 2020 2020 2020 2020 2054 ont T │ │ │ │ │ -00018b10: 6865 2066 6f6e 7420 746f 2075 7365 2066 he font to use f │ │ │ │ │ -00018b20: 6f72 2074 6865 2073 656c 6563 7465 640a or the selected. │ │ │ │ │ +00018ae0: 2020 7469 746c 6573 2e0a 2020 2020 2073 titles.. s │ │ │ │ │ +00018af0: 656c 6563 7465 645f 6974 656d 5f66 6f6e elected_item_fon │ │ │ │ │ +00018b00: 7420 2020 2020 2020 2020 2020 2054 6865 t The │ │ │ │ │ +00018b10: 2066 6f6e 7420 746f 2075 7365 2066 6f72 font to use for │ │ │ │ │ +00018b20: 2074 6865 2073 656c 6563 7465 640a 2020 the selected. │ │ │ │ │ 00018b30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00018b40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018b50: 2020 206d 656e 7520 6974 656d 2c20 6f72 menu item, or │ │ │ │ │ -00018b60: 2022 696e 6865 7269 7422 2028 7468 650a "inherit" (the. │ │ │ │ │ +00018b50: 206d 656e 7520 6974 656d 2c20 6f72 2022 menu item, or " │ │ │ │ │ +00018b60: 696e 6865 7269 7422 2028 7468 650a 2020 inherit" (the. │ │ │ │ │ 00018b70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00018b80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018b90: 2020 2064 6566 6175 6c74 2920 746f 2075 default) to u │ │ │ │ │ -00018ba0: 7365 2022 6974 656d 5f66 6f6e 7422 2066 se "item_font" f │ │ │ │ │ -00018bb0: 6f72 0a20 2020 2020 2020 2020 2020 2020 or. │ │ │ │ │ +00018b90: 2064 6566 6175 6c74 2920 746f 2075 7365 default) to use │ │ │ │ │ +00018ba0: 2022 6974 656d 5f66 6f6e 7422 2066 6f72 "item_font" for │ │ │ │ │ +00018bb0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ 00018bc0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018bd0: 2020 2020 2020 7468 6520 7365 6c65 6374 the select │ │ │ │ │ -00018be0: 6564 206d 656e 7520 6974 656d 2061 7320 ed menu item as │ │ │ │ │ -00018bf0: 7765 6c6c 2e0a 2020 2020 2069 7465 6d5f well.. item_ │ │ │ │ │ -00018c00: 636f 6c6f 7220 2020 2020 2020 2020 2020 color │ │ │ │ │ -00018c10: 2020 2020 2020 2020 2054 6865 2063 6f6c The col │ │ │ │ │ -00018c20: 6f72 2074 6f20 7573 6520 666f 7220 7468 or to use for th │ │ │ │ │ -00018c30: 6520 6d65 6e75 2069 7465 6d0a 2020 2020 e menu item. │ │ │ │ │ +00018bd0: 2020 2020 7468 6520 7365 6c65 6374 6564 the selected │ │ │ │ │ +00018be0: 206d 656e 7520 6974 656d 2061 7320 7765 menu item as we │ │ │ │ │ +00018bf0: 6c6c 2e0a 2020 2020 2069 7465 6d5f 636f ll.. item_co │ │ │ │ │ +00018c00: 6c6f 7220 2020 2020 2020 2020 2020 2020 lor │ │ │ │ │ +00018c10: 2020 2020 2020 2054 6865 2063 6f6c 6f72 The color │ │ │ │ │ +00018c20: 2074 6f20 7573 6520 666f 7220 7468 6520 to use for the │ │ │ │ │ +00018c30: 6d65 6e75 2069 7465 6d0a 2020 2020 2020 menu item. │ │ │ │ │ 00018c40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018c50: 2020 2020 2020 2020 2020 2020 2020 2074 t │ │ │ │ │ -00018c60: 6974 6c65 732e 0a20 2020 2020 7365 6c65 itles.. sele │ │ │ │ │ -00018c70: 6374 6564 5f69 7465 6d5f 636f 6c6f 7220 cted_item_color │ │ │ │ │ -00018c80: 2020 2020 2020 2020 2020 5468 6520 636f The co │ │ │ │ │ -00018c90: 6c6f 7220 746f 2075 7365 2066 6f72 2074 lor to use for t │ │ │ │ │ -00018ca0: 6865 2073 656c 6563 7465 640a 2020 2020 he selected. │ │ │ │ │ +00018c50: 2020 2020 2020 2020 2020 2020 2074 6974 tit │ │ │ │ │ +00018c60: 6c65 732e 0a20 2020 2020 7365 6c65 6374 les.. select │ │ │ │ │ +00018c70: 6564 5f69 7465 6d5f 636f 6c6f 7220 2020 ed_item_color │ │ │ │ │ +00018c80: 2020 2020 2020 2020 5468 6520 636f 6c6f The colo │ │ │ │ │ +00018c90: 7220 746f 2075 7365 2066 6f72 2074 6865 r to use for the │ │ │ │ │ +00018ca0: 2073 656c 6563 7465 640a 2020 2020 2020 selected. │ │ │ │ │ 00018cb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018cc0: 2020 2020 2020 2020 2020 2020 2020 206d m │ │ │ │ │ -00018cd0: 656e 7520 6974 656d 2c20 6f72 2022 696e enu item, or "in │ │ │ │ │ -00018ce0: 6865 7269 7422 2028 7468 650a 2020 2020 herit" (the. │ │ │ │ │ +00018cc0: 2020 2020 2020 2020 2020 2020 206d 656e men │ │ │ │ │ +00018cd0: 7520 6974 656d 2c20 6f72 2022 696e 6865 u item, or "inhe │ │ │ │ │ +00018ce0: 7269 7422 2028 7468 650a 2020 2020 2020 rit" (the. │ │ │ │ │ 00018cf0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018d00: 2020 2020 2020 2020 2020 2020 2020 2064 d │ │ │ │ │ -00018d10: 6566 6175 6c74 2920 746f 2075 7365 2022 efault) to use " │ │ │ │ │ -00018d20: 6974 656d 5f63 6f6c 6f72 2220 666f 720a item_color" for. │ │ │ │ │ +00018d00: 2020 2020 2020 2020 2020 2020 2064 6566 def │ │ │ │ │ +00018d10: 6175 6c74 2920 746f 2075 7365 2022 6974 ault) to use "it │ │ │ │ │ +00018d20: 656d 5f63 6f6c 6f72 2220 666f 720a 2020 em_color" for. │ │ │ │ │ 00018d30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00018d40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018d50: 2020 2074 6865 2073 656c 6563 7465 6420 the selected │ │ │ │ │ -00018d60: 6d65 6e75 2069 7465 6d20 6173 2077 656c menu item as wel │ │ │ │ │ -00018d70: 6c2e 0a20 2020 2020 6963 6f6e 5f77 6964 l.. icon_wid │ │ │ │ │ -00018d80: 7468 2020 2020 2020 2020 2020 2020 2020 th │ │ │ │ │ -00018d90: 2020 2020 2020 5468 6520 7769 6474 6820 The width │ │ │ │ │ -00018da0: 6f66 206d 656e 7520 6974 656d 2069 636f of menu item ico │ │ │ │ │ -00018db0: 6e73 2e0a 2020 2020 2020 2020 2020 2020 ns.. │ │ │ │ │ +00018d50: 2074 6865 2073 656c 6563 7465 6420 6d65 the selected me │ │ │ │ │ +00018d60: 6e75 2069 7465 6d20 6173 2077 656c 6c2e nu item as well. │ │ │ │ │ +00018d70: 0a20 2020 2020 6963 6f6e 5f77 6964 7468 . icon_width │ │ │ │ │ +00018d80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00018d90: 2020 2020 5468 6520 7769 6474 6820 6f66 The width of │ │ │ │ │ +00018da0: 206d 656e 7520 6974 656d 2069 636f 6e73 menu item icons │ │ │ │ │ +00018db0: 2e0a 2020 2020 2020 2020 2020 2020 2020 .. │ │ │ │ │ 00018dc0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018dd0: 2020 2020 2020 2049 636f 6e73 2061 7265 Icons are │ │ │ │ │ -00018de0: 2073 6361 6c65 6420 746f 2074 6865 2073 scaled to the s │ │ │ │ │ -00018df0: 7065 6369 6669 6564 0a20 2020 2020 2020 pecified. │ │ │ │ │ +00018dd0: 2020 2020 2049 636f 6e73 2061 7265 2073 Icons are s │ │ │ │ │ +00018de0: 6361 6c65 6420 746f 2074 6865 2073 7065 caled to the spe │ │ │ │ │ +00018df0: 6369 6669 6564 0a20 2020 2020 2020 2020 cified. │ │ │ │ │ 00018e00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018e10: 2020 2020 2020 2020 2020 2020 7369 7a65 size │ │ │ │ │ -00018e20: 2e0a 2020 2020 2069 636f 6e5f 6865 6967 .. icon_heig │ │ │ │ │ -00018e30: 6874 2020 2020 2020 2020 2020 2020 2020 ht │ │ │ │ │ -00018e40: 2020 2020 2054 6865 2068 6569 6768 7420 The height │ │ │ │ │ -00018e50: 6f66 206d 656e 7520 6974 656d 2069 636f of menu item ico │ │ │ │ │ -00018e60: 6e73 2e0a 2020 2020 2069 7465 6d5f 6865 ns.. item_he │ │ │ │ │ -00018e70: 6967 6874 2020 2020 2020 2020 2020 2020 ight │ │ │ │ │ -00018e80: 2020 2020 2020 2054 6865 2068 6569 6768 The heigh │ │ │ │ │ -00018e90: 7420 6f66 2065 6163 6820 6d65 6e75 2069 t of each menu i │ │ │ │ │ -00018ea0: 7465 6d20 696e 0a20 2020 2020 2020 2020 tem in. │ │ │ │ │ +00018e10: 2020 2020 2020 2020 2020 7369 7a65 2e0a size.. │ │ │ │ │ +00018e20: 2020 2020 2069 636f 6e5f 6865 6967 6874 icon_height │ │ │ │ │ +00018e30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00018e40: 2020 2054 6865 2068 6569 6768 7420 6f66 The height of │ │ │ │ │ +00018e50: 206d 656e 7520 6974 656d 2069 636f 6e73 menu item icons │ │ │ │ │ +00018e60: 2e0a 2020 2020 2069 7465 6d5f 6865 6967 .. item_heig │ │ │ │ │ +00018e70: 6874 2020 2020 2020 2020 2020 2020 2020 ht │ │ │ │ │ +00018e80: 2020 2020 2054 6865 2068 6569 6768 7420 The height │ │ │ │ │ +00018e90: 6f66 2065 6163 6820 6d65 6e75 2069 7465 of each menu ite │ │ │ │ │ +00018ea0: 6d20 696e 0a20 2020 2020 2020 2020 2020 m in. │ │ │ │ │ 00018eb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018ec0: 2020 2020 2020 2020 2020 7069 7865 6c73 pixels │ │ │ │ │ -00018ed0: 2e0a 2020 2020 2069 7465 6d5f 7061 6464 .. item_padd │ │ │ │ │ -00018ee0: 696e 6720 2020 2020 2020 2020 2020 2020 ing │ │ │ │ │ -00018ef0: 2020 2020 2054 6865 2061 6d6f 756e 7420 The amount │ │ │ │ │ -00018f00: 6f66 2073 7061 6365 2069 6e20 7069 7865 of space in pixe │ │ │ │ │ -00018f10: 6c73 2074 6f0a 2020 2020 2020 2020 2020 ls to. │ │ │ │ │ +00018ec0: 2020 2020 2020 2020 7069 7865 6c73 2e0a pixels.. │ │ │ │ │ +00018ed0: 2020 2020 2069 7465 6d5f 7061 6464 696e item_paddin │ │ │ │ │ +00018ee0: 6720 2020 2020 2020 2020 2020 2020 2020 g │ │ │ │ │ +00018ef0: 2020 2054 6865 2061 6d6f 756e 7420 6f66 The amount of │ │ │ │ │ +00018f00: 2073 7061 6365 2069 6e20 7069 7865 6c73 space in pixels │ │ │ │ │ +00018f10: 2074 6f0a 2020 2020 2020 2020 2020 2020 to. │ │ │ │ │ 00018f20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018f30: 2020 2020 2020 2020 206c 6561 7665 206f leave o │ │ │ │ │ -00018f40: 6e20 6561 6368 2073 6964 6520 6f66 2074 n each side of t │ │ │ │ │ -00018f50: 6865 206d 656e 750a 2020 2020 2020 2020 he menu. │ │ │ │ │ +00018f30: 2020 2020 2020 206c 6561 7665 206f 6e20 leave on │ │ │ │ │ +00018f40: 6561 6368 2073 6964 6520 6f66 2074 6865 each side of the │ │ │ │ │ +00018f50: 206d 656e 750a 2020 2020 2020 2020 2020 menu. │ │ │ │ │ 00018f60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018f70: 2020 2020 2020 2020 2020 2069 7465 6d20 item │ │ │ │ │ -00018f80: 636f 6e74 656e 7473 2e0a 2020 2020 2069 contents.. i │ │ │ │ │ -00018f90: 7465 6d5f 6963 6f6e 5f73 7061 6365 2020 tem_icon_space │ │ │ │ │ -00018fa0: 2020 2020 2020 2020 2020 2020 2054 6865 The │ │ │ │ │ -00018fb0: 2073 7061 6365 2062 6574 7765 656e 2061 space between a │ │ │ │ │ -00018fc0: 6e20 6974 656d 2773 2069 636f 6e0a 2020 n item's icon. │ │ │ │ │ +00018f70: 2020 2020 2020 2020 2069 7465 6d20 636f item co │ │ │ │ │ +00018f80: 6e74 656e 7473 2e0a 2020 2020 2069 7465 ntents.. ite │ │ │ │ │ +00018f90: 6d5f 6963 6f6e 5f73 7061 6365 2020 2020 m_icon_space │ │ │ │ │ +00018fa0: 2020 2020 2020 2020 2020 2054 6865 2073 The s │ │ │ │ │ +00018fb0: 7061 6365 2062 6574 7765 656e 2061 6e20 pace between an │ │ │ │ │ +00018fc0: 6974 656d 2773 2069 636f 6e0a 2020 2020 item's icon. │ │ │ │ │ 00018fd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018fe0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018ff0: 2061 6e64 2074 6865 2074 6974 6c65 2074 and the title t │ │ │ │ │ -00019000: 6578 742c 2069 6e20 7069 7865 6c73 2e0a ext, in pixels.. │ │ │ │ │ -00019010: 2020 2020 2069 7465 6d5f 7370 6163 696e item_spacin │ │ │ │ │ -00019020: 6720 2020 2020 2020 2020 2020 2020 2020 g │ │ │ │ │ -00019030: 2020 2054 6865 2061 6d6f 756e 7420 6f66 The amount of │ │ │ │ │ -00019040: 2073 7061 6365 2074 6f20 6c65 6176 650a space to leave. │ │ │ │ │ +00018fe0: 2020 2020 2020 2020 2020 2020 2020 2061 a │ │ │ │ │ +00018ff0: 6e64 2074 6865 2074 6974 6c65 2074 6578 nd the title tex │ │ │ │ │ +00019000: 742c 2069 6e20 7069 7865 6c73 2e0a 2020 t, in pixels.. │ │ │ │ │ +00019010: 2020 2069 7465 6d5f 7370 6163 696e 6720 item_spacing │ │ │ │ │ +00019020: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00019030: 2054 6865 2061 6d6f 756e 7420 6f66 2073 The amount of s │ │ │ │ │ +00019040: 7061 6365 2074 6f20 6c65 6176 650a 2020 pace to leave. │ │ │ │ │ 00019050: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00019060: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019070: 2020 2062 6574 7765 656e 206d 656e 7520 between menu │ │ │ │ │ -00019080: 6974 656d 732c 2069 6e20 7069 7865 6c73 items, in pixels │ │ │ │ │ -00019090: 2e0a 2020 2020 206d 656e 755f 7069 786d .. menu_pixm │ │ │ │ │ -000190a0: 6170 5f73 7479 6c65 2020 2020 2020 2020 ap_style │ │ │ │ │ -000190b0: 2020 2020 2054 6865 2069 6d61 6765 2066 The image f │ │ │ │ │ -000190c0: 696c 6520 7061 7474 6572 6e20 666f 7220 ile pattern for │ │ │ │ │ -000190d0: 7468 650a 2020 2020 2020 2020 2020 2020 the. │ │ │ │ │ +00019070: 2062 6574 7765 656e 206d 656e 7520 6974 between menu it │ │ │ │ │ +00019080: 656d 732c 2069 6e20 7069 7865 6c73 2e0a ems, in pixels.. │ │ │ │ │ +00019090: 2020 2020 206d 656e 755f 7069 786d 6170 menu_pixmap │ │ │ │ │ +000190a0: 5f73 7479 6c65 2020 2020 2020 2020 2020 _style │ │ │ │ │ +000190b0: 2020 2054 6865 2069 6d61 6765 2066 696c The image fil │ │ │ │ │ +000190c0: 6520 7061 7474 6572 6e20 666f 7220 7468 e pattern for th │ │ │ │ │ +000190d0: 650a 2020 2020 2020 2020 2020 2020 2020 e. │ │ │ │ │ 000190e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000190f0: 2020 2020 2020 206d 656e 7520 6672 616d menu fram │ │ │ │ │ -00019100: 6520 7374 796c 6564 2062 6f78 2e20 2045 e styled box. E │ │ │ │ │ -00019110: 7861 6d70 6c65 3a0a 2020 2020 2020 2020 xample:. │ │ │ │ │ +000190f0: 2020 2020 206d 656e 7520 6672 616d 6520 menu frame │ │ │ │ │ +00019100: 7374 796c 6564 2062 6f78 2e20 2045 7861 styled box. Exa │ │ │ │ │ +00019110: 6d70 6c65 3a0a 2020 2020 2020 2020 2020 mple:. │ │ │ │ │ 00019120: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019130: 2020 2020 2020 2020 2020 2022 6d65 6e75 "menu │ │ │ │ │ -00019140: 5f2a 2e70 6e67 2220 2874 6869 7320 7769 _*.png" (this wi │ │ │ │ │ -00019150: 6c6c 2075 7365 2069 6d61 6765 730a 2020 ll use images. │ │ │ │ │ +00019130: 2020 2020 2020 2020 2022 6d65 6e75 5f2a "menu_* │ │ │ │ │ +00019140: 2e70 6e67 2220 2874 6869 7320 7769 6c6c .png" (this will │ │ │ │ │ +00019150: 2075 7365 2069 6d61 6765 730a 2020 2020 use images. │ │ │ │ │ 00019160: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019170: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019180: 2073 7563 6820 6173 2022 6d65 6e75 5f63 such as "menu_c │ │ │ │ │ -00019190: 2e70 6e67 222c 0a20 2020 2020 2020 2020 .png",. │ │ │ │ │ +00019170: 2020 2020 2020 2020 2020 2020 2020 2073 s │ │ │ │ │ +00019180: 7563 6820 6173 2022 6d65 6e75 5f63 2e70 uch as "menu_c.p │ │ │ │ │ +00019190: 6e67 222c 0a20 2020 2020 2020 2020 2020 ng",. │ │ │ │ │ 000191a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000191b0: 2020 2020 2020 2020 2020 226d 656e 755f "menu_ │ │ │ │ │ -000191c0: 772e 706e 6722 2c20 276d 656e 755f 6e77 w.png", 'menu_nw │ │ │ │ │ -000191d0: 2e70 6e67 222c 2065 7463 2e29 0a20 2020 .png", etc.). │ │ │ │ │ -000191e0: 2020 6974 656d 5f70 6978 6d61 705f 7374 item_pixmap_st │ │ │ │ │ -000191f0: 796c 6520 2020 2020 2020 2020 2020 2020 yle │ │ │ │ │ -00019200: 5468 6520 696d 6167 6520 6669 6c65 2070 The image file p │ │ │ │ │ -00019210: 6174 7465 726e 2066 6f72 2074 6865 0a20 attern for the. │ │ │ │ │ +000191b0: 2020 2020 2020 2020 226d 656e 755f 772e "menu_w. │ │ │ │ │ +000191c0: 706e 6722 2c20 276d 656e 755f 6e77 2e70 png", 'menu_nw.p │ │ │ │ │ +000191d0: 6e67 222c 2065 7463 2e29 0a20 2020 2020 ng", etc.). │ │ │ │ │ +000191e0: 6974 656d 5f70 6978 6d61 705f 7374 796c item_pixmap_styl │ │ │ │ │ +000191f0: 6520 2020 2020 2020 2020 2020 2020 5468 e Th │ │ │ │ │ +00019200: 6520 696d 6167 6520 6669 6c65 2070 6174 e image file pat │ │ │ │ │ +00019210: 7465 726e 2066 6f72 2074 6865 0a20 2020 tern for the. │ │ │ │ │ 00019220: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00019230: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019240: 2020 6974 656d 2073 7479 6c65 6420 626f item styled bo │ │ │ │ │ -00019250: 782e 0a20 2020 2020 7365 6c65 6374 6564 x.. selected │ │ │ │ │ -00019260: 5f69 7465 6d5f 7069 786d 6170 5f73 7479 _item_pixmap_sty │ │ │ │ │ -00019270: 6c65 2020 2020 5468 6520 696d 6167 6520 le The image │ │ │ │ │ -00019280: 6669 6c65 2070 6174 7465 726e 2066 6f72 file pattern for │ │ │ │ │ -00019290: 2074 6865 0a20 2020 2020 2020 2020 2020 the. │ │ │ │ │ +00019240: 6974 656d 2073 7479 6c65 6420 626f 782e item styled box. │ │ │ │ │ +00019250: 0a20 2020 2020 7365 6c65 6374 6564 5f69 . selected_i │ │ │ │ │ +00019260: 7465 6d5f 7069 786d 6170 5f73 7479 6c65 tem_pixmap_style │ │ │ │ │ +00019270: 2020 2020 5468 6520 696d 6167 6520 6669 The image fi │ │ │ │ │ +00019280: 6c65 2070 6174 7465 726e 2066 6f72 2074 le pattern for t │ │ │ │ │ +00019290: 6865 0a20 2020 2020 2020 2020 2020 2020 he. │ │ │ │ │ 000192a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000192b0: 2020 2020 2020 2020 7365 6c65 6374 6564 selected │ │ │ │ │ -000192c0: 2069 7465 6d20 6869 6768 6c69 6768 7420 item highlight │ │ │ │ │ -000192d0: 7374 796c 6564 0a20 2020 2020 2020 2020 styled. │ │ │ │ │ +000192b0: 2020 2020 2020 7365 6c65 6374 6564 2069 selected i │ │ │ │ │ +000192c0: 7465 6d20 6869 6768 6c69 6768 7420 7374 tem highlight st │ │ │ │ │ +000192d0: 796c 6564 0a20 2020 2020 2020 2020 2020 yled. │ │ │ │ │ 000192e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000192f0: 2020 2020 2020 2020 2020 626f 782e 0a20 box.. │ │ │ │ │ -00019300: 2020 2020 7363 726f 6c6c 6261 7220 2020 scrollbar │ │ │ │ │ +000192f0: 2020 2020 2020 2020 626f 782e 0a20 2020 box.. │ │ │ │ │ +00019300: 2020 7363 726f 6c6c 6261 7220 2020 2020 scrollbar │ │ │ │ │ 00019310: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019320: 2020 426f 6f6c 6561 6e20 7661 6c75 6520 Boolean value │ │ │ │ │ -00019330: 696e 6469 6361 7469 6e67 2077 6865 7468 indicating wheth │ │ │ │ │ -00019340: 6572 0a20 2020 2020 2020 2020 2020 2020 er. │ │ │ │ │ +00019320: 426f 6f6c 6561 6e20 7661 6c75 6520 696e Boolean value in │ │ │ │ │ +00019330: 6469 6361 7469 6e67 2077 6865 7468 6572 dicating whether │ │ │ │ │ +00019340: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ 00019350: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019360: 2020 2020 2020 7468 6520 7363 726f 6c6c the scroll │ │ │ │ │ -00019370: 2062 6172 2073 686f 756c 6420 6265 2064 bar should be d │ │ │ │ │ -00019380: 7261 776e 2069 660a 2020 2020 2020 2020 rawn if. │ │ │ │ │ +00019360: 2020 2020 7468 6520 7363 726f 6c6c 2062 the scroll b │ │ │ │ │ +00019370: 6172 2073 686f 756c 6420 6265 2064 7261 ar should be dra │ │ │ │ │ +00019380: 776e 2069 660a 2020 2020 2020 2020 2020 wn if. │ │ │ │ │ 00019390: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000193a0: 2020 2020 2020 2020 2020 2074 6865 2066 the f │ │ │ │ │ -000193b0: 7261 6d65 2061 6e64 2074 6875 6d62 2073 rame and thumb s │ │ │ │ │ -000193c0: 7479 6c65 6420 626f 7865 730a 2020 2020 tyled boxes. │ │ │ │ │ +000193a0: 2020 2020 2020 2020 2074 6865 2066 7261 the fra │ │ │ │ │ +000193b0: 6d65 2061 6e64 2074 6875 6d62 2073 7479 me and thumb sty │ │ │ │ │ +000193c0: 6c65 6420 626f 7865 730a 2020 2020 2020 led boxes. │ │ │ │ │ 000193d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000193e0: 2020 2020 2020 2020 2020 2020 2020 2061 a │ │ │ │ │ -000193f0: 7265 2063 6f6e 6669 6775 7265 642e 0a20 re configured.. │ │ │ │ │ -00019400: 2020 2020 7363 726f 6c6c 6261 725f 6672 scrollbar_fr │ │ │ │ │ -00019410: 616d 6520 2020 2020 2020 2020 2020 2020 ame │ │ │ │ │ -00019420: 2020 5468 6520 696d 6167 6520 6669 6c65 The image file │ │ │ │ │ -00019430: 2070 6174 7465 726e 2066 6f72 2074 6865 pattern for the │ │ │ │ │ -00019440: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +000193e0: 2020 2020 2020 2020 2020 2020 2061 7265 are │ │ │ │ │ +000193f0: 2063 6f6e 6669 6775 7265 642e 0a20 2020 configured.. │ │ │ │ │ +00019400: 2020 7363 726f 6c6c 6261 725f 6672 616d scrollbar_fram │ │ │ │ │ +00019410: 6520 2020 2020 2020 2020 2020 2020 2020 e │ │ │ │ │ +00019420: 5468 6520 696d 6167 6520 6669 6c65 2070 The image file p │ │ │ │ │ +00019430: 6174 7465 726e 2066 6f72 2074 6865 0a20 attern for the. │ │ │ │ │ +00019440: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00019450: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019460: 2020 2020 656e 7469 7265 2073 6372 6f6c entire scrol │ │ │ │ │ -00019470: 6c20 6261 722e 2020 4578 616d 706c 653a l bar. Example: │ │ │ │ │ -00019480: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +00019460: 2020 656e 7469 7265 2073 6372 6f6c 6c20 entire scroll │ │ │ │ │ +00019470: 6261 722e 2020 4578 616d 706c 653a 0a20 bar. Example:. │ │ │ │ │ +00019480: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00019490: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000194a0: 2020 2020 2273 6372 6f6c 6c62 6172 5f2a "scrollbar_* │ │ │ │ │ -000194b0: 2e70 6e67 220a 2020 2020 2073 6372 6f6c .png". scrol │ │ │ │ │ -000194c0: 6c62 6172 5f74 6875 6d62 2020 2020 2020 lbar_thumb │ │ │ │ │ -000194d0: 2020 2020 2020 2020 2054 6865 2069 6d61 The ima │ │ │ │ │ -000194e0: 6765 2066 696c 6520 7061 7474 6572 6e20 ge file pattern │ │ │ │ │ -000194f0: 666f 7220 7468 650a 2020 2020 2020 2020 for the. │ │ │ │ │ +000194a0: 2020 2273 6372 6f6c 6c62 6172 5f2a 2e70 "scrollbar_*.p │ │ │ │ │ +000194b0: 6e67 220a 2020 2020 2073 6372 6f6c 6c62 ng". scrollb │ │ │ │ │ +000194c0: 6172 5f74 6875 6d62 2020 2020 2020 2020 ar_thumb │ │ │ │ │ +000194d0: 2020 2020 2020 2054 6865 2069 6d61 6765 The image │ │ │ │ │ +000194e0: 2066 696c 6520 7061 7474 6572 6e20 666f file pattern fo │ │ │ │ │ +000194f0: 7220 7468 650a 2020 2020 2020 2020 2020 r the. │ │ │ │ │ 00019500: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019510: 2020 2020 2020 2020 2020 2073 6372 6f6c scrol │ │ │ │ │ -00019520: 6c20 6261 7220 7468 756d 6220 2874 6865 l bar thumb (the │ │ │ │ │ -00019530: 2070 6172 7420 6f66 2074 6865 0a20 2020 part of the. │ │ │ │ │ +00019510: 2020 2020 2020 2020 2073 6372 6f6c 6c20 scroll │ │ │ │ │ +00019520: 6261 7220 7468 756d 6220 2874 6865 2070 bar thumb (the p │ │ │ │ │ +00019530: 6172 7420 6f66 2074 6865 0a20 2020 2020 art of the. │ │ │ │ │ 00019540: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019550: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019560: 7363 726f 6c6c 2062 6172 2074 6861 7420 scroll bar that │ │ │ │ │ -00019570: 6d6f 7665 7320 6173 2073 6372 6f6c 6c69 moves as scrolli │ │ │ │ │ -00019580: 6e67 0a20 2020 2020 2020 2020 2020 2020 ng. │ │ │ │ │ +00019550: 2020 2020 2020 2020 2020 2020 2020 7363 sc │ │ │ │ │ +00019560: 726f 6c6c 2062 6172 2074 6861 7420 6d6f roll bar that mo │ │ │ │ │ +00019570: 7665 7320 6173 2073 6372 6f6c 6c69 6e67 ves as scrolling │ │ │ │ │ +00019580: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ 00019590: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000195a0: 2020 2020 2020 6f63 6375 7273 292e 2020 occurs). │ │ │ │ │ -000195b0: 4578 616d 706c 653a 0a20 2020 2020 2020 Example:. │ │ │ │ │ +000195a0: 2020 2020 6f63 6375 7273 292e 2020 4578 occurs). Ex │ │ │ │ │ +000195b0: 616d 706c 653a 0a20 2020 2020 2020 2020 ample:. │ │ │ │ │ 000195c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000195d0: 2020 2020 2020 2020 2020 2020 2273 6372 "scr │ │ │ │ │ -000195e0: 6f6c 6c62 6172 5f74 6875 6d62 5f2a 2e70 ollbar_thumb_*.p │ │ │ │ │ -000195f0: 6e67 220a 2020 2020 2073 6372 6f6c 6c62 ng". scrollb │ │ │ │ │ -00019600: 6172 5f74 6875 6d62 5f6f 7665 726c 6179 ar_thumb_overlay │ │ │ │ │ -00019610: 2020 2020 2020 2049 6620 7468 6973 206f If this o │ │ │ │ │ -00019620: 7074 696f 6e20 6973 2073 6574 2074 6f20 ption is set to │ │ │ │ │ -00019630: 2274 7275 6522 0a20 2020 2020 2020 2020 "true". │ │ │ │ │ +000195d0: 2020 2020 2020 2020 2020 2273 6372 6f6c "scrol │ │ │ │ │ +000195e0: 6c62 6172 5f74 6875 6d62 5f2a 2e70 6e67 lbar_thumb_*.png │ │ │ │ │ +000195f0: 220a 2020 2020 2073 6372 6f6c 6c62 6172 ". scrollbar │ │ │ │ │ +00019600: 5f74 6875 6d62 5f6f 7665 726c 6179 2020 _thumb_overlay │ │ │ │ │ +00019610: 2020 2020 2049 6620 7468 6973 206f 7074 If this opt │ │ │ │ │ +00019620: 696f 6e20 6973 2073 6574 2074 6f20 2274 ion is set to "t │ │ │ │ │ +00019630: 7275 6522 0a20 2020 2020 2020 2020 2020 rue". │ │ │ │ │ 00019640: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019650: 2020 2020 2020 2020 2020 7468 656e 2074 then t │ │ │ │ │ -00019660: 6865 2073 6372 6f6c 6c62 6172 2074 6875 he scrollbar thu │ │ │ │ │ -00019670: 6d62 2073 6964 650a 2020 2020 2020 2020 mb side. │ │ │ │ │ +00019650: 2020 2020 2020 2020 7468 656e 2074 6865 then the │ │ │ │ │ +00019660: 2073 6372 6f6c 6c62 6172 2074 6875 6d62 scrollbar thumb │ │ │ │ │ +00019670: 2073 6964 650a 2020 2020 2020 2020 2020 side. │ │ │ │ │ 00019680: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019690: 2020 2020 2020 2020 2020 2073 6c69 6365 slice │ │ │ │ │ -000196a0: 7320 2865 7665 7279 2073 6c69 6365 2065 s (every slice e │ │ │ │ │ -000196b0: 7863 6570 7420 7468 650a 2020 2020 2020 xcept the. │ │ │ │ │ +00019690: 2020 2020 2020 2020 2073 6c69 6365 7320 slices │ │ │ │ │ +000196a0: 2865 7665 7279 2073 6c69 6365 2065 7863 (every slice exc │ │ │ │ │ +000196b0: 6570 7420 7468 650a 2020 2020 2020 2020 ept the. │ │ │ │ │ 000196c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000196d0: 2020 2020 2020 2020 2020 2020 2063 656e cen │ │ │ │ │ -000196e0: 7465 7220 736c 6963 6529 2077 696c 6c20 ter slice) will │ │ │ │ │ -000196f0: 6f76 6572 6c61 7920 7468 650a 2020 2020 overlay the. │ │ │ │ │ +000196d0: 2020 2020 2020 2020 2020 2063 656e 7465 cente │ │ │ │ │ +000196e0: 7220 736c 6963 6529 2077 696c 6c20 6f76 r slice) will ov │ │ │ │ │ +000196f0: 6572 6c61 7920 7468 650a 2020 2020 2020 erlay the. │ │ │ │ │ 00019700: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019710: 2020 2020 2020 2020 2020 2020 2020 2073 s │ │ │ │ │ -00019720: 6372 6f6c 6c62 6172 2066 7261 6d65 2073 crollbar frame s │ │ │ │ │ -00019730: 6964 6520 736c 6963 6573 2e20 2041 6e64 ide slices. And │ │ │ │ │ -00019740: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +00019710: 2020 2020 2020 2020 2020 2020 2073 6372 scr │ │ │ │ │ +00019720: 6f6c 6c62 6172 2066 7261 6d65 2073 6964 ollbar frame sid │ │ │ │ │ +00019730: 6520 736c 6963 6573 2e20 2041 6e64 0a20 e slices. And. │ │ │ │ │ +00019740: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00019750: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019760: 2020 2020 7468 6520 6365 6e74 6572 2073 the center s │ │ │ │ │ -00019770: 6c69 6365 206f 6620 7468 650a 2020 2020 lice of the. │ │ │ │ │ +00019760: 2020 7468 6520 6365 6e74 6572 2073 6c69 the center sli │ │ │ │ │ +00019770: 6365 206f 6620 7468 650a 2020 2020 2020 ce of the. │ │ │ │ │ 00019780: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019790: 2020 2020 2020 2020 2020 2020 2020 2073 s │ │ │ │ │ -000197a0: 6372 6f6c 6c62 6172 5f74 6875 6d62 2063 crollbar_thumb c │ │ │ │ │ -000197b0: 616e 206d 6f76 6520 616c 6c20 7468 650a an move all the. │ │ │ │ │ +00019790: 2020 2020 2020 2020 2020 2020 2073 6372 scr │ │ │ │ │ +000197a0: 6f6c 6c62 6172 5f74 6875 6d62 2063 616e ollbar_thumb can │ │ │ │ │ +000197b0: 206d 6f76 6520 616c 6c20 7468 650a 2020 move all the. │ │ │ │ │ 000197c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000197d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000197e0: 2020 2077 6179 2028 6672 6f6d 2074 6f70 way (from top │ │ │ │ │ -000197f0: 2074 6f20 626f 7474 6f6d 292c 2062 6569 to bottom), bei │ │ │ │ │ -00019800: 6e67 0a20 2020 2020 2020 2020 2020 2020 ng. │ │ │ │ │ +000197e0: 2077 6179 2028 6672 6f6d 2074 6f70 2074 way (from top t │ │ │ │ │ +000197f0: 6f20 626f 7474 6f6d 292c 2062 6569 6e67 o bottom), being │ │ │ │ │ +00019800: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ 00019810: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019820: 2020 2020 2020 6472 6177 6e20 6f6e 2074 drawn on t │ │ │ │ │ -00019830: 6865 2063 656e 7465 7220 736c 6963 6520 he center slice │ │ │ │ │ -00019840: 6f66 2074 6865 0a20 2020 2020 2020 2020 of the. │ │ │ │ │ +00019820: 2020 2020 6472 6177 6e20 6f6e 2074 6865 drawn on the │ │ │ │ │ +00019830: 2063 656e 7465 7220 736c 6963 6520 6f66 center slice of │ │ │ │ │ +00019840: 2074 6865 0a20 2020 2020 2020 2020 2020 the. │ │ │ │ │ 00019850: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019860: 2020 2020 2020 2020 2020 7363 726f 6c6c scroll │ │ │ │ │ -00019870: 6261 7220 6672 616d 652e 2020 5468 6174 bar frame. That │ │ │ │ │ -00019880: 2077 6179 2077 6520 6361 6e0a 2020 2020 way we can. │ │ │ │ │ +00019860: 2020 2020 2020 2020 7363 726f 6c6c 6261 scrollba │ │ │ │ │ +00019870: 7220 6672 616d 652e 2020 5468 6174 2077 r frame. That w │ │ │ │ │ +00019880: 6179 2077 6520 6361 6e0a 2020 2020 2020 ay we can. │ │ │ │ │ 00019890: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000198a0: 2020 2020 2020 2020 2020 2020 2020 206d m │ │ │ │ │ -000198b0: 616b 6520 6120 7363 726f 6c6c 6261 7220 ake a scrollbar │ │ │ │ │ -000198c0: 7769 7468 2072 6f75 6e64 2d73 6861 7065 with round-shape │ │ │ │ │ -000198d0: 640a 2020 2020 2020 2020 2020 2020 2020 d. │ │ │ │ │ +000198a0: 2020 2020 2020 2020 2020 2020 206d 616b mak │ │ │ │ │ +000198b0: 6520 6120 7363 726f 6c6c 6261 7220 7769 e a scrollbar wi │ │ │ │ │ +000198c0: 7468 2072 6f75 6e64 2d73 6861 7065 640a th round-shaped. │ │ │ │ │ +000198d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000198e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000198f0: 2020 2020 2065 6467 6573 2073 6f20 7468 edges so th │ │ │ │ │ -00019900: 6572 6520 776f 6e27 7420 6265 2061 2066 ere won't be a f │ │ │ │ │ -00019910: 7265 650a 2020 2020 2020 2020 2020 2020 ree. │ │ │ │ │ +000198f0: 2020 2065 6467 6573 2073 6f20 7468 6572 edges so ther │ │ │ │ │ +00019900: 6520 776f 6e27 7420 6265 2061 2066 7265 e won't be a fre │ │ │ │ │ +00019910: 650a 2020 2020 2020 2020 2020 2020 2020 e. │ │ │ │ │ 00019920: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019930: 2020 2020 2020 2073 7061 6365 2066 726f space fro │ │ │ │ │ -00019940: 6d20 7468 6520 7468 756d 6220 746f 2074 m the thumb to t │ │ │ │ │ -00019950: 6865 2066 7261 6d65 0a20 2020 2020 2020 he frame. │ │ │ │ │ +00019930: 2020 2020 2073 7061 6365 2066 726f 6d20 space from │ │ │ │ │ +00019940: 7468 6520 7468 756d 6220 746f 2074 6865 the thumb to the │ │ │ │ │ +00019950: 2066 7261 6d65 0a20 2020 2020 2020 2020 frame. │ │ │ │ │ 00019960: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019970: 2020 2020 2020 2020 2020 2020 696e 2074 in t │ │ │ │ │ -00019980: 6f70 2061 6e64 2062 6f74 746f 6d20 7363 op and bottom sc │ │ │ │ │ -00019990: 726f 6c6c 6261 720a 2020 2020 2020 2020 rollbar. │ │ │ │ │ +00019970: 2020 2020 2020 2020 2020 696e 2074 6f70 in top │ │ │ │ │ +00019980: 2061 6e64 2062 6f74 746f 6d20 7363 726f and bottom scro │ │ │ │ │ +00019990: 6c6c 6261 720a 2020 2020 2020 2020 2020 llbar. │ │ │ │ │ 000199a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000199b0: 2020 2020 2020 2020 2020 2070 6f73 6974 posit │ │ │ │ │ -000199c0: 696f 6e73 2e20 2044 6566 6175 6c74 2069 ions. Default i │ │ │ │ │ -000199d0: 7320 2266 616c 7365 222e 0a20 2020 2020 s "false".. │ │ │ │ │ -000199e0: 7363 726f 6c6c 6261 725f 736c 6963 6520 scrollbar_slice │ │ │ │ │ -000199f0: 2020 2020 2020 2020 2020 2020 2020 5468 Th │ │ │ │ │ -00019a00: 6520 6d65 6e75 2066 7261 6d65 2073 7479 e menu frame sty │ │ │ │ │ -00019a10: 6c65 6420 626f 7827 7320 736c 6963 650a led box's slice. │ │ │ │ │ +000199b0: 2020 2020 2020 2020 2070 6f73 6974 696f positio │ │ │ │ │ +000199c0: 6e73 2e20 2044 6566 6175 6c74 2069 7320 ns. Default is │ │ │ │ │ +000199d0: 2266 616c 7365 222e 0a20 2020 2020 7363 "false".. sc │ │ │ │ │ +000199e0: 726f 6c6c 6261 725f 736c 6963 6520 2020 rollbar_slice │ │ │ │ │ +000199f0: 2020 2020 2020 2020 2020 2020 5468 6520 The │ │ │ │ │ +00019a00: 6d65 6e75 2066 7261 6d65 2073 7479 6c65 menu frame style │ │ │ │ │ +00019a10: 6420 626f 7827 7320 736c 6963 650a 2020 d box's slice. │ │ │ │ │ 00019a20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00019a30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019a40: 2020 2069 6e20 7768 6963 6820 7468 6520 in which the │ │ │ │ │ -00019a50: 7363 726f 6c6c 6261 7220 7769 6c6c 2062 scrollbar will b │ │ │ │ │ -00019a60: 650a 2020 2020 2020 2020 2020 2020 2020 e. │ │ │ │ │ +00019a40: 2069 6e20 7768 6963 6820 7468 6520 7363 in which the sc │ │ │ │ │ +00019a50: 726f 6c6c 6261 7220 7769 6c6c 2062 650a rollbar will be. │ │ │ │ │ +00019a60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00019a70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019a80: 2020 2020 2064 7261 776e 2e20 2050 6f73 drawn. Pos │ │ │ │ │ -00019a90: 7369 626c 6520 7661 6c75 6573 2061 7265 sible values are │ │ │ │ │ -00019aa0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +00019a80: 2020 2064 7261 776e 2e20 2050 6f73 7369 drawn. Possi │ │ │ │ │ +00019a90: 626c 6520 7661 6c75 6573 2061 7265 0a20 ble values are. │ │ │ │ │ +00019aa0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00019ab0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019ac0: 2020 2020 2277 6573 7422 2c20 2263 656e "west", "cen │ │ │ │ │ -00019ad0: 7465 7222 2c20 2265 6173 7422 0a20 2020 ter", "east". │ │ │ │ │ +00019ac0: 2020 2277 6573 7422 2c20 2263 656e 7465 "west", "cente │ │ │ │ │ +00019ad0: 7222 2c20 2265 6173 7422 0a20 2020 2020 r", "east". │ │ │ │ │ 00019ae0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019af0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019b00: 2864 6566 6175 6c74 292e 2020 2277 6573 (default). "wes │ │ │ │ │ -00019b10: 7422 202d 2074 6865 2073 6372 6f6c 6c62 t" - the scrollb │ │ │ │ │ -00019b20: 6172 0a20 2020 2020 2020 2020 2020 2020 ar. │ │ │ │ │ +00019af0: 2020 2020 2020 2020 2020 2020 2020 2864 (d │ │ │ │ │ +00019b00: 6566 6175 6c74 292e 2020 2277 6573 7422 efault). "west" │ │ │ │ │ +00019b10: 202d 2074 6865 2073 6372 6f6c 6c62 6172 - the scrollbar │ │ │ │ │ +00019b20: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ 00019b30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019b40: 2020 2020 2020 7769 6c6c 2062 6520 6472 will be dr │ │ │ │ │ -00019b50: 6177 6e20 696e 2074 6865 2077 6573 7420 awn in the west │ │ │ │ │ -00019b60: 736c 6963 650a 2020 2020 2020 2020 2020 slice. │ │ │ │ │ +00019b40: 2020 2020 7769 6c6c 2062 6520 6472 6177 will be draw │ │ │ │ │ +00019b50: 6e20 696e 2074 6865 2077 6573 7420 736c n in the west sl │ │ │ │ │ +00019b60: 6963 650a 2020 2020 2020 2020 2020 2020 ice. │ │ │ │ │ 00019b70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019b80: 2020 2020 2020 2020 2028 7269 6768 742d (right- │ │ │ │ │ -00019b90: 616c 6967 6e65 6429 2e20 2022 6561 7374 aligned). "east │ │ │ │ │ -00019ba0: 2220 2d20 7468 650a 2020 2020 2020 2020 " - the. │ │ │ │ │ +00019b80: 2020 2020 2020 2028 7269 6768 742d 616c (right-al │ │ │ │ │ +00019b90: 6967 6e65 6429 2e20 2022 6561 7374 2220 igned). "east" │ │ │ │ │ +00019ba0: 2d20 7468 650a 2020 2020 2020 2020 2020 - the. │ │ │ │ │ 00019bb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019bc0: 2020 2020 2020 2020 2020 2073 6372 6f6c scrol │ │ │ │ │ -00019bd0: 6c62 6172 2077 696c 6c20 6265 2064 7261 lbar will be dra │ │ │ │ │ -00019be0: 776e 2069 6e20 7468 650a 2020 2020 2020 wn in the. │ │ │ │ │ +00019bc0: 2020 2020 2020 2020 2073 6372 6f6c 6c62 scrollb │ │ │ │ │ +00019bd0: 6172 2077 696c 6c20 6265 2064 7261 776e ar will be drawn │ │ │ │ │ +00019be0: 2069 6e20 7468 650a 2020 2020 2020 2020 in the. │ │ │ │ │ 00019bf0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019c00: 2020 2020 2020 2020 2020 2020 2065 6173 eas │ │ │ │ │ -00019c10: 7420 736c 6963 6520 286c 6566 742d 616c t slice (left-al │ │ │ │ │ -00019c20: 6967 6e65 6429 2e0a 2020 2020 2020 2020 igned).. │ │ │ │ │ +00019c00: 2020 2020 2020 2020 2020 2065 6173 7420 east │ │ │ │ │ +00019c10: 736c 6963 6520 286c 6566 742d 616c 6967 slice (left-alig │ │ │ │ │ +00019c20: 6e65 6429 2e0a 2020 2020 2020 2020 2020 ned).. │ │ │ │ │ 00019c30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019c40: 2020 2020 2020 2020 2020 2022 6365 6e74 "cent │ │ │ │ │ -00019c50: 6572 2220 2d20 7468 6520 7363 726f 6c6c er" - the scroll │ │ │ │ │ -00019c60: 6261 7220 7769 6c6c 2062 650a 2020 2020 bar will be. │ │ │ │ │ +00019c40: 2020 2020 2020 2020 2022 6365 6e74 6572 "center │ │ │ │ │ +00019c50: 2220 2d20 7468 6520 7363 726f 6c6c 6261 " - the scrollba │ │ │ │ │ +00019c60: 7220 7769 6c6c 2062 650a 2020 2020 2020 r will be. │ │ │ │ │ 00019c70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019c80: 2020 2020 2020 2020 2020 2020 2020 2064 d │ │ │ │ │ -00019c90: 7261 776e 2069 6e20 7468 6520 6365 6e74 rawn in the cent │ │ │ │ │ -00019ca0: 6572 2073 6c69 6365 2e20 204e 6f74 653a er slice. Note: │ │ │ │ │ -00019cb0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +00019c80: 2020 2020 2020 2020 2020 2020 2064 7261 dra │ │ │ │ │ +00019c90: 776e 2069 6e20 7468 6520 6365 6e74 6572 wn in the center │ │ │ │ │ +00019ca0: 2073 6c69 6365 2e20 204e 6f74 653a 0a20 slice. Note:. │ │ │ │ │ +00019cb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00019cc0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019cd0: 2020 2020 696e 2063 6173 6520 6f66 2022 in case of " │ │ │ │ │ -00019ce0: 6365 6e74 6572 2220 736c 6963 653a 2061 center" slice: a │ │ │ │ │ -00019cf0: 2920 4966 0a20 2020 2020 2020 2020 2020 ) If. │ │ │ │ │ +00019cd0: 2020 696e 2063 6173 6520 6f66 2022 6365 in case of "ce │ │ │ │ │ +00019ce0: 6e74 6572 2220 736c 6963 653a 2061 2920 nter" slice: a) │ │ │ │ │ +00019cf0: 4966 0a20 2020 2020 2020 2020 2020 2020 If. │ │ │ │ │ 00019d00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019d10: 2020 2020 2020 2020 7468 6520 7363 726f the scro │ │ │ │ │ -00019d20: 6c6c 6261 7220 7368 6f75 6c64 2062 6520 llbar should be │ │ │ │ │ -00019d30: 6472 6177 6e20 7468 656e 0a20 2020 2020 drawn then. │ │ │ │ │ +00019d10: 2020 2020 2020 7468 6520 7363 726f 6c6c the scroll │ │ │ │ │ +00019d20: 6261 7220 7368 6f75 6c64 2062 6520 6472 bar should be dr │ │ │ │ │ +00019d30: 6177 6e20 7468 656e 0a20 2020 2020 2020 awn then. │ │ │ │ │ 00019d40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019d50: 2020 2020 2020 2020 2020 2020 2020 626f bo │ │ │ │ │ -00019d60: 6f74 206d 656e 7520 656e 7472 7927 7320 ot menu entry's │ │ │ │ │ -00019d70: 7769 6474 6820 6973 0a20 2020 2020 2020 width is. │ │ │ │ │ +00019d50: 2020 2020 2020 2020 2020 2020 626f 6f74 boot │ │ │ │ │ +00019d60: 206d 656e 7520 656e 7472 7927 7320 7769 menu entry's wi │ │ │ │ │ +00019d70: 6474 6820 6973 0a20 2020 2020 2020 2020 dth is. │ │ │ │ │ 00019d80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019d90: 2020 2020 2020 2020 2020 2020 6465 6372 decr │ │ │ │ │ -00019da0: 6561 7365 6420 6279 2074 6865 2073 6372 eased by the scr │ │ │ │ │ -00019db0: 6f6c 6c62 6172 2773 2077 6964 7468 0a20 ollbar's width. │ │ │ │ │ +00019d90: 2020 2020 2020 2020 2020 6465 6372 6561 decrea │ │ │ │ │ +00019da0: 7365 6420 6279 2074 6865 2073 6372 6f6c sed by the scrol │ │ │ │ │ +00019db0: 6c62 6172 2773 2077 6964 7468 0a20 2020 lbar's width. │ │ │ │ │ 00019dc0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00019dd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019de0: 2020 616e 6420 7468 6520 7363 726f 6c6c and the scroll │ │ │ │ │ -00019df0: 6261 7220 6973 2064 7261 776e 2061 7420 bar is drawn at │ │ │ │ │ -00019e00: 7468 650a 2020 2020 2020 2020 2020 2020 the. │ │ │ │ │ +00019de0: 616e 6420 7468 6520 7363 726f 6c6c 6261 and the scrollba │ │ │ │ │ +00019df0: 7220 6973 2064 7261 776e 2061 7420 7468 r is drawn at th │ │ │ │ │ +00019e00: 650a 2020 2020 2020 2020 2020 2020 2020 e. │ │ │ │ │ 00019e10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019e20: 2020 2020 2020 2072 6967 6874 2073 6964 right sid │ │ │ │ │ -00019e30: 6520 6f66 2074 6865 2063 656e 7465 7220 e of the center │ │ │ │ │ -00019e40: 736c 6963 652e 0a20 2020 2020 2020 2020 slice.. │ │ │ │ │ +00019e20: 2020 2020 2072 6967 6874 2073 6964 6520 right side │ │ │ │ │ +00019e30: 6f66 2074 6865 2063 656e 7465 7220 736c of the center sl │ │ │ │ │ +00019e40: 6963 652e 0a20 2020 2020 2020 2020 2020 ice.. │ │ │ │ │ 00019e50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019e60: 2020 2020 2020 2020 2020 6229 2049 6620 b) If │ │ │ │ │ -00019e70: 7468 6520 7363 726f 6c6c 6261 7220 776f the scrollbar wo │ │ │ │ │ -00019e80: 6e27 7420 6265 2064 7261 776e 0a20 2020 n't be drawn. │ │ │ │ │ +00019e60: 2020 2020 2020 2020 6229 2049 6620 7468 b) If th │ │ │ │ │ +00019e70: 6520 7363 726f 6c6c 6261 7220 776f 6e27 e scrollbar won' │ │ │ │ │ +00019e80: 7420 6265 2064 7261 776e 0a20 2020 2020 t be drawn. │ │ │ │ │ 00019e90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019ea0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019eb0: 7468 656e 2074 6865 2062 6f6f 7420 6d65 then the boot me │ │ │ │ │ -00019ec0: 6e75 2065 6e74 7279 2773 2077 6964 7468 nu entry's width │ │ │ │ │ -00019ed0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +00019ea0: 2020 2020 2020 2020 2020 2020 2020 7468 th │ │ │ │ │ +00019eb0: 656e 2074 6865 2062 6f6f 7420 6d65 6e75 en the boot menu │ │ │ │ │ +00019ec0: 2065 6e74 7279 2773 2077 6964 7468 0a20 entry's width. │ │ │ │ │ +00019ed0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00019ee0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019ef0: 2020 2020 6973 2074 6865 2077 6964 7468 is the width │ │ │ │ │ -00019f00: 206f 6620 7468 6520 6365 6e74 6572 2073 of the center s │ │ │ │ │ -00019f10: 6c69 6365 2e0a 2020 2020 2020 2020 2020 lice.. │ │ │ │ │ +00019ef0: 2020 6973 2074 6865 2077 6964 7468 206f is the width o │ │ │ │ │ +00019f00: 6620 7468 6520 6365 6e74 6572 2073 6c69 f the center sli │ │ │ │ │ +00019f10: 6365 2e0a 2020 2020 2020 2020 2020 2020 ce.. │ │ │ │ │ 00019f20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019f30: 2020 2020 2020 2020 2063 2920 5765 2064 c) We d │ │ │ │ │ -00019f40: 6f6e 2774 206e 6563 6573 7361 7279 206e on't necessary n │ │ │ │ │ -00019f50: 6565 6420 7468 650a 2020 2020 2020 2020 eed the. │ │ │ │ │ +00019f30: 2020 2020 2020 2063 2920 5765 2064 6f6e c) We don │ │ │ │ │ +00019f40: 2774 206e 6563 6573 7361 7279 206e 6565 't necessary nee │ │ │ │ │ +00019f50: 6420 7468 650a 2020 2020 2020 2020 2020 d the. │ │ │ │ │ 00019f60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019f70: 2020 2020 2020 2020 2020 206d 656e 7520 menu │ │ │ │ │ -00019f80: 7069 786d 6170 2062 6f78 2074 6f20 6469 pixmap box to di │ │ │ │ │ -00019f90: 7370 6c61 7920 7468 650a 2020 2020 2020 splay the. │ │ │ │ │ +00019f70: 2020 2020 2020 2020 206d 656e 7520 7069 menu pi │ │ │ │ │ +00019f80: 786d 6170 2062 6f78 2074 6f20 6469 7370 xmap box to disp │ │ │ │ │ +00019f90: 6c61 7920 7468 650a 2020 2020 2020 2020 lay the. │ │ │ │ │ 00019fa0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019fb0: 2020 2020 2020 2020 2020 2020 2073 6372 scr │ │ │ │ │ -00019fc0: 6f6c 6c62 6172 2e0a 2020 2020 2073 6372 ollbar.. scr │ │ │ │ │ -00019fd0: 6f6c 6c62 6172 5f6c 6566 745f 7061 6420 ollbar_left_pad │ │ │ │ │ -00019fe0: 2020 2020 2020 2020 2020 2054 6865 206c The l │ │ │ │ │ -00019ff0: 6566 7420 7363 726f 6c6c 6261 7220 7061 eft scrollbar pa │ │ │ │ │ -0001a000: 6464 696e 6720 696e 0a20 2020 2020 2020 dding in. │ │ │ │ │ +00019fb0: 2020 2020 2020 2020 2020 2073 6372 6f6c scrol │ │ │ │ │ +00019fc0: 6c62 6172 2e0a 2020 2020 2073 6372 6f6c lbar.. scrol │ │ │ │ │ +00019fd0: 6c62 6172 5f6c 6566 745f 7061 6420 2020 lbar_left_pad │ │ │ │ │ +00019fe0: 2020 2020 2020 2020 2054 6865 206c 6566 The lef │ │ │ │ │ +00019ff0: 7420 7363 726f 6c6c 6261 7220 7061 6464 t scrollbar padd │ │ │ │ │ +0001a000: 696e 6720 696e 0a20 2020 2020 2020 2020 ing in. │ │ │ │ │ 0001a010: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0001a020: 2020 2020 2020 2020 2020 2020 7069 7865 pixe │ │ │ │ │ -0001a030: 6c73 2e20 2055 6e75 7365 6420 6966 0a20 ls. Unused if. │ │ │ │ │ +0001a020: 2020 2020 2020 2020 2020 7069 7865 6c73 pixels │ │ │ │ │ +0001a030: 2e20 2055 6e75 7365 6420 6966 0a20 2020 . Unused if. │ │ │ │ │ 0001a040: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0001a050: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0001a060: 2020 2273 6372 6f6c 6c62 6172 5f73 6c69 "scrollbar_sli │ │ │ │ │ -0001a070: 6365 2220 6973 2022 7765 7374 222e 0a20 ce" is "west".. │ │ │ │ │ -0001a080: 2020 2020 7363 726f 6c6c 6261 725f 7269 scrollbar_ri │ │ │ │ │ -0001a090: 6768 745f 7061 6420 2020 2020 2020 2020 ght_pad │ │ │ │ │ -0001a0a0: 2020 5468 6520 7269 6768 7420 7363 726f The right scro │ │ │ │ │ -0001a0b0: 6c6c 6261 7220 7061 6464 696e 6720 696e llbar padding in │ │ │ │ │ -0001a0c0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +0001a060: 2273 6372 6f6c 6c62 6172 5f73 6c69 6365 "scrollbar_slice │ │ │ │ │ +0001a070: 2220 6973 2022 7765 7374 222e 0a20 2020 " is "west".. │ │ │ │ │ +0001a080: 2020 7363 726f 6c6c 6261 725f 7269 6768 scrollbar_righ │ │ │ │ │ +0001a090: 745f 7061 6420 2020 2020 2020 2020 2020 t_pad │ │ │ │ │ +0001a0a0: 5468 6520 7269 6768 7420 7363 726f 6c6c The right scroll │ │ │ │ │ +0001a0b0: 6261 7220 7061 6464 696e 6720 696e 0a20 bar padding in. │ │ │ │ │ +0001a0c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0001a0d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0001a0e0: 2020 2020 7069 7865 6c73 2e20 2055 6e75 pixels. Unu │ │ │ │ │ -0001a0f0: 7365 6420 6966 0a20 2020 2020 2020 2020 sed if. │ │ │ │ │ +0001a0e0: 2020 7069 7865 6c73 2e20 2055 6e75 7365 pixels. Unuse │ │ │ │ │ +0001a0f0: 6420 6966 0a20 2020 2020 2020 2020 2020 d if. │ │ │ │ │ 0001a100: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0001a110: 2020 2020 2020 2020 2020 2273 6372 6f6c "scrol │ │ │ │ │ -0001a120: 6c62 6172 5f73 6c69 6365 2220 6973 2022 lbar_slice" is " │ │ │ │ │ -0001a130: 6561 7374 222e 0a20 2020 2020 7363 726f east".. scro │ │ │ │ │ -0001a140: 6c6c 6261 725f 746f 705f 7061 6420 2020 llbar_top_pad │ │ │ │ │ -0001a150: 2020 2020 2020 2020 2020 5468 6520 746f The to │ │ │ │ │ -0001a160: 7020 7363 726f 6c6c 6261 7220 7061 6464 p scrollbar padd │ │ │ │ │ -0001a170: 696e 6720 696e 0a20 2020 2020 2020 2020 ing in. │ │ │ │ │ +0001a110: 2020 2020 2020 2020 2273 6372 6f6c 6c62 "scrollb │ │ │ │ │ +0001a120: 6172 5f73 6c69 6365 2220 6973 2022 6561 ar_slice" is "ea │ │ │ │ │ +0001a130: 7374 222e 0a20 2020 2020 7363 726f 6c6c st".. scroll │ │ │ │ │ +0001a140: 6261 725f 746f 705f 7061 6420 2020 2020 bar_top_pad │ │ │ │ │ +0001a150: 2020 2020 2020 2020 5468 6520 746f 7020 The top │ │ │ │ │ +0001a160: 7363 726f 6c6c 6261 7220 7061 6464 696e scrollbar paddin │ │ │ │ │ +0001a170: 6720 696e 0a20 2020 2020 2020 2020 2020 g in. │ │ │ │ │ 0001a180: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0001a190: 2020 2020 2020 2020 2020 7069 7865 6c73 pixels │ │ │ │ │ -0001a1a0: 2e0a 2020 2020 2073 6372 6f6c 6c62 6172 .. scrollbar │ │ │ │ │ -0001a1b0: 5f62 6f74 746f 6d5f 7061 6420 2020 2020 _bottom_pad │ │ │ │ │ -0001a1c0: 2020 2020 2054 6865 2062 6f74 746f 6d20 The bottom │ │ │ │ │ -0001a1d0: 7363 726f 6c6c 6261 7220 7061 6464 696e scrollbar paddin │ │ │ │ │ -0001a1e0: 6720 696e 0a20 2020 2020 2020 2020 2020 g in. │ │ │ │ │ +0001a190: 2020 2020 2020 2020 7069 7865 6c73 2e0a pixels.. │ │ │ │ │ +0001a1a0: 2020 2020 2073 6372 6f6c 6c62 6172 5f62 scrollbar_b │ │ │ │ │ +0001a1b0: 6f74 746f 6d5f 7061 6420 2020 2020 2020 ottom_pad │ │ │ │ │ +0001a1c0: 2020 2054 6865 2062 6f74 746f 6d20 7363 The bottom sc │ │ │ │ │ +0001a1d0: 726f 6c6c 6261 7220 7061 6464 696e 6720 rollbar padding │ │ │ │ │ +0001a1e0: 696e 0a20 2020 2020 2020 2020 2020 2020 in. │ │ │ │ │ 0001a1f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0001a200: 2020 2020 2020 2020 7069 7865 6c73 2e0a pixels.. │ │ │ │ │ -0001a210: 2020 2020 2076 6973 6962 6c65 2020 2020 visible │ │ │ │ │ +0001a200: 2020 2020 2020 7069 7865 6c73 2e0a 2020 pixels.. │ │ │ │ │ +0001a210: 2020 2076 6973 6962 6c65 2020 2020 2020 visible │ │ │ │ │ 0001a220: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0001a230: 2020 2053 6574 2074 6f20 2266 616c 7365 Set to "false │ │ │ │ │ -0001a240: 2220 746f 2068 6964 6520 7468 6520 626f " to hide the bo │ │ │ │ │ -0001a250: 6f74 0a20 2020 2020 2020 2020 2020 2020 ot. │ │ │ │ │ +0001a230: 2053 6574 2074 6f20 2266 616c 7365 2220 Set to "false" │ │ │ │ │ +0001a240: 746f 2068 6964 6520 7468 6520 626f 6f74 to hide the boot │ │ │ │ │ +0001a250: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ 0001a260: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0001a270: 2020 2020 2020 6d65 6e75 2e0a 0a20 2020 menu... │ │ │ │ │ -0001a280: 2a20 6361 6e76 6173 2043 616e 7661 7320 * canvas Canvas │ │ │ │ │ -0001a290: 6973 2061 2063 6f6e 7461 696e 6572 2074 is a container t │ │ │ │ │ -0001a2a0: 6861 7420 616c 6c6f 7773 206d 616e 7561 hat allows manua │ │ │ │ │ -0001a2b0: 6c20 706c 6163 656d 656e 7420 6f66 0a20 l placement of. │ │ │ │ │ -0001a2c0: 2020 2020 636f 6d70 6f6e 656e 7473 2077 components w │ │ │ │ │ -0001a2d0: 6974 6869 6e20 6974 2e20 2049 7420 646f ithin it. It do │ │ │ │ │ -0001a2e0: 6573 206e 6f74 2061 6c74 6572 2074 6865 es not alter the │ │ │ │ │ -0001a2f0: 2070 6f73 6974 696f 6e73 206f 6620 6974 positions of it │ │ │ │ │ -0001a300: 7320 6368 696c 640a 2020 2020 2063 6f6d s child. com │ │ │ │ │ -0001a310: 706f 6e65 6e74 732e 2020 4974 2061 7373 ponents. It ass │ │ │ │ │ -0001a320: 6967 6e73 2061 6c6c 2063 6869 6c64 2063 igns all child c │ │ │ │ │ -0001a330: 6f6d 706f 6e65 6e74 7320 7468 6569 7220 omponents their │ │ │ │ │ -0001a340: 7072 6566 6572 7265 6420 7369 7a65 732e preferred sizes. │ │ │ │ │ -0001a350: 0a0a 2020 202a 2068 626f 7820 5468 6520 .. * hbox The │ │ │ │ │ -0001a360: 2a68 626f 782a 2063 6f6e 7461 696e 6572 *hbox* container │ │ │ │ │ -0001a370: 206c 6179 7320 6f75 7420 6974 7320 6368 lays out its ch │ │ │ │ │ -0001a380: 696c 6472 656e 2066 726f 6d20 6c65 6674 ildren from left │ │ │ │ │ -0001a390: 2074 6f20 7269 6768 742c 0a20 2020 2020 to right,. │ │ │ │ │ -0001a3a0: 6769 7669 6e67 2065 6163 6820 6f6e 6520 giving each one │ │ │ │ │ -0001a3b0: 6974 7320 7072 6566 6572 7265 6420 7769 its preferred wi │ │ │ │ │ -0001a3c0: 6474 682e 2020 5468 6520 6865 6967 6874 dth. The height │ │ │ │ │ -0001a3d0: 206f 6620 6561 6368 2063 6869 6c64 2069 of each child i │ │ │ │ │ -0001a3e0: 730a 2020 2020 2073 6574 2074 6f20 7468 s. set to th │ │ │ │ │ -0001a3f0: 6520 6d61 7869 6d75 6d20 6f66 2074 6865 e maximum of the │ │ │ │ │ -0001a400: 2070 7265 6665 7272 6564 2068 6569 6768 preferred heigh │ │ │ │ │ -0001a410: 7473 206f 6620 616c 6c20 6368 696c 6472 ts of all childr │ │ │ │ │ -0001a420: 656e 2e0a 0a20 2020 2a20 7662 6f78 2054 en... * vbox T │ │ │ │ │ -0001a430: 6865 202a 7662 6f78 2a20 636f 6e74 6169 he *vbox* contai │ │ │ │ │ -0001a440: 6e65 7220 6c61 7973 206f 7574 2069 7473 ner lays out its │ │ │ │ │ -0001a450: 2063 6869 6c64 7265 6e20 6672 6f6d 2074 children from t │ │ │ │ │ -0001a460: 6f70 2074 6f20 626f 7474 6f6d 2c0a 2020 op to bottom,. │ │ │ │ │ -0001a470: 2020 2067 6976 696e 6720 6561 6368 206f giving each o │ │ │ │ │ -0001a480: 6e65 2069 7473 2070 7265 6665 7272 6564 ne its preferred │ │ │ │ │ -0001a490: 2068 6569 6768 742e 2020 5468 6520 7769 height. The wi │ │ │ │ │ -0001a4a0: 6474 6820 6f66 2065 6163 6820 6368 696c dth of each chil │ │ │ │ │ -0001a4b0: 6420 6973 0a20 2020 2020 7365 7420 746f d is. set to │ │ │ │ │ -0001a4c0: 2074 6865 206d 6178 696d 756d 206f 6620 the maximum of │ │ │ │ │ -0001a4d0: 7468 6520 7072 6566 6572 7265 6420 7769 the preferred wi │ │ │ │ │ -0001a4e0: 6474 6873 206f 6620 616c 6c20 6368 696c dths of all chil │ │ │ │ │ -0001a4f0: 6472 656e 2e0a 0a37 2e33 2e36 2043 6f6d dren...7.3.6 Com │ │ │ │ │ -0001a500: 6d6f 6e20 7072 6f70 6572 7469 6573 0a2d mon properties.- │ │ │ │ │ +0001a270: 2020 2020 6d65 6e75 2e0a 0a20 2020 2a20 menu... * │ │ │ │ │ +0001a280: 6361 6e76 6173 2043 616e 7661 7320 6973 canvas Canvas is │ │ │ │ │ +0001a290: 2061 2063 6f6e 7461 696e 6572 2074 6861 a container tha │ │ │ │ │ +0001a2a0: 7420 616c 6c6f 7773 206d 616e 7561 6c20 t allows manual │ │ │ │ │ +0001a2b0: 706c 6163 656d 656e 7420 6f66 0a20 2020 placement of. │ │ │ │ │ +0001a2c0: 2020 636f 6d70 6f6e 656e 7473 2077 6974 components wit │ │ │ │ │ +0001a2d0: 6869 6e20 6974 2e20 2049 7420 646f 6573 hin it. It does │ │ │ │ │ +0001a2e0: 206e 6f74 2061 6c74 6572 2074 6865 2070 not alter the p │ │ │ │ │ +0001a2f0: 6f73 6974 696f 6e73 206f 6620 6974 7320 ositions of its │ │ │ │ │ +0001a300: 6368 696c 640a 2020 2020 2063 6f6d 706f child. compo │ │ │ │ │ +0001a310: 6e65 6e74 732e 2020 4974 2061 7373 6967 nents. It assig │ │ │ │ │ +0001a320: 6e73 2061 6c6c 2063 6869 6c64 2063 6f6d ns all child com │ │ │ │ │ +0001a330: 706f 6e65 6e74 7320 7468 6569 7220 7072 ponents their pr │ │ │ │ │ +0001a340: 6566 6572 7265 6420 7369 7a65 732e 0a0a eferred sizes... │ │ │ │ │ +0001a350: 2020 202a 2068 626f 7820 5468 6520 2a68 * hbox The *h │ │ │ │ │ +0001a360: 626f 782a 2063 6f6e 7461 696e 6572 206c box* container l │ │ │ │ │ +0001a370: 6179 7320 6f75 7420 6974 7320 6368 696c ays out its chil │ │ │ │ │ +0001a380: 6472 656e 2066 726f 6d20 6c65 6674 2074 dren from left t │ │ │ │ │ +0001a390: 6f20 7269 6768 742c 0a20 2020 2020 6769 o right,. gi │ │ │ │ │ +0001a3a0: 7669 6e67 2065 6163 6820 6f6e 6520 6974 ving each one it │ │ │ │ │ +0001a3b0: 7320 7072 6566 6572 7265 6420 7769 6474 s preferred widt │ │ │ │ │ +0001a3c0: 682e 2020 5468 6520 6865 6967 6874 206f h. The height o │ │ │ │ │ +0001a3d0: 6620 6561 6368 2063 6869 6c64 2069 730a f each child is. │ │ │ │ │ +0001a3e0: 2020 2020 2073 6574 2074 6f20 7468 6520 set to the │ │ │ │ │ +0001a3f0: 6d61 7869 6d75 6d20 6f66 2074 6865 2070 maximum of the p │ │ │ │ │ +0001a400: 7265 6665 7272 6564 2068 6569 6768 7473 referred heights │ │ │ │ │ +0001a410: 206f 6620 616c 6c20 6368 696c 6472 656e of all children │ │ │ │ │ +0001a420: 2e0a 0a20 2020 2a20 7662 6f78 2054 6865 ... * vbox The │ │ │ │ │ +0001a430: 202a 7662 6f78 2a20 636f 6e74 6169 6e65 *vbox* containe │ │ │ │ │ +0001a440: 7220 6c61 7973 206f 7574 2069 7473 2063 r lays out its c │ │ │ │ │ +0001a450: 6869 6c64 7265 6e20 6672 6f6d 2074 6f70 hildren from top │ │ │ │ │ +0001a460: 2074 6f20 626f 7474 6f6d 2c0a 2020 2020 to bottom,. │ │ │ │ │ +0001a470: 2067 6976 696e 6720 6561 6368 206f 6e65 giving each one │ │ │ │ │ +0001a480: 2069 7473 2070 7265 6665 7272 6564 2068 its preferred h │ │ │ │ │ +0001a490: 6569 6768 742e 2020 5468 6520 7769 6474 eight. The widt │ │ │ │ │ +0001a4a0: 6820 6f66 2065 6163 6820 6368 696c 6420 h of each child │ │ │ │ │ +0001a4b0: 6973 0a20 2020 2020 7365 7420 746f 2074 is. set to t │ │ │ │ │ +0001a4c0: 6865 206d 6178 696d 756d 206f 6620 7468 he maximum of th │ │ │ │ │ +0001a4d0: 6520 7072 6566 6572 7265 6420 7769 6474 e preferred widt │ │ │ │ │ +0001a4e0: 6873 206f 6620 616c 6c20 6368 696c 6472 hs of all childr │ │ │ │ │ +0001a4f0: 656e 2e0a 0a37 2e33 2e36 2043 6f6d 6d6f en...7.3.6 Commo │ │ │ │ │ +0001a500: 6e20 7072 6f70 6572 7469 6573 0a2d 2d2d n properties.--- │ │ │ │ │ 0001a510: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0001a520: 2d2d 2d2d 2d2d 0a0a 5468 6520 666f 6c6c ------..The foll │ │ │ │ │ -0001a530: 6f77 696e 6720 7072 6f70 6572 7469 6573 owing properties │ │ │ │ │ -0001a540: 2061 7265 2073 7570 706f 7274 6564 2062 are supported b │ │ │ │ │ -0001a550: 7920 616c 6c20 636f 6d70 6f6e 656e 7473 y all components │ │ │ │ │ -0001a560: 3a0a 276c 6566 7427 0a20 2020 2020 5468 :.'left'. Th │ │ │ │ │ -0001a570: 6520 6469 7374 616e 6365 2066 726f 6d20 e distance from │ │ │ │ │ -0001a580: 7468 6520 6c65 6674 2062 6f72 6465 7220 the left border │ │ │ │ │ -0001a590: 6f66 2063 6f6e 7461 696e 6572 2074 6f20 of container to │ │ │ │ │ -0001a5a0: 6c65 6674 2062 6f72 6465 7220 6f66 0a20 left border of. │ │ │ │ │ -0001a5b0: 2020 2020 7468 6520 6f62 6a65 6374 2069 the object i │ │ │ │ │ -0001a5c0: 6e20 6569 7468 6572 206f 6620 7468 7265 n either of thre │ │ │ │ │ -0001a5d0: 6520 666f 726d 6174 733a 0a20 2020 2020 e formats:. │ │ │ │ │ -0001a5e0: 7820 2020 2020 2020 2020 2020 2020 2056 x V │ │ │ │ │ -0001a5f0: 616c 7565 2069 6e20 7069 7865 6c73 0a20 alue in pixels. │ │ │ │ │ -0001a600: 2020 2020 7025 2020 2020 2020 2020 2020 p% │ │ │ │ │ -0001a610: 2020 2050 6572 6365 6e74 6167 650a 2020 Percentage. │ │ │ │ │ -0001a620: 2020 2070 252b 7820 2020 2020 2020 2020 p%+x │ │ │ │ │ -0001a630: 2020 6d69 7874 7572 6520 6f66 2062 6f74 mixture of bot │ │ │ │ │ -0001a640: 680a 2774 6f70 270a 2020 2020 2054 6865 h.'top'. The │ │ │ │ │ -0001a650: 2064 6973 7461 6e63 6520 6672 6f6d 2074 distance from t │ │ │ │ │ -0001a660: 6865 206c 6566 7420 626f 7264 6572 206f he left border o │ │ │ │ │ -0001a670: 6620 636f 6e74 6169 6e65 7220 746f 206c f container to l │ │ │ │ │ -0001a680: 6566 7420 626f 7264 6572 206f 660a 2020 eft border of. │ │ │ │ │ -0001a690: 2020 2074 6865 206f 626a 6563 7420 696e the object in │ │ │ │ │ -0001a6a0: 2073 616d 6520 666f 726d 6174 2e0a 2777 same format..'w │ │ │ │ │ -0001a6b0: 6964 7468 270a 2020 2020 2054 6865 2077 idth'. The w │ │ │ │ │ -0001a6c0: 6964 7468 206f 6620 6f62 6a65 6374 2069 idth of object i │ │ │ │ │ -0001a6d0: 6e20 7361 6d65 2066 6f72 6d61 742e 0a27 n same format..' │ │ │ │ │ -0001a6e0: 6865 6967 6874 270a 2020 2020 2054 6865 height'. The │ │ │ │ │ -0001a6f0: 2068 6569 6768 7420 6f66 206f 626a 6563 height of objec │ │ │ │ │ -0001a700: 7420 696e 2073 616d 6520 666f 726d 6174 t in same format │ │ │ │ │ -0001a710: 2e0a 2769 6427 0a20 2020 2020 5468 6520 ..'id'. The │ │ │ │ │ -0001a720: 6964 656e 7469 6669 6572 2066 6f72 2074 identifier for t │ │ │ │ │ -0001a730: 6865 2063 6f6d 706f 6e65 6e74 2e20 2054 he component. T │ │ │ │ │ -0001a740: 6869 7320 6361 6e20 6265 2061 6e79 2061 his can be any a │ │ │ │ │ -0001a750: 7262 6974 7261 7279 0a20 2020 2020 7374 rbitrary. st │ │ │ │ │ -0001a760: 7269 6e67 2e20 2054 6865 2049 4420 6361 ring. The ID ca │ │ │ │ │ -0001a770: 6e20 6265 2075 7365 6420 6279 2073 6372 n be used by scr │ │ │ │ │ -0001a780: 6970 7473 2074 6f20 7265 6665 7220 746f ipts to refer to │ │ │ │ │ -0001a790: 2076 6172 696f 7573 0a20 2020 2020 636f various. co │ │ │ │ │ -0001a7a0: 6d70 6f6e 656e 7473 2069 6e20 7468 6520 mponents in the │ │ │ │ │ -0001a7b0: 4755 4920 636f 6d70 6f6e 656e 7420 7472 GUI component tr │ │ │ │ │ -0001a7c0: 6565 2e20 2043 7572 7265 6e74 6c79 2c20 ee. Currently, │ │ │ │ │ -0001a7d0: 7468 6572 6520 6973 206f 6e65 0a20 2020 there is one. │ │ │ │ │ -0001a7e0: 2020 7370 6563 6961 6c20 4944 2076 616c special ID val │ │ │ │ │ -0001a7f0: 7565 2074 6861 7420 4752 5542 2072 6563 ue that GRUB rec │ │ │ │ │ -0001a800: 6f67 6e69 7a65 733a 0a0a 2020 2020 2022 ognizes:.. " │ │ │ │ │ -0001a810: 5f5f 7469 6d65 6f75 745f 5f22 2020 436f __timeout__" Co │ │ │ │ │ -0001a820: 6d70 6f6e 656e 7420 7769 7468 2074 6869 mponent with thi │ │ │ │ │ -0001a830: 7320 4944 2077 696c 6c20 6265 2075 7064 s ID will be upd │ │ │ │ │ -0001a840: 6174 6564 2062 7920 4752 5542 0a20 2020 ated by GRUB. │ │ │ │ │ -0001a850: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0001a860: 2061 6e64 2077 696c 6c20 696e 6469 6361 and will indica │ │ │ │ │ -0001a870: 7465 2074 696d 6520 656c 6170 7365 6420 te time elapsed │ │ │ │ │ -0001a880: 746f 2061 6e20 6175 746f 6d61 7469 6361 to an automatica │ │ │ │ │ -0001a890: 6c0a 2020 2020 2020 2020 2020 2020 2020 l. │ │ │ │ │ -0001a8a0: 2020 2020 2020 626f 6f74 206f 6620 7468 boot of th │ │ │ │ │ -0001a8b0: 6520 6465 6661 756c 7420 656e 7472 792e e default entry. │ │ │ │ │ -0001a8c0: 2020 4166 6665 6374 6564 2063 6f6d 706f Affected compo │ │ │ │ │ -0001a8d0: 6e65 6e74 733a 0a20 2020 2020 2020 2020 nents:. │ │ │ │ │ -0001a8e0: 2020 2020 2020 2020 2020 2022 6c61 6265 "labe │ │ │ │ │ -0001a8f0: 6c22 2c20 2263 6972 6375 6c61 725f 7072 l", "circular_pr │ │ │ │ │ -0001a900: 6f67 7265 7373 222c 2022 7072 6f67 7265 ogress", "progre │ │ │ │ │ -0001a910: 7373 5f62 6172 222e 0a0a 1f0a 4669 6c65 ss_bar".....File │ │ │ │ │ -0001a920: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ -0001a930: 6465 3a20 4e65 7477 6f72 6b2c 2020 4e65 de: Network, Ne │ │ │ │ │ -0001a940: 7874 3a20 5365 7269 616c 2074 6572 6d69 xt: Serial termi │ │ │ │ │ -0001a950: 6e61 6c2c 2020 5072 6576 3a20 5468 656d nal, Prev: Them │ │ │ │ │ -0001a960: 6520 6669 6c65 2066 6f72 6d61 742c 2020 e file format, │ │ │ │ │ -0001a970: 5570 3a20 546f 700a 0a38 2042 6f6f 7469 Up: Top..8 Booti │ │ │ │ │ -0001a980: 6e67 2047 5255 4220 6672 6f6d 2074 6865 ng GRUB from the │ │ │ │ │ -0001a990: 206e 6574 776f 726b 0a2a 2a2a 2a2a 2a2a network.******* │ │ │ │ │ +0001a520: 2d2d 2d2d 0a0a 5468 6520 666f 6c6c 6f77 ----..The follow │ │ │ │ │ +0001a530: 696e 6720 7072 6f70 6572 7469 6573 2061 ing properties a │ │ │ │ │ +0001a540: 7265 2073 7570 706f 7274 6564 2062 7920 re supported by │ │ │ │ │ +0001a550: 616c 6c20 636f 6d70 6f6e 656e 7473 3a0a all components:. │ │ │ │ │ +0001a560: 276c 6566 7427 0a20 2020 2020 5468 6520 'left'. The │ │ │ │ │ +0001a570: 6469 7374 616e 6365 2066 726f 6d20 7468 distance from th │ │ │ │ │ +0001a580: 6520 6c65 6674 2062 6f72 6465 7220 6f66 e left border of │ │ │ │ │ +0001a590: 2063 6f6e 7461 696e 6572 2074 6f20 6c65 container to le │ │ │ │ │ +0001a5a0: 6674 2062 6f72 6465 7220 6f66 0a20 2020 ft border of. │ │ │ │ │ +0001a5b0: 2020 7468 6520 6f62 6a65 6374 2069 6e20 the object in │ │ │ │ │ +0001a5c0: 6569 7468 6572 206f 6620 7468 7265 6520 either of three │ │ │ │ │ +0001a5d0: 666f 726d 6174 733a 0a20 2020 2020 7820 formats:. x │ │ │ │ │ +0001a5e0: 2020 2020 2020 2020 2020 2020 2056 616c Val │ │ │ │ │ +0001a5f0: 7565 2069 6e20 7069 7865 6c73 0a20 2020 ue in pixels. │ │ │ │ │ +0001a600: 2020 7025 2020 2020 2020 2020 2020 2020 p% │ │ │ │ │ +0001a610: 2050 6572 6365 6e74 6167 650a 2020 2020 Percentage. │ │ │ │ │ +0001a620: 2070 252b 7820 2020 2020 2020 2020 2020 p%+x │ │ │ │ │ +0001a630: 6d69 7874 7572 6520 6f66 2062 6f74 680a mixture of both. │ │ │ │ │ +0001a640: 2774 6f70 270a 2020 2020 2054 6865 2064 'top'. The d │ │ │ │ │ +0001a650: 6973 7461 6e63 6520 6672 6f6d 2074 6865 istance from the │ │ │ │ │ +0001a660: 206c 6566 7420 626f 7264 6572 206f 6620 left border of │ │ │ │ │ +0001a670: 636f 6e74 6169 6e65 7220 746f 206c 6566 container to lef │ │ │ │ │ +0001a680: 7420 626f 7264 6572 206f 660a 2020 2020 t border of. │ │ │ │ │ +0001a690: 2074 6865 206f 626a 6563 7420 696e 2073 the object in s │ │ │ │ │ +0001a6a0: 616d 6520 666f 726d 6174 2e0a 2777 6964 ame format..'wid │ │ │ │ │ +0001a6b0: 7468 270a 2020 2020 2054 6865 2077 6964 th'. The wid │ │ │ │ │ +0001a6c0: 7468 206f 6620 6f62 6a65 6374 2069 6e20 th of object in │ │ │ │ │ +0001a6d0: 7361 6d65 2066 6f72 6d61 742e 0a27 6865 same format..'he │ │ │ │ │ +0001a6e0: 6967 6874 270a 2020 2020 2054 6865 2068 ight'. The h │ │ │ │ │ +0001a6f0: 6569 6768 7420 6f66 206f 626a 6563 7420 eight of object │ │ │ │ │ +0001a700: 696e 2073 616d 6520 666f 726d 6174 2e0a in same format.. │ │ │ │ │ +0001a710: 2769 6427 0a20 2020 2020 5468 6520 6964 'id'. The id │ │ │ │ │ +0001a720: 656e 7469 6669 6572 2066 6f72 2074 6865 entifier for the │ │ │ │ │ +0001a730: 2063 6f6d 706f 6e65 6e74 2e20 2054 6869 component. Thi │ │ │ │ │ +0001a740: 7320 6361 6e20 6265 2061 6e79 2061 7262 s can be any arb │ │ │ │ │ +0001a750: 6974 7261 7279 0a20 2020 2020 7374 7269 itrary. stri │ │ │ │ │ +0001a760: 6e67 2e20 2054 6865 2049 4420 6361 6e20 ng. The ID can │ │ │ │ │ +0001a770: 6265 2075 7365 6420 6279 2073 6372 6970 be used by scrip │ │ │ │ │ +0001a780: 7473 2074 6f20 7265 6665 7220 746f 2076 ts to refer to v │ │ │ │ │ +0001a790: 6172 696f 7573 0a20 2020 2020 636f 6d70 arious. comp │ │ │ │ │ +0001a7a0: 6f6e 656e 7473 2069 6e20 7468 6520 4755 onents in the GU │ │ │ │ │ +0001a7b0: 4920 636f 6d70 6f6e 656e 7420 7472 6565 I component tree │ │ │ │ │ +0001a7c0: 2e20 2043 7572 7265 6e74 6c79 2c20 7468 . Currently, th │ │ │ │ │ +0001a7d0: 6572 6520 6973 206f 6e65 0a20 2020 2020 ere is one. │ │ │ │ │ +0001a7e0: 7370 6563 6961 6c20 4944 2076 616c 7565 special ID value │ │ │ │ │ +0001a7f0: 2074 6861 7420 4752 5542 2072 6563 6f67 that GRUB recog │ │ │ │ │ +0001a800: 6e69 7a65 733a 0a0a 2020 2020 2022 5f5f nizes:.. "__ │ │ │ │ │ +0001a810: 7469 6d65 6f75 745f 5f22 2020 436f 6d70 timeout__" Comp │ │ │ │ │ +0001a820: 6f6e 656e 7420 7769 7468 2074 6869 7320 onent with this │ │ │ │ │ +0001a830: 4944 2077 696c 6c20 6265 2075 7064 6174 ID will be updat │ │ │ │ │ +0001a840: 6564 2062 7920 4752 5542 0a20 2020 2020 ed by GRUB. │ │ │ │ │ +0001a850: 2020 2020 2020 2020 2020 2020 2020 2061 a │ │ │ │ │ +0001a860: 6e64 2077 696c 6c20 696e 6469 6361 7465 nd will indicate │ │ │ │ │ +0001a870: 2074 696d 6520 656c 6170 7365 6420 746f time elapsed to │ │ │ │ │ +0001a880: 2061 6e20 6175 746f 6d61 7469 6361 6c0a an automatical. │ │ │ │ │ +0001a890: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0001a8a0: 2020 2020 626f 6f74 206f 6620 7468 6520 boot of the │ │ │ │ │ +0001a8b0: 6465 6661 756c 7420 656e 7472 792e 2020 default entry. │ │ │ │ │ +0001a8c0: 4166 6665 6374 6564 2063 6f6d 706f 6e65 Affected compone │ │ │ │ │ +0001a8d0: 6e74 733a 0a20 2020 2020 2020 2020 2020 nts:. │ │ │ │ │ +0001a8e0: 2020 2020 2020 2020 2022 6c61 6265 6c22 "label" │ │ │ │ │ +0001a8f0: 2c20 2263 6972 6375 6c61 725f 7072 6f67 , "circular_prog │ │ │ │ │ +0001a900: 7265 7373 222c 2022 7072 6f67 7265 7373 ress", "progress │ │ │ │ │ +0001a910: 5f62 6172 222e 0a0a 1f0a 4669 6c65 3a20 _bar".....File: │ │ │ │ │ +0001a920: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ +0001a930: 3a20 4e65 7477 6f72 6b2c 2020 4e65 7874 : Network, Next │ │ │ │ │ +0001a940: 3a20 5365 7269 616c 2074 6572 6d69 6e61 : Serial termina │ │ │ │ │ +0001a950: 6c2c 2020 5072 6576 3a20 5468 656d 6520 l, Prev: Theme │ │ │ │ │ +0001a960: 6669 6c65 2066 6f72 6d61 742c 2020 5570 file format, Up │ │ │ │ │ +0001a970: 3a20 546f 700a 0a38 2042 6f6f 7469 6e67 : Top..8 Booting │ │ │ │ │ +0001a980: 2047 5255 4220 6672 6f6d 2074 6865 206e GRUB from the n │ │ │ │ │ +0001a990: 6574 776f 726b 0a2a 2a2a 2a2a 2a2a 2a2a etwork.********* │ │ │ │ │ 0001a9a0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -0001a9b0: 2a2a 2a2a 2a2a 2a2a 0a0a 5468 6520 666f ********..The fo │ │ │ │ │ -0001a9c0: 6c6c 6f77 696e 6720 696e 7374 7275 6374 llowing instruct │ │ │ │ │ -0001a9d0: 696f 6e73 2064 6f6e 2774 2077 6f72 6b20 ions don't work │ │ │ │ │ -0001a9e0: 666f 7220 2a2d 656d 752c 2069 3338 362d for *-emu, i386- │ │ │ │ │ -0001a9f0: 7165 6d75 2c0a 6933 3836 2d63 6f72 6562 qemu,.i386-coreb │ │ │ │ │ -0001aa00: 6f6f 742c 2069 3338 362d 6d75 6c74 6962 oot, i386-multib │ │ │ │ │ -0001aa10: 6f6f 742c 206d 6970 735f 6c6f 6f6e 6773 oot, mips_loongs │ │ │ │ │ -0001aa20: 6f6e 2c20 6d69 7073 2d61 7263 2061 6e64 on, mips-arc and │ │ │ │ │ -0001aa30: 0a6d 6970 735f 7165 6d75 5f6d 6970 730a .mips_qemu_mips. │ │ │ │ │ -0001aa40: 0a20 2020 546f 2067 656e 6572 6174 6520 . To generate │ │ │ │ │ -0001aa50: 6120 6e65 7462 6f6f 7461 626c 6520 6469 a netbootable di │ │ │ │ │ -0001aa60: 7265 6374 6f72 792c 2072 756e 3a0a 0a20 rectory, run:.. │ │ │ │ │ -0001aa70: 2020 2020 6772 7562 2d6d 6b6e 6574 6469 grub-mknetdi │ │ │ │ │ -0001aa80: 7220 2d2d 6e65 742d 6469 7265 6374 6f72 r --net-director │ │ │ │ │ -0001aa90: 793d 2f73 7276 2f74 6674 7020 2d2d 7375 y=/srv/tftp --su │ │ │ │ │ -0001aaa0: 6264 6972 3d2f 626f 6f74 2f67 7275 6220 bdir=/boot/grub │ │ │ │ │ -0001aab0: 2d64 202f 7573 722f 6c69 622f 6772 7562 -d /usr/lib/grub │ │ │ │ │ -0001aac0: 2f3c 706c 6174 666f 726d 3e0a 0a20 2020 /.. │ │ │ │ │ -0001aad0: 452e 672e 2020 666f 7220 6933 3836 2d70 E.g. for i386-p │ │ │ │ │ -0001aae0: 633a 0a0a 2020 2020 2067 7275 622d 6d6b c:.. grub-mk │ │ │ │ │ -0001aaf0: 6e65 7464 6972 202d 2d6e 6574 2d64 6972 netdir --net-dir │ │ │ │ │ -0001ab00: 6563 746f 7279 3d2f 7372 762f 7466 7470 ectory=/srv/tftp │ │ │ │ │ -0001ab10: 202d 2d73 7562 6469 723d 2f62 6f6f 742f --subdir=/boot/ │ │ │ │ │ -0001ab20: 6772 7562 202d 6420 2f75 7372 2f6c 6962 grub -d /usr/lib │ │ │ │ │ -0001ab30: 2f67 7275 622f 6933 3836 2d70 630a 0a20 /grub/i386-pc.. │ │ │ │ │ -0001ab40: 2020 5468 656e 2066 6f6c 6c6f 7720 696e Then follow in │ │ │ │ │ -0001ab50: 7374 7275 6374 696f 6e73 2070 7269 6e74 structions print │ │ │ │ │ -0001ab60: 6564 206f 7574 2062 7920 6772 7562 2d6d ed out by grub-m │ │ │ │ │ -0001ab70: 6b6e 6574 6469 7220 6f6e 2063 6f6e 6669 knetdir on confi │ │ │ │ │ -0001ab80: 6775 7269 6e67 0a79 6f75 7220 4448 4350 guring.your DHCP │ │ │ │ │ -0001ab90: 2073 6572 7665 722e 0a0a 2020 2054 6865 server... The │ │ │ │ │ -0001aba0: 2067 7275 622e 6366 6720 6669 6c65 2069 grub.cfg file i │ │ │ │ │ -0001abb0: 7320 706c 6163 6564 2069 6e20 7468 6520 s placed in the │ │ │ │ │ -0001abc0: 7361 6d65 2064 6972 6563 746f 7279 2061 same directory a │ │ │ │ │ -0001abd0: 7320 7468 6520 7061 7468 206f 7574 7075 s the path outpu │ │ │ │ │ -0001abe0: 740a 6279 2067 7275 622d 6d6b 6e65 7464 t.by grub-mknetd │ │ │ │ │ -0001abf0: 6972 2068 6572 6561 6674 6572 2072 6566 ir hereafter ref │ │ │ │ │ -0001ac00: 6572 7265 6420 746f 2061 7320 4657 5041 erred to as FWPA │ │ │ │ │ -0001ac10: 5448 2e20 4752 5542 2077 696c 6c20 7365 TH. GRUB will se │ │ │ │ │ -0001ac20: 6172 6368 2066 6f72 0a69 7473 2063 6f6e arch for.its con │ │ │ │ │ -0001ac30: 6669 6775 7261 7469 6f6e 2066 696c 6573 figuration files │ │ │ │ │ -0001ac40: 2069 6e20 6f72 6465 7220 7573 696e 6720 in order using │ │ │ │ │ -0001ac50: 7468 6520 666f 6c6c 6f77 696e 6720 7275 the following ru │ │ │ │ │ -0001ac60: 6c65 7320 7768 6572 6520 7468 650a 6170 les where the.ap │ │ │ │ │ -0001ac70: 7065 6e64 6564 2076 616c 7565 2063 6f72 pended value cor │ │ │ │ │ -0001ac80: 7265 7370 6f6e 6473 2074 6f20 6120 7661 responds to a va │ │ │ │ │ -0001ac90: 6c75 6520 6f6e 2074 6865 2063 6c69 656e lue on the clien │ │ │ │ │ -0001aca0: 7420 6d61 6368 696e 652e 0a0a 2020 2020 t machine... │ │ │ │ │ -0001acb0: 2027 2846 5750 4154 4829 272f 6772 7562 '(FWPATH)'/grub │ │ │ │ │ -0001acc0: 2e63 6667 2d27 2855 5549 4420 4f46 204d .cfg-'(UUID OF M │ │ │ │ │ -0001acd0: 4143 4849 4e45 2927 0a20 2020 2020 2728 ACHINE)'. '( │ │ │ │ │ -0001ace0: 4657 5041 5448 2927 2f67 7275 622e 6366 FWPATH)'/grub.cf │ │ │ │ │ -0001acf0: 672d 2728 4d41 4320 4144 4452 4553 5320 g-'(MAC ADDRESS │ │ │ │ │ -0001ad00: 4f46 204e 4943 2927 0a20 2020 2020 2728 OF NIC)'. '( │ │ │ │ │ -0001ad10: 4657 5041 5448 2927 2f67 7275 622e 6366 FWPATH)'/grub.cf │ │ │ │ │ -0001ad20: 672d 2728 4950 7634 204f 5220 4950 7636 g-'(IPv4 OR IPv6 │ │ │ │ │ -0001ad30: 2041 4444 5245 5353 2927 0a20 2020 2020 ADDRESS)'. │ │ │ │ │ -0001ad40: 2728 4657 5041 5448 2927 2f67 7275 622e '(FWPATH)'/grub. │ │ │ │ │ -0001ad50: 6366 670a 0a20 2020 5468 6520 5555 4944 cfg.. The UUID │ │ │ │ │ -0001ad60: 2069 7320 7468 6520 436c 6965 6e74 204d is the Client M │ │ │ │ │ -0001ad70: 6163 6869 6e65 2049 6465 6e74 6966 6965 achine Identifie │ │ │ │ │ -0001ad80: 7220 4f70 7469 6f6e 2044 6566 696e 6974 r Option Definit │ │ │ │ │ -0001ad90: 696f 6e20 6173 0a73 7065 6369 6669 6564 ion as.specified │ │ │ │ │ -0001ada0: 2069 6e20 5246 4320 3435 3738 2e20 2054 in RFC 4578. T │ │ │ │ │ -0001adb0: 6865 2063 6c69 656e 7420 7769 6c6c 206f he client will o │ │ │ │ │ -0001adc0: 6e6c 7920 6174 7465 6d70 7420 746f 206c nly attempt to l │ │ │ │ │ -0001add0: 6f6f 756b 2075 7020 6120 5555 4944 0a63 oouk up a UUID.c │ │ │ │ │ -0001ade0: 6f6e 6669 6720 6669 6c65 2069 6620 6974 onfig file if it │ │ │ │ │ -0001adf0: 2077 6173 2070 726f 7669 6465 6420 6279 was provided by │ │ │ │ │ -0001ae00: 2074 6865 2044 4843 5020 7365 7276 6572 the DHCP server │ │ │ │ │ -0001ae10: 2e0a 0a20 2020 5468 6520 636c 6965 6e74 ... The client │ │ │ │ │ -0001ae20: 2077 696c 6c20 6f6e 6c79 2061 7474 656d will only attem │ │ │ │ │ -0001ae30: 7074 2074 6f20 6c6f 6f6b 2075 7020 616e pt to look up an │ │ │ │ │ -0001ae40: 2049 5076 3620 6164 6472 6573 7320 636f IPv6 address co │ │ │ │ │ -0001ae50: 6e66 6967 206f 6e63 652c 0a68 6f77 6576 nfig once,.howev │ │ │ │ │ -0001ae60: 6572 2c20 6974 2077 696c 6c20 7472 7920 er, it will try │ │ │ │ │ -0001ae70: 7468 6520 4950 7634 206d 756c 7469 706c the IPv4 multipl │ │ │ │ │ -0001ae80: 6520 7469 6d65 732e 2020 5468 6520 636f e times. The co │ │ │ │ │ -0001ae90: 6e63 7265 7465 2065 7861 6d70 6c65 0a62 ncrete example.b │ │ │ │ │ -0001aea0: 656c 6f77 2073 686f 7773 2077 6861 7420 elow shows what │ │ │ │ │ -0001aeb0: 776f 756c 6420 6861 7070 656e 2075 6e64 would happen und │ │ │ │ │ -0001aec0: 6572 2074 6865 2049 5076 3420 6361 7365 er the IPv4 case │ │ │ │ │ -0001aed0: 2e0a 0a20 2020 2020 5555 4944 3a20 3737 ... UUID: 77 │ │ │ │ │ -0001aee0: 3236 6136 3738 2d37 6663 302d 3438 3533 26a678-7fc0-4853 │ │ │ │ │ -0001aef0: 2d61 3466 362d 6338 3561 6333 3661 3132 -a4f6-c85ac36a12 │ │ │ │ │ -0001af00: 3061 0a20 2020 2020 4d41 433a 2020 3532 0a. MAC: 52 │ │ │ │ │ -0001af10: 3a35 343a 3030 3a65 633a 3333 3a38 310a :54:00:ec:33:81. │ │ │ │ │ -0001af20: 2020 2020 2049 5056 343a 2031 302e 302e IPV4: 10.0. │ │ │ │ │ -0001af30: 302e 3133 3020 2830 4130 3030 3038 3229 0.130 (0A000082) │ │ │ │ │ -0001af40: 0a0a 2020 2020 2027 2846 5750 4154 4829 .. '(FWPATH) │ │ │ │ │ -0001af50: 272f 6772 7562 2e63 6667 2d37 3732 3661 '/grub.cfg-7726a │ │ │ │ │ -0001af60: 3637 382d 3766 6330 2d34 3835 332d 6134 678-7fc0-4853-a4 │ │ │ │ │ -0001af70: 6636 2d63 3835 6163 3336 6131 3230 610a f6-c85ac36a120a. │ │ │ │ │ -0001af80: 2020 2020 2027 2846 5750 4154 4829 272f '(FWPATH)'/ │ │ │ │ │ -0001af90: 6772 7562 2e63 6667 2d35 322d 3534 2d30 grub.cfg-52-54-0 │ │ │ │ │ -0001afa0: 302d 6563 2d33 332d 3831 0a20 2020 2020 0-ec-33-81. │ │ │ │ │ -0001afb0: 2728 4657 5041 5448 2927 2f67 7275 622e '(FWPATH)'/grub. │ │ │ │ │ -0001afc0: 6366 672d 3041 3030 3030 3832 0a20 2020 cfg-0A000082. │ │ │ │ │ -0001afd0: 2020 2728 4657 5041 5448 2927 2f67 7275 '(FWPATH)'/gru │ │ │ │ │ -0001afe0: 622e 6366 672d 3041 3030 3030 380a 2020 b.cfg-0A00008. │ │ │ │ │ -0001aff0: 2020 2027 2846 5750 4154 4829 272f 6772 '(FWPATH)'/gr │ │ │ │ │ -0001b000: 7562 2e63 6667 2d30 4130 3030 300a 2020 ub.cfg-0A0000. │ │ │ │ │ -0001b010: 2020 2027 2846 5750 4154 4829 272f 6772 '(FWPATH)'/gr │ │ │ │ │ -0001b020: 7562 2e63 6667 2d30 4130 3030 0a20 2020 ub.cfg-0A000. │ │ │ │ │ -0001b030: 2020 2728 4657 5041 5448 2927 2f67 7275 '(FWPATH)'/gru │ │ │ │ │ -0001b040: 622e 6366 672d 3041 3030 0a20 2020 2020 b.cfg-0A00. │ │ │ │ │ -0001b050: 2728 4657 5041 5448 2927 2f67 7275 622e '(FWPATH)'/grub. │ │ │ │ │ -0001b060: 6366 672d 3041 300a 2020 2020 2027 2846 cfg-0A0. '(F │ │ │ │ │ -0001b070: 5750 4154 4829 272f 6772 7562 2e63 6667 WPATH)'/grub.cfg │ │ │ │ │ -0001b080: 2d30 410a 2020 2020 2027 2846 5750 4154 -0A. '(FWPAT │ │ │ │ │ -0001b090: 4829 272f 6772 7562 2e63 6667 2d30 0a20 H)'/grub.cfg-0. │ │ │ │ │ -0001b0a0: 2020 2020 2728 4657 5041 5448 2927 2f67 '(FWPATH)'/g │ │ │ │ │ -0001b0b0: 7275 622e 6366 670a 0a20 2020 5468 6973 rub.cfg.. This │ │ │ │ │ -0001b0c0: 2066 6561 7475 7265 2069 7320 656e 6162 feature is enab │ │ │ │ │ -0001b0d0: 6c65 6420 6279 2064 6566 6175 6c74 2062 led by default b │ │ │ │ │ -0001b0e0: 7574 2069 7420 6361 6e20 6265 2064 6973 ut it can be dis │ │ │ │ │ -0001b0f0: 6162 6c65 6420 6279 2073 6574 7469 6e67 abled by setting │ │ │ │ │ -0001b100: 0a74 6865 2027 6665 6174 7572 655f 6e65 .the 'feature_ne │ │ │ │ │ -0001b110: 745f 7365 6172 6368 5f63 6667 2720 746f t_search_cfg' to │ │ │ │ │ -0001b120: 2027 6e27 2e20 2053 696e 6365 2074 6869 'n'. Since thi │ │ │ │ │ -0001b130: 7320 6861 7070 656e 7320 6265 666f 7265 s happens before │ │ │ │ │ -0001b140: 2074 6865 0a63 6f6e 6669 6775 7261 7469 the.configurati │ │ │ │ │ -0001b150: 6f6e 2066 696c 6520 6973 2072 6561 6420 on file is read │ │ │ │ │ -0001b160: 6279 2047 5255 422c 2074 6869 7320 6f70 by GRUB, this op │ │ │ │ │ -0001b170: 7469 6f6e 2068 6173 2074 6f20 6265 2064 tion has to be d │ │ │ │ │ -0001b180: 6973 6162 6c65 6420 696e 2061 6e0a 656d isabled in an.em │ │ │ │ │ -0001b190: 6265 6464 6564 2063 6f6e 6669 6775 7261 bedded configura │ │ │ │ │ -0001b1a0: 7469 6f6e 2066 696c 6520 282a 6e6f 7465 tion file (*note │ │ │ │ │ -0001b1b0: 2045 6d62 6564 6465 6420 636f 6e66 6967 Embedded config │ │ │ │ │ -0001b1c0: 7572 6174 696f 6e3a 3a29 2e0a 0a20 2020 uration::)... │ │ │ │ │ -0001b1d0: 4166 7465 7220 4752 5542 2068 6173 2073 After GRUB has s │ │ │ │ │ -0001b1e0: 7461 7274 6564 2c20 6669 6c65 7320 6f6e tarted, files on │ │ │ │ │ -0001b1f0: 2074 6865 2054 4654 5020 7365 7276 6572 the TFTP server │ │ │ │ │ -0001b200: 2077 696c 6c20 6265 2061 6363 6573 7369 will be accessi │ │ │ │ │ -0001b210: 626c 650a 7669 6120 7468 6520 2728 7466 ble.via the '(tf │ │ │ │ │ -0001b220: 7470 2927 2064 6576 6963 652e 0a0a 2020 tp)' device... │ │ │ │ │ -0001b230: 2054 6865 2073 6572 7665 7220 4950 2061 The server IP a │ │ │ │ │ -0001b240: 6464 7265 7373 2063 616e 2062 6520 636f ddress can be co │ │ │ │ │ -0001b250: 6e74 726f 6c6c 6564 2062 7920 6368 616e ntrolled by chan │ │ │ │ │ -0001b260: 6769 6e67 2074 6865 2027 2874 6674 7029 ging the '(tftp) │ │ │ │ │ -0001b270: 270a 6465 7669 6365 206e 616d 6520 746f '.device name to │ │ │ │ │ -0001b280: 2027 2874 6674 702c 5345 5256 4552 2d49 '(tftp,SERVER-I │ │ │ │ │ -0001b290: 5029 272e 2020 4e6f 7465 2074 6861 7420 P)'. Note that │ │ │ │ │ -0001b2a0: 7468 6973 2073 686f 756c 6420 6265 2063 this should be c │ │ │ │ │ -0001b2b0: 6861 6e67 6564 0a62 6f74 6820 696e 2074 hanged.both in t │ │ │ │ │ -0001b2c0: 6865 2070 7265 6669 7820 616e 6420 696e he prefix and in │ │ │ │ │ -0001b2d0: 2061 6e79 2072 6566 6572 656e 6365 7320 any references │ │ │ │ │ -0001b2e0: 746f 2074 6865 2064 6576 6963 6520 6e61 to the device na │ │ │ │ │ -0001b2f0: 6d65 2069 6e20 7468 650a 636f 6e66 6967 me in the.config │ │ │ │ │ -0001b300: 7572 6174 696f 6e20 6669 6c65 2e0a 0a20 uration file... │ │ │ │ │ -0001b310: 2020 4752 5542 2070 726f 7669 6465 7320 GRUB provides │ │ │ │ │ -0001b320: 7365 7665 7261 6c20 656e 7669 726f 6e6d several environm │ │ │ │ │ -0001b330: 656e 7420 7661 7269 6162 6c65 7320 7768 ent variables wh │ │ │ │ │ -0001b340: 6963 6820 6d61 7920 6265 2075 7365 6420 ich may be used │ │ │ │ │ -0001b350: 746f 0a69 6e73 7065 6374 206f 7220 6368 to.inspect or ch │ │ │ │ │ -0001b360: 616e 6765 2074 6865 2062 6568 6176 696f ange the behavio │ │ │ │ │ -0001b370: 7572 206f 6620 7468 6520 5058 4520 6465 ur of the PXE de │ │ │ │ │ -0001b380: 7669 6365 2e20 2049 6e20 7468 6520 666f vice. In the fo │ │ │ │ │ -0001b390: 6c6c 6f77 696e 670a 6465 7363 7269 7074 llowing.descript │ │ │ │ │ -0001b3a0: 696f 6e20 3c49 4e54 4552 4641 4345 3e20 ion │ │ │ │ │ -0001b3b0: 6973 2070 6c61 6365 686f 6c64 6572 2066 is placeholder f │ │ │ │ │ -0001b3c0: 6f72 2074 6865 206e 616d 6520 6f66 206e or the name of n │ │ │ │ │ -0001b3d0: 6574 776f 726b 2069 6e74 6572 6661 6365 etwork interface │ │ │ │ │ -0001b3e0: 0a28 706c 6174 666f 726d 2064 6570 656e .(platform depen │ │ │ │ │ -0001b3f0: 6465 6e74 293a 0a0a 276e 6574 5f3c 494e dent):..'net__ip'. │ │ │ │ │ -0001b410: 2020 5468 6520 6e65 7477 6f72 6b20 696e The network in │ │ │ │ │ -0001b420: 7465 7266 6163 6527 7320 4950 2061 6464 terface's IP add │ │ │ │ │ -0001b430: 7265 7373 2e20 2052 6561 642d 6f6e 6c79 ress. Read-only │ │ │ │ │ -0001b440: 2e0a 0a27 6e65 745f 3c49 4e54 4552 4641 ...'net__mac'. Th │ │ │ │ │ -0001b460: 6520 6e65 7477 6f72 6b20 696e 7465 7266 e network interf │ │ │ │ │ -0001b470: 6163 6527 7320 4d41 4320 6164 6472 6573 ace's MAC addres │ │ │ │ │ -0001b480: 732e 2020 5265 6164 2d6f 6e6c 792e 0a0a s. Read-only... │ │ │ │ │ -0001b490: 276e 6574 5f3c 494e 5445 5246 4143 453e 'net_ │ │ │ │ │ -0001b4a0: 5f68 6f73 746e 616d 6527 0a20 2020 2020 _hostname'. │ │ │ │ │ -0001b4b0: 5468 6520 636c 6965 6e74 2068 6f73 7420 The client host │ │ │ │ │ -0001b4c0: 6e61 6d65 2070 726f 7669 6465 6420 6279 name provided by │ │ │ │ │ -0001b4d0: 2044 4843 502e 2052 6561 642d 6f6e 6c79 DHCP. Read-only │ │ │ │ │ -0001b4e0: 2e0a 0a27 6e65 745f 3c49 4e54 4552 4641 ...'net__domain'. │ │ │ │ │ -0001b500: 2054 6865 2063 6c69 656e 7420 646f 6d61 The client doma │ │ │ │ │ -0001b510: 696e 206e 616d 6520 7072 6f76 6964 6564 in name provided │ │ │ │ │ -0001b520: 2062 7920 4448 4350 2e20 5265 6164 2d6f by DHCP. Read-o │ │ │ │ │ -0001b530: 6e6c 792e 0a0a 276e 6574 5f3c 494e 5445 nly...'net__rootpath' │ │ │ │ │ -0001b550: 0a20 2020 2020 5468 6520 7061 7468 2074 . The path t │ │ │ │ │ -0001b560: 6f20 7468 6520 636c 6965 6e74 2773 2072 o the client's r │ │ │ │ │ -0001b570: 6f6f 7420 6469 736b 2070 726f 7669 6465 oot disk provide │ │ │ │ │ -0001b580: 6420 6279 2044 4843 502e 2052 6561 642d d by DHCP. Read- │ │ │ │ │ -0001b590: 6f6e 6c79 2e0a 0a27 6e65 745f 3c49 4e54 only...'net__extensio │ │ │ │ │ -0001b5b0: 6e73 7061 7468 270a 2020 2020 2054 6865 nspath'. The │ │ │ │ │ -0001b5c0: 2070 6174 6820 746f 2061 6464 6974 696f path to additio │ │ │ │ │ -0001b5d0: 6e61 6c20 4448 4350 2076 656e 646f 7220 nal DHCP vendor │ │ │ │ │ -0001b5e0: 6578 7465 6e73 696f 6e73 2070 726f 7669 extensions provi │ │ │ │ │ -0001b5f0: 6465 6420 6279 2044 4843 502e 0a20 2020 ded by DHCP.. │ │ │ │ │ -0001b600: 2020 5265 6164 2d6f 6e6c 792e 0a0a 276e Read-only...'n │ │ │ │ │ -0001b610: 6574 5f3c 494e 5445 5246 4143 453e 5f62 et__b │ │ │ │ │ -0001b620: 6f6f 745f 6669 6c65 270a 2020 2020 2054 oot_file'. T │ │ │ │ │ -0001b630: 6865 2062 6f6f 7420 6669 6c65 206e 616d he boot file nam │ │ │ │ │ -0001b640: 6520 7072 6f76 6964 6564 2062 7920 4448 e provided by DH │ │ │ │ │ -0001b650: 4350 2e20 5265 6164 2d6f 6e6c 792e 0a0a CP. Read-only... │ │ │ │ │ -0001b660: 276e 6574 5f3c 494e 5445 5246 4143 453e 'net_ │ │ │ │ │ -0001b670: 5f64 6863 705f 7365 7276 6572 5f6e 616d _dhcp_server_nam │ │ │ │ │ -0001b680: 6527 0a20 2020 2020 5468 6520 6e61 6d65 e'. The name │ │ │ │ │ -0001b690: 206f 6620 7468 6520 4448 4350 2073 6572 of the DHCP ser │ │ │ │ │ -0001b6a0: 7665 7220 7265 7370 6f6e 7369 626c 6520 ver responsible │ │ │ │ │ -0001b6b0: 666f 7220 7468 6573 6520 626f 6f74 2070 for these boot p │ │ │ │ │ -0001b6c0: 6172 616d 6574 6572 732e 0a20 2020 2020 arameters.. │ │ │ │ │ -0001b6d0: 5265 6164 2d6f 6e6c 792e 0a0a 276e 6574 Read-only...'net │ │ │ │ │ -0001b6e0: 5f3c 494e 5445 5246 4143 453e 5f6e 6578 __nex │ │ │ │ │ -0001b6f0: 745f 7365 7276 6572 270a 2020 2020 2054 t_server'. T │ │ │ │ │ -0001b700: 6865 2049 5020 6164 6472 6573 7320 6f66 he IP address of │ │ │ │ │ -0001b710: 2074 6865 206e 6578 7420 2875 7375 616c the next (usual │ │ │ │ │ -0001b720: 6c79 2c20 5446 5450 2920 7365 7276 6572 ly, TFTP) server │ │ │ │ │ -0001b730: 2070 726f 7669 6465 6420 6279 2044 4843 provided by DHC │ │ │ │ │ -0001b740: 502e 0a20 2020 2020 5265 6164 2d6f 6e6c P.. Read-onl │ │ │ │ │ -0001b750: 792e 0a0a 276e 6574 5f64 6566 6175 6c74 y...'net_default │ │ │ │ │ -0001b760: 5f69 6e74 6572 6661 6365 270a 2020 2020 _interface'. │ │ │ │ │ -0001b770: 2049 6e69 7469 616c 6c79 2073 6574 2074 Initially set t │ │ │ │ │ -0001b780: 6f20 6e61 6d65 206f 6620 6e65 7477 6f72 o name of networ │ │ │ │ │ -0001b790: 6b20 696e 7465 7266 6163 6520 7468 6174 k interface that │ │ │ │ │ -0001b7a0: 2077 6173 2075 7365 6420 746f 206c 6f61 was used to loa │ │ │ │ │ -0001b7b0: 640a 2020 2020 2067 7275 622e 2020 5265 d. grub. Re │ │ │ │ │ -0001b7c0: 6164 2d77 7269 7465 2c20 616c 7468 6f75 ad-write, althou │ │ │ │ │ -0001b7d0: 6768 2073 6574 7469 6e67 2069 7420 6166 gh setting it af │ │ │ │ │ -0001b7e0: 6665 6374 7320 6f6e 6c79 2069 6e74 6572 fects only inter │ │ │ │ │ -0001b7f0: 7072 6574 6174 696f 6e0a 2020 2020 206f pretation. o │ │ │ │ │ -0001b800: 6620 276e 6574 5f64 6566 6175 6c74 5f69 f 'net_default_i │ │ │ │ │ -0001b810: 7027 2061 6e64 2027 6e65 745f 6465 6661 p' and 'net_defa │ │ │ │ │ -0001b820: 756c 745f 6d61 6327 0a0a 276e 6574 5f64 ult_mac'..'net_d │ │ │ │ │ -0001b830: 6566 6175 6c74 5f69 7027 0a20 2020 2020 efault_ip'. │ │ │ │ │ -0001b840: 5468 6520 4950 2061 6464 7265 7373 206f The IP address o │ │ │ │ │ -0001b850: 6620 6465 6661 756c 7420 696e 7465 7266 f default interf │ │ │ │ │ -0001b860: 6163 652e 2020 5265 6164 2d6f 6e6c 792e ace. Read-only. │ │ │ │ │ -0001b870: 2020 5468 6973 2069 7320 616c 6961 7320 This is alias │ │ │ │ │ -0001b880: 666f 720a 2020 2020 2074 6865 2027 6e65 for. the 'ne │ │ │ │ │ -0001b890: 745f 247b 6e65 745f 6465 6661 756c 745f t_${net_default_ │ │ │ │ │ -0001b8a0: 696e 7465 7266 6163 657d 5f69 7027 2e0a interface}_ip'.. │ │ │ │ │ -0001b8b0: 0a27 6e65 745f 6465 6661 756c 745f 6d61 .'net_default_ma │ │ │ │ │ -0001b8c0: 6327 0a20 2020 2020 5468 6520 6465 6661 c'. The defa │ │ │ │ │ -0001b8d0: 756c 7420 696e 7465 7266 6163 6527 7320 ult interface's │ │ │ │ │ -0001b8e0: 4d41 4320 6164 6472 6573 732e 2020 5265 MAC address. Re │ │ │ │ │ -0001b8f0: 6164 2d6f 6e6c 792e 2020 5468 6973 2069 ad-only. This i │ │ │ │ │ -0001b900: 7320 616c 6961 7320 666f 720a 2020 2020 s alias for. │ │ │ │ │ -0001b910: 2074 6865 2027 6e65 745f 247b 6e65 745f the 'net_${net_ │ │ │ │ │ -0001b920: 6465 6661 756c 745f 696e 7465 7266 6163 default_interfac │ │ │ │ │ -0001b930: 657d 5f6d 6163 272e 0a0a 276e 6574 5f64 e}_mac'...'net_d │ │ │ │ │ -0001b940: 6566 6175 6c74 5f73 6572 7665 7227 0a20 efault_server'. │ │ │ │ │ -0001b950: 2020 2020 5468 6520 6465 6661 756c 7420 The default │ │ │ │ │ -0001b960: 7365 7276 6572 2075 7365 6420 6279 206e server used by n │ │ │ │ │ -0001b970: 6574 776f 726b 2064 7269 7665 7320 282a etwork drives (* │ │ │ │ │ -0001b980: 6e6f 7465 2044 6576 6963 6520 7379 6e74 note Device synt │ │ │ │ │ -0001b990: 6178 3a3a 292e 0a20 2020 2020 5265 6164 ax::).. Read │ │ │ │ │ -0001b9a0: 2d77 7269 7465 2c20 616c 7468 6f75 6768 -write, although │ │ │ │ │ -0001b9b0: 2073 6574 7469 6e67 2074 6869 7320 6973 setting this is │ │ │ │ │ -0001b9c0: 206f 6e6c 7920 7573 6566 756c 2062 6566 only useful bef │ │ │ │ │ -0001b9d0: 6f72 6520 6f70 656e 696e 6720 610a 2020 ore opening a. │ │ │ │ │ -0001b9e0: 2020 206e 6574 776f 726b 2064 6576 6963 network devic │ │ │ │ │ -0001b9f0: 652e 0a0a 1f0a 4669 6c65 3a20 6772 7562 e.....File: grub │ │ │ │ │ -0001ba00: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 5365 .info, Node: Se │ │ │ │ │ -0001ba10: 7269 616c 2074 6572 6d69 6e61 6c2c 2020 rial terminal, │ │ │ │ │ -0001ba20: 4e65 7874 3a20 5665 6e64 6f72 2070 6f77 Next: Vendor pow │ │ │ │ │ -0001ba30: 6572 2d6f 6e20 6b65 7973 2c20 2050 7265 er-on keys, Pre │ │ │ │ │ -0001ba40: 763a 204e 6574 776f 726b 2c20 2055 703a v: Network, Up: │ │ │ │ │ -0001ba50: 2054 6f70 0a0a 3920 5573 696e 6720 4752 Top..9 Using GR │ │ │ │ │ -0001ba60: 5542 2076 6961 2061 2073 6572 6961 6c20 UB via a serial │ │ │ │ │ -0001ba70: 6c69 6e65 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a line.*********** │ │ │ │ │ +0001a9b0: 2a2a 2a2a 2a2a 0a0a 5468 6520 666f 6c6c ******..The foll │ │ │ │ │ +0001a9c0: 6f77 696e 6720 696e 7374 7275 6374 696f owing instructio │ │ │ │ │ +0001a9d0: 6e73 2064 6f6e 2774 2077 6f72 6b20 666f ns don't work fo │ │ │ │ │ +0001a9e0: 7220 2a2d 656d 752c 2069 3338 362d 7165 r *-emu, i386-qe │ │ │ │ │ +0001a9f0: 6d75 2c0a 6933 3836 2d63 6f72 6562 6f6f mu,.i386-coreboo │ │ │ │ │ +0001aa00: 742c 2069 3338 362d 6d75 6c74 6962 6f6f t, i386-multiboo │ │ │ │ │ +0001aa10: 742c 206d 6970 735f 6c6f 6f6e 6773 6f6e t, mips_loongson │ │ │ │ │ +0001aa20: 2c20 6d69 7073 2d61 7263 2061 6e64 0a6d , mips-arc and.m │ │ │ │ │ +0001aa30: 6970 735f 7165 6d75 5f6d 6970 730a 0a20 ips_qemu_mips.. │ │ │ │ │ +0001aa40: 2020 546f 2067 656e 6572 6174 6520 6120 To generate a │ │ │ │ │ +0001aa50: 6e65 7462 6f6f 7461 626c 6520 6469 7265 netbootable dire │ │ │ │ │ +0001aa60: 6374 6f72 792c 2072 756e 3a0a 0a20 2020 ctory, run:.. │ │ │ │ │ +0001aa70: 2020 6772 7562 2d6d 6b6e 6574 6469 7220 grub-mknetdir │ │ │ │ │ +0001aa80: 2d2d 6e65 742d 6469 7265 6374 6f72 793d --net-directory= │ │ │ │ │ +0001aa90: 2f73 7276 2f74 6674 7020 2d2d 7375 6264 /srv/tftp --subd │ │ │ │ │ +0001aaa0: 6972 3d2f 626f 6f74 2f67 7275 6220 2d64 ir=/boot/grub -d │ │ │ │ │ +0001aab0: 202f 7573 722f 6c69 622f 6772 7562 2f3c /usr/lib/grub/< │ │ │ │ │ +0001aac0: 706c 6174 666f 726d 3e0a 0a20 2020 452e platform>.. E. │ │ │ │ │ +0001aad0: 672e 2020 666f 7220 6933 3836 2d70 633a g. for i386-pc: │ │ │ │ │ +0001aae0: 0a0a 2020 2020 2067 7275 622d 6d6b 6e65 .. grub-mkne │ │ │ │ │ +0001aaf0: 7464 6972 202d 2d6e 6574 2d64 6972 6563 tdir --net-direc │ │ │ │ │ +0001ab00: 746f 7279 3d2f 7372 762f 7466 7470 202d tory=/srv/tftp - │ │ │ │ │ +0001ab10: 2d73 7562 6469 723d 2f62 6f6f 742f 6772 -subdir=/boot/gr │ │ │ │ │ +0001ab20: 7562 202d 6420 2f75 7372 2f6c 6962 2f67 ub -d /usr/lib/g │ │ │ │ │ +0001ab30: 7275 622f 6933 3836 2d70 630a 0a20 2020 rub/i386-pc.. │ │ │ │ │ +0001ab40: 5468 656e 2066 6f6c 6c6f 7720 696e 7374 Then follow inst │ │ │ │ │ +0001ab50: 7275 6374 696f 6e73 2070 7269 6e74 6564 ructions printed │ │ │ │ │ +0001ab60: 206f 7574 2062 7920 6772 7562 2d6d 6b6e out by grub-mkn │ │ │ │ │ +0001ab70: 6574 6469 7220 6f6e 2063 6f6e 6669 6775 etdir on configu │ │ │ │ │ +0001ab80: 7269 6e67 0a79 6f75 7220 4448 4350 2073 ring.your DHCP s │ │ │ │ │ +0001ab90: 6572 7665 722e 0a0a 2020 2054 6865 2067 erver... The g │ │ │ │ │ +0001aba0: 7275 622e 6366 6720 6669 6c65 2069 7320 rub.cfg file is │ │ │ │ │ +0001abb0: 706c 6163 6564 2069 6e20 7468 6520 7361 placed in the sa │ │ │ │ │ +0001abc0: 6d65 2064 6972 6563 746f 7279 2061 7320 me directory as │ │ │ │ │ +0001abd0: 7468 6520 7061 7468 206f 7574 7075 740a the path output. │ │ │ │ │ +0001abe0: 6279 2067 7275 622d 6d6b 6e65 7464 6972 by grub-mknetdir │ │ │ │ │ +0001abf0: 2068 6572 6561 6674 6572 2072 6566 6572 hereafter refer │ │ │ │ │ +0001ac00: 7265 6420 746f 2061 7320 4657 5041 5448 red to as FWPATH │ │ │ │ │ +0001ac10: 2e20 4752 5542 2077 696c 6c20 7365 6172 . GRUB will sear │ │ │ │ │ +0001ac20: 6368 2066 6f72 0a69 7473 2063 6f6e 6669 ch for.its confi │ │ │ │ │ +0001ac30: 6775 7261 7469 6f6e 2066 696c 6573 2069 guration files i │ │ │ │ │ +0001ac40: 6e20 6f72 6465 7220 7573 696e 6720 7468 n order using th │ │ │ │ │ +0001ac50: 6520 666f 6c6c 6f77 696e 6720 7275 6c65 e following rule │ │ │ │ │ +0001ac60: 7320 7768 6572 6520 7468 650a 6170 7065 s where the.appe │ │ │ │ │ +0001ac70: 6e64 6564 2076 616c 7565 2063 6f72 7265 nded value corre │ │ │ │ │ +0001ac80: 7370 6f6e 6473 2074 6f20 6120 7661 6c75 sponds to a valu │ │ │ │ │ +0001ac90: 6520 6f6e 2074 6865 2063 6c69 656e 7420 e on the client │ │ │ │ │ +0001aca0: 6d61 6368 696e 652e 0a0a 2020 2020 2027 machine... ' │ │ │ │ │ +0001acb0: 2846 5750 4154 4829 272f 6772 7562 2e63 (FWPATH)'/grub.c │ │ │ │ │ +0001acc0: 6667 2d27 2855 5549 4420 4f46 204d 4143 fg-'(UUID OF MAC │ │ │ │ │ +0001acd0: 4849 4e45 2927 0a20 2020 2020 2728 4657 HINE)'. '(FW │ │ │ │ │ +0001ace0: 5041 5448 2927 2f67 7275 622e 6366 672d PATH)'/grub.cfg- │ │ │ │ │ +0001acf0: 2728 4d41 4320 4144 4452 4553 5320 4f46 '(MAC ADDRESS OF │ │ │ │ │ +0001ad00: 204e 4943 2927 0a20 2020 2020 2728 4657 NIC)'. '(FW │ │ │ │ │ +0001ad10: 5041 5448 2927 2f67 7275 622e 6366 672d PATH)'/grub.cfg- │ │ │ │ │ +0001ad20: 2728 4950 7634 204f 5220 4950 7636 2041 '(IPv4 OR IPv6 A │ │ │ │ │ +0001ad30: 4444 5245 5353 2927 0a20 2020 2020 2728 DDRESS)'. '( │ │ │ │ │ +0001ad40: 4657 5041 5448 2927 2f67 7275 622e 6366 FWPATH)'/grub.cf │ │ │ │ │ +0001ad50: 670a 0a20 2020 5468 6520 5555 4944 2069 g.. The UUID i │ │ │ │ │ +0001ad60: 7320 7468 6520 436c 6965 6e74 204d 6163 s the Client Mac │ │ │ │ │ +0001ad70: 6869 6e65 2049 6465 6e74 6966 6965 7220 hine Identifier │ │ │ │ │ +0001ad80: 4f70 7469 6f6e 2044 6566 696e 6974 696f Option Definitio │ │ │ │ │ +0001ad90: 6e20 6173 0a73 7065 6369 6669 6564 2069 n as.specified i │ │ │ │ │ +0001ada0: 6e20 5246 4320 3435 3738 2e20 2054 6865 n RFC 4578. The │ │ │ │ │ +0001adb0: 2063 6c69 656e 7420 7769 6c6c 206f 6e6c client will onl │ │ │ │ │ +0001adc0: 7920 6174 7465 6d70 7420 746f 206c 6f6f y attempt to loo │ │ │ │ │ +0001add0: 756b 2075 7020 6120 5555 4944 0a63 6f6e uk up a UUID.con │ │ │ │ │ +0001ade0: 6669 6720 6669 6c65 2069 6620 6974 2077 fig file if it w │ │ │ │ │ +0001adf0: 6173 2070 726f 7669 6465 6420 6279 2074 as provided by t │ │ │ │ │ +0001ae00: 6865 2044 4843 5020 7365 7276 6572 2e0a he DHCP server.. │ │ │ │ │ +0001ae10: 0a20 2020 5468 6520 636c 6965 6e74 2077 . The client w │ │ │ │ │ +0001ae20: 696c 6c20 6f6e 6c79 2061 7474 656d 7074 ill only attempt │ │ │ │ │ +0001ae30: 2074 6f20 6c6f 6f6b 2075 7020 616e 2049 to look up an I │ │ │ │ │ +0001ae40: 5076 3620 6164 6472 6573 7320 636f 6e66 Pv6 address conf │ │ │ │ │ +0001ae50: 6967 206f 6e63 652c 0a68 6f77 6576 6572 ig once,.however │ │ │ │ │ +0001ae60: 2c20 6974 2077 696c 6c20 7472 7920 7468 , it will try th │ │ │ │ │ +0001ae70: 6520 4950 7634 206d 756c 7469 706c 6520 e IPv4 multiple │ │ │ │ │ +0001ae80: 7469 6d65 732e 2020 5468 6520 636f 6e63 times. The conc │ │ │ │ │ +0001ae90: 7265 7465 2065 7861 6d70 6c65 0a62 656c rete example.bel │ │ │ │ │ +0001aea0: 6f77 2073 686f 7773 2077 6861 7420 776f ow shows what wo │ │ │ │ │ +0001aeb0: 756c 6420 6861 7070 656e 2075 6e64 6572 uld happen under │ │ │ │ │ +0001aec0: 2074 6865 2049 5076 3420 6361 7365 2e0a the IPv4 case.. │ │ │ │ │ +0001aed0: 0a20 2020 2020 5555 4944 3a20 3737 3236 . UUID: 7726 │ │ │ │ │ +0001aee0: 6136 3738 2d37 6663 302d 3438 3533 2d61 a678-7fc0-4853-a │ │ │ │ │ +0001aef0: 3466 362d 6338 3561 6333 3661 3132 3061 4f6-c85ac36a120a │ │ │ │ │ +0001af00: 0a20 2020 2020 4d41 433a 2020 3532 3a35 . MAC: 52:5 │ │ │ │ │ +0001af10: 343a 3030 3a65 633a 3333 3a38 310a 2020 4:00:ec:33:81. │ │ │ │ │ +0001af20: 2020 2049 5056 343a 2031 302e 302e 302e IPV4: 10.0.0. │ │ │ │ │ +0001af30: 3133 3020 2830 4130 3030 3038 3229 0a0a 130 (0A000082).. │ │ │ │ │ +0001af40: 2020 2020 2027 2846 5750 4154 4829 272f '(FWPATH)'/ │ │ │ │ │ +0001af50: 6772 7562 2e63 6667 2d37 3732 3661 3637 grub.cfg-7726a67 │ │ │ │ │ +0001af60: 382d 3766 6330 2d34 3835 332d 6134 6636 8-7fc0-4853-a4f6 │ │ │ │ │ +0001af70: 2d63 3835 6163 3336 6131 3230 610a 2020 -c85ac36a120a. │ │ │ │ │ +0001af80: 2020 2027 2846 5750 4154 4829 272f 6772 '(FWPATH)'/gr │ │ │ │ │ +0001af90: 7562 2e63 6667 2d35 322d 3534 2d30 302d ub.cfg-52-54-00- │ │ │ │ │ +0001afa0: 6563 2d33 332d 3831 0a20 2020 2020 2728 ec-33-81. '( │ │ │ │ │ +0001afb0: 4657 5041 5448 2927 2f67 7275 622e 6366 FWPATH)'/grub.cf │ │ │ │ │ +0001afc0: 672d 3041 3030 3030 3832 0a20 2020 2020 g-0A000082. │ │ │ │ │ +0001afd0: 2728 4657 5041 5448 2927 2f67 7275 622e '(FWPATH)'/grub. │ │ │ │ │ +0001afe0: 6366 672d 3041 3030 3030 380a 2020 2020 cfg-0A00008. │ │ │ │ │ +0001aff0: 2027 2846 5750 4154 4829 272f 6772 7562 '(FWPATH)'/grub │ │ │ │ │ +0001b000: 2e63 6667 2d30 4130 3030 300a 2020 2020 .cfg-0A0000. │ │ │ │ │ +0001b010: 2027 2846 5750 4154 4829 272f 6772 7562 '(FWPATH)'/grub │ │ │ │ │ +0001b020: 2e63 6667 2d30 4130 3030 0a20 2020 2020 .cfg-0A000. │ │ │ │ │ +0001b030: 2728 4657 5041 5448 2927 2f67 7275 622e '(FWPATH)'/grub. │ │ │ │ │ +0001b040: 6366 672d 3041 3030 0a20 2020 2020 2728 cfg-0A00. '( │ │ │ │ │ +0001b050: 4657 5041 5448 2927 2f67 7275 622e 6366 FWPATH)'/grub.cf │ │ │ │ │ +0001b060: 672d 3041 300a 2020 2020 2027 2846 5750 g-0A0. '(FWP │ │ │ │ │ +0001b070: 4154 4829 272f 6772 7562 2e63 6667 2d30 ATH)'/grub.cfg-0 │ │ │ │ │ +0001b080: 410a 2020 2020 2027 2846 5750 4154 4829 A. '(FWPATH) │ │ │ │ │ +0001b090: 272f 6772 7562 2e63 6667 2d30 0a20 2020 '/grub.cfg-0. │ │ │ │ │ +0001b0a0: 2020 2728 4657 5041 5448 2927 2f67 7275 '(FWPATH)'/gru │ │ │ │ │ +0001b0b0: 622e 6366 670a 0a20 2020 5468 6973 2066 b.cfg.. This f │ │ │ │ │ +0001b0c0: 6561 7475 7265 2069 7320 656e 6162 6c65 eature is enable │ │ │ │ │ +0001b0d0: 6420 6279 2064 6566 6175 6c74 2062 7574 d by default but │ │ │ │ │ +0001b0e0: 2069 7420 6361 6e20 6265 2064 6973 6162 it can be disab │ │ │ │ │ +0001b0f0: 6c65 6420 6279 2073 6574 7469 6e67 0a74 led by setting.t │ │ │ │ │ +0001b100: 6865 2027 6665 6174 7572 655f 6e65 745f he 'feature_net_ │ │ │ │ │ +0001b110: 7365 6172 6368 5f63 6667 2720 746f 2027 search_cfg' to ' │ │ │ │ │ +0001b120: 6e27 2e20 2053 696e 6365 2074 6869 7320 n'. Since this │ │ │ │ │ +0001b130: 6861 7070 656e 7320 6265 666f 7265 2074 happens before t │ │ │ │ │ +0001b140: 6865 0a63 6f6e 6669 6775 7261 7469 6f6e he.configuration │ │ │ │ │ +0001b150: 2066 696c 6520 6973 2072 6561 6420 6279 file is read by │ │ │ │ │ +0001b160: 2047 5255 422c 2074 6869 7320 6f70 7469 GRUB, this opti │ │ │ │ │ +0001b170: 6f6e 2068 6173 2074 6f20 6265 2064 6973 on has to be dis │ │ │ │ │ +0001b180: 6162 6c65 6420 696e 2061 6e0a 656d 6265 abled in an.embe │ │ │ │ │ +0001b190: 6464 6564 2063 6f6e 6669 6775 7261 7469 dded configurati │ │ │ │ │ +0001b1a0: 6f6e 2066 696c 6520 282a 6e6f 7465 2045 on file (*note E │ │ │ │ │ +0001b1b0: 6d62 6564 6465 6420 636f 6e66 6967 7572 mbedded configur │ │ │ │ │ +0001b1c0: 6174 696f 6e3a 3a29 2e0a 0a20 2020 4166 ation::)... Af │ │ │ │ │ +0001b1d0: 7465 7220 4752 5542 2068 6173 2073 7461 ter GRUB has sta │ │ │ │ │ +0001b1e0: 7274 6564 2c20 6669 6c65 7320 6f6e 2074 rted, files on t │ │ │ │ │ +0001b1f0: 6865 2054 4654 5020 7365 7276 6572 2077 he TFTP server w │ │ │ │ │ +0001b200: 696c 6c20 6265 2061 6363 6573 7369 626c ill be accessibl │ │ │ │ │ +0001b210: 650a 7669 6120 7468 6520 2728 7466 7470 e.via the '(tftp │ │ │ │ │ +0001b220: 2927 2064 6576 6963 652e 0a0a 2020 2054 )' device... T │ │ │ │ │ +0001b230: 6865 2073 6572 7665 7220 4950 2061 6464 he server IP add │ │ │ │ │ +0001b240: 7265 7373 2063 616e 2062 6520 636f 6e74 ress can be cont │ │ │ │ │ +0001b250: 726f 6c6c 6564 2062 7920 6368 616e 6769 rolled by changi │ │ │ │ │ +0001b260: 6e67 2074 6865 2027 2874 6674 7029 270a ng the '(tftp)'. │ │ │ │ │ +0001b270: 6465 7669 6365 206e 616d 6520 746f 2027 device name to ' │ │ │ │ │ +0001b280: 2874 6674 702c 5345 5256 4552 2d49 5029 (tftp,SERVER-IP) │ │ │ │ │ +0001b290: 272e 2020 4e6f 7465 2074 6861 7420 7468 '. Note that th │ │ │ │ │ +0001b2a0: 6973 2073 686f 756c 6420 6265 2063 6861 is should be cha │ │ │ │ │ +0001b2b0: 6e67 6564 0a62 6f74 6820 696e 2074 6865 nged.both in the │ │ │ │ │ +0001b2c0: 2070 7265 6669 7820 616e 6420 696e 2061 prefix and in a │ │ │ │ │ +0001b2d0: 6e79 2072 6566 6572 656e 6365 7320 746f ny references to │ │ │ │ │ +0001b2e0: 2074 6865 2064 6576 6963 6520 6e61 6d65 the device name │ │ │ │ │ +0001b2f0: 2069 6e20 7468 650a 636f 6e66 6967 7572 in the.configur │ │ │ │ │ +0001b300: 6174 696f 6e20 6669 6c65 2e0a 0a20 2020 ation file... │ │ │ │ │ +0001b310: 4752 5542 2070 726f 7669 6465 7320 7365 GRUB provides se │ │ │ │ │ +0001b320: 7665 7261 6c20 656e 7669 726f 6e6d 656e veral environmen │ │ │ │ │ +0001b330: 7420 7661 7269 6162 6c65 7320 7768 6963 t variables whic │ │ │ │ │ +0001b340: 6820 6d61 7920 6265 2075 7365 6420 746f h may be used to │ │ │ │ │ +0001b350: 0a69 6e73 7065 6374 206f 7220 6368 616e .inspect or chan │ │ │ │ │ +0001b360: 6765 2074 6865 2062 6568 6176 696f 7572 ge the behaviour │ │ │ │ │ +0001b370: 206f 6620 7468 6520 5058 4520 6465 7669 of the PXE devi │ │ │ │ │ +0001b380: 6365 2e20 2049 6e20 7468 6520 666f 6c6c ce. In the foll │ │ │ │ │ +0001b390: 6f77 696e 670a 6465 7363 7269 7074 696f owing.descriptio │ │ │ │ │ +0001b3a0: 6e20 3c49 4e54 4552 4641 4345 3e20 6973 n is │ │ │ │ │ +0001b3b0: 2070 6c61 6365 686f 6c64 6572 2066 6f72 placeholder for │ │ │ │ │ +0001b3c0: 2074 6865 206e 616d 6520 6f66 206e 6574 the name of net │ │ │ │ │ +0001b3d0: 776f 726b 2069 6e74 6572 6661 6365 0a28 work interface.( │ │ │ │ │ +0001b3e0: 706c 6174 666f 726d 2064 6570 656e 6465 platform depende │ │ │ │ │ +0001b3f0: 6e74 293a 0a0a 276e 6574 5f3c 494e 5445 nt):..'net__ip'. │ │ │ │ │ +0001b410: 5468 6520 6e65 7477 6f72 6b20 696e 7465 The network inte │ │ │ │ │ +0001b420: 7266 6163 6527 7320 4950 2061 6464 7265 rface's IP addre │ │ │ │ │ +0001b430: 7373 2e20 2052 6561 642d 6f6e 6c79 2e0a ss. Read-only.. │ │ │ │ │ +0001b440: 0a27 6e65 745f 3c49 4e54 4552 4641 4345 .'net__mac'. The │ │ │ │ │ +0001b460: 6e65 7477 6f72 6b20 696e 7465 7266 6163 network interfac │ │ │ │ │ +0001b470: 6527 7320 4d41 4320 6164 6472 6573 732e e's MAC address. │ │ │ │ │ +0001b480: 2020 5265 6164 2d6f 6e6c 792e 0a0a 276e Read-only...'n │ │ │ │ │ +0001b490: 6574 5f3c 494e 5445 5246 4143 453e 5f68 et__h │ │ │ │ │ +0001b4a0: 6f73 746e 616d 6527 0a20 2020 2020 5468 ostname'. Th │ │ │ │ │ +0001b4b0: 6520 636c 6965 6e74 2068 6f73 7420 6e61 e client host na │ │ │ │ │ +0001b4c0: 6d65 2070 726f 7669 6465 6420 6279 2044 me provided by D │ │ │ │ │ +0001b4d0: 4843 502e 2052 6561 642d 6f6e 6c79 2e0a HCP. Read-only.. │ │ │ │ │ +0001b4e0: 0a27 6e65 745f 3c49 4e54 4552 4641 4345 .'net__domain'. T │ │ │ │ │ +0001b500: 6865 2063 6c69 656e 7420 646f 6d61 696e he client domain │ │ │ │ │ +0001b510: 206e 616d 6520 7072 6f76 6964 6564 2062 name provided b │ │ │ │ │ +0001b520: 7920 4448 4350 2e20 5265 6164 2d6f 6e6c y DHCP. Read-onl │ │ │ │ │ +0001b530: 792e 0a0a 276e 6574 5f3c 494e 5445 5246 y...'net__rootpath'. │ │ │ │ │ +0001b550: 2020 2020 5468 6520 7061 7468 2074 6f20 The path to │ │ │ │ │ +0001b560: 7468 6520 636c 6965 6e74 2773 2072 6f6f the client's roo │ │ │ │ │ +0001b570: 7420 6469 736b 2070 726f 7669 6465 6420 t disk provided │ │ │ │ │ +0001b580: 6279 2044 4843 502e 2052 6561 642d 6f6e by DHCP. Read-on │ │ │ │ │ +0001b590: 6c79 2e0a 0a27 6e65 745f 3c49 4e54 4552 ly...'net__extensions │ │ │ │ │ +0001b5b0: 7061 7468 270a 2020 2020 2054 6865 2070 path'. The p │ │ │ │ │ +0001b5c0: 6174 6820 746f 2061 6464 6974 696f 6e61 ath to additiona │ │ │ │ │ +0001b5d0: 6c20 4448 4350 2076 656e 646f 7220 6578 l DHCP vendor ex │ │ │ │ │ +0001b5e0: 7465 6e73 696f 6e73 2070 726f 7669 6465 tensions provide │ │ │ │ │ +0001b5f0: 6420 6279 2044 4843 502e 0a20 2020 2020 d by DHCP.. │ │ │ │ │ +0001b600: 5265 6164 2d6f 6e6c 792e 0a0a 276e 6574 Read-only...'net │ │ │ │ │ +0001b610: 5f3c 494e 5445 5246 4143 453e 5f62 6f6f __boo │ │ │ │ │ +0001b620: 745f 6669 6c65 270a 2020 2020 2054 6865 t_file'. The │ │ │ │ │ +0001b630: 2062 6f6f 7420 6669 6c65 206e 616d 6520 boot file name │ │ │ │ │ +0001b640: 7072 6f76 6964 6564 2062 7920 4448 4350 provided by DHCP │ │ │ │ │ +0001b650: 2e20 5265 6164 2d6f 6e6c 792e 0a0a 276e . Read-only...'n │ │ │ │ │ +0001b660: 6574 5f3c 494e 5445 5246 4143 453e 5f64 et__d │ │ │ │ │ +0001b670: 6863 705f 7365 7276 6572 5f6e 616d 6527 hcp_server_name' │ │ │ │ │ +0001b680: 0a20 2020 2020 5468 6520 6e61 6d65 206f . The name o │ │ │ │ │ +0001b690: 6620 7468 6520 4448 4350 2073 6572 7665 f the DHCP serve │ │ │ │ │ +0001b6a0: 7220 7265 7370 6f6e 7369 626c 6520 666f r responsible fo │ │ │ │ │ +0001b6b0: 7220 7468 6573 6520 626f 6f74 2070 6172 r these boot par │ │ │ │ │ +0001b6c0: 616d 6574 6572 732e 0a20 2020 2020 5265 ameters.. Re │ │ │ │ │ +0001b6d0: 6164 2d6f 6e6c 792e 0a0a 276e 6574 5f3c ad-only...'net_< │ │ │ │ │ +0001b6e0: 494e 5445 5246 4143 453e 5f6e 6578 745f INTERFACE>_next_ │ │ │ │ │ +0001b6f0: 7365 7276 6572 270a 2020 2020 2054 6865 server'. The │ │ │ │ │ +0001b700: 2049 5020 6164 6472 6573 7320 6f66 2074 IP address of t │ │ │ │ │ +0001b710: 6865 206e 6578 7420 2875 7375 616c 6c79 he next (usually │ │ │ │ │ +0001b720: 2c20 5446 5450 2920 7365 7276 6572 2070 , TFTP) server p │ │ │ │ │ +0001b730: 726f 7669 6465 6420 6279 2044 4843 502e rovided by DHCP. │ │ │ │ │ +0001b740: 0a20 2020 2020 5265 6164 2d6f 6e6c 792e . Read-only. │ │ │ │ │ +0001b750: 0a0a 276e 6574 5f64 6566 6175 6c74 5f69 ..'net_default_i │ │ │ │ │ +0001b760: 6e74 6572 6661 6365 270a 2020 2020 2049 nterface'. I │ │ │ │ │ +0001b770: 6e69 7469 616c 6c79 2073 6574 2074 6f20 nitially set to │ │ │ │ │ +0001b780: 6e61 6d65 206f 6620 6e65 7477 6f72 6b20 name of network │ │ │ │ │ +0001b790: 696e 7465 7266 6163 6520 7468 6174 2077 interface that w │ │ │ │ │ +0001b7a0: 6173 2075 7365 6420 746f 206c 6f61 640a as used to load. │ │ │ │ │ +0001b7b0: 2020 2020 2067 7275 622e 2020 5265 6164 grub. Read │ │ │ │ │ +0001b7c0: 2d77 7269 7465 2c20 616c 7468 6f75 6768 -write, although │ │ │ │ │ +0001b7d0: 2073 6574 7469 6e67 2069 7420 6166 6665 setting it affe │ │ │ │ │ +0001b7e0: 6374 7320 6f6e 6c79 2069 6e74 6572 7072 cts only interpr │ │ │ │ │ +0001b7f0: 6574 6174 696f 6e0a 2020 2020 206f 6620 etation. of │ │ │ │ │ +0001b800: 276e 6574 5f64 6566 6175 6c74 5f69 7027 'net_default_ip' │ │ │ │ │ +0001b810: 2061 6e64 2027 6e65 745f 6465 6661 756c and 'net_defaul │ │ │ │ │ +0001b820: 745f 6d61 6327 0a0a 276e 6574 5f64 6566 t_mac'..'net_def │ │ │ │ │ +0001b830: 6175 6c74 5f69 7027 0a20 2020 2020 5468 ault_ip'. Th │ │ │ │ │ +0001b840: 6520 4950 2061 6464 7265 7373 206f 6620 e IP address of │ │ │ │ │ +0001b850: 6465 6661 756c 7420 696e 7465 7266 6163 default interfac │ │ │ │ │ +0001b860: 652e 2020 5265 6164 2d6f 6e6c 792e 2020 e. Read-only. │ │ │ │ │ +0001b870: 5468 6973 2069 7320 616c 6961 7320 666f This is alias fo │ │ │ │ │ +0001b880: 720a 2020 2020 2074 6865 2027 6e65 745f r. the 'net_ │ │ │ │ │ +0001b890: 247b 6e65 745f 6465 6661 756c 745f 696e ${net_default_in │ │ │ │ │ +0001b8a0: 7465 7266 6163 657d 5f69 7027 2e0a 0a27 terface}_ip'...' │ │ │ │ │ +0001b8b0: 6e65 745f 6465 6661 756c 745f 6d61 6327 net_default_mac' │ │ │ │ │ +0001b8c0: 0a20 2020 2020 5468 6520 6465 6661 756c . The defaul │ │ │ │ │ +0001b8d0: 7420 696e 7465 7266 6163 6527 7320 4d41 t interface's MA │ │ │ │ │ +0001b8e0: 4320 6164 6472 6573 732e 2020 5265 6164 C address. Read │ │ │ │ │ +0001b8f0: 2d6f 6e6c 792e 2020 5468 6973 2069 7320 -only. This is │ │ │ │ │ +0001b900: 616c 6961 7320 666f 720a 2020 2020 2074 alias for. t │ │ │ │ │ +0001b910: 6865 2027 6e65 745f 247b 6e65 745f 6465 he 'net_${net_de │ │ │ │ │ +0001b920: 6661 756c 745f 696e 7465 7266 6163 657d fault_interface} │ │ │ │ │ +0001b930: 5f6d 6163 272e 0a0a 276e 6574 5f64 6566 _mac'...'net_def │ │ │ │ │ +0001b940: 6175 6c74 5f73 6572 7665 7227 0a20 2020 ault_server'. │ │ │ │ │ +0001b950: 2020 5468 6520 6465 6661 756c 7420 7365 The default se │ │ │ │ │ +0001b960: 7276 6572 2075 7365 6420 6279 206e 6574 rver used by net │ │ │ │ │ +0001b970: 776f 726b 2064 7269 7665 7320 282a 6e6f work drives (*no │ │ │ │ │ +0001b980: 7465 2044 6576 6963 6520 7379 6e74 6178 te Device syntax │ │ │ │ │ +0001b990: 3a3a 292e 0a20 2020 2020 5265 6164 2d77 ::).. Read-w │ │ │ │ │ +0001b9a0: 7269 7465 2c20 616c 7468 6f75 6768 2073 rite, although s │ │ │ │ │ +0001b9b0: 6574 7469 6e67 2074 6869 7320 6973 206f etting this is o │ │ │ │ │ +0001b9c0: 6e6c 7920 7573 6566 756c 2062 6566 6f72 nly useful befor │ │ │ │ │ +0001b9d0: 6520 6f70 656e 696e 6720 610a 2020 2020 e opening a. │ │ │ │ │ +0001b9e0: 206e 6574 776f 726b 2064 6576 6963 652e network device. │ │ │ │ │ +0001b9f0: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ +0001ba00: 6e66 6f2c 2020 4e6f 6465 3a20 5365 7269 nfo, Node: Seri │ │ │ │ │ +0001ba10: 616c 2074 6572 6d69 6e61 6c2c 2020 4e65 al terminal, Ne │ │ │ │ │ +0001ba20: 7874 3a20 5665 6e64 6f72 2070 6f77 6572 xt: Vendor power │ │ │ │ │ +0001ba30: 2d6f 6e20 6b65 7973 2c20 2050 7265 763a -on keys, Prev: │ │ │ │ │ +0001ba40: 204e 6574 776f 726b 2c20 2055 703a 2054 Network, Up: T │ │ │ │ │ +0001ba50: 6f70 0a0a 3920 5573 696e 6720 4752 5542 op..9 Using GRUB │ │ │ │ │ +0001ba60: 2076 6961 2061 2073 6572 6961 6c20 6c69 via a serial li │ │ │ │ │ +0001ba70: 6e65 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a ne.************* │ │ │ │ │ 0001ba80: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -0001ba90: 2a2a 2a0a 0a54 6869 7320 6368 6170 7465 ***..This chapte │ │ │ │ │ -0001baa0: 7220 6465 7363 7269 6265 7320 686f 7720 r describes how │ │ │ │ │ -0001bab0: 746f 2075 7365 2074 6865 2073 6572 6961 to use the seria │ │ │ │ │ -0001bac0: 6c20 7465 726d 696e 616c 2073 7570 706f l terminal suppo │ │ │ │ │ -0001bad0: 7274 2069 6e20 4752 5542 2e0a 0a20 2020 rt in GRUB... │ │ │ │ │ -0001bae0: 4966 2079 6f75 2068 6176 6520 6d61 6e79 If you have many │ │ │ │ │ -0001baf0: 2063 6f6d 7075 7465 7273 206f 7220 636f computers or co │ │ │ │ │ -0001bb00: 6d70 7574 6572 7320 7769 7468 206e 6f20 mputers with no │ │ │ │ │ -0001bb10: 6469 7370 6c61 792f 6b65 7962 6f61 7264 display/keyboard │ │ │ │ │ -0001bb20: 2c20 6974 0a63 6f75 6c64 2062 6520 7665 , it.could be ve │ │ │ │ │ -0001bb30: 7279 2075 7365 6675 6c20 746f 2063 6f6e ry useful to con │ │ │ │ │ -0001bb40: 7472 6f6c 2074 6865 2063 6f6d 7075 7465 trol the compute │ │ │ │ │ -0001bb50: 7273 2074 6872 6f75 6768 2073 6572 6961 rs through seria │ │ │ │ │ -0001bb60: 6c0a 636f 6d6d 756e 6963 6174 696f 6e73 l.communications │ │ │ │ │ -0001bb70: 2e20 2054 6f20 636f 6e6e 6563 7420 6f6e . To connect on │ │ │ │ │ -0001bb80: 6520 636f 6d70 7574 6572 2077 6974 6820 e computer with │ │ │ │ │ -0001bb90: 616e 6f74 6865 7220 7669 6120 6120 7365 another via a se │ │ │ │ │ -0001bba0: 7269 616c 206c 696e 652c 0a79 6f75 206e rial line,.you n │ │ │ │ │ -0001bbb0: 6565 6420 746f 2070 7265 7061 7265 2061 eed to prepare a │ │ │ │ │ -0001bbc0: 206e 756c 6c2d 6d6f 6465 6d20 2863 726f null-modem (cro │ │ │ │ │ -0001bbd0: 7373 2920 7365 7269 616c 2063 6162 6c65 ss) serial cable │ │ │ │ │ -0001bbe0: 2c20 616e 6420 796f 7520 6d61 7920 6e65 , and you may ne │ │ │ │ │ -0001bbf0: 6564 0a74 6f20 6861 7665 206d 756c 7469 ed.to have multi │ │ │ │ │ -0001bc00: 706f 7274 2073 6572 6961 6c20 626f 6172 port serial boar │ │ │ │ │ -0001bc10: 6473 2c20 6966 2079 6f75 7220 636f 6d70 ds, if your comp │ │ │ │ │ -0001bc20: 7574 6572 2064 6f65 736e 2774 2068 6176 uter doesn't hav │ │ │ │ │ -0001bc30: 6520 6578 7472 610a 7365 7269 616c 2070 e extra.serial p │ │ │ │ │ -0001bc40: 6f72 7473 2e20 2049 6e20 6164 6469 7469 orts. In additi │ │ │ │ │ -0001bc50: 6f6e 2c20 6120 7465 726d 696e 616c 2065 on, a terminal e │ │ │ │ │ -0001bc60: 6d75 6c61 746f 7220 6973 2061 6c73 6f20 mulator is also │ │ │ │ │ -0001bc70: 7265 7175 6972 6564 2c20 7375 6368 0a61 required, such.a │ │ │ │ │ -0001bc80: 7320 6d69 6e69 636f 6d2e 2020 5265 6665 s minicom. Refe │ │ │ │ │ -0001bc90: 7220 746f 2061 206d 616e 7561 6c20 6f66 r to a manual of │ │ │ │ │ -0001bca0: 2079 6f75 7220 6f70 6572 6174 696e 6720 your operating │ │ │ │ │ -0001bcb0: 7379 7374 656d 2c20 666f 7220 6d6f 7265 system, for more │ │ │ │ │ -0001bcc0: 0a69 6e66 6f72 6d61 7469 6f6e 2e0a 0a20 .information... │ │ │ │ │ -0001bcd0: 2020 4173 2066 6f72 2047 5255 422c 2074 As for GRUB, t │ │ │ │ │ -0001bce0: 6865 2069 6e73 7472 7563 7469 6f6e 2074 he instruction t │ │ │ │ │ -0001bcf0: 6f20 7365 7420 7570 2061 2073 6572 6961 o set up a seria │ │ │ │ │ -0001bd00: 6c20 7465 726d 696e 616c 2069 7320 7175 l terminal is qu │ │ │ │ │ -0001bd10: 6974 650a 7369 6d70 6c65 2e20 2048 6572 ite.simple. Her │ │ │ │ │ -0001bd20: 6520 6973 2061 6e20 6578 616d 706c 653a e is an example: │ │ │ │ │ -0001bd30: 0a0a 2020 2020 2067 7275 623e 2073 6572 .. grub> ser │ │ │ │ │ -0001bd40: 6961 6c20 2d2d 756e 6974 3d30 202d 2d73 ial --unit=0 --s │ │ │ │ │ -0001bd50: 7065 6564 3d39 3630 300a 2020 2020 2067 peed=9600. g │ │ │ │ │ -0001bd60: 7275 623e 2074 6572 6d69 6e61 6c5f 696e rub> terminal_in │ │ │ │ │ -0001bd70: 7075 7420 7365 7269 616c 3b20 7465 726d put serial; term │ │ │ │ │ -0001bd80: 696e 616c 5f6f 7574 7075 7420 7365 7269 inal_output seri │ │ │ │ │ -0001bd90: 616c 0a0a 2020 2054 6865 2063 6f6d 6d61 al.. The comma │ │ │ │ │ -0001bda0: 6e64 2027 7365 7269 616c 2720 696e 6974 nd 'serial' init │ │ │ │ │ -0001bdb0: 6961 6c69 7a65 7320 7468 6520 7365 7269 ializes the seri │ │ │ │ │ -0001bdc0: 616c 2075 6e69 7420 3020 7769 7468 2074 al unit 0 with t │ │ │ │ │ -0001bdd0: 6865 2073 7065 6564 0a39 3630 3062 7073 he speed.9600bps │ │ │ │ │ -0001bde0: 2e20 2054 6865 2073 6572 6961 6c20 756e . The serial un │ │ │ │ │ -0001bdf0: 6974 2030 2069 7320 7573 7561 6c6c 7920 it 0 is usually │ │ │ │ │ -0001be00: 6361 6c6c 6564 2027 434f 4d31 272c 2073 called 'COM1', s │ │ │ │ │ -0001be10: 6f2c 2069 6620 796f 7520 7761 6e74 2074 o, if you want t │ │ │ │ │ -0001be20: 6f0a 7573 6520 434f 4d32 2c20 796f 7520 o.use COM2, you │ │ │ │ │ -0001be30: 6d75 7374 2073 7065 6369 6679 2027 2d2d must specify '-- │ │ │ │ │ -0001be40: 756e 6974 3d31 2720 696e 7374 6561 642e unit=1' instead. │ │ │ │ │ -0001be50: 2020 5468 6973 2063 6f6d 6d61 6e64 2061 This command a │ │ │ │ │ -0001be60: 6363 6570 7473 0a6d 616e 7920 6f74 6865 ccepts.many othe │ │ │ │ │ -0001be70: 7220 6f70 7469 6f6e 732c 2073 6f20 706c r options, so pl │ │ │ │ │ -0001be80: 6561 7365 2072 6566 6572 2074 6f20 2a6e ease refer to *n │ │ │ │ │ -0001be90: 6f74 6520 7365 7269 616c 3a3a 2c20 666f ote serial::, fo │ │ │ │ │ -0001bea0: 7220 6d6f 7265 2064 6574 6169 6c73 2e0a r more details.. │ │ │ │ │ -0001beb0: 0a20 2020 5468 6520 636f 6d6d 616e 6473 . The commands │ │ │ │ │ -0001bec0: 2027 7465 726d 696e 616c 5f69 6e70 7574 'terminal_input │ │ │ │ │ -0001bed0: 2720 282a 6e6f 7465 2074 6572 6d69 6e61 ' (*note termina │ │ │ │ │ -0001bee0: 6c5f 696e 7075 743a 3a29 2061 6e64 0a27 l_input::) and.' │ │ │ │ │ -0001bef0: 7465 726d 696e 616c 5f6f 7574 7075 7427 terminal_output' │ │ │ │ │ -0001bf00: 2028 2a6e 6f74 6520 7465 726d 696e 616c (*note terminal │ │ │ │ │ -0001bf10: 5f6f 7574 7075 743a 3a29 2063 686f 6f73 _output::) choos │ │ │ │ │ -0001bf20: 6520 7768 6963 6820 7479 7065 206f 660a e which type of. │ │ │ │ │ -0001bf30: 7465 726d 696e 616c 2079 6f75 2077 616e terminal you wan │ │ │ │ │ -0001bf40: 7420 746f 2075 7365 2e20 2049 6e20 7468 t to use. In th │ │ │ │ │ -0001bf50: 6520 6361 7365 2061 626f 7665 2c20 7468 e case above, th │ │ │ │ │ -0001bf60: 6520 7465 726d 696e 616c 2077 696c 6c20 e terminal will │ │ │ │ │ -0001bf70: 6265 2061 0a73 6572 6961 6c20 7465 726d be a.serial term │ │ │ │ │ -0001bf80: 696e 616c 2c20 6275 7420 796f 7520 6361 inal, but you ca │ │ │ │ │ -0001bf90: 6e20 616c 736f 2070 6173 7320 2763 6f6e n also pass 'con │ │ │ │ │ -0001bfa0: 736f 6c65 2720 746f 2074 6865 2063 6f6d sole' to the com │ │ │ │ │ -0001bfb0: 6d61 6e64 2c20 6173 0a27 7465 726d 696e mand, as.'termin │ │ │ │ │ -0001bfc0: 616c 5f69 6e70 7574 2073 6572 6961 6c20 al_input serial │ │ │ │ │ -0001bfd0: 636f 6e73 6f6c 6527 2e20 2049 6e20 7468 console'. In th │ │ │ │ │ -0001bfe0: 6973 2063 6173 652c 2061 2074 6572 6d69 is case, a termi │ │ │ │ │ -0001bff0: 6e61 6c20 696e 2077 6869 6368 2079 6f75 nal in which you │ │ │ │ │ -0001c000: 0a70 7265 7373 2061 6e79 206b 6579 2077 .press any key w │ │ │ │ │ -0001c010: 696c 6c20 6265 2073 656c 6563 7465 6420 ill be selected │ │ │ │ │ -0001c020: 6173 2061 2047 5255 4220 7465 726d 696e as a GRUB termin │ │ │ │ │ -0001c030: 616c 2e20 2049 6e20 7468 6520 6578 616d al. In the exam │ │ │ │ │ -0001c040: 706c 650a 6162 6f76 652c 206e 6f74 6520 ple.above, note │ │ │ │ │ -0001c050: 7468 6174 2079 6f75 206e 6565 6420 746f that you need to │ │ │ │ │ -0001c060: 2070 7574 2062 6f74 6820 636f 6d6d 616e put both comman │ │ │ │ │ -0001c070: 6473 206f 6e20 7468 6520 7361 6d65 2063 ds on the same c │ │ │ │ │ -0001c080: 6f6d 6d61 6e64 206c 696e 652c 0a61 7320 ommand line,.as │ │ │ │ │ -0001c090: 796f 7520 7769 6c6c 206c 6f73 6520 7468 you will lose th │ │ │ │ │ -0001c0a0: 6520 6162 696c 6974 7920 746f 2074 7970 e ability to typ │ │ │ │ │ -0001c0b0: 6520 636f 6d6d 616e 6473 206f 6e20 7468 e commands on th │ │ │ │ │ -0001c0c0: 6520 636f 6e73 6f6c 6520 6166 7465 7220 e console after │ │ │ │ │ -0001c0d0: 7468 650a 6669 7273 7420 636f 6d6d 616e the.first comman │ │ │ │ │ -0001c0e0: 642e 0a0a 2020 2048 6f77 6576 6572 2c20 d... However, │ │ │ │ │ -0001c0f0: 6e6f 7465 2074 6861 7420 4752 5542 2061 note that GRUB a │ │ │ │ │ -0001c100: 7373 756d 6573 2074 6861 7420 796f 7572 ssumes that your │ │ │ │ │ -0001c110: 2074 6572 6d69 6e61 6c20 656d 756c 6174 terminal emulat │ │ │ │ │ -0001c120: 6f72 2069 730a 636f 6d70 6174 6962 6c65 or is.compatible │ │ │ │ │ -0001c130: 2077 6974 6820 5654 3130 3020 6279 2064 with VT100 by d │ │ │ │ │ -0001c140: 6566 6175 6c74 2e20 2054 6869 7320 6973 efault. This is │ │ │ │ │ -0001c150: 2074 7275 6520 666f 7220 6d6f 7374 2074 true for most t │ │ │ │ │ -0001c160: 6572 6d69 6e61 6c0a 656d 756c 6174 6f72 erminal.emulator │ │ │ │ │ -0001c170: 7320 6e6f 7761 6461 7973 2c20 6275 7420 s nowadays, but │ │ │ │ │ -0001c180: 796f 7520 7368 6f75 6c64 2070 6173 7320 you should pass │ │ │ │ │ -0001c190: 7468 6520 6f70 7469 6f6e 2027 2d2d 6475 the option '--du │ │ │ │ │ -0001c1a0: 6d62 2720 746f 2074 6865 0a63 6f6d 6d61 mb' to the.comma │ │ │ │ │ -0001c1b0: 6e64 2069 6620 796f 7572 2074 6572 6d69 nd if your termi │ │ │ │ │ -0001c1c0: 6e61 6c20 656d 756c 6174 6f72 2069 7320 nal emulator is │ │ │ │ │ -0001c1d0: 6e6f 7420 5654 3130 302d 636f 6d70 6174 not VT100-compat │ │ │ │ │ -0001c1e0: 6962 6c65 206f 7220 696d 706c 656d 656e ible or implemen │ │ │ │ │ -0001c1f0: 7473 0a66 6577 2056 5431 3030 2065 7363 ts.few VT100 esc │ │ │ │ │ -0001c200: 6170 6520 7365 7175 656e 6365 732e 2020 ape sequences. │ │ │ │ │ -0001c210: 4966 2079 6f75 2073 7065 6369 6679 2074 If you specify t │ │ │ │ │ -0001c220: 6869 7320 6f70 7469 6f6e 2074 6865 6e20 his option then │ │ │ │ │ -0001c230: 4752 5542 0a70 726f 7669 6465 7320 796f GRUB.provides yo │ │ │ │ │ -0001c240: 7520 7769 7468 2061 6e20 616c 7465 726e u with an altern │ │ │ │ │ -0001c250: 6174 6976 6520 6d65 6e75 2069 6e74 6572 ative menu inter │ │ │ │ │ -0001c260: 6661 6365 2c20 6265 6361 7573 6520 7468 face, because th │ │ │ │ │ -0001c270: 6520 6e6f 726d 616c 206d 656e 750a 7265 e normal menu.re │ │ │ │ │ -0001c280: 7175 6972 6573 2073 6576 6572 616c 2066 quires several f │ │ │ │ │ -0001c290: 616e 6379 2066 6561 7475 7265 7320 6f66 ancy features of │ │ │ │ │ -0001c2a0: 2079 6f75 7220 7465 726d 696e 616c 2e0a your terminal.. │ │ │ │ │ -0001c2b0: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ -0001c2c0: 666f 2c20 204e 6f64 653a 2056 656e 646f fo, Node: Vendo │ │ │ │ │ -0001c2d0: 7220 706f 7765 722d 6f6e 206b 6579 732c r power-on keys, │ │ │ │ │ -0001c2e0: 2020 4e65 7874 3a20 496d 6167 6573 2c20 Next: Images, │ │ │ │ │ -0001c2f0: 2050 7265 763a 2053 6572 6961 6c20 7465 Prev: Serial te │ │ │ │ │ -0001c300: 726d 696e 616c 2c20 2055 703a 2054 6f70 rminal, Up: Top │ │ │ │ │ -0001c310: 0a0a 3130 2055 7369 6e67 2047 5255 4220 ..10 Using GRUB │ │ │ │ │ -0001c320: 7769 7468 2076 656e 646f 7220 706f 7765 with vendor powe │ │ │ │ │ -0001c330: 722d 6f6e 206b 6579 730a 2a2a 2a2a 2a2a r-on keys.****** │ │ │ │ │ +0001ba90: 2a0a 0a54 6869 7320 6368 6170 7465 7220 *..This chapter │ │ │ │ │ +0001baa0: 6465 7363 7269 6265 7320 686f 7720 746f describes how to │ │ │ │ │ +0001bab0: 2075 7365 2074 6865 2073 6572 6961 6c20 use the serial │ │ │ │ │ +0001bac0: 7465 726d 696e 616c 2073 7570 706f 7274 terminal support │ │ │ │ │ +0001bad0: 2069 6e20 4752 5542 2e0a 0a20 2020 4966 in GRUB... If │ │ │ │ │ +0001bae0: 2079 6f75 2068 6176 6520 6d61 6e79 2063 you have many c │ │ │ │ │ +0001baf0: 6f6d 7075 7465 7273 206f 7220 636f 6d70 omputers or comp │ │ │ │ │ +0001bb00: 7574 6572 7320 7769 7468 206e 6f20 6469 uters with no di │ │ │ │ │ +0001bb10: 7370 6c61 792f 6b65 7962 6f61 7264 2c20 splay/keyboard, │ │ │ │ │ +0001bb20: 6974 0a63 6f75 6c64 2062 6520 7665 7279 it.could be very │ │ │ │ │ +0001bb30: 2075 7365 6675 6c20 746f 2063 6f6e 7472 useful to contr │ │ │ │ │ +0001bb40: 6f6c 2074 6865 2063 6f6d 7075 7465 7273 ol the computers │ │ │ │ │ +0001bb50: 2074 6872 6f75 6768 2073 6572 6961 6c0a through serial. │ │ │ │ │ +0001bb60: 636f 6d6d 756e 6963 6174 696f 6e73 2e20 communications. │ │ │ │ │ +0001bb70: 2054 6f20 636f 6e6e 6563 7420 6f6e 6520 To connect one │ │ │ │ │ +0001bb80: 636f 6d70 7574 6572 2077 6974 6820 616e computer with an │ │ │ │ │ +0001bb90: 6f74 6865 7220 7669 6120 6120 7365 7269 other via a seri │ │ │ │ │ +0001bba0: 616c 206c 696e 652c 0a79 6f75 206e 6565 al line,.you nee │ │ │ │ │ +0001bbb0: 6420 746f 2070 7265 7061 7265 2061 206e d to prepare a n │ │ │ │ │ +0001bbc0: 756c 6c2d 6d6f 6465 6d20 2863 726f 7373 ull-modem (cross │ │ │ │ │ +0001bbd0: 2920 7365 7269 616c 2063 6162 6c65 2c20 ) serial cable, │ │ │ │ │ +0001bbe0: 616e 6420 796f 7520 6d61 7920 6e65 6564 and you may need │ │ │ │ │ +0001bbf0: 0a74 6f20 6861 7665 206d 756c 7469 706f .to have multipo │ │ │ │ │ +0001bc00: 7274 2073 6572 6961 6c20 626f 6172 6473 rt serial boards │ │ │ │ │ +0001bc10: 2c20 6966 2079 6f75 7220 636f 6d70 7574 , if your comput │ │ │ │ │ +0001bc20: 6572 2064 6f65 736e 2774 2068 6176 6520 er doesn't have │ │ │ │ │ +0001bc30: 6578 7472 610a 7365 7269 616c 2070 6f72 extra.serial por │ │ │ │ │ +0001bc40: 7473 2e20 2049 6e20 6164 6469 7469 6f6e ts. In addition │ │ │ │ │ +0001bc50: 2c20 6120 7465 726d 696e 616c 2065 6d75 , a terminal emu │ │ │ │ │ +0001bc60: 6c61 746f 7220 6973 2061 6c73 6f20 7265 lator is also re │ │ │ │ │ +0001bc70: 7175 6972 6564 2c20 7375 6368 0a61 7320 quired, such.as │ │ │ │ │ +0001bc80: 6d69 6e69 636f 6d2e 2020 5265 6665 7220 minicom. Refer │ │ │ │ │ +0001bc90: 746f 2061 206d 616e 7561 6c20 6f66 2079 to a manual of y │ │ │ │ │ +0001bca0: 6f75 7220 6f70 6572 6174 696e 6720 7379 our operating sy │ │ │ │ │ +0001bcb0: 7374 656d 2c20 666f 7220 6d6f 7265 0a69 stem, for more.i │ │ │ │ │ +0001bcc0: 6e66 6f72 6d61 7469 6f6e 2e0a 0a20 2020 nformation... │ │ │ │ │ +0001bcd0: 4173 2066 6f72 2047 5255 422c 2074 6865 As for GRUB, the │ │ │ │ │ +0001bce0: 2069 6e73 7472 7563 7469 6f6e 2074 6f20 instruction to │ │ │ │ │ +0001bcf0: 7365 7420 7570 2061 2073 6572 6961 6c20 set up a serial │ │ │ │ │ +0001bd00: 7465 726d 696e 616c 2069 7320 7175 6974 terminal is quit │ │ │ │ │ +0001bd10: 650a 7369 6d70 6c65 2e20 2048 6572 6520 e.simple. Here │ │ │ │ │ +0001bd20: 6973 2061 6e20 6578 616d 706c 653a 0a0a is an example:.. │ │ │ │ │ +0001bd30: 2020 2020 2067 7275 623e 2073 6572 6961 grub> seria │ │ │ │ │ +0001bd40: 6c20 2d2d 756e 6974 3d30 202d 2d73 7065 l --unit=0 --spe │ │ │ │ │ +0001bd50: 6564 3d39 3630 300a 2020 2020 2067 7275 ed=9600. gru │ │ │ │ │ +0001bd60: 623e 2074 6572 6d69 6e61 6c5f 696e 7075 b> terminal_inpu │ │ │ │ │ +0001bd70: 7420 7365 7269 616c 3b20 7465 726d 696e t serial; termin │ │ │ │ │ +0001bd80: 616c 5f6f 7574 7075 7420 7365 7269 616c al_output serial │ │ │ │ │ +0001bd90: 0a0a 2020 2054 6865 2063 6f6d 6d61 6e64 .. The command │ │ │ │ │ +0001bda0: 2027 7365 7269 616c 2720 696e 6974 6961 'serial' initia │ │ │ │ │ +0001bdb0: 6c69 7a65 7320 7468 6520 7365 7269 616c lizes the serial │ │ │ │ │ +0001bdc0: 2075 6e69 7420 3020 7769 7468 2074 6865 unit 0 with the │ │ │ │ │ +0001bdd0: 2073 7065 6564 0a39 3630 3062 7073 2e20 speed.9600bps. │ │ │ │ │ +0001bde0: 2054 6865 2073 6572 6961 6c20 756e 6974 The serial unit │ │ │ │ │ +0001bdf0: 2030 2069 7320 7573 7561 6c6c 7920 6361 0 is usually ca │ │ │ │ │ +0001be00: 6c6c 6564 2027 434f 4d31 272c 2073 6f2c lled 'COM1', so, │ │ │ │ │ +0001be10: 2069 6620 796f 7520 7761 6e74 2074 6f0a if you want to. │ │ │ │ │ +0001be20: 7573 6520 434f 4d32 2c20 796f 7520 6d75 use COM2, you mu │ │ │ │ │ +0001be30: 7374 2073 7065 6369 6679 2027 2d2d 756e st specify '--un │ │ │ │ │ +0001be40: 6974 3d31 2720 696e 7374 6561 642e 2020 it=1' instead. │ │ │ │ │ +0001be50: 5468 6973 2063 6f6d 6d61 6e64 2061 6363 This command acc │ │ │ │ │ +0001be60: 6570 7473 0a6d 616e 7920 6f74 6865 7220 epts.many other │ │ │ │ │ +0001be70: 6f70 7469 6f6e 732c 2073 6f20 706c 6561 options, so plea │ │ │ │ │ +0001be80: 7365 2072 6566 6572 2074 6f20 2a6e 6f74 se refer to *not │ │ │ │ │ +0001be90: 6520 7365 7269 616c 3a3a 2c20 666f 7220 e serial::, for │ │ │ │ │ +0001bea0: 6d6f 7265 2064 6574 6169 6c73 2e0a 0a20 more details... │ │ │ │ │ +0001beb0: 2020 5468 6520 636f 6d6d 616e 6473 2027 The commands ' │ │ │ │ │ +0001bec0: 7465 726d 696e 616c 5f69 6e70 7574 2720 terminal_input' │ │ │ │ │ +0001bed0: 282a 6e6f 7465 2074 6572 6d69 6e61 6c5f (*note terminal_ │ │ │ │ │ +0001bee0: 696e 7075 743a 3a29 2061 6e64 0a27 7465 input::) and.'te │ │ │ │ │ +0001bef0: 726d 696e 616c 5f6f 7574 7075 7427 2028 rminal_output' ( │ │ │ │ │ +0001bf00: 2a6e 6f74 6520 7465 726d 696e 616c 5f6f *note terminal_o │ │ │ │ │ +0001bf10: 7574 7075 743a 3a29 2063 686f 6f73 6520 utput::) choose │ │ │ │ │ +0001bf20: 7768 6963 6820 7479 7065 206f 660a 7465 which type of.te │ │ │ │ │ +0001bf30: 726d 696e 616c 2079 6f75 2077 616e 7420 rminal you want │ │ │ │ │ +0001bf40: 746f 2075 7365 2e20 2049 6e20 7468 6520 to use. In the │ │ │ │ │ +0001bf50: 6361 7365 2061 626f 7665 2c20 7468 6520 case above, the │ │ │ │ │ +0001bf60: 7465 726d 696e 616c 2077 696c 6c20 6265 terminal will be │ │ │ │ │ +0001bf70: 2061 0a73 6572 6961 6c20 7465 726d 696e a.serial termin │ │ │ │ │ +0001bf80: 616c 2c20 6275 7420 796f 7520 6361 6e20 al, but you can │ │ │ │ │ +0001bf90: 616c 736f 2070 6173 7320 2763 6f6e 736f also pass 'conso │ │ │ │ │ +0001bfa0: 6c65 2720 746f 2074 6865 2063 6f6d 6d61 le' to the comma │ │ │ │ │ +0001bfb0: 6e64 2c20 6173 0a27 7465 726d 696e 616c nd, as.'terminal │ │ │ │ │ +0001bfc0: 5f69 6e70 7574 2073 6572 6961 6c20 636f _input serial co │ │ │ │ │ +0001bfd0: 6e73 6f6c 6527 2e20 2049 6e20 7468 6973 nsole'. In this │ │ │ │ │ +0001bfe0: 2063 6173 652c 2061 2074 6572 6d69 6e61 case, a termina │ │ │ │ │ +0001bff0: 6c20 696e 2077 6869 6368 2079 6f75 0a70 l in which you.p │ │ │ │ │ +0001c000: 7265 7373 2061 6e79 206b 6579 2077 696c ress any key wil │ │ │ │ │ +0001c010: 6c20 6265 2073 656c 6563 7465 6420 6173 l be selected as │ │ │ │ │ +0001c020: 2061 2047 5255 4220 7465 726d 696e 616c a GRUB terminal │ │ │ │ │ +0001c030: 2e20 2049 6e20 7468 6520 6578 616d 706c . In the exampl │ │ │ │ │ +0001c040: 650a 6162 6f76 652c 206e 6f74 6520 7468 e.above, note th │ │ │ │ │ +0001c050: 6174 2079 6f75 206e 6565 6420 746f 2070 at you need to p │ │ │ │ │ +0001c060: 7574 2062 6f74 6820 636f 6d6d 616e 6473 ut both commands │ │ │ │ │ +0001c070: 206f 6e20 7468 6520 7361 6d65 2063 6f6d on the same com │ │ │ │ │ +0001c080: 6d61 6e64 206c 696e 652c 0a61 7320 796f mand line,.as yo │ │ │ │ │ +0001c090: 7520 7769 6c6c 206c 6f73 6520 7468 6520 u will lose the │ │ │ │ │ +0001c0a0: 6162 696c 6974 7920 746f 2074 7970 6520 ability to type │ │ │ │ │ +0001c0b0: 636f 6d6d 616e 6473 206f 6e20 7468 6520 commands on the │ │ │ │ │ +0001c0c0: 636f 6e73 6f6c 6520 6166 7465 7220 7468 console after th │ │ │ │ │ +0001c0d0: 650a 6669 7273 7420 636f 6d6d 616e 642e e.first command. │ │ │ │ │ +0001c0e0: 0a0a 2020 2048 6f77 6576 6572 2c20 6e6f .. However, no │ │ │ │ │ +0001c0f0: 7465 2074 6861 7420 4752 5542 2061 7373 te that GRUB ass │ │ │ │ │ +0001c100: 756d 6573 2074 6861 7420 796f 7572 2074 umes that your t │ │ │ │ │ +0001c110: 6572 6d69 6e61 6c20 656d 756c 6174 6f72 erminal emulator │ │ │ │ │ +0001c120: 2069 730a 636f 6d70 6174 6962 6c65 2077 is.compatible w │ │ │ │ │ +0001c130: 6974 6820 5654 3130 3020 6279 2064 6566 ith VT100 by def │ │ │ │ │ +0001c140: 6175 6c74 2e20 2054 6869 7320 6973 2074 ault. This is t │ │ │ │ │ +0001c150: 7275 6520 666f 7220 6d6f 7374 2074 6572 rue for most ter │ │ │ │ │ +0001c160: 6d69 6e61 6c0a 656d 756c 6174 6f72 7320 minal.emulators │ │ │ │ │ +0001c170: 6e6f 7761 6461 7973 2c20 6275 7420 796f nowadays, but yo │ │ │ │ │ +0001c180: 7520 7368 6f75 6c64 2070 6173 7320 7468 u should pass th │ │ │ │ │ +0001c190: 6520 6f70 7469 6f6e 2027 2d2d 6475 6d62 e option '--dumb │ │ │ │ │ +0001c1a0: 2720 746f 2074 6865 0a63 6f6d 6d61 6e64 ' to the.command │ │ │ │ │ +0001c1b0: 2069 6620 796f 7572 2074 6572 6d69 6e61 if your termina │ │ │ │ │ +0001c1c0: 6c20 656d 756c 6174 6f72 2069 7320 6e6f l emulator is no │ │ │ │ │ +0001c1d0: 7420 5654 3130 302d 636f 6d70 6174 6962 t VT100-compatib │ │ │ │ │ +0001c1e0: 6c65 206f 7220 696d 706c 656d 656e 7473 le or implements │ │ │ │ │ +0001c1f0: 0a66 6577 2056 5431 3030 2065 7363 6170 .few VT100 escap │ │ │ │ │ +0001c200: 6520 7365 7175 656e 6365 732e 2020 4966 e sequences. If │ │ │ │ │ +0001c210: 2079 6f75 2073 7065 6369 6679 2074 6869 you specify thi │ │ │ │ │ +0001c220: 7320 6f70 7469 6f6e 2074 6865 6e20 4752 s option then GR │ │ │ │ │ +0001c230: 5542 0a70 726f 7669 6465 7320 796f 7520 UB.provides you │ │ │ │ │ +0001c240: 7769 7468 2061 6e20 616c 7465 726e 6174 with an alternat │ │ │ │ │ +0001c250: 6976 6520 6d65 6e75 2069 6e74 6572 6661 ive menu interfa │ │ │ │ │ +0001c260: 6365 2c20 6265 6361 7573 6520 7468 6520 ce, because the │ │ │ │ │ +0001c270: 6e6f 726d 616c 206d 656e 750a 7265 7175 normal menu.requ │ │ │ │ │ +0001c280: 6972 6573 2073 6576 6572 616c 2066 616e ires several fan │ │ │ │ │ +0001c290: 6379 2066 6561 7475 7265 7320 6f66 2079 cy features of y │ │ │ │ │ +0001c2a0: 6f75 7220 7465 726d 696e 616c 2e0a 0a1f our terminal.... │ │ │ │ │ +0001c2b0: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ +0001c2c0: 2c20 204e 6f64 653a 2056 656e 646f 7220 , Node: Vendor │ │ │ │ │ +0001c2d0: 706f 7765 722d 6f6e 206b 6579 732c 2020 power-on keys, │ │ │ │ │ +0001c2e0: 4e65 7874 3a20 496d 6167 6573 2c20 2050 Next: Images, P │ │ │ │ │ +0001c2f0: 7265 763a 2053 6572 6961 6c20 7465 726d rev: Serial term │ │ │ │ │ +0001c300: 696e 616c 2c20 2055 703a 2054 6f70 0a0a inal, Up: Top.. │ │ │ │ │ +0001c310: 3130 2055 7369 6e67 2047 5255 4220 7769 10 Using GRUB wi │ │ │ │ │ +0001c320: 7468 2076 656e 646f 7220 706f 7765 722d th vendor power- │ │ │ │ │ +0001c330: 6f6e 206b 6579 730a 2a2a 2a2a 2a2a 2a2a on keys.******** │ │ │ │ │ 0001c340: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -0001c350: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -0001c360: 2a0a 0a53 6f6d 6520 6c61 7074 6f70 2076 *..Some laptop v │ │ │ │ │ -0001c370: 656e 646f 7273 2070 726f 7669 6465 2061 endors provide a │ │ │ │ │ -0001c380: 6e20 6164 6469 7469 6f6e 616c 2070 6f77 n additional pow │ │ │ │ │ -0001c390: 6572 2d6f 6e20 6275 7474 6f6e 2077 6869 er-on button whi │ │ │ │ │ -0001c3a0: 6368 2062 6f6f 7473 0a61 6e6f 7468 6572 ch boots.another │ │ │ │ │ -0001c3b0: 204f 532e 2047 5255 4220 7375 7070 6f72 OS. GRUB suppor │ │ │ │ │ -0001c3c0: 7473 2073 7563 6820 6275 7474 6f6e 7320 ts such buttons │ │ │ │ │ -0001c3d0: 7769 7468 2074 6865 2027 4752 5542 5f54 with the 'GRUB_T │ │ │ │ │ -0001c3e0: 494d 454f 5554 5f42 5554 544f 4e27 2c0a IMEOUT_BUTTON',. │ │ │ │ │ -0001c3f0: 2747 5255 425f 5449 4d45 4f55 545f 5354 'GRUB_TIMEOUT_ST │ │ │ │ │ -0001c400: 594c 455f 4255 5454 4f4e 272c 2027 4752 YLE_BUTTON', 'GR │ │ │ │ │ -0001c410: 5542 5f44 4546 4155 4c54 5f42 5554 544f UB_DEFAULT_BUTTO │ │ │ │ │ -0001c420: 4e27 2c20 616e 640a 2747 5255 425f 4255 N', and.'GRUB_BU │ │ │ │ │ -0001c430: 5454 4f4e 5f43 4d4f 535f 4144 4452 4553 TTON_CMOS_ADDRES │ │ │ │ │ -0001c440: 5327 2076 6172 6961 626c 6573 2069 6e20 S' variables in │ │ │ │ │ -0001c450: 6465 6661 756c 742f 6772 7562 2028 2a6e default/grub (*n │ │ │ │ │ -0001c460: 6f74 6520 5369 6d70 6c65 0a63 6f6e 6669 ote Simple.confi │ │ │ │ │ -0001c470: 6775 7261 7469 6f6e 3a3a 292e 2020 2747 guration::). 'G │ │ │ │ │ -0001c480: 5255 425f 5449 4d45 4f55 545f 4255 5454 RUB_TIMEOUT_BUTT │ │ │ │ │ -0001c490: 4f4e 272c 2027 4752 5542 5f54 494d 454f ON', 'GRUB_TIMEO │ │ │ │ │ -0001c4a0: 5554 5f53 5459 4c45 5f42 5554 544f 4e27 UT_STYLE_BUTTON' │ │ │ │ │ -0001c4b0: 2c0a 616e 6420 2747 5255 425f 4445 4641 ,.and 'GRUB_DEFA │ │ │ │ │ -0001c4c0: 554c 545f 4255 5454 4f4e 2720 6172 6520 ULT_BUTTON' are │ │ │ │ │ -0001c4d0: 7573 6564 2069 6e73 7465 6164 206f 6620 used instead of │ │ │ │ │ -0001c4e0: 7468 6520 636f 7272 6573 706f 6e64 696e the correspondin │ │ │ │ │ -0001c4f0: 670a 7661 7269 6162 6c65 7320 7769 7468 g.variables with │ │ │ │ │ -0001c500: 6f75 7420 7468 6520 275f 4255 5454 4f4e out the '_BUTTON │ │ │ │ │ -0001c510: 2720 7375 6666 6978 2077 6865 6e20 706f ' suffix when po │ │ │ │ │ -0001c520: 7765 7265 6420 6f6e 2075 7369 6e67 2074 wered on using t │ │ │ │ │ -0001c530: 6865 2073 7065 6369 616c 0a62 7574 746f he special.butto │ │ │ │ │ -0001c540: 6e2e 2020 2747 5255 425f 4255 5454 4f4e n. 'GRUB_BUTTON │ │ │ │ │ -0001c550: 5f43 4d4f 535f 4144 4452 4553 5327 2069 _CMOS_ADDRESS' i │ │ │ │ │ -0001c560: 7320 7665 6e64 6f72 2d73 7065 6369 6669 s vendor-specifi │ │ │ │ │ -0001c570: 6320 616e 6420 7061 7274 6961 6c6c 790a c and partially. │ │ │ │ │ -0001c580: 6d6f 6465 6c2d 7370 6563 6966 6963 2e20 model-specific. │ │ │ │ │ -0001c590: 2056 616c 7565 7320 6b6e 6f77 6e20 746f Values known to │ │ │ │ │ -0001c5a0: 2074 6865 2047 5255 4220 7465 616d 2061 the GRUB team a │ │ │ │ │ -0001c5b0: 7265 3a0a 0a3c 4465 6c6c 2058 5053 204d re:... 121: │ │ │ │ │ -0001c5d0: 330a 3c44 656c 6c20 5850 5320 4d31 3533 3.. 85:3.. 85:3. │ │ │ │ │ -0001c620: 0a20 2020 2020 3834 3a31 2028 756e 636f . 84:1 (unco │ │ │ │ │ -0001c630: 6e66 6972 6d65 6429 0a3c 4c45 4e4f 564f nfirmed).. │ │ │ │ │ -0001c660: 3130 313a 330a 0a20 2020 546f 2074 616b 101:3.. To tak │ │ │ │ │ -0001c670: 6520 6675 6c6c 2061 6476 616e 7461 6765 e full advantage │ │ │ │ │ -0001c680: 206f 6620 7468 6973 2066 756e 6374 696f of this functio │ │ │ │ │ -0001c690: 6e2c 2069 6e73 7461 6c6c 2047 5255 4220 n, install GRUB │ │ │ │ │ -0001c6a0: 696e 746f 2074 6865 204d 4252 0a28 2a6e into the MBR.(*n │ │ │ │ │ -0001c6b0: 6f74 6520 496e 7374 616c 6c69 6e67 2047 ote Installing G │ │ │ │ │ -0001c6c0: 5255 4220 7573 696e 6720 6772 7562 2d69 RUB using grub-i │ │ │ │ │ -0001c6d0: 6e73 7461 6c6c 3a3a 292e 0a0a 2020 2049 nstall::)... I │ │ │ │ │ -0001c6e0: 6620 796f 7520 6861 7665 2061 206c 6170 f you have a lap │ │ │ │ │ -0001c6f0: 746f 7020 7768 6963 6820 6861 7320 6120 top which has a │ │ │ │ │ -0001c700: 7369 6d69 6c61 7220 6665 6174 7572 6520 similar feature │ │ │ │ │ -0001c710: 616e 6420 6e6f 7420 696e 2074 6865 2061 and not in the a │ │ │ │ │ -0001c720: 626f 7665 0a6c 6973 7420 636f 756c 6420 bove.list could │ │ │ │ │ -0001c730: 796f 7520 6669 6775 7265 2079 6f75 7220 you figure your │ │ │ │ │ -0001c740: 6164 6472 6573 7320 616e 6420 636f 6e74 address and cont │ │ │ │ │ -0001c750: 7269 6275 7465 3f20 2054 6f20 6469 7363 ribute? To disc │ │ │ │ │ -0001c760: 6f76 6572 2074 6865 0a61 6464 7265 7373 over the.address │ │ │ │ │ -0001c770: 2064 6f20 7468 6520 666f 6c6c 6f77 696e do the followin │ │ │ │ │ -0001c780: 673a 0a20 2020 2a20 626f 6f74 206e 6f72 g:. * boot nor │ │ │ │ │ -0001c790: 6d61 6c6c 790a 2020 202a 2020 2020 2020 mally. * │ │ │ │ │ -0001c7a0: 7375 646f 206d 6f64 7072 6f62 6520 6e76 sudo modprobe nv │ │ │ │ │ -0001c7b0: 7261 6d0a 2020 2020 2020 2020 2020 7375 ram. su │ │ │ │ │ -0001c7c0: 646f 2063 6174 202f 6465 762f 6e76 7261 do cat /dev/nvra │ │ │ │ │ -0001c7d0: 6d20 7c20 7878 6420 3e20 6e6f 726d 616c m | xxd > normal │ │ │ │ │ -0001c7e0: 5f62 7574 746f 6e2e 7478 740a 2020 202a _button.txt. * │ │ │ │ │ -0001c7f0: 2062 6f6f 7420 7573 696e 6720 7665 6e64 boot using vend │ │ │ │ │ -0001c800: 6f72 2062 7574 746f 6e0a 2020 202a 2020 or button. * │ │ │ │ │ -0001c810: 2020 2020 7375 646f 206d 6f64 7072 6f62 sudo modprob │ │ │ │ │ -0001c820: 6520 6e76 7261 6d0a 2020 2020 2020 2020 e nvram. │ │ │ │ │ -0001c830: 2020 7375 646f 2063 6174 202f 6465 762f sudo cat /dev/ │ │ │ │ │ -0001c840: 6e76 7261 6d20 7c20 7878 6420 3e20 6e6f nvram | xxd > no │ │ │ │ │ -0001c850: 726d 616c 5f76 656e 646f 722e 7478 740a rmal_vendor.txt. │ │ │ │ │ -0001c860: 0a20 2020 5468 656e 2063 6f6d 7061 7265 . Then compare │ │ │ │ │ -0001c870: 2074 6865 7365 2074 6578 7420 6669 6c65 these text file │ │ │ │ │ -0001c880: 7320 616e 6420 6669 6e64 2077 6865 7265 s and find where │ │ │ │ │ -0001c890: 2061 2062 6974 2077 6173 2074 6f67 676c a bit was toggl │ │ │ │ │ -0001c8a0: 6564 2e20 2045 2e67 2e0a 696e 2063 6173 ed. E.g..in cas │ │ │ │ │ -0001c8b0: 6520 6f66 2044 656c 6c20 5850 5320 6974 e of Dell XPS it │ │ │ │ │ -0001c8c0: 2077 6173 3a0a 2020 2020 2062 7974 6520 was:. byte │ │ │ │ │ -0001c8d0: 3078 3437 3a20 3230 202d 2d3e 2032 380a 0x47: 20 --> 28. │ │ │ │ │ -0001c8e0: 2020 2049 7427 7320 6120 6269 7420 6e75 It's a bit nu │ │ │ │ │ -0001c8f0: 6d62 6572 2033 2061 7320 7365 656e 2066 mber 3 as seen f │ │ │ │ │ -0001c900: 726f 6d20 666f 6c6c 6f77 696e 6720 7461 rom following ta │ │ │ │ │ -0001c910: 626c 653a 0a30 2020 2020 2020 2020 2020 ble:.0 │ │ │ │ │ -0001c920: 2020 2020 3031 0a31 2020 2020 2020 2020 01.1 │ │ │ │ │ -0001c930: 2020 2020 2020 3032 0a32 2020 2020 2020 02.2 │ │ │ │ │ -0001c940: 2020 2020 2020 2020 3034 0a33 2020 2020 04.3 │ │ │ │ │ -0001c950: 2020 2020 2020 2020 2020 3038 0a34 2020 08.4 │ │ │ │ │ -0001c960: 2020 2020 2020 2020 2020 2020 3130 0a35 10.5 │ │ │ │ │ -0001c970: 2020 2020 2020 2020 2020 2020 2020 3230 20 │ │ │ │ │ -0001c980: 0a36 2020 2020 2020 2020 2020 2020 2020 .6 │ │ │ │ │ -0001c990: 3430 0a37 2020 2020 2020 2020 2020 2020 40.7 │ │ │ │ │ -0001c9a0: 2020 3830 0a0a 2020 2030 7834 3720 6973 80.. 0x47 is │ │ │ │ │ -0001c9b0: 2064 6563 696d 616c 2037 312e 2020 4c69 decimal 71. Li │ │ │ │ │ -0001c9c0: 6e75 7820 6e76 7261 6d20 696d 706c 656d nux nvram implem │ │ │ │ │ -0001c9d0: 656e 7461 7469 6f6e 2063 7574 7320 6669 entation cuts fi │ │ │ │ │ -0001c9e0: 7273 7420 3134 2062 7974 6573 0a6f 6620 rst 14 bytes.of │ │ │ │ │ -0001c9f0: 434d 4f53 2e20 536f 2074 6865 2072 6561 CMOS. So the rea │ │ │ │ │ -0001ca00: 6c20 6279 7465 2061 6464 7265 7373 2069 l byte address i │ │ │ │ │ -0001ca10: 6e20 434d 4f53 2069 7320 3731 2b31 343d n CMOS is 71+14= │ │ │ │ │ -0001ca20: 3835 2053 6f20 636f 6d70 6c65 7465 0a61 85 So complete.a │ │ │ │ │ -0001ca30: 6464 7265 7373 2069 7320 3835 3a33 0a0a ddress is 85:3.. │ │ │ │ │ -0001ca40: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ -0001ca50: 6f2c 2020 4e6f 6465 3a20 496d 6167 6573 o, Node: Images │ │ │ │ │ -0001ca60: 2c20 204e 6578 743a 2043 6f72 6520 696d , Next: Core im │ │ │ │ │ -0001ca70: 6167 6520 7369 7a65 206c 696d 6974 6174 age size limitat │ │ │ │ │ -0001ca80: 696f 6e2c 2020 5072 6576 3a20 5665 6e64 ion, Prev: Vend │ │ │ │ │ -0001ca90: 6f72 2070 6f77 6572 2d6f 6e20 6b65 7973 or power-on keys │ │ │ │ │ -0001caa0: 2c20 2055 703a 2054 6f70 0a0a 3131 2047 , Up: Top..11 G │ │ │ │ │ -0001cab0: 5255 4220 696d 6167 6520 6669 6c65 730a RUB image files. │ │ │ │ │ +0001c350: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a ***************. │ │ │ │ │ +0001c360: 0a53 6f6d 6520 6c61 7074 6f70 2076 656e .Some laptop ven │ │ │ │ │ +0001c370: 646f 7273 2070 726f 7669 6465 2061 6e20 dors provide an │ │ │ │ │ +0001c380: 6164 6469 7469 6f6e 616c 2070 6f77 6572 additional power │ │ │ │ │ +0001c390: 2d6f 6e20 6275 7474 6f6e 2077 6869 6368 -on button which │ │ │ │ │ +0001c3a0: 2062 6f6f 7473 0a61 6e6f 7468 6572 204f boots.another O │ │ │ │ │ +0001c3b0: 532e 2047 5255 4220 7375 7070 6f72 7473 S. GRUB supports │ │ │ │ │ +0001c3c0: 2073 7563 6820 6275 7474 6f6e 7320 7769 such buttons wi │ │ │ │ │ +0001c3d0: 7468 2074 6865 2027 4752 5542 5f54 494d th the 'GRUB_TIM │ │ │ │ │ +0001c3e0: 454f 5554 5f42 5554 544f 4e27 2c0a 2747 EOUT_BUTTON',.'G │ │ │ │ │ +0001c3f0: 5255 425f 5449 4d45 4f55 545f 5354 594c RUB_TIMEOUT_STYL │ │ │ │ │ +0001c400: 455f 4255 5454 4f4e 272c 2027 4752 5542 E_BUTTON', 'GRUB │ │ │ │ │ +0001c410: 5f44 4546 4155 4c54 5f42 5554 544f 4e27 _DEFAULT_BUTTON' │ │ │ │ │ +0001c420: 2c20 616e 640a 2747 5255 425f 4255 5454 , and.'GRUB_BUTT │ │ │ │ │ +0001c430: 4f4e 5f43 4d4f 535f 4144 4452 4553 5327 ON_CMOS_ADDRESS' │ │ │ │ │ +0001c440: 2076 6172 6961 626c 6573 2069 6e20 6465 variables in de │ │ │ │ │ +0001c450: 6661 756c 742f 6772 7562 2028 2a6e 6f74 fault/grub (*not │ │ │ │ │ +0001c460: 6520 5369 6d70 6c65 0a63 6f6e 6669 6775 e Simple.configu │ │ │ │ │ +0001c470: 7261 7469 6f6e 3a3a 292e 2020 2747 5255 ration::). 'GRU │ │ │ │ │ +0001c480: 425f 5449 4d45 4f55 545f 4255 5454 4f4e B_TIMEOUT_BUTTON │ │ │ │ │ +0001c490: 272c 2027 4752 5542 5f54 494d 454f 5554 ', 'GRUB_TIMEOUT │ │ │ │ │ +0001c4a0: 5f53 5459 4c45 5f42 5554 544f 4e27 2c0a _STYLE_BUTTON',. │ │ │ │ │ +0001c4b0: 616e 6420 2747 5255 425f 4445 4641 554c and 'GRUB_DEFAUL │ │ │ │ │ +0001c4c0: 545f 4255 5454 4f4e 2720 6172 6520 7573 T_BUTTON' are us │ │ │ │ │ +0001c4d0: 6564 2069 6e73 7465 6164 206f 6620 7468 ed instead of th │ │ │ │ │ +0001c4e0: 6520 636f 7272 6573 706f 6e64 696e 670a e corresponding. │ │ │ │ │ +0001c4f0: 7661 7269 6162 6c65 7320 7769 7468 6f75 variables withou │ │ │ │ │ +0001c500: 7420 7468 6520 275f 4255 5454 4f4e 2720 t the '_BUTTON' │ │ │ │ │ +0001c510: 7375 6666 6978 2077 6865 6e20 706f 7765 suffix when powe │ │ │ │ │ +0001c520: 7265 6420 6f6e 2075 7369 6e67 2074 6865 red on using the │ │ │ │ │ +0001c530: 2073 7065 6369 616c 0a62 7574 746f 6e2e special.button. │ │ │ │ │ +0001c540: 2020 2747 5255 425f 4255 5454 4f4e 5f43 'GRUB_BUTTON_C │ │ │ │ │ +0001c550: 4d4f 535f 4144 4452 4553 5327 2069 7320 MOS_ADDRESS' is │ │ │ │ │ +0001c560: 7665 6e64 6f72 2d73 7065 6369 6669 6320 vendor-specific │ │ │ │ │ +0001c570: 616e 6420 7061 7274 6961 6c6c 790a 6d6f and partially.mo │ │ │ │ │ +0001c580: 6465 6c2d 7370 6563 6966 6963 2e20 2056 del-specific. V │ │ │ │ │ +0001c590: 616c 7565 7320 6b6e 6f77 6e20 746f 2074 alues known to t │ │ │ │ │ +0001c5a0: 6865 2047 5255 4220 7465 616d 2061 7265 he GRUB team are │ │ │ │ │ +0001c5b0: 3a0a 0a3c 4465 6c6c 2058 5053 204d 3133 :... 121:3. │ │ │ │ │ +0001c5d0: 3c44 656c 6c20 5850 5320 4d31 3533 303e │ │ │ │ │ +0001c5e0: 0a20 2020 2020 3835 3a33 0a3c 4465 6c6c . 85:3. │ │ │ │ │ +0001c600: 0a20 2020 2020 3835 3a33 0a3c 4173 7573 . 85:3.. │ │ │ │ │ +0001c620: 2020 2020 3834 3a31 2028 756e 636f 6e66 84:1 (unconf │ │ │ │ │ +0001c630: 6972 6d65 6429 0a3c 4c45 4e4f 564f 2054 irmed).. 10 │ │ │ │ │ +0001c660: 313a 330a 0a20 2020 546f 2074 616b 6520 1:3.. To take │ │ │ │ │ +0001c670: 6675 6c6c 2061 6476 616e 7461 6765 206f full advantage o │ │ │ │ │ +0001c680: 6620 7468 6973 2066 756e 6374 696f 6e2c f this function, │ │ │ │ │ +0001c690: 2069 6e73 7461 6c6c 2047 5255 4220 696e install GRUB in │ │ │ │ │ +0001c6a0: 746f 2074 6865 204d 4252 0a28 2a6e 6f74 to the MBR.(*not │ │ │ │ │ +0001c6b0: 6520 496e 7374 616c 6c69 6e67 2047 5255 e Installing GRU │ │ │ │ │ +0001c6c0: 4220 7573 696e 6720 6772 7562 2d69 6e73 B using grub-ins │ │ │ │ │ +0001c6d0: 7461 6c6c 3a3a 292e 0a0a 2020 2049 6620 tall::)... If │ │ │ │ │ +0001c6e0: 796f 7520 6861 7665 2061 206c 6170 746f you have a lapto │ │ │ │ │ +0001c6f0: 7020 7768 6963 6820 6861 7320 6120 7369 p which has a si │ │ │ │ │ +0001c700: 6d69 6c61 7220 6665 6174 7572 6520 616e milar feature an │ │ │ │ │ +0001c710: 6420 6e6f 7420 696e 2074 6865 2061 626f d not in the abo │ │ │ │ │ +0001c720: 7665 0a6c 6973 7420 636f 756c 6420 796f ve.list could yo │ │ │ │ │ +0001c730: 7520 6669 6775 7265 2079 6f75 7220 6164 u figure your ad │ │ │ │ │ +0001c740: 6472 6573 7320 616e 6420 636f 6e74 7269 dress and contri │ │ │ │ │ +0001c750: 6275 7465 3f20 2054 6f20 6469 7363 6f76 bute? To discov │ │ │ │ │ +0001c760: 6572 2074 6865 0a61 6464 7265 7373 2064 er the.address d │ │ │ │ │ +0001c770: 6f20 7468 6520 666f 6c6c 6f77 696e 673a o the following: │ │ │ │ │ +0001c780: 0a20 2020 2a20 626f 6f74 206e 6f72 6d61 . * boot norma │ │ │ │ │ +0001c790: 6c6c 790a 2020 202a 2020 2020 2020 7375 lly. * su │ │ │ │ │ +0001c7a0: 646f 206d 6f64 7072 6f62 6520 6e76 7261 do modprobe nvra │ │ │ │ │ +0001c7b0: 6d0a 2020 2020 2020 2020 2020 7375 646f m. sudo │ │ │ │ │ +0001c7c0: 2063 6174 202f 6465 762f 6e76 7261 6d20 cat /dev/nvram │ │ │ │ │ +0001c7d0: 7c20 7878 6420 3e20 6e6f 726d 616c 5f62 | xxd > normal_b │ │ │ │ │ +0001c7e0: 7574 746f 6e2e 7478 740a 2020 202a 2062 utton.txt. * b │ │ │ │ │ +0001c7f0: 6f6f 7420 7573 696e 6720 7665 6e64 6f72 oot using vendor │ │ │ │ │ +0001c800: 2062 7574 746f 6e0a 2020 202a 2020 2020 button. * │ │ │ │ │ +0001c810: 2020 7375 646f 206d 6f64 7072 6f62 6520 sudo modprobe │ │ │ │ │ +0001c820: 6e76 7261 6d0a 2020 2020 2020 2020 2020 nvram. │ │ │ │ │ +0001c830: 7375 646f 2063 6174 202f 6465 762f 6e76 sudo cat /dev/nv │ │ │ │ │ +0001c840: 7261 6d20 7c20 7878 6420 3e20 6e6f 726d ram | xxd > norm │ │ │ │ │ +0001c850: 616c 5f76 656e 646f 722e 7478 740a 0a20 al_vendor.txt.. │ │ │ │ │ +0001c860: 2020 5468 656e 2063 6f6d 7061 7265 2074 Then compare t │ │ │ │ │ +0001c870: 6865 7365 2074 6578 7420 6669 6c65 7320 hese text files │ │ │ │ │ +0001c880: 616e 6420 6669 6e64 2077 6865 7265 2061 and find where a │ │ │ │ │ +0001c890: 2062 6974 2077 6173 2074 6f67 676c 6564 bit was toggled │ │ │ │ │ +0001c8a0: 2e20 2045 2e67 2e0a 696e 2063 6173 6520 . E.g..in case │ │ │ │ │ +0001c8b0: 6f66 2044 656c 6c20 5850 5320 6974 2077 of Dell XPS it w │ │ │ │ │ +0001c8c0: 6173 3a0a 2020 2020 2062 7974 6520 3078 as:. byte 0x │ │ │ │ │ +0001c8d0: 3437 3a20 3230 202d 2d3e 2032 380a 2020 47: 20 --> 28. │ │ │ │ │ +0001c8e0: 2049 7427 7320 6120 6269 7420 6e75 6d62 It's a bit numb │ │ │ │ │ +0001c8f0: 6572 2033 2061 7320 7365 656e 2066 726f er 3 as seen fro │ │ │ │ │ +0001c900: 6d20 666f 6c6c 6f77 696e 6720 7461 626c m following tabl │ │ │ │ │ +0001c910: 653a 0a30 2020 2020 2020 2020 2020 2020 e:.0 │ │ │ │ │ +0001c920: 2020 3031 0a31 2020 2020 2020 2020 2020 01.1 │ │ │ │ │ +0001c930: 2020 2020 3032 0a32 2020 2020 2020 2020 02.2 │ │ │ │ │ +0001c940: 2020 2020 2020 3034 0a33 2020 2020 2020 04.3 │ │ │ │ │ +0001c950: 2020 2020 2020 2020 3038 0a34 2020 2020 08.4 │ │ │ │ │ +0001c960: 2020 2020 2020 2020 2020 3130 0a35 2020 10.5 │ │ │ │ │ +0001c970: 2020 2020 2020 2020 2020 2020 3230 0a36 20.6 │ │ │ │ │ +0001c980: 2020 2020 2020 2020 2020 2020 2020 3430 40 │ │ │ │ │ +0001c990: 0a37 2020 2020 2020 2020 2020 2020 2020 .7 │ │ │ │ │ +0001c9a0: 3830 0a0a 2020 2030 7834 3720 6973 2064 80.. 0x47 is d │ │ │ │ │ +0001c9b0: 6563 696d 616c 2037 312e 2020 4c69 6e75 ecimal 71. Linu │ │ │ │ │ +0001c9c0: 7820 6e76 7261 6d20 696d 706c 656d 656e x nvram implemen │ │ │ │ │ +0001c9d0: 7461 7469 6f6e 2063 7574 7320 6669 7273 tation cuts firs │ │ │ │ │ +0001c9e0: 7420 3134 2062 7974 6573 0a6f 6620 434d t 14 bytes.of CM │ │ │ │ │ +0001c9f0: 4f53 2e20 536f 2074 6865 2072 6561 6c20 OS. So the real │ │ │ │ │ +0001ca00: 6279 7465 2061 6464 7265 7373 2069 6e20 byte address in │ │ │ │ │ +0001ca10: 434d 4f53 2069 7320 3731 2b31 343d 3835 CMOS is 71+14=85 │ │ │ │ │ +0001ca20: 2053 6f20 636f 6d70 6c65 7465 0a61 6464 So complete.add │ │ │ │ │ +0001ca30: 7265 7373 2069 7320 3835 3a33 0a0a 1f0a ress is 85:3.... │ │ │ │ │ +0001ca40: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ +0001ca50: 2020 4e6f 6465 3a20 496d 6167 6573 2c20 Node: Images, │ │ │ │ │ +0001ca60: 204e 6578 743a 2043 6f72 6520 696d 6167 Next: Core imag │ │ │ │ │ +0001ca70: 6520 7369 7a65 206c 696d 6974 6174 696f e size limitatio │ │ │ │ │ +0001ca80: 6e2c 2020 5072 6576 3a20 5665 6e64 6f72 n, Prev: Vendor │ │ │ │ │ +0001ca90: 2070 6f77 6572 2d6f 6e20 6b65 7973 2c20 power-on keys, │ │ │ │ │ +0001caa0: 2055 703a 2054 6f70 0a0a 3131 2047 5255 Up: Top..11 GRU │ │ │ │ │ +0001cab0: 4220 696d 6167 6520 6669 6c65 730a 2a2a B image files.** │ │ │ │ │ 0001cac0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -0001cad0: 2a2a 2a0a 0a47 5255 4220 636f 6e73 6973 ***..GRUB consis │ │ │ │ │ -0001cae0: 7473 206f 6620 7365 7665 7261 6c20 696d ts of several im │ │ │ │ │ -0001caf0: 6167 6573 3a20 6120 7661 7269 6574 7920 ages: a variety │ │ │ │ │ -0001cb00: 6f66 2062 6f6f 7473 7472 6170 2069 6d61 of bootstrap ima │ │ │ │ │ -0001cb10: 6765 7320 666f 720a 7374 6172 7469 6e67 ges for.starting │ │ │ │ │ -0001cb20: 2047 5255 4220 696e 2076 6172 696f 7573 GRUB in various │ │ │ │ │ -0001cb30: 2077 6179 732c 2061 206b 6572 6e65 6c20 ways, a kernel │ │ │ │ │ -0001cb40: 696d 6167 652c 2061 6e64 2061 2073 6574 image, and a set │ │ │ │ │ -0001cb50: 206f 6620 6d6f 6475 6c65 730a 7768 6963 of modules.whic │ │ │ │ │ -0001cb60: 6820 6172 6520 636f 6d62 696e 6564 2077 h are combined w │ │ │ │ │ -0001cb70: 6974 6820 7468 6520 6b65 726e 656c 2069 ith the kernel i │ │ │ │ │ -0001cb80: 6d61 6765 2074 6f20 666f 726d 2061 2063 mage to form a c │ │ │ │ │ -0001cb90: 6f72 6520 696d 6167 652e 2020 4865 7265 ore image. Here │ │ │ │ │ -0001cba0: 2069 730a 6120 7368 6f72 7420 6f76 6572 is.a short over │ │ │ │ │ -0001cbb0: 7669 6577 206f 6620 7468 656d 2e0a 0a27 view of them...' │ │ │ │ │ -0001cbc0: 626f 6f74 2e69 6d67 270a 2020 2020 204f boot.img'. O │ │ │ │ │ -0001cbd0: 6e20 5043 2042 494f 5320 7379 7374 656d n PC BIOS system │ │ │ │ │ -0001cbe0: 732c 2074 6869 7320 696d 6167 6520 6973 s, this image is │ │ │ │ │ -0001cbf0: 2074 6865 2066 6972 7374 2070 6172 7420 the first part │ │ │ │ │ -0001cc00: 6f66 2047 5255 4220 746f 2073 7461 7274 of GRUB to start │ │ │ │ │ -0001cc10: 2e0a 2020 2020 2049 7420 6973 2077 7269 .. It is wri │ │ │ │ │ -0001cc20: 7474 656e 2074 6f20 6120 6d61 7374 6572 tten to a master │ │ │ │ │ -0001cc30: 2062 6f6f 7420 7265 636f 7264 2028 4d42 boot record (MB │ │ │ │ │ -0001cc40: 5229 206f 7220 746f 2074 6865 2062 6f6f R) or to the boo │ │ │ │ │ -0001cc50: 7420 7365 6374 6f72 0a20 2020 2020 6f66 t sector. of │ │ │ │ │ -0001cc60: 2061 2070 6172 7469 7469 6f6e 2e20 2042 a partition. B │ │ │ │ │ -0001cc70: 6563 6175 7365 2061 2050 4320 626f 6f74 ecause a PC boot │ │ │ │ │ -0001cc80: 2073 6563 746f 7220 6973 2035 3132 2062 sector is 512 b │ │ │ │ │ -0001cc90: 7974 6573 2c20 7468 6520 7369 7a65 206f ytes, the size o │ │ │ │ │ -0001cca0: 660a 2020 2020 2074 6869 7320 696d 6167 f. this imag │ │ │ │ │ -0001ccb0: 6520 6973 2065 7861 6374 6c79 2035 3132 e is exactly 512 │ │ │ │ │ -0001ccc0: 2062 7974 6573 2e0a 0a20 2020 2020 5468 bytes... Th │ │ │ │ │ -0001ccd0: 6520 736f 6c65 2066 756e 6374 696f 6e20 e sole function │ │ │ │ │ -0001cce0: 6f66 2027 626f 6f74 2e69 6d67 2720 6973 of 'boot.img' is │ │ │ │ │ -0001ccf0: 2074 6f20 7265 6164 2074 6865 2066 6972 to read the fir │ │ │ │ │ -0001cd00: 7374 2073 6563 746f 7220 6f66 2074 6865 st sector of the │ │ │ │ │ -0001cd10: 0a20 2020 2020 636f 7265 2069 6d61 6765 . core image │ │ │ │ │ -0001cd20: 2066 726f 6d20 6120 6c6f 6361 6c20 6469 from a local di │ │ │ │ │ -0001cd30: 736b 2061 6e64 206a 756d 7020 746f 2069 sk and jump to i │ │ │ │ │ -0001cd40: 742e 2020 4265 6361 7573 6520 6f66 2074 t. Because of t │ │ │ │ │ -0001cd50: 6865 2073 697a 650a 2020 2020 2072 6573 he size. res │ │ │ │ │ -0001cd60: 7472 6963 7469 6f6e 2c20 2762 6f6f 742e triction, 'boot. │ │ │ │ │ -0001cd70: 696d 6727 2063 616e 6e6f 7420 756e 6465 img' cannot unde │ │ │ │ │ -0001cd80: 7273 7461 6e64 2061 6e79 2066 696c 6520 rstand any file │ │ │ │ │ -0001cd90: 7379 7374 656d 0a20 2020 2020 7374 7275 system. stru │ │ │ │ │ -0001cda0: 6374 7572 652c 2073 6f20 2767 7275 622d cture, so 'grub- │ │ │ │ │ -0001cdb0: 696e 7374 616c 6c27 2068 6172 6463 6f64 install' hardcod │ │ │ │ │ -0001cdc0: 6573 2074 6865 206c 6f63 6174 696f 6e20 es the location │ │ │ │ │ -0001cdd0: 6f66 2074 6865 2066 6972 7374 0a20 2020 of the first. │ │ │ │ │ -0001cde0: 2020 7365 6374 6f72 206f 6620 7468 6520 sector of the │ │ │ │ │ -0001cdf0: 636f 7265 2069 6d61 6765 2069 6e74 6f20 core image into │ │ │ │ │ -0001ce00: 2762 6f6f 742e 696d 6727 2077 6865 6e20 'boot.img' when │ │ │ │ │ -0001ce10: 696e 7374 616c 6c69 6e67 2047 5255 422e installing GRUB. │ │ │ │ │ -0001ce20: 0a0a 2764 6973 6b62 6f6f 742e 696d 6727 ..'diskboot.img' │ │ │ │ │ -0001ce30: 0a20 2020 2020 5468 6973 2069 6d61 6765 . This image │ │ │ │ │ -0001ce40: 2069 7320 7573 6564 2061 7320 7468 6520 is used as the │ │ │ │ │ -0001ce50: 6669 7273 7420 7365 6374 6f72 206f 6620 first sector of │ │ │ │ │ -0001ce60: 7468 6520 636f 7265 2069 6d61 6765 2077 the core image w │ │ │ │ │ -0001ce70: 6865 6e0a 2020 2020 2062 6f6f 7469 6e67 hen. booting │ │ │ │ │ -0001ce80: 2066 726f 6d20 6120 6861 7264 2064 6973 from a hard dis │ │ │ │ │ -0001ce90: 6b2e 2020 4974 2072 6561 6473 2074 6865 k. It reads the │ │ │ │ │ -0001cea0: 2072 6573 7420 6f66 2074 6865 2063 6f72 rest of the cor │ │ │ │ │ -0001ceb0: 6520 696d 6167 6520 696e 746f 0a20 2020 e image into. │ │ │ │ │ -0001cec0: 2020 6d65 6d6f 7279 2061 6e64 2073 7461 memory and sta │ │ │ │ │ -0001ced0: 7274 7320 7468 6520 6b65 726e 656c 2e20 rts the kernel. │ │ │ │ │ -0001cee0: 2053 696e 6365 2066 696c 6520 7379 7374 Since file syst │ │ │ │ │ -0001cef0: 656d 2068 616e 646c 696e 6720 6973 206e em handling is n │ │ │ │ │ -0001cf00: 6f74 0a20 2020 2020 7965 7420 6176 6169 ot. yet avai │ │ │ │ │ -0001cf10: 6c61 626c 652c 2069 7420 656e 636f 6465 lable, it encode │ │ │ │ │ -0001cf20: 7320 7468 6520 6c6f 6361 7469 6f6e 206f s the location o │ │ │ │ │ -0001cf30: 6620 7468 6520 636f 7265 2069 6d61 6765 f the core image │ │ │ │ │ -0001cf40: 2075 7369 6e67 2061 0a20 2020 2020 626c using a. bl │ │ │ │ │ -0001cf50: 6f63 6b20 6c69 7374 2066 6f72 6d61 742e ock list format. │ │ │ │ │ -0001cf60: 0a0a 2763 6462 6f6f 742e 696d 6727 0a20 ..'cdboot.img'. │ │ │ │ │ -0001cf70: 2020 2020 5468 6973 2069 6d61 6765 2069 This image i │ │ │ │ │ -0001cf80: 7320 7573 6564 2061 7320 7468 6520 6669 s used as the fi │ │ │ │ │ -0001cf90: 7273 7420 7365 6374 6f72 206f 6620 7468 rst sector of th │ │ │ │ │ -0001cfa0: 6520 636f 7265 2069 6d61 6765 2077 6865 e core image whe │ │ │ │ │ -0001cfb0: 6e0a 2020 2020 2062 6f6f 7469 6e67 2066 n. booting f │ │ │ │ │ -0001cfc0: 726f 6d20 6120 4344 2d52 4f4d 2064 7269 rom a CD-ROM dri │ │ │ │ │ -0001cfd0: 7665 2e20 2049 7420 7065 7266 6f72 6d73 ve. It performs │ │ │ │ │ -0001cfe0: 2061 2073 696d 696c 6172 2066 756e 6374 a similar funct │ │ │ │ │ -0001cff0: 696f 6e20 746f 0a20 2020 2020 2764 6973 ion to. 'dis │ │ │ │ │ -0001d000: 6b62 6f6f 742e 696d 6727 2e0a 0a27 7078 kboot.img'...'px │ │ │ │ │ -0001d010: 6562 6f6f 742e 696d 6727 0a20 2020 2020 eboot.img'. │ │ │ │ │ -0001d020: 5468 6973 2069 6d61 6765 2069 7320 7573 This image is us │ │ │ │ │ -0001d030: 6564 2061 7320 7468 6520 7374 6172 7420 ed as the start │ │ │ │ │ -0001d040: 6f66 2074 6865 2063 6f72 6520 696d 6167 of the core imag │ │ │ │ │ -0001d050: 6520 7768 656e 2062 6f6f 7469 6e67 2066 e when booting f │ │ │ │ │ -0001d060: 726f 6d0a 2020 2020 2074 6865 206e 6574 rom. the net │ │ │ │ │ -0001d070: 776f 726b 2075 7369 6e67 2050 5845 2e20 work using PXE. │ │ │ │ │ -0001d080: 2a4e 6f74 6520 4e65 7477 6f72 6b3a 3a2e *Note Network::. │ │ │ │ │ -0001d090: 0a0a 276c 6e78 626f 6f74 2e69 6d67 270a ..'lnxboot.img'. │ │ │ │ │ -0001d0a0: 2020 2020 2054 6869 7320 696d 6167 6520 This image │ │ │ │ │ -0001d0b0: 6d61 7920 6265 2070 6c61 6365 6420 6174 may be placed at │ │ │ │ │ -0001d0c0: 2074 6865 2073 7461 7274 206f 6620 7468 the start of th │ │ │ │ │ -0001d0d0: 6520 636f 7265 2069 6d61 6765 2069 6e20 e core image in │ │ │ │ │ -0001d0e0: 6f72 6465 7220 746f 0a20 2020 2020 6d61 order to. ma │ │ │ │ │ -0001d0f0: 6b65 2047 5255 4220 6c6f 6f6b 2065 6e6f ke GRUB look eno │ │ │ │ │ -0001d100: 7567 6820 6c69 6b65 2061 204c 696e 7578 ugh like a Linux │ │ │ │ │ -0001d110: 206b 6572 6e65 6c20 7468 6174 2069 7420 kernel that it │ │ │ │ │ -0001d120: 6361 6e20 6265 2062 6f6f 7465 6420 6279 can be booted by │ │ │ │ │ -0001d130: 0a20 2020 2020 4c49 4c4f 2075 7369 6e67 . LILO using │ │ │ │ │ -0001d140: 2061 6e20 2769 6d61 6765 3d27 2073 6563 an 'image=' sec │ │ │ │ │ -0001d150: 7469 6f6e 2e0a 0a27 6b65 726e 656c 2e69 tion...'kernel.i │ │ │ │ │ -0001d160: 6d67 270a 2020 2020 2054 6869 7320 696d mg'. This im │ │ │ │ │ -0001d170: 6167 6520 636f 6e74 6169 6e73 2047 5255 age contains GRU │ │ │ │ │ -0001d180: 4227 7320 6261 7369 6320 7275 6e2d 7469 B's basic run-ti │ │ │ │ │ -0001d190: 6d65 2066 6163 696c 6974 6965 733a 2066 me facilities: f │ │ │ │ │ -0001d1a0: 7261 6d65 776f 726b 730a 2020 2020 2066 rameworks. f │ │ │ │ │ -0001d1b0: 6f72 2064 6576 6963 6520 616e 6420 6669 or device and fi │ │ │ │ │ -0001d1c0: 6c65 2068 616e 646c 696e 672c 2065 6e76 le handling, env │ │ │ │ │ -0001d1d0: 6972 6f6e 6d65 6e74 2076 6172 6961 626c ironment variabl │ │ │ │ │ -0001d1e0: 6573 2c20 7468 6520 7265 7363 7565 0a20 es, the rescue. │ │ │ │ │ -0001d1f0: 2020 2020 6d6f 6465 2063 6f6d 6d61 6e64 mode command │ │ │ │ │ -0001d200: 2d6c 696e 6520 7061 7273 6572 2c20 616e -line parser, an │ │ │ │ │ -0001d210: 6420 736f 206f 6e2e 2020 4974 2069 7320 d so on. It is │ │ │ │ │ -0001d220: 7261 7265 6c79 2075 7365 6420 6469 7265 rarely used dire │ │ │ │ │ -0001d230: 6374 6c79 2c0a 2020 2020 2062 7574 2069 ctly,. but i │ │ │ │ │ -0001d240: 7320 6275 696c 7420 696e 746f 2061 6c6c s built into all │ │ │ │ │ -0001d250: 2063 6f72 6520 696d 6167 6573 2e0a 0a27 core images...' │ │ │ │ │ -0001d260: 636f 7265 2e69 6d67 270a 2020 2020 2054 core.img'. T │ │ │ │ │ -0001d270: 6869 7320 6973 2074 6865 2063 6f72 6520 his is the core │ │ │ │ │ -0001d280: 696d 6167 6520 6f66 2047 5255 422e 2049 image of GRUB. I │ │ │ │ │ -0001d290: 7420 6973 2062 7569 6c74 2064 796e 616d t is built dynam │ │ │ │ │ -0001d2a0: 6963 616c 6c79 2066 726f 6d20 7468 650a ically from the. │ │ │ │ │ -0001d2b0: 2020 2020 206b 6572 6e65 6c20 696d 6167 kernel imag │ │ │ │ │ -0001d2c0: 6520 616e 6420 616e 2061 7262 6974 7261 e and an arbitra │ │ │ │ │ -0001d2d0: 7279 206c 6973 7420 6f66 206d 6f64 756c ry list of modul │ │ │ │ │ -0001d2e0: 6573 2062 7920 7468 6520 2767 7275 622d es by the 'grub- │ │ │ │ │ -0001d2f0: 6d6b 696d 6167 6527 0a20 2020 2020 7072 mkimage'. pr │ │ │ │ │ -0001d300: 6f67 7261 6d2e 2020 5573 7561 6c6c 792c ogram. Usually, │ │ │ │ │ -0001d310: 2069 7420 636f 6e74 6169 6e73 2065 6e6f it contains eno │ │ │ │ │ -0001d320: 7567 6820 6d6f 6475 6c65 7320 746f 2061 ugh modules to a │ │ │ │ │ -0001d330: 6363 6573 730a 2020 2020 2027 2f62 6f6f ccess. '/boo │ │ │ │ │ -0001d340: 742f 6772 7562 272c 2061 6e64 206c 6f61 t/grub', and loa │ │ │ │ │ -0001d350: 6473 2065 7665 7279 7468 696e 6720 656c ds everything el │ │ │ │ │ -0001d360: 7365 2028 696e 636c 7564 696e 6720 6d65 se (including me │ │ │ │ │ -0001d370: 6e75 2068 616e 646c 696e 672c 0a20 2020 nu handling,. │ │ │ │ │ -0001d380: 2020 7468 6520 6162 696c 6974 7920 746f the ability to │ │ │ │ │ -0001d390: 206c 6f61 6420 7461 7267 6574 206f 7065 load target ope │ │ │ │ │ -0001d3a0: 7261 7469 6e67 2073 7973 7465 6d73 2c20 rating systems, │ │ │ │ │ -0001d3b0: 616e 6420 736f 206f 6e29 2066 726f 6d20 and so on) from │ │ │ │ │ -0001d3c0: 7468 650a 2020 2020 2066 696c 6520 7379 the. file sy │ │ │ │ │ -0001d3d0: 7374 656d 2061 7420 7275 6e2d 7469 6d65 stem at run-time │ │ │ │ │ -0001d3e0: 2e20 2054 6865 206d 6f64 756c 6172 2064 . The modular d │ │ │ │ │ -0001d3f0: 6573 6967 6e20 616c 6c6f 7773 2074 6865 esign allows the │ │ │ │ │ -0001d400: 2063 6f72 6520 696d 6167 650a 2020 2020 core image. │ │ │ │ │ -0001d410: 2074 6f20 6265 206b 6570 7420 736d 616c to be kept smal │ │ │ │ │ -0001d420: 6c2c 2073 696e 6365 2074 6865 2061 7265 l, since the are │ │ │ │ │ -0001d430: 6173 206f 6620 6469 736b 2077 6865 7265 as of disk where │ │ │ │ │ -0001d440: 2069 7420 6d75 7374 2062 650a 2020 2020 it must be. │ │ │ │ │ -0001d450: 2069 6e73 7461 6c6c 6564 2061 7265 206f installed are o │ │ │ │ │ -0001d460: 6674 656e 2061 7320 736d 616c 6c20 6173 ften as small as │ │ │ │ │ -0001d470: 2033 324b 422e 0a0a 2020 2020 202a 4e6f 32KB... *No │ │ │ │ │ -0001d480: 7465 2042 494f 5320 696e 7374 616c 6c61 te BIOS installa │ │ │ │ │ -0001d490: 7469 6f6e 3a3a 2c20 666f 7220 6465 7461 tion::, for deta │ │ │ │ │ -0001d4a0: 696c 7320 6f6e 2077 6865 7265 2074 6865 ils on where the │ │ │ │ │ -0001d4b0: 2063 6f72 6520 696d 6167 6520 6361 6e0a core image can. │ │ │ │ │ -0001d4c0: 2020 2020 2062 6520 696e 7374 616c 6c65 be installe │ │ │ │ │ -0001d4d0: 6420 6f6e 2050 4320 7379 7374 656d 732e d on PC systems. │ │ │ │ │ -0001d4e0: 0a0a 272a 2e6d 6f64 270a 2020 2020 2045 ..'*.mod'. E │ │ │ │ │ -0001d4f0: 7665 7279 7468 696e 6720 656c 7365 2069 verything else i │ │ │ │ │ -0001d500: 6e20 4752 5542 2072 6573 6964 6573 2069 n GRUB resides i │ │ │ │ │ -0001d510: 6e20 6479 6e61 6d69 6361 6c6c 7920 6c6f n dynamically lo │ │ │ │ │ -0001d520: 6164 6162 6c65 206d 6f64 756c 6573 2e0a adable modules.. │ │ │ │ │ -0001d530: 2020 2020 2054 6865 7365 2061 7265 206f These are o │ │ │ │ │ -0001d540: 6674 656e 206c 6f61 6465 6420 6175 746f ften loaded auto │ │ │ │ │ -0001d550: 6d61 7469 6361 6c6c 792c 206f 7220 6275 matically, or bu │ │ │ │ │ -0001d560: 696c 7420 696e 746f 2074 6865 2063 6f72 ilt into the cor │ │ │ │ │ -0001d570: 6520 696d 6167 650a 2020 2020 2069 6620 e image. if │ │ │ │ │ -0001d580: 7468 6579 2061 7265 2065 7373 656e 7469 they are essenti │ │ │ │ │ -0001d590: 616c 2c20 6275 7420 6d61 7920 616c 736f al, but may also │ │ │ │ │ -0001d5a0: 2062 6520 6c6f 6164 6564 206d 616e 7561 be loaded manua │ │ │ │ │ -0001d5b0: 6c6c 7920 7573 696e 6720 7468 650a 2020 lly using the. │ │ │ │ │ -0001d5c0: 2020 2027 696e 736d 6f64 2720 636f 6d6d 'insmod' comm │ │ │ │ │ -0001d5d0: 616e 6420 282a 6e6f 7465 2069 6e73 6d6f and (*note insmo │ │ │ │ │ -0001d5e0: 643a 3a29 2e0a 0a46 6f72 2047 5255 4220 d::)...For GRUB │ │ │ │ │ -0001d5f0: 4c65 6761 6379 2075 7365 7273 0a3d 3d3d Legacy users.=== │ │ │ │ │ +0001cad0: 2a0a 0a47 5255 4220 636f 6e73 6973 7473 *..GRUB consists │ │ │ │ │ +0001cae0: 206f 6620 7365 7665 7261 6c20 696d 6167 of several imag │ │ │ │ │ +0001caf0: 6573 3a20 6120 7661 7269 6574 7920 6f66 es: a variety of │ │ │ │ │ +0001cb00: 2062 6f6f 7473 7472 6170 2069 6d61 6765 bootstrap image │ │ │ │ │ +0001cb10: 7320 666f 720a 7374 6172 7469 6e67 2047 s for.starting G │ │ │ │ │ +0001cb20: 5255 4220 696e 2076 6172 696f 7573 2077 RUB in various w │ │ │ │ │ +0001cb30: 6179 732c 2061 206b 6572 6e65 6c20 696d ays, a kernel im │ │ │ │ │ +0001cb40: 6167 652c 2061 6e64 2061 2073 6574 206f age, and a set o │ │ │ │ │ +0001cb50: 6620 6d6f 6475 6c65 730a 7768 6963 6820 f modules.which │ │ │ │ │ +0001cb60: 6172 6520 636f 6d62 696e 6564 2077 6974 are combined wit │ │ │ │ │ +0001cb70: 6820 7468 6520 6b65 726e 656c 2069 6d61 h the kernel ima │ │ │ │ │ +0001cb80: 6765 2074 6f20 666f 726d 2061 2063 6f72 ge to form a cor │ │ │ │ │ +0001cb90: 6520 696d 6167 652e 2020 4865 7265 2069 e image. Here i │ │ │ │ │ +0001cba0: 730a 6120 7368 6f72 7420 6f76 6572 7669 s.a short overvi │ │ │ │ │ +0001cbb0: 6577 206f 6620 7468 656d 2e0a 0a27 626f ew of them...'bo │ │ │ │ │ +0001cbc0: 6f74 2e69 6d67 270a 2020 2020 204f 6e20 ot.img'. On │ │ │ │ │ +0001cbd0: 5043 2042 494f 5320 7379 7374 656d 732c PC BIOS systems, │ │ │ │ │ +0001cbe0: 2074 6869 7320 696d 6167 6520 6973 2074 this image is t │ │ │ │ │ +0001cbf0: 6865 2066 6972 7374 2070 6172 7420 6f66 he first part of │ │ │ │ │ +0001cc00: 2047 5255 4220 746f 2073 7461 7274 2e0a GRUB to start.. │ │ │ │ │ +0001cc10: 2020 2020 2049 7420 6973 2077 7269 7474 It is writt │ │ │ │ │ +0001cc20: 656e 2074 6f20 6120 6d61 7374 6572 2062 en to a master b │ │ │ │ │ +0001cc30: 6f6f 7420 7265 636f 7264 2028 4d42 5229 oot record (MBR) │ │ │ │ │ +0001cc40: 206f 7220 746f 2074 6865 2062 6f6f 7420 or to the boot │ │ │ │ │ +0001cc50: 7365 6374 6f72 0a20 2020 2020 6f66 2061 sector. of a │ │ │ │ │ +0001cc60: 2070 6172 7469 7469 6f6e 2e20 2042 6563 partition. Bec │ │ │ │ │ +0001cc70: 6175 7365 2061 2050 4320 626f 6f74 2073 ause a PC boot s │ │ │ │ │ +0001cc80: 6563 746f 7220 6973 2035 3132 2062 7974 ector is 512 byt │ │ │ │ │ +0001cc90: 6573 2c20 7468 6520 7369 7a65 206f 660a es, the size of. │ │ │ │ │ +0001cca0: 2020 2020 2074 6869 7320 696d 6167 6520 this image │ │ │ │ │ +0001ccb0: 6973 2065 7861 6374 6c79 2035 3132 2062 is exactly 512 b │ │ │ │ │ +0001ccc0: 7974 6573 2e0a 0a20 2020 2020 5468 6520 ytes... The │ │ │ │ │ +0001ccd0: 736f 6c65 2066 756e 6374 696f 6e20 6f66 sole function of │ │ │ │ │ +0001cce0: 2027 626f 6f74 2e69 6d67 2720 6973 2074 'boot.img' is t │ │ │ │ │ +0001ccf0: 6f20 7265 6164 2074 6865 2066 6972 7374 o read the first │ │ │ │ │ +0001cd00: 2073 6563 746f 7220 6f66 2074 6865 0a20 sector of the. │ │ │ │ │ +0001cd10: 2020 2020 636f 7265 2069 6d61 6765 2066 core image f │ │ │ │ │ +0001cd20: 726f 6d20 6120 6c6f 6361 6c20 6469 736b rom a local disk │ │ │ │ │ +0001cd30: 2061 6e64 206a 756d 7020 746f 2069 742e and jump to it. │ │ │ │ │ +0001cd40: 2020 4265 6361 7573 6520 6f66 2074 6865 Because of the │ │ │ │ │ +0001cd50: 2073 697a 650a 2020 2020 2072 6573 7472 size. restr │ │ │ │ │ +0001cd60: 6963 7469 6f6e 2c20 2762 6f6f 742e 696d iction, 'boot.im │ │ │ │ │ +0001cd70: 6727 2063 616e 6e6f 7420 756e 6465 7273 g' cannot unders │ │ │ │ │ +0001cd80: 7461 6e64 2061 6e79 2066 696c 6520 7379 tand any file sy │ │ │ │ │ +0001cd90: 7374 656d 0a20 2020 2020 7374 7275 6374 stem. struct │ │ │ │ │ +0001cda0: 7572 652c 2073 6f20 2767 7275 622d 696e ure, so 'grub-in │ │ │ │ │ +0001cdb0: 7374 616c 6c27 2068 6172 6463 6f64 6573 stall' hardcodes │ │ │ │ │ +0001cdc0: 2074 6865 206c 6f63 6174 696f 6e20 6f66 the location of │ │ │ │ │ +0001cdd0: 2074 6865 2066 6972 7374 0a20 2020 2020 the first. │ │ │ │ │ +0001cde0: 7365 6374 6f72 206f 6620 7468 6520 636f sector of the co │ │ │ │ │ +0001cdf0: 7265 2069 6d61 6765 2069 6e74 6f20 2762 re image into 'b │ │ │ │ │ +0001ce00: 6f6f 742e 696d 6727 2077 6865 6e20 696e oot.img' when in │ │ │ │ │ +0001ce10: 7374 616c 6c69 6e67 2047 5255 422e 0a0a stalling GRUB... │ │ │ │ │ +0001ce20: 2764 6973 6b62 6f6f 742e 696d 6727 0a20 'diskboot.img'. │ │ │ │ │ +0001ce30: 2020 2020 5468 6973 2069 6d61 6765 2069 This image i │ │ │ │ │ +0001ce40: 7320 7573 6564 2061 7320 7468 6520 6669 s used as the fi │ │ │ │ │ +0001ce50: 7273 7420 7365 6374 6f72 206f 6620 7468 rst sector of th │ │ │ │ │ +0001ce60: 6520 636f 7265 2069 6d61 6765 2077 6865 e core image whe │ │ │ │ │ +0001ce70: 6e0a 2020 2020 2062 6f6f 7469 6e67 2066 n. booting f │ │ │ │ │ +0001ce80: 726f 6d20 6120 6861 7264 2064 6973 6b2e rom a hard disk. │ │ │ │ │ +0001ce90: 2020 4974 2072 6561 6473 2074 6865 2072 It reads the r │ │ │ │ │ +0001cea0: 6573 7420 6f66 2074 6865 2063 6f72 6520 est of the core │ │ │ │ │ +0001ceb0: 696d 6167 6520 696e 746f 0a20 2020 2020 image into. │ │ │ │ │ +0001cec0: 6d65 6d6f 7279 2061 6e64 2073 7461 7274 memory and start │ │ │ │ │ +0001ced0: 7320 7468 6520 6b65 726e 656c 2e20 2053 s the kernel. S │ │ │ │ │ +0001cee0: 696e 6365 2066 696c 6520 7379 7374 656d ince file system │ │ │ │ │ +0001cef0: 2068 616e 646c 696e 6720 6973 206e 6f74 handling is not │ │ │ │ │ +0001cf00: 0a20 2020 2020 7965 7420 6176 6169 6c61 . yet availa │ │ │ │ │ +0001cf10: 626c 652c 2069 7420 656e 636f 6465 7320 ble, it encodes │ │ │ │ │ +0001cf20: 7468 6520 6c6f 6361 7469 6f6e 206f 6620 the location of │ │ │ │ │ +0001cf30: 7468 6520 636f 7265 2069 6d61 6765 2075 the core image u │ │ │ │ │ +0001cf40: 7369 6e67 2061 0a20 2020 2020 626c 6f63 sing a. bloc │ │ │ │ │ +0001cf50: 6b20 6c69 7374 2066 6f72 6d61 742e 0a0a k list format... │ │ │ │ │ +0001cf60: 2763 6462 6f6f 742e 696d 6727 0a20 2020 'cdboot.img'. │ │ │ │ │ +0001cf70: 2020 5468 6973 2069 6d61 6765 2069 7320 This image is │ │ │ │ │ +0001cf80: 7573 6564 2061 7320 7468 6520 6669 7273 used as the firs │ │ │ │ │ +0001cf90: 7420 7365 6374 6f72 206f 6620 7468 6520 t sector of the │ │ │ │ │ +0001cfa0: 636f 7265 2069 6d61 6765 2077 6865 6e0a core image when. │ │ │ │ │ +0001cfb0: 2020 2020 2062 6f6f 7469 6e67 2066 726f booting fro │ │ │ │ │ +0001cfc0: 6d20 6120 4344 2d52 4f4d 2064 7269 7665 m a CD-ROM drive │ │ │ │ │ +0001cfd0: 2e20 2049 7420 7065 7266 6f72 6d73 2061 . It performs a │ │ │ │ │ +0001cfe0: 2073 696d 696c 6172 2066 756e 6374 696f similar functio │ │ │ │ │ +0001cff0: 6e20 746f 0a20 2020 2020 2764 6973 6b62 n to. 'diskb │ │ │ │ │ +0001d000: 6f6f 742e 696d 6727 2e0a 0a27 7078 6562 oot.img'...'pxeb │ │ │ │ │ +0001d010: 6f6f 742e 696d 6727 0a20 2020 2020 5468 oot.img'. Th │ │ │ │ │ +0001d020: 6973 2069 6d61 6765 2069 7320 7573 6564 is image is used │ │ │ │ │ +0001d030: 2061 7320 7468 6520 7374 6172 7420 6f66 as the start of │ │ │ │ │ +0001d040: 2074 6865 2063 6f72 6520 696d 6167 6520 the core image │ │ │ │ │ +0001d050: 7768 656e 2062 6f6f 7469 6e67 2066 726f when booting fro │ │ │ │ │ +0001d060: 6d0a 2020 2020 2074 6865 206e 6574 776f m. the netwo │ │ │ │ │ +0001d070: 726b 2075 7369 6e67 2050 5845 2e20 2a4e rk using PXE. *N │ │ │ │ │ +0001d080: 6f74 6520 4e65 7477 6f72 6b3a 3a2e 0a0a ote Network::... │ │ │ │ │ +0001d090: 276c 6e78 626f 6f74 2e69 6d67 270a 2020 'lnxboot.img'. │ │ │ │ │ +0001d0a0: 2020 2054 6869 7320 696d 6167 6520 6d61 This image ma │ │ │ │ │ +0001d0b0: 7920 6265 2070 6c61 6365 6420 6174 2074 y be placed at t │ │ │ │ │ +0001d0c0: 6865 2073 7461 7274 206f 6620 7468 6520 he start of the │ │ │ │ │ +0001d0d0: 636f 7265 2069 6d61 6765 2069 6e20 6f72 core image in or │ │ │ │ │ +0001d0e0: 6465 7220 746f 0a20 2020 2020 6d61 6b65 der to. make │ │ │ │ │ +0001d0f0: 2047 5255 4220 6c6f 6f6b 2065 6e6f 7567 GRUB look enoug │ │ │ │ │ +0001d100: 6820 6c69 6b65 2061 204c 696e 7578 206b h like a Linux k │ │ │ │ │ +0001d110: 6572 6e65 6c20 7468 6174 2069 7420 6361 ernel that it ca │ │ │ │ │ +0001d120: 6e20 6265 2062 6f6f 7465 6420 6279 0a20 n be booted by. │ │ │ │ │ +0001d130: 2020 2020 4c49 4c4f 2075 7369 6e67 2061 LILO using a │ │ │ │ │ +0001d140: 6e20 2769 6d61 6765 3d27 2073 6563 7469 n 'image=' secti │ │ │ │ │ +0001d150: 6f6e 2e0a 0a27 6b65 726e 656c 2e69 6d67 on...'kernel.img │ │ │ │ │ +0001d160: 270a 2020 2020 2054 6869 7320 696d 6167 '. This imag │ │ │ │ │ +0001d170: 6520 636f 6e74 6169 6e73 2047 5255 4227 e contains GRUB' │ │ │ │ │ +0001d180: 7320 6261 7369 6320 7275 6e2d 7469 6d65 s basic run-time │ │ │ │ │ +0001d190: 2066 6163 696c 6974 6965 733a 2066 7261 facilities: fra │ │ │ │ │ +0001d1a0: 6d65 776f 726b 730a 2020 2020 2066 6f72 meworks. for │ │ │ │ │ +0001d1b0: 2064 6576 6963 6520 616e 6420 6669 6c65 device and file │ │ │ │ │ +0001d1c0: 2068 616e 646c 696e 672c 2065 6e76 6972 handling, envir │ │ │ │ │ +0001d1d0: 6f6e 6d65 6e74 2076 6172 6961 626c 6573 onment variables │ │ │ │ │ +0001d1e0: 2c20 7468 6520 7265 7363 7565 0a20 2020 , the rescue. │ │ │ │ │ +0001d1f0: 2020 6d6f 6465 2063 6f6d 6d61 6e64 2d6c mode command-l │ │ │ │ │ +0001d200: 696e 6520 7061 7273 6572 2c20 616e 6420 ine parser, and │ │ │ │ │ +0001d210: 736f 206f 6e2e 2020 4974 2069 7320 7261 so on. It is ra │ │ │ │ │ +0001d220: 7265 6c79 2075 7365 6420 6469 7265 6374 rely used direct │ │ │ │ │ +0001d230: 6c79 2c0a 2020 2020 2062 7574 2069 7320 ly,. but is │ │ │ │ │ +0001d240: 6275 696c 7420 696e 746f 2061 6c6c 2063 built into all c │ │ │ │ │ +0001d250: 6f72 6520 696d 6167 6573 2e0a 0a27 636f ore images...'co │ │ │ │ │ +0001d260: 7265 2e69 6d67 270a 2020 2020 2054 6869 re.img'. Thi │ │ │ │ │ +0001d270: 7320 6973 2074 6865 2063 6f72 6520 696d s is the core im │ │ │ │ │ +0001d280: 6167 6520 6f66 2047 5255 422e 2049 7420 age of GRUB. It │ │ │ │ │ +0001d290: 6973 2062 7569 6c74 2064 796e 616d 6963 is built dynamic │ │ │ │ │ +0001d2a0: 616c 6c79 2066 726f 6d20 7468 650a 2020 ally from the. │ │ │ │ │ +0001d2b0: 2020 206b 6572 6e65 6c20 696d 6167 6520 kernel image │ │ │ │ │ +0001d2c0: 616e 6420 616e 2061 7262 6974 7261 7279 and an arbitrary │ │ │ │ │ +0001d2d0: 206c 6973 7420 6f66 206d 6f64 756c 6573 list of modules │ │ │ │ │ +0001d2e0: 2062 7920 7468 6520 2767 7275 622d 6d6b by the 'grub-mk │ │ │ │ │ +0001d2f0: 696d 6167 6527 0a20 2020 2020 7072 6f67 image'. prog │ │ │ │ │ +0001d300: 7261 6d2e 2020 5573 7561 6c6c 792c 2069 ram. Usually, i │ │ │ │ │ +0001d310: 7420 636f 6e74 6169 6e73 2065 6e6f 7567 t contains enoug │ │ │ │ │ +0001d320: 6820 6d6f 6475 6c65 7320 746f 2061 6363 h modules to acc │ │ │ │ │ +0001d330: 6573 730a 2020 2020 2027 2f62 6f6f 742f ess. '/boot/ │ │ │ │ │ +0001d340: 6772 7562 272c 2061 6e64 206c 6f61 6473 grub', and loads │ │ │ │ │ +0001d350: 2065 7665 7279 7468 696e 6720 656c 7365 everything else │ │ │ │ │ +0001d360: 2028 696e 636c 7564 696e 6720 6d65 6e75 (including menu │ │ │ │ │ +0001d370: 2068 616e 646c 696e 672c 0a20 2020 2020 handling,. │ │ │ │ │ +0001d380: 7468 6520 6162 696c 6974 7920 746f 206c the ability to l │ │ │ │ │ +0001d390: 6f61 6420 7461 7267 6574 206f 7065 7261 oad target opera │ │ │ │ │ +0001d3a0: 7469 6e67 2073 7973 7465 6d73 2c20 616e ting systems, an │ │ │ │ │ +0001d3b0: 6420 736f 206f 6e29 2066 726f 6d20 7468 d so on) from th │ │ │ │ │ +0001d3c0: 650a 2020 2020 2066 696c 6520 7379 7374 e. file syst │ │ │ │ │ +0001d3d0: 656d 2061 7420 7275 6e2d 7469 6d65 2e20 em at run-time. │ │ │ │ │ +0001d3e0: 2054 6865 206d 6f64 756c 6172 2064 6573 The modular des │ │ │ │ │ +0001d3f0: 6967 6e20 616c 6c6f 7773 2074 6865 2063 ign allows the c │ │ │ │ │ +0001d400: 6f72 6520 696d 6167 650a 2020 2020 2074 ore image. t │ │ │ │ │ +0001d410: 6f20 6265 206b 6570 7420 736d 616c 6c2c o be kept small, │ │ │ │ │ +0001d420: 2073 696e 6365 2074 6865 2061 7265 6173 since the areas │ │ │ │ │ +0001d430: 206f 6620 6469 736b 2077 6865 7265 2069 of disk where i │ │ │ │ │ +0001d440: 7420 6d75 7374 2062 650a 2020 2020 2069 t must be. i │ │ │ │ │ +0001d450: 6e73 7461 6c6c 6564 2061 7265 206f 6674 nstalled are oft │ │ │ │ │ +0001d460: 656e 2061 7320 736d 616c 6c20 6173 2033 en as small as 3 │ │ │ │ │ +0001d470: 324b 422e 0a0a 2020 2020 202a 4e6f 7465 2KB... *Note │ │ │ │ │ +0001d480: 2042 494f 5320 696e 7374 616c 6c61 7469 BIOS installati │ │ │ │ │ +0001d490: 6f6e 3a3a 2c20 666f 7220 6465 7461 696c on::, for detail │ │ │ │ │ +0001d4a0: 7320 6f6e 2077 6865 7265 2074 6865 2063 s on where the c │ │ │ │ │ +0001d4b0: 6f72 6520 696d 6167 6520 6361 6e0a 2020 ore image can. │ │ │ │ │ +0001d4c0: 2020 2062 6520 696e 7374 616c 6c65 6420 be installed │ │ │ │ │ +0001d4d0: 6f6e 2050 4320 7379 7374 656d 732e 0a0a on PC systems... │ │ │ │ │ +0001d4e0: 272a 2e6d 6f64 270a 2020 2020 2045 7665 '*.mod'. Eve │ │ │ │ │ +0001d4f0: 7279 7468 696e 6720 656c 7365 2069 6e20 rything else in │ │ │ │ │ +0001d500: 4752 5542 2072 6573 6964 6573 2069 6e20 GRUB resides in │ │ │ │ │ +0001d510: 6479 6e61 6d69 6361 6c6c 7920 6c6f 6164 dynamically load │ │ │ │ │ +0001d520: 6162 6c65 206d 6f64 756c 6573 2e0a 2020 able modules.. │ │ │ │ │ +0001d530: 2020 2054 6865 7365 2061 7265 206f 6674 These are oft │ │ │ │ │ +0001d540: 656e 206c 6f61 6465 6420 6175 746f 6d61 en loaded automa │ │ │ │ │ +0001d550: 7469 6361 6c6c 792c 206f 7220 6275 696c tically, or buil │ │ │ │ │ +0001d560: 7420 696e 746f 2074 6865 2063 6f72 6520 t into the core │ │ │ │ │ +0001d570: 696d 6167 650a 2020 2020 2069 6620 7468 image. if th │ │ │ │ │ +0001d580: 6579 2061 7265 2065 7373 656e 7469 616c ey are essential │ │ │ │ │ +0001d590: 2c20 6275 7420 6d61 7920 616c 736f 2062 , but may also b │ │ │ │ │ +0001d5a0: 6520 6c6f 6164 6564 206d 616e 7561 6c6c e loaded manuall │ │ │ │ │ +0001d5b0: 7920 7573 696e 6720 7468 650a 2020 2020 y using the. │ │ │ │ │ +0001d5c0: 2027 696e 736d 6f64 2720 636f 6d6d 616e 'insmod' comman │ │ │ │ │ +0001d5d0: 6420 282a 6e6f 7465 2069 6e73 6d6f 643a d (*note insmod: │ │ │ │ │ +0001d5e0: 3a29 2e0a 0a46 6f72 2047 5255 4220 4c65 :)...For GRUB Le │ │ │ │ │ +0001d5f0: 6761 6379 2075 7365 7273 0a3d 3d3d 3d3d gacy users.===== │ │ │ │ │ 0001d600: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0001d610: 3d3d 0a0a 4752 5542 2032 2068 6173 2061 ==..GRUB 2 has a │ │ │ │ │ -0001d620: 2064 6966 6665 7265 6e74 2064 6573 6967 different desig │ │ │ │ │ -0001d630: 6e20 6672 6f6d 2047 5255 4220 4c65 6761 n from GRUB Lega │ │ │ │ │ -0001d640: 6379 2c20 616e 6420 736f 2063 6f72 7265 cy, and so corre │ │ │ │ │ -0001d650: 7370 6f6e 6465 6e63 6573 0a77 6974 6820 spondences.with │ │ │ │ │ -0001d660: 7468 6520 696d 6167 6573 2069 7420 7573 the images it us │ │ │ │ │ -0001d670: 6564 2063 616e 6e6f 7420 6265 2065 7861 ed cannot be exa │ │ │ │ │ -0001d680: 6374 2e20 204e 6576 6572 7468 656c 6573 ct. Nevertheles │ │ │ │ │ -0001d690: 732c 2047 5255 4220 4c65 6761 6379 0a75 s, GRUB Legacy.u │ │ │ │ │ -0001d6a0: 7365 7273 206f 6674 656e 2061 736b 2071 sers often ask q │ │ │ │ │ -0001d6b0: 7565 7374 696f 6e73 2069 6e20 7468 6520 uestions in the │ │ │ │ │ -0001d6c0: 7465 726d 7320 7468 6579 2061 7265 2066 terms they are f │ │ │ │ │ -0001d6d0: 616d 696c 6961 7220 7769 7468 2c20 616e amiliar with, an │ │ │ │ │ -0001d6e0: 6420 736f 0a68 6572 6520 6973 2061 2062 d so.here is a b │ │ │ │ │ -0001d6f0: 7269 6566 2067 7569 6465 2074 6f20 686f rief guide to ho │ │ │ │ │ -0001d700: 7720 4752 5542 2032 2773 2069 6d61 6765 w GRUB 2's image │ │ │ │ │ -0001d710: 7320 7265 6c61 7465 2074 6f20 7468 6174 s relate to that │ │ │ │ │ -0001d720: 2e0a 0a27 7374 6167 6531 270a 2020 2020 ...'stage1'. │ │ │ │ │ -0001d730: 2053 7461 6765 2031 2066 726f 6d20 4752 Stage 1 from GR │ │ │ │ │ -0001d740: 5542 204c 6567 6163 7920 7761 7320 7665 UB Legacy was ve │ │ │ │ │ -0001d750: 7279 2073 696d 696c 6172 2074 6f20 2762 ry similar to 'b │ │ │ │ │ -0001d760: 6f6f 742e 696d 6727 2069 6e20 4752 5542 oot.img' in GRUB │ │ │ │ │ -0001d770: 2032 2c0a 2020 2020 2061 6e64 2074 6865 2,. and the │ │ │ │ │ -0001d780: 7920 7365 7276 6520 7468 6520 7361 6d65 y serve the same │ │ │ │ │ -0001d790: 2066 756e 6374 696f 6e2e 0a0a 272a 5f73 function...'*_s │ │ │ │ │ -0001d7a0: 7461 6765 315f 3527 0a20 2020 2020 496e tage1_5'. In │ │ │ │ │ -0001d7b0: 2047 5255 4220 4c65 6761 6379 2c20 5374 GRUB Legacy, St │ │ │ │ │ -0001d7c0: 6167 6520 312e 3527 7320 6675 6e63 7469 age 1.5's functi │ │ │ │ │ -0001d7d0: 6f6e 2077 6173 2074 6f20 696e 636c 7564 on was to includ │ │ │ │ │ -0001d7e0: 6520 656e 6f75 6768 0a20 2020 2020 6669 e enough. fi │ │ │ │ │ -0001d7f0: 6c65 7379 7374 656d 2063 6f64 6520 746f lesystem code to │ │ │ │ │ -0001d800: 2061 6c6c 6f77 2074 6865 206d 7563 6820 allow the much │ │ │ │ │ -0001d810: 6c61 7267 6572 2053 7461 6765 2032 2074 larger Stage 2 t │ │ │ │ │ -0001d820: 6f20 6265 2072 6561 6420 6672 6f6d 2061 o be read from a │ │ │ │ │ -0001d830: 6e0a 2020 2020 206f 7264 696e 6172 7920 n. ordinary │ │ │ │ │ -0001d840: 6669 6c65 7379 7374 656d 2e20 2049 6e20 filesystem. In │ │ │ │ │ -0001d850: 7468 6973 2072 6573 7065 6374 2c20 6974 this respect, it │ │ │ │ │ -0001d860: 7320 6675 6e63 7469 6f6e 2077 6173 2073 s function was s │ │ │ │ │ -0001d870: 696d 696c 6172 2074 6f0a 2020 2020 2027 imilar to. ' │ │ │ │ │ -0001d880: 636f 7265 2e69 6d67 2720 696e 2047 5255 core.img' in GRU │ │ │ │ │ -0001d890: 4220 322e 2020 486f 7765 7665 722c 2027 B 2. However, ' │ │ │ │ │ -0001d8a0: 636f 7265 2e69 6d67 2720 6973 206d 7563 core.img' is muc │ │ │ │ │ -0001d8b0: 6820 6d6f 7265 2063 6170 6162 6c65 0a20 h more capable. │ │ │ │ │ -0001d8c0: 2020 2020 7468 616e 2053 7461 6765 2031 than Stage 1 │ │ │ │ │ -0001d8d0: 2e35 2077 6173 3b20 7369 6e63 6520 6974 .5 was; since it │ │ │ │ │ -0001d8e0: 206f 6666 6572 7320 6120 7265 7363 7565 offers a rescue │ │ │ │ │ -0001d8f0: 2073 6865 6c6c 2c20 6974 2069 7320 736f shell, it is so │ │ │ │ │ -0001d900: 6d65 7469 6d65 730a 2020 2020 2070 6f73 metimes. pos │ │ │ │ │ -0001d910: 7369 626c 6520 746f 2072 6563 6f76 6572 sible to recover │ │ │ │ │ -0001d920: 206d 616e 7561 6c6c 7920 696e 2074 6865 manually in the │ │ │ │ │ -0001d930: 2065 7665 6e74 2074 6861 7420 6974 2069 event that it i │ │ │ │ │ -0001d940: 7320 756e 6162 6c65 2074 6f20 6c6f 6164 s unable to load │ │ │ │ │ -0001d950: 0a20 2020 2020 616e 7920 6f74 6865 7220 . any other │ │ │ │ │ -0001d960: 6d6f 6475 6c65 732c 2066 6f72 2065 7861 modules, for exa │ │ │ │ │ -0001d970: 6d70 6c65 2069 6620 7061 7274 6974 696f mple if partitio │ │ │ │ │ -0001d980: 6e20 6e75 6d62 6572 7320 6861 7665 2063 n numbers have c │ │ │ │ │ -0001d990: 6861 6e67 6564 2e0a 2020 2020 2027 636f hanged.. 'co │ │ │ │ │ -0001d9a0: 7265 2e69 6d67 2720 6973 2062 7569 6c74 re.img' is built │ │ │ │ │ -0001d9b0: 2069 6e20 6120 6d6f 7265 2066 6c65 7869 in a more flexi │ │ │ │ │ -0001d9c0: 626c 6520 7761 792c 2061 6c6c 6f77 696e ble way, allowin │ │ │ │ │ -0001d9d0: 6720 4752 5542 2032 2074 6f0a 2020 2020 g GRUB 2 to. │ │ │ │ │ -0001d9e0: 2073 7570 706f 7274 2072 6561 6469 6e67 support reading │ │ │ │ │ -0001d9f0: 206d 6f64 756c 6573 2066 726f 6d20 6164 modules from ad │ │ │ │ │ -0001da00: 7661 6e63 6564 2064 6973 6b20 7479 7065 vanced disk type │ │ │ │ │ -0001da10: 7320 7375 6368 2061 7320 4c56 4d20 616e s such as LVM an │ │ │ │ │ -0001da20: 640a 2020 2020 2052 4149 442e 0a0a 2020 d. RAID... │ │ │ │ │ -0001da30: 2020 2047 5255 4220 4c65 6761 6379 2063 GRUB Legacy c │ │ │ │ │ -0001da40: 6f75 6c64 2072 756e 2077 6974 6820 6f6e ould run with on │ │ │ │ │ -0001da50: 6c79 2053 7461 6765 2031 2061 6e64 2053 ly Stage 1 and S │ │ │ │ │ -0001da60: 7461 6765 2032 2069 6e20 736f 6d65 206c tage 2 in some l │ │ │ │ │ -0001da70: 696d 6974 6564 0a20 2020 2020 636f 6e66 imited. conf │ │ │ │ │ -0001da80: 6967 7572 6174 696f 6e73 2c20 7768 696c igurations, whil │ │ │ │ │ -0001da90: 6520 4752 5542 2032 2072 6571 7569 7265 e GRUB 2 require │ │ │ │ │ -0001daa0: 7320 2763 6f72 652e 696d 6727 2061 6e64 s 'core.img' and │ │ │ │ │ -0001dab0: 2063 616e 6e6f 7420 776f 726b 0a20 2020 cannot work. │ │ │ │ │ -0001dac0: 2020 7769 7468 6f75 7420 6974 2e0a 0a27 without it...' │ │ │ │ │ -0001dad0: 7374 6167 6532 270a 2020 2020 2047 5255 stage2'. GRU │ │ │ │ │ -0001dae0: 4220 3220 6861 7320 6e6f 2073 696e 676c B 2 has no singl │ │ │ │ │ -0001daf0: 6520 5374 6167 6520 3220 696d 6167 652e e Stage 2 image. │ │ │ │ │ -0001db00: 2020 496e 7374 6561 642c 2069 7420 6c6f Instead, it lo │ │ │ │ │ -0001db10: 6164 7320 6d6f 6475 6c65 7320 6672 6f6d ads modules from │ │ │ │ │ -0001db20: 0a20 2020 2020 272f 626f 6f74 2f67 7275 . '/boot/gru │ │ │ │ │ -0001db30: 6227 2061 7420 7275 6e2d 7469 6d65 2e0a b' at run-time.. │ │ │ │ │ -0001db40: 0a27 7374 6167 6532 5f65 6c74 6f72 6974 .'stage2_eltorit │ │ │ │ │ -0001db50: 6f27 0a20 2020 2020 496e 2047 5255 4220 o'. In GRUB │ │ │ │ │ -0001db60: 322c 2069 6d61 6765 7320 666f 7220 626f 2, images for bo │ │ │ │ │ -0001db70: 6f74 696e 6720 6672 6f6d 2043 442d 524f oting from CD-RO │ │ │ │ │ -0001db80: 4d20 6472 6976 6573 2061 7265 206e 6f77 M drives are now │ │ │ │ │ -0001db90: 0a20 2020 2020 636f 6e73 7472 7563 7465 . constructe │ │ │ │ │ -0001dba0: 6420 7573 696e 6720 2763 6462 6f6f 742e d using 'cdboot. │ │ │ │ │ -0001dbb0: 696d 6727 2061 6e64 2027 636f 7265 2e69 img' and 'core.i │ │ │ │ │ -0001dbc0: 6d67 272c 206d 616b 696e 6720 7375 7265 mg', making sure │ │ │ │ │ -0001dbd0: 2074 6861 7420 7468 650a 2020 2020 2063 that the. c │ │ │ │ │ -0001dbe0: 6f72 6520 696d 6167 6520 636f 6e74 6169 ore image contai │ │ │ │ │ -0001dbf0: 6e73 2074 6865 2027 6973 6f39 3636 3027 ns the 'iso9660' │ │ │ │ │ -0001dc00: 206d 6f64 756c 652e 2020 4974 2069 7320 module. It is │ │ │ │ │ -0001dc10: 7573 7561 6c6c 7920 6265 7374 2074 6f0a usually best to. │ │ │ │ │ -0001dc20: 2020 2020 2075 7365 2074 6865 2027 6772 use the 'gr │ │ │ │ │ -0001dc30: 7562 2d6d 6b72 6573 6375 6527 2070 726f ub-mkrescue' pro │ │ │ │ │ -0001dc40: 6772 616d 2066 6f72 2074 6869 732e 0a0a gram for this... │ │ │ │ │ -0001dc50: 276e 6267 7275 6227 0a20 2020 2020 5468 'nbgrub'. Th │ │ │ │ │ -0001dc60: 6572 6520 6973 2061 7320 7965 7420 6e6f ere is as yet no │ │ │ │ │ -0001dc70: 2065 7175 6976 616c 656e 7420 666f 7220 equivalent for │ │ │ │ │ -0001dc80: 276e 6267 7275 6227 2069 6e20 4752 5542 'nbgrub' in GRUB │ │ │ │ │ -0001dc90: 2032 3b20 6974 2077 6173 2075 7365 640a 2; it was used. │ │ │ │ │ -0001dca0: 2020 2020 2062 7920 4574 6865 7262 6f6f by Etherboo │ │ │ │ │ -0001dcb0: 7420 616e 6420 736f 6d65 206f 7468 6572 t and some other │ │ │ │ │ -0001dcc0: 206e 6574 776f 726b 2062 6f6f 7420 6c6f network boot lo │ │ │ │ │ -0001dcd0: 6164 6572 732e 0a0a 2770 7865 6772 7562 aders...'pxegrub │ │ │ │ │ -0001dce0: 270a 2020 2020 2049 6e20 4752 5542 2032 '. In GRUB 2 │ │ │ │ │ -0001dcf0: 2c20 696d 6167 6573 2066 6f72 2050 5845 , images for PXE │ │ │ │ │ -0001dd00: 206e 6574 776f 726b 2062 6f6f 7469 6e67 network booting │ │ │ │ │ -0001dd10: 2061 7265 206e 6f77 2063 6f6e 7374 7275 are now constru │ │ │ │ │ -0001dd20: 6374 6564 2075 7369 6e67 0a20 2020 2020 cted using. │ │ │ │ │ -0001dd30: 2770 7865 626f 6f74 2e69 6d67 2720 616e 'pxeboot.img' an │ │ │ │ │ -0001dd40: 6420 2763 6f72 652e 696d 6727 2c20 6d61 d 'core.img', ma │ │ │ │ │ -0001dd50: 6b69 6e67 2073 7572 6520 7468 6174 2074 king sure that t │ │ │ │ │ -0001dd60: 6865 2063 6f72 6520 696d 6167 650a 2020 he core image. │ │ │ │ │ -0001dd70: 2020 2063 6f6e 7461 696e 7320 7468 6520 contains the │ │ │ │ │ -0001dd80: 2770 7865 2720 616e 6420 2770 7865 636d 'pxe' and 'pxecm │ │ │ │ │ -0001dd90: 6427 206d 6f64 756c 6573 2e20 202a 4e6f d' modules. *No │ │ │ │ │ -0001dda0: 7465 204e 6574 776f 726b 3a3a 2e0a 0a1f te Network::.... │ │ │ │ │ -0001ddb0: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ -0001ddc0: 2c20 204e 6f64 653a 2043 6f72 6520 696d , Node: Core im │ │ │ │ │ -0001ddd0: 6167 6520 7369 7a65 206c 696d 6974 6174 age size limitat │ │ │ │ │ -0001dde0: 696f 6e2c 2020 4e65 7874 3a20 4669 6c65 ion, Next: File │ │ │ │ │ -0001ddf0: 7379 7374 656d 2c20 2050 7265 763a 2049 system, Prev: I │ │ │ │ │ -0001de00: 6d61 6765 732c 2020 5570 3a20 546f 700a mages, Up: Top. │ │ │ │ │ -0001de10: 0a31 3220 436f 7265 2069 6d61 6765 2073 .12 Core image s │ │ │ │ │ -0001de20: 697a 6520 6c69 6d69 7461 7469 6f6e 0a2a ize limitation.* │ │ │ │ │ +0001d610: 0a0a 4752 5542 2032 2068 6173 2061 2064 ..GRUB 2 has a d │ │ │ │ │ +0001d620: 6966 6665 7265 6e74 2064 6573 6967 6e20 ifferent design │ │ │ │ │ +0001d630: 6672 6f6d 2047 5255 4220 4c65 6761 6379 from GRUB Legacy │ │ │ │ │ +0001d640: 2c20 616e 6420 736f 2063 6f72 7265 7370 , and so corresp │ │ │ │ │ +0001d650: 6f6e 6465 6e63 6573 0a77 6974 6820 7468 ondences.with th │ │ │ │ │ +0001d660: 6520 696d 6167 6573 2069 7420 7573 6564 e images it used │ │ │ │ │ +0001d670: 2063 616e 6e6f 7420 6265 2065 7861 6374 cannot be exact │ │ │ │ │ +0001d680: 2e20 204e 6576 6572 7468 656c 6573 732c . Nevertheless, │ │ │ │ │ +0001d690: 2047 5255 4220 4c65 6761 6379 0a75 7365 GRUB Legacy.use │ │ │ │ │ +0001d6a0: 7273 206f 6674 656e 2061 736b 2071 7565 rs often ask que │ │ │ │ │ +0001d6b0: 7374 696f 6e73 2069 6e20 7468 6520 7465 stions in the te │ │ │ │ │ +0001d6c0: 726d 7320 7468 6579 2061 7265 2066 616d rms they are fam │ │ │ │ │ +0001d6d0: 696c 6961 7220 7769 7468 2c20 616e 6420 iliar with, and │ │ │ │ │ +0001d6e0: 736f 0a68 6572 6520 6973 2061 2062 7269 so.here is a bri │ │ │ │ │ +0001d6f0: 6566 2067 7569 6465 2074 6f20 686f 7720 ef guide to how │ │ │ │ │ +0001d700: 4752 5542 2032 2773 2069 6d61 6765 7320 GRUB 2's images │ │ │ │ │ +0001d710: 7265 6c61 7465 2074 6f20 7468 6174 2e0a relate to that.. │ │ │ │ │ +0001d720: 0a27 7374 6167 6531 270a 2020 2020 2053 .'stage1'. S │ │ │ │ │ +0001d730: 7461 6765 2031 2066 726f 6d20 4752 5542 tage 1 from GRUB │ │ │ │ │ +0001d740: 204c 6567 6163 7920 7761 7320 7665 7279 Legacy was very │ │ │ │ │ +0001d750: 2073 696d 696c 6172 2074 6f20 2762 6f6f similar to 'boo │ │ │ │ │ +0001d760: 742e 696d 6727 2069 6e20 4752 5542 2032 t.img' in GRUB 2 │ │ │ │ │ +0001d770: 2c0a 2020 2020 2061 6e64 2074 6865 7920 ,. and they │ │ │ │ │ +0001d780: 7365 7276 6520 7468 6520 7361 6d65 2066 serve the same f │ │ │ │ │ +0001d790: 756e 6374 696f 6e2e 0a0a 272a 5f73 7461 unction...'*_sta │ │ │ │ │ +0001d7a0: 6765 315f 3527 0a20 2020 2020 496e 2047 ge1_5'. In G │ │ │ │ │ +0001d7b0: 5255 4220 4c65 6761 6379 2c20 5374 6167 RUB Legacy, Stag │ │ │ │ │ +0001d7c0: 6520 312e 3527 7320 6675 6e63 7469 6f6e e 1.5's function │ │ │ │ │ +0001d7d0: 2077 6173 2074 6f20 696e 636c 7564 6520 was to include │ │ │ │ │ +0001d7e0: 656e 6f75 6768 0a20 2020 2020 6669 6c65 enough. file │ │ │ │ │ +0001d7f0: 7379 7374 656d 2063 6f64 6520 746f 2061 system code to a │ │ │ │ │ +0001d800: 6c6c 6f77 2074 6865 206d 7563 6820 6c61 llow the much la │ │ │ │ │ +0001d810: 7267 6572 2053 7461 6765 2032 2074 6f20 rger Stage 2 to │ │ │ │ │ +0001d820: 6265 2072 6561 6420 6672 6f6d 2061 6e0a be read from an. │ │ │ │ │ +0001d830: 2020 2020 206f 7264 696e 6172 7920 6669 ordinary fi │ │ │ │ │ +0001d840: 6c65 7379 7374 656d 2e20 2049 6e20 7468 lesystem. In th │ │ │ │ │ +0001d850: 6973 2072 6573 7065 6374 2c20 6974 7320 is respect, its │ │ │ │ │ +0001d860: 6675 6e63 7469 6f6e 2077 6173 2073 696d function was sim │ │ │ │ │ +0001d870: 696c 6172 2074 6f0a 2020 2020 2027 636f ilar to. 'co │ │ │ │ │ +0001d880: 7265 2e69 6d67 2720 696e 2047 5255 4220 re.img' in GRUB │ │ │ │ │ +0001d890: 322e 2020 486f 7765 7665 722c 2027 636f 2. However, 'co │ │ │ │ │ +0001d8a0: 7265 2e69 6d67 2720 6973 206d 7563 6820 re.img' is much │ │ │ │ │ +0001d8b0: 6d6f 7265 2063 6170 6162 6c65 0a20 2020 more capable. │ │ │ │ │ +0001d8c0: 2020 7468 616e 2053 7461 6765 2031 2e35 than Stage 1.5 │ │ │ │ │ +0001d8d0: 2077 6173 3b20 7369 6e63 6520 6974 206f was; since it o │ │ │ │ │ +0001d8e0: 6666 6572 7320 6120 7265 7363 7565 2073 ffers a rescue s │ │ │ │ │ +0001d8f0: 6865 6c6c 2c20 6974 2069 7320 736f 6d65 hell, it is some │ │ │ │ │ +0001d900: 7469 6d65 730a 2020 2020 2070 6f73 7369 times. possi │ │ │ │ │ +0001d910: 626c 6520 746f 2072 6563 6f76 6572 206d ble to recover m │ │ │ │ │ +0001d920: 616e 7561 6c6c 7920 696e 2074 6865 2065 anually in the e │ │ │ │ │ +0001d930: 7665 6e74 2074 6861 7420 6974 2069 7320 vent that it is │ │ │ │ │ +0001d940: 756e 6162 6c65 2074 6f20 6c6f 6164 0a20 unable to load. │ │ │ │ │ +0001d950: 2020 2020 616e 7920 6f74 6865 7220 6d6f any other mo │ │ │ │ │ +0001d960: 6475 6c65 732c 2066 6f72 2065 7861 6d70 dules, for examp │ │ │ │ │ +0001d970: 6c65 2069 6620 7061 7274 6974 696f 6e20 le if partition │ │ │ │ │ +0001d980: 6e75 6d62 6572 7320 6861 7665 2063 6861 numbers have cha │ │ │ │ │ +0001d990: 6e67 6564 2e0a 2020 2020 2027 636f 7265 nged.. 'core │ │ │ │ │ +0001d9a0: 2e69 6d67 2720 6973 2062 7569 6c74 2069 .img' is built i │ │ │ │ │ +0001d9b0: 6e20 6120 6d6f 7265 2066 6c65 7869 626c n a more flexibl │ │ │ │ │ +0001d9c0: 6520 7761 792c 2061 6c6c 6f77 696e 6720 e way, allowing │ │ │ │ │ +0001d9d0: 4752 5542 2032 2074 6f0a 2020 2020 2073 GRUB 2 to. s │ │ │ │ │ +0001d9e0: 7570 706f 7274 2072 6561 6469 6e67 206d upport reading m │ │ │ │ │ +0001d9f0: 6f64 756c 6573 2066 726f 6d20 6164 7661 odules from adva │ │ │ │ │ +0001da00: 6e63 6564 2064 6973 6b20 7479 7065 7320 nced disk types │ │ │ │ │ +0001da10: 7375 6368 2061 7320 4c56 4d20 616e 640a such as LVM and. │ │ │ │ │ +0001da20: 2020 2020 2052 4149 442e 0a0a 2020 2020 RAID... │ │ │ │ │ +0001da30: 2047 5255 4220 4c65 6761 6379 2063 6f75 GRUB Legacy cou │ │ │ │ │ +0001da40: 6c64 2072 756e 2077 6974 6820 6f6e 6c79 ld run with only │ │ │ │ │ +0001da50: 2053 7461 6765 2031 2061 6e64 2053 7461 Stage 1 and Sta │ │ │ │ │ +0001da60: 6765 2032 2069 6e20 736f 6d65 206c 696d ge 2 in some lim │ │ │ │ │ +0001da70: 6974 6564 0a20 2020 2020 636f 6e66 6967 ited. config │ │ │ │ │ +0001da80: 7572 6174 696f 6e73 2c20 7768 696c 6520 urations, while │ │ │ │ │ +0001da90: 4752 5542 2032 2072 6571 7569 7265 7320 GRUB 2 requires │ │ │ │ │ +0001daa0: 2763 6f72 652e 696d 6727 2061 6e64 2063 'core.img' and c │ │ │ │ │ +0001dab0: 616e 6e6f 7420 776f 726b 0a20 2020 2020 annot work. │ │ │ │ │ +0001dac0: 7769 7468 6f75 7420 6974 2e0a 0a27 7374 without it...'st │ │ │ │ │ +0001dad0: 6167 6532 270a 2020 2020 2047 5255 4220 age2'. GRUB │ │ │ │ │ +0001dae0: 3220 6861 7320 6e6f 2073 696e 676c 6520 2 has no single │ │ │ │ │ +0001daf0: 5374 6167 6520 3220 696d 6167 652e 2020 Stage 2 image. │ │ │ │ │ +0001db00: 496e 7374 6561 642c 2069 7420 6c6f 6164 Instead, it load │ │ │ │ │ +0001db10: 7320 6d6f 6475 6c65 7320 6672 6f6d 0a20 s modules from. │ │ │ │ │ +0001db20: 2020 2020 272f 626f 6f74 2f67 7275 6227 '/boot/grub' │ │ │ │ │ +0001db30: 2061 7420 7275 6e2d 7469 6d65 2e0a 0a27 at run-time...' │ │ │ │ │ +0001db40: 7374 6167 6532 5f65 6c74 6f72 6974 6f27 stage2_eltorito' │ │ │ │ │ +0001db50: 0a20 2020 2020 496e 2047 5255 4220 322c . In GRUB 2, │ │ │ │ │ +0001db60: 2069 6d61 6765 7320 666f 7220 626f 6f74 images for boot │ │ │ │ │ +0001db70: 696e 6720 6672 6f6d 2043 442d 524f 4d20 ing from CD-ROM │ │ │ │ │ +0001db80: 6472 6976 6573 2061 7265 206e 6f77 0a20 drives are now. │ │ │ │ │ +0001db90: 2020 2020 636f 6e73 7472 7563 7465 6420 constructed │ │ │ │ │ +0001dba0: 7573 696e 6720 2763 6462 6f6f 742e 696d using 'cdboot.im │ │ │ │ │ +0001dbb0: 6727 2061 6e64 2027 636f 7265 2e69 6d67 g' and 'core.img │ │ │ │ │ +0001dbc0: 272c 206d 616b 696e 6720 7375 7265 2074 ', making sure t │ │ │ │ │ +0001dbd0: 6861 7420 7468 650a 2020 2020 2063 6f72 hat the. cor │ │ │ │ │ +0001dbe0: 6520 696d 6167 6520 636f 6e74 6169 6e73 e image contains │ │ │ │ │ +0001dbf0: 2074 6865 2027 6973 6f39 3636 3027 206d the 'iso9660' m │ │ │ │ │ +0001dc00: 6f64 756c 652e 2020 4974 2069 7320 7573 odule. It is us │ │ │ │ │ +0001dc10: 7561 6c6c 7920 6265 7374 2074 6f0a 2020 ually best to. │ │ │ │ │ +0001dc20: 2020 2075 7365 2074 6865 2027 6772 7562 use the 'grub │ │ │ │ │ +0001dc30: 2d6d 6b72 6573 6375 6527 2070 726f 6772 -mkrescue' progr │ │ │ │ │ +0001dc40: 616d 2066 6f72 2074 6869 732e 0a0a 276e am for this...'n │ │ │ │ │ +0001dc50: 6267 7275 6227 0a20 2020 2020 5468 6572 bgrub'. Ther │ │ │ │ │ +0001dc60: 6520 6973 2061 7320 7965 7420 6e6f 2065 e is as yet no e │ │ │ │ │ +0001dc70: 7175 6976 616c 656e 7420 666f 7220 276e quivalent for 'n │ │ │ │ │ +0001dc80: 6267 7275 6227 2069 6e20 4752 5542 2032 bgrub' in GRUB 2 │ │ │ │ │ +0001dc90: 3b20 6974 2077 6173 2075 7365 640a 2020 ; it was used. │ │ │ │ │ +0001dca0: 2020 2062 7920 4574 6865 7262 6f6f 7420 by Etherboot │ │ │ │ │ +0001dcb0: 616e 6420 736f 6d65 206f 7468 6572 206e and some other n │ │ │ │ │ +0001dcc0: 6574 776f 726b 2062 6f6f 7420 6c6f 6164 etwork boot load │ │ │ │ │ +0001dcd0: 6572 732e 0a0a 2770 7865 6772 7562 270a ers...'pxegrub'. │ │ │ │ │ +0001dce0: 2020 2020 2049 6e20 4752 5542 2032 2c20 In GRUB 2, │ │ │ │ │ +0001dcf0: 696d 6167 6573 2066 6f72 2050 5845 206e images for PXE n │ │ │ │ │ +0001dd00: 6574 776f 726b 2062 6f6f 7469 6e67 2061 etwork booting a │ │ │ │ │ +0001dd10: 7265 206e 6f77 2063 6f6e 7374 7275 6374 re now construct │ │ │ │ │ +0001dd20: 6564 2075 7369 6e67 0a20 2020 2020 2770 ed using. 'p │ │ │ │ │ +0001dd30: 7865 626f 6f74 2e69 6d67 2720 616e 6420 xeboot.img' and │ │ │ │ │ +0001dd40: 2763 6f72 652e 696d 6727 2c20 6d61 6b69 'core.img', maki │ │ │ │ │ +0001dd50: 6e67 2073 7572 6520 7468 6174 2074 6865 ng sure that the │ │ │ │ │ +0001dd60: 2063 6f72 6520 696d 6167 650a 2020 2020 core image. │ │ │ │ │ +0001dd70: 2063 6f6e 7461 696e 7320 7468 6520 2770 contains the 'p │ │ │ │ │ +0001dd80: 7865 2720 616e 6420 2770 7865 636d 6427 xe' and 'pxecmd' │ │ │ │ │ +0001dd90: 206d 6f64 756c 6573 2e20 202a 4e6f 7465 modules. *Note │ │ │ │ │ +0001dda0: 204e 6574 776f 726b 3a3a 2e0a 0a1f 0a46 Network::.....F │ │ │ │ │ +0001ddb0: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ +0001ddc0: 204e 6f64 653a 2043 6f72 6520 696d 6167 Node: Core imag │ │ │ │ │ +0001ddd0: 6520 7369 7a65 206c 696d 6974 6174 696f e size limitatio │ │ │ │ │ +0001dde0: 6e2c 2020 4e65 7874 3a20 4669 6c65 7379 n, Next: Filesy │ │ │ │ │ +0001ddf0: 7374 656d 2c20 2050 7265 763a 2049 6d61 stem, Prev: Ima │ │ │ │ │ +0001de00: 6765 732c 2020 5570 3a20 546f 700a 0a31 ges, Up: Top..1 │ │ │ │ │ +0001de10: 3220 436f 7265 2069 6d61 6765 2073 697a 2 Core image siz │ │ │ │ │ +0001de20: 6520 6c69 6d69 7461 7469 6f6e 0a2a 2a2a e limitation.*** │ │ │ │ │ 0001de30: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -0001de40: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a 4865 ************..He │ │ │ │ │ -0001de50: 6176 696c 7920 6c69 6d69 7465 6420 706c avily limited pl │ │ │ │ │ -0001de60: 6174 666f 726d 733a 0a20 2020 2a20 6933 atforms:. * i3 │ │ │ │ │ -0001de70: 3836 2d70 6320 286e 6f72 6d61 6c20 616e 86-pc (normal an │ │ │ │ │ -0001de80: 6420 5058 4529 3a20 7468 6520 636f 7265 d PXE): the core │ │ │ │ │ -0001de90: 2069 6d61 6765 2073 697a 6520 2863 6f6d image size (com │ │ │ │ │ -0001dea0: 7072 6573 7365 6429 2069 730a 2020 2020 pressed) is. │ │ │ │ │ -0001deb0: 206c 696d 6974 6564 2062 7920 3435 3832 limited by 4582 │ │ │ │ │ -0001dec0: 3430 2062 7974 6573 2e20 206b 6572 6e65 40 bytes. kerne │ │ │ │ │ -0001ded0: 6c2e 696d 6720 282e 7465 7874 202b 202e l.img (.text + . │ │ │ │ │ -0001dee0: 6461 7461 202b 202e 6273 732c 0a20 2020 data + .bss,. │ │ │ │ │ -0001def0: 2020 756e 636f 6d70 7265 7373 6564 2920 uncompressed) │ │ │ │ │ -0001df00: 6973 206c 696d 6974 6564 2062 7920 3339 is limited by 39 │ │ │ │ │ -0001df10: 3237 3034 2062 7974 6573 2e20 206d 6f64 2704 bytes. mod │ │ │ │ │ -0001df20: 756c 6520 7369 7a65 0a20 2020 2020 2875 ule size. (u │ │ │ │ │ -0001df30: 6e63 6f6d 7072 6573 7365 6429 202b 206b ncompressed) + k │ │ │ │ │ -0001df40: 6572 6e65 6c2e 696d 6720 282e 7465 7874 ernel.img (.text │ │ │ │ │ -0001df50: 202b 202e 6461 7461 2c20 756e 636f 6d70 + .data, uncomp │ │ │ │ │ -0001df60: 7265 7373 6564 2920 6973 0a20 2020 2020 ressed) is. │ │ │ │ │ -0001df70: 6c69 6d69 7465 6420 6279 2074 6865 2073 limited by the s │ │ │ │ │ -0001df80: 697a 6520 6f66 2063 6f6e 7469 6775 6f75 ize of contiguou │ │ │ │ │ -0001df90: 7320 6368 756e 6b20 6174 2031 4d20 6164 s chunk at 1M ad │ │ │ │ │ -0001dfa0: 6472 6573 732e 0a20 2020 2a20 7370 6172 dress.. * spar │ │ │ │ │ -0001dfb0: 6336 342d 6965 6565 3132 3735 3a20 6b65 c64-ieee1275: ke │ │ │ │ │ -0001dfc0: 726e 656c 2e69 6d67 2028 2e74 6578 7420 rnel.img (.text │ │ │ │ │ -0001dfd0: 2b20 2e64 6174 6120 2b20 2e62 7373 2920 + .data + .bss) │ │ │ │ │ -0001dfe0: 2b20 6d6f 6475 6c65 7320 2b0a 2020 2020 + modules +. │ │ │ │ │ -0001dff0: 2032 3536 4b20 2873 7461 636b 2920 2b20 256K (stack) + │ │ │ │ │ -0001e000: 324d 2028 6865 6170 2920 6973 206c 696d 2M (heap) is lim │ │ │ │ │ -0001e010: 6974 6564 2062 7920 7370 6163 6520 6176 ited by space av │ │ │ │ │ -0001e020: 6169 6c61 626c 6520 6174 2030 7834 3430 ailable at 0x440 │ │ │ │ │ -0001e030: 302e 0a20 2020 2020 4f6e 206d 6f73 7420 0.. On most │ │ │ │ │ -0001e040: 706c 6174 666f 726d 7320 6974 2773 206a platforms it's j │ │ │ │ │ -0001e050: 7573 7420 3320 6f72 2034 4d20 7369 6e63 ust 3 or 4M sinc │ │ │ │ │ -0001e060: 6520 6965 6565 3132 3735 206d 6170 7320 e ieee1275 maps │ │ │ │ │ -0001e070: 6f6e 6c79 2073 6f0a 2020 2020 206d 7563 only so. muc │ │ │ │ │ -0001e080: 682e 0a20 2020 2a20 6933 3836 2d69 6565 h.. * i386-iee │ │ │ │ │ -0001e090: 6531 3237 353a 206b 6572 6e65 6c2e 696d e1275: kernel.im │ │ │ │ │ -0001e0a0: 6720 282e 7465 7874 202b 202e 6461 7461 g (.text + .data │ │ │ │ │ -0001e0b0: 202b 202e 6273 7329 202b 206d 6f64 756c + .bss) + modul │ │ │ │ │ -0001e0c0: 6573 2069 730a 2020 2020 206c 696d 6974 es is. limit │ │ │ │ │ -0001e0d0: 6564 2062 7920 6d65 6d6f 7279 2061 7661 ed by memory ava │ │ │ │ │ -0001e0e0: 696c 6162 6c65 2061 7420 3078 3130 3030 ilable at 0x1000 │ │ │ │ │ -0001e0f0: 302c 2061 7420 6d6f 7374 2035 3936 4b0a 0, at most 596K. │ │ │ │ │ -0001e100: 0a20 2020 4c69 6768 746c 7920 6c69 6d69 . Lightly limi │ │ │ │ │ -0001e110: 7465 6420 706c 6174 666f 726d 733a 0a0a ted platforms:.. │ │ │ │ │ -0001e120: 2020 202a 202a 2d78 656e 3a20 6c69 6d69 * *-xen: limi │ │ │ │ │ -0001e130: 7465 6420 6f6e 6c79 2062 7920 6164 7265 ted only by adre │ │ │ │ │ -0001e140: 7373 2073 7061 6365 2061 6e64 2052 414d ss space and RAM │ │ │ │ │ -0001e150: 2073 697a 652e 0a20 2020 2a20 6933 3836 size.. * i386 │ │ │ │ │ -0001e160: 2d71 656d 753a 206b 6572 6e65 6c2e 696d -qemu: kernel.im │ │ │ │ │ -0001e170: 6720 282e 7465 7874 202b 202e 6461 7461 g (.text + .data │ │ │ │ │ -0001e180: 202b 202e 6273 7329 2069 7320 6c69 6d69 + .bss) is limi │ │ │ │ │ -0001e190: 7465 6420 6279 2033 3932 3730 340a 2020 ted by 392704. │ │ │ │ │ -0001e1a0: 2020 2062 7974 6573 2e20 2028 636f 7265 bytes. (core │ │ │ │ │ -0001e1b0: 2e69 6d67 2077 6f75 6c64 2062 6520 6c69 .img would be li │ │ │ │ │ -0001e1c0: 6d69 7465 6420 6279 2052 4f4d 2073 697a mited by ROM siz │ │ │ │ │ -0001e1d0: 6520 6275 7420 6974 2773 2075 6e6c 696d e but it's unlim │ │ │ │ │ -0001e1e0: 6974 6564 0a20 2020 2020 6f6e 2071 656d ited. on qem │ │ │ │ │ -0001e1f0: 750a 2020 202a 2041 6c6c 2045 4649 2070 u. * All EFI p │ │ │ │ │ -0001e200: 6c61 7466 6f72 6d73 3a20 6c69 6d69 7465 latforms: limite │ │ │ │ │ -0001e210: 6420 6279 2063 6f6e 7469 6775 6f75 7320 d by contiguous │ │ │ │ │ -0001e220: 5241 4d20 7369 7a65 2061 6e64 2070 6f73 RAM size and pos │ │ │ │ │ -0001e230: 7369 626c 790a 2020 2020 2066 6972 6d77 sibly. firmw │ │ │ │ │ -0001e240: 6172 6520 6275 6773 0a20 2020 2a20 436f are bugs. * Co │ │ │ │ │ -0001e250: 7265 626f 6f74 2061 6e64 206d 756c 7469 reboot and multi │ │ │ │ │ -0001e260: 626f 6f74 2e20 206b 6572 6e65 6c2e 696d boot. kernel.im │ │ │ │ │ -0001e270: 6720 282e 7465 7874 202b 202e 6461 7461 g (.text + .data │ │ │ │ │ -0001e280: 202b 202e 6273 7329 2069 730a 2020 2020 + .bss) is. │ │ │ │ │ -0001e290: 206c 696d 6974 6564 2062 7920 3339 3237 limited by 3927 │ │ │ │ │ -0001e2a0: 3034 2062 7974 6573 2e20 206d 6f64 756c 04 bytes. modul │ │ │ │ │ -0001e2b0: 6520 7369 7a65 2069 7320 6c69 6d69 7465 e size is limite │ │ │ │ │ -0001e2c0: 6420 6279 2074 6865 2073 697a 6520 6f66 d by the size of │ │ │ │ │ -0001e2d0: 0a20 2020 2020 636f 6e74 6967 756f 7573 . contiguous │ │ │ │ │ -0001e2e0: 2063 6875 6e6b 2061 7420 314d 2061 6464 chunk at 1M add │ │ │ │ │ -0001e2f0: 7265 7373 2e0a 2020 202a 206d 6970 7365 ress.. * mipse │ │ │ │ │ -0001e300: 6c2d 6c6f 6f6e 6773 6f6e 2028 454c 4629 l-loongson (ELF) │ │ │ │ │ -0001e310: 2c20 6d69 7073 2865 6c29 2d71 656d 755f , mips(el)-qemu_ │ │ │ │ │ -0001e320: 6d69 7073 2028 454c 4629 3a20 6966 2075 mips (ELF): if u │ │ │ │ │ -0001e330: 6e63 6f6d 7072 6573 7365 643a 0a20 2020 ncompressed:. │ │ │ │ │ -0001e340: 2020 6b65 726e 656c 2e69 6d67 2028 2e74 kernel.img (.t │ │ │ │ │ -0001e350: 6578 7420 2b20 2e64 6174 6129 202b 206d ext + .data) + m │ │ │ │ │ -0001e360: 6f64 756c 6573 2069 7320 6c69 6d69 7465 odules is limite │ │ │ │ │ -0001e370: 6420 6279 2074 6865 2073 7061 6365 2066 d by the space f │ │ │ │ │ -0001e380: 726f 6d0a 2020 2020 2038 3032 3030 3030 rom. 8020000 │ │ │ │ │ -0001e390: 3020 666f 7277 6172 6420 6966 2063 6f6d 0 forward if com │ │ │ │ │ -0001e3a0: 7072 6573 7365 643a 206b 6572 6e65 6c2e pressed: kernel. │ │ │ │ │ -0001e3b0: 696d 6720 282e 7465 7874 202b 202e 6461 img (.text + .da │ │ │ │ │ -0001e3c0: 7461 2c0a 2020 2020 2075 6e63 6f6d 7072 ta,. uncompr │ │ │ │ │ -0001e3d0: 6573 7365 6429 202b 206d 6f64 756c 6573 essed) + modules │ │ │ │ │ -0001e3e0: 2028 756e 636f 6d70 7265 7373 6564 2920 (uncompressed) │ │ │ │ │ -0001e3f0: 2b20 286d 6f64 756c 6573 202b 206b 6572 + (modules + ker │ │ │ │ │ -0001e400: 6e65 6c2e 696d 670a 2020 2020 2028 2e74 nel.img. (.t │ │ │ │ │ -0001e410: 6578 7420 2b20 2e64 6174 6129 2920 2863 ext + .data)) (c │ │ │ │ │ -0001e420: 6f6d 7072 6573 7365 6429 202b 2064 6563 ompressed) + dec │ │ │ │ │ -0001e430: 6f6d 7072 6573 736f 7220 6973 206c 696d ompressor is lim │ │ │ │ │ -0001e440: 6974 6564 2062 7920 7468 650a 2020 2020 ited by the. │ │ │ │ │ -0001e450: 2073 7061 6365 2066 726f 6d20 3830 3230 space from 8020 │ │ │ │ │ -0001e460: 3030 3030 2066 6f72 7761 7264 0a20 2020 0000 forward. │ │ │ │ │ -0001e470: 2a20 6d69 7073 656c 2d6c 6f6f 6e67 736f * mipsel-loongso │ │ │ │ │ -0001e480: 6e20 2846 6c61 7368 292c 206d 6970 7328 n (Flash), mips( │ │ │ │ │ -0001e490: 656c 292d 7165 6d75 5f6d 6970 7320 2846 el)-qemu_mips (F │ │ │ │ │ -0001e4a0: 6c61 7368 293a 206b 6572 6e65 6c2e 696d lash): kernel.im │ │ │ │ │ -0001e4b0: 670a 2020 2020 2028 2e74 6578 7420 2b20 g. (.text + │ │ │ │ │ -0001e4c0: 2e64 6174 6129 202b 206d 6f64 756c 6573 .data) + modules │ │ │ │ │ -0001e4d0: 2069 7320 6c69 6d69 7465 6420 6279 2074 is limited by t │ │ │ │ │ -0001e4e0: 6865 2073 7061 6365 2066 726f 6d20 3830 he space from 80 │ │ │ │ │ -0001e4f0: 3230 3030 3030 0a20 2020 2020 666f 7277 200000. forw │ │ │ │ │ -0001e500: 6172 6420 636f 7265 2e69 6d67 2028 6669 ard core.img (fi │ │ │ │ │ -0001e510: 6e61 6c29 2069 7320 6c69 6d69 7465 6420 nal) is limited │ │ │ │ │ -0001e520: 6279 2066 6c61 7368 2073 697a 6520 2835 by flash size (5 │ │ │ │ │ -0001e530: 3132 4b20 6f6e 2079 6565 6c6f 6f6e 670a 12K on yeeloong. │ │ │ │ │ -0001e540: 2020 2020 2061 6e64 2066 756c 6f6f 6f6e and fulooon │ │ │ │ │ -0001e550: 6729 0a20 2020 2a20 6d69 7073 2d61 7263 g). * mips-arc │ │ │ │ │ -0001e560: 3a20 6966 2075 6e63 6f6d 7072 6573 7365 : if uncompresse │ │ │ │ │ -0001e570: 643a 206b 6572 6e65 6c2e 696d 6720 282e d: kernel.img (. │ │ │ │ │ -0001e580: 7465 7874 202b 202e 6461 7461 2920 6973 text + .data) is │ │ │ │ │ -0001e590: 206c 696d 6974 6564 2062 790a 2020 2020 limited by. │ │ │ │ │ -0001e5a0: 2074 6865 2073 7061 6365 2066 726f 6d20 the space from │ │ │ │ │ -0001e5b0: 3862 6430 3030 3030 2066 6f72 7761 7264 8bd00000 forward │ │ │ │ │ -0001e5c0: 206d 6f64 756c 6573 202b 2064 756d 6d79 modules + dummy │ │ │ │ │ -0001e5d0: 2064 6563 6f6d 7072 6573 736f 7220 6973 decompressor is │ │ │ │ │ -0001e5e0: 0a20 2020 2020 6c69 6d69 7465 6420 6279 . limited by │ │ │ │ │ -0001e5f0: 2074 6865 2073 7061 6365 2066 726f 6d20 the space from │ │ │ │ │ -0001e600: 3862 6430 3030 3030 2062 6163 6b77 6172 8bd00000 backwar │ │ │ │ │ -0001e610: 6420 6966 2063 6f6d 7072 6573 7365 643a d if compressed: │ │ │ │ │ -0001e620: 0a20 2020 2020 6b65 726e 656c 2e69 6d67 . kernel.img │ │ │ │ │ -0001e630: 2028 2e74 6578 7420 2b20 2e64 6174 612c (.text + .data, │ │ │ │ │ -0001e640: 2075 6e63 6f6d 7072 6573 7365 6429 2069 uncompressed) i │ │ │ │ │ -0001e650: 7320 6c69 6d69 7465 6420 6279 2074 6865 s limited by the │ │ │ │ │ -0001e660: 2073 7061 6365 0a20 2020 2020 6672 6f6d space. from │ │ │ │ │ -0001e670: 2038 6264 3030 3030 3020 666f 7277 6172 8bd00000 forwar │ │ │ │ │ -0001e680: 6420 6d6f 6475 6c65 7320 2875 6e63 6f6d d modules (uncom │ │ │ │ │ -0001e690: 7072 6573 7365 6429 202b 2028 6d6f 6475 pressed) + (modu │ │ │ │ │ -0001e6a0: 6c65 7320 2b0a 2020 2020 206b 6572 6e65 les +. kerne │ │ │ │ │ -0001e6b0: 6c2e 696d 6720 282e 7465 7874 202b 202e l.img (.text + . │ │ │ │ │ -0001e6c0: 6461 7461 2929 2028 636f 6d70 7265 7373 data)) (compress │ │ │ │ │ -0001e6d0: 6564 2c20 616c 6967 6e65 6420 746f 2031 ed, aligned to 1 │ │ │ │ │ -0001e6e0: 4d29 202b 2031 4d0a 2020 2020 2028 6465 M) + 1M. (de │ │ │ │ │ -0001e6f0: 636f 6d70 7265 7373 6f72 202b 2073 6372 compressor + scr │ │ │ │ │ -0001e700: 6174 6368 2073 7061 6365 2920 6973 206c atch space) is l │ │ │ │ │ -0001e710: 696d 6974 6564 2062 7920 7468 6520 7370 imited by the sp │ │ │ │ │ -0001e720: 6163 6520 6672 6f6d 0a20 2020 2020 3862 ace from. 8b │ │ │ │ │ -0001e730: 6430 3030 3030 2062 6163 6b77 6172 640a d00000 backward. │ │ │ │ │ -0001e740: 2020 202a 2070 6f77 6572 7063 2d69 6565 * powerpc-iee │ │ │ │ │ -0001e750: 6531 3237 353a 206b 6572 6e65 6c2e 696d e1275: kernel.im │ │ │ │ │ -0001e760: 6720 282e 7465 7874 202b 202e 6461 7461 g (.text + .data │ │ │ │ │ -0001e770: 202b 202e 6273 7329 202b 206d 6f64 756c + .bss) + modul │ │ │ │ │ -0001e780: 6573 2069 730a 2020 2020 206c 696d 6974 es is. limit │ │ │ │ │ -0001e790: 6564 2062 7920 7370 6163 6520 6176 6169 ed by space avai │ │ │ │ │ -0001e7a0: 6c61 626c 6520 6174 2030 7832 3030 3030 lable at 0x20000 │ │ │ │ │ -0001e7b0: 300a 0a1f 0a46 696c 653a 2067 7275 622e 0....File: grub. │ │ │ │ │ -0001e7c0: 696e 666f 2c20 204e 6f64 653a 2046 696c info, Node: Fil │ │ │ │ │ -0001e7d0: 6573 7973 7465 6d2c 2020 4e65 7874 3a20 esystem, Next: │ │ │ │ │ -0001e7e0: 496e 7465 7266 6163 652c 2020 5072 6576 Interface, Prev │ │ │ │ │ -0001e7f0: 3a20 436f 7265 2069 6d61 6765 2073 697a : Core image siz │ │ │ │ │ -0001e800: 6520 6c69 6d69 7461 7469 6f6e 2c20 2055 e limitation, U │ │ │ │ │ -0001e810: 703a 2054 6f70 0a0a 3133 2046 696c 6573 p: Top..13 Files │ │ │ │ │ -0001e820: 7973 7465 6d20 7379 6e74 6178 2061 6e64 ystem syntax and │ │ │ │ │ -0001e830: 2073 656d 616e 7469 6373 0a2a 2a2a 2a2a semantics.***** │ │ │ │ │ +0001de40: 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a 4865 6176 **********..Heav │ │ │ │ │ +0001de50: 696c 7920 6c69 6d69 7465 6420 706c 6174 ily limited plat │ │ │ │ │ +0001de60: 666f 726d 733a 0a20 2020 2a20 6933 3836 forms:. * i386 │ │ │ │ │ +0001de70: 2d70 6320 286e 6f72 6d61 6c20 616e 6420 -pc (normal and │ │ │ │ │ +0001de80: 5058 4529 3a20 7468 6520 636f 7265 2069 PXE): the core i │ │ │ │ │ +0001de90: 6d61 6765 2073 697a 6520 2863 6f6d 7072 mage size (compr │ │ │ │ │ +0001dea0: 6573 7365 6429 2069 730a 2020 2020 206c essed) is. l │ │ │ │ │ +0001deb0: 696d 6974 6564 2062 7920 3435 3832 3430 imited by 458240 │ │ │ │ │ +0001dec0: 2062 7974 6573 2e20 206b 6572 6e65 6c2e bytes. kernel. │ │ │ │ │ +0001ded0: 696d 6720 282e 7465 7874 202b 202e 6461 img (.text + .da │ │ │ │ │ +0001dee0: 7461 202b 202e 6273 732c 0a20 2020 2020 ta + .bss,. │ │ │ │ │ +0001def0: 756e 636f 6d70 7265 7373 6564 2920 6973 uncompressed) is │ │ │ │ │ +0001df00: 206c 696d 6974 6564 2062 7920 3339 3237 limited by 3927 │ │ │ │ │ +0001df10: 3034 2062 7974 6573 2e20 206d 6f64 756c 04 bytes. modul │ │ │ │ │ +0001df20: 6520 7369 7a65 0a20 2020 2020 2875 6e63 e size. (unc │ │ │ │ │ +0001df30: 6f6d 7072 6573 7365 6429 202b 206b 6572 ompressed) + ker │ │ │ │ │ +0001df40: 6e65 6c2e 696d 6720 282e 7465 7874 202b nel.img (.text + │ │ │ │ │ +0001df50: 202e 6461 7461 2c20 756e 636f 6d70 7265 .data, uncompre │ │ │ │ │ +0001df60: 7373 6564 2920 6973 0a20 2020 2020 6c69 ssed) is. li │ │ │ │ │ +0001df70: 6d69 7465 6420 6279 2074 6865 2073 697a mited by the siz │ │ │ │ │ +0001df80: 6520 6f66 2063 6f6e 7469 6775 6f75 7320 e of contiguous │ │ │ │ │ +0001df90: 6368 756e 6b20 6174 2031 4d20 6164 6472 chunk at 1M addr │ │ │ │ │ +0001dfa0: 6573 732e 0a20 2020 2a20 7370 6172 6336 ess.. * sparc6 │ │ │ │ │ +0001dfb0: 342d 6965 6565 3132 3735 3a20 6b65 726e 4-ieee1275: kern │ │ │ │ │ +0001dfc0: 656c 2e69 6d67 2028 2e74 6578 7420 2b20 el.img (.text + │ │ │ │ │ +0001dfd0: 2e64 6174 6120 2b20 2e62 7373 2920 2b20 .data + .bss) + │ │ │ │ │ +0001dfe0: 6d6f 6475 6c65 7320 2b0a 2020 2020 2032 modules +. 2 │ │ │ │ │ +0001dff0: 3536 4b20 2873 7461 636b 2920 2b20 324d 56K (stack) + 2M │ │ │ │ │ +0001e000: 2028 6865 6170 2920 6973 206c 696d 6974 (heap) is limit │ │ │ │ │ +0001e010: 6564 2062 7920 7370 6163 6520 6176 6169 ed by space avai │ │ │ │ │ +0001e020: 6c61 626c 6520 6174 2030 7834 3430 302e lable at 0x4400. │ │ │ │ │ +0001e030: 0a20 2020 2020 4f6e 206d 6f73 7420 706c . On most pl │ │ │ │ │ +0001e040: 6174 666f 726d 7320 6974 2773 206a 7573 atforms it's jus │ │ │ │ │ +0001e050: 7420 3320 6f72 2034 4d20 7369 6e63 6520 t 3 or 4M since │ │ │ │ │ +0001e060: 6965 6565 3132 3735 206d 6170 7320 6f6e ieee1275 maps on │ │ │ │ │ +0001e070: 6c79 2073 6f0a 2020 2020 206d 7563 682e ly so. much. │ │ │ │ │ +0001e080: 0a20 2020 2a20 6933 3836 2d69 6565 6531 . * i386-ieee1 │ │ │ │ │ +0001e090: 3237 353a 206b 6572 6e65 6c2e 696d 6720 275: kernel.img │ │ │ │ │ +0001e0a0: 282e 7465 7874 202b 202e 6461 7461 202b (.text + .data + │ │ │ │ │ +0001e0b0: 202e 6273 7329 202b 206d 6f64 756c 6573 .bss) + modules │ │ │ │ │ +0001e0c0: 2069 730a 2020 2020 206c 696d 6974 6564 is. limited │ │ │ │ │ +0001e0d0: 2062 7920 6d65 6d6f 7279 2061 7661 696c by memory avail │ │ │ │ │ +0001e0e0: 6162 6c65 2061 7420 3078 3130 3030 302c able at 0x10000, │ │ │ │ │ +0001e0f0: 2061 7420 6d6f 7374 2035 3936 4b0a 0a20 at most 596K.. │ │ │ │ │ +0001e100: 2020 4c69 6768 746c 7920 6c69 6d69 7465 Lightly limite │ │ │ │ │ +0001e110: 6420 706c 6174 666f 726d 733a 0a0a 2020 d platforms:.. │ │ │ │ │ +0001e120: 202a 202a 2d78 656e 3a20 6c69 6d69 7465 * *-xen: limite │ │ │ │ │ +0001e130: 6420 6f6e 6c79 2062 7920 6164 7265 7373 d only by adress │ │ │ │ │ +0001e140: 2073 7061 6365 2061 6e64 2052 414d 2073 space and RAM s │ │ │ │ │ +0001e150: 697a 652e 0a20 2020 2a20 6933 3836 2d71 ize.. * i386-q │ │ │ │ │ +0001e160: 656d 753a 206b 6572 6e65 6c2e 696d 6720 emu: kernel.img │ │ │ │ │ +0001e170: 282e 7465 7874 202b 202e 6461 7461 202b (.text + .data + │ │ │ │ │ +0001e180: 202e 6273 7329 2069 7320 6c69 6d69 7465 .bss) is limite │ │ │ │ │ +0001e190: 6420 6279 2033 3932 3730 340a 2020 2020 d by 392704. │ │ │ │ │ +0001e1a0: 2062 7974 6573 2e20 2028 636f 7265 2e69 bytes. (core.i │ │ │ │ │ +0001e1b0: 6d67 2077 6f75 6c64 2062 6520 6c69 6d69 mg would be limi │ │ │ │ │ +0001e1c0: 7465 6420 6279 2052 4f4d 2073 697a 6520 ted by ROM size │ │ │ │ │ +0001e1d0: 6275 7420 6974 2773 2075 6e6c 696d 6974 but it's unlimit │ │ │ │ │ +0001e1e0: 6564 0a20 2020 2020 6f6e 2071 656d 750a ed. on qemu. │ │ │ │ │ +0001e1f0: 2020 202a 2041 6c6c 2045 4649 2070 6c61 * All EFI pla │ │ │ │ │ +0001e200: 7466 6f72 6d73 3a20 6c69 6d69 7465 6420 tforms: limited │ │ │ │ │ +0001e210: 6279 2063 6f6e 7469 6775 6f75 7320 5241 by contiguous RA │ │ │ │ │ +0001e220: 4d20 7369 7a65 2061 6e64 2070 6f73 7369 M size and possi │ │ │ │ │ +0001e230: 626c 790a 2020 2020 2066 6972 6d77 6172 bly. firmwar │ │ │ │ │ +0001e240: 6520 6275 6773 0a20 2020 2a20 436f 7265 e bugs. * Core │ │ │ │ │ +0001e250: 626f 6f74 2061 6e64 206d 756c 7469 626f boot and multibo │ │ │ │ │ +0001e260: 6f74 2e20 206b 6572 6e65 6c2e 696d 6720 ot. kernel.img │ │ │ │ │ +0001e270: 282e 7465 7874 202b 202e 6461 7461 202b (.text + .data + │ │ │ │ │ +0001e280: 202e 6273 7329 2069 730a 2020 2020 206c .bss) is. l │ │ │ │ │ +0001e290: 696d 6974 6564 2062 7920 3339 3237 3034 imited by 392704 │ │ │ │ │ +0001e2a0: 2062 7974 6573 2e20 206d 6f64 756c 6520 bytes. module │ │ │ │ │ +0001e2b0: 7369 7a65 2069 7320 6c69 6d69 7465 6420 size is limited │ │ │ │ │ +0001e2c0: 6279 2074 6865 2073 697a 6520 6f66 0a20 by the size of. │ │ │ │ │ +0001e2d0: 2020 2020 636f 6e74 6967 756f 7573 2063 contiguous c │ │ │ │ │ +0001e2e0: 6875 6e6b 2061 7420 314d 2061 6464 7265 hunk at 1M addre │ │ │ │ │ +0001e2f0: 7373 2e0a 2020 202a 206d 6970 7365 6c2d ss.. * mipsel- │ │ │ │ │ +0001e300: 6c6f 6f6e 6773 6f6e 2028 454c 4629 2c20 loongson (ELF), │ │ │ │ │ +0001e310: 6d69 7073 2865 6c29 2d71 656d 755f 6d69 mips(el)-qemu_mi │ │ │ │ │ +0001e320: 7073 2028 454c 4629 3a20 6966 2075 6e63 ps (ELF): if unc │ │ │ │ │ +0001e330: 6f6d 7072 6573 7365 643a 0a20 2020 2020 ompressed:. │ │ │ │ │ +0001e340: 6b65 726e 656c 2e69 6d67 2028 2e74 6578 kernel.img (.tex │ │ │ │ │ +0001e350: 7420 2b20 2e64 6174 6129 202b 206d 6f64 t + .data) + mod │ │ │ │ │ +0001e360: 756c 6573 2069 7320 6c69 6d69 7465 6420 ules is limited │ │ │ │ │ +0001e370: 6279 2074 6865 2073 7061 6365 2066 726f by the space fro │ │ │ │ │ +0001e380: 6d0a 2020 2020 2038 3032 3030 3030 3020 m. 80200000 │ │ │ │ │ +0001e390: 666f 7277 6172 6420 6966 2063 6f6d 7072 forward if compr │ │ │ │ │ +0001e3a0: 6573 7365 643a 206b 6572 6e65 6c2e 696d essed: kernel.im │ │ │ │ │ +0001e3b0: 6720 282e 7465 7874 202b 202e 6461 7461 g (.text + .data │ │ │ │ │ +0001e3c0: 2c0a 2020 2020 2075 6e63 6f6d 7072 6573 ,. uncompres │ │ │ │ │ +0001e3d0: 7365 6429 202b 206d 6f64 756c 6573 2028 sed) + modules ( │ │ │ │ │ +0001e3e0: 756e 636f 6d70 7265 7373 6564 2920 2b20 uncompressed) + │ │ │ │ │ +0001e3f0: 286d 6f64 756c 6573 202b 206b 6572 6e65 (modules + kerne │ │ │ │ │ +0001e400: 6c2e 696d 670a 2020 2020 2028 2e74 6578 l.img. (.tex │ │ │ │ │ +0001e410: 7420 2b20 2e64 6174 6129 2920 2863 6f6d t + .data)) (com │ │ │ │ │ +0001e420: 7072 6573 7365 6429 202b 2064 6563 6f6d pressed) + decom │ │ │ │ │ +0001e430: 7072 6573 736f 7220 6973 206c 696d 6974 pressor is limit │ │ │ │ │ +0001e440: 6564 2062 7920 7468 650a 2020 2020 2073 ed by the. s │ │ │ │ │ +0001e450: 7061 6365 2066 726f 6d20 3830 3230 3030 pace from 802000 │ │ │ │ │ +0001e460: 3030 2066 6f72 7761 7264 0a20 2020 2a20 00 forward. * │ │ │ │ │ +0001e470: 6d69 7073 656c 2d6c 6f6f 6e67 736f 6e20 mipsel-loongson │ │ │ │ │ +0001e480: 2846 6c61 7368 292c 206d 6970 7328 656c (Flash), mips(el │ │ │ │ │ +0001e490: 292d 7165 6d75 5f6d 6970 7320 2846 6c61 )-qemu_mips (Fla │ │ │ │ │ +0001e4a0: 7368 293a 206b 6572 6e65 6c2e 696d 670a sh): kernel.img. │ │ │ │ │ +0001e4b0: 2020 2020 2028 2e74 6578 7420 2b20 2e64 (.text + .d │ │ │ │ │ +0001e4c0: 6174 6129 202b 206d 6f64 756c 6573 2069 ata) + modules i │ │ │ │ │ +0001e4d0: 7320 6c69 6d69 7465 6420 6279 2074 6865 s limited by the │ │ │ │ │ +0001e4e0: 2073 7061 6365 2066 726f 6d20 3830 3230 space from 8020 │ │ │ │ │ +0001e4f0: 3030 3030 0a20 2020 2020 666f 7277 6172 0000. forwar │ │ │ │ │ +0001e500: 6420 636f 7265 2e69 6d67 2028 6669 6e61 d core.img (fina │ │ │ │ │ +0001e510: 6c29 2069 7320 6c69 6d69 7465 6420 6279 l) is limited by │ │ │ │ │ +0001e520: 2066 6c61 7368 2073 697a 6520 2835 3132 flash size (512 │ │ │ │ │ +0001e530: 4b20 6f6e 2079 6565 6c6f 6f6e 670a 2020 K on yeeloong. │ │ │ │ │ +0001e540: 2020 2061 6e64 2066 756c 6f6f 6f6e 6729 and fulooong) │ │ │ │ │ +0001e550: 0a20 2020 2a20 6d69 7073 2d61 7263 3a20 . * mips-arc: │ │ │ │ │ +0001e560: 6966 2075 6e63 6f6d 7072 6573 7365 643a if uncompressed: │ │ │ │ │ +0001e570: 206b 6572 6e65 6c2e 696d 6720 282e 7465 kernel.img (.te │ │ │ │ │ +0001e580: 7874 202b 202e 6461 7461 2920 6973 206c xt + .data) is l │ │ │ │ │ +0001e590: 696d 6974 6564 2062 790a 2020 2020 2074 imited by. t │ │ │ │ │ +0001e5a0: 6865 2073 7061 6365 2066 726f 6d20 3862 he space from 8b │ │ │ │ │ +0001e5b0: 6430 3030 3030 2066 6f72 7761 7264 206d d00000 forward m │ │ │ │ │ +0001e5c0: 6f64 756c 6573 202b 2064 756d 6d79 2064 odules + dummy d │ │ │ │ │ +0001e5d0: 6563 6f6d 7072 6573 736f 7220 6973 0a20 ecompressor is. │ │ │ │ │ +0001e5e0: 2020 2020 6c69 6d69 7465 6420 6279 2074 limited by t │ │ │ │ │ +0001e5f0: 6865 2073 7061 6365 2066 726f 6d20 3862 he space from 8b │ │ │ │ │ +0001e600: 6430 3030 3030 2062 6163 6b77 6172 6420 d00000 backward │ │ │ │ │ +0001e610: 6966 2063 6f6d 7072 6573 7365 643a 0a20 if compressed:. │ │ │ │ │ +0001e620: 2020 2020 6b65 726e 656c 2e69 6d67 2028 kernel.img ( │ │ │ │ │ +0001e630: 2e74 6578 7420 2b20 2e64 6174 612c 2075 .text + .data, u │ │ │ │ │ +0001e640: 6e63 6f6d 7072 6573 7365 6429 2069 7320 ncompressed) is │ │ │ │ │ +0001e650: 6c69 6d69 7465 6420 6279 2074 6865 2073 limited by the s │ │ │ │ │ +0001e660: 7061 6365 0a20 2020 2020 6672 6f6d 2038 pace. from 8 │ │ │ │ │ +0001e670: 6264 3030 3030 3020 666f 7277 6172 6420 bd00000 forward │ │ │ │ │ +0001e680: 6d6f 6475 6c65 7320 2875 6e63 6f6d 7072 modules (uncompr │ │ │ │ │ +0001e690: 6573 7365 6429 202b 2028 6d6f 6475 6c65 essed) + (module │ │ │ │ │ +0001e6a0: 7320 2b0a 2020 2020 206b 6572 6e65 6c2e s +. kernel. │ │ │ │ │ +0001e6b0: 696d 6720 282e 7465 7874 202b 202e 6461 img (.text + .da │ │ │ │ │ +0001e6c0: 7461 2929 2028 636f 6d70 7265 7373 6564 ta)) (compressed │ │ │ │ │ +0001e6d0: 2c20 616c 6967 6e65 6420 746f 2031 4d29 , aligned to 1M) │ │ │ │ │ +0001e6e0: 202b 2031 4d0a 2020 2020 2028 6465 636f + 1M. (deco │ │ │ │ │ +0001e6f0: 6d70 7265 7373 6f72 202b 2073 6372 6174 mpressor + scrat │ │ │ │ │ +0001e700: 6368 2073 7061 6365 2920 6973 206c 696d ch space) is lim │ │ │ │ │ +0001e710: 6974 6564 2062 7920 7468 6520 7370 6163 ited by the spac │ │ │ │ │ +0001e720: 6520 6672 6f6d 0a20 2020 2020 3862 6430 e from. 8bd0 │ │ │ │ │ +0001e730: 3030 3030 2062 6163 6b77 6172 640a 2020 0000 backward. │ │ │ │ │ +0001e740: 202a 2070 6f77 6572 7063 2d69 6565 6531 * powerpc-ieee1 │ │ │ │ │ +0001e750: 3237 353a 206b 6572 6e65 6c2e 696d 6720 275: kernel.img │ │ │ │ │ +0001e760: 282e 7465 7874 202b 202e 6461 7461 202b (.text + .data + │ │ │ │ │ +0001e770: 202e 6273 7329 202b 206d 6f64 756c 6573 .bss) + modules │ │ │ │ │ +0001e780: 2069 730a 2020 2020 206c 696d 6974 6564 is. limited │ │ │ │ │ +0001e790: 2062 7920 7370 6163 6520 6176 6169 6c61 by space availa │ │ │ │ │ +0001e7a0: 626c 6520 6174 2030 7832 3030 3030 300a ble at 0x200000. │ │ │ │ │ +0001e7b0: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ +0001e7c0: 666f 2c20 204e 6f64 653a 2046 696c 6573 fo, Node: Files │ │ │ │ │ +0001e7d0: 7973 7465 6d2c 2020 4e65 7874 3a20 496e ystem, Next: In │ │ │ │ │ +0001e7e0: 7465 7266 6163 652c 2020 5072 6576 3a20 terface, Prev: │ │ │ │ │ +0001e7f0: 436f 7265 2069 6d61 6765 2073 697a 6520 Core image size │ │ │ │ │ +0001e800: 6c69 6d69 7461 7469 6f6e 2c20 2055 703a limitation, Up: │ │ │ │ │ +0001e810: 2054 6f70 0a0a 3133 2046 696c 6573 7973 Top..13 Filesys │ │ │ │ │ +0001e820: 7465 6d20 7379 6e74 6178 2061 6e64 2073 tem syntax and s │ │ │ │ │ +0001e830: 656d 616e 7469 6373 0a2a 2a2a 2a2a 2a2a emantics.******* │ │ │ │ │ 0001e840: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -0001e850: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a47 *************..G │ │ │ │ │ -0001e860: 5255 4220 7573 6573 2061 2073 7065 6369 RUB uses a speci │ │ │ │ │ -0001e870: 616c 2073 796e 7461 7820 666f 7220 7370 al syntax for sp │ │ │ │ │ -0001e880: 6563 6966 7969 6e67 2064 6973 6b20 6472 ecifying disk dr │ │ │ │ │ -0001e890: 6976 6573 2077 6869 6368 2063 616e 2062 ives which can b │ │ │ │ │ -0001e8a0: 650a 6163 6365 7373 6564 2062 7920 4249 e.accessed by BI │ │ │ │ │ -0001e8b0: 4f53 2e20 4265 6361 7573 6520 6f66 2042 OS. Because of B │ │ │ │ │ -0001e8c0: 494f 5320 6c69 6d69 7461 7469 6f6e 732c IOS limitations, │ │ │ │ │ -0001e8d0: 2047 5255 4220 6361 6e6e 6f74 2064 6973 GRUB cannot dis │ │ │ │ │ -0001e8e0: 7469 6e67 7569 7368 0a62 6574 7765 656e tinguish.between │ │ │ │ │ -0001e8f0: 2049 4445 2c20 4553 4449 2c20 5343 5349 IDE, ESDI, SCSI │ │ │ │ │ -0001e900: 2c20 6f72 206f 7468 6572 732e 2020 596f , or others. Yo │ │ │ │ │ -0001e910: 7520 6d75 7374 206b 6e6f 7720 796f 7572 u must know your │ │ │ │ │ -0001e920: 7365 6c66 2077 6869 6368 2042 494f 530a self which BIOS. │ │ │ │ │ -0001e930: 6465 7669 6365 2069 7320 6571 7569 7661 device is equiva │ │ │ │ │ -0001e940: 6c65 6e74 2074 6f20 7768 6963 6820 4f53 lent to which OS │ │ │ │ │ -0001e950: 2064 6576 6963 652e 2020 4e6f 726d 616c device. Normal │ │ │ │ │ -0001e960: 6c79 2c20 7468 6174 2077 696c 6c20 6265 ly, that will be │ │ │ │ │ -0001e970: 2063 6c65 6172 0a69 6620 796f 7520 7365 clear.if you se │ │ │ │ │ -0001e980: 6520 7468 6520 6669 6c65 7320 696e 2061 e the files in a │ │ │ │ │ -0001e990: 2064 6576 6963 6520 6f72 2075 7365 2074 device or use t │ │ │ │ │ -0001e9a0: 6865 2063 6f6d 6d61 6e64 2027 7365 6172 he command 'sear │ │ │ │ │ -0001e9b0: 6368 2720 282a 6e6f 7465 0a73 6561 7263 ch' (*note.searc │ │ │ │ │ -0001e9c0: 683a 3a29 2e0a 0a2a 204d 656e 753a 0a0a h::)...* Menu:.. │ │ │ │ │ -0001e9d0: 2a20 4465 7669 6365 2073 796e 7461 783a * Device syntax: │ │ │ │ │ -0001e9e0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -0001e9f0: 486f 7720 746f 2073 7065 6369 6679 2064 How to specify d │ │ │ │ │ -0001ea00: 6576 6963 6573 0a2a 2046 696c 6520 6e61 evices.* File na │ │ │ │ │ -0001ea10: 6d65 2073 796e 7461 783a 3a20 2020 2020 me syntax:: │ │ │ │ │ -0001ea20: 2020 2020 2020 2048 6f77 2074 6f20 7370 How to sp │ │ │ │ │ -0001ea30: 6563 6966 7920 6669 6c65 730a 2a20 426c ecify files.* Bl │ │ │ │ │ -0001ea40: 6f63 6b20 6c69 7374 2073 796e 7461 783a ock list syntax: │ │ │ │ │ -0001ea50: 3a20 2020 2020 2020 2020 2020 486f 7720 : How │ │ │ │ │ -0001ea60: 746f 2073 7065 6369 6679 2062 6c6f 636b to specify block │ │ │ │ │ -0001ea70: 206c 6973 7473 0a0a 1f0a 4669 6c65 3a20 lists....File: │ │ │ │ │ -0001ea80: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ -0001ea90: 3a20 4465 7669 6365 2073 796e 7461 782c : Device syntax, │ │ │ │ │ -0001eaa0: 2020 4e65 7874 3a20 4669 6c65 206e 616d Next: File nam │ │ │ │ │ -0001eab0: 6520 7379 6e74 6178 2c20 2055 703a 2046 e syntax, Up: F │ │ │ │ │ -0001eac0: 696c 6573 7973 7465 6d0a 0a31 332e 3120 ilesystem..13.1 │ │ │ │ │ -0001ead0: 486f 7720 746f 2073 7065 6369 6679 2064 How to specify d │ │ │ │ │ -0001eae0: 6576 6963 6573 0a3d 3d3d 3d3d 3d3d 3d3d evices.========= │ │ │ │ │ +0001e850: 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a47 5255 ***********..GRU │ │ │ │ │ +0001e860: 4220 7573 6573 2061 2073 7065 6369 616c B uses a special │ │ │ │ │ +0001e870: 2073 796e 7461 7820 666f 7220 7370 6563 syntax for spec │ │ │ │ │ +0001e880: 6966 7969 6e67 2064 6973 6b20 6472 6976 ifying disk driv │ │ │ │ │ +0001e890: 6573 2077 6869 6368 2063 616e 2062 650a es which can be. │ │ │ │ │ +0001e8a0: 6163 6365 7373 6564 2062 7920 4249 4f53 accessed by BIOS │ │ │ │ │ +0001e8b0: 2e20 4265 6361 7573 6520 6f66 2042 494f . Because of BIO │ │ │ │ │ +0001e8c0: 5320 6c69 6d69 7461 7469 6f6e 732c 2047 S limitations, G │ │ │ │ │ +0001e8d0: 5255 4220 6361 6e6e 6f74 2064 6973 7469 RUB cannot disti │ │ │ │ │ +0001e8e0: 6e67 7569 7368 0a62 6574 7765 656e 2049 nguish.between I │ │ │ │ │ +0001e8f0: 4445 2c20 4553 4449 2c20 5343 5349 2c20 DE, ESDI, SCSI, │ │ │ │ │ +0001e900: 6f72 206f 7468 6572 732e 2020 596f 7520 or others. You │ │ │ │ │ +0001e910: 6d75 7374 206b 6e6f 7720 796f 7572 7365 must know yourse │ │ │ │ │ +0001e920: 6c66 2077 6869 6368 2042 494f 530a 6465 lf which BIOS.de │ │ │ │ │ +0001e930: 7669 6365 2069 7320 6571 7569 7661 6c65 vice is equivale │ │ │ │ │ +0001e940: 6e74 2074 6f20 7768 6963 6820 4f53 2064 nt to which OS d │ │ │ │ │ +0001e950: 6576 6963 652e 2020 4e6f 726d 616c 6c79 evice. Normally │ │ │ │ │ +0001e960: 2c20 7468 6174 2077 696c 6c20 6265 2063 , that will be c │ │ │ │ │ +0001e970: 6c65 6172 0a69 6620 796f 7520 7365 6520 lear.if you see │ │ │ │ │ +0001e980: 7468 6520 6669 6c65 7320 696e 2061 2064 the files in a d │ │ │ │ │ +0001e990: 6576 6963 6520 6f72 2075 7365 2074 6865 evice or use the │ │ │ │ │ +0001e9a0: 2063 6f6d 6d61 6e64 2027 7365 6172 6368 command 'search │ │ │ │ │ +0001e9b0: 2720 282a 6e6f 7465 0a73 6561 7263 683a ' (*note.search: │ │ │ │ │ +0001e9c0: 3a29 2e0a 0a2a 204d 656e 753a 0a0a 2a20 :)...* Menu:..* │ │ │ │ │ +0001e9d0: 4465 7669 6365 2073 796e 7461 783a 3a20 Device syntax:: │ │ │ │ │ +0001e9e0: 2020 2020 2020 2020 2020 2020 2020 486f Ho │ │ │ │ │ +0001e9f0: 7720 746f 2073 7065 6369 6679 2064 6576 w to specify dev │ │ │ │ │ +0001ea00: 6963 6573 0a2a 2046 696c 6520 6e61 6d65 ices.* File name │ │ │ │ │ +0001ea10: 2073 796e 7461 783a 3a20 2020 2020 2020 syntax:: │ │ │ │ │ +0001ea20: 2020 2020 2048 6f77 2074 6f20 7370 6563 How to spec │ │ │ │ │ +0001ea30: 6966 7920 6669 6c65 730a 2a20 426c 6f63 ify files.* Bloc │ │ │ │ │ +0001ea40: 6b20 6c69 7374 2073 796e 7461 783a 3a20 k list syntax:: │ │ │ │ │ +0001ea50: 2020 2020 2020 2020 2020 486f 7720 746f How to │ │ │ │ │ +0001ea60: 2073 7065 6369 6679 2062 6c6f 636b 206c specify block l │ │ │ │ │ +0001ea70: 6973 7473 0a0a 1f0a 4669 6c65 3a20 6772 ists....File: gr │ │ │ │ │ +0001ea80: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ +0001ea90: 4465 7669 6365 2073 796e 7461 782c 2020 Device syntax, │ │ │ │ │ +0001eaa0: 4e65 7874 3a20 4669 6c65 206e 616d 6520 Next: File name │ │ │ │ │ +0001eab0: 7379 6e74 6178 2c20 2055 703a 2046 696c syntax, Up: Fil │ │ │ │ │ +0001eac0: 6573 7973 7465 6d0a 0a31 332e 3120 486f esystem..13.1 Ho │ │ │ │ │ +0001ead0: 7720 746f 2073 7065 6369 6679 2064 6576 w to specify dev │ │ │ │ │ +0001eae0: 6963 6573 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d ices.=========== │ │ │ │ │ 0001eaf0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0001eb00: 3d3d 0a0a 5468 6520 6465 7669 6365 2073 ==..The device s │ │ │ │ │ -0001eb10: 796e 7461 7820 6973 206c 696b 6520 7468 yntax is like th │ │ │ │ │ -0001eb20: 6973 3a0a 0a20 2020 2020 2844 4556 4943 is:.. (DEVIC │ │ │ │ │ -0001eb30: 455b 2c50 4152 544d 4150 2d4e 414d 4531 E[,PARTMAP-NAME1 │ │ │ │ │ -0001eb40: 5041 5254 2d4e 554d 315b 2c50 4152 544d PART-NUM1[,PARTM │ │ │ │ │ -0001eb50: 4150 2d4e 414d 4532 5041 5254 2d4e 554d AP-NAME2PART-NUM │ │ │ │ │ -0001eb60: 325b 2c2e 2e2e 5d5d 5d29 0a0a 2020 2027 2[,...]]]).. ' │ │ │ │ │ -0001eb70: 5b5d 2720 6d65 616e 7320 7468 6520 7061 []' means the pa │ │ │ │ │ -0001eb80: 7261 6d65 7465 7220 6973 206f 7074 696f rameter is optio │ │ │ │ │ -0001eb90: 6e61 6c2e 2020 4445 5649 4345 2064 6570 nal. DEVICE dep │ │ │ │ │ -0001eba0: 656e 6473 206f 6e20 7468 6520 6469 736b ends on the disk │ │ │ │ │ -0001ebb0: 0a64 7269 7665 7220 696e 2075 7365 2e20 .driver in use. │ │ │ │ │ -0001ebc0: 2042 494f 5320 616e 6420 4546 4920 6469 BIOS and EFI di │ │ │ │ │ -0001ebd0: 736b 7320 7573 6520 6569 7468 6572 2027 sks use either ' │ │ │ │ │ -0001ebe0: 6664 2720 6f72 2027 6864 2720 666f 6c6c fd' or 'hd' foll │ │ │ │ │ -0001ebf0: 6f77 6564 2062 7920 610a 6469 6769 742c owed by a.digit, │ │ │ │ │ -0001ec00: 206c 696b 6520 2766 6430 272c 206f 7220 like 'fd0', or │ │ │ │ │ -0001ec10: 2763 6427 2e20 2041 4843 492c 2050 4154 'cd'. AHCI, PAT │ │ │ │ │ -0001ec20: 4120 2861 7461 292c 2063 7279 7074 6f2c A (ata), crypto, │ │ │ │ │ -0001ec30: 2055 5342 2075 7365 2074 6865 206e 616d USB use the nam │ │ │ │ │ -0001ec40: 650a 6f66 2064 7269 7665 7220 666f 6c6c e.of driver foll │ │ │ │ │ -0001ec50: 6f77 6564 2062 7920 6120 6e75 6d62 6572 owed by a number │ │ │ │ │ -0001ec60: 2e20 204d 656d 6469 736b 2061 6e64 2068 . Memdisk and h │ │ │ │ │ -0001ec70: 6f73 7420 6172 6520 6c69 6d69 7465 6420 ost are limited │ │ │ │ │ -0001ec80: 746f 206f 6e65 0a64 6973 6b20 616e 6420 to one.disk and │ │ │ │ │ -0001ec90: 736f 2069 7427 7320 7265 6665 7265 6420 so it's refered │ │ │ │ │ -0001eca0: 6a75 7374 2062 7920 6472 6976 6572 206e just by driver n │ │ │ │ │ -0001ecb0: 616d 652e 2020 5241 4944 2028 6d64 292c ame. RAID (md), │ │ │ │ │ -0001ecc0: 206f 6664 6973 6b0a 2869 6565 6531 3237 ofdisk.(ieee127 │ │ │ │ │ -0001ecd0: 3520 616e 6420 6e61 6e64 292c 204c 564d 5 and nand), LVM │ │ │ │ │ -0001ece0: 2028 6c76 6d29 2c20 4c44 4d2c 2076 6972 (lvm), LDM, vir │ │ │ │ │ -0001ecf0: 7469 6f20 2876 6473 6b29 2061 6e64 2061 tio (vdsk) and a │ │ │ │ │ -0001ed00: 7263 6469 736b 2028 6172 6329 2075 7365 rcdisk (arc) use │ │ │ │ │ -0001ed10: 0a69 6e74 7269 6e73 6963 206e 616d 6520 .intrinsic name │ │ │ │ │ -0001ed20: 6f66 2064 6973 6b20 7072 6566 6978 6564 of disk prefixed │ │ │ │ │ -0001ed30: 2062 7920 6472 6976 6572 206e 616d 652e by driver name. │ │ │ │ │ -0001ed40: 2020 4164 6469 7469 6f6e 616c 6c79 206a Additionally j │ │ │ │ │ -0001ed50: 7573 740a 226e 616e 6422 2072 6566 6572 ust."nand" refer │ │ │ │ │ -0001ed60: 7320 746f 2074 6865 2064 6973 6b20 616c s to the disk al │ │ │ │ │ -0001ed70: 6961 7365 6420 6173 2022 6e61 6e64 222e iased as "nand". │ │ │ │ │ -0001ed80: 2020 436f 6e66 6c69 6374 7320 6172 6520 Conflicts are │ │ │ │ │ -0001ed90: 736f 6c76 6564 2062 790a 7375 6666 6978 solved by.suffix │ │ │ │ │ -0001eda0: 696e 6720 6120 6e75 6d62 6572 2069 6620 ing a number if │ │ │ │ │ -0001edb0: 6e65 6365 7373 6172 7279 2e20 2043 6f6d necessarry. Com │ │ │ │ │ -0001edc0: 6d61 7320 6e65 6564 2074 6f20 6265 2065 mas need to be e │ │ │ │ │ -0001edd0: 7363 6170 6564 2e20 204c 6f6f 7062 6163 scaped. Loopbac │ │ │ │ │ -0001ede0: 6b0a 7573 6573 2077 6861 7465 7665 7220 k.uses whatever │ │ │ │ │ -0001edf0: 6e61 6d65 2073 7065 6369 6669 6564 2074 name specified t │ │ │ │ │ -0001ee00: 6f20 276c 6f6f 7062 6163 6b27 2063 6f6d o 'loopback' com │ │ │ │ │ -0001ee10: 6d61 6e64 2e20 2048 6f73 7464 6973 6b20 mand. Hostdisk │ │ │ │ │ -0001ee20: 7573 6573 206e 616d 6573 0a73 7065 6369 uses names.speci │ │ │ │ │ -0001ee30: 6669 6564 2069 6e20 6465 7669 6365 2e6d fied in device.m │ │ │ │ │ -0001ee40: 6170 2061 7320 6c6f 6e67 2061 7320 6974 ap as long as it │ │ │ │ │ -0001ee50: 2773 206f 6620 7468 6520 666f 726d 205b 's of the form [ │ │ │ │ │ -0001ee60: 6668 635d 645b 302d 395d 2a20 6f72 0a68 fhc]d[0-9]* or.h │ │ │ │ │ -0001ee70: 6f73 7464 6973 6b2f 3c4f 5320 4445 5649 ostdisk/. For crypto │ │ │ │ │ -0001ee90: 2061 6e64 2052 4149 4420 286d 6429 2061 and RAID (md) a │ │ │ │ │ -0001eea0: 6464 6974 696f 6e61 6c6c 7920 796f 7520 dditionally you │ │ │ │ │ -0001eeb0: 6361 6e20 7573 650a 7468 6520 7379 6e74 can use.the synt │ │ │ │ │ -0001eec0: 6178 203c 6472 6976 6572 206e 616d 653e ax │ │ │ │ │ -0001eed0: 7575 6964 2f3c 7575 6964 3e2e 2020 466f uuid/. Fo │ │ │ │ │ -0001eee0: 7220 4c56 4d20 6164 6469 7469 6f6e 616c r LVM additional │ │ │ │ │ -0001eef0: 6c79 2079 6f75 2063 616e 2075 7365 0a74 ly you can use.t │ │ │ │ │ -0001ef00: 6865 2073 796e 7461 7820 6c76 6d69 642f he syntax lvmid/ │ │ │ │ │ -0001ef10: 3c76 6f6c 756d 652d 6772 6f75 702d 7575 /... (fd0). │ │ │ │ │ -0001ef40: 2020 2020 2868 6430 290a 2020 2020 2028 (hd0). ( │ │ │ │ │ -0001ef50: 6364 290a 2020 2020 2028 6168 6369 3029 cd). (ahci0) │ │ │ │ │ -0001ef60: 0a20 2020 2020 2861 7461 3029 0a20 2020 . (ata0). │ │ │ │ │ -0001ef70: 2020 2863 7279 7074 6f30 290a 2020 2020 (crypto0). │ │ │ │ │ -0001ef80: 2028 7573 6230 290a 2020 2020 2028 6372 (usb0). (cr │ │ │ │ │ -0001ef90: 7970 746f 7575 6964 2f31 3233 3435 3637 yptouuid/1234567 │ │ │ │ │ -0001efa0: 3839 6162 6364 6566 3031 3233 3435 3637 89abcdef01234567 │ │ │ │ │ -0001efb0: 3839 6162 6364 6566 3029 0a20 2020 2020 89abcdef0). │ │ │ │ │ -0001efc0: 286d 6475 7569 642f 3132 3334 3536 3738 (mduuid/12345678 │ │ │ │ │ -0001efd0: 3961 6263 6465 6630 3132 3334 3536 3738 9abcdef012345678 │ │ │ │ │ -0001efe0: 3961 6263 6465 6630 290a 2020 2020 2028 9abcdef0). ( │ │ │ │ │ -0001eff0: 6c76 6d2f 7379 7374 656d 2d72 6f6f 7429 lvm/system-root) │ │ │ │ │ -0001f000: 0a20 2020 2020 286c 766d 6964 2f46 3169 . (lvmid/F1i │ │ │ │ │ -0001f010: 6b67 442d 3252 4553 2d33 3036 472d 696c kgD-2RES-306G-il │ │ │ │ │ -0001f020: 394d 2d37 6977 612d 344e 4b57 2d45 6256 9M-7iwa-4NKW-EbV │ │ │ │ │ -0001f030: 314e 562f 654c 4775 4351 2d4c 344b 612d 1NV/eLGuCQ-L4Ka- │ │ │ │ │ -0001f040: 5855 6752 2d73 6a74 4a2d 6666 6368 2d62 XUgR-sjtJ-ffch-b │ │ │ │ │ -0001f050: 616a 722d 6643 4e66 7a35 290a 2020 2020 ajr-fCNfz5). │ │ │ │ │ -0001f060: 2028 6d64 2f6d 7972 6169 6429 0a20 2020 (md/myraid). │ │ │ │ │ -0001f070: 2020 286d 642f 3029 0a20 2020 2020 2869 (md/0). (i │ │ │ │ │ -0001f080: 6565 6531 3237 352f 6469 736b 3229 0a20 eee1275/disk2). │ │ │ │ │ -0001f090: 2020 2020 2869 6565 6531 3237 352f 2f70 (ieee1275//p │ │ │ │ │ -0001f0a0: 6369 4031 665c 2c30 2f69 6465 4064 2f64 ci@1f\,0/ide@d/d │ │ │ │ │ -0001f0b0: 6973 6b40 3229 0a20 2020 2020 286e 616e isk@2). (nan │ │ │ │ │ -0001f0c0: 6429 0a20 2020 2020 286d 656d 6469 736b d). (memdisk │ │ │ │ │ -0001f0d0: 290a 2020 2020 2028 686f 7374 290a 2020 ). (host). │ │ │ │ │ -0001f0e0: 2020 2028 6d79 6c6f 6f70 290a 2020 2020 (myloop). │ │ │ │ │ -0001f0f0: 2028 686f 7374 6469 736b 2f2f 6465 762f (hostdisk//dev/ │ │ │ │ │ -0001f100: 7364 6129 0a0a 2020 2050 4152 542d 4e55 sda).. PART-NU │ │ │ │ │ -0001f110: 4d20 7265 7072 6573 656e 7473 2074 6865 M represents the │ │ │ │ │ -0001f120: 2070 6172 7469 7469 6f6e 206e 756d 6265 partition numbe │ │ │ │ │ -0001f130: 7220 6f66 2044 4556 4943 452c 2073 7461 r of DEVICE, sta │ │ │ │ │ -0001f140: 7274 696e 6720 6672 6f6d 0a6f 6e65 2e20 rting from.one. │ │ │ │ │ -0001f150: 2050 4152 544e 414d 4520 6973 206f 7074 PARTNAME is opt │ │ │ │ │ -0001f160: 696f 6e61 6c20 6275 7420 6973 2072 6563 ional but is rec │ │ │ │ │ -0001f170: 6f6d 6d65 6e64 6564 2073 696e 6365 2064 ommended since d │ │ │ │ │ -0001f180: 6973 6b20 6d61 7920 6861 7665 0a73 6576 isk may have.sev │ │ │ │ │ -0001f190: 6572 616c 2074 6f70 2d6c 6576 656c 2070 eral top-level p │ │ │ │ │ -0001f1a0: 6172 746d 6170 732e 2020 5370 6563 6966 artmaps. Specif │ │ │ │ │ -0001f1b0: 7969 6e67 2074 6869 7264 2061 6e64 206c ying third and l │ │ │ │ │ -0001f1c0: 6174 6572 2063 6f6d 706f 6e65 6e74 2079 ater component y │ │ │ │ │ -0001f1d0: 6f75 0a63 616e 2061 6363 6573 7320 746f ou.can access to │ │ │ │ │ -0001f1e0: 2073 7562 7061 7274 6974 696f 6e73 2e0a subpartitions.. │ │ │ │ │ -0001f1f0: 0a20 2020 5468 6520 7379 6e74 6178 2027 . The syntax ' │ │ │ │ │ -0001f200: 2868 6430 2927 2072 6570 7265 7365 6e74 (hd0)' represent │ │ │ │ │ -0001f210: 7320 7573 696e 6720 7468 6520 656e 7469 s using the enti │ │ │ │ │ -0001f220: 7265 2064 6973 6b20 286f 7220 7468 6520 re disk (or the │ │ │ │ │ -0001f230: 4d42 5220 7768 656e 0a69 6e73 7461 6c6c MBR when.install │ │ │ │ │ -0001f240: 696e 6720 4752 5542 292c 2077 6869 6c65 ing GRUB), while │ │ │ │ │ -0001f250: 2074 6865 2073 796e 7461 7820 2728 6864 the syntax '(hd │ │ │ │ │ -0001f260: 302c 3129 2720 7265 7072 6573 656e 7473 0,1)' represents │ │ │ │ │ -0001f270: 2075 7369 6e67 2074 6865 2066 6972 7374 using the first │ │ │ │ │ -0001f280: 0a70 6172 7469 7469 6f6e 206f 6620 7468 .partition of th │ │ │ │ │ -0001f290: 6520 6469 736b 2028 6f72 2074 6865 2062 e disk (or the b │ │ │ │ │ -0001f2a0: 6f6f 7420 7365 6374 6f72 206f 6620 7468 oot sector of th │ │ │ │ │ -0001f2b0: 6520 7061 7274 6974 696f 6e20 7768 656e e partition when │ │ │ │ │ -0001f2c0: 0a69 6e73 7461 6c6c 696e 6720 4752 5542 .installing GRUB │ │ │ │ │ -0001f2d0: 292e 0a0a 2020 2020 2028 6864 302c 6d73 )... (hd0,ms │ │ │ │ │ -0001f2e0: 646f 7331 290a 2020 2020 2028 6864 302c dos1). (hd0, │ │ │ │ │ -0001f2f0: 6d73 646f 7331 2c6d 7364 6f73 3529 0a20 msdos1,msdos5). │ │ │ │ │ -0001f300: 2020 2020 2868 6430 2c6d 7364 6f73 312c (hd0,msdos1, │ │ │ │ │ -0001f310: 6273 6433 290a 2020 2020 2028 6864 302c bsd3). (hd0, │ │ │ │ │ -0001f320: 6e65 7462 7364 3129 0a20 2020 2020 2868 netbsd1). (h │ │ │ │ │ -0001f330: 6430 2c67 7074 3129 0a20 2020 2020 2868 d0,gpt1). (h │ │ │ │ │ -0001f340: 6430 2c31 2c33 290a 0a20 2020 4966 2079 d0,1,3).. If y │ │ │ │ │ -0001f350: 6f75 2065 6e61 626c 6564 2074 6865 206e ou enabled the n │ │ │ │ │ -0001f360: 6574 776f 726b 2073 7570 706f 7274 2c20 etwork support, │ │ │ │ │ -0001f370: 7468 6520 7370 6563 6961 6c20 6472 6976 the special driv │ │ │ │ │ -0001f380: 6573 0a27 2850 524f 544f 434f 4c5b 2c53 es.'(PROTOCOL[,S │ │ │ │ │ -0001f390: 4552 5645 525d 2927 2061 7265 2061 6c73 ERVER])' are als │ │ │ │ │ -0001f3a0: 6f20 6176 6169 6c61 626c 652e 2020 5375 o available. Su │ │ │ │ │ -0001f3b0: 7070 6f72 7465 6420 7072 6f74 6f63 6f6c pported protocol │ │ │ │ │ -0001f3c0: 7320 6172 650a 2768 7474 7027 2061 6e64 s are.'http' and │ │ │ │ │ -0001f3d0: 2027 7466 7470 272e 2020 4966 2053 4552 'tftp'. If SER │ │ │ │ │ -0001f3e0: 5645 5220 6973 206f 6d69 7474 6564 2c20 VER is omitted, │ │ │ │ │ -0001f3f0: 7661 6c75 6520 6f66 2065 6e76 6972 6f6e value of environ │ │ │ │ │ -0001f400: 6d65 6e74 2076 6172 6961 626c 650a 276e ment variable.'n │ │ │ │ │ -0001f410: 6574 5f64 6566 6175 6c74 5f73 6572 7665 et_default_serve │ │ │ │ │ -0001f420: 7227 2069 7320 7573 6564 2e20 2042 6566 r' is used. Bef │ │ │ │ │ -0001f430: 6f72 6520 7573 696e 6720 7468 6520 6e65 ore using the ne │ │ │ │ │ -0001f440: 7477 6f72 6b20 6472 6976 652c 2079 6f75 twork drive, you │ │ │ │ │ -0001f450: 206d 7573 740a 696e 6974 6961 6c69 7a65 must.initialize │ │ │ │ │ -0001f460: 2074 6865 206e 6574 776f 726b 2e20 202a the network. * │ │ │ │ │ -0001f470: 4e6f 7465 204e 6574 776f 726b 3a3a 2c20 Note Network::, │ │ │ │ │ -0001f480: 666f 7220 6d6f 7265 2069 6e66 6f72 6d61 for more informa │ │ │ │ │ -0001f490: 7469 6f6e 2e0a 0a20 2020 4966 2079 6f75 tion... If you │ │ │ │ │ -0001f4a0: 2062 6f6f 7420 4752 5542 2066 726f 6d20 boot GRUB from │ │ │ │ │ -0001f4b0: 6120 4344 2d52 4f4d 2c20 2728 6364 2927 a CD-ROM, '(cd)' │ │ │ │ │ -0001f4c0: 2069 7320 6176 6169 6c61 626c 652e 2020 is available. │ │ │ │ │ -0001f4d0: 2a4e 6f74 6520 4d61 6b69 6e67 2061 0a47 *Note Making a.G │ │ │ │ │ -0001f4e0: 5255 4220 626f 6f74 6162 6c65 2043 442d RUB bootable CD- │ │ │ │ │ -0001f4f0: 524f 4d3a 3a2c 2066 6f72 2064 6574 6169 ROM::, for detai │ │ │ │ │ -0001f500: 6c73 2e0a 0a1f 0a46 696c 653a 2067 7275 ls.....File: gru │ │ │ │ │ -0001f510: 622e 696e 666f 2c20 204e 6f64 653a 2046 b.info, Node: F │ │ │ │ │ -0001f520: 696c 6520 6e61 6d65 2073 796e 7461 782c ile name syntax, │ │ │ │ │ -0001f530: 2020 4e65 7874 3a20 426c 6f63 6b20 6c69 Next: Block li │ │ │ │ │ -0001f540: 7374 2073 796e 7461 782c 2020 5072 6576 st syntax, Prev │ │ │ │ │ -0001f550: 3a20 4465 7669 6365 2073 796e 7461 782c : Device syntax, │ │ │ │ │ -0001f560: 2020 5570 3a20 4669 6c65 7379 7374 656d Up: Filesystem │ │ │ │ │ -0001f570: 0a0a 3133 2e32 2048 6f77 2074 6f20 7370 ..13.2 How to sp │ │ │ │ │ -0001f580: 6563 6966 7920 6669 6c65 730a 3d3d 3d3d ecify files.==== │ │ │ │ │ +0001eb00: 0a0a 5468 6520 6465 7669 6365 2073 796e ..The device syn │ │ │ │ │ +0001eb10: 7461 7820 6973 206c 696b 6520 7468 6973 tax is like this │ │ │ │ │ +0001eb20: 3a0a 0a20 2020 2020 2844 4556 4943 455b :.. (DEVICE[ │ │ │ │ │ +0001eb30: 2c50 4152 544d 4150 2d4e 414d 4531 5041 ,PARTMAP-NAME1PA │ │ │ │ │ +0001eb40: 5254 2d4e 554d 315b 2c50 4152 544d 4150 RT-NUM1[,PARTMAP │ │ │ │ │ +0001eb50: 2d4e 414d 4532 5041 5254 2d4e 554d 325b -NAME2PART-NUM2[ │ │ │ │ │ +0001eb60: 2c2e 2e2e 5d5d 5d29 0a0a 2020 2027 5b5d ,...]]]).. '[] │ │ │ │ │ +0001eb70: 2720 6d65 616e 7320 7468 6520 7061 7261 ' means the para │ │ │ │ │ +0001eb80: 6d65 7465 7220 6973 206f 7074 696f 6e61 meter is optiona │ │ │ │ │ +0001eb90: 6c2e 2020 4445 5649 4345 2064 6570 656e l. DEVICE depen │ │ │ │ │ +0001eba0: 6473 206f 6e20 7468 6520 6469 736b 0a64 ds on the disk.d │ │ │ │ │ +0001ebb0: 7269 7665 7220 696e 2075 7365 2e20 2042 river in use. B │ │ │ │ │ +0001ebc0: 494f 5320 616e 6420 4546 4920 6469 736b IOS and EFI disk │ │ │ │ │ +0001ebd0: 7320 7573 6520 6569 7468 6572 2027 6664 s use either 'fd │ │ │ │ │ +0001ebe0: 2720 6f72 2027 6864 2720 666f 6c6c 6f77 ' or 'hd' follow │ │ │ │ │ +0001ebf0: 6564 2062 7920 610a 6469 6769 742c 206c ed by a.digit, l │ │ │ │ │ +0001ec00: 696b 6520 2766 6430 272c 206f 7220 2763 ike 'fd0', or 'c │ │ │ │ │ +0001ec10: 6427 2e20 2041 4843 492c 2050 4154 4120 d'. AHCI, PATA │ │ │ │ │ +0001ec20: 2861 7461 292c 2063 7279 7074 6f2c 2055 (ata), crypto, U │ │ │ │ │ +0001ec30: 5342 2075 7365 2074 6865 206e 616d 650a SB use the name. │ │ │ │ │ +0001ec40: 6f66 2064 7269 7665 7220 666f 6c6c 6f77 of driver follow │ │ │ │ │ +0001ec50: 6564 2062 7920 6120 6e75 6d62 6572 2e20 ed by a number. │ │ │ │ │ +0001ec60: 204d 656d 6469 736b 2061 6e64 2068 6f73 Memdisk and hos │ │ │ │ │ +0001ec70: 7420 6172 6520 6c69 6d69 7465 6420 746f t are limited to │ │ │ │ │ +0001ec80: 206f 6e65 0a64 6973 6b20 616e 6420 736f one.disk and so │ │ │ │ │ +0001ec90: 2069 7427 7320 7265 6665 7265 6420 6a75 it's refered ju │ │ │ │ │ +0001eca0: 7374 2062 7920 6472 6976 6572 206e 616d st by driver nam │ │ │ │ │ +0001ecb0: 652e 2020 5241 4944 2028 6d64 292c 206f e. RAID (md), o │ │ │ │ │ +0001ecc0: 6664 6973 6b0a 2869 6565 6531 3237 3520 fdisk.(ieee1275 │ │ │ │ │ +0001ecd0: 616e 6420 6e61 6e64 292c 204c 564d 2028 and nand), LVM ( │ │ │ │ │ +0001ece0: 6c76 6d29 2c20 4c44 4d2c 2076 6972 7469 lvm), LDM, virti │ │ │ │ │ +0001ecf0: 6f20 2876 6473 6b29 2061 6e64 2061 7263 o (vdsk) and arc │ │ │ │ │ +0001ed00: 6469 736b 2028 6172 6329 2075 7365 0a69 disk (arc) use.i │ │ │ │ │ +0001ed10: 6e74 7269 6e73 6963 206e 616d 6520 6f66 ntrinsic name of │ │ │ │ │ +0001ed20: 2064 6973 6b20 7072 6566 6978 6564 2062 disk prefixed b │ │ │ │ │ +0001ed30: 7920 6472 6976 6572 206e 616d 652e 2020 y driver name. │ │ │ │ │ +0001ed40: 4164 6469 7469 6f6e 616c 6c79 206a 7573 Additionally jus │ │ │ │ │ +0001ed50: 740a 226e 616e 6422 2072 6566 6572 7320 t."nand" refers │ │ │ │ │ +0001ed60: 746f 2074 6865 2064 6973 6b20 616c 6961 to the disk alia │ │ │ │ │ +0001ed70: 7365 6420 6173 2022 6e61 6e64 222e 2020 sed as "nand". │ │ │ │ │ +0001ed80: 436f 6e66 6c69 6374 7320 6172 6520 736f Conflicts are so │ │ │ │ │ +0001ed90: 6c76 6564 2062 790a 7375 6666 6978 696e lved by.suffixin │ │ │ │ │ +0001eda0: 6720 6120 6e75 6d62 6572 2069 6620 6e65 g a number if ne │ │ │ │ │ +0001edb0: 6365 7373 6172 7279 2e20 2043 6f6d 6d61 cessarry. Comma │ │ │ │ │ +0001edc0: 7320 6e65 6564 2074 6f20 6265 2065 7363 s need to be esc │ │ │ │ │ +0001edd0: 6170 6564 2e20 204c 6f6f 7062 6163 6b0a aped. Loopback. │ │ │ │ │ +0001ede0: 7573 6573 2077 6861 7465 7665 7220 6e61 uses whatever na │ │ │ │ │ +0001edf0: 6d65 2073 7065 6369 6669 6564 2074 6f20 me specified to │ │ │ │ │ +0001ee00: 276c 6f6f 7062 6163 6b27 2063 6f6d 6d61 'loopback' comma │ │ │ │ │ +0001ee10: 6e64 2e20 2048 6f73 7464 6973 6b20 7573 nd. Hostdisk us │ │ │ │ │ +0001ee20: 6573 206e 616d 6573 0a73 7065 6369 6669 es names.specifi │ │ │ │ │ +0001ee30: 6564 2069 6e20 6465 7669 6365 2e6d 6170 ed in device.map │ │ │ │ │ +0001ee40: 2061 7320 6c6f 6e67 2061 7320 6974 2773 as long as it's │ │ │ │ │ +0001ee50: 206f 6620 7468 6520 666f 726d 205b 6668 of the form [fh │ │ │ │ │ +0001ee60: 635d 645b 302d 395d 2a20 6f72 0a68 6f73 c]d[0-9]* or.hos │ │ │ │ │ +0001ee70: 7464 6973 6b2f 3c4f 5320 4445 5649 4345 tdisk/. For crypto a │ │ │ │ │ +0001ee90: 6e64 2052 4149 4420 286d 6429 2061 6464 nd RAID (md) add │ │ │ │ │ +0001eea0: 6974 696f 6e61 6c6c 7920 796f 7520 6361 itionally you ca │ │ │ │ │ +0001eeb0: 6e20 7573 650a 7468 6520 7379 6e74 6178 n use.the syntax │ │ │ │ │ +0001eec0: 203c 6472 6976 6572 206e 616d 653e 7575 uu │ │ │ │ │ +0001eed0: 6964 2f3c 7575 6964 3e2e 2020 466f 7220 id/. For │ │ │ │ │ +0001eee0: 4c56 4d20 6164 6469 7469 6f6e 616c 6c79 LVM additionally │ │ │ │ │ +0001eef0: 2079 6f75 2063 616e 2075 7365 0a74 6865 you can use.the │ │ │ │ │ +0001ef00: 2073 796e 7461 7820 6c76 6d69 642f 3c76 syntax lvmid//. │ │ │ │ │ +0001ef30: 0a0a 2020 2020 2028 6664 3029 0a20 2020 .. (fd0). │ │ │ │ │ +0001ef40: 2020 2868 6430 290a 2020 2020 2028 6364 (hd0). (cd │ │ │ │ │ +0001ef50: 290a 2020 2020 2028 6168 6369 3029 0a20 ). (ahci0). │ │ │ │ │ +0001ef60: 2020 2020 2861 7461 3029 0a20 2020 2020 (ata0). │ │ │ │ │ +0001ef70: 2863 7279 7074 6f30 290a 2020 2020 2028 (crypto0). ( │ │ │ │ │ +0001ef80: 7573 6230 290a 2020 2020 2028 6372 7970 usb0). (cryp │ │ │ │ │ +0001ef90: 746f 7575 6964 2f31 3233 3435 3637 3839 touuid/123456789 │ │ │ │ │ +0001efa0: 6162 6364 6566 3031 3233 3435 3637 3839 abcdef0123456789 │ │ │ │ │ +0001efb0: 6162 6364 6566 3029 0a20 2020 2020 286d abcdef0). (m │ │ │ │ │ +0001efc0: 6475 7569 642f 3132 3334 3536 3738 3961 duuid/123456789a │ │ │ │ │ +0001efd0: 6263 6465 6630 3132 3334 3536 3738 3961 bcdef0123456789a │ │ │ │ │ +0001efe0: 6263 6465 6630 290a 2020 2020 2028 6c76 bcdef0). (lv │ │ │ │ │ +0001eff0: 6d2f 7379 7374 656d 2d72 6f6f 7429 0a20 m/system-root). │ │ │ │ │ +0001f000: 2020 2020 286c 766d 6964 2f46 3169 6b67 (lvmid/F1ikg │ │ │ │ │ +0001f010: 442d 3252 4553 2d33 3036 472d 696c 394d D-2RES-306G-il9M │ │ │ │ │ +0001f020: 2d37 6977 612d 344e 4b57 2d45 6256 314e -7iwa-4NKW-EbV1N │ │ │ │ │ +0001f030: 562f 654c 4775 4351 2d4c 344b 612d 5855 V/eLGuCQ-L4Ka-XU │ │ │ │ │ +0001f040: 6752 2d73 6a74 4a2d 6666 6368 2d62 616a gR-sjtJ-ffch-baj │ │ │ │ │ +0001f050: 722d 6643 4e66 7a35 290a 2020 2020 2028 r-fCNfz5). ( │ │ │ │ │ +0001f060: 6d64 2f6d 7972 6169 6429 0a20 2020 2020 md/myraid). │ │ │ │ │ +0001f070: 286d 642f 3029 0a20 2020 2020 2869 6565 (md/0). (iee │ │ │ │ │ +0001f080: 6531 3237 352f 6469 736b 3229 0a20 2020 e1275/disk2). │ │ │ │ │ +0001f090: 2020 2869 6565 6531 3237 352f 2f70 6369 (ieee1275//pci │ │ │ │ │ +0001f0a0: 4031 665c 2c30 2f69 6465 4064 2f64 6973 @1f\,0/ide@d/dis │ │ │ │ │ +0001f0b0: 6b40 3229 0a20 2020 2020 286e 616e 6429 k@2). (nand) │ │ │ │ │ +0001f0c0: 0a20 2020 2020 286d 656d 6469 736b 290a . (memdisk). │ │ │ │ │ +0001f0d0: 2020 2020 2028 686f 7374 290a 2020 2020 (host). │ │ │ │ │ +0001f0e0: 2028 6d79 6c6f 6f70 290a 2020 2020 2028 (myloop). ( │ │ │ │ │ +0001f0f0: 686f 7374 6469 736b 2f2f 6465 762f 7364 hostdisk//dev/sd │ │ │ │ │ +0001f100: 6129 0a0a 2020 2050 4152 542d 4e55 4d20 a).. PART-NUM │ │ │ │ │ +0001f110: 7265 7072 6573 656e 7473 2074 6865 2070 represents the p │ │ │ │ │ +0001f120: 6172 7469 7469 6f6e 206e 756d 6265 7220 artition number │ │ │ │ │ +0001f130: 6f66 2044 4556 4943 452c 2073 7461 7274 of DEVICE, start │ │ │ │ │ +0001f140: 696e 6720 6672 6f6d 0a6f 6e65 2e20 2050 ing from.one. P │ │ │ │ │ +0001f150: 4152 544e 414d 4520 6973 206f 7074 696f ARTNAME is optio │ │ │ │ │ +0001f160: 6e61 6c20 6275 7420 6973 2072 6563 6f6d nal but is recom │ │ │ │ │ +0001f170: 6d65 6e64 6564 2073 696e 6365 2064 6973 mended since dis │ │ │ │ │ +0001f180: 6b20 6d61 7920 6861 7665 0a73 6576 6572 k may have.sever │ │ │ │ │ +0001f190: 616c 2074 6f70 2d6c 6576 656c 2070 6172 al top-level par │ │ │ │ │ +0001f1a0: 746d 6170 732e 2020 5370 6563 6966 7969 tmaps. Specifyi │ │ │ │ │ +0001f1b0: 6e67 2074 6869 7264 2061 6e64 206c 6174 ng third and lat │ │ │ │ │ +0001f1c0: 6572 2063 6f6d 706f 6e65 6e74 2079 6f75 er component you │ │ │ │ │ +0001f1d0: 0a63 616e 2061 6363 6573 7320 746f 2073 .can access to s │ │ │ │ │ +0001f1e0: 7562 7061 7274 6974 696f 6e73 2e0a 0a20 ubpartitions... │ │ │ │ │ +0001f1f0: 2020 5468 6520 7379 6e74 6178 2027 2868 The syntax '(h │ │ │ │ │ +0001f200: 6430 2927 2072 6570 7265 7365 6e74 7320 d0)' represents │ │ │ │ │ +0001f210: 7573 696e 6720 7468 6520 656e 7469 7265 using the entire │ │ │ │ │ +0001f220: 2064 6973 6b20 286f 7220 7468 6520 4d42 disk (or the MB │ │ │ │ │ +0001f230: 5220 7768 656e 0a69 6e73 7461 6c6c 696e R when.installin │ │ │ │ │ +0001f240: 6720 4752 5542 292c 2077 6869 6c65 2074 g GRUB), while t │ │ │ │ │ +0001f250: 6865 2073 796e 7461 7820 2728 6864 302c he syntax '(hd0, │ │ │ │ │ +0001f260: 3129 2720 7265 7072 6573 656e 7473 2075 1)' represents u │ │ │ │ │ +0001f270: 7369 6e67 2074 6865 2066 6972 7374 0a70 sing the first.p │ │ │ │ │ +0001f280: 6172 7469 7469 6f6e 206f 6620 7468 6520 artition of the │ │ │ │ │ +0001f290: 6469 736b 2028 6f72 2074 6865 2062 6f6f disk (or the boo │ │ │ │ │ +0001f2a0: 7420 7365 6374 6f72 206f 6620 7468 6520 t sector of the │ │ │ │ │ +0001f2b0: 7061 7274 6974 696f 6e20 7768 656e 0a69 partition when.i │ │ │ │ │ +0001f2c0: 6e73 7461 6c6c 696e 6720 4752 5542 292e nstalling GRUB). │ │ │ │ │ +0001f2d0: 0a0a 2020 2020 2028 6864 302c 6d73 646f .. (hd0,msdo │ │ │ │ │ +0001f2e0: 7331 290a 2020 2020 2028 6864 302c 6d73 s1). (hd0,ms │ │ │ │ │ +0001f2f0: 646f 7331 2c6d 7364 6f73 3529 0a20 2020 dos1,msdos5). │ │ │ │ │ +0001f300: 2020 2868 6430 2c6d 7364 6f73 312c 6273 (hd0,msdos1,bs │ │ │ │ │ +0001f310: 6433 290a 2020 2020 2028 6864 302c 6e65 d3). (hd0,ne │ │ │ │ │ +0001f320: 7462 7364 3129 0a20 2020 2020 2868 6430 tbsd1). (hd0 │ │ │ │ │ +0001f330: 2c67 7074 3129 0a20 2020 2020 2868 6430 ,gpt1). (hd0 │ │ │ │ │ +0001f340: 2c31 2c33 290a 0a20 2020 4966 2079 6f75 ,1,3).. If you │ │ │ │ │ +0001f350: 2065 6e61 626c 6564 2074 6865 206e 6574 enabled the net │ │ │ │ │ +0001f360: 776f 726b 2073 7570 706f 7274 2c20 7468 work support, th │ │ │ │ │ +0001f370: 6520 7370 6563 6961 6c20 6472 6976 6573 e special drives │ │ │ │ │ +0001f380: 0a27 2850 524f 544f 434f 4c5b 2c53 4552 .'(PROTOCOL[,SER │ │ │ │ │ +0001f390: 5645 525d 2927 2061 7265 2061 6c73 6f20 VER])' are also │ │ │ │ │ +0001f3a0: 6176 6169 6c61 626c 652e 2020 5375 7070 available. Supp │ │ │ │ │ +0001f3b0: 6f72 7465 6420 7072 6f74 6f63 6f6c 7320 orted protocols │ │ │ │ │ +0001f3c0: 6172 650a 2768 7474 7027 2061 6e64 2027 are.'http' and ' │ │ │ │ │ +0001f3d0: 7466 7470 272e 2020 4966 2053 4552 5645 tftp'. If SERVE │ │ │ │ │ +0001f3e0: 5220 6973 206f 6d69 7474 6564 2c20 7661 R is omitted, va │ │ │ │ │ +0001f3f0: 6c75 6520 6f66 2065 6e76 6972 6f6e 6d65 lue of environme │ │ │ │ │ +0001f400: 6e74 2076 6172 6961 626c 650a 276e 6574 nt variable.'net │ │ │ │ │ +0001f410: 5f64 6566 6175 6c74 5f73 6572 7665 7227 _default_server' │ │ │ │ │ +0001f420: 2069 7320 7573 6564 2e20 2042 6566 6f72 is used. Befor │ │ │ │ │ +0001f430: 6520 7573 696e 6720 7468 6520 6e65 7477 e using the netw │ │ │ │ │ +0001f440: 6f72 6b20 6472 6976 652c 2079 6f75 206d ork drive, you m │ │ │ │ │ +0001f450: 7573 740a 696e 6974 6961 6c69 7a65 2074 ust.initialize t │ │ │ │ │ +0001f460: 6865 206e 6574 776f 726b 2e20 202a 4e6f he network. *No │ │ │ │ │ +0001f470: 7465 204e 6574 776f 726b 3a3a 2c20 666f te Network::, fo │ │ │ │ │ +0001f480: 7220 6d6f 7265 2069 6e66 6f72 6d61 7469 r more informati │ │ │ │ │ +0001f490: 6f6e 2e0a 0a20 2020 4966 2079 6f75 2062 on... If you b │ │ │ │ │ +0001f4a0: 6f6f 7420 4752 5542 2066 726f 6d20 6120 oot GRUB from a │ │ │ │ │ +0001f4b0: 4344 2d52 4f4d 2c20 2728 6364 2927 2069 CD-ROM, '(cd)' i │ │ │ │ │ +0001f4c0: 7320 6176 6169 6c61 626c 652e 2020 2a4e s available. *N │ │ │ │ │ +0001f4d0: 6f74 6520 4d61 6b69 6e67 2061 0a47 5255 ote Making a.GRU │ │ │ │ │ +0001f4e0: 4220 626f 6f74 6162 6c65 2043 442d 524f B bootable CD-RO │ │ │ │ │ +0001f4f0: 4d3a 3a2c 2066 6f72 2064 6574 6169 6c73 M::, for details │ │ │ │ │ +0001f500: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ +0001f510: 696e 666f 2c20 204e 6f64 653a 2046 696c info, Node: Fil │ │ │ │ │ +0001f520: 6520 6e61 6d65 2073 796e 7461 782c 2020 e name syntax, │ │ │ │ │ +0001f530: 4e65 7874 3a20 426c 6f63 6b20 6c69 7374 Next: Block list │ │ │ │ │ +0001f540: 2073 796e 7461 782c 2020 5072 6576 3a20 syntax, Prev: │ │ │ │ │ +0001f550: 4465 7669 6365 2073 796e 7461 782c 2020 Device syntax, │ │ │ │ │ +0001f560: 5570 3a20 4669 6c65 7379 7374 656d 0a0a Up: Filesystem.. │ │ │ │ │ +0001f570: 3133 2e32 2048 6f77 2074 6f20 7370 6563 13.2 How to spec │ │ │ │ │ +0001f580: 6966 7920 6669 6c65 730a 3d3d 3d3d 3d3d ify files.====== │ │ │ │ │ 0001f590: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0001f5a0: 3d3d 3d3d 3d0a 0a54 6865 7265 2061 7265 =====..There are │ │ │ │ │ -0001f5b0: 2074 776f 2077 6179 7320 746f 2073 7065 two ways to spe │ │ │ │ │ -0001f5c0: 6369 6679 2066 696c 6573 2c20 6279 2022 cify files, by " │ │ │ │ │ -0001f5d0: 6162 736f 6c75 7465 2066 696c 6520 6e61 absolute file na │ │ │ │ │ -0001f5e0: 6d65 2220 616e 6420 6279 0a22 626c 6f63 me" and by."bloc │ │ │ │ │ -0001f5f0: 6b20 6c69 7374 222e 0a0a 2020 2041 6e20 k list"... An │ │ │ │ │ -0001f600: 6162 736f 6c75 7465 2066 696c 6520 6e61 absolute file na │ │ │ │ │ -0001f610: 6d65 2072 6573 656d 626c 6573 2061 2055 me resembles a U │ │ │ │ │ -0001f620: 6e69 7820 6162 736f 6c75 7465 2066 696c nix absolute fil │ │ │ │ │ -0001f630: 6520 6e61 6d65 2c20 7573 696e 6720 272f e name, using '/ │ │ │ │ │ -0001f640: 270a 666f 7220 7468 6520 6469 7265 6374 '.for the direct │ │ │ │ │ -0001f650: 6f72 7920 7365 7061 7261 746f 7220 286e ory separator (n │ │ │ │ │ -0001f660: 6f74 2027 5c27 2061 7320 696e 2044 4f53 ot '\' as in DOS │ │ │ │ │ -0001f670: 292e 204f 6e65 2065 7861 6d70 6c65 2069 ). One example i │ │ │ │ │ -0001f680: 730a 2728 6864 302c 3129 2f62 6f6f 742f s.'(hd0,1)/boot/ │ │ │ │ │ -0001f690: 6772 7562 2f67 7275 622e 6366 6727 2e20 grub/grub.cfg'. │ │ │ │ │ -0001f6a0: 2054 6869 7320 6d65 616e 7320 7468 6520 This means the │ │ │ │ │ -0001f6b0: 6669 6c65 2027 2f62 6f6f 742f 6772 7562 file '/boot/grub │ │ │ │ │ -0001f6c0: 2f67 7275 622e 6366 6727 0a69 6e20 7468 /grub.cfg'.in th │ │ │ │ │ -0001f6d0: 6520 6669 7273 7420 7061 7274 6974 696f e first partitio │ │ │ │ │ -0001f6e0: 6e20 6f66 2074 6865 2066 6972 7374 2068 n of the first h │ │ │ │ │ -0001f6f0: 6172 6420 6469 736b 2e20 2049 6620 796f ard disk. If yo │ │ │ │ │ -0001f700: 7520 6f6d 6974 2074 6865 2064 6576 6963 u omit the devic │ │ │ │ │ -0001f710: 650a 6e61 6d65 2069 6e20 616e 2061 6273 e.name in an abs │ │ │ │ │ -0001f720: 6f6c 7574 6520 6669 6c65 206e 616d 652c olute file name, │ │ │ │ │ -0001f730: 2047 5255 4220 7573 6573 2047 5255 4227 GRUB uses GRUB' │ │ │ │ │ -0001f740: 7320 2272 6f6f 7420 6465 7669 6365 220a s "root device". │ │ │ │ │ -0001f750: 696d 706c 6963 6974 6c79 2e20 2053 6f20 implicitly. So │ │ │ │ │ -0001f760: 6966 2079 6f75 2073 6574 2074 6865 2072 if you set the r │ │ │ │ │ -0001f770: 6f6f 7420 6465 7669 6365 2074 6f2c 2073 oot device to, s │ │ │ │ │ -0001f780: 6179 2c20 2728 6864 312c 3129 2720 6279 ay, '(hd1,1)' by │ │ │ │ │ -0001f790: 2074 6865 0a63 6f6d 6d61 6e64 2027 7365 the.command 'se │ │ │ │ │ -0001f7a0: 7420 726f 6f74 3d28 6864 312c 3129 2720 t root=(hd1,1)' │ │ │ │ │ -0001f7b0: 282a 6e6f 7465 2073 6574 3a3a 292c 2074 (*note set::), t │ │ │ │ │ -0001f7c0: 6865 6e20 272f 626f 6f74 2f6b 6572 6e65 hen '/boot/kerne │ │ │ │ │ -0001f7d0: 6c27 2069 7320 7468 650a 7361 6d65 2061 l' is the.same a │ │ │ │ │ -0001f7e0: 7320 2728 6864 312c 3129 2f62 6f6f 742f s '(hd1,1)/boot/ │ │ │ │ │ -0001f7f0: 6b65 726e 656c 272e 0a0a 2020 204f 6e20 kernel'... On │ │ │ │ │ -0001f800: 5a46 5320 6669 6c65 7379 7374 656d 2074 ZFS filesystem t │ │ │ │ │ -0001f810: 6865 2066 6972 7374 2070 6174 6820 636f he first path co │ │ │ │ │ -0001f820: 6d70 6f6e 656e 7420 6d75 7374 2062 650a mponent must be. │ │ │ │ │ -0001f830: 564f 4c55 4d45 2740 275b 534e 4150 5348 VOLUME'@'[SNAPSH │ │ │ │ │ -0001f840: 4f54 5d2e 2020 536f 2027 2f72 6f6f 7476 OT]. So '/rootv │ │ │ │ │ -0001f850: 6f6c 4073 6e61 702d 3132 392f 626f 6f74 ol@snap-129/boot │ │ │ │ │ -0001f860: 2f67 7275 622f 6772 7562 2e63 6667 2720 /grub/grub.cfg' │ │ │ │ │ -0001f870: 7265 6665 7273 0a74 6f20 6669 6c65 2027 refers.to file ' │ │ │ │ │ -0001f880: 2f62 6f6f 742f 6772 7562 2f67 7275 622e /boot/grub/grub. │ │ │ │ │ -0001f890: 6366 6727 2069 6e20 736e 6170 7368 6f74 cfg' in snapshot │ │ │ │ │ -0001f8a0: 206f 6620 766f 6c75 6d65 2027 726f 6f74 of volume 'root │ │ │ │ │ -0001f8b0: 766f 6c27 2077 6974 6820 6e61 6d65 0a27 vol' with name.' │ │ │ │ │ -0001f8c0: 736e 6170 2d31 3239 272e 2020 5472 6169 snap-129'. Trai │ │ │ │ │ -0001f8d0: 6c69 6e67 2027 4027 2061 6674 6572 2076 ling '@' after v │ │ │ │ │ -0001f8e0: 6f6c 756d 6520 6e61 6d65 2069 7320 6d61 olume name is ma │ │ │ │ │ -0001f8f0: 6e64 6174 6f72 7920 6576 656e 2069 660a ndatory even if. │ │ │ │ │ -0001f900: 736e 6170 7368 6f74 206e 616d 6520 6973 snapshot name is │ │ │ │ │ -0001f910: 206f 6d69 7474 6564 2e0a 0a1f 0a46 696c omitted.....Fil │ │ │ │ │ -0001f920: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ -0001f930: 6f64 653a 2042 6c6f 636b 206c 6973 7420 ode: Block list │ │ │ │ │ -0001f940: 7379 6e74 6178 2c20 2050 7265 763a 2046 syntax, Prev: F │ │ │ │ │ -0001f950: 696c 6520 6e61 6d65 2073 796e 7461 782c ile name syntax, │ │ │ │ │ -0001f960: 2020 5570 3a20 4669 6c65 7379 7374 656d Up: Filesystem │ │ │ │ │ -0001f970: 0a0a 3133 2e33 2048 6f77 2074 6f20 7370 ..13.3 How to sp │ │ │ │ │ -0001f980: 6563 6966 7920 626c 6f63 6b20 6c69 7374 ecify block list │ │ │ │ │ -0001f990: 730a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d s.============== │ │ │ │ │ -0001f9a0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0001f9b0: 3d0a 0a41 2062 6c6f 636b 206c 6973 7420 =..A block list │ │ │ │ │ -0001f9c0: 6973 2075 7365 6420 666f 7220 7370 6563 is used for spec │ │ │ │ │ -0001f9d0: 6966 7969 6e67 2061 2066 696c 6520 7468 ifying a file th │ │ │ │ │ -0001f9e0: 6174 2064 6f65 736e 2774 2061 7070 6561 at doesn't appea │ │ │ │ │ -0001f9f0: 7220 696e 2074 6865 0a66 696c 6573 7973 r in the.filesys │ │ │ │ │ -0001fa00: 7465 6d2c 206c 696b 6520 6120 6368 6169 tem, like a chai │ │ │ │ │ -0001fa10: 6e6c 6f61 6465 722e 2020 5468 6520 7379 nloader. The sy │ │ │ │ │ -0001fa20: 6e74 6178 2069 730a 275b 4f46 4653 4554 ntax is.'[OFFSET │ │ │ │ │ -0001fa30: 5d2b 4c45 4e47 5448 5b2c 5b4f 4646 5345 ]+LENGTH[,[OFFSE │ │ │ │ │ -0001fa40: 545d 2b4c 454e 4754 485d 2e2e 2e27 2e20 T]+LENGTH]...'. │ │ │ │ │ -0001fa50: 2048 6572 6520 6973 2061 6e20 6578 616d Here is an exam │ │ │ │ │ -0001fa60: 706c 653a 0a0a 2020 2020 2030 2b31 3030 ple:.. 0+100 │ │ │ │ │ -0001fa70: 2c32 3030 2b31 2c33 3030 2b33 3030 0a0a ,200+1,300+300.. │ │ │ │ │ -0001fa80: 2020 2054 6869 7320 7265 7072 6573 656e This represen │ │ │ │ │ -0001fa90: 7473 2074 6861 7420 4752 5542 2073 686f ts that GRUB sho │ │ │ │ │ -0001faa0: 756c 6420 7265 6164 2062 6c6f 636b 7320 uld read blocks │ │ │ │ │ -0001fab0: 3020 7468 726f 7567 6820 3939 2c20 626c 0 through 99, bl │ │ │ │ │ -0001fac0: 6f63 6b20 3230 302c 0a61 6e64 2062 6c6f ock 200,.and blo │ │ │ │ │ -0001fad0: 636b 7320 3330 3020 7468 726f 7567 6820 cks 300 through │ │ │ │ │ -0001fae0: 3539 392e 2020 4966 2079 6f75 206f 6d69 599. If you omi │ │ │ │ │ -0001faf0: 7420 616e 206f 6666 7365 742c 2074 6865 t an offset, the │ │ │ │ │ -0001fb00: 6e20 4752 5542 2061 7373 756d 6573 0a74 n GRUB assumes.t │ │ │ │ │ -0001fb10: 6865 206f 6666 7365 7420 6973 207a 6572 he offset is zer │ │ │ │ │ -0001fb20: 6f2e 0a0a 2020 204c 696b 6520 7468 6520 o... Like the │ │ │ │ │ -0001fb30: 6669 6c65 206e 616d 6520 7379 6e74 6178 file name syntax │ │ │ │ │ -0001fb40: 2028 2a6e 6f74 6520 4669 6c65 206e 616d (*note File nam │ │ │ │ │ -0001fb50: 6520 7379 6e74 6178 3a3a 292c 2069 6620 e syntax::), if │ │ │ │ │ -0001fb60: 6120 626c 6f63 6b6c 6973 740a 646f 6573 a blocklist.does │ │ │ │ │ -0001fb70: 206e 6f74 2063 6f6e 7461 696e 2061 2064 not contain a d │ │ │ │ │ -0001fb80: 6576 6963 6520 6e61 6d65 2c20 7468 656e evice name, then │ │ │ │ │ -0001fb90: 2047 5255 4220 7573 6573 2047 5255 4227 GRUB uses GRUB' │ │ │ │ │ -0001fba0: 7320 2272 6f6f 7420 6465 7669 6365 222e s "root device". │ │ │ │ │ -0001fbb0: 2020 536f 0a27 2868 6430 2c32 292b 3127 So.'(hd0,2)+1' │ │ │ │ │ -0001fbc0: 2069 7320 7468 6520 7361 6d65 2061 7320 is the same as │ │ │ │ │ -0001fbd0: 272b 3127 2077 6865 6e20 7468 6520 726f '+1' when the ro │ │ │ │ │ -0001fbe0: 6f74 2064 6576 6963 6520 6973 2027 2868 ot device is '(h │ │ │ │ │ -0001fbf0: 6430 2c32 2927 2e0a 0a1f 0a46 696c 653a d0,2)'.....File: │ │ │ │ │ -0001fc00: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ -0001fc10: 653a 2049 6e74 6572 6661 6365 2c20 204e e: Interface, N │ │ │ │ │ -0001fc20: 6578 743a 2045 6e76 6972 6f6e 6d65 6e74 ext: Environment │ │ │ │ │ -0001fc30: 2c20 2050 7265 763a 2046 696c 6573 7973 , Prev: Filesys │ │ │ │ │ -0001fc40: 7465 6d2c 2020 5570 3a20 546f 700a 0a31 tem, Up: Top..1 │ │ │ │ │ -0001fc50: 3420 4752 5542 2773 2075 7365 7220 696e 4 GRUB's user in │ │ │ │ │ -0001fc60: 7465 7266 6163 650a 2a2a 2a2a 2a2a 2a2a terface.******** │ │ │ │ │ -0001fc70: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -0001fc80: 0a0a 4752 5542 2068 6173 2062 6f74 6820 ..GRUB has both │ │ │ │ │ -0001fc90: 6120 7369 6d70 6c65 206d 656e 7520 696e a simple menu in │ │ │ │ │ -0001fca0: 7465 7266 6163 6520 666f 7220 6368 6f6f terface for choo │ │ │ │ │ -0001fcb0: 7369 6e67 2070 7265 7365 7420 656e 7472 sing preset entr │ │ │ │ │ -0001fcc0: 6965 7320 6672 6f6d 2061 0a63 6f6e 6669 ies from a.confi │ │ │ │ │ -0001fcd0: 6775 7261 7469 6f6e 2066 696c 652c 2061 guration file, a │ │ │ │ │ -0001fce0: 6e64 2061 2068 6967 686c 7920 666c 6578 nd a highly flex │ │ │ │ │ -0001fcf0: 6962 6c65 2063 6f6d 6d61 6e64 2d6c 696e ible command-lin │ │ │ │ │ -0001fd00: 6520 666f 7220 7065 7266 6f72 6d69 6e67 e for performing │ │ │ │ │ -0001fd10: 0a61 6e79 2064 6573 6972 6564 2063 6f6d .any desired com │ │ │ │ │ -0001fd20: 6269 6e61 7469 6f6e 206f 6620 626f 6f74 bination of boot │ │ │ │ │ -0001fd30: 2063 6f6d 6d61 6e64 732e 0a0a 2020 2047 commands... G │ │ │ │ │ -0001fd40: 5255 4220 6c6f 6f6b 7320 666f 7220 6974 RUB looks for it │ │ │ │ │ -0001fd50: 7320 636f 6e66 6967 7572 6174 696f 6e20 s configuration │ │ │ │ │ -0001fd60: 6669 6c65 2061 7320 736f 6f6e 2061 7320 file as soon as │ │ │ │ │ -0001fd70: 6974 2069 7320 6c6f 6164 6564 2e20 2049 it is loaded. I │ │ │ │ │ -0001fd80: 660a 6f6e 6520 6973 2066 6f75 6e64 2c20 f.one is found, │ │ │ │ │ -0001fd90: 7468 656e 2074 6865 2066 756c 6c20 6d65 then the full me │ │ │ │ │ -0001fda0: 6e75 2069 6e74 6572 6661 6365 2069 7320 nu interface is │ │ │ │ │ -0001fdb0: 6163 7469 7661 7465 6420 7573 696e 6720 activated using │ │ │ │ │ -0001fdc0: 7768 6174 6576 6572 0a65 6e74 7269 6573 whatever.entries │ │ │ │ │ -0001fdd0: 2077 6572 6520 666f 756e 6420 696e 2074 were found in t │ │ │ │ │ -0001fde0: 6865 2066 696c 652e 2020 4966 2079 6f75 he file. If you │ │ │ │ │ -0001fdf0: 2063 686f 6f73 6520 7468 6520 2263 6f6d choose the "com │ │ │ │ │ -0001fe00: 6d61 6e64 2d6c 696e 6522 206d 656e 750a mand-line" menu. │ │ │ │ │ -0001fe10: 6f70 7469 6f6e 2c20 6f72 2069 6620 7468 option, or if th │ │ │ │ │ -0001fe20: 6520 636f 6e66 6967 7572 6174 696f 6e20 e configuration │ │ │ │ │ -0001fe30: 6669 6c65 2077 6173 206e 6f74 2066 6f75 file was not fou │ │ │ │ │ -0001fe40: 6e64 2c20 7468 656e 2047 5255 4220 6472 nd, then GRUB dr │ │ │ │ │ -0001fe50: 6f70 7320 746f 0a74 6865 2063 6f6d 6d61 ops to.the comma │ │ │ │ │ -0001fe60: 6e64 2d6c 696e 6520 696e 7465 7266 6163 nd-line interfac │ │ │ │ │ -0001fe70: 652e 0a0a 2a20 4d65 6e75 3a0a 0a2a 2043 e...* Menu:..* C │ │ │ │ │ -0001fe80: 6f6d 6d61 6e64 2d6c 696e 6520 696e 7465 ommand-line inte │ │ │ │ │ -0001fe90: 7266 6163 653a 3a20 2020 2020 2054 6865 rface:: The │ │ │ │ │ -0001fea0: 2066 6c65 7869 626c 6520 636f 6d6d 616e flexible comman │ │ │ │ │ -0001feb0: 642d 6c69 6e65 2069 6e74 6572 6661 6365 d-line interface │ │ │ │ │ -0001fec0: 0a2a 204d 656e 7520 696e 7465 7266 6163 .* Menu interfac │ │ │ │ │ -0001fed0: 653a 3a20 2020 2020 2020 2020 2020 2020 e:: │ │ │ │ │ -0001fee0: 2054 6865 2073 696d 706c 6520 6d65 6e75 The simple menu │ │ │ │ │ -0001fef0: 2069 6e74 6572 6661 6365 0a2a 204d 656e interface.* Men │ │ │ │ │ -0001ff00: 7520 656e 7472 7920 6564 6974 6f72 3a3a u entry editor:: │ │ │ │ │ -0001ff10: 2020 2020 2020 2020 2020 2045 6469 7469 Editi │ │ │ │ │ -0001ff20: 6e67 2061 206d 656e 7520 656e 7472 790a ng a menu entry. │ │ │ │ │ -0001ff30: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ -0001ff40: 666f 2c20 204e 6f64 653a 2043 6f6d 6d61 fo, Node: Comma │ │ │ │ │ -0001ff50: 6e64 2d6c 696e 6520 696e 7465 7266 6163 nd-line interfac │ │ │ │ │ -0001ff60: 652c 2020 4e65 7874 3a20 4d65 6e75 2069 e, Next: Menu i │ │ │ │ │ -0001ff70: 6e74 6572 6661 6365 2c20 2055 703a 2049 nterface, Up: I │ │ │ │ │ -0001ff80: 6e74 6572 6661 6365 0a0a 3134 2e31 2054 nterface..14.1 T │ │ │ │ │ -0001ff90: 6865 2066 6c65 7869 626c 6520 636f 6d6d he flexible comm │ │ │ │ │ -0001ffa0: 616e 642d 6c69 6e65 2069 6e74 6572 6661 and-line interfa │ │ │ │ │ -0001ffb0: 6365 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ce.============= │ │ │ │ │ +0001f5a0: 3d3d 3d0a 0a54 6865 7265 2061 7265 2074 ===..There are t │ │ │ │ │ +0001f5b0: 776f 2077 6179 7320 746f 2073 7065 6369 wo ways to speci │ │ │ │ │ +0001f5c0: 6679 2066 696c 6573 2c20 6279 2022 6162 fy files, by "ab │ │ │ │ │ +0001f5d0: 736f 6c75 7465 2066 696c 6520 6e61 6d65 solute file name │ │ │ │ │ +0001f5e0: 2220 616e 6420 6279 0a22 626c 6f63 6b20 " and by."block │ │ │ │ │ +0001f5f0: 6c69 7374 222e 0a0a 2020 2041 6e20 6162 list"... An ab │ │ │ │ │ +0001f600: 736f 6c75 7465 2066 696c 6520 6e61 6d65 solute file name │ │ │ │ │ +0001f610: 2072 6573 656d 626c 6573 2061 2055 6e69 resembles a Uni │ │ │ │ │ +0001f620: 7820 6162 736f 6c75 7465 2066 696c 6520 x absolute file │ │ │ │ │ +0001f630: 6e61 6d65 2c20 7573 696e 6720 272f 270a name, using '/'. │ │ │ │ │ +0001f640: 666f 7220 7468 6520 6469 7265 6374 6f72 for the director │ │ │ │ │ +0001f650: 7920 7365 7061 7261 746f 7220 286e 6f74 y separator (not │ │ │ │ │ +0001f660: 2027 5c27 2061 7320 696e 2044 4f53 292e '\' as in DOS). │ │ │ │ │ +0001f670: 204f 6e65 2065 7861 6d70 6c65 2069 730a One example is. │ │ │ │ │ +0001f680: 2728 6864 302c 3129 2f62 6f6f 742f 6772 '(hd0,1)/boot/gr │ │ │ │ │ +0001f690: 7562 2f67 7275 622e 6366 6727 2e20 2054 ub/grub.cfg'. T │ │ │ │ │ +0001f6a0: 6869 7320 6d65 616e 7320 7468 6520 6669 his means the fi │ │ │ │ │ +0001f6b0: 6c65 2027 2f62 6f6f 742f 6772 7562 2f67 le '/boot/grub/g │ │ │ │ │ +0001f6c0: 7275 622e 6366 6727 0a69 6e20 7468 6520 rub.cfg'.in the │ │ │ │ │ +0001f6d0: 6669 7273 7420 7061 7274 6974 696f 6e20 first partition │ │ │ │ │ +0001f6e0: 6f66 2074 6865 2066 6972 7374 2068 6172 of the first har │ │ │ │ │ +0001f6f0: 6420 6469 736b 2e20 2049 6620 796f 7520 d disk. If you │ │ │ │ │ +0001f700: 6f6d 6974 2074 6865 2064 6576 6963 650a omit the device. │ │ │ │ │ +0001f710: 6e61 6d65 2069 6e20 616e 2061 6273 6f6c name in an absol │ │ │ │ │ +0001f720: 7574 6520 6669 6c65 206e 616d 652c 2047 ute file name, G │ │ │ │ │ +0001f730: 5255 4220 7573 6573 2047 5255 4227 7320 RUB uses GRUB's │ │ │ │ │ +0001f740: 2272 6f6f 7420 6465 7669 6365 220a 696d "root device".im │ │ │ │ │ +0001f750: 706c 6963 6974 6c79 2e20 2053 6f20 6966 plicitly. So if │ │ │ │ │ +0001f760: 2079 6f75 2073 6574 2074 6865 2072 6f6f you set the roo │ │ │ │ │ +0001f770: 7420 6465 7669 6365 2074 6f2c 2073 6179 t device to, say │ │ │ │ │ +0001f780: 2c20 2728 6864 312c 3129 2720 6279 2074 , '(hd1,1)' by t │ │ │ │ │ +0001f790: 6865 0a63 6f6d 6d61 6e64 2027 7365 7420 he.command 'set │ │ │ │ │ +0001f7a0: 726f 6f74 3d28 6864 312c 3129 2720 282a root=(hd1,1)' (* │ │ │ │ │ +0001f7b0: 6e6f 7465 2073 6574 3a3a 292c 2074 6865 note set::), the │ │ │ │ │ +0001f7c0: 6e20 272f 626f 6f74 2f6b 6572 6e65 6c27 n '/boot/kernel' │ │ │ │ │ +0001f7d0: 2069 7320 7468 650a 7361 6d65 2061 7320 is the.same as │ │ │ │ │ +0001f7e0: 2728 6864 312c 3129 2f62 6f6f 742f 6b65 '(hd1,1)/boot/ke │ │ │ │ │ +0001f7f0: 726e 656c 272e 0a0a 2020 204f 6e20 5a46 rnel'... On ZF │ │ │ │ │ +0001f800: 5320 6669 6c65 7379 7374 656d 2074 6865 S filesystem the │ │ │ │ │ +0001f810: 2066 6972 7374 2070 6174 6820 636f 6d70 first path comp │ │ │ │ │ +0001f820: 6f6e 656e 7420 6d75 7374 2062 650a 564f onent must be.VO │ │ │ │ │ +0001f830: 4c55 4d45 2740 275b 534e 4150 5348 4f54 LUME'@'[SNAPSHOT │ │ │ │ │ +0001f840: 5d2e 2020 536f 2027 2f72 6f6f 7476 6f6c ]. So '/rootvol │ │ │ │ │ +0001f850: 4073 6e61 702d 3132 392f 626f 6f74 2f67 @snap-129/boot/g │ │ │ │ │ +0001f860: 7275 622f 6772 7562 2e63 6667 2720 7265 rub/grub.cfg' re │ │ │ │ │ +0001f870: 6665 7273 0a74 6f20 6669 6c65 2027 2f62 fers.to file '/b │ │ │ │ │ +0001f880: 6f6f 742f 6772 7562 2f67 7275 622e 6366 oot/grub/grub.cf │ │ │ │ │ +0001f890: 6727 2069 6e20 736e 6170 7368 6f74 206f g' in snapshot o │ │ │ │ │ +0001f8a0: 6620 766f 6c75 6d65 2027 726f 6f74 766f f volume 'rootvo │ │ │ │ │ +0001f8b0: 6c27 2077 6974 6820 6e61 6d65 0a27 736e l' with name.'sn │ │ │ │ │ +0001f8c0: 6170 2d31 3239 272e 2020 5472 6169 6c69 ap-129'. Traili │ │ │ │ │ +0001f8d0: 6e67 2027 4027 2061 6674 6572 2076 6f6c ng '@' after vol │ │ │ │ │ +0001f8e0: 756d 6520 6e61 6d65 2069 7320 6d61 6e64 ume name is mand │ │ │ │ │ +0001f8f0: 6174 6f72 7920 6576 656e 2069 660a 736e atory even if.sn │ │ │ │ │ +0001f900: 6170 7368 6f74 206e 616d 6520 6973 206f apshot name is o │ │ │ │ │ +0001f910: 6d69 7474 6564 2e0a 0a1f 0a46 696c 653a mitted.....File: │ │ │ │ │ +0001f920: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ +0001f930: 653a 2042 6c6f 636b 206c 6973 7420 7379 e: Block list sy │ │ │ │ │ +0001f940: 6e74 6178 2c20 2050 7265 763a 2046 696c ntax, Prev: Fil │ │ │ │ │ +0001f950: 6520 6e61 6d65 2073 796e 7461 782c 2020 e name syntax, │ │ │ │ │ +0001f960: 5570 3a20 4669 6c65 7379 7374 656d 0a0a Up: Filesystem.. │ │ │ │ │ +0001f970: 3133 2e33 2048 6f77 2074 6f20 7370 6563 13.3 How to spec │ │ │ │ │ +0001f980: 6966 7920 626c 6f63 6b20 6c69 7374 730a ify block lists. │ │ │ │ │ +0001f990: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ +0001f9a0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a ===============. │ │ │ │ │ +0001f9b0: 0a41 2062 6c6f 636b 206c 6973 7420 6973 .A block list is │ │ │ │ │ +0001f9c0: 2075 7365 6420 666f 7220 7370 6563 6966 used for specif │ │ │ │ │ +0001f9d0: 7969 6e67 2061 2066 696c 6520 7468 6174 ying a file that │ │ │ │ │ +0001f9e0: 2064 6f65 736e 2774 2061 7070 6561 7220 doesn't appear │ │ │ │ │ +0001f9f0: 696e 2074 6865 0a66 696c 6573 7973 7465 in the.filesyste │ │ │ │ │ +0001fa00: 6d2c 206c 696b 6520 6120 6368 6169 6e6c m, like a chainl │ │ │ │ │ +0001fa10: 6f61 6465 722e 2020 5468 6520 7379 6e74 oader. The synt │ │ │ │ │ +0001fa20: 6178 2069 730a 275b 4f46 4653 4554 5d2b ax is.'[OFFSET]+ │ │ │ │ │ +0001fa30: 4c45 4e47 5448 5b2c 5b4f 4646 5345 545d LENGTH[,[OFFSET] │ │ │ │ │ +0001fa40: 2b4c 454e 4754 485d 2e2e 2e27 2e20 2048 +LENGTH]...'. H │ │ │ │ │ +0001fa50: 6572 6520 6973 2061 6e20 6578 616d 706c ere is an exampl │ │ │ │ │ +0001fa60: 653a 0a0a 2020 2020 2030 2b31 3030 2c32 e:.. 0+100,2 │ │ │ │ │ +0001fa70: 3030 2b31 2c33 3030 2b33 3030 0a0a 2020 00+1,300+300.. │ │ │ │ │ +0001fa80: 2054 6869 7320 7265 7072 6573 656e 7473 This represents │ │ │ │ │ +0001fa90: 2074 6861 7420 4752 5542 2073 686f 756c that GRUB shoul │ │ │ │ │ +0001faa0: 6420 7265 6164 2062 6c6f 636b 7320 3020 d read blocks 0 │ │ │ │ │ +0001fab0: 7468 726f 7567 6820 3939 2c20 626c 6f63 through 99, bloc │ │ │ │ │ +0001fac0: 6b20 3230 302c 0a61 6e64 2062 6c6f 636b k 200,.and block │ │ │ │ │ +0001fad0: 7320 3330 3020 7468 726f 7567 6820 3539 s 300 through 59 │ │ │ │ │ +0001fae0: 392e 2020 4966 2079 6f75 206f 6d69 7420 9. If you omit │ │ │ │ │ +0001faf0: 616e 206f 6666 7365 742c 2074 6865 6e20 an offset, then │ │ │ │ │ +0001fb00: 4752 5542 2061 7373 756d 6573 0a74 6865 GRUB assumes.the │ │ │ │ │ +0001fb10: 206f 6666 7365 7420 6973 207a 6572 6f2e offset is zero. │ │ │ │ │ +0001fb20: 0a0a 2020 204c 696b 6520 7468 6520 6669 .. Like the fi │ │ │ │ │ +0001fb30: 6c65 206e 616d 6520 7379 6e74 6178 2028 le name syntax ( │ │ │ │ │ +0001fb40: 2a6e 6f74 6520 4669 6c65 206e 616d 6520 *note File name │ │ │ │ │ +0001fb50: 7379 6e74 6178 3a3a 292c 2069 6620 6120 syntax::), if a │ │ │ │ │ +0001fb60: 626c 6f63 6b6c 6973 740a 646f 6573 206e blocklist.does n │ │ │ │ │ +0001fb70: 6f74 2063 6f6e 7461 696e 2061 2064 6576 ot contain a dev │ │ │ │ │ +0001fb80: 6963 6520 6e61 6d65 2c20 7468 656e 2047 ice name, then G │ │ │ │ │ +0001fb90: 5255 4220 7573 6573 2047 5255 4227 7320 RUB uses GRUB's │ │ │ │ │ +0001fba0: 2272 6f6f 7420 6465 7669 6365 222e 2020 "root device". │ │ │ │ │ +0001fbb0: 536f 0a27 2868 6430 2c32 292b 3127 2069 So.'(hd0,2)+1' i │ │ │ │ │ +0001fbc0: 7320 7468 6520 7361 6d65 2061 7320 272b s the same as '+ │ │ │ │ │ +0001fbd0: 3127 2077 6865 6e20 7468 6520 726f 6f74 1' when the root │ │ │ │ │ +0001fbe0: 2064 6576 6963 6520 6973 2027 2868 6430 device is '(hd0 │ │ │ │ │ +0001fbf0: 2c32 2927 2e0a 0a1f 0a46 696c 653a 2067 ,2)'.....File: g │ │ │ │ │ +0001fc00: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ +0001fc10: 2049 6e74 6572 6661 6365 2c20 204e 6578 Interface, Nex │ │ │ │ │ +0001fc20: 743a 2045 6e76 6972 6f6e 6d65 6e74 2c20 t: Environment, │ │ │ │ │ +0001fc30: 2050 7265 763a 2046 696c 6573 7973 7465 Prev: Filesyste │ │ │ │ │ +0001fc40: 6d2c 2020 5570 3a20 546f 700a 0a31 3420 m, Up: Top..14 │ │ │ │ │ +0001fc50: 4752 5542 2773 2075 7365 7220 696e 7465 GRUB's user inte │ │ │ │ │ +0001fc60: 7266 6163 650a 2a2a 2a2a 2a2a 2a2a 2a2a rface.********** │ │ │ │ │ +0001fc70: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a **************.. │ │ │ │ │ +0001fc80: 4752 5542 2068 6173 2062 6f74 6820 6120 GRUB has both a │ │ │ │ │ +0001fc90: 7369 6d70 6c65 206d 656e 7520 696e 7465 simple menu inte │ │ │ │ │ +0001fca0: 7266 6163 6520 666f 7220 6368 6f6f 7369 rface for choosi │ │ │ │ │ +0001fcb0: 6e67 2070 7265 7365 7420 656e 7472 6965 ng preset entrie │ │ │ │ │ +0001fcc0: 7320 6672 6f6d 2061 0a63 6f6e 6669 6775 s from a.configu │ │ │ │ │ +0001fcd0: 7261 7469 6f6e 2066 696c 652c 2061 6e64 ration file, and │ │ │ │ │ +0001fce0: 2061 2068 6967 686c 7920 666c 6578 6962 a highly flexib │ │ │ │ │ +0001fcf0: 6c65 2063 6f6d 6d61 6e64 2d6c 696e 6520 le command-line │ │ │ │ │ +0001fd00: 666f 7220 7065 7266 6f72 6d69 6e67 0a61 for performing.a │ │ │ │ │ +0001fd10: 6e79 2064 6573 6972 6564 2063 6f6d 6269 ny desired combi │ │ │ │ │ +0001fd20: 6e61 7469 6f6e 206f 6620 626f 6f74 2063 nation of boot c │ │ │ │ │ +0001fd30: 6f6d 6d61 6e64 732e 0a0a 2020 2047 5255 ommands... GRU │ │ │ │ │ +0001fd40: 4220 6c6f 6f6b 7320 666f 7220 6974 7320 B looks for its │ │ │ │ │ +0001fd50: 636f 6e66 6967 7572 6174 696f 6e20 6669 configuration fi │ │ │ │ │ +0001fd60: 6c65 2061 7320 736f 6f6e 2061 7320 6974 le as soon as it │ │ │ │ │ +0001fd70: 2069 7320 6c6f 6164 6564 2e20 2049 660a is loaded. If. │ │ │ │ │ +0001fd80: 6f6e 6520 6973 2066 6f75 6e64 2c20 7468 one is found, th │ │ │ │ │ +0001fd90: 656e 2074 6865 2066 756c 6c20 6d65 6e75 en the full menu │ │ │ │ │ +0001fda0: 2069 6e74 6572 6661 6365 2069 7320 6163 interface is ac │ │ │ │ │ +0001fdb0: 7469 7661 7465 6420 7573 696e 6720 7768 tivated using wh │ │ │ │ │ +0001fdc0: 6174 6576 6572 0a65 6e74 7269 6573 2077 atever.entries w │ │ │ │ │ +0001fdd0: 6572 6520 666f 756e 6420 696e 2074 6865 ere found in the │ │ │ │ │ +0001fde0: 2066 696c 652e 2020 4966 2079 6f75 2063 file. If you c │ │ │ │ │ +0001fdf0: 686f 6f73 6520 7468 6520 2263 6f6d 6d61 hoose the "comma │ │ │ │ │ +0001fe00: 6e64 2d6c 696e 6522 206d 656e 750a 6f70 nd-line" menu.op │ │ │ │ │ +0001fe10: 7469 6f6e 2c20 6f72 2069 6620 7468 6520 tion, or if the │ │ │ │ │ +0001fe20: 636f 6e66 6967 7572 6174 696f 6e20 6669 configuration fi │ │ │ │ │ +0001fe30: 6c65 2077 6173 206e 6f74 2066 6f75 6e64 le was not found │ │ │ │ │ +0001fe40: 2c20 7468 656e 2047 5255 4220 6472 6f70 , then GRUB drop │ │ │ │ │ +0001fe50: 7320 746f 0a74 6865 2063 6f6d 6d61 6e64 s to.the command │ │ │ │ │ +0001fe60: 2d6c 696e 6520 696e 7465 7266 6163 652e -line interface. │ │ │ │ │ +0001fe70: 0a0a 2a20 4d65 6e75 3a0a 0a2a 2043 6f6d ..* Menu:..* Com │ │ │ │ │ +0001fe80: 6d61 6e64 2d6c 696e 6520 696e 7465 7266 mand-line interf │ │ │ │ │ +0001fe90: 6163 653a 3a20 2020 2020 2054 6865 2066 ace:: The f │ │ │ │ │ +0001fea0: 6c65 7869 626c 6520 636f 6d6d 616e 642d lexible command- │ │ │ │ │ +0001feb0: 6c69 6e65 2069 6e74 6572 6661 6365 0a2a line interface.* │ │ │ │ │ +0001fec0: 204d 656e 7520 696e 7465 7266 6163 653a Menu interface: │ │ │ │ │ +0001fed0: 3a20 2020 2020 2020 2020 2020 2020 2054 : T │ │ │ │ │ +0001fee0: 6865 2073 696d 706c 6520 6d65 6e75 2069 he simple menu i │ │ │ │ │ +0001fef0: 6e74 6572 6661 6365 0a2a 204d 656e 7520 nterface.* Menu │ │ │ │ │ +0001ff00: 656e 7472 7920 6564 6974 6f72 3a3a 2020 entry editor:: │ │ │ │ │ +0001ff10: 2020 2020 2020 2020 2045 6469 7469 6e67 Editing │ │ │ │ │ +0001ff20: 2061 206d 656e 7520 656e 7472 790a 0a1f a menu entry... │ │ │ │ │ +0001ff30: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ +0001ff40: 2c20 204e 6f64 653a 2043 6f6d 6d61 6e64 , Node: Command │ │ │ │ │ +0001ff50: 2d6c 696e 6520 696e 7465 7266 6163 652c -line interface, │ │ │ │ │ +0001ff60: 2020 4e65 7874 3a20 4d65 6e75 2069 6e74 Next: Menu int │ │ │ │ │ +0001ff70: 6572 6661 6365 2c20 2055 703a 2049 6e74 erface, Up: Int │ │ │ │ │ +0001ff80: 6572 6661 6365 0a0a 3134 2e31 2054 6865 erface..14.1 The │ │ │ │ │ +0001ff90: 2066 6c65 7869 626c 6520 636f 6d6d 616e flexible comman │ │ │ │ │ +0001ffa0: 642d 6c69 6e65 2069 6e74 6572 6661 6365 d-line interface │ │ │ │ │ +0001ffb0: 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d .=============== │ │ │ │ │ 0001ffc0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0001ffd0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a54 6865 ===========..The │ │ │ │ │ -0001ffe0: 2063 6f6d 6d61 6e64 2d6c 696e 6520 696e command-line in │ │ │ │ │ -0001fff0: 7465 7266 6163 6520 7072 6f76 6964 6573 terface provides │ │ │ │ │ -00020000: 2061 2070 726f 6d70 7420 616e 6420 6166 a prompt and af │ │ │ │ │ -00020010: 7465 7220 6974 2061 6e20 6564 6974 6162 ter it an editab │ │ │ │ │ -00020020: 6c65 0a74 6578 7420 6172 6561 206d 7563 le.text area muc │ │ │ │ │ -00020030: 6820 6c69 6b65 2061 2063 6f6d 6d61 6e64 h like a command │ │ │ │ │ -00020040: 2d6c 696e 6520 696e 2055 6e69 7820 6f72 -line in Unix or │ │ │ │ │ -00020050: 2044 4f53 2e20 4561 6368 2063 6f6d 6d61 DOS. Each comma │ │ │ │ │ -00020060: 6e64 2069 730a 696d 6d65 6469 6174 656c nd is.immediatel │ │ │ │ │ -00020070: 7920 6578 6563 7574 6564 2061 6674 6572 y executed after │ │ │ │ │ -00020080: 2069 7420 6973 2065 6e74 6572 6564 2831 it is entered(1 │ │ │ │ │ -00020090: 2920 282a 6e6f 7465 2043 6f6d 6d61 6e64 ) (*note Command │ │ │ │ │ -000200a0: 2d6c 696e 650a 696e 7465 7266 6163 652d -line.interface- │ │ │ │ │ -000200b0: 466f 6f74 6e6f 7465 2d31 3a3a 292e 2020 Footnote-1::). │ │ │ │ │ -000200c0: 5468 6520 636f 6d6d 616e 6473 2028 2a6e The commands (*n │ │ │ │ │ -000200d0: 6f74 6520 436f 6d6d 616e 642d 6c69 6e65 ote Command-line │ │ │ │ │ -000200e0: 2061 6e64 206d 656e 750a 656e 7472 7920 and menu.entry │ │ │ │ │ -000200f0: 636f 6d6d 616e 6473 3a3a 2920 6172 6520 commands::) are │ │ │ │ │ -00020100: 6120 7375 6273 6574 206f 6620 7468 6f73 a subset of thos │ │ │ │ │ -00020110: 6520 6176 6169 6c61 626c 6520 696e 2074 e available in t │ │ │ │ │ -00020120: 6865 2063 6f6e 6669 6775 7261 7469 6f6e he configuration │ │ │ │ │ -00020130: 0a66 696c 652c 2075 7365 6420 7769 7468 .file, used with │ │ │ │ │ -00020140: 2065 7861 6374 6c79 2074 6865 2073 616d exactly the sam │ │ │ │ │ -00020150: 6520 7379 6e74 6178 2e0a 0a20 2020 4375 e syntax... Cu │ │ │ │ │ -00020160: 7273 6f72 206d 6f76 656d 656e 7420 616e rsor movement an │ │ │ │ │ -00020170: 6420 6564 6974 696e 6720 6f66 2074 6865 d editing of the │ │ │ │ │ -00020180: 2074 6578 7420 6f6e 2074 6865 206c 696e text on the lin │ │ │ │ │ -00020190: 6520 6361 6e20 6265 2064 6f6e 6520 7669 e can be done vi │ │ │ │ │ -000201a0: 6120 610a 7375 6273 6574 206f 6620 7468 a a.subset of th │ │ │ │ │ -000201b0: 6520 6675 6e63 7469 6f6e 7320 6176 6169 e functions avai │ │ │ │ │ -000201c0: 6c61 626c 6520 696e 2074 6865 2042 6173 lable in the Bas │ │ │ │ │ -000201d0: 6820 7368 656c 6c3a 0a0a 3c43 2d66 3e0a h shell:... │ │ │ │ │ -000201e0: 3c50 4320 7269 6768 7420 6b65 793e 0a20 . │ │ │ │ │ -000201f0: 2020 2020 4d6f 7665 2066 6f72 7761 7264 Move forward │ │ │ │ │ -00020200: 206f 6e65 2063 6861 7261 6374 6572 2e0a one character.. │ │ │ │ │ -00020210: 0a3c 432d 623e 0a3c 5043 206c 6566 7420 ... Move b │ │ │ │ │ -00020230: 6163 6b20 6f6e 6520 6368 6172 6163 7465 ack one characte │ │ │ │ │ -00020240: 722e 0a0a 3c43 2d61 3e0a 3c48 4f4d 453e r.... │ │ │ │ │ -00020250: 0a20 2020 2020 4d6f 7665 2074 6f20 7468 . Move to th │ │ │ │ │ -00020260: 6520 7374 6172 7420 6f66 2074 6865 206c e start of the l │ │ │ │ │ -00020270: 696e 652e 0a0a 3c43 2d65 3e0a 3c45 4e44 ine..... Move the │ │ │ │ │ -00020290: 7468 6520 656e 6420 6f66 2074 6865 206c the end of the l │ │ │ │ │ -000202a0: 696e 652e 0a0a 3c43 2d64 3e0a 3c44 454c ine..... Delete th │ │ │ │ │ -000202c0: 6520 6368 6172 6163 7465 7220 756e 6465 e character unde │ │ │ │ │ -000202d0: 726e 6561 7468 2074 6865 2063 7572 736f rneath the curso │ │ │ │ │ -000202e0: 722e 0a0a 3c43 2d68 3e0a 3c42 533e 0a20 r..... │ │ │ │ │ -000202f0: 2020 2020 4465 6c65 7465 2074 6865 2063 Delete the c │ │ │ │ │ -00020300: 6861 7261 6374 6572 2074 6f20 7468 6520 haracter to the │ │ │ │ │ -00020310: 6c65 6674 206f 6620 7468 6520 6375 7273 left of the curs │ │ │ │ │ -00020320: 6f72 2e0a 0a3c 432d 6b3e 0a20 2020 2020 or.... │ │ │ │ │ -00020330: 4b69 6c6c 2074 6865 2074 6578 7420 6672 Kill the text fr │ │ │ │ │ -00020340: 6f6d 2074 6865 2063 7572 7265 6e74 2063 om the current c │ │ │ │ │ -00020350: 7572 736f 7220 706f 7369 7469 6f6e 2074 ursor position t │ │ │ │ │ -00020360: 6f20 7468 6520 656e 6420 6f66 2074 6865 o the end of the │ │ │ │ │ -00020370: 0a20 2020 2020 6c69 6e65 2e0a 0a3c 432d . line.... Kill bac │ │ │ │ │ -00020390: 6b77 6172 6420 6672 6f6d 2074 6865 2063 kward from the c │ │ │ │ │ -000203a0: 7572 736f 7220 746f 2074 6865 2062 6567 ursor to the beg │ │ │ │ │ -000203b0: 696e 6e69 6e67 206f 6620 7468 6520 6c69 inning of the li │ │ │ │ │ -000203c0: 6e65 2e0a 0a3c 432d 793e 0a20 2020 2020 ne.... │ │ │ │ │ -000203d0: 5961 6e6b 2074 6865 206b 696c 6c65 6420 Yank the killed │ │ │ │ │ -000203e0: 7465 7874 2062 6163 6b20 696e 746f 2074 text back into t │ │ │ │ │ -000203f0: 6865 2062 7566 6665 7220 6174 2074 6865 he buffer at the │ │ │ │ │ -00020400: 2063 7572 736f 722e 0a0a 3c43 2d70 3e0a cursor.... │ │ │ │ │ -00020410: 3c50 4320 7570 206b 6579 3e0a 2020 2020 . │ │ │ │ │ -00020420: 204d 6f76 6520 7570 2074 6872 6f75 6768 Move up through │ │ │ │ │ -00020430: 2074 6865 2068 6973 746f 7279 206c 6973 the history lis │ │ │ │ │ -00020440: 742e 0a0a 3c43 2d6e 3e0a 3c50 4320 646f t..... Mov │ │ │ │ │ -00020460: 6520 646f 776e 2074 6872 6f75 6768 2074 e down through t │ │ │ │ │ -00020470: 6865 2068 6973 746f 7279 206c 6973 742e he history list. │ │ │ │ │ -00020480: 0a0a 2020 2057 6865 6e20 7479 7069 6e67 .. When typing │ │ │ │ │ -00020490: 2063 6f6d 6d61 6e64 7320 696e 7465 7261 commands intera │ │ │ │ │ -000204a0: 6374 6976 656c 792c 2069 6620 7468 6520 ctively, if the │ │ │ │ │ -000204b0: 6375 7273 6f72 2069 7320 7769 7468 696e cursor is within │ │ │ │ │ -000204c0: 206f 7220 6265 666f 7265 0a74 6865 2066 or before.the f │ │ │ │ │ -000204d0: 6972 7374 2077 6f72 6420 696e 2074 6865 irst word in the │ │ │ │ │ -000204e0: 2063 6f6d 6d61 6e64 2d6c 696e 652c 2070 command-line, p │ │ │ │ │ -000204f0: 7265 7373 696e 6720 7468 6520 3c54 4142 ressing the key (or ) │ │ │ │ │ -00020510: 0a77 696c 6c20 6469 7370 6c61 7920 6120 .will display a │ │ │ │ │ -00020520: 6c69 7374 696e 6720 6f66 2074 6865 2061 listing of the a │ │ │ │ │ -00020530: 7661 696c 6162 6c65 2063 6f6d 6d61 6e64 vailable command │ │ │ │ │ -00020540: 732c 2061 6e64 2069 6620 7468 6520 6375 s, and if the cu │ │ │ │ │ -00020550: 7273 6f72 2069 730a 6166 7465 7220 7468 rsor is.after th │ │ │ │ │ -00020560: 6520 6669 7273 7420 776f 7264 2c20 7468 e first word, th │ │ │ │ │ -00020570: 6520 273c 5441 423e 2720 7769 6c6c 2070 e '' will p │ │ │ │ │ -00020580: 726f 7669 6465 2061 2063 6f6d 706c 6574 rovide a complet │ │ │ │ │ -00020590: 696f 6e20 6c69 7374 696e 6720 6f66 0a64 ion listing of.d │ │ │ │ │ -000205a0: 6973 6b73 2c20 7061 7274 6974 696f 6e73 isks, partitions │ │ │ │ │ -000205b0: 2c20 616e 6420 6669 6c65 206e 616d 6573 , and file names │ │ │ │ │ -000205c0: 2064 6570 656e 6469 6e67 206f 6e20 7468 depending on th │ │ │ │ │ -000205d0: 6520 636f 6e74 6578 742e 2020 4e6f 7465 e context. Note │ │ │ │ │ -000205e0: 2074 6861 740a 746f 206f 6274 6169 6e20 that.to obtain │ │ │ │ │ -000205f0: 6120 6c69 7374 206f 6620 6472 6976 6573 a list of drives │ │ │ │ │ -00020600: 2c20 6f6e 6520 6d75 7374 206f 7065 6e20 , one must open │ │ │ │ │ -00020610: 6120 7061 7265 6e74 6865 7369 732c 2061 a parenthesis, a │ │ │ │ │ -00020620: 7320 2772 6f6f 7420 2827 2e0a 0a20 2020 s 'root ('... │ │ │ │ │ -00020630: 4e6f 7465 2074 6861 7420 796f 7520 6361 Note that you ca │ │ │ │ │ -00020640: 6e6e 6f74 2075 7365 2074 6865 2063 6f6d nnot use the com │ │ │ │ │ -00020650: 706c 6574 696f 6e20 6675 6e63 7469 6f6e pletion function │ │ │ │ │ -00020660: 616c 6974 7920 696e 2074 6865 2054 4654 ality in the TFT │ │ │ │ │ -00020670: 500a 6669 6c65 7379 7374 656d 2e20 2054 P.filesystem. T │ │ │ │ │ -00020680: 6869 7320 6973 2062 6563 6175 7365 2054 his is because T │ │ │ │ │ -00020690: 4654 5020 646f 6573 6e27 7420 7375 7070 FTP doesn't supp │ │ │ │ │ -000206a0: 6f72 7420 6669 6c65 206e 616d 6520 6c69 ort file name li │ │ │ │ │ -000206b0: 7374 696e 6720 666f 720a 7468 6520 7365 sting for.the se │ │ │ │ │ -000206c0: 6375 7269 7479 2e0a 0a1f 0a46 696c 653a curity.....File: │ │ │ │ │ -000206d0: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ -000206e0: 653a 2043 6f6d 6d61 6e64 2d6c 696e 6520 e: Command-line │ │ │ │ │ -000206f0: 696e 7465 7266 6163 652d 466f 6f74 6e6f interface-Footno │ │ │ │ │ -00020700: 7465 732c 2020 5570 3a20 436f 6d6d 616e tes, Up: Comman │ │ │ │ │ -00020710: 642d 6c69 6e65 2069 6e74 6572 6661 6365 d-line interface │ │ │ │ │ -00020720: 0a0a 2020 2028 3129 2048 6f77 6576 6572 .. (1) However │ │ │ │ │ -00020730: 2c20 7468 6973 2062 6568 6176 696f 7220 , this behavior │ │ │ │ │ -00020740: 7769 6c6c 2062 6520 6368 616e 6765 6420 will be changed │ │ │ │ │ -00020750: 696e 2074 6865 2066 7574 7572 6520 7665 in the future ve │ │ │ │ │ -00020760: 7273 696f 6e2c 2069 6e0a 6120 7573 6572 rsion, in.a user │ │ │ │ │ -00020770: 2d69 6e76 6973 6962 6c65 2077 6179 2e0a -invisible way.. │ │ │ │ │ -00020780: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ -00020790: 666f 2c20 204e 6f64 653a 204d 656e 7520 fo, Node: Menu │ │ │ │ │ -000207a0: 696e 7465 7266 6163 652c 2020 4e65 7874 interface, Next │ │ │ │ │ -000207b0: 3a20 4d65 6e75 2065 6e74 7279 2065 6469 : Menu entry edi │ │ │ │ │ -000207c0: 746f 722c 2020 5072 6576 3a20 436f 6d6d tor, Prev: Comm │ │ │ │ │ -000207d0: 616e 642d 6c69 6e65 2069 6e74 6572 6661 and-line interfa │ │ │ │ │ -000207e0: 6365 2c20 2055 703a 2049 6e74 6572 6661 ce, Up: Interfa │ │ │ │ │ -000207f0: 6365 0a0a 3134 2e32 2054 6865 2073 696d ce..14.2 The sim │ │ │ │ │ -00020800: 706c 6520 6d65 6e75 2069 6e74 6572 6661 ple menu interfa │ │ │ │ │ -00020810: 6365 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ce.============= │ │ │ │ │ -00020820: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00020830: 3d0a 0a54 6865 206d 656e 7520 696e 7465 =..The menu inte │ │ │ │ │ -00020840: 7266 6163 6520 6973 2071 7569 7465 2065 rface is quite e │ │ │ │ │ -00020850: 6173 7920 746f 2075 7365 2e20 2049 7473 asy to use. Its │ │ │ │ │ -00020860: 2063 6f6d 6d61 6e64 7320 6172 6520 626f commands are bo │ │ │ │ │ -00020870: 7468 0a72 6561 736f 6e61 626c 7920 696e th.reasonably in │ │ │ │ │ -00020880: 7475 6974 6976 6520 616e 6420 6465 7363 tuitive and desc │ │ │ │ │ -00020890: 7269 6265 6420 6f6e 2073 6372 6565 6e2e ribed on screen. │ │ │ │ │ -000208a0: 0a0a 2020 2042 6173 6963 616c 6c79 2c20 .. Basically, │ │ │ │ │ -000208b0: 7468 6520 6d65 6e75 2069 6e74 6572 6661 the menu interfa │ │ │ │ │ -000208c0: 6365 2070 726f 7669 6465 7320 6120 6c69 ce provides a li │ │ │ │ │ -000208d0: 7374 206f 6620 2262 6f6f 7420 656e 7472 st of "boot entr │ │ │ │ │ -000208e0: 6965 7322 2074 6f0a 7468 6520 7573 6572 ies" to.the user │ │ │ │ │ -000208f0: 2074 6f20 6368 6f6f 7365 2066 726f 6d2e to choose from. │ │ │ │ │ -00020900: 2020 5573 6520 7468 6520 6172 726f 7720 Use the arrow │ │ │ │ │ -00020910: 6b65 7973 2074 6f20 7365 6c65 6374 2074 keys to select t │ │ │ │ │ -00020920: 6865 2065 6e74 7279 206f 660a 6368 6f69 he entry of.choi │ │ │ │ │ -00020930: 6365 2c20 7468 656e 2070 7265 7373 203c ce, then press < │ │ │ │ │ -00020940: 5245 543e 2074 6f20 7275 6e20 6974 2e20 RET> to run it. │ │ │ │ │ -00020950: 2041 6e20 6f70 7469 6f6e 616c 2074 696d An optional tim │ │ │ │ │ -00020960: 656f 7574 2069 7320 6176 6169 6c61 626c eout is availabl │ │ │ │ │ -00020970: 6520 746f 0a62 6f6f 7420 7468 6520 6465 e to.boot the de │ │ │ │ │ -00020980: 6661 756c 7420 656e 7472 7920 2874 6865 fault entry (the │ │ │ │ │ -00020990: 2066 6972 7374 206f 6e65 2069 6620 6e6f first one if no │ │ │ │ │ -000209a0: 7420 7365 7429 2c20 7768 6963 6820 6973 t set), which is │ │ │ │ │ -000209b0: 2061 626f 7274 6564 2062 790a 7072 6573 aborted by.pres │ │ │ │ │ -000209c0: 7369 6e67 2061 6e79 206b 6579 2e0a 0a20 sing any key... │ │ │ │ │ -000209d0: 2020 436f 6d6d 616e 6473 2061 7265 2061 Commands are a │ │ │ │ │ -000209e0: 7661 696c 6162 6c65 2074 6f20 656e 7465 vailable to ente │ │ │ │ │ -000209f0: 7220 6120 6261 7265 2063 6f6d 6d61 6e64 r a bare command │ │ │ │ │ -00020a00: 2d6c 696e 6520 6279 2070 7265 7373 696e -line by pressin │ │ │ │ │ -00020a10: 6720 3c63 3e0a 2877 6869 6368 206f 7065 g .(which ope │ │ │ │ │ -00020a20: 7261 7465 7320 6578 6163 746c 7920 6c69 rates exactly li │ │ │ │ │ -00020a30: 6b65 2074 6865 206e 6f6e 2d63 6f6e 6669 ke the non-confi │ │ │ │ │ -00020a40: 672d 6669 6c65 2076 6572 7369 6f6e 206f g-file version o │ │ │ │ │ -00020a50: 6620 4752 5542 2c20 6275 740a 616c 6c6f f GRUB, but.allo │ │ │ │ │ -00020a60: 7773 206f 6e65 2074 6f20 7265 7475 726e ws one to return │ │ │ │ │ -00020a70: 2074 6f20 7468 6520 6d65 6e75 2069 6620 to the menu if │ │ │ │ │ -00020a80: 6465 7369 7265 6420 6279 2070 7265 7373 desired by press │ │ │ │ │ -00020a90: 696e 6720 3c45 5343 3e29 206f 7220 746f ing ) or to │ │ │ │ │ -00020aa0: 0a65 6469 7420 616e 7920 6f66 2074 6865 .edit any of the │ │ │ │ │ -00020ab0: 2022 626f 6f74 2065 6e74 7269 6573 2220 "boot entries" │ │ │ │ │ -00020ac0: 6279 2070 7265 7373 696e 6720 3c65 3e2e by pressing . │ │ │ │ │ -00020ad0: 0a0a 2020 2049 6620 796f 7520 7072 6f74 .. If you prot │ │ │ │ │ -00020ae0: 6563 7420 7468 6520 6d65 6e75 2069 6e74 ect the menu int │ │ │ │ │ -00020af0: 6572 6661 6365 2077 6974 6820 6120 7061 erface with a pa │ │ │ │ │ -00020b00: 7373 776f 7264 2028 2a6e 6f74 6520 5365 ssword (*note Se │ │ │ │ │ -00020b10: 6375 7269 7479 3a3a 292c 0a61 6c6c 2079 curity::),.all y │ │ │ │ │ -00020b20: 6f75 2063 616e 2064 6f20 6973 2063 686f ou can do is cho │ │ │ │ │ -00020b30: 6f73 6520 616e 2065 6e74 7279 2062 7920 ose an entry by │ │ │ │ │ -00020b40: 7072 6573 7369 6e67 203c 5245 543e 2c20 pressing , │ │ │ │ │ -00020b50: 6f72 2070 7265 7373 203c 703e 2074 6f0a or press

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

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

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

to.en │ │ │ │ │ +00020b60: 7465 7220 7468 6520 7061 7373 776f 7264 ter the password │ │ │ │ │ +00020b70: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ +00020b80: 696e 666f 2c20 204e 6f64 653a 204d 656e info, Node: Men │ │ │ │ │ +00020b90: 7520 656e 7472 7920 6564 6974 6f72 2c20 u entry editor, │ │ │ │ │ +00020ba0: 2050 7265 763a 204d 656e 7520 696e 7465 Prev: Menu inte │ │ │ │ │ +00020bb0: 7266 6163 652c 2020 5570 3a20 496e 7465 rface, Up: Inte │ │ │ │ │ +00020bc0: 7266 6163 650a 0a31 342e 3320 4564 6974 rface..14.3 Edit │ │ │ │ │ +00020bd0: 696e 6720 6120 6d65 6e75 2065 6e74 7279 ing a menu entry │ │ │ │ │ +00020be0: 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d .=============== │ │ │ │ │ +00020bf0: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 5468 6520 ==========..The │ │ │ │ │ +00020c00: 6d65 6e75 2065 6e74 7279 2065 6469 746f menu entry edito │ │ │ │ │ +00020c10: 7220 6c6f 6f6b 7320 6d75 6368 206c 696b r looks much lik │ │ │ │ │ +00020c20: 6520 7468 6520 6d61 696e 206d 656e 7520 e the main menu │ │ │ │ │ +00020c30: 696e 7465 7266 6163 652c 2062 7574 2074 interface, but t │ │ │ │ │ +00020c40: 6865 0a6c 696e 6573 2069 6e20 7468 6520 he.lines in the │ │ │ │ │ +00020c50: 6d65 6e75 2061 7265 2069 6e64 6976 6964 menu are individ │ │ │ │ │ +00020c60: 7561 6c20 636f 6d6d 616e 6473 2069 6e20 ual commands in │ │ │ │ │ +00020c70: 7468 6520 7365 6c65 6374 6564 2065 6e74 the selected ent │ │ │ │ │ +00020c80: 7279 2069 6e73 7465 6164 0a6f 6620 656e ry instead.of en │ │ │ │ │ +00020c90: 7472 7920 6e61 6d65 732e 0a0a 2020 2049 try names... I │ │ │ │ │ +00020ca0: 6620 616e 203c 4553 433e 2069 7320 7072 f an is pr │ │ │ │ │ +00020cb0: 6573 7365 6420 696e 2074 6865 2065 6469 essed in the edi │ │ │ │ │ +00020cc0: 746f 722c 2069 7420 6162 6f72 7473 2061 tor, it aborts a │ │ │ │ │ +00020cd0: 6c6c 2074 6865 2063 6861 6e67 6573 206d ll the changes m │ │ │ │ │ +00020ce0: 6164 650a 746f 2074 6865 2063 6f6e 6669 ade.to the confi │ │ │ │ │ +00020cf0: 6775 7261 7469 6f6e 2065 6e74 7279 2061 guration entry a │ │ │ │ │ +00020d00: 6e64 2072 6574 7572 6e73 2074 6f20 7468 nd returns to th │ │ │ │ │ +00020d10: 6520 6d61 696e 206d 656e 7520 696e 7465 e main menu inte │ │ │ │ │ +00020d20: 7266 6163 652e 0a0a 2020 2045 6163 6820 rface... Each │ │ │ │ │ +00020d30: 6c69 6e65 2069 6e20 7468 6520 6d65 6e75 line in the menu │ │ │ │ │ +00020d40: 2065 6e74 7279 2063 616e 2062 6520 6564 entry can be ed │ │ │ │ │ +00020d50: 6974 6564 2066 7265 656c 792c 2061 6e64 ited freely, and │ │ │ │ │ +00020d60: 2079 6f75 2063 616e 2061 6464 206e 6577 you can add new │ │ │ │ │ +00020d70: 0a6c 696e 6573 2062 7920 7072 6573 7369 .lines by pressi │ │ │ │ │ +00020d80: 6e67 203c 5245 543e 2061 7420 7468 6520 ng at the │ │ │ │ │ +00020d90: 656e 6420 6f66 2061 206c 696e 652e 2020 end of a line. │ │ │ │ │ +00020da0: 546f 2062 6f6f 7420 7468 6520 6564 6974 To boot the edit │ │ │ │ │ +00020db0: 6564 2065 6e74 7279 2c0a 7072 6573 7320 ed entry,.press │ │ │ │ │ +00020dc0: 3c43 7472 6c2d 783e 2e0a 0a20 2020 416c ... Al │ │ │ │ │ +00020dd0: 7468 6f75 6768 2047 5255 4220 756e 666f though GRUB unfo │ │ │ │ │ +00020de0: 7274 756e 6174 656c 7920 646f 6573 206e rtunately does n │ │ │ │ │ +00020df0: 6f74 2073 7570 706f 7274 2022 756e 646f ot support "undo │ │ │ │ │ +00020e00: 222c 2079 6f75 2063 616e 2064 6f0a 616c ", you can do.al │ │ │ │ │ +00020e10: 6d6f 7374 2074 6865 2073 616d 6520 7468 most the same th │ │ │ │ │ +00020e20: 696e 6720 6279 206a 7573 7420 7265 7475 ing by just retu │ │ │ │ │ +00020e30: 726e 696e 6720 746f 2074 6865 206d 6169 rning to the mai │ │ │ │ │ +00020e40: 6e20 6d65 6e75 2075 7369 6e67 203c 4553 n menu using .....File: gru │ │ │ │ │ +00020e60: 622e 696e 666f 2c20 204e 6f64 653a 2045 b.info, Node: E │ │ │ │ │ +00020e70: 6e76 6972 6f6e 6d65 6e74 2c20 204e 6578 nvironment, Nex │ │ │ │ │ +00020e80: 743a 2043 6f6d 6d61 6e64 732c 2020 5072 t: Commands, Pr │ │ │ │ │ +00020e90: 6576 3a20 496e 7465 7266 6163 652c 2020 ev: Interface, │ │ │ │ │ +00020ea0: 5570 3a20 546f 700a 0a31 3520 4752 5542 Up: Top..15 GRUB │ │ │ │ │ +00020eb0: 2065 6e76 6972 6f6e 6d65 6e74 2076 6172 environment var │ │ │ │ │ +00020ec0: 6961 626c 6573 0a2a 2a2a 2a2a 2a2a 2a2a iables.********* │ │ │ │ │ 00020ed0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -00020ee0: 2a2a 2a2a 2a2a 0a0a 4752 5542 2073 7570 ******..GRUB sup │ │ │ │ │ -00020ef0: 706f 7274 7320 656e 7669 726f 6e6d 656e ports environmen │ │ │ │ │ -00020f00: 7420 7661 7269 6162 6c65 7320 7768 6963 t variables whic │ │ │ │ │ -00020f10: 6820 6172 6520 7261 7468 6572 206c 696b h are rather lik │ │ │ │ │ -00020f20: 6520 7468 6f73 6520 6f66 6665 7265 640a e those offered. │ │ │ │ │ -00020f30: 6279 2061 6c6c 2055 6e69 782d 6c69 6b65 by all Unix-like │ │ │ │ │ -00020f40: 2073 7973 7465 6d73 2e20 2045 6e76 6972 systems. Envir │ │ │ │ │ -00020f50: 6f6e 6d65 6e74 2076 6172 6961 626c 6573 onment variables │ │ │ │ │ -00020f60: 2068 6176 6520 6120 6e61 6d65 2c20 7768 have a name, wh │ │ │ │ │ -00020f70: 6963 6820 6973 0a75 6e69 7175 6520 616e ich is.unique an │ │ │ │ │ -00020f80: 6420 6973 2075 7375 616c 6c79 2061 2073 d is usually a s │ │ │ │ │ -00020f90: 686f 7274 2069 6465 6e74 6966 6965 722c hort identifier, │ │ │ │ │ -00020fa0: 2061 6e64 2061 2076 616c 7565 2c20 7768 and a value, wh │ │ │ │ │ -00020fb0: 6963 6820 6973 2061 6e0a 6172 6269 7472 ich is an.arbitr │ │ │ │ │ -00020fc0: 6172 7920 7374 7269 6e67 206f 6620 6368 ary string of ch │ │ │ │ │ -00020fd0: 6172 6163 7465 7273 2e20 2054 6865 7920 aracters. They │ │ │ │ │ -00020fe0: 6d61 7920 6265 2073 6574 2028 2a6e 6f74 may be set (*not │ │ │ │ │ -00020ff0: 6520 7365 743a 3a29 2c20 756e 7365 740a e set::), unset. │ │ │ │ │ -00021000: 282a 6e6f 7465 2075 6e73 6574 3a3a 292c (*note unset::), │ │ │ │ │ -00021010: 206f 7220 6c6f 6f6b 6564 2075 7020 282a or looked up (* │ │ │ │ │ -00021020: 6e6f 7465 2053 6865 6c6c 2d6c 696b 6520 note Shell-like │ │ │ │ │ -00021030: 7363 7269 7074 696e 673a 3a29 2062 7920 scripting::) by │ │ │ │ │ -00021040: 6e61 6d65 2e0a 0a20 2020 4120 6e75 6d62 name... A numb │ │ │ │ │ -00021050: 6572 206f 6620 656e 7669 726f 6e6d 656e er of environmen │ │ │ │ │ -00021060: 7420 7661 7269 6162 6c65 7320 6861 7665 t variables have │ │ │ │ │ -00021070: 2073 7065 6369 616c 206d 6561 6e69 6e67 special meaning │ │ │ │ │ -00021080: 7320 746f 2076 6172 696f 7573 0a70 6172 s to various.par │ │ │ │ │ -00021090: 7473 206f 6620 4752 5542 2e20 4f74 6865 ts of GRUB. Othe │ │ │ │ │ -000210a0: 7273 206d 6179 2062 6520 7573 6564 2066 rs may be used f │ │ │ │ │ -000210b0: 7265 656c 7920 696e 2047 5255 4220 636f reely in GRUB co │ │ │ │ │ -000210c0: 6e66 6967 7572 6174 696f 6e20 6669 6c65 nfiguration file │ │ │ │ │ -000210d0: 732e 0a0a 2a20 4d65 6e75 3a0a 0a2a 2053 s...* Menu:..* S │ │ │ │ │ -000210e0: 7065 6369 616c 2065 6e76 6972 6f6e 6d65 pecial environme │ │ │ │ │ -000210f0: 6e74 2076 6172 6961 626c 6573 3a3a 0a2a nt variables::.* │ │ │ │ │ -00021100: 2045 6e76 6972 6f6e 6d65 6e74 2062 6c6f Environment blo │ │ │ │ │ -00021110: 636b 3a3a 0a0a 1f0a 4669 6c65 3a20 6772 ck::....File: gr │ │ │ │ │ -00021120: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ -00021130: 5370 6563 6961 6c20 656e 7669 726f 6e6d Special environm │ │ │ │ │ -00021140: 656e 7420 7661 7269 6162 6c65 732c 2020 ent variables, │ │ │ │ │ -00021150: 4e65 7874 3a20 456e 7669 726f 6e6d 656e Next: Environmen │ │ │ │ │ -00021160: 7420 626c 6f63 6b2c 2020 5570 3a20 456e t block, Up: En │ │ │ │ │ -00021170: 7669 726f 6e6d 656e 740a 0a31 352e 3120 vironment..15.1 │ │ │ │ │ -00021180: 5370 6563 6961 6c20 656e 7669 726f 6e6d Special environm │ │ │ │ │ -00021190: 656e 7420 7661 7269 6162 6c65 730a 3d3d ent variables.== │ │ │ │ │ +00020ee0: 2a2a 2a2a 0a0a 4752 5542 2073 7570 706f ****..GRUB suppo │ │ │ │ │ +00020ef0: 7274 7320 656e 7669 726f 6e6d 656e 7420 rts environment │ │ │ │ │ +00020f00: 7661 7269 6162 6c65 7320 7768 6963 6820 variables which │ │ │ │ │ +00020f10: 6172 6520 7261 7468 6572 206c 696b 6520 are rather like │ │ │ │ │ +00020f20: 7468 6f73 6520 6f66 6665 7265 640a 6279 those offered.by │ │ │ │ │ +00020f30: 2061 6c6c 2055 6e69 782d 6c69 6b65 2073 all Unix-like s │ │ │ │ │ +00020f40: 7973 7465 6d73 2e20 2045 6e76 6972 6f6e ystems. Environ │ │ │ │ │ +00020f50: 6d65 6e74 2076 6172 6961 626c 6573 2068 ment variables h │ │ │ │ │ +00020f60: 6176 6520 6120 6e61 6d65 2c20 7768 6963 ave a name, whic │ │ │ │ │ +00020f70: 6820 6973 0a75 6e69 7175 6520 616e 6420 h is.unique and │ │ │ │ │ +00020f80: 6973 2075 7375 616c 6c79 2061 2073 686f is usually a sho │ │ │ │ │ +00020f90: 7274 2069 6465 6e74 6966 6965 722c 2061 rt identifier, a │ │ │ │ │ +00020fa0: 6e64 2061 2076 616c 7565 2c20 7768 6963 nd a value, whic │ │ │ │ │ +00020fb0: 6820 6973 2061 6e0a 6172 6269 7472 6172 h is an.arbitrar │ │ │ │ │ +00020fc0: 7920 7374 7269 6e67 206f 6620 6368 6172 y string of char │ │ │ │ │ +00020fd0: 6163 7465 7273 2e20 2054 6865 7920 6d61 acters. They ma │ │ │ │ │ +00020fe0: 7920 6265 2073 6574 2028 2a6e 6f74 6520 y be set (*note │ │ │ │ │ +00020ff0: 7365 743a 3a29 2c20 756e 7365 740a 282a set::), unset.(* │ │ │ │ │ +00021000: 6e6f 7465 2075 6e73 6574 3a3a 292c 206f note unset::), o │ │ │ │ │ +00021010: 7220 6c6f 6f6b 6564 2075 7020 282a 6e6f r looked up (*no │ │ │ │ │ +00021020: 7465 2053 6865 6c6c 2d6c 696b 6520 7363 te Shell-like sc │ │ │ │ │ +00021030: 7269 7074 696e 673a 3a29 2062 7920 6e61 ripting::) by na │ │ │ │ │ +00021040: 6d65 2e0a 0a20 2020 4120 6e75 6d62 6572 me... A number │ │ │ │ │ +00021050: 206f 6620 656e 7669 726f 6e6d 656e 7420 of environment │ │ │ │ │ +00021060: 7661 7269 6162 6c65 7320 6861 7665 2073 variables have s │ │ │ │ │ +00021070: 7065 6369 616c 206d 6561 6e69 6e67 7320 pecial meanings │ │ │ │ │ +00021080: 746f 2076 6172 696f 7573 0a70 6172 7473 to various.parts │ │ │ │ │ +00021090: 206f 6620 4752 5542 2e20 4f74 6865 7273 of GRUB. Others │ │ │ │ │ +000210a0: 206d 6179 2062 6520 7573 6564 2066 7265 may be used fre │ │ │ │ │ +000210b0: 656c 7920 696e 2047 5255 4220 636f 6e66 ely in GRUB conf │ │ │ │ │ +000210c0: 6967 7572 6174 696f 6e20 6669 6c65 732e iguration files. │ │ │ │ │ +000210d0: 0a0a 2a20 4d65 6e75 3a0a 0a2a 2053 7065 ..* Menu:..* Spe │ │ │ │ │ +000210e0: 6369 616c 2065 6e76 6972 6f6e 6d65 6e74 cial environment │ │ │ │ │ +000210f0: 2076 6172 6961 626c 6573 3a3a 0a2a 2045 variables::.* E │ │ │ │ │ +00021100: 6e76 6972 6f6e 6d65 6e74 2062 6c6f 636b nvironment block │ │ │ │ │ +00021110: 3a3a 0a0a 1f0a 4669 6c65 3a20 6772 7562 ::....File: grub │ │ │ │ │ +00021120: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 5370 .info, Node: Sp │ │ │ │ │ +00021130: 6563 6961 6c20 656e 7669 726f 6e6d 656e ecial environmen │ │ │ │ │ +00021140: 7420 7661 7269 6162 6c65 732c 2020 4e65 t variables, Ne │ │ │ │ │ +00021150: 7874 3a20 456e 7669 726f 6e6d 656e 7420 xt: Environment │ │ │ │ │ +00021160: 626c 6f63 6b2c 2020 5570 3a20 456e 7669 block, Up: Envi │ │ │ │ │ +00021170: 726f 6e6d 656e 740a 0a31 352e 3120 5370 ronment..15.1 Sp │ │ │ │ │ +00021180: 6563 6961 6c20 656e 7669 726f 6e6d 656e ecial environmen │ │ │ │ │ +00021190: 7420 7661 7269 6162 6c65 730a 3d3d 3d3d t variables.==== │ │ │ │ │ 000211a0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -000211b0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -000211c0: 0a0a 5468 6573 6520 7661 7269 6162 6c65 ..These variable │ │ │ │ │ -000211d0: 7320 6861 7665 2073 7065 6369 616c 206d s have special m │ │ │ │ │ -000211e0: 6561 6e69 6e67 2074 6f20 4752 5542 2e0a eaning to GRUB.. │ │ │ │ │ -000211f0: 0a2a 204d 656e 753a 0a0a 2a20 6269 6f73 .* Menu:..* bios │ │ │ │ │ -00021200: 6e75 6d3a 3a0a 2a20 6368 6563 6b5f 7369 num::.* check_si │ │ │ │ │ -00021210: 676e 6174 7572 6573 3a3a 0a2a 2063 686f gnatures::.* cho │ │ │ │ │ -00021220: 7365 6e3a 3a0a 2a20 636d 6470 6174 683a sen::.* cmdpath: │ │ │ │ │ -00021230: 3a0a 2a20 636f 6c6f 725f 6869 6768 6c69 :.* color_highli │ │ │ │ │ -00021240: 6768 743a 3a0a 2a20 636f 6c6f 725f 6e6f ght::.* color_no │ │ │ │ │ -00021250: 726d 616c 3a3a 0a2a 2063 6f6e 6669 675f rmal::.* config_ │ │ │ │ │ -00021260: 6469 7265 6374 6f72 793a 3a0a 2a20 636f directory::.* co │ │ │ │ │ -00021270: 6e66 6967 5f66 696c 653a 3a0a 2a20 6465 nfig_file::.* de │ │ │ │ │ -00021280: 6275 673a 3a0a 2a20 6465 6661 756c 743a bug::.* default: │ │ │ │ │ -00021290: 3a0a 2a20 6661 6c6c 6261 636b 3a3a 0a2a :.* fallback::.* │ │ │ │ │ -000212a0: 2067 6678 6d6f 6465 3a3a 0a2a 2067 6678 gfxmode::.* gfx │ │ │ │ │ -000212b0: 7061 796c 6f61 643a 3a0a 2a20 6766 7874 payload::.* gfxt │ │ │ │ │ -000212c0: 6572 6d5f 666f 6e74 3a3a 0a2a 2067 7275 erm_font::.* gru │ │ │ │ │ -000212d0: 625f 6370 753a 3a0a 2a20 6772 7562 5f70 b_cpu::.* grub_p │ │ │ │ │ -000212e0: 6c61 7466 6f72 6d3a 3a0a 2a20 6963 6f6e latform::.* icon │ │ │ │ │ -000212f0: 6469 723a 3a0a 2a20 6c61 6e67 3a3a 0a2a dir::.* lang::.* │ │ │ │ │ -00021300: 206c 6f63 616c 655f 6469 723a 3a0a 2a20 locale_dir::.* │ │ │ │ │ -00021310: 6d65 6e75 5f63 6f6c 6f72 5f68 6967 686c menu_color_highl │ │ │ │ │ -00021320: 6967 6874 3a3a 0a2a 206d 656e 755f 636f ight::.* menu_co │ │ │ │ │ -00021330: 6c6f 725f 6e6f 726d 616c 3a3a 0a2a 206e lor_normal::.* n │ │ │ │ │ -00021340: 6574 5f3c 494e 5445 5246 4143 453e 5f62 et__b │ │ │ │ │ -00021350: 6f6f 745f 6669 6c65 3a3a 0a2a 206e 6574 oot_file::.* net │ │ │ │ │ -00021360: 5f3c 494e 5445 5246 4143 453e 5f64 6863 __dhc │ │ │ │ │ -00021370: 705f 7365 7276 6572 5f6e 616d 653a 3a0a p_server_name::. │ │ │ │ │ -00021380: 2a20 6e65 745f 3c49 4e54 4552 4641 4345 * net__domain::.* net │ │ │ │ │ -000213a0: 5f3c 494e 5445 5246 4143 453e 5f65 7874 __ext │ │ │ │ │ -000213b0: 656e 7369 6f6e 7370 6174 683a 3a0a 2a20 ensionspath::.* │ │ │ │ │ -000213c0: 6e65 745f 3c49 4e54 4552 4641 4345 3e5f net__ │ │ │ │ │ -000213d0: 686f 7374 6e61 6d65 3a3a 0a2a 206e 6574 hostname::.* net │ │ │ │ │ -000213e0: 5f3c 494e 5445 5246 4143 453e 5f69 703a __ip: │ │ │ │ │ -000213f0: 3a0a 2a20 6e65 745f 3c49 4e54 4552 4641 :.* net__mac::.* net_ │ │ │ │ │ -00021410: 3c49 4e54 4552 4641 4345 3e5f 6e65 7874 _next │ │ │ │ │ -00021420: 5f73 6572 7665 723a 3a0a 2a20 6e65 745f _server::.* net_ │ │ │ │ │ -00021430: 3c49 4e54 4552 4641 4345 3e5f 726f 6f74 _root │ │ │ │ │ -00021440: 7061 7468 3a3a 0a2a 206e 6574 5f64 6566 path::.* net_def │ │ │ │ │ -00021450: 6175 6c74 5f69 6e74 6572 6661 6365 3a3a ault_interface:: │ │ │ │ │ -00021460: 0a2a 206e 6574 5f64 6566 6175 6c74 5f69 .* net_default_i │ │ │ │ │ -00021470: 703a 3a0a 2a20 6e65 745f 6465 6661 756c p::.* net_defaul │ │ │ │ │ -00021480: 745f 6d61 633a 3a0a 2a20 6e65 745f 6465 t_mac::.* net_de │ │ │ │ │ -00021490: 6661 756c 745f 7365 7276 6572 3a3a 0a2a fault_server::.* │ │ │ │ │ -000214a0: 2070 6167 6572 3a3a 0a2a 2070 7265 6669 pager::.* prefi │ │ │ │ │ -000214b0: 783a 3a0a 2a20 7078 655f 626c 6b73 697a x::.* pxe_blksiz │ │ │ │ │ -000214c0: 653a 3a0a 2a20 7078 655f 6465 6661 756c e::.* pxe_defaul │ │ │ │ │ -000214d0: 745f 6761 7465 7761 793a 3a0a 2a20 7078 t_gateway::.* px │ │ │ │ │ -000214e0: 655f 6465 6661 756c 745f 7365 7276 6572 e_default_server │ │ │ │ │ -000214f0: 3a3a 0a2a 2072 6f6f 743a 3a0a 2a20 7375 ::.* root::.* su │ │ │ │ │ -00021500: 7065 7275 7365 7273 3a3a 0a2a 2074 6865 perusers::.* the │ │ │ │ │ -00021510: 6d65 3a3a 0a2a 2074 696d 656f 7574 3a3a me::.* timeout:: │ │ │ │ │ -00021520: 0a2a 2074 696d 656f 7574 5f73 7479 6c65 .* timeout_style │ │ │ │ │ -00021530: 3a3a 0a0a 1f0a 4669 6c65 3a20 6772 7562 ::....File: grub │ │ │ │ │ -00021540: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 6269 .info, Node: bi │ │ │ │ │ -00021550: 6f73 6e75 6d2c 2020 4e65 7874 3a20 6368 osnum, Next: ch │ │ │ │ │ -00021560: 6563 6b5f 7369 676e 6174 7572 6573 2c20 eck_signatures, │ │ │ │ │ -00021570: 2055 703a 2053 7065 6369 616c 2065 6e76 Up: Special env │ │ │ │ │ -00021580: 6972 6f6e 6d65 6e74 2076 6172 6961 626c ironment variabl │ │ │ │ │ -00021590: 6573 0a0a 3135 2e31 2e31 2062 696f 736e es..15.1.1 biosn │ │ │ │ │ -000215a0: 756d 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d um.------------- │ │ │ │ │ -000215b0: 2d0a 0a57 6865 6e20 6368 6169 6e2d 6c6f -..When chain-lo │ │ │ │ │ -000215c0: 6164 696e 6720 616e 6f74 6865 7220 626f ading another bo │ │ │ │ │ -000215d0: 6f74 206c 6f61 6465 7220 282a 6e6f 7465 ot loader (*note │ │ │ │ │ -000215e0: 2043 6861 696e 2d6c 6f61 6469 6e67 3a3a Chain-loading:: │ │ │ │ │ -000215f0: 292c 2047 5255 4220 6d61 790a 6e65 6564 ), GRUB may.need │ │ │ │ │ -00021600: 2074 6f20 6b6e 6f77 2077 6861 7420 4249 to know what BI │ │ │ │ │ -00021610: 4f53 2064 7269 7665 206e 756d 6265 7220 OS drive number │ │ │ │ │ -00021620: 636f 7272 6573 706f 6e64 7320 746f 2074 corresponds to t │ │ │ │ │ -00021630: 6865 2072 6f6f 7420 6465 7669 6365 0a28 he root device.( │ │ │ │ │ -00021640: 2a6e 6f74 6520 726f 6f74 3a3a 2920 736f *note root::) so │ │ │ │ │ -00021650: 2074 6861 7420 6974 2063 616e 2073 6574 that it can set │ │ │ │ │ -00021660: 2075 7020 7265 6769 7374 6572 7320 7072 up registers pr │ │ │ │ │ -00021670: 6f70 6572 6c79 2e20 2049 6620 7468 6520 operly. If the │ │ │ │ │ -00021680: 4249 4f53 4e55 4d0a 7661 7269 6162 6c65 BIOSNUM.variable │ │ │ │ │ -00021690: 2069 7320 7365 742c 2069 7420 6f76 6572 is set, it over │ │ │ │ │ -000216a0: 7269 6465 7320 4752 5542 2773 206f 776e rides GRUB's own │ │ │ │ │ -000216b0: 206d 6561 6e73 206f 6620 6775 6573 7369 means of guessi │ │ │ │ │ -000216c0: 6e67 2074 6869 732e 0a0a 2020 2046 6f72 ng this... For │ │ │ │ │ -000216d0: 2061 6e20 616c 7465 726e 6174 6976 6520 an alternative │ │ │ │ │ -000216e0: 6170 7072 6f61 6368 2077 6869 6368 2061 approach which a │ │ │ │ │ -000216f0: 6c73 6f20 6368 616e 6765 7320 4249 4f53 lso changes BIOS │ │ │ │ │ -00021700: 2064 7269 7665 206d 6170 7069 6e67 730a drive mappings. │ │ │ │ │ -00021710: 666f 7220 7468 6520 6368 6169 6e2d 6c6f for the chain-lo │ │ │ │ │ -00021720: 6164 6564 2073 7973 7465 6d2c 202a 6e6f aded system, *no │ │ │ │ │ -00021730: 7465 2064 7269 7665 6d61 703a 3a2e 0a0a te drivemap::... │ │ │ │ │ -00021740: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ -00021750: 6f2c 2020 4e6f 6465 3a20 6368 6563 6b5f o, Node: check_ │ │ │ │ │ -00021760: 7369 676e 6174 7572 6573 2c20 204e 6578 signatures, Nex │ │ │ │ │ -00021770: 743a 2063 686f 7365 6e2c 2020 5072 6576 t: chosen, Prev │ │ │ │ │ -00021780: 3a20 6269 6f73 6e75 6d2c 2020 5570 3a20 : biosnum, Up: │ │ │ │ │ -00021790: 5370 6563 6961 6c20 656e 7669 726f 6e6d Special environm │ │ │ │ │ -000217a0: 656e 7420 7661 7269 6162 6c65 730a 0a31 ent variables..1 │ │ │ │ │ -000217b0: 352e 312e 3220 6368 6563 6b5f 7369 676e 5.1.2 check_sign │ │ │ │ │ -000217c0: 6174 7572 6573 0a2d 2d2d 2d2d 2d2d 2d2d atures.--------- │ │ │ │ │ -000217d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ -000217e0: 5468 6973 2076 6172 6961 626c 6520 636f This variable co │ │ │ │ │ -000217f0: 6e74 726f 6c73 2077 6865 7468 6572 2047 ntrols whether G │ │ │ │ │ -00021800: 5255 4220 656e 666f 7263 6573 2064 6967 RUB enforces dig │ │ │ │ │ -00021810: 6974 616c 2073 6967 6e61 7475 7265 0a76 ital signature.v │ │ │ │ │ -00021820: 616c 6964 6174 696f 6e20 6f6e 206c 6f61 alidation on loa │ │ │ │ │ -00021830: 6465 6420 6669 6c65 732e 2020 2a4e 6f74 ded files. *Not │ │ │ │ │ -00021840: 6520 5573 696e 6720 6469 6769 7461 6c20 e Using digital │ │ │ │ │ -00021850: 7369 676e 6174 7572 6573 3a3a 2e0a 0a1f signatures::.... │ │ │ │ │ -00021860: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ -00021870: 2c20 204e 6f64 653a 2063 686f 7365 6e2c , Node: chosen, │ │ │ │ │ -00021880: 2020 4e65 7874 3a20 636d 6470 6174 682c Next: cmdpath, │ │ │ │ │ -00021890: 2020 5072 6576 3a20 6368 6563 6b5f 7369 Prev: check_si │ │ │ │ │ -000218a0: 676e 6174 7572 6573 2c20 2055 703a 2053 gnatures, Up: S │ │ │ │ │ -000218b0: 7065 6369 616c 2065 6e76 6972 6f6e 6d65 pecial environme │ │ │ │ │ -000218c0: 6e74 2076 6172 6961 626c 6573 0a0a 3135 nt variables..15 │ │ │ │ │ -000218d0: 2e31 2e33 2063 686f 7365 6e0a 2d2d 2d2d .1.3 chosen.---- │ │ │ │ │ -000218e0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a57 6865 6e20 ---------..When │ │ │ │ │ -000218f0: 6578 6563 7574 696e 6720 6120 6d65 6e75 executing a menu │ │ │ │ │ -00021900: 2065 6e74 7279 2c20 4752 5542 2073 6574 entry, GRUB set │ │ │ │ │ -00021910: 7320 7468 6520 4348 4f53 454e 2076 6172 s the CHOSEN var │ │ │ │ │ -00021920: 6961 626c 6520 746f 2074 6865 2074 6974 iable to the tit │ │ │ │ │ -00021930: 6c65 0a6f 6620 7468 6520 656e 7472 7920 le.of the entry │ │ │ │ │ -00021940: 6265 696e 6720 6578 6563 7574 6564 2e0a being executed.. │ │ │ │ │ -00021950: 0a20 2020 4966 2074 6865 206d 656e 7520 . If the menu │ │ │ │ │ -00021960: 656e 7472 7920 6973 2069 6e20 6f6e 6520 entry is in one │ │ │ │ │ -00021970: 6f72 206d 6f72 6520 7375 626d 656e 7573 or more submenus │ │ │ │ │ -00021980: 2c20 7468 656e 2043 484f 5345 4e20 6973 , then CHOSEN is │ │ │ │ │ -00021990: 2073 6574 2074 6f0a 7468 6520 7469 746c set to.the titl │ │ │ │ │ -000219a0: 6573 206f 6620 6561 6368 206f 6620 7468 es of each of th │ │ │ │ │ -000219b0: 6520 7375 626d 656e 7573 2073 7461 7274 e submenus start │ │ │ │ │ -000219c0: 696e 6720 6672 6f6d 2074 6865 2074 6f70 ing from the top │ │ │ │ │ -000219d0: 206c 6576 656c 2066 6f6c 6c6f 7765 640a level followed. │ │ │ │ │ -000219e0: 6279 2074 6865 2074 6974 6c65 206f 6620 by the title of │ │ │ │ │ -000219f0: 7468 6520 6d65 6e75 2065 6e74 7279 2069 the menu entry i │ │ │ │ │ -00021a00: 7473 656c 662c 2073 6570 6172 6174 6564 tself, separated │ │ │ │ │ -00021a10: 2062 7920 273e 272e 0a0a 1f0a 4669 6c65 by '>'.....File │ │ │ │ │ -00021a20: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ -00021a30: 6465 3a20 636d 6470 6174 682c 2020 4e65 de: cmdpath, Ne │ │ │ │ │ -00021a40: 7874 3a20 636f 6c6f 725f 6869 6768 6c69 xt: color_highli │ │ │ │ │ -00021a50: 6768 742c 2020 5072 6576 3a20 6368 6f73 ght, Prev: chos │ │ │ │ │ -00021a60: 656e 2c20 2055 703a 2053 7065 6369 616c en, Up: Special │ │ │ │ │ -00021a70: 2065 6e76 6972 6f6e 6d65 6e74 2076 6172 environment var │ │ │ │ │ -00021a80: 6961 626c 6573 0a0a 3135 2e31 2e34 2063 iables..15.1.4 c │ │ │ │ │ -00021a90: 6d64 7061 7468 0a2d 2d2d 2d2d 2d2d 2d2d mdpath.--------- │ │ │ │ │ -00021aa0: 2d2d 2d2d 2d0a 0a54 6865 206c 6f63 6174 -----..The locat │ │ │ │ │ -00021ab0: 696f 6e20 6672 6f6d 2077 6869 6368 2027 ion from which ' │ │ │ │ │ -00021ac0: 636f 7265 2e69 6d67 2720 7761 7320 6c6f core.img' was lo │ │ │ │ │ -00021ad0: 6164 6564 2061 7320 616e 2061 6273 6f6c aded as an absol │ │ │ │ │ -00021ae0: 7574 6520 6469 7265 6374 6f72 790a 6e61 ute directory.na │ │ │ │ │ -00021af0: 6d65 2028 2a6e 6f74 6520 4669 6c65 206e me (*note File n │ │ │ │ │ -00021b00: 616d 6520 7379 6e74 6178 3a3a 292e 2020 ame syntax::). │ │ │ │ │ -00021b10: 5468 6973 2069 7320 7365 7420 6279 2047 This is set by G │ │ │ │ │ -00021b20: 5255 4220 6174 2073 7461 7274 7570 2062 RUB at startup b │ │ │ │ │ -00021b30: 6173 6564 0a6f 6e20 696e 666f 726d 6174 ased.on informat │ │ │ │ │ -00021b40: 696f 6e20 7265 7475 726e 6564 2062 7920 ion returned by │ │ │ │ │ -00021b50: 706c 6174 666f 726d 2066 6972 6d77 6172 platform firmwar │ │ │ │ │ -00021b60: 652e 2020 4e6f 7420 6576 6572 7920 706c e. Not every pl │ │ │ │ │ -00021b70: 6174 666f 726d 0a70 726f 7669 6465 7320 atform.provides │ │ │ │ │ -00021b80: 7468 6973 2069 6e66 6f72 6d61 7469 6f6e this information │ │ │ │ │ -00021b90: 2061 6e64 2073 6f6d 6520 6d61 7920 7265 and some may re │ │ │ │ │ -00021ba0: 7475 726e 206f 6e6c 7920 6465 7669 6365 turn only device │ │ │ │ │ -00021bb0: 2077 6974 686f 7574 2070 6174 680a 6e61 without path.na │ │ │ │ │ -00021bc0: 6d65 2e0a 0a1f 0a46 696c 653a 2067 7275 me.....File: gru │ │ │ │ │ -00021bd0: 622e 696e 666f 2c20 204e 6f64 653a 2063 b.info, Node: c │ │ │ │ │ -00021be0: 6f6c 6f72 5f68 6967 686c 6967 6874 2c20 olor_highlight, │ │ │ │ │ -00021bf0: 204e 6578 743a 2063 6f6c 6f72 5f6e 6f72 Next: color_nor │ │ │ │ │ -00021c00: 6d61 6c2c 2020 5072 6576 3a20 636d 6470 mal, Prev: cmdp │ │ │ │ │ -00021c10: 6174 682c 2020 5570 3a20 5370 6563 6961 ath, Up: Specia │ │ │ │ │ -00021c20: 6c20 656e 7669 726f 6e6d 656e 7420 7661 l environment va │ │ │ │ │ -00021c30: 7269 6162 6c65 730a 0a31 352e 312e 3520 riables..15.1.5 │ │ │ │ │ -00021c40: 636f 6c6f 725f 6869 6768 6c69 6768 740a color_highlight. │ │ │ │ │ +000211b0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a ==============.. │ │ │ │ │ +000211c0: 5468 6573 6520 7661 7269 6162 6c65 7320 These variables │ │ │ │ │ +000211d0: 6861 7665 2073 7065 6369 616c 206d 6561 have special mea │ │ │ │ │ +000211e0: 6e69 6e67 2074 6f20 4752 5542 2e0a 0a2a ning to GRUB...* │ │ │ │ │ +000211f0: 204d 656e 753a 0a0a 2a20 6269 6f73 6e75 Menu:..* biosnu │ │ │ │ │ +00021200: 6d3a 3a0a 2a20 6368 6563 6b5f 7369 676e m::.* check_sign │ │ │ │ │ +00021210: 6174 7572 6573 3a3a 0a2a 2063 686f 7365 atures::.* chose │ │ │ │ │ +00021220: 6e3a 3a0a 2a20 636d 6470 6174 683a 3a0a n::.* cmdpath::. │ │ │ │ │ +00021230: 2a20 636f 6c6f 725f 6869 6768 6c69 6768 * color_highligh │ │ │ │ │ +00021240: 743a 3a0a 2a20 636f 6c6f 725f 6e6f 726d t::.* color_norm │ │ │ │ │ +00021250: 616c 3a3a 0a2a 2063 6f6e 6669 675f 6469 al::.* config_di │ │ │ │ │ +00021260: 7265 6374 6f72 793a 3a0a 2a20 636f 6e66 rectory::.* conf │ │ │ │ │ +00021270: 6967 5f66 696c 653a 3a0a 2a20 6465 6275 ig_file::.* debu │ │ │ │ │ +00021280: 673a 3a0a 2a20 6465 6661 756c 743a 3a0a g::.* default::. │ │ │ │ │ +00021290: 2a20 6661 6c6c 6261 636b 3a3a 0a2a 2067 * fallback::.* g │ │ │ │ │ +000212a0: 6678 6d6f 6465 3a3a 0a2a 2067 6678 7061 fxmode::.* gfxpa │ │ │ │ │ +000212b0: 796c 6f61 643a 3a0a 2a20 6766 7874 6572 yload::.* gfxter │ │ │ │ │ +000212c0: 6d5f 666f 6e74 3a3a 0a2a 2067 7275 625f m_font::.* grub_ │ │ │ │ │ +000212d0: 6370 753a 3a0a 2a20 6772 7562 5f70 6c61 cpu::.* grub_pla │ │ │ │ │ +000212e0: 7466 6f72 6d3a 3a0a 2a20 6963 6f6e 6469 tform::.* icondi │ │ │ │ │ +000212f0: 723a 3a0a 2a20 6c61 6e67 3a3a 0a2a 206c r::.* lang::.* l │ │ │ │ │ +00021300: 6f63 616c 655f 6469 723a 3a0a 2a20 6d65 ocale_dir::.* me │ │ │ │ │ +00021310: 6e75 5f63 6f6c 6f72 5f68 6967 686c 6967 nu_color_highlig │ │ │ │ │ +00021320: 6874 3a3a 0a2a 206d 656e 755f 636f 6c6f ht::.* menu_colo │ │ │ │ │ +00021330: 725f 6e6f 726d 616c 3a3a 0a2a 206e 6574 r_normal::.* net │ │ │ │ │ +00021340: 5f3c 494e 5445 5246 4143 453e 5f62 6f6f __boo │ │ │ │ │ +00021350: 745f 6669 6c65 3a3a 0a2a 206e 6574 5f3c t_file::.* net_< │ │ │ │ │ +00021360: 494e 5445 5246 4143 453e 5f64 6863 705f INTERFACE>_dhcp_ │ │ │ │ │ +00021370: 7365 7276 6572 5f6e 616d 653a 3a0a 2a20 server_name::.* │ │ │ │ │ +00021380: 6e65 745f 3c49 4e54 4552 4641 4345 3e5f net__ │ │ │ │ │ +00021390: 646f 6d61 696e 3a3a 0a2a 206e 6574 5f3c domain::.* net_< │ │ │ │ │ +000213a0: 494e 5445 5246 4143 453e 5f65 7874 656e INTERFACE>_exten │ │ │ │ │ +000213b0: 7369 6f6e 7370 6174 683a 3a0a 2a20 6e65 sionspath::.* ne │ │ │ │ │ +000213c0: 745f 3c49 4e54 4552 4641 4345 3e5f 686f t__ho │ │ │ │ │ +000213d0: 7374 6e61 6d65 3a3a 0a2a 206e 6574 5f3c stname::.* net_< │ │ │ │ │ +000213e0: 494e 5445 5246 4143 453e 5f69 703a 3a0a INTERFACE>_ip::. │ │ │ │ │ +000213f0: 2a20 6e65 745f 3c49 4e54 4552 4641 4345 * net__mac::.* net__next_s │ │ │ │ │ +00021420: 6572 7665 723a 3a0a 2a20 6e65 745f 3c49 erver::.* net__rootpa │ │ │ │ │ +00021440: 7468 3a3a 0a2a 206e 6574 5f64 6566 6175 th::.* net_defau │ │ │ │ │ +00021450: 6c74 5f69 6e74 6572 6661 6365 3a3a 0a2a lt_interface::.* │ │ │ │ │ +00021460: 206e 6574 5f64 6566 6175 6c74 5f69 703a net_default_ip: │ │ │ │ │ +00021470: 3a0a 2a20 6e65 745f 6465 6661 756c 745f :.* net_default_ │ │ │ │ │ +00021480: 6d61 633a 3a0a 2a20 6e65 745f 6465 6661 mac::.* net_defa │ │ │ │ │ +00021490: 756c 745f 7365 7276 6572 3a3a 0a2a 2070 ult_server::.* p │ │ │ │ │ +000214a0: 6167 6572 3a3a 0a2a 2070 7265 6669 783a ager::.* prefix: │ │ │ │ │ +000214b0: 3a0a 2a20 7078 655f 626c 6b73 697a 653a :.* pxe_blksize: │ │ │ │ │ +000214c0: 3a0a 2a20 7078 655f 6465 6661 756c 745f :.* pxe_default_ │ │ │ │ │ +000214d0: 6761 7465 7761 793a 3a0a 2a20 7078 655f gateway::.* pxe_ │ │ │ │ │ +000214e0: 6465 6661 756c 745f 7365 7276 6572 3a3a default_server:: │ │ │ │ │ +000214f0: 0a2a 2072 6f6f 743a 3a0a 2a20 7375 7065 .* root::.* supe │ │ │ │ │ +00021500: 7275 7365 7273 3a3a 0a2a 2074 6865 6d65 rusers::.* theme │ │ │ │ │ +00021510: 3a3a 0a2a 2074 696d 656f 7574 3a3a 0a2a ::.* timeout::.* │ │ │ │ │ +00021520: 2074 696d 656f 7574 5f73 7479 6c65 3a3a timeout_style:: │ │ │ │ │ +00021530: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ +00021540: 6e66 6f2c 2020 4e6f 6465 3a20 6269 6f73 nfo, Node: bios │ │ │ │ │ +00021550: 6e75 6d2c 2020 4e65 7874 3a20 6368 6563 num, Next: chec │ │ │ │ │ +00021560: 6b5f 7369 676e 6174 7572 6573 2c20 2055 k_signatures, U │ │ │ │ │ +00021570: 703a 2053 7065 6369 616c 2065 6e76 6972 p: Special envir │ │ │ │ │ +00021580: 6f6e 6d65 6e74 2076 6172 6961 626c 6573 onment variables │ │ │ │ │ +00021590: 0a0a 3135 2e31 2e31 2062 696f 736e 756d ..15.1.1 biosnum │ │ │ │ │ +000215a0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a .--------------. │ │ │ │ │ +000215b0: 0a57 6865 6e20 6368 6169 6e2d 6c6f 6164 .When chain-load │ │ │ │ │ +000215c0: 696e 6720 616e 6f74 6865 7220 626f 6f74 ing another boot │ │ │ │ │ +000215d0: 206c 6f61 6465 7220 282a 6e6f 7465 2043 loader (*note C │ │ │ │ │ +000215e0: 6861 696e 2d6c 6f61 6469 6e67 3a3a 292c hain-loading::), │ │ │ │ │ +000215f0: 2047 5255 4220 6d61 790a 6e65 6564 2074 GRUB may.need t │ │ │ │ │ +00021600: 6f20 6b6e 6f77 2077 6861 7420 4249 4f53 o know what BIOS │ │ │ │ │ +00021610: 2064 7269 7665 206e 756d 6265 7220 636f drive number co │ │ │ │ │ +00021620: 7272 6573 706f 6e64 7320 746f 2074 6865 rresponds to the │ │ │ │ │ +00021630: 2072 6f6f 7420 6465 7669 6365 0a28 2a6e root device.(*n │ │ │ │ │ +00021640: 6f74 6520 726f 6f74 3a3a 2920 736f 2074 ote root::) so t │ │ │ │ │ +00021650: 6861 7420 6974 2063 616e 2073 6574 2075 hat it can set u │ │ │ │ │ +00021660: 7020 7265 6769 7374 6572 7320 7072 6f70 p registers prop │ │ │ │ │ +00021670: 6572 6c79 2e20 2049 6620 7468 6520 4249 erly. If the BI │ │ │ │ │ +00021680: 4f53 4e55 4d0a 7661 7269 6162 6c65 2069 OSNUM.variable i │ │ │ │ │ +00021690: 7320 7365 742c 2069 7420 6f76 6572 7269 s set, it overri │ │ │ │ │ +000216a0: 6465 7320 4752 5542 2773 206f 776e 206d des GRUB's own m │ │ │ │ │ +000216b0: 6561 6e73 206f 6620 6775 6573 7369 6e67 eans of guessing │ │ │ │ │ +000216c0: 2074 6869 732e 0a0a 2020 2046 6f72 2061 this... For a │ │ │ │ │ +000216d0: 6e20 616c 7465 726e 6174 6976 6520 6170 n alternative ap │ │ │ │ │ +000216e0: 7072 6f61 6368 2077 6869 6368 2061 6c73 proach which als │ │ │ │ │ +000216f0: 6f20 6368 616e 6765 7320 4249 4f53 2064 o changes BIOS d │ │ │ │ │ +00021700: 7269 7665 206d 6170 7069 6e67 730a 666f rive mappings.fo │ │ │ │ │ +00021710: 7220 7468 6520 6368 6169 6e2d 6c6f 6164 r the chain-load │ │ │ │ │ +00021720: 6564 2073 7973 7465 6d2c 202a 6e6f 7465 ed system, *note │ │ │ │ │ +00021730: 2064 7269 7665 6d61 703a 3a2e 0a0a 1f0a drivemap::..... │ │ │ │ │ +00021740: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ +00021750: 2020 4e6f 6465 3a20 6368 6563 6b5f 7369 Node: check_si │ │ │ │ │ +00021760: 676e 6174 7572 6573 2c20 204e 6578 743a gnatures, Next: │ │ │ │ │ +00021770: 2063 686f 7365 6e2c 2020 5072 6576 3a20 chosen, Prev: │ │ │ │ │ +00021780: 6269 6f73 6e75 6d2c 2020 5570 3a20 5370 biosnum, Up: Sp │ │ │ │ │ +00021790: 6563 6961 6c20 656e 7669 726f 6e6d 656e ecial environmen │ │ │ │ │ +000217a0: 7420 7661 7269 6162 6c65 730a 0a31 352e t variables..15. │ │ │ │ │ +000217b0: 312e 3220 6368 6563 6b5f 7369 676e 6174 1.2 check_signat │ │ │ │ │ +000217c0: 7572 6573 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d ures.----------- │ │ │ │ │ +000217d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 5468 ------------..Th │ │ │ │ │ +000217e0: 6973 2076 6172 6961 626c 6520 636f 6e74 is variable cont │ │ │ │ │ +000217f0: 726f 6c73 2077 6865 7468 6572 2047 5255 rols whether GRU │ │ │ │ │ +00021800: 4220 656e 666f 7263 6573 2064 6967 6974 B enforces digit │ │ │ │ │ +00021810: 616c 2073 6967 6e61 7475 7265 0a76 616c al signature.val │ │ │ │ │ +00021820: 6964 6174 696f 6e20 6f6e 206c 6f61 6465 idation on loade │ │ │ │ │ +00021830: 6420 6669 6c65 732e 2020 2a4e 6f74 6520 d files. *Note │ │ │ │ │ +00021840: 5573 696e 6720 6469 6769 7461 6c20 7369 Using digital si │ │ │ │ │ +00021850: 676e 6174 7572 6573 3a3a 2e0a 0a1f 0a46 gnatures::.....F │ │ │ │ │ +00021860: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ +00021870: 204e 6f64 653a 2063 686f 7365 6e2c 2020 Node: chosen, │ │ │ │ │ +00021880: 4e65 7874 3a20 636d 6470 6174 682c 2020 Next: cmdpath, │ │ │ │ │ +00021890: 5072 6576 3a20 6368 6563 6b5f 7369 676e Prev: check_sign │ │ │ │ │ +000218a0: 6174 7572 6573 2c20 2055 703a 2053 7065 atures, Up: Spe │ │ │ │ │ +000218b0: 6369 616c 2065 6e76 6972 6f6e 6d65 6e74 cial environment │ │ │ │ │ +000218c0: 2076 6172 6961 626c 6573 0a0a 3135 2e31 variables..15.1 │ │ │ │ │ +000218d0: 2e33 2063 686f 7365 6e0a 2d2d 2d2d 2d2d .3 chosen.------ │ │ │ │ │ +000218e0: 2d2d 2d2d 2d2d 2d0a 0a57 6865 6e20 6578 -------..When ex │ │ │ │ │ +000218f0: 6563 7574 696e 6720 6120 6d65 6e75 2065 ecuting a menu e │ │ │ │ │ +00021900: 6e74 7279 2c20 4752 5542 2073 6574 7320 ntry, GRUB sets │ │ │ │ │ +00021910: 7468 6520 4348 4f53 454e 2076 6172 6961 the CHOSEN varia │ │ │ │ │ +00021920: 626c 6520 746f 2074 6865 2074 6974 6c65 ble to the title │ │ │ │ │ +00021930: 0a6f 6620 7468 6520 656e 7472 7920 6265 .of the entry be │ │ │ │ │ +00021940: 696e 6720 6578 6563 7574 6564 2e0a 0a20 ing executed... │ │ │ │ │ +00021950: 2020 4966 2074 6865 206d 656e 7520 656e If the menu en │ │ │ │ │ +00021960: 7472 7920 6973 2069 6e20 6f6e 6520 6f72 try is in one or │ │ │ │ │ +00021970: 206d 6f72 6520 7375 626d 656e 7573 2c20 more submenus, │ │ │ │ │ +00021980: 7468 656e 2043 484f 5345 4e20 6973 2073 then CHOSEN is s │ │ │ │ │ +00021990: 6574 2074 6f0a 7468 6520 7469 746c 6573 et to.the titles │ │ │ │ │ +000219a0: 206f 6620 6561 6368 206f 6620 7468 6520 of each of the │ │ │ │ │ +000219b0: 7375 626d 656e 7573 2073 7461 7274 696e submenus startin │ │ │ │ │ +000219c0: 6720 6672 6f6d 2074 6865 2074 6f70 206c g from the top l │ │ │ │ │ +000219d0: 6576 656c 2066 6f6c 6c6f 7765 640a 6279 evel followed.by │ │ │ │ │ +000219e0: 2074 6865 2074 6974 6c65 206f 6620 7468 the title of th │ │ │ │ │ +000219f0: 6520 6d65 6e75 2065 6e74 7279 2069 7473 e menu entry its │ │ │ │ │ +00021a00: 656c 662c 2073 6570 6172 6174 6564 2062 elf, separated b │ │ │ │ │ +00021a10: 7920 273e 272e 0a0a 1f0a 4669 6c65 3a20 y '>'.....File: │ │ │ │ │ +00021a20: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ +00021a30: 3a20 636d 6470 6174 682c 2020 4e65 7874 : cmdpath, Next │ │ │ │ │ +00021a40: 3a20 636f 6c6f 725f 6869 6768 6c69 6768 : color_highligh │ │ │ │ │ +00021a50: 742c 2020 5072 6576 3a20 6368 6f73 656e t, Prev: chosen │ │ │ │ │ +00021a60: 2c20 2055 703a 2053 7065 6369 616c 2065 , Up: Special e │ │ │ │ │ +00021a70: 6e76 6972 6f6e 6d65 6e74 2076 6172 6961 nvironment varia │ │ │ │ │ +00021a80: 626c 6573 0a0a 3135 2e31 2e34 2063 6d64 bles..15.1.4 cmd │ │ │ │ │ +00021a90: 7061 7468 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d path.----------- │ │ │ │ │ +00021aa0: 2d2d 2d0a 0a54 6865 206c 6f63 6174 696f ---..The locatio │ │ │ │ │ +00021ab0: 6e20 6672 6f6d 2077 6869 6368 2027 636f n from which 'co │ │ │ │ │ +00021ac0: 7265 2e69 6d67 2720 7761 7320 6c6f 6164 re.img' was load │ │ │ │ │ +00021ad0: 6564 2061 7320 616e 2061 6273 6f6c 7574 ed as an absolut │ │ │ │ │ +00021ae0: 6520 6469 7265 6374 6f72 790a 6e61 6d65 e directory.name │ │ │ │ │ +00021af0: 2028 2a6e 6f74 6520 4669 6c65 206e 616d (*note File nam │ │ │ │ │ +00021b00: 6520 7379 6e74 6178 3a3a 292e 2020 5468 e syntax::). Th │ │ │ │ │ +00021b10: 6973 2069 7320 7365 7420 6279 2047 5255 is is set by GRU │ │ │ │ │ +00021b20: 4220 6174 2073 7461 7274 7570 2062 6173 B at startup bas │ │ │ │ │ +00021b30: 6564 0a6f 6e20 696e 666f 726d 6174 696f ed.on informatio │ │ │ │ │ +00021b40: 6e20 7265 7475 726e 6564 2062 7920 706c n returned by pl │ │ │ │ │ +00021b50: 6174 666f 726d 2066 6972 6d77 6172 652e atform firmware. │ │ │ │ │ +00021b60: 2020 4e6f 7420 6576 6572 7920 706c 6174 Not every plat │ │ │ │ │ +00021b70: 666f 726d 0a70 726f 7669 6465 7320 7468 form.provides th │ │ │ │ │ +00021b80: 6973 2069 6e66 6f72 6d61 7469 6f6e 2061 is information a │ │ │ │ │ +00021b90: 6e64 2073 6f6d 6520 6d61 7920 7265 7475 nd some may retu │ │ │ │ │ +00021ba0: 726e 206f 6e6c 7920 6465 7669 6365 2077 rn only device w │ │ │ │ │ +00021bb0: 6974 686f 7574 2070 6174 680a 6e61 6d65 ithout path.name │ │ │ │ │ +00021bc0: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ +00021bd0: 696e 666f 2c20 204e 6f64 653a 2063 6f6c info, Node: col │ │ │ │ │ +00021be0: 6f72 5f68 6967 686c 6967 6874 2c20 204e or_highlight, N │ │ │ │ │ +00021bf0: 6578 743a 2063 6f6c 6f72 5f6e 6f72 6d61 ext: color_norma │ │ │ │ │ +00021c00: 6c2c 2020 5072 6576 3a20 636d 6470 6174 l, Prev: cmdpat │ │ │ │ │ +00021c10: 682c 2020 5570 3a20 5370 6563 6961 6c20 h, Up: Special │ │ │ │ │ +00021c20: 656e 7669 726f 6e6d 656e 7420 7661 7269 environment vari │ │ │ │ │ +00021c30: 6162 6c65 730a 0a31 352e 312e 3520 636f ables..15.1.5 co │ │ │ │ │ +00021c40: 6c6f 725f 6869 6768 6c69 6768 740a 2d2d lor_highlight.-- │ │ │ │ │ 00021c50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00021c60: 2d2d 2d2d 2d2d 0a0a 5468 6973 2076 6172 ------..This var │ │ │ │ │ -00021c70: 6961 626c 6520 636f 6e74 6169 6e73 2074 iable contains t │ │ │ │ │ -00021c80: 6865 2022 6869 6768 6c69 6768 7422 2066 he "highlight" f │ │ │ │ │ -00021c90: 6f72 6567 726f 756e 6420 616e 6420 6261 oreground and ba │ │ │ │ │ -00021ca0: 636b 6772 6f75 6e64 0a74 6572 6d69 6e61 ckground.termina │ │ │ │ │ -00021cb0: 6c20 636f 6c6f 7273 2c20 7365 7061 7261 l colors, separa │ │ │ │ │ -00021cc0: 7465 6420 6279 2061 2073 6c61 7368 2028 ted by a slash ( │ │ │ │ │ -00021cd0: 272f 2729 2e20 2053 6574 7469 6e67 2074 '/'). Setting t │ │ │ │ │ -00021ce0: 6869 7320 7661 7269 6162 6c65 0a63 6861 his variable.cha │ │ │ │ │ -00021cf0: 6e67 6573 2074 686f 7365 2063 6f6c 6f72 nges those color │ │ │ │ │ -00021d00: 732e 2020 466f 7220 7468 6520 6176 6169 s. For the avai │ │ │ │ │ -00021d10: 6c61 626c 6520 636f 6c6f 7220 6e61 6d65 lable color name │ │ │ │ │ -00021d20: 732c 202a 6e6f 7465 0a63 6f6c 6f72 5f6e s, *note.color_n │ │ │ │ │ -00021d30: 6f72 6d61 6c3a 3a2e 0a0a 2020 2054 6865 ormal::... The │ │ │ │ │ -00021d40: 2064 6566 6175 6c74 2069 7320 2762 6c61 default is 'bla │ │ │ │ │ -00021d50: 636b 2f6c 6967 6874 2d67 7261 7927 2e0a ck/light-gray'.. │ │ │ │ │ -00021d60: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ -00021d70: 666f 2c20 204e 6f64 653a 2063 6f6c 6f72 fo, Node: color │ │ │ │ │ -00021d80: 5f6e 6f72 6d61 6c2c 2020 4e65 7874 3a20 _normal, Next: │ │ │ │ │ -00021d90: 636f 6e66 6967 5f64 6972 6563 746f 7279 config_directory │ │ │ │ │ -00021da0: 2c20 2050 7265 763a 2063 6f6c 6f72 5f68 , Prev: color_h │ │ │ │ │ -00021db0: 6967 686c 6967 6874 2c20 2055 703a 2053 ighlight, Up: S │ │ │ │ │ -00021dc0: 7065 6369 616c 2065 6e76 6972 6f6e 6d65 pecial environme │ │ │ │ │ -00021dd0: 6e74 2076 6172 6961 626c 6573 0a0a 3135 nt variables..15 │ │ │ │ │ -00021de0: 2e31 2e36 2063 6f6c 6f72 5f6e 6f72 6d61 .1.6 color_norma │ │ │ │ │ -00021df0: 6c0a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d l.-------------- │ │ │ │ │ -00021e00: 2d2d 2d2d 2d0a 0a54 6869 7320 7661 7269 -----..This vari │ │ │ │ │ -00021e10: 6162 6c65 2063 6f6e 7461 696e 7320 7468 able contains th │ │ │ │ │ -00021e20: 6520 226e 6f72 6d61 6c22 2066 6f72 6567 e "normal" foreg │ │ │ │ │ -00021e30: 726f 756e 6420 616e 6420 6261 636b 6772 round and backgr │ │ │ │ │ -00021e40: 6f75 6e64 2074 6572 6d69 6e61 6c0a 636f ound terminal.co │ │ │ │ │ -00021e50: 6c6f 7273 2c20 7365 7061 7261 7465 6420 lors, separated │ │ │ │ │ -00021e60: 6279 2061 2073 6c61 7368 2028 272f 2729 by a slash ('/') │ │ │ │ │ -00021e70: 2e20 2053 6574 7469 6e67 2074 6869 7320 . Setting this │ │ │ │ │ -00021e80: 7661 7269 6162 6c65 2063 6861 6e67 6573 variable changes │ │ │ │ │ -00021e90: 2074 686f 7365 0a63 6f6c 6f72 732e 2020 those.colors. │ │ │ │ │ -00021ea0: 4561 6368 2063 6f6c 6f72 206d 7573 7420 Each color must │ │ │ │ │ -00021eb0: 6265 2061 206e 616d 6520 6672 6f6d 2074 be a name from t │ │ │ │ │ -00021ec0: 6865 2066 6f6c 6c6f 7769 6e67 206c 6973 he following lis │ │ │ │ │ -00021ed0: 743a 0a0a 2020 202a 2062 6c61 636b 0a20 t:.. * black. │ │ │ │ │ -00021ee0: 2020 2a20 626c 7565 0a20 2020 2a20 6772 * blue. * gr │ │ │ │ │ -00021ef0: 6565 6e0a 2020 202a 2063 7961 6e0a 2020 een. * cyan. │ │ │ │ │ -00021f00: 202a 2072 6564 0a20 2020 2a20 6d61 6765 * red. * mage │ │ │ │ │ -00021f10: 6e74 610a 2020 202a 2062 726f 776e 0a20 nta. * brown. │ │ │ │ │ -00021f20: 2020 2a20 6c69 6768 742d 6772 6179 0a20 * light-gray. │ │ │ │ │ -00021f30: 2020 2a20 6461 726b 2d67 7261 790a 2020 * dark-gray. │ │ │ │ │ -00021f40: 202a 206c 6967 6874 2d62 6c75 650a 2020 * light-blue. │ │ │ │ │ -00021f50: 202a 206c 6967 6874 2d67 7265 656e 0a20 * light-green. │ │ │ │ │ -00021f60: 2020 2a20 6c69 6768 742d 6379 616e 0a20 * light-cyan. │ │ │ │ │ -00021f70: 2020 2a20 6c69 6768 742d 7265 640a 2020 * light-red. │ │ │ │ │ -00021f80: 202a 206c 6967 6874 2d6d 6167 656e 7461 * light-magenta │ │ │ │ │ -00021f90: 0a20 2020 2a20 7965 6c6c 6f77 0a20 2020 . * yellow. │ │ │ │ │ -00021fa0: 2a20 7768 6974 650a 0a20 2020 5468 6520 * white.. The │ │ │ │ │ -00021fb0: 6465 6661 756c 7420 6973 2027 6c69 6768 default is 'ligh │ │ │ │ │ -00021fc0: 742d 6772 6179 2f62 6c61 636b 272e 0a0a t-gray/black'... │ │ │ │ │ -00021fd0: 2020 2054 6865 2063 6f6c 6f72 2073 7570 The color sup │ │ │ │ │ -00021fe0: 706f 7274 2073 7570 706f 7274 2076 6172 port support var │ │ │ │ │ -00021ff0: 6965 7320 6672 6f6d 2074 6572 6d69 6e61 ies from termina │ │ │ │ │ -00022000: 6c20 746f 2074 6572 6d69 6e61 6c2e 0a0a l to terminal... │ │ │ │ │ -00022010: 2020 2027 6d6f 7273 6527 2068 6173 206e 'morse' has n │ │ │ │ │ -00022020: 6f20 636f 6c6f 7220 7375 7070 6f72 7420 o color support │ │ │ │ │ -00022030: 6174 2061 6c6c 2e0a 0a20 2020 276d 6461 at all... 'mda │ │ │ │ │ -00022040: 5f74 6578 7427 2063 6f6c 6f72 2073 7570 _text' color sup │ │ │ │ │ -00022050: 706f 7274 2069 7320 6c69 6d69 7465 6420 port is limited │ │ │ │ │ -00022060: 746f 2068 6967 686c 6967 6874 696e 6720 to highlighting │ │ │ │ │ -00022070: 6279 2062 6c61 636b 2f77 6869 7465 0a72 by black/white.r │ │ │ │ │ -00022080: 6576 6572 7361 6c2e 0a0a 2020 2027 636f eversal... 'co │ │ │ │ │ -00022090: 6e73 6f6c 6527 206f 6e20 4152 432c 2045 nsole' on ARC, E │ │ │ │ │ -000220a0: 4d55 2061 6e64 2049 4545 4531 3237 352c MU and IEEE1275, │ │ │ │ │ -000220b0: 2027 7365 7269 616c 5f2a 2720 616e 6420 'serial_*' and │ │ │ │ │ -000220c0: 2773 706b 6d6f 6465 6d27 2061 7265 0a67 'spkmodem' are.g │ │ │ │ │ -000220d0: 6f76 6572 6e65 6420 6279 2074 6572 6d69 overned by termi │ │ │ │ │ -000220e0: 6e66 6f20 616e 6420 7375 7070 6f72 7420 nfo and support │ │ │ │ │ -000220f0: 6f6e 6c79 2038 2063 6f6c 6f72 7320 6966 only 8 colors if │ │ │ │ │ -00022100: 2069 6e20 6d6f 6465 7320 2776 7431 3030 in modes 'vt100 │ │ │ │ │ -00022110: 2d63 6f6c 6f72 270a 2864 6566 6175 6c74 -color'.(default │ │ │ │ │ -00022120: 2066 6f72 2063 6f6e 736f 6c65 206f 6e20 for console on │ │ │ │ │ -00022130: 656d 7529 2c20 2761 7263 2720 2864 6566 emu), 'arc' (def │ │ │ │ │ -00022140: 6175 6c74 2066 6f72 2063 6f6e 736f 6c65 ault for console │ │ │ │ │ -00022150: 206f 6e20 4152 4329 2c0a 2769 6565 6531 on ARC),.'ieee1 │ │ │ │ │ -00022160: 3237 3527 2028 6465 6661 756c 7420 666f 275' (default fo │ │ │ │ │ -00022170: 7220 636f 6e73 6f6c 6520 6f6e 2049 4545 r console on IEE │ │ │ │ │ -00022180: 4531 3237 3529 2e20 2057 6865 6e20 696e E1275). When in │ │ │ │ │ -00022190: 206d 6f64 6520 2776 7431 3030 2720 7468 mode 'vt100' th │ │ │ │ │ -000221a0: 656e 0a74 6865 2063 6f6c 6f72 2073 7570 en.the color sup │ │ │ │ │ -000221b0: 706f 7274 2069 7320 6c69 6d69 7465 6420 port is limited │ │ │ │ │ -000221c0: 746f 2068 6967 686c 6967 6874 696e 6720 to highlighting │ │ │ │ │ -000221d0: 6279 2062 6c61 636b 2f77 6869 7465 2072 by black/white r │ │ │ │ │ -000221e0: 6576 6572 7361 6c2e 0a57 6865 6e20 696e eversal..When in │ │ │ │ │ -000221f0: 206d 6f64 6520 2764 756d 6227 2074 6865 mode 'dumb' the │ │ │ │ │ -00022200: 7265 2069 7320 6e6f 2063 6f6c 6f72 2073 re is no color s │ │ │ │ │ -00022210: 7570 706f 7274 2e0a 0a20 2020 5768 656e upport... When │ │ │ │ │ -00022220: 2063 6f6e 736f 6c65 2073 7570 706f 7274 console support │ │ │ │ │ -00022230: 7320 6e6f 2063 6f6c 6f72 7320 7468 6973 s no colors this │ │ │ │ │ -00022240: 2073 6574 7469 6e67 2069 7320 6967 6e6f setting is igno │ │ │ │ │ -00022250: 7265 642e 2020 5768 656e 0a63 6f6e 736f red. When.conso │ │ │ │ │ -00022260: 6c65 2073 7570 706f 7274 7320 3820 636f le supports 8 co │ │ │ │ │ -00022270: 6c6f 7273 2c20 7468 656e 2074 6865 2063 lors, then the c │ │ │ │ │ -00022280: 6f6c 6f72 7320 6672 6f6d 2074 6865 2073 olors from the s │ │ │ │ │ -00022290: 6563 6f6e 6420 6861 6c66 206f 6620 7468 econd half of th │ │ │ │ │ -000222a0: 650a 7072 6576 696f 7573 206c 6973 7420 e.previous list │ │ │ │ │ -000222b0: 6172 6520 6d61 7070 6564 2074 6f20 7468 are mapped to th │ │ │ │ │ -000222c0: 6520 6d61 7463 6869 6e67 2063 6f6c 6f72 e matching color │ │ │ │ │ -000222d0: 7320 6f66 2066 6972 7374 2068 616c 662e s of first half. │ │ │ │ │ -000222e0: 0a0a 2020 2027 636f 6e73 6f6c 6527 206f .. 'console' o │ │ │ │ │ -000222f0: 6e20 4546 4920 616e 6420 4249 4f53 2061 n EFI and BIOS a │ │ │ │ │ -00022300: 6e64 2027 7667 615f 7465 7874 2720 7375 nd 'vga_text' su │ │ │ │ │ -00022310: 7070 6f72 7420 616c 6c20 3136 2063 6f6c pport all 16 col │ │ │ │ │ -00022320: 6f72 732e 0a0a 2020 2027 6766 7874 6572 ors... 'gfxter │ │ │ │ │ -00022330: 6d27 2073 7570 706f 7274 7320 616c 6c20 m' supports all │ │ │ │ │ -00022340: 3136 2063 6f6c 6f72 7320 616e 6420 776f 16 colors and wo │ │ │ │ │ -00022350: 756c 6420 6265 2074 6865 6f72 6574 6963 uld be theoretic │ │ │ │ │ -00022360: 616c 6c79 0a65 7874 656e 6461 626c 6520 ally.extendable │ │ │ │ │ -00022370: 746f 2073 7570 706f 7274 2077 686f 6c65 to support whole │ │ │ │ │ -00022380: 2072 6762 3234 2070 616c 6574 7465 2062 rgb24 palette b │ │ │ │ │ -00022390: 7574 2063 7572 7265 6e74 6c79 2074 6865 ut currently the │ │ │ │ │ -000223a0: 7265 2069 7320 6e6f 0a63 6f6d 7065 6c6c re is no.compell │ │ │ │ │ -000223b0: 696e 6720 7265 6173 6f6e 2074 6f20 676f ing reason to go │ │ │ │ │ -000223c0: 2062 6579 6f6e 6420 7468 6520 6375 7272 beyond the curr │ │ │ │ │ -000223d0: 656e 7420 3136 2063 6f6c 6f72 732e 0a0a ent 16 colors... │ │ │ │ │ -000223e0: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ -000223f0: 6f2c 2020 4e6f 6465 3a20 636f 6e66 6967 o, Node: config │ │ │ │ │ -00022400: 5f64 6972 6563 746f 7279 2c20 204e 6578 _directory, Nex │ │ │ │ │ -00022410: 743a 2063 6f6e 6669 675f 6669 6c65 2c20 t: config_file, │ │ │ │ │ -00022420: 2050 7265 763a 2063 6f6c 6f72 5f6e 6f72 Prev: color_nor │ │ │ │ │ -00022430: 6d61 6c2c 2020 5570 3a20 5370 6563 6961 mal, Up: Specia │ │ │ │ │ -00022440: 6c20 656e 7669 726f 6e6d 656e 7420 7661 l environment va │ │ │ │ │ -00022450: 7269 6162 6c65 730a 0a31 352e 312e 3720 riables..15.1.7 │ │ │ │ │ -00022460: 636f 6e66 6967 5f64 6972 6563 746f 7279 config_directory │ │ │ │ │ -00022470: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ │ -00022480: 2d2d 2d2d 2d2d 2d2d 0a0a 5468 6973 2076 --------..This v │ │ │ │ │ -00022490: 6172 6961 626c 6520 6973 2061 7574 6f6d ariable is autom │ │ │ │ │ -000224a0: 6174 6963 616c 6c79 2073 6574 2062 7920 atically set by │ │ │ │ │ -000224b0: 4752 5542 2074 6f20 7468 6520 6469 7265 GRUB to the dire │ │ │ │ │ -000224c0: 6374 6f72 7920 7061 7274 206f 660a 6375 ctory part of.cu │ │ │ │ │ -000224d0: 7272 656e 7420 636f 6e66 6967 7572 6174 rrent configurat │ │ │ │ │ -000224e0: 696f 6e20 6669 6c65 206e 616d 6520 282a ion file name (* │ │ │ │ │ -000224f0: 6e6f 7465 2063 6f6e 6669 675f 6669 6c65 note config_file │ │ │ │ │ -00022500: 3a3a 292e 0a0a 1f0a 4669 6c65 3a20 6772 ::).....File: gr │ │ │ │ │ -00022510: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ -00022520: 636f 6e66 6967 5f66 696c 652c 2020 4e65 config_file, Ne │ │ │ │ │ -00022530: 7874 3a20 6465 6275 672c 2020 5072 6576 xt: debug, Prev │ │ │ │ │ -00022540: 3a20 636f 6e66 6967 5f64 6972 6563 746f : config_directo │ │ │ │ │ -00022550: 7279 2c20 2055 703a 2053 7065 6369 616c ry, Up: Special │ │ │ │ │ -00022560: 2065 6e76 6972 6f6e 6d65 6e74 2076 6172 environment var │ │ │ │ │ -00022570: 6961 626c 6573 0a0a 3135 2e31 2e38 2063 iables..15.1.8 c │ │ │ │ │ -00022580: 6f6e 6669 675f 6669 6c65 0a2d 2d2d 2d2d onfig_file.----- │ │ │ │ │ -00022590: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a54 -------------..T │ │ │ │ │ -000225a0: 6869 7320 7661 7269 6162 6c65 2069 7320 his variable is │ │ │ │ │ -000225b0: 6175 746f 6d61 7469 6361 6c6c 7920 7365 automatically se │ │ │ │ │ -000225c0: 7420 6279 2047 5255 4220 746f 2074 6865 t by GRUB to the │ │ │ │ │ -000225d0: 206e 616d 6520 6f66 2063 6f6e 6669 6775 name of configu │ │ │ │ │ -000225e0: 7261 7469 6f6e 0a66 696c 6520 7468 6174 ration.file that │ │ │ │ │ -000225f0: 2069 7320 6265 696e 6720 7072 6f63 6573 is being proces │ │ │ │ │ -00022600: 7365 6420 6279 2063 6f6d 6d61 6e64 7320 sed by commands │ │ │ │ │ -00022610: 2763 6f6e 6669 6766 696c 6527 2028 2a6e 'configfile' (*n │ │ │ │ │ -00022620: 6f74 650a 636f 6e66 6967 6669 6c65 3a3a ote.configfile:: │ │ │ │ │ -00022630: 2920 6f72 2027 6e6f 726d 616c 2720 282a ) or 'normal' (* │ │ │ │ │ -00022640: 6e6f 7465 206e 6f72 6d61 6c3a 3a29 2e20 note normal::). │ │ │ │ │ -00022650: 2049 7420 6973 2072 6573 746f 7265 6420 It is restored │ │ │ │ │ -00022660: 746f 2074 6865 0a70 7265 7669 6f75 7320 to the.previous │ │ │ │ │ -00022670: 7661 6c75 6520 7768 656e 2063 6f6d 6d61 value when comma │ │ │ │ │ -00022680: 6e64 2063 6f6d 706c 6574 6573 2e0a 0a1f nd completes.... │ │ │ │ │ -00022690: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ -000226a0: 2c20 204e 6f64 653a 2064 6562 7567 2c20 , Node: debug, │ │ │ │ │ -000226b0: 204e 6578 743a 2064 6566 6175 6c74 2c20 Next: default, │ │ │ │ │ -000226c0: 2050 7265 763a 2063 6f6e 6669 675f 6669 Prev: config_fi │ │ │ │ │ -000226d0: 6c65 2c20 2055 703a 2053 7065 6369 616c le, Up: Special │ │ │ │ │ -000226e0: 2065 6e76 6972 6f6e 6d65 6e74 2076 6172 environment var │ │ │ │ │ -000226f0: 6961 626c 6573 0a0a 3135 2e31 2e39 2064 iables..15.1.9 d │ │ │ │ │ -00022700: 6562 7567 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d ebug.----------- │ │ │ │ │ -00022710: 2d0a 0a54 6869 7320 7661 7269 6162 6c65 -..This variable │ │ │ │ │ -00022720: 206d 6179 2062 6520 7365 7420 746f 2065 may be set to e │ │ │ │ │ -00022730: 6e61 626c 6520 6465 6275 6767 696e 6720 nable debugging │ │ │ │ │ -00022740: 6f75 7470 7574 2066 726f 6d20 7661 7269 output from vari │ │ │ │ │ -00022750: 6f75 730a 636f 6d70 6f6e 656e 7473 206f ous.components o │ │ │ │ │ -00022760: 6620 4752 5542 2e20 5468 6520 7661 6c75 f GRUB. The valu │ │ │ │ │ -00022770: 6520 6973 2061 206c 6973 7420 6f66 2064 e is a list of d │ │ │ │ │ -00022780: 6562 7567 2066 6163 696c 6974 7920 6e61 ebug facility na │ │ │ │ │ -00022790: 6d65 730a 7365 7061 7261 7465 6420 6279 mes.separated by │ │ │ │ │ -000227a0: 2077 6869 7465 7370 6163 6520 6f72 2027 whitespace or ' │ │ │ │ │ -000227b0: 2c27 2c20 6f72 2027 616c 6c27 2074 6f20 ,', or 'all' to │ │ │ │ │ -000227c0: 656e 6162 6c65 2061 6c6c 2061 7661 696c enable all avail │ │ │ │ │ -000227d0: 6162 6c65 0a64 6562 7567 6769 6e67 206f able.debugging o │ │ │ │ │ -000227e0: 7574 7075 742e 2020 5468 6520 6661 6369 utput. The faci │ │ │ │ │ -000227f0: 6c69 7479 206e 616d 6573 2061 7265 2074 lity names are t │ │ │ │ │ -00022800: 6865 2066 6972 7374 2061 7267 756d 656e he first argumen │ │ │ │ │ -00022810: 7420 746f 0a67 7275 625f 6470 7269 6e74 t to.grub_dprint │ │ │ │ │ -00022820: 662e 2020 436f 6e73 756c 7420 736f 7572 f. Consult sour │ │ │ │ │ -00022830: 6365 2066 6f72 206d 6f72 6520 6465 7461 ce for more deta │ │ │ │ │ -00022840: 696c 732e 0a0a 1f0a 4669 6c65 3a20 6772 ils.....File: gr │ │ │ │ │ -00022850: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ -00022860: 6465 6661 756c 742c 2020 4e65 7874 3a20 default, Next: │ │ │ │ │ -00022870: 6661 6c6c 6261 636b 2c20 2050 7265 763a fallback, Prev: │ │ │ │ │ -00022880: 2064 6562 7567 2c20 2055 703a 2053 7065 debug, Up: Spe │ │ │ │ │ -00022890: 6369 616c 2065 6e76 6972 6f6e 6d65 6e74 cial environment │ │ │ │ │ -000228a0: 2076 6172 6961 626c 6573 0a0a 3135 2e31 variables..15.1 │ │ │ │ │ -000228b0: 2e31 3020 6465 6661 756c 740a 2d2d 2d2d .10 default.---- │ │ │ │ │ -000228c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a49 6620 -----------..If │ │ │ │ │ -000228d0: 7468 6973 2076 6172 6961 626c 6520 6973 this variable is │ │ │ │ │ -000228e0: 2073 6574 2c20 6974 2069 6465 6e74 6966 set, it identif │ │ │ │ │ -000228f0: 6965 7320 6120 6d65 6e75 2065 6e74 7279 ies a menu entry │ │ │ │ │ -00022900: 2074 6861 7420 7368 6f75 6c64 2062 650a that should be. │ │ │ │ │ -00022910: 7365 6c65 6374 6564 2062 7920 6465 6661 selected by defa │ │ │ │ │ -00022920: 756c 742c 2070 6f73 7369 626c 7920 6166 ult, possibly af │ │ │ │ │ -00022930: 7465 7220 6120 7469 6d65 6f75 7420 282a ter a timeout (* │ │ │ │ │ -00022940: 6e6f 7465 2074 696d 656f 7574 3a3a 292e note timeout::). │ │ │ │ │ -00022950: 2020 5468 650a 656e 7472 7920 6d61 7920 The.entry may │ │ │ │ │ -00022960: 6265 2069 6465 6e74 6966 6965 6420 6279 be identified by │ │ │ │ │ -00022970: 206e 756d 6265 7220 2873 7461 7274 696e number (startin │ │ │ │ │ -00022980: 6720 6672 6f6d 2030 2061 7420 6561 6368 g from 0 at each │ │ │ │ │ -00022990: 206c 6576 656c 206f 6620 7468 650a 6869 level of the.hi │ │ │ │ │ -000229a0: 6572 6172 6368 7929 2c20 6279 2074 6974 erarchy), by tit │ │ │ │ │ -000229b0: 6c65 2c20 6f72 2062 7920 6964 2e0a 0a20 le, or by id... │ │ │ │ │ -000229c0: 2020 466f 7220 6578 616d 706c 652c 2069 For example, i │ │ │ │ │ -000229d0: 6620 796f 7520 6861 7665 3a0a 0a6d 656e f you have:..men │ │ │ │ │ -000229e0: 7565 6e74 7279 2027 4578 616d 706c 6520 uentry 'Example │ │ │ │ │ -000229f0: 474e 552f 4c69 6e75 7820 6469 7374 7269 GNU/Linux distri │ │ │ │ │ -00022a00: 6275 7469 6f6e 2720 2d2d 636c 6173 7320 bution' --class │ │ │ │ │ -00022a10: 676e 752d 6c69 6e75 7820 2d2d 6964 2065 gnu-linux --id e │ │ │ │ │ -00022a20: 7861 6d70 6c65 2d67 6e75 2d6c 696e 7578 xample-gnu-linux │ │ │ │ │ -00022a30: 207b 0a09 2e2e 2e0a 7d0a 0a20 2020 7468 {......}.. th │ │ │ │ │ -00022a40: 656e 2079 6f75 2063 616e 206d 616b 6520 en you can make │ │ │ │ │ -00022a50: 7468 6973 2074 6865 2064 6566 6175 6c74 this the default │ │ │ │ │ -00022a60: 2075 7369 6e67 3a0a 0a20 2020 2020 6465 using:.. de │ │ │ │ │ -00022a70: 6661 756c 743d 6578 616d 706c 652d 676e fault=example-gn │ │ │ │ │ -00022a80: 752d 6c69 6e75 780a 0a20 2020 4966 2074 u-linux.. If t │ │ │ │ │ -00022a90: 6865 2065 6e74 7279 2069 7320 696e 2061 he entry is in a │ │ │ │ │ -00022aa0: 2073 7562 6d65 6e75 2c20 7468 656e 2069 submenu, then i │ │ │ │ │ -00022ab0: 7420 6d75 7374 2062 6520 6964 656e 7469 t must be identi │ │ │ │ │ -00022ac0: 6669 6564 2075 7369 6e67 2074 6865 0a6e fied using the.n │ │ │ │ │ -00022ad0: 756d 6265 722c 2074 6974 6c65 2c20 6f72 umber, title, or │ │ │ │ │ -00022ae0: 2069 6420 6f66 2065 6163 6820 6f66 2074 id of each of t │ │ │ │ │ -00022af0: 6865 2073 7562 6d65 6e75 7320 7374 6172 he submenus star │ │ │ │ │ -00022b00: 7469 6e67 2066 726f 6d20 7468 6520 746f ting from the to │ │ │ │ │ -00022b10: 700a 6c65 7665 6c2c 2066 6f6c 6c6f 7765 p.level, followe │ │ │ │ │ -00022b20: 6420 6279 2074 6865 206e 756d 6265 722c d by the number, │ │ │ │ │ -00022b30: 2074 6974 6c65 2c20 6f72 2069 6420 6f66 title, or id of │ │ │ │ │ -00022b40: 2074 6865 206d 656e 7520 656e 7472 7920 the menu entry │ │ │ │ │ -00022b50: 6974 7365 6c66 2c0a 7769 7468 2065 6163 itself,.with eac │ │ │ │ │ -00022b60: 6820 656c 656d 656e 7420 7365 7061 7261 h element separa │ │ │ │ │ -00022b70: 7465 6420 6279 2027 3e27 2e20 2046 6f72 ted by '>'. For │ │ │ │ │ -00022b80: 2065 7861 6d70 6c65 2c20 7461 6b65 2074 example, take t │ │ │ │ │ -00022b90: 6865 2066 6f6c 6c6f 7769 6e67 0a6d 656e he following.men │ │ │ │ │ -00022ba0: 7520 7374 7275 6374 7572 653a 0a0a 2020 u structure:.. │ │ │ │ │ -00022bb0: 2020 2047 4e55 2f48 7572 6420 2d2d 6964 GNU/Hurd --id │ │ │ │ │ -00022bc0: 2067 6e75 2d68 7572 640a 2020 2020 2020 gnu-hurd. │ │ │ │ │ -00022bd0: 2053 7461 6e64 6172 6420 426f 6f74 202d Standard Boot - │ │ │ │ │ -00022be0: 2d69 643d 676e 752d 6875 7264 2d73 7464 -id=gnu-hurd-std │ │ │ │ │ -00022bf0: 0a20 2020 2020 2020 5265 7363 7565 2073 . Rescue s │ │ │ │ │ -00022c00: 6865 6c6c 202d 2d69 643d 676e 752d 6875 hell --id=gnu-hu │ │ │ │ │ -00022c10: 7264 2d72 6573 6375 650a 2020 2020 204f rd-rescue. O │ │ │ │ │ -00022c20: 7468 6572 2070 6c61 7466 6f72 6d73 202d ther platforms - │ │ │ │ │ -00022c30: 2d69 643d 6f74 6865 720a 2020 2020 2020 -id=other. │ │ │ │ │ -00022c40: 204d 696e 6978 202d 2d69 643d 6d69 6e69 Minix --id=mini │ │ │ │ │ -00022c50: 780a 2020 2020 2020 2020 2056 6572 7369 x. Versi │ │ │ │ │ -00022c60: 6f6e 2033 2e34 2e30 202d 2d69 643d 6d69 on 3.4.0 --id=mi │ │ │ │ │ -00022c70: 6e69 782d 332e 342e 300a 2020 2020 2020 nix-3.4.0. │ │ │ │ │ -00022c80: 2020 2056 6572 7369 6f6e 2033 2e33 2e30 Version 3.3.0 │ │ │ │ │ -00022c90: 202d 2d69 643d 6d69 6e69 782d 332e 332e --id=minix-3.3. │ │ │ │ │ -00022ca0: 300a 2020 2020 2020 2047 5255 4220 496e 0. GRUB In │ │ │ │ │ -00022cb0: 7661 6465 7273 202d 2d69 643d 6772 7562 vaders --id=grub │ │ │ │ │ -00022cc0: 2d69 6e76 6164 6572 730a 0a20 2020 5468 -invaders.. Th │ │ │ │ │ -00022cd0: 6520 6d6f 7265 2072 6563 656e 7420 7265 e more recent re │ │ │ │ │ -00022ce0: 6c65 6173 6520 6f66 204d 696e 6978 2077 lease of Minix w │ │ │ │ │ -00022cf0: 6f75 6c64 2074 6865 6e20 6265 2069 6465 ould then be ide │ │ │ │ │ -00022d00: 6e74 6966 6965 6420 6173 2027 4f74 6865 ntified as 'Othe │ │ │ │ │ -00022d10: 720a 706c 6174 666f 726d 733e 4d69 6e69 r.platforms>Mini │ │ │ │ │ -00022d20: 783e 5665 7273 696f 6e20 332e 342e 3027 x>Version 3.4.0' │ │ │ │ │ -00022d30: 2c20 6f72 2061 7320 2731 3e30 3e30 272c , or as '1>0>0', │ │ │ │ │ -00022d40: 206f 7220 6173 0a27 6f74 6865 723e 6d69 or as.'other>mi │ │ │ │ │ -00022d50: 6e69 783e 6d69 6e69 782d 332e 342e 3027 nix>minix-3.4.0' │ │ │ │ │ -00022d60: 2e0a 0a20 2020 5468 6973 2076 6172 6961 ... This varia │ │ │ │ │ -00022d70: 626c 6520 6973 206f 6674 656e 2073 6574 ble is often set │ │ │ │ │ -00022d80: 2062 7920 2747 5255 425f 4445 4641 554c by 'GRUB_DEFAUL │ │ │ │ │ -00022d90: 5427 2028 2a6e 6f74 6520 5369 6d70 6c65 T' (*note Simple │ │ │ │ │ -00022da0: 0a63 6f6e 6669 6775 7261 7469 6f6e 3a3a .configuration:: │ │ │ │ │ -00022db0: 292c 2027 6772 7562 2d73 6574 2d64 6566 ), 'grub-set-def │ │ │ │ │ -00022dc0: 6175 6c74 272c 206f 7220 2767 7275 622d ault', or 'grub- │ │ │ │ │ -00022dd0: 7265 626f 6f74 272e 0a0a 1f0a 4669 6c65 reboot'.....File │ │ │ │ │ -00022de0: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ -00022df0: 6465 3a20 6661 6c6c 6261 636b 2c20 204e de: fallback, N │ │ │ │ │ -00022e00: 6578 743a 2067 6678 6d6f 6465 2c20 2050 ext: gfxmode, P │ │ │ │ │ -00022e10: 7265 763a 2064 6566 6175 6c74 2c20 2055 rev: default, U │ │ │ │ │ -00022e20: 703a 2053 7065 6369 616c 2065 6e76 6972 p: Special envir │ │ │ │ │ -00022e30: 6f6e 6d65 6e74 2076 6172 6961 626c 6573 onment variables │ │ │ │ │ -00022e40: 0a0a 3135 2e31 2e31 3120 6661 6c6c 6261 ..15.1.11 fallba │ │ │ │ │ -00022e50: 636b 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ck.------------- │ │ │ │ │ -00022e60: 2d2d 2d0a 0a49 6620 7468 6973 2076 6172 ---..If this var │ │ │ │ │ -00022e70: 6961 626c 6520 6973 2073 6574 2c20 6974 iable is set, it │ │ │ │ │ -00022e80: 2069 6465 6e74 6966 6965 7320 6120 6d65 identifies a me │ │ │ │ │ -00022e90: 6e75 2065 6e74 7279 2074 6861 7420 7368 nu entry that sh │ │ │ │ │ -00022ea0: 6f75 6c64 2062 650a 7365 6c65 6374 6564 ould be.selected │ │ │ │ │ -00022eb0: 2069 6620 7468 6520 6465 6661 756c 7420 if the default │ │ │ │ │ -00022ec0: 6d65 6e75 2065 6e74 7279 2066 6169 6c73 menu entry fails │ │ │ │ │ -00022ed0: 2074 6f20 626f 6f74 2e20 2045 6e74 7269 to boot. Entri │ │ │ │ │ -00022ee0: 6573 2061 7265 0a69 6465 6e74 6966 6965 es are.identifie │ │ │ │ │ -00022ef0: 6420 696e 2074 6865 2073 616d 6520 7761 d in the same wa │ │ │ │ │ -00022f00: 7920 6173 2066 6f72 2027 6465 6661 756c y as for 'defaul │ │ │ │ │ -00022f10: 7427 2028 2a6e 6f74 6520 6465 6661 756c t' (*note defaul │ │ │ │ │ -00022f20: 743a 3a29 2e0a 0a1f 0a46 696c 653a 2067 t::).....File: g │ │ │ │ │ -00022f30: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ -00022f40: 2067 6678 6d6f 6465 2c20 204e 6578 743a gfxmode, Next: │ │ │ │ │ -00022f50: 2067 6678 7061 796c 6f61 642c 2020 5072 gfxpayload, Pr │ │ │ │ │ -00022f60: 6576 3a20 6661 6c6c 6261 636b 2c20 2055 ev: fallback, U │ │ │ │ │ -00022f70: 703a 2053 7065 6369 616c 2065 6e76 6972 p: Special envir │ │ │ │ │ -00022f80: 6f6e 6d65 6e74 2076 6172 6961 626c 6573 onment variables │ │ │ │ │ -00022f90: 0a0a 3135 2e31 2e31 3220 6766 786d 6f64 ..15.1.12 gfxmod │ │ │ │ │ -00022fa0: 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d e.-------------- │ │ │ │ │ -00022fb0: 2d0a 0a49 6620 7468 6973 2076 6172 6961 -..If this varia │ │ │ │ │ -00022fc0: 626c 6520 6973 2073 6574 2c20 6974 2073 ble is set, it s │ │ │ │ │ -00022fd0: 6574 7320 7468 6520 7265 736f 6c75 7469 ets the resoluti │ │ │ │ │ -00022fe0: 6f6e 2075 7365 6420 6f6e 2074 6865 2027 on used on the ' │ │ │ │ │ -00022ff0: 6766 7874 6572 6d27 0a67 7261 7068 6963 gfxterm'.graphic │ │ │ │ │ -00023000: 616c 2074 6572 6d69 6e61 6c2e 2020 4e6f al terminal. No │ │ │ │ │ -00023010: 7465 2074 6861 7420 796f 7520 6361 6e20 te that you can │ │ │ │ │ -00023020: 6f6e 6c79 2075 7365 206d 6f64 6573 2077 only use modes w │ │ │ │ │ -00023030: 6869 6368 2079 6f75 720a 6772 6170 6869 hich your.graphi │ │ │ │ │ -00023040: 6373 2063 6172 6420 7375 7070 6f72 7473 cs card supports │ │ │ │ │ -00023050: 2076 6961 2056 4553 4120 4249 4f53 2045 via VESA BIOS E │ │ │ │ │ -00023060: 7874 656e 7369 6f6e 7320 2856 4245 292c xtensions (VBE), │ │ │ │ │ -00023070: 2073 6f20 666f 7220 6578 616d 706c 650a so for example. │ │ │ │ │ -00023080: 6e61 7469 7665 204c 4344 2070 616e 656c native LCD panel │ │ │ │ │ -00023090: 2072 6573 6f6c 7574 696f 6e73 206d 6179 resolutions may │ │ │ │ │ -000230a0: 206e 6f74 2062 6520 6176 6169 6c61 626c not be availabl │ │ │ │ │ -000230b0: 652e 2020 5468 6520 6465 6661 756c 7420 e. The default │ │ │ │ │ -000230c0: 6973 0a27 6175 746f 272c 2077 6869 6368 is.'auto', which │ │ │ │ │ -000230d0: 2073 656c 6563 7473 2061 2070 6c61 7466 selects a platf │ │ │ │ │ -000230e0: 6f72 6d2d 7370 6563 6966 6963 2064 6566 orm-specific def │ │ │ │ │ -000230f0: 6175 6c74 2074 6861 7420 7368 6f75 6c64 ault that should │ │ │ │ │ -00023100: 206c 6f6f 6b0a 7265 6173 6f6e 6162 6c65 look.reasonable │ │ │ │ │ -00023110: 2e20 2053 7570 706f 7274 6564 206d 6f64 . Supported mod │ │ │ │ │ -00023120: 6573 2063 616e 2062 6520 6c69 7374 6564 es can be listed │ │ │ │ │ -00023130: 2062 7920 2776 6964 656f 696e 666f 2720 by 'videoinfo' │ │ │ │ │ -00023140: 636f 6d6d 616e 6420 696e 0a47 5255 422e command in.GRUB. │ │ │ │ │ -00023150: 0a0a 2020 2054 6865 2072 6573 6f6c 7574 .. The resolut │ │ │ │ │ -00023160: 696f 6e20 6d61 7920 6265 2073 7065 6369 ion may be speci │ │ │ │ │ -00023170: 6669 6564 2061 7320 6120 7365 7175 656e fied as a sequen │ │ │ │ │ -00023180: 6365 206f 6620 6f6e 6520 6f72 206d 6f72 ce of one or mor │ │ │ │ │ -00023190: 6520 6d6f 6465 732c 0a73 6570 6172 6174 e modes,.separat │ │ │ │ │ -000231a0: 6564 2062 7920 636f 6d6d 6173 2028 272c ed by commas (', │ │ │ │ │ -000231b0: 2729 206f 7220 7365 6d69 636f 6c6f 6e73 ') or semicolons │ │ │ │ │ -000231c0: 2028 273b 2729 3b20 6561 6368 2077 696c (';'); each wil │ │ │ │ │ -000231d0: 6c20 6265 2074 7269 6564 2069 6e0a 7475 l be tried in.tu │ │ │ │ │ -000231e0: 726e 2075 6e74 696c 206f 6e65 2069 7320 rn until one is │ │ │ │ │ -000231f0: 666f 756e 642e 2020 4561 6368 206d 6f64 found. Each mod │ │ │ │ │ -00023200: 6520 7368 6f75 6c64 2062 6520 6569 7468 e should be eith │ │ │ │ │ -00023210: 6572 2027 6175 746f 272c 0a27 5749 4454 er 'auto',.'WIDT │ │ │ │ │ -00023220: 4878 4845 4947 4854 272c 206f 7220 2757 HxHEIGHT', or 'W │ │ │ │ │ -00023230: 4944 5448 7848 4549 4748 5478 4445 5054 IDTHxHEIGHTxDEPT │ │ │ │ │ -00023240: 4827 2e0a 0a1f 0a46 696c 653a 2067 7275 H'.....File: gru │ │ │ │ │ -00023250: 622e 696e 666f 2c20 204e 6f64 653a 2067 b.info, Node: g │ │ │ │ │ -00023260: 6678 7061 796c 6f61 642c 2020 4e65 7874 fxpayload, Next │ │ │ │ │ -00023270: 3a20 6766 7874 6572 6d5f 666f 6e74 2c20 : gfxterm_font, │ │ │ │ │ -00023280: 2050 7265 763a 2067 6678 6d6f 6465 2c20 Prev: gfxmode, │ │ │ │ │ -00023290: 2055 703a 2053 7065 6369 616c 2065 6e76 Up: Special env │ │ │ │ │ -000232a0: 6972 6f6e 6d65 6e74 2076 6172 6961 626c ironment variabl │ │ │ │ │ -000232b0: 6573 0a0a 3135 2e31 2e31 3320 6766 7870 es..15.1.13 gfxp │ │ │ │ │ -000232c0: 6179 6c6f 6164 0a2d 2d2d 2d2d 2d2d 2d2d ayload.--------- │ │ │ │ │ -000232d0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a49 6620 7468 ---------..If th │ │ │ │ │ -000232e0: 6973 2076 6172 6961 626c 6520 6973 2073 is variable is s │ │ │ │ │ -000232f0: 6574 2c20 6974 2063 6f6e 7472 6f6c 7320 et, it controls │ │ │ │ │ -00023300: 7468 6520 7669 6465 6f20 6d6f 6465 2069 the video mode i │ │ │ │ │ -00023310: 6e20 7768 6963 6820 7468 6520 4c69 6e75 n which the Linu │ │ │ │ │ -00023320: 780a 6b65 726e 656c 2073 7461 7274 7320 x.kernel starts │ │ │ │ │ -00023330: 7570 2c20 7265 706c 6163 696e 6720 7468 up, replacing th │ │ │ │ │ -00023340: 6520 2776 6761 3d27 2062 6f6f 7420 6f70 e 'vga=' boot op │ │ │ │ │ -00023350: 7469 6f6e 2028 2a6e 6f74 6520 6c69 6e75 tion (*note linu │ │ │ │ │ -00023360: 783a 3a29 2e20 2049 740a 6d61 7920 6265 x::). It.may be │ │ │ │ │ -00023370: 2073 6574 2074 6f20 2774 6578 7427 2074 set to 'text' t │ │ │ │ │ -00023380: 6f20 666f 7263 6520 7468 6520 4c69 6e75 o force the Linu │ │ │ │ │ -00023390: 7820 6b65 726e 656c 2074 6f20 626f 6f74 x kernel to boot │ │ │ │ │ -000233a0: 2069 6e20 6e6f 726d 616c 2074 6578 740a in normal text. │ │ │ │ │ -000233b0: 6d6f 6465 2c20 276b 6565 7027 2074 6f20 mode, 'keep' to │ │ │ │ │ -000233c0: 7072 6573 6572 7665 2074 6865 2067 7261 preserve the gra │ │ │ │ │ -000233d0: 7068 6963 7320 6d6f 6465 2073 6574 2075 phics mode set u │ │ │ │ │ -000233e0: 7369 6e67 2027 6766 786d 6f64 6527 2c20 sing 'gfxmode', │ │ │ │ │ -000233f0: 6f72 2061 6e79 0a6f 6620 7468 6520 7065 or any.of the pe │ │ │ │ │ -00023400: 726d 6974 7465 6420 7661 6c75 6573 2066 rmitted values f │ │ │ │ │ -00023410: 6f72 2027 6766 786d 6f64 6527 2074 6f20 or 'gfxmode' to │ │ │ │ │ -00023420: 7365 7420 6120 7061 7274 6963 756c 6172 set a particular │ │ │ │ │ -00023430: 2067 7261 7068 6963 7320 6d6f 6465 0a28 graphics mode.( │ │ │ │ │ -00023440: 2a6e 6f74 6520 6766 786d 6f64 653a 3a29 *note gfxmode::) │ │ │ │ │ -00023450: 2e0a 0a20 2020 4465 7065 6e64 696e 6720 ... Depending │ │ │ │ │ -00023460: 6f6e 2079 6f75 7220 6b65 726e 656c 2c20 on your kernel, │ │ │ │ │ -00023470: 796f 7572 2064 6973 7472 6962 7574 696f your distributio │ │ │ │ │ -00023480: 6e2c 2079 6f75 7220 6772 6170 6869 6373 n, your graphics │ │ │ │ │ -00023490: 2063 6172 642c 2061 6e64 0a74 6865 2070 card, and.the p │ │ │ │ │ -000234a0: 6861 7365 206f 6620 7468 6520 6d6f 6f6e hase of the moon │ │ │ │ │ -000234b0: 2c20 6e6f 7465 2074 6861 7420 7573 696e , note that usin │ │ │ │ │ -000234c0: 6720 7468 6973 206f 7074 696f 6e20 6d61 g this option ma │ │ │ │ │ -000234d0: 7920 6361 7573 6520 474e 552f 4c69 6e75 y cause GNU/Linu │ │ │ │ │ -000234e0: 780a 746f 2073 7566 6665 7220 6672 6f6d x.to suffer from │ │ │ │ │ -000234f0: 2076 6172 696f 7573 2064 6973 706c 6179 various display │ │ │ │ │ -00023500: 2070 726f 626c 656d 732c 2070 6172 7469 problems, parti │ │ │ │ │ -00023510: 6375 6c61 726c 7920 6475 7269 6e67 2074 cularly during t │ │ │ │ │ -00023520: 6865 2065 6172 6c79 0a70 6172 7420 6f66 he early.part of │ │ │ │ │ -00023530: 2074 6865 2062 6f6f 7420 7365 7175 656e the boot sequen │ │ │ │ │ -00023540: 6365 2e20 2049 6620 796f 7520 6861 7665 ce. If you have │ │ │ │ │ -00023550: 2070 726f 626c 656d 732c 2073 6574 2074 problems, set t │ │ │ │ │ -00023560: 6869 7320 7661 7269 6162 6c65 2074 6f0a his variable to. │ │ │ │ │ -00023570: 2774 6578 7427 2061 6e64 2047 5255 4220 'text' and GRUB │ │ │ │ │ -00023580: 7769 6c6c 2074 656c 6c20 4c69 6e75 7820 will tell Linux │ │ │ │ │ -00023590: 746f 2062 6f6f 7420 696e 206e 6f72 6d61 to boot in norma │ │ │ │ │ -000235a0: 6c20 7465 7874 206d 6f64 652e 0a0a 2020 l text mode... │ │ │ │ │ -000235b0: 2054 6865 2064 6566 6175 6c74 2069 7320 The default is │ │ │ │ │ -000235c0: 706c 6174 666f 726d 2d73 7065 6369 6669 platform-specifi │ │ │ │ │ -000235d0: 632e 2020 4f6e 2070 6c61 7466 6f72 6d73 c. On platforms │ │ │ │ │ -000235e0: 2077 6974 6820 6120 6e61 7469 7665 2074 with a native t │ │ │ │ │ -000235f0: 6578 740a 6d6f 6465 2028 7375 6368 2061 ext.mode (such a │ │ │ │ │ -00023600: 7320 5043 2042 494f 5320 706c 6174 666f s PC BIOS platfo │ │ │ │ │ -00023610: 726d 7329 2c20 7468 6520 6465 6661 756c rms), the defaul │ │ │ │ │ -00023620: 7420 6973 2027 7465 7874 272e 2020 4f74 t is 'text'. Ot │ │ │ │ │ -00023630: 6865 7277 6973 6520 7468 650a 6465 6661 herwise the.defa │ │ │ │ │ -00023640: 756c 7420 6d61 7920 6265 2027 6175 746f ult may be 'auto │ │ │ │ │ -00023650: 2720 6f72 2061 2073 7065 6369 6669 6320 ' or a specific │ │ │ │ │ -00023660: 7669 6465 6f20 6d6f 6465 2e0a 0a20 2020 video mode... │ │ │ │ │ -00023670: 5468 6973 2076 6172 6961 626c 6520 6973 This variable is │ │ │ │ │ -00023680: 206f 6674 656e 2073 6574 2062 7920 2747 often set by 'G │ │ │ │ │ -00023690: 5255 425f 4746 5850 4159 4c4f 4144 5f4c RUB_GFXPAYLOAD_L │ │ │ │ │ -000236a0: 494e 5558 2720 282a 6e6f 7465 2053 696d INUX' (*note Sim │ │ │ │ │ -000236b0: 706c 650a 636f 6e66 6967 7572 6174 696f ple.configuratio │ │ │ │ │ -000236c0: 6e3a 3a29 2e0a 0a1f 0a46 696c 653a 2067 n::).....File: g │ │ │ │ │ -000236d0: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ -000236e0: 2067 6678 7465 726d 5f66 6f6e 742c 2020 gfxterm_font, │ │ │ │ │ -000236f0: 4e65 7874 3a20 6772 7562 5f63 7075 2c20 Next: grub_cpu, │ │ │ │ │ -00023700: 2050 7265 763a 2067 6678 7061 796c 6f61 Prev: gfxpayloa │ │ │ │ │ -00023710: 642c 2020 5570 3a20 5370 6563 6961 6c20 d, Up: Special │ │ │ │ │ -00023720: 656e 7669 726f 6e6d 656e 7420 7661 7269 environment vari │ │ │ │ │ -00023730: 6162 6c65 730a 0a31 352e 312e 3134 2067 ables..15.1.14 g │ │ │ │ │ -00023740: 6678 7465 726d 5f66 6f6e 740a 2d2d 2d2d fxterm_font.---- │ │ │ │ │ -00023750: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00023760: 0a0a 4966 2074 6869 7320 7661 7269 6162 ..If this variab │ │ │ │ │ -00023770: 6c65 2069 7320 7365 742c 2069 7420 6e61 le is set, it na │ │ │ │ │ -00023780: 6d65 7320 6120 666f 6e74 2074 6f20 7573 mes a font to us │ │ │ │ │ -00023790: 6520 666f 7220 7465 7874 206f 6e20 7468 e for text on th │ │ │ │ │ -000237a0: 650a 2767 6678 7465 726d 2720 6772 6170 e.'gfxterm' grap │ │ │ │ │ -000237b0: 6869 6361 6c20 7465 726d 696e 616c 2e20 hical terminal. │ │ │ │ │ -000237c0: 204f 7468 6572 7769 7365 2c20 2767 6678 Otherwise, 'gfx │ │ │ │ │ -000237d0: 7465 726d 2720 6d61 7920 7573 6520 616e term' may use an │ │ │ │ │ -000237e0: 790a 6176 6169 6c61 626c 6520 666f 6e74 y.available font │ │ │ │ │ -000237f0: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ -00023800: 696e 666f 2c20 204e 6f64 653a 2067 7275 info, Node: gru │ │ │ │ │ -00023810: 625f 6370 752c 2020 4e65 7874 3a20 6772 b_cpu, Next: gr │ │ │ │ │ -00023820: 7562 5f70 6c61 7466 6f72 6d2c 2020 5072 ub_platform, Pr │ │ │ │ │ -00023830: 6576 3a20 6766 7874 6572 6d5f 666f 6e74 ev: gfxterm_font │ │ │ │ │ -00023840: 2c20 2055 703a 2053 7065 6369 616c 2065 , Up: Special e │ │ │ │ │ -00023850: 6e76 6972 6f6e 6d65 6e74 2076 6172 6961 nvironment varia │ │ │ │ │ -00023860: 626c 6573 0a0a 3135 2e31 2e31 3520 6772 bles..15.1.15 gr │ │ │ │ │ -00023870: 7562 5f63 7075 0a2d 2d2d 2d2d 2d2d 2d2d ub_cpu.--------- │ │ │ │ │ -00023880: 2d2d 2d2d 2d2d 2d0a 0a49 6e20 6e6f 726d -------..In norm │ │ │ │ │ -00023890: 616c 206d 6f64 6520 282a 6e6f 7465 206e al mode (*note n │ │ │ │ │ -000238a0: 6f72 6d61 6c3a 3a29 2c20 4752 5542 2073 ormal::), GRUB s │ │ │ │ │ -000238b0: 6574 7320 7468 6520 2767 7275 625f 6370 ets the 'grub_cp │ │ │ │ │ -000238c0: 7527 2076 6172 6961 626c 6520 746f 0a74 u' variable to.t │ │ │ │ │ -000238d0: 6865 2043 5055 2074 7970 6520 666f 7220 he CPU type for │ │ │ │ │ -000238e0: 7768 6963 6820 4752 5542 2077 6173 2062 which GRUB was b │ │ │ │ │ -000238f0: 7569 6c74 2028 652e 672e 2020 2769 3338 uilt (e.g. 'i38 │ │ │ │ │ -00023900: 3627 206f 7220 2770 6f77 6572 7063 2729 6' or 'powerpc') │ │ │ │ │ -00023910: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ -00023920: 696e 666f 2c20 204e 6f64 653a 2067 7275 info, Node: gru │ │ │ │ │ -00023930: 625f 706c 6174 666f 726d 2c20 204e 6578 b_platform, Nex │ │ │ │ │ -00023940: 743a 2069 636f 6e64 6972 2c20 2050 7265 t: icondir, Pre │ │ │ │ │ -00023950: 763a 2067 7275 625f 6370 752c 2020 5570 v: grub_cpu, Up │ │ │ │ │ -00023960: 3a20 5370 6563 6961 6c20 656e 7669 726f : Special enviro │ │ │ │ │ -00023970: 6e6d 656e 7420 7661 7269 6162 6c65 730a nment variables. │ │ │ │ │ -00023980: 0a31 352e 312e 3136 2067 7275 625f 706c .15.1.16 grub_pl │ │ │ │ │ -00023990: 6174 666f 726d 0a2d 2d2d 2d2d 2d2d 2d2d atform.--------- │ │ │ │ │ -000239a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 496e ------------..In │ │ │ │ │ -000239b0: 206e 6f72 6d61 6c20 6d6f 6465 2028 2a6e normal mode (*n │ │ │ │ │ -000239c0: 6f74 6520 6e6f 726d 616c 3a3a 292c 2047 ote normal::), G │ │ │ │ │ -000239d0: 5255 4220 7365 7473 2074 6865 2027 6772 RUB sets the 'gr │ │ │ │ │ -000239e0: 7562 5f70 6c61 7466 6f72 6d27 2076 6172 ub_platform' var │ │ │ │ │ -000239f0: 6961 626c 650a 746f 2074 6865 2070 6c61 iable.to the pla │ │ │ │ │ -00023a00: 7466 6f72 6d20 666f 7220 7768 6963 6820 tform for which │ │ │ │ │ -00023a10: 4752 5542 2077 6173 2062 7569 6c74 2028 GRUB was built ( │ │ │ │ │ -00023a20: 652e 672e 2020 2770 6327 206f 7220 2765 e.g. 'pc' or 'e │ │ │ │ │ -00023a30: 6669 2729 2e0a 0a1f 0a46 696c 653a 2067 fi').....File: g │ │ │ │ │ -00023a40: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ -00023a50: 2069 636f 6e64 6972 2c20 204e 6578 743a icondir, Next: │ │ │ │ │ -00023a60: 206c 616e 672c 2020 5072 6576 3a20 6772 lang, Prev: gr │ │ │ │ │ -00023a70: 7562 5f70 6c61 7466 6f72 6d2c 2020 5570 ub_platform, Up │ │ │ │ │ -00023a80: 3a20 5370 6563 6961 6c20 656e 7669 726f : Special enviro │ │ │ │ │ -00023a90: 6e6d 656e 7420 7661 7269 6162 6c65 730a nment variables. │ │ │ │ │ -00023aa0: 0a31 352e 312e 3137 2069 636f 6e64 6972 .15.1.17 icondir │ │ │ │ │ -00023ab0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ │ -00023ac0: 0a0a 4966 2074 6869 7320 7661 7269 6162 ..If this variab │ │ │ │ │ -00023ad0: 6c65 2069 7320 7365 742c 2069 7420 6e61 le is set, it na │ │ │ │ │ -00023ae0: 6d65 7320 6120 6469 7265 6374 6f72 7920 mes a directory │ │ │ │ │ -00023af0: 696e 2077 6869 6368 2074 6865 2047 5255 in which the GRU │ │ │ │ │ -00023b00: 420a 6772 6170 6869 6361 6c20 6d65 6e75 B.graphical menu │ │ │ │ │ -00023b10: 2073 686f 756c 6420 6c6f 6f6b 2066 6f72 should look for │ │ │ │ │ -00023b20: 2069 636f 6e73 2061 6674 6572 206c 6f6f icons after loo │ │ │ │ │ -00023b30: 6b69 6e67 2069 6e20 7468 6520 7468 656d king in the them │ │ │ │ │ -00023b40: 6527 730a 2769 636f 6e73 2720 6469 7265 e's.'icons' dire │ │ │ │ │ -00023b50: 6374 6f72 792e 2020 2a4e 6f74 6520 5468 ctory. *Note Th │ │ │ │ │ -00023b60: 656d 6520 6669 6c65 2066 6f72 6d61 743a eme file format: │ │ │ │ │ -00023b70: 3a2e 0a0a 1f0a 4669 6c65 3a20 6772 7562 :.....File: grub │ │ │ │ │ -00023b80: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 6c61 .info, Node: la │ │ │ │ │ -00023b90: 6e67 2c20 204e 6578 743a 206c 6f63 616c ng, Next: local │ │ │ │ │ -00023ba0: 655f 6469 722c 2020 5072 6576 3a20 6963 e_dir, Prev: ic │ │ │ │ │ -00023bb0: 6f6e 6469 722c 2020 5570 3a20 5370 6563 ondir, Up: Spec │ │ │ │ │ -00023bc0: 6961 6c20 656e 7669 726f 6e6d 656e 7420 ial environment │ │ │ │ │ -00023bd0: 7661 7269 6162 6c65 730a 0a31 352e 312e variables..15.1. │ │ │ │ │ -00023be0: 3138 206c 616e 670a 2d2d 2d2d 2d2d 2d2d 18 lang.-------- │ │ │ │ │ -00023bf0: 2d2d 2d2d 0a0a 4966 2074 6869 7320 7661 ----..If this va │ │ │ │ │ -00023c00: 7269 6162 6c65 2069 7320 7365 742c 2069 riable is set, i │ │ │ │ │ -00023c10: 7420 6e61 6d65 7320 7468 6520 6c61 6e67 t names the lang │ │ │ │ │ -00023c20: 7561 6765 2063 6f64 6520 7468 6174 2074 uage code that t │ │ │ │ │ -00023c30: 6865 2027 6765 7474 6578 7427 0a63 6f6d he 'gettext'.com │ │ │ │ │ -00023c40: 6d61 6e64 2028 2a6e 6f74 6520 6765 7474 mand (*note gett │ │ │ │ │ -00023c50: 6578 743a 3a29 2075 7365 7320 746f 2074 ext::) uses to t │ │ │ │ │ -00023c60: 7261 6e73 6c61 7465 2073 7472 696e 6773 ranslate strings │ │ │ │ │ -00023c70: 2e20 2046 6f72 2065 7861 6d70 6c65 2c0a . For example,. │ │ │ │ │ -00023c80: 4672 656e 6368 2077 6f75 6c64 2062 6520 French would be │ │ │ │ │ -00023c90: 6e61 6d65 6420 6173 2027 6672 272c 2061 named as 'fr', a │ │ │ │ │ -00023ca0: 6e64 2053 696d 706c 6966 6965 6420 4368 nd Simplified Ch │ │ │ │ │ -00023cb0: 696e 6573 6520 6173 2027 7a68 5f43 4e27 inese as 'zh_CN' │ │ │ │ │ -00023cc0: 2e0a 0a20 2020 2767 7275 622d 6d6b 636f ... 'grub-mkco │ │ │ │ │ -00023cd0: 6e66 6967 2720 282a 6e6f 7465 2053 696d nfig' (*note Sim │ │ │ │ │ -00023ce0: 706c 6520 636f 6e66 6967 7572 6174 696f ple configuratio │ │ │ │ │ -00023cf0: 6e3a 3a29 2077 696c 6c20 7472 7920 746f n::) will try to │ │ │ │ │ -00023d00: 2073 6574 2061 0a72 6561 736f 6e61 626c set a.reasonabl │ │ │ │ │ -00023d10: 6520 6465 6661 756c 7420 666f 7220 7468 e default for th │ │ │ │ │ -00023d20: 6973 2076 6172 6961 626c 6520 6261 7365 is variable base │ │ │ │ │ -00023d30: 6420 6f6e 2074 6865 2073 7973 7465 6d20 d on the system │ │ │ │ │ -00023d40: 6c6f 6361 6c65 2e0a 0a1f 0a46 696c 653a locale.....File: │ │ │ │ │ -00023d50: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ -00023d60: 653a 206c 6f63 616c 655f 6469 722c 2020 e: locale_dir, │ │ │ │ │ -00023d70: 4e65 7874 3a20 6d65 6e75 5f63 6f6c 6f72 Next: menu_color │ │ │ │ │ -00023d80: 5f68 6967 686c 6967 6874 2c20 2050 7265 _highlight, Pre │ │ │ │ │ -00023d90: 763a 206c 616e 672c 2020 5570 3a20 5370 v: lang, Up: Sp │ │ │ │ │ -00023da0: 6563 6961 6c20 656e 7669 726f 6e6d 656e ecial environmen │ │ │ │ │ -00023db0: 7420 7661 7269 6162 6c65 730a 0a31 352e t variables..15. │ │ │ │ │ -00023dc0: 312e 3139 206c 6f63 616c 655f 6469 720a 1.19 locale_dir. │ │ │ │ │ +00021c60: 2d2d 2d2d 0a0a 5468 6973 2076 6172 6961 ----..This varia │ │ │ │ │ +00021c70: 626c 6520 636f 6e74 6169 6e73 2074 6865 ble contains the │ │ │ │ │ +00021c80: 2022 6869 6768 6c69 6768 7422 2066 6f72 "highlight" for │ │ │ │ │ +00021c90: 6567 726f 756e 6420 616e 6420 6261 636b eground and back │ │ │ │ │ +00021ca0: 6772 6f75 6e64 0a74 6572 6d69 6e61 6c20 ground.terminal │ │ │ │ │ +00021cb0: 636f 6c6f 7273 2c20 7365 7061 7261 7465 colors, separate │ │ │ │ │ +00021cc0: 6420 6279 2061 2073 6c61 7368 2028 272f d by a slash ('/ │ │ │ │ │ +00021cd0: 2729 2e20 2053 6574 7469 6e67 2074 6869 '). Setting thi │ │ │ │ │ +00021ce0: 7320 7661 7269 6162 6c65 0a63 6861 6e67 s variable.chang │ │ │ │ │ +00021cf0: 6573 2074 686f 7365 2063 6f6c 6f72 732e es those colors. │ │ │ │ │ +00021d00: 2020 466f 7220 7468 6520 6176 6169 6c61 For the availa │ │ │ │ │ +00021d10: 626c 6520 636f 6c6f 7220 6e61 6d65 732c ble color names, │ │ │ │ │ +00021d20: 202a 6e6f 7465 0a63 6f6c 6f72 5f6e 6f72 *note.color_nor │ │ │ │ │ +00021d30: 6d61 6c3a 3a2e 0a0a 2020 2054 6865 2064 mal::... The d │ │ │ │ │ +00021d40: 6566 6175 6c74 2069 7320 2762 6c61 636b efault is 'black │ │ │ │ │ +00021d50: 2f6c 6967 6874 2d67 7261 7927 2e0a 0a1f /light-gray'.... │ │ │ │ │ +00021d60: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ +00021d70: 2c20 204e 6f64 653a 2063 6f6c 6f72 5f6e , Node: color_n │ │ │ │ │ +00021d80: 6f72 6d61 6c2c 2020 4e65 7874 3a20 636f ormal, Next: co │ │ │ │ │ +00021d90: 6e66 6967 5f64 6972 6563 746f 7279 2c20 nfig_directory, │ │ │ │ │ +00021da0: 2050 7265 763a 2063 6f6c 6f72 5f68 6967 Prev: color_hig │ │ │ │ │ +00021db0: 686c 6967 6874 2c20 2055 703a 2053 7065 hlight, Up: Spe │ │ │ │ │ +00021dc0: 6369 616c 2065 6e76 6972 6f6e 6d65 6e74 cial environment │ │ │ │ │ +00021dd0: 2076 6172 6961 626c 6573 0a0a 3135 2e31 variables..15.1 │ │ │ │ │ +00021de0: 2e36 2063 6f6c 6f72 5f6e 6f72 6d61 6c0a .6 color_normal. │ │ │ │ │ +00021df0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ +00021e00: 2d2d 2d0a 0a54 6869 7320 7661 7269 6162 ---..This variab │ │ │ │ │ +00021e10: 6c65 2063 6f6e 7461 696e 7320 7468 6520 le contains the │ │ │ │ │ +00021e20: 226e 6f72 6d61 6c22 2066 6f72 6567 726f "normal" foregro │ │ │ │ │ +00021e30: 756e 6420 616e 6420 6261 636b 6772 6f75 und and backgrou │ │ │ │ │ +00021e40: 6e64 2074 6572 6d69 6e61 6c0a 636f 6c6f nd terminal.colo │ │ │ │ │ +00021e50: 7273 2c20 7365 7061 7261 7465 6420 6279 rs, separated by │ │ │ │ │ +00021e60: 2061 2073 6c61 7368 2028 272f 2729 2e20 a slash ('/'). │ │ │ │ │ +00021e70: 2053 6574 7469 6e67 2074 6869 7320 7661 Setting this va │ │ │ │ │ +00021e80: 7269 6162 6c65 2063 6861 6e67 6573 2074 riable changes t │ │ │ │ │ +00021e90: 686f 7365 0a63 6f6c 6f72 732e 2020 4561 hose.colors. Ea │ │ │ │ │ +00021ea0: 6368 2063 6f6c 6f72 206d 7573 7420 6265 ch color must be │ │ │ │ │ +00021eb0: 2061 206e 616d 6520 6672 6f6d 2074 6865 a name from the │ │ │ │ │ +00021ec0: 2066 6f6c 6c6f 7769 6e67 206c 6973 743a following list: │ │ │ │ │ +00021ed0: 0a0a 2020 202a 2062 6c61 636b 0a20 2020 .. * black. │ │ │ │ │ +00021ee0: 2a20 626c 7565 0a20 2020 2a20 6772 6565 * blue. * gree │ │ │ │ │ +00021ef0: 6e0a 2020 202a 2063 7961 6e0a 2020 202a n. * cyan. * │ │ │ │ │ +00021f00: 2072 6564 0a20 2020 2a20 6d61 6765 6e74 red. * magent │ │ │ │ │ +00021f10: 610a 2020 202a 2062 726f 776e 0a20 2020 a. * brown. │ │ │ │ │ +00021f20: 2a20 6c69 6768 742d 6772 6179 0a20 2020 * light-gray. │ │ │ │ │ +00021f30: 2a20 6461 726b 2d67 7261 790a 2020 202a * dark-gray. * │ │ │ │ │ +00021f40: 206c 6967 6874 2d62 6c75 650a 2020 202a light-blue. * │ │ │ │ │ +00021f50: 206c 6967 6874 2d67 7265 656e 0a20 2020 light-green. │ │ │ │ │ +00021f60: 2a20 6c69 6768 742d 6379 616e 0a20 2020 * light-cyan. │ │ │ │ │ +00021f70: 2a20 6c69 6768 742d 7265 640a 2020 202a * light-red. * │ │ │ │ │ +00021f80: 206c 6967 6874 2d6d 6167 656e 7461 0a20 light-magenta. │ │ │ │ │ +00021f90: 2020 2a20 7965 6c6c 6f77 0a20 2020 2a20 * yellow. * │ │ │ │ │ +00021fa0: 7768 6974 650a 0a20 2020 5468 6520 6465 white.. The de │ │ │ │ │ +00021fb0: 6661 756c 7420 6973 2027 6c69 6768 742d fault is 'light- │ │ │ │ │ +00021fc0: 6772 6179 2f62 6c61 636b 272e 0a0a 2020 gray/black'... │ │ │ │ │ +00021fd0: 2054 6865 2063 6f6c 6f72 2073 7570 706f The color suppo │ │ │ │ │ +00021fe0: 7274 2073 7570 706f 7274 2076 6172 6965 rt support varie │ │ │ │ │ +00021ff0: 7320 6672 6f6d 2074 6572 6d69 6e61 6c20 s from terminal │ │ │ │ │ +00022000: 746f 2074 6572 6d69 6e61 6c2e 0a0a 2020 to terminal... │ │ │ │ │ +00022010: 2027 6d6f 7273 6527 2068 6173 206e 6f20 'morse' has no │ │ │ │ │ +00022020: 636f 6c6f 7220 7375 7070 6f72 7420 6174 color support at │ │ │ │ │ +00022030: 2061 6c6c 2e0a 0a20 2020 276d 6461 5f74 all... 'mda_t │ │ │ │ │ +00022040: 6578 7427 2063 6f6c 6f72 2073 7570 706f ext' color suppo │ │ │ │ │ +00022050: 7274 2069 7320 6c69 6d69 7465 6420 746f rt is limited to │ │ │ │ │ +00022060: 2068 6967 686c 6967 6874 696e 6720 6279 highlighting by │ │ │ │ │ +00022070: 2062 6c61 636b 2f77 6869 7465 0a72 6576 black/white.rev │ │ │ │ │ +00022080: 6572 7361 6c2e 0a0a 2020 2027 636f 6e73 ersal... 'cons │ │ │ │ │ +00022090: 6f6c 6527 206f 6e20 4152 432c 2045 4d55 ole' on ARC, EMU │ │ │ │ │ +000220a0: 2061 6e64 2049 4545 4531 3237 352c 2027 and IEEE1275, ' │ │ │ │ │ +000220b0: 7365 7269 616c 5f2a 2720 616e 6420 2773 serial_*' and 's │ │ │ │ │ +000220c0: 706b 6d6f 6465 6d27 2061 7265 0a67 6f76 pkmodem' are.gov │ │ │ │ │ +000220d0: 6572 6e65 6420 6279 2074 6572 6d69 6e66 erned by terminf │ │ │ │ │ +000220e0: 6f20 616e 6420 7375 7070 6f72 7420 6f6e o and support on │ │ │ │ │ +000220f0: 6c79 2038 2063 6f6c 6f72 7320 6966 2069 ly 8 colors if i │ │ │ │ │ +00022100: 6e20 6d6f 6465 7320 2776 7431 3030 2d63 n modes 'vt100-c │ │ │ │ │ +00022110: 6f6c 6f72 270a 2864 6566 6175 6c74 2066 olor'.(default f │ │ │ │ │ +00022120: 6f72 2063 6f6e 736f 6c65 206f 6e20 656d or console on em │ │ │ │ │ +00022130: 7529 2c20 2761 7263 2720 2864 6566 6175 u), 'arc' (defau │ │ │ │ │ +00022140: 6c74 2066 6f72 2063 6f6e 736f 6c65 206f lt for console o │ │ │ │ │ +00022150: 6e20 4152 4329 2c0a 2769 6565 6531 3237 n ARC),.'ieee127 │ │ │ │ │ +00022160: 3527 2028 6465 6661 756c 7420 666f 7220 5' (default for │ │ │ │ │ +00022170: 636f 6e73 6f6c 6520 6f6e 2049 4545 4531 console on IEEE1 │ │ │ │ │ +00022180: 3237 3529 2e20 2057 6865 6e20 696e 206d 275). When in m │ │ │ │ │ +00022190: 6f64 6520 2776 7431 3030 2720 7468 656e ode 'vt100' then │ │ │ │ │ +000221a0: 0a74 6865 2063 6f6c 6f72 2073 7570 706f .the color suppo │ │ │ │ │ +000221b0: 7274 2069 7320 6c69 6d69 7465 6420 746f rt is limited to │ │ │ │ │ +000221c0: 2068 6967 686c 6967 6874 696e 6720 6279 highlighting by │ │ │ │ │ +000221d0: 2062 6c61 636b 2f77 6869 7465 2072 6576 black/white rev │ │ │ │ │ +000221e0: 6572 7361 6c2e 0a57 6865 6e20 696e 206d ersal..When in m │ │ │ │ │ +000221f0: 6f64 6520 2764 756d 6227 2074 6865 7265 ode 'dumb' there │ │ │ │ │ +00022200: 2069 7320 6e6f 2063 6f6c 6f72 2073 7570 is no color sup │ │ │ │ │ +00022210: 706f 7274 2e0a 0a20 2020 5768 656e 2063 port... When c │ │ │ │ │ +00022220: 6f6e 736f 6c65 2073 7570 706f 7274 7320 onsole supports │ │ │ │ │ +00022230: 6e6f 2063 6f6c 6f72 7320 7468 6973 2073 no colors this s │ │ │ │ │ +00022240: 6574 7469 6e67 2069 7320 6967 6e6f 7265 etting is ignore │ │ │ │ │ +00022250: 642e 2020 5768 656e 0a63 6f6e 736f 6c65 d. When.console │ │ │ │ │ +00022260: 2073 7570 706f 7274 7320 3820 636f 6c6f supports 8 colo │ │ │ │ │ +00022270: 7273 2c20 7468 656e 2074 6865 2063 6f6c rs, then the col │ │ │ │ │ +00022280: 6f72 7320 6672 6f6d 2074 6865 2073 6563 ors from the sec │ │ │ │ │ +00022290: 6f6e 6420 6861 6c66 206f 6620 7468 650a ond half of the. │ │ │ │ │ +000222a0: 7072 6576 696f 7573 206c 6973 7420 6172 previous list ar │ │ │ │ │ +000222b0: 6520 6d61 7070 6564 2074 6f20 7468 6520 e mapped to the │ │ │ │ │ +000222c0: 6d61 7463 6869 6e67 2063 6f6c 6f72 7320 matching colors │ │ │ │ │ +000222d0: 6f66 2066 6972 7374 2068 616c 662e 0a0a of first half... │ │ │ │ │ +000222e0: 2020 2027 636f 6e73 6f6c 6527 206f 6e20 'console' on │ │ │ │ │ +000222f0: 4546 4920 616e 6420 4249 4f53 2061 6e64 EFI and BIOS and │ │ │ │ │ +00022300: 2027 7667 615f 7465 7874 2720 7375 7070 'vga_text' supp │ │ │ │ │ +00022310: 6f72 7420 616c 6c20 3136 2063 6f6c 6f72 ort all 16 color │ │ │ │ │ +00022320: 732e 0a0a 2020 2027 6766 7874 6572 6d27 s... 'gfxterm' │ │ │ │ │ +00022330: 2073 7570 706f 7274 7320 616c 6c20 3136 supports all 16 │ │ │ │ │ +00022340: 2063 6f6c 6f72 7320 616e 6420 776f 756c colors and woul │ │ │ │ │ +00022350: 6420 6265 2074 6865 6f72 6574 6963 616c d be theoretical │ │ │ │ │ +00022360: 6c79 0a65 7874 656e 6461 626c 6520 746f ly.extendable to │ │ │ │ │ +00022370: 2073 7570 706f 7274 2077 686f 6c65 2072 support whole r │ │ │ │ │ +00022380: 6762 3234 2070 616c 6574 7465 2062 7574 gb24 palette but │ │ │ │ │ +00022390: 2063 7572 7265 6e74 6c79 2074 6865 7265 currently there │ │ │ │ │ +000223a0: 2069 7320 6e6f 0a63 6f6d 7065 6c6c 696e is no.compellin │ │ │ │ │ +000223b0: 6720 7265 6173 6f6e 2074 6f20 676f 2062 g reason to go b │ │ │ │ │ +000223c0: 6579 6f6e 6420 7468 6520 6375 7272 656e eyond the curren │ │ │ │ │ +000223d0: 7420 3136 2063 6f6c 6f72 732e 0a0a 1f0a t 16 colors..... │ │ │ │ │ +000223e0: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ +000223f0: 2020 4e6f 6465 3a20 636f 6e66 6967 5f64 Node: config_d │ │ │ │ │ +00022400: 6972 6563 746f 7279 2c20 204e 6578 743a irectory, Next: │ │ │ │ │ +00022410: 2063 6f6e 6669 675f 6669 6c65 2c20 2050 config_file, P │ │ │ │ │ +00022420: 7265 763a 2063 6f6c 6f72 5f6e 6f72 6d61 rev: color_norma │ │ │ │ │ +00022430: 6c2c 2020 5570 3a20 5370 6563 6961 6c20 l, Up: Special │ │ │ │ │ +00022440: 656e 7669 726f 6e6d 656e 7420 7661 7269 environment vari │ │ │ │ │ +00022450: 6162 6c65 730a 0a31 352e 312e 3720 636f ables..15.1.7 co │ │ │ │ │ +00022460: 6e66 6967 5f64 6972 6563 746f 7279 0a2d nfig_directory.- │ │ │ │ │ +00022470: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ +00022480: 2d2d 2d2d 2d2d 0a0a 5468 6973 2076 6172 ------..This var │ │ │ │ │ +00022490: 6961 626c 6520 6973 2061 7574 6f6d 6174 iable is automat │ │ │ │ │ +000224a0: 6963 616c 6c79 2073 6574 2062 7920 4752 ically set by GR │ │ │ │ │ +000224b0: 5542 2074 6f20 7468 6520 6469 7265 6374 UB to the direct │ │ │ │ │ +000224c0: 6f72 7920 7061 7274 206f 660a 6375 7272 ory part of.curr │ │ │ │ │ +000224d0: 656e 7420 636f 6e66 6967 7572 6174 696f ent configuratio │ │ │ │ │ +000224e0: 6e20 6669 6c65 206e 616d 6520 282a 6e6f n file name (*no │ │ │ │ │ +000224f0: 7465 2063 6f6e 6669 675f 6669 6c65 3a3a te config_file:: │ │ │ │ │ +00022500: 292e 0a0a 1f0a 4669 6c65 3a20 6772 7562 ).....File: grub │ │ │ │ │ +00022510: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 636f .info, Node: co │ │ │ │ │ +00022520: 6e66 6967 5f66 696c 652c 2020 4e65 7874 nfig_file, Next │ │ │ │ │ +00022530: 3a20 6465 6275 672c 2020 5072 6576 3a20 : debug, Prev: │ │ │ │ │ +00022540: 636f 6e66 6967 5f64 6972 6563 746f 7279 config_directory │ │ │ │ │ +00022550: 2c20 2055 703a 2053 7065 6369 616c 2065 , Up: Special e │ │ │ │ │ +00022560: 6e76 6972 6f6e 6d65 6e74 2076 6172 6961 nvironment varia │ │ │ │ │ +00022570: 626c 6573 0a0a 3135 2e31 2e38 2063 6f6e bles..15.1.8 con │ │ │ │ │ +00022580: 6669 675f 6669 6c65 0a2d 2d2d 2d2d 2d2d fig_file.------- │ │ │ │ │ +00022590: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a54 6869 -----------..Thi │ │ │ │ │ +000225a0: 7320 7661 7269 6162 6c65 2069 7320 6175 s variable is au │ │ │ │ │ +000225b0: 746f 6d61 7469 6361 6c6c 7920 7365 7420 tomatically set │ │ │ │ │ +000225c0: 6279 2047 5255 4220 746f 2074 6865 206e by GRUB to the n │ │ │ │ │ +000225d0: 616d 6520 6f66 2063 6f6e 6669 6775 7261 ame of configura │ │ │ │ │ +000225e0: 7469 6f6e 0a66 696c 6520 7468 6174 2069 tion.file that i │ │ │ │ │ +000225f0: 7320 6265 696e 6720 7072 6f63 6573 7365 s being processe │ │ │ │ │ +00022600: 6420 6279 2063 6f6d 6d61 6e64 7320 2763 d by commands 'c │ │ │ │ │ +00022610: 6f6e 6669 6766 696c 6527 2028 2a6e 6f74 onfigfile' (*not │ │ │ │ │ +00022620: 650a 636f 6e66 6967 6669 6c65 3a3a 2920 e.configfile::) │ │ │ │ │ +00022630: 6f72 2027 6e6f 726d 616c 2720 282a 6e6f or 'normal' (*no │ │ │ │ │ +00022640: 7465 206e 6f72 6d61 6c3a 3a29 2e20 2049 te normal::). I │ │ │ │ │ +00022650: 7420 6973 2072 6573 746f 7265 6420 746f t is restored to │ │ │ │ │ +00022660: 2074 6865 0a70 7265 7669 6f75 7320 7661 the.previous va │ │ │ │ │ +00022670: 6c75 6520 7768 656e 2063 6f6d 6d61 6e64 lue when command │ │ │ │ │ +00022680: 2063 6f6d 706c 6574 6573 2e0a 0a1f 0a46 completes.....F │ │ │ │ │ +00022690: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ +000226a0: 204e 6f64 653a 2064 6562 7567 2c20 204e Node: debug, N │ │ │ │ │ +000226b0: 6578 743a 2064 6566 6175 6c74 2c20 2050 ext: default, P │ │ │ │ │ +000226c0: 7265 763a 2063 6f6e 6669 675f 6669 6c65 rev: config_file │ │ │ │ │ +000226d0: 2c20 2055 703a 2053 7065 6369 616c 2065 , Up: Special e │ │ │ │ │ +000226e0: 6e76 6972 6f6e 6d65 6e74 2076 6172 6961 nvironment varia │ │ │ │ │ +000226f0: 626c 6573 0a0a 3135 2e31 2e39 2064 6562 bles..15.1.9 deb │ │ │ │ │ +00022700: 7567 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ug.------------. │ │ │ │ │ +00022710: 0a54 6869 7320 7661 7269 6162 6c65 206d .This variable m │ │ │ │ │ +00022720: 6179 2062 6520 7365 7420 746f 2065 6e61 ay be set to ena │ │ │ │ │ +00022730: 626c 6520 6465 6275 6767 696e 6720 6f75 ble debugging ou │ │ │ │ │ +00022740: 7470 7574 2066 726f 6d20 7661 7269 6f75 tput from variou │ │ │ │ │ +00022750: 730a 636f 6d70 6f6e 656e 7473 206f 6620 s.components of │ │ │ │ │ +00022760: 4752 5542 2e20 5468 6520 7661 6c75 6520 GRUB. The value │ │ │ │ │ +00022770: 6973 2061 206c 6973 7420 6f66 2064 6562 is a list of deb │ │ │ │ │ +00022780: 7567 2066 6163 696c 6974 7920 6e61 6d65 ug facility name │ │ │ │ │ +00022790: 730a 7365 7061 7261 7465 6420 6279 2077 s.separated by w │ │ │ │ │ +000227a0: 6869 7465 7370 6163 6520 6f72 2027 2c27 hitespace or ',' │ │ │ │ │ +000227b0: 2c20 6f72 2027 616c 6c27 2074 6f20 656e , or 'all' to en │ │ │ │ │ +000227c0: 6162 6c65 2061 6c6c 2061 7661 696c 6162 able all availab │ │ │ │ │ +000227d0: 6c65 0a64 6562 7567 6769 6e67 206f 7574 le.debugging out │ │ │ │ │ +000227e0: 7075 742e 2020 5468 6520 6661 6369 6c69 put. The facili │ │ │ │ │ +000227f0: 7479 206e 616d 6573 2061 7265 2074 6865 ty names are the │ │ │ │ │ +00022800: 2066 6972 7374 2061 7267 756d 656e 7420 first argument │ │ │ │ │ +00022810: 746f 0a67 7275 625f 6470 7269 6e74 662e to.grub_dprintf. │ │ │ │ │ +00022820: 2020 436f 6e73 756c 7420 736f 7572 6365 Consult source │ │ │ │ │ +00022830: 2066 6f72 206d 6f72 6520 6465 7461 696c for more detail │ │ │ │ │ +00022840: 732e 0a0a 1f0a 4669 6c65 3a20 6772 7562 s.....File: grub │ │ │ │ │ +00022850: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 6465 .info, Node: de │ │ │ │ │ +00022860: 6661 756c 742c 2020 4e65 7874 3a20 6661 fault, Next: fa │ │ │ │ │ +00022870: 6c6c 6261 636b 2c20 2050 7265 763a 2064 llback, Prev: d │ │ │ │ │ +00022880: 6562 7567 2c20 2055 703a 2053 7065 6369 ebug, Up: Speci │ │ │ │ │ +00022890: 616c 2065 6e76 6972 6f6e 6d65 6e74 2076 al environment v │ │ │ │ │ +000228a0: 6172 6961 626c 6573 0a0a 3135 2e31 2e31 ariables..15.1.1 │ │ │ │ │ +000228b0: 3020 6465 6661 756c 740a 2d2d 2d2d 2d2d 0 default.------ │ │ │ │ │ +000228c0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a49 6620 7468 ---------..If th │ │ │ │ │ +000228d0: 6973 2076 6172 6961 626c 6520 6973 2073 is variable is s │ │ │ │ │ +000228e0: 6574 2c20 6974 2069 6465 6e74 6966 6965 et, it identifie │ │ │ │ │ +000228f0: 7320 6120 6d65 6e75 2065 6e74 7279 2074 s a menu entry t │ │ │ │ │ +00022900: 6861 7420 7368 6f75 6c64 2062 650a 7365 hat should be.se │ │ │ │ │ +00022910: 6c65 6374 6564 2062 7920 6465 6661 756c lected by defaul │ │ │ │ │ +00022920: 742c 2070 6f73 7369 626c 7920 6166 7465 t, possibly afte │ │ │ │ │ +00022930: 7220 6120 7469 6d65 6f75 7420 282a 6e6f r a timeout (*no │ │ │ │ │ +00022940: 7465 2074 696d 656f 7574 3a3a 292e 2020 te timeout::). │ │ │ │ │ +00022950: 5468 650a 656e 7472 7920 6d61 7920 6265 The.entry may be │ │ │ │ │ +00022960: 2069 6465 6e74 6966 6965 6420 6279 206e identified by n │ │ │ │ │ +00022970: 756d 6265 7220 2873 7461 7274 696e 6720 umber (starting │ │ │ │ │ +00022980: 6672 6f6d 2030 2061 7420 6561 6368 206c from 0 at each l │ │ │ │ │ +00022990: 6576 656c 206f 6620 7468 650a 6869 6572 evel of the.hier │ │ │ │ │ +000229a0: 6172 6368 7929 2c20 6279 2074 6974 6c65 archy), by title │ │ │ │ │ +000229b0: 2c20 6f72 2062 7920 6964 2e0a 0a20 2020 , or by id... │ │ │ │ │ +000229c0: 466f 7220 6578 616d 706c 652c 2069 6620 For example, if │ │ │ │ │ +000229d0: 796f 7520 6861 7665 3a0a 0a6d 656e 7565 you have:..menue │ │ │ │ │ +000229e0: 6e74 7279 2027 4578 616d 706c 6520 474e ntry 'Example GN │ │ │ │ │ +000229f0: 552f 4c69 6e75 7820 6469 7374 7269 6275 U/Linux distribu │ │ │ │ │ +00022a00: 7469 6f6e 2720 2d2d 636c 6173 7320 676e tion' --class gn │ │ │ │ │ +00022a10: 752d 6c69 6e75 7820 2d2d 6964 2065 7861 u-linux --id exa │ │ │ │ │ +00022a20: 6d70 6c65 2d67 6e75 2d6c 696e 7578 207b mple-gnu-linux { │ │ │ │ │ +00022a30: 0a09 2e2e 2e0a 7d0a 0a20 2020 7468 656e ......}.. then │ │ │ │ │ +00022a40: 2079 6f75 2063 616e 206d 616b 6520 7468 you can make th │ │ │ │ │ +00022a50: 6973 2074 6865 2064 6566 6175 6c74 2075 is the default u │ │ │ │ │ +00022a60: 7369 6e67 3a0a 0a20 2020 2020 6465 6661 sing:.. defa │ │ │ │ │ +00022a70: 756c 743d 6578 616d 706c 652d 676e 752d ult=example-gnu- │ │ │ │ │ +00022a80: 6c69 6e75 780a 0a20 2020 4966 2074 6865 linux.. If the │ │ │ │ │ +00022a90: 2065 6e74 7279 2069 7320 696e 2061 2073 entry is in a s │ │ │ │ │ +00022aa0: 7562 6d65 6e75 2c20 7468 656e 2069 7420 ubmenu, then it │ │ │ │ │ +00022ab0: 6d75 7374 2062 6520 6964 656e 7469 6669 must be identifi │ │ │ │ │ +00022ac0: 6564 2075 7369 6e67 2074 6865 0a6e 756d ed using the.num │ │ │ │ │ +00022ad0: 6265 722c 2074 6974 6c65 2c20 6f72 2069 ber, title, or i │ │ │ │ │ +00022ae0: 6420 6f66 2065 6163 6820 6f66 2074 6865 d of each of the │ │ │ │ │ +00022af0: 2073 7562 6d65 6e75 7320 7374 6172 7469 submenus starti │ │ │ │ │ +00022b00: 6e67 2066 726f 6d20 7468 6520 746f 700a ng from the top. │ │ │ │ │ +00022b10: 6c65 7665 6c2c 2066 6f6c 6c6f 7765 6420 level, followed │ │ │ │ │ +00022b20: 6279 2074 6865 206e 756d 6265 722c 2074 by the number, t │ │ │ │ │ +00022b30: 6974 6c65 2c20 6f72 2069 6420 6f66 2074 itle, or id of t │ │ │ │ │ +00022b40: 6865 206d 656e 7520 656e 7472 7920 6974 he menu entry it │ │ │ │ │ +00022b50: 7365 6c66 2c0a 7769 7468 2065 6163 6820 self,.with each │ │ │ │ │ +00022b60: 656c 656d 656e 7420 7365 7061 7261 7465 element separate │ │ │ │ │ +00022b70: 6420 6279 2027 3e27 2e20 2046 6f72 2065 d by '>'. For e │ │ │ │ │ +00022b80: 7861 6d70 6c65 2c20 7461 6b65 2074 6865 xample, take the │ │ │ │ │ +00022b90: 2066 6f6c 6c6f 7769 6e67 0a6d 656e 7520 following.menu │ │ │ │ │ +00022ba0: 7374 7275 6374 7572 653a 0a0a 2020 2020 structure:.. │ │ │ │ │ +00022bb0: 2047 4e55 2f48 7572 6420 2d2d 6964 2067 GNU/Hurd --id g │ │ │ │ │ +00022bc0: 6e75 2d68 7572 640a 2020 2020 2020 2053 nu-hurd. S │ │ │ │ │ +00022bd0: 7461 6e64 6172 6420 426f 6f74 202d 2d69 tandard Boot --i │ │ │ │ │ +00022be0: 643d 676e 752d 6875 7264 2d73 7464 0a20 d=gnu-hurd-std. │ │ │ │ │ +00022bf0: 2020 2020 2020 5265 7363 7565 2073 6865 Rescue she │ │ │ │ │ +00022c00: 6c6c 202d 2d69 643d 676e 752d 6875 7264 ll --id=gnu-hurd │ │ │ │ │ +00022c10: 2d72 6573 6375 650a 2020 2020 204f 7468 -rescue. Oth │ │ │ │ │ +00022c20: 6572 2070 6c61 7466 6f72 6d73 202d 2d69 er platforms --i │ │ │ │ │ +00022c30: 643d 6f74 6865 720a 2020 2020 2020 204d d=other. M │ │ │ │ │ +00022c40: 696e 6978 202d 2d69 643d 6d69 6e69 780a inix --id=minix. │ │ │ │ │ +00022c50: 2020 2020 2020 2020 2056 6572 7369 6f6e Version │ │ │ │ │ +00022c60: 2033 2e34 2e30 202d 2d69 643d 6d69 6e69 3.4.0 --id=mini │ │ │ │ │ +00022c70: 782d 332e 342e 300a 2020 2020 2020 2020 x-3.4.0. │ │ │ │ │ +00022c80: 2056 6572 7369 6f6e 2033 2e33 2e30 202d Version 3.3.0 - │ │ │ │ │ +00022c90: 2d69 643d 6d69 6e69 782d 332e 332e 300a -id=minix-3.3.0. │ │ │ │ │ +00022ca0: 2020 2020 2020 2047 5255 4220 496e 7661 GRUB Inva │ │ │ │ │ +00022cb0: 6465 7273 202d 2d69 643d 6772 7562 2d69 ders --id=grub-i │ │ │ │ │ +00022cc0: 6e76 6164 6572 730a 0a20 2020 5468 6520 nvaders.. The │ │ │ │ │ +00022cd0: 6d6f 7265 2072 6563 656e 7420 7265 6c65 more recent rele │ │ │ │ │ +00022ce0: 6173 6520 6f66 204d 696e 6978 2077 6f75 ase of Minix wou │ │ │ │ │ +00022cf0: 6c64 2074 6865 6e20 6265 2069 6465 6e74 ld then be ident │ │ │ │ │ +00022d00: 6966 6965 6420 6173 2027 4f74 6865 720a ified as 'Other. │ │ │ │ │ +00022d10: 706c 6174 666f 726d 733e 4d69 6e69 783e platforms>Minix> │ │ │ │ │ +00022d20: 5665 7273 696f 6e20 332e 342e 3027 2c20 Version 3.4.0', │ │ │ │ │ +00022d30: 6f72 2061 7320 2731 3e30 3e30 272c 206f or as '1>0>0', o │ │ │ │ │ +00022d40: 7220 6173 0a27 6f74 6865 723e 6d69 6e69 r as.'other>mini │ │ │ │ │ +00022d50: 783e 6d69 6e69 782d 332e 342e 3027 2e0a x>minix-3.4.0'.. │ │ │ │ │ +00022d60: 0a20 2020 5468 6973 2076 6172 6961 626c . This variabl │ │ │ │ │ +00022d70: 6520 6973 206f 6674 656e 2073 6574 2062 e is often set b │ │ │ │ │ +00022d80: 7920 2747 5255 425f 4445 4641 554c 5427 y 'GRUB_DEFAULT' │ │ │ │ │ +00022d90: 2028 2a6e 6f74 6520 5369 6d70 6c65 0a63 (*note Simple.c │ │ │ │ │ +00022da0: 6f6e 6669 6775 7261 7469 6f6e 3a3a 292c onfiguration::), │ │ │ │ │ +00022db0: 2027 6772 7562 2d73 6574 2d64 6566 6175 'grub-set-defau │ │ │ │ │ +00022dc0: 6c74 272c 206f 7220 2767 7275 622d 7265 lt', or 'grub-re │ │ │ │ │ +00022dd0: 626f 6f74 272e 0a0a 1f0a 4669 6c65 3a20 boot'.....File: │ │ │ │ │ +00022de0: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ +00022df0: 3a20 6661 6c6c 6261 636b 2c20 204e 6578 : fallback, Nex │ │ │ │ │ +00022e00: 743a 2067 6678 6d6f 6465 2c20 2050 7265 t: gfxmode, Pre │ │ │ │ │ +00022e10: 763a 2064 6566 6175 6c74 2c20 2055 703a v: default, Up: │ │ │ │ │ +00022e20: 2053 7065 6369 616c 2065 6e76 6972 6f6e Special environ │ │ │ │ │ +00022e30: 6d65 6e74 2076 6172 6961 626c 6573 0a0a ment variables.. │ │ │ │ │ +00022e40: 3135 2e31 2e31 3120 6661 6c6c 6261 636b 15.1.11 fallback │ │ │ │ │ +00022e50: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ │ +00022e60: 2d0a 0a49 6620 7468 6973 2076 6172 6961 -..If this varia │ │ │ │ │ +00022e70: 626c 6520 6973 2073 6574 2c20 6974 2069 ble is set, it i │ │ │ │ │ +00022e80: 6465 6e74 6966 6965 7320 6120 6d65 6e75 dentifies a menu │ │ │ │ │ +00022e90: 2065 6e74 7279 2074 6861 7420 7368 6f75 entry that shou │ │ │ │ │ +00022ea0: 6c64 2062 650a 7365 6c65 6374 6564 2069 ld be.selected i │ │ │ │ │ +00022eb0: 6620 7468 6520 6465 6661 756c 7420 6d65 f the default me │ │ │ │ │ +00022ec0: 6e75 2065 6e74 7279 2066 6169 6c73 2074 nu entry fails t │ │ │ │ │ +00022ed0: 6f20 626f 6f74 2e20 2045 6e74 7269 6573 o boot. Entries │ │ │ │ │ +00022ee0: 2061 7265 0a69 6465 6e74 6966 6965 6420 are.identified │ │ │ │ │ +00022ef0: 696e 2074 6865 2073 616d 6520 7761 7920 in the same way │ │ │ │ │ +00022f00: 6173 2066 6f72 2027 6465 6661 756c 7427 as for 'default' │ │ │ │ │ +00022f10: 2028 2a6e 6f74 6520 6465 6661 756c 743a (*note default: │ │ │ │ │ +00022f20: 3a29 2e0a 0a1f 0a46 696c 653a 2067 7275 :).....File: gru │ │ │ │ │ +00022f30: 622e 696e 666f 2c20 204e 6f64 653a 2067 b.info, Node: g │ │ │ │ │ +00022f40: 6678 6d6f 6465 2c20 204e 6578 743a 2067 fxmode, Next: g │ │ │ │ │ +00022f50: 6678 7061 796c 6f61 642c 2020 5072 6576 fxpayload, Prev │ │ │ │ │ +00022f60: 3a20 6661 6c6c 6261 636b 2c20 2055 703a : fallback, Up: │ │ │ │ │ +00022f70: 2053 7065 6369 616c 2065 6e76 6972 6f6e Special environ │ │ │ │ │ +00022f80: 6d65 6e74 2076 6172 6961 626c 6573 0a0a ment variables.. │ │ │ │ │ +00022f90: 3135 2e31 2e31 3220 6766 786d 6f64 650a 15.1.12 gfxmode. │ │ │ │ │ +00022fa0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ +00022fb0: 0a49 6620 7468 6973 2076 6172 6961 626c .If this variabl │ │ │ │ │ +00022fc0: 6520 6973 2073 6574 2c20 6974 2073 6574 e is set, it set │ │ │ │ │ +00022fd0: 7320 7468 6520 7265 736f 6c75 7469 6f6e s the resolution │ │ │ │ │ +00022fe0: 2075 7365 6420 6f6e 2074 6865 2027 6766 used on the 'gf │ │ │ │ │ +00022ff0: 7874 6572 6d27 0a67 7261 7068 6963 616c xterm'.graphical │ │ │ │ │ +00023000: 2074 6572 6d69 6e61 6c2e 2020 4e6f 7465 terminal. Note │ │ │ │ │ +00023010: 2074 6861 7420 796f 7520 6361 6e20 6f6e that you can on │ │ │ │ │ +00023020: 6c79 2075 7365 206d 6f64 6573 2077 6869 ly use modes whi │ │ │ │ │ +00023030: 6368 2079 6f75 720a 6772 6170 6869 6373 ch your.graphics │ │ │ │ │ +00023040: 2063 6172 6420 7375 7070 6f72 7473 2076 card supports v │ │ │ │ │ +00023050: 6961 2056 4553 4120 4249 4f53 2045 7874 ia VESA BIOS Ext │ │ │ │ │ +00023060: 656e 7369 6f6e 7320 2856 4245 292c 2073 ensions (VBE), s │ │ │ │ │ +00023070: 6f20 666f 7220 6578 616d 706c 650a 6e61 o for example.na │ │ │ │ │ +00023080: 7469 7665 204c 4344 2070 616e 656c 2072 tive LCD panel r │ │ │ │ │ +00023090: 6573 6f6c 7574 696f 6e73 206d 6179 206e esolutions may n │ │ │ │ │ +000230a0: 6f74 2062 6520 6176 6169 6c61 626c 652e ot be available. │ │ │ │ │ +000230b0: 2020 5468 6520 6465 6661 756c 7420 6973 The default is │ │ │ │ │ +000230c0: 0a27 6175 746f 272c 2077 6869 6368 2073 .'auto', which s │ │ │ │ │ +000230d0: 656c 6563 7473 2061 2070 6c61 7466 6f72 elects a platfor │ │ │ │ │ +000230e0: 6d2d 7370 6563 6966 6963 2064 6566 6175 m-specific defau │ │ │ │ │ +000230f0: 6c74 2074 6861 7420 7368 6f75 6c64 206c lt that should l │ │ │ │ │ +00023100: 6f6f 6b0a 7265 6173 6f6e 6162 6c65 2e20 ook.reasonable. │ │ │ │ │ +00023110: 2053 7570 706f 7274 6564 206d 6f64 6573 Supported modes │ │ │ │ │ +00023120: 2063 616e 2062 6520 6c69 7374 6564 2062 can be listed b │ │ │ │ │ +00023130: 7920 2776 6964 656f 696e 666f 2720 636f y 'videoinfo' co │ │ │ │ │ +00023140: 6d6d 616e 6420 696e 0a47 5255 422e 0a0a mmand in.GRUB... │ │ │ │ │ +00023150: 2020 2054 6865 2072 6573 6f6c 7574 696f The resolutio │ │ │ │ │ +00023160: 6e20 6d61 7920 6265 2073 7065 6369 6669 n may be specifi │ │ │ │ │ +00023170: 6564 2061 7320 6120 7365 7175 656e 6365 ed as a sequence │ │ │ │ │ +00023180: 206f 6620 6f6e 6520 6f72 206d 6f72 6520 of one or more │ │ │ │ │ +00023190: 6d6f 6465 732c 0a73 6570 6172 6174 6564 modes,.separated │ │ │ │ │ +000231a0: 2062 7920 636f 6d6d 6173 2028 272c 2729 by commas (',') │ │ │ │ │ +000231b0: 206f 7220 7365 6d69 636f 6c6f 6e73 2028 or semicolons ( │ │ │ │ │ +000231c0: 273b 2729 3b20 6561 6368 2077 696c 6c20 ';'); each will │ │ │ │ │ +000231d0: 6265 2074 7269 6564 2069 6e0a 7475 726e be tried in.turn │ │ │ │ │ +000231e0: 2075 6e74 696c 206f 6e65 2069 7320 666f until one is fo │ │ │ │ │ +000231f0: 756e 642e 2020 4561 6368 206d 6f64 6520 und. Each mode │ │ │ │ │ +00023200: 7368 6f75 6c64 2062 6520 6569 7468 6572 should be either │ │ │ │ │ +00023210: 2027 6175 746f 272c 0a27 5749 4454 4878 'auto',.'WIDTHx │ │ │ │ │ +00023220: 4845 4947 4854 272c 206f 7220 2757 4944 HEIGHT', or 'WID │ │ │ │ │ +00023230: 5448 7848 4549 4748 5478 4445 5054 4827 THxHEIGHTxDEPTH' │ │ │ │ │ +00023240: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ +00023250: 696e 666f 2c20 204e 6f64 653a 2067 6678 info, Node: gfx │ │ │ │ │ +00023260: 7061 796c 6f61 642c 2020 4e65 7874 3a20 payload, Next: │ │ │ │ │ +00023270: 6766 7874 6572 6d5f 666f 6e74 2c20 2050 gfxterm_font, P │ │ │ │ │ +00023280: 7265 763a 2067 6678 6d6f 6465 2c20 2055 rev: gfxmode, U │ │ │ │ │ +00023290: 703a 2053 7065 6369 616c 2065 6e76 6972 p: Special envir │ │ │ │ │ +000232a0: 6f6e 6d65 6e74 2076 6172 6961 626c 6573 onment variables │ │ │ │ │ +000232b0: 0a0a 3135 2e31 2e31 3320 6766 7870 6179 ..15.1.13 gfxpay │ │ │ │ │ +000232c0: 6c6f 6164 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d load.----------- │ │ │ │ │ +000232d0: 2d2d 2d2d 2d2d 2d0a 0a49 6620 7468 6973 -------..If this │ │ │ │ │ +000232e0: 2076 6172 6961 626c 6520 6973 2073 6574 variable is set │ │ │ │ │ +000232f0: 2c20 6974 2063 6f6e 7472 6f6c 7320 7468 , it controls th │ │ │ │ │ +00023300: 6520 7669 6465 6f20 6d6f 6465 2069 6e20 e video mode in │ │ │ │ │ +00023310: 7768 6963 6820 7468 6520 4c69 6e75 780a which the Linux. │ │ │ │ │ +00023320: 6b65 726e 656c 2073 7461 7274 7320 7570 kernel starts up │ │ │ │ │ +00023330: 2c20 7265 706c 6163 696e 6720 7468 6520 , replacing the │ │ │ │ │ +00023340: 2776 6761 3d27 2062 6f6f 7420 6f70 7469 'vga=' boot opti │ │ │ │ │ +00023350: 6f6e 2028 2a6e 6f74 6520 6c69 6e75 783a on (*note linux: │ │ │ │ │ +00023360: 3a29 2e20 2049 740a 6d61 7920 6265 2073 :). It.may be s │ │ │ │ │ +00023370: 6574 2074 6f20 2774 6578 7427 2074 6f20 et to 'text' to │ │ │ │ │ +00023380: 666f 7263 6520 7468 6520 4c69 6e75 7820 force the Linux │ │ │ │ │ +00023390: 6b65 726e 656c 2074 6f20 626f 6f74 2069 kernel to boot i │ │ │ │ │ +000233a0: 6e20 6e6f 726d 616c 2074 6578 740a 6d6f n normal text.mo │ │ │ │ │ +000233b0: 6465 2c20 276b 6565 7027 2074 6f20 7072 de, 'keep' to pr │ │ │ │ │ +000233c0: 6573 6572 7665 2074 6865 2067 7261 7068 eserve the graph │ │ │ │ │ +000233d0: 6963 7320 6d6f 6465 2073 6574 2075 7369 ics mode set usi │ │ │ │ │ +000233e0: 6e67 2027 6766 786d 6f64 6527 2c20 6f72 ng 'gfxmode', or │ │ │ │ │ +000233f0: 2061 6e79 0a6f 6620 7468 6520 7065 726d any.of the perm │ │ │ │ │ +00023400: 6974 7465 6420 7661 6c75 6573 2066 6f72 itted values for │ │ │ │ │ +00023410: 2027 6766 786d 6f64 6527 2074 6f20 7365 'gfxmode' to se │ │ │ │ │ +00023420: 7420 6120 7061 7274 6963 756c 6172 2067 t a particular g │ │ │ │ │ +00023430: 7261 7068 6963 7320 6d6f 6465 0a28 2a6e raphics mode.(*n │ │ │ │ │ +00023440: 6f74 6520 6766 786d 6f64 653a 3a29 2e0a ote gfxmode::).. │ │ │ │ │ +00023450: 0a20 2020 4465 7065 6e64 696e 6720 6f6e . Depending on │ │ │ │ │ +00023460: 2079 6f75 7220 6b65 726e 656c 2c20 796f your kernel, yo │ │ │ │ │ +00023470: 7572 2064 6973 7472 6962 7574 696f 6e2c ur distribution, │ │ │ │ │ +00023480: 2079 6f75 7220 6772 6170 6869 6373 2063 your graphics c │ │ │ │ │ +00023490: 6172 642c 2061 6e64 0a74 6865 2070 6861 ard, and.the pha │ │ │ │ │ +000234a0: 7365 206f 6620 7468 6520 6d6f 6f6e 2c20 se of the moon, │ │ │ │ │ +000234b0: 6e6f 7465 2074 6861 7420 7573 696e 6720 note that using │ │ │ │ │ +000234c0: 7468 6973 206f 7074 696f 6e20 6d61 7920 this option may │ │ │ │ │ +000234d0: 6361 7573 6520 474e 552f 4c69 6e75 780a cause GNU/Linux. │ │ │ │ │ +000234e0: 746f 2073 7566 6665 7220 6672 6f6d 2076 to suffer from v │ │ │ │ │ +000234f0: 6172 696f 7573 2064 6973 706c 6179 2070 arious display p │ │ │ │ │ +00023500: 726f 626c 656d 732c 2070 6172 7469 6375 roblems, particu │ │ │ │ │ +00023510: 6c61 726c 7920 6475 7269 6e67 2074 6865 larly during the │ │ │ │ │ +00023520: 2065 6172 6c79 0a70 6172 7420 6f66 2074 early.part of t │ │ │ │ │ +00023530: 6865 2062 6f6f 7420 7365 7175 656e 6365 he boot sequence │ │ │ │ │ +00023540: 2e20 2049 6620 796f 7520 6861 7665 2070 . If you have p │ │ │ │ │ +00023550: 726f 626c 656d 732c 2073 6574 2074 6869 roblems, set thi │ │ │ │ │ +00023560: 7320 7661 7269 6162 6c65 2074 6f0a 2774 s variable to.'t │ │ │ │ │ +00023570: 6578 7427 2061 6e64 2047 5255 4220 7769 ext' and GRUB wi │ │ │ │ │ +00023580: 6c6c 2074 656c 6c20 4c69 6e75 7820 746f ll tell Linux to │ │ │ │ │ +00023590: 2062 6f6f 7420 696e 206e 6f72 6d61 6c20 boot in normal │ │ │ │ │ +000235a0: 7465 7874 206d 6f64 652e 0a0a 2020 2054 text mode... T │ │ │ │ │ +000235b0: 6865 2064 6566 6175 6c74 2069 7320 706c he default is pl │ │ │ │ │ +000235c0: 6174 666f 726d 2d73 7065 6369 6669 632e atform-specific. │ │ │ │ │ +000235d0: 2020 4f6e 2070 6c61 7466 6f72 6d73 2077 On platforms w │ │ │ │ │ +000235e0: 6974 6820 6120 6e61 7469 7665 2074 6578 ith a native tex │ │ │ │ │ +000235f0: 740a 6d6f 6465 2028 7375 6368 2061 7320 t.mode (such as │ │ │ │ │ +00023600: 5043 2042 494f 5320 706c 6174 666f 726d PC BIOS platform │ │ │ │ │ +00023610: 7329 2c20 7468 6520 6465 6661 756c 7420 s), the default │ │ │ │ │ +00023620: 6973 2027 7465 7874 272e 2020 4f74 6865 is 'text'. Othe │ │ │ │ │ +00023630: 7277 6973 6520 7468 650a 6465 6661 756c rwise the.defaul │ │ │ │ │ +00023640: 7420 6d61 7920 6265 2027 6175 746f 2720 t may be 'auto' │ │ │ │ │ +00023650: 6f72 2061 2073 7065 6369 6669 6320 7669 or a specific vi │ │ │ │ │ +00023660: 6465 6f20 6d6f 6465 2e0a 0a20 2020 5468 deo mode... Th │ │ │ │ │ +00023670: 6973 2076 6172 6961 626c 6520 6973 206f is variable is o │ │ │ │ │ +00023680: 6674 656e 2073 6574 2062 7920 2747 5255 ften set by 'GRU │ │ │ │ │ +00023690: 425f 4746 5850 4159 4c4f 4144 5f4c 494e B_GFXPAYLOAD_LIN │ │ │ │ │ +000236a0: 5558 2720 282a 6e6f 7465 2053 696d 706c UX' (*note Simpl │ │ │ │ │ +000236b0: 650a 636f 6e66 6967 7572 6174 696f 6e3a e.configuration: │ │ │ │ │ +000236c0: 3a29 2e0a 0a1f 0a46 696c 653a 2067 7275 :).....File: gru │ │ │ │ │ +000236d0: 622e 696e 666f 2c20 204e 6f64 653a 2067 b.info, Node: g │ │ │ │ │ +000236e0: 6678 7465 726d 5f66 6f6e 742c 2020 4e65 fxterm_font, Ne │ │ │ │ │ +000236f0: 7874 3a20 6772 7562 5f63 7075 2c20 2050 xt: grub_cpu, P │ │ │ │ │ +00023700: 7265 763a 2067 6678 7061 796c 6f61 642c rev: gfxpayload, │ │ │ │ │ +00023710: 2020 5570 3a20 5370 6563 6961 6c20 656e Up: Special en │ │ │ │ │ +00023720: 7669 726f 6e6d 656e 7420 7661 7269 6162 vironment variab │ │ │ │ │ +00023730: 6c65 730a 0a31 352e 312e 3134 2067 6678 les..15.1.14 gfx │ │ │ │ │ +00023740: 7465 726d 5f66 6f6e 740a 2d2d 2d2d 2d2d term_font.------ │ │ │ │ │ +00023750: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ +00023760: 4966 2074 6869 7320 7661 7269 6162 6c65 If this variable │ │ │ │ │ +00023770: 2069 7320 7365 742c 2069 7420 6e61 6d65 is set, it name │ │ │ │ │ +00023780: 7320 6120 666f 6e74 2074 6f20 7573 6520 s a font to use │ │ │ │ │ +00023790: 666f 7220 7465 7874 206f 6e20 7468 650a for text on the. │ │ │ │ │ +000237a0: 2767 6678 7465 726d 2720 6772 6170 6869 'gfxterm' graphi │ │ │ │ │ +000237b0: 6361 6c20 7465 726d 696e 616c 2e20 204f cal terminal. O │ │ │ │ │ +000237c0: 7468 6572 7769 7365 2c20 2767 6678 7465 therwise, 'gfxte │ │ │ │ │ +000237d0: 726d 2720 6d61 7920 7573 6520 616e 790a rm' may use any. │ │ │ │ │ +000237e0: 6176 6169 6c61 626c 6520 666f 6e74 2e0a available font.. │ │ │ │ │ +000237f0: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ +00023800: 666f 2c20 204e 6f64 653a 2067 7275 625f fo, Node: grub_ │ │ │ │ │ +00023810: 6370 752c 2020 4e65 7874 3a20 6772 7562 cpu, Next: grub │ │ │ │ │ +00023820: 5f70 6c61 7466 6f72 6d2c 2020 5072 6576 _platform, Prev │ │ │ │ │ +00023830: 3a20 6766 7874 6572 6d5f 666f 6e74 2c20 : gfxterm_font, │ │ │ │ │ +00023840: 2055 703a 2053 7065 6369 616c 2065 6e76 Up: Special env │ │ │ │ │ +00023850: 6972 6f6e 6d65 6e74 2076 6172 6961 626c ironment variabl │ │ │ │ │ +00023860: 6573 0a0a 3135 2e31 2e31 3520 6772 7562 es..15.1.15 grub │ │ │ │ │ +00023870: 5f63 7075 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d _cpu.----------- │ │ │ │ │ +00023880: 2d2d 2d2d 2d0a 0a49 6e20 6e6f 726d 616c -----..In normal │ │ │ │ │ +00023890: 206d 6f64 6520 282a 6e6f 7465 206e 6f72 mode (*note nor │ │ │ │ │ +000238a0: 6d61 6c3a 3a29 2c20 4752 5542 2073 6574 mal::), GRUB set │ │ │ │ │ +000238b0: 7320 7468 6520 2767 7275 625f 6370 7527 s the 'grub_cpu' │ │ │ │ │ +000238c0: 2076 6172 6961 626c 6520 746f 0a74 6865 variable to.the │ │ │ │ │ +000238d0: 2043 5055 2074 7970 6520 666f 7220 7768 CPU type for wh │ │ │ │ │ +000238e0: 6963 6820 4752 5542 2077 6173 2062 7569 ich GRUB was bui │ │ │ │ │ +000238f0: 6c74 2028 652e 672e 2020 2769 3338 3627 lt (e.g. 'i386' │ │ │ │ │ +00023900: 206f 7220 2770 6f77 6572 7063 2729 2e0a or 'powerpc').. │ │ │ │ │ +00023910: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ +00023920: 666f 2c20 204e 6f64 653a 2067 7275 625f fo, Node: grub_ │ │ │ │ │ +00023930: 706c 6174 666f 726d 2c20 204e 6578 743a platform, Next: │ │ │ │ │ +00023940: 2069 636f 6e64 6972 2c20 2050 7265 763a icondir, Prev: │ │ │ │ │ +00023950: 2067 7275 625f 6370 752c 2020 5570 3a20 grub_cpu, Up: │ │ │ │ │ +00023960: 5370 6563 6961 6c20 656e 7669 726f 6e6d Special environm │ │ │ │ │ +00023970: 656e 7420 7661 7269 6162 6c65 730a 0a31 ent variables..1 │ │ │ │ │ +00023980: 352e 312e 3136 2067 7275 625f 706c 6174 5.1.16 grub_plat │ │ │ │ │ +00023990: 666f 726d 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d form.----------- │ │ │ │ │ +000239a0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 496e 206e ----------..In n │ │ │ │ │ +000239b0: 6f72 6d61 6c20 6d6f 6465 2028 2a6e 6f74 ormal mode (*not │ │ │ │ │ +000239c0: 6520 6e6f 726d 616c 3a3a 292c 2047 5255 e normal::), GRU │ │ │ │ │ +000239d0: 4220 7365 7473 2074 6865 2027 6772 7562 B sets the 'grub │ │ │ │ │ +000239e0: 5f70 6c61 7466 6f72 6d27 2076 6172 6961 _platform' varia │ │ │ │ │ +000239f0: 626c 650a 746f 2074 6865 2070 6c61 7466 ble.to the platf │ │ │ │ │ +00023a00: 6f72 6d20 666f 7220 7768 6963 6820 4752 orm for which GR │ │ │ │ │ +00023a10: 5542 2077 6173 2062 7569 6c74 2028 652e UB was built (e. │ │ │ │ │ +00023a20: 672e 2020 2770 6327 206f 7220 2765 6669 g. 'pc' or 'efi │ │ │ │ │ +00023a30: 2729 2e0a 0a1f 0a46 696c 653a 2067 7275 ').....File: gru │ │ │ │ │ +00023a40: 622e 696e 666f 2c20 204e 6f64 653a 2069 b.info, Node: i │ │ │ │ │ +00023a50: 636f 6e64 6972 2c20 204e 6578 743a 206c condir, Next: l │ │ │ │ │ +00023a60: 616e 672c 2020 5072 6576 3a20 6772 7562 ang, Prev: grub │ │ │ │ │ +00023a70: 5f70 6c61 7466 6f72 6d2c 2020 5570 3a20 _platform, Up: │ │ │ │ │ +00023a80: 5370 6563 6961 6c20 656e 7669 726f 6e6d Special environm │ │ │ │ │ +00023a90: 656e 7420 7661 7269 6162 6c65 730a 0a31 ent variables..1 │ │ │ │ │ +00023aa0: 352e 312e 3137 2069 636f 6e64 6972 0a2d 5.1.17 icondir.- │ │ │ │ │ +00023ab0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ +00023ac0: 4966 2074 6869 7320 7661 7269 6162 6c65 If this variable │ │ │ │ │ +00023ad0: 2069 7320 7365 742c 2069 7420 6e61 6d65 is set, it name │ │ │ │ │ +00023ae0: 7320 6120 6469 7265 6374 6f72 7920 696e s a directory in │ │ │ │ │ +00023af0: 2077 6869 6368 2074 6865 2047 5255 420a which the GRUB. │ │ │ │ │ +00023b00: 6772 6170 6869 6361 6c20 6d65 6e75 2073 graphical menu s │ │ │ │ │ +00023b10: 686f 756c 6420 6c6f 6f6b 2066 6f72 2069 hould look for i │ │ │ │ │ +00023b20: 636f 6e73 2061 6674 6572 206c 6f6f 6b69 cons after looki │ │ │ │ │ +00023b30: 6e67 2069 6e20 7468 6520 7468 656d 6527 ng in the theme' │ │ │ │ │ +00023b40: 730a 2769 636f 6e73 2720 6469 7265 6374 s.'icons' direct │ │ │ │ │ +00023b50: 6f72 792e 2020 2a4e 6f74 6520 5468 656d ory. *Note Them │ │ │ │ │ +00023b60: 6520 6669 6c65 2066 6f72 6d61 743a 3a2e e file format::. │ │ │ │ │ +00023b70: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ +00023b80: 6e66 6f2c 2020 4e6f 6465 3a20 6c61 6e67 nfo, Node: lang │ │ │ │ │ +00023b90: 2c20 204e 6578 743a 206c 6f63 616c 655f , Next: locale_ │ │ │ │ │ +00023ba0: 6469 722c 2020 5072 6576 3a20 6963 6f6e dir, Prev: icon │ │ │ │ │ +00023bb0: 6469 722c 2020 5570 3a20 5370 6563 6961 dir, Up: Specia │ │ │ │ │ +00023bc0: 6c20 656e 7669 726f 6e6d 656e 7420 7661 l environment va │ │ │ │ │ +00023bd0: 7269 6162 6c65 730a 0a31 352e 312e 3138 riables..15.1.18 │ │ │ │ │ +00023be0: 206c 616e 670a 2d2d 2d2d 2d2d 2d2d 2d2d lang.---------- │ │ │ │ │ +00023bf0: 2d2d 0a0a 4966 2074 6869 7320 7661 7269 --..If this vari │ │ │ │ │ +00023c00: 6162 6c65 2069 7320 7365 742c 2069 7420 able is set, it │ │ │ │ │ +00023c10: 6e61 6d65 7320 7468 6520 6c61 6e67 7561 names the langua │ │ │ │ │ +00023c20: 6765 2063 6f64 6520 7468 6174 2074 6865 ge code that the │ │ │ │ │ +00023c30: 2027 6765 7474 6578 7427 0a63 6f6d 6d61 'gettext'.comma │ │ │ │ │ +00023c40: 6e64 2028 2a6e 6f74 6520 6765 7474 6578 nd (*note gettex │ │ │ │ │ +00023c50: 743a 3a29 2075 7365 7320 746f 2074 7261 t::) uses to tra │ │ │ │ │ +00023c60: 6e73 6c61 7465 2073 7472 696e 6773 2e20 nslate strings. │ │ │ │ │ +00023c70: 2046 6f72 2065 7861 6d70 6c65 2c0a 4672 For example,.Fr │ │ │ │ │ +00023c80: 656e 6368 2077 6f75 6c64 2062 6520 6e61 ench would be na │ │ │ │ │ +00023c90: 6d65 6420 6173 2027 6672 272c 2061 6e64 med as 'fr', and │ │ │ │ │ +00023ca0: 2053 696d 706c 6966 6965 6420 4368 696e Simplified Chin │ │ │ │ │ +00023cb0: 6573 6520 6173 2027 7a68 5f43 4e27 2e0a ese as 'zh_CN'.. │ │ │ │ │ +00023cc0: 0a20 2020 2767 7275 622d 6d6b 636f 6e66 . 'grub-mkconf │ │ │ │ │ +00023cd0: 6967 2720 282a 6e6f 7465 2053 696d 706c ig' (*note Simpl │ │ │ │ │ +00023ce0: 6520 636f 6e66 6967 7572 6174 696f 6e3a e configuration: │ │ │ │ │ +00023cf0: 3a29 2077 696c 6c20 7472 7920 746f 2073 :) will try to s │ │ │ │ │ +00023d00: 6574 2061 0a72 6561 736f 6e61 626c 6520 et a.reasonable │ │ │ │ │ +00023d10: 6465 6661 756c 7420 666f 7220 7468 6973 default for this │ │ │ │ │ +00023d20: 2076 6172 6961 626c 6520 6261 7365 6420 variable based │ │ │ │ │ +00023d30: 6f6e 2074 6865 2073 7973 7465 6d20 6c6f on the system lo │ │ │ │ │ +00023d40: 6361 6c65 2e0a 0a1f 0a46 696c 653a 2067 cale.....File: g │ │ │ │ │ +00023d50: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ +00023d60: 206c 6f63 616c 655f 6469 722c 2020 4e65 locale_dir, Ne │ │ │ │ │ +00023d70: 7874 3a20 6d65 6e75 5f63 6f6c 6f72 5f68 xt: menu_color_h │ │ │ │ │ +00023d80: 6967 686c 6967 6874 2c20 2050 7265 763a ighlight, Prev: │ │ │ │ │ +00023d90: 206c 616e 672c 2020 5570 3a20 5370 6563 lang, Up: Spec │ │ │ │ │ +00023da0: 6961 6c20 656e 7669 726f 6e6d 656e 7420 ial environment │ │ │ │ │ +00023db0: 7661 7269 6162 6c65 730a 0a31 352e 312e variables..15.1. │ │ │ │ │ +00023dc0: 3139 206c 6f63 616c 655f 6469 720a 2d2d 19 locale_dir.-- │ │ │ │ │ 00023dd0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00023de0: 2d2d 0a0a 4966 2074 6869 7320 7661 7269 --..If this vari │ │ │ │ │ -00023df0: 6162 6c65 2069 7320 7365 742c 2069 7420 able is set, it │ │ │ │ │ -00023e00: 6e61 6d65 7320 7468 6520 6469 7265 6374 names the direct │ │ │ │ │ -00023e10: 6f72 7920 7768 6572 6520 7472 616e 736c ory where transl │ │ │ │ │ -00023e20: 6174 696f 6e20 6669 6c65 730a 6d61 7920 ation files.may │ │ │ │ │ -00023e30: 6265 2066 6f75 6e64 2028 2a6e 6f74 6520 be found (*note │ │ │ │ │ -00023e40: 6765 7474 6578 743a 3a29 2c20 7573 7561 gettext::), usua │ │ │ │ │ -00023e50: 6c6c 7920 272f 626f 6f74 2f67 7275 622f lly '/boot/grub/ │ │ │ │ │ -00023e60: 6c6f 6361 6c65 272e 2020 4f74 6865 7277 locale'. Otherw │ │ │ │ │ -00023e70: 6973 652c 0a69 6e74 6572 6e61 7469 6f6e ise,.internation │ │ │ │ │ -00023e80: 616c 697a 6174 696f 6e20 6973 2064 6973 alization is dis │ │ │ │ │ -00023e90: 6162 6c65 642e 0a0a 2020 2027 6772 7562 abled... 'grub │ │ │ │ │ -00023ea0: 2d6d 6b63 6f6e 6669 6727 2028 2a6e 6f74 -mkconfig' (*not │ │ │ │ │ -00023eb0: 6520 5369 6d70 6c65 2063 6f6e 6669 6775 e Simple configu │ │ │ │ │ -00023ec0: 7261 7469 6f6e 3a3a 2920 7769 6c6c 2073 ration::) will s │ │ │ │ │ -00023ed0: 6574 2061 2072 6561 736f 6e61 626c 650a et a reasonable. │ │ │ │ │ -00023ee0: 6465 6661 756c 7420 666f 7220 7468 6973 default for this │ │ │ │ │ -00023ef0: 2076 6172 6961 626c 6520 6966 2069 6e74 variable if int │ │ │ │ │ -00023f00: 6572 6e61 7469 6f6e 616c 697a 6174 696f ernationalizatio │ │ │ │ │ -00023f10: 6e20 6973 206e 6565 6465 6420 616e 6420 n is needed and │ │ │ │ │ -00023f20: 616e 790a 7472 616e 736c 6174 696f 6e20 any.translation │ │ │ │ │ -00023f30: 6669 6c65 7320 6172 6520 6176 6169 6c61 files are availa │ │ │ │ │ -00023f40: 626c 652e 0a0a 1f0a 4669 6c65 3a20 6772 ble.....File: gr │ │ │ │ │ -00023f50: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ -00023f60: 6d65 6e75 5f63 6f6c 6f72 5f68 6967 686c menu_color_highl │ │ │ │ │ -00023f70: 6967 6874 2c20 204e 6578 743a 206d 656e ight, Next: men │ │ │ │ │ -00023f80: 755f 636f 6c6f 725f 6e6f 726d 616c 2c20 u_color_normal, │ │ │ │ │ -00023f90: 2050 7265 763a 206c 6f63 616c 655f 6469 Prev: locale_di │ │ │ │ │ -00023fa0: 722c 2020 5570 3a20 5370 6563 6961 6c20 r, Up: Special │ │ │ │ │ -00023fb0: 656e 7669 726f 6e6d 656e 7420 7661 7269 environment vari │ │ │ │ │ -00023fc0: 6162 6c65 730a 0a31 352e 312e 3230 206d ables..15.1.20 m │ │ │ │ │ -00023fd0: 656e 755f 636f 6c6f 725f 6869 6768 6c69 enu_color_highli │ │ │ │ │ -00023fe0: 6768 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ght.------------ │ │ │ │ │ -00023ff0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00024000: 0a0a 5468 6973 2076 6172 6961 626c 6520 ..This variable │ │ │ │ │ -00024010: 636f 6e74 6169 6e73 2074 6865 2066 6f72 contains the for │ │ │ │ │ -00024020: 6567 726f 756e 6420 616e 6420 6261 636b eground and back │ │ │ │ │ -00024030: 6772 6f75 6e64 2063 6f6c 6f72 7320 746f ground colors to │ │ │ │ │ -00024040: 2062 6520 7573 6564 0a66 6f72 2074 6865 be used.for the │ │ │ │ │ -00024050: 2068 6967 686c 6967 6874 6564 206d 656e highlighted men │ │ │ │ │ -00024060: 7520 656e 7472 792c 2073 6570 6172 6174 u entry, separat │ │ │ │ │ -00024070: 6564 2062 7920 6120 736c 6173 6820 2827 ed by a slash (' │ │ │ │ │ -00024080: 2f27 292e 2020 5365 7474 696e 670a 7468 /'). Setting.th │ │ │ │ │ -00024090: 6973 2076 6172 6961 626c 6520 6368 616e is variable chan │ │ │ │ │ -000240a0: 6765 7320 7468 6f73 6520 636f 6c6f 7273 ges those colors │ │ │ │ │ -000240b0: 2e20 2046 6f72 2074 6865 2061 7661 696c . For the avail │ │ │ │ │ -000240c0: 6162 6c65 2063 6f6c 6f72 206e 616d 6573 able color names │ │ │ │ │ -000240d0: 2c0a 2a6e 6f74 6520 636f 6c6f 725f 6e6f ,.*note color_no │ │ │ │ │ -000240e0: 726d 616c 3a3a 2e0a 0a20 2020 5468 6520 rmal::... The │ │ │ │ │ -000240f0: 6465 6661 756c 7420 6973 2074 6865 2076 default is the v │ │ │ │ │ -00024100: 616c 7565 206f 6620 2763 6f6c 6f72 5f68 alue of 'color_h │ │ │ │ │ -00024110: 6967 686c 6967 6874 2720 282a 6e6f 7465 ighlight' (*note │ │ │ │ │ -00024120: 0a63 6f6c 6f72 5f68 6967 686c 6967 6874 .color_highlight │ │ │ │ │ -00024130: 3a3a 292e 0a0a 1f0a 4669 6c65 3a20 6772 ::).....File: gr │ │ │ │ │ -00024140: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ -00024150: 6d65 6e75 5f63 6f6c 6f72 5f6e 6f72 6d61 menu_color_norma │ │ │ │ │ -00024160: 6c2c 2020 4e65 7874 3a20 6e65 745f 3c49 l, Next: net__boot_f │ │ │ │ │ -00024180: 696c 652c 2020 5072 6576 3a20 6d65 6e75 ile, Prev: menu │ │ │ │ │ -00024190: 5f63 6f6c 6f72 5f68 6967 686c 6967 6874 _color_highlight │ │ │ │ │ -000241a0: 2c20 2055 703a 2053 7065 6369 616c 2065 , Up: Special e │ │ │ │ │ -000241b0: 6e76 6972 6f6e 6d65 6e74 2076 6172 6961 nvironment varia │ │ │ │ │ -000241c0: 626c 6573 0a0a 3135 2e31 2e32 3120 6d65 bles..15.1.21 me │ │ │ │ │ -000241d0: 6e75 5f63 6f6c 6f72 5f6e 6f72 6d61 6c0a nu_color_normal. │ │ │ │ │ +00023de0: 0a0a 4966 2074 6869 7320 7661 7269 6162 ..If this variab │ │ │ │ │ +00023df0: 6c65 2069 7320 7365 742c 2069 7420 6e61 le is set, it na │ │ │ │ │ +00023e00: 6d65 7320 7468 6520 6469 7265 6374 6f72 mes the director │ │ │ │ │ +00023e10: 7920 7768 6572 6520 7472 616e 736c 6174 y where translat │ │ │ │ │ +00023e20: 696f 6e20 6669 6c65 730a 6d61 7920 6265 ion files.may be │ │ │ │ │ +00023e30: 2066 6f75 6e64 2028 2a6e 6f74 6520 6765 found (*note ge │ │ │ │ │ +00023e40: 7474 6578 743a 3a29 2c20 7573 7561 6c6c ttext::), usuall │ │ │ │ │ +00023e50: 7920 272f 626f 6f74 2f67 7275 622f 6c6f y '/boot/grub/lo │ │ │ │ │ +00023e60: 6361 6c65 272e 2020 4f74 6865 7277 6973 cale'. Otherwis │ │ │ │ │ +00023e70: 652c 0a69 6e74 6572 6e61 7469 6f6e 616c e,.international │ │ │ │ │ +00023e80: 697a 6174 696f 6e20 6973 2064 6973 6162 ization is disab │ │ │ │ │ +00023e90: 6c65 642e 0a0a 2020 2027 6772 7562 2d6d led... 'grub-m │ │ │ │ │ +00023ea0: 6b63 6f6e 6669 6727 2028 2a6e 6f74 6520 kconfig' (*note │ │ │ │ │ +00023eb0: 5369 6d70 6c65 2063 6f6e 6669 6775 7261 Simple configura │ │ │ │ │ +00023ec0: 7469 6f6e 3a3a 2920 7769 6c6c 2073 6574 tion::) will set │ │ │ │ │ +00023ed0: 2061 2072 6561 736f 6e61 626c 650a 6465 a reasonable.de │ │ │ │ │ +00023ee0: 6661 756c 7420 666f 7220 7468 6973 2076 fault for this v │ │ │ │ │ +00023ef0: 6172 6961 626c 6520 6966 2069 6e74 6572 ariable if inter │ │ │ │ │ +00023f00: 6e61 7469 6f6e 616c 697a 6174 696f 6e20 nationalization │ │ │ │ │ +00023f10: 6973 206e 6565 6465 6420 616e 6420 616e is needed and an │ │ │ │ │ +00023f20: 790a 7472 616e 736c 6174 696f 6e20 6669 y.translation fi │ │ │ │ │ +00023f30: 6c65 7320 6172 6520 6176 6169 6c61 626c les are availabl │ │ │ │ │ +00023f40: 652e 0a0a 1f0a 4669 6c65 3a20 6772 7562 e.....File: grub │ │ │ │ │ +00023f50: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 6d65 .info, Node: me │ │ │ │ │ +00023f60: 6e75 5f63 6f6c 6f72 5f68 6967 686c 6967 nu_color_highlig │ │ │ │ │ +00023f70: 6874 2c20 204e 6578 743a 206d 656e 755f ht, Next: menu_ │ │ │ │ │ +00023f80: 636f 6c6f 725f 6e6f 726d 616c 2c20 2050 color_normal, P │ │ │ │ │ +00023f90: 7265 763a 206c 6f63 616c 655f 6469 722c rev: locale_dir, │ │ │ │ │ +00023fa0: 2020 5570 3a20 5370 6563 6961 6c20 656e Up: Special en │ │ │ │ │ +00023fb0: 7669 726f 6e6d 656e 7420 7661 7269 6162 vironment variab │ │ │ │ │ +00023fc0: 6c65 730a 0a31 352e 312e 3230 206d 656e les..15.1.20 men │ │ │ │ │ +00023fd0: 755f 636f 6c6f 725f 6869 6768 6c69 6768 u_color_highligh │ │ │ │ │ +00023fe0: 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d t.-------------- │ │ │ │ │ +00023ff0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ +00024000: 5468 6973 2076 6172 6961 626c 6520 636f This variable co │ │ │ │ │ +00024010: 6e74 6169 6e73 2074 6865 2066 6f72 6567 ntains the foreg │ │ │ │ │ +00024020: 726f 756e 6420 616e 6420 6261 636b 6772 round and backgr │ │ │ │ │ +00024030: 6f75 6e64 2063 6f6c 6f72 7320 746f 2062 ound colors to b │ │ │ │ │ +00024040: 6520 7573 6564 0a66 6f72 2074 6865 2068 e used.for the h │ │ │ │ │ +00024050: 6967 686c 6967 6874 6564 206d 656e 7520 ighlighted menu │ │ │ │ │ +00024060: 656e 7472 792c 2073 6570 6172 6174 6564 entry, separated │ │ │ │ │ +00024070: 2062 7920 6120 736c 6173 6820 2827 2f27 by a slash ('/' │ │ │ │ │ +00024080: 292e 2020 5365 7474 696e 670a 7468 6973 ). Setting.this │ │ │ │ │ +00024090: 2076 6172 6961 626c 6520 6368 616e 6765 variable change │ │ │ │ │ +000240a0: 7320 7468 6f73 6520 636f 6c6f 7273 2e20 s those colors. │ │ │ │ │ +000240b0: 2046 6f72 2074 6865 2061 7661 696c 6162 For the availab │ │ │ │ │ +000240c0: 6c65 2063 6f6c 6f72 206e 616d 6573 2c0a le color names,. │ │ │ │ │ +000240d0: 2a6e 6f74 6520 636f 6c6f 725f 6e6f 726d *note color_norm │ │ │ │ │ +000240e0: 616c 3a3a 2e0a 0a20 2020 5468 6520 6465 al::... The de │ │ │ │ │ +000240f0: 6661 756c 7420 6973 2074 6865 2076 616c fault is the val │ │ │ │ │ +00024100: 7565 206f 6620 2763 6f6c 6f72 5f68 6967 ue of 'color_hig │ │ │ │ │ +00024110: 686c 6967 6874 2720 282a 6e6f 7465 0a63 hlight' (*note.c │ │ │ │ │ +00024120: 6f6c 6f72 5f68 6967 686c 6967 6874 3a3a olor_highlight:: │ │ │ │ │ +00024130: 292e 0a0a 1f0a 4669 6c65 3a20 6772 7562 ).....File: grub │ │ │ │ │ +00024140: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 6d65 .info, Node: me │ │ │ │ │ +00024150: 6e75 5f63 6f6c 6f72 5f6e 6f72 6d61 6c2c nu_color_normal, │ │ │ │ │ +00024160: 2020 4e65 7874 3a20 6e65 745f 3c49 4e54 Next: net__boot_fil │ │ │ │ │ +00024180: 652c 2020 5072 6576 3a20 6d65 6e75 5f63 e, Prev: menu_c │ │ │ │ │ +00024190: 6f6c 6f72 5f68 6967 686c 6967 6874 2c20 olor_highlight, │ │ │ │ │ +000241a0: 2055 703a 2053 7065 6369 616c 2065 6e76 Up: Special env │ │ │ │ │ +000241b0: 6972 6f6e 6d65 6e74 2076 6172 6961 626c ironment variabl │ │ │ │ │ +000241c0: 6573 0a0a 3135 2e31 2e32 3120 6d65 6e75 es..15.1.21 menu │ │ │ │ │ +000241d0: 5f63 6f6c 6f72 5f6e 6f72 6d61 6c0a 2d2d _color_normal.-- │ │ │ │ │ 000241e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -000241f0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a54 6869 7320 ---------..This │ │ │ │ │ -00024200: 7661 7269 6162 6c65 2063 6f6e 7461 696e variable contain │ │ │ │ │ -00024210: 7320 7468 6520 666f 7265 6772 6f75 6e64 s the foreground │ │ │ │ │ -00024220: 2061 6e64 2062 6163 6b67 726f 756e 6420 and background │ │ │ │ │ -00024230: 636f 6c6f 7273 2074 6f20 6265 2075 7365 colors to be use │ │ │ │ │ -00024240: 640a 666f 7220 6e6f 6e2d 6869 6768 6c69 d.for non-highli │ │ │ │ │ -00024250: 6768 7465 6420 6d65 6e75 2065 6e74 7269 ghted menu entri │ │ │ │ │ -00024260: 6573 2c20 7365 7061 7261 7465 6420 6279 es, separated by │ │ │ │ │ -00024270: 2061 2073 6c61 7368 2028 272f 2729 2e20 a slash ('/'). │ │ │ │ │ -00024280: 2053 6574 7469 6e67 0a74 6869 7320 7661 Setting.this va │ │ │ │ │ -00024290: 7269 6162 6c65 2063 6861 6e67 6573 2074 riable changes t │ │ │ │ │ -000242a0: 686f 7365 2063 6f6c 6f72 732e 2020 466f hose colors. Fo │ │ │ │ │ -000242b0: 7220 7468 6520 6176 6169 6c61 626c 6520 r the available │ │ │ │ │ -000242c0: 636f 6c6f 7220 6e61 6d65 732c 0a2a 6e6f color names,.*no │ │ │ │ │ -000242d0: 7465 2063 6f6c 6f72 5f6e 6f72 6d61 6c3a te color_normal: │ │ │ │ │ -000242e0: 3a2e 0a0a 2020 2054 6865 2064 6566 6175 :... The defau │ │ │ │ │ -000242f0: 6c74 2069 7320 7468 6520 7661 6c75 6520 lt is the value │ │ │ │ │ -00024300: 6f66 2027 636f 6c6f 725f 6e6f 726d 616c of 'color_normal │ │ │ │ │ -00024310: 2720 282a 6e6f 7465 2063 6f6c 6f72 5f6e ' (*note color_n │ │ │ │ │ -00024320: 6f72 6d61 6c3a 3a29 2e0a 0a1f 0a46 696c ormal::).....Fil │ │ │ │ │ -00024330: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ -00024340: 6f64 653a 206e 6574 5f3c 494e 5445 5246 ode: net__boot_file, │ │ │ │ │ -00024360: 204e 6578 743a 206e 6574 5f3c 494e 5445 Next: net__dhcp_serv │ │ │ │ │ -00024380: 6572 5f6e 616d 652c 2020 5072 6576 3a20 er_name, Prev: │ │ │ │ │ -00024390: 6d65 6e75 5f63 6f6c 6f72 5f6e 6f72 6d61 menu_color_norma │ │ │ │ │ -000243a0: 6c2c 2020 5570 3a20 5370 6563 6961 6c20 l, Up: Special │ │ │ │ │ -000243b0: 656e 7669 726f 6e6d 656e 7420 7661 7269 environment vari │ │ │ │ │ -000243c0: 6162 6c65 730a 0a31 352e 312e 3232 206e ables..15.1.22 n │ │ │ │ │ -000243d0: 6574 5f3c 494e 5445 5246 4143 453e 5f62 et__b │ │ │ │ │ -000243e0: 6f6f 745f 6669 6c65 0a2d 2d2d 2d2d 2d2d oot_file.------- │ │ │ │ │ +000241f0: 2d2d 2d2d 2d2d 2d0a 0a54 6869 7320 7661 -------..This va │ │ │ │ │ +00024200: 7269 6162 6c65 2063 6f6e 7461 696e 7320 riable contains │ │ │ │ │ +00024210: 7468 6520 666f 7265 6772 6f75 6e64 2061 the foreground a │ │ │ │ │ +00024220: 6e64 2062 6163 6b67 726f 756e 6420 636f nd background co │ │ │ │ │ +00024230: 6c6f 7273 2074 6f20 6265 2075 7365 640a lors to be used. │ │ │ │ │ +00024240: 666f 7220 6e6f 6e2d 6869 6768 6c69 6768 for non-highligh │ │ │ │ │ +00024250: 7465 6420 6d65 6e75 2065 6e74 7269 6573 ted menu entries │ │ │ │ │ +00024260: 2c20 7365 7061 7261 7465 6420 6279 2061 , separated by a │ │ │ │ │ +00024270: 2073 6c61 7368 2028 272f 2729 2e20 2053 slash ('/'). S │ │ │ │ │ +00024280: 6574 7469 6e67 0a74 6869 7320 7661 7269 etting.this vari │ │ │ │ │ +00024290: 6162 6c65 2063 6861 6e67 6573 2074 686f able changes tho │ │ │ │ │ +000242a0: 7365 2063 6f6c 6f72 732e 2020 466f 7220 se colors. For │ │ │ │ │ +000242b0: 7468 6520 6176 6169 6c61 626c 6520 636f the available co │ │ │ │ │ +000242c0: 6c6f 7220 6e61 6d65 732c 0a2a 6e6f 7465 lor names,.*note │ │ │ │ │ +000242d0: 2063 6f6c 6f72 5f6e 6f72 6d61 6c3a 3a2e color_normal::. │ │ │ │ │ +000242e0: 0a0a 2020 2054 6865 2064 6566 6175 6c74 .. The default │ │ │ │ │ +000242f0: 2069 7320 7468 6520 7661 6c75 6520 6f66 is the value of │ │ │ │ │ +00024300: 2027 636f 6c6f 725f 6e6f 726d 616c 2720 'color_normal' │ │ │ │ │ +00024310: 282a 6e6f 7465 2063 6f6c 6f72 5f6e 6f72 (*note color_nor │ │ │ │ │ +00024320: 6d61 6c3a 3a29 2e0a 0a1f 0a46 696c 653a mal::).....File: │ │ │ │ │ +00024330: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ +00024340: 653a 206e 6574 5f3c 494e 5445 5246 4143 e: net__boot_file, N │ │ │ │ │ +00024360: 6578 743a 206e 6574 5f3c 494e 5445 5246 ext: net__dhcp_server │ │ │ │ │ +00024380: 5f6e 616d 652c 2020 5072 6576 3a20 6d65 _name, Prev: me │ │ │ │ │ +00024390: 6e75 5f63 6f6c 6f72 5f6e 6f72 6d61 6c2c nu_color_normal, │ │ │ │ │ +000243a0: 2020 5570 3a20 5370 6563 6961 6c20 656e Up: Special en │ │ │ │ │ +000243b0: 7669 726f 6e6d 656e 7420 7661 7269 6162 vironment variab │ │ │ │ │ +000243c0: 6c65 730a 0a31 352e 312e 3232 206e 6574 les..15.1.22 net │ │ │ │ │ +000243d0: 5f3c 494e 5445 5246 4143 453e 5f62 6f6f __boo │ │ │ │ │ +000243e0: 745f 6669 6c65 0a2d 2d2d 2d2d 2d2d 2d2d t_file.--------- │ │ │ │ │ 000243f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00024400: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2a4e 6f74 ----------..*Not │ │ │ │ │ -00024410: 6520 4e65 7477 6f72 6b3a 3a2e 0a0a 1f0a e Network::..... │ │ │ │ │ -00024420: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ -00024430: 2020 4e6f 6465 3a20 6e65 745f 3c49 4e54 Node: net__dhcp_ser │ │ │ │ │ -00024450: 7665 725f 6e61 6d65 2c20 204e 6578 743a ver_name, Next: │ │ │ │ │ -00024460: 206e 6574 5f3c 494e 5445 5246 4143 453e net_ │ │ │ │ │ -00024470: 5f64 6f6d 6169 6e2c 2020 5072 6576 3a20 _domain, Prev: │ │ │ │ │ -00024480: 6e65 745f 3c49 4e54 4552 4641 4345 3e5f net__ │ │ │ │ │ -00024490: 626f 6f74 5f66 696c 652c 2020 5570 3a20 boot_file, Up: │ │ │ │ │ -000244a0: 5370 6563 6961 6c20 656e 7669 726f 6e6d Special environm │ │ │ │ │ -000244b0: 656e 7420 7661 7269 6162 6c65 730a 0a31 ent variables..1 │ │ │ │ │ -000244c0: 352e 312e 3233 206e 6574 5f3c 494e 5445 5.1.23 net__dhcp_serv │ │ │ │ │ -000244e0: 6572 5f6e 616d 650a 2d2d 2d2d 2d2d 2d2d er_name.-------- │ │ │ │ │ +00024400: 2d2d 2d2d 2d2d 2d2d 0a0a 2a4e 6f74 6520 --------..*Note │ │ │ │ │ +00024410: 4e65 7477 6f72 6b3a 3a2e 0a0a 1f0a 4669 Network::.....Fi │ │ │ │ │ +00024420: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ +00024430: 4e6f 6465 3a20 6e65 745f 3c49 4e54 4552 Node: net__dhcp_serve │ │ │ │ │ +00024450: 725f 6e61 6d65 2c20 204e 6578 743a 206e r_name, Next: n │ │ │ │ │ +00024460: 6574 5f3c 494e 5445 5246 4143 453e 5f64 et__d │ │ │ │ │ +00024470: 6f6d 6169 6e2c 2020 5072 6576 3a20 6e65 omain, Prev: ne │ │ │ │ │ +00024480: 745f 3c49 4e54 4552 4641 4345 3e5f 626f t__bo │ │ │ │ │ +00024490: 6f74 5f66 696c 652c 2020 5570 3a20 5370 ot_file, Up: Sp │ │ │ │ │ +000244a0: 6563 6961 6c20 656e 7669 726f 6e6d 656e ecial environmen │ │ │ │ │ +000244b0: 7420 7661 7269 6162 6c65 730a 0a31 352e t variables..15. │ │ │ │ │ +000244c0: 312e 3233 206e 6574 5f3c 494e 5445 5246 1.23 net__dhcp_server │ │ │ │ │ +000244e0: 5f6e 616d 650a 2d2d 2d2d 2d2d 2d2d 2d2d _name.---------- │ │ │ │ │ 000244f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00024500: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00024510: 0a0a 2a4e 6f74 6520 4e65 7477 6f72 6b3a ..*Note Network: │ │ │ │ │ -00024520: 3a2e 0a0a 1f0a 4669 6c65 3a20 6772 7562 :.....File: grub │ │ │ │ │ -00024530: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 6e65 .info, Node: ne │ │ │ │ │ -00024540: 745f 3c49 4e54 4552 4641 4345 3e5f 646f t__do │ │ │ │ │ -00024550: 6d61 696e 2c20 204e 6578 743a 206e 6574 main, Next: net │ │ │ │ │ -00024560: 5f3c 494e 5445 5246 4143 453e 5f65 7874 __ext │ │ │ │ │ -00024570: 656e 7369 6f6e 7370 6174 682c 2020 5072 ensionspath, Pr │ │ │ │ │ -00024580: 6576 3a20 6e65 745f 3c49 4e54 4552 4641 ev: net__dhcp_server_ │ │ │ │ │ -000245a0: 6e61 6d65 2c20 2055 703a 2053 7065 6369 name, Up: Speci │ │ │ │ │ -000245b0: 616c 2065 6e76 6972 6f6e 6d65 6e74 2076 al environment v │ │ │ │ │ -000245c0: 6172 6961 626c 6573 0a0a 3135 2e31 2e32 ariables..15.1.2 │ │ │ │ │ -000245d0: 3420 6e65 745f 3c49 4e54 4552 4641 4345 4 net__domain.------- │ │ │ │ │ +00024500: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ +00024510: 2a4e 6f74 6520 4e65 7477 6f72 6b3a 3a2e *Note Network::. │ │ │ │ │ +00024520: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ +00024530: 6e66 6f2c 2020 4e6f 6465 3a20 6e65 745f nfo, Node: net_ │ │ │ │ │ +00024540: 3c49 4e54 4552 4641 4345 3e5f 646f 6d61 _doma │ │ │ │ │ +00024550: 696e 2c20 204e 6578 743a 206e 6574 5f3c in, Next: net_< │ │ │ │ │ +00024560: 494e 5445 5246 4143 453e 5f65 7874 656e INTERFACE>_exten │ │ │ │ │ +00024570: 7369 6f6e 7370 6174 682c 2020 5072 6576 sionspath, Prev │ │ │ │ │ +00024580: 3a20 6e65 745f 3c49 4e54 4552 4641 4345 : net__dhcp_server_na │ │ │ │ │ +000245a0: 6d65 2c20 2055 703a 2053 7065 6369 616c me, Up: Special │ │ │ │ │ +000245b0: 2065 6e76 6972 6f6e 6d65 6e74 2076 6172 environment var │ │ │ │ │ +000245c0: 6961 626c 6573 0a0a 3135 2e31 2e32 3420 iables..15.1.24 │ │ │ │ │ +000245d0: 6e65 745f 3c49 4e54 4552 4641 4345 3e5f net__ │ │ │ │ │ +000245e0: 646f 6d61 696e 0a2d 2d2d 2d2d 2d2d 2d2d domain.--------- │ │ │ │ │ 000245f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00024600: 2d2d 2d2d 2d2d 2d0a 0a2a 4e6f 7465 204e -------..*Note N │ │ │ │ │ -00024610: 6574 776f 726b 3a3a 2e0a 0a1f 0a46 696c etwork::.....Fil │ │ │ │ │ -00024620: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ -00024630: 6f64 653a 206e 6574 5f3c 494e 5445 5246 ode: net__extensionsp │ │ │ │ │ -00024650: 6174 682c 2020 4e65 7874 3a20 6e65 745f ath, Next: net_ │ │ │ │ │ -00024660: 3c49 4e54 4552 4641 4345 3e5f 686f 7374 _host │ │ │ │ │ -00024670: 6e61 6d65 2c20 2050 7265 763a 206e 6574 name, Prev: net │ │ │ │ │ -00024680: 5f3c 494e 5445 5246 4143 453e 5f64 6f6d __dom │ │ │ │ │ -00024690: 6169 6e2c 2020 5570 3a20 5370 6563 6961 ain, Up: Specia │ │ │ │ │ -000246a0: 6c20 656e 7669 726f 6e6d 656e 7420 7661 l environment va │ │ │ │ │ -000246b0: 7269 6162 6c65 730a 0a31 352e 312e 3235 riables..15.1.25 │ │ │ │ │ -000246c0: 206e 6574 5f3c 494e 5445 5246 4143 453e net_ │ │ │ │ │ -000246d0: 5f65 7874 656e 7369 6f6e 7370 6174 680a _extensionspath. │ │ │ │ │ +00024600: 2d2d 2d2d 2d0a 0a2a 4e6f 7465 204e 6574 -----..*Note Net │ │ │ │ │ +00024610: 776f 726b 3a3a 2e0a 0a1f 0a46 696c 653a work::.....File: │ │ │ │ │ +00024620: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ +00024630: 653a 206e 6574 5f3c 494e 5445 5246 4143 e: net__extensionspat │ │ │ │ │ +00024650: 682c 2020 4e65 7874 3a20 6e65 745f 3c49 h, Next: net__hostna │ │ │ │ │ +00024670: 6d65 2c20 2050 7265 763a 206e 6574 5f3c me, Prev: net_< │ │ │ │ │ +00024680: 494e 5445 5246 4143 453e 5f64 6f6d 6169 INTERFACE>_domai │ │ │ │ │ +00024690: 6e2c 2020 5570 3a20 5370 6563 6961 6c20 n, Up: Special │ │ │ │ │ +000246a0: 656e 7669 726f 6e6d 656e 7420 7661 7269 environment vari │ │ │ │ │ +000246b0: 6162 6c65 730a 0a31 352e 312e 3235 206e ables..15.1.25 n │ │ │ │ │ +000246c0: 6574 5f3c 494e 5445 5246 4143 453e 5f65 et__e │ │ │ │ │ +000246d0: 7874 656e 7369 6f6e 7370 6174 680a 2d2d xtensionspath.-- │ │ │ │ │ 000246e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 000246f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00024700: 2d2d 2d2d 2d2d 0a0a 2a4e 6f74 6520 4e65 ------..*Note Ne │ │ │ │ │ -00024710: 7477 6f72 6b3a 3a2e 0a0a 1f0a 4669 6c65 twork::.....File │ │ │ │ │ -00024720: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ -00024730: 6465 3a20 6e65 745f 3c49 4e54 4552 4641 de: net__hostname, N │ │ │ │ │ -00024750: 6578 743a 206e 6574 5f3c 494e 5445 5246 ext: net__ip, Prev: │ │ │ │ │ -00024770: 6e65 745f 3c49 4e54 4552 4641 4345 3e5f net__ │ │ │ │ │ -00024780: 6578 7465 6e73 696f 6e73 7061 7468 2c20 extensionspath, │ │ │ │ │ -00024790: 2055 703a 2053 7065 6369 616c 2065 6e76 Up: Special env │ │ │ │ │ -000247a0: 6972 6f6e 6d65 6e74 2076 6172 6961 626c ironment variabl │ │ │ │ │ -000247b0: 6573 0a0a 3135 2e31 2e32 3620 6e65 745f es..15.1.26 net_ │ │ │ │ │ -000247c0: 3c49 4e54 4552 4641 4345 3e5f 686f 7374 _host │ │ │ │ │ -000247d0: 6e61 6d65 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d name.----------- │ │ │ │ │ +00024700: 2d2d 2d2d 0a0a 2a4e 6f74 6520 4e65 7477 ----..*Note Netw │ │ │ │ │ +00024710: 6f72 6b3a 3a2e 0a0a 1f0a 4669 6c65 3a20 ork::.....File: │ │ │ │ │ +00024720: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ +00024730: 3a20 6e65 745f 3c49 4e54 4552 4641 4345 : net__hostname, Nex │ │ │ │ │ +00024750: 743a 206e 6574 5f3c 494e 5445 5246 4143 t: net__ip, Prev: ne │ │ │ │ │ +00024770: 745f 3c49 4e54 4552 4641 4345 3e5f 6578 t__ex │ │ │ │ │ +00024780: 7465 6e73 696f 6e73 7061 7468 2c20 2055 tensionspath, U │ │ │ │ │ +00024790: 703a 2053 7065 6369 616c 2065 6e76 6972 p: Special envir │ │ │ │ │ +000247a0: 6f6e 6d65 6e74 2076 6172 6961 626c 6573 onment variables │ │ │ │ │ +000247b0: 0a0a 3135 2e31 2e32 3620 6e65 745f 3c49 ..15.1.26 net__hostna │ │ │ │ │ +000247d0: 6d65 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d me.------------- │ │ │ │ │ 000247e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -000247f0: 2d2d 2d2d 2d0a 0a2a 4e6f 7465 204e 6574 -----..*Note Net │ │ │ │ │ -00024800: 776f 726b 3a3a 2e0a 0a1f 0a46 696c 653a work::.....File: │ │ │ │ │ -00024810: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ -00024820: 653a 206e 6574 5f3c 494e 5445 5246 4143 e: net__ip, Next: ne │ │ │ │ │ -00024840: 745f 3c49 4e54 4552 4641 4345 3e5f 6d61 t__ma │ │ │ │ │ -00024850: 632c 2020 5072 6576 3a20 6e65 745f 3c49 c, Prev: net__hostna │ │ │ │ │ -00024870: 6d65 2c20 2055 703a 2053 7065 6369 616c me, Up: Special │ │ │ │ │ -00024880: 2065 6e76 6972 6f6e 6d65 6e74 2076 6172 environment var │ │ │ │ │ -00024890: 6961 626c 6573 0a0a 3135 2e31 2e32 3720 iables..15.1.27 │ │ │ │ │ -000248a0: 6e65 745f 3c49 4e54 4552 4641 4345 3e5f net__ │ │ │ │ │ -000248b0: 6970 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ip.------------- │ │ │ │ │ -000248c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a2a -------------..* │ │ │ │ │ -000248d0: 4e6f 7465 204e 6574 776f 726b 3a3a 2e0a Note Network::.. │ │ │ │ │ -000248e0: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ -000248f0: 666f 2c20 204e 6f64 653a 206e 6574 5f3c fo, Node: net_< │ │ │ │ │ -00024900: 494e 5445 5246 4143 453e 5f6d 6163 2c20 INTERFACE>_mac, │ │ │ │ │ -00024910: 204e 6578 743a 206e 6574 5f3c 494e 5445 Next: net__next_serv │ │ │ │ │ -00024930: 6572 2c20 2050 7265 763a 206e 6574 5f3c er, Prev: net_< │ │ │ │ │ -00024940: 494e 5445 5246 4143 453e 5f69 702c 2020 INTERFACE>_ip, │ │ │ │ │ -00024950: 5570 3a20 5370 6563 6961 6c20 656e 7669 Up: Special envi │ │ │ │ │ -00024960: 726f 6e6d 656e 7420 7661 7269 6162 6c65 ronment variable │ │ │ │ │ -00024970: 730a 0a31 352e 312e 3238 206e 6574 5f3c s..15.1.28 net_< │ │ │ │ │ -00024980: 494e 5445 5246 4143 453e 5f6d 6163 0a2d INTERFACE>_mac.- │ │ │ │ │ +000247f0: 2d2d 2d0a 0a2a 4e6f 7465 204e 6574 776f ---..*Note Netwo │ │ │ │ │ +00024800: 726b 3a3a 2e0a 0a1f 0a46 696c 653a 2067 rk::.....File: g │ │ │ │ │ +00024810: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ +00024820: 206e 6574 5f3c 494e 5445 5246 4143 453e net_ │ │ │ │ │ +00024830: 5f69 702c 2020 4e65 7874 3a20 6e65 745f _ip, Next: net_ │ │ │ │ │ +00024840: 3c49 4e54 4552 4641 4345 3e5f 6d61 632c _mac, │ │ │ │ │ +00024850: 2020 5072 6576 3a20 6e65 745f 3c49 4e54 Prev: net__hostname │ │ │ │ │ +00024870: 2c20 2055 703a 2053 7065 6369 616c 2065 , Up: Special e │ │ │ │ │ +00024880: 6e76 6972 6f6e 6d65 6e74 2076 6172 6961 nvironment varia │ │ │ │ │ +00024890: 626c 6573 0a0a 3135 2e31 2e32 3720 6e65 bles..15.1.27 ne │ │ │ │ │ +000248a0: 745f 3c49 4e54 4552 4641 4345 3e5f 6970 t__ip │ │ │ │ │ +000248b0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ │ +000248c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a2a 4e6f -----------..*No │ │ │ │ │ +000248d0: 7465 204e 6574 776f 726b 3a3a 2e0a 0a1f te Network::.... │ │ │ │ │ +000248e0: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ +000248f0: 2c20 204e 6f64 653a 206e 6574 5f3c 494e , Node: net__mac, N │ │ │ │ │ +00024910: 6578 743a 206e 6574 5f3c 494e 5445 5246 ext: net__next_server │ │ │ │ │ +00024930: 2c20 2050 7265 763a 206e 6574 5f3c 494e , Prev: net__ip, Up │ │ │ │ │ +00024950: 3a20 5370 6563 6961 6c20 656e 7669 726f : Special enviro │ │ │ │ │ +00024960: 6e6d 656e 7420 7661 7269 6162 6c65 730a nment variables. │ │ │ │ │ +00024970: 0a31 352e 312e 3238 206e 6574 5f3c 494e .15.1.28 net__mac.--- │ │ │ │ │ 00024990: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -000249a0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2a4e 6f74 ----------..*Not │ │ │ │ │ -000249b0: 6520 4e65 7477 6f72 6b3a 3a2e 0a0a 1f0a e Network::..... │ │ │ │ │ -000249c0: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ -000249d0: 2020 4e6f 6465 3a20 6e65 745f 3c49 4e54 Node: net__next_ser │ │ │ │ │ -000249f0: 7665 722c 2020 4e65 7874 3a20 6e65 745f ver, Next: net_ │ │ │ │ │ -00024a00: 3c49 4e54 4552 4641 4345 3e5f 726f 6f74 _root │ │ │ │ │ -00024a10: 7061 7468 2c20 2050 7265 763a 206e 6574 path, Prev: net │ │ │ │ │ -00024a20: 5f3c 494e 5445 5246 4143 453e 5f6d 6163 __mac │ │ │ │ │ -00024a30: 2c20 2055 703a 2053 7065 6369 616c 2065 , Up: Special e │ │ │ │ │ -00024a40: 6e76 6972 6f6e 6d65 6e74 2076 6172 6961 nvironment varia │ │ │ │ │ -00024a50: 626c 6573 0a0a 3135 2e31 2e32 3920 6e65 bles..15.1.29 ne │ │ │ │ │ -00024a60: 745f 3c49 4e54 4552 4641 4345 3e5f 6e65 t__ne │ │ │ │ │ -00024a70: 7874 5f73 6572 7665 720a 2d2d 2d2d 2d2d xt_server.------ │ │ │ │ │ +000249a0: 2d2d 2d2d 2d2d 2d2d 0a0a 2a4e 6f74 6520 --------..*Note │ │ │ │ │ +000249b0: 4e65 7477 6f72 6b3a 3a2e 0a0a 1f0a 4669 Network::.....Fi │ │ │ │ │ +000249c0: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ +000249d0: 4e6f 6465 3a20 6e65 745f 3c49 4e54 4552 Node: net__next_serve │ │ │ │ │ +000249f0: 722c 2020 4e65 7874 3a20 6e65 745f 3c49 r, Next: net__rootpa │ │ │ │ │ +00024a10: 7468 2c20 2050 7265 763a 206e 6574 5f3c th, Prev: net_< │ │ │ │ │ +00024a20: 494e 5445 5246 4143 453e 5f6d 6163 2c20 INTERFACE>_mac, │ │ │ │ │ +00024a30: 2055 703a 2053 7065 6369 616c 2065 6e76 Up: Special env │ │ │ │ │ +00024a40: 6972 6f6e 6d65 6e74 2076 6172 6961 626c ironment variabl │ │ │ │ │ +00024a50: 6573 0a0a 3135 2e31 2e32 3920 6e65 745f es..15.1.29 net_ │ │ │ │ │ +00024a60: 3c49 4e54 4552 4641 4345 3e5f 6e65 7874 _next │ │ │ │ │ +00024a70: 5f73 6572 7665 720a 2d2d 2d2d 2d2d 2d2d _server.-------- │ │ │ │ │ 00024a80: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00024a90: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a2a -------------..* │ │ │ │ │ -00024aa0: 4e6f 7465 204e 6574 776f 726b 3a3a 2e0a Note Network::.. │ │ │ │ │ -00024ab0: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ -00024ac0: 666f 2c20 204e 6f64 653a 206e 6574 5f3c fo, Node: net_< │ │ │ │ │ -00024ad0: 494e 5445 5246 4143 453e 5f72 6f6f 7470 INTERFACE>_rootp │ │ │ │ │ -00024ae0: 6174 682c 2020 4e65 7874 3a20 6e65 745f ath, Next: net_ │ │ │ │ │ -00024af0: 6465 6661 756c 745f 696e 7465 7266 6163 default_interfac │ │ │ │ │ -00024b00: 652c 2020 5072 6576 3a20 6e65 745f 3c49 e, Prev: net__next_s │ │ │ │ │ -00024b20: 6572 7665 722c 2020 5570 3a20 5370 6563 erver, Up: Spec │ │ │ │ │ -00024b30: 6961 6c20 656e 7669 726f 6e6d 656e 7420 ial environment │ │ │ │ │ -00024b40: 7661 7269 6162 6c65 730a 0a31 352e 312e variables..15.1. │ │ │ │ │ -00024b50: 3330 206e 6574 5f3c 494e 5445 5246 4143 30 net__rootpath.---- │ │ │ │ │ +00024a90: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a2a 4e6f -----------..*No │ │ │ │ │ +00024aa0: 7465 204e 6574 776f 726b 3a3a 2e0a 0a1f te Network::.... │ │ │ │ │ +00024ab0: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ +00024ac0: 2c20 204e 6f64 653a 206e 6574 5f3c 494e , Node: net__rootpat │ │ │ │ │ +00024ae0: 682c 2020 4e65 7874 3a20 6e65 745f 6465 h, Next: net_de │ │ │ │ │ +00024af0: 6661 756c 745f 696e 7465 7266 6163 652c fault_interface, │ │ │ │ │ +00024b00: 2020 5072 6576 3a20 6e65 745f 3c49 4e54 Prev: net__next_ser │ │ │ │ │ +00024b20: 7665 722c 2020 5570 3a20 5370 6563 6961 ver, Up: Specia │ │ │ │ │ +00024b30: 6c20 656e 7669 726f 6e6d 656e 7420 7661 l environment va │ │ │ │ │ +00024b40: 7269 6162 6c65 730a 0a31 352e 312e 3330 riables..15.1.30 │ │ │ │ │ +00024b50: 206e 6574 5f3c 494e 5445 5246 4143 453e net_ │ │ │ │ │ +00024b60: 5f72 6f6f 7470 6174 680a 2d2d 2d2d 2d2d _rootpath.------ │ │ │ │ │ 00024b70: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00024b80: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2a4e ------------..*N │ │ │ │ │ -00024b90: 6f74 6520 4e65 7477 6f72 6b3a 3a2e 0a0a ote Network::... │ │ │ │ │ -00024ba0: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ -00024bb0: 6f2c 2020 4e6f 6465 3a20 6e65 745f 6465 o, Node: net_de │ │ │ │ │ -00024bc0: 6661 756c 745f 696e 7465 7266 6163 652c fault_interface, │ │ │ │ │ -00024bd0: 2020 4e65 7874 3a20 6e65 745f 6465 6661 Next: net_defa │ │ │ │ │ -00024be0: 756c 745f 6970 2c20 2050 7265 763a 206e ult_ip, Prev: n │ │ │ │ │ -00024bf0: 6574 5f3c 494e 5445 5246 4143 453e 5f72 et__r │ │ │ │ │ -00024c00: 6f6f 7470 6174 682c 2020 5570 3a20 5370 ootpath, Up: Sp │ │ │ │ │ -00024c10: 6563 6961 6c20 656e 7669 726f 6e6d 656e ecial environmen │ │ │ │ │ -00024c20: 7420 7661 7269 6162 6c65 730a 0a31 352e t variables..15. │ │ │ │ │ -00024c30: 312e 3331 206e 6574 5f64 6566 6175 6c74 1.31 net_default │ │ │ │ │ -00024c40: 5f69 6e74 6572 6661 6365 0a2d 2d2d 2d2d _interface.----- │ │ │ │ │ +00024b80: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2a4e 6f74 ----------..*Not │ │ │ │ │ +00024b90: 6520 4e65 7477 6f72 6b3a 3a2e 0a0a 1f0a e Network::..... │ │ │ │ │ +00024ba0: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ +00024bb0: 2020 4e6f 6465 3a20 6e65 745f 6465 6661 Node: net_defa │ │ │ │ │ +00024bc0: 756c 745f 696e 7465 7266 6163 652c 2020 ult_interface, │ │ │ │ │ +00024bd0: 4e65 7874 3a20 6e65 745f 6465 6661 756c Next: net_defaul │ │ │ │ │ +00024be0: 745f 6970 2c20 2050 7265 763a 206e 6574 t_ip, Prev: net │ │ │ │ │ +00024bf0: 5f3c 494e 5445 5246 4143 453e 5f72 6f6f __roo │ │ │ │ │ +00024c00: 7470 6174 682c 2020 5570 3a20 5370 6563 tpath, Up: Spec │ │ │ │ │ +00024c10: 6961 6c20 656e 7669 726f 6e6d 656e 7420 ial environment │ │ │ │ │ +00024c20: 7661 7269 6162 6c65 730a 0a31 352e 312e variables..15.1. │ │ │ │ │ +00024c30: 3331 206e 6574 5f64 6566 6175 6c74 5f69 31 net_default_i │ │ │ │ │ +00024c40: 6e74 6572 6661 6365 0a2d 2d2d 2d2d 2d2d nterface.------- │ │ │ │ │ 00024c50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00024c60: 2d2d 2d2d 2d2d 2d2d 0a0a 2a4e 6f74 6520 --------..*Note │ │ │ │ │ -00024c70: 4e65 7477 6f72 6b3a 3a2e 0a0a 1f0a 4669 Network::.....Fi │ │ │ │ │ -00024c80: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ -00024c90: 4e6f 6465 3a20 6e65 745f 6465 6661 756c Node: net_defaul │ │ │ │ │ -00024ca0: 745f 6970 2c20 204e 6578 743a 206e 6574 t_ip, Next: net │ │ │ │ │ -00024cb0: 5f64 6566 6175 6c74 5f6d 6163 2c20 2050 _default_mac, P │ │ │ │ │ -00024cc0: 7265 763a 206e 6574 5f64 6566 6175 6c74 rev: net_default │ │ │ │ │ -00024cd0: 5f69 6e74 6572 6661 6365 2c20 2055 703a _interface, Up: │ │ │ │ │ -00024ce0: 2053 7065 6369 616c 2065 6e76 6972 6f6e Special environ │ │ │ │ │ -00024cf0: 6d65 6e74 2076 6172 6961 626c 6573 0a0a ment variables.. │ │ │ │ │ -00024d00: 3135 2e31 2e33 3220 6e65 745f 6465 6661 15.1.32 net_defa │ │ │ │ │ -00024d10: 756c 745f 6970 0a2d 2d2d 2d2d 2d2d 2d2d ult_ip.--------- │ │ │ │ │ -00024d20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a2a -------------..* │ │ │ │ │ -00024d30: 4e6f 7465 204e 6574 776f 726b 3a3a 2e0a Note Network::.. │ │ │ │ │ -00024d40: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ -00024d50: 666f 2c20 204e 6f64 653a 206e 6574 5f64 fo, Node: net_d │ │ │ │ │ -00024d60: 6566 6175 6c74 5f6d 6163 2c20 204e 6578 efault_mac, Nex │ │ │ │ │ -00024d70: 743a 206e 6574 5f64 6566 6175 6c74 5f73 t: net_default_s │ │ │ │ │ -00024d80: 6572 7665 722c 2020 5072 6576 3a20 6e65 erver, Prev: ne │ │ │ │ │ -00024d90: 745f 6465 6661 756c 745f 6970 2c20 2055 t_default_ip, U │ │ │ │ │ -00024da0: 703a 2053 7065 6369 616c 2065 6e76 6972 p: Special envir │ │ │ │ │ -00024db0: 6f6e 6d65 6e74 2076 6172 6961 626c 6573 onment variables │ │ │ │ │ -00024dc0: 0a0a 3135 2e31 2e33 3320 6e65 745f 6465 ..15.1.33 net_de │ │ │ │ │ -00024dd0: 6661 756c 745f 6d61 630a 2d2d 2d2d 2d2d fault_mac.------ │ │ │ │ │ -00024de0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00024df0: 2d0a 0a2a 4e6f 7465 204e 6574 776f 726b -..*Note Network │ │ │ │ │ -00024e00: 3a3a 2e0a 0a1f 0a46 696c 653a 2067 7275 ::.....File: gru │ │ │ │ │ -00024e10: 622e 696e 666f 2c20 204e 6f64 653a 206e b.info, Node: n │ │ │ │ │ -00024e20: 6574 5f64 6566 6175 6c74 5f73 6572 7665 et_default_serve │ │ │ │ │ -00024e30: 722c 2020 4e65 7874 3a20 7061 6765 722c r, Next: pager, │ │ │ │ │ -00024e40: 2020 5072 6576 3a20 6e65 745f 6465 6661 Prev: net_defa │ │ │ │ │ -00024e50: 756c 745f 6d61 632c 2020 5570 3a20 5370 ult_mac, Up: Sp │ │ │ │ │ -00024e60: 6563 6961 6c20 656e 7669 726f 6e6d 656e ecial environmen │ │ │ │ │ -00024e70: 7420 7661 7269 6162 6c65 730a 0a31 352e t variables..15. │ │ │ │ │ -00024e80: 312e 3334 206e 6574 5f64 6566 6175 6c74 1.34 net_default │ │ │ │ │ -00024e90: 5f73 6572 7665 720a 2d2d 2d2d 2d2d 2d2d _server.-------- │ │ │ │ │ +00024c60: 2d2d 2d2d 2d2d 0a0a 2a4e 6f74 6520 4e65 ------..*Note Ne │ │ │ │ │ +00024c70: 7477 6f72 6b3a 3a2e 0a0a 1f0a 4669 6c65 twork::.....File │ │ │ │ │ +00024c80: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ +00024c90: 6465 3a20 6e65 745f 6465 6661 756c 745f de: net_default_ │ │ │ │ │ +00024ca0: 6970 2c20 204e 6578 743a 206e 6574 5f64 ip, Next: net_d │ │ │ │ │ +00024cb0: 6566 6175 6c74 5f6d 6163 2c20 2050 7265 efault_mac, Pre │ │ │ │ │ +00024cc0: 763a 206e 6574 5f64 6566 6175 6c74 5f69 v: net_default_i │ │ │ │ │ +00024cd0: 6e74 6572 6661 6365 2c20 2055 703a 2053 nterface, Up: S │ │ │ │ │ +00024ce0: 7065 6369 616c 2065 6e76 6972 6f6e 6d65 pecial environme │ │ │ │ │ +00024cf0: 6e74 2076 6172 6961 626c 6573 0a0a 3135 nt variables..15 │ │ │ │ │ +00024d00: 2e31 2e33 3220 6e65 745f 6465 6661 756c .1.32 net_defaul │ │ │ │ │ +00024d10: 745f 6970 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d t_ip.----------- │ │ │ │ │ +00024d20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a2a 4e6f -----------..*No │ │ │ │ │ +00024d30: 7465 204e 6574 776f 726b 3a3a 2e0a 0a1f te Network::.... │ │ │ │ │ +00024d40: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ +00024d50: 2c20 204e 6f64 653a 206e 6574 5f64 6566 , Node: net_def │ │ │ │ │ +00024d60: 6175 6c74 5f6d 6163 2c20 204e 6578 743a ault_mac, Next: │ │ │ │ │ +00024d70: 206e 6574 5f64 6566 6175 6c74 5f73 6572 net_default_ser │ │ │ │ │ +00024d80: 7665 722c 2020 5072 6576 3a20 6e65 745f ver, Prev: net_ │ │ │ │ │ +00024d90: 6465 6661 756c 745f 6970 2c20 2055 703a default_ip, Up: │ │ │ │ │ +00024da0: 2053 7065 6369 616c 2065 6e76 6972 6f6e Special environ │ │ │ │ │ +00024db0: 6d65 6e74 2076 6172 6961 626c 6573 0a0a ment variables.. │ │ │ │ │ +00024dc0: 3135 2e31 2e33 3320 6e65 745f 6465 6661 15.1.33 net_defa │ │ │ │ │ +00024dd0: 756c 745f 6d61 630a 2d2d 2d2d 2d2d 2d2d ult_mac.-------- │ │ │ │ │ +00024de0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ +00024df0: 0a2a 4e6f 7465 204e 6574 776f 726b 3a3a .*Note Network:: │ │ │ │ │ +00024e00: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ +00024e10: 696e 666f 2c20 204e 6f64 653a 206e 6574 info, Node: net │ │ │ │ │ +00024e20: 5f64 6566 6175 6c74 5f73 6572 7665 722c _default_server, │ │ │ │ │ +00024e30: 2020 4e65 7874 3a20 7061 6765 722c 2020 Next: pager, │ │ │ │ │ +00024e40: 5072 6576 3a20 6e65 745f 6465 6661 756c Prev: net_defaul │ │ │ │ │ +00024e50: 745f 6d61 632c 2020 5570 3a20 5370 6563 t_mac, Up: Spec │ │ │ │ │ +00024e60: 6961 6c20 656e 7669 726f 6e6d 656e 7420 ial environment │ │ │ │ │ +00024e70: 7661 7269 6162 6c65 730a 0a31 352e 312e variables..15.1. │ │ │ │ │ +00024e80: 3334 206e 6574 5f64 6566 6175 6c74 5f73 34 net_default_s │ │ │ │ │ +00024e90: 6572 7665 720a 2d2d 2d2d 2d2d 2d2d 2d2d erver.---------- │ │ │ │ │ 00024ea0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00024eb0: 2d2d 0a0a 2a4e 6f74 6520 4e65 7477 6f72 --..*Note Networ │ │ │ │ │ -00024ec0: 6b3a 3a2e 0a0a 1f0a 4669 6c65 3a20 6772 k::.....File: gr │ │ │ │ │ -00024ed0: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ -00024ee0: 7061 6765 722c 2020 4e65 7874 3a20 7072 pager, Next: pr │ │ │ │ │ -00024ef0: 6566 6978 2c20 2050 7265 763a 206e 6574 efix, Prev: net │ │ │ │ │ -00024f00: 5f64 6566 6175 6c74 5f73 6572 7665 722c _default_server, │ │ │ │ │ -00024f10: 2020 5570 3a20 5370 6563 6961 6c20 656e Up: Special en │ │ │ │ │ -00024f20: 7669 726f 6e6d 656e 7420 7661 7269 6162 vironment variab │ │ │ │ │ -00024f30: 6c65 730a 0a31 352e 312e 3335 2070 6167 les..15.1.35 pag │ │ │ │ │ -00024f40: 6572 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d er.------------- │ │ │ │ │ -00024f50: 0a0a 4966 2073 6574 2074 6f20 2731 272c ..If set to '1', │ │ │ │ │ -00024f60: 2070 6175 7365 206f 7574 7075 7420 6166 pause output af │ │ │ │ │ -00024f70: 7465 7220 6561 6368 2073 6372 6565 6e66 ter each screenf │ │ │ │ │ -00024f80: 756c 2061 6e64 2077 6169 7420 666f 7220 ul and wait for │ │ │ │ │ -00024f90: 6b65 7962 6f61 7264 0a69 6e70 7574 2e20 keyboard.input. │ │ │ │ │ -00024fa0: 2054 6865 2064 6566 6175 6c74 2069 7320 The default is │ │ │ │ │ -00024fb0: 6e6f 7420 746f 2070 6175 7365 206f 7574 not to pause out │ │ │ │ │ -00024fc0: 7075 742e 0a0a 1f0a 4669 6c65 3a20 6772 put.....File: gr │ │ │ │ │ -00024fd0: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ -00024fe0: 7072 6566 6978 2c20 204e 6578 743a 2070 prefix, Next: p │ │ │ │ │ -00024ff0: 7865 5f62 6c6b 7369 7a65 2c20 2050 7265 xe_blksize, Pre │ │ │ │ │ -00025000: 763a 2070 6167 6572 2c20 2055 703a 2053 v: pager, Up: S │ │ │ │ │ -00025010: 7065 6369 616c 2065 6e76 6972 6f6e 6d65 pecial environme │ │ │ │ │ -00025020: 6e74 2076 6172 6961 626c 6573 0a0a 3135 nt variables..15 │ │ │ │ │ -00025030: 2e31 2e33 3620 7072 6566 6978 0a2d 2d2d .1.36 prefix.--- │ │ │ │ │ -00025040: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a54 6865 -----------..The │ │ │ │ │ -00025050: 206c 6f63 6174 696f 6e20 6f66 2074 6865 location of the │ │ │ │ │ -00025060: 2027 2f62 6f6f 742f 6772 7562 2720 6469 '/boot/grub' di │ │ │ │ │ -00025070: 7265 6374 6f72 7920 6173 2061 6e20 6162 rectory as an ab │ │ │ │ │ -00025080: 736f 6c75 7465 2066 696c 6520 6e61 6d65 solute file name │ │ │ │ │ -00025090: 0a28 2a6e 6f74 6520 4669 6c65 206e 616d .(*note File nam │ │ │ │ │ -000250a0: 6520 7379 6e74 6178 3a3a 292e 2020 5468 e syntax::). Th │ │ │ │ │ -000250b0: 6973 2069 7320 6e6f 726d 616c 6c79 2073 is is normally s │ │ │ │ │ -000250c0: 6574 2062 7920 4752 5542 2061 7420 7374 et by GRUB at st │ │ │ │ │ -000250d0: 6172 7475 700a 6261 7365 6420 6f6e 2069 artup.based on i │ │ │ │ │ -000250e0: 6e66 6f72 6d61 7469 6f6e 2070 726f 7669 nformation provi │ │ │ │ │ -000250f0: 6465 6420 6279 2027 6772 7562 2d69 6e73 ded by 'grub-ins │ │ │ │ │ -00025100: 7461 6c6c 272e 2020 4752 5542 206d 6f64 tall'. GRUB mod │ │ │ │ │ -00025110: 756c 6573 2061 7265 0a64 796e 616d 6963 ules are.dynamic │ │ │ │ │ -00025120: 616c 6c79 206c 6f61 6465 6420 6672 6f6d ally loaded from │ │ │ │ │ -00025130: 2074 6869 7320 6469 7265 6374 6f72 792c this directory, │ │ │ │ │ -00025140: 2073 6f20 6974 206d 7573 7420 6265 2073 so it must be s │ │ │ │ │ -00025150: 6574 2063 6f72 7265 6374 6c79 2069 6e0a et correctly in. │ │ │ │ │ -00025160: 6f72 6465 7220 666f 7220 6d61 6e79 2070 order for many p │ │ │ │ │ -00025170: 6172 7473 206f 6620 4752 5542 2074 6f20 arts of GRUB to │ │ │ │ │ -00025180: 776f 726b 2e0a 0a1f 0a46 696c 653a 2067 work.....File: g │ │ │ │ │ -00025190: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ -000251a0: 2070 7865 5f62 6c6b 7369 7a65 2c20 204e pxe_blksize, N │ │ │ │ │ -000251b0: 6578 743a 2070 7865 5f64 6566 6175 6c74 ext: pxe_default │ │ │ │ │ -000251c0: 5f67 6174 6577 6179 2c20 2050 7265 763a _gateway, Prev: │ │ │ │ │ -000251d0: 2070 7265 6669 782c 2020 5570 3a20 5370 prefix, Up: Sp │ │ │ │ │ -000251e0: 6563 6961 6c20 656e 7669 726f 6e6d 656e ecial environmen │ │ │ │ │ -000251f0: 7420 7661 7269 6162 6c65 730a 0a31 352e t variables..15. │ │ │ │ │ -00025200: 312e 3337 2070 7865 5f62 6c6b 7369 7a65 1.37 pxe_blksize │ │ │ │ │ -00025210: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ │ -00025220: 2d2d 2d2d 0a0a 2a4e 6f74 6520 4e65 7477 ----..*Note Netw │ │ │ │ │ -00025230: 6f72 6b3a 3a2e 0a0a 1f0a 4669 6c65 3a20 ork::.....File: │ │ │ │ │ -00025240: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ -00025250: 3a20 7078 655f 6465 6661 756c 745f 6761 : pxe_default_ga │ │ │ │ │ -00025260: 7465 7761 792c 2020 4e65 7874 3a20 7078 teway, Next: px │ │ │ │ │ -00025270: 655f 6465 6661 756c 745f 7365 7276 6572 e_default_server │ │ │ │ │ -00025280: 2c20 2050 7265 763a 2070 7865 5f62 6c6b , Prev: pxe_blk │ │ │ │ │ -00025290: 7369 7a65 2c20 2055 703a 2053 7065 6369 size, Up: Speci │ │ │ │ │ -000252a0: 616c 2065 6e76 6972 6f6e 6d65 6e74 2076 al environment v │ │ │ │ │ -000252b0: 6172 6961 626c 6573 0a0a 3135 2e31 2e33 ariables..15.1.3 │ │ │ │ │ -000252c0: 3820 7078 655f 6465 6661 756c 745f 6761 8 pxe_default_ga │ │ │ │ │ -000252d0: 7465 7761 790a 2d2d 2d2d 2d2d 2d2d 2d2d teway.---------- │ │ │ │ │ -000252e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -000252f0: 2d0a 0a2a 4e6f 7465 204e 6574 776f 726b -..*Note Network │ │ │ │ │ -00025300: 3a3a 2e0a 0a1f 0a46 696c 653a 2067 7275 ::.....File: gru │ │ │ │ │ -00025310: 622e 696e 666f 2c20 204e 6f64 653a 2070 b.info, Node: p │ │ │ │ │ -00025320: 7865 5f64 6566 6175 6c74 5f73 6572 7665 xe_default_serve │ │ │ │ │ -00025330: 722c 2020 4e65 7874 3a20 726f 6f74 2c20 r, Next: root, │ │ │ │ │ -00025340: 2050 7265 763a 2070 7865 5f64 6566 6175 Prev: pxe_defau │ │ │ │ │ -00025350: 6c74 5f67 6174 6577 6179 2c20 2055 703a lt_gateway, Up: │ │ │ │ │ -00025360: 2053 7065 6369 616c 2065 6e76 6972 6f6e Special environ │ │ │ │ │ -00025370: 6d65 6e74 2076 6172 6961 626c 6573 0a0a ment variables.. │ │ │ │ │ -00025380: 3135 2e31 2e33 3920 7078 655f 6465 6661 15.1.39 pxe_defa │ │ │ │ │ -00025390: 756c 745f 7365 7276 6572 0a2d 2d2d 2d2d ult_server.----- │ │ │ │ │ +00024eb0: 0a0a 2a4e 6f74 6520 4e65 7477 6f72 6b3a ..*Note Network: │ │ │ │ │ +00024ec0: 3a2e 0a0a 1f0a 4669 6c65 3a20 6772 7562 :.....File: grub │ │ │ │ │ +00024ed0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 7061 .info, Node: pa │ │ │ │ │ +00024ee0: 6765 722c 2020 4e65 7874 3a20 7072 6566 ger, Next: pref │ │ │ │ │ +00024ef0: 6978 2c20 2050 7265 763a 206e 6574 5f64 ix, Prev: net_d │ │ │ │ │ +00024f00: 6566 6175 6c74 5f73 6572 7665 722c 2020 efault_server, │ │ │ │ │ +00024f10: 5570 3a20 5370 6563 6961 6c20 656e 7669 Up: Special envi │ │ │ │ │ +00024f20: 726f 6e6d 656e 7420 7661 7269 6162 6c65 ronment variable │ │ │ │ │ +00024f30: 730a 0a31 352e 312e 3335 2070 6167 6572 s..15.1.35 pager │ │ │ │ │ +00024f40: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a .-------------.. │ │ │ │ │ +00024f50: 4966 2073 6574 2074 6f20 2731 272c 2070 If set to '1', p │ │ │ │ │ +00024f60: 6175 7365 206f 7574 7075 7420 6166 7465 ause output afte │ │ │ │ │ +00024f70: 7220 6561 6368 2073 6372 6565 6e66 756c r each screenful │ │ │ │ │ +00024f80: 2061 6e64 2077 6169 7420 666f 7220 6b65 and wait for ke │ │ │ │ │ +00024f90: 7962 6f61 7264 0a69 6e70 7574 2e20 2054 yboard.input. T │ │ │ │ │ +00024fa0: 6865 2064 6566 6175 6c74 2069 7320 6e6f he default is no │ │ │ │ │ +00024fb0: 7420 746f 2070 6175 7365 206f 7574 7075 t to pause outpu │ │ │ │ │ +00024fc0: 742e 0a0a 1f0a 4669 6c65 3a20 6772 7562 t.....File: grub │ │ │ │ │ +00024fd0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 7072 .info, Node: pr │ │ │ │ │ +00024fe0: 6566 6978 2c20 204e 6578 743a 2070 7865 efix, Next: pxe │ │ │ │ │ +00024ff0: 5f62 6c6b 7369 7a65 2c20 2050 7265 763a _blksize, Prev: │ │ │ │ │ +00025000: 2070 6167 6572 2c20 2055 703a 2053 7065 pager, Up: Spe │ │ │ │ │ +00025010: 6369 616c 2065 6e76 6972 6f6e 6d65 6e74 cial environment │ │ │ │ │ +00025020: 2076 6172 6961 626c 6573 0a0a 3135 2e31 variables..15.1 │ │ │ │ │ +00025030: 2e33 3620 7072 6566 6978 0a2d 2d2d 2d2d .36 prefix.----- │ │ │ │ │ +00025040: 2d2d 2d2d 2d2d 2d2d 2d0a 0a54 6865 206c ---------..The l │ │ │ │ │ +00025050: 6f63 6174 696f 6e20 6f66 2074 6865 2027 ocation of the ' │ │ │ │ │ +00025060: 2f62 6f6f 742f 6772 7562 2720 6469 7265 /boot/grub' dire │ │ │ │ │ +00025070: 6374 6f72 7920 6173 2061 6e20 6162 736f ctory as an abso │ │ │ │ │ +00025080: 6c75 7465 2066 696c 6520 6e61 6d65 0a28 lute file name.( │ │ │ │ │ +00025090: 2a6e 6f74 6520 4669 6c65 206e 616d 6520 *note File name │ │ │ │ │ +000250a0: 7379 6e74 6178 3a3a 292e 2020 5468 6973 syntax::). This │ │ │ │ │ +000250b0: 2069 7320 6e6f 726d 616c 6c79 2073 6574 is normally set │ │ │ │ │ +000250c0: 2062 7920 4752 5542 2061 7420 7374 6172 by GRUB at star │ │ │ │ │ +000250d0: 7475 700a 6261 7365 6420 6f6e 2069 6e66 tup.based on inf │ │ │ │ │ +000250e0: 6f72 6d61 7469 6f6e 2070 726f 7669 6465 ormation provide │ │ │ │ │ +000250f0: 6420 6279 2027 6772 7562 2d69 6e73 7461 d by 'grub-insta │ │ │ │ │ +00025100: 6c6c 272e 2020 4752 5542 206d 6f64 756c ll'. GRUB modul │ │ │ │ │ +00025110: 6573 2061 7265 0a64 796e 616d 6963 616c es are.dynamical │ │ │ │ │ +00025120: 6c79 206c 6f61 6465 6420 6672 6f6d 2074 ly loaded from t │ │ │ │ │ +00025130: 6869 7320 6469 7265 6374 6f72 792c 2073 his directory, s │ │ │ │ │ +00025140: 6f20 6974 206d 7573 7420 6265 2073 6574 o it must be set │ │ │ │ │ +00025150: 2063 6f72 7265 6374 6c79 2069 6e0a 6f72 correctly in.or │ │ │ │ │ +00025160: 6465 7220 666f 7220 6d61 6e79 2070 6172 der for many par │ │ │ │ │ +00025170: 7473 206f 6620 4752 5542 2074 6f20 776f ts of GRUB to wo │ │ │ │ │ +00025180: 726b 2e0a 0a1f 0a46 696c 653a 2067 7275 rk.....File: gru │ │ │ │ │ +00025190: 622e 696e 666f 2c20 204e 6f64 653a 2070 b.info, Node: p │ │ │ │ │ +000251a0: 7865 5f62 6c6b 7369 7a65 2c20 204e 6578 xe_blksize, Nex │ │ │ │ │ +000251b0: 743a 2070 7865 5f64 6566 6175 6c74 5f67 t: pxe_default_g │ │ │ │ │ +000251c0: 6174 6577 6179 2c20 2050 7265 763a 2070 ateway, Prev: p │ │ │ │ │ +000251d0: 7265 6669 782c 2020 5570 3a20 5370 6563 refix, Up: Spec │ │ │ │ │ +000251e0: 6961 6c20 656e 7669 726f 6e6d 656e 7420 ial environment │ │ │ │ │ +000251f0: 7661 7269 6162 6c65 730a 0a31 352e 312e variables..15.1. │ │ │ │ │ +00025200: 3337 2070 7865 5f62 6c6b 7369 7a65 0a2d 37 pxe_blksize.- │ │ │ │ │ +00025210: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ +00025220: 2d2d 0a0a 2a4e 6f74 6520 4e65 7477 6f72 --..*Note Networ │ │ │ │ │ +00025230: 6b3a 3a2e 0a0a 1f0a 4669 6c65 3a20 6772 k::.....File: gr │ │ │ │ │ +00025240: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ +00025250: 7078 655f 6465 6661 756c 745f 6761 7465 pxe_default_gate │ │ │ │ │ +00025260: 7761 792c 2020 4e65 7874 3a20 7078 655f way, Next: pxe_ │ │ │ │ │ +00025270: 6465 6661 756c 745f 7365 7276 6572 2c20 default_server, │ │ │ │ │ +00025280: 2050 7265 763a 2070 7865 5f62 6c6b 7369 Prev: pxe_blksi │ │ │ │ │ +00025290: 7a65 2c20 2055 703a 2053 7065 6369 616c ze, Up: Special │ │ │ │ │ +000252a0: 2065 6e76 6972 6f6e 6d65 6e74 2076 6172 environment var │ │ │ │ │ +000252b0: 6961 626c 6573 0a0a 3135 2e31 2e33 3820 iables..15.1.38 │ │ │ │ │ +000252c0: 7078 655f 6465 6661 756c 745f 6761 7465 pxe_default_gate │ │ │ │ │ +000252d0: 7761 790a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d way.------------ │ │ │ │ │ +000252e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ +000252f0: 0a2a 4e6f 7465 204e 6574 776f 726b 3a3a .*Note Network:: │ │ │ │ │ +00025300: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ +00025310: 696e 666f 2c20 204e 6f64 653a 2070 7865 info, Node: pxe │ │ │ │ │ +00025320: 5f64 6566 6175 6c74 5f73 6572 7665 722c _default_server, │ │ │ │ │ +00025330: 2020 4e65 7874 3a20 726f 6f74 2c20 2050 Next: root, P │ │ │ │ │ +00025340: 7265 763a 2070 7865 5f64 6566 6175 6c74 rev: pxe_default │ │ │ │ │ +00025350: 5f67 6174 6577 6179 2c20 2055 703a 2053 _gateway, Up: S │ │ │ │ │ +00025360: 7065 6369 616c 2065 6e76 6972 6f6e 6d65 pecial environme │ │ │ │ │ +00025370: 6e74 2076 6172 6961 626c 6573 0a0a 3135 nt variables..15 │ │ │ │ │ +00025380: 2e31 2e33 3920 7078 655f 6465 6661 756c .1.39 pxe_defaul │ │ │ │ │ +00025390: 745f 7365 7276 6572 0a2d 2d2d 2d2d 2d2d t_server.------- │ │ │ │ │ 000253a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -000253b0: 2d2d 2d2d 2d0a 0a2a 4e6f 7465 204e 6574 -----..*Note Net │ │ │ │ │ -000253c0: 776f 726b 3a3a 2e0a 0a1f 0a46 696c 653a work::.....File: │ │ │ │ │ -000253d0: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ -000253e0: 653a 2072 6f6f 742c 2020 4e65 7874 3a20 e: root, Next: │ │ │ │ │ -000253f0: 7375 7065 7275 7365 7273 2c20 2050 7265 superusers, Pre │ │ │ │ │ -00025400: 763a 2070 7865 5f64 6566 6175 6c74 5f73 v: pxe_default_s │ │ │ │ │ -00025410: 6572 7665 722c 2020 5570 3a20 5370 6563 erver, Up: Spec │ │ │ │ │ -00025420: 6961 6c20 656e 7669 726f 6e6d 656e 7420 ial environment │ │ │ │ │ -00025430: 7661 7269 6162 6c65 730a 0a31 352e 312e variables..15.1. │ │ │ │ │ -00025440: 3430 2072 6f6f 740a 2d2d 2d2d 2d2d 2d2d 40 root.-------- │ │ │ │ │ -00025450: 2d2d 2d2d 0a0a 5468 6520 726f 6f74 2064 ----..The root d │ │ │ │ │ -00025460: 6576 6963 6520 6e61 6d65 2028 2a6e 6f74 evice name (*not │ │ │ │ │ -00025470: 6520 4465 7669 6365 2073 796e 7461 783a e Device syntax: │ │ │ │ │ -00025480: 3a29 2e20 2041 6e79 2066 696c 6520 6e61 :). Any file na │ │ │ │ │ -00025490: 6d65 7320 7468 6174 2064 6f0a 6e6f 7420 mes that do.not │ │ │ │ │ -000254a0: 7370 6563 6966 7920 616e 2065 7870 6c69 specify an expli │ │ │ │ │ -000254b0: 6369 7420 6465 7669 6365 206e 616d 6520 cit device name │ │ │ │ │ -000254c0: 6172 6520 7265 6164 2066 726f 6d20 7468 are read from th │ │ │ │ │ -000254d0: 6973 2064 6576 6963 652e 2020 5468 650a is device. The. │ │ │ │ │ -000254e0: 6465 6661 756c 7420 6973 206e 6f72 6d61 default is norma │ │ │ │ │ -000254f0: 6c6c 7920 7365 7420 6279 2047 5255 4220 lly set by GRUB │ │ │ │ │ -00025500: 6174 2073 7461 7274 7570 2062 6173 6564 at startup based │ │ │ │ │ -00025510: 206f 6e20 7468 6520 7661 6c75 6520 6f66 on the value of │ │ │ │ │ -00025520: 0a27 7072 6566 6978 2720 282a 6e6f 7465 .'prefix' (*note │ │ │ │ │ -00025530: 2070 7265 6669 783a 3a29 2e0a 0a20 2020 prefix::)... │ │ │ │ │ -00025540: 466f 7220 6578 616d 706c 652c 2069 6620 For example, if │ │ │ │ │ -00025550: 4752 5542 2077 6173 2069 6e73 7461 6c6c GRUB was install │ │ │ │ │ -00025560: 6564 2074 6f20 7468 6520 6669 7273 7420 ed to the first │ │ │ │ │ -00025570: 7061 7274 6974 696f 6e20 6f66 2074 6865 partition of the │ │ │ │ │ -00025580: 0a66 6972 7374 2068 6172 6420 6469 736b .first hard disk │ │ │ │ │ -00025590: 2c20 7468 656e 2027 7072 6566 6978 2720 , then 'prefix' │ │ │ │ │ -000255a0: 6d69 6768 7420 6265 2073 6574 2074 6f20 might be set to │ │ │ │ │ -000255b0: 2728 6864 302c 6d73 646f 7331 292f 626f '(hd0,msdos1)/bo │ │ │ │ │ -000255c0: 6f74 2f67 7275 6227 0a61 6e64 2027 726f ot/grub'.and 'ro │ │ │ │ │ -000255d0: 6f74 2720 746f 2027 6864 302c 6d73 646f ot' to 'hd0,msdo │ │ │ │ │ -000255e0: 7331 272e 0a0a 1f0a 4669 6c65 3a20 6772 s1'.....File: gr │ │ │ │ │ -000255f0: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ -00025600: 7375 7065 7275 7365 7273 2c20 204e 6578 superusers, Nex │ │ │ │ │ -00025610: 743a 2074 6865 6d65 2c20 2050 7265 763a t: theme, Prev: │ │ │ │ │ -00025620: 2072 6f6f 742c 2020 5570 3a20 5370 6563 root, Up: Spec │ │ │ │ │ -00025630: 6961 6c20 656e 7669 726f 6e6d 656e 7420 ial environment │ │ │ │ │ -00025640: 7661 7269 6162 6c65 730a 0a31 352e 312e variables..15.1. │ │ │ │ │ -00025650: 3431 2073 7570 6572 7573 6572 730a 2d2d 41 superusers.-- │ │ │ │ │ -00025660: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00025670: 0a0a 5468 6973 2076 6172 6961 626c 6520 ..This variable │ │ │ │ │ -00025680: 6d61 7920 6265 2073 6574 2074 6f20 6120 may be set to a │ │ │ │ │ -00025690: 6c69 7374 206f 6620 7375 7065 7275 7365 list of superuse │ │ │ │ │ -000256a0: 7220 6e61 6d65 7320 746f 2065 6e61 626c r names to enabl │ │ │ │ │ -000256b0: 650a 6175 7468 656e 7469 6361 7469 6f6e e.authentication │ │ │ │ │ -000256c0: 2073 7570 706f 7274 2e20 202a 4e6f 7465 support. *Note │ │ │ │ │ -000256d0: 2053 6563 7572 6974 793a 3a2e 0a0a 1f0a Security::..... │ │ │ │ │ -000256e0: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ -000256f0: 2020 4e6f 6465 3a20 7468 656d 652c 2020 Node: theme, │ │ │ │ │ -00025700: 4e65 7874 3a20 7469 6d65 6f75 742c 2020 Next: timeout, │ │ │ │ │ -00025710: 5072 6576 3a20 7375 7065 7275 7365 7273 Prev: superusers │ │ │ │ │ -00025720: 2c20 2055 703a 2053 7065 6369 616c 2065 , Up: Special e │ │ │ │ │ -00025730: 6e76 6972 6f6e 6d65 6e74 2076 6172 6961 nvironment varia │ │ │ │ │ -00025740: 626c 6573 0a0a 3135 2e31 2e34 3220 7468 bles..15.1.42 th │ │ │ │ │ -00025750: 656d 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d eme.------------ │ │ │ │ │ -00025760: 2d0a 0a54 6869 7320 7661 7269 6162 6c65 -..This variable │ │ │ │ │ -00025770: 206d 6179 2062 6520 7365 7420 746f 2061 may be set to a │ │ │ │ │ -00025780: 2064 6972 6563 746f 7279 2063 6f6e 7461 directory conta │ │ │ │ │ -00025790: 696e 696e 6720 6120 4752 5542 2067 7261 ining a GRUB gra │ │ │ │ │ -000257a0: 7068 6963 616c 206d 656e 750a 7468 656d phical menu.them │ │ │ │ │ -000257b0: 652e 2020 2a4e 6f74 6520 5468 656d 6520 e. *Note Theme │ │ │ │ │ -000257c0: 6669 6c65 2066 6f72 6d61 743a 3a2e 0a0a file format::... │ │ │ │ │ -000257d0: 2020 2054 6869 7320 7661 7269 6162 6c65 This variable │ │ │ │ │ -000257e0: 2069 7320 6f66 7465 6e20 7365 7420 6279 is often set by │ │ │ │ │ -000257f0: 2027 4752 5542 5f54 4845 4d45 2720 282a 'GRUB_THEME' (* │ │ │ │ │ -00025800: 6e6f 7465 2053 696d 706c 650a 636f 6e66 note Simple.conf │ │ │ │ │ -00025810: 6967 7572 6174 696f 6e3a 3a29 2e0a 0a1f iguration::).... │ │ │ │ │ -00025820: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ -00025830: 2c20 204e 6f64 653a 2074 696d 656f 7574 , Node: timeout │ │ │ │ │ -00025840: 2c20 204e 6578 743a 2074 696d 656f 7574 , Next: timeout │ │ │ │ │ -00025850: 5f73 7479 6c65 2c20 2050 7265 763a 2074 _style, Prev: t │ │ │ │ │ -00025860: 6865 6d65 2c20 2055 703a 2053 7065 6369 heme, Up: Speci │ │ │ │ │ -00025870: 616c 2065 6e76 6972 6f6e 6d65 6e74 2076 al environment v │ │ │ │ │ -00025880: 6172 6961 626c 6573 0a0a 3135 2e31 2e34 ariables..15.1.4 │ │ │ │ │ -00025890: 3320 7469 6d65 6f75 740a 2d2d 2d2d 2d2d 3 timeout.------ │ │ │ │ │ -000258a0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a49 6620 7468 ---------..If th │ │ │ │ │ -000258b0: 6973 2076 6172 6961 626c 6520 6973 2073 is variable is s │ │ │ │ │ -000258c0: 6574 2c20 6974 2073 7065 6369 6669 6573 et, it specifies │ │ │ │ │ -000258d0: 2074 6865 2074 696d 6520 696e 2073 6563 the time in sec │ │ │ │ │ -000258e0: 6f6e 6473 2074 6f20 7761 6974 2066 6f72 onds to wait for │ │ │ │ │ -000258f0: 0a6b 6579 626f 6172 6420 696e 7075 7420 .keyboard input │ │ │ │ │ -00025900: 6265 666f 7265 2062 6f6f 7469 6e67 2074 before booting t │ │ │ │ │ -00025910: 6865 2064 6566 6175 6c74 206d 656e 7520 he default menu │ │ │ │ │ -00025920: 656e 7472 792e 2020 4120 7469 6d65 6f75 entry. A timeou │ │ │ │ │ -00025930: 7420 6f66 2027 3027 0a6d 6561 6e73 2074 t of '0'.means t │ │ │ │ │ -00025940: 6f20 626f 6f74 2074 6865 2064 6566 6175 o boot the defau │ │ │ │ │ -00025950: 6c74 2065 6e74 7279 2069 6d6d 6564 6961 lt entry immedia │ │ │ │ │ -00025960: 7465 6c79 2077 6974 686f 7574 2064 6973 tely without dis │ │ │ │ │ -00025970: 706c 6179 696e 6720 7468 6520 6d65 6e75 playing the menu │ │ │ │ │ -00025980: 3b0a 6120 7469 6d65 6f75 7420 6f66 2027 ;.a timeout of ' │ │ │ │ │ -00025990: 2d31 2720 286f 7220 756e 7365 7429 206d -1' (or unset) m │ │ │ │ │ -000259a0: 6561 6e73 2074 6f20 7761 6974 2069 6e64 eans to wait ind │ │ │ │ │ -000259b0: 6566 696e 6974 656c 792e 0a0a 2020 2049 efinitely... I │ │ │ │ │ -000259c0: 6620 2774 696d 656f 7574 5f73 7479 6c65 f 'timeout_style │ │ │ │ │ -000259d0: 2720 282a 6e6f 7465 2074 696d 656f 7574 ' (*note timeout │ │ │ │ │ -000259e0: 5f73 7479 6c65 3a3a 2920 6973 2073 6574 _style::) is set │ │ │ │ │ -000259f0: 2074 6f20 2763 6f75 6e74 646f 776e 2720 to 'countdown' │ │ │ │ │ -00025a00: 6f72 0a27 6869 6464 656e 272c 2074 6865 or.'hidden', the │ │ │ │ │ -00025a10: 2074 696d 656f 7574 2069 7320 696e 7374 timeout is inst │ │ │ │ │ -00025a20: 6561 6420 636f 756e 7465 6420 6265 666f ead counted befo │ │ │ │ │ -00025a30: 7265 2074 6865 206d 656e 7520 6973 2064 re the menu is d │ │ │ │ │ -00025a40: 6973 706c 6179 6564 2e0a 0a20 2020 5468 isplayed... Th │ │ │ │ │ -00025a50: 6973 2076 6172 6961 626c 6520 6973 206f is variable is o │ │ │ │ │ -00025a60: 6674 656e 2073 6574 2062 7920 2747 5255 ften set by 'GRU │ │ │ │ │ -00025a70: 425f 5449 4d45 4f55 5427 2028 2a6e 6f74 B_TIMEOUT' (*not │ │ │ │ │ -00025a80: 6520 5369 6d70 6c65 0a63 6f6e 6669 6775 e Simple.configu │ │ │ │ │ -00025a90: 7261 7469 6f6e 3a3a 292e 0a0a 1f0a 4669 ration::).....Fi │ │ │ │ │ -00025aa0: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ -00025ab0: 4e6f 6465 3a20 7469 6d65 6f75 745f 7374 Node: timeout_st │ │ │ │ │ -00025ac0: 796c 652c 2020 5072 6576 3a20 7469 6d65 yle, Prev: time │ │ │ │ │ -00025ad0: 6f75 742c 2020 5570 3a20 5370 6563 6961 out, Up: Specia │ │ │ │ │ -00025ae0: 6c20 656e 7669 726f 6e6d 656e 7420 7661 l environment va │ │ │ │ │ -00025af0: 7269 6162 6c65 730a 0a31 352e 312e 3434 riables..15.1.44 │ │ │ │ │ -00025b00: 2074 696d 656f 7574 5f73 7479 6c65 0a2d timeout_style.- │ │ │ │ │ +000253b0: 2d2d 2d0a 0a2a 4e6f 7465 204e 6574 776f ---..*Note Netwo │ │ │ │ │ +000253c0: 726b 3a3a 2e0a 0a1f 0a46 696c 653a 2067 rk::.....File: g │ │ │ │ │ +000253d0: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ +000253e0: 2072 6f6f 742c 2020 4e65 7874 3a20 7375 root, Next: su │ │ │ │ │ +000253f0: 7065 7275 7365 7273 2c20 2050 7265 763a perusers, Prev: │ │ │ │ │ +00025400: 2070 7865 5f64 6566 6175 6c74 5f73 6572 pxe_default_ser │ │ │ │ │ +00025410: 7665 722c 2020 5570 3a20 5370 6563 6961 ver, Up: Specia │ │ │ │ │ +00025420: 6c20 656e 7669 726f 6e6d 656e 7420 7661 l environment va │ │ │ │ │ +00025430: 7269 6162 6c65 730a 0a31 352e 312e 3430 riables..15.1.40 │ │ │ │ │ +00025440: 2072 6f6f 740a 2d2d 2d2d 2d2d 2d2d 2d2d root.---------- │ │ │ │ │ +00025450: 2d2d 0a0a 5468 6520 726f 6f74 2064 6576 --..The root dev │ │ │ │ │ +00025460: 6963 6520 6e61 6d65 2028 2a6e 6f74 6520 ice name (*note │ │ │ │ │ +00025470: 4465 7669 6365 2073 796e 7461 783a 3a29 Device syntax::) │ │ │ │ │ +00025480: 2e20 2041 6e79 2066 696c 6520 6e61 6d65 . Any file name │ │ │ │ │ +00025490: 7320 7468 6174 2064 6f0a 6e6f 7420 7370 s that do.not sp │ │ │ │ │ +000254a0: 6563 6966 7920 616e 2065 7870 6c69 6369 ecify an explici │ │ │ │ │ +000254b0: 7420 6465 7669 6365 206e 616d 6520 6172 t device name ar │ │ │ │ │ +000254c0: 6520 7265 6164 2066 726f 6d20 7468 6973 e read from this │ │ │ │ │ +000254d0: 2064 6576 6963 652e 2020 5468 650a 6465 device. The.de │ │ │ │ │ +000254e0: 6661 756c 7420 6973 206e 6f72 6d61 6c6c fault is normall │ │ │ │ │ +000254f0: 7920 7365 7420 6279 2047 5255 4220 6174 y set by GRUB at │ │ │ │ │ +00025500: 2073 7461 7274 7570 2062 6173 6564 206f startup based o │ │ │ │ │ +00025510: 6e20 7468 6520 7661 6c75 6520 6f66 0a27 n the value of.' │ │ │ │ │ +00025520: 7072 6566 6978 2720 282a 6e6f 7465 2070 prefix' (*note p │ │ │ │ │ +00025530: 7265 6669 783a 3a29 2e0a 0a20 2020 466f refix::)... Fo │ │ │ │ │ +00025540: 7220 6578 616d 706c 652c 2069 6620 4752 r example, if GR │ │ │ │ │ +00025550: 5542 2077 6173 2069 6e73 7461 6c6c 6564 UB was installed │ │ │ │ │ +00025560: 2074 6f20 7468 6520 6669 7273 7420 7061 to the first pa │ │ │ │ │ +00025570: 7274 6974 696f 6e20 6f66 2074 6865 0a66 rtition of the.f │ │ │ │ │ +00025580: 6972 7374 2068 6172 6420 6469 736b 2c20 irst hard disk, │ │ │ │ │ +00025590: 7468 656e 2027 7072 6566 6978 2720 6d69 then 'prefix' mi │ │ │ │ │ +000255a0: 6768 7420 6265 2073 6574 2074 6f20 2728 ght be set to '( │ │ │ │ │ +000255b0: 6864 302c 6d73 646f 7331 292f 626f 6f74 hd0,msdos1)/boot │ │ │ │ │ +000255c0: 2f67 7275 6227 0a61 6e64 2027 726f 6f74 /grub'.and 'root │ │ │ │ │ +000255d0: 2720 746f 2027 6864 302c 6d73 646f 7331 ' to 'hd0,msdos1 │ │ │ │ │ +000255e0: 272e 0a0a 1f0a 4669 6c65 3a20 6772 7562 '.....File: grub │ │ │ │ │ +000255f0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 7375 .info, Node: su │ │ │ │ │ +00025600: 7065 7275 7365 7273 2c20 204e 6578 743a perusers, Next: │ │ │ │ │ +00025610: 2074 6865 6d65 2c20 2050 7265 763a 2072 theme, Prev: r │ │ │ │ │ +00025620: 6f6f 742c 2020 5570 3a20 5370 6563 6961 oot, Up: Specia │ │ │ │ │ +00025630: 6c20 656e 7669 726f 6e6d 656e 7420 7661 l environment va │ │ │ │ │ +00025640: 7269 6162 6c65 730a 0a31 352e 312e 3431 riables..15.1.41 │ │ │ │ │ +00025650: 2073 7570 6572 7573 6572 730a 2d2d 2d2d superusers.---- │ │ │ │ │ +00025660: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ +00025670: 5468 6973 2076 6172 6961 626c 6520 6d61 This variable ma │ │ │ │ │ +00025680: 7920 6265 2073 6574 2074 6f20 6120 6c69 y be set to a li │ │ │ │ │ +00025690: 7374 206f 6620 7375 7065 7275 7365 7220 st of superuser │ │ │ │ │ +000256a0: 6e61 6d65 7320 746f 2065 6e61 626c 650a names to enable. │ │ │ │ │ +000256b0: 6175 7468 656e 7469 6361 7469 6f6e 2073 authentication s │ │ │ │ │ +000256c0: 7570 706f 7274 2e20 202a 4e6f 7465 2053 upport. *Note S │ │ │ │ │ +000256d0: 6563 7572 6974 793a 3a2e 0a0a 1f0a 4669 ecurity::.....Fi │ │ │ │ │ +000256e0: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ +000256f0: 4e6f 6465 3a20 7468 656d 652c 2020 4e65 Node: theme, Ne │ │ │ │ │ +00025700: 7874 3a20 7469 6d65 6f75 742c 2020 5072 xt: timeout, Pr │ │ │ │ │ +00025710: 6576 3a20 7375 7065 7275 7365 7273 2c20 ev: superusers, │ │ │ │ │ +00025720: 2055 703a 2053 7065 6369 616c 2065 6e76 Up: Special env │ │ │ │ │ +00025730: 6972 6f6e 6d65 6e74 2076 6172 6961 626c ironment variabl │ │ │ │ │ +00025740: 6573 0a0a 3135 2e31 2e34 3220 7468 656d es..15.1.42 them │ │ │ │ │ +00025750: 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a e.-------------. │ │ │ │ │ +00025760: 0a54 6869 7320 7661 7269 6162 6c65 206d .This variable m │ │ │ │ │ +00025770: 6179 2062 6520 7365 7420 746f 2061 2064 ay be set to a d │ │ │ │ │ +00025780: 6972 6563 746f 7279 2063 6f6e 7461 696e irectory contain │ │ │ │ │ +00025790: 696e 6720 6120 4752 5542 2067 7261 7068 ing a GRUB graph │ │ │ │ │ +000257a0: 6963 616c 206d 656e 750a 7468 656d 652e ical menu.theme. │ │ │ │ │ +000257b0: 2020 2a4e 6f74 6520 5468 656d 6520 6669 *Note Theme fi │ │ │ │ │ +000257c0: 6c65 2066 6f72 6d61 743a 3a2e 0a0a 2020 le format::... │ │ │ │ │ +000257d0: 2054 6869 7320 7661 7269 6162 6c65 2069 This variable i │ │ │ │ │ +000257e0: 7320 6f66 7465 6e20 7365 7420 6279 2027 s often set by ' │ │ │ │ │ +000257f0: 4752 5542 5f54 4845 4d45 2720 282a 6e6f GRUB_THEME' (*no │ │ │ │ │ +00025800: 7465 2053 696d 706c 650a 636f 6e66 6967 te Simple.config │ │ │ │ │ +00025810: 7572 6174 696f 6e3a 3a29 2e0a 0a1f 0a46 uration::).....F │ │ │ │ │ +00025820: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ +00025830: 204e 6f64 653a 2074 696d 656f 7574 2c20 Node: timeout, │ │ │ │ │ +00025840: 204e 6578 743a 2074 696d 656f 7574 5f73 Next: timeout_s │ │ │ │ │ +00025850: 7479 6c65 2c20 2050 7265 763a 2074 6865 tyle, Prev: the │ │ │ │ │ +00025860: 6d65 2c20 2055 703a 2053 7065 6369 616c me, Up: Special │ │ │ │ │ +00025870: 2065 6e76 6972 6f6e 6d65 6e74 2076 6172 environment var │ │ │ │ │ +00025880: 6961 626c 6573 0a0a 3135 2e31 2e34 3320 iables..15.1.43 │ │ │ │ │ +00025890: 7469 6d65 6f75 740a 2d2d 2d2d 2d2d 2d2d timeout.-------- │ │ │ │ │ +000258a0: 2d2d 2d2d 2d2d 2d0a 0a49 6620 7468 6973 -------..If this │ │ │ │ │ +000258b0: 2076 6172 6961 626c 6520 6973 2073 6574 variable is set │ │ │ │ │ +000258c0: 2c20 6974 2073 7065 6369 6669 6573 2074 , it specifies t │ │ │ │ │ +000258d0: 6865 2074 696d 6520 696e 2073 6563 6f6e he time in secon │ │ │ │ │ +000258e0: 6473 2074 6f20 7761 6974 2066 6f72 0a6b ds to wait for.k │ │ │ │ │ +000258f0: 6579 626f 6172 6420 696e 7075 7420 6265 eyboard input be │ │ │ │ │ +00025900: 666f 7265 2062 6f6f 7469 6e67 2074 6865 fore booting the │ │ │ │ │ +00025910: 2064 6566 6175 6c74 206d 656e 7520 656e default menu en │ │ │ │ │ +00025920: 7472 792e 2020 4120 7469 6d65 6f75 7420 try. A timeout │ │ │ │ │ +00025930: 6f66 2027 3027 0a6d 6561 6e73 2074 6f20 of '0'.means to │ │ │ │ │ +00025940: 626f 6f74 2074 6865 2064 6566 6175 6c74 boot the default │ │ │ │ │ +00025950: 2065 6e74 7279 2069 6d6d 6564 6961 7465 entry immediate │ │ │ │ │ +00025960: 6c79 2077 6974 686f 7574 2064 6973 706c ly without displ │ │ │ │ │ +00025970: 6179 696e 6720 7468 6520 6d65 6e75 3b0a aying the menu;. │ │ │ │ │ +00025980: 6120 7469 6d65 6f75 7420 6f66 2027 2d31 a timeout of '-1 │ │ │ │ │ +00025990: 2720 286f 7220 756e 7365 7429 206d 6561 ' (or unset) mea │ │ │ │ │ +000259a0: 6e73 2074 6f20 7761 6974 2069 6e64 6566 ns to wait indef │ │ │ │ │ +000259b0: 696e 6974 656c 792e 0a0a 2020 2049 6620 initely... If │ │ │ │ │ +000259c0: 2774 696d 656f 7574 5f73 7479 6c65 2720 'timeout_style' │ │ │ │ │ +000259d0: 282a 6e6f 7465 2074 696d 656f 7574 5f73 (*note timeout_s │ │ │ │ │ +000259e0: 7479 6c65 3a3a 2920 6973 2073 6574 2074 tyle::) is set t │ │ │ │ │ +000259f0: 6f20 2763 6f75 6e74 646f 776e 2720 6f72 o 'countdown' or │ │ │ │ │ +00025a00: 0a27 6869 6464 656e 272c 2074 6865 2074 .'hidden', the t │ │ │ │ │ +00025a10: 696d 656f 7574 2069 7320 696e 7374 6561 imeout is instea │ │ │ │ │ +00025a20: 6420 636f 756e 7465 6420 6265 666f 7265 d counted before │ │ │ │ │ +00025a30: 2074 6865 206d 656e 7520 6973 2064 6973 the menu is dis │ │ │ │ │ +00025a40: 706c 6179 6564 2e0a 0a20 2020 5468 6973 played... This │ │ │ │ │ +00025a50: 2076 6172 6961 626c 6520 6973 206f 6674 variable is oft │ │ │ │ │ +00025a60: 656e 2073 6574 2062 7920 2747 5255 425f en set by 'GRUB_ │ │ │ │ │ +00025a70: 5449 4d45 4f55 5427 2028 2a6e 6f74 6520 TIMEOUT' (*note │ │ │ │ │ +00025a80: 5369 6d70 6c65 0a63 6f6e 6669 6775 7261 Simple.configura │ │ │ │ │ +00025a90: 7469 6f6e 3a3a 292e 0a0a 1f0a 4669 6c65 tion::).....File │ │ │ │ │ +00025aa0: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ +00025ab0: 6465 3a20 7469 6d65 6f75 745f 7374 796c de: timeout_styl │ │ │ │ │ +00025ac0: 652c 2020 5072 6576 3a20 7469 6d65 6f75 e, Prev: timeou │ │ │ │ │ +00025ad0: 742c 2020 5570 3a20 5370 6563 6961 6c20 t, Up: Special │ │ │ │ │ +00025ae0: 656e 7669 726f 6e6d 656e 7420 7661 7269 environment vari │ │ │ │ │ +00025af0: 6162 6c65 730a 0a31 352e 312e 3434 2074 ables..15.1.44 t │ │ │ │ │ +00025b00: 696d 656f 7574 5f73 7479 6c65 0a2d 2d2d imeout_style.--- │ │ │ │ │ 00025b10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00025b20: 2d2d 2d2d 0a0a 5468 6973 2076 6172 6961 ----..This varia │ │ │ │ │ -00025b30: 626c 6520 6d61 7920 6265 2073 6574 2074 ble may be set t │ │ │ │ │ -00025b40: 6f20 276d 656e 7527 2c20 2763 6f75 6e74 o 'menu', 'count │ │ │ │ │ -00025b50: 646f 776e 272c 206f 7220 2768 6964 6465 down', or 'hidde │ │ │ │ │ -00025b60: 6e27 2074 6f20 636f 6e74 726f 6c0a 7468 n' to control.th │ │ │ │ │ -00025b70: 6520 7761 7920 696e 2077 6869 6368 2074 e way in which t │ │ │ │ │ -00025b80: 6865 2074 696d 656f 7574 2028 2a6e 6f74 he timeout (*not │ │ │ │ │ -00025b90: 6520 7469 6d65 6f75 743a 3a29 2069 6e74 e timeout::) int │ │ │ │ │ -00025ba0: 6572 6163 7473 2077 6974 6820 6469 7370 eracts with disp │ │ │ │ │ -00025bb0: 6c61 7969 6e67 0a74 6865 206d 656e 752e laying.the menu. │ │ │ │ │ -00025bc0: 2020 5365 6520 7468 6520 646f 6375 6d65 See the docume │ │ │ │ │ -00025bd0: 6e74 6174 696f 6e20 6f66 2027 4752 5542 ntation of 'GRUB │ │ │ │ │ -00025be0: 5f54 494d 454f 5554 5f53 5459 4c45 2720 _TIMEOUT_STYLE' │ │ │ │ │ -00025bf0: 282a 6e6f 7465 2053 696d 706c 650a 636f (*note Simple.co │ │ │ │ │ -00025c00: 6e66 6967 7572 6174 696f 6e3a 3a29 2066 nfiguration::) f │ │ │ │ │ -00025c10: 6f72 2064 6574 6169 6c73 2e0a 0a1f 0a46 or details.....F │ │ │ │ │ -00025c20: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ -00025c30: 204e 6f64 653a 2045 6e76 6972 6f6e 6d65 Node: Environme │ │ │ │ │ -00025c40: 6e74 2062 6c6f 636b 2c20 2050 7265 763a nt block, Prev: │ │ │ │ │ -00025c50: 2053 7065 6369 616c 2065 6e76 6972 6f6e Special environ │ │ │ │ │ -00025c60: 6d65 6e74 2076 6172 6961 626c 6573 2c20 ment variables, │ │ │ │ │ -00025c70: 2055 703a 2045 6e76 6972 6f6e 6d65 6e74 Up: Environment │ │ │ │ │ -00025c80: 0a0a 3135 2e32 2054 6865 2047 5255 4220 ..15.2 The GRUB │ │ │ │ │ -00025c90: 656e 7669 726f 6e6d 656e 7420 626c 6f63 environment bloc │ │ │ │ │ -00025ca0: 6b0a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d k.============== │ │ │ │ │ -00025cb0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00025cc0: 3d0a 0a49 7420 6973 206f 6674 656e 2075 =..It is often u │ │ │ │ │ -00025cd0: 7365 6675 6c20 746f 2062 6520 6162 6c65 seful to be able │ │ │ │ │ -00025ce0: 2074 6f20 7265 6d65 6d62 6572 2061 2073 to remember a s │ │ │ │ │ -00025cf0: 6d61 6c6c 2061 6d6f 756e 7420 6f66 2069 mall amount of i │ │ │ │ │ -00025d00: 6e66 6f72 6d61 7469 6f6e 0a66 726f 6d20 nformation.from │ │ │ │ │ -00025d10: 6f6e 6520 626f 6f74 2074 6f20 7468 6520 one boot to the │ │ │ │ │ -00025d20: 6e65 7874 2e20 2046 6f72 2065 7861 6d70 next. For examp │ │ │ │ │ -00025d30: 6c65 2c20 796f 7520 6d69 6768 7420 7761 le, you might wa │ │ │ │ │ -00025d40: 6e74 2074 6f20 7365 7420 7468 650a 6465 nt to set the.de │ │ │ │ │ -00025d50: 6661 756c 7420 6d65 6e75 2065 6e74 7279 fault menu entry │ │ │ │ │ -00025d60: 2062 6173 6564 206f 6e20 7768 6174 2077 based on what w │ │ │ │ │ -00025d70: 6173 2073 656c 6563 7465 6420 7468 6520 as selected the │ │ │ │ │ -00025d80: 6c61 7374 2074 696d 652e 2020 4752 5542 last time. GRUB │ │ │ │ │ -00025d90: 0a64 656c 6962 6572 6174 656c 7920 646f .deliberately do │ │ │ │ │ -00025da0: 6573 206e 6f74 2069 6d70 6c65 6d65 6e74 es not implement │ │ │ │ │ -00025db0: 2073 7570 706f 7274 2066 6f72 2077 7269 support for wri │ │ │ │ │ -00025dc0: 7469 6e67 2066 696c 6573 2069 6e20 6f72 ting files in or │ │ │ │ │ -00025dd0: 6465 7220 746f 0a6d 696e 696d 6973 6520 der to.minimise │ │ │ │ │ -00025de0: 7468 6520 706f 7373 6962 696c 6974 7920 the possibility │ │ │ │ │ -00025df0: 6f66 2074 6865 2062 6f6f 7420 6c6f 6164 of the boot load │ │ │ │ │ -00025e00: 6572 2062 6569 6e67 2072 6573 706f 6e73 er being respons │ │ │ │ │ -00025e10: 6962 6c65 2066 6f72 2066 696c 650a 7379 ible for file.sy │ │ │ │ │ -00025e20: 7374 656d 2063 6f72 7275 7074 696f 6e2c stem corruption, │ │ │ │ │ -00025e30: 2073 6f20 6120 4752 5542 2063 6f6e 6669 so a GRUB confi │ │ │ │ │ -00025e40: 6775 7261 7469 6f6e 2066 696c 6520 6361 guration file ca │ │ │ │ │ -00025e50: 6e6e 6f74 206a 7573 7420 6372 6561 7465 nnot just create │ │ │ │ │ -00025e60: 2061 0a66 696c 6520 696e 2074 6865 206f a.file in the o │ │ │ │ │ -00025e70: 7264 696e 6172 7920 7761 792e 2020 486f rdinary way. Ho │ │ │ │ │ -00025e80: 7765 7665 722c 2047 5255 4220 7072 6f76 wever, GRUB prov │ │ │ │ │ -00025e90: 6964 6573 2061 6e20 2265 6e76 6972 6f6e ides an "environ │ │ │ │ │ -00025ea0: 6d65 6e74 2062 6c6f 636b 220a 7768 6963 ment block".whic │ │ │ │ │ -00025eb0: 6820 6361 6e20 6265 2075 7365 6420 746f h can be used to │ │ │ │ │ -00025ec0: 2073 6176 6520 6120 736d 616c 6c20 616d save a small am │ │ │ │ │ -00025ed0: 6f75 6e74 206f 6620 7374 6174 652e 0a0a ount of state... │ │ │ │ │ -00025ee0: 2020 2054 6865 2065 6e76 6972 6f6e 6d65 The environme │ │ │ │ │ -00025ef0: 6e74 2062 6c6f 636b 2069 7320 6120 7072 nt block is a pr │ │ │ │ │ -00025f00: 6561 6c6c 6f63 6174 6564 2031 3032 342d eallocated 1024- │ │ │ │ │ -00025f10: 6279 7465 2066 696c 652c 2077 6869 6368 byte file, which │ │ │ │ │ -00025f20: 0a6e 6f72 6d61 6c6c 7920 6c69 7665 7320 .normally lives │ │ │ │ │ -00025f30: 696e 2027 2f62 6f6f 742f 6772 7562 2f67 in '/boot/grub/g │ │ │ │ │ -00025f40: 7275 6265 6e76 2720 2861 6c74 686f 7567 rubenv' (althoug │ │ │ │ │ -00025f50: 6820 796f 7520 7368 6f75 6c64 206e 6f74 h you should not │ │ │ │ │ -00025f60: 2061 7373 756d 650a 7468 6973 292e 2020 assume.this). │ │ │ │ │ -00025f70: 4174 2062 6f6f 7420 7469 6d65 2c20 7468 At boot time, th │ │ │ │ │ -00025f80: 6520 276c 6f61 645f 656e 7627 2063 6f6d e 'load_env' com │ │ │ │ │ -00025f90: 6d61 6e64 2028 2a6e 6f74 6520 6c6f 6164 mand (*note load │ │ │ │ │ -00025fa0: 5f65 6e76 3a3a 2920 6c6f 6164 730a 656e _env::) loads.en │ │ │ │ │ -00025fb0: 7669 726f 6e6d 656e 7420 7661 7269 6162 vironment variab │ │ │ │ │ -00025fc0: 6c65 7320 6672 6f6d 2069 742c 2061 6e64 les from it, and │ │ │ │ │ -00025fd0: 2074 6865 2027 7361 7665 5f65 6e76 2720 the 'save_env' │ │ │ │ │ -00025fe0: 282a 6e6f 7465 2073 6176 655f 656e 763a (*note save_env: │ │ │ │ │ -00025ff0: 3a29 0a63 6f6d 6d61 6e64 2073 6176 6573 :).command saves │ │ │ │ │ -00026000: 2065 6e76 6972 6f6e 6d65 6e74 2076 6172 environment var │ │ │ │ │ -00026010: 6961 626c 6573 2074 6f20 6974 2e20 2046 iables to it. F │ │ │ │ │ -00026020: 726f 6d20 6120 7275 6e6e 696e 6720 7379 rom a running sy │ │ │ │ │ -00026030: 7374 656d 2c20 7468 650a 2767 7275 622d stem, the.'grub- │ │ │ │ │ -00026040: 6564 6974 656e 7627 2075 7469 6c69 7479 editenv' utility │ │ │ │ │ -00026050: 2063 616e 2062 6520 7573 6564 2074 6f20 can be used to │ │ │ │ │ -00026060: 6564 6974 2074 6865 2065 6e76 6972 6f6e edit the environ │ │ │ │ │ -00026070: 6d65 6e74 2062 6c6f 636b 2e0a 0a20 2020 ment block... │ │ │ │ │ -00026080: 466f 7220 7361 6665 7479 2072 6561 736f For safety reaso │ │ │ │ │ -00026090: 6e73 2c20 7468 6973 2073 746f 7261 6765 ns, this storage │ │ │ │ │ -000260a0: 2069 7320 6f6e 6c79 2061 7661 696c 6162 is only availab │ │ │ │ │ -000260b0: 6c65 2077 6865 6e20 696e 7374 616c 6c65 le when installe │ │ │ │ │ -000260c0: 6420 6f6e 0a61 2070 6c61 696e 2064 6973 d on.a plain dis │ │ │ │ │ -000260d0: 6b20 286e 6f20 4c56 4d20 6f72 2052 4149 k (no LVM or RAI │ │ │ │ │ -000260e0: 4429 2c20 7573 696e 6720 6120 6e6f 6e2d D), using a non- │ │ │ │ │ -000260f0: 6368 6563 6b73 756d 6d69 6e67 2066 696c checksumming fil │ │ │ │ │ -00026100: 6573 7973 7465 6d20 286e 6f0a 5a46 5329 esystem (no.ZFS) │ │ │ │ │ -00026110: 2c20 616e 6420 7573 696e 6720 4249 4f53 , and using BIOS │ │ │ │ │ -00026120: 206f 7220 4546 4920 6675 6e63 7469 6f6e or EFI function │ │ │ │ │ -00026130: 7320 286e 6f20 4154 412c 2055 5342 206f s (no ATA, USB o │ │ │ │ │ -00026140: 7220 4945 4545 3132 3735 292e 0a0a 2020 r IEEE1275)... │ │ │ │ │ -00026150: 2027 6772 7562 2d6d 6b63 6f6e 6669 6727 'grub-mkconfig' │ │ │ │ │ -00026160: 2075 7365 7320 7468 6973 2066 6163 696c uses this facil │ │ │ │ │ -00026170: 6974 7920 746f 2069 6d70 6c65 6d65 6e74 ity to implement │ │ │ │ │ -00026180: 2027 4752 5542 5f53 4156 4544 4546 4155 'GRUB_SAVEDEFAU │ │ │ │ │ -00026190: 4c54 270a 282a 6e6f 7465 2053 696d 706c LT'.(*note Simpl │ │ │ │ │ -000261a0: 6520 636f 6e66 6967 7572 6174 696f 6e3a e configuration: │ │ │ │ │ -000261b0: 3a29 2e0a 0a1f 0a46 696c 653a 2067 7275 :).....File: gru │ │ │ │ │ -000261c0: 622e 696e 666f 2c20 204e 6f64 653a 2043 b.info, Node: C │ │ │ │ │ -000261d0: 6f6d 6d61 6e64 732c 2020 4e65 7874 3a20 ommands, Next: │ │ │ │ │ -000261e0: 496e 7465 726e 6174 696f 6e61 6c69 7361 Internationalisa │ │ │ │ │ -000261f0: 7469 6f6e 2c20 2050 7265 763a 2045 6e76 tion, Prev: Env │ │ │ │ │ -00026200: 6972 6f6e 6d65 6e74 2c20 2055 703a 2054 ironment, Up: T │ │ │ │ │ -00026210: 6f70 0a0a 3136 2054 6865 206c 6973 7420 op..16 The list │ │ │ │ │ -00026220: 6f66 2061 7661 696c 6162 6c65 2063 6f6d of available com │ │ │ │ │ -00026230: 6d61 6e64 730a 2a2a 2a2a 2a2a 2a2a 2a2a mands.********** │ │ │ │ │ +00025b20: 2d2d 0a0a 5468 6973 2076 6172 6961 626c --..This variabl │ │ │ │ │ +00025b30: 6520 6d61 7920 6265 2073 6574 2074 6f20 e may be set to │ │ │ │ │ +00025b40: 276d 656e 7527 2c20 2763 6f75 6e74 646f 'menu', 'countdo │ │ │ │ │ +00025b50: 776e 272c 206f 7220 2768 6964 6465 6e27 wn', or 'hidden' │ │ │ │ │ +00025b60: 2074 6f20 636f 6e74 726f 6c0a 7468 6520 to control.the │ │ │ │ │ +00025b70: 7761 7920 696e 2077 6869 6368 2074 6865 way in which the │ │ │ │ │ +00025b80: 2074 696d 656f 7574 2028 2a6e 6f74 6520 timeout (*note │ │ │ │ │ +00025b90: 7469 6d65 6f75 743a 3a29 2069 6e74 6572 timeout::) inter │ │ │ │ │ +00025ba0: 6163 7473 2077 6974 6820 6469 7370 6c61 acts with displa │ │ │ │ │ +00025bb0: 7969 6e67 0a74 6865 206d 656e 752e 2020 ying.the menu. │ │ │ │ │ +00025bc0: 5365 6520 7468 6520 646f 6375 6d65 6e74 See the document │ │ │ │ │ +00025bd0: 6174 696f 6e20 6f66 2027 4752 5542 5f54 ation of 'GRUB_T │ │ │ │ │ +00025be0: 494d 454f 5554 5f53 5459 4c45 2720 282a IMEOUT_STYLE' (* │ │ │ │ │ +00025bf0: 6e6f 7465 2053 696d 706c 650a 636f 6e66 note Simple.conf │ │ │ │ │ +00025c00: 6967 7572 6174 696f 6e3a 3a29 2066 6f72 iguration::) for │ │ │ │ │ +00025c10: 2064 6574 6169 6c73 2e0a 0a1f 0a46 696c details.....Fil │ │ │ │ │ +00025c20: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ +00025c30: 6f64 653a 2045 6e76 6972 6f6e 6d65 6e74 ode: Environment │ │ │ │ │ +00025c40: 2062 6c6f 636b 2c20 2050 7265 763a 2053 block, Prev: S │ │ │ │ │ +00025c50: 7065 6369 616c 2065 6e76 6972 6f6e 6d65 pecial environme │ │ │ │ │ +00025c60: 6e74 2076 6172 6961 626c 6573 2c20 2055 nt variables, U │ │ │ │ │ +00025c70: 703a 2045 6e76 6972 6f6e 6d65 6e74 0a0a p: Environment.. │ │ │ │ │ +00025c80: 3135 2e32 2054 6865 2047 5255 4220 656e 15.2 The GRUB en │ │ │ │ │ +00025c90: 7669 726f 6e6d 656e 7420 626c 6f63 6b0a vironment block. │ │ │ │ │ +00025ca0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ +00025cb0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a ===============. │ │ │ │ │ +00025cc0: 0a49 7420 6973 206f 6674 656e 2075 7365 .It is often use │ │ │ │ │ +00025cd0: 6675 6c20 746f 2062 6520 6162 6c65 2074 ful to be able t │ │ │ │ │ +00025ce0: 6f20 7265 6d65 6d62 6572 2061 2073 6d61 o remember a sma │ │ │ │ │ +00025cf0: 6c6c 2061 6d6f 756e 7420 6f66 2069 6e66 ll amount of inf │ │ │ │ │ +00025d00: 6f72 6d61 7469 6f6e 0a66 726f 6d20 6f6e ormation.from on │ │ │ │ │ +00025d10: 6520 626f 6f74 2074 6f20 7468 6520 6e65 e boot to the ne │ │ │ │ │ +00025d20: 7874 2e20 2046 6f72 2065 7861 6d70 6c65 xt. For example │ │ │ │ │ +00025d30: 2c20 796f 7520 6d69 6768 7420 7761 6e74 , you might want │ │ │ │ │ +00025d40: 2074 6f20 7365 7420 7468 650a 6465 6661 to set the.defa │ │ │ │ │ +00025d50: 756c 7420 6d65 6e75 2065 6e74 7279 2062 ult menu entry b │ │ │ │ │ +00025d60: 6173 6564 206f 6e20 7768 6174 2077 6173 ased on what was │ │ │ │ │ +00025d70: 2073 656c 6563 7465 6420 7468 6520 6c61 selected the la │ │ │ │ │ +00025d80: 7374 2074 696d 652e 2020 4752 5542 0a64 st time. GRUB.d │ │ │ │ │ +00025d90: 656c 6962 6572 6174 656c 7920 646f 6573 eliberately does │ │ │ │ │ +00025da0: 206e 6f74 2069 6d70 6c65 6d65 6e74 2073 not implement s │ │ │ │ │ +00025db0: 7570 706f 7274 2066 6f72 2077 7269 7469 upport for writi │ │ │ │ │ +00025dc0: 6e67 2066 696c 6573 2069 6e20 6f72 6465 ng files in orde │ │ │ │ │ +00025dd0: 7220 746f 0a6d 696e 696d 6973 6520 7468 r to.minimise th │ │ │ │ │ +00025de0: 6520 706f 7373 6962 696c 6974 7920 6f66 e possibility of │ │ │ │ │ +00025df0: 2074 6865 2062 6f6f 7420 6c6f 6164 6572 the boot loader │ │ │ │ │ +00025e00: 2062 6569 6e67 2072 6573 706f 6e73 6962 being responsib │ │ │ │ │ +00025e10: 6c65 2066 6f72 2066 696c 650a 7379 7374 le for file.syst │ │ │ │ │ +00025e20: 656d 2063 6f72 7275 7074 696f 6e2c 2073 em corruption, s │ │ │ │ │ +00025e30: 6f20 6120 4752 5542 2063 6f6e 6669 6775 o a GRUB configu │ │ │ │ │ +00025e40: 7261 7469 6f6e 2066 696c 6520 6361 6e6e ration file cann │ │ │ │ │ +00025e50: 6f74 206a 7573 7420 6372 6561 7465 2061 ot just create a │ │ │ │ │ +00025e60: 0a66 696c 6520 696e 2074 6865 206f 7264 .file in the ord │ │ │ │ │ +00025e70: 696e 6172 7920 7761 792e 2020 486f 7765 inary way. Howe │ │ │ │ │ +00025e80: 7665 722c 2047 5255 4220 7072 6f76 6964 ver, GRUB provid │ │ │ │ │ +00025e90: 6573 2061 6e20 2265 6e76 6972 6f6e 6d65 es an "environme │ │ │ │ │ +00025ea0: 6e74 2062 6c6f 636b 220a 7768 6963 6820 nt block".which │ │ │ │ │ +00025eb0: 6361 6e20 6265 2075 7365 6420 746f 2073 can be used to s │ │ │ │ │ +00025ec0: 6176 6520 6120 736d 616c 6c20 616d 6f75 ave a small amou │ │ │ │ │ +00025ed0: 6e74 206f 6620 7374 6174 652e 0a0a 2020 nt of state... │ │ │ │ │ +00025ee0: 2054 6865 2065 6e76 6972 6f6e 6d65 6e74 The environment │ │ │ │ │ +00025ef0: 2062 6c6f 636b 2069 7320 6120 7072 6561 block is a prea │ │ │ │ │ +00025f00: 6c6c 6f63 6174 6564 2031 3032 342d 6279 llocated 1024-by │ │ │ │ │ +00025f10: 7465 2066 696c 652c 2077 6869 6368 0a6e te file, which.n │ │ │ │ │ +00025f20: 6f72 6d61 6c6c 7920 6c69 7665 7320 696e ormally lives in │ │ │ │ │ +00025f30: 2027 2f62 6f6f 742f 6772 7562 2f67 7275 '/boot/grub/gru │ │ │ │ │ +00025f40: 6265 6e76 2720 2861 6c74 686f 7567 6820 benv' (although │ │ │ │ │ +00025f50: 796f 7520 7368 6f75 6c64 206e 6f74 2061 you should not a │ │ │ │ │ +00025f60: 7373 756d 650a 7468 6973 292e 2020 4174 ssume.this). At │ │ │ │ │ +00025f70: 2062 6f6f 7420 7469 6d65 2c20 7468 6520 boot time, the │ │ │ │ │ +00025f80: 276c 6f61 645f 656e 7627 2063 6f6d 6d61 'load_env' comma │ │ │ │ │ +00025f90: 6e64 2028 2a6e 6f74 6520 6c6f 6164 5f65 nd (*note load_e │ │ │ │ │ +00025fa0: 6e76 3a3a 2920 6c6f 6164 730a 656e 7669 nv::) loads.envi │ │ │ │ │ +00025fb0: 726f 6e6d 656e 7420 7661 7269 6162 6c65 ronment variable │ │ │ │ │ +00025fc0: 7320 6672 6f6d 2069 742c 2061 6e64 2074 s from it, and t │ │ │ │ │ +00025fd0: 6865 2027 7361 7665 5f65 6e76 2720 282a he 'save_env' (* │ │ │ │ │ +00025fe0: 6e6f 7465 2073 6176 655f 656e 763a 3a29 note save_env::) │ │ │ │ │ +00025ff0: 0a63 6f6d 6d61 6e64 2073 6176 6573 2065 .command saves e │ │ │ │ │ +00026000: 6e76 6972 6f6e 6d65 6e74 2076 6172 6961 nvironment varia │ │ │ │ │ +00026010: 626c 6573 2074 6f20 6974 2e20 2046 726f bles to it. Fro │ │ │ │ │ +00026020: 6d20 6120 7275 6e6e 696e 6720 7379 7374 m a running syst │ │ │ │ │ +00026030: 656d 2c20 7468 650a 2767 7275 622d 6564 em, the.'grub-ed │ │ │ │ │ +00026040: 6974 656e 7627 2075 7469 6c69 7479 2063 itenv' utility c │ │ │ │ │ +00026050: 616e 2062 6520 7573 6564 2074 6f20 6564 an be used to ed │ │ │ │ │ +00026060: 6974 2074 6865 2065 6e76 6972 6f6e 6d65 it the environme │ │ │ │ │ +00026070: 6e74 2062 6c6f 636b 2e0a 0a20 2020 466f nt block... Fo │ │ │ │ │ +00026080: 7220 7361 6665 7479 2072 6561 736f 6e73 r safety reasons │ │ │ │ │ +00026090: 2c20 7468 6973 2073 746f 7261 6765 2069 , this storage i │ │ │ │ │ +000260a0: 7320 6f6e 6c79 2061 7661 696c 6162 6c65 s only available │ │ │ │ │ +000260b0: 2077 6865 6e20 696e 7374 616c 6c65 6420 when installed │ │ │ │ │ +000260c0: 6f6e 0a61 2070 6c61 696e 2064 6973 6b20 on.a plain disk │ │ │ │ │ +000260d0: 286e 6f20 4c56 4d20 6f72 2052 4149 4429 (no LVM or RAID) │ │ │ │ │ +000260e0: 2c20 7573 696e 6720 6120 6e6f 6e2d 6368 , using a non-ch │ │ │ │ │ +000260f0: 6563 6b73 756d 6d69 6e67 2066 696c 6573 ecksumming files │ │ │ │ │ +00026100: 7973 7465 6d20 286e 6f0a 5a46 5329 2c20 ystem (no.ZFS), │ │ │ │ │ +00026110: 616e 6420 7573 696e 6720 4249 4f53 206f and using BIOS o │ │ │ │ │ +00026120: 7220 4546 4920 6675 6e63 7469 6f6e 7320 r EFI functions │ │ │ │ │ +00026130: 286e 6f20 4154 412c 2055 5342 206f 7220 (no ATA, USB or │ │ │ │ │ +00026140: 4945 4545 3132 3735 292e 0a0a 2020 2027 IEEE1275)... ' │ │ │ │ │ +00026150: 6772 7562 2d6d 6b63 6f6e 6669 6727 2075 grub-mkconfig' u │ │ │ │ │ +00026160: 7365 7320 7468 6973 2066 6163 696c 6974 ses this facilit │ │ │ │ │ +00026170: 7920 746f 2069 6d70 6c65 6d65 6e74 2027 y to implement ' │ │ │ │ │ +00026180: 4752 5542 5f53 4156 4544 4546 4155 4c54 GRUB_SAVEDEFAULT │ │ │ │ │ +00026190: 270a 282a 6e6f 7465 2053 696d 706c 6520 '.(*note Simple │ │ │ │ │ +000261a0: 636f 6e66 6967 7572 6174 696f 6e3a 3a29 configuration::) │ │ │ │ │ +000261b0: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ +000261c0: 696e 666f 2c20 204e 6f64 653a 2043 6f6d info, Node: Com │ │ │ │ │ +000261d0: 6d61 6e64 732c 2020 4e65 7874 3a20 496e mands, Next: In │ │ │ │ │ +000261e0: 7465 726e 6174 696f 6e61 6c69 7361 7469 ternationalisati │ │ │ │ │ +000261f0: 6f6e 2c20 2050 7265 763a 2045 6e76 6972 on, Prev: Envir │ │ │ │ │ +00026200: 6f6e 6d65 6e74 2c20 2055 703a 2054 6f70 onment, Up: Top │ │ │ │ │ +00026210: 0a0a 3136 2054 6865 206c 6973 7420 6f66 ..16 The list of │ │ │ │ │ +00026220: 2061 7661 696c 6162 6c65 2063 6f6d 6d61 available comma │ │ │ │ │ +00026230: 6e64 730a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a nds.************ │ │ │ │ │ 00026240: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -00026250: 2a2a 2a2a 2a2a 2a0a 0a49 6e20 7468 6973 *******..In this │ │ │ │ │ -00026260: 2063 6861 7074 6572 2c20 7765 206c 6973 chapter, we lis │ │ │ │ │ -00026270: 7420 616c 6c20 636f 6d6d 616e 6473 2074 t all commands t │ │ │ │ │ -00026280: 6861 7420 6172 6520 6176 6169 6c61 626c hat are availabl │ │ │ │ │ -00026290: 6520 696e 2047 5255 422e 0a0a 2020 2043 e in GRUB... C │ │ │ │ │ -000262a0: 6f6d 6d61 6e64 7320 6265 6c6f 6e67 2074 ommands belong t │ │ │ │ │ -000262b0: 6f20 6469 6666 6572 656e 7420 6772 6f75 o different grou │ │ │ │ │ -000262c0: 7073 2e20 2041 2066 6577 2063 616e 206f ps. A few can o │ │ │ │ │ -000262d0: 6e6c 7920 6265 2075 7365 6420 696e 2074 nly be used in t │ │ │ │ │ -000262e0: 6865 0a67 6c6f 6261 6c20 7365 6374 696f he.global sectio │ │ │ │ │ -000262f0: 6e20 6f66 2074 6865 2063 6f6e 6669 6775 n of the configu │ │ │ │ │ -00026300: 7261 7469 6f6e 2066 696c 6520 286f 7220 ration file (or │ │ │ │ │ -00026310: 226d 656e 7522 293b 206d 6f73 7420 6f66 "menu"); most of │ │ │ │ │ -00026320: 2074 6865 6d20 6361 6e0a 6265 2065 6e74 them can.be ent │ │ │ │ │ -00026330: 6572 6564 206f 6e20 7468 6520 636f 6d6d ered on the comm │ │ │ │ │ -00026340: 616e 642d 6c69 6e65 2061 6e64 2063 616e and-line and can │ │ │ │ │ -00026350: 2062 6520 7573 6564 2065 6974 6865 7220 be used either │ │ │ │ │ -00026360: 616e 7977 6865 7265 2069 6e20 7468 650a anywhere in the. │ │ │ │ │ -00026370: 6d65 6e75 206f 7220 7370 6563 6966 6963 menu or specific │ │ │ │ │ -00026380: 616c 6c79 2069 6e20 7468 6520 6d65 6e75 ally in the menu │ │ │ │ │ -00026390: 2065 6e74 7269 6573 2e0a 0a20 2020 496e entries... In │ │ │ │ │ -000263a0: 2072 6573 6375 6520 6d6f 6465 2c20 6f6e rescue mode, on │ │ │ │ │ -000263b0: 6c79 2074 6865 2027 696e 736d 6f64 2720 ly the 'insmod' │ │ │ │ │ -000263c0: 282a 6e6f 7465 2069 6e73 6d6f 643a 3a29 (*note insmod::) │ │ │ │ │ -000263d0: 2c20 276c 7327 2028 2a6e 6f74 650a 6c73 , 'ls' (*note.ls │ │ │ │ │ -000263e0: 3a3a 292c 2027 7365 7427 2028 2a6e 6f74 ::), 'set' (*not │ │ │ │ │ -000263f0: 6520 7365 743a 3a29 2c20 616e 6420 2775 e set::), and 'u │ │ │ │ │ -00026400: 6e73 6574 2720 282a 6e6f 7465 2075 6e73 nset' (*note uns │ │ │ │ │ -00026410: 6574 3a3a 2920 636f 6d6d 616e 6473 2061 et::) commands a │ │ │ │ │ -00026420: 7265 0a6e 6f72 6d61 6c6c 7920 6176 6169 re.normally avai │ │ │ │ │ -00026430: 6c61 626c 652e 2020 4966 2079 6f75 2065 lable. If you e │ │ │ │ │ -00026440: 6e64 2075 7020 696e 2072 6573 6375 6520 nd up in rescue │ │ │ │ │ -00026450: 6d6f 6465 2061 6e64 2064 6f20 6e6f 7420 mode and do not │ │ │ │ │ -00026460: 6b6e 6f77 2077 6861 740a 746f 2064 6f2c know what.to do, │ │ │ │ │ -00026470: 2074 6865 6e20 2a6e 6f74 6520 4752 5542 then *note GRUB │ │ │ │ │ -00026480: 206f 6e6c 7920 6f66 6665 7273 2061 2072 only offers a r │ │ │ │ │ -00026490: 6573 6375 6520 7368 656c 6c3a 3a2e 0a0a escue shell::... │ │ │ │ │ -000264a0: 2a20 4d65 6e75 3a0a 0a2a 204d 656e 752d * Menu:..* Menu- │ │ │ │ │ -000264b0: 7370 6563 6966 6963 2063 6f6d 6d61 6e64 specific command │ │ │ │ │ -000264c0: 733a 3a0a 2a20 4765 6e65 7261 6c20 636f s::.* General co │ │ │ │ │ -000264d0: 6d6d 616e 6473 3a3a 0a2a 2043 6f6d 6d61 mmands::.* Comma │ │ │ │ │ -000264e0: 6e64 2d6c 696e 6520 616e 6420 6d65 6e75 nd-line and menu │ │ │ │ │ -000264f0: 2065 6e74 7279 2063 6f6d 6d61 6e64 733a entry commands: │ │ │ │ │ -00026500: 3a0a 2a20 4e65 7477 6f72 6b69 6e67 2063 :.* Networking c │ │ │ │ │ -00026510: 6f6d 6d61 6e64 733a 3a0a 0a1f 0a46 696c ommands::....Fil │ │ │ │ │ -00026520: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ -00026530: 6f64 653a 204d 656e 752d 7370 6563 6966 ode: Menu-specif │ │ │ │ │ -00026540: 6963 2063 6f6d 6d61 6e64 732c 2020 4e65 ic commands, Ne │ │ │ │ │ -00026550: 7874 3a20 4765 6e65 7261 6c20 636f 6d6d xt: General comm │ │ │ │ │ -00026560: 616e 6473 2c20 2055 703a 2043 6f6d 6d61 ands, Up: Comma │ │ │ │ │ -00026570: 6e64 730a 0a31 362e 3120 5468 6520 6c69 nds..16.1 The li │ │ │ │ │ -00026580: 7374 206f 6620 636f 6d6d 616e 6473 2066 st of commands f │ │ │ │ │ -00026590: 6f72 2074 6865 206d 656e 7520 6f6e 6c79 or the menu only │ │ │ │ │ -000265a0: 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d .=============== │ │ │ │ │ +00026250: 2a2a 2a2a 2a0a 0a49 6e20 7468 6973 2063 *****..In this c │ │ │ │ │ +00026260: 6861 7074 6572 2c20 7765 206c 6973 7420 hapter, we list │ │ │ │ │ +00026270: 616c 6c20 636f 6d6d 616e 6473 2074 6861 all commands tha │ │ │ │ │ +00026280: 7420 6172 6520 6176 6169 6c61 626c 6520 t are available │ │ │ │ │ +00026290: 696e 2047 5255 422e 0a0a 2020 2043 6f6d in GRUB... Com │ │ │ │ │ +000262a0: 6d61 6e64 7320 6265 6c6f 6e67 2074 6f20 mands belong to │ │ │ │ │ +000262b0: 6469 6666 6572 656e 7420 6772 6f75 7073 different groups │ │ │ │ │ +000262c0: 2e20 2041 2066 6577 2063 616e 206f 6e6c . A few can onl │ │ │ │ │ +000262d0: 7920 6265 2075 7365 6420 696e 2074 6865 y be used in the │ │ │ │ │ +000262e0: 0a67 6c6f 6261 6c20 7365 6374 696f 6e20 .global section │ │ │ │ │ +000262f0: 6f66 2074 6865 2063 6f6e 6669 6775 7261 of the configura │ │ │ │ │ +00026300: 7469 6f6e 2066 696c 6520 286f 7220 226d tion file (or "m │ │ │ │ │ +00026310: 656e 7522 293b 206d 6f73 7420 6f66 2074 enu"); most of t │ │ │ │ │ +00026320: 6865 6d20 6361 6e0a 6265 2065 6e74 6572 hem can.be enter │ │ │ │ │ +00026330: 6564 206f 6e20 7468 6520 636f 6d6d 616e ed on the comman │ │ │ │ │ +00026340: 642d 6c69 6e65 2061 6e64 2063 616e 2062 d-line and can b │ │ │ │ │ +00026350: 6520 7573 6564 2065 6974 6865 7220 616e e used either an │ │ │ │ │ +00026360: 7977 6865 7265 2069 6e20 7468 650a 6d65 ywhere in the.me │ │ │ │ │ +00026370: 6e75 206f 7220 7370 6563 6966 6963 616c nu or specifical │ │ │ │ │ +00026380: 6c79 2069 6e20 7468 6520 6d65 6e75 2065 ly in the menu e │ │ │ │ │ +00026390: 6e74 7269 6573 2e0a 0a20 2020 496e 2072 ntries... In r │ │ │ │ │ +000263a0: 6573 6375 6520 6d6f 6465 2c20 6f6e 6c79 escue mode, only │ │ │ │ │ +000263b0: 2074 6865 2027 696e 736d 6f64 2720 282a the 'insmod' (* │ │ │ │ │ +000263c0: 6e6f 7465 2069 6e73 6d6f 643a 3a29 2c20 note insmod::), │ │ │ │ │ +000263d0: 276c 7327 2028 2a6e 6f74 650a 6c73 3a3a 'ls' (*note.ls:: │ │ │ │ │ +000263e0: 292c 2027 7365 7427 2028 2a6e 6f74 6520 ), 'set' (*note │ │ │ │ │ +000263f0: 7365 743a 3a29 2c20 616e 6420 2775 6e73 set::), and 'uns │ │ │ │ │ +00026400: 6574 2720 282a 6e6f 7465 2075 6e73 6574 et' (*note unset │ │ │ │ │ +00026410: 3a3a 2920 636f 6d6d 616e 6473 2061 7265 ::) commands are │ │ │ │ │ +00026420: 0a6e 6f72 6d61 6c6c 7920 6176 6169 6c61 .normally availa │ │ │ │ │ +00026430: 626c 652e 2020 4966 2079 6f75 2065 6e64 ble. If you end │ │ │ │ │ +00026440: 2075 7020 696e 2072 6573 6375 6520 6d6f up in rescue mo │ │ │ │ │ +00026450: 6465 2061 6e64 2064 6f20 6e6f 7420 6b6e de and do not kn │ │ │ │ │ +00026460: 6f77 2077 6861 740a 746f 2064 6f2c 2074 ow what.to do, t │ │ │ │ │ +00026470: 6865 6e20 2a6e 6f74 6520 4752 5542 206f hen *note GRUB o │ │ │ │ │ +00026480: 6e6c 7920 6f66 6665 7273 2061 2072 6573 nly offers a res │ │ │ │ │ +00026490: 6375 6520 7368 656c 6c3a 3a2e 0a0a 2a20 cue shell::...* │ │ │ │ │ +000264a0: 4d65 6e75 3a0a 0a2a 204d 656e 752d 7370 Menu:..* Menu-sp │ │ │ │ │ +000264b0: 6563 6966 6963 2063 6f6d 6d61 6e64 733a ecific commands: │ │ │ │ │ +000264c0: 3a0a 2a20 4765 6e65 7261 6c20 636f 6d6d :.* General comm │ │ │ │ │ +000264d0: 616e 6473 3a3a 0a2a 2043 6f6d 6d61 6e64 ands::.* Command │ │ │ │ │ +000264e0: 2d6c 696e 6520 616e 6420 6d65 6e75 2065 -line and menu e │ │ │ │ │ +000264f0: 6e74 7279 2063 6f6d 6d61 6e64 733a 3a0a ntry commands::. │ │ │ │ │ +00026500: 2a20 4e65 7477 6f72 6b69 6e67 2063 6f6d * Networking com │ │ │ │ │ +00026510: 6d61 6e64 733a 3a0a 0a1f 0a46 696c 653a mands::....File: │ │ │ │ │ +00026520: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ +00026530: 653a 204d 656e 752d 7370 6563 6966 6963 e: Menu-specific │ │ │ │ │ +00026540: 2063 6f6d 6d61 6e64 732c 2020 4e65 7874 commands, Next │ │ │ │ │ +00026550: 3a20 4765 6e65 7261 6c20 636f 6d6d 616e : General comman │ │ │ │ │ +00026560: 6473 2c20 2055 703a 2043 6f6d 6d61 6e64 ds, Up: Command │ │ │ │ │ +00026570: 730a 0a31 362e 3120 5468 6520 6c69 7374 s..16.1 The list │ │ │ │ │ +00026580: 206f 6620 636f 6d6d 616e 6473 2066 6f72 of commands for │ │ │ │ │ +00026590: 2074 6865 206d 656e 7520 6f6e 6c79 0a3d the menu only.= │ │ │ │ │ +000265a0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 000265b0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -000265c0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 5468 ============..Th │ │ │ │ │ -000265d0: 6520 7365 6d61 6e74 6963 7320 7573 6564 e semantics used │ │ │ │ │ -000265e0: 2069 6e20 7061 7273 696e 6720 7468 6520 in parsing the │ │ │ │ │ -000265f0: 636f 6e66 6967 7572 6174 696f 6e20 6669 configuration fi │ │ │ │ │ -00026600: 6c65 2061 7265 2074 6865 2066 6f6c 6c6f le are the follo │ │ │ │ │ -00026610: 7769 6e67 3a0a 0a20 2020 2a20 5468 6520 wing:.. * The │ │ │ │ │ -00026620: 6669 6c65 7320 5f6d 7573 745f 2062 6520 files _must_ be │ │ │ │ │ -00026630: 696e 2070 6c61 696e 2d74 6578 7420 666f in plain-text fo │ │ │ │ │ -00026640: 726d 6174 2e0a 0a20 2020 2a20 2723 2720 rmat... * '#' │ │ │ │ │ -00026650: 6174 2074 6865 2062 6567 696e 6e69 6e67 at the beginning │ │ │ │ │ -00026660: 206f 6620 6120 6c69 6e65 2069 6e20 6120 of a line in a │ │ │ │ │ -00026670: 636f 6e66 6967 7572 6174 696f 6e20 6669 configuration fi │ │ │ │ │ -00026680: 6c65 206d 6561 6e73 2069 7420 6973 0a20 le means it is. │ │ │ │ │ -00026690: 2020 2020 6f6e 6c79 2061 2063 6f6d 6d65 only a comme │ │ │ │ │ -000266a0: 6e74 2e0a 0a20 2020 2a20 4f70 7469 6f6e nt... * Option │ │ │ │ │ -000266b0: 7320 6172 6520 7365 7061 7261 7465 6420 s are separated │ │ │ │ │ -000266c0: 6279 2073 7061 6365 732e 0a0a 2020 202a by spaces... * │ │ │ │ │ -000266d0: 2041 6c6c 206e 756d 6265 7273 2063 616e All numbers can │ │ │ │ │ -000266e0: 2062 6520 6569 7468 6572 2064 6563 696d be either decim │ │ │ │ │ -000266f0: 616c 206f 7220 6865 7861 6465 6369 6d61 al or hexadecima │ │ │ │ │ -00026700: 6c2e 2020 4120 6865 7861 6465 6369 6d61 l. A hexadecima │ │ │ │ │ -00026710: 6c0a 2020 2020 206e 756d 6265 7220 6d75 l. number mu │ │ │ │ │ -00026720: 7374 2062 6520 7072 6563 6564 6564 2062 st be preceded b │ │ │ │ │ -00026730: 7920 2730 7827 2c20 616e 6420 6973 2063 y '0x', and is c │ │ │ │ │ -00026740: 6173 652d 696e 7365 6e73 6974 6976 652e ase-insensitive. │ │ │ │ │ -00026750: 0a0a 2020 2054 6865 7365 2063 6f6d 6d61 .. These comma │ │ │ │ │ -00026760: 6e64 7320 6361 6e20 6f6e 6c79 2062 6520 nds can only be │ │ │ │ │ -00026770: 7573 6564 2069 6e20 7468 6520 6d65 6e75 used in the menu │ │ │ │ │ -00026780: 3a0a 0a2a 204d 656e 753a 0a0a 2a20 6d65 :..* Menu:..* me │ │ │ │ │ -00026790: 6e75 656e 7472 793a 3a20 2020 2020 2020 nuentry:: │ │ │ │ │ -000267a0: 2020 2020 2020 2020 2020 2020 5374 6172 Star │ │ │ │ │ -000267b0: 7420 6120 6d65 6e75 2065 6e74 7279 0a2a t a menu entry.* │ │ │ │ │ -000267c0: 2073 7562 6d65 6e75 3a3a 2020 2020 2020 submenu:: │ │ │ │ │ -000267d0: 2020 2020 2020 2020 2020 2020 2020 2047 G │ │ │ │ │ -000267e0: 726f 7570 206d 656e 7520 656e 7472 6965 roup menu entrie │ │ │ │ │ -000267f0: 730a 0a1f 0a46 696c 653a 2067 7275 622e s....File: grub. │ │ │ │ │ -00026800: 696e 666f 2c20 204e 6f64 653a 206d 656e info, Node: men │ │ │ │ │ -00026810: 7565 6e74 7279 2c20 204e 6578 743a 2073 uentry, Next: s │ │ │ │ │ -00026820: 7562 6d65 6e75 2c20 2055 703a 204d 656e ubmenu, Up: Men │ │ │ │ │ -00026830: 752d 7370 6563 6966 6963 2063 6f6d 6d61 u-specific comma │ │ │ │ │ -00026840: 6e64 730a 0a31 362e 312e 3120 6d65 6e75 nds..16.1.1 menu │ │ │ │ │ -00026850: 656e 7472 790a 2d2d 2d2d 2d2d 2d2d 2d2d entry.---------- │ │ │ │ │ -00026860: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ │ -00026870: 616e 643a 206d 656e 7565 6e74 7279 2054 and: menuentry T │ │ │ │ │ -00026880: 4954 4c45 205b 2d2d 636c 6173 733d 636c ITLE [--class=cl │ │ │ │ │ -00026890: 6173 7320 2e2e 2e5d 205b 2d2d 7573 6572 ass ...] [--user │ │ │ │ │ -000268a0: 733d 7573 6572 735d 0a20 2020 2020 2020 s=users]. │ │ │ │ │ -000268b0: 2020 205b 2d2d 756e 7265 7374 7269 6374 [--unrestrict │ │ │ │ │ -000268c0: 6564 5d20 5b2d 2d68 6f74 6b65 793d 6b65 ed] [--hotkey=ke │ │ │ │ │ -000268d0: 795d 205b 2d2d 6964 3d69 645d 205b 4152 y] [--id=id] [AR │ │ │ │ │ -000268e0: 4720 2e2e 2e5d 207b 2043 4f4d 4d41 4e44 G ...] { COMMAND │ │ │ │ │ -000268f0: 3b0a 2020 2020 2020 2020 2020 2e2e 2e20 ;. ... │ │ │ │ │ -00026900: 7d0a 2020 2020 2054 6869 7320 6465 6669 }. This defi │ │ │ │ │ -00026910: 6e65 7320 6120 4752 5542 206d 656e 7520 nes a GRUB menu │ │ │ │ │ -00026920: 656e 7472 7920 6e61 6d65 6420 5449 544c entry named TITL │ │ │ │ │ -00026930: 452e 2020 5768 656e 2074 6869 7320 656e E. When this en │ │ │ │ │ -00026940: 7472 7920 6973 0a20 2020 2020 7365 6c65 try is. sele │ │ │ │ │ -00026950: 6374 6564 2066 726f 6d20 7468 6520 6d65 cted from the me │ │ │ │ │ -00026960: 6e75 2c20 4752 5542 2077 696c 6c20 7365 nu, GRUB will se │ │ │ │ │ -00026970: 7420 7468 6520 4348 4f53 454e 2065 6e76 t the CHOSEN env │ │ │ │ │ -00026980: 6972 6f6e 6d65 6e74 0a20 2020 2020 7661 ironment. va │ │ │ │ │ -00026990: 7269 6162 6c65 2074 6f20 7661 6c75 6520 riable to value │ │ │ │ │ -000269a0: 6f66 2027 2d2d 6964 2720 6966 2027 2d2d of '--id' if '-- │ │ │ │ │ -000269b0: 6964 2720 6973 2067 6976 656e 2c20 6578 id' is given, ex │ │ │ │ │ -000269c0: 6563 7574 6520 7468 6520 6c69 7374 206f ecute the list o │ │ │ │ │ -000269d0: 660a 2020 2020 2063 6f6d 6d61 6e64 7320 f. commands │ │ │ │ │ -000269e0: 6769 7665 6e20 7769 7468 696e 2062 7261 given within bra │ │ │ │ │ -000269f0: 6365 732c 2061 6e64 2069 6620 7468 6520 ces, and if the │ │ │ │ │ -00026a00: 6c61 7374 2063 6f6d 6d61 6e64 2069 6e20 last command in │ │ │ │ │ -00026a10: 7468 6520 6c69 7374 0a20 2020 2020 7265 the list. re │ │ │ │ │ -00026a20: 7475 726e 6564 2073 7563 6365 7373 6675 turned successfu │ │ │ │ │ -00026a30: 6c6c 7920 616e 6420 6120 6b65 726e 656c lly and a kernel │ │ │ │ │ -00026a40: 2077 6173 206c 6f61 6465 6420 6974 2077 was loaded it w │ │ │ │ │ -00026a50: 696c 6c20 6578 6563 7574 6520 7468 650a ill execute the. │ │ │ │ │ -00026a60: 2020 2020 2027 626f 6f74 2720 636f 6d6d 'boot' comm │ │ │ │ │ -00026a70: 616e 642e 0a0a 2020 2020 2054 6865 2027 and... The ' │ │ │ │ │ -00026a80: 2d2d 636c 6173 7327 206f 7074 696f 6e20 --class' option │ │ │ │ │ -00026a90: 6d61 7920 6265 2075 7365 6420 616e 7920 may be used any │ │ │ │ │ -00026aa0: 6e75 6d62 6572 206f 6620 7469 6d65 7320 number of times │ │ │ │ │ -00026ab0: 746f 2067 726f 7570 206d 656e 750a 2020 to group menu. │ │ │ │ │ -00026ac0: 2020 2065 6e74 7269 6573 2069 6e74 6f20 entries into │ │ │ │ │ -00026ad0: 636c 6173 7365 732e 2020 4d65 6e75 2074 classes. Menu t │ │ │ │ │ -00026ae0: 6865 6d65 7320 6d61 7920 6469 7370 6c61 hemes may displa │ │ │ │ │ -00026af0: 7920 6469 6666 6572 656e 7420 636c 6173 y different clas │ │ │ │ │ -00026b00: 7365 730a 2020 2020 2075 7369 6e67 2064 ses. using d │ │ │ │ │ -00026b10: 6966 6665 7265 6e74 2073 7479 6c65 732e ifferent styles. │ │ │ │ │ -00026b20: 0a0a 2020 2020 2054 6865 2027 2d2d 7573 .. The '--us │ │ │ │ │ -00026b30: 6572 7327 206f 7074 696f 6e20 6772 616e ers' option gran │ │ │ │ │ -00026b40: 7473 2073 7065 6369 6669 6320 7573 6572 ts specific user │ │ │ │ │ -00026b50: 7320 6163 6365 7373 2074 6f20 7370 6563 s access to spec │ │ │ │ │ -00026b60: 6966 6963 206d 656e 750a 2020 2020 2065 ific menu. e │ │ │ │ │ -00026b70: 6e74 7269 6573 2e20 202a 4e6f 7465 2053 ntries. *Note S │ │ │ │ │ -00026b80: 6563 7572 6974 793a 3a2e 0a0a 2020 2020 ecurity::... │ │ │ │ │ -00026b90: 2054 6865 2027 2d2d 756e 7265 7374 7269 The '--unrestri │ │ │ │ │ -00026ba0: 6374 6564 2720 6f70 7469 6f6e 2067 7261 cted' option gra │ │ │ │ │ -00026bb0: 6e74 7320 616c 6c20 7573 6572 7320 6163 nts all users ac │ │ │ │ │ -00026bc0: 6365 7373 2074 6f20 7370 6563 6966 6963 cess to specific │ │ │ │ │ -00026bd0: 0a20 2020 2020 6d65 6e75 2065 6e74 7269 . menu entri │ │ │ │ │ -00026be0: 6573 2e20 202a 4e6f 7465 2053 6563 7572 es. *Note Secur │ │ │ │ │ -00026bf0: 6974 793a 3a2e 0a0a 2020 2020 2054 6865 ity::... The │ │ │ │ │ -00026c00: 2027 2d2d 686f 746b 6579 2720 6f70 7469 '--hotkey' opti │ │ │ │ │ -00026c10: 6f6e 2061 7373 6f63 6961 7465 7320 6120 on associates a │ │ │ │ │ -00026c20: 686f 746b 6579 2077 6974 6820 6120 6d65 hotkey with a me │ │ │ │ │ -00026c30: 6e75 2065 6e74 7279 2e20 204b 4559 0a20 nu entry. KEY. │ │ │ │ │ -00026c40: 2020 2020 6d61 7920 6265 2061 2073 696e may be a sin │ │ │ │ │ -00026c50: 676c 6520 6c65 7474 6572 2c20 6f72 206f gle letter, or o │ │ │ │ │ -00026c60: 6e65 206f 6620 7468 6520 616c 6961 7365 ne of the aliase │ │ │ │ │ -00026c70: 7320 2762 6163 6b73 7061 6365 272c 2027 s 'backspace', ' │ │ │ │ │ -00026c80: 7461 6227 2c0a 2020 2020 206f 7220 2764 tab',. or 'd │ │ │ │ │ -00026c90: 656c 6574 6527 2e0a 0a20 2020 2020 5468 elete'... Th │ │ │ │ │ -00026ca0: 6520 272d 2d69 6427 206d 6179 2062 6520 e '--id' may be │ │ │ │ │ -00026cb0: 7573 6564 2074 6f20 6173 736f 6369 6174 used to associat │ │ │ │ │ -00026cc0: 6520 756e 6971 7565 2069 6465 6e74 6966 e unique identif │ │ │ │ │ -00026cd0: 6965 7220 7769 7468 2061 206d 656e 750a ier with a menu. │ │ │ │ │ -00026ce0: 2020 2020 2065 6e74 7279 2e20 2049 4420 entry. ID │ │ │ │ │ -00026cf0: 6973 2073 7472 696e 6720 6f66 2041 5343 is string of ASC │ │ │ │ │ -00026d00: 4949 2061 7068 616e 756d 6572 6963 2063 II aphanumeric c │ │ │ │ │ -00026d10: 6861 7261 6374 6572 732c 2075 6e64 6572 haracters, under │ │ │ │ │ -00026d20: 7363 6f72 650a 2020 2020 2061 6e64 2068 score. and h │ │ │ │ │ -00026d30: 7970 6865 6e20 616e 6420 7368 6f75 6c64 yphen and should │ │ │ │ │ -00026d40: 206e 6f74 2073 7461 7274 2077 6974 6820 not start with │ │ │ │ │ -00026d50: 6120 6469 6769 742e 0a0a 2020 2020 2041 a digit... A │ │ │ │ │ -00026d60: 6c6c 206f 7468 6572 2061 7267 756d 656e ll other argumen │ │ │ │ │ -00026d70: 7473 2069 6e63 6c75 6469 6e67 2054 4954 ts including TIT │ │ │ │ │ -00026d80: 4c45 2061 7265 2070 6173 7365 6420 6173 LE are passed as │ │ │ │ │ -00026d90: 2070 6f73 6974 696f 6e61 6c0a 2020 2020 positional. │ │ │ │ │ -00026da0: 2070 6172 616d 6574 6572 7320 7768 656e parameters when │ │ │ │ │ -00026db0: 206c 6973 7420 6f66 2063 6f6d 6d61 6e64 list of command │ │ │ │ │ -00026dc0: 7320 6973 2065 7865 6375 7465 6420 7769 s is executed wi │ │ │ │ │ -00026dd0: 7468 2054 4954 4c45 2061 6c77 6179 730a th TITLE always. │ │ │ │ │ -00026de0: 2020 2020 2061 7373 6967 6e65 6420 746f assigned to │ │ │ │ │ -00026df0: 2027 2431 272e 0a0a 1f0a 4669 6c65 3a20 '$1'.....File: │ │ │ │ │ -00026e00: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ -00026e10: 3a20 7375 626d 656e 752c 2020 5072 6576 : submenu, Prev │ │ │ │ │ -00026e20: 3a20 6d65 6e75 656e 7472 792c 2020 5570 : menuentry, Up │ │ │ │ │ -00026e30: 3a20 4d65 6e75 2d73 7065 6369 6669 6320 : Menu-specific │ │ │ │ │ -00026e40: 636f 6d6d 616e 6473 0a0a 3136 2e31 2e32 commands..16.1.2 │ │ │ │ │ -00026e50: 2073 7562 6d65 6e75 0a2d 2d2d 2d2d 2d2d submenu.------- │ │ │ │ │ -00026e60: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d -------.. -- Com │ │ │ │ │ -00026e70: 6d61 6e64 3a20 7375 626d 656e 7520 5449 mand: submenu TI │ │ │ │ │ -00026e80: 544c 4520 5b2d 2d63 6c61 7373 3d63 6c61 TLE [--class=cla │ │ │ │ │ -00026e90: 7373 202e 2e2e 5d20 5b2d 2d75 7365 7273 ss ...] [--users │ │ │ │ │ -00026ea0: 3d75 7365 7273 5d0a 2020 2020 2020 2020 =users]. │ │ │ │ │ -00026eb0: 2020 5b2d 2d75 6e72 6573 7472 6963 7465 [--unrestricte │ │ │ │ │ -00026ec0: 645d 205b 2d2d 686f 746b 6579 3d6b 6579 d] [--hotkey=key │ │ │ │ │ -00026ed0: 5d20 5b2d 2d69 643d 6964 5d20 7b20 4d45 ] [--id=id] { ME │ │ │ │ │ -00026ee0: 4e55 2045 4e54 5249 4553 202e 2e2e 207d NU ENTRIES ... } │ │ │ │ │ -00026ef0: 0a20 2020 2020 5468 6973 2064 6566 696e . This defin │ │ │ │ │ -00026f00: 6573 2061 2073 7562 6d65 6e75 2e20 2041 es a submenu. A │ │ │ │ │ -00026f10: 6e20 656e 7472 7920 6361 6c6c 6564 2054 n entry called T │ │ │ │ │ -00026f20: 4954 4c45 2077 696c 6c20 6265 2061 6464 ITLE will be add │ │ │ │ │ -00026f30: 6564 2074 6f20 7468 650a 2020 2020 206d ed to the. m │ │ │ │ │ -00026f40: 656e 753b 2077 6865 6e20 7468 6174 2065 enu; when that e │ │ │ │ │ -00026f50: 6e74 7279 2069 7320 7365 6c65 6374 6564 ntry is selected │ │ │ │ │ -00026f60: 2c20 6120 6e65 7720 6d65 6e75 2077 696c , a new menu wil │ │ │ │ │ -00026f70: 6c20 6265 2064 6973 706c 6179 6564 0a20 l be displayed. │ │ │ │ │ -00026f80: 2020 2020 7368 6f77 696e 6720 616c 6c20 showing all │ │ │ │ │ -00026f90: 7468 6520 656e 7472 6965 7320 7769 7468 the entries with │ │ │ │ │ -00026fa0: 696e 2074 6869 7320 7375 626d 656e 752e in this submenu. │ │ │ │ │ -00026fb0: 0a0a 2020 2020 2041 6c6c 206f 7074 696f .. All optio │ │ │ │ │ -00026fc0: 6e73 2061 7265 2074 6865 2073 616d 6520 ns are the same │ │ │ │ │ -00026fd0: 6173 2069 6e20 7468 6520 276d 656e 7565 as in the 'menue │ │ │ │ │ -00026fe0: 6e74 7279 2720 636f 6d6d 616e 6420 282a ntry' command (* │ │ │ │ │ -00026ff0: 6e6f 7465 0a20 2020 2020 6d65 6e75 656e note. menuen │ │ │ │ │ -00027000: 7472 793a 3a29 2e0a 0a1f 0a46 696c 653a try::).....File: │ │ │ │ │ -00027010: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ -00027020: 653a 2047 656e 6572 616c 2063 6f6d 6d61 e: General comma │ │ │ │ │ -00027030: 6e64 732c 2020 4e65 7874 3a20 436f 6d6d nds, Next: Comm │ │ │ │ │ -00027040: 616e 642d 6c69 6e65 2061 6e64 206d 656e and-line and men │ │ │ │ │ -00027050: 7520 656e 7472 7920 636f 6d6d 616e 6473 u entry commands │ │ │ │ │ -00027060: 2c20 2050 7265 763a 204d 656e 752d 7370 , Prev: Menu-sp │ │ │ │ │ -00027070: 6563 6966 6963 2063 6f6d 6d61 6e64 732c ecific commands, │ │ │ │ │ -00027080: 2020 5570 3a20 436f 6d6d 616e 6473 0a0a Up: Commands.. │ │ │ │ │ -00027090: 3136 2e32 2054 6865 206c 6973 7420 6f66 16.2 The list of │ │ │ │ │ -000270a0: 2067 656e 6572 616c 2063 6f6d 6d61 6e64 general command │ │ │ │ │ -000270b0: 730a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d s.============== │ │ │ │ │ +000265c0: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 5468 6520 ==========..The │ │ │ │ │ +000265d0: 7365 6d61 6e74 6963 7320 7573 6564 2069 semantics used i │ │ │ │ │ +000265e0: 6e20 7061 7273 696e 6720 7468 6520 636f n parsing the co │ │ │ │ │ +000265f0: 6e66 6967 7572 6174 696f 6e20 6669 6c65 nfiguration file │ │ │ │ │ +00026600: 2061 7265 2074 6865 2066 6f6c 6c6f 7769 are the followi │ │ │ │ │ +00026610: 6e67 3a0a 0a20 2020 2a20 5468 6520 6669 ng:.. * The fi │ │ │ │ │ +00026620: 6c65 7320 5f6d 7573 745f 2062 6520 696e les _must_ be in │ │ │ │ │ +00026630: 2070 6c61 696e 2d74 6578 7420 666f 726d plain-text form │ │ │ │ │ +00026640: 6174 2e0a 0a20 2020 2a20 2723 2720 6174 at... * '#' at │ │ │ │ │ +00026650: 2074 6865 2062 6567 696e 6e69 6e67 206f the beginning o │ │ │ │ │ +00026660: 6620 6120 6c69 6e65 2069 6e20 6120 636f f a line in a co │ │ │ │ │ +00026670: 6e66 6967 7572 6174 696f 6e20 6669 6c65 nfiguration file │ │ │ │ │ +00026680: 206d 6561 6e73 2069 7420 6973 0a20 2020 means it is. │ │ │ │ │ +00026690: 2020 6f6e 6c79 2061 2063 6f6d 6d65 6e74 only a comment │ │ │ │ │ +000266a0: 2e0a 0a20 2020 2a20 4f70 7469 6f6e 7320 ... * Options │ │ │ │ │ +000266b0: 6172 6520 7365 7061 7261 7465 6420 6279 are separated by │ │ │ │ │ +000266c0: 2073 7061 6365 732e 0a0a 2020 202a 2041 spaces... * A │ │ │ │ │ +000266d0: 6c6c 206e 756d 6265 7273 2063 616e 2062 ll numbers can b │ │ │ │ │ +000266e0: 6520 6569 7468 6572 2064 6563 696d 616c e either decimal │ │ │ │ │ +000266f0: 206f 7220 6865 7861 6465 6369 6d61 6c2e or hexadecimal. │ │ │ │ │ +00026700: 2020 4120 6865 7861 6465 6369 6d61 6c0a A hexadecimal. │ │ │ │ │ +00026710: 2020 2020 206e 756d 6265 7220 6d75 7374 number must │ │ │ │ │ +00026720: 2062 6520 7072 6563 6564 6564 2062 7920 be preceded by │ │ │ │ │ +00026730: 2730 7827 2c20 616e 6420 6973 2063 6173 '0x', and is cas │ │ │ │ │ +00026740: 652d 696e 7365 6e73 6974 6976 652e 0a0a e-insensitive... │ │ │ │ │ +00026750: 2020 2054 6865 7365 2063 6f6d 6d61 6e64 These command │ │ │ │ │ +00026760: 7320 6361 6e20 6f6e 6c79 2062 6520 7573 s can only be us │ │ │ │ │ +00026770: 6564 2069 6e20 7468 6520 6d65 6e75 3a0a ed in the menu:. │ │ │ │ │ +00026780: 0a2a 204d 656e 753a 0a0a 2a20 6d65 6e75 .* Menu:..* menu │ │ │ │ │ +00026790: 656e 7472 793a 3a20 2020 2020 2020 2020 entry:: │ │ │ │ │ +000267a0: 2020 2020 2020 2020 2020 5374 6172 7420 Start │ │ │ │ │ +000267b0: 6120 6d65 6e75 2065 6e74 7279 0a2a 2073 a menu entry.* s │ │ │ │ │ +000267c0: 7562 6d65 6e75 3a3a 2020 2020 2020 2020 ubmenu:: │ │ │ │ │ +000267d0: 2020 2020 2020 2020 2020 2020 2047 726f Gro │ │ │ │ │ +000267e0: 7570 206d 656e 7520 656e 7472 6965 730a up menu entries. │ │ │ │ │ +000267f0: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ +00026800: 666f 2c20 204e 6f64 653a 206d 656e 7565 fo, Node: menue │ │ │ │ │ +00026810: 6e74 7279 2c20 204e 6578 743a 2073 7562 ntry, Next: sub │ │ │ │ │ +00026820: 6d65 6e75 2c20 2055 703a 204d 656e 752d menu, Up: Menu- │ │ │ │ │ +00026830: 7370 6563 6966 6963 2063 6f6d 6d61 6e64 specific command │ │ │ │ │ +00026840: 730a 0a31 362e 312e 3120 6d65 6e75 656e s..16.1.1 menuen │ │ │ │ │ +00026850: 7472 790a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d try.------------ │ │ │ │ │ +00026860: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ │ +00026870: 643a 206d 656e 7565 6e74 7279 2054 4954 d: menuentry TIT │ │ │ │ │ +00026880: 4c45 205b 2d2d 636c 6173 733d 636c 6173 LE [--class=clas │ │ │ │ │ +00026890: 7320 2e2e 2e5d 205b 2d2d 7573 6572 733d s ...] [--users= │ │ │ │ │ +000268a0: 7573 6572 735d 0a20 2020 2020 2020 2020 users]. │ │ │ │ │ +000268b0: 205b 2d2d 756e 7265 7374 7269 6374 6564 [--unrestricted │ │ │ │ │ +000268c0: 5d20 5b2d 2d68 6f74 6b65 793d 6b65 795d ] [--hotkey=key] │ │ │ │ │ +000268d0: 205b 2d2d 6964 3d69 645d 205b 4152 4720 [--id=id] [ARG │ │ │ │ │ +000268e0: 2e2e 2e5d 207b 2043 4f4d 4d41 4e44 3b0a ...] { COMMAND;. │ │ │ │ │ +000268f0: 2020 2020 2020 2020 2020 2e2e 2e20 7d0a ... }. │ │ │ │ │ +00026900: 2020 2020 2054 6869 7320 6465 6669 6e65 This define │ │ │ │ │ +00026910: 7320 6120 4752 5542 206d 656e 7520 656e s a GRUB menu en │ │ │ │ │ +00026920: 7472 7920 6e61 6d65 6420 5449 544c 452e try named TITLE. │ │ │ │ │ +00026930: 2020 5768 656e 2074 6869 7320 656e 7472 When this entr │ │ │ │ │ +00026940: 7920 6973 0a20 2020 2020 7365 6c65 6374 y is. select │ │ │ │ │ +00026950: 6564 2066 726f 6d20 7468 6520 6d65 6e75 ed from the menu │ │ │ │ │ +00026960: 2c20 4752 5542 2077 696c 6c20 7365 7420 , GRUB will set │ │ │ │ │ +00026970: 7468 6520 4348 4f53 454e 2065 6e76 6972 the CHOSEN envir │ │ │ │ │ +00026980: 6f6e 6d65 6e74 0a20 2020 2020 7661 7269 onment. vari │ │ │ │ │ +00026990: 6162 6c65 2074 6f20 7661 6c75 6520 6f66 able to value of │ │ │ │ │ +000269a0: 2027 2d2d 6964 2720 6966 2027 2d2d 6964 '--id' if '--id │ │ │ │ │ +000269b0: 2720 6973 2067 6976 656e 2c20 6578 6563 ' is given, exec │ │ │ │ │ +000269c0: 7574 6520 7468 6520 6c69 7374 206f 660a ute the list of. │ │ │ │ │ +000269d0: 2020 2020 2063 6f6d 6d61 6e64 7320 6769 commands gi │ │ │ │ │ +000269e0: 7665 6e20 7769 7468 696e 2062 7261 6365 ven within brace │ │ │ │ │ +000269f0: 732c 2061 6e64 2069 6620 7468 6520 6c61 s, and if the la │ │ │ │ │ +00026a00: 7374 2063 6f6d 6d61 6e64 2069 6e20 7468 st command in th │ │ │ │ │ +00026a10: 6520 6c69 7374 0a20 2020 2020 7265 7475 e list. retu │ │ │ │ │ +00026a20: 726e 6564 2073 7563 6365 7373 6675 6c6c rned successfull │ │ │ │ │ +00026a30: 7920 616e 6420 6120 6b65 726e 656c 2077 y and a kernel w │ │ │ │ │ +00026a40: 6173 206c 6f61 6465 6420 6974 2077 696c as loaded it wil │ │ │ │ │ +00026a50: 6c20 6578 6563 7574 6520 7468 650a 2020 l execute the. │ │ │ │ │ +00026a60: 2020 2027 626f 6f74 2720 636f 6d6d 616e 'boot' comman │ │ │ │ │ +00026a70: 642e 0a0a 2020 2020 2054 6865 2027 2d2d d... The '-- │ │ │ │ │ +00026a80: 636c 6173 7327 206f 7074 696f 6e20 6d61 class' option ma │ │ │ │ │ +00026a90: 7920 6265 2075 7365 6420 616e 7920 6e75 y be used any nu │ │ │ │ │ +00026aa0: 6d62 6572 206f 6620 7469 6d65 7320 746f mber of times to │ │ │ │ │ +00026ab0: 2067 726f 7570 206d 656e 750a 2020 2020 group menu. │ │ │ │ │ +00026ac0: 2065 6e74 7269 6573 2069 6e74 6f20 636c entries into cl │ │ │ │ │ +00026ad0: 6173 7365 732e 2020 4d65 6e75 2074 6865 asses. Menu the │ │ │ │ │ +00026ae0: 6d65 7320 6d61 7920 6469 7370 6c61 7920 mes may display │ │ │ │ │ +00026af0: 6469 6666 6572 656e 7420 636c 6173 7365 different classe │ │ │ │ │ +00026b00: 730a 2020 2020 2075 7369 6e67 2064 6966 s. using dif │ │ │ │ │ +00026b10: 6665 7265 6e74 2073 7479 6c65 732e 0a0a ferent styles... │ │ │ │ │ +00026b20: 2020 2020 2054 6865 2027 2d2d 7573 6572 The '--user │ │ │ │ │ +00026b30: 7327 206f 7074 696f 6e20 6772 616e 7473 s' option grants │ │ │ │ │ +00026b40: 2073 7065 6369 6669 6320 7573 6572 7320 specific users │ │ │ │ │ +00026b50: 6163 6365 7373 2074 6f20 7370 6563 6966 access to specif │ │ │ │ │ +00026b60: 6963 206d 656e 750a 2020 2020 2065 6e74 ic menu. ent │ │ │ │ │ +00026b70: 7269 6573 2e20 202a 4e6f 7465 2053 6563 ries. *Note Sec │ │ │ │ │ +00026b80: 7572 6974 793a 3a2e 0a0a 2020 2020 2054 urity::... T │ │ │ │ │ +00026b90: 6865 2027 2d2d 756e 7265 7374 7269 6374 he '--unrestrict │ │ │ │ │ +00026ba0: 6564 2720 6f70 7469 6f6e 2067 7261 6e74 ed' option grant │ │ │ │ │ +00026bb0: 7320 616c 6c20 7573 6572 7320 6163 6365 s all users acce │ │ │ │ │ +00026bc0: 7373 2074 6f20 7370 6563 6966 6963 0a20 ss to specific. │ │ │ │ │ +00026bd0: 2020 2020 6d65 6e75 2065 6e74 7269 6573 menu entries │ │ │ │ │ +00026be0: 2e20 202a 4e6f 7465 2053 6563 7572 6974 . *Note Securit │ │ │ │ │ +00026bf0: 793a 3a2e 0a0a 2020 2020 2054 6865 2027 y::... The ' │ │ │ │ │ +00026c00: 2d2d 686f 746b 6579 2720 6f70 7469 6f6e --hotkey' option │ │ │ │ │ +00026c10: 2061 7373 6f63 6961 7465 7320 6120 686f associates a ho │ │ │ │ │ +00026c20: 746b 6579 2077 6974 6820 6120 6d65 6e75 tkey with a menu │ │ │ │ │ +00026c30: 2065 6e74 7279 2e20 204b 4559 0a20 2020 entry. KEY. │ │ │ │ │ +00026c40: 2020 6d61 7920 6265 2061 2073 696e 676c may be a singl │ │ │ │ │ +00026c50: 6520 6c65 7474 6572 2c20 6f72 206f 6e65 e letter, or one │ │ │ │ │ +00026c60: 206f 6620 7468 6520 616c 6961 7365 7320 of the aliases │ │ │ │ │ +00026c70: 2762 6163 6b73 7061 6365 272c 2027 7461 'backspace', 'ta │ │ │ │ │ +00026c80: 6227 2c0a 2020 2020 206f 7220 2764 656c b',. or 'del │ │ │ │ │ +00026c90: 6574 6527 2e0a 0a20 2020 2020 5468 6520 ete'... The │ │ │ │ │ +00026ca0: 272d 2d69 6427 206d 6179 2062 6520 7573 '--id' may be us │ │ │ │ │ +00026cb0: 6564 2074 6f20 6173 736f 6369 6174 6520 ed to associate │ │ │ │ │ +00026cc0: 756e 6971 7565 2069 6465 6e74 6966 6965 unique identifie │ │ │ │ │ +00026cd0: 7220 7769 7468 2061 206d 656e 750a 2020 r with a menu. │ │ │ │ │ +00026ce0: 2020 2065 6e74 7279 2e20 2049 4420 6973 entry. ID is │ │ │ │ │ +00026cf0: 2073 7472 696e 6720 6f66 2041 5343 4949 string of ASCII │ │ │ │ │ +00026d00: 2061 7068 616e 756d 6572 6963 2063 6861 aphanumeric cha │ │ │ │ │ +00026d10: 7261 6374 6572 732c 2075 6e64 6572 7363 racters, undersc │ │ │ │ │ +00026d20: 6f72 650a 2020 2020 2061 6e64 2068 7970 ore. and hyp │ │ │ │ │ +00026d30: 6865 6e20 616e 6420 7368 6f75 6c64 206e hen and should n │ │ │ │ │ +00026d40: 6f74 2073 7461 7274 2077 6974 6820 6120 ot start with a │ │ │ │ │ +00026d50: 6469 6769 742e 0a0a 2020 2020 2041 6c6c digit... All │ │ │ │ │ +00026d60: 206f 7468 6572 2061 7267 756d 656e 7473 other arguments │ │ │ │ │ +00026d70: 2069 6e63 6c75 6469 6e67 2054 4954 4c45 including TITLE │ │ │ │ │ +00026d80: 2061 7265 2070 6173 7365 6420 6173 2070 are passed as p │ │ │ │ │ +00026d90: 6f73 6974 696f 6e61 6c0a 2020 2020 2070 ositional. p │ │ │ │ │ +00026da0: 6172 616d 6574 6572 7320 7768 656e 206c arameters when l │ │ │ │ │ +00026db0: 6973 7420 6f66 2063 6f6d 6d61 6e64 7320 ist of commands │ │ │ │ │ +00026dc0: 6973 2065 7865 6375 7465 6420 7769 7468 is executed with │ │ │ │ │ +00026dd0: 2054 4954 4c45 2061 6c77 6179 730a 2020 TITLE always. │ │ │ │ │ +00026de0: 2020 2061 7373 6967 6e65 6420 746f 2027 assigned to ' │ │ │ │ │ +00026df0: 2431 272e 0a0a 1f0a 4669 6c65 3a20 6772 $1'.....File: gr │ │ │ │ │ +00026e00: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ +00026e10: 7375 626d 656e 752c 2020 5072 6576 3a20 submenu, Prev: │ │ │ │ │ +00026e20: 6d65 6e75 656e 7472 792c 2020 5570 3a20 menuentry, Up: │ │ │ │ │ +00026e30: 4d65 6e75 2d73 7065 6369 6669 6320 636f Menu-specific co │ │ │ │ │ +00026e40: 6d6d 616e 6473 0a0a 3136 2e31 2e32 2073 mmands..16.1.2 s │ │ │ │ │ +00026e50: 7562 6d65 6e75 0a2d 2d2d 2d2d 2d2d 2d2d ubmenu.--------- │ │ │ │ │ +00026e60: 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 -----.. -- Comma │ │ │ │ │ +00026e70: 6e64 3a20 7375 626d 656e 7520 5449 544c nd: submenu TITL │ │ │ │ │ +00026e80: 4520 5b2d 2d63 6c61 7373 3d63 6c61 7373 E [--class=class │ │ │ │ │ +00026e90: 202e 2e2e 5d20 5b2d 2d75 7365 7273 3d75 ...] [--users=u │ │ │ │ │ +00026ea0: 7365 7273 5d0a 2020 2020 2020 2020 2020 sers]. │ │ │ │ │ +00026eb0: 5b2d 2d75 6e72 6573 7472 6963 7465 645d [--unrestricted] │ │ │ │ │ +00026ec0: 205b 2d2d 686f 746b 6579 3d6b 6579 5d20 [--hotkey=key] │ │ │ │ │ +00026ed0: 5b2d 2d69 643d 6964 5d20 7b20 4d45 4e55 [--id=id] { MENU │ │ │ │ │ +00026ee0: 2045 4e54 5249 4553 202e 2e2e 207d 0a20 ENTRIES ... }. │ │ │ │ │ +00026ef0: 2020 2020 5468 6973 2064 6566 696e 6573 This defines │ │ │ │ │ +00026f00: 2061 2073 7562 6d65 6e75 2e20 2041 6e20 a submenu. An │ │ │ │ │ +00026f10: 656e 7472 7920 6361 6c6c 6564 2054 4954 entry called TIT │ │ │ │ │ +00026f20: 4c45 2077 696c 6c20 6265 2061 6464 6564 LE will be added │ │ │ │ │ +00026f30: 2074 6f20 7468 650a 2020 2020 206d 656e to the. men │ │ │ │ │ +00026f40: 753b 2077 6865 6e20 7468 6174 2065 6e74 u; when that ent │ │ │ │ │ +00026f50: 7279 2069 7320 7365 6c65 6374 6564 2c20 ry is selected, │ │ │ │ │ +00026f60: 6120 6e65 7720 6d65 6e75 2077 696c 6c20 a new menu will │ │ │ │ │ +00026f70: 6265 2064 6973 706c 6179 6564 0a20 2020 be displayed. │ │ │ │ │ +00026f80: 2020 7368 6f77 696e 6720 616c 6c20 7468 showing all th │ │ │ │ │ +00026f90: 6520 656e 7472 6965 7320 7769 7468 696e e entries within │ │ │ │ │ +00026fa0: 2074 6869 7320 7375 626d 656e 752e 0a0a this submenu... │ │ │ │ │ +00026fb0: 2020 2020 2041 6c6c 206f 7074 696f 6e73 All options │ │ │ │ │ +00026fc0: 2061 7265 2074 6865 2073 616d 6520 6173 are the same as │ │ │ │ │ +00026fd0: 2069 6e20 7468 6520 276d 656e 7565 6e74 in the 'menuent │ │ │ │ │ +00026fe0: 7279 2720 636f 6d6d 616e 6420 282a 6e6f ry' command (*no │ │ │ │ │ +00026ff0: 7465 0a20 2020 2020 6d65 6e75 656e 7472 te. menuentr │ │ │ │ │ +00027000: 793a 3a29 2e0a 0a1f 0a46 696c 653a 2067 y::).....File: g │ │ │ │ │ +00027010: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ +00027020: 2047 656e 6572 616c 2063 6f6d 6d61 6e64 General command │ │ │ │ │ +00027030: 732c 2020 4e65 7874 3a20 436f 6d6d 616e s, Next: Comman │ │ │ │ │ +00027040: 642d 6c69 6e65 2061 6e64 206d 656e 7520 d-line and menu │ │ │ │ │ +00027050: 656e 7472 7920 636f 6d6d 616e 6473 2c20 entry commands, │ │ │ │ │ +00027060: 2050 7265 763a 204d 656e 752d 7370 6563 Prev: Menu-spec │ │ │ │ │ +00027070: 6966 6963 2063 6f6d 6d61 6e64 732c 2020 ific commands, │ │ │ │ │ +00027080: 5570 3a20 436f 6d6d 616e 6473 0a0a 3136 Up: Commands..16 │ │ │ │ │ +00027090: 2e32 2054 6865 206c 6973 7420 6f66 2067 .2 The list of g │ │ │ │ │ +000270a0: 656e 6572 616c 2063 6f6d 6d61 6e64 730a eneral commands. │ │ │ │ │ +000270b0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 000270c0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -000270d0: 3d3d 3d0a 0a43 6f6d 6d61 6e64 7320 7573 ===..Commands us │ │ │ │ │ -000270e0: 6162 6c65 2061 6e79 7768 6572 6520 696e able anywhere in │ │ │ │ │ -000270f0: 2074 6865 206d 656e 7520 616e 6420 696e the menu and in │ │ │ │ │ -00027100: 2074 6865 2063 6f6d 6d61 6e64 2d6c 696e the command-lin │ │ │ │ │ -00027110: 652e 0a0a 2a20 4d65 6e75 3a0a 0a2a 2073 e...* Menu:..* s │ │ │ │ │ -00027120: 6572 6961 6c3a 3a20 2020 2020 2020 2020 erial:: │ │ │ │ │ -00027130: 2020 2020 2020 2020 2020 2020 2053 6574 Set │ │ │ │ │ -00027140: 2075 7020 6120 7365 7269 616c 2064 6576 up a serial dev │ │ │ │ │ -00027150: 6963 650a 2a20 7465 726d 696e 616c 5f69 ice.* terminal_i │ │ │ │ │ -00027160: 6e70 7574 3a3a 2020 2020 2020 2020 2020 nput:: │ │ │ │ │ -00027170: 2020 2020 4d61 6e61 6765 2069 6e70 7574 Manage input │ │ │ │ │ -00027180: 2074 6572 6d69 6e61 6c73 0a2a 2074 6572 terminals.* ter │ │ │ │ │ -00027190: 6d69 6e61 6c5f 6f75 7470 7574 3a3a 2020 minal_output:: │ │ │ │ │ -000271a0: 2020 2020 2020 2020 2020 204d 616e 6167 Manag │ │ │ │ │ -000271b0: 6520 6f75 7470 7574 2074 6572 6d69 6e61 e output termina │ │ │ │ │ -000271c0: 6c73 0a2a 2074 6572 6d69 6e66 6f3a 3a20 ls.* terminfo:: │ │ │ │ │ +000270d0: 3d0a 0a43 6f6d 6d61 6e64 7320 7573 6162 =..Commands usab │ │ │ │ │ +000270e0: 6c65 2061 6e79 7768 6572 6520 696e 2074 le anywhere in t │ │ │ │ │ +000270f0: 6865 206d 656e 7520 616e 6420 696e 2074 he menu and in t │ │ │ │ │ +00027100: 6865 2063 6f6d 6d61 6e64 2d6c 696e 652e he command-line. │ │ │ │ │ +00027110: 0a0a 2a20 4d65 6e75 3a0a 0a2a 2073 6572 ..* Menu:..* ser │ │ │ │ │ +00027120: 6961 6c3a 3a20 2020 2020 2020 2020 2020 ial:: │ │ │ │ │ +00027130: 2020 2020 2020 2020 2020 2053 6574 2075 Set u │ │ │ │ │ +00027140: 7020 6120 7365 7269 616c 2064 6576 6963 p a serial devic │ │ │ │ │ +00027150: 650a 2a20 7465 726d 696e 616c 5f69 6e70 e.* terminal_inp │ │ │ │ │ +00027160: 7574 3a3a 2020 2020 2020 2020 2020 2020 ut:: │ │ │ │ │ +00027170: 2020 4d61 6e61 6765 2069 6e70 7574 2074 Manage input t │ │ │ │ │ +00027180: 6572 6d69 6e61 6c73 0a2a 2074 6572 6d69 erminals.* termi │ │ │ │ │ +00027190: 6e61 6c5f 6f75 7470 7574 3a3a 2020 2020 nal_output:: │ │ │ │ │ +000271a0: 2020 2020 2020 2020 204d 616e 6167 6520 Manage │ │ │ │ │ +000271b0: 6f75 7470 7574 2074 6572 6d69 6e61 6c73 output terminals │ │ │ │ │ +000271c0: 0a2a 2074 6572 6d69 6e66 6f3a 3a20 2020 .* terminfo:: │ │ │ │ │ 000271d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000271e0: 2020 2044 6566 696e 6520 7465 726d 696e Define termin │ │ │ │ │ -000271f0: 616c 2074 7970 650a 0a1f 0a46 696c 653a al type....File: │ │ │ │ │ -00027200: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ -00027210: 653a 2073 6572 6961 6c2c 2020 4e65 7874 e: serial, Next │ │ │ │ │ -00027220: 3a20 7465 726d 696e 616c 5f69 6e70 7574 : terminal_input │ │ │ │ │ -00027230: 2c20 2055 703a 2047 656e 6572 616c 2063 , Up: General c │ │ │ │ │ -00027240: 6f6d 6d61 6e64 730a 0a31 362e 322e 3120 ommands..16.2.1 │ │ │ │ │ -00027250: 7365 7269 616c 0a2d 2d2d 2d2d 2d2d 2d2d serial.--------- │ │ │ │ │ -00027260: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ │ -00027270: 643a 2073 6572 6961 6c20 5b2d 2d75 6e69 d: serial [--uni │ │ │ │ │ -00027280: 743d 756e 6974 5d20 5b2d 2d70 6f72 743d t=unit] [--port= │ │ │ │ │ -00027290: 706f 7274 5d20 5b2d 2d73 7065 6564 3d73 port] [--speed=s │ │ │ │ │ -000272a0: 7065 6564 5d0a 2020 2020 2020 2020 2020 peed]. │ │ │ │ │ -000272b0: 5b2d 2d77 6f72 643d 776f 7264 5d20 5b2d [--word=word] [- │ │ │ │ │ -000272c0: 2d70 6172 6974 793d 7061 7269 7479 5d20 -parity=parity] │ │ │ │ │ -000272d0: 5b2d 2d73 746f 703d 7374 6f70 5d0a 2020 [--stop=stop]. │ │ │ │ │ -000272e0: 2020 2049 6e69 7469 616c 697a 6520 6120 Initialize a │ │ │ │ │ -000272f0: 7365 7269 616c 2064 6576 6963 652e 2020 serial device. │ │ │ │ │ -00027300: 554e 4954 2069 7320 6120 6e75 6d62 6572 UNIT is a number │ │ │ │ │ -00027310: 2069 6e20 7468 6520 7261 6e67 6520 302d in the range 0- │ │ │ │ │ -00027320: 330a 2020 2020 2073 7065 6369 6679 696e 3. specifyin │ │ │ │ │ -00027330: 6720 7768 6963 6820 7365 7269 616c 2070 g which serial p │ │ │ │ │ -00027340: 6f72 7420 746f 2075 7365 3b20 6465 6661 ort to use; defa │ │ │ │ │ -00027350: 756c 7420 6973 2030 2c20 7768 6963 680a ult is 0, which. │ │ │ │ │ -00027360: 2020 2020 2063 6f72 7265 7370 6f6e 6473 corresponds │ │ │ │ │ -00027370: 2074 6f20 7468 6520 706f 7274 206f 6674 to the port oft │ │ │ │ │ -00027380: 656e 2063 616c 6c65 6420 434f 4d31 2e20 en called COM1. │ │ │ │ │ -00027390: 2050 4f52 5420 6973 2074 6865 2049 2f4f PORT is the I/O │ │ │ │ │ -000273a0: 2070 6f72 740a 2020 2020 2077 6865 7265 port. where │ │ │ │ │ -000273b0: 2074 6865 2055 4152 5420 6973 2074 6f20 the UART is to │ │ │ │ │ -000273c0: 6265 2066 6f75 6e64 3b20 6966 2073 7065 be found; if spe │ │ │ │ │ -000273d0: 6369 6669 6564 2069 7420 7461 6b65 7320 cified it takes │ │ │ │ │ -000273e0: 7072 6563 6564 656e 6365 0a20 2020 2020 precedence. │ │ │ │ │ -000273f0: 6f76 6572 2055 4e49 542e 2020 5350 4545 over UNIT. SPEE │ │ │ │ │ -00027400: 4420 6973 2074 6865 2074 7261 6e73 6d69 D is the transmi │ │ │ │ │ -00027410: 7373 696f 6e20 7370 6565 643b 2064 6566 ssion speed; def │ │ │ │ │ -00027420: 6175 6c74 2069 7320 3936 3030 2e20 2057 ault is 9600. W │ │ │ │ │ -00027430: 4f52 440a 2020 2020 2061 6e64 2053 544f ORD. and STO │ │ │ │ │ -00027440: 5020 6172 6520 7468 6520 6e75 6d62 6572 P are the number │ │ │ │ │ -00027450: 206f 6620 6461 7461 2062 6974 7320 616e of data bits an │ │ │ │ │ -00027460: 6420 7374 6f70 2062 6974 732e 2020 4461 d stop bits. Da │ │ │ │ │ -00027470: 7461 2062 6974 7320 6d75 7374 0a20 2020 ta bits must. │ │ │ │ │ -00027480: 2020 6265 2069 6e20 7468 6520 7261 6e67 be in the rang │ │ │ │ │ -00027490: 6520 352d 3820 616e 6420 7374 6f70 2062 e 5-8 and stop b │ │ │ │ │ -000274a0: 6974 7320 6d75 7374 2062 6520 3120 6f72 its must be 1 or │ │ │ │ │ -000274b0: 2032 2e20 2044 6566 6175 6c74 2069 7320 2. Default is │ │ │ │ │ -000274c0: 380a 2020 2020 2064 6174 6120 6269 7473 8. data bits │ │ │ │ │ -000274d0: 2061 6e64 206f 6e65 2073 746f 7020 6269 and one stop bi │ │ │ │ │ -000274e0: 742e 2020 5041 5249 5459 2069 7320 6f6e t. PARITY is on │ │ │ │ │ -000274f0: 6520 6f66 2027 6e6f 272c 2027 6f64 6427 e of 'no', 'odd' │ │ │ │ │ -00027500: 2c20 2765 7665 6e27 0a20 2020 2020 616e , 'even'. an │ │ │ │ │ -00027510: 6420 6465 6661 756c 7473 2074 6f20 276e d defaults to 'n │ │ │ │ │ -00027520: 6f27 2e0a 0a20 2020 2020 5468 6520 7365 o'... The se │ │ │ │ │ -00027530: 7269 616c 2070 6f72 7420 6973 206e 6f74 rial port is not │ │ │ │ │ -00027540: 2075 7365 6420 6173 2061 2063 6f6d 6d75 used as a commu │ │ │ │ │ -00027550: 6e69 6361 7469 6f6e 2063 6861 6e6e 656c nication channel │ │ │ │ │ -00027560: 2075 6e6c 6573 7320 7468 650a 2020 2020 unless the. │ │ │ │ │ -00027570: 2027 7465 726d 696e 616c 5f69 6e70 7574 'terminal_input │ │ │ │ │ -00027580: 2720 6f72 2027 7465 726d 696e 616c 5f6f ' or 'terminal_o │ │ │ │ │ -00027590: 7574 7075 7427 2063 6f6d 6d61 6e64 2069 utput' command i │ │ │ │ │ -000275a0: 7320 7573 6564 2028 2a6e 6f74 650a 2020 s used (*note. │ │ │ │ │ -000275b0: 2020 2074 6572 6d69 6e61 6c5f 696e 7075 terminal_inpu │ │ │ │ │ -000275c0: 743a 3a2c 202a 6e6f 7465 2074 6572 6d69 t::, *note termi │ │ │ │ │ -000275d0: 6e61 6c5f 6f75 7470 7574 3a3a 292e 0a0a nal_output::)... │ │ │ │ │ -000275e0: 2020 2020 2053 6565 2061 6c73 6f20 2a6e See also *n │ │ │ │ │ -000275f0: 6f74 6520 5365 7269 616c 2074 6572 6d69 ote Serial termi │ │ │ │ │ -00027600: 6e61 6c3a 3a2e 0a0a 1f0a 4669 6c65 3a20 nal::.....File: │ │ │ │ │ -00027610: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ -00027620: 3a20 7465 726d 696e 616c 5f69 6e70 7574 : terminal_input │ │ │ │ │ -00027630: 2c20 204e 6578 743a 2074 6572 6d69 6e61 , Next: termina │ │ │ │ │ -00027640: 6c5f 6f75 7470 7574 2c20 2050 7265 763a l_output, Prev: │ │ │ │ │ -00027650: 2073 6572 6961 6c2c 2020 5570 3a20 4765 serial, Up: Ge │ │ │ │ │ -00027660: 6e65 7261 6c20 636f 6d6d 616e 6473 0a0a neral commands.. │ │ │ │ │ -00027670: 3136 2e32 2e32 2074 6572 6d69 6e61 6c5f 16.2.2 terminal_ │ │ │ │ │ -00027680: 696e 7075 740a 2d2d 2d2d 2d2d 2d2d 2d2d input.---------- │ │ │ │ │ -00027690: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d -----------.. -- │ │ │ │ │ -000276a0: 2043 6f6d 6d61 6e64 3a20 7465 726d 696e Command: termin │ │ │ │ │ -000276b0: 616c 5f69 6e70 7574 205b 2d2d 6170 7065 al_input [--appe │ │ │ │ │ -000276c0: 6e64 7c2d 2d72 656d 6f76 655d 205b 7465 nd|--remove] [te │ │ │ │ │ -000276d0: 726d 696e 616c 315d 205b 7465 726d 696e rminal1] [termin │ │ │ │ │ -000276e0: 616c 325d 0a20 2020 2020 2020 2020 202e al2]. . │ │ │ │ │ -000276f0: 2e2e 0a20 2020 2020 4c69 7374 206f 7220 ... List or │ │ │ │ │ -00027700: 7365 6c65 6374 2061 6e20 696e 7075 7420 select an input │ │ │ │ │ -00027710: 7465 726d 696e 616c 2e0a 0a20 2020 2020 terminal... │ │ │ │ │ -00027720: 5769 7468 206e 6f20 6172 6775 6d65 6e74 With no argument │ │ │ │ │ -00027730: 732c 206c 6973 7420 7468 6520 6163 7469 s, list the acti │ │ │ │ │ -00027740: 7665 2061 6e64 2061 7661 696c 6162 6c65 ve and available │ │ │ │ │ -00027750: 2069 6e70 7574 2074 6572 6d69 6e61 6c73 input terminals │ │ │ │ │ -00027760: 2e0a 0a20 2020 2020 5769 7468 2027 2d2d ... With '-- │ │ │ │ │ -00027770: 6170 7065 6e64 272c 2061 6464 2074 6865 append', add the │ │ │ │ │ -00027780: 206e 616d 6564 2074 6572 6d69 6e61 6c73 named terminals │ │ │ │ │ -00027790: 2074 6f20 7468 6520 6c69 7374 206f 6620 to the list of │ │ │ │ │ -000277a0: 6163 7469 7665 0a20 2020 2020 696e 7075 active. inpu │ │ │ │ │ -000277b0: 7420 7465 726d 696e 616c 733b 2061 6e79 t terminals; any │ │ │ │ │ -000277c0: 206f 6620 7468 6573 6520 6d61 7920 6265 of these may be │ │ │ │ │ -000277d0: 2075 7365 6420 746f 2070 726f 7669 6465 used to provide │ │ │ │ │ -000277e0: 2069 6e70 7574 2074 6f20 4752 5542 2e0a input to GRUB.. │ │ │ │ │ -000277f0: 0a20 2020 2020 5769 7468 2027 2d2d 7265 . With '--re │ │ │ │ │ -00027800: 6d6f 7665 272c 2072 656d 6f76 6520 7468 move', remove th │ │ │ │ │ -00027810: 6520 6e61 6d65 6420 7465 726d 696e 616c e named terminal │ │ │ │ │ -00027820: 7320 6672 6f6d 2074 6865 2061 6374 6976 s from the activ │ │ │ │ │ -00027830: 6520 6c69 7374 2e0a 0a20 2020 2020 5769 e list... Wi │ │ │ │ │ -00027840: 7468 206e 6f20 6f70 7469 6f6e 7320 6275 th no options bu │ │ │ │ │ -00027850: 7420 6120 6c69 7374 206f 6620 7465 726d t a list of term │ │ │ │ │ -00027860: 696e 616c 206e 616d 6573 2c20 6d61 6b65 inal names, make │ │ │ │ │ -00027870: 206f 6e6c 7920 7468 6520 6c69 7374 6564 only the listed │ │ │ │ │ -00027880: 0a20 2020 2020 7465 726d 696e 616c 206e . terminal n │ │ │ │ │ -00027890: 616d 6573 2061 6374 6976 652e 0a0a 1f0a ames active..... │ │ │ │ │ -000278a0: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ -000278b0: 2020 4e6f 6465 3a20 7465 726d 696e 616c Node: terminal │ │ │ │ │ -000278c0: 5f6f 7574 7075 742c 2020 4e65 7874 3a20 _output, Next: │ │ │ │ │ -000278d0: 7465 726d 696e 666f 2c20 2050 7265 763a terminfo, Prev: │ │ │ │ │ -000278e0: 2074 6572 6d69 6e61 6c5f 696e 7075 742c terminal_input, │ │ │ │ │ -000278f0: 2020 5570 3a20 4765 6e65 7261 6c20 636f Up: General co │ │ │ │ │ -00027900: 6d6d 616e 6473 0a0a 3136 2e32 2e33 2074 mmands..16.2.3 t │ │ │ │ │ -00027910: 6572 6d69 6e61 6c5f 6f75 7470 7574 0a2d erminal_output.- │ │ │ │ │ +000271e0: 2044 6566 696e 6520 7465 726d 696e 616c Define terminal │ │ │ │ │ +000271f0: 2074 7970 650a 0a1f 0a46 696c 653a 2067 type....File: g │ │ │ │ │ +00027200: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ +00027210: 2073 6572 6961 6c2c 2020 4e65 7874 3a20 serial, Next: │ │ │ │ │ +00027220: 7465 726d 696e 616c 5f69 6e70 7574 2c20 terminal_input, │ │ │ │ │ +00027230: 2055 703a 2047 656e 6572 616c 2063 6f6d Up: General com │ │ │ │ │ +00027240: 6d61 6e64 730a 0a31 362e 322e 3120 7365 mands..16.2.1 se │ │ │ │ │ +00027250: 7269 616c 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d rial.----------- │ │ │ │ │ +00027260: 2d2d 0a0a 202d 2d20 436f 6d6d 616e 643a --.. -- Command: │ │ │ │ │ +00027270: 2073 6572 6961 6c20 5b2d 2d75 6e69 743d serial [--unit= │ │ │ │ │ +00027280: 756e 6974 5d20 5b2d 2d70 6f72 743d 706f unit] [--port=po │ │ │ │ │ +00027290: 7274 5d20 5b2d 2d73 7065 6564 3d73 7065 rt] [--speed=spe │ │ │ │ │ +000272a0: 6564 5d0a 2020 2020 2020 2020 2020 5b2d ed]. [- │ │ │ │ │ +000272b0: 2d77 6f72 643d 776f 7264 5d20 5b2d 2d70 -word=word] [--p │ │ │ │ │ +000272c0: 6172 6974 793d 7061 7269 7479 5d20 5b2d arity=parity] [- │ │ │ │ │ +000272d0: 2d73 746f 703d 7374 6f70 5d0a 2020 2020 -stop=stop]. │ │ │ │ │ +000272e0: 2049 6e69 7469 616c 697a 6520 6120 7365 Initialize a se │ │ │ │ │ +000272f0: 7269 616c 2064 6576 6963 652e 2020 554e rial device. UN │ │ │ │ │ +00027300: 4954 2069 7320 6120 6e75 6d62 6572 2069 IT is a number i │ │ │ │ │ +00027310: 6e20 7468 6520 7261 6e67 6520 302d 330a n the range 0-3. │ │ │ │ │ +00027320: 2020 2020 2073 7065 6369 6679 696e 6720 specifying │ │ │ │ │ +00027330: 7768 6963 6820 7365 7269 616c 2070 6f72 which serial por │ │ │ │ │ +00027340: 7420 746f 2075 7365 3b20 6465 6661 756c t to use; defaul │ │ │ │ │ +00027350: 7420 6973 2030 2c20 7768 6963 680a 2020 t is 0, which. │ │ │ │ │ +00027360: 2020 2063 6f72 7265 7370 6f6e 6473 2074 corresponds t │ │ │ │ │ +00027370: 6f20 7468 6520 706f 7274 206f 6674 656e o the port often │ │ │ │ │ +00027380: 2063 616c 6c65 6420 434f 4d31 2e20 2050 called COM1. P │ │ │ │ │ +00027390: 4f52 5420 6973 2074 6865 2049 2f4f 2070 ORT is the I/O p │ │ │ │ │ +000273a0: 6f72 740a 2020 2020 2077 6865 7265 2074 ort. where t │ │ │ │ │ +000273b0: 6865 2055 4152 5420 6973 2074 6f20 6265 he UART is to be │ │ │ │ │ +000273c0: 2066 6f75 6e64 3b20 6966 2073 7065 6369 found; if speci │ │ │ │ │ +000273d0: 6669 6564 2069 7420 7461 6b65 7320 7072 fied it takes pr │ │ │ │ │ +000273e0: 6563 6564 656e 6365 0a20 2020 2020 6f76 ecedence. ov │ │ │ │ │ +000273f0: 6572 2055 4e49 542e 2020 5350 4545 4420 er UNIT. SPEED │ │ │ │ │ +00027400: 6973 2074 6865 2074 7261 6e73 6d69 7373 is the transmiss │ │ │ │ │ +00027410: 696f 6e20 7370 6565 643b 2064 6566 6175 ion speed; defau │ │ │ │ │ +00027420: 6c74 2069 7320 3936 3030 2e20 2057 4f52 lt is 9600. WOR │ │ │ │ │ +00027430: 440a 2020 2020 2061 6e64 2053 544f 5020 D. and STOP │ │ │ │ │ +00027440: 6172 6520 7468 6520 6e75 6d62 6572 206f are the number o │ │ │ │ │ +00027450: 6620 6461 7461 2062 6974 7320 616e 6420 f data bits and │ │ │ │ │ +00027460: 7374 6f70 2062 6974 732e 2020 4461 7461 stop bits. Data │ │ │ │ │ +00027470: 2062 6974 7320 6d75 7374 0a20 2020 2020 bits must. │ │ │ │ │ +00027480: 6265 2069 6e20 7468 6520 7261 6e67 6520 be in the range │ │ │ │ │ +00027490: 352d 3820 616e 6420 7374 6f70 2062 6974 5-8 and stop bit │ │ │ │ │ +000274a0: 7320 6d75 7374 2062 6520 3120 6f72 2032 s must be 1 or 2 │ │ │ │ │ +000274b0: 2e20 2044 6566 6175 6c74 2069 7320 380a . Default is 8. │ │ │ │ │ +000274c0: 2020 2020 2064 6174 6120 6269 7473 2061 data bits a │ │ │ │ │ +000274d0: 6e64 206f 6e65 2073 746f 7020 6269 742e nd one stop bit. │ │ │ │ │ +000274e0: 2020 5041 5249 5459 2069 7320 6f6e 6520 PARITY is one │ │ │ │ │ +000274f0: 6f66 2027 6e6f 272c 2027 6f64 6427 2c20 of 'no', 'odd', │ │ │ │ │ +00027500: 2765 7665 6e27 0a20 2020 2020 616e 6420 'even'. and │ │ │ │ │ +00027510: 6465 6661 756c 7473 2074 6f20 276e 6f27 defaults to 'no' │ │ │ │ │ +00027520: 2e0a 0a20 2020 2020 5468 6520 7365 7269 ... The seri │ │ │ │ │ +00027530: 616c 2070 6f72 7420 6973 206e 6f74 2075 al port is not u │ │ │ │ │ +00027540: 7365 6420 6173 2061 2063 6f6d 6d75 6e69 sed as a communi │ │ │ │ │ +00027550: 6361 7469 6f6e 2063 6861 6e6e 656c 2075 cation channel u │ │ │ │ │ +00027560: 6e6c 6573 7320 7468 650a 2020 2020 2027 nless the. ' │ │ │ │ │ +00027570: 7465 726d 696e 616c 5f69 6e70 7574 2720 terminal_input' │ │ │ │ │ +00027580: 6f72 2027 7465 726d 696e 616c 5f6f 7574 or 'terminal_out │ │ │ │ │ +00027590: 7075 7427 2063 6f6d 6d61 6e64 2069 7320 put' command is │ │ │ │ │ +000275a0: 7573 6564 2028 2a6e 6f74 650a 2020 2020 used (*note. │ │ │ │ │ +000275b0: 2074 6572 6d69 6e61 6c5f 696e 7075 743a terminal_input: │ │ │ │ │ +000275c0: 3a2c 202a 6e6f 7465 2074 6572 6d69 6e61 :, *note termina │ │ │ │ │ +000275d0: 6c5f 6f75 7470 7574 3a3a 292e 0a0a 2020 l_output::)... │ │ │ │ │ +000275e0: 2020 2053 6565 2061 6c73 6f20 2a6e 6f74 See also *not │ │ │ │ │ +000275f0: 6520 5365 7269 616c 2074 6572 6d69 6e61 e Serial termina │ │ │ │ │ +00027600: 6c3a 3a2e 0a0a 1f0a 4669 6c65 3a20 6772 l::.....File: gr │ │ │ │ │ +00027610: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ +00027620: 7465 726d 696e 616c 5f69 6e70 7574 2c20 terminal_input, │ │ │ │ │ +00027630: 204e 6578 743a 2074 6572 6d69 6e61 6c5f Next: terminal_ │ │ │ │ │ +00027640: 6f75 7470 7574 2c20 2050 7265 763a 2073 output, Prev: s │ │ │ │ │ +00027650: 6572 6961 6c2c 2020 5570 3a20 4765 6e65 erial, Up: Gene │ │ │ │ │ +00027660: 7261 6c20 636f 6d6d 616e 6473 0a0a 3136 ral commands..16 │ │ │ │ │ +00027670: 2e32 2e32 2074 6572 6d69 6e61 6c5f 696e .2.2 terminal_in │ │ │ │ │ +00027680: 7075 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d put.------------ │ │ │ │ │ +00027690: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 ---------.. -- C │ │ │ │ │ +000276a0: 6f6d 6d61 6e64 3a20 7465 726d 696e 616c ommand: terminal │ │ │ │ │ +000276b0: 5f69 6e70 7574 205b 2d2d 6170 7065 6e64 _input [--append │ │ │ │ │ +000276c0: 7c2d 2d72 656d 6f76 655d 205b 7465 726d |--remove] [term │ │ │ │ │ +000276d0: 696e 616c 315d 205b 7465 726d 696e 616c inal1] [terminal │ │ │ │ │ +000276e0: 325d 0a20 2020 2020 2020 2020 202e 2e2e 2]. ... │ │ │ │ │ +000276f0: 0a20 2020 2020 4c69 7374 206f 7220 7365 . List or se │ │ │ │ │ +00027700: 6c65 6374 2061 6e20 696e 7075 7420 7465 lect an input te │ │ │ │ │ +00027710: 726d 696e 616c 2e0a 0a20 2020 2020 5769 rminal... Wi │ │ │ │ │ +00027720: 7468 206e 6f20 6172 6775 6d65 6e74 732c th no arguments, │ │ │ │ │ +00027730: 206c 6973 7420 7468 6520 6163 7469 7665 list the active │ │ │ │ │ +00027740: 2061 6e64 2061 7661 696c 6162 6c65 2069 and available i │ │ │ │ │ +00027750: 6e70 7574 2074 6572 6d69 6e61 6c73 2e0a nput terminals.. │ │ │ │ │ +00027760: 0a20 2020 2020 5769 7468 2027 2d2d 6170 . With '--ap │ │ │ │ │ +00027770: 7065 6e64 272c 2061 6464 2074 6865 206e pend', add the n │ │ │ │ │ +00027780: 616d 6564 2074 6572 6d69 6e61 6c73 2074 amed terminals t │ │ │ │ │ +00027790: 6f20 7468 6520 6c69 7374 206f 6620 6163 o the list of ac │ │ │ │ │ +000277a0: 7469 7665 0a20 2020 2020 696e 7075 7420 tive. input │ │ │ │ │ +000277b0: 7465 726d 696e 616c 733b 2061 6e79 206f terminals; any o │ │ │ │ │ +000277c0: 6620 7468 6573 6520 6d61 7920 6265 2075 f these may be u │ │ │ │ │ +000277d0: 7365 6420 746f 2070 726f 7669 6465 2069 sed to provide i │ │ │ │ │ +000277e0: 6e70 7574 2074 6f20 4752 5542 2e0a 0a20 nput to GRUB... │ │ │ │ │ +000277f0: 2020 2020 5769 7468 2027 2d2d 7265 6d6f With '--remo │ │ │ │ │ +00027800: 7665 272c 2072 656d 6f76 6520 7468 6520 ve', remove the │ │ │ │ │ +00027810: 6e61 6d65 6420 7465 726d 696e 616c 7320 named terminals │ │ │ │ │ +00027820: 6672 6f6d 2074 6865 2061 6374 6976 6520 from the active │ │ │ │ │ +00027830: 6c69 7374 2e0a 0a20 2020 2020 5769 7468 list... With │ │ │ │ │ +00027840: 206e 6f20 6f70 7469 6f6e 7320 6275 7420 no options but │ │ │ │ │ +00027850: 6120 6c69 7374 206f 6620 7465 726d 696e a list of termin │ │ │ │ │ +00027860: 616c 206e 616d 6573 2c20 6d61 6b65 206f al names, make o │ │ │ │ │ +00027870: 6e6c 7920 7468 6520 6c69 7374 6564 0a20 nly the listed. │ │ │ │ │ +00027880: 2020 2020 7465 726d 696e 616c 206e 616d terminal nam │ │ │ │ │ +00027890: 6573 2061 6374 6976 652e 0a0a 1f0a 4669 es active.....Fi │ │ │ │ │ +000278a0: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ +000278b0: 4e6f 6465 3a20 7465 726d 696e 616c 5f6f Node: terminal_o │ │ │ │ │ +000278c0: 7574 7075 742c 2020 4e65 7874 3a20 7465 utput, Next: te │ │ │ │ │ +000278d0: 726d 696e 666f 2c20 2050 7265 763a 2074 rminfo, Prev: t │ │ │ │ │ +000278e0: 6572 6d69 6e61 6c5f 696e 7075 742c 2020 erminal_input, │ │ │ │ │ +000278f0: 5570 3a20 4765 6e65 7261 6c20 636f 6d6d Up: General comm │ │ │ │ │ +00027900: 616e 6473 0a0a 3136 2e32 2e33 2074 6572 ands..16.2.3 ter │ │ │ │ │ +00027910: 6d69 6e61 6c5f 6f75 7470 7574 0a2d 2d2d minal_output.--- │ │ │ │ │ 00027920: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00027930: 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 -----.. -- Comma │ │ │ │ │ -00027940: 6e64 3a20 7465 726d 696e 616c 5f6f 7574 nd: terminal_out │ │ │ │ │ -00027950: 7075 7420 5b2d 2d61 7070 656e 647c 2d2d put [--append|-- │ │ │ │ │ -00027960: 7265 6d6f 7665 5d20 5b74 6572 6d69 6e61 remove] [termina │ │ │ │ │ -00027970: 6c31 5d20 5b74 6572 6d69 6e61 6c32 5d0a l1] [terminal2]. │ │ │ │ │ -00027980: 2020 2020 2020 2020 2020 2e2e 2e0a 2020 .... │ │ │ │ │ -00027990: 2020 204c 6973 7420 6f72 2073 656c 6563 List or selec │ │ │ │ │ -000279a0: 7420 616e 206f 7574 7075 7420 7465 726d t an output term │ │ │ │ │ -000279b0: 696e 616c 2e0a 0a20 2020 2020 5769 7468 inal... With │ │ │ │ │ -000279c0: 206e 6f20 6172 6775 6d65 6e74 732c 206c no arguments, l │ │ │ │ │ -000279d0: 6973 7420 7468 6520 6163 7469 7665 2061 ist the active a │ │ │ │ │ -000279e0: 6e64 2061 7661 696c 6162 6c65 206f 7574 nd available out │ │ │ │ │ -000279f0: 7075 7420 7465 726d 696e 616c 732e 0a0a put terminals... │ │ │ │ │ -00027a00: 2020 2020 2057 6974 6820 272d 2d61 7070 With '--app │ │ │ │ │ -00027a10: 656e 6427 2c20 6164 6420 7468 6520 6e61 end', add the na │ │ │ │ │ -00027a20: 6d65 6420 7465 726d 696e 616c 7320 746f med terminals to │ │ │ │ │ -00027a30: 2074 6865 206c 6973 7420 6f66 2061 6374 the list of act │ │ │ │ │ -00027a40: 6976 650a 2020 2020 206f 7574 7075 7420 ive. output │ │ │ │ │ -00027a50: 7465 726d 696e 616c 733b 2061 6c6c 206f terminals; all o │ │ │ │ │ -00027a60: 6620 7468 6573 6520 7769 6c6c 2072 6563 f these will rec │ │ │ │ │ -00027a70: 6569 7665 206f 7574 7075 7420 6672 6f6d eive output from │ │ │ │ │ -00027a80: 2047 5255 422e 0a0a 2020 2020 2057 6974 GRUB... Wit │ │ │ │ │ -00027a90: 6820 272d 2d72 656d 6f76 6527 2c20 7265 h '--remove', re │ │ │ │ │ -00027aa0: 6d6f 7665 2074 6865 206e 616d 6564 2074 move the named t │ │ │ │ │ -00027ab0: 6572 6d69 6e61 6c73 2066 726f 6d20 7468 erminals from th │ │ │ │ │ -00027ac0: 6520 6163 7469 7665 206c 6973 742e 0a0a e active list... │ │ │ │ │ -00027ad0: 2020 2020 2057 6974 6820 6e6f 206f 7074 With no opt │ │ │ │ │ -00027ae0: 696f 6e73 2062 7574 2061 206c 6973 7420 ions but a list │ │ │ │ │ -00027af0: 6f66 2074 6572 6d69 6e61 6c20 6e61 6d65 of terminal name │ │ │ │ │ -00027b00: 732c 206d 616b 6520 6f6e 6c79 2074 6865 s, make only the │ │ │ │ │ -00027b10: 206c 6973 7465 640a 2020 2020 2074 6572 listed. ter │ │ │ │ │ -00027b20: 6d69 6e61 6c20 6e61 6d65 7320 6163 7469 minal names acti │ │ │ │ │ -00027b30: 7665 2e0a 0a1f 0a46 696c 653a 2067 7275 ve.....File: gru │ │ │ │ │ -00027b40: 622e 696e 666f 2c20 204e 6f64 653a 2074 b.info, Node: t │ │ │ │ │ -00027b50: 6572 6d69 6e66 6f2c 2020 5072 6576 3a20 erminfo, Prev: │ │ │ │ │ -00027b60: 7465 726d 696e 616c 5f6f 7574 7075 742c terminal_output, │ │ │ │ │ -00027b70: 2020 5570 3a20 4765 6e65 7261 6c20 636f Up: General co │ │ │ │ │ -00027b80: 6d6d 616e 6473 0a0a 3136 2e32 2e34 2074 mmands..16.2.4 t │ │ │ │ │ -00027b90: 6572 6d69 6e66 6f0a 2d2d 2d2d 2d2d 2d2d erminfo.-------- │ │ │ │ │ -00027ba0: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d -------.. -- Com │ │ │ │ │ -00027bb0: 6d61 6e64 3a20 7465 726d 696e 666f 205b mand: terminfo [ │ │ │ │ │ -00027bc0: 2d61 7c2d 757c 2d76 5d20 5b2d 6720 5778 -a|-u|-v] [-g Wx │ │ │ │ │ -00027bd0: 485d 205b 7465 726d 5d20 5b74 7970 655d H] [term] [type] │ │ │ │ │ -00027be0: 0a20 2020 2020 4465 6669 6e65 2074 6865 . Define the │ │ │ │ │ -00027bf0: 2063 6170 6162 696c 6974 6965 7320 6f66 capabilities of │ │ │ │ │ -00027c00: 2079 6f75 7220 7465 726d 696e 616c 2062 your terminal b │ │ │ │ │ -00027c10: 7920 6769 7669 6e67 2074 6865 206e 616d y giving the nam │ │ │ │ │ -00027c20: 6520 6f66 2061 6e0a 2020 2020 2065 6e74 e of an. ent │ │ │ │ │ -00027c30: 7279 2069 6e20 7468 6520 7465 726d 696e ry in the termin │ │ │ │ │ -00027c40: 666f 2064 6174 6162 6173 652c 2077 6869 fo database, whi │ │ │ │ │ -00027c50: 6368 2073 686f 756c 6420 636f 7272 6573 ch should corres │ │ │ │ │ -00027c60: 706f 6e64 2072 6f75 6768 6c79 2074 6f0a pond roughly to. │ │ │ │ │ -00027c70: 2020 2020 2061 2027 5445 524d 2720 656e a 'TERM' en │ │ │ │ │ -00027c80: 7669 726f 6e6d 656e 7420 7661 7269 6162 vironment variab │ │ │ │ │ -00027c90: 6c65 2069 6e20 556e 6978 2e0a 0a20 2020 le in Unix... │ │ │ │ │ -00027ca0: 2020 5468 6520 6375 7272 656e 746c 7920 The currently │ │ │ │ │ -00027cb0: 6176 6169 6c61 626c 6520 7465 726d 696e available termin │ │ │ │ │ -00027cc0: 616c 2074 7970 6573 2061 7265 2027 7674 al types are 'vt │ │ │ │ │ -00027cd0: 3130 3027 2c20 2776 7431 3030 2d63 6f6c 100', 'vt100-col │ │ │ │ │ -00027ce0: 6f72 272c 0a20 2020 2020 2769 6565 6531 or',. 'ieee1 │ │ │ │ │ -00027cf0: 3237 3527 2c20 616e 6420 2764 756d 6227 275', and 'dumb' │ │ │ │ │ -00027d00: 2e20 2049 6620 796f 7520 6e65 6564 206f . If you need o │ │ │ │ │ -00027d10: 7468 6572 2074 6572 6d69 6e61 6c20 7479 ther terminal ty │ │ │ │ │ -00027d20: 7065 732c 2070 6c65 6173 650a 2020 2020 pes, please. │ │ │ │ │ -00027d30: 2063 6f6e 7461 6374 2075 7320 746f 2064 contact us to d │ │ │ │ │ -00027d40: 6973 6375 7373 2074 6865 2062 6573 7420 iscuss the best │ │ │ │ │ -00027d50: 7761 7920 746f 2069 6e63 6c75 6465 2073 way to include s │ │ │ │ │ -00027d60: 7570 706f 7274 2066 6f72 2074 6865 7365 upport for these │ │ │ │ │ -00027d70: 2069 6e0a 2020 2020 2047 5255 422e 0a0a in. GRUB... │ │ │ │ │ -00027d80: 2020 2020 2054 6865 2027 2d61 2720 2827 The '-a' (' │ │ │ │ │ -00027d90: 2d2d 6173 6369 6927 292c 2027 2d75 2720 --ascii'), '-u' │ │ │ │ │ -00027da0: 2827 2d2d 7574 6638 2729 2c20 616e 6420 ('--utf8'), and │ │ │ │ │ -00027db0: 272d 7627 2028 272d 2d76 6973 7561 6c2d '-v' ('--visual- │ │ │ │ │ -00027dc0: 7574 6638 2729 0a20 2020 2020 6f70 7469 utf8'). opti │ │ │ │ │ -00027dd0: 6f6e 7320 636f 6e74 726f 6c20 686f 7720 ons control how │ │ │ │ │ -00027de0: 6e6f 6e2d 4153 4349 4920 7465 7874 2069 non-ASCII text i │ │ │ │ │ -00027df0: 7320 6469 7370 6c61 7965 642e 2020 272d s displayed. '- │ │ │ │ │ -00027e00: 6127 2073 7065 6369 6669 6573 2061 6e0a a' specifies an. │ │ │ │ │ -00027e10: 2020 2020 2041 5343 4949 2d6f 6e6c 7920 ASCII-only │ │ │ │ │ -00027e20: 7465 726d 696e 616c 3b20 272d 7527 2073 terminal; '-u' s │ │ │ │ │ -00027e30: 7065 6369 6669 6573 206c 6f67 6963 616c pecifies logical │ │ │ │ │ -00027e40: 6c79 2d6f 7264 6572 6564 2055 5446 2d38 ly-ordered UTF-8 │ │ │ │ │ -00027e50: 3b20 616e 640a 2020 2020 2027 2d76 2720 ; and. '-v' │ │ │ │ │ -00027e60: 7370 6563 6966 6965 7320 2276 6973 7561 specifies "visua │ │ │ │ │ -00027e70: 6c6c 792d 6f72 6465 7265 6420 5554 462d lly-ordered UTF- │ │ │ │ │ -00027e80: 3822 2028 696e 206f 7468 6572 2077 6f72 8" (in other wor │ │ │ │ │ -00027e90: 6473 2c20 6172 7261 6e67 6564 0a20 2020 ds, arranged. │ │ │ │ │ -00027ea0: 2020 7375 6368 2074 6861 7420 6120 7465 such that a te │ │ │ │ │ -00027eb0: 726d 696e 616c 2065 6d75 6c61 746f 7220 rminal emulator │ │ │ │ │ -00027ec0: 7769 7468 6f75 7420 6269 6469 7265 6374 without bidirect │ │ │ │ │ -00027ed0: 696f 6e61 6c20 7465 7874 2073 7570 706f ional text suppo │ │ │ │ │ -00027ee0: 7274 0a20 2020 2020 7769 6c6c 2064 6973 rt. will dis │ │ │ │ │ -00027ef0: 706c 6179 2072 6967 6874 2d74 6f2d 6c65 play right-to-le │ │ │ │ │ -00027f00: 6674 2074 6578 7420 696e 2074 6865 2070 ft text in the p │ │ │ │ │ -00027f10: 726f 7065 7220 6f72 6465 723b 2074 6869 roper order; thi │ │ │ │ │ -00027f20: 7320 6973 206e 6f74 0a20 2020 2020 7265 s is not. re │ │ │ │ │ -00027f30: 616c 6c79 2070 726f 7065 7220 5554 462d ally proper UTF- │ │ │ │ │ -00027f40: 382c 2062 7574 2061 2077 6f72 6b61 726f 8, but a workaro │ │ │ │ │ -00027f50: 756e 6429 2e0a 0a20 2020 2020 5468 6520 und)... The │ │ │ │ │ -00027f60: 272d 6727 2028 272d 2d67 656f 6d65 7472 '-g' ('--geometr │ │ │ │ │ -00027f70: 7927 2920 6361 6e20 6265 2075 7365 6420 y') can be used │ │ │ │ │ -00027f80: 746f 2073 7065 6369 6679 2074 6572 6d69 to specify termi │ │ │ │ │ -00027f90: 6e61 6c20 6765 6f6d 6574 7279 2e0a 0a20 nal geometry... │ │ │ │ │ -00027fa0: 2020 2020 4966 206e 6f20 6f70 7469 6f6e If no option │ │ │ │ │ -00027fb0: 206f 7220 7465 726d 696e 616c 2074 7970 or terminal typ │ │ │ │ │ -00027fc0: 6520 6973 2073 7065 6369 6669 6564 2c20 e is specified, │ │ │ │ │ -00027fd0: 7468 6520 6375 7272 656e 7420 7465 726d the current term │ │ │ │ │ -00027fe0: 696e 616c 0a20 2020 2020 7479 7065 2069 inal. type i │ │ │ │ │ -00027ff0: 7320 7072 696e 7465 642e 0a0a 1f0a 4669 s printed.....Fi │ │ │ │ │ -00028000: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ -00028010: 4e6f 6465 3a20 436f 6d6d 616e 642d 6c69 Node: Command-li │ │ │ │ │ -00028020: 6e65 2061 6e64 206d 656e 7520 656e 7472 ne and menu entr │ │ │ │ │ -00028030: 7920 636f 6d6d 616e 6473 2c20 204e 6578 y commands, Nex │ │ │ │ │ -00028040: 743a 204e 6574 776f 726b 696e 6720 636f t: Networking co │ │ │ │ │ -00028050: 6d6d 616e 6473 2c20 2050 7265 763a 2047 mmands, Prev: G │ │ │ │ │ -00028060: 656e 6572 616c 2063 6f6d 6d61 6e64 732c eneral commands, │ │ │ │ │ -00028070: 2020 5570 3a20 436f 6d6d 616e 6473 0a0a Up: Commands.. │ │ │ │ │ -00028080: 3136 2e33 2054 6865 206c 6973 7420 6f66 16.3 The list of │ │ │ │ │ -00028090: 2063 6f6d 6d61 6e64 2d6c 696e 6520 616e command-line an │ │ │ │ │ -000280a0: 6420 6d65 6e75 2065 6e74 7279 2063 6f6d d menu entry com │ │ │ │ │ -000280b0: 6d61 6e64 730a 3d3d 3d3d 3d3d 3d3d 3d3d mands.========== │ │ │ │ │ +00027930: 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 ---.. -- Command │ │ │ │ │ +00027940: 3a20 7465 726d 696e 616c 5f6f 7574 7075 : terminal_outpu │ │ │ │ │ +00027950: 7420 5b2d 2d61 7070 656e 647c 2d2d 7265 t [--append|--re │ │ │ │ │ +00027960: 6d6f 7665 5d20 5b74 6572 6d69 6e61 6c31 move] [terminal1 │ │ │ │ │ +00027970: 5d20 5b74 6572 6d69 6e61 6c32 5d0a 2020 ] [terminal2]. │ │ │ │ │ +00027980: 2020 2020 2020 2020 2e2e 2e0a 2020 2020 .... │ │ │ │ │ +00027990: 204c 6973 7420 6f72 2073 656c 6563 7420 List or select │ │ │ │ │ +000279a0: 616e 206f 7574 7075 7420 7465 726d 696e an output termin │ │ │ │ │ +000279b0: 616c 2e0a 0a20 2020 2020 5769 7468 206e al... With n │ │ │ │ │ +000279c0: 6f20 6172 6775 6d65 6e74 732c 206c 6973 o arguments, lis │ │ │ │ │ +000279d0: 7420 7468 6520 6163 7469 7665 2061 6e64 t the active and │ │ │ │ │ +000279e0: 2061 7661 696c 6162 6c65 206f 7574 7075 available outpu │ │ │ │ │ +000279f0: 7420 7465 726d 696e 616c 732e 0a0a 2020 t terminals... │ │ │ │ │ +00027a00: 2020 2057 6974 6820 272d 2d61 7070 656e With '--appen │ │ │ │ │ +00027a10: 6427 2c20 6164 6420 7468 6520 6e61 6d65 d', add the name │ │ │ │ │ +00027a20: 6420 7465 726d 696e 616c 7320 746f 2074 d terminals to t │ │ │ │ │ +00027a30: 6865 206c 6973 7420 6f66 2061 6374 6976 he list of activ │ │ │ │ │ +00027a40: 650a 2020 2020 206f 7574 7075 7420 7465 e. output te │ │ │ │ │ +00027a50: 726d 696e 616c 733b 2061 6c6c 206f 6620 rminals; all of │ │ │ │ │ +00027a60: 7468 6573 6520 7769 6c6c 2072 6563 6569 these will recei │ │ │ │ │ +00027a70: 7665 206f 7574 7075 7420 6672 6f6d 2047 ve output from G │ │ │ │ │ +00027a80: 5255 422e 0a0a 2020 2020 2057 6974 6820 RUB... With │ │ │ │ │ +00027a90: 272d 2d72 656d 6f76 6527 2c20 7265 6d6f '--remove', remo │ │ │ │ │ +00027aa0: 7665 2074 6865 206e 616d 6564 2074 6572 ve the named ter │ │ │ │ │ +00027ab0: 6d69 6e61 6c73 2066 726f 6d20 7468 6520 minals from the │ │ │ │ │ +00027ac0: 6163 7469 7665 206c 6973 742e 0a0a 2020 active list... │ │ │ │ │ +00027ad0: 2020 2057 6974 6820 6e6f 206f 7074 696f With no optio │ │ │ │ │ +00027ae0: 6e73 2062 7574 2061 206c 6973 7420 6f66 ns but a list of │ │ │ │ │ +00027af0: 2074 6572 6d69 6e61 6c20 6e61 6d65 732c terminal names, │ │ │ │ │ +00027b00: 206d 616b 6520 6f6e 6c79 2074 6865 206c make only the l │ │ │ │ │ +00027b10: 6973 7465 640a 2020 2020 2074 6572 6d69 isted. termi │ │ │ │ │ +00027b20: 6e61 6c20 6e61 6d65 7320 6163 7469 7665 nal names active │ │ │ │ │ +00027b30: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ +00027b40: 696e 666f 2c20 204e 6f64 653a 2074 6572 info, Node: ter │ │ │ │ │ +00027b50: 6d69 6e66 6f2c 2020 5072 6576 3a20 7465 minfo, Prev: te │ │ │ │ │ +00027b60: 726d 696e 616c 5f6f 7574 7075 742c 2020 rminal_output, │ │ │ │ │ +00027b70: 5570 3a20 4765 6e65 7261 6c20 636f 6d6d Up: General comm │ │ │ │ │ +00027b80: 616e 6473 0a0a 3136 2e32 2e34 2074 6572 ands..16.2.4 ter │ │ │ │ │ +00027b90: 6d69 6e66 6f0a 2d2d 2d2d 2d2d 2d2d 2d2d minfo.---------- │ │ │ │ │ +00027ba0: 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 -----.. -- Comma │ │ │ │ │ +00027bb0: 6e64 3a20 7465 726d 696e 666f 205b 2d61 nd: terminfo [-a │ │ │ │ │ +00027bc0: 7c2d 757c 2d76 5d20 5b2d 6720 5778 485d |-u|-v] [-g WxH] │ │ │ │ │ +00027bd0: 205b 7465 726d 5d20 5b74 7970 655d 0a20 [term] [type]. │ │ │ │ │ +00027be0: 2020 2020 4465 6669 6e65 2074 6865 2063 Define the c │ │ │ │ │ +00027bf0: 6170 6162 696c 6974 6965 7320 6f66 2079 apabilities of y │ │ │ │ │ +00027c00: 6f75 7220 7465 726d 696e 616c 2062 7920 our terminal by │ │ │ │ │ +00027c10: 6769 7669 6e67 2074 6865 206e 616d 6520 giving the name │ │ │ │ │ +00027c20: 6f66 2061 6e0a 2020 2020 2065 6e74 7279 of an. entry │ │ │ │ │ +00027c30: 2069 6e20 7468 6520 7465 726d 696e 666f in the terminfo │ │ │ │ │ +00027c40: 2064 6174 6162 6173 652c 2077 6869 6368 database, which │ │ │ │ │ +00027c50: 2073 686f 756c 6420 636f 7272 6573 706f should correspo │ │ │ │ │ +00027c60: 6e64 2072 6f75 6768 6c79 2074 6f0a 2020 nd roughly to. │ │ │ │ │ +00027c70: 2020 2061 2027 5445 524d 2720 656e 7669 a 'TERM' envi │ │ │ │ │ +00027c80: 726f 6e6d 656e 7420 7661 7269 6162 6c65 ronment variable │ │ │ │ │ +00027c90: 2069 6e20 556e 6978 2e0a 0a20 2020 2020 in Unix... │ │ │ │ │ +00027ca0: 5468 6520 6375 7272 656e 746c 7920 6176 The currently av │ │ │ │ │ +00027cb0: 6169 6c61 626c 6520 7465 726d 696e 616c ailable terminal │ │ │ │ │ +00027cc0: 2074 7970 6573 2061 7265 2027 7674 3130 types are 'vt10 │ │ │ │ │ +00027cd0: 3027 2c20 2776 7431 3030 2d63 6f6c 6f72 0', 'vt100-color │ │ │ │ │ +00027ce0: 272c 0a20 2020 2020 2769 6565 6531 3237 ',. 'ieee127 │ │ │ │ │ +00027cf0: 3527 2c20 616e 6420 2764 756d 6227 2e20 5', and 'dumb'. │ │ │ │ │ +00027d00: 2049 6620 796f 7520 6e65 6564 206f 7468 If you need oth │ │ │ │ │ +00027d10: 6572 2074 6572 6d69 6e61 6c20 7479 7065 er terminal type │ │ │ │ │ +00027d20: 732c 2070 6c65 6173 650a 2020 2020 2063 s, please. c │ │ │ │ │ +00027d30: 6f6e 7461 6374 2075 7320 746f 2064 6973 ontact us to dis │ │ │ │ │ +00027d40: 6375 7373 2074 6865 2062 6573 7420 7761 cuss the best wa │ │ │ │ │ +00027d50: 7920 746f 2069 6e63 6c75 6465 2073 7570 y to include sup │ │ │ │ │ +00027d60: 706f 7274 2066 6f72 2074 6865 7365 2069 port for these i │ │ │ │ │ +00027d70: 6e0a 2020 2020 2047 5255 422e 0a0a 2020 n. GRUB... │ │ │ │ │ +00027d80: 2020 2054 6865 2027 2d61 2720 2827 2d2d The '-a' ('-- │ │ │ │ │ +00027d90: 6173 6369 6927 292c 2027 2d75 2720 2827 ascii'), '-u' (' │ │ │ │ │ +00027da0: 2d2d 7574 6638 2729 2c20 616e 6420 272d --utf8'), and '- │ │ │ │ │ +00027db0: 7627 2028 272d 2d76 6973 7561 6c2d 7574 v' ('--visual-ut │ │ │ │ │ +00027dc0: 6638 2729 0a20 2020 2020 6f70 7469 6f6e f8'). option │ │ │ │ │ +00027dd0: 7320 636f 6e74 726f 6c20 686f 7720 6e6f s control how no │ │ │ │ │ +00027de0: 6e2d 4153 4349 4920 7465 7874 2069 7320 n-ASCII text is │ │ │ │ │ +00027df0: 6469 7370 6c61 7965 642e 2020 272d 6127 displayed. '-a' │ │ │ │ │ +00027e00: 2073 7065 6369 6669 6573 2061 6e0a 2020 specifies an. │ │ │ │ │ +00027e10: 2020 2041 5343 4949 2d6f 6e6c 7920 7465 ASCII-only te │ │ │ │ │ +00027e20: 726d 696e 616c 3b20 272d 7527 2073 7065 rminal; '-u' spe │ │ │ │ │ +00027e30: 6369 6669 6573 206c 6f67 6963 616c 6c79 cifies logically │ │ │ │ │ +00027e40: 2d6f 7264 6572 6564 2055 5446 2d38 3b20 -ordered UTF-8; │ │ │ │ │ +00027e50: 616e 640a 2020 2020 2027 2d76 2720 7370 and. '-v' sp │ │ │ │ │ +00027e60: 6563 6966 6965 7320 2276 6973 7561 6c6c ecifies "visuall │ │ │ │ │ +00027e70: 792d 6f72 6465 7265 6420 5554 462d 3822 y-ordered UTF-8" │ │ │ │ │ +00027e80: 2028 696e 206f 7468 6572 2077 6f72 6473 (in other words │ │ │ │ │ +00027e90: 2c20 6172 7261 6e67 6564 0a20 2020 2020 , arranged. │ │ │ │ │ +00027ea0: 7375 6368 2074 6861 7420 6120 7465 726d such that a term │ │ │ │ │ +00027eb0: 696e 616c 2065 6d75 6c61 746f 7220 7769 inal emulator wi │ │ │ │ │ +00027ec0: 7468 6f75 7420 6269 6469 7265 6374 696f thout bidirectio │ │ │ │ │ +00027ed0: 6e61 6c20 7465 7874 2073 7570 706f 7274 nal text support │ │ │ │ │ +00027ee0: 0a20 2020 2020 7769 6c6c 2064 6973 706c . will displ │ │ │ │ │ +00027ef0: 6179 2072 6967 6874 2d74 6f2d 6c65 6674 ay right-to-left │ │ │ │ │ +00027f00: 2074 6578 7420 696e 2074 6865 2070 726f text in the pro │ │ │ │ │ +00027f10: 7065 7220 6f72 6465 723b 2074 6869 7320 per order; this │ │ │ │ │ +00027f20: 6973 206e 6f74 0a20 2020 2020 7265 616c is not. real │ │ │ │ │ +00027f30: 6c79 2070 726f 7065 7220 5554 462d 382c ly proper UTF-8, │ │ │ │ │ +00027f40: 2062 7574 2061 2077 6f72 6b61 726f 756e but a workaroun │ │ │ │ │ +00027f50: 6429 2e0a 0a20 2020 2020 5468 6520 272d d)... The '- │ │ │ │ │ +00027f60: 6727 2028 272d 2d67 656f 6d65 7472 7927 g' ('--geometry' │ │ │ │ │ +00027f70: 2920 6361 6e20 6265 2075 7365 6420 746f ) can be used to │ │ │ │ │ +00027f80: 2073 7065 6369 6679 2074 6572 6d69 6e61 specify termina │ │ │ │ │ +00027f90: 6c20 6765 6f6d 6574 7279 2e0a 0a20 2020 l geometry... │ │ │ │ │ +00027fa0: 2020 4966 206e 6f20 6f70 7469 6f6e 206f If no option o │ │ │ │ │ +00027fb0: 7220 7465 726d 696e 616c 2074 7970 6520 r terminal type │ │ │ │ │ +00027fc0: 6973 2073 7065 6369 6669 6564 2c20 7468 is specified, th │ │ │ │ │ +00027fd0: 6520 6375 7272 656e 7420 7465 726d 696e e current termin │ │ │ │ │ +00027fe0: 616c 0a20 2020 2020 7479 7065 2069 7320 al. type is │ │ │ │ │ +00027ff0: 7072 696e 7465 642e 0a0a 1f0a 4669 6c65 printed.....File │ │ │ │ │ +00028000: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ +00028010: 6465 3a20 436f 6d6d 616e 642d 6c69 6e65 de: Command-line │ │ │ │ │ +00028020: 2061 6e64 206d 656e 7520 656e 7472 7920 and menu entry │ │ │ │ │ +00028030: 636f 6d6d 616e 6473 2c20 204e 6578 743a commands, Next: │ │ │ │ │ +00028040: 204e 6574 776f 726b 696e 6720 636f 6d6d Networking comm │ │ │ │ │ +00028050: 616e 6473 2c20 2050 7265 763a 2047 656e ands, Prev: Gen │ │ │ │ │ +00028060: 6572 616c 2063 6f6d 6d61 6e64 732c 2020 eral commands, │ │ │ │ │ +00028070: 5570 3a20 436f 6d6d 616e 6473 0a0a 3136 Up: Commands..16 │ │ │ │ │ +00028080: 2e33 2054 6865 206c 6973 7420 6f66 2063 .3 The list of c │ │ │ │ │ +00028090: 6f6d 6d61 6e64 2d6c 696e 6520 616e 6420 ommand-line and │ │ │ │ │ +000280a0: 6d65 6e75 2065 6e74 7279 2063 6f6d 6d61 menu entry comma │ │ │ │ │ +000280b0: 6e64 730a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d nds.============ │ │ │ │ │ 000280c0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 000280d0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -000280e0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a54 6865 ===========..The │ │ │ │ │ -000280f0: 7365 2063 6f6d 6d61 6e64 7320 6172 6520 se commands are │ │ │ │ │ -00028100: 7573 6162 6c65 2069 6e20 7468 6520 636f usable in the co │ │ │ │ │ -00028110: 6d6d 616e 642d 6c69 6e65 2061 6e64 2069 mmand-line and i │ │ │ │ │ -00028120: 6e20 6d65 6e75 2065 6e74 7269 6573 2e20 n menu entries. │ │ │ │ │ -00028130: 2049 660a 796f 7520 666f 7267 6574 2061 If.you forget a │ │ │ │ │ -00028140: 2063 6f6d 6d61 6e64 2c20 796f 7520 6361 command, you ca │ │ │ │ │ -00028150: 6e20 7275 6e20 7468 6520 636f 6d6d 616e n run the comman │ │ │ │ │ -00028160: 6420 2768 656c 7027 2028 2a6e 6f74 6520 d 'help' (*note │ │ │ │ │ -00028170: 6865 6c70 3a3a 292e 0a0a 2a20 4d65 6e75 help::)...* Menu │ │ │ │ │ -00028180: 3a0a 0a2a 205b 3a3a 2020 2020 2020 2020 :..* [:: │ │ │ │ │ +000280e0: 3d3d 3d3d 3d3d 3d3d 3d0a 0a54 6865 7365 =========..These │ │ │ │ │ +000280f0: 2063 6f6d 6d61 6e64 7320 6172 6520 7573 commands are us │ │ │ │ │ +00028100: 6162 6c65 2069 6e20 7468 6520 636f 6d6d able in the comm │ │ │ │ │ +00028110: 616e 642d 6c69 6e65 2061 6e64 2069 6e20 and-line and in │ │ │ │ │ +00028120: 6d65 6e75 2065 6e74 7269 6573 2e20 2049 menu entries. I │ │ │ │ │ +00028130: 660a 796f 7520 666f 7267 6574 2061 2063 f.you forget a c │ │ │ │ │ +00028140: 6f6d 6d61 6e64 2c20 796f 7520 6361 6e20 ommand, you can │ │ │ │ │ +00028150: 7275 6e20 7468 6520 636f 6d6d 616e 6420 run the command │ │ │ │ │ +00028160: 2768 656c 7027 2028 2a6e 6f74 6520 6865 'help' (*note he │ │ │ │ │ +00028170: 6c70 3a3a 292e 0a0a 2a20 4d65 6e75 3a0a lp::)...* Menu:. │ │ │ │ │ +00028180: 0a2a 205b 3a3a 2020 2020 2020 2020 2020 .* [:: │ │ │ │ │ 00028190: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000281a0: 2020 2043 6865 636b 2066 696c 6520 7479 Check file ty │ │ │ │ │ -000281b0: 7065 7320 616e 6420 636f 6d70 6172 6520 pes and compare │ │ │ │ │ -000281c0: 7661 6c75 6573 0a2a 2061 6370 693a 3a20 values.* acpi:: │ │ │ │ │ +000281a0: 2043 6865 636b 2066 696c 6520 7479 7065 Check file type │ │ │ │ │ +000281b0: 7320 616e 6420 636f 6d70 6172 6520 7661 s and compare va │ │ │ │ │ +000281c0: 6c75 6573 0a2a 2061 6370 693a 3a20 2020 lues.* acpi:: │ │ │ │ │ 000281d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000281e0: 2020 2020 2020 204c 6f61 6420 4143 5049 Load ACPI │ │ │ │ │ -000281f0: 2074 6162 6c65 730a 2a20 6175 7468 656e tables.* authen │ │ │ │ │ -00028200: 7469 6361 7465 3a3a 2020 2020 2020 2020 ticate:: │ │ │ │ │ -00028210: 2020 2020 2020 2020 4368 6563 6b20 7768 Check wh │ │ │ │ │ -00028220: 6574 6865 7220 7573 6572 2069 7320 696e ether user is in │ │ │ │ │ -00028230: 2075 7365 7220 6c69 7374 0a2a 2062 6163 user list.* bac │ │ │ │ │ -00028240: 6b67 726f 756e 645f 636f 6c6f 723a 3a20 kground_color:: │ │ │ │ │ -00028250: 2020 2020 2020 2020 2020 2053 6574 2062 Set b │ │ │ │ │ -00028260: 6163 6b67 726f 756e 6420 636f 6c6f 7220 ackground color │ │ │ │ │ -00028270: 666f 7220 6163 7469 7665 2074 6572 6d69 for active termi │ │ │ │ │ -00028280: 6e61 6c0a 2a20 6261 636b 6772 6f75 6e64 nal.* background │ │ │ │ │ -00028290: 5f69 6d61 6765 3a3a 2020 2020 2020 2020 _image:: │ │ │ │ │ -000282a0: 2020 2020 4c6f 6164 2062 6163 6b67 726f Load backgro │ │ │ │ │ -000282b0: 756e 6420 696d 6167 6520 666f 7220 6163 und image for ac │ │ │ │ │ -000282c0: 7469 7665 2074 6572 6d69 6e61 6c0a 2a20 tive terminal.* │ │ │ │ │ -000282d0: 6261 6472 616d 3a3a 2020 2020 2020 2020 badram:: │ │ │ │ │ -000282e0: 2020 2020 2020 2020 2020 2020 2020 4669 Fi │ │ │ │ │ -000282f0: 6c74 6572 206f 7574 2062 6164 2072 6567 lter out bad reg │ │ │ │ │ -00028300: 696f 6e73 206f 6620 5241 4d0a 2a20 626c ions of RAM.* bl │ │ │ │ │ -00028310: 6f63 6b6c 6973 743a 3a20 2020 2020 2020 ocklist:: │ │ │ │ │ -00028320: 2020 2020 2020 2020 2020 2020 5072 696e Prin │ │ │ │ │ -00028330: 7420 6120 626c 6f63 6b20 6c69 7374 0a2a t a block list.* │ │ │ │ │ -00028340: 2062 6f6f 743a 3a20 2020 2020 2020 2020 boot:: │ │ │ │ │ -00028350: 2020 2020 2020 2020 2020 2020 2020 2053 S │ │ │ │ │ -00028360: 7461 7274 2075 7020 796f 7572 206f 7065 tart up your ope │ │ │ │ │ -00028370: 7261 7469 6e67 2073 7973 7465 6d0a 2a20 rating system.* │ │ │ │ │ -00028380: 6361 743a 3a20 2020 2020 2020 2020 2020 cat:: │ │ │ │ │ -00028390: 2020 2020 2020 2020 2020 2020 2020 5368 Sh │ │ │ │ │ -000283a0: 6f77 2074 6865 2063 6f6e 7465 6e74 7320 ow the contents │ │ │ │ │ -000283b0: 6f66 2061 2066 696c 650a 2a20 6368 6169 of a file.* chai │ │ │ │ │ -000283c0: 6e6c 6f61 6465 723a 3a20 2020 2020 2020 nloader:: │ │ │ │ │ -000283d0: 2020 2020 2020 2020 2020 4368 6169 6e2d Chain- │ │ │ │ │ -000283e0: 6c6f 6164 2061 6e6f 7468 6572 2062 6f6f load another boo │ │ │ │ │ -000283f0: 7420 6c6f 6164 6572 0a2a 2063 6c65 6172 t loader.* clear │ │ │ │ │ -00028400: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ │ -00028410: 2020 2020 2020 2020 2043 6c65 6172 2074 Clear t │ │ │ │ │ -00028420: 6865 2073 6372 6565 6e0a 2a20 636d 6f73 he screen.* cmos │ │ │ │ │ -00028430: 636c 6561 6e3a 3a20 2020 2020 2020 2020 clean:: │ │ │ │ │ -00028440: 2020 2020 2020 2020 2020 436c 6561 7220 Clear │ │ │ │ │ -00028450: 6269 7420 696e 2043 4d4f 530a 2a20 636d bit in CMOS.* cm │ │ │ │ │ -00028460: 6f73 6475 6d70 3a3a 2020 2020 2020 2020 osdump:: │ │ │ │ │ -00028470: 2020 2020 2020 2020 2020 2020 4475 6d70 Dump │ │ │ │ │ -00028480: 2043 4d4f 5320 636f 6e74 656e 7473 0a2a CMOS contents.* │ │ │ │ │ -00028490: 2063 6d6f 7374 6573 743a 3a20 2020 2020 cmostest:: │ │ │ │ │ -000284a0: 2020 2020 2020 2020 2020 2020 2020 2054 T │ │ │ │ │ -000284b0: 6573 7420 6269 7420 696e 2043 4d4f 530a est bit in CMOS. │ │ │ │ │ -000284c0: 2a20 636d 703a 3a20 2020 2020 2020 2020 * cmp:: │ │ │ │ │ -000284d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000284e0: 436f 6d70 6172 6520 7477 6f20 6669 6c65 Compare two file │ │ │ │ │ -000284f0: 730a 2a20 636f 6e66 6967 6669 6c65 3a3a s.* configfile:: │ │ │ │ │ +000281e0: 2020 2020 204c 6f61 6420 4143 5049 2074 Load ACPI t │ │ │ │ │ +000281f0: 6162 6c65 730a 2a20 6175 7468 656e 7469 ables.* authenti │ │ │ │ │ +00028200: 6361 7465 3a3a 2020 2020 2020 2020 2020 cate:: │ │ │ │ │ +00028210: 2020 2020 2020 4368 6563 6b20 7768 6574 Check whet │ │ │ │ │ +00028220: 6865 7220 7573 6572 2069 7320 696e 2075 her user is in u │ │ │ │ │ +00028230: 7365 7220 6c69 7374 0a2a 2062 6163 6b67 ser list.* backg │ │ │ │ │ +00028240: 726f 756e 645f 636f 6c6f 723a 3a20 2020 round_color:: │ │ │ │ │ +00028250: 2020 2020 2020 2020 2053 6574 2062 6163 Set bac │ │ │ │ │ +00028260: 6b67 726f 756e 6420 636f 6c6f 7220 666f kground color fo │ │ │ │ │ +00028270: 7220 6163 7469 7665 2074 6572 6d69 6e61 r active termina │ │ │ │ │ +00028280: 6c0a 2a20 6261 636b 6772 6f75 6e64 5f69 l.* background_i │ │ │ │ │ +00028290: 6d61 6765 3a3a 2020 2020 2020 2020 2020 mage:: │ │ │ │ │ +000282a0: 2020 4c6f 6164 2062 6163 6b67 726f 756e Load backgroun │ │ │ │ │ +000282b0: 6420 696d 6167 6520 666f 7220 6163 7469 d image for acti │ │ │ │ │ +000282c0: 7665 2074 6572 6d69 6e61 6c0a 2a20 6261 ve terminal.* ba │ │ │ │ │ +000282d0: 6472 616d 3a3a 2020 2020 2020 2020 2020 dram:: │ │ │ │ │ +000282e0: 2020 2020 2020 2020 2020 2020 4669 6c74 Filt │ │ │ │ │ +000282f0: 6572 206f 7574 2062 6164 2072 6567 696f er out bad regio │ │ │ │ │ +00028300: 6e73 206f 6620 5241 4d0a 2a20 626c 6f63 ns of RAM.* bloc │ │ │ │ │ +00028310: 6b6c 6973 743a 3a20 2020 2020 2020 2020 klist:: │ │ │ │ │ +00028320: 2020 2020 2020 2020 2020 5072 696e 7420 Print │ │ │ │ │ +00028330: 6120 626c 6f63 6b20 6c69 7374 0a2a 2062 a block list.* b │ │ │ │ │ +00028340: 6f6f 743a 3a20 2020 2020 2020 2020 2020 oot:: │ │ │ │ │ +00028350: 2020 2020 2020 2020 2020 2020 2053 7461 Sta │ │ │ │ │ +00028360: 7274 2075 7020 796f 7572 206f 7065 7261 rt up your opera │ │ │ │ │ +00028370: 7469 6e67 2073 7973 7465 6d0a 2a20 6361 ting system.* ca │ │ │ │ │ +00028380: 743a 3a20 2020 2020 2020 2020 2020 2020 t:: │ │ │ │ │ +00028390: 2020 2020 2020 2020 2020 2020 5368 6f77 Show │ │ │ │ │ +000283a0: 2074 6865 2063 6f6e 7465 6e74 7320 6f66 the contents of │ │ │ │ │ +000283b0: 2061 2066 696c 650a 2a20 6368 6169 6e6c a file.* chainl │ │ │ │ │ +000283c0: 6f61 6465 723a 3a20 2020 2020 2020 2020 oader:: │ │ │ │ │ +000283d0: 2020 2020 2020 2020 4368 6169 6e2d 6c6f Chain-lo │ │ │ │ │ +000283e0: 6164 2061 6e6f 7468 6572 2062 6f6f 7420 ad another boot │ │ │ │ │ +000283f0: 6c6f 6164 6572 0a2a 2063 6c65 6172 3a3a loader.* clear:: │ │ │ │ │ +00028400: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00028410: 2020 2020 2020 2043 6c65 6172 2074 6865 Clear the │ │ │ │ │ +00028420: 2073 6372 6565 6e0a 2a20 636d 6f73 636c screen.* cmoscl │ │ │ │ │ +00028430: 6561 6e3a 3a20 2020 2020 2020 2020 2020 ean:: │ │ │ │ │ +00028440: 2020 2020 2020 2020 436c 6561 7220 6269 Clear bi │ │ │ │ │ +00028450: 7420 696e 2043 4d4f 530a 2a20 636d 6f73 t in CMOS.* cmos │ │ │ │ │ +00028460: 6475 6d70 3a3a 2020 2020 2020 2020 2020 dump:: │ │ │ │ │ +00028470: 2020 2020 2020 2020 2020 4475 6d70 2043 Dump C │ │ │ │ │ +00028480: 4d4f 5320 636f 6e74 656e 7473 0a2a 2063 MOS contents.* c │ │ │ │ │ +00028490: 6d6f 7374 6573 743a 3a20 2020 2020 2020 mostest:: │ │ │ │ │ +000284a0: 2020 2020 2020 2020 2020 2020 2054 6573 Tes │ │ │ │ │ +000284b0: 7420 6269 7420 696e 2043 4d4f 530a 2a20 t bit in CMOS.* │ │ │ │ │ +000284c0: 636d 703a 3a20 2020 2020 2020 2020 2020 cmp:: │ │ │ │ │ +000284d0: 2020 2020 2020 2020 2020 2020 2020 436f Co │ │ │ │ │ +000284e0: 6d70 6172 6520 7477 6f20 6669 6c65 730a mpare two files. │ │ │ │ │ +000284f0: 2a20 636f 6e66 6967 6669 6c65 3a3a 2020 * configfile:: │ │ │ │ │ 00028500: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00028510: 2020 4c6f 6164 2061 2063 6f6e 6669 6775 Load a configu │ │ │ │ │ -00028520: 7261 7469 6f6e 2066 696c 650a 2a20 6370 ration file.* cp │ │ │ │ │ -00028530: 7569 643a 3a20 2020 2020 2020 2020 2020 uid:: │ │ │ │ │ -00028540: 2020 2020 2020 2020 2020 2020 4368 6563 Chec │ │ │ │ │ -00028550: 6b20 666f 7220 4350 5520 6665 6174 7572 k for CPU featur │ │ │ │ │ -00028560: 6573 0a2a 2063 7263 3a3a 2020 2020 2020 es.* crc:: │ │ │ │ │ +00028510: 4c6f 6164 2061 2063 6f6e 6669 6775 7261 Load a configura │ │ │ │ │ +00028520: 7469 6f6e 2066 696c 650a 2a20 6370 7569 tion file.* cpui │ │ │ │ │ +00028530: 643a 3a20 2020 2020 2020 2020 2020 2020 d:: │ │ │ │ │ +00028540: 2020 2020 2020 2020 2020 4368 6563 6b20 Check │ │ │ │ │ +00028550: 666f 7220 4350 5520 6665 6174 7572 6573 for CPU features │ │ │ │ │ +00028560: 0a2a 2063 7263 3a3a 2020 2020 2020 2020 .* crc:: │ │ │ │ │ 00028570: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00028580: 2020 2043 6f6d 7075 7465 206f 7220 6368 Compute or ch │ │ │ │ │ -00028590: 6563 6b20 4352 4333 3220 6368 6563 6b73 eck CRC32 checks │ │ │ │ │ -000285a0: 756d 730a 2a20 6372 7970 746f 6d6f 756e ums.* cryptomoun │ │ │ │ │ -000285b0: 743a 3a20 2020 2020 2020 2020 2020 2020 t:: │ │ │ │ │ -000285c0: 2020 2020 4d6f 756e 7420 6120 6372 7970 Mount a cryp │ │ │ │ │ -000285d0: 746f 2064 6576 6963 650a 2a20 6375 746d to device.* cutm │ │ │ │ │ -000285e0: 656d 3a3a 2020 2020 2020 2020 2020 2020 em:: │ │ │ │ │ -000285f0: 2020 2020 2020 2020 2020 5265 6d6f 7665 Remove │ │ │ │ │ -00028600: 206d 656d 6f72 7920 7265 6769 6f6e 730a memory regions. │ │ │ │ │ -00028610: 2a20 6461 7465 3a3a 2020 2020 2020 2020 * date:: │ │ │ │ │ -00028620: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00028630: 4469 7370 6c61 7920 6f72 2073 6574 2063 Display or set c │ │ │ │ │ -00028640: 7572 7265 6e74 2064 6174 6520 616e 6420 urrent date and │ │ │ │ │ -00028650: 7469 6d65 0a2a 2064 6576 6963 6574 7265 time.* devicetre │ │ │ │ │ -00028660: 653a 3a20 2020 2020 2020 2020 2020 2020 e:: │ │ │ │ │ -00028670: 2020 2020 204c 6f61 6420 6120 6465 7669 Load a devi │ │ │ │ │ -00028680: 6365 2074 7265 6520 626c 6f62 0a2a 2064 ce tree blob.* d │ │ │ │ │ -00028690: 6973 7472 7573 743a 3a20 2020 2020 2020 istrust:: │ │ │ │ │ -000286a0: 2020 2020 2020 2020 2020 2020 2052 656d Rem │ │ │ │ │ -000286b0: 6f76 6520 6120 7075 626b 6579 2066 726f ove a pubkey fro │ │ │ │ │ -000286c0: 6d20 7472 7573 7465 6420 6b65 7973 0a2a m trusted keys.* │ │ │ │ │ -000286d0: 2064 7269 7665 6d61 703a 3a20 2020 2020 drivemap:: │ │ │ │ │ -000286e0: 2020 2020 2020 2020 2020 2020 2020 204d M │ │ │ │ │ -000286f0: 6170 2061 2064 7269 7665 2074 6f20 616e ap a drive to an │ │ │ │ │ -00028700: 6f74 6865 720a 2a20 6563 686f 3a3a 2020 other.* echo:: │ │ │ │ │ +00028580: 2043 6f6d 7075 7465 206f 7220 6368 6563 Compute or chec │ │ │ │ │ +00028590: 6b20 4352 4333 3220 6368 6563 6b73 756d k CRC32 checksum │ │ │ │ │ +000285a0: 730a 2a20 6372 7970 746f 6d6f 756e 743a s.* cryptomount: │ │ │ │ │ +000285b0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +000285c0: 2020 4d6f 756e 7420 6120 6372 7970 746f Mount a crypto │ │ │ │ │ +000285d0: 2064 6576 6963 650a 2a20 6375 746d 656d device.* cutmem │ │ │ │ │ +000285e0: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ │ +000285f0: 2020 2020 2020 2020 5265 6d6f 7665 206d Remove m │ │ │ │ │ +00028600: 656d 6f72 7920 7265 6769 6f6e 730a 2a20 emory regions.* │ │ │ │ │ +00028610: 6461 7465 3a3a 2020 2020 2020 2020 2020 date:: │ │ │ │ │ +00028620: 2020 2020 2020 2020 2020 2020 2020 4469 Di │ │ │ │ │ +00028630: 7370 6c61 7920 6f72 2073 6574 2063 7572 splay or set cur │ │ │ │ │ +00028640: 7265 6e74 2064 6174 6520 616e 6420 7469 rent date and ti │ │ │ │ │ +00028650: 6d65 0a2a 2064 6576 6963 6574 7265 653a me.* devicetree: │ │ │ │ │ +00028660: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00028670: 2020 204c 6f61 6420 6120 6465 7669 6365 Load a device │ │ │ │ │ +00028680: 2074 7265 6520 626c 6f62 0a2a 2064 6973 tree blob.* dis │ │ │ │ │ +00028690: 7472 7573 743a 3a20 2020 2020 2020 2020 trust:: │ │ │ │ │ +000286a0: 2020 2020 2020 2020 2020 2052 656d 6f76 Remov │ │ │ │ │ +000286b0: 6520 6120 7075 626b 6579 2066 726f 6d20 e a pubkey from │ │ │ │ │ +000286c0: 7472 7573 7465 6420 6b65 7973 0a2a 2064 trusted keys.* d │ │ │ │ │ +000286d0: 7269 7665 6d61 703a 3a20 2020 2020 2020 rivemap:: │ │ │ │ │ +000286e0: 2020 2020 2020 2020 2020 2020 204d 6170 Map │ │ │ │ │ +000286f0: 2061 2064 7269 7665 2074 6f20 616e 6f74 a drive to anot │ │ │ │ │ +00028700: 6865 720a 2a20 6563 686f 3a3a 2020 2020 her.* echo:: │ │ │ │ │ 00028710: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00028720: 2020 2020 2020 4469 7370 6c61 7920 6120 Display a │ │ │ │ │ -00028730: 6c69 6e65 206f 6620 7465 7874 0a2a 2065 line of text.* e │ │ │ │ │ -00028740: 7661 6c3a 3a20 2020 2020 2020 2020 2020 val:: │ │ │ │ │ -00028750: 2020 2020 2020 2020 2020 2020 2045 7661 Eva │ │ │ │ │ -00028760: 6c75 6174 6520 6167 7275 6d65 6e74 7320 luate agruments │ │ │ │ │ -00028770: 6173 2047 5255 4220 636f 6d6d 616e 6473 as GRUB commands │ │ │ │ │ -00028780: 0a2a 2065 7870 6f72 743a 3a20 2020 2020 .* export:: │ │ │ │ │ -00028790: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000287a0: 2045 7870 6f72 7420 616e 2065 6e76 6972 Export an envir │ │ │ │ │ -000287b0: 6f6e 6d65 6e74 2076 6172 6961 626c 650a onment variable. │ │ │ │ │ -000287c0: 2a20 6661 6c73 653a 3a20 2020 2020 2020 * false:: │ │ │ │ │ -000287d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000287e0: 446f 206e 6f74 6869 6e67 2c20 756e 7375 Do nothing, unsu │ │ │ │ │ -000287f0: 6363 6573 7366 756c 6c79 0a2a 2067 6574 ccessfully.* get │ │ │ │ │ -00028800: 7465 7874 3a3a 2020 2020 2020 2020 2020 text:: │ │ │ │ │ -00028810: 2020 2020 2020 2020 2020 2054 7261 6e73 Trans │ │ │ │ │ -00028820: 6c61 7465 2061 2073 7472 696e 670a 2a20 late a string.* │ │ │ │ │ -00028830: 6770 7473 796e 633a 3a20 2020 2020 2020 gptsync:: │ │ │ │ │ -00028840: 2020 2020 2020 2020 2020 2020 2020 4669 Fi │ │ │ │ │ -00028850: 6c6c 2061 6e20 4d42 5220 6261 7365 6420 ll an MBR based │ │ │ │ │ -00028860: 6f6e 2047 5054 2065 6e74 7269 6573 0a2a on GPT entries.* │ │ │ │ │ -00028870: 2068 616c 743a 3a20 2020 2020 2020 2020 halt:: │ │ │ │ │ -00028880: 2020 2020 2020 2020 2020 2020 2020 2053 S │ │ │ │ │ -00028890: 6875 7420 646f 776e 2079 6f75 7220 636f hut down your co │ │ │ │ │ -000288a0: 6d70 7574 6572 0a2a 2068 6173 6873 756d mputer.* hashsum │ │ │ │ │ -000288b0: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ │ -000288c0: 2020 2020 2020 2043 6f6d 7075 7465 206f Compute o │ │ │ │ │ -000288d0: 7220 6368 6563 6b20 6861 7368 2063 6865 r check hash che │ │ │ │ │ -000288e0: 636b 7375 6d0a 2a20 6865 6c70 3a3a 2020 cksum.* help:: │ │ │ │ │ +00028720: 2020 2020 4469 7370 6c61 7920 6120 6c69 Display a li │ │ │ │ │ +00028730: 6e65 206f 6620 7465 7874 0a2a 2065 7661 ne of text.* eva │ │ │ │ │ +00028740: 6c3a 3a20 2020 2020 2020 2020 2020 2020 l:: │ │ │ │ │ +00028750: 2020 2020 2020 2020 2020 2045 7661 6c75 Evalu │ │ │ │ │ +00028760: 6174 6520 6167 7275 6d65 6e74 7320 6173 ate agruments as │ │ │ │ │ +00028770: 2047 5255 4220 636f 6d6d 616e 6473 0a2a GRUB commands.* │ │ │ │ │ +00028780: 2065 7870 6f72 743a 3a20 2020 2020 2020 export:: │ │ │ │ │ +00028790: 2020 2020 2020 2020 2020 2020 2020 2045 E │ │ │ │ │ +000287a0: 7870 6f72 7420 616e 2065 6e76 6972 6f6e xport an environ │ │ │ │ │ +000287b0: 6d65 6e74 2076 6172 6961 626c 650a 2a20 ment variable.* │ │ │ │ │ +000287c0: 6661 6c73 653a 3a20 2020 2020 2020 2020 false:: │ │ │ │ │ +000287d0: 2020 2020 2020 2020 2020 2020 2020 446f Do │ │ │ │ │ +000287e0: 206e 6f74 6869 6e67 2c20 756e 7375 6363 nothing, unsucc │ │ │ │ │ +000287f0: 6573 7366 756c 6c79 0a2a 2067 6574 7465 essfully.* gette │ │ │ │ │ +00028800: 7874 3a3a 2020 2020 2020 2020 2020 2020 xt:: │ │ │ │ │ +00028810: 2020 2020 2020 2020 2054 7261 6e73 6c61 Transla │ │ │ │ │ +00028820: 7465 2061 2073 7472 696e 670a 2a20 6770 te a string.* gp │ │ │ │ │ +00028830: 7473 796e 633a 3a20 2020 2020 2020 2020 tsync:: │ │ │ │ │ +00028840: 2020 2020 2020 2020 2020 2020 4669 6c6c Fill │ │ │ │ │ +00028850: 2061 6e20 4d42 5220 6261 7365 6420 6f6e an MBR based on │ │ │ │ │ +00028860: 2047 5054 2065 6e74 7269 6573 0a2a 2068 GPT entries.* h │ │ │ │ │ +00028870: 616c 743a 3a20 2020 2020 2020 2020 2020 alt:: │ │ │ │ │ +00028880: 2020 2020 2020 2020 2020 2020 2053 6875 Shu │ │ │ │ │ +00028890: 7420 646f 776e 2079 6f75 7220 636f 6d70 t down your comp │ │ │ │ │ +000288a0: 7574 6572 0a2a 2068 6173 6873 756d 3a3a uter.* hashsum:: │ │ │ │ │ +000288b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +000288c0: 2020 2020 2043 6f6d 7075 7465 206f 7220 Compute or │ │ │ │ │ +000288d0: 6368 6563 6b20 6861 7368 2063 6865 636b check hash check │ │ │ │ │ +000288e0: 7375 6d0a 2a20 6865 6c70 3a3a 2020 2020 sum.* help:: │ │ │ │ │ 000288f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00028900: 2020 2020 2020 5368 6f77 2068 656c 7020 Show help │ │ │ │ │ -00028910: 6d65 7373 6167 6573 0a2a 2069 6e69 7472 messages.* initr │ │ │ │ │ -00028920: 643a 3a20 2020 2020 2020 2020 2020 2020 d:: │ │ │ │ │ -00028930: 2020 2020 2020 2020 204c 6f61 6420 6120 Load a │ │ │ │ │ -00028940: 4c69 6e75 7820 696e 6974 7264 0a2a 2069 Linux initrd.* i │ │ │ │ │ -00028950: 6e69 7472 6431 363a 3a20 2020 2020 2020 nitrd16:: │ │ │ │ │ -00028960: 2020 2020 2020 2020 2020 2020 204c 6f61 Loa │ │ │ │ │ -00028970: 6420 6120 4c69 6e75 7820 696e 6974 7264 d a Linux initrd │ │ │ │ │ -00028980: 2028 3136 2d62 6974 206d 6f64 6529 0a2a (16-bit mode).* │ │ │ │ │ -00028990: 2069 6e73 6d6f 643a 3a20 2020 2020 2020 insmod:: │ │ │ │ │ -000289a0: 2020 2020 2020 2020 2020 2020 2020 2049 I │ │ │ │ │ -000289b0: 6e73 6572 7420 6120 6d6f 6475 6c65 0a2a nsert a module.* │ │ │ │ │ -000289c0: 206b 6579 7374 6174 7573 3a3a 2020 2020 keystatus:: │ │ │ │ │ -000289d0: 2020 2020 2020 2020 2020 2020 2020 2043 C │ │ │ │ │ -000289e0: 6865 636b 206b 6579 206d 6f64 6966 6965 heck key modifie │ │ │ │ │ -000289f0: 7220 7374 6174 7573 0a2a 206c 696e 7578 r status.* linux │ │ │ │ │ -00028a00: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ │ -00028a10: 2020 2020 2020 2020 204c 6f61 6420 6120 Load a │ │ │ │ │ -00028a20: 4c69 6e75 7820 6b65 726e 656c 0a2a 206c Linux kernel.* l │ │ │ │ │ -00028a30: 696e 7578 3136 3a3a 2020 2020 2020 2020 inux16:: │ │ │ │ │ -00028a40: 2020 2020 2020 2020 2020 2020 204c 6f61 Loa │ │ │ │ │ -00028a50: 6420 6120 4c69 6e75 7820 6b65 726e 656c d a Linux kernel │ │ │ │ │ -00028a60: 2028 3136 2d62 6974 206d 6f64 6529 0a2a (16-bit mode).* │ │ │ │ │ -00028a70: 206c 6973 745f 656e 763a 3a20 2020 2020 list_env:: │ │ │ │ │ -00028a80: 2020 2020 2020 2020 2020 2020 2020 204c L │ │ │ │ │ -00028a90: 6973 7420 7661 7269 6162 6c65 7320 696e ist variables in │ │ │ │ │ -00028aa0: 2065 6e76 6972 6f6e 6d65 6e74 2062 6c6f environment blo │ │ │ │ │ -00028ab0: 636b 0a2a 206c 6973 745f 7472 7573 7465 ck.* list_truste │ │ │ │ │ -00028ac0: 643a 3a20 2020 2020 2020 2020 2020 2020 d:: │ │ │ │ │ -00028ad0: 2020 204c 6973 7420 7472 7573 7465 6420 List trusted │ │ │ │ │ -00028ae0: 7075 626c 6963 206b 6579 730a 2a20 6c6f public keys.* lo │ │ │ │ │ -00028af0: 6164 5f65 6e76 3a3a 2020 2020 2020 2020 ad_env:: │ │ │ │ │ -00028b00: 2020 2020 2020 2020 2020 2020 4c6f 6164 Load │ │ │ │ │ -00028b10: 2076 6172 6961 626c 6573 2066 726f 6d20 variables from │ │ │ │ │ -00028b20: 656e 7669 726f 6e6d 656e 7420 626c 6f63 environment bloc │ │ │ │ │ -00028b30: 6b0a 2a20 6c6f 6164 666f 6e74 3a3a 2020 k.* loadfont:: │ │ │ │ │ +00028900: 2020 2020 5368 6f77 2068 656c 7020 6d65 Show help me │ │ │ │ │ +00028910: 7373 6167 6573 0a2a 2069 6e69 7472 643a ssages.* initrd: │ │ │ │ │ +00028920: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00028930: 2020 2020 2020 204c 6f61 6420 6120 4c69 Load a Li │ │ │ │ │ +00028940: 6e75 7820 696e 6974 7264 0a2a 2069 6e69 nux initrd.* ini │ │ │ │ │ +00028950: 7472 6431 363a 3a20 2020 2020 2020 2020 trd16:: │ │ │ │ │ +00028960: 2020 2020 2020 2020 2020 204c 6f61 6420 Load │ │ │ │ │ +00028970: 6120 4c69 6e75 7820 696e 6974 7264 2028 a Linux initrd ( │ │ │ │ │ +00028980: 3136 2d62 6974 206d 6f64 6529 0a2a 2069 16-bit mode).* i │ │ │ │ │ +00028990: 6e73 6d6f 643a 3a20 2020 2020 2020 2020 nsmod:: │ │ │ │ │ +000289a0: 2020 2020 2020 2020 2020 2020 2049 6e73 Ins │ │ │ │ │ +000289b0: 6572 7420 6120 6d6f 6475 6c65 0a2a 206b ert a module.* k │ │ │ │ │ +000289c0: 6579 7374 6174 7573 3a3a 2020 2020 2020 eystatus:: │ │ │ │ │ +000289d0: 2020 2020 2020 2020 2020 2020 2043 6865 Che │ │ │ │ │ +000289e0: 636b 206b 6579 206d 6f64 6966 6965 7220 ck key modifier │ │ │ │ │ +000289f0: 7374 6174 7573 0a2a 206c 696e 7578 3a3a status.* linux:: │ │ │ │ │ +00028a00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00028a10: 2020 2020 2020 204c 6f61 6420 6120 4c69 Load a Li │ │ │ │ │ +00028a20: 6e75 7820 6b65 726e 656c 0a2a 206c 696e nux kernel.* lin │ │ │ │ │ +00028a30: 7578 3136 3a3a 2020 2020 2020 2020 2020 ux16:: │ │ │ │ │ +00028a40: 2020 2020 2020 2020 2020 204c 6f61 6420 Load │ │ │ │ │ +00028a50: 6120 4c69 6e75 7820 6b65 726e 656c 2028 a Linux kernel ( │ │ │ │ │ +00028a60: 3136 2d62 6974 206d 6f64 6529 0a2a 206c 16-bit mode).* l │ │ │ │ │ +00028a70: 6973 745f 656e 763a 3a20 2020 2020 2020 ist_env:: │ │ │ │ │ +00028a80: 2020 2020 2020 2020 2020 2020 204c 6973 Lis │ │ │ │ │ +00028a90: 7420 7661 7269 6162 6c65 7320 696e 2065 t variables in e │ │ │ │ │ +00028aa0: 6e76 6972 6f6e 6d65 6e74 2062 6c6f 636b nvironment block │ │ │ │ │ +00028ab0: 0a2a 206c 6973 745f 7472 7573 7465 643a .* list_trusted: │ │ │ │ │ +00028ac0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00028ad0: 204c 6973 7420 7472 7573 7465 6420 7075 List trusted pu │ │ │ │ │ +00028ae0: 626c 6963 206b 6579 730a 2a20 6c6f 6164 blic keys.* load │ │ │ │ │ +00028af0: 5f65 6e76 3a3a 2020 2020 2020 2020 2020 _env:: │ │ │ │ │ +00028b00: 2020 2020 2020 2020 2020 4c6f 6164 2076 Load v │ │ │ │ │ +00028b10: 6172 6961 626c 6573 2066 726f 6d20 656e ariables from en │ │ │ │ │ +00028b20: 7669 726f 6e6d 656e 7420 626c 6f63 6b0a vironment block. │ │ │ │ │ +00028b30: 2a20 6c6f 6164 666f 6e74 3a3a 2020 2020 * loadfont:: │ │ │ │ │ 00028b40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00028b50: 2020 4c6f 6164 2066 6f6e 7420 6669 6c65 Load font file │ │ │ │ │ -00028b60: 730a 2a20 6c6f 6f70 6261 636b 3a3a 2020 s.* loopback:: │ │ │ │ │ +00028b50: 4c6f 6164 2066 6f6e 7420 6669 6c65 730a Load font files. │ │ │ │ │ +00028b60: 2a20 6c6f 6f70 6261 636b 3a3a 2020 2020 * loopback:: │ │ │ │ │ 00028b70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00028b80: 2020 4d61 6b65 2061 2064 6576 6963 6520 Make a device │ │ │ │ │ -00028b90: 6672 6f6d 2061 2066 696c 6573 7973 7465 from a filesyste │ │ │ │ │ -00028ba0: 6d20 696d 6167 650a 2a20 6c73 3a3a 2020 m image.* ls:: │ │ │ │ │ +00028b80: 4d61 6b65 2061 2064 6576 6963 6520 6672 Make a device fr │ │ │ │ │ +00028b90: 6f6d 2061 2066 696c 6573 7973 7465 6d20 om a filesystem │ │ │ │ │ +00028ba0: 696d 6167 650a 2a20 6c73 3a3a 2020 2020 image.* ls:: │ │ │ │ │ 00028bb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00028bc0: 2020 2020 2020 2020 4c69 7374 2064 6576 List dev │ │ │ │ │ -00028bd0: 6963 6573 206f 7220 6669 6c65 730a 2a20 ices or files.* │ │ │ │ │ -00028be0: 6c73 666f 6e74 733a 3a20 2020 2020 2020 lsfonts:: │ │ │ │ │ -00028bf0: 2020 2020 2020 2020 2020 2020 2020 4c69 Li │ │ │ │ │ -00028c00: 7374 206c 6f61 6465 6420 666f 6e74 730a st loaded fonts. │ │ │ │ │ -00028c10: 2a20 6c73 6d6f 643a 3a20 2020 2020 2020 * lsmod:: │ │ │ │ │ -00028c20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00028c30: 5368 6f77 206c 6f61 6465 6420 6d6f 6475 Show loaded modu │ │ │ │ │ -00028c40: 6c65 730a 2a20 6d64 3573 756d 3a3a 2020 les.* md5sum:: │ │ │ │ │ +00028bc0: 2020 2020 2020 4c69 7374 2064 6576 6963 List devic │ │ │ │ │ +00028bd0: 6573 206f 7220 6669 6c65 730a 2a20 6c73 es or files.* ls │ │ │ │ │ +00028be0: 666f 6e74 733a 3a20 2020 2020 2020 2020 fonts:: │ │ │ │ │ +00028bf0: 2020 2020 2020 2020 2020 2020 4c69 7374 List │ │ │ │ │ +00028c00: 206c 6f61 6465 6420 666f 6e74 730a 2a20 loaded fonts.* │ │ │ │ │ +00028c10: 6c73 6d6f 643a 3a20 2020 2020 2020 2020 lsmod:: │ │ │ │ │ +00028c20: 2020 2020 2020 2020 2020 2020 2020 5368 Sh │ │ │ │ │ +00028c30: 6f77 206c 6f61 6465 6420 6d6f 6475 6c65 ow loaded module │ │ │ │ │ +00028c40: 730a 2a20 6d64 3573 756d 3a3a 2020 2020 s.* md5sum:: │ │ │ │ │ 00028c50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00028c60: 2020 2020 436f 6d70 7574 6520 6f72 2063 Compute or c │ │ │ │ │ -00028c70: 6865 636b 204d 4435 2068 6173 680a 2a20 heck MD5 hash.* │ │ │ │ │ -00028c80: 6d6f 6475 6c65 3a3a 2020 2020 2020 2020 module:: │ │ │ │ │ -00028c90: 2020 2020 2020 2020 2020 2020 2020 4c6f Lo │ │ │ │ │ -00028ca0: 6164 206d 6f64 756c 6520 666f 7220 6d75 ad module for mu │ │ │ │ │ -00028cb0: 6c74 6962 6f6f 7420 6b65 726e 656c 0a2a ltiboot kernel.* │ │ │ │ │ -00028cc0: 206d 756c 7469 626f 6f74 3a3a 2020 2020 multiboot:: │ │ │ │ │ -00028cd0: 2020 2020 2020 2020 2020 2020 2020 204c L │ │ │ │ │ -00028ce0: 6f61 6420 6d75 6c74 6962 6f6f 7420 636f oad multiboot co │ │ │ │ │ -00028cf0: 6d70 6c69 616e 7420 6b65 726e 656c 0a2a mpliant kernel.* │ │ │ │ │ -00028d00: 206e 6174 6976 6564 6973 6b3a 3a20 2020 nativedisk:: │ │ │ │ │ -00028d10: 2020 2020 2020 2020 2020 2020 2020 2053 S │ │ │ │ │ -00028d20: 7769 7463 6820 746f 206e 6174 6976 6520 witch to native │ │ │ │ │ -00028d30: 6469 736b 2064 7269 7665 7273 0a2a 206e disk drivers.* n │ │ │ │ │ -00028d40: 6f72 6d61 6c3a 3a20 2020 2020 2020 2020 ormal:: │ │ │ │ │ -00028d50: 2020 2020 2020 2020 2020 2020 2045 6e74 Ent │ │ │ │ │ -00028d60: 6572 206e 6f72 6d61 6c20 6d6f 6465 0a2a er normal mode.* │ │ │ │ │ -00028d70: 206e 6f72 6d61 6c5f 6578 6974 3a3a 2020 normal_exit:: │ │ │ │ │ -00028d80: 2020 2020 2020 2020 2020 2020 2020 2045 E │ │ │ │ │ -00028d90: 7869 7420 6672 6f6d 206e 6f72 6d61 6c20 xit from normal │ │ │ │ │ -00028da0: 6d6f 6465 0a2a 2070 6172 7474 6f6f 6c3a mode.* parttool: │ │ │ │ │ -00028db0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -00028dc0: 2020 2020 204d 6f64 6966 7920 7061 7274 Modify part │ │ │ │ │ -00028dd0: 6974 696f 6e20 7461 626c 6520 656e 7472 ition table entr │ │ │ │ │ -00028de0: 6965 730a 2a20 7061 7373 776f 7264 3a3a ies.* password:: │ │ │ │ │ +00028c60: 2020 436f 6d70 7574 6520 6f72 2063 6865 Compute or che │ │ │ │ │ +00028c70: 636b 204d 4435 2068 6173 680a 2a20 6d6f ck MD5 hash.* mo │ │ │ │ │ +00028c80: 6475 6c65 3a3a 2020 2020 2020 2020 2020 dule:: │ │ │ │ │ +00028c90: 2020 2020 2020 2020 2020 2020 4c6f 6164 Load │ │ │ │ │ +00028ca0: 206d 6f64 756c 6520 666f 7220 6d75 6c74 module for mult │ │ │ │ │ +00028cb0: 6962 6f6f 7420 6b65 726e 656c 0a2a 206d iboot kernel.* m │ │ │ │ │ +00028cc0: 756c 7469 626f 6f74 3a3a 2020 2020 2020 ultiboot:: │ │ │ │ │ +00028cd0: 2020 2020 2020 2020 2020 2020 204c 6f61 Loa │ │ │ │ │ +00028ce0: 6420 6d75 6c74 6962 6f6f 7420 636f 6d70 d multiboot comp │ │ │ │ │ +00028cf0: 6c69 616e 7420 6b65 726e 656c 0a2a 206e liant kernel.* n │ │ │ │ │ +00028d00: 6174 6976 6564 6973 6b3a 3a20 2020 2020 ativedisk:: │ │ │ │ │ +00028d10: 2020 2020 2020 2020 2020 2020 2053 7769 Swi │ │ │ │ │ +00028d20: 7463 6820 746f 206e 6174 6976 6520 6469 tch to native di │ │ │ │ │ +00028d30: 736b 2064 7269 7665 7273 0a2a 206e 6f72 sk drivers.* nor │ │ │ │ │ +00028d40: 6d61 6c3a 3a20 2020 2020 2020 2020 2020 mal:: │ │ │ │ │ +00028d50: 2020 2020 2020 2020 2020 2045 6e74 6572 Enter │ │ │ │ │ +00028d60: 206e 6f72 6d61 6c20 6d6f 6465 0a2a 206e normal mode.* n │ │ │ │ │ +00028d70: 6f72 6d61 6c5f 6578 6974 3a3a 2020 2020 ormal_exit:: │ │ │ │ │ +00028d80: 2020 2020 2020 2020 2020 2020 2045 7869 Exi │ │ │ │ │ +00028d90: 7420 6672 6f6d 206e 6f72 6d61 6c20 6d6f t from normal mo │ │ │ │ │ +00028da0: 6465 0a2a 2070 6172 7474 6f6f 6c3a 3a20 de.* parttool:: │ │ │ │ │ +00028db0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00028dc0: 2020 204d 6f64 6966 7920 7061 7274 6974 Modify partit │ │ │ │ │ +00028dd0: 696f 6e20 7461 626c 6520 656e 7472 6965 ion table entrie │ │ │ │ │ +00028de0: 730a 2a20 7061 7373 776f 7264 3a3a 2020 s.* password:: │ │ │ │ │ 00028df0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00028e00: 2020 2020 5365 7420 6120 636c 6561 722d Set a clear- │ │ │ │ │ -00028e10: 7465 7874 2070 6173 7377 6f72 640a 2a20 text password.* │ │ │ │ │ -00028e20: 7061 7373 776f 7264 5f70 626b 6466 323a password_pbkdf2: │ │ │ │ │ -00028e30: 3a20 2020 2020 2020 2020 2020 2020 5365 : Se │ │ │ │ │ -00028e40: 7420 6120 6861 7368 6564 2070 6173 7377 t a hashed passw │ │ │ │ │ -00028e50: 6f72 640a 2a20 706c 6179 3a3a 2020 2020 ord.* play:: │ │ │ │ │ +00028e00: 2020 5365 7420 6120 636c 6561 722d 7465 Set a clear-te │ │ │ │ │ +00028e10: 7874 2070 6173 7377 6f72 640a 2a20 7061 xt password.* pa │ │ │ │ │ +00028e20: 7373 776f 7264 5f70 626b 6466 323a 3a20 ssword_pbkdf2:: │ │ │ │ │ +00028e30: 2020 2020 2020 2020 2020 2020 5365 7420 Set │ │ │ │ │ +00028e40: 6120 6861 7368 6564 2070 6173 7377 6f72 a hashed passwor │ │ │ │ │ +00028e50: 640a 2a20 706c 6179 3a3a 2020 2020 2020 d.* play:: │ │ │ │ │ 00028e60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00028e70: 2020 2020 506c 6179 2061 2074 756e 650a Play a tune. │ │ │ │ │ -00028e80: 2a20 7072 6f62 653a 3a20 2020 2020 2020 * probe:: │ │ │ │ │ -00028e90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00028ea0: 5265 7472 6965 7665 2064 6576 6963 6520 Retrieve device │ │ │ │ │ -00028eb0: 696e 666f 0a2a 2072 646d 7372 3a3a 2020 info.* rdmsr:: │ │ │ │ │ +00028e70: 2020 506c 6179 2061 2074 756e 650a 2a20 Play a tune.* │ │ │ │ │ +00028e80: 7072 6f62 653a 3a20 2020 2020 2020 2020 probe:: │ │ │ │ │ +00028e90: 2020 2020 2020 2020 2020 2020 2020 5265 Re │ │ │ │ │ +00028ea0: 7472 6965 7665 2064 6576 6963 6520 696e trieve device in │ │ │ │ │ +00028eb0: 666f 0a2a 2072 646d 7372 3a3a 2020 2020 fo.* rdmsr:: │ │ │ │ │ 00028ec0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00028ed0: 2020 2020 2052 6561 6420 7661 6c75 6573 Read values │ │ │ │ │ -00028ee0: 2066 726f 6d20 6d6f 6465 6c2d 7370 6563 from model-spec │ │ │ │ │ -00028ef0: 6966 6963 2072 6567 6973 7465 7273 0a2a ific registers.* │ │ │ │ │ -00028f00: 2072 6561 643a 3a20 2020 2020 2020 2020 read:: │ │ │ │ │ -00028f10: 2020 2020 2020 2020 2020 2020 2020 2052 R │ │ │ │ │ -00028f20: 6561 6420 7573 6572 2069 6e70 7574 0a2a ead user input.* │ │ │ │ │ -00028f30: 2072 6562 6f6f 743a 3a20 2020 2020 2020 reboot:: │ │ │ │ │ -00028f40: 2020 2020 2020 2020 2020 2020 2020 2052 R │ │ │ │ │ -00028f50: 6562 6f6f 7420 796f 7572 2063 6f6d 7075 eboot your compu │ │ │ │ │ -00028f60: 7465 720a 2a20 7265 6765 7870 3a3a 2020 ter.* regexp:: │ │ │ │ │ +00028ed0: 2020 2052 6561 6420 7661 6c75 6573 2066 Read values f │ │ │ │ │ +00028ee0: 726f 6d20 6d6f 6465 6c2d 7370 6563 6966 rom model-specif │ │ │ │ │ +00028ef0: 6963 2072 6567 6973 7465 7273 0a2a 2072 ic registers.* r │ │ │ │ │ +00028f00: 6561 643a 3a20 2020 2020 2020 2020 2020 ead:: │ │ │ │ │ +00028f10: 2020 2020 2020 2020 2020 2020 2052 6561 Rea │ │ │ │ │ +00028f20: 6420 7573 6572 2069 6e70 7574 0a2a 2072 d user input.* r │ │ │ │ │ +00028f30: 6562 6f6f 743a 3a20 2020 2020 2020 2020 eboot:: │ │ │ │ │ +00028f40: 2020 2020 2020 2020 2020 2020 2052 6562 Reb │ │ │ │ │ +00028f50: 6f6f 7420 796f 7572 2063 6f6d 7075 7465 oot your compute │ │ │ │ │ +00028f60: 720a 2a20 7265 6765 7870 3a3a 2020 2020 r.* regexp:: │ │ │ │ │ 00028f70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00028f80: 2020 2020 5465 7374 2069 6620 7265 6775 Test if regu │ │ │ │ │ -00028f90: 6c61 7220 6578 7072 6573 7369 6f6e 206d lar expression m │ │ │ │ │ -00028fa0: 6174 6368 6573 2073 7472 696e 670a 2a20 atches string.* │ │ │ │ │ -00028fb0: 726d 6d6f 643a 3a20 2020 2020 2020 2020 rmmod:: │ │ │ │ │ -00028fc0: 2020 2020 2020 2020 2020 2020 2020 5265 Re │ │ │ │ │ -00028fd0: 6d6f 7665 2061 206d 6f64 756c 650a 2a20 move a module.* │ │ │ │ │ -00028fe0: 7361 7665 5f65 6e76 3a3a 2020 2020 2020 save_env:: │ │ │ │ │ -00028ff0: 2020 2020 2020 2020 2020 2020 2020 5361 Sa │ │ │ │ │ -00029000: 7665 2076 6172 6961 626c 6573 2074 6f20 ve variables to │ │ │ │ │ -00029010: 656e 7669 726f 6e6d 656e 7420 626c 6f63 environment bloc │ │ │ │ │ -00029020: 6b0a 2a20 7365 6172 6368 3a3a 2020 2020 k.* search:: │ │ │ │ │ +00028f80: 2020 5465 7374 2069 6620 7265 6775 6c61 Test if regula │ │ │ │ │ +00028f90: 7220 6578 7072 6573 7369 6f6e 206d 6174 r expression mat │ │ │ │ │ +00028fa0: 6368 6573 2073 7472 696e 670a 2a20 726d ches string.* rm │ │ │ │ │ +00028fb0: 6d6f 643a 3a20 2020 2020 2020 2020 2020 mod:: │ │ │ │ │ +00028fc0: 2020 2020 2020 2020 2020 2020 5265 6d6f Remo │ │ │ │ │ +00028fd0: 7665 2061 206d 6f64 756c 650a 2a20 7361 ve a module.* sa │ │ │ │ │ +00028fe0: 7665 5f65 6e76 3a3a 2020 2020 2020 2020 ve_env:: │ │ │ │ │ +00028ff0: 2020 2020 2020 2020 2020 2020 5361 7665 Save │ │ │ │ │ +00029000: 2076 6172 6961 626c 6573 2074 6f20 656e variables to en │ │ │ │ │ +00029010: 7669 726f 6e6d 656e 7420 626c 6f63 6b0a vironment block. │ │ │ │ │ +00029020: 2a20 7365 6172 6368 3a3a 2020 2020 2020 * search:: │ │ │ │ │ 00029030: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00029040: 2020 5365 6172 6368 2064 6576 6963 6573 Search devices │ │ │ │ │ -00029050: 2062 7920 6669 6c65 2c20 6c61 6265 6c2c by file, label, │ │ │ │ │ -00029060: 206f 7220 5555 4944 0a2a 2073 656e 646b or UUID.* sendk │ │ │ │ │ -00029070: 6579 3a3a 2020 2020 2020 2020 2020 2020 ey:: │ │ │ │ │ -00029080: 2020 2020 2020 2020 2045 6d75 6c61 7465 Emulate │ │ │ │ │ -00029090: 206b 6579 7374 726f 6b65 730a 2a20 7365 keystrokes.* se │ │ │ │ │ -000290a0: 743a 3a20 2020 2020 2020 2020 2020 2020 t:: │ │ │ │ │ -000290b0: 2020 2020 2020 2020 2020 2020 5365 7420 Set │ │ │ │ │ -000290c0: 616e 2065 6e76 6972 6f6e 6d65 6e74 2076 an environment v │ │ │ │ │ -000290d0: 6172 6961 626c 650a 2a20 7368 6131 7375 ariable.* sha1su │ │ │ │ │ -000290e0: 6d3a 3a20 2020 2020 2020 2020 2020 2020 m:: │ │ │ │ │ -000290f0: 2020 2020 2020 2020 436f 6d70 7574 6520 Compute │ │ │ │ │ -00029100: 6f72 2063 6865 636b 2053 4841 3120 6861 or check SHA1 ha │ │ │ │ │ -00029110: 7368 0a2a 2073 6861 3235 3673 756d 3a3a sh.* sha256sum:: │ │ │ │ │ +00029040: 5365 6172 6368 2064 6576 6963 6573 2062 Search devices b │ │ │ │ │ +00029050: 7920 6669 6c65 2c20 6c61 6265 6c2c 206f y file, label, o │ │ │ │ │ +00029060: 7220 5555 4944 0a2a 2073 656e 646b 6579 r UUID.* sendkey │ │ │ │ │ +00029070: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ │ +00029080: 2020 2020 2020 2045 6d75 6c61 7465 206b Emulate k │ │ │ │ │ +00029090: 6579 7374 726f 6b65 730a 2a20 7365 743a eystrokes.* set: │ │ │ │ │ +000290a0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +000290b0: 2020 2020 2020 2020 2020 5365 7420 616e Set an │ │ │ │ │ +000290c0: 2065 6e76 6972 6f6e 6d65 6e74 2076 6172 environment var │ │ │ │ │ +000290d0: 6961 626c 650a 2a20 7368 6131 7375 6d3a iable.* sha1sum: │ │ │ │ │ +000290e0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +000290f0: 2020 2020 2020 436f 6d70 7574 6520 6f72 Compute or │ │ │ │ │ +00029100: 2063 6865 636b 2053 4841 3120 6861 7368 check SHA1 hash │ │ │ │ │ +00029110: 0a2a 2073 6861 3235 3673 756d 3a3a 2020 .* sha256sum:: │ │ │ │ │ 00029120: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00029130: 2020 2043 6f6d 7075 7465 206f 7220 6368 Compute or ch │ │ │ │ │ -00029140: 6563 6b20 5348 4132 3536 2068 6173 680a eck SHA256 hash. │ │ │ │ │ -00029150: 2a20 7368 6135 3132 7375 6d3a 3a20 2020 * sha512sum:: │ │ │ │ │ -00029160: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00029170: 436f 6d70 7574 6520 6f72 2063 6865 636b Compute or check │ │ │ │ │ -00029180: 2053 4841 3531 3220 6861 7368 0a2a 2073 SHA512 hash.* s │ │ │ │ │ -00029190: 6c65 6570 3a3a 2020 2020 2020 2020 2020 leep:: │ │ │ │ │ -000291a0: 2020 2020 2020 2020 2020 2020 2057 6169 Wai │ │ │ │ │ -000291b0: 7420 666f 7220 6120 7370 6563 6966 6965 t for a specifie │ │ │ │ │ -000291c0: 6420 6e75 6d62 6572 206f 6620 7365 636f d number of seco │ │ │ │ │ -000291d0: 6e64 730a 2a20 736d 6269 6f73 3a3a 2020 nds.* smbios:: │ │ │ │ │ +00029130: 2043 6f6d 7075 7465 206f 7220 6368 6563 Compute or chec │ │ │ │ │ +00029140: 6b20 5348 4132 3536 2068 6173 680a 2a20 k SHA256 hash.* │ │ │ │ │ +00029150: 7368 6135 3132 7375 6d3a 3a20 2020 2020 sha512sum:: │ │ │ │ │ +00029160: 2020 2020 2020 2020 2020 2020 2020 436f Co │ │ │ │ │ +00029170: 6d70 7574 6520 6f72 2063 6865 636b 2053 mpute or check S │ │ │ │ │ +00029180: 4841 3531 3220 6861 7368 0a2a 2073 6c65 HA512 hash.* sle │ │ │ │ │ +00029190: 6570 3a3a 2020 2020 2020 2020 2020 2020 ep:: │ │ │ │ │ +000291a0: 2020 2020 2020 2020 2020 2057 6169 7420 Wait │ │ │ │ │ +000291b0: 666f 7220 6120 7370 6563 6966 6965 6420 for a specified │ │ │ │ │ +000291c0: 6e75 6d62 6572 206f 6620 7365 636f 6e64 number of second │ │ │ │ │ +000291d0: 730a 2a20 736d 6269 6f73 3a3a 2020 2020 s.* smbios:: │ │ │ │ │ 000291e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000291f0: 2020 2020 5265 7472 6965 7665 2053 4d42 Retrieve SMB │ │ │ │ │ -00029200: 494f 5320 696e 666f 726d 6174 696f 6e0a IOS information. │ │ │ │ │ -00029210: 2a20 736f 7572 6365 3a3a 2020 2020 2020 * source:: │ │ │ │ │ -00029220: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00029230: 5265 6164 2061 2063 6f6e 6669 6775 7261 Read a configura │ │ │ │ │ -00029240: 7469 6f6e 2066 696c 6520 696e 2073 616d tion file in sam │ │ │ │ │ -00029250: 6520 636f 6e74 6578 740a 2a20 7465 7374 e context.* test │ │ │ │ │ -00029260: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ │ -00029270: 2020 2020 2020 2020 2020 4368 6563 6b20 Check │ │ │ │ │ -00029280: 6669 6c65 2074 7970 6573 2061 6e64 2063 file types and c │ │ │ │ │ -00029290: 6f6d 7061 7265 2076 616c 7565 730a 2a20 ompare values.* │ │ │ │ │ -000292a0: 7472 7565 3a3a 2020 2020 2020 2020 2020 true:: │ │ │ │ │ -000292b0: 2020 2020 2020 2020 2020 2020 2020 446f Do │ │ │ │ │ -000292c0: 206e 6f74 6869 6e67 2c20 7375 6363 6573 nothing, succes │ │ │ │ │ -000292d0: 7366 756c 6c79 0a2a 2074 7275 7374 3a3a sfully.* trust:: │ │ │ │ │ +000291f0: 2020 5265 7472 6965 7665 2053 4d42 494f Retrieve SMBIO │ │ │ │ │ +00029200: 5320 696e 666f 726d 6174 696f 6e0a 2a20 S information.* │ │ │ │ │ +00029210: 736f 7572 6365 3a3a 2020 2020 2020 2020 source:: │ │ │ │ │ +00029220: 2020 2020 2020 2020 2020 2020 2020 5265 Re │ │ │ │ │ +00029230: 6164 2061 2063 6f6e 6669 6775 7261 7469 ad a configurati │ │ │ │ │ +00029240: 6f6e 2066 696c 6520 696e 2073 616d 6520 on file in same │ │ │ │ │ +00029250: 636f 6e74 6578 740a 2a20 7465 7374 3a3a context.* test:: │ │ │ │ │ +00029260: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00029270: 2020 2020 2020 2020 4368 6563 6b20 6669 Check fi │ │ │ │ │ +00029280: 6c65 2074 7970 6573 2061 6e64 2063 6f6d le types and com │ │ │ │ │ +00029290: 7061 7265 2076 616c 7565 730a 2a20 7472 pare values.* tr │ │ │ │ │ +000292a0: 7565 3a3a 2020 2020 2020 2020 2020 2020 ue:: │ │ │ │ │ +000292b0: 2020 2020 2020 2020 2020 2020 446f 206e Do n │ │ │ │ │ +000292c0: 6f74 6869 6e67 2c20 7375 6363 6573 7366 othing, successf │ │ │ │ │ +000292d0: 756c 6c79 0a2a 2074 7275 7374 3a3a 2020 ully.* trust:: │ │ │ │ │ 000292e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000292f0: 2020 2020 2020 2041 6464 2070 7562 6c69 Add publi │ │ │ │ │ -00029300: 6320 6b65 7920 746f 206c 6973 7420 6f66 c key to list of │ │ │ │ │ -00029310: 2074 7275 7374 6564 206b 6579 730a 2a20 trusted keys.* │ │ │ │ │ -00029320: 756e 7365 743a 3a20 2020 2020 2020 2020 unset:: │ │ │ │ │ -00029330: 2020 2020 2020 2020 2020 2020 2020 556e Un │ │ │ │ │ -00029340: 7365 7420 616e 2065 6e76 6972 6f6e 6d65 set an environme │ │ │ │ │ -00029350: 6e74 2076 6172 6961 626c 650a 2a20 7665 nt variable.* ve │ │ │ │ │ -00029360: 7269 6679 5f64 6574 6163 6865 643a 3a20 rify_detached:: │ │ │ │ │ -00029370: 2020 2020 2020 2020 2020 2020 5665 7269 Veri │ │ │ │ │ -00029380: 6679 2064 6574 6163 6865 6420 6469 6769 fy detached digi │ │ │ │ │ -00029390: 7461 6c20 7369 676e 6174 7572 650a 2a20 tal signature.* │ │ │ │ │ -000293a0: 7669 6465 6f69 6e66 6f3a 3a20 2020 2020 videoinfo:: │ │ │ │ │ -000293b0: 2020 2020 2020 2020 2020 2020 2020 4c69 Li │ │ │ │ │ -000293c0: 7374 2061 7661 696c 6162 6c65 2076 6964 st available vid │ │ │ │ │ -000293d0: 656f 206d 6f64 6573 0a2a 2077 726d 7372 eo modes.* wrmsr │ │ │ │ │ -000293e0: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ │ -000293f0: 2020 2020 2020 2020 2057 7269 7465 2076 Write v │ │ │ │ │ -00029400: 616c 7565 7320 746f 206d 6f64 656c 2d73 alues to model-s │ │ │ │ │ -00029410: 7065 6369 6669 6320 7265 6769 7374 6572 pecific register │ │ │ │ │ -00029420: 730a 2a20 7865 6e5f 6879 7065 7276 6973 s.* xen_hypervis │ │ │ │ │ -00029430: 6f72 3a3a 2020 2020 2020 2020 2020 2020 or:: │ │ │ │ │ -00029440: 2020 4c6f 6164 2078 656e 2068 7970 6572 Load xen hyper │ │ │ │ │ -00029450: 7669 736f 7220 6269 6e61 7279 2028 6f6e visor binary (on │ │ │ │ │ -00029460: 6c79 206f 6e20 4141 7263 6836 3429 0a2a ly on AArch64).* │ │ │ │ │ -00029470: 2078 656e 5f6d 6f64 756c 653a 3a20 2020 xen_module:: │ │ │ │ │ -00029480: 2020 2020 2020 2020 2020 2020 2020 204c L │ │ │ │ │ -00029490: 6f61 6420 7865 6e20 6d6f 6475 6c65 7320 oad xen modules │ │ │ │ │ -000294a0: 666f 7220 7865 6e20 6879 7065 7276 6973 for xen hypervis │ │ │ │ │ -000294b0: 6f72 2028 6f6e 6c79 206f 6e20 4141 7263 or (only on AArc │ │ │ │ │ -000294c0: 6836 3429 0a0a 1f0a 4669 6c65 3a20 6772 h64)....File: gr │ │ │ │ │ -000294d0: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ -000294e0: 5b2c 2020 4e65 7874 3a20 6163 7069 2c20 [, Next: acpi, │ │ │ │ │ -000294f0: 2055 703a 2043 6f6d 6d61 6e64 2d6c 696e Up: Command-lin │ │ │ │ │ -00029500: 6520 616e 6420 6d65 6e75 2065 6e74 7279 e and menu entry │ │ │ │ │ -00029510: 2063 6f6d 6d61 6e64 730a 0a31 362e 332e commands..16.3. │ │ │ │ │ -00029520: 3120 5b0a 2d2d 2d2d 2d2d 2d2d 0a0a 202d 1 [.--------.. - │ │ │ │ │ -00029530: 2d20 436f 6d6d 616e 643a 205b 2065 7870 - Command: [ exp │ │ │ │ │ -00029540: 7265 7373 696f 6e20 5d0a 2020 2020 2041 ression ]. A │ │ │ │ │ -00029550: 6c69 6173 2066 6f72 2027 7465 7374 2045 lias for 'test E │ │ │ │ │ -00029560: 5850 5245 5353 494f 4e27 2028 2a6e 6f74 XPRESSION' (*not │ │ │ │ │ -00029570: 6520 7465 7374 3a3a 292e 0a0a 1f0a 4669 e test::).....Fi │ │ │ │ │ -00029580: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ -00029590: 4e6f 6465 3a20 6163 7069 2c20 204e 6578 Node: acpi, Nex │ │ │ │ │ -000295a0: 743a 2061 7574 6865 6e74 6963 6174 652c t: authenticate, │ │ │ │ │ -000295b0: 2020 5072 6576 3a20 5b2c 2020 5570 3a20 Prev: [, Up: │ │ │ │ │ -000295c0: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ -000295d0: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ │ -000295e0: 616e 6473 0a0a 3136 2e33 2e32 2061 6370 ands..16.3.2 acp │ │ │ │ │ -000295f0: 690a 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 i.-----------.. │ │ │ │ │ -00029600: 2d2d 2043 6f6d 6d61 6e64 3a20 6163 7069 -- Command: acpi │ │ │ │ │ -00029610: 205b 2d31 7c2d 325d 205b 2d2d 6578 636c [-1|-2] [--excl │ │ │ │ │ -00029620: 7564 653d 7461 626c 6531 2c2e 2e2e 7c2d ude=table1,...|- │ │ │ │ │ -00029630: 2d6c 6f61 642d 6f6e 6c79 3d74 6162 6c65 -load-only=table │ │ │ │ │ -00029640: 312c 2e2e 2e5d 0a20 2020 2020 2020 2020 1,...]. │ │ │ │ │ -00029650: 205b 2d2d 6f65 6d69 643d 6964 5d20 5b2d [--oemid=id] [- │ │ │ │ │ -00029660: 2d6f 656d 7461 626c 653d 7461 626c 655d -oemtable=table] │ │ │ │ │ -00029670: 205b 2d2d 6f65 6d74 6162 6c65 7265 763d [--oemtablerev= │ │ │ │ │ -00029680: 7265 765d 0a20 2020 2020 2020 2020 205b rev]. [ │ │ │ │ │ -00029690: 2d2d 6f65 6d74 6162 6c65 6372 6561 746f --oemtablecreato │ │ │ │ │ -000296a0: 723d 6372 6561 746f 725d 205b 2d2d 6f65 r=creator] [--oe │ │ │ │ │ -000296b0: 6d74 6162 6c65 6372 6561 746f 7272 6576 mtablecreatorrev │ │ │ │ │ -000296c0: 3d72 6576 5d0a 2020 2020 2020 2020 2020 =rev]. │ │ │ │ │ -000296d0: 5b2d 2d6e 6f2d 6562 6461 5d20 6669 6c65 [--no-ebda] file │ │ │ │ │ -000296e0: 6e61 6d65 202e 2e2e 0a20 2020 2020 4d6f name .... Mo │ │ │ │ │ -000296f0: 6465 726e 2042 494f 5320 7379 7374 656d dern BIOS system │ │ │ │ │ -00029700: 7320 6e6f 726d 616c 6c79 2069 6d70 6c65 s normally imple │ │ │ │ │ -00029710: 6d65 6e74 2074 6865 2041 6476 616e 6365 ment the Advance │ │ │ │ │ -00029720: 6420 436f 6e66 6967 7572 6174 696f 6e0a d Configuration. │ │ │ │ │ -00029730: 2020 2020 2061 6e64 2050 6f77 6572 2049 and Power I │ │ │ │ │ -00029740: 6e74 6572 6661 6365 2028 4143 5049 292c nterface (ACPI), │ │ │ │ │ -00029750: 2061 6e64 2064 6566 696e 6520 7661 7269 and define vari │ │ │ │ │ -00029760: 6f75 7320 7461 626c 6573 2074 6861 7420 ous tables that │ │ │ │ │ -00029770: 6465 7363 7269 6265 0a20 2020 2020 7468 describe. th │ │ │ │ │ -00029780: 6520 696e 7465 7266 6163 6520 6265 7477 e interface betw │ │ │ │ │ -00029790: 6565 6e20 616e 2041 4350 492d 636f 6d70 een an ACPI-comp │ │ │ │ │ -000297a0: 6c69 616e 7420 6f70 6572 6174 696e 6720 liant operating │ │ │ │ │ -000297b0: 7379 7374 656d 2061 6e64 2074 6865 0a20 system and the. │ │ │ │ │ -000297c0: 2020 2020 6669 726d 7761 7265 2e20 2049 firmware. I │ │ │ │ │ -000297d0: 6e20 736f 6d65 2063 6173 6573 2c20 7468 n some cases, th │ │ │ │ │ -000297e0: 6520 7461 626c 6573 2070 726f 7669 6465 e tables provide │ │ │ │ │ -000297f0: 6420 6279 2064 6566 6175 6c74 206f 6e6c d by default onl │ │ │ │ │ -00029800: 7920 776f 726b 0a20 2020 2020 7765 6c6c y work. well │ │ │ │ │ -00029810: 2077 6974 6820 6365 7274 6169 6e20 6f70 with certain op │ │ │ │ │ -00029820: 6572 6174 696e 6720 7379 7374 656d 732c erating systems, │ │ │ │ │ -00029830: 2061 6e64 2069 7420 6d61 7920 6265 206e and it may be n │ │ │ │ │ -00029840: 6563 6573 7361 7279 2074 6f0a 2020 2020 ecessary to. │ │ │ │ │ -00029850: 2072 6570 6c61 6365 2073 6f6d 6520 6f66 replace some of │ │ │ │ │ -00029860: 2074 6865 6d2e 0a0a 2020 2020 204e 6f72 them... Nor │ │ │ │ │ -00029870: 6d61 6c6c 792c 2074 6869 7320 636f 6d6d mally, this comm │ │ │ │ │ -00029880: 616e 6420 7769 6c6c 2072 6570 6c61 6365 and will replace │ │ │ │ │ -00029890: 2074 6865 2052 6f6f 7420 5379 7374 656d the Root System │ │ │ │ │ -000298a0: 2044 6573 6372 6970 7469 6f6e 0a20 2020 Description. │ │ │ │ │ -000298b0: 2020 506f 696e 7465 7220 2852 5344 5029 Pointer (RSDP) │ │ │ │ │ -000298c0: 2069 6e20 7468 6520 4578 7465 6e64 6564 in the Extended │ │ │ │ │ -000298d0: 2042 494f 5320 4461 7461 2041 7265 6120 BIOS Data Area │ │ │ │ │ -000298e0: 746f 2070 6f69 6e74 2074 6f20 7468 6520 to point to the │ │ │ │ │ -000298f0: 6e65 770a 2020 2020 2074 6162 6c65 732e new. tables. │ │ │ │ │ -00029900: 2020 4966 2074 6865 2027 2d2d 6e6f 2d65 If the '--no-e │ │ │ │ │ -00029910: 6264 6127 206f 7074 696f 6e20 6973 2075 bda' option is u │ │ │ │ │ -00029920: 7365 642c 2074 6865 206e 6577 2074 6162 sed, the new tab │ │ │ │ │ -00029930: 6c65 7320 7769 6c6c 2062 650a 2020 2020 les will be. │ │ │ │ │ -00029940: 206b 6e6f 776e 206f 6e6c 7920 746f 2047 known only to G │ │ │ │ │ -00029950: 5255 422c 2062 7574 206d 6179 2062 6520 RUB, but may be │ │ │ │ │ -00029960: 7573 6564 2062 7920 4752 5542 2773 2045 used by GRUB's E │ │ │ │ │ -00029970: 4649 2065 6d75 6c61 7469 6f6e 2e0a 0a20 FI emulation... │ │ │ │ │ -00029980: 2020 2020 4e6f 7465 3a20 5468 6520 636f Note: The co │ │ │ │ │ -00029990: 6d6d 616e 6420 6973 206e 6f74 2061 6c6c mmand is not all │ │ │ │ │ -000299a0: 6f77 6564 2077 6865 6e20 6c6f 636b 646f owed when lockdo │ │ │ │ │ -000299b0: 776e 2069 7320 656e 666f 7263 6564 2028 wn is enforced ( │ │ │ │ │ -000299c0: 2a6e 6f74 650a 2020 2020 204c 6f63 6b64 *note. Lockd │ │ │ │ │ -000299d0: 6f77 6e3a 3a29 2e20 204f 7468 6572 7769 own::). Otherwi │ │ │ │ │ -000299e0: 7365 2061 6e20 6174 7461 636b 6572 2063 se an attacker c │ │ │ │ │ -000299f0: 616e 2069 6e73 7472 7563 7420 7468 6520 an instruct the │ │ │ │ │ -00029a00: 4752 5542 2074 6f20 6c6f 6164 0a20 2020 GRUB to load. │ │ │ │ │ -00029a10: 2020 616e 2053 5344 5420 7461 626c 6520 an SSDT table │ │ │ │ │ -00029a20: 746f 206f 7665 7277 7269 7465 2074 6865 to overwrite the │ │ │ │ │ -00029a30: 206b 6572 6e65 6c20 6c6f 636b 646f 776e kernel lockdown │ │ │ │ │ -00029a40: 2063 6f6e 6669 6775 7261 7469 6f6e 2061 configuration a │ │ │ │ │ -00029a50: 6e64 0a20 2020 2020 6c61 7465 7220 6c6f nd. later lo │ │ │ │ │ -00029a60: 6164 2061 6e64 2065 7865 6375 7465 2075 ad and execute u │ │ │ │ │ -00029a70: 6e73 6967 6e65 6420 636f 6465 2e0a 0a1f nsigned code.... │ │ │ │ │ -00029a80: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ -00029a90: 2c20 204e 6f64 653a 2061 7574 6865 6e74 , Node: authent │ │ │ │ │ -00029aa0: 6963 6174 652c 2020 4e65 7874 3a20 6261 icate, Next: ba │ │ │ │ │ -00029ab0: 636b 6772 6f75 6e64 5f63 6f6c 6f72 2c20 ckground_color, │ │ │ │ │ -00029ac0: 2050 7265 763a 2061 6370 692c 2020 5570 Prev: acpi, Up │ │ │ │ │ -00029ad0: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ │ -00029ae0: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ │ -00029af0: 6d6d 616e 6473 0a0a 3136 2e33 2e33 2061 mmands..16.3.3 a │ │ │ │ │ -00029b00: 7574 6865 6e74 6963 6174 650a 2d2d 2d2d uthenticate.---- │ │ │ │ │ -00029b10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ -00029b20: 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 6175 . -- Command: au │ │ │ │ │ -00029b30: 7468 656e 7469 6361 7465 205b 7573 6572 thenticate [user │ │ │ │ │ -00029b40: 6c69 7374 5d0a 2020 2020 2043 6865 636b list]. Check │ │ │ │ │ -00029b50: 2077 6865 7468 6572 2075 7365 7220 6973 whether user is │ │ │ │ │ -00029b60: 2069 6e20 5553 4552 4c49 5354 206f 7220 in USERLIST or │ │ │ │ │ -00029b70: 6c69 7374 6564 2069 6e20 7468 6520 7661 listed in the va │ │ │ │ │ -00029b80: 6c75 6520 6f66 0a20 2020 2020 7661 7269 lue of. vari │ │ │ │ │ -00029b90: 6162 6c65 2027 7375 7065 7275 7365 7273 able 'superusers │ │ │ │ │ -00029ba0: 272e 2020 5365 6520 2a6e 6f74 6520 7375 '. See *note su │ │ │ │ │ -00029bb0: 7065 7275 7365 7273 3a3a 2066 6f72 2076 perusers:: for v │ │ │ │ │ -00029bc0: 616c 6964 2075 7365 7220 6c69 7374 0a20 alid user list. │ │ │ │ │ -00029bd0: 2020 2020 666f 726d 6174 2e20 2049 6620 format. If │ │ │ │ │ -00029be0: 2773 7570 6572 7573 6572 7327 2069 7320 'superusers' is │ │ │ │ │ -00029bf0: 656d 7074 792c 2074 6869 7320 636f 6d6d empty, this comm │ │ │ │ │ -00029c00: 616e 6420 7265 7475 726e 7320 7472 7565 and returns true │ │ │ │ │ -00029c10: 2e0a 2020 2020 202a 4e6f 7465 2053 6563 .. *Note Sec │ │ │ │ │ -00029c20: 7572 6974 793a 3a2e 0a0a 1f0a 4669 6c65 urity::.....File │ │ │ │ │ -00029c30: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ -00029c40: 6465 3a20 6261 636b 6772 6f75 6e64 5f63 de: background_c │ │ │ │ │ -00029c50: 6f6c 6f72 2c20 204e 6578 743a 2062 6163 olor, Next: bac │ │ │ │ │ -00029c60: 6b67 726f 756e 645f 696d 6167 652c 2020 kground_image, │ │ │ │ │ -00029c70: 5072 6576 3a20 6175 7468 656e 7469 6361 Prev: authentica │ │ │ │ │ -00029c80: 7465 2c20 2055 703a 2043 6f6d 6d61 6e64 te, Up: Command │ │ │ │ │ -00029c90: 2d6c 696e 6520 616e 6420 6d65 6e75 2065 -line and menu e │ │ │ │ │ -00029ca0: 6e74 7279 2063 6f6d 6d61 6e64 730a 0a31 ntry commands..1 │ │ │ │ │ -00029cb0: 362e 332e 3420 6261 636b 6772 6f75 6e64 6.3.4 background │ │ │ │ │ -00029cc0: 5f63 6f6c 6f72 0a2d 2d2d 2d2d 2d2d 2d2d _color.--------- │ │ │ │ │ -00029cd0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ -00029ce0: 202d 2d20 436f 6d6d 616e 643a 2062 6163 -- Command: bac │ │ │ │ │ -00029cf0: 6b67 726f 756e 645f 636f 6c6f 7220 636f kground_color co │ │ │ │ │ -00029d00: 6c6f 720a 2020 2020 2053 6574 2062 6163 lor. Set bac │ │ │ │ │ -00029d10: 6b67 726f 756e 6420 636f 6c6f 7220 666f kground color fo │ │ │ │ │ -00029d20: 7220 6163 7469 7665 2074 6572 6d69 6e61 r active termina │ │ │ │ │ -00029d30: 6c2e 2020 466f 7220 7661 6c69 6420 636f l. For valid co │ │ │ │ │ -00029d40: 6c6f 720a 2020 2020 2073 7065 6369 6669 lor. specifi │ │ │ │ │ -00029d50: 6361 7469 6f6e 7320 7365 6520 2a6e 6f74 cations see *not │ │ │ │ │ -00029d60: 6520 436f 6c6f 7273 3a20 5468 656d 6520 e Colors: Theme │ │ │ │ │ -00029d70: 6669 6c65 2066 6f72 6d61 742e 2020 4261 file format. Ba │ │ │ │ │ -00029d80: 636b 6772 6f75 6e64 0a20 2020 2020 636f ckground. co │ │ │ │ │ -00029d90: 6c6f 7220 6361 6e20 6265 2063 6861 6e67 lor can be chang │ │ │ │ │ -00029da0: 6564 206f 6e6c 7920 7768 656e 2075 7369 ed only when usi │ │ │ │ │ -00029db0: 6e67 2027 6766 7874 6572 6d27 2066 6f72 ng 'gfxterm' for │ │ │ │ │ -00029dc0: 2074 6572 6d69 6e61 6c20 6f75 7470 7574 terminal output │ │ │ │ │ -00029dd0: 2e0a 0a20 2020 2020 5468 6973 2063 6f6d ... This com │ │ │ │ │ -00029de0: 6d61 6e64 2073 6574 7320 636f 6c6f 7220 mand sets color │ │ │ │ │ -00029df0: 6f66 2065 6d70 7479 2061 7265 6173 2077 of empty areas w │ │ │ │ │ -00029e00: 6974 686f 7574 2074 6578 742e 2020 5465 ithout text. Te │ │ │ │ │ -00029e10: 7874 0a20 2020 2020 6261 636b 6772 6f75 xt. backgrou │ │ │ │ │ -00029e20: 6e64 2063 6f6c 6f72 2069 7320 636f 6e74 nd color is cont │ │ │ │ │ -00029e30: 726f 6c6c 6564 2062 7920 656e 7669 726f rolled by enviro │ │ │ │ │ -00029e40: 6e6d 656e 7420 7661 7269 6162 6c65 730a nment variables. │ │ │ │ │ -00029e50: 2020 2020 2043 4f4c 4f52 5f4e 4f52 4d41 COLOR_NORMA │ │ │ │ │ -00029e60: 4c2c 2043 4f4c 4f52 5f48 4947 484c 4947 L, COLOR_HIGHLIG │ │ │ │ │ -00029e70: 4854 2c20 4d45 4e55 5f43 4f4c 4f52 5f4e HT, MENU_COLOR_N │ │ │ │ │ -00029e80: 4f52 4d41 4c2c 0a20 2020 2020 4d45 4e55 ORMAL,. MENU │ │ │ │ │ -00029e90: 5f43 4f4c 4f52 5f48 4947 484c 4947 4854 _COLOR_HIGHLIGHT │ │ │ │ │ -00029ea0: 2e20 202a 4e6f 7465 2053 7065 6369 616c . *Note Special │ │ │ │ │ -00029eb0: 2065 6e76 6972 6f6e 6d65 6e74 2076 6172 environment var │ │ │ │ │ -00029ec0: 6961 626c 6573 3a3a 2e0a 0a1f 0a46 696c iables::.....Fil │ │ │ │ │ -00029ed0: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ -00029ee0: 6f64 653a 2062 6163 6b67 726f 756e 645f ode: background_ │ │ │ │ │ -00029ef0: 696d 6167 652c 2020 4e65 7874 3a20 6261 image, Next: ba │ │ │ │ │ -00029f00: 6472 616d 2c20 2050 7265 763a 2062 6163 dram, Prev: bac │ │ │ │ │ -00029f10: 6b67 726f 756e 645f 636f 6c6f 722c 2020 kground_color, │ │ │ │ │ -00029f20: 5570 3a20 436f 6d6d 616e 642d 6c69 6e65 Up: Command-line │ │ │ │ │ -00029f30: 2061 6e64 206d 656e 7520 656e 7472 7920 and menu entry │ │ │ │ │ -00029f40: 636f 6d6d 616e 6473 0a0a 3136 2e33 2e35 commands..16.3.5 │ │ │ │ │ -00029f50: 2062 6163 6b67 726f 756e 645f 696d 6167 background_imag │ │ │ │ │ -00029f60: 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d e.-------------- │ │ │ │ │ -00029f70: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 ---------.. -- C │ │ │ │ │ -00029f80: 6f6d 6d61 6e64 3a20 6261 636b 6772 6f75 ommand: backgrou │ │ │ │ │ -00029f90: 6e64 5f69 6d61 6765 205b 5b2d 2d6d 6f64 nd_image [[--mod │ │ │ │ │ -00029fa0: 6520 7374 7265 7463 687c 6e6f 726d 616c e stretch|normal │ │ │ │ │ -00029fb0: 5d20 6669 6c65 5d0a 2020 2020 204c 6f61 ] file]. Loa │ │ │ │ │ -00029fc0: 6420 6261 636b 6772 6f75 6e64 2069 6d61 d background ima │ │ │ │ │ -00029fd0: 6765 2066 6f72 2061 6374 6976 6520 7465 ge for active te │ │ │ │ │ -00029fe0: 726d 696e 616c 2066 726f 6d20 4649 4c45 rminal from FILE │ │ │ │ │ -00029ff0: 2e20 2049 6d61 6765 2069 730a 2020 2020 . Image is. │ │ │ │ │ -0002a000: 2073 7472 6574 6368 6564 2074 6f20 6669 stretched to fi │ │ │ │ │ -0002a010: 6c6c 2075 7020 656e 7469 7265 2073 6372 ll up entire scr │ │ │ │ │ -0002a020: 6565 6e20 756e 6c65 7373 206f 7074 696f een unless optio │ │ │ │ │ -0002a030: 6e20 272d 2d6d 6f64 6527 2027 6e6f 726d n '--mode' 'norm │ │ │ │ │ -0002a040: 616c 270a 2020 2020 2069 7320 6769 7665 al'. is give │ │ │ │ │ -0002a050: 6e2e 2020 5769 7468 6f75 7420 6172 6775 n. Without argu │ │ │ │ │ -0002a060: 6d65 6e74 7320 7265 6d6f 7665 2063 7572 ments remove cur │ │ │ │ │ -0002a070: 7265 6e74 6c79 206c 6f61 6465 6420 6261 rently loaded ba │ │ │ │ │ -0002a080: 636b 6772 6f75 6e64 0a20 2020 2020 696d ckground. im │ │ │ │ │ -0002a090: 6167 652e 2020 4261 636b 6772 6f75 6e64 age. Background │ │ │ │ │ -0002a0a0: 2069 6d61 6765 2063 616e 2062 6520 6368 image can be ch │ │ │ │ │ -0002a0b0: 616e 6765 6420 6f6e 6c79 2077 6865 6e20 anged only when │ │ │ │ │ -0002a0c0: 7573 696e 6720 2767 6678 7465 726d 270a using 'gfxterm'. │ │ │ │ │ -0002a0d0: 2020 2020 2066 6f72 2074 6572 6d69 6e61 for termina │ │ │ │ │ -0002a0e0: 6c20 6f75 7470 7574 2e0a 0a1f 0a46 696c l output.....Fil │ │ │ │ │ -0002a0f0: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ -0002a100: 6f64 653a 2062 6164 7261 6d2c 2020 4e65 ode: badram, Ne │ │ │ │ │ -0002a110: 7874 3a20 626c 6f63 6b6c 6973 742c 2020 xt: blocklist, │ │ │ │ │ -0002a120: 5072 6576 3a20 6261 636b 6772 6f75 6e64 Prev: background │ │ │ │ │ -0002a130: 5f69 6d61 6765 2c20 2055 703a 2043 6f6d _image, Up: Com │ │ │ │ │ -0002a140: 6d61 6e64 2d6c 696e 6520 616e 6420 6d65 mand-line and me │ │ │ │ │ -0002a150: 6e75 2065 6e74 7279 2063 6f6d 6d61 6e64 nu entry command │ │ │ │ │ -0002a160: 730a 0a31 362e 332e 3620 6261 6472 616d s..16.3.6 badram │ │ │ │ │ -0002a170: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a .-------------.. │ │ │ │ │ -0002a180: 202d 2d20 436f 6d6d 616e 643a 2062 6164 -- Command: bad │ │ │ │ │ -0002a190: 7261 6d20 6164 6472 2c6d 6173 6b5b 2c61 ram addr,mask[,a │ │ │ │ │ -0002a1a0: 6464 722c 6d61 736b 2e2e 2e5d 0a20 2020 ddr,mask...]. │ │ │ │ │ -0002a1b0: 2020 4669 6c74 6572 206f 7574 2062 6164 Filter out bad │ │ │ │ │ -0002a1c0: 2052 414d 2e0a 0a20 2020 2020 5468 6973 RAM... This │ │ │ │ │ -0002a1d0: 2063 6f6d 6d61 6e64 206e 6f74 6966 6965 command notifie │ │ │ │ │ -0002a1e0: 7320 7468 6520 6d65 6d6f 7279 206d 616e s the memory man │ │ │ │ │ -0002a1f0: 6167 6572 2074 6861 7420 7370 6563 6966 ager that specif │ │ │ │ │ -0002a200: 6965 6420 7265 6769 6f6e 7320 6f66 0a20 ied regions of. │ │ │ │ │ -0002a210: 2020 2020 5241 4d20 6f75 6768 7420 746f RAM ought to │ │ │ │ │ -0002a220: 2062 6520 6669 6c74 6572 6564 206f 7574 be filtered out │ │ │ │ │ -0002a230: 2028 7573 7561 6c6c 792c 2062 6563 6175 (usually, becau │ │ │ │ │ -0002a240: 7365 2074 6865 7927 7265 2064 616d 6167 se they're damag │ │ │ │ │ -0002a250: 6564 292e 0a20 2020 2020 5468 6973 2072 ed).. This r │ │ │ │ │ -0002a260: 656d 6169 6e73 2069 6e20 6566 6665 6374 emains in effect │ │ │ │ │ -0002a270: 2061 6674 6572 2061 2070 6179 6c6f 6164 after a payload │ │ │ │ │ -0002a280: 206b 6572 6e65 6c20 6861 7320 6265 656e kernel has been │ │ │ │ │ -0002a290: 206c 6f61 6465 6420 6279 0a20 2020 2020 loaded by. │ │ │ │ │ -0002a2a0: 4752 5542 2c20 6173 206c 6f6e 6720 6173 GRUB, as long as │ │ │ │ │ -0002a2b0: 2074 6865 206c 6f61 6465 6420 6b65 726e the loaded kern │ │ │ │ │ -0002a2c0: 656c 206f 6274 6169 6e73 2069 7473 206d el obtains its m │ │ │ │ │ -0002a2d0: 656d 6f72 7920 6d61 7020 6672 6f6d 0a20 emory map from. │ │ │ │ │ -0002a2e0: 2020 2020 4752 5542 2e20 4b65 726e 656c GRUB. Kernel │ │ │ │ │ -0002a2f0: 7320 7468 6174 2073 7570 706f 7274 2074 s that support t │ │ │ │ │ -0002a300: 6869 7320 696e 636c 7564 6520 4c69 6e75 his include Linu │ │ │ │ │ -0002a310: 782c 2047 4e55 204d 6163 682c 2074 6865 x, GNU Mach, the │ │ │ │ │ -0002a320: 206b 6572 6e65 6c0a 2020 2020 206f 6620 kernel. of │ │ │ │ │ -0002a330: 4672 6565 4253 4420 616e 6420 4d75 6c74 FreeBSD and Mult │ │ │ │ │ -0002a340: 6962 6f6f 7420 6b65 726e 656c 7320 696e iboot kernels in │ │ │ │ │ -0002a350: 2067 656e 6572 616c 2e0a 0a20 2020 2020 general... │ │ │ │ │ -0002a360: 5379 6e74 6178 2069 7320 7468 6520 7361 Syntax is the sa │ │ │ │ │ -0002a370: 6d65 2061 7320 7072 6f76 6964 6564 2062 me as provided b │ │ │ │ │ -0002a380: 7920 7468 6520 4d65 6d74 6573 7438 362b y the Memtest86+ │ │ │ │ │ -0002a390: 2075 7469 6c69 7479 0a20 2020 2020 2868 utility. (h │ │ │ │ │ -0002a3a0: 7474 703a 2f2f 7777 772e 6d65 6d74 6573 ttp://www.memtes │ │ │ │ │ -0002a3b0: 742e 6f72 672f 293a 2061 206c 6973 7420 t.org/): a list │ │ │ │ │ -0002a3c0: 6f66 2061 6464 7265 7373 2f6d 6173 6b20 of address/mask │ │ │ │ │ -0002a3d0: 7061 6972 732e 2020 4769 7665 6e20 610a pairs. Given a. │ │ │ │ │ -0002a3e0: 2020 2020 2070 6167 652d 616c 6967 6e65 page-aligne │ │ │ │ │ -0002a3f0: 6420 6164 6472 6573 7320 616e 6420 6120 d address and a │ │ │ │ │ -0002a400: 6261 7365 2061 6464 7265 7373 202f 206d base address / m │ │ │ │ │ -0002a410: 6173 6b20 7061 6972 2c20 6966 2061 6c6c ask pair, if all │ │ │ │ │ -0002a420: 2074 6865 0a20 2020 2020 6269 7473 206f the. bits o │ │ │ │ │ -0002a430: 6620 7468 6520 7061 6765 2d61 6c69 676e f the page-align │ │ │ │ │ -0002a440: 6564 2061 6464 7265 7373 2074 6861 7420 ed address that │ │ │ │ │ -0002a450: 6172 6520 656e 6162 6c65 6420 6279 2074 are enabled by t │ │ │ │ │ -0002a460: 6865 206d 6173 6b20 6d61 7463 680a 2020 he mask match. │ │ │ │ │ -0002a470: 2020 2077 6974 6820 7468 6520 6261 7365 with the base │ │ │ │ │ -0002a480: 2061 6464 7265 7373 2c20 6974 206d 6561 address, it mea │ │ │ │ │ -0002a490: 6e73 2074 6869 7320 7061 6765 2069 7320 ns this page is │ │ │ │ │ -0002a4a0: 746f 2062 6520 6669 6c74 6572 6564 2e20 to be filtered. │ │ │ │ │ -0002a4b0: 2054 6869 730a 2020 2020 2073 796e 7461 This. synta │ │ │ │ │ -0002a4c0: 7820 6d61 6b65 7320 6974 2065 6173 7920 x makes it easy │ │ │ │ │ -0002a4d0: 746f 2072 6570 7265 7365 6e74 2070 6174 to represent pat │ │ │ │ │ -0002a4e0: 7465 726e 7320 7468 6174 2061 7265 206f terns that are o │ │ │ │ │ -0002a4f0: 6674 656e 2072 6573 756c 7420 6f66 0a20 ften result of. │ │ │ │ │ -0002a500: 2020 2020 6d65 6d6f 7279 2064 616d 6167 memory damag │ │ │ │ │ -0002a510: 652c 2064 7565 2074 6f20 7068 7973 6963 e, due to physic │ │ │ │ │ -0002a520: 616c 2064 6973 7472 6962 7574 696f 6e20 al distribution │ │ │ │ │ -0002a530: 6f66 206d 656d 6f72 7920 6365 6c6c 732e of memory cells. │ │ │ │ │ -0002a540: 0a0a 2020 2020 2054 6865 2063 6f6d 6d61 .. The comma │ │ │ │ │ -0002a550: 6e64 2069 7320 7369 6d69 6c61 7220 746f nd is similar to │ │ │ │ │ -0002a560: 2027 6375 746d 656d 2720 636f 6d6d 616e 'cutmem' comman │ │ │ │ │ -0002a570: 642e 0a0a 2020 2020 204e 6f74 653a 2054 d... Note: T │ │ │ │ │ -0002a580: 6865 2063 6f6d 6d61 6e64 2069 7320 6e6f he command is no │ │ │ │ │ -0002a590: 7420 616c 6c6f 7765 6420 7768 656e 206c t allowed when l │ │ │ │ │ -0002a5a0: 6f63 6b64 6f77 6e20 6973 2065 6e66 6f72 ockdown is enfor │ │ │ │ │ -0002a5b0: 6365 6420 282a 6e6f 7465 0a20 2020 2020 ced (*note. │ │ │ │ │ -0002a5c0: 4c6f 636b 646f 776e 3a3a 292e 2020 5468 Lockdown::). Th │ │ │ │ │ -0002a5d0: 6973 2070 7265 7665 6e74 7320 7265 6d6f is prevents remo │ │ │ │ │ -0002a5e0: 7669 6e67 2045 4649 206d 656d 6f72 7920 ving EFI memory │ │ │ │ │ -0002a5f0: 7265 6769 6f6e 7320 746f 0a20 2020 2020 regions to. │ │ │ │ │ -0002a600: 706f 7465 6e74 6961 6c6c 7920 7375 6276 potentially subv │ │ │ │ │ -0002a610: 6572 7420 7468 6520 7365 6375 7269 7479 ert the security │ │ │ │ │ -0002a620: 206d 6563 6861 6e69 736d 7320 7072 6f76 mechanisms prov │ │ │ │ │ -0002a630: 6964 6564 2062 7920 7468 6520 5545 4649 ided by the UEFI │ │ │ │ │ -0002a640: 0a20 2020 2020 7365 6375 7265 2062 6f6f . secure boo │ │ │ │ │ -0002a650: 742e 0a0a 1f0a 4669 6c65 3a20 6772 7562 t.....File: grub │ │ │ │ │ -0002a660: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 626c .info, Node: bl │ │ │ │ │ -0002a670: 6f63 6b6c 6973 742c 2020 4e65 7874 3a20 ocklist, Next: │ │ │ │ │ -0002a680: 626f 6f74 2c20 2050 7265 763a 2062 6164 boot, Prev: bad │ │ │ │ │ -0002a690: 7261 6d2c 2020 5570 3a20 436f 6d6d 616e ram, Up: Comman │ │ │ │ │ -0002a6a0: 642d 6c69 6e65 2061 6e64 206d 656e 7520 d-line and menu │ │ │ │ │ -0002a6b0: 656e 7472 7920 636f 6d6d 616e 6473 0a0a entry commands.. │ │ │ │ │ -0002a6c0: 3136 2e33 2e37 2062 6c6f 636b 6c69 7374 16.3.7 blocklist │ │ │ │ │ -0002a6d0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ │ -0002a6e0: 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 -.. -- Command: │ │ │ │ │ -0002a6f0: 626c 6f63 6b6c 6973 7420 6669 6c65 0a20 blocklist file. │ │ │ │ │ -0002a700: 2020 2020 5072 696e 7420 6120 626c 6f63 Print a bloc │ │ │ │ │ -0002a710: 6b20 6c69 7374 2028 2a6e 6f74 6520 426c k list (*note Bl │ │ │ │ │ -0002a720: 6f63 6b20 6c69 7374 2073 796e 7461 783a ock list syntax: │ │ │ │ │ -0002a730: 3a29 2066 6f72 2046 494c 452e 0a0a 1f0a :) for FILE..... │ │ │ │ │ -0002a740: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ -0002a750: 2020 4e6f 6465 3a20 626f 6f74 2c20 204e Node: boot, N │ │ │ │ │ -0002a760: 6578 743a 2063 6174 2c20 2050 7265 763a ext: cat, Prev: │ │ │ │ │ -0002a770: 2062 6c6f 636b 6c69 7374 2c20 2055 703a blocklist, Up: │ │ │ │ │ -0002a780: 2043 6f6d 6d61 6e64 2d6c 696e 6520 616e Command-line an │ │ │ │ │ -0002a790: 6420 6d65 6e75 2065 6e74 7279 2063 6f6d d menu entry com │ │ │ │ │ -0002a7a0: 6d61 6e64 730a 0a31 362e 332e 3820 626f mands..16.3.8 bo │ │ │ │ │ -0002a7b0: 6f74 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a ot.-----------.. │ │ │ │ │ -0002a7c0: 202d 2d20 436f 6d6d 616e 643a 2062 6f6f -- Command: boo │ │ │ │ │ -0002a7d0: 740a 2020 2020 2042 6f6f 7420 7468 6520 t. Boot the │ │ │ │ │ -0002a7e0: 4f53 206f 7220 6368 6169 6e2d 6c6f 6164 OS or chain-load │ │ │ │ │ -0002a7f0: 6572 2077 6869 6368 2068 6173 2062 6565 er which has bee │ │ │ │ │ -0002a800: 6e20 6c6f 6164 6564 2e20 204f 6e6c 7920 n loaded. Only │ │ │ │ │ -0002a810: 6e65 6365 7373 6172 790a 2020 2020 2069 necessary. i │ │ │ │ │ -0002a820: 6620 7275 6e6e 696e 6720 7468 6520 6675 f running the fu │ │ │ │ │ -0002a830: 6c6c 7920 696e 7465 7261 6374 6976 6520 lly interactive │ │ │ │ │ -0002a840: 636f 6d6d 616e 642d 6c69 6e65 2028 6974 command-line (it │ │ │ │ │ -0002a850: 2069 7320 696d 706c 6963 6974 2061 740a is implicit at. │ │ │ │ │ -0002a860: 2020 2020 2074 6865 2065 6e64 206f 6620 the end of │ │ │ │ │ -0002a870: 6120 6d65 6e75 2065 6e74 7279 292e 0a0a a menu entry)... │ │ │ │ │ -0002a880: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ -0002a890: 6f2c 2020 4e6f 6465 3a20 6361 742c 2020 o, Node: cat, │ │ │ │ │ -0002a8a0: 4e65 7874 3a20 6368 6169 6e6c 6f61 6465 Next: chainloade │ │ │ │ │ -0002a8b0: 722c 2020 5072 6576 3a20 626f 6f74 2c20 r, Prev: boot, │ │ │ │ │ -0002a8c0: 2055 703a 2043 6f6d 6d61 6e64 2d6c 696e Up: Command-lin │ │ │ │ │ -0002a8d0: 6520 616e 6420 6d65 6e75 2065 6e74 7279 e and menu entry │ │ │ │ │ -0002a8e0: 2063 6f6d 6d61 6e64 730a 0a31 362e 332e commands..16.3. │ │ │ │ │ -0002a8f0: 3920 6361 740a 2d2d 2d2d 2d2d 2d2d 2d2d 9 cat.---------- │ │ │ │ │ -0002a900: 0a0a 202d 2d20 436f 6d6d 616e 643a 2063 .. -- Command: c │ │ │ │ │ -0002a910: 6174 205b 2d2d 646f 735d 2066 696c 650a at [--dos] file. │ │ │ │ │ -0002a920: 2020 2020 2044 6973 706c 6179 2074 6865 Display the │ │ │ │ │ -0002a930: 2063 6f6e 7465 6e74 7320 6f66 2074 6865 contents of the │ │ │ │ │ -0002a940: 2066 696c 6520 4649 4c45 2e20 2054 6869 file FILE. Thi │ │ │ │ │ -0002a950: 7320 636f 6d6d 616e 6420 6d61 7920 6265 s command may be │ │ │ │ │ -0002a960: 2075 7365 6675 6c0a 2020 2020 2074 6f20 useful. to │ │ │ │ │ -0002a970: 7265 6d69 6e64 2079 6f75 206f 6620 796f remind you of yo │ │ │ │ │ -0002a980: 7572 204f 5327 7320 726f 6f74 2070 6172 ur OS's root par │ │ │ │ │ -0002a990: 7469 7469 6f6e 3a0a 0a20 2020 2020 2020 tition:.. │ │ │ │ │ -0002a9a0: 2020 2067 7275 623e 2063 6174 202f 6574 grub> cat /et │ │ │ │ │ -0002a9b0: 632f 6673 7461 620a 0a20 2020 2020 4966 c/fstab.. If │ │ │ │ │ -0002a9c0: 2074 6865 2027 2d2d 646f 7327 206f 7074 the '--dos' opt │ │ │ │ │ -0002a9d0: 696f 6e20 6973 2075 7365 642c 2074 6865 ion is used, the │ │ │ │ │ -0002a9e0: 6e20 6361 7272 6961 6765 2072 6574 7572 n carriage retur │ │ │ │ │ -0002a9f0: 6e20 2f20 6e65 7720 6c69 6e65 0a20 2020 n / new line. │ │ │ │ │ -0002aa00: 2020 7061 6972 7320 7769 6c6c 2062 6520 pairs will be │ │ │ │ │ -0002aa10: 6469 7370 6c61 7965 6420 6173 2061 2073 displayed as a s │ │ │ │ │ -0002aa20: 696d 706c 6520 6e65 7720 6c69 6e65 2e20 imple new line. │ │ │ │ │ -0002aa30: 204f 7468 6572 7769 7365 2c20 7468 650a Otherwise, the. │ │ │ │ │ -0002aa40: 2020 2020 2063 6172 7269 6167 6520 7265 carriage re │ │ │ │ │ -0002aa50: 7475 726e 2077 696c 6c20 6265 2064 6973 turn will be dis │ │ │ │ │ -0002aa60: 706c 6179 6564 2061 7320 6120 636f 6e74 played as a cont │ │ │ │ │ -0002aa70: 726f 6c20 6368 6172 6163 7465 7220 2827 rol character (' │ │ │ │ │ -0002aa80: 3c64 3e27 2920 746f 0a20 2020 2020 6d61 ') to. ma │ │ │ │ │ -0002aa90: 6b65 2069 7420 6561 7369 6572 2074 6f20 ke it easier to │ │ │ │ │ -0002aaa0: 7365 6520 7768 656e 2062 6f6f 7420 7072 see when boot pr │ │ │ │ │ -0002aab0: 6f62 6c65 6d73 2061 7265 2063 6175 7365 oblems are cause │ │ │ │ │ -0002aac0: 6420 6279 2061 2066 696c 650a 2020 2020 d by a file. │ │ │ │ │ -0002aad0: 2066 6f72 6d61 7474 6564 2075 7369 6e67 formatted using │ │ │ │ │ -0002aae0: 2044 4f53 2d73 7479 6c65 206c 696e 6520 DOS-style line │ │ │ │ │ -0002aaf0: 656e 6469 6e67 732e 0a0a 1f0a 4669 6c65 endings.....File │ │ │ │ │ -0002ab00: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ -0002ab10: 6465 3a20 6368 6169 6e6c 6f61 6465 722c de: chainloader, │ │ │ │ │ -0002ab20: 2020 4e65 7874 3a20 636c 6561 722c 2020 Next: clear, │ │ │ │ │ -0002ab30: 5072 6576 3a20 6361 742c 2020 5570 3a20 Prev: cat, Up: │ │ │ │ │ -0002ab40: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ -0002ab50: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ │ -0002ab60: 616e 6473 0a0a 3136 2e33 2e31 3020 6368 ands..16.3.10 ch │ │ │ │ │ -0002ab70: 6169 6e6c 6f61 6465 720a 2d2d 2d2d 2d2d ainloader.------ │ │ │ │ │ -0002ab80: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 -------------.. │ │ │ │ │ -0002ab90: 2d2d 2043 6f6d 6d61 6e64 3a20 6368 6169 -- Command: chai │ │ │ │ │ -0002aba0: 6e6c 6f61 6465 7220 5b2d 2d66 6f72 6365 nloader [--force │ │ │ │ │ -0002abb0: 5d20 6669 6c65 0a20 2020 2020 4c6f 6164 ] file. Load │ │ │ │ │ -0002abc0: 2046 494c 4520 6173 2061 2063 6861 696e FILE as a chain │ │ │ │ │ -0002abd0: 2d6c 6f61 6465 722e 2020 4c69 6b65 2061 -loader. Like a │ │ │ │ │ -0002abe0: 6e79 206f 7468 6572 2066 696c 6520 6c6f ny other file lo │ │ │ │ │ -0002abf0: 6164 6564 2062 7920 7468 650a 2020 2020 aded by the. │ │ │ │ │ -0002ac00: 2066 696c 6573 7973 7465 6d20 636f 6465 filesystem code │ │ │ │ │ -0002ac10: 2c20 6974 2063 616e 2075 7365 2074 6865 , it can use the │ │ │ │ │ -0002ac20: 2062 6c6f 636b 6c69 7374 206e 6f74 6174 blocklist notat │ │ │ │ │ -0002ac30: 696f 6e20 282a 6e6f 7465 2042 6c6f 636b ion (*note Block │ │ │ │ │ -0002ac40: 0a20 2020 2020 6c69 7374 2073 796e 7461 . list synta │ │ │ │ │ -0002ac50: 783a 3a29 2074 6f20 6772 6162 2074 6865 x::) to grab the │ │ │ │ │ -0002ac60: 2066 6972 7374 2073 6563 746f 7220 6f66 first sector of │ │ │ │ │ -0002ac70: 2074 6865 2063 7572 7265 6e74 2070 6172 the current par │ │ │ │ │ -0002ac80: 7469 7469 6f6e 0a20 2020 2020 7769 7468 tition. with │ │ │ │ │ -0002ac90: 2027 2b31 272e 2020 4966 2079 6f75 2073 '+1'. If you s │ │ │ │ │ -0002aca0: 7065 6369 6679 2074 6865 206f 7074 696f pecify the optio │ │ │ │ │ -0002acb0: 6e20 272d 2d66 6f72 6365 272c 2074 6865 n '--force', the │ │ │ │ │ -0002acc0: 6e20 6c6f 6164 2046 494c 450a 2020 2020 n load FILE. │ │ │ │ │ -0002acd0: 2066 6f72 6369 626c 792c 2077 6865 7468 forcibly, wheth │ │ │ │ │ -0002ace0: 6572 2069 7420 6861 7320 6120 636f 7272 er it has a corr │ │ │ │ │ -0002acf0: 6563 7420 7369 676e 6174 7572 6520 6f72 ect signature or │ │ │ │ │ -0002ad00: 206e 6f74 2e20 2054 6869 7320 6973 0a20 not. This is. │ │ │ │ │ -0002ad10: 2020 2020 7265 7175 6972 6564 2077 6865 required whe │ │ │ │ │ -0002ad20: 6e20 796f 7520 7761 6e74 2074 6f20 6c6f n you want to lo │ │ │ │ │ -0002ad30: 6164 2061 2064 6566 6563 7469 7665 2062 ad a defective b │ │ │ │ │ -0002ad40: 6f6f 7420 6c6f 6164 6572 2c20 7375 6368 oot loader, such │ │ │ │ │ -0002ad50: 2061 7320 5343 4f0a 2020 2020 2055 6e69 as SCO. Uni │ │ │ │ │ -0002ad60: 7857 6172 6520 372e 312e 0a0a 1f0a 4669 xWare 7.1.....Fi │ │ │ │ │ -0002ad70: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ -0002ad80: 4e6f 6465 3a20 636c 6561 722c 2020 4e65 Node: clear, Ne │ │ │ │ │ -0002ad90: 7874 3a20 636d 6f73 636c 6561 6e2c 2020 xt: cmosclean, │ │ │ │ │ -0002ada0: 5072 6576 3a20 6368 6169 6e6c 6f61 6465 Prev: chainloade │ │ │ │ │ -0002adb0: 722c 2020 5570 3a20 436f 6d6d 616e 642d r, Up: Command- │ │ │ │ │ -0002adc0: 6c69 6e65 2061 6e64 206d 656e 7520 656e line and menu en │ │ │ │ │ -0002add0: 7472 7920 636f 6d6d 616e 6473 0a0a 3136 try commands..16 │ │ │ │ │ -0002ade0: 2e33 2e31 3120 636c 6561 720a 2d2d 2d2d .3.11 clear.---- │ │ │ │ │ -0002adf0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 ---------.. -- C │ │ │ │ │ -0002ae00: 6f6d 6d61 6e64 3a20 636c 6561 720a 2020 ommand: clear. │ │ │ │ │ -0002ae10: 2020 2043 6c65 6172 2074 6865 2073 6372 Clear the scr │ │ │ │ │ -0002ae20: 6565 6e2e 0a0a 1f0a 4669 6c65 3a20 6772 een.....File: gr │ │ │ │ │ -0002ae30: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ -0002ae40: 636d 6f73 636c 6561 6e2c 2020 4e65 7874 cmosclean, Next │ │ │ │ │ -0002ae50: 3a20 636d 6f73 6475 6d70 2c20 2050 7265 : cmosdump, Pre │ │ │ │ │ -0002ae60: 763a 2063 6c65 6172 2c20 2055 703a 2043 v: clear, Up: C │ │ │ │ │ -0002ae70: 6f6d 6d61 6e64 2d6c 696e 6520 616e 6420 ommand-line and │ │ │ │ │ -0002ae80: 6d65 6e75 2065 6e74 7279 2063 6f6d 6d61 menu entry comma │ │ │ │ │ -0002ae90: 6e64 730a 0a31 362e 332e 3132 2063 6d6f nds..16.3.12 cmo │ │ │ │ │ -0002aea0: 7363 6c65 616e 0a2d 2d2d 2d2d 2d2d 2d2d sclean.--------- │ │ │ │ │ -0002aeb0: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ │ -0002aec0: 6d6d 616e 643a 2063 6d6f 7363 6c65 616e mmand: cmosclean │ │ │ │ │ -0002aed0: 2062 7974 653a 6269 740a 2020 2020 2043 byte:bit. C │ │ │ │ │ -0002aee0: 6c65 6172 2076 616c 7565 206f 6620 6269 lear value of bi │ │ │ │ │ -0002aef0: 7420 696e 2043 4d4f 5320 6174 206c 6f63 t in CMOS at loc │ │ │ │ │ -0002af00: 6174 696f 6e20 4259 5445 3a42 4954 2e20 ation BYTE:BIT. │ │ │ │ │ -0002af10: 2054 6869 7320 636f 6d6d 616e 6420 6973 This command is │ │ │ │ │ -0002af20: 0a20 2020 2020 6176 6169 6c61 626c 6520 . available │ │ │ │ │ -0002af30: 6f6e 6c79 206f 6e20 706c 6174 666f 726d only on platform │ │ │ │ │ -0002af40: 7320 7468 6174 2073 7570 706f 7274 2043 s that support C │ │ │ │ │ -0002af50: 4d4f 532e 0a0a 1f0a 4669 6c65 3a20 6772 MOS.....File: gr │ │ │ │ │ -0002af60: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ -0002af70: 636d 6f73 6475 6d70 2c20 204e 6578 743a cmosdump, Next: │ │ │ │ │ -0002af80: 2063 6d6f 7374 6573 742c 2020 5072 6576 cmostest, Prev │ │ │ │ │ -0002af90: 3a20 636d 6f73 636c 6561 6e2c 2020 5570 : cmosclean, Up │ │ │ │ │ -0002afa0: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ │ -0002afb0: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ │ -0002afc0: 6d6d 616e 6473 0a0a 3136 2e33 2e31 3320 mmands..16.3.13 │ │ │ │ │ -0002afd0: 636d 6f73 6475 6d70 0a2d 2d2d 2d2d 2d2d cmosdump.------- │ │ │ │ │ -0002afe0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2044 ---------.. -- D │ │ │ │ │ -0002aff0: 756d 703a 2043 4d4f 5320 636f 6e74 656e ump: CMOS conten │ │ │ │ │ -0002b000: 7473 0a20 2020 2020 4475 6d70 2066 756c ts. Dump ful │ │ │ │ │ -0002b010: 6c20 434d 4f53 2063 6f6e 7465 6e74 7320 l CMOS contents │ │ │ │ │ -0002b020: 6173 2068 6578 6164 6563 696d 616c 2076 as hexadecimal v │ │ │ │ │ -0002b030: 616c 7565 732e 2020 5468 6973 2063 6f6d alues. This com │ │ │ │ │ -0002b040: 6d61 6e64 2069 730a 2020 2020 2061 7661 mand is. ava │ │ │ │ │ -0002b050: 696c 6162 6c65 206f 6e6c 7920 6f6e 2070 ilable only on p │ │ │ │ │ -0002b060: 6c61 7466 6f72 6d73 2074 6861 7420 7375 latforms that su │ │ │ │ │ -0002b070: 7070 6f72 7420 434d 4f53 2e0a 0a1f 0a46 pport CMOS.....F │ │ │ │ │ -0002b080: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ -0002b090: 204e 6f64 653a 2063 6d6f 7374 6573 742c Node: cmostest, │ │ │ │ │ -0002b0a0: 2020 4e65 7874 3a20 636d 702c 2020 5072 Next: cmp, Pr │ │ │ │ │ -0002b0b0: 6576 3a20 636d 6f73 6475 6d70 2c20 2055 ev: cmosdump, U │ │ │ │ │ -0002b0c0: 703a 2043 6f6d 6d61 6e64 2d6c 696e 6520 p: Command-line │ │ │ │ │ -0002b0d0: 616e 6420 6d65 6e75 2065 6e74 7279 2063 and menu entry c │ │ │ │ │ -0002b0e0: 6f6d 6d61 6e64 730a 0a31 362e 332e 3134 ommands..16.3.14 │ │ │ │ │ -0002b0f0: 2063 6d6f 7374 6573 740a 2d2d 2d2d 2d2d cmostest.------ │ │ │ │ │ -0002b100: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 ----------.. -- │ │ │ │ │ -0002b110: 436f 6d6d 616e 643a 2063 6d6f 7374 6573 Command: cmostes │ │ │ │ │ -0002b120: 7420 6279 7465 3a62 6974 0a20 2020 2020 t byte:bit. │ │ │ │ │ -0002b130: 5465 7374 2076 616c 7565 206f 6620 6269 Test value of bi │ │ │ │ │ -0002b140: 7420 696e 2043 4d4f 5320 6174 206c 6f63 t in CMOS at loc │ │ │ │ │ -0002b150: 6174 696f 6e20 4259 5445 3a42 4954 2e20 ation BYTE:BIT. │ │ │ │ │ -0002b160: 2045 7869 7420 7374 6174 7573 2069 730a Exit status is. │ │ │ │ │ -0002b170: 2020 2020 207a 6572 6f20 6966 2062 6974 zero if bit │ │ │ │ │ -0002b180: 2069 7320 7365 742c 206e 6f6e 207a 6572 is set, non zer │ │ │ │ │ -0002b190: 6f20 6f74 6865 7277 6973 652e 2020 5468 o otherwise. Th │ │ │ │ │ -0002b1a0: 6973 2063 6f6d 6d61 6e64 2069 7320 6176 is command is av │ │ │ │ │ -0002b1b0: 6169 6c61 626c 650a 2020 2020 206f 6e6c ailable. onl │ │ │ │ │ -0002b1c0: 7920 6f6e 2070 6c61 7466 6f72 6d73 2074 y on platforms t │ │ │ │ │ -0002b1d0: 6861 7420 7375 7070 6f72 7420 434d 4f53 hat support CMOS │ │ │ │ │ -0002b1e0: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ -0002b1f0: 696e 666f 2c20 204e 6f64 653a 2063 6d70 info, Node: cmp │ │ │ │ │ -0002b200: 2c20 204e 6578 743a 2063 6f6e 6669 6766 , Next: configf │ │ │ │ │ -0002b210: 696c 652c 2020 5072 6576 3a20 636d 6f73 ile, Prev: cmos │ │ │ │ │ -0002b220: 7465 7374 2c20 2055 703a 2043 6f6d 6d61 test, Up: Comma │ │ │ │ │ -0002b230: 6e64 2d6c 696e 6520 616e 6420 6d65 6e75 nd-line and menu │ │ │ │ │ -0002b240: 2065 6e74 7279 2063 6f6d 6d61 6e64 730a entry commands. │ │ │ │ │ -0002b250: 0a31 362e 332e 3135 2063 6d70 0a2d 2d2d .16.3.15 cmp.--- │ │ │ │ │ -0002b260: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ │ -0002b270: 6d6d 616e 643a 2063 6d70 2066 696c 6531 mmand: cmp file1 │ │ │ │ │ -0002b280: 2066 696c 6532 0a20 2020 2020 436f 6d70 file2. Comp │ │ │ │ │ -0002b290: 6172 6520 7468 6520 6669 6c65 2046 494c are the file FIL │ │ │ │ │ -0002b2a0: 4531 2077 6974 6820 7468 6520 6669 6c65 E1 with the file │ │ │ │ │ -0002b2b0: 2046 494c 4532 2e20 2049 6620 7468 6579 FILE2. If they │ │ │ │ │ -0002b2c0: 2064 6966 6665 7220 696e 0a20 2020 2020 differ in. │ │ │ │ │ -0002b2d0: 7369 7a65 2c20 7072 696e 7420 7468 6520 size, print the │ │ │ │ │ -0002b2e0: 7369 7a65 7320 6c69 6b65 2074 6869 733a sizes like this: │ │ │ │ │ -0002b2f0: 0a0a 2020 2020 2020 2020 2020 4469 6666 .. Diff │ │ │ │ │ -0002b300: 6572 2069 6e20 7369 7a65 3a20 3078 3132 er in size: 0x12 │ │ │ │ │ -0002b310: 3334 205b 666f 6f5d 2c20 3078 3433 3231 34 [foo], 0x4321 │ │ │ │ │ -0002b320: 205b 6261 725d 0a0a 2020 2020 2049 6620 [bar].. If │ │ │ │ │ -0002b330: 7468 6520 7369 7a65 7320 6172 6520 6571 the sizes are eq │ │ │ │ │ -0002b340: 7561 6c20 6275 7420 7468 6520 6279 7465 ual but the byte │ │ │ │ │ -0002b350: 7320 6174 2061 6e20 6f66 6673 6574 2064 s at an offset d │ │ │ │ │ -0002b360: 6966 6665 722c 2074 6865 6e0a 2020 2020 iffer, then. │ │ │ │ │ -0002b370: 2070 7269 6e74 2074 6865 2062 7974 6573 print the bytes │ │ │ │ │ -0002b380: 206c 696b 6520 7468 6973 3a0a 0a20 2020 like this:.. │ │ │ │ │ -0002b390: 2020 2020 2020 2044 6966 6665 7220 6174 Differ at │ │ │ │ │ -0002b3a0: 2074 6865 206f 6666 7365 7420 3737 373a the offset 777: │ │ │ │ │ -0002b3b0: 2030 7862 6520 5b66 6f6f 5d2c 2030 7865 0xbe [foo], 0xe │ │ │ │ │ -0002b3c0: 6620 5b62 6172 5d0a 0a20 2020 2020 4966 f [bar].. If │ │ │ │ │ -0002b3d0: 2074 6865 7920 6172 6520 636f 6d70 6c65 they are comple │ │ │ │ │ -0002b3e0: 7465 6c79 2069 6465 6e74 6963 616c 2c20 tely identical, │ │ │ │ │ -0002b3f0: 6e6f 7468 696e 6720 7769 6c6c 2062 6520 nothing will be │ │ │ │ │ -0002b400: 7072 696e 7465 642e 0a0a 1f0a 4669 6c65 printed.....File │ │ │ │ │ -0002b410: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ -0002b420: 6465 3a20 636f 6e66 6967 6669 6c65 2c20 de: configfile, │ │ │ │ │ -0002b430: 204e 6578 743a 2063 7075 6964 2c20 2050 Next: cpuid, P │ │ │ │ │ -0002b440: 7265 763a 2063 6d70 2c20 2055 703a 2043 rev: cmp, Up: C │ │ │ │ │ -0002b450: 6f6d 6d61 6e64 2d6c 696e 6520 616e 6420 ommand-line and │ │ │ │ │ -0002b460: 6d65 6e75 2065 6e74 7279 2063 6f6d 6d61 menu entry comma │ │ │ │ │ -0002b470: 6e64 730a 0a31 362e 332e 3136 2063 6f6e nds..16.3.16 con │ │ │ │ │ -0002b480: 6669 6766 696c 650a 2d2d 2d2d 2d2d 2d2d figfile.-------- │ │ │ │ │ -0002b490: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 ----------.. -- │ │ │ │ │ -0002b4a0: 436f 6d6d 616e 643a 2063 6f6e 6669 6766 Command: configf │ │ │ │ │ -0002b4b0: 696c 6520 6669 6c65 0a20 2020 2020 4c6f ile file. Lo │ │ │ │ │ -0002b4c0: 6164 2046 494c 4520 6173 2061 2063 6f6e ad FILE as a con │ │ │ │ │ -0002b4d0: 6669 6775 7261 7469 6f6e 2066 696c 652e figuration file. │ │ │ │ │ -0002b4e0: 2020 4966 2046 494c 4520 6465 6669 6e65 If FILE define │ │ │ │ │ -0002b4f0: 7320 616e 7920 6d65 6e75 0a20 2020 2020 s any menu. │ │ │ │ │ -0002b500: 656e 7472 6965 732c 2074 6865 6e20 7368 entries, then sh │ │ │ │ │ -0002b510: 6f77 2061 206d 656e 7520 636f 6e74 6169 ow a menu contai │ │ │ │ │ -0002b520: 6e69 6e67 2074 6865 6d20 696d 6d65 6469 ning them immedi │ │ │ │ │ -0002b530: 6174 656c 792e 2020 416e 790a 2020 2020 ately. Any. │ │ │ │ │ -0002b540: 2065 6e76 6972 6f6e 6d65 6e74 2076 6172 environment var │ │ │ │ │ -0002b550: 6961 626c 6520 6368 616e 6765 7320 6d61 iable changes ma │ │ │ │ │ -0002b560: 6465 2062 7920 7468 6520 636f 6d6d 616e de by the comman │ │ │ │ │ -0002b570: 6473 2069 6e20 4649 4c45 2077 696c 6c20 ds in FILE will │ │ │ │ │ -0002b580: 6e6f 740a 2020 2020 2062 6520 7072 6573 not. be pres │ │ │ │ │ -0002b590: 6572 7665 6420 6166 7465 7220 2763 6f6e erved after 'con │ │ │ │ │ -0002b5a0: 6669 6766 696c 6527 2072 6574 7572 6e73 figfile' returns │ │ │ │ │ -0002b5b0: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ -0002b5c0: 696e 666f 2c20 204e 6f64 653a 2063 7075 info, Node: cpu │ │ │ │ │ -0002b5d0: 6964 2c20 204e 6578 743a 2063 7263 2c20 id, Next: crc, │ │ │ │ │ -0002b5e0: 2050 7265 763a 2063 6f6e 6669 6766 696c Prev: configfil │ │ │ │ │ -0002b5f0: 652c 2020 5570 3a20 436f 6d6d 616e 642d e, Up: Command- │ │ │ │ │ -0002b600: 6c69 6e65 2061 6e64 206d 656e 7520 656e line and menu en │ │ │ │ │ -0002b610: 7472 7920 636f 6d6d 616e 6473 0a0a 3136 try commands..16 │ │ │ │ │ -0002b620: 2e33 2e31 3720 6370 7569 640a 2d2d 2d2d .3.17 cpuid.---- │ │ │ │ │ -0002b630: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 ---------.. -- C │ │ │ │ │ -0002b640: 6f6d 6d61 6e64 3a20 6370 7569 6420 5b2d ommand: cpuid [- │ │ │ │ │ -0002b650: 6c5d 205b 2d70 5d0a 2020 2020 2043 6865 l] [-p]. Che │ │ │ │ │ -0002b660: 636b 2066 6f72 2043 5055 2066 6561 7475 ck for CPU featu │ │ │ │ │ -0002b670: 7265 732e 2020 5468 6973 2063 6f6d 6d61 res. This comma │ │ │ │ │ -0002b680: 6e64 2069 7320 6f6e 6c79 2061 7661 696c nd is only avail │ │ │ │ │ -0002b690: 6162 6c65 206f 6e20 7838 360a 2020 2020 able on x86. │ │ │ │ │ -0002b6a0: 2073 7973 7465 6d73 2e0a 0a20 2020 2020 systems... │ │ │ │ │ -0002b6b0: 5769 7468 2074 6865 2027 2d6c 2720 6f70 With the '-l' op │ │ │ │ │ -0002b6c0: 7469 6f6e 2c20 7265 7475 726e 2074 7275 tion, return tru │ │ │ │ │ -0002b6d0: 6520 6966 2074 6865 2043 5055 2073 7570 e if the CPU sup │ │ │ │ │ -0002b6e0: 706f 7274 7320 6c6f 6e67 206d 6f64 650a ports long mode. │ │ │ │ │ -0002b6f0: 2020 2020 2028 3634 2d62 6974 292e 0a0a (64-bit)... │ │ │ │ │ -0002b700: 2020 2020 2057 6974 6820 7468 6520 272d With the '- │ │ │ │ │ -0002b710: 7027 206f 7074 696f 6e2c 2072 6574 7572 p' option, retur │ │ │ │ │ -0002b720: 6e20 7472 7565 2069 6620 7468 6520 4350 n true if the CP │ │ │ │ │ -0002b730: 5520 7375 7070 6f72 7473 2050 6879 7369 U supports Physi │ │ │ │ │ -0002b740: 6361 6c0a 2020 2020 2041 6464 7265 7373 cal. Address │ │ │ │ │ -0002b750: 2045 7874 656e 7369 6f6e 2028 5041 4529 Extension (PAE) │ │ │ │ │ -0002b760: 2e0a 0a20 2020 2020 4966 2069 6e76 6f6b ... If invok │ │ │ │ │ -0002b770: 6564 2077 6974 686f 7574 206f 7074 696f ed without optio │ │ │ │ │ -0002b780: 6e73 2c20 7468 6973 2063 6f6d 6d61 6e64 ns, this command │ │ │ │ │ -0002b790: 2063 7572 7265 6e74 6c79 2062 6568 6176 currently behav │ │ │ │ │ -0002b7a0: 6573 2061 7320 6966 2069 740a 2020 2020 es as if it. │ │ │ │ │ -0002b7b0: 2068 6164 2062 6565 6e20 696e 766f 6b65 had been invoke │ │ │ │ │ -0002b7c0: 6420 7769 7468 2027 2d6c 272e 2020 5468 d with '-l'. Th │ │ │ │ │ -0002b7d0: 6973 206d 6179 2063 6861 6e67 6520 696e is may change in │ │ │ │ │ -0002b7e0: 2074 6865 2066 7574 7572 652e 0a0a 1f0a the future..... │ │ │ │ │ -0002b7f0: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ -0002b800: 2020 4e6f 6465 3a20 6372 632c 2020 4e65 Node: crc, Ne │ │ │ │ │ -0002b810: 7874 3a20 6372 7970 746f 6d6f 756e 742c xt: cryptomount, │ │ │ │ │ -0002b820: 2020 5072 6576 3a20 6370 7569 642c 2020 Prev: cpuid, │ │ │ │ │ -0002b830: 5570 3a20 436f 6d6d 616e 642d 6c69 6e65 Up: Command-line │ │ │ │ │ -0002b840: 2061 6e64 206d 656e 7520 656e 7472 7920 and menu entry │ │ │ │ │ -0002b850: 636f 6d6d 616e 6473 0a0a 3136 2e33 2e31 commands..16.3.1 │ │ │ │ │ -0002b860: 3820 6372 630a 2d2d 2d2d 2d2d 2d2d 2d2d 8 crc.---------- │ │ │ │ │ -0002b870: 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 -.. -- Command: │ │ │ │ │ -0002b880: 6372 6320 6172 6720 2e2e 2e0a 2020 2020 crc arg .... │ │ │ │ │ -0002b890: 2041 6c69 6173 2066 6f72 2027 6861 7368 Alias for 'hash │ │ │ │ │ -0002b8a0: 7375 6d20 2d2d 6861 7368 2063 7263 3332 sum --hash crc32 │ │ │ │ │ -0002b8b0: 2061 7267 202e 2e2e 272e 2020 5365 6520 arg ...'. See │ │ │ │ │ -0002b8c0: 636f 6d6d 616e 6420 2768 6173 6873 756d command 'hashsum │ │ │ │ │ -0002b8d0: 270a 2020 2020 2028 2a6e 6f74 6520 6861 '. (*note ha │ │ │ │ │ -0002b8e0: 7368 7375 6d3a 3a29 2066 6f72 2066 756c shsum::) for ful │ │ │ │ │ -0002b8f0: 6c20 6465 7363 7269 7074 696f 6e2e 0a0a l description... │ │ │ │ │ -0002b900: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ -0002b910: 6f2c 2020 4e6f 6465 3a20 6372 7970 746f o, Node: crypto │ │ │ │ │ -0002b920: 6d6f 756e 742c 2020 4e65 7874 3a20 6375 mount, Next: cu │ │ │ │ │ -0002b930: 746d 656d 2c20 2050 7265 763a 2063 7263 tmem, Prev: crc │ │ │ │ │ -0002b940: 2c20 2055 703a 2043 6f6d 6d61 6e64 2d6c , Up: Command-l │ │ │ │ │ -0002b950: 696e 6520 616e 6420 6d65 6e75 2065 6e74 ine and menu ent │ │ │ │ │ -0002b960: 7279 2063 6f6d 6d61 6e64 730a 0a31 362e ry commands..16. │ │ │ │ │ -0002b970: 332e 3139 2063 7279 7074 6f6d 6f75 6e74 3.19 cryptomount │ │ │ │ │ -0002b980: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ │ -0002b990: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ │ -0002b9a0: 643a 2063 7279 7074 6f6d 6f75 6e74 2064 d: cryptomount d │ │ │ │ │ -0002b9b0: 6576 6963 657c 2d75 2075 7569 647c 2d61 evice|-u uuid|-a │ │ │ │ │ -0002b9c0: 7c2d 620a 2020 2020 2053 6574 7570 2061 |-b. Setup a │ │ │ │ │ -0002b9d0: 6363 6573 7320 746f 2065 6e63 7279 7074 ccess to encrypt │ │ │ │ │ -0002b9e0: 6564 2064 6576 6963 652e 2020 4966 206e ed device. If n │ │ │ │ │ -0002b9f0: 6563 6573 7361 7279 2c20 7061 7373 7068 ecessary, passph │ │ │ │ │ -0002ba00: 7261 7365 2069 730a 2020 2020 2072 6571 rase is. req │ │ │ │ │ -0002ba10: 7565 7374 6564 2069 6e74 6572 6163 7469 uested interacti │ │ │ │ │ -0002ba20: 7665 6c79 2e20 204f 7074 696f 6e20 4445 vely. Option DE │ │ │ │ │ -0002ba30: 5649 4345 2063 6f6e 6669 6775 7265 7320 VICE configures │ │ │ │ │ -0002ba40: 7370 6563 6966 6963 2067 7275 620a 2020 specific grub. │ │ │ │ │ -0002ba50: 2020 2064 6576 6963 6520 282a 6e6f 7465 device (*note │ │ │ │ │ -0002ba60: 204e 616d 696e 6720 636f 6e76 656e 7469 Naming conventi │ │ │ │ │ -0002ba70: 6f6e 3a3a 293b 206f 7074 696f 6e20 272d on::); option '- │ │ │ │ │ -0002ba80: 7527 2055 5549 4420 636f 6e66 6967 7572 u' UUID configur │ │ │ │ │ -0002ba90: 6573 0a20 2020 2020 6465 7669 6365 2077 es. device w │ │ │ │ │ -0002baa0: 6974 6820 7370 6563 6966 6965 6420 5555 ith specified UU │ │ │ │ │ -0002bab0: 4944 3b20 6f70 7469 6f6e 2027 2d61 2720 ID; option '-a' │ │ │ │ │ -0002bac0: 636f 6e66 6967 7572 6573 2061 6c6c 2064 configures all d │ │ │ │ │ -0002bad0: 6574 6563 7465 640a 2020 2020 2065 6e63 etected. enc │ │ │ │ │ -0002bae0: 7279 7074 6564 2064 6576 6963 6573 3b20 rypted devices; │ │ │ │ │ -0002baf0: 6f70 7469 6f6e 2027 2d62 2720 636f 6e66 option '-b' conf │ │ │ │ │ -0002bb00: 6967 7572 6573 2061 6c6c 2067 656c 6920 igures all geli │ │ │ │ │ -0002bb10: 636f 6e74 6169 6e65 7273 2074 6861 740a containers that. │ │ │ │ │ -0002bb20: 2020 2020 2068 6176 6520 626f 6f74 2066 have boot f │ │ │ │ │ -0002bb30: 6c61 6720 7365 742e 0a0a 2020 2020 2047 lag set... G │ │ │ │ │ -0002bb40: 5255 4220 7375 706f 7274 7320 6465 7669 RUB suports devi │ │ │ │ │ -0002bb50: 6365 7320 656e 6372 7970 7465 6420 7573 ces encrypted us │ │ │ │ │ -0002bb60: 696e 6720 4c55 4b53 2c20 4c55 4b53 3220 ing LUKS, LUKS2 │ │ │ │ │ -0002bb70: 616e 6420 6765 6c69 2e20 204e 6f74 650a and geli. Note. │ │ │ │ │ -0002bb80: 2020 2020 2074 6861 7420 6e65 6365 7373 that necess │ │ │ │ │ -0002bb90: 6172 7920 6d6f 6475 6c65 7320 284c 554b ary modules (LUK │ │ │ │ │ -0002bba0: 532c 204c 554b 5332 2061 6e64 2047 454c S, LUKS2 and GEL │ │ │ │ │ -0002bbb0: 4929 2068 6176 6520 746f 2062 6520 6c6f I) have to be lo │ │ │ │ │ -0002bbc0: 6164 6564 0a20 2020 2020 6d61 6e75 616c aded. manual │ │ │ │ │ -0002bbd0: 6c79 2062 6566 6f72 6520 7468 6973 2063 ly before this c │ │ │ │ │ -0002bbe0: 6f6d 6d61 6e64 2063 616e 2062 6520 7573 ommand can be us │ │ │ │ │ -0002bbf0: 6564 2e20 2046 6f72 204c 554b 5332 206f ed. For LUKS2 o │ │ │ │ │ -0002bc00: 6e6c 7920 7468 650a 2020 2020 2050 424b nly the. PBK │ │ │ │ │ -0002bc10: 4446 3220 6b65 7920 6465 7269 7661 7469 DF2 key derivati │ │ │ │ │ -0002bc20: 6f6e 2066 756e 6374 696f 6e20 6973 2073 on function is s │ │ │ │ │ -0002bc30: 7570 706f 7274 6564 2c20 6173 2041 7267 upported, as Arg │ │ │ │ │ -0002bc40: 6f6e 3220 6973 206e 6f74 2079 6574 0a20 on2 is not yet. │ │ │ │ │ -0002bc50: 2020 2020 7375 7070 6f72 7465 642e 0a0a supported... │ │ │ │ │ -0002bc60: 2020 2020 2041 6c73 6f2c 206e 6f74 6520 Also, note │ │ │ │ │ -0002bc70: 7468 6174 2c20 756e 6c69 6b65 2066 696c that, unlike fil │ │ │ │ │ -0002bc80: 6573 7973 7465 6d20 5555 4944 732c 2055 esystem UUIDs, U │ │ │ │ │ -0002bc90: 5549 4473 2066 6f72 2065 6e63 7279 7074 UIDs for encrypt │ │ │ │ │ -0002bca0: 6564 0a20 2020 2020 6465 7669 6365 7320 ed. devices │ │ │ │ │ -0002bcb0: 6d75 7374 2062 6520 7370 6563 6966 6965 must be specifie │ │ │ │ │ -0002bcc0: 6420 7769 7468 6f75 7420 6461 7368 2073 d without dash s │ │ │ │ │ -0002bcd0: 6570 6172 6174 6f72 732e 0a0a 1f0a 4669 eparators.....Fi │ │ │ │ │ -0002bce0: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ -0002bcf0: 4e6f 6465 3a20 6375 746d 656d 2c20 204e Node: cutmem, N │ │ │ │ │ -0002bd00: 6578 743a 2064 6174 652c 2020 5072 6576 ext: date, Prev │ │ │ │ │ -0002bd10: 3a20 6372 7970 746f 6d6f 756e 742c 2020 : cryptomount, │ │ │ │ │ -0002bd20: 5570 3a20 436f 6d6d 616e 642d 6c69 6e65 Up: Command-line │ │ │ │ │ -0002bd30: 2061 6e64 206d 656e 7520 656e 7472 7920 and menu entry │ │ │ │ │ -0002bd40: 636f 6d6d 616e 6473 0a0a 3136 2e33 2e32 commands..16.3.2 │ │ │ │ │ -0002bd50: 3020 6375 746d 656d 0a2d 2d2d 2d2d 2d2d 0 cutmem.------- │ │ │ │ │ -0002bd60: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d -------.. -- Com │ │ │ │ │ -0002bd70: 6d61 6e64 3a20 6375 746d 656d 2066 726f mand: cutmem fro │ │ │ │ │ -0002bd80: 6d5b 4b7c 4d7c 475d 2074 6f5b 4b7c 4d7c m[K|M|G] to[K|M| │ │ │ │ │ -0002bd90: 475d 0a20 2020 2020 5265 6d6f 7665 2061 G]. Remove a │ │ │ │ │ -0002bda0: 6e79 206d 656d 6f72 7920 7265 6769 6f6e ny memory region │ │ │ │ │ -0002bdb0: 7320 696e 2073 7065 6369 6669 6564 2072 s in specified r │ │ │ │ │ -0002bdc0: 616e 6765 2e0a 0a20 2020 2020 5468 6973 ange... This │ │ │ │ │ -0002bdd0: 2063 6f6d 6d61 6e64 206e 6f74 6966 6965 command notifie │ │ │ │ │ -0002bde0: 7320 7468 6520 6d65 6d6f 7279 206d 616e s the memory man │ │ │ │ │ -0002bdf0: 6167 6572 2074 6861 7420 7370 6563 6966 ager that specif │ │ │ │ │ -0002be00: 6965 6420 7265 6769 6f6e 7320 6f66 0a20 ied regions of. │ │ │ │ │ -0002be10: 2020 2020 5241 4d20 6f75 6768 7420 746f RAM ought to │ │ │ │ │ -0002be20: 2062 6520 6669 6c74 6572 6564 206f 7574 be filtered out │ │ │ │ │ -0002be30: 2e20 2054 6869 7320 7265 6d61 696e 7320 . This remains │ │ │ │ │ -0002be40: 696e 2065 6666 6563 7420 6166 7465 7220 in effect after │ │ │ │ │ -0002be50: 610a 2020 2020 2070 6179 6c6f 6164 206b a. payload k │ │ │ │ │ -0002be60: 6572 6e65 6c20 6861 7320 6265 656e 206c ernel has been l │ │ │ │ │ -0002be70: 6f61 6465 6420 6279 2047 5255 422c 2061 oaded by GRUB, a │ │ │ │ │ -0002be80: 7320 6c6f 6e67 2061 7320 7468 6520 6c6f s long as the lo │ │ │ │ │ -0002be90: 6164 6564 0a20 2020 2020 6b65 726e 656c aded. kernel │ │ │ │ │ -0002bea0: 206f 6274 6169 6e73 2069 7473 206d 656d obtains its mem │ │ │ │ │ -0002beb0: 6f72 7920 6d61 7020 6672 6f6d 2047 5255 ory map from GRU │ │ │ │ │ -0002bec0: 422e 204b 6572 6e65 6c73 2074 6861 7420 B. Kernels that │ │ │ │ │ -0002bed0: 7375 7070 6f72 7420 7468 6973 0a20 2020 support this. │ │ │ │ │ -0002bee0: 2020 696e 636c 7564 6520 4c69 6e75 782c include Linux, │ │ │ │ │ -0002bef0: 2047 4e55 204d 6163 682c 2074 6865 206b GNU Mach, the k │ │ │ │ │ -0002bf00: 6572 6e65 6c20 6f66 2046 7265 6542 5344 ernel of FreeBSD │ │ │ │ │ -0002bf10: 2061 6e64 204d 756c 7469 626f 6f74 0a20 and Multiboot. │ │ │ │ │ -0002bf20: 2020 2020 6b65 726e 656c 7320 696e 2067 kernels in g │ │ │ │ │ -0002bf30: 656e 6572 616c 2e0a 0a20 2020 2020 5468 eneral... Th │ │ │ │ │ -0002bf40: 6520 636f 6d6d 616e 6420 6973 2073 696d e command is sim │ │ │ │ │ -0002bf50: 696c 6172 2074 6f20 2762 6164 7261 6d27 ilar to 'badram' │ │ │ │ │ -0002bf60: 2063 6f6d 6d61 6e64 2e0a 0a20 2020 2020 command... │ │ │ │ │ -0002bf70: 4e6f 7465 3a20 5468 6520 636f 6d6d 616e Note: The comman │ │ │ │ │ -0002bf80: 6420 6973 206e 6f74 2061 6c6c 6f77 6564 d is not allowed │ │ │ │ │ -0002bf90: 2077 6865 6e20 6c6f 636b 646f 776e 2069 when lockdown i │ │ │ │ │ -0002bfa0: 7320 656e 666f 7263 6564 2028 2a6e 6f74 s enforced (*not │ │ │ │ │ -0002bfb0: 650a 2020 2020 204c 6f63 6b64 6f77 6e3a e. Lockdown: │ │ │ │ │ -0002bfc0: 3a29 2e20 2054 6869 7320 7072 6576 656e :). This preven │ │ │ │ │ -0002bfd0: 7473 2072 656d 6f76 696e 6720 4546 4920 ts removing EFI │ │ │ │ │ -0002bfe0: 6d65 6d6f 7279 2072 6567 696f 6e73 2074 memory regions t │ │ │ │ │ -0002bff0: 6f0a 2020 2020 2070 6f74 656e 7469 616c o. potential │ │ │ │ │ -0002c000: 6c79 2073 7562 7665 7274 2074 6865 2073 ly subvert the s │ │ │ │ │ -0002c010: 6563 7572 6974 7920 6d65 6368 616e 6973 ecurity mechanis │ │ │ │ │ -0002c020: 6d73 2070 726f 7669 6465 6420 6279 2074 ms provided by t │ │ │ │ │ -0002c030: 6865 2055 4546 490a 2020 2020 2073 6563 he UEFI. sec │ │ │ │ │ -0002c040: 7572 6520 626f 6f74 2e0a 0a1f 0a46 696c ure boot.....Fil │ │ │ │ │ -0002c050: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ -0002c060: 6f64 653a 2064 6174 652c 2020 4e65 7874 ode: date, Next │ │ │ │ │ -0002c070: 3a20 6465 7669 6365 7472 6565 2c20 2050 : devicetree, P │ │ │ │ │ -0002c080: 7265 763a 2063 7574 6d65 6d2c 2020 5570 rev: cutmem, Up │ │ │ │ │ -0002c090: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ │ -0002c0a0: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ │ -0002c0b0: 6d6d 616e 6473 0a0a 3136 2e33 2e32 3120 mmands..16.3.21 │ │ │ │ │ -0002c0c0: 6461 7465 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d date.----------- │ │ │ │ │ -0002c0d0: 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 -.. -- Command: │ │ │ │ │ -0002c0e0: 6461 7465 205b 5b79 6561 722d 5d6d 6f6e date [[year-]mon │ │ │ │ │ -0002c0f0: 7468 2d64 6179 5d20 5b68 6f75 723a 6d69 th-day] [hour:mi │ │ │ │ │ -0002c100: 6e75 7465 5b3a 7365 636f 6e64 5d5d 0a20 nute[:second]]. │ │ │ │ │ -0002c110: 2020 2020 5769 7468 206e 6f20 6172 6775 With no argu │ │ │ │ │ -0002c120: 6d65 6e74 732c 2070 7269 6e74 2074 6865 ments, print the │ │ │ │ │ -0002c130: 2063 7572 7265 6e74 2064 6174 6520 616e current date an │ │ │ │ │ -0002c140: 6420 7469 6d65 2e0a 0a20 2020 2020 4f74 d time... Ot │ │ │ │ │ -0002c150: 6865 7277 6973 652c 2074 616b 6520 7468 herwise, take th │ │ │ │ │ -0002c160: 6520 6375 7272 656e 7420 6461 7465 2061 e current date a │ │ │ │ │ -0002c170: 6e64 2074 696d 652c 2063 6861 6e67 6520 nd time, change │ │ │ │ │ -0002c180: 616e 7920 656c 656d 656e 7473 0a20 2020 any elements. │ │ │ │ │ -0002c190: 2020 7370 6563 6966 6965 6420 6173 2061 specified as a │ │ │ │ │ -0002c1a0: 7267 756d 656e 7473 2c20 616e 6420 7365 rguments, and se │ │ │ │ │ -0002c1b0: 7420 7468 6520 7265 7375 6c74 2061 7320 t the result as │ │ │ │ │ -0002c1c0: 7468 6520 6e65 7720 6461 7465 2061 6e64 the new date and │ │ │ │ │ -0002c1d0: 0a20 2020 2020 7469 6d65 2e20 2046 6f72 . time. For │ │ │ │ │ -0002c1e0: 2065 7861 6d70 6c65 2c20 2764 6174 6520 example, 'date │ │ │ │ │ -0002c1f0: 3031 2d30 3127 2077 696c 6c20 7365 7420 01-01' will set │ │ │ │ │ -0002c200: 7468 6520 6375 7272 656e 7420 6d6f 6e74 the current mont │ │ │ │ │ -0002c210: 6820 616e 6420 6461 790a 2020 2020 2074 h and day. t │ │ │ │ │ -0002c220: 6f20 4a61 6e75 6172 7920 312c 2062 7574 o January 1, but │ │ │ │ │ -0002c230: 206c 6561 7665 2074 6865 2079 6561 722c leave the year, │ │ │ │ │ -0002c240: 2068 6f75 722c 206d 696e 7574 652c 2061 hour, minute, a │ │ │ │ │ -0002c250: 6e64 2073 6563 6f6e 640a 2020 2020 2075 nd second. u │ │ │ │ │ -0002c260: 6e63 6861 6e67 6564 2e0a 0a1f 0a46 696c nchanged.....Fil │ │ │ │ │ -0002c270: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ -0002c280: 6f64 653a 2064 6576 6963 6574 7265 652c ode: devicetree, │ │ │ │ │ -0002c290: 2020 4e65 7874 3a20 6469 7374 7275 7374 Next: distrust │ │ │ │ │ -0002c2a0: 2c20 2050 7265 763a 2064 6174 652c 2020 , Prev: date, │ │ │ │ │ -0002c2b0: 5570 3a20 436f 6d6d 616e 642d 6c69 6e65 Up: Command-line │ │ │ │ │ -0002c2c0: 2061 6e64 206d 656e 7520 656e 7472 7920 and menu entry │ │ │ │ │ -0002c2d0: 636f 6d6d 616e 6473 0a0a 3136 2e33 2e32 commands..16.3.2 │ │ │ │ │ -0002c2e0: 3220 6465 7669 6365 7472 6565 0a2d 2d2d 2 devicetree.--- │ │ │ │ │ -0002c2f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ -0002c300: 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 6465 . -- Command: de │ │ │ │ │ -0002c310: 7669 6365 7472 6565 2066 696c 650a 2020 vicetree file. │ │ │ │ │ -0002c320: 2020 204c 6f61 6420 6120 6465 7669 6365 Load a device │ │ │ │ │ -0002c330: 2074 7265 6520 626c 6f62 2028 2e64 7462 tree blob (.dtb │ │ │ │ │ -0002c340: 2920 6672 6f6d 2061 2066 696c 6573 7973 ) from a filesys │ │ │ │ │ -0002c350: 7465 6d2c 2066 6f72 206c 6174 6572 2075 tem, for later u │ │ │ │ │ -0002c360: 7365 2062 790a 2020 2020 2061 204c 696e se by. a Lin │ │ │ │ │ -0002c370: 7578 206b 6572 6e65 6c2e 2020 446f 6573 ux kernel. Does │ │ │ │ │ -0002c380: 206e 6f74 2070 6572 666f 726d 206d 6572 not perform mer │ │ │ │ │ -0002c390: 6769 6e67 2077 6974 6820 616e 7920 6465 ging with any de │ │ │ │ │ -0002c3a0: 7669 6365 2074 7265 650a 2020 2020 2073 vice tree. s │ │ │ │ │ -0002c3b0: 7570 706c 6965 6420 6279 2066 6972 6d77 upplied by firmw │ │ │ │ │ -0002c3c0: 6172 652c 2062 7574 2072 6174 6865 7220 are, but rather │ │ │ │ │ -0002c3d0: 7265 706c 6163 6573 2069 7420 636f 6d70 replaces it comp │ │ │ │ │ -0002c3e0: 6c65 7465 6c79 2e0a 0a20 2020 2020 4e6f letely... No │ │ │ │ │ -0002c3f0: 7465 3a20 5468 6520 636f 6d6d 616e 6420 te: The command │ │ │ │ │ -0002c400: 6973 206e 6f74 2061 6c6c 6f77 6564 2077 is not allowed w │ │ │ │ │ -0002c410: 6865 6e20 6c6f 636b 646f 776e 2069 7320 hen lockdown is │ │ │ │ │ -0002c420: 656e 666f 7263 6564 2028 2a6e 6f74 650a enforced (*note. │ │ │ │ │ -0002c430: 2020 2020 204c 6f63 6b64 6f77 6e3a 3a29 Lockdown::) │ │ │ │ │ -0002c440: 2e20 2054 6869 7320 6973 2064 6f6e 6520 . This is done │ │ │ │ │ -0002c450: 746f 2070 7265 7665 6e74 2073 7562 7665 to prevent subve │ │ │ │ │ -0002c460: 7274 696e 6720 7661 7269 6f75 7320 7365 rting various se │ │ │ │ │ -0002c470: 6375 7269 7479 0a20 2020 2020 6d65 6368 curity. mech │ │ │ │ │ -0002c480: 616e 6973 6d73 2e0a 0a1f 0a46 696c 653a anisms.....File: │ │ │ │ │ -0002c490: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ -0002c4a0: 653a 2064 6973 7472 7573 742c 2020 4e65 e: distrust, Ne │ │ │ │ │ -0002c4b0: 7874 3a20 6472 6976 656d 6170 2c20 2050 xt: drivemap, P │ │ │ │ │ -0002c4c0: 7265 763a 2064 6576 6963 6574 7265 652c rev: devicetree, │ │ │ │ │ -0002c4d0: 2020 5570 3a20 436f 6d6d 616e 642d 6c69 Up: Command-li │ │ │ │ │ -0002c4e0: 6e65 2061 6e64 206d 656e 7520 656e 7472 ne and menu entr │ │ │ │ │ -0002c4f0: 7920 636f 6d6d 616e 6473 0a0a 3136 2e33 y commands..16.3 │ │ │ │ │ -0002c500: 2e32 3320 6469 7374 7275 7374 0a2d 2d2d .23 distrust.--- │ │ │ │ │ -0002c510: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 -------------.. │ │ │ │ │ -0002c520: 2d2d 2043 6f6d 6d61 6e64 3a20 6469 7374 -- Command: dist │ │ │ │ │ -0002c530: 7275 7374 2070 7562 6b65 795f 6964 0a20 rust pubkey_id. │ │ │ │ │ -0002c540: 2020 2020 5265 6d6f 7665 2070 7562 6c69 Remove publi │ │ │ │ │ -0002c550: 6320 6b65 7920 5055 424b 4559 5f49 4420 c key PUBKEY_ID │ │ │ │ │ -0002c560: 6672 6f6d 2047 5255 4227 7320 6b65 7972 from GRUB's keyr │ │ │ │ │ -0002c570: 696e 6720 6f66 2074 7275 7374 6564 206b ing of trusted k │ │ │ │ │ -0002c580: 6579 732e 0a20 2020 2020 5055 424b 4559 eys.. PUBKEY │ │ │ │ │ -0002c590: 5f49 4420 6973 2074 6865 206c 6173 7420 _ID is the last │ │ │ │ │ -0002c5a0: 666f 7572 2062 7974 6573 2028 6569 6768 four bytes (eigh │ │ │ │ │ -0002c5b0: 7420 6865 7861 6465 6369 6d61 6c20 6469 t hexadecimal di │ │ │ │ │ -0002c5c0: 6769 7473 2920 6f66 2074 6865 0a20 2020 gits) of the. │ │ │ │ │ -0002c5d0: 2020 4750 4720 7634 206b 6579 2069 642c GPG v4 key id, │ │ │ │ │ -0002c5e0: 2077 6869 6368 2069 7320 616c 736f 2074 which is also t │ │ │ │ │ -0002c5f0: 6865 206f 7574 7075 7420 6f66 2027 6c69 he output of 'li │ │ │ │ │ -0002c600: 7374 5f74 7275 7374 6564 2720 282a 6e6f st_trusted' (*no │ │ │ │ │ -0002c610: 7465 0a20 2020 2020 6c69 7374 5f74 7275 te. list_tru │ │ │ │ │ -0002c620: 7374 6564 3a3a 292e 2020 4f75 7473 6964 sted::). Outsid │ │ │ │ │ -0002c630: 6520 6f66 2047 5255 422c 2074 6865 206b e of GRUB, the k │ │ │ │ │ -0002c640: 6579 2069 6420 6361 6e20 6265 206f 6274 ey id can be obt │ │ │ │ │ -0002c650: 6169 6e65 6420 7573 696e 670a 2020 2020 ained using. │ │ │ │ │ -0002c660: 2027 6770 6720 2d2d 6669 6e67 6572 7072 'gpg --fingerpr │ │ │ │ │ -0002c670: 696e 7427 292e 2020 5468 6573 6520 6b65 int'). These ke │ │ │ │ │ -0002c680: 7973 2061 7265 2075 7365 6420 746f 2076 ys are used to v │ │ │ │ │ -0002c690: 616c 6964 6174 6520 7369 676e 6174 7572 alidate signatur │ │ │ │ │ -0002c6a0: 6573 0a20 2020 2020 7768 656e 2065 6e76 es. when env │ │ │ │ │ -0002c6b0: 6972 6f6e 6d65 6e74 2076 6172 6961 626c ironment variabl │ │ │ │ │ -0002c6c0: 6520 2763 6865 636b 5f73 6967 6e61 7475 e 'check_signatu │ │ │ │ │ -0002c6d0: 7265 7327 2069 7320 7365 7420 746f 2027 res' is set to ' │ │ │ │ │ -0002c6e0: 656e 666f 7263 6527 0a20 2020 2020 282a enforce'. (* │ │ │ │ │ -0002c6f0: 6e6f 7465 2063 6865 636b 5f73 6967 6e61 note check_signa │ │ │ │ │ -0002c700: 7475 7265 733a 3a29 2c20 616e 6420 6279 tures::), and by │ │ │ │ │ -0002c710: 2073 6f6d 6520 696e 766f 6361 7469 6f6e some invocation │ │ │ │ │ -0002c720: 7320 6f66 0a20 2020 2020 2776 6572 6966 s of. 'verif │ │ │ │ │ -0002c730: 795f 6465 7461 6368 6564 2720 282a 6e6f y_detached' (*no │ │ │ │ │ -0002c740: 7465 2076 6572 6966 795f 6465 7461 6368 te verify_detach │ │ │ │ │ -0002c750: 6564 3a3a 292e 2020 2a4e 6f74 6520 5573 ed::). *Note Us │ │ │ │ │ -0002c760: 696e 6720 6469 6769 7461 6c0a 2020 2020 ing digital. │ │ │ │ │ -0002c770: 2073 6967 6e61 7475 7265 733a 3a2c 2066 signatures::, f │ │ │ │ │ -0002c780: 6f72 206d 6f72 6520 696e 666f 726d 6174 or more informat │ │ │ │ │ -0002c790: 696f 6e2e 0a0a 1f0a 4669 6c65 3a20 6772 ion.....File: gr │ │ │ │ │ -0002c7a0: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ -0002c7b0: 6472 6976 656d 6170 2c20 204e 6578 743a drivemap, Next: │ │ │ │ │ -0002c7c0: 2065 6368 6f2c 2020 5072 6576 3a20 6469 echo, Prev: di │ │ │ │ │ -0002c7d0: 7374 7275 7374 2c20 2055 703a 2043 6f6d strust, Up: Com │ │ │ │ │ -0002c7e0: 6d61 6e64 2d6c 696e 6520 616e 6420 6d65 mand-line and me │ │ │ │ │ -0002c7f0: 6e75 2065 6e74 7279 2063 6f6d 6d61 6e64 nu entry command │ │ │ │ │ -0002c800: 730a 0a31 362e 332e 3234 2064 7269 7665 s..16.3.24 drive │ │ │ │ │ -0002c810: 6d61 700a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d map.------------ │ │ │ │ │ -0002c820: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ │ -0002c830: 643a 2064 7269 7665 6d61 7020 2d6c 7c2d d: drivemap -l|- │ │ │ │ │ -0002c840: 727c 5b2d 735d 2066 726f 6d5f 6472 6976 r|[-s] from_driv │ │ │ │ │ -0002c850: 6520 746f 5f64 7269 7665 0a20 2020 2020 e to_drive. │ │ │ │ │ -0002c860: 5769 7468 6f75 7420 6f70 7469 6f6e 732c Without options, │ │ │ │ │ -0002c870: 206d 6170 2074 6865 2064 7269 7665 2046 map the drive F │ │ │ │ │ -0002c880: 524f 4d5f 4452 4956 4520 746f 2074 6865 ROM_DRIVE to the │ │ │ │ │ -0002c890: 2064 7269 7665 2054 4f5f 4452 4956 452e drive TO_DRIVE. │ │ │ │ │ -0002c8a0: 0a20 2020 2020 5468 6973 2069 7320 6e65 . This is ne │ │ │ │ │ -0002c8b0: 6365 7373 6172 7920 7768 656e 2079 6f75 cessary when you │ │ │ │ │ -0002c8c0: 2063 6861 696e 2d6c 6f61 6420 736f 6d65 chain-load some │ │ │ │ │ -0002c8d0: 206f 7065 7261 7469 6e67 2073 7973 7465 operating syste │ │ │ │ │ -0002c8e0: 6d73 2c20 7375 6368 0a20 2020 2020 6173 ms, such. as │ │ │ │ │ -0002c8f0: 2044 4f53 2c20 6966 2073 7563 6820 616e DOS, if such an │ │ │ │ │ -0002c900: 204f 5320 7265 7369 6465 7320 6174 2061 OS resides at a │ │ │ │ │ -0002c910: 206e 6f6e 2d66 6972 7374 2064 7269 7665 non-first drive │ │ │ │ │ -0002c920: 2e20 2046 6f72 0a20 2020 2020 636f 6e76 . For. conv │ │ │ │ │ -0002c930: 656e 6965 6e63 652c 2061 6e79 2070 6172 enience, any par │ │ │ │ │ -0002c940: 7469 7469 6f6e 2073 7566 6669 7820 6f6e tition suffix on │ │ │ │ │ -0002c950: 2074 6865 2064 7269 7665 2069 7320 6967 the drive is ig │ │ │ │ │ -0002c960: 6e6f 7265 642c 2073 6f20 796f 750a 2020 nored, so you. │ │ │ │ │ -0002c970: 2020 2063 616e 2073 6166 656c 7920 7573 can safely us │ │ │ │ │ -0002c980: 6520 247b 726f 6f74 7d20 6173 2061 2064 e ${root} as a d │ │ │ │ │ -0002c990: 7269 7665 2073 7065 6369 6669 6361 7469 rive specificati │ │ │ │ │ -0002c9a0: 6f6e 2e0a 0a20 2020 2020 5769 7468 2074 on... With t │ │ │ │ │ -0002c9b0: 6865 2027 2d73 2720 6f70 7469 6f6e 2c20 he '-s' option, │ │ │ │ │ -0002c9c0: 7065 7266 6f72 6d20 7468 6520 7265 7665 perform the reve │ │ │ │ │ -0002c9d0: 7273 6520 6d61 7070 696e 6720 6173 2077 rse mapping as w │ │ │ │ │ -0002c9e0: 656c 6c2c 2073 7761 7070 696e 670a 2020 ell, swapping. │ │ │ │ │ -0002c9f0: 2020 2074 6865 2074 776f 2064 7269 7665 the two drive │ │ │ │ │ -0002ca00: 732e 0a0a 2020 2020 2057 6974 6820 7468 s... With th │ │ │ │ │ -0002ca10: 6520 272d 6c27 206f 7074 696f 6e2c 206c e '-l' option, l │ │ │ │ │ -0002ca20: 6973 7420 7468 6520 6375 7272 656e 7420 ist the current │ │ │ │ │ -0002ca30: 6d61 7070 696e 6773 2e0a 0a20 2020 2020 mappings... │ │ │ │ │ -0002ca40: 5769 7468 2074 6865 2027 2d72 2720 6f70 With the '-r' op │ │ │ │ │ -0002ca50: 7469 6f6e 2c20 7265 7365 7420 616c 6c20 tion, reset all │ │ │ │ │ -0002ca60: 6d61 7070 696e 6773 2074 6f20 7468 6520 mappings to the │ │ │ │ │ -0002ca70: 6465 6661 756c 7420 7661 6c75 6573 2e0a default values.. │ │ │ │ │ -0002ca80: 0a20 2020 2020 466f 7220 6578 616d 706c . For exampl │ │ │ │ │ -0002ca90: 653a 0a0a 2020 2020 2020 2020 2020 6472 e:.. dr │ │ │ │ │ -0002caa0: 6976 656d 6170 202d 7320 2868 6430 2920 ivemap -s (hd0) │ │ │ │ │ -0002cab0: 2868 6431 290a 0a1f 0a46 696c 653a 2067 (hd1)....File: g │ │ │ │ │ -0002cac0: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ -0002cad0: 2065 6368 6f2c 2020 4e65 7874 3a20 6576 echo, Next: ev │ │ │ │ │ -0002cae0: 616c 2c20 2050 7265 763a 2064 7269 7665 al, Prev: drive │ │ │ │ │ -0002caf0: 6d61 702c 2020 5570 3a20 436f 6d6d 616e map, Up: Comman │ │ │ │ │ -0002cb00: 642d 6c69 6e65 2061 6e64 206d 656e 7520 d-line and menu │ │ │ │ │ -0002cb10: 656e 7472 7920 636f 6d6d 616e 6473 0a0a entry commands.. │ │ │ │ │ -0002cb20: 3136 2e33 2e32 3520 6563 686f 0a2d 2d2d 16.3.25 echo.--- │ │ │ │ │ -0002cb30: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 ---------.. -- C │ │ │ │ │ -0002cb40: 6f6d 6d61 6e64 3a20 6563 686f 205b 2d6e ommand: echo [-n │ │ │ │ │ -0002cb50: 5d20 5b2d 655d 2073 7472 696e 6720 2e2e ] [-e] string .. │ │ │ │ │ -0002cb60: 2e0a 2020 2020 2044 6973 706c 6179 2074 .. Display t │ │ │ │ │ -0002cb70: 6865 2072 6571 7565 7374 6564 2074 6578 he requested tex │ │ │ │ │ -0002cb80: 7420 616e 642c 2075 6e6c 6573 7320 7468 t and, unless th │ │ │ │ │ -0002cb90: 6520 272d 6e27 206f 7074 696f 6e20 6973 e '-n' option is │ │ │ │ │ -0002cba0: 2075 7365 642c 2061 0a20 2020 2020 7472 used, a. tr │ │ │ │ │ -0002cbb0: 6169 6c69 6e67 206e 6577 206c 696e 652e ailing new line. │ │ │ │ │ -0002cbc0: 2020 4966 2074 6865 7265 2069 7320 6d6f If there is mo │ │ │ │ │ -0002cbd0: 7265 2074 6861 6e20 6f6e 6520 7374 7269 re than one stri │ │ │ │ │ -0002cbe0: 6e67 2c20 7468 6579 2061 7265 0a20 2020 ng, they are. │ │ │ │ │ -0002cbf0: 2020 7365 7061 7261 7465 6420 6279 2073 separated by s │ │ │ │ │ -0002cc00: 7061 6365 7320 696e 2074 6865 206f 7574 paces in the out │ │ │ │ │ -0002cc10: 7075 742e 2020 4173 2075 7375 616c 2069 put. As usual i │ │ │ │ │ -0002cc20: 6e20 4752 5542 2063 6f6d 6d61 6e64 732c n GRUB commands, │ │ │ │ │ -0002cc30: 0a20 2020 2020 7661 7269 6162 6c65 7320 . variables │ │ │ │ │ -0002cc40: 6d61 7920 6265 2073 7562 7374 6974 7574 may be substitut │ │ │ │ │ -0002cc50: 6564 2075 7369 6e67 2027 247b 7661 727d ed using '${var} │ │ │ │ │ -0002cc60: 272e 0a0a 2020 2020 2054 6865 2027 2d65 '... The '-e │ │ │ │ │ -0002cc70: 2720 6f70 7469 6f6e 2065 6e61 626c 6573 ' option enables │ │ │ │ │ -0002cc80: 2069 6e74 6572 7072 6574 6174 696f 6e20 interpretation │ │ │ │ │ -0002cc90: 6f66 2062 6163 6b73 6c61 7368 2065 7363 of backslash esc │ │ │ │ │ -0002cca0: 6170 6573 2e20 2054 6865 0a20 2020 2020 apes. The. │ │ │ │ │ -0002ccb0: 666f 6c6c 6f77 696e 6720 7365 7175 656e following sequen │ │ │ │ │ -0002ccc0: 6365 7320 6172 6520 7265 636f 676e 6973 ces are recognis │ │ │ │ │ -0002ccd0: 6564 3a0a 0a20 2020 2020 275c 5c27 0a20 ed:.. '\\'. │ │ │ │ │ -0002cce0: 2020 2020 2020 2020 2062 6163 6b73 6c61 backsla │ │ │ │ │ -0002ccf0: 7368 0a0a 2020 2020 2027 5c61 270a 2020 sh.. '\a'. │ │ │ │ │ -0002cd00: 2020 2020 2020 2020 616c 6572 7420 2842 alert (B │ │ │ │ │ -0002cd10: 454c 290a 0a20 2020 2020 275c 6327 0a20 EL).. '\c'. │ │ │ │ │ -0002cd20: 2020 2020 2020 2020 2073 7570 7072 6573 suppres │ │ │ │ │ -0002cd30: 7320 7472 6169 6c69 6e67 206e 6577 206c s trailing new l │ │ │ │ │ -0002cd40: 696e 650a 0a20 2020 2020 275c 6627 0a20 ine.. '\f'. │ │ │ │ │ -0002cd50: 2020 2020 2020 2020 2066 6f72 6d20 6665 form fe │ │ │ │ │ -0002cd60: 6564 0a0a 2020 2020 2027 5c6e 270a 2020 ed.. '\n'. │ │ │ │ │ -0002cd70: 2020 2020 2020 2020 6e65 7720 6c69 6e65 new line │ │ │ │ │ -0002cd80: 0a0a 2020 2020 2027 5c72 270a 2020 2020 .. '\r'. │ │ │ │ │ -0002cd90: 2020 2020 2020 6361 7272 6961 6765 2072 carriage r │ │ │ │ │ -0002cda0: 6574 7572 6e0a 0a20 2020 2020 275c 7427 eturn.. '\t' │ │ │ │ │ -0002cdb0: 0a20 2020 2020 2020 2020 2068 6f72 697a . horiz │ │ │ │ │ -0002cdc0: 6f6e 7461 6c20 7461 620a 0a20 2020 2020 ontal tab.. │ │ │ │ │ -0002cdd0: 275c 7627 0a20 2020 2020 2020 2020 2076 '\v'. v │ │ │ │ │ -0002cde0: 6572 7469 6361 6c20 7461 620a 0a20 2020 ertical tab.. │ │ │ │ │ -0002cdf0: 2020 5768 656e 2069 6e74 6572 7072 6574 When interpret │ │ │ │ │ -0002ce00: 696e 6720 6261 636b 736c 6173 6820 6573 ing backslash es │ │ │ │ │ -0002ce10: 6361 7065 732c 2062 6163 6b73 6c61 7368 capes, backslash │ │ │ │ │ -0002ce20: 2066 6f6c 6c6f 7765 6420 6279 2061 6e79 followed by any │ │ │ │ │ -0002ce30: 0a20 2020 2020 6f74 6865 7220 6368 6172 . other char │ │ │ │ │ -0002ce40: 6163 7465 7220 7769 6c6c 2070 7269 6e74 acter will print │ │ │ │ │ -0002ce50: 2074 6861 7420 6368 6172 6163 7465 722e that character. │ │ │ │ │ -0002ce60: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ -0002ce70: 6e66 6f2c 2020 4e6f 6465 3a20 6576 616c nfo, Node: eval │ │ │ │ │ -0002ce80: 2c20 204e 6578 743a 2065 7870 6f72 742c , Next: export, │ │ │ │ │ -0002ce90: 2020 5072 6576 3a20 6563 686f 2c20 2055 Prev: echo, U │ │ │ │ │ -0002cea0: 703a 2043 6f6d 6d61 6e64 2d6c 696e 6520 p: Command-line │ │ │ │ │ -0002ceb0: 616e 6420 6d65 6e75 2065 6e74 7279 2063 and menu entry c │ │ │ │ │ -0002cec0: 6f6d 6d61 6e64 730a 0a31 362e 332e 3236 ommands..16.3.26 │ │ │ │ │ -0002ced0: 2065 7661 6c0a 2d2d 2d2d 2d2d 2d2d 2d2d eval.---------- │ │ │ │ │ -0002cee0: 2d2d 0a0a 202d 2d20 436f 6d6d 616e 643a --.. -- Command: │ │ │ │ │ -0002cef0: 2065 7661 6c20 7374 7269 6e67 202e 2e2e eval string ... │ │ │ │ │ -0002cf00: 0a20 2020 2020 436f 6e63 6174 656e 6174 . Concatenat │ │ │ │ │ -0002cf10: 6520 6172 6775 6d65 6e74 7320 746f 6765 e arguments toge │ │ │ │ │ -0002cf20: 7468 6572 2075 7369 6e67 2073 696e 676c ther using singl │ │ │ │ │ -0002cf30: 6520 7370 6163 6520 6173 2073 6570 6172 e space as separ │ │ │ │ │ -0002cf40: 6174 6f72 2061 6e64 0a20 2020 2020 6576 ator and. ev │ │ │ │ │ -0002cf50: 616c 7561 7465 2072 6573 756c 7420 6173 aluate result as │ │ │ │ │ -0002cf60: 2073 6571 7565 6e63 6520 6f66 2047 5255 sequence of GRU │ │ │ │ │ -0002cf70: 4220 636f 6d6d 616e 6473 2e0a 0a1f 0a46 B commands.....F │ │ │ │ │ -0002cf80: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ -0002cf90: 204e 6f64 653a 2065 7870 6f72 742c 2020 Node: export, │ │ │ │ │ -0002cfa0: 4e65 7874 3a20 6661 6c73 652c 2020 5072 Next: false, Pr │ │ │ │ │ -0002cfb0: 6576 3a20 6576 616c 2c20 2055 703a 2043 ev: eval, Up: C │ │ │ │ │ -0002cfc0: 6f6d 6d61 6e64 2d6c 696e 6520 616e 6420 ommand-line and │ │ │ │ │ -0002cfd0: 6d65 6e75 2065 6e74 7279 2063 6f6d 6d61 menu entry comma │ │ │ │ │ -0002cfe0: 6e64 730a 0a31 362e 332e 3237 2065 7870 nds..16.3.27 exp │ │ │ │ │ -0002cff0: 6f72 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ort.------------ │ │ │ │ │ -0002d000: 2d2d 0a0a 202d 2d20 436f 6d6d 616e 643a --.. -- Command: │ │ │ │ │ -0002d010: 2065 7870 6f72 7420 656e 7676 6172 0a20 export envvar. │ │ │ │ │ -0002d020: 2020 2020 4578 706f 7274 2074 6865 2065 Export the e │ │ │ │ │ -0002d030: 6e76 6972 6f6e 6d65 6e74 2076 6172 6961 nvironment varia │ │ │ │ │ -0002d040: 626c 6520 454e 5656 4152 2e20 2045 7870 ble ENVVAR. Exp │ │ │ │ │ -0002d050: 6f72 7465 6420 7661 7269 6162 6c65 7320 orted variables │ │ │ │ │ -0002d060: 6172 650a 2020 2020 2076 6973 6962 6c65 are. visible │ │ │ │ │ -0002d070: 2074 6f20 7375 6273 6964 6961 7279 2063 to subsidiary c │ │ │ │ │ -0002d080: 6f6e 6669 6775 7261 7469 6f6e 2066 696c onfiguration fil │ │ │ │ │ -0002d090: 6573 206c 6f61 6465 6420 7573 696e 670a es loaded using. │ │ │ │ │ -0002d0a0: 2020 2020 2027 636f 6e66 6967 6669 6c65 'configfile │ │ │ │ │ -0002d0b0: 272e 0a0a 1f0a 4669 6c65 3a20 6772 7562 '.....File: grub │ │ │ │ │ -0002d0c0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 6661 .info, Node: fa │ │ │ │ │ -0002d0d0: 6c73 652c 2020 4e65 7874 3a20 6765 7474 lse, Next: gett │ │ │ │ │ -0002d0e0: 6578 742c 2020 5072 6576 3a20 6578 706f ext, Prev: expo │ │ │ │ │ -0002d0f0: 7274 2c20 2055 703a 2043 6f6d 6d61 6e64 rt, Up: Command │ │ │ │ │ -0002d100: 2d6c 696e 6520 616e 6420 6d65 6e75 2065 -line and menu e │ │ │ │ │ -0002d110: 6e74 7279 2063 6f6d 6d61 6e64 730a 0a31 ntry commands..1 │ │ │ │ │ -0002d120: 362e 332e 3238 2066 616c 7365 0a2d 2d2d 6.3.28 false.--- │ │ │ │ │ -0002d130: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 ----------.. -- │ │ │ │ │ -0002d140: 436f 6d6d 616e 643a 2066 616c 7365 0a20 Command: false. │ │ │ │ │ -0002d150: 2020 2020 446f 206e 6f74 6869 6e67 2c20 Do nothing, │ │ │ │ │ -0002d160: 756e 7375 6363 6573 7366 756c 6c79 2e20 unsuccessfully. │ │ │ │ │ -0002d170: 2054 6869 7320 6973 206d 6169 6e6c 7920 This is mainly │ │ │ │ │ -0002d180: 7573 6566 756c 2069 6e20 636f 6e74 726f useful in contro │ │ │ │ │ -0002d190: 6c0a 2020 2020 2063 6f6e 7374 7275 6374 l. construct │ │ │ │ │ -0002d1a0: 7320 7375 6368 2061 7320 2769 6627 2061 s such as 'if' a │ │ │ │ │ -0002d1b0: 6e64 2027 7768 696c 6527 2028 2a6e 6f74 nd 'while' (*not │ │ │ │ │ -0002d1c0: 6520 5368 656c 6c2d 6c69 6b65 2073 6372 e Shell-like scr │ │ │ │ │ -0002d1d0: 6970 7469 6e67 3a3a 292e 0a0a 1f0a 4669 ipting::).....Fi │ │ │ │ │ -0002d1e0: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ -0002d1f0: 4e6f 6465 3a20 6765 7474 6578 742c 2020 Node: gettext, │ │ │ │ │ -0002d200: 4e65 7874 3a20 6770 7473 796e 632c 2020 Next: gptsync, │ │ │ │ │ -0002d210: 5072 6576 3a20 6661 6c73 652c 2020 5570 Prev: false, Up │ │ │ │ │ -0002d220: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ │ -0002d230: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ │ -0002d240: 6d6d 616e 6473 0a0a 3136 2e33 2e32 3920 mmands..16.3.29 │ │ │ │ │ -0002d250: 6765 7474 6578 740a 2d2d 2d2d 2d2d 2d2d gettext.-------- │ │ │ │ │ -0002d260: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d -------.. -- Com │ │ │ │ │ -0002d270: 6d61 6e64 3a20 6765 7474 6578 7420 7374 mand: gettext st │ │ │ │ │ -0002d280: 7269 6e67 0a20 2020 2020 5472 616e 736c ring. Transl │ │ │ │ │ -0002d290: 6174 6520 5354 5249 4e47 2069 6e74 6f20 ate STRING into │ │ │ │ │ -0002d2a0: 7468 6520 6375 7272 656e 7420 6c61 6e67 the current lang │ │ │ │ │ -0002d2b0: 7561 6765 2e0a 0a20 2020 2020 5468 6520 uage... The │ │ │ │ │ -0002d2c0: 6375 7272 656e 7420 6c61 6e67 7561 6765 current language │ │ │ │ │ -0002d2d0: 2063 6f64 6520 6973 2073 746f 7265 6420 code is stored │ │ │ │ │ -0002d2e0: 696e 2074 6865 2027 6c61 6e67 2720 7661 in the 'lang' va │ │ │ │ │ -0002d2f0: 7269 6162 6c65 2069 6e0a 2020 2020 2047 riable in. G │ │ │ │ │ -0002d300: 5255 4227 7320 656e 7669 726f 6e6d 656e RUB's environmen │ │ │ │ │ -0002d310: 7420 282a 6e6f 7465 206c 616e 673a 3a29 t (*note lang::) │ │ │ │ │ -0002d320: 2e20 2054 7261 6e73 6c61 7469 6f6e 2066 . Translation f │ │ │ │ │ -0002d330: 696c 6573 2069 6e20 4d4f 2066 6f72 6d61 iles in MO forma │ │ │ │ │ -0002d340: 740a 2020 2020 2061 7265 2072 6561 6420 t. are read │ │ │ │ │ -0002d350: 6672 6f6d 2027 6c6f 6361 6c65 5f64 6972 from 'locale_dir │ │ │ │ │ -0002d360: 2720 282a 6e6f 7465 206c 6f63 616c 655f ' (*note locale_ │ │ │ │ │ -0002d370: 6469 723a 3a29 2c20 7573 7561 6c6c 790a dir::), usually. │ │ │ │ │ -0002d380: 2020 2020 2027 2f62 6f6f 742f 6772 7562 '/boot/grub │ │ │ │ │ -0002d390: 2f6c 6f63 616c 6527 2e0a 0a1f 0a46 696c /locale'.....Fil │ │ │ │ │ -0002d3a0: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ -0002d3b0: 6f64 653a 2067 7074 7379 6e63 2c20 204e ode: gptsync, N │ │ │ │ │ -0002d3c0: 6578 743a 2068 616c 742c 2020 5072 6576 ext: halt, Prev │ │ │ │ │ -0002d3d0: 3a20 6765 7474 6578 742c 2020 5570 3a20 : gettext, Up: │ │ │ │ │ -0002d3e0: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ -0002d3f0: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ │ -0002d400: 616e 6473 0a0a 3136 2e33 2e33 3020 6770 ands..16.3.30 gp │ │ │ │ │ -0002d410: 7473 796e 630a 2d2d 2d2d 2d2d 2d2d 2d2d tsync.---------- │ │ │ │ │ -0002d420: 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 -----.. -- Comma │ │ │ │ │ -0002d430: 6e64 3a20 6770 7473 796e 6320 6465 7669 nd: gptsync devi │ │ │ │ │ -0002d440: 6365 205b 7061 7274 6974 696f 6e5b 2b2f ce [partition[+/ │ │ │ │ │ -0002d450: 2d5b 7479 7065 5d5d 5d20 2e2e 2e0a 2020 -[type]]] .... │ │ │ │ │ -0002d460: 2020 2044 6973 6b73 2075 7369 6e67 2074 Disks using t │ │ │ │ │ -0002d470: 6865 2047 5549 4420 5061 7274 6974 696f he GUID Partitio │ │ │ │ │ -0002d480: 6e20 5461 626c 6520 2847 5054 2920 616c n Table (GPT) al │ │ │ │ │ -0002d490: 736f 2068 6176 6520 6120 6c65 6761 6379 so have a legacy │ │ │ │ │ -0002d4a0: 0a20 2020 2020 4d61 7374 6572 2042 6f6f . Master Boo │ │ │ │ │ -0002d4b0: 7420 5265 636f 7264 2028 4d42 5229 2070 t Record (MBR) p │ │ │ │ │ -0002d4c0: 6172 7469 7469 6f6e 2074 6162 6c65 2066 artition table f │ │ │ │ │ -0002d4d0: 6f72 2063 6f6d 7061 7469 6269 6c69 7479 or compatibility │ │ │ │ │ -0002d4e0: 2077 6974 6820 7468 650a 2020 2020 2042 with the. B │ │ │ │ │ -0002d4f0: 494f 5320 616e 6420 7769 7468 206f 6c64 IOS and with old │ │ │ │ │ -0002d500: 6572 206f 7065 7261 7469 6e67 2073 7973 er operating sys │ │ │ │ │ -0002d510: 7465 6d73 2e20 2054 6865 206c 6567 6163 tems. The legac │ │ │ │ │ -0002d520: 7920 4d42 5220 6361 6e20 6f6e 6c79 0a20 y MBR can only. │ │ │ │ │ -0002d530: 2020 2020 7265 7072 6573 656e 7420 6120 represent a │ │ │ │ │ -0002d540: 6c69 6d69 7465 6420 7375 6273 6574 206f limited subset o │ │ │ │ │ -0002d550: 6620 4750 5420 7061 7274 6974 696f 6e20 f GPT partition │ │ │ │ │ -0002d560: 656e 7472 6965 732e 0a0a 2020 2020 2054 entries... T │ │ │ │ │ -0002d570: 6869 7320 636f 6d6d 616e 6420 706f 7075 his command popu │ │ │ │ │ -0002d580: 6c61 7465 7320 7468 6520 6c65 6761 6379 lates the legacy │ │ │ │ │ -0002d590: 204d 4252 2077 6974 6820 7468 6520 7370 MBR with the sp │ │ │ │ │ -0002d5a0: 6563 6966 6965 6420 5041 5254 4954 494f ecified PARTITIO │ │ │ │ │ -0002d5b0: 4e0a 2020 2020 2065 6e74 7269 6573 206f N. entries o │ │ │ │ │ -0002d5c0: 6e20 4445 5649 4345 2e20 2055 7020 746f n DEVICE. Up to │ │ │ │ │ -0002d5d0: 2074 6872 6565 2070 6172 7469 7469 6f6e three partition │ │ │ │ │ -0002d5e0: 7320 6d61 7920 6265 2075 7365 642e 0a0a s may be used... │ │ │ │ │ -0002d5f0: 2020 2020 2054 5950 4520 6973 2061 6e20 TYPE is an │ │ │ │ │ -0002d600: 4d42 5220 7061 7274 6974 696f 6e20 7479 MBR partition ty │ │ │ │ │ -0002d610: 7065 2063 6f64 653b 2070 7265 6669 7820 pe code; prefix │ │ │ │ │ -0002d620: 7769 7468 2027 3078 2720 6966 2079 6f75 with '0x' if you │ │ │ │ │ -0002d630: 2077 616e 7420 746f 0a20 2020 2020 656e want to. en │ │ │ │ │ -0002d640: 7465 7220 7468 6973 2069 6e20 6865 7861 ter this in hexa │ │ │ │ │ -0002d650: 6465 6369 6d61 6c2e 2020 5468 6520 7365 decimal. The se │ │ │ │ │ -0002d660: 7061 7261 746f 7220 6265 7477 6565 6e20 parator between │ │ │ │ │ -0002d670: 5041 5254 4954 494f 4e20 616e 640a 2020 PARTITION and. │ │ │ │ │ -0002d680: 2020 2054 5950 4520 6d61 7920 6265 2027 TYPE may be ' │ │ │ │ │ -0002d690: 2b27 2074 6f20 6d61 6b65 2074 6865 2070 +' to make the p │ │ │ │ │ -0002d6a0: 6172 7469 7469 6f6e 2061 6374 6976 652c artition active, │ │ │ │ │ -0002d6b0: 206f 7220 272d 2720 746f 206d 616b 6520 or '-' to make │ │ │ │ │ -0002d6c0: 6974 0a20 2020 2020 696e 6163 7469 7665 it. inactive │ │ │ │ │ -0002d6d0: 3b20 6f6e 6c79 206f 6e65 2070 6172 7469 ; only one parti │ │ │ │ │ -0002d6e0: 7469 6f6e 206d 6179 2062 6520 6163 7469 tion may be acti │ │ │ │ │ -0002d6f0: 7665 2e20 2049 6620 626f 7468 2074 6865 ve. If both the │ │ │ │ │ -0002d700: 2073 6570 6172 6174 6f72 0a20 2020 2020 separator. │ │ │ │ │ -0002d710: 616e 6420 7479 7065 2061 7265 206f 6d69 and type are omi │ │ │ │ │ -0002d720: 7474 6564 2c20 7468 656e 2074 6865 2070 tted, then the p │ │ │ │ │ -0002d730: 6172 7469 7469 6f6e 2077 696c 6c20 6265 artition will be │ │ │ │ │ -0002d740: 2069 6e61 6374 6976 652e 0a0a 1f0a 4669 inactive.....Fi │ │ │ │ │ -0002d750: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ -0002d760: 4e6f 6465 3a20 6861 6c74 2c20 204e 6578 Node: halt, Nex │ │ │ │ │ -0002d770: 743a 2068 6173 6873 756d 2c20 2050 7265 t: hashsum, Pre │ │ │ │ │ -0002d780: 763a 2067 7074 7379 6e63 2c20 2055 703a v: gptsync, Up: │ │ │ │ │ -0002d790: 2043 6f6d 6d61 6e64 2d6c 696e 6520 616e Command-line an │ │ │ │ │ -0002d7a0: 6420 6d65 6e75 2065 6e74 7279 2063 6f6d d menu entry com │ │ │ │ │ -0002d7b0: 6d61 6e64 730a 0a31 362e 332e 3331 2068 mands..16.3.31 h │ │ │ │ │ -0002d7c0: 616c 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d alt.------------ │ │ │ │ │ -0002d7d0: 0a0a 202d 2d20 436f 6d6d 616e 643a 2068 .. -- Command: h │ │ │ │ │ -0002d7e0: 616c 7420 2d2d 6e6f 2d61 706d 0a20 2020 alt --no-apm. │ │ │ │ │ -0002d7f0: 2020 5468 6520 636f 6d6d 616e 6420 6861 The command ha │ │ │ │ │ -0002d800: 6c74 7320 7468 6520 636f 6d70 7574 6572 lts the computer │ │ │ │ │ -0002d810: 2e20 2049 6620 7468 6520 272d 2d6e 6f2d . If the '--no- │ │ │ │ │ -0002d820: 6170 6d27 206f 7074 696f 6e20 6973 0a20 apm' option is. │ │ │ │ │ -0002d830: 2020 2020 7370 6563 6966 6965 642c 206e specified, n │ │ │ │ │ -0002d840: 6f20 4150 4d20 4249 4f53 2063 616c 6c20 o APM BIOS call │ │ │ │ │ -0002d850: 6973 2070 6572 666f 726d 6564 2e20 204f is performed. O │ │ │ │ │ -0002d860: 7468 6572 7769 7365 2c20 7468 6520 636f therwise, the co │ │ │ │ │ -0002d870: 6d70 7574 6572 0a20 2020 2020 6973 2073 mputer. is s │ │ │ │ │ -0002d880: 6875 7420 646f 776e 2075 7369 6e67 2041 hut down using A │ │ │ │ │ -0002d890: 504d 2e0a 0a1f 0a46 696c 653a 2067 7275 PM.....File: gru │ │ │ │ │ -0002d8a0: 622e 696e 666f 2c20 204e 6f64 653a 2068 b.info, Node: h │ │ │ │ │ -0002d8b0: 6173 6873 756d 2c20 204e 6578 743a 2068 ashsum, Next: h │ │ │ │ │ -0002d8c0: 656c 702c 2020 5072 6576 3a20 6861 6c74 elp, Prev: halt │ │ │ │ │ -0002d8d0: 2c20 2055 703a 2043 6f6d 6d61 6e64 2d6c , Up: Command-l │ │ │ │ │ -0002d8e0: 696e 6520 616e 6420 6d65 6e75 2065 6e74 ine and menu ent │ │ │ │ │ -0002d8f0: 7279 2063 6f6d 6d61 6e64 730a 0a31 362e ry commands..16. │ │ │ │ │ -0002d900: 332e 3332 2068 6173 6873 756d 0a2d 2d2d 3.32 hashsum.--- │ │ │ │ │ -0002d910: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d ------------.. - │ │ │ │ │ -0002d920: 2d20 436f 6d6d 616e 643a 2068 6173 6873 - Command: hashs │ │ │ │ │ -0002d930: 756d 202d 2d68 6173 6820 6861 7368 202d um --hash hash - │ │ │ │ │ -0002d940: 2d6b 6565 702d 676f 696e 6720 2d2d 756e -keep-going --un │ │ │ │ │ -0002d950: 636f 6d70 7265 7373 202d 2d63 6865 636b compress --check │ │ │ │ │ -0002d960: 2066 696c 650a 2020 2020 2020 2020 2020 file. │ │ │ │ │ -0002d970: 5b2d 2d70 7265 6669 7820 6469 725d 7c66 [--prefix dir]|f │ │ │ │ │ -0002d980: 696c 6520 2e2e 2e0a 2020 2020 2043 6f6d ile .... Com │ │ │ │ │ -0002d990: 7075 7465 206f 7220 7665 7269 6679 2066 pute or verify f │ │ │ │ │ -0002d9a0: 696c 6520 6861 7368 6573 2e20 2048 6173 ile hashes. Has │ │ │ │ │ -0002d9b0: 6820 7479 7065 2069 7320 7365 6c65 6374 h type is select │ │ │ │ │ -0002d9c0: 6564 2077 6974 6820 6f70 7469 6f6e 0a20 ed with option. │ │ │ │ │ -0002d9d0: 2020 2020 272d 2d68 6173 6827 2e20 2053 '--hash'. S │ │ │ │ │ -0002d9e0: 7570 706f 7274 6564 2068 6173 6865 7320 upported hashes │ │ │ │ │ -0002d9f0: 6172 653a 2027 6164 6c65 7233 3227 2c20 are: 'adler32', │ │ │ │ │ -0002da00: 2763 7263 3634 272c 2027 6372 6333 3227 'crc64', 'crc32' │ │ │ │ │ -0002da10: 2c0a 2020 2020 2027 6372 6333 3272 6663 ,. 'crc32rfc │ │ │ │ │ -0002da20: 3135 3130 272c 2027 6372 6332 3472 6663 1510', 'crc24rfc │ │ │ │ │ -0002da30: 3234 3430 272c 2027 6d64 3427 2c20 276d 2440', 'md4', 'm │ │ │ │ │ -0002da40: 6435 272c 2027 7269 7065 6d64 3136 3027 d5', 'ripemd160' │ │ │ │ │ -0002da50: 2c20 2773 6861 3127 2c0a 2020 2020 2027 , 'sha1',. ' │ │ │ │ │ -0002da60: 7368 6132 3234 272c 2027 7368 6132 3536 sha224', 'sha256 │ │ │ │ │ -0002da70: 272c 2027 7368 6135 3132 272c 2027 7368 ', 'sha512', 'sh │ │ │ │ │ -0002da80: 6133 3834 272c 2027 7469 6765 7231 3932 a384', 'tiger192 │ │ │ │ │ -0002da90: 272c 2027 7469 6765 7227 2c0a 2020 2020 ', 'tiger',. │ │ │ │ │ -0002daa0: 2027 7469 6765 7232 272c 2027 7768 6972 'tiger2', 'whir │ │ │ │ │ -0002dab0: 6c70 6f6f 6c27 2e20 204f 7074 696f 6e20 lpool'. Option │ │ │ │ │ -0002dac0: 272d 2d75 6e63 6f6d 7072 6573 7327 2075 '--uncompress' u │ │ │ │ │ -0002dad0: 6e63 6f6d 7072 6573 7365 7320 6669 6c65 ncompresses file │ │ │ │ │ -0002dae0: 730a 2020 2020 2062 6566 6f72 6520 636f s. before co │ │ │ │ │ -0002daf0: 6d70 7574 696e 6720 6861 7368 2e0a 0a20 mputing hash... │ │ │ │ │ -0002db00: 2020 2020 5768 656e 206c 6973 7420 6f66 When list of │ │ │ │ │ -0002db10: 2066 696c 6573 2069 7320 6769 7665 6e2c files is given, │ │ │ │ │ -0002db20: 2068 6173 6820 6f66 2065 6163 6820 6669 hash of each fi │ │ │ │ │ -0002db30: 6c65 2069 7320 636f 6d70 7574 6564 2061 le is computed a │ │ │ │ │ -0002db40: 6e64 0a20 2020 2020 7072 696e 7465 642c nd. printed, │ │ │ │ │ -0002db50: 2066 6f6c 6c6f 7765 6420 6279 2066 696c followed by fil │ │ │ │ │ -0002db60: 6520 6e61 6d65 2c20 6561 6368 2066 696c e name, each fil │ │ │ │ │ -0002db70: 6520 6f6e 2061 206e 6577 206c 696e 652e e on a new line. │ │ │ │ │ -0002db80: 0a0a 2020 2020 2057 6865 6e20 6f70 7469 .. When opti │ │ │ │ │ -0002db90: 6f6e 2027 2d2d 6368 6563 6b27 2069 7320 on '--check' is │ │ │ │ │ -0002dba0: 6769 7665 6e2c 2069 7420 706f 696e 7473 given, it points │ │ │ │ │ -0002dbb0: 2074 6f20 6120 6669 6c65 2074 6861 7420 to a file that │ │ │ │ │ -0002dbc0: 636f 6e74 6169 6e73 0a20 2020 2020 6c69 contains. li │ │ │ │ │ -0002dbd0: 7374 206f 6620 4841 5348 204e 414d 4520 st of HASH NAME │ │ │ │ │ -0002dbe0: 7061 6972 7320 696e 2074 6865 2073 616d pairs in the sam │ │ │ │ │ -0002dbf0: 6520 666f 726d 6174 2061 7320 7573 6564 e format as used │ │ │ │ │ -0002dc00: 2062 7920 554e 4958 2027 6d64 3573 756d by UNIX 'md5sum │ │ │ │ │ -0002dc10: 270a 2020 2020 2063 6f6d 6d61 6e64 2e20 '. command. │ │ │ │ │ -0002dc20: 204f 7074 696f 6e20 272d 2d70 7265 6669 Option '--prefi │ │ │ │ │ -0002dc30: 7827 206d 6179 2062 6520 7573 6564 2074 x' may be used t │ │ │ │ │ -0002dc40: 6f20 6769 7665 2064 6972 6563 746f 7279 o give directory │ │ │ │ │ -0002dc50: 2077 6865 7265 0a20 2020 2020 6669 6c65 where. file │ │ │ │ │ -0002dc60: 7320 6172 6520 6c6f 6361 7465 642e 2020 s are located. │ │ │ │ │ -0002dc70: 4861 7368 2076 6572 6966 6963 6174 696f Hash verificatio │ │ │ │ │ -0002dc80: 6e20 7374 6f70 7320 6166 7465 7220 7468 n stops after th │ │ │ │ │ -0002dc90: 6520 6669 7273 740a 2020 2020 206d 6973 e first. mis │ │ │ │ │ -0002dca0: 6d61 7463 6820 7761 7320 666f 756e 6420 match was found │ │ │ │ │ -0002dcb0: 756e 6c65 7373 206f 7074 696f 6e20 272d unless option '- │ │ │ │ │ -0002dcc0: 2d6b 6565 702d 676f 696e 6727 2077 6173 -keep-going' was │ │ │ │ │ -0002dcd0: 2067 6976 656e 2e20 2054 6865 0a20 2020 given. The. │ │ │ │ │ -0002dce0: 2020 6578 6974 2063 6f64 6520 2724 3f27 exit code '$?' │ │ │ │ │ -0002dcf0: 2069 7320 7365 7420 746f 2030 2069 6620 is set to 0 if │ │ │ │ │ -0002dd00: 6861 7368 2076 6572 6966 6963 6174 696f hash verificatio │ │ │ │ │ -0002dd10: 6e20 6973 2073 7563 6365 7373 6675 6c2e n is successful. │ │ │ │ │ -0002dd20: 2020 4966 0a20 2020 2020 6974 2066 6169 If. it fai │ │ │ │ │ -0002dd30: 6c73 2c20 2724 3f27 2069 7320 7365 7420 ls, '$?' is set │ │ │ │ │ -0002dd40: 746f 2061 206e 6f6e 7a65 726f 2076 616c to a nonzero val │ │ │ │ │ -0002dd50: 7565 2e0a 0a1f 0a46 696c 653a 2067 7275 ue.....File: gru │ │ │ │ │ -0002dd60: 622e 696e 666f 2c20 204e 6f64 653a 2068 b.info, Node: h │ │ │ │ │ -0002dd70: 656c 702c 2020 4e65 7874 3a20 696e 6974 elp, Next: init │ │ │ │ │ -0002dd80: 7264 2c20 2050 7265 763a 2068 6173 6873 rd, Prev: hashs │ │ │ │ │ -0002dd90: 756d 2c20 2055 703a 2043 6f6d 6d61 6e64 um, Up: Command │ │ │ │ │ -0002dda0: 2d6c 696e 6520 616e 6420 6d65 6e75 2065 -line and menu e │ │ │ │ │ -0002ddb0: 6e74 7279 2063 6f6d 6d61 6e64 730a 0a31 ntry commands..1 │ │ │ │ │ -0002ddc0: 362e 332e 3333 2068 656c 700a 2d2d 2d2d 6.3.33 help.---- │ │ │ │ │ -0002ddd0: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ │ -0002dde0: 6d6d 616e 643a 2068 656c 7020 5b70 6174 mmand: help [pat │ │ │ │ │ -0002ddf0: 7465 726e 202e 2e2e 5d0a 2020 2020 2044 tern ...]. D │ │ │ │ │ -0002de00: 6973 706c 6179 2068 656c 7066 756c 2069 isplay helpful i │ │ │ │ │ -0002de10: 6e66 6f72 6d61 7469 6f6e 2061 626f 7574 nformation about │ │ │ │ │ -0002de20: 2062 7569 6c74 696e 2063 6f6d 6d61 6e64 builtin command │ │ │ │ │ -0002de30: 732e 2020 4966 2079 6f75 2064 6f20 6e6f s. If you do no │ │ │ │ │ -0002de40: 740a 2020 2020 2073 7065 6369 6679 2050 t. specify P │ │ │ │ │ -0002de50: 4154 5445 524e 2c20 7468 6973 2063 6f6d ATTERN, this com │ │ │ │ │ -0002de60: 6d61 6e64 2073 686f 7773 2073 686f 7274 mand shows short │ │ │ │ │ -0002de70: 2064 6573 6372 6970 7469 6f6e 7320 6f66 descriptions of │ │ │ │ │ -0002de80: 2061 6c6c 0a20 2020 2020 6176 6169 6c61 all. availa │ │ │ │ │ -0002de90: 626c 6520 636f 6d6d 616e 6473 2e0a 0a20 ble commands... │ │ │ │ │ -0002dea0: 2020 2020 4966 2079 6f75 2073 7065 6369 If you speci │ │ │ │ │ -0002deb0: 6679 2061 6e79 2050 4154 5445 524e 532c fy any PATTERNS, │ │ │ │ │ -0002dec0: 2069 7420 6469 7370 6c61 7973 206c 6f6e it displays lon │ │ │ │ │ -0002ded0: 6765 7220 696e 666f 726d 6174 696f 6e20 ger information │ │ │ │ │ -0002dee0: 6162 6f75 740a 2020 2020 2065 6163 6820 about. each │ │ │ │ │ -0002def0: 6f66 2074 6865 2063 6f6d 6d61 6e64 7320 of the commands │ │ │ │ │ -0002df00: 7768 6f73 6520 6e61 6d65 7320 6265 6769 whose names begi │ │ │ │ │ -0002df10: 6e20 7769 7468 2074 686f 7365 2050 4154 n with those PAT │ │ │ │ │ -0002df20: 5445 524e 532e 0a0a 1f0a 4669 6c65 3a20 TERNS.....File: │ │ │ │ │ -0002df30: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ -0002df40: 3a20 696e 6974 7264 2c20 204e 6578 743a : initrd, Next: │ │ │ │ │ -0002df50: 2069 6e69 7472 6431 362c 2020 5072 6576 initrd16, Prev │ │ │ │ │ -0002df60: 3a20 6865 6c70 2c20 2055 703a 2043 6f6d : help, Up: Com │ │ │ │ │ -0002df70: 6d61 6e64 2d6c 696e 6520 616e 6420 6d65 mand-line and me │ │ │ │ │ -0002df80: 6e75 2065 6e74 7279 2063 6f6d 6d61 6e64 nu entry command │ │ │ │ │ -0002df90: 730a 0a31 362e 332e 3334 2069 6e69 7472 s..16.3.34 initr │ │ │ │ │ -0002dfa0: 640a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d d.-------------- │ │ │ │ │ -0002dfb0: 0a0a 202d 2d20 436f 6d6d 616e 643a 2069 .. -- Command: i │ │ │ │ │ -0002dfc0: 6e69 7472 6420 6669 6c65 205b 6669 6c65 nitrd file [file │ │ │ │ │ -0002dfd0: 202e 2e2e 5d0a 2020 2020 204c 6f61 642c ...]. Load, │ │ │ │ │ -0002dfe0: 2069 6e20 6f72 6465 722c 2061 6c6c 2069 in order, all i │ │ │ │ │ -0002dff0: 6e69 7469 616c 2072 616d 6469 736b 7320 nitial ramdisks │ │ │ │ │ -0002e000: 666f 7220 6120 4c69 6e75 7820 6b65 726e for a Linux kern │ │ │ │ │ -0002e010: 656c 2069 6d61 6765 2c20 616e 640a 2020 el image, and. │ │ │ │ │ -0002e020: 2020 2073 6574 2074 6865 2061 7070 726f set the appro │ │ │ │ │ -0002e030: 7072 6961 7465 2070 6172 616d 6574 6572 priate parameter │ │ │ │ │ -0002e040: 7320 696e 2074 6865 204c 696e 7578 2073 s in the Linux s │ │ │ │ │ -0002e050: 6574 7570 2061 7265 6120 696e 206d 656d etup area in mem │ │ │ │ │ -0002e060: 6f72 792e 0a20 2020 2020 5468 6973 206d ory.. This m │ │ │ │ │ -0002e070: 6179 206f 6e6c 7920 6265 2075 7365 6420 ay only be used │ │ │ │ │ -0002e080: 6166 7465 7220 7468 6520 276c 696e 7578 after the 'linux │ │ │ │ │ -0002e090: 2720 636f 6d6d 616e 6420 282a 6e6f 7465 ' command (*note │ │ │ │ │ -0002e0a0: 206c 696e 7578 3a3a 2920 6861 730a 2020 linux::) has. │ │ │ │ │ -0002e0b0: 2020 2062 6565 6e20 7275 6e2e 2020 5365 been run. Se │ │ │ │ │ -0002e0c0: 6520 616c 736f 202a 6e6f 7465 2047 4e55 e also *note GNU │ │ │ │ │ -0002e0d0: 2f4c 696e 7578 3a3a 2e0a 0a1f 0a46 696c /Linux::.....Fil │ │ │ │ │ -0002e0e0: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ -0002e0f0: 6f64 653a 2069 6e69 7472 6431 362c 2020 ode: initrd16, │ │ │ │ │ -0002e100: 4e65 7874 3a20 696e 736d 6f64 2c20 2050 Next: insmod, P │ │ │ │ │ -0002e110: 7265 763a 2069 6e69 7472 642c 2020 5570 rev: initrd, Up │ │ │ │ │ -0002e120: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ │ -0002e130: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ │ -0002e140: 6d6d 616e 6473 0a0a 3136 2e33 2e33 3520 mmands..16.3.35 │ │ │ │ │ -0002e150: 696e 6974 7264 3136 0a2d 2d2d 2d2d 2d2d initrd16.------- │ │ │ │ │ -0002e160: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 ---------.. -- C │ │ │ │ │ -0002e170: 6f6d 6d61 6e64 3a20 696e 6974 7264 3136 ommand: initrd16 │ │ │ │ │ -0002e180: 2066 696c 6520 5b66 696c 6520 2e2e 2e5d file [file ...] │ │ │ │ │ -0002e190: 0a20 2020 2020 4c6f 6164 2c20 696e 206f . Load, in o │ │ │ │ │ -0002e1a0: 7264 6572 2c20 616c 6c20 696e 6974 6961 rder, all initia │ │ │ │ │ -0002e1b0: 6c20 7261 6d64 6973 6b73 2066 6f72 2061 l ramdisks for a │ │ │ │ │ -0002e1c0: 204c 696e 7578 206b 6572 6e65 6c20 696d Linux kernel im │ │ │ │ │ -0002e1d0: 6167 6520 746f 2062 650a 2020 2020 2062 age to be. b │ │ │ │ │ -0002e1e0: 6f6f 7465 6420 696e 2031 362d 6269 7420 ooted in 16-bit │ │ │ │ │ -0002e1f0: 6d6f 6465 2c20 616e 6420 7365 7420 7468 mode, and set th │ │ │ │ │ -0002e200: 6520 6170 7072 6f70 7269 6174 6520 7061 e appropriate pa │ │ │ │ │ -0002e210: 7261 6d65 7465 7273 2069 6e20 7468 650a rameters in the. │ │ │ │ │ -0002e220: 2020 2020 204c 696e 7578 2073 6574 7570 Linux setup │ │ │ │ │ -0002e230: 2061 7265 6120 696e 206d 656d 6f72 792e area in memory. │ │ │ │ │ -0002e240: 2020 5468 6973 206d 6179 206f 6e6c 7920 This may only │ │ │ │ │ -0002e250: 6265 2075 7365 6420 6166 7465 7220 7468 be used after th │ │ │ │ │ -0002e260: 650a 2020 2020 2027 6c69 6e75 7831 3627 e. 'linux16' │ │ │ │ │ -0002e270: 2063 6f6d 6d61 6e64 2028 2a6e 6f74 6520 command (*note │ │ │ │ │ -0002e280: 6c69 6e75 7831 363a 3a29 2068 6173 2062 linux16::) has b │ │ │ │ │ -0002e290: 6565 6e20 7275 6e2e 2020 5365 6520 616c een run. See al │ │ │ │ │ -0002e2a0: 736f 202a 6e6f 7465 0a20 2020 2020 474e so *note. GN │ │ │ │ │ -0002e2b0: 552f 4c69 6e75 783a 3a2e 0a0a 2020 2020 U/Linux::... │ │ │ │ │ -0002e2c0: 2054 6869 7320 636f 6d6d 616e 6420 6973 This command is │ │ │ │ │ -0002e2d0: 206f 6e6c 7920 6176 6169 6c61 626c 6520 only available │ │ │ │ │ -0002e2e0: 6f6e 2078 3836 2073 7973 7465 6d73 2e0a on x86 systems.. │ │ │ │ │ -0002e2f0: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ -0002e300: 666f 2c20 204e 6f64 653a 2069 6e73 6d6f fo, Node: insmo │ │ │ │ │ -0002e310: 642c 2020 4e65 7874 3a20 6b65 7973 7461 d, Next: keysta │ │ │ │ │ -0002e320: 7475 732c 2020 5072 6576 3a20 696e 6974 tus, Prev: init │ │ │ │ │ -0002e330: 7264 3136 2c20 2055 703a 2043 6f6d 6d61 rd16, Up: Comma │ │ │ │ │ -0002e340: 6e64 2d6c 696e 6520 616e 6420 6d65 6e75 nd-line and menu │ │ │ │ │ -0002e350: 2065 6e74 7279 2063 6f6d 6d61 6e64 730a entry commands. │ │ │ │ │ -0002e360: 0a31 362e 332e 3336 2069 6e73 6d6f 640a .16.3.36 insmod. │ │ │ │ │ -0002e370: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ -0002e380: 202d 2d20 436f 6d6d 616e 643a 2069 6e73 -- Command: ins │ │ │ │ │ -0002e390: 6d6f 6420 6d6f 6475 6c65 0a20 2020 2020 mod module. │ │ │ │ │ -0002e3a0: 496e 7365 7274 2074 6865 2064 796e 616d Insert the dynam │ │ │ │ │ -0002e3b0: 6963 2047 5255 4220 6d6f 6475 6c65 2063 ic GRUB module c │ │ │ │ │ -0002e3c0: 616c 6c65 6420 4d4f 4455 4c45 2e0a 0a1f alled MODULE.... │ │ │ │ │ -0002e3d0: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ -0002e3e0: 2c20 204e 6f64 653a 206b 6579 7374 6174 , Node: keystat │ │ │ │ │ -0002e3f0: 7573 2c20 204e 6578 743a 206c 696e 7578 us, Next: linux │ │ │ │ │ -0002e400: 2c20 2050 7265 763a 2069 6e73 6d6f 642c , Prev: insmod, │ │ │ │ │ -0002e410: 2020 5570 3a20 436f 6d6d 616e 642d 6c69 Up: Command-li │ │ │ │ │ -0002e420: 6e65 2061 6e64 206d 656e 7520 656e 7472 ne and menu entr │ │ │ │ │ -0002e430: 7920 636f 6d6d 616e 6473 0a0a 3136 2e33 y commands..16.3 │ │ │ │ │ -0002e440: 2e33 3720 6b65 7973 7461 7475 730a 2d2d .37 keystatus.-- │ │ │ │ │ -0002e450: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ -0002e460: 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 6b65 . -- Command: ke │ │ │ │ │ -0002e470: 7973 7461 7475 7320 5b2d 2d73 6869 6674 ystatus [--shift │ │ │ │ │ -0002e480: 5d20 5b2d 2d63 7472 6c5d 205b 2d2d 616c ] [--ctrl] [--al │ │ │ │ │ -0002e490: 745d 0a20 2020 2020 5265 7475 726e 2074 t]. Return t │ │ │ │ │ -0002e4a0: 7275 6520 6966 2074 6865 2053 6869 6674 rue if the Shift │ │ │ │ │ -0002e4b0: 2c20 436f 6e74 726f 6c2c 206f 7220 416c , Control, or Al │ │ │ │ │ -0002e4c0: 7420 6d6f 6469 6669 6572 206b 6579 7320 t modifier keys │ │ │ │ │ -0002e4d0: 6172 6520 6865 6c64 0a20 2020 2020 646f are held. do │ │ │ │ │ -0002e4e0: 776e 2c20 6173 2072 6571 7565 7374 6564 wn, as requested │ │ │ │ │ -0002e4f0: 2062 7920 6f70 7469 6f6e 732e 2020 5468 by options. Th │ │ │ │ │ -0002e500: 6973 2069 7320 7573 6566 756c 2069 6e20 is is useful in │ │ │ │ │ -0002e510: 7363 7269 7074 696e 672c 2074 6f0a 2020 scripting, to. │ │ │ │ │ -0002e520: 2020 2061 6c6c 6f77 2073 6f6d 6520 7573 allow some us │ │ │ │ │ -0002e530: 6572 2063 6f6e 7472 6f6c 206f 7665 7220 er control over │ │ │ │ │ -0002e540: 6265 6861 7669 6f75 7220 7769 7468 6f75 behaviour withou │ │ │ │ │ -0002e550: 7420 6861 7669 6e67 2074 6f20 7761 6974 t having to wait │ │ │ │ │ -0002e560: 2066 6f72 2061 0a20 2020 2020 6b65 7970 for a. keyp │ │ │ │ │ -0002e570: 7265 7373 2e0a 0a20 2020 2020 4368 6563 ress... Chec │ │ │ │ │ -0002e580: 6b69 6e67 206b 6579 206d 6f64 6966 6965 king key modifie │ │ │ │ │ -0002e590: 7220 7374 6174 7573 2069 7320 6f6e 6c79 r status is only │ │ │ │ │ -0002e5a0: 2073 7570 706f 7274 6564 206f 6e20 736f supported on so │ │ │ │ │ -0002e5b0: 6d65 2070 6c61 7466 6f72 6d73 2e0a 2020 me platforms.. │ │ │ │ │ -0002e5c0: 2020 2049 6620 696e 766f 6b65 6420 7769 If invoked wi │ │ │ │ │ -0002e5d0: 7468 6f75 7420 616e 7920 6f70 7469 6f6e thout any option │ │ │ │ │ -0002e5e0: 732c 2074 6865 2027 6b65 7973 7461 7475 s, the 'keystatu │ │ │ │ │ -0002e5f0: 7327 2063 6f6d 6d61 6e64 2072 6574 7572 s' command retur │ │ │ │ │ -0002e600: 6e73 0a20 2020 2020 7472 7565 2069 6620 ns. true if │ │ │ │ │ -0002e610: 616e 6420 6f6e 6c79 2069 6620 6368 6563 and only if chec │ │ │ │ │ -0002e620: 6b69 6e67 206b 6579 206d 6f64 6966 6965 king key modifie │ │ │ │ │ -0002e630: 7220 7374 6174 7573 2069 7320 7375 7070 r status is supp │ │ │ │ │ -0002e640: 6f72 7465 642e 0a0a 1f0a 4669 6c65 3a20 orted.....File: │ │ │ │ │ -0002e650: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ -0002e660: 3a20 6c69 6e75 782c 2020 4e65 7874 3a20 : linux, Next: │ │ │ │ │ -0002e670: 6c69 6e75 7831 362c 2020 5072 6576 3a20 linux16, Prev: │ │ │ │ │ -0002e680: 6b65 7973 7461 7475 732c 2020 5570 3a20 keystatus, Up: │ │ │ │ │ -0002e690: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ -0002e6a0: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ │ -0002e6b0: 616e 6473 0a0a 3136 2e33 2e33 3820 6c69 ands..16.3.38 li │ │ │ │ │ -0002e6c0: 6e75 780a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d nux.------------ │ │ │ │ │ -0002e6d0: 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 -.. -- Command: │ │ │ │ │ -0002e6e0: 6c69 6e75 7820 6669 6c65 202e 2e2e 0a20 linux file .... │ │ │ │ │ -0002e6f0: 2020 2020 4c6f 6164 2061 204c 696e 7578 Load a Linux │ │ │ │ │ -0002e700: 206b 6572 6e65 6c20 696d 6167 6520 6672 kernel image fr │ │ │ │ │ -0002e710: 6f6d 2046 494c 452e 2020 5468 6520 7265 om FILE. The re │ │ │ │ │ -0002e720: 7374 206f 6620 7468 6520 6c69 6e65 2069 st of the line i │ │ │ │ │ -0002e730: 730a 2020 2020 2070 6173 7365 6420 7665 s. passed ve │ │ │ │ │ -0002e740: 7262 6174 696d 2061 7320 7468 6520 226b rbatim as the "k │ │ │ │ │ -0002e750: 6572 6e65 6c20 636f 6d6d 616e 642d 6c69 ernel command-li │ │ │ │ │ -0002e760: 6e65 222e 2020 416e 7920 696e 6974 7264 ne". Any initrd │ │ │ │ │ -0002e770: 206d 7573 7420 6265 0a20 2020 2020 7265 must be. re │ │ │ │ │ -0002e780: 6c6f 6164 6564 2061 6674 6572 2075 7369 loaded after usi │ │ │ │ │ -0002e790: 6e67 2074 6869 7320 636f 6d6d 616e 6420 ng this command │ │ │ │ │ -0002e7a0: 282a 6e6f 7465 2069 6e69 7472 643a 3a29 (*note initrd::) │ │ │ │ │ -0002e7b0: 2e0a 0a20 2020 2020 4f6e 2078 3836 2073 ... On x86 s │ │ │ │ │ -0002e7c0: 7973 7465 6d73 2c20 7468 6520 6b65 726e ystems, the kern │ │ │ │ │ -0002e7d0: 656c 2077 696c 6c20 6265 2062 6f6f 7465 el will be boote │ │ │ │ │ -0002e7e0: 6420 7573 696e 6720 7468 6520 3332 2d62 d using the 32-b │ │ │ │ │ -0002e7f0: 6974 2062 6f6f 740a 2020 2020 2070 726f it boot. pro │ │ │ │ │ -0002e800: 746f 636f 6c2e 2020 4e6f 7465 2074 6861 tocol. Note tha │ │ │ │ │ -0002e810: 7420 7468 6973 206d 6561 6e73 2074 6861 t this means tha │ │ │ │ │ -0002e820: 7420 7468 6520 2776 6761 3d27 2062 6f6f t the 'vga=' boo │ │ │ │ │ -0002e830: 7420 6f70 7469 6f6e 2077 696c 6c0a 2020 t option will. │ │ │ │ │ -0002e840: 2020 206e 6f74 2077 6f72 6b3b 2069 6620 not work; if │ │ │ │ │ -0002e850: 796f 7520 7761 6e74 2074 6f20 7365 7420 you want to set │ │ │ │ │ -0002e860: 6120 7370 6563 6961 6c20 7669 6465 6f20 a special video │ │ │ │ │ -0002e870: 6d6f 6465 2c20 796f 7520 7769 6c6c 206e mode, you will n │ │ │ │ │ -0002e880: 6565 6420 746f 0a20 2020 2020 7573 6520 eed to. use │ │ │ │ │ -0002e890: 4752 5542 2063 6f6d 6d61 6e64 7320 7375 GRUB commands su │ │ │ │ │ -0002e8a0: 6368 2061 7320 2773 6574 2067 6678 7061 ch as 'set gfxpa │ │ │ │ │ -0002e8b0: 796c 6f61 643d 3130 3234 7837 3638 2720 yload=1024x768' │ │ │ │ │ -0002e8c0: 6f72 2027 7365 740a 2020 2020 2067 6678 or 'set. gfx │ │ │ │ │ -0002e8d0: 7061 796c 6f61 643d 6b65 6570 2720 2874 payload=keep' (t │ │ │ │ │ -0002e8e0: 6f20 6b65 6570 2074 6865 2073 616d 6520 o keep the same │ │ │ │ │ -0002e8f0: 6d6f 6465 2061 7320 7573 6564 2069 6e20 mode as used in │ │ │ │ │ -0002e900: 4752 5542 2920 696e 7374 6561 642e 0a20 GRUB) instead.. │ │ │ │ │ -0002e910: 2020 2020 4752 5542 2063 616e 2061 7574 GRUB can aut │ │ │ │ │ -0002e920: 6f6d 6174 6963 616c 6c79 2064 6574 6563 omatically detec │ │ │ │ │ -0002e930: 7420 736f 6d65 2075 7365 7320 6f66 2027 t some uses of ' │ │ │ │ │ -0002e940: 7667 613d 2720 616e 6420 7472 616e 736c vga=' and transl │ │ │ │ │ -0002e950: 6174 650a 2020 2020 2074 6865 6d20 746f ate. them to │ │ │ │ │ -0002e960: 2061 7070 726f 7072 6961 7465 2073 6574 appropriate set │ │ │ │ │ -0002e970: 7469 6e67 7320 6f66 2027 6766 7870 6179 tings of 'gfxpay │ │ │ │ │ -0002e980: 6c6f 6164 272e 2020 5468 6520 276c 696e load'. The 'lin │ │ │ │ │ -0002e990: 7578 3136 270a 2020 2020 2063 6f6d 6d61 ux16'. comma │ │ │ │ │ -0002e9a0: 6e64 2028 2a6e 6f74 6520 6c69 6e75 7831 nd (*note linux1 │ │ │ │ │ -0002e9b0: 363a 3a29 2061 766f 6964 7320 7468 6973 6::) avoids this │ │ │ │ │ -0002e9c0: 2072 6573 7472 6963 7469 6f6e 2e0a 0a1f restriction.... │ │ │ │ │ -0002e9d0: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ -0002e9e0: 2c20 204e 6f64 653a 206c 696e 7578 3136 , Node: linux16 │ │ │ │ │ -0002e9f0: 2c20 204e 6578 743a 206c 6973 745f 656e , Next: list_en │ │ │ │ │ -0002ea00: 762c 2020 5072 6576 3a20 6c69 6e75 782c v, Prev: linux, │ │ │ │ │ -0002ea10: 2020 5570 3a20 436f 6d6d 616e 642d 6c69 Up: Command-li │ │ │ │ │ -0002ea20: 6e65 2061 6e64 206d 656e 7520 656e 7472 ne and menu entr │ │ │ │ │ -0002ea30: 7920 636f 6d6d 616e 6473 0a0a 3136 2e33 y commands..16.3 │ │ │ │ │ -0002ea40: 2e33 3920 6c69 6e75 7831 360a 2d2d 2d2d .39 linux16.---- │ │ │ │ │ -0002ea50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d -----------.. -- │ │ │ │ │ -0002ea60: 2043 6f6d 6d61 6e64 3a20 6c69 6e75 7831 Command: linux1 │ │ │ │ │ -0002ea70: 3620 6669 6c65 202e 2e2e 0a20 2020 2020 6 file .... │ │ │ │ │ -0002ea80: 4c6f 6164 2061 204c 696e 7578 206b 6572 Load a Linux ker │ │ │ │ │ -0002ea90: 6e65 6c20 696d 6167 6520 6672 6f6d 2046 nel image from F │ │ │ │ │ -0002eaa0: 494c 4520 696e 2031 362d 6269 7420 6d6f ILE in 16-bit mo │ │ │ │ │ -0002eab0: 6465 2e20 2054 6865 2072 6573 7420 6f66 de. The rest of │ │ │ │ │ -0002eac0: 0a20 2020 2020 7468 6520 6c69 6e65 2069 . the line i │ │ │ │ │ -0002ead0: 7320 7061 7373 6564 2076 6572 6261 7469 s passed verbati │ │ │ │ │ -0002eae0: 6d20 6173 2074 6865 2022 6b65 726e 656c m as the "kernel │ │ │ │ │ -0002eaf0: 2063 6f6d 6d61 6e64 2d6c 696e 6522 2e20 command-line". │ │ │ │ │ -0002eb00: 2041 6e79 0a20 2020 2020 696e 6974 7264 Any. initrd │ │ │ │ │ -0002eb10: 206d 7573 7420 6265 2072 656c 6f61 6465 must be reloade │ │ │ │ │ -0002eb20: 6420 6166 7465 7220 7573 696e 6720 7468 d after using th │ │ │ │ │ -0002eb30: 6973 2063 6f6d 6d61 6e64 2028 2a6e 6f74 is command (*not │ │ │ │ │ -0002eb40: 650a 2020 2020 2069 6e69 7472 6431 363a e. initrd16: │ │ │ │ │ -0002eb50: 3a29 2e0a 0a20 2020 2020 5468 6520 6b65 :)... The ke │ │ │ │ │ -0002eb60: 726e 656c 2077 696c 6c20 6265 2062 6f6f rnel will be boo │ │ │ │ │ -0002eb70: 7465 6420 7573 696e 6720 7468 6520 7472 ted using the tr │ │ │ │ │ -0002eb80: 6164 6974 696f 6e61 6c20 3136 2d62 6974 aditional 16-bit │ │ │ │ │ -0002eb90: 2062 6f6f 740a 2020 2020 2070 726f 746f boot. proto │ │ │ │ │ -0002eba0: 636f 6c2e 2020 4173 2077 656c 6c20 6173 col. As well as │ │ │ │ │ -0002ebb0: 2062 7970 6173 7369 6e67 2070 726f 626c bypassing probl │ │ │ │ │ -0002ebc0: 656d 7320 7769 7468 2027 7667 613d 2720 ems with 'vga=' │ │ │ │ │ -0002ebd0: 6465 7363 7269 6265 6420 696e 0a20 2020 described in. │ │ │ │ │ -0002ebe0: 2020 2a6e 6f74 6520 6c69 6e75 783a 3a2c *note linux::, │ │ │ │ │ -0002ebf0: 2074 6869 7320 7065 726d 6974 7320 626f this permits bo │ │ │ │ │ -0002ec00: 6f74 696e 6720 736f 6d65 206f 7468 6572 oting some other │ │ │ │ │ -0002ec10: 2070 726f 6772 616d 7320 7468 6174 0a20 programs that. │ │ │ │ │ -0002ec20: 2020 2020 696d 706c 656d 656e 7420 7468 implement th │ │ │ │ │ -0002ec30: 6520 4c69 6e75 7820 626f 6f74 2070 726f e Linux boot pro │ │ │ │ │ -0002ec40: 746f 636f 6c20 666f 7220 7468 6520 7361 tocol for the sa │ │ │ │ │ -0002ec50: 6b65 206f 6620 636f 6e76 656e 6965 6e63 ke of convenienc │ │ │ │ │ -0002ec60: 652e 0a0a 2020 2020 2054 6869 7320 636f e... This co │ │ │ │ │ -0002ec70: 6d6d 616e 6420 6973 206f 6e6c 7920 6176 mmand is only av │ │ │ │ │ -0002ec80: 6169 6c61 626c 6520 6f6e 2078 3836 2073 ailable on x86 s │ │ │ │ │ -0002ec90: 7973 7465 6d73 2e0a 0a1f 0a46 696c 653a ystems.....File: │ │ │ │ │ -0002eca0: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ -0002ecb0: 653a 206c 6973 745f 656e 762c 2020 4e65 e: list_env, Ne │ │ │ │ │ -0002ecc0: 7874 3a20 6c69 7374 5f74 7275 7374 6564 xt: list_trusted │ │ │ │ │ -0002ecd0: 2c20 2050 7265 763a 206c 696e 7578 3136 , Prev: linux16 │ │ │ │ │ -0002ece0: 2c20 2055 703a 2043 6f6d 6d61 6e64 2d6c , Up: Command-l │ │ │ │ │ -0002ecf0: 696e 6520 616e 6420 6d65 6e75 2065 6e74 ine and menu ent │ │ │ │ │ -0002ed00: 7279 2063 6f6d 6d61 6e64 730a 0a31 362e ry commands..16. │ │ │ │ │ -0002ed10: 332e 3430 206c 6973 745f 656e 760a 2d2d 3.40 list_env.-- │ │ │ │ │ -0002ed20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ -0002ed30: 202d 2d20 436f 6d6d 616e 643a 206c 6973 -- Command: lis │ │ │ │ │ -0002ed40: 745f 656e 7620 5b2d 2d66 696c 6520 6669 t_env [--file fi │ │ │ │ │ -0002ed50: 6c65 5d0a 2020 2020 204c 6973 7420 616c le]. List al │ │ │ │ │ -0002ed60: 6c20 7661 7269 6162 6c65 7320 696e 2074 l variables in t │ │ │ │ │ -0002ed70: 6865 2065 6e76 6972 6f6e 6d65 6e74 2062 he environment b │ │ │ │ │ -0002ed80: 6c6f 636b 2066 696c 652e 2020 2a4e 6f74 lock file. *Not │ │ │ │ │ -0002ed90: 650a 2020 2020 2045 6e76 6972 6f6e 6d65 e. Environme │ │ │ │ │ -0002eda0: 6e74 2062 6c6f 636b 3a3a 2e0a 0a20 2020 nt block::... │ │ │ │ │ -0002edb0: 2020 5468 6520 272d 2d66 696c 6527 206f The '--file' o │ │ │ │ │ -0002edc0: 7074 696f 6e20 6f76 6572 7269 6465 7320 ption overrides │ │ │ │ │ -0002edd0: 7468 6520 6465 6661 756c 7420 6c6f 6361 the default loca │ │ │ │ │ -0002ede0: 7469 6f6e 206f 6620 7468 650a 2020 2020 tion of the. │ │ │ │ │ -0002edf0: 2065 6e76 6972 6f6e 6d65 6e74 2062 6c6f environment blo │ │ │ │ │ -0002ee00: 636b 2e0a 0a1f 0a46 696c 653a 2067 7275 ck.....File: gru │ │ │ │ │ -0002ee10: 622e 696e 666f 2c20 204e 6f64 653a 206c b.info, Node: l │ │ │ │ │ -0002ee20: 6973 745f 7472 7573 7465 642c 2020 4e65 ist_trusted, Ne │ │ │ │ │ -0002ee30: 7874 3a20 6c6f 6164 5f65 6e76 2c20 2050 xt: load_env, P │ │ │ │ │ -0002ee40: 7265 763a 206c 6973 745f 656e 762c 2020 rev: list_env, │ │ │ │ │ -0002ee50: 5570 3a20 436f 6d6d 616e 642d 6c69 6e65 Up: Command-line │ │ │ │ │ -0002ee60: 2061 6e64 206d 656e 7520 656e 7472 7920 and menu entry │ │ │ │ │ -0002ee70: 636f 6d6d 616e 6473 0a0a 3136 2e33 2e34 commands..16.3.4 │ │ │ │ │ -0002ee80: 3120 6c69 7374 5f74 7275 7374 6564 0a2d 1 list_trusted.- │ │ │ │ │ +000292f0: 2020 2020 2041 6464 2070 7562 6c69 6320 Add public │ │ │ │ │ +00029300: 6b65 7920 746f 206c 6973 7420 6f66 2074 key to list of t │ │ │ │ │ +00029310: 7275 7374 6564 206b 6579 730a 2a20 756e rusted keys.* un │ │ │ │ │ +00029320: 7365 743a 3a20 2020 2020 2020 2020 2020 set:: │ │ │ │ │ +00029330: 2020 2020 2020 2020 2020 2020 556e 7365 Unse │ │ │ │ │ +00029340: 7420 616e 2065 6e76 6972 6f6e 6d65 6e74 t an environment │ │ │ │ │ +00029350: 2076 6172 6961 626c 650a 2a20 7665 7269 variable.* veri │ │ │ │ │ +00029360: 6679 5f64 6574 6163 6865 643a 3a20 2020 fy_detached:: │ │ │ │ │ +00029370: 2020 2020 2020 2020 2020 5665 7269 6679 Verify │ │ │ │ │ +00029380: 2064 6574 6163 6865 6420 6469 6769 7461 detached digita │ │ │ │ │ +00029390: 6c20 7369 676e 6174 7572 650a 2a20 7669 l signature.* vi │ │ │ │ │ +000293a0: 6465 6f69 6e66 6f3a 3a20 2020 2020 2020 deoinfo:: │ │ │ │ │ +000293b0: 2020 2020 2020 2020 2020 2020 4c69 7374 List │ │ │ │ │ +000293c0: 2061 7661 696c 6162 6c65 2076 6964 656f available video │ │ │ │ │ +000293d0: 206d 6f64 6573 0a2a 2077 726d 7372 3a3a modes.* wrmsr:: │ │ │ │ │ +000293e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +000293f0: 2020 2020 2020 2057 7269 7465 2076 616c Write val │ │ │ │ │ +00029400: 7565 7320 746f 206d 6f64 656c 2d73 7065 ues to model-spe │ │ │ │ │ +00029410: 6369 6669 6320 7265 6769 7374 6572 730a cific registers. │ │ │ │ │ +00029420: 2a20 7865 6e5f 6879 7065 7276 6973 6f72 * xen_hypervisor │ │ │ │ │ +00029430: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ │ +00029440: 4c6f 6164 2078 656e 2068 7970 6572 7669 Load xen hypervi │ │ │ │ │ +00029450: 736f 7220 6269 6e61 7279 2028 6f6e 6c79 sor binary (only │ │ │ │ │ +00029460: 206f 6e20 4141 7263 6836 3429 0a2a 2078 on AArch64).* x │ │ │ │ │ +00029470: 656e 5f6d 6f64 756c 653a 3a20 2020 2020 en_module:: │ │ │ │ │ +00029480: 2020 2020 2020 2020 2020 2020 204c 6f61 Loa │ │ │ │ │ +00029490: 6420 7865 6e20 6d6f 6475 6c65 7320 666f d xen modules fo │ │ │ │ │ +000294a0: 7220 7865 6e20 6879 7065 7276 6973 6f72 r xen hypervisor │ │ │ │ │ +000294b0: 2028 6f6e 6c79 206f 6e20 4141 7263 6836 (only on AArch6 │ │ │ │ │ +000294c0: 3429 0a0a 1f0a 4669 6c65 3a20 6772 7562 4)....File: grub │ │ │ │ │ +000294d0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 5b2c .info, Node: [, │ │ │ │ │ +000294e0: 2020 4e65 7874 3a20 6163 7069 2c20 2055 Next: acpi, U │ │ │ │ │ +000294f0: 703a 2043 6f6d 6d61 6e64 2d6c 696e 6520 p: Command-line │ │ │ │ │ +00029500: 616e 6420 6d65 6e75 2065 6e74 7279 2063 and menu entry c │ │ │ │ │ +00029510: 6f6d 6d61 6e64 730a 0a31 362e 332e 3120 ommands..16.3.1 │ │ │ │ │ +00029520: 5b0a 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 [.--------.. -- │ │ │ │ │ +00029530: 436f 6d6d 616e 643a 205b 2065 7870 7265 Command: [ expre │ │ │ │ │ +00029540: 7373 696f 6e20 5d0a 2020 2020 2041 6c69 ssion ]. Ali │ │ │ │ │ +00029550: 6173 2066 6f72 2027 7465 7374 2045 5850 as for 'test EXP │ │ │ │ │ +00029560: 5245 5353 494f 4e27 2028 2a6e 6f74 6520 RESSION' (*note │ │ │ │ │ +00029570: 7465 7374 3a3a 292e 0a0a 1f0a 4669 6c65 test::).....File │ │ │ │ │ +00029580: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ +00029590: 6465 3a20 6163 7069 2c20 204e 6578 743a de: acpi, Next: │ │ │ │ │ +000295a0: 2061 7574 6865 6e74 6963 6174 652c 2020 authenticate, │ │ │ │ │ +000295b0: 5072 6576 3a20 5b2c 2020 5570 3a20 436f Prev: [, Up: Co │ │ │ │ │ +000295c0: 6d6d 616e 642d 6c69 6e65 2061 6e64 206d mmand-line and m │ │ │ │ │ +000295d0: 656e 7520 656e 7472 7920 636f 6d6d 616e enu entry comman │ │ │ │ │ +000295e0: 6473 0a0a 3136 2e33 2e32 2061 6370 690a ds..16.3.2 acpi. │ │ │ │ │ +000295f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d -----------.. -- │ │ │ │ │ +00029600: 2043 6f6d 6d61 6e64 3a20 6163 7069 205b Command: acpi [ │ │ │ │ │ +00029610: 2d31 7c2d 325d 205b 2d2d 6578 636c 7564 -1|-2] [--exclud │ │ │ │ │ +00029620: 653d 7461 626c 6531 2c2e 2e2e 7c2d 2d6c e=table1,...|--l │ │ │ │ │ +00029630: 6f61 642d 6f6e 6c79 3d74 6162 6c65 312c oad-only=table1, │ │ │ │ │ +00029640: 2e2e 2e5d 0a20 2020 2020 2020 2020 205b ...]. [ │ │ │ │ │ +00029650: 2d2d 6f65 6d69 643d 6964 5d20 5b2d 2d6f --oemid=id] [--o │ │ │ │ │ +00029660: 656d 7461 626c 653d 7461 626c 655d 205b emtable=table] [ │ │ │ │ │ +00029670: 2d2d 6f65 6d74 6162 6c65 7265 763d 7265 --oemtablerev=re │ │ │ │ │ +00029680: 765d 0a20 2020 2020 2020 2020 205b 2d2d v]. [-- │ │ │ │ │ +00029690: 6f65 6d74 6162 6c65 6372 6561 746f 723d oemtablecreator= │ │ │ │ │ +000296a0: 6372 6561 746f 725d 205b 2d2d 6f65 6d74 creator] [--oemt │ │ │ │ │ +000296b0: 6162 6c65 6372 6561 746f 7272 6576 3d72 ablecreatorrev=r │ │ │ │ │ +000296c0: 6576 5d0a 2020 2020 2020 2020 2020 5b2d ev]. [- │ │ │ │ │ +000296d0: 2d6e 6f2d 6562 6461 5d20 6669 6c65 6e61 -no-ebda] filena │ │ │ │ │ +000296e0: 6d65 202e 2e2e 0a20 2020 2020 4d6f 6465 me .... Mode │ │ │ │ │ +000296f0: 726e 2042 494f 5320 7379 7374 656d 7320 rn BIOS systems │ │ │ │ │ +00029700: 6e6f 726d 616c 6c79 2069 6d70 6c65 6d65 normally impleme │ │ │ │ │ +00029710: 6e74 2074 6865 2041 6476 616e 6365 6420 nt the Advanced │ │ │ │ │ +00029720: 436f 6e66 6967 7572 6174 696f 6e0a 2020 Configuration. │ │ │ │ │ +00029730: 2020 2061 6e64 2050 6f77 6572 2049 6e74 and Power Int │ │ │ │ │ +00029740: 6572 6661 6365 2028 4143 5049 292c 2061 erface (ACPI), a │ │ │ │ │ +00029750: 6e64 2064 6566 696e 6520 7661 7269 6f75 nd define variou │ │ │ │ │ +00029760: 7320 7461 626c 6573 2074 6861 7420 6465 s tables that de │ │ │ │ │ +00029770: 7363 7269 6265 0a20 2020 2020 7468 6520 scribe. the │ │ │ │ │ +00029780: 696e 7465 7266 6163 6520 6265 7477 6565 interface betwee │ │ │ │ │ +00029790: 6e20 616e 2041 4350 492d 636f 6d70 6c69 n an ACPI-compli │ │ │ │ │ +000297a0: 616e 7420 6f70 6572 6174 696e 6720 7379 ant operating sy │ │ │ │ │ +000297b0: 7374 656d 2061 6e64 2074 6865 0a20 2020 stem and the. │ │ │ │ │ +000297c0: 2020 6669 726d 7761 7265 2e20 2049 6e20 firmware. In │ │ │ │ │ +000297d0: 736f 6d65 2063 6173 6573 2c20 7468 6520 some cases, the │ │ │ │ │ +000297e0: 7461 626c 6573 2070 726f 7669 6465 6420 tables provided │ │ │ │ │ +000297f0: 6279 2064 6566 6175 6c74 206f 6e6c 7920 by default only │ │ │ │ │ +00029800: 776f 726b 0a20 2020 2020 7765 6c6c 2077 work. well w │ │ │ │ │ +00029810: 6974 6820 6365 7274 6169 6e20 6f70 6572 ith certain oper │ │ │ │ │ +00029820: 6174 696e 6720 7379 7374 656d 732c 2061 ating systems, a │ │ │ │ │ +00029830: 6e64 2069 7420 6d61 7920 6265 206e 6563 nd it may be nec │ │ │ │ │ +00029840: 6573 7361 7279 2074 6f0a 2020 2020 2072 essary to. r │ │ │ │ │ +00029850: 6570 6c61 6365 2073 6f6d 6520 6f66 2074 eplace some of t │ │ │ │ │ +00029860: 6865 6d2e 0a0a 2020 2020 204e 6f72 6d61 hem... Norma │ │ │ │ │ +00029870: 6c6c 792c 2074 6869 7320 636f 6d6d 616e lly, this comman │ │ │ │ │ +00029880: 6420 7769 6c6c 2072 6570 6c61 6365 2074 d will replace t │ │ │ │ │ +00029890: 6865 2052 6f6f 7420 5379 7374 656d 2044 he Root System D │ │ │ │ │ +000298a0: 6573 6372 6970 7469 6f6e 0a20 2020 2020 escription. │ │ │ │ │ +000298b0: 506f 696e 7465 7220 2852 5344 5029 2069 Pointer (RSDP) i │ │ │ │ │ +000298c0: 6e20 7468 6520 4578 7465 6e64 6564 2042 n the Extended B │ │ │ │ │ +000298d0: 494f 5320 4461 7461 2041 7265 6120 746f IOS Data Area to │ │ │ │ │ +000298e0: 2070 6f69 6e74 2074 6f20 7468 6520 6e65 point to the ne │ │ │ │ │ +000298f0: 770a 2020 2020 2074 6162 6c65 732e 2020 w. tables. │ │ │ │ │ +00029900: 4966 2074 6865 2027 2d2d 6e6f 2d65 6264 If the '--no-ebd │ │ │ │ │ +00029910: 6127 206f 7074 696f 6e20 6973 2075 7365 a' option is use │ │ │ │ │ +00029920: 642c 2074 6865 206e 6577 2074 6162 6c65 d, the new table │ │ │ │ │ +00029930: 7320 7769 6c6c 2062 650a 2020 2020 206b s will be. k │ │ │ │ │ +00029940: 6e6f 776e 206f 6e6c 7920 746f 2047 5255 nown only to GRU │ │ │ │ │ +00029950: 422c 2062 7574 206d 6179 2062 6520 7573 B, but may be us │ │ │ │ │ +00029960: 6564 2062 7920 4752 5542 2773 2045 4649 ed by GRUB's EFI │ │ │ │ │ +00029970: 2065 6d75 6c61 7469 6f6e 2e0a 0a20 2020 emulation... │ │ │ │ │ +00029980: 2020 4e6f 7465 3a20 5468 6520 636f 6d6d Note: The comm │ │ │ │ │ +00029990: 616e 6420 6973 206e 6f74 2061 6c6c 6f77 and is not allow │ │ │ │ │ +000299a0: 6564 2077 6865 6e20 6c6f 636b 646f 776e ed when lockdown │ │ │ │ │ +000299b0: 2069 7320 656e 666f 7263 6564 2028 2a6e is enforced (*n │ │ │ │ │ +000299c0: 6f74 650a 2020 2020 204c 6f63 6b64 6f77 ote. Lockdow │ │ │ │ │ +000299d0: 6e3a 3a29 2e20 204f 7468 6572 7769 7365 n::). Otherwise │ │ │ │ │ +000299e0: 2061 6e20 6174 7461 636b 6572 2063 616e an attacker can │ │ │ │ │ +000299f0: 2069 6e73 7472 7563 7420 7468 6520 4752 instruct the GR │ │ │ │ │ +00029a00: 5542 2074 6f20 6c6f 6164 0a20 2020 2020 UB to load. │ │ │ │ │ +00029a10: 616e 2053 5344 5420 7461 626c 6520 746f an SSDT table to │ │ │ │ │ +00029a20: 206f 7665 7277 7269 7465 2074 6865 206b overwrite the k │ │ │ │ │ +00029a30: 6572 6e65 6c20 6c6f 636b 646f 776e 2063 ernel lockdown c │ │ │ │ │ +00029a40: 6f6e 6669 6775 7261 7469 6f6e 2061 6e64 onfiguration and │ │ │ │ │ +00029a50: 0a20 2020 2020 6c61 7465 7220 6c6f 6164 . later load │ │ │ │ │ +00029a60: 2061 6e64 2065 7865 6375 7465 2075 6e73 and execute uns │ │ │ │ │ +00029a70: 6967 6e65 6420 636f 6465 2e0a 0a1f 0a46 igned code.....F │ │ │ │ │ +00029a80: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ +00029a90: 204e 6f64 653a 2061 7574 6865 6e74 6963 Node: authentic │ │ │ │ │ +00029aa0: 6174 652c 2020 4e65 7874 3a20 6261 636b ate, Next: back │ │ │ │ │ +00029ab0: 6772 6f75 6e64 5f63 6f6c 6f72 2c20 2050 ground_color, P │ │ │ │ │ +00029ac0: 7265 763a 2061 6370 692c 2020 5570 3a20 rev: acpi, Up: │ │ │ │ │ +00029ad0: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ +00029ae0: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ │ +00029af0: 616e 6473 0a0a 3136 2e33 2e33 2061 7574 ands..16.3.3 aut │ │ │ │ │ +00029b00: 6865 6e74 6963 6174 650a 2d2d 2d2d 2d2d henticate.------ │ │ │ │ │ +00029b10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 -------------.. │ │ │ │ │ +00029b20: 2d2d 2043 6f6d 6d61 6e64 3a20 6175 7468 -- Command: auth │ │ │ │ │ +00029b30: 656e 7469 6361 7465 205b 7573 6572 6c69 enticate [userli │ │ │ │ │ +00029b40: 7374 5d0a 2020 2020 2043 6865 636b 2077 st]. Check w │ │ │ │ │ +00029b50: 6865 7468 6572 2075 7365 7220 6973 2069 hether user is i │ │ │ │ │ +00029b60: 6e20 5553 4552 4c49 5354 206f 7220 6c69 n USERLIST or li │ │ │ │ │ +00029b70: 7374 6564 2069 6e20 7468 6520 7661 6c75 sted in the valu │ │ │ │ │ +00029b80: 6520 6f66 0a20 2020 2020 7661 7269 6162 e of. variab │ │ │ │ │ +00029b90: 6c65 2027 7375 7065 7275 7365 7273 272e le 'superusers'. │ │ │ │ │ +00029ba0: 2020 5365 6520 2a6e 6f74 6520 7375 7065 See *note supe │ │ │ │ │ +00029bb0: 7275 7365 7273 3a3a 2066 6f72 2076 616c rusers:: for val │ │ │ │ │ +00029bc0: 6964 2075 7365 7220 6c69 7374 0a20 2020 id user list. │ │ │ │ │ +00029bd0: 2020 666f 726d 6174 2e20 2049 6620 2773 format. If 's │ │ │ │ │ +00029be0: 7570 6572 7573 6572 7327 2069 7320 656d uperusers' is em │ │ │ │ │ +00029bf0: 7074 792c 2074 6869 7320 636f 6d6d 616e pty, this comman │ │ │ │ │ +00029c00: 6420 7265 7475 726e 7320 7472 7565 2e0a d returns true.. │ │ │ │ │ +00029c10: 2020 2020 202a 4e6f 7465 2053 6563 7572 *Note Secur │ │ │ │ │ +00029c20: 6974 793a 3a2e 0a0a 1f0a 4669 6c65 3a20 ity::.....File: │ │ │ │ │ +00029c30: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ +00029c40: 3a20 6261 636b 6772 6f75 6e64 5f63 6f6c : background_col │ │ │ │ │ +00029c50: 6f72 2c20 204e 6578 743a 2062 6163 6b67 or, Next: backg │ │ │ │ │ +00029c60: 726f 756e 645f 696d 6167 652c 2020 5072 round_image, Pr │ │ │ │ │ +00029c70: 6576 3a20 6175 7468 656e 7469 6361 7465 ev: authenticate │ │ │ │ │ +00029c80: 2c20 2055 703a 2043 6f6d 6d61 6e64 2d6c , Up: Command-l │ │ │ │ │ +00029c90: 696e 6520 616e 6420 6d65 6e75 2065 6e74 ine and menu ent │ │ │ │ │ +00029ca0: 7279 2063 6f6d 6d61 6e64 730a 0a31 362e ry commands..16. │ │ │ │ │ +00029cb0: 332e 3420 6261 636b 6772 6f75 6e64 5f63 3.4 background_c │ │ │ │ │ +00029cc0: 6f6c 6f72 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d olor.----------- │ │ │ │ │ +00029cd0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d ------------.. - │ │ │ │ │ +00029ce0: 2d20 436f 6d6d 616e 643a 2062 6163 6b67 - Command: backg │ │ │ │ │ +00029cf0: 726f 756e 645f 636f 6c6f 7220 636f 6c6f round_color colo │ │ │ │ │ +00029d00: 720a 2020 2020 2053 6574 2062 6163 6b67 r. Set backg │ │ │ │ │ +00029d10: 726f 756e 6420 636f 6c6f 7220 666f 7220 round color for │ │ │ │ │ +00029d20: 6163 7469 7665 2074 6572 6d69 6e61 6c2e active terminal. │ │ │ │ │ +00029d30: 2020 466f 7220 7661 6c69 6420 636f 6c6f For valid colo │ │ │ │ │ +00029d40: 720a 2020 2020 2073 7065 6369 6669 6361 r. specifica │ │ │ │ │ +00029d50: 7469 6f6e 7320 7365 6520 2a6e 6f74 6520 tions see *note │ │ │ │ │ +00029d60: 436f 6c6f 7273 3a20 5468 656d 6520 6669 Colors: Theme fi │ │ │ │ │ +00029d70: 6c65 2066 6f72 6d61 742e 2020 4261 636b le format. Back │ │ │ │ │ +00029d80: 6772 6f75 6e64 0a20 2020 2020 636f 6c6f ground. colo │ │ │ │ │ +00029d90: 7220 6361 6e20 6265 2063 6861 6e67 6564 r can be changed │ │ │ │ │ +00029da0: 206f 6e6c 7920 7768 656e 2075 7369 6e67 only when using │ │ │ │ │ +00029db0: 2027 6766 7874 6572 6d27 2066 6f72 2074 'gfxterm' for t │ │ │ │ │ +00029dc0: 6572 6d69 6e61 6c20 6f75 7470 7574 2e0a erminal output.. │ │ │ │ │ +00029dd0: 0a20 2020 2020 5468 6973 2063 6f6d 6d61 . This comma │ │ │ │ │ +00029de0: 6e64 2073 6574 7320 636f 6c6f 7220 6f66 nd sets color of │ │ │ │ │ +00029df0: 2065 6d70 7479 2061 7265 6173 2077 6974 empty areas wit │ │ │ │ │ +00029e00: 686f 7574 2074 6578 742e 2020 5465 7874 hout text. Text │ │ │ │ │ +00029e10: 0a20 2020 2020 6261 636b 6772 6f75 6e64 . background │ │ │ │ │ +00029e20: 2063 6f6c 6f72 2069 7320 636f 6e74 726f color is contro │ │ │ │ │ +00029e30: 6c6c 6564 2062 7920 656e 7669 726f 6e6d lled by environm │ │ │ │ │ +00029e40: 656e 7420 7661 7269 6162 6c65 730a 2020 ent variables. │ │ │ │ │ +00029e50: 2020 2043 4f4c 4f52 5f4e 4f52 4d41 4c2c COLOR_NORMAL, │ │ │ │ │ +00029e60: 2043 4f4c 4f52 5f48 4947 484c 4947 4854 COLOR_HIGHLIGHT │ │ │ │ │ +00029e70: 2c20 4d45 4e55 5f43 4f4c 4f52 5f4e 4f52 , MENU_COLOR_NOR │ │ │ │ │ +00029e80: 4d41 4c2c 0a20 2020 2020 4d45 4e55 5f43 MAL,. MENU_C │ │ │ │ │ +00029e90: 4f4c 4f52 5f48 4947 484c 4947 4854 2e20 OLOR_HIGHLIGHT. │ │ │ │ │ +00029ea0: 202a 4e6f 7465 2053 7065 6369 616c 2065 *Note Special e │ │ │ │ │ +00029eb0: 6e76 6972 6f6e 6d65 6e74 2076 6172 6961 nvironment varia │ │ │ │ │ +00029ec0: 626c 6573 3a3a 2e0a 0a1f 0a46 696c 653a bles::.....File: │ │ │ │ │ +00029ed0: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ +00029ee0: 653a 2062 6163 6b67 726f 756e 645f 696d e: background_im │ │ │ │ │ +00029ef0: 6167 652c 2020 4e65 7874 3a20 6261 6472 age, Next: badr │ │ │ │ │ +00029f00: 616d 2c20 2050 7265 763a 2062 6163 6b67 am, Prev: backg │ │ │ │ │ +00029f10: 726f 756e 645f 636f 6c6f 722c 2020 5570 round_color, Up │ │ │ │ │ +00029f20: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ │ +00029f30: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ │ +00029f40: 6d6d 616e 6473 0a0a 3136 2e33 2e35 2062 mmands..16.3.5 b │ │ │ │ │ +00029f50: 6163 6b67 726f 756e 645f 696d 6167 650a ackground_image. │ │ │ │ │ +00029f60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ +00029f70: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d -------.. -- Com │ │ │ │ │ +00029f80: 6d61 6e64 3a20 6261 636b 6772 6f75 6e64 mand: background │ │ │ │ │ +00029f90: 5f69 6d61 6765 205b 5b2d 2d6d 6f64 6520 _image [[--mode │ │ │ │ │ +00029fa0: 7374 7265 7463 687c 6e6f 726d 616c 5d20 stretch|normal] │ │ │ │ │ +00029fb0: 6669 6c65 5d0a 2020 2020 204c 6f61 6420 file]. Load │ │ │ │ │ +00029fc0: 6261 636b 6772 6f75 6e64 2069 6d61 6765 background image │ │ │ │ │ +00029fd0: 2066 6f72 2061 6374 6976 6520 7465 726d for active term │ │ │ │ │ +00029fe0: 696e 616c 2066 726f 6d20 4649 4c45 2e20 inal from FILE. │ │ │ │ │ +00029ff0: 2049 6d61 6765 2069 730a 2020 2020 2073 Image is. s │ │ │ │ │ +0002a000: 7472 6574 6368 6564 2074 6f20 6669 6c6c tretched to fill │ │ │ │ │ +0002a010: 2075 7020 656e 7469 7265 2073 6372 6565 up entire scree │ │ │ │ │ +0002a020: 6e20 756e 6c65 7373 206f 7074 696f 6e20 n unless option │ │ │ │ │ +0002a030: 272d 2d6d 6f64 6527 2027 6e6f 726d 616c '--mode' 'normal │ │ │ │ │ +0002a040: 270a 2020 2020 2069 7320 6769 7665 6e2e '. is given. │ │ │ │ │ +0002a050: 2020 5769 7468 6f75 7420 6172 6775 6d65 Without argume │ │ │ │ │ +0002a060: 6e74 7320 7265 6d6f 7665 2063 7572 7265 nts remove curre │ │ │ │ │ +0002a070: 6e74 6c79 206c 6f61 6465 6420 6261 636b ntly loaded back │ │ │ │ │ +0002a080: 6772 6f75 6e64 0a20 2020 2020 696d 6167 ground. imag │ │ │ │ │ +0002a090: 652e 2020 4261 636b 6772 6f75 6e64 2069 e. Background i │ │ │ │ │ +0002a0a0: 6d61 6765 2063 616e 2062 6520 6368 616e mage can be chan │ │ │ │ │ +0002a0b0: 6765 6420 6f6e 6c79 2077 6865 6e20 7573 ged only when us │ │ │ │ │ +0002a0c0: 696e 6720 2767 6678 7465 726d 270a 2020 ing 'gfxterm'. │ │ │ │ │ +0002a0d0: 2020 2066 6f72 2074 6572 6d69 6e61 6c20 for terminal │ │ │ │ │ +0002a0e0: 6f75 7470 7574 2e0a 0a1f 0a46 696c 653a output.....File: │ │ │ │ │ +0002a0f0: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ +0002a100: 653a 2062 6164 7261 6d2c 2020 4e65 7874 e: badram, Next │ │ │ │ │ +0002a110: 3a20 626c 6f63 6b6c 6973 742c 2020 5072 : blocklist, Pr │ │ │ │ │ +0002a120: 6576 3a20 6261 636b 6772 6f75 6e64 5f69 ev: background_i │ │ │ │ │ +0002a130: 6d61 6765 2c20 2055 703a 2043 6f6d 6d61 mage, Up: Comma │ │ │ │ │ +0002a140: 6e64 2d6c 696e 6520 616e 6420 6d65 6e75 nd-line and menu │ │ │ │ │ +0002a150: 2065 6e74 7279 2063 6f6d 6d61 6e64 730a entry commands. │ │ │ │ │ +0002a160: 0a31 362e 332e 3620 6261 6472 616d 0a2d .16.3.6 badram.- │ │ │ │ │ +0002a170: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d ------------.. - │ │ │ │ │ +0002a180: 2d20 436f 6d6d 616e 643a 2062 6164 7261 - Command: badra │ │ │ │ │ +0002a190: 6d20 6164 6472 2c6d 6173 6b5b 2c61 6464 m addr,mask[,add │ │ │ │ │ +0002a1a0: 722c 6d61 736b 2e2e 2e5d 0a20 2020 2020 r,mask...]. │ │ │ │ │ +0002a1b0: 4669 6c74 6572 206f 7574 2062 6164 2052 Filter out bad R │ │ │ │ │ +0002a1c0: 414d 2e0a 0a20 2020 2020 5468 6973 2063 AM... This c │ │ │ │ │ +0002a1d0: 6f6d 6d61 6e64 206e 6f74 6966 6965 7320 ommand notifies │ │ │ │ │ +0002a1e0: 7468 6520 6d65 6d6f 7279 206d 616e 6167 the memory manag │ │ │ │ │ +0002a1f0: 6572 2074 6861 7420 7370 6563 6966 6965 er that specifie │ │ │ │ │ +0002a200: 6420 7265 6769 6f6e 7320 6f66 0a20 2020 d regions of. │ │ │ │ │ +0002a210: 2020 5241 4d20 6f75 6768 7420 746f 2062 RAM ought to b │ │ │ │ │ +0002a220: 6520 6669 6c74 6572 6564 206f 7574 2028 e filtered out ( │ │ │ │ │ +0002a230: 7573 7561 6c6c 792c 2062 6563 6175 7365 usually, because │ │ │ │ │ +0002a240: 2074 6865 7927 7265 2064 616d 6167 6564 they're damaged │ │ │ │ │ +0002a250: 292e 0a20 2020 2020 5468 6973 2072 656d ).. This rem │ │ │ │ │ +0002a260: 6169 6e73 2069 6e20 6566 6665 6374 2061 ains in effect a │ │ │ │ │ +0002a270: 6674 6572 2061 2070 6179 6c6f 6164 206b fter a payload k │ │ │ │ │ +0002a280: 6572 6e65 6c20 6861 7320 6265 656e 206c ernel has been l │ │ │ │ │ +0002a290: 6f61 6465 6420 6279 0a20 2020 2020 4752 oaded by. GR │ │ │ │ │ +0002a2a0: 5542 2c20 6173 206c 6f6e 6720 6173 2074 UB, as long as t │ │ │ │ │ +0002a2b0: 6865 206c 6f61 6465 6420 6b65 726e 656c he loaded kernel │ │ │ │ │ +0002a2c0: 206f 6274 6169 6e73 2069 7473 206d 656d obtains its mem │ │ │ │ │ +0002a2d0: 6f72 7920 6d61 7020 6672 6f6d 0a20 2020 ory map from. │ │ │ │ │ +0002a2e0: 2020 4752 5542 2e20 4b65 726e 656c 7320 GRUB. Kernels │ │ │ │ │ +0002a2f0: 7468 6174 2073 7570 706f 7274 2074 6869 that support thi │ │ │ │ │ +0002a300: 7320 696e 636c 7564 6520 4c69 6e75 782c s include Linux, │ │ │ │ │ +0002a310: 2047 4e55 204d 6163 682c 2074 6865 206b GNU Mach, the k │ │ │ │ │ +0002a320: 6572 6e65 6c0a 2020 2020 206f 6620 4672 ernel. of Fr │ │ │ │ │ +0002a330: 6565 4253 4420 616e 6420 4d75 6c74 6962 eeBSD and Multib │ │ │ │ │ +0002a340: 6f6f 7420 6b65 726e 656c 7320 696e 2067 oot kernels in g │ │ │ │ │ +0002a350: 656e 6572 616c 2e0a 0a20 2020 2020 5379 eneral... Sy │ │ │ │ │ +0002a360: 6e74 6178 2069 7320 7468 6520 7361 6d65 ntax is the same │ │ │ │ │ +0002a370: 2061 7320 7072 6f76 6964 6564 2062 7920 as provided by │ │ │ │ │ +0002a380: 7468 6520 4d65 6d74 6573 7438 362b 2075 the Memtest86+ u │ │ │ │ │ +0002a390: 7469 6c69 7479 0a20 2020 2020 2868 7474 tility. (htt │ │ │ │ │ +0002a3a0: 703a 2f2f 7777 772e 6d65 6d74 6573 742e p://www.memtest. │ │ │ │ │ +0002a3b0: 6f72 672f 293a 2061 206c 6973 7420 6f66 org/): a list of │ │ │ │ │ +0002a3c0: 2061 6464 7265 7373 2f6d 6173 6b20 7061 address/mask pa │ │ │ │ │ +0002a3d0: 6972 732e 2020 4769 7665 6e20 610a 2020 irs. Given a. │ │ │ │ │ +0002a3e0: 2020 2070 6167 652d 616c 6967 6e65 6420 page-aligned │ │ │ │ │ +0002a3f0: 6164 6472 6573 7320 616e 6420 6120 6261 address and a ba │ │ │ │ │ +0002a400: 7365 2061 6464 7265 7373 202f 206d 6173 se address / mas │ │ │ │ │ +0002a410: 6b20 7061 6972 2c20 6966 2061 6c6c 2074 k pair, if all t │ │ │ │ │ +0002a420: 6865 0a20 2020 2020 6269 7473 206f 6620 he. bits of │ │ │ │ │ +0002a430: 7468 6520 7061 6765 2d61 6c69 676e 6564 the page-aligned │ │ │ │ │ +0002a440: 2061 6464 7265 7373 2074 6861 7420 6172 address that ar │ │ │ │ │ +0002a450: 6520 656e 6162 6c65 6420 6279 2074 6865 e enabled by the │ │ │ │ │ +0002a460: 206d 6173 6b20 6d61 7463 680a 2020 2020 mask match. │ │ │ │ │ +0002a470: 2077 6974 6820 7468 6520 6261 7365 2061 with the base a │ │ │ │ │ +0002a480: 6464 7265 7373 2c20 6974 206d 6561 6e73 ddress, it means │ │ │ │ │ +0002a490: 2074 6869 7320 7061 6765 2069 7320 746f this page is to │ │ │ │ │ +0002a4a0: 2062 6520 6669 6c74 6572 6564 2e20 2054 be filtered. T │ │ │ │ │ +0002a4b0: 6869 730a 2020 2020 2073 796e 7461 7820 his. syntax │ │ │ │ │ +0002a4c0: 6d61 6b65 7320 6974 2065 6173 7920 746f makes it easy to │ │ │ │ │ +0002a4d0: 2072 6570 7265 7365 6e74 2070 6174 7465 represent patte │ │ │ │ │ +0002a4e0: 726e 7320 7468 6174 2061 7265 206f 6674 rns that are oft │ │ │ │ │ +0002a4f0: 656e 2072 6573 756c 7420 6f66 0a20 2020 en result of. │ │ │ │ │ +0002a500: 2020 6d65 6d6f 7279 2064 616d 6167 652c memory damage, │ │ │ │ │ +0002a510: 2064 7565 2074 6f20 7068 7973 6963 616c due to physical │ │ │ │ │ +0002a520: 2064 6973 7472 6962 7574 696f 6e20 6f66 distribution of │ │ │ │ │ +0002a530: 206d 656d 6f72 7920 6365 6c6c 732e 0a0a memory cells... │ │ │ │ │ +0002a540: 2020 2020 2054 6865 2063 6f6d 6d61 6e64 The command │ │ │ │ │ +0002a550: 2069 7320 7369 6d69 6c61 7220 746f 2027 is similar to ' │ │ │ │ │ +0002a560: 6375 746d 656d 2720 636f 6d6d 616e 642e cutmem' command. │ │ │ │ │ +0002a570: 0a0a 2020 2020 204e 6f74 653a 2054 6865 .. Note: The │ │ │ │ │ +0002a580: 2063 6f6d 6d61 6e64 2069 7320 6e6f 7420 command is not │ │ │ │ │ +0002a590: 616c 6c6f 7765 6420 7768 656e 206c 6f63 allowed when loc │ │ │ │ │ +0002a5a0: 6b64 6f77 6e20 6973 2065 6e66 6f72 6365 kdown is enforce │ │ │ │ │ +0002a5b0: 6420 282a 6e6f 7465 0a20 2020 2020 4c6f d (*note. Lo │ │ │ │ │ +0002a5c0: 636b 646f 776e 3a3a 292e 2020 5468 6973 ckdown::). This │ │ │ │ │ +0002a5d0: 2070 7265 7665 6e74 7320 7265 6d6f 7669 prevents removi │ │ │ │ │ +0002a5e0: 6e67 2045 4649 206d 656d 6f72 7920 7265 ng EFI memory re │ │ │ │ │ +0002a5f0: 6769 6f6e 7320 746f 0a20 2020 2020 706f gions to. po │ │ │ │ │ +0002a600: 7465 6e74 6961 6c6c 7920 7375 6276 6572 tentially subver │ │ │ │ │ +0002a610: 7420 7468 6520 7365 6375 7269 7479 206d t the security m │ │ │ │ │ +0002a620: 6563 6861 6e69 736d 7320 7072 6f76 6964 echanisms provid │ │ │ │ │ +0002a630: 6564 2062 7920 7468 6520 5545 4649 0a20 ed by the UEFI. │ │ │ │ │ +0002a640: 2020 2020 7365 6375 7265 2062 6f6f 742e secure boot. │ │ │ │ │ +0002a650: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ +0002a660: 6e66 6f2c 2020 4e6f 6465 3a20 626c 6f63 nfo, Node: bloc │ │ │ │ │ +0002a670: 6b6c 6973 742c 2020 4e65 7874 3a20 626f klist, Next: bo │ │ │ │ │ +0002a680: 6f74 2c20 2050 7265 763a 2062 6164 7261 ot, Prev: badra │ │ │ │ │ +0002a690: 6d2c 2020 5570 3a20 436f 6d6d 616e 642d m, Up: Command- │ │ │ │ │ +0002a6a0: 6c69 6e65 2061 6e64 206d 656e 7520 656e line and menu en │ │ │ │ │ +0002a6b0: 7472 7920 636f 6d6d 616e 6473 0a0a 3136 try commands..16 │ │ │ │ │ +0002a6c0: 2e33 2e37 2062 6c6f 636b 6c69 7374 0a2d .3.7 blocklist.- │ │ │ │ │ +0002a6d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ +0002a6e0: 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 626c . -- Command: bl │ │ │ │ │ +0002a6f0: 6f63 6b6c 6973 7420 6669 6c65 0a20 2020 ocklist file. │ │ │ │ │ +0002a700: 2020 5072 696e 7420 6120 626c 6f63 6b20 Print a block │ │ │ │ │ +0002a710: 6c69 7374 2028 2a6e 6f74 6520 426c 6f63 list (*note Bloc │ │ │ │ │ +0002a720: 6b20 6c69 7374 2073 796e 7461 783a 3a29 k list syntax::) │ │ │ │ │ +0002a730: 2066 6f72 2046 494c 452e 0a0a 1f0a 4669 for FILE.....Fi │ │ │ │ │ +0002a740: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ +0002a750: 4e6f 6465 3a20 626f 6f74 2c20 204e 6578 Node: boot, Nex │ │ │ │ │ +0002a760: 743a 2063 6174 2c20 2050 7265 763a 2062 t: cat, Prev: b │ │ │ │ │ +0002a770: 6c6f 636b 6c69 7374 2c20 2055 703a 2043 locklist, Up: C │ │ │ │ │ +0002a780: 6f6d 6d61 6e64 2d6c 696e 6520 616e 6420 ommand-line and │ │ │ │ │ +0002a790: 6d65 6e75 2065 6e74 7279 2063 6f6d 6d61 menu entry comma │ │ │ │ │ +0002a7a0: 6e64 730a 0a31 362e 332e 3820 626f 6f74 nds..16.3.8 boot │ │ │ │ │ +0002a7b0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d .-----------.. - │ │ │ │ │ +0002a7c0: 2d20 436f 6d6d 616e 643a 2062 6f6f 740a - Command: boot. │ │ │ │ │ +0002a7d0: 2020 2020 2042 6f6f 7420 7468 6520 4f53 Boot the OS │ │ │ │ │ +0002a7e0: 206f 7220 6368 6169 6e2d 6c6f 6164 6572 or chain-loader │ │ │ │ │ +0002a7f0: 2077 6869 6368 2068 6173 2062 6565 6e20 which has been │ │ │ │ │ +0002a800: 6c6f 6164 6564 2e20 204f 6e6c 7920 6e65 loaded. Only ne │ │ │ │ │ +0002a810: 6365 7373 6172 790a 2020 2020 2069 6620 cessary. if │ │ │ │ │ +0002a820: 7275 6e6e 696e 6720 7468 6520 6675 6c6c running the full │ │ │ │ │ +0002a830: 7920 696e 7465 7261 6374 6976 6520 636f y interactive co │ │ │ │ │ +0002a840: 6d6d 616e 642d 6c69 6e65 2028 6974 2069 mmand-line (it i │ │ │ │ │ +0002a850: 7320 696d 706c 6963 6974 2061 740a 2020 s implicit at. │ │ │ │ │ +0002a860: 2020 2074 6865 2065 6e64 206f 6620 6120 the end of a │ │ │ │ │ +0002a870: 6d65 6e75 2065 6e74 7279 292e 0a0a 1f0a menu entry)..... │ │ │ │ │ +0002a880: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ +0002a890: 2020 4e6f 6465 3a20 6361 742c 2020 4e65 Node: cat, Ne │ │ │ │ │ +0002a8a0: 7874 3a20 6368 6169 6e6c 6f61 6465 722c xt: chainloader, │ │ │ │ │ +0002a8b0: 2020 5072 6576 3a20 626f 6f74 2c20 2055 Prev: boot, U │ │ │ │ │ +0002a8c0: 703a 2043 6f6d 6d61 6e64 2d6c 696e 6520 p: Command-line │ │ │ │ │ +0002a8d0: 616e 6420 6d65 6e75 2065 6e74 7279 2063 and menu entry c │ │ │ │ │ +0002a8e0: 6f6d 6d61 6e64 730a 0a31 362e 332e 3920 ommands..16.3.9 │ │ │ │ │ +0002a8f0: 6361 740a 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a cat.----------.. │ │ │ │ │ +0002a900: 202d 2d20 436f 6d6d 616e 643a 2063 6174 -- Command: cat │ │ │ │ │ +0002a910: 205b 2d2d 646f 735d 2066 696c 650a 2020 [--dos] file. │ │ │ │ │ +0002a920: 2020 2044 6973 706c 6179 2074 6865 2063 Display the c │ │ │ │ │ +0002a930: 6f6e 7465 6e74 7320 6f66 2074 6865 2066 ontents of the f │ │ │ │ │ +0002a940: 696c 6520 4649 4c45 2e20 2054 6869 7320 ile FILE. This │ │ │ │ │ +0002a950: 636f 6d6d 616e 6420 6d61 7920 6265 2075 command may be u │ │ │ │ │ +0002a960: 7365 6675 6c0a 2020 2020 2074 6f20 7265 seful. to re │ │ │ │ │ +0002a970: 6d69 6e64 2079 6f75 206f 6620 796f 7572 mind you of your │ │ │ │ │ +0002a980: 204f 5327 7320 726f 6f74 2070 6172 7469 OS's root parti │ │ │ │ │ +0002a990: 7469 6f6e 3a0a 0a20 2020 2020 2020 2020 tion:.. │ │ │ │ │ +0002a9a0: 2067 7275 623e 2063 6174 202f 6574 632f grub> cat /etc/ │ │ │ │ │ +0002a9b0: 6673 7461 620a 0a20 2020 2020 4966 2074 fstab.. If t │ │ │ │ │ +0002a9c0: 6865 2027 2d2d 646f 7327 206f 7074 696f he '--dos' optio │ │ │ │ │ +0002a9d0: 6e20 6973 2075 7365 642c 2074 6865 6e20 n is used, then │ │ │ │ │ +0002a9e0: 6361 7272 6961 6765 2072 6574 7572 6e20 carriage return │ │ │ │ │ +0002a9f0: 2f20 6e65 7720 6c69 6e65 0a20 2020 2020 / new line. │ │ │ │ │ +0002aa00: 7061 6972 7320 7769 6c6c 2062 6520 6469 pairs will be di │ │ │ │ │ +0002aa10: 7370 6c61 7965 6420 6173 2061 2073 696d splayed as a sim │ │ │ │ │ +0002aa20: 706c 6520 6e65 7720 6c69 6e65 2e20 204f ple new line. O │ │ │ │ │ +0002aa30: 7468 6572 7769 7365 2c20 7468 650a 2020 therwise, the. │ │ │ │ │ +0002aa40: 2020 2063 6172 7269 6167 6520 7265 7475 carriage retu │ │ │ │ │ +0002aa50: 726e 2077 696c 6c20 6265 2064 6973 706c rn will be displ │ │ │ │ │ +0002aa60: 6179 6564 2061 7320 6120 636f 6e74 726f ayed as a contro │ │ │ │ │ +0002aa70: 6c20 6368 6172 6163 7465 7220 2827 3c64 l character ('') to. make │ │ │ │ │ +0002aa90: 2069 7420 6561 7369 6572 2074 6f20 7365 it easier to se │ │ │ │ │ +0002aaa0: 6520 7768 656e 2062 6f6f 7420 7072 6f62 e when boot prob │ │ │ │ │ +0002aab0: 6c65 6d73 2061 7265 2063 6175 7365 6420 lems are caused │ │ │ │ │ +0002aac0: 6279 2061 2066 696c 650a 2020 2020 2066 by a file. f │ │ │ │ │ +0002aad0: 6f72 6d61 7474 6564 2075 7369 6e67 2044 ormatted using D │ │ │ │ │ +0002aae0: 4f53 2d73 7479 6c65 206c 696e 6520 656e OS-style line en │ │ │ │ │ +0002aaf0: 6469 6e67 732e 0a0a 1f0a 4669 6c65 3a20 dings.....File: │ │ │ │ │ +0002ab00: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ +0002ab10: 3a20 6368 6169 6e6c 6f61 6465 722c 2020 : chainloader, │ │ │ │ │ +0002ab20: 4e65 7874 3a20 636c 6561 722c 2020 5072 Next: clear, Pr │ │ │ │ │ +0002ab30: 6576 3a20 6361 742c 2020 5570 3a20 436f ev: cat, Up: Co │ │ │ │ │ +0002ab40: 6d6d 616e 642d 6c69 6e65 2061 6e64 206d mmand-line and m │ │ │ │ │ +0002ab50: 656e 7520 656e 7472 7920 636f 6d6d 616e enu entry comman │ │ │ │ │ +0002ab60: 6473 0a0a 3136 2e33 2e31 3020 6368 6169 ds..16.3.10 chai │ │ │ │ │ +0002ab70: 6e6c 6f61 6465 720a 2d2d 2d2d 2d2d 2d2d nloader.-------- │ │ │ │ │ +0002ab80: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d -----------.. -- │ │ │ │ │ +0002ab90: 2043 6f6d 6d61 6e64 3a20 6368 6169 6e6c Command: chainl │ │ │ │ │ +0002aba0: 6f61 6465 7220 5b2d 2d66 6f72 6365 5d20 oader [--force] │ │ │ │ │ +0002abb0: 6669 6c65 0a20 2020 2020 4c6f 6164 2046 file. Load F │ │ │ │ │ +0002abc0: 494c 4520 6173 2061 2063 6861 696e 2d6c ILE as a chain-l │ │ │ │ │ +0002abd0: 6f61 6465 722e 2020 4c69 6b65 2061 6e79 oader. Like any │ │ │ │ │ +0002abe0: 206f 7468 6572 2066 696c 6520 6c6f 6164 other file load │ │ │ │ │ +0002abf0: 6564 2062 7920 7468 650a 2020 2020 2066 ed by the. f │ │ │ │ │ +0002ac00: 696c 6573 7973 7465 6d20 636f 6465 2c20 ilesystem code, │ │ │ │ │ +0002ac10: 6974 2063 616e 2075 7365 2074 6865 2062 it can use the b │ │ │ │ │ +0002ac20: 6c6f 636b 6c69 7374 206e 6f74 6174 696f locklist notatio │ │ │ │ │ +0002ac30: 6e20 282a 6e6f 7465 2042 6c6f 636b 0a20 n (*note Block. │ │ │ │ │ +0002ac40: 2020 2020 6c69 7374 2073 796e 7461 783a list syntax: │ │ │ │ │ +0002ac50: 3a29 2074 6f20 6772 6162 2074 6865 2066 :) to grab the f │ │ │ │ │ +0002ac60: 6972 7374 2073 6563 746f 7220 6f66 2074 irst sector of t │ │ │ │ │ +0002ac70: 6865 2063 7572 7265 6e74 2070 6172 7469 he current parti │ │ │ │ │ +0002ac80: 7469 6f6e 0a20 2020 2020 7769 7468 2027 tion. with ' │ │ │ │ │ +0002ac90: 2b31 272e 2020 4966 2079 6f75 2073 7065 +1'. If you spe │ │ │ │ │ +0002aca0: 6369 6679 2074 6865 206f 7074 696f 6e20 cify the option │ │ │ │ │ +0002acb0: 272d 2d66 6f72 6365 272c 2074 6865 6e20 '--force', then │ │ │ │ │ +0002acc0: 6c6f 6164 2046 494c 450a 2020 2020 2066 load FILE. f │ │ │ │ │ +0002acd0: 6f72 6369 626c 792c 2077 6865 7468 6572 orcibly, whether │ │ │ │ │ +0002ace0: 2069 7420 6861 7320 6120 636f 7272 6563 it has a correc │ │ │ │ │ +0002acf0: 7420 7369 676e 6174 7572 6520 6f72 206e t signature or n │ │ │ │ │ +0002ad00: 6f74 2e20 2054 6869 7320 6973 0a20 2020 ot. This is. │ │ │ │ │ +0002ad10: 2020 7265 7175 6972 6564 2077 6865 6e20 required when │ │ │ │ │ +0002ad20: 796f 7520 7761 6e74 2074 6f20 6c6f 6164 you want to load │ │ │ │ │ +0002ad30: 2061 2064 6566 6563 7469 7665 2062 6f6f a defective boo │ │ │ │ │ +0002ad40: 7420 6c6f 6164 6572 2c20 7375 6368 2061 t loader, such a │ │ │ │ │ +0002ad50: 7320 5343 4f0a 2020 2020 2055 6e69 7857 s SCO. UnixW │ │ │ │ │ +0002ad60: 6172 6520 372e 312e 0a0a 1f0a 4669 6c65 are 7.1.....File │ │ │ │ │ +0002ad70: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ +0002ad80: 6465 3a20 636c 6561 722c 2020 4e65 7874 de: clear, Next │ │ │ │ │ +0002ad90: 3a20 636d 6f73 636c 6561 6e2c 2020 5072 : cmosclean, Pr │ │ │ │ │ +0002ada0: 6576 3a20 6368 6169 6e6c 6f61 6465 722c ev: chainloader, │ │ │ │ │ +0002adb0: 2020 5570 3a20 436f 6d6d 616e 642d 6c69 Up: Command-li │ │ │ │ │ +0002adc0: 6e65 2061 6e64 206d 656e 7520 656e 7472 ne and menu entr │ │ │ │ │ +0002add0: 7920 636f 6d6d 616e 6473 0a0a 3136 2e33 y commands..16.3 │ │ │ │ │ +0002ade0: 2e31 3120 636c 6561 720a 2d2d 2d2d 2d2d .11 clear.------ │ │ │ │ │ +0002adf0: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d -------.. -- Com │ │ │ │ │ +0002ae00: 6d61 6e64 3a20 636c 6561 720a 2020 2020 mand: clear. │ │ │ │ │ +0002ae10: 2043 6c65 6172 2074 6865 2073 6372 6565 Clear the scree │ │ │ │ │ +0002ae20: 6e2e 0a0a 1f0a 4669 6c65 3a20 6772 7562 n.....File: grub │ │ │ │ │ +0002ae30: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 636d .info, Node: cm │ │ │ │ │ +0002ae40: 6f73 636c 6561 6e2c 2020 4e65 7874 3a20 osclean, Next: │ │ │ │ │ +0002ae50: 636d 6f73 6475 6d70 2c20 2050 7265 763a cmosdump, Prev: │ │ │ │ │ +0002ae60: 2063 6c65 6172 2c20 2055 703a 2043 6f6d clear, Up: Com │ │ │ │ │ +0002ae70: 6d61 6e64 2d6c 696e 6520 616e 6420 6d65 mand-line and me │ │ │ │ │ +0002ae80: 6e75 2065 6e74 7279 2063 6f6d 6d61 6e64 nu entry command │ │ │ │ │ +0002ae90: 730a 0a31 362e 332e 3132 2063 6d6f 7363 s..16.3.12 cmosc │ │ │ │ │ +0002aea0: 6c65 616e 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d lean.----------- │ │ │ │ │ +0002aeb0: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ │ +0002aec0: 616e 643a 2063 6d6f 7363 6c65 616e 2062 and: cmosclean b │ │ │ │ │ +0002aed0: 7974 653a 6269 740a 2020 2020 2043 6c65 yte:bit. Cle │ │ │ │ │ +0002aee0: 6172 2076 616c 7565 206f 6620 6269 7420 ar value of bit │ │ │ │ │ +0002aef0: 696e 2043 4d4f 5320 6174 206c 6f63 6174 in CMOS at locat │ │ │ │ │ +0002af00: 696f 6e20 4259 5445 3a42 4954 2e20 2054 ion BYTE:BIT. T │ │ │ │ │ +0002af10: 6869 7320 636f 6d6d 616e 6420 6973 0a20 his command is. │ │ │ │ │ +0002af20: 2020 2020 6176 6169 6c61 626c 6520 6f6e available on │ │ │ │ │ +0002af30: 6c79 206f 6e20 706c 6174 666f 726d 7320 ly on platforms │ │ │ │ │ +0002af40: 7468 6174 2073 7570 706f 7274 2043 4d4f that support CMO │ │ │ │ │ +0002af50: 532e 0a0a 1f0a 4669 6c65 3a20 6772 7562 S.....File: grub │ │ │ │ │ +0002af60: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 636d .info, Node: cm │ │ │ │ │ +0002af70: 6f73 6475 6d70 2c20 204e 6578 743a 2063 osdump, Next: c │ │ │ │ │ +0002af80: 6d6f 7374 6573 742c 2020 5072 6576 3a20 mostest, Prev: │ │ │ │ │ +0002af90: 636d 6f73 636c 6561 6e2c 2020 5570 3a20 cmosclean, Up: │ │ │ │ │ +0002afa0: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ +0002afb0: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ │ +0002afc0: 616e 6473 0a0a 3136 2e33 2e31 3320 636d ands..16.3.13 cm │ │ │ │ │ +0002afd0: 6f73 6475 6d70 0a2d 2d2d 2d2d 2d2d 2d2d osdump.--------- │ │ │ │ │ +0002afe0: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2044 756d -------.. -- Dum │ │ │ │ │ +0002aff0: 703a 2043 4d4f 5320 636f 6e74 656e 7473 p: CMOS contents │ │ │ │ │ +0002b000: 0a20 2020 2020 4475 6d70 2066 756c 6c20 . Dump full │ │ │ │ │ +0002b010: 434d 4f53 2063 6f6e 7465 6e74 7320 6173 CMOS contents as │ │ │ │ │ +0002b020: 2068 6578 6164 6563 696d 616c 2076 616c hexadecimal val │ │ │ │ │ +0002b030: 7565 732e 2020 5468 6973 2063 6f6d 6d61 ues. This comma │ │ │ │ │ +0002b040: 6e64 2069 730a 2020 2020 2061 7661 696c nd is. avail │ │ │ │ │ +0002b050: 6162 6c65 206f 6e6c 7920 6f6e 2070 6c61 able only on pla │ │ │ │ │ +0002b060: 7466 6f72 6d73 2074 6861 7420 7375 7070 tforms that supp │ │ │ │ │ +0002b070: 6f72 7420 434d 4f53 2e0a 0a1f 0a46 696c ort CMOS.....Fil │ │ │ │ │ +0002b080: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ +0002b090: 6f64 653a 2063 6d6f 7374 6573 742c 2020 ode: cmostest, │ │ │ │ │ +0002b0a0: 4e65 7874 3a20 636d 702c 2020 5072 6576 Next: cmp, Prev │ │ │ │ │ +0002b0b0: 3a20 636d 6f73 6475 6d70 2c20 2055 703a : cmosdump, Up: │ │ │ │ │ +0002b0c0: 2043 6f6d 6d61 6e64 2d6c 696e 6520 616e Command-line an │ │ │ │ │ +0002b0d0: 6420 6d65 6e75 2065 6e74 7279 2063 6f6d d menu entry com │ │ │ │ │ +0002b0e0: 6d61 6e64 730a 0a31 362e 332e 3134 2063 mands..16.3.14 c │ │ │ │ │ +0002b0f0: 6d6f 7374 6573 740a 2d2d 2d2d 2d2d 2d2d mostest.-------- │ │ │ │ │ +0002b100: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ │ +0002b110: 6d6d 616e 643a 2063 6d6f 7374 6573 7420 mmand: cmostest │ │ │ │ │ +0002b120: 6279 7465 3a62 6974 0a20 2020 2020 5465 byte:bit. Te │ │ │ │ │ +0002b130: 7374 2076 616c 7565 206f 6620 6269 7420 st value of bit │ │ │ │ │ +0002b140: 696e 2043 4d4f 5320 6174 206c 6f63 6174 in CMOS at locat │ │ │ │ │ +0002b150: 696f 6e20 4259 5445 3a42 4954 2e20 2045 ion BYTE:BIT. E │ │ │ │ │ +0002b160: 7869 7420 7374 6174 7573 2069 730a 2020 xit status is. │ │ │ │ │ +0002b170: 2020 207a 6572 6f20 6966 2062 6974 2069 zero if bit i │ │ │ │ │ +0002b180: 7320 7365 742c 206e 6f6e 207a 6572 6f20 s set, non zero │ │ │ │ │ +0002b190: 6f74 6865 7277 6973 652e 2020 5468 6973 otherwise. This │ │ │ │ │ +0002b1a0: 2063 6f6d 6d61 6e64 2069 7320 6176 6169 command is avai │ │ │ │ │ +0002b1b0: 6c61 626c 650a 2020 2020 206f 6e6c 7920 lable. only │ │ │ │ │ +0002b1c0: 6f6e 2070 6c61 7466 6f72 6d73 2074 6861 on platforms tha │ │ │ │ │ +0002b1d0: 7420 7375 7070 6f72 7420 434d 4f53 2e0a t support CMOS.. │ │ │ │ │ +0002b1e0: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ +0002b1f0: 666f 2c20 204e 6f64 653a 2063 6d70 2c20 fo, Node: cmp, │ │ │ │ │ +0002b200: 204e 6578 743a 2063 6f6e 6669 6766 696c Next: configfil │ │ │ │ │ +0002b210: 652c 2020 5072 6576 3a20 636d 6f73 7465 e, Prev: cmoste │ │ │ │ │ +0002b220: 7374 2c20 2055 703a 2043 6f6d 6d61 6e64 st, Up: Command │ │ │ │ │ +0002b230: 2d6c 696e 6520 616e 6420 6d65 6e75 2065 -line and menu e │ │ │ │ │ +0002b240: 6e74 7279 2063 6f6d 6d61 6e64 730a 0a31 ntry commands..1 │ │ │ │ │ +0002b250: 362e 332e 3135 2063 6d70 0a2d 2d2d 2d2d 6.3.15 cmp.----- │ │ │ │ │ +0002b260: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ │ +0002b270: 616e 643a 2063 6d70 2066 696c 6531 2066 and: cmp file1 f │ │ │ │ │ +0002b280: 696c 6532 0a20 2020 2020 436f 6d70 6172 ile2. Compar │ │ │ │ │ +0002b290: 6520 7468 6520 6669 6c65 2046 494c 4531 e the file FILE1 │ │ │ │ │ +0002b2a0: 2077 6974 6820 7468 6520 6669 6c65 2046 with the file F │ │ │ │ │ +0002b2b0: 494c 4532 2e20 2049 6620 7468 6579 2064 ILE2. If they d │ │ │ │ │ +0002b2c0: 6966 6665 7220 696e 0a20 2020 2020 7369 iffer in. si │ │ │ │ │ +0002b2d0: 7a65 2c20 7072 696e 7420 7468 6520 7369 ze, print the si │ │ │ │ │ +0002b2e0: 7a65 7320 6c69 6b65 2074 6869 733a 0a0a zes like this:.. │ │ │ │ │ +0002b2f0: 2020 2020 2020 2020 2020 4469 6666 6572 Differ │ │ │ │ │ +0002b300: 2069 6e20 7369 7a65 3a20 3078 3132 3334 in size: 0x1234 │ │ │ │ │ +0002b310: 205b 666f 6f5d 2c20 3078 3433 3231 205b [foo], 0x4321 [ │ │ │ │ │ +0002b320: 6261 725d 0a0a 2020 2020 2049 6620 7468 bar].. If th │ │ │ │ │ +0002b330: 6520 7369 7a65 7320 6172 6520 6571 7561 e sizes are equa │ │ │ │ │ +0002b340: 6c20 6275 7420 7468 6520 6279 7465 7320 l but the bytes │ │ │ │ │ +0002b350: 6174 2061 6e20 6f66 6673 6574 2064 6966 at an offset dif │ │ │ │ │ +0002b360: 6665 722c 2074 6865 6e0a 2020 2020 2070 fer, then. p │ │ │ │ │ +0002b370: 7269 6e74 2074 6865 2062 7974 6573 206c rint the bytes l │ │ │ │ │ +0002b380: 696b 6520 7468 6973 3a0a 0a20 2020 2020 ike this:.. │ │ │ │ │ +0002b390: 2020 2020 2044 6966 6665 7220 6174 2074 Differ at t │ │ │ │ │ +0002b3a0: 6865 206f 6666 7365 7420 3737 373a 2030 he offset 777: 0 │ │ │ │ │ +0002b3b0: 7862 6520 5b66 6f6f 5d2c 2030 7865 6620 xbe [foo], 0xef │ │ │ │ │ +0002b3c0: 5b62 6172 5d0a 0a20 2020 2020 4966 2074 [bar].. If t │ │ │ │ │ +0002b3d0: 6865 7920 6172 6520 636f 6d70 6c65 7465 hey are complete │ │ │ │ │ +0002b3e0: 6c79 2069 6465 6e74 6963 616c 2c20 6e6f ly identical, no │ │ │ │ │ +0002b3f0: 7468 696e 6720 7769 6c6c 2062 6520 7072 thing will be pr │ │ │ │ │ +0002b400: 696e 7465 642e 0a0a 1f0a 4669 6c65 3a20 inted.....File: │ │ │ │ │ +0002b410: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ +0002b420: 3a20 636f 6e66 6967 6669 6c65 2c20 204e : configfile, N │ │ │ │ │ +0002b430: 6578 743a 2063 7075 6964 2c20 2050 7265 ext: cpuid, Pre │ │ │ │ │ +0002b440: 763a 2063 6d70 2c20 2055 703a 2043 6f6d v: cmp, Up: Com │ │ │ │ │ +0002b450: 6d61 6e64 2d6c 696e 6520 616e 6420 6d65 mand-line and me │ │ │ │ │ +0002b460: 6e75 2065 6e74 7279 2063 6f6d 6d61 6e64 nu entry command │ │ │ │ │ +0002b470: 730a 0a31 362e 332e 3136 2063 6f6e 6669 s..16.3.16 confi │ │ │ │ │ +0002b480: 6766 696c 650a 2d2d 2d2d 2d2d 2d2d 2d2d gfile.---------- │ │ │ │ │ +0002b490: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ │ +0002b4a0: 6d6d 616e 643a 2063 6f6e 6669 6766 696c mmand: configfil │ │ │ │ │ +0002b4b0: 6520 6669 6c65 0a20 2020 2020 4c6f 6164 e file. Load │ │ │ │ │ +0002b4c0: 2046 494c 4520 6173 2061 2063 6f6e 6669 FILE as a confi │ │ │ │ │ +0002b4d0: 6775 7261 7469 6f6e 2066 696c 652e 2020 guration file. │ │ │ │ │ +0002b4e0: 4966 2046 494c 4520 6465 6669 6e65 7320 If FILE defines │ │ │ │ │ +0002b4f0: 616e 7920 6d65 6e75 0a20 2020 2020 656e any menu. en │ │ │ │ │ +0002b500: 7472 6965 732c 2074 6865 6e20 7368 6f77 tries, then show │ │ │ │ │ +0002b510: 2061 206d 656e 7520 636f 6e74 6169 6e69 a menu containi │ │ │ │ │ +0002b520: 6e67 2074 6865 6d20 696d 6d65 6469 6174 ng them immediat │ │ │ │ │ +0002b530: 656c 792e 2020 416e 790a 2020 2020 2065 ely. Any. e │ │ │ │ │ +0002b540: 6e76 6972 6f6e 6d65 6e74 2076 6172 6961 nvironment varia │ │ │ │ │ +0002b550: 626c 6520 6368 616e 6765 7320 6d61 6465 ble changes made │ │ │ │ │ +0002b560: 2062 7920 7468 6520 636f 6d6d 616e 6473 by the commands │ │ │ │ │ +0002b570: 2069 6e20 4649 4c45 2077 696c 6c20 6e6f in FILE will no │ │ │ │ │ +0002b580: 740a 2020 2020 2062 6520 7072 6573 6572 t. be preser │ │ │ │ │ +0002b590: 7665 6420 6166 7465 7220 2763 6f6e 6669 ved after 'confi │ │ │ │ │ +0002b5a0: 6766 696c 6527 2072 6574 7572 6e73 2e0a gfile' returns.. │ │ │ │ │ +0002b5b0: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ +0002b5c0: 666f 2c20 204e 6f64 653a 2063 7075 6964 fo, Node: cpuid │ │ │ │ │ +0002b5d0: 2c20 204e 6578 743a 2063 7263 2c20 2050 , Next: crc, P │ │ │ │ │ +0002b5e0: 7265 763a 2063 6f6e 6669 6766 696c 652c rev: configfile, │ │ │ │ │ +0002b5f0: 2020 5570 3a20 436f 6d6d 616e 642d 6c69 Up: Command-li │ │ │ │ │ +0002b600: 6e65 2061 6e64 206d 656e 7520 656e 7472 ne and menu entr │ │ │ │ │ +0002b610: 7920 636f 6d6d 616e 6473 0a0a 3136 2e33 y commands..16.3 │ │ │ │ │ +0002b620: 2e31 3720 6370 7569 640a 2d2d 2d2d 2d2d .17 cpuid.------ │ │ │ │ │ +0002b630: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d -------.. -- Com │ │ │ │ │ +0002b640: 6d61 6e64 3a20 6370 7569 6420 5b2d 6c5d mand: cpuid [-l] │ │ │ │ │ +0002b650: 205b 2d70 5d0a 2020 2020 2043 6865 636b [-p]. Check │ │ │ │ │ +0002b660: 2066 6f72 2043 5055 2066 6561 7475 7265 for CPU feature │ │ │ │ │ +0002b670: 732e 2020 5468 6973 2063 6f6d 6d61 6e64 s. This command │ │ │ │ │ +0002b680: 2069 7320 6f6e 6c79 2061 7661 696c 6162 is only availab │ │ │ │ │ +0002b690: 6c65 206f 6e20 7838 360a 2020 2020 2073 le on x86. s │ │ │ │ │ +0002b6a0: 7973 7465 6d73 2e0a 0a20 2020 2020 5769 ystems... Wi │ │ │ │ │ +0002b6b0: 7468 2074 6865 2027 2d6c 2720 6f70 7469 th the '-l' opti │ │ │ │ │ +0002b6c0: 6f6e 2c20 7265 7475 726e 2074 7275 6520 on, return true │ │ │ │ │ +0002b6d0: 6966 2074 6865 2043 5055 2073 7570 706f if the CPU suppo │ │ │ │ │ +0002b6e0: 7274 7320 6c6f 6e67 206d 6f64 650a 2020 rts long mode. │ │ │ │ │ +0002b6f0: 2020 2028 3634 2d62 6974 292e 0a0a 2020 (64-bit)... │ │ │ │ │ +0002b700: 2020 2057 6974 6820 7468 6520 272d 7027 With the '-p' │ │ │ │ │ +0002b710: 206f 7074 696f 6e2c 2072 6574 7572 6e20 option, return │ │ │ │ │ +0002b720: 7472 7565 2069 6620 7468 6520 4350 5520 true if the CPU │ │ │ │ │ +0002b730: 7375 7070 6f72 7473 2050 6879 7369 6361 supports Physica │ │ │ │ │ +0002b740: 6c0a 2020 2020 2041 6464 7265 7373 2045 l. Address E │ │ │ │ │ +0002b750: 7874 656e 7369 6f6e 2028 5041 4529 2e0a xtension (PAE).. │ │ │ │ │ +0002b760: 0a20 2020 2020 4966 2069 6e76 6f6b 6564 . If invoked │ │ │ │ │ +0002b770: 2077 6974 686f 7574 206f 7074 696f 6e73 without options │ │ │ │ │ +0002b780: 2c20 7468 6973 2063 6f6d 6d61 6e64 2063 , this command c │ │ │ │ │ +0002b790: 7572 7265 6e74 6c79 2062 6568 6176 6573 urrently behaves │ │ │ │ │ +0002b7a0: 2061 7320 6966 2069 740a 2020 2020 2068 as if it. h │ │ │ │ │ +0002b7b0: 6164 2062 6565 6e20 696e 766f 6b65 6420 ad been invoked │ │ │ │ │ +0002b7c0: 7769 7468 2027 2d6c 272e 2020 5468 6973 with '-l'. This │ │ │ │ │ +0002b7d0: 206d 6179 2063 6861 6e67 6520 696e 2074 may change in t │ │ │ │ │ +0002b7e0: 6865 2066 7574 7572 652e 0a0a 1f0a 4669 he future.....Fi │ │ │ │ │ +0002b7f0: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ +0002b800: 4e6f 6465 3a20 6372 632c 2020 4e65 7874 Node: crc, Next │ │ │ │ │ +0002b810: 3a20 6372 7970 746f 6d6f 756e 742c 2020 : cryptomount, │ │ │ │ │ +0002b820: 5072 6576 3a20 6370 7569 642c 2020 5570 Prev: cpuid, Up │ │ │ │ │ +0002b830: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ │ +0002b840: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ │ +0002b850: 6d6d 616e 6473 0a0a 3136 2e33 2e31 3820 mmands..16.3.18 │ │ │ │ │ +0002b860: 6372 630a 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a crc.-----------. │ │ │ │ │ +0002b870: 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 6372 . -- Command: cr │ │ │ │ │ +0002b880: 6320 6172 6720 2e2e 2e0a 2020 2020 2041 c arg .... A │ │ │ │ │ +0002b890: 6c69 6173 2066 6f72 2027 6861 7368 7375 lias for 'hashsu │ │ │ │ │ +0002b8a0: 6d20 2d2d 6861 7368 2063 7263 3332 2061 m --hash crc32 a │ │ │ │ │ +0002b8b0: 7267 202e 2e2e 272e 2020 5365 6520 636f rg ...'. See co │ │ │ │ │ +0002b8c0: 6d6d 616e 6420 2768 6173 6873 756d 270a mmand 'hashsum'. │ │ │ │ │ +0002b8d0: 2020 2020 2028 2a6e 6f74 6520 6861 7368 (*note hash │ │ │ │ │ +0002b8e0: 7375 6d3a 3a29 2066 6f72 2066 756c 6c20 sum::) for full │ │ │ │ │ +0002b8f0: 6465 7363 7269 7074 696f 6e2e 0a0a 1f0a description..... │ │ │ │ │ +0002b900: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ +0002b910: 2020 4e6f 6465 3a20 6372 7970 746f 6d6f Node: cryptomo │ │ │ │ │ +0002b920: 756e 742c 2020 4e65 7874 3a20 6375 746d unt, Next: cutm │ │ │ │ │ +0002b930: 656d 2c20 2050 7265 763a 2063 7263 2c20 em, Prev: crc, │ │ │ │ │ +0002b940: 2055 703a 2043 6f6d 6d61 6e64 2d6c 696e Up: Command-lin │ │ │ │ │ +0002b950: 6520 616e 6420 6d65 6e75 2065 6e74 7279 e and menu entry │ │ │ │ │ +0002b960: 2063 6f6d 6d61 6e64 730a 0a31 362e 332e commands..16.3. │ │ │ │ │ +0002b970: 3139 2063 7279 7074 6f6d 6f75 6e74 0a2d 19 cryptomount.- │ │ │ │ │ +0002b980: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ +0002b990: 2d2d 0a0a 202d 2d20 436f 6d6d 616e 643a --.. -- Command: │ │ │ │ │ +0002b9a0: 2063 7279 7074 6f6d 6f75 6e74 2064 6576 cryptomount dev │ │ │ │ │ +0002b9b0: 6963 657c 2d75 2075 7569 647c 2d61 7c2d ice|-u uuid|-a|- │ │ │ │ │ +0002b9c0: 620a 2020 2020 2053 6574 7570 2061 6363 b. Setup acc │ │ │ │ │ +0002b9d0: 6573 7320 746f 2065 6e63 7279 7074 6564 ess to encrypted │ │ │ │ │ +0002b9e0: 2064 6576 6963 652e 2020 4966 206e 6563 device. If nec │ │ │ │ │ +0002b9f0: 6573 7361 7279 2c20 7061 7373 7068 7261 essary, passphra │ │ │ │ │ +0002ba00: 7365 2069 730a 2020 2020 2072 6571 7565 se is. reque │ │ │ │ │ +0002ba10: 7374 6564 2069 6e74 6572 6163 7469 7665 sted interactive │ │ │ │ │ +0002ba20: 6c79 2e20 204f 7074 696f 6e20 4445 5649 ly. Option DEVI │ │ │ │ │ +0002ba30: 4345 2063 6f6e 6669 6775 7265 7320 7370 CE configures sp │ │ │ │ │ +0002ba40: 6563 6966 6963 2067 7275 620a 2020 2020 ecific grub. │ │ │ │ │ +0002ba50: 2064 6576 6963 6520 282a 6e6f 7465 204e device (*note N │ │ │ │ │ +0002ba60: 616d 696e 6720 636f 6e76 656e 7469 6f6e aming convention │ │ │ │ │ +0002ba70: 3a3a 293b 206f 7074 696f 6e20 272d 7527 ::); option '-u' │ │ │ │ │ +0002ba80: 2055 5549 4420 636f 6e66 6967 7572 6573 UUID configures │ │ │ │ │ +0002ba90: 0a20 2020 2020 6465 7669 6365 2077 6974 . device wit │ │ │ │ │ +0002baa0: 6820 7370 6563 6966 6965 6420 5555 4944 h specified UUID │ │ │ │ │ +0002bab0: 3b20 6f70 7469 6f6e 2027 2d61 2720 636f ; option '-a' co │ │ │ │ │ +0002bac0: 6e66 6967 7572 6573 2061 6c6c 2064 6574 nfigures all det │ │ │ │ │ +0002bad0: 6563 7465 640a 2020 2020 2065 6e63 7279 ected. encry │ │ │ │ │ +0002bae0: 7074 6564 2064 6576 6963 6573 3b20 6f70 pted devices; op │ │ │ │ │ +0002baf0: 7469 6f6e 2027 2d62 2720 636f 6e66 6967 tion '-b' config │ │ │ │ │ +0002bb00: 7572 6573 2061 6c6c 2067 656c 6920 636f ures all geli co │ │ │ │ │ +0002bb10: 6e74 6169 6e65 7273 2074 6861 740a 2020 ntainers that. │ │ │ │ │ +0002bb20: 2020 2068 6176 6520 626f 6f74 2066 6c61 have boot fla │ │ │ │ │ +0002bb30: 6720 7365 742e 0a0a 2020 2020 2047 5255 g set... GRU │ │ │ │ │ +0002bb40: 4220 7375 706f 7274 7320 6465 7669 6365 B suports device │ │ │ │ │ +0002bb50: 7320 656e 6372 7970 7465 6420 7573 696e s encrypted usin │ │ │ │ │ +0002bb60: 6720 4c55 4b53 2c20 4c55 4b53 3220 616e g LUKS, LUKS2 an │ │ │ │ │ +0002bb70: 6420 6765 6c69 2e20 204e 6f74 650a 2020 d geli. Note. │ │ │ │ │ +0002bb80: 2020 2074 6861 7420 6e65 6365 7373 6172 that necessar │ │ │ │ │ +0002bb90: 7920 6d6f 6475 6c65 7320 284c 554b 532c y modules (LUKS, │ │ │ │ │ +0002bba0: 204c 554b 5332 2061 6e64 2047 454c 4929 LUKS2 and GELI) │ │ │ │ │ +0002bbb0: 2068 6176 6520 746f 2062 6520 6c6f 6164 have to be load │ │ │ │ │ +0002bbc0: 6564 0a20 2020 2020 6d61 6e75 616c 6c79 ed. manually │ │ │ │ │ +0002bbd0: 2062 6566 6f72 6520 7468 6973 2063 6f6d before this com │ │ │ │ │ +0002bbe0: 6d61 6e64 2063 616e 2062 6520 7573 6564 mand can be used │ │ │ │ │ +0002bbf0: 2e20 2046 6f72 204c 554b 5332 206f 6e6c . For LUKS2 onl │ │ │ │ │ +0002bc00: 7920 7468 650a 2020 2020 2050 424b 4446 y the. PBKDF │ │ │ │ │ +0002bc10: 3220 6b65 7920 6465 7269 7661 7469 6f6e 2 key derivation │ │ │ │ │ +0002bc20: 2066 756e 6374 696f 6e20 6973 2073 7570 function is sup │ │ │ │ │ +0002bc30: 706f 7274 6564 2c20 6173 2041 7267 6f6e ported, as Argon │ │ │ │ │ +0002bc40: 3220 6973 206e 6f74 2079 6574 0a20 2020 2 is not yet. │ │ │ │ │ +0002bc50: 2020 7375 7070 6f72 7465 642e 0a0a 2020 supported... │ │ │ │ │ +0002bc60: 2020 2041 6c73 6f2c 206e 6f74 6520 7468 Also, note th │ │ │ │ │ +0002bc70: 6174 2c20 756e 6c69 6b65 2066 696c 6573 at, unlike files │ │ │ │ │ +0002bc80: 7973 7465 6d20 5555 4944 732c 2055 5549 ystem UUIDs, UUI │ │ │ │ │ +0002bc90: 4473 2066 6f72 2065 6e63 7279 7074 6564 Ds for encrypted │ │ │ │ │ +0002bca0: 0a20 2020 2020 6465 7669 6365 7320 6d75 . devices mu │ │ │ │ │ +0002bcb0: 7374 2062 6520 7370 6563 6966 6965 6420 st be specified │ │ │ │ │ +0002bcc0: 7769 7468 6f75 7420 6461 7368 2073 6570 without dash sep │ │ │ │ │ +0002bcd0: 6172 6174 6f72 732e 0a0a 1f0a 4669 6c65 arators.....File │ │ │ │ │ +0002bce0: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ +0002bcf0: 6465 3a20 6375 746d 656d 2c20 204e 6578 de: cutmem, Nex │ │ │ │ │ +0002bd00: 743a 2064 6174 652c 2020 5072 6576 3a20 t: date, Prev: │ │ │ │ │ +0002bd10: 6372 7970 746f 6d6f 756e 742c 2020 5570 cryptomount, Up │ │ │ │ │ +0002bd20: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ │ +0002bd30: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ │ +0002bd40: 6d6d 616e 6473 0a0a 3136 2e33 2e32 3020 mmands..16.3.20 │ │ │ │ │ +0002bd50: 6375 746d 656d 0a2d 2d2d 2d2d 2d2d 2d2d cutmem.--------- │ │ │ │ │ +0002bd60: 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 -----.. -- Comma │ │ │ │ │ +0002bd70: 6e64 3a20 6375 746d 656d 2066 726f 6d5b nd: cutmem from[ │ │ │ │ │ +0002bd80: 4b7c 4d7c 475d 2074 6f5b 4b7c 4d7c 475d K|M|G] to[K|M|G] │ │ │ │ │ +0002bd90: 0a20 2020 2020 5265 6d6f 7665 2061 6e79 . Remove any │ │ │ │ │ +0002bda0: 206d 656d 6f72 7920 7265 6769 6f6e 7320 memory regions │ │ │ │ │ +0002bdb0: 696e 2073 7065 6369 6669 6564 2072 616e in specified ran │ │ │ │ │ +0002bdc0: 6765 2e0a 0a20 2020 2020 5468 6973 2063 ge... This c │ │ │ │ │ +0002bdd0: 6f6d 6d61 6e64 206e 6f74 6966 6965 7320 ommand notifies │ │ │ │ │ +0002bde0: 7468 6520 6d65 6d6f 7279 206d 616e 6167 the memory manag │ │ │ │ │ +0002bdf0: 6572 2074 6861 7420 7370 6563 6966 6965 er that specifie │ │ │ │ │ +0002be00: 6420 7265 6769 6f6e 7320 6f66 0a20 2020 d regions of. │ │ │ │ │ +0002be10: 2020 5241 4d20 6f75 6768 7420 746f 2062 RAM ought to b │ │ │ │ │ +0002be20: 6520 6669 6c74 6572 6564 206f 7574 2e20 e filtered out. │ │ │ │ │ +0002be30: 2054 6869 7320 7265 6d61 696e 7320 696e This remains in │ │ │ │ │ +0002be40: 2065 6666 6563 7420 6166 7465 7220 610a effect after a. │ │ │ │ │ +0002be50: 2020 2020 2070 6179 6c6f 6164 206b 6572 payload ker │ │ │ │ │ +0002be60: 6e65 6c20 6861 7320 6265 656e 206c 6f61 nel has been loa │ │ │ │ │ +0002be70: 6465 6420 6279 2047 5255 422c 2061 7320 ded by GRUB, as │ │ │ │ │ +0002be80: 6c6f 6e67 2061 7320 7468 6520 6c6f 6164 long as the load │ │ │ │ │ +0002be90: 6564 0a20 2020 2020 6b65 726e 656c 206f ed. kernel o │ │ │ │ │ +0002bea0: 6274 6169 6e73 2069 7473 206d 656d 6f72 btains its memor │ │ │ │ │ +0002beb0: 7920 6d61 7020 6672 6f6d 2047 5255 422e y map from GRUB. │ │ │ │ │ +0002bec0: 204b 6572 6e65 6c73 2074 6861 7420 7375 Kernels that su │ │ │ │ │ +0002bed0: 7070 6f72 7420 7468 6973 0a20 2020 2020 pport this. │ │ │ │ │ +0002bee0: 696e 636c 7564 6520 4c69 6e75 782c 2047 include Linux, G │ │ │ │ │ +0002bef0: 4e55 204d 6163 682c 2074 6865 206b 6572 NU Mach, the ker │ │ │ │ │ +0002bf00: 6e65 6c20 6f66 2046 7265 6542 5344 2061 nel of FreeBSD a │ │ │ │ │ +0002bf10: 6e64 204d 756c 7469 626f 6f74 0a20 2020 nd Multiboot. │ │ │ │ │ +0002bf20: 2020 6b65 726e 656c 7320 696e 2067 656e kernels in gen │ │ │ │ │ +0002bf30: 6572 616c 2e0a 0a20 2020 2020 5468 6520 eral... The │ │ │ │ │ +0002bf40: 636f 6d6d 616e 6420 6973 2073 696d 696c command is simil │ │ │ │ │ +0002bf50: 6172 2074 6f20 2762 6164 7261 6d27 2063 ar to 'badram' c │ │ │ │ │ +0002bf60: 6f6d 6d61 6e64 2e0a 0a20 2020 2020 4e6f ommand... No │ │ │ │ │ +0002bf70: 7465 3a20 5468 6520 636f 6d6d 616e 6420 te: The command │ │ │ │ │ +0002bf80: 6973 206e 6f74 2061 6c6c 6f77 6564 2077 is not allowed w │ │ │ │ │ +0002bf90: 6865 6e20 6c6f 636b 646f 776e 2069 7320 hen lockdown is │ │ │ │ │ +0002bfa0: 656e 666f 7263 6564 2028 2a6e 6f74 650a enforced (*note. │ │ │ │ │ +0002bfb0: 2020 2020 204c 6f63 6b64 6f77 6e3a 3a29 Lockdown::) │ │ │ │ │ +0002bfc0: 2e20 2054 6869 7320 7072 6576 656e 7473 . This prevents │ │ │ │ │ +0002bfd0: 2072 656d 6f76 696e 6720 4546 4920 6d65 removing EFI me │ │ │ │ │ +0002bfe0: 6d6f 7279 2072 6567 696f 6e73 2074 6f0a mory regions to. │ │ │ │ │ +0002bff0: 2020 2020 2070 6f74 656e 7469 616c 6c79 potentially │ │ │ │ │ +0002c000: 2073 7562 7665 7274 2074 6865 2073 6563 subvert the sec │ │ │ │ │ +0002c010: 7572 6974 7920 6d65 6368 616e 6973 6d73 urity mechanisms │ │ │ │ │ +0002c020: 2070 726f 7669 6465 6420 6279 2074 6865 provided by the │ │ │ │ │ +0002c030: 2055 4546 490a 2020 2020 2073 6563 7572 UEFI. secur │ │ │ │ │ +0002c040: 6520 626f 6f74 2e0a 0a1f 0a46 696c 653a e boot.....File: │ │ │ │ │ +0002c050: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ +0002c060: 653a 2064 6174 652c 2020 4e65 7874 3a20 e: date, Next: │ │ │ │ │ +0002c070: 6465 7669 6365 7472 6565 2c20 2050 7265 devicetree, Pre │ │ │ │ │ +0002c080: 763a 2063 7574 6d65 6d2c 2020 5570 3a20 v: cutmem, Up: │ │ │ │ │ +0002c090: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ +0002c0a0: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ │ +0002c0b0: 616e 6473 0a0a 3136 2e33 2e32 3120 6461 ands..16.3.21 da │ │ │ │ │ +0002c0c0: 7465 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a te.------------. │ │ │ │ │ +0002c0d0: 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 6461 . -- Command: da │ │ │ │ │ +0002c0e0: 7465 205b 5b79 6561 722d 5d6d 6f6e 7468 te [[year-]month │ │ │ │ │ +0002c0f0: 2d64 6179 5d20 5b68 6f75 723a 6d69 6e75 -day] [hour:minu │ │ │ │ │ +0002c100: 7465 5b3a 7365 636f 6e64 5d5d 0a20 2020 te[:second]]. │ │ │ │ │ +0002c110: 2020 5769 7468 206e 6f20 6172 6775 6d65 With no argume │ │ │ │ │ +0002c120: 6e74 732c 2070 7269 6e74 2074 6865 2063 nts, print the c │ │ │ │ │ +0002c130: 7572 7265 6e74 2064 6174 6520 616e 6420 urrent date and │ │ │ │ │ +0002c140: 7469 6d65 2e0a 0a20 2020 2020 4f74 6865 time... Othe │ │ │ │ │ +0002c150: 7277 6973 652c 2074 616b 6520 7468 6520 rwise, take the │ │ │ │ │ +0002c160: 6375 7272 656e 7420 6461 7465 2061 6e64 current date and │ │ │ │ │ +0002c170: 2074 696d 652c 2063 6861 6e67 6520 616e time, change an │ │ │ │ │ +0002c180: 7920 656c 656d 656e 7473 0a20 2020 2020 y elements. │ │ │ │ │ +0002c190: 7370 6563 6966 6965 6420 6173 2061 7267 specified as arg │ │ │ │ │ +0002c1a0: 756d 656e 7473 2c20 616e 6420 7365 7420 uments, and set │ │ │ │ │ +0002c1b0: 7468 6520 7265 7375 6c74 2061 7320 7468 the result as th │ │ │ │ │ +0002c1c0: 6520 6e65 7720 6461 7465 2061 6e64 0a20 e new date and. │ │ │ │ │ +0002c1d0: 2020 2020 7469 6d65 2e20 2046 6f72 2065 time. For e │ │ │ │ │ +0002c1e0: 7861 6d70 6c65 2c20 2764 6174 6520 3031 xample, 'date 01 │ │ │ │ │ +0002c1f0: 2d30 3127 2077 696c 6c20 7365 7420 7468 -01' will set th │ │ │ │ │ +0002c200: 6520 6375 7272 656e 7420 6d6f 6e74 6820 e current month │ │ │ │ │ +0002c210: 616e 6420 6461 790a 2020 2020 2074 6f20 and day. to │ │ │ │ │ +0002c220: 4a61 6e75 6172 7920 312c 2062 7574 206c January 1, but l │ │ │ │ │ +0002c230: 6561 7665 2074 6865 2079 6561 722c 2068 eave the year, h │ │ │ │ │ +0002c240: 6f75 722c 206d 696e 7574 652c 2061 6e64 our, minute, and │ │ │ │ │ +0002c250: 2073 6563 6f6e 640a 2020 2020 2075 6e63 second. unc │ │ │ │ │ +0002c260: 6861 6e67 6564 2e0a 0a1f 0a46 696c 653a hanged.....File: │ │ │ │ │ +0002c270: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ +0002c280: 653a 2064 6576 6963 6574 7265 652c 2020 e: devicetree, │ │ │ │ │ +0002c290: 4e65 7874 3a20 6469 7374 7275 7374 2c20 Next: distrust, │ │ │ │ │ +0002c2a0: 2050 7265 763a 2064 6174 652c 2020 5570 Prev: date, Up │ │ │ │ │ +0002c2b0: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ │ +0002c2c0: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ │ +0002c2d0: 6d6d 616e 6473 0a0a 3136 2e33 2e32 3220 mmands..16.3.22 │ │ │ │ │ +0002c2e0: 6465 7669 6365 7472 6565 0a2d 2d2d 2d2d devicetree.----- │ │ │ │ │ +0002c2f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 -------------.. │ │ │ │ │ +0002c300: 2d2d 2043 6f6d 6d61 6e64 3a20 6465 7669 -- Command: devi │ │ │ │ │ +0002c310: 6365 7472 6565 2066 696c 650a 2020 2020 cetree file. │ │ │ │ │ +0002c320: 204c 6f61 6420 6120 6465 7669 6365 2074 Load a device t │ │ │ │ │ +0002c330: 7265 6520 626c 6f62 2028 2e64 7462 2920 ree blob (.dtb) │ │ │ │ │ +0002c340: 6672 6f6d 2061 2066 696c 6573 7973 7465 from a filesyste │ │ │ │ │ +0002c350: 6d2c 2066 6f72 206c 6174 6572 2075 7365 m, for later use │ │ │ │ │ +0002c360: 2062 790a 2020 2020 2061 204c 696e 7578 by. a Linux │ │ │ │ │ +0002c370: 206b 6572 6e65 6c2e 2020 446f 6573 206e kernel. Does n │ │ │ │ │ +0002c380: 6f74 2070 6572 666f 726d 206d 6572 6769 ot perform mergi │ │ │ │ │ +0002c390: 6e67 2077 6974 6820 616e 7920 6465 7669 ng with any devi │ │ │ │ │ +0002c3a0: 6365 2074 7265 650a 2020 2020 2073 7570 ce tree. sup │ │ │ │ │ +0002c3b0: 706c 6965 6420 6279 2066 6972 6d77 6172 plied by firmwar │ │ │ │ │ +0002c3c0: 652c 2062 7574 2072 6174 6865 7220 7265 e, but rather re │ │ │ │ │ +0002c3d0: 706c 6163 6573 2069 7420 636f 6d70 6c65 places it comple │ │ │ │ │ +0002c3e0: 7465 6c79 2e0a 0a20 2020 2020 4e6f 7465 tely... Note │ │ │ │ │ +0002c3f0: 3a20 5468 6520 636f 6d6d 616e 6420 6973 : The command is │ │ │ │ │ +0002c400: 206e 6f74 2061 6c6c 6f77 6564 2077 6865 not allowed whe │ │ │ │ │ +0002c410: 6e20 6c6f 636b 646f 776e 2069 7320 656e n lockdown is en │ │ │ │ │ +0002c420: 666f 7263 6564 2028 2a6e 6f74 650a 2020 forced (*note. │ │ │ │ │ +0002c430: 2020 204c 6f63 6b64 6f77 6e3a 3a29 2e20 Lockdown::). │ │ │ │ │ +0002c440: 2054 6869 7320 6973 2064 6f6e 6520 746f This is done to │ │ │ │ │ +0002c450: 2070 7265 7665 6e74 2073 7562 7665 7274 prevent subvert │ │ │ │ │ +0002c460: 696e 6720 7661 7269 6f75 7320 7365 6375 ing various secu │ │ │ │ │ +0002c470: 7269 7479 0a20 2020 2020 6d65 6368 616e rity. mechan │ │ │ │ │ +0002c480: 6973 6d73 2e0a 0a1f 0a46 696c 653a 2067 isms.....File: g │ │ │ │ │ +0002c490: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ +0002c4a0: 2064 6973 7472 7573 742c 2020 4e65 7874 distrust, Next │ │ │ │ │ +0002c4b0: 3a20 6472 6976 656d 6170 2c20 2050 7265 : drivemap, Pre │ │ │ │ │ +0002c4c0: 763a 2064 6576 6963 6574 7265 652c 2020 v: devicetree, │ │ │ │ │ +0002c4d0: 5570 3a20 436f 6d6d 616e 642d 6c69 6e65 Up: Command-line │ │ │ │ │ +0002c4e0: 2061 6e64 206d 656e 7520 656e 7472 7920 and menu entry │ │ │ │ │ +0002c4f0: 636f 6d6d 616e 6473 0a0a 3136 2e33 2e32 commands..16.3.2 │ │ │ │ │ +0002c500: 3320 6469 7374 7275 7374 0a2d 2d2d 2d2d 3 distrust.----- │ │ │ │ │ +0002c510: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d -----------.. -- │ │ │ │ │ +0002c520: 2043 6f6d 6d61 6e64 3a20 6469 7374 7275 Command: distru │ │ │ │ │ +0002c530: 7374 2070 7562 6b65 795f 6964 0a20 2020 st pubkey_id. │ │ │ │ │ +0002c540: 2020 5265 6d6f 7665 2070 7562 6c69 6320 Remove public │ │ │ │ │ +0002c550: 6b65 7920 5055 424b 4559 5f49 4420 6672 key PUBKEY_ID fr │ │ │ │ │ +0002c560: 6f6d 2047 5255 4227 7320 6b65 7972 696e om GRUB's keyrin │ │ │ │ │ +0002c570: 6720 6f66 2074 7275 7374 6564 206b 6579 g of trusted key │ │ │ │ │ +0002c580: 732e 0a20 2020 2020 5055 424b 4559 5f49 s.. PUBKEY_I │ │ │ │ │ +0002c590: 4420 6973 2074 6865 206c 6173 7420 666f D is the last fo │ │ │ │ │ +0002c5a0: 7572 2062 7974 6573 2028 6569 6768 7420 ur bytes (eight │ │ │ │ │ +0002c5b0: 6865 7861 6465 6369 6d61 6c20 6469 6769 hexadecimal digi │ │ │ │ │ +0002c5c0: 7473 2920 6f66 2074 6865 0a20 2020 2020 ts) of the. │ │ │ │ │ +0002c5d0: 4750 4720 7634 206b 6579 2069 642c 2077 GPG v4 key id, w │ │ │ │ │ +0002c5e0: 6869 6368 2069 7320 616c 736f 2074 6865 hich is also the │ │ │ │ │ +0002c5f0: 206f 7574 7075 7420 6f66 2027 6c69 7374 output of 'list │ │ │ │ │ +0002c600: 5f74 7275 7374 6564 2720 282a 6e6f 7465 _trusted' (*note │ │ │ │ │ +0002c610: 0a20 2020 2020 6c69 7374 5f74 7275 7374 . list_trust │ │ │ │ │ +0002c620: 6564 3a3a 292e 2020 4f75 7473 6964 6520 ed::). Outside │ │ │ │ │ +0002c630: 6f66 2047 5255 422c 2074 6865 206b 6579 of GRUB, the key │ │ │ │ │ +0002c640: 2069 6420 6361 6e20 6265 206f 6274 6169 id can be obtai │ │ │ │ │ +0002c650: 6e65 6420 7573 696e 670a 2020 2020 2027 ned using. ' │ │ │ │ │ +0002c660: 6770 6720 2d2d 6669 6e67 6572 7072 696e gpg --fingerprin │ │ │ │ │ +0002c670: 7427 292e 2020 5468 6573 6520 6b65 7973 t'). These keys │ │ │ │ │ +0002c680: 2061 7265 2075 7365 6420 746f 2076 616c are used to val │ │ │ │ │ +0002c690: 6964 6174 6520 7369 676e 6174 7572 6573 idate signatures │ │ │ │ │ +0002c6a0: 0a20 2020 2020 7768 656e 2065 6e76 6972 . when envir │ │ │ │ │ +0002c6b0: 6f6e 6d65 6e74 2076 6172 6961 626c 6520 onment variable │ │ │ │ │ +0002c6c0: 2763 6865 636b 5f73 6967 6e61 7475 7265 'check_signature │ │ │ │ │ +0002c6d0: 7327 2069 7320 7365 7420 746f 2027 656e s' is set to 'en │ │ │ │ │ +0002c6e0: 666f 7263 6527 0a20 2020 2020 282a 6e6f force'. (*no │ │ │ │ │ +0002c6f0: 7465 2063 6865 636b 5f73 6967 6e61 7475 te check_signatu │ │ │ │ │ +0002c700: 7265 733a 3a29 2c20 616e 6420 6279 2073 res::), and by s │ │ │ │ │ +0002c710: 6f6d 6520 696e 766f 6361 7469 6f6e 7320 ome invocations │ │ │ │ │ +0002c720: 6f66 0a20 2020 2020 2776 6572 6966 795f of. 'verify_ │ │ │ │ │ +0002c730: 6465 7461 6368 6564 2720 282a 6e6f 7465 detached' (*note │ │ │ │ │ +0002c740: 2076 6572 6966 795f 6465 7461 6368 6564 verify_detached │ │ │ │ │ +0002c750: 3a3a 292e 2020 2a4e 6f74 6520 5573 696e ::). *Note Usin │ │ │ │ │ +0002c760: 6720 6469 6769 7461 6c0a 2020 2020 2073 g digital. s │ │ │ │ │ +0002c770: 6967 6e61 7475 7265 733a 3a2c 2066 6f72 ignatures::, for │ │ │ │ │ +0002c780: 206d 6f72 6520 696e 666f 726d 6174 696f more informatio │ │ │ │ │ +0002c790: 6e2e 0a0a 1f0a 4669 6c65 3a20 6772 7562 n.....File: grub │ │ │ │ │ +0002c7a0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 6472 .info, Node: dr │ │ │ │ │ +0002c7b0: 6976 656d 6170 2c20 204e 6578 743a 2065 ivemap, Next: e │ │ │ │ │ +0002c7c0: 6368 6f2c 2020 5072 6576 3a20 6469 7374 cho, Prev: dist │ │ │ │ │ +0002c7d0: 7275 7374 2c20 2055 703a 2043 6f6d 6d61 rust, Up: Comma │ │ │ │ │ +0002c7e0: 6e64 2d6c 696e 6520 616e 6420 6d65 6e75 nd-line and menu │ │ │ │ │ +0002c7f0: 2065 6e74 7279 2063 6f6d 6d61 6e64 730a entry commands. │ │ │ │ │ +0002c800: 0a31 362e 332e 3234 2064 7269 7665 6d61 .16.3.24 drivema │ │ │ │ │ +0002c810: 700a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d p.-------------- │ │ │ │ │ +0002c820: 2d2d 0a0a 202d 2d20 436f 6d6d 616e 643a --.. -- Command: │ │ │ │ │ +0002c830: 2064 7269 7665 6d61 7020 2d6c 7c2d 727c drivemap -l|-r| │ │ │ │ │ +0002c840: 5b2d 735d 2066 726f 6d5f 6472 6976 6520 [-s] from_drive │ │ │ │ │ +0002c850: 746f 5f64 7269 7665 0a20 2020 2020 5769 to_drive. Wi │ │ │ │ │ +0002c860: 7468 6f75 7420 6f70 7469 6f6e 732c 206d thout options, m │ │ │ │ │ +0002c870: 6170 2074 6865 2064 7269 7665 2046 524f ap the drive FRO │ │ │ │ │ +0002c880: 4d5f 4452 4956 4520 746f 2074 6865 2064 M_DRIVE to the d │ │ │ │ │ +0002c890: 7269 7665 2054 4f5f 4452 4956 452e 0a20 rive TO_DRIVE.. │ │ │ │ │ +0002c8a0: 2020 2020 5468 6973 2069 7320 6e65 6365 This is nece │ │ │ │ │ +0002c8b0: 7373 6172 7920 7768 656e 2079 6f75 2063 ssary when you c │ │ │ │ │ +0002c8c0: 6861 696e 2d6c 6f61 6420 736f 6d65 206f hain-load some o │ │ │ │ │ +0002c8d0: 7065 7261 7469 6e67 2073 7973 7465 6d73 perating systems │ │ │ │ │ +0002c8e0: 2c20 7375 6368 0a20 2020 2020 6173 2044 , such. as D │ │ │ │ │ +0002c8f0: 4f53 2c20 6966 2073 7563 6820 616e 204f OS, if such an O │ │ │ │ │ +0002c900: 5320 7265 7369 6465 7320 6174 2061 206e S resides at a n │ │ │ │ │ +0002c910: 6f6e 2d66 6972 7374 2064 7269 7665 2e20 on-first drive. │ │ │ │ │ +0002c920: 2046 6f72 0a20 2020 2020 636f 6e76 656e For. conven │ │ │ │ │ +0002c930: 6965 6e63 652c 2061 6e79 2070 6172 7469 ience, any parti │ │ │ │ │ +0002c940: 7469 6f6e 2073 7566 6669 7820 6f6e 2074 tion suffix on t │ │ │ │ │ +0002c950: 6865 2064 7269 7665 2069 7320 6967 6e6f he drive is igno │ │ │ │ │ +0002c960: 7265 642c 2073 6f20 796f 750a 2020 2020 red, so you. │ │ │ │ │ +0002c970: 2063 616e 2073 6166 656c 7920 7573 6520 can safely use │ │ │ │ │ +0002c980: 247b 726f 6f74 7d20 6173 2061 2064 7269 ${root} as a dri │ │ │ │ │ +0002c990: 7665 2073 7065 6369 6669 6361 7469 6f6e ve specification │ │ │ │ │ +0002c9a0: 2e0a 0a20 2020 2020 5769 7468 2074 6865 ... With the │ │ │ │ │ +0002c9b0: 2027 2d73 2720 6f70 7469 6f6e 2c20 7065 '-s' option, pe │ │ │ │ │ +0002c9c0: 7266 6f72 6d20 7468 6520 7265 7665 7273 rform the revers │ │ │ │ │ +0002c9d0: 6520 6d61 7070 696e 6720 6173 2077 656c e mapping as wel │ │ │ │ │ +0002c9e0: 6c2c 2073 7761 7070 696e 670a 2020 2020 l, swapping. │ │ │ │ │ +0002c9f0: 2074 6865 2074 776f 2064 7269 7665 732e the two drives. │ │ │ │ │ +0002ca00: 0a0a 2020 2020 2057 6974 6820 7468 6520 .. With the │ │ │ │ │ +0002ca10: 272d 6c27 206f 7074 696f 6e2c 206c 6973 '-l' option, lis │ │ │ │ │ +0002ca20: 7420 7468 6520 6375 7272 656e 7420 6d61 t the current ma │ │ │ │ │ +0002ca30: 7070 696e 6773 2e0a 0a20 2020 2020 5769 ppings... Wi │ │ │ │ │ +0002ca40: 7468 2074 6865 2027 2d72 2720 6f70 7469 th the '-r' opti │ │ │ │ │ +0002ca50: 6f6e 2c20 7265 7365 7420 616c 6c20 6d61 on, reset all ma │ │ │ │ │ +0002ca60: 7070 696e 6773 2074 6f20 7468 6520 6465 ppings to the de │ │ │ │ │ +0002ca70: 6661 756c 7420 7661 6c75 6573 2e0a 0a20 fault values... │ │ │ │ │ +0002ca80: 2020 2020 466f 7220 6578 616d 706c 653a For example: │ │ │ │ │ +0002ca90: 0a0a 2020 2020 2020 2020 2020 6472 6976 .. driv │ │ │ │ │ +0002caa0: 656d 6170 202d 7320 2868 6430 2920 2868 emap -s (hd0) (h │ │ │ │ │ +0002cab0: 6431 290a 0a1f 0a46 696c 653a 2067 7275 d1)....File: gru │ │ │ │ │ +0002cac0: 622e 696e 666f 2c20 204e 6f64 653a 2065 b.info, Node: e │ │ │ │ │ +0002cad0: 6368 6f2c 2020 4e65 7874 3a20 6576 616c cho, Next: eval │ │ │ │ │ +0002cae0: 2c20 2050 7265 763a 2064 7269 7665 6d61 , Prev: drivema │ │ │ │ │ +0002caf0: 702c 2020 5570 3a20 436f 6d6d 616e 642d p, Up: Command- │ │ │ │ │ +0002cb00: 6c69 6e65 2061 6e64 206d 656e 7520 656e line and menu en │ │ │ │ │ +0002cb10: 7472 7920 636f 6d6d 616e 6473 0a0a 3136 try commands..16 │ │ │ │ │ +0002cb20: 2e33 2e32 3520 6563 686f 0a2d 2d2d 2d2d .3.25 echo.----- │ │ │ │ │ +0002cb30: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d -------.. -- Com │ │ │ │ │ +0002cb40: 6d61 6e64 3a20 6563 686f 205b 2d6e 5d20 mand: echo [-n] │ │ │ │ │ +0002cb50: 5b2d 655d 2073 7472 696e 6720 2e2e 2e0a [-e] string .... │ │ │ │ │ +0002cb60: 2020 2020 2044 6973 706c 6179 2074 6865 Display the │ │ │ │ │ +0002cb70: 2072 6571 7565 7374 6564 2074 6578 7420 requested text │ │ │ │ │ +0002cb80: 616e 642c 2075 6e6c 6573 7320 7468 6520 and, unless the │ │ │ │ │ +0002cb90: 272d 6e27 206f 7074 696f 6e20 6973 2075 '-n' option is u │ │ │ │ │ +0002cba0: 7365 642c 2061 0a20 2020 2020 7472 6169 sed, a. trai │ │ │ │ │ +0002cbb0: 6c69 6e67 206e 6577 206c 696e 652e 2020 ling new line. │ │ │ │ │ +0002cbc0: 4966 2074 6865 7265 2069 7320 6d6f 7265 If there is more │ │ │ │ │ +0002cbd0: 2074 6861 6e20 6f6e 6520 7374 7269 6e67 than one string │ │ │ │ │ +0002cbe0: 2c20 7468 6579 2061 7265 0a20 2020 2020 , they are. │ │ │ │ │ +0002cbf0: 7365 7061 7261 7465 6420 6279 2073 7061 separated by spa │ │ │ │ │ +0002cc00: 6365 7320 696e 2074 6865 206f 7574 7075 ces in the outpu │ │ │ │ │ +0002cc10: 742e 2020 4173 2075 7375 616c 2069 6e20 t. As usual in │ │ │ │ │ +0002cc20: 4752 5542 2063 6f6d 6d61 6e64 732c 0a20 GRUB commands,. │ │ │ │ │ +0002cc30: 2020 2020 7661 7269 6162 6c65 7320 6d61 variables ma │ │ │ │ │ +0002cc40: 7920 6265 2073 7562 7374 6974 7574 6564 y be substituted │ │ │ │ │ +0002cc50: 2075 7369 6e67 2027 247b 7661 727d 272e using '${var}'. │ │ │ │ │ +0002cc60: 0a0a 2020 2020 2054 6865 2027 2d65 2720 .. The '-e' │ │ │ │ │ +0002cc70: 6f70 7469 6f6e 2065 6e61 626c 6573 2069 option enables i │ │ │ │ │ +0002cc80: 6e74 6572 7072 6574 6174 696f 6e20 6f66 nterpretation of │ │ │ │ │ +0002cc90: 2062 6163 6b73 6c61 7368 2065 7363 6170 backslash escap │ │ │ │ │ +0002cca0: 6573 2e20 2054 6865 0a20 2020 2020 666f es. The. fo │ │ │ │ │ +0002ccb0: 6c6c 6f77 696e 6720 7365 7175 656e 6365 llowing sequence │ │ │ │ │ +0002ccc0: 7320 6172 6520 7265 636f 676e 6973 6564 s are recognised │ │ │ │ │ +0002ccd0: 3a0a 0a20 2020 2020 275c 5c27 0a20 2020 :.. '\\'. │ │ │ │ │ +0002cce0: 2020 2020 2020 2062 6163 6b73 6c61 7368 backslash │ │ │ │ │ +0002ccf0: 0a0a 2020 2020 2027 5c61 270a 2020 2020 .. '\a'. │ │ │ │ │ +0002cd00: 2020 2020 2020 616c 6572 7420 2842 454c alert (BEL │ │ │ │ │ +0002cd10: 290a 0a20 2020 2020 275c 6327 0a20 2020 ).. '\c'. │ │ │ │ │ +0002cd20: 2020 2020 2020 2073 7570 7072 6573 7320 suppress │ │ │ │ │ +0002cd30: 7472 6169 6c69 6e67 206e 6577 206c 696e trailing new lin │ │ │ │ │ +0002cd40: 650a 0a20 2020 2020 275c 6627 0a20 2020 e.. '\f'. │ │ │ │ │ +0002cd50: 2020 2020 2020 2066 6f72 6d20 6665 6564 form feed │ │ │ │ │ +0002cd60: 0a0a 2020 2020 2027 5c6e 270a 2020 2020 .. '\n'. │ │ │ │ │ +0002cd70: 2020 2020 2020 6e65 7720 6c69 6e65 0a0a new line.. │ │ │ │ │ +0002cd80: 2020 2020 2027 5c72 270a 2020 2020 2020 '\r'. │ │ │ │ │ +0002cd90: 2020 2020 6361 7272 6961 6765 2072 6574 carriage ret │ │ │ │ │ +0002cda0: 7572 6e0a 0a20 2020 2020 275c 7427 0a20 urn.. '\t'. │ │ │ │ │ +0002cdb0: 2020 2020 2020 2020 2068 6f72 697a 6f6e horizon │ │ │ │ │ +0002cdc0: 7461 6c20 7461 620a 0a20 2020 2020 275c tal tab.. '\ │ │ │ │ │ +0002cdd0: 7627 0a20 2020 2020 2020 2020 2076 6572 v'. ver │ │ │ │ │ +0002cde0: 7469 6361 6c20 7461 620a 0a20 2020 2020 tical tab.. │ │ │ │ │ +0002cdf0: 5768 656e 2069 6e74 6572 7072 6574 696e When interpretin │ │ │ │ │ +0002ce00: 6720 6261 636b 736c 6173 6820 6573 6361 g backslash esca │ │ │ │ │ +0002ce10: 7065 732c 2062 6163 6b73 6c61 7368 2066 pes, backslash f │ │ │ │ │ +0002ce20: 6f6c 6c6f 7765 6420 6279 2061 6e79 0a20 ollowed by any. │ │ │ │ │ +0002ce30: 2020 2020 6f74 6865 7220 6368 6172 6163 other charac │ │ │ │ │ +0002ce40: 7465 7220 7769 6c6c 2070 7269 6e74 2074 ter will print t │ │ │ │ │ +0002ce50: 6861 7420 6368 6172 6163 7465 722e 0a0a hat character... │ │ │ │ │ +0002ce60: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ +0002ce70: 6f2c 2020 4e6f 6465 3a20 6576 616c 2c20 o, Node: eval, │ │ │ │ │ +0002ce80: 204e 6578 743a 2065 7870 6f72 742c 2020 Next: export, │ │ │ │ │ +0002ce90: 5072 6576 3a20 6563 686f 2c20 2055 703a Prev: echo, Up: │ │ │ │ │ +0002cea0: 2043 6f6d 6d61 6e64 2d6c 696e 6520 616e Command-line an │ │ │ │ │ +0002ceb0: 6420 6d65 6e75 2065 6e74 7279 2063 6f6d d menu entry com │ │ │ │ │ +0002cec0: 6d61 6e64 730a 0a31 362e 332e 3236 2065 mands..16.3.26 e │ │ │ │ │ +0002ced0: 7661 6c0a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d val.------------ │ │ │ │ │ +0002cee0: 0a0a 202d 2d20 436f 6d6d 616e 643a 2065 .. -- Command: e │ │ │ │ │ +0002cef0: 7661 6c20 7374 7269 6e67 202e 2e2e 0a20 val string .... │ │ │ │ │ +0002cf00: 2020 2020 436f 6e63 6174 656e 6174 6520 Concatenate │ │ │ │ │ +0002cf10: 6172 6775 6d65 6e74 7320 746f 6765 7468 arguments togeth │ │ │ │ │ +0002cf20: 6572 2075 7369 6e67 2073 696e 676c 6520 er using single │ │ │ │ │ +0002cf30: 7370 6163 6520 6173 2073 6570 6172 6174 space as separat │ │ │ │ │ +0002cf40: 6f72 2061 6e64 0a20 2020 2020 6576 616c or and. eval │ │ │ │ │ +0002cf50: 7561 7465 2072 6573 756c 7420 6173 2073 uate result as s │ │ │ │ │ +0002cf60: 6571 7565 6e63 6520 6f66 2047 5255 4220 equence of GRUB │ │ │ │ │ +0002cf70: 636f 6d6d 616e 6473 2e0a 0a1f 0a46 696c commands.....Fil │ │ │ │ │ +0002cf80: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ +0002cf90: 6f64 653a 2065 7870 6f72 742c 2020 4e65 ode: export, Ne │ │ │ │ │ +0002cfa0: 7874 3a20 6661 6c73 652c 2020 5072 6576 xt: false, Prev │ │ │ │ │ +0002cfb0: 3a20 6576 616c 2c20 2055 703a 2043 6f6d : eval, Up: Com │ │ │ │ │ +0002cfc0: 6d61 6e64 2d6c 696e 6520 616e 6420 6d65 mand-line and me │ │ │ │ │ +0002cfd0: 6e75 2065 6e74 7279 2063 6f6d 6d61 6e64 nu entry command │ │ │ │ │ +0002cfe0: 730a 0a31 362e 332e 3237 2065 7870 6f72 s..16.3.27 expor │ │ │ │ │ +0002cff0: 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d t.-------------- │ │ │ │ │ +0002d000: 0a0a 202d 2d20 436f 6d6d 616e 643a 2065 .. -- Command: e │ │ │ │ │ +0002d010: 7870 6f72 7420 656e 7676 6172 0a20 2020 xport envvar. │ │ │ │ │ +0002d020: 2020 4578 706f 7274 2074 6865 2065 6e76 Export the env │ │ │ │ │ +0002d030: 6972 6f6e 6d65 6e74 2076 6172 6961 626c ironment variabl │ │ │ │ │ +0002d040: 6520 454e 5656 4152 2e20 2045 7870 6f72 e ENVVAR. Expor │ │ │ │ │ +0002d050: 7465 6420 7661 7269 6162 6c65 7320 6172 ted variables ar │ │ │ │ │ +0002d060: 650a 2020 2020 2076 6973 6962 6c65 2074 e. visible t │ │ │ │ │ +0002d070: 6f20 7375 6273 6964 6961 7279 2063 6f6e o subsidiary con │ │ │ │ │ +0002d080: 6669 6775 7261 7469 6f6e 2066 696c 6573 figuration files │ │ │ │ │ +0002d090: 206c 6f61 6465 6420 7573 696e 670a 2020 loaded using. │ │ │ │ │ +0002d0a0: 2020 2027 636f 6e66 6967 6669 6c65 272e 'configfile'. │ │ │ │ │ +0002d0b0: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ +0002d0c0: 6e66 6f2c 2020 4e6f 6465 3a20 6661 6c73 nfo, Node: fals │ │ │ │ │ +0002d0d0: 652c 2020 4e65 7874 3a20 6765 7474 6578 e, Next: gettex │ │ │ │ │ +0002d0e0: 742c 2020 5072 6576 3a20 6578 706f 7274 t, Prev: export │ │ │ │ │ +0002d0f0: 2c20 2055 703a 2043 6f6d 6d61 6e64 2d6c , Up: Command-l │ │ │ │ │ +0002d100: 696e 6520 616e 6420 6d65 6e75 2065 6e74 ine and menu ent │ │ │ │ │ +0002d110: 7279 2063 6f6d 6d61 6e64 730a 0a31 362e ry commands..16. │ │ │ │ │ +0002d120: 332e 3238 2066 616c 7365 0a2d 2d2d 2d2d 3.28 false.----- │ │ │ │ │ +0002d130: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ │ +0002d140: 6d6d 616e 643a 2066 616c 7365 0a20 2020 mmand: false. │ │ │ │ │ +0002d150: 2020 446f 206e 6f74 6869 6e67 2c20 756e Do nothing, un │ │ │ │ │ +0002d160: 7375 6363 6573 7366 756c 6c79 2e20 2054 successfully. T │ │ │ │ │ +0002d170: 6869 7320 6973 206d 6169 6e6c 7920 7573 his is mainly us │ │ │ │ │ +0002d180: 6566 756c 2069 6e20 636f 6e74 726f 6c0a eful in control. │ │ │ │ │ +0002d190: 2020 2020 2063 6f6e 7374 7275 6374 7320 constructs │ │ │ │ │ +0002d1a0: 7375 6368 2061 7320 2769 6627 2061 6e64 such as 'if' and │ │ │ │ │ +0002d1b0: 2027 7768 696c 6527 2028 2a6e 6f74 6520 'while' (*note │ │ │ │ │ +0002d1c0: 5368 656c 6c2d 6c69 6b65 2073 6372 6970 Shell-like scrip │ │ │ │ │ +0002d1d0: 7469 6e67 3a3a 292e 0a0a 1f0a 4669 6c65 ting::).....File │ │ │ │ │ +0002d1e0: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ +0002d1f0: 6465 3a20 6765 7474 6578 742c 2020 4e65 de: gettext, Ne │ │ │ │ │ +0002d200: 7874 3a20 6770 7473 796e 632c 2020 5072 xt: gptsync, Pr │ │ │ │ │ +0002d210: 6576 3a20 6661 6c73 652c 2020 5570 3a20 ev: false, Up: │ │ │ │ │ +0002d220: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ +0002d230: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ │ +0002d240: 616e 6473 0a0a 3136 2e33 2e32 3920 6765 ands..16.3.29 ge │ │ │ │ │ +0002d250: 7474 6578 740a 2d2d 2d2d 2d2d 2d2d 2d2d ttext.---------- │ │ │ │ │ +0002d260: 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 -----.. -- Comma │ │ │ │ │ +0002d270: 6e64 3a20 6765 7474 6578 7420 7374 7269 nd: gettext stri │ │ │ │ │ +0002d280: 6e67 0a20 2020 2020 5472 616e 736c 6174 ng. Translat │ │ │ │ │ +0002d290: 6520 5354 5249 4e47 2069 6e74 6f20 7468 e STRING into th │ │ │ │ │ +0002d2a0: 6520 6375 7272 656e 7420 6c61 6e67 7561 e current langua │ │ │ │ │ +0002d2b0: 6765 2e0a 0a20 2020 2020 5468 6520 6375 ge... The cu │ │ │ │ │ +0002d2c0: 7272 656e 7420 6c61 6e67 7561 6765 2063 rrent language c │ │ │ │ │ +0002d2d0: 6f64 6520 6973 2073 746f 7265 6420 696e ode is stored in │ │ │ │ │ +0002d2e0: 2074 6865 2027 6c61 6e67 2720 7661 7269 the 'lang' vari │ │ │ │ │ +0002d2f0: 6162 6c65 2069 6e0a 2020 2020 2047 5255 able in. GRU │ │ │ │ │ +0002d300: 4227 7320 656e 7669 726f 6e6d 656e 7420 B's environment │ │ │ │ │ +0002d310: 282a 6e6f 7465 206c 616e 673a 3a29 2e20 (*note lang::). │ │ │ │ │ +0002d320: 2054 7261 6e73 6c61 7469 6f6e 2066 696c Translation fil │ │ │ │ │ +0002d330: 6573 2069 6e20 4d4f 2066 6f72 6d61 740a es in MO format. │ │ │ │ │ +0002d340: 2020 2020 2061 7265 2072 6561 6420 6672 are read fr │ │ │ │ │ +0002d350: 6f6d 2027 6c6f 6361 6c65 5f64 6972 2720 om 'locale_dir' │ │ │ │ │ +0002d360: 282a 6e6f 7465 206c 6f63 616c 655f 6469 (*note locale_di │ │ │ │ │ +0002d370: 723a 3a29 2c20 7573 7561 6c6c 790a 2020 r::), usually. │ │ │ │ │ +0002d380: 2020 2027 2f62 6f6f 742f 6772 7562 2f6c '/boot/grub/l │ │ │ │ │ +0002d390: 6f63 616c 6527 2e0a 0a1f 0a46 696c 653a ocale'.....File: │ │ │ │ │ +0002d3a0: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ +0002d3b0: 653a 2067 7074 7379 6e63 2c20 204e 6578 e: gptsync, Nex │ │ │ │ │ +0002d3c0: 743a 2068 616c 742c 2020 5072 6576 3a20 t: halt, Prev: │ │ │ │ │ +0002d3d0: 6765 7474 6578 742c 2020 5570 3a20 436f gettext, Up: Co │ │ │ │ │ +0002d3e0: 6d6d 616e 642d 6c69 6e65 2061 6e64 206d mmand-line and m │ │ │ │ │ +0002d3f0: 656e 7520 656e 7472 7920 636f 6d6d 616e enu entry comman │ │ │ │ │ +0002d400: 6473 0a0a 3136 2e33 2e33 3020 6770 7473 ds..16.3.30 gpts │ │ │ │ │ +0002d410: 796e 630a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ync.------------ │ │ │ │ │ +0002d420: 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 ---.. -- Command │ │ │ │ │ +0002d430: 3a20 6770 7473 796e 6320 6465 7669 6365 : gptsync device │ │ │ │ │ +0002d440: 205b 7061 7274 6974 696f 6e5b 2b2f 2d5b [partition[+/-[ │ │ │ │ │ +0002d450: 7479 7065 5d5d 5d20 2e2e 2e0a 2020 2020 type]]] .... │ │ │ │ │ +0002d460: 2044 6973 6b73 2075 7369 6e67 2074 6865 Disks using the │ │ │ │ │ +0002d470: 2047 5549 4420 5061 7274 6974 696f 6e20 GUID Partition │ │ │ │ │ +0002d480: 5461 626c 6520 2847 5054 2920 616c 736f Table (GPT) also │ │ │ │ │ +0002d490: 2068 6176 6520 6120 6c65 6761 6379 0a20 have a legacy. │ │ │ │ │ +0002d4a0: 2020 2020 4d61 7374 6572 2042 6f6f 7420 Master Boot │ │ │ │ │ +0002d4b0: 5265 636f 7264 2028 4d42 5229 2070 6172 Record (MBR) par │ │ │ │ │ +0002d4c0: 7469 7469 6f6e 2074 6162 6c65 2066 6f72 tition table for │ │ │ │ │ +0002d4d0: 2063 6f6d 7061 7469 6269 6c69 7479 2077 compatibility w │ │ │ │ │ +0002d4e0: 6974 6820 7468 650a 2020 2020 2042 494f ith the. BIO │ │ │ │ │ +0002d4f0: 5320 616e 6420 7769 7468 206f 6c64 6572 S and with older │ │ │ │ │ +0002d500: 206f 7065 7261 7469 6e67 2073 7973 7465 operating syste │ │ │ │ │ +0002d510: 6d73 2e20 2054 6865 206c 6567 6163 7920 ms. The legacy │ │ │ │ │ +0002d520: 4d42 5220 6361 6e20 6f6e 6c79 0a20 2020 MBR can only. │ │ │ │ │ +0002d530: 2020 7265 7072 6573 656e 7420 6120 6c69 represent a li │ │ │ │ │ +0002d540: 6d69 7465 6420 7375 6273 6574 206f 6620 mited subset of │ │ │ │ │ +0002d550: 4750 5420 7061 7274 6974 696f 6e20 656e GPT partition en │ │ │ │ │ +0002d560: 7472 6965 732e 0a0a 2020 2020 2054 6869 tries... Thi │ │ │ │ │ +0002d570: 7320 636f 6d6d 616e 6420 706f 7075 6c61 s command popula │ │ │ │ │ +0002d580: 7465 7320 7468 6520 6c65 6761 6379 204d tes the legacy M │ │ │ │ │ +0002d590: 4252 2077 6974 6820 7468 6520 7370 6563 BR with the spec │ │ │ │ │ +0002d5a0: 6966 6965 6420 5041 5254 4954 494f 4e0a ified PARTITION. │ │ │ │ │ +0002d5b0: 2020 2020 2065 6e74 7269 6573 206f 6e20 entries on │ │ │ │ │ +0002d5c0: 4445 5649 4345 2e20 2055 7020 746f 2074 DEVICE. Up to t │ │ │ │ │ +0002d5d0: 6872 6565 2070 6172 7469 7469 6f6e 7320 hree partitions │ │ │ │ │ +0002d5e0: 6d61 7920 6265 2075 7365 642e 0a0a 2020 may be used... │ │ │ │ │ +0002d5f0: 2020 2054 5950 4520 6973 2061 6e20 4d42 TYPE is an MB │ │ │ │ │ +0002d600: 5220 7061 7274 6974 696f 6e20 7479 7065 R partition type │ │ │ │ │ +0002d610: 2063 6f64 653b 2070 7265 6669 7820 7769 code; prefix wi │ │ │ │ │ +0002d620: 7468 2027 3078 2720 6966 2079 6f75 2077 th '0x' if you w │ │ │ │ │ +0002d630: 616e 7420 746f 0a20 2020 2020 656e 7465 ant to. ente │ │ │ │ │ +0002d640: 7220 7468 6973 2069 6e20 6865 7861 6465 r this in hexade │ │ │ │ │ +0002d650: 6369 6d61 6c2e 2020 5468 6520 7365 7061 cimal. The sepa │ │ │ │ │ +0002d660: 7261 746f 7220 6265 7477 6565 6e20 5041 rator between PA │ │ │ │ │ +0002d670: 5254 4954 494f 4e20 616e 640a 2020 2020 RTITION and. │ │ │ │ │ +0002d680: 2054 5950 4520 6d61 7920 6265 2027 2b27 TYPE may be '+' │ │ │ │ │ +0002d690: 2074 6f20 6d61 6b65 2074 6865 2070 6172 to make the par │ │ │ │ │ +0002d6a0: 7469 7469 6f6e 2061 6374 6976 652c 206f tition active, o │ │ │ │ │ +0002d6b0: 7220 272d 2720 746f 206d 616b 6520 6974 r '-' to make it │ │ │ │ │ +0002d6c0: 0a20 2020 2020 696e 6163 7469 7665 3b20 . inactive; │ │ │ │ │ +0002d6d0: 6f6e 6c79 206f 6e65 2070 6172 7469 7469 only one partiti │ │ │ │ │ +0002d6e0: 6f6e 206d 6179 2062 6520 6163 7469 7665 on may be active │ │ │ │ │ +0002d6f0: 2e20 2049 6620 626f 7468 2074 6865 2073 . If both the s │ │ │ │ │ +0002d700: 6570 6172 6174 6f72 0a20 2020 2020 616e eparator. an │ │ │ │ │ +0002d710: 6420 7479 7065 2061 7265 206f 6d69 7474 d type are omitt │ │ │ │ │ +0002d720: 6564 2c20 7468 656e 2074 6865 2070 6172 ed, then the par │ │ │ │ │ +0002d730: 7469 7469 6f6e 2077 696c 6c20 6265 2069 tition will be i │ │ │ │ │ +0002d740: 6e61 6374 6976 652e 0a0a 1f0a 4669 6c65 nactive.....File │ │ │ │ │ +0002d750: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ +0002d760: 6465 3a20 6861 6c74 2c20 204e 6578 743a de: halt, Next: │ │ │ │ │ +0002d770: 2068 6173 6873 756d 2c20 2050 7265 763a hashsum, Prev: │ │ │ │ │ +0002d780: 2067 7074 7379 6e63 2c20 2055 703a 2043 gptsync, Up: C │ │ │ │ │ +0002d790: 6f6d 6d61 6e64 2d6c 696e 6520 616e 6420 ommand-line and │ │ │ │ │ +0002d7a0: 6d65 6e75 2065 6e74 7279 2063 6f6d 6d61 menu entry comma │ │ │ │ │ +0002d7b0: 6e64 730a 0a31 362e 332e 3331 2068 616c nds..16.3.31 hal │ │ │ │ │ +0002d7c0: 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a t.------------.. │ │ │ │ │ +0002d7d0: 202d 2d20 436f 6d6d 616e 643a 2068 616c -- Command: hal │ │ │ │ │ +0002d7e0: 7420 2d2d 6e6f 2d61 706d 0a20 2020 2020 t --no-apm. │ │ │ │ │ +0002d7f0: 5468 6520 636f 6d6d 616e 6420 6861 6c74 The command halt │ │ │ │ │ +0002d800: 7320 7468 6520 636f 6d70 7574 6572 2e20 s the computer. │ │ │ │ │ +0002d810: 2049 6620 7468 6520 272d 2d6e 6f2d 6170 If the '--no-ap │ │ │ │ │ +0002d820: 6d27 206f 7074 696f 6e20 6973 0a20 2020 m' option is. │ │ │ │ │ +0002d830: 2020 7370 6563 6966 6965 642c 206e 6f20 specified, no │ │ │ │ │ +0002d840: 4150 4d20 4249 4f53 2063 616c 6c20 6973 APM BIOS call is │ │ │ │ │ +0002d850: 2070 6572 666f 726d 6564 2e20 204f 7468 performed. Oth │ │ │ │ │ +0002d860: 6572 7769 7365 2c20 7468 6520 636f 6d70 erwise, the comp │ │ │ │ │ +0002d870: 7574 6572 0a20 2020 2020 6973 2073 6875 uter. is shu │ │ │ │ │ +0002d880: 7420 646f 776e 2075 7369 6e67 2041 504d t down using APM │ │ │ │ │ +0002d890: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ +0002d8a0: 696e 666f 2c20 204e 6f64 653a 2068 6173 info, Node: has │ │ │ │ │ +0002d8b0: 6873 756d 2c20 204e 6578 743a 2068 656c hsum, Next: hel │ │ │ │ │ +0002d8c0: 702c 2020 5072 6576 3a20 6861 6c74 2c20 p, Prev: halt, │ │ │ │ │ +0002d8d0: 2055 703a 2043 6f6d 6d61 6e64 2d6c 696e Up: Command-lin │ │ │ │ │ +0002d8e0: 6520 616e 6420 6d65 6e75 2065 6e74 7279 e and menu entry │ │ │ │ │ +0002d8f0: 2063 6f6d 6d61 6e64 730a 0a31 362e 332e commands..16.3. │ │ │ │ │ +0002d900: 3332 2068 6173 6873 756d 0a2d 2d2d 2d2d 32 hashsum.----- │ │ │ │ │ +0002d910: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 ----------.. -- │ │ │ │ │ +0002d920: 436f 6d6d 616e 643a 2068 6173 6873 756d Command: hashsum │ │ │ │ │ +0002d930: 202d 2d68 6173 6820 6861 7368 202d 2d6b --hash hash --k │ │ │ │ │ +0002d940: 6565 702d 676f 696e 6720 2d2d 756e 636f eep-going --unco │ │ │ │ │ +0002d950: 6d70 7265 7373 202d 2d63 6865 636b 2066 mpress --check f │ │ │ │ │ +0002d960: 696c 650a 2020 2020 2020 2020 2020 5b2d ile. [- │ │ │ │ │ +0002d970: 2d70 7265 6669 7820 6469 725d 7c66 696c -prefix dir]|fil │ │ │ │ │ +0002d980: 6520 2e2e 2e0a 2020 2020 2043 6f6d 7075 e .... Compu │ │ │ │ │ +0002d990: 7465 206f 7220 7665 7269 6679 2066 696c te or verify fil │ │ │ │ │ +0002d9a0: 6520 6861 7368 6573 2e20 2048 6173 6820 e hashes. Hash │ │ │ │ │ +0002d9b0: 7479 7065 2069 7320 7365 6c65 6374 6564 type is selected │ │ │ │ │ +0002d9c0: 2077 6974 6820 6f70 7469 6f6e 0a20 2020 with option. │ │ │ │ │ +0002d9d0: 2020 272d 2d68 6173 6827 2e20 2053 7570 '--hash'. Sup │ │ │ │ │ +0002d9e0: 706f 7274 6564 2068 6173 6865 7320 6172 ported hashes ar │ │ │ │ │ +0002d9f0: 653a 2027 6164 6c65 7233 3227 2c20 2763 e: 'adler32', 'c │ │ │ │ │ +0002da00: 7263 3634 272c 2027 6372 6333 3227 2c0a rc64', 'crc32',. │ │ │ │ │ +0002da10: 2020 2020 2027 6372 6333 3272 6663 3135 'crc32rfc15 │ │ │ │ │ +0002da20: 3130 272c 2027 6372 6332 3472 6663 3234 10', 'crc24rfc24 │ │ │ │ │ +0002da30: 3430 272c 2027 6d64 3427 2c20 276d 6435 40', 'md4', 'md5 │ │ │ │ │ +0002da40: 272c 2027 7269 7065 6d64 3136 3027 2c20 ', 'ripemd160', │ │ │ │ │ +0002da50: 2773 6861 3127 2c0a 2020 2020 2027 7368 'sha1',. 'sh │ │ │ │ │ +0002da60: 6132 3234 272c 2027 7368 6132 3536 272c a224', 'sha256', │ │ │ │ │ +0002da70: 2027 7368 6135 3132 272c 2027 7368 6133 'sha512', 'sha3 │ │ │ │ │ +0002da80: 3834 272c 2027 7469 6765 7231 3932 272c 84', 'tiger192', │ │ │ │ │ +0002da90: 2027 7469 6765 7227 2c0a 2020 2020 2027 'tiger',. ' │ │ │ │ │ +0002daa0: 7469 6765 7232 272c 2027 7768 6972 6c70 tiger2', 'whirlp │ │ │ │ │ +0002dab0: 6f6f 6c27 2e20 204f 7074 696f 6e20 272d ool'. Option '- │ │ │ │ │ +0002dac0: 2d75 6e63 6f6d 7072 6573 7327 2075 6e63 -uncompress' unc │ │ │ │ │ +0002dad0: 6f6d 7072 6573 7365 7320 6669 6c65 730a ompresses files. │ │ │ │ │ +0002dae0: 2020 2020 2062 6566 6f72 6520 636f 6d70 before comp │ │ │ │ │ +0002daf0: 7574 696e 6720 6861 7368 2e0a 0a20 2020 uting hash... │ │ │ │ │ +0002db00: 2020 5768 656e 206c 6973 7420 6f66 2066 When list of f │ │ │ │ │ +0002db10: 696c 6573 2069 7320 6769 7665 6e2c 2068 iles is given, h │ │ │ │ │ +0002db20: 6173 6820 6f66 2065 6163 6820 6669 6c65 ash of each file │ │ │ │ │ +0002db30: 2069 7320 636f 6d70 7574 6564 2061 6e64 is computed and │ │ │ │ │ +0002db40: 0a20 2020 2020 7072 696e 7465 642c 2066 . printed, f │ │ │ │ │ +0002db50: 6f6c 6c6f 7765 6420 6279 2066 696c 6520 ollowed by file │ │ │ │ │ +0002db60: 6e61 6d65 2c20 6561 6368 2066 696c 6520 name, each file │ │ │ │ │ +0002db70: 6f6e 2061 206e 6577 206c 696e 652e 0a0a on a new line... │ │ │ │ │ +0002db80: 2020 2020 2057 6865 6e20 6f70 7469 6f6e When option │ │ │ │ │ +0002db90: 2027 2d2d 6368 6563 6b27 2069 7320 6769 '--check' is gi │ │ │ │ │ +0002dba0: 7665 6e2c 2069 7420 706f 696e 7473 2074 ven, it points t │ │ │ │ │ +0002dbb0: 6f20 6120 6669 6c65 2074 6861 7420 636f o a file that co │ │ │ │ │ +0002dbc0: 6e74 6169 6e73 0a20 2020 2020 6c69 7374 ntains. list │ │ │ │ │ +0002dbd0: 206f 6620 4841 5348 204e 414d 4520 7061 of HASH NAME pa │ │ │ │ │ +0002dbe0: 6972 7320 696e 2074 6865 2073 616d 6520 irs in the same │ │ │ │ │ +0002dbf0: 666f 726d 6174 2061 7320 7573 6564 2062 format as used b │ │ │ │ │ +0002dc00: 7920 554e 4958 2027 6d64 3573 756d 270a y UNIX 'md5sum'. │ │ │ │ │ +0002dc10: 2020 2020 2063 6f6d 6d61 6e64 2e20 204f command. O │ │ │ │ │ +0002dc20: 7074 696f 6e20 272d 2d70 7265 6669 7827 ption '--prefix' │ │ │ │ │ +0002dc30: 206d 6179 2062 6520 7573 6564 2074 6f20 may be used to │ │ │ │ │ +0002dc40: 6769 7665 2064 6972 6563 746f 7279 2077 give directory w │ │ │ │ │ +0002dc50: 6865 7265 0a20 2020 2020 6669 6c65 7320 here. files │ │ │ │ │ +0002dc60: 6172 6520 6c6f 6361 7465 642e 2020 4861 are located. Ha │ │ │ │ │ +0002dc70: 7368 2076 6572 6966 6963 6174 696f 6e20 sh verification │ │ │ │ │ +0002dc80: 7374 6f70 7320 6166 7465 7220 7468 6520 stops after the │ │ │ │ │ +0002dc90: 6669 7273 740a 2020 2020 206d 6973 6d61 first. misma │ │ │ │ │ +0002dca0: 7463 6820 7761 7320 666f 756e 6420 756e tch was found un │ │ │ │ │ +0002dcb0: 6c65 7373 206f 7074 696f 6e20 272d 2d6b less option '--k │ │ │ │ │ +0002dcc0: 6565 702d 676f 696e 6727 2077 6173 2067 eep-going' was g │ │ │ │ │ +0002dcd0: 6976 656e 2e20 2054 6865 0a20 2020 2020 iven. The. │ │ │ │ │ +0002dce0: 6578 6974 2063 6f64 6520 2724 3f27 2069 exit code '$?' i │ │ │ │ │ +0002dcf0: 7320 7365 7420 746f 2030 2069 6620 6861 s set to 0 if ha │ │ │ │ │ +0002dd00: 7368 2076 6572 6966 6963 6174 696f 6e20 sh verification │ │ │ │ │ +0002dd10: 6973 2073 7563 6365 7373 6675 6c2e 2020 is successful. │ │ │ │ │ +0002dd20: 4966 0a20 2020 2020 6974 2066 6169 6c73 If. it fails │ │ │ │ │ +0002dd30: 2c20 2724 3f27 2069 7320 7365 7420 746f , '$?' is set to │ │ │ │ │ +0002dd40: 2061 206e 6f6e 7a65 726f 2076 616c 7565 a nonzero value │ │ │ │ │ +0002dd50: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ +0002dd60: 696e 666f 2c20 204e 6f64 653a 2068 656c info, Node: hel │ │ │ │ │ +0002dd70: 702c 2020 4e65 7874 3a20 696e 6974 7264 p, Next: initrd │ │ │ │ │ +0002dd80: 2c20 2050 7265 763a 2068 6173 6873 756d , Prev: hashsum │ │ │ │ │ +0002dd90: 2c20 2055 703a 2043 6f6d 6d61 6e64 2d6c , Up: Command-l │ │ │ │ │ +0002dda0: 696e 6520 616e 6420 6d65 6e75 2065 6e74 ine and menu ent │ │ │ │ │ +0002ddb0: 7279 2063 6f6d 6d61 6e64 730a 0a31 362e ry commands..16. │ │ │ │ │ +0002ddc0: 332e 3333 2068 656c 700a 2d2d 2d2d 2d2d 3.33 help.------ │ │ │ │ │ +0002ddd0: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ │ +0002dde0: 616e 643a 2068 656c 7020 5b70 6174 7465 and: help [patte │ │ │ │ │ +0002ddf0: 726e 202e 2e2e 5d0a 2020 2020 2044 6973 rn ...]. Dis │ │ │ │ │ +0002de00: 706c 6179 2068 656c 7066 756c 2069 6e66 play helpful inf │ │ │ │ │ +0002de10: 6f72 6d61 7469 6f6e 2061 626f 7574 2062 ormation about b │ │ │ │ │ +0002de20: 7569 6c74 696e 2063 6f6d 6d61 6e64 732e uiltin commands. │ │ │ │ │ +0002de30: 2020 4966 2079 6f75 2064 6f20 6e6f 740a If you do not. │ │ │ │ │ +0002de40: 2020 2020 2073 7065 6369 6679 2050 4154 specify PAT │ │ │ │ │ +0002de50: 5445 524e 2c20 7468 6973 2063 6f6d 6d61 TERN, this comma │ │ │ │ │ +0002de60: 6e64 2073 686f 7773 2073 686f 7274 2064 nd shows short d │ │ │ │ │ +0002de70: 6573 6372 6970 7469 6f6e 7320 6f66 2061 escriptions of a │ │ │ │ │ +0002de80: 6c6c 0a20 2020 2020 6176 6169 6c61 626c ll. availabl │ │ │ │ │ +0002de90: 6520 636f 6d6d 616e 6473 2e0a 0a20 2020 e commands... │ │ │ │ │ +0002dea0: 2020 4966 2079 6f75 2073 7065 6369 6679 If you specify │ │ │ │ │ +0002deb0: 2061 6e79 2050 4154 5445 524e 532c 2069 any PATTERNS, i │ │ │ │ │ +0002dec0: 7420 6469 7370 6c61 7973 206c 6f6e 6765 t displays longe │ │ │ │ │ +0002ded0: 7220 696e 666f 726d 6174 696f 6e20 6162 r information ab │ │ │ │ │ +0002dee0: 6f75 740a 2020 2020 2065 6163 6820 6f66 out. each of │ │ │ │ │ +0002def0: 2074 6865 2063 6f6d 6d61 6e64 7320 7768 the commands wh │ │ │ │ │ +0002df00: 6f73 6520 6e61 6d65 7320 6265 6769 6e20 ose names begin │ │ │ │ │ +0002df10: 7769 7468 2074 686f 7365 2050 4154 5445 with those PATTE │ │ │ │ │ +0002df20: 524e 532e 0a0a 1f0a 4669 6c65 3a20 6772 RNS.....File: gr │ │ │ │ │ +0002df30: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ +0002df40: 696e 6974 7264 2c20 204e 6578 743a 2069 initrd, Next: i │ │ │ │ │ +0002df50: 6e69 7472 6431 362c 2020 5072 6576 3a20 nitrd16, Prev: │ │ │ │ │ +0002df60: 6865 6c70 2c20 2055 703a 2043 6f6d 6d61 help, Up: Comma │ │ │ │ │ +0002df70: 6e64 2d6c 696e 6520 616e 6420 6d65 6e75 nd-line and menu │ │ │ │ │ +0002df80: 2065 6e74 7279 2063 6f6d 6d61 6e64 730a entry commands. │ │ │ │ │ +0002df90: 0a31 362e 332e 3334 2069 6e69 7472 640a .16.3.34 initrd. │ │ │ │ │ +0002dfa0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ +0002dfb0: 202d 2d20 436f 6d6d 616e 643a 2069 6e69 -- Command: ini │ │ │ │ │ +0002dfc0: 7472 6420 6669 6c65 205b 6669 6c65 202e trd file [file . │ │ │ │ │ +0002dfd0: 2e2e 5d0a 2020 2020 204c 6f61 642c 2069 ..]. Load, i │ │ │ │ │ +0002dfe0: 6e20 6f72 6465 722c 2061 6c6c 2069 6e69 n order, all ini │ │ │ │ │ +0002dff0: 7469 616c 2072 616d 6469 736b 7320 666f tial ramdisks fo │ │ │ │ │ +0002e000: 7220 6120 4c69 6e75 7820 6b65 726e 656c r a Linux kernel │ │ │ │ │ +0002e010: 2069 6d61 6765 2c20 616e 640a 2020 2020 image, and. │ │ │ │ │ +0002e020: 2073 6574 2074 6865 2061 7070 726f 7072 set the appropr │ │ │ │ │ +0002e030: 6961 7465 2070 6172 616d 6574 6572 7320 iate parameters │ │ │ │ │ +0002e040: 696e 2074 6865 204c 696e 7578 2073 6574 in the Linux set │ │ │ │ │ +0002e050: 7570 2061 7265 6120 696e 206d 656d 6f72 up area in memor │ │ │ │ │ +0002e060: 792e 0a20 2020 2020 5468 6973 206d 6179 y.. This may │ │ │ │ │ +0002e070: 206f 6e6c 7920 6265 2075 7365 6420 6166 only be used af │ │ │ │ │ +0002e080: 7465 7220 7468 6520 276c 696e 7578 2720 ter the 'linux' │ │ │ │ │ +0002e090: 636f 6d6d 616e 6420 282a 6e6f 7465 206c command (*note l │ │ │ │ │ +0002e0a0: 696e 7578 3a3a 2920 6861 730a 2020 2020 inux::) has. │ │ │ │ │ +0002e0b0: 2062 6565 6e20 7275 6e2e 2020 5365 6520 been run. See │ │ │ │ │ +0002e0c0: 616c 736f 202a 6e6f 7465 2047 4e55 2f4c also *note GNU/L │ │ │ │ │ +0002e0d0: 696e 7578 3a3a 2e0a 0a1f 0a46 696c 653a inux::.....File: │ │ │ │ │ +0002e0e0: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ +0002e0f0: 653a 2069 6e69 7472 6431 362c 2020 4e65 e: initrd16, Ne │ │ │ │ │ +0002e100: 7874 3a20 696e 736d 6f64 2c20 2050 7265 xt: insmod, Pre │ │ │ │ │ +0002e110: 763a 2069 6e69 7472 642c 2020 5570 3a20 v: initrd, Up: │ │ │ │ │ +0002e120: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ +0002e130: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ │ +0002e140: 616e 6473 0a0a 3136 2e33 2e33 3520 696e ands..16.3.35 in │ │ │ │ │ +0002e150: 6974 7264 3136 0a2d 2d2d 2d2d 2d2d 2d2d itrd16.--------- │ │ │ │ │ +0002e160: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d -------.. -- Com │ │ │ │ │ +0002e170: 6d61 6e64 3a20 696e 6974 7264 3136 2066 mand: initrd16 f │ │ │ │ │ +0002e180: 696c 6520 5b66 696c 6520 2e2e 2e5d 0a20 ile [file ...]. │ │ │ │ │ +0002e190: 2020 2020 4c6f 6164 2c20 696e 206f 7264 Load, in ord │ │ │ │ │ +0002e1a0: 6572 2c20 616c 6c20 696e 6974 6961 6c20 er, all initial │ │ │ │ │ +0002e1b0: 7261 6d64 6973 6b73 2066 6f72 2061 204c ramdisks for a L │ │ │ │ │ +0002e1c0: 696e 7578 206b 6572 6e65 6c20 696d 6167 inux kernel imag │ │ │ │ │ +0002e1d0: 6520 746f 2062 650a 2020 2020 2062 6f6f e to be. boo │ │ │ │ │ +0002e1e0: 7465 6420 696e 2031 362d 6269 7420 6d6f ted in 16-bit mo │ │ │ │ │ +0002e1f0: 6465 2c20 616e 6420 7365 7420 7468 6520 de, and set the │ │ │ │ │ +0002e200: 6170 7072 6f70 7269 6174 6520 7061 7261 appropriate para │ │ │ │ │ +0002e210: 6d65 7465 7273 2069 6e20 7468 650a 2020 meters in the. │ │ │ │ │ +0002e220: 2020 204c 696e 7578 2073 6574 7570 2061 Linux setup a │ │ │ │ │ +0002e230: 7265 6120 696e 206d 656d 6f72 792e 2020 rea in memory. │ │ │ │ │ +0002e240: 5468 6973 206d 6179 206f 6e6c 7920 6265 This may only be │ │ │ │ │ +0002e250: 2075 7365 6420 6166 7465 7220 7468 650a used after the. │ │ │ │ │ +0002e260: 2020 2020 2027 6c69 6e75 7831 3627 2063 'linux16' c │ │ │ │ │ +0002e270: 6f6d 6d61 6e64 2028 2a6e 6f74 6520 6c69 ommand (*note li │ │ │ │ │ +0002e280: 6e75 7831 363a 3a29 2068 6173 2062 6565 nux16::) has bee │ │ │ │ │ +0002e290: 6e20 7275 6e2e 2020 5365 6520 616c 736f n run. See also │ │ │ │ │ +0002e2a0: 202a 6e6f 7465 0a20 2020 2020 474e 552f *note. GNU/ │ │ │ │ │ +0002e2b0: 4c69 6e75 783a 3a2e 0a0a 2020 2020 2054 Linux::... T │ │ │ │ │ +0002e2c0: 6869 7320 636f 6d6d 616e 6420 6973 206f his command is o │ │ │ │ │ +0002e2d0: 6e6c 7920 6176 6169 6c61 626c 6520 6f6e nly available on │ │ │ │ │ +0002e2e0: 2078 3836 2073 7973 7465 6d73 2e0a 0a1f x86 systems.... │ │ │ │ │ +0002e2f0: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ +0002e300: 2c20 204e 6f64 653a 2069 6e73 6d6f 642c , Node: insmod, │ │ │ │ │ +0002e310: 2020 4e65 7874 3a20 6b65 7973 7461 7475 Next: keystatu │ │ │ │ │ +0002e320: 732c 2020 5072 6576 3a20 696e 6974 7264 s, Prev: initrd │ │ │ │ │ +0002e330: 3136 2c20 2055 703a 2043 6f6d 6d61 6e64 16, Up: Command │ │ │ │ │ +0002e340: 2d6c 696e 6520 616e 6420 6d65 6e75 2065 -line and menu e │ │ │ │ │ +0002e350: 6e74 7279 2063 6f6d 6d61 6e64 730a 0a31 ntry commands..1 │ │ │ │ │ +0002e360: 362e 332e 3336 2069 6e73 6d6f 640a 2d2d 6.3.36 insmod.-- │ │ │ │ │ +0002e370: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d ------------.. - │ │ │ │ │ +0002e380: 2d20 436f 6d6d 616e 643a 2069 6e73 6d6f - Command: insmo │ │ │ │ │ +0002e390: 6420 6d6f 6475 6c65 0a20 2020 2020 496e d module. In │ │ │ │ │ +0002e3a0: 7365 7274 2074 6865 2064 796e 616d 6963 sert the dynamic │ │ │ │ │ +0002e3b0: 2047 5255 4220 6d6f 6475 6c65 2063 616c GRUB module cal │ │ │ │ │ +0002e3c0: 6c65 6420 4d4f 4455 4c45 2e0a 0a1f 0a46 led MODULE.....F │ │ │ │ │ +0002e3d0: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ +0002e3e0: 204e 6f64 653a 206b 6579 7374 6174 7573 Node: keystatus │ │ │ │ │ +0002e3f0: 2c20 204e 6578 743a 206c 696e 7578 2c20 , Next: linux, │ │ │ │ │ +0002e400: 2050 7265 763a 2069 6e73 6d6f 642c 2020 Prev: insmod, │ │ │ │ │ +0002e410: 5570 3a20 436f 6d6d 616e 642d 6c69 6e65 Up: Command-line │ │ │ │ │ +0002e420: 2061 6e64 206d 656e 7520 656e 7472 7920 and menu entry │ │ │ │ │ +0002e430: 636f 6d6d 616e 6473 0a0a 3136 2e33 2e33 commands..16.3.3 │ │ │ │ │ +0002e440: 3720 6b65 7973 7461 7475 730a 2d2d 2d2d 7 keystatus.---- │ │ │ │ │ +0002e450: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 -------------.. │ │ │ │ │ +0002e460: 2d2d 2043 6f6d 6d61 6e64 3a20 6b65 7973 -- Command: keys │ │ │ │ │ +0002e470: 7461 7475 7320 5b2d 2d73 6869 6674 5d20 tatus [--shift] │ │ │ │ │ +0002e480: 5b2d 2d63 7472 6c5d 205b 2d2d 616c 745d [--ctrl] [--alt] │ │ │ │ │ +0002e490: 0a20 2020 2020 5265 7475 726e 2074 7275 . Return tru │ │ │ │ │ +0002e4a0: 6520 6966 2074 6865 2053 6869 6674 2c20 e if the Shift, │ │ │ │ │ +0002e4b0: 436f 6e74 726f 6c2c 206f 7220 416c 7420 Control, or Alt │ │ │ │ │ +0002e4c0: 6d6f 6469 6669 6572 206b 6579 7320 6172 modifier keys ar │ │ │ │ │ +0002e4d0: 6520 6865 6c64 0a20 2020 2020 646f 776e e held. down │ │ │ │ │ +0002e4e0: 2c20 6173 2072 6571 7565 7374 6564 2062 , as requested b │ │ │ │ │ +0002e4f0: 7920 6f70 7469 6f6e 732e 2020 5468 6973 y options. This │ │ │ │ │ +0002e500: 2069 7320 7573 6566 756c 2069 6e20 7363 is useful in sc │ │ │ │ │ +0002e510: 7269 7074 696e 672c 2074 6f0a 2020 2020 ripting, to. │ │ │ │ │ +0002e520: 2061 6c6c 6f77 2073 6f6d 6520 7573 6572 allow some user │ │ │ │ │ +0002e530: 2063 6f6e 7472 6f6c 206f 7665 7220 6265 control over be │ │ │ │ │ +0002e540: 6861 7669 6f75 7220 7769 7468 6f75 7420 haviour without │ │ │ │ │ +0002e550: 6861 7669 6e67 2074 6f20 7761 6974 2066 having to wait f │ │ │ │ │ +0002e560: 6f72 2061 0a20 2020 2020 6b65 7970 7265 or a. keypre │ │ │ │ │ +0002e570: 7373 2e0a 0a20 2020 2020 4368 6563 6b69 ss... Checki │ │ │ │ │ +0002e580: 6e67 206b 6579 206d 6f64 6966 6965 7220 ng key modifier │ │ │ │ │ +0002e590: 7374 6174 7573 2069 7320 6f6e 6c79 2073 status is only s │ │ │ │ │ +0002e5a0: 7570 706f 7274 6564 206f 6e20 736f 6d65 upported on some │ │ │ │ │ +0002e5b0: 2070 6c61 7466 6f72 6d73 2e0a 2020 2020 platforms.. │ │ │ │ │ +0002e5c0: 2049 6620 696e 766f 6b65 6420 7769 7468 If invoked with │ │ │ │ │ +0002e5d0: 6f75 7420 616e 7920 6f70 7469 6f6e 732c out any options, │ │ │ │ │ +0002e5e0: 2074 6865 2027 6b65 7973 7461 7475 7327 the 'keystatus' │ │ │ │ │ +0002e5f0: 2063 6f6d 6d61 6e64 2072 6574 7572 6e73 command returns │ │ │ │ │ +0002e600: 0a20 2020 2020 7472 7565 2069 6620 616e . true if an │ │ │ │ │ +0002e610: 6420 6f6e 6c79 2069 6620 6368 6563 6b69 d only if checki │ │ │ │ │ +0002e620: 6e67 206b 6579 206d 6f64 6966 6965 7220 ng key modifier │ │ │ │ │ +0002e630: 7374 6174 7573 2069 7320 7375 7070 6f72 status is suppor │ │ │ │ │ +0002e640: 7465 642e 0a0a 1f0a 4669 6c65 3a20 6772 ted.....File: gr │ │ │ │ │ +0002e650: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ +0002e660: 6c69 6e75 782c 2020 4e65 7874 3a20 6c69 linux, Next: li │ │ │ │ │ +0002e670: 6e75 7831 362c 2020 5072 6576 3a20 6b65 nux16, Prev: ke │ │ │ │ │ +0002e680: 7973 7461 7475 732c 2020 5570 3a20 436f ystatus, Up: Co │ │ │ │ │ +0002e690: 6d6d 616e 642d 6c69 6e65 2061 6e64 206d mmand-line and m │ │ │ │ │ +0002e6a0: 656e 7520 656e 7472 7920 636f 6d6d 616e enu entry comman │ │ │ │ │ +0002e6b0: 6473 0a0a 3136 2e33 2e33 3820 6c69 6e75 ds..16.3.38 linu │ │ │ │ │ +0002e6c0: 780a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a x.-------------. │ │ │ │ │ +0002e6d0: 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 6c69 . -- Command: li │ │ │ │ │ +0002e6e0: 6e75 7820 6669 6c65 202e 2e2e 0a20 2020 nux file .... │ │ │ │ │ +0002e6f0: 2020 4c6f 6164 2061 204c 696e 7578 206b Load a Linux k │ │ │ │ │ +0002e700: 6572 6e65 6c20 696d 6167 6520 6672 6f6d ernel image from │ │ │ │ │ +0002e710: 2046 494c 452e 2020 5468 6520 7265 7374 FILE. The rest │ │ │ │ │ +0002e720: 206f 6620 7468 6520 6c69 6e65 2069 730a of the line is. │ │ │ │ │ +0002e730: 2020 2020 2070 6173 7365 6420 7665 7262 passed verb │ │ │ │ │ +0002e740: 6174 696d 2061 7320 7468 6520 226b 6572 atim as the "ker │ │ │ │ │ +0002e750: 6e65 6c20 636f 6d6d 616e 642d 6c69 6e65 nel command-line │ │ │ │ │ +0002e760: 222e 2020 416e 7920 696e 6974 7264 206d ". Any initrd m │ │ │ │ │ +0002e770: 7573 7420 6265 0a20 2020 2020 7265 6c6f ust be. relo │ │ │ │ │ +0002e780: 6164 6564 2061 6674 6572 2075 7369 6e67 aded after using │ │ │ │ │ +0002e790: 2074 6869 7320 636f 6d6d 616e 6420 282a this command (* │ │ │ │ │ +0002e7a0: 6e6f 7465 2069 6e69 7472 643a 3a29 2e0a note initrd::).. │ │ │ │ │ +0002e7b0: 0a20 2020 2020 4f6e 2078 3836 2073 7973 . On x86 sys │ │ │ │ │ +0002e7c0: 7465 6d73 2c20 7468 6520 6b65 726e 656c tems, the kernel │ │ │ │ │ +0002e7d0: 2077 696c 6c20 6265 2062 6f6f 7465 6420 will be booted │ │ │ │ │ +0002e7e0: 7573 696e 6720 7468 6520 3332 2d62 6974 using the 32-bit │ │ │ │ │ +0002e7f0: 2062 6f6f 740a 2020 2020 2070 726f 746f boot. proto │ │ │ │ │ +0002e800: 636f 6c2e 2020 4e6f 7465 2074 6861 7420 col. Note that │ │ │ │ │ +0002e810: 7468 6973 206d 6561 6e73 2074 6861 7420 this means that │ │ │ │ │ +0002e820: 7468 6520 2776 6761 3d27 2062 6f6f 7420 the 'vga=' boot │ │ │ │ │ +0002e830: 6f70 7469 6f6e 2077 696c 6c0a 2020 2020 option will. │ │ │ │ │ +0002e840: 206e 6f74 2077 6f72 6b3b 2069 6620 796f not work; if yo │ │ │ │ │ +0002e850: 7520 7761 6e74 2074 6f20 7365 7420 6120 u want to set a │ │ │ │ │ +0002e860: 7370 6563 6961 6c20 7669 6465 6f20 6d6f special video mo │ │ │ │ │ +0002e870: 6465 2c20 796f 7520 7769 6c6c 206e 6565 de, you will nee │ │ │ │ │ +0002e880: 6420 746f 0a20 2020 2020 7573 6520 4752 d to. use GR │ │ │ │ │ +0002e890: 5542 2063 6f6d 6d61 6e64 7320 7375 6368 UB commands such │ │ │ │ │ +0002e8a0: 2061 7320 2773 6574 2067 6678 7061 796c as 'set gfxpayl │ │ │ │ │ +0002e8b0: 6f61 643d 3130 3234 7837 3638 2720 6f72 oad=1024x768' or │ │ │ │ │ +0002e8c0: 2027 7365 740a 2020 2020 2067 6678 7061 'set. gfxpa │ │ │ │ │ +0002e8d0: 796c 6f61 643d 6b65 6570 2720 2874 6f20 yload=keep' (to │ │ │ │ │ +0002e8e0: 6b65 6570 2074 6865 2073 616d 6520 6d6f keep the same mo │ │ │ │ │ +0002e8f0: 6465 2061 7320 7573 6564 2069 6e20 4752 de as used in GR │ │ │ │ │ +0002e900: 5542 2920 696e 7374 6561 642e 0a20 2020 UB) instead.. │ │ │ │ │ +0002e910: 2020 4752 5542 2063 616e 2061 7574 6f6d GRUB can autom │ │ │ │ │ +0002e920: 6174 6963 616c 6c79 2064 6574 6563 7420 atically detect │ │ │ │ │ +0002e930: 736f 6d65 2075 7365 7320 6f66 2027 7667 some uses of 'vg │ │ │ │ │ +0002e940: 613d 2720 616e 6420 7472 616e 736c 6174 a=' and translat │ │ │ │ │ +0002e950: 650a 2020 2020 2074 6865 6d20 746f 2061 e. them to a │ │ │ │ │ +0002e960: 7070 726f 7072 6961 7465 2073 6574 7469 ppropriate setti │ │ │ │ │ +0002e970: 6e67 7320 6f66 2027 6766 7870 6179 6c6f ngs of 'gfxpaylo │ │ │ │ │ +0002e980: 6164 272e 2020 5468 6520 276c 696e 7578 ad'. The 'linux │ │ │ │ │ +0002e990: 3136 270a 2020 2020 2063 6f6d 6d61 6e64 16'. command │ │ │ │ │ +0002e9a0: 2028 2a6e 6f74 6520 6c69 6e75 7831 363a (*note linux16: │ │ │ │ │ +0002e9b0: 3a29 2061 766f 6964 7320 7468 6973 2072 :) avoids this r │ │ │ │ │ +0002e9c0: 6573 7472 6963 7469 6f6e 2e0a 0a1f 0a46 estriction.....F │ │ │ │ │ +0002e9d0: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ +0002e9e0: 204e 6f64 653a 206c 696e 7578 3136 2c20 Node: linux16, │ │ │ │ │ +0002e9f0: 204e 6578 743a 206c 6973 745f 656e 762c Next: list_env, │ │ │ │ │ +0002ea00: 2020 5072 6576 3a20 6c69 6e75 782c 2020 Prev: linux, │ │ │ │ │ +0002ea10: 5570 3a20 436f 6d6d 616e 642d 6c69 6e65 Up: Command-line │ │ │ │ │ +0002ea20: 2061 6e64 206d 656e 7520 656e 7472 7920 and menu entry │ │ │ │ │ +0002ea30: 636f 6d6d 616e 6473 0a0a 3136 2e33 2e33 commands..16.3.3 │ │ │ │ │ +0002ea40: 3920 6c69 6e75 7831 360a 2d2d 2d2d 2d2d 9 linux16.------ │ │ │ │ │ +0002ea50: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 ---------.. -- C │ │ │ │ │ +0002ea60: 6f6d 6d61 6e64 3a20 6c69 6e75 7831 3620 ommand: linux16 │ │ │ │ │ +0002ea70: 6669 6c65 202e 2e2e 0a20 2020 2020 4c6f file .... Lo │ │ │ │ │ +0002ea80: 6164 2061 204c 696e 7578 206b 6572 6e65 ad a Linux kerne │ │ │ │ │ +0002ea90: 6c20 696d 6167 6520 6672 6f6d 2046 494c l image from FIL │ │ │ │ │ +0002eaa0: 4520 696e 2031 362d 6269 7420 6d6f 6465 E in 16-bit mode │ │ │ │ │ +0002eab0: 2e20 2054 6865 2072 6573 7420 6f66 0a20 . The rest of. │ │ │ │ │ +0002eac0: 2020 2020 7468 6520 6c69 6e65 2069 7320 the line is │ │ │ │ │ +0002ead0: 7061 7373 6564 2076 6572 6261 7469 6d20 passed verbatim │ │ │ │ │ +0002eae0: 6173 2074 6865 2022 6b65 726e 656c 2063 as the "kernel c │ │ │ │ │ +0002eaf0: 6f6d 6d61 6e64 2d6c 696e 6522 2e20 2041 ommand-line". A │ │ │ │ │ +0002eb00: 6e79 0a20 2020 2020 696e 6974 7264 206d ny. initrd m │ │ │ │ │ +0002eb10: 7573 7420 6265 2072 656c 6f61 6465 6420 ust be reloaded │ │ │ │ │ +0002eb20: 6166 7465 7220 7573 696e 6720 7468 6973 after using this │ │ │ │ │ +0002eb30: 2063 6f6d 6d61 6e64 2028 2a6e 6f74 650a command (*note. │ │ │ │ │ +0002eb40: 2020 2020 2069 6e69 7472 6431 363a 3a29 initrd16::) │ │ │ │ │ +0002eb50: 2e0a 0a20 2020 2020 5468 6520 6b65 726e ... The kern │ │ │ │ │ +0002eb60: 656c 2077 696c 6c20 6265 2062 6f6f 7465 el will be boote │ │ │ │ │ +0002eb70: 6420 7573 696e 6720 7468 6520 7472 6164 d using the trad │ │ │ │ │ +0002eb80: 6974 696f 6e61 6c20 3136 2d62 6974 2062 itional 16-bit b │ │ │ │ │ +0002eb90: 6f6f 740a 2020 2020 2070 726f 746f 636f oot. protoco │ │ │ │ │ +0002eba0: 6c2e 2020 4173 2077 656c 6c20 6173 2062 l. As well as b │ │ │ │ │ +0002ebb0: 7970 6173 7369 6e67 2070 726f 626c 656d ypassing problem │ │ │ │ │ +0002ebc0: 7320 7769 7468 2027 7667 613d 2720 6465 s with 'vga=' de │ │ │ │ │ +0002ebd0: 7363 7269 6265 6420 696e 0a20 2020 2020 scribed in. │ │ │ │ │ +0002ebe0: 2a6e 6f74 6520 6c69 6e75 783a 3a2c 2074 *note linux::, t │ │ │ │ │ +0002ebf0: 6869 7320 7065 726d 6974 7320 626f 6f74 his permits boot │ │ │ │ │ +0002ec00: 696e 6720 736f 6d65 206f 7468 6572 2070 ing some other p │ │ │ │ │ +0002ec10: 726f 6772 616d 7320 7468 6174 0a20 2020 rograms that. │ │ │ │ │ +0002ec20: 2020 696d 706c 656d 656e 7420 7468 6520 implement the │ │ │ │ │ +0002ec30: 4c69 6e75 7820 626f 6f74 2070 726f 746f Linux boot proto │ │ │ │ │ +0002ec40: 636f 6c20 666f 7220 7468 6520 7361 6b65 col for the sake │ │ │ │ │ +0002ec50: 206f 6620 636f 6e76 656e 6965 6e63 652e of convenience. │ │ │ │ │ +0002ec60: 0a0a 2020 2020 2054 6869 7320 636f 6d6d .. This comm │ │ │ │ │ +0002ec70: 616e 6420 6973 206f 6e6c 7920 6176 6169 and is only avai │ │ │ │ │ +0002ec80: 6c61 626c 6520 6f6e 2078 3836 2073 7973 lable on x86 sys │ │ │ │ │ +0002ec90: 7465 6d73 2e0a 0a1f 0a46 696c 653a 2067 tems.....File: g │ │ │ │ │ +0002eca0: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ +0002ecb0: 206c 6973 745f 656e 762c 2020 4e65 7874 list_env, Next │ │ │ │ │ +0002ecc0: 3a20 6c69 7374 5f74 7275 7374 6564 2c20 : list_trusted, │ │ │ │ │ +0002ecd0: 2050 7265 763a 206c 696e 7578 3136 2c20 Prev: linux16, │ │ │ │ │ +0002ece0: 2055 703a 2043 6f6d 6d61 6e64 2d6c 696e Up: Command-lin │ │ │ │ │ +0002ecf0: 6520 616e 6420 6d65 6e75 2065 6e74 7279 e and menu entry │ │ │ │ │ +0002ed00: 2063 6f6d 6d61 6e64 730a 0a31 362e 332e commands..16.3. │ │ │ │ │ +0002ed10: 3430 206c 6973 745f 656e 760a 2d2d 2d2d 40 list_env.---- │ │ │ │ │ +0002ed20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d ------------.. - │ │ │ │ │ +0002ed30: 2d20 436f 6d6d 616e 643a 206c 6973 745f - Command: list_ │ │ │ │ │ +0002ed40: 656e 7620 5b2d 2d66 696c 6520 6669 6c65 env [--file file │ │ │ │ │ +0002ed50: 5d0a 2020 2020 204c 6973 7420 616c 6c20 ]. List all │ │ │ │ │ +0002ed60: 7661 7269 6162 6c65 7320 696e 2074 6865 variables in the │ │ │ │ │ +0002ed70: 2065 6e76 6972 6f6e 6d65 6e74 2062 6c6f environment blo │ │ │ │ │ +0002ed80: 636b 2066 696c 652e 2020 2a4e 6f74 650a ck file. *Note. │ │ │ │ │ +0002ed90: 2020 2020 2045 6e76 6972 6f6e 6d65 6e74 Environment │ │ │ │ │ +0002eda0: 2062 6c6f 636b 3a3a 2e0a 0a20 2020 2020 block::... │ │ │ │ │ +0002edb0: 5468 6520 272d 2d66 696c 6527 206f 7074 The '--file' opt │ │ │ │ │ +0002edc0: 696f 6e20 6f76 6572 7269 6465 7320 7468 ion overrides th │ │ │ │ │ +0002edd0: 6520 6465 6661 756c 7420 6c6f 6361 7469 e default locati │ │ │ │ │ +0002ede0: 6f6e 206f 6620 7468 650a 2020 2020 2065 on of the. e │ │ │ │ │ +0002edf0: 6e76 6972 6f6e 6d65 6e74 2062 6c6f 636b nvironment block │ │ │ │ │ +0002ee00: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ +0002ee10: 696e 666f 2c20 204e 6f64 653a 206c 6973 info, Node: lis │ │ │ │ │ +0002ee20: 745f 7472 7573 7465 642c 2020 4e65 7874 t_trusted, Next │ │ │ │ │ +0002ee30: 3a20 6c6f 6164 5f65 6e76 2c20 2050 7265 : load_env, Pre │ │ │ │ │ +0002ee40: 763a 206c 6973 745f 656e 762c 2020 5570 v: list_env, Up │ │ │ │ │ +0002ee50: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ │ +0002ee60: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ │ +0002ee70: 6d6d 616e 6473 0a0a 3136 2e33 2e34 3120 mmands..16.3.41 │ │ │ │ │ +0002ee80: 6c69 7374 5f74 7275 7374 6564 0a2d 2d2d list_trusted.--- │ │ │ │ │ 0002ee90: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0002eea0: 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 ---.. -- Command │ │ │ │ │ -0002eeb0: 3a20 6c69 7374 5f74 7275 7374 6564 0a20 : list_trusted. │ │ │ │ │ -0002eec0: 2020 2020 4c69 7374 2061 6c6c 2070 7562 List all pub │ │ │ │ │ -0002eed0: 6c69 6320 6b65 7973 2074 7275 7374 6564 lic keys trusted │ │ │ │ │ -0002eee0: 2062 7920 4752 5542 2066 6f72 2076 616c by GRUB for val │ │ │ │ │ -0002eef0: 6964 6174 696e 6720 7369 676e 6174 7572 idating signatur │ │ │ │ │ -0002ef00: 6573 2e0a 2020 2020 2054 6865 206f 7574 es.. The out │ │ │ │ │ -0002ef10: 7075 7420 6973 2069 6e20 4750 4727 7320 put is in GPG's │ │ │ │ │ -0002ef20: 7634 206b 6579 2066 696e 6765 7270 7269 v4 key fingerpri │ │ │ │ │ -0002ef30: 6e74 2066 6f72 6d61 7420 2869 2e65 2e2c nt format (i.e., │ │ │ │ │ -0002ef40: 2074 6865 206f 7574 7075 740a 2020 2020 the output. │ │ │ │ │ -0002ef50: 206f 6620 2767 7067 202d 2d66 696e 6765 of 'gpg --finge │ │ │ │ │ -0002ef60: 7270 7269 6e74 2729 2e20 2054 6865 206c rprint'). The l │ │ │ │ │ -0002ef70: 6561 7374 2073 6967 6e69 6669 6361 6e74 east significant │ │ │ │ │ -0002ef80: 2066 6f75 7220 6279 7465 7320 286c 6173 four bytes (las │ │ │ │ │ -0002ef90: 740a 2020 2020 2065 6967 6874 2068 6578 t. eight hex │ │ │ │ │ -0002efa0: 6164 6563 696d 616c 2064 6967 6974 7329 adecimal digits) │ │ │ │ │ -0002efb0: 2063 616e 2062 6520 7573 6564 2061 7320 can be used as │ │ │ │ │ -0002efc0: 616e 2061 7267 756d 656e 7420 746f 2027 an argument to ' │ │ │ │ │ -0002efd0: 6469 7374 7275 7374 270a 2020 2020 2028 distrust'. ( │ │ │ │ │ -0002efe0: 2a6e 6f74 6520 6469 7374 7275 7374 3a3a *note distrust:: │ │ │ │ │ -0002eff0: 292e 2020 2a4e 6f74 6520 5573 696e 6720 ). *Note Using │ │ │ │ │ -0002f000: 6469 6769 7461 6c20 7369 676e 6174 7572 digital signatur │ │ │ │ │ -0002f010: 6573 3a3a 2c20 666f 7220 6d6f 7265 0a20 es::, for more. │ │ │ │ │ -0002f020: 2020 2020 696e 666f 726d 6174 696f 6e20 information │ │ │ │ │ -0002f030: 6162 6f75 7420 7573 6573 2066 6f72 2074 about uses for t │ │ │ │ │ -0002f040: 6865 7365 206b 6579 732e 0a0a 1f0a 4669 hese keys.....Fi │ │ │ │ │ -0002f050: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ -0002f060: 4e6f 6465 3a20 6c6f 6164 5f65 6e76 2c20 Node: load_env, │ │ │ │ │ -0002f070: 204e 6578 743a 206c 6f61 6466 6f6e 742c Next: loadfont, │ │ │ │ │ -0002f080: 2020 5072 6576 3a20 6c69 7374 5f74 7275 Prev: list_tru │ │ │ │ │ -0002f090: 7374 6564 2c20 2055 703a 2043 6f6d 6d61 sted, Up: Comma │ │ │ │ │ -0002f0a0: 6e64 2d6c 696e 6520 616e 6420 6d65 6e75 nd-line and menu │ │ │ │ │ -0002f0b0: 2065 6e74 7279 2063 6f6d 6d61 6e64 730a entry commands. │ │ │ │ │ -0002f0c0: 0a31 362e 332e 3432 206c 6f61 645f 656e .16.3.42 load_en │ │ │ │ │ -0002f0d0: 760a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d v.-------------- │ │ │ │ │ -0002f0e0: 2d2d 0a0a 202d 2d20 436f 6d6d 616e 643a --.. -- Command: │ │ │ │ │ -0002f0f0: 206c 6f61 645f 656e 7620 5b2d 2d66 696c load_env [--fil │ │ │ │ │ -0002f100: 6520 6669 6c65 5d20 5b2d 2d73 6b69 702d e file] [--skip- │ │ │ │ │ -0002f110: 7369 675d 0a20 2020 2020 2020 2020 205b sig]. [ │ │ │ │ │ -0002f120: 7768 6974 656c 6973 7465 645f 7661 7269 whitelisted_vari │ │ │ │ │ -0002f130: 6162 6c65 5f6e 616d 655d 202e 2e2e 0a20 able_name] .... │ │ │ │ │ -0002f140: 2020 2020 4c6f 6164 2061 6c6c 2076 6172 Load all var │ │ │ │ │ -0002f150: 6961 626c 6573 2066 726f 6d20 7468 6520 iables from the │ │ │ │ │ -0002f160: 656e 7669 726f 6e6d 656e 7420 626c 6f63 environment bloc │ │ │ │ │ -0002f170: 6b20 6669 6c65 2069 6e74 6f20 7468 650a k file into the. │ │ │ │ │ -0002f180: 2020 2020 2065 6e76 6972 6f6e 6d65 6e74 environment │ │ │ │ │ -0002f190: 2e20 202a 4e6f 7465 2045 6e76 6972 6f6e . *Note Environ │ │ │ │ │ -0002f1a0: 6d65 6e74 2062 6c6f 636b 3a3a 2e0a 0a20 ment block::... │ │ │ │ │ -0002f1b0: 2020 2020 5468 6520 272d 2d66 696c 6527 The '--file' │ │ │ │ │ -0002f1c0: 206f 7074 696f 6e20 6f76 6572 7269 6465 option override │ │ │ │ │ -0002f1d0: 7320 7468 6520 6465 6661 756c 7420 6c6f s the default lo │ │ │ │ │ -0002f1e0: 6361 7469 6f6e 206f 6620 7468 650a 2020 cation of the. │ │ │ │ │ -0002f1f0: 2020 2065 6e76 6972 6f6e 6d65 6e74 2062 environment b │ │ │ │ │ -0002f200: 6c6f 636b 2e0a 0a20 2020 2020 5468 6520 lock... The │ │ │ │ │ -0002f210: 272d 2d73 6b69 702d 7369 6727 206f 7074 '--skip-sig' opt │ │ │ │ │ -0002f220: 696f 6e20 736b 6970 7320 7369 676e 6174 ion skips signat │ │ │ │ │ -0002f230: 7572 6520 6368 6563 6b69 6e67 2065 7665 ure checking eve │ │ │ │ │ -0002f240: 6e20 7768 656e 2074 6865 0a20 2020 2020 n when the. │ │ │ │ │ -0002f250: 7661 6c75 6520 6f66 2065 6e76 6972 6f6e value of environ │ │ │ │ │ -0002f260: 6d65 6e74 2076 6172 6961 626c 6520 2763 ment variable 'c │ │ │ │ │ -0002f270: 6865 636b 5f73 6967 6e61 7475 7265 7327 heck_signatures' │ │ │ │ │ -0002f280: 2069 7320 7365 7420 746f 0a20 2020 2020 is set to. │ │ │ │ │ -0002f290: 2765 6e66 6f72 6365 2720 282a 6e6f 7465 'enforce' (*note │ │ │ │ │ -0002f2a0: 2063 6865 636b 5f73 6967 6e61 7475 7265 check_signature │ │ │ │ │ -0002f2b0: 733a 3a29 2e0a 0a20 2020 2020 4966 206f s::)... If o │ │ │ │ │ -0002f2c0: 6e65 206f 7220 6d6f 7265 2076 6172 6961 ne or more varia │ │ │ │ │ -0002f2d0: 626c 6520 6e61 6d65 7320 6172 6520 7072 ble names are pr │ │ │ │ │ -0002f2e0: 6f76 6964 6564 2061 7320 6172 6775 6d65 ovided as argume │ │ │ │ │ -0002f2f0: 6e74 732c 2074 6865 7920 6172 650a 2020 nts, they are. │ │ │ │ │ -0002f300: 2020 2069 6e74 6572 7072 6574 6564 2061 interpreted a │ │ │ │ │ -0002f310: 7320 6120 7768 6974 656c 6973 7420 6f66 s a whitelist of │ │ │ │ │ -0002f320: 2076 6172 6961 626c 6573 2074 6f20 6c6f variables to lo │ │ │ │ │ -0002f330: 6164 2066 726f 6d20 7468 650a 2020 2020 ad from the. │ │ │ │ │ -0002f340: 2065 6e76 6972 6f6e 6d65 6e74 2062 6c6f environment blo │ │ │ │ │ -0002f350: 636b 2066 696c 652e 2020 5661 7269 6162 ck file. Variab │ │ │ │ │ -0002f360: 6c65 7320 7365 7420 696e 2074 6865 2066 les set in the f │ │ │ │ │ -0002f370: 696c 6520 6275 7420 6e6f 7420 7072 6573 ile but not pres │ │ │ │ │ -0002f380: 656e 740a 2020 2020 2069 6e20 7468 6520 ent. in the │ │ │ │ │ -0002f390: 7768 6974 656c 6973 7420 6172 6520 6967 whitelist are ig │ │ │ │ │ -0002f3a0: 6e6f 7265 642e 0a0a 2020 2020 2054 6865 nored... The │ │ │ │ │ -0002f3b0: 2027 2d2d 736b 6970 2d73 6967 2720 6f70 '--skip-sig' op │ │ │ │ │ -0002f3c0: 7469 6f6e 2073 686f 756c 6420 6265 2075 tion should be u │ │ │ │ │ -0002f3d0: 7365 6420 7769 7468 2063 6172 652c 2061 sed with care, a │ │ │ │ │ -0002f3e0: 6e64 2073 686f 756c 6420 616c 7761 7973 nd should always │ │ │ │ │ -0002f3f0: 0a20 2020 2020 6265 2075 7365 6420 696e . be used in │ │ │ │ │ -0002f400: 2063 6f6e 6365 7274 2077 6974 6820 6120 concert with a │ │ │ │ │ -0002f410: 7768 6974 656c 6973 7420 6f66 2061 6363 whitelist of acc │ │ │ │ │ -0002f420: 6570 7461 626c 6520 7661 7269 6162 6c65 eptable variable │ │ │ │ │ -0002f430: 7320 7768 6f73 650a 2020 2020 2076 616c s whose. val │ │ │ │ │ -0002f440: 7565 7320 7368 6f75 6c64 2062 6520 7365 ues should be se │ │ │ │ │ -0002f450: 742e 2020 4661 696c 7572 6520 746f 2065 t. Failure to e │ │ │ │ │ -0002f460: 6d70 6c6f 7920 6120 6361 7265 6675 6c6c mploy a carefull │ │ │ │ │ -0002f470: 7920 636f 6e73 7472 7563 7465 640a 2020 y constructed. │ │ │ │ │ -0002f480: 2020 2077 6869 7465 6c69 7374 2063 6f75 whitelist cou │ │ │ │ │ -0002f490: 6c64 2072 6573 756c 7420 696e 2072 6561 ld result in rea │ │ │ │ │ -0002f4a0: 6469 6e67 2061 206d 616c 6963 696f 7573 ding a malicious │ │ │ │ │ -0002f4b0: 2076 616c 7565 2069 6e74 6f20 6372 6974 value into crit │ │ │ │ │ -0002f4c0: 6963 616c 0a20 2020 2020 656e 7669 726f ical. enviro │ │ │ │ │ -0002f4d0: 6e6d 656e 7420 7661 7269 6162 6c65 7320 nment variables │ │ │ │ │ -0002f4e0: 6672 6f6d 2074 6865 2066 696c 652c 2073 from the file, s │ │ │ │ │ -0002f4f0: 7563 6820 6173 2073 6574 7469 6e67 0a20 uch as setting. │ │ │ │ │ -0002f500: 2020 2020 2763 6865 636b 5f73 6967 6e61 'check_signa │ │ │ │ │ -0002f510: 7475 7265 733d 6e6f 272c 206d 6f64 6966 tures=no', modif │ │ │ │ │ -0002f520: 7969 6e67 2027 7072 6566 6978 2720 746f ying 'prefix' to │ │ │ │ │ -0002f530: 2062 6f6f 7420 6672 6f6d 2061 6e0a 2020 boot from an. │ │ │ │ │ -0002f540: 2020 2075 6e65 7870 6563 7465 6420 6c6f unexpected lo │ │ │ │ │ -0002f550: 6361 7469 6f6e 206f 7220 6e6f 7420 6174 cation or not at │ │ │ │ │ -0002f560: 2061 6c6c 2c20 6574 632e 0a0a 2020 2020 all, etc... │ │ │ │ │ -0002f570: 2057 6865 6e20 7573 6564 2077 6974 6820 When used with │ │ │ │ │ -0002f580: 6361 7265 2c20 272d 2d73 6b69 702d 7369 care, '--skip-si │ │ │ │ │ -0002f590: 6727 2061 6e64 2074 6865 2077 6869 7465 g' and the white │ │ │ │ │ -0002f5a0: 6c69 7374 2065 6e61 626c 6520 616e 0a20 list enable an. │ │ │ │ │ -0002f5b0: 2020 2020 6164 6d69 6e69 7374 7261 746f administrato │ │ │ │ │ -0002f5c0: 7220 746f 2063 6f6e 6669 6775 7265 2061 r to configure a │ │ │ │ │ -0002f5d0: 2073 7973 7465 6d20 746f 2062 6f6f 7420 system to boot │ │ │ │ │ -0002f5e0: 6f6e 6c79 2073 6967 6e65 640a 2020 2020 only signed. │ │ │ │ │ -0002f5f0: 2063 6f6e 6669 6775 7261 7469 6f6e 732c configurations, │ │ │ │ │ -0002f600: 2062 7574 2074 6f20 616c 6c6f 7720 7468 but to allow th │ │ │ │ │ -0002f610: 6520 7573 6572 2074 6f20 7365 6c65 6374 e user to select │ │ │ │ │ -0002f620: 2066 726f 6d20 616d 6f6e 6720 6d75 6c74 from among mult │ │ │ │ │ -0002f630: 6970 6c65 0a20 2020 2020 636f 6e66 6967 iple. config │ │ │ │ │ -0002f640: 7572 6174 696f 6e73 2c20 616e 6420 746f urations, and to │ │ │ │ │ -0002f650: 2065 6e61 626c 6520 226f 6e65 2d73 686f enable "one-sho │ │ │ │ │ -0002f660: 7422 2062 6f6f 7420 6174 7465 6d70 7473 t" boot attempts │ │ │ │ │ -0002f670: 2061 6e64 0a20 2020 2020 2273 6176 6564 and. "saved │ │ │ │ │ -0002f680: 6566 6175 6c74 2220 6265 6861 7669 6f72 efault" behavior │ │ │ │ │ -0002f690: 2e20 202a 4e6f 7465 2055 7369 6e67 2064 . *Note Using d │ │ │ │ │ -0002f6a0: 6967 6974 616c 2073 6967 6e61 7475 7265 igital signature │ │ │ │ │ -0002f6b0: 733a 3a2c 2066 6f72 206d 6f72 650a 2020 s::, for more. │ │ │ │ │ -0002f6c0: 2020 2069 6e66 6f72 6d61 7469 6f6e 2e0a information.. │ │ │ │ │ -0002f6d0: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ -0002f6e0: 666f 2c20 204e 6f64 653a 206c 6f61 6466 fo, Node: loadf │ │ │ │ │ -0002f6f0: 6f6e 742c 2020 4e65 7874 3a20 6c6f 6f70 ont, Next: loop │ │ │ │ │ -0002f700: 6261 636b 2c20 2050 7265 763a 206c 6f61 back, Prev: loa │ │ │ │ │ -0002f710: 645f 656e 762c 2020 5570 3a20 436f 6d6d d_env, Up: Comm │ │ │ │ │ -0002f720: 616e 642d 6c69 6e65 2061 6e64 206d 656e and-line and men │ │ │ │ │ -0002f730: 7520 656e 7472 7920 636f 6d6d 616e 6473 u entry commands │ │ │ │ │ -0002f740: 0a0a 3136 2e33 2e34 3320 6c6f 6164 666f ..16.3.43 loadfo │ │ │ │ │ -0002f750: 6e74 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d nt.------------- │ │ │ │ │ -0002f760: 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 ---.. -- Command │ │ │ │ │ -0002f770: 3a20 6c6f 6164 666f 6e74 2066 696c 6520 : loadfont file │ │ │ │ │ -0002f780: 2e2e 2e0a 2020 2020 204c 6f61 6420 7370 .... Load sp │ │ │ │ │ -0002f790: 6563 6966 6965 6420 666f 6e74 2066 696c ecified font fil │ │ │ │ │ -0002f7a0: 6573 2e20 2055 6e6c 6573 7320 6162 736f es. Unless abso │ │ │ │ │ -0002f7b0: 6c75 7465 2070 6174 686e 616d 6520 6973 lute pathname is │ │ │ │ │ -0002f7c0: 2067 6976 656e 2c20 4649 4c45 0a20 2020 given, FILE. │ │ │ │ │ -0002f7d0: 2020 6973 2061 7373 756d 6564 2074 6f20 is assumed to │ │ │ │ │ -0002f7e0: 6265 2069 6e20 6469 7265 6374 6f72 7920 be in directory │ │ │ │ │ -0002f7f0: 2724 7072 6566 6978 2f66 6f6e 7473 2720 '$prefix/fonts' │ │ │ │ │ -0002f800: 7769 7468 2073 7566 6669 7820 272e 7066 with suffix '.pf │ │ │ │ │ -0002f810: 3227 0a20 2020 2020 6170 7065 6e64 6564 2'. appended │ │ │ │ │ -0002f820: 2e20 202a 4e6f 7465 2046 6f6e 7473 3a20 . *Note Fonts: │ │ │ │ │ -0002f830: 5468 656d 6520 6669 6c65 2066 6f72 6d61 Theme file forma │ │ │ │ │ -0002f840: 742e 0a0a 1f0a 4669 6c65 3a20 6772 7562 t.....File: grub │ │ │ │ │ -0002f850: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 6c6f .info, Node: lo │ │ │ │ │ -0002f860: 6f70 6261 636b 2c20 204e 6578 743a 206c opback, Next: l │ │ │ │ │ -0002f870: 732c 2020 5072 6576 3a20 6c6f 6164 666f s, Prev: loadfo │ │ │ │ │ -0002f880: 6e74 2c20 2055 703a 2043 6f6d 6d61 6e64 nt, Up: Command │ │ │ │ │ -0002f890: 2d6c 696e 6520 616e 6420 6d65 6e75 2065 -line and menu e │ │ │ │ │ -0002f8a0: 6e74 7279 2063 6f6d 6d61 6e64 730a 0a31 ntry commands..1 │ │ │ │ │ -0002f8b0: 362e 332e 3434 206c 6f6f 7062 6163 6b0a 6.3.44 loopback. │ │ │ │ │ -0002f8c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0002f8d0: 0a0a 202d 2d20 436f 6d6d 616e 643a 206c .. -- Command: l │ │ │ │ │ -0002f8e0: 6f6f 7062 6163 6b20 5b2d 645d 2064 6576 oopback [-d] dev │ │ │ │ │ -0002f8f0: 6963 6520 6669 6c65 0a20 2020 2020 4d61 ice file. Ma │ │ │ │ │ -0002f900: 6b65 2074 6865 2064 6576 6963 6520 6e61 ke the device na │ │ │ │ │ -0002f910: 6d65 6420 4445 5649 4345 2063 6f72 7265 med DEVICE corre │ │ │ │ │ -0002f920: 7370 6f6e 6420 746f 2074 6865 2063 6f6e spond to the con │ │ │ │ │ -0002f930: 7465 6e74 7320 6f66 2074 6865 0a20 2020 tents of the. │ │ │ │ │ -0002f940: 2020 6669 6c65 7379 7374 656d 2069 6d61 filesystem ima │ │ │ │ │ -0002f950: 6765 2069 6e20 4649 4c45 2e20 2046 6f72 ge in FILE. For │ │ │ │ │ -0002f960: 2065 7861 6d70 6c65 3a0a 0a20 2020 2020 example:.. │ │ │ │ │ -0002f970: 2020 2020 206c 6f6f 7062 6163 6b20 6c6f loopback lo │ │ │ │ │ -0002f980: 6f70 3020 2f70 6174 682f 746f 2f69 6d61 op0 /path/to/ima │ │ │ │ │ -0002f990: 6765 0a20 2020 2020 2020 2020 206c 7320 ge. ls │ │ │ │ │ -0002f9a0: 286c 6f6f 7030 292f 0a0a 2020 2020 2057 (loop0)/.. W │ │ │ │ │ -0002f9b0: 6974 6820 7468 6520 272d 6427 206f 7074 ith the '-d' opt │ │ │ │ │ -0002f9c0: 696f 6e2c 2064 656c 6574 6520 6120 6465 ion, delete a de │ │ │ │ │ -0002f9d0: 7669 6365 2070 7265 7669 6f75 736c 7920 vice previously │ │ │ │ │ -0002f9e0: 6372 6561 7465 6420 7573 696e 6720 7468 created using th │ │ │ │ │ -0002f9f0: 6973 0a20 2020 2020 636f 6d6d 616e 642e is. command. │ │ │ │ │ -0002fa00: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ -0002fa10: 6e66 6f2c 2020 4e6f 6465 3a20 6c73 2c20 nfo, Node: ls, │ │ │ │ │ -0002fa20: 204e 6578 743a 206c 7366 6f6e 7473 2c20 Next: lsfonts, │ │ │ │ │ -0002fa30: 2050 7265 763a 206c 6f6f 7062 6163 6b2c Prev: loopback, │ │ │ │ │ -0002fa40: 2020 5570 3a20 436f 6d6d 616e 642d 6c69 Up: Command-li │ │ │ │ │ -0002fa50: 6e65 2061 6e64 206d 656e 7520 656e 7472 ne and menu entr │ │ │ │ │ -0002fa60: 7920 636f 6d6d 616e 6473 0a0a 3136 2e33 y commands..16.3 │ │ │ │ │ -0002fa70: 2e34 3520 6c73 0a2d 2d2d 2d2d 2d2d 2d2d .45 ls.--------- │ │ │ │ │ -0002fa80: 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 -.. -- Command: │ │ │ │ │ -0002fa90: 6c73 205b 6172 6720 2e2e 2e5d 0a20 2020 ls [arg ...]. │ │ │ │ │ -0002faa0: 2020 4c69 7374 2064 6576 6963 6573 206f List devices o │ │ │ │ │ -0002fab0: 7220 6669 6c65 732e 0a0a 2020 2020 2057 r files... W │ │ │ │ │ -0002fac0: 6974 6820 6e6f 2061 7267 756d 656e 7473 ith no arguments │ │ │ │ │ -0002fad0: 2c20 7072 696e 7420 616c 6c20 6465 7669 , print all devi │ │ │ │ │ -0002fae0: 6365 7320 6b6e 6f77 6e20 746f 2047 5255 ces known to GRU │ │ │ │ │ -0002faf0: 422e 0a0a 2020 2020 2049 6620 7468 6520 B... If the │ │ │ │ │ -0002fb00: 6172 6775 6d65 6e74 2069 7320 6120 6465 argument is a de │ │ │ │ │ -0002fb10: 7669 6365 206e 616d 6520 656e 636c 6f73 vice name enclos │ │ │ │ │ -0002fb20: 6564 2069 6e20 7061 7265 6e74 6865 7365 ed in parenthese │ │ │ │ │ -0002fb30: 7320 282a 6e6f 7465 0a20 2020 2020 4465 s (*note. De │ │ │ │ │ -0002fb40: 7669 6365 2073 796e 7461 783a 3a29 2c20 vice syntax::), │ │ │ │ │ -0002fb50: 7468 656e 2070 7269 6e74 2074 6865 206e then print the n │ │ │ │ │ -0002fb60: 616d 6520 6f66 2074 6865 2066 696c 6573 ame of the files │ │ │ │ │ -0002fb70: 7973 7465 6d20 6f66 2074 6861 740a 2020 ystem of that. │ │ │ │ │ -0002fb80: 2020 2064 6576 6963 652e 0a0a 2020 2020 device... │ │ │ │ │ -0002fb90: 2049 6620 7468 6520 6172 6775 6d65 6e74 If the argument │ │ │ │ │ -0002fba0: 2069 7320 6120 6469 7265 6374 6f72 7920 is a directory │ │ │ │ │ -0002fbb0: 6769 7665 6e20 6173 2061 6e20 6162 736f given as an abso │ │ │ │ │ -0002fbc0: 6c75 7465 2066 696c 6520 6e61 6d65 0a20 lute file name. │ │ │ │ │ -0002fbd0: 2020 2020 282a 6e6f 7465 2046 696c 6520 (*note File │ │ │ │ │ -0002fbe0: 6e61 6d65 2073 796e 7461 783a 3a29 2c20 name syntax::), │ │ │ │ │ -0002fbf0: 7468 656e 206c 6973 7420 7468 6520 636f then list the co │ │ │ │ │ -0002fc00: 6e74 656e 7473 206f 6620 7468 6174 0a20 ntents of that. │ │ │ │ │ -0002fc10: 2020 2020 6469 7265 6374 6f72 792e 0a0a directory... │ │ │ │ │ -0002fc20: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ -0002fc30: 6f2c 2020 4e6f 6465 3a20 6c73 666f 6e74 o, Node: lsfont │ │ │ │ │ -0002fc40: 732c 2020 4e65 7874 3a20 6c73 6d6f 642c s, Next: lsmod, │ │ │ │ │ -0002fc50: 2020 5072 6576 3a20 6c73 2c20 2055 703a Prev: ls, Up: │ │ │ │ │ -0002fc60: 2043 6f6d 6d61 6e64 2d6c 696e 6520 616e Command-line an │ │ │ │ │ -0002fc70: 6420 6d65 6e75 2065 6e74 7279 2063 6f6d d menu entry com │ │ │ │ │ -0002fc80: 6d61 6e64 730a 0a31 362e 332e 3436 206c mands..16.3.46 l │ │ │ │ │ -0002fc90: 7366 6f6e 7473 0a2d 2d2d 2d2d 2d2d 2d2d sfonts.--------- │ │ │ │ │ -0002fca0: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ │ -0002fcb0: 616e 643a 206c 7366 6f6e 7473 0a20 2020 and: lsfonts. │ │ │ │ │ -0002fcc0: 2020 4c69 7374 206c 6f61 6465 6420 666f List loaded fo │ │ │ │ │ -0002fcd0: 6e74 732e 0a0a 1f0a 4669 6c65 3a20 6772 nts.....File: gr │ │ │ │ │ -0002fce0: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ -0002fcf0: 6c73 6d6f 642c 2020 4e65 7874 3a20 6d64 lsmod, Next: md │ │ │ │ │ -0002fd00: 3573 756d 2c20 2050 7265 763a 206c 7366 5sum, Prev: lsf │ │ │ │ │ -0002fd10: 6f6e 7473 2c20 2055 703a 2043 6f6d 6d61 onts, Up: Comma │ │ │ │ │ -0002fd20: 6e64 2d6c 696e 6520 616e 6420 6d65 6e75 nd-line and menu │ │ │ │ │ -0002fd30: 2065 6e74 7279 2063 6f6d 6d61 6e64 730a entry commands. │ │ │ │ │ -0002fd40: 0a31 362e 332e 3437 206c 736d 6f64 0a2d .16.3.47 lsmod.- │ │ │ │ │ -0002fd50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d ------------.. - │ │ │ │ │ -0002fd60: 2d20 436f 6d6d 616e 643a 206c 736d 6f64 - Command: lsmod │ │ │ │ │ -0002fd70: 0a20 2020 2020 5368 6f77 206c 6973 7420 . Show list │ │ │ │ │ -0002fd80: 6f66 206c 6f61 6465 6420 6d6f 6475 6c65 of loaded module │ │ │ │ │ -0002fd90: 732e 0a0a 1f0a 4669 6c65 3a20 6772 7562 s.....File: grub │ │ │ │ │ -0002fda0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 6d64 .info, Node: md │ │ │ │ │ -0002fdb0: 3573 756d 2c20 204e 6578 743a 206d 6f64 5sum, Next: mod │ │ │ │ │ -0002fdc0: 756c 652c 2020 5072 6576 3a20 6c73 6d6f ule, Prev: lsmo │ │ │ │ │ -0002fdd0: 642c 2020 5570 3a20 436f 6d6d 616e 642d d, Up: Command- │ │ │ │ │ -0002fde0: 6c69 6e65 2061 6e64 206d 656e 7520 656e line and menu en │ │ │ │ │ -0002fdf0: 7472 7920 636f 6d6d 616e 6473 0a0a 3136 try commands..16 │ │ │ │ │ -0002fe00: 2e33 2e34 3820 6d64 3573 756d 0a2d 2d2d .3.48 md5sum.--- │ │ │ │ │ -0002fe10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d -----------.. -- │ │ │ │ │ -0002fe20: 2043 6f6d 6d61 6e64 3a20 6d64 3573 756d Command: md5sum │ │ │ │ │ -0002fe30: 2061 7267 202e 2e2e 0a20 2020 2020 416c arg .... Al │ │ │ │ │ -0002fe40: 6961 7320 666f 7220 2768 6173 6873 756d ias for 'hashsum │ │ │ │ │ -0002fe50: 202d 2d68 6173 6820 6d64 3520 6172 6720 --hash md5 arg │ │ │ │ │ -0002fe60: 2e2e 2e27 2e20 2053 6565 2063 6f6d 6d61 ...'. See comma │ │ │ │ │ -0002fe70: 6e64 2027 6861 7368 7375 6d27 0a20 2020 nd 'hashsum'. │ │ │ │ │ -0002fe80: 2020 282a 6e6f 7465 2068 6173 6873 756d (*note hashsum │ │ │ │ │ -0002fe90: 3a3a 2920 666f 7220 6675 6c6c 2064 6573 ::) for full des │ │ │ │ │ -0002fea0: 6372 6970 7469 6f6e 2e0a 0a1f 0a46 696c cription.....Fil │ │ │ │ │ -0002feb0: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ -0002fec0: 6f64 653a 206d 6f64 756c 652c 2020 4e65 ode: module, Ne │ │ │ │ │ -0002fed0: 7874 3a20 6d75 6c74 6962 6f6f 742c 2020 xt: multiboot, │ │ │ │ │ -0002fee0: 5072 6576 3a20 6d64 3573 756d 2c20 2055 Prev: md5sum, U │ │ │ │ │ -0002fef0: 703a 2043 6f6d 6d61 6e64 2d6c 696e 6520 p: Command-line │ │ │ │ │ -0002ff00: 616e 6420 6d65 6e75 2065 6e74 7279 2063 and menu entry c │ │ │ │ │ -0002ff10: 6f6d 6d61 6e64 730a 0a31 362e 332e 3439 ommands..16.3.49 │ │ │ │ │ -0002ff20: 206d 6f64 756c 650a 2d2d 2d2d 2d2d 2d2d module.-------- │ │ │ │ │ -0002ff30: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ │ -0002ff40: 616e 643a 206d 6f64 756c 6520 5b2d 2d6e and: module [--n │ │ │ │ │ -0002ff50: 6f75 6e7a 6970 5d20 6669 6c65 205b 6172 ounzip] file [ar │ │ │ │ │ -0002ff60: 6775 6d65 6e74 735d 0a20 2020 2020 4c6f guments]. Lo │ │ │ │ │ -0002ff70: 6164 2061 206d 6f64 756c 6520 666f 7220 ad a module for │ │ │ │ │ -0002ff80: 6d75 6c74 6962 6f6f 7420 6b65 726e 656c multiboot kernel │ │ │ │ │ -0002ff90: 2069 6d61 6765 2e20 2054 6865 2072 6573 image. The res │ │ │ │ │ -0002ffa0: 7420 6f66 2074 6865 206c 696e 6520 6973 t of the line is │ │ │ │ │ -0002ffb0: 0a20 2020 2020 7061 7373 6564 2076 6572 . passed ver │ │ │ │ │ -0002ffc0: 6261 7469 6d20 6173 2074 6865 206d 6f64 batim as the mod │ │ │ │ │ -0002ffd0: 756c 6520 636f 6d6d 616e 6420 6c69 6e65 ule command line │ │ │ │ │ -0002ffe0: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ -0002fff0: 696e 666f 2c20 204e 6f64 653a 206d 756c info, Node: mul │ │ │ │ │ -00030000: 7469 626f 6f74 2c20 204e 6578 743a 206e tiboot, Next: n │ │ │ │ │ -00030010: 6174 6976 6564 6973 6b2c 2020 5072 6576 ativedisk, Prev │ │ │ │ │ -00030020: 3a20 6d6f 6475 6c65 2c20 2055 703a 2043 : module, Up: C │ │ │ │ │ -00030030: 6f6d 6d61 6e64 2d6c 696e 6520 616e 6420 ommand-line and │ │ │ │ │ -00030040: 6d65 6e75 2065 6e74 7279 2063 6f6d 6d61 menu entry comma │ │ │ │ │ -00030050: 6e64 730a 0a31 362e 332e 3530 206d 756c nds..16.3.50 mul │ │ │ │ │ -00030060: 7469 626f 6f74 0a2d 2d2d 2d2d 2d2d 2d2d tiboot.--------- │ │ │ │ │ -00030070: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ │ -00030080: 6d6d 616e 643a 206d 756c 7469 626f 6f74 mmand: multiboot │ │ │ │ │ -00030090: 205b 2d2d 7175 6972 6b2d 6261 642d 6b6c [--quirk-bad-kl │ │ │ │ │ -000300a0: 7564 6765 5d0a 2020 2020 2020 2020 2020 udge]. │ │ │ │ │ -000300b0: 5b2d 2d71 7569 726b 2d6d 6f64 756c 6573 [--quirk-modules │ │ │ │ │ -000300c0: 2d61 6674 6572 2d6b 6572 6e65 6c5d 2066 -after-kernel] f │ │ │ │ │ -000300d0: 696c 6520 2e2e 2e0a 2020 2020 204c 6f61 ile .... Loa │ │ │ │ │ -000300e0: 6420 6120 6d75 6c74 6962 6f6f 7420 6b65 d a multiboot ke │ │ │ │ │ -000300f0: 726e 656c 2069 6d61 6765 2066 726f 6d20 rnel image from │ │ │ │ │ -00030100: 4649 4c45 2e20 2054 6865 2072 6573 7420 FILE. The rest │ │ │ │ │ -00030110: 6f66 2074 6865 206c 696e 6520 6973 0a20 of the line is. │ │ │ │ │ -00030120: 2020 2020 7061 7373 6564 2076 6572 6261 passed verba │ │ │ │ │ -00030130: 7469 6d20 6173 2074 6865 2022 6b65 726e tim as the "kern │ │ │ │ │ -00030140: 656c 2063 6f6d 6d61 6e64 2d6c 696e 6522 el command-line" │ │ │ │ │ -00030150: 2e20 2041 6e79 206d 6f64 756c 6520 6d75 . Any module mu │ │ │ │ │ -00030160: 7374 2062 650a 2020 2020 2072 656c 6f61 st be. reloa │ │ │ │ │ -00030170: 6465 6420 6166 7465 7220 7573 696e 6720 ded after using │ │ │ │ │ -00030180: 7468 6973 2063 6f6d 6d61 6e64 2028 2a6e this command (*n │ │ │ │ │ -00030190: 6f74 6520 6d6f 6475 6c65 3a3a 292e 0a0a ote module::)... │ │ │ │ │ -000301a0: 2020 2020 2053 6f6d 6520 6b65 726e 656c Some kernel │ │ │ │ │ -000301b0: 7320 6861 7665 206b 6e6f 776e 2070 726f s have known pro │ │ │ │ │ -000301c0: 626c 656d 732e 2020 596f 7520 6e65 6564 blems. You need │ │ │ │ │ -000301d0: 2074 6f20 7370 6563 6966 7920 2d71 7569 to specify -qui │ │ │ │ │ -000301e0: 726b 2d2a 2066 6f72 0a20 2020 2020 7468 rk-* for. th │ │ │ │ │ -000301f0: 6f73 652e 2020 2d71 7569 726b 2d62 6164 ose. -quirk-bad │ │ │ │ │ -00030200: 2d6b 6c75 6467 6520 6973 2061 2070 726f -kludge is a pro │ │ │ │ │ -00030210: 626c 656d 2073 6565 6e20 696e 2073 6576 blem seen in sev │ │ │ │ │ -00030220: 6572 616c 2070 726f 6475 6374 730a 2020 eral products. │ │ │ │ │ -00030230: 2020 2074 6861 7420 7468 6579 2069 6e63 that they inc │ │ │ │ │ -00030240: 6c75 6465 206c 6f61 6469 6e67 206b 6c75 lude loading klu │ │ │ │ │ -00030250: 6467 6520 696e 666f 726d 6174 696f 6e20 dge information │ │ │ │ │ -00030260: 7769 7468 2069 6e76 616c 6964 2064 6174 with invalid dat │ │ │ │ │ -00030270: 6120 696e 0a20 2020 2020 454c 4620 6669 a in. ELF fi │ │ │ │ │ -00030280: 6c65 2e20 2047 5255 4220 7072 696f 7220 le. GRUB prior │ │ │ │ │ -00030290: 746f 2030 2e39 3720 616e 6420 736f 6d65 to 0.97 and some │ │ │ │ │ -000302a0: 2063 7573 746f 6d20 6275 696c 6473 2070 custom builds p │ │ │ │ │ -000302b0: 7265 6665 7272 6564 2045 4c46 0a20 2020 referred ELF. │ │ │ │ │ -000302c0: 2020 696e 666f 726d 6174 696f 6e20 7768 information wh │ │ │ │ │ -000302d0: 696c 6520 302e 3937 2061 6e64 2047 5255 ile 0.97 and GRU │ │ │ │ │ -000302e0: 4220 3220 7573 6520 6b6c 7564 6765 2e20 B 2 use kludge. │ │ │ │ │ -000302f0: 2055 7365 2074 6869 7320 6f70 7469 6f6e Use this option │ │ │ │ │ -00030300: 2074 6f0a 2020 2020 2069 676e 6f72 6520 to. ignore │ │ │ │ │ -00030310: 6b6c 7564 6765 2e20 204b 6e6f 776e 2061 kludge. Known a │ │ │ │ │ -00030320: 6666 6563 7465 6420 7379 7374 656d 733a ffected systems: │ │ │ │ │ -00030330: 206f 6c64 2053 6f6c 6172 6973 2c20 536b old Solaris, Sk │ │ │ │ │ -00030340: 794f 532e 0a0a 2020 2020 202d 7175 6972 yOS... -quir │ │ │ │ │ -00030350: 6b2d 6d6f 6475 6c65 732d 6166 7465 722d k-modules-after- │ │ │ │ │ -00030360: 6b65 726e 656c 2069 7320 6e65 6564 6564 kernel is needed │ │ │ │ │ -00030370: 2066 6f72 206b 6572 6e65 6c73 2077 6869 for kernels whi │ │ │ │ │ -00030380: 6368 206c 6f61 6420 6174 0a20 2020 2020 ch load at. │ │ │ │ │ -00030390: 7265 6c61 7469 7665 6c79 2068 6967 6820 relatively high │ │ │ │ │ -000303a0: 6164 6472 6573 7320 652e 672e 2020 3136 address e.g. 16 │ │ │ │ │ -000303b0: 4d69 4220 6d61 726b 2061 6e64 2063 616e MiB mark and can │ │ │ │ │ -000303c0: 2774 2063 6f70 6520 7769 7468 0a20 2020 't cope with. │ │ │ │ │ -000303d0: 2020 6d6f 6475 6c65 7320 7374 7566 6665 modules stuffe │ │ │ │ │ -000303e0: 6420 6265 7477 6565 6e20 314d 6942 206d d between 1MiB m │ │ │ │ │ -000303f0: 6172 6b20 616e 6420 6265 6769 6e6e 696e ark and beginnin │ │ │ │ │ -00030400: 6720 6f66 2074 6865 206b 6572 6e65 6c2e g of the kernel. │ │ │ │ │ -00030410: 0a20 2020 2020 4b6e 6f77 6e20 6166 6674 . Known afft │ │ │ │ │ -00030420: 6563 7465 6420 7379 7374 656d 733a 2056 ected systems: V │ │ │ │ │ -00030430: 4d57 6172 652e 0a0a 1f0a 4669 6c65 3a20 MWare.....File: │ │ │ │ │ -00030440: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ -00030450: 3a20 6e61 7469 7665 6469 736b 2c20 204e : nativedisk, N │ │ │ │ │ -00030460: 6578 743a 206e 6f72 6d61 6c2c 2020 5072 ext: normal, Pr │ │ │ │ │ -00030470: 6576 3a20 6d75 6c74 6962 6f6f 742c 2020 ev: multiboot, │ │ │ │ │ -00030480: 5570 3a20 436f 6d6d 616e 642d 6c69 6e65 Up: Command-line │ │ │ │ │ -00030490: 2061 6e64 206d 656e 7520 656e 7472 7920 and menu entry │ │ │ │ │ -000304a0: 636f 6d6d 616e 6473 0a0a 3136 2e33 2e35 commands..16.3.5 │ │ │ │ │ -000304b0: 3120 6e61 7469 7665 6469 736b 0a2d 2d2d 1 nativedisk.--- │ │ │ │ │ -000304c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ -000304d0: 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 6e61 . -- Command: na │ │ │ │ │ -000304e0: 7469 7665 6469 736b 0a20 2020 2020 5377 tivedisk. Sw │ │ │ │ │ -000304f0: 6974 6368 2066 726f 6d20 6669 726d 7761 itch from firmwa │ │ │ │ │ -00030500: 7265 2064 6973 6b20 6472 6976 6572 7320 re disk drivers │ │ │ │ │ -00030510: 746f 206e 6174 6976 6520 6f6e 6573 2e20 to native ones. │ │ │ │ │ -00030520: 2052 6561 6c6c 7920 7573 6566 756c 0a20 Really useful. │ │ │ │ │ -00030530: 2020 2020 6f6e 6c79 206f 6e20 706c 6174 only on plat │ │ │ │ │ -00030540: 666f 726d 7320 7768 6572 6520 626f 7468 forms where both │ │ │ │ │ -00030550: 2066 6972 6d77 6172 6520 616e 6420 6e61 firmware and na │ │ │ │ │ -00030560: 7469 7665 2064 6973 6b20 6472 6976 6573 tive disk drives │ │ │ │ │ -00030570: 2061 7265 0a20 2020 2020 6176 6169 6c61 are. availa │ │ │ │ │ -00030580: 626c 652e 2020 4375 7272 656e 746c 7920 ble. Currently │ │ │ │ │ -00030590: 6933 3836 2d70 632c 2069 3338 362d 6566 i386-pc, i386-ef │ │ │ │ │ -000305a0: 692c 2069 3338 362d 6965 6565 3132 3735 i, i386-ieee1275 │ │ │ │ │ -000305b0: 2061 6e64 0a20 2020 2020 7838 365f 3634 and. x86_64 │ │ │ │ │ -000305c0: 2d65 6669 2e0a 0a1f 0a46 696c 653a 2067 -efi.....File: g │ │ │ │ │ -000305d0: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ -000305e0: 206e 6f72 6d61 6c2c 2020 4e65 7874 3a20 normal, Next: │ │ │ │ │ -000305f0: 6e6f 726d 616c 5f65 7869 742c 2020 5072 normal_exit, Pr │ │ │ │ │ -00030600: 6576 3a20 6e61 7469 7665 6469 736b 2c20 ev: nativedisk, │ │ │ │ │ -00030610: 2055 703a 2043 6f6d 6d61 6e64 2d6c 696e Up: Command-lin │ │ │ │ │ -00030620: 6520 616e 6420 6d65 6e75 2065 6e74 7279 e and menu entry │ │ │ │ │ -00030630: 2063 6f6d 6d61 6e64 730a 0a31 362e 332e commands..16.3. │ │ │ │ │ -00030640: 3532 206e 6f72 6d61 6c0a 2d2d 2d2d 2d2d 52 normal.------ │ │ │ │ │ -00030650: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ │ -00030660: 6d6d 616e 643a 206e 6f72 6d61 6c20 5b66 mmand: normal [f │ │ │ │ │ -00030670: 696c 655d 0a20 2020 2020 456e 7465 7220 ile]. Enter │ │ │ │ │ -00030680: 6e6f 726d 616c 206d 6f64 6520 616e 6420 normal mode and │ │ │ │ │ -00030690: 6469 7370 6c61 7920 7468 6520 4752 5542 display the GRUB │ │ │ │ │ -000306a0: 206d 656e 752e 0a0a 2020 2020 2049 6e20 menu... In │ │ │ │ │ -000306b0: 6e6f 726d 616c 206d 6f64 652c 2063 6f6d normal mode, com │ │ │ │ │ -000306c0: 6d61 6e64 732c 2066 696c 6573 7973 7465 mands, filesyste │ │ │ │ │ -000306d0: 6d20 6d6f 6475 6c65 732c 2061 6e64 2063 m modules, and c │ │ │ │ │ -000306e0: 7279 7074 6f67 7261 7068 790a 2020 2020 ryptography. │ │ │ │ │ -000306f0: 206d 6f64 756c 6573 2061 7265 2061 7574 modules are aut │ │ │ │ │ -00030700: 6f6d 6174 6963 616c 6c79 206c 6f61 6465 omatically loade │ │ │ │ │ -00030710: 642c 2061 6e64 2074 6865 2066 756c 6c20 d, and the full │ │ │ │ │ -00030720: 4752 5542 2073 6372 6970 7420 7061 7273 GRUB script pars │ │ │ │ │ -00030730: 6572 0a20 2020 2020 6973 2061 7661 696c er. is avail │ │ │ │ │ -00030740: 6162 6c65 2e20 204f 7468 6572 206d 6f64 able. Other mod │ │ │ │ │ -00030750: 756c 6573 206d 6179 2062 6520 6578 706c ules may be expl │ │ │ │ │ -00030760: 6963 6974 6c79 206c 6f61 6465 6420 7573 icitly loaded us │ │ │ │ │ -00030770: 696e 670a 2020 2020 2027 696e 736d 6f64 ing. 'insmod │ │ │ │ │ -00030780: 2720 282a 6e6f 7465 2069 6e73 6d6f 643a ' (*note insmod: │ │ │ │ │ -00030790: 3a29 2e0a 0a20 2020 2020 4966 2061 2046 :)... If a F │ │ │ │ │ -000307a0: 494c 4520 6973 2067 6976 656e 2c20 7468 ILE is given, th │ │ │ │ │ -000307b0: 656e 2063 6f6d 6d61 6e64 7320 7769 6c6c en commands will │ │ │ │ │ -000307c0: 2062 6520 7265 6164 2066 726f 6d20 7468 be read from th │ │ │ │ │ -000307d0: 6174 2066 696c 652e 0a20 2020 2020 4f74 at file.. Ot │ │ │ │ │ -000307e0: 6865 7277 6973 652c 2074 6865 7920 7769 herwise, they wi │ │ │ │ │ -000307f0: 6c6c 2062 6520 7265 6164 2066 726f 6d20 ll be read from │ │ │ │ │ -00030800: 2724 7072 6566 6978 2f67 7275 622e 6366 '$prefix/grub.cf │ │ │ │ │ -00030810: 6727 2069 6620 6974 2065 7869 7374 732e g' if it exists. │ │ │ │ │ -00030820: 0a0a 2020 2020 2027 6e6f 726d 616c 2720 .. 'normal' │ │ │ │ │ -00030830: 6d61 7920 6265 2063 616c 6c65 6420 6672 may be called fr │ │ │ │ │ -00030840: 6f6d 2077 6974 6869 6e20 6e6f 726d 616c om within normal │ │ │ │ │ -00030850: 206d 6f64 652c 2063 7265 6174 696e 6720 mode, creating │ │ │ │ │ -00030860: 6120 6e65 7374 6564 0a20 2020 2020 656e a nested. en │ │ │ │ │ -00030870: 7669 726f 6e6d 656e 742e 2020 4974 2069 vironment. It i │ │ │ │ │ -00030880: 7320 6d6f 7265 2075 7375 616c 2074 6f20 s more usual to │ │ │ │ │ -00030890: 7573 6520 2763 6f6e 6669 6766 696c 6527 use 'configfile' │ │ │ │ │ -000308a0: 2028 2a6e 6f74 650a 2020 2020 2063 6f6e (*note. con │ │ │ │ │ -000308b0: 6669 6766 696c 653a 3a29 2066 6f72 2074 figfile::) for t │ │ │ │ │ -000308c0: 6869 732e 0a0a 1f0a 4669 6c65 3a20 6772 his.....File: gr │ │ │ │ │ -000308d0: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ -000308e0: 6e6f 726d 616c 5f65 7869 742c 2020 4e65 normal_exit, Ne │ │ │ │ │ -000308f0: 7874 3a20 7061 7274 746f 6f6c 2c20 2050 xt: parttool, P │ │ │ │ │ -00030900: 7265 763a 206e 6f72 6d61 6c2c 2020 5570 rev: normal, Up │ │ │ │ │ -00030910: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ │ -00030920: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ │ -00030930: 6d6d 616e 6473 0a0a 3136 2e33 2e35 3320 mmands..16.3.53 │ │ │ │ │ -00030940: 6e6f 726d 616c 5f65 7869 740a 2d2d 2d2d normal_exit.---- │ │ │ │ │ -00030950: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ -00030960: 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 6e6f . -- Command: no │ │ │ │ │ -00030970: 726d 616c 5f65 7869 740a 2020 2020 2045 rmal_exit. E │ │ │ │ │ -00030980: 7869 7420 6e6f 726d 616c 206d 6f64 6520 xit normal mode │ │ │ │ │ -00030990: 282a 6e6f 7465 206e 6f72 6d61 6c3a 3a29 (*note normal::) │ │ │ │ │ -000309a0: 2e20 2049 6620 7468 6973 2069 6e73 7461 . If this insta │ │ │ │ │ -000309b0: 6e63 6520 6f66 206e 6f72 6d61 6c20 6d6f nce of normal mo │ │ │ │ │ -000309c0: 6465 0a20 2020 2020 7761 7320 6e6f 7420 de. was not │ │ │ │ │ -000309d0: 6e65 7374 6564 2077 6974 6869 6e20 616e nested within an │ │ │ │ │ -000309e0: 6f74 6865 7220 6f6e 652c 2074 6865 6e20 other one, then │ │ │ │ │ -000309f0: 7265 7475 726e 2074 6f20 7265 7363 7565 return to rescue │ │ │ │ │ -00030a00: 206d 6f64 652e 0a0a 1f0a 4669 6c65 3a20 mode.....File: │ │ │ │ │ -00030a10: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ -00030a20: 3a20 7061 7274 746f 6f6c 2c20 204e 6578 : parttool, Nex │ │ │ │ │ -00030a30: 743a 2070 6173 7377 6f72 642c 2020 5072 t: password, Pr │ │ │ │ │ -00030a40: 6576 3a20 6e6f 726d 616c 5f65 7869 742c ev: normal_exit, │ │ │ │ │ -00030a50: 2020 5570 3a20 436f 6d6d 616e 642d 6c69 Up: Command-li │ │ │ │ │ -00030a60: 6e65 2061 6e64 206d 656e 7520 656e 7472 ne and menu entr │ │ │ │ │ -00030a70: 7920 636f 6d6d 616e 6473 0a0a 3136 2e33 y commands..16.3 │ │ │ │ │ -00030a80: 2e35 3420 7061 7274 746f 6f6c 0a2d 2d2d .54 parttool.--- │ │ │ │ │ -00030a90: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 -------------.. │ │ │ │ │ -00030aa0: 2d2d 2043 6f6d 6d61 6e64 3a20 7061 7274 -- Command: part │ │ │ │ │ -00030ab0: 746f 6f6c 2070 6172 7469 7469 6f6e 2063 tool partition c │ │ │ │ │ -00030ac0: 6f6d 6d61 6e64 730a 2020 2020 204d 616b ommands. Mak │ │ │ │ │ -00030ad0: 6520 7661 7269 6f75 7320 6d6f 6469 6669 e various modifi │ │ │ │ │ -00030ae0: 6361 7469 6f6e 7320 746f 2070 6172 7469 cations to parti │ │ │ │ │ -00030af0: 7469 6f6e 2074 6162 6c65 2065 6e74 7269 tion table entri │ │ │ │ │ -00030b00: 6573 2e0a 0a20 2020 2020 4561 6368 2043 es... Each C │ │ │ │ │ -00030b10: 4f4d 4d41 4e44 2069 7320 6569 7468 6572 OMMAND is either │ │ │ │ │ -00030b20: 2061 2062 6f6f 6c65 616e 206f 7074 696f a boolean optio │ │ │ │ │ -00030b30: 6e2c 2069 6e20 7768 6963 6820 6361 7365 n, in which case │ │ │ │ │ -00030b40: 2069 7420 6d75 7374 2062 650a 2020 2020 it must be. │ │ │ │ │ -00030b50: 2066 6f6c 6c6f 7765 6420 7769 7468 2027 followed with ' │ │ │ │ │ -00030b60: 2b27 206f 7220 272d 2720 2877 6974 6820 +' or '-' (with │ │ │ │ │ -00030b70: 6e6f 2069 6e74 6572 7665 6e69 6e67 2073 no intervening s │ │ │ │ │ -00030b80: 7061 6365 2920 746f 2065 6e61 626c 6520 pace) to enable │ │ │ │ │ -00030b90: 6f72 0a20 2020 2020 6469 7361 626c 6520 or. disable │ │ │ │ │ -00030ba0: 7468 6174 206f 7074 696f 6e2c 206f 7220 that option, or │ │ │ │ │ -00030bb0: 656c 7365 2069 7420 7461 6b65 7320 6120 else it takes a │ │ │ │ │ -00030bc0: 7661 6c75 6520 696e 2074 6865 2066 6f72 value in the for │ │ │ │ │ -00030bd0: 6d0a 2020 2020 2027 434f 4d4d 414e 443d m. 'COMMAND= │ │ │ │ │ -00030be0: 5641 4c55 4527 2e0a 0a20 2020 2020 4375 VALUE'... Cu │ │ │ │ │ -00030bf0: 7272 656e 746c 792c 2027 7061 7274 746f rrently, 'partto │ │ │ │ │ -00030c00: 6f6c 2720 6973 206f 6e6c 7920 7573 6566 ol' is only usef │ │ │ │ │ -00030c10: 756c 206f 6e20 444f 5320 7061 7274 6974 ul on DOS partit │ │ │ │ │ -00030c20: 696f 6e20 7461 626c 6573 2028 616c 736f ion tables (also │ │ │ │ │ -00030c30: 0a20 2020 2020 6b6e 6f77 6e20 6173 204d . known as M │ │ │ │ │ -00030c40: 6173 7465 7220 426f 6f74 2052 6563 6f72 aster Boot Recor │ │ │ │ │ -00030c50: 642c 206f 7220 4d42 5229 2e20 4f6e 2074 d, or MBR). On t │ │ │ │ │ -00030c60: 6865 7365 2070 6172 7469 7469 6f6e 2074 hese partition t │ │ │ │ │ -00030c70: 6162 6c65 732c 0a20 2020 2020 7468 6520 ables,. the │ │ │ │ │ -00030c80: 666f 6c6c 6f77 696e 6720 636f 6d6d 616e following comman │ │ │ │ │ -00030c90: 6473 2061 7265 2061 7661 696c 6162 6c65 ds are available │ │ │ │ │ -00030ca0: 3a0a 0a20 2020 2020 2762 6f6f 7427 2028 :.. 'boot' ( │ │ │ │ │ -00030cb0: 626f 6f6c 6561 6e29 0a20 2020 2020 2020 boolean). │ │ │ │ │ -00030cc0: 2020 2057 6865 6e20 656e 6162 6c65 642c When enabled, │ │ │ │ │ -00030cd0: 2074 6869 7320 6d61 6b65 7320 7468 6520 this makes the │ │ │ │ │ -00030ce0: 7365 6c65 6374 6564 2070 6172 7469 7469 selected partiti │ │ │ │ │ -00030cf0: 6f6e 2062 6520 7468 6520 6163 7469 7665 on be the active │ │ │ │ │ -00030d00: 0a20 2020 2020 2020 2020 2028 626f 6f74 . (boot │ │ │ │ │ -00030d10: 6162 6c65 2920 7061 7274 6974 696f 6e20 able) partition │ │ │ │ │ -00030d20: 6f6e 2069 7473 2064 6973 6b2c 2063 6c65 on its disk, cle │ │ │ │ │ -00030d30: 6172 696e 6720 7468 6520 6163 7469 7665 aring the active │ │ │ │ │ -00030d40: 2066 6c61 6720 6f6e 0a20 2020 2020 2020 flag on. │ │ │ │ │ -00030d50: 2020 2061 6c6c 206f 7468 6572 2070 6172 all other par │ │ │ │ │ -00030d60: 7469 7469 6f6e 732e 2020 5468 6973 2063 titions. This c │ │ │ │ │ -00030d70: 6f6d 6d61 6e64 2069 7320 6c69 6d69 7465 ommand is limite │ │ │ │ │ -00030d80: 6420 746f 205f 7072 696d 6172 795f 0a20 d to _primary_. │ │ │ │ │ -00030d90: 2020 2020 2020 2020 2070 6172 7469 7469 partiti │ │ │ │ │ -00030da0: 6f6e 732e 0a0a 2020 2020 2027 7479 7065 ons... 'type │ │ │ │ │ -00030db0: 2720 2876 616c 7565 290a 2020 2020 2020 ' (value). │ │ │ │ │ -00030dc0: 2020 2020 4368 616e 6765 2074 6865 2074 Change the t │ │ │ │ │ -00030dd0: 7970 6520 6f66 2061 6e20 6578 6973 7469 ype of an existi │ │ │ │ │ -00030de0: 6e67 2070 6172 7469 7469 6f6e 2e20 2054 ng partition. T │ │ │ │ │ -00030df0: 6865 2076 616c 7565 206d 7573 7420 6265 he value must be │ │ │ │ │ -00030e00: 2061 0a20 2020 2020 2020 2020 206e 756d a. num │ │ │ │ │ -00030e10: 6265 7220 696e 2074 6865 2072 616e 6765 ber in the range │ │ │ │ │ -00030e20: 2030 2d30 7846 4620 2870 7265 6669 7820 0-0xFF (prefix │ │ │ │ │ -00030e30: 7769 7468 2027 3078 2720 746f 2065 6e74 with '0x' to ent │ │ │ │ │ -00030e40: 6572 2069 7420 696e 0a20 2020 2020 2020 er it in. │ │ │ │ │ -00030e50: 2020 2068 6578 6164 6563 696d 616c 292e hexadecimal). │ │ │ │ │ -00030e60: 0a0a 2020 2020 2027 6869 6464 656e 2720 .. 'hidden' │ │ │ │ │ -00030e70: 2862 6f6f 6c65 616e 290a 2020 2020 2020 (boolean). │ │ │ │ │ -00030e80: 2020 2020 5768 656e 2065 6e61 626c 6564 When enabled │ │ │ │ │ -00030e90: 2c20 7468 6973 2068 6964 6573 2074 6865 , this hides the │ │ │ │ │ -00030ea0: 2073 656c 6563 7465 6420 7061 7274 6974 selected partit │ │ │ │ │ -00030eb0: 696f 6e20 6279 2073 6574 7469 6e67 2074 ion by setting t │ │ │ │ │ -00030ec0: 6865 0a20 2020 2020 2020 2020 2022 6869 he. "hi │ │ │ │ │ -00030ed0: 6464 656e 2220 6269 7420 696e 2069 7473 dden" bit in its │ │ │ │ │ -00030ee0: 2070 6172 7469 7469 6f6e 2074 7970 6520 partition type │ │ │ │ │ -00030ef0: 636f 6465 3b20 7768 656e 2064 6973 6162 code; when disab │ │ │ │ │ -00030f00: 6c65 642c 0a20 2020 2020 2020 2020 2075 led,. u │ │ │ │ │ -00030f10: 6e68 6964 6573 2074 6865 2073 656c 6563 nhides the selec │ │ │ │ │ -00030f20: 7465 6420 7061 7274 6974 696f 6e20 6279 ted partition by │ │ │ │ │ -00030f30: 2063 6c65 6172 696e 6720 7468 6973 2062 clearing this b │ │ │ │ │ -00030f40: 6974 2e20 2054 6869 7320 6973 0a20 2020 it. This is. │ │ │ │ │ -00030f50: 2020 2020 2020 2075 7365 6675 6c20 6f6e useful on │ │ │ │ │ -00030f60: 6c79 2077 6865 6e20 626f 6f74 696e 6720 ly when booting │ │ │ │ │ -00030f70: 444f 5320 6f72 2057 696e 646f 7773 2061 DOS or Windows a │ │ │ │ │ -00030f80: 6e64 206d 756c 7469 706c 6520 7072 696d nd multiple prim │ │ │ │ │ -00030f90: 6172 790a 2020 2020 2020 2020 2020 4641 ary. FA │ │ │ │ │ -00030fa0: 5420 7061 7274 6974 696f 6e73 2065 7869 T partitions exi │ │ │ │ │ -00030fb0: 7374 2069 6e20 6f6e 6520 6469 736b 2e20 st in one disk. │ │ │ │ │ -00030fc0: 2053 6565 2061 6c73 6f20 2a6e 6f74 650a See also *note. │ │ │ │ │ -00030fd0: 2020 2020 2020 2020 2020 444f 532f 5769 DOS/Wi │ │ │ │ │ -00030fe0: 6e64 6f77 733a 3a2e 0a0a 1f0a 4669 6c65 ndows::.....File │ │ │ │ │ -00030ff0: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ -00031000: 6465 3a20 7061 7373 776f 7264 2c20 204e de: password, N │ │ │ │ │ -00031010: 6578 743a 2070 6173 7377 6f72 645f 7062 ext: password_pb │ │ │ │ │ -00031020: 6b64 6632 2c20 2050 7265 763a 2070 6172 kdf2, Prev: par │ │ │ │ │ -00031030: 7474 6f6f 6c2c 2020 5570 3a20 436f 6d6d ttool, Up: Comm │ │ │ │ │ -00031040: 616e 642d 6c69 6e65 2061 6e64 206d 656e and-line and men │ │ │ │ │ -00031050: 7520 656e 7472 7920 636f 6d6d 616e 6473 u entry commands │ │ │ │ │ -00031060: 0a0a 3136 2e33 2e35 3520 7061 7373 776f ..16.3.55 passwo │ │ │ │ │ -00031070: 7264 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d rd.------------- │ │ │ │ │ -00031080: 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 ---.. -- Command │ │ │ │ │ -00031090: 3a20 7061 7373 776f 7264 2075 7365 7220 : password user │ │ │ │ │ -000310a0: 636c 6561 722d 7061 7373 776f 7264 0a20 clear-password. │ │ │ │ │ -000310b0: 2020 2020 4465 6669 6e65 2061 2075 7365 Define a use │ │ │ │ │ -000310c0: 7220 6e61 6d65 6420 5553 4552 2077 6974 r named USER wit │ │ │ │ │ -000310d0: 6820 7061 7373 776f 7264 2043 4c45 4152 h password CLEAR │ │ │ │ │ -000310e0: 2d50 4153 5357 4f52 442e 2020 2a4e 6f74 -PASSWORD. *Not │ │ │ │ │ -000310f0: 650a 2020 2020 2053 6563 7572 6974 793a e. Security: │ │ │ │ │ -00031100: 3a2e 0a0a 1f0a 4669 6c65 3a20 6772 7562 :.....File: grub │ │ │ │ │ -00031110: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 7061 .info, Node: pa │ │ │ │ │ -00031120: 7373 776f 7264 5f70 626b 6466 322c 2020 ssword_pbkdf2, │ │ │ │ │ -00031130: 4e65 7874 3a20 706c 6179 2c20 2050 7265 Next: play, Pre │ │ │ │ │ -00031140: 763a 2070 6173 7377 6f72 642c 2020 5570 v: password, Up │ │ │ │ │ -00031150: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ │ -00031160: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ │ -00031170: 6d6d 616e 6473 0a0a 3136 2e33 2e35 3620 mmands..16.3.56 │ │ │ │ │ -00031180: 7061 7373 776f 7264 5f70 626b 6466 320a password_pbkdf2. │ │ │ │ │ +0002eea0: 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 -.. -- Command: │ │ │ │ │ +0002eeb0: 6c69 7374 5f74 7275 7374 6564 0a20 2020 list_trusted. │ │ │ │ │ +0002eec0: 2020 4c69 7374 2061 6c6c 2070 7562 6c69 List all publi │ │ │ │ │ +0002eed0: 6320 6b65 7973 2074 7275 7374 6564 2062 c keys trusted b │ │ │ │ │ +0002eee0: 7920 4752 5542 2066 6f72 2076 616c 6964 y GRUB for valid │ │ │ │ │ +0002eef0: 6174 696e 6720 7369 676e 6174 7572 6573 ating signatures │ │ │ │ │ +0002ef00: 2e0a 2020 2020 2054 6865 206f 7574 7075 .. The outpu │ │ │ │ │ +0002ef10: 7420 6973 2069 6e20 4750 4727 7320 7634 t is in GPG's v4 │ │ │ │ │ +0002ef20: 206b 6579 2066 696e 6765 7270 7269 6e74 key fingerprint │ │ │ │ │ +0002ef30: 2066 6f72 6d61 7420 2869 2e65 2e2c 2074 format (i.e., t │ │ │ │ │ +0002ef40: 6865 206f 7574 7075 740a 2020 2020 206f he output. o │ │ │ │ │ +0002ef50: 6620 2767 7067 202d 2d66 696e 6765 7270 f 'gpg --fingerp │ │ │ │ │ +0002ef60: 7269 6e74 2729 2e20 2054 6865 206c 6561 rint'). The lea │ │ │ │ │ +0002ef70: 7374 2073 6967 6e69 6669 6361 6e74 2066 st significant f │ │ │ │ │ +0002ef80: 6f75 7220 6279 7465 7320 286c 6173 740a our bytes (last. │ │ │ │ │ +0002ef90: 2020 2020 2065 6967 6874 2068 6578 6164 eight hexad │ │ │ │ │ +0002efa0: 6563 696d 616c 2064 6967 6974 7329 2063 ecimal digits) c │ │ │ │ │ +0002efb0: 616e 2062 6520 7573 6564 2061 7320 616e an be used as an │ │ │ │ │ +0002efc0: 2061 7267 756d 656e 7420 746f 2027 6469 argument to 'di │ │ │ │ │ +0002efd0: 7374 7275 7374 270a 2020 2020 2028 2a6e strust'. (*n │ │ │ │ │ +0002efe0: 6f74 6520 6469 7374 7275 7374 3a3a 292e ote distrust::). │ │ │ │ │ +0002eff0: 2020 2a4e 6f74 6520 5573 696e 6720 6469 *Note Using di │ │ │ │ │ +0002f000: 6769 7461 6c20 7369 676e 6174 7572 6573 gital signatures │ │ │ │ │ +0002f010: 3a3a 2c20 666f 7220 6d6f 7265 0a20 2020 ::, for more. │ │ │ │ │ +0002f020: 2020 696e 666f 726d 6174 696f 6e20 6162 information ab │ │ │ │ │ +0002f030: 6f75 7420 7573 6573 2066 6f72 2074 6865 out uses for the │ │ │ │ │ +0002f040: 7365 206b 6579 732e 0a0a 1f0a 4669 6c65 se keys.....File │ │ │ │ │ +0002f050: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ +0002f060: 6465 3a20 6c6f 6164 5f65 6e76 2c20 204e de: load_env, N │ │ │ │ │ +0002f070: 6578 743a 206c 6f61 6466 6f6e 742c 2020 ext: loadfont, │ │ │ │ │ +0002f080: 5072 6576 3a20 6c69 7374 5f74 7275 7374 Prev: list_trust │ │ │ │ │ +0002f090: 6564 2c20 2055 703a 2043 6f6d 6d61 6e64 ed, Up: Command │ │ │ │ │ +0002f0a0: 2d6c 696e 6520 616e 6420 6d65 6e75 2065 -line and menu e │ │ │ │ │ +0002f0b0: 6e74 7279 2063 6f6d 6d61 6e64 730a 0a31 ntry commands..1 │ │ │ │ │ +0002f0c0: 362e 332e 3432 206c 6f61 645f 656e 760a 6.3.42 load_env. │ │ │ │ │ +0002f0d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ +0002f0e0: 0a0a 202d 2d20 436f 6d6d 616e 643a 206c .. -- Command: l │ │ │ │ │ +0002f0f0: 6f61 645f 656e 7620 5b2d 2d66 696c 6520 oad_env [--file │ │ │ │ │ +0002f100: 6669 6c65 5d20 5b2d 2d73 6b69 702d 7369 file] [--skip-si │ │ │ │ │ +0002f110: 675d 0a20 2020 2020 2020 2020 205b 7768 g]. [wh │ │ │ │ │ +0002f120: 6974 656c 6973 7465 645f 7661 7269 6162 itelisted_variab │ │ │ │ │ +0002f130: 6c65 5f6e 616d 655d 202e 2e2e 0a20 2020 le_name] .... │ │ │ │ │ +0002f140: 2020 4c6f 6164 2061 6c6c 2076 6172 6961 Load all varia │ │ │ │ │ +0002f150: 626c 6573 2066 726f 6d20 7468 6520 656e bles from the en │ │ │ │ │ +0002f160: 7669 726f 6e6d 656e 7420 626c 6f63 6b20 vironment block │ │ │ │ │ +0002f170: 6669 6c65 2069 6e74 6f20 7468 650a 2020 file into the. │ │ │ │ │ +0002f180: 2020 2065 6e76 6972 6f6e 6d65 6e74 2e20 environment. │ │ │ │ │ +0002f190: 202a 4e6f 7465 2045 6e76 6972 6f6e 6d65 *Note Environme │ │ │ │ │ +0002f1a0: 6e74 2062 6c6f 636b 3a3a 2e0a 0a20 2020 nt block::... │ │ │ │ │ +0002f1b0: 2020 5468 6520 272d 2d66 696c 6527 206f The '--file' o │ │ │ │ │ +0002f1c0: 7074 696f 6e20 6f76 6572 7269 6465 7320 ption overrides │ │ │ │ │ +0002f1d0: 7468 6520 6465 6661 756c 7420 6c6f 6361 the default loca │ │ │ │ │ +0002f1e0: 7469 6f6e 206f 6620 7468 650a 2020 2020 tion of the. │ │ │ │ │ +0002f1f0: 2065 6e76 6972 6f6e 6d65 6e74 2062 6c6f environment blo │ │ │ │ │ +0002f200: 636b 2e0a 0a20 2020 2020 5468 6520 272d ck... The '- │ │ │ │ │ +0002f210: 2d73 6b69 702d 7369 6727 206f 7074 696f -skip-sig' optio │ │ │ │ │ +0002f220: 6e20 736b 6970 7320 7369 676e 6174 7572 n skips signatur │ │ │ │ │ +0002f230: 6520 6368 6563 6b69 6e67 2065 7665 6e20 e checking even │ │ │ │ │ +0002f240: 7768 656e 2074 6865 0a20 2020 2020 7661 when the. va │ │ │ │ │ +0002f250: 6c75 6520 6f66 2065 6e76 6972 6f6e 6d65 lue of environme │ │ │ │ │ +0002f260: 6e74 2076 6172 6961 626c 6520 2763 6865 nt variable 'che │ │ │ │ │ +0002f270: 636b 5f73 6967 6e61 7475 7265 7327 2069 ck_signatures' i │ │ │ │ │ +0002f280: 7320 7365 7420 746f 0a20 2020 2020 2765 s set to. 'e │ │ │ │ │ +0002f290: 6e66 6f72 6365 2720 282a 6e6f 7465 2063 nforce' (*note c │ │ │ │ │ +0002f2a0: 6865 636b 5f73 6967 6e61 7475 7265 733a heck_signatures: │ │ │ │ │ +0002f2b0: 3a29 2e0a 0a20 2020 2020 4966 206f 6e65 :)... If one │ │ │ │ │ +0002f2c0: 206f 7220 6d6f 7265 2076 6172 6961 626c or more variabl │ │ │ │ │ +0002f2d0: 6520 6e61 6d65 7320 6172 6520 7072 6f76 e names are prov │ │ │ │ │ +0002f2e0: 6964 6564 2061 7320 6172 6775 6d65 6e74 ided as argument │ │ │ │ │ +0002f2f0: 732c 2074 6865 7920 6172 650a 2020 2020 s, they are. │ │ │ │ │ +0002f300: 2069 6e74 6572 7072 6574 6564 2061 7320 interpreted as │ │ │ │ │ +0002f310: 6120 7768 6974 656c 6973 7420 6f66 2076 a whitelist of v │ │ │ │ │ +0002f320: 6172 6961 626c 6573 2074 6f20 6c6f 6164 ariables to load │ │ │ │ │ +0002f330: 2066 726f 6d20 7468 650a 2020 2020 2065 from the. e │ │ │ │ │ +0002f340: 6e76 6972 6f6e 6d65 6e74 2062 6c6f 636b nvironment block │ │ │ │ │ +0002f350: 2066 696c 652e 2020 5661 7269 6162 6c65 file. Variable │ │ │ │ │ +0002f360: 7320 7365 7420 696e 2074 6865 2066 696c s set in the fil │ │ │ │ │ +0002f370: 6520 6275 7420 6e6f 7420 7072 6573 656e e but not presen │ │ │ │ │ +0002f380: 740a 2020 2020 2069 6e20 7468 6520 7768 t. in the wh │ │ │ │ │ +0002f390: 6974 656c 6973 7420 6172 6520 6967 6e6f itelist are igno │ │ │ │ │ +0002f3a0: 7265 642e 0a0a 2020 2020 2054 6865 2027 red... The ' │ │ │ │ │ +0002f3b0: 2d2d 736b 6970 2d73 6967 2720 6f70 7469 --skip-sig' opti │ │ │ │ │ +0002f3c0: 6f6e 2073 686f 756c 6420 6265 2075 7365 on should be use │ │ │ │ │ +0002f3d0: 6420 7769 7468 2063 6172 652c 2061 6e64 d with care, and │ │ │ │ │ +0002f3e0: 2073 686f 756c 6420 616c 7761 7973 0a20 should always. │ │ │ │ │ +0002f3f0: 2020 2020 6265 2075 7365 6420 696e 2063 be used in c │ │ │ │ │ +0002f400: 6f6e 6365 7274 2077 6974 6820 6120 7768 oncert with a wh │ │ │ │ │ +0002f410: 6974 656c 6973 7420 6f66 2061 6363 6570 itelist of accep │ │ │ │ │ +0002f420: 7461 626c 6520 7661 7269 6162 6c65 7320 table variables │ │ │ │ │ +0002f430: 7768 6f73 650a 2020 2020 2076 616c 7565 whose. value │ │ │ │ │ +0002f440: 7320 7368 6f75 6c64 2062 6520 7365 742e s should be set. │ │ │ │ │ +0002f450: 2020 4661 696c 7572 6520 746f 2065 6d70 Failure to emp │ │ │ │ │ +0002f460: 6c6f 7920 6120 6361 7265 6675 6c6c 7920 loy a carefully │ │ │ │ │ +0002f470: 636f 6e73 7472 7563 7465 640a 2020 2020 constructed. │ │ │ │ │ +0002f480: 2077 6869 7465 6c69 7374 2063 6f75 6c64 whitelist could │ │ │ │ │ +0002f490: 2072 6573 756c 7420 696e 2072 6561 6469 result in readi │ │ │ │ │ +0002f4a0: 6e67 2061 206d 616c 6963 696f 7573 2076 ng a malicious v │ │ │ │ │ +0002f4b0: 616c 7565 2069 6e74 6f20 6372 6974 6963 alue into critic │ │ │ │ │ +0002f4c0: 616c 0a20 2020 2020 656e 7669 726f 6e6d al. environm │ │ │ │ │ +0002f4d0: 656e 7420 7661 7269 6162 6c65 7320 6672 ent variables fr │ │ │ │ │ +0002f4e0: 6f6d 2074 6865 2066 696c 652c 2073 7563 om the file, suc │ │ │ │ │ +0002f4f0: 6820 6173 2073 6574 7469 6e67 0a20 2020 h as setting. │ │ │ │ │ +0002f500: 2020 2763 6865 636b 5f73 6967 6e61 7475 'check_signatu │ │ │ │ │ +0002f510: 7265 733d 6e6f 272c 206d 6f64 6966 7969 res=no', modifyi │ │ │ │ │ +0002f520: 6e67 2027 7072 6566 6978 2720 746f 2062 ng 'prefix' to b │ │ │ │ │ +0002f530: 6f6f 7420 6672 6f6d 2061 6e0a 2020 2020 oot from an. │ │ │ │ │ +0002f540: 2075 6e65 7870 6563 7465 6420 6c6f 6361 unexpected loca │ │ │ │ │ +0002f550: 7469 6f6e 206f 7220 6e6f 7420 6174 2061 tion or not at a │ │ │ │ │ +0002f560: 6c6c 2c20 6574 632e 0a0a 2020 2020 2057 ll, etc... W │ │ │ │ │ +0002f570: 6865 6e20 7573 6564 2077 6974 6820 6361 hen used with ca │ │ │ │ │ +0002f580: 7265 2c20 272d 2d73 6b69 702d 7369 6727 re, '--skip-sig' │ │ │ │ │ +0002f590: 2061 6e64 2074 6865 2077 6869 7465 6c69 and the whiteli │ │ │ │ │ +0002f5a0: 7374 2065 6e61 626c 6520 616e 0a20 2020 st enable an. │ │ │ │ │ +0002f5b0: 2020 6164 6d69 6e69 7374 7261 746f 7220 administrator │ │ │ │ │ +0002f5c0: 746f 2063 6f6e 6669 6775 7265 2061 2073 to configure a s │ │ │ │ │ +0002f5d0: 7973 7465 6d20 746f 2062 6f6f 7420 6f6e ystem to boot on │ │ │ │ │ +0002f5e0: 6c79 2073 6967 6e65 640a 2020 2020 2063 ly signed. c │ │ │ │ │ +0002f5f0: 6f6e 6669 6775 7261 7469 6f6e 732c 2062 onfigurations, b │ │ │ │ │ +0002f600: 7574 2074 6f20 616c 6c6f 7720 7468 6520 ut to allow the │ │ │ │ │ +0002f610: 7573 6572 2074 6f20 7365 6c65 6374 2066 user to select f │ │ │ │ │ +0002f620: 726f 6d20 616d 6f6e 6720 6d75 6c74 6970 rom among multip │ │ │ │ │ +0002f630: 6c65 0a20 2020 2020 636f 6e66 6967 7572 le. configur │ │ │ │ │ +0002f640: 6174 696f 6e73 2c20 616e 6420 746f 2065 ations, and to e │ │ │ │ │ +0002f650: 6e61 626c 6520 226f 6e65 2d73 686f 7422 nable "one-shot" │ │ │ │ │ +0002f660: 2062 6f6f 7420 6174 7465 6d70 7473 2061 boot attempts a │ │ │ │ │ +0002f670: 6e64 0a20 2020 2020 2273 6176 6564 6566 nd. "savedef │ │ │ │ │ +0002f680: 6175 6c74 2220 6265 6861 7669 6f72 2e20 ault" behavior. │ │ │ │ │ +0002f690: 202a 4e6f 7465 2055 7369 6e67 2064 6967 *Note Using dig │ │ │ │ │ +0002f6a0: 6974 616c 2073 6967 6e61 7475 7265 733a ital signatures: │ │ │ │ │ +0002f6b0: 3a2c 2066 6f72 206d 6f72 650a 2020 2020 :, for more. │ │ │ │ │ +0002f6c0: 2069 6e66 6f72 6d61 7469 6f6e 2e0a 0a1f information.... │ │ │ │ │ +0002f6d0: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ +0002f6e0: 2c20 204e 6f64 653a 206c 6f61 6466 6f6e , Node: loadfon │ │ │ │ │ +0002f6f0: 742c 2020 4e65 7874 3a20 6c6f 6f70 6261 t, Next: loopba │ │ │ │ │ +0002f700: 636b 2c20 2050 7265 763a 206c 6f61 645f ck, Prev: load_ │ │ │ │ │ +0002f710: 656e 762c 2020 5570 3a20 436f 6d6d 616e env, Up: Comman │ │ │ │ │ +0002f720: 642d 6c69 6e65 2061 6e64 206d 656e 7520 d-line and menu │ │ │ │ │ +0002f730: 656e 7472 7920 636f 6d6d 616e 6473 0a0a entry commands.. │ │ │ │ │ +0002f740: 3136 2e33 2e34 3320 6c6f 6164 666f 6e74 16.3.43 loadfont │ │ │ │ │ +0002f750: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ │ +0002f760: 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 -.. -- Command: │ │ │ │ │ +0002f770: 6c6f 6164 666f 6e74 2066 696c 6520 2e2e loadfont file .. │ │ │ │ │ +0002f780: 2e0a 2020 2020 204c 6f61 6420 7370 6563 .. Load spec │ │ │ │ │ +0002f790: 6966 6965 6420 666f 6e74 2066 696c 6573 ified font files │ │ │ │ │ +0002f7a0: 2e20 2055 6e6c 6573 7320 6162 736f 6c75 . Unless absolu │ │ │ │ │ +0002f7b0: 7465 2070 6174 686e 616d 6520 6973 2067 te pathname is g │ │ │ │ │ +0002f7c0: 6976 656e 2c20 4649 4c45 0a20 2020 2020 iven, FILE. │ │ │ │ │ +0002f7d0: 6973 2061 7373 756d 6564 2074 6f20 6265 is assumed to be │ │ │ │ │ +0002f7e0: 2069 6e20 6469 7265 6374 6f72 7920 2724 in directory '$ │ │ │ │ │ +0002f7f0: 7072 6566 6978 2f66 6f6e 7473 2720 7769 prefix/fonts' wi │ │ │ │ │ +0002f800: 7468 2073 7566 6669 7820 272e 7066 3227 th suffix '.pf2' │ │ │ │ │ +0002f810: 0a20 2020 2020 6170 7065 6e64 6564 2e20 . appended. │ │ │ │ │ +0002f820: 202a 4e6f 7465 2046 6f6e 7473 3a20 5468 *Note Fonts: Th │ │ │ │ │ +0002f830: 656d 6520 6669 6c65 2066 6f72 6d61 742e eme file format. │ │ │ │ │ +0002f840: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ +0002f850: 6e66 6f2c 2020 4e6f 6465 3a20 6c6f 6f70 nfo, Node: loop │ │ │ │ │ +0002f860: 6261 636b 2c20 204e 6578 743a 206c 732c back, Next: ls, │ │ │ │ │ +0002f870: 2020 5072 6576 3a20 6c6f 6164 666f 6e74 Prev: loadfont │ │ │ │ │ +0002f880: 2c20 2055 703a 2043 6f6d 6d61 6e64 2d6c , Up: Command-l │ │ │ │ │ +0002f890: 696e 6520 616e 6420 6d65 6e75 2065 6e74 ine and menu ent │ │ │ │ │ +0002f8a0: 7279 2063 6f6d 6d61 6e64 730a 0a31 362e ry commands..16. │ │ │ │ │ +0002f8b0: 332e 3434 206c 6f6f 7062 6163 6b0a 2d2d 3.44 loopback.-- │ │ │ │ │ +0002f8c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ +0002f8d0: 202d 2d20 436f 6d6d 616e 643a 206c 6f6f -- Command: loo │ │ │ │ │ +0002f8e0: 7062 6163 6b20 5b2d 645d 2064 6576 6963 pback [-d] devic │ │ │ │ │ +0002f8f0: 6520 6669 6c65 0a20 2020 2020 4d61 6b65 e file. Make │ │ │ │ │ +0002f900: 2074 6865 2064 6576 6963 6520 6e61 6d65 the device name │ │ │ │ │ +0002f910: 6420 4445 5649 4345 2063 6f72 7265 7370 d DEVICE corresp │ │ │ │ │ +0002f920: 6f6e 6420 746f 2074 6865 2063 6f6e 7465 ond to the conte │ │ │ │ │ +0002f930: 6e74 7320 6f66 2074 6865 0a20 2020 2020 nts of the. │ │ │ │ │ +0002f940: 6669 6c65 7379 7374 656d 2069 6d61 6765 filesystem image │ │ │ │ │ +0002f950: 2069 6e20 4649 4c45 2e20 2046 6f72 2065 in FILE. For e │ │ │ │ │ +0002f960: 7861 6d70 6c65 3a0a 0a20 2020 2020 2020 xample:.. │ │ │ │ │ +0002f970: 2020 206c 6f6f 7062 6163 6b20 6c6f 6f70 loopback loop │ │ │ │ │ +0002f980: 3020 2f70 6174 682f 746f 2f69 6d61 6765 0 /path/to/image │ │ │ │ │ +0002f990: 0a20 2020 2020 2020 2020 206c 7320 286c . ls (l │ │ │ │ │ +0002f9a0: 6f6f 7030 292f 0a0a 2020 2020 2057 6974 oop0)/.. Wit │ │ │ │ │ +0002f9b0: 6820 7468 6520 272d 6427 206f 7074 696f h the '-d' optio │ │ │ │ │ +0002f9c0: 6e2c 2064 656c 6574 6520 6120 6465 7669 n, delete a devi │ │ │ │ │ +0002f9d0: 6365 2070 7265 7669 6f75 736c 7920 6372 ce previously cr │ │ │ │ │ +0002f9e0: 6561 7465 6420 7573 696e 6720 7468 6973 eated using this │ │ │ │ │ +0002f9f0: 0a20 2020 2020 636f 6d6d 616e 642e 0a0a . command... │ │ │ │ │ +0002fa00: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ +0002fa10: 6f2c 2020 4e6f 6465 3a20 6c73 2c20 204e o, Node: ls, N │ │ │ │ │ +0002fa20: 6578 743a 206c 7366 6f6e 7473 2c20 2050 ext: lsfonts, P │ │ │ │ │ +0002fa30: 7265 763a 206c 6f6f 7062 6163 6b2c 2020 rev: loopback, │ │ │ │ │ +0002fa40: 5570 3a20 436f 6d6d 616e 642d 6c69 6e65 Up: Command-line │ │ │ │ │ +0002fa50: 2061 6e64 206d 656e 7520 656e 7472 7920 and menu entry │ │ │ │ │ +0002fa60: 636f 6d6d 616e 6473 0a0a 3136 2e33 2e34 commands..16.3.4 │ │ │ │ │ +0002fa70: 3520 6c73 0a2d 2d2d 2d2d 2d2d 2d2d 2d0a 5 ls.----------. │ │ │ │ │ +0002fa80: 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 6c73 . -- Command: ls │ │ │ │ │ +0002fa90: 205b 6172 6720 2e2e 2e5d 0a20 2020 2020 [arg ...]. │ │ │ │ │ +0002faa0: 4c69 7374 2064 6576 6963 6573 206f 7220 List devices or │ │ │ │ │ +0002fab0: 6669 6c65 732e 0a0a 2020 2020 2057 6974 files... Wit │ │ │ │ │ +0002fac0: 6820 6e6f 2061 7267 756d 656e 7473 2c20 h no arguments, │ │ │ │ │ +0002fad0: 7072 696e 7420 616c 6c20 6465 7669 6365 print all device │ │ │ │ │ +0002fae0: 7320 6b6e 6f77 6e20 746f 2047 5255 422e s known to GRUB. │ │ │ │ │ +0002faf0: 0a0a 2020 2020 2049 6620 7468 6520 6172 .. If the ar │ │ │ │ │ +0002fb00: 6775 6d65 6e74 2069 7320 6120 6465 7669 gument is a devi │ │ │ │ │ +0002fb10: 6365 206e 616d 6520 656e 636c 6f73 6564 ce name enclosed │ │ │ │ │ +0002fb20: 2069 6e20 7061 7265 6e74 6865 7365 7320 in parentheses │ │ │ │ │ +0002fb30: 282a 6e6f 7465 0a20 2020 2020 4465 7669 (*note. Devi │ │ │ │ │ +0002fb40: 6365 2073 796e 7461 783a 3a29 2c20 7468 ce syntax::), th │ │ │ │ │ +0002fb50: 656e 2070 7269 6e74 2074 6865 206e 616d en print the nam │ │ │ │ │ +0002fb60: 6520 6f66 2074 6865 2066 696c 6573 7973 e of the filesys │ │ │ │ │ +0002fb70: 7465 6d20 6f66 2074 6861 740a 2020 2020 tem of that. │ │ │ │ │ +0002fb80: 2064 6576 6963 652e 0a0a 2020 2020 2049 device... I │ │ │ │ │ +0002fb90: 6620 7468 6520 6172 6775 6d65 6e74 2069 f the argument i │ │ │ │ │ +0002fba0: 7320 6120 6469 7265 6374 6f72 7920 6769 s a directory gi │ │ │ │ │ +0002fbb0: 7665 6e20 6173 2061 6e20 6162 736f 6c75 ven as an absolu │ │ │ │ │ +0002fbc0: 7465 2066 696c 6520 6e61 6d65 0a20 2020 te file name. │ │ │ │ │ +0002fbd0: 2020 282a 6e6f 7465 2046 696c 6520 6e61 (*note File na │ │ │ │ │ +0002fbe0: 6d65 2073 796e 7461 783a 3a29 2c20 7468 me syntax::), th │ │ │ │ │ +0002fbf0: 656e 206c 6973 7420 7468 6520 636f 6e74 en list the cont │ │ │ │ │ +0002fc00: 656e 7473 206f 6620 7468 6174 0a20 2020 ents of that. │ │ │ │ │ +0002fc10: 2020 6469 7265 6374 6f72 792e 0a0a 1f0a directory..... │ │ │ │ │ +0002fc20: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ +0002fc30: 2020 4e6f 6465 3a20 6c73 666f 6e74 732c Node: lsfonts, │ │ │ │ │ +0002fc40: 2020 4e65 7874 3a20 6c73 6d6f 642c 2020 Next: lsmod, │ │ │ │ │ +0002fc50: 5072 6576 3a20 6c73 2c20 2055 703a 2043 Prev: ls, Up: C │ │ │ │ │ +0002fc60: 6f6d 6d61 6e64 2d6c 696e 6520 616e 6420 ommand-line and │ │ │ │ │ +0002fc70: 6d65 6e75 2065 6e74 7279 2063 6f6d 6d61 menu entry comma │ │ │ │ │ +0002fc80: 6e64 730a 0a31 362e 332e 3436 206c 7366 nds..16.3.46 lsf │ │ │ │ │ +0002fc90: 6f6e 7473 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d onts.----------- │ │ │ │ │ +0002fca0: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ │ +0002fcb0: 643a 206c 7366 6f6e 7473 0a20 2020 2020 d: lsfonts. │ │ │ │ │ +0002fcc0: 4c69 7374 206c 6f61 6465 6420 666f 6e74 List loaded font │ │ │ │ │ +0002fcd0: 732e 0a0a 1f0a 4669 6c65 3a20 6772 7562 s.....File: grub │ │ │ │ │ +0002fce0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 6c73 .info, Node: ls │ │ │ │ │ +0002fcf0: 6d6f 642c 2020 4e65 7874 3a20 6d64 3573 mod, Next: md5s │ │ │ │ │ +0002fd00: 756d 2c20 2050 7265 763a 206c 7366 6f6e um, Prev: lsfon │ │ │ │ │ +0002fd10: 7473 2c20 2055 703a 2043 6f6d 6d61 6e64 ts, Up: Command │ │ │ │ │ +0002fd20: 2d6c 696e 6520 616e 6420 6d65 6e75 2065 -line and menu e │ │ │ │ │ +0002fd30: 6e74 7279 2063 6f6d 6d61 6e64 730a 0a31 ntry commands..1 │ │ │ │ │ +0002fd40: 362e 332e 3437 206c 736d 6f64 0a2d 2d2d 6.3.47 lsmod.--- │ │ │ │ │ +0002fd50: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 ----------.. -- │ │ │ │ │ +0002fd60: 436f 6d6d 616e 643a 206c 736d 6f64 0a20 Command: lsmod. │ │ │ │ │ +0002fd70: 2020 2020 5368 6f77 206c 6973 7420 6f66 Show list of │ │ │ │ │ +0002fd80: 206c 6f61 6465 6420 6d6f 6475 6c65 732e loaded modules. │ │ │ │ │ +0002fd90: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ +0002fda0: 6e66 6f2c 2020 4e6f 6465 3a20 6d64 3573 nfo, Node: md5s │ │ │ │ │ +0002fdb0: 756d 2c20 204e 6578 743a 206d 6f64 756c um, Next: modul │ │ │ │ │ +0002fdc0: 652c 2020 5072 6576 3a20 6c73 6d6f 642c e, Prev: lsmod, │ │ │ │ │ +0002fdd0: 2020 5570 3a20 436f 6d6d 616e 642d 6c69 Up: Command-li │ │ │ │ │ +0002fde0: 6e65 2061 6e64 206d 656e 7520 656e 7472 ne and menu entr │ │ │ │ │ +0002fdf0: 7920 636f 6d6d 616e 6473 0a0a 3136 2e33 y commands..16.3 │ │ │ │ │ +0002fe00: 2e34 3820 6d64 3573 756d 0a2d 2d2d 2d2d .48 md5sum.----- │ │ │ │ │ +0002fe10: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 ---------.. -- C │ │ │ │ │ +0002fe20: 6f6d 6d61 6e64 3a20 6d64 3573 756d 2061 ommand: md5sum a │ │ │ │ │ +0002fe30: 7267 202e 2e2e 0a20 2020 2020 416c 6961 rg .... Alia │ │ │ │ │ +0002fe40: 7320 666f 7220 2768 6173 6873 756d 202d s for 'hashsum - │ │ │ │ │ +0002fe50: 2d68 6173 6820 6d64 3520 6172 6720 2e2e -hash md5 arg .. │ │ │ │ │ +0002fe60: 2e27 2e20 2053 6565 2063 6f6d 6d61 6e64 .'. See command │ │ │ │ │ +0002fe70: 2027 6861 7368 7375 6d27 0a20 2020 2020 'hashsum'. │ │ │ │ │ +0002fe80: 282a 6e6f 7465 2068 6173 6873 756d 3a3a (*note hashsum:: │ │ │ │ │ +0002fe90: 2920 666f 7220 6675 6c6c 2064 6573 6372 ) for full descr │ │ │ │ │ +0002fea0: 6970 7469 6f6e 2e0a 0a1f 0a46 696c 653a iption.....File: │ │ │ │ │ +0002feb0: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ +0002fec0: 653a 206d 6f64 756c 652c 2020 4e65 7874 e: module, Next │ │ │ │ │ +0002fed0: 3a20 6d75 6c74 6962 6f6f 742c 2020 5072 : multiboot, Pr │ │ │ │ │ +0002fee0: 6576 3a20 6d64 3573 756d 2c20 2055 703a ev: md5sum, Up: │ │ │ │ │ +0002fef0: 2043 6f6d 6d61 6e64 2d6c 696e 6520 616e Command-line an │ │ │ │ │ +0002ff00: 6420 6d65 6e75 2065 6e74 7279 2063 6f6d d menu entry com │ │ │ │ │ +0002ff10: 6d61 6e64 730a 0a31 362e 332e 3439 206d mands..16.3.49 m │ │ │ │ │ +0002ff20: 6f64 756c 650a 2d2d 2d2d 2d2d 2d2d 2d2d odule.---------- │ │ │ │ │ +0002ff30: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ │ +0002ff40: 643a 206d 6f64 756c 6520 5b2d 2d6e 6f75 d: module [--nou │ │ │ │ │ +0002ff50: 6e7a 6970 5d20 6669 6c65 205b 6172 6775 nzip] file [argu │ │ │ │ │ +0002ff60: 6d65 6e74 735d 0a20 2020 2020 4c6f 6164 ments]. Load │ │ │ │ │ +0002ff70: 2061 206d 6f64 756c 6520 666f 7220 6d75 a module for mu │ │ │ │ │ +0002ff80: 6c74 6962 6f6f 7420 6b65 726e 656c 2069 ltiboot kernel i │ │ │ │ │ +0002ff90: 6d61 6765 2e20 2054 6865 2072 6573 7420 mage. The rest │ │ │ │ │ +0002ffa0: 6f66 2074 6865 206c 696e 6520 6973 0a20 of the line is. │ │ │ │ │ +0002ffb0: 2020 2020 7061 7373 6564 2076 6572 6261 passed verba │ │ │ │ │ +0002ffc0: 7469 6d20 6173 2074 6865 206d 6f64 756c tim as the modul │ │ │ │ │ +0002ffd0: 6520 636f 6d6d 616e 6420 6c69 6e65 2e0a e command line.. │ │ │ │ │ +0002ffe0: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ +0002fff0: 666f 2c20 204e 6f64 653a 206d 756c 7469 fo, Node: multi │ │ │ │ │ +00030000: 626f 6f74 2c20 204e 6578 743a 206e 6174 boot, Next: nat │ │ │ │ │ +00030010: 6976 6564 6973 6b2c 2020 5072 6576 3a20 ivedisk, Prev: │ │ │ │ │ +00030020: 6d6f 6475 6c65 2c20 2055 703a 2043 6f6d module, Up: Com │ │ │ │ │ +00030030: 6d61 6e64 2d6c 696e 6520 616e 6420 6d65 mand-line and me │ │ │ │ │ +00030040: 6e75 2065 6e74 7279 2063 6f6d 6d61 6e64 nu entry command │ │ │ │ │ +00030050: 730a 0a31 362e 332e 3530 206d 756c 7469 s..16.3.50 multi │ │ │ │ │ +00030060: 626f 6f74 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d boot.----------- │ │ │ │ │ +00030070: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ │ +00030080: 616e 643a 206d 756c 7469 626f 6f74 205b and: multiboot [ │ │ │ │ │ +00030090: 2d2d 7175 6972 6b2d 6261 642d 6b6c 7564 --quirk-bad-klud │ │ │ │ │ +000300a0: 6765 5d0a 2020 2020 2020 2020 2020 5b2d ge]. [- │ │ │ │ │ +000300b0: 2d71 7569 726b 2d6d 6f64 756c 6573 2d61 -quirk-modules-a │ │ │ │ │ +000300c0: 6674 6572 2d6b 6572 6e65 6c5d 2066 696c fter-kernel] fil │ │ │ │ │ +000300d0: 6520 2e2e 2e0a 2020 2020 204c 6f61 6420 e .... Load │ │ │ │ │ +000300e0: 6120 6d75 6c74 6962 6f6f 7420 6b65 726e a multiboot kern │ │ │ │ │ +000300f0: 656c 2069 6d61 6765 2066 726f 6d20 4649 el image from FI │ │ │ │ │ +00030100: 4c45 2e20 2054 6865 2072 6573 7420 6f66 LE. The rest of │ │ │ │ │ +00030110: 2074 6865 206c 696e 6520 6973 0a20 2020 the line is. │ │ │ │ │ +00030120: 2020 7061 7373 6564 2076 6572 6261 7469 passed verbati │ │ │ │ │ +00030130: 6d20 6173 2074 6865 2022 6b65 726e 656c m as the "kernel │ │ │ │ │ +00030140: 2063 6f6d 6d61 6e64 2d6c 696e 6522 2e20 command-line". │ │ │ │ │ +00030150: 2041 6e79 206d 6f64 756c 6520 6d75 7374 Any module must │ │ │ │ │ +00030160: 2062 650a 2020 2020 2072 656c 6f61 6465 be. reloade │ │ │ │ │ +00030170: 6420 6166 7465 7220 7573 696e 6720 7468 d after using th │ │ │ │ │ +00030180: 6973 2063 6f6d 6d61 6e64 2028 2a6e 6f74 is command (*not │ │ │ │ │ +00030190: 6520 6d6f 6475 6c65 3a3a 292e 0a0a 2020 e module::)... │ │ │ │ │ +000301a0: 2020 2053 6f6d 6520 6b65 726e 656c 7320 Some kernels │ │ │ │ │ +000301b0: 6861 7665 206b 6e6f 776e 2070 726f 626c have known probl │ │ │ │ │ +000301c0: 656d 732e 2020 596f 7520 6e65 6564 2074 ems. You need t │ │ │ │ │ +000301d0: 6f20 7370 6563 6966 7920 2d71 7569 726b o specify -quirk │ │ │ │ │ +000301e0: 2d2a 2066 6f72 0a20 2020 2020 7468 6f73 -* for. thos │ │ │ │ │ +000301f0: 652e 2020 2d71 7569 726b 2d62 6164 2d6b e. -quirk-bad-k │ │ │ │ │ +00030200: 6c75 6467 6520 6973 2061 2070 726f 626c ludge is a probl │ │ │ │ │ +00030210: 656d 2073 6565 6e20 696e 2073 6576 6572 em seen in sever │ │ │ │ │ +00030220: 616c 2070 726f 6475 6374 730a 2020 2020 al products. │ │ │ │ │ +00030230: 2074 6861 7420 7468 6579 2069 6e63 6c75 that they inclu │ │ │ │ │ +00030240: 6465 206c 6f61 6469 6e67 206b 6c75 6467 de loading kludg │ │ │ │ │ +00030250: 6520 696e 666f 726d 6174 696f 6e20 7769 e information wi │ │ │ │ │ +00030260: 7468 2069 6e76 616c 6964 2064 6174 6120 th invalid data │ │ │ │ │ +00030270: 696e 0a20 2020 2020 454c 4620 6669 6c65 in. ELF file │ │ │ │ │ +00030280: 2e20 2047 5255 4220 7072 696f 7220 746f . GRUB prior to │ │ │ │ │ +00030290: 2030 2e39 3720 616e 6420 736f 6d65 2063 0.97 and some c │ │ │ │ │ +000302a0: 7573 746f 6d20 6275 696c 6473 2070 7265 ustom builds pre │ │ │ │ │ +000302b0: 6665 7272 6564 2045 4c46 0a20 2020 2020 ferred ELF. │ │ │ │ │ +000302c0: 696e 666f 726d 6174 696f 6e20 7768 696c information whil │ │ │ │ │ +000302d0: 6520 302e 3937 2061 6e64 2047 5255 4220 e 0.97 and GRUB │ │ │ │ │ +000302e0: 3220 7573 6520 6b6c 7564 6765 2e20 2055 2 use kludge. U │ │ │ │ │ +000302f0: 7365 2074 6869 7320 6f70 7469 6f6e 2074 se this option t │ │ │ │ │ +00030300: 6f0a 2020 2020 2069 676e 6f72 6520 6b6c o. ignore kl │ │ │ │ │ +00030310: 7564 6765 2e20 204b 6e6f 776e 2061 6666 udge. Known aff │ │ │ │ │ +00030320: 6563 7465 6420 7379 7374 656d 733a 206f ected systems: o │ │ │ │ │ +00030330: 6c64 2053 6f6c 6172 6973 2c20 536b 794f ld Solaris, SkyO │ │ │ │ │ +00030340: 532e 0a0a 2020 2020 202d 7175 6972 6b2d S... -quirk- │ │ │ │ │ +00030350: 6d6f 6475 6c65 732d 6166 7465 722d 6b65 modules-after-ke │ │ │ │ │ +00030360: 726e 656c 2069 7320 6e65 6564 6564 2066 rnel is needed f │ │ │ │ │ +00030370: 6f72 206b 6572 6e65 6c73 2077 6869 6368 or kernels which │ │ │ │ │ +00030380: 206c 6f61 6420 6174 0a20 2020 2020 7265 load at. re │ │ │ │ │ +00030390: 6c61 7469 7665 6c79 2068 6967 6820 6164 latively high ad │ │ │ │ │ +000303a0: 6472 6573 7320 652e 672e 2020 3136 4d69 dress e.g. 16Mi │ │ │ │ │ +000303b0: 4220 6d61 726b 2061 6e64 2063 616e 2774 B mark and can't │ │ │ │ │ +000303c0: 2063 6f70 6520 7769 7468 0a20 2020 2020 cope with. │ │ │ │ │ +000303d0: 6d6f 6475 6c65 7320 7374 7566 6665 6420 modules stuffed │ │ │ │ │ +000303e0: 6265 7477 6565 6e20 314d 6942 206d 6172 between 1MiB mar │ │ │ │ │ +000303f0: 6b20 616e 6420 6265 6769 6e6e 696e 6720 k and beginning │ │ │ │ │ +00030400: 6f66 2074 6865 206b 6572 6e65 6c2e 0a20 of the kernel.. │ │ │ │ │ +00030410: 2020 2020 4b6e 6f77 6e20 6166 6674 6563 Known afftec │ │ │ │ │ +00030420: 7465 6420 7379 7374 656d 733a 2056 4d57 ted systems: VMW │ │ │ │ │ +00030430: 6172 652e 0a0a 1f0a 4669 6c65 3a20 6772 are.....File: gr │ │ │ │ │ +00030440: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ +00030450: 6e61 7469 7665 6469 736b 2c20 204e 6578 nativedisk, Nex │ │ │ │ │ +00030460: 743a 206e 6f72 6d61 6c2c 2020 5072 6576 t: normal, Prev │ │ │ │ │ +00030470: 3a20 6d75 6c74 6962 6f6f 742c 2020 5570 : multiboot, Up │ │ │ │ │ +00030480: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ │ +00030490: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ │ +000304a0: 6d6d 616e 6473 0a0a 3136 2e33 2e35 3120 mmands..16.3.51 │ │ │ │ │ +000304b0: 6e61 7469 7665 6469 736b 0a2d 2d2d 2d2d nativedisk.----- │ │ │ │ │ +000304c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 -------------.. │ │ │ │ │ +000304d0: 2d2d 2043 6f6d 6d61 6e64 3a20 6e61 7469 -- Command: nati │ │ │ │ │ +000304e0: 7665 6469 736b 0a20 2020 2020 5377 6974 vedisk. Swit │ │ │ │ │ +000304f0: 6368 2066 726f 6d20 6669 726d 7761 7265 ch from firmware │ │ │ │ │ +00030500: 2064 6973 6b20 6472 6976 6572 7320 746f disk drivers to │ │ │ │ │ +00030510: 206e 6174 6976 6520 6f6e 6573 2e20 2052 native ones. R │ │ │ │ │ +00030520: 6561 6c6c 7920 7573 6566 756c 0a20 2020 eally useful. │ │ │ │ │ +00030530: 2020 6f6e 6c79 206f 6e20 706c 6174 666f only on platfo │ │ │ │ │ +00030540: 726d 7320 7768 6572 6520 626f 7468 2066 rms where both f │ │ │ │ │ +00030550: 6972 6d77 6172 6520 616e 6420 6e61 7469 irmware and nati │ │ │ │ │ +00030560: 7665 2064 6973 6b20 6472 6976 6573 2061 ve disk drives a │ │ │ │ │ +00030570: 7265 0a20 2020 2020 6176 6169 6c61 626c re. availabl │ │ │ │ │ +00030580: 652e 2020 4375 7272 656e 746c 7920 6933 e. Currently i3 │ │ │ │ │ +00030590: 3836 2d70 632c 2069 3338 362d 6566 692c 86-pc, i386-efi, │ │ │ │ │ +000305a0: 2069 3338 362d 6965 6565 3132 3735 2061 i386-ieee1275 a │ │ │ │ │ +000305b0: 6e64 0a20 2020 2020 7838 365f 3634 2d65 nd. x86_64-e │ │ │ │ │ +000305c0: 6669 2e0a 0a1f 0a46 696c 653a 2067 7275 fi.....File: gru │ │ │ │ │ +000305d0: 622e 696e 666f 2c20 204e 6f64 653a 206e b.info, Node: n │ │ │ │ │ +000305e0: 6f72 6d61 6c2c 2020 4e65 7874 3a20 6e6f ormal, Next: no │ │ │ │ │ +000305f0: 726d 616c 5f65 7869 742c 2020 5072 6576 rmal_exit, Prev │ │ │ │ │ +00030600: 3a20 6e61 7469 7665 6469 736b 2c20 2055 : nativedisk, U │ │ │ │ │ +00030610: 703a 2043 6f6d 6d61 6e64 2d6c 696e 6520 p: Command-line │ │ │ │ │ +00030620: 616e 6420 6d65 6e75 2065 6e74 7279 2063 and menu entry c │ │ │ │ │ +00030630: 6f6d 6d61 6e64 730a 0a31 362e 332e 3532 ommands..16.3.52 │ │ │ │ │ +00030640: 206e 6f72 6d61 6c0a 2d2d 2d2d 2d2d 2d2d normal.-------- │ │ │ │ │ +00030650: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ │ +00030660: 616e 643a 206e 6f72 6d61 6c20 5b66 696c and: normal [fil │ │ │ │ │ +00030670: 655d 0a20 2020 2020 456e 7465 7220 6e6f e]. Enter no │ │ │ │ │ +00030680: 726d 616c 206d 6f64 6520 616e 6420 6469 rmal mode and di │ │ │ │ │ +00030690: 7370 6c61 7920 7468 6520 4752 5542 206d splay the GRUB m │ │ │ │ │ +000306a0: 656e 752e 0a0a 2020 2020 2049 6e20 6e6f enu... In no │ │ │ │ │ +000306b0: 726d 616c 206d 6f64 652c 2063 6f6d 6d61 rmal mode, comma │ │ │ │ │ +000306c0: 6e64 732c 2066 696c 6573 7973 7465 6d20 nds, filesystem │ │ │ │ │ +000306d0: 6d6f 6475 6c65 732c 2061 6e64 2063 7279 modules, and cry │ │ │ │ │ +000306e0: 7074 6f67 7261 7068 790a 2020 2020 206d ptography. m │ │ │ │ │ +000306f0: 6f64 756c 6573 2061 7265 2061 7574 6f6d odules are autom │ │ │ │ │ +00030700: 6174 6963 616c 6c79 206c 6f61 6465 642c atically loaded, │ │ │ │ │ +00030710: 2061 6e64 2074 6865 2066 756c 6c20 4752 and the full GR │ │ │ │ │ +00030720: 5542 2073 6372 6970 7420 7061 7273 6572 UB script parser │ │ │ │ │ +00030730: 0a20 2020 2020 6973 2061 7661 696c 6162 . is availab │ │ │ │ │ +00030740: 6c65 2e20 204f 7468 6572 206d 6f64 756c le. Other modul │ │ │ │ │ +00030750: 6573 206d 6179 2062 6520 6578 706c 6963 es may be explic │ │ │ │ │ +00030760: 6974 6c79 206c 6f61 6465 6420 7573 696e itly loaded usin │ │ │ │ │ +00030770: 670a 2020 2020 2027 696e 736d 6f64 2720 g. 'insmod' │ │ │ │ │ +00030780: 282a 6e6f 7465 2069 6e73 6d6f 643a 3a29 (*note insmod::) │ │ │ │ │ +00030790: 2e0a 0a20 2020 2020 4966 2061 2046 494c ... If a FIL │ │ │ │ │ +000307a0: 4520 6973 2067 6976 656e 2c20 7468 656e E is given, then │ │ │ │ │ +000307b0: 2063 6f6d 6d61 6e64 7320 7769 6c6c 2062 commands will b │ │ │ │ │ +000307c0: 6520 7265 6164 2066 726f 6d20 7468 6174 e read from that │ │ │ │ │ +000307d0: 2066 696c 652e 0a20 2020 2020 4f74 6865 file.. Othe │ │ │ │ │ +000307e0: 7277 6973 652c 2074 6865 7920 7769 6c6c rwise, they will │ │ │ │ │ +000307f0: 2062 6520 7265 6164 2066 726f 6d20 2724 be read from '$ │ │ │ │ │ +00030800: 7072 6566 6978 2f67 7275 622e 6366 6727 prefix/grub.cfg' │ │ │ │ │ +00030810: 2069 6620 6974 2065 7869 7374 732e 0a0a if it exists... │ │ │ │ │ +00030820: 2020 2020 2027 6e6f 726d 616c 2720 6d61 'normal' ma │ │ │ │ │ +00030830: 7920 6265 2063 616c 6c65 6420 6672 6f6d y be called from │ │ │ │ │ +00030840: 2077 6974 6869 6e20 6e6f 726d 616c 206d within normal m │ │ │ │ │ +00030850: 6f64 652c 2063 7265 6174 696e 6720 6120 ode, creating a │ │ │ │ │ +00030860: 6e65 7374 6564 0a20 2020 2020 656e 7669 nested. envi │ │ │ │ │ +00030870: 726f 6e6d 656e 742e 2020 4974 2069 7320 ronment. It is │ │ │ │ │ +00030880: 6d6f 7265 2075 7375 616c 2074 6f20 7573 more usual to us │ │ │ │ │ +00030890: 6520 2763 6f6e 6669 6766 696c 6527 2028 e 'configfile' ( │ │ │ │ │ +000308a0: 2a6e 6f74 650a 2020 2020 2063 6f6e 6669 *note. confi │ │ │ │ │ +000308b0: 6766 696c 653a 3a29 2066 6f72 2074 6869 gfile::) for thi │ │ │ │ │ +000308c0: 732e 0a0a 1f0a 4669 6c65 3a20 6772 7562 s.....File: grub │ │ │ │ │ +000308d0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 6e6f .info, Node: no │ │ │ │ │ +000308e0: 726d 616c 5f65 7869 742c 2020 4e65 7874 rmal_exit, Next │ │ │ │ │ +000308f0: 3a20 7061 7274 746f 6f6c 2c20 2050 7265 : parttool, Pre │ │ │ │ │ +00030900: 763a 206e 6f72 6d61 6c2c 2020 5570 3a20 v: normal, Up: │ │ │ │ │ +00030910: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ +00030920: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ │ +00030930: 616e 6473 0a0a 3136 2e33 2e35 3320 6e6f ands..16.3.53 no │ │ │ │ │ +00030940: 726d 616c 5f65 7869 740a 2d2d 2d2d 2d2d rmal_exit.------ │ │ │ │ │ +00030950: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 -------------.. │ │ │ │ │ +00030960: 2d2d 2043 6f6d 6d61 6e64 3a20 6e6f 726d -- Command: norm │ │ │ │ │ +00030970: 616c 5f65 7869 740a 2020 2020 2045 7869 al_exit. Exi │ │ │ │ │ +00030980: 7420 6e6f 726d 616c 206d 6f64 6520 282a t normal mode (* │ │ │ │ │ +00030990: 6e6f 7465 206e 6f72 6d61 6c3a 3a29 2e20 note normal::). │ │ │ │ │ +000309a0: 2049 6620 7468 6973 2069 6e73 7461 6e63 If this instanc │ │ │ │ │ +000309b0: 6520 6f66 206e 6f72 6d61 6c20 6d6f 6465 e of normal mode │ │ │ │ │ +000309c0: 0a20 2020 2020 7761 7320 6e6f 7420 6e65 . was not ne │ │ │ │ │ +000309d0: 7374 6564 2077 6974 6869 6e20 616e 6f74 sted within anot │ │ │ │ │ +000309e0: 6865 7220 6f6e 652c 2074 6865 6e20 7265 her one, then re │ │ │ │ │ +000309f0: 7475 726e 2074 6f20 7265 7363 7565 206d turn to rescue m │ │ │ │ │ +00030a00: 6f64 652e 0a0a 1f0a 4669 6c65 3a20 6772 ode.....File: gr │ │ │ │ │ +00030a10: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ +00030a20: 7061 7274 746f 6f6c 2c20 204e 6578 743a parttool, Next: │ │ │ │ │ +00030a30: 2070 6173 7377 6f72 642c 2020 5072 6576 password, Prev │ │ │ │ │ +00030a40: 3a20 6e6f 726d 616c 5f65 7869 742c 2020 : normal_exit, │ │ │ │ │ +00030a50: 5570 3a20 436f 6d6d 616e 642d 6c69 6e65 Up: Command-line │ │ │ │ │ +00030a60: 2061 6e64 206d 656e 7520 656e 7472 7920 and menu entry │ │ │ │ │ +00030a70: 636f 6d6d 616e 6473 0a0a 3136 2e33 2e35 commands..16.3.5 │ │ │ │ │ +00030a80: 3420 7061 7274 746f 6f6c 0a2d 2d2d 2d2d 4 parttool.----- │ │ │ │ │ +00030a90: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d -----------.. -- │ │ │ │ │ +00030aa0: 2043 6f6d 6d61 6e64 3a20 7061 7274 746f Command: partto │ │ │ │ │ +00030ab0: 6f6c 2070 6172 7469 7469 6f6e 2063 6f6d ol partition com │ │ │ │ │ +00030ac0: 6d61 6e64 730a 2020 2020 204d 616b 6520 mands. Make │ │ │ │ │ +00030ad0: 7661 7269 6f75 7320 6d6f 6469 6669 6361 various modifica │ │ │ │ │ +00030ae0: 7469 6f6e 7320 746f 2070 6172 7469 7469 tions to partiti │ │ │ │ │ +00030af0: 6f6e 2074 6162 6c65 2065 6e74 7269 6573 on table entries │ │ │ │ │ +00030b00: 2e0a 0a20 2020 2020 4561 6368 2043 4f4d ... Each COM │ │ │ │ │ +00030b10: 4d41 4e44 2069 7320 6569 7468 6572 2061 MAND is either a │ │ │ │ │ +00030b20: 2062 6f6f 6c65 616e 206f 7074 696f 6e2c boolean option, │ │ │ │ │ +00030b30: 2069 6e20 7768 6963 6820 6361 7365 2069 in which case i │ │ │ │ │ +00030b40: 7420 6d75 7374 2062 650a 2020 2020 2066 t must be. f │ │ │ │ │ +00030b50: 6f6c 6c6f 7765 6420 7769 7468 2027 2b27 ollowed with '+' │ │ │ │ │ +00030b60: 206f 7220 272d 2720 2877 6974 6820 6e6f or '-' (with no │ │ │ │ │ +00030b70: 2069 6e74 6572 7665 6e69 6e67 2073 7061 intervening spa │ │ │ │ │ +00030b80: 6365 2920 746f 2065 6e61 626c 6520 6f72 ce) to enable or │ │ │ │ │ +00030b90: 0a20 2020 2020 6469 7361 626c 6520 7468 . disable th │ │ │ │ │ +00030ba0: 6174 206f 7074 696f 6e2c 206f 7220 656c at option, or el │ │ │ │ │ +00030bb0: 7365 2069 7420 7461 6b65 7320 6120 7661 se it takes a va │ │ │ │ │ +00030bc0: 6c75 6520 696e 2074 6865 2066 6f72 6d0a lue in the form. │ │ │ │ │ +00030bd0: 2020 2020 2027 434f 4d4d 414e 443d 5641 'COMMAND=VA │ │ │ │ │ +00030be0: 4c55 4527 2e0a 0a20 2020 2020 4375 7272 LUE'... Curr │ │ │ │ │ +00030bf0: 656e 746c 792c 2027 7061 7274 746f 6f6c ently, 'parttool │ │ │ │ │ +00030c00: 2720 6973 206f 6e6c 7920 7573 6566 756c ' is only useful │ │ │ │ │ +00030c10: 206f 6e20 444f 5320 7061 7274 6974 696f on DOS partitio │ │ │ │ │ +00030c20: 6e20 7461 626c 6573 2028 616c 736f 0a20 n tables (also. │ │ │ │ │ +00030c30: 2020 2020 6b6e 6f77 6e20 6173 204d 6173 known as Mas │ │ │ │ │ +00030c40: 7465 7220 426f 6f74 2052 6563 6f72 642c ter Boot Record, │ │ │ │ │ +00030c50: 206f 7220 4d42 5229 2e20 4f6e 2074 6865 or MBR). On the │ │ │ │ │ +00030c60: 7365 2070 6172 7469 7469 6f6e 2074 6162 se partition tab │ │ │ │ │ +00030c70: 6c65 732c 0a20 2020 2020 7468 6520 666f les,. the fo │ │ │ │ │ +00030c80: 6c6c 6f77 696e 6720 636f 6d6d 616e 6473 llowing commands │ │ │ │ │ +00030c90: 2061 7265 2061 7661 696c 6162 6c65 3a0a are available:. │ │ │ │ │ +00030ca0: 0a20 2020 2020 2762 6f6f 7427 2028 626f . 'boot' (bo │ │ │ │ │ +00030cb0: 6f6c 6561 6e29 0a20 2020 2020 2020 2020 olean). │ │ │ │ │ +00030cc0: 2057 6865 6e20 656e 6162 6c65 642c 2074 When enabled, t │ │ │ │ │ +00030cd0: 6869 7320 6d61 6b65 7320 7468 6520 7365 his makes the se │ │ │ │ │ +00030ce0: 6c65 6374 6564 2070 6172 7469 7469 6f6e lected partition │ │ │ │ │ +00030cf0: 2062 6520 7468 6520 6163 7469 7665 0a20 be the active. │ │ │ │ │ +00030d00: 2020 2020 2020 2020 2028 626f 6f74 6162 (bootab │ │ │ │ │ +00030d10: 6c65 2920 7061 7274 6974 696f 6e20 6f6e le) partition on │ │ │ │ │ +00030d20: 2069 7473 2064 6973 6b2c 2063 6c65 6172 its disk, clear │ │ │ │ │ +00030d30: 696e 6720 7468 6520 6163 7469 7665 2066 ing the active f │ │ │ │ │ +00030d40: 6c61 6720 6f6e 0a20 2020 2020 2020 2020 lag on. │ │ │ │ │ +00030d50: 2061 6c6c 206f 7468 6572 2070 6172 7469 all other parti │ │ │ │ │ +00030d60: 7469 6f6e 732e 2020 5468 6973 2063 6f6d tions. This com │ │ │ │ │ +00030d70: 6d61 6e64 2069 7320 6c69 6d69 7465 6420 mand is limited │ │ │ │ │ +00030d80: 746f 205f 7072 696d 6172 795f 0a20 2020 to _primary_. │ │ │ │ │ +00030d90: 2020 2020 2020 2070 6172 7469 7469 6f6e partition │ │ │ │ │ +00030da0: 732e 0a0a 2020 2020 2027 7479 7065 2720 s... 'type' │ │ │ │ │ +00030db0: 2876 616c 7565 290a 2020 2020 2020 2020 (value). │ │ │ │ │ +00030dc0: 2020 4368 616e 6765 2074 6865 2074 7970 Change the typ │ │ │ │ │ +00030dd0: 6520 6f66 2061 6e20 6578 6973 7469 6e67 e of an existing │ │ │ │ │ +00030de0: 2070 6172 7469 7469 6f6e 2e20 2054 6865 partition. The │ │ │ │ │ +00030df0: 2076 616c 7565 206d 7573 7420 6265 2061 value must be a │ │ │ │ │ +00030e00: 0a20 2020 2020 2020 2020 206e 756d 6265 . numbe │ │ │ │ │ +00030e10: 7220 696e 2074 6865 2072 616e 6765 2030 r in the range 0 │ │ │ │ │ +00030e20: 2d30 7846 4620 2870 7265 6669 7820 7769 -0xFF (prefix wi │ │ │ │ │ +00030e30: 7468 2027 3078 2720 746f 2065 6e74 6572 th '0x' to enter │ │ │ │ │ +00030e40: 2069 7420 696e 0a20 2020 2020 2020 2020 it in. │ │ │ │ │ +00030e50: 2068 6578 6164 6563 696d 616c 292e 0a0a hexadecimal)... │ │ │ │ │ +00030e60: 2020 2020 2027 6869 6464 656e 2720 2862 'hidden' (b │ │ │ │ │ +00030e70: 6f6f 6c65 616e 290a 2020 2020 2020 2020 oolean). │ │ │ │ │ +00030e80: 2020 5768 656e 2065 6e61 626c 6564 2c20 When enabled, │ │ │ │ │ +00030e90: 7468 6973 2068 6964 6573 2074 6865 2073 this hides the s │ │ │ │ │ +00030ea0: 656c 6563 7465 6420 7061 7274 6974 696f elected partitio │ │ │ │ │ +00030eb0: 6e20 6279 2073 6574 7469 6e67 2074 6865 n by setting the │ │ │ │ │ +00030ec0: 0a20 2020 2020 2020 2020 2022 6869 6464 . "hidd │ │ │ │ │ +00030ed0: 656e 2220 6269 7420 696e 2069 7473 2070 en" bit in its p │ │ │ │ │ +00030ee0: 6172 7469 7469 6f6e 2074 7970 6520 636f artition type co │ │ │ │ │ +00030ef0: 6465 3b20 7768 656e 2064 6973 6162 6c65 de; when disable │ │ │ │ │ +00030f00: 642c 0a20 2020 2020 2020 2020 2075 6e68 d,. unh │ │ │ │ │ +00030f10: 6964 6573 2074 6865 2073 656c 6563 7465 ides the selecte │ │ │ │ │ +00030f20: 6420 7061 7274 6974 696f 6e20 6279 2063 d partition by c │ │ │ │ │ +00030f30: 6c65 6172 696e 6720 7468 6973 2062 6974 learing this bit │ │ │ │ │ +00030f40: 2e20 2054 6869 7320 6973 0a20 2020 2020 . This is. │ │ │ │ │ +00030f50: 2020 2020 2075 7365 6675 6c20 6f6e 6c79 useful only │ │ │ │ │ +00030f60: 2077 6865 6e20 626f 6f74 696e 6720 444f when booting DO │ │ │ │ │ +00030f70: 5320 6f72 2057 696e 646f 7773 2061 6e64 S or Windows and │ │ │ │ │ +00030f80: 206d 756c 7469 706c 6520 7072 696d 6172 multiple primar │ │ │ │ │ +00030f90: 790a 2020 2020 2020 2020 2020 4641 5420 y. FAT │ │ │ │ │ +00030fa0: 7061 7274 6974 696f 6e73 2065 7869 7374 partitions exist │ │ │ │ │ +00030fb0: 2069 6e20 6f6e 6520 6469 736b 2e20 2053 in one disk. S │ │ │ │ │ +00030fc0: 6565 2061 6c73 6f20 2a6e 6f74 650a 2020 ee also *note. │ │ │ │ │ +00030fd0: 2020 2020 2020 2020 444f 532f 5769 6e64 DOS/Wind │ │ │ │ │ +00030fe0: 6f77 733a 3a2e 0a0a 1f0a 4669 6c65 3a20 ows::.....File: │ │ │ │ │ +00030ff0: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ +00031000: 3a20 7061 7373 776f 7264 2c20 204e 6578 : password, Nex │ │ │ │ │ +00031010: 743a 2070 6173 7377 6f72 645f 7062 6b64 t: password_pbkd │ │ │ │ │ +00031020: 6632 2c20 2050 7265 763a 2070 6172 7474 f2, Prev: partt │ │ │ │ │ +00031030: 6f6f 6c2c 2020 5570 3a20 436f 6d6d 616e ool, Up: Comman │ │ │ │ │ +00031040: 642d 6c69 6e65 2061 6e64 206d 656e 7520 d-line and menu │ │ │ │ │ +00031050: 656e 7472 7920 636f 6d6d 616e 6473 0a0a entry commands.. │ │ │ │ │ +00031060: 3136 2e33 2e35 3520 7061 7373 776f 7264 16.3.55 password │ │ │ │ │ +00031070: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ │ +00031080: 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 -.. -- Command: │ │ │ │ │ +00031090: 7061 7373 776f 7264 2075 7365 7220 636c password user cl │ │ │ │ │ +000310a0: 6561 722d 7061 7373 776f 7264 0a20 2020 ear-password. │ │ │ │ │ +000310b0: 2020 4465 6669 6e65 2061 2075 7365 7220 Define a user │ │ │ │ │ +000310c0: 6e61 6d65 6420 5553 4552 2077 6974 6820 named USER with │ │ │ │ │ +000310d0: 7061 7373 776f 7264 2043 4c45 4152 2d50 password CLEAR-P │ │ │ │ │ +000310e0: 4153 5357 4f52 442e 2020 2a4e 6f74 650a ASSWORD. *Note. │ │ │ │ │ +000310f0: 2020 2020 2053 6563 7572 6974 793a 3a2e Security::. │ │ │ │ │ +00031100: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ +00031110: 6e66 6f2c 2020 4e6f 6465 3a20 7061 7373 nfo, Node: pass │ │ │ │ │ +00031120: 776f 7264 5f70 626b 6466 322c 2020 4e65 word_pbkdf2, Ne │ │ │ │ │ +00031130: 7874 3a20 706c 6179 2c20 2050 7265 763a xt: play, Prev: │ │ │ │ │ +00031140: 2070 6173 7377 6f72 642c 2020 5570 3a20 password, Up: │ │ │ │ │ +00031150: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ +00031160: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ │ +00031170: 616e 6473 0a0a 3136 2e33 2e35 3620 7061 ands..16.3.56 pa │ │ │ │ │ +00031180: 7373 776f 7264 5f70 626b 6466 320a 2d2d ssword_pbkdf2.-- │ │ │ │ │ 00031190: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -000311a0: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d -------.. -- Com │ │ │ │ │ -000311b0: 6d61 6e64 3a20 7061 7373 776f 7264 5f70 mand: password_p │ │ │ │ │ -000311c0: 626b 6466 3220 7573 6572 2068 6173 6865 bkdf2 user hashe │ │ │ │ │ -000311d0: 642d 7061 7373 776f 7264 0a20 2020 2020 d-password. │ │ │ │ │ -000311e0: 4465 6669 6e65 2061 2075 7365 7220 6e61 Define a user na │ │ │ │ │ -000311f0: 6d65 6420 5553 4552 2077 6974 6820 7061 med USER with pa │ │ │ │ │ -00031200: 7373 776f 7264 2068 6173 6820 4841 5348 ssword hash HASH │ │ │ │ │ -00031210: 4544 2d50 4153 5357 4f52 442e 2020 5573 ED-PASSWORD. Us │ │ │ │ │ -00031220: 650a 2020 2020 2027 6772 7562 2d6d 6b70 e. 'grub-mkp │ │ │ │ │ -00031230: 6173 7377 642d 7062 6b64 6632 2720 282a asswd-pbkdf2' (* │ │ │ │ │ -00031240: 6e6f 7465 2049 6e76 6f6b 696e 6720 6772 note Invoking gr │ │ │ │ │ -00031250: 7562 2d6d 6b70 6173 7377 642d 7062 6b64 ub-mkpasswd-pbkd │ │ │ │ │ -00031260: 6632 3a3a 2920 746f 0a20 2020 2020 6765 f2::) to. ge │ │ │ │ │ -00031270: 6e65 7261 7465 2070 6173 7377 6f72 6420 nerate password │ │ │ │ │ -00031280: 6861 7368 6573 2e20 202a 4e6f 7465 2053 hashes. *Note S │ │ │ │ │ -00031290: 6563 7572 6974 793a 3a2e 0a0a 1f0a 4669 ecurity::.....Fi │ │ │ │ │ -000312a0: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ -000312b0: 4e6f 6465 3a20 706c 6179 2c20 204e 6578 Node: play, Nex │ │ │ │ │ -000312c0: 743a 2070 726f 6265 2c20 2050 7265 763a t: probe, Prev: │ │ │ │ │ -000312d0: 2070 6173 7377 6f72 645f 7062 6b64 6632 password_pbkdf2 │ │ │ │ │ -000312e0: 2c20 2055 703a 2043 6f6d 6d61 6e64 2d6c , Up: Command-l │ │ │ │ │ -000312f0: 696e 6520 616e 6420 6d65 6e75 2065 6e74 ine and menu ent │ │ │ │ │ -00031300: 7279 2063 6f6d 6d61 6e64 730a 0a31 362e ry commands..16. │ │ │ │ │ -00031310: 332e 3537 2070 6c61 790a 2d2d 2d2d 2d2d 3.57 play.------ │ │ │ │ │ -00031320: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ │ -00031330: 616e 643a 2070 6c61 7920 6669 6c65 207c and: play file | │ │ │ │ │ -00031340: 2074 656d 706f 205b 7069 7463 6831 2064 tempo [pitch1 d │ │ │ │ │ -00031350: 7572 6174 696f 6e31 5d20 5b70 6974 6368 uration1] [pitch │ │ │ │ │ -00031360: 3220 6475 7261 7469 6f6e 325d 202e 2e2e 2 duration2] ... │ │ │ │ │ -00031370: 0a20 2020 2020 506c 6179 7320 6120 7475 . Plays a tu │ │ │ │ │ -00031380: 6e65 0a0a 2020 2020 2049 6620 7468 6520 ne.. If the │ │ │ │ │ -00031390: 6172 6775 6d65 6e74 2069 7320 6120 6669 argument is a fi │ │ │ │ │ -000313a0: 6c65 206e 616d 6520 282a 6e6f 7465 2046 le name (*note F │ │ │ │ │ -000313b0: 696c 6520 6e61 6d65 2073 796e 7461 783a ile name syntax: │ │ │ │ │ -000313c0: 3a29 2c20 706c 6179 2074 6865 0a20 2020 :), play the. │ │ │ │ │ -000313d0: 2020 7475 6e65 2072 6563 6f72 6465 6420 tune recorded │ │ │ │ │ -000313e0: 696e 2069 742e 2020 5468 6520 6669 6c65 in it. The file │ │ │ │ │ -000313f0: 2066 6f72 6d61 7420 6973 2066 6972 7374 format is first │ │ │ │ │ -00031400: 2074 6865 2074 656d 706f 2061 7320 616e the tempo as an │ │ │ │ │ -00031410: 0a20 2020 2020 756e 7369 676e 6564 2033 . unsigned 3 │ │ │ │ │ -00031420: 3262 6974 206c 6974 746c 652d 656e 6469 2bit little-endi │ │ │ │ │ -00031430: 616e 206e 756d 6265 722c 2074 6865 6e20 an number, then │ │ │ │ │ -00031440: 7061 6972 7320 6f66 2075 6e73 6967 6e65 pairs of unsigne │ │ │ │ │ -00031450: 6420 3136 6269 740a 2020 2020 206c 6974 d 16bit. lit │ │ │ │ │ -00031460: 746c 652d 656e 6469 616e 206e 756d 6265 tle-endian numbe │ │ │ │ │ -00031470: 7273 2066 6f72 2070 6974 6368 2061 6e64 rs for pitch and │ │ │ │ │ -00031480: 2064 7572 6174 696f 6e20 7061 6972 732e duration pairs. │ │ │ │ │ -00031490: 0a0a 2020 2020 2049 6620 7468 6520 6172 .. If the ar │ │ │ │ │ -000314a0: 6775 6d65 6e74 7320 6172 6520 6120 7365 guments are a se │ │ │ │ │ -000314b0: 7269 6573 206f 6620 6e75 6d62 6572 732c ries of numbers, │ │ │ │ │ -000314c0: 2070 6c61 7920 7468 6520 696e 6c69 6e65 play the inline │ │ │ │ │ -000314d0: 2074 756e 652e 0a0a 2020 2020 2054 6865 tune... The │ │ │ │ │ -000314e0: 2074 656d 706f 2069 7320 7468 6520 6261 tempo is the ba │ │ │ │ │ -000314f0: 7365 2066 6f72 2061 6c6c 206e 6f74 6520 se for all note │ │ │ │ │ -00031500: 6475 7261 7469 6f6e 732e 2020 3630 2067 durations. 60 g │ │ │ │ │ -00031510: 6976 6573 2061 2031 2d73 6563 6f6e 640a ives a 1-second. │ │ │ │ │ -00031520: 2020 2020 2062 6173 652c 2031 3230 2067 base, 120 g │ │ │ │ │ -00031530: 6976 6573 2061 2068 616c 662d 7365 636f ives a half-seco │ │ │ │ │ -00031540: 6e64 2062 6173 652c 2065 7463 2e20 2050 nd base, etc. P │ │ │ │ │ -00031550: 6974 6368 6573 2061 7265 2048 7a2e 2020 itches are Hz. │ │ │ │ │ -00031560: 5365 740a 2020 2020 2070 6974 6368 2074 Set. pitch t │ │ │ │ │ -00031570: 6f20 3020 746f 2070 726f 6475 6365 2061 o 0 to produce a │ │ │ │ │ -00031580: 2072 6573 742e 0a0a 1f0a 4669 6c65 3a20 rest.....File: │ │ │ │ │ -00031590: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ -000315a0: 3a20 7072 6f62 652c 2020 4e65 7874 3a20 : probe, Next: │ │ │ │ │ -000315b0: 7264 6d73 722c 2020 5072 6576 3a20 706c rdmsr, Prev: pl │ │ │ │ │ -000315c0: 6179 2c20 2055 703a 2043 6f6d 6d61 6e64 ay, Up: Command │ │ │ │ │ -000315d0: 2d6c 696e 6520 616e 6420 6d65 6e75 2065 -line and menu e │ │ │ │ │ -000315e0: 6e74 7279 2063 6f6d 6d61 6e64 730a 0a31 ntry commands..1 │ │ │ │ │ -000315f0: 362e 332e 3538 2070 726f 6265 0a2d 2d2d 6.3.58 probe.--- │ │ │ │ │ -00031600: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 ----------.. -- │ │ │ │ │ -00031610: 436f 6d6d 616e 643a 2070 726f 6265 205b Command: probe [ │ │ │ │ │ -00031620: 2d2d 7365 7420 7661 725d 0a20 2020 2020 --set var]. │ │ │ │ │ -00031630: 2020 2020 202d 2d64 7269 7665 727c 2d2d --driver|-- │ │ │ │ │ -00031640: 7061 7274 6d61 707c 2d2d 6673 7c2d 2d66 partmap|--fs|--f │ │ │ │ │ -00031650: 732d 7575 6964 7c2d 2d6c 6162 656c 7c2d s-uuid|--label|- │ │ │ │ │ -00031660: 2d70 6172 742d 7575 6964 2064 6576 6963 -part-uuid devic │ │ │ │ │ -00031670: 650a 2020 2020 2052 6574 7269 6576 6520 e. Retrieve │ │ │ │ │ -00031680: 6465 7669 6365 2069 6e66 6f72 6d61 7469 device informati │ │ │ │ │ -00031690: 6f6e 2e20 2049 6620 6f70 7469 6f6e 2027 on. If option ' │ │ │ │ │ -000316a0: 2d2d 7365 7427 2069 7320 6769 7665 6e2c --set' is given, │ │ │ │ │ -000316b0: 2061 7373 6967 6e0a 2020 2020 2072 6573 assign. res │ │ │ │ │ -000316c0: 756c 7420 746f 2076 6172 6961 626c 6520 ult to variable │ │ │ │ │ -000316d0: 5641 522c 206f 7468 6572 7769 7365 2070 VAR, otherwise p │ │ │ │ │ -000316e0: 7269 6e74 2069 6e66 6f72 6d61 7469 6f6e rint information │ │ │ │ │ -000316f0: 206f 6e20 7468 6520 7363 7265 656e 2e0a on the screen.. │ │ │ │ │ -00031700: 0a20 2020 2020 5468 6520 6f70 7469 6f6e . The option │ │ │ │ │ -00031710: 2027 2d2d 7061 7274 2d75 7569 6427 2069 '--part-uuid' i │ │ │ │ │ -00031720: 7320 6375 7272 656e 746c 7920 6f6e 6c79 s currently only │ │ │ │ │ -00031730: 2069 6d70 6c65 6d65 6e74 6564 2066 6f72 implemented for │ │ │ │ │ -00031740: 204d 5344 4f53 0a20 2020 2020 616e 6420 MSDOS. and │ │ │ │ │ -00031750: 4750 5420 666f 726d 6174 7465 6420 6469 GPT formatted di │ │ │ │ │ -00031760: 736b 732e 0a0a 1f0a 4669 6c65 3a20 6772 sks.....File: gr │ │ │ │ │ -00031770: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ -00031780: 7264 6d73 722c 2020 4e65 7874 3a20 7265 rdmsr, Next: re │ │ │ │ │ -00031790: 6164 2c20 2050 7265 763a 2070 726f 6265 ad, Prev: probe │ │ │ │ │ -000317a0: 2c20 2055 703a 2043 6f6d 6d61 6e64 2d6c , Up: Command-l │ │ │ │ │ -000317b0: 696e 6520 616e 6420 6d65 6e75 2065 6e74 ine and menu ent │ │ │ │ │ -000317c0: 7279 2063 6f6d 6d61 6e64 730a 0a31 362e ry commands..16. │ │ │ │ │ -000317d0: 332e 3539 2072 646d 7372 0a2d 2d2d 2d2d 3.59 rdmsr.----- │ │ │ │ │ -000317e0: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ │ -000317f0: 6d6d 616e 643a 3a20 7264 6d73 7220 3078 mmand:: rdmsr 0x │ │ │ │ │ -00031800: 4144 4452 205b 2d76 2056 4152 4e41 4d45 ADDR [-v VARNAME │ │ │ │ │ -00031810: 5d0a 2020 2020 2052 6561 6420 6120 6d6f ]. Read a mo │ │ │ │ │ -00031820: 6465 6c2d 7370 6563 6966 6963 2072 6567 del-specific reg │ │ │ │ │ -00031830: 6973 7465 7220 6174 2061 6464 7265 7373 ister at address │ │ │ │ │ -00031840: 2030 7841 4444 522e 2049 6620 7468 6520 0xADDR. If the │ │ │ │ │ -00031850: 7061 7261 6d65 7465 720a 2020 2020 2027 parameter. ' │ │ │ │ │ -00031860: 2d76 2720 6973 2075 7365 6420 616e 6420 -v' is used and │ │ │ │ │ -00031870: 616e 2065 6e76 6972 6f6e 6d65 6e74 2076 an environment v │ │ │ │ │ -00031880: 6172 6961 626c 6520 5641 524e 414d 4520 ariable VARNAME │ │ │ │ │ -00031890: 6973 2067 6976 656e 2c20 7365 7420 7468 is given, set th │ │ │ │ │ -000318a0: 6174 0a20 2020 2020 656e 7669 726f 6e6d at. environm │ │ │ │ │ -000318b0: 656e 7420 7661 7269 6162 6c65 2074 6f20 ent variable to │ │ │ │ │ -000318c0: 7468 6520 7661 6c75 6520 7468 6174 2077 the value that w │ │ │ │ │ -000318d0: 6173 2072 6561 642e 0a0a 2020 2020 2050 as read... P │ │ │ │ │ -000318e0: 6c65 6173 6520 6e6f 7465 2074 6861 7420 lease note that │ │ │ │ │ -000318f0: 6f6e 2053 4d50 2073 7973 7465 6d73 2c20 on SMP systems, │ │ │ │ │ -00031900: 7265 6164 696e 6720 6672 6f6d 2061 204d reading from a M │ │ │ │ │ -00031910: 5352 2074 6861 7420 6861 7320 610a 2020 SR that has a. │ │ │ │ │ -00031920: 2020 2073 636f 7065 2070 6572 2068 6172 scope per har │ │ │ │ │ -00031930: 6477 6172 6520 7468 7265 6164 2c20 696d dware thread, im │ │ │ │ │ -00031940: 706c 6965 7320 7468 6174 2074 6865 2076 plies that the v │ │ │ │ │ -00031950: 616c 7565 2074 6861 7420 6973 2072 6574 alue that is ret │ │ │ │ │ -00031960: 7572 6e65 640a 2020 2020 206f 6e6c 7920 urned. only │ │ │ │ │ -00031970: 6170 706c 6965 7320 746f 2074 6865 2070 applies to the p │ │ │ │ │ -00031980: 6172 7469 6375 6c61 7220 6370 752f 636f articular cpu/co │ │ │ │ │ -00031990: 7265 2f74 6872 6561 6420 7468 6174 2072 re/thread that r │ │ │ │ │ -000319a0: 756e 7320 7468 650a 2020 2020 2063 6f6d uns the. com │ │ │ │ │ -000319b0: 6d61 6e64 2e0a 0a20 2020 2020 416c 736f mand... Also │ │ │ │ │ -000319c0: 2c20 6966 2079 6f75 2073 7065 6369 6679 , if you specify │ │ │ │ │ -000319d0: 2061 2072 6573 6572 7665 6420 6f72 2075 a reserved or u │ │ │ │ │ -000319e0: 6e69 6d70 6c65 6d65 6e74 6564 204d 5352 nimplemented MSR │ │ │ │ │ -000319f0: 2061 6464 7265 7373 2c20 6974 0a20 2020 address, it. │ │ │ │ │ -00031a00: 2020 7769 6c6c 2063 6175 7365 2061 2067 will cause a g │ │ │ │ │ -00031a10: 656e 6572 616c 2070 726f 7465 6374 696f eneral protectio │ │ │ │ │ -00031a20: 6e20 6578 6365 7074 696f 6e20 2877 6869 n exception (whi │ │ │ │ │ -00031a30: 6368 2069 7320 6e6f 7420 6375 7272 656e ch is not curren │ │ │ │ │ -00031a40: 746c 790a 2020 2020 2062 6569 6e67 2068 tly. being h │ │ │ │ │ -00031a50: 616e 646c 6564 2920 616e 6420 7468 6520 andled) and the │ │ │ │ │ -00031a60: 7379 7374 656d 2077 696c 6c20 7265 626f system will rebo │ │ │ │ │ -00031a70: 6f74 2e0a 0a1f 0a46 696c 653a 2067 7275 ot.....File: gru │ │ │ │ │ -00031a80: 622e 696e 666f 2c20 204e 6f64 653a 2072 b.info, Node: r │ │ │ │ │ -00031a90: 6561 642c 2020 4e65 7874 3a20 7265 626f ead, Next: rebo │ │ │ │ │ -00031aa0: 6f74 2c20 2050 7265 763a 2072 646d 7372 ot, Prev: rdmsr │ │ │ │ │ -00031ab0: 2c20 2055 703a 2043 6f6d 6d61 6e64 2d6c , Up: Command-l │ │ │ │ │ -00031ac0: 696e 6520 616e 6420 6d65 6e75 2065 6e74 ine and menu ent │ │ │ │ │ -00031ad0: 7279 2063 6f6d 6d61 6e64 730a 0a31 362e ry commands..16. │ │ │ │ │ -00031ae0: 332e 3630 2072 6561 640a 2d2d 2d2d 2d2d 3.60 read.------ │ │ │ │ │ -00031af0: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ │ -00031b00: 616e 643a 2072 6561 6420 5b76 6172 5d0a and: read [var]. │ │ │ │ │ -00031b10: 2020 2020 2052 6561 6420 6120 6c69 6e65 Read a line │ │ │ │ │ -00031b20: 206f 6620 696e 7075 7420 6672 6f6d 2074 of input from t │ │ │ │ │ -00031b30: 6865 2075 7365 722e 2020 4966 2061 6e20 he user. If an │ │ │ │ │ -00031b40: 656e 7669 726f 6e6d 656e 7420 7661 7269 environment vari │ │ │ │ │ -00031b50: 6162 6c65 2056 4152 0a20 2020 2020 6973 able VAR. is │ │ │ │ │ -00031b60: 2067 6976 656e 2c20 7365 7420 7468 6174 given, set that │ │ │ │ │ -00031b70: 2065 6e76 6972 6f6e 6d65 6e74 2076 6172 environment var │ │ │ │ │ -00031b80: 6961 626c 6520 746f 2074 6865 206c 696e iable to the lin │ │ │ │ │ -00031b90: 6520 6f66 2069 6e70 7574 2074 6861 740a e of input that. │ │ │ │ │ -00031ba0: 2020 2020 2077 6173 2072 6561 642c 2077 was read, w │ │ │ │ │ -00031bb0: 6974 6820 6e6f 2074 6572 6d69 6e61 7469 ith no terminati │ │ │ │ │ -00031bc0: 6e67 206e 6577 6c69 6e65 2e0a 0a1f 0a46 ng newline.....F │ │ │ │ │ -00031bd0: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ -00031be0: 204e 6f64 653a 2072 6562 6f6f 742c 2020 Node: reboot, │ │ │ │ │ -00031bf0: 4e65 7874 3a20 7265 6765 7870 2c20 2050 Next: regexp, P │ │ │ │ │ -00031c00: 7265 763a 2072 6561 642c 2020 5570 3a20 rev: read, Up: │ │ │ │ │ -00031c10: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ -00031c20: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ │ -00031c30: 616e 6473 0a0a 3136 2e33 2e36 3120 7265 ands..16.3.61 re │ │ │ │ │ -00031c40: 626f 6f74 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d boot.----------- │ │ │ │ │ -00031c50: 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 ---.. -- Command │ │ │ │ │ -00031c60: 3a20 7265 626f 6f74 0a20 2020 2020 5265 : reboot. Re │ │ │ │ │ -00031c70: 626f 6f74 2074 6865 2063 6f6d 7075 7465 boot the compute │ │ │ │ │ -00031c80: 722e 0a0a 1f0a 4669 6c65 3a20 6772 7562 r.....File: grub │ │ │ │ │ -00031c90: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 7265 .info, Node: re │ │ │ │ │ -00031ca0: 6765 7870 2c20 204e 6578 743a 2072 6d6d gexp, Next: rmm │ │ │ │ │ -00031cb0: 6f64 2c20 2050 7265 763a 2072 6562 6f6f od, Prev: reboo │ │ │ │ │ -00031cc0: 742c 2020 5570 3a20 436f 6d6d 616e 642d t, Up: Command- │ │ │ │ │ -00031cd0: 6c69 6e65 2061 6e64 206d 656e 7520 656e line and menu en │ │ │ │ │ -00031ce0: 7472 7920 636f 6d6d 616e 6473 0a0a 3136 try commands..16 │ │ │ │ │ -00031cf0: 2e33 2e36 3220 7265 6765 7870 0a2d 2d2d .3.62 regexp.--- │ │ │ │ │ -00031d00: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d -----------.. -- │ │ │ │ │ -00031d10: 2043 6f6d 6d61 6e64 3a20 7265 6765 7870 Command: regexp │ │ │ │ │ -00031d20: 205b 2d2d 7365 7420 5b6e 756d 6265 723a [--set [number: │ │ │ │ │ -00031d30: 5d76 6172 5d20 7265 6765 7870 2073 7472 ]var] regexp str │ │ │ │ │ -00031d40: 696e 670a 2020 2020 2054 6573 7420 6966 ing. Test if │ │ │ │ │ -00031d50: 2072 6567 756c 6172 2065 7870 7265 7373 regular express │ │ │ │ │ -00031d60: 696f 6e20 5245 4745 5850 206d 6174 6368 ion REGEXP match │ │ │ │ │ -00031d70: 6573 2053 5452 494e 472e 2020 5375 7070 es STRING. Supp │ │ │ │ │ -00031d80: 6f72 7465 640a 2020 2020 2072 6567 756c orted. regul │ │ │ │ │ -00031d90: 6172 2065 7870 7265 7373 696f 6e73 2061 ar expressions a │ │ │ │ │ -00031da0: 7265 2050 4f53 4958 2e32 2045 7874 656e re POSIX.2 Exten │ │ │ │ │ -00031db0: 6465 6420 5265 6775 6c61 7220 4578 7072 ded Regular Expr │ │ │ │ │ -00031dc0: 6573 7369 6f6e 732e 2020 4966 0a20 2020 essions. If. │ │ │ │ │ -00031dd0: 2020 6f70 7469 6f6e 2027 2d2d 7365 7427 option '--set' │ │ │ │ │ -00031de0: 2069 7320 6769 7665 6e2c 2073 746f 7265 is given, store │ │ │ │ │ -00031df0: 204e 554d 4245 5274 6820 6d61 7463 6865 NUMBERth matche │ │ │ │ │ -00031e00: 6420 7375 6265 7870 7265 7373 696f 6e20 d subexpression │ │ │ │ │ -00031e10: 696e 0a20 2020 2020 7661 7269 6162 6c65 in. variable │ │ │ │ │ -00031e20: 2056 4152 2e20 2053 7562 6578 7072 6573 VAR. Subexpres │ │ │ │ │ -00031e30: 7369 6f6e 7320 6172 6520 6e75 6d62 6572 sions are number │ │ │ │ │ -00031e40: 6564 2069 6e20 6f72 6465 7220 6f66 2074 ed in order of t │ │ │ │ │ -00031e50: 6865 6972 0a20 2020 2020 6f70 656e 696e heir. openin │ │ │ │ │ -00031e60: 6720 7061 7265 6e74 6865 7365 7320 7374 g parentheses st │ │ │ │ │ -00031e70: 6172 7469 6e67 2066 726f 6d20 2731 272e arting from '1'. │ │ │ │ │ -00031e80: 2020 4e55 4d42 4552 2064 6566 6175 6c74 NUMBER default │ │ │ │ │ -00031e90: 7320 746f 2027 3127 2e0a 0a1f 0a46 696c s to '1'.....Fil │ │ │ │ │ -00031ea0: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ -00031eb0: 6f64 653a 2072 6d6d 6f64 2c20 204e 6578 ode: rmmod, Nex │ │ │ │ │ -00031ec0: 743a 2073 6176 655f 656e 762c 2020 5072 t: save_env, Pr │ │ │ │ │ -00031ed0: 6576 3a20 7265 6765 7870 2c20 2055 703a ev: regexp, Up: │ │ │ │ │ -00031ee0: 2043 6f6d 6d61 6e64 2d6c 696e 6520 616e Command-line an │ │ │ │ │ -00031ef0: 6420 6d65 6e75 2065 6e74 7279 2063 6f6d d menu entry com │ │ │ │ │ -00031f00: 6d61 6e64 730a 0a31 362e 332e 3633 2072 mands..16.3.63 r │ │ │ │ │ -00031f10: 6d6d 6f64 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d mmod.----------- │ │ │ │ │ -00031f20: 2d2d 0a0a 202d 2d20 436f 6d6d 616e 643a --.. -- Command: │ │ │ │ │ -00031f30: 2072 6d6d 6f64 206d 6f64 756c 650a 2020 rmmod module. │ │ │ │ │ -00031f40: 2020 2052 656d 6f76 6520 6120 6c6f 6164 Remove a load │ │ │ │ │ -00031f50: 6564 204d 4f44 554c 452e 0a0a 1f0a 4669 ed MODULE.....Fi │ │ │ │ │ -00031f60: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ -00031f70: 4e6f 6465 3a20 7361 7665 5f65 6e76 2c20 Node: save_env, │ │ │ │ │ -00031f80: 204e 6578 743a 2073 6561 7263 682c 2020 Next: search, │ │ │ │ │ -00031f90: 5072 6576 3a20 726d 6d6f 642c 2020 5570 Prev: rmmod, Up │ │ │ │ │ -00031fa0: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ │ -00031fb0: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ │ -00031fc0: 6d6d 616e 6473 0a0a 3136 2e33 2e36 3420 mmands..16.3.64 │ │ │ │ │ -00031fd0: 7361 7665 5f65 6e76 0a2d 2d2d 2d2d 2d2d save_env.------- │ │ │ │ │ -00031fe0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 ---------.. -- C │ │ │ │ │ -00031ff0: 6f6d 6d61 6e64 3a20 7361 7665 5f65 6e76 ommand: save_env │ │ │ │ │ -00032000: 205b 2d2d 6669 6c65 2066 696c 655d 2076 [--file file] v │ │ │ │ │ -00032010: 6172 202e 2e2e 0a20 2020 2020 5361 7665 ar .... Save │ │ │ │ │ -00032020: 2074 6865 206e 616d 6564 2076 6172 6961 the named varia │ │ │ │ │ -00032030: 626c 6573 2066 726f 6d20 7468 6520 656e bles from the en │ │ │ │ │ -00032040: 7669 726f 6e6d 656e 7420 746f 2074 6865 vironment to the │ │ │ │ │ -00032050: 2065 6e76 6972 6f6e 6d65 6e74 0a20 2020 environment. │ │ │ │ │ -00032060: 2020 626c 6f63 6b20 6669 6c65 2e20 202a block file. * │ │ │ │ │ -00032070: 4e6f 7465 2045 6e76 6972 6f6e 6d65 6e74 Note Environment │ │ │ │ │ -00032080: 2062 6c6f 636b 3a3a 2e0a 0a20 2020 2020 block::... │ │ │ │ │ -00032090: 5468 6520 272d 2d66 696c 6527 206f 7074 The '--file' opt │ │ │ │ │ -000320a0: 696f 6e20 6f76 6572 7269 6465 7320 7468 ion overrides th │ │ │ │ │ -000320b0: 6520 6465 6661 756c 7420 6c6f 6361 7469 e default locati │ │ │ │ │ -000320c0: 6f6e 206f 6620 7468 650a 2020 2020 2065 on of the. e │ │ │ │ │ -000320d0: 6e76 6972 6f6e 6d65 6e74 2062 6c6f 636b nvironment block │ │ │ │ │ -000320e0: 2e0a 0a20 2020 2020 5468 6973 2063 6f6d ... This com │ │ │ │ │ -000320f0: 6d61 6e64 2077 696c 6c20 6f70 6572 6174 mand will operat │ │ │ │ │ -00032100: 6520 7375 6363 6573 7366 756c 6c79 2065 e successfully e │ │ │ │ │ -00032110: 7665 6e20 7768 656e 2065 6e76 6972 6f6e ven when environ │ │ │ │ │ -00032120: 6d65 6e74 0a20 2020 2020 7661 7269 6162 ment. variab │ │ │ │ │ -00032130: 6c65 2027 6368 6563 6b5f 7369 676e 6174 le 'check_signat │ │ │ │ │ -00032140: 7572 6573 2720 6973 2073 6574 2074 6f20 ures' is set to │ │ │ │ │ -00032150: 2765 6e66 6f72 6365 2720 282a 6e6f 7465 'enforce' (*note │ │ │ │ │ -00032160: 0a20 2020 2020 6368 6563 6b5f 7369 676e . check_sign │ │ │ │ │ -00032170: 6174 7572 6573 3a3a 292c 2073 696e 6365 atures::), since │ │ │ │ │ -00032180: 2069 7420 7772 6974 6573 2074 6f20 6469 it writes to di │ │ │ │ │ -00032190: 736b 2061 6e64 2064 6f65 7320 6e6f 7420 sk and does not │ │ │ │ │ -000321a0: 616c 7465 7220 7468 650a 2020 2020 2062 alter the. b │ │ │ │ │ -000321b0: 6568 6176 696f 7220 6f66 2047 5255 4220 ehavior of GRUB │ │ │ │ │ -000321c0: 6261 7365 6420 6f6e 2061 6e79 2063 6f6e based on any con │ │ │ │ │ -000321d0: 7465 6e74 7320 6f66 2064 6973 6b20 7468 tents of disk th │ │ │ │ │ -000321e0: 6174 2068 6176 6520 6265 656e 2072 6561 at have been rea │ │ │ │ │ -000321f0: 642e 0a20 2020 2020 4974 2069 7320 706f d.. It is po │ │ │ │ │ -00032200: 7373 6962 6c65 2074 6f20 6d6f 6469 6679 ssible to modify │ │ │ │ │ -00032210: 2061 2064 6967 6974 616c 6c79 2073 6967 a digitally sig │ │ │ │ │ -00032220: 6e65 6420 656e 7669 726f 6e6d 656e 7420 ned environment │ │ │ │ │ -00032230: 626c 6f63 6b20 6669 6c65 0a20 2020 2020 block file. │ │ │ │ │ -00032240: 6672 6f6d 2077 6974 6869 6e20 4752 5542 from within GRUB │ │ │ │ │ -00032250: 2075 7369 6e67 2074 6869 7320 636f 6d6d using this comm │ │ │ │ │ -00032260: 616e 642c 2073 7563 6820 7468 6174 2069 and, such that i │ │ │ │ │ -00032270: 7473 2073 6967 6e61 7475 7265 2077 696c ts signature wil │ │ │ │ │ -00032280: 6c0a 2020 2020 206e 6f20 6c6f 6e67 6572 l. no longer │ │ │ │ │ -00032290: 2062 6520 7661 6c69 6420 6f6e 2073 7562 be valid on sub │ │ │ │ │ -000322a0: 7365 7175 656e 7420 626f 6f74 732e 2020 sequent boots. │ │ │ │ │ -000322b0: 4361 7265 2073 686f 756c 6420 6265 2074 Care should be t │ │ │ │ │ -000322c0: 616b 656e 2069 6e0a 2020 2020 2073 7563 aken in. suc │ │ │ │ │ -000322d0: 6820 6164 7661 6e63 6564 2063 6f6e 6669 h advanced confi │ │ │ │ │ -000322e0: 6775 7261 7469 6f6e 7320 746f 2061 766f gurations to avo │ │ │ │ │ -000322f0: 6964 2072 656e 6465 7269 6e67 2074 6865 id rendering the │ │ │ │ │ -00032300: 2073 7973 7465 6d0a 2020 2020 2075 6e62 system. unb │ │ │ │ │ -00032310: 6f6f 7461 626c 652e 2020 2a4e 6f74 6520 ootable. *Note │ │ │ │ │ -00032320: 5573 696e 6720 6469 6769 7461 6c20 7369 Using digital si │ │ │ │ │ -00032330: 676e 6174 7572 6573 3a3a 2c20 666f 7220 gnatures::, for │ │ │ │ │ -00032340: 6d6f 7265 0a20 2020 2020 696e 666f 726d more. inform │ │ │ │ │ -00032350: 6174 696f 6e2e 0a0a 1f0a 4669 6c65 3a20 ation.....File: │ │ │ │ │ -00032360: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ -00032370: 3a20 7365 6172 6368 2c20 204e 6578 743a : search, Next: │ │ │ │ │ -00032380: 2073 656e 646b 6579 2c20 2050 7265 763a sendkey, Prev: │ │ │ │ │ -00032390: 2073 6176 655f 656e 762c 2020 5570 3a20 save_env, Up: │ │ │ │ │ -000323a0: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ -000323b0: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ │ -000323c0: 616e 6473 0a0a 3136 2e33 2e36 3520 7365 ands..16.3.65 se │ │ │ │ │ -000323d0: 6172 6368 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d arch.----------- │ │ │ │ │ -000323e0: 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 ---.. -- Command │ │ │ │ │ -000323f0: 3a20 7365 6172 6368 205b 2d2d 6669 6c65 : search [--file │ │ │ │ │ -00032400: 7c2d 2d6c 6162 656c 7c2d 2d66 732d 7575 |--label|--fs-uu │ │ │ │ │ -00032410: 6964 5d20 5b2d 2d73 6574 205b 7661 725d id] [--set [var] │ │ │ │ │ -00032420: 5d0a 2020 2020 2020 2020 2020 5b2d 2d6e ]. [--n │ │ │ │ │ -00032430: 6f2d 666c 6f70 7079 5d20 6e61 6d65 0a20 o-floppy] name. │ │ │ │ │ -00032440: 2020 2020 5365 6172 6368 2064 6576 6963 Search devic │ │ │ │ │ -00032450: 6573 2062 7920 6669 6c65 2028 272d 6627 es by file ('-f' │ │ │ │ │ -00032460: 2c20 272d 2d66 696c 6527 292c 2066 696c , '--file'), fil │ │ │ │ │ -00032470: 6573 7973 7465 6d20 6c61 6265 6c20 2827 esystem label (' │ │ │ │ │ -00032480: 2d6c 272c 0a20 2020 2020 272d 2d6c 6162 -l',. '--lab │ │ │ │ │ -00032490: 656c 2729 2c20 6f72 2066 696c 6573 7973 el'), or filesys │ │ │ │ │ -000324a0: 7465 6d20 5555 4944 2028 272d 7527 2c20 tem UUID ('-u', │ │ │ │ │ -000324b0: 272d 2d66 732d 7575 6964 2729 2e0a 0a20 '--fs-uuid')... │ │ │ │ │ -000324c0: 2020 2020 4966 2074 6865 2027 2d2d 7365 If the '--se │ │ │ │ │ -000324d0: 7427 206f 7074 696f 6e20 6973 2075 7365 t' option is use │ │ │ │ │ -000324e0: 642c 2074 6865 2066 6972 7374 2064 6576 d, the first dev │ │ │ │ │ -000324f0: 6963 6520 666f 756e 6420 6973 2073 6574 ice found is set │ │ │ │ │ -00032500: 2061 7320 7468 650a 2020 2020 2076 616c as the. val │ │ │ │ │ -00032510: 7565 206f 6620 656e 7669 726f 6e6d 656e ue of environmen │ │ │ │ │ -00032520: 7420 7661 7269 6162 6c65 2056 4152 2e20 t variable VAR. │ │ │ │ │ -00032530: 2054 6865 2064 6566 6175 6c74 2076 6172 The default var │ │ │ │ │ -00032540: 6961 626c 6520 6973 2027 726f 6f74 272e iable is 'root'. │ │ │ │ │ -00032550: 0a0a 2020 2020 2054 6865 2027 2d2d 6e6f .. The '--no │ │ │ │ │ -00032560: 2d66 6c6f 7070 7927 206f 7074 696f 6e20 -floppy' option │ │ │ │ │ -00032570: 7072 6576 656e 7473 2073 6561 7263 6869 prevents searchi │ │ │ │ │ -00032580: 6e67 2066 6c6f 7070 7920 6465 7669 6365 ng floppy device │ │ │ │ │ -00032590: 732c 2077 6869 6368 0a20 2020 2020 6361 s, which. ca │ │ │ │ │ -000325a0: 6e20 6265 2073 6c6f 772e 0a0a 2020 2020 n be slow... │ │ │ │ │ -000325b0: 2054 6865 2027 7365 6172 6368 2e66 696c The 'search.fil │ │ │ │ │ -000325c0: 6527 2c20 2773 6561 7263 682e 6673 5f6c e', 'search.fs_l │ │ │ │ │ -000325d0: 6162 656c 272c 2061 6e64 2027 7365 6172 abel', and 'sear │ │ │ │ │ -000325e0: 6368 2e66 735f 7575 6964 2720 636f 6d6d ch.fs_uuid' comm │ │ │ │ │ -000325f0: 616e 6473 0a20 2020 2020 6172 6520 616c ands. are al │ │ │ │ │ -00032600: 6961 7365 7320 666f 7220 2773 6561 7263 iases for 'searc │ │ │ │ │ -00032610: 6820 2d2d 6669 6c65 272c 2027 7365 6172 h --file', 'sear │ │ │ │ │ -00032620: 6368 202d 2d6c 6162 656c 272c 2061 6e64 ch --label', and │ │ │ │ │ -00032630: 2027 7365 6172 6368 0a20 2020 2020 2d2d 'search. -- │ │ │ │ │ -00032640: 6673 2d75 7569 6427 2072 6573 7065 6374 fs-uuid' respect │ │ │ │ │ -00032650: 6976 656c 792e 0a0a 1f0a 4669 6c65 3a20 ively.....File: │ │ │ │ │ -00032660: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ -00032670: 3a20 7365 6e64 6b65 792c 2020 4e65 7874 : sendkey, Next │ │ │ │ │ -00032680: 3a20 7365 742c 2020 5072 6576 3a20 7365 : set, Prev: se │ │ │ │ │ -00032690: 6172 6368 2c20 2055 703a 2043 6f6d 6d61 arch, Up: Comma │ │ │ │ │ -000326a0: 6e64 2d6c 696e 6520 616e 6420 6d65 6e75 nd-line and menu │ │ │ │ │ -000326b0: 2065 6e74 7279 2063 6f6d 6d61 6e64 730a entry commands. │ │ │ │ │ -000326c0: 0a31 362e 332e 3636 2073 656e 646b 6579 .16.3.66 sendkey │ │ │ │ │ -000326d0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ │ -000326e0: 0a0a 202d 2d20 436f 6d6d 616e 643a 2073 .. -- Command: s │ │ │ │ │ -000326f0: 656e 646b 6579 0a20 2020 2020 2020 2020 endkey. │ │ │ │ │ -00032700: 205b 2d2d 6e75 6d7c 2d2d 6361 7073 7c2d [--num|--caps|- │ │ │ │ │ -00032710: 2d73 6372 6f6c 6c7c 2d2d 696e 7365 7274 -scroll|--insert │ │ │ │ │ -00032720: 7c2d 2d70 6175 7365 7c2d 2d6c 6566 742d |--pause|--left- │ │ │ │ │ -00032730: 7368 6966 747c 2d2d 7269 6768 742d 7368 shift|--right-sh │ │ │ │ │ -00032740: 6966 747c 2d2d 7379 7372 717c 2d2d 6e75 ift|--sysrq|--nu │ │ │ │ │ -00032750: 6d6b 6579 7c2d 2d63 6170 736b 6579 7c2d mkey|--capskey|- │ │ │ │ │ -00032760: 2d73 6372 6f6c 6c6b 6579 7c2d 2d69 6e73 -scrollkey|--ins │ │ │ │ │ -00032770: 6572 746b 6579 7c2d 2d6c 6566 742d 616c ertkey|--left-al │ │ │ │ │ -00032780: 747c 2d2d 7269 6768 742d 616c 747c 2d2d t|--right-alt|-- │ │ │ │ │ -00032790: 6c65 6674 2d63 7472 6c7c 2d2d 7269 6768 left-ctrl|--righ │ │ │ │ │ -000327a0: 742d 6374 726c 0a20 2020 2020 2020 2020 t-ctrl. │ │ │ │ │ -000327b0: 206f 6e7c 6f66 665d 2e2e 2e20 5b6e 6f2d on|off]... [no- │ │ │ │ │ -000327c0: 6c65 645d 206b 6579 7374 726f 6b65 0a20 led] keystroke. │ │ │ │ │ -000327d0: 2020 2020 496e 7365 7274 206b 6579 7374 Insert keyst │ │ │ │ │ -000327e0: 726f 6b65 7320 696e 746f 2074 6865 206b rokes into the k │ │ │ │ │ -000327f0: 6579 626f 6172 6420 6275 6666 6572 2077 eyboard buffer w │ │ │ │ │ -00032800: 6865 6e20 626f 6f74 696e 672e 2020 536f hen booting. So │ │ │ │ │ -00032810: 6d65 7469 6d65 730a 2020 2020 2061 6e20 metimes. an │ │ │ │ │ -00032820: 6f70 6572 6174 696e 6720 7379 7374 656d operating system │ │ │ │ │ -00032830: 206f 7220 6368 6169 6e6c 6f61 6465 6420 or chainloaded │ │ │ │ │ -00032840: 626f 6f74 206c 6f61 6465 7220 7265 7175 boot loader requ │ │ │ │ │ -00032850: 6972 6573 2070 6172 7469 6375 6c61 720a ires particular. │ │ │ │ │ -00032860: 2020 2020 206b 6579 7320 746f 2062 6520 keys to be │ │ │ │ │ -00032870: 7072 6573 7365 643a 2066 6f72 2065 7861 pressed: for exa │ │ │ │ │ -00032880: 6d70 6c65 2c20 6f6e 6520 6d69 6768 7420 mple, one might │ │ │ │ │ -00032890: 6e65 6564 2074 6f20 7072 6573 7320 610a need to press a. │ │ │ │ │ -000328a0: 2020 2020 2070 6172 7469 6375 6c61 7220 particular │ │ │ │ │ -000328b0: 6b65 7920 746f 2065 6e74 6572 2022 7361 key to enter "sa │ │ │ │ │ -000328c0: 6665 206d 6f64 6522 2c20 6f72 2077 6865 fe mode", or whe │ │ │ │ │ -000328d0: 6e20 6368 6169 6e6c 6f61 6469 6e67 2061 n chainloading a │ │ │ │ │ -000328e0: 6e6f 7468 6572 0a20 2020 2020 626f 6f74 nother. boot │ │ │ │ │ -000328f0: 206c 6f61 6465 7220 6f6e 6520 6d69 6768 loader one migh │ │ │ │ │ -00032900: 7420 7365 6e64 206b 6579 7374 726f 6b65 t send keystroke │ │ │ │ │ -00032910: 7320 746f 2069 7420 746f 206e 6176 6967 s to it to navig │ │ │ │ │ -00032920: 6174 6520 6974 7320 6d65 6e75 2e0a 0a20 ate its menu... │ │ │ │ │ -00032930: 2020 2020 596f 7520 6d61 7920 7072 6f76 You may prov │ │ │ │ │ -00032940: 6964 6520 7570 2074 6f20 3136 206b 6579 ide up to 16 key │ │ │ │ │ -00032950: 7374 726f 6b65 7320 2874 6865 206c 656e strokes (the len │ │ │ │ │ -00032960: 6774 6820 6f66 2074 6865 2042 494f 530a gth of the BIOS. │ │ │ │ │ -00032970: 2020 2020 206b 6579 626f 6172 6420 6275 keyboard bu │ │ │ │ │ -00032980: 6666 6572 292e 2020 4b65 7973 7472 6f6b ffer). Keystrok │ │ │ │ │ -00032990: 6520 6e61 6d65 7320 6d61 7920 6265 2075 e names may be u │ │ │ │ │ -000329a0: 7070 6572 2d63 6173 6520 6f72 206c 6f77 pper-case or low │ │ │ │ │ -000329b0: 6572 2d63 6173 650a 2020 2020 206c 6574 er-case. let │ │ │ │ │ -000329c0: 7465 7273 2c20 6469 6769 7473 2c20 6f72 ters, digits, or │ │ │ │ │ -000329d0: 2074 616b 656e 2066 726f 6d20 7468 6520 taken from the │ │ │ │ │ -000329e0: 666f 6c6c 6f77 696e 6720 7461 626c 653a following table: │ │ │ │ │ -000329f0: 0a0a 2020 2020 204e 616d 6520 2020 2020 .. Name │ │ │ │ │ +000311a0: 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 -----.. -- Comma │ │ │ │ │ +000311b0: 6e64 3a20 7061 7373 776f 7264 5f70 626b nd: password_pbk │ │ │ │ │ +000311c0: 6466 3220 7573 6572 2068 6173 6865 642d df2 user hashed- │ │ │ │ │ +000311d0: 7061 7373 776f 7264 0a20 2020 2020 4465 password. De │ │ │ │ │ +000311e0: 6669 6e65 2061 2075 7365 7220 6e61 6d65 fine a user name │ │ │ │ │ +000311f0: 6420 5553 4552 2077 6974 6820 7061 7373 d USER with pass │ │ │ │ │ +00031200: 776f 7264 2068 6173 6820 4841 5348 4544 word hash HASHED │ │ │ │ │ +00031210: 2d50 4153 5357 4f52 442e 2020 5573 650a -PASSWORD. Use. │ │ │ │ │ +00031220: 2020 2020 2027 6772 7562 2d6d 6b70 6173 'grub-mkpas │ │ │ │ │ +00031230: 7377 642d 7062 6b64 6632 2720 282a 6e6f swd-pbkdf2' (*no │ │ │ │ │ +00031240: 7465 2049 6e76 6f6b 696e 6720 6772 7562 te Invoking grub │ │ │ │ │ +00031250: 2d6d 6b70 6173 7377 642d 7062 6b64 6632 -mkpasswd-pbkdf2 │ │ │ │ │ +00031260: 3a3a 2920 746f 0a20 2020 2020 6765 6e65 ::) to. gene │ │ │ │ │ +00031270: 7261 7465 2070 6173 7377 6f72 6420 6861 rate password ha │ │ │ │ │ +00031280: 7368 6573 2e20 202a 4e6f 7465 2053 6563 shes. *Note Sec │ │ │ │ │ +00031290: 7572 6974 793a 3a2e 0a0a 1f0a 4669 6c65 urity::.....File │ │ │ │ │ +000312a0: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ +000312b0: 6465 3a20 706c 6179 2c20 204e 6578 743a de: play, Next: │ │ │ │ │ +000312c0: 2070 726f 6265 2c20 2050 7265 763a 2070 probe, Prev: p │ │ │ │ │ +000312d0: 6173 7377 6f72 645f 7062 6b64 6632 2c20 assword_pbkdf2, │ │ │ │ │ +000312e0: 2055 703a 2043 6f6d 6d61 6e64 2d6c 696e Up: Command-lin │ │ │ │ │ +000312f0: 6520 616e 6420 6d65 6e75 2065 6e74 7279 e and menu entry │ │ │ │ │ +00031300: 2063 6f6d 6d61 6e64 730a 0a31 362e 332e commands..16.3. │ │ │ │ │ +00031310: 3537 2070 6c61 790a 2d2d 2d2d 2d2d 2d2d 57 play.-------- │ │ │ │ │ +00031320: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ │ +00031330: 643a 2070 6c61 7920 6669 6c65 207c 2074 d: play file | t │ │ │ │ │ +00031340: 656d 706f 205b 7069 7463 6831 2064 7572 empo [pitch1 dur │ │ │ │ │ +00031350: 6174 696f 6e31 5d20 5b70 6974 6368 3220 ation1] [pitch2 │ │ │ │ │ +00031360: 6475 7261 7469 6f6e 325d 202e 2e2e 0a20 duration2] .... │ │ │ │ │ +00031370: 2020 2020 506c 6179 7320 6120 7475 6e65 Plays a tune │ │ │ │ │ +00031380: 0a0a 2020 2020 2049 6620 7468 6520 6172 .. If the ar │ │ │ │ │ +00031390: 6775 6d65 6e74 2069 7320 6120 6669 6c65 gument is a file │ │ │ │ │ +000313a0: 206e 616d 6520 282a 6e6f 7465 2046 696c name (*note Fil │ │ │ │ │ +000313b0: 6520 6e61 6d65 2073 796e 7461 783a 3a29 e name syntax::) │ │ │ │ │ +000313c0: 2c20 706c 6179 2074 6865 0a20 2020 2020 , play the. │ │ │ │ │ +000313d0: 7475 6e65 2072 6563 6f72 6465 6420 696e tune recorded in │ │ │ │ │ +000313e0: 2069 742e 2020 5468 6520 6669 6c65 2066 it. The file f │ │ │ │ │ +000313f0: 6f72 6d61 7420 6973 2066 6972 7374 2074 ormat is first t │ │ │ │ │ +00031400: 6865 2074 656d 706f 2061 7320 616e 0a20 he tempo as an. │ │ │ │ │ +00031410: 2020 2020 756e 7369 676e 6564 2033 3262 unsigned 32b │ │ │ │ │ +00031420: 6974 206c 6974 746c 652d 656e 6469 616e it little-endian │ │ │ │ │ +00031430: 206e 756d 6265 722c 2074 6865 6e20 7061 number, then pa │ │ │ │ │ +00031440: 6972 7320 6f66 2075 6e73 6967 6e65 6420 irs of unsigned │ │ │ │ │ +00031450: 3136 6269 740a 2020 2020 206c 6974 746c 16bit. littl │ │ │ │ │ +00031460: 652d 656e 6469 616e 206e 756d 6265 7273 e-endian numbers │ │ │ │ │ +00031470: 2066 6f72 2070 6974 6368 2061 6e64 2064 for pitch and d │ │ │ │ │ +00031480: 7572 6174 696f 6e20 7061 6972 732e 0a0a uration pairs... │ │ │ │ │ +00031490: 2020 2020 2049 6620 7468 6520 6172 6775 If the argu │ │ │ │ │ +000314a0: 6d65 6e74 7320 6172 6520 6120 7365 7269 ments are a seri │ │ │ │ │ +000314b0: 6573 206f 6620 6e75 6d62 6572 732c 2070 es of numbers, p │ │ │ │ │ +000314c0: 6c61 7920 7468 6520 696e 6c69 6e65 2074 lay the inline t │ │ │ │ │ +000314d0: 756e 652e 0a0a 2020 2020 2054 6865 2074 une... The t │ │ │ │ │ +000314e0: 656d 706f 2069 7320 7468 6520 6261 7365 empo is the base │ │ │ │ │ +000314f0: 2066 6f72 2061 6c6c 206e 6f74 6520 6475 for all note du │ │ │ │ │ +00031500: 7261 7469 6f6e 732e 2020 3630 2067 6976 rations. 60 giv │ │ │ │ │ +00031510: 6573 2061 2031 2d73 6563 6f6e 640a 2020 es a 1-second. │ │ │ │ │ +00031520: 2020 2062 6173 652c 2031 3230 2067 6976 base, 120 giv │ │ │ │ │ +00031530: 6573 2061 2068 616c 662d 7365 636f 6e64 es a half-second │ │ │ │ │ +00031540: 2062 6173 652c 2065 7463 2e20 2050 6974 base, etc. Pit │ │ │ │ │ +00031550: 6368 6573 2061 7265 2048 7a2e 2020 5365 ches are Hz. Se │ │ │ │ │ +00031560: 740a 2020 2020 2070 6974 6368 2074 6f20 t. pitch to │ │ │ │ │ +00031570: 3020 746f 2070 726f 6475 6365 2061 2072 0 to produce a r │ │ │ │ │ +00031580: 6573 742e 0a0a 1f0a 4669 6c65 3a20 6772 est.....File: gr │ │ │ │ │ +00031590: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ +000315a0: 7072 6f62 652c 2020 4e65 7874 3a20 7264 probe, Next: rd │ │ │ │ │ +000315b0: 6d73 722c 2020 5072 6576 3a20 706c 6179 msr, Prev: play │ │ │ │ │ +000315c0: 2c20 2055 703a 2043 6f6d 6d61 6e64 2d6c , Up: Command-l │ │ │ │ │ +000315d0: 696e 6520 616e 6420 6d65 6e75 2065 6e74 ine and menu ent │ │ │ │ │ +000315e0: 7279 2063 6f6d 6d61 6e64 730a 0a31 362e ry commands..16. │ │ │ │ │ +000315f0: 332e 3538 2070 726f 6265 0a2d 2d2d 2d2d 3.58 probe.----- │ │ │ │ │ +00031600: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ │ +00031610: 6d6d 616e 643a 2070 726f 6265 205b 2d2d mmand: probe [-- │ │ │ │ │ +00031620: 7365 7420 7661 725d 0a20 2020 2020 2020 set var]. │ │ │ │ │ +00031630: 2020 202d 2d64 7269 7665 727c 2d2d 7061 --driver|--pa │ │ │ │ │ +00031640: 7274 6d61 707c 2d2d 6673 7c2d 2d66 732d rtmap|--fs|--fs- │ │ │ │ │ +00031650: 7575 6964 7c2d 2d6c 6162 656c 7c2d 2d70 uuid|--label|--p │ │ │ │ │ +00031660: 6172 742d 7575 6964 2064 6576 6963 650a art-uuid device. │ │ │ │ │ +00031670: 2020 2020 2052 6574 7269 6576 6520 6465 Retrieve de │ │ │ │ │ +00031680: 7669 6365 2069 6e66 6f72 6d61 7469 6f6e vice information │ │ │ │ │ +00031690: 2e20 2049 6620 6f70 7469 6f6e 2027 2d2d . If option '-- │ │ │ │ │ +000316a0: 7365 7427 2069 7320 6769 7665 6e2c 2061 set' is given, a │ │ │ │ │ +000316b0: 7373 6967 6e0a 2020 2020 2072 6573 756c ssign. resul │ │ │ │ │ +000316c0: 7420 746f 2076 6172 6961 626c 6520 5641 t to variable VA │ │ │ │ │ +000316d0: 522c 206f 7468 6572 7769 7365 2070 7269 R, otherwise pri │ │ │ │ │ +000316e0: 6e74 2069 6e66 6f72 6d61 7469 6f6e 206f nt information o │ │ │ │ │ +000316f0: 6e20 7468 6520 7363 7265 656e 2e0a 0a20 n the screen... │ │ │ │ │ +00031700: 2020 2020 5468 6520 6f70 7469 6f6e 2027 The option ' │ │ │ │ │ +00031710: 2d2d 7061 7274 2d75 7569 6427 2069 7320 --part-uuid' is │ │ │ │ │ +00031720: 6375 7272 656e 746c 7920 6f6e 6c79 2069 currently only i │ │ │ │ │ +00031730: 6d70 6c65 6d65 6e74 6564 2066 6f72 204d mplemented for M │ │ │ │ │ +00031740: 5344 4f53 0a20 2020 2020 616e 6420 4750 SDOS. and GP │ │ │ │ │ +00031750: 5420 666f 726d 6174 7465 6420 6469 736b T formatted disk │ │ │ │ │ +00031760: 732e 0a0a 1f0a 4669 6c65 3a20 6772 7562 s.....File: grub │ │ │ │ │ +00031770: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 7264 .info, Node: rd │ │ │ │ │ +00031780: 6d73 722c 2020 4e65 7874 3a20 7265 6164 msr, Next: read │ │ │ │ │ +00031790: 2c20 2050 7265 763a 2070 726f 6265 2c20 , Prev: probe, │ │ │ │ │ +000317a0: 2055 703a 2043 6f6d 6d61 6e64 2d6c 696e Up: Command-lin │ │ │ │ │ +000317b0: 6520 616e 6420 6d65 6e75 2065 6e74 7279 e and menu entry │ │ │ │ │ +000317c0: 2063 6f6d 6d61 6e64 730a 0a31 362e 332e commands..16.3. │ │ │ │ │ +000317d0: 3539 2072 646d 7372 0a2d 2d2d 2d2d 2d2d 59 rdmsr.------- │ │ │ │ │ +000317e0: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ │ +000317f0: 616e 643a 3a20 7264 6d73 7220 3078 4144 and:: rdmsr 0xAD │ │ │ │ │ +00031800: 4452 205b 2d76 2056 4152 4e41 4d45 5d0a DR [-v VARNAME]. │ │ │ │ │ +00031810: 2020 2020 2052 6561 6420 6120 6d6f 6465 Read a mode │ │ │ │ │ +00031820: 6c2d 7370 6563 6966 6963 2072 6567 6973 l-specific regis │ │ │ │ │ +00031830: 7465 7220 6174 2061 6464 7265 7373 2030 ter at address 0 │ │ │ │ │ +00031840: 7841 4444 522e 2049 6620 7468 6520 7061 xADDR. If the pa │ │ │ │ │ +00031850: 7261 6d65 7465 720a 2020 2020 2027 2d76 rameter. '-v │ │ │ │ │ +00031860: 2720 6973 2075 7365 6420 616e 6420 616e ' is used and an │ │ │ │ │ +00031870: 2065 6e76 6972 6f6e 6d65 6e74 2076 6172 environment var │ │ │ │ │ +00031880: 6961 626c 6520 5641 524e 414d 4520 6973 iable VARNAME is │ │ │ │ │ +00031890: 2067 6976 656e 2c20 7365 7420 7468 6174 given, set that │ │ │ │ │ +000318a0: 0a20 2020 2020 656e 7669 726f 6e6d 656e . environmen │ │ │ │ │ +000318b0: 7420 7661 7269 6162 6c65 2074 6f20 7468 t variable to th │ │ │ │ │ +000318c0: 6520 7661 6c75 6520 7468 6174 2077 6173 e value that was │ │ │ │ │ +000318d0: 2072 6561 642e 0a0a 2020 2020 2050 6c65 read... Ple │ │ │ │ │ +000318e0: 6173 6520 6e6f 7465 2074 6861 7420 6f6e ase note that on │ │ │ │ │ +000318f0: 2053 4d50 2073 7973 7465 6d73 2c20 7265 SMP systems, re │ │ │ │ │ +00031900: 6164 696e 6720 6672 6f6d 2061 204d 5352 ading from a MSR │ │ │ │ │ +00031910: 2074 6861 7420 6861 7320 610a 2020 2020 that has a. │ │ │ │ │ +00031920: 2073 636f 7065 2070 6572 2068 6172 6477 scope per hardw │ │ │ │ │ +00031930: 6172 6520 7468 7265 6164 2c20 696d 706c are thread, impl │ │ │ │ │ +00031940: 6965 7320 7468 6174 2074 6865 2076 616c ies that the val │ │ │ │ │ +00031950: 7565 2074 6861 7420 6973 2072 6574 7572 ue that is retur │ │ │ │ │ +00031960: 6e65 640a 2020 2020 206f 6e6c 7920 6170 ned. only ap │ │ │ │ │ +00031970: 706c 6965 7320 746f 2074 6865 2070 6172 plies to the par │ │ │ │ │ +00031980: 7469 6375 6c61 7220 6370 752f 636f 7265 ticular cpu/core │ │ │ │ │ +00031990: 2f74 6872 6561 6420 7468 6174 2072 756e /thread that run │ │ │ │ │ +000319a0: 7320 7468 650a 2020 2020 2063 6f6d 6d61 s the. comma │ │ │ │ │ +000319b0: 6e64 2e0a 0a20 2020 2020 416c 736f 2c20 nd... Also, │ │ │ │ │ +000319c0: 6966 2079 6f75 2073 7065 6369 6679 2061 if you specify a │ │ │ │ │ +000319d0: 2072 6573 6572 7665 6420 6f72 2075 6e69 reserved or uni │ │ │ │ │ +000319e0: 6d70 6c65 6d65 6e74 6564 204d 5352 2061 mplemented MSR a │ │ │ │ │ +000319f0: 6464 7265 7373 2c20 6974 0a20 2020 2020 ddress, it. │ │ │ │ │ +00031a00: 7769 6c6c 2063 6175 7365 2061 2067 656e will cause a gen │ │ │ │ │ +00031a10: 6572 616c 2070 726f 7465 6374 696f 6e20 eral protection │ │ │ │ │ +00031a20: 6578 6365 7074 696f 6e20 2877 6869 6368 exception (which │ │ │ │ │ +00031a30: 2069 7320 6e6f 7420 6375 7272 656e 746c is not currentl │ │ │ │ │ +00031a40: 790a 2020 2020 2062 6569 6e67 2068 616e y. being han │ │ │ │ │ +00031a50: 646c 6564 2920 616e 6420 7468 6520 7379 dled) and the sy │ │ │ │ │ +00031a60: 7374 656d 2077 696c 6c20 7265 626f 6f74 stem will reboot │ │ │ │ │ +00031a70: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ +00031a80: 696e 666f 2c20 204e 6f64 653a 2072 6561 info, Node: rea │ │ │ │ │ +00031a90: 642c 2020 4e65 7874 3a20 7265 626f 6f74 d, Next: reboot │ │ │ │ │ +00031aa0: 2c20 2050 7265 763a 2072 646d 7372 2c20 , Prev: rdmsr, │ │ │ │ │ +00031ab0: 2055 703a 2043 6f6d 6d61 6e64 2d6c 696e Up: Command-lin │ │ │ │ │ +00031ac0: 6520 616e 6420 6d65 6e75 2065 6e74 7279 e and menu entry │ │ │ │ │ +00031ad0: 2063 6f6d 6d61 6e64 730a 0a31 362e 332e commands..16.3. │ │ │ │ │ +00031ae0: 3630 2072 6561 640a 2d2d 2d2d 2d2d 2d2d 60 read.-------- │ │ │ │ │ +00031af0: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ │ +00031b00: 643a 2072 6561 6420 5b76 6172 5d0a 2020 d: read [var]. │ │ │ │ │ +00031b10: 2020 2052 6561 6420 6120 6c69 6e65 206f Read a line o │ │ │ │ │ +00031b20: 6620 696e 7075 7420 6672 6f6d 2074 6865 f input from the │ │ │ │ │ +00031b30: 2075 7365 722e 2020 4966 2061 6e20 656e user. If an en │ │ │ │ │ +00031b40: 7669 726f 6e6d 656e 7420 7661 7269 6162 vironment variab │ │ │ │ │ +00031b50: 6c65 2056 4152 0a20 2020 2020 6973 2067 le VAR. is g │ │ │ │ │ +00031b60: 6976 656e 2c20 7365 7420 7468 6174 2065 iven, set that e │ │ │ │ │ +00031b70: 6e76 6972 6f6e 6d65 6e74 2076 6172 6961 nvironment varia │ │ │ │ │ +00031b80: 626c 6520 746f 2074 6865 206c 696e 6520 ble to the line │ │ │ │ │ +00031b90: 6f66 2069 6e70 7574 2074 6861 740a 2020 of input that. │ │ │ │ │ +00031ba0: 2020 2077 6173 2072 6561 642c 2077 6974 was read, wit │ │ │ │ │ +00031bb0: 6820 6e6f 2074 6572 6d69 6e61 7469 6e67 h no terminating │ │ │ │ │ +00031bc0: 206e 6577 6c69 6e65 2e0a 0a1f 0a46 696c newline.....Fil │ │ │ │ │ +00031bd0: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ +00031be0: 6f64 653a 2072 6562 6f6f 742c 2020 4e65 ode: reboot, Ne │ │ │ │ │ +00031bf0: 7874 3a20 7265 6765 7870 2c20 2050 7265 xt: regexp, Pre │ │ │ │ │ +00031c00: 763a 2072 6561 642c 2020 5570 3a20 436f v: read, Up: Co │ │ │ │ │ +00031c10: 6d6d 616e 642d 6c69 6e65 2061 6e64 206d mmand-line and m │ │ │ │ │ +00031c20: 656e 7520 656e 7472 7920 636f 6d6d 616e enu entry comman │ │ │ │ │ +00031c30: 6473 0a0a 3136 2e33 2e36 3120 7265 626f ds..16.3.61 rebo │ │ │ │ │ +00031c40: 6f74 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ot.------------- │ │ │ │ │ +00031c50: 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 -.. -- Command: │ │ │ │ │ +00031c60: 7265 626f 6f74 0a20 2020 2020 5265 626f reboot. Rebo │ │ │ │ │ +00031c70: 6f74 2074 6865 2063 6f6d 7075 7465 722e ot the computer. │ │ │ │ │ +00031c80: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ +00031c90: 6e66 6f2c 2020 4e6f 6465 3a20 7265 6765 nfo, Node: rege │ │ │ │ │ +00031ca0: 7870 2c20 204e 6578 743a 2072 6d6d 6f64 xp, Next: rmmod │ │ │ │ │ +00031cb0: 2c20 2050 7265 763a 2072 6562 6f6f 742c , Prev: reboot, │ │ │ │ │ +00031cc0: 2020 5570 3a20 436f 6d6d 616e 642d 6c69 Up: Command-li │ │ │ │ │ +00031cd0: 6e65 2061 6e64 206d 656e 7520 656e 7472 ne and menu entr │ │ │ │ │ +00031ce0: 7920 636f 6d6d 616e 6473 0a0a 3136 2e33 y commands..16.3 │ │ │ │ │ +00031cf0: 2e36 3220 7265 6765 7870 0a2d 2d2d 2d2d .62 regexp.----- │ │ │ │ │ +00031d00: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 ---------.. -- C │ │ │ │ │ +00031d10: 6f6d 6d61 6e64 3a20 7265 6765 7870 205b ommand: regexp [ │ │ │ │ │ +00031d20: 2d2d 7365 7420 5b6e 756d 6265 723a 5d76 --set [number:]v │ │ │ │ │ +00031d30: 6172 5d20 7265 6765 7870 2073 7472 696e ar] regexp strin │ │ │ │ │ +00031d40: 670a 2020 2020 2054 6573 7420 6966 2072 g. Test if r │ │ │ │ │ +00031d50: 6567 756c 6172 2065 7870 7265 7373 696f egular expressio │ │ │ │ │ +00031d60: 6e20 5245 4745 5850 206d 6174 6368 6573 n REGEXP matches │ │ │ │ │ +00031d70: 2053 5452 494e 472e 2020 5375 7070 6f72 STRING. Suppor │ │ │ │ │ +00031d80: 7465 640a 2020 2020 2072 6567 756c 6172 ted. regular │ │ │ │ │ +00031d90: 2065 7870 7265 7373 696f 6e73 2061 7265 expressions are │ │ │ │ │ +00031da0: 2050 4f53 4958 2e32 2045 7874 656e 6465 POSIX.2 Extende │ │ │ │ │ +00031db0: 6420 5265 6775 6c61 7220 4578 7072 6573 d Regular Expres │ │ │ │ │ +00031dc0: 7369 6f6e 732e 2020 4966 0a20 2020 2020 sions. If. │ │ │ │ │ +00031dd0: 6f70 7469 6f6e 2027 2d2d 7365 7427 2069 option '--set' i │ │ │ │ │ +00031de0: 7320 6769 7665 6e2c 2073 746f 7265 204e s given, store N │ │ │ │ │ +00031df0: 554d 4245 5274 6820 6d61 7463 6865 6420 UMBERth matched │ │ │ │ │ +00031e00: 7375 6265 7870 7265 7373 696f 6e20 696e subexpression in │ │ │ │ │ +00031e10: 0a20 2020 2020 7661 7269 6162 6c65 2056 . variable V │ │ │ │ │ +00031e20: 4152 2e20 2053 7562 6578 7072 6573 7369 AR. Subexpressi │ │ │ │ │ +00031e30: 6f6e 7320 6172 6520 6e75 6d62 6572 6564 ons are numbered │ │ │ │ │ +00031e40: 2069 6e20 6f72 6465 7220 6f66 2074 6865 in order of the │ │ │ │ │ +00031e50: 6972 0a20 2020 2020 6f70 656e 696e 6720 ir. opening │ │ │ │ │ +00031e60: 7061 7265 6e74 6865 7365 7320 7374 6172 parentheses star │ │ │ │ │ +00031e70: 7469 6e67 2066 726f 6d20 2731 272e 2020 ting from '1'. │ │ │ │ │ +00031e80: 4e55 4d42 4552 2064 6566 6175 6c74 7320 NUMBER defaults │ │ │ │ │ +00031e90: 746f 2027 3127 2e0a 0a1f 0a46 696c 653a to '1'.....File: │ │ │ │ │ +00031ea0: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ +00031eb0: 653a 2072 6d6d 6f64 2c20 204e 6578 743a e: rmmod, Next: │ │ │ │ │ +00031ec0: 2073 6176 655f 656e 762c 2020 5072 6576 save_env, Prev │ │ │ │ │ +00031ed0: 3a20 7265 6765 7870 2c20 2055 703a 2043 : regexp, Up: C │ │ │ │ │ +00031ee0: 6f6d 6d61 6e64 2d6c 696e 6520 616e 6420 ommand-line and │ │ │ │ │ +00031ef0: 6d65 6e75 2065 6e74 7279 2063 6f6d 6d61 menu entry comma │ │ │ │ │ +00031f00: 6e64 730a 0a31 362e 332e 3633 2072 6d6d nds..16.3.63 rmm │ │ │ │ │ +00031f10: 6f64 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d od.------------- │ │ │ │ │ +00031f20: 0a0a 202d 2d20 436f 6d6d 616e 643a 2072 .. -- Command: r │ │ │ │ │ +00031f30: 6d6d 6f64 206d 6f64 756c 650a 2020 2020 mmod module. │ │ │ │ │ +00031f40: 2052 656d 6f76 6520 6120 6c6f 6164 6564 Remove a loaded │ │ │ │ │ +00031f50: 204d 4f44 554c 452e 0a0a 1f0a 4669 6c65 MODULE.....File │ │ │ │ │ +00031f60: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ +00031f70: 6465 3a20 7361 7665 5f65 6e76 2c20 204e de: save_env, N │ │ │ │ │ +00031f80: 6578 743a 2073 6561 7263 682c 2020 5072 ext: search, Pr │ │ │ │ │ +00031f90: 6576 3a20 726d 6d6f 642c 2020 5570 3a20 ev: rmmod, Up: │ │ │ │ │ +00031fa0: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ +00031fb0: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ │ +00031fc0: 616e 6473 0a0a 3136 2e33 2e36 3420 7361 ands..16.3.64 sa │ │ │ │ │ +00031fd0: 7665 5f65 6e76 0a2d 2d2d 2d2d 2d2d 2d2d ve_env.--------- │ │ │ │ │ +00031fe0: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d -------.. -- Com │ │ │ │ │ +00031ff0: 6d61 6e64 3a20 7361 7665 5f65 6e76 205b mand: save_env [ │ │ │ │ │ +00032000: 2d2d 6669 6c65 2066 696c 655d 2076 6172 --file file] var │ │ │ │ │ +00032010: 202e 2e2e 0a20 2020 2020 5361 7665 2074 .... Save t │ │ │ │ │ +00032020: 6865 206e 616d 6564 2076 6172 6961 626c he named variabl │ │ │ │ │ +00032030: 6573 2066 726f 6d20 7468 6520 656e 7669 es from the envi │ │ │ │ │ +00032040: 726f 6e6d 656e 7420 746f 2074 6865 2065 ronment to the e │ │ │ │ │ +00032050: 6e76 6972 6f6e 6d65 6e74 0a20 2020 2020 nvironment. │ │ │ │ │ +00032060: 626c 6f63 6b20 6669 6c65 2e20 202a 4e6f block file. *No │ │ │ │ │ +00032070: 7465 2045 6e76 6972 6f6e 6d65 6e74 2062 te Environment b │ │ │ │ │ +00032080: 6c6f 636b 3a3a 2e0a 0a20 2020 2020 5468 lock::... Th │ │ │ │ │ +00032090: 6520 272d 2d66 696c 6527 206f 7074 696f e '--file' optio │ │ │ │ │ +000320a0: 6e20 6f76 6572 7269 6465 7320 7468 6520 n overrides the │ │ │ │ │ +000320b0: 6465 6661 756c 7420 6c6f 6361 7469 6f6e default location │ │ │ │ │ +000320c0: 206f 6620 7468 650a 2020 2020 2065 6e76 of the. env │ │ │ │ │ +000320d0: 6972 6f6e 6d65 6e74 2062 6c6f 636b 2e0a ironment block.. │ │ │ │ │ +000320e0: 0a20 2020 2020 5468 6973 2063 6f6d 6d61 . This comma │ │ │ │ │ +000320f0: 6e64 2077 696c 6c20 6f70 6572 6174 6520 nd will operate │ │ │ │ │ +00032100: 7375 6363 6573 7366 756c 6c79 2065 7665 successfully eve │ │ │ │ │ +00032110: 6e20 7768 656e 2065 6e76 6972 6f6e 6d65 n when environme │ │ │ │ │ +00032120: 6e74 0a20 2020 2020 7661 7269 6162 6c65 nt. variable │ │ │ │ │ +00032130: 2027 6368 6563 6b5f 7369 676e 6174 7572 'check_signatur │ │ │ │ │ +00032140: 6573 2720 6973 2073 6574 2074 6f20 2765 es' is set to 'e │ │ │ │ │ +00032150: 6e66 6f72 6365 2720 282a 6e6f 7465 0a20 nforce' (*note. │ │ │ │ │ +00032160: 2020 2020 6368 6563 6b5f 7369 676e 6174 check_signat │ │ │ │ │ +00032170: 7572 6573 3a3a 292c 2073 696e 6365 2069 ures::), since i │ │ │ │ │ +00032180: 7420 7772 6974 6573 2074 6f20 6469 736b t writes to disk │ │ │ │ │ +00032190: 2061 6e64 2064 6f65 7320 6e6f 7420 616c and does not al │ │ │ │ │ +000321a0: 7465 7220 7468 650a 2020 2020 2062 6568 ter the. beh │ │ │ │ │ +000321b0: 6176 696f 7220 6f66 2047 5255 4220 6261 avior of GRUB ba │ │ │ │ │ +000321c0: 7365 6420 6f6e 2061 6e79 2063 6f6e 7465 sed on any conte │ │ │ │ │ +000321d0: 6e74 7320 6f66 2064 6973 6b20 7468 6174 nts of disk that │ │ │ │ │ +000321e0: 2068 6176 6520 6265 656e 2072 6561 642e have been read. │ │ │ │ │ +000321f0: 0a20 2020 2020 4974 2069 7320 706f 7373 . It is poss │ │ │ │ │ +00032200: 6962 6c65 2074 6f20 6d6f 6469 6679 2061 ible to modify a │ │ │ │ │ +00032210: 2064 6967 6974 616c 6c79 2073 6967 6e65 digitally signe │ │ │ │ │ +00032220: 6420 656e 7669 726f 6e6d 656e 7420 626c d environment bl │ │ │ │ │ +00032230: 6f63 6b20 6669 6c65 0a20 2020 2020 6672 ock file. fr │ │ │ │ │ +00032240: 6f6d 2077 6974 6869 6e20 4752 5542 2075 om within GRUB u │ │ │ │ │ +00032250: 7369 6e67 2074 6869 7320 636f 6d6d 616e sing this comman │ │ │ │ │ +00032260: 642c 2073 7563 6820 7468 6174 2069 7473 d, such that its │ │ │ │ │ +00032270: 2073 6967 6e61 7475 7265 2077 696c 6c0a signature will. │ │ │ │ │ +00032280: 2020 2020 206e 6f20 6c6f 6e67 6572 2062 no longer b │ │ │ │ │ +00032290: 6520 7661 6c69 6420 6f6e 2073 7562 7365 e valid on subse │ │ │ │ │ +000322a0: 7175 656e 7420 626f 6f74 732e 2020 4361 quent boots. Ca │ │ │ │ │ +000322b0: 7265 2073 686f 756c 6420 6265 2074 616b re should be tak │ │ │ │ │ +000322c0: 656e 2069 6e0a 2020 2020 2073 7563 6820 en in. such │ │ │ │ │ +000322d0: 6164 7661 6e63 6564 2063 6f6e 6669 6775 advanced configu │ │ │ │ │ +000322e0: 7261 7469 6f6e 7320 746f 2061 766f 6964 rations to avoid │ │ │ │ │ +000322f0: 2072 656e 6465 7269 6e67 2074 6865 2073 rendering the s │ │ │ │ │ +00032300: 7973 7465 6d0a 2020 2020 2075 6e62 6f6f ystem. unboo │ │ │ │ │ +00032310: 7461 626c 652e 2020 2a4e 6f74 6520 5573 table. *Note Us │ │ │ │ │ +00032320: 696e 6720 6469 6769 7461 6c20 7369 676e ing digital sign │ │ │ │ │ +00032330: 6174 7572 6573 3a3a 2c20 666f 7220 6d6f atures::, for mo │ │ │ │ │ +00032340: 7265 0a20 2020 2020 696e 666f 726d 6174 re. informat │ │ │ │ │ +00032350: 696f 6e2e 0a0a 1f0a 4669 6c65 3a20 6772 ion.....File: gr │ │ │ │ │ +00032360: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ +00032370: 7365 6172 6368 2c20 204e 6578 743a 2073 search, Next: s │ │ │ │ │ +00032380: 656e 646b 6579 2c20 2050 7265 763a 2073 endkey, Prev: s │ │ │ │ │ +00032390: 6176 655f 656e 762c 2020 5570 3a20 436f ave_env, Up: Co │ │ │ │ │ +000323a0: 6d6d 616e 642d 6c69 6e65 2061 6e64 206d mmand-line and m │ │ │ │ │ +000323b0: 656e 7520 656e 7472 7920 636f 6d6d 616e enu entry comman │ │ │ │ │ +000323c0: 6473 0a0a 3136 2e33 2e36 3520 7365 6172 ds..16.3.65 sear │ │ │ │ │ +000323d0: 6368 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ch.------------- │ │ │ │ │ +000323e0: 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 -.. -- Command: │ │ │ │ │ +000323f0: 7365 6172 6368 205b 2d2d 6669 6c65 7c2d search [--file|- │ │ │ │ │ +00032400: 2d6c 6162 656c 7c2d 2d66 732d 7575 6964 -label|--fs-uuid │ │ │ │ │ +00032410: 5d20 5b2d 2d73 6574 205b 7661 725d 5d0a ] [--set [var]]. │ │ │ │ │ +00032420: 2020 2020 2020 2020 2020 5b2d 2d6e 6f2d [--no- │ │ │ │ │ +00032430: 666c 6f70 7079 5d20 6e61 6d65 0a20 2020 floppy] name. │ │ │ │ │ +00032440: 2020 5365 6172 6368 2064 6576 6963 6573 Search devices │ │ │ │ │ +00032450: 2062 7920 6669 6c65 2028 272d 6627 2c20 by file ('-f', │ │ │ │ │ +00032460: 272d 2d66 696c 6527 292c 2066 696c 6573 '--file'), files │ │ │ │ │ +00032470: 7973 7465 6d20 6c61 6265 6c20 2827 2d6c ystem label ('-l │ │ │ │ │ +00032480: 272c 0a20 2020 2020 272d 2d6c 6162 656c ',. '--label │ │ │ │ │ +00032490: 2729 2c20 6f72 2066 696c 6573 7973 7465 '), or filesyste │ │ │ │ │ +000324a0: 6d20 5555 4944 2028 272d 7527 2c20 272d m UUID ('-u', '- │ │ │ │ │ +000324b0: 2d66 732d 7575 6964 2729 2e0a 0a20 2020 -fs-uuid')... │ │ │ │ │ +000324c0: 2020 4966 2074 6865 2027 2d2d 7365 7427 If the '--set' │ │ │ │ │ +000324d0: 206f 7074 696f 6e20 6973 2075 7365 642c option is used, │ │ │ │ │ +000324e0: 2074 6865 2066 6972 7374 2064 6576 6963 the first devic │ │ │ │ │ +000324f0: 6520 666f 756e 6420 6973 2073 6574 2061 e found is set a │ │ │ │ │ +00032500: 7320 7468 650a 2020 2020 2076 616c 7565 s the. value │ │ │ │ │ +00032510: 206f 6620 656e 7669 726f 6e6d 656e 7420 of environment │ │ │ │ │ +00032520: 7661 7269 6162 6c65 2056 4152 2e20 2054 variable VAR. T │ │ │ │ │ +00032530: 6865 2064 6566 6175 6c74 2076 6172 6961 he default varia │ │ │ │ │ +00032540: 626c 6520 6973 2027 726f 6f74 272e 0a0a ble is 'root'... │ │ │ │ │ +00032550: 2020 2020 2054 6865 2027 2d2d 6e6f 2d66 The '--no-f │ │ │ │ │ +00032560: 6c6f 7070 7927 206f 7074 696f 6e20 7072 loppy' option pr │ │ │ │ │ +00032570: 6576 656e 7473 2073 6561 7263 6869 6e67 events searching │ │ │ │ │ +00032580: 2066 6c6f 7070 7920 6465 7669 6365 732c floppy devices, │ │ │ │ │ +00032590: 2077 6869 6368 0a20 2020 2020 6361 6e20 which. can │ │ │ │ │ +000325a0: 6265 2073 6c6f 772e 0a0a 2020 2020 2054 be slow... T │ │ │ │ │ +000325b0: 6865 2027 7365 6172 6368 2e66 696c 6527 he 'search.file' │ │ │ │ │ +000325c0: 2c20 2773 6561 7263 682e 6673 5f6c 6162 , 'search.fs_lab │ │ │ │ │ +000325d0: 656c 272c 2061 6e64 2027 7365 6172 6368 el', and 'search │ │ │ │ │ +000325e0: 2e66 735f 7575 6964 2720 636f 6d6d 616e .fs_uuid' comman │ │ │ │ │ +000325f0: 6473 0a20 2020 2020 6172 6520 616c 6961 ds. are alia │ │ │ │ │ +00032600: 7365 7320 666f 7220 2773 6561 7263 6820 ses for 'search │ │ │ │ │ +00032610: 2d2d 6669 6c65 272c 2027 7365 6172 6368 --file', 'search │ │ │ │ │ +00032620: 202d 2d6c 6162 656c 272c 2061 6e64 2027 --label', and ' │ │ │ │ │ +00032630: 7365 6172 6368 0a20 2020 2020 2d2d 6673 search. --fs │ │ │ │ │ +00032640: 2d75 7569 6427 2072 6573 7065 6374 6976 -uuid' respectiv │ │ │ │ │ +00032650: 656c 792e 0a0a 1f0a 4669 6c65 3a20 6772 ely.....File: gr │ │ │ │ │ +00032660: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ +00032670: 7365 6e64 6b65 792c 2020 4e65 7874 3a20 sendkey, Next: │ │ │ │ │ +00032680: 7365 742c 2020 5072 6576 3a20 7365 6172 set, Prev: sear │ │ │ │ │ +00032690: 6368 2c20 2055 703a 2043 6f6d 6d61 6e64 ch, Up: Command │ │ │ │ │ +000326a0: 2d6c 696e 6520 616e 6420 6d65 6e75 2065 -line and menu e │ │ │ │ │ +000326b0: 6e74 7279 2063 6f6d 6d61 6e64 730a 0a31 ntry commands..1 │ │ │ │ │ +000326c0: 362e 332e 3636 2073 656e 646b 6579 0a2d 6.3.66 sendkey.- │ │ │ │ │ +000326d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ +000326e0: 202d 2d20 436f 6d6d 616e 643a 2073 656e -- Command: sen │ │ │ │ │ +000326f0: 646b 6579 0a20 2020 2020 2020 2020 205b dkey. [ │ │ │ │ │ +00032700: 2d2d 6e75 6d7c 2d2d 6361 7073 7c2d 2d73 --num|--caps|--s │ │ │ │ │ +00032710: 6372 6f6c 6c7c 2d2d 696e 7365 7274 7c2d croll|--insert|- │ │ │ │ │ +00032720: 2d70 6175 7365 7c2d 2d6c 6566 742d 7368 -pause|--left-sh │ │ │ │ │ +00032730: 6966 747c 2d2d 7269 6768 742d 7368 6966 ift|--right-shif │ │ │ │ │ +00032740: 747c 2d2d 7379 7372 717c 2d2d 6e75 6d6b t|--sysrq|--numk │ │ │ │ │ +00032750: 6579 7c2d 2d63 6170 736b 6579 7c2d 2d73 ey|--capskey|--s │ │ │ │ │ +00032760: 6372 6f6c 6c6b 6579 7c2d 2d69 6e73 6572 crollkey|--inser │ │ │ │ │ +00032770: 746b 6579 7c2d 2d6c 6566 742d 616c 747c tkey|--left-alt| │ │ │ │ │ +00032780: 2d2d 7269 6768 742d 616c 747c 2d2d 6c65 --right-alt|--le │ │ │ │ │ +00032790: 6674 2d63 7472 6c7c 2d2d 7269 6768 742d ft-ctrl|--right- │ │ │ │ │ +000327a0: 6374 726c 0a20 2020 2020 2020 2020 206f ctrl. o │ │ │ │ │ +000327b0: 6e7c 6f66 665d 2e2e 2e20 5b6e 6f2d 6c65 n|off]... [no-le │ │ │ │ │ +000327c0: 645d 206b 6579 7374 726f 6b65 0a20 2020 d] keystroke. │ │ │ │ │ +000327d0: 2020 496e 7365 7274 206b 6579 7374 726f Insert keystro │ │ │ │ │ +000327e0: 6b65 7320 696e 746f 2074 6865 206b 6579 kes into the key │ │ │ │ │ +000327f0: 626f 6172 6420 6275 6666 6572 2077 6865 board buffer whe │ │ │ │ │ +00032800: 6e20 626f 6f74 696e 672e 2020 536f 6d65 n booting. Some │ │ │ │ │ +00032810: 7469 6d65 730a 2020 2020 2061 6e20 6f70 times. an op │ │ │ │ │ +00032820: 6572 6174 696e 6720 7379 7374 656d 206f erating system o │ │ │ │ │ +00032830: 7220 6368 6169 6e6c 6f61 6465 6420 626f r chainloaded bo │ │ │ │ │ +00032840: 6f74 206c 6f61 6465 7220 7265 7175 6972 ot loader requir │ │ │ │ │ +00032850: 6573 2070 6172 7469 6375 6c61 720a 2020 es particular. │ │ │ │ │ +00032860: 2020 206b 6579 7320 746f 2062 6520 7072 keys to be pr │ │ │ │ │ +00032870: 6573 7365 643a 2066 6f72 2065 7861 6d70 essed: for examp │ │ │ │ │ +00032880: 6c65 2c20 6f6e 6520 6d69 6768 7420 6e65 le, one might ne │ │ │ │ │ +00032890: 6564 2074 6f20 7072 6573 7320 610a 2020 ed to press a. │ │ │ │ │ +000328a0: 2020 2070 6172 7469 6375 6c61 7220 6b65 particular ke │ │ │ │ │ +000328b0: 7920 746f 2065 6e74 6572 2022 7361 6665 y to enter "safe │ │ │ │ │ +000328c0: 206d 6f64 6522 2c20 6f72 2077 6865 6e20 mode", or when │ │ │ │ │ +000328d0: 6368 6169 6e6c 6f61 6469 6e67 2061 6e6f chainloading ano │ │ │ │ │ +000328e0: 7468 6572 0a20 2020 2020 626f 6f74 206c ther. boot l │ │ │ │ │ +000328f0: 6f61 6465 7220 6f6e 6520 6d69 6768 7420 oader one might │ │ │ │ │ +00032900: 7365 6e64 206b 6579 7374 726f 6b65 7320 send keystrokes │ │ │ │ │ +00032910: 746f 2069 7420 746f 206e 6176 6967 6174 to it to navigat │ │ │ │ │ +00032920: 6520 6974 7320 6d65 6e75 2e0a 0a20 2020 e its menu... │ │ │ │ │ +00032930: 2020 596f 7520 6d61 7920 7072 6f76 6964 You may provid │ │ │ │ │ +00032940: 6520 7570 2074 6f20 3136 206b 6579 7374 e up to 16 keyst │ │ │ │ │ +00032950: 726f 6b65 7320 2874 6865 206c 656e 6774 rokes (the lengt │ │ │ │ │ +00032960: 6820 6f66 2074 6865 2042 494f 530a 2020 h of the BIOS. │ │ │ │ │ +00032970: 2020 206b 6579 626f 6172 6420 6275 6666 keyboard buff │ │ │ │ │ +00032980: 6572 292e 2020 4b65 7973 7472 6f6b 6520 er). Keystroke │ │ │ │ │ +00032990: 6e61 6d65 7320 6d61 7920 6265 2075 7070 names may be upp │ │ │ │ │ +000329a0: 6572 2d63 6173 6520 6f72 206c 6f77 6572 er-case or lower │ │ │ │ │ +000329b0: 2d63 6173 650a 2020 2020 206c 6574 7465 -case. lette │ │ │ │ │ +000329c0: 7273 2c20 6469 6769 7473 2c20 6f72 2074 rs, digits, or t │ │ │ │ │ +000329d0: 616b 656e 2066 726f 6d20 7468 6520 666f aken from the fo │ │ │ │ │ +000329e0: 6c6c 6f77 696e 6720 7461 626c 653a 0a0a llowing table:.. │ │ │ │ │ +000329f0: 2020 2020 204e 616d 6520 2020 2020 2020 Name │ │ │ │ │ 00032a00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00032a10: 2020 2020 204b 6579 0a20 2020 2020 2d2d Key. -- │ │ │ │ │ +00032a10: 2020 204b 6579 0a20 2020 2020 2d2d 2d2d Key. ---- │ │ │ │ │ 00032a20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 00032a30: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 00032a40: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00032a50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00032a60: 2d0a 2020 2020 2065 7363 6170 6520 2020 -. escape │ │ │ │ │ +00032a50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ +00032a60: 2020 2020 2065 7363 6170 6520 2020 2020 escape │ │ │ │ │ 00032a70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00032a80: 2020 2020 2045 7363 6170 650a 2020 2020 Escape. │ │ │ │ │ -00032a90: 2065 7863 6c61 6d20 2020 2020 2020 2020 exclam │ │ │ │ │ -00032aa0: 2020 2020 2020 2020 2020 2020 2020 2021 ! │ │ │ │ │ -00032ab0: 0a20 2020 2020 6174 2020 2020 2020 2020 . at │ │ │ │ │ +00032a80: 2020 2045 7363 6170 650a 2020 2020 2065 Escape. e │ │ │ │ │ +00032a90: 7863 6c61 6d20 2020 2020 2020 2020 2020 xclam │ │ │ │ │ +00032aa0: 2020 2020 2020 2020 2020 2020 2021 0a20 !. │ │ │ │ │ +00032ab0: 2020 2020 6174 2020 2020 2020 2020 2020 at │ │ │ │ │ 00032ac0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00032ad0: 2020 2020 400a 2020 2020 206e 756d 6265 @. numbe │ │ │ │ │ -00032ae0: 7273 6967 6e20 2020 2020 2020 2020 2020 rsign │ │ │ │ │ -00032af0: 2020 2020 2020 2020 2023 0a20 2020 2020 #. │ │ │ │ │ -00032b00: 646f 6c6c 6172 2020 2020 2020 2020 2020 dollar │ │ │ │ │ -00032b10: 2020 2020 2020 2020 2020 2020 2020 240a $. │ │ │ │ │ -00032b20: 2020 2020 2070 6572 6365 6e74 2020 2020 percent │ │ │ │ │ +00032ad0: 2020 400a 2020 2020 206e 756d 6265 7273 @. numbers │ │ │ │ │ +00032ae0: 6967 6e20 2020 2020 2020 2020 2020 2020 ign │ │ │ │ │ +00032af0: 2020 2020 2020 2023 0a20 2020 2020 646f #. do │ │ │ │ │ +00032b00: 6c6c 6172 2020 2020 2020 2020 2020 2020 llar │ │ │ │ │ +00032b10: 2020 2020 2020 2020 2020 2020 240a 2020 $. │ │ │ │ │ +00032b20: 2020 2070 6572 6365 6e74 2020 2020 2020 percent │ │ │ │ │ 00032b30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00032b40: 2020 2025 0a20 2020 2020 6361 7265 7420 %. caret │ │ │ │ │ +00032b40: 2025 0a20 2020 2020 6361 7265 7420 2020 %. caret │ │ │ │ │ 00032b50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00032b60: 2020 2020 2020 2020 5e0a 2020 2020 2061 ^. a │ │ │ │ │ -00032b70: 6d70 6572 7361 6e64 2020 2020 2020 2020 mpersand │ │ │ │ │ -00032b80: 2020 2020 2020 2020 2020 2020 2026 0a20 &. │ │ │ │ │ -00032b90: 2020 2020 6173 7465 7269 736b 2020 2020 asterisk │ │ │ │ │ +00032b60: 2020 2020 2020 5e0a 2020 2020 2061 6d70 ^. amp │ │ │ │ │ +00032b70: 6572 7361 6e64 2020 2020 2020 2020 2020 ersand │ │ │ │ │ +00032b80: 2020 2020 2020 2020 2020 2026 0a20 2020 &. │ │ │ │ │ +00032b90: 2020 6173 7465 7269 736b 2020 2020 2020 asterisk │ │ │ │ │ 00032ba0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00032bb0: 2020 2a0a 2020 2020 2070 6172 656e 6c65 *. parenle │ │ │ │ │ -00032bc0: 6674 2020 2020 2020 2020 2020 2020 2020 ft │ │ │ │ │ -00032bd0: 2020 2020 2020 2028 0a20 2020 2020 7061 (. pa │ │ │ │ │ -00032be0: 7265 6e72 6967 6874 2020 2020 2020 2020 renright │ │ │ │ │ -00032bf0: 2020 2020 2020 2020 2020 2020 290a 2020 ). │ │ │ │ │ -00032c00: 2020 206d 696e 7573 2020 2020 2020 2020 minus │ │ │ │ │ -00032c10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00032c20: 202d 0a20 2020 2020 756e 6465 7273 636f -. undersco │ │ │ │ │ -00032c30: 7265 2020 2020 2020 2020 2020 2020 2020 re │ │ │ │ │ -00032c40: 2020 2020 2020 5f0a 2020 2020 2065 7175 _. equ │ │ │ │ │ -00032c50: 616c 2020 2020 2020 2020 2020 2020 2020 al │ │ │ │ │ -00032c60: 2020 2020 2020 2020 2020 203d 0a20 2020 =. │ │ │ │ │ -00032c70: 2020 706c 7573 2020 2020 2020 2020 2020 plus │ │ │ │ │ -00032c80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00032c90: 2b0a 2020 2020 2062 6163 6b73 7061 6365 +. backspace │ │ │ │ │ +00032bb0: 2a0a 2020 2020 2070 6172 656e 6c65 6674 *. parenleft │ │ │ │ │ +00032bc0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00032bd0: 2020 2020 2028 0a20 2020 2020 7061 7265 (. pare │ │ │ │ │ +00032be0: 6e72 6967 6874 2020 2020 2020 2020 2020 nright │ │ │ │ │ +00032bf0: 2020 2020 2020 2020 2020 290a 2020 2020 ). │ │ │ │ │ +00032c00: 206d 696e 7573 2020 2020 2020 2020 2020 minus │ │ │ │ │ +00032c10: 2020 2020 2020 2020 2020 2020 2020 202d - │ │ │ │ │ +00032c20: 0a20 2020 2020 756e 6465 7273 636f 7265 . underscore │ │ │ │ │ +00032c30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00032c40: 2020 2020 5f0a 2020 2020 2065 7175 616c _. equal │ │ │ │ │ +00032c50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00032c60: 2020 2020 2020 2020 203d 0a20 2020 2020 =. │ │ │ │ │ +00032c70: 706c 7573 2020 2020 2020 2020 2020 2020 plus │ │ │ │ │ +00032c80: 2020 2020 2020 2020 2020 2020 2020 2b0a +. │ │ │ │ │ +00032c90: 2020 2020 2062 6163 6b73 7061 6365 2020 backspace │ │ │ │ │ 00032ca0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00032cb0: 2020 2020 2042 6163 6b73 7061 6365 0a20 Backspace. │ │ │ │ │ -00032cc0: 2020 2020 7461 6220 2020 2020 2020 2020 tab │ │ │ │ │ +00032cb0: 2020 2042 6163 6b73 7061 6365 0a20 2020 Backspace. │ │ │ │ │ +00032cc0: 2020 7461 6220 2020 2020 2020 2020 2020 tab │ │ │ │ │ 00032cd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00032ce0: 2020 5461 620a 2020 2020 2062 7261 636b Tab. brack │ │ │ │ │ -00032cf0: 6574 6c65 6674 2020 2020 2020 2020 2020 etleft │ │ │ │ │ -00032d00: 2020 2020 2020 2020 205b 0a20 2020 2020 [. │ │ │ │ │ -00032d10: 6272 6163 656c 6566 7420 2020 2020 2020 braceleft │ │ │ │ │ -00032d20: 2020 2020 2020 2020 2020 2020 2020 7b0a {. │ │ │ │ │ -00032d30: 2020 2020 2062 7261 636b 6574 7269 6768 bracketrigh │ │ │ │ │ -00032d40: 7420 2020 2020 2020 2020 2020 2020 2020 t │ │ │ │ │ -00032d50: 2020 205d 0a20 2020 2020 6272 6163 6572 ]. bracer │ │ │ │ │ -00032d60: 6967 6874 2020 2020 2020 2020 2020 2020 ight │ │ │ │ │ -00032d70: 2020 2020 2020 2020 7d0a 2020 2020 2065 }. e │ │ │ │ │ -00032d80: 6e74 6572 2020 2020 2020 2020 2020 2020 nter │ │ │ │ │ -00032d90: 2020 2020 2020 2020 2020 2020 2045 6e74 Ent │ │ │ │ │ -00032da0: 6572 0a20 2020 2020 636f 6e74 726f 6c20 er. control │ │ │ │ │ +00032ce0: 5461 620a 2020 2020 2062 7261 636b 6574 Tab. bracket │ │ │ │ │ +00032cf0: 6c65 6674 2020 2020 2020 2020 2020 2020 left │ │ │ │ │ +00032d00: 2020 2020 2020 205b 0a20 2020 2020 6272 [. br │ │ │ │ │ +00032d10: 6163 656c 6566 7420 2020 2020 2020 2020 aceleft │ │ │ │ │ +00032d20: 2020 2020 2020 2020 2020 2020 7b0a 2020 {. │ │ │ │ │ +00032d30: 2020 2062 7261 636b 6574 7269 6768 7420 bracketright │ │ │ │ │ +00032d40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00032d50: 205d 0a20 2020 2020 6272 6163 6572 6967 ]. bracerig │ │ │ │ │ +00032d60: 6874 2020 2020 2020 2020 2020 2020 2020 ht │ │ │ │ │ +00032d70: 2020 2020 2020 7d0a 2020 2020 2065 6e74 }. ent │ │ │ │ │ +00032d80: 6572 2020 2020 2020 2020 2020 2020 2020 er │ │ │ │ │ +00032d90: 2020 2020 2020 2020 2020 2045 6e74 6572 Enter │ │ │ │ │ +00032da0: 0a20 2020 2020 636f 6e74 726f 6c20 2020 . control │ │ │ │ │ 00032db0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00032dc0: 2020 2020 2020 7072 6573 7320 616e 6420 press and │ │ │ │ │ -00032dd0: 7265 6c65 6173 6520 436f 6e74 726f 6c0a release Control. │ │ │ │ │ -00032de0: 2020 2020 2073 656d 6963 6f6c 6f6e 2020 semicolon │ │ │ │ │ +00032dc0: 2020 2020 7072 6573 7320 616e 6420 7265 press and re │ │ │ │ │ +00032dd0: 6c65 6173 6520 436f 6e74 726f 6c0a 2020 lease Control. │ │ │ │ │ +00032de0: 2020 2073 656d 6963 6f6c 6f6e 2020 2020 semicolon │ │ │ │ │ 00032df0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00032e00: 2020 203b 0a20 2020 2020 636f 6c6f 6e20 ;. colon │ │ │ │ │ +00032e00: 203b 0a20 2020 2020 636f 6c6f 6e20 2020 ;. colon │ │ │ │ │ 00032e10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00032e20: 2020 2020 2020 2020 3a0a 2020 2020 2071 :. q │ │ │ │ │ -00032e30: 756f 7465 2020 2020 2020 2020 2020 2020 uote │ │ │ │ │ -00032e40: 2020 2020 2020 2020 2020 2020 2027 0a20 '. │ │ │ │ │ -00032e50: 2020 2020 646f 7562 6c65 7175 6f74 6520 doublequote │ │ │ │ │ +00032e20: 2020 2020 2020 3a0a 2020 2020 2071 756f :. quo │ │ │ │ │ +00032e30: 7465 2020 2020 2020 2020 2020 2020 2020 te │ │ │ │ │ +00032e40: 2020 2020 2020 2020 2020 2027 0a20 2020 '. │ │ │ │ │ +00032e50: 2020 646f 7562 6c65 7175 6f74 6520 2020 doublequote │ │ │ │ │ 00032e60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00032e70: 2020 220a 2020 2020 2062 6163 6b71 756f ". backquo │ │ │ │ │ -00032e80: 7465 2020 2020 2020 2020 2020 2020 2020 te │ │ │ │ │ -00032e90: 2020 2020 2020 2027 0a20 2020 2020 7469 '. ti │ │ │ │ │ -00032ea0: 6c64 6520 2020 2020 2020 2020 2020 2020 lde │ │ │ │ │ -00032eb0: 2020 2020 2020 2020 2020 2020 7e0a 2020 ~. │ │ │ │ │ -00032ec0: 2020 2073 6869 6674 2020 2020 2020 2020 shift │ │ │ │ │ -00032ed0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00032ee0: 2070 7265 7373 2061 6e64 2072 656c 6561 press and relea │ │ │ │ │ -00032ef0: 7365 206c 6566 7420 5368 6966 740a 2020 se left Shift. │ │ │ │ │ -00032f00: 2020 2062 6163 6b73 6c61 7368 2020 2020 backslash │ │ │ │ │ -00032f10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00032f20: 205c 0a20 2020 2020 6261 7220 2020 2020 \. bar │ │ │ │ │ +00032e70: 220a 2020 2020 2062 6163 6b71 756f 7465 ". backquote │ │ │ │ │ +00032e80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00032e90: 2020 2020 2027 0a20 2020 2020 7469 6c64 '. tild │ │ │ │ │ +00032ea0: 6520 2020 2020 2020 2020 2020 2020 2020 e │ │ │ │ │ +00032eb0: 2020 2020 2020 2020 2020 7e0a 2020 2020 ~. │ │ │ │ │ +00032ec0: 2073 6869 6674 2020 2020 2020 2020 2020 shift │ │ │ │ │ +00032ed0: 2020 2020 2020 2020 2020 2020 2020 2070 p │ │ │ │ │ +00032ee0: 7265 7373 2061 6e64 2072 656c 6561 7365 ress and release │ │ │ │ │ +00032ef0: 206c 6566 7420 5368 6966 740a 2020 2020 left Shift. │ │ │ │ │ +00032f00: 2062 6163 6b73 6c61 7368 2020 2020 2020 backslash │ │ │ │ │ +00032f10: 2020 2020 2020 2020 2020 2020 2020 205c \ │ │ │ │ │ +00032f20: 0a20 2020 2020 6261 7220 2020 2020 2020 . bar │ │ │ │ │ 00032f30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00032f40: 2020 2020 2020 7c0a 2020 2020 2063 6f6d |. com │ │ │ │ │ -00032f50: 6d61 2020 2020 2020 2020 2020 2020 2020 ma │ │ │ │ │ -00032f60: 2020 2020 2020 2020 2020 202c 0a20 2020 ,. │ │ │ │ │ -00032f70: 2020 6c65 7373 2020 2020 2020 2020 2020 less │ │ │ │ │ -00032f80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00032f90: 3c0a 2020 2020 2070 6572 696f 6420 2020 <. period │ │ │ │ │ +00032f40: 2020 2020 7c0a 2020 2020 2063 6f6d 6d61 |. comma │ │ │ │ │ +00032f50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00032f60: 2020 2020 2020 2020 202c 0a20 2020 2020 ,. │ │ │ │ │ +00032f70: 6c65 7373 2020 2020 2020 2020 2020 2020 less │ │ │ │ │ +00032f80: 2020 2020 2020 2020 2020 2020 2020 3c0a <. │ │ │ │ │ +00032f90: 2020 2020 2070 6572 696f 6420 2020 2020 period │ │ │ │ │ 00032fa0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00032fb0: 2020 2020 202e 0a20 2020 2020 6772 6561 .. grea │ │ │ │ │ -00032fc0: 7465 7220 2020 2020 2020 2020 2020 2020 ter │ │ │ │ │ -00032fd0: 2020 2020 2020 2020 2020 3e0a 2020 2020 >. │ │ │ │ │ -00032fe0: 2073 6c61 7368 2020 2020 2020 2020 2020 slash │ │ │ │ │ -00032ff0: 2020 2020 2020 2020 2020 2020 2020 202f / │ │ │ │ │ -00033000: 0a20 2020 2020 7175 6573 7469 6f6e 2020 . question │ │ │ │ │ +00032fb0: 2020 202e 0a20 2020 2020 6772 6561 7465 .. greate │ │ │ │ │ +00032fc0: 7220 2020 2020 2020 2020 2020 2020 2020 r │ │ │ │ │ +00032fd0: 2020 2020 2020 2020 3e0a 2020 2020 2073 >. s │ │ │ │ │ +00032fe0: 6c61 7368 2020 2020 2020 2020 2020 2020 lash │ │ │ │ │ +00032ff0: 2020 2020 2020 2020 2020 2020 202f 0a20 /. │ │ │ │ │ +00033000: 2020 2020 7175 6573 7469 6f6e 2020 2020 question │ │ │ │ │ 00033010: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033020: 2020 2020 3f0a 2020 2020 2072 7368 6966 ?. rshif │ │ │ │ │ -00033030: 7420 2020 2020 2020 2020 2020 2020 2020 t │ │ │ │ │ -00033040: 2020 2020 2020 2020 2070 7265 7373 2061 press a │ │ │ │ │ -00033050: 6e64 2072 656c 6561 7365 2072 6967 6874 nd release right │ │ │ │ │ -00033060: 2053 6869 6674 0a20 2020 2020 616c 7420 Shift. alt │ │ │ │ │ +00033020: 2020 3f0a 2020 2020 2072 7368 6966 7420 ?. rshift │ │ │ │ │ +00033030: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00033040: 2020 2020 2020 2070 7265 7373 2061 6e64 press and │ │ │ │ │ +00033050: 2072 656c 6561 7365 2072 6967 6874 2053 release right S │ │ │ │ │ +00033060: 6869 6674 0a20 2020 2020 616c 7420 2020 hift. alt │ │ │ │ │ 00033070: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033080: 2020 2020 2020 2020 2020 7072 6573 7320 press │ │ │ │ │ -00033090: 616e 6420 7265 6c65 6173 6520 416c 740a and release Alt. │ │ │ │ │ -000330a0: 2020 2020 2073 7061 6365 2020 2020 2020 space │ │ │ │ │ +00033080: 2020 2020 2020 2020 7072 6573 7320 616e press an │ │ │ │ │ +00033090: 6420 7265 6c65 6173 6520 416c 740a 2020 d release Alt. │ │ │ │ │ +000330a0: 2020 2073 7061 6365 2020 2020 2020 2020 space │ │ │ │ │ 000330b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000330c0: 2020 2073 7061 6365 2062 6172 0a20 2020 space bar. │ │ │ │ │ -000330d0: 2020 6361 7073 6c6f 636b 2020 2020 2020 capslock │ │ │ │ │ -000330e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000330f0: 4361 7073 204c 6f63 6b0a 2020 2020 2046 Caps Lock. F │ │ │ │ │ -00033100: 3120 2020 2020 2020 2020 2020 2020 2020 1 │ │ │ │ │ -00033110: 2020 2020 2020 2020 2020 2020 2046 310a F1. │ │ │ │ │ -00033120: 2020 2020 2046 3220 2020 2020 2020 2020 F2 │ │ │ │ │ +000330c0: 2073 7061 6365 2062 6172 0a20 2020 2020 space bar. │ │ │ │ │ +000330d0: 6361 7073 6c6f 636b 2020 2020 2020 2020 capslock │ │ │ │ │ +000330e0: 2020 2020 2020 2020 2020 2020 2020 4361 Ca │ │ │ │ │ +000330f0: 7073 204c 6f63 6b0a 2020 2020 2046 3120 ps Lock. F1 │ │ │ │ │ +00033100: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00033110: 2020 2020 2020 2020 2020 2046 310a 2020 F1. │ │ │ │ │ +00033120: 2020 2046 3220 2020 2020 2020 2020 2020 F2 │ │ │ │ │ 00033130: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033140: 2020 2046 320a 2020 2020 2046 3320 2020 F2. F3 │ │ │ │ │ +00033140: 2046 320a 2020 2020 2046 3320 2020 2020 F2. F3 │ │ │ │ │ 00033150: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033160: 2020 2020 2020 2020 2046 330a 2020 2020 F3. │ │ │ │ │ -00033170: 2046 3420 2020 2020 2020 2020 2020 2020 F4 │ │ │ │ │ -00033180: 2020 2020 2020 2020 2020 2020 2020 2046 F │ │ │ │ │ -00033190: 340a 2020 2020 2046 3520 2020 2020 2020 4. F5 │ │ │ │ │ +00033160: 2020 2020 2020 2046 330a 2020 2020 2046 F3. F │ │ │ │ │ +00033170: 3420 2020 2020 2020 2020 2020 2020 2020 4 │ │ │ │ │ +00033180: 2020 2020 2020 2020 2020 2020 2046 340a F4. │ │ │ │ │ +00033190: 2020 2020 2046 3520 2020 2020 2020 2020 F5 │ │ │ │ │ 000331a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000331b0: 2020 2020 2046 350a 2020 2020 2046 3620 F5. F6 │ │ │ │ │ +000331b0: 2020 2046 350a 2020 2020 2046 3620 2020 F5. F6 │ │ │ │ │ 000331c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000331d0: 2020 2020 2020 2020 2020 2046 360a 2020 F6. │ │ │ │ │ -000331e0: 2020 2046 3720 2020 2020 2020 2020 2020 F7 │ │ │ │ │ -000331f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033200: 2046 370a 2020 2020 2046 3820 2020 2020 F7. F8 │ │ │ │ │ +000331d0: 2020 2020 2020 2020 2046 360a 2020 2020 F6. │ │ │ │ │ +000331e0: 2046 3720 2020 2020 2020 2020 2020 2020 F7 │ │ │ │ │ +000331f0: 2020 2020 2020 2020 2020 2020 2020 2046 F │ │ │ │ │ +00033200: 370a 2020 2020 2046 3820 2020 2020 2020 7. F8 │ │ │ │ │ 00033210: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033220: 2020 2020 2020 2046 380a 2020 2020 2046 F8. F │ │ │ │ │ -00033230: 3920 2020 2020 2020 2020 2020 2020 2020 9 │ │ │ │ │ -00033240: 2020 2020 2020 2020 2020 2020 2046 390a F9. │ │ │ │ │ -00033250: 2020 2020 2046 3130 2020 2020 2020 2020 F10 │ │ │ │ │ +00033220: 2020 2020 2046 380a 2020 2020 2046 3920 F8. F9 │ │ │ │ │ +00033230: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00033240: 2020 2020 2020 2020 2020 2046 390a 2020 F9. │ │ │ │ │ +00033250: 2020 2046 3130 2020 2020 2020 2020 2020 F10 │ │ │ │ │ 00033260: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033270: 2020 2046 3130 0a20 2020 2020 4631 3120 F10. F11 │ │ │ │ │ +00033270: 2046 3130 0a20 2020 2020 4631 3120 2020 F10. F11 │ │ │ │ │ 00033280: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033290: 2020 2020 2020 2020 2020 4631 310a 2020 F11. │ │ │ │ │ -000332a0: 2020 2046 3132 2020 2020 2020 2020 2020 F12 │ │ │ │ │ -000332b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000332c0: 2046 3132 0a20 2020 2020 6e75 6d31 2020 F12. num1 │ │ │ │ │ +00033290: 2020 2020 2020 2020 4631 310a 2020 2020 F11. │ │ │ │ │ +000332a0: 2046 3132 2020 2020 2020 2020 2020 2020 F12 │ │ │ │ │ +000332b0: 2020 2020 2020 2020 2020 2020 2020 2046 F │ │ │ │ │ +000332c0: 3132 0a20 2020 2020 6e75 6d31 2020 2020 12. num1 │ │ │ │ │ 000332d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000332e0: 2020 2020 2020 2020 3120 286e 756d 6572 1 (numer │ │ │ │ │ -000332f0: 6963 206b 6579 7061 6429 0a20 2020 2020 ic keypad). │ │ │ │ │ -00033300: 6e75 6d32 2020 2020 2020 2020 2020 2020 num2 │ │ │ │ │ -00033310: 2020 2020 2020 2020 2020 2020 2020 3220 2 │ │ │ │ │ -00033320: 286e 756d 6572 6963 206b 6579 7061 6429 (numeric keypad) │ │ │ │ │ -00033330: 0a20 2020 2020 6e75 6d33 2020 2020 2020 . num3 │ │ │ │ │ +000332e0: 2020 2020 2020 3120 286e 756d 6572 6963 1 (numeric │ │ │ │ │ +000332f0: 206b 6579 7061 6429 0a20 2020 2020 6e75 keypad). nu │ │ │ │ │ +00033300: 6d32 2020 2020 2020 2020 2020 2020 2020 m2 │ │ │ │ │ +00033310: 2020 2020 2020 2020 2020 2020 3220 286e 2 (n │ │ │ │ │ +00033320: 756d 6572 6963 206b 6579 7061 6429 0a20 umeric keypad). │ │ │ │ │ +00033330: 2020 2020 6e75 6d33 2020 2020 2020 2020 num3 │ │ │ │ │ 00033340: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033350: 2020 2020 3320 286e 756d 6572 6963 206b 3 (numeric k │ │ │ │ │ -00033360: 6579 7061 6429 0a20 2020 2020 6e75 6d34 eypad). num4 │ │ │ │ │ +00033350: 2020 3320 286e 756d 6572 6963 206b 6579 3 (numeric key │ │ │ │ │ +00033360: 7061 6429 0a20 2020 2020 6e75 6d34 2020 pad). num4 │ │ │ │ │ 00033370: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033380: 2020 2020 2020 2020 2020 3420 286e 756d 4 (num │ │ │ │ │ -00033390: 6572 6963 206b 6579 7061 6429 0a20 2020 eric keypad). │ │ │ │ │ -000333a0: 2020 6e75 6d35 2020 2020 2020 2020 2020 num5 │ │ │ │ │ -000333b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000333c0: 3520 286e 756d 6572 6963 206b 6579 7061 5 (numeric keypa │ │ │ │ │ -000333d0: 6429 0a20 2020 2020 6e75 6d36 2020 2020 d). num6 │ │ │ │ │ +00033380: 2020 2020 2020 2020 3420 286e 756d 6572 4 (numer │ │ │ │ │ +00033390: 6963 206b 6579 7061 6429 0a20 2020 2020 ic keypad). │ │ │ │ │ +000333a0: 6e75 6d35 2020 2020 2020 2020 2020 2020 num5 │ │ │ │ │ +000333b0: 2020 2020 2020 2020 2020 2020 2020 3520 5 │ │ │ │ │ +000333c0: 286e 756d 6572 6963 206b 6579 7061 6429 (numeric keypad) │ │ │ │ │ +000333d0: 0a20 2020 2020 6e75 6d36 2020 2020 2020 . num6 │ │ │ │ │ 000333e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000333f0: 2020 2020 2020 3620 286e 756d 6572 6963 6 (numeric │ │ │ │ │ -00033400: 206b 6579 7061 6429 0a20 2020 2020 6e75 keypad). nu │ │ │ │ │ -00033410: 6d37 2020 2020 2020 2020 2020 2020 2020 m7 │ │ │ │ │ -00033420: 2020 2020 2020 2020 2020 2020 3720 286e 7 (n │ │ │ │ │ -00033430: 756d 6572 6963 206b 6579 7061 6429 0a20 umeric keypad). │ │ │ │ │ -00033440: 2020 2020 6e75 6d38 2020 2020 2020 2020 num8 │ │ │ │ │ +000333f0: 2020 2020 3620 286e 756d 6572 6963 206b 6 (numeric k │ │ │ │ │ +00033400: 6579 7061 6429 0a20 2020 2020 6e75 6d37 eypad). num7 │ │ │ │ │ +00033410: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00033420: 2020 2020 2020 2020 2020 3720 286e 756d 7 (num │ │ │ │ │ +00033430: 6572 6963 206b 6579 7061 6429 0a20 2020 eric keypad). │ │ │ │ │ +00033440: 2020 6e75 6d38 2020 2020 2020 2020 2020 num8 │ │ │ │ │ 00033450: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033460: 2020 3820 286e 756d 6572 6963 206b 6579 8 (numeric key │ │ │ │ │ -00033470: 7061 6429 0a20 2020 2020 6e75 6d39 2020 pad). num9 │ │ │ │ │ +00033460: 3820 286e 756d 6572 6963 206b 6579 7061 8 (numeric keypa │ │ │ │ │ +00033470: 6429 0a20 2020 2020 6e75 6d39 2020 2020 d). num9 │ │ │ │ │ 00033480: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033490: 2020 2020 2020 2020 3920 286e 756d 6572 9 (numer │ │ │ │ │ -000334a0: 6963 206b 6579 7061 6429 0a20 2020 2020 ic keypad). │ │ │ │ │ -000334b0: 6e75 6d30 2020 2020 2020 2020 2020 2020 num0 │ │ │ │ │ -000334c0: 2020 2020 2020 2020 2020 2020 2020 3020 0 │ │ │ │ │ -000334d0: 286e 756d 6572 6963 206b 6579 7061 6429 (numeric keypad) │ │ │ │ │ -000334e0: 0a20 2020 2020 6e75 6d70 6572 696f 6420 . numperiod │ │ │ │ │ +00033490: 2020 2020 2020 3920 286e 756d 6572 6963 9 (numeric │ │ │ │ │ +000334a0: 206b 6579 7061 6429 0a20 2020 2020 6e75 keypad). nu │ │ │ │ │ +000334b0: 6d30 2020 2020 2020 2020 2020 2020 2020 m0 │ │ │ │ │ +000334c0: 2020 2020 2020 2020 2020 2020 3020 286e 0 (n │ │ │ │ │ +000334d0: 756d 6572 6963 206b 6579 7061 6429 0a20 umeric keypad). │ │ │ │ │ +000334e0: 2020 2020 6e75 6d70 6572 696f 6420 2020 numperiod │ │ │ │ │ 000334f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033500: 2020 2020 2e20 2028 6e75 6d65 7269 6320 . (numeric │ │ │ │ │ -00033510: 6b65 7970 6164 290a 2020 2020 206e 756d keypad). num │ │ │ │ │ -00033520: 656e 6420 2020 2020 2020 2020 2020 2020 end │ │ │ │ │ -00033530: 2020 2020 2020 2020 2020 2045 6e64 2028 End ( │ │ │ │ │ -00033540: 6e75 6d65 7269 6320 6b65 7970 6164 290a numeric keypad). │ │ │ │ │ -00033550: 2020 2020 206e 756d 646f 776e 2020 2020 numdown │ │ │ │ │ +00033500: 2020 2e20 2028 6e75 6d65 7269 6320 6b65 . (numeric ke │ │ │ │ │ +00033510: 7970 6164 290a 2020 2020 206e 756d 656e ypad). numen │ │ │ │ │ +00033520: 6420 2020 2020 2020 2020 2020 2020 2020 d │ │ │ │ │ +00033530: 2020 2020 2020 2020 2045 6e64 2028 6e75 End (nu │ │ │ │ │ +00033540: 6d65 7269 6320 6b65 7970 6164 290a 2020 meric keypad). │ │ │ │ │ +00033550: 2020 206e 756d 646f 776e 2020 2020 2020 numdown │ │ │ │ │ 00033560: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033570: 2020 2044 6f77 6e20 286e 756d 6572 6963 Down (numeric │ │ │ │ │ -00033580: 206b 6579 7061 6429 0a20 2020 2020 6e75 keypad). nu │ │ │ │ │ -00033590: 6d70 6764 6f77 6e20 2020 2020 2020 2020 mpgdown │ │ │ │ │ -000335a0: 2020 2020 2020 2020 2020 2020 5061 6765 Page │ │ │ │ │ -000335b0: 2044 6f77 6e20 286e 756d 6572 6963 206b Down (numeric k │ │ │ │ │ -000335c0: 6579 7061 6429 0a20 2020 2020 6e75 6d6c eypad). numl │ │ │ │ │ -000335d0: 6566 7420 2020 2020 2020 2020 2020 2020 eft │ │ │ │ │ -000335e0: 2020 2020 2020 2020 2020 4c65 6674 2028 Left ( │ │ │ │ │ -000335f0: 6e75 6d65 7269 6320 6b65 7970 6164 290a numeric keypad). │ │ │ │ │ -00033600: 2020 2020 206e 756d 6365 6e74 6572 2020 numcenter │ │ │ │ │ +00033570: 2044 6f77 6e20 286e 756d 6572 6963 206b Down (numeric k │ │ │ │ │ +00033580: 6579 7061 6429 0a20 2020 2020 6e75 6d70 eypad). nump │ │ │ │ │ +00033590: 6764 6f77 6e20 2020 2020 2020 2020 2020 gdown │ │ │ │ │ +000335a0: 2020 2020 2020 2020 2020 5061 6765 2044 Page D │ │ │ │ │ +000335b0: 6f77 6e20 286e 756d 6572 6963 206b 6579 own (numeric key │ │ │ │ │ +000335c0: 7061 6429 0a20 2020 2020 6e75 6d6c 6566 pad). numlef │ │ │ │ │ +000335d0: 7420 2020 2020 2020 2020 2020 2020 2020 t │ │ │ │ │ +000335e0: 2020 2020 2020 2020 4c65 6674 2028 6e75 Left (nu │ │ │ │ │ +000335f0: 6d65 7269 6320 6b65 7970 6164 290a 2020 meric keypad). │ │ │ │ │ +00033600: 2020 206e 756d 6365 6e74 6572 2020 2020 numcenter │ │ │ │ │ 00033610: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033620: 2020 2035 2077 6974 6820 4e75 6d20 4c6f 5 with Num Lo │ │ │ │ │ -00033630: 636b 2069 6e61 6374 6976 6520 286e 756d ck inactive (num │ │ │ │ │ -00033640: 6572 6963 0a20 2020 2020 2020 2020 2020 eric. │ │ │ │ │ +00033620: 2035 2077 6974 6820 4e75 6d20 4c6f 636b 5 with Num Lock │ │ │ │ │ +00033630: 2069 6e61 6374 6976 6520 286e 756d 6572 inactive (numer │ │ │ │ │ +00033640: 6963 0a20 2020 2020 2020 2020 2020 2020 ic. │ │ │ │ │ 00033650: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033660: 2020 2020 2020 2020 6b65 7970 6164 290a keypad). │ │ │ │ │ -00033670: 2020 2020 206e 756d 7269 6768 7420 2020 numright │ │ │ │ │ +00033660: 2020 2020 2020 6b65 7970 6164 290a 2020 keypad). │ │ │ │ │ +00033670: 2020 206e 756d 7269 6768 7420 2020 2020 numright │ │ │ │ │ 00033680: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033690: 2020 2052 6967 6874 2028 6e75 6d65 7269 Right (numeri │ │ │ │ │ -000336a0: 6320 6b65 7970 6164 290a 2020 2020 206e c keypad). n │ │ │ │ │ -000336b0: 756d 686f 6d65 2020 2020 2020 2020 2020 umhome │ │ │ │ │ -000336c0: 2020 2020 2020 2020 2020 2020 2048 6f6d Hom │ │ │ │ │ -000336d0: 6520 286e 756d 6572 6963 206b 6579 7061 e (numeric keypa │ │ │ │ │ -000336e0: 6429 0a20 2020 2020 6e75 6d75 7020 2020 d). numup │ │ │ │ │ +00033690: 2052 6967 6874 2028 6e75 6d65 7269 6320 Right (numeric │ │ │ │ │ +000336a0: 6b65 7970 6164 290a 2020 2020 206e 756d keypad). num │ │ │ │ │ +000336b0: 686f 6d65 2020 2020 2020 2020 2020 2020 home │ │ │ │ │ +000336c0: 2020 2020 2020 2020 2020 2048 6f6d 6520 Home │ │ │ │ │ +000336d0: 286e 756d 6572 6963 206b 6579 7061 6429 (numeric keypad) │ │ │ │ │ +000336e0: 0a20 2020 2020 6e75 6d75 7020 2020 2020 . numup │ │ │ │ │ 000336f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033700: 2020 2020 2020 5570 2028 6e75 6d65 7269 Up (numeri │ │ │ │ │ -00033710: 6320 6b65 7970 6164 290a 2020 2020 206e c keypad). n │ │ │ │ │ -00033720: 756d 7067 7570 2020 2020 2020 2020 2020 umpgup │ │ │ │ │ -00033730: 2020 2020 2020 2020 2020 2020 2050 6167 Pag │ │ │ │ │ -00033740: 6520 5570 2028 6e75 6d65 7269 6320 6b65 e Up (numeric ke │ │ │ │ │ -00033750: 7970 6164 290a 2020 2020 206e 756d 696e ypad). numin │ │ │ │ │ -00033760: 7365 7274 2020 2020 2020 2020 2020 2020 sert │ │ │ │ │ -00033770: 2020 2020 2020 2020 2049 6e73 6572 7420 Insert │ │ │ │ │ -00033780: 286e 756d 6572 6963 206b 6579 7061 6429 (numeric keypad) │ │ │ │ │ -00033790: 0a20 2020 2020 6e75 6d64 656c 6574 6520 . numdelete │ │ │ │ │ +00033700: 2020 2020 5570 2028 6e75 6d65 7269 6320 Up (numeric │ │ │ │ │ +00033710: 6b65 7970 6164 290a 2020 2020 206e 756d keypad). num │ │ │ │ │ +00033720: 7067 7570 2020 2020 2020 2020 2020 2020 pgup │ │ │ │ │ +00033730: 2020 2020 2020 2020 2020 2050 6167 6520 Page │ │ │ │ │ +00033740: 5570 2028 6e75 6d65 7269 6320 6b65 7970 Up (numeric keyp │ │ │ │ │ +00033750: 6164 290a 2020 2020 206e 756d 696e 7365 ad). numinse │ │ │ │ │ +00033760: 7274 2020 2020 2020 2020 2020 2020 2020 rt │ │ │ │ │ +00033770: 2020 2020 2020 2049 6e73 6572 7420 286e Insert (n │ │ │ │ │ +00033780: 756d 6572 6963 206b 6579 7061 6429 0a20 umeric keypad). │ │ │ │ │ +00033790: 2020 2020 6e75 6d64 656c 6574 6520 2020 numdelete │ │ │ │ │ 000337a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000337b0: 2020 2020 4465 6c65 7465 2028 6e75 6d65 Delete (nume │ │ │ │ │ -000337c0: 7269 6320 6b65 7970 6164 290a 2020 2020 ric keypad). │ │ │ │ │ -000337d0: 206e 756d 6173 7465 7269 736b 2020 2020 numasterisk │ │ │ │ │ -000337e0: 2020 2020 2020 2020 2020 2020 2020 202a * │ │ │ │ │ -000337f0: 2028 6e75 6d65 7269 6320 6b65 7970 6164 (numeric keypad │ │ │ │ │ -00033800: 290a 2020 2020 206e 756d 6d69 6e75 7320 ). numminus │ │ │ │ │ +000337b0: 2020 4465 6c65 7465 2028 6e75 6d65 7269 Delete (numeri │ │ │ │ │ +000337c0: 6320 6b65 7970 6164 290a 2020 2020 206e c keypad). n │ │ │ │ │ +000337d0: 756d 6173 7465 7269 736b 2020 2020 2020 umasterisk │ │ │ │ │ +000337e0: 2020 2020 2020 2020 2020 2020 202a 2028 * ( │ │ │ │ │ +000337f0: 6e75 6d65 7269 6320 6b65 7970 6164 290a numeric keypad). │ │ │ │ │ +00033800: 2020 2020 206e 756d 6d69 6e75 7320 2020 numminus │ │ │ │ │ 00033810: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033820: 2020 2020 202d 2028 6e75 6d65 7269 6320 - (numeric │ │ │ │ │ -00033830: 6b65 7970 6164 290a 2020 2020 206e 756d keypad). num │ │ │ │ │ -00033840: 706c 7573 2020 2020 2020 2020 2020 2020 plus │ │ │ │ │ -00033850: 2020 2020 2020 2020 2020 202b 2028 6e75 + (nu │ │ │ │ │ -00033860: 6d65 7269 6320 6b65 7970 6164 290a 2020 meric keypad). │ │ │ │ │ -00033870: 2020 206e 756d 736c 6173 6820 2020 2020 numslash │ │ │ │ │ -00033880: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033890: 202f 2028 6e75 6d65 7269 6320 6b65 7970 / (numeric keyp │ │ │ │ │ -000338a0: 6164 290a 2020 2020 206e 756d 656e 7465 ad). numente │ │ │ │ │ -000338b0: 7220 2020 2020 2020 2020 2020 2020 2020 r │ │ │ │ │ -000338c0: 2020 2020 2020 2045 6e74 6572 2028 6e75 Enter (nu │ │ │ │ │ -000338d0: 6d65 7269 6320 6b65 7970 6164 290a 2020 meric keypad). │ │ │ │ │ -000338e0: 2020 2064 656c 6574 6520 2020 2020 2020 delete │ │ │ │ │ -000338f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033900: 2044 656c 6574 650a 2020 2020 2069 6e73 Delete. ins │ │ │ │ │ -00033910: 6572 7420 2020 2020 2020 2020 2020 2020 ert │ │ │ │ │ -00033920: 2020 2020 2020 2020 2020 2049 6e73 6572 Inser │ │ │ │ │ -00033930: 740a 2020 2020 2068 6f6d 6520 2020 2020 t. home │ │ │ │ │ +00033820: 2020 202d 2028 6e75 6d65 7269 6320 6b65 - (numeric ke │ │ │ │ │ +00033830: 7970 6164 290a 2020 2020 206e 756d 706c ypad). numpl │ │ │ │ │ +00033840: 7573 2020 2020 2020 2020 2020 2020 2020 us │ │ │ │ │ +00033850: 2020 2020 2020 2020 202b 2028 6e75 6d65 + (nume │ │ │ │ │ +00033860: 7269 6320 6b65 7970 6164 290a 2020 2020 ric keypad). │ │ │ │ │ +00033870: 206e 756d 736c 6173 6820 2020 2020 2020 numslash │ │ │ │ │ +00033880: 2020 2020 2020 2020 2020 2020 2020 202f / │ │ │ │ │ +00033890: 2028 6e75 6d65 7269 6320 6b65 7970 6164 (numeric keypad │ │ │ │ │ +000338a0: 290a 2020 2020 206e 756d 656e 7465 7220 ). numenter │ │ │ │ │ +000338b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +000338c0: 2020 2020 2045 6e74 6572 2028 6e75 6d65 Enter (nume │ │ │ │ │ +000338d0: 7269 6320 6b65 7970 6164 290a 2020 2020 ric keypad). │ │ │ │ │ +000338e0: 2064 656c 6574 6520 2020 2020 2020 2020 delete │ │ │ │ │ +000338f0: 2020 2020 2020 2020 2020 2020 2020 2044 D │ │ │ │ │ +00033900: 656c 6574 650a 2020 2020 2069 6e73 6572 elete. inser │ │ │ │ │ +00033910: 7420 2020 2020 2020 2020 2020 2020 2020 t │ │ │ │ │ +00033920: 2020 2020 2020 2020 2049 6e73 6572 740a Insert. │ │ │ │ │ +00033930: 2020 2020 2068 6f6d 6520 2020 2020 2020 home │ │ │ │ │ 00033940: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033950: 2020 2020 2048 6f6d 650a 2020 2020 2065 Home. e │ │ │ │ │ -00033960: 6e64 2020 2020 2020 2020 2020 2020 2020 nd │ │ │ │ │ -00033970: 2020 2020 2020 2020 2020 2020 2045 6e64 End │ │ │ │ │ -00033980: 0a20 2020 2020 7067 646f 776e 2020 2020 . pgdown │ │ │ │ │ +00033950: 2020 2048 6f6d 650a 2020 2020 2065 6e64 Home. end │ │ │ │ │ +00033960: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00033970: 2020 2020 2020 2020 2020 2045 6e64 0a20 End. │ │ │ │ │ +00033980: 2020 2020 7067 646f 776e 2020 2020 2020 pgdown │ │ │ │ │ 00033990: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000339a0: 2020 2020 5061 6765 2044 6f77 6e0a 2020 Page Down. │ │ │ │ │ -000339b0: 2020 2070 6775 7020 2020 2020 2020 2020 pgup │ │ │ │ │ -000339c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000339d0: 2050 6167 6520 5570 0a20 2020 2020 646f Page Up. do │ │ │ │ │ -000339e0: 776e 2020 2020 2020 2020 2020 2020 2020 wn │ │ │ │ │ -000339f0: 2020 2020 2020 2020 2020 2020 446f 776e Down │ │ │ │ │ -00033a00: 0a20 2020 2020 7570 2020 2020 2020 2020 . up │ │ │ │ │ +000339a0: 2020 5061 6765 2044 6f77 6e0a 2020 2020 Page Down. │ │ │ │ │ +000339b0: 2070 6775 7020 2020 2020 2020 2020 2020 pgup │ │ │ │ │ +000339c0: 2020 2020 2020 2020 2020 2020 2020 2050 P │ │ │ │ │ +000339d0: 6167 6520 5570 0a20 2020 2020 646f 776e age Up. down │ │ │ │ │ +000339e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +000339f0: 2020 2020 2020 2020 2020 446f 776e 0a20 Down. │ │ │ │ │ +00033a00: 2020 2020 7570 2020 2020 2020 2020 2020 up │ │ │ │ │ 00033a10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033a20: 2020 2020 5570 0a20 2020 2020 6c65 6674 Up. left │ │ │ │ │ +00033a20: 2020 5570 0a20 2020 2020 6c65 6674 2020 Up. left │ │ │ │ │ 00033a30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033a40: 2020 2020 2020 2020 2020 4c65 6674 0a20 Left. │ │ │ │ │ -00033a50: 2020 2020 7269 6768 7420 2020 2020 2020 right │ │ │ │ │ +00033a40: 2020 2020 2020 2020 4c65 6674 0a20 2020 Left. │ │ │ │ │ +00033a50: 2020 7269 6768 7420 2020 2020 2020 2020 right │ │ │ │ │ 00033a60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033a70: 2020 5269 6768 740a 0a20 2020 2020 4173 Right.. As │ │ │ │ │ -00033a80: 2077 656c 6c20 6173 206b 6579 7374 726f well as keystro │ │ │ │ │ -00033a90: 6b65 732c 2074 6865 2027 7365 6e64 6b65 kes, the 'sendke │ │ │ │ │ -00033aa0: 7927 2063 6f6d 6d61 6e64 2074 616b 6573 y' command takes │ │ │ │ │ -00033ab0: 2076 6172 696f 7573 206f 7074 696f 6e73 various options │ │ │ │ │ -00033ac0: 0a20 2020 2020 7468 6174 2061 6666 6563 . that affec │ │ │ │ │ -00033ad0: 7420 7468 6520 4249 4f53 206b 6579 626f t the BIOS keybo │ │ │ │ │ -00033ae0: 6172 6420 7374 6174 7573 2066 6c61 6773 ard status flags │ │ │ │ │ -00033af0: 2e20 2054 6865 7365 206f 7074 696f 6e73 . These options │ │ │ │ │ -00033b00: 2074 616b 6520 616e 0a20 2020 2020 276f take an. 'o │ │ │ │ │ -00033b10: 6e27 206f 7220 276f 6666 2720 7061 7261 n' or 'off' para │ │ │ │ │ -00033b20: 6d65 7465 722c 2073 7065 6369 6679 696e meter, specifyin │ │ │ │ │ -00033b30: 6720 7468 6174 2074 6865 2063 6f72 7265 g that the corre │ │ │ │ │ -00033b40: 7370 6f6e 6469 6e67 2073 7461 7475 730a sponding status. │ │ │ │ │ -00033b50: 2020 2020 2066 6c61 6720 6265 2073 6574 flag be set │ │ │ │ │ -00033b60: 206f 7220 756e 7365 743b 206f 6d69 7474 or unset; omitt │ │ │ │ │ -00033b70: 696e 6720 7468 6520 6f70 7469 6f6e 2066 ing the option f │ │ │ │ │ -00033b80: 6f72 2061 2067 6976 656e 2073 7461 7475 or a given statu │ │ │ │ │ -00033b90: 7320 666c 6167 0a20 2020 2020 7769 6c6c s flag. will │ │ │ │ │ -00033ba0: 206c 6561 7665 2074 6861 7420 666c 6167 leave that flag │ │ │ │ │ -00033bb0: 2061 7420 6974 7320 696e 6974 6961 6c20 at its initial │ │ │ │ │ -00033bc0: 7374 6174 6520 6174 2062 6f6f 742e 2020 state at boot. │ │ │ │ │ -00033bd0: 5468 6520 272d 2d6e 756d 272c 0a20 2020 The '--num',. │ │ │ │ │ -00033be0: 2020 272d 2d63 6170 7327 2c20 272d 2d73 '--caps', '--s │ │ │ │ │ -00033bf0: 6372 6f6c 6c27 2c20 616e 6420 272d 2d69 croll', and '--i │ │ │ │ │ -00033c00: 6e73 6572 7427 206f 7074 696f 6e73 2065 nsert' options e │ │ │ │ │ -00033c10: 6d75 6c61 7465 2073 6574 7469 6e67 2074 mulate setting t │ │ │ │ │ -00033c20: 6865 0a20 2020 2020 636f 7272 6573 706f he. correspo │ │ │ │ │ -00033c30: 6e64 696e 6720 6d6f 6465 2c20 7768 696c nding mode, whil │ │ │ │ │ -00033c40: 6520 7468 6520 272d 2d6e 756d 6b65 7927 e the '--numkey' │ │ │ │ │ -00033c50: 2c20 272d 2d63 6170 736b 6579 272c 0a20 , '--capskey',. │ │ │ │ │ -00033c60: 2020 2020 272d 2d73 6372 6f6c 6c6b 6579 '--scrollkey │ │ │ │ │ -00033c70: 272c 2061 6e64 2027 2d2d 696e 7365 7274 ', and '--insert │ │ │ │ │ -00033c80: 6b65 7927 206f 7074 696f 6e73 2065 6d75 key' options emu │ │ │ │ │ -00033c90: 6c61 7465 2070 7265 7373 696e 6720 616e late pressing an │ │ │ │ │ -00033ca0: 640a 2020 2020 2068 6f6c 6469 6e67 2074 d. holding t │ │ │ │ │ -00033cb0: 6865 2063 6f72 7265 7370 6f6e 6469 6e67 he corresponding │ │ │ │ │ -00033cc0: 206b 6579 2e20 2054 6865 206f 7468 6572 key. The other │ │ │ │ │ -00033cd0: 2073 7461 7475 7320 666c 6167 206f 7074 status flag opt │ │ │ │ │ -00033ce0: 696f 6e73 2061 7265 0a20 2020 2020 7365 ions are. se │ │ │ │ │ -00033cf0: 6c66 2d65 7870 6c61 6e61 746f 7279 2e0a lf-explanatory.. │ │ │ │ │ -00033d00: 0a20 2020 2020 4966 2074 6865 2027 2d2d . If the '-- │ │ │ │ │ -00033d10: 6e6f 2d6c 6564 2720 6f70 7469 6f6e 2069 no-led' option i │ │ │ │ │ -00033d20: 7320 6769 7665 6e2c 2074 6865 2073 7461 s given, the sta │ │ │ │ │ -00033d30: 7475 7320 666c 6167 206f 7074 696f 6e73 tus flag options │ │ │ │ │ -00033d40: 2077 696c 6c0a 2020 2020 2068 6176 6520 will. have │ │ │ │ │ -00033d50: 6e6f 2065 6666 6563 7420 6f6e 206b 6579 no effect on key │ │ │ │ │ -00033d60: 626f 6172 6420 4c45 4473 2e0a 0a20 2020 board LEDs... │ │ │ │ │ -00033d70: 2020 4966 2074 6865 2027 7365 6e64 6b65 If the 'sendke │ │ │ │ │ -00033d80: 7927 2063 6f6d 6d61 6e64 2069 7320 6769 y' command is gi │ │ │ │ │ -00033d90: 7665 6e20 6d75 6c74 6970 6c65 2074 696d ven multiple tim │ │ │ │ │ -00033da0: 6573 2c20 7468 656e 206f 6e6c 7920 7468 es, then only th │ │ │ │ │ -00033db0: 650a 2020 2020 206c 6173 7420 696e 766f e. last invo │ │ │ │ │ -00033dc0: 6361 7469 6f6e 2068 6173 2061 6e79 2065 cation has any e │ │ │ │ │ -00033dd0: 6666 6563 742e 0a0a 2020 2020 2053 696e ffect... Sin │ │ │ │ │ -00033de0: 6365 2027 7365 6e64 6b65 7927 206d 616e ce 'sendkey' man │ │ │ │ │ -00033df0: 6970 756c 6174 6573 2074 6865 2042 494f ipulates the BIO │ │ │ │ │ -00033e00: 5320 6b65 7962 6f61 7264 2062 7566 6665 S keyboard buffe │ │ │ │ │ -00033e10: 722c 2069 7420 6d61 7920 6361 7573 650a r, it may cause. │ │ │ │ │ -00033e20: 2020 2020 2068 616e 6773 2c20 7265 626f hangs, rebo │ │ │ │ │ -00033e30: 6f74 732c 206f 7220 6f74 6865 7220 6d69 ots, or other mi │ │ │ │ │ -00033e40: 7362 6568 6176 696f 7572 206f 6e20 736f sbehaviour on so │ │ │ │ │ -00033e50: 6d65 2073 7973 7465 6d73 2e20 2049 6620 me systems. If │ │ │ │ │ -00033e60: 7468 650a 2020 2020 206f 7065 7261 7469 the. operati │ │ │ │ │ -00033e70: 6e67 2073 7973 7465 6d20 6f72 2062 6f6f ng system or boo │ │ │ │ │ -00033e80: 7420 6c6f 6164 6572 2074 6861 7420 7275 t loader that ru │ │ │ │ │ -00033e90: 6e73 2061 6674 6572 2047 5255 4220 7573 ns after GRUB us │ │ │ │ │ -00033ea0: 6573 2069 7473 206f 776e 0a20 2020 2020 es its own. │ │ │ │ │ -00033eb0: 6b65 7962 6f61 7264 2064 7269 7665 7220 keyboard driver │ │ │ │ │ -00033ec0: 7261 7468 6572 2074 6861 6e20 7468 6520 rather than the │ │ │ │ │ -00033ed0: 4249 4f53 206b 6579 626f 6172 6420 6675 BIOS keyboard fu │ │ │ │ │ -00033ee0: 6e63 7469 6f6e 732c 2074 6865 6e0a 2020 nctions, then. │ │ │ │ │ -00033ef0: 2020 2027 7365 6e64 6b65 7927 2077 696c 'sendkey' wil │ │ │ │ │ -00033f00: 6c20 6861 7665 206e 6f20 6566 6665 6374 l have no effect │ │ │ │ │ -00033f10: 2e0a 0a20 2020 2020 5468 6973 2063 6f6d ... This com │ │ │ │ │ -00033f20: 6d61 6e64 2069 7320 6f6e 6c79 2061 7661 mand is only ava │ │ │ │ │ -00033f30: 696c 6162 6c65 206f 6e20 5043 2042 494f ilable on PC BIO │ │ │ │ │ -00033f40: 5320 7379 7374 656d 732e 0a0a 1f0a 4669 S systems.....Fi │ │ │ │ │ -00033f50: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ -00033f60: 4e6f 6465 3a20 7365 742c 2020 4e65 7874 Node: set, Next │ │ │ │ │ -00033f70: 3a20 7368 6131 7375 6d2c 2020 5072 6576 : sha1sum, Prev │ │ │ │ │ -00033f80: 3a20 7365 6e64 6b65 792c 2020 5570 3a20 : sendkey, Up: │ │ │ │ │ -00033f90: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ -00033fa0: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ │ -00033fb0: 616e 6473 0a0a 3136 2e33 2e36 3720 7365 ands..16.3.67 se │ │ │ │ │ -00033fc0: 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 t.-----------.. │ │ │ │ │ -00033fd0: 2d2d 2043 6f6d 6d61 6e64 3a20 7365 7420 -- Command: set │ │ │ │ │ -00033fe0: 5b65 6e76 7661 723d 7661 6c75 655d 0a20 [envvar=value]. │ │ │ │ │ -00033ff0: 2020 2020 5365 7420 7468 6520 656e 7669 Set the envi │ │ │ │ │ -00034000: 726f 6e6d 656e 7420 7661 7269 6162 6c65 ronment variable │ │ │ │ │ -00034010: 2045 4e56 5641 5220 746f 2056 414c 5545 ENVVAR to VALUE │ │ │ │ │ -00034020: 2e20 2049 6620 696e 766f 6b65 6420 7769 . If invoked wi │ │ │ │ │ -00034030: 7468 206e 6f0a 2020 2020 2061 7267 756d th no. argum │ │ │ │ │ -00034040: 656e 7473 2c20 7072 696e 7420 616c 6c20 ents, print all │ │ │ │ │ -00034050: 656e 7669 726f 6e6d 656e 7420 7661 7269 environment vari │ │ │ │ │ -00034060: 6162 6c65 7320 7769 7468 2074 6865 6972 ables with their │ │ │ │ │ -00034070: 2076 616c 7565 732e 0a0a 1f0a 4669 6c65 values.....File │ │ │ │ │ -00034080: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ -00034090: 6465 3a20 7368 6131 7375 6d2c 2020 4e65 de: sha1sum, Ne │ │ │ │ │ -000340a0: 7874 3a20 7368 6132 3536 7375 6d2c 2020 xt: sha256sum, │ │ │ │ │ -000340b0: 5072 6576 3a20 7365 742c 2020 5570 3a20 Prev: set, Up: │ │ │ │ │ -000340c0: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ -000340d0: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ │ -000340e0: 616e 6473 0a0a 3136 2e33 2e36 3820 7368 ands..16.3.68 sh │ │ │ │ │ -000340f0: 6131 7375 6d0a 2d2d 2d2d 2d2d 2d2d 2d2d a1sum.---------- │ │ │ │ │ -00034100: 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 -----.. -- Comma │ │ │ │ │ -00034110: 6e64 3a20 7368 6131 7375 6d20 6172 6720 nd: sha1sum arg │ │ │ │ │ -00034120: 2e2e 2e0a 2020 2020 2041 6c69 6173 2066 .... Alias f │ │ │ │ │ -00034130: 6f72 2027 6861 7368 7375 6d20 2d2d 6861 or 'hashsum --ha │ │ │ │ │ -00034140: 7368 2073 6861 3120 6172 6720 2e2e 2e27 sh sha1 arg ...' │ │ │ │ │ -00034150: 2e20 2053 6565 2063 6f6d 6d61 6e64 2027 . See command ' │ │ │ │ │ -00034160: 6861 7368 7375 6d27 0a20 2020 2020 282a hashsum'. (* │ │ │ │ │ -00034170: 6e6f 7465 2068 6173 6873 756d 3a3a 2920 note hashsum::) │ │ │ │ │ -00034180: 666f 7220 6675 6c6c 2064 6573 6372 6970 for full descrip │ │ │ │ │ -00034190: 7469 6f6e 2e0a 0a1f 0a46 696c 653a 2067 tion.....File: g │ │ │ │ │ -000341a0: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ -000341b0: 2073 6861 3235 3673 756d 2c20 204e 6578 sha256sum, Nex │ │ │ │ │ -000341c0: 743a 2073 6861 3531 3273 756d 2c20 2050 t: sha512sum, P │ │ │ │ │ -000341d0: 7265 763a 2073 6861 3173 756d 2c20 2055 rev: sha1sum, U │ │ │ │ │ -000341e0: 703a 2043 6f6d 6d61 6e64 2d6c 696e 6520 p: Command-line │ │ │ │ │ -000341f0: 616e 6420 6d65 6e75 2065 6e74 7279 2063 and menu entry c │ │ │ │ │ -00034200: 6f6d 6d61 6e64 730a 0a31 362e 332e 3639 ommands..16.3.69 │ │ │ │ │ -00034210: 2073 6861 3235 3673 756d 0a2d 2d2d 2d2d sha256sum.----- │ │ │ │ │ -00034220: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d ------------.. - │ │ │ │ │ -00034230: 2d20 436f 6d6d 616e 643a 2073 6861 3235 - Command: sha25 │ │ │ │ │ -00034240: 3673 756d 2061 7267 202e 2e2e 0a20 2020 6sum arg .... │ │ │ │ │ -00034250: 2020 416c 6961 7320 666f 7220 2768 6173 Alias for 'has │ │ │ │ │ -00034260: 6873 756d 202d 2d68 6173 6820 7368 6132 hsum --hash sha2 │ │ │ │ │ -00034270: 3536 2061 7267 202e 2e2e 272e 2020 5365 56 arg ...'. Se │ │ │ │ │ -00034280: 6520 636f 6d6d 616e 6420 2768 6173 6873 e command 'hashs │ │ │ │ │ -00034290: 756d 270a 2020 2020 2028 2a6e 6f74 6520 um'. (*note │ │ │ │ │ -000342a0: 6861 7368 7375 6d3a 3a29 2066 6f72 2066 hashsum::) for f │ │ │ │ │ -000342b0: 756c 6c20 6465 7363 7269 7074 696f 6e2e ull description. │ │ │ │ │ -000342c0: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ -000342d0: 6e66 6f2c 2020 4e6f 6465 3a20 7368 6135 nfo, Node: sha5 │ │ │ │ │ -000342e0: 3132 7375 6d2c 2020 4e65 7874 3a20 736c 12sum, Next: sl │ │ │ │ │ -000342f0: 6565 702c 2020 5072 6576 3a20 7368 6132 eep, Prev: sha2 │ │ │ │ │ -00034300: 3536 7375 6d2c 2020 5570 3a20 436f 6d6d 56sum, Up: Comm │ │ │ │ │ -00034310: 616e 642d 6c69 6e65 2061 6e64 206d 656e and-line and men │ │ │ │ │ -00034320: 7520 656e 7472 7920 636f 6d6d 616e 6473 u entry commands │ │ │ │ │ -00034330: 0a0a 3136 2e33 2e37 3020 7368 6135 3132 ..16.3.70 sha512 │ │ │ │ │ -00034340: 7375 6d0a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d sum.------------ │ │ │ │ │ -00034350: 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 -----.. -- Comma │ │ │ │ │ -00034360: 6e64 3a20 7368 6135 3132 7375 6d20 6172 nd: sha512sum ar │ │ │ │ │ -00034370: 6720 2e2e 2e0a 2020 2020 2041 6c69 6173 g .... Alias │ │ │ │ │ -00034380: 2066 6f72 2027 6861 7368 7375 6d20 2d2d for 'hashsum -- │ │ │ │ │ -00034390: 6861 7368 2073 6861 3531 3220 6172 6720 hash sha512 arg │ │ │ │ │ -000343a0: 2e2e 2e27 2e20 2053 6565 2063 6f6d 6d61 ...'. See comma │ │ │ │ │ -000343b0: 6e64 2027 6861 7368 7375 6d27 0a20 2020 nd 'hashsum'. │ │ │ │ │ -000343c0: 2020 282a 6e6f 7465 2068 6173 6873 756d (*note hashsum │ │ │ │ │ -000343d0: 3a3a 2920 666f 7220 6675 6c6c 2064 6573 ::) for full des │ │ │ │ │ -000343e0: 6372 6970 7469 6f6e 2e0a 0a1f 0a46 696c cription.....Fil │ │ │ │ │ -000343f0: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ -00034400: 6f64 653a 2073 6c65 6570 2c20 204e 6578 ode: sleep, Nex │ │ │ │ │ -00034410: 743a 2073 6d62 696f 732c 2020 5072 6576 t: smbios, Prev │ │ │ │ │ -00034420: 3a20 7368 6135 3132 7375 6d2c 2020 5570 : sha512sum, Up │ │ │ │ │ -00034430: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ │ -00034440: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ │ -00034450: 6d6d 616e 6473 0a0a 3136 2e33 2e37 3120 mmands..16.3.71 │ │ │ │ │ -00034460: 736c 6565 700a 2d2d 2d2d 2d2d 2d2d 2d2d sleep.---------- │ │ │ │ │ -00034470: 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 ---.. -- Command │ │ │ │ │ -00034480: 3a20 736c 6565 7020 5b2d 2d76 6572 626f : sleep [--verbo │ │ │ │ │ -00034490: 7365 5d20 5b2d 2d69 6e74 6572 7275 7074 se] [--interrupt │ │ │ │ │ -000344a0: 6962 6c65 5d20 636f 756e 740a 2020 2020 ible] count. │ │ │ │ │ -000344b0: 2053 6c65 6570 2066 6f72 2043 4f55 4e54 Sleep for COUNT │ │ │ │ │ -000344c0: 2073 6563 6f6e 6473 2e20 2049 6620 6f70 seconds. If op │ │ │ │ │ -000344d0: 7469 6f6e 2027 2d2d 696e 7465 7272 7570 tion '--interrup │ │ │ │ │ -000344e0: 7469 626c 6527 2069 7320 6769 7665 6e2c tible' is given, │ │ │ │ │ -000344f0: 0a20 2020 2020 616c 6c6f 7720 7072 6573 . allow pres │ │ │ │ │ -00034500: 7369 6e67 203c 4553 433e 2c20 3c46 343e sing , │ │ │ │ │ -00034510: 206f 7220 686f 6c64 696e 6720 646f 776e or holding down │ │ │ │ │ -00034520: 203c 5348 4946 543e 2074 6f20 696e 7465 to inte │ │ │ │ │ -00034530: 7272 7570 740a 2020 2020 2073 6c65 6570 rrupt. sleep │ │ │ │ │ -00034540: 2e20 2057 6974 6820 272d 2d76 6572 626f . With '--verbo │ │ │ │ │ -00034550: 7365 2720 7368 6f77 2063 6f75 6e74 646f se' show countdo │ │ │ │ │ -00034560: 776e 206f 6620 7265 6d61 696e 696e 6720 wn of remaining │ │ │ │ │ -00034570: 7365 636f 6e64 732e 2020 4578 6974 0a20 seconds. Exit. │ │ │ │ │ -00034580: 2020 2020 636f 6465 2069 7320 7365 7420 code is set │ │ │ │ │ -00034590: 746f 2030 2069 6620 7469 6d65 6f75 7420 to 0 if timeout │ │ │ │ │ -000345a0: 6578 7069 7265 6420 616e 6420 746f 2031 expired and to 1 │ │ │ │ │ -000345b0: 2069 6620 7469 6d65 6f75 7420 7761 730a if timeout was. │ │ │ │ │ -000345c0: 2020 2020 2069 6e74 6572 7275 7074 6564 interrupted │ │ │ │ │ -000345d0: 2075 7369 6e67 2061 6e79 206f 6620 7468 using any of th │ │ │ │ │ -000345e0: 6520 6d65 6e74 696f 6e65 6420 6b65 7973 e mentioned keys │ │ │ │ │ -000345f0: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ -00034600: 696e 666f 2c20 204e 6f64 653a 2073 6d62 info, Node: smb │ │ │ │ │ -00034610: 696f 732c 2020 4e65 7874 3a20 736f 7572 ios, Next: sour │ │ │ │ │ -00034620: 6365 2c20 2050 7265 763a 2073 6c65 6570 ce, Prev: sleep │ │ │ │ │ -00034630: 2c20 2055 703a 2043 6f6d 6d61 6e64 2d6c , Up: Command-l │ │ │ │ │ -00034640: 696e 6520 616e 6420 6d65 6e75 2065 6e74 ine and menu ent │ │ │ │ │ -00034650: 7279 2063 6f6d 6d61 6e64 730a 0a31 362e ry commands..16. │ │ │ │ │ -00034660: 332e 3732 2073 6d62 696f 730a 2d2d 2d2d 3.72 smbios.---- │ │ │ │ │ -00034670: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 ----------.. -- │ │ │ │ │ -00034680: 436f 6d6d 616e 643a 2073 6d62 696f 7320 Command: smbios │ │ │ │ │ -00034690: 5b2d 2d74 7970 6520 5459 5045 5d20 5b2d [--type TYPE] [- │ │ │ │ │ -000346a0: 2d68 616e 646c 6520 4841 4e44 4c45 5d20 -handle HANDLE] │ │ │ │ │ -000346b0: 5b2d 2d6d 6174 6368 204d 4154 4348 5d0a [--match MATCH]. │ │ │ │ │ -000346c0: 2020 2020 2020 2020 2020 282d 2d67 6574 (--get │ │ │ │ │ -000346d0: 2d62 7974 6520 7c20 2d2d 6765 742d 776f -byte | --get-wo │ │ │ │ │ -000346e0: 7264 207c 202d 2d67 6574 2d64 776f 7264 rd | --get-dword │ │ │ │ │ -000346f0: 207c 202d 2d67 6574 2d71 776f 7264 207c | --get-qword | │ │ │ │ │ -00034700: 0a20 2020 2020 2020 2020 202d 2d67 6574 . --get │ │ │ │ │ -00034710: 2d73 7472 696e 6720 7c20 2d2d 6765 742d -string | --get- │ │ │ │ │ -00034720: 7575 6964 2920 4f46 4653 4554 205b 2d2d uuid) OFFSET [-- │ │ │ │ │ -00034730: 7365 7420 5641 5249 4142 4c45 5d0a 2020 set VARIABLE]. │ │ │ │ │ -00034740: 2020 2052 6574 7269 6576 6520 534d 4249 Retrieve SMBI │ │ │ │ │ -00034750: 4f53 2069 6e66 6f72 6d61 7469 6f6e 2e0a OS information.. │ │ │ │ │ -00034760: 0a20 2020 2020 5468 6520 2773 6d62 696f . The 'smbio │ │ │ │ │ -00034770: 7327 2063 6f6d 6d61 6e64 2072 6574 7572 s' command retur │ │ │ │ │ -00034780: 6e73 2074 6865 2076 616c 7565 206f 6620 ns the value of │ │ │ │ │ -00034790: 6120 6669 656c 6420 696e 2061 6e20 534d a field in an SM │ │ │ │ │ -000347a0: 4249 4f53 0a20 2020 2020 7374 7275 6374 BIOS. struct │ │ │ │ │ -000347b0: 7572 652e 2020 5468 6520 666f 6c6c 6f77 ure. The follow │ │ │ │ │ -000347c0: 696e 6720 6f70 7469 6f6e 7320 6465 7465 ing options dete │ │ │ │ │ -000347d0: 726d 696e 6520 7768 6963 6820 7374 7275 rmine which stru │ │ │ │ │ -000347e0: 6374 7572 6520 746f 0a20 2020 2020 7365 cture to. se │ │ │ │ │ -000347f0: 6c65 6374 2e0a 0a20 2020 2020 2020 202a lect... * │ │ │ │ │ -00034800: 2053 7065 6369 6679 696e 6720 272d 2d74 Specifying '--t │ │ │ │ │ -00034810: 7970 6527 2077 696c 6c20 7365 6c65 6374 ype' will select │ │ │ │ │ -00034820: 2073 7472 7563 7475 7265 7320 7769 7468 structures with │ │ │ │ │ -00034830: 2061 206d 6174 6368 696e 670a 2020 2020 a matching. │ │ │ │ │ -00034840: 2020 2020 2020 5459 5045 2e20 2054 6865 TYPE. The │ │ │ │ │ -00034850: 2074 7970 6520 6361 6e20 6265 2061 6e79 type can be any │ │ │ │ │ -00034860: 2069 6e74 6567 6572 2066 726f 6d20 3020 integer from 0 │ │ │ │ │ -00034870: 746f 2032 3535 2e0a 2020 2020 2020 2020 to 255.. │ │ │ │ │ -00034880: 2a20 5370 6563 6966 7969 6e67 2027 2d2d * Specifying '-- │ │ │ │ │ -00034890: 6861 6e64 6c65 2720 7769 6c6c 2073 656c handle' will sel │ │ │ │ │ -000348a0: 6563 7420 7374 7275 6374 7572 6573 2077 ect structures w │ │ │ │ │ -000348b0: 6974 6820 6120 6d61 7463 6869 6e67 0a20 ith a matching. │ │ │ │ │ -000348c0: 2020 2020 2020 2020 2048 414e 444c 452e HANDLE. │ │ │ │ │ -000348d0: 2020 5468 6520 6861 6e64 6c65 2063 616e The handle can │ │ │ │ │ -000348e0: 2062 6520 616e 7920 696e 7465 6765 7220 be any integer │ │ │ │ │ -000348f0: 6672 6f6d 2030 2074 6f20 3635 3533 352e from 0 to 65535. │ │ │ │ │ -00034900: 0a20 2020 2020 2020 202a 2053 7065 6369 . * Speci │ │ │ │ │ -00034910: 6679 696e 6720 272d 2d6d 6174 6368 2720 fying '--match' │ │ │ │ │ -00034920: 7769 6c6c 2073 656c 6563 7420 7374 7275 will select stru │ │ │ │ │ -00034930: 6374 7572 6520 6e75 6d62 6572 204d 4154 cture number MAT │ │ │ │ │ -00034940: 4348 2069 6e20 7468 650a 2020 2020 2020 CH in the. │ │ │ │ │ -00034950: 2020 2020 6669 6c74 6572 6564 206c 6973 filtered lis │ │ │ │ │ -00034960: 7420 6f66 2073 7472 7563 7475 7265 733b t of structures; │ │ │ │ │ -00034970: 2065 2e67 2e20 2027 736d 6269 6f73 202d e.g. 'smbios - │ │ │ │ │ -00034980: 2d74 7970 6520 3420 2d2d 6d61 7463 6820 -type 4 --match │ │ │ │ │ -00034990: 3227 0a20 2020 2020 2020 2020 2077 696c 2'. wil │ │ │ │ │ -000349a0: 6c20 7365 6c65 6374 2074 6865 2073 6563 l select the sec │ │ │ │ │ -000349b0: 6f6e 6420 5072 6f63 6573 7320 496e 666f ond Process Info │ │ │ │ │ -000349c0: 726d 6174 696f 6e20 2854 7970 6520 3429 rmation (Type 4) │ │ │ │ │ -000349d0: 2073 7472 7563 7475 7265 2e0a 2020 2020 structure.. │ │ │ │ │ -000349e0: 2020 2020 2020 5468 6520 6c69 7374 2069 The list i │ │ │ │ │ -000349f0: 7320 616c 7761 7973 206f 7264 6572 6564 s always ordered │ │ │ │ │ -00034a00: 2074 6865 2073 616d 6520 6173 2074 6865 the same as the │ │ │ │ │ -00034a10: 2068 6172 6477 6172 6527 7320 534d 4249 hardware's SMBI │ │ │ │ │ -00034a20: 4f53 0a20 2020 2020 2020 2020 2074 6162 OS. tab │ │ │ │ │ -00034a30: 6c65 2e20 2054 6865 206d 6174 6368 206e le. The match n │ │ │ │ │ -00034a40: 756d 6265 7220 6d75 7374 2062 6520 6120 umber must be a │ │ │ │ │ -00034a50: 706f 7369 7469 7665 2069 6e74 6567 6572 positive integer │ │ │ │ │ -00034a60: 2e20 2049 660a 2020 2020 2020 2020 2020 . If. │ │ │ │ │ -00034a70: 756e 7370 6563 6966 6965 642c 2074 6865 unspecified, the │ │ │ │ │ -00034a80: 2066 6972 7374 206d 6174 6368 696e 6720 first matching │ │ │ │ │ -00034a90: 7374 7275 6374 7572 6520 7769 6c6c 2062 structure will b │ │ │ │ │ -00034aa0: 6520 7365 6c65 6374 6564 2e0a 0a20 2020 e selected... │ │ │ │ │ -00034ab0: 2020 5468 6520 7265 6d61 696e 696e 6720 The remaining │ │ │ │ │ -00034ac0: 6f70 7469 6f6e 7320 6465 7465 726d 696e options determin │ │ │ │ │ -00034ad0: 6520 7768 6963 6820 6669 656c 6420 696e e which field in │ │ │ │ │ -00034ae0: 2074 6865 2073 656c 6563 7465 6420 534d the selected SM │ │ │ │ │ -00034af0: 4249 4f53 0a20 2020 2020 7374 7275 6374 BIOS. struct │ │ │ │ │ -00034b00: 7572 6520 746f 2072 6574 7572 6e2e 2020 ure to return. │ │ │ │ │ -00034b10: 4f6e 6c79 206f 6e65 206f 6620 7468 6573 Only one of thes │ │ │ │ │ -00034b20: 6520 6f70 7469 6f6e 7320 6d61 7920 6265 e options may be │ │ │ │ │ -00034b30: 2073 7065 6369 6669 6564 2061 740a 2020 specified at. │ │ │ │ │ -00034b40: 2020 2061 2074 696d 652e 0a0a 2020 2020 a time... │ │ │ │ │ -00034b50: 2020 2020 2a20 5768 656e 2067 6976 656e * When given │ │ │ │ │ -00034b60: 2027 2d2d 6765 742d 6279 7465 272c 2072 '--get-byte', r │ │ │ │ │ -00034b70: 6574 7572 6e20 7468 6520 7661 6c75 6520 eturn the value │ │ │ │ │ -00034b80: 6f66 2074 6865 2062 7974 6520 6174 0a20 of the byte at. │ │ │ │ │ -00034b90: 2020 2020 2020 2020 204f 4646 5345 5420 OFFSET │ │ │ │ │ -00034ba0: 6279 7465 7320 696e 746f 2074 6865 2073 bytes into the s │ │ │ │ │ -00034bb0: 656c 6563 7465 6420 534d 4249 4f53 2073 elected SMBIOS s │ │ │ │ │ -00034bc0: 7472 7563 7475 7265 2e20 2049 7420 7769 tructure. It wi │ │ │ │ │ -00034bd0: 6c6c 2062 650a 2020 2020 2020 2020 2020 ll be. │ │ │ │ │ -00034be0: 666f 726d 6174 7465 6420 6173 2061 6e20 formatted as an │ │ │ │ │ -00034bf0: 756e 7369 676e 6564 2064 6563 696d 616c unsigned decimal │ │ │ │ │ -00034c00: 2069 6e74 6567 6572 2e0a 2020 2020 2020 integer.. │ │ │ │ │ -00034c10: 2020 2a20 5768 656e 2067 6976 656e 2027 * When given ' │ │ │ │ │ -00034c20: 2d2d 6765 742d 776f 7264 272c 2072 6574 --get-word', ret │ │ │ │ │ -00034c30: 7572 6e20 7468 6520 7661 6c75 6520 6f66 urn the value of │ │ │ │ │ -00034c40: 2074 6865 2077 6f72 6420 2874 776f 0a20 the word (two. │ │ │ │ │ -00034c50: 2020 2020 2020 2020 2062 7974 6573 2920 bytes) │ │ │ │ │ -00034c60: 6174 204f 4646 5345 5420 6279 7465 7320 at OFFSET bytes │ │ │ │ │ -00034c70: 696e 746f 2074 6865 2073 656c 6563 7465 into the selecte │ │ │ │ │ -00034c80: 6420 534d 4249 4f53 2073 7472 7563 7475 d SMBIOS structu │ │ │ │ │ -00034c90: 7265 2e20 2049 740a 2020 2020 2020 2020 re. It. │ │ │ │ │ -00034ca0: 2020 7769 6c6c 2062 6520 666f 726d 6174 will be format │ │ │ │ │ -00034cb0: 7465 6420 6173 2061 6e20 756e 7369 676e ted as an unsign │ │ │ │ │ -00034cc0: 6564 2064 6563 696d 616c 2069 6e74 6567 ed decimal integ │ │ │ │ │ -00034cd0: 6572 2e0a 2020 2020 2020 2020 2a20 5768 er.. * Wh │ │ │ │ │ -00034ce0: 656e 2067 6976 656e 2027 2d2d 6765 742d en given '--get- │ │ │ │ │ -00034cf0: 6477 6f72 6427 2c20 7265 7475 726e 2074 dword', return t │ │ │ │ │ -00034d00: 6865 2076 616c 7565 206f 6620 7468 6520 he value of the │ │ │ │ │ -00034d10: 6477 6f72 6420 2866 6f75 720a 2020 2020 dword (four. │ │ │ │ │ -00034d20: 2020 2020 2020 6279 7465 7329 2061 7420 bytes) at │ │ │ │ │ -00034d30: 4f46 4653 4554 2062 7974 6573 2069 6e74 OFFSET bytes int │ │ │ │ │ -00034d40: 6f20 7468 6520 7365 6c65 6374 6564 2053 o the selected S │ │ │ │ │ -00034d50: 4d42 494f 5320 7374 7275 6374 7572 652e MBIOS structure. │ │ │ │ │ -00034d60: 2020 4974 0a20 2020 2020 2020 2020 2077 It. w │ │ │ │ │ -00034d70: 696c 6c20 6265 2066 6f72 6d61 7474 6564 ill be formatted │ │ │ │ │ -00034d80: 2061 7320 616e 2075 6e73 6967 6e65 6420 as an unsigned │ │ │ │ │ -00034d90: 6465 6369 6d61 6c20 696e 7465 6765 722e decimal integer. │ │ │ │ │ -00034da0: 0a20 2020 2020 2020 202a 2057 6865 6e20 . * When │ │ │ │ │ -00034db0: 6769 7665 6e20 272d 2d67 6574 2d71 776f given '--get-qwo │ │ │ │ │ -00034dc0: 7264 272c 2072 6574 7572 6e20 7468 6520 rd', return the │ │ │ │ │ -00034dd0: 7661 6c75 6520 6f66 2074 6865 2071 776f value of the qwo │ │ │ │ │ -00034de0: 7264 2028 6569 6768 740a 2020 2020 2020 rd (eight. │ │ │ │ │ -00034df0: 2020 2020 6279 7465 7329 2061 7420 4f46 bytes) at OF │ │ │ │ │ -00034e00: 4653 4554 2062 7974 6573 2069 6e74 6f20 FSET bytes into │ │ │ │ │ -00034e10: 7468 6520 7365 6c65 6374 6564 2053 4d42 the selected SMB │ │ │ │ │ -00034e20: 494f 5320 7374 7275 6374 7572 652e 2020 IOS structure. │ │ │ │ │ -00034e30: 4974 0a20 2020 2020 2020 2020 2077 696c It. wil │ │ │ │ │ -00034e40: 6c20 6265 2066 6f72 6d61 7474 6564 2061 l be formatted a │ │ │ │ │ -00034e50: 7320 616e 2075 6e73 6967 6e65 6420 6465 s an unsigned de │ │ │ │ │ -00034e60: 6369 6d61 6c20 696e 7465 6765 722e 0a20 cimal integer.. │ │ │ │ │ -00034e70: 2020 2020 2020 202a 2057 6865 6e20 6769 * When gi │ │ │ │ │ -00034e80: 7665 6e20 272d 2d67 6574 2d73 7472 696e ven '--get-strin │ │ │ │ │ -00034e90: 6727 2c20 7265 7475 726e 2074 6865 2073 g', return the s │ │ │ │ │ -00034ea0: 7472 696e 6720 7769 7468 2069 7473 2069 tring with its i │ │ │ │ │ -00034eb0: 6e64 6578 0a20 2020 2020 2020 2020 2066 ndex. f │ │ │ │ │ -00034ec0: 6f75 6e64 2061 7420 4f46 4653 4554 2062 ound at OFFSET b │ │ │ │ │ -00034ed0: 7974 6573 2069 6e74 6f20 7468 6520 7365 ytes into the se │ │ │ │ │ -00034ee0: 6c65 6374 6564 2053 4d42 494f 5320 7374 lected SMBIOS st │ │ │ │ │ -00034ef0: 7275 6374 7572 652e 0a20 2020 2020 2020 ructure.. │ │ │ │ │ -00034f00: 202a 2057 6865 6e20 6769 7665 6e20 272d * When given '- │ │ │ │ │ -00034f10: 2d67 6574 2d75 7569 6427 2c20 7265 7475 -get-uuid', retu │ │ │ │ │ -00034f20: 726e 2074 6865 2076 616c 7565 206f 6620 rn the value of │ │ │ │ │ -00034f30: 7468 6520 5555 4944 2028 7369 7874 6565 the UUID (sixtee │ │ │ │ │ -00034f40: 6e0a 2020 2020 2020 2020 2020 6279 7465 n. byte │ │ │ │ │ -00034f50: 7329 2061 7420 4f46 4653 4554 2062 7974 s) at OFFSET byt │ │ │ │ │ -00034f60: 6573 2069 6e74 6f20 7468 6520 7365 6c65 es into the sele │ │ │ │ │ -00034f70: 6374 6564 2053 4d42 494f 5320 7374 7275 cted SMBIOS stru │ │ │ │ │ -00034f80: 6374 7572 652e 2020 4974 0a20 2020 2020 cture. It. │ │ │ │ │ -00034f90: 2020 2020 2077 696c 6c20 6265 2066 6f72 will be for │ │ │ │ │ -00034fa0: 6d61 7474 6564 2061 7320 6c6f 7765 722d matted as lower- │ │ │ │ │ -00034fb0: 6361 7365 2068 7970 6865 6e61 7465 6420 case hyphenated │ │ │ │ │ -00034fc0: 6865 7861 6465 6369 6d61 6c20 6469 6769 hexadecimal digi │ │ │ │ │ -00034fd0: 7473 2c0a 2020 2020 2020 2020 2020 7769 ts,. wi │ │ │ │ │ -00034fe0: 7468 2074 6865 2066 6972 7374 2074 6872 th the first thr │ │ │ │ │ -00034ff0: 6565 2066 6965 6c64 7320 6173 206c 6974 ee fields as lit │ │ │ │ │ -00035000: 746c 652d 656e 6469 616e 2c20 616e 6420 tle-endian, and │ │ │ │ │ -00035010: 7468 6520 7265 7374 0a20 2020 2020 2020 the rest. │ │ │ │ │ -00035020: 2020 2070 7269 6e74 6564 2062 7974 652d printed byte- │ │ │ │ │ -00035030: 6279 2d62 7974 652e 0a0a 2020 2020 2054 by-byte... T │ │ │ │ │ -00035040: 6865 2064 6566 6175 6c74 2061 6374 696f he default actio │ │ │ │ │ -00035050: 6e20 6973 2074 6f20 7072 696e 7420 7468 n is to print th │ │ │ │ │ -00035060: 6520 7661 6c75 6520 6f66 2074 6865 2072 e value of the r │ │ │ │ │ -00035070: 6571 7565 7374 6564 2066 6965 6c64 2074 equested field t │ │ │ │ │ -00035080: 6f0a 2020 2020 2074 6865 2063 6f6e 736f o. the conso │ │ │ │ │ -00035090: 6c65 2c20 6275 7420 6120 7661 7269 6162 le, but a variab │ │ │ │ │ -000350a0: 6c65 206e 616d 6520 6361 6e20 6265 2073 le name can be s │ │ │ │ │ -000350b0: 7065 6369 6669 6564 2077 6974 6820 272d pecified with '- │ │ │ │ │ -000350c0: 2d73 6574 2720 746f 0a20 2020 2020 7374 -set' to. st │ │ │ │ │ -000350d0: 6f72 6520 7468 6520 7661 6c75 6520 696e ore the value in │ │ │ │ │ -000350e0: 7374 6561 6420 6f66 2070 7269 6e74 696e stead of printin │ │ │ │ │ -000350f0: 6720 6974 2e0a 0a20 2020 2020 466f 7220 g it... For │ │ │ │ │ -00035100: 6578 616d 706c 652c 2074 6869 7320 7769 example, this wi │ │ │ │ │ -00035110: 6c6c 2073 746f 7265 2061 6e64 2074 6865 ll store and the │ │ │ │ │ -00035120: 6e20 6469 7370 6c61 7920 7468 6520 7379 n display the sy │ │ │ │ │ -00035130: 7374 656d 0a20 2020 2020 6d61 6e75 6661 stem. manufa │ │ │ │ │ -00035140: 6374 7572 6572 2773 206e 616d 652e 0a0a cturer's name... │ │ │ │ │ -00035150: 2020 2020 2020 2020 2020 736d 6269 6f73 smbios │ │ │ │ │ -00035160: 202d 2d74 7970 6520 3120 2d2d 6765 742d --type 1 --get- │ │ │ │ │ -00035170: 7374 7269 6e67 2034 202d 2d73 6574 2073 string 4 --set s │ │ │ │ │ -00035180: 7973 7465 6d5f 6d61 6e75 6661 6374 7572 ystem_manufactur │ │ │ │ │ -00035190: 6572 0a20 2020 2020 2020 2020 2065 6368 er. ech │ │ │ │ │ -000351a0: 6f20 2473 7973 7465 6d5f 6d61 6e75 6661 o $system_manufa │ │ │ │ │ -000351b0: 6374 7572 6572 0a0a 1f0a 4669 6c65 3a20 cturer....File: │ │ │ │ │ -000351c0: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ -000351d0: 3a20 736f 7572 6365 2c20 204e 6578 743a : source, Next: │ │ │ │ │ -000351e0: 2074 6573 742c 2020 5072 6576 3a20 736d test, Prev: sm │ │ │ │ │ -000351f0: 6269 6f73 2c20 2055 703a 2043 6f6d 6d61 bios, Up: Comma │ │ │ │ │ -00035200: 6e64 2d6c 696e 6520 616e 6420 6d65 6e75 nd-line and menu │ │ │ │ │ -00035210: 2065 6e74 7279 2063 6f6d 6d61 6e64 730a entry commands. │ │ │ │ │ -00035220: 0a31 362e 332e 3733 2073 6f75 7263 650a .16.3.73 source. │ │ │ │ │ -00035230: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ -00035240: 202d 2d20 436f 6d6d 616e 643a 2073 6f75 -- Command: sou │ │ │ │ │ -00035250: 7263 6520 6669 6c65 0a20 2020 2020 5265 rce file. Re │ │ │ │ │ -00035260: 6164 2046 494c 4520 6173 2061 2063 6f6e ad FILE as a con │ │ │ │ │ -00035270: 6669 6775 7261 7469 6f6e 2066 696c 652c figuration file, │ │ │ │ │ -00035280: 2061 7320 6966 2069 7473 2063 6f6e 7465 as if its conte │ │ │ │ │ -00035290: 6e74 7320 6861 6420 6265 656e 0a20 2020 nts had been. │ │ │ │ │ -000352a0: 2020 696e 636f 7270 6f72 6174 6564 2064 incorporated d │ │ │ │ │ -000352b0: 6972 6563 746c 7920 696e 746f 2074 6865 irectly into the │ │ │ │ │ -000352c0: 2073 6f75 7263 696e 6720 6669 6c65 2e20 sourcing file. │ │ │ │ │ -000352d0: 2055 6e6c 696b 6520 2763 6f6e 6669 6766 Unlike 'configf │ │ │ │ │ -000352e0: 696c 6527 0a20 2020 2020 282a 6e6f 7465 ile'. (*note │ │ │ │ │ -000352f0: 2063 6f6e 6669 6766 696c 653a 3a29 2c20 configfile::), │ │ │ │ │ -00035300: 7468 6973 2065 7865 6375 7465 7320 7468 this executes th │ │ │ │ │ -00035310: 6520 636f 6e74 656e 7473 206f 6620 4649 e contents of FI │ │ │ │ │ -00035320: 4c45 2077 6974 686f 7574 0a20 2020 2020 LE without. │ │ │ │ │ -00035330: 6368 616e 6769 6e67 2063 6f6e 7465 7874 changing context │ │ │ │ │ -00035340: 3a20 616e 7920 656e 7669 726f 6e6d 656e : any environmen │ │ │ │ │ -00035350: 7420 7661 7269 6162 6c65 2063 6861 6e67 t variable chang │ │ │ │ │ -00035360: 6573 206d 6164 6520 6279 2074 6865 0a20 es made by the. │ │ │ │ │ -00035370: 2020 2020 636f 6d6d 616e 6473 2069 6e20 commands in │ │ │ │ │ -00035380: 4649 4c45 2077 696c 6c20 6265 2070 7265 FILE will be pre │ │ │ │ │ -00035390: 7365 7276 6564 2061 6674 6572 2027 736f served after 'so │ │ │ │ │ -000353a0: 7572 6365 2720 7265 7475 726e 732c 2061 urce' returns, a │ │ │ │ │ -000353b0: 6e64 2074 6865 0a20 2020 2020 6d65 6e75 nd the. menu │ │ │ │ │ -000353c0: 2077 696c 6c20 6e6f 7420 6265 2073 686f will not be sho │ │ │ │ │ -000353d0: 776e 2069 6d6d 6564 6961 7465 6c79 2e0a wn immediately.. │ │ │ │ │ -000353e0: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ -000353f0: 666f 2c20 204e 6f64 653a 2074 6573 742c fo, Node: test, │ │ │ │ │ -00035400: 2020 4e65 7874 3a20 7472 7565 2c20 2050 Next: true, P │ │ │ │ │ -00035410: 7265 763a 2073 6f75 7263 652c 2020 5570 rev: source, Up │ │ │ │ │ -00035420: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ │ -00035430: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ │ -00035440: 6d6d 616e 6473 0a0a 3136 2e33 2e37 3420 mmands..16.3.74 │ │ │ │ │ -00035450: 7465 7374 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d test.----------- │ │ │ │ │ -00035460: 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 -.. -- Command: │ │ │ │ │ -00035470: 7465 7374 2065 7870 7265 7373 696f 6e0a test expression. │ │ │ │ │ -00035480: 2020 2020 2045 7661 6c75 6174 6520 4558 Evaluate EX │ │ │ │ │ -00035490: 5052 4553 5349 4f4e 2061 6e64 2072 6574 PRESSION and ret │ │ │ │ │ -000354a0: 7572 6e20 7a65 726f 2065 7869 7420 7374 urn zero exit st │ │ │ │ │ -000354b0: 6174 7573 2069 6620 7265 7375 6c74 2069 atus if result i │ │ │ │ │ -000354c0: 7320 7472 7565 2c0a 2020 2020 206e 6f6e s true,. non │ │ │ │ │ -000354d0: 207a 6572 6f20 7374 6174 7573 206f 7468 zero status oth │ │ │ │ │ -000354e0: 6572 7769 7365 2e0a 0a20 2020 2020 4558 erwise... EX │ │ │ │ │ -000354f0: 5052 4553 5349 4f4e 2069 7320 6f6e 6520 PRESSION is one │ │ │ │ │ -00035500: 6f66 3a0a 0a20 2020 2020 5354 5249 4e47 of:.. STRING │ │ │ │ │ -00035510: 3120 273d 3d27 2053 5452 494e 4732 0a20 1 '==' STRING2. │ │ │ │ │ -00035520: 2020 2020 2020 2020 2074 6865 2073 7472 the str │ │ │ │ │ -00035530: 696e 6773 2061 7265 2065 7175 616c 0a20 ings are equal. │ │ │ │ │ -00035540: 2020 2020 5354 5249 4e47 3120 2721 3d27 STRING1 '!=' │ │ │ │ │ -00035550: 2053 5452 494e 4732 0a20 2020 2020 2020 STRING2. │ │ │ │ │ -00035560: 2020 2074 6865 2073 7472 696e 6773 2061 the strings a │ │ │ │ │ -00035570: 7265 206e 6f74 2065 7175 616c 0a20 2020 re not equal. │ │ │ │ │ -00035580: 2020 5354 5249 4e47 3120 273c 2720 5354 STRING1 '<' ST │ │ │ │ │ -00035590: 5249 4e47 320a 2020 2020 2020 2020 2020 RING2. │ │ │ │ │ -000355a0: 5354 5249 4e47 3120 6973 206c 6578 6963 STRING1 is lexic │ │ │ │ │ -000355b0: 6f67 7261 7068 6963 616c 6c79 206c 6573 ographically les │ │ │ │ │ -000355c0: 7320 7468 616e 2053 5452 494e 4732 0a20 s than STRING2. │ │ │ │ │ -000355d0: 2020 2020 5354 5249 4e47 3120 273c 3d27 STRING1 '<=' │ │ │ │ │ -000355e0: 2053 5452 494e 4732 0a20 2020 2020 2020 STRING2. │ │ │ │ │ -000355f0: 2020 2053 5452 494e 4731 2069 7320 6c65 STRING1 is le │ │ │ │ │ -00035600: 7869 636f 6772 6170 6869 6361 6c6c 7920 xicographically │ │ │ │ │ -00035610: 6c65 7373 206f 7220 6571 7561 6c20 7468 less or equal th │ │ │ │ │ -00035620: 616e 2053 5452 494e 4732 0a20 2020 2020 an STRING2. │ │ │ │ │ -00035630: 5354 5249 4e47 3120 273e 2720 5354 5249 STRING1 '>' STRI │ │ │ │ │ -00035640: 4e47 320a 2020 2020 2020 2020 2020 5354 NG2. ST │ │ │ │ │ -00035650: 5249 4e47 3120 6973 206c 6578 6963 6f67 RING1 is lexicog │ │ │ │ │ -00035660: 7261 7068 6963 616c 6c79 2067 7265 6174 raphically great │ │ │ │ │ -00035670: 6572 2074 6861 6e20 5354 5249 4e47 320a er than STRING2. │ │ │ │ │ -00035680: 2020 2020 2053 5452 494e 4731 2027 3e3d STRING1 '>= │ │ │ │ │ -00035690: 2720 5354 5249 4e47 320a 2020 2020 2020 ' STRING2. │ │ │ │ │ -000356a0: 2020 2020 5354 5249 4e47 3120 6973 206c STRING1 is l │ │ │ │ │ -000356b0: 6578 6963 6f67 7261 7068 6963 616c 6c79 exicographically │ │ │ │ │ -000356c0: 2067 7265 6174 6572 206f 7220 6571 7561 greater or equa │ │ │ │ │ -000356d0: 6c20 7468 616e 2053 5452 494e 4732 0a20 l than STRING2. │ │ │ │ │ -000356e0: 2020 2020 494e 5445 4745 5231 2027 2d65 INTEGER1 '-e │ │ │ │ │ -000356f0: 7127 2049 4e54 4547 4552 320a 2020 2020 q' INTEGER2. │ │ │ │ │ -00035700: 2020 2020 2020 494e 5445 4745 5231 2069 INTEGER1 i │ │ │ │ │ -00035710: 7320 6571 7561 6c20 746f 2049 4e54 4547 s equal to INTEG │ │ │ │ │ -00035720: 4552 320a 2020 2020 2049 4e54 4547 4552 ER2. INTEGER │ │ │ │ │ -00035730: 3120 272d 6765 2720 494e 5445 4745 5232 1 '-ge' INTEGER2 │ │ │ │ │ -00035740: 0a20 2020 2020 2020 2020 2049 4e54 4547 . INTEG │ │ │ │ │ -00035750: 4552 3120 6973 2067 7265 6174 6572 2074 ER1 is greater t │ │ │ │ │ -00035760: 6861 6e20 6f72 2065 7175 616c 2074 6f20 han or equal to │ │ │ │ │ -00035770: 494e 5445 4745 5232 0a20 2020 2020 494e INTEGER2. IN │ │ │ │ │ -00035780: 5445 4745 5231 2027 2d67 7427 2049 4e54 TEGER1 '-gt' INT │ │ │ │ │ -00035790: 4547 4552 320a 2020 2020 2020 2020 2020 EGER2. │ │ │ │ │ -000357a0: 494e 5445 4745 5231 2069 7320 6772 6561 INTEGER1 is grea │ │ │ │ │ -000357b0: 7465 7220 7468 616e 2049 4e54 4547 4552 ter than INTEGER │ │ │ │ │ -000357c0: 320a 2020 2020 2049 4e54 4547 4552 3120 2. INTEGER1 │ │ │ │ │ -000357d0: 272d 6c65 2720 494e 5445 4745 5232 0a20 '-le' INTEGER2. │ │ │ │ │ -000357e0: 2020 2020 2020 2020 2049 4e54 4547 4552 INTEGER │ │ │ │ │ -000357f0: 3120 6973 206c 6573 7320 7468 616e 206f 1 is less than o │ │ │ │ │ -00035800: 7220 6571 7561 6c20 746f 2049 4e54 4547 r equal to INTEG │ │ │ │ │ -00035810: 4552 320a 2020 2020 2049 4e54 4547 4552 ER2. INTEGER │ │ │ │ │ -00035820: 3120 272d 6c74 2720 494e 5445 4745 5232 1 '-lt' INTEGER2 │ │ │ │ │ -00035830: 0a20 2020 2020 2020 2020 2049 4e54 4547 . INTEG │ │ │ │ │ -00035840: 4552 3120 6973 206c 6573 7320 7468 616e ER1 is less than │ │ │ │ │ -00035850: 2049 4e54 4547 4552 320a 2020 2020 2049 INTEGER2. I │ │ │ │ │ -00035860: 4e54 4547 4552 3120 272d 6e65 2720 494e NTEGER1 '-ne' IN │ │ │ │ │ -00035870: 5445 4745 5232 0a20 2020 2020 2020 2020 TEGER2. │ │ │ │ │ -00035880: 2049 4e54 4547 4552 3120 6973 206e 6f74 INTEGER1 is not │ │ │ │ │ -00035890: 2065 7175 616c 2074 6f20 494e 5445 4745 equal to INTEGE │ │ │ │ │ -000358a0: 5232 0a20 2020 2020 5052 4546 4958 494e R2. PREFIXIN │ │ │ │ │ -000358b0: 5445 4745 5231 2027 2d70 6774 2720 5052 TEGER1 '-pgt' PR │ │ │ │ │ -000358c0: 4546 4958 494e 5445 4745 5232 0a20 2020 EFIXINTEGER2. │ │ │ │ │ -000358d0: 2020 2020 2020 2049 4e54 4547 4552 3120 INTEGER1 │ │ │ │ │ -000358e0: 6973 2067 7265 6174 6572 2074 6861 6e20 is greater than │ │ │ │ │ -000358f0: 494e 5445 4745 5232 2061 6674 6572 2073 INTEGER2 after s │ │ │ │ │ -00035900: 7472 6970 7069 6e67 206f 6666 2063 6f6d tripping off com │ │ │ │ │ -00035910: 6d6f 6e0a 2020 2020 2020 2020 2020 6e6f mon. no │ │ │ │ │ -00035920: 6e2d 6e75 6d65 7269 6320 5052 4546 4958 n-numeric PREFIX │ │ │ │ │ -00035930: 2e0a 2020 2020 2050 5245 4649 5849 4e54 .. PREFIXINT │ │ │ │ │ -00035940: 4547 4552 3120 272d 706c 7427 2050 5245 EGER1 '-plt' PRE │ │ │ │ │ -00035950: 4649 5849 4e54 4547 4552 320a 2020 2020 FIXINTEGER2. │ │ │ │ │ -00035960: 2020 2020 2020 494e 5445 4745 5231 2069 INTEGER1 i │ │ │ │ │ -00035970: 7320 6c65 7373 2074 6861 6e20 494e 5445 s less than INTE │ │ │ │ │ -00035980: 4745 5232 2061 6674 6572 2073 7472 6970 GER2 after strip │ │ │ │ │ -00035990: 7069 6e67 206f 6666 2063 6f6d 6d6f 6e0a ping off common. │ │ │ │ │ -000359a0: 2020 2020 2020 2020 2020 6e6f 6e2d 6e75 non-nu │ │ │ │ │ -000359b0: 6d65 7269 6320 5052 4546 4958 2e0a 2020 meric PREFIX.. │ │ │ │ │ -000359c0: 2020 2046 494c 4531 2027 2d6e 7427 2046 FILE1 '-nt' F │ │ │ │ │ -000359d0: 494c 4532 0a20 2020 2020 2020 2020 2046 ILE2. F │ │ │ │ │ -000359e0: 494c 4531 2069 7320 6e65 7765 7220 7468 ILE1 is newer th │ │ │ │ │ -000359f0: 616e 2046 494c 4532 2028 6d6f 6469 6669 an FILE2 (modifi │ │ │ │ │ -00035a00: 6361 7469 6f6e 2074 696d 6529 2e20 204f cation time). O │ │ │ │ │ -00035a10: 7074 696f 6e61 6c6c 790a 2020 2020 2020 ptionally. │ │ │ │ │ -00035a20: 2020 2020 6e75 6d65 7269 6320 4249 4153 numeric BIAS │ │ │ │ │ -00035a30: 206d 6179 2062 6520 6469 7265 6374 6c79 may be directly │ │ │ │ │ -00035a40: 2061 7070 656e 6465 6420 746f 2027 2d6e appended to '-n │ │ │ │ │ -00035a50: 7427 2069 6e20 7768 6963 6820 6361 7365 t' in which case │ │ │ │ │ -00035a60: 0a20 2020 2020 2020 2020 2069 7420 6973 . it is │ │ │ │ │ -00035a70: 2061 6464 6564 2074 6f20 7468 6520 6669 added to the fi │ │ │ │ │ -00035a80: 7273 7420 6669 6c65 206d 6f64 6966 6963 rst file modific │ │ │ │ │ -00035a90: 6174 696f 6e20 7469 6d65 2e0a 2020 2020 ation time.. │ │ │ │ │ -00035aa0: 2046 494c 4531 2027 2d6f 7427 2046 494c FILE1 '-ot' FIL │ │ │ │ │ -00035ab0: 4532 0a20 2020 2020 2020 2020 2046 494c E2. FIL │ │ │ │ │ -00035ac0: 4531 2069 7320 6f6c 6465 7220 7468 616e E1 is older than │ │ │ │ │ -00035ad0: 2046 494c 4532 2028 6d6f 6469 6669 6361 FILE2 (modifica │ │ │ │ │ -00035ae0: 7469 6f6e 2074 696d 6529 2e20 204f 7074 tion time). Opt │ │ │ │ │ -00035af0: 696f 6e61 6c6c 790a 2020 2020 2020 2020 ionally. │ │ │ │ │ -00035b00: 2020 6e75 6d65 7269 6320 4249 4153 206d numeric BIAS m │ │ │ │ │ -00035b10: 6179 2062 6520 6469 7265 6374 6c79 2061 ay be directly a │ │ │ │ │ -00035b20: 7070 656e 6465 6420 746f 2027 2d6f 7427 ppended to '-ot' │ │ │ │ │ -00035b30: 2069 6e20 7768 6963 6820 6361 7365 0a20 in which case. │ │ │ │ │ -00035b40: 2020 2020 2020 2020 2069 7420 6973 2061 it is a │ │ │ │ │ -00035b50: 6464 6564 2074 6f20 7468 6520 6669 7273 dded to the firs │ │ │ │ │ -00035b60: 7420 6669 6c65 206d 6f64 6966 6963 6174 t file modificat │ │ │ │ │ -00035b70: 696f 6e20 7469 6d65 2e0a 2020 2020 2027 ion time.. ' │ │ │ │ │ -00035b80: 2d64 2720 4649 4c45 0a20 2020 2020 2020 -d' FILE. │ │ │ │ │ -00035b90: 2020 2046 494c 4520 6578 6973 7473 2061 FILE exists a │ │ │ │ │ -00035ba0: 6e64 2069 7320 6120 6469 7265 6374 6f72 nd is a director │ │ │ │ │ -00035bb0: 790a 2020 2020 2027 2d65 2720 4649 4c45 y. '-e' FILE │ │ │ │ │ -00035bc0: 0a20 2020 2020 2020 2020 2046 494c 4520 . FILE │ │ │ │ │ -00035bd0: 6578 6973 7473 0a20 2020 2020 272d 6627 exists. '-f' │ │ │ │ │ -00035be0: 2046 494c 450a 2020 2020 2020 2020 2020 FILE. │ │ │ │ │ -00035bf0: 4649 4c45 2065 7869 7374 7320 616e 6420 FILE exists and │ │ │ │ │ -00035c00: 6973 206e 6f74 2061 2064 6972 6563 746f is not a directo │ │ │ │ │ -00035c10: 7279 0a20 2020 2020 272d 7327 2046 494c ry. '-s' FIL │ │ │ │ │ -00035c20: 450a 2020 2020 2020 2020 2020 4649 4c45 E. FILE │ │ │ │ │ -00035c30: 2065 7869 7374 7320 616e 6420 6861 7320 exists and has │ │ │ │ │ -00035c40: 6120 7369 7a65 2067 7265 6174 6572 2074 a size greater t │ │ │ │ │ -00035c50: 6861 6e20 7a65 726f 0a20 2020 2020 272d han zero. '- │ │ │ │ │ -00035c60: 6e27 2053 5452 494e 470a 2020 2020 2020 n' STRING. │ │ │ │ │ -00035c70: 2020 2020 7468 6520 6c65 6e67 7468 206f the length o │ │ │ │ │ -00035c80: 6620 5354 5249 4e47 2069 7320 6e6f 6e7a f STRING is nonz │ │ │ │ │ -00035c90: 6572 6f0a 2020 2020 2053 5452 494e 470a ero. STRING. │ │ │ │ │ -00035ca0: 2020 2020 2020 2020 2020 5354 5249 4e47 STRING │ │ │ │ │ -00035cb0: 2069 7320 6571 7569 7661 6c65 6e74 2074 is equivalent t │ │ │ │ │ -00035cc0: 6f20 272d 6e20 5354 5249 4e47 270a 2020 o '-n STRING'. │ │ │ │ │ -00035cd0: 2020 2027 2d7a 2720 5354 5249 4e47 0a20 '-z' STRING. │ │ │ │ │ -00035ce0: 2020 2020 2020 2020 2074 6865 206c 656e the len │ │ │ │ │ -00035cf0: 6774 6820 6f66 2053 5452 494e 4720 6973 gth of STRING is │ │ │ │ │ -00035d00: 207a 6572 6f0a 2020 2020 2027 2827 2045 zero. '(' E │ │ │ │ │ -00035d10: 5850 5245 5353 494f 4e20 2729 270a 2020 XPRESSION ')'. │ │ │ │ │ -00035d20: 2020 2020 2020 2020 4558 5052 4553 5349 EXPRESSI │ │ │ │ │ -00035d30: 4f4e 2069 7320 7472 7565 0a20 2020 2020 ON is true. │ │ │ │ │ -00035d40: 2721 2720 4558 5052 4553 5349 4f4e 0a20 '!' EXPRESSION. │ │ │ │ │ -00035d50: 2020 2020 2020 2020 2045 5850 5245 5353 EXPRESS │ │ │ │ │ -00035d60: 494f 4e20 6973 2066 616c 7365 0a20 2020 ION is false. │ │ │ │ │ -00035d70: 2020 4558 5052 4553 5349 4f4e 3120 272d EXPRESSION1 '- │ │ │ │ │ -00035d80: 6127 2045 5850 5245 5353 494f 4e32 0a20 a' EXPRESSION2. │ │ │ │ │ -00035d90: 2020 2020 2020 2020 2062 6f74 6820 4558 both EX │ │ │ │ │ -00035da0: 5052 4553 5349 4f4e 3120 616e 6420 4558 PRESSION1 and EX │ │ │ │ │ -00035db0: 5052 4553 5349 4f4e 3220 6172 6520 7472 PRESSION2 are tr │ │ │ │ │ -00035dc0: 7565 0a20 2020 2020 4558 5052 4553 5349 ue. EXPRESSI │ │ │ │ │ -00035dd0: 4f4e 3120 4558 5052 4553 5349 4f4e 320a ON1 EXPRESSION2. │ │ │ │ │ -00035de0: 2020 2020 2020 2020 2020 626f 7468 2045 both E │ │ │ │ │ -00035df0: 5850 5245 5353 494f 4e31 2061 6e64 2045 XPRESSION1 and E │ │ │ │ │ -00035e00: 5850 5245 5353 494f 4e32 2061 7265 2074 XPRESSION2 are t │ │ │ │ │ -00035e10: 7275 652e 2020 5468 6973 2073 796e 7461 rue. This synta │ │ │ │ │ -00035e20: 7820 6973 206e 6f74 0a20 2020 2020 2020 x is not. │ │ │ │ │ -00035e30: 2020 2050 4f53 4958 2d63 6f6d 706c 6961 POSIX-complia │ │ │ │ │ -00035e40: 6e74 2061 6e64 2069 7320 6e6f 7420 7265 nt and is not re │ │ │ │ │ -00035e50: 636f 6d6d 656e 6465 642e 0a20 2020 2020 commended.. │ │ │ │ │ -00035e60: 4558 5052 4553 5349 4f4e 3120 272d 6f27 EXPRESSION1 '-o' │ │ │ │ │ -00035e70: 2045 5850 5245 5353 494f 4e32 0a20 2020 EXPRESSION2. │ │ │ │ │ -00035e80: 2020 2020 2020 2065 6974 6865 7220 4558 either EX │ │ │ │ │ -00035e90: 5052 4553 5349 4f4e 3120 6f72 2045 5850 PRESSION1 or EXP │ │ │ │ │ -00035ea0: 5245 5353 494f 4e32 2069 7320 7472 7565 RESSION2 is true │ │ │ │ │ -00035eb0: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ -00035ec0: 6e66 6f2c 2020 4e6f 6465 3a20 7472 7565 nfo, Node: true │ │ │ │ │ -00035ed0: 2c20 204e 6578 743a 2074 7275 7374 2c20 , Next: trust, │ │ │ │ │ -00035ee0: 2050 7265 763a 2074 6573 742c 2020 5570 Prev: test, Up │ │ │ │ │ -00035ef0: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ │ -00035f00: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ │ -00035f10: 6d6d 616e 6473 0a0a 3136 2e33 2e37 3520 mmands..16.3.75 │ │ │ │ │ -00035f20: 7472 7565 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d true.----------- │ │ │ │ │ -00035f30: 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 -.. -- Command: │ │ │ │ │ -00035f40: 7472 7565 0a20 2020 2020 446f 206e 6f74 true. Do not │ │ │ │ │ -00035f50: 6869 6e67 2c20 7375 6363 6573 7366 756c hing, successful │ │ │ │ │ -00035f60: 6c79 2e20 2054 6869 7320 6973 206d 6169 ly. This is mai │ │ │ │ │ -00035f70: 6e6c 7920 7573 6566 756c 2069 6e20 636f nly useful in co │ │ │ │ │ -00035f80: 6e74 726f 6c0a 2020 2020 2063 6f6e 7374 ntrol. const │ │ │ │ │ -00035f90: 7275 6374 7320 7375 6368 2061 7320 2769 ructs such as 'i │ │ │ │ │ -00035fa0: 6627 2061 6e64 2027 7768 696c 6527 2028 f' and 'while' ( │ │ │ │ │ -00035fb0: 2a6e 6f74 6520 5368 656c 6c2d 6c69 6b65 *note Shell-like │ │ │ │ │ -00035fc0: 2073 6372 6970 7469 6e67 3a3a 292e 0a0a scripting::)... │ │ │ │ │ -00035fd0: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ -00035fe0: 6f2c 2020 4e6f 6465 3a20 7472 7573 742c o, Node: trust, │ │ │ │ │ -00035ff0: 2020 4e65 7874 3a20 756e 7365 742c 2020 Next: unset, │ │ │ │ │ -00036000: 5072 6576 3a20 7472 7565 2c20 2055 703a Prev: true, Up: │ │ │ │ │ -00036010: 2043 6f6d 6d61 6e64 2d6c 696e 6520 616e Command-line an │ │ │ │ │ -00036020: 6420 6d65 6e75 2065 6e74 7279 2063 6f6d d menu entry com │ │ │ │ │ -00036030: 6d61 6e64 730a 0a31 362e 332e 3736 2074 mands..16.3.76 t │ │ │ │ │ -00036040: 7275 7374 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d rust.----------- │ │ │ │ │ -00036050: 2d2d 0a0a 202d 2d20 436f 6d6d 616e 643a --.. -- Command: │ │ │ │ │ -00036060: 2074 7275 7374 205b 2d2d 736b 6970 2d73 trust [--skip-s │ │ │ │ │ -00036070: 6967 5d20 7075 626b 6579 5f66 696c 650a ig] pubkey_file. │ │ │ │ │ -00036080: 2020 2020 2052 6561 6420 7075 626c 6963 Read public │ │ │ │ │ -00036090: 206b 6579 2066 726f 6d20 5055 424b 4559 key from PUBKEY │ │ │ │ │ -000360a0: 5f46 494c 4520 616e 6420 6164 6420 6974 _FILE and add it │ │ │ │ │ -000360b0: 2074 6f20 4752 5542 2773 2069 6e74 6572 to GRUB's inter │ │ │ │ │ -000360c0: 6e61 6c20 6c69 7374 0a20 2020 2020 6f66 nal list. of │ │ │ │ │ -000360d0: 2074 7275 7374 6564 2070 7562 6c69 6320 trusted public │ │ │ │ │ -000360e0: 6b65 7973 2e20 2054 6865 7365 206b 6579 keys. These key │ │ │ │ │ -000360f0: 7320 6172 6520 7573 6564 2074 6f20 7661 s are used to va │ │ │ │ │ -00036100: 6c69 6461 7465 2064 6967 6974 616c 0a20 lidate digital. │ │ │ │ │ -00036110: 2020 2020 7369 676e 6174 7572 6573 2077 signatures w │ │ │ │ │ -00036120: 6865 6e20 656e 7669 726f 6e6d 656e 7420 hen environment │ │ │ │ │ -00036130: 7661 7269 6162 6c65 2027 6368 6563 6b5f variable 'check_ │ │ │ │ │ -00036140: 7369 676e 6174 7572 6573 2720 6973 2073 signatures' is s │ │ │ │ │ -00036150: 6574 2074 6f0a 2020 2020 2027 656e 666f et to. 'enfo │ │ │ │ │ -00036160: 7263 6527 2e20 204e 6f74 6520 7468 6174 rce'. Note that │ │ │ │ │ -00036170: 2069 6620 2763 6865 636b 5f73 6967 6e61 if 'check_signa │ │ │ │ │ -00036180: 7475 7265 7327 2069 7320 7365 7420 746f tures' is set to │ │ │ │ │ -00036190: 2027 656e 666f 7263 6527 0a20 2020 2020 'enforce'. │ │ │ │ │ -000361a0: 7768 656e 2027 7472 7573 7427 2065 7865 when 'trust' exe │ │ │ │ │ -000361b0: 6375 7465 732c 2074 6865 6e20 5055 424b cutes, then PUBK │ │ │ │ │ -000361c0: 4559 5f46 494c 4520 6d75 7374 2069 7473 EY_FILE must its │ │ │ │ │ -000361d0: 656c 6620 6265 2070 726f 7065 726c 790a elf be properly. │ │ │ │ │ -000361e0: 2020 2020 2073 6967 6e65 642e 2020 5468 signed. Th │ │ │ │ │ -000361f0: 6520 272d 2d73 6b69 702d 7369 6727 206f e '--skip-sig' o │ │ │ │ │ -00036200: 7074 696f 6e20 6361 6e20 6265 2075 7365 ption can be use │ │ │ │ │ -00036210: 6420 746f 2064 6973 6162 6c65 0a20 2020 d to disable. │ │ │ │ │ -00036220: 2020 7369 676e 6174 7572 652d 6368 6563 signature-chec │ │ │ │ │ -00036230: 6b69 6e67 2077 6865 6e20 7265 6164 696e king when readin │ │ │ │ │ -00036240: 6720 5055 424b 4559 5f46 494c 4520 6974 g PUBKEY_FILE it │ │ │ │ │ -00036250: 7365 6c66 2e20 2049 7420 6973 2065 7870 self. It is exp │ │ │ │ │ -00036260: 6563 7465 640a 2020 2020 2074 6861 7420 ected. that │ │ │ │ │ -00036270: 272d 2d73 6b69 702d 7369 6727 2069 7320 '--skip-sig' is │ │ │ │ │ -00036280: 7573 6566 756c 2066 6f72 2074 6573 7469 useful for testi │ │ │ │ │ -00036290: 6e67 2061 6e64 206d 616e 7561 6c20 626f ng and manual bo │ │ │ │ │ -000362a0: 6f74 696e 672e 2020 2a4e 6f74 650a 2020 oting. *Note. │ │ │ │ │ -000362b0: 2020 2055 7369 6e67 2064 6967 6974 616c Using digital │ │ │ │ │ -000362c0: 2073 6967 6e61 7475 7265 733a 3a2c 2066 signatures::, f │ │ │ │ │ -000362d0: 6f72 206d 6f72 6520 696e 666f 726d 6174 or more informat │ │ │ │ │ -000362e0: 696f 6e2e 0a0a 1f0a 4669 6c65 3a20 6772 ion.....File: gr │ │ │ │ │ -000362f0: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ -00036300: 756e 7365 742c 2020 4e65 7874 3a20 7665 unset, Next: ve │ │ │ │ │ -00036310: 7269 6679 5f64 6574 6163 6865 642c 2020 rify_detached, │ │ │ │ │ -00036320: 5072 6576 3a20 7472 7573 742c 2020 5570 Prev: trust, Up │ │ │ │ │ -00036330: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ │ -00036340: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ │ -00036350: 6d6d 616e 6473 0a0a 3136 2e33 2e37 3720 mmands..16.3.77 │ │ │ │ │ -00036360: 756e 7365 740a 2d2d 2d2d 2d2d 2d2d 2d2d unset.---------- │ │ │ │ │ -00036370: 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 ---.. -- Command │ │ │ │ │ -00036380: 3a20 756e 7365 7420 656e 7676 6172 0a20 : unset envvar. │ │ │ │ │ -00036390: 2020 2020 556e 7365 7420 7468 6520 656e Unset the en │ │ │ │ │ -000363a0: 7669 726f 6e6d 656e 7420 7661 7269 6162 vironment variab │ │ │ │ │ -000363b0: 6c65 2045 4e56 5641 522e 0a0a 1f0a 4669 le ENVVAR.....Fi │ │ │ │ │ -000363c0: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ -000363d0: 4e6f 6465 3a20 7665 7269 6679 5f64 6574 Node: verify_det │ │ │ │ │ -000363e0: 6163 6865 642c 2020 4e65 7874 3a20 7669 ached, Next: vi │ │ │ │ │ -000363f0: 6465 6f69 6e66 6f2c 2020 5072 6576 3a20 deoinfo, Prev: │ │ │ │ │ -00036400: 756e 7365 742c 2020 5570 3a20 436f 6d6d unset, Up: Comm │ │ │ │ │ -00036410: 616e 642d 6c69 6e65 2061 6e64 206d 656e and-line and men │ │ │ │ │ -00036420: 7520 656e 7472 7920 636f 6d6d 616e 6473 u entry commands │ │ │ │ │ -00036430: 0a0a 3136 2e33 2e37 3820 7665 7269 6679 ..16.3.78 verify │ │ │ │ │ -00036440: 5f64 6574 6163 6865 640a 2d2d 2d2d 2d2d _detached.------ │ │ │ │ │ -00036450: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00036460: 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 -.. -- Command: │ │ │ │ │ -00036470: 7665 7269 6679 5f64 6574 6163 6865 6420 verify_detached │ │ │ │ │ -00036480: 5b2d 2d73 6b69 702d 7369 675d 2066 696c [--skip-sig] fil │ │ │ │ │ -00036490: 6520 7369 676e 6174 7572 655f 6669 6c65 e signature_file │ │ │ │ │ -000364a0: 0a20 2020 2020 2020 2020 205b 7075 626b . [pubk │ │ │ │ │ -000364b0: 6579 5f66 696c 655d 0a20 2020 2020 5665 ey_file]. Ve │ │ │ │ │ -000364c0: 7269 6669 6573 2061 2047 5047 2d73 7479 rifies a GPG-sty │ │ │ │ │ -000364d0: 6c65 2064 6574 6163 6865 6420 7369 676e le detached sign │ │ │ │ │ -000364e0: 6174 7572 652c 2077 6865 7265 2074 6865 ature, where the │ │ │ │ │ -000364f0: 2073 6967 6e65 6420 6669 6c65 2069 730a signed file is. │ │ │ │ │ -00036500: 2020 2020 2046 494c 452c 2061 6e64 2074 FILE, and t │ │ │ │ │ -00036510: 6865 2073 6967 6e61 7475 7265 2069 7473 he signature its │ │ │ │ │ -00036520: 656c 6620 6973 2069 6e20 6669 6c65 2053 elf is in file S │ │ │ │ │ -00036530: 4947 4e41 5455 5245 5f46 494c 452e 0a20 IGNATURE_FILE.. │ │ │ │ │ -00036540: 2020 2020 4f70 7469 6f6e 616c 6c79 2c20 Optionally, │ │ │ │ │ -00036550: 6120 7370 6563 6966 6963 2070 7562 6c69 a specific publi │ │ │ │ │ -00036560: 6320 6b65 7920 746f 2075 7365 2063 616e c key to use can │ │ │ │ │ -00036570: 2062 6520 7370 6563 6966 6965 6420 7573 be specified us │ │ │ │ │ -00036580: 696e 670a 2020 2020 2050 5542 4b45 595f ing. PUBKEY_ │ │ │ │ │ -00036590: 4649 4c45 2e20 2057 6865 6e20 656e 7669 FILE. When envi │ │ │ │ │ -000365a0: 726f 6e6d 656e 7420 7661 7269 6162 6c65 ronment variable │ │ │ │ │ -000365b0: 2027 6368 6563 6b5f 7369 676e 6174 7572 'check_signatur │ │ │ │ │ -000365c0: 6573 2720 6973 2073 6574 0a20 2020 2020 es' is set. │ │ │ │ │ -000365d0: 746f 2027 656e 666f 7263 6527 2c20 7468 to 'enforce', th │ │ │ │ │ -000365e0: 656e 2050 5542 4b45 595f 4649 4c45 206d en PUBKEY_FILE m │ │ │ │ │ -000365f0: 7573 7420 6974 7365 6c66 2062 6520 7072 ust itself be pr │ │ │ │ │ -00036600: 6f70 6572 6c79 2073 6967 6e65 6420 6279 operly signed by │ │ │ │ │ -00036610: 2061 6e0a 2020 2020 2061 6c72 6561 6479 an. already │ │ │ │ │ -00036620: 2d74 7275 7374 6564 206b 6579 2e20 2041 -trusted key. A │ │ │ │ │ -00036630: 6e20 756e 7369 676e 6564 2050 5542 4b45 n unsigned PUBKE │ │ │ │ │ -00036640: 595f 4649 4c45 2063 616e 2062 6520 6c6f Y_FILE can be lo │ │ │ │ │ -00036650: 6164 6564 2062 790a 2020 2020 2073 7065 aded by. spe │ │ │ │ │ -00036660: 6369 6679 696e 6720 272d 2d73 6b69 702d cifying '--skip- │ │ │ │ │ -00036670: 7369 6727 2e20 2049 6620 5055 424b 4559 sig'. If PUBKEY │ │ │ │ │ -00036680: 5f46 494c 4520 6973 206f 6d69 7474 6564 _FILE is omitted │ │ │ │ │ -00036690: 2c20 7468 656e 2070 7562 6c69 630a 2020 , then public. │ │ │ │ │ -000366a0: 2020 206b 6579 7320 6672 6f6d 2047 5255 keys from GRU │ │ │ │ │ -000366b0: 4227 7320 7472 7573 7465 6420 6b65 7973 B's trusted keys │ │ │ │ │ -000366c0: 2028 2a6e 6f74 6520 6c69 7374 5f74 7275 (*note list_tru │ │ │ │ │ -000366d0: 7374 6564 3a3a 2c20 2a6e 6f74 6520 7472 sted::, *note tr │ │ │ │ │ -000366e0: 7573 743a 3a2c 0a20 2020 2020 616e 6420 ust::,. and │ │ │ │ │ -000366f0: 2a6e 6f74 6520 6469 7374 7275 7374 3a3a *note distrust:: │ │ │ │ │ -00036700: 2920 6172 6520 7472 6965 642e 0a0a 2020 ) are tried... │ │ │ │ │ -00036710: 2020 2045 7869 7420 636f 6465 2027 243f Exit code '$? │ │ │ │ │ -00036720: 2720 6973 2073 6574 2074 6f20 3020 6966 ' is set to 0 if │ │ │ │ │ -00036730: 2074 6865 2073 6967 6e61 7475 7265 2076 the signature v │ │ │ │ │ -00036740: 616c 6964 6174 6573 2073 7563 6365 7373 alidates success │ │ │ │ │ -00036750: 6675 6c6c 792e 0a20 2020 2020 4966 2076 fully.. If v │ │ │ │ │ -00036760: 616c 6964 6174 696f 6e20 6661 696c 732c alidation fails, │ │ │ │ │ -00036770: 2069 7420 6973 2073 6574 2074 6f20 6120 it is set to a │ │ │ │ │ -00036780: 6e6f 6e2d 7a65 726f 2076 616c 7565 2e20 non-zero value. │ │ │ │ │ -00036790: 202a 4e6f 7465 2055 7369 6e67 0a20 2020 *Note Using. │ │ │ │ │ -000367a0: 2020 6469 6769 7461 6c20 7369 676e 6174 digital signat │ │ │ │ │ -000367b0: 7572 6573 3a3a 2c20 666f 7220 6d6f 7265 ures::, for more │ │ │ │ │ -000367c0: 2069 6e66 6f72 6d61 7469 6f6e 2e0a 0a1f information.... │ │ │ │ │ -000367d0: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ -000367e0: 2c20 204e 6f64 653a 2076 6964 656f 696e , Node: videoin │ │ │ │ │ -000367f0: 666f 2c20 204e 6578 743a 2077 726d 7372 fo, Next: wrmsr │ │ │ │ │ -00036800: 2c20 2050 7265 763a 2076 6572 6966 795f , Prev: verify_ │ │ │ │ │ -00036810: 6465 7461 6368 6564 2c20 2055 703a 2043 detached, Up: C │ │ │ │ │ -00036820: 6f6d 6d61 6e64 2d6c 696e 6520 616e 6420 ommand-line and │ │ │ │ │ -00036830: 6d65 6e75 2065 6e74 7279 2063 6f6d 6d61 menu entry comma │ │ │ │ │ -00036840: 6e64 730a 0a31 362e 332e 3739 2076 6964 nds..16.3.79 vid │ │ │ │ │ -00036850: 656f 696e 666f 0a2d 2d2d 2d2d 2d2d 2d2d eoinfo.--------- │ │ │ │ │ -00036860: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ │ -00036870: 6d6d 616e 643a 2076 6964 656f 696e 666f mmand: videoinfo │ │ │ │ │ -00036880: 205b 5b57 7848 5d78 445d 0a20 2020 2020 [[WxH]xD]. │ │ │ │ │ -00036890: 4c69 7374 2061 7661 696c 6162 6c65 2076 List available v │ │ │ │ │ -000368a0: 6964 656f 206d 6f64 6573 2e20 2049 6620 ideo modes. If │ │ │ │ │ -000368b0: 7265 736f 6c75 7469 6f6e 2069 7320 6769 resolution is gi │ │ │ │ │ -000368c0: 7665 6e2c 2073 686f 7720 6f6e 6c79 0a20 ven, show only. │ │ │ │ │ -000368d0: 2020 2020 6d61 7463 6869 6e67 206d 6f64 matching mod │ │ │ │ │ -000368e0: 6573 2e0a 0a1f 0a46 696c 653a 2067 7275 es.....File: gru │ │ │ │ │ -000368f0: 622e 696e 666f 2c20 204e 6f64 653a 2077 b.info, Node: w │ │ │ │ │ -00036900: 726d 7372 2c20 204e 6578 743a 2078 656e rmsr, Next: xen │ │ │ │ │ -00036910: 5f68 7970 6572 7669 736f 722c 2020 5072 _hypervisor, Pr │ │ │ │ │ -00036920: 6576 3a20 7669 6465 6f69 6e66 6f2c 2020 ev: videoinfo, │ │ │ │ │ -00036930: 5570 3a20 436f 6d6d 616e 642d 6c69 6e65 Up: Command-line │ │ │ │ │ -00036940: 2061 6e64 206d 656e 7520 656e 7472 7920 and menu entry │ │ │ │ │ -00036950: 636f 6d6d 616e 6473 0a0a 3136 2e33 2e38 commands..16.3.8 │ │ │ │ │ -00036960: 3020 7772 6d73 720a 2d2d 2d2d 2d2d 2d2d 0 wrmsr.-------- │ │ │ │ │ -00036970: 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 -----.. -- Comma │ │ │ │ │ -00036980: 6e64 3a3a 2077 726d 7372 2030 7841 4444 nd:: wrmsr 0xADD │ │ │ │ │ -00036990: 5220 3078 5641 4c55 450a 2020 2020 2057 R 0xVALUE. W │ │ │ │ │ -000369a0: 7269 7465 2061 2030 7856 414c 5545 2074 rite a 0xVALUE t │ │ │ │ │ -000369b0: 6f20 6120 6d6f 6465 6c2d 7370 6563 6966 o a model-specif │ │ │ │ │ -000369c0: 6963 2072 6567 6973 7465 7220 6174 2061 ic register at a │ │ │ │ │ -000369d0: 6464 7265 7373 2030 7841 4444 522e 0a0a ddress 0xADDR... │ │ │ │ │ -000369e0: 2020 2020 2050 6c65 6173 6520 6e6f 7465 Please note │ │ │ │ │ -000369f0: 2074 6861 7420 6f6e 2053 4d50 2073 7973 that on SMP sys │ │ │ │ │ -00036a00: 7465 6d73 2c20 7772 6974 696e 6720 746f tems, writing to │ │ │ │ │ -00036a10: 2061 204d 5352 2074 6861 7420 6861 7320 a MSR that has │ │ │ │ │ -00036a20: 6120 7363 6f70 650a 2020 2020 2070 6572 a scope. per │ │ │ │ │ -00036a30: 2068 6172 6477 6172 6520 7468 7265 6164 hardware thread │ │ │ │ │ -00036a40: 2c20 696d 706c 6965 7320 7468 6174 2074 , implies that t │ │ │ │ │ -00036a50: 6865 2076 616c 7565 2074 6861 7420 6973 he value that is │ │ │ │ │ -00036a60: 2077 7269 7474 656e 206f 6e6c 790a 2020 written only. │ │ │ │ │ -00036a70: 2020 2061 7070 6c69 6573 2074 6f20 7468 applies to th │ │ │ │ │ -00036a80: 6520 7061 7274 6963 756c 6172 2063 7075 e particular cpu │ │ │ │ │ -00036a90: 2f63 6f72 652f 7468 7265 6164 2074 6861 /core/thread tha │ │ │ │ │ -00036aa0: 7420 7275 6e73 2074 6865 2063 6f6d 6d61 t runs the comma │ │ │ │ │ -00036ab0: 6e64 2e0a 0a20 2020 2020 416c 736f 2c20 nd... Also, │ │ │ │ │ -00036ac0: 6966 2079 6f75 2073 7065 6369 6679 2061 if you specify a │ │ │ │ │ -00036ad0: 2072 6573 6572 7665 6420 6f72 2075 6e69 reserved or uni │ │ │ │ │ -00036ae0: 6d70 6c65 6d65 6e74 6564 204d 5352 2061 mplemented MSR a │ │ │ │ │ -00036af0: 6464 7265 7373 2c20 6974 0a20 2020 2020 ddress, it. │ │ │ │ │ -00036b00: 7769 6c6c 2063 6175 7365 2061 2067 656e will cause a gen │ │ │ │ │ -00036b10: 6572 616c 2070 726f 7465 6374 696f 6e20 eral protection │ │ │ │ │ -00036b20: 6578 6365 7074 696f 6e20 2877 6869 6368 exception (which │ │ │ │ │ -00036b30: 2069 7320 6e6f 7420 6375 7272 656e 746c is not currentl │ │ │ │ │ -00036b40: 790a 2020 2020 2062 6569 6e67 2068 616e y. being han │ │ │ │ │ -00036b50: 646c 6564 2920 616e 6420 7468 6520 7379 dled) and the sy │ │ │ │ │ -00036b60: 7374 656d 2077 696c 6c20 7265 626f 6f74 stem will reboot │ │ │ │ │ -00036b70: 2e0a 0a20 2020 2020 4e6f 7465 3a20 5468 ... Note: Th │ │ │ │ │ -00036b80: 6520 636f 6d6d 616e 6420 6973 206e 6f74 e command is not │ │ │ │ │ -00036b90: 2061 6c6c 6f77 6564 2077 6865 6e20 6c6f allowed when lo │ │ │ │ │ -00036ba0: 636b 646f 776e 2069 7320 656e 666f 7263 ckdown is enforc │ │ │ │ │ -00036bb0: 6564 2028 2a6e 6f74 650a 2020 2020 204c ed (*note. L │ │ │ │ │ -00036bc0: 6f63 6b64 6f77 6e3a 3a29 2e20 2054 6869 ockdown::). Thi │ │ │ │ │ -00036bd0: 7320 6973 2064 6f6e 6520 746f 2070 7265 s is done to pre │ │ │ │ │ -00036be0: 7665 6e74 2073 7562 7665 7274 696e 6720 vent subverting │ │ │ │ │ -00036bf0: 7661 7269 6f75 7320 7365 6375 7269 7479 various security │ │ │ │ │ -00036c00: 0a20 2020 2020 6d65 6368 616e 6973 6d73 . mechanisms │ │ │ │ │ -00036c10: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ -00036c20: 696e 666f 2c20 204e 6f64 653a 2078 656e info, Node: xen │ │ │ │ │ -00036c30: 5f68 7970 6572 7669 736f 722c 2020 4e65 _hypervisor, Ne │ │ │ │ │ -00036c40: 7874 3a20 7865 6e5f 6d6f 6475 6c65 2c20 xt: xen_module, │ │ │ │ │ -00036c50: 2050 7265 763a 2077 726d 7372 2c20 2055 Prev: wrmsr, U │ │ │ │ │ -00036c60: 703a 2043 6f6d 6d61 6e64 2d6c 696e 6520 p: Command-line │ │ │ │ │ -00036c70: 616e 6420 6d65 6e75 2065 6e74 7279 2063 and menu entry c │ │ │ │ │ -00036c80: 6f6d 6d61 6e64 730a 0a31 362e 332e 3831 ommands..16.3.81 │ │ │ │ │ -00036c90: 2078 656e 5f68 7970 6572 7669 736f 720a xen_hypervisor. │ │ │ │ │ +00033a70: 5269 6768 740a 0a20 2020 2020 4173 2077 Right.. As w │ │ │ │ │ +00033a80: 656c 6c20 6173 206b 6579 7374 726f 6b65 ell as keystroke │ │ │ │ │ +00033a90: 732c 2074 6865 2027 7365 6e64 6b65 7927 s, the 'sendkey' │ │ │ │ │ +00033aa0: 2063 6f6d 6d61 6e64 2074 616b 6573 2076 command takes v │ │ │ │ │ +00033ab0: 6172 696f 7573 206f 7074 696f 6e73 0a20 arious options. │ │ │ │ │ +00033ac0: 2020 2020 7468 6174 2061 6666 6563 7420 that affect │ │ │ │ │ +00033ad0: 7468 6520 4249 4f53 206b 6579 626f 6172 the BIOS keyboar │ │ │ │ │ +00033ae0: 6420 7374 6174 7573 2066 6c61 6773 2e20 d status flags. │ │ │ │ │ +00033af0: 2054 6865 7365 206f 7074 696f 6e73 2074 These options t │ │ │ │ │ +00033b00: 616b 6520 616e 0a20 2020 2020 276f 6e27 ake an. 'on' │ │ │ │ │ +00033b10: 206f 7220 276f 6666 2720 7061 7261 6d65 or 'off' parame │ │ │ │ │ +00033b20: 7465 722c 2073 7065 6369 6679 696e 6720 ter, specifying │ │ │ │ │ +00033b30: 7468 6174 2074 6865 2063 6f72 7265 7370 that the corresp │ │ │ │ │ +00033b40: 6f6e 6469 6e67 2073 7461 7475 730a 2020 onding status. │ │ │ │ │ +00033b50: 2020 2066 6c61 6720 6265 2073 6574 206f flag be set o │ │ │ │ │ +00033b60: 7220 756e 7365 743b 206f 6d69 7474 696e r unset; omittin │ │ │ │ │ +00033b70: 6720 7468 6520 6f70 7469 6f6e 2066 6f72 g the option for │ │ │ │ │ +00033b80: 2061 2067 6976 656e 2073 7461 7475 7320 a given status │ │ │ │ │ +00033b90: 666c 6167 0a20 2020 2020 7769 6c6c 206c flag. will l │ │ │ │ │ +00033ba0: 6561 7665 2074 6861 7420 666c 6167 2061 eave that flag a │ │ │ │ │ +00033bb0: 7420 6974 7320 696e 6974 6961 6c20 7374 t its initial st │ │ │ │ │ +00033bc0: 6174 6520 6174 2062 6f6f 742e 2020 5468 ate at boot. Th │ │ │ │ │ +00033bd0: 6520 272d 2d6e 756d 272c 0a20 2020 2020 e '--num',. │ │ │ │ │ +00033be0: 272d 2d63 6170 7327 2c20 272d 2d73 6372 '--caps', '--scr │ │ │ │ │ +00033bf0: 6f6c 6c27 2c20 616e 6420 272d 2d69 6e73 oll', and '--ins │ │ │ │ │ +00033c00: 6572 7427 206f 7074 696f 6e73 2065 6d75 ert' options emu │ │ │ │ │ +00033c10: 6c61 7465 2073 6574 7469 6e67 2074 6865 late setting the │ │ │ │ │ +00033c20: 0a20 2020 2020 636f 7272 6573 706f 6e64 . correspond │ │ │ │ │ +00033c30: 696e 6720 6d6f 6465 2c20 7768 696c 6520 ing mode, while │ │ │ │ │ +00033c40: 7468 6520 272d 2d6e 756d 6b65 7927 2c20 the '--numkey', │ │ │ │ │ +00033c50: 272d 2d63 6170 736b 6579 272c 0a20 2020 '--capskey',. │ │ │ │ │ +00033c60: 2020 272d 2d73 6372 6f6c 6c6b 6579 272c '--scrollkey', │ │ │ │ │ +00033c70: 2061 6e64 2027 2d2d 696e 7365 7274 6b65 and '--insertke │ │ │ │ │ +00033c80: 7927 206f 7074 696f 6e73 2065 6d75 6c61 y' options emula │ │ │ │ │ +00033c90: 7465 2070 7265 7373 696e 6720 616e 640a te pressing and. │ │ │ │ │ +00033ca0: 2020 2020 2068 6f6c 6469 6e67 2074 6865 holding the │ │ │ │ │ +00033cb0: 2063 6f72 7265 7370 6f6e 6469 6e67 206b corresponding k │ │ │ │ │ +00033cc0: 6579 2e20 2054 6865 206f 7468 6572 2073 ey. The other s │ │ │ │ │ +00033cd0: 7461 7475 7320 666c 6167 206f 7074 696f tatus flag optio │ │ │ │ │ +00033ce0: 6e73 2061 7265 0a20 2020 2020 7365 6c66 ns are. self │ │ │ │ │ +00033cf0: 2d65 7870 6c61 6e61 746f 7279 2e0a 0a20 -explanatory... │ │ │ │ │ +00033d00: 2020 2020 4966 2074 6865 2027 2d2d 6e6f If the '--no │ │ │ │ │ +00033d10: 2d6c 6564 2720 6f70 7469 6f6e 2069 7320 -led' option is │ │ │ │ │ +00033d20: 6769 7665 6e2c 2074 6865 2073 7461 7475 given, the statu │ │ │ │ │ +00033d30: 7320 666c 6167 206f 7074 696f 6e73 2077 s flag options w │ │ │ │ │ +00033d40: 696c 6c0a 2020 2020 2068 6176 6520 6e6f ill. have no │ │ │ │ │ +00033d50: 2065 6666 6563 7420 6f6e 206b 6579 626f effect on keybo │ │ │ │ │ +00033d60: 6172 6420 4c45 4473 2e0a 0a20 2020 2020 ard LEDs... │ │ │ │ │ +00033d70: 4966 2074 6865 2027 7365 6e64 6b65 7927 If the 'sendkey' │ │ │ │ │ +00033d80: 2063 6f6d 6d61 6e64 2069 7320 6769 7665 command is give │ │ │ │ │ +00033d90: 6e20 6d75 6c74 6970 6c65 2074 696d 6573 n multiple times │ │ │ │ │ +00033da0: 2c20 7468 656e 206f 6e6c 7920 7468 650a , then only the. │ │ │ │ │ +00033db0: 2020 2020 206c 6173 7420 696e 766f 6361 last invoca │ │ │ │ │ +00033dc0: 7469 6f6e 2068 6173 2061 6e79 2065 6666 tion has any eff │ │ │ │ │ +00033dd0: 6563 742e 0a0a 2020 2020 2053 696e 6365 ect... Since │ │ │ │ │ +00033de0: 2027 7365 6e64 6b65 7927 206d 616e 6970 'sendkey' manip │ │ │ │ │ +00033df0: 756c 6174 6573 2074 6865 2042 494f 5320 ulates the BIOS │ │ │ │ │ +00033e00: 6b65 7962 6f61 7264 2062 7566 6665 722c keyboard buffer, │ │ │ │ │ +00033e10: 2069 7420 6d61 7920 6361 7573 650a 2020 it may cause. │ │ │ │ │ +00033e20: 2020 2068 616e 6773 2c20 7265 626f 6f74 hangs, reboot │ │ │ │ │ +00033e30: 732c 206f 7220 6f74 6865 7220 6d69 7362 s, or other misb │ │ │ │ │ +00033e40: 6568 6176 696f 7572 206f 6e20 736f 6d65 ehaviour on some │ │ │ │ │ +00033e50: 2073 7973 7465 6d73 2e20 2049 6620 7468 systems. If th │ │ │ │ │ +00033e60: 650a 2020 2020 206f 7065 7261 7469 6e67 e. operating │ │ │ │ │ +00033e70: 2073 7973 7465 6d20 6f72 2062 6f6f 7420 system or boot │ │ │ │ │ +00033e80: 6c6f 6164 6572 2074 6861 7420 7275 6e73 loader that runs │ │ │ │ │ +00033e90: 2061 6674 6572 2047 5255 4220 7573 6573 after GRUB uses │ │ │ │ │ +00033ea0: 2069 7473 206f 776e 0a20 2020 2020 6b65 its own. ke │ │ │ │ │ +00033eb0: 7962 6f61 7264 2064 7269 7665 7220 7261 yboard driver ra │ │ │ │ │ +00033ec0: 7468 6572 2074 6861 6e20 7468 6520 4249 ther than the BI │ │ │ │ │ +00033ed0: 4f53 206b 6579 626f 6172 6420 6675 6e63 OS keyboard func │ │ │ │ │ +00033ee0: 7469 6f6e 732c 2074 6865 6e0a 2020 2020 tions, then. │ │ │ │ │ +00033ef0: 2027 7365 6e64 6b65 7927 2077 696c 6c20 'sendkey' will │ │ │ │ │ +00033f00: 6861 7665 206e 6f20 6566 6665 6374 2e0a have no effect.. │ │ │ │ │ +00033f10: 0a20 2020 2020 5468 6973 2063 6f6d 6d61 . This comma │ │ │ │ │ +00033f20: 6e64 2069 7320 6f6e 6c79 2061 7661 696c nd is only avail │ │ │ │ │ +00033f30: 6162 6c65 206f 6e20 5043 2042 494f 5320 able on PC BIOS │ │ │ │ │ +00033f40: 7379 7374 656d 732e 0a0a 1f0a 4669 6c65 systems.....File │ │ │ │ │ +00033f50: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ +00033f60: 6465 3a20 7365 742c 2020 4e65 7874 3a20 de: set, Next: │ │ │ │ │ +00033f70: 7368 6131 7375 6d2c 2020 5072 6576 3a20 sha1sum, Prev: │ │ │ │ │ +00033f80: 7365 6e64 6b65 792c 2020 5570 3a20 436f sendkey, Up: Co │ │ │ │ │ +00033f90: 6d6d 616e 642d 6c69 6e65 2061 6e64 206d mmand-line and m │ │ │ │ │ +00033fa0: 656e 7520 656e 7472 7920 636f 6d6d 616e enu entry comman │ │ │ │ │ +00033fb0: 6473 0a0a 3136 2e33 2e36 3720 7365 740a ds..16.3.67 set. │ │ │ │ │ +00033fc0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d -----------.. -- │ │ │ │ │ +00033fd0: 2043 6f6d 6d61 6e64 3a20 7365 7420 5b65 Command: set [e │ │ │ │ │ +00033fe0: 6e76 7661 723d 7661 6c75 655d 0a20 2020 nvvar=value]. │ │ │ │ │ +00033ff0: 2020 5365 7420 7468 6520 656e 7669 726f Set the enviro │ │ │ │ │ +00034000: 6e6d 656e 7420 7661 7269 6162 6c65 2045 nment variable E │ │ │ │ │ +00034010: 4e56 5641 5220 746f 2056 414c 5545 2e20 NVVAR to VALUE. │ │ │ │ │ +00034020: 2049 6620 696e 766f 6b65 6420 7769 7468 If invoked with │ │ │ │ │ +00034030: 206e 6f0a 2020 2020 2061 7267 756d 656e no. argumen │ │ │ │ │ +00034040: 7473 2c20 7072 696e 7420 616c 6c20 656e ts, print all en │ │ │ │ │ +00034050: 7669 726f 6e6d 656e 7420 7661 7269 6162 vironment variab │ │ │ │ │ +00034060: 6c65 7320 7769 7468 2074 6865 6972 2076 les with their v │ │ │ │ │ +00034070: 616c 7565 732e 0a0a 1f0a 4669 6c65 3a20 alues.....File: │ │ │ │ │ +00034080: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ +00034090: 3a20 7368 6131 7375 6d2c 2020 4e65 7874 : sha1sum, Next │ │ │ │ │ +000340a0: 3a20 7368 6132 3536 7375 6d2c 2020 5072 : sha256sum, Pr │ │ │ │ │ +000340b0: 6576 3a20 7365 742c 2020 5570 3a20 436f ev: set, Up: Co │ │ │ │ │ +000340c0: 6d6d 616e 642d 6c69 6e65 2061 6e64 206d mmand-line and m │ │ │ │ │ +000340d0: 656e 7520 656e 7472 7920 636f 6d6d 616e enu entry comman │ │ │ │ │ +000340e0: 6473 0a0a 3136 2e33 2e36 3820 7368 6131 ds..16.3.68 sha1 │ │ │ │ │ +000340f0: 7375 6d0a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d sum.------------ │ │ │ │ │ +00034100: 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 ---.. -- Command │ │ │ │ │ +00034110: 3a20 7368 6131 7375 6d20 6172 6720 2e2e : sha1sum arg .. │ │ │ │ │ +00034120: 2e0a 2020 2020 2041 6c69 6173 2066 6f72 .. Alias for │ │ │ │ │ +00034130: 2027 6861 7368 7375 6d20 2d2d 6861 7368 'hashsum --hash │ │ │ │ │ +00034140: 2073 6861 3120 6172 6720 2e2e 2e27 2e20 sha1 arg ...'. │ │ │ │ │ +00034150: 2053 6565 2063 6f6d 6d61 6e64 2027 6861 See command 'ha │ │ │ │ │ +00034160: 7368 7375 6d27 0a20 2020 2020 282a 6e6f shsum'. (*no │ │ │ │ │ +00034170: 7465 2068 6173 6873 756d 3a3a 2920 666f te hashsum::) fo │ │ │ │ │ +00034180: 7220 6675 6c6c 2064 6573 6372 6970 7469 r full descripti │ │ │ │ │ +00034190: 6f6e 2e0a 0a1f 0a46 696c 653a 2067 7275 on.....File: gru │ │ │ │ │ +000341a0: 622e 696e 666f 2c20 204e 6f64 653a 2073 b.info, Node: s │ │ │ │ │ +000341b0: 6861 3235 3673 756d 2c20 204e 6578 743a ha256sum, Next: │ │ │ │ │ +000341c0: 2073 6861 3531 3273 756d 2c20 2050 7265 sha512sum, Pre │ │ │ │ │ +000341d0: 763a 2073 6861 3173 756d 2c20 2055 703a v: sha1sum, Up: │ │ │ │ │ +000341e0: 2043 6f6d 6d61 6e64 2d6c 696e 6520 616e Command-line an │ │ │ │ │ +000341f0: 6420 6d65 6e75 2065 6e74 7279 2063 6f6d d menu entry com │ │ │ │ │ +00034200: 6d61 6e64 730a 0a31 362e 332e 3639 2073 mands..16.3.69 s │ │ │ │ │ +00034210: 6861 3235 3673 756d 0a2d 2d2d 2d2d 2d2d ha256sum.------- │ │ │ │ │ +00034220: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 ----------.. -- │ │ │ │ │ +00034230: 436f 6d6d 616e 643a 2073 6861 3235 3673 Command: sha256s │ │ │ │ │ +00034240: 756d 2061 7267 202e 2e2e 0a20 2020 2020 um arg .... │ │ │ │ │ +00034250: 416c 6961 7320 666f 7220 2768 6173 6873 Alias for 'hashs │ │ │ │ │ +00034260: 756d 202d 2d68 6173 6820 7368 6132 3536 um --hash sha256 │ │ │ │ │ +00034270: 2061 7267 202e 2e2e 272e 2020 5365 6520 arg ...'. See │ │ │ │ │ +00034280: 636f 6d6d 616e 6420 2768 6173 6873 756d command 'hashsum │ │ │ │ │ +00034290: 270a 2020 2020 2028 2a6e 6f74 6520 6861 '. (*note ha │ │ │ │ │ +000342a0: 7368 7375 6d3a 3a29 2066 6f72 2066 756c shsum::) for ful │ │ │ │ │ +000342b0: 6c20 6465 7363 7269 7074 696f 6e2e 0a0a l description... │ │ │ │ │ +000342c0: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ +000342d0: 6f2c 2020 4e6f 6465 3a20 7368 6135 3132 o, Node: sha512 │ │ │ │ │ +000342e0: 7375 6d2c 2020 4e65 7874 3a20 736c 6565 sum, Next: slee │ │ │ │ │ +000342f0: 702c 2020 5072 6576 3a20 7368 6132 3536 p, Prev: sha256 │ │ │ │ │ +00034300: 7375 6d2c 2020 5570 3a20 436f 6d6d 616e sum, Up: Comman │ │ │ │ │ +00034310: 642d 6c69 6e65 2061 6e64 206d 656e 7520 d-line and menu │ │ │ │ │ +00034320: 656e 7472 7920 636f 6d6d 616e 6473 0a0a entry commands.. │ │ │ │ │ +00034330: 3136 2e33 2e37 3020 7368 6135 3132 7375 16.3.70 sha512su │ │ │ │ │ +00034340: 6d0a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d m.-------------- │ │ │ │ │ +00034350: 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 ---.. -- Command │ │ │ │ │ +00034360: 3a20 7368 6135 3132 7375 6d20 6172 6720 : sha512sum arg │ │ │ │ │ +00034370: 2e2e 2e0a 2020 2020 2041 6c69 6173 2066 .... Alias f │ │ │ │ │ +00034380: 6f72 2027 6861 7368 7375 6d20 2d2d 6861 or 'hashsum --ha │ │ │ │ │ +00034390: 7368 2073 6861 3531 3220 6172 6720 2e2e sh sha512 arg .. │ │ │ │ │ +000343a0: 2e27 2e20 2053 6565 2063 6f6d 6d61 6e64 .'. See command │ │ │ │ │ +000343b0: 2027 6861 7368 7375 6d27 0a20 2020 2020 'hashsum'. │ │ │ │ │ +000343c0: 282a 6e6f 7465 2068 6173 6873 756d 3a3a (*note hashsum:: │ │ │ │ │ +000343d0: 2920 666f 7220 6675 6c6c 2064 6573 6372 ) for full descr │ │ │ │ │ +000343e0: 6970 7469 6f6e 2e0a 0a1f 0a46 696c 653a iption.....File: │ │ │ │ │ +000343f0: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ +00034400: 653a 2073 6c65 6570 2c20 204e 6578 743a e: sleep, Next: │ │ │ │ │ +00034410: 2073 6d62 696f 732c 2020 5072 6576 3a20 smbios, Prev: │ │ │ │ │ +00034420: 7368 6135 3132 7375 6d2c 2020 5570 3a20 sha512sum, Up: │ │ │ │ │ +00034430: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ +00034440: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ │ +00034450: 616e 6473 0a0a 3136 2e33 2e37 3120 736c ands..16.3.71 sl │ │ │ │ │ +00034460: 6565 700a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d eep.------------ │ │ │ │ │ +00034470: 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 -.. -- Command: │ │ │ │ │ +00034480: 736c 6565 7020 5b2d 2d76 6572 626f 7365 sleep [--verbose │ │ │ │ │ +00034490: 5d20 5b2d 2d69 6e74 6572 7275 7074 6962 ] [--interruptib │ │ │ │ │ +000344a0: 6c65 5d20 636f 756e 740a 2020 2020 2053 le] count. S │ │ │ │ │ +000344b0: 6c65 6570 2066 6f72 2043 4f55 4e54 2073 leep for COUNT s │ │ │ │ │ +000344c0: 6563 6f6e 6473 2e20 2049 6620 6f70 7469 econds. If opti │ │ │ │ │ +000344d0: 6f6e 2027 2d2d 696e 7465 7272 7570 7469 on '--interrupti │ │ │ │ │ +000344e0: 626c 6527 2069 7320 6769 7665 6e2c 0a20 ble' is given,. │ │ │ │ │ +000344f0: 2020 2020 616c 6c6f 7720 7072 6573 7369 allow pressi │ │ │ │ │ +00034500: 6e67 203c 4553 433e 2c20 3c46 343e 206f ng , o │ │ │ │ │ +00034510: 7220 686f 6c64 696e 6720 646f 776e 203c r holding down < │ │ │ │ │ +00034520: 5348 4946 543e 2074 6f20 696e 7465 7272 SHIFT> to interr │ │ │ │ │ +00034530: 7570 740a 2020 2020 2073 6c65 6570 2e20 upt. sleep. │ │ │ │ │ +00034540: 2057 6974 6820 272d 2d76 6572 626f 7365 With '--verbose │ │ │ │ │ +00034550: 2720 7368 6f77 2063 6f75 6e74 646f 776e ' show countdown │ │ │ │ │ +00034560: 206f 6620 7265 6d61 696e 696e 6720 7365 of remaining se │ │ │ │ │ +00034570: 636f 6e64 732e 2020 4578 6974 0a20 2020 conds. Exit. │ │ │ │ │ +00034580: 2020 636f 6465 2069 7320 7365 7420 746f code is set to │ │ │ │ │ +00034590: 2030 2069 6620 7469 6d65 6f75 7420 6578 0 if timeout ex │ │ │ │ │ +000345a0: 7069 7265 6420 616e 6420 746f 2031 2069 pired and to 1 i │ │ │ │ │ +000345b0: 6620 7469 6d65 6f75 7420 7761 730a 2020 f timeout was. │ │ │ │ │ +000345c0: 2020 2069 6e74 6572 7275 7074 6564 2075 interrupted u │ │ │ │ │ +000345d0: 7369 6e67 2061 6e79 206f 6620 7468 6520 sing any of the │ │ │ │ │ +000345e0: 6d65 6e74 696f 6e65 6420 6b65 7973 2e0a mentioned keys.. │ │ │ │ │ +000345f0: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ +00034600: 666f 2c20 204e 6f64 653a 2073 6d62 696f fo, Node: smbio │ │ │ │ │ +00034610: 732c 2020 4e65 7874 3a20 736f 7572 6365 s, Next: source │ │ │ │ │ +00034620: 2c20 2050 7265 763a 2073 6c65 6570 2c20 , Prev: sleep, │ │ │ │ │ +00034630: 2055 703a 2043 6f6d 6d61 6e64 2d6c 696e Up: Command-lin │ │ │ │ │ +00034640: 6520 616e 6420 6d65 6e75 2065 6e74 7279 e and menu entry │ │ │ │ │ +00034650: 2063 6f6d 6d61 6e64 730a 0a31 362e 332e commands..16.3. │ │ │ │ │ +00034660: 3732 2073 6d62 696f 730a 2d2d 2d2d 2d2d 72 smbios.------ │ │ │ │ │ +00034670: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ │ +00034680: 6d6d 616e 643a 2073 6d62 696f 7320 5b2d mmand: smbios [- │ │ │ │ │ +00034690: 2d74 7970 6520 5459 5045 5d20 5b2d 2d68 -type TYPE] [--h │ │ │ │ │ +000346a0: 616e 646c 6520 4841 4e44 4c45 5d20 5b2d andle HANDLE] [- │ │ │ │ │ +000346b0: 2d6d 6174 6368 204d 4154 4348 5d0a 2020 -match MATCH]. │ │ │ │ │ +000346c0: 2020 2020 2020 2020 282d 2d67 6574 2d62 (--get-b │ │ │ │ │ +000346d0: 7974 6520 7c20 2d2d 6765 742d 776f 7264 yte | --get-word │ │ │ │ │ +000346e0: 207c 202d 2d67 6574 2d64 776f 7264 207c | --get-dword | │ │ │ │ │ +000346f0: 202d 2d67 6574 2d71 776f 7264 207c 0a20 --get-qword |. │ │ │ │ │ +00034700: 2020 2020 2020 2020 202d 2d67 6574 2d73 --get-s │ │ │ │ │ +00034710: 7472 696e 6720 7c20 2d2d 6765 742d 7575 tring | --get-uu │ │ │ │ │ +00034720: 6964 2920 4f46 4653 4554 205b 2d2d 7365 id) OFFSET [--se │ │ │ │ │ +00034730: 7420 5641 5249 4142 4c45 5d0a 2020 2020 t VARIABLE]. │ │ │ │ │ +00034740: 2052 6574 7269 6576 6520 534d 4249 4f53 Retrieve SMBIOS │ │ │ │ │ +00034750: 2069 6e66 6f72 6d61 7469 6f6e 2e0a 0a20 information... │ │ │ │ │ +00034760: 2020 2020 5468 6520 2773 6d62 696f 7327 The 'smbios' │ │ │ │ │ +00034770: 2063 6f6d 6d61 6e64 2072 6574 7572 6e73 command returns │ │ │ │ │ +00034780: 2074 6865 2076 616c 7565 206f 6620 6120 the value of a │ │ │ │ │ +00034790: 6669 656c 6420 696e 2061 6e20 534d 4249 field in an SMBI │ │ │ │ │ +000347a0: 4f53 0a20 2020 2020 7374 7275 6374 7572 OS. structur │ │ │ │ │ +000347b0: 652e 2020 5468 6520 666f 6c6c 6f77 696e e. The followin │ │ │ │ │ +000347c0: 6720 6f70 7469 6f6e 7320 6465 7465 726d g options determ │ │ │ │ │ +000347d0: 696e 6520 7768 6963 6820 7374 7275 6374 ine which struct │ │ │ │ │ +000347e0: 7572 6520 746f 0a20 2020 2020 7365 6c65 ure to. sele │ │ │ │ │ +000347f0: 6374 2e0a 0a20 2020 2020 2020 202a 2053 ct... * S │ │ │ │ │ +00034800: 7065 6369 6679 696e 6720 272d 2d74 7970 pecifying '--typ │ │ │ │ │ +00034810: 6527 2077 696c 6c20 7365 6c65 6374 2073 e' will select s │ │ │ │ │ +00034820: 7472 7563 7475 7265 7320 7769 7468 2061 tructures with a │ │ │ │ │ +00034830: 206d 6174 6368 696e 670a 2020 2020 2020 matching. │ │ │ │ │ +00034840: 2020 2020 5459 5045 2e20 2054 6865 2074 TYPE. The t │ │ │ │ │ +00034850: 7970 6520 6361 6e20 6265 2061 6e79 2069 ype can be any i │ │ │ │ │ +00034860: 6e74 6567 6572 2066 726f 6d20 3020 746f nteger from 0 to │ │ │ │ │ +00034870: 2032 3535 2e0a 2020 2020 2020 2020 2a20 255.. * │ │ │ │ │ +00034880: 5370 6563 6966 7969 6e67 2027 2d2d 6861 Specifying '--ha │ │ │ │ │ +00034890: 6e64 6c65 2720 7769 6c6c 2073 656c 6563 ndle' will selec │ │ │ │ │ +000348a0: 7420 7374 7275 6374 7572 6573 2077 6974 t structures wit │ │ │ │ │ +000348b0: 6820 6120 6d61 7463 6869 6e67 0a20 2020 h a matching. │ │ │ │ │ +000348c0: 2020 2020 2020 2048 414e 444c 452e 2020 HANDLE. │ │ │ │ │ +000348d0: 5468 6520 6861 6e64 6c65 2063 616e 2062 The handle can b │ │ │ │ │ +000348e0: 6520 616e 7920 696e 7465 6765 7220 6672 e any integer fr │ │ │ │ │ +000348f0: 6f6d 2030 2074 6f20 3635 3533 352e 0a20 om 0 to 65535.. │ │ │ │ │ +00034900: 2020 2020 2020 202a 2053 7065 6369 6679 * Specify │ │ │ │ │ +00034910: 696e 6720 272d 2d6d 6174 6368 2720 7769 ing '--match' wi │ │ │ │ │ +00034920: 6c6c 2073 656c 6563 7420 7374 7275 6374 ll select struct │ │ │ │ │ +00034930: 7572 6520 6e75 6d62 6572 204d 4154 4348 ure number MATCH │ │ │ │ │ +00034940: 2069 6e20 7468 650a 2020 2020 2020 2020 in the. │ │ │ │ │ +00034950: 2020 6669 6c74 6572 6564 206c 6973 7420 filtered list │ │ │ │ │ +00034960: 6f66 2073 7472 7563 7475 7265 733b 2065 of structures; e │ │ │ │ │ +00034970: 2e67 2e20 2027 736d 6269 6f73 202d 2d74 .g. 'smbios --t │ │ │ │ │ +00034980: 7970 6520 3420 2d2d 6d61 7463 6820 3227 ype 4 --match 2' │ │ │ │ │ +00034990: 0a20 2020 2020 2020 2020 2077 696c 6c20 . will │ │ │ │ │ +000349a0: 7365 6c65 6374 2074 6865 2073 6563 6f6e select the secon │ │ │ │ │ +000349b0: 6420 5072 6f63 6573 7320 496e 666f 726d d Process Inform │ │ │ │ │ +000349c0: 6174 696f 6e20 2854 7970 6520 3429 2073 ation (Type 4) s │ │ │ │ │ +000349d0: 7472 7563 7475 7265 2e0a 2020 2020 2020 tructure.. │ │ │ │ │ +000349e0: 2020 2020 5468 6520 6c69 7374 2069 7320 The list is │ │ │ │ │ +000349f0: 616c 7761 7973 206f 7264 6572 6564 2074 always ordered t │ │ │ │ │ +00034a00: 6865 2073 616d 6520 6173 2074 6865 2068 he same as the h │ │ │ │ │ +00034a10: 6172 6477 6172 6527 7320 534d 4249 4f53 ardware's SMBIOS │ │ │ │ │ +00034a20: 0a20 2020 2020 2020 2020 2074 6162 6c65 . table │ │ │ │ │ +00034a30: 2e20 2054 6865 206d 6174 6368 206e 756d . The match num │ │ │ │ │ +00034a40: 6265 7220 6d75 7374 2062 6520 6120 706f ber must be a po │ │ │ │ │ +00034a50: 7369 7469 7665 2069 6e74 6567 6572 2e20 sitive integer. │ │ │ │ │ +00034a60: 2049 660a 2020 2020 2020 2020 2020 756e If. un │ │ │ │ │ +00034a70: 7370 6563 6966 6965 642c 2074 6865 2066 specified, the f │ │ │ │ │ +00034a80: 6972 7374 206d 6174 6368 696e 6720 7374 irst matching st │ │ │ │ │ +00034a90: 7275 6374 7572 6520 7769 6c6c 2062 6520 ructure will be │ │ │ │ │ +00034aa0: 7365 6c65 6374 6564 2e0a 0a20 2020 2020 selected... │ │ │ │ │ +00034ab0: 5468 6520 7265 6d61 696e 696e 6720 6f70 The remaining op │ │ │ │ │ +00034ac0: 7469 6f6e 7320 6465 7465 726d 696e 6520 tions determine │ │ │ │ │ +00034ad0: 7768 6963 6820 6669 656c 6420 696e 2074 which field in t │ │ │ │ │ +00034ae0: 6865 2073 656c 6563 7465 6420 534d 4249 he selected SMBI │ │ │ │ │ +00034af0: 4f53 0a20 2020 2020 7374 7275 6374 7572 OS. structur │ │ │ │ │ +00034b00: 6520 746f 2072 6574 7572 6e2e 2020 4f6e e to return. On │ │ │ │ │ +00034b10: 6c79 206f 6e65 206f 6620 7468 6573 6520 ly one of these │ │ │ │ │ +00034b20: 6f70 7469 6f6e 7320 6d61 7920 6265 2073 options may be s │ │ │ │ │ +00034b30: 7065 6369 6669 6564 2061 740a 2020 2020 pecified at. │ │ │ │ │ +00034b40: 2061 2074 696d 652e 0a0a 2020 2020 2020 a time... │ │ │ │ │ +00034b50: 2020 2a20 5768 656e 2067 6976 656e 2027 * When given ' │ │ │ │ │ +00034b60: 2d2d 6765 742d 6279 7465 272c 2072 6574 --get-byte', ret │ │ │ │ │ +00034b70: 7572 6e20 7468 6520 7661 6c75 6520 6f66 urn the value of │ │ │ │ │ +00034b80: 2074 6865 2062 7974 6520 6174 0a20 2020 the byte at. │ │ │ │ │ +00034b90: 2020 2020 2020 204f 4646 5345 5420 6279 OFFSET by │ │ │ │ │ +00034ba0: 7465 7320 696e 746f 2074 6865 2073 656c tes into the sel │ │ │ │ │ +00034bb0: 6563 7465 6420 534d 4249 4f53 2073 7472 ected SMBIOS str │ │ │ │ │ +00034bc0: 7563 7475 7265 2e20 2049 7420 7769 6c6c ucture. It will │ │ │ │ │ +00034bd0: 2062 650a 2020 2020 2020 2020 2020 666f be. fo │ │ │ │ │ +00034be0: 726d 6174 7465 6420 6173 2061 6e20 756e rmatted as an un │ │ │ │ │ +00034bf0: 7369 676e 6564 2064 6563 696d 616c 2069 signed decimal i │ │ │ │ │ +00034c00: 6e74 6567 6572 2e0a 2020 2020 2020 2020 nteger.. │ │ │ │ │ +00034c10: 2a20 5768 656e 2067 6976 656e 2027 2d2d * When given '-- │ │ │ │ │ +00034c20: 6765 742d 776f 7264 272c 2072 6574 7572 get-word', retur │ │ │ │ │ +00034c30: 6e20 7468 6520 7661 6c75 6520 6f66 2074 n the value of t │ │ │ │ │ +00034c40: 6865 2077 6f72 6420 2874 776f 0a20 2020 he word (two. │ │ │ │ │ +00034c50: 2020 2020 2020 2062 7974 6573 2920 6174 bytes) at │ │ │ │ │ +00034c60: 204f 4646 5345 5420 6279 7465 7320 696e OFFSET bytes in │ │ │ │ │ +00034c70: 746f 2074 6865 2073 656c 6563 7465 6420 to the selected │ │ │ │ │ +00034c80: 534d 4249 4f53 2073 7472 7563 7475 7265 SMBIOS structure │ │ │ │ │ +00034c90: 2e20 2049 740a 2020 2020 2020 2020 2020 . It. │ │ │ │ │ +00034ca0: 7769 6c6c 2062 6520 666f 726d 6174 7465 will be formatte │ │ │ │ │ +00034cb0: 6420 6173 2061 6e20 756e 7369 676e 6564 d as an unsigned │ │ │ │ │ +00034cc0: 2064 6563 696d 616c 2069 6e74 6567 6572 decimal integer │ │ │ │ │ +00034cd0: 2e0a 2020 2020 2020 2020 2a20 5768 656e .. * When │ │ │ │ │ +00034ce0: 2067 6976 656e 2027 2d2d 6765 742d 6477 given '--get-dw │ │ │ │ │ +00034cf0: 6f72 6427 2c20 7265 7475 726e 2074 6865 ord', return the │ │ │ │ │ +00034d00: 2076 616c 7565 206f 6620 7468 6520 6477 value of the dw │ │ │ │ │ +00034d10: 6f72 6420 2866 6f75 720a 2020 2020 2020 ord (four. │ │ │ │ │ +00034d20: 2020 2020 6279 7465 7329 2061 7420 4f46 bytes) at OF │ │ │ │ │ +00034d30: 4653 4554 2062 7974 6573 2069 6e74 6f20 FSET bytes into │ │ │ │ │ +00034d40: 7468 6520 7365 6c65 6374 6564 2053 4d42 the selected SMB │ │ │ │ │ +00034d50: 494f 5320 7374 7275 6374 7572 652e 2020 IOS structure. │ │ │ │ │ +00034d60: 4974 0a20 2020 2020 2020 2020 2077 696c It. wil │ │ │ │ │ +00034d70: 6c20 6265 2066 6f72 6d61 7474 6564 2061 l be formatted a │ │ │ │ │ +00034d80: 7320 616e 2075 6e73 6967 6e65 6420 6465 s an unsigned de │ │ │ │ │ +00034d90: 6369 6d61 6c20 696e 7465 6765 722e 0a20 cimal integer.. │ │ │ │ │ +00034da0: 2020 2020 2020 202a 2057 6865 6e20 6769 * When gi │ │ │ │ │ +00034db0: 7665 6e20 272d 2d67 6574 2d71 776f 7264 ven '--get-qword │ │ │ │ │ +00034dc0: 272c 2072 6574 7572 6e20 7468 6520 7661 ', return the va │ │ │ │ │ +00034dd0: 6c75 6520 6f66 2074 6865 2071 776f 7264 lue of the qword │ │ │ │ │ +00034de0: 2028 6569 6768 740a 2020 2020 2020 2020 (eight. │ │ │ │ │ +00034df0: 2020 6279 7465 7329 2061 7420 4f46 4653 bytes) at OFFS │ │ │ │ │ +00034e00: 4554 2062 7974 6573 2069 6e74 6f20 7468 ET bytes into th │ │ │ │ │ +00034e10: 6520 7365 6c65 6374 6564 2053 4d42 494f e selected SMBIO │ │ │ │ │ +00034e20: 5320 7374 7275 6374 7572 652e 2020 4974 S structure. It │ │ │ │ │ +00034e30: 0a20 2020 2020 2020 2020 2077 696c 6c20 . will │ │ │ │ │ +00034e40: 6265 2066 6f72 6d61 7474 6564 2061 7320 be formatted as │ │ │ │ │ +00034e50: 616e 2075 6e73 6967 6e65 6420 6465 6369 an unsigned deci │ │ │ │ │ +00034e60: 6d61 6c20 696e 7465 6765 722e 0a20 2020 mal integer.. │ │ │ │ │ +00034e70: 2020 2020 202a 2057 6865 6e20 6769 7665 * When give │ │ │ │ │ +00034e80: 6e20 272d 2d67 6574 2d73 7472 696e 6727 n '--get-string' │ │ │ │ │ +00034e90: 2c20 7265 7475 726e 2074 6865 2073 7472 , return the str │ │ │ │ │ +00034ea0: 696e 6720 7769 7468 2069 7473 2069 6e64 ing with its ind │ │ │ │ │ +00034eb0: 6578 0a20 2020 2020 2020 2020 2066 6f75 ex. fou │ │ │ │ │ +00034ec0: 6e64 2061 7420 4f46 4653 4554 2062 7974 nd at OFFSET byt │ │ │ │ │ +00034ed0: 6573 2069 6e74 6f20 7468 6520 7365 6c65 es into the sele │ │ │ │ │ +00034ee0: 6374 6564 2053 4d42 494f 5320 7374 7275 cted SMBIOS stru │ │ │ │ │ +00034ef0: 6374 7572 652e 0a20 2020 2020 2020 202a cture.. * │ │ │ │ │ +00034f00: 2057 6865 6e20 6769 7665 6e20 272d 2d67 When given '--g │ │ │ │ │ +00034f10: 6574 2d75 7569 6427 2c20 7265 7475 726e et-uuid', return │ │ │ │ │ +00034f20: 2074 6865 2076 616c 7565 206f 6620 7468 the value of th │ │ │ │ │ +00034f30: 6520 5555 4944 2028 7369 7874 6565 6e0a e UUID (sixteen. │ │ │ │ │ +00034f40: 2020 2020 2020 2020 2020 6279 7465 7329 bytes) │ │ │ │ │ +00034f50: 2061 7420 4f46 4653 4554 2062 7974 6573 at OFFSET bytes │ │ │ │ │ +00034f60: 2069 6e74 6f20 7468 6520 7365 6c65 6374 into the select │ │ │ │ │ +00034f70: 6564 2053 4d42 494f 5320 7374 7275 6374 ed SMBIOS struct │ │ │ │ │ +00034f80: 7572 652e 2020 4974 0a20 2020 2020 2020 ure. It. │ │ │ │ │ +00034f90: 2020 2077 696c 6c20 6265 2066 6f72 6d61 will be forma │ │ │ │ │ +00034fa0: 7474 6564 2061 7320 6c6f 7765 722d 6361 tted as lower-ca │ │ │ │ │ +00034fb0: 7365 2068 7970 6865 6e61 7465 6420 6865 se hyphenated he │ │ │ │ │ +00034fc0: 7861 6465 6369 6d61 6c20 6469 6769 7473 xadecimal digits │ │ │ │ │ +00034fd0: 2c0a 2020 2020 2020 2020 2020 7769 7468 ,. with │ │ │ │ │ +00034fe0: 2074 6865 2066 6972 7374 2074 6872 6565 the first three │ │ │ │ │ +00034ff0: 2066 6965 6c64 7320 6173 206c 6974 746c fields as littl │ │ │ │ │ +00035000: 652d 656e 6469 616e 2c20 616e 6420 7468 e-endian, and th │ │ │ │ │ +00035010: 6520 7265 7374 0a20 2020 2020 2020 2020 e rest. │ │ │ │ │ +00035020: 2070 7269 6e74 6564 2062 7974 652d 6279 printed byte-by │ │ │ │ │ +00035030: 2d62 7974 652e 0a0a 2020 2020 2054 6865 -byte... The │ │ │ │ │ +00035040: 2064 6566 6175 6c74 2061 6374 696f 6e20 default action │ │ │ │ │ +00035050: 6973 2074 6f20 7072 696e 7420 7468 6520 is to print the │ │ │ │ │ +00035060: 7661 6c75 6520 6f66 2074 6865 2072 6571 value of the req │ │ │ │ │ +00035070: 7565 7374 6564 2066 6965 6c64 2074 6f0a uested field to. │ │ │ │ │ +00035080: 2020 2020 2074 6865 2063 6f6e 736f 6c65 the console │ │ │ │ │ +00035090: 2c20 6275 7420 6120 7661 7269 6162 6c65 , but a variable │ │ │ │ │ +000350a0: 206e 616d 6520 6361 6e20 6265 2073 7065 name can be spe │ │ │ │ │ +000350b0: 6369 6669 6564 2077 6974 6820 272d 2d73 cified with '--s │ │ │ │ │ +000350c0: 6574 2720 746f 0a20 2020 2020 7374 6f72 et' to. stor │ │ │ │ │ +000350d0: 6520 7468 6520 7661 6c75 6520 696e 7374 e the value inst │ │ │ │ │ +000350e0: 6561 6420 6f66 2070 7269 6e74 696e 6720 ead of printing │ │ │ │ │ +000350f0: 6974 2e0a 0a20 2020 2020 466f 7220 6578 it... For ex │ │ │ │ │ +00035100: 616d 706c 652c 2074 6869 7320 7769 6c6c ample, this will │ │ │ │ │ +00035110: 2073 746f 7265 2061 6e64 2074 6865 6e20 store and then │ │ │ │ │ +00035120: 6469 7370 6c61 7920 7468 6520 7379 7374 display the syst │ │ │ │ │ +00035130: 656d 0a20 2020 2020 6d61 6e75 6661 6374 em. manufact │ │ │ │ │ +00035140: 7572 6572 2773 206e 616d 652e 0a0a 2020 urer's name... │ │ │ │ │ +00035150: 2020 2020 2020 2020 736d 6269 6f73 202d smbios - │ │ │ │ │ +00035160: 2d74 7970 6520 3120 2d2d 6765 742d 7374 -type 1 --get-st │ │ │ │ │ +00035170: 7269 6e67 2034 202d 2d73 6574 2073 7973 ring 4 --set sys │ │ │ │ │ +00035180: 7465 6d5f 6d61 6e75 6661 6374 7572 6572 tem_manufacturer │ │ │ │ │ +00035190: 0a20 2020 2020 2020 2020 2065 6368 6f20 . echo │ │ │ │ │ +000351a0: 2473 7973 7465 6d5f 6d61 6e75 6661 6374 $system_manufact │ │ │ │ │ +000351b0: 7572 6572 0a0a 1f0a 4669 6c65 3a20 6772 urer....File: gr │ │ │ │ │ +000351c0: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ +000351d0: 736f 7572 6365 2c20 204e 6578 743a 2074 source, Next: t │ │ │ │ │ +000351e0: 6573 742c 2020 5072 6576 3a20 736d 6269 est, Prev: smbi │ │ │ │ │ +000351f0: 6f73 2c20 2055 703a 2043 6f6d 6d61 6e64 os, Up: Command │ │ │ │ │ +00035200: 2d6c 696e 6520 616e 6420 6d65 6e75 2065 -line and menu e │ │ │ │ │ +00035210: 6e74 7279 2063 6f6d 6d61 6e64 730a 0a31 ntry commands..1 │ │ │ │ │ +00035220: 362e 332e 3733 2073 6f75 7263 650a 2d2d 6.3.73 source.-- │ │ │ │ │ +00035230: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d ------------.. - │ │ │ │ │ +00035240: 2d20 436f 6d6d 616e 643a 2073 6f75 7263 - Command: sourc │ │ │ │ │ +00035250: 6520 6669 6c65 0a20 2020 2020 5265 6164 e file. Read │ │ │ │ │ +00035260: 2046 494c 4520 6173 2061 2063 6f6e 6669 FILE as a confi │ │ │ │ │ +00035270: 6775 7261 7469 6f6e 2066 696c 652c 2061 guration file, a │ │ │ │ │ +00035280: 7320 6966 2069 7473 2063 6f6e 7465 6e74 s if its content │ │ │ │ │ +00035290: 7320 6861 6420 6265 656e 0a20 2020 2020 s had been. │ │ │ │ │ +000352a0: 696e 636f 7270 6f72 6174 6564 2064 6972 incorporated dir │ │ │ │ │ +000352b0: 6563 746c 7920 696e 746f 2074 6865 2073 ectly into the s │ │ │ │ │ +000352c0: 6f75 7263 696e 6720 6669 6c65 2e20 2055 ourcing file. U │ │ │ │ │ +000352d0: 6e6c 696b 6520 2763 6f6e 6669 6766 696c nlike 'configfil │ │ │ │ │ +000352e0: 6527 0a20 2020 2020 282a 6e6f 7465 2063 e'. (*note c │ │ │ │ │ +000352f0: 6f6e 6669 6766 696c 653a 3a29 2c20 7468 onfigfile::), th │ │ │ │ │ +00035300: 6973 2065 7865 6375 7465 7320 7468 6520 is executes the │ │ │ │ │ +00035310: 636f 6e74 656e 7473 206f 6620 4649 4c45 contents of FILE │ │ │ │ │ +00035320: 2077 6974 686f 7574 0a20 2020 2020 6368 without. ch │ │ │ │ │ +00035330: 616e 6769 6e67 2063 6f6e 7465 7874 3a20 anging context: │ │ │ │ │ +00035340: 616e 7920 656e 7669 726f 6e6d 656e 7420 any environment │ │ │ │ │ +00035350: 7661 7269 6162 6c65 2063 6861 6e67 6573 variable changes │ │ │ │ │ +00035360: 206d 6164 6520 6279 2074 6865 0a20 2020 made by the. │ │ │ │ │ +00035370: 2020 636f 6d6d 616e 6473 2069 6e20 4649 commands in FI │ │ │ │ │ +00035380: 4c45 2077 696c 6c20 6265 2070 7265 7365 LE will be prese │ │ │ │ │ +00035390: 7276 6564 2061 6674 6572 2027 736f 7572 rved after 'sour │ │ │ │ │ +000353a0: 6365 2720 7265 7475 726e 732c 2061 6e64 ce' returns, and │ │ │ │ │ +000353b0: 2074 6865 0a20 2020 2020 6d65 6e75 2077 the. menu w │ │ │ │ │ +000353c0: 696c 6c20 6e6f 7420 6265 2073 686f 776e ill not be shown │ │ │ │ │ +000353d0: 2069 6d6d 6564 6961 7465 6c79 2e0a 0a1f immediately.... │ │ │ │ │ +000353e0: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ +000353f0: 2c20 204e 6f64 653a 2074 6573 742c 2020 , Node: test, │ │ │ │ │ +00035400: 4e65 7874 3a20 7472 7565 2c20 2050 7265 Next: true, Pre │ │ │ │ │ +00035410: 763a 2073 6f75 7263 652c 2020 5570 3a20 v: source, Up: │ │ │ │ │ +00035420: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ +00035430: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ │ +00035440: 616e 6473 0a0a 3136 2e33 2e37 3420 7465 ands..16.3.74 te │ │ │ │ │ +00035450: 7374 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a st.------------. │ │ │ │ │ +00035460: 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 7465 . -- Command: te │ │ │ │ │ +00035470: 7374 2065 7870 7265 7373 696f 6e0a 2020 st expression. │ │ │ │ │ +00035480: 2020 2045 7661 6c75 6174 6520 4558 5052 Evaluate EXPR │ │ │ │ │ +00035490: 4553 5349 4f4e 2061 6e64 2072 6574 7572 ESSION and retur │ │ │ │ │ +000354a0: 6e20 7a65 726f 2065 7869 7420 7374 6174 n zero exit stat │ │ │ │ │ +000354b0: 7573 2069 6620 7265 7375 6c74 2069 7320 us if result is │ │ │ │ │ +000354c0: 7472 7565 2c0a 2020 2020 206e 6f6e 207a true,. non z │ │ │ │ │ +000354d0: 6572 6f20 7374 6174 7573 206f 7468 6572 ero status other │ │ │ │ │ +000354e0: 7769 7365 2e0a 0a20 2020 2020 4558 5052 wise... EXPR │ │ │ │ │ +000354f0: 4553 5349 4f4e 2069 7320 6f6e 6520 6f66 ESSION is one of │ │ │ │ │ +00035500: 3a0a 0a20 2020 2020 5354 5249 4e47 3120 :.. STRING1 │ │ │ │ │ +00035510: 273d 3d27 2053 5452 494e 4732 0a20 2020 '==' STRING2. │ │ │ │ │ +00035520: 2020 2020 2020 2074 6865 2073 7472 696e the strin │ │ │ │ │ +00035530: 6773 2061 7265 2065 7175 616c 0a20 2020 gs are equal. │ │ │ │ │ +00035540: 2020 5354 5249 4e47 3120 2721 3d27 2053 STRING1 '!=' S │ │ │ │ │ +00035550: 5452 494e 4732 0a20 2020 2020 2020 2020 TRING2. │ │ │ │ │ +00035560: 2074 6865 2073 7472 696e 6773 2061 7265 the strings are │ │ │ │ │ +00035570: 206e 6f74 2065 7175 616c 0a20 2020 2020 not equal. │ │ │ │ │ +00035580: 5354 5249 4e47 3120 273c 2720 5354 5249 STRING1 '<' STRI │ │ │ │ │ +00035590: 4e47 320a 2020 2020 2020 2020 2020 5354 NG2. ST │ │ │ │ │ +000355a0: 5249 4e47 3120 6973 206c 6578 6963 6f67 RING1 is lexicog │ │ │ │ │ +000355b0: 7261 7068 6963 616c 6c79 206c 6573 7320 raphically less │ │ │ │ │ +000355c0: 7468 616e 2053 5452 494e 4732 0a20 2020 than STRING2. │ │ │ │ │ +000355d0: 2020 5354 5249 4e47 3120 273c 3d27 2053 STRING1 '<=' S │ │ │ │ │ +000355e0: 5452 494e 4732 0a20 2020 2020 2020 2020 TRING2. │ │ │ │ │ +000355f0: 2053 5452 494e 4731 2069 7320 6c65 7869 STRING1 is lexi │ │ │ │ │ +00035600: 636f 6772 6170 6869 6361 6c6c 7920 6c65 cographically le │ │ │ │ │ +00035610: 7373 206f 7220 6571 7561 6c20 7468 616e ss or equal than │ │ │ │ │ +00035620: 2053 5452 494e 4732 0a20 2020 2020 5354 STRING2. ST │ │ │ │ │ +00035630: 5249 4e47 3120 273e 2720 5354 5249 4e47 RING1 '>' STRING │ │ │ │ │ +00035640: 320a 2020 2020 2020 2020 2020 5354 5249 2. STRI │ │ │ │ │ +00035650: 4e47 3120 6973 206c 6578 6963 6f67 7261 NG1 is lexicogra │ │ │ │ │ +00035660: 7068 6963 616c 6c79 2067 7265 6174 6572 phically greater │ │ │ │ │ +00035670: 2074 6861 6e20 5354 5249 4e47 320a 2020 than STRING2. │ │ │ │ │ +00035680: 2020 2053 5452 494e 4731 2027 3e3d 2720 STRING1 '>=' │ │ │ │ │ +00035690: 5354 5249 4e47 320a 2020 2020 2020 2020 STRING2. │ │ │ │ │ +000356a0: 2020 5354 5249 4e47 3120 6973 206c 6578 STRING1 is lex │ │ │ │ │ +000356b0: 6963 6f67 7261 7068 6963 616c 6c79 2067 icographically g │ │ │ │ │ +000356c0: 7265 6174 6572 206f 7220 6571 7561 6c20 reater or equal │ │ │ │ │ +000356d0: 7468 616e 2053 5452 494e 4732 0a20 2020 than STRING2. │ │ │ │ │ +000356e0: 2020 494e 5445 4745 5231 2027 2d65 7127 INTEGER1 '-eq' │ │ │ │ │ +000356f0: 2049 4e54 4547 4552 320a 2020 2020 2020 INTEGER2. │ │ │ │ │ +00035700: 2020 2020 494e 5445 4745 5231 2069 7320 INTEGER1 is │ │ │ │ │ +00035710: 6571 7561 6c20 746f 2049 4e54 4547 4552 equal to INTEGER │ │ │ │ │ +00035720: 320a 2020 2020 2049 4e54 4547 4552 3120 2. INTEGER1 │ │ │ │ │ +00035730: 272d 6765 2720 494e 5445 4745 5232 0a20 '-ge' INTEGER2. │ │ │ │ │ +00035740: 2020 2020 2020 2020 2049 4e54 4547 4552 INTEGER │ │ │ │ │ +00035750: 3120 6973 2067 7265 6174 6572 2074 6861 1 is greater tha │ │ │ │ │ +00035760: 6e20 6f72 2065 7175 616c 2074 6f20 494e n or equal to IN │ │ │ │ │ +00035770: 5445 4745 5232 0a20 2020 2020 494e 5445 TEGER2. INTE │ │ │ │ │ +00035780: 4745 5231 2027 2d67 7427 2049 4e54 4547 GER1 '-gt' INTEG │ │ │ │ │ +00035790: 4552 320a 2020 2020 2020 2020 2020 494e ER2. IN │ │ │ │ │ +000357a0: 5445 4745 5231 2069 7320 6772 6561 7465 TEGER1 is greate │ │ │ │ │ +000357b0: 7220 7468 616e 2049 4e54 4547 4552 320a r than INTEGER2. │ │ │ │ │ +000357c0: 2020 2020 2049 4e54 4547 4552 3120 272d INTEGER1 '- │ │ │ │ │ +000357d0: 6c65 2720 494e 5445 4745 5232 0a20 2020 le' INTEGER2. │ │ │ │ │ +000357e0: 2020 2020 2020 2049 4e54 4547 4552 3120 INTEGER1 │ │ │ │ │ +000357f0: 6973 206c 6573 7320 7468 616e 206f 7220 is less than or │ │ │ │ │ +00035800: 6571 7561 6c20 746f 2049 4e54 4547 4552 equal to INTEGER │ │ │ │ │ +00035810: 320a 2020 2020 2049 4e54 4547 4552 3120 2. INTEGER1 │ │ │ │ │ +00035820: 272d 6c74 2720 494e 5445 4745 5232 0a20 '-lt' INTEGER2. │ │ │ │ │ +00035830: 2020 2020 2020 2020 2049 4e54 4547 4552 INTEGER │ │ │ │ │ +00035840: 3120 6973 206c 6573 7320 7468 616e 2049 1 is less than I │ │ │ │ │ +00035850: 4e54 4547 4552 320a 2020 2020 2049 4e54 NTEGER2. INT │ │ │ │ │ +00035860: 4547 4552 3120 272d 6e65 2720 494e 5445 EGER1 '-ne' INTE │ │ │ │ │ +00035870: 4745 5232 0a20 2020 2020 2020 2020 2049 GER2. I │ │ │ │ │ +00035880: 4e54 4547 4552 3120 6973 206e 6f74 2065 NTEGER1 is not e │ │ │ │ │ +00035890: 7175 616c 2074 6f20 494e 5445 4745 5232 qual to INTEGER2 │ │ │ │ │ +000358a0: 0a20 2020 2020 5052 4546 4958 494e 5445 . PREFIXINTE │ │ │ │ │ +000358b0: 4745 5231 2027 2d70 6774 2720 5052 4546 GER1 '-pgt' PREF │ │ │ │ │ +000358c0: 4958 494e 5445 4745 5232 0a20 2020 2020 IXINTEGER2. │ │ │ │ │ +000358d0: 2020 2020 2049 4e54 4547 4552 3120 6973 INTEGER1 is │ │ │ │ │ +000358e0: 2067 7265 6174 6572 2074 6861 6e20 494e greater than IN │ │ │ │ │ +000358f0: 5445 4745 5232 2061 6674 6572 2073 7472 TEGER2 after str │ │ │ │ │ +00035900: 6970 7069 6e67 206f 6666 2063 6f6d 6d6f ipping off commo │ │ │ │ │ +00035910: 6e0a 2020 2020 2020 2020 2020 6e6f 6e2d n. non- │ │ │ │ │ +00035920: 6e75 6d65 7269 6320 5052 4546 4958 2e0a numeric PREFIX.. │ │ │ │ │ +00035930: 2020 2020 2050 5245 4649 5849 4e54 4547 PREFIXINTEG │ │ │ │ │ +00035940: 4552 3120 272d 706c 7427 2050 5245 4649 ER1 '-plt' PREFI │ │ │ │ │ +00035950: 5849 4e54 4547 4552 320a 2020 2020 2020 XINTEGER2. │ │ │ │ │ +00035960: 2020 2020 494e 5445 4745 5231 2069 7320 INTEGER1 is │ │ │ │ │ +00035970: 6c65 7373 2074 6861 6e20 494e 5445 4745 less than INTEGE │ │ │ │ │ +00035980: 5232 2061 6674 6572 2073 7472 6970 7069 R2 after strippi │ │ │ │ │ +00035990: 6e67 206f 6666 2063 6f6d 6d6f 6e0a 2020 ng off common. │ │ │ │ │ +000359a0: 2020 2020 2020 2020 6e6f 6e2d 6e75 6d65 non-nume │ │ │ │ │ +000359b0: 7269 6320 5052 4546 4958 2e0a 2020 2020 ric PREFIX.. │ │ │ │ │ +000359c0: 2046 494c 4531 2027 2d6e 7427 2046 494c FILE1 '-nt' FIL │ │ │ │ │ +000359d0: 4532 0a20 2020 2020 2020 2020 2046 494c E2. FIL │ │ │ │ │ +000359e0: 4531 2069 7320 6e65 7765 7220 7468 616e E1 is newer than │ │ │ │ │ +000359f0: 2046 494c 4532 2028 6d6f 6469 6669 6361 FILE2 (modifica │ │ │ │ │ +00035a00: 7469 6f6e 2074 696d 6529 2e20 204f 7074 tion time). Opt │ │ │ │ │ +00035a10: 696f 6e61 6c6c 790a 2020 2020 2020 2020 ionally. │ │ │ │ │ +00035a20: 2020 6e75 6d65 7269 6320 4249 4153 206d numeric BIAS m │ │ │ │ │ +00035a30: 6179 2062 6520 6469 7265 6374 6c79 2061 ay be directly a │ │ │ │ │ +00035a40: 7070 656e 6465 6420 746f 2027 2d6e 7427 ppended to '-nt' │ │ │ │ │ +00035a50: 2069 6e20 7768 6963 6820 6361 7365 0a20 in which case. │ │ │ │ │ +00035a60: 2020 2020 2020 2020 2069 7420 6973 2061 it is a │ │ │ │ │ +00035a70: 6464 6564 2074 6f20 7468 6520 6669 7273 dded to the firs │ │ │ │ │ +00035a80: 7420 6669 6c65 206d 6f64 6966 6963 6174 t file modificat │ │ │ │ │ +00035a90: 696f 6e20 7469 6d65 2e0a 2020 2020 2046 ion time.. F │ │ │ │ │ +00035aa0: 494c 4531 2027 2d6f 7427 2046 494c 4532 ILE1 '-ot' FILE2 │ │ │ │ │ +00035ab0: 0a20 2020 2020 2020 2020 2046 494c 4531 . FILE1 │ │ │ │ │ +00035ac0: 2069 7320 6f6c 6465 7220 7468 616e 2046 is older than F │ │ │ │ │ +00035ad0: 494c 4532 2028 6d6f 6469 6669 6361 7469 ILE2 (modificati │ │ │ │ │ +00035ae0: 6f6e 2074 696d 6529 2e20 204f 7074 696f on time). Optio │ │ │ │ │ +00035af0: 6e61 6c6c 790a 2020 2020 2020 2020 2020 nally. │ │ │ │ │ +00035b00: 6e75 6d65 7269 6320 4249 4153 206d 6179 numeric BIAS may │ │ │ │ │ +00035b10: 2062 6520 6469 7265 6374 6c79 2061 7070 be directly app │ │ │ │ │ +00035b20: 656e 6465 6420 746f 2027 2d6f 7427 2069 ended to '-ot' i │ │ │ │ │ +00035b30: 6e20 7768 6963 6820 6361 7365 0a20 2020 n which case. │ │ │ │ │ +00035b40: 2020 2020 2020 2069 7420 6973 2061 6464 it is add │ │ │ │ │ +00035b50: 6564 2074 6f20 7468 6520 6669 7273 7420 ed to the first │ │ │ │ │ +00035b60: 6669 6c65 206d 6f64 6966 6963 6174 696f file modificatio │ │ │ │ │ +00035b70: 6e20 7469 6d65 2e0a 2020 2020 2027 2d64 n time.. '-d │ │ │ │ │ +00035b80: 2720 4649 4c45 0a20 2020 2020 2020 2020 ' FILE. │ │ │ │ │ +00035b90: 2046 494c 4520 6578 6973 7473 2061 6e64 FILE exists and │ │ │ │ │ +00035ba0: 2069 7320 6120 6469 7265 6374 6f72 790a is a directory. │ │ │ │ │ +00035bb0: 2020 2020 2027 2d65 2720 4649 4c45 0a20 '-e' FILE. │ │ │ │ │ +00035bc0: 2020 2020 2020 2020 2046 494c 4520 6578 FILE ex │ │ │ │ │ +00035bd0: 6973 7473 0a20 2020 2020 272d 6627 2046 ists. '-f' F │ │ │ │ │ +00035be0: 494c 450a 2020 2020 2020 2020 2020 4649 ILE. FI │ │ │ │ │ +00035bf0: 4c45 2065 7869 7374 7320 616e 6420 6973 LE exists and is │ │ │ │ │ +00035c00: 206e 6f74 2061 2064 6972 6563 746f 7279 not a directory │ │ │ │ │ +00035c10: 0a20 2020 2020 272d 7327 2046 494c 450a . '-s' FILE. │ │ │ │ │ +00035c20: 2020 2020 2020 2020 2020 4649 4c45 2065 FILE e │ │ │ │ │ +00035c30: 7869 7374 7320 616e 6420 6861 7320 6120 xists and has a │ │ │ │ │ +00035c40: 7369 7a65 2067 7265 6174 6572 2074 6861 size greater tha │ │ │ │ │ +00035c50: 6e20 7a65 726f 0a20 2020 2020 272d 6e27 n zero. '-n' │ │ │ │ │ +00035c60: 2053 5452 494e 470a 2020 2020 2020 2020 STRING. │ │ │ │ │ +00035c70: 2020 7468 6520 6c65 6e67 7468 206f 6620 the length of │ │ │ │ │ +00035c80: 5354 5249 4e47 2069 7320 6e6f 6e7a 6572 STRING is nonzer │ │ │ │ │ +00035c90: 6f0a 2020 2020 2053 5452 494e 470a 2020 o. STRING. │ │ │ │ │ +00035ca0: 2020 2020 2020 2020 5354 5249 4e47 2069 STRING i │ │ │ │ │ +00035cb0: 7320 6571 7569 7661 6c65 6e74 2074 6f20 s equivalent to │ │ │ │ │ +00035cc0: 272d 6e20 5354 5249 4e47 270a 2020 2020 '-n STRING'. │ │ │ │ │ +00035cd0: 2027 2d7a 2720 5354 5249 4e47 0a20 2020 '-z' STRING. │ │ │ │ │ +00035ce0: 2020 2020 2020 2074 6865 206c 656e 6774 the lengt │ │ │ │ │ +00035cf0: 6820 6f66 2053 5452 494e 4720 6973 207a h of STRING is z │ │ │ │ │ +00035d00: 6572 6f0a 2020 2020 2027 2827 2045 5850 ero. '(' EXP │ │ │ │ │ +00035d10: 5245 5353 494f 4e20 2729 270a 2020 2020 RESSION ')'. │ │ │ │ │ +00035d20: 2020 2020 2020 4558 5052 4553 5349 4f4e EXPRESSION │ │ │ │ │ +00035d30: 2069 7320 7472 7565 0a20 2020 2020 2721 is true. '! │ │ │ │ │ +00035d40: 2720 4558 5052 4553 5349 4f4e 0a20 2020 ' EXPRESSION. │ │ │ │ │ +00035d50: 2020 2020 2020 2045 5850 5245 5353 494f EXPRESSIO │ │ │ │ │ +00035d60: 4e20 6973 2066 616c 7365 0a20 2020 2020 N is false. │ │ │ │ │ +00035d70: 4558 5052 4553 5349 4f4e 3120 272d 6127 EXPRESSION1 '-a' │ │ │ │ │ +00035d80: 2045 5850 5245 5353 494f 4e32 0a20 2020 EXPRESSION2. │ │ │ │ │ +00035d90: 2020 2020 2020 2062 6f74 6820 4558 5052 both EXPR │ │ │ │ │ +00035da0: 4553 5349 4f4e 3120 616e 6420 4558 5052 ESSION1 and EXPR │ │ │ │ │ +00035db0: 4553 5349 4f4e 3220 6172 6520 7472 7565 ESSION2 are true │ │ │ │ │ +00035dc0: 0a20 2020 2020 4558 5052 4553 5349 4f4e . EXPRESSION │ │ │ │ │ +00035dd0: 3120 4558 5052 4553 5349 4f4e 320a 2020 1 EXPRESSION2. │ │ │ │ │ +00035de0: 2020 2020 2020 2020 626f 7468 2045 5850 both EXP │ │ │ │ │ +00035df0: 5245 5353 494f 4e31 2061 6e64 2045 5850 RESSION1 and EXP │ │ │ │ │ +00035e00: 5245 5353 494f 4e32 2061 7265 2074 7275 RESSION2 are tru │ │ │ │ │ +00035e10: 652e 2020 5468 6973 2073 796e 7461 7820 e. This syntax │ │ │ │ │ +00035e20: 6973 206e 6f74 0a20 2020 2020 2020 2020 is not. │ │ │ │ │ +00035e30: 2050 4f53 4958 2d63 6f6d 706c 6961 6e74 POSIX-compliant │ │ │ │ │ +00035e40: 2061 6e64 2069 7320 6e6f 7420 7265 636f and is not reco │ │ │ │ │ +00035e50: 6d6d 656e 6465 642e 0a20 2020 2020 4558 mmended.. EX │ │ │ │ │ +00035e60: 5052 4553 5349 4f4e 3120 272d 6f27 2045 PRESSION1 '-o' E │ │ │ │ │ +00035e70: 5850 5245 5353 494f 4e32 0a20 2020 2020 XPRESSION2. │ │ │ │ │ +00035e80: 2020 2020 2065 6974 6865 7220 4558 5052 either EXPR │ │ │ │ │ +00035e90: 4553 5349 4f4e 3120 6f72 2045 5850 5245 ESSION1 or EXPRE │ │ │ │ │ +00035ea0: 5353 494f 4e32 2069 7320 7472 7565 0a0a SSION2 is true.. │ │ │ │ │ +00035eb0: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ +00035ec0: 6f2c 2020 4e6f 6465 3a20 7472 7565 2c20 o, Node: true, │ │ │ │ │ +00035ed0: 204e 6578 743a 2074 7275 7374 2c20 2050 Next: trust, P │ │ │ │ │ +00035ee0: 7265 763a 2074 6573 742c 2020 5570 3a20 rev: test, Up: │ │ │ │ │ +00035ef0: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ +00035f00: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ │ +00035f10: 616e 6473 0a0a 3136 2e33 2e37 3520 7472 ands..16.3.75 tr │ │ │ │ │ +00035f20: 7565 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ue.------------. │ │ │ │ │ +00035f30: 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 7472 . -- Command: tr │ │ │ │ │ +00035f40: 7565 0a20 2020 2020 446f 206e 6f74 6869 ue. Do nothi │ │ │ │ │ +00035f50: 6e67 2c20 7375 6363 6573 7366 756c 6c79 ng, successfully │ │ │ │ │ +00035f60: 2e20 2054 6869 7320 6973 206d 6169 6e6c . This is mainl │ │ │ │ │ +00035f70: 7920 7573 6566 756c 2069 6e20 636f 6e74 y useful in cont │ │ │ │ │ +00035f80: 726f 6c0a 2020 2020 2063 6f6e 7374 7275 rol. constru │ │ │ │ │ +00035f90: 6374 7320 7375 6368 2061 7320 2769 6627 cts such as 'if' │ │ │ │ │ +00035fa0: 2061 6e64 2027 7768 696c 6527 2028 2a6e and 'while' (*n │ │ │ │ │ +00035fb0: 6f74 6520 5368 656c 6c2d 6c69 6b65 2073 ote Shell-like s │ │ │ │ │ +00035fc0: 6372 6970 7469 6e67 3a3a 292e 0a0a 1f0a cripting::)..... │ │ │ │ │ +00035fd0: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ +00035fe0: 2020 4e6f 6465 3a20 7472 7573 742c 2020 Node: trust, │ │ │ │ │ +00035ff0: 4e65 7874 3a20 756e 7365 742c 2020 5072 Next: unset, Pr │ │ │ │ │ +00036000: 6576 3a20 7472 7565 2c20 2055 703a 2043 ev: true, Up: C │ │ │ │ │ +00036010: 6f6d 6d61 6e64 2d6c 696e 6520 616e 6420 ommand-line and │ │ │ │ │ +00036020: 6d65 6e75 2065 6e74 7279 2063 6f6d 6d61 menu entry comma │ │ │ │ │ +00036030: 6e64 730a 0a31 362e 332e 3736 2074 7275 nds..16.3.76 tru │ │ │ │ │ +00036040: 7374 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d st.------------- │ │ │ │ │ +00036050: 0a0a 202d 2d20 436f 6d6d 616e 643a 2074 .. -- Command: t │ │ │ │ │ +00036060: 7275 7374 205b 2d2d 736b 6970 2d73 6967 rust [--skip-sig │ │ │ │ │ +00036070: 5d20 7075 626b 6579 5f66 696c 650a 2020 ] pubkey_file. │ │ │ │ │ +00036080: 2020 2052 6561 6420 7075 626c 6963 206b Read public k │ │ │ │ │ +00036090: 6579 2066 726f 6d20 5055 424b 4559 5f46 ey from PUBKEY_F │ │ │ │ │ +000360a0: 494c 4520 616e 6420 6164 6420 6974 2074 ILE and add it t │ │ │ │ │ +000360b0: 6f20 4752 5542 2773 2069 6e74 6572 6e61 o GRUB's interna │ │ │ │ │ +000360c0: 6c20 6c69 7374 0a20 2020 2020 6f66 2074 l list. of t │ │ │ │ │ +000360d0: 7275 7374 6564 2070 7562 6c69 6320 6b65 rusted public ke │ │ │ │ │ +000360e0: 7973 2e20 2054 6865 7365 206b 6579 7320 ys. These keys │ │ │ │ │ +000360f0: 6172 6520 7573 6564 2074 6f20 7661 6c69 are used to vali │ │ │ │ │ +00036100: 6461 7465 2064 6967 6974 616c 0a20 2020 date digital. │ │ │ │ │ +00036110: 2020 7369 676e 6174 7572 6573 2077 6865 signatures whe │ │ │ │ │ +00036120: 6e20 656e 7669 726f 6e6d 656e 7420 7661 n environment va │ │ │ │ │ +00036130: 7269 6162 6c65 2027 6368 6563 6b5f 7369 riable 'check_si │ │ │ │ │ +00036140: 676e 6174 7572 6573 2720 6973 2073 6574 gnatures' is set │ │ │ │ │ +00036150: 2074 6f0a 2020 2020 2027 656e 666f 7263 to. 'enforc │ │ │ │ │ +00036160: 6527 2e20 204e 6f74 6520 7468 6174 2069 e'. Note that i │ │ │ │ │ +00036170: 6620 2763 6865 636b 5f73 6967 6e61 7475 f 'check_signatu │ │ │ │ │ +00036180: 7265 7327 2069 7320 7365 7420 746f 2027 res' is set to ' │ │ │ │ │ +00036190: 656e 666f 7263 6527 0a20 2020 2020 7768 enforce'. wh │ │ │ │ │ +000361a0: 656e 2027 7472 7573 7427 2065 7865 6375 en 'trust' execu │ │ │ │ │ +000361b0: 7465 732c 2074 6865 6e20 5055 424b 4559 tes, then PUBKEY │ │ │ │ │ +000361c0: 5f46 494c 4520 6d75 7374 2069 7473 656c _FILE must itsel │ │ │ │ │ +000361d0: 6620 6265 2070 726f 7065 726c 790a 2020 f be properly. │ │ │ │ │ +000361e0: 2020 2073 6967 6e65 642e 2020 5468 6520 signed. The │ │ │ │ │ +000361f0: 272d 2d73 6b69 702d 7369 6727 206f 7074 '--skip-sig' opt │ │ │ │ │ +00036200: 696f 6e20 6361 6e20 6265 2075 7365 6420 ion can be used │ │ │ │ │ +00036210: 746f 2064 6973 6162 6c65 0a20 2020 2020 to disable. │ │ │ │ │ +00036220: 7369 676e 6174 7572 652d 6368 6563 6b69 signature-checki │ │ │ │ │ +00036230: 6e67 2077 6865 6e20 7265 6164 696e 6720 ng when reading │ │ │ │ │ +00036240: 5055 424b 4559 5f46 494c 4520 6974 7365 PUBKEY_FILE itse │ │ │ │ │ +00036250: 6c66 2e20 2049 7420 6973 2065 7870 6563 lf. It is expec │ │ │ │ │ +00036260: 7465 640a 2020 2020 2074 6861 7420 272d ted. that '- │ │ │ │ │ +00036270: 2d73 6b69 702d 7369 6727 2069 7320 7573 -skip-sig' is us │ │ │ │ │ +00036280: 6566 756c 2066 6f72 2074 6573 7469 6e67 eful for testing │ │ │ │ │ +00036290: 2061 6e64 206d 616e 7561 6c20 626f 6f74 and manual boot │ │ │ │ │ +000362a0: 696e 672e 2020 2a4e 6f74 650a 2020 2020 ing. *Note. │ │ │ │ │ +000362b0: 2055 7369 6e67 2064 6967 6974 616c 2073 Using digital s │ │ │ │ │ +000362c0: 6967 6e61 7475 7265 733a 3a2c 2066 6f72 ignatures::, for │ │ │ │ │ +000362d0: 206d 6f72 6520 696e 666f 726d 6174 696f more informatio │ │ │ │ │ +000362e0: 6e2e 0a0a 1f0a 4669 6c65 3a20 6772 7562 n.....File: grub │ │ │ │ │ +000362f0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 756e .info, Node: un │ │ │ │ │ +00036300: 7365 742c 2020 4e65 7874 3a20 7665 7269 set, Next: veri │ │ │ │ │ +00036310: 6679 5f64 6574 6163 6865 642c 2020 5072 fy_detached, Pr │ │ │ │ │ +00036320: 6576 3a20 7472 7573 742c 2020 5570 3a20 ev: trust, Up: │ │ │ │ │ +00036330: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ +00036340: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ │ +00036350: 616e 6473 0a0a 3136 2e33 2e37 3720 756e ands..16.3.77 un │ │ │ │ │ +00036360: 7365 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d set.------------ │ │ │ │ │ +00036370: 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 -.. -- Command: │ │ │ │ │ +00036380: 756e 7365 7420 656e 7676 6172 0a20 2020 unset envvar. │ │ │ │ │ +00036390: 2020 556e 7365 7420 7468 6520 656e 7669 Unset the envi │ │ │ │ │ +000363a0: 726f 6e6d 656e 7420 7661 7269 6162 6c65 ronment variable │ │ │ │ │ +000363b0: 2045 4e56 5641 522e 0a0a 1f0a 4669 6c65 ENVVAR.....File │ │ │ │ │ +000363c0: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ +000363d0: 6465 3a20 7665 7269 6679 5f64 6574 6163 de: verify_detac │ │ │ │ │ +000363e0: 6865 642c 2020 4e65 7874 3a20 7669 6465 hed, Next: vide │ │ │ │ │ +000363f0: 6f69 6e66 6f2c 2020 5072 6576 3a20 756e oinfo, Prev: un │ │ │ │ │ +00036400: 7365 742c 2020 5570 3a20 436f 6d6d 616e set, Up: Comman │ │ │ │ │ +00036410: 642d 6c69 6e65 2061 6e64 206d 656e 7520 d-line and menu │ │ │ │ │ +00036420: 656e 7472 7920 636f 6d6d 616e 6473 0a0a entry commands.. │ │ │ │ │ +00036430: 3136 2e33 2e37 3820 7665 7269 6679 5f64 16.3.78 verify_d │ │ │ │ │ +00036440: 6574 6163 6865 640a 2d2d 2d2d 2d2d 2d2d etached.-------- │ │ │ │ │ +00036450: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ +00036460: 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 7665 . -- Command: ve │ │ │ │ │ +00036470: 7269 6679 5f64 6574 6163 6865 6420 5b2d rify_detached [- │ │ │ │ │ +00036480: 2d73 6b69 702d 7369 675d 2066 696c 6520 -skip-sig] file │ │ │ │ │ +00036490: 7369 676e 6174 7572 655f 6669 6c65 0a20 signature_file. │ │ │ │ │ +000364a0: 2020 2020 2020 2020 205b 7075 626b 6579 [pubkey │ │ │ │ │ +000364b0: 5f66 696c 655d 0a20 2020 2020 5665 7269 _file]. Veri │ │ │ │ │ +000364c0: 6669 6573 2061 2047 5047 2d73 7479 6c65 fies a GPG-style │ │ │ │ │ +000364d0: 2064 6574 6163 6865 6420 7369 676e 6174 detached signat │ │ │ │ │ +000364e0: 7572 652c 2077 6865 7265 2074 6865 2073 ure, where the s │ │ │ │ │ +000364f0: 6967 6e65 6420 6669 6c65 2069 730a 2020 igned file is. │ │ │ │ │ +00036500: 2020 2046 494c 452c 2061 6e64 2074 6865 FILE, and the │ │ │ │ │ +00036510: 2073 6967 6e61 7475 7265 2069 7473 656c signature itsel │ │ │ │ │ +00036520: 6620 6973 2069 6e20 6669 6c65 2053 4947 f is in file SIG │ │ │ │ │ +00036530: 4e41 5455 5245 5f46 494c 452e 0a20 2020 NATURE_FILE.. │ │ │ │ │ +00036540: 2020 4f70 7469 6f6e 616c 6c79 2c20 6120 Optionally, a │ │ │ │ │ +00036550: 7370 6563 6966 6963 2070 7562 6c69 6320 specific public │ │ │ │ │ +00036560: 6b65 7920 746f 2075 7365 2063 616e 2062 key to use can b │ │ │ │ │ +00036570: 6520 7370 6563 6966 6965 6420 7573 696e e specified usin │ │ │ │ │ +00036580: 670a 2020 2020 2050 5542 4b45 595f 4649 g. PUBKEY_FI │ │ │ │ │ +00036590: 4c45 2e20 2057 6865 6e20 656e 7669 726f LE. When enviro │ │ │ │ │ +000365a0: 6e6d 656e 7420 7661 7269 6162 6c65 2027 nment variable ' │ │ │ │ │ +000365b0: 6368 6563 6b5f 7369 676e 6174 7572 6573 check_signatures │ │ │ │ │ +000365c0: 2720 6973 2073 6574 0a20 2020 2020 746f ' is set. to │ │ │ │ │ +000365d0: 2027 656e 666f 7263 6527 2c20 7468 656e 'enforce', then │ │ │ │ │ +000365e0: 2050 5542 4b45 595f 4649 4c45 206d 7573 PUBKEY_FILE mus │ │ │ │ │ +000365f0: 7420 6974 7365 6c66 2062 6520 7072 6f70 t itself be prop │ │ │ │ │ +00036600: 6572 6c79 2073 6967 6e65 6420 6279 2061 erly signed by a │ │ │ │ │ +00036610: 6e0a 2020 2020 2061 6c72 6561 6479 2d74 n. already-t │ │ │ │ │ +00036620: 7275 7374 6564 206b 6579 2e20 2041 6e20 rusted key. An │ │ │ │ │ +00036630: 756e 7369 676e 6564 2050 5542 4b45 595f unsigned PUBKEY_ │ │ │ │ │ +00036640: 4649 4c45 2063 616e 2062 6520 6c6f 6164 FILE can be load │ │ │ │ │ +00036650: 6564 2062 790a 2020 2020 2073 7065 6369 ed by. speci │ │ │ │ │ +00036660: 6679 696e 6720 272d 2d73 6b69 702d 7369 fying '--skip-si │ │ │ │ │ +00036670: 6727 2e20 2049 6620 5055 424b 4559 5f46 g'. If PUBKEY_F │ │ │ │ │ +00036680: 494c 4520 6973 206f 6d69 7474 6564 2c20 ILE is omitted, │ │ │ │ │ +00036690: 7468 656e 2070 7562 6c69 630a 2020 2020 then public. │ │ │ │ │ +000366a0: 206b 6579 7320 6672 6f6d 2047 5255 4227 keys from GRUB' │ │ │ │ │ +000366b0: 7320 7472 7573 7465 6420 6b65 7973 2028 s trusted keys ( │ │ │ │ │ +000366c0: 2a6e 6f74 6520 6c69 7374 5f74 7275 7374 *note list_trust │ │ │ │ │ +000366d0: 6564 3a3a 2c20 2a6e 6f74 6520 7472 7573 ed::, *note trus │ │ │ │ │ +000366e0: 743a 3a2c 0a20 2020 2020 616e 6420 2a6e t::,. and *n │ │ │ │ │ +000366f0: 6f74 6520 6469 7374 7275 7374 3a3a 2920 ote distrust::) │ │ │ │ │ +00036700: 6172 6520 7472 6965 642e 0a0a 2020 2020 are tried... │ │ │ │ │ +00036710: 2045 7869 7420 636f 6465 2027 243f 2720 Exit code '$?' │ │ │ │ │ +00036720: 6973 2073 6574 2074 6f20 3020 6966 2074 is set to 0 if t │ │ │ │ │ +00036730: 6865 2073 6967 6e61 7475 7265 2076 616c he signature val │ │ │ │ │ +00036740: 6964 6174 6573 2073 7563 6365 7373 6675 idates successfu │ │ │ │ │ +00036750: 6c6c 792e 0a20 2020 2020 4966 2076 616c lly.. If val │ │ │ │ │ +00036760: 6964 6174 696f 6e20 6661 696c 732c 2069 idation fails, i │ │ │ │ │ +00036770: 7420 6973 2073 6574 2074 6f20 6120 6e6f t is set to a no │ │ │ │ │ +00036780: 6e2d 7a65 726f 2076 616c 7565 2e20 202a n-zero value. * │ │ │ │ │ +00036790: 4e6f 7465 2055 7369 6e67 0a20 2020 2020 Note Using. │ │ │ │ │ +000367a0: 6469 6769 7461 6c20 7369 676e 6174 7572 digital signatur │ │ │ │ │ +000367b0: 6573 3a3a 2c20 666f 7220 6d6f 7265 2069 es::, for more i │ │ │ │ │ +000367c0: 6e66 6f72 6d61 7469 6f6e 2e0a 0a1f 0a46 nformation.....F │ │ │ │ │ +000367d0: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ +000367e0: 204e 6f64 653a 2076 6964 656f 696e 666f Node: videoinfo │ │ │ │ │ +000367f0: 2c20 204e 6578 743a 2077 726d 7372 2c20 , Next: wrmsr, │ │ │ │ │ +00036800: 2050 7265 763a 2076 6572 6966 795f 6465 Prev: verify_de │ │ │ │ │ +00036810: 7461 6368 6564 2c20 2055 703a 2043 6f6d tached, Up: Com │ │ │ │ │ +00036820: 6d61 6e64 2d6c 696e 6520 616e 6420 6d65 mand-line and me │ │ │ │ │ +00036830: 6e75 2065 6e74 7279 2063 6f6d 6d61 6e64 nu entry command │ │ │ │ │ +00036840: 730a 0a31 362e 332e 3739 2076 6964 656f s..16.3.79 video │ │ │ │ │ +00036850: 696e 666f 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d info.----------- │ │ │ │ │ +00036860: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ │ +00036870: 616e 643a 2076 6964 656f 696e 666f 205b and: videoinfo [ │ │ │ │ │ +00036880: 5b57 7848 5d78 445d 0a20 2020 2020 4c69 [WxH]xD]. Li │ │ │ │ │ +00036890: 7374 2061 7661 696c 6162 6c65 2076 6964 st available vid │ │ │ │ │ +000368a0: 656f 206d 6f64 6573 2e20 2049 6620 7265 eo modes. If re │ │ │ │ │ +000368b0: 736f 6c75 7469 6f6e 2069 7320 6769 7665 solution is give │ │ │ │ │ +000368c0: 6e2c 2073 686f 7720 6f6e 6c79 0a20 2020 n, show only. │ │ │ │ │ +000368d0: 2020 6d61 7463 6869 6e67 206d 6f64 6573 matching modes │ │ │ │ │ +000368e0: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ +000368f0: 696e 666f 2c20 204e 6f64 653a 2077 726d info, Node: wrm │ │ │ │ │ +00036900: 7372 2c20 204e 6578 743a 2078 656e 5f68 sr, Next: xen_h │ │ │ │ │ +00036910: 7970 6572 7669 736f 722c 2020 5072 6576 ypervisor, Prev │ │ │ │ │ +00036920: 3a20 7669 6465 6f69 6e66 6f2c 2020 5570 : videoinfo, Up │ │ │ │ │ +00036930: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ │ +00036940: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ │ +00036950: 6d6d 616e 6473 0a0a 3136 2e33 2e38 3020 mmands..16.3.80 │ │ │ │ │ +00036960: 7772 6d73 720a 2d2d 2d2d 2d2d 2d2d 2d2d wrmsr.---------- │ │ │ │ │ +00036970: 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 ---.. -- Command │ │ │ │ │ +00036980: 3a3a 2077 726d 7372 2030 7841 4444 5220 :: wrmsr 0xADDR │ │ │ │ │ +00036990: 3078 5641 4c55 450a 2020 2020 2057 7269 0xVALUE. Wri │ │ │ │ │ +000369a0: 7465 2061 2030 7856 414c 5545 2074 6f20 te a 0xVALUE to │ │ │ │ │ +000369b0: 6120 6d6f 6465 6c2d 7370 6563 6966 6963 a model-specific │ │ │ │ │ +000369c0: 2072 6567 6973 7465 7220 6174 2061 6464 register at add │ │ │ │ │ +000369d0: 7265 7373 2030 7841 4444 522e 0a0a 2020 ress 0xADDR... │ │ │ │ │ +000369e0: 2020 2050 6c65 6173 6520 6e6f 7465 2074 Please note t │ │ │ │ │ +000369f0: 6861 7420 6f6e 2053 4d50 2073 7973 7465 hat on SMP syste │ │ │ │ │ +00036a00: 6d73 2c20 7772 6974 696e 6720 746f 2061 ms, writing to a │ │ │ │ │ +00036a10: 204d 5352 2074 6861 7420 6861 7320 6120 MSR that has a │ │ │ │ │ +00036a20: 7363 6f70 650a 2020 2020 2070 6572 2068 scope. per h │ │ │ │ │ +00036a30: 6172 6477 6172 6520 7468 7265 6164 2c20 ardware thread, │ │ │ │ │ +00036a40: 696d 706c 6965 7320 7468 6174 2074 6865 implies that the │ │ │ │ │ +00036a50: 2076 616c 7565 2074 6861 7420 6973 2077 value that is w │ │ │ │ │ +00036a60: 7269 7474 656e 206f 6e6c 790a 2020 2020 ritten only. │ │ │ │ │ +00036a70: 2061 7070 6c69 6573 2074 6f20 7468 6520 applies to the │ │ │ │ │ +00036a80: 7061 7274 6963 756c 6172 2063 7075 2f63 particular cpu/c │ │ │ │ │ +00036a90: 6f72 652f 7468 7265 6164 2074 6861 7420 ore/thread that │ │ │ │ │ +00036aa0: 7275 6e73 2074 6865 2063 6f6d 6d61 6e64 runs the command │ │ │ │ │ +00036ab0: 2e0a 0a20 2020 2020 416c 736f 2c20 6966 ... Also, if │ │ │ │ │ +00036ac0: 2079 6f75 2073 7065 6369 6679 2061 2072 you specify a r │ │ │ │ │ +00036ad0: 6573 6572 7665 6420 6f72 2075 6e69 6d70 eserved or unimp │ │ │ │ │ +00036ae0: 6c65 6d65 6e74 6564 204d 5352 2061 6464 lemented MSR add │ │ │ │ │ +00036af0: 7265 7373 2c20 6974 0a20 2020 2020 7769 ress, it. wi │ │ │ │ │ +00036b00: 6c6c 2063 6175 7365 2061 2067 656e 6572 ll cause a gener │ │ │ │ │ +00036b10: 616c 2070 726f 7465 6374 696f 6e20 6578 al protection ex │ │ │ │ │ +00036b20: 6365 7074 696f 6e20 2877 6869 6368 2069 ception (which i │ │ │ │ │ +00036b30: 7320 6e6f 7420 6375 7272 656e 746c 790a s not currently. │ │ │ │ │ +00036b40: 2020 2020 2062 6569 6e67 2068 616e 646c being handl │ │ │ │ │ +00036b50: 6564 2920 616e 6420 7468 6520 7379 7374 ed) and the syst │ │ │ │ │ +00036b60: 656d 2077 696c 6c20 7265 626f 6f74 2e0a em will reboot.. │ │ │ │ │ +00036b70: 0a20 2020 2020 4e6f 7465 3a20 5468 6520 . Note: The │ │ │ │ │ +00036b80: 636f 6d6d 616e 6420 6973 206e 6f74 2061 command is not a │ │ │ │ │ +00036b90: 6c6c 6f77 6564 2077 6865 6e20 6c6f 636b llowed when lock │ │ │ │ │ +00036ba0: 646f 776e 2069 7320 656e 666f 7263 6564 down is enforced │ │ │ │ │ +00036bb0: 2028 2a6e 6f74 650a 2020 2020 204c 6f63 (*note. Loc │ │ │ │ │ +00036bc0: 6b64 6f77 6e3a 3a29 2e20 2054 6869 7320 kdown::). This │ │ │ │ │ +00036bd0: 6973 2064 6f6e 6520 746f 2070 7265 7665 is done to preve │ │ │ │ │ +00036be0: 6e74 2073 7562 7665 7274 696e 6720 7661 nt subverting va │ │ │ │ │ +00036bf0: 7269 6f75 7320 7365 6375 7269 7479 0a20 rious security. │ │ │ │ │ +00036c00: 2020 2020 6d65 6368 616e 6973 6d73 2e0a mechanisms.. │ │ │ │ │ +00036c10: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ +00036c20: 666f 2c20 204e 6f64 653a 2078 656e 5f68 fo, Node: xen_h │ │ │ │ │ +00036c30: 7970 6572 7669 736f 722c 2020 4e65 7874 ypervisor, Next │ │ │ │ │ +00036c40: 3a20 7865 6e5f 6d6f 6475 6c65 2c20 2050 : xen_module, P │ │ │ │ │ +00036c50: 7265 763a 2077 726d 7372 2c20 2055 703a rev: wrmsr, Up: │ │ │ │ │ +00036c60: 2043 6f6d 6d61 6e64 2d6c 696e 6520 616e Command-line an │ │ │ │ │ +00036c70: 6420 6d65 6e75 2065 6e74 7279 2063 6f6d d menu entry com │ │ │ │ │ +00036c80: 6d61 6e64 730a 0a31 362e 332e 3831 2078 mands..16.3.81 x │ │ │ │ │ +00036c90: 656e 5f68 7970 6572 7669 736f 720a 2d2d en_hypervisor.-- │ │ │ │ │ 00036ca0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00036cb0: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ │ -00036cc0: 616e 643a 2078 656e 5f68 7970 6572 7669 and: xen_hypervi │ │ │ │ │ -00036cd0: 736f 7220 6669 6c65 205b 6172 6775 6d65 sor file [argume │ │ │ │ │ -00036ce0: 6e74 735d 202e 2e2e 0a20 2020 2020 4c6f nts] .... Lo │ │ │ │ │ -00036cf0: 6164 2061 2058 656e 2068 7970 6572 7669 ad a Xen hypervi │ │ │ │ │ -00036d00: 736f 7220 6269 6e61 7279 2066 726f 6d20 sor binary from │ │ │ │ │ -00036d10: 4649 4c45 2e20 2054 6865 2072 6573 7420 FILE. The rest │ │ │ │ │ -00036d20: 6f66 2074 6865 206c 696e 6520 6973 0a20 of the line is. │ │ │ │ │ -00036d30: 2020 2020 7061 7373 6564 2076 6572 6261 passed verba │ │ │ │ │ -00036d40: 7469 6d20 6173 2074 6865 2022 6b65 726e tim as the "kern │ │ │ │ │ -00036d50: 656c 2063 6f6d 6d61 6e64 2d6c 696e 6522 el command-line" │ │ │ │ │ -00036d60: 2e20 2041 6e79 206f 7468 6572 2062 696e . Any other bin │ │ │ │ │ -00036d70: 6172 6965 730a 2020 2020 206d 7573 7420 aries. must │ │ │ │ │ -00036d80: 6265 2072 656c 6f61 6465 6420 6166 7465 be reloaded afte │ │ │ │ │ -00036d90: 7220 7573 696e 6720 7468 6973 2063 6f6d r using this com │ │ │ │ │ -00036da0: 6d61 6e64 2e20 2054 6869 7320 636f 6d6d mand. This comm │ │ │ │ │ -00036db0: 616e 6420 6973 206f 6e6c 790a 2020 2020 and is only. │ │ │ │ │ -00036dc0: 2061 7661 696c 6162 6c65 206f 6e20 4141 available on AA │ │ │ │ │ -00036dd0: 7263 6836 3420 7379 7374 656d 732e 0a0a rch64 systems... │ │ │ │ │ -00036de0: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ -00036df0: 6f2c 2020 4e6f 6465 3a20 7865 6e5f 6d6f o, Node: xen_mo │ │ │ │ │ -00036e00: 6475 6c65 2c20 2050 7265 763a 2078 656e dule, Prev: xen │ │ │ │ │ -00036e10: 5f68 7970 6572 7669 736f 722c 2020 5570 _hypervisor, Up │ │ │ │ │ -00036e20: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ │ -00036e30: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ │ -00036e40: 6d6d 616e 6473 0a0a 3136 2e33 2e38 3220 mmands..16.3.82 │ │ │ │ │ -00036e50: 7865 6e5f 6d6f 6475 6c65 0a2d 2d2d 2d2d xen_module.----- │ │ │ │ │ -00036e60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 -------------.. │ │ │ │ │ -00036e70: 2d2d 2043 6f6d 6d61 6e64 3a20 7865 6e5f -- Command: xen_ │ │ │ │ │ -00036e80: 6d6f 6475 6c65 205b 2d2d 6e6f 756e 7a69 module [--nounzi │ │ │ │ │ -00036e90: 705d 2066 696c 6520 5b61 7267 756d 656e p] file [argumen │ │ │ │ │ -00036ea0: 7473 5d0a 2020 2020 204c 6f61 6420 6120 ts]. Load a │ │ │ │ │ -00036eb0: 6d6f 6475 6c65 2066 6f72 2078 656e 2068 module for xen h │ │ │ │ │ -00036ec0: 7970 6572 7669 736f 7220 6174 2074 6865 ypervisor at the │ │ │ │ │ -00036ed0: 2062 6f6f 7469 6e67 2070 726f 6365 7373 booting process │ │ │ │ │ -00036ee0: 206f 6620 7865 6e2e 0a20 2020 2020 5468 of xen.. Th │ │ │ │ │ -00036ef0: 6520 7265 7374 206f 6620 7468 6520 6c69 e rest of the li │ │ │ │ │ -00036f00: 6e65 2069 7320 7061 7373 6564 2076 6572 ne is passed ver │ │ │ │ │ -00036f10: 6261 7469 6d20 6173 2074 6865 206d 6f64 batim as the mod │ │ │ │ │ -00036f20: 756c 6520 636f 6d6d 616e 6420 6c69 6e65 ule command line │ │ │ │ │ -00036f30: 2e0a 2020 2020 204d 6f64 756c 6573 2073 .. Modules s │ │ │ │ │ -00036f40: 686f 756c 6420 6265 206c 6f61 6465 6420 hould be loaded │ │ │ │ │ -00036f50: 696e 2074 6865 2066 6f6c 6c6f 7769 6e67 in the following │ │ │ │ │ -00036f60: 206f 7264 6572 3a20 2d20 646f 6d30 206b order: - dom0 k │ │ │ │ │ -00036f70: 6572 6e65 6c0a 2020 2020 2069 6d61 6765 ernel. image │ │ │ │ │ -00036f80: 202d 2064 6f6d 3020 7261 6d64 6973 6b20 - dom0 ramdisk │ │ │ │ │ -00036f90: 6966 2070 7265 7365 6e74 202d 2058 534d if present - XSM │ │ │ │ │ -00036fa0: 2070 6f6c 6963 7920 6966 2070 7265 7365 policy if prese │ │ │ │ │ -00036fb0: 6e74 2054 6869 730a 2020 2020 2063 6f6d nt This. com │ │ │ │ │ -00036fc0: 6d61 6e64 2069 7320 6f6e 6c79 2061 7661 mand is only ava │ │ │ │ │ -00036fd0: 696c 6162 6c65 206f 6e20 4141 7263 6836 ilable on AArch6 │ │ │ │ │ -00036fe0: 3420 7379 7374 656d 732e 0a0a 1f0a 4669 4 systems.....Fi │ │ │ │ │ -00036ff0: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ -00037000: 4e6f 6465 3a20 4e65 7477 6f72 6b69 6e67 Node: Networking │ │ │ │ │ -00037010: 2063 6f6d 6d61 6e64 732c 2020 5072 6576 commands, Prev │ │ │ │ │ -00037020: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ │ -00037030: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ │ -00037040: 6d6d 616e 6473 2c20 2055 703a 2043 6f6d mmands, Up: Com │ │ │ │ │ -00037050: 6d61 6e64 730a 0a31 362e 3420 5468 6520 mands..16.4 The │ │ │ │ │ -00037060: 6c69 7374 206f 6620 6e65 7477 6f72 6b69 list of networki │ │ │ │ │ -00037070: 6e67 2063 6f6d 6d61 6e64 730a 3d3d 3d3d ng commands.==== │ │ │ │ │ +00036cb0: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ │ +00036cc0: 643a 2078 656e 5f68 7970 6572 7669 736f d: xen_hyperviso │ │ │ │ │ +00036cd0: 7220 6669 6c65 205b 6172 6775 6d65 6e74 r file [argument │ │ │ │ │ +00036ce0: 735d 202e 2e2e 0a20 2020 2020 4c6f 6164 s] .... Load │ │ │ │ │ +00036cf0: 2061 2058 656e 2068 7970 6572 7669 736f a Xen hyperviso │ │ │ │ │ +00036d00: 7220 6269 6e61 7279 2066 726f 6d20 4649 r binary from FI │ │ │ │ │ +00036d10: 4c45 2e20 2054 6865 2072 6573 7420 6f66 LE. The rest of │ │ │ │ │ +00036d20: 2074 6865 206c 696e 6520 6973 0a20 2020 the line is. │ │ │ │ │ +00036d30: 2020 7061 7373 6564 2076 6572 6261 7469 passed verbati │ │ │ │ │ +00036d40: 6d20 6173 2074 6865 2022 6b65 726e 656c m as the "kernel │ │ │ │ │ +00036d50: 2063 6f6d 6d61 6e64 2d6c 696e 6522 2e20 command-line". │ │ │ │ │ +00036d60: 2041 6e79 206f 7468 6572 2062 696e 6172 Any other binar │ │ │ │ │ +00036d70: 6965 730a 2020 2020 206d 7573 7420 6265 ies. must be │ │ │ │ │ +00036d80: 2072 656c 6f61 6465 6420 6166 7465 7220 reloaded after │ │ │ │ │ +00036d90: 7573 696e 6720 7468 6973 2063 6f6d 6d61 using this comma │ │ │ │ │ +00036da0: 6e64 2e20 2054 6869 7320 636f 6d6d 616e nd. This comman │ │ │ │ │ +00036db0: 6420 6973 206f 6e6c 790a 2020 2020 2061 d is only. a │ │ │ │ │ +00036dc0: 7661 696c 6162 6c65 206f 6e20 4141 7263 vailable on AArc │ │ │ │ │ +00036dd0: 6836 3420 7379 7374 656d 732e 0a0a 1f0a h64 systems..... │ │ │ │ │ +00036de0: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ +00036df0: 2020 4e6f 6465 3a20 7865 6e5f 6d6f 6475 Node: xen_modu │ │ │ │ │ +00036e00: 6c65 2c20 2050 7265 763a 2078 656e 5f68 le, Prev: xen_h │ │ │ │ │ +00036e10: 7970 6572 7669 736f 722c 2020 5570 3a20 ypervisor, Up: │ │ │ │ │ +00036e20: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ +00036e30: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ │ +00036e40: 616e 6473 0a0a 3136 2e33 2e38 3220 7865 ands..16.3.82 xe │ │ │ │ │ +00036e50: 6e5f 6d6f 6475 6c65 0a2d 2d2d 2d2d 2d2d n_module.------- │ │ │ │ │ +00036e60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d -----------.. -- │ │ │ │ │ +00036e70: 2043 6f6d 6d61 6e64 3a20 7865 6e5f 6d6f Command: xen_mo │ │ │ │ │ +00036e80: 6475 6c65 205b 2d2d 6e6f 756e 7a69 705d dule [--nounzip] │ │ │ │ │ +00036e90: 2066 696c 6520 5b61 7267 756d 656e 7473 file [arguments │ │ │ │ │ +00036ea0: 5d0a 2020 2020 204c 6f61 6420 6120 6d6f ]. Load a mo │ │ │ │ │ +00036eb0: 6475 6c65 2066 6f72 2078 656e 2068 7970 dule for xen hyp │ │ │ │ │ +00036ec0: 6572 7669 736f 7220 6174 2074 6865 2062 ervisor at the b │ │ │ │ │ +00036ed0: 6f6f 7469 6e67 2070 726f 6365 7373 206f ooting process o │ │ │ │ │ +00036ee0: 6620 7865 6e2e 0a20 2020 2020 5468 6520 f xen.. The │ │ │ │ │ +00036ef0: 7265 7374 206f 6620 7468 6520 6c69 6e65 rest of the line │ │ │ │ │ +00036f00: 2069 7320 7061 7373 6564 2076 6572 6261 is passed verba │ │ │ │ │ +00036f10: 7469 6d20 6173 2074 6865 206d 6f64 756c tim as the modul │ │ │ │ │ +00036f20: 6520 636f 6d6d 616e 6420 6c69 6e65 2e0a e command line.. │ │ │ │ │ +00036f30: 2020 2020 204d 6f64 756c 6573 2073 686f Modules sho │ │ │ │ │ +00036f40: 756c 6420 6265 206c 6f61 6465 6420 696e uld be loaded in │ │ │ │ │ +00036f50: 2074 6865 2066 6f6c 6c6f 7769 6e67 206f the following o │ │ │ │ │ +00036f60: 7264 6572 3a20 2d20 646f 6d30 206b 6572 rder: - dom0 ker │ │ │ │ │ +00036f70: 6e65 6c0a 2020 2020 2069 6d61 6765 202d nel. image - │ │ │ │ │ +00036f80: 2064 6f6d 3020 7261 6d64 6973 6b20 6966 dom0 ramdisk if │ │ │ │ │ +00036f90: 2070 7265 7365 6e74 202d 2058 534d 2070 present - XSM p │ │ │ │ │ +00036fa0: 6f6c 6963 7920 6966 2070 7265 7365 6e74 olicy if present │ │ │ │ │ +00036fb0: 2054 6869 730a 2020 2020 2063 6f6d 6d61 This. comma │ │ │ │ │ +00036fc0: 6e64 2069 7320 6f6e 6c79 2061 7661 696c nd is only avail │ │ │ │ │ +00036fd0: 6162 6c65 206f 6e20 4141 7263 6836 3420 able on AArch64 │ │ │ │ │ +00036fe0: 7379 7374 656d 732e 0a0a 1f0a 4669 6c65 systems.....File │ │ │ │ │ +00036ff0: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ +00037000: 6465 3a20 4e65 7477 6f72 6b69 6e67 2063 de: Networking c │ │ │ │ │ +00037010: 6f6d 6d61 6e64 732c 2020 5072 6576 3a20 ommands, Prev: │ │ │ │ │ +00037020: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ +00037030: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ │ +00037040: 616e 6473 2c20 2055 703a 2043 6f6d 6d61 ands, Up: Comma │ │ │ │ │ +00037050: 6e64 730a 0a31 362e 3420 5468 6520 6c69 nds..16.4 The li │ │ │ │ │ +00037060: 7374 206f 6620 6e65 7477 6f72 6b69 6e67 st of networking │ │ │ │ │ +00037070: 2063 6f6d 6d61 6e64 730a 3d3d 3d3d 3d3d commands.====== │ │ │ │ │ 00037080: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00037090: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -000370a0: 0a0a 2a20 4d65 6e75 3a0a 0a2a 206e 6574 ..* Menu:..* net │ │ │ │ │ -000370b0: 5f61 6464 5f61 6464 723a 3a20 2020 2020 _add_addr:: │ │ │ │ │ -000370c0: 2020 2020 2020 2020 2020 2041 6464 2061 Add a │ │ │ │ │ -000370d0: 206e 6574 776f 726b 2061 6464 7265 7373 network address │ │ │ │ │ -000370e0: 0a2a 206e 6574 5f61 6464 5f64 6e73 3a3a .* net_add_dns:: │ │ │ │ │ -000370f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00037100: 2041 6464 2061 2044 4e53 2073 6572 7665 Add a DNS serve │ │ │ │ │ -00037110: 720a 2a20 6e65 745f 6164 645f 726f 7574 r.* net_add_rout │ │ │ │ │ -00037120: 653a 3a20 2020 2020 2020 2020 2020 2020 e:: │ │ │ │ │ -00037130: 2020 4164 6420 726f 7574 696e 6720 656e Add routing en │ │ │ │ │ -00037140: 7472 790a 2a20 6e65 745f 626f 6f74 703a try.* net_bootp: │ │ │ │ │ -00037150: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -00037160: 2020 2020 5065 7266 6f72 6d20 6120 626f Perform a bo │ │ │ │ │ -00037170: 6f74 702f 4448 4350 2061 7574 6f63 6f6e otp/DHCP autocon │ │ │ │ │ -00037180: 6669 6775 7261 7469 6f6e 0a2a 206e 6574 figuration.* net │ │ │ │ │ -00037190: 5f64 656c 5f61 6464 723a 3a20 2020 2020 _del_addr:: │ │ │ │ │ -000371a0: 2020 2020 2020 2020 2020 2052 656d 6f76 Remov │ │ │ │ │ -000371b0: 6520 4950 2061 6464 7265 7373 2066 726f e IP address fro │ │ │ │ │ -000371c0: 6d20 696e 7465 7266 6163 650a 2a20 6e65 m interface.* ne │ │ │ │ │ -000371d0: 745f 6465 6c5f 646e 733a 3a20 2020 2020 t_del_dns:: │ │ │ │ │ -000371e0: 2020 2020 2020 2020 2020 2020 5265 6d6f Remo │ │ │ │ │ -000371f0: 7665 2061 2044 4e53 2073 6572 7665 720a ve a DNS server. │ │ │ │ │ -00037200: 2a20 6e65 745f 6465 6c5f 726f 7574 653a * net_del_route: │ │ │ │ │ -00037210: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -00037220: 5265 6d6f 7665 2061 2072 6f75 7465 2065 Remove a route e │ │ │ │ │ -00037230: 6e74 7279 0a2a 206e 6574 5f64 6863 703a ntry.* net_dhcp: │ │ │ │ │ -00037240: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -00037250: 2020 2020 2050 6572 666f 726d 2061 2044 Perform a D │ │ │ │ │ -00037260: 4843 5020 6175 746f 636f 6e66 6967 7572 HCP autoconfigur │ │ │ │ │ -00037270: 6174 696f 6e0a 2a20 6e65 745f 6765 745f ation.* net_get_ │ │ │ │ │ -00037280: 6468 6370 5f6f 7074 696f 6e3a 3a20 2020 dhcp_option:: │ │ │ │ │ -00037290: 2020 2020 2020 5265 7472 6965 7665 2044 Retrieve D │ │ │ │ │ -000372a0: 4843 5020 6f70 7469 6f6e 730a 2a20 6e65 HCP options.* ne │ │ │ │ │ -000372b0: 745f 6970 7636 5f61 7574 6f63 6f6e 663a t_ipv6_autoconf: │ │ │ │ │ -000372c0: 3a20 2020 2020 2020 2020 2020 5065 7266 : Perf │ │ │ │ │ -000372d0: 6f72 6d20 4950 7636 2061 7574 6f63 6f6e orm IPv6 autocon │ │ │ │ │ -000372e0: 6669 6775 7261 7469 6f6e 0a2a 206e 6574 figuration.* net │ │ │ │ │ -000372f0: 5f6c 735f 6164 6472 3a3a 2020 2020 2020 _ls_addr:: │ │ │ │ │ -00037300: 2020 2020 2020 2020 2020 204c 6973 7420 List │ │ │ │ │ -00037310: 696e 7465 7266 6163 6573 0a2a 206e 6574 interfaces.* net │ │ │ │ │ -00037320: 5f6c 735f 6361 7264 733a 3a20 2020 2020 _ls_cards:: │ │ │ │ │ -00037330: 2020 2020 2020 2020 2020 204c 6973 7420 List │ │ │ │ │ -00037340: 6e65 7477 6f72 6b20 6361 7264 730a 2a20 network cards.* │ │ │ │ │ -00037350: 6e65 745f 6c73 5f64 6e73 3a3a 2020 2020 net_ls_dns:: │ │ │ │ │ -00037360: 2020 2020 2020 2020 2020 2020 2020 4c69 Li │ │ │ │ │ -00037370: 7374 2044 4e53 2073 6572 7665 7273 0a2a st DNS servers.* │ │ │ │ │ -00037380: 206e 6574 5f6c 735f 726f 7574 6573 3a3a net_ls_routes:: │ │ │ │ │ -00037390: 2020 2020 2020 2020 2020 2020 2020 204c L │ │ │ │ │ -000373a0: 6973 7420 726f 7574 696e 6720 656e 7472 ist routing entr │ │ │ │ │ -000373b0: 6965 730a 2a20 6e65 745f 6e73 6c6f 6f6b ies.* net_nslook │ │ │ │ │ -000373c0: 7570 3a3a 2020 2020 2020 2020 2020 2020 up:: │ │ │ │ │ -000373d0: 2020 2020 5065 7266 6f72 6d20 6120 444e Perform a DN │ │ │ │ │ -000373e0: 5320 6c6f 6f6b 7570 0a0a 1f0a 4669 6c65 S lookup....File │ │ │ │ │ -000373f0: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ -00037400: 6465 3a20 6e65 745f 6164 645f 6164 6472 de: net_add_addr │ │ │ │ │ -00037410: 2c20 204e 6578 743a 206e 6574 5f61 6464 , Next: net_add │ │ │ │ │ -00037420: 5f64 6e73 2c20 2055 703a 204e 6574 776f _dns, Up: Netwo │ │ │ │ │ -00037430: 726b 696e 6720 636f 6d6d 616e 6473 0a0a rking commands.. │ │ │ │ │ -00037440: 3136 2e34 2e31 206e 6574 5f61 6464 5f61 16.4.1 net_add_a │ │ │ │ │ -00037450: 6464 720a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ddr.------------ │ │ │ │ │ -00037460: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d -------.. -- Com │ │ │ │ │ -00037470: 6d61 6e64 3a20 6e65 745f 6164 645f 6164 mand: net_add_ad │ │ │ │ │ -00037480: 6472 2049 4e54 4552 4641 4345 2043 4152 dr INTERFACE CAR │ │ │ │ │ -00037490: 4420 4144 4452 4553 530a 2020 2020 2043 D ADDRESS. C │ │ │ │ │ -000374a0: 6f6e 6669 6775 7265 2061 6464 6974 696f onfigure additio │ │ │ │ │ -000374b0: 6e61 6c20 6e65 7477 6f72 6b20 494e 5445 nal network INTE │ │ │ │ │ -000374c0: 5246 4143 4520 7769 7468 2041 4444 5245 RFACE with ADDRE │ │ │ │ │ -000374d0: 5353 206f 6e20 6120 6e65 7477 6f72 6b0a SS on a network. │ │ │ │ │ -000374e0: 2020 2020 2043 4152 442e 2020 4144 4452 CARD. ADDR │ │ │ │ │ -000374f0: 4553 5320 6361 6e20 6265 2065 6974 6865 ESS can be eithe │ │ │ │ │ -00037500: 7220 4950 2069 6e20 646f 7474 6564 2064 r IP in dotted d │ │ │ │ │ -00037510: 6563 696d 616c 206e 6f74 6174 696f 6e2c ecimal notation, │ │ │ │ │ -00037520: 206f 720a 2020 2020 2073 796d 626f 6c69 or. symboli │ │ │ │ │ -00037530: 6320 6e61 6d65 2077 6869 6368 2069 7320 c name which is │ │ │ │ │ -00037540: 7265 736f 6c76 6564 2075 7369 6e67 2044 resolved using D │ │ │ │ │ -00037550: 4e53 206c 6f6f 6b75 702e 2020 4966 2073 NS lookup. If s │ │ │ │ │ -00037560: 7563 6365 7373 6675 6c2c 0a20 2020 2020 uccessful,. │ │ │ │ │ -00037570: 7468 6973 2063 6f6d 6d61 6e64 2061 6c73 this command als │ │ │ │ │ -00037580: 6f20 6164 6473 206c 6f63 616c 206c 696e o adds local lin │ │ │ │ │ -00037590: 6b20 726f 7574 696e 6720 656e 7472 7920 k routing entry │ │ │ │ │ -000375a0: 746f 2074 6865 2064 6566 6175 6c74 0a20 to the default. │ │ │ │ │ -000375b0: 2020 2020 7375 626e 6574 206f 6620 4144 subnet of AD │ │ │ │ │ -000375c0: 4452 4553 5320 7769 7468 206e 616d 6520 DRESS with name │ │ │ │ │ -000375d0: 494e 5445 5246 4143 4527 3a6c 6f63 616c INTERFACE':local │ │ │ │ │ -000375e0: 2720 7669 6120 494e 5445 5246 4143 452e ' via INTERFACE. │ │ │ │ │ -000375f0: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ -00037600: 6e66 6f2c 2020 4e6f 6465 3a20 6e65 745f nfo, Node: net_ │ │ │ │ │ -00037610: 6164 645f 646e 732c 2020 4e65 7874 3a20 add_dns, Next: │ │ │ │ │ -00037620: 6e65 745f 6164 645f 726f 7574 652c 2020 net_add_route, │ │ │ │ │ -00037630: 5072 6576 3a20 6e65 745f 6164 645f 6164 Prev: net_add_ad │ │ │ │ │ -00037640: 6472 2c20 2055 703a 204e 6574 776f 726b dr, Up: Network │ │ │ │ │ -00037650: 696e 6720 636f 6d6d 616e 6473 0a0a 3136 ing commands..16 │ │ │ │ │ -00037660: 2e34 2e32 206e 6574 5f61 6464 5f64 6e73 .4.2 net_add_dns │ │ │ │ │ -00037670: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ │ -00037680: 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 ---.. -- Command │ │ │ │ │ -00037690: 3a20 6e65 745f 6164 645f 646e 7320 5345 : net_add_dns SE │ │ │ │ │ -000376a0: 5256 4552 0a20 2020 2020 5265 736f 6c76 RVER. Resolv │ │ │ │ │ -000376b0: 6520 5345 5256 4552 2049 5020 6164 6472 e SERVER IP addr │ │ │ │ │ -000376c0: 6573 7320 616e 6420 6164 6420 746f 2074 ess and add to t │ │ │ │ │ -000376d0: 6865 206c 6973 7420 6f66 2044 4e53 2073 he list of DNS s │ │ │ │ │ -000376e0: 6572 7665 7273 2075 7365 640a 2020 2020 ervers used. │ │ │ │ │ -000376f0: 2064 7572 696e 6720 6e61 6d65 206c 6f6f during name loo │ │ │ │ │ -00037700: 6b75 702e 0a0a 1f0a 4669 6c65 3a20 6772 kup.....File: gr │ │ │ │ │ -00037710: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ -00037720: 6e65 745f 6164 645f 726f 7574 652c 2020 net_add_route, │ │ │ │ │ -00037730: 4e65 7874 3a20 6e65 745f 626f 6f74 702c Next: net_bootp, │ │ │ │ │ -00037740: 2020 5072 6576 3a20 6e65 745f 6164 645f Prev: net_add_ │ │ │ │ │ -00037750: 646e 732c 2020 5570 3a20 4e65 7477 6f72 dns, Up: Networ │ │ │ │ │ -00037760: 6b69 6e67 2063 6f6d 6d61 6e64 730a 0a31 king commands..1 │ │ │ │ │ -00037770: 362e 342e 3320 6e65 745f 6164 645f 726f 6.4.3 net_add_ro │ │ │ │ │ -00037780: 7574 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ute.------------ │ │ │ │ │ -00037790: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ │ -000377a0: 6d6d 616e 643a 206e 6574 5f61 6464 5f72 mmand: net_add_r │ │ │ │ │ -000377b0: 6f75 7465 2053 484f 5254 4e41 4d45 2049 oute SHORTNAME I │ │ │ │ │ -000377c0: 505b 2f50 5245 4649 585d 205b 494e 5445 P[/PREFIX] [INTE │ │ │ │ │ -000377d0: 5246 4143 4520 7c20 6777 0a20 2020 2020 RFACE | gw. │ │ │ │ │ -000377e0: 2020 2020 2047 4154 4557 4159 5d0a 2020 GATEWAY]. │ │ │ │ │ -000377f0: 2020 2041 6464 2072 6f75 7465 2074 6f20 Add route to │ │ │ │ │ -00037800: 6e65 7477 6f72 6b20 7769 7468 2061 6464 network with add │ │ │ │ │ -00037810: 7265 7373 2049 5020 6173 206d 6f64 6966 ress IP as modif │ │ │ │ │ -00037820: 6965 6420 6279 2050 5245 4649 5820 7669 ied by PREFIX vi │ │ │ │ │ -00037830: 610a 2020 2020 2065 6974 6865 7220 6c6f a. either lo │ │ │ │ │ -00037840: 6361 6c20 494e 5445 5246 4143 4520 6f72 cal INTERFACE or │ │ │ │ │ -00037850: 2047 4154 4557 4159 2e20 2050 5245 4649 GATEWAY. PREFI │ │ │ │ │ -00037860: 5820 6973 206f 7074 696f 6e61 6c20 616e X is optional an │ │ │ │ │ -00037870: 6420 6465 6661 756c 7473 0a20 2020 2020 d defaults. │ │ │ │ │ -00037880: 746f 2033 3220 666f 7220 4950 7634 2061 to 32 for IPv4 a │ │ │ │ │ -00037890: 6464 7265 7373 2061 6e64 2031 3238 2066 ddress and 128 f │ │ │ │ │ -000378a0: 6f72 2049 5076 3620 6164 6472 6573 732e or IPv6 address. │ │ │ │ │ -000378b0: 2020 526f 7574 6520 6973 0a20 2020 2020 Route is. │ │ │ │ │ -000378c0: 6964 656e 7469 6669 6564 2062 7920 5348 identified by SH │ │ │ │ │ -000378d0: 4f52 544e 414d 4520 7768 6963 6820 6361 ORTNAME which ca │ │ │ │ │ -000378e0: 6e20 6265 2075 7365 6420 746f 2072 656d n be used to rem │ │ │ │ │ -000378f0: 6f76 6520 6974 2028 2a6e 6f74 650a 2020 ove it (*note. │ │ │ │ │ -00037900: 2020 206e 6574 5f64 656c 5f72 6f75 7465 net_del_route │ │ │ │ │ -00037910: 3a3a 292e 0a0a 1f0a 4669 6c65 3a20 6772 ::).....File: gr │ │ │ │ │ -00037920: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ -00037930: 6e65 745f 626f 6f74 702c 2020 4e65 7874 net_bootp, Next │ │ │ │ │ -00037940: 3a20 6e65 745f 6465 6c5f 6164 6472 2c20 : net_del_addr, │ │ │ │ │ -00037950: 2050 7265 763a 206e 6574 5f61 6464 5f72 Prev: net_add_r │ │ │ │ │ -00037960: 6f75 7465 2c20 2055 703a 204e 6574 776f oute, Up: Netwo │ │ │ │ │ -00037970: 726b 696e 6720 636f 6d6d 616e 6473 0a0a rking commands.. │ │ │ │ │ -00037980: 3136 2e34 2e34 206e 6574 5f62 6f6f 7470 16.4.4 net_bootp │ │ │ │ │ -00037990: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ │ -000379a0: 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 -.. -- Command: │ │ │ │ │ -000379b0: 6e65 745f 626f 6f74 7020 5b43 4152 445d net_bootp [CARD] │ │ │ │ │ -000379c0: 0a20 2020 2020 416c 6961 7320 666f 7220 . Alias for │ │ │ │ │ -000379d0: 6e65 745f 6468 6370 2c20 666f 7220 636f net_dhcp, for co │ │ │ │ │ -000379e0: 6d70 6174 6962 696c 6974 7920 7769 7468 mpatibility with │ │ │ │ │ -000379f0: 206f 6c64 6572 2047 7275 6220 7665 7273 older Grub vers │ │ │ │ │ -00037a00: 696f 6e73 2e0a 2020 2020 2057 696c 6c20 ions.. Will │ │ │ │ │ -00037a10: 7065 7266 6f72 6d20 7468 6520 7361 6d65 perform the same │ │ │ │ │ -00037a20: 2044 4843 5020 6861 6e64 7368 616b 6520 DHCP handshake │ │ │ │ │ -00037a30: 7769 7468 2070 6f74 656e 7469 616c 2066 with potential f │ │ │ │ │ -00037a40: 616c 6c62 6163 6b20 746f 0a20 2020 2020 allback to. │ │ │ │ │ -00037a50: 424f 4f54 5020 6173 2074 6865 206e 6574 BOOTP as the net │ │ │ │ │ -00037a60: 5f64 6863 7020 636f 6d6d 616e 6420 282a _dhcp command (* │ │ │ │ │ -00037a70: 6e6f 7465 206e 6574 5f64 6863 703a 3a29 note net_dhcp::) │ │ │ │ │ -00037a80: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ -00037a90: 696e 666f 2c20 204e 6f64 653a 206e 6574 info, Node: net │ │ │ │ │ -00037aa0: 5f64 656c 5f61 6464 722c 2020 4e65 7874 _del_addr, Next │ │ │ │ │ -00037ab0: 3a20 6e65 745f 6465 6c5f 646e 732c 2020 : net_del_dns, │ │ │ │ │ -00037ac0: 5072 6576 3a20 6e65 745f 626f 6f74 702c Prev: net_bootp, │ │ │ │ │ -00037ad0: 2020 5570 3a20 4e65 7477 6f72 6b69 6e67 Up: Networking │ │ │ │ │ -00037ae0: 2063 6f6d 6d61 6e64 730a 0a31 362e 342e commands..16.4. │ │ │ │ │ -00037af0: 3520 6e65 745f 6465 6c5f 6164 6472 0a2d 5 net_del_addr.- │ │ │ │ │ +00037090: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a ==============.. │ │ │ │ │ +000370a0: 2a20 4d65 6e75 3a0a 0a2a 206e 6574 5f61 * Menu:..* net_a │ │ │ │ │ +000370b0: 6464 5f61 6464 723a 3a20 2020 2020 2020 dd_addr:: │ │ │ │ │ +000370c0: 2020 2020 2020 2020 2041 6464 2061 206e Add a n │ │ │ │ │ +000370d0: 6574 776f 726b 2061 6464 7265 7373 0a2a etwork address.* │ │ │ │ │ +000370e0: 206e 6574 5f61 6464 5f64 6e73 3a3a 2020 net_add_dns:: │ │ │ │ │ +000370f0: 2020 2020 2020 2020 2020 2020 2020 2041 A │ │ │ │ │ +00037100: 6464 2061 2044 4e53 2073 6572 7665 720a dd a DNS server. │ │ │ │ │ +00037110: 2a20 6e65 745f 6164 645f 726f 7574 653a * net_add_route: │ │ │ │ │ +00037120: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00037130: 4164 6420 726f 7574 696e 6720 656e 7472 Add routing entr │ │ │ │ │ +00037140: 790a 2a20 6e65 745f 626f 6f74 703a 3a20 y.* net_bootp:: │ │ │ │ │ +00037150: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00037160: 2020 5065 7266 6f72 6d20 6120 626f 6f74 Perform a boot │ │ │ │ │ +00037170: 702f 4448 4350 2061 7574 6f63 6f6e 6669 p/DHCP autoconfi │ │ │ │ │ +00037180: 6775 7261 7469 6f6e 0a2a 206e 6574 5f64 guration.* net_d │ │ │ │ │ +00037190: 656c 5f61 6464 723a 3a20 2020 2020 2020 el_addr:: │ │ │ │ │ +000371a0: 2020 2020 2020 2020 2052 656d 6f76 6520 Remove │ │ │ │ │ +000371b0: 4950 2061 6464 7265 7373 2066 726f 6d20 IP address from │ │ │ │ │ +000371c0: 696e 7465 7266 6163 650a 2a20 6e65 745f interface.* net_ │ │ │ │ │ +000371d0: 6465 6c5f 646e 733a 3a20 2020 2020 2020 del_dns:: │ │ │ │ │ +000371e0: 2020 2020 2020 2020 2020 5265 6d6f 7665 Remove │ │ │ │ │ +000371f0: 2061 2044 4e53 2073 6572 7665 720a 2a20 a DNS server.* │ │ │ │ │ +00037200: 6e65 745f 6465 6c5f 726f 7574 653a 3a20 net_del_route:: │ │ │ │ │ +00037210: 2020 2020 2020 2020 2020 2020 2020 5265 Re │ │ │ │ │ +00037220: 6d6f 7665 2061 2072 6f75 7465 2065 6e74 move a route ent │ │ │ │ │ +00037230: 7279 0a2a 206e 6574 5f64 6863 703a 3a20 ry.* net_dhcp:: │ │ │ │ │ +00037240: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00037250: 2020 2050 6572 666f 726d 2061 2044 4843 Perform a DHC │ │ │ │ │ +00037260: 5020 6175 746f 636f 6e66 6967 7572 6174 P autoconfigurat │ │ │ │ │ +00037270: 696f 6e0a 2a20 6e65 745f 6765 745f 6468 ion.* net_get_dh │ │ │ │ │ +00037280: 6370 5f6f 7074 696f 6e3a 3a20 2020 2020 cp_option:: │ │ │ │ │ +00037290: 2020 2020 5265 7472 6965 7665 2044 4843 Retrieve DHC │ │ │ │ │ +000372a0: 5020 6f70 7469 6f6e 730a 2a20 6e65 745f P options.* net_ │ │ │ │ │ +000372b0: 6970 7636 5f61 7574 6f63 6f6e 663a 3a20 ipv6_autoconf:: │ │ │ │ │ +000372c0: 2020 2020 2020 2020 2020 5065 7266 6f72 Perfor │ │ │ │ │ +000372d0: 6d20 4950 7636 2061 7574 6f63 6f6e 6669 m IPv6 autoconfi │ │ │ │ │ +000372e0: 6775 7261 7469 6f6e 0a2a 206e 6574 5f6c guration.* net_l │ │ │ │ │ +000372f0: 735f 6164 6472 3a3a 2020 2020 2020 2020 s_addr:: │ │ │ │ │ +00037300: 2020 2020 2020 2020 204c 6973 7420 696e List in │ │ │ │ │ +00037310: 7465 7266 6163 6573 0a2a 206e 6574 5f6c terfaces.* net_l │ │ │ │ │ +00037320: 735f 6361 7264 733a 3a20 2020 2020 2020 s_cards:: │ │ │ │ │ +00037330: 2020 2020 2020 2020 204c 6973 7420 6e65 List ne │ │ │ │ │ +00037340: 7477 6f72 6b20 6361 7264 730a 2a20 6e65 twork cards.* ne │ │ │ │ │ +00037350: 745f 6c73 5f64 6e73 3a3a 2020 2020 2020 t_ls_dns:: │ │ │ │ │ +00037360: 2020 2020 2020 2020 2020 2020 4c69 7374 List │ │ │ │ │ +00037370: 2044 4e53 2073 6572 7665 7273 0a2a 206e DNS servers.* n │ │ │ │ │ +00037380: 6574 5f6c 735f 726f 7574 6573 3a3a 2020 et_ls_routes:: │ │ │ │ │ +00037390: 2020 2020 2020 2020 2020 2020 204c 6973 Lis │ │ │ │ │ +000373a0: 7420 726f 7574 696e 6720 656e 7472 6965 t routing entrie │ │ │ │ │ +000373b0: 730a 2a20 6e65 745f 6e73 6c6f 6f6b 7570 s.* net_nslookup │ │ │ │ │ +000373c0: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ │ +000373d0: 2020 5065 7266 6f72 6d20 6120 444e 5320 Perform a DNS │ │ │ │ │ +000373e0: 6c6f 6f6b 7570 0a0a 1f0a 4669 6c65 3a20 lookup....File: │ │ │ │ │ +000373f0: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ +00037400: 3a20 6e65 745f 6164 645f 6164 6472 2c20 : net_add_addr, │ │ │ │ │ +00037410: 204e 6578 743a 206e 6574 5f61 6464 5f64 Next: net_add_d │ │ │ │ │ +00037420: 6e73 2c20 2055 703a 204e 6574 776f 726b ns, Up: Network │ │ │ │ │ +00037430: 696e 6720 636f 6d6d 616e 6473 0a0a 3136 ing commands..16 │ │ │ │ │ +00037440: 2e34 2e31 206e 6574 5f61 6464 5f61 6464 .4.1 net_add_add │ │ │ │ │ +00037450: 720a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d r.-------------- │ │ │ │ │ +00037460: 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 -----.. -- Comma │ │ │ │ │ +00037470: 6e64 3a20 6e65 745f 6164 645f 6164 6472 nd: net_add_addr │ │ │ │ │ +00037480: 2049 4e54 4552 4641 4345 2043 4152 4420 INTERFACE CARD │ │ │ │ │ +00037490: 4144 4452 4553 530a 2020 2020 2043 6f6e ADDRESS. Con │ │ │ │ │ +000374a0: 6669 6775 7265 2061 6464 6974 696f 6e61 figure additiona │ │ │ │ │ +000374b0: 6c20 6e65 7477 6f72 6b20 494e 5445 5246 l network INTERF │ │ │ │ │ +000374c0: 4143 4520 7769 7468 2041 4444 5245 5353 ACE with ADDRESS │ │ │ │ │ +000374d0: 206f 6e20 6120 6e65 7477 6f72 6b0a 2020 on a network. │ │ │ │ │ +000374e0: 2020 2043 4152 442e 2020 4144 4452 4553 CARD. ADDRES │ │ │ │ │ +000374f0: 5320 6361 6e20 6265 2065 6974 6865 7220 S can be either │ │ │ │ │ +00037500: 4950 2069 6e20 646f 7474 6564 2064 6563 IP in dotted dec │ │ │ │ │ +00037510: 696d 616c 206e 6f74 6174 696f 6e2c 206f imal notation, o │ │ │ │ │ +00037520: 720a 2020 2020 2073 796d 626f 6c69 6320 r. symbolic │ │ │ │ │ +00037530: 6e61 6d65 2077 6869 6368 2069 7320 7265 name which is re │ │ │ │ │ +00037540: 736f 6c76 6564 2075 7369 6e67 2044 4e53 solved using DNS │ │ │ │ │ +00037550: 206c 6f6f 6b75 702e 2020 4966 2073 7563 lookup. If suc │ │ │ │ │ +00037560: 6365 7373 6675 6c2c 0a20 2020 2020 7468 cessful,. th │ │ │ │ │ +00037570: 6973 2063 6f6d 6d61 6e64 2061 6c73 6f20 is command also │ │ │ │ │ +00037580: 6164 6473 206c 6f63 616c 206c 696e 6b20 adds local link │ │ │ │ │ +00037590: 726f 7574 696e 6720 656e 7472 7920 746f routing entry to │ │ │ │ │ +000375a0: 2074 6865 2064 6566 6175 6c74 0a20 2020 the default. │ │ │ │ │ +000375b0: 2020 7375 626e 6574 206f 6620 4144 4452 subnet of ADDR │ │ │ │ │ +000375c0: 4553 5320 7769 7468 206e 616d 6520 494e ESS with name IN │ │ │ │ │ +000375d0: 5445 5246 4143 4527 3a6c 6f63 616c 2720 TERFACE':local' │ │ │ │ │ +000375e0: 7669 6120 494e 5445 5246 4143 452e 0a0a via INTERFACE... │ │ │ │ │ +000375f0: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ +00037600: 6f2c 2020 4e6f 6465 3a20 6e65 745f 6164 o, Node: net_ad │ │ │ │ │ +00037610: 645f 646e 732c 2020 4e65 7874 3a20 6e65 d_dns, Next: ne │ │ │ │ │ +00037620: 745f 6164 645f 726f 7574 652c 2020 5072 t_add_route, Pr │ │ │ │ │ +00037630: 6576 3a20 6e65 745f 6164 645f 6164 6472 ev: net_add_addr │ │ │ │ │ +00037640: 2c20 2055 703a 204e 6574 776f 726b 696e , Up: Networkin │ │ │ │ │ +00037650: 6720 636f 6d6d 616e 6473 0a0a 3136 2e34 g commands..16.4 │ │ │ │ │ +00037660: 2e32 206e 6574 5f61 6464 5f64 6e73 0a2d .2 net_add_dns.- │ │ │ │ │ +00037670: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ +00037680: 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 -.. -- Command: │ │ │ │ │ +00037690: 6e65 745f 6164 645f 646e 7320 5345 5256 net_add_dns SERV │ │ │ │ │ +000376a0: 4552 0a20 2020 2020 5265 736f 6c76 6520 ER. Resolve │ │ │ │ │ +000376b0: 5345 5256 4552 2049 5020 6164 6472 6573 SERVER IP addres │ │ │ │ │ +000376c0: 7320 616e 6420 6164 6420 746f 2074 6865 s and add to the │ │ │ │ │ +000376d0: 206c 6973 7420 6f66 2044 4e53 2073 6572 list of DNS ser │ │ │ │ │ +000376e0: 7665 7273 2075 7365 640a 2020 2020 2064 vers used. d │ │ │ │ │ +000376f0: 7572 696e 6720 6e61 6d65 206c 6f6f 6b75 uring name looku │ │ │ │ │ +00037700: 702e 0a0a 1f0a 4669 6c65 3a20 6772 7562 p.....File: grub │ │ │ │ │ +00037710: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 6e65 .info, Node: ne │ │ │ │ │ +00037720: 745f 6164 645f 726f 7574 652c 2020 4e65 t_add_route, Ne │ │ │ │ │ +00037730: 7874 3a20 6e65 745f 626f 6f74 702c 2020 xt: net_bootp, │ │ │ │ │ +00037740: 5072 6576 3a20 6e65 745f 6164 645f 646e Prev: net_add_dn │ │ │ │ │ +00037750: 732c 2020 5570 3a20 4e65 7477 6f72 6b69 s, Up: Networki │ │ │ │ │ +00037760: 6e67 2063 6f6d 6d61 6e64 730a 0a31 362e ng commands..16. │ │ │ │ │ +00037770: 342e 3320 6e65 745f 6164 645f 726f 7574 4.3 net_add_rout │ │ │ │ │ +00037780: 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d e.-------------- │ │ │ │ │ +00037790: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ │ +000377a0: 616e 643a 206e 6574 5f61 6464 5f72 6f75 and: net_add_rou │ │ │ │ │ +000377b0: 7465 2053 484f 5254 4e41 4d45 2049 505b te SHORTNAME IP[ │ │ │ │ │ +000377c0: 2f50 5245 4649 585d 205b 494e 5445 5246 /PREFIX] [INTERF │ │ │ │ │ +000377d0: 4143 4520 7c20 6777 0a20 2020 2020 2020 ACE | gw. │ │ │ │ │ +000377e0: 2020 2047 4154 4557 4159 5d0a 2020 2020 GATEWAY]. │ │ │ │ │ +000377f0: 2041 6464 2072 6f75 7465 2074 6f20 6e65 Add route to ne │ │ │ │ │ +00037800: 7477 6f72 6b20 7769 7468 2061 6464 7265 twork with addre │ │ │ │ │ +00037810: 7373 2049 5020 6173 206d 6f64 6966 6965 ss IP as modifie │ │ │ │ │ +00037820: 6420 6279 2050 5245 4649 5820 7669 610a d by PREFIX via. │ │ │ │ │ +00037830: 2020 2020 2065 6974 6865 7220 6c6f 6361 either loca │ │ │ │ │ +00037840: 6c20 494e 5445 5246 4143 4520 6f72 2047 l INTERFACE or G │ │ │ │ │ +00037850: 4154 4557 4159 2e20 2050 5245 4649 5820 ATEWAY. PREFIX │ │ │ │ │ +00037860: 6973 206f 7074 696f 6e61 6c20 616e 6420 is optional and │ │ │ │ │ +00037870: 6465 6661 756c 7473 0a20 2020 2020 746f defaults. to │ │ │ │ │ +00037880: 2033 3220 666f 7220 4950 7634 2061 6464 32 for IPv4 add │ │ │ │ │ +00037890: 7265 7373 2061 6e64 2031 3238 2066 6f72 ress and 128 for │ │ │ │ │ +000378a0: 2049 5076 3620 6164 6472 6573 732e 2020 IPv6 address. │ │ │ │ │ +000378b0: 526f 7574 6520 6973 0a20 2020 2020 6964 Route is. id │ │ │ │ │ +000378c0: 656e 7469 6669 6564 2062 7920 5348 4f52 entified by SHOR │ │ │ │ │ +000378d0: 544e 414d 4520 7768 6963 6820 6361 6e20 TNAME which can │ │ │ │ │ +000378e0: 6265 2075 7365 6420 746f 2072 656d 6f76 be used to remov │ │ │ │ │ +000378f0: 6520 6974 2028 2a6e 6f74 650a 2020 2020 e it (*note. │ │ │ │ │ +00037900: 206e 6574 5f64 656c 5f72 6f75 7465 3a3a net_del_route:: │ │ │ │ │ +00037910: 292e 0a0a 1f0a 4669 6c65 3a20 6772 7562 ).....File: grub │ │ │ │ │ +00037920: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 6e65 .info, Node: ne │ │ │ │ │ +00037930: 745f 626f 6f74 702c 2020 4e65 7874 3a20 t_bootp, Next: │ │ │ │ │ +00037940: 6e65 745f 6465 6c5f 6164 6472 2c20 2050 net_del_addr, P │ │ │ │ │ +00037950: 7265 763a 206e 6574 5f61 6464 5f72 6f75 rev: net_add_rou │ │ │ │ │ +00037960: 7465 2c20 2055 703a 204e 6574 776f 726b te, Up: Network │ │ │ │ │ +00037970: 696e 6720 636f 6d6d 616e 6473 0a0a 3136 ing commands..16 │ │ │ │ │ +00037980: 2e34 2e34 206e 6574 5f62 6f6f 7470 0a2d .4.4 net_bootp.- │ │ │ │ │ +00037990: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ +000379a0: 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 6e65 . -- Command: ne │ │ │ │ │ +000379b0: 745f 626f 6f74 7020 5b43 4152 445d 0a20 t_bootp [CARD]. │ │ │ │ │ +000379c0: 2020 2020 416c 6961 7320 666f 7220 6e65 Alias for ne │ │ │ │ │ +000379d0: 745f 6468 6370 2c20 666f 7220 636f 6d70 t_dhcp, for comp │ │ │ │ │ +000379e0: 6174 6962 696c 6974 7920 7769 7468 206f atibility with o │ │ │ │ │ +000379f0: 6c64 6572 2047 7275 6220 7665 7273 696f lder Grub versio │ │ │ │ │ +00037a00: 6e73 2e0a 2020 2020 2057 696c 6c20 7065 ns.. Will pe │ │ │ │ │ +00037a10: 7266 6f72 6d20 7468 6520 7361 6d65 2044 rform the same D │ │ │ │ │ +00037a20: 4843 5020 6861 6e64 7368 616b 6520 7769 HCP handshake wi │ │ │ │ │ +00037a30: 7468 2070 6f74 656e 7469 616c 2066 616c th potential fal │ │ │ │ │ +00037a40: 6c62 6163 6b20 746f 0a20 2020 2020 424f lback to. BO │ │ │ │ │ +00037a50: 4f54 5020 6173 2074 6865 206e 6574 5f64 OTP as the net_d │ │ │ │ │ +00037a60: 6863 7020 636f 6d6d 616e 6420 282a 6e6f hcp command (*no │ │ │ │ │ +00037a70: 7465 206e 6574 5f64 6863 703a 3a29 2e0a te net_dhcp::).. │ │ │ │ │ +00037a80: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ +00037a90: 666f 2c20 204e 6f64 653a 206e 6574 5f64 fo, Node: net_d │ │ │ │ │ +00037aa0: 656c 5f61 6464 722c 2020 4e65 7874 3a20 el_addr, Next: │ │ │ │ │ +00037ab0: 6e65 745f 6465 6c5f 646e 732c 2020 5072 net_del_dns, Pr │ │ │ │ │ +00037ac0: 6576 3a20 6e65 745f 626f 6f74 702c 2020 ev: net_bootp, │ │ │ │ │ +00037ad0: 5570 3a20 4e65 7477 6f72 6b69 6e67 2063 Up: Networking c │ │ │ │ │ +00037ae0: 6f6d 6d61 6e64 730a 0a31 362e 342e 3520 ommands..16.4.5 │ │ │ │ │ +00037af0: 6e65 745f 6465 6c5f 6164 6472 0a2d 2d2d net_del_addr.--- │ │ │ │ │ 00037b00: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00037b10: 2d2d 0a0a 202d 2d20 436f 6d6d 616e 643a --.. -- Command: │ │ │ │ │ -00037b20: 206e 6574 5f64 656c 5f61 6464 7220 494e net_del_addr IN │ │ │ │ │ -00037b30: 5445 5246 4143 450a 2020 2020 2052 656d TERFACE. Rem │ │ │ │ │ -00037b40: 6f76 6520 636f 6e66 6967 7572 6564 2049 ove configured I │ │ │ │ │ -00037b50: 4e54 4552 4641 4345 2077 6974 6820 6173 NTERFACE with as │ │ │ │ │ -00037b60: 736f 6369 6174 6564 2061 6464 7265 7373 sociated address │ │ │ │ │ -00037b70: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ -00037b80: 696e 666f 2c20 204e 6f64 653a 206e 6574 info, Node: net │ │ │ │ │ -00037b90: 5f64 656c 5f64 6e73 2c20 204e 6578 743a _del_dns, Next: │ │ │ │ │ -00037ba0: 206e 6574 5f64 656c 5f72 6f75 7465 2c20 net_del_route, │ │ │ │ │ -00037bb0: 2050 7265 763a 206e 6574 5f64 656c 5f61 Prev: net_del_a │ │ │ │ │ -00037bc0: 6464 722c 2020 5570 3a20 4e65 7477 6f72 ddr, Up: Networ │ │ │ │ │ -00037bd0: 6b69 6e67 2063 6f6d 6d61 6e64 730a 0a31 king commands..1 │ │ │ │ │ -00037be0: 362e 342e 3620 6e65 745f 6465 6c5f 646e 6.4.6 net_del_dn │ │ │ │ │ -00037bf0: 730a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d s.-------------- │ │ │ │ │ -00037c00: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ │ -00037c10: 643a 206e 6574 5f64 656c 5f64 6e73 2041 d: net_del_dns A │ │ │ │ │ -00037c20: 4444 5245 5353 0a20 2020 2020 5265 6d6f DDRESS. Remo │ │ │ │ │ -00037c30: 7665 2041 4444 5245 5353 2066 726f 6d20 ve ADDRESS from │ │ │ │ │ -00037c40: 6c69 7374 206f 6620 7365 7276 6572 7320 list of servers │ │ │ │ │ -00037c50: 7573 6564 2064 7572 696e 6720 6e61 6d65 used during name │ │ │ │ │ -00037c60: 206c 6f6f 6b75 702e 0a0a 1f0a 4669 6c65 lookup.....File │ │ │ │ │ -00037c70: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ -00037c80: 6465 3a20 6e65 745f 6465 6c5f 726f 7574 de: net_del_rout │ │ │ │ │ -00037c90: 652c 2020 4e65 7874 3a20 6e65 745f 6468 e, Next: net_dh │ │ │ │ │ -00037ca0: 6370 2c20 2050 7265 763a 206e 6574 5f64 cp, Prev: net_d │ │ │ │ │ -00037cb0: 656c 5f64 6e73 2c20 2055 703a 204e 6574 el_dns, Up: Net │ │ │ │ │ -00037cc0: 776f 726b 696e 6720 636f 6d6d 616e 6473 working commands │ │ │ │ │ -00037cd0: 0a0a 3136 2e34 2e37 206e 6574 5f64 656c ..16.4.7 net_del │ │ │ │ │ -00037ce0: 5f72 6f75 7465 0a2d 2d2d 2d2d 2d2d 2d2d _route.--------- │ │ │ │ │ -00037cf0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d -----------.. -- │ │ │ │ │ -00037d00: 2043 6f6d 6d61 6e64 3a20 6e65 745f 6465 Command: net_de │ │ │ │ │ -00037d10: 6c5f 726f 7574 6520 5348 4f52 544e 414d l_route SHORTNAM │ │ │ │ │ -00037d20: 450a 2020 2020 2052 656d 6f76 6520 726f E. Remove ro │ │ │ │ │ -00037d30: 7574 6520 656e 7472 7920 6964 656e 7469 ute entry identi │ │ │ │ │ -00037d40: 6669 6564 2062 7920 5348 4f52 544e 414d fied by SHORTNAM │ │ │ │ │ -00037d50: 452e 0a0a 1f0a 4669 6c65 3a20 6772 7562 E.....File: grub │ │ │ │ │ -00037d60: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 6e65 .info, Node: ne │ │ │ │ │ -00037d70: 745f 6468 6370 2c20 204e 6578 743a 206e t_dhcp, Next: n │ │ │ │ │ -00037d80: 6574 5f67 6574 5f64 6863 705f 6f70 7469 et_get_dhcp_opti │ │ │ │ │ -00037d90: 6f6e 2c20 2050 7265 763a 206e 6574 5f64 on, Prev: net_d │ │ │ │ │ -00037da0: 656c 5f72 6f75 7465 2c20 2055 703a 204e el_route, Up: N │ │ │ │ │ -00037db0: 6574 776f 726b 696e 6720 636f 6d6d 616e etworking comman │ │ │ │ │ -00037dc0: 6473 0a0a 3136 2e34 2e38 206e 6574 5f64 ds..16.4.8 net_d │ │ │ │ │ -00037dd0: 6863 700a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d hcp.------------ │ │ │ │ │ -00037de0: 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 ---.. -- Command │ │ │ │ │ -00037df0: 3a20 6e65 745f 6468 6370 205b 4341 5244 : net_dhcp [CARD │ │ │ │ │ -00037e00: 5d0a 2020 2020 2050 6572 666f 726d 2063 ]. Perform c │ │ │ │ │ -00037e10: 6f6e 6669 6775 7261 7469 6f6e 206f 6620 onfiguration of │ │ │ │ │ -00037e20: 4341 5244 2075 7369 6e67 2044 4843 5020 CARD using DHCP │ │ │ │ │ -00037e30: 7072 6f74 6f63 6f6c 2e20 2049 6620 6e6f protocol. If no │ │ │ │ │ -00037e40: 2063 6172 6420 6e61 6d65 0a20 2020 2020 card name. │ │ │ │ │ -00037e50: 6973 2073 7065 6369 6669 6564 2c20 7472 is specified, tr │ │ │ │ │ -00037e60: 7920 746f 2063 6f6e 6669 6775 7265 2061 y to configure a │ │ │ │ │ -00037e70: 6c6c 2065 7869 7374 696e 6720 6361 7264 ll existing card │ │ │ │ │ -00037e80: 732e 2020 4661 6c6c 7320 6261 636b 2074 s. Falls back t │ │ │ │ │ -00037e90: 6f0a 2020 2020 2074 6865 2042 4f4f 5450 o. the BOOTP │ │ │ │ │ -00037ea0: 2070 726f 746f 636f 6c2c 2069 6620 6e65 protocol, if ne │ │ │ │ │ -00037eb0: 6564 6564 2e20 2049 6620 636f 6e66 6967 eded. If config │ │ │ │ │ -00037ec0: 7572 6174 696f 6e20 7761 7320 7375 6363 uration was succ │ │ │ │ │ -00037ed0: 6573 7366 756c 2c0a 2020 2020 2069 6e74 essful,. int │ │ │ │ │ -00037ee0: 6572 6661 6365 2077 6974 6820 6e61 6d65 erface with name │ │ │ │ │ -00037ef0: 2043 4152 4427 3a64 6863 7027 2061 6e64 CARD':dhcp' and │ │ │ │ │ -00037f00: 2063 6f6e 6669 6775 7265 6420 6164 6472 configured addr │ │ │ │ │ -00037f10: 6573 7320 6973 2061 6464 6564 2074 6f0a ess is added to. │ │ │ │ │ -00037f20: 2020 2020 2043 4152 442e 2020 4164 6469 CARD. Addi │ │ │ │ │ -00037f30: 7469 6f6e 616c 6c79 2074 6865 2066 6f6c tionally the fol │ │ │ │ │ -00037f40: 6c6f 7769 6e67 2044 4843 5020 6f70 7469 lowing DHCP opti │ │ │ │ │ -00037f50: 6f6e 7320 6172 6520 7265 636f 676e 697a ons are recogniz │ │ │ │ │ -00037f60: 6564 2061 6e64 0a20 2020 2020 7072 6f63 ed and. proc │ │ │ │ │ -00037f70: 6573 7365 643a 0a0a 2020 2020 2027 3120 essed:.. '1 │ │ │ │ │ -00037f80: 2853 7562 6e65 7420 4d61 736b 2927 0a20 (Subnet Mask)'. │ │ │ │ │ -00037f90: 2020 2020 2020 2020 2055 7365 6420 746f Used to │ │ │ │ │ -00037fa0: 2063 616c 6375 6c61 7465 206e 6574 776f calculate netwo │ │ │ │ │ -00037fb0: 726b 206c 6f63 616c 2072 6f75 7469 6e67 rk local routing │ │ │ │ │ -00037fc0: 2065 6e74 7279 2066 6f72 2069 6e74 6572 entry for inter │ │ │ │ │ -00037fd0: 6661 6365 0a20 2020 2020 2020 2020 2043 face. C │ │ │ │ │ -00037fe0: 4152 4427 3a64 6863 7027 2e0a 2020 2020 ARD':dhcp'.. │ │ │ │ │ -00037ff0: 2027 3320 2852 6f75 7465 7229 270a 2020 '3 (Router)'. │ │ │ │ │ -00038000: 2020 2020 2020 2020 4164 6473 2064 6566 Adds def │ │ │ │ │ -00038010: 6175 6c74 2072 6f75 7465 2065 6e74 7279 ault route entry │ │ │ │ │ -00038020: 2077 6974 6820 7468 6520 6e61 6d65 2043 with the name C │ │ │ │ │ -00038030: 4152 4427 3a64 6863 703a 6465 6661 756c ARD':dhcp:defaul │ │ │ │ │ -00038040: 7427 2076 6961 0a20 2020 2020 2020 2020 t' via. │ │ │ │ │ -00038050: 2067 6174 6577 6179 2066 726f 6d20 4448 gateway from DH │ │ │ │ │ -00038060: 4350 206f 7074 696f 6e2e 2020 4e6f 7465 CP option. Note │ │ │ │ │ -00038070: 2074 6861 7420 6f6e 6c79 206f 7074 696f that only optio │ │ │ │ │ -00038080: 6e20 7769 7468 2073 696e 676c 650a 2020 n with single. │ │ │ │ │ -00038090: 2020 2020 2020 2020 726f 7574 6520 6973 route is │ │ │ │ │ -000380a0: 2061 6363 6570 7465 642e 0a20 2020 2020 accepted.. │ │ │ │ │ -000380b0: 2736 2028 446f 6d61 696e 204e 616d 6520 '6 (Domain Name │ │ │ │ │ -000380c0: 5365 7276 6572 2927 0a20 2020 2020 2020 Server)'. │ │ │ │ │ -000380d0: 2020 2041 6464 7320 616c 6c20 7365 7276 Adds all serv │ │ │ │ │ -000380e0: 6572 7320 6672 6f6d 206f 7074 696f 6e20 ers from option │ │ │ │ │ -000380f0: 7661 6c75 6520 746f 2074 6865 206c 6973 value to the lis │ │ │ │ │ -00038100: 7420 6f66 2073 6572 7665 7273 2075 7365 t of servers use │ │ │ │ │ -00038110: 640a 2020 2020 2020 2020 2020 6475 7269 d. duri │ │ │ │ │ -00038120: 6e67 206e 616d 6520 7265 736f 6c75 7469 ng name resoluti │ │ │ │ │ -00038130: 6f6e 2e0a 2020 2020 2027 3132 2028 486f on.. '12 (Ho │ │ │ │ │ -00038140: 7374 204e 616d 6529 270a 2020 2020 2020 st Name)'. │ │ │ │ │ -00038150: 2020 2020 5365 7473 2065 6e76 6972 6f6e Sets environ │ │ │ │ │ -00038160: 6d65 6e74 2076 6172 6961 626c 6520 276e ment variable 'n │ │ │ │ │ -00038170: 6574 5f27 3c43 4152 443e 275f 6468 6370 et_''_dhcp │ │ │ │ │ -00038180: 5f68 6f73 746e 616d 6527 2028 2a6e 6f74 _hostname' (*not │ │ │ │ │ -00038190: 650a 2020 2020 2020 2020 2020 6e65 745f e. net_ │ │ │ │ │ -000381a0: 3c49 4e54 4552 4641 4345 3e5f 686f 7374 _host │ │ │ │ │ -000381b0: 6e61 6d65 3a3a 2920 746f 2074 6865 2076 name::) to the v │ │ │ │ │ -000381c0: 616c 7565 206f 6620 6f70 7469 6f6e 2e0a alue of option.. │ │ │ │ │ -000381d0: 2020 2020 2027 3135 2028 446f 6d61 696e '15 (Domain │ │ │ │ │ -000381e0: 204e 616d 6529 270a 2020 2020 2020 2020 Name)'. │ │ │ │ │ -000381f0: 2020 5365 7473 2065 6e76 6972 6f6e 6d65 Sets environme │ │ │ │ │ -00038200: 6e74 2076 6172 6961 626c 6520 276e 6574 nt variable 'net │ │ │ │ │ -00038210: 5f27 3c43 4152 443e 275f 6468 6370 5f64 _''_dhcp_d │ │ │ │ │ -00038220: 6f6d 6169 6e27 2028 2a6e 6f74 650a 2020 omain' (*note. │ │ │ │ │ -00038230: 2020 2020 2020 2020 6e65 745f 3c49 4e54 net__domain:: │ │ │ │ │ -00038250: 2920 746f 2074 6865 2076 616c 7565 206f ) to the value o │ │ │ │ │ -00038260: 6620 6f70 7469 6f6e 2e0a 2020 2020 2027 f option.. ' │ │ │ │ │ -00038270: 3137 2028 526f 6f74 2050 6174 6829 270a 17 (Root Path)'. │ │ │ │ │ -00038280: 2020 2020 2020 2020 2020 5365 7473 2065 Sets e │ │ │ │ │ -00038290: 6e76 6972 6f6e 6d65 6e74 2076 6172 6961 nvironment varia │ │ │ │ │ -000382a0: 626c 6520 276e 6574 5f27 3c43 4152 443e ble 'net_' │ │ │ │ │ -000382b0: 275f 6468 6370 5f72 6f6f 7470 6174 6827 '_dhcp_rootpath' │ │ │ │ │ -000382c0: 2028 2a6e 6f74 650a 2020 2020 2020 2020 (*note. │ │ │ │ │ -000382d0: 2020 6e65 745f 3c49 4e54 4552 4641 4345 net__rootpath::) to │ │ │ │ │ -000382f0: 2074 6865 2076 616c 7565 206f 6620 6f70 the value of op │ │ │ │ │ -00038300: 7469 6f6e 2e0a 2020 2020 2027 3138 2028 tion.. '18 ( │ │ │ │ │ -00038310: 4578 7465 6e73 696f 6e73 2050 6174 6829 Extensions Path) │ │ │ │ │ -00038320: 270a 2020 2020 2020 2020 2020 5365 7473 '. Sets │ │ │ │ │ -00038330: 2065 6e76 6972 6f6e 6d65 6e74 2076 6172 environment var │ │ │ │ │ -00038340: 6961 626c 6520 276e 6574 5f27 3c43 4152 iable 'net_''_dhcp_extensi │ │ │ │ │ -00038360: 6f6e 7370 6174 6827 0a20 2020 2020 2020 onspath'. │ │ │ │ │ -00038370: 2020 2028 2a6e 6f74 6520 6e65 745f 3c49 (*note net__extens │ │ │ │ │ -00038390: 696f 6e73 7061 7468 3a3a 2920 746f 2074 ionspath::) to t │ │ │ │ │ -000383a0: 6865 2076 616c 7565 206f 660a 2020 2020 he value of. │ │ │ │ │ -000383b0: 2020 2020 2020 6f70 7469 6f6e 2e0a 2020 option.. │ │ │ │ │ -000383c0: 2020 2027 3636 2028 5446 5450 2053 6572 '66 (TFTP Ser │ │ │ │ │ -000383d0: 7665 7220 4e61 6d65 2927 0a20 2020 2020 ver Name)'. │ │ │ │ │ -000383e0: 2020 2020 2053 6574 7320 656e 7669 726f Sets enviro │ │ │ │ │ -000383f0: 6e6d 656e 7420 7661 7269 6162 6c65 2027 nment variable ' │ │ │ │ │ -00038400: 6e65 745f 273c 4341 5244 3e27 5f64 6863 net_''_dhc │ │ │ │ │ -00038410: 705f 7365 7276 6572 5f6e 616d 6527 0a20 p_server_name'. │ │ │ │ │ -00038420: 2020 2020 2020 2020 2028 2a6e 6f74 6520 (*note │ │ │ │ │ -00038430: 6e65 745f 3c49 4e54 4552 4641 4345 3e5f net__ │ │ │ │ │ -00038440: 6468 6370 5f73 6572 7665 725f 6e61 6d65 dhcp_server_name │ │ │ │ │ -00038450: 3a3a 2920 746f 2074 6865 2076 616c 7565 ::) to the value │ │ │ │ │ -00038460: 206f 660a 2020 2020 2020 2020 2020 6f70 of. op │ │ │ │ │ -00038470: 7469 6f6e 2e0a 2020 2020 2027 3637 2028 tion.. '67 ( │ │ │ │ │ -00038480: 4669 6c65 6e61 6d65 2927 0a20 2020 2020 Filename)'. │ │ │ │ │ -00038490: 2020 2020 2053 6574 7320 656e 7669 726f Sets enviro │ │ │ │ │ -000384a0: 6e6d 656e 7420 7661 7269 6162 6c65 2027 nment variable ' │ │ │ │ │ -000384b0: 6e65 745f 273c 4341 5244 3e27 5f62 6f6f net_''_boo │ │ │ │ │ -000384c0: 745f 6669 6c65 2720 282a 6e6f 7465 0a20 t_file' (*note. │ │ │ │ │ -000384d0: 2020 2020 2020 2020 206e 6574 5f3c 494e net__boot_fi │ │ │ │ │ -000384f0: 6c65 3a3a 2920 746f 2074 6865 2076 616c le::) to the val │ │ │ │ │ -00038500: 7565 206f 6620 6f70 7469 6f6e 2e0a 0a1f ue of option.... │ │ │ │ │ -00038510: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ -00038520: 2c20 204e 6f64 653a 206e 6574 5f67 6574 , Node: net_get │ │ │ │ │ -00038530: 5f64 6863 705f 6f70 7469 6f6e 2c20 204e _dhcp_option, N │ │ │ │ │ -00038540: 6578 743a 206e 6574 5f69 7076 365f 6175 ext: net_ipv6_au │ │ │ │ │ -00038550: 746f 636f 6e66 2c20 2050 7265 763a 206e toconf, Prev: n │ │ │ │ │ -00038560: 6574 5f64 6863 702c 2020 5570 3a20 4e65 et_dhcp, Up: Ne │ │ │ │ │ -00038570: 7477 6f72 6b69 6e67 2063 6f6d 6d61 6e64 tworking command │ │ │ │ │ -00038580: 730a 0a31 362e 342e 3920 6e65 745f 6765 s..16.4.9 net_ge │ │ │ │ │ -00038590: 745f 6468 6370 5f6f 7074 696f 6e0a 2d2d t_dhcp_option.-- │ │ │ │ │ +00037b10: 0a0a 202d 2d20 436f 6d6d 616e 643a 206e .. -- Command: n │ │ │ │ │ +00037b20: 6574 5f64 656c 5f61 6464 7220 494e 5445 et_del_addr INTE │ │ │ │ │ +00037b30: 5246 4143 450a 2020 2020 2052 656d 6f76 RFACE. Remov │ │ │ │ │ +00037b40: 6520 636f 6e66 6967 7572 6564 2049 4e54 e configured INT │ │ │ │ │ +00037b50: 4552 4641 4345 2077 6974 6820 6173 736f ERFACE with asso │ │ │ │ │ +00037b60: 6369 6174 6564 2061 6464 7265 7373 2e0a ciated address.. │ │ │ │ │ +00037b70: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ +00037b80: 666f 2c20 204e 6f64 653a 206e 6574 5f64 fo, Node: net_d │ │ │ │ │ +00037b90: 656c 5f64 6e73 2c20 204e 6578 743a 206e el_dns, Next: n │ │ │ │ │ +00037ba0: 6574 5f64 656c 5f72 6f75 7465 2c20 2050 et_del_route, P │ │ │ │ │ +00037bb0: 7265 763a 206e 6574 5f64 656c 5f61 6464 rev: net_del_add │ │ │ │ │ +00037bc0: 722c 2020 5570 3a20 4e65 7477 6f72 6b69 r, Up: Networki │ │ │ │ │ +00037bd0: 6e67 2063 6f6d 6d61 6e64 730a 0a31 362e ng commands..16. │ │ │ │ │ +00037be0: 342e 3620 6e65 745f 6465 6c5f 646e 730a 4.6 net_del_dns. │ │ │ │ │ +00037bf0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ +00037c00: 2d2d 0a0a 202d 2d20 436f 6d6d 616e 643a --.. -- Command: │ │ │ │ │ +00037c10: 206e 6574 5f64 656c 5f64 6e73 2041 4444 net_del_dns ADD │ │ │ │ │ +00037c20: 5245 5353 0a20 2020 2020 5265 6d6f 7665 RESS. Remove │ │ │ │ │ +00037c30: 2041 4444 5245 5353 2066 726f 6d20 6c69 ADDRESS from li │ │ │ │ │ +00037c40: 7374 206f 6620 7365 7276 6572 7320 7573 st of servers us │ │ │ │ │ +00037c50: 6564 2064 7572 696e 6720 6e61 6d65 206c ed during name l │ │ │ │ │ +00037c60: 6f6f 6b75 702e 0a0a 1f0a 4669 6c65 3a20 ookup.....File: │ │ │ │ │ +00037c70: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ +00037c80: 3a20 6e65 745f 6465 6c5f 726f 7574 652c : net_del_route, │ │ │ │ │ +00037c90: 2020 4e65 7874 3a20 6e65 745f 6468 6370 Next: net_dhcp │ │ │ │ │ +00037ca0: 2c20 2050 7265 763a 206e 6574 5f64 656c , Prev: net_del │ │ │ │ │ +00037cb0: 5f64 6e73 2c20 2055 703a 204e 6574 776f _dns, Up: Netwo │ │ │ │ │ +00037cc0: 726b 696e 6720 636f 6d6d 616e 6473 0a0a rking commands.. │ │ │ │ │ +00037cd0: 3136 2e34 2e37 206e 6574 5f64 656c 5f72 16.4.7 net_del_r │ │ │ │ │ +00037ce0: 6f75 7465 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d oute.----------- │ │ │ │ │ +00037cf0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 ---------.. -- C │ │ │ │ │ +00037d00: 6f6d 6d61 6e64 3a20 6e65 745f 6465 6c5f ommand: net_del_ │ │ │ │ │ +00037d10: 726f 7574 6520 5348 4f52 544e 414d 450a route SHORTNAME. │ │ │ │ │ +00037d20: 2020 2020 2052 656d 6f76 6520 726f 7574 Remove rout │ │ │ │ │ +00037d30: 6520 656e 7472 7920 6964 656e 7469 6669 e entry identifi │ │ │ │ │ +00037d40: 6564 2062 7920 5348 4f52 544e 414d 452e ed by SHORTNAME. │ │ │ │ │ +00037d50: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ +00037d60: 6e66 6f2c 2020 4e6f 6465 3a20 6e65 745f nfo, Node: net_ │ │ │ │ │ +00037d70: 6468 6370 2c20 204e 6578 743a 206e 6574 dhcp, Next: net │ │ │ │ │ +00037d80: 5f67 6574 5f64 6863 705f 6f70 7469 6f6e _get_dhcp_option │ │ │ │ │ +00037d90: 2c20 2050 7265 763a 206e 6574 5f64 656c , Prev: net_del │ │ │ │ │ +00037da0: 5f72 6f75 7465 2c20 2055 703a 204e 6574 _route, Up: Net │ │ │ │ │ +00037db0: 776f 726b 696e 6720 636f 6d6d 616e 6473 working commands │ │ │ │ │ +00037dc0: 0a0a 3136 2e34 2e38 206e 6574 5f64 6863 ..16.4.8 net_dhc │ │ │ │ │ +00037dd0: 700a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d p.-------------- │ │ │ │ │ +00037de0: 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 -.. -- Command: │ │ │ │ │ +00037df0: 6e65 745f 6468 6370 205b 4341 5244 5d0a net_dhcp [CARD]. │ │ │ │ │ +00037e00: 2020 2020 2050 6572 666f 726d 2063 6f6e Perform con │ │ │ │ │ +00037e10: 6669 6775 7261 7469 6f6e 206f 6620 4341 figuration of CA │ │ │ │ │ +00037e20: 5244 2075 7369 6e67 2044 4843 5020 7072 RD using DHCP pr │ │ │ │ │ +00037e30: 6f74 6f63 6f6c 2e20 2049 6620 6e6f 2063 otocol. If no c │ │ │ │ │ +00037e40: 6172 6420 6e61 6d65 0a20 2020 2020 6973 ard name. is │ │ │ │ │ +00037e50: 2073 7065 6369 6669 6564 2c20 7472 7920 specified, try │ │ │ │ │ +00037e60: 746f 2063 6f6e 6669 6775 7265 2061 6c6c to configure all │ │ │ │ │ +00037e70: 2065 7869 7374 696e 6720 6361 7264 732e existing cards. │ │ │ │ │ +00037e80: 2020 4661 6c6c 7320 6261 636b 2074 6f0a Falls back to. │ │ │ │ │ +00037e90: 2020 2020 2074 6865 2042 4f4f 5450 2070 the BOOTP p │ │ │ │ │ +00037ea0: 726f 746f 636f 6c2c 2069 6620 6e65 6564 rotocol, if need │ │ │ │ │ +00037eb0: 6564 2e20 2049 6620 636f 6e66 6967 7572 ed. If configur │ │ │ │ │ +00037ec0: 6174 696f 6e20 7761 7320 7375 6363 6573 ation was succes │ │ │ │ │ +00037ed0: 7366 756c 2c0a 2020 2020 2069 6e74 6572 sful,. inter │ │ │ │ │ +00037ee0: 6661 6365 2077 6974 6820 6e61 6d65 2043 face with name C │ │ │ │ │ +00037ef0: 4152 4427 3a64 6863 7027 2061 6e64 2063 ARD':dhcp' and c │ │ │ │ │ +00037f00: 6f6e 6669 6775 7265 6420 6164 6472 6573 onfigured addres │ │ │ │ │ +00037f10: 7320 6973 2061 6464 6564 2074 6f0a 2020 s is added to. │ │ │ │ │ +00037f20: 2020 2043 4152 442e 2020 4164 6469 7469 CARD. Additi │ │ │ │ │ +00037f30: 6f6e 616c 6c79 2074 6865 2066 6f6c 6c6f onally the follo │ │ │ │ │ +00037f40: 7769 6e67 2044 4843 5020 6f70 7469 6f6e wing DHCP option │ │ │ │ │ +00037f50: 7320 6172 6520 7265 636f 676e 697a 6564 s are recognized │ │ │ │ │ +00037f60: 2061 6e64 0a20 2020 2020 7072 6f63 6573 and. proces │ │ │ │ │ +00037f70: 7365 643a 0a0a 2020 2020 2027 3120 2853 sed:.. '1 (S │ │ │ │ │ +00037f80: 7562 6e65 7420 4d61 736b 2927 0a20 2020 ubnet Mask)'. │ │ │ │ │ +00037f90: 2020 2020 2020 2055 7365 6420 746f 2063 Used to c │ │ │ │ │ +00037fa0: 616c 6375 6c61 7465 206e 6574 776f 726b alculate network │ │ │ │ │ +00037fb0: 206c 6f63 616c 2072 6f75 7469 6e67 2065 local routing e │ │ │ │ │ +00037fc0: 6e74 7279 2066 6f72 2069 6e74 6572 6661 ntry for interfa │ │ │ │ │ +00037fd0: 6365 0a20 2020 2020 2020 2020 2043 4152 ce. CAR │ │ │ │ │ +00037fe0: 4427 3a64 6863 7027 2e0a 2020 2020 2027 D':dhcp'.. ' │ │ │ │ │ +00037ff0: 3320 2852 6f75 7465 7229 270a 2020 2020 3 (Router)'. │ │ │ │ │ +00038000: 2020 2020 2020 4164 6473 2064 6566 6175 Adds defau │ │ │ │ │ +00038010: 6c74 2072 6f75 7465 2065 6e74 7279 2077 lt route entry w │ │ │ │ │ +00038020: 6974 6820 7468 6520 6e61 6d65 2043 4152 ith the name CAR │ │ │ │ │ +00038030: 4427 3a64 6863 703a 6465 6661 756c 7427 D':dhcp:default' │ │ │ │ │ +00038040: 2076 6961 0a20 2020 2020 2020 2020 2067 via. g │ │ │ │ │ +00038050: 6174 6577 6179 2066 726f 6d20 4448 4350 ateway from DHCP │ │ │ │ │ +00038060: 206f 7074 696f 6e2e 2020 4e6f 7465 2074 option. Note t │ │ │ │ │ +00038070: 6861 7420 6f6e 6c79 206f 7074 696f 6e20 hat only option │ │ │ │ │ +00038080: 7769 7468 2073 696e 676c 650a 2020 2020 with single. │ │ │ │ │ +00038090: 2020 2020 2020 726f 7574 6520 6973 2061 route is a │ │ │ │ │ +000380a0: 6363 6570 7465 642e 0a20 2020 2020 2736 ccepted.. '6 │ │ │ │ │ +000380b0: 2028 446f 6d61 696e 204e 616d 6520 5365 (Domain Name Se │ │ │ │ │ +000380c0: 7276 6572 2927 0a20 2020 2020 2020 2020 rver)'. │ │ │ │ │ +000380d0: 2041 6464 7320 616c 6c20 7365 7276 6572 Adds all server │ │ │ │ │ +000380e0: 7320 6672 6f6d 206f 7074 696f 6e20 7661 s from option va │ │ │ │ │ +000380f0: 6c75 6520 746f 2074 6865 206c 6973 7420 lue to the list │ │ │ │ │ +00038100: 6f66 2073 6572 7665 7273 2075 7365 640a of servers used. │ │ │ │ │ +00038110: 2020 2020 2020 2020 2020 6475 7269 6e67 during │ │ │ │ │ +00038120: 206e 616d 6520 7265 736f 6c75 7469 6f6e name resolution │ │ │ │ │ +00038130: 2e0a 2020 2020 2027 3132 2028 486f 7374 .. '12 (Host │ │ │ │ │ +00038140: 204e 616d 6529 270a 2020 2020 2020 2020 Name)'. │ │ │ │ │ +00038150: 2020 5365 7473 2065 6e76 6972 6f6e 6d65 Sets environme │ │ │ │ │ +00038160: 6e74 2076 6172 6961 626c 6520 276e 6574 nt variable 'net │ │ │ │ │ +00038170: 5f27 3c43 4152 443e 275f 6468 6370 5f68 _''_dhcp_h │ │ │ │ │ +00038180: 6f73 746e 616d 6527 2028 2a6e 6f74 650a ostname' (*note. │ │ │ │ │ +00038190: 2020 2020 2020 2020 2020 6e65 745f 3c49 net__hostna │ │ │ │ │ +000381b0: 6d65 3a3a 2920 746f 2074 6865 2076 616c me::) to the val │ │ │ │ │ +000381c0: 7565 206f 6620 6f70 7469 6f6e 2e0a 2020 ue of option.. │ │ │ │ │ +000381d0: 2020 2027 3135 2028 446f 6d61 696e 204e '15 (Domain N │ │ │ │ │ +000381e0: 616d 6529 270a 2020 2020 2020 2020 2020 ame)'. │ │ │ │ │ +000381f0: 5365 7473 2065 6e76 6972 6f6e 6d65 6e74 Sets environment │ │ │ │ │ +00038200: 2076 6172 6961 626c 6520 276e 6574 5f27 variable 'net_' │ │ │ │ │ +00038210: 3c43 4152 443e 275f 6468 6370 5f64 6f6d '_dhcp_dom │ │ │ │ │ +00038220: 6169 6e27 2028 2a6e 6f74 650a 2020 2020 ain' (*note. │ │ │ │ │ +00038230: 2020 2020 2020 6e65 745f 3c49 4e54 4552 net__domain::) │ │ │ │ │ +00038250: 746f 2074 6865 2076 616c 7565 206f 6620 to the value of │ │ │ │ │ +00038260: 6f70 7469 6f6e 2e0a 2020 2020 2027 3137 option.. '17 │ │ │ │ │ +00038270: 2028 526f 6f74 2050 6174 6829 270a 2020 (Root Path)'. │ │ │ │ │ +00038280: 2020 2020 2020 2020 5365 7473 2065 6e76 Sets env │ │ │ │ │ +00038290: 6972 6f6e 6d65 6e74 2076 6172 6961 626c ironment variabl │ │ │ │ │ +000382a0: 6520 276e 6574 5f27 3c43 4152 443e 275f e 'net_''_ │ │ │ │ │ +000382b0: 6468 6370 5f72 6f6f 7470 6174 6827 2028 dhcp_rootpath' ( │ │ │ │ │ +000382c0: 2a6e 6f74 650a 2020 2020 2020 2020 2020 *note. │ │ │ │ │ +000382d0: 6e65 745f 3c49 4e54 4552 4641 4345 3e5f net__ │ │ │ │ │ +000382e0: 726f 6f74 7061 7468 3a3a 2920 746f 2074 rootpath::) to t │ │ │ │ │ +000382f0: 6865 2076 616c 7565 206f 6620 6f70 7469 he value of opti │ │ │ │ │ +00038300: 6f6e 2e0a 2020 2020 2027 3138 2028 4578 on.. '18 (Ex │ │ │ │ │ +00038310: 7465 6e73 696f 6e73 2050 6174 6829 270a tensions Path)'. │ │ │ │ │ +00038320: 2020 2020 2020 2020 2020 5365 7473 2065 Sets e │ │ │ │ │ +00038330: 6e76 6972 6f6e 6d65 6e74 2076 6172 6961 nvironment varia │ │ │ │ │ +00038340: 626c 6520 276e 6574 5f27 3c43 4152 443e ble 'net_' │ │ │ │ │ +00038350: 275f 6468 6370 5f65 7874 656e 7369 6f6e '_dhcp_extension │ │ │ │ │ +00038360: 7370 6174 6827 0a20 2020 2020 2020 2020 spath'. │ │ │ │ │ +00038370: 2028 2a6e 6f74 6520 6e65 745f 3c49 4e54 (*note net__extensio │ │ │ │ │ +00038390: 6e73 7061 7468 3a3a 2920 746f 2074 6865 nspath::) to the │ │ │ │ │ +000383a0: 2076 616c 7565 206f 660a 2020 2020 2020 value of. │ │ │ │ │ +000383b0: 2020 2020 6f70 7469 6f6e 2e0a 2020 2020 option.. │ │ │ │ │ +000383c0: 2027 3636 2028 5446 5450 2053 6572 7665 '66 (TFTP Serve │ │ │ │ │ +000383d0: 7220 4e61 6d65 2927 0a20 2020 2020 2020 r Name)'. │ │ │ │ │ +000383e0: 2020 2053 6574 7320 656e 7669 726f 6e6d Sets environm │ │ │ │ │ +000383f0: 656e 7420 7661 7269 6162 6c65 2027 6e65 ent variable 'ne │ │ │ │ │ +00038400: 745f 273c 4341 5244 3e27 5f64 6863 705f t_''_dhcp_ │ │ │ │ │ +00038410: 7365 7276 6572 5f6e 616d 6527 0a20 2020 server_name'. │ │ │ │ │ +00038420: 2020 2020 2020 2028 2a6e 6f74 6520 6e65 (*note ne │ │ │ │ │ +00038430: 745f 3c49 4e54 4552 4641 4345 3e5f 6468 t__dh │ │ │ │ │ +00038440: 6370 5f73 6572 7665 725f 6e61 6d65 3a3a cp_server_name:: │ │ │ │ │ +00038450: 2920 746f 2074 6865 2076 616c 7565 206f ) to the value o │ │ │ │ │ +00038460: 660a 2020 2020 2020 2020 2020 6f70 7469 f. opti │ │ │ │ │ +00038470: 6f6e 2e0a 2020 2020 2027 3637 2028 4669 on.. '67 (Fi │ │ │ │ │ +00038480: 6c65 6e61 6d65 2927 0a20 2020 2020 2020 lename)'. │ │ │ │ │ +00038490: 2020 2053 6574 7320 656e 7669 726f 6e6d Sets environm │ │ │ │ │ +000384a0: 656e 7420 7661 7269 6162 6c65 2027 6e65 ent variable 'ne │ │ │ │ │ +000384b0: 745f 273c 4341 5244 3e27 5f62 6f6f 745f t_''_boot_ │ │ │ │ │ +000384c0: 6669 6c65 2720 282a 6e6f 7465 0a20 2020 file' (*note. │ │ │ │ │ +000384d0: 2020 2020 2020 206e 6574 5f3c 494e 5445 net__boot_file │ │ │ │ │ +000384f0: 3a3a 2920 746f 2074 6865 2076 616c 7565 ::) to the value │ │ │ │ │ +00038500: 206f 6620 6f70 7469 6f6e 2e0a 0a1f 0a46 of option.....F │ │ │ │ │ +00038510: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ +00038520: 204e 6f64 653a 206e 6574 5f67 6574 5f64 Node: net_get_d │ │ │ │ │ +00038530: 6863 705f 6f70 7469 6f6e 2c20 204e 6578 hcp_option, Nex │ │ │ │ │ +00038540: 743a 206e 6574 5f69 7076 365f 6175 746f t: net_ipv6_auto │ │ │ │ │ +00038550: 636f 6e66 2c20 2050 7265 763a 206e 6574 conf, Prev: net │ │ │ │ │ +00038560: 5f64 6863 702c 2020 5570 3a20 4e65 7477 _dhcp, Up: Netw │ │ │ │ │ +00038570: 6f72 6b69 6e67 2063 6f6d 6d61 6e64 730a orking commands. │ │ │ │ │ +00038580: 0a31 362e 342e 3920 6e65 745f 6765 745f .16.4.9 net_get_ │ │ │ │ │ +00038590: 6468 6370 5f6f 7074 696f 6e0a 2d2d 2d2d dhcp_option.---- │ │ │ │ │ 000385a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -000385b0: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ │ -000385c0: 6d6d 616e 643a 206e 6574 5f67 6574 5f64 mmand: net_get_d │ │ │ │ │ -000385d0: 6863 705f 6f70 7469 6f6e 2056 4152 2049 hcp_option VAR I │ │ │ │ │ -000385e0: 4e54 4552 4641 4345 204e 554d 4245 5220 NTERFACE NUMBER │ │ │ │ │ -000385f0: 5459 5045 0a20 2020 2020 5265 7175 6573 TYPE. Reques │ │ │ │ │ -00038600: 7420 4448 4350 206f 7074 696f 6e20 4e55 t DHCP option NU │ │ │ │ │ -00038610: 4d42 4552 206f 6620 5459 5045 2076 6961 MBER of TYPE via │ │ │ │ │ -00038620: 2049 4e54 4552 4641 4345 2e20 2054 5950 INTERFACE. TYP │ │ │ │ │ -00038630: 4520 6361 6e20 6265 206f 6e65 0a20 2020 E can be one. │ │ │ │ │ -00038640: 2020 6f66 2027 7374 7269 6e67 272c 2027 of 'string', ' │ │ │ │ │ -00038650: 6e75 6d62 6572 2720 6f72 2027 6865 7827 number' or 'hex' │ │ │ │ │ -00038660: 2e20 2049 6620 6f70 7469 6f6e 2069 7320 . If option is │ │ │ │ │ -00038670: 666f 756e 642c 2061 7373 6967 6e20 6974 found, assign it │ │ │ │ │ -00038680: 730a 2020 2020 2076 616c 7565 2074 6f20 s. value to │ │ │ │ │ -00038690: 7661 7269 6162 6c65 2056 4152 2e20 2056 variable VAR. V │ │ │ │ │ -000386a0: 616c 7565 7320 6f66 2074 7970 6573 2027 alues of types ' │ │ │ │ │ -000386b0: 6e75 6d62 6572 2720 616e 6420 2768 6578 number' and 'hex │ │ │ │ │ -000386c0: 2720 6172 650a 2020 2020 2063 6f6e 7665 ' are. conve │ │ │ │ │ -000386d0: 7274 6564 2074 6f20 7374 7269 6e67 2072 rted to string r │ │ │ │ │ -000386e0: 6570 7265 7365 6e74 6174 696f 6e2e 0a0a epresentation... │ │ │ │ │ -000386f0: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ -00038700: 6f2c 2020 4e6f 6465 3a20 6e65 745f 6970 o, Node: net_ip │ │ │ │ │ -00038710: 7636 5f61 7574 6f63 6f6e 662c 2020 4e65 v6_autoconf, Ne │ │ │ │ │ -00038720: 7874 3a20 6e65 745f 6c73 5f61 6464 722c xt: net_ls_addr, │ │ │ │ │ -00038730: 2020 5072 6576 3a20 6e65 745f 6765 745f Prev: net_get_ │ │ │ │ │ -00038740: 6468 6370 5f6f 7074 696f 6e2c 2020 5570 dhcp_option, Up │ │ │ │ │ -00038750: 3a20 4e65 7477 6f72 6b69 6e67 2063 6f6d : Networking com │ │ │ │ │ -00038760: 6d61 6e64 730a 0a31 362e 342e 3130 206e mands..16.4.10 n │ │ │ │ │ -00038770: 6574 5f69 7076 365f 6175 746f 636f 6e66 et_ipv6_autoconf │ │ │ │ │ -00038780: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ │ -00038790: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 ----------.. -- │ │ │ │ │ -000387a0: 436f 6d6d 616e 643a 206e 6574 5f69 7076 Command: net_ipv │ │ │ │ │ -000387b0: 365f 6175 746f 636f 6e66 205b 4341 5244 6_autoconf [CARD │ │ │ │ │ -000387c0: 5d0a 2020 2020 2050 6572 666f 726d 2049 ]. Perform I │ │ │ │ │ -000387d0: 5076 3620 6175 746f 636f 6e66 6967 7572 Pv6 autoconfigur │ │ │ │ │ -000387e0: 6174 696f 6e20 6279 2061 6464 696e 6720 ation by adding │ │ │ │ │ -000387f0: 746f 2074 6865 2043 4152 4420 696e 7465 to the CARD inte │ │ │ │ │ -00038800: 7266 6163 6520 7769 7468 0a20 2020 2020 rface with. │ │ │ │ │ -00038810: 6e61 6d65 2043 4152 4427 3a6c 696e 6b27 name CARD':link' │ │ │ │ │ -00038820: 2061 6e64 206c 696e 6b20 6c6f 6361 6c20 and link local │ │ │ │ │ -00038830: 4d41 432d 6261 7365 6420 6164 6472 6573 MAC-based addres │ │ │ │ │ -00038840: 732e 2020 4966 206e 6f20 6361 7264 2069 s. If no card i │ │ │ │ │ -00038850: 730a 2020 2020 2073 7065 6369 6669 6564 s. specified │ │ │ │ │ -00038860: 2c20 7065 7266 6f72 6d20 6175 746f 636f , perform autoco │ │ │ │ │ -00038870: 6e66 6967 7572 6174 696f 6e20 666f 7220 nfiguration for │ │ │ │ │ -00038880: 616c 6c20 6578 6973 7469 6e67 2063 6172 all existing car │ │ │ │ │ -00038890: 6473 2e0a 0a1f 0a46 696c 653a 2067 7275 ds.....File: gru │ │ │ │ │ -000388a0: 622e 696e 666f 2c20 204e 6f64 653a 206e b.info, Node: n │ │ │ │ │ -000388b0: 6574 5f6c 735f 6164 6472 2c20 204e 6578 et_ls_addr, Nex │ │ │ │ │ -000388c0: 743a 206e 6574 5f6c 735f 6361 7264 732c t: net_ls_cards, │ │ │ │ │ -000388d0: 2020 5072 6576 3a20 6e65 745f 6970 7636 Prev: net_ipv6 │ │ │ │ │ -000388e0: 5f61 7574 6f63 6f6e 662c 2020 5570 3a20 _autoconf, Up: │ │ │ │ │ -000388f0: 4e65 7477 6f72 6b69 6e67 2063 6f6d 6d61 Networking comma │ │ │ │ │ -00038900: 6e64 730a 0a31 362e 342e 3131 206e 6574 nds..16.4.11 net │ │ │ │ │ -00038910: 5f6c 735f 6164 6472 0a2d 2d2d 2d2d 2d2d _ls_addr.------- │ │ │ │ │ -00038920: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d ------------.. - │ │ │ │ │ -00038930: 2d20 436f 6d6d 616e 643a 206e 6574 5f6c - Command: net_l │ │ │ │ │ -00038940: 735f 6164 6472 0a20 2020 2020 4c69 7374 s_addr. List │ │ │ │ │ -00038950: 2061 6c6c 2063 6f6e 6669 6775 7265 6420 all configured │ │ │ │ │ -00038960: 696e 7465 7266 6163 6573 2077 6974 6820 interfaces with │ │ │ │ │ -00038970: 7468 6569 7220 4d41 4320 616e 6420 4950 their MAC and IP │ │ │ │ │ -00038980: 2061 6464 7265 7373 6573 2e0a 0a1f 0a46 addresses.....F │ │ │ │ │ -00038990: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ -000389a0: 204e 6f64 653a 206e 6574 5f6c 735f 6361 Node: net_ls_ca │ │ │ │ │ -000389b0: 7264 732c 2020 4e65 7874 3a20 6e65 745f rds, Next: net_ │ │ │ │ │ -000389c0: 6c73 5f64 6e73 2c20 2050 7265 763a 206e ls_dns, Prev: n │ │ │ │ │ -000389d0: 6574 5f6c 735f 6164 6472 2c20 2055 703a et_ls_addr, Up: │ │ │ │ │ -000389e0: 204e 6574 776f 726b 696e 6720 636f 6d6d Networking comm │ │ │ │ │ -000389f0: 616e 6473 0a0a 3136 2e34 2e31 3220 6e65 ands..16.4.12 ne │ │ │ │ │ -00038a00: 745f 6c73 5f63 6172 6473 0a2d 2d2d 2d2d t_ls_cards.----- │ │ │ │ │ -00038a10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ -00038a20: 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 6e65 . -- Command: ne │ │ │ │ │ -00038a30: 745f 6c73 5f63 6172 6473 0a20 2020 2020 t_ls_cards. │ │ │ │ │ -00038a40: 4c69 7374 2061 6c6c 2064 6574 6563 7465 List all detecte │ │ │ │ │ -00038a50: 6420 6e65 7477 6f72 6b20 6361 7264 7320 d network cards │ │ │ │ │ -00038a60: 7769 7468 2074 6865 6972 204d 4143 2061 with their MAC a │ │ │ │ │ -00038a70: 6464 7265 7373 2e0a 0a1f 0a46 696c 653a ddress.....File: │ │ │ │ │ -00038a80: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ -00038a90: 653a 206e 6574 5f6c 735f 646e 732c 2020 e: net_ls_dns, │ │ │ │ │ -00038aa0: 4e65 7874 3a20 6e65 745f 6c73 5f72 6f75 Next: net_ls_rou │ │ │ │ │ -00038ab0: 7465 732c 2020 5072 6576 3a20 6e65 745f tes, Prev: net_ │ │ │ │ │ -00038ac0: 6c73 5f63 6172 6473 2c20 2055 703a 204e ls_cards, Up: N │ │ │ │ │ -00038ad0: 6574 776f 726b 696e 6720 636f 6d6d 616e etworking comman │ │ │ │ │ -00038ae0: 6473 0a0a 3136 2e34 2e31 3320 6e65 745f ds..16.4.13 net_ │ │ │ │ │ -00038af0: 6c73 5f64 6e73 0a2d 2d2d 2d2d 2d2d 2d2d ls_dns.--------- │ │ │ │ │ -00038b00: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 ---------.. -- C │ │ │ │ │ -00038b10: 6f6d 6d61 6e64 3a20 6e65 745f 6c73 5f64 ommand: net_ls_d │ │ │ │ │ -00038b20: 6e73 0a20 2020 2020 4c69 7374 2061 6464 ns. List add │ │ │ │ │ -00038b30: 7265 7373 6573 206f 6620 444e 5320 7365 resses of DNS se │ │ │ │ │ -00038b40: 7276 6572 7320 7573 6564 2064 7572 696e rvers used durin │ │ │ │ │ -00038b50: 6720 6e61 6d65 206c 6f6f 6b75 702e 0a0a g name lookup... │ │ │ │ │ -00038b60: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ -00038b70: 6f2c 2020 4e6f 6465 3a20 6e65 745f 6c73 o, Node: net_ls │ │ │ │ │ -00038b80: 5f72 6f75 7465 732c 2020 4e65 7874 3a20 _routes, Next: │ │ │ │ │ -00038b90: 6e65 745f 6e73 6c6f 6f6b 7570 2c20 2050 net_nslookup, P │ │ │ │ │ -00038ba0: 7265 763a 206e 6574 5f6c 735f 646e 732c rev: net_ls_dns, │ │ │ │ │ -00038bb0: 2020 5570 3a20 4e65 7477 6f72 6b69 6e67 Up: Networking │ │ │ │ │ -00038bc0: 2063 6f6d 6d61 6e64 730a 0a31 362e 342e commands..16.4. │ │ │ │ │ -00038bd0: 3134 206e 6574 5f6c 735f 726f 7574 6573 14 net_ls_routes │ │ │ │ │ -00038be0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ │ -00038bf0: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ │ -00038c00: 616e 643a 206e 6574 5f6c 735f 726f 7574 and: net_ls_rout │ │ │ │ │ -00038c10: 6573 0a20 2020 2020 4c69 7374 2072 6f75 es. List rou │ │ │ │ │ -00038c20: 7469 6e67 2065 6e74 7269 6573 2e0a 0a1f ting entries.... │ │ │ │ │ -00038c30: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ -00038c40: 2c20 204e 6f64 653a 206e 6574 5f6e 736c , Node: net_nsl │ │ │ │ │ -00038c50: 6f6f 6b75 702c 2020 5072 6576 3a20 6e65 ookup, Prev: ne │ │ │ │ │ -00038c60: 745f 6c73 5f72 6f75 7465 732c 2020 5570 t_ls_routes, Up │ │ │ │ │ -00038c70: 3a20 4e65 7477 6f72 6b69 6e67 2063 6f6d : Networking com │ │ │ │ │ -00038c80: 6d61 6e64 730a 0a31 362e 342e 3135 206e mands..16.4.15 n │ │ │ │ │ -00038c90: 6574 5f6e 736c 6f6f 6b75 700a 2d2d 2d2d et_nslookup.---- │ │ │ │ │ -00038ca0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00038cb0: 0a0a 202d 2d20 436f 6d6d 616e 643a 206e .. -- Command: n │ │ │ │ │ -00038cc0: 6574 5f6e 736c 6f6f 6b75 7020 4e41 4d45 et_nslookup NAME │ │ │ │ │ -00038cd0: 205b 5345 5256 4552 5d0a 2020 2020 2052 [SERVER]. R │ │ │ │ │ -00038ce0: 6573 6f6c 7665 2061 6464 7265 7373 206f esolve address o │ │ │ │ │ -00038cf0: 6620 4e41 4d45 2075 7369 6e67 2044 4e53 f NAME using DNS │ │ │ │ │ -00038d00: 2073 6572 7665 7220 5345 5256 4552 2e20 server SERVER. │ │ │ │ │ -00038d10: 2049 6620 6e6f 2073 6572 7665 7220 6973 If no server is │ │ │ │ │ -00038d20: 0a20 2020 2020 6769 7665 6e2c 2075 7365 . given, use │ │ │ │ │ -00038d30: 2064 6566 6175 6c74 206c 6973 7420 6f66 default list of │ │ │ │ │ -00038d40: 2073 6572 7665 7273 2e0a 0a1f 0a46 696c servers.....Fil │ │ │ │ │ -00038d50: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ -00038d60: 6f64 653a 2049 6e74 6572 6e61 7469 6f6e ode: Internation │ │ │ │ │ -00038d70: 616c 6973 6174 696f 6e2c 2020 4e65 7874 alisation, Next │ │ │ │ │ -00038d80: 3a20 5365 6375 7269 7479 2c20 2050 7265 : Security, Pre │ │ │ │ │ -00038d90: 763a 2043 6f6d 6d61 6e64 732c 2020 5570 v: Commands, Up │ │ │ │ │ -00038da0: 3a20 546f 700a 0a31 3720 496e 7465 726e : Top..17 Intern │ │ │ │ │ -00038db0: 6174 696f 6e61 6c69 7361 7469 6f6e 0a2a ationalisation.* │ │ │ │ │ +000385b0: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ │ +000385c0: 616e 643a 206e 6574 5f67 6574 5f64 6863 and: net_get_dhc │ │ │ │ │ +000385d0: 705f 6f70 7469 6f6e 2056 4152 2049 4e54 p_option VAR INT │ │ │ │ │ +000385e0: 4552 4641 4345 204e 554d 4245 5220 5459 ERFACE NUMBER TY │ │ │ │ │ +000385f0: 5045 0a20 2020 2020 5265 7175 6573 7420 PE. Request │ │ │ │ │ +00038600: 4448 4350 206f 7074 696f 6e20 4e55 4d42 DHCP option NUMB │ │ │ │ │ +00038610: 4552 206f 6620 5459 5045 2076 6961 2049 ER of TYPE via I │ │ │ │ │ +00038620: 4e54 4552 4641 4345 2e20 2054 5950 4520 NTERFACE. TYPE │ │ │ │ │ +00038630: 6361 6e20 6265 206f 6e65 0a20 2020 2020 can be one. │ │ │ │ │ +00038640: 6f66 2027 7374 7269 6e67 272c 2027 6e75 of 'string', 'nu │ │ │ │ │ +00038650: 6d62 6572 2720 6f72 2027 6865 7827 2e20 mber' or 'hex'. │ │ │ │ │ +00038660: 2049 6620 6f70 7469 6f6e 2069 7320 666f If option is fo │ │ │ │ │ +00038670: 756e 642c 2061 7373 6967 6e20 6974 730a und, assign its. │ │ │ │ │ +00038680: 2020 2020 2076 616c 7565 2074 6f20 7661 value to va │ │ │ │ │ +00038690: 7269 6162 6c65 2056 4152 2e20 2056 616c riable VAR. Val │ │ │ │ │ +000386a0: 7565 7320 6f66 2074 7970 6573 2027 6e75 ues of types 'nu │ │ │ │ │ +000386b0: 6d62 6572 2720 616e 6420 2768 6578 2720 mber' and 'hex' │ │ │ │ │ +000386c0: 6172 650a 2020 2020 2063 6f6e 7665 7274 are. convert │ │ │ │ │ +000386d0: 6564 2074 6f20 7374 7269 6e67 2072 6570 ed to string rep │ │ │ │ │ +000386e0: 7265 7365 6e74 6174 696f 6e2e 0a0a 1f0a resentation..... │ │ │ │ │ +000386f0: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ +00038700: 2020 4e6f 6465 3a20 6e65 745f 6970 7636 Node: net_ipv6 │ │ │ │ │ +00038710: 5f61 7574 6f63 6f6e 662c 2020 4e65 7874 _autoconf, Next │ │ │ │ │ +00038720: 3a20 6e65 745f 6c73 5f61 6464 722c 2020 : net_ls_addr, │ │ │ │ │ +00038730: 5072 6576 3a20 6e65 745f 6765 745f 6468 Prev: net_get_dh │ │ │ │ │ +00038740: 6370 5f6f 7074 696f 6e2c 2020 5570 3a20 cp_option, Up: │ │ │ │ │ +00038750: 4e65 7477 6f72 6b69 6e67 2063 6f6d 6d61 Networking comma │ │ │ │ │ +00038760: 6e64 730a 0a31 362e 342e 3130 206e 6574 nds..16.4.10 net │ │ │ │ │ +00038770: 5f69 7076 365f 6175 746f 636f 6e66 0a2d _ipv6_autoconf.- │ │ │ │ │ +00038780: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ +00038790: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ │ +000387a0: 6d6d 616e 643a 206e 6574 5f69 7076 365f mmand: net_ipv6_ │ │ │ │ │ +000387b0: 6175 746f 636f 6e66 205b 4341 5244 5d0a autoconf [CARD]. │ │ │ │ │ +000387c0: 2020 2020 2050 6572 666f 726d 2049 5076 Perform IPv │ │ │ │ │ +000387d0: 3620 6175 746f 636f 6e66 6967 7572 6174 6 autoconfigurat │ │ │ │ │ +000387e0: 696f 6e20 6279 2061 6464 696e 6720 746f ion by adding to │ │ │ │ │ +000387f0: 2074 6865 2043 4152 4420 696e 7465 7266 the CARD interf │ │ │ │ │ +00038800: 6163 6520 7769 7468 0a20 2020 2020 6e61 ace with. na │ │ │ │ │ +00038810: 6d65 2043 4152 4427 3a6c 696e 6b27 2061 me CARD':link' a │ │ │ │ │ +00038820: 6e64 206c 696e 6b20 6c6f 6361 6c20 4d41 nd link local MA │ │ │ │ │ +00038830: 432d 6261 7365 6420 6164 6472 6573 732e C-based address. │ │ │ │ │ +00038840: 2020 4966 206e 6f20 6361 7264 2069 730a If no card is. │ │ │ │ │ +00038850: 2020 2020 2073 7065 6369 6669 6564 2c20 specified, │ │ │ │ │ +00038860: 7065 7266 6f72 6d20 6175 746f 636f 6e66 perform autoconf │ │ │ │ │ +00038870: 6967 7572 6174 696f 6e20 666f 7220 616c iguration for al │ │ │ │ │ +00038880: 6c20 6578 6973 7469 6e67 2063 6172 6473 l existing cards │ │ │ │ │ +00038890: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ +000388a0: 696e 666f 2c20 204e 6f64 653a 206e 6574 info, Node: net │ │ │ │ │ +000388b0: 5f6c 735f 6164 6472 2c20 204e 6578 743a _ls_addr, Next: │ │ │ │ │ +000388c0: 206e 6574 5f6c 735f 6361 7264 732c 2020 net_ls_cards, │ │ │ │ │ +000388d0: 5072 6576 3a20 6e65 745f 6970 7636 5f61 Prev: net_ipv6_a │ │ │ │ │ +000388e0: 7574 6f63 6f6e 662c 2020 5570 3a20 4e65 utoconf, Up: Ne │ │ │ │ │ +000388f0: 7477 6f72 6b69 6e67 2063 6f6d 6d61 6e64 tworking command │ │ │ │ │ +00038900: 730a 0a31 362e 342e 3131 206e 6574 5f6c s..16.4.11 net_l │ │ │ │ │ +00038910: 735f 6164 6472 0a2d 2d2d 2d2d 2d2d 2d2d s_addr.--------- │ │ │ │ │ +00038920: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 ----------.. -- │ │ │ │ │ +00038930: 436f 6d6d 616e 643a 206e 6574 5f6c 735f Command: net_ls_ │ │ │ │ │ +00038940: 6164 6472 0a20 2020 2020 4c69 7374 2061 addr. List a │ │ │ │ │ +00038950: 6c6c 2063 6f6e 6669 6775 7265 6420 696e ll configured in │ │ │ │ │ +00038960: 7465 7266 6163 6573 2077 6974 6820 7468 terfaces with th │ │ │ │ │ +00038970: 6569 7220 4d41 4320 616e 6420 4950 2061 eir MAC and IP a │ │ │ │ │ +00038980: 6464 7265 7373 6573 2e0a 0a1f 0a46 696c ddresses.....Fil │ │ │ │ │ +00038990: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ +000389a0: 6f64 653a 206e 6574 5f6c 735f 6361 7264 ode: net_ls_card │ │ │ │ │ +000389b0: 732c 2020 4e65 7874 3a20 6e65 745f 6c73 s, Next: net_ls │ │ │ │ │ +000389c0: 5f64 6e73 2c20 2050 7265 763a 206e 6574 _dns, Prev: net │ │ │ │ │ +000389d0: 5f6c 735f 6164 6472 2c20 2055 703a 204e _ls_addr, Up: N │ │ │ │ │ +000389e0: 6574 776f 726b 696e 6720 636f 6d6d 616e etworking comman │ │ │ │ │ +000389f0: 6473 0a0a 3136 2e34 2e31 3220 6e65 745f ds..16.4.12 net_ │ │ │ │ │ +00038a00: 6c73 5f63 6172 6473 0a2d 2d2d 2d2d 2d2d ls_cards.------- │ │ │ │ │ +00038a10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 -------------.. │ │ │ │ │ +00038a20: 2d2d 2043 6f6d 6d61 6e64 3a20 6e65 745f -- Command: net_ │ │ │ │ │ +00038a30: 6c73 5f63 6172 6473 0a20 2020 2020 4c69 ls_cards. Li │ │ │ │ │ +00038a40: 7374 2061 6c6c 2064 6574 6563 7465 6420 st all detected │ │ │ │ │ +00038a50: 6e65 7477 6f72 6b20 6361 7264 7320 7769 network cards wi │ │ │ │ │ +00038a60: 7468 2074 6865 6972 204d 4143 2061 6464 th their MAC add │ │ │ │ │ +00038a70: 7265 7373 2e0a 0a1f 0a46 696c 653a 2067 ress.....File: g │ │ │ │ │ +00038a80: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ +00038a90: 206e 6574 5f6c 735f 646e 732c 2020 4e65 net_ls_dns, Ne │ │ │ │ │ +00038aa0: 7874 3a20 6e65 745f 6c73 5f72 6f75 7465 xt: net_ls_route │ │ │ │ │ +00038ab0: 732c 2020 5072 6576 3a20 6e65 745f 6c73 s, Prev: net_ls │ │ │ │ │ +00038ac0: 5f63 6172 6473 2c20 2055 703a 204e 6574 _cards, Up: Net │ │ │ │ │ +00038ad0: 776f 726b 696e 6720 636f 6d6d 616e 6473 working commands │ │ │ │ │ +00038ae0: 0a0a 3136 2e34 2e31 3320 6e65 745f 6c73 ..16.4.13 net_ls │ │ │ │ │ +00038af0: 5f64 6e73 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d _dns.----------- │ │ │ │ │ +00038b00: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d -------.. -- Com │ │ │ │ │ +00038b10: 6d61 6e64 3a20 6e65 745f 6c73 5f64 6e73 mand: net_ls_dns │ │ │ │ │ +00038b20: 0a20 2020 2020 4c69 7374 2061 6464 7265 . List addre │ │ │ │ │ +00038b30: 7373 6573 206f 6620 444e 5320 7365 7276 sses of DNS serv │ │ │ │ │ +00038b40: 6572 7320 7573 6564 2064 7572 696e 6720 ers used during │ │ │ │ │ +00038b50: 6e61 6d65 206c 6f6f 6b75 702e 0a0a 1f0a name lookup..... │ │ │ │ │ +00038b60: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ +00038b70: 2020 4e6f 6465 3a20 6e65 745f 6c73 5f72 Node: net_ls_r │ │ │ │ │ +00038b80: 6f75 7465 732c 2020 4e65 7874 3a20 6e65 outes, Next: ne │ │ │ │ │ +00038b90: 745f 6e73 6c6f 6f6b 7570 2c20 2050 7265 t_nslookup, Pre │ │ │ │ │ +00038ba0: 763a 206e 6574 5f6c 735f 646e 732c 2020 v: net_ls_dns, │ │ │ │ │ +00038bb0: 5570 3a20 4e65 7477 6f72 6b69 6e67 2063 Up: Networking c │ │ │ │ │ +00038bc0: 6f6d 6d61 6e64 730a 0a31 362e 342e 3134 ommands..16.4.14 │ │ │ │ │ +00038bd0: 206e 6574 5f6c 735f 726f 7574 6573 0a2d net_ls_routes.- │ │ │ │ │ +00038be0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ +00038bf0: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ │ +00038c00: 643a 206e 6574 5f6c 735f 726f 7574 6573 d: net_ls_routes │ │ │ │ │ +00038c10: 0a20 2020 2020 4c69 7374 2072 6f75 7469 . List routi │ │ │ │ │ +00038c20: 6e67 2065 6e74 7269 6573 2e0a 0a1f 0a46 ng entries.....F │ │ │ │ │ +00038c30: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ +00038c40: 204e 6f64 653a 206e 6574 5f6e 736c 6f6f Node: net_nsloo │ │ │ │ │ +00038c50: 6b75 702c 2020 5072 6576 3a20 6e65 745f kup, Prev: net_ │ │ │ │ │ +00038c60: 6c73 5f72 6f75 7465 732c 2020 5570 3a20 ls_routes, Up: │ │ │ │ │ +00038c70: 4e65 7477 6f72 6b69 6e67 2063 6f6d 6d61 Networking comma │ │ │ │ │ +00038c80: 6e64 730a 0a31 362e 342e 3135 206e 6574 nds..16.4.15 net │ │ │ │ │ +00038c90: 5f6e 736c 6f6f 6b75 700a 2d2d 2d2d 2d2d _nslookup.------ │ │ │ │ │ +00038ca0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ +00038cb0: 202d 2d20 436f 6d6d 616e 643a 206e 6574 -- Command: net │ │ │ │ │ +00038cc0: 5f6e 736c 6f6f 6b75 7020 4e41 4d45 205b _nslookup NAME [ │ │ │ │ │ +00038cd0: 5345 5256 4552 5d0a 2020 2020 2052 6573 SERVER]. Res │ │ │ │ │ +00038ce0: 6f6c 7665 2061 6464 7265 7373 206f 6620 olve address of │ │ │ │ │ +00038cf0: 4e41 4d45 2075 7369 6e67 2044 4e53 2073 NAME using DNS s │ │ │ │ │ +00038d00: 6572 7665 7220 5345 5256 4552 2e20 2049 erver SERVER. I │ │ │ │ │ +00038d10: 6620 6e6f 2073 6572 7665 7220 6973 0a20 f no server is. │ │ │ │ │ +00038d20: 2020 2020 6769 7665 6e2c 2075 7365 2064 given, use d │ │ │ │ │ +00038d30: 6566 6175 6c74 206c 6973 7420 6f66 2073 efault list of s │ │ │ │ │ +00038d40: 6572 7665 7273 2e0a 0a1f 0a46 696c 653a ervers.....File: │ │ │ │ │ +00038d50: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ +00038d60: 653a 2049 6e74 6572 6e61 7469 6f6e 616c e: International │ │ │ │ │ +00038d70: 6973 6174 696f 6e2c 2020 4e65 7874 3a20 isation, Next: │ │ │ │ │ +00038d80: 5365 6375 7269 7479 2c20 2050 7265 763a Security, Prev: │ │ │ │ │ +00038d90: 2043 6f6d 6d61 6e64 732c 2020 5570 3a20 Commands, Up: │ │ │ │ │ +00038da0: 546f 700a 0a31 3720 496e 7465 726e 6174 Top..17 Internat │ │ │ │ │ +00038db0: 696f 6e61 6c69 7361 7469 6f6e 0a2a 2a2a ionalisation.*** │ │ │ │ │ 00038dc0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -00038dd0: 2a2a 2a2a 2a2a 0a0a 3137 2e31 2043 6861 ******..17.1 Cha │ │ │ │ │ -00038de0: 7273 6574 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d rset.=========== │ │ │ │ │ -00038df0: 3d0a 0a47 5255 4220 7573 6573 2055 5446 =..GRUB uses UTF │ │ │ │ │ -00038e00: 2d38 2069 6e74 6572 6e61 6c6c 7920 6f74 -8 internally ot │ │ │ │ │ -00038e10: 6865 7220 7468 616e 2069 6e20 7265 6e64 her than in rend │ │ │ │ │ -00038e20: 6572 696e 6720 7768 6572 6520 736f 6d65 ering where some │ │ │ │ │ -00038e30: 0a47 5255 422d 7370 6563 6966 6963 2061 .GRUB-specific a │ │ │ │ │ -00038e40: 7070 726f 7072 6961 7465 2072 6570 7265 ppropriate repre │ │ │ │ │ -00038e50: 7365 6e74 6174 696f 6e20 6973 2075 7365 sentation is use │ │ │ │ │ -00038e60: 642e 2020 416c 6c20 7465 7874 2066 696c d. All text fil │ │ │ │ │ -00038e70: 6573 0a28 696e 636c 7564 696e 6720 636f es.(including co │ │ │ │ │ -00038e80: 6e66 6967 2920 6172 6520 6173 7375 6d65 nfig) are assume │ │ │ │ │ -00038e90: 6420 746f 2062 6520 656e 636f 6465 6420 d to be encoded │ │ │ │ │ -00038ea0: 696e 2055 5446 2d38 2e0a 0a31 372e 3220 in UTF-8...17.2 │ │ │ │ │ -00038eb0: 4669 6c65 7379 7374 656d 730a 3d3d 3d3d Filesystems.==== │ │ │ │ │ -00038ec0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 4e54 ============..NT │ │ │ │ │ -00038ed0: 4653 2c20 4a46 532c 2055 4446 2c20 4846 FS, JFS, UDF, HF │ │ │ │ │ -00038ee0: 532b 2c20 6578 4641 542c 206c 6f6e 6720 S+, exFAT, long │ │ │ │ │ -00038ef0: 6669 6c65 6e61 6d65 7320 696e 2046 4154 filenames in FAT │ │ │ │ │ -00038f00: 2c20 4a6f 6c69 6574 2070 6172 7420 6f66 , Joliet part of │ │ │ │ │ -00038f10: 0a49 534f 3936 3630 2061 7265 2074 7265 .ISO9660 are tre │ │ │ │ │ -00038f20: 6174 6564 2061 7320 5554 462d 3136 2061 ated as UTF-16 a │ │ │ │ │ -00038f30: 7320 7065 7220 7370 6563 6966 6963 6174 s per specificat │ │ │ │ │ -00038f40: 696f 6e2e 2020 4146 5320 616e 6420 4246 ion. AFS and BF │ │ │ │ │ -00038f50: 5320 6172 650a 7265 6164 2061 7320 5554 S are.read as UT │ │ │ │ │ -00038f60: 462d 382c 2061 6761 696e 2061 6363 6f72 F-8, again accor │ │ │ │ │ -00038f70: 6469 6e67 2074 6f20 7370 6563 6966 6963 ding to specific │ │ │ │ │ -00038f80: 6174 696f 6e2e 2020 4274 7246 532c 2063 ation. BtrFS, c │ │ │ │ │ -00038f90: 7069 6f2c 2074 6172 2c0a 7371 7561 7368 pio, tar,.squash │ │ │ │ │ -00038fa0: 342c 206d 696e 6978 2c20 6d69 6e69 7832 4, minix, minix2 │ │ │ │ │ -00038fb0: 2c20 6d69 6e69 7833 2c20 524f 4d46 532c , minix3, ROMFS, │ │ │ │ │ -00038fc0: 2052 6569 7365 7246 532c 2058 4653 2c20 ReiserFS, XFS, │ │ │ │ │ -00038fd0: 6578 7432 2c20 6578 7433 2c20 6578 7434 ext2, ext3, ext4 │ │ │ │ │ -00038fe0: 2c0a 4641 5420 2873 686f 7274 206e 616d ,.FAT (short nam │ │ │ │ │ -00038ff0: 6573 292c 2046 3246 532c 2052 6f63 6b52 es), F2FS, RockR │ │ │ │ │ -00039000: 6964 6765 2070 6172 7420 6f66 2049 534f idge part of ISO │ │ │ │ │ -00039010: 3936 3630 2c20 6e69 6c66 7332 2c20 5546 9660, nilfs2, UF │ │ │ │ │ -00039020: 5331 2c20 5546 5332 0a61 6e64 205a 4653 S1, UFS2.and ZFS │ │ │ │ │ -00039030: 2061 7265 2061 7373 756d 6564 2074 6f20 are assumed to │ │ │ │ │ -00039040: 6265 2055 5446 2d38 2e20 2054 6869 7320 be UTF-8. This │ │ │ │ │ -00039050: 6d69 6768 7420 6265 2066 616c 7365 206f might be false o │ │ │ │ │ -00039060: 6e20 7379 7374 656d 730a 636f 6e66 6967 n systems.config │ │ │ │ │ -00039070: 7572 6564 2077 6974 6820 6c65 6761 6379 ured with legacy │ │ │ │ │ -00039080: 2063 6861 7273 6574 2062 7574 2061 7320 charset but as │ │ │ │ │ -00039090: 6c6f 6e67 2061 7320 7468 6520 6368 6172 long as the char │ │ │ │ │ -000390a0: 7365 7420 7573 6564 2069 730a 7375 7065 set used is.supe │ │ │ │ │ -000390b0: 7273 6574 206f 6620 4153 4349 4920 796f rset of ASCII yo │ │ │ │ │ -000390c0: 7520 7368 6f75 6c64 2062 6520 6162 6c65 u should be able │ │ │ │ │ -000390d0: 2074 6f20 6163 6365 7373 2041 5343 4949 to access ASCII │ │ │ │ │ -000390e0: 2d6e 616d 6564 2066 696c 6573 2e20 2041 -named files. A │ │ │ │ │ -000390f0: 6e64 0a69 7427 7320 7265 636f 6d6d 656e nd.it's recommen │ │ │ │ │ -00039100: 6465 6420 746f 2063 6f6e 6669 6775 7265 ded to configure │ │ │ │ │ -00039110: 2079 6f75 7220 7379 7374 656d 2074 6f20 your system to │ │ │ │ │ -00039120: 7573 6520 5554 462d 3820 746f 2061 6363 use UTF-8 to acc │ │ │ │ │ -00039130: 6573 7320 7468 650a 6669 6c65 7379 7374 ess the.filesyst │ │ │ │ │ -00039140: 656d 2c20 636f 6e76 6d76 206d 6179 2068 em, convmv may h │ │ │ │ │ -00039150: 656c 7020 7769 7468 206d 6967 7261 7469 elp with migrati │ │ │ │ │ -00039160: 6f6e 2e20 2049 534f 3936 3630 2028 706c on. ISO9660 (pl │ │ │ │ │ -00039170: 6169 6e29 2066 696c 656e 616d 6573 0a61 ain) filenames.a │ │ │ │ │ -00039180: 7265 2073 7065 6369 6669 6564 2061 7320 re specified as │ │ │ │ │ -00039190: 6265 696e 6720 4153 4349 4920 6f72 2062 being ASCII or b │ │ │ │ │ -000391a0: 6569 6e67 2064 6573 6372 6962 6564 2077 eing described w │ │ │ │ │ -000391b0: 6974 6820 756e 7370 6563 6966 6965 6420 ith unspecified │ │ │ │ │ -000391c0: 6573 6361 7065 0a73 6571 7565 6e63 6573 escape.sequences │ │ │ │ │ -000391d0: 2e20 2047 5255 4220 6173 7375 6d65 7320 . GRUB assumes │ │ │ │ │ -000391e0: 7468 6174 2074 6865 2049 534f 3936 3630 that the ISO9660 │ │ │ │ │ -000391f0: 206e 616d 6573 2061 7265 2055 5446 2d38 names are UTF-8 │ │ │ │ │ -00039200: 2028 7369 6e63 6520 616e 790a 4153 4349 (since any.ASCI │ │ │ │ │ -00039210: 4920 6973 2076 616c 6964 2055 5446 2d38 I is valid UTF-8 │ │ │ │ │ -00039220: 292e 2020 5468 6572 6520 6172 6520 736f ). There are so │ │ │ │ │ -00039230: 6d65 206f 6c64 2043 442d 524f 4d73 2077 me old CD-ROMs w │ │ │ │ │ -00039240: 6869 6368 2075 7365 2043 5034 3337 2069 hich use CP437 i │ │ │ │ │ -00039250: 6e0a 6e6f 6e2d 636f 6d70 6c69 616e 7420 n.non-compliant │ │ │ │ │ -00039260: 7761 792e 2020 596f 7527 7265 2073 7469 way. You're sti │ │ │ │ │ -00039270: 6c6c 2061 626c 6520 746f 2061 6363 6573 ll able to acces │ │ │ │ │ -00039280: 7320 6669 6c65 7320 7769 7468 206e 616d s files with nam │ │ │ │ │ -00039290: 6573 0a63 6f6e 7461 696e 696e 6720 6f6e es.containing on │ │ │ │ │ -000392a0: 6c79 2041 5343 4949 2063 6861 7261 6374 ly ASCII charact │ │ │ │ │ -000392b0: 6572 7320 6f6e 2073 7563 6820 6669 6c65 ers on such file │ │ │ │ │ -000392c0: 7379 7374 656d 7320 7468 6f75 6768 2e20 systems though. │ │ │ │ │ -000392d0: 2059 6f75 2772 650a 616c 736f 2061 626c You're.also abl │ │ │ │ │ -000392e0: 6520 746f 2061 6363 6573 7320 616e 7920 e to access any │ │ │ │ │ -000392f0: 6669 6c65 2069 6620 7468 6520 6669 6c65 file if the file │ │ │ │ │ -00039300: 7379 7374 656d 2063 6f6e 7461 696e 7320 system contains │ │ │ │ │ -00039310: 7661 6c69 6420 4a6f 6c69 6574 0a28 5554 valid Joliet.(UT │ │ │ │ │ -00039320: 462d 3136 2920 6f72 2052 6f63 6b52 6964 F-16) or RockRid │ │ │ │ │ -00039330: 6765 2028 5554 462d 3829 2e20 2041 4646 ge (UTF-8). AFF │ │ │ │ │ -00039340: 532c 2053 4653 2061 6e64 2048 4653 206e S, SFS and HFS n │ │ │ │ │ -00039350: 6576 6572 2075 7365 2075 6e69 636f 6465 ever use unicode │ │ │ │ │ -00039360: 2061 6e64 0a47 5255 4220 6173 7375 6d65 and.GRUB assume │ │ │ │ │ -00039370: 7320 7468 656d 2074 6f20 6265 2069 6e20 s them to be in │ │ │ │ │ -00039380: 4c61 7469 6e31 2c20 4c61 7469 6e31 2061 Latin1, Latin1 a │ │ │ │ │ -00039390: 6e64 204d 6163 526f 6d61 6e20 7265 7370 nd MacRoman resp │ │ │ │ │ -000393a0: 6563 7469 7665 6c79 2e0a 4752 5542 2068 ectively..GRUB h │ │ │ │ │ -000393b0: 616e 646c 6573 2066 696c 6573 7973 7465 andles filesyste │ │ │ │ │ -000393c0: 6d20 6361 7365 2d69 6e73 656e 7369 7469 m case-insensiti │ │ │ │ │ -000393d0: 7669 7479 2068 6f77 6576 6572 206e 6f20 vity however no │ │ │ │ │ -000393e0: 6174 7465 6d70 7420 6973 0a70 6572 666f attempt is.perfo │ │ │ │ │ -000393f0: 726d 6564 2061 7420 6361 7365 2063 6f6e rmed at case con │ │ │ │ │ -00039400: 7665 7273 696f 6e20 6f66 2069 6e74 6572 version of inter │ │ │ │ │ -00039410: 6e61 7469 6f6e 616c 2063 6861 7261 6374 national charact │ │ │ │ │ -00039420: 6572 7320 736f 2065 2e67 2e20 2061 2066 ers so e.g. a f │ │ │ │ │ -00039430: 696c 650a 6e61 6d65 6420 6c6f 7765 7263 ile.named lowerc │ │ │ │ │ -00039440: 6173 6520 6772 6565 6b20 616c 7068 6120 ase greek alpha │ │ │ │ │ -00039450: 6973 2074 7265 6174 6564 2061 7320 6469 is treated as di │ │ │ │ │ -00039460: 6666 6572 656e 7420 6672 6f6d 2074 6865 fferent from the │ │ │ │ │ -00039470: 206f 6e65 206e 616d 6564 0a61 7320 7570 one named.as up │ │ │ │ │ -00039480: 7065 7263 6173 6520 616c 7068 612e 2020 percase alpha. │ │ │ │ │ -00039490: 5468 6520 6669 6c65 7379 7374 656d 7320 The filesystems │ │ │ │ │ -000394a0: 696e 2071 7565 7374 696f 6e73 2061 7265 in questions are │ │ │ │ │ -000394b0: 204e 5446 5320 2865 7863 6570 7420 504f NTFS (except PO │ │ │ │ │ -000394c0: 5349 580a 6e61 6d65 7370 6163 6529 2c20 SIX.namespace), │ │ │ │ │ -000394d0: 4846 532b 2028 636f 6e66 6967 7572 6162 HFS+ (configurab │ │ │ │ │ -000394e0: 6c65 2061 7420 6d6b 6673 2074 696d 652c le at mkfs time, │ │ │ │ │ -000394f0: 2064 6566 6175 6c74 2069 6e73 656e 7369 default insensi │ │ │ │ │ -00039500: 7469 7665 292c 2053 4653 0a28 636f 6e66 tive), SFS.(conf │ │ │ │ │ -00039510: 6967 7572 6162 6c65 2061 7420 6d6b 6673 igurable at mkfs │ │ │ │ │ -00039520: 2074 696d 652c 2064 6566 6175 6c74 2069 time, default i │ │ │ │ │ -00039530: 6e73 656e 7369 7469 7665 292c 204a 4653 nsensitive), JFS │ │ │ │ │ -00039540: 2028 636f 6e66 6967 7572 6162 6c65 2061 (configurable a │ │ │ │ │ -00039550: 740a 6d6b 6673 2074 696d 652c 2064 6566 t.mkfs time, def │ │ │ │ │ -00039560: 6175 6c74 2073 656e 7369 7469 7665 292c ault sensitive), │ │ │ │ │ -00039570: 2048 4653 2c20 4146 4653 2c20 4641 542c HFS, AFFS, FAT, │ │ │ │ │ -00039580: 2065 7846 4154 2061 6e64 205a 4653 0a28 exFAT and ZFS.( │ │ │ │ │ -00039590: 636f 6e66 6967 7572 6162 6c65 206f 6e20 configurable on │ │ │ │ │ -000395a0: 7065 722d 7375 6276 6f6c 756d 6520 6261 per-subvolume ba │ │ │ │ │ -000395b0: 7369 7320 6279 2070 726f 7065 7274 7920 sis by property │ │ │ │ │ -000395c0: 2263 6173 6573 656e 7369 7469 7669 7479 "casesensitivity │ │ │ │ │ -000395d0: 222c 0a64 6566 6175 6c74 2073 656e 7369 ",.default sensi │ │ │ │ │ -000395e0: 7469 7665 292e 2020 4f6e 205a 4653 2073 tive). On ZFS s │ │ │ │ │ -000395f0: 7562 766f 6c75 6d65 7320 6d61 726b 6564 ubvolumes marked │ │ │ │ │ -00039600: 2061 7320 6361 7365 2069 6e73 656e 7369 as case insensi │ │ │ │ │ -00039610: 7469 7665 2066 696c 6573 0a63 6f6e 7461 tive files.conta │ │ │ │ │ -00039620: 696e 696e 6720 6c6f 7765 7263 6173 6520 ining lowercase │ │ │ │ │ -00039630: 696e 7465 726e 6174 696f 6e61 6c20 6368 international ch │ │ │ │ │ -00039640: 6172 6163 7465 7273 2061 7265 2069 6e61 aracters are ina │ │ │ │ │ -00039650: 6363 6573 7369 626c 652e 2020 416c 736f ccessible. Also │ │ │ │ │ -00039660: 0a6c 696b 6520 616c 6c20 7375 7070 6f72 .like all suppor │ │ │ │ │ -00039670: 7465 6420 6669 6c65 7379 7374 656d 7320 ted filesystems │ │ │ │ │ -00039680: 6578 6365 7074 2048 4653 2b20 616e 6420 except HFS+ and │ │ │ │ │ -00039690: 5a46 5320 2863 6f6e 6669 6775 7261 626c ZFS (configurabl │ │ │ │ │ -000396a0: 6520 6f6e 0a70 6572 2d73 7562 766f 6c75 e on.per-subvolu │ │ │ │ │ -000396b0: 6d65 2062 6173 6973 2062 7920 7072 6f70 me basis by prop │ │ │ │ │ -000396c0: 6572 7479 2022 6e6f 726d 616c 697a 6174 erty "normalizat │ │ │ │ │ -000396d0: 696f 6e22 2c20 6465 6661 756c 7420 6e6f ion", default no │ │ │ │ │ -000396e0: 6e65 2920 4752 5542 0a6d 616b 6573 206e ne) GRUB.makes n │ │ │ │ │ -000396f0: 6f20 6174 7465 6d70 7420 6174 2063 6865 o attempt at che │ │ │ │ │ -00039700: 636b 206f 6620 6361 6e6f 6e69 6361 6c20 ck of canonical │ │ │ │ │ -00039710: 6571 7569 7661 6c65 6e63 6520 736f 2061 equivalence so a │ │ │ │ │ -00039720: 2066 696c 6520 6e61 6d65 0a75 2d64 6961 file name.u-dia │ │ │ │ │ -00039730: 7265 7369 7320 6973 2074 7265 6174 6564 resis is treated │ │ │ │ │ -00039740: 2061 7320 6469 7374 696e 6374 2066 726f as distinct fro │ │ │ │ │ -00039750: 6d20 752b 636f 6d62 696e 696e 6720 6469 m u+combining di │ │ │ │ │ -00039760: 6172 6573 6973 2e20 2054 6869 730a 686f aresis. This.ho │ │ │ │ │ -00039770: 7765 7665 7220 6d65 616e 7320 7468 6174 wever means that │ │ │ │ │ -00039780: 2069 6e20 6f72 6465 7220 746f 2061 6363 in order to acc │ │ │ │ │ -00039790: 6573 7320 6669 6c65 206f 6e20 4846 532b ess file on HFS+ │ │ │ │ │ -000397a0: 2069 7473 206e 616d 6520 6d75 7374 2062 its name must b │ │ │ │ │ -000397b0: 650a 7370 6563 6966 6965 6420 696e 206e e.specified in n │ │ │ │ │ -000397c0: 6f72 6d61 6c69 7361 7469 6f6e 2066 6f72 ormalisation for │ │ │ │ │ -000397d0: 6d20 442e 204f 6e20 6e6f 726d 616c 697a m D. On normaliz │ │ │ │ │ -000397e0: 6564 205a 4653 2073 7562 766f 6c75 6d65 ed ZFS subvolume │ │ │ │ │ -000397f0: 730a 6669 6c65 6e61 6d65 7320 6f75 7420 s.filenames out │ │ │ │ │ -00039800: 6f66 206e 6f72 6d61 6c69 7361 7469 6f6e of normalisation │ │ │ │ │ -00039810: 2061 7265 2069 6e61 6363 6573 7369 626c are inaccessibl │ │ │ │ │ -00039820: 652e 0a0a 3137 2e33 204f 7574 7075 7420 e...17.3 Output │ │ │ │ │ -00039830: 7465 726d 696e 616c 0a3d 3d3d 3d3d 3d3d terminal.======= │ │ │ │ │ -00039840: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a46 =============..F │ │ │ │ │ -00039850: 6972 6d77 6172 6520 6f75 7470 7574 2063 irmware output c │ │ │ │ │ -00039860: 6f6e 736f 6c65 2022 636f 6e73 6f6c 6522 onsole "console" │ │ │ │ │ -00039870: 206f 6e20 4152 4320 616e 6420 4945 4545 on ARC and IEEE │ │ │ │ │ -00039880: 3132 3735 2061 7265 206c 696d 6974 6564 1275 are limited │ │ │ │ │ -00039890: 2074 6f0a 4153 4349 492e 0a0a 2020 2042 to.ASCII... B │ │ │ │ │ -000398a0: 494f 5320 6669 726d 7761 7265 2063 6f6e IOS firmware con │ │ │ │ │ -000398b0: 736f 6c65 2061 6e64 2056 4741 2074 6578 sole and VGA tex │ │ │ │ │ -000398c0: 7420 6172 6520 6c69 6d69 7465 6420 746f t are limited to │ │ │ │ │ -000398d0: 2041 5343 4949 2061 6e64 2073 6f6d 650a ASCII and some. │ │ │ │ │ -000398e0: 7073 6575 646f 6772 6170 6869 6373 2e0a pseudographics.. │ │ │ │ │ -000398f0: 0a20 2020 4e6f 6e65 206f 6620 6162 6f76 . None of abov │ │ │ │ │ -00039900: 6520 6d65 6e74 696f 6e65 6420 6973 2061 e mentioned is a │ │ │ │ │ -00039910: 7070 726f 7072 6961 7465 2066 6f72 2064 ppropriate for d │ │ │ │ │ -00039920: 6973 706c 6179 696e 6720 696e 7465 726e isplaying intern │ │ │ │ │ -00039930: 6174 696f 6e61 6c0a 616e 6420 616e 7920 ational.and any │ │ │ │ │ -00039940: 756e 7375 7070 6f72 7465 6420 6368 6172 unsupported char │ │ │ │ │ -00039950: 6163 7465 7220 6973 2072 6570 6c61 6365 acter is replace │ │ │ │ │ -00039960: 6420 7769 7468 2071 7565 7374 696f 6e20 d with question │ │ │ │ │ -00039970: 6d61 726b 2065 7863 6570 740a 7073 6575 mark except.pseu │ │ │ │ │ -00039980: 646f 6772 6170 6869 6373 2077 6869 6368 dographics which │ │ │ │ │ -00039990: 2077 6520 6174 7465 6d70 7420 746f 2061 we attempt to a │ │ │ │ │ -000399a0: 7070 726f 7869 6d61 7465 2077 6974 6820 pproximate with │ │ │ │ │ -000399b0: 4153 4349 492e 0a0a 2020 2045 4649 2063 ASCII... EFI c │ │ │ │ │ -000399c0: 6f6e 736f 6c65 206f 6e20 7468 6520 6f74 onsole on the ot │ │ │ │ │ -000399d0: 6865 7220 6861 6e64 206e 6f6d 696e 616c her hand nominal │ │ │ │ │ -000399e0: 6c79 2073 7570 706f 7274 7320 5554 462d ly supports UTF- │ │ │ │ │ -000399f0: 3136 2062 7574 2061 6374 7561 6c0a 6c61 16 but actual.la │ │ │ │ │ -00039a00: 6e67 7561 6765 2063 6f76 6572 6167 6520 nguage coverage │ │ │ │ │ -00039a10: 6465 7065 6e64 7320 6f6e 2066 6972 6d77 depends on firmw │ │ │ │ │ -00039a20: 6172 6520 616e 6420 6d61 7920 6265 2076 are and may be v │ │ │ │ │ -00039a30: 6572 7920 6c69 6d69 7465 642e 0a0a 2020 ery limited... │ │ │ │ │ -00039a40: 2054 6865 2065 6e63 6f64 696e 6720 7573 The encoding us │ │ │ │ │ -00039a50: 6564 206f 6e20 7365 7269 616c 2063 616e ed on serial can │ │ │ │ │ -00039a60: 2062 6520 6368 6f73 656e 2077 6974 6820 be chosen with │ │ │ │ │ -00039a70: 2774 6572 6d69 6e66 6f27 2061 7320 6569 'terminfo' as ei │ │ │ │ │ -00039a80: 7468 6572 0a41 5343 4949 2c20 5554 462d ther.ASCII, UTF- │ │ │ │ │ -00039a90: 3820 6f72 2022 7669 7375 616c 2055 5446 8 or "visual UTF │ │ │ │ │ -00039aa0: 2d38 222e 2020 4c61 7374 206f 6e65 2069 -8". Last one i │ │ │ │ │ -00039ab0: 7320 6167 6169 6e73 7420 7468 6520 7370 s against the sp │ │ │ │ │ -00039ac0: 6563 6966 6963 6174 696f 6e0a 6275 7420 ecification.but │ │ │ │ │ -00039ad0: 7265 7375 6c74 7320 696e 2063 6f72 7265 results in corre │ │ │ │ │ -00039ae0: 6374 2072 656e 6465 7269 6e67 206f 6620 ct rendering of │ │ │ │ │ -00039af0: 7269 6768 742d 746f 2d6c 6566 7420 6f6e right-to-left on │ │ │ │ │ -00039b00: 2073 6f6d 6520 7265 6164 6572 7320 7768 some readers wh │ │ │ │ │ -00039b10: 6963 680a 646f 6e27 7420 6861 7665 206f ich.don't have o │ │ │ │ │ -00039b20: 776e 2062 6964 6920 696d 706c 656d 656e wn bidi implemen │ │ │ │ │ -00039b30: 7461 7469 6f6e 2e0a 0a20 2020 4f6e 2065 tation... On e │ │ │ │ │ -00039b40: 6d75 2047 5255 4220 6368 6563 6b73 2069 mu GRUB checks i │ │ │ │ │ -00039b50: 6620 6368 6172 7365 7420 6973 2055 5446 f charset is UTF │ │ │ │ │ -00039b60: 2d38 2061 6e64 2075 7365 7320 6974 2069 -8 and uses it i │ │ │ │ │ -00039b70: 6620 736f 2061 6e64 2075 7365 730a 4153 f so and uses.AS │ │ │ │ │ -00039b80: 4349 4920 6f74 6865 7277 6973 652e 0a0a CII otherwise... │ │ │ │ │ -00039b90: 2020 2057 6865 6e20 7573 696e 6720 6766 When using gf │ │ │ │ │ -00039ba0: 7874 6572 6d20 6f72 2067 6678 6d65 6e75 xterm or gfxmenu │ │ │ │ │ -00039bb0: 2047 5255 4220 6974 7365 6c66 2069 7320 GRUB itself is │ │ │ │ │ -00039bc0: 7265 7370 6f6e 7369 626c 6520 666f 720a responsible for. │ │ │ │ │ -00039bd0: 7265 6e64 6572 696e 6720 7468 6520 7465 rendering the te │ │ │ │ │ -00039be0: 7874 2e20 2049 6e20 7468 6973 2063 6173 xt. In this cas │ │ │ │ │ -00039bf0: 6520 4752 5542 2069 7320 6c69 6d69 7465 e GRUB is limite │ │ │ │ │ -00039c00: 6420 6279 206c 6f61 6465 6420 666f 6e74 d by loaded font │ │ │ │ │ -00039c10: 732e 2020 4966 0a66 6f6e 7473 2063 6f6e s. If.fonts con │ │ │ │ │ -00039c20: 7461 696e 2061 6c6c 2072 6571 7569 7265 tain all require │ │ │ │ │ -00039c30: 6420 6368 6172 6163 7465 7273 2074 6865 d characters the │ │ │ │ │ -00039c40: 6e20 6269 6469 7265 6374 696f 6e61 6c20 n bidirectional │ │ │ │ │ -00039c50: 7465 7874 2c20 6375 7273 6976 650a 7661 text, cursive.va │ │ │ │ │ -00039c60: 7269 616e 7473 2061 6e64 2063 6f6d 6269 riants and combi │ │ │ │ │ -00039c70: 6e69 6e67 206d 6172 6b73 206f 7468 6572 ning marks other │ │ │ │ │ -00039c80: 2074 6861 6e20 656e 636c 6f73 696e 672c than enclosing, │ │ │ │ │ -00039c90: 2068 616c 6620 2865 2e67 2e20 206c 6566 half (e.g. lef │ │ │ │ │ -00039ca0: 7420 6861 6c66 0a74 696c 6465 206f 7220 t half.tilde or │ │ │ │ │ -00039cb0: 636f 6d62 696e 696e 6720 6f76 6572 6c69 combining overli │ │ │ │ │ -00039cc0: 6e65 2920 616e 6420 646f 7562 6c65 206f ne) and double o │ │ │ │ │ -00039cd0: 6e65 732e 2020 4c69 6761 7475 7265 7320 nes. Ligatures │ │ │ │ │ -00039ce0: 6172 656e 2774 0a73 7570 706f 7274 6564 aren't.supported │ │ │ │ │ -00039cf0: 2074 686f 7567 682e 2020 5468 6973 2073 though. This s │ │ │ │ │ -00039d00: 686f 756c 6420 636f 7665 7220 4575 726f hould cover Euro │ │ │ │ │ -00039d10: 7065 616e 2c20 4d69 6464 6c65 2045 6173 pean, Middle Eas │ │ │ │ │ -00039d20: 7465 726e 2028 6966 2079 6f75 0a64 6f6e tern (if you.don │ │ │ │ │ -00039d30: 2774 206d 696e 6420 6c61 636b 206f 6620 't mind lack of │ │ │ │ │ -00039d40: 6c61 6d2d 616c 6966 206c 6967 6174 7572 lam-alif ligatur │ │ │ │ │ -00039d50: 6520 696e 2041 7261 6269 6329 2061 6e64 e in Arabic) and │ │ │ │ │ -00039d60: 2045 6173 7420 4173 6961 6e20 7363 7269 East Asian scri │ │ │ │ │ -00039d70: 7074 732e 0a4e 6f74 6162 6c65 2075 6e73 pts..Notable uns │ │ │ │ │ -00039d80: 7570 706f 7274 6564 2073 6372 6970 7473 upported scripts │ │ │ │ │ -00039d90: 2061 7265 2042 7261 686d 6963 2066 616d are Brahmic fam │ │ │ │ │ -00039da0: 696c 7920 616e 6420 6465 7269 7665 6420 ily and derived │ │ │ │ │ -00039db0: 6173 2077 656c 6c20 6173 0a4d 6f6e 676f as well as.Mongo │ │ │ │ │ -00039dc0: 6c69 616e 2c20 5469 6669 6e61 6768 2c20 lian, Tifinagh, │ │ │ │ │ -00039dd0: 4b6f 7265 616e 204a 616d 6f20 2870 7265 Korean Jamo (pre │ │ │ │ │ -00039de0: 636f 6d70 6f73 6564 2063 6861 7261 6374 composed charact │ │ │ │ │ -00039df0: 6572 7320 6861 7665 206e 6f0a 7072 6f62 ers have no.prob │ │ │ │ │ -00039e00: 6c65 6d29 2061 6e64 2074 6f6e 616c 2077 lem) and tonal w │ │ │ │ │ -00039e10: 7269 7469 6e67 2028 3265 352d 3265 3929 riting (2e5-2e9) │ │ │ │ │ -00039e20: 2e20 2047 5255 4220 616c 736f 2069 676e . GRUB also ign │ │ │ │ │ -00039e30: 6f72 6573 2064 6570 7265 6361 7465 6420 ores deprecated │ │ │ │ │ -00039e40: 2861 730a 7370 6563 6966 6965 6420 696e (as.specified in │ │ │ │ │ -00039e50: 2055 6e69 636f 6465 2920 6368 6172 6163 Unicode) charac │ │ │ │ │ -00039e60: 7465 7273 2028 652e 672e 2020 7461 6773 ters (e.g. tags │ │ │ │ │ -00039e70: 292e 2020 4752 5542 2061 6c73 6f20 646f ). GRUB also do │ │ │ │ │ -00039e80: 6573 6e27 7420 6861 6e64 6c65 0a73 6f20 esn't handle.so │ │ │ │ │ -00039e90: 6361 6c6c 6564 2022 616e 6e6f 7461 7469 called "annotati │ │ │ │ │ -00039ea0: 6f6e 2063 6861 7261 6374 6572 7322 2049 on characters" I │ │ │ │ │ -00039eb0: 6620 796f 7520 6361 6e20 636f 6d70 6c65 f you can comple │ │ │ │ │ -00039ec0: 7465 2065 6974 6865 7220 6f66 2074 776f te either of two │ │ │ │ │ -00039ed0: 0a6c 6973 7473 206f 722c 2062 6574 7465 .lists or, bette │ │ │ │ │ -00039ee0: 722c 2070 726f 706f 7365 2061 2070 6174 r, propose a pat │ │ │ │ │ -00039ef0: 6368 2074 6f20 696d 7072 6f76 6520 7265 ch to improve re │ │ │ │ │ -00039f00: 6e64 6572 696e 672c 2070 6c65 6173 6520 ndering, please │ │ │ │ │ -00039f10: 636f 6e74 6163 740a 6465 7665 6c6f 7065 contact.develope │ │ │ │ │ -00039f20: 7220 7465 616d 2e0a 0a31 372e 3420 496e r team...17.4 In │ │ │ │ │ -00039f30: 7075 7420 7465 726d 696e 616c 0a3d 3d3d put terminal.=== │ │ │ │ │ -00039f40: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00039f50: 0a0a 4669 726d 7761 7265 2063 6f6e 736f ..Firmware conso │ │ │ │ │ -00039f60: 6c65 206f 6e20 4249 4f53 2c20 4945 4545 le on BIOS, IEEE │ │ │ │ │ -00039f70: 3132 3735 2061 6e64 2041 5243 2064 6f65 1275 and ARC doe │ │ │ │ │ -00039f80: 736e 2774 2061 6c6c 6f77 2079 6f75 2074 sn't allow you t │ │ │ │ │ -00039f90: 6f20 656e 7465 720a 6e6f 6e2d 4153 4349 o enter.non-ASCI │ │ │ │ │ -00039fa0: 4920 6368 6172 6163 7465 7273 2e20 2045 I characters. E │ │ │ │ │ -00039fb0: 4649 2073 7065 6369 6669 6361 7469 6f6e FI specification │ │ │ │ │ -00039fc0: 2061 6c6c 6f77 7320 666f 7220 7375 6368 allows for such │ │ │ │ │ -00039fd0: 2062 7574 2061 7574 686f 7220 6973 0a75 but author is.u │ │ │ │ │ -00039fe0: 6e61 7761 7265 206f 6620 616e 7920 6163 naware of any ac │ │ │ │ │ -00039ff0: 7475 616c 2069 6d70 6c65 6d65 6e74 6174 tual implementat │ │ │ │ │ -0003a000: 696f 6e73 2e20 2053 6572 6961 6c20 696e ions. Serial in │ │ │ │ │ -0003a010: 7075 7420 6973 2063 7572 7265 6e74 6c79 put is currently │ │ │ │ │ -0003a020: 0a6c 696d 6974 6564 2066 6f72 206c 6174 .limited for lat │ │ │ │ │ -0003a030: 696e 3120 2875 6e6c 696b 656c 7920 746f in1 (unlikely to │ │ │ │ │ -0003a040: 2063 6861 6e67 6529 2e20 204f 776e 206b change). Own k │ │ │ │ │ -0003a050: 6579 626f 6172 6420 696d 706c 656d 656e eyboard implemen │ │ │ │ │ -0003a060: 7461 7469 6f6e 730a 2861 745f 6b65 7962 tations.(at_keyb │ │ │ │ │ -0003a070: 6f61 7264 2061 6e64 2075 7362 5f6b 6579 oard and usb_key │ │ │ │ │ -0003a080: 626f 6172 6429 2073 7570 706f 7274 7320 board) supports │ │ │ │ │ -0003a090: 616e 7920 6b65 7920 6275 7420 776f 726b any key but work │ │ │ │ │ -0003a0a0: 206f 6e0a 6f6e 652d 6368 6172 2d70 6572 on.one-char-per │ │ │ │ │ -0003a0b0: 2d6b 6579 7374 726f 6b65 2e20 2053 6f20 -keystroke. So │ │ │ │ │ -0003a0c0: 6e6f 2064 6561 6420 6b65 7973 206f 7220 no dead keys or │ │ │ │ │ -0003a0d0: 6164 7661 6e63 6564 2069 6e70 7574 206d advanced input m │ │ │ │ │ -0003a0e0: 6574 686f 642e 2020 416c 736f 0a74 6865 ethod. Also.the │ │ │ │ │ -0003a0f0: 7265 2069 7320 6e6f 206b 6579 6d61 7020 re is no keymap │ │ │ │ │ -0003a100: 6368 616e 6765 2068 6f74 6b65 792e 2020 change hotkey. │ │ │ │ │ -0003a110: 496e 2070 7261 6374 6963 6520 6974 206d In practice it m │ │ │ │ │ -0003a120: 616b 6573 2064 6966 6669 6375 6c74 2074 akes difficult t │ │ │ │ │ -0003a130: 6f0a 656e 7465 7220 616e 7920 7465 7874 o.enter any text │ │ │ │ │ -0003a140: 2075 7369 6e67 206e 6f6e 2d4c 6174 696e using non-Latin │ │ │ │ │ -0003a150: 2061 6c70 6861 6265 742e 2020 4d6f 7265 alphabet. More │ │ │ │ │ -0003a160: 6f76 6572 2061 6c6c 2063 7572 7265 6e74 over all current │ │ │ │ │ -0003a170: 2069 6e70 7574 0a63 6f6e 7375 6d65 7273 input.consumers │ │ │ │ │ -0003a180: 2061 7265 206c 696d 6974 6564 2074 6f20 are limited to │ │ │ │ │ -0003a190: 4153 4349 492e 0a0a 3137 2e35 2047 6574 ASCII...17.5 Get │ │ │ │ │ -0003a1a0: 7465 7874 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d text.=========== │ │ │ │ │ -0003a1b0: 3d0a 0a47 5255 4220 7375 7070 6f72 7473 =..GRUB supports │ │ │ │ │ -0003a1c0: 2062 6569 6e67 2074 7261 6e73 6c61 7465 being translate │ │ │ │ │ -0003a1d0: 642e 2020 466f 7220 7468 6973 2079 6f75 d. For this you │ │ │ │ │ -0003a1e0: 206e 6565 6420 746f 2068 6176 6520 6c61 need to have la │ │ │ │ │ -0003a1f0: 6e67 7561 6765 202a 2e6d 6f0a 6669 6c65 nguage *.mo.file │ │ │ │ │ -0003a200: 7320 696e 2024 7072 6566 6978 2f6c 6f63 s in $prefix/loc │ │ │ │ │ -0003a210: 616c 652c 206c 6f61 6420 6765 7474 6578 ale, load gettex │ │ │ │ │ -0003a220: 7420 6d6f 6475 6c65 2061 6e64 2073 6574 t module and set │ │ │ │ │ -0003a230: 2022 6c61 6e67 2220 7661 7269 6162 6c65 "lang" variable │ │ │ │ │ -0003a240: 2e0a 0a31 372e 3620 5265 6765 7870 0a3d ...17.6 Regexp.= │ │ │ │ │ -0003a250: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 5265 6765 ==========..Rege │ │ │ │ │ -0003a260: 7870 7320 776f 726b 206f 6e20 756e 6963 xps work on unic │ │ │ │ │ -0003a270: 6f64 6520 6368 6172 6163 7465 7273 2c20 ode characters, │ │ │ │ │ -0003a280: 686f 7765 7665 7220 6e6f 2061 7474 656d however no attem │ │ │ │ │ -0003a290: 7074 2061 7420 6368 6563 6b69 6e67 0a63 pt at checking.c │ │ │ │ │ -0003a2a0: 616e 6e6f 6e69 6361 6c20 6571 7569 7661 annonical equiva │ │ │ │ │ -0003a2b0: 6c65 6e63 6520 6861 7320 6265 656e 206d lence has been m │ │ │ │ │ -0003a2c0: 6164 652e 2020 4d6f 7265 6f76 6572 2074 ade. Moreover t │ │ │ │ │ -0003a2d0: 6865 2063 6c61 7373 6573 206c 696b 650a he classes like. │ │ │ │ │ -0003a2e0: 5b3a 616c 7068 613a 5d20 6d61 7463 6820 [:alpha:] match │ │ │ │ │ -0003a2f0: 6f6e 6c79 2041 5343 4949 2073 7562 7365 only ASCII subse │ │ │ │ │ -0003a300: 742e 0a0a 3137 2e37 204f 7468 6572 0a3d t...17.7 Other.= │ │ │ │ │ -0003a310: 3d3d 3d3d 3d3d 3d3d 3d0a 0a43 7572 7265 =========..Curre │ │ │ │ │ -0003a320: 6e74 6c79 2047 5255 4220 616c 7761 7973 ntly GRUB always │ │ │ │ │ -0003a330: 2075 7365 7320 5945 4152 2d4d 4f4e 5448 uses YEAR-MONTH │ │ │ │ │ -0003a340: 2d44 4159 2048 4f55 523a 4d49 4e55 5445 -DAY HOUR:MINUTE │ │ │ │ │ -0003a350: 3a53 4543 4f4e 4420 5b57 4545 4b44 4159 :SECOND [WEEKDAY │ │ │ │ │ -0003a360: 5d0a 3234 2d68 6f75 7220 6461 7465 7469 ].24-hour dateti │ │ │ │ │ -0003a370: 6d65 2066 6f72 6d61 7420 6275 7420 7765 me format but we │ │ │ │ │ -0003a380: 656b 6461 7973 2061 7265 2074 7261 6e73 ekdays are trans │ │ │ │ │ -0003a390: 6c61 7465 642e 2020 4752 5542 2061 6c77 lated. GRUB alw │ │ │ │ │ -0003a3a0: 6179 7320 7573 6573 0a74 6865 2064 6563 ays uses.the dec │ │ │ │ │ -0003a3b0: 696d 616c 206e 756d 6265 7220 666f 726d imal number form │ │ │ │ │ -0003a3c0: 6174 2077 6974 6820 5b30 2d39 5d20 6173 at with [0-9] as │ │ │ │ │ -0003a3d0: 2064 6967 6974 7320 616e 6420 2e20 2061 digits and . a │ │ │ │ │ -0003a3e0: 7320 6465 7363 696d 616c 0a73 6570 6172 s descimal.separ │ │ │ │ │ -0003a3f0: 6174 6f72 2061 6e64 206e 6f20 6772 6f75 ator and no grou │ │ │ │ │ -0003a400: 7020 7365 7061 7261 746f 722e 2020 4945 p separator. IE │ │ │ │ │ -0003a410: 4545 3132 3735 2061 6c69 6173 6573 2061 EE1275 aliases a │ │ │ │ │ -0003a420: 7265 206d 6174 6368 6564 0a63 6173 652d re matched.case- │ │ │ │ │ -0003a430: 696e 7365 6e73 6974 6976 656c 7920 6578 insensitively ex │ │ │ │ │ -0003a440: 6365 7074 206e 6f6e 2d41 5343 4949 2077 cept non-ASCII w │ │ │ │ │ -0003a450: 6869 6368 2069 7320 6d61 7463 6865 6420 hich is matched │ │ │ │ │ -0003a460: 6173 2062 696e 6172 792e 2020 5369 6d69 as binary. Simi │ │ │ │ │ -0003a470: 6c61 720a 6265 6861 7669 6f75 7220 6973 lar.behaviour is │ │ │ │ │ -0003a480: 2066 6f72 206d 6174 6368 696e 6720 4f53 for matching OS │ │ │ │ │ -0003a490: 4275 6e64 6c65 5265 7175 6972 6564 2e20 BundleRequired. │ │ │ │ │ -0003a4a0: 2053 696e 6365 2049 4545 4531 3237 3520 Since IEEE1275 │ │ │ │ │ -0003a4b0: 616c 6961 7365 7320 616e 640a 4f53 4275 aliases and.OSBu │ │ │ │ │ -0003a4c0: 6e64 6c65 5265 7175 6972 6564 2064 6f6e ndleRequired don │ │ │ │ │ -0003a4d0: 2774 2063 6f6e 7461 696e 2061 6e79 206e 't contain any n │ │ │ │ │ -0003a4e0: 6f6e 2d41 5343 4949 2069 7420 7368 6f75 on-ASCII it shou │ │ │ │ │ -0003a4f0: 6c64 206e 6576 6572 2062 6520 610a 7072 ld never be a.pr │ │ │ │ │ -0003a500: 6f62 6c65 6d20 696e 2070 7261 6374 6963 oblem in practic │ │ │ │ │ -0003a510: 652e 2020 4361 7365 2d73 656e 7369 7469 e. Case-sensiti │ │ │ │ │ -0003a520: 7665 2069 6465 6e74 6966 6965 7273 2061 ve identifiers a │ │ │ │ │ -0003a530: 7265 206d 6174 6368 6564 2061 7320 7261 re matched as ra │ │ │ │ │ -0003a540: 770a 7374 7269 6e67 732c 206e 6f20 6361 w.strings, no ca │ │ │ │ │ -0003a550: 6e6f 6e69 6361 6c20 6571 7569 7661 6c65 nonical equivale │ │ │ │ │ -0003a560: 6e63 6520 6368 6563 6b20 6973 2070 6572 nce check is per │ │ │ │ │ -0003a570: 666f 726d 6564 2e20 2043 6173 652d 696e formed. Case-in │ │ │ │ │ -0003a580: 7365 6e73 7469 7665 0a69 6465 6e74 6966 senstive.identif │ │ │ │ │ -0003a590: 6965 7273 2061 7265 206d 6174 6368 6564 iers are matched │ │ │ │ │ -0003a5a0: 2061 7320 5241 5720 6275 7420 6164 6469 as RAW but addi │ │ │ │ │ -0003a5b0: 7469 6f6e 616c 6c79 205b 612d 7a5d 2069 tionally [a-z] i │ │ │ │ │ -0003a5c0: 7320 6571 7569 7661 6c65 6e74 2074 6f0a s equivalent to. │ │ │ │ │ -0003a5d0: 5b41 2d5a 5d2e 2047 5255 422d 6465 6669 [A-Z]. GRUB-defi │ │ │ │ │ -0003a5e0: 6e65 6420 6964 656e 7469 6669 6572 7320 ned identifiers │ │ │ │ │ -0003a5f0: 7573 6520 6f6e 6c79 2041 5343 4949 2061 use only ASCII a │ │ │ │ │ -0003a600: 6e64 2073 6f20 7368 6f75 6c64 0a75 7365 nd so should.use │ │ │ │ │ -0003a610: 722d 6465 6669 6e65 6420 6f6e 6573 2e20 r-defined ones. │ │ │ │ │ -0003a620: 2049 6465 6e74 6966 6965 7273 2063 6f6e Identifiers con │ │ │ │ │ -0003a630: 7461 696e 696e 6720 6e6f 6e2d 4153 4349 taining non-ASCI │ │ │ │ │ -0003a640: 4920 6d61 7920 776f 726b 2062 7574 2061 I may work but a │ │ │ │ │ -0003a650: 7265 6e27 740a 7375 7070 6f72 7465 642e ren't.supported. │ │ │ │ │ -0003a660: 2020 4f6e 6c79 2074 6865 2041 5343 4949 Only the ASCII │ │ │ │ │ -0003a670: 2073 7061 6365 2063 6861 7261 6374 6572 space character │ │ │ │ │ -0003a680: 7320 2873 7061 6365 2055 2b30 3032 302c s (space U+0020, │ │ │ │ │ -0003a690: 2074 6162 2055 2b30 3030 622c 0a43 5220 tab U+000b,.CR │ │ │ │ │ -0003a6a0: 552b 3030 3064 2061 6e64 204c 4620 552b U+000d and LF U+ │ │ │ │ │ -0003a6b0: 3030 3061 2920 6172 6520 7265 636f 676e 000a) are recogn │ │ │ │ │ -0003a6c0: 6973 6564 2e20 204f 7468 6572 2075 6e69 ised. Other uni │ │ │ │ │ -0003a6d0: 636f 6465 2073 7061 6365 2063 6861 7261 code space chara │ │ │ │ │ -0003a6e0: 6374 6572 730a 6172 656e 2774 2061 2076 cters.aren't a v │ │ │ │ │ -0003a6f0: 616c 6964 2066 6965 6c64 2073 6570 6172 alid field separ │ │ │ │ │ -0003a700: 6174 6f72 2e20 2027 7465 7374 2720 282a ator. 'test' (* │ │ │ │ │ -0003a710: 6e6f 7465 2074 6573 743a 3a29 2074 6573 note test::) tes │ │ │ │ │ -0003a720: 7473 203c 2c20 3e2c 203c 3d2c 0a3e 3d2c ts <, >, <=,.>=, │ │ │ │ │ -0003a730: 202d 7067 7420 616e 6420 2d70 6c74 2063 -pgt and -plt c │ │ │ │ │ -0003a740: 6f6d 7061 7265 2074 6865 2073 7472 696e ompare the strin │ │ │ │ │ -0003a750: 6773 2069 6e20 7468 6520 6c65 7869 636f gs in the lexico │ │ │ │ │ -0003a760: 6772 6170 6869 6361 6c20 6f72 6465 7220 graphical order │ │ │ │ │ -0003a770: 6f66 0a75 6e69 636f 6465 2063 6f64 6570 of.unicode codep │ │ │ │ │ -0003a780: 6f69 6e74 732c 2072 6570 6c69 6361 7469 oints, replicati │ │ │ │ │ -0003a790: 6e67 2074 6865 2062 6568 6176 696f 7572 ng the behaviour │ │ │ │ │ -0003a7a0: 206f 6620 7465 7374 2066 726f 6d20 636f of test from co │ │ │ │ │ -0003a7b0: 7265 7574 696c 732e 0a65 6e76 6972 6f6e reutils..environ │ │ │ │ │ -0003a7c0: 6d65 6e74 2076 6172 6961 626c 6573 2061 ment variables a │ │ │ │ │ -0003a7d0: 6e64 2063 6f6d 6d61 6e64 7320 6172 6520 nd commands are │ │ │ │ │ -0003a7e0: 6c69 7374 6564 2069 6e20 7468 6520 7361 listed in the sa │ │ │ │ │ -0003a7f0: 6d65 206f 7264 6572 2e0a 0a1f 0a46 696c me order.....Fil │ │ │ │ │ -0003a800: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ -0003a810: 6f64 653a 2053 6563 7572 6974 792c 2020 ode: Security, │ │ │ │ │ -0003a820: 4e65 7874 3a20 506c 6174 666f 726d 206c Next: Platform l │ │ │ │ │ -0003a830: 696d 6974 6174 696f 6e73 2c20 2050 7265 imitations, Pre │ │ │ │ │ -0003a840: 763a 2049 6e74 6572 6e61 7469 6f6e 616c v: International │ │ │ │ │ -0003a850: 6973 6174 696f 6e2c 2020 5570 3a20 546f isation, Up: To │ │ │ │ │ -0003a860: 700a 0a31 3820 5365 6375 7269 7479 0a2a p..18 Security.* │ │ │ │ │ -0003a870: 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a 2a20 4d65 **********..* Me │ │ │ │ │ -0003a880: 6e75 3a0a 0a2a 2041 7574 6865 6e74 6963 nu:..* Authentic │ │ │ │ │ -0003a890: 6174 696f 6e20 616e 6420 6175 7468 6f72 ation and author │ │ │ │ │ -0003a8a0: 6973 6174 696f 6e3a 3a20 5573 6572 7320 isation:: Users │ │ │ │ │ -0003a8b0: 616e 6420 6163 6365 7373 2063 6f6e 7472 and access contr │ │ │ │ │ -0003a8c0: 6f6c 0a2a 2055 7369 6e67 2064 6967 6974 ol.* Using digit │ │ │ │ │ -0003a8d0: 616c 2073 6967 6e61 7475 7265 733a 3a20 al signatures:: │ │ │ │ │ -0003a8e0: 2020 2020 2020 2020 426f 6f74 696e 6720 Booting │ │ │ │ │ -0003a8f0: 6469 6769 7461 6c6c 7920 7369 676e 6564 digitally signed │ │ │ │ │ -0003a900: 2063 6f64 650a 2a20 5545 4649 2073 6563 code.* UEFI sec │ │ │ │ │ -0003a910: 7572 6520 626f 6f74 2061 6e64 2073 6869 ure boot and shi │ │ │ │ │ -0003a920: 6d3a 3a20 2020 2020 2020 2042 6f6f 7469 m:: Booti │ │ │ │ │ -0003a930: 6e67 2064 6967 6974 616c 6c79 2073 6967 ng digitally sig │ │ │ │ │ -0003a940: 6e65 6420 5045 2066 696c 6573 0a2a 2053 ned PE files.* S │ │ │ │ │ -0003a950: 6563 7572 6520 426f 6f74 2041 6476 616e ecure Boot Advan │ │ │ │ │ -0003a960: 6365 6420 5461 7267 6574 696e 673a 3a20 ced Targeting:: │ │ │ │ │ -0003a970: 2020 456d 6265 6464 6564 2069 6e66 6f72 Embedded infor │ │ │ │ │ -0003a980: 6d61 7469 6f6e 2066 6f72 2067 656e 6572 mation for gener │ │ │ │ │ -0003a990: 6174 696f 6e20 6e75 6d62 6572 2062 6173 ation number bas │ │ │ │ │ -0003a9a0: 6564 2072 6576 6f63 6174 696f 6e0a 2a20 ed revocation.* │ │ │ │ │ -0003a9b0: 4d65 6173 7572 6564 2042 6f6f 743a 3a20 Measured Boot:: │ │ │ │ │ +00038dd0: 2a2a 2a2a 0a0a 3137 2e31 2043 6861 7273 ****..17.1 Chars │ │ │ │ │ +00038de0: 6574 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a et.============. │ │ │ │ │ +00038df0: 0a47 5255 4220 7573 6573 2055 5446 2d38 .GRUB uses UTF-8 │ │ │ │ │ +00038e00: 2069 6e74 6572 6e61 6c6c 7920 6f74 6865 internally othe │ │ │ │ │ +00038e10: 7220 7468 616e 2069 6e20 7265 6e64 6572 r than in render │ │ │ │ │ +00038e20: 696e 6720 7768 6572 6520 736f 6d65 0a47 ing where some.G │ │ │ │ │ +00038e30: 5255 422d 7370 6563 6966 6963 2061 7070 RUB-specific app │ │ │ │ │ +00038e40: 726f 7072 6961 7465 2072 6570 7265 7365 ropriate represe │ │ │ │ │ +00038e50: 6e74 6174 696f 6e20 6973 2075 7365 642e ntation is used. │ │ │ │ │ +00038e60: 2020 416c 6c20 7465 7874 2066 696c 6573 All text files │ │ │ │ │ +00038e70: 0a28 696e 636c 7564 696e 6720 636f 6e66 .(including conf │ │ │ │ │ +00038e80: 6967 2920 6172 6520 6173 7375 6d65 6420 ig) are assumed │ │ │ │ │ +00038e90: 746f 2062 6520 656e 636f 6465 6420 696e to be encoded in │ │ │ │ │ +00038ea0: 2055 5446 2d38 2e0a 0a31 372e 3220 4669 UTF-8...17.2 Fi │ │ │ │ │ +00038eb0: 6c65 7379 7374 656d 730a 3d3d 3d3d 3d3d lesystems.====== │ │ │ │ │ +00038ec0: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 4e54 4653 ==========..NTFS │ │ │ │ │ +00038ed0: 2c20 4a46 532c 2055 4446 2c20 4846 532b , JFS, UDF, HFS+ │ │ │ │ │ +00038ee0: 2c20 6578 4641 542c 206c 6f6e 6720 6669 , exFAT, long fi │ │ │ │ │ +00038ef0: 6c65 6e61 6d65 7320 696e 2046 4154 2c20 lenames in FAT, │ │ │ │ │ +00038f00: 4a6f 6c69 6574 2070 6172 7420 6f66 0a49 Joliet part of.I │ │ │ │ │ +00038f10: 534f 3936 3630 2061 7265 2074 7265 6174 SO9660 are treat │ │ │ │ │ +00038f20: 6564 2061 7320 5554 462d 3136 2061 7320 ed as UTF-16 as │ │ │ │ │ +00038f30: 7065 7220 7370 6563 6966 6963 6174 696f per specificatio │ │ │ │ │ +00038f40: 6e2e 2020 4146 5320 616e 6420 4246 5320 n. AFS and BFS │ │ │ │ │ +00038f50: 6172 650a 7265 6164 2061 7320 5554 462d are.read as UTF- │ │ │ │ │ +00038f60: 382c 2061 6761 696e 2061 6363 6f72 6469 8, again accordi │ │ │ │ │ +00038f70: 6e67 2074 6f20 7370 6563 6966 6963 6174 ng to specificat │ │ │ │ │ +00038f80: 696f 6e2e 2020 4274 7246 532c 2063 7069 ion. BtrFS, cpi │ │ │ │ │ +00038f90: 6f2c 2074 6172 2c0a 7371 7561 7368 342c o, tar,.squash4, │ │ │ │ │ +00038fa0: 206d 696e 6978 2c20 6d69 6e69 7832 2c20 minix, minix2, │ │ │ │ │ +00038fb0: 6d69 6e69 7833 2c20 524f 4d46 532c 2052 minix3, ROMFS, R │ │ │ │ │ +00038fc0: 6569 7365 7246 532c 2058 4653 2c20 6578 eiserFS, XFS, ex │ │ │ │ │ +00038fd0: 7432 2c20 6578 7433 2c20 6578 7434 2c0a t2, ext3, ext4,. │ │ │ │ │ +00038fe0: 4641 5420 2873 686f 7274 206e 616d 6573 FAT (short names │ │ │ │ │ +00038ff0: 292c 2046 3246 532c 2052 6f63 6b52 6964 ), F2FS, RockRid │ │ │ │ │ +00039000: 6765 2070 6172 7420 6f66 2049 534f 3936 ge part of ISO96 │ │ │ │ │ +00039010: 3630 2c20 6e69 6c66 7332 2c20 5546 5331 60, nilfs2, UFS1 │ │ │ │ │ +00039020: 2c20 5546 5332 0a61 6e64 205a 4653 2061 , UFS2.and ZFS a │ │ │ │ │ +00039030: 7265 2061 7373 756d 6564 2074 6f20 6265 re assumed to be │ │ │ │ │ +00039040: 2055 5446 2d38 2e20 2054 6869 7320 6d69 UTF-8. This mi │ │ │ │ │ +00039050: 6768 7420 6265 2066 616c 7365 206f 6e20 ght be false on │ │ │ │ │ +00039060: 7379 7374 656d 730a 636f 6e66 6967 7572 systems.configur │ │ │ │ │ +00039070: 6564 2077 6974 6820 6c65 6761 6379 2063 ed with legacy c │ │ │ │ │ +00039080: 6861 7273 6574 2062 7574 2061 7320 6c6f harset but as lo │ │ │ │ │ +00039090: 6e67 2061 7320 7468 6520 6368 6172 7365 ng as the charse │ │ │ │ │ +000390a0: 7420 7573 6564 2069 730a 7375 7065 7273 t used is.supers │ │ │ │ │ +000390b0: 6574 206f 6620 4153 4349 4920 796f 7520 et of ASCII you │ │ │ │ │ +000390c0: 7368 6f75 6c64 2062 6520 6162 6c65 2074 should be able t │ │ │ │ │ +000390d0: 6f20 6163 6365 7373 2041 5343 4949 2d6e o access ASCII-n │ │ │ │ │ +000390e0: 616d 6564 2066 696c 6573 2e20 2041 6e64 amed files. And │ │ │ │ │ +000390f0: 0a69 7427 7320 7265 636f 6d6d 656e 6465 .it's recommende │ │ │ │ │ +00039100: 6420 746f 2063 6f6e 6669 6775 7265 2079 d to configure y │ │ │ │ │ +00039110: 6f75 7220 7379 7374 656d 2074 6f20 7573 our system to us │ │ │ │ │ +00039120: 6520 5554 462d 3820 746f 2061 6363 6573 e UTF-8 to acces │ │ │ │ │ +00039130: 7320 7468 650a 6669 6c65 7379 7374 656d s the.filesystem │ │ │ │ │ +00039140: 2c20 636f 6e76 6d76 206d 6179 2068 656c , convmv may hel │ │ │ │ │ +00039150: 7020 7769 7468 206d 6967 7261 7469 6f6e p with migration │ │ │ │ │ +00039160: 2e20 2049 534f 3936 3630 2028 706c 6169 . ISO9660 (plai │ │ │ │ │ +00039170: 6e29 2066 696c 656e 616d 6573 0a61 7265 n) filenames.are │ │ │ │ │ +00039180: 2073 7065 6369 6669 6564 2061 7320 6265 specified as be │ │ │ │ │ +00039190: 696e 6720 4153 4349 4920 6f72 2062 6569 ing ASCII or bei │ │ │ │ │ +000391a0: 6e67 2064 6573 6372 6962 6564 2077 6974 ng described wit │ │ │ │ │ +000391b0: 6820 756e 7370 6563 6966 6965 6420 6573 h unspecified es │ │ │ │ │ +000391c0: 6361 7065 0a73 6571 7565 6e63 6573 2e20 cape.sequences. │ │ │ │ │ +000391d0: 2047 5255 4220 6173 7375 6d65 7320 7468 GRUB assumes th │ │ │ │ │ +000391e0: 6174 2074 6865 2049 534f 3936 3630 206e at the ISO9660 n │ │ │ │ │ +000391f0: 616d 6573 2061 7265 2055 5446 2d38 2028 ames are UTF-8 ( │ │ │ │ │ +00039200: 7369 6e63 6520 616e 790a 4153 4349 4920 since any.ASCII │ │ │ │ │ +00039210: 6973 2076 616c 6964 2055 5446 2d38 292e is valid UTF-8). │ │ │ │ │ +00039220: 2020 5468 6572 6520 6172 6520 736f 6d65 There are some │ │ │ │ │ +00039230: 206f 6c64 2043 442d 524f 4d73 2077 6869 old CD-ROMs whi │ │ │ │ │ +00039240: 6368 2075 7365 2043 5034 3337 2069 6e0a ch use CP437 in. │ │ │ │ │ +00039250: 6e6f 6e2d 636f 6d70 6c69 616e 7420 7761 non-compliant wa │ │ │ │ │ +00039260: 792e 2020 596f 7527 7265 2073 7469 6c6c y. You're still │ │ │ │ │ +00039270: 2061 626c 6520 746f 2061 6363 6573 7320 able to access │ │ │ │ │ +00039280: 6669 6c65 7320 7769 7468 206e 616d 6573 files with names │ │ │ │ │ +00039290: 0a63 6f6e 7461 696e 696e 6720 6f6e 6c79 .containing only │ │ │ │ │ +000392a0: 2041 5343 4949 2063 6861 7261 6374 6572 ASCII character │ │ │ │ │ +000392b0: 7320 6f6e 2073 7563 6820 6669 6c65 7379 s on such filesy │ │ │ │ │ +000392c0: 7374 656d 7320 7468 6f75 6768 2e20 2059 stems though. Y │ │ │ │ │ +000392d0: 6f75 2772 650a 616c 736f 2061 626c 6520 ou're.also able │ │ │ │ │ +000392e0: 746f 2061 6363 6573 7320 616e 7920 6669 to access any fi │ │ │ │ │ +000392f0: 6c65 2069 6620 7468 6520 6669 6c65 7379 le if the filesy │ │ │ │ │ +00039300: 7374 656d 2063 6f6e 7461 696e 7320 7661 stem contains va │ │ │ │ │ +00039310: 6c69 6420 4a6f 6c69 6574 0a28 5554 462d lid Joliet.(UTF- │ │ │ │ │ +00039320: 3136 2920 6f72 2052 6f63 6b52 6964 6765 16) or RockRidge │ │ │ │ │ +00039330: 2028 5554 462d 3829 2e20 2041 4646 532c (UTF-8). AFFS, │ │ │ │ │ +00039340: 2053 4653 2061 6e64 2048 4653 206e 6576 SFS and HFS nev │ │ │ │ │ +00039350: 6572 2075 7365 2075 6e69 636f 6465 2061 er use unicode a │ │ │ │ │ +00039360: 6e64 0a47 5255 4220 6173 7375 6d65 7320 nd.GRUB assumes │ │ │ │ │ +00039370: 7468 656d 2074 6f20 6265 2069 6e20 4c61 them to be in La │ │ │ │ │ +00039380: 7469 6e31 2c20 4c61 7469 6e31 2061 6e64 tin1, Latin1 and │ │ │ │ │ +00039390: 204d 6163 526f 6d61 6e20 7265 7370 6563 MacRoman respec │ │ │ │ │ +000393a0: 7469 7665 6c79 2e0a 4752 5542 2068 616e tively..GRUB han │ │ │ │ │ +000393b0: 646c 6573 2066 696c 6573 7973 7465 6d20 dles filesystem │ │ │ │ │ +000393c0: 6361 7365 2d69 6e73 656e 7369 7469 7669 case-insensitivi │ │ │ │ │ +000393d0: 7479 2068 6f77 6576 6572 206e 6f20 6174 ty however no at │ │ │ │ │ +000393e0: 7465 6d70 7420 6973 0a70 6572 666f 726d tempt is.perform │ │ │ │ │ +000393f0: 6564 2061 7420 6361 7365 2063 6f6e 7665 ed at case conve │ │ │ │ │ +00039400: 7273 696f 6e20 6f66 2069 6e74 6572 6e61 rsion of interna │ │ │ │ │ +00039410: 7469 6f6e 616c 2063 6861 7261 6374 6572 tional character │ │ │ │ │ +00039420: 7320 736f 2065 2e67 2e20 2061 2066 696c s so e.g. a fil │ │ │ │ │ +00039430: 650a 6e61 6d65 6420 6c6f 7765 7263 6173 e.named lowercas │ │ │ │ │ +00039440: 6520 6772 6565 6b20 616c 7068 6120 6973 e greek alpha is │ │ │ │ │ +00039450: 2074 7265 6174 6564 2061 7320 6469 6666 treated as diff │ │ │ │ │ +00039460: 6572 656e 7420 6672 6f6d 2074 6865 206f erent from the o │ │ │ │ │ +00039470: 6e65 206e 616d 6564 0a61 7320 7570 7065 ne named.as uppe │ │ │ │ │ +00039480: 7263 6173 6520 616c 7068 612e 2020 5468 rcase alpha. Th │ │ │ │ │ +00039490: 6520 6669 6c65 7379 7374 656d 7320 696e e filesystems in │ │ │ │ │ +000394a0: 2071 7565 7374 696f 6e73 2061 7265 204e questions are N │ │ │ │ │ +000394b0: 5446 5320 2865 7863 6570 7420 504f 5349 TFS (except POSI │ │ │ │ │ +000394c0: 580a 6e61 6d65 7370 6163 6529 2c20 4846 X.namespace), HF │ │ │ │ │ +000394d0: 532b 2028 636f 6e66 6967 7572 6162 6c65 S+ (configurable │ │ │ │ │ +000394e0: 2061 7420 6d6b 6673 2074 696d 652c 2064 at mkfs time, d │ │ │ │ │ +000394f0: 6566 6175 6c74 2069 6e73 656e 7369 7469 efault insensiti │ │ │ │ │ +00039500: 7665 292c 2053 4653 0a28 636f 6e66 6967 ve), SFS.(config │ │ │ │ │ +00039510: 7572 6162 6c65 2061 7420 6d6b 6673 2074 urable at mkfs t │ │ │ │ │ +00039520: 696d 652c 2064 6566 6175 6c74 2069 6e73 ime, default ins │ │ │ │ │ +00039530: 656e 7369 7469 7665 292c 204a 4653 2028 ensitive), JFS ( │ │ │ │ │ +00039540: 636f 6e66 6967 7572 6162 6c65 2061 740a configurable at. │ │ │ │ │ +00039550: 6d6b 6673 2074 696d 652c 2064 6566 6175 mkfs time, defau │ │ │ │ │ +00039560: 6c74 2073 656e 7369 7469 7665 292c 2048 lt sensitive), H │ │ │ │ │ +00039570: 4653 2c20 4146 4653 2c20 4641 542c 2065 FS, AFFS, FAT, e │ │ │ │ │ +00039580: 7846 4154 2061 6e64 205a 4653 0a28 636f xFAT and ZFS.(co │ │ │ │ │ +00039590: 6e66 6967 7572 6162 6c65 206f 6e20 7065 nfigurable on pe │ │ │ │ │ +000395a0: 722d 7375 6276 6f6c 756d 6520 6261 7369 r-subvolume basi │ │ │ │ │ +000395b0: 7320 6279 2070 726f 7065 7274 7920 2263 s by property "c │ │ │ │ │ +000395c0: 6173 6573 656e 7369 7469 7669 7479 222c asesensitivity", │ │ │ │ │ +000395d0: 0a64 6566 6175 6c74 2073 656e 7369 7469 .default sensiti │ │ │ │ │ +000395e0: 7665 292e 2020 4f6e 205a 4653 2073 7562 ve). On ZFS sub │ │ │ │ │ +000395f0: 766f 6c75 6d65 7320 6d61 726b 6564 2061 volumes marked a │ │ │ │ │ +00039600: 7320 6361 7365 2069 6e73 656e 7369 7469 s case insensiti │ │ │ │ │ +00039610: 7665 2066 696c 6573 0a63 6f6e 7461 696e ve files.contain │ │ │ │ │ +00039620: 696e 6720 6c6f 7765 7263 6173 6520 696e ing lowercase in │ │ │ │ │ +00039630: 7465 726e 6174 696f 6e61 6c20 6368 6172 ternational char │ │ │ │ │ +00039640: 6163 7465 7273 2061 7265 2069 6e61 6363 acters are inacc │ │ │ │ │ +00039650: 6573 7369 626c 652e 2020 416c 736f 0a6c essible. Also.l │ │ │ │ │ +00039660: 696b 6520 616c 6c20 7375 7070 6f72 7465 ike all supporte │ │ │ │ │ +00039670: 6420 6669 6c65 7379 7374 656d 7320 6578 d filesystems ex │ │ │ │ │ +00039680: 6365 7074 2048 4653 2b20 616e 6420 5a46 cept HFS+ and ZF │ │ │ │ │ +00039690: 5320 2863 6f6e 6669 6775 7261 626c 6520 S (configurable │ │ │ │ │ +000396a0: 6f6e 0a70 6572 2d73 7562 766f 6c75 6d65 on.per-subvolume │ │ │ │ │ +000396b0: 2062 6173 6973 2062 7920 7072 6f70 6572 basis by proper │ │ │ │ │ +000396c0: 7479 2022 6e6f 726d 616c 697a 6174 696f ty "normalizatio │ │ │ │ │ +000396d0: 6e22 2c20 6465 6661 756c 7420 6e6f 6e65 n", default none │ │ │ │ │ +000396e0: 2920 4752 5542 0a6d 616b 6573 206e 6f20 ) GRUB.makes no │ │ │ │ │ +000396f0: 6174 7465 6d70 7420 6174 2063 6865 636b attempt at check │ │ │ │ │ +00039700: 206f 6620 6361 6e6f 6e69 6361 6c20 6571 of canonical eq │ │ │ │ │ +00039710: 7569 7661 6c65 6e63 6520 736f 2061 2066 uivalence so a f │ │ │ │ │ +00039720: 696c 6520 6e61 6d65 0a75 2d64 6961 7265 ile name.u-diare │ │ │ │ │ +00039730: 7369 7320 6973 2074 7265 6174 6564 2061 sis is treated a │ │ │ │ │ +00039740: 7320 6469 7374 696e 6374 2066 726f 6d20 s distinct from │ │ │ │ │ +00039750: 752b 636f 6d62 696e 696e 6720 6469 6172 u+combining diar │ │ │ │ │ +00039760: 6573 6973 2e20 2054 6869 730a 686f 7765 esis. This.howe │ │ │ │ │ +00039770: 7665 7220 6d65 616e 7320 7468 6174 2069 ver means that i │ │ │ │ │ +00039780: 6e20 6f72 6465 7220 746f 2061 6363 6573 n order to acces │ │ │ │ │ +00039790: 7320 6669 6c65 206f 6e20 4846 532b 2069 s file on HFS+ i │ │ │ │ │ +000397a0: 7473 206e 616d 6520 6d75 7374 2062 650a ts name must be. │ │ │ │ │ +000397b0: 7370 6563 6966 6965 6420 696e 206e 6f72 specified in nor │ │ │ │ │ +000397c0: 6d61 6c69 7361 7469 6f6e 2066 6f72 6d20 malisation form │ │ │ │ │ +000397d0: 442e 204f 6e20 6e6f 726d 616c 697a 6564 D. On normalized │ │ │ │ │ +000397e0: 205a 4653 2073 7562 766f 6c75 6d65 730a ZFS subvolumes. │ │ │ │ │ +000397f0: 6669 6c65 6e61 6d65 7320 6f75 7420 6f66 filenames out of │ │ │ │ │ +00039800: 206e 6f72 6d61 6c69 7361 7469 6f6e 2061 normalisation a │ │ │ │ │ +00039810: 7265 2069 6e61 6363 6573 7369 626c 652e re inaccessible. │ │ │ │ │ +00039820: 0a0a 3137 2e33 204f 7574 7075 7420 7465 ..17.3 Output te │ │ │ │ │ +00039830: 726d 696e 616c 0a3d 3d3d 3d3d 3d3d 3d3d rminal.========= │ │ │ │ │ +00039840: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a46 6972 ===========..Fir │ │ │ │ │ +00039850: 6d77 6172 6520 6f75 7470 7574 2063 6f6e mware output con │ │ │ │ │ +00039860: 736f 6c65 2022 636f 6e73 6f6c 6522 206f sole "console" o │ │ │ │ │ +00039870: 6e20 4152 4320 616e 6420 4945 4545 3132 n ARC and IEEE12 │ │ │ │ │ +00039880: 3735 2061 7265 206c 696d 6974 6564 2074 75 are limited t │ │ │ │ │ +00039890: 6f0a 4153 4349 492e 0a0a 2020 2042 494f o.ASCII... BIO │ │ │ │ │ +000398a0: 5320 6669 726d 7761 7265 2063 6f6e 736f S firmware conso │ │ │ │ │ +000398b0: 6c65 2061 6e64 2056 4741 2074 6578 7420 le and VGA text │ │ │ │ │ +000398c0: 6172 6520 6c69 6d69 7465 6420 746f 2041 are limited to A │ │ │ │ │ +000398d0: 5343 4949 2061 6e64 2073 6f6d 650a 7073 SCII and some.ps │ │ │ │ │ +000398e0: 6575 646f 6772 6170 6869 6373 2e0a 0a20 eudographics... │ │ │ │ │ +000398f0: 2020 4e6f 6e65 206f 6620 6162 6f76 6520 None of above │ │ │ │ │ +00039900: 6d65 6e74 696f 6e65 6420 6973 2061 7070 mentioned is app │ │ │ │ │ +00039910: 726f 7072 6961 7465 2066 6f72 2064 6973 ropriate for dis │ │ │ │ │ +00039920: 706c 6179 696e 6720 696e 7465 726e 6174 playing internat │ │ │ │ │ +00039930: 696f 6e61 6c0a 616e 6420 616e 7920 756e ional.and any un │ │ │ │ │ +00039940: 7375 7070 6f72 7465 6420 6368 6172 6163 supported charac │ │ │ │ │ +00039950: 7465 7220 6973 2072 6570 6c61 6365 6420 ter is replaced │ │ │ │ │ +00039960: 7769 7468 2071 7565 7374 696f 6e20 6d61 with question ma │ │ │ │ │ +00039970: 726b 2065 7863 6570 740a 7073 6575 646f rk except.pseudo │ │ │ │ │ +00039980: 6772 6170 6869 6373 2077 6869 6368 2077 graphics which w │ │ │ │ │ +00039990: 6520 6174 7465 6d70 7420 746f 2061 7070 e attempt to app │ │ │ │ │ +000399a0: 726f 7869 6d61 7465 2077 6974 6820 4153 roximate with AS │ │ │ │ │ +000399b0: 4349 492e 0a0a 2020 2045 4649 2063 6f6e CII... EFI con │ │ │ │ │ +000399c0: 736f 6c65 206f 6e20 7468 6520 6f74 6865 sole on the othe │ │ │ │ │ +000399d0: 7220 6861 6e64 206e 6f6d 696e 616c 6c79 r hand nominally │ │ │ │ │ +000399e0: 2073 7570 706f 7274 7320 5554 462d 3136 supports UTF-16 │ │ │ │ │ +000399f0: 2062 7574 2061 6374 7561 6c0a 6c61 6e67 but actual.lang │ │ │ │ │ +00039a00: 7561 6765 2063 6f76 6572 6167 6520 6465 uage coverage de │ │ │ │ │ +00039a10: 7065 6e64 7320 6f6e 2066 6972 6d77 6172 pends on firmwar │ │ │ │ │ +00039a20: 6520 616e 6420 6d61 7920 6265 2076 6572 e and may be ver │ │ │ │ │ +00039a30: 7920 6c69 6d69 7465 642e 0a0a 2020 2054 y limited... T │ │ │ │ │ +00039a40: 6865 2065 6e63 6f64 696e 6720 7573 6564 he encoding used │ │ │ │ │ +00039a50: 206f 6e20 7365 7269 616c 2063 616e 2062 on serial can b │ │ │ │ │ +00039a60: 6520 6368 6f73 656e 2077 6974 6820 2774 e chosen with 't │ │ │ │ │ +00039a70: 6572 6d69 6e66 6f27 2061 7320 6569 7468 erminfo' as eith │ │ │ │ │ +00039a80: 6572 0a41 5343 4949 2c20 5554 462d 3820 er.ASCII, UTF-8 │ │ │ │ │ +00039a90: 6f72 2022 7669 7375 616c 2055 5446 2d38 or "visual UTF-8 │ │ │ │ │ +00039aa0: 222e 2020 4c61 7374 206f 6e65 2069 7320 ". Last one is │ │ │ │ │ +00039ab0: 6167 6169 6e73 7420 7468 6520 7370 6563 against the spec │ │ │ │ │ +00039ac0: 6966 6963 6174 696f 6e0a 6275 7420 7265 ification.but re │ │ │ │ │ +00039ad0: 7375 6c74 7320 696e 2063 6f72 7265 6374 sults in correct │ │ │ │ │ +00039ae0: 2072 656e 6465 7269 6e67 206f 6620 7269 rendering of ri │ │ │ │ │ +00039af0: 6768 742d 746f 2d6c 6566 7420 6f6e 2073 ght-to-left on s │ │ │ │ │ +00039b00: 6f6d 6520 7265 6164 6572 7320 7768 6963 ome readers whic │ │ │ │ │ +00039b10: 680a 646f 6e27 7420 6861 7665 206f 776e h.don't have own │ │ │ │ │ +00039b20: 2062 6964 6920 696d 706c 656d 656e 7461 bidi implementa │ │ │ │ │ +00039b30: 7469 6f6e 2e0a 0a20 2020 4f6e 2065 6d75 tion... On emu │ │ │ │ │ +00039b40: 2047 5255 4220 6368 6563 6b73 2069 6620 GRUB checks if │ │ │ │ │ +00039b50: 6368 6172 7365 7420 6973 2055 5446 2d38 charset is UTF-8 │ │ │ │ │ +00039b60: 2061 6e64 2075 7365 7320 6974 2069 6620 and uses it if │ │ │ │ │ +00039b70: 736f 2061 6e64 2075 7365 730a 4153 4349 so and uses.ASCI │ │ │ │ │ +00039b80: 4920 6f74 6865 7277 6973 652e 0a0a 2020 I otherwise... │ │ │ │ │ +00039b90: 2057 6865 6e20 7573 696e 6720 6766 7874 When using gfxt │ │ │ │ │ +00039ba0: 6572 6d20 6f72 2067 6678 6d65 6e75 2047 erm or gfxmenu G │ │ │ │ │ +00039bb0: 5255 4220 6974 7365 6c66 2069 7320 7265 RUB itself is re │ │ │ │ │ +00039bc0: 7370 6f6e 7369 626c 6520 666f 720a 7265 sponsible for.re │ │ │ │ │ +00039bd0: 6e64 6572 696e 6720 7468 6520 7465 7874 ndering the text │ │ │ │ │ +00039be0: 2e20 2049 6e20 7468 6973 2063 6173 6520 . In this case │ │ │ │ │ +00039bf0: 4752 5542 2069 7320 6c69 6d69 7465 6420 GRUB is limited │ │ │ │ │ +00039c00: 6279 206c 6f61 6465 6420 666f 6e74 732e by loaded fonts. │ │ │ │ │ +00039c10: 2020 4966 0a66 6f6e 7473 2063 6f6e 7461 If.fonts conta │ │ │ │ │ +00039c20: 696e 2061 6c6c 2072 6571 7569 7265 6420 in all required │ │ │ │ │ +00039c30: 6368 6172 6163 7465 7273 2074 6865 6e20 characters then │ │ │ │ │ +00039c40: 6269 6469 7265 6374 696f 6e61 6c20 7465 bidirectional te │ │ │ │ │ +00039c50: 7874 2c20 6375 7273 6976 650a 7661 7269 xt, cursive.vari │ │ │ │ │ +00039c60: 616e 7473 2061 6e64 2063 6f6d 6269 6e69 ants and combini │ │ │ │ │ +00039c70: 6e67 206d 6172 6b73 206f 7468 6572 2074 ng marks other t │ │ │ │ │ +00039c80: 6861 6e20 656e 636c 6f73 696e 672c 2068 han enclosing, h │ │ │ │ │ +00039c90: 616c 6620 2865 2e67 2e20 206c 6566 7420 alf (e.g. left │ │ │ │ │ +00039ca0: 6861 6c66 0a74 696c 6465 206f 7220 636f half.tilde or co │ │ │ │ │ +00039cb0: 6d62 696e 696e 6720 6f76 6572 6c69 6e65 mbining overline │ │ │ │ │ +00039cc0: 2920 616e 6420 646f 7562 6c65 206f 6e65 ) and double one │ │ │ │ │ +00039cd0: 732e 2020 4c69 6761 7475 7265 7320 6172 s. Ligatures ar │ │ │ │ │ +00039ce0: 656e 2774 0a73 7570 706f 7274 6564 2074 en't.supported t │ │ │ │ │ +00039cf0: 686f 7567 682e 2020 5468 6973 2073 686f hough. This sho │ │ │ │ │ +00039d00: 756c 6420 636f 7665 7220 4575 726f 7065 uld cover Europe │ │ │ │ │ +00039d10: 616e 2c20 4d69 6464 6c65 2045 6173 7465 an, Middle Easte │ │ │ │ │ +00039d20: 726e 2028 6966 2079 6f75 0a64 6f6e 2774 rn (if you.don't │ │ │ │ │ +00039d30: 206d 696e 6420 6c61 636b 206f 6620 6c61 mind lack of la │ │ │ │ │ +00039d40: 6d2d 616c 6966 206c 6967 6174 7572 6520 m-alif ligature │ │ │ │ │ +00039d50: 696e 2041 7261 6269 6329 2061 6e64 2045 in Arabic) and E │ │ │ │ │ +00039d60: 6173 7420 4173 6961 6e20 7363 7269 7074 ast Asian script │ │ │ │ │ +00039d70: 732e 0a4e 6f74 6162 6c65 2075 6e73 7570 s..Notable unsup │ │ │ │ │ +00039d80: 706f 7274 6564 2073 6372 6970 7473 2061 ported scripts a │ │ │ │ │ +00039d90: 7265 2042 7261 686d 6963 2066 616d 696c re Brahmic famil │ │ │ │ │ +00039da0: 7920 616e 6420 6465 7269 7665 6420 6173 y and derived as │ │ │ │ │ +00039db0: 2077 656c 6c20 6173 0a4d 6f6e 676f 6c69 well as.Mongoli │ │ │ │ │ +00039dc0: 616e 2c20 5469 6669 6e61 6768 2c20 4b6f an, Tifinagh, Ko │ │ │ │ │ +00039dd0: 7265 616e 204a 616d 6f20 2870 7265 636f rean Jamo (preco │ │ │ │ │ +00039de0: 6d70 6f73 6564 2063 6861 7261 6374 6572 mposed character │ │ │ │ │ +00039df0: 7320 6861 7665 206e 6f0a 7072 6f62 6c65 s have no.proble │ │ │ │ │ +00039e00: 6d29 2061 6e64 2074 6f6e 616c 2077 7269 m) and tonal wri │ │ │ │ │ +00039e10: 7469 6e67 2028 3265 352d 3265 3929 2e20 ting (2e5-2e9). │ │ │ │ │ +00039e20: 2047 5255 4220 616c 736f 2069 676e 6f72 GRUB also ignor │ │ │ │ │ +00039e30: 6573 2064 6570 7265 6361 7465 6420 2861 es deprecated (a │ │ │ │ │ +00039e40: 730a 7370 6563 6966 6965 6420 696e 2055 s.specified in U │ │ │ │ │ +00039e50: 6e69 636f 6465 2920 6368 6172 6163 7465 nicode) characte │ │ │ │ │ +00039e60: 7273 2028 652e 672e 2020 7461 6773 292e rs (e.g. tags). │ │ │ │ │ +00039e70: 2020 4752 5542 2061 6c73 6f20 646f 6573 GRUB also does │ │ │ │ │ +00039e80: 6e27 7420 6861 6e64 6c65 0a73 6f20 6361 n't handle.so ca │ │ │ │ │ +00039e90: 6c6c 6564 2022 616e 6e6f 7461 7469 6f6e lled "annotation │ │ │ │ │ +00039ea0: 2063 6861 7261 6374 6572 7322 2049 6620 characters" If │ │ │ │ │ +00039eb0: 796f 7520 6361 6e20 636f 6d70 6c65 7465 you can complete │ │ │ │ │ +00039ec0: 2065 6974 6865 7220 6f66 2074 776f 0a6c either of two.l │ │ │ │ │ +00039ed0: 6973 7473 206f 722c 2062 6574 7465 722c ists or, better, │ │ │ │ │ +00039ee0: 2070 726f 706f 7365 2061 2070 6174 6368 propose a patch │ │ │ │ │ +00039ef0: 2074 6f20 696d 7072 6f76 6520 7265 6e64 to improve rend │ │ │ │ │ +00039f00: 6572 696e 672c 2070 6c65 6173 6520 636f ering, please co │ │ │ │ │ +00039f10: 6e74 6163 740a 6465 7665 6c6f 7065 7220 ntact.developer │ │ │ │ │ +00039f20: 7465 616d 2e0a 0a31 372e 3420 496e 7075 team...17.4 Inpu │ │ │ │ │ +00039f30: 7420 7465 726d 696e 616c 0a3d 3d3d 3d3d t terminal.===== │ │ │ │ │ +00039f40: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a ==============.. │ │ │ │ │ +00039f50: 4669 726d 7761 7265 2063 6f6e 736f 6c65 Firmware console │ │ │ │ │ +00039f60: 206f 6e20 4249 4f53 2c20 4945 4545 3132 on BIOS, IEEE12 │ │ │ │ │ +00039f70: 3735 2061 6e64 2041 5243 2064 6f65 736e 75 and ARC doesn │ │ │ │ │ +00039f80: 2774 2061 6c6c 6f77 2079 6f75 2074 6f20 't allow you to │ │ │ │ │ +00039f90: 656e 7465 720a 6e6f 6e2d 4153 4349 4920 enter.non-ASCII │ │ │ │ │ +00039fa0: 6368 6172 6163 7465 7273 2e20 2045 4649 characters. EFI │ │ │ │ │ +00039fb0: 2073 7065 6369 6669 6361 7469 6f6e 2061 specification a │ │ │ │ │ +00039fc0: 6c6c 6f77 7320 666f 7220 7375 6368 2062 llows for such b │ │ │ │ │ +00039fd0: 7574 2061 7574 686f 7220 6973 0a75 6e61 ut author is.una │ │ │ │ │ +00039fe0: 7761 7265 206f 6620 616e 7920 6163 7475 ware of any actu │ │ │ │ │ +00039ff0: 616c 2069 6d70 6c65 6d65 6e74 6174 696f al implementatio │ │ │ │ │ +0003a000: 6e73 2e20 2053 6572 6961 6c20 696e 7075 ns. Serial inpu │ │ │ │ │ +0003a010: 7420 6973 2063 7572 7265 6e74 6c79 0a6c t is currently.l │ │ │ │ │ +0003a020: 696d 6974 6564 2066 6f72 206c 6174 696e imited for latin │ │ │ │ │ +0003a030: 3120 2875 6e6c 696b 656c 7920 746f 2063 1 (unlikely to c │ │ │ │ │ +0003a040: 6861 6e67 6529 2e20 204f 776e 206b 6579 hange). Own key │ │ │ │ │ +0003a050: 626f 6172 6420 696d 706c 656d 656e 7461 board implementa │ │ │ │ │ +0003a060: 7469 6f6e 730a 2861 745f 6b65 7962 6f61 tions.(at_keyboa │ │ │ │ │ +0003a070: 7264 2061 6e64 2075 7362 5f6b 6579 626f rd and usb_keybo │ │ │ │ │ +0003a080: 6172 6429 2073 7570 706f 7274 7320 616e ard) supports an │ │ │ │ │ +0003a090: 7920 6b65 7920 6275 7420 776f 726b 206f y key but work o │ │ │ │ │ +0003a0a0: 6e0a 6f6e 652d 6368 6172 2d70 6572 2d6b n.one-char-per-k │ │ │ │ │ +0003a0b0: 6579 7374 726f 6b65 2e20 2053 6f20 6e6f eystroke. So no │ │ │ │ │ +0003a0c0: 2064 6561 6420 6b65 7973 206f 7220 6164 dead keys or ad │ │ │ │ │ +0003a0d0: 7661 6e63 6564 2069 6e70 7574 206d 6574 vanced input met │ │ │ │ │ +0003a0e0: 686f 642e 2020 416c 736f 0a74 6865 7265 hod. Also.there │ │ │ │ │ +0003a0f0: 2069 7320 6e6f 206b 6579 6d61 7020 6368 is no keymap ch │ │ │ │ │ +0003a100: 616e 6765 2068 6f74 6b65 792e 2020 496e ange hotkey. In │ │ │ │ │ +0003a110: 2070 7261 6374 6963 6520 6974 206d 616b practice it mak │ │ │ │ │ +0003a120: 6573 2064 6966 6669 6375 6c74 2074 6f0a es difficult to. │ │ │ │ │ +0003a130: 656e 7465 7220 616e 7920 7465 7874 2075 enter any text u │ │ │ │ │ +0003a140: 7369 6e67 206e 6f6e 2d4c 6174 696e 2061 sing non-Latin a │ │ │ │ │ +0003a150: 6c70 6861 6265 742e 2020 4d6f 7265 6f76 lphabet. Moreov │ │ │ │ │ +0003a160: 6572 2061 6c6c 2063 7572 7265 6e74 2069 er all current i │ │ │ │ │ +0003a170: 6e70 7574 0a63 6f6e 7375 6d65 7273 2061 nput.consumers a │ │ │ │ │ +0003a180: 7265 206c 696d 6974 6564 2074 6f20 4153 re limited to AS │ │ │ │ │ +0003a190: 4349 492e 0a0a 3137 2e35 2047 6574 7465 CII...17.5 Gette │ │ │ │ │ +0003a1a0: 7874 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a xt.============. │ │ │ │ │ +0003a1b0: 0a47 5255 4220 7375 7070 6f72 7473 2062 .GRUB supports b │ │ │ │ │ +0003a1c0: 6569 6e67 2074 7261 6e73 6c61 7465 642e eing translated. │ │ │ │ │ +0003a1d0: 2020 466f 7220 7468 6973 2079 6f75 206e For this you n │ │ │ │ │ +0003a1e0: 6565 6420 746f 2068 6176 6520 6c61 6e67 eed to have lang │ │ │ │ │ +0003a1f0: 7561 6765 202a 2e6d 6f0a 6669 6c65 7320 uage *.mo.files │ │ │ │ │ +0003a200: 696e 2024 7072 6566 6978 2f6c 6f63 616c in $prefix/local │ │ │ │ │ +0003a210: 652c 206c 6f61 6420 6765 7474 6578 7420 e, load gettext │ │ │ │ │ +0003a220: 6d6f 6475 6c65 2061 6e64 2073 6574 2022 module and set " │ │ │ │ │ +0003a230: 6c61 6e67 2220 7661 7269 6162 6c65 2e0a lang" variable.. │ │ │ │ │ +0003a240: 0a31 372e 3620 5265 6765 7870 0a3d 3d3d .17.6 Regexp.=== │ │ │ │ │ +0003a250: 3d3d 3d3d 3d3d 3d3d 0a0a 5265 6765 7870 ========..Regexp │ │ │ │ │ +0003a260: 7320 776f 726b 206f 6e20 756e 6963 6f64 s work on unicod │ │ │ │ │ +0003a270: 6520 6368 6172 6163 7465 7273 2c20 686f e characters, ho │ │ │ │ │ +0003a280: 7765 7665 7220 6e6f 2061 7474 656d 7074 wever no attempt │ │ │ │ │ +0003a290: 2061 7420 6368 6563 6b69 6e67 0a63 616e at checking.can │ │ │ │ │ +0003a2a0: 6e6f 6e69 6361 6c20 6571 7569 7661 6c65 nonical equivale │ │ │ │ │ +0003a2b0: 6e63 6520 6861 7320 6265 656e 206d 6164 nce has been mad │ │ │ │ │ +0003a2c0: 652e 2020 4d6f 7265 6f76 6572 2074 6865 e. Moreover the │ │ │ │ │ +0003a2d0: 2063 6c61 7373 6573 206c 696b 650a 5b3a classes like.[: │ │ │ │ │ +0003a2e0: 616c 7068 613a 5d20 6d61 7463 6820 6f6e alpha:] match on │ │ │ │ │ +0003a2f0: 6c79 2041 5343 4949 2073 7562 7365 742e ly ASCII subset. │ │ │ │ │ +0003a300: 0a0a 3137 2e37 204f 7468 6572 0a3d 3d3d ..17.7 Other.=== │ │ │ │ │ +0003a310: 3d3d 3d3d 3d3d 3d0a 0a43 7572 7265 6e74 =======..Current │ │ │ │ │ +0003a320: 6c79 2047 5255 4220 616c 7761 7973 2075 ly GRUB always u │ │ │ │ │ +0003a330: 7365 7320 5945 4152 2d4d 4f4e 5448 2d44 ses YEAR-MONTH-D │ │ │ │ │ +0003a340: 4159 2048 4f55 523a 4d49 4e55 5445 3a53 AY HOUR:MINUTE:S │ │ │ │ │ +0003a350: 4543 4f4e 4420 5b57 4545 4b44 4159 5d0a ECOND [WEEKDAY]. │ │ │ │ │ +0003a360: 3234 2d68 6f75 7220 6461 7465 7469 6d65 24-hour datetime │ │ │ │ │ +0003a370: 2066 6f72 6d61 7420 6275 7420 7765 656b format but week │ │ │ │ │ +0003a380: 6461 7973 2061 7265 2074 7261 6e73 6c61 days are transla │ │ │ │ │ +0003a390: 7465 642e 2020 4752 5542 2061 6c77 6179 ted. GRUB alway │ │ │ │ │ +0003a3a0: 7320 7573 6573 0a74 6865 2064 6563 696d s uses.the decim │ │ │ │ │ +0003a3b0: 616c 206e 756d 6265 7220 666f 726d 6174 al number format │ │ │ │ │ +0003a3c0: 2077 6974 6820 5b30 2d39 5d20 6173 2064 with [0-9] as d │ │ │ │ │ +0003a3d0: 6967 6974 7320 616e 6420 2e20 2061 7320 igits and . as │ │ │ │ │ +0003a3e0: 6465 7363 696d 616c 0a73 6570 6172 6174 descimal.separat │ │ │ │ │ +0003a3f0: 6f72 2061 6e64 206e 6f20 6772 6f75 7020 or and no group │ │ │ │ │ +0003a400: 7365 7061 7261 746f 722e 2020 4945 4545 separator. IEEE │ │ │ │ │ +0003a410: 3132 3735 2061 6c69 6173 6573 2061 7265 1275 aliases are │ │ │ │ │ +0003a420: 206d 6174 6368 6564 0a63 6173 652d 696e matched.case-in │ │ │ │ │ +0003a430: 7365 6e73 6974 6976 656c 7920 6578 6365 sensitively exce │ │ │ │ │ +0003a440: 7074 206e 6f6e 2d41 5343 4949 2077 6869 pt non-ASCII whi │ │ │ │ │ +0003a450: 6368 2069 7320 6d61 7463 6865 6420 6173 ch is matched as │ │ │ │ │ +0003a460: 2062 696e 6172 792e 2020 5369 6d69 6c61 binary. Simila │ │ │ │ │ +0003a470: 720a 6265 6861 7669 6f75 7220 6973 2066 r.behaviour is f │ │ │ │ │ +0003a480: 6f72 206d 6174 6368 696e 6720 4f53 4275 or matching OSBu │ │ │ │ │ +0003a490: 6e64 6c65 5265 7175 6972 6564 2e20 2053 ndleRequired. S │ │ │ │ │ +0003a4a0: 696e 6365 2049 4545 4531 3237 3520 616c ince IEEE1275 al │ │ │ │ │ +0003a4b0: 6961 7365 7320 616e 640a 4f53 4275 6e64 iases and.OSBund │ │ │ │ │ +0003a4c0: 6c65 5265 7175 6972 6564 2064 6f6e 2774 leRequired don't │ │ │ │ │ +0003a4d0: 2063 6f6e 7461 696e 2061 6e79 206e 6f6e contain any non │ │ │ │ │ +0003a4e0: 2d41 5343 4949 2069 7420 7368 6f75 6c64 -ASCII it should │ │ │ │ │ +0003a4f0: 206e 6576 6572 2062 6520 610a 7072 6f62 never be a.prob │ │ │ │ │ +0003a500: 6c65 6d20 696e 2070 7261 6374 6963 652e lem in practice. │ │ │ │ │ +0003a510: 2020 4361 7365 2d73 656e 7369 7469 7665 Case-sensitive │ │ │ │ │ +0003a520: 2069 6465 6e74 6966 6965 7273 2061 7265 identifiers are │ │ │ │ │ +0003a530: 206d 6174 6368 6564 2061 7320 7261 770a matched as raw. │ │ │ │ │ +0003a540: 7374 7269 6e67 732c 206e 6f20 6361 6e6f strings, no cano │ │ │ │ │ +0003a550: 6e69 6361 6c20 6571 7569 7661 6c65 6e63 nical equivalenc │ │ │ │ │ +0003a560: 6520 6368 6563 6b20 6973 2070 6572 666f e check is perfo │ │ │ │ │ +0003a570: 726d 6564 2e20 2043 6173 652d 696e 7365 rmed. Case-inse │ │ │ │ │ +0003a580: 6e73 7469 7665 0a69 6465 6e74 6966 6965 nstive.identifie │ │ │ │ │ +0003a590: 7273 2061 7265 206d 6174 6368 6564 2061 rs are matched a │ │ │ │ │ +0003a5a0: 7320 5241 5720 6275 7420 6164 6469 7469 s RAW but additi │ │ │ │ │ +0003a5b0: 6f6e 616c 6c79 205b 612d 7a5d 2069 7320 onally [a-z] is │ │ │ │ │ +0003a5c0: 6571 7569 7661 6c65 6e74 2074 6f0a 5b41 equivalent to.[A │ │ │ │ │ +0003a5d0: 2d5a 5d2e 2047 5255 422d 6465 6669 6e65 -Z]. GRUB-define │ │ │ │ │ +0003a5e0: 6420 6964 656e 7469 6669 6572 7320 7573 d identifiers us │ │ │ │ │ +0003a5f0: 6520 6f6e 6c79 2041 5343 4949 2061 6e64 e only ASCII and │ │ │ │ │ +0003a600: 2073 6f20 7368 6f75 6c64 0a75 7365 722d so should.user- │ │ │ │ │ +0003a610: 6465 6669 6e65 6420 6f6e 6573 2e20 2049 defined ones. I │ │ │ │ │ +0003a620: 6465 6e74 6966 6965 7273 2063 6f6e 7461 dentifiers conta │ │ │ │ │ +0003a630: 696e 696e 6720 6e6f 6e2d 4153 4349 4920 ining non-ASCII │ │ │ │ │ +0003a640: 6d61 7920 776f 726b 2062 7574 2061 7265 may work but are │ │ │ │ │ +0003a650: 6e27 740a 7375 7070 6f72 7465 642e 2020 n't.supported. │ │ │ │ │ +0003a660: 4f6e 6c79 2074 6865 2041 5343 4949 2073 Only the ASCII s │ │ │ │ │ +0003a670: 7061 6365 2063 6861 7261 6374 6572 7320 pace characters │ │ │ │ │ +0003a680: 2873 7061 6365 2055 2b30 3032 302c 2074 (space U+0020, t │ │ │ │ │ +0003a690: 6162 2055 2b30 3030 622c 0a43 5220 552b ab U+000b,.CR U+ │ │ │ │ │ +0003a6a0: 3030 3064 2061 6e64 204c 4620 552b 3030 000d and LF U+00 │ │ │ │ │ +0003a6b0: 3061 2920 6172 6520 7265 636f 676e 6973 0a) are recognis │ │ │ │ │ +0003a6c0: 6564 2e20 204f 7468 6572 2075 6e69 636f ed. Other unico │ │ │ │ │ +0003a6d0: 6465 2073 7061 6365 2063 6861 7261 6374 de space charact │ │ │ │ │ +0003a6e0: 6572 730a 6172 656e 2774 2061 2076 616c ers.aren't a val │ │ │ │ │ +0003a6f0: 6964 2066 6965 6c64 2073 6570 6172 6174 id field separat │ │ │ │ │ +0003a700: 6f72 2e20 2027 7465 7374 2720 282a 6e6f or. 'test' (*no │ │ │ │ │ +0003a710: 7465 2074 6573 743a 3a29 2074 6573 7473 te test::) tests │ │ │ │ │ +0003a720: 203c 2c20 3e2c 203c 3d2c 0a3e 3d2c 202d <, >, <=,.>=, - │ │ │ │ │ +0003a730: 7067 7420 616e 6420 2d70 6c74 2063 6f6d pgt and -plt com │ │ │ │ │ +0003a740: 7061 7265 2074 6865 2073 7472 696e 6773 pare the strings │ │ │ │ │ +0003a750: 2069 6e20 7468 6520 6c65 7869 636f 6772 in the lexicogr │ │ │ │ │ +0003a760: 6170 6869 6361 6c20 6f72 6465 7220 6f66 aphical order of │ │ │ │ │ +0003a770: 0a75 6e69 636f 6465 2063 6f64 6570 6f69 .unicode codepoi │ │ │ │ │ +0003a780: 6e74 732c 2072 6570 6c69 6361 7469 6e67 nts, replicating │ │ │ │ │ +0003a790: 2074 6865 2062 6568 6176 696f 7572 206f the behaviour o │ │ │ │ │ +0003a7a0: 6620 7465 7374 2066 726f 6d20 636f 7265 f test from core │ │ │ │ │ +0003a7b0: 7574 696c 732e 0a65 6e76 6972 6f6e 6d65 utils..environme │ │ │ │ │ +0003a7c0: 6e74 2076 6172 6961 626c 6573 2061 6e64 nt variables and │ │ │ │ │ +0003a7d0: 2063 6f6d 6d61 6e64 7320 6172 6520 6c69 commands are li │ │ │ │ │ +0003a7e0: 7374 6564 2069 6e20 7468 6520 7361 6d65 sted in the same │ │ │ │ │ +0003a7f0: 206f 7264 6572 2e0a 0a1f 0a46 696c 653a order.....File: │ │ │ │ │ +0003a800: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ +0003a810: 653a 2053 6563 7572 6974 792c 2020 4e65 e: Security, Ne │ │ │ │ │ +0003a820: 7874 3a20 506c 6174 666f 726d 206c 696d xt: Platform lim │ │ │ │ │ +0003a830: 6974 6174 696f 6e73 2c20 2050 7265 763a itations, Prev: │ │ │ │ │ +0003a840: 2049 6e74 6572 6e61 7469 6f6e 616c 6973 Internationalis │ │ │ │ │ +0003a850: 6174 696f 6e2c 2020 5570 3a20 546f 700a ation, Up: Top. │ │ │ │ │ +0003a860: 0a31 3820 5365 6375 7269 7479 0a2a 2a2a .18 Security.*** │ │ │ │ │ +0003a870: 2a2a 2a2a 2a2a 2a2a 0a0a 2a20 4d65 6e75 ********..* Menu │ │ │ │ │ +0003a880: 3a0a 0a2a 2041 7574 6865 6e74 6963 6174 :..* Authenticat │ │ │ │ │ +0003a890: 696f 6e20 616e 6420 6175 7468 6f72 6973 ion and authoris │ │ │ │ │ +0003a8a0: 6174 696f 6e3a 3a20 5573 6572 7320 616e ation:: Users an │ │ │ │ │ +0003a8b0: 6420 6163 6365 7373 2063 6f6e 7472 6f6c d access control │ │ │ │ │ +0003a8c0: 0a2a 2055 7369 6e67 2064 6967 6974 616c .* Using digital │ │ │ │ │ +0003a8d0: 2073 6967 6e61 7475 7265 733a 3a20 2020 signatures:: │ │ │ │ │ +0003a8e0: 2020 2020 2020 426f 6f74 696e 6720 6469 Booting di │ │ │ │ │ +0003a8f0: 6769 7461 6c6c 7920 7369 676e 6564 2063 gitally signed c │ │ │ │ │ +0003a900: 6f64 650a 2a20 5545 4649 2073 6563 7572 ode.* UEFI secur │ │ │ │ │ +0003a910: 6520 626f 6f74 2061 6e64 2073 6869 6d3a e boot and shim: │ │ │ │ │ +0003a920: 3a20 2020 2020 2020 2042 6f6f 7469 6e67 : Booting │ │ │ │ │ +0003a930: 2064 6967 6974 616c 6c79 2073 6967 6e65 digitally signe │ │ │ │ │ +0003a940: 6420 5045 2066 696c 6573 0a2a 2053 6563 d PE files.* Sec │ │ │ │ │ +0003a950: 7572 6520 426f 6f74 2041 6476 616e 6365 ure Boot Advance │ │ │ │ │ +0003a960: 6420 5461 7267 6574 696e 673a 3a20 2020 d Targeting:: │ │ │ │ │ +0003a970: 456d 6265 6464 6564 2069 6e66 6f72 6d61 Embedded informa │ │ │ │ │ +0003a980: 7469 6f6e 2066 6f72 2067 656e 6572 6174 tion for generat │ │ │ │ │ +0003a990: 696f 6e20 6e75 6d62 6572 2062 6173 6564 ion number based │ │ │ │ │ +0003a9a0: 2072 6576 6f63 6174 696f 6e0a 2a20 4d65 revocation.* Me │ │ │ │ │ +0003a9b0: 6173 7572 6564 2042 6f6f 743a 3a20 2020 asured Boot:: │ │ │ │ │ 0003a9c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003a9d0: 2020 204d 6561 7375 7269 6e67 2062 6f6f Measuring boo │ │ │ │ │ -0003a9e0: 7420 636f 6d70 6f6e 656e 7473 0a2a 204c t components.* L │ │ │ │ │ -0003a9f0: 6f63 6b64 6f77 6e3a 3a20 2020 2020 2020 ockdown:: │ │ │ │ │ +0003a9d0: 204d 6561 7375 7269 6e67 2062 6f6f 7420 Measuring boot │ │ │ │ │ +0003a9e0: 636f 6d70 6f6e 656e 7473 0a2a 204c 6f63 components.* Loc │ │ │ │ │ +0003a9f0: 6b64 6f77 6e3a 3a20 2020 2020 2020 2020 kdown:: │ │ │ │ │ 0003aa00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003aa10: 2020 4c6f 636b 646f 776e 2077 6865 6e20 Lockdown when │ │ │ │ │ -0003aa20: 626f 6f74 696e 6720 6f6e 2061 2073 6563 booting on a sec │ │ │ │ │ -0003aa30: 7572 6520 7365 7475 700a 0a1f 0a46 696c ure setup....Fil │ │ │ │ │ -0003aa40: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ -0003aa50: 6f64 653a 2041 7574 6865 6e74 6963 6174 ode: Authenticat │ │ │ │ │ -0003aa60: 696f 6e20 616e 6420 6175 7468 6f72 6973 ion and authoris │ │ │ │ │ -0003aa70: 6174 696f 6e2c 2020 4e65 7874 3a20 5573 ation, Next: Us │ │ │ │ │ -0003aa80: 696e 6720 6469 6769 7461 6c20 7369 676e ing digital sign │ │ │ │ │ -0003aa90: 6174 7572 6573 2c20 2055 703a 2053 6563 atures, Up: Sec │ │ │ │ │ -0003aaa0: 7572 6974 790a 0a31 382e 3120 4175 7468 urity..18.1 Auth │ │ │ │ │ -0003aab0: 656e 7469 6361 7469 6f6e 2061 6e64 2061 entication and a │ │ │ │ │ -0003aac0: 7574 686f 7269 7361 7469 6f6e 2069 6e20 uthorisation in │ │ │ │ │ -0003aad0: 4752 5542 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d GRUB.=========== │ │ │ │ │ +0003aa10: 4c6f 636b 646f 776e 2077 6865 6e20 626f Lockdown when bo │ │ │ │ │ +0003aa20: 6f74 696e 6720 6f6e 2061 2073 6563 7572 oting on a secur │ │ │ │ │ +0003aa30: 6520 7365 7475 700a 0a1f 0a46 696c 653a e setup....File: │ │ │ │ │ +0003aa40: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ +0003aa50: 653a 2041 7574 6865 6e74 6963 6174 696f e: Authenticatio │ │ │ │ │ +0003aa60: 6e20 616e 6420 6175 7468 6f72 6973 6174 n and authorisat │ │ │ │ │ +0003aa70: 696f 6e2c 2020 4e65 7874 3a20 5573 696e ion, Next: Usin │ │ │ │ │ +0003aa80: 6720 6469 6769 7461 6c20 7369 676e 6174 g digital signat │ │ │ │ │ +0003aa90: 7572 6573 2c20 2055 703a 2053 6563 7572 ures, Up: Secur │ │ │ │ │ +0003aaa0: 6974 790a 0a31 382e 3120 4175 7468 656e ity..18.1 Authen │ │ │ │ │ +0003aab0: 7469 6361 7469 6f6e 2061 6e64 2061 7574 tication and aut │ │ │ │ │ +0003aac0: 686f 7269 7361 7469 6f6e 2069 6e20 4752 horisation in GR │ │ │ │ │ +0003aad0: 5542 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d UB.============= │ │ │ │ │ 0003aae0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 0003aaf0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0003ab00: 3d3d 0a0a 4279 2064 6566 6175 6c74 2c20 ==..By default, │ │ │ │ │ -0003ab10: 7468 6520 626f 6f74 206c 6f61 6465 7220 the boot loader │ │ │ │ │ -0003ab20: 696e 7465 7266 6163 6520 6973 2061 6363 interface is acc │ │ │ │ │ -0003ab30: 6573 7369 626c 6520 746f 2061 6e79 6f6e essible to anyon │ │ │ │ │ -0003ab40: 6520 7769 7468 0a70 6879 7369 6361 6c20 e with.physical │ │ │ │ │ -0003ab50: 6163 6365 7373 2074 6f20 7468 6520 636f access to the co │ │ │ │ │ -0003ab60: 6e73 6f6c 653a 2061 6e79 6f6e 6520 6361 nsole: anyone ca │ │ │ │ │ -0003ab70: 6e20 7365 6c65 6374 2061 6e64 2065 6469 n select and edi │ │ │ │ │ -0003ab80: 7420 616e 7920 6d65 6e75 0a65 6e74 7279 t any menu.entry │ │ │ │ │ -0003ab90: 2c20 616e 6420 616e 796f 6e65 2063 616e , and anyone can │ │ │ │ │ -0003aba0: 2067 6574 2064 6972 6563 7420 6163 6365 get direct acce │ │ │ │ │ -0003abb0: 7373 2074 6f20 6120 4752 5542 2073 6865 ss to a GRUB she │ │ │ │ │ -0003abc0: 6c6c 2070 726f 6d70 742e 2020 466f 720a ll prompt. For. │ │ │ │ │ -0003abd0: 6d6f 7374 2073 7973 7465 6d73 2c20 7468 most systems, th │ │ │ │ │ -0003abe0: 6973 2069 7320 7265 6173 6f6e 6162 6c65 is is reasonable │ │ │ │ │ -0003abf0: 2073 696e 6365 2061 6e79 6f6e 6520 7769 since anyone wi │ │ │ │ │ -0003ac00: 7468 2064 6972 6563 7420 7068 7973 6963 th direct physic │ │ │ │ │ -0003ac10: 616c 0a61 6363 6573 7320 6861 7320 6120 al.access has a │ │ │ │ │ -0003ac20: 7661 7269 6574 7920 6f66 206f 7468 6572 variety of other │ │ │ │ │ -0003ac30: 2077 6179 7320 746f 2067 6169 6e20 6675 ways to gain fu │ │ │ │ │ -0003ac40: 6c6c 2061 6363 6573 732c 2061 6e64 2072 ll access, and r │ │ │ │ │ -0003ac50: 6571 7569 7269 6e67 0a61 7574 6865 6e74 equiring.authent │ │ │ │ │ -0003ac60: 6963 6174 696f 6e20 6174 2074 6865 2062 ication at the b │ │ │ │ │ -0003ac70: 6f6f 7420 6c6f 6164 6572 206c 6576 656c oot loader level │ │ │ │ │ -0003ac80: 2077 6f75 6c64 206f 6e6c 7920 7365 7276 would only serv │ │ │ │ │ -0003ac90: 6520 746f 206d 616b 6520 6974 0a64 6966 e to make it.dif │ │ │ │ │ -0003aca0: 6669 6375 6c74 2074 6f20 7265 636f 7665 ficult to recove │ │ │ │ │ -0003acb0: 7220 6272 6f6b 656e 2073 7973 7465 6d73 r broken systems │ │ │ │ │ -0003acc0: 2e0a 0a20 2020 486f 7765 7665 722c 2069 ... However, i │ │ │ │ │ -0003acd0: 6e20 736f 6d65 2065 6e76 6972 6f6e 6d65 n some environme │ │ │ │ │ -0003ace0: 6e74 732c 2073 7563 6820 6173 206b 696f nts, such as kio │ │ │ │ │ -0003acf0: 736b 732c 2069 7420 6d61 7920 6265 2061 sks, it may be a │ │ │ │ │ -0003ad00: 7070 726f 7072 6961 7465 0a74 6f20 6c6f ppropriate.to lo │ │ │ │ │ -0003ad10: 636b 2064 6f77 6e20 7468 6520 626f 6f74 ck down the boot │ │ │ │ │ -0003ad20: 206c 6f61 6465 7220 746f 2072 6571 7569 loader to requi │ │ │ │ │ -0003ad30: 7265 2061 7574 6865 6e74 6963 6174 696f re authenticatio │ │ │ │ │ -0003ad40: 6e20 6265 666f 7265 2070 6572 666f 726d n before perform │ │ │ │ │ -0003ad50: 696e 670a 6365 7274 6169 6e20 6f70 6572 ing.certain oper │ │ │ │ │ -0003ad60: 6174 696f 6e73 2e0a 0a20 2020 5468 6520 ations... The │ │ │ │ │ -0003ad70: 2770 6173 7377 6f72 6427 2028 2a6e 6f74 'password' (*not │ │ │ │ │ -0003ad80: 6520 7061 7373 776f 7264 3a3a 2920 616e e password::) an │ │ │ │ │ -0003ad90: 6420 2770 6173 7377 6f72 645f 7062 6b64 d 'password_pbkd │ │ │ │ │ -0003ada0: 6632 2720 282a 6e6f 7465 0a70 6173 7377 f2' (*note.passw │ │ │ │ │ -0003adb0: 6f72 645f 7062 6b64 6632 3a3a 2920 636f ord_pbkdf2::) co │ │ │ │ │ -0003adc0: 6d6d 616e 6473 2063 616e 2062 6520 7573 mmands can be us │ │ │ │ │ -0003add0: 6564 2074 6f20 6465 6669 6e65 2075 7365 ed to define use │ │ │ │ │ -0003ade0: 7273 2c20 6561 6368 206f 6620 7768 6963 rs, each of whic │ │ │ │ │ -0003adf0: 680a 6861 7320 616e 2061 7373 6f63 6961 h.has an associa │ │ │ │ │ -0003ae00: 7465 6420 7061 7373 776f 7264 2e20 2027 ted password. ' │ │ │ │ │ -0003ae10: 7061 7373 776f 7264 2720 7365 7473 2074 password' sets t │ │ │ │ │ -0003ae20: 6865 2070 6173 7377 6f72 6420 696e 2070 he password in p │ │ │ │ │ -0003ae30: 6c61 696e 2074 6578 742c 0a72 6571 7569 lain text,.requi │ │ │ │ │ -0003ae40: 7269 6e67 2027 6772 7562 2e63 6667 2720 ring 'grub.cfg' │ │ │ │ │ -0003ae50: 746f 2062 6520 7365 6375 7265 3b20 2770 to be secure; 'p │ │ │ │ │ -0003ae60: 6173 7377 6f72 645f 7062 6b64 6632 2720 assword_pbkdf2' │ │ │ │ │ -0003ae70: 7365 7473 2074 6865 2070 6173 7377 6f72 sets the passwor │ │ │ │ │ -0003ae80: 640a 6861 7368 6564 2075 7369 6e67 2074 d.hashed using t │ │ │ │ │ -0003ae90: 6865 2050 6173 7377 6f72 642d 4261 7365 he Password-Base │ │ │ │ │ -0003aea0: 6420 4b65 7920 4465 7269 7661 7469 6f6e d Key Derivation │ │ │ │ │ -0003aeb0: 2046 756e 6374 696f 6e20 2852 4643 2032 Function (RFC 2 │ │ │ │ │ -0003aec0: 3839 3829 2c0a 7265 7175 6972 696e 6720 898),.requiring │ │ │ │ │ -0003aed0: 7468 6520 7573 6520 6f66 2027 6772 7562 the use of 'grub │ │ │ │ │ -0003aee0: 2d6d 6b70 6173 7377 642d 7062 6b64 6632 -mkpasswd-pbkdf2 │ │ │ │ │ -0003aef0: 2720 282a 6e6f 7465 2049 6e76 6f6b 696e ' (*note Invokin │ │ │ │ │ -0003af00: 670a 6772 7562 2d6d 6b70 6173 7377 642d g.grub-mkpasswd- │ │ │ │ │ -0003af10: 7062 6b64 6632 3a3a 2920 746f 2067 656e pbkdf2::) to gen │ │ │ │ │ -0003af20: 6572 6174 6520 7061 7373 776f 7264 2068 erate password h │ │ │ │ │ -0003af30: 6173 6865 732e 0a0a 2020 2049 6e20 6f72 ashes... In or │ │ │ │ │ -0003af40: 6465 7220 746f 2065 6e61 626c 6520 6175 der to enable au │ │ │ │ │ -0003af50: 7468 656e 7469 6361 7469 6f6e 2073 7570 thentication sup │ │ │ │ │ -0003af60: 706f 7274 2c20 7468 6520 2773 7570 6572 port, the 'super │ │ │ │ │ -0003af70: 7573 6572 7327 0a65 6e76 6972 6f6e 6d65 users'.environme │ │ │ │ │ -0003af80: 6e74 2076 6172 6961 626c 6520 6d75 7374 nt variable must │ │ │ │ │ -0003af90: 2062 6520 7365 7420 746f 2061 206c 6973 be set to a lis │ │ │ │ │ -0003afa0: 7420 6f66 2075 7365 726e 616d 6573 2c20 t of usernames, │ │ │ │ │ -0003afb0: 7365 7061 7261 7465 6420 6279 0a61 6e79 separated by.any │ │ │ │ │ -0003afc0: 206f 6620 7370 6163 6573 2c20 636f 6d6d of spaces, comm │ │ │ │ │ -0003afd0: 6173 2c20 7365 6d69 636f 6c6f 6e73 2c20 as, semicolons, │ │ │ │ │ -0003afe0: 7069 7065 732c 206f 7220 616d 7065 7273 pipes, or ampers │ │ │ │ │ -0003aff0: 616e 6473 2e20 2053 7570 6572 7573 6572 ands. Superuser │ │ │ │ │ -0003b000: 7320 6172 650a 7065 726d 6974 7465 6420 s are.permitted │ │ │ │ │ -0003b010: 746f 2075 7365 2074 6865 2047 5255 4220 to use the GRUB │ │ │ │ │ -0003b020: 636f 6d6d 616e 6420 6c69 6e65 2c20 6564 command line, ed │ │ │ │ │ -0003b030: 6974 206d 656e 7520 656e 7472 6965 732c it menu entries, │ │ │ │ │ -0003b040: 2061 6e64 2065 7865 6375 7465 0a61 6e79 and execute.any │ │ │ │ │ -0003b050: 206d 656e 7520 656e 7472 792e 2020 4966 menu entry. If │ │ │ │ │ -0003b060: 2027 7375 7065 7275 7365 7273 2720 6973 'superusers' is │ │ │ │ │ -0003b070: 2073 6574 2c20 7468 656e 2075 7365 206f set, then use o │ │ │ │ │ -0003b080: 6620 7468 6520 636f 6d6d 616e 6420 6c69 f the command li │ │ │ │ │ -0003b090: 6e65 0a61 6e64 2065 6469 7469 6e67 206f ne.and editing o │ │ │ │ │ -0003b0a0: 6620 6d65 6e75 2065 6e74 7269 6573 2061 f menu entries a │ │ │ │ │ -0003b0b0: 7265 2061 7574 6f6d 6174 6963 616c 6c79 re automatically │ │ │ │ │ -0003b0c0: 2072 6573 7472 6963 7465 6420 746f 2073 restricted to s │ │ │ │ │ -0003b0d0: 7570 6572 7573 6572 732e 0a53 6574 7469 uperusers..Setti │ │ │ │ │ -0003b0e0: 6e67 2027 7375 7065 7275 7365 7273 2720 ng 'superusers' │ │ │ │ │ -0003b0f0: 746f 2065 6d70 7479 2073 7472 696e 6720 to empty string │ │ │ │ │ -0003b100: 6566 6665 6374 6976 656c 7920 6469 7361 effectively disa │ │ │ │ │ -0003b110: 626c 6573 2062 6f74 6820 6163 6365 7373 bles both access │ │ │ │ │ -0003b120: 2074 6f0a 434c 4920 616e 6420 6564 6974 to.CLI and edit │ │ │ │ │ -0003b130: 696e 6720 6f66 206d 656e 7520 656e 7472 ing of menu entr │ │ │ │ │ -0003b140: 6965 732e 2020 4e6f 7465 3a20 5468 6520 ies. Note: The │ │ │ │ │ -0003b150: 656e 7669 726f 6e6d 656e 7420 7661 7269 environment vari │ │ │ │ │ -0003b160: 6162 6c65 206e 6565 6473 0a74 6f20 6265 able needs.to be │ │ │ │ │ -0003b170: 2065 7870 6f72 7465 6420 746f 2061 6c73 exported to als │ │ │ │ │ -0003b180: 6f20 6166 6665 6374 2074 6865 2073 6563 o affect the sec │ │ │ │ │ -0003b190: 7469 6f6e 2064 6566 696e 6564 2062 7920 tion defined by │ │ │ │ │ -0003b1a0: 7468 6520 2773 7562 6d65 6e75 270a 636f the 'submenu'.co │ │ │ │ │ -0003b1b0: 6d6d 616e 6420 282a 6e6f 7465 2073 7562 mmand (*note sub │ │ │ │ │ -0003b1c0: 6d65 6e75 3a3a 292e 0a0a 2020 204f 7468 menu::)... Oth │ │ │ │ │ -0003b1d0: 6572 2075 7365 7273 206d 6179 2062 6520 er users may be │ │ │ │ │ -0003b1e0: 616c 6c6f 7765 6420 746f 2065 7865 6375 allowed to execu │ │ │ │ │ -0003b1f0: 7465 2073 7065 6369 6669 6320 6d65 6e75 te specific menu │ │ │ │ │ -0003b200: 2065 6e74 7269 6573 2062 7920 6769 7669 entries by givi │ │ │ │ │ -0003b210: 6e67 0a61 206c 6973 7420 6f66 2075 7365 ng.a list of use │ │ │ │ │ -0003b220: 726e 616d 6573 2028 6173 2061 626f 7665 rnames (as above │ │ │ │ │ -0003b230: 2920 7573 696e 6720 7468 6520 272d 2d75 ) using the '--u │ │ │ │ │ -0003b240: 7365 7273 2720 6f70 7469 6f6e 2074 6f20 sers' option to │ │ │ │ │ -0003b250: 7468 650a 276d 656e 7565 6e74 7279 2720 the.'menuentry' │ │ │ │ │ -0003b260: 636f 6d6d 616e 6420 282a 6e6f 7465 206d command (*note m │ │ │ │ │ -0003b270: 656e 7565 6e74 7279 3a3a 292e 2020 4966 enuentry::). If │ │ │ │ │ -0003b280: 2074 6865 2027 2d2d 756e 7265 7374 7269 the '--unrestri │ │ │ │ │ -0003b290: 6374 6564 2720 6f70 7469 6f6e 0a69 7320 cted' option.is │ │ │ │ │ -0003b2a0: 7573 6564 2066 6f72 2061 206d 656e 7520 used for a menu │ │ │ │ │ -0003b2b0: 656e 7472 792c 2074 6865 6e20 7468 6174 entry, then that │ │ │ │ │ -0003b2c0: 2065 6e74 7279 2069 7320 756e 7265 7374 entry is unrest │ │ │ │ │ -0003b2d0: 7269 6374 6564 2e20 2049 6620 7468 650a ricted. If the. │ │ │ │ │ -0003b2e0: 272d 2d75 7365 7273 2720 6f70 7469 6f6e '--users' option │ │ │ │ │ -0003b2f0: 2069 7320 6e6f 7420 7573 6564 2066 6f72 is not used for │ │ │ │ │ -0003b300: 2061 206d 656e 7520 656e 7472 792c 2074 a menu entry, t │ │ │ │ │ -0003b310: 6865 6e20 7468 6174 206f 6e6c 7920 7375 hen that only su │ │ │ │ │ -0003b320: 7065 7275 7365 7273 0a61 7265 2061 626c perusers.are abl │ │ │ │ │ -0003b330: 6520 746f 2075 7365 2069 742e 0a0a 2020 e to use it... │ │ │ │ │ -0003b340: 2050 7574 7469 6e67 2074 6869 7320 746f Putting this to │ │ │ │ │ -0003b350: 6765 7468 6572 2c20 6120 7479 7069 6361 gether, a typica │ │ │ │ │ -0003b360: 6c20 2767 7275 622e 6366 6727 2066 7261 l 'grub.cfg' fra │ │ │ │ │ -0003b370: 676d 656e 7420 6d69 6768 7420 6c6f 6f6b gment might look │ │ │ │ │ -0003b380: 206c 696b 650a 7468 6973 3a0a 0a20 2020 like.this:.. │ │ │ │ │ -0003b390: 2020 7365 7420 7375 7065 7275 7365 7273 set superusers │ │ │ │ │ -0003b3a0: 3d22 726f 6f74 220a 2020 2020 2070 6173 ="root". pas │ │ │ │ │ -0003b3b0: 7377 6f72 645f 7062 6b64 6632 2072 6f6f sword_pbkdf2 roo │ │ │ │ │ -0003b3c0: 7420 6772 7562 2e70 626b 6466 322e 7368 t grub.pbkdf2.sh │ │ │ │ │ -0003b3d0: 6135 3132 2e31 3030 3030 2e62 6967 6c6f a512.10000.biglo │ │ │ │ │ -0003b3e0: 6e67 7374 7269 6e67 0a20 2020 2020 7061 ngstring. pa │ │ │ │ │ -0003b3f0: 7373 776f 7264 2075 7365 7231 2069 6e73 ssword user1 ins │ │ │ │ │ -0003b400: 6563 7572 650a 0a20 2020 2020 6d65 6e75 ecure.. menu │ │ │ │ │ -0003b410: 656e 7472 7920 224d 6179 2062 6520 7275 entry "May be ru │ │ │ │ │ -0003b420: 6e20 6279 2061 6e79 2075 7365 7222 202d n by any user" - │ │ │ │ │ -0003b430: 2d75 6e72 6573 7472 6963 7465 6420 7b0a -unrestricted {. │ │ │ │ │ -0003b440: 2020 2020 2009 7365 7420 726f 6f74 3d28 .set root=( │ │ │ │ │ -0003b450: 6864 302c 3129 0a20 2020 2020 096c 696e hd0,1). .lin │ │ │ │ │ -0003b460: 7578 202f 766d 6c69 6e75 7a0a 2020 2020 ux /vmlinuz. │ │ │ │ │ -0003b470: 207d 0a0a 2020 2020 206d 656e 7565 6e74 }.. menuent │ │ │ │ │ -0003b480: 7279 2022 5375 7065 7275 7365 7273 206f ry "Superusers o │ │ │ │ │ -0003b490: 6e6c 7922 202d 2d75 7365 7273 2022 2220 nly" --users "" │ │ │ │ │ -0003b4a0: 7b0a 2020 2020 2009 7365 7420 726f 6f74 {. .set root │ │ │ │ │ -0003b4b0: 3d28 6864 302c 3129 0a20 2020 2020 096c =(hd0,1). .l │ │ │ │ │ -0003b4c0: 696e 7578 202f 766d 6c69 6e75 7a20 7369 inux /vmlinuz si │ │ │ │ │ -0003b4d0: 6e67 6c65 0a20 2020 2020 7d0a 0a20 2020 ngle. }.. │ │ │ │ │ -0003b4e0: 2020 6d65 6e75 656e 7472 7920 224d 6179 menuentry "May │ │ │ │ │ -0003b4f0: 2062 6520 7275 6e20 6279 2075 7365 7231 be run by user1 │ │ │ │ │ -0003b500: 206f 7220 6120 7375 7065 7275 7365 7222 or a superuser" │ │ │ │ │ -0003b510: 202d 2d75 7365 7273 2075 7365 7231 207b --users user1 { │ │ │ │ │ -0003b520: 0a20 2020 2020 0973 6574 2072 6f6f 743d . .set root= │ │ │ │ │ -0003b530: 2868 6430 2c32 290a 2020 2020 2009 6368 (hd0,2). .ch │ │ │ │ │ -0003b540: 6169 6e6c 6f61 6465 7220 2b31 0a20 2020 ainloader +1. │ │ │ │ │ -0003b550: 2020 7d0a 0a20 2020 5468 6520 2767 7275 }.. The 'gru │ │ │ │ │ -0003b560: 622d 6d6b 636f 6e66 6967 2720 7072 6f67 b-mkconfig' prog │ │ │ │ │ -0003b570: 7261 6d20 646f 6573 206e 6f74 2079 6574 ram does not yet │ │ │ │ │ -0003b580: 2068 6176 6520 6275 696c 742d 696e 2073 have built-in s │ │ │ │ │ -0003b590: 7570 706f 7274 2066 6f72 0a67 656e 6572 upport for.gener │ │ │ │ │ -0003b5a0: 6174 696e 6720 636f 6e66 6967 7572 6174 ating configurat │ │ │ │ │ -0003b5b0: 696f 6e20 6669 6c65 7320 7769 7468 2061 ion files with a │ │ │ │ │ -0003b5c0: 7574 6865 6e74 6963 6174 696f 6e2e 2020 uthentication. │ │ │ │ │ -0003b5d0: 596f 7520 6361 6e20 7573 650a 272f 6574 You can use.'/et │ │ │ │ │ -0003b5e0: 632f 6772 7562 2e64 2f34 305f 6375 7374 c/grub.d/40_cust │ │ │ │ │ -0003b5f0: 6f6d 2720 746f 2061 6464 2073 696d 706c om' to add simpl │ │ │ │ │ -0003b600: 6520 7375 7065 7275 7365 7220 6175 7468 e superuser auth │ │ │ │ │ -0003b610: 656e 7469 6361 7469 6f6e 2c20 6279 0a61 entication, by.a │ │ │ │ │ -0003b620: 6464 696e 6720 2773 6574 2073 7570 6572 dding 'set super │ │ │ │ │ -0003b630: 7573 6572 733d 2720 616e 6420 2770 6173 users=' and 'pas │ │ │ │ │ -0003b640: 7377 6f72 6427 206f 7220 2770 6173 7377 sword' or 'passw │ │ │ │ │ -0003b650: 6f72 645f 7062 6b64 6632 2720 636f 6d6d ord_pbkdf2' comm │ │ │ │ │ -0003b660: 616e 6473 2e0a 0a1f 0a46 696c 653a 2067 ands.....File: g │ │ │ │ │ -0003b670: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ -0003b680: 2055 7369 6e67 2064 6967 6974 616c 2073 Using digital s │ │ │ │ │ -0003b690: 6967 6e61 7475 7265 732c 2020 4e65 7874 ignatures, Next │ │ │ │ │ -0003b6a0: 3a20 5545 4649 2073 6563 7572 6520 626f : UEFI secure bo │ │ │ │ │ -0003b6b0: 6f74 2061 6e64 2073 6869 6d2c 2020 5072 ot and shim, Pr │ │ │ │ │ -0003b6c0: 6576 3a20 4175 7468 656e 7469 6361 7469 ev: Authenticati │ │ │ │ │ -0003b6d0: 6f6e 2061 6e64 2061 7574 686f 7269 7361 on and authorisa │ │ │ │ │ -0003b6e0: 7469 6f6e 2c20 2055 703a 2053 6563 7572 tion, Up: Secur │ │ │ │ │ -0003b6f0: 6974 790a 0a31 382e 3220 5573 696e 6720 ity..18.2 Using │ │ │ │ │ -0003b700: 6469 6769 7461 6c20 7369 676e 6174 7572 digital signatur │ │ │ │ │ -0003b710: 6573 2069 6e20 4752 5542 0a3d 3d3d 3d3d es in GRUB.===== │ │ │ │ │ +0003ab00: 0a0a 4279 2064 6566 6175 6c74 2c20 7468 ..By default, th │ │ │ │ │ +0003ab10: 6520 626f 6f74 206c 6f61 6465 7220 696e e boot loader in │ │ │ │ │ +0003ab20: 7465 7266 6163 6520 6973 2061 6363 6573 terface is acces │ │ │ │ │ +0003ab30: 7369 626c 6520 746f 2061 6e79 6f6e 6520 sible to anyone │ │ │ │ │ +0003ab40: 7769 7468 0a70 6879 7369 6361 6c20 6163 with.physical ac │ │ │ │ │ +0003ab50: 6365 7373 2074 6f20 7468 6520 636f 6e73 cess to the cons │ │ │ │ │ +0003ab60: 6f6c 653a 2061 6e79 6f6e 6520 6361 6e20 ole: anyone can │ │ │ │ │ +0003ab70: 7365 6c65 6374 2061 6e64 2065 6469 7420 select and edit │ │ │ │ │ +0003ab80: 616e 7920 6d65 6e75 0a65 6e74 7279 2c20 any menu.entry, │ │ │ │ │ +0003ab90: 616e 6420 616e 796f 6e65 2063 616e 2067 and anyone can g │ │ │ │ │ +0003aba0: 6574 2064 6972 6563 7420 6163 6365 7373 et direct access │ │ │ │ │ +0003abb0: 2074 6f20 6120 4752 5542 2073 6865 6c6c to a GRUB shell │ │ │ │ │ +0003abc0: 2070 726f 6d70 742e 2020 466f 720a 6d6f prompt. For.mo │ │ │ │ │ +0003abd0: 7374 2073 7973 7465 6d73 2c20 7468 6973 st systems, this │ │ │ │ │ +0003abe0: 2069 7320 7265 6173 6f6e 6162 6c65 2073 is reasonable s │ │ │ │ │ +0003abf0: 696e 6365 2061 6e79 6f6e 6520 7769 7468 ince anyone with │ │ │ │ │ +0003ac00: 2064 6972 6563 7420 7068 7973 6963 616c direct physical │ │ │ │ │ +0003ac10: 0a61 6363 6573 7320 6861 7320 6120 7661 .access has a va │ │ │ │ │ +0003ac20: 7269 6574 7920 6f66 206f 7468 6572 2077 riety of other w │ │ │ │ │ +0003ac30: 6179 7320 746f 2067 6169 6e20 6675 6c6c ays to gain full │ │ │ │ │ +0003ac40: 2061 6363 6573 732c 2061 6e64 2072 6571 access, and req │ │ │ │ │ +0003ac50: 7569 7269 6e67 0a61 7574 6865 6e74 6963 uiring.authentic │ │ │ │ │ +0003ac60: 6174 696f 6e20 6174 2074 6865 2062 6f6f ation at the boo │ │ │ │ │ +0003ac70: 7420 6c6f 6164 6572 206c 6576 656c 2077 t loader level w │ │ │ │ │ +0003ac80: 6f75 6c64 206f 6e6c 7920 7365 7276 6520 ould only serve │ │ │ │ │ +0003ac90: 746f 206d 616b 6520 6974 0a64 6966 6669 to make it.diffi │ │ │ │ │ +0003aca0: 6375 6c74 2074 6f20 7265 636f 7665 7220 cult to recover │ │ │ │ │ +0003acb0: 6272 6f6b 656e 2073 7973 7465 6d73 2e0a broken systems.. │ │ │ │ │ +0003acc0: 0a20 2020 486f 7765 7665 722c 2069 6e20 . However, in │ │ │ │ │ +0003acd0: 736f 6d65 2065 6e76 6972 6f6e 6d65 6e74 some environment │ │ │ │ │ +0003ace0: 732c 2073 7563 6820 6173 206b 696f 736b s, such as kiosk │ │ │ │ │ +0003acf0: 732c 2069 7420 6d61 7920 6265 2061 7070 s, it may be app │ │ │ │ │ +0003ad00: 726f 7072 6961 7465 0a74 6f20 6c6f 636b ropriate.to lock │ │ │ │ │ +0003ad10: 2064 6f77 6e20 7468 6520 626f 6f74 206c down the boot l │ │ │ │ │ +0003ad20: 6f61 6465 7220 746f 2072 6571 7569 7265 oader to require │ │ │ │ │ +0003ad30: 2061 7574 6865 6e74 6963 6174 696f 6e20 authentication │ │ │ │ │ +0003ad40: 6265 666f 7265 2070 6572 666f 726d 696e before performin │ │ │ │ │ +0003ad50: 670a 6365 7274 6169 6e20 6f70 6572 6174 g.certain operat │ │ │ │ │ +0003ad60: 696f 6e73 2e0a 0a20 2020 5468 6520 2770 ions... The 'p │ │ │ │ │ +0003ad70: 6173 7377 6f72 6427 2028 2a6e 6f74 6520 assword' (*note │ │ │ │ │ +0003ad80: 7061 7373 776f 7264 3a3a 2920 616e 6420 password::) and │ │ │ │ │ +0003ad90: 2770 6173 7377 6f72 645f 7062 6b64 6632 'password_pbkdf2 │ │ │ │ │ +0003ada0: 2720 282a 6e6f 7465 0a70 6173 7377 6f72 ' (*note.passwor │ │ │ │ │ +0003adb0: 645f 7062 6b64 6632 3a3a 2920 636f 6d6d d_pbkdf2::) comm │ │ │ │ │ +0003adc0: 616e 6473 2063 616e 2062 6520 7573 6564 ands can be used │ │ │ │ │ +0003add0: 2074 6f20 6465 6669 6e65 2075 7365 7273 to define users │ │ │ │ │ +0003ade0: 2c20 6561 6368 206f 6620 7768 6963 680a , each of which. │ │ │ │ │ +0003adf0: 6861 7320 616e 2061 7373 6f63 6961 7465 has an associate │ │ │ │ │ +0003ae00: 6420 7061 7373 776f 7264 2e20 2027 7061 d password. 'pa │ │ │ │ │ +0003ae10: 7373 776f 7264 2720 7365 7473 2074 6865 ssword' sets the │ │ │ │ │ +0003ae20: 2070 6173 7377 6f72 6420 696e 2070 6c61 password in pla │ │ │ │ │ +0003ae30: 696e 2074 6578 742c 0a72 6571 7569 7269 in text,.requiri │ │ │ │ │ +0003ae40: 6e67 2027 6772 7562 2e63 6667 2720 746f ng 'grub.cfg' to │ │ │ │ │ +0003ae50: 2062 6520 7365 6375 7265 3b20 2770 6173 be secure; 'pas │ │ │ │ │ +0003ae60: 7377 6f72 645f 7062 6b64 6632 2720 7365 sword_pbkdf2' se │ │ │ │ │ +0003ae70: 7473 2074 6865 2070 6173 7377 6f72 640a ts the password. │ │ │ │ │ +0003ae80: 6861 7368 6564 2075 7369 6e67 2074 6865 hashed using the │ │ │ │ │ +0003ae90: 2050 6173 7377 6f72 642d 4261 7365 6420 Password-Based │ │ │ │ │ +0003aea0: 4b65 7920 4465 7269 7661 7469 6f6e 2046 Key Derivation F │ │ │ │ │ +0003aeb0: 756e 6374 696f 6e20 2852 4643 2032 3839 unction (RFC 289 │ │ │ │ │ +0003aec0: 3829 2c0a 7265 7175 6972 696e 6720 7468 8),.requiring th │ │ │ │ │ +0003aed0: 6520 7573 6520 6f66 2027 6772 7562 2d6d e use of 'grub-m │ │ │ │ │ +0003aee0: 6b70 6173 7377 642d 7062 6b64 6632 2720 kpasswd-pbkdf2' │ │ │ │ │ +0003aef0: 282a 6e6f 7465 2049 6e76 6f6b 696e 670a (*note Invoking. │ │ │ │ │ +0003af00: 6772 7562 2d6d 6b70 6173 7377 642d 7062 grub-mkpasswd-pb │ │ │ │ │ +0003af10: 6b64 6632 3a3a 2920 746f 2067 656e 6572 kdf2::) to gener │ │ │ │ │ +0003af20: 6174 6520 7061 7373 776f 7264 2068 6173 ate password has │ │ │ │ │ +0003af30: 6865 732e 0a0a 2020 2049 6e20 6f72 6465 hes... In orde │ │ │ │ │ +0003af40: 7220 746f 2065 6e61 626c 6520 6175 7468 r to enable auth │ │ │ │ │ +0003af50: 656e 7469 6361 7469 6f6e 2073 7570 706f entication suppo │ │ │ │ │ +0003af60: 7274 2c20 7468 6520 2773 7570 6572 7573 rt, the 'superus │ │ │ │ │ +0003af70: 6572 7327 0a65 6e76 6972 6f6e 6d65 6e74 ers'.environment │ │ │ │ │ +0003af80: 2076 6172 6961 626c 6520 6d75 7374 2062 variable must b │ │ │ │ │ +0003af90: 6520 7365 7420 746f 2061 206c 6973 7420 e set to a list │ │ │ │ │ +0003afa0: 6f66 2075 7365 726e 616d 6573 2c20 7365 of usernames, se │ │ │ │ │ +0003afb0: 7061 7261 7465 6420 6279 0a61 6e79 206f parated by.any o │ │ │ │ │ +0003afc0: 6620 7370 6163 6573 2c20 636f 6d6d 6173 f spaces, commas │ │ │ │ │ +0003afd0: 2c20 7365 6d69 636f 6c6f 6e73 2c20 7069 , semicolons, pi │ │ │ │ │ +0003afe0: 7065 732c 206f 7220 616d 7065 7273 616e pes, or ampersan │ │ │ │ │ +0003aff0: 6473 2e20 2053 7570 6572 7573 6572 7320 ds. Superusers │ │ │ │ │ +0003b000: 6172 650a 7065 726d 6974 7465 6420 746f are.permitted to │ │ │ │ │ +0003b010: 2075 7365 2074 6865 2047 5255 4220 636f use the GRUB co │ │ │ │ │ +0003b020: 6d6d 616e 6420 6c69 6e65 2c20 6564 6974 mmand line, edit │ │ │ │ │ +0003b030: 206d 656e 7520 656e 7472 6965 732c 2061 menu entries, a │ │ │ │ │ +0003b040: 6e64 2065 7865 6375 7465 0a61 6e79 206d nd execute.any m │ │ │ │ │ +0003b050: 656e 7520 656e 7472 792e 2020 4966 2027 enu entry. If ' │ │ │ │ │ +0003b060: 7375 7065 7275 7365 7273 2720 6973 2073 superusers' is s │ │ │ │ │ +0003b070: 6574 2c20 7468 656e 2075 7365 206f 6620 et, then use of │ │ │ │ │ +0003b080: 7468 6520 636f 6d6d 616e 6420 6c69 6e65 the command line │ │ │ │ │ +0003b090: 0a61 6e64 2065 6469 7469 6e67 206f 6620 .and editing of │ │ │ │ │ +0003b0a0: 6d65 6e75 2065 6e74 7269 6573 2061 7265 menu entries are │ │ │ │ │ +0003b0b0: 2061 7574 6f6d 6174 6963 616c 6c79 2072 automatically r │ │ │ │ │ +0003b0c0: 6573 7472 6963 7465 6420 746f 2073 7570 estricted to sup │ │ │ │ │ +0003b0d0: 6572 7573 6572 732e 0a53 6574 7469 6e67 erusers..Setting │ │ │ │ │ +0003b0e0: 2027 7375 7065 7275 7365 7273 2720 746f 'superusers' to │ │ │ │ │ +0003b0f0: 2065 6d70 7479 2073 7472 696e 6720 6566 empty string ef │ │ │ │ │ +0003b100: 6665 6374 6976 656c 7920 6469 7361 626c fectively disabl │ │ │ │ │ +0003b110: 6573 2062 6f74 6820 6163 6365 7373 2074 es both access t │ │ │ │ │ +0003b120: 6f0a 434c 4920 616e 6420 6564 6974 696e o.CLI and editin │ │ │ │ │ +0003b130: 6720 6f66 206d 656e 7520 656e 7472 6965 g of menu entrie │ │ │ │ │ +0003b140: 732e 2020 4e6f 7465 3a20 5468 6520 656e s. Note: The en │ │ │ │ │ +0003b150: 7669 726f 6e6d 656e 7420 7661 7269 6162 vironment variab │ │ │ │ │ +0003b160: 6c65 206e 6565 6473 0a74 6f20 6265 2065 le needs.to be e │ │ │ │ │ +0003b170: 7870 6f72 7465 6420 746f 2061 6c73 6f20 xported to also │ │ │ │ │ +0003b180: 6166 6665 6374 2074 6865 2073 6563 7469 affect the secti │ │ │ │ │ +0003b190: 6f6e 2064 6566 696e 6564 2062 7920 7468 on defined by th │ │ │ │ │ +0003b1a0: 6520 2773 7562 6d65 6e75 270a 636f 6d6d e 'submenu'.comm │ │ │ │ │ +0003b1b0: 616e 6420 282a 6e6f 7465 2073 7562 6d65 and (*note subme │ │ │ │ │ +0003b1c0: 6e75 3a3a 292e 0a0a 2020 204f 7468 6572 nu::)... Other │ │ │ │ │ +0003b1d0: 2075 7365 7273 206d 6179 2062 6520 616c users may be al │ │ │ │ │ +0003b1e0: 6c6f 7765 6420 746f 2065 7865 6375 7465 lowed to execute │ │ │ │ │ +0003b1f0: 2073 7065 6369 6669 6320 6d65 6e75 2065 specific menu e │ │ │ │ │ +0003b200: 6e74 7269 6573 2062 7920 6769 7669 6e67 ntries by giving │ │ │ │ │ +0003b210: 0a61 206c 6973 7420 6f66 2075 7365 726e .a list of usern │ │ │ │ │ +0003b220: 616d 6573 2028 6173 2061 626f 7665 2920 ames (as above) │ │ │ │ │ +0003b230: 7573 696e 6720 7468 6520 272d 2d75 7365 using the '--use │ │ │ │ │ +0003b240: 7273 2720 6f70 7469 6f6e 2074 6f20 7468 rs' option to th │ │ │ │ │ +0003b250: 650a 276d 656e 7565 6e74 7279 2720 636f e.'menuentry' co │ │ │ │ │ +0003b260: 6d6d 616e 6420 282a 6e6f 7465 206d 656e mmand (*note men │ │ │ │ │ +0003b270: 7565 6e74 7279 3a3a 292e 2020 4966 2074 uentry::). If t │ │ │ │ │ +0003b280: 6865 2027 2d2d 756e 7265 7374 7269 6374 he '--unrestrict │ │ │ │ │ +0003b290: 6564 2720 6f70 7469 6f6e 0a69 7320 7573 ed' option.is us │ │ │ │ │ +0003b2a0: 6564 2066 6f72 2061 206d 656e 7520 656e ed for a menu en │ │ │ │ │ +0003b2b0: 7472 792c 2074 6865 6e20 7468 6174 2065 try, then that e │ │ │ │ │ +0003b2c0: 6e74 7279 2069 7320 756e 7265 7374 7269 ntry is unrestri │ │ │ │ │ +0003b2d0: 6374 6564 2e20 2049 6620 7468 650a 272d cted. If the.'- │ │ │ │ │ +0003b2e0: 2d75 7365 7273 2720 6f70 7469 6f6e 2069 -users' option i │ │ │ │ │ +0003b2f0: 7320 6e6f 7420 7573 6564 2066 6f72 2061 s not used for a │ │ │ │ │ +0003b300: 206d 656e 7520 656e 7472 792c 2074 6865 menu entry, the │ │ │ │ │ +0003b310: 6e20 7468 6174 206f 6e6c 7920 7375 7065 n that only supe │ │ │ │ │ +0003b320: 7275 7365 7273 0a61 7265 2061 626c 6520 rusers.are able │ │ │ │ │ +0003b330: 746f 2075 7365 2069 742e 0a0a 2020 2050 to use it... P │ │ │ │ │ +0003b340: 7574 7469 6e67 2074 6869 7320 746f 6765 utting this toge │ │ │ │ │ +0003b350: 7468 6572 2c20 6120 7479 7069 6361 6c20 ther, a typical │ │ │ │ │ +0003b360: 2767 7275 622e 6366 6727 2066 7261 676d 'grub.cfg' fragm │ │ │ │ │ +0003b370: 656e 7420 6d69 6768 7420 6c6f 6f6b 206c ent might look l │ │ │ │ │ +0003b380: 696b 650a 7468 6973 3a0a 0a20 2020 2020 ike.this:.. │ │ │ │ │ +0003b390: 7365 7420 7375 7065 7275 7365 7273 3d22 set superusers=" │ │ │ │ │ +0003b3a0: 726f 6f74 220a 2020 2020 2070 6173 7377 root". passw │ │ │ │ │ +0003b3b0: 6f72 645f 7062 6b64 6632 2072 6f6f 7420 ord_pbkdf2 root │ │ │ │ │ +0003b3c0: 6772 7562 2e70 626b 6466 322e 7368 6135 grub.pbkdf2.sha5 │ │ │ │ │ +0003b3d0: 3132 2e31 3030 3030 2e62 6967 6c6f 6e67 12.10000.biglong │ │ │ │ │ +0003b3e0: 7374 7269 6e67 0a20 2020 2020 7061 7373 string. pass │ │ │ │ │ +0003b3f0: 776f 7264 2075 7365 7231 2069 6e73 6563 word user1 insec │ │ │ │ │ +0003b400: 7572 650a 0a20 2020 2020 6d65 6e75 656e ure.. menuen │ │ │ │ │ +0003b410: 7472 7920 224d 6179 2062 6520 7275 6e20 try "May be run │ │ │ │ │ +0003b420: 6279 2061 6e79 2075 7365 7222 202d 2d75 by any user" --u │ │ │ │ │ +0003b430: 6e72 6573 7472 6963 7465 6420 7b0a 2020 nrestricted {. │ │ │ │ │ +0003b440: 2020 2009 7365 7420 726f 6f74 3d28 6864 .set root=(hd │ │ │ │ │ +0003b450: 302c 3129 0a20 2020 2020 096c 696e 7578 0,1). .linux │ │ │ │ │ +0003b460: 202f 766d 6c69 6e75 7a0a 2020 2020 207d /vmlinuz. } │ │ │ │ │ +0003b470: 0a0a 2020 2020 206d 656e 7565 6e74 7279 .. menuentry │ │ │ │ │ +0003b480: 2022 5375 7065 7275 7365 7273 206f 6e6c "Superusers onl │ │ │ │ │ +0003b490: 7922 202d 2d75 7365 7273 2022 2220 7b0a y" --users "" {. │ │ │ │ │ +0003b4a0: 2020 2020 2009 7365 7420 726f 6f74 3d28 .set root=( │ │ │ │ │ +0003b4b0: 6864 302c 3129 0a20 2020 2020 096c 696e hd0,1). .lin │ │ │ │ │ +0003b4c0: 7578 202f 766d 6c69 6e75 7a20 7369 6e67 ux /vmlinuz sing │ │ │ │ │ +0003b4d0: 6c65 0a20 2020 2020 7d0a 0a20 2020 2020 le. }.. │ │ │ │ │ +0003b4e0: 6d65 6e75 656e 7472 7920 224d 6179 2062 menuentry "May b │ │ │ │ │ +0003b4f0: 6520 7275 6e20 6279 2075 7365 7231 206f e run by user1 o │ │ │ │ │ +0003b500: 7220 6120 7375 7065 7275 7365 7222 202d r a superuser" - │ │ │ │ │ +0003b510: 2d75 7365 7273 2075 7365 7231 207b 0a20 -users user1 {. │ │ │ │ │ +0003b520: 2020 2020 0973 6574 2072 6f6f 743d 2868 .set root=(h │ │ │ │ │ +0003b530: 6430 2c32 290a 2020 2020 2009 6368 6169 d0,2). .chai │ │ │ │ │ +0003b540: 6e6c 6f61 6465 7220 2b31 0a20 2020 2020 nloader +1. │ │ │ │ │ +0003b550: 7d0a 0a20 2020 5468 6520 2767 7275 622d }.. The 'grub- │ │ │ │ │ +0003b560: 6d6b 636f 6e66 6967 2720 7072 6f67 7261 mkconfig' progra │ │ │ │ │ +0003b570: 6d20 646f 6573 206e 6f74 2079 6574 2068 m does not yet h │ │ │ │ │ +0003b580: 6176 6520 6275 696c 742d 696e 2073 7570 ave built-in sup │ │ │ │ │ +0003b590: 706f 7274 2066 6f72 0a67 656e 6572 6174 port for.generat │ │ │ │ │ +0003b5a0: 696e 6720 636f 6e66 6967 7572 6174 696f ing configuratio │ │ │ │ │ +0003b5b0: 6e20 6669 6c65 7320 7769 7468 2061 7574 n files with aut │ │ │ │ │ +0003b5c0: 6865 6e74 6963 6174 696f 6e2e 2020 596f hentication. Yo │ │ │ │ │ +0003b5d0: 7520 6361 6e20 7573 650a 272f 6574 632f u can use.'/etc/ │ │ │ │ │ +0003b5e0: 6772 7562 2e64 2f34 305f 6375 7374 6f6d grub.d/40_custom │ │ │ │ │ +0003b5f0: 2720 746f 2061 6464 2073 696d 706c 6520 ' to add simple │ │ │ │ │ +0003b600: 7375 7065 7275 7365 7220 6175 7468 656e superuser authen │ │ │ │ │ +0003b610: 7469 6361 7469 6f6e 2c20 6279 0a61 6464 tication, by.add │ │ │ │ │ +0003b620: 696e 6720 2773 6574 2073 7570 6572 7573 ing 'set superus │ │ │ │ │ +0003b630: 6572 733d 2720 616e 6420 2770 6173 7377 ers=' and 'passw │ │ │ │ │ +0003b640: 6f72 6427 206f 7220 2770 6173 7377 6f72 ord' or 'passwor │ │ │ │ │ +0003b650: 645f 7062 6b64 6632 2720 636f 6d6d 616e d_pbkdf2' comman │ │ │ │ │ +0003b660: 6473 2e0a 0a1f 0a46 696c 653a 2067 7275 ds.....File: gru │ │ │ │ │ +0003b670: 622e 696e 666f 2c20 204e 6f64 653a 2055 b.info, Node: U │ │ │ │ │ +0003b680: 7369 6e67 2064 6967 6974 616c 2073 6967 sing digital sig │ │ │ │ │ +0003b690: 6e61 7475 7265 732c 2020 4e65 7874 3a20 natures, Next: │ │ │ │ │ +0003b6a0: 5545 4649 2073 6563 7572 6520 626f 6f74 UEFI secure boot │ │ │ │ │ +0003b6b0: 2061 6e64 2073 6869 6d2c 2020 5072 6576 and shim, Prev │ │ │ │ │ +0003b6c0: 3a20 4175 7468 656e 7469 6361 7469 6f6e : Authentication │ │ │ │ │ +0003b6d0: 2061 6e64 2061 7574 686f 7269 7361 7469 and authorisati │ │ │ │ │ +0003b6e0: 6f6e 2c20 2055 703a 2053 6563 7572 6974 on, Up: Securit │ │ │ │ │ +0003b6f0: 790a 0a31 382e 3220 5573 696e 6720 6469 y..18.2 Using di │ │ │ │ │ +0003b700: 6769 7461 6c20 7369 676e 6174 7572 6573 gital signatures │ │ │ │ │ +0003b710: 2069 6e20 4752 5542 0a3d 3d3d 3d3d 3d3d in GRUB.======= │ │ │ │ │ 0003b720: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0003b730: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0003b740: 0a0a 4752 5542 2773 2027 636f 7265 2e69 ..GRUB's 'core.i │ │ │ │ │ -0003b750: 6d67 2720 6361 6e20 6f70 7469 6f6e 616c mg' can optional │ │ │ │ │ -0003b760: 6c79 2070 726f 7669 6465 2065 6e66 6f72 ly provide enfor │ │ │ │ │ -0003b770: 6365 6d65 6e74 2074 6861 7420 616c 6c20 cement that all │ │ │ │ │ -0003b780: 6669 6c65 730a 7375 6273 6571 7565 6e74 files.subsequent │ │ │ │ │ -0003b790: 6c79 2072 6561 6420 6672 6f6d 2064 6973 ly read from dis │ │ │ │ │ -0003b7a0: 6b20 6172 6520 636f 7665 7265 6420 6279 k are covered by │ │ │ │ │ -0003b7b0: 2061 2076 616c 6964 2064 6967 6974 616c a valid digital │ │ │ │ │ -0003b7c0: 2073 6967 6e61 7475 7265 2e0a 5468 6973 signature..This │ │ │ │ │ -0003b7d0: 2064 6f63 756d 656e 7420 646f 6573 202a document does * │ │ │ │ │ -0003b7e0: 6e6f 742a 2063 6f76 6572 2068 6f77 2074 not* cover how t │ │ │ │ │ -0003b7f0: 6f20 656e 7375 7265 2074 6861 7420 796f o ensure that yo │ │ │ │ │ -0003b800: 7572 2070 6c61 7466 6f72 6d27 730a 6669 ur platform's.fi │ │ │ │ │ -0003b810: 726d 7761 7265 2028 652e 672e 2c20 436f rmware (e.g., Co │ │ │ │ │ -0003b820: 7265 626f 6f74 2920 7661 6c69 6461 7465 reboot) validate │ │ │ │ │ -0003b830: 7320 2763 6f72 652e 696d 6727 2e0a 0a20 s 'core.img'... │ │ │ │ │ -0003b840: 2020 4966 2065 6e76 6972 6f6e 6d65 6e74 If environment │ │ │ │ │ -0003b850: 2076 6172 6961 626c 6520 2763 6865 636b variable 'check │ │ │ │ │ -0003b860: 5f73 6967 6e61 7475 7265 7327 2028 2a6e _signatures' (*n │ │ │ │ │ -0003b870: 6f74 6520 6368 6563 6b5f 7369 676e 6174 ote check_signat │ │ │ │ │ -0003b880: 7572 6573 3a3a 290a 6973 2073 6574 2074 ures::).is set t │ │ │ │ │ -0003b890: 6f20 2765 6e66 6f72 6365 272c 2074 6865 o 'enforce', the │ │ │ │ │ -0003b8a0: 6e20 6576 6572 7920 6174 7465 6d70 7420 n every attempt │ │ │ │ │ -0003b8b0: 6279 2074 6865 2047 5255 4220 2763 6f72 by the GRUB 'cor │ │ │ │ │ -0003b8c0: 652e 696d 6727 2074 6f20 6c6f 6164 0a61 e.img' to load.a │ │ │ │ │ -0003b8d0: 6e6f 7468 6572 2066 696c 6520 2766 6f6f nother file 'foo │ │ │ │ │ -0003b8e0: 2720 696d 706c 6963 6974 6c79 2069 6e76 ' implicitly inv │ │ │ │ │ -0003b8f0: 6f6b 6573 2027 7665 7269 6679 5f64 6574 okes 'verify_det │ │ │ │ │ -0003b900: 6163 6865 6420 666f 6f20 666f 6f2e 7369 ached foo foo.si │ │ │ │ │ -0003b910: 6727 0a28 2a6e 6f74 6520 7665 7269 6679 g'.(*note verify │ │ │ │ │ -0003b920: 5f64 6574 6163 6865 643a 3a29 2e20 2027 _detached::). ' │ │ │ │ │ -0003b930: 666f 6f2e 7369 6727 206d 7573 7420 636f foo.sig' must co │ │ │ │ │ -0003b940: 6e74 6169 6e20 6120 7661 6c69 6420 6469 ntain a valid di │ │ │ │ │ -0003b950: 6769 7461 6c0a 7369 676e 6174 7572 6520 gital.signature │ │ │ │ │ -0003b960: 6f76 6572 2074 6865 2063 6f6e 7465 6e74 over the content │ │ │ │ │ -0003b970: 7320 6f66 2027 666f 6f27 2c20 7768 6963 s of 'foo', whic │ │ │ │ │ -0003b980: 6820 6361 6e20 6265 2076 6572 6966 6965 h can be verifie │ │ │ │ │ -0003b990: 6420 7769 7468 2061 0a70 7562 6c69 6320 d with a.public │ │ │ │ │ -0003b9a0: 6b65 7920 6375 7272 656e 746c 7920 7472 key currently tr │ │ │ │ │ -0003b9b0: 7573 7465 6420 6279 2047 5255 4220 282a usted by GRUB (* │ │ │ │ │ -0003b9c0: 6e6f 7465 206c 6973 745f 7472 7573 7465 note list_truste │ │ │ │ │ -0003b9d0: 643a 3a2c 202a 6e6f 7465 0a74 7275 7374 d::, *note.trust │ │ │ │ │ -0003b9e0: 3a3a 2c20 616e 6420 2a6e 6f74 6520 6469 ::, and *note di │ │ │ │ │ -0003b9f0: 7374 7275 7374 3a3a 292e 2020 4966 2076 strust::). If v │ │ │ │ │ -0003ba00: 616c 6964 6174 696f 6e20 6661 696c 732c alidation fails, │ │ │ │ │ -0003ba10: 2074 6865 6e20 6669 6c65 2027 666f 6f27 then file 'foo' │ │ │ │ │ -0003ba20: 0a63 616e 6e6f 7420 6265 206f 7065 6e65 .cannot be opene │ │ │ │ │ -0003ba30: 642e 2020 5468 6973 2066 6169 6c75 7265 d. This failure │ │ │ │ │ -0003ba40: 206d 6179 2068 616c 7420 6f72 206f 7468 may halt or oth │ │ │ │ │ -0003ba50: 6572 7769 7365 2069 6d70 6163 7420 7468 erwise impact th │ │ │ │ │ -0003ba60: 6520 626f 6f74 0a70 726f 6365 7373 2e0a e boot.process.. │ │ │ │ │ -0003ba70: 0a20 2020 416e 2069 6e69 7469 616c 2074 . An initial t │ │ │ │ │ -0003ba80: 7275 7374 6564 2070 7562 6c69 6320 6b65 rusted public ke │ │ │ │ │ -0003ba90: 7920 6361 6e20 6265 2065 6d62 6564 6465 y can be embedde │ │ │ │ │ -0003baa0: 6420 7769 7468 696e 2074 6865 2047 5255 d within the GRU │ │ │ │ │ -0003bab0: 420a 2763 6f72 652e 696d 6727 2075 7369 B.'core.img' usi │ │ │ │ │ -0003bac0: 6e67 2074 6865 2027 2d2d 7075 626b 6579 ng the '--pubkey │ │ │ │ │ -0003bad0: 2720 6f70 7469 6f6e 2074 6f20 2767 7275 ' option to 'gru │ │ │ │ │ -0003bae0: 622d 696e 7374 616c 6c27 2028 2a6e 6f74 b-install' (*not │ │ │ │ │ -0003baf0: 6520 496e 766f 6b69 6e67 0a67 7275 622d e Invoking.grub- │ │ │ │ │ -0003bb00: 696e 7374 616c 6c3a 3a29 2e0a 0a20 2020 install::)... │ │ │ │ │ -0003bb10: 4752 5542 2075 7365 7320 4750 472d 7374 GRUB uses GPG-st │ │ │ │ │ -0003bb20: 796c 6520 6465 7461 6368 6564 2073 6967 yle detached sig │ │ │ │ │ -0003bb30: 6e61 7475 7265 7320 286d 6561 6e69 6e67 natures (meaning │ │ │ │ │ -0003bb40: 2074 6861 7420 6120 6669 6c65 0a27 666f that a file.'fo │ │ │ │ │ -0003bb50: 6f2e 7369 6727 2077 696c 6c20 6265 2070 o.sig' will be p │ │ │ │ │ -0003bb60: 726f 6475 6365 6420 7768 656e 2066 696c roduced when fil │ │ │ │ │ -0003bb70: 6520 2766 6f6f 2720 6973 2073 6967 6e65 e 'foo' is signe │ │ │ │ │ -0003bb80: 6429 2c20 616e 6420 6375 7272 656e 746c d), and currentl │ │ │ │ │ -0003bb90: 790a 7375 7070 6f72 7473 2074 6865 2044 y.supports the D │ │ │ │ │ -0003bba0: 5341 2061 6e64 2052 5341 2073 6967 6e69 SA and RSA signi │ │ │ │ │ -0003bbb0: 6e67 2061 6c67 6f72 6974 686d 732e 2020 ng algorithms. │ │ │ │ │ -0003bbc0: 4120 7369 676e 696e 6720 6b65 7920 6361 A signing key ca │ │ │ │ │ -0003bbd0: 6e20 6265 0a67 656e 6572 6174 6564 2061 n be.generated a │ │ │ │ │ -0003bbe0: 7320 666f 6c6c 6f77 733a 0a0a 2020 2020 s follows:.. │ │ │ │ │ -0003bbf0: 2067 7067 202d 2d67 656e 2d6b 6579 0a0a gpg --gen-key.. │ │ │ │ │ -0003bc00: 2020 2041 6e20 696e 6469 7669 6475 616c An individual │ │ │ │ │ -0003bc10: 2066 696c 6520 6361 6e20 6265 2073 6967 file can be sig │ │ │ │ │ -0003bc20: 6e65 6420 6173 2066 6f6c 6c6f 7773 3a0a ned as follows:. │ │ │ │ │ -0003bc30: 0a20 2020 2020 6770 6720 2d2d 6465 7461 . gpg --deta │ │ │ │ │ -0003bc40: 6368 2d73 6967 6e20 2f70 6174 682f 746f ch-sign /path/to │ │ │ │ │ -0003bc50: 2f66 696c 650a 0a20 2020 466f 7220 7375 /file.. For su │ │ │ │ │ -0003bc60: 6363 6573 7366 756c 2076 616c 6964 6174 ccessful validat │ │ │ │ │ -0003bc70: 696f 6e20 6f66 2061 6c6c 206f 6620 4752 ion of all of GR │ │ │ │ │ -0003bc80: 5542 2773 2073 7562 636f 6d70 6f6e 656e UB's subcomponen │ │ │ │ │ -0003bc90: 7473 2061 6e64 2074 6865 0a6c 6f61 6465 ts and the.loade │ │ │ │ │ -0003bca0: 6420 4f53 206b 6572 6e65 6c2c 2074 6865 d OS kernel, the │ │ │ │ │ -0003bcb0: 7920 6d75 7374 2061 6c6c 2062 6520 7369 y must all be si │ │ │ │ │ -0003bcc0: 676e 6564 2e20 204f 6e65 2077 6179 2074 gned. One way t │ │ │ │ │ -0003bcd0: 6f20 6163 636f 6d70 6c69 7368 2074 6869 o accomplish thi │ │ │ │ │ -0003bce0: 730a 6973 2074 6865 2066 6f6c 6c6f 7769 s.is the followi │ │ │ │ │ -0003bcf0: 6e67 2028 6166 7465 7220 6861 7669 6e67 ng (after having │ │ │ │ │ -0003bd00: 2061 6c72 6561 6479 2070 726f 6475 6365 already produce │ │ │ │ │ -0003bd10: 6420 7468 6520 6465 7369 7265 6420 2767 d the desired 'g │ │ │ │ │ -0003bd20: 7275 622e 6366 6727 0a66 696c 652c 2065 rub.cfg'.file, e │ │ │ │ │ -0003bd30: 2e67 2e2c 2062 7920 7275 6e6e 696e 6720 .g., by running │ │ │ │ │ -0003bd40: 2767 7275 622d 6d6b 636f 6e66 6967 2720 'grub-mkconfig' │ │ │ │ │ -0003bd50: 282a 6e6f 7465 2049 6e76 6f6b 696e 6720 (*note Invoking │ │ │ │ │ -0003bd60: 6772 7562 2d6d 6b63 6f6e 6669 673a 3a29 grub-mkconfig::) │ │ │ │ │ -0003bd70: 3a0a 0a20 2020 2020 2320 4564 6974 202f :.. # Edit / │ │ │ │ │ -0003bd80: 6465 762f 7368 6d2f 7061 7373 7068 7261 dev/shm/passphra │ │ │ │ │ -0003bd90: 7365 2e74 7874 2074 6f20 636f 6e74 6169 se.txt to contai │ │ │ │ │ -0003bda0: 6e20 796f 7572 2073 6967 6e69 6e67 206b n your signing k │ │ │ │ │ -0003bdb0: 6579 2773 2070 6173 7370 6872 6173 650a ey's passphrase. │ │ │ │ │ -0003bdc0: 2020 2020 2066 6f72 2069 2069 6e20 6066 for i in `f │ │ │ │ │ -0003bdd0: 696e 6420 2f62 6f6f 7420 2d6e 616d 6520 ind /boot -name │ │ │ │ │ -0003bde0: 222a 2e63 6667 2220 2d6f 7220 2d6e 616d "*.cfg" -or -nam │ │ │ │ │ -0003bdf0: 6520 222a 2e6c 7374 2220 2d6f 7220 5c0a e "*.lst" -or \. │ │ │ │ │ -0003be00: 2020 2020 2020 202d 6e61 6d65 2022 2a2e -name "*. │ │ │ │ │ -0003be10: 6d6f 6422 202d 6f72 202d 6e61 6d65 2022 mod" -or -name " │ │ │ │ │ -0003be20: 766d 6c69 6e75 7a2a 2220 2d6f 7220 2d6e vmlinuz*" -or -n │ │ │ │ │ -0003be30: 616d 6520 2269 6e69 7472 642a 2220 2d6f ame "initrd*" -o │ │ │ │ │ -0003be40: 7220 5c0a 2020 2020 2020 202d 6e61 6d65 r \. -name │ │ │ │ │ -0003be50: 2022 6772 7562 656e 7622 603b 0a20 2020 "grubenv"`;. │ │ │ │ │ -0003be60: 2020 646f 0a20 2020 2020 2020 6770 6720 do. gpg │ │ │ │ │ -0003be70: 2d2d 6261 7463 6820 2d2d 6465 7461 6368 --batch --detach │ │ │ │ │ -0003be80: 2d73 6967 6e20 2d2d 7061 7373 7068 7261 -sign --passphra │ │ │ │ │ -0003be90: 7365 2d66 6420 3020 2469 203c 205c 0a20 se-fd 0 $i < \. │ │ │ │ │ -0003bea0: 2020 2020 2020 2020 2f64 6576 2f73 686d /dev/shm │ │ │ │ │ -0003beb0: 2f70 6173 7370 6872 6173 652e 7478 740a /passphrase.txt. │ │ │ │ │ -0003bec0: 2020 2020 2064 6f6e 650a 2020 2020 2073 done. s │ │ │ │ │ -0003bed0: 6872 6564 202f 6465 762f 7368 6d2f 7061 hred /dev/shm/pa │ │ │ │ │ -0003bee0: 7373 7068 7261 7365 2e74 7874 0a0a 2020 ssphrase.txt.. │ │ │ │ │ -0003bef0: 2053 6565 2061 6c73 6f3a 202a 6e6f 7465 See also: *note │ │ │ │ │ -0003bf00: 2063 6865 636b 5f73 6967 6e61 7475 7265 check_signature │ │ │ │ │ -0003bf10: 733a 3a2c 202a 6e6f 7465 2076 6572 6966 s::, *note verif │ │ │ │ │ -0003bf20: 795f 6465 7461 6368 6564 3a3a 2c20 2a6e y_detached::, *n │ │ │ │ │ -0003bf30: 6f74 650a 7472 7573 743a 3a2c 202a 6e6f ote.trust::, *no │ │ │ │ │ -0003bf40: 7465 206c 6973 745f 7472 7573 7465 643a te list_trusted: │ │ │ │ │ -0003bf50: 3a2c 202a 6e6f 7465 2064 6973 7472 7573 :, *note distrus │ │ │ │ │ -0003bf60: 743a 3a2c 202a 6e6f 7465 206c 6f61 645f t::, *note load_ │ │ │ │ │ -0003bf70: 656e 763a 3a2c 202a 6e6f 7465 0a73 6176 env::, *note.sav │ │ │ │ │ -0003bf80: 655f 656e 763a 3a2e 0a0a 2020 204e 6f74 e_env::... Not │ │ │ │ │ -0003bf90: 6520 7468 6174 2069 6e74 6572 6e61 6c6c e that internall │ │ │ │ │ -0003bfa0: 7920 7369 676e 6174 7572 6520 656e 666f y signature enfo │ │ │ │ │ -0003bfb0: 7263 656d 656e 7420 6973 2063 6f6e 7472 rcement is contr │ │ │ │ │ -0003bfc0: 6f6c 6c65 6420 6279 2073 6574 7469 6e67 olled by setting │ │ │ │ │ -0003bfd0: 0a74 6865 2065 6e76 6972 6f6e 6d65 6e74 .the environment │ │ │ │ │ -0003bfe0: 2076 6172 6961 626c 6520 2763 6865 636b variable 'check │ │ │ │ │ -0003bff0: 5f73 6967 6e61 7475 7265 7327 2065 7175 _signatures' equ │ │ │ │ │ -0003c000: 616c 2074 6f20 2765 6e66 6f72 6365 272e al to 'enforce'. │ │ │ │ │ -0003c010: 2020 5061 7373 696e 670a 6f6e 6520 6f72 Passing.one or │ │ │ │ │ -0003c020: 206d 6f72 6520 272d 2d70 7562 6b65 7927 more '--pubkey' │ │ │ │ │ -0003c030: 206f 7074 696f 6e73 2074 6f20 2767 7275 options to 'gru │ │ │ │ │ -0003c040: 622d 6d6b 696d 6167 6527 2069 6d70 6c69 b-mkimage' impli │ │ │ │ │ -0003c050: 6369 746c 7920 6465 6669 6e65 730a 2763 citly defines.'c │ │ │ │ │ -0003c060: 6865 636b 5f73 6967 6e61 7475 7265 7327 heck_signatures' │ │ │ │ │ -0003c070: 2065 7175 616c 2074 6f20 2765 6e66 6f72 equal to 'enfor │ │ │ │ │ -0003c080: 6365 2720 696e 2027 636f 7265 2e69 6d67 ce' in 'core.img │ │ │ │ │ -0003c090: 2720 7072 696f 7220 746f 2070 726f 6365 ' prior to proce │ │ │ │ │ -0003c0a0: 7373 696e 670a 616e 7920 636f 6e66 6967 ssing.any config │ │ │ │ │ -0003c0b0: 7572 6174 696f 6e20 6669 6c65 732e 0a0a uration files... │ │ │ │ │ -0003c0c0: 2020 204e 6f74 6520 7468 6174 2073 6967 Note that sig │ │ │ │ │ -0003c0d0: 6e61 7475 7265 2063 6865 636b 696e 6720 nature checking │ │ │ │ │ -0003c0e0: 646f 6573 202a 6e6f 742a 2070 7265 7665 does *not* preve │ │ │ │ │ -0003c0f0: 6e74 2061 6e20 6174 7461 636b 6572 2077 nt an attacker w │ │ │ │ │ -0003c100: 6974 680a 2873 6572 6961 6c2c 2070 6879 ith.(serial, phy │ │ │ │ │ -0003c110: 7369 6361 6c2c 202e 2e2e 2920 2063 6f6e sical, ...) con │ │ │ │ │ -0003c120: 736f 6c65 2061 6363 6573 7320 6672 6f6d sole access from │ │ │ │ │ -0003c130: 2064 726f 7070 696e 6720 6d61 6e75 616c dropping manual │ │ │ │ │ -0003c140: 6c79 2074 6f20 7468 650a 4752 5542 2063 ly to the.GRUB c │ │ │ │ │ -0003c150: 6f6e 736f 6c65 2061 6e64 2065 7865 6375 onsole and execu │ │ │ │ │ -0003c160: 7469 6e67 3a0a 0a20 2020 2020 7365 7420 ting:.. set │ │ │ │ │ -0003c170: 6368 6563 6b5f 7369 676e 6174 7572 6573 check_signatures │ │ │ │ │ -0003c180: 3d6e 6f0a 0a20 2020 546f 2070 7265 7665 =no.. To preve │ │ │ │ │ -0003c190: 6e74 2074 6869 732c 2070 6173 7377 6f72 nt this, passwor │ │ │ │ │ -0003c1a0: 642d 7072 6f74 6563 7469 6f6e 2028 2a6e d-protection (*n │ │ │ │ │ -0003c1b0: 6f74 6520 4175 7468 656e 7469 6361 7469 ote Authenticati │ │ │ │ │ -0003c1c0: 6f6e 2061 6e64 0a61 7574 686f 7269 7361 on and.authorisa │ │ │ │ │ -0003c1d0: 7469 6f6e 3a3a 2920 6973 2065 7373 656e tion::) is essen │ │ │ │ │ -0003c1e0: 7469 616c 2e20 204e 6f74 6520 7468 6174 tial. Note that │ │ │ │ │ -0003c1f0: 2065 7665 6e20 7769 7468 2047 5255 4220 even with GRUB │ │ │ │ │ -0003c200: 7061 7373 776f 7264 0a70 726f 7465 6374 password.protect │ │ │ │ │ -0003c210: 696f 6e2c 2047 5255 4220 6974 7365 6c66 ion, GRUB itself │ │ │ │ │ -0003c220: 2063 616e 6e6f 7420 7072 6576 656e 7420 cannot prevent │ │ │ │ │ -0003c230: 736f 6d65 6f6e 6520 7769 7468 2070 6879 someone with phy │ │ │ │ │ -0003c240: 7369 6361 6c20 6163 6365 7373 2074 6f0a sical access to. │ │ │ │ │ -0003c250: 7468 6520 6d61 6368 696e 6520 6672 6f6d the machine from │ │ │ │ │ -0003c260: 2061 6c74 6572 696e 6720 7468 6174 206d altering that m │ │ │ │ │ -0003c270: 6163 6869 6e65 2773 2066 6972 6d77 6172 achine's firmwar │ │ │ │ │ -0003c280: 6520 2865 2e67 2e2c 2043 6f72 6562 6f6f e (e.g., Coreboo │ │ │ │ │ -0003c290: 7420 6f72 0a42 494f 5329 2063 6f6e 6669 t or.BIOS) confi │ │ │ │ │ -0003c2a0: 6775 7261 7469 6f6e 2074 6f20 6361 7573 guration to caus │ │ │ │ │ -0003c2b0: 6520 7468 6520 6d61 6368 696e 6520 746f e the machine to │ │ │ │ │ -0003c2c0: 2062 6f6f 7420 6672 6f6d 2061 2064 6966 boot from a dif │ │ │ │ │ -0003c2d0: 6665 7265 6e74 0a28 6174 7461 636b 6572 ferent.(attacker │ │ │ │ │ -0003c2e0: 2d63 6f6e 7472 6f6c 6c65 6429 2064 6576 -controlled) dev │ │ │ │ │ -0003c2f0: 6963 652e 2020 4752 5542 2069 7320 6174 ice. GRUB is at │ │ │ │ │ -0003c300: 2062 6573 7420 6f6e 6c79 206f 6e65 206c best only one l │ │ │ │ │ -0003c310: 696e 6b20 696e 2061 2073 6563 7572 650a ink in a secure. │ │ │ │ │ -0003c320: 626f 6f74 2063 6861 696e 2e0a 0a1f 0a46 boot chain.....F │ │ │ │ │ -0003c330: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ -0003c340: 204e 6f64 653a 2055 4546 4920 7365 6375 Node: UEFI secu │ │ │ │ │ -0003c350: 7265 2062 6f6f 7420 616e 6420 7368 696d re boot and shim │ │ │ │ │ -0003c360: 2c20 204e 6578 743a 2053 6563 7572 6520 , Next: Secure │ │ │ │ │ -0003c370: 426f 6f74 2041 6476 616e 6365 6420 5461 Boot Advanced Ta │ │ │ │ │ -0003c380: 7267 6574 696e 672c 2020 5072 6576 3a20 rgeting, Prev: │ │ │ │ │ -0003c390: 5573 696e 6720 6469 6769 7461 6c20 7369 Using digital si │ │ │ │ │ -0003c3a0: 676e 6174 7572 6573 2c20 2055 703a 2053 gnatures, Up: S │ │ │ │ │ -0003c3b0: 6563 7572 6974 790a 0a31 382e 3320 5545 ecurity..18.3 UE │ │ │ │ │ -0003c3c0: 4649 2073 6563 7572 6520 626f 6f74 2061 FI secure boot a │ │ │ │ │ -0003c3d0: 6e64 2073 6869 6d20 7375 7070 6f72 740a nd shim support. │ │ │ │ │ +0003b730: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a ==============.. │ │ │ │ │ +0003b740: 4752 5542 2773 2027 636f 7265 2e69 6d67 GRUB's 'core.img │ │ │ │ │ +0003b750: 2720 6361 6e20 6f70 7469 6f6e 616c 6c79 ' can optionally │ │ │ │ │ +0003b760: 2070 726f 7669 6465 2065 6e66 6f72 6365 provide enforce │ │ │ │ │ +0003b770: 6d65 6e74 2074 6861 7420 616c 6c20 6669 ment that all fi │ │ │ │ │ +0003b780: 6c65 730a 7375 6273 6571 7565 6e74 6c79 les.subsequently │ │ │ │ │ +0003b790: 2072 6561 6420 6672 6f6d 2064 6973 6b20 read from disk │ │ │ │ │ +0003b7a0: 6172 6520 636f 7665 7265 6420 6279 2061 are covered by a │ │ │ │ │ +0003b7b0: 2076 616c 6964 2064 6967 6974 616c 2073 valid digital s │ │ │ │ │ +0003b7c0: 6967 6e61 7475 7265 2e0a 5468 6973 2064 ignature..This d │ │ │ │ │ +0003b7d0: 6f63 756d 656e 7420 646f 6573 202a 6e6f ocument does *no │ │ │ │ │ +0003b7e0: 742a 2063 6f76 6572 2068 6f77 2074 6f20 t* cover how to │ │ │ │ │ +0003b7f0: 656e 7375 7265 2074 6861 7420 796f 7572 ensure that your │ │ │ │ │ +0003b800: 2070 6c61 7466 6f72 6d27 730a 6669 726d platform's.firm │ │ │ │ │ +0003b810: 7761 7265 2028 652e 672e 2c20 436f 7265 ware (e.g., Core │ │ │ │ │ +0003b820: 626f 6f74 2920 7661 6c69 6461 7465 7320 boot) validates │ │ │ │ │ +0003b830: 2763 6f72 652e 696d 6727 2e0a 0a20 2020 'core.img'... │ │ │ │ │ +0003b840: 4966 2065 6e76 6972 6f6e 6d65 6e74 2076 If environment v │ │ │ │ │ +0003b850: 6172 6961 626c 6520 2763 6865 636b 5f73 ariable 'check_s │ │ │ │ │ +0003b860: 6967 6e61 7475 7265 7327 2028 2a6e 6f74 ignatures' (*not │ │ │ │ │ +0003b870: 6520 6368 6563 6b5f 7369 676e 6174 7572 e check_signatur │ │ │ │ │ +0003b880: 6573 3a3a 290a 6973 2073 6574 2074 6f20 es::).is set to │ │ │ │ │ +0003b890: 2765 6e66 6f72 6365 272c 2074 6865 6e20 'enforce', then │ │ │ │ │ +0003b8a0: 6576 6572 7920 6174 7465 6d70 7420 6279 every attempt by │ │ │ │ │ +0003b8b0: 2074 6865 2047 5255 4220 2763 6f72 652e the GRUB 'core. │ │ │ │ │ +0003b8c0: 696d 6727 2074 6f20 6c6f 6164 0a61 6e6f img' to load.ano │ │ │ │ │ +0003b8d0: 7468 6572 2066 696c 6520 2766 6f6f 2720 ther file 'foo' │ │ │ │ │ +0003b8e0: 696d 706c 6963 6974 6c79 2069 6e76 6f6b implicitly invok │ │ │ │ │ +0003b8f0: 6573 2027 7665 7269 6679 5f64 6574 6163 es 'verify_detac │ │ │ │ │ +0003b900: 6865 6420 666f 6f20 666f 6f2e 7369 6727 hed foo foo.sig' │ │ │ │ │ +0003b910: 0a28 2a6e 6f74 6520 7665 7269 6679 5f64 .(*note verify_d │ │ │ │ │ +0003b920: 6574 6163 6865 643a 3a29 2e20 2027 666f etached::). 'fo │ │ │ │ │ +0003b930: 6f2e 7369 6727 206d 7573 7420 636f 6e74 o.sig' must cont │ │ │ │ │ +0003b940: 6169 6e20 6120 7661 6c69 6420 6469 6769 ain a valid digi │ │ │ │ │ +0003b950: 7461 6c0a 7369 676e 6174 7572 6520 6f76 tal.signature ov │ │ │ │ │ +0003b960: 6572 2074 6865 2063 6f6e 7465 6e74 7320 er the contents │ │ │ │ │ +0003b970: 6f66 2027 666f 6f27 2c20 7768 6963 6820 of 'foo', which │ │ │ │ │ +0003b980: 6361 6e20 6265 2076 6572 6966 6965 6420 can be verified │ │ │ │ │ +0003b990: 7769 7468 2061 0a70 7562 6c69 6320 6b65 with a.public ke │ │ │ │ │ +0003b9a0: 7920 6375 7272 656e 746c 7920 7472 7573 y currently trus │ │ │ │ │ +0003b9b0: 7465 6420 6279 2047 5255 4220 282a 6e6f ted by GRUB (*no │ │ │ │ │ +0003b9c0: 7465 206c 6973 745f 7472 7573 7465 643a te list_trusted: │ │ │ │ │ +0003b9d0: 3a2c 202a 6e6f 7465 0a74 7275 7374 3a3a :, *note.trust:: │ │ │ │ │ +0003b9e0: 2c20 616e 6420 2a6e 6f74 6520 6469 7374 , and *note dist │ │ │ │ │ +0003b9f0: 7275 7374 3a3a 292e 2020 4966 2076 616c rust::). If val │ │ │ │ │ +0003ba00: 6964 6174 696f 6e20 6661 696c 732c 2074 idation fails, t │ │ │ │ │ +0003ba10: 6865 6e20 6669 6c65 2027 666f 6f27 0a63 hen file 'foo'.c │ │ │ │ │ +0003ba20: 616e 6e6f 7420 6265 206f 7065 6e65 642e annot be opened. │ │ │ │ │ +0003ba30: 2020 5468 6973 2066 6169 6c75 7265 206d This failure m │ │ │ │ │ +0003ba40: 6179 2068 616c 7420 6f72 206f 7468 6572 ay halt or other │ │ │ │ │ +0003ba50: 7769 7365 2069 6d70 6163 7420 7468 6520 wise impact the │ │ │ │ │ +0003ba60: 626f 6f74 0a70 726f 6365 7373 2e0a 0a20 boot.process... │ │ │ │ │ +0003ba70: 2020 416e 2069 6e69 7469 616c 2074 7275 An initial tru │ │ │ │ │ +0003ba80: 7374 6564 2070 7562 6c69 6320 6b65 7920 sted public key │ │ │ │ │ +0003ba90: 6361 6e20 6265 2065 6d62 6564 6465 6420 can be embedded │ │ │ │ │ +0003baa0: 7769 7468 696e 2074 6865 2047 5255 420a within the GRUB. │ │ │ │ │ +0003bab0: 2763 6f72 652e 696d 6727 2075 7369 6e67 'core.img' using │ │ │ │ │ +0003bac0: 2074 6865 2027 2d2d 7075 626b 6579 2720 the '--pubkey' │ │ │ │ │ +0003bad0: 6f70 7469 6f6e 2074 6f20 2767 7275 622d option to 'grub- │ │ │ │ │ +0003bae0: 696e 7374 616c 6c27 2028 2a6e 6f74 6520 install' (*note │ │ │ │ │ +0003baf0: 496e 766f 6b69 6e67 0a67 7275 622d 696e Invoking.grub-in │ │ │ │ │ +0003bb00: 7374 616c 6c3a 3a29 2e0a 0a20 2020 4752 stall::)... GR │ │ │ │ │ +0003bb10: 5542 2075 7365 7320 4750 472d 7374 796c UB uses GPG-styl │ │ │ │ │ +0003bb20: 6520 6465 7461 6368 6564 2073 6967 6e61 e detached signa │ │ │ │ │ +0003bb30: 7475 7265 7320 286d 6561 6e69 6e67 2074 tures (meaning t │ │ │ │ │ +0003bb40: 6861 7420 6120 6669 6c65 0a27 666f 6f2e hat a file.'foo. │ │ │ │ │ +0003bb50: 7369 6727 2077 696c 6c20 6265 2070 726f sig' will be pro │ │ │ │ │ +0003bb60: 6475 6365 6420 7768 656e 2066 696c 6520 duced when file │ │ │ │ │ +0003bb70: 2766 6f6f 2720 6973 2073 6967 6e65 6429 'foo' is signed) │ │ │ │ │ +0003bb80: 2c20 616e 6420 6375 7272 656e 746c 790a , and currently. │ │ │ │ │ +0003bb90: 7375 7070 6f72 7473 2074 6865 2044 5341 supports the DSA │ │ │ │ │ +0003bba0: 2061 6e64 2052 5341 2073 6967 6e69 6e67 and RSA signing │ │ │ │ │ +0003bbb0: 2061 6c67 6f72 6974 686d 732e 2020 4120 algorithms. A │ │ │ │ │ +0003bbc0: 7369 676e 696e 6720 6b65 7920 6361 6e20 signing key can │ │ │ │ │ +0003bbd0: 6265 0a67 656e 6572 6174 6564 2061 7320 be.generated as │ │ │ │ │ +0003bbe0: 666f 6c6c 6f77 733a 0a0a 2020 2020 2067 follows:.. g │ │ │ │ │ +0003bbf0: 7067 202d 2d67 656e 2d6b 6579 0a0a 2020 pg --gen-key.. │ │ │ │ │ +0003bc00: 2041 6e20 696e 6469 7669 6475 616c 2066 An individual f │ │ │ │ │ +0003bc10: 696c 6520 6361 6e20 6265 2073 6967 6e65 ile can be signe │ │ │ │ │ +0003bc20: 6420 6173 2066 6f6c 6c6f 7773 3a0a 0a20 d as follows:.. │ │ │ │ │ +0003bc30: 2020 2020 6770 6720 2d2d 6465 7461 6368 gpg --detach │ │ │ │ │ +0003bc40: 2d73 6967 6e20 2f70 6174 682f 746f 2f66 -sign /path/to/f │ │ │ │ │ +0003bc50: 696c 650a 0a20 2020 466f 7220 7375 6363 ile.. For succ │ │ │ │ │ +0003bc60: 6573 7366 756c 2076 616c 6964 6174 696f essful validatio │ │ │ │ │ +0003bc70: 6e20 6f66 2061 6c6c 206f 6620 4752 5542 n of all of GRUB │ │ │ │ │ +0003bc80: 2773 2073 7562 636f 6d70 6f6e 656e 7473 's subcomponents │ │ │ │ │ +0003bc90: 2061 6e64 2074 6865 0a6c 6f61 6465 6420 and the.loaded │ │ │ │ │ +0003bca0: 4f53 206b 6572 6e65 6c2c 2074 6865 7920 OS kernel, they │ │ │ │ │ +0003bcb0: 6d75 7374 2061 6c6c 2062 6520 7369 676e must all be sign │ │ │ │ │ +0003bcc0: 6564 2e20 204f 6e65 2077 6179 2074 6f20 ed. One way to │ │ │ │ │ +0003bcd0: 6163 636f 6d70 6c69 7368 2074 6869 730a accomplish this. │ │ │ │ │ +0003bce0: 6973 2074 6865 2066 6f6c 6c6f 7769 6e67 is the following │ │ │ │ │ +0003bcf0: 2028 6166 7465 7220 6861 7669 6e67 2061 (after having a │ │ │ │ │ +0003bd00: 6c72 6561 6479 2070 726f 6475 6365 6420 lready produced │ │ │ │ │ +0003bd10: 7468 6520 6465 7369 7265 6420 2767 7275 the desired 'gru │ │ │ │ │ +0003bd20: 622e 6366 6727 0a66 696c 652c 2065 2e67 b.cfg'.file, e.g │ │ │ │ │ +0003bd30: 2e2c 2062 7920 7275 6e6e 696e 6720 2767 ., by running 'g │ │ │ │ │ +0003bd40: 7275 622d 6d6b 636f 6e66 6967 2720 282a rub-mkconfig' (* │ │ │ │ │ +0003bd50: 6e6f 7465 2049 6e76 6f6b 696e 6720 6772 note Invoking gr │ │ │ │ │ +0003bd60: 7562 2d6d 6b63 6f6e 6669 673a 3a29 3a0a ub-mkconfig::):. │ │ │ │ │ +0003bd70: 0a20 2020 2020 2320 4564 6974 202f 6465 . # Edit /de │ │ │ │ │ +0003bd80: 762f 7368 6d2f 7061 7373 7068 7261 7365 v/shm/passphrase │ │ │ │ │ +0003bd90: 2e74 7874 2074 6f20 636f 6e74 6169 6e20 .txt to contain │ │ │ │ │ +0003bda0: 796f 7572 2073 6967 6e69 6e67 206b 6579 your signing key │ │ │ │ │ +0003bdb0: 2773 2070 6173 7370 6872 6173 650a 2020 's passphrase. │ │ │ │ │ +0003bdc0: 2020 2066 6f72 2069 2069 6e20 6066 696e for i in `fin │ │ │ │ │ +0003bdd0: 6420 2f62 6f6f 7420 2d6e 616d 6520 222a d /boot -name "* │ │ │ │ │ +0003bde0: 2e63 6667 2220 2d6f 7220 2d6e 616d 6520 .cfg" -or -name │ │ │ │ │ +0003bdf0: 222a 2e6c 7374 2220 2d6f 7220 5c0a 2020 "*.lst" -or \. │ │ │ │ │ +0003be00: 2020 2020 202d 6e61 6d65 2022 2a2e 6d6f -name "*.mo │ │ │ │ │ +0003be10: 6422 202d 6f72 202d 6e61 6d65 2022 766d d" -or -name "vm │ │ │ │ │ +0003be20: 6c69 6e75 7a2a 2220 2d6f 7220 2d6e 616d linuz*" -or -nam │ │ │ │ │ +0003be30: 6520 2269 6e69 7472 642a 2220 2d6f 7220 e "initrd*" -or │ │ │ │ │ +0003be40: 5c0a 2020 2020 2020 202d 6e61 6d65 2022 \. -name " │ │ │ │ │ +0003be50: 6772 7562 656e 7622 603b 0a20 2020 2020 grubenv"`;. │ │ │ │ │ +0003be60: 646f 0a20 2020 2020 2020 6770 6720 2d2d do. gpg -- │ │ │ │ │ +0003be70: 6261 7463 6820 2d2d 6465 7461 6368 2d73 batch --detach-s │ │ │ │ │ +0003be80: 6967 6e20 2d2d 7061 7373 7068 7261 7365 ign --passphrase │ │ │ │ │ +0003be90: 2d66 6420 3020 2469 203c 205c 0a20 2020 -fd 0 $i < \. │ │ │ │ │ +0003bea0: 2020 2020 2020 2f64 6576 2f73 686d 2f70 /dev/shm/p │ │ │ │ │ +0003beb0: 6173 7370 6872 6173 652e 7478 740a 2020 assphrase.txt. │ │ │ │ │ +0003bec0: 2020 2064 6f6e 650a 2020 2020 2073 6872 done. shr │ │ │ │ │ +0003bed0: 6564 202f 6465 762f 7368 6d2f 7061 7373 ed /dev/shm/pass │ │ │ │ │ +0003bee0: 7068 7261 7365 2e74 7874 0a0a 2020 2053 phrase.txt.. S │ │ │ │ │ +0003bef0: 6565 2061 6c73 6f3a 202a 6e6f 7465 2063 ee also: *note c │ │ │ │ │ +0003bf00: 6865 636b 5f73 6967 6e61 7475 7265 733a heck_signatures: │ │ │ │ │ +0003bf10: 3a2c 202a 6e6f 7465 2076 6572 6966 795f :, *note verify_ │ │ │ │ │ +0003bf20: 6465 7461 6368 6564 3a3a 2c20 2a6e 6f74 detached::, *not │ │ │ │ │ +0003bf30: 650a 7472 7573 743a 3a2c 202a 6e6f 7465 e.trust::, *note │ │ │ │ │ +0003bf40: 206c 6973 745f 7472 7573 7465 643a 3a2c list_trusted::, │ │ │ │ │ +0003bf50: 202a 6e6f 7465 2064 6973 7472 7573 743a *note distrust: │ │ │ │ │ +0003bf60: 3a2c 202a 6e6f 7465 206c 6f61 645f 656e :, *note load_en │ │ │ │ │ +0003bf70: 763a 3a2c 202a 6e6f 7465 0a73 6176 655f v::, *note.save_ │ │ │ │ │ +0003bf80: 656e 763a 3a2e 0a0a 2020 204e 6f74 6520 env::... Note │ │ │ │ │ +0003bf90: 7468 6174 2069 6e74 6572 6e61 6c6c 7920 that internally │ │ │ │ │ +0003bfa0: 7369 676e 6174 7572 6520 656e 666f 7263 signature enforc │ │ │ │ │ +0003bfb0: 656d 656e 7420 6973 2063 6f6e 7472 6f6c ement is control │ │ │ │ │ +0003bfc0: 6c65 6420 6279 2073 6574 7469 6e67 0a74 led by setting.t │ │ │ │ │ +0003bfd0: 6865 2065 6e76 6972 6f6e 6d65 6e74 2076 he environment v │ │ │ │ │ +0003bfe0: 6172 6961 626c 6520 2763 6865 636b 5f73 ariable 'check_s │ │ │ │ │ +0003bff0: 6967 6e61 7475 7265 7327 2065 7175 616c ignatures' equal │ │ │ │ │ +0003c000: 2074 6f20 2765 6e66 6f72 6365 272e 2020 to 'enforce'. │ │ │ │ │ +0003c010: 5061 7373 696e 670a 6f6e 6520 6f72 206d Passing.one or m │ │ │ │ │ +0003c020: 6f72 6520 272d 2d70 7562 6b65 7927 206f ore '--pubkey' o │ │ │ │ │ +0003c030: 7074 696f 6e73 2074 6f20 2767 7275 622d ptions to 'grub- │ │ │ │ │ +0003c040: 6d6b 696d 6167 6527 2069 6d70 6c69 6369 mkimage' implici │ │ │ │ │ +0003c050: 746c 7920 6465 6669 6e65 730a 2763 6865 tly defines.'che │ │ │ │ │ +0003c060: 636b 5f73 6967 6e61 7475 7265 7327 2065 ck_signatures' e │ │ │ │ │ +0003c070: 7175 616c 2074 6f20 2765 6e66 6f72 6365 qual to 'enforce │ │ │ │ │ +0003c080: 2720 696e 2027 636f 7265 2e69 6d67 2720 ' in 'core.img' │ │ │ │ │ +0003c090: 7072 696f 7220 746f 2070 726f 6365 7373 prior to process │ │ │ │ │ +0003c0a0: 696e 670a 616e 7920 636f 6e66 6967 7572 ing.any configur │ │ │ │ │ +0003c0b0: 6174 696f 6e20 6669 6c65 732e 0a0a 2020 ation files... │ │ │ │ │ +0003c0c0: 204e 6f74 6520 7468 6174 2073 6967 6e61 Note that signa │ │ │ │ │ +0003c0d0: 7475 7265 2063 6865 636b 696e 6720 646f ture checking do │ │ │ │ │ +0003c0e0: 6573 202a 6e6f 742a 2070 7265 7665 6e74 es *not* prevent │ │ │ │ │ +0003c0f0: 2061 6e20 6174 7461 636b 6572 2077 6974 an attacker wit │ │ │ │ │ +0003c100: 680a 2873 6572 6961 6c2c 2070 6879 7369 h.(serial, physi │ │ │ │ │ +0003c110: 6361 6c2c 202e 2e2e 2920 2063 6f6e 736f cal, ...) conso │ │ │ │ │ +0003c120: 6c65 2061 6363 6573 7320 6672 6f6d 2064 le access from d │ │ │ │ │ +0003c130: 726f 7070 696e 6720 6d61 6e75 616c 6c79 ropping manually │ │ │ │ │ +0003c140: 2074 6f20 7468 650a 4752 5542 2063 6f6e to the.GRUB con │ │ │ │ │ +0003c150: 736f 6c65 2061 6e64 2065 7865 6375 7469 sole and executi │ │ │ │ │ +0003c160: 6e67 3a0a 0a20 2020 2020 7365 7420 6368 ng:.. set ch │ │ │ │ │ +0003c170: 6563 6b5f 7369 676e 6174 7572 6573 3d6e eck_signatures=n │ │ │ │ │ +0003c180: 6f0a 0a20 2020 546f 2070 7265 7665 6e74 o.. To prevent │ │ │ │ │ +0003c190: 2074 6869 732c 2070 6173 7377 6f72 642d this, password- │ │ │ │ │ +0003c1a0: 7072 6f74 6563 7469 6f6e 2028 2a6e 6f74 protection (*not │ │ │ │ │ +0003c1b0: 6520 4175 7468 656e 7469 6361 7469 6f6e e Authentication │ │ │ │ │ +0003c1c0: 2061 6e64 0a61 7574 686f 7269 7361 7469 and.authorisati │ │ │ │ │ +0003c1d0: 6f6e 3a3a 2920 6973 2065 7373 656e 7469 on::) is essenti │ │ │ │ │ +0003c1e0: 616c 2e20 204e 6f74 6520 7468 6174 2065 al. Note that e │ │ │ │ │ +0003c1f0: 7665 6e20 7769 7468 2047 5255 4220 7061 ven with GRUB pa │ │ │ │ │ +0003c200: 7373 776f 7264 0a70 726f 7465 6374 696f ssword.protectio │ │ │ │ │ +0003c210: 6e2c 2047 5255 4220 6974 7365 6c66 2063 n, GRUB itself c │ │ │ │ │ +0003c220: 616e 6e6f 7420 7072 6576 656e 7420 736f annot prevent so │ │ │ │ │ +0003c230: 6d65 6f6e 6520 7769 7468 2070 6879 7369 meone with physi │ │ │ │ │ +0003c240: 6361 6c20 6163 6365 7373 2074 6f0a 7468 cal access to.th │ │ │ │ │ +0003c250: 6520 6d61 6368 696e 6520 6672 6f6d 2061 e machine from a │ │ │ │ │ +0003c260: 6c74 6572 696e 6720 7468 6174 206d 6163 ltering that mac │ │ │ │ │ +0003c270: 6869 6e65 2773 2066 6972 6d77 6172 6520 hine's firmware │ │ │ │ │ +0003c280: 2865 2e67 2e2c 2043 6f72 6562 6f6f 7420 (e.g., Coreboot │ │ │ │ │ +0003c290: 6f72 0a42 494f 5329 2063 6f6e 6669 6775 or.BIOS) configu │ │ │ │ │ +0003c2a0: 7261 7469 6f6e 2074 6f20 6361 7573 6520 ration to cause │ │ │ │ │ +0003c2b0: 7468 6520 6d61 6368 696e 6520 746f 2062 the machine to b │ │ │ │ │ +0003c2c0: 6f6f 7420 6672 6f6d 2061 2064 6966 6665 oot from a diffe │ │ │ │ │ +0003c2d0: 7265 6e74 0a28 6174 7461 636b 6572 2d63 rent.(attacker-c │ │ │ │ │ +0003c2e0: 6f6e 7472 6f6c 6c65 6429 2064 6576 6963 ontrolled) devic │ │ │ │ │ +0003c2f0: 652e 2020 4752 5542 2069 7320 6174 2062 e. GRUB is at b │ │ │ │ │ +0003c300: 6573 7420 6f6e 6c79 206f 6e65 206c 696e est only one lin │ │ │ │ │ +0003c310: 6b20 696e 2061 2073 6563 7572 650a 626f k in a secure.bo │ │ │ │ │ +0003c320: 6f74 2063 6861 696e 2e0a 0a1f 0a46 696c ot chain.....Fil │ │ │ │ │ +0003c330: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ +0003c340: 6f64 653a 2055 4546 4920 7365 6375 7265 ode: UEFI secure │ │ │ │ │ +0003c350: 2062 6f6f 7420 616e 6420 7368 696d 2c20 boot and shim, │ │ │ │ │ +0003c360: 204e 6578 743a 2053 6563 7572 6520 426f Next: Secure Bo │ │ │ │ │ +0003c370: 6f74 2041 6476 616e 6365 6420 5461 7267 ot Advanced Targ │ │ │ │ │ +0003c380: 6574 696e 672c 2020 5072 6576 3a20 5573 eting, Prev: Us │ │ │ │ │ +0003c390: 696e 6720 6469 6769 7461 6c20 7369 676e ing digital sign │ │ │ │ │ +0003c3a0: 6174 7572 6573 2c20 2055 703a 2053 6563 atures, Up: Sec │ │ │ │ │ +0003c3b0: 7572 6974 790a 0a31 382e 3320 5545 4649 urity..18.3 UEFI │ │ │ │ │ +0003c3c0: 2073 6563 7572 6520 626f 6f74 2061 6e64 secure boot and │ │ │ │ │ +0003c3d0: 2073 6869 6d20 7375 7070 6f72 740a 3d3d shim support.== │ │ │ │ │ 0003c3e0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 0003c3f0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0003c400: 3d3d 3d3d 3d3d 0a0a 5468 6520 4752 5542 ======..The GRUB │ │ │ │ │ -0003c410: 2c20 6578 6365 7074 2074 6865 2027 6368 , except the 'ch │ │ │ │ │ -0003c420: 6169 6e6c 6f61 6465 7227 2063 6f6d 6d61 ainloader' comma │ │ │ │ │ -0003c430: 6e64 2c20 776f 726b 7320 7769 7468 2074 nd, works with t │ │ │ │ │ -0003c440: 6865 2055 4546 4920 7365 6375 7265 0a62 he UEFI secure.b │ │ │ │ │ -0003c450: 6f6f 7420 616e 6420 7468 6520 7368 696d oot and the shim │ │ │ │ │ -0003c460: 2e20 2054 6869 7320 6675 6e63 7469 6f6e . This function │ │ │ │ │ -0003c470: 616c 6974 7920 6973 2070 726f 7669 6465 ality is provide │ │ │ │ │ -0003c480: 6420 6279 2074 6865 2073 6869 6d5f 6c6f d by the shim_lo │ │ │ │ │ -0003c490: 636b 0a76 6572 6966 6965 722e 2020 4974 ck.verifier. It │ │ │ │ │ -0003c4a0: 2069 7320 6275 696c 7420 696e 746f 2074 is built into t │ │ │ │ │ -0003c4b0: 6865 2027 636f 7265 2e69 6d67 2720 616e he 'core.img' an │ │ │ │ │ -0003c4c0: 6420 6973 2072 6567 6973 7465 7265 6420 d is registered │ │ │ │ │ -0003c4d0: 6966 2074 6865 2055 4546 490a 7365 6375 if the UEFI.secu │ │ │ │ │ -0003c4e0: 7265 2062 6f6f 7420 6973 2065 6e61 626c re boot is enabl │ │ │ │ │ -0003c4f0: 6564 2e20 2054 6865 2027 7368 696d 5f6c ed. The 'shim_l │ │ │ │ │ -0003c500: 6f63 6b27 2076 6172 6961 626c 6520 6973 ock' variable is │ │ │ │ │ -0003c510: 2073 6574 2074 6f20 2779 2720 7768 656e set to 'y' when │ │ │ │ │ -0003c520: 0a73 6869 6d5f 6c6f 636b 2076 6572 6966 .shim_lock verif │ │ │ │ │ -0003c530: 6965 7220 6973 2072 6567 6973 7465 7265 ier is registere │ │ │ │ │ -0003c540: 642e 2020 4966 2069 7420 6973 2064 6573 d. If it is des │ │ │ │ │ -0003c550: 6972 6564 2074 6f20 7573 6520 5545 4649 ired to use UEFI │ │ │ │ │ -0003c560: 2073 6563 7572 650a 626f 6f74 2077 6974 secure.boot wit │ │ │ │ │ -0003c570: 686f 7574 2073 6869 6d2c 206f 6e65 2063 hout shim, one c │ │ │ │ │ -0003c580: 616e 2064 6973 6162 6c65 2073 6869 6d5f an disable shim_ │ │ │ │ │ -0003c590: 6c6f 636b 2062 7920 6469 7361 626c 696e lock by disablin │ │ │ │ │ -0003c5a0: 6720 7368 696d 0a76 6572 6966 6963 6174 g shim.verificat │ │ │ │ │ -0003c5b0: 696f 6e20 7769 7468 204d 6f6b 5362 5374 ion with MokSbSt │ │ │ │ │ -0003c5c0: 6174 6520 5545 4649 2076 6172 6961 626c ate UEFI variabl │ │ │ │ │ -0003c5d0: 6520 6f72 2062 7920 6275 696c 6469 6e67 e or by building │ │ │ │ │ -0003c5e0: 2067 7275 6220 696d 6167 650a 7769 7468 grub image.with │ │ │ │ │ -0003c5f0: 2027 2d2d 6469 7361 626c 652d 7368 696d '--disable-shim │ │ │ │ │ -0003c600: 2d6c 6f63 6b27 206f 7074 696f 6e2e 0a0a -lock' option... │ │ │ │ │ -0003c610: 2020 2041 6c6c 2047 5255 4220 6d6f 6475 All GRUB modu │ │ │ │ │ -0003c620: 6c65 7320 6e6f 7420 7374 6f72 6564 2069 les not stored i │ │ │ │ │ -0003c630: 6e20 7468 6520 2763 6f72 652e 696d 6727 n the 'core.img' │ │ │ │ │ -0003c640: 2c20 4f53 206b 6572 6e65 6c73 2c20 4143 , OS kernels, AC │ │ │ │ │ -0003c650: 5049 0a74 6162 6c65 732c 2044 6576 6963 PI.tables, Devic │ │ │ │ │ -0003c660: 6520 5472 6565 732c 2065 7463 2e20 2068 e Trees, etc. h │ │ │ │ │ -0003c670: 6176 6520 746f 2062 6520 7369 676e 6564 ave to be signed │ │ │ │ │ -0003c680: 2c20 652e 672c 2075 7369 6e67 2050 4750 , e.g, using PGP │ │ │ │ │ -0003c690: 2e0a 4164 6469 7469 6f6e 616c 6c79 2c20 ..Additionally, │ │ │ │ │ -0003c6a0: 7468 6520 636f 6d6d 616e 6473 2074 6861 the commands tha │ │ │ │ │ -0003c6b0: 7420 6361 6e20 6265 2075 7365 6420 746f t can be used to │ │ │ │ │ -0003c6c0: 2073 7562 7665 7274 2074 6865 2055 4546 subvert the UEF │ │ │ │ │ -0003c6d0: 4920 7365 6375 7265 0a62 6f6f 7420 6d65 I secure.boot me │ │ │ │ │ -0003c6e0: 6368 616e 6973 6d2c 2073 7563 6820 6173 chanism, such as │ │ │ │ │ -0003c6f0: 2027 696f 7277 2720 616e 6420 276d 656d 'iorw' and 'mem │ │ │ │ │ -0003c700: 7277 2720 7769 6c6c 206e 6f74 2062 6520 rw' will not be │ │ │ │ │ -0003c710: 6176 6169 6c61 626c 6520 7768 656e 0a74 available when.t │ │ │ │ │ -0003c720: 6865 2055 4546 4920 7365 6375 7265 2062 he UEFI secure b │ │ │ │ │ -0003c730: 6f6f 7420 6973 2065 6e61 626c 6564 2e20 oot is enabled. │ │ │ │ │ -0003c740: 2054 6869 7320 6973 2064 6f6e 6520 666f This is done fo │ │ │ │ │ -0003c750: 7220 7365 6375 7269 7479 2072 6561 736f r security reaso │ │ │ │ │ -0003c760: 6e73 2061 6e64 0a61 7265 2065 6e66 6f72 ns and.are enfor │ │ │ │ │ -0003c770: 6365 6420 6279 2074 6865 2047 5255 4220 ced by the GRUB │ │ │ │ │ -0003c780: 4c6f 636b 646f 776e 206d 6563 6861 6e69 Lockdown mechani │ │ │ │ │ -0003c790: 736d 2028 2a6e 6f74 6520 4c6f 636b 646f sm (*note Lockdo │ │ │ │ │ -0003c7a0: 776e 3a3a 292e 0a0a 1f0a 4669 6c65 3a20 wn::).....File: │ │ │ │ │ -0003c7b0: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ -0003c7c0: 3a20 5365 6375 7265 2042 6f6f 7420 4164 : Secure Boot Ad │ │ │ │ │ -0003c7d0: 7661 6e63 6564 2054 6172 6765 7469 6e67 vanced Targeting │ │ │ │ │ -0003c7e0: 2c20 204e 6578 743a 204d 6561 7375 7265 , Next: Measure │ │ │ │ │ -0003c7f0: 6420 426f 6f74 2c20 2050 7265 763a 2055 d Boot, Prev: U │ │ │ │ │ -0003c800: 4546 4920 7365 6375 7265 2062 6f6f 7420 EFI secure boot │ │ │ │ │ -0003c810: 616e 6420 7368 696d 2c20 2055 703a 2053 and shim, Up: S │ │ │ │ │ -0003c820: 6563 7572 6974 790a 0a31 382e 3420 456d ecurity..18.4 Em │ │ │ │ │ -0003c830: 6265 6464 6564 2069 6e66 6f72 6d61 7469 bedded informati │ │ │ │ │ -0003c840: 6f6e 2066 6f72 2067 656e 6572 6174 696f on for generatio │ │ │ │ │ -0003c850: 6e20 6e75 6d62 6572 2062 6173 6564 2072 n number based r │ │ │ │ │ -0003c860: 6576 6f63 6174 696f 6e0a 3d3d 3d3d 3d3d evocation.====== │ │ │ │ │ +0003c400: 3d3d 3d3d 0a0a 5468 6520 4752 5542 2c20 ====..The GRUB, │ │ │ │ │ +0003c410: 6578 6365 7074 2074 6865 2027 6368 6169 except the 'chai │ │ │ │ │ +0003c420: 6e6c 6f61 6465 7227 2063 6f6d 6d61 6e64 nloader' command │ │ │ │ │ +0003c430: 2c20 776f 726b 7320 7769 7468 2074 6865 , works with the │ │ │ │ │ +0003c440: 2055 4546 4920 7365 6375 7265 0a62 6f6f UEFI secure.boo │ │ │ │ │ +0003c450: 7420 616e 6420 7468 6520 7368 696d 2e20 t and the shim. │ │ │ │ │ +0003c460: 2054 6869 7320 6675 6e63 7469 6f6e 616c This functional │ │ │ │ │ +0003c470: 6974 7920 6973 2070 726f 7669 6465 6420 ity is provided │ │ │ │ │ +0003c480: 6279 2074 6865 2073 6869 6d5f 6c6f 636b by the shim_lock │ │ │ │ │ +0003c490: 0a76 6572 6966 6965 722e 2020 4974 2069 .verifier. It i │ │ │ │ │ +0003c4a0: 7320 6275 696c 7420 696e 746f 2074 6865 s built into the │ │ │ │ │ +0003c4b0: 2027 636f 7265 2e69 6d67 2720 616e 6420 'core.img' and │ │ │ │ │ +0003c4c0: 6973 2072 6567 6973 7465 7265 6420 6966 is registered if │ │ │ │ │ +0003c4d0: 2074 6865 2055 4546 490a 7365 6375 7265 the UEFI.secure │ │ │ │ │ +0003c4e0: 2062 6f6f 7420 6973 2065 6e61 626c 6564 boot is enabled │ │ │ │ │ +0003c4f0: 2e20 2054 6865 2027 7368 696d 5f6c 6f63 . The 'shim_loc │ │ │ │ │ +0003c500: 6b27 2076 6172 6961 626c 6520 6973 2073 k' variable is s │ │ │ │ │ +0003c510: 6574 2074 6f20 2779 2720 7768 656e 0a73 et to 'y' when.s │ │ │ │ │ +0003c520: 6869 6d5f 6c6f 636b 2076 6572 6966 6965 him_lock verifie │ │ │ │ │ +0003c530: 7220 6973 2072 6567 6973 7465 7265 642e r is registered. │ │ │ │ │ +0003c540: 2020 4966 2069 7420 6973 2064 6573 6972 If it is desir │ │ │ │ │ +0003c550: 6564 2074 6f20 7573 6520 5545 4649 2073 ed to use UEFI s │ │ │ │ │ +0003c560: 6563 7572 650a 626f 6f74 2077 6974 686f ecure.boot witho │ │ │ │ │ +0003c570: 7574 2073 6869 6d2c 206f 6e65 2063 616e ut shim, one can │ │ │ │ │ +0003c580: 2064 6973 6162 6c65 2073 6869 6d5f 6c6f disable shim_lo │ │ │ │ │ +0003c590: 636b 2062 7920 6469 7361 626c 696e 6720 ck by disabling │ │ │ │ │ +0003c5a0: 7368 696d 0a76 6572 6966 6963 6174 696f shim.verificatio │ │ │ │ │ +0003c5b0: 6e20 7769 7468 204d 6f6b 5362 5374 6174 n with MokSbStat │ │ │ │ │ +0003c5c0: 6520 5545 4649 2076 6172 6961 626c 6520 e UEFI variable │ │ │ │ │ +0003c5d0: 6f72 2062 7920 6275 696c 6469 6e67 2067 or by building g │ │ │ │ │ +0003c5e0: 7275 6220 696d 6167 650a 7769 7468 2027 rub image.with ' │ │ │ │ │ +0003c5f0: 2d2d 6469 7361 626c 652d 7368 696d 2d6c --disable-shim-l │ │ │ │ │ +0003c600: 6f63 6b27 206f 7074 696f 6e2e 0a0a 2020 ock' option... │ │ │ │ │ +0003c610: 2041 6c6c 2047 5255 4220 6d6f 6475 6c65 All GRUB module │ │ │ │ │ +0003c620: 7320 6e6f 7420 7374 6f72 6564 2069 6e20 s not stored in │ │ │ │ │ +0003c630: 7468 6520 2763 6f72 652e 696d 6727 2c20 the 'core.img', │ │ │ │ │ +0003c640: 4f53 206b 6572 6e65 6c73 2c20 4143 5049 OS kernels, ACPI │ │ │ │ │ +0003c650: 0a74 6162 6c65 732c 2044 6576 6963 6520 .tables, Device │ │ │ │ │ +0003c660: 5472 6565 732c 2065 7463 2e20 2068 6176 Trees, etc. hav │ │ │ │ │ +0003c670: 6520 746f 2062 6520 7369 676e 6564 2c20 e to be signed, │ │ │ │ │ +0003c680: 652e 672c 2075 7369 6e67 2050 4750 2e0a e.g, using PGP.. │ │ │ │ │ +0003c690: 4164 6469 7469 6f6e 616c 6c79 2c20 7468 Additionally, th │ │ │ │ │ +0003c6a0: 6520 636f 6d6d 616e 6473 2074 6861 7420 e commands that │ │ │ │ │ +0003c6b0: 6361 6e20 6265 2075 7365 6420 746f 2073 can be used to s │ │ │ │ │ +0003c6c0: 7562 7665 7274 2074 6865 2055 4546 4920 ubvert the UEFI │ │ │ │ │ +0003c6d0: 7365 6375 7265 0a62 6f6f 7420 6d65 6368 secure.boot mech │ │ │ │ │ +0003c6e0: 616e 6973 6d2c 2073 7563 6820 6173 2027 anism, such as ' │ │ │ │ │ +0003c6f0: 696f 7277 2720 616e 6420 276d 656d 7277 iorw' and 'memrw │ │ │ │ │ +0003c700: 2720 7769 6c6c 206e 6f74 2062 6520 6176 ' will not be av │ │ │ │ │ +0003c710: 6169 6c61 626c 6520 7768 656e 0a74 6865 ailable when.the │ │ │ │ │ +0003c720: 2055 4546 4920 7365 6375 7265 2062 6f6f UEFI secure boo │ │ │ │ │ +0003c730: 7420 6973 2065 6e61 626c 6564 2e20 2054 t is enabled. T │ │ │ │ │ +0003c740: 6869 7320 6973 2064 6f6e 6520 666f 7220 his is done for │ │ │ │ │ +0003c750: 7365 6375 7269 7479 2072 6561 736f 6e73 security reasons │ │ │ │ │ +0003c760: 2061 6e64 0a61 7265 2065 6e66 6f72 6365 and.are enforce │ │ │ │ │ +0003c770: 6420 6279 2074 6865 2047 5255 4220 4c6f d by the GRUB Lo │ │ │ │ │ +0003c780: 636b 646f 776e 206d 6563 6861 6e69 736d ckdown mechanism │ │ │ │ │ +0003c790: 2028 2a6e 6f74 6520 4c6f 636b 646f 776e (*note Lockdown │ │ │ │ │ +0003c7a0: 3a3a 292e 0a0a 1f0a 4669 6c65 3a20 6772 ::).....File: gr │ │ │ │ │ +0003c7b0: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ +0003c7c0: 5365 6375 7265 2042 6f6f 7420 4164 7661 Secure Boot Adva │ │ │ │ │ +0003c7d0: 6e63 6564 2054 6172 6765 7469 6e67 2c20 nced Targeting, │ │ │ │ │ +0003c7e0: 204e 6578 743a 204d 6561 7375 7265 6420 Next: Measured │ │ │ │ │ +0003c7f0: 426f 6f74 2c20 2050 7265 763a 2055 4546 Boot, Prev: UEF │ │ │ │ │ +0003c800: 4920 7365 6375 7265 2062 6f6f 7420 616e I secure boot an │ │ │ │ │ +0003c810: 6420 7368 696d 2c20 2055 703a 2053 6563 d shim, Up: Sec │ │ │ │ │ +0003c820: 7572 6974 790a 0a31 382e 3420 456d 6265 urity..18.4 Embe │ │ │ │ │ +0003c830: 6464 6564 2069 6e66 6f72 6d61 7469 6f6e dded information │ │ │ │ │ +0003c840: 2066 6f72 2067 656e 6572 6174 696f 6e20 for generation │ │ │ │ │ +0003c850: 6e75 6d62 6572 2062 6173 6564 2072 6576 number based rev │ │ │ │ │ +0003c860: 6f63 6174 696f 6e0a 3d3d 3d3d 3d3d 3d3d ocation.======== │ │ │ │ │ 0003c870: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 0003c880: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 0003c890: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0003c8a0: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 5468 6520 ==========..The │ │ │ │ │ -0003c8b0: 5365 6375 7265 2042 6f6f 7420 4164 7661 Secure Boot Adva │ │ │ │ │ -0003c8c0: 6e63 6564 2054 6172 6765 7469 6e67 2028 nced Targeting ( │ │ │ │ │ -0003c8d0: 5342 4154 2920 6973 2061 206d 6563 6861 SBAT) is a mecha │ │ │ │ │ -0003c8e0: 6e69 736d 2074 6f20 616c 6c6f 7720 7468 nism to allow th │ │ │ │ │ -0003c8f0: 650a 7265 766f 6361 7469 6f6e 206f 6620 e.revocation of │ │ │ │ │ -0003c900: 636f 6d70 6f6e 656e 7473 2069 6e20 7468 components in th │ │ │ │ │ -0003c910: 6520 626f 6f74 2070 6174 6820 6279 2075 e boot path by u │ │ │ │ │ -0003c920: 7369 6e67 2067 656e 6572 6174 696f 6e20 sing generation │ │ │ │ │ -0003c930: 6e75 6d62 6572 730a 656d 6265 6464 6564 numbers.embedded │ │ │ │ │ -0003c940: 2069 6e74 6f20 7468 6520 4546 4920 6269 into the EFI bi │ │ │ │ │ -0003c950: 6e61 7269 6573 2e20 2054 6865 2053 4241 naries. The SBA │ │ │ │ │ -0003c960: 5420 6d65 7461 6461 7461 2069 7320 6c6f T metadata is lo │ │ │ │ │ -0003c970: 6361 7465 6420 696e 2061 6e0a 2e73 6261 cated in an..sba │ │ │ │ │ -0003c980: 7420 6461 7461 2073 6563 7469 6f6e 2074 t data section t │ │ │ │ │ -0003c990: 6861 7420 6861 7320 7365 7420 6f66 2055 hat has set of U │ │ │ │ │ -0003c9a0: 5446 2d38 2073 7472 696e 6773 2061 7320 TF-8 strings as │ │ │ │ │ -0003c9b0: 636f 6d6d 612d 7365 7061 7261 7465 640a comma-separated. │ │ │ │ │ -0003c9c0: 7661 6c75 6573 2028 4353 5629 2e20 5365 values (CSV). Se │ │ │ │ │ -0003c9d0: 6520 3c68 7474 7073 3a2f 2f67 6974 6875 e for.more de │ │ │ │ │ -0003ca10: 7461 696c 732e 0a0a 2020 2054 6f20 6164 tails... To ad │ │ │ │ │ -0003ca20: 6420 6120 6461 7461 2073 6563 7469 6f6e d a data section │ │ │ │ │ -0003ca30: 2063 6f6e 7461 696e 696e 6720 7468 6520 containing the │ │ │ │ │ -0003ca40: 5342 4154 2069 6e66 6f72 6d61 7469 6f6e SBAT information │ │ │ │ │ -0003ca50: 2069 6e74 6f20 7468 650a 6269 6e61 7279 into the.binary │ │ │ │ │ -0003ca60: 2c20 7468 6520 272d 2d73 6261 7427 206f , the '--sbat' o │ │ │ │ │ -0003ca70: 7074 696f 6e20 6f66 2027 6772 7562 2d6d ption of 'grub-m │ │ │ │ │ -0003ca80: 6b69 6d61 6765 2720 636f 6d6d 616e 6420 kimage' command │ │ │ │ │ -0003ca90: 7368 6f75 6c64 2062 6520 7573 6564 2e0a should be used.. │ │ │ │ │ -0003caa0: 5468 6520 636f 6e74 656e 7420 6f66 2061 The content of a │ │ │ │ │ -0003cab0: 2043 5356 2066 696c 652c 2065 6e63 6f64 CSV file, encod │ │ │ │ │ -0003cac0: 6564 2077 6974 6820 5554 462d 382c 2069 ed with UTF-8, i │ │ │ │ │ -0003cad0: 7320 636f 7069 6564 2061 7320 6973 2074 s copied as is t │ │ │ │ │ -0003cae0: 6f20 7468 650a 2e73 6261 7420 6461 7461 o the..sbat data │ │ │ │ │ -0003caf0: 2073 6563 7469 6f6e 2069 6e74 6f20 7468 section into th │ │ │ │ │ -0003cb00: 6520 6765 6e65 7261 7465 6420 4546 4920 e generated EFI │ │ │ │ │ -0003cb10: 6269 6e61 7279 2e20 2054 6865 2043 5356 binary. The CSV │ │ │ │ │ -0003cb20: 2066 696c 6520 6361 6e20 6265 0a73 746f file can be.sto │ │ │ │ │ -0003cb30: 7265 6420 616e 7977 6865 7265 206f 6e20 red anywhere on │ │ │ │ │ -0003cb40: 7468 6520 6669 6c65 2073 7973 7465 6d2e the file system. │ │ │ │ │ -0003cb50: 0a0a 2020 2020 2067 7275 622d 6d6b 696d .. grub-mkim │ │ │ │ │ -0003cb60: 6167 6520 2d4f 2078 3836 5f36 342d 6566 age -O x86_64-ef │ │ │ │ │ -0003cb70: 6920 2d6f 2067 7275 6278 3634 2e65 6669 i -o grubx64.efi │ │ │ │ │ -0003cb80: 202d 7020 2728 7466 7470 292f 6772 7562 -p '(tftp)/grub │ │ │ │ │ -0003cb90: 2720 2d2d 7362 6174 2073 6261 742e 6373 ' --sbat sbat.cs │ │ │ │ │ -0003cba0: 7620 6566 696e 6574 2074 6674 700a 0a1f v efinet tftp... │ │ │ │ │ -0003cbb0: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ -0003cbc0: 2c20 204e 6f64 653a 204d 6561 7375 7265 , Node: Measure │ │ │ │ │ -0003cbd0: 6420 426f 6f74 2c20 204e 6578 743a 204c d Boot, Next: L │ │ │ │ │ -0003cbe0: 6f63 6b64 6f77 6e2c 2020 5072 6576 3a20 ockdown, Prev: │ │ │ │ │ -0003cbf0: 5365 6375 7265 2042 6f6f 7420 4164 7661 Secure Boot Adva │ │ │ │ │ -0003cc00: 6e63 6564 2054 6172 6765 7469 6e67 2c20 nced Targeting, │ │ │ │ │ -0003cc10: 2055 703a 2053 6563 7572 6974 790a 0a31 Up: Security..1 │ │ │ │ │ -0003cc20: 382e 3520 4d65 6173 7572 696e 6720 626f 8.5 Measuring bo │ │ │ │ │ -0003cc30: 6f74 2063 6f6d 706f 6e65 6e74 730a 3d3d ot components.== │ │ │ │ │ +0003c8a0: 3d3d 3d3d 3d3d 3d3d 0a0a 5468 6520 5365 ========..The Se │ │ │ │ │ +0003c8b0: 6375 7265 2042 6f6f 7420 4164 7661 6e63 cure Boot Advanc │ │ │ │ │ +0003c8c0: 6564 2054 6172 6765 7469 6e67 2028 5342 ed Targeting (SB │ │ │ │ │ +0003c8d0: 4154 2920 6973 2061 206d 6563 6861 6e69 AT) is a mechani │ │ │ │ │ +0003c8e0: 736d 2074 6f20 616c 6c6f 7720 7468 650a sm to allow the. │ │ │ │ │ +0003c8f0: 7265 766f 6361 7469 6f6e 206f 6620 636f revocation of co │ │ │ │ │ +0003c900: 6d70 6f6e 656e 7473 2069 6e20 7468 6520 mponents in the │ │ │ │ │ +0003c910: 626f 6f74 2070 6174 6820 6279 2075 7369 boot path by usi │ │ │ │ │ +0003c920: 6e67 2067 656e 6572 6174 696f 6e20 6e75 ng generation nu │ │ │ │ │ +0003c930: 6d62 6572 730a 656d 6265 6464 6564 2069 mbers.embedded i │ │ │ │ │ +0003c940: 6e74 6f20 7468 6520 4546 4920 6269 6e61 nto the EFI bina │ │ │ │ │ +0003c950: 7269 6573 2e20 2054 6865 2053 4241 5420 ries. The SBAT │ │ │ │ │ +0003c960: 6d65 7461 6461 7461 2069 7320 6c6f 6361 metadata is loca │ │ │ │ │ +0003c970: 7465 6420 696e 2061 6e0a 2e73 6261 7420 ted in an..sbat │ │ │ │ │ +0003c980: 6461 7461 2073 6563 7469 6f6e 2074 6861 data section tha │ │ │ │ │ +0003c990: 7420 6861 7320 7365 7420 6f66 2055 5446 t has set of UTF │ │ │ │ │ +0003c9a0: 2d38 2073 7472 696e 6773 2061 7320 636f -8 strings as co │ │ │ │ │ +0003c9b0: 6d6d 612d 7365 7061 7261 7465 640a 7661 mma-separated.va │ │ │ │ │ +0003c9c0: 6c75 6573 2028 4353 5629 2e20 5365 6520 lues (CSV). See │ │ │ │ │ +0003c9d0: 3c68 7474 7073 3a2f 2f67 6974 6875 622e for.more deta │ │ │ │ │ +0003ca10: 696c 732e 0a0a 2020 2054 6f20 6164 6420 ils... To add │ │ │ │ │ +0003ca20: 6120 6461 7461 2073 6563 7469 6f6e 2063 a data section c │ │ │ │ │ +0003ca30: 6f6e 7461 696e 696e 6720 7468 6520 5342 ontaining the SB │ │ │ │ │ +0003ca40: 4154 2069 6e66 6f72 6d61 7469 6f6e 2069 AT information i │ │ │ │ │ +0003ca50: 6e74 6f20 7468 650a 6269 6e61 7279 2c20 nto the.binary, │ │ │ │ │ +0003ca60: 7468 6520 272d 2d73 6261 7427 206f 7074 the '--sbat' opt │ │ │ │ │ +0003ca70: 696f 6e20 6f66 2027 6772 7562 2d6d 6b69 ion of 'grub-mki │ │ │ │ │ +0003ca80: 6d61 6765 2720 636f 6d6d 616e 6420 7368 mage' command sh │ │ │ │ │ +0003ca90: 6f75 6c64 2062 6520 7573 6564 2e0a 5468 ould be used..Th │ │ │ │ │ +0003caa0: 6520 636f 6e74 656e 7420 6f66 2061 2043 e content of a C │ │ │ │ │ +0003cab0: 5356 2066 696c 652c 2065 6e63 6f64 6564 SV file, encoded │ │ │ │ │ +0003cac0: 2077 6974 6820 5554 462d 382c 2069 7320 with UTF-8, is │ │ │ │ │ +0003cad0: 636f 7069 6564 2061 7320 6973 2074 6f20 copied as is to │ │ │ │ │ +0003cae0: 7468 650a 2e73 6261 7420 6461 7461 2073 the..sbat data s │ │ │ │ │ +0003caf0: 6563 7469 6f6e 2069 6e74 6f20 7468 6520 ection into the │ │ │ │ │ +0003cb00: 6765 6e65 7261 7465 6420 4546 4920 6269 generated EFI bi │ │ │ │ │ +0003cb10: 6e61 7279 2e20 2054 6865 2043 5356 2066 nary. The CSV f │ │ │ │ │ +0003cb20: 696c 6520 6361 6e20 6265 0a73 746f 7265 ile can be.store │ │ │ │ │ +0003cb30: 6420 616e 7977 6865 7265 206f 6e20 7468 d anywhere on th │ │ │ │ │ +0003cb40: 6520 6669 6c65 2073 7973 7465 6d2e 0a0a e file system... │ │ │ │ │ +0003cb50: 2020 2020 2067 7275 622d 6d6b 696d 6167 grub-mkimag │ │ │ │ │ +0003cb60: 6520 2d4f 2078 3836 5f36 342d 6566 6920 e -O x86_64-efi │ │ │ │ │ +0003cb70: 2d6f 2067 7275 6278 3634 2e65 6669 202d -o grubx64.efi - │ │ │ │ │ +0003cb80: 7020 2728 7466 7470 292f 6772 7562 2720 p '(tftp)/grub' │ │ │ │ │ +0003cb90: 2d2d 7362 6174 2073 6261 742e 6373 7620 --sbat sbat.csv │ │ │ │ │ +0003cba0: 6566 696e 6574 2074 6674 700a 0a1f 0a46 efinet tftp....F │ │ │ │ │ +0003cbb0: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ +0003cbc0: 204e 6f64 653a 204d 6561 7375 7265 6420 Node: Measured │ │ │ │ │ +0003cbd0: 426f 6f74 2c20 204e 6578 743a 204c 6f63 Boot, Next: Loc │ │ │ │ │ +0003cbe0: 6b64 6f77 6e2c 2020 5072 6576 3a20 5365 kdown, Prev: Se │ │ │ │ │ +0003cbf0: 6375 7265 2042 6f6f 7420 4164 7661 6e63 cure Boot Advanc │ │ │ │ │ +0003cc00: 6564 2054 6172 6765 7469 6e67 2c20 2055 ed Targeting, U │ │ │ │ │ +0003cc10: 703a 2053 6563 7572 6974 790a 0a31 382e p: Security..18. │ │ │ │ │ +0003cc20: 3520 4d65 6173 7572 696e 6720 626f 6f74 5 Measuring boot │ │ │ │ │ +0003cc30: 2063 6f6d 706f 6e65 6e74 730a 3d3d 3d3d components.==== │ │ │ │ │ 0003cc40: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0003cc50: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 4966 ============..If │ │ │ │ │ -0003cc60: 2074 6865 2074 706d 206d 6f64 756c 6520 the tpm module │ │ │ │ │ -0003cc70: 6973 206c 6f61 6465 6420 616e 6420 7468 is loaded and th │ │ │ │ │ -0003cc80: 6520 706c 6174 666f 726d 2068 6173 2061 e platform has a │ │ │ │ │ -0003cc90: 2054 7275 7374 6564 2050 6c61 7466 6f72 Trusted Platfor │ │ │ │ │ -0003cca0: 6d0a 4d6f 6475 6c65 2069 6e73 7461 6c6c m.Module install │ │ │ │ │ -0003ccb0: 6564 2c20 4752 5542 2077 696c 6c20 6c6f ed, GRUB will lo │ │ │ │ │ -0003ccc0: 6720 6561 6368 2063 6f6d 6d61 6e64 2065 g each command e │ │ │ │ │ -0003ccd0: 7865 6375 7465 6420 616e 6420 6561 6368 xecuted and each │ │ │ │ │ -0003cce0: 2066 696c 650a 6c6f 6164 6564 2069 6e74 file.loaded int │ │ │ │ │ -0003ccf0: 6f20 7468 6520 5450 4d20 6576 656e 7420 o the TPM event │ │ │ │ │ -0003cd00: 6c6f 6720 616e 6420 6578 7465 6e64 2074 log and extend t │ │ │ │ │ -0003cd10: 6865 2050 4352 2076 616c 7565 7320 696e he PCR values in │ │ │ │ │ -0003cd20: 2074 6865 2054 504d 0a63 6f72 7265 7370 the TPM.corresp │ │ │ │ │ -0003cd30: 6f6e 6469 6e67 6c79 2e20 2041 6c6c 2065 ondingly. All e │ │ │ │ │ -0003cd40: 7665 6e74 7320 7769 6c6c 2062 6520 6c6f vents will be lo │ │ │ │ │ -0003cd50: 6767 6564 2069 6e74 6f20 7468 6520 5043 gged into the PC │ │ │ │ │ -0003cd60: 5220 6465 7363 7269 6265 6420 6265 6c6f R described belo │ │ │ │ │ -0003cd70: 770a 7769 7468 2061 2074 7970 6520 6f66 w.with a type of │ │ │ │ │ -0003cd80: 2045 565f 4950 4c20 616e 6420 616e 2065 EV_IPL and an e │ │ │ │ │ -0003cd90: 7665 6e74 2064 6573 6372 6970 7469 6f6e vent description │ │ │ │ │ -0003cda0: 2061 7320 6465 7363 7269 6265 6420 6265 as described be │ │ │ │ │ -0003cdb0: 6c6f 772e 0a0a 4576 656e 7420 7479 7065 low...Event type │ │ │ │ │ -0003cdc0: 2020 2020 2020 2020 2020 2020 2050 4352 PCR │ │ │ │ │ -0003cdd0: 2020 2020 2044 6573 6372 6970 7469 6f6e Description │ │ │ │ │ -0003cde0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ │ +0003cc50: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 4966 2074 ==========..If t │ │ │ │ │ +0003cc60: 6865 2074 706d 206d 6f64 756c 6520 6973 he tpm module is │ │ │ │ │ +0003cc70: 206c 6f61 6465 6420 616e 6420 7468 6520 loaded and the │ │ │ │ │ +0003cc80: 706c 6174 666f 726d 2068 6173 2061 2054 platform has a T │ │ │ │ │ +0003cc90: 7275 7374 6564 2050 6c61 7466 6f72 6d0a rusted Platform. │ │ │ │ │ +0003cca0: 4d6f 6475 6c65 2069 6e73 7461 6c6c 6564 Module installed │ │ │ │ │ +0003ccb0: 2c20 4752 5542 2077 696c 6c20 6c6f 6720 , GRUB will log │ │ │ │ │ +0003ccc0: 6561 6368 2063 6f6d 6d61 6e64 2065 7865 each command exe │ │ │ │ │ +0003ccd0: 6375 7465 6420 616e 6420 6561 6368 2066 cuted and each f │ │ │ │ │ +0003cce0: 696c 650a 6c6f 6164 6564 2069 6e74 6f20 ile.loaded into │ │ │ │ │ +0003ccf0: 7468 6520 5450 4d20 6576 656e 7420 6c6f the TPM event lo │ │ │ │ │ +0003cd00: 6720 616e 6420 6578 7465 6e64 2074 6865 g and extend the │ │ │ │ │ +0003cd10: 2050 4352 2076 616c 7565 7320 696e 2074 PCR values in t │ │ │ │ │ +0003cd20: 6865 2054 504d 0a63 6f72 7265 7370 6f6e he TPM.correspon │ │ │ │ │ +0003cd30: 6469 6e67 6c79 2e20 2041 6c6c 2065 7665 dingly. All eve │ │ │ │ │ +0003cd40: 6e74 7320 7769 6c6c 2062 6520 6c6f 6767 nts will be logg │ │ │ │ │ +0003cd50: 6564 2069 6e74 6f20 7468 6520 5043 5220 ed into the PCR │ │ │ │ │ +0003cd60: 6465 7363 7269 6265 6420 6265 6c6f 770a described below. │ │ │ │ │ +0003cd70: 7769 7468 2061 2074 7970 6520 6f66 2045 with a type of E │ │ │ │ │ +0003cd80: 565f 4950 4c20 616e 6420 616e 2065 7665 V_IPL and an eve │ │ │ │ │ +0003cd90: 6e74 2064 6573 6372 6970 7469 6f6e 2061 nt description a │ │ │ │ │ +0003cda0: 7320 6465 7363 7269 6265 6420 6265 6c6f s described belo │ │ │ │ │ +0003cdb0: 772e 0a0a 4576 656e 7420 7479 7065 2020 w...Event type │ │ │ │ │ +0003cdc0: 2020 2020 2020 2020 2020 2050 4352 2020 PCR │ │ │ │ │ +0003cdd0: 2020 2044 6573 6372 6970 7469 6f6e 0a2d Description.- │ │ │ │ │ +0003cde0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 0003cdf0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 0003ce00: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 0003ce10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0003ce20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a43 6f6d ------------.Com │ │ │ │ │ -0003ce30: 6d61 6e64 2020 2020 2020 2020 2020 2020 mand │ │ │ │ │ -0003ce40: 2020 2020 3820 2020 2020 2020 416c 6c20 8 All │ │ │ │ │ -0003ce50: 6578 6563 7574 6564 2063 6f6d 6d61 6e64 executed command │ │ │ │ │ -0003ce60: 7320 2869 6e63 6c75 6469 6e67 2074 686f s (including tho │ │ │ │ │ -0003ce70: 7365 0a20 2020 2020 2020 2020 2020 2020 se. │ │ │ │ │ +0003ce20: 2d2d 2d2d 2d2d 2d2d 2d2d 0a43 6f6d 6d61 ----------.Comma │ │ │ │ │ +0003ce30: 6e64 2020 2020 2020 2020 2020 2020 2020 nd │ │ │ │ │ +0003ce40: 2020 3820 2020 2020 2020 416c 6c20 6578 8 All ex │ │ │ │ │ +0003ce50: 6563 7574 6564 2063 6f6d 6d61 6e64 7320 ecuted commands │ │ │ │ │ +0003ce60: 2869 6e63 6c75 6469 6e67 2074 686f 7365 (including those │ │ │ │ │ +0003ce70: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ 0003ce80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003ce90: 2020 6672 6f6d 2063 6f6e 6669 6775 7261 from configura │ │ │ │ │ -0003cea0: 7469 6f6e 2066 696c 6573 2920 7769 6c6c tion files) will │ │ │ │ │ -0003ceb0: 2062 6520 6c6f 6767 6564 0a20 2020 2020 be logged. │ │ │ │ │ +0003ce90: 6672 6f6d 2063 6f6e 6669 6775 7261 7469 from configurati │ │ │ │ │ +0003cea0: 6f6e 2066 696c 6573 2920 7769 6c6c 2062 on files) will b │ │ │ │ │ +0003ceb0: 6520 6c6f 6767 6564 0a20 2020 2020 2020 e logged. │ │ │ │ │ 0003cec0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003ced0: 2020 2020 2020 2020 2020 616e 6420 6d65 and me │ │ │ │ │ -0003cee0: 6173 7572 6564 2061 7320 656e 7465 7265 asured as entere │ │ │ │ │ -0003cef0: 6420 7769 7468 2061 2070 7265 6669 7820 d with a prefix │ │ │ │ │ -0003cf00: 6f66 0a20 2020 2020 2020 2020 2020 2020 of. │ │ │ │ │ +0003ced0: 2020 2020 2020 2020 616e 6420 6d65 6173 and meas │ │ │ │ │ +0003cee0: 7572 6564 2061 7320 656e 7465 7265 6420 ured as entered │ │ │ │ │ +0003cef0: 7769 7468 2061 2070 7265 6669 7820 6f66 with a prefix of │ │ │ │ │ +0003cf00: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ 0003cf10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003cf20: 2020 2267 7275 625f 636d 643a 2022 0a4b "grub_cmd: ".K │ │ │ │ │ -0003cf30: 6572 6e65 6c20 636f 6d6d 616e 6420 6c69 ernel command li │ │ │ │ │ -0003cf40: 6e65 2020 2020 3820 2020 2020 2020 416e ne 8 An │ │ │ │ │ -0003cf50: 7920 636f 6d6d 616e 6420 6c69 6e65 2070 y command line p │ │ │ │ │ -0003cf60: 6173 7365 6420 746f 2061 206b 6572 6e65 assed to a kerne │ │ │ │ │ -0003cf70: 6c20 7769 6c6c 0a20 2020 2020 2020 2020 l will. │ │ │ │ │ +0003cf20: 2267 7275 625f 636d 643a 2022 0a4b 6572 "grub_cmd: ".Ker │ │ │ │ │ +0003cf30: 6e65 6c20 636f 6d6d 616e 6420 6c69 6e65 nel command line │ │ │ │ │ +0003cf40: 2020 2020 3820 2020 2020 2020 416e 7920 8 Any │ │ │ │ │ +0003cf50: 636f 6d6d 616e 6420 6c69 6e65 2070 6173 command line pas │ │ │ │ │ +0003cf60: 7365 6420 746f 2061 206b 6572 6e65 6c20 sed to a kernel │ │ │ │ │ +0003cf70: 7769 6c6c 0a20 2020 2020 2020 2020 2020 will. │ │ │ │ │ 0003cf80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003cf90: 2020 2020 2020 6265 206c 6f67 6765 6420 be logged │ │ │ │ │ -0003cfa0: 616e 6420 6d65 6173 7572 6564 2061 7320 and measured as │ │ │ │ │ -0003cfb0: 656e 7465 7265 6420 7769 7468 2061 0a20 entered with a. │ │ │ │ │ +0003cf90: 2020 2020 6265 206c 6f67 6765 6420 616e be logged an │ │ │ │ │ +0003cfa0: 6420 6d65 6173 7572 6564 2061 7320 656e d measured as en │ │ │ │ │ +0003cfb0: 7465 7265 6420 7769 7468 2061 0a20 2020 tered with a. │ │ │ │ │ 0003cfc0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003cfd0: 2020 2020 2020 2020 2020 2020 2020 7072 pr │ │ │ │ │ -0003cfe0: 6566 6978 206f 6620 226b 6572 6e65 6c5f efix of "kernel_ │ │ │ │ │ -0003cff0: 636d 646c 696e 653a 2022 0a4d 6f64 756c cmdline: ".Modul │ │ │ │ │ -0003d000: 6520 636f 6d6d 616e 6420 6c69 6e65 2020 e command line │ │ │ │ │ -0003d010: 2020 3820 2020 2020 2020 416e 7920 636f 8 Any co │ │ │ │ │ -0003d020: 6d6d 616e 6420 6c69 6e65 2070 6173 7365 mmand line passe │ │ │ │ │ -0003d030: 6420 746f 2061 206b 6572 6e65 6c0a 2020 d to a kernel. │ │ │ │ │ +0003cfd0: 2020 2020 2020 2020 2020 2020 7072 6566 pref │ │ │ │ │ +0003cfe0: 6978 206f 6620 226b 6572 6e65 6c5f 636d ix of "kernel_cm │ │ │ │ │ +0003cff0: 646c 696e 653a 2022 0a4d 6f64 756c 6520 dline: ".Module │ │ │ │ │ +0003d000: 636f 6d6d 616e 6420 6c69 6e65 2020 2020 command line │ │ │ │ │ +0003d010: 3820 2020 2020 2020 416e 7920 636f 6d6d 8 Any comm │ │ │ │ │ +0003d020: 616e 6420 6c69 6e65 2070 6173 7365 6420 and line passed │ │ │ │ │ +0003d030: 746f 2061 206b 6572 6e65 6c0a 2020 2020 to a kernel. │ │ │ │ │ 0003d040: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003d050: 2020 2020 2020 2020 2020 2020 206d 6f64 mod │ │ │ │ │ -0003d060: 756c 6520 7769 6c6c 2062 6520 6c6f 6767 ule will be logg │ │ │ │ │ -0003d070: 6564 2061 6e64 206d 6561 7375 7265 6420 ed and measured │ │ │ │ │ -0003d080: 6173 0a20 2020 2020 2020 2020 2020 2020 as. │ │ │ │ │ +0003d050: 2020 2020 2020 2020 2020 206d 6f64 756c modul │ │ │ │ │ +0003d060: 6520 7769 6c6c 2062 6520 6c6f 6767 6564 e will be logged │ │ │ │ │ +0003d070: 2061 6e64 206d 6561 7375 7265 6420 6173 and measured as │ │ │ │ │ +0003d080: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ 0003d090: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003d0a0: 2020 656e 7465 7265 6420 7769 7468 2061 entered with a │ │ │ │ │ -0003d0b0: 2070 7265 6669 7820 6f66 2022 6d6f 6475 prefix of "modu │ │ │ │ │ -0003d0c0: 6c65 5f63 6d64 6c69 6e65 3a0a 2020 2020 le_cmdline:. │ │ │ │ │ +0003d0a0: 656e 7465 7265 6420 7769 7468 2061 2070 entered with a p │ │ │ │ │ +0003d0b0: 7265 6669 7820 6f66 2022 6d6f 6475 6c65 refix of "module │ │ │ │ │ +0003d0c0: 5f63 6d64 6c69 6e65 3a0a 2020 2020 2020 _cmdline:. │ │ │ │ │ 0003d0d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003d0e0: 2020 2020 2020 2020 2020 2022 0a46 696c ".Fil │ │ │ │ │ -0003d0f0: 6573 2020 2020 2020 2020 2020 2020 2020 es │ │ │ │ │ -0003d100: 2020 2020 3920 2020 2020 2020 416e 7920 9 Any │ │ │ │ │ -0003d110: 6669 6c65 2072 6561 6420 6279 2047 5255 file read by GRU │ │ │ │ │ -0003d120: 4220 7769 6c6c 2062 6520 6c6f 6767 6564 B will be logged │ │ │ │ │ -0003d130: 2061 6e64 0a20 2020 2020 2020 2020 2020 and. │ │ │ │ │ +0003d0e0: 2020 2020 2020 2020 2022 0a46 696c 6573 ".Files │ │ │ │ │ +0003d0f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0003d100: 2020 3920 2020 2020 2020 416e 7920 6669 9 Any fi │ │ │ │ │ +0003d110: 6c65 2072 6561 6420 6279 2047 5255 4220 le read by GRUB │ │ │ │ │ +0003d120: 7769 6c6c 2062 6520 6c6f 6767 6564 2061 will be logged a │ │ │ │ │ +0003d130: 6e64 0a20 2020 2020 2020 2020 2020 2020 nd. │ │ │ │ │ 0003d140: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003d150: 2020 2020 6d65 6173 7572 6564 2077 6974 measured wit │ │ │ │ │ -0003d160: 6820 6120 6465 7363 7269 7074 6976 6520 h a descriptive │ │ │ │ │ -0003d170: 7465 7874 0a20 2020 2020 2020 2020 2020 text. │ │ │ │ │ +0003d150: 2020 6d65 6173 7572 6564 2077 6974 6820 measured with │ │ │ │ │ +0003d160: 6120 6465 7363 7269 7074 6976 6520 7465 a descriptive te │ │ │ │ │ +0003d170: 7874 0a20 2020 2020 2020 2020 2020 2020 xt. │ │ │ │ │ 0003d180: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003d190: 2020 2020 636f 7272 6573 706f 6e64 696e correspondin │ │ │ │ │ -0003d1a0: 6720 746f 2074 6865 2066 696c 656e 616d g to the filenam │ │ │ │ │ -0003d1b0: 652e 0a0a 2020 2047 5255 4220 7769 6c6c e... GRUB will │ │ │ │ │ -0003d1c0: 206e 6f74 206d 6561 7375 7265 2069 7473 not measure its │ │ │ │ │ -0003d1d0: 206f 776e 2027 636f 7265 2e69 6d67 2720 own 'core.img' │ │ │ │ │ -0003d1e0: 2d20 6974 2069 7320 6578 7065 6374 6564 - it is expected │ │ │ │ │ -0003d1f0: 2074 6861 740a 6669 726d 7761 7265 2077 that.firmware w │ │ │ │ │ -0003d200: 696c 6c20 6361 7272 7920 7468 6973 206f ill carry this o │ │ │ │ │ -0003d210: 7574 2e20 2047 5255 4220 7769 6c6c 2061 ut. GRUB will a │ │ │ │ │ -0003d220: 6c73 6f20 6e6f 7420 7065 7266 6f72 6d20 lso not perform │ │ │ │ │ -0003d230: 616e 790a 6d65 6173 7572 656d 656e 7473 any.measurements │ │ │ │ │ -0003d240: 2075 6e74 696c 2074 6865 2074 706d 206d until the tpm m │ │ │ │ │ -0003d250: 6f64 756c 6520 6973 206c 6f61 6465 642e odule is loaded. │ │ │ │ │ -0003d260: 2020 4173 2073 7563 6820 6974 2069 7320 As such it is │ │ │ │ │ -0003d270: 7265 636f 6d6d 656e 6465 640a 7468 6174 recommended.that │ │ │ │ │ -0003d280: 2074 6865 2074 706d 206d 6f64 756c 6520 the tpm module │ │ │ │ │ -0003d290: 6265 2062 7569 6c74 2069 6e74 6f20 2763 be built into 'c │ │ │ │ │ -0003d2a0: 6f72 652e 696d 6727 2069 6e20 6f72 6465 ore.img' in orde │ │ │ │ │ -0003d2b0: 7220 746f 2061 766f 6964 2061 0a70 6f74 r to avoid a.pot │ │ │ │ │ -0003d2c0: 656e 7469 616c 2067 6170 2069 6e20 6d65 ential gap in me │ │ │ │ │ -0003d2d0: 6173 7572 656d 656e 7420 6265 7477 6565 asurement betwee │ │ │ │ │ -0003d2e0: 6e20 2763 6f72 652e 696d 6727 2062 6569 n 'core.img' bei │ │ │ │ │ -0003d2f0: 6e67 206c 6f61 6465 6420 616e 6420 7468 ng loaded and th │ │ │ │ │ -0003d300: 6520 7470 6d0a 6d6f 6475 6c65 2062 6569 e tpm.module bei │ │ │ │ │ -0003d310: 6e67 206c 6f61 6465 642e 0a0a 2020 204d ng loaded... M │ │ │ │ │ -0003d320: 6561 7375 7265 6420 626f 6f74 2069 7320 easured boot is │ │ │ │ │ -0003d330: 6375 7272 656e 746c 7920 6f6e 6c79 2073 currently only s │ │ │ │ │ -0003d340: 7570 706f 7274 6564 206f 6e20 4546 4920 upported on EFI │ │ │ │ │ -0003d350: 706c 6174 666f 726d 732e 0a0a 1f0a 4669 platforms.....Fi │ │ │ │ │ -0003d360: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ -0003d370: 4e6f 6465 3a20 4c6f 636b 646f 776e 2c20 Node: Lockdown, │ │ │ │ │ -0003d380: 2050 7265 763a 204d 6561 7375 7265 6420 Prev: Measured │ │ │ │ │ -0003d390: 426f 6f74 2c20 2055 703a 2053 6563 7572 Boot, Up: Secur │ │ │ │ │ -0003d3a0: 6974 790a 0a31 382e 3620 4c6f 636b 646f ity..18.6 Lockdo │ │ │ │ │ -0003d3b0: 776e 2077 6865 6e20 626f 6f74 696e 6720 wn when booting │ │ │ │ │ -0003d3c0: 6f6e 2061 2073 6563 7572 6520 7365 7475 on a secure setu │ │ │ │ │ -0003d3d0: 700a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d p.============== │ │ │ │ │ +0003d190: 2020 636f 7272 6573 706f 6e64 696e 6720 corresponding │ │ │ │ │ +0003d1a0: 746f 2074 6865 2066 696c 656e 616d 652e to the filename. │ │ │ │ │ +0003d1b0: 0a0a 2020 2047 5255 4220 7769 6c6c 206e .. GRUB will n │ │ │ │ │ +0003d1c0: 6f74 206d 6561 7375 7265 2069 7473 206f ot measure its o │ │ │ │ │ +0003d1d0: 776e 2027 636f 7265 2e69 6d67 2720 2d20 wn 'core.img' - │ │ │ │ │ +0003d1e0: 6974 2069 7320 6578 7065 6374 6564 2074 it is expected t │ │ │ │ │ +0003d1f0: 6861 740a 6669 726d 7761 7265 2077 696c hat.firmware wil │ │ │ │ │ +0003d200: 6c20 6361 7272 7920 7468 6973 206f 7574 l carry this out │ │ │ │ │ +0003d210: 2e20 2047 5255 4220 7769 6c6c 2061 6c73 . GRUB will als │ │ │ │ │ +0003d220: 6f20 6e6f 7420 7065 7266 6f72 6d20 616e o not perform an │ │ │ │ │ +0003d230: 790a 6d65 6173 7572 656d 656e 7473 2075 y.measurements u │ │ │ │ │ +0003d240: 6e74 696c 2074 6865 2074 706d 206d 6f64 ntil the tpm mod │ │ │ │ │ +0003d250: 756c 6520 6973 206c 6f61 6465 642e 2020 ule is loaded. │ │ │ │ │ +0003d260: 4173 2073 7563 6820 6974 2069 7320 7265 As such it is re │ │ │ │ │ +0003d270: 636f 6d6d 656e 6465 640a 7468 6174 2074 commended.that t │ │ │ │ │ +0003d280: 6865 2074 706d 206d 6f64 756c 6520 6265 he tpm module be │ │ │ │ │ +0003d290: 2062 7569 6c74 2069 6e74 6f20 2763 6f72 built into 'cor │ │ │ │ │ +0003d2a0: 652e 696d 6727 2069 6e20 6f72 6465 7220 e.img' in order │ │ │ │ │ +0003d2b0: 746f 2061 766f 6964 2061 0a70 6f74 656e to avoid a.poten │ │ │ │ │ +0003d2c0: 7469 616c 2067 6170 2069 6e20 6d65 6173 tial gap in meas │ │ │ │ │ +0003d2d0: 7572 656d 656e 7420 6265 7477 6565 6e20 urement between │ │ │ │ │ +0003d2e0: 2763 6f72 652e 696d 6727 2062 6569 6e67 'core.img' being │ │ │ │ │ +0003d2f0: 206c 6f61 6465 6420 616e 6420 7468 6520 loaded and the │ │ │ │ │ +0003d300: 7470 6d0a 6d6f 6475 6c65 2062 6569 6e67 tpm.module being │ │ │ │ │ +0003d310: 206c 6f61 6465 642e 0a0a 2020 204d 6561 loaded... Mea │ │ │ │ │ +0003d320: 7375 7265 6420 626f 6f74 2069 7320 6375 sured boot is cu │ │ │ │ │ +0003d330: 7272 656e 746c 7920 6f6e 6c79 2073 7570 rrently only sup │ │ │ │ │ +0003d340: 706f 7274 6564 206f 6e20 4546 4920 706c ported on EFI pl │ │ │ │ │ +0003d350: 6174 666f 726d 732e 0a0a 1f0a 4669 6c65 atforms.....File │ │ │ │ │ +0003d360: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ +0003d370: 6465 3a20 4c6f 636b 646f 776e 2c20 2050 de: Lockdown, P │ │ │ │ │ +0003d380: 7265 763a 204d 6561 7375 7265 6420 426f rev: Measured Bo │ │ │ │ │ +0003d390: 6f74 2c20 2055 703a 2053 6563 7572 6974 ot, Up: Securit │ │ │ │ │ +0003d3a0: 790a 0a31 382e 3620 4c6f 636b 646f 776e y..18.6 Lockdown │ │ │ │ │ +0003d3b0: 2077 6865 6e20 626f 6f74 696e 6720 6f6e when booting on │ │ │ │ │ +0003d3c0: 2061 2073 6563 7572 6520 7365 7475 700a a secure setup. │ │ │ │ │ +0003d3d0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 0003d3e0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0003d3f0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a ==============.. │ │ │ │ │ -0003d400: 5468 6520 4752 5542 2063 616e 2062 6520 The GRUB can be │ │ │ │ │ -0003d410: 6c6f 636b 6564 2064 6f77 6e20 7768 656e locked down when │ │ │ │ │ -0003d420: 2062 6f6f 7465 6420 6f6e 2061 2073 6563 booted on a sec │ │ │ │ │ -0003d430: 7572 6520 626f 6f74 2065 6e76 6972 6f6e ure boot environ │ │ │ │ │ -0003d440: 6d65 6e74 2c0a 666f 7220 6578 616d 706c ment,.for exampl │ │ │ │ │ -0003d450: 6520 6966 2074 6865 2055 4546 4920 7365 e if the UEFI se │ │ │ │ │ -0003d460: 6375 7265 2062 6f6f 7420 6973 2065 6e61 cure boot is ena │ │ │ │ │ -0003d470: 626c 6564 2e20 204f 6e20 6120 6c6f 636b bled. On a lock │ │ │ │ │ -0003d480: 6564 2064 6f77 6e0a 636f 6e66 6967 7572 ed down.configur │ │ │ │ │ -0003d490: 6174 696f 6e2c 2074 6865 2047 5255 4220 ation, the GRUB │ │ │ │ │ -0003d4a0: 7769 6c6c 2062 6520 7265 7374 7269 6374 will be restrict │ │ │ │ │ -0003d4b0: 6564 2061 6e64 2073 6f6d 6520 6f70 6572 ed and some oper │ │ │ │ │ -0003d4c0: 6174 696f 6e73 2f63 6f6d 6d61 6e64 730a ations/commands. │ │ │ │ │ -0003d4d0: 6361 6e6e 6f74 2062 6520 6578 6563 7574 cannot be execut │ │ │ │ │ -0003d4e0: 6564 2e0a 0a20 2020 5468 6520 276c 6f63 ed... The 'loc │ │ │ │ │ -0003d4f0: 6b64 6f77 6e27 2076 6172 6961 626c 6520 kdown' variable │ │ │ │ │ -0003d500: 6973 2073 6574 2074 6f20 2779 2720 7768 is set to 'y' wh │ │ │ │ │ -0003d510: 656e 2074 6865 2047 5255 4220 6973 206c en the GRUB is l │ │ │ │ │ -0003d520: 6f63 6b65 6420 646f 776e 2e0a 4f74 6865 ocked down..Othe │ │ │ │ │ -0003d530: 7277 6973 6520 6974 2064 6f65 7320 6e6f rwise it does no │ │ │ │ │ -0003d540: 7420 6578 6974 2e0a 0a1f 0a46 696c 653a t exit.....File: │ │ │ │ │ -0003d550: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ -0003d560: 653a 2050 6c61 7466 6f72 6d20 6c69 6d69 e: Platform limi │ │ │ │ │ -0003d570: 7461 7469 6f6e 732c 2020 4e65 7874 3a20 tations, Next: │ │ │ │ │ -0003d580: 506c 6174 666f 726d 2d73 7065 6369 6669 Platform-specifi │ │ │ │ │ -0003d590: 6320 6f70 6572 6174 696f 6e73 2c20 2050 c operations, P │ │ │ │ │ -0003d5a0: 7265 763a 2053 6563 7572 6974 792c 2020 rev: Security, │ │ │ │ │ -0003d5b0: 5570 3a20 546f 700a 0a31 3920 506c 6174 Up: Top..19 Plat │ │ │ │ │ -0003d5c0: 666f 726d 206c 696d 6974 6174 696f 6e73 form limitations │ │ │ │ │ -0003d5d0: 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a .*************** │ │ │ │ │ -0003d5e0: 2a2a 2a2a 2a2a 2a2a 0a0a 4752 5542 3220 ********..GRUB2 │ │ │ │ │ -0003d5f0: 6973 2064 6573 6967 6e65 6420 746f 2062 is designed to b │ │ │ │ │ -0003d600: 6520 706f 7274 6162 6c65 2061 6e64 2069 e portable and i │ │ │ │ │ -0003d610: 7320 6163 7475 616c 6c79 2070 6f72 7465 s actually porte │ │ │ │ │ -0003d620: 6420 6163 726f 7373 0a70 6c61 7466 6f72 d across.platfor │ │ │ │ │ -0003d630: 6d73 2e20 2057 6520 7472 7920 746f 206b ms. We try to k │ │ │ │ │ -0003d640: 6565 7020 616c 6c20 706c 6174 666f 726d eep all platform │ │ │ │ │ -0003d650: 7320 6174 2074 6865 206c 6576 656c 2e20 s at the level. │ │ │ │ │ -0003d660: 2055 6e66 6f72 7475 6e61 7465 6c79 0a73 Unfortunately.s │ │ │ │ │ -0003d670: 6f6d 6520 706c 6174 666f 726d 7320 6172 ome platforms ar │ │ │ │ │ -0003d680: 6520 6265 7474 6572 2073 7570 706f 7274 e better support │ │ │ │ │ -0003d690: 6564 2074 6861 6e20 6f74 6865 7273 2e20 ed than others. │ │ │ │ │ -0003d6a0: 2054 6869 7320 6973 2064 6574 6169 6c65 This is detaile │ │ │ │ │ -0003d6b0: 6420 696e 0a63 7572 7265 6e74 2061 6e64 d in.current and │ │ │ │ │ -0003d6c0: 2032 2066 6f6c 6c6f 7769 6e67 2073 6563 2 following sec │ │ │ │ │ -0003d6d0: 7469 6f6e 732e 0a0a 2020 2041 6c6c 2070 tions... All p │ │ │ │ │ -0003d6e0: 6c61 7466 6f72 6d73 2068 6176 6520 616e latforms have an │ │ │ │ │ -0003d6f0: 2061 7274 6966 6963 6961 6c6c 7920 4752 artificially GR │ │ │ │ │ -0003d700: 5542 2069 6d70 6f73 6564 2064 6973 6b20 UB imposed disk │ │ │ │ │ -0003d710: 7369 7a65 2072 6573 7472 6963 7469 6f6e size restriction │ │ │ │ │ -0003d720: 0a6f 6620 3120 4569 422e 2049 6e20 736f .of 1 EiB. In so │ │ │ │ │ -0003d730: 6d65 2063 6173 6573 2c20 6c61 7267 6572 me cases, larger │ │ │ │ │ -0003d740: 2064 6973 6b20 7369 7a65 7320 6361 6e20 disk sizes can │ │ │ │ │ -0003d750: 6265 2075 7365 642c 2062 7574 2061 6363 be used, but acc │ │ │ │ │ -0003d760: 6573 7320 7769 6c6c 0a6e 6f74 2062 6520 ess will.not be │ │ │ │ │ -0003d770: 616c 6c6f 7765 6420 6265 796f 6e64 2031 allowed beyond 1 │ │ │ │ │ -0003d780: 2045 6942 2e0a 0a20 2020 4c55 4b53 3220 EiB... LUKS2 │ │ │ │ │ -0003d790: 6465 7669 6365 7320 7769 7468 2073 697a devices with siz │ │ │ │ │ -0003d7a0: 6520 6c61 7267 6572 2074 6861 6e20 3136 e larger than 16 │ │ │ │ │ -0003d7b0: 2045 6942 2061 7265 2063 7572 7265 6e74 EiB are current │ │ │ │ │ -0003d7c0: 6c79 206e 6f74 0a73 7570 706f 7274 6564 ly not.supported │ │ │ │ │ -0003d7d0: 2e20 2054 6865 7920 6361 6e20 6e6f 7420 . They can not │ │ │ │ │ -0003d7e0: 6265 2063 7265 6174 6564 2061 7320 6372 be created as cr │ │ │ │ │ -0003d7f0: 7970 746f 2064 6576 6963 6573 2062 7920 ypto devices by │ │ │ │ │ -0003d800: 6372 7970 746f 6d6f 756e 742c 2073 6f0a cryptomount, so. │ │ │ │ │ -0003d810: 6361 6e20 6e6f 7420 6576 656e 2062 6520 can not even be │ │ │ │ │ -0003d820: 7061 7274 6961 6c6c 7920 7265 6164 2066 partially read f │ │ │ │ │ -0003d830: 726f 6d2e 2020 4c55 4b53 2068 6176 6520 rom. LUKS have │ │ │ │ │ -0003d840: 6e6f 206c 696d 6974 6174 696f 6e73 206f no limitations o │ │ │ │ │ -0003d850: 7468 6572 0a74 6861 6e20 7468 6f73 6520 ther.than those │ │ │ │ │ -0003d860: 696d 706f 7365 6420 6279 2074 6865 2066 imposed by the f │ │ │ │ │ -0003d870: 6f72 6d61 742e 0a0a 2020 2041 5243 2070 ormat... ARC p │ │ │ │ │ -0003d880: 6c61 7466 6f72 6d20 6973 2075 6e61 626c latform is unabl │ │ │ │ │ -0003d890: 6520 746f 2063 6861 6e67 6520 6461 7465 e to change date │ │ │ │ │ -0003d8a0: 7469 6d65 2028 6669 726d 7761 7265 2064 time (firmware d │ │ │ │ │ -0003d8b0: 6f65 736e 2774 2073 6565 6d20 746f 0a70 oesn't seem to.p │ │ │ │ │ -0003d8c0: 726f 7669 6465 2061 2066 756e 6374 696f rovide a functio │ │ │ │ │ -0003d8d0: 6e20 666f 7220 6974 292e 2020 454d 5520 n for it). EMU │ │ │ │ │ -0003d8e0: 6861 7320 7369 6d69 6c61 7220 6c69 6d69 has similar limi │ │ │ │ │ -0003d8f0: 7461 7469 6f6e 2e0a 0a20 2020 4f6e 2045 tation... On E │ │ │ │ │ -0003d900: 4d55 2070 6c61 7466 6f72 6d20 6e6f 2073 MU platform no s │ │ │ │ │ -0003d910: 6572 6961 6c20 706f 7274 2069 7320 6176 erial port is av │ │ │ │ │ -0003d920: 6169 6c61 626c 652e 0a0a 2020 2043 6f6e ailable... Con │ │ │ │ │ -0003d930: 736f 6c65 2063 6861 7273 6574 2072 6566 sole charset ref │ │ │ │ │ -0003d940: 6572 7320 6f6e 6c79 2074 6f20 6669 726d ers only to firm │ │ │ │ │ -0003d950: 7761 7265 2d61 7373 6973 7465 6420 636f ware-assisted co │ │ │ │ │ -0003d960: 6e73 6f6c 652e 2020 6766 7874 6572 6d20 nsole. gfxterm │ │ │ │ │ -0003d970: 6973 0a61 6c77 6179 7320 556e 6963 6f64 is.always Unicod │ │ │ │ │ -0003d980: 6520 2873 6565 2049 6e74 6572 6e61 7469 e (see Internati │ │ │ │ │ -0003d990: 6f6e 616c 6973 6174 696f 6e20 7365 6374 onalisation sect │ │ │ │ │ -0003d9a0: 696f 6e20 666f 7220 6974 7320 6c69 6d69 ion for its limi │ │ │ │ │ -0003d9b0: 7461 7469 6f6e 7329 2e0a 5365 7269 616c tations)..Serial │ │ │ │ │ -0003d9c0: 2069 7320 636f 6e66 6967 7572 6162 6c65 is configurable │ │ │ │ │ -0003d9d0: 2074 6f20 5554 462d 3820 6f72 2041 5343 to UTF-8 or ASC │ │ │ │ │ -0003d9e0: 4949 2028 7365 6520 496e 7465 726e 6174 II (see Internat │ │ │ │ │ -0003d9f0: 696f 6e61 6c69 7361 7469 6f6e 292e 2020 ionalisation). │ │ │ │ │ -0003da00: 496e 0a63 6173 6520 6f66 2071 656d 7520 In.case of qemu │ │ │ │ │ -0003da10: 616e 6420 636f 7265 626f 6f74 2070 6f72 and coreboot por │ │ │ │ │ -0003da20: 7473 2074 6865 2072 6566 6572 6564 2063 ts the refered c │ │ │ │ │ -0003da30: 6f6e 736f 6c65 2069 7320 7667 615f 7465 onsole is vga_te │ │ │ │ │ -0003da40: 7874 2e0a 4c6f 6f6e 6773 6f6e 2061 6c77 xt..Loongson alw │ │ │ │ │ -0003da50: 6179 7320 7573 6573 2067 6678 7465 726d ays uses gfxterm │ │ │ │ │ -0003da60: 2e0a 0a20 2020 4d6f 7374 206c 696d 6974 ... Most limit │ │ │ │ │ -0003da70: 6564 206f 6e65 2069 7320 4153 4349 492e ed one is ASCII. │ │ │ │ │ -0003da80: 2043 5034 3337 2070 726f 7669 6465 7320 CP437 provides │ │ │ │ │ -0003da90: 6164 6469 7469 6f6e 616c 6c79 0a70 7365 additionally.pse │ │ │ │ │ -0003daa0: 7564 6f67 7261 7068 6963 732e 2020 4752 udographics. GR │ │ │ │ │ -0003dab0: 5542 3220 646f 6573 6e27 7420 7573 6520 UB2 doesn't use │ │ │ │ │ -0003dac0: 616e 7920 6c61 6e67 7561 6765 2063 6861 any language cha │ │ │ │ │ -0003dad0: 7261 6374 6572 7320 6672 6f6d 2043 5034 racters from CP4 │ │ │ │ │ -0003dae0: 3337 2061 730a 6f66 7465 6e20 4350 3433 37 as.often CP43 │ │ │ │ │ -0003daf0: 3720 6973 2072 6570 6c61 6365 6420 6279 7 is replaced by │ │ │ │ │ -0003db00: 206e 6174 696f 6e61 6c20 656e 636f 6469 national encodi │ │ │ │ │ -0003db10: 6e67 2063 6f6d 7061 7469 626c 6520 6f6e ng compatible on │ │ │ │ │ -0003db20: 6c79 2069 6e0a 7073 6575 646f 6772 6170 ly in.pseudograp │ │ │ │ │ -0003db30: 6869 6373 2e20 2055 6e69 636f 6465 2069 hics. Unicode i │ │ │ │ │ -0003db40: 7320 7468 6520 6d6f 7374 2076 6572 7361 s the most versa │ │ │ │ │ -0003db50: 7469 6c65 2063 6861 7273 6574 2077 6869 tile charset whi │ │ │ │ │ -0003db60: 6368 2073 7570 706f 7274 730a 6d61 6e79 ch supports.many │ │ │ │ │ -0003db70: 206c 616e 6775 6167 6573 2e20 2048 6f77 languages. How │ │ │ │ │ -0003db80: 6576 6572 2074 6865 2061 6374 7561 6c20 ever the actual │ │ │ │ │ -0003db90: 636f 6e73 6f6c 6520 6d61 7920 6265 206d console may be m │ │ │ │ │ -0003dba0: 7563 6820 6d6f 7265 206c 696d 6974 6564 uch more limited │ │ │ │ │ -0003dbb0: 0a64 6570 656e 6469 6e67 206f 6e20 6669 .depending on fi │ │ │ │ │ -0003dbc0: 726d 7761 7265 0a0a 2020 204f 6e20 4249 rmware.. On BI │ │ │ │ │ -0003dbd0: 4f53 2c20 6e65 7477 6f72 6b20 6973 2073 OS, network is s │ │ │ │ │ -0003dbe0: 7570 706f 7274 6564 206f 6e6c 7920 6966 upported only if │ │ │ │ │ -0003dbf0: 2074 6865 2069 6d61 6765 2069 7320 6c6f the image is lo │ │ │ │ │ -0003dc00: 6164 6564 2074 6872 6f75 6768 0a6e 6574 aded through.net │ │ │ │ │ -0003dc10: 776f 726b 2e20 204f 6e20 7370 6172 6336 work. On sparc6 │ │ │ │ │ -0003dc20: 342c 2047 5255 4220 6973 2075 6e61 626c 4, GRUB is unabl │ │ │ │ │ -0003dc30: 6520 746f 2064 6574 6572 6d69 6e65 2077 e to determine w │ │ │ │ │ -0003dc40: 6869 6368 2073 6572 7665 7220 6974 2077 hich server it w │ │ │ │ │ -0003dc50: 6173 0a62 6f6f 7465 6420 6672 6f6d 2e0a as.booted from.. │ │ │ │ │ -0003dc60: 0a20 2020 4469 7265 6374 2041 5441 2f41 . Direct ATA/A │ │ │ │ │ -0003dc70: 4843 4920 7375 7070 6f72 7420 616c 6c6f HCI support allo │ │ │ │ │ -0003dc80: 7773 2074 6f20 6369 7263 756d 7665 6e74 ws to circumvent │ │ │ │ │ -0003dc90: 2076 6172 696f 7573 2066 6972 6d77 6172 various firmwar │ │ │ │ │ -0003dca0: 650a 6c69 6d69 7461 7469 6f6e 7320 6275 e.limitations bu │ │ │ │ │ -0003dcb0: 7420 6973 6e27 7420 6e65 6564 6564 2066 t isn't needed f │ │ │ │ │ -0003dcc0: 6f72 206e 6f72 6d61 6c20 6f70 6572 6174 or normal operat │ │ │ │ │ -0003dcd0: 696f 6e20 6578 6365 7074 206f 6e20 6261 ion except on ba │ │ │ │ │ -0003dce0: 7265 6d65 7461 6c0a 706f 7274 732e 0a0a remetal.ports... │ │ │ │ │ -0003dcf0: 2020 2041 5420 6b65 7962 6f61 7264 2073 AT keyboard s │ │ │ │ │ -0003dd00: 7570 706f 7274 2061 6c6c 6f77 7320 6b65 upport allows ke │ │ │ │ │ -0003dd10: 7962 6f61 7264 206c 6179 6f75 7420 7265 yboard layout re │ │ │ │ │ -0003dd20: 6d61 7070 696e 6720 616e 6420 7375 7070 mapping and supp │ │ │ │ │ -0003dd30: 6f72 7420 666f 720a 6b65 7973 206e 6f74 ort for.keys not │ │ │ │ │ -0003dd40: 2061 7661 696c 6162 6c65 2074 6872 6f75 available throu │ │ │ │ │ -0003dd50: 6768 2066 6972 6d77 6172 652e 2020 4974 gh firmware. It │ │ │ │ │ -0003dd60: 2069 736e 2774 206e 6565 6465 6420 666f isn't needed fo │ │ │ │ │ -0003dd70: 7220 6e6f 726d 616c 0a6f 7065 7261 7469 r normal.operati │ │ │ │ │ -0003dd80: 6f6e 2065 7863 6570 7420 6261 7265 6d65 on except bareme │ │ │ │ │ -0003dd90: 7461 6c20 706f 7274 732e 0a0a 2020 2053 tal ports... S │ │ │ │ │ -0003dda0: 7065 616b 6572 2061 6c6c 6f77 7320 6d6f peaker allows mo │ │ │ │ │ -0003ddb0: 7273 6520 616e 6420 7370 6b6d 6f64 656d rse and spkmodem │ │ │ │ │ -0003ddc0: 2063 6f6d 6d75 6e69 6361 7469 6f6e 2e0a communication.. │ │ │ │ │ -0003ddd0: 0a20 2020 5553 4220 7375 7070 6f72 7420 . USB support │ │ │ │ │ -0003dde0: 7072 6f76 6964 6573 2062 656e 6566 6974 provides benefit │ │ │ │ │ -0003ddf0: 7320 7369 6d69 6c61 7220 746f 2041 5441 s similar to ATA │ │ │ │ │ -0003de00: 2028 666f 7220 5553 4220 6469 736b 7329 (for USB disks) │ │ │ │ │ -0003de10: 206f 7220 4154 0a28 666f 7220 5553 4220 or AT.(for USB │ │ │ │ │ -0003de20: 6b65 7962 6f61 7264 7329 2e20 2049 6e20 keyboards). In │ │ │ │ │ -0003de30: 6164 6469 7469 6f6e 2069 7420 616c 6c6f addition it allo │ │ │ │ │ -0003de40: 7773 2055 5342 7365 7269 616c 2e0a 0a20 ws USBserial... │ │ │ │ │ -0003de50: 2020 4368 6169 6e6c 6f61 6469 6e67 2072 Chainloading r │ │ │ │ │ -0003de60: 6566 6572 7320 746f 2074 6865 2061 6269 efers to the abi │ │ │ │ │ -0003de70: 6c69 7479 2074 6f20 6c6f 6164 2061 6e6f lity to load ano │ │ │ │ │ -0003de80: 7468 6572 2062 6f6f 746c 6f61 6465 7220 ther bootloader │ │ │ │ │ -0003de90: 7468 726f 7567 680a 7468 6520 7361 6d65 through.the same │ │ │ │ │ -0003dea0: 2070 726f 746f 636f 6c0a 0a20 2020 4869 protocol.. Hi │ │ │ │ │ -0003deb0: 6e74 7320 616c 6c6f 7720 6661 7374 6572 nts allow faster │ │ │ │ │ -0003dec0: 2064 6973 6b20 6469 7363 6f76 6572 7920 disk discovery │ │ │ │ │ -0003ded0: 6279 2061 6c72 6561 6479 206b 6e6f 7769 by already knowi │ │ │ │ │ -0003dee0: 6e67 2069 6e20 6164 7661 6e63 6520 7768 ng in advance wh │ │ │ │ │ -0003def0: 6963 680a 6973 2074 6865 2064 6973 6b20 ich.is the disk │ │ │ │ │ -0003df00: 696e 2071 7565 7374 696f 6e2e 2020 4f6e in question. On │ │ │ │ │ -0003df10: 2073 6f6d 6520 706c 6174 666f 726d 7320 some platforms │ │ │ │ │ -0003df20: 6869 6e74 7320 6172 6520 636f 7272 6563 hints are correc │ │ │ │ │ -0003df30: 7420 756e 6c65 7373 2079 6f75 0a6d 6f76 t unless you.mov │ │ │ │ │ -0003df40: 6520 7468 6520 6469 736b 2062 6574 7765 e the disk betwe │ │ │ │ │ -0003df50: 656e 2062 6f6f 7473 2e20 204f 6e20 6f74 en boots. On ot │ │ │ │ │ -0003df60: 6865 7220 706c 6174 666f 726d 7320 6974 her platforms it │ │ │ │ │ -0003df70: 2773 206a 7573 7420 616e 2065 6475 6361 's just an educa │ │ │ │ │ -0003df80: 7465 640a 6775 6573 732e 2020 4e6f 7465 ted.guess. Note │ │ │ │ │ -0003df90: 2074 6861 7420 6869 6e74 2066 6169 6c75 that hint failu │ │ │ │ │ -0003dfa0: 7265 2072 6573 756c 7473 2069 6e20 6a75 re results in ju │ │ │ │ │ -0003dfb0: 7374 2072 6564 7563 6564 2070 6572 666f st reduced perfo │ │ │ │ │ -0003dfc0: 726d 616e 6365 2c20 6e6f 740a 6120 6661 rmance, not.a fa │ │ │ │ │ -0003dfd0: 696c 7572 650a 0a20 2020 4261 6452 414d ilure.. BadRAM │ │ │ │ │ -0003dfe0: 2069 7320 7468 6520 6162 696c 6974 7920 is the ability │ │ │ │ │ -0003dff0: 746f 206d 6172 6b20 736f 6d65 206f 6620 to mark some of │ │ │ │ │ -0003e000: 7468 6520 5241 4d20 6173 2022 6261 6422 the RAM as "bad" │ │ │ │ │ -0003e010: 2e20 204e 6f74 653a 2064 7565 2074 6f0a . Note: due to. │ │ │ │ │ -0003e020: 7072 6f74 6f63 6f6c 206c 696d 6974 6174 protocol limitat │ │ │ │ │ -0003e030: 696f 6e73 206d 6970 732d 6c6f 6f6e 6773 ions mips-loongs │ │ │ │ │ -0003e040: 6f6e 2028 7769 7468 204c 696e 7578 2070 on (with Linux p │ │ │ │ │ -0003e050: 726f 746f 636f 6c29 2061 6e64 0a6d 6970 rotocol) and.mip │ │ │ │ │ -0003e060: 732d 7165 6d75 5f6d 6970 7320 6361 6e20 s-qemu_mips can │ │ │ │ │ -0003e070: 7573 6520 6f6e 6c79 206d 656d 6f72 7920 use only memory │ │ │ │ │ -0003e080: 7570 2074 6f20 6669 7273 7420 686f 6c65 up to first hole │ │ │ │ │ -0003e090: 2e0a 0a20 2020 426f 6f74 6c6f 6361 7469 ... Bootlocati │ │ │ │ │ -0003e0a0: 6f6e 2069 7320 6162 696c 6974 7920 6f66 on is ability of │ │ │ │ │ -0003e0b0: 2047 5255 4220 746f 2061 7574 6f6d 6174 GRUB to automat │ │ │ │ │ -0003e0c0: 6963 616c 6c79 2064 6574 6563 7420 7768 ically detect wh │ │ │ │ │ -0003e0d0: 6572 6520 6974 0a62 6f6f 7473 2066 726f ere it.boots fro │ │ │ │ │ -0003e0e0: 6d2e 2020 2264 6973 6b22 206d 6561 6e73 m. "disk" means │ │ │ │ │ -0003e0f0: 2074 6865 2064 6574 6563 7469 6f6e 2069 the detection i │ │ │ │ │ -0003e100: 7320 6c69 6d69 7465 6420 746f 2064 6574 s limited to det │ │ │ │ │ -0003e110: 6563 7469 6e67 2074 6865 2064 6973 6b0a ecting the disk. │ │ │ │ │ -0003e120: 7769 7468 2070 6172 7469 7469 6f6e 2062 with partition b │ │ │ │ │ -0003e130: 6569 6e67 2064 6973 636f 7665 7265 6420 eing discovered │ │ │ │ │ -0003e140: 6f6e 2069 6e73 7461 6c6c 2074 696d 652e on install time. │ │ │ │ │ -0003e150: 2020 2270 6172 7469 7469 6f6e 2220 6d65 "partition" me │ │ │ │ │ -0003e160: 616e 7320 7468 6174 0a64 6973 6b20 616e ans that.disk an │ │ │ │ │ -0003e170: 6420 7061 7274 6974 6f6e 2063 616e 2062 d partiton can b │ │ │ │ │ -0003e180: 6520 6175 746f 6d61 7469 6361 6c6c 7920 e automatically │ │ │ │ │ -0003e190: 6469 7363 6f76 6572 6564 2e20 2022 6669 discovered. "fi │ │ │ │ │ -0003e1a0: 6c65 2220 6d65 616e 7320 7468 6174 0a62 le" means that.b │ │ │ │ │ -0003e1b0: 6f6f 7420 696d 6167 6520 6669 6c65 206e oot image file n │ │ │ │ │ -0003e1c0: 616d 6520 6173 2077 656c 6c20 6173 2064 ame as well as d │ │ │ │ │ -0003e1d0: 6973 6b20 616e 6420 7061 7274 6974 696f isk and partitio │ │ │ │ │ -0003e1e0: 6e20 6361 6e20 6265 2064 6973 636f 7665 n can be discove │ │ │ │ │ -0003e1f0: 7265 642e 0a46 6f72 2063 6f6e 7369 7374 red..For consist │ │ │ │ │ -0003e200: 656e 6379 2c20 6465 6661 756c 7420 696e ency, default in │ │ │ │ │ -0003e210: 7374 616c 6c20 6967 6e6f 7265 7320 7061 stall ignores pa │ │ │ │ │ -0003e220: 7274 6974 696f 6e20 616e 6420 7265 6c69 rtition and reli │ │ │ │ │ -0003e230: 6573 2073 6f6c 656c 7920 6f6e 0a64 6973 es solely on.dis │ │ │ │ │ -0003e240: 6b20 6465 7465 6374 696f 6e2e 2020 4966 k detection. If │ │ │ │ │ -0003e250: 206e 6f20 626f 6f74 6c6f 6361 7469 6f6e no bootlocation │ │ │ │ │ -0003e260: 2064 6973 636f 7665 7279 2069 7320 6176 discovery is av │ │ │ │ │ -0003e270: 6169 6c61 626c 6520 6f72 2062 6f6f 7420 ailable or boot │ │ │ │ │ -0003e280: 616e 640a 6772 7562 2d72 6f6f 7420 6469 and.grub-root di │ │ │ │ │ -0003e290: 736b 7320 6172 6520 6469 6666 6572 656e sks are differen │ │ │ │ │ -0003e2a0: 742c 2055 5549 4420 6973 2075 7365 6420 t, UUID is used │ │ │ │ │ -0003e2b0: 696e 7374 6561 642e 2020 4f6e 2041 5243 instead. On ARC │ │ │ │ │ -0003e2c0: 2069 6620 6e6f 0a64 6576 6963 6520 746f if no.device to │ │ │ │ │ -0003e2d0: 2069 6e73 7461 6c6c 2074 6f20 6973 2073 install to is s │ │ │ │ │ -0003e2e0: 7065 6369 6669 6564 2c20 5555 4944 2069 pecified, UUID i │ │ │ │ │ -0003e2f0: 7320 7573 6564 2069 6e73 7465 6164 2061 s used instead a │ │ │ │ │ -0003e300: 7320 7765 6c6c 2e0a 0a20 2020 2020 2020 s well... │ │ │ │ │ -0003e310: 2020 2020 2020 2020 4249 4f53 2020 2020 BIOS │ │ │ │ │ -0003e320: 2020 2020 2020 2043 6f72 6562 6f6f 7420 Coreboot │ │ │ │ │ -0003e330: 2020 2020 2020 4d75 6c74 6962 6f6f 7420 Multiboot │ │ │ │ │ -0003e340: 2020 2020 2051 656d 750a 7669 6465 6f20 Qemu.video │ │ │ │ │ -0003e350: 2020 2020 2020 2020 2079 6573 2020 2020 yes │ │ │ │ │ -0003e360: 2020 2020 2020 2020 7965 7320 2020 2020 yes │ │ │ │ │ -0003e370: 2020 2020 2020 2079 6573 2020 2020 2020 yes │ │ │ │ │ -0003e380: 2020 2020 2020 7965 730a 636f 6e73 6f6c yes.consol │ │ │ │ │ -0003e390: 6520 2020 2020 2020 2043 5034 3337 2020 e CP437 │ │ │ │ │ -0003e3a0: 2020 2020 2020 2020 4350 3433 3720 2020 CP437 │ │ │ │ │ -0003e3b0: 2020 2020 2020 2043 5034 3337 2020 2020 CP437 │ │ │ │ │ -0003e3c0: 2020 2020 2020 4350 3433 370a 6368 6172 CP437.char │ │ │ │ │ -0003e3d0: 7365 740a 6e65 7477 6f72 6b20 2020 2020 set.network │ │ │ │ │ -0003e3e0: 2020 2079 6573 2028 2a29 2020 2020 2020 yes (*) │ │ │ │ │ -0003e3f0: 2020 6e6f 2020 2020 2020 2020 2020 2020 no │ │ │ │ │ -0003e400: 206e 6f20 2020 2020 2020 2020 2020 2020 no │ │ │ │ │ -0003e410: 6e6f 0a41 5441 2f41 4843 4920 2020 2020 no.ATA/AHCI │ │ │ │ │ -0003e420: 2020 7965 7320 2020 2020 2020 2020 2020 yes │ │ │ │ │ -0003e430: 2079 6573 2020 2020 2020 2020 2020 2020 yes │ │ │ │ │ -0003e440: 7965 7320 2020 2020 2020 2020 2020 2079 yes y │ │ │ │ │ -0003e450: 6573 0a41 5420 6b65 7962 6f61 7264 2020 es.AT keyboard │ │ │ │ │ -0003e460: 2020 7965 7320 2020 2020 2020 2020 2020 yes │ │ │ │ │ -0003e470: 2079 6573 2020 2020 2020 2020 2020 2020 yes │ │ │ │ │ -0003e480: 7965 7320 2020 2020 2020 2020 2020 2079 yes y │ │ │ │ │ -0003e490: 6573 0a53 7065 616b 6572 2020 2020 2020 es.Speaker │ │ │ │ │ -0003e4a0: 2020 7965 7320 2020 2020 2020 2020 2020 yes │ │ │ │ │ -0003e4b0: 2079 6573 2020 2020 2020 2020 2020 2020 yes │ │ │ │ │ -0003e4c0: 7965 7320 2020 2020 2020 2020 2020 2079 yes y │ │ │ │ │ -0003e4d0: 6573 0a55 5342 2020 2020 2020 2020 2020 es.USB │ │ │ │ │ -0003e4e0: 2020 7965 7320 2020 2020 2020 2020 2020 yes │ │ │ │ │ -0003e4f0: 2079 6573 2020 2020 2020 2020 2020 2020 yes │ │ │ │ │ -0003e500: 7965 7320 2020 2020 2020 2020 2020 2079 yes y │ │ │ │ │ -0003e510: 6573 0a63 6861 696e 6c6f 6164 6572 2020 es.chainloader │ │ │ │ │ -0003e520: 2020 6c6f 6361 6c20 2020 2020 2020 2020 local │ │ │ │ │ -0003e530: 2079 6573 2020 2020 2020 2020 2020 2020 yes │ │ │ │ │ -0003e540: 7965 7320 2020 2020 2020 2020 2020 206e yes n │ │ │ │ │ -0003e550: 6f0a 6370 7569 6420 2020 2020 2020 2020 o.cpuid │ │ │ │ │ -0003e560: 2070 6172 7469 616c 2020 2020 2020 2020 partial │ │ │ │ │ -0003e570: 7061 7274 6961 6c20 2020 2020 2020 2070 partial p │ │ │ │ │ -0003e580: 6172 7469 616c 2020 2020 2020 2020 7061 artial pa │ │ │ │ │ -0003e590: 7274 6961 6c0a 7264 6d73 7220 2020 2020 rtial.rdmsr │ │ │ │ │ -0003e5a0: 2020 2020 2070 6172 7469 616c 2020 2020 partial │ │ │ │ │ -0003e5b0: 2020 2020 7061 7274 6961 6c20 2020 2020 partial │ │ │ │ │ -0003e5c0: 2020 2070 6172 7469 616c 2020 2020 2020 partial │ │ │ │ │ -0003e5d0: 2020 7061 7274 6961 6c0a 7772 6d73 7220 partial.wrmsr │ │ │ │ │ -0003e5e0: 2020 2020 2020 2020 2070 6172 7469 616c partial │ │ │ │ │ -0003e5f0: 2020 2020 2020 2020 7061 7274 6961 6c20 partial │ │ │ │ │ -0003e600: 2020 2020 2020 2070 6172 7469 616c 2020 partial │ │ │ │ │ -0003e610: 2020 2020 2020 7061 7274 6961 6c0a 6869 partial.hi │ │ │ │ │ -0003e620: 6e74 7320 2020 2020 2020 2020 2067 7565 nts gue │ │ │ │ │ -0003e630: 7373 2020 2020 2020 2020 2020 6775 6573 ss gues │ │ │ │ │ -0003e640: 7320 2020 2020 2020 2020 2067 7565 7373 s guess │ │ │ │ │ -0003e650: 2020 2020 2020 2020 2020 6775 6573 730a guess. │ │ │ │ │ -0003e660: 5043 4920 2020 2020 2020 2020 2020 2079 PCI y │ │ │ │ │ -0003e670: 6573 2020 2020 2020 2020 2020 2020 7965 es ye │ │ │ │ │ -0003e680: 7320 2020 2020 2020 2020 2020 2079 6573 s yes │ │ │ │ │ -0003e690: 2020 2020 2020 2020 2020 2020 7965 730a yes. │ │ │ │ │ -0003e6a0: 6261 6472 616d 2020 2020 2020 2020 2079 badram y │ │ │ │ │ -0003e6b0: 6573 2020 2020 2020 2020 2020 2020 7965 es ye │ │ │ │ │ -0003e6c0: 7320 2020 2020 2020 2020 2020 2079 6573 s yes │ │ │ │ │ -0003e6d0: 2020 2020 2020 2020 2020 2020 7965 730a yes. │ │ │ │ │ -0003e6e0: 636f 6d70 7265 7373 696f 6e20 2020 2061 compression a │ │ │ │ │ -0003e6f0: 6c77 6179 7320 2020 2020 2020 2020 706f lways po │ │ │ │ │ -0003e700: 696e 746c 6573 7320 2020 2020 206e 6f20 intless no │ │ │ │ │ -0003e710: 2020 2020 2020 2020 2020 2020 6e6f 0a65 no.e │ │ │ │ │ -0003e720: 7869 7420 2020 2020 2020 2020 2020 7965 xit ye │ │ │ │ │ -0003e730: 7320 2020 2020 2020 2020 2020 206e 6f20 s no │ │ │ │ │ -0003e740: 2020 2020 2020 2020 2020 2020 6e6f 2020 no │ │ │ │ │ -0003e750: 2020 2020 2020 2020 2020 206e 6f0a 626f no.bo │ │ │ │ │ -0003e760: 6f74 6c6f 6361 7469 6f6e 2020 2064 6973 otlocation dis │ │ │ │ │ -0003e770: 6b20 2020 2020 2020 2020 2020 6e6f 2020 k no │ │ │ │ │ -0003e780: 2020 2020 2020 2020 2020 206e 6f20 2020 no │ │ │ │ │ -0003e790: 2020 2020 2020 2020 2020 6e6f 0a0a 2020 no.. │ │ │ │ │ -0003e7a0: 2020 2020 2020 2020 2020 2020 2069 6133 ia3 │ │ │ │ │ -0003e7b0: 3220 4546 4920 2020 2020 2020 616d 6436 2 EFI amd6 │ │ │ │ │ -0003e7c0: 3420 4546 4920 2020 2020 2069 6133 3220 4 EFI ia32 │ │ │ │ │ -0003e7d0: 2020 2020 2020 2020 2020 4974 616e 6975 Itaniu │ │ │ │ │ -0003e7e0: 6d0a 2020 2020 2020 2020 2020 2020 2020 m. │ │ │ │ │ +0003d3f0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 5468 ============..Th │ │ │ │ │ +0003d400: 6520 4752 5542 2063 616e 2062 6520 6c6f e GRUB can be lo │ │ │ │ │ +0003d410: 636b 6564 2064 6f77 6e20 7768 656e 2062 cked down when b │ │ │ │ │ +0003d420: 6f6f 7465 6420 6f6e 2061 2073 6563 7572 ooted on a secur │ │ │ │ │ +0003d430: 6520 626f 6f74 2065 6e76 6972 6f6e 6d65 e boot environme │ │ │ │ │ +0003d440: 6e74 2c0a 666f 7220 6578 616d 706c 6520 nt,.for example │ │ │ │ │ +0003d450: 6966 2074 6865 2055 4546 4920 7365 6375 if the UEFI secu │ │ │ │ │ +0003d460: 7265 2062 6f6f 7420 6973 2065 6e61 626c re boot is enabl │ │ │ │ │ +0003d470: 6564 2e20 204f 6e20 6120 6c6f 636b 6564 ed. On a locked │ │ │ │ │ +0003d480: 2064 6f77 6e0a 636f 6e66 6967 7572 6174 down.configurat │ │ │ │ │ +0003d490: 696f 6e2c 2074 6865 2047 5255 4220 7769 ion, the GRUB wi │ │ │ │ │ +0003d4a0: 6c6c 2062 6520 7265 7374 7269 6374 6564 ll be restricted │ │ │ │ │ +0003d4b0: 2061 6e64 2073 6f6d 6520 6f70 6572 6174 and some operat │ │ │ │ │ +0003d4c0: 696f 6e73 2f63 6f6d 6d61 6e64 730a 6361 ions/commands.ca │ │ │ │ │ +0003d4d0: 6e6e 6f74 2062 6520 6578 6563 7574 6564 nnot be executed │ │ │ │ │ +0003d4e0: 2e0a 0a20 2020 5468 6520 276c 6f63 6b64 ... The 'lockd │ │ │ │ │ +0003d4f0: 6f77 6e27 2076 6172 6961 626c 6520 6973 own' variable is │ │ │ │ │ +0003d500: 2073 6574 2074 6f20 2779 2720 7768 656e set to 'y' when │ │ │ │ │ +0003d510: 2074 6865 2047 5255 4220 6973 206c 6f63 the GRUB is loc │ │ │ │ │ +0003d520: 6b65 6420 646f 776e 2e0a 4f74 6865 7277 ked down..Otherw │ │ │ │ │ +0003d530: 6973 6520 6974 2064 6f65 7320 6e6f 7420 ise it does not │ │ │ │ │ +0003d540: 6578 6974 2e0a 0a1f 0a46 696c 653a 2067 exit.....File: g │ │ │ │ │ +0003d550: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ +0003d560: 2050 6c61 7466 6f72 6d20 6c69 6d69 7461 Platform limita │ │ │ │ │ +0003d570: 7469 6f6e 732c 2020 4e65 7874 3a20 506c tions, Next: Pl │ │ │ │ │ +0003d580: 6174 666f 726d 2d73 7065 6369 6669 6320 atform-specific │ │ │ │ │ +0003d590: 6f70 6572 6174 696f 6e73 2c20 2050 7265 operations, Pre │ │ │ │ │ +0003d5a0: 763a 2053 6563 7572 6974 792c 2020 5570 v: Security, Up │ │ │ │ │ +0003d5b0: 3a20 546f 700a 0a31 3920 506c 6174 666f : Top..19 Platfo │ │ │ │ │ +0003d5c0: 726d 206c 696d 6974 6174 696f 6e73 0a2a rm limitations.* │ │ │ │ │ +0003d5d0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ +0003d5e0: 2a2a 2a2a 2a2a 0a0a 4752 5542 3220 6973 ******..GRUB2 is │ │ │ │ │ +0003d5f0: 2064 6573 6967 6e65 6420 746f 2062 6520 designed to be │ │ │ │ │ +0003d600: 706f 7274 6162 6c65 2061 6e64 2069 7320 portable and is │ │ │ │ │ +0003d610: 6163 7475 616c 6c79 2070 6f72 7465 6420 actually ported │ │ │ │ │ +0003d620: 6163 726f 7373 0a70 6c61 7466 6f72 6d73 across.platforms │ │ │ │ │ +0003d630: 2e20 2057 6520 7472 7920 746f 206b 6565 . We try to kee │ │ │ │ │ +0003d640: 7020 616c 6c20 706c 6174 666f 726d 7320 p all platforms │ │ │ │ │ +0003d650: 6174 2074 6865 206c 6576 656c 2e20 2055 at the level. U │ │ │ │ │ +0003d660: 6e66 6f72 7475 6e61 7465 6c79 0a73 6f6d nfortunately.som │ │ │ │ │ +0003d670: 6520 706c 6174 666f 726d 7320 6172 6520 e platforms are │ │ │ │ │ +0003d680: 6265 7474 6572 2073 7570 706f 7274 6564 better supported │ │ │ │ │ +0003d690: 2074 6861 6e20 6f74 6865 7273 2e20 2054 than others. T │ │ │ │ │ +0003d6a0: 6869 7320 6973 2064 6574 6169 6c65 6420 his is detailed │ │ │ │ │ +0003d6b0: 696e 0a63 7572 7265 6e74 2061 6e64 2032 in.current and 2 │ │ │ │ │ +0003d6c0: 2066 6f6c 6c6f 7769 6e67 2073 6563 7469 following secti │ │ │ │ │ +0003d6d0: 6f6e 732e 0a0a 2020 2041 6c6c 2070 6c61 ons... All pla │ │ │ │ │ +0003d6e0: 7466 6f72 6d73 2068 6176 6520 616e 2061 tforms have an a │ │ │ │ │ +0003d6f0: 7274 6966 6963 6961 6c6c 7920 4752 5542 rtificially GRUB │ │ │ │ │ +0003d700: 2069 6d70 6f73 6564 2064 6973 6b20 7369 imposed disk si │ │ │ │ │ +0003d710: 7a65 2072 6573 7472 6963 7469 6f6e 0a6f ze restriction.o │ │ │ │ │ +0003d720: 6620 3120 4569 422e 2049 6e20 736f 6d65 f 1 EiB. In some │ │ │ │ │ +0003d730: 2063 6173 6573 2c20 6c61 7267 6572 2064 cases, larger d │ │ │ │ │ +0003d740: 6973 6b20 7369 7a65 7320 6361 6e20 6265 isk sizes can be │ │ │ │ │ +0003d750: 2075 7365 642c 2062 7574 2061 6363 6573 used, but acces │ │ │ │ │ +0003d760: 7320 7769 6c6c 0a6e 6f74 2062 6520 616c s will.not be al │ │ │ │ │ +0003d770: 6c6f 7765 6420 6265 796f 6e64 2031 2045 lowed beyond 1 E │ │ │ │ │ +0003d780: 6942 2e0a 0a20 2020 4c55 4b53 3220 6465 iB... LUKS2 de │ │ │ │ │ +0003d790: 7669 6365 7320 7769 7468 2073 697a 6520 vices with size │ │ │ │ │ +0003d7a0: 6c61 7267 6572 2074 6861 6e20 3136 2045 larger than 16 E │ │ │ │ │ +0003d7b0: 6942 2061 7265 2063 7572 7265 6e74 6c79 iB are currently │ │ │ │ │ +0003d7c0: 206e 6f74 0a73 7570 706f 7274 6564 2e20 not.supported. │ │ │ │ │ +0003d7d0: 2054 6865 7920 6361 6e20 6e6f 7420 6265 They can not be │ │ │ │ │ +0003d7e0: 2063 7265 6174 6564 2061 7320 6372 7970 created as cryp │ │ │ │ │ +0003d7f0: 746f 2064 6576 6963 6573 2062 7920 6372 to devices by cr │ │ │ │ │ +0003d800: 7970 746f 6d6f 756e 742c 2073 6f0a 6361 yptomount, so.ca │ │ │ │ │ +0003d810: 6e20 6e6f 7420 6576 656e 2062 6520 7061 n not even be pa │ │ │ │ │ +0003d820: 7274 6961 6c6c 7920 7265 6164 2066 726f rtially read fro │ │ │ │ │ +0003d830: 6d2e 2020 4c55 4b53 2068 6176 6520 6e6f m. LUKS have no │ │ │ │ │ +0003d840: 206c 696d 6974 6174 696f 6e73 206f 7468 limitations oth │ │ │ │ │ +0003d850: 6572 0a74 6861 6e20 7468 6f73 6520 696d er.than those im │ │ │ │ │ +0003d860: 706f 7365 6420 6279 2074 6865 2066 6f72 posed by the for │ │ │ │ │ +0003d870: 6d61 742e 0a0a 2020 2041 5243 2070 6c61 mat... ARC pla │ │ │ │ │ +0003d880: 7466 6f72 6d20 6973 2075 6e61 626c 6520 tform is unable │ │ │ │ │ +0003d890: 746f 2063 6861 6e67 6520 6461 7465 7469 to change dateti │ │ │ │ │ +0003d8a0: 6d65 2028 6669 726d 7761 7265 2064 6f65 me (firmware doe │ │ │ │ │ +0003d8b0: 736e 2774 2073 6565 6d20 746f 0a70 726f sn't seem to.pro │ │ │ │ │ +0003d8c0: 7669 6465 2061 2066 756e 6374 696f 6e20 vide a function │ │ │ │ │ +0003d8d0: 666f 7220 6974 292e 2020 454d 5520 6861 for it). EMU ha │ │ │ │ │ +0003d8e0: 7320 7369 6d69 6c61 7220 6c69 6d69 7461 s similar limita │ │ │ │ │ +0003d8f0: 7469 6f6e 2e0a 0a20 2020 4f6e 2045 4d55 tion... On EMU │ │ │ │ │ +0003d900: 2070 6c61 7466 6f72 6d20 6e6f 2073 6572 platform no ser │ │ │ │ │ +0003d910: 6961 6c20 706f 7274 2069 7320 6176 6169 ial port is avai │ │ │ │ │ +0003d920: 6c61 626c 652e 0a0a 2020 2043 6f6e 736f lable... Conso │ │ │ │ │ +0003d930: 6c65 2063 6861 7273 6574 2072 6566 6572 le charset refer │ │ │ │ │ +0003d940: 7320 6f6e 6c79 2074 6f20 6669 726d 7761 s only to firmwa │ │ │ │ │ +0003d950: 7265 2d61 7373 6973 7465 6420 636f 6e73 re-assisted cons │ │ │ │ │ +0003d960: 6f6c 652e 2020 6766 7874 6572 6d20 6973 ole. gfxterm is │ │ │ │ │ +0003d970: 0a61 6c77 6179 7320 556e 6963 6f64 6520 .always Unicode │ │ │ │ │ +0003d980: 2873 6565 2049 6e74 6572 6e61 7469 6f6e (see Internation │ │ │ │ │ +0003d990: 616c 6973 6174 696f 6e20 7365 6374 696f alisation sectio │ │ │ │ │ +0003d9a0: 6e20 666f 7220 6974 7320 6c69 6d69 7461 n for its limita │ │ │ │ │ +0003d9b0: 7469 6f6e 7329 2e0a 5365 7269 616c 2069 tions)..Serial i │ │ │ │ │ +0003d9c0: 7320 636f 6e66 6967 7572 6162 6c65 2074 s configurable t │ │ │ │ │ +0003d9d0: 6f20 5554 462d 3820 6f72 2041 5343 4949 o UTF-8 or ASCII │ │ │ │ │ +0003d9e0: 2028 7365 6520 496e 7465 726e 6174 696f (see Internatio │ │ │ │ │ +0003d9f0: 6e61 6c69 7361 7469 6f6e 292e 2020 496e nalisation). In │ │ │ │ │ +0003da00: 0a63 6173 6520 6f66 2071 656d 7520 616e .case of qemu an │ │ │ │ │ +0003da10: 6420 636f 7265 626f 6f74 2070 6f72 7473 d coreboot ports │ │ │ │ │ +0003da20: 2074 6865 2072 6566 6572 6564 2063 6f6e the refered con │ │ │ │ │ +0003da30: 736f 6c65 2069 7320 7667 615f 7465 7874 sole is vga_text │ │ │ │ │ +0003da40: 2e0a 4c6f 6f6e 6773 6f6e 2061 6c77 6179 ..Loongson alway │ │ │ │ │ +0003da50: 7320 7573 6573 2067 6678 7465 726d 2e0a s uses gfxterm.. │ │ │ │ │ +0003da60: 0a20 2020 4d6f 7374 206c 696d 6974 6564 . Most limited │ │ │ │ │ +0003da70: 206f 6e65 2069 7320 4153 4349 492e 2043 one is ASCII. C │ │ │ │ │ +0003da80: 5034 3337 2070 726f 7669 6465 7320 6164 P437 provides ad │ │ │ │ │ +0003da90: 6469 7469 6f6e 616c 6c79 0a70 7365 7564 ditionally.pseud │ │ │ │ │ +0003daa0: 6f67 7261 7068 6963 732e 2020 4752 5542 ographics. GRUB │ │ │ │ │ +0003dab0: 3220 646f 6573 6e27 7420 7573 6520 616e 2 doesn't use an │ │ │ │ │ +0003dac0: 7920 6c61 6e67 7561 6765 2063 6861 7261 y language chara │ │ │ │ │ +0003dad0: 6374 6572 7320 6672 6f6d 2043 5034 3337 cters from CP437 │ │ │ │ │ +0003dae0: 2061 730a 6f66 7465 6e20 4350 3433 3720 as.often CP437 │ │ │ │ │ +0003daf0: 6973 2072 6570 6c61 6365 6420 6279 206e is replaced by n │ │ │ │ │ +0003db00: 6174 696f 6e61 6c20 656e 636f 6469 6e67 ational encoding │ │ │ │ │ +0003db10: 2063 6f6d 7061 7469 626c 6520 6f6e 6c79 compatible only │ │ │ │ │ +0003db20: 2069 6e0a 7073 6575 646f 6772 6170 6869 in.pseudographi │ │ │ │ │ +0003db30: 6373 2e20 2055 6e69 636f 6465 2069 7320 cs. Unicode is │ │ │ │ │ +0003db40: 7468 6520 6d6f 7374 2076 6572 7361 7469 the most versati │ │ │ │ │ +0003db50: 6c65 2063 6861 7273 6574 2077 6869 6368 le charset which │ │ │ │ │ +0003db60: 2073 7570 706f 7274 730a 6d61 6e79 206c supports.many l │ │ │ │ │ +0003db70: 616e 6775 6167 6573 2e20 2048 6f77 6576 anguages. Howev │ │ │ │ │ +0003db80: 6572 2074 6865 2061 6374 7561 6c20 636f er the actual co │ │ │ │ │ +0003db90: 6e73 6f6c 6520 6d61 7920 6265 206d 7563 nsole may be muc │ │ │ │ │ +0003dba0: 6820 6d6f 7265 206c 696d 6974 6564 0a64 h more limited.d │ │ │ │ │ +0003dbb0: 6570 656e 6469 6e67 206f 6e20 6669 726d epending on firm │ │ │ │ │ +0003dbc0: 7761 7265 0a0a 2020 204f 6e20 4249 4f53 ware.. On BIOS │ │ │ │ │ +0003dbd0: 2c20 6e65 7477 6f72 6b20 6973 2073 7570 , network is sup │ │ │ │ │ +0003dbe0: 706f 7274 6564 206f 6e6c 7920 6966 2074 ported only if t │ │ │ │ │ +0003dbf0: 6865 2069 6d61 6765 2069 7320 6c6f 6164 he image is load │ │ │ │ │ +0003dc00: 6564 2074 6872 6f75 6768 0a6e 6574 776f ed through.netwo │ │ │ │ │ +0003dc10: 726b 2e20 204f 6e20 7370 6172 6336 342c rk. On sparc64, │ │ │ │ │ +0003dc20: 2047 5255 4220 6973 2075 6e61 626c 6520 GRUB is unable │ │ │ │ │ +0003dc30: 746f 2064 6574 6572 6d69 6e65 2077 6869 to determine whi │ │ │ │ │ +0003dc40: 6368 2073 6572 7665 7220 6974 2077 6173 ch server it was │ │ │ │ │ +0003dc50: 0a62 6f6f 7465 6420 6672 6f6d 2e0a 0a20 .booted from... │ │ │ │ │ +0003dc60: 2020 4469 7265 6374 2041 5441 2f41 4843 Direct ATA/AHC │ │ │ │ │ +0003dc70: 4920 7375 7070 6f72 7420 616c 6c6f 7773 I support allows │ │ │ │ │ +0003dc80: 2074 6f20 6369 7263 756d 7665 6e74 2076 to circumvent v │ │ │ │ │ +0003dc90: 6172 696f 7573 2066 6972 6d77 6172 650a arious firmware. │ │ │ │ │ +0003dca0: 6c69 6d69 7461 7469 6f6e 7320 6275 7420 limitations but │ │ │ │ │ +0003dcb0: 6973 6e27 7420 6e65 6564 6564 2066 6f72 isn't needed for │ │ │ │ │ +0003dcc0: 206e 6f72 6d61 6c20 6f70 6572 6174 696f normal operatio │ │ │ │ │ +0003dcd0: 6e20 6578 6365 7074 206f 6e20 6261 7265 n except on bare │ │ │ │ │ +0003dce0: 6d65 7461 6c0a 706f 7274 732e 0a0a 2020 metal.ports... │ │ │ │ │ +0003dcf0: 2041 5420 6b65 7962 6f61 7264 2073 7570 AT keyboard sup │ │ │ │ │ +0003dd00: 706f 7274 2061 6c6c 6f77 7320 6b65 7962 port allows keyb │ │ │ │ │ +0003dd10: 6f61 7264 206c 6179 6f75 7420 7265 6d61 oard layout rema │ │ │ │ │ +0003dd20: 7070 696e 6720 616e 6420 7375 7070 6f72 pping and suppor │ │ │ │ │ +0003dd30: 7420 666f 720a 6b65 7973 206e 6f74 2061 t for.keys not a │ │ │ │ │ +0003dd40: 7661 696c 6162 6c65 2074 6872 6f75 6768 vailable through │ │ │ │ │ +0003dd50: 2066 6972 6d77 6172 652e 2020 4974 2069 firmware. It i │ │ │ │ │ +0003dd60: 736e 2774 206e 6565 6465 6420 666f 7220 sn't needed for │ │ │ │ │ +0003dd70: 6e6f 726d 616c 0a6f 7065 7261 7469 6f6e normal.operation │ │ │ │ │ +0003dd80: 2065 7863 6570 7420 6261 7265 6d65 7461 except baremeta │ │ │ │ │ +0003dd90: 6c20 706f 7274 732e 0a0a 2020 2053 7065 l ports... Spe │ │ │ │ │ +0003dda0: 616b 6572 2061 6c6c 6f77 7320 6d6f 7273 aker allows mors │ │ │ │ │ +0003ddb0: 6520 616e 6420 7370 6b6d 6f64 656d 2063 e and spkmodem c │ │ │ │ │ +0003ddc0: 6f6d 6d75 6e69 6361 7469 6f6e 2e0a 0a20 ommunication... │ │ │ │ │ +0003ddd0: 2020 5553 4220 7375 7070 6f72 7420 7072 USB support pr │ │ │ │ │ +0003dde0: 6f76 6964 6573 2062 656e 6566 6974 7320 ovides benefits │ │ │ │ │ +0003ddf0: 7369 6d69 6c61 7220 746f 2041 5441 2028 similar to ATA ( │ │ │ │ │ +0003de00: 666f 7220 5553 4220 6469 736b 7329 206f for USB disks) o │ │ │ │ │ +0003de10: 7220 4154 0a28 666f 7220 5553 4220 6b65 r AT.(for USB ke │ │ │ │ │ +0003de20: 7962 6f61 7264 7329 2e20 2049 6e20 6164 yboards). In ad │ │ │ │ │ +0003de30: 6469 7469 6f6e 2069 7420 616c 6c6f 7773 dition it allows │ │ │ │ │ +0003de40: 2055 5342 7365 7269 616c 2e0a 0a20 2020 USBserial... │ │ │ │ │ +0003de50: 4368 6169 6e6c 6f61 6469 6e67 2072 6566 Chainloading ref │ │ │ │ │ +0003de60: 6572 7320 746f 2074 6865 2061 6269 6c69 ers to the abili │ │ │ │ │ +0003de70: 7479 2074 6f20 6c6f 6164 2061 6e6f 7468 ty to load anoth │ │ │ │ │ +0003de80: 6572 2062 6f6f 746c 6f61 6465 7220 7468 er bootloader th │ │ │ │ │ +0003de90: 726f 7567 680a 7468 6520 7361 6d65 2070 rough.the same p │ │ │ │ │ +0003dea0: 726f 746f 636f 6c0a 0a20 2020 4869 6e74 rotocol.. Hint │ │ │ │ │ +0003deb0: 7320 616c 6c6f 7720 6661 7374 6572 2064 s allow faster d │ │ │ │ │ +0003dec0: 6973 6b20 6469 7363 6f76 6572 7920 6279 isk discovery by │ │ │ │ │ +0003ded0: 2061 6c72 6561 6479 206b 6e6f 7769 6e67 already knowing │ │ │ │ │ +0003dee0: 2069 6e20 6164 7661 6e63 6520 7768 6963 in advance whic │ │ │ │ │ +0003def0: 680a 6973 2074 6865 2064 6973 6b20 696e h.is the disk in │ │ │ │ │ +0003df00: 2071 7565 7374 696f 6e2e 2020 4f6e 2073 question. On s │ │ │ │ │ +0003df10: 6f6d 6520 706c 6174 666f 726d 7320 6869 ome platforms hi │ │ │ │ │ +0003df20: 6e74 7320 6172 6520 636f 7272 6563 7420 nts are correct │ │ │ │ │ +0003df30: 756e 6c65 7373 2079 6f75 0a6d 6f76 6520 unless you.move │ │ │ │ │ +0003df40: 7468 6520 6469 736b 2062 6574 7765 656e the disk between │ │ │ │ │ +0003df50: 2062 6f6f 7473 2e20 204f 6e20 6f74 6865 boots. On othe │ │ │ │ │ +0003df60: 7220 706c 6174 666f 726d 7320 6974 2773 r platforms it's │ │ │ │ │ +0003df70: 206a 7573 7420 616e 2065 6475 6361 7465 just an educate │ │ │ │ │ +0003df80: 640a 6775 6573 732e 2020 4e6f 7465 2074 d.guess. Note t │ │ │ │ │ +0003df90: 6861 7420 6869 6e74 2066 6169 6c75 7265 hat hint failure │ │ │ │ │ +0003dfa0: 2072 6573 756c 7473 2069 6e20 6a75 7374 results in just │ │ │ │ │ +0003dfb0: 2072 6564 7563 6564 2070 6572 666f 726d reduced perform │ │ │ │ │ +0003dfc0: 616e 6365 2c20 6e6f 740a 6120 6661 696c ance, not.a fail │ │ │ │ │ +0003dfd0: 7572 650a 0a20 2020 4261 6452 414d 2069 ure.. BadRAM i │ │ │ │ │ +0003dfe0: 7320 7468 6520 6162 696c 6974 7920 746f s the ability to │ │ │ │ │ +0003dff0: 206d 6172 6b20 736f 6d65 206f 6620 7468 mark some of th │ │ │ │ │ +0003e000: 6520 5241 4d20 6173 2022 6261 6422 2e20 e RAM as "bad". │ │ │ │ │ +0003e010: 204e 6f74 653a 2064 7565 2074 6f0a 7072 Note: due to.pr │ │ │ │ │ +0003e020: 6f74 6f63 6f6c 206c 696d 6974 6174 696f otocol limitatio │ │ │ │ │ +0003e030: 6e73 206d 6970 732d 6c6f 6f6e 6773 6f6e ns mips-loongson │ │ │ │ │ +0003e040: 2028 7769 7468 204c 696e 7578 2070 726f (with Linux pro │ │ │ │ │ +0003e050: 746f 636f 6c29 2061 6e64 0a6d 6970 732d tocol) and.mips- │ │ │ │ │ +0003e060: 7165 6d75 5f6d 6970 7320 6361 6e20 7573 qemu_mips can us │ │ │ │ │ +0003e070: 6520 6f6e 6c79 206d 656d 6f72 7920 7570 e only memory up │ │ │ │ │ +0003e080: 2074 6f20 6669 7273 7420 686f 6c65 2e0a to first hole.. │ │ │ │ │ +0003e090: 0a20 2020 426f 6f74 6c6f 6361 7469 6f6e . Bootlocation │ │ │ │ │ +0003e0a0: 2069 7320 6162 696c 6974 7920 6f66 2047 is ability of G │ │ │ │ │ +0003e0b0: 5255 4220 746f 2061 7574 6f6d 6174 6963 RUB to automatic │ │ │ │ │ +0003e0c0: 616c 6c79 2064 6574 6563 7420 7768 6572 ally detect wher │ │ │ │ │ +0003e0d0: 6520 6974 0a62 6f6f 7473 2066 726f 6d2e e it.boots from. │ │ │ │ │ +0003e0e0: 2020 2264 6973 6b22 206d 6561 6e73 2074 "disk" means t │ │ │ │ │ +0003e0f0: 6865 2064 6574 6563 7469 6f6e 2069 7320 he detection is │ │ │ │ │ +0003e100: 6c69 6d69 7465 6420 746f 2064 6574 6563 limited to detec │ │ │ │ │ +0003e110: 7469 6e67 2074 6865 2064 6973 6b0a 7769 ting the disk.wi │ │ │ │ │ +0003e120: 7468 2070 6172 7469 7469 6f6e 2062 6569 th partition bei │ │ │ │ │ +0003e130: 6e67 2064 6973 636f 7665 7265 6420 6f6e ng discovered on │ │ │ │ │ +0003e140: 2069 6e73 7461 6c6c 2074 696d 652e 2020 install time. │ │ │ │ │ +0003e150: 2270 6172 7469 7469 6f6e 2220 6d65 616e "partition" mean │ │ │ │ │ +0003e160: 7320 7468 6174 0a64 6973 6b20 616e 6420 s that.disk and │ │ │ │ │ +0003e170: 7061 7274 6974 6f6e 2063 616e 2062 6520 partiton can be │ │ │ │ │ +0003e180: 6175 746f 6d61 7469 6361 6c6c 7920 6469 automatically di │ │ │ │ │ +0003e190: 7363 6f76 6572 6564 2e20 2022 6669 6c65 scovered. "file │ │ │ │ │ +0003e1a0: 2220 6d65 616e 7320 7468 6174 0a62 6f6f " means that.boo │ │ │ │ │ +0003e1b0: 7420 696d 6167 6520 6669 6c65 206e 616d t image file nam │ │ │ │ │ +0003e1c0: 6520 6173 2077 656c 6c20 6173 2064 6973 e as well as dis │ │ │ │ │ +0003e1d0: 6b20 616e 6420 7061 7274 6974 696f 6e20 k and partition │ │ │ │ │ +0003e1e0: 6361 6e20 6265 2064 6973 636f 7665 7265 can be discovere │ │ │ │ │ +0003e1f0: 642e 0a46 6f72 2063 6f6e 7369 7374 656e d..For consisten │ │ │ │ │ +0003e200: 6379 2c20 6465 6661 756c 7420 696e 7374 cy, default inst │ │ │ │ │ +0003e210: 616c 6c20 6967 6e6f 7265 7320 7061 7274 all ignores part │ │ │ │ │ +0003e220: 6974 696f 6e20 616e 6420 7265 6c69 6573 ition and relies │ │ │ │ │ +0003e230: 2073 6f6c 656c 7920 6f6e 0a64 6973 6b20 solely on.disk │ │ │ │ │ +0003e240: 6465 7465 6374 696f 6e2e 2020 4966 206e detection. If n │ │ │ │ │ +0003e250: 6f20 626f 6f74 6c6f 6361 7469 6f6e 2064 o bootlocation d │ │ │ │ │ +0003e260: 6973 636f 7665 7279 2069 7320 6176 6169 iscovery is avai │ │ │ │ │ +0003e270: 6c61 626c 6520 6f72 2062 6f6f 7420 616e lable or boot an │ │ │ │ │ +0003e280: 640a 6772 7562 2d72 6f6f 7420 6469 736b d.grub-root disk │ │ │ │ │ +0003e290: 7320 6172 6520 6469 6666 6572 656e 742c s are different, │ │ │ │ │ +0003e2a0: 2055 5549 4420 6973 2075 7365 6420 696e UUID is used in │ │ │ │ │ +0003e2b0: 7374 6561 642e 2020 4f6e 2041 5243 2069 stead. On ARC i │ │ │ │ │ +0003e2c0: 6620 6e6f 0a64 6576 6963 6520 746f 2069 f no.device to i │ │ │ │ │ +0003e2d0: 6e73 7461 6c6c 2074 6f20 6973 2073 7065 nstall to is spe │ │ │ │ │ +0003e2e0: 6369 6669 6564 2c20 5555 4944 2069 7320 cified, UUID is │ │ │ │ │ +0003e2f0: 7573 6564 2069 6e73 7465 6164 2061 7320 used instead as │ │ │ │ │ +0003e300: 7765 6c6c 2e0a 0a20 2020 2020 2020 2020 well... │ │ │ │ │ +0003e310: 2020 2020 2020 4249 4f53 2020 2020 2020 BIOS │ │ │ │ │ +0003e320: 2020 2020 2043 6f72 6562 6f6f 7420 2020 Coreboot │ │ │ │ │ +0003e330: 2020 2020 4d75 6c74 6962 6f6f 7420 2020 Multiboot │ │ │ │ │ +0003e340: 2020 2051 656d 750a 7669 6465 6f20 2020 Qemu.video │ │ │ │ │ +0003e350: 2020 2020 2020 2079 6573 2020 2020 2020 yes │ │ │ │ │ +0003e360: 2020 2020 2020 7965 7320 2020 2020 2020 yes │ │ │ │ │ +0003e370: 2020 2020 2079 6573 2020 2020 2020 2020 yes │ │ │ │ │ +0003e380: 2020 2020 7965 730a 636f 6e73 6f6c 6520 yes.console │ │ │ │ │ +0003e390: 2020 2020 2020 2043 5034 3337 2020 2020 CP437 │ │ │ │ │ +0003e3a0: 2020 2020 2020 4350 3433 3720 2020 2020 CP437 │ │ │ │ │ +0003e3b0: 2020 2020 2043 5034 3337 2020 2020 2020 CP437 │ │ │ │ │ +0003e3c0: 2020 2020 4350 3433 370a 6368 6172 7365 CP437.charse │ │ │ │ │ +0003e3d0: 740a 6e65 7477 6f72 6b20 2020 2020 2020 t.network │ │ │ │ │ +0003e3e0: 2079 6573 2028 2a29 2020 2020 2020 2020 yes (*) │ │ │ │ │ +0003e3f0: 6e6f 2020 2020 2020 2020 2020 2020 206e no n │ │ │ │ │ +0003e400: 6f20 2020 2020 2020 2020 2020 2020 6e6f o no │ │ │ │ │ +0003e410: 0a41 5441 2f41 4843 4920 2020 2020 2020 .ATA/AHCI │ │ │ │ │ +0003e420: 7965 7320 2020 2020 2020 2020 2020 2079 yes y │ │ │ │ │ +0003e430: 6573 2020 2020 2020 2020 2020 2020 7965 es ye │ │ │ │ │ +0003e440: 7320 2020 2020 2020 2020 2020 2079 6573 s yes │ │ │ │ │ +0003e450: 0a41 5420 6b65 7962 6f61 7264 2020 2020 .AT keyboard │ │ │ │ │ +0003e460: 7965 7320 2020 2020 2020 2020 2020 2079 yes y │ │ │ │ │ +0003e470: 6573 2020 2020 2020 2020 2020 2020 7965 es ye │ │ │ │ │ +0003e480: 7320 2020 2020 2020 2020 2020 2079 6573 s yes │ │ │ │ │ +0003e490: 0a53 7065 616b 6572 2020 2020 2020 2020 .Speaker │ │ │ │ │ +0003e4a0: 7965 7320 2020 2020 2020 2020 2020 2079 yes y │ │ │ │ │ +0003e4b0: 6573 2020 2020 2020 2020 2020 2020 7965 es ye │ │ │ │ │ +0003e4c0: 7320 2020 2020 2020 2020 2020 2079 6573 s yes │ │ │ │ │ +0003e4d0: 0a55 5342 2020 2020 2020 2020 2020 2020 .USB │ │ │ │ │ +0003e4e0: 7965 7320 2020 2020 2020 2020 2020 2079 yes y │ │ │ │ │ +0003e4f0: 6573 2020 2020 2020 2020 2020 2020 7965 es ye │ │ │ │ │ +0003e500: 7320 2020 2020 2020 2020 2020 2079 6573 s yes │ │ │ │ │ +0003e510: 0a63 6861 696e 6c6f 6164 6572 2020 2020 .chainloader │ │ │ │ │ +0003e520: 6c6f 6361 6c20 2020 2020 2020 2020 2079 local y │ │ │ │ │ +0003e530: 6573 2020 2020 2020 2020 2020 2020 7965 es ye │ │ │ │ │ +0003e540: 7320 2020 2020 2020 2020 2020 206e 6f0a s no. │ │ │ │ │ +0003e550: 6370 7569 6420 2020 2020 2020 2020 2070 cpuid p │ │ │ │ │ +0003e560: 6172 7469 616c 2020 2020 2020 2020 7061 artial pa │ │ │ │ │ +0003e570: 7274 6961 6c20 2020 2020 2020 2070 6172 rtial par │ │ │ │ │ +0003e580: 7469 616c 2020 2020 2020 2020 7061 7274 tial part │ │ │ │ │ +0003e590: 6961 6c0a 7264 6d73 7220 2020 2020 2020 ial.rdmsr │ │ │ │ │ +0003e5a0: 2020 2070 6172 7469 616c 2020 2020 2020 partial │ │ │ │ │ +0003e5b0: 2020 7061 7274 6961 6c20 2020 2020 2020 partial │ │ │ │ │ +0003e5c0: 2070 6172 7469 616c 2020 2020 2020 2020 partial │ │ │ │ │ +0003e5d0: 7061 7274 6961 6c0a 7772 6d73 7220 2020 partial.wrmsr │ │ │ │ │ +0003e5e0: 2020 2020 2020 2070 6172 7469 616c 2020 partial │ │ │ │ │ +0003e5f0: 2020 2020 2020 7061 7274 6961 6c20 2020 partial │ │ │ │ │ +0003e600: 2020 2020 2070 6172 7469 616c 2020 2020 partial │ │ │ │ │ +0003e610: 2020 2020 7061 7274 6961 6c0a 6869 6e74 partial.hint │ │ │ │ │ +0003e620: 7320 2020 2020 2020 2020 2067 7565 7373 s guess │ │ │ │ │ +0003e630: 2020 2020 2020 2020 2020 6775 6573 7320 guess │ │ │ │ │ +0003e640: 2020 2020 2020 2020 2067 7565 7373 2020 guess │ │ │ │ │ +0003e650: 2020 2020 2020 2020 6775 6573 730a 5043 guess.PC │ │ │ │ │ +0003e660: 4920 2020 2020 2020 2020 2020 2079 6573 I yes │ │ │ │ │ +0003e670: 2020 2020 2020 2020 2020 2020 7965 7320 yes │ │ │ │ │ +0003e680: 2020 2020 2020 2020 2020 2079 6573 2020 yes │ │ │ │ │ +0003e690: 2020 2020 2020 2020 2020 7965 730a 6261 yes.ba │ │ │ │ │ +0003e6a0: 6472 616d 2020 2020 2020 2020 2079 6573 dram yes │ │ │ │ │ +0003e6b0: 2020 2020 2020 2020 2020 2020 7965 7320 yes │ │ │ │ │ +0003e6c0: 2020 2020 2020 2020 2020 2079 6573 2020 yes │ │ │ │ │ +0003e6d0: 2020 2020 2020 2020 2020 7965 730a 636f yes.co │ │ │ │ │ +0003e6e0: 6d70 7265 7373 696f 6e20 2020 2061 6c77 mpression alw │ │ │ │ │ +0003e6f0: 6179 7320 2020 2020 2020 2020 706f 696e ays poin │ │ │ │ │ +0003e700: 746c 6573 7320 2020 2020 206e 6f20 2020 tless no │ │ │ │ │ +0003e710: 2020 2020 2020 2020 2020 6e6f 0a65 7869 no.exi │ │ │ │ │ +0003e720: 7420 2020 2020 2020 2020 2020 7965 7320 t yes │ │ │ │ │ +0003e730: 2020 2020 2020 2020 2020 206e 6f20 2020 no │ │ │ │ │ +0003e740: 2020 2020 2020 2020 2020 6e6f 2020 2020 no │ │ │ │ │ +0003e750: 2020 2020 2020 2020 206e 6f0a 626f 6f74 no.boot │ │ │ │ │ +0003e760: 6c6f 6361 7469 6f6e 2020 2064 6973 6b20 location disk │ │ │ │ │ +0003e770: 2020 2020 2020 2020 2020 6e6f 2020 2020 no │ │ │ │ │ +0003e780: 2020 2020 2020 2020 206e 6f20 2020 2020 no │ │ │ │ │ +0003e790: 2020 2020 2020 2020 6e6f 0a0a 2020 2020 no.. │ │ │ │ │ +0003e7a0: 2020 2020 2020 2020 2020 2069 6133 3220 ia32 │ │ │ │ │ +0003e7b0: 4546 4920 2020 2020 2020 616d 6436 3420 EFI amd64 │ │ │ │ │ +0003e7c0: 4546 4920 2020 2020 2069 6133 3220 2020 EFI ia32 │ │ │ │ │ +0003e7d0: 2020 2020 2020 2020 4974 616e 6975 6d0a Itanium. │ │ │ │ │ +0003e7e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003e7f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003e800: 2020 2020 2020 2020 2020 2020 2020 2049 I │ │ │ │ │ -0003e810: 4545 4531 3237 350a 7669 6465 6f20 2020 EEE1275.video │ │ │ │ │ -0003e820: 2020 2020 2020 2079 6573 2020 2020 2020 yes │ │ │ │ │ -0003e830: 2020 2020 2020 7965 7320 2020 2020 2020 yes │ │ │ │ │ -0003e840: 2020 2020 206e 6f20 2020 2020 2020 2020 no │ │ │ │ │ -0003e850: 2020 2020 6e6f 0a63 6f6e 736f 6c65 2020 no.console │ │ │ │ │ -0003e860: 2020 2020 2020 556e 6963 6f64 6520 2020 Unicode │ │ │ │ │ -0003e870: 2020 2020 2055 6e69 636f 6465 2020 2020 Unicode │ │ │ │ │ -0003e880: 2020 2020 4153 4349 4920 2020 2020 2020 ASCII │ │ │ │ │ -0003e890: 2020 2055 6e69 636f 6465 0a63 6861 7273 Unicode.chars │ │ │ │ │ -0003e8a0: 6574 0a6e 6574 776f 726b 2020 2020 2020 et.network │ │ │ │ │ -0003e8b0: 2020 7965 7320 2020 2020 2020 2020 2020 yes │ │ │ │ │ -0003e8c0: 2079 6573 2020 2020 2020 2020 2020 2020 yes │ │ │ │ │ -0003e8d0: 7965 7320 2020 2020 2020 2020 2020 2079 yes y │ │ │ │ │ -0003e8e0: 6573 0a41 5441 2f41 4843 4920 2020 2020 es.ATA/AHCI │ │ │ │ │ -0003e8f0: 2020 7965 7320 2020 2020 2020 2020 2020 yes │ │ │ │ │ -0003e900: 2079 6573 2020 2020 2020 2020 2020 2020 yes │ │ │ │ │ -0003e910: 7965 7320 2020 2020 2020 2020 2020 206e yes n │ │ │ │ │ -0003e920: 6f0a 4154 206b 6579 626f 6172 6420 2020 o.AT keyboard │ │ │ │ │ -0003e930: 2079 6573 2020 2020 2020 2020 2020 2020 yes │ │ │ │ │ -0003e940: 7965 7320 2020 2020 2020 2020 2020 2079 yes y │ │ │ │ │ -0003e950: 6573 2020 2020 2020 2020 2020 2020 6e6f es no │ │ │ │ │ -0003e960: 0a53 7065 616b 6572 2020 2020 2020 2020 .Speaker │ │ │ │ │ -0003e970: 7965 7320 2020 2020 2020 2020 2020 2079 yes y │ │ │ │ │ -0003e980: 6573 2020 2020 2020 2020 2020 2020 7965 es ye │ │ │ │ │ -0003e990: 7320 2020 2020 2020 2020 2020 206e 6f0a s no. │ │ │ │ │ -0003e9a0: 5553 4220 2020 2020 2020 2020 2020 2079 USB y │ │ │ │ │ -0003e9b0: 6573 2020 2020 2020 2020 2020 2020 7965 es ye │ │ │ │ │ -0003e9c0: 7320 2020 2020 2020 2020 2020 2079 6573 s yes │ │ │ │ │ -0003e9d0: 2020 2020 2020 2020 2020 2020 6e6f 0a63 no.c │ │ │ │ │ -0003e9e0: 6861 696e 6c6f 6164 6572 2020 2020 6c6f hainloader lo │ │ │ │ │ -0003e9f0: 6361 6c20 2020 2020 2020 2020 206c 6f63 cal loc │ │ │ │ │ -0003ea00: 616c 2020 2020 2020 2020 2020 6e6f 2020 al no │ │ │ │ │ -0003ea10: 2020 2020 2020 2020 2020 206c 6f63 616c local │ │ │ │ │ -0003ea20: 0a63 7075 6964 2020 2020 2020 2020 2020 .cpuid │ │ │ │ │ -0003ea30: 7061 7274 6961 6c20 2020 2020 2020 2070 partial p │ │ │ │ │ -0003ea40: 6172 7469 616c 2020 2020 2020 2020 7061 artial pa │ │ │ │ │ -0003ea50: 7274 6961 6c20 2020 2020 2020 206e 6f0a rtial no. │ │ │ │ │ -0003ea60: 7264 6d73 7220 2020 2020 2020 2020 2070 rdmsr p │ │ │ │ │ -0003ea70: 6172 7469 616c 2020 2020 2020 2020 7061 artial pa │ │ │ │ │ -0003ea80: 7274 6961 6c20 2020 2020 2020 2070 6172 rtial par │ │ │ │ │ -0003ea90: 7469 616c 2020 2020 2020 2020 6e6f 0a77 tial no.w │ │ │ │ │ -0003eaa0: 726d 7372 2020 2020 2020 2020 2020 7061 rmsr pa │ │ │ │ │ -0003eab0: 7274 6961 6c20 2020 2020 2020 2070 6172 rtial par │ │ │ │ │ -0003eac0: 7469 616c 2020 2020 2020 2020 7061 7274 tial part │ │ │ │ │ -0003ead0: 6961 6c20 2020 2020 2020 206e 6f0a 6869 ial no.hi │ │ │ │ │ -0003eae0: 6e74 7320 2020 2020 2020 2020 2067 7565 nts gue │ │ │ │ │ -0003eaf0: 7373 2020 2020 2020 2020 2020 6775 6573 ss gues │ │ │ │ │ -0003eb00: 7320 2020 2020 2020 2020 2067 6f6f 6420 s good │ │ │ │ │ -0003eb10: 2020 2020 2020 2020 2020 6775 6573 730a guess. │ │ │ │ │ -0003eb20: 5043 4920 2020 2020 2020 2020 2020 2079 PCI y │ │ │ │ │ -0003eb30: 6573 2020 2020 2020 2020 2020 2020 7965 es ye │ │ │ │ │ -0003eb40: 7320 2020 2020 2020 2020 2020 2079 6573 s yes │ │ │ │ │ -0003eb50: 2020 2020 2020 2020 2020 2020 6e6f 0a62 no.b │ │ │ │ │ -0003eb60: 6164 7261 6d20 2020 2020 2020 2020 7965 adram ye │ │ │ │ │ -0003eb70: 7320 2020 2020 2020 2020 2020 2079 6573 s yes │ │ │ │ │ -0003eb80: 2020 2020 2020 2020 2020 2020 6e6f 2020 no │ │ │ │ │ -0003eb90: 2020 2020 2020 2020 2020 2079 6573 0a63 yes.c │ │ │ │ │ -0003eba0: 6f6d 7072 6573 7369 6f6e 2020 2020 6e6f ompression no │ │ │ │ │ -0003ebb0: 2020 2020 2020 2020 2020 2020 206e 6f20 no │ │ │ │ │ -0003ebc0: 2020 2020 2020 2020 2020 2020 6e6f 2020 no │ │ │ │ │ -0003ebd0: 2020 2020 2020 2020 2020 206e 6f0a 6578 no.ex │ │ │ │ │ -0003ebe0: 6974 2020 2020 2020 2020 2020 2079 6573 it yes │ │ │ │ │ -0003ebf0: 2020 2020 2020 2020 2020 2020 7965 7320 yes │ │ │ │ │ -0003ec00: 2020 2020 2020 2020 2020 2079 6573 2020 yes │ │ │ │ │ -0003ec10: 2020 2020 2020 2020 2020 7965 730a 626f yes.bo │ │ │ │ │ -0003ec20: 6f74 6c6f 6361 7469 6f6e 2020 2066 696c otlocation fil │ │ │ │ │ -0003ec30: 6520 2020 2020 2020 2020 2020 6669 6c65 e file │ │ │ │ │ -0003ec40: 2020 2020 2020 2020 2020 2066 696c 652c file, │ │ │ │ │ -0003ec50: 2020 2020 2020 2020 2020 6669 6c65 0a20 file. │ │ │ │ │ +0003e800: 2020 2020 2020 2020 2020 2020 2049 4545 IEE │ │ │ │ │ +0003e810: 4531 3237 350a 7669 6465 6f20 2020 2020 E1275.video │ │ │ │ │ +0003e820: 2020 2020 2079 6573 2020 2020 2020 2020 yes │ │ │ │ │ +0003e830: 2020 2020 7965 7320 2020 2020 2020 2020 yes │ │ │ │ │ +0003e840: 2020 206e 6f20 2020 2020 2020 2020 2020 no │ │ │ │ │ +0003e850: 2020 6e6f 0a63 6f6e 736f 6c65 2020 2020 no.console │ │ │ │ │ +0003e860: 2020 2020 556e 6963 6f64 6520 2020 2020 Unicode │ │ │ │ │ +0003e870: 2020 2055 6e69 636f 6465 2020 2020 2020 Unicode │ │ │ │ │ +0003e880: 2020 4153 4349 4920 2020 2020 2020 2020 ASCII │ │ │ │ │ +0003e890: 2055 6e69 636f 6465 0a63 6861 7273 6574 Unicode.charset │ │ │ │ │ +0003e8a0: 0a6e 6574 776f 726b 2020 2020 2020 2020 .network │ │ │ │ │ +0003e8b0: 7965 7320 2020 2020 2020 2020 2020 2079 yes y │ │ │ │ │ +0003e8c0: 6573 2020 2020 2020 2020 2020 2020 7965 es ye │ │ │ │ │ +0003e8d0: 7320 2020 2020 2020 2020 2020 2079 6573 s yes │ │ │ │ │ +0003e8e0: 0a41 5441 2f41 4843 4920 2020 2020 2020 .ATA/AHCI │ │ │ │ │ +0003e8f0: 7965 7320 2020 2020 2020 2020 2020 2079 yes y │ │ │ │ │ +0003e900: 6573 2020 2020 2020 2020 2020 2020 7965 es ye │ │ │ │ │ +0003e910: 7320 2020 2020 2020 2020 2020 206e 6f0a s no. │ │ │ │ │ +0003e920: 4154 206b 6579 626f 6172 6420 2020 2079 AT keyboard y │ │ │ │ │ +0003e930: 6573 2020 2020 2020 2020 2020 2020 7965 es ye │ │ │ │ │ +0003e940: 7320 2020 2020 2020 2020 2020 2079 6573 s yes │ │ │ │ │ +0003e950: 2020 2020 2020 2020 2020 2020 6e6f 0a53 no.S │ │ │ │ │ +0003e960: 7065 616b 6572 2020 2020 2020 2020 7965 peaker ye │ │ │ │ │ +0003e970: 7320 2020 2020 2020 2020 2020 2079 6573 s yes │ │ │ │ │ +0003e980: 2020 2020 2020 2020 2020 2020 7965 7320 yes │ │ │ │ │ +0003e990: 2020 2020 2020 2020 2020 206e 6f0a 5553 no.US │ │ │ │ │ +0003e9a0: 4220 2020 2020 2020 2020 2020 2079 6573 B yes │ │ │ │ │ +0003e9b0: 2020 2020 2020 2020 2020 2020 7965 7320 yes │ │ │ │ │ +0003e9c0: 2020 2020 2020 2020 2020 2079 6573 2020 yes │ │ │ │ │ +0003e9d0: 2020 2020 2020 2020 2020 6e6f 0a63 6861 no.cha │ │ │ │ │ +0003e9e0: 696e 6c6f 6164 6572 2020 2020 6c6f 6361 inloader loca │ │ │ │ │ +0003e9f0: 6c20 2020 2020 2020 2020 206c 6f63 616c l local │ │ │ │ │ +0003ea00: 2020 2020 2020 2020 2020 6e6f 2020 2020 no │ │ │ │ │ +0003ea10: 2020 2020 2020 2020 206c 6f63 616c 0a63 local.c │ │ │ │ │ +0003ea20: 7075 6964 2020 2020 2020 2020 2020 7061 puid pa │ │ │ │ │ +0003ea30: 7274 6961 6c20 2020 2020 2020 2070 6172 rtial par │ │ │ │ │ +0003ea40: 7469 616c 2020 2020 2020 2020 7061 7274 tial part │ │ │ │ │ +0003ea50: 6961 6c20 2020 2020 2020 206e 6f0a 7264 ial no.rd │ │ │ │ │ +0003ea60: 6d73 7220 2020 2020 2020 2020 2070 6172 msr par │ │ │ │ │ +0003ea70: 7469 616c 2020 2020 2020 2020 7061 7274 tial part │ │ │ │ │ +0003ea80: 6961 6c20 2020 2020 2020 2070 6172 7469 ial parti │ │ │ │ │ +0003ea90: 616c 2020 2020 2020 2020 6e6f 0a77 726d al no.wrm │ │ │ │ │ +0003eaa0: 7372 2020 2020 2020 2020 2020 7061 7274 sr part │ │ │ │ │ +0003eab0: 6961 6c20 2020 2020 2020 2070 6172 7469 ial parti │ │ │ │ │ +0003eac0: 616c 2020 2020 2020 2020 7061 7274 6961 al partia │ │ │ │ │ +0003ead0: 6c20 2020 2020 2020 206e 6f0a 6869 6e74 l no.hint │ │ │ │ │ +0003eae0: 7320 2020 2020 2020 2020 2067 7565 7373 s guess │ │ │ │ │ +0003eaf0: 2020 2020 2020 2020 2020 6775 6573 7320 guess │ │ │ │ │ +0003eb00: 2020 2020 2020 2020 2067 6f6f 6420 2020 good │ │ │ │ │ +0003eb10: 2020 2020 2020 2020 6775 6573 730a 5043 guess.PC │ │ │ │ │ +0003eb20: 4920 2020 2020 2020 2020 2020 2079 6573 I yes │ │ │ │ │ +0003eb30: 2020 2020 2020 2020 2020 2020 7965 7320 yes │ │ │ │ │ +0003eb40: 2020 2020 2020 2020 2020 2079 6573 2020 yes │ │ │ │ │ +0003eb50: 2020 2020 2020 2020 2020 6e6f 0a62 6164 no.bad │ │ │ │ │ +0003eb60: 7261 6d20 2020 2020 2020 2020 7965 7320 ram yes │ │ │ │ │ +0003eb70: 2020 2020 2020 2020 2020 2079 6573 2020 yes │ │ │ │ │ +0003eb80: 2020 2020 2020 2020 2020 6e6f 2020 2020 no │ │ │ │ │ +0003eb90: 2020 2020 2020 2020 2079 6573 0a63 6f6d yes.com │ │ │ │ │ +0003eba0: 7072 6573 7369 6f6e 2020 2020 6e6f 2020 pression no │ │ │ │ │ +0003ebb0: 2020 2020 2020 2020 2020 206e 6f20 2020 no │ │ │ │ │ +0003ebc0: 2020 2020 2020 2020 2020 6e6f 2020 2020 no │ │ │ │ │ +0003ebd0: 2020 2020 2020 2020 206e 6f0a 6578 6974 no.exit │ │ │ │ │ +0003ebe0: 2020 2020 2020 2020 2020 2079 6573 2020 yes │ │ │ │ │ +0003ebf0: 2020 2020 2020 2020 2020 7965 7320 2020 yes │ │ │ │ │ +0003ec00: 2020 2020 2020 2020 2079 6573 2020 2020 yes │ │ │ │ │ +0003ec10: 2020 2020 2020 2020 7965 730a 626f 6f74 yes.boot │ │ │ │ │ +0003ec20: 6c6f 6361 7469 6f6e 2020 2066 696c 6520 location file │ │ │ │ │ +0003ec30: 2020 2020 2020 2020 2020 6669 6c65 2020 file │ │ │ │ │ +0003ec40: 2020 2020 2020 2020 2066 696c 652c 2020 file, │ │ │ │ │ +0003ec50: 2020 2020 2020 2020 6669 6c65 0a20 2020 file. │ │ │ │ │ 0003ec60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003ec70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003ec80: 2020 2020 2020 2020 2020 2020 6967 6e6f igno │ │ │ │ │ -0003ec90: 7265 640a 0a20 2020 2020 2020 2020 2020 red.. │ │ │ │ │ -0003eca0: 2020 2020 4c6f 6f6e 6773 6f6e 2020 2020 Loongson │ │ │ │ │ -0003ecb0: 2020 2073 7061 7263 3634 2020 2020 2020 sparc64 │ │ │ │ │ -0003ecc0: 2020 506f 7765 7270 6320 2020 2020 2020 Powerpc │ │ │ │ │ -0003ecd0: 2041 5243 0a76 6964 656f 2020 2020 2020 ARC.video │ │ │ │ │ -0003ece0: 2020 2020 7965 7320 2020 2020 2020 2020 yes │ │ │ │ │ -0003ecf0: 2020 206e 6f20 2020 2020 2020 2020 2020 no │ │ │ │ │ -0003ed00: 2020 7965 7320 2020 2020 2020 2020 2020 yes │ │ │ │ │ -0003ed10: 206e 6f0a 636f 6e73 6f6c 6520 2020 2020 no.console │ │ │ │ │ -0003ed20: 2020 204e 2f41 2020 2020 2020 2020 2020 N/A │ │ │ │ │ -0003ed30: 2020 4153 4349 4920 2020 2020 2020 2020 ASCII │ │ │ │ │ -0003ed40: 2041 5343 4949 2020 2020 2020 2020 2020 ASCII │ │ │ │ │ -0003ed50: 4153 4349 490a 6368 6172 7365 740a 6e65 ASCII.charset.ne │ │ │ │ │ -0003ed60: 7477 6f72 6b20 2020 2020 2020 206e 6f20 twork no │ │ │ │ │ -0003ed70: 2020 2020 2020 2020 2020 2020 7965 7320 yes │ │ │ │ │ -0003ed80: 282a 2920 2020 2020 2020 2079 6573 2020 (*) yes │ │ │ │ │ -0003ed90: 2020 2020 2020 2020 2020 6e6f 0a41 5441 no.ATA │ │ │ │ │ -0003eda0: 2f41 4843 4920 2020 2020 2020 7965 7320 /AHCI yes │ │ │ │ │ -0003edb0: 2020 2020 2020 2020 2020 206e 6f20 2020 no │ │ │ │ │ -0003edc0: 2020 2020 2020 2020 2020 6e6f 2020 2020 no │ │ │ │ │ -0003edd0: 2020 2020 2020 2020 206e 6f0a 4154 206b no.AT k │ │ │ │ │ -0003ede0: 6579 626f 6172 6420 2020 2079 6573 2020 eyboard yes │ │ │ │ │ -0003edf0: 2020 2020 2020 2020 2020 6e6f 2020 2020 no │ │ │ │ │ -0003ee00: 2020 2020 2020 2020 206e 6f20 2020 2020 no │ │ │ │ │ -0003ee10: 2020 2020 2020 2020 6e6f 0a53 7065 616b no.Speak │ │ │ │ │ -0003ee20: 6572 2020 2020 2020 2020 6e6f 2020 2020 er no │ │ │ │ │ -0003ee30: 2020 2020 2020 2020 206e 6f20 2020 2020 no │ │ │ │ │ -0003ee40: 2020 2020 2020 2020 6e6f 2020 2020 2020 no │ │ │ │ │ -0003ee50: 2020 2020 2020 206e 6f0a 5553 4220 2020 no.USB │ │ │ │ │ -0003ee60: 2020 2020 2020 2020 2079 6573 2020 2020 yes │ │ │ │ │ -0003ee70: 2020 2020 2020 2020 6e6f 2020 2020 2020 no │ │ │ │ │ -0003ee80: 2020 2020 2020 206e 6f20 2020 2020 2020 no │ │ │ │ │ -0003ee90: 2020 2020 2020 6e6f 0a63 6861 696e 6c6f no.chainlo │ │ │ │ │ -0003eea0: 6164 6572 2020 2020 7965 7320 2020 2020 ader yes │ │ │ │ │ -0003eeb0: 2020 2020 2020 206e 6f20 2020 2020 2020 no │ │ │ │ │ -0003eec0: 2020 2020 2020 6e6f 2020 2020 2020 2020 no │ │ │ │ │ -0003eed0: 2020 2020 206e 6f0a 6370 7569 6420 2020 no.cpuid │ │ │ │ │ -0003eee0: 2020 2020 2020 206e 6f20 2020 2020 2020 no │ │ │ │ │ -0003eef0: 2020 2020 2020 6e6f 2020 2020 2020 2020 no │ │ │ │ │ -0003ef00: 2020 2020 206e 6f20 2020 2020 2020 2020 no │ │ │ │ │ -0003ef10: 2020 2020 6e6f 0a72 646d 7372 2020 2020 no.rdmsr │ │ │ │ │ -0003ef20: 2020 2020 2020 6e6f 2020 2020 2020 2020 no │ │ │ │ │ -0003ef30: 2020 2020 206e 6f20 2020 2020 2020 2020 no │ │ │ │ │ -0003ef40: 2020 2020 6e6f 2020 2020 2020 2020 2020 no │ │ │ │ │ -0003ef50: 2020 206e 6f0a 7772 6d73 7220 2020 2020 no.wrmsr │ │ │ │ │ -0003ef60: 2020 2020 206e 6f20 2020 2020 2020 2020 no │ │ │ │ │ -0003ef70: 2020 2020 6e6f 2020 2020 2020 2020 2020 no │ │ │ │ │ -0003ef80: 2020 206e 6f20 2020 2020 2020 2020 2020 no │ │ │ │ │ -0003ef90: 2020 6e6f 0a68 696e 7473 2020 2020 2020 no.hints │ │ │ │ │ -0003efa0: 2020 2020 676f 6f64 2020 2020 2020 2020 good │ │ │ │ │ -0003efb0: 2020 2067 6f6f 6420 2020 2020 2020 2020 good │ │ │ │ │ -0003efc0: 2020 676f 6f64 2020 2020 2020 2020 2020 good │ │ │ │ │ -0003efd0: 206e 6f0a 5043 4920 2020 2020 2020 2020 no.PCI │ │ │ │ │ -0003efe0: 2020 2079 6573 2020 2020 2020 2020 2020 yes │ │ │ │ │ -0003eff0: 2020 6e6f 2020 2020 2020 2020 2020 2020 no │ │ │ │ │ -0003f000: 206e 6f20 2020 2020 2020 2020 2020 2020 no │ │ │ │ │ -0003f010: 6e6f 0a62 6164 7261 6d20 2020 2020 2020 no.badram │ │ │ │ │ -0003f020: 2020 7965 7320 282a 2920 2020 2020 2020 yes (*) │ │ │ │ │ -0003f030: 206e 6f20 2020 2020 2020 2020 2020 2020 no │ │ │ │ │ -0003f040: 6e6f 2020 2020 2020 2020 2020 2020 206e no n │ │ │ │ │ -0003f050: 6f0a 636f 6d70 7265 7373 696f 6e20 2020 o.compression │ │ │ │ │ -0003f060: 2063 6f6e 6669 6775 7261 626c 6520 2020 configurable │ │ │ │ │ -0003f070: 6e6f 2020 2020 2020 2020 2020 2020 206e no n │ │ │ │ │ -0003f080: 6f20 2020 2020 2020 2020 2020 2020 636f o co │ │ │ │ │ -0003f090: 6e66 6967 7572 6162 6c65 0a65 7869 7420 nfigurable.exit │ │ │ │ │ -0003f0a0: 2020 2020 2020 2020 2020 6e6f 2020 2020 no │ │ │ │ │ -0003f0b0: 2020 2020 2020 2020 2079 6573 2020 2020 yes │ │ │ │ │ -0003f0c0: 2020 2020 2020 2020 7965 7320 2020 2020 yes │ │ │ │ │ -0003f0d0: 2020 2020 2020 2079 6573 0a62 6f6f 746c yes.bootl │ │ │ │ │ -0003f0e0: 6f63 6174 696f 6e20 2020 6e6f 2020 2020 ocation no │ │ │ │ │ -0003f0f0: 2020 2020 2020 2020 2070 6172 7469 7469 partiti │ │ │ │ │ -0003f100: 6f6e 2020 2020 2020 6669 6c65 2020 2020 on file │ │ │ │ │ -0003f110: 2020 2020 2020 2066 696c 6520 282a 290a file (*). │ │ │ │ │ -0003f120: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ -0003f130: 4d49 5053 2071 656d 7520 2020 2020 2065 MIPS qemu e │ │ │ │ │ -0003f140: 6d75 2020 2020 2020 2020 2020 2020 7865 mu xe │ │ │ │ │ -0003f150: 6e0a 7669 6465 6f20 2020 2020 2020 2020 n.video │ │ │ │ │ -0003f160: 206e 6f20 2020 2020 2020 2020 2020 2020 no │ │ │ │ │ -0003f170: 7965 7320 2020 2020 2020 2020 2020 206e yes n │ │ │ │ │ -0003f180: 6f0a 636f 6e73 6f6c 6520 2020 2020 2020 o.console │ │ │ │ │ -0003f190: 2043 5034 3337 2020 2020 2020 2020 2020 CP437 │ │ │ │ │ -0003f1a0: 556e 6963 6f64 6520 282a 2920 2020 2041 Unicode (*) A │ │ │ │ │ -0003f1b0: 5343 4949 0a63 6861 7273 6574 0a6e 6574 SCII.charset.net │ │ │ │ │ -0003f1c0: 776f 726b 2020 2020 2020 2020 6e6f 2020 work no │ │ │ │ │ -0003f1d0: 2020 2020 2020 2020 2020 2079 6573 2020 yes │ │ │ │ │ -0003f1e0: 2020 2020 2020 2020 2020 6e6f 0a41 5441 no.ATA │ │ │ │ │ -0003f1f0: 2f41 4843 4920 2020 2020 2020 7965 7320 /AHCI yes │ │ │ │ │ -0003f200: 2020 2020 2020 2020 2020 206e 6f20 2020 no │ │ │ │ │ -0003f210: 2020 2020 2020 2020 2020 6e6f 0a41 5420 no.AT │ │ │ │ │ -0003f220: 6b65 7962 6f61 7264 2020 2020 7965 7320 keyboard yes │ │ │ │ │ -0003f230: 2020 2020 2020 2020 2020 206e 6f20 2020 no │ │ │ │ │ -0003f240: 2020 2020 2020 2020 2020 6e6f 0a53 7065 no.Spe │ │ │ │ │ -0003f250: 616b 6572 2020 2020 2020 2020 6e6f 2020 aker no │ │ │ │ │ -0003f260: 2020 2020 2020 2020 2020 206e 6f20 2020 no │ │ │ │ │ -0003f270: 2020 2020 2020 2020 2020 6e6f 0a55 5342 no.USB │ │ │ │ │ -0003f280: 2020 2020 2020 2020 2020 2020 4e2f 4120 N/A │ │ │ │ │ -0003f290: 2020 2020 2020 2020 2020 2079 6573 2020 yes │ │ │ │ │ -0003f2a0: 2020 2020 2020 2020 2020 6e6f 0a63 6861 no.cha │ │ │ │ │ -0003f2b0: 696e 6c6f 6164 6572 2020 2020 7965 7320 inloader yes │ │ │ │ │ -0003f2c0: 2020 2020 2020 2020 2020 206e 6f20 2020 no │ │ │ │ │ -0003f2d0: 2020 2020 2020 2020 2020 7965 730a 6370 yes.cp │ │ │ │ │ -0003f2e0: 7569 6420 2020 2020 2020 2020 206e 6f20 uid no │ │ │ │ │ -0003f2f0: 2020 2020 2020 2020 2020 2020 6e6f 2020 no │ │ │ │ │ -0003f300: 2020 2020 2020 2020 2020 2079 6573 0a72 yes.r │ │ │ │ │ -0003f310: 646d 7372 2020 2020 2020 2020 2020 6e6f dmsr no │ │ │ │ │ -0003f320: 2020 2020 2020 2020 2020 2020 206e 6f20 no │ │ │ │ │ -0003f330: 2020 2020 2020 2020 2020 2020 7965 730a yes. │ │ │ │ │ -0003f340: 7772 6d73 7220 2020 2020 2020 2020 206e wrmsr n │ │ │ │ │ -0003f350: 6f20 2020 2020 2020 2020 2020 2020 6e6f o no │ │ │ │ │ -0003f360: 2020 2020 2020 2020 2020 2020 2079 6573 yes │ │ │ │ │ -0003f370: 0a68 696e 7473 2020 2020 2020 2020 2020 .hints │ │ │ │ │ -0003f380: 6775 6573 7320 2020 2020 2020 2020 206e guess n │ │ │ │ │ -0003f390: 6f20 2020 2020 2020 2020 2020 2020 6e6f o no │ │ │ │ │ -0003f3a0: 0a50 4349 2020 2020 2020 2020 2020 2020 .PCI │ │ │ │ │ -0003f3b0: 6e6f 2020 2020 2020 2020 2020 2020 206e no n │ │ │ │ │ -0003f3c0: 6f20 2020 2020 2020 2020 2020 2020 6e6f o no │ │ │ │ │ -0003f3d0: 0a62 6164 7261 6d20 2020 2020 2020 2020 .badram │ │ │ │ │ -0003f3e0: 7965 7320 282a 2920 2020 2020 2020 206e yes (*) n │ │ │ │ │ -0003f3f0: 6f20 2020 2020 2020 2020 2020 2020 6e6f o no │ │ │ │ │ -0003f400: 0a63 6f6d 7072 6573 7369 6f6e 2020 2020 .compression │ │ │ │ │ -0003f410: 636f 6e66 6967 7572 6162 6c65 2020 206e configurable n │ │ │ │ │ -0003f420: 6f20 2020 2020 2020 2020 2020 2020 6e6f o no │ │ │ │ │ -0003f430: 0a65 7869 7420 2020 2020 2020 2020 2020 .exit │ │ │ │ │ -0003f440: 6e6f 2020 2020 2020 2020 2020 2020 2079 no y │ │ │ │ │ -0003f450: 6573 2020 2020 2020 2020 2020 2020 6e6f es no │ │ │ │ │ -0003f460: 0a62 6f6f 746c 6f63 6174 696f 6e20 2020 .bootlocation │ │ │ │ │ -0003f470: 6e6f 2020 2020 2020 2020 2020 2020 2066 no f │ │ │ │ │ -0003f480: 696c 6520 2020 2020 2020 2020 2020 6e6f ile no │ │ │ │ │ -0003f490: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ -0003f4a0: 6e66 6f2c 2020 4e6f 6465 3a20 506c 6174 nfo, Node: Plat │ │ │ │ │ -0003f4b0: 666f 726d 2d73 7065 6369 6669 6320 6f70 form-specific op │ │ │ │ │ -0003f4c0: 6572 6174 696f 6e73 2c20 204e 6578 743a erations, Next: │ │ │ │ │ -0003f4d0: 2053 7570 706f 7274 6564 206b 6572 6e65 Supported kerne │ │ │ │ │ -0003f4e0: 6c73 2c20 2050 7265 763a 2050 6c61 7466 ls, Prev: Platf │ │ │ │ │ -0003f4f0: 6f72 6d20 6c69 6d69 7461 7469 6f6e 732c orm limitations, │ │ │ │ │ -0003f500: 2020 5570 3a20 546f 700a 0a32 3020 4f75 Up: Top..20 Ou │ │ │ │ │ -0003f510: 746c 696e 650a 2a2a 2a2a 2a2a 2a2a 2a2a tline.********** │ │ │ │ │ -0003f520: 0a0a 536f 6d65 2070 6c61 7466 6f72 6d73 ..Some platforms │ │ │ │ │ -0003f530: 2068 6176 6520 6665 6174 7572 6573 2077 have features w │ │ │ │ │ -0003f540: 6869 6368 2061 6c6c 6f77 7320 746f 2069 hich allows to i │ │ │ │ │ -0003f550: 6d70 6c65 6d65 6e74 2073 6f6d 6520 636f mplement some co │ │ │ │ │ -0003f560: 6d6d 616e 6473 0a75 7365 6c65 7373 206f mmands.useless o │ │ │ │ │ -0003f570: 7220 6e6f 7420 696d 706c 656d 656e 7461 r not implementa │ │ │ │ │ -0003f580: 626c 6520 6f6e 206f 7468 6572 732e 0a0a ble on others... │ │ │ │ │ -0003f590: 2020 2051 7569 636b 2073 756d 6d61 7279 Quick summary │ │ │ │ │ -0003f5a0: 3a0a 0a20 2020 496e 666f 726d 6174 696f :.. Informatio │ │ │ │ │ -0003f5b0: 6e20 7265 7472 6965 7661 6c3a 0a0a 2020 n retrieval:.. │ │ │ │ │ -0003f5c0: 202a 206d 6970 7365 6c2d 6c6f 6f6e 6773 * mipsel-loongs │ │ │ │ │ -0003f5d0: 6f6e 3a20 6c73 7370 640a 2020 202a 206d on: lsspd. * m │ │ │ │ │ -0003f5e0: 6970 732d 6172 633a 206c 7364 6576 0a20 ips-arc: lsdev. │ │ │ │ │ -0003f5f0: 2020 2a20 6566 693a 206c 7365 6669 7379 * efi: lsefisy │ │ │ │ │ -0003f600: 7374 6162 2c20 6c73 7361 6c2c 206c 7365 stab, lssal, lse │ │ │ │ │ -0003f610: 6669 6d6d 6170 2c20 6c73 6566 690a 2020 fimmap, lsefi. │ │ │ │ │ -0003f620: 202a 2069 3338 362d 7063 3a20 6c73 6170 * i386-pc: lsap │ │ │ │ │ -0003f630: 6d0a 2020 202a 2069 3338 362d 636f 7265 m. * i386-core │ │ │ │ │ -0003f640: 626f 6f74 3a20 6c73 636f 7265 626f 6f74 boot: lscoreboot │ │ │ │ │ -0003f650: 2c20 636f 7265 626f 6f74 5f62 6f6f 7474 , coreboot_boott │ │ │ │ │ -0003f660: 696d 652c 2063 626d 656d 630a 2020 202a ime, cbmemc. * │ │ │ │ │ -0003f670: 2061 6370 692d 656e 6162 6c65 6420 2869 acpi-enabled (i │ │ │ │ │ -0003f680: 3338 362d 7063 2c20 6933 3836 2d63 6f72 386-pc, i386-cor │ │ │ │ │ -0003f690: 6562 6f6f 742c 2069 3338 362d 6d75 6c74 eboot, i386-mult │ │ │ │ │ -0003f6a0: 6962 6f6f 742c 202a 2d65 6669 293a 0a20 iboot, *-efi):. │ │ │ │ │ -0003f6b0: 2020 2020 6c73 6163 7069 0a0a 2020 2057 lsacpi.. W │ │ │ │ │ -0003f6c0: 6f72 6b61 726f 756e 6473 2066 6f72 2070 orkarounds for p │ │ │ │ │ -0003f6d0: 6c61 7466 6f72 6d2d 7370 6563 6966 6963 latform-specific │ │ │ │ │ -0003f6e0: 2069 7373 7565 733a 0a20 2020 2a20 6933 issues:. * i3 │ │ │ │ │ -0003f6f0: 3836 2d65 6669 2f78 3836 5f36 342d 6566 86-efi/x86_64-ef │ │ │ │ │ -0003f700: 693a 206c 6f61 6462 696f 732c 2066 616b i: loadbios, fak │ │ │ │ │ -0003f710: 6562 696f 732c 2066 6978 5f76 6964 656f ebios, fix_video │ │ │ │ │ -0003f720: 0a20 2020 2a20 6163 7069 2d65 6e61 626c . * acpi-enabl │ │ │ │ │ -0003f730: 6564 2028 6933 3836 2d70 632c 2069 3338 ed (i386-pc, i38 │ │ │ │ │ -0003f740: 362d 636f 7265 626f 6f74 2c20 6933 3836 6-coreboot, i386 │ │ │ │ │ -0003f750: 2d6d 756c 7469 626f 6f74 2c20 2a2d 6566 -multiboot, *-ef │ │ │ │ │ -0003f760: 6929 3a20 6163 7069 0a20 2020 2020 286f i): acpi. (o │ │ │ │ │ -0003f770: 7665 7272 6964 6520 4143 5049 2074 6162 verride ACPI tab │ │ │ │ │ -0003f780: 6c65 7329 0a20 2020 2a20 6933 3836 2d70 les). * i386-p │ │ │ │ │ -0003f790: 633a 2064 7269 7665 6d61 700a 2020 202a c: drivemap. * │ │ │ │ │ -0003f7a0: 2069 3338 362d 7063 3a20 7365 6e64 6b65 i386-pc: sendke │ │ │ │ │ -0003f7b0: 790a 0a20 2020 4164 7661 6e63 6564 206f y.. Advanced o │ │ │ │ │ -0003f7c0: 7065 7261 7469 6f6e 7320 666f 7220 706f perations for po │ │ │ │ │ -0003f7d0: 7765 7220 7573 6572 733a 0a20 2020 2a20 wer users:. * │ │ │ │ │ -0003f7e0: 7838 363a 2069 6f72 7720 2864 6972 6563 x86: iorw (direc │ │ │ │ │ -0003f7f0: 7420 6163 6365 7373 2074 6f20 492f 4f20 t access to I/O │ │ │ │ │ -0003f800: 706f 7274 7329 0a0a 2020 204d 6973 6365 ports).. Misce │ │ │ │ │ -0003f810: 6c61 6e65 6f75 733a 0a20 2020 2a20 636d laneous:. * cm │ │ │ │ │ -0003f820: 6f73 2028 7838 362d 2a2c 2069 6565 6531 os (x86-*, ieee1 │ │ │ │ │ -0003f830: 3237 352c 206d 6970 732d 7165 6d75 5f6d 275, mips-qemu_m │ │ │ │ │ -0003f840: 6970 732c 206d 6970 732d 6c6f 6f6e 6773 ips, mips-loongs │ │ │ │ │ -0003f850: 6f6e 293a 2063 6d6f 7374 6573 740a 2020 on): cmostest. │ │ │ │ │ -0003f860: 2020 2028 7573 6564 206f 6e20 736f 6d65 (used on some │ │ │ │ │ -0003f870: 206c 6170 746f 7073 2074 6f20 6368 6563 laptops to chec │ │ │ │ │ -0003f880: 6b20 666f 7220 7370 6563 6961 6c20 706f k for special po │ │ │ │ │ -0003f890: 7765 722d 6f6e 206b 6579 292c 2063 6d6f wer-on key), cmo │ │ │ │ │ -0003f8a0: 7363 6c65 616e 0a20 2020 2a20 6933 3836 sclean. * i386 │ │ │ │ │ -0003f8b0: 2d70 633a 2070 6c61 790a 0a1f 0a46 696c -pc: play....Fil │ │ │ │ │ -0003f8c0: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ -0003f8d0: 6f64 653a 2053 7570 706f 7274 6564 206b ode: Supported k │ │ │ │ │ -0003f8e0: 6572 6e65 6c73 2c20 204e 6578 743a 2054 ernels, Next: T │ │ │ │ │ -0003f8f0: 726f 7562 6c65 7368 6f6f 7469 6e67 2c20 roubleshooting, │ │ │ │ │ -0003f900: 2050 7265 763a 2050 6c61 7466 6f72 6d2d Prev: Platform- │ │ │ │ │ -0003f910: 7370 6563 6966 6963 206f 7065 7261 7469 specific operati │ │ │ │ │ -0003f920: 6f6e 732c 2020 5570 3a20 546f 700a 0a32 ons, Up: Top..2 │ │ │ │ │ -0003f930: 3120 5375 7070 6f72 7465 6420 626f 6f74 1 Supported boot │ │ │ │ │ -0003f940: 2074 6172 6765 7473 0a2a 2a2a 2a2a 2a2a targets.******* │ │ │ │ │ +0003ec80: 2020 2020 2020 2020 2020 6967 6e6f 7265 ignore │ │ │ │ │ +0003ec90: 640a 0a20 2020 2020 2020 2020 2020 2020 d.. │ │ │ │ │ +0003eca0: 2020 4c6f 6f6e 6773 6f6e 2020 2020 2020 Loongson │ │ │ │ │ +0003ecb0: 2073 7061 7263 3634 2020 2020 2020 2020 sparc64 │ │ │ │ │ +0003ecc0: 506f 7765 7270 6320 2020 2020 2020 2041 Powerpc A │ │ │ │ │ +0003ecd0: 5243 0a76 6964 656f 2020 2020 2020 2020 RC.video │ │ │ │ │ +0003ece0: 2020 7965 7320 2020 2020 2020 2020 2020 yes │ │ │ │ │ +0003ecf0: 206e 6f20 2020 2020 2020 2020 2020 2020 no │ │ │ │ │ +0003ed00: 7965 7320 2020 2020 2020 2020 2020 206e yes n │ │ │ │ │ +0003ed10: 6f0a 636f 6e73 6f6c 6520 2020 2020 2020 o.console │ │ │ │ │ +0003ed20: 204e 2f41 2020 2020 2020 2020 2020 2020 N/A │ │ │ │ │ +0003ed30: 4153 4349 4920 2020 2020 2020 2020 2041 ASCII A │ │ │ │ │ +0003ed40: 5343 4949 2020 2020 2020 2020 2020 4153 SCII AS │ │ │ │ │ +0003ed50: 4349 490a 6368 6172 7365 740a 6e65 7477 CII.charset.netw │ │ │ │ │ +0003ed60: 6f72 6b20 2020 2020 2020 206e 6f20 2020 ork no │ │ │ │ │ +0003ed70: 2020 2020 2020 2020 2020 7965 7320 282a yes (* │ │ │ │ │ +0003ed80: 2920 2020 2020 2020 2079 6573 2020 2020 ) yes │ │ │ │ │ +0003ed90: 2020 2020 2020 2020 6e6f 0a41 5441 2f41 no.ATA/A │ │ │ │ │ +0003eda0: 4843 4920 2020 2020 2020 7965 7320 2020 HCI yes │ │ │ │ │ +0003edb0: 2020 2020 2020 2020 206e 6f20 2020 2020 no │ │ │ │ │ +0003edc0: 2020 2020 2020 2020 6e6f 2020 2020 2020 no │ │ │ │ │ +0003edd0: 2020 2020 2020 206e 6f0a 4154 206b 6579 no.AT key │ │ │ │ │ +0003ede0: 626f 6172 6420 2020 2079 6573 2020 2020 board yes │ │ │ │ │ +0003edf0: 2020 2020 2020 2020 6e6f 2020 2020 2020 no │ │ │ │ │ +0003ee00: 2020 2020 2020 206e 6f20 2020 2020 2020 no │ │ │ │ │ +0003ee10: 2020 2020 2020 6e6f 0a53 7065 616b 6572 no.Speaker │ │ │ │ │ +0003ee20: 2020 2020 2020 2020 6e6f 2020 2020 2020 no │ │ │ │ │ +0003ee30: 2020 2020 2020 206e 6f20 2020 2020 2020 no │ │ │ │ │ +0003ee40: 2020 2020 2020 6e6f 2020 2020 2020 2020 no │ │ │ │ │ +0003ee50: 2020 2020 206e 6f0a 5553 4220 2020 2020 no.USB │ │ │ │ │ +0003ee60: 2020 2020 2020 2079 6573 2020 2020 2020 yes │ │ │ │ │ +0003ee70: 2020 2020 2020 6e6f 2020 2020 2020 2020 no │ │ │ │ │ +0003ee80: 2020 2020 206e 6f20 2020 2020 2020 2020 no │ │ │ │ │ +0003ee90: 2020 2020 6e6f 0a63 6861 696e 6c6f 6164 no.chainload │ │ │ │ │ +0003eea0: 6572 2020 2020 7965 7320 2020 2020 2020 er yes │ │ │ │ │ +0003eeb0: 2020 2020 206e 6f20 2020 2020 2020 2020 no │ │ │ │ │ +0003eec0: 2020 2020 6e6f 2020 2020 2020 2020 2020 no │ │ │ │ │ +0003eed0: 2020 206e 6f0a 6370 7569 6420 2020 2020 no.cpuid │ │ │ │ │ +0003eee0: 2020 2020 206e 6f20 2020 2020 2020 2020 no │ │ │ │ │ +0003eef0: 2020 2020 6e6f 2020 2020 2020 2020 2020 no │ │ │ │ │ +0003ef00: 2020 206e 6f20 2020 2020 2020 2020 2020 no │ │ │ │ │ +0003ef10: 2020 6e6f 0a72 646d 7372 2020 2020 2020 no.rdmsr │ │ │ │ │ +0003ef20: 2020 2020 6e6f 2020 2020 2020 2020 2020 no │ │ │ │ │ +0003ef30: 2020 206e 6f20 2020 2020 2020 2020 2020 no │ │ │ │ │ +0003ef40: 2020 6e6f 2020 2020 2020 2020 2020 2020 no │ │ │ │ │ +0003ef50: 206e 6f0a 7772 6d73 7220 2020 2020 2020 no.wrmsr │ │ │ │ │ +0003ef60: 2020 206e 6f20 2020 2020 2020 2020 2020 no │ │ │ │ │ +0003ef70: 2020 6e6f 2020 2020 2020 2020 2020 2020 no │ │ │ │ │ +0003ef80: 206e 6f20 2020 2020 2020 2020 2020 2020 no │ │ │ │ │ +0003ef90: 6e6f 0a68 696e 7473 2020 2020 2020 2020 no.hints │ │ │ │ │ +0003efa0: 2020 676f 6f64 2020 2020 2020 2020 2020 good │ │ │ │ │ +0003efb0: 2067 6f6f 6420 2020 2020 2020 2020 2020 good │ │ │ │ │ +0003efc0: 676f 6f64 2020 2020 2020 2020 2020 206e good n │ │ │ │ │ +0003efd0: 6f0a 5043 4920 2020 2020 2020 2020 2020 o.PCI │ │ │ │ │ +0003efe0: 2079 6573 2020 2020 2020 2020 2020 2020 yes │ │ │ │ │ +0003eff0: 6e6f 2020 2020 2020 2020 2020 2020 206e no n │ │ │ │ │ +0003f000: 6f20 2020 2020 2020 2020 2020 2020 6e6f o no │ │ │ │ │ +0003f010: 0a62 6164 7261 6d20 2020 2020 2020 2020 .badram │ │ │ │ │ +0003f020: 7965 7320 282a 2920 2020 2020 2020 206e yes (*) n │ │ │ │ │ +0003f030: 6f20 2020 2020 2020 2020 2020 2020 6e6f o no │ │ │ │ │ +0003f040: 2020 2020 2020 2020 2020 2020 206e 6f0a no. │ │ │ │ │ +0003f050: 636f 6d70 7265 7373 696f 6e20 2020 2063 compression c │ │ │ │ │ +0003f060: 6f6e 6669 6775 7261 626c 6520 2020 6e6f onfigurable no │ │ │ │ │ +0003f070: 2020 2020 2020 2020 2020 2020 206e 6f20 no │ │ │ │ │ +0003f080: 2020 2020 2020 2020 2020 2020 636f 6e66 conf │ │ │ │ │ +0003f090: 6967 7572 6162 6c65 0a65 7869 7420 2020 igurable.exit │ │ │ │ │ +0003f0a0: 2020 2020 2020 2020 6e6f 2020 2020 2020 no │ │ │ │ │ +0003f0b0: 2020 2020 2020 2079 6573 2020 2020 2020 yes │ │ │ │ │ +0003f0c0: 2020 2020 2020 7965 7320 2020 2020 2020 yes │ │ │ │ │ +0003f0d0: 2020 2020 2079 6573 0a62 6f6f 746c 6f63 yes.bootloc │ │ │ │ │ +0003f0e0: 6174 696f 6e20 2020 6e6f 2020 2020 2020 ation no │ │ │ │ │ +0003f0f0: 2020 2020 2020 2070 6172 7469 7469 6f6e partition │ │ │ │ │ +0003f100: 2020 2020 2020 6669 6c65 2020 2020 2020 file │ │ │ │ │ +0003f110: 2020 2020 2066 696c 6520 282a 290a 0a20 file (*).. │ │ │ │ │ +0003f120: 2020 2020 2020 2020 2020 2020 2020 4d49 MI │ │ │ │ │ +0003f130: 5053 2071 656d 7520 2020 2020 2065 6d75 PS qemu emu │ │ │ │ │ +0003f140: 2020 2020 2020 2020 2020 2020 7865 6e0a xen. │ │ │ │ │ +0003f150: 7669 6465 6f20 2020 2020 2020 2020 206e video n │ │ │ │ │ +0003f160: 6f20 2020 2020 2020 2020 2020 2020 7965 o ye │ │ │ │ │ +0003f170: 7320 2020 2020 2020 2020 2020 206e 6f0a s no. │ │ │ │ │ +0003f180: 636f 6e73 6f6c 6520 2020 2020 2020 2043 console C │ │ │ │ │ +0003f190: 5034 3337 2020 2020 2020 2020 2020 556e P437 Un │ │ │ │ │ +0003f1a0: 6963 6f64 6520 282a 2920 2020 2041 5343 icode (*) ASC │ │ │ │ │ +0003f1b0: 4949 0a63 6861 7273 6574 0a6e 6574 776f II.charset.netwo │ │ │ │ │ +0003f1c0: 726b 2020 2020 2020 2020 6e6f 2020 2020 rk no │ │ │ │ │ +0003f1d0: 2020 2020 2020 2020 2079 6573 2020 2020 yes │ │ │ │ │ +0003f1e0: 2020 2020 2020 2020 6e6f 0a41 5441 2f41 no.ATA/A │ │ │ │ │ +0003f1f0: 4843 4920 2020 2020 2020 7965 7320 2020 HCI yes │ │ │ │ │ +0003f200: 2020 2020 2020 2020 206e 6f20 2020 2020 no │ │ │ │ │ +0003f210: 2020 2020 2020 2020 6e6f 0a41 5420 6b65 no.AT ke │ │ │ │ │ +0003f220: 7962 6f61 7264 2020 2020 7965 7320 2020 yboard yes │ │ │ │ │ +0003f230: 2020 2020 2020 2020 206e 6f20 2020 2020 no │ │ │ │ │ +0003f240: 2020 2020 2020 2020 6e6f 0a53 7065 616b no.Speak │ │ │ │ │ +0003f250: 6572 2020 2020 2020 2020 6e6f 2020 2020 er no │ │ │ │ │ +0003f260: 2020 2020 2020 2020 206e 6f20 2020 2020 no │ │ │ │ │ +0003f270: 2020 2020 2020 2020 6e6f 0a55 5342 2020 no.USB │ │ │ │ │ +0003f280: 2020 2020 2020 2020 2020 4e2f 4120 2020 N/A │ │ │ │ │ +0003f290: 2020 2020 2020 2020 2079 6573 2020 2020 yes │ │ │ │ │ +0003f2a0: 2020 2020 2020 2020 6e6f 0a63 6861 696e no.chain │ │ │ │ │ +0003f2b0: 6c6f 6164 6572 2020 2020 7965 7320 2020 loader yes │ │ │ │ │ +0003f2c0: 2020 2020 2020 2020 206e 6f20 2020 2020 no │ │ │ │ │ +0003f2d0: 2020 2020 2020 2020 7965 730a 6370 7569 yes.cpui │ │ │ │ │ +0003f2e0: 6420 2020 2020 2020 2020 206e 6f20 2020 d no │ │ │ │ │ +0003f2f0: 2020 2020 2020 2020 2020 6e6f 2020 2020 no │ │ │ │ │ +0003f300: 2020 2020 2020 2020 2079 6573 0a72 646d yes.rdm │ │ │ │ │ +0003f310: 7372 2020 2020 2020 2020 2020 6e6f 2020 sr no │ │ │ │ │ +0003f320: 2020 2020 2020 2020 2020 206e 6f20 2020 no │ │ │ │ │ +0003f330: 2020 2020 2020 2020 2020 7965 730a 7772 yes.wr │ │ │ │ │ +0003f340: 6d73 7220 2020 2020 2020 2020 206e 6f20 msr no │ │ │ │ │ +0003f350: 2020 2020 2020 2020 2020 2020 6e6f 2020 no │ │ │ │ │ +0003f360: 2020 2020 2020 2020 2020 2079 6573 0a68 yes.h │ │ │ │ │ +0003f370: 696e 7473 2020 2020 2020 2020 2020 6775 ints gu │ │ │ │ │ +0003f380: 6573 7320 2020 2020 2020 2020 206e 6f20 ess no │ │ │ │ │ +0003f390: 2020 2020 2020 2020 2020 2020 6e6f 0a50 no.P │ │ │ │ │ +0003f3a0: 4349 2020 2020 2020 2020 2020 2020 6e6f CI no │ │ │ │ │ +0003f3b0: 2020 2020 2020 2020 2020 2020 206e 6f20 no │ │ │ │ │ +0003f3c0: 2020 2020 2020 2020 2020 2020 6e6f 0a62 no.b │ │ │ │ │ +0003f3d0: 6164 7261 6d20 2020 2020 2020 2020 7965 adram ye │ │ │ │ │ +0003f3e0: 7320 282a 2920 2020 2020 2020 206e 6f20 s (*) no │ │ │ │ │ +0003f3f0: 2020 2020 2020 2020 2020 2020 6e6f 0a63 no.c │ │ │ │ │ +0003f400: 6f6d 7072 6573 7369 6f6e 2020 2020 636f ompression co │ │ │ │ │ +0003f410: 6e66 6967 7572 6162 6c65 2020 206e 6f20 nfigurable no │ │ │ │ │ +0003f420: 2020 2020 2020 2020 2020 2020 6e6f 0a65 no.e │ │ │ │ │ +0003f430: 7869 7420 2020 2020 2020 2020 2020 6e6f xit no │ │ │ │ │ +0003f440: 2020 2020 2020 2020 2020 2020 2079 6573 yes │ │ │ │ │ +0003f450: 2020 2020 2020 2020 2020 2020 6e6f 0a62 no.b │ │ │ │ │ +0003f460: 6f6f 746c 6f63 6174 696f 6e20 2020 6e6f ootlocation no │ │ │ │ │ +0003f470: 2020 2020 2020 2020 2020 2020 2066 696c fil │ │ │ │ │ +0003f480: 6520 2020 2020 2020 2020 2020 6e6f 0a0a e no.. │ │ │ │ │ +0003f490: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ +0003f4a0: 6f2c 2020 4e6f 6465 3a20 506c 6174 666f o, Node: Platfo │ │ │ │ │ +0003f4b0: 726d 2d73 7065 6369 6669 6320 6f70 6572 rm-specific oper │ │ │ │ │ +0003f4c0: 6174 696f 6e73 2c20 204e 6578 743a 2053 ations, Next: S │ │ │ │ │ +0003f4d0: 7570 706f 7274 6564 206b 6572 6e65 6c73 upported kernels │ │ │ │ │ +0003f4e0: 2c20 2050 7265 763a 2050 6c61 7466 6f72 , Prev: Platfor │ │ │ │ │ +0003f4f0: 6d20 6c69 6d69 7461 7469 6f6e 732c 2020 m limitations, │ │ │ │ │ +0003f500: 5570 3a20 546f 700a 0a32 3020 4f75 746c Up: Top..20 Outl │ │ │ │ │ +0003f510: 696e 650a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a ine.**********.. │ │ │ │ │ +0003f520: 536f 6d65 2070 6c61 7466 6f72 6d73 2068 Some platforms h │ │ │ │ │ +0003f530: 6176 6520 6665 6174 7572 6573 2077 6869 ave features whi │ │ │ │ │ +0003f540: 6368 2061 6c6c 6f77 7320 746f 2069 6d70 ch allows to imp │ │ │ │ │ +0003f550: 6c65 6d65 6e74 2073 6f6d 6520 636f 6d6d lement some comm │ │ │ │ │ +0003f560: 616e 6473 0a75 7365 6c65 7373 206f 7220 ands.useless or │ │ │ │ │ +0003f570: 6e6f 7420 696d 706c 656d 656e 7461 626c not implementabl │ │ │ │ │ +0003f580: 6520 6f6e 206f 7468 6572 732e 0a0a 2020 e on others... │ │ │ │ │ +0003f590: 2051 7569 636b 2073 756d 6d61 7279 3a0a Quick summary:. │ │ │ │ │ +0003f5a0: 0a20 2020 496e 666f 726d 6174 696f 6e20 . Information │ │ │ │ │ +0003f5b0: 7265 7472 6965 7661 6c3a 0a0a 2020 202a retrieval:.. * │ │ │ │ │ +0003f5c0: 206d 6970 7365 6c2d 6c6f 6f6e 6773 6f6e mipsel-loongson │ │ │ │ │ +0003f5d0: 3a20 6c73 7370 640a 2020 202a 206d 6970 : lsspd. * mip │ │ │ │ │ +0003f5e0: 732d 6172 633a 206c 7364 6576 0a20 2020 s-arc: lsdev. │ │ │ │ │ +0003f5f0: 2a20 6566 693a 206c 7365 6669 7379 7374 * efi: lsefisyst │ │ │ │ │ +0003f600: 6162 2c20 6c73 7361 6c2c 206c 7365 6669 ab, lssal, lsefi │ │ │ │ │ +0003f610: 6d6d 6170 2c20 6c73 6566 690a 2020 202a mmap, lsefi. * │ │ │ │ │ +0003f620: 2069 3338 362d 7063 3a20 6c73 6170 6d0a i386-pc: lsapm. │ │ │ │ │ +0003f630: 2020 202a 2069 3338 362d 636f 7265 626f * i386-corebo │ │ │ │ │ +0003f640: 6f74 3a20 6c73 636f 7265 626f 6f74 2c20 ot: lscoreboot, │ │ │ │ │ +0003f650: 636f 7265 626f 6f74 5f62 6f6f 7474 696d coreboot_boottim │ │ │ │ │ +0003f660: 652c 2063 626d 656d 630a 2020 202a 2061 e, cbmemc. * a │ │ │ │ │ +0003f670: 6370 692d 656e 6162 6c65 6420 2869 3338 cpi-enabled (i38 │ │ │ │ │ +0003f680: 362d 7063 2c20 6933 3836 2d63 6f72 6562 6-pc, i386-coreb │ │ │ │ │ +0003f690: 6f6f 742c 2069 3338 362d 6d75 6c74 6962 oot, i386-multib │ │ │ │ │ +0003f6a0: 6f6f 742c 202a 2d65 6669 293a 0a20 2020 oot, *-efi):. │ │ │ │ │ +0003f6b0: 2020 6c73 6163 7069 0a0a 2020 2057 6f72 lsacpi.. Wor │ │ │ │ │ +0003f6c0: 6b61 726f 756e 6473 2066 6f72 2070 6c61 karounds for pla │ │ │ │ │ +0003f6d0: 7466 6f72 6d2d 7370 6563 6966 6963 2069 tform-specific i │ │ │ │ │ +0003f6e0: 7373 7565 733a 0a20 2020 2a20 6933 3836 ssues:. * i386 │ │ │ │ │ +0003f6f0: 2d65 6669 2f78 3836 5f36 342d 6566 693a -efi/x86_64-efi: │ │ │ │ │ +0003f700: 206c 6f61 6462 696f 732c 2066 616b 6562 loadbios, fakeb │ │ │ │ │ +0003f710: 696f 732c 2066 6978 5f76 6964 656f 0a20 ios, fix_video. │ │ │ │ │ +0003f720: 2020 2a20 6163 7069 2d65 6e61 626c 6564 * acpi-enabled │ │ │ │ │ +0003f730: 2028 6933 3836 2d70 632c 2069 3338 362d (i386-pc, i386- │ │ │ │ │ +0003f740: 636f 7265 626f 6f74 2c20 6933 3836 2d6d coreboot, i386-m │ │ │ │ │ +0003f750: 756c 7469 626f 6f74 2c20 2a2d 6566 6929 ultiboot, *-efi) │ │ │ │ │ +0003f760: 3a20 6163 7069 0a20 2020 2020 286f 7665 : acpi. (ove │ │ │ │ │ +0003f770: 7272 6964 6520 4143 5049 2074 6162 6c65 rride ACPI table │ │ │ │ │ +0003f780: 7329 0a20 2020 2a20 6933 3836 2d70 633a s). * i386-pc: │ │ │ │ │ +0003f790: 2064 7269 7665 6d61 700a 2020 202a 2069 drivemap. * i │ │ │ │ │ +0003f7a0: 3338 362d 7063 3a20 7365 6e64 6b65 790a 386-pc: sendkey. │ │ │ │ │ +0003f7b0: 0a20 2020 4164 7661 6e63 6564 206f 7065 . Advanced ope │ │ │ │ │ +0003f7c0: 7261 7469 6f6e 7320 666f 7220 706f 7765 rations for powe │ │ │ │ │ +0003f7d0: 7220 7573 6572 733a 0a20 2020 2a20 7838 r users:. * x8 │ │ │ │ │ +0003f7e0: 363a 2069 6f72 7720 2864 6972 6563 7420 6: iorw (direct │ │ │ │ │ +0003f7f0: 6163 6365 7373 2074 6f20 492f 4f20 706f access to I/O po │ │ │ │ │ +0003f800: 7274 7329 0a0a 2020 204d 6973 6365 6c61 rts).. Miscela │ │ │ │ │ +0003f810: 6e65 6f75 733a 0a20 2020 2a20 636d 6f73 neous:. * cmos │ │ │ │ │ +0003f820: 2028 7838 362d 2a2c 2069 6565 6531 3237 (x86-*, ieee127 │ │ │ │ │ +0003f830: 352c 206d 6970 732d 7165 6d75 5f6d 6970 5, mips-qemu_mip │ │ │ │ │ +0003f840: 732c 206d 6970 732d 6c6f 6f6e 6773 6f6e s, mips-loongson │ │ │ │ │ +0003f850: 293a 2063 6d6f 7374 6573 740a 2020 2020 ): cmostest. │ │ │ │ │ +0003f860: 2028 7573 6564 206f 6e20 736f 6d65 206c (used on some l │ │ │ │ │ +0003f870: 6170 746f 7073 2074 6f20 6368 6563 6b20 aptops to check │ │ │ │ │ +0003f880: 666f 7220 7370 6563 6961 6c20 706f 7765 for special powe │ │ │ │ │ +0003f890: 722d 6f6e 206b 6579 292c 2063 6d6f 7363 r-on key), cmosc │ │ │ │ │ +0003f8a0: 6c65 616e 0a20 2020 2a20 6933 3836 2d70 lean. * i386-p │ │ │ │ │ +0003f8b0: 633a 2070 6c61 790a 0a1f 0a46 696c 653a c: play....File: │ │ │ │ │ +0003f8c0: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ +0003f8d0: 653a 2053 7570 706f 7274 6564 206b 6572 e: Supported ker │ │ │ │ │ +0003f8e0: 6e65 6c73 2c20 204e 6578 743a 2054 726f nels, Next: Tro │ │ │ │ │ +0003f8f0: 7562 6c65 7368 6f6f 7469 6e67 2c20 2050 ubleshooting, P │ │ │ │ │ +0003f900: 7265 763a 2050 6c61 7466 6f72 6d2d 7370 rev: Platform-sp │ │ │ │ │ +0003f910: 6563 6966 6963 206f 7065 7261 7469 6f6e ecific operation │ │ │ │ │ +0003f920: 732c 2020 5570 3a20 546f 700a 0a32 3120 s, Up: Top..21 │ │ │ │ │ +0003f930: 5375 7070 6f72 7465 6420 626f 6f74 2074 Supported boot t │ │ │ │ │ +0003f940: 6172 6765 7473 0a2a 2a2a 2a2a 2a2a 2a2a argets.********* │ │ │ │ │ 0003f950: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -0003f960: 2a2a 0a0a 5838 3620 7375 7070 6f72 7420 **..X86 support │ │ │ │ │ -0003f970: 6973 2073 756d 6d61 7269 7365 6420 696e is summarised in │ │ │ │ │ -0003f980: 2074 6865 2066 6f6c 6c6f 7769 6e67 2074 the following t │ │ │ │ │ -0003f990: 6162 6c65 2e20 2022 5965 7322 206d 6561 able. "Yes" mea │ │ │ │ │ -0003f9a0: 6e73 2074 6861 7420 7468 650a 6b65 726e ns that the.kern │ │ │ │ │ -0003f9b0: 656c 2077 6f72 6b73 206f 6e20 7468 6520 el works on the │ │ │ │ │ -0003f9c0: 6769 7665 6e20 706c 6174 666f 726d 2c20 given platform, │ │ │ │ │ -0003f9d0: 2263 7261 7368 6573 2220 6d65 616e 7320 "crashes" means │ │ │ │ │ -0003f9e0: 616e 2065 6172 6c79 206b 6572 6e65 6c0a an early kernel. │ │ │ │ │ -0003f9f0: 6372 6173 6820 7768 6963 6820 7765 2068 crash which we h │ │ │ │ │ -0003fa00: 6f70 6520 7769 6c6c 2062 6520 6669 7865 ope will be fixe │ │ │ │ │ -0003fa10: 6420 6279 2063 6f6e 6365 726e 6564 206b d by concerned k │ │ │ │ │ -0003fa20: 6572 6e65 6c20 6465 7665 6c6f 7065 7273 ernel developers │ │ │ │ │ -0003fa30: 2e20 2022 6e6f 220a 6d65 616e 7320 4752 . "no".means GR │ │ │ │ │ -0003fa40: 5542 2064 6f65 736e 2774 206c 6f61 6420 UB doesn't load │ │ │ │ │ -0003fa50: 7468 6520 6769 7665 6e20 6b65 726e 656c the given kernel │ │ │ │ │ -0003fa60: 206f 6e20 6120 6769 7665 6e20 706c 6174 on a given plat │ │ │ │ │ -0003fa70: 666f 726d 2e0a 2268 6561 646c 6573 7322 form.."headless" │ │ │ │ │ -0003fa80: 206d 6561 6e73 2074 6861 7420 7468 6520 means that the │ │ │ │ │ -0003fa90: 6b65 726e 656c 2077 6f72 6b73 2062 7574 kernel works but │ │ │ │ │ -0003faa0: 206c 6163 6b73 2063 6f6e 736f 6c65 2064 lacks console d │ │ │ │ │ -0003fab0: 7269 7665 7273 2028 796f 750a 6361 6e20 rivers (you.can │ │ │ │ │ -0003fac0: 7374 696c 6c20 7573 6520 7365 7269 616c still use serial │ │ │ │ │ -0003fad0: 206f 7220 6e65 7477 6f72 6b20 636f 6e73 or network cons │ │ │ │ │ -0003fae0: 6f6c 6529 2e20 2049 6e20 6361 7365 206f ole). In case o │ │ │ │ │ -0003faf0: 6620 226e 6f22 2061 6e64 2022 6372 6173 f "no" and "cras │ │ │ │ │ -0003fb00: 6865 7322 0a74 6865 2072 6561 736f 6e20 hes".the reason │ │ │ │ │ -0003fb10: 6973 2067 6976 656e 2069 6e20 666f 6f74 is given in foot │ │ │ │ │ -0003fb20: 6e6f 7465 2e0a 2020 2020 2020 2020 2020 note.. │ │ │ │ │ +0003f960: 0a0a 5838 3620 7375 7070 6f72 7420 6973 ..X86 support is │ │ │ │ │ +0003f970: 2073 756d 6d61 7269 7365 6420 696e 2074 summarised in t │ │ │ │ │ +0003f980: 6865 2066 6f6c 6c6f 7769 6e67 2074 6162 he following tab │ │ │ │ │ +0003f990: 6c65 2e20 2022 5965 7322 206d 6561 6e73 le. "Yes" means │ │ │ │ │ +0003f9a0: 2074 6861 7420 7468 650a 6b65 726e 656c that the.kernel │ │ │ │ │ +0003f9b0: 2077 6f72 6b73 206f 6e20 7468 6520 6769 works on the gi │ │ │ │ │ +0003f9c0: 7665 6e20 706c 6174 666f 726d 2c20 2263 ven platform, "c │ │ │ │ │ +0003f9d0: 7261 7368 6573 2220 6d65 616e 7320 616e rashes" means an │ │ │ │ │ +0003f9e0: 2065 6172 6c79 206b 6572 6e65 6c0a 6372 early kernel.cr │ │ │ │ │ +0003f9f0: 6173 6820 7768 6963 6820 7765 2068 6f70 ash which we hop │ │ │ │ │ +0003fa00: 6520 7769 6c6c 2062 6520 6669 7865 6420 e will be fixed │ │ │ │ │ +0003fa10: 6279 2063 6f6e 6365 726e 6564 206b 6572 by concerned ker │ │ │ │ │ +0003fa20: 6e65 6c20 6465 7665 6c6f 7065 7273 2e20 nel developers. │ │ │ │ │ +0003fa30: 2022 6e6f 220a 6d65 616e 7320 4752 5542 "no".means GRUB │ │ │ │ │ +0003fa40: 2064 6f65 736e 2774 206c 6f61 6420 7468 doesn't load th │ │ │ │ │ +0003fa50: 6520 6769 7665 6e20 6b65 726e 656c 206f e given kernel o │ │ │ │ │ +0003fa60: 6e20 6120 6769 7665 6e20 706c 6174 666f n a given platfo │ │ │ │ │ +0003fa70: 726d 2e0a 2268 6561 646c 6573 7322 206d rm.."headless" m │ │ │ │ │ +0003fa80: 6561 6e73 2074 6861 7420 7468 6520 6b65 eans that the ke │ │ │ │ │ +0003fa90: 726e 656c 2077 6f72 6b73 2062 7574 206c rnel works but l │ │ │ │ │ +0003faa0: 6163 6b73 2063 6f6e 736f 6c65 2064 7269 acks console dri │ │ │ │ │ +0003fab0: 7665 7273 2028 796f 750a 6361 6e20 7374 vers (you.can st │ │ │ │ │ +0003fac0: 696c 6c20 7573 6520 7365 7269 616c 206f ill use serial o │ │ │ │ │ +0003fad0: 7220 6e65 7477 6f72 6b20 636f 6e73 6f6c r network consol │ │ │ │ │ +0003fae0: 6529 2e20 2049 6e20 6361 7365 206f 6620 e). In case of │ │ │ │ │ +0003faf0: 226e 6f22 2061 6e64 2022 6372 6173 6865 "no" and "crashe │ │ │ │ │ +0003fb00: 7322 0a74 6865 2072 6561 736f 6e20 6973 s".the reason is │ │ │ │ │ +0003fb10: 2067 6976 656e 2069 6e20 666f 6f74 6e6f given in footno │ │ │ │ │ +0003fb20: 7465 2e0a 2020 2020 2020 2020 2020 2020 te.. │ │ │ │ │ 0003fb30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003fb40: 2020 2020 2020 2020 2020 2042 494f 5320 BIOS │ │ │ │ │ -0003fb50: 2020 2020 2020 2020 2020 2020 436f 7265 Core │ │ │ │ │ -0003fb60: 626f 6f74 0a42 494f 5320 6368 6169 6e6c boot.BIOS chainl │ │ │ │ │ -0003fb70: 6f61 6469 6e67 2020 2020 2020 2020 2020 oading │ │ │ │ │ -0003fb80: 2020 2020 2020 2020 2020 7965 7320 2020 yes │ │ │ │ │ -0003fb90: 2020 2020 2020 2020 2020 206e 6f20 2831 no (1 │ │ │ │ │ -0003fba0: 290a 4e54 4c44 5220 2020 2020 2020 2020 ).NTLDR │ │ │ │ │ +0003fb40: 2020 2020 2020 2020 2042 494f 5320 2020 BIOS │ │ │ │ │ +0003fb50: 2020 2020 2020 2020 2020 436f 7265 626f Corebo │ │ │ │ │ +0003fb60: 6f74 0a42 494f 5320 6368 6169 6e6c 6f61 ot.BIOS chainloa │ │ │ │ │ +0003fb70: 6469 6e67 2020 2020 2020 2020 2020 2020 ding │ │ │ │ │ +0003fb80: 2020 2020 2020 2020 7965 7320 2020 2020 yes │ │ │ │ │ +0003fb90: 2020 2020 2020 2020 206e 6f20 2831 290a no (1). │ │ │ │ │ +0003fba0: 4e54 4c44 5220 2020 2020 2020 2020 2020 NTLDR │ │ │ │ │ 0003fbb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003fbc0: 2020 2020 2020 2079 6573 2020 2020 2020 yes │ │ │ │ │ -0003fbd0: 2020 2020 2020 2020 6e6f 2028 3129 0a50 no (1).P │ │ │ │ │ -0003fbe0: 6c61 6e39 2020 2020 2020 2020 2020 2020 lan9 │ │ │ │ │ +0003fbc0: 2020 2020 2079 6573 2020 2020 2020 2020 yes │ │ │ │ │ +0003fbd0: 2020 2020 2020 6e6f 2028 3129 0a50 6c61 no (1).Pla │ │ │ │ │ +0003fbe0: 6e39 2020 2020 2020 2020 2020 2020 2020 n9 │ │ │ │ │ 0003fbf0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003fc00: 2020 2020 7965 7320 2020 2020 2020 2020 yes │ │ │ │ │ -0003fc10: 2020 2020 206e 6f20 2831 290a 4672 6565 no (1).Free │ │ │ │ │ -0003fc20: 646f 7320 2020 2020 2020 2020 2020 2020 dos │ │ │ │ │ -0003fc30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003fc40: 2079 6573 2020 2020 2020 2020 2020 2020 yes │ │ │ │ │ -0003fc50: 2020 6e6f 2028 3129 0a46 7265 6542 5344 no (1).FreeBSD │ │ │ │ │ -0003fc60: 2062 6f6f 746c 6f61 6465 7220 2020 2020 bootloader │ │ │ │ │ -0003fc70: 2020 2020 2020 2020 2020 2020 2020 7965 ye │ │ │ │ │ -0003fc80: 7320 2020 2020 2020 2020 2020 2020 2063 s c │ │ │ │ │ -0003fc90: 7261 7368 6573 2028 3129 0a33 322d 6269 rashes (1).32-bi │ │ │ │ │ -0003fca0: 7420 6b46 7265 6542 5344 2020 2020 2020 t kFreeBSD │ │ │ │ │ -0003fcb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003fcc0: 7965 7320 2020 2020 2020 2020 2020 2020 yes │ │ │ │ │ -0003fcd0: 2063 7261 7368 6573 2028 3529 0a36 342d crashes (5).64- │ │ │ │ │ -0003fce0: 6269 7420 6b46 7265 6542 5344 2020 2020 bit kFreeBSD │ │ │ │ │ +0003fc00: 2020 7965 7320 2020 2020 2020 2020 2020 yes │ │ │ │ │ +0003fc10: 2020 206e 6f20 2831 290a 4672 6565 646f no (1).Freedo │ │ │ │ │ +0003fc20: 7320 2020 2020 2020 2020 2020 2020 2020 s │ │ │ │ │ +0003fc30: 2020 2020 2020 2020 2020 2020 2020 2079 y │ │ │ │ │ +0003fc40: 6573 2020 2020 2020 2020 2020 2020 2020 es │ │ │ │ │ +0003fc50: 6e6f 2028 3129 0a46 7265 6542 5344 2062 no (1).FreeBSD b │ │ │ │ │ +0003fc60: 6f6f 746c 6f61 6465 7220 2020 2020 2020 ootloader │ │ │ │ │ +0003fc70: 2020 2020 2020 2020 2020 2020 7965 7320 yes │ │ │ │ │ +0003fc80: 2020 2020 2020 2020 2020 2020 2063 7261 cra │ │ │ │ │ +0003fc90: 7368 6573 2028 3129 0a33 322d 6269 7420 shes (1).32-bit │ │ │ │ │ +0003fca0: 6b46 7265 6542 5344 2020 2020 2020 2020 kFreeBSD │ │ │ │ │ +0003fcb0: 2020 2020 2020 2020 2020 2020 2020 7965 ye │ │ │ │ │ +0003fcc0: 7320 2020 2020 2020 2020 2020 2020 2063 s c │ │ │ │ │ +0003fcd0: 7261 7368 6573 2028 3529 0a36 342d 6269 rashes (5).64-bi │ │ │ │ │ +0003fce0: 7420 6b46 7265 6542 5344 2020 2020 2020 t kFreeBSD │ │ │ │ │ 0003fcf0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003fd00: 2020 7965 7320 2020 2020 2020 2020 2020 yes │ │ │ │ │ -0003fd10: 2020 2063 7261 7368 6573 2028 3529 0a33 crashes (5).3 │ │ │ │ │ -0003fd20: 322d 6269 7420 6b4e 6574 4253 4420 2020 2-bit kNetBSD │ │ │ │ │ +0003fd00: 7965 7320 2020 2020 2020 2020 2020 2020 yes │ │ │ │ │ +0003fd10: 2063 7261 7368 6573 2028 3529 0a33 322d crashes (5).32- │ │ │ │ │ +0003fd20: 6269 7420 6b4e 6574 4253 4420 2020 2020 bit kNetBSD │ │ │ │ │ 0003fd30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003fd40: 2020 2020 7965 7320 2020 2020 2020 2020 yes │ │ │ │ │ -0003fd50: 2020 2020 2063 7261 7368 6573 2028 3129 crashes (1) │ │ │ │ │ -0003fd60: 0a36 342d 6269 7420 6b4e 6574 4253 4420 .64-bit kNetBSD │ │ │ │ │ +0003fd40: 2020 7965 7320 2020 2020 2020 2020 2020 yes │ │ │ │ │ +0003fd50: 2020 2063 7261 7368 6573 2028 3129 0a36 crashes (1).6 │ │ │ │ │ +0003fd60: 342d 6269 7420 6b4e 6574 4253 4420 2020 4-bit kNetBSD │ │ │ │ │ 0003fd70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003fd80: 2020 2020 2020 7965 7320 2020 2020 2020 yes │ │ │ │ │ -0003fd90: 2020 2020 2020 2063 7261 7368 6573 0a33 crashes.3 │ │ │ │ │ -0003fda0: 322d 6269 7420 6b4f 7065 6e42 5344 2020 2-bit kOpenBSD │ │ │ │ │ +0003fd80: 2020 2020 7965 7320 2020 2020 2020 2020 yes │ │ │ │ │ +0003fd90: 2020 2020 2063 7261 7368 6573 0a33 322d crashes.32- │ │ │ │ │ +0003fda0: 6269 7420 6b4f 7065 6e42 5344 2020 2020 bit kOpenBSD │ │ │ │ │ 0003fdb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003fdc0: 2020 2020 7965 7320 2020 2020 2020 2020 yes │ │ │ │ │ -0003fdd0: 2020 2020 2079 6573 0a36 342d 6269 7420 yes.64-bit │ │ │ │ │ -0003fde0: 6b4f 7065 6e42 5344 2020 2020 2020 2020 kOpenBSD │ │ │ │ │ -0003fdf0: 2020 2020 2020 2020 2020 2020 2020 7965 ye │ │ │ │ │ -0003fe00: 7320 2020 2020 2020 2020 2020 2020 2079 s y │ │ │ │ │ -0003fe10: 6573 0a4d 756c 7469 626f 6f74 2020 2020 es.Multiboot │ │ │ │ │ +0003fdc0: 2020 7965 7320 2020 2020 2020 2020 2020 yes │ │ │ │ │ +0003fdd0: 2020 2079 6573 0a36 342d 6269 7420 6b4f yes.64-bit kO │ │ │ │ │ +0003fde0: 7065 6e42 5344 2020 2020 2020 2020 2020 penBSD │ │ │ │ │ +0003fdf0: 2020 2020 2020 2020 2020 2020 7965 7320 yes │ │ │ │ │ +0003fe00: 2020 2020 2020 2020 2020 2020 2079 6573 yes │ │ │ │ │ +0003fe10: 0a4d 756c 7469 626f 6f74 2020 2020 2020 .Multiboot │ │ │ │ │ 0003fe20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003fe30: 2020 2020 2020 2020 7965 7320 2020 2020 yes │ │ │ │ │ -0003fe40: 2020 2020 2020 2020 2079 6573 0a4d 756c yes.Mul │ │ │ │ │ -0003fe50: 7469 626f 6f74 3220 2020 2020 2020 2020 tiboot2 │ │ │ │ │ +0003fe30: 2020 2020 2020 7965 7320 2020 2020 2020 yes │ │ │ │ │ +0003fe40: 2020 2020 2020 2079 6573 0a4d 756c 7469 yes.Multi │ │ │ │ │ +0003fe50: 626f 6f74 3220 2020 2020 2020 2020 2020 boot2 │ │ │ │ │ 0003fe60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003fe70: 2020 7965 7320 2020 2020 2020 2020 2020 yes │ │ │ │ │ -0003fe80: 2020 2079 6573 0a33 322d 6269 7420 4c69 yes.32-bit Li │ │ │ │ │ -0003fe90: 6e75 7820 286c 6567 6163 7920 7072 6f74 nux (legacy prot │ │ │ │ │ -0003fea0: 6f63 6f6c 2920 2020 2020 2020 7965 7320 ocol) yes │ │ │ │ │ -0003feb0: 2020 2020 2020 2020 2020 2020 206e 6f20 no │ │ │ │ │ -0003fec0: 2831 290a 3634 2d62 6974 204c 696e 7578 (1).64-bit Linux │ │ │ │ │ -0003fed0: 2028 6c65 6761 6379 2070 726f 746f 636f (legacy protoco │ │ │ │ │ -0003fee0: 6c29 2020 2020 2020 2079 6573 2020 2020 l) yes │ │ │ │ │ -0003fef0: 2020 2020 2020 2020 2020 6e6f 2028 3129 no (1) │ │ │ │ │ -0003ff00: 0a33 322d 6269 7420 4c69 6e75 7820 286d .32-bit Linux (m │ │ │ │ │ -0003ff10: 6f64 6572 6e20 7072 6f74 6f63 6f6c 2920 odern protocol) │ │ │ │ │ -0003ff20: 2020 2020 2020 7965 7320 2020 2020 2020 yes │ │ │ │ │ -0003ff30: 2020 2020 2020 2079 6573 0a36 342d 6269 yes.64-bi │ │ │ │ │ -0003ff40: 7420 4c69 6e75 7820 286d 6f64 6572 6e20 t Linux (modern │ │ │ │ │ -0003ff50: 7072 6f74 6f63 6f6c 2920 2020 2020 2020 protocol) │ │ │ │ │ -0003ff60: 7965 7320 2020 2020 2020 2020 2020 2020 yes │ │ │ │ │ -0003ff70: 2079 6573 0a33 322d 6269 7420 584e 5520 yes.32-bit XNU │ │ │ │ │ +0003fe70: 7965 7320 2020 2020 2020 2020 2020 2020 yes │ │ │ │ │ +0003fe80: 2079 6573 0a33 322d 6269 7420 4c69 6e75 yes.32-bit Linu │ │ │ │ │ +0003fe90: 7820 286c 6567 6163 7920 7072 6f74 6f63 x (legacy protoc │ │ │ │ │ +0003fea0: 6f6c 2920 2020 2020 2020 7965 7320 2020 ol) yes │ │ │ │ │ +0003feb0: 2020 2020 2020 2020 2020 206e 6f20 2831 no (1 │ │ │ │ │ +0003fec0: 290a 3634 2d62 6974 204c 696e 7578 2028 ).64-bit Linux ( │ │ │ │ │ +0003fed0: 6c65 6761 6379 2070 726f 746f 636f 6c29 legacy protocol) │ │ │ │ │ +0003fee0: 2020 2020 2020 2079 6573 2020 2020 2020 yes │ │ │ │ │ +0003fef0: 2020 2020 2020 2020 6e6f 2028 3129 0a33 no (1).3 │ │ │ │ │ +0003ff00: 322d 6269 7420 4c69 6e75 7820 286d 6f64 2-bit Linux (mod │ │ │ │ │ +0003ff10: 6572 6e20 7072 6f74 6f63 6f6c 2920 2020 ern protocol) │ │ │ │ │ +0003ff20: 2020 2020 7965 7320 2020 2020 2020 2020 yes │ │ │ │ │ +0003ff30: 2020 2020 2079 6573 0a36 342d 6269 7420 yes.64-bit │ │ │ │ │ +0003ff40: 4c69 6e75 7820 286d 6f64 6572 6e20 7072 Linux (modern pr │ │ │ │ │ +0003ff50: 6f74 6f63 6f6c 2920 2020 2020 2020 7965 otocol) ye │ │ │ │ │ +0003ff60: 7320 2020 2020 2020 2020 2020 2020 2079 s y │ │ │ │ │ +0003ff70: 6573 0a33 322d 6269 7420 584e 5520 2020 es.32-bit XNU │ │ │ │ │ 0003ff80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003ff90: 2020 2020 2020 2020 2020 7965 7320 2020 yes │ │ │ │ │ -0003ffa0: 2020 2020 2020 2020 2020 203f 0a36 342d ?.64- │ │ │ │ │ -0003ffb0: 6269 7420 584e 5520 2020 2020 2020 2020 bit XNU │ │ │ │ │ +0003ff90: 2020 2020 2020 2020 7965 7320 2020 2020 yes │ │ │ │ │ +0003ffa0: 2020 2020 2020 2020 203f 0a36 342d 6269 ?.64-bi │ │ │ │ │ +0003ffb0: 7420 584e 5520 2020 2020 2020 2020 2020 t XNU │ │ │ │ │ 0003ffc0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003ffd0: 2020 7965 7320 2020 2020 2020 2020 2020 yes │ │ │ │ │ -0003ffe0: 2020 203f 0a33 322d 6269 7420 4546 4920 ?.32-bit EFI │ │ │ │ │ -0003fff0: 6368 6169 6e6c 6f61 6465 7220 2020 2020 chainloader │ │ │ │ │ -00040000: 2020 2020 2020 2020 2020 6e6f 2028 3229 no (2) │ │ │ │ │ -00040010: 2020 2020 2020 2020 2020 206e 6f20 2832 no (2 │ │ │ │ │ -00040020: 290a 3634 2d62 6974 2045 4649 2063 6861 ).64-bit EFI cha │ │ │ │ │ -00040030: 696e 6c6f 6164 6572 2020 2020 2020 2020 inloader │ │ │ │ │ -00040040: 2020 2020 2020 206e 6f20 2832 2920 2020 no (2) │ │ │ │ │ -00040050: 2020 2020 2020 2020 6e6f 2028 3229 0a41 no (2).A │ │ │ │ │ -00040060: 7070 6c65 6c6f 6164 6572 2020 2020 2020 ppleloader │ │ │ │ │ +0003ffd0: 7965 7320 2020 2020 2020 2020 2020 2020 yes │ │ │ │ │ +0003ffe0: 203f 0a33 322d 6269 7420 4546 4920 6368 ?.32-bit EFI ch │ │ │ │ │ +0003fff0: 6169 6e6c 6f61 6465 7220 2020 2020 2020 ainloader │ │ │ │ │ +00040000: 2020 2020 2020 2020 6e6f 2028 3229 2020 no (2) │ │ │ │ │ +00040010: 2020 2020 2020 2020 206e 6f20 2832 290a no (2). │ │ │ │ │ +00040020: 3634 2d62 6974 2045 4649 2063 6861 696e 64-bit EFI chain │ │ │ │ │ +00040030: 6c6f 6164 6572 2020 2020 2020 2020 2020 loader │ │ │ │ │ +00040040: 2020 2020 206e 6f20 2832 2920 2020 2020 no (2) │ │ │ │ │ +00040050: 2020 2020 2020 6e6f 2028 3229 0a41 7070 no (2).App │ │ │ │ │ +00040060: 6c65 6c6f 6164 6572 2020 2020 2020 2020 leloader │ │ │ │ │ 00040070: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040080: 2020 2020 6e6f 2028 3229 2020 2020 2020 no (2) │ │ │ │ │ -00040090: 2020 2020 206e 6f20 2832 290a 0a20 2020 no (2).. │ │ │ │ │ +00040080: 2020 6e6f 2028 3229 2020 2020 2020 2020 no (2) │ │ │ │ │ +00040090: 2020 206e 6f20 2832 290a 0a20 2020 2020 no (2).. │ │ │ │ │ 000400a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000400b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000400c0: 2020 4d75 6c74 6962 6f6f 7420 2020 2020 Multiboot │ │ │ │ │ -000400d0: 2020 2051 656d 750a 4249 4f53 2063 6861 Qemu.BIOS cha │ │ │ │ │ -000400e0: 696e 6c6f 6164 696e 6720 2020 2020 2020 inloading │ │ │ │ │ -000400f0: 2020 2020 2020 2020 2020 2020 206e 6f20 no │ │ │ │ │ -00040100: 2831 2920 2020 2020 2020 2020 2020 6e6f (1) no │ │ │ │ │ -00040110: 2028 3129 0a4e 544c 4452 2020 2020 2020 (1).NTLDR │ │ │ │ │ +000400c0: 4d75 6c74 6962 6f6f 7420 2020 2020 2020 Multiboot │ │ │ │ │ +000400d0: 2051 656d 750a 4249 4f53 2063 6861 696e Qemu.BIOS chain │ │ │ │ │ +000400e0: 6c6f 6164 696e 6720 2020 2020 2020 2020 loading │ │ │ │ │ +000400f0: 2020 2020 2020 2020 2020 206e 6f20 2831 no (1 │ │ │ │ │ +00040100: 2920 2020 2020 2020 2020 2020 6e6f 2028 ) no ( │ │ │ │ │ +00040110: 3129 0a4e 544c 4452 2020 2020 2020 2020 1).NTLDR │ │ │ │ │ 00040120: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040130: 2020 2020 2020 2020 2020 6e6f 2028 3129 no (1) │ │ │ │ │ -00040140: 2020 2020 2020 2020 2020 206e 6f20 2831 no (1 │ │ │ │ │ -00040150: 290a 506c 616e 3920 2020 2020 2020 2020 ).Plan9 │ │ │ │ │ +00040130: 2020 2020 2020 2020 6e6f 2028 3129 2020 no (1) │ │ │ │ │ +00040140: 2020 2020 2020 2020 206e 6f20 2831 290a no (1). │ │ │ │ │ +00040150: 506c 616e 3920 2020 2020 2020 2020 2020 Plan9 │ │ │ │ │ 00040160: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040170: 2020 2020 2020 206e 6f20 2831 2920 2020 no (1) │ │ │ │ │ -00040180: 2020 2020 2020 2020 6e6f 2028 3129 0a46 no (1).F │ │ │ │ │ -00040190: 7265 6544 4f53 2020 2020 2020 2020 2020 reeDOS │ │ │ │ │ +00040170: 2020 2020 206e 6f20 2831 2920 2020 2020 no (1) │ │ │ │ │ +00040180: 2020 2020 2020 6e6f 2028 3129 0a46 7265 no (1).Fre │ │ │ │ │ +00040190: 6544 4f53 2020 2020 2020 2020 2020 2020 eDOS │ │ │ │ │ 000401a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000401b0: 2020 2020 6e6f 2028 3129 2020 2020 2020 no (1) │ │ │ │ │ -000401c0: 2020 2020 206e 6f20 2831 290a 4672 6565 no (1).Free │ │ │ │ │ -000401d0: 4253 4420 626f 6f74 6c6f 6164 6572 2020 BSD bootloader │ │ │ │ │ -000401e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000401f0: 2063 7261 7368 6573 2028 3129 2020 2020 crashes (1) │ │ │ │ │ -00040200: 2020 6372 6173 6865 7320 2831 290a 3332 crashes (1).32 │ │ │ │ │ -00040210: 2d62 6974 206b 4672 6565 4253 4420 2020 -bit kFreeBSD │ │ │ │ │ +000401b0: 2020 6e6f 2028 3129 2020 2020 2020 2020 no (1) │ │ │ │ │ +000401c0: 2020 206e 6f20 2831 290a 4672 6565 4253 no (1).FreeBS │ │ │ │ │ +000401d0: 4420 626f 6f74 6c6f 6164 6572 2020 2020 D bootloader │ │ │ │ │ +000401e0: 2020 2020 2020 2020 2020 2020 2020 2063 c │ │ │ │ │ +000401f0: 7261 7368 6573 2028 3129 2020 2020 2020 rashes (1) │ │ │ │ │ +00040200: 6372 6173 6865 7320 2831 290a 3332 2d62 crashes (1).32-b │ │ │ │ │ +00040210: 6974 206b 4672 6565 4253 4420 2020 2020 it kFreeBSD │ │ │ │ │ 00040220: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040230: 2020 2063 7261 7368 6573 2028 3529 2020 crashes (5) │ │ │ │ │ -00040240: 2020 2020 6372 6173 6865 7320 2835 290a crashes (5). │ │ │ │ │ -00040250: 3634 2d62 6974 206b 4672 6565 4253 4420 64-bit kFreeBSD │ │ │ │ │ +00040230: 2063 7261 7368 6573 2028 3529 2020 2020 crashes (5) │ │ │ │ │ +00040240: 2020 6372 6173 6865 7320 2835 290a 3634 crashes (5).64 │ │ │ │ │ +00040250: 2d62 6974 206b 4672 6565 4253 4420 2020 -bit kFreeBSD │ │ │ │ │ 00040260: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040270: 2020 2020 2063 7261 7368 6573 2028 3529 crashes (5) │ │ │ │ │ -00040280: 2020 2020 2020 6372 6173 6865 7320 2835 crashes (5 │ │ │ │ │ -00040290: 290a 3332 2d62 6974 206b 4e65 7442 5344 ).32-bit kNetBSD │ │ │ │ │ +00040270: 2020 2063 7261 7368 6573 2028 3529 2020 crashes (5) │ │ │ │ │ +00040280: 2020 2020 6372 6173 6865 7320 2835 290a crashes (5). │ │ │ │ │ +00040290: 3332 2d62 6974 206b 4e65 7442 5344 2020 32-bit kNetBSD │ │ │ │ │ 000402a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000402b0: 2020 2020 2020 2063 7261 7368 6573 2028 crashes ( │ │ │ │ │ -000402c0: 3129 2020 2020 2020 6372 6173 6865 7320 1) crashes │ │ │ │ │ -000402d0: 2831 290a 3634 2d62 6974 206b 4e65 7442 (1).64-bit kNetB │ │ │ │ │ -000402e0: 5344 2020 2020 2020 2020 2020 2020 2020 SD │ │ │ │ │ -000402f0: 2020 2020 2020 2020 2079 6573 2020 2020 yes │ │ │ │ │ -00040300: 2020 2020 2020 2020 2020 7965 730a 3332 yes.32 │ │ │ │ │ -00040310: 2d62 6974 206b 4f70 656e 4253 4420 2020 -bit kOpenBSD │ │ │ │ │ +000402b0: 2020 2020 2063 7261 7368 6573 2028 3129 crashes (1) │ │ │ │ │ +000402c0: 2020 2020 2020 6372 6173 6865 7320 2831 crashes (1 │ │ │ │ │ +000402d0: 290a 3634 2d62 6974 206b 4e65 7442 5344 ).64-bit kNetBSD │ │ │ │ │ +000402e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +000402f0: 2020 2020 2020 2079 6573 2020 2020 2020 yes │ │ │ │ │ +00040300: 2020 2020 2020 2020 7965 730a 3332 2d62 yes.32-b │ │ │ │ │ +00040310: 6974 206b 4f70 656e 4253 4420 2020 2020 it kOpenBSD │ │ │ │ │ 00040320: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040330: 2020 2079 6573 2020 2020 2020 2020 2020 yes │ │ │ │ │ -00040340: 2020 2020 7965 730a 3634 2d62 6974 206b yes.64-bit k │ │ │ │ │ -00040350: 4f70 656e 4253 4420 2020 2020 2020 2020 OpenBSD │ │ │ │ │ -00040360: 2020 2020 2020 2020 2020 2020 2079 6573 yes │ │ │ │ │ -00040370: 2020 2020 2020 2020 2020 2020 2020 7965 ye │ │ │ │ │ -00040380: 730a 4d75 6c74 6962 6f6f 7420 2020 2020 s.Multiboot │ │ │ │ │ +00040330: 2079 6573 2020 2020 2020 2020 2020 2020 yes │ │ │ │ │ +00040340: 2020 7965 730a 3634 2d62 6974 206b 4f70 yes.64-bit kOp │ │ │ │ │ +00040350: 656e 4253 4420 2020 2020 2020 2020 2020 enBSD │ │ │ │ │ +00040360: 2020 2020 2020 2020 2020 2079 6573 2020 yes │ │ │ │ │ +00040370: 2020 2020 2020 2020 2020 2020 7965 730a yes. │ │ │ │ │ +00040380: 4d75 6c74 6962 6f6f 7420 2020 2020 2020 Multiboot │ │ │ │ │ 00040390: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000403a0: 2020 2020 2020 2079 6573 2020 2020 2020 yes │ │ │ │ │ -000403b0: 2020 2020 2020 2020 7965 730a 4d75 6c74 yes.Mult │ │ │ │ │ -000403c0: 6962 6f6f 7432 2020 2020 2020 2020 2020 iboot2 │ │ │ │ │ -000403d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000403e0: 2079 6573 2020 2020 2020 2020 2020 2020 yes │ │ │ │ │ -000403f0: 2020 7965 730a 3332 2d62 6974 204c 696e yes.32-bit Lin │ │ │ │ │ -00040400: 7578 2028 6c65 6761 6379 2070 726f 746f ux (legacy proto │ │ │ │ │ -00040410: 636f 6c29 2020 2020 2020 206e 6f20 2831 col) no (1 │ │ │ │ │ -00040420: 2920 2020 2020 2020 2020 2020 6e6f 2028 ) no ( │ │ │ │ │ -00040430: 3129 0a36 342d 6269 7420 4c69 6e75 7820 1).64-bit Linux │ │ │ │ │ -00040440: 286c 6567 6163 7920 7072 6f74 6f63 6f6c (legacy protocol │ │ │ │ │ -00040450: 2920 2020 2020 2020 6e6f 2028 3129 2020 ) no (1) │ │ │ │ │ -00040460: 2020 2020 2020 2020 206e 6f20 2831 290a no (1). │ │ │ │ │ -00040470: 3332 2d62 6974 204c 696e 7578 2028 6d6f 32-bit Linux (mo │ │ │ │ │ -00040480: 6465 726e 2070 726f 746f 636f 6c29 2020 dern protocol) │ │ │ │ │ -00040490: 2020 2020 2079 6573 2020 2020 2020 2020 yes │ │ │ │ │ -000404a0: 2020 2020 2020 7965 730a 3634 2d62 6974 yes.64-bit │ │ │ │ │ -000404b0: 204c 696e 7578 2028 6d6f 6465 726e 2070 Linux (modern p │ │ │ │ │ -000404c0: 726f 746f 636f 6c29 2020 2020 2020 2079 rotocol) y │ │ │ │ │ -000404d0: 6573 2020 2020 2020 2020 2020 2020 2020 es │ │ │ │ │ -000404e0: 7965 730a 3332 2d62 6974 2058 4e55 2020 yes.32-bit XNU │ │ │ │ │ +000403a0: 2020 2020 2079 6573 2020 2020 2020 2020 yes │ │ │ │ │ +000403b0: 2020 2020 2020 7965 730a 4d75 6c74 6962 yes.Multib │ │ │ │ │ +000403c0: 6f6f 7432 2020 2020 2020 2020 2020 2020 oot2 │ │ │ │ │ +000403d0: 2020 2020 2020 2020 2020 2020 2020 2079 y │ │ │ │ │ +000403e0: 6573 2020 2020 2020 2020 2020 2020 2020 es │ │ │ │ │ +000403f0: 7965 730a 3332 2d62 6974 204c 696e 7578 yes.32-bit Linux │ │ │ │ │ +00040400: 2028 6c65 6761 6379 2070 726f 746f 636f (legacy protoco │ │ │ │ │ +00040410: 6c29 2020 2020 2020 206e 6f20 2831 2920 l) no (1) │ │ │ │ │ +00040420: 2020 2020 2020 2020 2020 6e6f 2028 3129 no (1) │ │ │ │ │ +00040430: 0a36 342d 6269 7420 4c69 6e75 7820 286c .64-bit Linux (l │ │ │ │ │ +00040440: 6567 6163 7920 7072 6f74 6f63 6f6c 2920 egacy protocol) │ │ │ │ │ +00040450: 2020 2020 2020 6e6f 2028 3129 2020 2020 no (1) │ │ │ │ │ +00040460: 2020 2020 2020 206e 6f20 2831 290a 3332 no (1).32 │ │ │ │ │ +00040470: 2d62 6974 204c 696e 7578 2028 6d6f 6465 -bit Linux (mode │ │ │ │ │ +00040480: 726e 2070 726f 746f 636f 6c29 2020 2020 rn protocol) │ │ │ │ │ +00040490: 2020 2079 6573 2020 2020 2020 2020 2020 yes │ │ │ │ │ +000404a0: 2020 2020 7965 730a 3634 2d62 6974 204c yes.64-bit L │ │ │ │ │ +000404b0: 696e 7578 2028 6d6f 6465 726e 2070 726f inux (modern pro │ │ │ │ │ +000404c0: 746f 636f 6c29 2020 2020 2020 2079 6573 tocol) yes │ │ │ │ │ +000404d0: 2020 2020 2020 2020 2020 2020 2020 7965 ye │ │ │ │ │ +000404e0: 730a 3332 2d62 6974 2058 4e55 2020 2020 s.32-bit XNU │ │ │ │ │ 000404f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040500: 2020 2020 2020 2020 203f 2020 2020 2020 ? │ │ │ │ │ -00040510: 2020 2020 2020 2020 2020 3f0a 3634 2d62 ?.64-b │ │ │ │ │ -00040520: 6974 2058 4e55 2020 2020 2020 2020 2020 it XNU │ │ │ │ │ -00040530: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040540: 203f 2020 2020 2020 2020 2020 2020 2020 ? │ │ │ │ │ -00040550: 2020 3f0a 3332 2d62 6974 2045 4649 2063 ?.32-bit EFI c │ │ │ │ │ -00040560: 6861 696e 6c6f 6164 6572 2020 2020 2020 hainloader │ │ │ │ │ -00040570: 2020 2020 2020 2020 206e 6f20 2832 2920 no (2) │ │ │ │ │ -00040580: 2020 2020 2020 2020 2020 6e6f 2028 3229 no (2) │ │ │ │ │ -00040590: 0a36 342d 6269 7420 4546 4920 6368 6169 .64-bit EFI chai │ │ │ │ │ -000405a0: 6e6c 6f61 6465 7220 2020 2020 2020 2020 nloader │ │ │ │ │ -000405b0: 2020 2020 2020 6e6f 2028 3229 2020 2020 no (2) │ │ │ │ │ -000405c0: 2020 2020 2020 206e 6f20 2832 290a 4170 no (2).Ap │ │ │ │ │ -000405d0: 706c 656c 6f61 6465 7220 2020 2020 2020 pleloader │ │ │ │ │ +00040500: 2020 2020 2020 203f 2020 2020 2020 2020 ? │ │ │ │ │ +00040510: 2020 2020 2020 2020 3f0a 3634 2d62 6974 ?.64-bit │ │ │ │ │ +00040520: 2058 4e55 2020 2020 2020 2020 2020 2020 XNU │ │ │ │ │ +00040530: 2020 2020 2020 2020 2020 2020 2020 203f ? │ │ │ │ │ +00040540: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00040550: 3f0a 3332 2d62 6974 2045 4649 2063 6861 ?.32-bit EFI cha │ │ │ │ │ +00040560: 696e 6c6f 6164 6572 2020 2020 2020 2020 inloader │ │ │ │ │ +00040570: 2020 2020 2020 206e 6f20 2832 2920 2020 no (2) │ │ │ │ │ +00040580: 2020 2020 2020 2020 6e6f 2028 3229 0a36 no (2).6 │ │ │ │ │ +00040590: 342d 6269 7420 4546 4920 6368 6169 6e6c 4-bit EFI chainl │ │ │ │ │ +000405a0: 6f61 6465 7220 2020 2020 2020 2020 2020 oader │ │ │ │ │ +000405b0: 2020 2020 6e6f 2028 3229 2020 2020 2020 no (2) │ │ │ │ │ +000405c0: 2020 2020 206e 6f20 2832 290a 4170 706c no (2).Appl │ │ │ │ │ +000405d0: 656c 6f61 6465 7220 2020 2020 2020 2020 eloader │ │ │ │ │ 000405e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000405f0: 2020 206e 6f20 2832 2920 2020 2020 2020 no (2) │ │ │ │ │ -00040600: 2020 2020 6e6f 2028 3229 0a0a 2020 2020 no (2).. │ │ │ │ │ +000405f0: 206e 6f20 2832 2920 2020 2020 2020 2020 no (2) │ │ │ │ │ +00040600: 2020 6e6f 2028 3229 0a0a 2020 2020 2020 no (2).. │ │ │ │ │ 00040610: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040620: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040630: 2069 6133 3220 4546 4920 2020 2020 2020 ia32 EFI │ │ │ │ │ -00040640: 2020 616d 6436 3420 4546 490a 4249 4f53 amd64 EFI.BIOS │ │ │ │ │ -00040650: 2063 6861 696e 6c6f 6164 696e 6720 2020 chainloading │ │ │ │ │ -00040660: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040670: 206e 6f20 2831 2920 2020 2020 2020 2020 no (1) │ │ │ │ │ -00040680: 2020 6e6f 2028 3129 0a4e 544c 4452 2020 no (1).NTLDR │ │ │ │ │ +00040620: 2020 2020 2020 2020 2020 2020 2020 2069 i │ │ │ │ │ +00040630: 6133 3220 4546 4920 2020 2020 2020 2020 a32 EFI │ │ │ │ │ +00040640: 616d 6436 3420 4546 490a 4249 4f53 2063 amd64 EFI.BIOS c │ │ │ │ │ +00040650: 6861 696e 6c6f 6164 696e 6720 2020 2020 hainloading │ │ │ │ │ +00040660: 2020 2020 2020 2020 2020 2020 2020 206e n │ │ │ │ │ +00040670: 6f20 2831 2920 2020 2020 2020 2020 2020 o (1) │ │ │ │ │ +00040680: 6e6f 2028 3129 0a4e 544c 4452 2020 2020 no (1).NTLDR │ │ │ │ │ 00040690: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000406a0: 2020 2020 2020 2020 2020 2020 2020 6e6f no │ │ │ │ │ -000406b0: 2028 3129 2020 2020 2020 2020 2020 206e (1) n │ │ │ │ │ -000406c0: 6f20 2831 290a 506c 616e 3920 2020 2020 o (1).Plan9 │ │ │ │ │ +000406a0: 2020 2020 2020 2020 2020 2020 6e6f 2028 no ( │ │ │ │ │ +000406b0: 3129 2020 2020 2020 2020 2020 206e 6f20 1) no │ │ │ │ │ +000406c0: 2831 290a 506c 616e 3920 2020 2020 2020 (1).Plan9 │ │ │ │ │ 000406d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000406e0: 2020 2020 2020 2020 2020 206e 6f20 2831 no (1 │ │ │ │ │ -000406f0: 2920 2020 2020 2020 2020 2020 6e6f 2028 ) no ( │ │ │ │ │ -00040700: 3129 0a46 7265 6544 4f53 2020 2020 2020 1).FreeDOS │ │ │ │ │ +000406e0: 2020 2020 2020 2020 206e 6f20 2831 2920 no (1) │ │ │ │ │ +000406f0: 2020 2020 2020 2020 2020 6e6f 2028 3129 no (1) │ │ │ │ │ +00040700: 0a46 7265 6544 4f53 2020 2020 2020 2020 .FreeDOS │ │ │ │ │ 00040710: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040720: 2020 2020 2020 2020 6e6f 2028 3129 2020 no (1) │ │ │ │ │ -00040730: 2020 2020 2020 2020 206e 6f20 2831 290a no (1). │ │ │ │ │ -00040740: 4672 6565 4253 4420 626f 6f74 6c6f 6164 FreeBSD bootload │ │ │ │ │ -00040750: 6572 2020 2020 2020 2020 2020 2020 2020 er │ │ │ │ │ -00040760: 2020 2020 2063 7261 7368 6573 2028 3129 crashes (1) │ │ │ │ │ -00040770: 2020 2020 2020 6372 6173 6865 7320 2831 crashes (1 │ │ │ │ │ -00040780: 290a 3332 2d62 6974 206b 4672 6565 4253 ).32-bit kFreeBS │ │ │ │ │ -00040790: 4420 2020 2020 2020 2020 2020 2020 2020 D │ │ │ │ │ -000407a0: 2020 2020 2020 2068 6561 646c 6573 7320 headless │ │ │ │ │ -000407b0: 2020 2020 2020 2020 6865 6164 6c65 7373 headless │ │ │ │ │ -000407c0: 0a36 342d 6269 7420 6b46 7265 6542 5344 .64-bit kFreeBSD │ │ │ │ │ +00040720: 2020 2020 2020 6e6f 2028 3129 2020 2020 no (1) │ │ │ │ │ +00040730: 2020 2020 2020 206e 6f20 2831 290a 4672 no (1).Fr │ │ │ │ │ +00040740: 6565 4253 4420 626f 6f74 6c6f 6164 6572 eeBSD bootloader │ │ │ │ │ +00040750: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00040760: 2020 2063 7261 7368 6573 2028 3129 2020 crashes (1) │ │ │ │ │ +00040770: 2020 2020 6372 6173 6865 7320 2831 290a crashes (1). │ │ │ │ │ +00040780: 3332 2d62 6974 206b 4672 6565 4253 4420 32-bit kFreeBSD │ │ │ │ │ +00040790: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +000407a0: 2020 2020 2068 6561 646c 6573 7320 2020 headless │ │ │ │ │ +000407b0: 2020 2020 2020 6865 6164 6c65 7373 0a36 headless.6 │ │ │ │ │ +000407c0: 342d 6269 7420 6b46 7265 6542 5344 2020 4-bit kFreeBSD │ │ │ │ │ 000407d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000407e0: 2020 2020 2020 6865 6164 6c65 7373 2020 headless │ │ │ │ │ -000407f0: 2020 2020 2020 2068 6561 646c 6573 730a headless. │ │ │ │ │ -00040800: 3332 2d62 6974 206b 4e65 7442 5344 2020 32-bit kNetBSD │ │ │ │ │ +000407e0: 2020 2020 6865 6164 6c65 7373 2020 2020 headless │ │ │ │ │ +000407f0: 2020 2020 2068 6561 646c 6573 730a 3332 headless.32 │ │ │ │ │ +00040800: 2d62 6974 206b 4e65 7442 5344 2020 2020 -bit kNetBSD │ │ │ │ │ 00040810: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040820: 2020 2020 2063 7261 7368 6573 2028 3129 crashes (1) │ │ │ │ │ -00040830: 2020 2020 2020 6372 6173 6865 7320 2831 crashes (1 │ │ │ │ │ -00040840: 290a 3634 2d62 6974 206b 4e65 7442 5344 ).64-bit kNetBSD │ │ │ │ │ +00040820: 2020 2063 7261 7368 6573 2028 3129 2020 crashes (1) │ │ │ │ │ +00040830: 2020 2020 6372 6173 6865 7320 2831 290a crashes (1). │ │ │ │ │ +00040840: 3634 2d62 6974 206b 4e65 7442 5344 2020 64-bit kNetBSD │ │ │ │ │ 00040850: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040860: 2020 2020 2020 2079 6573 2020 2020 2020 yes │ │ │ │ │ -00040870: 2020 2020 2020 2020 7965 730a 3332 2d62 yes.32-b │ │ │ │ │ -00040880: 6974 206b 4f70 656e 4253 4420 2020 2020 it kOpenBSD │ │ │ │ │ -00040890: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000408a0: 2068 6561 646c 6573 7320 2020 2020 2020 headless │ │ │ │ │ -000408b0: 2020 6865 6164 6c65 7373 0a36 342d 6269 headless.64-bi │ │ │ │ │ -000408c0: 7420 6b4f 7065 6e42 5344 2020 2020 2020 t kOpenBSD │ │ │ │ │ -000408d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000408e0: 6865 6164 6c65 7373 2020 2020 2020 2020 headless │ │ │ │ │ -000408f0: 2068 6561 646c 6573 730a 4d75 6c74 6962 headless.Multib │ │ │ │ │ -00040900: 6f6f 7420 2020 2020 2020 2020 2020 2020 oot │ │ │ │ │ -00040910: 2020 2020 2020 2020 2020 2020 2020 2079 y │ │ │ │ │ -00040920: 6573 2020 2020 2020 2020 2020 2020 2020 es │ │ │ │ │ -00040930: 7965 730a 4d75 6c74 6962 6f6f 7432 2020 yes.Multiboot2 │ │ │ │ │ +00040860: 2020 2020 2079 6573 2020 2020 2020 2020 yes │ │ │ │ │ +00040870: 2020 2020 2020 7965 730a 3332 2d62 6974 yes.32-bit │ │ │ │ │ +00040880: 206b 4f70 656e 4253 4420 2020 2020 2020 kOpenBSD │ │ │ │ │ +00040890: 2020 2020 2020 2020 2020 2020 2020 2068 h │ │ │ │ │ +000408a0: 6561 646c 6573 7320 2020 2020 2020 2020 eadless │ │ │ │ │ +000408b0: 6865 6164 6c65 7373 0a36 342d 6269 7420 headless.64-bit │ │ │ │ │ +000408c0: 6b4f 7065 6e42 5344 2020 2020 2020 2020 kOpenBSD │ │ │ │ │ +000408d0: 2020 2020 2020 2020 2020 2020 2020 6865 he │ │ │ │ │ +000408e0: 6164 6c65 7373 2020 2020 2020 2020 2068 adless h │ │ │ │ │ +000408f0: 6561 646c 6573 730a 4d75 6c74 6962 6f6f eadless.Multiboo │ │ │ │ │ +00040900: 7420 2020 2020 2020 2020 2020 2020 2020 t │ │ │ │ │ +00040910: 2020 2020 2020 2020 2020 2020 2079 6573 yes │ │ │ │ │ +00040920: 2020 2020 2020 2020 2020 2020 2020 7965 ye │ │ │ │ │ +00040930: 730a 4d75 6c74 6962 6f6f 7432 2020 2020 s.Multiboot2 │ │ │ │ │ 00040940: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040950: 2020 2020 2020 2020 2079 6573 2020 2020 yes │ │ │ │ │ -00040960: 2020 2020 2020 2020 2020 7965 730a 3332 yes.32 │ │ │ │ │ -00040970: 2d62 6974 204c 696e 7578 2028 6c65 6761 -bit Linux (lega │ │ │ │ │ -00040980: 6379 2070 726f 746f 636f 6c29 2020 2020 cy protocol) │ │ │ │ │ -00040990: 2020 206e 6f20 2831 2920 2020 2020 2020 no (1) │ │ │ │ │ -000409a0: 2020 2020 6e6f 2028 3129 0a36 342d 6269 no (1).64-bi │ │ │ │ │ -000409b0: 7420 4c69 6e75 7820 286c 6567 6163 7920 t Linux (legacy │ │ │ │ │ -000409c0: 7072 6f74 6f63 6f6c 2920 2020 2020 2020 protocol) │ │ │ │ │ -000409d0: 6e6f 2028 3129 2020 2020 2020 2020 2020 no (1) │ │ │ │ │ -000409e0: 206e 6f20 2831 290a 3332 2d62 6974 204c no (1).32-bit L │ │ │ │ │ -000409f0: 696e 7578 2028 6d6f 6465 726e 2070 726f inux (modern pro │ │ │ │ │ -00040a00: 746f 636f 6c29 2020 2020 2020 2079 6573 tocol) yes │ │ │ │ │ -00040a10: 2020 2020 2020 2020 2020 2020 2020 7965 ye │ │ │ │ │ -00040a20: 730a 3634 2d62 6974 204c 696e 7578 2028 s.64-bit Linux ( │ │ │ │ │ -00040a30: 6d6f 6465 726e 2070 726f 746f 636f 6c29 modern protocol) │ │ │ │ │ -00040a40: 2020 2020 2020 2079 6573 2020 2020 2020 yes │ │ │ │ │ -00040a50: 2020 2020 2020 2020 7965 730a 3332 2d62 yes.32-b │ │ │ │ │ -00040a60: 6974 2058 4e55 2020 2020 2020 2020 2020 it XNU │ │ │ │ │ -00040a70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040a80: 2079 6573 2020 2020 2020 2020 2020 2020 yes │ │ │ │ │ -00040a90: 2020 7965 730a 3634 2d62 6974 2058 4e55 yes.64-bit XNU │ │ │ │ │ +00040950: 2020 2020 2020 2079 6573 2020 2020 2020 yes │ │ │ │ │ +00040960: 2020 2020 2020 2020 7965 730a 3332 2d62 yes.32-b │ │ │ │ │ +00040970: 6974 204c 696e 7578 2028 6c65 6761 6379 it Linux (legacy │ │ │ │ │ +00040980: 2070 726f 746f 636f 6c29 2020 2020 2020 protocol) │ │ │ │ │ +00040990: 206e 6f20 2831 2920 2020 2020 2020 2020 no (1) │ │ │ │ │ +000409a0: 2020 6e6f 2028 3129 0a36 342d 6269 7420 no (1).64-bit │ │ │ │ │ +000409b0: 4c69 6e75 7820 286c 6567 6163 7920 7072 Linux (legacy pr │ │ │ │ │ +000409c0: 6f74 6f63 6f6c 2920 2020 2020 2020 6e6f otocol) no │ │ │ │ │ +000409d0: 2028 3129 2020 2020 2020 2020 2020 206e (1) n │ │ │ │ │ +000409e0: 6f20 2831 290a 3332 2d62 6974 204c 696e o (1).32-bit Lin │ │ │ │ │ +000409f0: 7578 2028 6d6f 6465 726e 2070 726f 746f ux (modern proto │ │ │ │ │ +00040a00: 636f 6c29 2020 2020 2020 2079 6573 2020 col) yes │ │ │ │ │ +00040a10: 2020 2020 2020 2020 2020 2020 7965 730a yes. │ │ │ │ │ +00040a20: 3634 2d62 6974 204c 696e 7578 2028 6d6f 64-bit Linux (mo │ │ │ │ │ +00040a30: 6465 726e 2070 726f 746f 636f 6c29 2020 dern protocol) │ │ │ │ │ +00040a40: 2020 2020 2079 6573 2020 2020 2020 2020 yes │ │ │ │ │ +00040a50: 2020 2020 2020 7965 730a 3332 2d62 6974 yes.32-bit │ │ │ │ │ +00040a60: 2058 4e55 2020 2020 2020 2020 2020 2020 XNU │ │ │ │ │ +00040a70: 2020 2020 2020 2020 2020 2020 2020 2079 y │ │ │ │ │ +00040a80: 6573 2020 2020 2020 2020 2020 2020 2020 es │ │ │ │ │ +00040a90: 7965 730a 3634 2d62 6974 2058 4e55 2020 yes.64-bit XNU │ │ │ │ │ 00040aa0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040ab0: 2020 2020 2020 2020 2020 2079 6573 2028 yes ( │ │ │ │ │ -00040ac0: 3429 2020 2020 2020 2020 2020 7965 730a 4) yes. │ │ │ │ │ -00040ad0: 3332 2d62 6974 2045 4649 2063 6861 696e 32-bit EFI chain │ │ │ │ │ -00040ae0: 6c6f 6164 6572 2020 2020 2020 2020 2020 loader │ │ │ │ │ -00040af0: 2020 2020 2079 6573 2020 2020 2020 2020 yes │ │ │ │ │ -00040b00: 2020 2020 2020 6e6f 2028 3329 0a36 342d no (3).64- │ │ │ │ │ -00040b10: 6269 7420 4546 4920 6368 6169 6e6c 6f61 bit EFI chainloa │ │ │ │ │ -00040b20: 6465 7220 2020 2020 2020 2020 2020 2020 der │ │ │ │ │ -00040b30: 2020 6e6f 2028 3329 2020 2020 2020 2020 no (3) │ │ │ │ │ -00040b40: 2020 2079 6573 0a41 7070 6c65 6c6f 6164 yes.Appleload │ │ │ │ │ -00040b50: 6572 2020 2020 2020 2020 2020 2020 2020 er │ │ │ │ │ -00040b60: 2020 2020 2020 2020 2020 2020 7965 7320 yes │ │ │ │ │ -00040b70: 2020 2020 2020 2020 2020 2020 2079 6573 yes │ │ │ │ │ -00040b80: 0a0a 2020 2020 2020 2020 2020 2020 2020 .. │ │ │ │ │ +00040ab0: 2020 2020 2020 2020 2079 6573 2028 3429 yes (4) │ │ │ │ │ +00040ac0: 2020 2020 2020 2020 2020 7965 730a 3332 yes.32 │ │ │ │ │ +00040ad0: 2d62 6974 2045 4649 2063 6861 696e 6c6f -bit EFI chainlo │ │ │ │ │ +00040ae0: 6164 6572 2020 2020 2020 2020 2020 2020 ader │ │ │ │ │ +00040af0: 2020 2079 6573 2020 2020 2020 2020 2020 yes │ │ │ │ │ +00040b00: 2020 2020 6e6f 2028 3329 0a36 342d 6269 no (3).64-bi │ │ │ │ │ +00040b10: 7420 4546 4920 6368 6169 6e6c 6f61 6465 t EFI chainloade │ │ │ │ │ +00040b20: 7220 2020 2020 2020 2020 2020 2020 2020 r │ │ │ │ │ +00040b30: 6e6f 2028 3329 2020 2020 2020 2020 2020 no (3) │ │ │ │ │ +00040b40: 2079 6573 0a41 7070 6c65 6c6f 6164 6572 yes.Appleloader │ │ │ │ │ +00040b50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00040b60: 2020 2020 2020 2020 2020 7965 7320 2020 yes │ │ │ │ │ +00040b70: 2020 2020 2020 2020 2020 2079 6573 0a0a yes.. │ │ │ │ │ +00040b80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00040b90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040ba0: 2020 2020 2020 2069 6133 3220 4945 4545 ia32 IEEE │ │ │ │ │ -00040bb0: 3132 3735 0a42 494f 5320 6368 6169 6e6c 1275.BIOS chainl │ │ │ │ │ -00040bc0: 6f61 6469 6e67 2020 2020 2020 2020 2020 oading │ │ │ │ │ -00040bd0: 2020 2020 2020 2020 2020 6e6f 2028 3129 no (1) │ │ │ │ │ -00040be0: 0a4e 544c 4452 2020 2020 2020 2020 2020 .NTLDR │ │ │ │ │ +00040ba0: 2020 2020 2069 6133 3220 4945 4545 3132 ia32 IEEE12 │ │ │ │ │ +00040bb0: 3735 0a42 494f 5320 6368 6169 6e6c 6f61 75.BIOS chainloa │ │ │ │ │ +00040bc0: 6469 6e67 2020 2020 2020 2020 2020 2020 ding │ │ │ │ │ +00040bd0: 2020 2020 2020 2020 6e6f 2028 3129 0a4e no (1).N │ │ │ │ │ +00040be0: 544c 4452 2020 2020 2020 2020 2020 2020 TLDR │ │ │ │ │ 00040bf0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040c00: 2020 2020 2020 6e6f 2028 3129 0a50 6c61 no (1).Pla │ │ │ │ │ -00040c10: 6e39 2020 2020 2020 2020 2020 2020 2020 n9 │ │ │ │ │ +00040c00: 2020 2020 6e6f 2028 3129 0a50 6c61 6e39 no (1).Plan9 │ │ │ │ │ +00040c10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00040c20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040c30: 2020 6e6f 2028 3129 0a46 7265 6544 4f53 no (1).FreeDOS │ │ │ │ │ +00040c30: 6e6f 2028 3129 0a46 7265 6544 4f53 2020 no (1).FreeDOS │ │ │ │ │ 00040c40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040c50: 2020 2020 2020 2020 2020 2020 2020 6e6f no │ │ │ │ │ -00040c60: 2028 3129 0a46 7265 6542 5344 2062 6f6f (1).FreeBSD boo │ │ │ │ │ -00040c70: 746c 6f61 6465 7220 2020 2020 2020 2020 tloader │ │ │ │ │ -00040c80: 2020 2020 2020 2020 2020 6372 6173 6865 crashe │ │ │ │ │ -00040c90: 7320 2831 290a 3332 2d62 6974 206b 4672 s (1).32-bit kFr │ │ │ │ │ -00040ca0: 6565 4253 4420 2020 2020 2020 2020 2020 eeBSD │ │ │ │ │ -00040cb0: 2020 2020 2020 2020 2020 2063 7261 7368 crash │ │ │ │ │ -00040cc0: 6573 2028 3529 0a36 342d 6269 7420 6b46 es (5).64-bit kF │ │ │ │ │ -00040cd0: 7265 6542 5344 2020 2020 2020 2020 2020 reeBSD │ │ │ │ │ -00040ce0: 2020 2020 2020 2020 2020 2020 6372 6173 cras │ │ │ │ │ -00040cf0: 6865 7320 2835 290a 3332 2d62 6974 206b hes (5).32-bit k │ │ │ │ │ -00040d00: 4e65 7442 5344 2020 2020 2020 2020 2020 NetBSD │ │ │ │ │ -00040d10: 2020 2020 2020 2020 2020 2020 2063 7261 cra │ │ │ │ │ -00040d20: 7368 6573 2028 3129 0a36 342d 6269 7420 shes (1).64-bit │ │ │ │ │ -00040d30: 6b4e 6574 4253 4420 2020 2020 2020 2020 kNetBSD │ │ │ │ │ -00040d40: 2020 2020 2020 2020 2020 2020 2020 3f0a ?. │ │ │ │ │ -00040d50: 3332 2d62 6974 206b 4f70 656e 4253 4420 32-bit kOpenBSD │ │ │ │ │ +00040c50: 2020 2020 2020 2020 2020 2020 6e6f 2028 no ( │ │ │ │ │ +00040c60: 3129 0a46 7265 6542 5344 2062 6f6f 746c 1).FreeBSD bootl │ │ │ │ │ +00040c70: 6f61 6465 7220 2020 2020 2020 2020 2020 oader │ │ │ │ │ +00040c80: 2020 2020 2020 2020 6372 6173 6865 7320 crashes │ │ │ │ │ +00040c90: 2831 290a 3332 2d62 6974 206b 4672 6565 (1).32-bit kFree │ │ │ │ │ +00040ca0: 4253 4420 2020 2020 2020 2020 2020 2020 BSD │ │ │ │ │ +00040cb0: 2020 2020 2020 2020 2063 7261 7368 6573 crashes │ │ │ │ │ +00040cc0: 2028 3529 0a36 342d 6269 7420 6b46 7265 (5).64-bit kFre │ │ │ │ │ +00040cd0: 6542 5344 2020 2020 2020 2020 2020 2020 eBSD │ │ │ │ │ +00040ce0: 2020 2020 2020 2020 2020 6372 6173 6865 crashe │ │ │ │ │ +00040cf0: 7320 2835 290a 3332 2d62 6974 206b 4e65 s (5).32-bit kNe │ │ │ │ │ +00040d00: 7442 5344 2020 2020 2020 2020 2020 2020 tBSD │ │ │ │ │ +00040d10: 2020 2020 2020 2020 2020 2063 7261 7368 crash │ │ │ │ │ +00040d20: 6573 2028 3129 0a36 342d 6269 7420 6b4e es (1).64-bit kN │ │ │ │ │ +00040d30: 6574 4253 4420 2020 2020 2020 2020 2020 etBSD │ │ │ │ │ +00040d40: 2020 2020 2020 2020 2020 2020 3f0a 3332 ?.32 │ │ │ │ │ +00040d50: 2d62 6974 206b 4f70 656e 4253 4420 2020 -bit kOpenBSD │ │ │ │ │ 00040d60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040d70: 2020 2020 203f 0a36 342d 6269 7420 6b4f ?.64-bit kO │ │ │ │ │ -00040d80: 7065 6e42 5344 2020 2020 2020 2020 2020 penBSD │ │ │ │ │ -00040d90: 2020 2020 2020 2020 2020 2020 3f0a 4d75 ?.Mu │ │ │ │ │ -00040da0: 6c74 6962 6f6f 7420 2020 2020 2020 2020 ltiboot │ │ │ │ │ +00040d70: 2020 203f 0a36 342d 6269 7420 6b4f 7065 ?.64-bit kOpe │ │ │ │ │ +00040d80: 6e42 5344 2020 2020 2020 2020 2020 2020 nBSD │ │ │ │ │ +00040d90: 2020 2020 2020 2020 2020 3f0a 4d75 6c74 ?.Mult │ │ │ │ │ +00040da0: 6962 6f6f 7420 2020 2020 2020 2020 2020 iboot │ │ │ │ │ 00040db0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040dc0: 2020 203f 0a4d 756c 7469 626f 6f74 3220 ?.Multiboot2 │ │ │ │ │ +00040dc0: 203f 0a4d 756c 7469 626f 6f74 3220 2020 ?.Multiboot2 │ │ │ │ │ 00040dd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040de0: 2020 2020 2020 2020 2020 3f0a 3332 2d62 ?.32-b │ │ │ │ │ -00040df0: 6974 204c 696e 7578 2028 6c65 6761 6379 it Linux (legacy │ │ │ │ │ -00040e00: 2070 726f 746f 636f 6c29 2020 2020 2020 protocol) │ │ │ │ │ -00040e10: 206e 6f20 2831 290a 3634 2d62 6974 204c no (1).64-bit L │ │ │ │ │ -00040e20: 696e 7578 2028 6c65 6761 6379 2070 726f inux (legacy pro │ │ │ │ │ -00040e30: 746f 636f 6c29 2020 2020 2020 206e 6f20 tocol) no │ │ │ │ │ -00040e40: 2831 290a 3332 2d62 6974 204c 696e 7578 (1).32-bit Linux │ │ │ │ │ -00040e50: 2028 6d6f 6465 726e 2070 726f 746f 636f (modern protoco │ │ │ │ │ -00040e60: 6c29 2020 2020 2020 203f 0a36 342d 6269 l) ?.64-bi │ │ │ │ │ -00040e70: 7420 4c69 6e75 7820 286d 6f64 6572 6e20 t Linux (modern │ │ │ │ │ -00040e80: 7072 6f74 6f63 6f6c 2920 2020 2020 2020 protocol) │ │ │ │ │ -00040e90: 3f0a 3332 2d62 6974 2058 4e55 2020 2020 ?.32-bit XNU │ │ │ │ │ +00040de0: 2020 2020 2020 2020 3f0a 3332 2d62 6974 ?.32-bit │ │ │ │ │ +00040df0: 204c 696e 7578 2028 6c65 6761 6379 2070 Linux (legacy p │ │ │ │ │ +00040e00: 726f 746f 636f 6c29 2020 2020 2020 206e rotocol) n │ │ │ │ │ +00040e10: 6f20 2831 290a 3634 2d62 6974 204c 696e o (1).64-bit Lin │ │ │ │ │ +00040e20: 7578 2028 6c65 6761 6379 2070 726f 746f ux (legacy proto │ │ │ │ │ +00040e30: 636f 6c29 2020 2020 2020 206e 6f20 2831 col) no (1 │ │ │ │ │ +00040e40: 290a 3332 2d62 6974 204c 696e 7578 2028 ).32-bit Linux ( │ │ │ │ │ +00040e50: 6d6f 6465 726e 2070 726f 746f 636f 6c29 modern protocol) │ │ │ │ │ +00040e60: 2020 2020 2020 203f 0a36 342d 6269 7420 ?.64-bit │ │ │ │ │ +00040e70: 4c69 6e75 7820 286d 6f64 6572 6e20 7072 Linux (modern pr │ │ │ │ │ +00040e80: 6f74 6f63 6f6c 2920 2020 2020 2020 3f0a otocol) ?. │ │ │ │ │ +00040e90: 3332 2d62 6974 2058 4e55 2020 2020 2020 32-bit XNU │ │ │ │ │ 00040ea0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040eb0: 2020 2020 2020 203f 0a36 342d 6269 7420 ?.64-bit │ │ │ │ │ -00040ec0: 584e 5520 2020 2020 2020 2020 2020 2020 XNU │ │ │ │ │ -00040ed0: 2020 2020 2020 2020 2020 2020 2020 3f0a ?. │ │ │ │ │ -00040ee0: 3332 2d62 6974 2045 4649 2063 6861 696e 32-bit EFI chain │ │ │ │ │ -00040ef0: 6c6f 6164 6572 2020 2020 2020 2020 2020 loader │ │ │ │ │ -00040f00: 2020 2020 206e 6f20 2832 290a 3634 2d62 no (2).64-b │ │ │ │ │ -00040f10: 6974 2045 4649 2063 6861 696e 6c6f 6164 it EFI chainload │ │ │ │ │ -00040f20: 6572 2020 2020 2020 2020 2020 2020 2020 er │ │ │ │ │ -00040f30: 206e 6f20 2832 290a 4170 706c 656c 6f61 no (2).Appleloa │ │ │ │ │ -00040f40: 6465 7220 2020 2020 2020 2020 2020 2020 der │ │ │ │ │ -00040f50: 2020 2020 2020 2020 2020 2020 206e 6f20 no │ │ │ │ │ -00040f60: 2832 290a 0a20 2031 2e20 5265 7175 6972 (2).. 1. Requir │ │ │ │ │ -00040f70: 6573 2042 494f 530a 2020 322e 2045 4649 es BIOS. 2. EFI │ │ │ │ │ -00040f80: 206f 6e6c 790a 2020 332e 2033 322d 6269 only. 3. 32-bi │ │ │ │ │ -00040f90: 7420 616e 6420 3634 2d62 6974 2045 4649 t and 64-bit EFI │ │ │ │ │ -00040fa0: 2068 6176 6520 6469 6666 6572 656e 7420 have different │ │ │ │ │ -00040fb0: 7374 7275 6374 7572 6573 2061 6e64 2077 structures and w │ │ │ │ │ -00040fc0: 6f72 6b20 696e 0a20 2020 2020 6469 6666 ork in. diff │ │ │ │ │ -00040fd0: 6572 656e 7420 4350 5520 6d6f 6465 7320 erent CPU modes │ │ │ │ │ -00040fe0: 736f 2069 7427 7320 6e6f 7420 706f 7373 so it's not poss │ │ │ │ │ -00040ff0: 6962 6c65 2074 6f20 6368 6169 6e6c 6f61 ible to chainloa │ │ │ │ │ -00041000: 6420 3332 2d62 6974 0a20 2020 2020 626f d 32-bit. bo │ │ │ │ │ -00041010: 6f74 6c6f 6164 6572 206f 6e20 3634 2d62 otloader on 64-b │ │ │ │ │ -00041020: 6974 2070 6c61 7466 6f72 6d20 616e 6420 it platform and │ │ │ │ │ -00041030: 7669 6365 2d76 6572 7361 0a20 2034 2e20 vice-versa. 4. │ │ │ │ │ -00041040: 536f 6d65 206d 6f64 756c 6573 206d 6179 Some modules may │ │ │ │ │ -00041050: 206e 6565 6420 746f 2062 6520 6469 7361 need to be disa │ │ │ │ │ -00041060: 626c 6564 0a20 2035 2e20 5265 7175 6972 bled. 5. Requir │ │ │ │ │ -00041070: 6573 2041 4350 490a 0a20 2020 506f 7765 es ACPI.. Powe │ │ │ │ │ -00041080: 7250 432c 2049 4136 3420 616e 6420 5370 rPC, IA64 and Sp │ │ │ │ │ -00041090: 6172 6336 3420 706f 7274 7320 7375 7070 arc64 ports supp │ │ │ │ │ -000410a0: 6f72 7420 6f6e 6c79 204c 696e 7578 2e20 ort only Linux. │ │ │ │ │ -000410b0: 204d 4950 5320 706f 7274 0a73 7570 706f MIPS port.suppo │ │ │ │ │ -000410c0: 7274 7320 4c69 6e75 7820 616e 6420 6d75 rts Linux and mu │ │ │ │ │ -000410d0: 6c74 6962 6f6f 7432 2e0a 0a32 312e 3120 ltiboot2...21.1 │ │ │ │ │ -000410e0: 426f 6f74 2074 6573 7473 0a3d 3d3d 3d3d Boot tests.===== │ │ │ │ │ -000410f0: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 4173 2079 ==========..As y │ │ │ │ │ -00041100: 6f75 2068 6176 6520 7365 656e 2069 6e20 ou have seen in │ │ │ │ │ -00041110: 7072 6576 696f 7573 2063 6861 7074 6572 previous chapter │ │ │ │ │ -00041120: 2074 6865 2073 7570 706f 7274 206d 6174 the support mat │ │ │ │ │ -00041130: 7269 7820 6973 2070 7265 7474 7920 6269 rix is pretty bi │ │ │ │ │ -00041140: 670a 616e 6420 736f 6d65 206f 6620 7468 g.and some of th │ │ │ │ │ -00041150: 6520 636f 6e66 6967 7572 6174 696f 6e73 e configurations │ │ │ │ │ -00041160: 2061 7265 206f 6e6c 7920 7261 7265 6c79 are only rarely │ │ │ │ │ -00041170: 2075 7365 642e 2020 546f 2065 6e73 7572 used. To ensur │ │ │ │ │ -00041180: 6520 7468 650a 7175 616c 6974 7920 626f e the.quality bo │ │ │ │ │ -00041190: 6f74 6368 6563 6b73 2061 7265 2061 7661 otchecks are ava │ │ │ │ │ -000411a0: 696c 6162 6c65 2066 6f72 2061 6c6c 2078 ilable for all x │ │ │ │ │ -000411b0: 3836 2074 6172 6765 7473 2065 7863 6570 86 targets excep │ │ │ │ │ -000411c0: 7420 4546 490a 6368 6169 6e6c 6f61 6465 t EFI.chainloade │ │ │ │ │ -000411d0: 722c 2041 7070 6c65 6c6f 6164 6572 2061 r, Appleloader a │ │ │ │ │ -000411e0: 6e64 2058 4e55 2e20 416c 6c20 7838 3620 nd XNU. All x86 │ │ │ │ │ -000411f0: 706c 6174 666f 726d 7320 6861 7665 2062 platforms have b │ │ │ │ │ -00041200: 6f6f 7463 6865 636b 0a66 6163 696c 6974 ootcheck.facilit │ │ │ │ │ -00041210: 7920 6578 6365 7074 2069 6565 6531 3237 y except ieee127 │ │ │ │ │ -00041220: 352e 2020 4d75 6c74 6962 6f6f 742c 206d 5. Multiboot, m │ │ │ │ │ -00041230: 756c 7469 626f 6f74 322c 2042 494f 5320 ultiboot2, BIOS │ │ │ │ │ -00041240: 6368 6169 6e6c 6f61 6465 722c 0a6e 746c chainloader,.ntl │ │ │ │ │ -00041250: 6472 2061 6e64 2066 7265 6562 7364 2d62 dr and freebsd-b │ │ │ │ │ -00041260: 6f6f 746c 6f61 6465 7220 626f 6f74 2074 ootloader boot t │ │ │ │ │ -00041270: 6172 6765 7473 2061 7265 2074 6573 7465 argets are teste │ │ │ │ │ -00041280: 6420 6f6e 6c79 2077 6974 6820 6120 6661 d only with a fa │ │ │ │ │ -00041290: 6b65 0a6b 6572 6e65 6c20 696d 6167 6573 ke.kernel images │ │ │ │ │ -000412a0: 2e20 204f 6e6c 7920 4c69 6e75 7820 6973 . Only Linux is │ │ │ │ │ -000412b0: 2074 6573 7465 6420 616d 6f6e 6720 7468 tested among th │ │ │ │ │ -000412c0: 6520 7061 796c 6f61 6473 2075 7369 6e67 e payloads using │ │ │ │ │ -000412d0: 204c 696e 7578 0a70 726f 746f 636f 6c73 Linux.protocols │ │ │ │ │ -000412e0: 2e0a 0a20 2020 466f 6c6c 6f77 696e 6720 ... Following │ │ │ │ │ -000412f0: 7661 7269 6162 6c65 7320 6d75 7374 2062 variables must b │ │ │ │ │ -00041300: 6520 6465 6669 6e65 643a 0a0a 4752 5542 e defined:..GRUB │ │ │ │ │ -00041310: 5f50 4159 4c4f 4144 535f 4449 5220 2020 _PAYLOADS_DIR │ │ │ │ │ -00041320: 2020 2064 6972 6563 746f 7279 2063 6f6e directory con │ │ │ │ │ -00041330: 7461 696e 696e 6720 7468 6520 7265 7175 taining the requ │ │ │ │ │ -00041340: 6972 6564 206b 6572 6e65 6c73 0a47 5255 ired kernels.GRU │ │ │ │ │ -00041350: 425f 4342 4653 544f 4f4c 2020 2020 2020 B_CBFSTOOL │ │ │ │ │ -00041360: 2020 2020 6362 6673 746f 6f6c 2066 726f cbfstool fro │ │ │ │ │ -00041370: 6d20 436f 7265 626f 6f74 2070 6163 6b61 m Coreboot packa │ │ │ │ │ -00041380: 6765 2028 666f 7220 636f 7265 626f 6f74 ge (for coreboot │ │ │ │ │ -00041390: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ -000413a0: 2020 2020 2020 2020 706c 6174 666f 726d platform │ │ │ │ │ -000413b0: 206f 6e6c 7929 0a47 5255 425f 434f 5245 only).GRUB_CORE │ │ │ │ │ -000413c0: 424f 4f54 5f52 4f4d 2020 2020 2020 656d BOOT_ROM em │ │ │ │ │ -000413d0: 7074 7920 436f 7265 626f 6f74 2052 4f4d pty Coreboot ROM │ │ │ │ │ -000413e0: 0a47 5255 425f 5145 4d55 5f4f 5054 5320 .GRUB_QEMU_OPTS │ │ │ │ │ -000413f0: 2020 2020 2020 2020 6164 6469 7469 6f6e addition │ │ │ │ │ -00041400: 616c 206f 7074 696f 6e73 2074 6f20 6265 al options to be │ │ │ │ │ -00041410: 2073 7570 706c 6965 6420 746f 2051 454d supplied to QEM │ │ │ │ │ -00041420: 550a 0a20 2020 5265 7175 6972 6564 2066 U.. Required f │ │ │ │ │ -00041430: 696c 6573 2061 7265 3a0a 0a6b 6672 6565 iles are:..kfree │ │ │ │ │ -00041440: 6273 645f 656e 762e 6933 3836 2020 2020 bsd_env.i386 │ │ │ │ │ -00041450: 2020 2020 2020 2020 2033 322d 6269 7420 32-bit │ │ │ │ │ -00041460: 6b46 7265 6542 5344 2064 6576 6963 6520 kFreeBSD device │ │ │ │ │ -00041470: 6869 6e74 730a 6b66 7265 6562 7364 2e69 hints.kfreebsd.i │ │ │ │ │ -00041480: 3338 3620 2020 2020 2020 2020 2020 2020 386 │ │ │ │ │ -00041490: 2020 2020 3332 2d62 6974 2046 7265 6542 32-bit FreeB │ │ │ │ │ -000414a0: 5344 206b 6572 6e65 6c20 696d 6167 650a SD kernel image. │ │ │ │ │ -000414b0: 6b66 7265 6562 7364 2e78 3836 5f36 342c kfreebsd.x86_64, │ │ │ │ │ -000414c0: 2020 2020 2020 2020 2020 2020 2020 7361 sa │ │ │ │ │ -000414d0: 6d65 2066 726f 6d20 3634 2d62 6974 206b me from 64-bit k │ │ │ │ │ -000414e0: 4672 6565 4253 440a 6b66 7265 6562 7364 FreeBSD.kfreebsd │ │ │ │ │ -000414f0: 5f65 6e76 2e78 3836 5f36 340a 6b6e 6574 _env.x86_64.knet │ │ │ │ │ -00041500: 6273 642e 6933 3836 2020 2020 2020 2020 bsd.i386 │ │ │ │ │ -00041510: 2020 2020 2020 2020 2020 3332 2d62 6974 32-bit │ │ │ │ │ -00041520: 204e 6574 4253 4420 6b65 726e 656c 2069 NetBSD kernel i │ │ │ │ │ -00041530: 6d61 6765 0a6b 6e65 7462 7364 2e6d 696e mage.knetbsd.min │ │ │ │ │ -00041540: 6972 6f6f 742e 6933 3836 2020 2020 2020 iroot.i386 │ │ │ │ │ -00041550: 2020 2033 322d 6269 7420 6b4e 6574 4253 32-bit kNetBS │ │ │ │ │ -00041560: 4420 6d69 6e69 726f 6f74 2e6b 6d6f 642e D miniroot.kmod. │ │ │ │ │ -00041570: 0a6b 6e65 7462 7364 2e78 3836 5f36 342c .knetbsd.x86_64, │ │ │ │ │ -00041580: 2020 2020 2020 2020 2020 2020 2020 2073 s │ │ │ │ │ -00041590: 616d 6520 6672 6f6d 2036 342d 6269 7420 ame from 64-bit │ │ │ │ │ -000415a0: 6b4e 6574 4253 440a 6b6e 6574 6273 642e kNetBSD.knetbsd. │ │ │ │ │ -000415b0: 6d69 6e69 726f 6f74 2e78 3836 5f36 340a miniroot.x86_64. │ │ │ │ │ -000415c0: 6b6f 7065 6e62 7364 2e69 3338 3620 2020 kopenbsd.i386 │ │ │ │ │ -000415d0: 2020 2020 2020 2020 2020 2020 2020 3332 32 │ │ │ │ │ -000415e0: 2d62 6974 204f 7065 6e42 5344 206b 6572 -bit OpenBSD ker │ │ │ │ │ -000415f0: 6e65 6c20 6273 642e 7264 2069 6d61 6765 nel bsd.rd image │ │ │ │ │ -00041600: 0a6b 6f70 656e 6273 642e 7838 365f 3634 .kopenbsd.x86_64 │ │ │ │ │ -00041610: 2020 2020 2020 2020 2020 2020 2020 2073 s │ │ │ │ │ -00041620: 616d 6520 6672 6f6d 2036 342d 6269 7420 ame from 64-bit │ │ │ │ │ -00041630: 6b4f 7065 6e42 5344 0a6c 696e 7578 2e69 kOpenBSD.linux.i │ │ │ │ │ -00041640: 3338 3620 2020 2020 2020 2020 2020 2020 386 │ │ │ │ │ -00041650: 2020 2020 2020 2033 322d 6269 7420 4c69 32-bit Li │ │ │ │ │ -00041660: 6e75 780a 6c69 6e75 782e 7838 365f 3634 nux.linux.x86_64 │ │ │ │ │ +00040eb0: 2020 2020 203f 0a36 342d 6269 7420 584e ?.64-bit XN │ │ │ │ │ +00040ec0: 5520 2020 2020 2020 2020 2020 2020 2020 U │ │ │ │ │ +00040ed0: 2020 2020 2020 2020 2020 2020 3f0a 3332 ?.32 │ │ │ │ │ +00040ee0: 2d62 6974 2045 4649 2063 6861 696e 6c6f -bit EFI chainlo │ │ │ │ │ +00040ef0: 6164 6572 2020 2020 2020 2020 2020 2020 ader │ │ │ │ │ +00040f00: 2020 206e 6f20 2832 290a 3634 2d62 6974 no (2).64-bit │ │ │ │ │ +00040f10: 2045 4649 2063 6861 696e 6c6f 6164 6572 EFI chainloader │ │ │ │ │ +00040f20: 2020 2020 2020 2020 2020 2020 2020 206e n │ │ │ │ │ +00040f30: 6f20 2832 290a 4170 706c 656c 6f61 6465 o (2).Appleloade │ │ │ │ │ +00040f40: 7220 2020 2020 2020 2020 2020 2020 2020 r │ │ │ │ │ +00040f50: 2020 2020 2020 2020 2020 206e 6f20 2832 no (2 │ │ │ │ │ +00040f60: 290a 0a20 2031 2e20 5265 7175 6972 6573 ).. 1. Requires │ │ │ │ │ +00040f70: 2042 494f 530a 2020 322e 2045 4649 206f BIOS. 2. EFI o │ │ │ │ │ +00040f80: 6e6c 790a 2020 332e 2033 322d 6269 7420 nly. 3. 32-bit │ │ │ │ │ +00040f90: 616e 6420 3634 2d62 6974 2045 4649 2068 and 64-bit EFI h │ │ │ │ │ +00040fa0: 6176 6520 6469 6666 6572 656e 7420 7374 ave different st │ │ │ │ │ +00040fb0: 7275 6374 7572 6573 2061 6e64 2077 6f72 ructures and wor │ │ │ │ │ +00040fc0: 6b20 696e 0a20 2020 2020 6469 6666 6572 k in. differ │ │ │ │ │ +00040fd0: 656e 7420 4350 5520 6d6f 6465 7320 736f ent CPU modes so │ │ │ │ │ +00040fe0: 2069 7427 7320 6e6f 7420 706f 7373 6962 it's not possib │ │ │ │ │ +00040ff0: 6c65 2074 6f20 6368 6169 6e6c 6f61 6420 le to chainload │ │ │ │ │ +00041000: 3332 2d62 6974 0a20 2020 2020 626f 6f74 32-bit. boot │ │ │ │ │ +00041010: 6c6f 6164 6572 206f 6e20 3634 2d62 6974 loader on 64-bit │ │ │ │ │ +00041020: 2070 6c61 7466 6f72 6d20 616e 6420 7669 platform and vi │ │ │ │ │ +00041030: 6365 2d76 6572 7361 0a20 2034 2e20 536f ce-versa. 4. So │ │ │ │ │ +00041040: 6d65 206d 6f64 756c 6573 206d 6179 206e me modules may n │ │ │ │ │ +00041050: 6565 6420 746f 2062 6520 6469 7361 626c eed to be disabl │ │ │ │ │ +00041060: 6564 0a20 2035 2e20 5265 7175 6972 6573 ed. 5. Requires │ │ │ │ │ +00041070: 2041 4350 490a 0a20 2020 506f 7765 7250 ACPI.. PowerP │ │ │ │ │ +00041080: 432c 2049 4136 3420 616e 6420 5370 6172 C, IA64 and Spar │ │ │ │ │ +00041090: 6336 3420 706f 7274 7320 7375 7070 6f72 c64 ports suppor │ │ │ │ │ +000410a0: 7420 6f6e 6c79 204c 696e 7578 2e20 204d t only Linux. M │ │ │ │ │ +000410b0: 4950 5320 706f 7274 0a73 7570 706f 7274 IPS port.support │ │ │ │ │ +000410c0: 7320 4c69 6e75 7820 616e 6420 6d75 6c74 s Linux and mult │ │ │ │ │ +000410d0: 6962 6f6f 7432 2e0a 0a32 312e 3120 426f iboot2...21.1 Bo │ │ │ │ │ +000410e0: 6f74 2074 6573 7473 0a3d 3d3d 3d3d 3d3d ot tests.======= │ │ │ │ │ +000410f0: 3d3d 3d3d 3d3d 3d3d 0a0a 4173 2079 6f75 ========..As you │ │ │ │ │ +00041100: 2068 6176 6520 7365 656e 2069 6e20 7072 have seen in pr │ │ │ │ │ +00041110: 6576 696f 7573 2063 6861 7074 6572 2074 evious chapter t │ │ │ │ │ +00041120: 6865 2073 7570 706f 7274 206d 6174 7269 he support matri │ │ │ │ │ +00041130: 7820 6973 2070 7265 7474 7920 6269 670a x is pretty big. │ │ │ │ │ +00041140: 616e 6420 736f 6d65 206f 6620 7468 6520 and some of the │ │ │ │ │ +00041150: 636f 6e66 6967 7572 6174 696f 6e73 2061 configurations a │ │ │ │ │ +00041160: 7265 206f 6e6c 7920 7261 7265 6c79 2075 re only rarely u │ │ │ │ │ +00041170: 7365 642e 2020 546f 2065 6e73 7572 6520 sed. To ensure │ │ │ │ │ +00041180: 7468 650a 7175 616c 6974 7920 626f 6f74 the.quality boot │ │ │ │ │ +00041190: 6368 6563 6b73 2061 7265 2061 7661 696c checks are avail │ │ │ │ │ +000411a0: 6162 6c65 2066 6f72 2061 6c6c 2078 3836 able for all x86 │ │ │ │ │ +000411b0: 2074 6172 6765 7473 2065 7863 6570 7420 targets except │ │ │ │ │ +000411c0: 4546 490a 6368 6169 6e6c 6f61 6465 722c EFI.chainloader, │ │ │ │ │ +000411d0: 2041 7070 6c65 6c6f 6164 6572 2061 6e64 Appleloader and │ │ │ │ │ +000411e0: 2058 4e55 2e20 416c 6c20 7838 3620 706c XNU. All x86 pl │ │ │ │ │ +000411f0: 6174 666f 726d 7320 6861 7665 2062 6f6f atforms have boo │ │ │ │ │ +00041200: 7463 6865 636b 0a66 6163 696c 6974 7920 tcheck.facility │ │ │ │ │ +00041210: 6578 6365 7074 2069 6565 6531 3237 352e except ieee1275. │ │ │ │ │ +00041220: 2020 4d75 6c74 6962 6f6f 742c 206d 756c Multiboot, mul │ │ │ │ │ +00041230: 7469 626f 6f74 322c 2042 494f 5320 6368 tiboot2, BIOS ch │ │ │ │ │ +00041240: 6169 6e6c 6f61 6465 722c 0a6e 746c 6472 ainloader,.ntldr │ │ │ │ │ +00041250: 2061 6e64 2066 7265 6562 7364 2d62 6f6f and freebsd-boo │ │ │ │ │ +00041260: 746c 6f61 6465 7220 626f 6f74 2074 6172 tloader boot tar │ │ │ │ │ +00041270: 6765 7473 2061 7265 2074 6573 7465 6420 gets are tested │ │ │ │ │ +00041280: 6f6e 6c79 2077 6974 6820 6120 6661 6b65 only with a fake │ │ │ │ │ +00041290: 0a6b 6572 6e65 6c20 696d 6167 6573 2e20 .kernel images. │ │ │ │ │ +000412a0: 204f 6e6c 7920 4c69 6e75 7820 6973 2074 Only Linux is t │ │ │ │ │ +000412b0: 6573 7465 6420 616d 6f6e 6720 7468 6520 ested among the │ │ │ │ │ +000412c0: 7061 796c 6f61 6473 2075 7369 6e67 204c payloads using L │ │ │ │ │ +000412d0: 696e 7578 0a70 726f 746f 636f 6c73 2e0a inux.protocols.. │ │ │ │ │ +000412e0: 0a20 2020 466f 6c6c 6f77 696e 6720 7661 . Following va │ │ │ │ │ +000412f0: 7269 6162 6c65 7320 6d75 7374 2062 6520 riables must be │ │ │ │ │ +00041300: 6465 6669 6e65 643a 0a0a 4752 5542 5f50 defined:..GRUB_P │ │ │ │ │ +00041310: 4159 4c4f 4144 535f 4449 5220 2020 2020 AYLOADS_DIR │ │ │ │ │ +00041320: 2064 6972 6563 746f 7279 2063 6f6e 7461 directory conta │ │ │ │ │ +00041330: 696e 696e 6720 7468 6520 7265 7175 6972 ining the requir │ │ │ │ │ +00041340: 6564 206b 6572 6e65 6c73 0a47 5255 425f ed kernels.GRUB_ │ │ │ │ │ +00041350: 4342 4653 544f 4f4c 2020 2020 2020 2020 CBFSTOOL │ │ │ │ │ +00041360: 2020 6362 6673 746f 6f6c 2066 726f 6d20 cbfstool from │ │ │ │ │ +00041370: 436f 7265 626f 6f74 2070 6163 6b61 6765 Coreboot package │ │ │ │ │ +00041380: 2028 666f 7220 636f 7265 626f 6f74 0a20 (for coreboot. │ │ │ │ │ +00041390: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +000413a0: 2020 2020 2020 706c 6174 666f 726d 206f platform o │ │ │ │ │ +000413b0: 6e6c 7929 0a47 5255 425f 434f 5245 424f nly).GRUB_COREBO │ │ │ │ │ +000413c0: 4f54 5f52 4f4d 2020 2020 2020 656d 7074 OT_ROM empt │ │ │ │ │ +000413d0: 7920 436f 7265 626f 6f74 2052 4f4d 0a47 y Coreboot ROM.G │ │ │ │ │ +000413e0: 5255 425f 5145 4d55 5f4f 5054 5320 2020 RUB_QEMU_OPTS │ │ │ │ │ +000413f0: 2020 2020 2020 6164 6469 7469 6f6e 616c additional │ │ │ │ │ +00041400: 206f 7074 696f 6e73 2074 6f20 6265 2073 options to be s │ │ │ │ │ +00041410: 7570 706c 6965 6420 746f 2051 454d 550a upplied to QEMU. │ │ │ │ │ +00041420: 0a20 2020 5265 7175 6972 6564 2066 696c . Required fil │ │ │ │ │ +00041430: 6573 2061 7265 3a0a 0a6b 6672 6565 6273 es are:..kfreebs │ │ │ │ │ +00041440: 645f 656e 762e 6933 3836 2020 2020 2020 d_env.i386 │ │ │ │ │ +00041450: 2020 2020 2020 2033 322d 6269 7420 6b46 32-bit kF │ │ │ │ │ +00041460: 7265 6542 5344 2064 6576 6963 6520 6869 reeBSD device hi │ │ │ │ │ +00041470: 6e74 730a 6b66 7265 6562 7364 2e69 3338 nts.kfreebsd.i38 │ │ │ │ │ +00041480: 3620 2020 2020 2020 2020 2020 2020 2020 6 │ │ │ │ │ +00041490: 2020 3332 2d62 6974 2046 7265 6542 5344 32-bit FreeBSD │ │ │ │ │ +000414a0: 206b 6572 6e65 6c20 696d 6167 650a 6b66 kernel image.kf │ │ │ │ │ +000414b0: 7265 6562 7364 2e78 3836 5f36 342c 2020 reebsd.x86_64, │ │ │ │ │ +000414c0: 2020 2020 2020 2020 2020 2020 7361 6d65 same │ │ │ │ │ +000414d0: 2066 726f 6d20 3634 2d62 6974 206b 4672 from 64-bit kFr │ │ │ │ │ +000414e0: 6565 4253 440a 6b66 7265 6562 7364 5f65 eeBSD.kfreebsd_e │ │ │ │ │ +000414f0: 6e76 2e78 3836 5f36 340a 6b6e 6574 6273 nv.x86_64.knetbs │ │ │ │ │ +00041500: 642e 6933 3836 2020 2020 2020 2020 2020 d.i386 │ │ │ │ │ +00041510: 2020 2020 2020 2020 3332 2d62 6974 204e 32-bit N │ │ │ │ │ +00041520: 6574 4253 4420 6b65 726e 656c 2069 6d61 etBSD kernel ima │ │ │ │ │ +00041530: 6765 0a6b 6e65 7462 7364 2e6d 696e 6972 ge.knetbsd.minir │ │ │ │ │ +00041540: 6f6f 742e 6933 3836 2020 2020 2020 2020 oot.i386 │ │ │ │ │ +00041550: 2033 322d 6269 7420 6b4e 6574 4253 4420 32-bit kNetBSD │ │ │ │ │ +00041560: 6d69 6e69 726f 6f74 2e6b 6d6f 642e 0a6b miniroot.kmod..k │ │ │ │ │ +00041570: 6e65 7462 7364 2e78 3836 5f36 342c 2020 netbsd.x86_64, │ │ │ │ │ +00041580: 2020 2020 2020 2020 2020 2020 2073 616d sam │ │ │ │ │ +00041590: 6520 6672 6f6d 2036 342d 6269 7420 6b4e e from 64-bit kN │ │ │ │ │ +000415a0: 6574 4253 440a 6b6e 6574 6273 642e 6d69 etBSD.knetbsd.mi │ │ │ │ │ +000415b0: 6e69 726f 6f74 2e78 3836 5f36 340a 6b6f niroot.x86_64.ko │ │ │ │ │ +000415c0: 7065 6e62 7364 2e69 3338 3620 2020 2020 penbsd.i386 │ │ │ │ │ +000415d0: 2020 2020 2020 2020 2020 2020 3332 2d62 32-b │ │ │ │ │ +000415e0: 6974 204f 7065 6e42 5344 206b 6572 6e65 it OpenBSD kerne │ │ │ │ │ +000415f0: 6c20 6273 642e 7264 2069 6d61 6765 0a6b l bsd.rd image.k │ │ │ │ │ +00041600: 6f70 656e 6273 642e 7838 365f 3634 2020 openbsd.x86_64 │ │ │ │ │ +00041610: 2020 2020 2020 2020 2020 2020 2073 616d sam │ │ │ │ │ +00041620: 6520 6672 6f6d 2036 342d 6269 7420 6b4f e from 64-bit kO │ │ │ │ │ +00041630: 7065 6e42 5344 0a6c 696e 7578 2e69 3338 penBSD.linux.i38 │ │ │ │ │ +00041640: 3620 2020 2020 2020 2020 2020 2020 2020 6 │ │ │ │ │ +00041650: 2020 2020 2033 322d 6269 7420 4c69 6e75 32-bit Linu │ │ │ │ │ +00041660: 780a 6c69 6e75 782e 7838 365f 3634 2020 x.linux.x86_64 │ │ │ │ │ 00041670: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00041680: 2020 3634 2d62 6974 204c 696e 7578 0a0a 64-bit Linux.. │ │ │ │ │ -00041690: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ -000416a0: 6f2c 2020 4e6f 6465 3a20 5472 6f75 626c o, Node: Troubl │ │ │ │ │ -000416b0: 6573 686f 6f74 696e 672c 2020 4e65 7874 eshooting, Next │ │ │ │ │ -000416c0: 3a20 496e 766f 6b69 6e67 2067 7275 622d : Invoking grub- │ │ │ │ │ -000416d0: 696e 7374 616c 6c2c 2020 5072 6576 3a20 install, Prev: │ │ │ │ │ -000416e0: 5375 7070 6f72 7465 6420 6b65 726e 656c Supported kernel │ │ │ │ │ -000416f0: 732c 2020 5570 3a20 546f 700a 0a32 3220 s, Up: Top..22 │ │ │ │ │ -00041700: 4572 726f 7220 6d65 7373 6167 6573 2070 Error messages p │ │ │ │ │ -00041710: 726f 6475 6365 6420 6279 2047 5255 420a roduced by GRUB. │ │ │ │ │ +00041680: 3634 2d62 6974 204c 696e 7578 0a0a 1f0a 64-bit Linux.... │ │ │ │ │ +00041690: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ +000416a0: 2020 4e6f 6465 3a20 5472 6f75 626c 6573 Node: Troubles │ │ │ │ │ +000416b0: 686f 6f74 696e 672c 2020 4e65 7874 3a20 hooting, Next: │ │ │ │ │ +000416c0: 496e 766f 6b69 6e67 2067 7275 622d 696e Invoking grub-in │ │ │ │ │ +000416d0: 7374 616c 6c2c 2020 5072 6576 3a20 5375 stall, Prev: Su │ │ │ │ │ +000416e0: 7070 6f72 7465 6420 6b65 726e 656c 732c pported kernels, │ │ │ │ │ +000416f0: 2020 5570 3a20 546f 700a 0a32 3220 4572 Up: Top..22 Er │ │ │ │ │ +00041700: 726f 7220 6d65 7373 6167 6573 2070 726f ror messages pro │ │ │ │ │ +00041710: 6475 6365 6420 6279 2047 5255 420a 2a2a duced by GRUB.** │ │ │ │ │ 00041720: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ 00041730: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -00041740: 2a2a 0a0a 2a20 4d65 6e75 3a0a 0a2a 2047 **..* Menu:..* G │ │ │ │ │ -00041750: 5255 4220 6f6e 6c79 206f 6666 6572 7320 RUB only offers │ │ │ │ │ -00041760: 6120 7265 7363 7565 2073 6865 6c6c 3a3a a rescue shell:: │ │ │ │ │ -00041770: 0a2a 2046 6972 6d77 6172 6520 7374 616c .* Firmware stal │ │ │ │ │ -00041780: 6c73 2069 6e73 7465 6164 206f 6620 626f ls instead of bo │ │ │ │ │ -00041790: 6f74 696e 6720 4752 5542 3a3a 0a0a 1f0a oting GRUB::.... │ │ │ │ │ -000417a0: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ -000417b0: 2020 4e6f 6465 3a20 4752 5542 206f 6e6c Node: GRUB onl │ │ │ │ │ -000417c0: 7920 6f66 6665 7273 2061 2072 6573 6375 y offers a rescu │ │ │ │ │ -000417d0: 6520 7368 656c 6c2c 2020 4e65 7874 3a20 e shell, Next: │ │ │ │ │ -000417e0: 4669 726d 7761 7265 2073 7461 6c6c 7320 Firmware stalls │ │ │ │ │ -000417f0: 696e 7374 6561 6420 6f66 2062 6f6f 7469 instead of booti │ │ │ │ │ -00041800: 6e67 2047 5255 422c 2020 5570 3a20 5472 ng GRUB, Up: Tr │ │ │ │ │ -00041810: 6f75 626c 6573 686f 6f74 696e 670a 0a32 oubleshooting..2 │ │ │ │ │ -00041820: 322e 3120 4752 5542 206f 6e6c 7920 6f66 2.1 GRUB only of │ │ │ │ │ -00041830: 6665 7273 2061 2072 6573 6375 6520 7368 fers a rescue sh │ │ │ │ │ -00041840: 656c 6c0a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ell.============ │ │ │ │ │ +00041740: 0a0a 2a20 4d65 6e75 3a0a 0a2a 2047 5255 ..* Menu:..* GRU │ │ │ │ │ +00041750: 4220 6f6e 6c79 206f 6666 6572 7320 6120 B only offers a │ │ │ │ │ +00041760: 7265 7363 7565 2073 6865 6c6c 3a3a 0a2a rescue shell::.* │ │ │ │ │ +00041770: 2046 6972 6d77 6172 6520 7374 616c 6c73 Firmware stalls │ │ │ │ │ +00041780: 2069 6e73 7465 6164 206f 6620 626f 6f74 instead of boot │ │ │ │ │ +00041790: 696e 6720 4752 5542 3a3a 0a0a 1f0a 4669 ing GRUB::....Fi │ │ │ │ │ +000417a0: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ +000417b0: 4e6f 6465 3a20 4752 5542 206f 6e6c 7920 Node: GRUB only │ │ │ │ │ +000417c0: 6f66 6665 7273 2061 2072 6573 6375 6520 offers a rescue │ │ │ │ │ +000417d0: 7368 656c 6c2c 2020 4e65 7874 3a20 4669 shell, Next: Fi │ │ │ │ │ +000417e0: 726d 7761 7265 2073 7461 6c6c 7320 696e rmware stalls in │ │ │ │ │ +000417f0: 7374 6561 6420 6f66 2062 6f6f 7469 6e67 stead of booting │ │ │ │ │ +00041800: 2047 5255 422c 2020 5570 3a20 5472 6f75 GRUB, Up: Trou │ │ │ │ │ +00041810: 626c 6573 686f 6f74 696e 670a 0a32 322e bleshooting..22. │ │ │ │ │ +00041820: 3120 4752 5542 206f 6e6c 7920 6f66 6665 1 GRUB only offe │ │ │ │ │ +00041830: 7273 2061 2072 6573 6375 6520 7368 656c rs a rescue shel │ │ │ │ │ +00041840: 6c0a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d l.============== │ │ │ │ │ 00041850: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00041860: 3d3d 3d3d 3d3d 3d3d 0a0a 4752 5542 2773 ========..GRUB's │ │ │ │ │ -00041870: 206e 6f72 6d61 6c20 7374 6172 742d 7570 normal start-up │ │ │ │ │ -00041880: 2070 726f 6365 6475 7265 2069 6e76 6f6c procedure invol │ │ │ │ │ -00041890: 7665 7320 7365 7474 696e 6720 7468 6520 ves setting the │ │ │ │ │ -000418a0: 2770 7265 6669 7827 0a65 6e76 6972 6f6e 'prefix'.environ │ │ │ │ │ -000418b0: 6d65 6e74 2076 6172 6961 626c 6520 746f ment variable to │ │ │ │ │ -000418c0: 2061 2076 616c 7565 2073 6574 2069 6e20 a value set in │ │ │ │ │ -000418d0: 7468 6520 636f 7265 2069 6d61 6765 2062 the core image b │ │ │ │ │ -000418e0: 7920 2767 7275 622d 696e 7374 616c 6c27 y 'grub-install' │ │ │ │ │ -000418f0: 2c0a 7365 7474 696e 6720 7468 6520 2772 ,.setting the 'r │ │ │ │ │ -00041900: 6f6f 7427 2076 6172 6961 626c 6520 746f oot' variable to │ │ │ │ │ -00041910: 206d 6174 6368 2c20 6c6f 6164 696e 6720 match, loading │ │ │ │ │ -00041920: 7468 6520 276e 6f72 6d61 6c27 206d 6f64 the 'normal' mod │ │ │ │ │ -00041930: 756c 6520 6672 6f6d 0a74 6865 2070 7265 ule from.the pre │ │ │ │ │ -00041940: 6669 782c 2061 6e64 2072 756e 6e69 6e67 fix, and running │ │ │ │ │ -00041950: 2074 6865 2027 6e6f 726d 616c 2720 636f the 'normal' co │ │ │ │ │ -00041960: 6d6d 616e 6420 282a 6e6f 7465 206e 6f72 mmand (*note nor │ │ │ │ │ -00041970: 6d61 6c3a 3a29 2e20 2054 6869 730a 636f mal::). This.co │ │ │ │ │ -00041980: 6d6d 616e 6420 6973 2072 6573 706f 6e73 mmand is respons │ │ │ │ │ -00041990: 6962 6c65 2066 6f72 2072 6561 6469 6e67 ible for reading │ │ │ │ │ -000419a0: 2027 2f62 6f6f 742f 6772 7562 2f67 7275 '/boot/grub/gru │ │ │ │ │ -000419b0: 622e 6366 6727 2c20 7275 6e6e 696e 6720 b.cfg', running │ │ │ │ │ -000419c0: 7468 650a 6d65 6e75 2c20 616e 6420 646f the.menu, and do │ │ │ │ │ -000419d0: 696e 6720 616c 6c20 7468 6520 7573 6566 ing all the usef │ │ │ │ │ -000419e0: 756c 2074 6869 6e67 7320 4752 5542 2069 ul things GRUB i │ │ │ │ │ -000419f0: 7320 7375 7070 6f73 6564 2074 6f20 646f s supposed to do │ │ │ │ │ -00041a00: 2e0a 0a20 2020 4966 2c20 696e 7374 6561 ... If, instea │ │ │ │ │ -00041a10: 642c 2079 6f75 206f 6e6c 7920 6765 7420 d, you only get │ │ │ │ │ -00041a20: 6120 7265 7363 7565 2073 6865 6c6c 2c20 a rescue shell, │ │ │ │ │ -00041a30: 7468 6973 2075 7375 616c 6c79 206d 6561 this usually mea │ │ │ │ │ -00041a40: 6e73 2074 6861 740a 4752 5542 2066 6169 ns that.GRUB fai │ │ │ │ │ -00041a50: 6c65 6420 746f 206c 6f61 6420 7468 6520 led to load the │ │ │ │ │ -00041a60: 276e 6f72 6d61 6c27 206d 6f64 756c 6520 'normal' module │ │ │ │ │ -00041a70: 666f 7220 736f 6d65 2072 6561 736f 6e2e for some reason. │ │ │ │ │ -00041a80: 2020 4974 206d 6179 2062 650a 706f 7373 It may be.poss │ │ │ │ │ -00041a90: 6962 6c65 2074 6f20 776f 726b 2061 726f ible to work aro │ │ │ │ │ -00041aa0: 756e 6420 7468 6973 2074 656d 706f 7261 und this tempora │ │ │ │ │ -00041ab0: 7269 6c79 3a20 666f 7220 696e 7374 616e rily: for instan │ │ │ │ │ -00041ac0: 6365 2c20 6966 2074 6865 2072 6561 736f ce, if the reaso │ │ │ │ │ -00041ad0: 6e0a 666f 7220 7468 6520 6661 696c 7572 n.for the failur │ │ │ │ │ -00041ae0: 6520 6973 2074 6861 7420 2770 7265 6669 e is that 'prefi │ │ │ │ │ -00041af0: 7827 2069 7320 7772 6f6e 6720 2870 6572 x' is wrong (per │ │ │ │ │ -00041b00: 6861 7073 2069 7420 7265 6665 7273 2074 haps it refers t │ │ │ │ │ -00041b10: 6f20 7468 650a 7772 6f6e 6720 6465 7669 o the.wrong devi │ │ │ │ │ -00041b20: 6365 2c20 6f72 2070 6572 6861 7073 2074 ce, or perhaps t │ │ │ │ │ -00041b30: 6865 2070 6174 6820 746f 2027 2f62 6f6f he path to '/boo │ │ │ │ │ -00041b40: 742f 6772 7562 2720 7761 7320 6e6f 7420 t/grub' was not │ │ │ │ │ -00041b50: 636f 7272 6563 746c 7920 6d61 6465 0a72 correctly made.r │ │ │ │ │ -00041b60: 656c 6174 6976 6520 746f 2074 6865 2064 elative to the d │ │ │ │ │ -00041b70: 6576 6963 6529 2c20 7468 656e 2079 6f75 evice), then you │ │ │ │ │ -00041b80: 2063 616e 2063 6f72 7265 6374 2074 6869 can correct thi │ │ │ │ │ -00041b90: 7320 616e 6420 656e 7465 7220 6e6f 726d s and enter norm │ │ │ │ │ -00041ba0: 616c 206d 6f64 650a 6d61 6e75 616c 6c79 al mode.manually │ │ │ │ │ -00041bb0: 3a0a 0a20 2020 2020 2320 496e 7370 6563 :.. # Inspec │ │ │ │ │ -00041bc0: 7420 7468 6520 6375 7272 656e 7420 7072 t the current pr │ │ │ │ │ -00041bd0: 6566 6978 2028 616e 6420 6f74 6865 7220 efix (and other │ │ │ │ │ -00041be0: 7072 6573 6574 2076 6172 6961 626c 6573 preset variables │ │ │ │ │ -00041bf0: 293a 0a20 2020 2020 7365 740a 2020 2020 ):. set. │ │ │ │ │ -00041c00: 2023 2046 696e 6420 6f75 7420 7768 6963 # Find out whic │ │ │ │ │ -00041c10: 6820 6465 7669 6365 7320 6172 6520 6176 h devices are av │ │ │ │ │ -00041c20: 6169 6c61 626c 653a 0a20 2020 2020 6c73 ailable:. ls │ │ │ │ │ -00041c30: 0a20 2020 2020 2320 5365 7420 746f 2074 . # Set to t │ │ │ │ │ -00041c40: 6865 2063 6f72 7265 6374 2076 616c 7565 he correct value │ │ │ │ │ -00041c50: 2c20 7768 6963 6820 6d69 6768 7420 6265 , which might be │ │ │ │ │ -00041c60: 2073 6f6d 6574 6869 6e67 206c 696b 6520 something like │ │ │ │ │ -00041c70: 7468 6973 3a0a 2020 2020 2073 6574 2070 this:. set p │ │ │ │ │ -00041c80: 7265 6669 783d 2868 6430 2c31 292f 6772 refix=(hd0,1)/gr │ │ │ │ │ -00041c90: 7562 0a20 2020 2020 7365 7420 726f 6f74 ub. set root │ │ │ │ │ -00041ca0: 3d28 6864 302c 3129 0a20 2020 2020 696e =(hd0,1). in │ │ │ │ │ -00041cb0: 736d 6f64 206e 6f72 6d61 6c0a 2020 2020 smod normal. │ │ │ │ │ -00041cc0: 206e 6f72 6d61 6c0a 0a20 2020 486f 7765 normal.. Howe │ │ │ │ │ -00041cd0: 7665 722c 2061 6e79 2070 726f 626c 656d ver, any problem │ │ │ │ │ -00041ce0: 2074 6861 7420 6c65 6176 6573 2079 6f75 that leaves you │ │ │ │ │ -00041cf0: 2069 6e20 7468 6520 7265 7363 7565 2073 in the rescue s │ │ │ │ │ -00041d00: 6865 6c6c 2070 726f 6261 626c 790a 6d65 hell probably.me │ │ │ │ │ -00041d10: 616e 7320 7468 6174 2047 5255 4220 7761 ans that GRUB wa │ │ │ │ │ -00041d20: 7320 6e6f 7420 636f 7272 6563 746c 7920 s not correctly │ │ │ │ │ -00041d30: 696e 7374 616c 6c65 642e 2020 4974 206d installed. It m │ │ │ │ │ -00041d40: 6179 2062 6520 6d6f 7265 2075 7365 6675 ay be more usefu │ │ │ │ │ -00041d50: 6c20 746f 0a74 7279 2074 6f20 7265 696e l to.try to rein │ │ │ │ │ -00041d60: 7374 616c 6c20 6974 2070 726f 7065 726c stall it properl │ │ │ │ │ -00041d70: 7920 7573 696e 6720 2767 7275 622d 696e y using 'grub-in │ │ │ │ │ -00041d80: 7374 616c 6c20 4445 5649 4345 2720 282a stall DEVICE' (* │ │ │ │ │ -00041d90: 6e6f 7465 2049 6e76 6f6b 696e 670a 6772 note Invoking.gr │ │ │ │ │ -00041da0: 7562 2d69 6e73 7461 6c6c 3a3a 292e 2020 ub-install::). │ │ │ │ │ -00041db0: 5768 656e 2064 6f69 6e67 2074 6869 732c When doing this, │ │ │ │ │ -00041dc0: 2074 6865 7265 2061 7265 2061 2066 6577 there are a few │ │ │ │ │ -00041dd0: 2074 6869 6e67 7320 746f 2072 656d 656d things to remem │ │ │ │ │ -00041de0: 6265 723a 0a0a 2020 202a 2044 7269 7665 ber:.. * Drive │ │ │ │ │ -00041df0: 206f 7264 6572 696e 6720 696e 2079 6f75 ordering in you │ │ │ │ │ -00041e00: 7220 6f70 6572 6174 696e 6720 7379 7374 r operating syst │ │ │ │ │ -00041e10: 656d 206d 6179 206e 6f74 2062 6520 7468 em may not be th │ │ │ │ │ -00041e20: 6520 7361 6d65 2061 7320 7468 650a 2020 e same as the. │ │ │ │ │ -00041e30: 2020 2062 6f6f 7420 6472 6976 6520 6f72 boot drive or │ │ │ │ │ -00041e40: 6465 7269 6e67 2075 7365 6420 6279 2079 dering used by y │ │ │ │ │ -00041e50: 6f75 7220 6669 726d 7761 7265 2e20 2044 our firmware. D │ │ │ │ │ -00041e60: 6f20 6e6f 7420 6173 7375 6d65 2074 6861 o not assume tha │ │ │ │ │ -00041e70: 7420 796f 7572 0a20 2020 2020 6669 7273 t your. firs │ │ │ │ │ -00041e80: 7420 6861 7264 2064 7269 7665 2028 652e t hard drive (e. │ │ │ │ │ -00041e90: 672e 2020 272f 6465 762f 7364 6127 2920 g. '/dev/sda') │ │ │ │ │ -00041ea0: 6973 2074 6865 206f 6e65 2074 6861 7420 is the one that │ │ │ │ │ -00041eb0: 796f 7572 2066 6972 6d77 6172 650a 2020 your firmware. │ │ │ │ │ -00041ec0: 2020 2077 696c 6c20 626f 6f74 2066 726f will boot fro │ │ │ │ │ -00041ed0: 6d2e 2020 2764 6576 6963 652e 6d61 7027 m. 'device.map' │ │ │ │ │ -00041ee0: 2028 2a6e 6f74 6520 4465 7669 6365 206d (*note Device m │ │ │ │ │ -00041ef0: 6170 3a3a 2920 6361 6e20 6265 2075 7365 ap::) can be use │ │ │ │ │ -00041f00: 6420 746f 0a20 2020 2020 6f76 6572 7269 d to. overri │ │ │ │ │ -00041f10: 6465 2074 6869 732c 2062 7574 2069 7420 de this, but it │ │ │ │ │ -00041f20: 6973 2075 7375 616c 6c79 2062 6574 7465 is usually bette │ │ │ │ │ -00041f30: 7220 746f 2075 7365 2055 5549 4473 206f r to use UUIDs o │ │ │ │ │ -00041f40: 7220 6669 6c65 2073 7973 7465 6d0a 2020 r file system. │ │ │ │ │ -00041f50: 2020 206c 6162 656c 7320 616e 6420 6176 labels and av │ │ │ │ │ -00041f60: 6f69 6420 6465 7065 6e64 696e 6720 6f6e oid depending on │ │ │ │ │ -00041f70: 2064 7269 7665 206f 7264 6572 696e 6720 drive ordering │ │ │ │ │ -00041f80: 656e 7469 7265 6c79 2e0a 0a20 2020 2a20 entirely... * │ │ │ │ │ -00041f90: 4174 206c 6561 7374 206f 6e20 4249 4f53 At least on BIOS │ │ │ │ │ -00041fa0: 2073 7973 7465 6d73 2c20 6966 2079 6f75 systems, if you │ │ │ │ │ -00041fb0: 2074 656c 6c20 2767 7275 622d 696e 7374 tell 'grub-inst │ │ │ │ │ -00041fc0: 616c 6c27 2074 6f20 696e 7374 616c 6c0a all' to install. │ │ │ │ │ -00041fd0: 2020 2020 2047 5255 4220 746f 2061 2070 GRUB to a p │ │ │ │ │ -00041fe0: 6172 7469 7469 6f6e 2062 7574 2047 5255 artition but GRU │ │ │ │ │ -00041ff0: 4220 6861 7320 616c 7265 6164 7920 6265 B has already be │ │ │ │ │ -00042000: 656e 2069 6e73 7461 6c6c 6564 2069 6e20 en installed in │ │ │ │ │ -00042010: 7468 650a 2020 2020 206d 6173 7465 7220 the. master │ │ │ │ │ -00042020: 626f 6f74 2072 6563 6f72 642c 2074 6865 boot record, the │ │ │ │ │ -00042030: 6e20 7468 6520 4752 5542 2069 6e73 7461 n the GRUB insta │ │ │ │ │ -00042040: 6c6c 6174 696f 6e20 696e 2074 6865 2070 llation in the p │ │ │ │ │ -00042050: 6172 7469 7469 6f6e 0a20 2020 2020 7769 artition. wi │ │ │ │ │ -00042060: 6c6c 2062 6520 6967 6e6f 7265 642e 0a0a ll be ignored... │ │ │ │ │ -00042070: 2020 202a 2049 6620 706f 7373 6962 6c65 * If possible │ │ │ │ │ -00042080: 2c20 6974 2069 7320 6765 6e65 7261 6c6c , it is generall │ │ │ │ │ -00042090: 7920 6265 7374 2074 6f20 6176 6f69 6420 y best to avoid │ │ │ │ │ -000420a0: 696e 7374 616c 6c69 6e67 2047 5255 4220 installing GRUB │ │ │ │ │ -000420b0: 746f 2061 0a20 2020 2020 7061 7274 6974 to a. partit │ │ │ │ │ -000420c0: 696f 6e20 2875 6e6c 6573 7320 6974 2069 ion (unless it i │ │ │ │ │ -000420d0: 7320 6120 7370 6563 6961 6c20 7061 7274 s a special part │ │ │ │ │ -000420e0: 6974 696f 6e20 666f 7220 7468 6520 7573 ition for the us │ │ │ │ │ -000420f0: 6520 6f66 2047 5255 420a 2020 2020 2061 e of GRUB. a │ │ │ │ │ -00042100: 6c6f 6e65 2c20 7375 6368 2061 7320 7468 lone, such as th │ │ │ │ │ -00042110: 6520 4249 4f53 2042 6f6f 7420 5061 7274 e BIOS Boot Part │ │ │ │ │ -00042120: 6974 696f 6e20 7573 6564 206f 6e20 4750 ition used on GP │ │ │ │ │ -00042130: 5429 2e20 446f 696e 6720 7468 6973 0a20 T). Doing this. │ │ │ │ │ -00042140: 2020 2020 6d65 616e 7320 7468 6174 2047 means that G │ │ │ │ │ -00042150: 5255 4220 6d61 7920 7374 6f70 2062 6569 RUB may stop bei │ │ │ │ │ -00042160: 6e67 2061 626c 6520 746f 2072 6561 6420 ng able to read │ │ │ │ │ -00042170: 6974 7320 636f 7265 2069 6d61 6765 2064 its core image d │ │ │ │ │ -00042180: 7565 2074 6f20 610a 2020 2020 2066 696c ue to a. fil │ │ │ │ │ -00042190: 6520 7379 7374 656d 206d 6f76 696e 6720 e system moving │ │ │ │ │ -000421a0: 626c 6f63 6b73 2061 726f 756e 642c 2073 blocks around, s │ │ │ │ │ -000421b0: 7563 6820 6173 2077 6869 6c65 2064 6566 uch as while def │ │ │ │ │ -000421c0: 7261 676d 656e 7469 6e67 2c0a 2020 2020 ragmenting,. │ │ │ │ │ -000421d0: 2072 756e 6e69 6e67 2063 6865 636b 732c running checks, │ │ │ │ │ -000421e0: 206f 7220 6576 656e 2064 7572 696e 6720 or even during │ │ │ │ │ -000421f0: 6e6f 726d 616c 206f 7065 7261 7469 6f6e normal operation │ │ │ │ │ -00042200: 2e20 2049 6e73 7461 6c6c 696e 6720 746f . Installing to │ │ │ │ │ -00042210: 2074 6865 0a20 2020 2020 7768 6f6c 6520 the. whole │ │ │ │ │ -00042220: 6469 736b 2064 6576 6963 6520 6973 206e disk device is n │ │ │ │ │ -00042230: 6f72 6d61 6c6c 7920 6d6f 7265 2072 6f62 ormally more rob │ │ │ │ │ -00042240: 7573 742e 0a0a 2020 202a 2043 6865 636b ust... * Check │ │ │ │ │ -00042250: 2074 6861 7420 4752 5542 2061 6374 7561 that GRUB actua │ │ │ │ │ -00042260: 6c6c 7920 6b6e 6f77 7320 686f 7720 746f lly knows how to │ │ │ │ │ -00042270: 2072 6561 6420 6672 6f6d 2074 6865 2064 read from the d │ │ │ │ │ -00042280: 6576 6963 6520 616e 6420 6669 6c65 0a20 evice and file. │ │ │ │ │ -00042290: 2020 2020 7379 7374 656d 2063 6f6e 7461 system conta │ │ │ │ │ -000422a0: 696e 696e 6720 272f 626f 6f74 2f67 7275 ining '/boot/gru │ │ │ │ │ -000422b0: 6227 2e20 2049 7420 7769 6c6c 206e 6f74 b'. It will not │ │ │ │ │ -000422c0: 2062 6520 6162 6c65 2074 6f20 7265 6164 be able to read │ │ │ │ │ -000422d0: 2066 726f 6d0a 2020 2020 2065 6e63 7279 from. encry │ │ │ │ │ -000422e0: 7074 6564 2064 6576 6963 6573 2077 6974 pted devices wit │ │ │ │ │ -000422f0: 6820 756e 7375 7070 6f72 7465 6420 656e h unsupported en │ │ │ │ │ -00042300: 6372 7970 7469 6f6e 2073 6368 656d 652c cryption scheme, │ │ │ │ │ -00042310: 206e 6f72 2066 726f 6d20 6669 6c65 0a20 nor from file. │ │ │ │ │ -00042320: 2020 2020 7379 7374 656d 7320 666f 7220 systems for │ │ │ │ │ -00042330: 7768 6963 6820 7375 7070 6f72 7420 6861 which support ha │ │ │ │ │ -00042340: 7320 6e6f 7420 7965 7420 6265 656e 2061 s not yet been a │ │ │ │ │ -00042350: 6464 6564 2074 6f20 4752 5542 2e0a 0a1f dded to GRUB.... │ │ │ │ │ -00042360: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ -00042370: 2c20 204e 6f64 653a 2046 6972 6d77 6172 , Node: Firmwar │ │ │ │ │ -00042380: 6520 7374 616c 6c73 2069 6e73 7465 6164 e stalls instead │ │ │ │ │ -00042390: 206f 6620 626f 6f74 696e 6720 4752 5542 of booting GRUB │ │ │ │ │ -000423a0: 2c20 2050 7265 763a 2047 5255 4220 6f6e , Prev: GRUB on │ │ │ │ │ -000423b0: 6c79 206f 6666 6572 7320 6120 7265 7363 ly offers a resc │ │ │ │ │ -000423c0: 7565 2073 6865 6c6c 2c20 2055 703a 2054 ue shell, Up: T │ │ │ │ │ -000423d0: 726f 7562 6c65 7368 6f6f 7469 6e67 0a0a roubleshooting.. │ │ │ │ │ -000423e0: 3232 2e32 2046 6972 6d77 6172 6520 7374 22.2 Firmware st │ │ │ │ │ -000423f0: 616c 6c73 2069 6e73 7465 6164 206f 6620 alls instead of │ │ │ │ │ -00042400: 626f 6f74 696e 6720 4752 5542 0a3d 3d3d booting GRUB.=== │ │ │ │ │ +00041860: 3d3d 3d3d 3d3d 0a0a 4752 5542 2773 206e ======..GRUB's n │ │ │ │ │ +00041870: 6f72 6d61 6c20 7374 6172 742d 7570 2070 ormal start-up p │ │ │ │ │ +00041880: 726f 6365 6475 7265 2069 6e76 6f6c 7665 rocedure involve │ │ │ │ │ +00041890: 7320 7365 7474 696e 6720 7468 6520 2770 s setting the 'p │ │ │ │ │ +000418a0: 7265 6669 7827 0a65 6e76 6972 6f6e 6d65 refix'.environme │ │ │ │ │ +000418b0: 6e74 2076 6172 6961 626c 6520 746f 2061 nt variable to a │ │ │ │ │ +000418c0: 2076 616c 7565 2073 6574 2069 6e20 7468 value set in th │ │ │ │ │ +000418d0: 6520 636f 7265 2069 6d61 6765 2062 7920 e core image by │ │ │ │ │ +000418e0: 2767 7275 622d 696e 7374 616c 6c27 2c0a 'grub-install',. │ │ │ │ │ +000418f0: 7365 7474 696e 6720 7468 6520 2772 6f6f setting the 'roo │ │ │ │ │ +00041900: 7427 2076 6172 6961 626c 6520 746f 206d t' variable to m │ │ │ │ │ +00041910: 6174 6368 2c20 6c6f 6164 696e 6720 7468 atch, loading th │ │ │ │ │ +00041920: 6520 276e 6f72 6d61 6c27 206d 6f64 756c e 'normal' modul │ │ │ │ │ +00041930: 6520 6672 6f6d 0a74 6865 2070 7265 6669 e from.the prefi │ │ │ │ │ +00041940: 782c 2061 6e64 2072 756e 6e69 6e67 2074 x, and running t │ │ │ │ │ +00041950: 6865 2027 6e6f 726d 616c 2720 636f 6d6d he 'normal' comm │ │ │ │ │ +00041960: 616e 6420 282a 6e6f 7465 206e 6f72 6d61 and (*note norma │ │ │ │ │ +00041970: 6c3a 3a29 2e20 2054 6869 730a 636f 6d6d l::). This.comm │ │ │ │ │ +00041980: 616e 6420 6973 2072 6573 706f 6e73 6962 and is responsib │ │ │ │ │ +00041990: 6c65 2066 6f72 2072 6561 6469 6e67 2027 le for reading ' │ │ │ │ │ +000419a0: 2f62 6f6f 742f 6772 7562 2f67 7275 622e /boot/grub/grub. │ │ │ │ │ +000419b0: 6366 6727 2c20 7275 6e6e 696e 6720 7468 cfg', running th │ │ │ │ │ +000419c0: 650a 6d65 6e75 2c20 616e 6420 646f 696e e.menu, and doin │ │ │ │ │ +000419d0: 6720 616c 6c20 7468 6520 7573 6566 756c g all the useful │ │ │ │ │ +000419e0: 2074 6869 6e67 7320 4752 5542 2069 7320 things GRUB is │ │ │ │ │ +000419f0: 7375 7070 6f73 6564 2074 6f20 646f 2e0a supposed to do.. │ │ │ │ │ +00041a00: 0a20 2020 4966 2c20 696e 7374 6561 642c . If, instead, │ │ │ │ │ +00041a10: 2079 6f75 206f 6e6c 7920 6765 7420 6120 you only get a │ │ │ │ │ +00041a20: 7265 7363 7565 2073 6865 6c6c 2c20 7468 rescue shell, th │ │ │ │ │ +00041a30: 6973 2075 7375 616c 6c79 206d 6561 6e73 is usually means │ │ │ │ │ +00041a40: 2074 6861 740a 4752 5542 2066 6169 6c65 that.GRUB faile │ │ │ │ │ +00041a50: 6420 746f 206c 6f61 6420 7468 6520 276e d to load the 'n │ │ │ │ │ +00041a60: 6f72 6d61 6c27 206d 6f64 756c 6520 666f ormal' module fo │ │ │ │ │ +00041a70: 7220 736f 6d65 2072 6561 736f 6e2e 2020 r some reason. │ │ │ │ │ +00041a80: 4974 206d 6179 2062 650a 706f 7373 6962 It may be.possib │ │ │ │ │ +00041a90: 6c65 2074 6f20 776f 726b 2061 726f 756e le to work aroun │ │ │ │ │ +00041aa0: 6420 7468 6973 2074 656d 706f 7261 7269 d this temporari │ │ │ │ │ +00041ab0: 6c79 3a20 666f 7220 696e 7374 616e 6365 ly: for instance │ │ │ │ │ +00041ac0: 2c20 6966 2074 6865 2072 6561 736f 6e0a , if the reason. │ │ │ │ │ +00041ad0: 666f 7220 7468 6520 6661 696c 7572 6520 for the failure │ │ │ │ │ +00041ae0: 6973 2074 6861 7420 2770 7265 6669 7827 is that 'prefix' │ │ │ │ │ +00041af0: 2069 7320 7772 6f6e 6720 2870 6572 6861 is wrong (perha │ │ │ │ │ +00041b00: 7073 2069 7420 7265 6665 7273 2074 6f20 ps it refers to │ │ │ │ │ +00041b10: 7468 650a 7772 6f6e 6720 6465 7669 6365 the.wrong device │ │ │ │ │ +00041b20: 2c20 6f72 2070 6572 6861 7073 2074 6865 , or perhaps the │ │ │ │ │ +00041b30: 2070 6174 6820 746f 2027 2f62 6f6f 742f path to '/boot/ │ │ │ │ │ +00041b40: 6772 7562 2720 7761 7320 6e6f 7420 636f grub' was not co │ │ │ │ │ +00041b50: 7272 6563 746c 7920 6d61 6465 0a72 656c rrectly made.rel │ │ │ │ │ +00041b60: 6174 6976 6520 746f 2074 6865 2064 6576 ative to the dev │ │ │ │ │ +00041b70: 6963 6529 2c20 7468 656e 2079 6f75 2063 ice), then you c │ │ │ │ │ +00041b80: 616e 2063 6f72 7265 6374 2074 6869 7320 an correct this │ │ │ │ │ +00041b90: 616e 6420 656e 7465 7220 6e6f 726d 616c and enter normal │ │ │ │ │ +00041ba0: 206d 6f64 650a 6d61 6e75 616c 6c79 3a0a mode.manually:. │ │ │ │ │ +00041bb0: 0a20 2020 2020 2320 496e 7370 6563 7420 . # Inspect │ │ │ │ │ +00041bc0: 7468 6520 6375 7272 656e 7420 7072 6566 the current pref │ │ │ │ │ +00041bd0: 6978 2028 616e 6420 6f74 6865 7220 7072 ix (and other pr │ │ │ │ │ +00041be0: 6573 6574 2076 6172 6961 626c 6573 293a eset variables): │ │ │ │ │ +00041bf0: 0a20 2020 2020 7365 740a 2020 2020 2023 . set. # │ │ │ │ │ +00041c00: 2046 696e 6420 6f75 7420 7768 6963 6820 Find out which │ │ │ │ │ +00041c10: 6465 7669 6365 7320 6172 6520 6176 6169 devices are avai │ │ │ │ │ +00041c20: 6c61 626c 653a 0a20 2020 2020 6c73 0a20 lable:. ls. │ │ │ │ │ +00041c30: 2020 2020 2320 5365 7420 746f 2074 6865 # Set to the │ │ │ │ │ +00041c40: 2063 6f72 7265 6374 2076 616c 7565 2c20 correct value, │ │ │ │ │ +00041c50: 7768 6963 6820 6d69 6768 7420 6265 2073 which might be s │ │ │ │ │ +00041c60: 6f6d 6574 6869 6e67 206c 696b 6520 7468 omething like th │ │ │ │ │ +00041c70: 6973 3a0a 2020 2020 2073 6574 2070 7265 is:. set pre │ │ │ │ │ +00041c80: 6669 783d 2868 6430 2c31 292f 6772 7562 fix=(hd0,1)/grub │ │ │ │ │ +00041c90: 0a20 2020 2020 7365 7420 726f 6f74 3d28 . set root=( │ │ │ │ │ +00041ca0: 6864 302c 3129 0a20 2020 2020 696e 736d hd0,1). insm │ │ │ │ │ +00041cb0: 6f64 206e 6f72 6d61 6c0a 2020 2020 206e od normal. n │ │ │ │ │ +00041cc0: 6f72 6d61 6c0a 0a20 2020 486f 7765 7665 ormal.. Howeve │ │ │ │ │ +00041cd0: 722c 2061 6e79 2070 726f 626c 656d 2074 r, any problem t │ │ │ │ │ +00041ce0: 6861 7420 6c65 6176 6573 2079 6f75 2069 hat leaves you i │ │ │ │ │ +00041cf0: 6e20 7468 6520 7265 7363 7565 2073 6865 n the rescue she │ │ │ │ │ +00041d00: 6c6c 2070 726f 6261 626c 790a 6d65 616e ll probably.mean │ │ │ │ │ +00041d10: 7320 7468 6174 2047 5255 4220 7761 7320 s that GRUB was │ │ │ │ │ +00041d20: 6e6f 7420 636f 7272 6563 746c 7920 696e not correctly in │ │ │ │ │ +00041d30: 7374 616c 6c65 642e 2020 4974 206d 6179 stalled. It may │ │ │ │ │ +00041d40: 2062 6520 6d6f 7265 2075 7365 6675 6c20 be more useful │ │ │ │ │ +00041d50: 746f 0a74 7279 2074 6f20 7265 696e 7374 to.try to reinst │ │ │ │ │ +00041d60: 616c 6c20 6974 2070 726f 7065 726c 7920 all it properly │ │ │ │ │ +00041d70: 7573 696e 6720 2767 7275 622d 696e 7374 using 'grub-inst │ │ │ │ │ +00041d80: 616c 6c20 4445 5649 4345 2720 282a 6e6f all DEVICE' (*no │ │ │ │ │ +00041d90: 7465 2049 6e76 6f6b 696e 670a 6772 7562 te Invoking.grub │ │ │ │ │ +00041da0: 2d69 6e73 7461 6c6c 3a3a 292e 2020 5768 -install::). Wh │ │ │ │ │ +00041db0: 656e 2064 6f69 6e67 2074 6869 732c 2074 en doing this, t │ │ │ │ │ +00041dc0: 6865 7265 2061 7265 2061 2066 6577 2074 here are a few t │ │ │ │ │ +00041dd0: 6869 6e67 7320 746f 2072 656d 656d 6265 hings to remembe │ │ │ │ │ +00041de0: 723a 0a0a 2020 202a 2044 7269 7665 206f r:.. * Drive o │ │ │ │ │ +00041df0: 7264 6572 696e 6720 696e 2079 6f75 7220 rdering in your │ │ │ │ │ +00041e00: 6f70 6572 6174 696e 6720 7379 7374 656d operating system │ │ │ │ │ +00041e10: 206d 6179 206e 6f74 2062 6520 7468 6520 may not be the │ │ │ │ │ +00041e20: 7361 6d65 2061 7320 7468 650a 2020 2020 same as the. │ │ │ │ │ +00041e30: 2062 6f6f 7420 6472 6976 6520 6f72 6465 boot drive orde │ │ │ │ │ +00041e40: 7269 6e67 2075 7365 6420 6279 2079 6f75 ring used by you │ │ │ │ │ +00041e50: 7220 6669 726d 7761 7265 2e20 2044 6f20 r firmware. Do │ │ │ │ │ +00041e60: 6e6f 7420 6173 7375 6d65 2074 6861 7420 not assume that │ │ │ │ │ +00041e70: 796f 7572 0a20 2020 2020 6669 7273 7420 your. first │ │ │ │ │ +00041e80: 6861 7264 2064 7269 7665 2028 652e 672e hard drive (e.g. │ │ │ │ │ +00041e90: 2020 272f 6465 762f 7364 6127 2920 6973 '/dev/sda') is │ │ │ │ │ +00041ea0: 2074 6865 206f 6e65 2074 6861 7420 796f the one that yo │ │ │ │ │ +00041eb0: 7572 2066 6972 6d77 6172 650a 2020 2020 ur firmware. │ │ │ │ │ +00041ec0: 2077 696c 6c20 626f 6f74 2066 726f 6d2e will boot from. │ │ │ │ │ +00041ed0: 2020 2764 6576 6963 652e 6d61 7027 2028 'device.map' ( │ │ │ │ │ +00041ee0: 2a6e 6f74 6520 4465 7669 6365 206d 6170 *note Device map │ │ │ │ │ +00041ef0: 3a3a 2920 6361 6e20 6265 2075 7365 6420 ::) can be used │ │ │ │ │ +00041f00: 746f 0a20 2020 2020 6f76 6572 7269 6465 to. override │ │ │ │ │ +00041f10: 2074 6869 732c 2062 7574 2069 7420 6973 this, but it is │ │ │ │ │ +00041f20: 2075 7375 616c 6c79 2062 6574 7465 7220 usually better │ │ │ │ │ +00041f30: 746f 2075 7365 2055 5549 4473 206f 7220 to use UUIDs or │ │ │ │ │ +00041f40: 6669 6c65 2073 7973 7465 6d0a 2020 2020 file system. │ │ │ │ │ +00041f50: 206c 6162 656c 7320 616e 6420 6176 6f69 labels and avoi │ │ │ │ │ +00041f60: 6420 6465 7065 6e64 696e 6720 6f6e 2064 d depending on d │ │ │ │ │ +00041f70: 7269 7665 206f 7264 6572 696e 6720 656e rive ordering en │ │ │ │ │ +00041f80: 7469 7265 6c79 2e0a 0a20 2020 2a20 4174 tirely... * At │ │ │ │ │ +00041f90: 206c 6561 7374 206f 6e20 4249 4f53 2073 least on BIOS s │ │ │ │ │ +00041fa0: 7973 7465 6d73 2c20 6966 2079 6f75 2074 ystems, if you t │ │ │ │ │ +00041fb0: 656c 6c20 2767 7275 622d 696e 7374 616c ell 'grub-instal │ │ │ │ │ +00041fc0: 6c27 2074 6f20 696e 7374 616c 6c0a 2020 l' to install. │ │ │ │ │ +00041fd0: 2020 2047 5255 4220 746f 2061 2070 6172 GRUB to a par │ │ │ │ │ +00041fe0: 7469 7469 6f6e 2062 7574 2047 5255 4220 tition but GRUB │ │ │ │ │ +00041ff0: 6861 7320 616c 7265 6164 7920 6265 656e has already been │ │ │ │ │ +00042000: 2069 6e73 7461 6c6c 6564 2069 6e20 7468 installed in th │ │ │ │ │ +00042010: 650a 2020 2020 206d 6173 7465 7220 626f e. master bo │ │ │ │ │ +00042020: 6f74 2072 6563 6f72 642c 2074 6865 6e20 ot record, then │ │ │ │ │ +00042030: 7468 6520 4752 5542 2069 6e73 7461 6c6c the GRUB install │ │ │ │ │ +00042040: 6174 696f 6e20 696e 2074 6865 2070 6172 ation in the par │ │ │ │ │ +00042050: 7469 7469 6f6e 0a20 2020 2020 7769 6c6c tition. will │ │ │ │ │ +00042060: 2062 6520 6967 6e6f 7265 642e 0a0a 2020 be ignored... │ │ │ │ │ +00042070: 202a 2049 6620 706f 7373 6962 6c65 2c20 * If possible, │ │ │ │ │ +00042080: 6974 2069 7320 6765 6e65 7261 6c6c 7920 it is generally │ │ │ │ │ +00042090: 6265 7374 2074 6f20 6176 6f69 6420 696e best to avoid in │ │ │ │ │ +000420a0: 7374 616c 6c69 6e67 2047 5255 4220 746f stalling GRUB to │ │ │ │ │ +000420b0: 2061 0a20 2020 2020 7061 7274 6974 696f a. partitio │ │ │ │ │ +000420c0: 6e20 2875 6e6c 6573 7320 6974 2069 7320 n (unless it is │ │ │ │ │ +000420d0: 6120 7370 6563 6961 6c20 7061 7274 6974 a special partit │ │ │ │ │ +000420e0: 696f 6e20 666f 7220 7468 6520 7573 6520 ion for the use │ │ │ │ │ +000420f0: 6f66 2047 5255 420a 2020 2020 2061 6c6f of GRUB. alo │ │ │ │ │ +00042100: 6e65 2c20 7375 6368 2061 7320 7468 6520 ne, such as the │ │ │ │ │ +00042110: 4249 4f53 2042 6f6f 7420 5061 7274 6974 BIOS Boot Partit │ │ │ │ │ +00042120: 696f 6e20 7573 6564 206f 6e20 4750 5429 ion used on GPT) │ │ │ │ │ +00042130: 2e20 446f 696e 6720 7468 6973 0a20 2020 . Doing this. │ │ │ │ │ +00042140: 2020 6d65 616e 7320 7468 6174 2047 5255 means that GRU │ │ │ │ │ +00042150: 4220 6d61 7920 7374 6f70 2062 6569 6e67 B may stop being │ │ │ │ │ +00042160: 2061 626c 6520 746f 2072 6561 6420 6974 able to read it │ │ │ │ │ +00042170: 7320 636f 7265 2069 6d61 6765 2064 7565 s core image due │ │ │ │ │ +00042180: 2074 6f20 610a 2020 2020 2066 696c 6520 to a. file │ │ │ │ │ +00042190: 7379 7374 656d 206d 6f76 696e 6720 626c system moving bl │ │ │ │ │ +000421a0: 6f63 6b73 2061 726f 756e 642c 2073 7563 ocks around, suc │ │ │ │ │ +000421b0: 6820 6173 2077 6869 6c65 2064 6566 7261 h as while defra │ │ │ │ │ +000421c0: 676d 656e 7469 6e67 2c0a 2020 2020 2072 gmenting,. r │ │ │ │ │ +000421d0: 756e 6e69 6e67 2063 6865 636b 732c 206f unning checks, o │ │ │ │ │ +000421e0: 7220 6576 656e 2064 7572 696e 6720 6e6f r even during no │ │ │ │ │ +000421f0: 726d 616c 206f 7065 7261 7469 6f6e 2e20 rmal operation. │ │ │ │ │ +00042200: 2049 6e73 7461 6c6c 696e 6720 746f 2074 Installing to t │ │ │ │ │ +00042210: 6865 0a20 2020 2020 7768 6f6c 6520 6469 he. whole di │ │ │ │ │ +00042220: 736b 2064 6576 6963 6520 6973 206e 6f72 sk device is nor │ │ │ │ │ +00042230: 6d61 6c6c 7920 6d6f 7265 2072 6f62 7573 mally more robus │ │ │ │ │ +00042240: 742e 0a0a 2020 202a 2043 6865 636b 2074 t... * Check t │ │ │ │ │ +00042250: 6861 7420 4752 5542 2061 6374 7561 6c6c hat GRUB actuall │ │ │ │ │ +00042260: 7920 6b6e 6f77 7320 686f 7720 746f 2072 y knows how to r │ │ │ │ │ +00042270: 6561 6420 6672 6f6d 2074 6865 2064 6576 ead from the dev │ │ │ │ │ +00042280: 6963 6520 616e 6420 6669 6c65 0a20 2020 ice and file. │ │ │ │ │ +00042290: 2020 7379 7374 656d 2063 6f6e 7461 696e system contain │ │ │ │ │ +000422a0: 696e 6720 272f 626f 6f74 2f67 7275 6227 ing '/boot/grub' │ │ │ │ │ +000422b0: 2e20 2049 7420 7769 6c6c 206e 6f74 2062 . It will not b │ │ │ │ │ +000422c0: 6520 6162 6c65 2074 6f20 7265 6164 2066 e able to read f │ │ │ │ │ +000422d0: 726f 6d0a 2020 2020 2065 6e63 7279 7074 rom. encrypt │ │ │ │ │ +000422e0: 6564 2064 6576 6963 6573 2077 6974 6820 ed devices with │ │ │ │ │ +000422f0: 756e 7375 7070 6f72 7465 6420 656e 6372 unsupported encr │ │ │ │ │ +00042300: 7970 7469 6f6e 2073 6368 656d 652c 206e yption scheme, n │ │ │ │ │ +00042310: 6f72 2066 726f 6d20 6669 6c65 0a20 2020 or from file. │ │ │ │ │ +00042320: 2020 7379 7374 656d 7320 666f 7220 7768 systems for wh │ │ │ │ │ +00042330: 6963 6820 7375 7070 6f72 7420 6861 7320 ich support has │ │ │ │ │ +00042340: 6e6f 7420 7965 7420 6265 656e 2061 6464 not yet been add │ │ │ │ │ +00042350: 6564 2074 6f20 4752 5542 2e0a 0a1f 0a46 ed to GRUB.....F │ │ │ │ │ +00042360: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ +00042370: 204e 6f64 653a 2046 6972 6d77 6172 6520 Node: Firmware │ │ │ │ │ +00042380: 7374 616c 6c73 2069 6e73 7465 6164 206f stalls instead o │ │ │ │ │ +00042390: 6620 626f 6f74 696e 6720 4752 5542 2c20 f booting GRUB, │ │ │ │ │ +000423a0: 2050 7265 763a 2047 5255 4220 6f6e 6c79 Prev: GRUB only │ │ │ │ │ +000423b0: 206f 6666 6572 7320 6120 7265 7363 7565 offers a rescue │ │ │ │ │ +000423c0: 2073 6865 6c6c 2c20 2055 703a 2054 726f shell, Up: Tro │ │ │ │ │ +000423d0: 7562 6c65 7368 6f6f 7469 6e67 0a0a 3232 ubleshooting..22 │ │ │ │ │ +000423e0: 2e32 2046 6972 6d77 6172 6520 7374 616c .2 Firmware stal │ │ │ │ │ +000423f0: 6c73 2069 6e73 7465 6164 206f 6620 626f ls instead of bo │ │ │ │ │ +00042400: 6f74 696e 6720 4752 5542 0a3d 3d3d 3d3d oting GRUB.===== │ │ │ │ │ 00042410: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 00042420: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00042430: 3d3d 3d3d 3d3d 3d3d 3d0a 0a54 6865 2045 =========..The E │ │ │ │ │ -00042440: 4649 2069 6d70 6c65 6d65 6e74 6174 696f FI implementatio │ │ │ │ │ -00042450: 6e20 6f66 2073 6f6d 6520 6f6c 6465 7220 n of some older │ │ │ │ │ -00042460: 4d61 6342 6f6f 6b20 6c61 7074 6f70 7320 MacBook laptops │ │ │ │ │ -00042470: 7374 616c 6c73 2077 6865 6e20 6974 2067 stalls when it g │ │ │ │ │ -00042480: 6574 730a 7072 6573 656e 7465 6420 6120 ets.presented a │ │ │ │ │ -00042490: 6772 7562 2d6d 6b72 6573 6375 6520 4953 grub-mkrescue IS │ │ │ │ │ -000424a0: 4f20 696d 6167 6520 666f 7220 7838 365f O image for x86_ │ │ │ │ │ -000424b0: 3634 2d65 6669 2074 6172 6765 7420 6f6e 64-efi target on │ │ │ │ │ -000424c0: 2061 6e20 5553 420a 7374 6963 6b2e 2020 an USB.stick. │ │ │ │ │ -000424d0: 4166 6665 6374 6564 2061 7265 206d 6f64 Affected are mod │ │ │ │ │ -000424e0: 656c 7320 6f66 2079 6561 7220 3230 3130 els of year 2010 │ │ │ │ │ -000424f0: 206f 7220 6561 726c 6965 722e 2020 576f or earlier. Wo │ │ │ │ │ -00042500: 726b 6172 6f75 6e64 2069 7320 746f 0a7a rkaround is to.z │ │ │ │ │ -00042510: 6572 6f69 7a65 2074 6865 2062 7974 6573 eroize the bytes │ │ │ │ │ -00042520: 2034 3436 2074 6f20 3436 3120 6f66 2074 446 to 461 of t │ │ │ │ │ -00042530: 6865 2045 4649 2070 6172 7469 7469 6f6e he EFI partition │ │ │ │ │ -00042540: 2c20 7768 6572 6520 6d66 6f72 6d61 7420 , where mformat │ │ │ │ │ -00042550: 6861 7320 7075 740a 6120 7061 7274 6974 has put.a partit │ │ │ │ │ -00042560: 696f 6e20 7461 626c 6520 656e 7472 7920 ion table entry │ │ │ │ │ -00042570: 7768 6963 6820 636c 6169 6d73 2070 6172 which claims par │ │ │ │ │ -00042580: 7469 7469 6f6e 2073 7461 7274 2061 7420 tition start at │ │ │ │ │ -00042590: 626c 6f63 6b20 302e 2020 5468 6973 0a63 block 0. This.c │ │ │ │ │ -000425a0: 6861 6e67 6520 7769 6c6c 206e 6f74 2068 hange will not h │ │ │ │ │ -000425b0: 616d 7065 7220 626f 6f74 6162 696c 6974 amper bootabilit │ │ │ │ │ -000425c0: 7920 6f6e 206f 7468 6572 206d 6163 6869 y on other machi │ │ │ │ │ -000425d0: 6e65 732e 0a0a 1f0a 4669 6c65 3a20 6772 nes.....File: gr │ │ │ │ │ -000425e0: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ -000425f0: 496e 766f 6b69 6e67 2067 7275 622d 696e Invoking grub-in │ │ │ │ │ -00042600: 7374 616c 6c2c 2020 4e65 7874 3a20 496e stall, Next: In │ │ │ │ │ -00042610: 766f 6b69 6e67 2067 7275 622d 6d6b 636f voking grub-mkco │ │ │ │ │ -00042620: 6e66 6967 2c20 2050 7265 763a 2054 726f nfig, Prev: Tro │ │ │ │ │ -00042630: 7562 6c65 7368 6f6f 7469 6e67 2c20 2055 ubleshooting, U │ │ │ │ │ -00042640: 703a 2054 6f70 0a0a 3233 2049 6e76 6f6b p: Top..23 Invok │ │ │ │ │ -00042650: 696e 6720 6772 7562 2d69 6e73 7461 6c6c ing grub-install │ │ │ │ │ -00042660: 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a .*************** │ │ │ │ │ -00042670: 2a2a 2a2a 2a2a 2a2a 2a0a 0a54 6865 2070 *********..The p │ │ │ │ │ -00042680: 726f 6772 616d 2027 6772 7562 2d69 6e73 rogram 'grub-ins │ │ │ │ │ -00042690: 7461 6c6c 2720 6765 6e65 7261 7465 7320 tall' generates │ │ │ │ │ -000426a0: 6120 4752 5542 2063 6f72 6520 696d 6167 a GRUB core imag │ │ │ │ │ -000426b0: 6520 7573 696e 670a 2767 7275 622d 6d6b e using.'grub-mk │ │ │ │ │ -000426c0: 696d 6167 6527 2061 6e64 2069 6e73 7461 image' and insta │ │ │ │ │ -000426d0: 6c6c 7320 6974 206f 6e20 796f 7572 2073 lls it on your s │ │ │ │ │ -000426e0: 7973 7465 6d2e 2020 596f 7520 6d75 7374 ystem. You must │ │ │ │ │ -000426f0: 2073 7065 6369 6679 2074 6865 0a64 6576 specify the.dev │ │ │ │ │ -00042700: 6963 6520 6e61 6d65 206f 6e20 7768 6963 ice name on whic │ │ │ │ │ -00042710: 6820 796f 7520 7761 6e74 2074 6f20 696e h you want to in │ │ │ │ │ -00042720: 7374 616c 6c20 4752 5542 2c20 6c69 6b65 stall GRUB, like │ │ │ │ │ -00042730: 2074 6869 733a 0a0a 2020 2020 2067 7275 this:.. gru │ │ │ │ │ -00042740: 622d 696e 7374 616c 6c20 494e 5354 414c b-install INSTAL │ │ │ │ │ -00042750: 4c5f 4445 5649 4345 0a0a 2020 2054 6865 L_DEVICE.. The │ │ │ │ │ -00042760: 2064 6576 6963 6520 6e61 6d65 2049 4e53 device name INS │ │ │ │ │ -00042770: 5441 4c4c 5f44 4556 4943 4520 6973 2061 TALL_DEVICE is a │ │ │ │ │ -00042780: 6e20 4f53 2064 6576 6963 6520 6e61 6d65 n OS device name │ │ │ │ │ -00042790: 206f 7220 6120 4752 5542 2064 6576 6963 or a GRUB devic │ │ │ │ │ -000427a0: 650a 6e61 6d65 2e0a 0a20 2020 2767 7275 e.name... 'gru │ │ │ │ │ -000427b0: 622d 696e 7374 616c 6c27 2061 6363 6570 b-install' accep │ │ │ │ │ -000427c0: 7473 2074 6865 2066 6f6c 6c6f 7769 6e67 ts the following │ │ │ │ │ -000427d0: 206f 7074 696f 6e73 3a0a 0a27 2d2d 6865 options:..'--he │ │ │ │ │ -000427e0: 6c70 270a 2020 2020 2050 7269 6e74 2061 lp'. Print a │ │ │ │ │ -000427f0: 2073 756d 6d61 7279 206f 6620 7468 6520 summary of the │ │ │ │ │ -00042800: 636f 6d6d 616e 642d 6c69 6e65 206f 7074 command-line opt │ │ │ │ │ -00042810: 696f 6e73 2061 6e64 2065 7869 742e 0a0a ions and exit... │ │ │ │ │ -00042820: 272d 2d76 6572 7369 6f6e 270a 2020 2020 '--version'. │ │ │ │ │ -00042830: 2050 7269 6e74 2074 6865 2076 6572 7369 Print the versi │ │ │ │ │ -00042840: 6f6e 206e 756d 6265 7220 6f66 2047 5255 on number of GRU │ │ │ │ │ -00042850: 4220 616e 6420 6578 6974 2e0a 0a27 2d2d B and exit...'-- │ │ │ │ │ -00042860: 626f 6f74 2d64 6972 6563 746f 7279 3d44 boot-directory=D │ │ │ │ │ -00042870: 4952 270a 2020 2020 2049 6e73 7461 6c6c IR'. Install │ │ │ │ │ -00042880: 2047 5255 4220 696d 6167 6573 2075 6e64 GRUB images und │ │ │ │ │ -00042890: 6572 2074 6865 2064 6972 6563 746f 7279 er the directory │ │ │ │ │ -000428a0: 2027 4449 522f 6772 7562 2f27 2054 6869 'DIR/grub/' Thi │ │ │ │ │ -000428b0: 7320 6f70 7469 6f6e 2069 730a 2020 2020 s option is. │ │ │ │ │ -000428c0: 2075 7365 6675 6c20 7768 656e 2079 6f75 useful when you │ │ │ │ │ -000428d0: 2077 616e 7420 746f 2069 6e73 7461 6c6c want to install │ │ │ │ │ -000428e0: 2047 5255 4220 696e 746f 2061 2073 6570 GRUB into a sep │ │ │ │ │ -000428f0: 6172 6174 6520 7061 7274 6974 696f 6e20 arate partition │ │ │ │ │ -00042900: 6f72 2061 0a20 2020 2020 7265 6d6f 7661 or a. remova │ │ │ │ │ -00042910: 626c 6520 6469 736b 2e20 2049 6620 7468 ble disk. If th │ │ │ │ │ -00042920: 6973 206f 7074 696f 6e20 6973 206e 6f74 is option is not │ │ │ │ │ -00042930: 2073 7065 6369 6669 6564 2074 6865 6e20 specified then │ │ │ │ │ -00042940: 6974 2064 6566 6175 6c74 730a 2020 2020 it defaults. │ │ │ │ │ -00042950: 2074 6f20 272f 626f 6f74 272c 2073 6f0a to '/boot', so. │ │ │ │ │ -00042960: 0a20 2020 2020 2020 2020 2067 7275 622d . grub- │ │ │ │ │ -00042970: 696e 7374 616c 6c20 2f64 6576 2f73 6461 install /dev/sda │ │ │ │ │ -00042980: 0a0a 2020 2020 2069 7320 6571 7569 7661 .. is equiva │ │ │ │ │ -00042990: 6c65 6e74 2074 6f0a 0a20 2020 2020 2020 lent to.. │ │ │ │ │ -000429a0: 2020 2067 7275 622d 696e 7374 616c 6c20 grub-install │ │ │ │ │ -000429b0: 2d2d 626f 6f74 2d64 6972 6563 746f 7279 --boot-directory │ │ │ │ │ -000429c0: 3d2f 626f 6f74 2f20 2f64 6576 2f73 6461 =/boot/ /dev/sda │ │ │ │ │ -000429d0: 0a0a 2020 2020 2048 6572 6520 6973 2061 .. Here is a │ │ │ │ │ -000429e0: 6e20 6578 616d 706c 6520 696e 2077 6869 n example in whi │ │ │ │ │ -000429f0: 6368 2079 6f75 2068 6176 6520 6120 7365 ch you have a se │ │ │ │ │ -00042a00: 7061 7261 7465 2022 626f 6f74 2220 7061 parate "boot" pa │ │ │ │ │ -00042a10: 7274 6974 696f 6e0a 2020 2020 2077 6869 rtition. whi │ │ │ │ │ -00042a20: 6368 2069 7320 6d6f 756e 7465 6420 6f6e ch is mounted on │ │ │ │ │ -00042a30: 2027 2f6d 6e74 2f62 6f6f 7427 3a0a 0a20 '/mnt/boot':.. │ │ │ │ │ -00042a40: 2020 2020 2020 2020 2067 7275 622d 696e grub-in │ │ │ │ │ -00042a50: 7374 616c 6c20 2d2d 626f 6f74 2d64 6972 stall --boot-dir │ │ │ │ │ -00042a60: 6563 746f 7279 3d2f 6d6e 742f 626f 6f74 ectory=/mnt/boot │ │ │ │ │ -00042a70: 202f 6465 762f 7364 620a 0a27 2d2d 7265 /dev/sdb..'--re │ │ │ │ │ -00042a80: 6368 6563 6b27 0a20 2020 2020 5265 6368 check'. Rech │ │ │ │ │ -00042a90: 6563 6b20 7468 6520 6465 7669 6365 206d eck the device m │ │ │ │ │ -00042aa0: 6170 2c20 6576 656e 2069 6620 272f 626f ap, even if '/bo │ │ │ │ │ -00042ab0: 6f74 2f67 7275 622f 6465 7669 6365 2e6d ot/grub/device.m │ │ │ │ │ -00042ac0: 6170 2720 616c 7265 6164 790a 2020 2020 ap' already. │ │ │ │ │ -00042ad0: 2065 7869 7374 732e 2020 596f 7520 7368 exists. You sh │ │ │ │ │ -00042ae0: 6f75 6c64 2075 7365 2074 6869 7320 6f70 ould use this op │ │ │ │ │ -00042af0: 7469 6f6e 2077 6865 6e65 7665 7220 796f tion whenever yo │ │ │ │ │ -00042b00: 7520 6164 642f 7265 6d6f 7665 2061 2064 u add/remove a d │ │ │ │ │ -00042b10: 6973 6b0a 2020 2020 2069 6e74 6f2f 6672 isk. into/fr │ │ │ │ │ -00042b20: 6f6d 2079 6f75 7220 636f 6d70 7574 6572 om your computer │ │ │ │ │ -00042b30: 2e0a 0a27 2d2d 6e6f 2d72 732d 636f 6465 ...'--no-rs-code │ │ │ │ │ -00042b40: 7327 0a20 2020 2020 4279 2064 6566 6175 s'. By defau │ │ │ │ │ -00042b50: 6c74 206f 6e20 7838 3620 4249 4f53 2073 lt on x86 BIOS s │ │ │ │ │ -00042b60: 7973 7465 6d73 2c20 2767 7275 622d 696e ystems, 'grub-in │ │ │ │ │ -00042b70: 7374 616c 6c27 2077 696c 6c20 7573 6520 stall' will use │ │ │ │ │ -00042b80: 736f 6d65 2065 7874 7261 0a20 2020 2020 some extra. │ │ │ │ │ -00042b90: 7370 6163 6520 696e 2074 6865 2062 6f6f space in the boo │ │ │ │ │ -00042ba0: 746c 6f61 6465 7220 656d 6265 6464 696e tloader embeddin │ │ │ │ │ -00042bb0: 6720 6172 6561 2066 6f72 2052 6565 642d g area for Reed- │ │ │ │ │ -00042bc0: 536f 6c6f 6d6f 6e0a 2020 2020 2065 7272 Solomon. err │ │ │ │ │ -00042bd0: 6f72 2d63 6f72 7265 6374 696e 6720 636f or-correcting co │ │ │ │ │ -00042be0: 6465 732e 2020 5468 6973 2065 6e61 626c des. This enabl │ │ │ │ │ -00042bf0: 6573 2047 5255 4220 746f 2073 7469 6c6c es GRUB to still │ │ │ │ │ -00042c00: 2062 6f6f 740a 2020 2020 2073 7563 6365 boot. succe │ │ │ │ │ -00042c10: 7373 6675 6c6c 7920 6966 2073 6f6d 6520 ssfully if some │ │ │ │ │ -00042c20: 626c 6f63 6b73 2061 7265 2063 6f72 7275 blocks are corru │ │ │ │ │ -00042c30: 7074 6564 2e20 2054 6865 2065 7861 6374 pted. The exact │ │ │ │ │ -00042c40: 2061 6d6f 756e 7420 6f66 0a20 2020 2020 amount of. │ │ │ │ │ -00042c50: 7072 6f74 6563 7469 6f6e 206f 6666 6572 protection offer │ │ │ │ │ -00042c60: 6564 2069 7320 6465 7065 6e64 656e 7420 ed is dependent │ │ │ │ │ -00042c70: 6f6e 2061 7661 696c 6162 6c65 2073 7061 on available spa │ │ │ │ │ -00042c80: 6365 2069 6e20 7468 6520 656d 6265 6464 ce in the embedd │ │ │ │ │ -00042c90: 696e 670a 2020 2020 2061 7265 612e 2020 ing. area. │ │ │ │ │ -00042ca0: 5220 7365 6374 6f72 7320 6f66 2072 6564 R sectors of red │ │ │ │ │ -00042cb0: 756e 6461 6e63 7920 6361 6e20 746f 6c65 undancy can tole │ │ │ │ │ -00042cc0: 7261 7465 2075 7020 746f 2052 2f32 2063 rate up to R/2 c │ │ │ │ │ -00042cd0: 6f72 7275 7074 6564 0a20 2020 2020 7365 orrupted. se │ │ │ │ │ -00042ce0: 6374 6f72 732e 2020 5468 6973 2072 6564 ctors. This red │ │ │ │ │ -00042cf0: 756e 6461 6e63 7920 6d61 7920 6265 2063 undancy may be c │ │ │ │ │ -00042d00: 756d 6265 7273 6f6d 6520 6966 2061 7474 umbersome if att │ │ │ │ │ -00042d10: 656d 7074 696e 6720 746f 0a20 2020 2020 empting to. │ │ │ │ │ -00042d20: 6372 7970 746f 6772 6170 6869 6361 6c6c cryptographicall │ │ │ │ │ -00042d30: 7920 7661 6c69 6461 7465 2074 6865 2063 y validate the c │ │ │ │ │ -00042d40: 6f6e 7465 6e74 7320 6f66 2074 6865 2062 ontents of the b │ │ │ │ │ -00042d50: 6f6f 746c 6f61 6465 7220 656d 6265 6464 ootloader embedd │ │ │ │ │ -00042d60: 696e 670a 2020 2020 2061 7265 612c 206f ing. area, o │ │ │ │ │ -00042d70: 7220 696e 206d 6f72 6520 6d6f 6465 726e r in more modern │ │ │ │ │ -00042d80: 2073 7973 7465 6d73 2077 6974 6820 4750 systems with GP │ │ │ │ │ -00042d90: 542d 7374 796c 6520 7061 7274 6974 696f T-style partitio │ │ │ │ │ -00042da0: 6e20 7461 626c 6573 0a20 2020 2020 282a n tables. (* │ │ │ │ │ -00042db0: 6e6f 7465 2042 494f 5320 696e 7374 616c note BIOS instal │ │ │ │ │ -00042dc0: 6c61 7469 6f6e 3a3a 2920 7768 6572 6520 lation::) where │ │ │ │ │ -00042dd0: 4752 5542 2064 6f65 7320 6e6f 7420 7265 GRUB does not re │ │ │ │ │ -00042de0: 7369 6465 2069 6e20 616e 790a 2020 2020 side in any. │ │ │ │ │ -00042df0: 2075 6e70 6172 7469 7469 6f6e 6564 2073 unpartitioned s │ │ │ │ │ -00042e00: 7061 6365 206f 7574 7369 6465 206f 6620 pace outside of │ │ │ │ │ -00042e10: 7468 6520 4d42 522e 2044 6973 6162 6c65 the MBR. Disable │ │ │ │ │ -00042e20: 2074 6865 2052 6565 642d 536f 6c6f 6d6f the Reed-Solomo │ │ │ │ │ -00042e30: 6e0a 2020 2020 2063 6f64 6573 2077 6974 n. codes wit │ │ │ │ │ -00042e40: 6820 7468 6973 206f 7074 696f 6e2e 0a0a h this option... │ │ │ │ │ -00042e50: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ -00042e60: 6f2c 2020 4e6f 6465 3a20 496e 766f 6b69 o, Node: Invoki │ │ │ │ │ -00042e70: 6e67 2067 7275 622d 6d6b 636f 6e66 6967 ng grub-mkconfig │ │ │ │ │ -00042e80: 2c20 204e 6578 743a 2049 6e76 6f6b 696e , Next: Invokin │ │ │ │ │ -00042e90: 6720 6772 7562 2d6d 6b70 6173 7377 642d g grub-mkpasswd- │ │ │ │ │ -00042ea0: 7062 6b64 6632 2c20 2050 7265 763a 2049 pbkdf2, Prev: I │ │ │ │ │ -00042eb0: 6e76 6f6b 696e 6720 6772 7562 2d69 6e73 nvoking grub-ins │ │ │ │ │ -00042ec0: 7461 6c6c 2c20 2055 703a 2054 6f70 0a0a tall, Up: Top.. │ │ │ │ │ -00042ed0: 3234 2049 6e76 6f6b 696e 6720 6772 7562 24 Invoking grub │ │ │ │ │ -00042ee0: 2d6d 6b63 6f6e 6669 670a 2a2a 2a2a 2a2a -mkconfig.****** │ │ │ │ │ +00042430: 3d3d 3d3d 3d3d 3d0a 0a54 6865 2045 4649 =======..The EFI │ │ │ │ │ +00042440: 2069 6d70 6c65 6d65 6e74 6174 696f 6e20 implementation │ │ │ │ │ +00042450: 6f66 2073 6f6d 6520 6f6c 6465 7220 4d61 of some older Ma │ │ │ │ │ +00042460: 6342 6f6f 6b20 6c61 7074 6f70 7320 7374 cBook laptops st │ │ │ │ │ +00042470: 616c 6c73 2077 6865 6e20 6974 2067 6574 alls when it get │ │ │ │ │ +00042480: 730a 7072 6573 656e 7465 6420 6120 6772 s.presented a gr │ │ │ │ │ +00042490: 7562 2d6d 6b72 6573 6375 6520 4953 4f20 ub-mkrescue ISO │ │ │ │ │ +000424a0: 696d 6167 6520 666f 7220 7838 365f 3634 image for x86_64 │ │ │ │ │ +000424b0: 2d65 6669 2074 6172 6765 7420 6f6e 2061 -efi target on a │ │ │ │ │ +000424c0: 6e20 5553 420a 7374 6963 6b2e 2020 4166 n USB.stick. Af │ │ │ │ │ +000424d0: 6665 6374 6564 2061 7265 206d 6f64 656c fected are model │ │ │ │ │ +000424e0: 7320 6f66 2079 6561 7220 3230 3130 206f s of year 2010 o │ │ │ │ │ +000424f0: 7220 6561 726c 6965 722e 2020 576f 726b r earlier. Work │ │ │ │ │ +00042500: 6172 6f75 6e64 2069 7320 746f 0a7a 6572 around is to.zer │ │ │ │ │ +00042510: 6f69 7a65 2074 6865 2062 7974 6573 2034 oize the bytes 4 │ │ │ │ │ +00042520: 3436 2074 6f20 3436 3120 6f66 2074 6865 46 to 461 of the │ │ │ │ │ +00042530: 2045 4649 2070 6172 7469 7469 6f6e 2c20 EFI partition, │ │ │ │ │ +00042540: 7768 6572 6520 6d66 6f72 6d61 7420 6861 where mformat ha │ │ │ │ │ +00042550: 7320 7075 740a 6120 7061 7274 6974 696f s put.a partitio │ │ │ │ │ +00042560: 6e20 7461 626c 6520 656e 7472 7920 7768 n table entry wh │ │ │ │ │ +00042570: 6963 6820 636c 6169 6d73 2070 6172 7469 ich claims parti │ │ │ │ │ +00042580: 7469 6f6e 2073 7461 7274 2061 7420 626c tion start at bl │ │ │ │ │ +00042590: 6f63 6b20 302e 2020 5468 6973 0a63 6861 ock 0. This.cha │ │ │ │ │ +000425a0: 6e67 6520 7769 6c6c 206e 6f74 2068 616d nge will not ham │ │ │ │ │ +000425b0: 7065 7220 626f 6f74 6162 696c 6974 7920 per bootability │ │ │ │ │ +000425c0: 6f6e 206f 7468 6572 206d 6163 6869 6e65 on other machine │ │ │ │ │ +000425d0: 732e 0a0a 1f0a 4669 6c65 3a20 6772 7562 s.....File: grub │ │ │ │ │ +000425e0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 496e .info, Node: In │ │ │ │ │ +000425f0: 766f 6b69 6e67 2067 7275 622d 696e 7374 voking grub-inst │ │ │ │ │ +00042600: 616c 6c2c 2020 4e65 7874 3a20 496e 766f all, Next: Invo │ │ │ │ │ +00042610: 6b69 6e67 2067 7275 622d 6d6b 636f 6e66 king grub-mkconf │ │ │ │ │ +00042620: 6967 2c20 2050 7265 763a 2054 726f 7562 ig, Prev: Troub │ │ │ │ │ +00042630: 6c65 7368 6f6f 7469 6e67 2c20 2055 703a leshooting, Up: │ │ │ │ │ +00042640: 2054 6f70 0a0a 3233 2049 6e76 6f6b 696e Top..23 Invokin │ │ │ │ │ +00042650: 6720 6772 7562 2d69 6e73 7461 6c6c 0a2a g grub-install.* │ │ │ │ │ +00042660: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ +00042670: 2a2a 2a2a 2a2a 2a0a 0a54 6865 2070 726f *******..The pro │ │ │ │ │ +00042680: 6772 616d 2027 6772 7562 2d69 6e73 7461 gram 'grub-insta │ │ │ │ │ +00042690: 6c6c 2720 6765 6e65 7261 7465 7320 6120 ll' generates a │ │ │ │ │ +000426a0: 4752 5542 2063 6f72 6520 696d 6167 6520 GRUB core image │ │ │ │ │ +000426b0: 7573 696e 670a 2767 7275 622d 6d6b 696d using.'grub-mkim │ │ │ │ │ +000426c0: 6167 6527 2061 6e64 2069 6e73 7461 6c6c age' and install │ │ │ │ │ +000426d0: 7320 6974 206f 6e20 796f 7572 2073 7973 s it on your sys │ │ │ │ │ +000426e0: 7465 6d2e 2020 596f 7520 6d75 7374 2073 tem. You must s │ │ │ │ │ +000426f0: 7065 6369 6679 2074 6865 0a64 6576 6963 pecify the.devic │ │ │ │ │ +00042700: 6520 6e61 6d65 206f 6e20 7768 6963 6820 e name on which │ │ │ │ │ +00042710: 796f 7520 7761 6e74 2074 6f20 696e 7374 you want to inst │ │ │ │ │ +00042720: 616c 6c20 4752 5542 2c20 6c69 6b65 2074 all GRUB, like t │ │ │ │ │ +00042730: 6869 733a 0a0a 2020 2020 2067 7275 622d his:.. grub- │ │ │ │ │ +00042740: 696e 7374 616c 6c20 494e 5354 414c 4c5f install INSTALL_ │ │ │ │ │ +00042750: 4445 5649 4345 0a0a 2020 2054 6865 2064 DEVICE.. The d │ │ │ │ │ +00042760: 6576 6963 6520 6e61 6d65 2049 4e53 5441 evice name INSTA │ │ │ │ │ +00042770: 4c4c 5f44 4556 4943 4520 6973 2061 6e20 LL_DEVICE is an │ │ │ │ │ +00042780: 4f53 2064 6576 6963 6520 6e61 6d65 206f OS device name o │ │ │ │ │ +00042790: 7220 6120 4752 5542 2064 6576 6963 650a r a GRUB device. │ │ │ │ │ +000427a0: 6e61 6d65 2e0a 0a20 2020 2767 7275 622d name... 'grub- │ │ │ │ │ +000427b0: 696e 7374 616c 6c27 2061 6363 6570 7473 install' accepts │ │ │ │ │ +000427c0: 2074 6865 2066 6f6c 6c6f 7769 6e67 206f the following o │ │ │ │ │ +000427d0: 7074 696f 6e73 3a0a 0a27 2d2d 6865 6c70 ptions:..'--help │ │ │ │ │ +000427e0: 270a 2020 2020 2050 7269 6e74 2061 2073 '. Print a s │ │ │ │ │ +000427f0: 756d 6d61 7279 206f 6620 7468 6520 636f ummary of the co │ │ │ │ │ +00042800: 6d6d 616e 642d 6c69 6e65 206f 7074 696f mmand-line optio │ │ │ │ │ +00042810: 6e73 2061 6e64 2065 7869 742e 0a0a 272d ns and exit...'- │ │ │ │ │ +00042820: 2d76 6572 7369 6f6e 270a 2020 2020 2050 -version'. P │ │ │ │ │ +00042830: 7269 6e74 2074 6865 2076 6572 7369 6f6e rint the version │ │ │ │ │ +00042840: 206e 756d 6265 7220 6f66 2047 5255 4220 number of GRUB │ │ │ │ │ +00042850: 616e 6420 6578 6974 2e0a 0a27 2d2d 626f and exit...'--bo │ │ │ │ │ +00042860: 6f74 2d64 6972 6563 746f 7279 3d44 4952 ot-directory=DIR │ │ │ │ │ +00042870: 270a 2020 2020 2049 6e73 7461 6c6c 2047 '. Install G │ │ │ │ │ +00042880: 5255 4220 696d 6167 6573 2075 6e64 6572 RUB images under │ │ │ │ │ +00042890: 2074 6865 2064 6972 6563 746f 7279 2027 the directory ' │ │ │ │ │ +000428a0: 4449 522f 6772 7562 2f27 2054 6869 7320 DIR/grub/' This │ │ │ │ │ +000428b0: 6f70 7469 6f6e 2069 730a 2020 2020 2075 option is. u │ │ │ │ │ +000428c0: 7365 6675 6c20 7768 656e 2079 6f75 2077 seful when you w │ │ │ │ │ +000428d0: 616e 7420 746f 2069 6e73 7461 6c6c 2047 ant to install G │ │ │ │ │ +000428e0: 5255 4220 696e 746f 2061 2073 6570 6172 RUB into a separ │ │ │ │ │ +000428f0: 6174 6520 7061 7274 6974 696f 6e20 6f72 ate partition or │ │ │ │ │ +00042900: 2061 0a20 2020 2020 7265 6d6f 7661 626c a. removabl │ │ │ │ │ +00042910: 6520 6469 736b 2e20 2049 6620 7468 6973 e disk. If this │ │ │ │ │ +00042920: 206f 7074 696f 6e20 6973 206e 6f74 2073 option is not s │ │ │ │ │ +00042930: 7065 6369 6669 6564 2074 6865 6e20 6974 pecified then it │ │ │ │ │ +00042940: 2064 6566 6175 6c74 730a 2020 2020 2074 defaults. t │ │ │ │ │ +00042950: 6f20 272f 626f 6f74 272c 2073 6f0a 0a20 o '/boot', so.. │ │ │ │ │ +00042960: 2020 2020 2020 2020 2067 7275 622d 696e grub-in │ │ │ │ │ +00042970: 7374 616c 6c20 2f64 6576 2f73 6461 0a0a stall /dev/sda.. │ │ │ │ │ +00042980: 2020 2020 2069 7320 6571 7569 7661 6c65 is equivale │ │ │ │ │ +00042990: 6e74 2074 6f0a 0a20 2020 2020 2020 2020 nt to.. │ │ │ │ │ +000429a0: 2067 7275 622d 696e 7374 616c 6c20 2d2d grub-install -- │ │ │ │ │ +000429b0: 626f 6f74 2d64 6972 6563 746f 7279 3d2f boot-directory=/ │ │ │ │ │ +000429c0: 626f 6f74 2f20 2f64 6576 2f73 6461 0a0a boot/ /dev/sda.. │ │ │ │ │ +000429d0: 2020 2020 2048 6572 6520 6973 2061 6e20 Here is an │ │ │ │ │ +000429e0: 6578 616d 706c 6520 696e 2077 6869 6368 example in which │ │ │ │ │ +000429f0: 2079 6f75 2068 6176 6520 6120 7365 7061 you have a sepa │ │ │ │ │ +00042a00: 7261 7465 2022 626f 6f74 2220 7061 7274 rate "boot" part │ │ │ │ │ +00042a10: 6974 696f 6e0a 2020 2020 2077 6869 6368 ition. which │ │ │ │ │ +00042a20: 2069 7320 6d6f 756e 7465 6420 6f6e 2027 is mounted on ' │ │ │ │ │ +00042a30: 2f6d 6e74 2f62 6f6f 7427 3a0a 0a20 2020 /mnt/boot':.. │ │ │ │ │ +00042a40: 2020 2020 2020 2067 7275 622d 696e 7374 grub-inst │ │ │ │ │ +00042a50: 616c 6c20 2d2d 626f 6f74 2d64 6972 6563 all --boot-direc │ │ │ │ │ +00042a60: 746f 7279 3d2f 6d6e 742f 626f 6f74 202f tory=/mnt/boot / │ │ │ │ │ +00042a70: 6465 762f 7364 620a 0a27 2d2d 7265 6368 dev/sdb..'--rech │ │ │ │ │ +00042a80: 6563 6b27 0a20 2020 2020 5265 6368 6563 eck'. Rechec │ │ │ │ │ +00042a90: 6b20 7468 6520 6465 7669 6365 206d 6170 k the device map │ │ │ │ │ +00042aa0: 2c20 6576 656e 2069 6620 272f 626f 6f74 , even if '/boot │ │ │ │ │ +00042ab0: 2f67 7275 622f 6465 7669 6365 2e6d 6170 /grub/device.map │ │ │ │ │ +00042ac0: 2720 616c 7265 6164 790a 2020 2020 2065 ' already. e │ │ │ │ │ +00042ad0: 7869 7374 732e 2020 596f 7520 7368 6f75 xists. You shou │ │ │ │ │ +00042ae0: 6c64 2075 7365 2074 6869 7320 6f70 7469 ld use this opti │ │ │ │ │ +00042af0: 6f6e 2077 6865 6e65 7665 7220 796f 7520 on whenever you │ │ │ │ │ +00042b00: 6164 642f 7265 6d6f 7665 2061 2064 6973 add/remove a dis │ │ │ │ │ +00042b10: 6b0a 2020 2020 2069 6e74 6f2f 6672 6f6d k. into/from │ │ │ │ │ +00042b20: 2079 6f75 7220 636f 6d70 7574 6572 2e0a your computer.. │ │ │ │ │ +00042b30: 0a27 2d2d 6e6f 2d72 732d 636f 6465 7327 .'--no-rs-codes' │ │ │ │ │ +00042b40: 0a20 2020 2020 4279 2064 6566 6175 6c74 . By default │ │ │ │ │ +00042b50: 206f 6e20 7838 3620 4249 4f53 2073 7973 on x86 BIOS sys │ │ │ │ │ +00042b60: 7465 6d73 2c20 2767 7275 622d 696e 7374 tems, 'grub-inst │ │ │ │ │ +00042b70: 616c 6c27 2077 696c 6c20 7573 6520 736f all' will use so │ │ │ │ │ +00042b80: 6d65 2065 7874 7261 0a20 2020 2020 7370 me extra. sp │ │ │ │ │ +00042b90: 6163 6520 696e 2074 6865 2062 6f6f 746c ace in the bootl │ │ │ │ │ +00042ba0: 6f61 6465 7220 656d 6265 6464 696e 6720 oader embedding │ │ │ │ │ +00042bb0: 6172 6561 2066 6f72 2052 6565 642d 536f area for Reed-So │ │ │ │ │ +00042bc0: 6c6f 6d6f 6e0a 2020 2020 2065 7272 6f72 lomon. error │ │ │ │ │ +00042bd0: 2d63 6f72 7265 6374 696e 6720 636f 6465 -correcting code │ │ │ │ │ +00042be0: 732e 2020 5468 6973 2065 6e61 626c 6573 s. This enables │ │ │ │ │ +00042bf0: 2047 5255 4220 746f 2073 7469 6c6c 2062 GRUB to still b │ │ │ │ │ +00042c00: 6f6f 740a 2020 2020 2073 7563 6365 7373 oot. success │ │ │ │ │ +00042c10: 6675 6c6c 7920 6966 2073 6f6d 6520 626c fully if some bl │ │ │ │ │ +00042c20: 6f63 6b73 2061 7265 2063 6f72 7275 7074 ocks are corrupt │ │ │ │ │ +00042c30: 6564 2e20 2054 6865 2065 7861 6374 2061 ed. The exact a │ │ │ │ │ +00042c40: 6d6f 756e 7420 6f66 0a20 2020 2020 7072 mount of. pr │ │ │ │ │ +00042c50: 6f74 6563 7469 6f6e 206f 6666 6572 6564 otection offered │ │ │ │ │ +00042c60: 2069 7320 6465 7065 6e64 656e 7420 6f6e is dependent on │ │ │ │ │ +00042c70: 2061 7661 696c 6162 6c65 2073 7061 6365 available space │ │ │ │ │ +00042c80: 2069 6e20 7468 6520 656d 6265 6464 696e in the embeddin │ │ │ │ │ +00042c90: 670a 2020 2020 2061 7265 612e 2020 5220 g. area. R │ │ │ │ │ +00042ca0: 7365 6374 6f72 7320 6f66 2072 6564 756e sectors of redun │ │ │ │ │ +00042cb0: 6461 6e63 7920 6361 6e20 746f 6c65 7261 dancy can tolera │ │ │ │ │ +00042cc0: 7465 2075 7020 746f 2052 2f32 2063 6f72 te up to R/2 cor │ │ │ │ │ +00042cd0: 7275 7074 6564 0a20 2020 2020 7365 6374 rupted. sect │ │ │ │ │ +00042ce0: 6f72 732e 2020 5468 6973 2072 6564 756e ors. This redun │ │ │ │ │ +00042cf0: 6461 6e63 7920 6d61 7920 6265 2063 756d dancy may be cum │ │ │ │ │ +00042d00: 6265 7273 6f6d 6520 6966 2061 7474 656d bersome if attem │ │ │ │ │ +00042d10: 7074 696e 6720 746f 0a20 2020 2020 6372 pting to. cr │ │ │ │ │ +00042d20: 7970 746f 6772 6170 6869 6361 6c6c 7920 yptographically │ │ │ │ │ +00042d30: 7661 6c69 6461 7465 2074 6865 2063 6f6e validate the con │ │ │ │ │ +00042d40: 7465 6e74 7320 6f66 2074 6865 2062 6f6f tents of the boo │ │ │ │ │ +00042d50: 746c 6f61 6465 7220 656d 6265 6464 696e tloader embeddin │ │ │ │ │ +00042d60: 670a 2020 2020 2061 7265 612c 206f 7220 g. area, or │ │ │ │ │ +00042d70: 696e 206d 6f72 6520 6d6f 6465 726e 2073 in more modern s │ │ │ │ │ +00042d80: 7973 7465 6d73 2077 6974 6820 4750 542d ystems with GPT- │ │ │ │ │ +00042d90: 7374 796c 6520 7061 7274 6974 696f 6e20 style partition │ │ │ │ │ +00042da0: 7461 626c 6573 0a20 2020 2020 282a 6e6f tables. (*no │ │ │ │ │ +00042db0: 7465 2042 494f 5320 696e 7374 616c 6c61 te BIOS installa │ │ │ │ │ +00042dc0: 7469 6f6e 3a3a 2920 7768 6572 6520 4752 tion::) where GR │ │ │ │ │ +00042dd0: 5542 2064 6f65 7320 6e6f 7420 7265 7369 UB does not resi │ │ │ │ │ +00042de0: 6465 2069 6e20 616e 790a 2020 2020 2075 de in any. u │ │ │ │ │ +00042df0: 6e70 6172 7469 7469 6f6e 6564 2073 7061 npartitioned spa │ │ │ │ │ +00042e00: 6365 206f 7574 7369 6465 206f 6620 7468 ce outside of th │ │ │ │ │ +00042e10: 6520 4d42 522e 2044 6973 6162 6c65 2074 e MBR. Disable t │ │ │ │ │ +00042e20: 6865 2052 6565 642d 536f 6c6f 6d6f 6e0a he Reed-Solomon. │ │ │ │ │ +00042e30: 2020 2020 2063 6f64 6573 2077 6974 6820 codes with │ │ │ │ │ +00042e40: 7468 6973 206f 7074 696f 6e2e 0a0a 1f0a this option..... │ │ │ │ │ +00042e50: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ +00042e60: 2020 4e6f 6465 3a20 496e 766f 6b69 6e67 Node: Invoking │ │ │ │ │ +00042e70: 2067 7275 622d 6d6b 636f 6e66 6967 2c20 grub-mkconfig, │ │ │ │ │ +00042e80: 204e 6578 743a 2049 6e76 6f6b 696e 6720 Next: Invoking │ │ │ │ │ +00042e90: 6772 7562 2d6d 6b70 6173 7377 642d 7062 grub-mkpasswd-pb │ │ │ │ │ +00042ea0: 6b64 6632 2c20 2050 7265 763a 2049 6e76 kdf2, Prev: Inv │ │ │ │ │ +00042eb0: 6f6b 696e 6720 6772 7562 2d69 6e73 7461 oking grub-insta │ │ │ │ │ +00042ec0: 6c6c 2c20 2055 703a 2054 6f70 0a0a 3234 ll, Up: Top..24 │ │ │ │ │ +00042ed0: 2049 6e76 6f6b 696e 6720 6772 7562 2d6d Invoking grub-m │ │ │ │ │ +00042ee0: 6b63 6f6e 6669 670a 2a2a 2a2a 2a2a 2a2a kconfig.******** │ │ │ │ │ 00042ef0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -00042f00: 2a2a 2a0a 0a54 6865 2070 726f 6772 616d ***..The program │ │ │ │ │ -00042f10: 2027 6772 7562 2d6d 6b63 6f6e 6669 6727 'grub-mkconfig' │ │ │ │ │ -00042f20: 2067 656e 6572 6174 6573 2061 2063 6f6e generates a con │ │ │ │ │ -00042f30: 6669 6775 7261 7469 6f6e 2066 696c 6520 figuration file │ │ │ │ │ -00042f40: 666f 7220 4752 5542 0a28 2a6e 6f74 6520 for GRUB.(*note │ │ │ │ │ -00042f50: 5369 6d70 6c65 2063 6f6e 6669 6775 7261 Simple configura │ │ │ │ │ -00042f60: 7469 6f6e 3a3a 292e 0a0a 2020 2020 2067 tion::)... g │ │ │ │ │ -00042f70: 7275 622d 6d6b 636f 6e66 6967 202d 6f20 rub-mkconfig -o │ │ │ │ │ -00042f80: 2f62 6f6f 742f 6772 7562 2f67 7275 622e /boot/grub/grub. │ │ │ │ │ -00042f90: 6366 670a 0a20 2020 2767 7275 622d 6d6b cfg.. 'grub-mk │ │ │ │ │ -00042fa0: 636f 6e66 6967 2720 6163 6365 7074 7320 config' accepts │ │ │ │ │ -00042fb0: 7468 6520 666f 6c6c 6f77 696e 6720 6f70 the following op │ │ │ │ │ -00042fc0: 7469 6f6e 733a 0a0a 272d 2d68 656c 7027 tions:..'--help' │ │ │ │ │ -00042fd0: 0a20 2020 2020 5072 696e 7420 6120 7375 . Print a su │ │ │ │ │ -00042fe0: 6d6d 6172 7920 6f66 2074 6865 2063 6f6d mmary of the com │ │ │ │ │ -00042ff0: 6d61 6e64 2d6c 696e 6520 6f70 7469 6f6e mand-line option │ │ │ │ │ -00043000: 7320 616e 6420 6578 6974 2e0a 0a27 2d2d s and exit...'-- │ │ │ │ │ -00043010: 7665 7273 696f 6e27 0a20 2020 2020 5072 version'. Pr │ │ │ │ │ -00043020: 696e 7420 7468 6520 7665 7273 696f 6e20 int the version │ │ │ │ │ -00043030: 6e75 6d62 6572 206f 6620 4752 5542 2061 number of GRUB a │ │ │ │ │ -00043040: 6e64 2065 7869 742e 0a0a 272d 6f20 4649 nd exit...'-o FI │ │ │ │ │ -00043050: 4c45 270a 272d 2d6f 7574 7075 743d 4649 LE'.'--output=FI │ │ │ │ │ -00043060: 4c45 270a 2020 2020 2053 656e 6420 7468 LE'. Send th │ │ │ │ │ -00043070: 6520 6765 6e65 7261 7465 6420 636f 6e66 e generated conf │ │ │ │ │ -00043080: 6967 7572 6174 696f 6e20 6669 6c65 2074 iguration file t │ │ │ │ │ -00043090: 6f20 4649 4c45 2e20 2054 6865 2064 6566 o FILE. The def │ │ │ │ │ -000430a0: 6175 6c74 2069 7320 746f 0a20 2020 2020 ault is to. │ │ │ │ │ -000430b0: 7365 6e64 2069 7420 746f 2073 7461 6e64 send it to stand │ │ │ │ │ -000430c0: 6172 6420 6f75 7470 7574 2e0a 0a1f 0a46 ard output.....F │ │ │ │ │ -000430d0: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ -000430e0: 204e 6f64 653a 2049 6e76 6f6b 696e 6720 Node: Invoking │ │ │ │ │ -000430f0: 6772 7562 2d6d 6b70 6173 7377 642d 7062 grub-mkpasswd-pb │ │ │ │ │ -00043100: 6b64 6632 2c20 204e 6578 743a 2049 6e76 kdf2, Next: Inv │ │ │ │ │ -00043110: 6f6b 696e 6720 6772 7562 2d6d 6b72 656c oking grub-mkrel │ │ │ │ │ -00043120: 7061 7468 2c20 2050 7265 763a 2049 6e76 path, Prev: Inv │ │ │ │ │ -00043130: 6f6b 696e 6720 6772 7562 2d6d 6b63 6f6e oking grub-mkcon │ │ │ │ │ -00043140: 6669 672c 2020 5570 3a20 546f 700a 0a32 fig, Up: Top..2 │ │ │ │ │ -00043150: 3520 496e 766f 6b69 6e67 2067 7275 622d 5 Invoking grub- │ │ │ │ │ -00043160: 6d6b 7061 7373 7764 2d70 626b 6466 320a mkpasswd-pbkdf2. │ │ │ │ │ +00042f00: 2a0a 0a54 6865 2070 726f 6772 616d 2027 *..The program ' │ │ │ │ │ +00042f10: 6772 7562 2d6d 6b63 6f6e 6669 6727 2067 grub-mkconfig' g │ │ │ │ │ +00042f20: 656e 6572 6174 6573 2061 2063 6f6e 6669 enerates a confi │ │ │ │ │ +00042f30: 6775 7261 7469 6f6e 2066 696c 6520 666f guration file fo │ │ │ │ │ +00042f40: 7220 4752 5542 0a28 2a6e 6f74 6520 5369 r GRUB.(*note Si │ │ │ │ │ +00042f50: 6d70 6c65 2063 6f6e 6669 6775 7261 7469 mple configurati │ │ │ │ │ +00042f60: 6f6e 3a3a 292e 0a0a 2020 2020 2067 7275 on::)... gru │ │ │ │ │ +00042f70: 622d 6d6b 636f 6e66 6967 202d 6f20 2f62 b-mkconfig -o /b │ │ │ │ │ +00042f80: 6f6f 742f 6772 7562 2f67 7275 622e 6366 oot/grub/grub.cf │ │ │ │ │ +00042f90: 670a 0a20 2020 2767 7275 622d 6d6b 636f g.. 'grub-mkco │ │ │ │ │ +00042fa0: 6e66 6967 2720 6163 6365 7074 7320 7468 nfig' accepts th │ │ │ │ │ +00042fb0: 6520 666f 6c6c 6f77 696e 6720 6f70 7469 e following opti │ │ │ │ │ +00042fc0: 6f6e 733a 0a0a 272d 2d68 656c 7027 0a20 ons:..'--help'. │ │ │ │ │ +00042fd0: 2020 2020 5072 696e 7420 6120 7375 6d6d Print a summ │ │ │ │ │ +00042fe0: 6172 7920 6f66 2074 6865 2063 6f6d 6d61 ary of the comma │ │ │ │ │ +00042ff0: 6e64 2d6c 696e 6520 6f70 7469 6f6e 7320 nd-line options │ │ │ │ │ +00043000: 616e 6420 6578 6974 2e0a 0a27 2d2d 7665 and exit...'--ve │ │ │ │ │ +00043010: 7273 696f 6e27 0a20 2020 2020 5072 696e rsion'. Prin │ │ │ │ │ +00043020: 7420 7468 6520 7665 7273 696f 6e20 6e75 t the version nu │ │ │ │ │ +00043030: 6d62 6572 206f 6620 4752 5542 2061 6e64 mber of GRUB and │ │ │ │ │ +00043040: 2065 7869 742e 0a0a 272d 6f20 4649 4c45 exit...'-o FILE │ │ │ │ │ +00043050: 270a 272d 2d6f 7574 7075 743d 4649 4c45 '.'--output=FILE │ │ │ │ │ +00043060: 270a 2020 2020 2053 656e 6420 7468 6520 '. Send the │ │ │ │ │ +00043070: 6765 6e65 7261 7465 6420 636f 6e66 6967 generated config │ │ │ │ │ +00043080: 7572 6174 696f 6e20 6669 6c65 2074 6f20 uration file to │ │ │ │ │ +00043090: 4649 4c45 2e20 2054 6865 2064 6566 6175 FILE. The defau │ │ │ │ │ +000430a0: 6c74 2069 7320 746f 0a20 2020 2020 7365 lt is to. se │ │ │ │ │ +000430b0: 6e64 2069 7420 746f 2073 7461 6e64 6172 nd it to standar │ │ │ │ │ +000430c0: 6420 6f75 7470 7574 2e0a 0a1f 0a46 696c d output.....Fil │ │ │ │ │ +000430d0: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ +000430e0: 6f64 653a 2049 6e76 6f6b 696e 6720 6772 ode: Invoking gr │ │ │ │ │ +000430f0: 7562 2d6d 6b70 6173 7377 642d 7062 6b64 ub-mkpasswd-pbkd │ │ │ │ │ +00043100: 6632 2c20 204e 6578 743a 2049 6e76 6f6b f2, Next: Invok │ │ │ │ │ +00043110: 696e 6720 6772 7562 2d6d 6b72 656c 7061 ing grub-mkrelpa │ │ │ │ │ +00043120: 7468 2c20 2050 7265 763a 2049 6e76 6f6b th, Prev: Invok │ │ │ │ │ +00043130: 696e 6720 6772 7562 2d6d 6b63 6f6e 6669 ing grub-mkconfi │ │ │ │ │ +00043140: 672c 2020 5570 3a20 546f 700a 0a32 3520 g, Up: Top..25 │ │ │ │ │ +00043150: 496e 766f 6b69 6e67 2067 7275 622d 6d6b Invoking grub-mk │ │ │ │ │ +00043160: 7061 7373 7764 2d70 626b 6466 320a 2a2a passwd-pbkdf2.** │ │ │ │ │ 00043170: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -00043180: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -00043190: 0a0a 5468 6520 7072 6f67 7261 6d20 2767 ..The program 'g │ │ │ │ │ -000431a0: 7275 622d 6d6b 7061 7373 7764 2d70 626b rub-mkpasswd-pbk │ │ │ │ │ -000431b0: 6466 3227 2067 656e 6572 6174 6573 2070 df2' generates p │ │ │ │ │ -000431c0: 6173 7377 6f72 6420 6861 7368 6573 2066 assword hashes f │ │ │ │ │ -000431d0: 6f72 2047 5255 420a 282a 6e6f 7465 2053 or GRUB.(*note S │ │ │ │ │ -000431e0: 6563 7572 6974 793a 3a29 2e0a 0a20 2020 ecurity::)... │ │ │ │ │ -000431f0: 2020 6772 7562 2d6d 6b70 6173 7377 642d grub-mkpasswd- │ │ │ │ │ -00043200: 7062 6b64 6632 0a0a 2020 2027 6772 7562 pbkdf2.. 'grub │ │ │ │ │ -00043210: 2d6d 6b70 6173 7377 642d 7062 6b64 6632 -mkpasswd-pbkdf2 │ │ │ │ │ -00043220: 2720 6163 6365 7074 7320 7468 6520 666f ' accepts the fo │ │ │ │ │ -00043230: 6c6c 6f77 696e 6720 6f70 7469 6f6e 733a llowing options: │ │ │ │ │ -00043240: 0a0a 272d 6320 4e55 4d42 4552 270a 272d ..'-c NUMBER'.'- │ │ │ │ │ -00043250: 2d69 7465 7261 7469 6f6e 2d63 6f75 6e74 -iteration-count │ │ │ │ │ -00043260: 3d4e 554d 4245 5227 0a20 2020 2020 4e75 =NUMBER'. Nu │ │ │ │ │ -00043270: 6d62 6572 206f 6620 6974 6572 6174 696f mber of iteratio │ │ │ │ │ -00043280: 6e73 206f 6620 7468 6520 756e 6465 726c ns of the underl │ │ │ │ │ -00043290: 7969 6e67 2070 7365 7564 6f2d 7261 6e64 ying pseudo-rand │ │ │ │ │ -000432a0: 6f6d 2066 756e 6374 696f 6e2e 0a20 2020 om function.. │ │ │ │ │ -000432b0: 2020 4465 6661 756c 7473 2074 6f20 3130 Defaults to 10 │ │ │ │ │ -000432c0: 3030 302e 0a0a 272d 6c20 4e55 4d42 4552 000...'-l NUMBER │ │ │ │ │ -000432d0: 270a 272d 2d62 7566 6c65 6e3d 4e55 4d42 '.'--buflen=NUMB │ │ │ │ │ -000432e0: 4552 270a 2020 2020 204c 656e 6774 6820 ER'. Length │ │ │ │ │ -000432f0: 6f66 2074 6865 2067 656e 6572 6174 6564 of the generated │ │ │ │ │ -00043300: 2068 6173 682e 2020 4465 6661 756c 7473 hash. Defaults │ │ │ │ │ -00043310: 2074 6f20 3634 2e0a 0a27 2d73 204e 554d to 64...'-s NUM │ │ │ │ │ -00043320: 4245 5227 0a27 2d2d 7361 6c74 3d4e 554d BER'.'--salt=NUM │ │ │ │ │ -00043330: 4245 5227 0a20 2020 2020 4c65 6e67 7468 BER'. Length │ │ │ │ │ -00043340: 206f 6620 7468 6520 7361 6c74 2e20 2044 of the salt. D │ │ │ │ │ -00043350: 6566 6175 6c74 7320 746f 2036 342e 0a0a efaults to 64... │ │ │ │ │ -00043360: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ -00043370: 6f2c 2020 4e6f 6465 3a20 496e 766f 6b69 o, Node: Invoki │ │ │ │ │ -00043380: 6e67 2067 7275 622d 6d6b 7265 6c70 6174 ng grub-mkrelpat │ │ │ │ │ -00043390: 682c 2020 4e65 7874 3a20 496e 766f 6b69 h, Next: Invoki │ │ │ │ │ -000433a0: 6e67 2067 7275 622d 6d6b 7265 7363 7565 ng grub-mkrescue │ │ │ │ │ -000433b0: 2c20 2050 7265 763a 2049 6e76 6f6b 696e , Prev: Invokin │ │ │ │ │ -000433c0: 6720 6772 7562 2d6d 6b70 6173 7377 642d g grub-mkpasswd- │ │ │ │ │ -000433d0: 7062 6b64 6632 2c20 2055 703a 2054 6f70 pbkdf2, Up: Top │ │ │ │ │ -000433e0: 0a0a 3236 2049 6e76 6f6b 696e 6720 6772 ..26 Invoking gr │ │ │ │ │ -000433f0: 7562 2d6d 6b72 656c 7061 7468 0a2a 2a2a ub-mkrelpath.*** │ │ │ │ │ +00043180: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a **************.. │ │ │ │ │ +00043190: 5468 6520 7072 6f67 7261 6d20 2767 7275 The program 'gru │ │ │ │ │ +000431a0: 622d 6d6b 7061 7373 7764 2d70 626b 6466 b-mkpasswd-pbkdf │ │ │ │ │ +000431b0: 3227 2067 656e 6572 6174 6573 2070 6173 2' generates pas │ │ │ │ │ +000431c0: 7377 6f72 6420 6861 7368 6573 2066 6f72 sword hashes for │ │ │ │ │ +000431d0: 2047 5255 420a 282a 6e6f 7465 2053 6563 GRUB.(*note Sec │ │ │ │ │ +000431e0: 7572 6974 793a 3a29 2e0a 0a20 2020 2020 urity::)... │ │ │ │ │ +000431f0: 6772 7562 2d6d 6b70 6173 7377 642d 7062 grub-mkpasswd-pb │ │ │ │ │ +00043200: 6b64 6632 0a0a 2020 2027 6772 7562 2d6d kdf2.. 'grub-m │ │ │ │ │ +00043210: 6b70 6173 7377 642d 7062 6b64 6632 2720 kpasswd-pbkdf2' │ │ │ │ │ +00043220: 6163 6365 7074 7320 7468 6520 666f 6c6c accepts the foll │ │ │ │ │ +00043230: 6f77 696e 6720 6f70 7469 6f6e 733a 0a0a owing options:.. │ │ │ │ │ +00043240: 272d 6320 4e55 4d42 4552 270a 272d 2d69 '-c NUMBER'.'--i │ │ │ │ │ +00043250: 7465 7261 7469 6f6e 2d63 6f75 6e74 3d4e teration-count=N │ │ │ │ │ +00043260: 554d 4245 5227 0a20 2020 2020 4e75 6d62 UMBER'. Numb │ │ │ │ │ +00043270: 6572 206f 6620 6974 6572 6174 696f 6e73 er of iterations │ │ │ │ │ +00043280: 206f 6620 7468 6520 756e 6465 726c 7969 of the underlyi │ │ │ │ │ +00043290: 6e67 2070 7365 7564 6f2d 7261 6e64 6f6d ng pseudo-random │ │ │ │ │ +000432a0: 2066 756e 6374 696f 6e2e 0a20 2020 2020 function.. │ │ │ │ │ +000432b0: 4465 6661 756c 7473 2074 6f20 3130 3030 Defaults to 1000 │ │ │ │ │ +000432c0: 302e 0a0a 272d 6c20 4e55 4d42 4552 270a 0...'-l NUMBER'. │ │ │ │ │ +000432d0: 272d 2d62 7566 6c65 6e3d 4e55 4d42 4552 '--buflen=NUMBER │ │ │ │ │ +000432e0: 270a 2020 2020 204c 656e 6774 6820 6f66 '. Length of │ │ │ │ │ +000432f0: 2074 6865 2067 656e 6572 6174 6564 2068 the generated h │ │ │ │ │ +00043300: 6173 682e 2020 4465 6661 756c 7473 2074 ash. Defaults t │ │ │ │ │ +00043310: 6f20 3634 2e0a 0a27 2d73 204e 554d 4245 o 64...'-s NUMBE │ │ │ │ │ +00043320: 5227 0a27 2d2d 7361 6c74 3d4e 554d 4245 R'.'--salt=NUMBE │ │ │ │ │ +00043330: 5227 0a20 2020 2020 4c65 6e67 7468 206f R'. Length o │ │ │ │ │ +00043340: 6620 7468 6520 7361 6c74 2e20 2044 6566 f the salt. Def │ │ │ │ │ +00043350: 6175 6c74 7320 746f 2036 342e 0a0a 1f0a aults to 64..... │ │ │ │ │ +00043360: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ +00043370: 2020 4e6f 6465 3a20 496e 766f 6b69 6e67 Node: Invoking │ │ │ │ │ +00043380: 2067 7275 622d 6d6b 7265 6c70 6174 682c grub-mkrelpath, │ │ │ │ │ +00043390: 2020 4e65 7874 3a20 496e 766f 6b69 6e67 Next: Invoking │ │ │ │ │ +000433a0: 2067 7275 622d 6d6b 7265 7363 7565 2c20 grub-mkrescue, │ │ │ │ │ +000433b0: 2050 7265 763a 2049 6e76 6f6b 696e 6720 Prev: Invoking │ │ │ │ │ +000433c0: 6772 7562 2d6d 6b70 6173 7377 642d 7062 grub-mkpasswd-pb │ │ │ │ │ +000433d0: 6b64 6632 2c20 2055 703a 2054 6f70 0a0a kdf2, Up: Top.. │ │ │ │ │ +000433e0: 3236 2049 6e76 6f6b 696e 6720 6772 7562 26 Invoking grub │ │ │ │ │ +000433f0: 2d6d 6b72 656c 7061 7468 0a2a 2a2a 2a2a -mkrelpath.***** │ │ │ │ │ 00043400: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -00043410: 2a2a 2a2a 2a2a 2a0a 0a54 6865 2070 726f *******..The pro │ │ │ │ │ -00043420: 6772 616d 2027 6772 7562 2d6d 6b72 656c gram 'grub-mkrel │ │ │ │ │ -00043430: 7061 7468 2720 6d61 6b65 7320 6120 6669 path' makes a fi │ │ │ │ │ -00043440: 6c65 2073 7973 7465 6d20 7061 7468 2072 le system path r │ │ │ │ │ -00043450: 656c 6174 6976 6520 746f 2074 6865 0a72 elative to the.r │ │ │ │ │ -00043460: 6f6f 7420 6f66 2069 7473 2063 6f6e 7461 oot of its conta │ │ │ │ │ -00043470: 696e 696e 6720 6669 6c65 2073 7973 7465 ining file syste │ │ │ │ │ -00043480: 6d2e 2020 466f 7220 696e 7374 616e 6365 m. For instance │ │ │ │ │ -00043490: 2c20 6966 2027 2f75 7372 2720 6973 2061 , if '/usr' is a │ │ │ │ │ -000434a0: 206d 6f75 6e74 0a70 6f69 6e74 2c20 7468 mount.point, th │ │ │ │ │ -000434b0: 656e 3a0a 0a20 2020 2020 2420 6772 7562 en:.. $ grub │ │ │ │ │ -000434c0: 2d6d 6b72 656c 7061 7468 202f 7573 722f -mkrelpath /usr/ │ │ │ │ │ -000434d0: 7368 6172 652f 6772 7562 2f75 6e69 636f share/grub/unico │ │ │ │ │ -000434e0: 6465 2e70 6632 0a20 2020 2020 272f 7368 de.pf2. '/sh │ │ │ │ │ -000434f0: 6172 652f 6772 7562 2f75 6e69 636f 6465 are/grub/unicode │ │ │ │ │ -00043500: 2e70 6632 270a 0a20 2020 5468 6973 2069 .pf2'.. This i │ │ │ │ │ -00043510: 7320 6d61 696e 6c79 2075 7365 6420 696e s mainly used in │ │ │ │ │ -00043520: 7465 726e 616c 6c79 2062 7920 6f74 6865 ternally by othe │ │ │ │ │ -00043530: 7220 4752 5542 2075 7469 6c69 7469 6573 r GRUB utilities │ │ │ │ │ -00043540: 2073 7563 6820 6173 0a27 6772 7562 2d6d such as.'grub-m │ │ │ │ │ -00043550: 6b63 6f6e 6669 6727 2028 2a6e 6f74 6520 kconfig' (*note │ │ │ │ │ -00043560: 496e 766f 6b69 6e67 2067 7275 622d 6d6b Invoking grub-mk │ │ │ │ │ -00043570: 636f 6e66 6967 3a3a 292c 2062 7574 206d config::), but m │ │ │ │ │ -00043580: 6179 206f 6363 6173 696f 6e61 6c6c 790a ay occasionally. │ │ │ │ │ -00043590: 616c 736f 2062 6520 7573 6566 756c 2066 also be useful f │ │ │ │ │ -000435a0: 6f72 2064 6562 7567 6769 6e67 2e0a 0a20 or debugging... │ │ │ │ │ -000435b0: 2020 2767 7275 622d 6d6b 7265 6c70 6174 'grub-mkrelpat │ │ │ │ │ -000435c0: 6827 2061 6363 6570 7473 2074 6865 2066 h' accepts the f │ │ │ │ │ -000435d0: 6f6c 6c6f 7769 6e67 206f 7074 696f 6e73 ollowing options │ │ │ │ │ -000435e0: 3a0a 0a27 2d2d 6865 6c70 270a 2020 2020 :..'--help'. │ │ │ │ │ -000435f0: 2050 7269 6e74 2061 2073 756d 6d61 7279 Print a summary │ │ │ │ │ -00043600: 206f 6620 7468 6520 636f 6d6d 616e 642d of the command- │ │ │ │ │ -00043610: 6c69 6e65 206f 7074 696f 6e73 2061 6e64 line options and │ │ │ │ │ -00043620: 2065 7869 742e 0a0a 272d 2d76 6572 7369 exit...'--versi │ │ │ │ │ -00043630: 6f6e 270a 2020 2020 2050 7269 6e74 2074 on'. Print t │ │ │ │ │ -00043640: 6865 2076 6572 7369 6f6e 206e 756d 6265 he version numbe │ │ │ │ │ -00043650: 7220 6f66 2047 5255 4220 616e 6420 6578 r of GRUB and ex │ │ │ │ │ -00043660: 6974 2e0a 0a1f 0a46 696c 653a 2067 7275 it.....File: gru │ │ │ │ │ -00043670: 622e 696e 666f 2c20 204e 6f64 653a 2049 b.info, Node: I │ │ │ │ │ -00043680: 6e76 6f6b 696e 6720 6772 7562 2d6d 6b72 nvoking grub-mkr │ │ │ │ │ -00043690: 6573 6375 652c 2020 4e65 7874 3a20 496e escue, Next: In │ │ │ │ │ -000436a0: 766f 6b69 6e67 2067 7275 622d 6d6f 756e voking grub-moun │ │ │ │ │ -000436b0: 742c 2020 5072 6576 3a20 496e 766f 6b69 t, Prev: Invoki │ │ │ │ │ -000436c0: 6e67 2067 7275 622d 6d6b 7265 6c70 6174 ng grub-mkrelpat │ │ │ │ │ -000436d0: 682c 2020 5570 3a20 546f 700a 0a32 3720 h, Up: Top..27 │ │ │ │ │ -000436e0: 496e 766f 6b69 6e67 2067 7275 622d 6d6b Invoking grub-mk │ │ │ │ │ -000436f0: 7265 7363 7565 0a2a 2a2a 2a2a 2a2a 2a2a rescue.********* │ │ │ │ │ -00043700: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -00043710: 0a0a 5468 6520 7072 6f67 7261 6d20 2767 ..The program 'g │ │ │ │ │ -00043720: 7275 622d 6d6b 7265 7363 7565 2720 6765 rub-mkrescue' ge │ │ │ │ │ -00043730: 6e65 7261 7465 7320 6120 626f 6f74 6162 nerates a bootab │ │ │ │ │ -00043740: 6c65 2047 5255 4220 7265 7363 7565 2069 le GRUB rescue i │ │ │ │ │ -00043750: 6d61 6765 0a28 2a6e 6f74 6520 4d61 6b69 mage.(*note Maki │ │ │ │ │ -00043760: 6e67 2061 2047 5255 4220 626f 6f74 6162 ng a GRUB bootab │ │ │ │ │ -00043770: 6c65 2043 442d 524f 4d3a 3a29 2e0a 0a20 le CD-ROM::)... │ │ │ │ │ -00043780: 2020 2020 6772 7562 2d6d 6b72 6573 6375 grub-mkrescu │ │ │ │ │ -00043790: 6520 2d6f 2067 7275 622e 6973 6f0a 0a20 e -o grub.iso.. │ │ │ │ │ -000437a0: 2020 416c 6c20 6172 6775 6d65 6e74 7320 All arguments │ │ │ │ │ -000437b0: 6e6f 7420 6578 706c 6963 6974 6c79 206c not explicitly l │ │ │ │ │ -000437c0: 6973 7465 6420 6173 2027 6772 7562 2d6d isted as 'grub-m │ │ │ │ │ -000437d0: 6b72 6573 6375 6527 206f 7074 696f 6e73 krescue' options │ │ │ │ │ -000437e0: 2061 7265 0a70 6173 7365 6420 6f6e 2064 are.passed on d │ │ │ │ │ -000437f0: 6972 6563 746c 7920 746f 2027 786f 7272 irectly to 'xorr │ │ │ │ │ -00043800: 6973 6f27 2069 6e20 276d 6b69 736f 6673 iso' in 'mkisofs │ │ │ │ │ -00043810: 2720 656d 756c 6174 696f 6e20 6d6f 6465 ' emulation mode │ │ │ │ │ -00043820: 2e20 204f 7074 696f 6e73 0a70 6173 7365 . Options.passe │ │ │ │ │ -00043830: 6420 746f 2027 786f 7272 6973 6f27 2077 d to 'xorriso' w │ │ │ │ │ -00043840: 696c 6c20 6e6f 726d 616c 6c79 2062 6520 ill normally be │ │ │ │ │ -00043850: 696e 7465 7270 7265 7465 6420 6173 2027 interpreted as ' │ │ │ │ │ -00043860: 6d6b 6973 6f66 7327 206f 7074 696f 6e73 mkisofs' options │ │ │ │ │ -00043870: 3b0a 6966 2074 6865 206f 7074 696f 6e20 ;.if the option │ │ │ │ │ -00043880: 272d 2d27 2069 7320 7573 6564 2c20 7468 '--' is used, th │ │ │ │ │ -00043890: 656e 2061 6e79 7468 696e 6720 6166 7465 en anything afte │ │ │ │ │ -000438a0: 7220 7468 6174 2077 696c 6c20 6265 2069 r that will be i │ │ │ │ │ -000438b0: 6e74 6572 7072 6574 6564 0a61 7320 6e61 nterpreted.as na │ │ │ │ │ -000438c0: 7469 7665 2027 786f 7272 6973 6f27 206f tive 'xorriso' o │ │ │ │ │ -000438d0: 7074 696f 6e73 2e0a 0a20 2020 4e6f 6e2d ptions... Non- │ │ │ │ │ -000438e0: 6f70 7469 6f6e 2061 7267 756d 656e 7473 option arguments │ │ │ │ │ -000438f0: 2073 7065 6369 6679 2061 6464 6974 696f specify additio │ │ │ │ │ -00043900: 6e61 6c20 736f 7572 6365 2064 6972 6563 nal source direc │ │ │ │ │ -00043910: 746f 7269 6573 2e20 2054 6869 7320 6973 tories. This is │ │ │ │ │ -00043920: 0a63 6f6d 6d6f 6e6c 7920 7573 6564 2074 .commonly used t │ │ │ │ │ -00043930: 6f20 6164 6420 6578 7472 6120 6669 6c65 o add extra file │ │ │ │ │ -00043940: 7320 746f 2074 6865 2069 6d61 6765 3a0a s to the image:. │ │ │ │ │ -00043950: 0a20 2020 2020 6d6b 6469 7220 2d70 2064 . mkdir -p d │ │ │ │ │ -00043960: 6973 6b2f 626f 6f74 2f67 7275 620a 2020 isk/boot/grub. │ │ │ │ │ -00043970: 2020 2028 6164 6420 6578 7472 6120 6669 (add extra fi │ │ │ │ │ -00043980: 6c65 7320 746f 2027 6469 736b 2f62 6f6f les to 'disk/boo │ │ │ │ │ -00043990: 742f 6772 7562 2729 0a20 2020 2020 6772 t/grub'). gr │ │ │ │ │ -000439a0: 7562 2d6d 6b72 6573 6375 6520 2d6f 2067 ub-mkrescue -o g │ │ │ │ │ -000439b0: 7275 622e 6973 6f20 6469 736b 0a0a 2020 rub.iso disk.. │ │ │ │ │ -000439c0: 2027 6772 7562 2d6d 6b72 6573 6375 6527 'grub-mkrescue' │ │ │ │ │ -000439d0: 2061 6363 6570 7473 2074 6865 2066 6f6c accepts the fol │ │ │ │ │ -000439e0: 6c6f 7769 6e67 206f 7074 696f 6e73 3a0a lowing options:. │ │ │ │ │ -000439f0: 0a27 2d2d 6865 6c70 270a 2020 2020 2050 .'--help'. P │ │ │ │ │ -00043a00: 7269 6e74 2061 2073 756d 6d61 7279 206f rint a summary o │ │ │ │ │ -00043a10: 6620 7468 6520 636f 6d6d 616e 642d 6c69 f the command-li │ │ │ │ │ -00043a20: 6e65 206f 7074 696f 6e73 2061 6e64 2065 ne options and e │ │ │ │ │ -00043a30: 7869 742e 0a0a 272d 2d76 6572 7369 6f6e xit...'--version │ │ │ │ │ -00043a40: 270a 2020 2020 2050 7269 6e74 2074 6865 '. Print the │ │ │ │ │ -00043a50: 2076 6572 7369 6f6e 206e 756d 6265 7220 version number │ │ │ │ │ -00043a60: 6f66 2047 5255 4220 616e 6420 6578 6974 of GRUB and exit │ │ │ │ │ -00043a70: 2e0a 0a27 2d6f 2046 494c 4527 0a27 2d2d ...'-o FILE'.'-- │ │ │ │ │ -00043a80: 6f75 7470 7574 3d46 494c 4527 0a20 2020 output=FILE'. │ │ │ │ │ -00043a90: 2020 5361 7665 206f 7574 7075 7420 696e Save output in │ │ │ │ │ -00043aa0: 2046 494c 452e 2020 5468 6973 2022 6f70 FILE. This "op │ │ │ │ │ -00043ab0: 7469 6f6e 2220 6973 2072 6571 7569 7265 tion" is require │ │ │ │ │ -00043ac0: 642e 0a0a 272d 2d6d 6f64 756c 6573 3d4d d...'--modules=M │ │ │ │ │ -00043ad0: 4f44 554c 4553 270a 2020 2020 2050 7265 ODULES'. Pre │ │ │ │ │ -00043ae0: 2d6c 6f61 6420 7468 6520 6e61 6d65 6420 -load the named │ │ │ │ │ -00043af0: 4752 5542 206d 6f64 756c 6573 2069 6e20 GRUB modules in │ │ │ │ │ -00043b00: 7468 6520 696d 6167 652e 2020 4d75 6c74 the image. Mult │ │ │ │ │ -00043b10: 6970 6c65 2065 6e74 7269 6573 2069 6e0a iple entries in. │ │ │ │ │ -00043b20: 2020 2020 204d 4f44 554c 4553 2073 686f MODULES sho │ │ │ │ │ -00043b30: 756c 6420 6265 2073 6570 6172 6174 6564 uld be separated │ │ │ │ │ -00043b40: 2062 7920 7768 6974 6573 7061 6365 2028 by whitespace ( │ │ │ │ │ -00043b50: 736f 2079 6f75 2077 696c 6c20 7072 6f62 so you will prob │ │ │ │ │ -00043b60: 6162 6c79 0a20 2020 2020 6e65 6564 2074 ably. need t │ │ │ │ │ -00043b70: 6f20 7175 6f74 6520 7468 6973 2066 6f72 o quote this for │ │ │ │ │ -00043b80: 2079 6f75 7220 7368 656c 6c29 2e0a 0a27 your shell)...' │ │ │ │ │ -00043b90: 2d2d 726f 6d2d 6469 7265 6374 6f72 793d --rom-directory= │ │ │ │ │ -00043ba0: 4449 5227 0a20 2020 2020 4966 2067 656e DIR'. If gen │ │ │ │ │ -00043bb0: 6572 6174 696e 6720 696d 6167 6573 2066 erating images f │ │ │ │ │ -00043bc0: 6f72 2074 6865 2051 454d 5520 6f72 2043 or the QEMU or C │ │ │ │ │ -00043bd0: 6f72 6562 6f6f 7420 706c 6174 666f 726d oreboot platform │ │ │ │ │ -00043be0: 732c 2063 6f70 7920 7468 650a 2020 2020 s, copy the. │ │ │ │ │ -00043bf0: 2072 6573 756c 7469 6e67 2027 7165 6d75 resulting 'qemu │ │ │ │ │ -00043c00: 2e69 6d67 2720 6f72 2027 636f 7265 626f .img' or 'corebo │ │ │ │ │ -00043c10: 6f74 2e65 6c66 2720 6669 6c65 7320 7265 ot.elf' files re │ │ │ │ │ -00043c20: 7370 6563 7469 7665 6c79 2074 6f20 7468 spectively to th │ │ │ │ │ -00043c30: 650a 2020 2020 2044 4952 2064 6972 6563 e. DIR direc │ │ │ │ │ -00043c40: 746f 7279 2061 7320 7765 6c6c 2061 7320 tory as well as │ │ │ │ │ -00043c50: 696e 636c 7564 696e 6720 7468 656d 2069 including them i │ │ │ │ │ -00043c60: 6e20 7468 6520 696d 6167 652e 0a0a 272d n the image...'- │ │ │ │ │ -00043c70: 2d78 6f72 7269 736f 3d46 494c 4527 0a20 -xorriso=FILE'. │ │ │ │ │ -00043c80: 2020 2020 5573 6520 4649 4c45 2061 7320 Use FILE as │ │ │ │ │ -00043c90: 7468 6520 2778 6f72 7269 736f 2720 7072 the 'xorriso' pr │ │ │ │ │ -00043ca0: 6f67 7261 6d2c 2072 6174 6865 7220 7468 ogram, rather th │ │ │ │ │ -00043cb0: 616e 2074 6865 2062 7569 6c74 2d69 6e0a an the built-in. │ │ │ │ │ -00043cc0: 2020 2020 2064 6566 6175 6c74 2e0a 0a27 default...' │ │ │ │ │ -00043cd0: 2d2d 6772 7562 2d6d 6b69 6d61 6765 3d46 --grub-mkimage=F │ │ │ │ │ -00043ce0: 494c 4527 0a20 2020 2020 5573 6520 4649 ILE'. Use FI │ │ │ │ │ -00043cf0: 4c45 2061 7320 7468 6520 2767 7275 622d LE as the 'grub- │ │ │ │ │ -00043d00: 6d6b 696d 6167 6527 2070 726f 6772 616d mkimage' program │ │ │ │ │ -00043d10: 2c20 7261 7468 6572 2074 6861 6e20 7468 , rather than th │ │ │ │ │ -00043d20: 6520 6275 696c 742d 696e 0a20 2020 2020 e built-in. │ │ │ │ │ -00043d30: 6465 6661 756c 742e 0a0a 1f0a 4669 6c65 default.....File │ │ │ │ │ -00043d40: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ -00043d50: 6465 3a20 496e 766f 6b69 6e67 2067 7275 de: Invoking gru │ │ │ │ │ -00043d60: 622d 6d6f 756e 742c 2020 4e65 7874 3a20 b-mount, Next: │ │ │ │ │ -00043d70: 496e 766f 6b69 6e67 2067 7275 622d 7072 Invoking grub-pr │ │ │ │ │ -00043d80: 6f62 652c 2020 5072 6576 3a20 496e 766f obe, Prev: Invo │ │ │ │ │ -00043d90: 6b69 6e67 2067 7275 622d 6d6b 7265 7363 king grub-mkresc │ │ │ │ │ -00043da0: 7565 2c20 2055 703a 2054 6f70 0a0a 3238 ue, Up: Top..28 │ │ │ │ │ -00043db0: 2049 6e76 6f6b 696e 6720 6772 7562 2d6d Invoking grub-m │ │ │ │ │ -00043dc0: 6f75 6e74 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a ount.*********** │ │ │ │ │ -00043dd0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a54 6865 ***********..The │ │ │ │ │ -00043de0: 2070 726f 6772 616d 2027 6772 7562 2d6d program 'grub-m │ │ │ │ │ -00043df0: 6f75 6e74 2720 7065 7266 6f72 6d73 2061 ount' performs a │ │ │ │ │ -00043e00: 2072 6561 642d 6f6e 6c79 206d 6f75 6e74 read-only mount │ │ │ │ │ -00043e10: 206f 6620 616e 7920 6669 6c65 2073 7973 of any file sys │ │ │ │ │ -00043e20: 7465 6d0a 6f72 2066 696c 6520 7379 7374 tem.or file syst │ │ │ │ │ -00043e30: 656d 2069 6d61 6765 2074 6861 7420 4752 em image that GR │ │ │ │ │ -00043e40: 5542 2075 6e64 6572 7374 616e 6473 2c20 UB understands, │ │ │ │ │ -00043e50: 7573 696e 6720 4752 5542 2773 2066 696c using GRUB's fil │ │ │ │ │ -00043e60: 6520 7379 7374 656d 0a64 7269 7665 7273 e system.drivers │ │ │ │ │ -00043e70: 2076 6961 2046 5553 452e 2028 4974 2069 via FUSE. (It i │ │ │ │ │ -00043e80: 7320 6f6e 6c79 2061 7661 696c 6162 6c65 s only available │ │ │ │ │ -00043e90: 2069 6620 4655 5345 2064 6576 656c 6f70 if FUSE develop │ │ │ │ │ -00043ea0: 6d65 6e74 2066 696c 6573 2077 6572 650a ment files were. │ │ │ │ │ -00043eb0: 7072 6573 656e 7420 7768 656e 2047 5255 present when GRU │ │ │ │ │ -00043ec0: 4220 7761 7320 6275 696c 742e 2920 2054 B was built.) T │ │ │ │ │ -00043ed0: 6869 7320 6861 7320 6120 6e75 6d62 6572 his has a number │ │ │ │ │ -00043ee0: 206f 6620 7573 6573 3a0a 0a20 2020 2a20 of uses:.. * │ │ │ │ │ -00043ef0: 4974 2070 726f 7669 6465 7320 6120 636f It provides a co │ │ │ │ │ -00043f00: 6e76 656e 6965 6e74 2077 6179 2074 6f20 nvenient way to │ │ │ │ │ -00043f10: 6368 6563 6b20 686f 7720 4752 5542 2077 check how GRUB w │ │ │ │ │ -00043f20: 696c 6c20 7669 6577 2061 2066 696c 650a ill view a file. │ │ │ │ │ -00043f30: 2020 2020 2073 7973 7465 6d20 6174 2062 system at b │ │ │ │ │ -00043f40: 6f6f 7420 7469 6d65 2e20 2059 6f75 2063 oot time. You c │ │ │ │ │ -00043f50: 616e 2075 7365 206e 6f72 6d61 6c20 636f an use normal co │ │ │ │ │ -00043f60: 6d6d 616e 642d 6c69 6e65 2074 6f6f 6c73 mmand-line tools │ │ │ │ │ -00043f70: 2074 6f0a 2020 2020 2063 6f6d 7061 7265 to. compare │ │ │ │ │ -00043f80: 2074 6861 7420 7669 6577 2077 6974 6820 that view with │ │ │ │ │ -00043f90: 7468 6174 206f 6620 796f 7572 206f 7065 that of your ope │ │ │ │ │ -00043fa0: 7261 7469 6e67 2073 7973 7465 6d2c 206d rating system, m │ │ │ │ │ -00043fb0: 616b 696e 6720 6974 0a20 2020 2020 6561 aking it. ea │ │ │ │ │ -00043fc0: 7379 2074 6f20 6669 6e64 2062 7567 732e sy to find bugs. │ │ │ │ │ -00043fd0: 0a0a 2020 202a 2049 7420 6f66 6665 7273 .. * It offers │ │ │ │ │ -00043fe0: 2074 7275 6520 7265 6164 2d6f 6e6c 7920 true read-only │ │ │ │ │ -00043ff0: 6d6f 756e 7473 2e20 204c 696e 7578 2064 mounts. Linux d │ │ │ │ │ -00044000: 6f65 7320 6e6f 7420 6861 7665 2074 6865 oes not have the │ │ │ │ │ -00044010: 7365 2066 6f72 0a20 2020 2020 6a6f 7572 se for. jour │ │ │ │ │ -00044020: 6e61 6c6c 696e 6720 6669 6c65 2073 7973 nalling file sys │ │ │ │ │ -00044030: 7465 6d73 2c20 6265 6361 7573 6520 6974 tems, because it │ │ │ │ │ -00044040: 2077 696c 6c20 616c 7761 7973 2061 7474 will always att │ │ │ │ │ -00044050: 656d 7074 2074 6f20 7265 706c 6179 0a20 empt to replay. │ │ │ │ │ -00044060: 2020 2020 7468 6520 6a6f 7572 6e61 6c20 the journal │ │ │ │ │ -00044070: 6174 206d 6f75 6e74 2074 696d 653b 2077 at mount time; w │ │ │ │ │ -00044080: 6869 6c65 2079 6f75 2063 616e 2074 656d hile you can tem │ │ │ │ │ -00044090: 706f 7261 7269 6c79 206d 6172 6b20 7468 porarily mark th │ │ │ │ │ -000440a0: 6520 626c 6f63 6b0a 2020 2020 2064 6576 e block. dev │ │ │ │ │ -000440b0: 6963 6520 7265 6164 2d6f 6e6c 7920 746f ice read-only to │ │ │ │ │ -000440c0: 2061 766f 6964 2074 6869 732c 2074 6861 avoid this, tha │ │ │ │ │ -000440d0: 7420 6361 7573 6573 2074 6865 206d 6f75 t causes the mou │ │ │ │ │ -000440e0: 6e74 2074 6f20 6661 696c 2e0a 2020 2020 nt to fail.. │ │ │ │ │ -000440f0: 2053 696e 6365 2047 5255 4220 696e 7465 Since GRUB inte │ │ │ │ │ -00044100: 6e74 696f 6e61 6c6c 7920 636f 6e74 6169 ntionally contai │ │ │ │ │ -00044110: 6e73 206e 6f20 636f 6465 2066 6f72 2077 ns no code for w │ │ │ │ │ -00044120: 7269 7469 6e67 2074 6f20 6669 6c65 0a20 riting to file. │ │ │ │ │ -00044130: 2020 2020 7379 7374 656d 732c 2069 7420 systems, it │ │ │ │ │ -00044140: 6361 6e20 6561 7369 6c79 2070 726f 7669 can easily provi │ │ │ │ │ -00044150: 6465 2061 2067 7561 7261 6e74 6565 6420 de a guaranteed │ │ │ │ │ -00044160: 7265 6164 2d6f 6e6c 7920 6d6f 756e 740a read-only mount. │ │ │ │ │ -00044170: 2020 2020 206d 6563 6861 6e69 736d 2e0a mechanism.. │ │ │ │ │ -00044180: 0a20 2020 2a20 4974 2061 6c6c 6f77 7320 . * It allows │ │ │ │ │ -00044190: 796f 7520 746f 2065 7861 6d69 6e65 2061 you to examine a │ │ │ │ │ -000441a0: 6e79 2066 696c 6520 7379 7374 656d 2074 ny file system t │ │ │ │ │ -000441b0: 6861 7420 4752 5542 2075 6e64 6572 7374 hat GRUB underst │ │ │ │ │ -000441c0: 616e 6473 0a20 2020 2020 7769 7468 6f75 ands. withou │ │ │ │ │ -000441d0: 7420 6e65 6564 696e 6720 746f 206c 6f61 t needing to loa │ │ │ │ │ -000441e0: 6420 6164 6469 7469 6f6e 616c 206d 6f64 d additional mod │ │ │ │ │ -000441f0: 756c 6573 2069 6e74 6f20 796f 7572 2072 ules into your r │ │ │ │ │ -00044200: 756e 6e69 6e67 0a20 2020 2020 6b65 726e unning. kern │ │ │ │ │ -00044210: 656c 2c20 7768 6963 6820 6d61 7920 6265 el, which may be │ │ │ │ │ -00044220: 2075 7365 6675 6c20 696e 2063 6f6e 7374 useful in const │ │ │ │ │ -00044230: 7261 696e 6564 2065 6e76 6972 6f6e 6d65 rained environme │ │ │ │ │ -00044240: 6e74 7320 7375 6368 2061 730a 2020 2020 nts such as. │ │ │ │ │ -00044250: 2069 6e73 7461 6c6c 6572 732e 0a0a 2020 installers... │ │ │ │ │ -00044260: 202a 2053 696e 6365 2069 7420 6361 6e20 * Since it can │ │ │ │ │ -00044270: 6578 616d 696e 6520 6669 6c65 2073 7973 examine file sys │ │ │ │ │ -00044280: 7465 6d20 696d 6167 6573 2028 636f 6e74 tem images (cont │ │ │ │ │ -00044290: 6169 6e65 6420 696e 2072 6567 756c 6172 ained in regular │ │ │ │ │ -000442a0: 0a20 2020 2020 6669 6c65 7329 206a 7573 . files) jus │ │ │ │ │ -000442b0: 7420 6173 2065 6173 696c 7920 6173 2066 t as easily as f │ │ │ │ │ -000442c0: 696c 6520 7379 7374 656d 7320 6f6e 2062 ile systems on b │ │ │ │ │ -000442d0: 6c6f 636b 2064 6576 6963 6573 2c20 796f lock devices, yo │ │ │ │ │ -000442e0: 7520 6361 6e20 7573 650a 2020 2020 2069 u can use. i │ │ │ │ │ -000442f0: 7420 746f 2069 6e73 7065 6374 2061 6e79 t to inspect any │ │ │ │ │ -00044300: 2066 696c 6520 7379 7374 656d 2069 6d61 file system ima │ │ │ │ │ -00044310: 6765 2074 6861 7420 4752 5542 2075 6e64 ge that GRUB und │ │ │ │ │ -00044320: 6572 7374 616e 6473 2077 6974 6820 6f6e erstands with on │ │ │ │ │ -00044330: 6c79 0a20 2020 2020 656e 6f75 6768 2070 ly. enough p │ │ │ │ │ -00044340: 7269 7669 6c65 6765 7320 746f 2075 7365 rivileges to use │ │ │ │ │ -00044350: 2046 5553 452c 2065 7665 6e20 6966 206e FUSE, even if n │ │ │ │ │ -00044360: 6f62 6f64 7920 6861 7320 7965 7420 7772 obody has yet wr │ │ │ │ │ -00044370: 6974 7465 6e20 610a 2020 2020 2046 5553 itten a. FUS │ │ │ │ │ -00044380: 4520 6d6f 6475 6c65 2073 7065 6369 6669 E module specifi │ │ │ │ │ -00044390: 6361 6c6c 7920 666f 7220 7468 6174 2066 cally for that f │ │ │ │ │ -000443a0: 696c 6520 7379 7374 656d 2074 7970 652e ile system type. │ │ │ │ │ -000443b0: 0a0a 2020 2055 7369 6e67 2027 6772 7562 .. Using 'grub │ │ │ │ │ -000443c0: 2d6d 6f75 6e74 2720 6973 206e 6f72 6d61 -mount' is norma │ │ │ │ │ -000443d0: 6c6c 7920 6173 2073 696d 706c 6520 6173 lly as simple as │ │ │ │ │ -000443e0: 3a0a 0a20 2020 2020 6772 7562 2d6d 6f75 :.. grub-mou │ │ │ │ │ -000443f0: 6e74 202f 6465 762f 7364 6131 202f 6d6e nt /dev/sda1 /mn │ │ │ │ │ -00044400: 740a 0a20 2020 2767 7275 622d 6d6f 756e t.. 'grub-moun │ │ │ │ │ -00044410: 7427 206d 7573 7420 6265 2067 6976 656e t' must be given │ │ │ │ │ -00044420: 206f 6e65 206f 7220 6d6f 7265 2069 6d61 one or more ima │ │ │ │ │ -00044430: 6765 7320 616e 6420 6120 6d6f 756e 7420 ges and a mount │ │ │ │ │ -00044440: 706f 696e 7420 6173 0a6e 6f6e 2d6f 7074 point as.non-opt │ │ │ │ │ -00044450: 696f 6e20 6172 6775 6d65 6e74 7320 2869 ion arguments (i │ │ │ │ │ -00044460: 6620 6974 2069 7320 6769 7665 6e20 6d6f f it is given mo │ │ │ │ │ -00044470: 7265 2074 6861 6e20 6f6e 6520 696d 6167 re than one imag │ │ │ │ │ -00044480: 652c 2069 7420 7769 6c6c 2074 7265 6174 e, it will treat │ │ │ │ │ -00044490: 0a74 6865 6d20 6173 2061 2052 4149 4420 .them as a RAID │ │ │ │ │ -000444a0: 7365 7429 2c20 616e 6420 616c 736f 2061 set), and also a │ │ │ │ │ -000444b0: 6363 6570 7473 2074 6865 2066 6f6c 6c6f ccepts the follo │ │ │ │ │ -000444c0: 7769 6e67 206f 7074 696f 6e73 3a0a 0a27 wing options:..' │ │ │ │ │ -000444d0: 2d2d 6865 6c70 270a 2020 2020 2050 7269 --help'. Pri │ │ │ │ │ -000444e0: 6e74 2061 2073 756d 6d61 7279 206f 6620 nt a summary of │ │ │ │ │ -000444f0: 7468 6520 636f 6d6d 616e 642d 6c69 6e65 the command-line │ │ │ │ │ -00044500: 206f 7074 696f 6e73 2061 6e64 2065 7869 options and exi │ │ │ │ │ -00044510: 742e 0a0a 272d 2d76 6572 7369 6f6e 270a t...'--version'. │ │ │ │ │ -00044520: 2020 2020 2050 7269 6e74 2074 6865 2076 Print the v │ │ │ │ │ -00044530: 6572 7369 6f6e 206e 756d 6265 7220 6f66 ersion number of │ │ │ │ │ -00044540: 2047 5255 4220 616e 6420 6578 6974 2e0a GRUB and exit.. │ │ │ │ │ -00044550: 0a27 2d43 270a 272d 2d63 7279 7074 6f27 .'-C'.'--crypto' │ │ │ │ │ -00044560: 0a20 2020 2020 4d6f 756e 7420 656e 6372 . Mount encr │ │ │ │ │ -00044570: 7970 7465 6420 6465 7669 6365 732c 2070 ypted devices, p │ │ │ │ │ -00044580: 726f 6d70 7469 6e67 2066 6f72 2061 2070 rompting for a p │ │ │ │ │ -00044590: 6173 7370 6872 6173 6520 6966 206e 6563 assphrase if nec │ │ │ │ │ -000445a0: 6573 7361 7279 2e0a 0a27 2d64 2053 5452 essary...'-d STR │ │ │ │ │ -000445b0: 494e 4727 0a27 2d2d 6465 6275 673d 5354 ING'.'--debug=ST │ │ │ │ │ -000445c0: 5249 4e47 270a 2020 2020 2053 686f 7720 RING'. Show │ │ │ │ │ -000445d0: 6465 6275 6767 696e 6720 6f75 7470 7574 debugging output │ │ │ │ │ -000445e0: 2066 6f72 2063 6f6e 6469 7469 6f6e 7320 for conditions │ │ │ │ │ -000445f0: 6d61 7463 6869 6e67 2053 5452 494e 472e matching STRING. │ │ │ │ │ -00044600: 0a0a 272d 4b20 7072 6f6d 7074 7c46 494c ..'-K prompt|FIL │ │ │ │ │ -00044610: 4527 0a27 2d2d 7a66 732d 6b65 793d 7072 E'.'--zfs-key=pr │ │ │ │ │ -00044620: 6f6d 7074 7c46 494c 4527 0a20 2020 2020 ompt|FILE'. │ │ │ │ │ -00044630: 4c6f 6164 2061 205a 4653 2065 6e63 7279 Load a ZFS encry │ │ │ │ │ -00044640: 7074 696f 6e20 6b65 792e 2020 4966 2079 ption key. If y │ │ │ │ │ -00044650: 6f75 2075 7365 2027 7072 6f6d 7074 2720 ou use 'prompt' │ │ │ │ │ -00044660: 6173 2074 6865 2061 7267 756d 656e 742c as the argument, │ │ │ │ │ -00044670: 0a20 2020 2020 2767 7275 622d 6d6f 756e . 'grub-moun │ │ │ │ │ -00044680: 7427 2077 696c 6c20 7265 6164 2061 2070 t' will read a p │ │ │ │ │ -00044690: 6173 7370 6872 6173 6520 6672 6f6d 2074 assphrase from t │ │ │ │ │ -000446a0: 6865 2074 6572 6d69 6e61 6c3b 206f 7468 he terminal; oth │ │ │ │ │ -000446b0: 6572 7769 7365 2c0a 2020 2020 2069 7420 erwise,. it │ │ │ │ │ -000446c0: 7769 6c6c 2072 6561 6420 6b65 7920 6d61 will read key ma │ │ │ │ │ -000446d0: 7465 7269 616c 2066 726f 6d20 7468 6520 terial from the │ │ │ │ │ -000446e0: 7370 6563 6966 6965 6420 6669 6c65 2e0a specified file.. │ │ │ │ │ -000446f0: 0a27 2d72 2044 4556 4943 4527 0a27 2d2d .'-r DEVICE'.'-- │ │ │ │ │ -00044700: 726f 6f74 3d44 4556 4943 4527 0a20 2020 root=DEVICE'. │ │ │ │ │ -00044710: 2020 5365 7420 7468 6520 4752 5542 2072 Set the GRUB r │ │ │ │ │ -00044720: 6f6f 7420 6465 7669 6365 2074 6f20 4445 oot device to DE │ │ │ │ │ -00044730: 5649 4345 2e20 2059 6f75 2064 6f20 6e6f VICE. You do no │ │ │ │ │ -00044740: 7420 6e6f 726d 616c 6c79 206e 6565 6420 t normally need │ │ │ │ │ -00044750: 746f 0a20 2020 2020 7365 7420 7468 6973 to. set this │ │ │ │ │ -00044760: 3b20 2767 7275 622d 6d6f 756e 7427 2077 ; 'grub-mount' w │ │ │ │ │ -00044770: 696c 6c20 6175 746f 6d61 7469 6361 6c6c ill automaticall │ │ │ │ │ -00044780: 7920 7365 7420 7468 6520 726f 6f74 2064 y set the root d │ │ │ │ │ -00044790: 6576 6963 6520 746f 0a20 2020 2020 7468 evice to. th │ │ │ │ │ -000447a0: 6520 726f 6f74 206f 6620 7468 6520 7375 e root of the su │ │ │ │ │ -000447b0: 7070 6c69 6564 2066 696c 6520 7379 7374 pplied file syst │ │ │ │ │ -000447c0: 656d 2e0a 0a20 2020 2020 4966 2044 4556 em... If DEV │ │ │ │ │ -000447d0: 4943 4520 6973 206a 7573 7420 6120 6e75 ICE is just a nu │ │ │ │ │ -000447e0: 6d62 6572 2c20 7468 656e 2069 7420 7769 mber, then it wi │ │ │ │ │ -000447f0: 6c6c 2062 6520 7472 6561 7465 6420 6173 ll be treated as │ │ │ │ │ -00044800: 2061 2070 6172 7469 7469 6f6e 0a20 2020 a partition. │ │ │ │ │ -00044810: 2020 6e75 6d62 6572 2077 6974 6869 6e20 number within │ │ │ │ │ -00044820: 7468 6520 7375 7070 6c69 6564 2069 6d61 the supplied ima │ │ │ │ │ -00044830: 6765 2e20 2054 6869 7320 6d65 616e 7320 ge. This means │ │ │ │ │ -00044840: 7468 6174 2c20 6966 2079 6f75 2068 6176 that, if you hav │ │ │ │ │ -00044850: 6520 616e 0a20 2020 2020 696d 6167 6520 e an. image │ │ │ │ │ -00044860: 6f66 2061 6e20 656e 7469 7265 2064 6973 of an entire dis │ │ │ │ │ -00044870: 6b20 696e 2027 6469 736b 2e69 6d67 272c k in 'disk.img', │ │ │ │ │ -00044880: 2074 6865 6e20 796f 7520 6361 6e20 7573 then you can us │ │ │ │ │ -00044890: 6520 7468 6973 0a20 2020 2020 636f 6d6d e this. comm │ │ │ │ │ -000448a0: 616e 6420 746f 206d 6f75 6e74 2069 7473 and to mount its │ │ │ │ │ -000448b0: 2073 6563 6f6e 6420 7061 7274 6974 696f second partitio │ │ │ │ │ -000448c0: 6e3a 0a0a 2020 2020 2020 2020 2020 6772 n:.. gr │ │ │ │ │ -000448d0: 7562 2d6d 6f75 6e74 202d 7220 3220 6469 ub-mount -r 2 di │ │ │ │ │ -000448e0: 736b 2e69 6d67 206d 6f75 6e74 2d70 6f69 sk.img mount-poi │ │ │ │ │ -000448f0: 6e74 0a0a 272d 7627 0a27 2d2d 7665 7262 nt..'-v'.'--verb │ │ │ │ │ -00044900: 6f73 6527 0a20 2020 2020 5072 696e 7420 ose'. Print │ │ │ │ │ -00044910: 7665 7262 6f73 6520 6d65 7373 6167 6573 verbose messages │ │ │ │ │ -00044920: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ -00044930: 696e 666f 2c20 204e 6f64 653a 2049 6e76 info, Node: Inv │ │ │ │ │ -00044940: 6f6b 696e 6720 6772 7562 2d70 726f 6265 oking grub-probe │ │ │ │ │ -00044950: 2c20 204e 6578 743a 2049 6e76 6f6b 696e , Next: Invokin │ │ │ │ │ -00044960: 6720 6772 7562 2d73 6372 6970 742d 6368 g grub-script-ch │ │ │ │ │ -00044970: 6563 6b2c 2020 5072 6576 3a20 496e 766f eck, Prev: Invo │ │ │ │ │ -00044980: 6b69 6e67 2067 7275 622d 6d6f 756e 742c king grub-mount, │ │ │ │ │ -00044990: 2020 5570 3a20 546f 700a 0a32 3920 496e Up: Top..29 In │ │ │ │ │ -000449a0: 766f 6b69 6e67 2067 7275 622d 7072 6f62 voking grub-prob │ │ │ │ │ -000449b0: 650a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a e.************** │ │ │ │ │ -000449c0: 2a2a 2a2a 2a2a 2a2a 0a0a 5468 6520 7072 ********..The pr │ │ │ │ │ -000449d0: 6f67 7261 6d20 2767 7275 622d 7072 6f62 ogram 'grub-prob │ │ │ │ │ -000449e0: 6527 2070 726f 6265 7320 6465 7669 6365 e' probes device │ │ │ │ │ -000449f0: 2069 6e66 6f72 6d61 7469 6f6e 2066 6f72 information for │ │ │ │ │ -00044a00: 2061 2067 6976 656e 2070 6174 6820 6f72 a given path or │ │ │ │ │ -00044a10: 0a64 6576 6963 652e 0a0a 2020 2020 2067 .device... g │ │ │ │ │ -00044a20: 7275 622d 7072 6f62 6520 2d2d 7461 7267 rub-probe --targ │ │ │ │ │ -00044a30: 6574 3d66 7320 2f62 6f6f 742f 6772 7562 et=fs /boot/grub │ │ │ │ │ -00044a40: 0a20 2020 2020 6772 7562 2d70 726f 6265 . grub-probe │ │ │ │ │ -00044a50: 202d 2d74 6172 6765 743d 6472 6976 6520 --target=drive │ │ │ │ │ -00044a60: 2d2d 6465 7669 6365 202f 6465 762f 7364 --device /dev/sd │ │ │ │ │ -00044a70: 6131 0a0a 2020 2027 6772 7562 2d70 726f a1.. 'grub-pro │ │ │ │ │ -00044a80: 6265 2720 6d75 7374 2062 6520 6769 7665 be' must be give │ │ │ │ │ -00044a90: 6e20 6120 7061 7468 206f 7220 6465 7669 n a path or devi │ │ │ │ │ -00044aa0: 6365 2061 7320 6120 6e6f 6e2d 6f70 7469 ce as a non-opti │ │ │ │ │ -00044ab0: 6f6e 2061 7267 756d 656e 742c 0a61 6e64 on argument,.and │ │ │ │ │ -00044ac0: 2061 6c73 6f20 6163 6365 7074 7320 7468 also accepts th │ │ │ │ │ -00044ad0: 6520 666f 6c6c 6f77 696e 6720 6f70 7469 e following opti │ │ │ │ │ -00044ae0: 6f6e 733a 0a0a 272d 2d68 656c 7027 0a20 ons:..'--help'. │ │ │ │ │ -00044af0: 2020 2020 5072 696e 7420 6120 7375 6d6d Print a summ │ │ │ │ │ -00044b00: 6172 7920 6f66 2074 6865 2063 6f6d 6d61 ary of the comma │ │ │ │ │ -00044b10: 6e64 2d6c 696e 6520 6f70 7469 6f6e 7320 nd-line options │ │ │ │ │ -00044b20: 616e 6420 6578 6974 2e0a 0a27 2d2d 7665 and exit...'--ve │ │ │ │ │ -00044b30: 7273 696f 6e27 0a20 2020 2020 5072 696e rsion'. Prin │ │ │ │ │ -00044b40: 7420 7468 6520 7665 7273 696f 6e20 6e75 t the version nu │ │ │ │ │ -00044b50: 6d62 6572 206f 6620 4752 5542 2061 6e64 mber of GRUB and │ │ │ │ │ -00044b60: 2065 7869 742e 0a0a 272d 6427 0a27 2d2d exit...'-d'.'-- │ │ │ │ │ -00044b70: 6465 7669 6365 270a 2020 2020 2049 6620 device'. If │ │ │ │ │ -00044b80: 7468 6973 206f 7074 696f 6e20 6973 2067 this option is g │ │ │ │ │ -00044b90: 6976 656e 2c20 7468 656e 2074 6865 206e iven, then the n │ │ │ │ │ -00044ba0: 6f6e 2d6f 7074 696f 6e20 6172 6775 6d65 on-option argume │ │ │ │ │ -00044bb0: 6e74 2069 7320 6120 7379 7374 656d 0a20 nt is a system. │ │ │ │ │ -00044bc0: 2020 2020 6465 7669 6365 206e 616d 6520 device name │ │ │ │ │ -00044bd0: 2873 7563 6820 6173 2027 2f64 6576 2f73 (such as '/dev/s │ │ │ │ │ -00044be0: 6461 3127 292c 2061 6e64 2027 6772 7562 da1'), and 'grub │ │ │ │ │ -00044bf0: 2d70 726f 6265 2720 7769 6c6c 2070 7269 -probe' will pri │ │ │ │ │ -00044c00: 6e74 0a20 2020 2020 696e 666f 726d 6174 nt. informat │ │ │ │ │ -00044c10: 696f 6e20 6162 6f75 7420 7468 6174 2064 ion about that d │ │ │ │ │ -00044c20: 6576 6963 652e 2020 4966 2069 7420 6973 evice. If it is │ │ │ │ │ -00044c30: 206e 6f74 2067 6976 656e 2c20 7468 656e not given, then │ │ │ │ │ -00044c40: 2074 6865 0a20 2020 2020 6e6f 6e2d 6f70 the. non-op │ │ │ │ │ -00044c50: 7469 6f6e 2061 7267 756d 656e 7420 6973 tion argument is │ │ │ │ │ -00044c60: 2061 2066 696c 6573 7973 7465 6d20 7061 a filesystem pa │ │ │ │ │ -00044c70: 7468 2028 7375 6368 2061 7320 272f 626f th (such as '/bo │ │ │ │ │ -00044c80: 6f74 2f67 7275 6227 292c 0a20 2020 2020 ot/grub'),. │ │ │ │ │ -00044c90: 616e 6420 2767 7275 622d 7072 6f62 6527 and 'grub-probe' │ │ │ │ │ -00044ca0: 2077 696c 6c20 7072 696e 7420 696e 666f will print info │ │ │ │ │ -00044cb0: 726d 6174 696f 6e20 6162 6f75 7420 7468 rmation about th │ │ │ │ │ -00044cc0: 6520 6465 7669 6365 2063 6f6e 7461 696e e device contain │ │ │ │ │ -00044cd0: 696e 670a 2020 2020 2074 6861 7420 7061 ing. that pa │ │ │ │ │ -00044ce0: 7274 206f 6620 7468 6520 6669 6c65 7379 rt of the filesy │ │ │ │ │ -00044cf0: 7374 656d 2e0a 0a27 2d6d 2046 494c 4527 stem...'-m FILE' │ │ │ │ │ -00044d00: 0a27 2d2d 6465 7669 6365 2d6d 6170 3d46 .'--device-map=F │ │ │ │ │ -00044d10: 494c 4527 0a20 2020 2020 5573 6520 4649 ILE'. Use FI │ │ │ │ │ -00044d20: 4c45 2061 7320 7468 6520 6465 7669 6365 LE as the device │ │ │ │ │ -00044d30: 206d 6170 2028 2a6e 6f74 6520 4465 7669 map (*note Devi │ │ │ │ │ -00044d40: 6365 206d 6170 3a3a 2920 7261 7468 6572 ce map::) rather │ │ │ │ │ -00044d50: 2074 6861 6e20 7468 650a 2020 2020 2064 than the. d │ │ │ │ │ -00044d60: 6566 6175 6c74 2c20 7573 7561 6c6c 7920 efault, usually │ │ │ │ │ -00044d70: 272f 626f 6f74 2f67 7275 622f 6465 7669 '/boot/grub/devi │ │ │ │ │ -00044d80: 6365 2e6d 6170 272e 0a0a 272d 7420 5441 ce.map'...'-t TA │ │ │ │ │ -00044d90: 5247 4554 270a 272d 2d74 6172 6765 743d RGET'.'--target= │ │ │ │ │ -00044da0: 5441 5247 4554 270a 2020 2020 2050 7269 TARGET'. Pri │ │ │ │ │ -00044db0: 6e74 2069 6e66 6f72 6d61 7469 6f6e 2061 nt information a │ │ │ │ │ -00044dc0: 626f 7574 2074 6865 2067 6976 656e 2070 bout the given p │ │ │ │ │ -00044dd0: 6174 6820 6f72 2064 6576 6963 6520 6173 ath or device as │ │ │ │ │ -00044de0: 2064 6566 696e 6564 2062 790a 2020 2020 defined by. │ │ │ │ │ -00044df0: 2054 4152 4745 542e 2020 5468 6520 6176 TARGET. The av │ │ │ │ │ -00044e00: 6169 6c61 626c 6520 7461 7267 6574 7320 ailable targets │ │ │ │ │ -00044e10: 616e 6420 7468 6569 7220 6d65 616e 696e and their meanin │ │ │ │ │ -00044e20: 6773 2061 7265 3a0a 0a20 2020 2020 2766 gs are:.. 'f │ │ │ │ │ -00044e30: 7327 0a20 2020 2020 2020 2020 2047 5255 s'. GRU │ │ │ │ │ -00044e40: 4220 6669 6c65 7379 7374 656d 206d 6f64 B filesystem mod │ │ │ │ │ -00044e50: 756c 652e 0a20 2020 2020 2766 735f 7575 ule.. 'fs_uu │ │ │ │ │ -00044e60: 6964 270a 2020 2020 2020 2020 2020 4669 id'. Fi │ │ │ │ │ -00044e70: 6c65 7379 7374 656d 2055 6e69 7665 7273 lesystem Univers │ │ │ │ │ -00044e80: 616c 6c79 2055 6e69 7175 6520 4964 656e ally Unique Iden │ │ │ │ │ -00044e90: 7469 6669 6572 2028 5555 4944 292e 0a20 tifier (UUID).. │ │ │ │ │ -00044ea0: 2020 2020 2766 735f 6c61 6265 6c27 0a20 'fs_label'. │ │ │ │ │ -00044eb0: 2020 2020 2020 2020 2046 696c 6573 7973 Filesys │ │ │ │ │ -00044ec0: 7465 6d20 6c61 6265 6c2e 0a20 2020 2020 tem label.. │ │ │ │ │ -00044ed0: 2764 7269 7665 270a 2020 2020 2020 2020 'drive'. │ │ │ │ │ -00044ee0: 2020 4752 5542 2064 6576 6963 6520 6e61 GRUB device na │ │ │ │ │ -00044ef0: 6d65 2e0a 2020 2020 2027 6465 7669 6365 me.. 'device │ │ │ │ │ -00044f00: 270a 2020 2020 2020 2020 2020 5379 7374 '. Syst │ │ │ │ │ -00044f10: 656d 2064 6576 6963 6520 6e61 6d65 2e0a em device name.. │ │ │ │ │ -00044f20: 2020 2020 2027 7061 7274 6d61 7027 0a20 'partmap'. │ │ │ │ │ -00044f30: 2020 2020 2020 2020 2047 5255 4220 7061 GRUB pa │ │ │ │ │ -00044f40: 7274 6974 696f 6e20 6d61 7020 6d6f 6475 rtition map modu │ │ │ │ │ -00044f50: 6c65 2e0a 2020 2020 2027 6162 7374 7261 le.. 'abstra │ │ │ │ │ -00044f60: 6374 696f 6e27 0a20 2020 2020 2020 2020 ction'. │ │ │ │ │ -00044f70: 2047 5255 4220 6162 7374 7261 6374 696f GRUB abstractio │ │ │ │ │ -00044f80: 6e20 6d6f 6475 6c65 2028 652e 672e 2020 n module (e.g. │ │ │ │ │ -00044f90: 276c 766d 2729 2e0a 2020 2020 2027 6372 'lvm').. 'cr │ │ │ │ │ -00044fa0: 7970 746f 6469 736b 5f75 7569 6427 0a20 yptodisk_uuid'. │ │ │ │ │ -00044fb0: 2020 2020 2020 2020 2043 7279 7074 6f20 Crypto │ │ │ │ │ -00044fc0: 6465 7669 6365 2055 5549 442e 0a20 2020 device UUID.. │ │ │ │ │ -00044fd0: 2020 276d 7364 6f73 5f70 6172 7474 7970 'msdos_parttyp │ │ │ │ │ -00044fe0: 6527 0a20 2020 2020 2020 2020 204d 4252 e'. MBR │ │ │ │ │ -00044ff0: 2070 6172 7469 7469 6f6e 2074 7970 6520 partition type │ │ │ │ │ -00045000: 636f 6465 2028 7477 6f20 6865 7861 6465 code (two hexade │ │ │ │ │ -00045010: 6369 6d61 6c20 6469 6769 7473 292e 0a20 cimal digits).. │ │ │ │ │ -00045020: 2020 2020 2768 696e 7473 5f73 7472 696e 'hints_strin │ │ │ │ │ -00045030: 6727 0a20 2020 2020 2020 2020 2041 2073 g'. A s │ │ │ │ │ -00045040: 7472 696e 6720 6f66 2070 6c61 7466 6f72 tring of platfor │ │ │ │ │ -00045050: 6d20 7365 6172 6368 2068 696e 7473 2073 m search hints s │ │ │ │ │ -00045060: 7569 7461 626c 6520 666f 7220 7061 7373 uitable for pass │ │ │ │ │ -00045070: 696e 6720 746f 2074 6865 0a20 2020 2020 ing to the. │ │ │ │ │ -00045080: 2020 2020 2027 7365 6172 6368 2720 636f 'search' co │ │ │ │ │ -00045090: 6d6d 616e 6420 282a 6e6f 7465 2073 6561 mmand (*note sea │ │ │ │ │ -000450a0: 7263 683a 3a29 2e0a 2020 2020 2027 6269 rch::).. 'bi │ │ │ │ │ -000450b0: 6f73 5f68 696e 7473 270a 2020 2020 2020 os_hints'. │ │ │ │ │ -000450c0: 2020 2020 5365 6172 6368 2068 696e 7473 Search hints │ │ │ │ │ -000450d0: 2066 6f72 2074 6865 2050 4320 4249 4f53 for the PC BIOS │ │ │ │ │ -000450e0: 2070 6c61 7466 6f72 6d2e 0a20 2020 2020 platform.. │ │ │ │ │ -000450f0: 2769 6565 6531 3237 355f 6869 6e74 7327 'ieee1275_hints' │ │ │ │ │ -00045100: 0a20 2020 2020 2020 2020 2053 6561 7263 . Searc │ │ │ │ │ -00045110: 6820 6869 6e74 7320 666f 7220 7468 6520 h hints for the │ │ │ │ │ -00045120: 4945 4545 3132 3735 2070 6c61 7466 6f72 IEEE1275 platfor │ │ │ │ │ -00045130: 6d2e 0a20 2020 2020 2762 6172 656d 6574 m.. 'baremet │ │ │ │ │ -00045140: 616c 5f68 696e 7473 270a 2020 2020 2020 al_hints'. │ │ │ │ │ -00045150: 2020 2020 5365 6172 6368 2068 696e 7473 Search hints │ │ │ │ │ -00045160: 2066 6f72 2070 6c61 7466 6f72 6d73 2077 for platforms w │ │ │ │ │ -00045170: 6865 7265 2064 6973 6b73 2061 7265 2061 here disks are a │ │ │ │ │ -00045180: 6464 7265 7373 6564 2064 6972 6563 746c ddressed directl │ │ │ │ │ -00045190: 790a 2020 2020 2020 2020 2020 7261 7468 y. rath │ │ │ │ │ -000451a0: 6572 2074 6861 6e20 7669 6120 6669 726d er than via firm │ │ │ │ │ -000451b0: 7761 7265 2e0a 2020 2020 2027 6566 695f ware.. 'efi_ │ │ │ │ │ -000451c0: 6869 6e74 7327 0a20 2020 2020 2020 2020 hints'. │ │ │ │ │ -000451d0: 2053 6561 7263 6820 6869 6e74 7320 666f Search hints fo │ │ │ │ │ -000451e0: 7220 7468 6520 4546 4920 706c 6174 666f r the EFI platfo │ │ │ │ │ -000451f0: 726d 2e0a 2020 2020 2027 6172 635f 6869 rm.. 'arc_hi │ │ │ │ │ -00045200: 6e74 7327 0a20 2020 2020 2020 2020 2053 nts'. S │ │ │ │ │ -00045210: 6561 7263 6820 6869 6e74 7320 666f 7220 earch hints for │ │ │ │ │ -00045220: 7468 6520 4152 4320 706c 6174 666f 726d the ARC platform │ │ │ │ │ -00045230: 2e0a 2020 2020 2027 636f 6d70 6174 6962 .. 'compatib │ │ │ │ │ -00045240: 696c 6974 795f 6869 6e74 270a 2020 2020 ility_hint'. │ │ │ │ │ -00045250: 2020 2020 2020 4120 6775 6573 7320 6174 A guess at │ │ │ │ │ -00045260: 2061 2072 6561 736f 6e61 626c 6520 4752 a reasonable GR │ │ │ │ │ -00045270: 5542 2064 7269 7665 206e 616d 6520 666f UB drive name fo │ │ │ │ │ -00045280: 7220 7468 6973 2064 6576 6963 652c 2077 r this device, w │ │ │ │ │ -00045290: 6869 6368 0a20 2020 2020 2020 2020 206d hich. m │ │ │ │ │ -000452a0: 6179 2062 6520 7573 6564 2061 7320 6120 ay be used as a │ │ │ │ │ -000452b0: 6661 6c6c 6261 636b 2069 6620 7468 6520 fallback if the │ │ │ │ │ -000452c0: 2773 6561 7263 6827 2063 6f6d 6d61 6e64 'search' command │ │ │ │ │ -000452d0: 2066 6169 6c73 2e0a 2020 2020 2027 6469 fails.. 'di │ │ │ │ │ -000452e0: 736b 270a 2020 2020 2020 2020 2020 5379 sk'. Sy │ │ │ │ │ -000452f0: 7374 656d 2064 6576 6963 6520 6e61 6d65 stem device name │ │ │ │ │ -00045300: 2066 6f72 2074 6865 2077 686f 6c65 2064 for the whole d │ │ │ │ │ -00045310: 6973 6b2e 0a0a 272d 7627 0a27 2d2d 7665 isk...'-v'.'--ve │ │ │ │ │ -00045320: 7262 6f73 6527 0a20 2020 2020 5072 696e rbose'. Prin │ │ │ │ │ -00045330: 7420 7665 7262 6f73 6520 6d65 7373 6167 t verbose messag │ │ │ │ │ -00045340: 6573 2e0a 0a1f 0a46 696c 653a 2067 7275 es.....File: gru │ │ │ │ │ -00045350: 622e 696e 666f 2c20 204e 6f64 653a 2049 b.info, Node: I │ │ │ │ │ -00045360: 6e76 6f6b 696e 6720 6772 7562 2d73 6372 nvoking grub-scr │ │ │ │ │ -00045370: 6970 742d 6368 6563 6b2c 2020 4e65 7874 ipt-check, Next │ │ │ │ │ -00045380: 3a20 4f62 7461 696e 696e 6720 616e 6420 : Obtaining and │ │ │ │ │ -00045390: 4275 696c 6469 6e67 2047 5255 422c 2020 Building GRUB, │ │ │ │ │ -000453a0: 5072 6576 3a20 496e 766f 6b69 6e67 2067 Prev: Invoking g │ │ │ │ │ -000453b0: 7275 622d 7072 6f62 652c 2020 5570 3a20 rub-probe, Up: │ │ │ │ │ -000453c0: 546f 700a 0a33 3020 496e 766f 6b69 6e67 Top..30 Invoking │ │ │ │ │ -000453d0: 2067 7275 622d 7363 7269 7074 2d63 6865 grub-script-che │ │ │ │ │ -000453e0: 636b 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a ck.************* │ │ │ │ │ -000453f0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -00045400: 0a0a 5468 6520 7072 6f67 7261 6d20 2767 ..The program 'g │ │ │ │ │ -00045410: 7275 622d 7363 7269 7074 2d63 6865 636b rub-script-check │ │ │ │ │ -00045420: 2720 7461 6b65 7320 6120 4752 5542 2073 ' takes a GRUB s │ │ │ │ │ -00045430: 6372 6970 7420 6669 6c65 2028 2a6e 6f74 cript file (*not │ │ │ │ │ -00045440: 650a 5368 656c 6c2d 6c69 6b65 2073 6372 e.Shell-like scr │ │ │ │ │ -00045450: 6970 7469 6e67 3a3a 2920 616e 6420 6368 ipting::) and ch │ │ │ │ │ -00045460: 6563 6b73 2069 7420 666f 7220 7379 6e74 ecks it for synt │ │ │ │ │ -00045470: 6178 2065 7272 6f72 732c 2073 696d 696c ax errors, simil │ │ │ │ │ -00045480: 6172 2074 6f0a 636f 6d6d 616e 6473 2073 ar to.commands s │ │ │ │ │ -00045490: 7563 6820 6173 2027 7368 202d 6e27 2e20 uch as 'sh -n'. │ │ │ │ │ -000454a0: 2049 7420 6d61 7920 7461 6b65 2061 2050 It may take a P │ │ │ │ │ -000454b0: 4154 4820 6173 2061 206e 6f6e 2d6f 7074 ATH as a non-opt │ │ │ │ │ -000454c0: 696f 6e20 6172 6775 6d65 6e74 3b0a 6966 ion argument;.if │ │ │ │ │ -000454d0: 206e 6f6e 6520 6973 2073 7570 706c 6965 none is supplie │ │ │ │ │ -000454e0: 642c 2069 7420 7769 6c6c 2072 6561 6420 d, it will read │ │ │ │ │ -000454f0: 6672 6f6d 2073 7461 6e64 6172 6420 696e from standard in │ │ │ │ │ -00045500: 7075 742e 0a0a 2020 2020 2067 7275 622d put... grub- │ │ │ │ │ -00045510: 7363 7269 7074 2d63 6865 636b 202f 626f script-check /bo │ │ │ │ │ -00045520: 6f74 2f67 7275 622f 6772 7562 2e63 6667 ot/grub/grub.cfg │ │ │ │ │ -00045530: 0a0a 2020 2027 6772 7562 2d73 6372 6970 .. 'grub-scrip │ │ │ │ │ -00045540: 742d 6368 6563 6b27 2061 6363 6570 7473 t-check' accepts │ │ │ │ │ -00045550: 2074 6865 2066 6f6c 6c6f 7769 6e67 206f the following o │ │ │ │ │ -00045560: 7074 696f 6e73 3a0a 0a27 2d2d 6865 6c70 ptions:..'--help │ │ │ │ │ -00045570: 270a 2020 2020 2050 7269 6e74 2061 2073 '. Print a s │ │ │ │ │ -00045580: 756d 6d61 7279 206f 6620 7468 6520 636f ummary of the co │ │ │ │ │ -00045590: 6d6d 616e 642d 6c69 6e65 206f 7074 696f mmand-line optio │ │ │ │ │ -000455a0: 6e73 2061 6e64 2065 7869 742e 0a0a 272d ns and exit...'- │ │ │ │ │ -000455b0: 2d76 6572 7369 6f6e 270a 2020 2020 2050 -version'. P │ │ │ │ │ -000455c0: 7269 6e74 2074 6865 2076 6572 7369 6f6e rint the version │ │ │ │ │ -000455d0: 206e 756d 6265 7220 6f66 2047 5255 4220 number of GRUB │ │ │ │ │ -000455e0: 616e 6420 6578 6974 2e0a 0a27 2d76 270a and exit...'-v'. │ │ │ │ │ -000455f0: 272d 2d76 6572 626f 7365 270a 2020 2020 '--verbose'. │ │ │ │ │ -00045600: 2050 7269 6e74 2065 6163 6820 6c69 6e65 Print each line │ │ │ │ │ -00045610: 206f 6620 696e 7075 7420 6166 7465 7220 of input after │ │ │ │ │ -00045620: 7265 6164 696e 6720 6974 2e0a 0a1f 0a46 reading it.....F │ │ │ │ │ -00045630: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ -00045640: 204e 6f64 653a 204f 6274 6169 6e69 6e67 Node: Obtaining │ │ │ │ │ -00045650: 2061 6e64 2042 7569 6c64 696e 6720 4752 and Building GR │ │ │ │ │ -00045660: 5542 2c20 204e 6578 743a 2052 6570 6f72 UB, Next: Repor │ │ │ │ │ -00045670: 7469 6e67 2062 7567 732c 2020 5072 6576 ting bugs, Prev │ │ │ │ │ -00045680: 3a20 496e 766f 6b69 6e67 2067 7275 622d : Invoking grub- │ │ │ │ │ -00045690: 7363 7269 7074 2d63 6865 636b 2c20 2055 script-check, U │ │ │ │ │ -000456a0: 703a 2054 6f70 0a0a 4170 7065 6e64 6978 p: Top..Appendix │ │ │ │ │ -000456b0: 2041 2048 6f77 2074 6f20 6f62 7461 696e A How to obtain │ │ │ │ │ -000456c0: 2061 6e64 2062 7569 6c64 2047 5255 420a and build GRUB. │ │ │ │ │ +00043410: 2a2a 2a2a 2a0a 0a54 6865 2070 726f 6772 *****..The progr │ │ │ │ │ +00043420: 616d 2027 6772 7562 2d6d 6b72 656c 7061 am 'grub-mkrelpa │ │ │ │ │ +00043430: 7468 2720 6d61 6b65 7320 6120 6669 6c65 th' makes a file │ │ │ │ │ +00043440: 2073 7973 7465 6d20 7061 7468 2072 656c system path rel │ │ │ │ │ +00043450: 6174 6976 6520 746f 2074 6865 0a72 6f6f ative to the.roo │ │ │ │ │ +00043460: 7420 6f66 2069 7473 2063 6f6e 7461 696e t of its contain │ │ │ │ │ +00043470: 696e 6720 6669 6c65 2073 7973 7465 6d2e ing file system. │ │ │ │ │ +00043480: 2020 466f 7220 696e 7374 616e 6365 2c20 For instance, │ │ │ │ │ +00043490: 6966 2027 2f75 7372 2720 6973 2061 206d if '/usr' is a m │ │ │ │ │ +000434a0: 6f75 6e74 0a70 6f69 6e74 2c20 7468 656e ount.point, then │ │ │ │ │ +000434b0: 3a0a 0a20 2020 2020 2420 6772 7562 2d6d :.. $ grub-m │ │ │ │ │ +000434c0: 6b72 656c 7061 7468 202f 7573 722f 7368 krelpath /usr/sh │ │ │ │ │ +000434d0: 6172 652f 6772 7562 2f75 6e69 636f 6465 are/grub/unicode │ │ │ │ │ +000434e0: 2e70 6632 0a20 2020 2020 272f 7368 6172 .pf2. '/shar │ │ │ │ │ +000434f0: 652f 6772 7562 2f75 6e69 636f 6465 2e70 e/grub/unicode.p │ │ │ │ │ +00043500: 6632 270a 0a20 2020 5468 6973 2069 7320 f2'.. This is │ │ │ │ │ +00043510: 6d61 696e 6c79 2075 7365 6420 696e 7465 mainly used inte │ │ │ │ │ +00043520: 726e 616c 6c79 2062 7920 6f74 6865 7220 rnally by other │ │ │ │ │ +00043530: 4752 5542 2075 7469 6c69 7469 6573 2073 GRUB utilities s │ │ │ │ │ +00043540: 7563 6820 6173 0a27 6772 7562 2d6d 6b63 uch as.'grub-mkc │ │ │ │ │ +00043550: 6f6e 6669 6727 2028 2a6e 6f74 6520 496e onfig' (*note In │ │ │ │ │ +00043560: 766f 6b69 6e67 2067 7275 622d 6d6b 636f voking grub-mkco │ │ │ │ │ +00043570: 6e66 6967 3a3a 292c 2062 7574 206d 6179 nfig::), but may │ │ │ │ │ +00043580: 206f 6363 6173 696f 6e61 6c6c 790a 616c occasionally.al │ │ │ │ │ +00043590: 736f 2062 6520 7573 6566 756c 2066 6f72 so be useful for │ │ │ │ │ +000435a0: 2064 6562 7567 6769 6e67 2e0a 0a20 2020 debugging... │ │ │ │ │ +000435b0: 2767 7275 622d 6d6b 7265 6c70 6174 6827 'grub-mkrelpath' │ │ │ │ │ +000435c0: 2061 6363 6570 7473 2074 6865 2066 6f6c accepts the fol │ │ │ │ │ +000435d0: 6c6f 7769 6e67 206f 7074 696f 6e73 3a0a lowing options:. │ │ │ │ │ +000435e0: 0a27 2d2d 6865 6c70 270a 2020 2020 2050 .'--help'. P │ │ │ │ │ +000435f0: 7269 6e74 2061 2073 756d 6d61 7279 206f rint a summary o │ │ │ │ │ +00043600: 6620 7468 6520 636f 6d6d 616e 642d 6c69 f the command-li │ │ │ │ │ +00043610: 6e65 206f 7074 696f 6e73 2061 6e64 2065 ne options and e │ │ │ │ │ +00043620: 7869 742e 0a0a 272d 2d76 6572 7369 6f6e xit...'--version │ │ │ │ │ +00043630: 270a 2020 2020 2050 7269 6e74 2074 6865 '. Print the │ │ │ │ │ +00043640: 2076 6572 7369 6f6e 206e 756d 6265 7220 version number │ │ │ │ │ +00043650: 6f66 2047 5255 4220 616e 6420 6578 6974 of GRUB and exit │ │ │ │ │ +00043660: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ +00043670: 696e 666f 2c20 204e 6f64 653a 2049 6e76 info, Node: Inv │ │ │ │ │ +00043680: 6f6b 696e 6720 6772 7562 2d6d 6b72 6573 oking grub-mkres │ │ │ │ │ +00043690: 6375 652c 2020 4e65 7874 3a20 496e 766f cue, Next: Invo │ │ │ │ │ +000436a0: 6b69 6e67 2067 7275 622d 6d6f 756e 742c king grub-mount, │ │ │ │ │ +000436b0: 2020 5072 6576 3a20 496e 766f 6b69 6e67 Prev: Invoking │ │ │ │ │ +000436c0: 2067 7275 622d 6d6b 7265 6c70 6174 682c grub-mkrelpath, │ │ │ │ │ +000436d0: 2020 5570 3a20 546f 700a 0a32 3720 496e Up: Top..27 In │ │ │ │ │ +000436e0: 766f 6b69 6e67 2067 7275 622d 6d6b 7265 voking grub-mkre │ │ │ │ │ +000436f0: 7363 7565 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a scue.*********** │ │ │ │ │ +00043700: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a **************.. │ │ │ │ │ +00043710: 5468 6520 7072 6f67 7261 6d20 2767 7275 The program 'gru │ │ │ │ │ +00043720: 622d 6d6b 7265 7363 7565 2720 6765 6e65 b-mkrescue' gene │ │ │ │ │ +00043730: 7261 7465 7320 6120 626f 6f74 6162 6c65 rates a bootable │ │ │ │ │ +00043740: 2047 5255 4220 7265 7363 7565 2069 6d61 GRUB rescue ima │ │ │ │ │ +00043750: 6765 0a28 2a6e 6f74 6520 4d61 6b69 6e67 ge.(*note Making │ │ │ │ │ +00043760: 2061 2047 5255 4220 626f 6f74 6162 6c65 a GRUB bootable │ │ │ │ │ +00043770: 2043 442d 524f 4d3a 3a29 2e0a 0a20 2020 CD-ROM::)... │ │ │ │ │ +00043780: 2020 6772 7562 2d6d 6b72 6573 6375 6520 grub-mkrescue │ │ │ │ │ +00043790: 2d6f 2067 7275 622e 6973 6f0a 0a20 2020 -o grub.iso.. │ │ │ │ │ +000437a0: 416c 6c20 6172 6775 6d65 6e74 7320 6e6f All arguments no │ │ │ │ │ +000437b0: 7420 6578 706c 6963 6974 6c79 206c 6973 t explicitly lis │ │ │ │ │ +000437c0: 7465 6420 6173 2027 6772 7562 2d6d 6b72 ted as 'grub-mkr │ │ │ │ │ +000437d0: 6573 6375 6527 206f 7074 696f 6e73 2061 escue' options a │ │ │ │ │ +000437e0: 7265 0a70 6173 7365 6420 6f6e 2064 6972 re.passed on dir │ │ │ │ │ +000437f0: 6563 746c 7920 746f 2027 786f 7272 6973 ectly to 'xorris │ │ │ │ │ +00043800: 6f27 2069 6e20 276d 6b69 736f 6673 2720 o' in 'mkisofs' │ │ │ │ │ +00043810: 656d 756c 6174 696f 6e20 6d6f 6465 2e20 emulation mode. │ │ │ │ │ +00043820: 204f 7074 696f 6e73 0a70 6173 7365 6420 Options.passed │ │ │ │ │ +00043830: 746f 2027 786f 7272 6973 6f27 2077 696c to 'xorriso' wil │ │ │ │ │ +00043840: 6c20 6e6f 726d 616c 6c79 2062 6520 696e l normally be in │ │ │ │ │ +00043850: 7465 7270 7265 7465 6420 6173 2027 6d6b terpreted as 'mk │ │ │ │ │ +00043860: 6973 6f66 7327 206f 7074 696f 6e73 3b0a isofs' options;. │ │ │ │ │ +00043870: 6966 2074 6865 206f 7074 696f 6e20 272d if the option '- │ │ │ │ │ +00043880: 2d27 2069 7320 7573 6564 2c20 7468 656e -' is used, then │ │ │ │ │ +00043890: 2061 6e79 7468 696e 6720 6166 7465 7220 anything after │ │ │ │ │ +000438a0: 7468 6174 2077 696c 6c20 6265 2069 6e74 that will be int │ │ │ │ │ +000438b0: 6572 7072 6574 6564 0a61 7320 6e61 7469 erpreted.as nati │ │ │ │ │ +000438c0: 7665 2027 786f 7272 6973 6f27 206f 7074 ve 'xorriso' opt │ │ │ │ │ +000438d0: 696f 6e73 2e0a 0a20 2020 4e6f 6e2d 6f70 ions... Non-op │ │ │ │ │ +000438e0: 7469 6f6e 2061 7267 756d 656e 7473 2073 tion arguments s │ │ │ │ │ +000438f0: 7065 6369 6679 2061 6464 6974 696f 6e61 pecify additiona │ │ │ │ │ +00043900: 6c20 736f 7572 6365 2064 6972 6563 746f l source directo │ │ │ │ │ +00043910: 7269 6573 2e20 2054 6869 7320 6973 0a63 ries. This is.c │ │ │ │ │ +00043920: 6f6d 6d6f 6e6c 7920 7573 6564 2074 6f20 ommonly used to │ │ │ │ │ +00043930: 6164 6420 6578 7472 6120 6669 6c65 7320 add extra files │ │ │ │ │ +00043940: 746f 2074 6865 2069 6d61 6765 3a0a 0a20 to the image:.. │ │ │ │ │ +00043950: 2020 2020 6d6b 6469 7220 2d70 2064 6973 mkdir -p dis │ │ │ │ │ +00043960: 6b2f 626f 6f74 2f67 7275 620a 2020 2020 k/boot/grub. │ │ │ │ │ +00043970: 2028 6164 6420 6578 7472 6120 6669 6c65 (add extra file │ │ │ │ │ +00043980: 7320 746f 2027 6469 736b 2f62 6f6f 742f s to 'disk/boot/ │ │ │ │ │ +00043990: 6772 7562 2729 0a20 2020 2020 6772 7562 grub'). grub │ │ │ │ │ +000439a0: 2d6d 6b72 6573 6375 6520 2d6f 2067 7275 -mkrescue -o gru │ │ │ │ │ +000439b0: 622e 6973 6f20 6469 736b 0a0a 2020 2027 b.iso disk.. ' │ │ │ │ │ +000439c0: 6772 7562 2d6d 6b72 6573 6375 6527 2061 grub-mkrescue' a │ │ │ │ │ +000439d0: 6363 6570 7473 2074 6865 2066 6f6c 6c6f ccepts the follo │ │ │ │ │ +000439e0: 7769 6e67 206f 7074 696f 6e73 3a0a 0a27 wing options:..' │ │ │ │ │ +000439f0: 2d2d 6865 6c70 270a 2020 2020 2050 7269 --help'. Pri │ │ │ │ │ +00043a00: 6e74 2061 2073 756d 6d61 7279 206f 6620 nt a summary of │ │ │ │ │ +00043a10: 7468 6520 636f 6d6d 616e 642d 6c69 6e65 the command-line │ │ │ │ │ +00043a20: 206f 7074 696f 6e73 2061 6e64 2065 7869 options and exi │ │ │ │ │ +00043a30: 742e 0a0a 272d 2d76 6572 7369 6f6e 270a t...'--version'. │ │ │ │ │ +00043a40: 2020 2020 2050 7269 6e74 2074 6865 2076 Print the v │ │ │ │ │ +00043a50: 6572 7369 6f6e 206e 756d 6265 7220 6f66 ersion number of │ │ │ │ │ +00043a60: 2047 5255 4220 616e 6420 6578 6974 2e0a GRUB and exit.. │ │ │ │ │ +00043a70: 0a27 2d6f 2046 494c 4527 0a27 2d2d 6f75 .'-o FILE'.'--ou │ │ │ │ │ +00043a80: 7470 7574 3d46 494c 4527 0a20 2020 2020 tput=FILE'. │ │ │ │ │ +00043a90: 5361 7665 206f 7574 7075 7420 696e 2046 Save output in F │ │ │ │ │ +00043aa0: 494c 452e 2020 5468 6973 2022 6f70 7469 ILE. This "opti │ │ │ │ │ +00043ab0: 6f6e 2220 6973 2072 6571 7569 7265 642e on" is required. │ │ │ │ │ +00043ac0: 0a0a 272d 2d6d 6f64 756c 6573 3d4d 4f44 ..'--modules=MOD │ │ │ │ │ +00043ad0: 554c 4553 270a 2020 2020 2050 7265 2d6c ULES'. Pre-l │ │ │ │ │ +00043ae0: 6f61 6420 7468 6520 6e61 6d65 6420 4752 oad the named GR │ │ │ │ │ +00043af0: 5542 206d 6f64 756c 6573 2069 6e20 7468 UB modules in th │ │ │ │ │ +00043b00: 6520 696d 6167 652e 2020 4d75 6c74 6970 e image. Multip │ │ │ │ │ +00043b10: 6c65 2065 6e74 7269 6573 2069 6e0a 2020 le entries in. │ │ │ │ │ +00043b20: 2020 204d 4f44 554c 4553 2073 686f 756c MODULES shoul │ │ │ │ │ +00043b30: 6420 6265 2073 6570 6172 6174 6564 2062 d be separated b │ │ │ │ │ +00043b40: 7920 7768 6974 6573 7061 6365 2028 736f y whitespace (so │ │ │ │ │ +00043b50: 2079 6f75 2077 696c 6c20 7072 6f62 6162 you will probab │ │ │ │ │ +00043b60: 6c79 0a20 2020 2020 6e65 6564 2074 6f20 ly. need to │ │ │ │ │ +00043b70: 7175 6f74 6520 7468 6973 2066 6f72 2079 quote this for y │ │ │ │ │ +00043b80: 6f75 7220 7368 656c 6c29 2e0a 0a27 2d2d our shell)...'-- │ │ │ │ │ +00043b90: 726f 6d2d 6469 7265 6374 6f72 793d 4449 rom-directory=DI │ │ │ │ │ +00043ba0: 5227 0a20 2020 2020 4966 2067 656e 6572 R'. If gener │ │ │ │ │ +00043bb0: 6174 696e 6720 696d 6167 6573 2066 6f72 ating images for │ │ │ │ │ +00043bc0: 2074 6865 2051 454d 5520 6f72 2043 6f72 the QEMU or Cor │ │ │ │ │ +00043bd0: 6562 6f6f 7420 706c 6174 666f 726d 732c eboot platforms, │ │ │ │ │ +00043be0: 2063 6f70 7920 7468 650a 2020 2020 2072 copy the. r │ │ │ │ │ +00043bf0: 6573 756c 7469 6e67 2027 7165 6d75 2e69 esulting 'qemu.i │ │ │ │ │ +00043c00: 6d67 2720 6f72 2027 636f 7265 626f 6f74 mg' or 'coreboot │ │ │ │ │ +00043c10: 2e65 6c66 2720 6669 6c65 7320 7265 7370 .elf' files resp │ │ │ │ │ +00043c20: 6563 7469 7665 6c79 2074 6f20 7468 650a ectively to the. │ │ │ │ │ +00043c30: 2020 2020 2044 4952 2064 6972 6563 746f DIR directo │ │ │ │ │ +00043c40: 7279 2061 7320 7765 6c6c 2061 7320 696e ry as well as in │ │ │ │ │ +00043c50: 636c 7564 696e 6720 7468 656d 2069 6e20 cluding them in │ │ │ │ │ +00043c60: 7468 6520 696d 6167 652e 0a0a 272d 2d78 the image...'--x │ │ │ │ │ +00043c70: 6f72 7269 736f 3d46 494c 4527 0a20 2020 orriso=FILE'. │ │ │ │ │ +00043c80: 2020 5573 6520 4649 4c45 2061 7320 7468 Use FILE as th │ │ │ │ │ +00043c90: 6520 2778 6f72 7269 736f 2720 7072 6f67 e 'xorriso' prog │ │ │ │ │ +00043ca0: 7261 6d2c 2072 6174 6865 7220 7468 616e ram, rather than │ │ │ │ │ +00043cb0: 2074 6865 2062 7569 6c74 2d69 6e0a 2020 the built-in. │ │ │ │ │ +00043cc0: 2020 2064 6566 6175 6c74 2e0a 0a27 2d2d default...'-- │ │ │ │ │ +00043cd0: 6772 7562 2d6d 6b69 6d61 6765 3d46 494c grub-mkimage=FIL │ │ │ │ │ +00043ce0: 4527 0a20 2020 2020 5573 6520 4649 4c45 E'. Use FILE │ │ │ │ │ +00043cf0: 2061 7320 7468 6520 2767 7275 622d 6d6b as the 'grub-mk │ │ │ │ │ +00043d00: 696d 6167 6527 2070 726f 6772 616d 2c20 image' program, │ │ │ │ │ +00043d10: 7261 7468 6572 2074 6861 6e20 7468 6520 rather than the │ │ │ │ │ +00043d20: 6275 696c 742d 696e 0a20 2020 2020 6465 built-in. de │ │ │ │ │ +00043d30: 6661 756c 742e 0a0a 1f0a 4669 6c65 3a20 fault.....File: │ │ │ │ │ +00043d40: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ +00043d50: 3a20 496e 766f 6b69 6e67 2067 7275 622d : Invoking grub- │ │ │ │ │ +00043d60: 6d6f 756e 742c 2020 4e65 7874 3a20 496e mount, Next: In │ │ │ │ │ +00043d70: 766f 6b69 6e67 2067 7275 622d 7072 6f62 voking grub-prob │ │ │ │ │ +00043d80: 652c 2020 5072 6576 3a20 496e 766f 6b69 e, Prev: Invoki │ │ │ │ │ +00043d90: 6e67 2067 7275 622d 6d6b 7265 7363 7565 ng grub-mkrescue │ │ │ │ │ +00043da0: 2c20 2055 703a 2054 6f70 0a0a 3238 2049 , Up: Top..28 I │ │ │ │ │ +00043db0: 6e76 6f6b 696e 6720 6772 7562 2d6d 6f75 nvoking grub-mou │ │ │ │ │ +00043dc0: 6e74 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a nt.************* │ │ │ │ │ +00043dd0: 2a2a 2a2a 2a2a 2a2a 2a0a 0a54 6865 2070 *********..The p │ │ │ │ │ +00043de0: 726f 6772 616d 2027 6772 7562 2d6d 6f75 rogram 'grub-mou │ │ │ │ │ +00043df0: 6e74 2720 7065 7266 6f72 6d73 2061 2072 nt' performs a r │ │ │ │ │ +00043e00: 6561 642d 6f6e 6c79 206d 6f75 6e74 206f ead-only mount o │ │ │ │ │ +00043e10: 6620 616e 7920 6669 6c65 2073 7973 7465 f any file syste │ │ │ │ │ +00043e20: 6d0a 6f72 2066 696c 6520 7379 7374 656d m.or file system │ │ │ │ │ +00043e30: 2069 6d61 6765 2074 6861 7420 4752 5542 image that GRUB │ │ │ │ │ +00043e40: 2075 6e64 6572 7374 616e 6473 2c20 7573 understands, us │ │ │ │ │ +00043e50: 696e 6720 4752 5542 2773 2066 696c 6520 ing GRUB's file │ │ │ │ │ +00043e60: 7379 7374 656d 0a64 7269 7665 7273 2076 system.drivers v │ │ │ │ │ +00043e70: 6961 2046 5553 452e 2028 4974 2069 7320 ia FUSE. (It is │ │ │ │ │ +00043e80: 6f6e 6c79 2061 7661 696c 6162 6c65 2069 only available i │ │ │ │ │ +00043e90: 6620 4655 5345 2064 6576 656c 6f70 6d65 f FUSE developme │ │ │ │ │ +00043ea0: 6e74 2066 696c 6573 2077 6572 650a 7072 nt files were.pr │ │ │ │ │ +00043eb0: 6573 656e 7420 7768 656e 2047 5255 4220 esent when GRUB │ │ │ │ │ +00043ec0: 7761 7320 6275 696c 742e 2920 2054 6869 was built.) Thi │ │ │ │ │ +00043ed0: 7320 6861 7320 6120 6e75 6d62 6572 206f s has a number o │ │ │ │ │ +00043ee0: 6620 7573 6573 3a0a 0a20 2020 2a20 4974 f uses:.. * It │ │ │ │ │ +00043ef0: 2070 726f 7669 6465 7320 6120 636f 6e76 provides a conv │ │ │ │ │ +00043f00: 656e 6965 6e74 2077 6179 2074 6f20 6368 enient way to ch │ │ │ │ │ +00043f10: 6563 6b20 686f 7720 4752 5542 2077 696c eck how GRUB wil │ │ │ │ │ +00043f20: 6c20 7669 6577 2061 2066 696c 650a 2020 l view a file. │ │ │ │ │ +00043f30: 2020 2073 7973 7465 6d20 6174 2062 6f6f system at boo │ │ │ │ │ +00043f40: 7420 7469 6d65 2e20 2059 6f75 2063 616e t time. You can │ │ │ │ │ +00043f50: 2075 7365 206e 6f72 6d61 6c20 636f 6d6d use normal comm │ │ │ │ │ +00043f60: 616e 642d 6c69 6e65 2074 6f6f 6c73 2074 and-line tools t │ │ │ │ │ +00043f70: 6f0a 2020 2020 2063 6f6d 7061 7265 2074 o. compare t │ │ │ │ │ +00043f80: 6861 7420 7669 6577 2077 6974 6820 7468 hat view with th │ │ │ │ │ +00043f90: 6174 206f 6620 796f 7572 206f 7065 7261 at of your opera │ │ │ │ │ +00043fa0: 7469 6e67 2073 7973 7465 6d2c 206d 616b ting system, mak │ │ │ │ │ +00043fb0: 696e 6720 6974 0a20 2020 2020 6561 7379 ing it. easy │ │ │ │ │ +00043fc0: 2074 6f20 6669 6e64 2062 7567 732e 0a0a to find bugs... │ │ │ │ │ +00043fd0: 2020 202a 2049 7420 6f66 6665 7273 2074 * It offers t │ │ │ │ │ +00043fe0: 7275 6520 7265 6164 2d6f 6e6c 7920 6d6f rue read-only mo │ │ │ │ │ +00043ff0: 756e 7473 2e20 204c 696e 7578 2064 6f65 unts. Linux doe │ │ │ │ │ +00044000: 7320 6e6f 7420 6861 7665 2074 6865 7365 s not have these │ │ │ │ │ +00044010: 2066 6f72 0a20 2020 2020 6a6f 7572 6e61 for. journa │ │ │ │ │ +00044020: 6c6c 696e 6720 6669 6c65 2073 7973 7465 lling file syste │ │ │ │ │ +00044030: 6d73 2c20 6265 6361 7573 6520 6974 2077 ms, because it w │ │ │ │ │ +00044040: 696c 6c20 616c 7761 7973 2061 7474 656d ill always attem │ │ │ │ │ +00044050: 7074 2074 6f20 7265 706c 6179 0a20 2020 pt to replay. │ │ │ │ │ +00044060: 2020 7468 6520 6a6f 7572 6e61 6c20 6174 the journal at │ │ │ │ │ +00044070: 206d 6f75 6e74 2074 696d 653b 2077 6869 mount time; whi │ │ │ │ │ +00044080: 6c65 2079 6f75 2063 616e 2074 656d 706f le you can tempo │ │ │ │ │ +00044090: 7261 7269 6c79 206d 6172 6b20 7468 6520 rarily mark the │ │ │ │ │ +000440a0: 626c 6f63 6b0a 2020 2020 2064 6576 6963 block. devic │ │ │ │ │ +000440b0: 6520 7265 6164 2d6f 6e6c 7920 746f 2061 e read-only to a │ │ │ │ │ +000440c0: 766f 6964 2074 6869 732c 2074 6861 7420 void this, that │ │ │ │ │ +000440d0: 6361 7573 6573 2074 6865 206d 6f75 6e74 causes the mount │ │ │ │ │ +000440e0: 2074 6f20 6661 696c 2e0a 2020 2020 2053 to fail.. S │ │ │ │ │ +000440f0: 696e 6365 2047 5255 4220 696e 7465 6e74 ince GRUB intent │ │ │ │ │ +00044100: 696f 6e61 6c6c 7920 636f 6e74 6169 6e73 ionally contains │ │ │ │ │ +00044110: 206e 6f20 636f 6465 2066 6f72 2077 7269 no code for wri │ │ │ │ │ +00044120: 7469 6e67 2074 6f20 6669 6c65 0a20 2020 ting to file. │ │ │ │ │ +00044130: 2020 7379 7374 656d 732c 2069 7420 6361 systems, it ca │ │ │ │ │ +00044140: 6e20 6561 7369 6c79 2070 726f 7669 6465 n easily provide │ │ │ │ │ +00044150: 2061 2067 7561 7261 6e74 6565 6420 7265 a guaranteed re │ │ │ │ │ +00044160: 6164 2d6f 6e6c 7920 6d6f 756e 740a 2020 ad-only mount. │ │ │ │ │ +00044170: 2020 206d 6563 6861 6e69 736d 2e0a 0a20 mechanism... │ │ │ │ │ +00044180: 2020 2a20 4974 2061 6c6c 6f77 7320 796f * It allows yo │ │ │ │ │ +00044190: 7520 746f 2065 7861 6d69 6e65 2061 6e79 u to examine any │ │ │ │ │ +000441a0: 2066 696c 6520 7379 7374 656d 2074 6861 file system tha │ │ │ │ │ +000441b0: 7420 4752 5542 2075 6e64 6572 7374 616e t GRUB understan │ │ │ │ │ +000441c0: 6473 0a20 2020 2020 7769 7468 6f75 7420 ds. without │ │ │ │ │ +000441d0: 6e65 6564 696e 6720 746f 206c 6f61 6420 needing to load │ │ │ │ │ +000441e0: 6164 6469 7469 6f6e 616c 206d 6f64 756c additional modul │ │ │ │ │ +000441f0: 6573 2069 6e74 6f20 796f 7572 2072 756e es into your run │ │ │ │ │ +00044200: 6e69 6e67 0a20 2020 2020 6b65 726e 656c ning. kernel │ │ │ │ │ +00044210: 2c20 7768 6963 6820 6d61 7920 6265 2075 , which may be u │ │ │ │ │ +00044220: 7365 6675 6c20 696e 2063 6f6e 7374 7261 seful in constra │ │ │ │ │ +00044230: 696e 6564 2065 6e76 6972 6f6e 6d65 6e74 ined environment │ │ │ │ │ +00044240: 7320 7375 6368 2061 730a 2020 2020 2069 s such as. i │ │ │ │ │ +00044250: 6e73 7461 6c6c 6572 732e 0a0a 2020 202a nstallers... * │ │ │ │ │ +00044260: 2053 696e 6365 2069 7420 6361 6e20 6578 Since it can ex │ │ │ │ │ +00044270: 616d 696e 6520 6669 6c65 2073 7973 7465 amine file syste │ │ │ │ │ +00044280: 6d20 696d 6167 6573 2028 636f 6e74 6169 m images (contai │ │ │ │ │ +00044290: 6e65 6420 696e 2072 6567 756c 6172 0a20 ned in regular. │ │ │ │ │ +000442a0: 2020 2020 6669 6c65 7329 206a 7573 7420 files) just │ │ │ │ │ +000442b0: 6173 2065 6173 696c 7920 6173 2066 696c as easily as fil │ │ │ │ │ +000442c0: 6520 7379 7374 656d 7320 6f6e 2062 6c6f e systems on blo │ │ │ │ │ +000442d0: 636b 2064 6576 6963 6573 2c20 796f 7520 ck devices, you │ │ │ │ │ +000442e0: 6361 6e20 7573 650a 2020 2020 2069 7420 can use. it │ │ │ │ │ +000442f0: 746f 2069 6e73 7065 6374 2061 6e79 2066 to inspect any f │ │ │ │ │ +00044300: 696c 6520 7379 7374 656d 2069 6d61 6765 ile system image │ │ │ │ │ +00044310: 2074 6861 7420 4752 5542 2075 6e64 6572 that GRUB under │ │ │ │ │ +00044320: 7374 616e 6473 2077 6974 6820 6f6e 6c79 stands with only │ │ │ │ │ +00044330: 0a20 2020 2020 656e 6f75 6768 2070 7269 . enough pri │ │ │ │ │ +00044340: 7669 6c65 6765 7320 746f 2075 7365 2046 vileges to use F │ │ │ │ │ +00044350: 5553 452c 2065 7665 6e20 6966 206e 6f62 USE, even if nob │ │ │ │ │ +00044360: 6f64 7920 6861 7320 7965 7420 7772 6974 ody has yet writ │ │ │ │ │ +00044370: 7465 6e20 610a 2020 2020 2046 5553 4520 ten a. FUSE │ │ │ │ │ +00044380: 6d6f 6475 6c65 2073 7065 6369 6669 6361 module specifica │ │ │ │ │ +00044390: 6c6c 7920 666f 7220 7468 6174 2066 696c lly for that fil │ │ │ │ │ +000443a0: 6520 7379 7374 656d 2074 7970 652e 0a0a e system type... │ │ │ │ │ +000443b0: 2020 2055 7369 6e67 2027 6772 7562 2d6d Using 'grub-m │ │ │ │ │ +000443c0: 6f75 6e74 2720 6973 206e 6f72 6d61 6c6c ount' is normall │ │ │ │ │ +000443d0: 7920 6173 2073 696d 706c 6520 6173 3a0a y as simple as:. │ │ │ │ │ +000443e0: 0a20 2020 2020 6772 7562 2d6d 6f75 6e74 . grub-mount │ │ │ │ │ +000443f0: 202f 6465 762f 7364 6131 202f 6d6e 740a /dev/sda1 /mnt. │ │ │ │ │ +00044400: 0a20 2020 2767 7275 622d 6d6f 756e 7427 . 'grub-mount' │ │ │ │ │ +00044410: 206d 7573 7420 6265 2067 6976 656e 206f must be given o │ │ │ │ │ +00044420: 6e65 206f 7220 6d6f 7265 2069 6d61 6765 ne or more image │ │ │ │ │ +00044430: 7320 616e 6420 6120 6d6f 756e 7420 706f s and a mount po │ │ │ │ │ +00044440: 696e 7420 6173 0a6e 6f6e 2d6f 7074 696f int as.non-optio │ │ │ │ │ +00044450: 6e20 6172 6775 6d65 6e74 7320 2869 6620 n arguments (if │ │ │ │ │ +00044460: 6974 2069 7320 6769 7665 6e20 6d6f 7265 it is given more │ │ │ │ │ +00044470: 2074 6861 6e20 6f6e 6520 696d 6167 652c than one image, │ │ │ │ │ +00044480: 2069 7420 7769 6c6c 2074 7265 6174 0a74 it will treat.t │ │ │ │ │ +00044490: 6865 6d20 6173 2061 2052 4149 4420 7365 hem as a RAID se │ │ │ │ │ +000444a0: 7429 2c20 616e 6420 616c 736f 2061 6363 t), and also acc │ │ │ │ │ +000444b0: 6570 7473 2074 6865 2066 6f6c 6c6f 7769 epts the followi │ │ │ │ │ +000444c0: 6e67 206f 7074 696f 6e73 3a0a 0a27 2d2d ng options:..'-- │ │ │ │ │ +000444d0: 6865 6c70 270a 2020 2020 2050 7269 6e74 help'. Print │ │ │ │ │ +000444e0: 2061 2073 756d 6d61 7279 206f 6620 7468 a summary of th │ │ │ │ │ +000444f0: 6520 636f 6d6d 616e 642d 6c69 6e65 206f e command-line o │ │ │ │ │ +00044500: 7074 696f 6e73 2061 6e64 2065 7869 742e ptions and exit. │ │ │ │ │ +00044510: 0a0a 272d 2d76 6572 7369 6f6e 270a 2020 ..'--version'. │ │ │ │ │ +00044520: 2020 2050 7269 6e74 2074 6865 2076 6572 Print the ver │ │ │ │ │ +00044530: 7369 6f6e 206e 756d 6265 7220 6f66 2047 sion number of G │ │ │ │ │ +00044540: 5255 4220 616e 6420 6578 6974 2e0a 0a27 RUB and exit...' │ │ │ │ │ +00044550: 2d43 270a 272d 2d63 7279 7074 6f27 0a20 -C'.'--crypto'. │ │ │ │ │ +00044560: 2020 2020 4d6f 756e 7420 656e 6372 7970 Mount encryp │ │ │ │ │ +00044570: 7465 6420 6465 7669 6365 732c 2070 726f ted devices, pro │ │ │ │ │ +00044580: 6d70 7469 6e67 2066 6f72 2061 2070 6173 mpting for a pas │ │ │ │ │ +00044590: 7370 6872 6173 6520 6966 206e 6563 6573 sphrase if neces │ │ │ │ │ +000445a0: 7361 7279 2e0a 0a27 2d64 2053 5452 494e sary...'-d STRIN │ │ │ │ │ +000445b0: 4727 0a27 2d2d 6465 6275 673d 5354 5249 G'.'--debug=STRI │ │ │ │ │ +000445c0: 4e47 270a 2020 2020 2053 686f 7720 6465 NG'. Show de │ │ │ │ │ +000445d0: 6275 6767 696e 6720 6f75 7470 7574 2066 bugging output f │ │ │ │ │ +000445e0: 6f72 2063 6f6e 6469 7469 6f6e 7320 6d61 or conditions ma │ │ │ │ │ +000445f0: 7463 6869 6e67 2053 5452 494e 472e 0a0a tching STRING... │ │ │ │ │ +00044600: 272d 4b20 7072 6f6d 7074 7c46 494c 4527 '-K prompt|FILE' │ │ │ │ │ +00044610: 0a27 2d2d 7a66 732d 6b65 793d 7072 6f6d .'--zfs-key=prom │ │ │ │ │ +00044620: 7074 7c46 494c 4527 0a20 2020 2020 4c6f pt|FILE'. Lo │ │ │ │ │ +00044630: 6164 2061 205a 4653 2065 6e63 7279 7074 ad a ZFS encrypt │ │ │ │ │ +00044640: 696f 6e20 6b65 792e 2020 4966 2079 6f75 ion key. If you │ │ │ │ │ +00044650: 2075 7365 2027 7072 6f6d 7074 2720 6173 use 'prompt' as │ │ │ │ │ +00044660: 2074 6865 2061 7267 756d 656e 742c 0a20 the argument,. │ │ │ │ │ +00044670: 2020 2020 2767 7275 622d 6d6f 756e 7427 'grub-mount' │ │ │ │ │ +00044680: 2077 696c 6c20 7265 6164 2061 2070 6173 will read a pas │ │ │ │ │ +00044690: 7370 6872 6173 6520 6672 6f6d 2074 6865 sphrase from the │ │ │ │ │ +000446a0: 2074 6572 6d69 6e61 6c3b 206f 7468 6572 terminal; other │ │ │ │ │ +000446b0: 7769 7365 2c0a 2020 2020 2069 7420 7769 wise,. it wi │ │ │ │ │ +000446c0: 6c6c 2072 6561 6420 6b65 7920 6d61 7465 ll read key mate │ │ │ │ │ +000446d0: 7269 616c 2066 726f 6d20 7468 6520 7370 rial from the sp │ │ │ │ │ +000446e0: 6563 6966 6965 6420 6669 6c65 2e0a 0a27 ecified file...' │ │ │ │ │ +000446f0: 2d72 2044 4556 4943 4527 0a27 2d2d 726f -r DEVICE'.'--ro │ │ │ │ │ +00044700: 6f74 3d44 4556 4943 4527 0a20 2020 2020 ot=DEVICE'. │ │ │ │ │ +00044710: 5365 7420 7468 6520 4752 5542 2072 6f6f Set the GRUB roo │ │ │ │ │ +00044720: 7420 6465 7669 6365 2074 6f20 4445 5649 t device to DEVI │ │ │ │ │ +00044730: 4345 2e20 2059 6f75 2064 6f20 6e6f 7420 CE. You do not │ │ │ │ │ +00044740: 6e6f 726d 616c 6c79 206e 6565 6420 746f normally need to │ │ │ │ │ +00044750: 0a20 2020 2020 7365 7420 7468 6973 3b20 . set this; │ │ │ │ │ +00044760: 2767 7275 622d 6d6f 756e 7427 2077 696c 'grub-mount' wil │ │ │ │ │ +00044770: 6c20 6175 746f 6d61 7469 6361 6c6c 7920 l automatically │ │ │ │ │ +00044780: 7365 7420 7468 6520 726f 6f74 2064 6576 set the root dev │ │ │ │ │ +00044790: 6963 6520 746f 0a20 2020 2020 7468 6520 ice to. the │ │ │ │ │ +000447a0: 726f 6f74 206f 6620 7468 6520 7375 7070 root of the supp │ │ │ │ │ +000447b0: 6c69 6564 2066 696c 6520 7379 7374 656d lied file system │ │ │ │ │ +000447c0: 2e0a 0a20 2020 2020 4966 2044 4556 4943 ... If DEVIC │ │ │ │ │ +000447d0: 4520 6973 206a 7573 7420 6120 6e75 6d62 E is just a numb │ │ │ │ │ +000447e0: 6572 2c20 7468 656e 2069 7420 7769 6c6c er, then it will │ │ │ │ │ +000447f0: 2062 6520 7472 6561 7465 6420 6173 2061 be treated as a │ │ │ │ │ +00044800: 2070 6172 7469 7469 6f6e 0a20 2020 2020 partition. │ │ │ │ │ +00044810: 6e75 6d62 6572 2077 6974 6869 6e20 7468 number within th │ │ │ │ │ +00044820: 6520 7375 7070 6c69 6564 2069 6d61 6765 e supplied image │ │ │ │ │ +00044830: 2e20 2054 6869 7320 6d65 616e 7320 7468 . This means th │ │ │ │ │ +00044840: 6174 2c20 6966 2079 6f75 2068 6176 6520 at, if you have │ │ │ │ │ +00044850: 616e 0a20 2020 2020 696d 6167 6520 6f66 an. image of │ │ │ │ │ +00044860: 2061 6e20 656e 7469 7265 2064 6973 6b20 an entire disk │ │ │ │ │ +00044870: 696e 2027 6469 736b 2e69 6d67 272c 2074 in 'disk.img', t │ │ │ │ │ +00044880: 6865 6e20 796f 7520 6361 6e20 7573 6520 hen you can use │ │ │ │ │ +00044890: 7468 6973 0a20 2020 2020 636f 6d6d 616e this. comman │ │ │ │ │ +000448a0: 6420 746f 206d 6f75 6e74 2069 7473 2073 d to mount its s │ │ │ │ │ +000448b0: 6563 6f6e 6420 7061 7274 6974 696f 6e3a econd partition: │ │ │ │ │ +000448c0: 0a0a 2020 2020 2020 2020 2020 6772 7562 .. grub │ │ │ │ │ +000448d0: 2d6d 6f75 6e74 202d 7220 3220 6469 736b -mount -r 2 disk │ │ │ │ │ +000448e0: 2e69 6d67 206d 6f75 6e74 2d70 6f69 6e74 .img mount-point │ │ │ │ │ +000448f0: 0a0a 272d 7627 0a27 2d2d 7665 7262 6f73 ..'-v'.'--verbos │ │ │ │ │ +00044900: 6527 0a20 2020 2020 5072 696e 7420 7665 e'. Print ve │ │ │ │ │ +00044910: 7262 6f73 6520 6d65 7373 6167 6573 2e0a rbose messages.. │ │ │ │ │ +00044920: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ +00044930: 666f 2c20 204e 6f64 653a 2049 6e76 6f6b fo, Node: Invok │ │ │ │ │ +00044940: 696e 6720 6772 7562 2d70 726f 6265 2c20 ing grub-probe, │ │ │ │ │ +00044950: 204e 6578 743a 2049 6e76 6f6b 696e 6720 Next: Invoking │ │ │ │ │ +00044960: 6772 7562 2d73 6372 6970 742d 6368 6563 grub-script-chec │ │ │ │ │ +00044970: 6b2c 2020 5072 6576 3a20 496e 766f 6b69 k, Prev: Invoki │ │ │ │ │ +00044980: 6e67 2067 7275 622d 6d6f 756e 742c 2020 ng grub-mount, │ │ │ │ │ +00044990: 5570 3a20 546f 700a 0a32 3920 496e 766f Up: Top..29 Invo │ │ │ │ │ +000449a0: 6b69 6e67 2067 7275 622d 7072 6f62 650a king grub-probe. │ │ │ │ │ +000449b0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ +000449c0: 2a2a 2a2a 2a2a 0a0a 5468 6520 7072 6f67 ******..The prog │ │ │ │ │ +000449d0: 7261 6d20 2767 7275 622d 7072 6f62 6527 ram 'grub-probe' │ │ │ │ │ +000449e0: 2070 726f 6265 7320 6465 7669 6365 2069 probes device i │ │ │ │ │ +000449f0: 6e66 6f72 6d61 7469 6f6e 2066 6f72 2061 nformation for a │ │ │ │ │ +00044a00: 2067 6976 656e 2070 6174 6820 6f72 0a64 given path or.d │ │ │ │ │ +00044a10: 6576 6963 652e 0a0a 2020 2020 2067 7275 evice... gru │ │ │ │ │ +00044a20: 622d 7072 6f62 6520 2d2d 7461 7267 6574 b-probe --target │ │ │ │ │ +00044a30: 3d66 7320 2f62 6f6f 742f 6772 7562 0a20 =fs /boot/grub. │ │ │ │ │ +00044a40: 2020 2020 6772 7562 2d70 726f 6265 202d grub-probe - │ │ │ │ │ +00044a50: 2d74 6172 6765 743d 6472 6976 6520 2d2d -target=drive -- │ │ │ │ │ +00044a60: 6465 7669 6365 202f 6465 762f 7364 6131 device /dev/sda1 │ │ │ │ │ +00044a70: 0a0a 2020 2027 6772 7562 2d70 726f 6265 .. 'grub-probe │ │ │ │ │ +00044a80: 2720 6d75 7374 2062 6520 6769 7665 6e20 ' must be given │ │ │ │ │ +00044a90: 6120 7061 7468 206f 7220 6465 7669 6365 a path or device │ │ │ │ │ +00044aa0: 2061 7320 6120 6e6f 6e2d 6f70 7469 6f6e as a non-option │ │ │ │ │ +00044ab0: 2061 7267 756d 656e 742c 0a61 6e64 2061 argument,.and a │ │ │ │ │ +00044ac0: 6c73 6f20 6163 6365 7074 7320 7468 6520 lso accepts the │ │ │ │ │ +00044ad0: 666f 6c6c 6f77 696e 6720 6f70 7469 6f6e following option │ │ │ │ │ +00044ae0: 733a 0a0a 272d 2d68 656c 7027 0a20 2020 s:..'--help'. │ │ │ │ │ +00044af0: 2020 5072 696e 7420 6120 7375 6d6d 6172 Print a summar │ │ │ │ │ +00044b00: 7920 6f66 2074 6865 2063 6f6d 6d61 6e64 y of the command │ │ │ │ │ +00044b10: 2d6c 696e 6520 6f70 7469 6f6e 7320 616e -line options an │ │ │ │ │ +00044b20: 6420 6578 6974 2e0a 0a27 2d2d 7665 7273 d exit...'--vers │ │ │ │ │ +00044b30: 696f 6e27 0a20 2020 2020 5072 696e 7420 ion'. Print │ │ │ │ │ +00044b40: 7468 6520 7665 7273 696f 6e20 6e75 6d62 the version numb │ │ │ │ │ +00044b50: 6572 206f 6620 4752 5542 2061 6e64 2065 er of GRUB and e │ │ │ │ │ +00044b60: 7869 742e 0a0a 272d 6427 0a27 2d2d 6465 xit...'-d'.'--de │ │ │ │ │ +00044b70: 7669 6365 270a 2020 2020 2049 6620 7468 vice'. If th │ │ │ │ │ +00044b80: 6973 206f 7074 696f 6e20 6973 2067 6976 is option is giv │ │ │ │ │ +00044b90: 656e 2c20 7468 656e 2074 6865 206e 6f6e en, then the non │ │ │ │ │ +00044ba0: 2d6f 7074 696f 6e20 6172 6775 6d65 6e74 -option argument │ │ │ │ │ +00044bb0: 2069 7320 6120 7379 7374 656d 0a20 2020 is a system. │ │ │ │ │ +00044bc0: 2020 6465 7669 6365 206e 616d 6520 2873 device name (s │ │ │ │ │ +00044bd0: 7563 6820 6173 2027 2f64 6576 2f73 6461 uch as '/dev/sda │ │ │ │ │ +00044be0: 3127 292c 2061 6e64 2027 6772 7562 2d70 1'), and 'grub-p │ │ │ │ │ +00044bf0: 726f 6265 2720 7769 6c6c 2070 7269 6e74 robe' will print │ │ │ │ │ +00044c00: 0a20 2020 2020 696e 666f 726d 6174 696f . informatio │ │ │ │ │ +00044c10: 6e20 6162 6f75 7420 7468 6174 2064 6576 n about that dev │ │ │ │ │ +00044c20: 6963 652e 2020 4966 2069 7420 6973 206e ice. If it is n │ │ │ │ │ +00044c30: 6f74 2067 6976 656e 2c20 7468 656e 2074 ot given, then t │ │ │ │ │ +00044c40: 6865 0a20 2020 2020 6e6f 6e2d 6f70 7469 he. non-opti │ │ │ │ │ +00044c50: 6f6e 2061 7267 756d 656e 7420 6973 2061 on argument is a │ │ │ │ │ +00044c60: 2066 696c 6573 7973 7465 6d20 7061 7468 filesystem path │ │ │ │ │ +00044c70: 2028 7375 6368 2061 7320 272f 626f 6f74 (such as '/boot │ │ │ │ │ +00044c80: 2f67 7275 6227 292c 0a20 2020 2020 616e /grub'),. an │ │ │ │ │ +00044c90: 6420 2767 7275 622d 7072 6f62 6527 2077 d 'grub-probe' w │ │ │ │ │ +00044ca0: 696c 6c20 7072 696e 7420 696e 666f 726d ill print inform │ │ │ │ │ +00044cb0: 6174 696f 6e20 6162 6f75 7420 7468 6520 ation about the │ │ │ │ │ +00044cc0: 6465 7669 6365 2063 6f6e 7461 696e 696e device containin │ │ │ │ │ +00044cd0: 670a 2020 2020 2074 6861 7420 7061 7274 g. that part │ │ │ │ │ +00044ce0: 206f 6620 7468 6520 6669 6c65 7379 7374 of the filesyst │ │ │ │ │ +00044cf0: 656d 2e0a 0a27 2d6d 2046 494c 4527 0a27 em...'-m FILE'.' │ │ │ │ │ +00044d00: 2d2d 6465 7669 6365 2d6d 6170 3d46 494c --device-map=FIL │ │ │ │ │ +00044d10: 4527 0a20 2020 2020 5573 6520 4649 4c45 E'. Use FILE │ │ │ │ │ +00044d20: 2061 7320 7468 6520 6465 7669 6365 206d as the device m │ │ │ │ │ +00044d30: 6170 2028 2a6e 6f74 6520 4465 7669 6365 ap (*note Device │ │ │ │ │ +00044d40: 206d 6170 3a3a 2920 7261 7468 6572 2074 map::) rather t │ │ │ │ │ +00044d50: 6861 6e20 7468 650a 2020 2020 2064 6566 han the. def │ │ │ │ │ +00044d60: 6175 6c74 2c20 7573 7561 6c6c 7920 272f ault, usually '/ │ │ │ │ │ +00044d70: 626f 6f74 2f67 7275 622f 6465 7669 6365 boot/grub/device │ │ │ │ │ +00044d80: 2e6d 6170 272e 0a0a 272d 7420 5441 5247 .map'...'-t TARG │ │ │ │ │ +00044d90: 4554 270a 272d 2d74 6172 6765 743d 5441 ET'.'--target=TA │ │ │ │ │ +00044da0: 5247 4554 270a 2020 2020 2050 7269 6e74 RGET'. Print │ │ │ │ │ +00044db0: 2069 6e66 6f72 6d61 7469 6f6e 2061 626f information abo │ │ │ │ │ +00044dc0: 7574 2074 6865 2067 6976 656e 2070 6174 ut the given pat │ │ │ │ │ +00044dd0: 6820 6f72 2064 6576 6963 6520 6173 2064 h or device as d │ │ │ │ │ +00044de0: 6566 696e 6564 2062 790a 2020 2020 2054 efined by. T │ │ │ │ │ +00044df0: 4152 4745 542e 2020 5468 6520 6176 6169 ARGET. The avai │ │ │ │ │ +00044e00: 6c61 626c 6520 7461 7267 6574 7320 616e lable targets an │ │ │ │ │ +00044e10: 6420 7468 6569 7220 6d65 616e 696e 6773 d their meanings │ │ │ │ │ +00044e20: 2061 7265 3a0a 0a20 2020 2020 2766 7327 are:.. 'fs' │ │ │ │ │ +00044e30: 0a20 2020 2020 2020 2020 2047 5255 4220 . GRUB │ │ │ │ │ +00044e40: 6669 6c65 7379 7374 656d 206d 6f64 756c filesystem modul │ │ │ │ │ +00044e50: 652e 0a20 2020 2020 2766 735f 7575 6964 e.. 'fs_uuid │ │ │ │ │ +00044e60: 270a 2020 2020 2020 2020 2020 4669 6c65 '. File │ │ │ │ │ +00044e70: 7379 7374 656d 2055 6e69 7665 7273 616c system Universal │ │ │ │ │ +00044e80: 6c79 2055 6e69 7175 6520 4964 656e 7469 ly Unique Identi │ │ │ │ │ +00044e90: 6669 6572 2028 5555 4944 292e 0a20 2020 fier (UUID).. │ │ │ │ │ +00044ea0: 2020 2766 735f 6c61 6265 6c27 0a20 2020 'fs_label'. │ │ │ │ │ +00044eb0: 2020 2020 2020 2046 696c 6573 7973 7465 Filesyste │ │ │ │ │ +00044ec0: 6d20 6c61 6265 6c2e 0a20 2020 2020 2764 m label.. 'd │ │ │ │ │ +00044ed0: 7269 7665 270a 2020 2020 2020 2020 2020 rive'. │ │ │ │ │ +00044ee0: 4752 5542 2064 6576 6963 6520 6e61 6d65 GRUB device name │ │ │ │ │ +00044ef0: 2e0a 2020 2020 2027 6465 7669 6365 270a .. 'device'. │ │ │ │ │ +00044f00: 2020 2020 2020 2020 2020 5379 7374 656d System │ │ │ │ │ +00044f10: 2064 6576 6963 6520 6e61 6d65 2e0a 2020 device name.. │ │ │ │ │ +00044f20: 2020 2027 7061 7274 6d61 7027 0a20 2020 'partmap'. │ │ │ │ │ +00044f30: 2020 2020 2020 2047 5255 4220 7061 7274 GRUB part │ │ │ │ │ +00044f40: 6974 696f 6e20 6d61 7020 6d6f 6475 6c65 ition map module │ │ │ │ │ +00044f50: 2e0a 2020 2020 2027 6162 7374 7261 6374 .. 'abstract │ │ │ │ │ +00044f60: 696f 6e27 0a20 2020 2020 2020 2020 2047 ion'. G │ │ │ │ │ +00044f70: 5255 4220 6162 7374 7261 6374 696f 6e20 RUB abstraction │ │ │ │ │ +00044f80: 6d6f 6475 6c65 2028 652e 672e 2020 276c module (e.g. 'l │ │ │ │ │ +00044f90: 766d 2729 2e0a 2020 2020 2027 6372 7970 vm').. 'cryp │ │ │ │ │ +00044fa0: 746f 6469 736b 5f75 7569 6427 0a20 2020 todisk_uuid'. │ │ │ │ │ +00044fb0: 2020 2020 2020 2043 7279 7074 6f20 6465 Crypto de │ │ │ │ │ +00044fc0: 7669 6365 2055 5549 442e 0a20 2020 2020 vice UUID.. │ │ │ │ │ +00044fd0: 276d 7364 6f73 5f70 6172 7474 7970 6527 'msdos_parttype' │ │ │ │ │ +00044fe0: 0a20 2020 2020 2020 2020 204d 4252 2070 . MBR p │ │ │ │ │ +00044ff0: 6172 7469 7469 6f6e 2074 7970 6520 636f artition type co │ │ │ │ │ +00045000: 6465 2028 7477 6f20 6865 7861 6465 6369 de (two hexadeci │ │ │ │ │ +00045010: 6d61 6c20 6469 6769 7473 292e 0a20 2020 mal digits).. │ │ │ │ │ +00045020: 2020 2768 696e 7473 5f73 7472 696e 6727 'hints_string' │ │ │ │ │ +00045030: 0a20 2020 2020 2020 2020 2041 2073 7472 . A str │ │ │ │ │ +00045040: 696e 6720 6f66 2070 6c61 7466 6f72 6d20 ing of platform │ │ │ │ │ +00045050: 7365 6172 6368 2068 696e 7473 2073 7569 search hints sui │ │ │ │ │ +00045060: 7461 626c 6520 666f 7220 7061 7373 696e table for passin │ │ │ │ │ +00045070: 6720 746f 2074 6865 0a20 2020 2020 2020 g to the. │ │ │ │ │ +00045080: 2020 2027 7365 6172 6368 2720 636f 6d6d 'search' comm │ │ │ │ │ +00045090: 616e 6420 282a 6e6f 7465 2073 6561 7263 and (*note searc │ │ │ │ │ +000450a0: 683a 3a29 2e0a 2020 2020 2027 6269 6f73 h::).. 'bios │ │ │ │ │ +000450b0: 5f68 696e 7473 270a 2020 2020 2020 2020 _hints'. │ │ │ │ │ +000450c0: 2020 5365 6172 6368 2068 696e 7473 2066 Search hints f │ │ │ │ │ +000450d0: 6f72 2074 6865 2050 4320 4249 4f53 2070 or the PC BIOS p │ │ │ │ │ +000450e0: 6c61 7466 6f72 6d2e 0a20 2020 2020 2769 latform.. 'i │ │ │ │ │ +000450f0: 6565 6531 3237 355f 6869 6e74 7327 0a20 eee1275_hints'. │ │ │ │ │ +00045100: 2020 2020 2020 2020 2053 6561 7263 6820 Search │ │ │ │ │ +00045110: 6869 6e74 7320 666f 7220 7468 6520 4945 hints for the IE │ │ │ │ │ +00045120: 4545 3132 3735 2070 6c61 7466 6f72 6d2e EE1275 platform. │ │ │ │ │ +00045130: 0a20 2020 2020 2762 6172 656d 6574 616c . 'baremetal │ │ │ │ │ +00045140: 5f68 696e 7473 270a 2020 2020 2020 2020 _hints'. │ │ │ │ │ +00045150: 2020 5365 6172 6368 2068 696e 7473 2066 Search hints f │ │ │ │ │ +00045160: 6f72 2070 6c61 7466 6f72 6d73 2077 6865 or platforms whe │ │ │ │ │ +00045170: 7265 2064 6973 6b73 2061 7265 2061 6464 re disks are add │ │ │ │ │ +00045180: 7265 7373 6564 2064 6972 6563 746c 790a ressed directly. │ │ │ │ │ +00045190: 2020 2020 2020 2020 2020 7261 7468 6572 rather │ │ │ │ │ +000451a0: 2074 6861 6e20 7669 6120 6669 726d 7761 than via firmwa │ │ │ │ │ +000451b0: 7265 2e0a 2020 2020 2027 6566 695f 6869 re.. 'efi_hi │ │ │ │ │ +000451c0: 6e74 7327 0a20 2020 2020 2020 2020 2053 nts'. S │ │ │ │ │ +000451d0: 6561 7263 6820 6869 6e74 7320 666f 7220 earch hints for │ │ │ │ │ +000451e0: 7468 6520 4546 4920 706c 6174 666f 726d the EFI platform │ │ │ │ │ +000451f0: 2e0a 2020 2020 2027 6172 635f 6869 6e74 .. 'arc_hint │ │ │ │ │ +00045200: 7327 0a20 2020 2020 2020 2020 2053 6561 s'. Sea │ │ │ │ │ +00045210: 7263 6820 6869 6e74 7320 666f 7220 7468 rch hints for th │ │ │ │ │ +00045220: 6520 4152 4320 706c 6174 666f 726d 2e0a e ARC platform.. │ │ │ │ │ +00045230: 2020 2020 2027 636f 6d70 6174 6962 696c 'compatibil │ │ │ │ │ +00045240: 6974 795f 6869 6e74 270a 2020 2020 2020 ity_hint'. │ │ │ │ │ +00045250: 2020 2020 4120 6775 6573 7320 6174 2061 A guess at a │ │ │ │ │ +00045260: 2072 6561 736f 6e61 626c 6520 4752 5542 reasonable GRUB │ │ │ │ │ +00045270: 2064 7269 7665 206e 616d 6520 666f 7220 drive name for │ │ │ │ │ +00045280: 7468 6973 2064 6576 6963 652c 2077 6869 this device, whi │ │ │ │ │ +00045290: 6368 0a20 2020 2020 2020 2020 206d 6179 ch. may │ │ │ │ │ +000452a0: 2062 6520 7573 6564 2061 7320 6120 6661 be used as a fa │ │ │ │ │ +000452b0: 6c6c 6261 636b 2069 6620 7468 6520 2773 llback if the 's │ │ │ │ │ +000452c0: 6561 7263 6827 2063 6f6d 6d61 6e64 2066 earch' command f │ │ │ │ │ +000452d0: 6169 6c73 2e0a 2020 2020 2027 6469 736b ails.. 'disk │ │ │ │ │ +000452e0: 270a 2020 2020 2020 2020 2020 5379 7374 '. Syst │ │ │ │ │ +000452f0: 656d 2064 6576 6963 6520 6e61 6d65 2066 em device name f │ │ │ │ │ +00045300: 6f72 2074 6865 2077 686f 6c65 2064 6973 or the whole dis │ │ │ │ │ +00045310: 6b2e 0a0a 272d 7627 0a27 2d2d 7665 7262 k...'-v'.'--verb │ │ │ │ │ +00045320: 6f73 6527 0a20 2020 2020 5072 696e 7420 ose'. Print │ │ │ │ │ +00045330: 7665 7262 6f73 6520 6d65 7373 6167 6573 verbose messages │ │ │ │ │ +00045340: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ +00045350: 696e 666f 2c20 204e 6f64 653a 2049 6e76 info, Node: Inv │ │ │ │ │ +00045360: 6f6b 696e 6720 6772 7562 2d73 6372 6970 oking grub-scrip │ │ │ │ │ +00045370: 742d 6368 6563 6b2c 2020 4e65 7874 3a20 t-check, Next: │ │ │ │ │ +00045380: 4f62 7461 696e 696e 6720 616e 6420 4275 Obtaining and Bu │ │ │ │ │ +00045390: 696c 6469 6e67 2047 5255 422c 2020 5072 ilding GRUB, Pr │ │ │ │ │ +000453a0: 6576 3a20 496e 766f 6b69 6e67 2067 7275 ev: Invoking gru │ │ │ │ │ +000453b0: 622d 7072 6f62 652c 2020 5570 3a20 546f b-probe, Up: To │ │ │ │ │ +000453c0: 700a 0a33 3020 496e 766f 6b69 6e67 2067 p..30 Invoking g │ │ │ │ │ +000453d0: 7275 622d 7363 7269 7074 2d63 6865 636b rub-script-check │ │ │ │ │ +000453e0: 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a .*************** │ │ │ │ │ +000453f0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a **************.. │ │ │ │ │ +00045400: 5468 6520 7072 6f67 7261 6d20 2767 7275 The program 'gru │ │ │ │ │ +00045410: 622d 7363 7269 7074 2d63 6865 636b 2720 b-script-check' │ │ │ │ │ +00045420: 7461 6b65 7320 6120 4752 5542 2073 6372 takes a GRUB scr │ │ │ │ │ +00045430: 6970 7420 6669 6c65 2028 2a6e 6f74 650a ipt file (*note. │ │ │ │ │ +00045440: 5368 656c 6c2d 6c69 6b65 2073 6372 6970 Shell-like scrip │ │ │ │ │ +00045450: 7469 6e67 3a3a 2920 616e 6420 6368 6563 ting::) and chec │ │ │ │ │ +00045460: 6b73 2069 7420 666f 7220 7379 6e74 6178 ks it for syntax │ │ │ │ │ +00045470: 2065 7272 6f72 732c 2073 696d 696c 6172 errors, similar │ │ │ │ │ +00045480: 2074 6f0a 636f 6d6d 616e 6473 2073 7563 to.commands suc │ │ │ │ │ +00045490: 6820 6173 2027 7368 202d 6e27 2e20 2049 h as 'sh -n'. I │ │ │ │ │ +000454a0: 7420 6d61 7920 7461 6b65 2061 2050 4154 t may take a PAT │ │ │ │ │ +000454b0: 4820 6173 2061 206e 6f6e 2d6f 7074 696f H as a non-optio │ │ │ │ │ +000454c0: 6e20 6172 6775 6d65 6e74 3b0a 6966 206e n argument;.if n │ │ │ │ │ +000454d0: 6f6e 6520 6973 2073 7570 706c 6965 642c one is supplied, │ │ │ │ │ +000454e0: 2069 7420 7769 6c6c 2072 6561 6420 6672 it will read fr │ │ │ │ │ +000454f0: 6f6d 2073 7461 6e64 6172 6420 696e 7075 om standard inpu │ │ │ │ │ +00045500: 742e 0a0a 2020 2020 2067 7275 622d 7363 t... grub-sc │ │ │ │ │ +00045510: 7269 7074 2d63 6865 636b 202f 626f 6f74 ript-check /boot │ │ │ │ │ +00045520: 2f67 7275 622f 6772 7562 2e63 6667 0a0a /grub/grub.cfg.. │ │ │ │ │ +00045530: 2020 2027 6772 7562 2d73 6372 6970 742d 'grub-script- │ │ │ │ │ +00045540: 6368 6563 6b27 2061 6363 6570 7473 2074 check' accepts t │ │ │ │ │ +00045550: 6865 2066 6f6c 6c6f 7769 6e67 206f 7074 he following opt │ │ │ │ │ +00045560: 696f 6e73 3a0a 0a27 2d2d 6865 6c70 270a ions:..'--help'. │ │ │ │ │ +00045570: 2020 2020 2050 7269 6e74 2061 2073 756d Print a sum │ │ │ │ │ +00045580: 6d61 7279 206f 6620 7468 6520 636f 6d6d mary of the comm │ │ │ │ │ +00045590: 616e 642d 6c69 6e65 206f 7074 696f 6e73 and-line options │ │ │ │ │ +000455a0: 2061 6e64 2065 7869 742e 0a0a 272d 2d76 and exit...'--v │ │ │ │ │ +000455b0: 6572 7369 6f6e 270a 2020 2020 2050 7269 ersion'. Pri │ │ │ │ │ +000455c0: 6e74 2074 6865 2076 6572 7369 6f6e 206e nt the version n │ │ │ │ │ +000455d0: 756d 6265 7220 6f66 2047 5255 4220 616e umber of GRUB an │ │ │ │ │ +000455e0: 6420 6578 6974 2e0a 0a27 2d76 270a 272d d exit...'-v'.'- │ │ │ │ │ +000455f0: 2d76 6572 626f 7365 270a 2020 2020 2050 -verbose'. P │ │ │ │ │ +00045600: 7269 6e74 2065 6163 6820 6c69 6e65 206f rint each line o │ │ │ │ │ +00045610: 6620 696e 7075 7420 6166 7465 7220 7265 f input after re │ │ │ │ │ +00045620: 6164 696e 6720 6974 2e0a 0a1f 0a46 696c ading it.....Fil │ │ │ │ │ +00045630: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ +00045640: 6f64 653a 204f 6274 6169 6e69 6e67 2061 ode: Obtaining a │ │ │ │ │ +00045650: 6e64 2042 7569 6c64 696e 6720 4752 5542 nd Building GRUB │ │ │ │ │ +00045660: 2c20 204e 6578 743a 2052 6570 6f72 7469 , Next: Reporti │ │ │ │ │ +00045670: 6e67 2062 7567 732c 2020 5072 6576 3a20 ng bugs, Prev: │ │ │ │ │ +00045680: 496e 766f 6b69 6e67 2067 7275 622d 7363 Invoking grub-sc │ │ │ │ │ +00045690: 7269 7074 2d63 6865 636b 2c20 2055 703a ript-check, Up: │ │ │ │ │ +000456a0: 2054 6f70 0a0a 4170 7065 6e64 6978 2041 Top..Appendix A │ │ │ │ │ +000456b0: 2048 6f77 2074 6f20 6f62 7461 696e 2061 How to obtain a │ │ │ │ │ +000456c0: 6e64 2062 7569 6c64 2047 5255 420a 2a2a nd build GRUB.** │ │ │ │ │ 000456d0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ 000456e0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -000456f0: 2a2a 2a2a 2a2a 2a0a 0a20 2020 2020 2a43 *******.. *C │ │ │ │ │ -00045700: 6175 7469 6f6e 3a2a 2047 5255 4220 7265 aution:* GRUB re │ │ │ │ │ -00045710: 7175 6972 6573 2062 696e 7574 696c 732d quires binutils- │ │ │ │ │ -00045720: 322e 392e 312e 302e 3233 206f 7220 6c61 2.9.1.0.23 or la │ │ │ │ │ -00045730: 7465 7220 6265 6361 7573 6520 7468 650a ter because the. │ │ │ │ │ -00045740: 2020 2020 2047 4e55 2061 7373 656d 626c GNU assembl │ │ │ │ │ -00045750: 6572 2068 6173 2062 6565 6e20 6368 616e er has been chan │ │ │ │ │ -00045760: 6765 6420 736f 2074 6861 7420 6974 2063 ged so that it c │ │ │ │ │ -00045770: 616e 2070 726f 6475 6365 2072 6561 6c20 an produce real │ │ │ │ │ -00045780: 3136 6269 7473 0a20 2020 2020 6d61 6368 16bits. mach │ │ │ │ │ -00045790: 696e 6520 636f 6465 2062 6574 7765 656e ine code between │ │ │ │ │ -000457a0: 2032 2e39 2e31 2061 6e64 2032 2e39 2e31 2.9.1 and 2.9.1 │ │ │ │ │ -000457b0: 2e30 2e78 2e20 2053 6565 0a20 2020 2020 .0.x. See. │ │ │ │ │ -000457c0: 3c68 7474 703a 2f2f 736f 7572 6365 732e , to obtain │ │ │ │ │ -000457f0: 2069 6e66 6f72 6d61 7469 6f6e 206f 6e20 information on │ │ │ │ │ -00045800: 686f 770a 2020 2020 2074 6f20 6765 7420 how. to get │ │ │ │ │ -00045810: 7468 6520 6c61 7465 7374 2076 6572 7369 the latest versi │ │ │ │ │ -00045820: 6f6e 2e0a 0a20 2020 4752 5542 2069 7320 on... GRUB is │ │ │ │ │ -00045830: 6176 6169 6c61 626c 6520 6672 6f6d 2074 available from t │ │ │ │ │ -00045840: 6865 2047 4e55 2061 6c70 6861 2061 7263 he GNU alpha arc │ │ │ │ │ -00045850: 6869 7665 2073 6974 650a 3c66 7470 3a2f hive site. or any of │ │ │ │ │ -00045880: 2069 7473 206d 6972 726f 7273 2e20 2054 its mirrors. T │ │ │ │ │ -00045890: 6865 2066 696c 6520 7769 6c6c 2062 650a he file will be. │ │ │ │ │ -000458a0: 6e61 6d65 6420 6772 7562 2d76 6572 7369 named grub-versi │ │ │ │ │ -000458b0: 6f6e 2e74 6172 2e67 7a2e 2020 5468 6520 on.tar.gz. The │ │ │ │ │ -000458c0: 6375 7272 656e 7420 7665 7273 696f 6e20 current version │ │ │ │ │ -000458d0: 6973 2032 2e30 362c 2073 6f20 7468 6520 is 2.06, so the │ │ │ │ │ -000458e0: 6669 6c65 2079 6f75 0a73 686f 756c 6420 file you.should │ │ │ │ │ -000458f0: 6772 6162 2069 733a 0a0a 2020 203c 6674 grab is:.. .. T │ │ │ │ │ -00045930: 6f20 756e 6275 6e64 6c65 2047 5255 4220 o unbundle GRUB │ │ │ │ │ -00045940: 7573 6520 7468 6520 696e 7374 7275 6374 use the instruct │ │ │ │ │ -00045950: 696f 6e3a 0a0a 2020 2020 207a 6361 7420 ion:.. zcat │ │ │ │ │ -00045960: 6772 7562 2d32 2e30 362e 7461 722e 677a grub-2.06.tar.gz │ │ │ │ │ -00045970: 207c 2074 6172 2078 7666 202d 0a0a 2020 | tar xvf -.. │ │ │ │ │ -00045980: 2077 6869 6368 2077 696c 6c20 6372 6561 which will crea │ │ │ │ │ -00045990: 7465 2061 2064 6972 6563 746f 7279 2063 te a directory c │ │ │ │ │ -000459a0: 616c 6c65 6420 2767 7275 622d 322e 3036 alled 'grub-2.06 │ │ │ │ │ -000459b0: 2720 7769 7468 2061 6c6c 2074 6865 0a73 ' with all the.s │ │ │ │ │ -000459c0: 6f75 7263 6573 2e20 2059 6f75 2063 616e ources. You can │ │ │ │ │ -000459d0: 206c 6f6f 6b20 6174 2074 6865 2066 696c look at the fil │ │ │ │ │ -000459e0: 6520 2749 4e53 5441 4c4c 2720 666f 7220 e 'INSTALL' for │ │ │ │ │ -000459f0: 6465 7461 696c 6564 2069 6e73 7472 7563 detailed instruc │ │ │ │ │ -00045a00: 7469 6f6e 730a 6f6e 2068 6f77 2074 6f20 tions.on how to │ │ │ │ │ -00045a10: 6275 696c 6420 616e 6420 696e 7374 616c build and instal │ │ │ │ │ -00045a20: 6c20 4752 5542 2c20 6275 7420 796f 7520 l GRUB, but you │ │ │ │ │ -00045a30: 7368 6f75 6c64 2062 6520 6162 6c65 2074 should be able t │ │ │ │ │ -00045a40: 6f20 6a75 7374 2064 6f3a 0a0a 2020 2020 o just do:.. │ │ │ │ │ -00045a50: 2063 6420 6772 7562 2d32 2e30 360a 2020 cd grub-2.06. │ │ │ │ │ -00045a60: 2020 202e 2f63 6f6e 6669 6775 7265 0a20 ./configure. │ │ │ │ │ -00045a70: 2020 2020 6d61 6b65 2069 6e73 7461 6c6c make install │ │ │ │ │ -00045a80: 0a0a 2020 2041 6c73 6f2c 2074 6865 206c .. Also, the l │ │ │ │ │ -00045a90: 6174 6573 7420 7665 7273 696f 6e20 6973 atest version is │ │ │ │ │ -00045aa0: 2061 7661 696c 6162 6c65 2075 7369 6e67 available using │ │ │ │ │ -00045ab0: 2047 6974 2e20 2053 6565 0a3c 6874 7470 Git. See. │ │ │ │ │ -00045af0: 2066 6f72 206d 6f72 650a 696e 666f 726d for more.inform │ │ │ │ │ -00045b00: 6174 696f 6e2e 0a0a 1f0a 4669 6c65 3a20 ation.....File: │ │ │ │ │ -00045b10: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ -00045b20: 3a20 5265 706f 7274 696e 6720 6275 6773 : Reporting bugs │ │ │ │ │ -00045b30: 2c20 204e 6578 743a 2046 7574 7572 652c , Next: Future, │ │ │ │ │ -00045b40: 2020 5072 6576 3a20 4f62 7461 696e 696e Prev: Obtainin │ │ │ │ │ -00045b50: 6720 616e 6420 4275 696c 6469 6e67 2047 g and Building G │ │ │ │ │ -00045b60: 5255 422c 2020 5570 3a20 546f 700a 0a41 RUB, Up: Top..A │ │ │ │ │ -00045b70: 7070 656e 6469 7820 4220 5265 706f 7274 ppendix B Report │ │ │ │ │ -00045b80: 696e 6720 6275 6773 0a2a 2a2a 2a2a 2a2a ing bugs.******* │ │ │ │ │ +000456f0: 2a2a 2a2a 2a0a 0a20 2020 2020 2a43 6175 *****.. *Cau │ │ │ │ │ +00045700: 7469 6f6e 3a2a 2047 5255 4220 7265 7175 tion:* GRUB requ │ │ │ │ │ +00045710: 6972 6573 2062 696e 7574 696c 732d 322e ires binutils-2. │ │ │ │ │ +00045720: 392e 312e 302e 3233 206f 7220 6c61 7465 9.1.0.23 or late │ │ │ │ │ +00045730: 7220 6265 6361 7573 6520 7468 650a 2020 r because the. │ │ │ │ │ +00045740: 2020 2047 4e55 2061 7373 656d 626c 6572 GNU assembler │ │ │ │ │ +00045750: 2068 6173 2062 6565 6e20 6368 616e 6765 has been change │ │ │ │ │ +00045760: 6420 736f 2074 6861 7420 6974 2063 616e d so that it can │ │ │ │ │ +00045770: 2070 726f 6475 6365 2072 6561 6c20 3136 produce real 16 │ │ │ │ │ +00045780: 6269 7473 0a20 2020 2020 6d61 6368 696e bits. machin │ │ │ │ │ +00045790: 6520 636f 6465 2062 6574 7765 656e 2032 e code between 2 │ │ │ │ │ +000457a0: 2e39 2e31 2061 6e64 2032 2e39 2e31 2e30 .9.1 and 2.9.1.0 │ │ │ │ │ +000457b0: 2e78 2e20 2053 6565 0a20 2020 2020 3c68 .x. See. , to obtain i │ │ │ │ │ +000457f0: 6e66 6f72 6d61 7469 6f6e 206f 6e20 686f nformation on ho │ │ │ │ │ +00045800: 770a 2020 2020 2074 6f20 6765 7420 7468 w. to get th │ │ │ │ │ +00045810: 6520 6c61 7465 7374 2076 6572 7369 6f6e e latest version │ │ │ │ │ +00045820: 2e0a 0a20 2020 4752 5542 2069 7320 6176 ... GRUB is av │ │ │ │ │ +00045830: 6169 6c61 626c 6520 6672 6f6d 2074 6865 ailable from the │ │ │ │ │ +00045840: 2047 4e55 2061 6c70 6861 2061 7263 6869 GNU alpha archi │ │ │ │ │ +00045850: 7665 2073 6974 650a 3c66 7470 3a2f 2f66 ve site. or any of i │ │ │ │ │ +00045880: 7473 206d 6972 726f 7273 2e20 2054 6865 ts mirrors. The │ │ │ │ │ +00045890: 2066 696c 6520 7769 6c6c 2062 650a 6e61 file will be.na │ │ │ │ │ +000458a0: 6d65 6420 6772 7562 2d76 6572 7369 6f6e med grub-version │ │ │ │ │ +000458b0: 2e74 6172 2e67 7a2e 2020 5468 6520 6375 .tar.gz. The cu │ │ │ │ │ +000458c0: 7272 656e 7420 7665 7273 696f 6e20 6973 rrent version is │ │ │ │ │ +000458d0: 2032 2e30 362c 2073 6f20 7468 6520 6669 2.06, so the fi │ │ │ │ │ +000458e0: 6c65 2079 6f75 0a73 686f 756c 6420 6772 le you.should gr │ │ │ │ │ +000458f0: 6162 2069 733a 0a0a 2020 203c 6674 703a ab is:.. .. To │ │ │ │ │ +00045930: 756e 6275 6e64 6c65 2047 5255 4220 7573 unbundle GRUB us │ │ │ │ │ +00045940: 6520 7468 6520 696e 7374 7275 6374 696f e the instructio │ │ │ │ │ +00045950: 6e3a 0a0a 2020 2020 207a 6361 7420 6772 n:.. zcat gr │ │ │ │ │ +00045960: 7562 2d32 2e30 362e 7461 722e 677a 207c ub-2.06.tar.gz | │ │ │ │ │ +00045970: 2074 6172 2078 7666 202d 0a0a 2020 2077 tar xvf -.. w │ │ │ │ │ +00045980: 6869 6368 2077 696c 6c20 6372 6561 7465 hich will create │ │ │ │ │ +00045990: 2061 2064 6972 6563 746f 7279 2063 616c a directory cal │ │ │ │ │ +000459a0: 6c65 6420 2767 7275 622d 322e 3036 2720 led 'grub-2.06' │ │ │ │ │ +000459b0: 7769 7468 2061 6c6c 2074 6865 0a73 6f75 with all the.sou │ │ │ │ │ +000459c0: 7263 6573 2e20 2059 6f75 2063 616e 206c rces. You can l │ │ │ │ │ +000459d0: 6f6f 6b20 6174 2074 6865 2066 696c 6520 ook at the file │ │ │ │ │ +000459e0: 2749 4e53 5441 4c4c 2720 666f 7220 6465 'INSTALL' for de │ │ │ │ │ +000459f0: 7461 696c 6564 2069 6e73 7472 7563 7469 tailed instructi │ │ │ │ │ +00045a00: 6f6e 730a 6f6e 2068 6f77 2074 6f20 6275 ons.on how to bu │ │ │ │ │ +00045a10: 696c 6420 616e 6420 696e 7374 616c 6c20 ild and install │ │ │ │ │ +00045a20: 4752 5542 2c20 6275 7420 796f 7520 7368 GRUB, but you sh │ │ │ │ │ +00045a30: 6f75 6c64 2062 6520 6162 6c65 2074 6f20 ould be able to │ │ │ │ │ +00045a40: 6a75 7374 2064 6f3a 0a0a 2020 2020 2063 just do:.. c │ │ │ │ │ +00045a50: 6420 6772 7562 2d32 2e30 360a 2020 2020 d grub-2.06. │ │ │ │ │ +00045a60: 202e 2f63 6f6e 6669 6775 7265 0a20 2020 ./configure. │ │ │ │ │ +00045a70: 2020 6d61 6b65 2069 6e73 7461 6c6c 0a0a make install.. │ │ │ │ │ +00045a80: 2020 2041 6c73 6f2c 2074 6865 206c 6174 Also, the lat │ │ │ │ │ +00045a90: 6573 7420 7665 7273 696f 6e20 6973 2061 est version is a │ │ │ │ │ +00045aa0: 7661 696c 6162 6c65 2075 7369 6e67 2047 vailable using G │ │ │ │ │ +00045ab0: 6974 2e20 2053 6565 0a3c 6874 7470 3a2f it. See. f │ │ │ │ │ +00045af0: 6f72 206d 6f72 650a 696e 666f 726d 6174 or more.informat │ │ │ │ │ +00045b00: 696f 6e2e 0a0a 1f0a 4669 6c65 3a20 6772 ion.....File: gr │ │ │ │ │ +00045b10: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ +00045b20: 5265 706f 7274 696e 6720 6275 6773 2c20 Reporting bugs, │ │ │ │ │ +00045b30: 204e 6578 743a 2046 7574 7572 652c 2020 Next: Future, │ │ │ │ │ +00045b40: 5072 6576 3a20 4f62 7461 696e 696e 6720 Prev: Obtaining │ │ │ │ │ +00045b50: 616e 6420 4275 696c 6469 6e67 2047 5255 and Building GRU │ │ │ │ │ +00045b60: 422c 2020 5570 3a20 546f 700a 0a41 7070 B, Up: Top..App │ │ │ │ │ +00045b70: 656e 6469 7820 4220 5265 706f 7274 696e endix B Reportin │ │ │ │ │ +00045b80: 6720 6275 6773 0a2a 2a2a 2a2a 2a2a 2a2a g bugs.********* │ │ │ │ │ 00045b90: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -00045ba0: 2a2a 0a0a 5468 6573 6520 6172 6520 7468 **..These are th │ │ │ │ │ -00045bb0: 6520 6775 6964 656c 696e 6520 666f 7220 e guideline for │ │ │ │ │ -00045bc0: 686f 7720 746f 2072 6570 6f72 7420 6275 how to report bu │ │ │ │ │ -00045bd0: 6773 2e20 2054 616b 6520 6120 6c6f 6f6b gs. Take a look │ │ │ │ │ -00045be0: 2061 7420 7468 6973 0a6c 6973 7420 6265 at this.list be │ │ │ │ │ -00045bf0: 6c6f 7720 6265 666f 7265 2079 6f75 2073 low before you s │ │ │ │ │ -00045c00: 7562 6d69 7420 6275 6773 3a0a 0a20 2031 ubmit bugs:.. 1 │ │ │ │ │ -00045c10: 2e20 4265 666f 7265 2067 6574 7469 6e67 . Before getting │ │ │ │ │ -00045c20: 2075 6e73 6574 746c 6564 2c20 7265 6164 unsettled, read │ │ │ │ │ -00045c30: 2074 6869 7320 6d61 6e75 616c 2074 6872 this manual thr │ │ │ │ │ -00045c40: 6f75 6768 2061 6e64 2074 6872 6f75 6768 ough and through │ │ │ │ │ -00045c50: 2e0a 2020 2020 2041 6c73 6f2c 2073 6565 .. Also, see │ │ │ │ │ -00045c60: 2074 6865 2047 4e55 2047 5255 4220 4641 the GNU GRUB FA │ │ │ │ │ -00045c70: 510a 2020 2020 2028 6874 7470 3a2f 2f77 Q. (http://w │ │ │ │ │ -00045c80: 7777 2e67 6e75 2e6f 7267 2f73 6f66 7477 ww.gnu.org/softw │ │ │ │ │ -00045c90: 6172 652f 6772 7562 2f67 7275 622d 6661 are/grub/grub-fa │ │ │ │ │ -00045ca0: 712e 6874 6d6c 292e 0a0a 2020 322e 2041 q.html)... 2. A │ │ │ │ │ -00045cb0: 6c77 6179 7320 6d65 6e74 696f 6e20 7468 lways mention th │ │ │ │ │ -00045cc0: 6520 696e 666f 726d 6174 696f 6e20 6f6e e information on │ │ │ │ │ -00045cd0: 2079 6f75 7220 4752 5542 2e20 5468 6520 your GRUB. The │ │ │ │ │ -00045ce0: 7665 7273 696f 6e20 6e75 6d62 6572 2061 version number a │ │ │ │ │ -00045cf0: 6e64 0a20 2020 2020 7468 6520 636f 6e66 nd. the conf │ │ │ │ │ -00045d00: 6967 7572 6174 696f 6e20 6172 6520 7175 iguration are qu │ │ │ │ │ -00045d10: 6974 6520 696d 706f 7274 616e 742e 2020 ite important. │ │ │ │ │ -00045d20: 4966 2079 6f75 2062 7569 6c64 2069 7420 If you build it │ │ │ │ │ -00045d30: 796f 7572 7365 6c66 2c0a 2020 2020 2077 yourself,. w │ │ │ │ │ -00045d40: 7269 7465 2074 6865 206f 7074 696f 6e73 rite the options │ │ │ │ │ -00045d50: 2073 7065 6369 6669 6564 2074 6f20 7468 specified to th │ │ │ │ │ -00045d60: 6520 636f 6e66 6967 7572 6520 7363 7269 e configure scri │ │ │ │ │ -00045d70: 7074 2061 6e64 2079 6f75 720a 2020 2020 pt and your. │ │ │ │ │ -00045d80: 206f 7065 7261 7469 6e67 2073 7973 7465 operating syste │ │ │ │ │ -00045d90: 6d2c 2069 6e63 6c75 6469 6e67 2074 6865 m, including the │ │ │ │ │ -00045da0: 2076 6572 7369 6f6e 7320 6f66 2067 6363 versions of gcc │ │ │ │ │ -00045db0: 2061 6e64 2062 696e 7574 696c 732e 0a0a and binutils... │ │ │ │ │ -00045dc0: 2020 332e 2049 6620 796f 7520 6861 7665 3. If you have │ │ │ │ │ -00045dd0: 2074 726f 7562 6c65 2077 6974 6820 7468 trouble with th │ │ │ │ │ -00045de0: 6520 696e 7374 616c 6c61 7469 6f6e 2c20 e installation, │ │ │ │ │ -00045df0: 696e 666f 726d 2075 7320 6f66 2068 6f77 inform us of how │ │ │ │ │ -00045e00: 2079 6f75 0a20 2020 2020 696e 7374 616c you. instal │ │ │ │ │ -00045e10: 6c65 6420 4752 5542 2e20 446f 6e27 7420 led GRUB. Don't │ │ │ │ │ -00045e20: 6f6d 6974 2065 7272 6f72 206d 6573 7361 omit error messa │ │ │ │ │ -00045e30: 6765 732c 2069 6620 616e 792e 2020 4a75 ges, if any. Ju │ │ │ │ │ -00045e40: 7374 2027 4752 5542 0a20 2020 2020 6861 st 'GRUB. ha │ │ │ │ │ -00045e50: 6e67 7320 7570 2077 6865 6e20 6974 2062 ngs up when it b │ │ │ │ │ -00045e60: 6f6f 7473 2720 6973 206e 6f74 2065 6e6f oots' is not eno │ │ │ │ │ -00045e70: 7567 682e 0a0a 2020 2020 2054 6865 2069 ugh... The i │ │ │ │ │ -00045e80: 6e66 6f72 6d61 7469 6f6e 206f 6e20 796f nformation on yo │ │ │ │ │ -00045e90: 7572 2068 6172 6477 6172 6520 6973 2061 ur hardware is a │ │ │ │ │ -00045ea0: 6c73 6f20 6573 7365 6e74 6961 6c2e 2020 lso essential. │ │ │ │ │ -00045eb0: 5468 6573 6520 6172 650a 2020 2020 2065 These are. e │ │ │ │ │ -00045ec0: 7370 6563 6961 6c6c 7920 696d 706f 7274 specially import │ │ │ │ │ -00045ed0: 616e 743a 2074 6865 2067 656f 6d65 7472 ant: the geometr │ │ │ │ │ -00045ee0: 6965 7320 616e 6420 7468 6520 7061 7274 ies and the part │ │ │ │ │ -00045ef0: 6974 696f 6e20 7461 626c 6573 206f 660a ition tables of. │ │ │ │ │ -00045f00: 2020 2020 2079 6f75 7220 6861 7264 2064 your hard d │ │ │ │ │ -00045f10: 6973 6b20 6472 6976 6573 2061 6e64 2079 isk drives and y │ │ │ │ │ -00045f20: 6f75 7220 4249 4f53 2e0a 0a20 2034 2e20 our BIOS... 4. │ │ │ │ │ -00045f30: 4966 2047 5255 4220 6361 6e6e 6f74 2062 If GRUB cannot b │ │ │ │ │ -00045f40: 6f6f 7420 796f 7572 206f 7065 7261 7469 oot your operati │ │ │ │ │ -00045f50: 6e67 2073 7973 7465 6d2c 2077 7269 7465 ng system, write │ │ │ │ │ -00045f60: 2064 6f77 6e20 5f65 7665 7279 7468 696e down _everythin │ │ │ │ │ -00045f70: 675f 0a20 2020 2020 796f 7520 7365 6520 g_. you see │ │ │ │ │ -00045f80: 6f6e 2074 6865 2073 6372 6565 6e2e 2020 on the screen. │ │ │ │ │ -00045f90: 446f 6e27 7420 7061 7261 7068 7261 7365 Don't paraphrase │ │ │ │ │ -00045fa0: 2074 6865 6d2c 206c 696b 6520 2754 6865 them, like 'The │ │ │ │ │ -00045fb0: 2066 6f6f 204f 530a 2020 2020 2063 7261 foo OS. cra │ │ │ │ │ -00045fc0: 7368 6573 2077 6974 6820 4752 5542 2c20 shes with GRUB, │ │ │ │ │ -00045fd0: 6576 656e 2074 686f 7567 6820 6974 2063 even though it c │ │ │ │ │ -00045fe0: 616e 2062 6f6f 7420 7769 7468 2074 6865 an boot with the │ │ │ │ │ -00045ff0: 2062 6172 2062 6f6f 7420 6c6f 6164 6572 bar boot loader │ │ │ │ │ -00046000: 0a20 2020 2020 6a75 7374 2066 696e 6527 . just fine' │ │ │ │ │ -00046010: 2e20 204d 656e 7469 6f6e 2074 6865 2063 . Mention the c │ │ │ │ │ -00046020: 6f6d 6d61 6e64 7320 796f 7520 6578 6563 ommands you exec │ │ │ │ │ -00046030: 7574 6564 2c20 7468 6520 6d65 7373 6167 uted, the messag │ │ │ │ │ -00046040: 6573 0a20 2020 2020 7072 696e 7465 6420 es. printed │ │ │ │ │ -00046050: 6279 2074 6865 6d2c 2061 6e64 2069 6e66 by them, and inf │ │ │ │ │ -00046060: 6f72 6d61 7469 6f6e 206f 6e20 796f 7572 ormation on your │ │ │ │ │ -00046070: 206f 7065 7261 7469 6e67 2073 7973 7465 operating syste │ │ │ │ │ -00046080: 6d20 696e 636c 7564 696e 670a 2020 2020 m including. │ │ │ │ │ -00046090: 2074 6865 2076 6572 7369 6f6e 206e 756d the version num │ │ │ │ │ -000460a0: 6265 722e 0a0a 2020 352e 2045 7870 6c61 ber... 5. Expla │ │ │ │ │ -000460b0: 696e 2077 6861 7420 796f 7520 7761 6e74 in what you want │ │ │ │ │ -000460c0: 6564 2074 6f20 646f 2e20 2049 7420 6973 ed to do. It is │ │ │ │ │ -000460d0: 2076 6572 7920 7573 6566 756c 2074 6f20 very useful to │ │ │ │ │ -000460e0: 6b6e 6f77 2079 6f75 720a 2020 2020 2070 know your. p │ │ │ │ │ -000460f0: 7572 706f 7365 2061 6e64 2079 6f75 7220 urpose and your │ │ │ │ │ -00046100: 7769 7368 2c20 616e 6420 686f 7720 4752 wish, and how GR │ │ │ │ │ -00046110: 5542 2064 6964 6e27 7420 7361 7469 7366 UB didn't satisf │ │ │ │ │ -00046120: 7920 796f 752e 0a0a 2020 362e 2049 6620 y you... 6. If │ │ │ │ │ -00046130: 796f 7520 6361 6e20 696e 7665 7374 6967 you can investig │ │ │ │ │ -00046140: 6174 6520 7468 6520 7072 6f62 6c65 6d20 ate the problem │ │ │ │ │ -00046150: 796f 7572 7365 6c66 2c20 706c 6561 7365 yourself, please │ │ │ │ │ -00046160: 2064 6f2e 2020 5468 6174 2077 696c 6c0a do. That will. │ │ │ │ │ -00046170: 2020 2020 2067 6976 6520 796f 7520 616e give you an │ │ │ │ │ -00046180: 6420 7573 206d 7563 6820 6d6f 7265 2069 d us much more i │ │ │ │ │ -00046190: 6e66 6f72 6d61 7469 6f6e 206f 6e20 7468 nformation on th │ │ │ │ │ -000461a0: 6520 7072 6f62 6c65 6d2e 2020 4174 7461 e problem. Atta │ │ │ │ │ -000461b0: 6368 696e 6720 610a 2020 2020 2070 6174 ching a. pat │ │ │ │ │ -000461c0: 6368 2069 7320 6576 656e 2062 6574 7465 ch is even bette │ │ │ │ │ -000461d0: 722e 0a0a 2020 2020 2057 6865 6e20 796f r... When yo │ │ │ │ │ -000461e0: 7520 6174 7461 6368 2061 2070 6174 6368 u attach a patch │ │ │ │ │ -000461f0: 2c20 6d61 6b65 2074 6865 2070 6174 6368 , make the patch │ │ │ │ │ -00046200: 2069 6e20 756e 6966 6965 6420 6469 6666 in unified diff │ │ │ │ │ -00046210: 2066 6f72 6d61 742c 2061 6e64 0a20 2020 format, and. │ │ │ │ │ -00046220: 2020 7772 6974 6520 4368 616e 6765 4c6f write ChangeLo │ │ │ │ │ -00046230: 6720 656e 7472 6965 732e 2020 4275 742c g entries. But, │ │ │ │ │ -00046240: 2065 7665 6e20 7768 656e 2079 6f75 206d even when you m │ │ │ │ │ -00046250: 616b 6520 6120 7061 7463 682c 2064 6f6e ake a patch, don │ │ │ │ │ -00046260: 2774 0a20 2020 2020 666f 7267 6574 2074 't. forget t │ │ │ │ │ -00046270: 6f20 6578 706c 6169 6e20 7468 6520 7072 o explain the pr │ │ │ │ │ -00046280: 6f62 6c65 6d2c 2073 6f20 7468 6174 2077 oblem, so that w │ │ │ │ │ -00046290: 6520 6361 6e20 756e 6465 7273 7461 6e64 e can understand │ │ │ │ │ -000462a0: 2077 6861 7420 796f 7572 0a20 2020 2020 what your. │ │ │ │ │ -000462b0: 7061 7463 6820 6973 2066 6f72 2e0a 0a20 patch is for... │ │ │ │ │ -000462c0: 2037 2e20 5772 6974 6520 646f 776e 2061 7. Write down a │ │ │ │ │ -000462d0: 6e79 7468 696e 6720 7468 6174 2079 6f75 nything that you │ │ │ │ │ -000462e0: 2074 6869 6e6b 206d 6967 6874 2062 6520 think might be │ │ │ │ │ -000462f0: 7265 6c61 7465 642e 2020 506c 6561 7365 related. Please │ │ │ │ │ -00046300: 0a20 2020 2020 756e 6465 7273 7461 6e64 . understand │ │ │ │ │ -00046310: 2074 6861 7420 7765 206f 6674 656e 206e that we often n │ │ │ │ │ -00046320: 6565 6420 746f 2072 6570 726f 6475 6365 eed to reproduce │ │ │ │ │ -00046330: 2074 6865 2073 616d 6520 7072 6f62 6c65 the same proble │ │ │ │ │ -00046340: 6d20 796f 750a 2020 2020 2065 6e63 6f75 m you. encou │ │ │ │ │ -00046350: 6e74 6572 6564 2069 6e20 6f75 7220 656e ntered in our en │ │ │ │ │ -00046360: 7669 726f 6e6d 656e 742e 2020 536f 2079 vironment. So y │ │ │ │ │ -00046370: 6f75 7220 696e 666f 726d 6174 696f 6e20 our information │ │ │ │ │ -00046380: 7368 6f75 6c64 2062 650a 2020 2020 2073 should be. s │ │ │ │ │ -00046390: 7566 6669 6369 656e 7420 666f 7220 7573 ufficient for us │ │ │ │ │ -000463a0: 2074 6f20 646f 2074 6865 2073 616d 6520 to do the same │ │ │ │ │ -000463b0: 7468 696e 672d 2d44 6f6e 2774 2066 6f72 thing--Don't for │ │ │ │ │ -000463c0: 6765 7420 7468 6174 2077 6520 6361 6e6e get that we cann │ │ │ │ │ -000463d0: 6f74 0a20 2020 2020 7365 6520 796f 7572 ot. see your │ │ │ │ │ -000463e0: 2063 6f6d 7075 7465 7220 6469 7265 6374 computer direct │ │ │ │ │ -000463f0: 6c79 2e20 2049 6620 796f 7520 6172 6520 ly. If you are │ │ │ │ │ -00046400: 6e6f 7420 7375 7265 2077 6865 7468 6572 not sure whether │ │ │ │ │ -00046410: 2074 6f20 7374 6174 6520 610a 2020 2020 to state a. │ │ │ │ │ -00046420: 2066 6163 7420 6f72 206c 6561 7665 2069 fact or leave i │ │ │ │ │ -00046430: 7420 6f75 742c 2073 7461 7465 2069 7421 t out, state it! │ │ │ │ │ -00046440: 2020 5265 706f 7274 696e 6720 746f 6f20 Reporting too │ │ │ │ │ -00046450: 6d61 6e79 2074 6869 6e67 7320 6973 206d many things is m │ │ │ │ │ -00046460: 7563 680a 2020 2020 2062 6574 7465 7220 uch. better │ │ │ │ │ -00046470: 7468 616e 206f 6d69 7474 696e 6720 736f than omitting so │ │ │ │ │ -00046480: 6d65 7468 696e 6720 696d 706f 7274 616e mething importan │ │ │ │ │ -00046490: 742e 0a0a 2020 2049 6620 796f 7520 666f t... If you fo │ │ │ │ │ -000464a0: 6c6c 6f77 2074 6865 2067 7569 6465 6c69 llow the guideli │ │ │ │ │ -000464b0: 6e65 2061 626f 7665 2c20 7375 626d 6974 ne above, submit │ │ │ │ │ -000464c0: 2061 2072 6570 6f72 7420 746f 2074 6865 a report to the │ │ │ │ │ -000464d0: 2042 7567 0a54 7261 636b 696e 6720 5379 Bug.Tracking Sy │ │ │ │ │ -000464e0: 7374 656d 2028 6874 7470 3a2f 2f73 6176 stem (http://sav │ │ │ │ │ -000464f0: 616e 6e61 682e 676e 752e 6f72 672f 6275 annah.gnu.org/bu │ │ │ │ │ -00046500: 6773 2f3f 6772 6f75 703d 6772 7562 292e gs/?group=grub). │ │ │ │ │ -00046510: 0a41 6c74 6572 6e61 7469 7665 6c79 2c20 .Alternatively, │ │ │ │ │ -00046520: 796f 7520 6361 6e20 7375 626d 6974 2061 you can submit a │ │ │ │ │ -00046530: 2072 6570 6f72 7420 7669 6120 656c 6563 report via elec │ │ │ │ │ -00046540: 7472 6f6e 6963 206d 6169 6c20 746f 0a3c tronic mail to.< │ │ │ │ │ -00046550: 6275 672d 6772 7562 4067 6e75 2e6f 7267 bug-grub@gnu.org │ │ │ │ │ -00046560: 3e2c 2062 7574 2077 6520 7374 726f 6e67 >, but we strong │ │ │ │ │ -00046570: 6c79 2072 6563 6f6d 6d65 6e64 2074 6861 ly recommend tha │ │ │ │ │ -00046580: 7420 796f 7520 7573 6520 7468 6520 4275 t you use the Bu │ │ │ │ │ -00046590: 670a 5472 6163 6b69 6e67 2053 7973 7465 g.Tracking Syste │ │ │ │ │ -000465a0: 6d2c 2062 6563 6175 7365 2065 2d6d 6169 m, because e-mai │ │ │ │ │ -000465b0: 6c20 6361 6e20 6265 2070 6173 7365 6420 l can be passed │ │ │ │ │ -000465c0: 6f76 6572 2065 6173 696c 792e 0a0a 2020 over easily... │ │ │ │ │ -000465d0: 204f 6e63 6520 7765 2067 6574 2079 6f75 Once we get you │ │ │ │ │ -000465e0: 7220 7265 706f 7274 2c20 7765 2077 696c r report, we wil │ │ │ │ │ -000465f0: 6c20 7472 7920 746f 2066 6978 2074 6865 l try to fix the │ │ │ │ │ -00046600: 2062 7567 732e 0a0a 1f0a 4669 6c65 3a20 bugs.....File: │ │ │ │ │ -00046610: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ -00046620: 3a20 4675 7475 7265 2c20 204e 6578 743a : Future, Next: │ │ │ │ │ -00046630: 2043 6f70 7969 6e67 2054 6869 7320 4d61 Copying This Ma │ │ │ │ │ -00046640: 6e75 616c 2c20 2050 7265 763a 2052 6570 nual, Prev: Rep │ │ │ │ │ -00046650: 6f72 7469 6e67 2062 7567 732c 2020 5570 orting bugs, Up │ │ │ │ │ -00046660: 3a20 546f 700a 0a41 7070 656e 6469 7820 : Top..Appendix │ │ │ │ │ -00046670: 4320 5768 6572 6520 4752 5542 2077 696c C Where GRUB wil │ │ │ │ │ -00046680: 6c20 676f 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a l go.*********** │ │ │ │ │ +00045ba0: 0a0a 5468 6573 6520 6172 6520 7468 6520 ..These are the │ │ │ │ │ +00045bb0: 6775 6964 656c 696e 6520 666f 7220 686f guideline for ho │ │ │ │ │ +00045bc0: 7720 746f 2072 6570 6f72 7420 6275 6773 w to report bugs │ │ │ │ │ +00045bd0: 2e20 2054 616b 6520 6120 6c6f 6f6b 2061 . Take a look a │ │ │ │ │ +00045be0: 7420 7468 6973 0a6c 6973 7420 6265 6c6f t this.list belo │ │ │ │ │ +00045bf0: 7720 6265 666f 7265 2079 6f75 2073 7562 w before you sub │ │ │ │ │ +00045c00: 6d69 7420 6275 6773 3a0a 0a20 2031 2e20 mit bugs:.. 1. │ │ │ │ │ +00045c10: 4265 666f 7265 2067 6574 7469 6e67 2075 Before getting u │ │ │ │ │ +00045c20: 6e73 6574 746c 6564 2c20 7265 6164 2074 nsettled, read t │ │ │ │ │ +00045c30: 6869 7320 6d61 6e75 616c 2074 6872 6f75 his manual throu │ │ │ │ │ +00045c40: 6768 2061 6e64 2074 6872 6f75 6768 2e0a gh and through.. │ │ │ │ │ +00045c50: 2020 2020 2041 6c73 6f2c 2073 6565 2074 Also, see t │ │ │ │ │ +00045c60: 6865 2047 4e55 2047 5255 4220 4641 510a he GNU GRUB FAQ. │ │ │ │ │ +00045c70: 2020 2020 2028 6874 7470 3a2f 2f77 7777 (http://www │ │ │ │ │ +00045c80: 2e67 6e75 2e6f 7267 2f73 6f66 7477 6172 .gnu.org/softwar │ │ │ │ │ +00045c90: 652f 6772 7562 2f67 7275 622d 6661 712e e/grub/grub-faq. │ │ │ │ │ +00045ca0: 6874 6d6c 292e 0a0a 2020 322e 2041 6c77 html)... 2. Alw │ │ │ │ │ +00045cb0: 6179 7320 6d65 6e74 696f 6e20 7468 6520 ays mention the │ │ │ │ │ +00045cc0: 696e 666f 726d 6174 696f 6e20 6f6e 2079 information on y │ │ │ │ │ +00045cd0: 6f75 7220 4752 5542 2e20 5468 6520 7665 our GRUB. The ve │ │ │ │ │ +00045ce0: 7273 696f 6e20 6e75 6d62 6572 2061 6e64 rsion number and │ │ │ │ │ +00045cf0: 0a20 2020 2020 7468 6520 636f 6e66 6967 . the config │ │ │ │ │ +00045d00: 7572 6174 696f 6e20 6172 6520 7175 6974 uration are quit │ │ │ │ │ +00045d10: 6520 696d 706f 7274 616e 742e 2020 4966 e important. If │ │ │ │ │ +00045d20: 2079 6f75 2062 7569 6c64 2069 7420 796f you build it yo │ │ │ │ │ +00045d30: 7572 7365 6c66 2c0a 2020 2020 2077 7269 urself,. wri │ │ │ │ │ +00045d40: 7465 2074 6865 206f 7074 696f 6e73 2073 te the options s │ │ │ │ │ +00045d50: 7065 6369 6669 6564 2074 6f20 7468 6520 pecified to the │ │ │ │ │ +00045d60: 636f 6e66 6967 7572 6520 7363 7269 7074 configure script │ │ │ │ │ +00045d70: 2061 6e64 2079 6f75 720a 2020 2020 206f and your. o │ │ │ │ │ +00045d80: 7065 7261 7469 6e67 2073 7973 7465 6d2c perating system, │ │ │ │ │ +00045d90: 2069 6e63 6c75 6469 6e67 2074 6865 2076 including the v │ │ │ │ │ +00045da0: 6572 7369 6f6e 7320 6f66 2067 6363 2061 ersions of gcc a │ │ │ │ │ +00045db0: 6e64 2062 696e 7574 696c 732e 0a0a 2020 nd binutils... │ │ │ │ │ +00045dc0: 332e 2049 6620 796f 7520 6861 7665 2074 3. If you have t │ │ │ │ │ +00045dd0: 726f 7562 6c65 2077 6974 6820 7468 6520 rouble with the │ │ │ │ │ +00045de0: 696e 7374 616c 6c61 7469 6f6e 2c20 696e installation, in │ │ │ │ │ +00045df0: 666f 726d 2075 7320 6f66 2068 6f77 2079 form us of how y │ │ │ │ │ +00045e00: 6f75 0a20 2020 2020 696e 7374 616c 6c65 ou. installe │ │ │ │ │ +00045e10: 6420 4752 5542 2e20 446f 6e27 7420 6f6d d GRUB. Don't om │ │ │ │ │ +00045e20: 6974 2065 7272 6f72 206d 6573 7361 6765 it error message │ │ │ │ │ +00045e30: 732c 2069 6620 616e 792e 2020 4a75 7374 s, if any. Just │ │ │ │ │ +00045e40: 2027 4752 5542 0a20 2020 2020 6861 6e67 'GRUB. hang │ │ │ │ │ +00045e50: 7320 7570 2077 6865 6e20 6974 2062 6f6f s up when it boo │ │ │ │ │ +00045e60: 7473 2720 6973 206e 6f74 2065 6e6f 7567 ts' is not enoug │ │ │ │ │ +00045e70: 682e 0a0a 2020 2020 2054 6865 2069 6e66 h... The inf │ │ │ │ │ +00045e80: 6f72 6d61 7469 6f6e 206f 6e20 796f 7572 ormation on your │ │ │ │ │ +00045e90: 2068 6172 6477 6172 6520 6973 2061 6c73 hardware is als │ │ │ │ │ +00045ea0: 6f20 6573 7365 6e74 6961 6c2e 2020 5468 o essential. Th │ │ │ │ │ +00045eb0: 6573 6520 6172 650a 2020 2020 2065 7370 ese are. esp │ │ │ │ │ +00045ec0: 6563 6961 6c6c 7920 696d 706f 7274 616e ecially importan │ │ │ │ │ +00045ed0: 743a 2074 6865 2067 656f 6d65 7472 6965 t: the geometrie │ │ │ │ │ +00045ee0: 7320 616e 6420 7468 6520 7061 7274 6974 s and the partit │ │ │ │ │ +00045ef0: 696f 6e20 7461 626c 6573 206f 660a 2020 ion tables of. │ │ │ │ │ +00045f00: 2020 2079 6f75 7220 6861 7264 2064 6973 your hard dis │ │ │ │ │ +00045f10: 6b20 6472 6976 6573 2061 6e64 2079 6f75 k drives and you │ │ │ │ │ +00045f20: 7220 4249 4f53 2e0a 0a20 2034 2e20 4966 r BIOS... 4. If │ │ │ │ │ +00045f30: 2047 5255 4220 6361 6e6e 6f74 2062 6f6f GRUB cannot boo │ │ │ │ │ +00045f40: 7420 796f 7572 206f 7065 7261 7469 6e67 t your operating │ │ │ │ │ +00045f50: 2073 7973 7465 6d2c 2077 7269 7465 2064 system, write d │ │ │ │ │ +00045f60: 6f77 6e20 5f65 7665 7279 7468 696e 675f own _everything_ │ │ │ │ │ +00045f70: 0a20 2020 2020 796f 7520 7365 6520 6f6e . you see on │ │ │ │ │ +00045f80: 2074 6865 2073 6372 6565 6e2e 2020 446f the screen. Do │ │ │ │ │ +00045f90: 6e27 7420 7061 7261 7068 7261 7365 2074 n't paraphrase t │ │ │ │ │ +00045fa0: 6865 6d2c 206c 696b 6520 2754 6865 2066 hem, like 'The f │ │ │ │ │ +00045fb0: 6f6f 204f 530a 2020 2020 2063 7261 7368 oo OS. crash │ │ │ │ │ +00045fc0: 6573 2077 6974 6820 4752 5542 2c20 6576 es with GRUB, ev │ │ │ │ │ +00045fd0: 656e 2074 686f 7567 6820 6974 2063 616e en though it can │ │ │ │ │ +00045fe0: 2062 6f6f 7420 7769 7468 2074 6865 2062 boot with the b │ │ │ │ │ +00045ff0: 6172 2062 6f6f 7420 6c6f 6164 6572 0a20 ar boot loader. │ │ │ │ │ +00046000: 2020 2020 6a75 7374 2066 696e 6527 2e20 just fine'. │ │ │ │ │ +00046010: 204d 656e 7469 6f6e 2074 6865 2063 6f6d Mention the com │ │ │ │ │ +00046020: 6d61 6e64 7320 796f 7520 6578 6563 7574 mands you execut │ │ │ │ │ +00046030: 6564 2c20 7468 6520 6d65 7373 6167 6573 ed, the messages │ │ │ │ │ +00046040: 0a20 2020 2020 7072 696e 7465 6420 6279 . printed by │ │ │ │ │ +00046050: 2074 6865 6d2c 2061 6e64 2069 6e66 6f72 them, and infor │ │ │ │ │ +00046060: 6d61 7469 6f6e 206f 6e20 796f 7572 206f mation on your o │ │ │ │ │ +00046070: 7065 7261 7469 6e67 2073 7973 7465 6d20 perating system │ │ │ │ │ +00046080: 696e 636c 7564 696e 670a 2020 2020 2074 including. t │ │ │ │ │ +00046090: 6865 2076 6572 7369 6f6e 206e 756d 6265 he version numbe │ │ │ │ │ +000460a0: 722e 0a0a 2020 352e 2045 7870 6c61 696e r... 5. Explain │ │ │ │ │ +000460b0: 2077 6861 7420 796f 7520 7761 6e74 6564 what you wanted │ │ │ │ │ +000460c0: 2074 6f20 646f 2e20 2049 7420 6973 2076 to do. It is v │ │ │ │ │ +000460d0: 6572 7920 7573 6566 756c 2074 6f20 6b6e ery useful to kn │ │ │ │ │ +000460e0: 6f77 2079 6f75 720a 2020 2020 2070 7572 ow your. pur │ │ │ │ │ +000460f0: 706f 7365 2061 6e64 2079 6f75 7220 7769 pose and your wi │ │ │ │ │ +00046100: 7368 2c20 616e 6420 686f 7720 4752 5542 sh, and how GRUB │ │ │ │ │ +00046110: 2064 6964 6e27 7420 7361 7469 7366 7920 didn't satisfy │ │ │ │ │ +00046120: 796f 752e 0a0a 2020 362e 2049 6620 796f you... 6. If yo │ │ │ │ │ +00046130: 7520 6361 6e20 696e 7665 7374 6967 6174 u can investigat │ │ │ │ │ +00046140: 6520 7468 6520 7072 6f62 6c65 6d20 796f e the problem yo │ │ │ │ │ +00046150: 7572 7365 6c66 2c20 706c 6561 7365 2064 urself, please d │ │ │ │ │ +00046160: 6f2e 2020 5468 6174 2077 696c 6c0a 2020 o. That will. │ │ │ │ │ +00046170: 2020 2067 6976 6520 796f 7520 616e 6420 give you and │ │ │ │ │ +00046180: 7573 206d 7563 6820 6d6f 7265 2069 6e66 us much more inf │ │ │ │ │ +00046190: 6f72 6d61 7469 6f6e 206f 6e20 7468 6520 ormation on the │ │ │ │ │ +000461a0: 7072 6f62 6c65 6d2e 2020 4174 7461 6368 problem. Attach │ │ │ │ │ +000461b0: 696e 6720 610a 2020 2020 2070 6174 6368 ing a. patch │ │ │ │ │ +000461c0: 2069 7320 6576 656e 2062 6574 7465 722e is even better. │ │ │ │ │ +000461d0: 0a0a 2020 2020 2057 6865 6e20 796f 7520 .. When you │ │ │ │ │ +000461e0: 6174 7461 6368 2061 2070 6174 6368 2c20 attach a patch, │ │ │ │ │ +000461f0: 6d61 6b65 2074 6865 2070 6174 6368 2069 make the patch i │ │ │ │ │ +00046200: 6e20 756e 6966 6965 6420 6469 6666 2066 n unified diff f │ │ │ │ │ +00046210: 6f72 6d61 742c 2061 6e64 0a20 2020 2020 ormat, and. │ │ │ │ │ +00046220: 7772 6974 6520 4368 616e 6765 4c6f 6720 write ChangeLog │ │ │ │ │ +00046230: 656e 7472 6965 732e 2020 4275 742c 2065 entries. But, e │ │ │ │ │ +00046240: 7665 6e20 7768 656e 2079 6f75 206d 616b ven when you mak │ │ │ │ │ +00046250: 6520 6120 7061 7463 682c 2064 6f6e 2774 e a patch, don't │ │ │ │ │ +00046260: 0a20 2020 2020 666f 7267 6574 2074 6f20 . forget to │ │ │ │ │ +00046270: 6578 706c 6169 6e20 7468 6520 7072 6f62 explain the prob │ │ │ │ │ +00046280: 6c65 6d2c 2073 6f20 7468 6174 2077 6520 lem, so that we │ │ │ │ │ +00046290: 6361 6e20 756e 6465 7273 7461 6e64 2077 can understand w │ │ │ │ │ +000462a0: 6861 7420 796f 7572 0a20 2020 2020 7061 hat your. pa │ │ │ │ │ +000462b0: 7463 6820 6973 2066 6f72 2e0a 0a20 2037 tch is for... 7 │ │ │ │ │ +000462c0: 2e20 5772 6974 6520 646f 776e 2061 6e79 . Write down any │ │ │ │ │ +000462d0: 7468 696e 6720 7468 6174 2079 6f75 2074 thing that you t │ │ │ │ │ +000462e0: 6869 6e6b 206d 6967 6874 2062 6520 7265 hink might be re │ │ │ │ │ +000462f0: 6c61 7465 642e 2020 506c 6561 7365 0a20 lated. Please. │ │ │ │ │ +00046300: 2020 2020 756e 6465 7273 7461 6e64 2074 understand t │ │ │ │ │ +00046310: 6861 7420 7765 206f 6674 656e 206e 6565 hat we often nee │ │ │ │ │ +00046320: 6420 746f 2072 6570 726f 6475 6365 2074 d to reproduce t │ │ │ │ │ +00046330: 6865 2073 616d 6520 7072 6f62 6c65 6d20 he same problem │ │ │ │ │ +00046340: 796f 750a 2020 2020 2065 6e63 6f75 6e74 you. encount │ │ │ │ │ +00046350: 6572 6564 2069 6e20 6f75 7220 656e 7669 ered in our envi │ │ │ │ │ +00046360: 726f 6e6d 656e 742e 2020 536f 2079 6f75 ronment. So you │ │ │ │ │ +00046370: 7220 696e 666f 726d 6174 696f 6e20 7368 r information sh │ │ │ │ │ +00046380: 6f75 6c64 2062 650a 2020 2020 2073 7566 ould be. suf │ │ │ │ │ +00046390: 6669 6369 656e 7420 666f 7220 7573 2074 ficient for us t │ │ │ │ │ +000463a0: 6f20 646f 2074 6865 2073 616d 6520 7468 o do the same th │ │ │ │ │ +000463b0: 696e 672d 2d44 6f6e 2774 2066 6f72 6765 ing--Don't forge │ │ │ │ │ +000463c0: 7420 7468 6174 2077 6520 6361 6e6e 6f74 t that we cannot │ │ │ │ │ +000463d0: 0a20 2020 2020 7365 6520 796f 7572 2063 . see your c │ │ │ │ │ +000463e0: 6f6d 7075 7465 7220 6469 7265 6374 6c79 omputer directly │ │ │ │ │ +000463f0: 2e20 2049 6620 796f 7520 6172 6520 6e6f . If you are no │ │ │ │ │ +00046400: 7420 7375 7265 2077 6865 7468 6572 2074 t sure whether t │ │ │ │ │ +00046410: 6f20 7374 6174 6520 610a 2020 2020 2066 o state a. f │ │ │ │ │ +00046420: 6163 7420 6f72 206c 6561 7665 2069 7420 act or leave it │ │ │ │ │ +00046430: 6f75 742c 2073 7461 7465 2069 7421 2020 out, state it! │ │ │ │ │ +00046440: 5265 706f 7274 696e 6720 746f 6f20 6d61 Reporting too ma │ │ │ │ │ +00046450: 6e79 2074 6869 6e67 7320 6973 206d 7563 ny things is muc │ │ │ │ │ +00046460: 680a 2020 2020 2062 6574 7465 7220 7468 h. better th │ │ │ │ │ +00046470: 616e 206f 6d69 7474 696e 6720 736f 6d65 an omitting some │ │ │ │ │ +00046480: 7468 696e 6720 696d 706f 7274 616e 742e thing important. │ │ │ │ │ +00046490: 0a0a 2020 2049 6620 796f 7520 666f 6c6c .. If you foll │ │ │ │ │ +000464a0: 6f77 2074 6865 2067 7569 6465 6c69 6e65 ow the guideline │ │ │ │ │ +000464b0: 2061 626f 7665 2c20 7375 626d 6974 2061 above, submit a │ │ │ │ │ +000464c0: 2072 6570 6f72 7420 746f 2074 6865 2042 report to the B │ │ │ │ │ +000464d0: 7567 0a54 7261 636b 696e 6720 5379 7374 ug.Tracking Syst │ │ │ │ │ +000464e0: 656d 2028 6874 7470 3a2f 2f73 6176 616e em (http://savan │ │ │ │ │ +000464f0: 6e61 682e 676e 752e 6f72 672f 6275 6773 nah.gnu.org/bugs │ │ │ │ │ +00046500: 2f3f 6772 6f75 703d 6772 7562 292e 0a41 /?group=grub)..A │ │ │ │ │ +00046510: 6c74 6572 6e61 7469 7665 6c79 2c20 796f lternatively, yo │ │ │ │ │ +00046520: 7520 6361 6e20 7375 626d 6974 2061 2072 u can submit a r │ │ │ │ │ +00046530: 6570 6f72 7420 7669 6120 656c 6563 7472 eport via electr │ │ │ │ │ +00046540: 6f6e 6963 206d 6169 6c20 746f 0a3c 6275 onic mail to., │ │ │ │ │ +00046560: 2062 7574 2077 6520 7374 726f 6e67 6c79 but we strongly │ │ │ │ │ +00046570: 2072 6563 6f6d 6d65 6e64 2074 6861 7420 recommend that │ │ │ │ │ +00046580: 796f 7520 7573 6520 7468 6520 4275 670a you use the Bug. │ │ │ │ │ +00046590: 5472 6163 6b69 6e67 2053 7973 7465 6d2c Tracking System, │ │ │ │ │ +000465a0: 2062 6563 6175 7365 2065 2d6d 6169 6c20 because e-mail │ │ │ │ │ +000465b0: 6361 6e20 6265 2070 6173 7365 6420 6f76 can be passed ov │ │ │ │ │ +000465c0: 6572 2065 6173 696c 792e 0a0a 2020 204f er easily... O │ │ │ │ │ +000465d0: 6e63 6520 7765 2067 6574 2079 6f75 7220 nce we get your │ │ │ │ │ +000465e0: 7265 706f 7274 2c20 7765 2077 696c 6c20 report, we will │ │ │ │ │ +000465f0: 7472 7920 746f 2066 6978 2074 6865 2062 try to fix the b │ │ │ │ │ +00046600: 7567 732e 0a0a 1f0a 4669 6c65 3a20 6772 ugs.....File: gr │ │ │ │ │ +00046610: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ +00046620: 4675 7475 7265 2c20 204e 6578 743a 2043 Future, Next: C │ │ │ │ │ +00046630: 6f70 7969 6e67 2054 6869 7320 4d61 6e75 opying This Manu │ │ │ │ │ +00046640: 616c 2c20 2050 7265 763a 2052 6570 6f72 al, Prev: Repor │ │ │ │ │ +00046650: 7469 6e67 2062 7567 732c 2020 5570 3a20 ting bugs, Up: │ │ │ │ │ +00046660: 546f 700a 0a41 7070 656e 6469 7820 4320 Top..Appendix C │ │ │ │ │ +00046670: 5768 6572 6520 4752 5542 2077 696c 6c20 Where GRUB will │ │ │ │ │ +00046680: 676f 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a go.************* │ │ │ │ │ 00046690: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -000466a0: 2a2a 0a0a 4752 5542 2032 2069 7320 6e6f **..GRUB 2 is no │ │ │ │ │ -000466b0: 7720 7175 6974 6520 7374 6162 6c65 2061 w quite stable a │ │ │ │ │ -000466c0: 6e64 2075 7365 6420 696e 206d 616e 7920 nd used in many │ │ │ │ │ -000466d0: 7072 6f64 7563 7469 6f6e 2073 7973 7465 production syste │ │ │ │ │ -000466e0: 6d73 2e20 2057 6520 6172 650a 6375 7272 ms. We are.curr │ │ │ │ │ -000466f0: 656e 746c 7920 776f 726b 696e 6720 746f ently working to │ │ │ │ │ -00046700: 7761 7264 7320 6120 322e 3020 7265 6c65 wards a 2.0 rele │ │ │ │ │ -00046710: 6173 652e 0a0a 2020 2049 6620 796f 7520 ase... If you │ │ │ │ │ -00046720: 6172 6520 696e 7465 7265 7374 6564 2069 are interested i │ │ │ │ │ -00046730: 6e20 7468 6520 6465 7665 6c6f 706d 656e n the developmen │ │ │ │ │ -00046740: 7420 6f66 2047 5255 4220 322c 2074 616b t of GRUB 2, tak │ │ │ │ │ -00046750: 6520 6120 6c6f 6f6b 2061 740a 7468 6520 e a look at.the │ │ │ │ │ -00046760: 686f 6d65 7061 6765 2028 6874 7470 3a2f homepage (http:/ │ │ │ │ │ -00046770: 2f77 7777 2e67 6e75 2e6f 7267 2f73 6f66 /www.gnu.org/sof │ │ │ │ │ -00046780: 7477 6172 652f 6772 7562 2f67 7275 622e tware/grub/grub. │ │ │ │ │ -00046790: 6874 6d6c 292e 0a0a 1f0a 4669 6c65 3a20 html).....File: │ │ │ │ │ -000467a0: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ -000467b0: 3a20 436f 7079 696e 6720 5468 6973 204d : Copying This M │ │ │ │ │ -000467c0: 616e 7561 6c2c 2020 4e65 7874 3a20 496e anual, Next: In │ │ │ │ │ -000467d0: 6465 782c 2020 5072 6576 3a20 4675 7475 dex, Prev: Futu │ │ │ │ │ -000467e0: 7265 2c20 2055 703a 2054 6f70 0a0a 4170 re, Up: Top..Ap │ │ │ │ │ -000467f0: 7065 6e64 6978 2044 2043 6f70 7969 6e67 pendix D Copying │ │ │ │ │ -00046800: 2054 6869 7320 4d61 6e75 616c 0a2a 2a2a This Manual.*** │ │ │ │ │ +000466a0: 0a0a 4752 5542 2032 2069 7320 6e6f 7720 ..GRUB 2 is now │ │ │ │ │ +000466b0: 7175 6974 6520 7374 6162 6c65 2061 6e64 quite stable and │ │ │ │ │ +000466c0: 2075 7365 6420 696e 206d 616e 7920 7072 used in many pr │ │ │ │ │ +000466d0: 6f64 7563 7469 6f6e 2073 7973 7465 6d73 oduction systems │ │ │ │ │ +000466e0: 2e20 2057 6520 6172 650a 6375 7272 656e . We are.curren │ │ │ │ │ +000466f0: 746c 7920 776f 726b 696e 6720 746f 7761 tly working towa │ │ │ │ │ +00046700: 7264 7320 6120 322e 3020 7265 6c65 6173 rds a 2.0 releas │ │ │ │ │ +00046710: 652e 0a0a 2020 2049 6620 796f 7520 6172 e... If you ar │ │ │ │ │ +00046720: 6520 696e 7465 7265 7374 6564 2069 6e20 e interested in │ │ │ │ │ +00046730: 7468 6520 6465 7665 6c6f 706d 656e 7420 the development │ │ │ │ │ +00046740: 6f66 2047 5255 4220 322c 2074 616b 6520 of GRUB 2, take │ │ │ │ │ +00046750: 6120 6c6f 6f6b 2061 740a 7468 6520 686f a look at.the ho │ │ │ │ │ +00046760: 6d65 7061 6765 2028 6874 7470 3a2f 2f77 mepage (http://w │ │ │ │ │ +00046770: 7777 2e67 6e75 2e6f 7267 2f73 6f66 7477 ww.gnu.org/softw │ │ │ │ │ +00046780: 6172 652f 6772 7562 2f67 7275 622e 6874 are/grub/grub.ht │ │ │ │ │ +00046790: 6d6c 292e 0a0a 1f0a 4669 6c65 3a20 6772 ml).....File: gr │ │ │ │ │ +000467a0: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ +000467b0: 436f 7079 696e 6720 5468 6973 204d 616e Copying This Man │ │ │ │ │ +000467c0: 7561 6c2c 2020 4e65 7874 3a20 496e 6465 ual, Next: Inde │ │ │ │ │ +000467d0: 782c 2020 5072 6576 3a20 4675 7475 7265 x, Prev: Future │ │ │ │ │ +000467e0: 2c20 2055 703a 2054 6f70 0a0a 4170 7065 , Up: Top..Appe │ │ │ │ │ +000467f0: 6e64 6978 2044 2043 6f70 7969 6e67 2054 ndix D Copying T │ │ │ │ │ +00046800: 6869 7320 4d61 6e75 616c 0a2a 2a2a 2a2a his Manual.***** │ │ │ │ │ 00046810: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -00046820: 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a2a 204d ***********..* M │ │ │ │ │ -00046830: 656e 753a 0a0a 2a20 474e 5520 4672 6565 enu:..* GNU Free │ │ │ │ │ -00046840: 2044 6f63 756d 656e 7461 7469 6f6e 204c Documentation L │ │ │ │ │ -00046850: 6963 656e 7365 3a3a 2020 4c69 6365 6e73 icense:: Licens │ │ │ │ │ -00046860: 6520 666f 7220 636f 7079 696e 6720 7468 e for copying th │ │ │ │ │ -00046870: 6973 206d 616e 7561 6c2e 0a0a 1f0a 4669 is manual.....Fi │ │ │ │ │ -00046880: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ -00046890: 4e6f 6465 3a20 474e 5520 4672 6565 2044 Node: GNU Free D │ │ │ │ │ -000468a0: 6f63 756d 656e 7461 7469 6f6e 204c 6963 ocumentation Lic │ │ │ │ │ -000468b0: 656e 7365 2c20 2055 703a 2043 6f70 7969 ense, Up: Copyi │ │ │ │ │ -000468c0: 6e67 2054 6869 7320 4d61 6e75 616c 0a0a ng This Manual.. │ │ │ │ │ -000468d0: 442e 3120 474e 5520 4672 6565 2044 6f63 D.1 GNU Free Doc │ │ │ │ │ -000468e0: 756d 656e 7461 7469 6f6e 204c 6963 656e umentation Licen │ │ │ │ │ -000468f0: 7365 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d se.============= │ │ │ │ │ +00046820: 2a2a 2a2a 2a2a 2a2a 2a0a 0a2a 204d 656e *********..* Men │ │ │ │ │ +00046830: 753a 0a0a 2a20 474e 5520 4672 6565 2044 u:..* GNU Free D │ │ │ │ │ +00046840: 6f63 756d 656e 7461 7469 6f6e 204c 6963 ocumentation Lic │ │ │ │ │ +00046850: 656e 7365 3a3a 2020 4c69 6365 6e73 6520 ense:: License │ │ │ │ │ +00046860: 666f 7220 636f 7079 696e 6720 7468 6973 for copying this │ │ │ │ │ +00046870: 206d 616e 7561 6c2e 0a0a 1f0a 4669 6c65 manual.....File │ │ │ │ │ +00046880: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ +00046890: 6465 3a20 474e 5520 4672 6565 2044 6f63 de: GNU Free Doc │ │ │ │ │ +000468a0: 756d 656e 7461 7469 6f6e 204c 6963 656e umentation Licen │ │ │ │ │ +000468b0: 7365 2c20 2055 703a 2043 6f70 7969 6e67 se, Up: Copying │ │ │ │ │ +000468c0: 2054 6869 7320 4d61 6e75 616c 0a0a 442e This Manual..D. │ │ │ │ │ +000468d0: 3120 474e 5520 4672 6565 2044 6f63 756d 1 GNU Free Docum │ │ │ │ │ +000468e0: 656e 7461 7469 6f6e 204c 6963 656e 7365 entation License │ │ │ │ │ +000468f0: 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d .=============== │ │ │ │ │ 00046900: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00046910: 3d3d 3d3d 3d0a 0a20 2020 2020 2020 2020 =====.. │ │ │ │ │ -00046920: 2020 2020 2020 2020 2020 2020 2056 6572 Ver │ │ │ │ │ -00046930: 7369 6f6e 2031 2e32 2c20 4e6f 7665 6d62 sion 1.2, Novemb │ │ │ │ │ -00046940: 6572 2032 3030 320a 0a20 2020 2020 436f er 2002.. Co │ │ │ │ │ -00046950: 7079 7269 6768 7420 2843 2920 3230 3030 pyright (C) 2000 │ │ │ │ │ -00046960: 2c32 3030 312c 3230 3032 2046 7265 6520 ,2001,2002 Free │ │ │ │ │ -00046970: 536f 6674 7761 7265 2046 6f75 6e64 6174 Software Foundat │ │ │ │ │ -00046980: 696f 6e2c 2049 6e63 2e0a 2020 2020 2035 ion, Inc.. 5 │ │ │ │ │ -00046990: 3120 4672 616e 6b6c 696e 2053 742c 2046 1 Franklin St, F │ │ │ │ │ -000469a0: 6966 7468 2046 6c6f 6f72 2c20 426f 7374 ifth Floor, Bost │ │ │ │ │ -000469b0: 6f6e 2c20 4d41 2020 3032 3131 302d 3133 on, MA 02110-13 │ │ │ │ │ -000469c0: 3031 2c20 5553 410a 0a20 2020 2020 4576 01, USA.. Ev │ │ │ │ │ -000469d0: 6572 796f 6e65 2069 7320 7065 726d 6974 eryone is permit │ │ │ │ │ -000469e0: 7465 6420 746f 2063 6f70 7920 616e 6420 ted to copy and │ │ │ │ │ -000469f0: 6469 7374 7269 6275 7465 2076 6572 6261 distribute verba │ │ │ │ │ -00046a00: 7469 6d20 636f 7069 6573 0a20 2020 2020 tim copies. │ │ │ │ │ -00046a10: 6f66 2074 6869 7320 6c69 6365 6e73 6520 of this license │ │ │ │ │ -00046a20: 646f 6375 6d65 6e74 2c20 6275 7420 6368 document, but ch │ │ │ │ │ -00046a30: 616e 6769 6e67 2069 7420 6973 206e 6f74 anging it is not │ │ │ │ │ -00046a40: 2061 6c6c 6f77 6564 2e0a 0a20 2030 2e20 allowed... 0. │ │ │ │ │ -00046a50: 5052 4541 4d42 4c45 0a0a 2020 2020 2054 PREAMBLE.. T │ │ │ │ │ -00046a60: 6865 2070 7572 706f 7365 206f 6620 7468 he purpose of th │ │ │ │ │ -00046a70: 6973 204c 6963 656e 7365 2069 7320 746f is License is to │ │ │ │ │ -00046a80: 206d 616b 6520 6120 6d61 6e75 616c 2c20 make a manual, │ │ │ │ │ -00046a90: 7465 7874 626f 6f6b 2c20 6f72 206f 7468 textbook, or oth │ │ │ │ │ -00046aa0: 6572 0a20 2020 2020 6675 6e63 7469 6f6e er. function │ │ │ │ │ -00046ab0: 616c 2061 6e64 2075 7365 6675 6c20 646f al and useful do │ │ │ │ │ -00046ac0: 6375 6d65 6e74 2022 6672 6565 2220 696e cument "free" in │ │ │ │ │ -00046ad0: 2074 6865 2073 656e 7365 206f 6620 6672 the sense of fr │ │ │ │ │ -00046ae0: 6565 646f 6d3a 2074 6f0a 2020 2020 2061 eedom: to. a │ │ │ │ │ -00046af0: 7373 7572 6520 6576 6572 796f 6e65 2074 ssure everyone t │ │ │ │ │ -00046b00: 6865 2065 6666 6563 7469 7665 2066 7265 he effective fre │ │ │ │ │ -00046b10: 6564 6f6d 2074 6f20 636f 7079 2061 6e64 edom to copy and │ │ │ │ │ -00046b20: 2072 6564 6973 7472 6962 7574 6520 6974 redistribute it │ │ │ │ │ -00046b30: 2c0a 2020 2020 2077 6974 6820 6f72 2077 ,. with or w │ │ │ │ │ -00046b40: 6974 686f 7574 206d 6f64 6966 7969 6e67 ithout modifying │ │ │ │ │ -00046b50: 2069 742c 2065 6974 6865 7220 636f 6d6d it, either comm │ │ │ │ │ -00046b60: 6572 6369 616c 6c79 206f 720a 2020 2020 ercially or. │ │ │ │ │ -00046b70: 206e 6f6e 636f 6d6d 6572 6369 616c 6c79 noncommercially │ │ │ │ │ -00046b80: 2e20 2053 6563 6f6e 6461 7269 6c79 2c20 . Secondarily, │ │ │ │ │ -00046b90: 7468 6973 204c 6963 656e 7365 2070 7265 this License pre │ │ │ │ │ -00046ba0: 7365 7276 6573 2066 6f72 2074 6865 0a20 serves for the. │ │ │ │ │ -00046bb0: 2020 2020 6175 7468 6f72 2061 6e64 2070 author and p │ │ │ │ │ -00046bc0: 7562 6c69 7368 6572 2061 2077 6179 2074 ublisher a way t │ │ │ │ │ -00046bd0: 6f20 6765 7420 6372 6564 6974 2066 6f72 o get credit for │ │ │ │ │ -00046be0: 2074 6865 6972 2077 6f72 6b2c 2077 6869 their work, whi │ │ │ │ │ -00046bf0: 6c65 206e 6f74 0a20 2020 2020 6265 696e le not. bein │ │ │ │ │ -00046c00: 6720 636f 6e73 6964 6572 6564 2072 6573 g considered res │ │ │ │ │ -00046c10: 706f 6e73 6962 6c65 2066 6f72 206d 6f64 ponsible for mod │ │ │ │ │ -00046c20: 6966 6963 6174 696f 6e73 206d 6164 6520 ifications made │ │ │ │ │ -00046c30: 6279 206f 7468 6572 732e 0a0a 2020 2020 by others... │ │ │ │ │ -00046c40: 2054 6869 7320 4c69 6365 6e73 6520 6973 This License is │ │ │ │ │ -00046c50: 2061 206b 696e 6420 6f66 2022 636f 7079 a kind of "copy │ │ │ │ │ -00046c60: 6c65 6674 222c 2077 6869 6368 206d 6561 left", which mea │ │ │ │ │ -00046c70: 6e73 2074 6861 7420 6465 7269 7661 7469 ns that derivati │ │ │ │ │ -00046c80: 7665 0a20 2020 2020 776f 726b 7320 6f66 ve. works of │ │ │ │ │ -00046c90: 2074 6865 2064 6f63 756d 656e 7420 6d75 the document mu │ │ │ │ │ -00046ca0: 7374 2074 6865 6d73 656c 7665 7320 6265 st themselves be │ │ │ │ │ -00046cb0: 2066 7265 6520 696e 2074 6865 2073 616d free in the sam │ │ │ │ │ -00046cc0: 6520 7365 6e73 652e 0a20 2020 2020 4974 e sense.. It │ │ │ │ │ -00046cd0: 2063 6f6d 706c 656d 656e 7473 2074 6865 complements the │ │ │ │ │ -00046ce0: 2047 4e55 2047 656e 6572 616c 2050 7562 GNU General Pub │ │ │ │ │ -00046cf0: 6c69 6320 4c69 6365 6e73 652c 2077 6869 lic License, whi │ │ │ │ │ -00046d00: 6368 2069 7320 6120 636f 7079 6c65 6674 ch is a copyleft │ │ │ │ │ -00046d10: 0a20 2020 2020 6c69 6365 6e73 6520 6465 . license de │ │ │ │ │ -00046d20: 7369 676e 6564 2066 6f72 2066 7265 6520 signed for free │ │ │ │ │ -00046d30: 736f 6674 7761 7265 2e0a 0a20 2020 2020 software... │ │ │ │ │ -00046d40: 5765 2068 6176 6520 6465 7369 676e 6564 We have designed │ │ │ │ │ -00046d50: 2074 6869 7320 4c69 6365 6e73 6520 696e this License in │ │ │ │ │ -00046d60: 206f 7264 6572 2074 6f20 7573 6520 6974 order to use it │ │ │ │ │ -00046d70: 2066 6f72 206d 616e 7561 6c73 2066 6f72 for manuals for │ │ │ │ │ -00046d80: 0a20 2020 2020 6672 6565 2073 6f66 7477 . free softw │ │ │ │ │ -00046d90: 6172 652c 2062 6563 6175 7365 2066 7265 are, because fre │ │ │ │ │ -00046da0: 6520 736f 6674 7761 7265 206e 6565 6473 e software needs │ │ │ │ │ -00046db0: 2066 7265 6520 646f 6375 6d65 6e74 6174 free documentat │ │ │ │ │ -00046dc0: 696f 6e3a 2061 0a20 2020 2020 6672 6565 ion: a. free │ │ │ │ │ -00046dd0: 2070 726f 6772 616d 2073 686f 756c 6420 program should │ │ │ │ │ -00046de0: 636f 6d65 2077 6974 6820 6d61 6e75 616c come with manual │ │ │ │ │ -00046df0: 7320 7072 6f76 6964 696e 6720 7468 6520 s providing the │ │ │ │ │ -00046e00: 7361 6d65 2066 7265 6564 6f6d 730a 2020 same freedoms. │ │ │ │ │ -00046e10: 2020 2074 6861 7420 7468 6520 736f 6674 that the soft │ │ │ │ │ -00046e20: 7761 7265 2064 6f65 732e 2020 4275 7420 ware does. But │ │ │ │ │ -00046e30: 7468 6973 204c 6963 656e 7365 2069 7320 this License is │ │ │ │ │ -00046e40: 6e6f 7420 6c69 6d69 7465 6420 746f 0a20 not limited to. │ │ │ │ │ -00046e50: 2020 2020 736f 6674 7761 7265 206d 616e software man │ │ │ │ │ -00046e60: 7561 6c73 3b20 6974 2063 616e 2062 6520 uals; it can be │ │ │ │ │ -00046e70: 7573 6564 2066 6f72 2061 6e79 2074 6578 used for any tex │ │ │ │ │ -00046e80: 7475 616c 2077 6f72 6b2c 2072 6567 6172 tual work, regar │ │ │ │ │ -00046e90: 646c 6573 730a 2020 2020 206f 6620 7375 dless. of su │ │ │ │ │ -00046ea0: 626a 6563 7420 6d61 7474 6572 206f 7220 bject matter or │ │ │ │ │ -00046eb0: 7768 6574 6865 7220 6974 2069 7320 7075 whether it is pu │ │ │ │ │ -00046ec0: 626c 6973 6865 6420 6173 2061 2070 7269 blished as a pri │ │ │ │ │ -00046ed0: 6e74 6564 2062 6f6f 6b2e 2020 5765 0a20 nted book. We. │ │ │ │ │ -00046ee0: 2020 2020 7265 636f 6d6d 656e 6420 7468 recommend th │ │ │ │ │ -00046ef0: 6973 204c 6963 656e 7365 2070 7269 6e63 is License princ │ │ │ │ │ -00046f00: 6970 616c 6c79 2066 6f72 2077 6f72 6b73 ipally for works │ │ │ │ │ -00046f10: 2077 686f 7365 2070 7572 706f 7365 2069 whose purpose i │ │ │ │ │ -00046f20: 730a 2020 2020 2069 6e73 7472 7563 7469 s. instructi │ │ │ │ │ -00046f30: 6f6e 206f 7220 7265 6665 7265 6e63 652e on or reference. │ │ │ │ │ -00046f40: 0a0a 2020 312e 2041 5050 4c49 4341 4249 .. 1. APPLICABI │ │ │ │ │ -00046f50: 4c49 5459 2041 4e44 2044 4546 494e 4954 LITY AND DEFINIT │ │ │ │ │ -00046f60: 494f 4e53 0a0a 2020 2020 2054 6869 7320 IONS.. This │ │ │ │ │ -00046f70: 4c69 6365 6e73 6520 6170 706c 6965 7320 License applies │ │ │ │ │ -00046f80: 746f 2061 6e79 206d 616e 7561 6c20 6f72 to any manual or │ │ │ │ │ -00046f90: 206f 7468 6572 2077 6f72 6b2c 2069 6e20 other work, in │ │ │ │ │ -00046fa0: 616e 7920 6d65 6469 756d 2c0a 2020 2020 any medium,. │ │ │ │ │ -00046fb0: 2074 6861 7420 636f 6e74 6169 6e73 2061 that contains a │ │ │ │ │ -00046fc0: 206e 6f74 6963 6520 706c 6163 6564 2062 notice placed b │ │ │ │ │ -00046fd0: 7920 7468 6520 636f 7079 7269 6768 7420 y the copyright │ │ │ │ │ -00046fe0: 686f 6c64 6572 2073 6179 696e 6720 6974 holder saying it │ │ │ │ │ -00046ff0: 2063 616e 0a20 2020 2020 6265 2064 6973 can. be dis │ │ │ │ │ -00047000: 7472 6962 7574 6564 2075 6e64 6572 2074 tributed under t │ │ │ │ │ -00047010: 6865 2074 6572 6d73 206f 6620 7468 6973 he terms of this │ │ │ │ │ -00047020: 204c 6963 656e 7365 2e20 2053 7563 6820 License. Such │ │ │ │ │ -00047030: 6120 6e6f 7469 6365 0a20 2020 2020 6772 a notice. gr │ │ │ │ │ -00047040: 616e 7473 2061 2077 6f72 6c64 2d77 6964 ants a world-wid │ │ │ │ │ -00047050: 652c 2072 6f79 616c 7479 2d66 7265 6520 e, royalty-free │ │ │ │ │ -00047060: 6c69 6365 6e73 652c 2075 6e6c 696d 6974 license, unlimit │ │ │ │ │ -00047070: 6564 2069 6e20 6475 7261 7469 6f6e 2c0a ed in duration,. │ │ │ │ │ -00047080: 2020 2020 2074 6f20 7573 6520 7468 6174 to use that │ │ │ │ │ -00047090: 2077 6f72 6b20 756e 6465 7220 7468 6520 work under the │ │ │ │ │ -000470a0: 636f 6e64 6974 696f 6e73 2073 7461 7465 conditions state │ │ │ │ │ -000470b0: 6420 6865 7265 696e 2e20 2054 6865 0a20 d herein. The. │ │ │ │ │ -000470c0: 2020 2020 2244 6f63 756d 656e 7422 2c20 "Document", │ │ │ │ │ -000470d0: 6265 6c6f 772c 2072 6566 6572 7320 746f below, refers to │ │ │ │ │ -000470e0: 2061 6e79 2073 7563 6820 6d61 6e75 616c any such manual │ │ │ │ │ -000470f0: 206f 7220 776f 726b 2e20 2041 6e79 206d or work. Any m │ │ │ │ │ -00047100: 656d 6265 720a 2020 2020 206f 6620 7468 ember. of th │ │ │ │ │ -00047110: 6520 7075 626c 6963 2069 7320 6120 6c69 e public is a li │ │ │ │ │ -00047120: 6365 6e73 6565 2c20 616e 6420 6973 2061 censee, and is a │ │ │ │ │ -00047130: 6464 7265 7373 6564 2061 7320 2279 6f75 ddressed as "you │ │ │ │ │ -00047140: 222e 2020 596f 7520 6163 6365 7074 0a20 ". You accept. │ │ │ │ │ -00047150: 2020 2020 7468 6520 6c69 6365 6e73 6520 the license │ │ │ │ │ -00047160: 6966 2079 6f75 2063 6f70 792c 206d 6f64 if you copy, mod │ │ │ │ │ -00047170: 6966 7920 6f72 2064 6973 7472 6962 7574 ify or distribut │ │ │ │ │ -00047180: 6520 7468 6520 776f 726b 2069 6e20 6120 e the work in a │ │ │ │ │ -00047190: 7761 790a 2020 2020 2072 6571 7569 7269 way. requiri │ │ │ │ │ -000471a0: 6e67 2070 6572 6d69 7373 696f 6e20 756e ng permission un │ │ │ │ │ -000471b0: 6465 7220 636f 7079 7269 6768 7420 6c61 der copyright la │ │ │ │ │ -000471c0: 772e 0a0a 2020 2020 2041 2022 4d6f 6469 w... A "Modi │ │ │ │ │ -000471d0: 6669 6564 2056 6572 7369 6f6e 2220 6f66 fied Version" of │ │ │ │ │ -000471e0: 2074 6865 2044 6f63 756d 656e 7420 6d65 the Document me │ │ │ │ │ -000471f0: 616e 7320 616e 7920 776f 726b 2063 6f6e ans any work con │ │ │ │ │ -00047200: 7461 696e 696e 6720 7468 650a 2020 2020 taining the. │ │ │ │ │ -00047210: 2044 6f63 756d 656e 7420 6f72 2061 2070 Document or a p │ │ │ │ │ -00047220: 6f72 7469 6f6e 206f 6620 6974 2c20 6569 ortion of it, ei │ │ │ │ │ -00047230: 7468 6572 2063 6f70 6965 6420 7665 7262 ther copied verb │ │ │ │ │ -00047240: 6174 696d 2c20 6f72 2077 6974 680a 2020 atim, or with. │ │ │ │ │ -00047250: 2020 206d 6f64 6966 6963 6174 696f 6e73 modifications │ │ │ │ │ -00047260: 2061 6e64 2f6f 7220 7472 616e 736c 6174 and/or translat │ │ │ │ │ -00047270: 6564 2069 6e74 6f20 616e 6f74 6865 7220 ed into another │ │ │ │ │ -00047280: 6c61 6e67 7561 6765 2e0a 0a20 2020 2020 language... │ │ │ │ │ -00047290: 4120 2253 6563 6f6e 6461 7279 2053 6563 A "Secondary Sec │ │ │ │ │ -000472a0: 7469 6f6e 2220 6973 2061 206e 616d 6564 tion" is a named │ │ │ │ │ -000472b0: 2061 7070 656e 6469 7820 6f72 2061 2066 appendix or a f │ │ │ │ │ -000472c0: 726f 6e74 2d6d 6174 7465 7220 7365 6374 ront-matter sect │ │ │ │ │ -000472d0: 696f 6e0a 2020 2020 206f 6620 7468 6520 ion. of the │ │ │ │ │ -000472e0: 446f 6375 6d65 6e74 2074 6861 7420 6465 Document that de │ │ │ │ │ -000472f0: 616c 7320 6578 636c 7573 6976 656c 7920 als exclusively │ │ │ │ │ -00047300: 7769 7468 2074 6865 2072 656c 6174 696f with the relatio │ │ │ │ │ -00047310: 6e73 6869 7020 6f66 2074 6865 0a20 2020 nship of the. │ │ │ │ │ -00047320: 2020 7075 626c 6973 6865 7273 206f 7220 publishers or │ │ │ │ │ -00047330: 6175 7468 6f72 7320 6f66 2074 6865 2044 authors of the D │ │ │ │ │ -00047340: 6f63 756d 656e 7420 746f 2074 6865 2044 ocument to the D │ │ │ │ │ -00047350: 6f63 756d 656e 7427 7320 6f76 6572 616c ocument's overal │ │ │ │ │ -00047360: 6c0a 2020 2020 2073 7562 6a65 6374 2028 l. subject ( │ │ │ │ │ -00047370: 6f72 2074 6f20 7265 6c61 7465 6420 6d61 or to related ma │ │ │ │ │ -00047380: 7474 6572 7329 2061 6e64 2063 6f6e 7461 tters) and conta │ │ │ │ │ -00047390: 696e 7320 6e6f 7468 696e 6720 7468 6174 ins nothing that │ │ │ │ │ -000473a0: 2063 6f75 6c64 0a20 2020 2020 6661 6c6c could. fall │ │ │ │ │ -000473b0: 2064 6972 6563 746c 7920 7769 7468 696e directly within │ │ │ │ │ -000473c0: 2074 6861 7420 6f76 6572 616c 6c20 7375 that overall su │ │ │ │ │ -000473d0: 626a 6563 742e 2020 2854 6875 732c 2069 bject. (Thus, i │ │ │ │ │ -000473e0: 6620 7468 6520 446f 6375 6d65 6e74 0a20 f the Document. │ │ │ │ │ -000473f0: 2020 2020 6973 2069 6e20 7061 7274 2061 is in part a │ │ │ │ │ -00047400: 2074 6578 7462 6f6f 6b20 6f66 206d 6174 textbook of mat │ │ │ │ │ -00047410: 6865 6d61 7469 6373 2c20 6120 5365 636f hematics, a Seco │ │ │ │ │ -00047420: 6e64 6172 7920 5365 6374 696f 6e20 6d61 ndary Section ma │ │ │ │ │ -00047430: 7920 6e6f 740a 2020 2020 2065 7870 6c61 y not. expla │ │ │ │ │ -00047440: 696e 2061 6e79 206d 6174 6865 6d61 7469 in any mathemati │ │ │ │ │ -00047450: 6373 2e29 2020 5468 6520 7265 6c61 7469 cs.) The relati │ │ │ │ │ -00047460: 6f6e 7368 6970 2063 6f75 6c64 2062 6520 onship could be │ │ │ │ │ -00047470: 6120 6d61 7474 6572 206f 660a 2020 2020 a matter of. │ │ │ │ │ -00047480: 2068 6973 746f 7269 6361 6c20 636f 6e6e historical conn │ │ │ │ │ -00047490: 6563 7469 6f6e 2077 6974 6820 7468 6520 ection with the │ │ │ │ │ -000474a0: 7375 626a 6563 7420 6f72 2077 6974 6820 subject or with │ │ │ │ │ -000474b0: 7265 6c61 7465 6420 6d61 7474 6572 732c related matters, │ │ │ │ │ -000474c0: 206f 720a 2020 2020 206f 6620 6c65 6761 or. of lega │ │ │ │ │ -000474d0: 6c2c 2063 6f6d 6d65 7263 6961 6c2c 2070 l, commercial, p │ │ │ │ │ -000474e0: 6869 6c6f 736f 7068 6963 616c 2c20 6574 hilosophical, et │ │ │ │ │ -000474f0: 6869 6361 6c20 6f72 2070 6f6c 6974 6963 hical or politic │ │ │ │ │ -00047500: 616c 2070 6f73 6974 696f 6e0a 2020 2020 al position. │ │ │ │ │ -00047510: 2072 6567 6172 6469 6e67 2074 6865 6d2e regarding them. │ │ │ │ │ -00047520: 0a0a 2020 2020 2054 6865 2022 496e 7661 .. The "Inva │ │ │ │ │ -00047530: 7269 616e 7420 5365 6374 696f 6e73 2220 riant Sections" │ │ │ │ │ -00047540: 6172 6520 6365 7274 6169 6e20 5365 636f are certain Seco │ │ │ │ │ -00047550: 6e64 6172 7920 5365 6374 696f 6e73 2077 ndary Sections w │ │ │ │ │ -00047560: 686f 7365 0a20 2020 2020 7469 746c 6573 hose. titles │ │ │ │ │ -00047570: 2061 7265 2064 6573 6967 6e61 7465 642c are designated, │ │ │ │ │ -00047580: 2061 7320 6265 696e 6720 7468 6f73 6520 as being those │ │ │ │ │ -00047590: 6f66 2049 6e76 6172 6961 6e74 2053 6563 of Invariant Sec │ │ │ │ │ -000475a0: 7469 6f6e 732c 2069 6e20 7468 650a 2020 tions, in the. │ │ │ │ │ -000475b0: 2020 206e 6f74 6963 6520 7468 6174 2073 notice that s │ │ │ │ │ -000475c0: 6179 7320 7468 6174 2074 6865 2044 6f63 ays that the Doc │ │ │ │ │ -000475d0: 756d 656e 7420 6973 2072 656c 6561 7365 ument is release │ │ │ │ │ -000475e0: 6420 756e 6465 7220 7468 6973 204c 6963 d under this Lic │ │ │ │ │ -000475f0: 656e 7365 2e0a 2020 2020 2049 6620 6120 ense.. If a │ │ │ │ │ -00047600: 7365 6374 696f 6e20 646f 6573 206e 6f74 section does not │ │ │ │ │ -00047610: 2066 6974 2074 6865 2061 626f 7665 2064 fit the above d │ │ │ │ │ -00047620: 6566 696e 6974 696f 6e20 6f66 2053 6563 efinition of Sec │ │ │ │ │ -00047630: 6f6e 6461 7279 2074 6865 6e20 6974 0a20 ondary then it. │ │ │ │ │ -00047640: 2020 2020 6973 206e 6f74 2061 6c6c 6f77 is not allow │ │ │ │ │ -00047650: 6564 2074 6f20 6265 2064 6573 6967 6e61 ed to be designa │ │ │ │ │ -00047660: 7465 6420 6173 2049 6e76 6172 6961 6e74 ted as Invariant │ │ │ │ │ -00047670: 2e20 2054 6865 2044 6f63 756d 656e 7420 . The Document │ │ │ │ │ -00047680: 6d61 790a 2020 2020 2063 6f6e 7461 696e may. contain │ │ │ │ │ -00047690: 207a 6572 6f20 496e 7661 7269 616e 7420 zero Invariant │ │ │ │ │ -000476a0: 5365 6374 696f 6e73 2e20 2049 6620 7468 Sections. If th │ │ │ │ │ -000476b0: 6520 446f 6375 6d65 6e74 2064 6f65 7320 e Document does │ │ │ │ │ -000476c0: 6e6f 7420 6964 656e 7469 6679 0a20 2020 not identify. │ │ │ │ │ -000476d0: 2020 616e 7920 496e 7661 7269 616e 7420 any Invariant │ │ │ │ │ -000476e0: 5365 6374 696f 6e73 2074 6865 6e20 7468 Sections then th │ │ │ │ │ -000476f0: 6572 6520 6172 6520 6e6f 6e65 2e0a 0a20 ere are none... │ │ │ │ │ -00047700: 2020 2020 5468 6520 2243 6f76 6572 2054 The "Cover T │ │ │ │ │ -00047710: 6578 7473 2220 6172 6520 6365 7274 6169 exts" are certai │ │ │ │ │ -00047720: 6e20 7368 6f72 7420 7061 7373 6167 6573 n short passages │ │ │ │ │ -00047730: 206f 6620 7465 7874 2074 6861 7420 6172 of text that ar │ │ │ │ │ -00047740: 650a 2020 2020 206c 6973 7465 642c 2061 e. listed, a │ │ │ │ │ -00047750: 7320 4672 6f6e 742d 436f 7665 7220 5465 s Front-Cover Te │ │ │ │ │ -00047760: 7874 7320 6f72 2042 6163 6b2d 436f 7665 xts or Back-Cove │ │ │ │ │ -00047770: 7220 5465 7874 732c 2069 6e20 7468 6520 r Texts, in the │ │ │ │ │ -00047780: 6e6f 7469 6365 0a20 2020 2020 7468 6174 notice. that │ │ │ │ │ -00047790: 2073 6179 7320 7468 6174 2074 6865 2044 says that the D │ │ │ │ │ -000477a0: 6f63 756d 656e 7420 6973 2072 656c 6561 ocument is relea │ │ │ │ │ -000477b0: 7365 6420 756e 6465 7220 7468 6973 204c sed under this L │ │ │ │ │ -000477c0: 6963 656e 7365 2e20 2041 0a20 2020 2020 icense. A. │ │ │ │ │ -000477d0: 4672 6f6e 742d 436f 7665 7220 5465 7874 Front-Cover Text │ │ │ │ │ -000477e0: 206d 6179 2062 6520 6174 206d 6f73 7420 may be at most │ │ │ │ │ -000477f0: 3520 776f 7264 732c 2061 6e64 2061 2042 5 words, and a B │ │ │ │ │ -00047800: 6163 6b2d 436f 7665 7220 5465 7874 206d ack-Cover Text m │ │ │ │ │ -00047810: 6179 0a20 2020 2020 6265 2061 7420 6d6f ay. be at mo │ │ │ │ │ -00047820: 7374 2032 3520 776f 7264 732e 0a0a 2020 st 25 words... │ │ │ │ │ -00047830: 2020 2041 2022 5472 616e 7370 6172 656e A "Transparen │ │ │ │ │ -00047840: 7422 2063 6f70 7920 6f66 2074 6865 2044 t" copy of the D │ │ │ │ │ -00047850: 6f63 756d 656e 7420 6d65 616e 7320 6120 ocument means a │ │ │ │ │ -00047860: 6d61 6368 696e 652d 7265 6164 6162 6c65 machine-readable │ │ │ │ │ -00047870: 2063 6f70 792c 0a20 2020 2020 7265 7072 copy,. repr │ │ │ │ │ -00047880: 6573 656e 7465 6420 696e 2061 2066 6f72 esented in a for │ │ │ │ │ -00047890: 6d61 7420 7768 6f73 6520 7370 6563 6966 mat whose specif │ │ │ │ │ -000478a0: 6963 6174 696f 6e20 6973 2061 7661 696c ication is avail │ │ │ │ │ -000478b0: 6162 6c65 2074 6f20 7468 650a 2020 2020 able to the. │ │ │ │ │ -000478c0: 2067 656e 6572 616c 2070 7562 6c69 632c general public, │ │ │ │ │ -000478d0: 2074 6861 7420 6973 2073 7569 7461 626c that is suitabl │ │ │ │ │ -000478e0: 6520 666f 7220 7265 7669 7369 6e67 2074 e for revising t │ │ │ │ │ -000478f0: 6865 2064 6f63 756d 656e 740a 2020 2020 he document. │ │ │ │ │ -00047900: 2073 7472 6169 6768 7466 6f72 7761 7264 straightforward │ │ │ │ │ -00047910: 6c79 2077 6974 6820 6765 6e65 7269 6320 ly with generic │ │ │ │ │ -00047920: 7465 7874 2065 6469 746f 7273 206f 7220 text editors or │ │ │ │ │ -00047930: 2866 6f72 2069 6d61 6765 7320 636f 6d70 (for images comp │ │ │ │ │ -00047940: 6f73 6564 0a20 2020 2020 6f66 2070 6978 osed. of pix │ │ │ │ │ -00047950: 656c 7329 2067 656e 6572 6963 2070 6169 els) generic pai │ │ │ │ │ -00047960: 6e74 2070 726f 6772 616d 7320 6f72 2028 nt programs or ( │ │ │ │ │ -00047970: 666f 7220 6472 6177 696e 6773 2920 736f for drawings) so │ │ │ │ │ -00047980: 6d65 2077 6964 656c 790a 2020 2020 2061 me widely. a │ │ │ │ │ -00047990: 7661 696c 6162 6c65 2064 7261 7769 6e67 vailable drawing │ │ │ │ │ -000479a0: 2065 6469 746f 722c 2061 6e64 2074 6861 editor, and tha │ │ │ │ │ -000479b0: 7420 6973 2073 7569 7461 626c 6520 666f t is suitable fo │ │ │ │ │ -000479c0: 7220 696e 7075 7420 746f 2074 6578 740a r input to text. │ │ │ │ │ -000479d0: 2020 2020 2066 6f72 6d61 7474 6572 7320 formatters │ │ │ │ │ -000479e0: 6f72 2066 6f72 2061 7574 6f6d 6174 6963 or for automatic │ │ │ │ │ -000479f0: 2074 7261 6e73 6c61 7469 6f6e 2074 6f20 translation to │ │ │ │ │ -00047a00: 6120 7661 7269 6574 7920 6f66 2066 6f72 a variety of for │ │ │ │ │ -00047a10: 6d61 7473 0a20 2020 2020 7375 6974 6162 mats. suitab │ │ │ │ │ -00047a20: 6c65 2066 6f72 2069 6e70 7574 2074 6f20 le for input to │ │ │ │ │ -00047a30: 7465 7874 2066 6f72 6d61 7474 6572 732e text formatters. │ │ │ │ │ -00047a40: 2020 4120 636f 7079 206d 6164 6520 696e A copy made in │ │ │ │ │ -00047a50: 2061 6e20 6f74 6865 7277 6973 650a 2020 an otherwise. │ │ │ │ │ -00047a60: 2020 2054 7261 6e73 7061 7265 6e74 2066 Transparent f │ │ │ │ │ -00047a70: 696c 6520 666f 726d 6174 2077 686f 7365 ile format whose │ │ │ │ │ -00047a80: 206d 6172 6b75 702c 206f 7220 6162 7365 markup, or abse │ │ │ │ │ -00047a90: 6e63 6520 6f66 206d 6172 6b75 702c 2068 nce of markup, h │ │ │ │ │ -00047aa0: 6173 0a20 2020 2020 6265 656e 2061 7272 as. been arr │ │ │ │ │ -00047ab0: 616e 6765 6420 746f 2074 6877 6172 7420 anged to thwart │ │ │ │ │ -00047ac0: 6f72 2064 6973 636f 7572 6167 6520 7375 or discourage su │ │ │ │ │ -00047ad0: 6273 6571 7565 6e74 206d 6f64 6966 6963 bsequent modific │ │ │ │ │ -00047ae0: 6174 696f 6e20 6279 0a20 2020 2020 7265 ation by. re │ │ │ │ │ -00047af0: 6164 6572 7320 6973 206e 6f74 2054 7261 aders is not Tra │ │ │ │ │ -00047b00: 6e73 7061 7265 6e74 2e20 2041 6e20 696d nsparent. An im │ │ │ │ │ -00047b10: 6167 6520 666f 726d 6174 2069 7320 6e6f age format is no │ │ │ │ │ -00047b20: 7420 5472 616e 7370 6172 656e 7420 6966 t Transparent if │ │ │ │ │ -00047b30: 0a20 2020 2020 7573 6564 2066 6f72 2061 . used for a │ │ │ │ │ -00047b40: 6e79 2073 7562 7374 616e 7469 616c 2061 ny substantial a │ │ │ │ │ -00047b50: 6d6f 756e 7420 6f66 2074 6578 742e 2020 mount of text. │ │ │ │ │ -00047b60: 4120 636f 7079 2074 6861 7420 6973 206e A copy that is n │ │ │ │ │ -00047b70: 6f74 0a20 2020 2020 2254 7261 6e73 7061 ot. "Transpa │ │ │ │ │ -00047b80: 7265 6e74 2220 6973 2063 616c 6c65 6420 rent" is called │ │ │ │ │ -00047b90: 224f 7061 7175 6522 2e0a 0a20 2020 2020 "Opaque"... │ │ │ │ │ -00047ba0: 4578 616d 706c 6573 206f 6620 7375 6974 Examples of suit │ │ │ │ │ -00047bb0: 6162 6c65 2066 6f72 6d61 7473 2066 6f72 able formats for │ │ │ │ │ -00047bc0: 2054 7261 6e73 7061 7265 6e74 2063 6f70 Transparent cop │ │ │ │ │ -00047bd0: 6965 7320 696e 636c 7564 6520 706c 6169 ies include plai │ │ │ │ │ -00047be0: 6e0a 2020 2020 2041 5343 4949 2077 6974 n. ASCII wit │ │ │ │ │ -00047bf0: 686f 7574 206d 6172 6b75 702c 2054 6578 hout markup, Tex │ │ │ │ │ -00047c00: 696e 666f 2069 6e70 7574 2066 6f72 6d61 info input forma │ │ │ │ │ -00047c10: 742c 204c 6154 6558 2069 6e70 7574 2066 t, LaTeX input f │ │ │ │ │ -00047c20: 6f72 6d61 742c 0a20 2020 2020 5347 4d4c ormat,. SGML │ │ │ │ │ -00047c30: 206f 7220 584d 4c20 7573 696e 6720 6120 or XML using a │ │ │ │ │ -00047c40: 7075 626c 6963 6c79 2061 7661 696c 6162 publicly availab │ │ │ │ │ -00047c50: 6c65 2044 5444 2c20 616e 6420 7374 616e le DTD, and stan │ │ │ │ │ -00047c60: 6461 7264 2d63 6f6e 666f 726d 696e 670a dard-conforming. │ │ │ │ │ -00047c70: 2020 2020 2073 696d 706c 6520 4854 4d4c simple HTML │ │ │ │ │ -00047c80: 2c20 506f 7374 5363 7269 7074 206f 7220 , PostScript or │ │ │ │ │ -00047c90: 5044 4620 6465 7369 676e 6564 2066 6f72 PDF designed for │ │ │ │ │ -00047ca0: 2068 756d 616e 206d 6f64 6966 6963 6174 human modificat │ │ │ │ │ -00047cb0: 696f 6e2e 0a20 2020 2020 4578 616d 706c ion.. Exampl │ │ │ │ │ -00047cc0: 6573 206f 6620 7472 616e 7370 6172 656e es of transparen │ │ │ │ │ -00047cd0: 7420 696d 6167 6520 666f 726d 6174 7320 t image formats │ │ │ │ │ -00047ce0: 696e 636c 7564 6520 504e 472c 2058 4346 include PNG, XCF │ │ │ │ │ -00047cf0: 2061 6e64 204a 5047 2e0a 2020 2020 204f and JPG.. O │ │ │ │ │ -00047d00: 7061 7175 6520 666f 726d 6174 7320 696e paque formats in │ │ │ │ │ -00047d10: 636c 7564 6520 7072 6f70 7269 6574 6172 clude proprietar │ │ │ │ │ -00047d20: 7920 666f 726d 6174 7320 7468 6174 2063 y formats that c │ │ │ │ │ -00047d30: 616e 2062 6520 7265 6164 2061 6e64 0a20 an be read and. │ │ │ │ │ -00047d40: 2020 2020 6564 6974 6564 206f 6e6c 7920 edited only │ │ │ │ │ -00047d50: 6279 2070 726f 7072 6965 7461 7279 2077 by proprietary w │ │ │ │ │ -00047d60: 6f72 6420 7072 6f63 6573 736f 7273 2c20 ord processors, │ │ │ │ │ -00047d70: 5347 4d4c 206f 7220 584d 4c20 666f 7220 SGML or XML for │ │ │ │ │ -00047d80: 7768 6963 680a 2020 2020 2074 6865 2044 which. the D │ │ │ │ │ -00047d90: 5444 2061 6e64 2f6f 7220 7072 6f63 6573 TD and/or proces │ │ │ │ │ -00047da0: 7369 6e67 2074 6f6f 6c73 2061 7265 206e sing tools are n │ │ │ │ │ -00047db0: 6f74 2067 656e 6572 616c 6c79 2061 7661 ot generally ava │ │ │ │ │ -00047dc0: 696c 6162 6c65 2c20 616e 640a 2020 2020 ilable, and. │ │ │ │ │ -00047dd0: 2074 6865 206d 6163 6869 6e65 2d67 656e the machine-gen │ │ │ │ │ -00047de0: 6572 6174 6564 2048 544d 4c2c 2050 6f73 erated HTML, Pos │ │ │ │ │ -00047df0: 7453 6372 6970 7420 6f72 2050 4446 2070 tScript or PDF p │ │ │ │ │ -00047e00: 726f 6475 6365 6420 6279 2073 6f6d 6520 roduced by some │ │ │ │ │ -00047e10: 776f 7264 0a20 2020 2020 7072 6f63 6573 word. proces │ │ │ │ │ -00047e20: 736f 7273 2066 6f72 206f 7574 7075 7420 sors for output │ │ │ │ │ -00047e30: 7075 7270 6f73 6573 206f 6e6c 792e 0a0a purposes only... │ │ │ │ │ -00047e40: 2020 2020 2054 6865 2022 5469 746c 6520 The "Title │ │ │ │ │ -00047e50: 5061 6765 2220 6d65 616e 732c 2066 6f72 Page" means, for │ │ │ │ │ -00047e60: 2061 2070 7269 6e74 6564 2062 6f6f 6b2c a printed book, │ │ │ │ │ -00047e70: 2074 6865 2074 6974 6c65 2070 6167 6520 the title page │ │ │ │ │ -00047e80: 6974 7365 6c66 2c0a 2020 2020 2070 6c75 itself,. plu │ │ │ │ │ -00047e90: 7320 7375 6368 2066 6f6c 6c6f 7769 6e67 s such following │ │ │ │ │ -00047ea0: 2070 6167 6573 2061 7320 6172 6520 6e65 pages as are ne │ │ │ │ │ -00047eb0: 6564 6564 2074 6f20 686f 6c64 2c20 6c65 eded to hold, le │ │ │ │ │ -00047ec0: 6769 626c 792c 2074 6865 0a20 2020 2020 gibly, the. │ │ │ │ │ -00047ed0: 6d61 7465 7269 616c 2074 6869 7320 4c69 material this Li │ │ │ │ │ -00047ee0: 6365 6e73 6520 7265 7175 6972 6573 2074 cense requires t │ │ │ │ │ -00047ef0: 6f20 6170 7065 6172 2069 6e20 7468 6520 o appear in the │ │ │ │ │ -00047f00: 7469 746c 6520 7061 6765 2e20 2046 6f72 title page. For │ │ │ │ │ -00047f10: 0a20 2020 2020 776f 726b 7320 696e 2066 . works in f │ │ │ │ │ -00047f20: 6f72 6d61 7473 2077 6869 6368 2064 6f20 ormats which do │ │ │ │ │ -00047f30: 6e6f 7420 6861 7665 2061 6e79 2074 6974 not have any tit │ │ │ │ │ -00047f40: 6c65 2070 6167 6520 6173 2073 7563 682c le page as such, │ │ │ │ │ -00047f50: 2022 5469 746c 650a 2020 2020 2050 6167 "Title. Pag │ │ │ │ │ -00047f60: 6522 206d 6561 6e73 2074 6865 2074 6578 e" means the tex │ │ │ │ │ -00047f70: 7420 6e65 6172 2074 6865 206d 6f73 7420 t near the most │ │ │ │ │ -00047f80: 7072 6f6d 696e 656e 7420 6170 7065 6172 prominent appear │ │ │ │ │ -00047f90: 616e 6365 206f 6620 7468 650a 2020 2020 ance of the. │ │ │ │ │ -00047fa0: 2077 6f72 6b27 7320 7469 746c 652c 2070 work's title, p │ │ │ │ │ -00047fb0: 7265 6365 6469 6e67 2074 6865 2062 6567 receding the beg │ │ │ │ │ -00047fc0: 696e 6e69 6e67 206f 6620 7468 6520 626f inning of the bo │ │ │ │ │ -00047fd0: 6479 206f 6620 7468 6520 7465 7874 2e0a dy of the text.. │ │ │ │ │ -00047fe0: 0a20 2020 2020 4120 7365 6374 696f 6e20 . A section │ │ │ │ │ -00047ff0: 2245 6e74 6974 6c65 6420 5859 5a22 206d "Entitled XYZ" m │ │ │ │ │ -00048000: 6561 6e73 2061 206e 616d 6564 2073 7562 eans a named sub │ │ │ │ │ -00048010: 756e 6974 206f 6620 7468 6520 446f 6375 unit of the Docu │ │ │ │ │ -00048020: 6d65 6e74 0a20 2020 2020 7768 6f73 6520 ment. whose │ │ │ │ │ -00048030: 7469 746c 6520 6569 7468 6572 2069 7320 title either is │ │ │ │ │ -00048040: 7072 6563 6973 656c 7920 5859 5a20 6f72 precisely XYZ or │ │ │ │ │ -00048050: 2063 6f6e 7461 696e 7320 5859 5a20 696e contains XYZ in │ │ │ │ │ -00048060: 2070 6172 656e 7468 6573 6573 0a20 2020 parentheses. │ │ │ │ │ -00048070: 2020 666f 6c6c 6f77 696e 6720 7465 7874 following text │ │ │ │ │ -00048080: 2074 6861 7420 7472 616e 736c 6174 6573 that translates │ │ │ │ │ -00048090: 2058 595a 2069 6e20 616e 6f74 6865 7220 XYZ in another │ │ │ │ │ -000480a0: 6c61 6e67 7561 6765 2e20 2028 4865 7265 language. (Here │ │ │ │ │ -000480b0: 2058 595a 0a20 2020 2020 7374 616e 6473 XYZ. stands │ │ │ │ │ -000480c0: 2066 6f72 2061 2073 7065 6369 6669 6320 for a specific │ │ │ │ │ -000480d0: 7365 6374 696f 6e20 6e61 6d65 206d 656e section name men │ │ │ │ │ -000480e0: 7469 6f6e 6564 2062 656c 6f77 2c20 7375 tioned below, su │ │ │ │ │ -000480f0: 6368 2061 730a 2020 2020 2022 4163 6b6e ch as. "Ackn │ │ │ │ │ -00048100: 6f77 6c65 6467 656d 656e 7473 222c 2022 owledgements", " │ │ │ │ │ -00048110: 4465 6469 6361 7469 6f6e 7322 2c20 2245 Dedications", "E │ │ │ │ │ -00048120: 6e64 6f72 7365 6d65 6e74 7322 2c20 6f72 ndorsements", or │ │ │ │ │ -00048130: 2022 4869 7374 6f72 7922 2e29 0a20 2020 "History".). │ │ │ │ │ -00048140: 2020 546f 2022 5072 6573 6572 7665 2074 To "Preserve t │ │ │ │ │ -00048150: 6865 2054 6974 6c65 2220 6f66 2073 7563 he Title" of suc │ │ │ │ │ -00048160: 6820 6120 7365 6374 696f 6e20 7768 656e h a section when │ │ │ │ │ -00048170: 2079 6f75 206d 6f64 6966 7920 7468 650a you modify the. │ │ │ │ │ -00048180: 2020 2020 2044 6f63 756d 656e 7420 6d65 Document me │ │ │ │ │ -00048190: 616e 7320 7468 6174 2069 7420 7265 6d61 ans that it rema │ │ │ │ │ -000481a0: 696e 7320 6120 7365 6374 696f 6e20 2245 ins a section "E │ │ │ │ │ -000481b0: 6e74 6974 6c65 6420 5859 5a22 2061 6363 ntitled XYZ" acc │ │ │ │ │ -000481c0: 6f72 6469 6e67 0a20 2020 2020 746f 2074 ording. to t │ │ │ │ │ -000481d0: 6869 7320 6465 6669 6e69 7469 6f6e 2e0a his definition.. │ │ │ │ │ -000481e0: 0a20 2020 2020 5468 6520 446f 6375 6d65 . The Docume │ │ │ │ │ -000481f0: 6e74 206d 6179 2069 6e63 6c75 6465 2057 nt may include W │ │ │ │ │ -00048200: 6172 7261 6e74 7920 4469 7363 6c61 696d arranty Disclaim │ │ │ │ │ -00048210: 6572 7320 6e65 7874 2074 6f20 7468 6520 ers next to the │ │ │ │ │ -00048220: 6e6f 7469 6365 0a20 2020 2020 7768 6963 notice. whic │ │ │ │ │ -00048230: 6820 7374 6174 6573 2074 6861 7420 7468 h states that th │ │ │ │ │ -00048240: 6973 204c 6963 656e 7365 2061 7070 6c69 is License appli │ │ │ │ │ -00048250: 6573 2074 6f20 7468 6520 446f 6375 6d65 es to the Docume │ │ │ │ │ -00048260: 6e74 2e20 2054 6865 7365 0a20 2020 2020 nt. These. │ │ │ │ │ -00048270: 5761 7272 616e 7479 2044 6973 636c 6169 Warranty Disclai │ │ │ │ │ -00048280: 6d65 7273 2061 7265 2063 6f6e 7369 6465 mers are conside │ │ │ │ │ -00048290: 7265 6420 746f 2062 6520 696e 636c 7564 red to be includ │ │ │ │ │ -000482a0: 6564 2062 7920 7265 6665 7265 6e63 6520 ed by reference │ │ │ │ │ -000482b0: 696e 0a20 2020 2020 7468 6973 204c 6963 in. this Lic │ │ │ │ │ -000482c0: 656e 7365 2c20 6275 7420 6f6e 6c79 2061 ense, but only a │ │ │ │ │ -000482d0: 7320 7265 6761 7264 7320 6469 7363 6c61 s regards discla │ │ │ │ │ -000482e0: 696d 696e 6720 7761 7272 616e 7469 6573 iming warranties │ │ │ │ │ -000482f0: 3a20 616e 7920 6f74 6865 720a 2020 2020 : any other. │ │ │ │ │ -00048300: 2069 6d70 6c69 6361 7469 6f6e 2074 6861 implication tha │ │ │ │ │ -00048310: 7420 7468 6573 6520 5761 7272 616e 7479 t these Warranty │ │ │ │ │ -00048320: 2044 6973 636c 6169 6d65 7273 206d 6179 Disclaimers may │ │ │ │ │ -00048330: 2068 6176 6520 6973 2076 6f69 6420 616e have is void an │ │ │ │ │ -00048340: 640a 2020 2020 2068 6173 206e 6f20 6566 d. has no ef │ │ │ │ │ -00048350: 6665 6374 206f 6e20 7468 6520 6d65 616e fect on the mean │ │ │ │ │ -00048360: 696e 6720 6f66 2074 6869 7320 4c69 6365 ing of this Lice │ │ │ │ │ -00048370: 6e73 652e 0a0a 2020 322e 2056 4552 4241 nse... 2. VERBA │ │ │ │ │ -00048380: 5449 4d20 434f 5059 494e 470a 0a20 2020 TIM COPYING.. │ │ │ │ │ -00048390: 2020 596f 7520 6d61 7920 636f 7079 2061 You may copy a │ │ │ │ │ -000483a0: 6e64 2064 6973 7472 6962 7574 6520 7468 nd distribute th │ │ │ │ │ -000483b0: 6520 446f 6375 6d65 6e74 2069 6e20 616e e Document in an │ │ │ │ │ -000483c0: 7920 6d65 6469 756d 2c20 6569 7468 6572 y medium, either │ │ │ │ │ -000483d0: 0a20 2020 2020 636f 6d6d 6572 6369 616c . commercial │ │ │ │ │ -000483e0: 6c79 206f 7220 6e6f 6e63 6f6d 6d65 7263 ly or noncommerc │ │ │ │ │ -000483f0: 6961 6c6c 792c 2070 726f 7669 6465 6420 ially, provided │ │ │ │ │ -00048400: 7468 6174 2074 6869 7320 4c69 6365 6e73 that this Licens │ │ │ │ │ -00048410: 652c 2074 6865 0a20 2020 2020 636f 7079 e, the. copy │ │ │ │ │ -00048420: 7269 6768 7420 6e6f 7469 6365 732c 2061 right notices, a │ │ │ │ │ -00048430: 6e64 2074 6865 206c 6963 656e 7365 206e nd the license n │ │ │ │ │ -00048440: 6f74 6963 6520 7361 7969 6e67 2074 6869 otice saying thi │ │ │ │ │ -00048450: 7320 4c69 6365 6e73 650a 2020 2020 2061 s License. a │ │ │ │ │ -00048460: 7070 6c69 6573 2074 6f20 7468 6520 446f pplies to the Do │ │ │ │ │ -00048470: 6375 6d65 6e74 2061 7265 2072 6570 726f cument are repro │ │ │ │ │ -00048480: 6475 6365 6420 696e 2061 6c6c 2063 6f70 duced in all cop │ │ │ │ │ -00048490: 6965 732c 2061 6e64 2074 6861 7420 796f ies, and that yo │ │ │ │ │ -000484a0: 750a 2020 2020 2061 6464 206e 6f20 6f74 u. add no ot │ │ │ │ │ -000484b0: 6865 7220 636f 6e64 6974 696f 6e73 2077 her conditions w │ │ │ │ │ -000484c0: 6861 7473 6f65 7665 7220 746f 2074 686f hatsoever to tho │ │ │ │ │ -000484d0: 7365 206f 6620 7468 6973 204c 6963 656e se of this Licen │ │ │ │ │ -000484e0: 7365 2e20 2059 6f75 0a20 2020 2020 6d61 se. You. ma │ │ │ │ │ -000484f0: 7920 6e6f 7420 7573 6520 7465 6368 6e69 y not use techni │ │ │ │ │ -00048500: 6361 6c20 6d65 6173 7572 6573 2074 6f20 cal measures to │ │ │ │ │ -00048510: 6f62 7374 7275 6374 206f 7220 636f 6e74 obstruct or cont │ │ │ │ │ -00048520: 726f 6c20 7468 6520 7265 6164 696e 670a rol the reading. │ │ │ │ │ -00048530: 2020 2020 206f 7220 6675 7274 6865 7220 or further │ │ │ │ │ -00048540: 636f 7079 696e 6720 6f66 2074 6865 2063 copying of the c │ │ │ │ │ -00048550: 6f70 6965 7320 796f 7520 6d61 6b65 206f opies you make o │ │ │ │ │ -00048560: 7220 6469 7374 7269 6275 7465 2e20 2048 r distribute. H │ │ │ │ │ -00048570: 6f77 6576 6572 2c0a 2020 2020 2079 6f75 owever,. you │ │ │ │ │ -00048580: 206d 6179 2061 6363 6570 7420 636f 6d70 may accept comp │ │ │ │ │ -00048590: 656e 7361 7469 6f6e 2069 6e20 6578 6368 ensation in exch │ │ │ │ │ -000485a0: 616e 6765 2066 6f72 2063 6f70 6965 732e ange for copies. │ │ │ │ │ -000485b0: 2020 4966 2079 6f75 0a20 2020 2020 6469 If you. di │ │ │ │ │ -000485c0: 7374 7269 6275 7465 2061 206c 6172 6765 stribute a large │ │ │ │ │ -000485d0: 2065 6e6f 7567 6820 6e75 6d62 6572 206f enough number o │ │ │ │ │ -000485e0: 6620 636f 7069 6573 2079 6f75 206d 7573 f copies you mus │ │ │ │ │ -000485f0: 7420 616c 736f 2066 6f6c 6c6f 7720 7468 t also follow th │ │ │ │ │ -00048600: 650a 2020 2020 2063 6f6e 6469 7469 6f6e e. condition │ │ │ │ │ -00048610: 7320 696e 2073 6563 7469 6f6e 2033 2e0a s in section 3.. │ │ │ │ │ -00048620: 0a20 2020 2020 596f 7520 6d61 7920 616c . You may al │ │ │ │ │ -00048630: 736f 206c 656e 6420 636f 7069 6573 2c20 so lend copies, │ │ │ │ │ -00048640: 756e 6465 7220 7468 6520 7361 6d65 2063 under the same c │ │ │ │ │ -00048650: 6f6e 6469 7469 6f6e 7320 7374 6174 6564 onditions stated │ │ │ │ │ -00048660: 2061 626f 7665 2c0a 2020 2020 2061 6e64 above,. and │ │ │ │ │ -00048670: 2079 6f75 206d 6179 2070 7562 6c69 636c you may publicl │ │ │ │ │ -00048680: 7920 6469 7370 6c61 7920 636f 7069 6573 y display copies │ │ │ │ │ -00048690: 2e0a 0a20 2033 2e20 434f 5059 494e 4720 ... 3. COPYING │ │ │ │ │ -000486a0: 494e 2051 5541 4e54 4954 590a 0a20 2020 IN QUANTITY.. │ │ │ │ │ -000486b0: 2020 4966 2079 6f75 2070 7562 6c69 7368 If you publish │ │ │ │ │ -000486c0: 2070 7269 6e74 6564 2063 6f70 6965 7320 printed copies │ │ │ │ │ -000486d0: 286f 7220 636f 7069 6573 2069 6e20 6d65 (or copies in me │ │ │ │ │ -000486e0: 6469 6120 7468 6174 2063 6f6d 6d6f 6e6c dia that commonl │ │ │ │ │ -000486f0: 790a 2020 2020 2068 6176 6520 7072 696e y. have prin │ │ │ │ │ -00048700: 7465 6420 636f 7665 7273 2920 6f66 2074 ted covers) of t │ │ │ │ │ -00048710: 6865 2044 6f63 756d 656e 742c 206e 756d he Document, num │ │ │ │ │ -00048720: 6265 7269 6e67 206d 6f72 6520 7468 616e bering more than │ │ │ │ │ -00048730: 2031 3030 2c20 616e 640a 2020 2020 2074 100, and. t │ │ │ │ │ -00048740: 6865 2044 6f63 756d 656e 7427 7320 6c69 he Document's li │ │ │ │ │ -00048750: 6365 6e73 6520 6e6f 7469 6365 2072 6571 cense notice req │ │ │ │ │ -00048760: 7569 7265 7320 436f 7665 7220 5465 7874 uires Cover Text │ │ │ │ │ -00048770: 732c 2079 6f75 206d 7573 740a 2020 2020 s, you must. │ │ │ │ │ -00048780: 2065 6e63 6c6f 7365 2074 6865 2063 6f70 enclose the cop │ │ │ │ │ -00048790: 6965 7320 696e 2063 6f76 6572 7320 7468 ies in covers th │ │ │ │ │ -000487a0: 6174 2063 6172 7279 2c20 636c 6561 726c at carry, clearl │ │ │ │ │ -000487b0: 7920 616e 6420 6c65 6769 626c 792c 2061 y and legibly, a │ │ │ │ │ -000487c0: 6c6c 0a20 2020 2020 7468 6573 6520 436f ll. these Co │ │ │ │ │ -000487d0: 7665 7220 5465 7874 733a 2046 726f 6e74 ver Texts: Front │ │ │ │ │ -000487e0: 2d43 6f76 6572 2054 6578 7473 206f 6e20 -Cover Texts on │ │ │ │ │ -000487f0: 7468 6520 6672 6f6e 7420 636f 7665 722c the front cover, │ │ │ │ │ -00048800: 2061 6e64 0a20 2020 2020 4261 636b 2d43 and. Back-C │ │ │ │ │ -00048810: 6f76 6572 2054 6578 7473 206f 6e20 7468 over Texts on th │ │ │ │ │ -00048820: 6520 6261 636b 2063 6f76 6572 2e20 2042 e back cover. B │ │ │ │ │ -00048830: 6f74 6820 636f 7665 7273 206d 7573 7420 oth covers must │ │ │ │ │ -00048840: 616c 736f 2063 6c65 6172 6c79 0a20 2020 also clearly. │ │ │ │ │ -00048850: 2020 616e 6420 6c65 6769 626c 7920 6964 and legibly id │ │ │ │ │ -00048860: 656e 7469 6679 2079 6f75 2061 7320 7468 entify you as th │ │ │ │ │ -00048870: 6520 7075 626c 6973 6865 7220 6f66 2074 e publisher of t │ │ │ │ │ -00048880: 6865 7365 2063 6f70 6965 732e 2020 5468 hese copies. Th │ │ │ │ │ -00048890: 650a 2020 2020 2066 726f 6e74 2063 6f76 e. front cov │ │ │ │ │ -000488a0: 6572 206d 7573 7420 7072 6573 656e 7420 er must present │ │ │ │ │ -000488b0: 7468 6520 6675 6c6c 2074 6974 6c65 2077 the full title w │ │ │ │ │ -000488c0: 6974 6820 616c 6c20 776f 7264 7320 6f66 ith all words of │ │ │ │ │ -000488d0: 2074 6865 2074 6974 6c65 0a20 2020 2020 the title. │ │ │ │ │ -000488e0: 6571 7561 6c6c 7920 7072 6f6d 696e 656e equally prominen │ │ │ │ │ -000488f0: 7420 616e 6420 7669 7369 626c 652e 2020 t and visible. │ │ │ │ │ -00048900: 596f 7520 6d61 7920 6164 6420 6f74 6865 You may add othe │ │ │ │ │ -00048910: 7220 6d61 7465 7269 616c 206f 6e20 7468 r material on th │ │ │ │ │ -00048920: 650a 2020 2020 2063 6f76 6572 7320 696e e. covers in │ │ │ │ │ -00048930: 2061 6464 6974 696f 6e2e 2020 436f 7079 addition. Copy │ │ │ │ │ -00048940: 696e 6720 7769 7468 2063 6861 6e67 6573 ing with changes │ │ │ │ │ -00048950: 206c 696d 6974 6564 2074 6f20 7468 6520 limited to the │ │ │ │ │ -00048960: 636f 7665 7273 2c20 6173 0a20 2020 2020 covers, as. │ │ │ │ │ -00048970: 6c6f 6e67 2061 7320 7468 6579 2070 7265 long as they pre │ │ │ │ │ -00048980: 7365 7276 6520 7468 6520 7469 746c 6520 serve the title │ │ │ │ │ -00048990: 6f66 2074 6865 2044 6f63 756d 656e 7420 of the Document │ │ │ │ │ -000489a0: 616e 6420 7361 7469 7366 7920 7468 6573 and satisfy thes │ │ │ │ │ -000489b0: 650a 2020 2020 2063 6f6e 6469 7469 6f6e e. condition │ │ │ │ │ -000489c0: 732c 2063 616e 2062 6520 7472 6561 7465 s, can be treate │ │ │ │ │ -000489d0: 6420 6173 2076 6572 6261 7469 6d20 636f d as verbatim co │ │ │ │ │ -000489e0: 7079 696e 6720 696e 206f 7468 6572 2072 pying in other r │ │ │ │ │ -000489f0: 6573 7065 6374 732e 0a0a 2020 2020 2049 espects... I │ │ │ │ │ -00048a00: 6620 7468 6520 7265 7175 6972 6564 2074 f the required t │ │ │ │ │ -00048a10: 6578 7473 2066 6f72 2065 6974 6865 7220 exts for either │ │ │ │ │ -00048a20: 636f 7665 7220 6172 6520 746f 6f20 766f cover are too vo │ │ │ │ │ -00048a30: 6c75 6d69 6e6f 7573 2074 6f20 6669 740a luminous to fit. │ │ │ │ │ -00048a40: 2020 2020 206c 6567 6962 6c79 2c20 796f legibly, yo │ │ │ │ │ -00048a50: 7520 7368 6f75 6c64 2070 7574 2074 6865 u should put the │ │ │ │ │ -00048a60: 2066 6972 7374 206f 6e65 7320 6c69 7374 first ones list │ │ │ │ │ -00048a70: 6564 2028 6173 206d 616e 7920 6173 2066 ed (as many as f │ │ │ │ │ -00048a80: 6974 0a20 2020 2020 7265 6173 6f6e 6162 it. reasonab │ │ │ │ │ -00048a90: 6c79 2920 6f6e 2074 6865 2061 6374 7561 ly) on the actua │ │ │ │ │ -00048aa0: 6c20 636f 7665 722c 2061 6e64 2063 6f6e l cover, and con │ │ │ │ │ -00048ab0: 7469 6e75 6520 7468 6520 7265 7374 206f tinue the rest o │ │ │ │ │ -00048ac0: 6e74 6f0a 2020 2020 2061 646a 6163 656e nto. adjacen │ │ │ │ │ -00048ad0: 7420 7061 6765 732e 0a0a 2020 2020 2049 t pages... I │ │ │ │ │ -00048ae0: 6620 796f 7520 7075 626c 6973 6820 6f72 f you publish or │ │ │ │ │ -00048af0: 2064 6973 7472 6962 7574 6520 4f70 6171 distribute Opaq │ │ │ │ │ -00048b00: 7565 2063 6f70 6965 7320 6f66 2074 6865 ue copies of the │ │ │ │ │ -00048b10: 2044 6f63 756d 656e 740a 2020 2020 206e Document. n │ │ │ │ │ -00048b20: 756d 6265 7269 6e67 206d 6f72 6520 7468 umbering more th │ │ │ │ │ -00048b30: 616e 2031 3030 2c20 796f 7520 6d75 7374 an 100, you must │ │ │ │ │ -00048b40: 2065 6974 6865 7220 696e 636c 7564 6520 either include │ │ │ │ │ -00048b50: 6120 6d61 6368 696e 652d 7265 6164 6162 a machine-readab │ │ │ │ │ -00048b60: 6c65 0a20 2020 2020 5472 616e 7370 6172 le. Transpar │ │ │ │ │ -00048b70: 656e 7420 636f 7079 2061 6c6f 6e67 2077 ent copy along w │ │ │ │ │ -00048b80: 6974 6820 6561 6368 204f 7061 7175 6520 ith each Opaque │ │ │ │ │ -00048b90: 636f 7079 2c20 6f72 2073 7461 7465 2069 copy, or state i │ │ │ │ │ -00048ba0: 6e20 6f72 2077 6974 680a 2020 2020 2065 n or with. e │ │ │ │ │ -00048bb0: 6163 6820 4f70 6171 7565 2063 6f70 7920 ach Opaque copy │ │ │ │ │ -00048bc0: 6120 636f 6d70 7574 6572 2d6e 6574 776f a computer-netwo │ │ │ │ │ -00048bd0: 726b 206c 6f63 6174 696f 6e20 6672 6f6d rk location from │ │ │ │ │ -00048be0: 2077 6869 6368 2074 6865 2067 656e 6572 which the gener │ │ │ │ │ -00048bf0: 616c 0a20 2020 2020 6e65 7477 6f72 6b2d al. network- │ │ │ │ │ -00048c00: 7573 696e 6720 7075 626c 6963 2068 6173 using public has │ │ │ │ │ -00048c10: 2061 6363 6573 7320 746f 2064 6f77 6e6c access to downl │ │ │ │ │ -00048c20: 6f61 6420 7573 696e 6720 7075 626c 6963 oad using public │ │ │ │ │ -00048c30: 2d73 7461 6e64 6172 640a 2020 2020 206e -standard. n │ │ │ │ │ -00048c40: 6574 776f 726b 2070 726f 746f 636f 6c73 etwork protocols │ │ │ │ │ -00048c50: 2061 2063 6f6d 706c 6574 6520 5472 616e a complete Tran │ │ │ │ │ -00048c60: 7370 6172 656e 7420 636f 7079 206f 6620 sparent copy of │ │ │ │ │ -00048c70: 7468 6520 446f 6375 6d65 6e74 2c20 6672 the Document, fr │ │ │ │ │ -00048c80: 6565 0a20 2020 2020 6f66 2061 6464 6564 ee. of added │ │ │ │ │ -00048c90: 206d 6174 6572 6961 6c2e 2020 4966 2079 material. If y │ │ │ │ │ -00048ca0: 6f75 2075 7365 2074 6865 206c 6174 7465 ou use the latte │ │ │ │ │ -00048cb0: 7220 6f70 7469 6f6e 2c20 796f 7520 6d75 r option, you mu │ │ │ │ │ -00048cc0: 7374 2074 616b 650a 2020 2020 2072 6561 st take. rea │ │ │ │ │ -00048cd0: 736f 6e61 626c 7920 7072 7564 656e 7420 sonably prudent │ │ │ │ │ -00048ce0: 7374 6570 732c 2077 6865 6e20 796f 7520 steps, when you │ │ │ │ │ -00048cf0: 6265 6769 6e20 6469 7374 7269 6275 7469 begin distributi │ │ │ │ │ -00048d00: 6f6e 206f 6620 4f70 6171 7565 0a20 2020 on of Opaque. │ │ │ │ │ -00048d10: 2020 636f 7069 6573 2069 6e20 7175 616e copies in quan │ │ │ │ │ -00048d20: 7469 7479 2c20 746f 2065 6e73 7572 6520 tity, to ensure │ │ │ │ │ -00048d30: 7468 6174 2074 6869 7320 5472 616e 7370 that this Transp │ │ │ │ │ -00048d40: 6172 656e 7420 636f 7079 2077 696c 6c0a arent copy will. │ │ │ │ │ -00048d50: 2020 2020 2072 656d 6169 6e20 7468 7573 remain thus │ │ │ │ │ -00048d60: 2061 6363 6573 7369 626c 6520 6174 2074 accessible at t │ │ │ │ │ -00048d70: 6865 2073 7461 7465 6420 6c6f 6361 7469 he stated locati │ │ │ │ │ -00048d80: 6f6e 2075 6e74 696c 2061 7420 6c65 6173 on until at leas │ │ │ │ │ -00048d90: 7420 6f6e 650a 2020 2020 2079 6561 7220 t one. year │ │ │ │ │ -00048da0: 6166 7465 7220 7468 6520 6c61 7374 2074 after the last t │ │ │ │ │ -00048db0: 696d 6520 796f 7520 6469 7374 7269 6275 ime you distribu │ │ │ │ │ -00048dc0: 7465 2061 6e20 4f70 6171 7565 2063 6f70 te an Opaque cop │ │ │ │ │ -00048dd0: 7920 2864 6972 6563 746c 7920 6f72 0a20 y (directly or. │ │ │ │ │ -00048de0: 2020 2020 7468 726f 7567 6820 796f 7572 through your │ │ │ │ │ -00048df0: 2061 6765 6e74 7320 6f72 2072 6574 6169 agents or retai │ │ │ │ │ -00048e00: 6c65 7273 2920 6f66 2074 6861 7420 6564 lers) of that ed │ │ │ │ │ -00048e10: 6974 696f 6e20 746f 2074 6865 2070 7562 ition to the pub │ │ │ │ │ -00048e20: 6c69 632e 0a0a 2020 2020 2049 7420 6973 lic... It is │ │ │ │ │ -00048e30: 2072 6571 7565 7374 6564 2c20 6275 7420 requested, but │ │ │ │ │ -00048e40: 6e6f 7420 7265 7175 6972 6564 2c20 7468 not required, th │ │ │ │ │ -00048e50: 6174 2079 6f75 2063 6f6e 7461 6374 2074 at you contact t │ │ │ │ │ -00048e60: 6865 2061 7574 686f 7273 206f 660a 2020 he authors of. │ │ │ │ │ -00048e70: 2020 2074 6865 2044 6f63 756d 656e 7420 the Document │ │ │ │ │ -00048e80: 7765 6c6c 2062 6566 6f72 6520 7265 6469 well before redi │ │ │ │ │ -00048e90: 7374 7269 6275 7469 6e67 2061 6e79 206c stributing any l │ │ │ │ │ -00048ea0: 6172 6765 206e 756d 6265 7220 6f66 2063 arge number of c │ │ │ │ │ -00048eb0: 6f70 6965 732c 0a20 2020 2020 746f 2067 opies,. to g │ │ │ │ │ -00048ec0: 6976 6520 7468 656d 2061 2063 6861 6e63 ive them a chanc │ │ │ │ │ -00048ed0: 6520 746f 2070 726f 7669 6465 2079 6f75 e to provide you │ │ │ │ │ -00048ee0: 2077 6974 6820 616e 2075 7064 6174 6564 with an updated │ │ │ │ │ -00048ef0: 2076 6572 7369 6f6e 206f 6620 7468 650a version of the. │ │ │ │ │ -00048f00: 2020 2020 2044 6f63 756d 656e 742e 0a0a Document... │ │ │ │ │ -00048f10: 2020 342e 204d 4f44 4946 4943 4154 494f 4. MODIFICATIO │ │ │ │ │ -00048f20: 4e53 0a0a 2020 2020 2059 6f75 206d 6179 NS.. You may │ │ │ │ │ -00048f30: 2063 6f70 7920 616e 6420 6469 7374 7269 copy and distri │ │ │ │ │ -00048f40: 6275 7465 2061 204d 6f64 6966 6965 6420 bute a Modified │ │ │ │ │ -00048f50: 5665 7273 696f 6e20 6f66 2074 6865 2044 Version of the D │ │ │ │ │ -00048f60: 6f63 756d 656e 740a 2020 2020 2075 6e64 ocument. und │ │ │ │ │ -00048f70: 6572 2074 6865 2063 6f6e 6469 7469 6f6e er the condition │ │ │ │ │ -00048f80: 7320 6f66 2073 6563 7469 6f6e 7320 3220 s of sections 2 │ │ │ │ │ -00048f90: 616e 6420 3320 6162 6f76 652c 2070 726f and 3 above, pro │ │ │ │ │ -00048fa0: 7669 6465 6420 7468 6174 2079 6f75 0a20 vided that you. │ │ │ │ │ -00048fb0: 2020 2020 7265 6c65 6173 6520 7468 6520 release the │ │ │ │ │ -00048fc0: 4d6f 6469 6669 6564 2056 6572 7369 6f6e Modified Version │ │ │ │ │ -00048fd0: 2075 6e64 6572 2070 7265 6369 7365 6c79 under precisely │ │ │ │ │ -00048fe0: 2074 6869 7320 4c69 6365 6e73 652c 2077 this License, w │ │ │ │ │ -00048ff0: 6974 6820 7468 650a 2020 2020 204d 6f64 ith the. Mod │ │ │ │ │ -00049000: 6966 6965 6420 5665 7273 696f 6e20 6669 ified Version fi │ │ │ │ │ -00049010: 6c6c 696e 6720 7468 6520 726f 6c65 206f lling the role o │ │ │ │ │ -00049020: 6620 7468 6520 446f 6375 6d65 6e74 2c20 f the Document, │ │ │ │ │ -00049030: 7468 7573 206c 6963 656e 7369 6e67 0a20 thus licensing. │ │ │ │ │ -00049040: 2020 2020 6469 7374 7269 6275 7469 6f6e distribution │ │ │ │ │ -00049050: 2061 6e64 206d 6f64 6966 6963 6174 696f and modificatio │ │ │ │ │ -00049060: 6e20 6f66 2074 6865 204d 6f64 6966 6965 n of the Modifie │ │ │ │ │ -00049070: 6420 5665 7273 696f 6e20 746f 2077 686f d Version to who │ │ │ │ │ -00049080: 6576 6572 0a20 2020 2020 706f 7373 6573 ever. posses │ │ │ │ │ -00049090: 7365 7320 6120 636f 7079 206f 6620 6974 ses a copy of it │ │ │ │ │ -000490a0: 2e20 2049 6e20 6164 6469 7469 6f6e 2c20 . In addition, │ │ │ │ │ -000490b0: 796f 7520 6d75 7374 2064 6f20 7468 6573 you must do thes │ │ │ │ │ -000490c0: 6520 7468 696e 6773 2069 6e0a 2020 2020 e things in. │ │ │ │ │ -000490d0: 2074 6865 204d 6f64 6966 6965 6420 5665 the Modified Ve │ │ │ │ │ -000490e0: 7273 696f 6e3a 0a0a 2020 2020 2020 2041 rsion:.. A │ │ │ │ │ -000490f0: 2e20 5573 6520 696e 2074 6865 2054 6974 . Use in the Tit │ │ │ │ │ -00049100: 6c65 2050 6167 6520 2861 6e64 206f 6e20 le Page (and on │ │ │ │ │ -00049110: 7468 6520 636f 7665 7273 2c20 6966 2061 the covers, if a │ │ │ │ │ -00049120: 6e79 2920 6120 7469 746c 650a 2020 2020 ny) a title. │ │ │ │ │ -00049130: 2020 2020 2020 6469 7374 696e 6374 2066 distinct f │ │ │ │ │ -00049140: 726f 6d20 7468 6174 206f 6620 7468 6520 rom that of the │ │ │ │ │ -00049150: 446f 6375 6d65 6e74 2c20 616e 6420 6672 Document, and fr │ │ │ │ │ -00049160: 6f6d 2074 686f 7365 206f 6620 7072 6576 om those of prev │ │ │ │ │ -00049170: 696f 7573 0a20 2020 2020 2020 2020 2076 ious. v │ │ │ │ │ -00049180: 6572 7369 6f6e 7320 2877 6869 6368 2073 ersions (which s │ │ │ │ │ -00049190: 686f 756c 642c 2069 6620 7468 6572 6520 hould, if there │ │ │ │ │ -000491a0: 7765 7265 2061 6e79 2c20 6265 206c 6973 were any, be lis │ │ │ │ │ -000491b0: 7465 6420 696e 2074 6865 0a20 2020 2020 ted in the. │ │ │ │ │ -000491c0: 2020 2020 2048 6973 746f 7279 2073 6563 History sec │ │ │ │ │ -000491d0: 7469 6f6e 206f 6620 7468 6520 446f 6375 tion of the Docu │ │ │ │ │ -000491e0: 6d65 6e74 292e 2020 596f 7520 6d61 7920 ment). You may │ │ │ │ │ -000491f0: 7573 6520 7468 6520 7361 6d65 2074 6974 use the same tit │ │ │ │ │ -00049200: 6c65 0a20 2020 2020 2020 2020 2061 7320 le. as │ │ │ │ │ -00049210: 6120 7072 6576 696f 7573 2076 6572 7369 a previous versi │ │ │ │ │ -00049220: 6f6e 2069 6620 7468 6520 6f72 6967 696e on if the origin │ │ │ │ │ -00049230: 616c 2070 7562 6c69 7368 6572 206f 6620 al publisher of │ │ │ │ │ -00049240: 7468 6174 0a20 2020 2020 2020 2020 2076 that. v │ │ │ │ │ -00049250: 6572 7369 6f6e 2067 6976 6573 2070 6572 ersion gives per │ │ │ │ │ -00049260: 6d69 7373 696f 6e2e 0a0a 2020 2020 2020 mission... │ │ │ │ │ -00049270: 2042 2e20 4c69 7374 206f 6e20 7468 6520 B. List on the │ │ │ │ │ -00049280: 5469 746c 6520 5061 6765 2c20 6173 2061 Title Page, as a │ │ │ │ │ -00049290: 7574 686f 7273 2c20 6f6e 6520 6f72 206d uthors, one or m │ │ │ │ │ -000492a0: 6f72 6520 7065 7273 6f6e 7320 6f72 0a20 ore persons or. │ │ │ │ │ -000492b0: 2020 2020 2020 2020 2065 6e74 6974 6965 entitie │ │ │ │ │ -000492c0: 7320 7265 7370 6f6e 7369 626c 6520 666f s responsible fo │ │ │ │ │ -000492d0: 7220 6175 7468 6f72 7368 6970 206f 6620 r authorship of │ │ │ │ │ -000492e0: 7468 6520 6d6f 6469 6669 6361 7469 6f6e the modification │ │ │ │ │ -000492f0: 7320 696e 0a20 2020 2020 2020 2020 2074 s in. t │ │ │ │ │ -00049300: 6865 204d 6f64 6966 6965 6420 5665 7273 he Modified Vers │ │ │ │ │ -00049310: 696f 6e2c 2074 6f67 6574 6865 7220 7769 ion, together wi │ │ │ │ │ -00049320: 7468 2061 7420 6c65 6173 7420 6669 7665 th at least five │ │ │ │ │ -00049330: 206f 6620 7468 650a 2020 2020 2020 2020 of the. │ │ │ │ │ -00049340: 2020 7072 696e 6369 7061 6c20 6175 7468 principal auth │ │ │ │ │ -00049350: 6f72 7320 6f66 2074 6865 2044 6f63 756d ors of the Docum │ │ │ │ │ -00049360: 656e 7420 2861 6c6c 206f 6620 6974 7320 ent (all of its │ │ │ │ │ -00049370: 7072 696e 6369 7061 6c0a 2020 2020 2020 principal. │ │ │ │ │ -00049380: 2020 2020 6175 7468 6f72 732c 2069 6620 authors, if │ │ │ │ │ -00049390: 6974 2068 6173 2066 6577 6572 2074 6861 it has fewer tha │ │ │ │ │ -000493a0: 6e20 6669 7665 292c 2075 6e6c 6573 7320 n five), unless │ │ │ │ │ -000493b0: 7468 6579 2072 656c 6561 7365 2079 6f75 they release you │ │ │ │ │ -000493c0: 0a20 2020 2020 2020 2020 2066 726f 6d20 . from │ │ │ │ │ -000493d0: 7468 6973 2072 6571 7569 7265 6d65 6e74 this requirement │ │ │ │ │ -000493e0: 2e0a 0a20 2020 2020 2020 432e 2053 7461 ... C. Sta │ │ │ │ │ -000493f0: 7465 206f 6e20 7468 6520 5469 746c 6520 te on the Title │ │ │ │ │ -00049400: 7061 6765 2074 6865 206e 616d 6520 6f66 page the name of │ │ │ │ │ -00049410: 2074 6865 2070 7562 6c69 7368 6572 206f the publisher o │ │ │ │ │ -00049420: 6620 7468 650a 2020 2020 2020 2020 2020 f the. │ │ │ │ │ -00049430: 4d6f 6469 6669 6564 2056 6572 7369 6f6e Modified Version │ │ │ │ │ -00049440: 2c20 6173 2074 6865 2070 7562 6c69 7368 , as the publish │ │ │ │ │ -00049450: 6572 2e0a 0a20 2020 2020 2020 442e 2050 er... D. P │ │ │ │ │ -00049460: 7265 7365 7276 6520 616c 6c20 7468 6520 reserve all the │ │ │ │ │ -00049470: 636f 7079 7269 6768 7420 6e6f 7469 6365 copyright notice │ │ │ │ │ -00049480: 7320 6f66 2074 6865 2044 6f63 756d 656e s of the Documen │ │ │ │ │ -00049490: 742e 0a0a 2020 2020 2020 2045 2e20 4164 t... E. Ad │ │ │ │ │ -000494a0: 6420 616e 2061 7070 726f 7072 6961 7465 d an appropriate │ │ │ │ │ -000494b0: 2063 6f70 7972 6967 6874 206e 6f74 6963 copyright notic │ │ │ │ │ -000494c0: 6520 666f 7220 796f 7572 206d 6f64 6966 e for your modif │ │ │ │ │ -000494d0: 6963 6174 696f 6e73 0a20 2020 2020 2020 ications. │ │ │ │ │ -000494e0: 2020 2061 646a 6163 656e 7420 746f 2074 adjacent to t │ │ │ │ │ -000494f0: 6865 206f 7468 6572 2063 6f70 7972 6967 he other copyrig │ │ │ │ │ -00049500: 6874 206e 6f74 6963 6573 2e0a 0a20 2020 ht notices... │ │ │ │ │ -00049510: 2020 2020 462e 2049 6e63 6c75 6465 2c20 F. Include, │ │ │ │ │ -00049520: 696d 6d65 6469 6174 656c 7920 6166 7465 immediately afte │ │ │ │ │ -00049530: 7220 7468 6520 636f 7079 7269 6768 7420 r the copyright │ │ │ │ │ -00049540: 6e6f 7469 6365 732c 2061 206c 6963 656e notices, a licen │ │ │ │ │ -00049550: 7365 0a20 2020 2020 2020 2020 206e 6f74 se. not │ │ │ │ │ -00049560: 6963 6520 6769 7669 6e67 2074 6865 2070 ice giving the p │ │ │ │ │ -00049570: 7562 6c69 6320 7065 726d 6973 7369 6f6e ublic permission │ │ │ │ │ -00049580: 2074 6f20 7573 6520 7468 6520 4d6f 6469 to use the Modi │ │ │ │ │ -00049590: 6669 6564 0a20 2020 2020 2020 2020 2056 fied. V │ │ │ │ │ -000495a0: 6572 7369 6f6e 2075 6e64 6572 2074 6865 ersion under the │ │ │ │ │ -000495b0: 2074 6572 6d73 206f 6620 7468 6973 204c terms of this L │ │ │ │ │ -000495c0: 6963 656e 7365 2c20 696e 2074 6865 2066 icense, in the f │ │ │ │ │ -000495d0: 6f72 6d20 7368 6f77 6e20 696e 0a20 2020 orm shown in. │ │ │ │ │ -000495e0: 2020 2020 2020 2074 6865 2041 6464 656e the Adden │ │ │ │ │ -000495f0: 6475 6d20 6265 6c6f 772e 0a0a 2020 2020 dum below... │ │ │ │ │ -00049600: 2020 2047 2e20 5072 6573 6572 7665 2069 G. Preserve i │ │ │ │ │ -00049610: 6e20 7468 6174 206c 6963 656e 7365 206e n that license n │ │ │ │ │ -00049620: 6f74 6963 6520 7468 6520 6675 6c6c 206c otice the full l │ │ │ │ │ -00049630: 6973 7473 206f 6620 496e 7661 7269 616e ists of Invarian │ │ │ │ │ -00049640: 740a 2020 2020 2020 2020 2020 5365 6374 t. Sect │ │ │ │ │ -00049650: 696f 6e73 2061 6e64 2072 6571 7569 7265 ions and require │ │ │ │ │ -00049660: 6420 436f 7665 7220 5465 7874 7320 6769 d Cover Texts gi │ │ │ │ │ -00049670: 7665 6e20 696e 2074 6865 2044 6f63 756d ven in the Docum │ │ │ │ │ -00049680: 656e 7427 730a 2020 2020 2020 2020 2020 ent's. │ │ │ │ │ -00049690: 6c69 6365 6e73 6520 6e6f 7469 6365 2e0a license notice.. │ │ │ │ │ -000496a0: 0a20 2020 2020 2020 482e 2049 6e63 6c75 . H. Inclu │ │ │ │ │ -000496b0: 6465 2061 6e20 756e 616c 7465 7265 6420 de an unaltered │ │ │ │ │ -000496c0: 636f 7079 206f 6620 7468 6973 204c 6963 copy of this Lic │ │ │ │ │ -000496d0: 656e 7365 2e0a 0a20 2020 2020 2020 492e ense... I. │ │ │ │ │ -000496e0: 2050 7265 7365 7276 6520 7468 6520 7365 Preserve the se │ │ │ │ │ -000496f0: 6374 696f 6e20 456e 7469 746c 6564 2022 ction Entitled " │ │ │ │ │ -00049700: 4869 7374 6f72 7922 2c20 5072 6573 6572 History", Preser │ │ │ │ │ -00049710: 7665 2069 7473 2054 6974 6c65 2c0a 2020 ve its Title,. │ │ │ │ │ -00049720: 2020 2020 2020 2020 616e 6420 6164 6420 and add │ │ │ │ │ -00049730: 746f 2069 7420 616e 2069 7465 6d20 7374 to it an item st │ │ │ │ │ -00049740: 6174 696e 6720 6174 206c 6561 7374 2074 ating at least t │ │ │ │ │ -00049750: 6865 2074 6974 6c65 2c20 7965 6172 2c20 he title, year, │ │ │ │ │ -00049760: 6e65 770a 2020 2020 2020 2020 2020 6175 new. au │ │ │ │ │ -00049770: 7468 6f72 732c 2061 6e64 2070 7562 6c69 thors, and publi │ │ │ │ │ -00049780: 7368 6572 206f 6620 7468 6520 4d6f 6469 sher of the Modi │ │ │ │ │ -00049790: 6669 6564 2056 6572 7369 6f6e 2061 7320 fied Version as │ │ │ │ │ -000497a0: 6769 7665 6e20 6f6e 2074 6865 0a20 2020 given on the. │ │ │ │ │ -000497b0: 2020 2020 2020 2054 6974 6c65 2050 6167 Title Pag │ │ │ │ │ -000497c0: 652e 2020 4966 2074 6865 7265 2069 7320 e. If there is │ │ │ │ │ -000497d0: 6e6f 2073 6563 7469 6f6e 2045 6e74 6974 no section Entit │ │ │ │ │ -000497e0: 6c65 6420 2248 6973 746f 7279 2220 696e led "History" in │ │ │ │ │ -000497f0: 2074 6865 0a20 2020 2020 2020 2020 2044 the. D │ │ │ │ │ -00049800: 6f63 756d 656e 742c 2063 7265 6174 6520 ocument, create │ │ │ │ │ -00049810: 6f6e 6520 7374 6174 696e 6720 7468 6520 one stating the │ │ │ │ │ -00049820: 7469 746c 652c 2079 6561 722c 2061 7574 title, year, aut │ │ │ │ │ -00049830: 686f 7273 2c20 616e 640a 2020 2020 2020 hors, and. │ │ │ │ │ -00049840: 2020 2020 7075 626c 6973 6865 7220 6f66 publisher of │ │ │ │ │ -00049850: 2074 6865 2044 6f63 756d 656e 7420 6173 the Document as │ │ │ │ │ -00049860: 2067 6976 656e 206f 6e20 6974 7320 5469 given on its Ti │ │ │ │ │ -00049870: 746c 6520 5061 6765 2c20 7468 656e 2061 tle Page, then a │ │ │ │ │ -00049880: 6464 0a20 2020 2020 2020 2020 2061 6e20 dd. an │ │ │ │ │ -00049890: 6974 656d 2064 6573 6372 6962 696e 6720 item describing │ │ │ │ │ -000498a0: 7468 6520 4d6f 6469 6669 6564 2056 6572 the Modified Ver │ │ │ │ │ -000498b0: 7369 6f6e 2061 7320 7374 6174 6564 2069 sion as stated i │ │ │ │ │ -000498c0: 6e20 7468 650a 2020 2020 2020 2020 2020 n the. │ │ │ │ │ -000498d0: 7072 6576 696f 7573 2073 656e 7465 6e63 previous sentenc │ │ │ │ │ -000498e0: 652e 0a0a 2020 2020 2020 204a 2e20 5072 e... J. Pr │ │ │ │ │ -000498f0: 6573 6572 7665 2074 6865 206e 6574 776f eserve the netwo │ │ │ │ │ -00049900: 726b 206c 6f63 6174 696f 6e2c 2069 6620 rk location, if │ │ │ │ │ -00049910: 616e 792c 2067 6976 656e 2069 6e20 7468 any, given in th │ │ │ │ │ -00049920: 6520 446f 6375 6d65 6e74 0a20 2020 2020 e Document. │ │ │ │ │ -00049930: 2020 2020 2066 6f72 2070 7562 6c69 6320 for public │ │ │ │ │ -00049940: 6163 6365 7373 2074 6f20 6120 5472 616e access to a Tran │ │ │ │ │ -00049950: 7370 6172 656e 7420 636f 7079 206f 6620 sparent copy of │ │ │ │ │ -00049960: 7468 6520 446f 6375 6d65 6e74 2c20 616e the Document, an │ │ │ │ │ -00049970: 640a 2020 2020 2020 2020 2020 6c69 6b65 d. like │ │ │ │ │ -00049980: 7769 7365 2074 6865 206e 6574 776f 726b wise the network │ │ │ │ │ -00049990: 206c 6f63 6174 696f 6e73 2067 6976 656e locations given │ │ │ │ │ -000499a0: 2069 6e20 7468 6520 446f 6375 6d65 6e74 in the Document │ │ │ │ │ -000499b0: 2066 6f72 0a20 2020 2020 2020 2020 2070 for. p │ │ │ │ │ -000499c0: 7265 7669 6f75 7320 7665 7273 696f 6e73 revious versions │ │ │ │ │ -000499d0: 2069 7420 7761 7320 6261 7365 6420 6f6e it was based on │ │ │ │ │ -000499e0: 2e20 2054 6865 7365 206d 6179 2062 6520 . These may be │ │ │ │ │ -000499f0: 706c 6163 6564 2069 6e20 7468 650a 2020 placed in the. │ │ │ │ │ -00049a00: 2020 2020 2020 2020 2248 6973 746f 7279 "History │ │ │ │ │ -00049a10: 2220 7365 6374 696f 6e2e 2020 596f 7520 " section. You │ │ │ │ │ -00049a20: 6d61 7920 6f6d 6974 2061 206e 6574 776f may omit a netwo │ │ │ │ │ -00049a30: 726b 206c 6f63 6174 696f 6e20 666f 7220 rk location for │ │ │ │ │ -00049a40: 6120 776f 726b 0a20 2020 2020 2020 2020 a work. │ │ │ │ │ -00049a50: 2074 6861 7420 7761 7320 7075 626c 6973 that was publis │ │ │ │ │ -00049a60: 6865 6420 6174 206c 6561 7374 2066 6f75 hed at least fou │ │ │ │ │ -00049a70: 7220 7965 6172 7320 6265 666f 7265 2074 r years before t │ │ │ │ │ -00049a80: 6865 2044 6f63 756d 656e 740a 2020 2020 he Document. │ │ │ │ │ -00049a90: 2020 2020 2020 6974 7365 6c66 2c20 6f72 itself, or │ │ │ │ │ -00049aa0: 2069 6620 7468 6520 6f72 6967 696e 616c if the original │ │ │ │ │ -00049ab0: 2070 7562 6c69 7368 6572 206f 6620 7468 publisher of th │ │ │ │ │ -00049ac0: 6520 7665 7273 696f 6e20 6974 2072 6566 e version it ref │ │ │ │ │ -00049ad0: 6572 730a 2020 2020 2020 2020 2020 746f ers. to │ │ │ │ │ -00049ae0: 2067 6976 6573 2070 6572 6d69 7373 696f gives permissio │ │ │ │ │ -00049af0: 6e2e 0a0a 2020 2020 2020 204b 2e20 466f n... K. Fo │ │ │ │ │ -00049b00: 7220 616e 7920 7365 6374 696f 6e20 456e r any section En │ │ │ │ │ -00049b10: 7469 746c 6564 2022 4163 6b6e 6f77 6c65 titled "Acknowle │ │ │ │ │ -00049b20: 6467 656d 656e 7473 2220 6f72 2022 4465 dgements" or "De │ │ │ │ │ -00049b30: 6469 6361 7469 6f6e 7322 2c0a 2020 2020 dications",. │ │ │ │ │ -00049b40: 2020 2020 2020 5072 6573 6572 7665 2074 Preserve t │ │ │ │ │ -00049b50: 6865 2054 6974 6c65 206f 6620 7468 6520 he Title of the │ │ │ │ │ -00049b60: 7365 6374 696f 6e2c 2061 6e64 2070 7265 section, and pre │ │ │ │ │ -00049b70: 7365 7276 6520 696e 2074 6865 2073 6563 serve in the sec │ │ │ │ │ -00049b80: 7469 6f6e 0a20 2020 2020 2020 2020 2061 tion. a │ │ │ │ │ -00049b90: 6c6c 2074 6865 2073 7562 7374 616e 6365 ll the substance │ │ │ │ │ -00049ba0: 2061 6e64 2074 6f6e 6520 6f66 2065 6163 and tone of eac │ │ │ │ │ -00049bb0: 6820 6f66 2074 6865 2063 6f6e 7472 6962 h of the contrib │ │ │ │ │ -00049bc0: 7574 6f72 0a20 2020 2020 2020 2020 2061 utor. a │ │ │ │ │ -00049bd0: 636b 6e6f 776c 6564 6765 6d65 6e74 7320 cknowledgements │ │ │ │ │ -00049be0: 616e 642f 6f72 2064 6564 6963 6174 696f and/or dedicatio │ │ │ │ │ -00049bf0: 6e73 2067 6976 656e 2074 6865 7265 696e ns given therein │ │ │ │ │ -00049c00: 2e0a 0a20 2020 2020 2020 4c2e 2050 7265 ... L. Pre │ │ │ │ │ -00049c10: 7365 7276 6520 616c 6c20 7468 6520 496e serve all the In │ │ │ │ │ -00049c20: 7661 7269 616e 7420 5365 6374 696f 6e73 variant Sections │ │ │ │ │ -00049c30: 206f 6620 7468 6520 446f 6375 6d65 6e74 of the Document │ │ │ │ │ -00049c40: 2c20 756e 616c 7465 7265 640a 2020 2020 , unaltered. │ │ │ │ │ -00049c50: 2020 2020 2020 696e 2074 6865 6972 2074 in their t │ │ │ │ │ -00049c60: 6578 7420 616e 6420 696e 2074 6865 6972 ext and in their │ │ │ │ │ -00049c70: 2074 6974 6c65 732e 2020 5365 6374 696f titles. Sectio │ │ │ │ │ -00049c80: 6e20 6e75 6d62 6572 7320 6f72 2074 6865 n numbers or the │ │ │ │ │ -00049c90: 0a20 2020 2020 2020 2020 2065 7175 6976 . equiv │ │ │ │ │ -00049ca0: 616c 656e 7420 6172 6520 6e6f 7420 636f alent are not co │ │ │ │ │ -00049cb0: 6e73 6964 6572 6564 2070 6172 7420 6f66 nsidered part of │ │ │ │ │ -00049cc0: 2074 6865 2073 6563 7469 6f6e 2074 6974 the section tit │ │ │ │ │ -00049cd0: 6c65 732e 0a0a 2020 2020 2020 204d 2e20 les... M. │ │ │ │ │ -00049ce0: 4465 6c65 7465 2061 6e79 2073 6563 7469 Delete any secti │ │ │ │ │ -00049cf0: 6f6e 2045 6e74 6974 6c65 6420 2245 6e64 on Entitled "End │ │ │ │ │ -00049d00: 6f72 7365 6d65 6e74 7322 2e20 2053 7563 orsements". Suc │ │ │ │ │ -00049d10: 6820 6120 7365 6374 696f 6e0a 2020 2020 h a section. │ │ │ │ │ -00049d20: 2020 2020 2020 6d61 7920 6e6f 7420 6265 may not be │ │ │ │ │ -00049d30: 2069 6e63 6c75 6465 6420 696e 2074 6865 included in the │ │ │ │ │ -00049d40: 204d 6f64 6966 6965 6420 5665 7273 696f Modified Versio │ │ │ │ │ -00049d50: 6e2e 0a0a 2020 2020 2020 204e 2e20 446f n... N. Do │ │ │ │ │ -00049d60: 206e 6f74 2072 6574 6974 6c65 2061 6e79 not retitle any │ │ │ │ │ -00049d70: 2065 7869 7374 696e 6720 7365 6374 696f existing sectio │ │ │ │ │ -00049d80: 6e20 746f 2062 6520 456e 7469 746c 6564 n to be Entitled │ │ │ │ │ -00049d90: 0a20 2020 2020 2020 2020 2022 456e 646f . "Endo │ │ │ │ │ -00049da0: 7273 656d 656e 7473 2220 6f72 2074 6f20 rsements" or to │ │ │ │ │ -00049db0: 636f 6e66 6c69 6374 2069 6e20 7469 746c conflict in titl │ │ │ │ │ -00049dc0: 6520 7769 7468 2061 6e79 2049 6e76 6172 e with any Invar │ │ │ │ │ -00049dd0: 6961 6e74 0a20 2020 2020 2020 2020 2053 iant. S │ │ │ │ │ -00049de0: 6563 7469 6f6e 2e0a 0a20 2020 2020 2020 ection... │ │ │ │ │ -00049df0: 4f2e 2050 7265 7365 7276 6520 616e 7920 O. Preserve any │ │ │ │ │ -00049e00: 5761 7272 616e 7479 2044 6973 636c 6169 Warranty Disclai │ │ │ │ │ -00049e10: 6d65 7273 2e0a 0a20 2020 2020 4966 2074 mers... If t │ │ │ │ │ -00049e20: 6865 204d 6f64 6966 6965 6420 5665 7273 he Modified Vers │ │ │ │ │ -00049e30: 696f 6e20 696e 636c 7564 6573 206e 6577 ion includes new │ │ │ │ │ -00049e40: 2066 726f 6e74 2d6d 6174 7465 7220 7365 front-matter se │ │ │ │ │ -00049e50: 6374 696f 6e73 206f 720a 2020 2020 2061 ctions or. a │ │ │ │ │ -00049e60: 7070 656e 6469 6365 7320 7468 6174 2071 ppendices that q │ │ │ │ │ -00049e70: 7561 6c69 6679 2061 7320 5365 636f 6e64 ualify as Second │ │ │ │ │ -00049e80: 6172 7920 5365 6374 696f 6e73 2061 6e64 ary Sections and │ │ │ │ │ -00049e90: 2063 6f6e 7461 696e 206e 6f0a 2020 2020 contain no. │ │ │ │ │ -00049ea0: 206d 6174 6572 6961 6c20 636f 7069 6564 material copied │ │ │ │ │ -00049eb0: 2066 726f 6d20 7468 6520 446f 6375 6d65 from the Docume │ │ │ │ │ -00049ec0: 6e74 2c20 796f 7520 6d61 7920 6174 2079 nt, you may at y │ │ │ │ │ -00049ed0: 6f75 7220 6f70 7469 6f6e 2064 6573 6967 our option desig │ │ │ │ │ -00049ee0: 6e61 7465 0a20 2020 2020 736f 6d65 206f nate. some o │ │ │ │ │ -00049ef0: 7220 616c 6c20 6f66 2074 6865 7365 2073 r all of these s │ │ │ │ │ -00049f00: 6563 7469 6f6e 7320 6173 2069 6e76 6172 ections as invar │ │ │ │ │ -00049f10: 6961 6e74 2e20 2054 6f20 646f 2074 6869 iant. To do thi │ │ │ │ │ -00049f20: 732c 2061 6464 2074 6865 6972 0a20 2020 s, add their. │ │ │ │ │ -00049f30: 2020 7469 746c 6573 2074 6f20 7468 6520 titles to the │ │ │ │ │ -00049f40: 6c69 7374 206f 6620 496e 7661 7269 616e list of Invarian │ │ │ │ │ -00049f50: 7420 5365 6374 696f 6e73 2069 6e20 7468 t Sections in th │ │ │ │ │ -00049f60: 6520 4d6f 6469 6669 6564 2056 6572 7369 e Modified Versi │ │ │ │ │ -00049f70: 6f6e 2773 0a20 2020 2020 6c69 6365 6e73 on's. licens │ │ │ │ │ -00049f80: 6520 6e6f 7469 6365 2e20 2054 6865 7365 e notice. These │ │ │ │ │ -00049f90: 2074 6974 6c65 7320 6d75 7374 2062 6520 titles must be │ │ │ │ │ -00049fa0: 6469 7374 696e 6374 2066 726f 6d20 616e distinct from an │ │ │ │ │ -00049fb0: 7920 6f74 6865 720a 2020 2020 2073 6563 y other. sec │ │ │ │ │ -00049fc0: 7469 6f6e 2074 6974 6c65 732e 0a0a 2020 tion titles... │ │ │ │ │ -00049fd0: 2020 2059 6f75 206d 6179 2061 6464 2061 You may add a │ │ │ │ │ -00049fe0: 2073 6563 7469 6f6e 2045 6e74 6974 6c65 section Entitle │ │ │ │ │ -00049ff0: 6420 2245 6e64 6f72 7365 6d65 6e74 7322 d "Endorsements" │ │ │ │ │ -0004a000: 2c20 7072 6f76 6964 6564 2069 7420 636f , provided it co │ │ │ │ │ -0004a010: 6e74 6169 6e73 0a20 2020 2020 6e6f 7468 ntains. noth │ │ │ │ │ -0004a020: 696e 6720 6275 7420 656e 646f 7273 656d ing but endorsem │ │ │ │ │ -0004a030: 656e 7473 206f 6620 796f 7572 204d 6f64 ents of your Mod │ │ │ │ │ -0004a040: 6966 6965 6420 5665 7273 696f 6e20 6279 ified Version by │ │ │ │ │ -0004a050: 2076 6172 696f 7573 0a20 2020 2020 7061 various. pa │ │ │ │ │ -0004a060: 7274 6965 732d 2d66 6f72 2065 7861 6d70 rties--for examp │ │ │ │ │ -0004a070: 6c65 2c20 7374 6174 656d 656e 7473 206f le, statements o │ │ │ │ │ -0004a080: 6620 7065 6572 2072 6576 6965 7720 6f72 f peer review or │ │ │ │ │ -0004a090: 2074 6861 7420 7468 6520 7465 7874 0a20 that the text. │ │ │ │ │ -0004a0a0: 2020 2020 6861 7320 6265 656e 2061 7070 has been app │ │ │ │ │ -0004a0b0: 726f 7665 6420 6279 2061 6e20 6f72 6761 roved by an orga │ │ │ │ │ -0004a0c0: 6e69 7a61 7469 6f6e 2061 7320 7468 6520 nization as the │ │ │ │ │ -0004a0d0: 6175 7468 6f72 6974 6174 6976 650a 2020 authoritative. │ │ │ │ │ -0004a0e0: 2020 2064 6566 696e 6974 696f 6e20 6f66 definition of │ │ │ │ │ -0004a0f0: 2061 2073 7461 6e64 6172 642e 0a0a 2020 a standard... │ │ │ │ │ -0004a100: 2020 2059 6f75 206d 6179 2061 6464 2061 You may add a │ │ │ │ │ -0004a110: 2070 6173 7361 6765 206f 6620 7570 2074 passage of up t │ │ │ │ │ -0004a120: 6f20 6669 7665 2077 6f72 6473 2061 7320 o five words as │ │ │ │ │ -0004a130: 6120 4672 6f6e 742d 436f 7665 7220 5465 a Front-Cover Te │ │ │ │ │ -0004a140: 7874 2c0a 2020 2020 2061 6e64 2061 2070 xt,. and a p │ │ │ │ │ -0004a150: 6173 7361 6765 206f 6620 7570 2074 6f20 assage of up to │ │ │ │ │ -0004a160: 3235 2077 6f72 6473 2061 7320 6120 4261 25 words as a Ba │ │ │ │ │ -0004a170: 636b 2d43 6f76 6572 2054 6578 742c 2074 ck-Cover Text, t │ │ │ │ │ -0004a180: 6f20 7468 6520 656e 6420 6f66 0a20 2020 o the end of. │ │ │ │ │ -0004a190: 2020 7468 6520 6c69 7374 206f 6620 436f the list of Co │ │ │ │ │ -0004a1a0: 7665 7220 5465 7874 7320 696e 2074 6865 ver Texts in the │ │ │ │ │ -0004a1b0: 204d 6f64 6966 6965 6420 5665 7273 696f Modified Versio │ │ │ │ │ -0004a1c0: 6e2e 2020 4f6e 6c79 206f 6e65 2070 6173 n. Only one pas │ │ │ │ │ -0004a1d0: 7361 6765 0a20 2020 2020 6f66 2046 726f sage. of Fro │ │ │ │ │ -0004a1e0: 6e74 2d43 6f76 6572 2054 6578 7420 616e nt-Cover Text an │ │ │ │ │ -0004a1f0: 6420 6f6e 6520 6f66 2042 6163 6b2d 436f d one of Back-Co │ │ │ │ │ -0004a200: 7665 7220 5465 7874 206d 6179 2062 6520 ver Text may be │ │ │ │ │ -0004a210: 6164 6465 6420 6279 2028 6f72 0a20 2020 added by (or. │ │ │ │ │ -0004a220: 2020 7468 726f 7567 6820 6172 7261 6e67 through arrang │ │ │ │ │ -0004a230: 656d 656e 7473 206d 6164 6520 6279 2920 ements made by) │ │ │ │ │ -0004a240: 616e 7920 6f6e 6520 656e 7469 7479 2e20 any one entity. │ │ │ │ │ -0004a250: 2049 6620 7468 6520 446f 6375 6d65 6e74 If the Document │ │ │ │ │ -0004a260: 0a20 2020 2020 616c 7265 6164 7920 696e . already in │ │ │ │ │ -0004a270: 636c 7564 6573 2061 2063 6f76 6572 2074 cludes a cover t │ │ │ │ │ -0004a280: 6578 7420 666f 7220 7468 6520 7361 6d65 ext for the same │ │ │ │ │ -0004a290: 2063 6f76 6572 2c20 7072 6576 696f 7573 cover, previous │ │ │ │ │ -0004a2a0: 6c79 2061 6464 6564 0a20 2020 2020 6279 ly added. by │ │ │ │ │ -0004a2b0: 2079 6f75 206f 7220 6279 2061 7272 616e you or by arran │ │ │ │ │ -0004a2c0: 6765 6d65 6e74 206d 6164 6520 6279 2074 gement made by t │ │ │ │ │ -0004a2d0: 6865 2073 616d 6520 656e 7469 7479 2079 he same entity y │ │ │ │ │ -0004a2e0: 6f75 2061 7265 2061 6374 696e 6720 6f6e ou are acting on │ │ │ │ │ -0004a2f0: 0a20 2020 2020 6265 6861 6c66 206f 662c . behalf of, │ │ │ │ │ -0004a300: 2079 6f75 206d 6179 206e 6f74 2061 6464 you may not add │ │ │ │ │ -0004a310: 2061 6e6f 7468 6572 3b20 6275 7420 796f another; but yo │ │ │ │ │ -0004a320: 7520 6d61 7920 7265 706c 6163 6520 7468 u may replace th │ │ │ │ │ -0004a330: 6520 6f6c 640a 2020 2020 206f 6e65 2c20 e old. one, │ │ │ │ │ -0004a340: 6f6e 2065 7870 6c69 6369 7420 7065 726d on explicit perm │ │ │ │ │ -0004a350: 6973 7369 6f6e 2066 726f 6d20 7468 6520 ission from the │ │ │ │ │ -0004a360: 7072 6576 696f 7573 2070 7562 6c69 7368 previous publish │ │ │ │ │ -0004a370: 6572 2074 6861 7420 6164 6465 640a 2020 er that added. │ │ │ │ │ -0004a380: 2020 2074 6865 206f 6c64 206f 6e65 2e0a the old one.. │ │ │ │ │ -0004a390: 0a20 2020 2020 5468 6520 6175 7468 6f72 . The author │ │ │ │ │ -0004a3a0: 2873 2920 616e 6420 7075 626c 6973 6865 (s) and publishe │ │ │ │ │ -0004a3b0: 7228 7329 206f 6620 7468 6520 446f 6375 r(s) of the Docu │ │ │ │ │ -0004a3c0: 6d65 6e74 2064 6f20 6e6f 7420 6279 2074 ment do not by t │ │ │ │ │ -0004a3d0: 6869 730a 2020 2020 204c 6963 656e 7365 his. License │ │ │ │ │ -0004a3e0: 2067 6976 6520 7065 726d 6973 7369 6f6e give permission │ │ │ │ │ -0004a3f0: 2074 6f20 7573 6520 7468 6569 7220 6e61 to use their na │ │ │ │ │ -0004a400: 6d65 7320 666f 7220 7075 626c 6963 6974 mes for publicit │ │ │ │ │ -0004a410: 7920 666f 7220 6f72 2074 6f0a 2020 2020 y for or to. │ │ │ │ │ -0004a420: 2061 7373 6572 7420 6f72 2069 6d70 6c79 assert or imply │ │ │ │ │ -0004a430: 2065 6e64 6f72 7365 6d65 6e74 206f 6620 endorsement of │ │ │ │ │ -0004a440: 616e 7920 4d6f 6469 6669 6564 2056 6572 any Modified Ver │ │ │ │ │ -0004a450: 7369 6f6e 2e0a 0a20 2035 2e20 434f 4d42 sion... 5. COMB │ │ │ │ │ -0004a460: 494e 494e 4720 444f 4355 4d45 4e54 530a INING DOCUMENTS. │ │ │ │ │ -0004a470: 0a20 2020 2020 596f 7520 6d61 7920 636f . You may co │ │ │ │ │ -0004a480: 6d62 696e 6520 7468 6520 446f 6375 6d65 mbine the Docume │ │ │ │ │ -0004a490: 6e74 2077 6974 6820 6f74 6865 7220 646f nt with other do │ │ │ │ │ -0004a4a0: 6375 6d65 6e74 7320 7265 6c65 6173 6564 cuments released │ │ │ │ │ -0004a4b0: 2075 6e64 6572 0a20 2020 2020 7468 6973 under. this │ │ │ │ │ -0004a4c0: 204c 6963 656e 7365 2c20 756e 6465 7220 License, under │ │ │ │ │ -0004a4d0: 7468 6520 7465 726d 7320 6465 6669 6e65 the terms define │ │ │ │ │ -0004a4e0: 6420 696e 2073 6563 7469 6f6e 2034 2061 d in section 4 a │ │ │ │ │ -0004a4f0: 626f 7665 2066 6f72 0a20 2020 2020 6d6f bove for. mo │ │ │ │ │ -0004a500: 6469 6669 6564 2076 6572 7369 6f6e 732c dified versions, │ │ │ │ │ -0004a510: 2070 726f 7669 6465 6420 7468 6174 2079 provided that y │ │ │ │ │ -0004a520: 6f75 2069 6e63 6c75 6465 2069 6e20 7468 ou include in th │ │ │ │ │ -0004a530: 6520 636f 6d62 696e 6174 696f 6e20 616c e combination al │ │ │ │ │ -0004a540: 6c0a 2020 2020 206f 6620 7468 6520 496e l. of the In │ │ │ │ │ -0004a550: 7661 7269 616e 7420 5365 6374 696f 6e73 variant Sections │ │ │ │ │ -0004a560: 206f 6620 616c 6c20 6f66 2074 6865 206f of all of the o │ │ │ │ │ -0004a570: 7269 6769 6e61 6c20 646f 6375 6d65 6e74 riginal document │ │ │ │ │ -0004a580: 732c 0a20 2020 2020 756e 6d6f 6469 6669 s,. unmodifi │ │ │ │ │ -0004a590: 6564 2c20 616e 6420 6c69 7374 2074 6865 ed, and list the │ │ │ │ │ -0004a5a0: 6d20 616c 6c20 6173 2049 6e76 6172 6961 m all as Invaria │ │ │ │ │ -0004a5b0: 6e74 2053 6563 7469 6f6e 7320 6f66 2079 nt Sections of y │ │ │ │ │ -0004a5c0: 6f75 720a 2020 2020 2063 6f6d 6269 6e65 our. combine │ │ │ │ │ -0004a5d0: 6420 776f 726b 2069 6e20 6974 7320 6c69 d work in its li │ │ │ │ │ -0004a5e0: 6365 6e73 6520 6e6f 7469 6365 2c20 616e cense notice, an │ │ │ │ │ -0004a5f0: 6420 7468 6174 2079 6f75 2070 7265 7365 d that you prese │ │ │ │ │ -0004a600: 7276 6520 616c 6c0a 2020 2020 2074 6865 rve all. the │ │ │ │ │ -0004a610: 6972 2057 6172 7261 6e74 7920 4469 7363 ir Warranty Disc │ │ │ │ │ -0004a620: 6c61 696d 6572 732e 0a0a 2020 2020 2054 laimers... T │ │ │ │ │ -0004a630: 6865 2063 6f6d 6269 6e65 6420 776f 726b he combined work │ │ │ │ │ -0004a640: 206e 6565 6420 6f6e 6c79 2063 6f6e 7461 need only conta │ │ │ │ │ -0004a650: 696e 206f 6e65 2063 6f70 7920 6f66 2074 in one copy of t │ │ │ │ │ -0004a660: 6869 7320 4c69 6365 6e73 652c 2061 6e64 his License, and │ │ │ │ │ -0004a670: 0a20 2020 2020 6d75 6c74 6970 6c65 2069 . multiple i │ │ │ │ │ -0004a680: 6465 6e74 6963 616c 2049 6e76 6172 6961 dentical Invaria │ │ │ │ │ -0004a690: 6e74 2053 6563 7469 6f6e 7320 6d61 7920 nt Sections may │ │ │ │ │ -0004a6a0: 6265 2072 6570 6c61 6365 6420 7769 7468 be replaced with │ │ │ │ │ -0004a6b0: 2061 2073 696e 676c 650a 2020 2020 2063 a single. c │ │ │ │ │ -0004a6c0: 6f70 792e 2020 4966 2074 6865 7265 2061 opy. If there a │ │ │ │ │ -0004a6d0: 7265 206d 756c 7469 706c 6520 496e 7661 re multiple Inva │ │ │ │ │ -0004a6e0: 7269 616e 7420 5365 6374 696f 6e73 2077 riant Sections w │ │ │ │ │ -0004a6f0: 6974 6820 7468 6520 7361 6d65 206e 616d ith the same nam │ │ │ │ │ -0004a700: 650a 2020 2020 2062 7574 2064 6966 6665 e. but diffe │ │ │ │ │ -0004a710: 7265 6e74 2063 6f6e 7465 6e74 732c 206d rent contents, m │ │ │ │ │ -0004a720: 616b 6520 7468 6520 7469 746c 6520 6f66 ake the title of │ │ │ │ │ -0004a730: 2065 6163 6820 7375 6368 2073 6563 7469 each such secti │ │ │ │ │ -0004a740: 6f6e 2075 6e69 7175 650a 2020 2020 2062 on unique. b │ │ │ │ │ -0004a750: 7920 6164 6469 6e67 2061 7420 7468 6520 y adding at the │ │ │ │ │ -0004a760: 656e 6420 6f66 2069 742c 2069 6e20 7061 end of it, in pa │ │ │ │ │ -0004a770: 7265 6e74 6865 7365 732c 2074 6865 206e rentheses, the n │ │ │ │ │ -0004a780: 616d 6520 6f66 2074 6865 0a20 2020 2020 ame of the. │ │ │ │ │ -0004a790: 6f72 6967 696e 616c 2061 7574 686f 7220 original author │ │ │ │ │ -0004a7a0: 6f72 2070 7562 6c69 7368 6572 206f 6620 or publisher of │ │ │ │ │ -0004a7b0: 7468 6174 2073 6563 7469 6f6e 2069 6620 that section if │ │ │ │ │ -0004a7c0: 6b6e 6f77 6e2c 206f 7220 656c 7365 2061 known, or else a │ │ │ │ │ -0004a7d0: 0a20 2020 2020 756e 6971 7565 206e 756d . unique num │ │ │ │ │ -0004a7e0: 6265 722e 2020 4d61 6b65 2074 6865 2073 ber. Make the s │ │ │ │ │ -0004a7f0: 616d 6520 6164 6a75 7374 6d65 6e74 2074 ame adjustment t │ │ │ │ │ -0004a800: 6f20 7468 6520 7365 6374 696f 6e20 7469 o the section ti │ │ │ │ │ -0004a810: 746c 6573 2069 6e0a 2020 2020 2074 6865 tles in. the │ │ │ │ │ -0004a820: 206c 6973 7420 6f66 2049 6e76 6172 6961 list of Invaria │ │ │ │ │ -0004a830: 6e74 2053 6563 7469 6f6e 7320 696e 2074 nt Sections in t │ │ │ │ │ -0004a840: 6865 206c 6963 656e 7365 206e 6f74 6963 he license notic │ │ │ │ │ -0004a850: 6520 6f66 2074 6865 0a20 2020 2020 636f e of the. co │ │ │ │ │ -0004a860: 6d62 696e 6564 2077 6f72 6b2e 0a0a 2020 mbined work... │ │ │ │ │ -0004a870: 2020 2049 6e20 7468 6520 636f 6d62 696e In the combin │ │ │ │ │ -0004a880: 6174 696f 6e2c 2079 6f75 206d 7573 7420 ation, you must │ │ │ │ │ -0004a890: 636f 6d62 696e 6520 616e 7920 7365 6374 combine any sect │ │ │ │ │ -0004a8a0: 696f 6e73 2045 6e74 6974 6c65 640a 2020 ions Entitled. │ │ │ │ │ -0004a8b0: 2020 2022 4869 7374 6f72 7922 2069 6e20 "History" in │ │ │ │ │ -0004a8c0: 7468 6520 7661 7269 6f75 7320 6f72 6967 the various orig │ │ │ │ │ -0004a8d0: 696e 616c 2064 6f63 756d 656e 7473 2c20 inal documents, │ │ │ │ │ -0004a8e0: 666f 726d 696e 6720 6f6e 6520 7365 6374 forming one sect │ │ │ │ │ -0004a8f0: 696f 6e0a 2020 2020 2045 6e74 6974 6c65 ion. Entitle │ │ │ │ │ -0004a900: 6420 2248 6973 746f 7279 223b 206c 696b d "History"; lik │ │ │ │ │ -0004a910: 6577 6973 6520 636f 6d62 696e 6520 616e ewise combine an │ │ │ │ │ -0004a920: 7920 7365 6374 696f 6e73 2045 6e74 6974 y sections Entit │ │ │ │ │ -0004a930: 6c65 640a 2020 2020 2022 4163 6b6e 6f77 led. "Acknow │ │ │ │ │ -0004a940: 6c65 6467 656d 656e 7473 222c 2061 6e64 ledgements", and │ │ │ │ │ -0004a950: 2061 6e79 2073 6563 7469 6f6e 7320 456e any sections En │ │ │ │ │ -0004a960: 7469 746c 6564 2022 4465 6469 6361 7469 titled "Dedicati │ │ │ │ │ -0004a970: 6f6e 7322 2e20 2059 6f75 0a20 2020 2020 ons". You. │ │ │ │ │ -0004a980: 6d75 7374 2064 656c 6574 6520 616c 6c20 must delete all │ │ │ │ │ -0004a990: 7365 6374 696f 6e73 2045 6e74 6974 6c65 sections Entitle │ │ │ │ │ -0004a9a0: 6420 2245 6e64 6f72 7365 6d65 6e74 732e d "Endorsements. │ │ │ │ │ -0004a9b0: 220a 0a20 2036 2e20 434f 4c4c 4543 5449 ".. 6. COLLECTI │ │ │ │ │ -0004a9c0: 4f4e 5320 4f46 2044 4f43 554d 454e 5453 ONS OF DOCUMENTS │ │ │ │ │ -0004a9d0: 0a0a 2020 2020 2059 6f75 206d 6179 206d .. You may m │ │ │ │ │ -0004a9e0: 616b 6520 6120 636f 6c6c 6563 7469 6f6e ake a collection │ │ │ │ │ -0004a9f0: 2063 6f6e 7369 7374 696e 6720 6f66 2074 consisting of t │ │ │ │ │ -0004aa00: 6865 2044 6f63 756d 656e 7420 616e 6420 he Document and │ │ │ │ │ -0004aa10: 6f74 6865 720a 2020 2020 2064 6f63 756d other. docum │ │ │ │ │ -0004aa20: 656e 7473 2072 656c 6561 7365 6420 756e ents released un │ │ │ │ │ -0004aa30: 6465 7220 7468 6973 204c 6963 656e 7365 der this License │ │ │ │ │ -0004aa40: 2c20 616e 6420 7265 706c 6163 6520 7468 , and replace th │ │ │ │ │ -0004aa50: 6520 696e 6469 7669 6475 616c 0a20 2020 e individual. │ │ │ │ │ -0004aa60: 2020 636f 7069 6573 206f 6620 7468 6973 copies of this │ │ │ │ │ -0004aa70: 204c 6963 656e 7365 2069 6e20 7468 6520 License in the │ │ │ │ │ -0004aa80: 7661 7269 6f75 7320 646f 6375 6d65 6e74 various document │ │ │ │ │ -0004aa90: 7320 7769 7468 2061 2073 696e 676c 6520 s with a single │ │ │ │ │ -0004aaa0: 636f 7079 0a20 2020 2020 7468 6174 2069 copy. that i │ │ │ │ │ -0004aab0: 7320 696e 636c 7564 6564 2069 6e20 7468 s included in th │ │ │ │ │ -0004aac0: 6520 636f 6c6c 6563 7469 6f6e 2c20 7072 e collection, pr │ │ │ │ │ -0004aad0: 6f76 6964 6564 2074 6861 7420 796f 7520 ovided that you │ │ │ │ │ -0004aae0: 666f 6c6c 6f77 2074 6865 0a20 2020 2020 follow the. │ │ │ │ │ -0004aaf0: 7275 6c65 7320 6f66 2074 6869 7320 4c69 rules of this Li │ │ │ │ │ -0004ab00: 6365 6e73 6520 666f 7220 7665 7262 6174 cense for verbat │ │ │ │ │ -0004ab10: 696d 2063 6f70 7969 6e67 206f 6620 6561 im copying of ea │ │ │ │ │ -0004ab20: 6368 206f 6620 7468 6520 646f 6375 6d65 ch of the docume │ │ │ │ │ -0004ab30: 6e74 730a 2020 2020 2069 6e20 616c 6c20 nts. in all │ │ │ │ │ -0004ab40: 6f74 6865 7220 7265 7370 6563 7473 2e0a other respects.. │ │ │ │ │ -0004ab50: 0a20 2020 2020 596f 7520 6d61 7920 6578 . You may ex │ │ │ │ │ -0004ab60: 7472 6163 7420 6120 7369 6e67 6c65 2064 tract a single d │ │ │ │ │ -0004ab70: 6f63 756d 656e 7420 6672 6f6d 2073 7563 ocument from suc │ │ │ │ │ -0004ab80: 6820 6120 636f 6c6c 6563 7469 6f6e 2c20 h a collection, │ │ │ │ │ -0004ab90: 616e 640a 2020 2020 2064 6973 7472 6962 and. distrib │ │ │ │ │ -0004aba0: 7574 6520 6974 2069 6e64 6976 6964 7561 ute it individua │ │ │ │ │ -0004abb0: 6c6c 7920 756e 6465 7220 7468 6973 204c lly under this L │ │ │ │ │ -0004abc0: 6963 656e 7365 2c20 7072 6f76 6964 6564 icense, provided │ │ │ │ │ -0004abd0: 2079 6f75 2069 6e73 6572 740a 2020 2020 you insert. │ │ │ │ │ -0004abe0: 2061 2063 6f70 7920 6f66 2074 6869 7320 a copy of this │ │ │ │ │ -0004abf0: 4c69 6365 6e73 6520 696e 746f 2074 6865 License into the │ │ │ │ │ -0004ac00: 2065 7874 7261 6374 6564 2064 6f63 756d extracted docum │ │ │ │ │ -0004ac10: 656e 742c 2061 6e64 2066 6f6c 6c6f 7720 ent, and follow │ │ │ │ │ -0004ac20: 7468 6973 0a20 2020 2020 4c69 6365 6e73 this. Licens │ │ │ │ │ -0004ac30: 6520 696e 2061 6c6c 206f 7468 6572 2072 e in all other r │ │ │ │ │ -0004ac40: 6573 7065 6374 7320 7265 6761 7264 696e espects regardin │ │ │ │ │ -0004ac50: 6720 7665 7262 6174 696d 2063 6f70 7969 g verbatim copyi │ │ │ │ │ -0004ac60: 6e67 206f 6620 7468 6174 0a20 2020 2020 ng of that. │ │ │ │ │ -0004ac70: 646f 6375 6d65 6e74 2e0a 0a20 2037 2e20 document... 7. │ │ │ │ │ -0004ac80: 4147 4752 4547 4154 494f 4e20 5749 5448 AGGREGATION WITH │ │ │ │ │ -0004ac90: 2049 4e44 4550 454e 4445 4e54 2057 4f52 INDEPENDENT WOR │ │ │ │ │ -0004aca0: 4b53 0a0a 2020 2020 2041 2063 6f6d 7069 KS.. A compi │ │ │ │ │ -0004acb0: 6c61 7469 6f6e 206f 6620 7468 6520 446f lation of the Do │ │ │ │ │ -0004acc0: 6375 6d65 6e74 206f 7220 6974 7320 6465 cument or its de │ │ │ │ │ -0004acd0: 7269 7661 7469 7665 7320 7769 7468 206f rivatives with o │ │ │ │ │ -0004ace0: 7468 6572 0a20 2020 2020 7365 7061 7261 ther. separa │ │ │ │ │ -0004acf0: 7465 2061 6e64 2069 6e64 6570 656e 6465 te and independe │ │ │ │ │ -0004ad00: 6e74 2064 6f63 756d 656e 7473 206f 7220 nt documents or │ │ │ │ │ -0004ad10: 776f 726b 732c 2069 6e20 6f72 206f 6e20 works, in or on │ │ │ │ │ -0004ad20: 6120 766f 6c75 6d65 206f 6620 610a 2020 a volume of a. │ │ │ │ │ -0004ad30: 2020 2073 746f 7261 6765 206f 7220 6469 storage or di │ │ │ │ │ -0004ad40: 7374 7269 6275 7469 6f6e 206d 6564 6975 stribution mediu │ │ │ │ │ -0004ad50: 6d2c 2069 7320 6361 6c6c 6564 2061 6e20 m, is called an │ │ │ │ │ -0004ad60: 2261 6767 7265 6761 7465 2220 6966 2074 "aggregate" if t │ │ │ │ │ -0004ad70: 6865 0a20 2020 2020 636f 7079 7269 6768 he. copyrigh │ │ │ │ │ -0004ad80: 7420 7265 7375 6c74 696e 6720 6672 6f6d t resulting from │ │ │ │ │ -0004ad90: 2074 6865 2063 6f6d 7069 6c61 7469 6f6e the compilation │ │ │ │ │ -0004ada0: 2069 7320 6e6f 7420 7573 6564 2074 6f20 is not used to │ │ │ │ │ -0004adb0: 6c69 6d69 7420 7468 650a 2020 2020 206c limit the. l │ │ │ │ │ -0004adc0: 6567 616c 2072 6967 6874 7320 6f66 2074 egal rights of t │ │ │ │ │ -0004add0: 6865 2063 6f6d 7069 6c61 7469 6f6e 2773 he compilation's │ │ │ │ │ -0004ade0: 2075 7365 7273 2062 6579 6f6e 6420 7768 users beyond wh │ │ │ │ │ -0004adf0: 6174 2074 6865 2069 6e64 6976 6964 7561 at the individua │ │ │ │ │ -0004ae00: 6c0a 2020 2020 2077 6f72 6b73 2070 6572 l. works per │ │ │ │ │ -0004ae10: 6d69 742e 2020 5768 656e 2074 6865 2044 mit. When the D │ │ │ │ │ -0004ae20: 6f63 756d 656e 7420 6973 2069 6e63 6c75 ocument is inclu │ │ │ │ │ -0004ae30: 6465 6420 696e 2061 6e20 6167 6772 6567 ded in an aggreg │ │ │ │ │ -0004ae40: 6174 652c 2074 6869 730a 2020 2020 204c ate, this. L │ │ │ │ │ -0004ae50: 6963 656e 7365 2064 6f65 7320 6e6f 7420 icense does not │ │ │ │ │ -0004ae60: 6170 706c 7920 746f 2074 6865 206f 7468 apply to the oth │ │ │ │ │ -0004ae70: 6572 2077 6f72 6b73 2069 6e20 7468 6520 er works in the │ │ │ │ │ -0004ae80: 6167 6772 6567 6174 6520 7768 6963 680a aggregate which. │ │ │ │ │ -0004ae90: 2020 2020 2061 7265 206e 6f74 2074 6865 are not the │ │ │ │ │ -0004aea0: 6d73 656c 7665 7320 6465 7269 7661 7469 mselves derivati │ │ │ │ │ -0004aeb0: 7665 2077 6f72 6b73 206f 6620 7468 6520 ve works of the │ │ │ │ │ -0004aec0: 446f 6375 6d65 6e74 2e0a 0a20 2020 2020 Document... │ │ │ │ │ -0004aed0: 4966 2074 6865 2043 6f76 6572 2054 6578 If the Cover Tex │ │ │ │ │ -0004aee0: 7420 7265 7175 6972 656d 656e 7420 6f66 t requirement of │ │ │ │ │ -0004aef0: 2073 6563 7469 6f6e 2033 2069 7320 6170 section 3 is ap │ │ │ │ │ -0004af00: 706c 6963 6162 6c65 2074 6f20 7468 6573 plicable to thes │ │ │ │ │ -0004af10: 650a 2020 2020 2063 6f70 6965 7320 6f66 e. copies of │ │ │ │ │ -0004af20: 2074 6865 2044 6f63 756d 656e 742c 2074 the Document, t │ │ │ │ │ -0004af30: 6865 6e20 6966 2074 6865 2044 6f63 756d hen if the Docum │ │ │ │ │ -0004af40: 656e 7420 6973 206c 6573 7320 7468 616e ent is less than │ │ │ │ │ -0004af50: 206f 6e65 2068 616c 660a 2020 2020 206f one half. o │ │ │ │ │ -0004af60: 6620 7468 6520 656e 7469 7265 2061 6767 f the entire agg │ │ │ │ │ -0004af70: 7265 6761 7465 2c20 7468 6520 446f 6375 regate, the Docu │ │ │ │ │ -0004af80: 6d65 6e74 2773 2043 6f76 6572 2054 6578 ment's Cover Tex │ │ │ │ │ -0004af90: 7473 206d 6179 2062 6520 706c 6163 6564 ts may be placed │ │ │ │ │ -0004afa0: 0a20 2020 2020 6f6e 2063 6f76 6572 7320 . on covers │ │ │ │ │ -0004afb0: 7468 6174 2062 7261 636b 6574 2074 6865 that bracket the │ │ │ │ │ -0004afc0: 2044 6f63 756d 656e 7420 7769 7468 696e Document within │ │ │ │ │ -0004afd0: 2074 6865 2061 6767 7265 6761 7465 2c20 the aggregate, │ │ │ │ │ -0004afe0: 6f72 2074 6865 0a20 2020 2020 656c 6563 or the. elec │ │ │ │ │ -0004aff0: 7472 6f6e 6963 2065 7175 6976 616c 656e tronic equivalen │ │ │ │ │ -0004b000: 7420 6f66 2063 6f76 6572 7320 6966 2074 t of covers if t │ │ │ │ │ -0004b010: 6865 2044 6f63 756d 656e 7420 6973 2069 he Document is i │ │ │ │ │ -0004b020: 6e20 656c 6563 7472 6f6e 6963 0a20 2020 n electronic. │ │ │ │ │ -0004b030: 2020 666f 726d 2e20 204f 7468 6572 7769 form. Otherwi │ │ │ │ │ -0004b040: 7365 2074 6865 7920 6d75 7374 2061 7070 se they must app │ │ │ │ │ -0004b050: 6561 7220 6f6e 2070 7269 6e74 6564 2063 ear on printed c │ │ │ │ │ -0004b060: 6f76 6572 7320 7468 6174 2062 7261 636b overs that brack │ │ │ │ │ -0004b070: 6574 0a20 2020 2020 7468 6520 7768 6f6c et. the whol │ │ │ │ │ -0004b080: 6520 6167 6772 6567 6174 652e 0a0a 2020 e aggregate... │ │ │ │ │ -0004b090: 382e 2054 5241 4e53 4c41 5449 4f4e 0a0a 8. TRANSLATION.. │ │ │ │ │ -0004b0a0: 2020 2020 2054 7261 6e73 6c61 7469 6f6e Translation │ │ │ │ │ -0004b0b0: 2069 7320 636f 6e73 6964 6572 6564 2061 is considered a │ │ │ │ │ -0004b0c0: 206b 696e 6420 6f66 206d 6f64 6966 6963 kind of modific │ │ │ │ │ -0004b0d0: 6174 696f 6e2c 2073 6f20 796f 7520 6d61 ation, so you ma │ │ │ │ │ -0004b0e0: 790a 2020 2020 2064 6973 7472 6962 7574 y. distribut │ │ │ │ │ -0004b0f0: 6520 7472 616e 736c 6174 696f 6e73 206f e translations o │ │ │ │ │ -0004b100: 6620 7468 6520 446f 6375 6d65 6e74 2075 f the Document u │ │ │ │ │ -0004b110: 6e64 6572 2074 6865 2074 6572 6d73 206f nder the terms o │ │ │ │ │ -0004b120: 6620 7365 6374 696f 6e0a 2020 2020 2034 f section. 4 │ │ │ │ │ -0004b130: 2e20 2052 6570 6c61 6369 6e67 2049 6e76 . Replacing Inv │ │ │ │ │ -0004b140: 6172 6961 6e74 2053 6563 7469 6f6e 7320 ariant Sections │ │ │ │ │ -0004b150: 7769 7468 2074 7261 6e73 6c61 7469 6f6e with translation │ │ │ │ │ -0004b160: 7320 7265 7175 6972 6573 2073 7065 6369 s requires speci │ │ │ │ │ -0004b170: 616c 0a20 2020 2020 7065 726d 6973 7369 al. permissi │ │ │ │ │ -0004b180: 6f6e 2066 726f 6d20 7468 6569 7220 636f on from their co │ │ │ │ │ -0004b190: 7079 7269 6768 7420 686f 6c64 6572 732c pyright holders, │ │ │ │ │ -0004b1a0: 2062 7574 2079 6f75 206d 6179 2069 6e63 but you may inc │ │ │ │ │ -0004b1b0: 6c75 6465 0a20 2020 2020 7472 616e 736c lude. transl │ │ │ │ │ -0004b1c0: 6174 696f 6e73 206f 6620 736f 6d65 206f ations of some o │ │ │ │ │ -0004b1d0: 7220 616c 6c20 496e 7661 7269 616e 7420 r all Invariant │ │ │ │ │ -0004b1e0: 5365 6374 696f 6e73 2069 6e20 6164 6469 Sections in addi │ │ │ │ │ -0004b1f0: 7469 6f6e 2074 6f20 7468 650a 2020 2020 tion to the. │ │ │ │ │ -0004b200: 206f 7269 6769 6e61 6c20 7665 7273 696f original versio │ │ │ │ │ -0004b210: 6e73 206f 6620 7468 6573 6520 496e 7661 ns of these Inva │ │ │ │ │ -0004b220: 7269 616e 7420 5365 6374 696f 6e73 2e20 riant Sections. │ │ │ │ │ -0004b230: 2059 6f75 206d 6179 2069 6e63 6c75 6465 You may include │ │ │ │ │ -0004b240: 2061 0a20 2020 2020 7472 616e 736c 6174 a. translat │ │ │ │ │ -0004b250: 696f 6e20 6f66 2074 6869 7320 4c69 6365 ion of this Lice │ │ │ │ │ -0004b260: 6e73 652c 2061 6e64 2061 6c6c 2074 6865 nse, and all the │ │ │ │ │ -0004b270: 206c 6963 656e 7365 206e 6f74 6963 6573 license notices │ │ │ │ │ -0004b280: 2069 6e20 7468 650a 2020 2020 2044 6f63 in the. Doc │ │ │ │ │ -0004b290: 756d 656e 742c 2061 6e64 2061 6e79 2057 ument, and any W │ │ │ │ │ -0004b2a0: 6172 7261 6e74 7920 4469 7363 6c61 696d arranty Disclaim │ │ │ │ │ -0004b2b0: 6572 732c 2070 726f 7669 6465 6420 7468 ers, provided th │ │ │ │ │ -0004b2c0: 6174 2079 6f75 2061 6c73 6f0a 2020 2020 at you also. │ │ │ │ │ -0004b2d0: 2069 6e63 6c75 6465 2074 6865 206f 7269 include the ori │ │ │ │ │ -0004b2e0: 6769 6e61 6c20 456e 676c 6973 6820 7665 ginal English ve │ │ │ │ │ -0004b2f0: 7273 696f 6e20 6f66 2074 6869 7320 4c69 rsion of this Li │ │ │ │ │ -0004b300: 6365 6e73 6520 616e 6420 7468 650a 2020 cense and the. │ │ │ │ │ -0004b310: 2020 206f 7269 6769 6e61 6c20 7665 7273 original vers │ │ │ │ │ -0004b320: 696f 6e73 206f 6620 7468 6f73 6520 6e6f ions of those no │ │ │ │ │ -0004b330: 7469 6365 7320 616e 6420 6469 7363 6c61 tices and discla │ │ │ │ │ -0004b340: 696d 6572 732e 2020 496e 2063 6173 6520 imers. In case │ │ │ │ │ -0004b350: 6f66 2061 0a20 2020 2020 6469 7361 6772 of a. disagr │ │ │ │ │ -0004b360: 6565 6d65 6e74 2062 6574 7765 656e 2074 eement between t │ │ │ │ │ -0004b370: 6865 2074 7261 6e73 6c61 7469 6f6e 2061 he translation a │ │ │ │ │ -0004b380: 6e64 2074 6865 206f 7269 6769 6e61 6c20 nd the original │ │ │ │ │ -0004b390: 7665 7273 696f 6e20 6f66 0a20 2020 2020 version of. │ │ │ │ │ -0004b3a0: 7468 6973 204c 6963 656e 7365 206f 7220 this License or │ │ │ │ │ -0004b3b0: 6120 6e6f 7469 6365 206f 7220 6469 7363 a notice or disc │ │ │ │ │ -0004b3c0: 6c61 696d 6572 2c20 7468 6520 6f72 6967 laimer, the orig │ │ │ │ │ -0004b3d0: 696e 616c 2076 6572 7369 6f6e 2077 696c inal version wil │ │ │ │ │ -0004b3e0: 6c0a 2020 2020 2070 7265 7661 696c 2e0a l. prevail.. │ │ │ │ │ -0004b3f0: 0a20 2020 2020 4966 2061 2073 6563 7469 . If a secti │ │ │ │ │ -0004b400: 6f6e 2069 6e20 7468 6520 446f 6375 6d65 on in the Docume │ │ │ │ │ -0004b410: 6e74 2069 7320 456e 7469 746c 6564 2022 nt is Entitled " │ │ │ │ │ -0004b420: 4163 6b6e 6f77 6c65 6467 656d 656e 7473 Acknowledgements │ │ │ │ │ -0004b430: 222c 0a20 2020 2020 2244 6564 6963 6174 ",. "Dedicat │ │ │ │ │ -0004b440: 696f 6e73 222c 206f 7220 2248 6973 746f ions", or "Histo │ │ │ │ │ -0004b450: 7279 222c 2074 6865 2072 6571 7569 7265 ry", the require │ │ │ │ │ -0004b460: 6d65 6e74 2028 7365 6374 696f 6e20 3429 ment (section 4) │ │ │ │ │ -0004b470: 2074 6f0a 2020 2020 2050 7265 7365 7276 to. Preserv │ │ │ │ │ -0004b480: 6520 6974 7320 5469 746c 6520 2873 6563 e its Title (sec │ │ │ │ │ -0004b490: 7469 6f6e 2031 2920 7769 6c6c 2074 7970 tion 1) will typ │ │ │ │ │ -0004b4a0: 6963 616c 6c79 2072 6571 7569 7265 2063 ically require c │ │ │ │ │ -0004b4b0: 6861 6e67 696e 6720 7468 650a 2020 2020 hanging the. │ │ │ │ │ -0004b4c0: 2061 6374 7561 6c20 7469 746c 652e 0a0a actual title... │ │ │ │ │ -0004b4d0: 2020 392e 2054 4552 4d49 4e41 5449 4f4e 9. TERMINATION │ │ │ │ │ -0004b4e0: 0a0a 2020 2020 2059 6f75 206d 6179 206e .. You may n │ │ │ │ │ -0004b4f0: 6f74 2063 6f70 792c 206d 6f64 6966 792c ot copy, modify, │ │ │ │ │ -0004b500: 2073 7562 6c69 6365 6e73 652c 206f 7220 sublicense, or │ │ │ │ │ -0004b510: 6469 7374 7269 6275 7465 2074 6865 2044 distribute the D │ │ │ │ │ -0004b520: 6f63 756d 656e 740a 2020 2020 2065 7863 ocument. exc │ │ │ │ │ -0004b530: 6570 7420 6173 2065 7870 7265 7373 6c79 ept as expressly │ │ │ │ │ -0004b540: 2070 726f 7669 6465 6420 666f 7220 756e provided for un │ │ │ │ │ -0004b550: 6465 7220 7468 6973 204c 6963 656e 7365 der this License │ │ │ │ │ -0004b560: 2e20 2041 6e79 206f 7468 6572 0a20 2020 . Any other. │ │ │ │ │ -0004b570: 2020 6174 7465 6d70 7420 746f 2063 6f70 attempt to cop │ │ │ │ │ -0004b580: 792c 206d 6f64 6966 792c 2073 7562 6c69 y, modify, subli │ │ │ │ │ -0004b590: 6365 6e73 6520 6f72 2064 6973 7472 6962 cense or distrib │ │ │ │ │ -0004b5a0: 7574 6520 7468 6520 446f 6375 6d65 6e74 ute the Document │ │ │ │ │ -0004b5b0: 2069 730a 2020 2020 2076 6f69 642c 2061 is. void, a │ │ │ │ │ -0004b5c0: 6e64 2077 696c 6c20 6175 746f 6d61 7469 nd will automati │ │ │ │ │ -0004b5d0: 6361 6c6c 7920 7465 726d 696e 6174 6520 cally terminate │ │ │ │ │ -0004b5e0: 796f 7572 2072 6967 6874 7320 756e 6465 your rights unde │ │ │ │ │ -0004b5f0: 7220 7468 6973 0a20 2020 2020 4c69 6365 r this. Lice │ │ │ │ │ -0004b600: 6e73 652e 2020 486f 7765 7665 722c 2070 nse. However, p │ │ │ │ │ -0004b610: 6172 7469 6573 2077 686f 2068 6176 6520 arties who have │ │ │ │ │ -0004b620: 7265 6365 6976 6564 2063 6f70 6965 732c received copies, │ │ │ │ │ -0004b630: 206f 7220 7269 6768 7473 2c0a 2020 2020 or rights,. │ │ │ │ │ -0004b640: 2066 726f 6d20 796f 7520 756e 6465 7220 from you under │ │ │ │ │ -0004b650: 7468 6973 204c 6963 656e 7365 2077 696c this License wil │ │ │ │ │ -0004b660: 6c20 6e6f 7420 6861 7665 2074 6865 6972 l not have their │ │ │ │ │ -0004b670: 206c 6963 656e 7365 7320 7465 726d 696e licenses termin │ │ │ │ │ -0004b680: 6174 6564 0a20 2020 2020 736f 206c 6f6e ated. so lon │ │ │ │ │ -0004b690: 6720 6173 2073 7563 6820 7061 7274 6965 g as such partie │ │ │ │ │ -0004b6a0: 7320 7265 6d61 696e 2069 6e20 6675 6c6c s remain in full │ │ │ │ │ -0004b6b0: 2063 6f6d 706c 6961 6e63 652e 0a0a 2020 compliance... │ │ │ │ │ -0004b6c0: 3130 2e20 4655 5455 5245 2052 4556 4953 10. FUTURE REVIS │ │ │ │ │ -0004b6d0: 494f 4e53 204f 4620 5448 4953 204c 4943 IONS OF THIS LIC │ │ │ │ │ -0004b6e0: 454e 5345 0a0a 2020 2020 2054 6865 2046 ENSE.. The F │ │ │ │ │ -0004b6f0: 7265 6520 536f 6674 7761 7265 2046 6f75 ree Software Fou │ │ │ │ │ -0004b700: 6e64 6174 696f 6e20 6d61 7920 7075 626c ndation may publ │ │ │ │ │ -0004b710: 6973 6820 6e65 772c 2072 6576 6973 6564 ish new, revised │ │ │ │ │ -0004b720: 2076 6572 7369 6f6e 7320 6f66 0a20 2020 versions of. │ │ │ │ │ -0004b730: 2020 7468 6520 474e 5520 4672 6565 2044 the GNU Free D │ │ │ │ │ -0004b740: 6f63 756d 656e 7461 7469 6f6e 204c 6963 ocumentation Lic │ │ │ │ │ -0004b750: 656e 7365 2066 726f 6d20 7469 6d65 2074 ense from time t │ │ │ │ │ -0004b760: 6f20 7469 6d65 2e20 2053 7563 6820 6e65 o time. Such ne │ │ │ │ │ -0004b770: 770a 2020 2020 2076 6572 7369 6f6e 7320 w. versions │ │ │ │ │ -0004b780: 7769 6c6c 2062 6520 7369 6d69 6c61 7220 will be similar │ │ │ │ │ -0004b790: 696e 2073 7069 7269 7420 746f 2074 6865 in spirit to the │ │ │ │ │ -0004b7a0: 2070 7265 7365 6e74 2076 6572 7369 6f6e present version │ │ │ │ │ -0004b7b0: 2c20 6275 7420 6d61 790a 2020 2020 2064 , but may. d │ │ │ │ │ -0004b7c0: 6966 6665 7220 696e 2064 6574 6169 6c20 iffer in detail │ │ │ │ │ -0004b7d0: 746f 2061 6464 7265 7373 206e 6577 2070 to address new p │ │ │ │ │ -0004b7e0: 726f 626c 656d 7320 6f72 2063 6f6e 6365 roblems or conce │ │ │ │ │ -0004b7f0: 726e 732e 2020 5365 650a 2020 2020 203c rns. See. < │ │ │ │ │ -0004b800: 6874 7470 3a2f 2f77 7777 2e67 6e75 2e6f http://www.gnu.o │ │ │ │ │ -0004b810: 7267 2f63 6f70 796c 6566 742f 3e2e 0a0a rg/copyleft/>... │ │ │ │ │ -0004b820: 2020 2020 2045 6163 6820 7665 7273 696f Each versio │ │ │ │ │ -0004b830: 6e20 6f66 2074 6865 204c 6963 656e 7365 n of the License │ │ │ │ │ -0004b840: 2069 7320 6769 7665 6e20 6120 6469 7374 is given a dist │ │ │ │ │ -0004b850: 696e 6775 6973 6869 6e67 2076 6572 7369 inguishing versi │ │ │ │ │ -0004b860: 6f6e 0a20 2020 2020 6e75 6d62 6572 2e20 on. number. │ │ │ │ │ -0004b870: 2049 6620 7468 6520 446f 6375 6d65 6e74 If the Document │ │ │ │ │ -0004b880: 2073 7065 6369 6669 6573 2074 6861 7420 specifies that │ │ │ │ │ -0004b890: 6120 7061 7274 6963 756c 6172 206e 756d a particular num │ │ │ │ │ -0004b8a0: 6265 7265 640a 2020 2020 2076 6572 7369 bered. versi │ │ │ │ │ -0004b8b0: 6f6e 206f 6620 7468 6973 204c 6963 656e on of this Licen │ │ │ │ │ -0004b8c0: 7365 2022 6f72 2061 6e79 206c 6174 6572 se "or any later │ │ │ │ │ -0004b8d0: 2076 6572 7369 6f6e 2220 6170 706c 6965 version" applie │ │ │ │ │ -0004b8e0: 7320 746f 2069 742c 2079 6f75 0a20 2020 s to it, you. │ │ │ │ │ -0004b8f0: 2020 6861 7665 2074 6865 206f 7074 696f have the optio │ │ │ │ │ -0004b900: 6e20 6f66 2066 6f6c 6c6f 7769 6e67 2074 n of following t │ │ │ │ │ -0004b910: 6865 2074 6572 6d73 2061 6e64 2063 6f6e he terms and con │ │ │ │ │ -0004b920: 6469 7469 6f6e 7320 6569 7468 6572 206f ditions either o │ │ │ │ │ -0004b930: 660a 2020 2020 2074 6861 7420 7370 6563 f. that spec │ │ │ │ │ -0004b940: 6966 6965 6420 7665 7273 696f 6e20 6f72 ified version or │ │ │ │ │ -0004b950: 206f 6620 616e 7920 6c61 7465 7220 7665 of any later ve │ │ │ │ │ -0004b960: 7273 696f 6e20 7468 6174 2068 6173 2062 rsion that has b │ │ │ │ │ -0004b970: 6565 6e0a 2020 2020 2070 7562 6c69 7368 een. publish │ │ │ │ │ -0004b980: 6564 2028 6e6f 7420 6173 2061 2064 7261 ed (not as a dra │ │ │ │ │ -0004b990: 6674 2920 6279 2074 6865 2046 7265 6520 ft) by the Free │ │ │ │ │ -0004b9a0: 536f 6674 7761 7265 2046 6f75 6e64 6174 Software Foundat │ │ │ │ │ -0004b9b0: 696f 6e2e 2020 4966 2074 6865 0a20 2020 ion. If the. │ │ │ │ │ -0004b9c0: 2020 446f 6375 6d65 6e74 2064 6f65 7320 Document does │ │ │ │ │ -0004b9d0: 6e6f 7420 7370 6563 6966 7920 6120 7665 not specify a ve │ │ │ │ │ -0004b9e0: 7273 696f 6e20 6e75 6d62 6572 206f 6620 rsion number of │ │ │ │ │ -0004b9f0: 7468 6973 204c 6963 656e 7365 2c20 796f this License, yo │ │ │ │ │ -0004ba00: 7520 6d61 790a 2020 2020 2063 686f 6f73 u may. choos │ │ │ │ │ -0004ba10: 6520 616e 7920 7665 7273 696f 6e20 6576 e any version ev │ │ │ │ │ -0004ba20: 6572 2070 7562 6c69 7368 6564 2028 6e6f er published (no │ │ │ │ │ -0004ba30: 7420 6173 2061 2064 7261 6674 2920 6279 t as a draft) by │ │ │ │ │ -0004ba40: 2074 6865 2046 7265 650a 2020 2020 2053 the Free. S │ │ │ │ │ -0004ba50: 6f66 7477 6172 6520 466f 756e 6461 7469 oftware Foundati │ │ │ │ │ -0004ba60: 6f6e 2e0a 0a44 2e31 2e31 2041 4444 454e on...D.1.1 ADDEN │ │ │ │ │ -0004ba70: 4455 4d3a 2048 6f77 2074 6f20 7573 6520 DUM: How to use │ │ │ │ │ -0004ba80: 7468 6973 204c 6963 656e 7365 2066 6f72 this License for │ │ │ │ │ -0004ba90: 2079 6f75 7220 646f 6375 6d65 6e74 730a your documents. │ │ │ │ │ +00046910: 3d3d 3d0a 0a20 2020 2020 2020 2020 2020 ===.. │ │ │ │ │ +00046920: 2020 2020 2020 2020 2020 2056 6572 7369 Versi │ │ │ │ │ +00046930: 6f6e 2031 2e32 2c20 4e6f 7665 6d62 6572 on 1.2, November │ │ │ │ │ +00046940: 2032 3030 320a 0a20 2020 2020 436f 7079 2002.. Copy │ │ │ │ │ +00046950: 7269 6768 7420 2843 2920 3230 3030 2c32 right (C) 2000,2 │ │ │ │ │ +00046960: 3030 312c 3230 3032 2046 7265 6520 536f 001,2002 Free So │ │ │ │ │ +00046970: 6674 7761 7265 2046 6f75 6e64 6174 696f ftware Foundatio │ │ │ │ │ +00046980: 6e2c 2049 6e63 2e0a 2020 2020 2035 3120 n, Inc.. 51 │ │ │ │ │ +00046990: 4672 616e 6b6c 696e 2053 742c 2046 6966 Franklin St, Fif │ │ │ │ │ +000469a0: 7468 2046 6c6f 6f72 2c20 426f 7374 6f6e th Floor, Boston │ │ │ │ │ +000469b0: 2c20 4d41 2020 3032 3131 302d 3133 3031 , MA 02110-1301 │ │ │ │ │ +000469c0: 2c20 5553 410a 0a20 2020 2020 4576 6572 , USA.. Ever │ │ │ │ │ +000469d0: 796f 6e65 2069 7320 7065 726d 6974 7465 yone is permitte │ │ │ │ │ +000469e0: 6420 746f 2063 6f70 7920 616e 6420 6469 d to copy and di │ │ │ │ │ +000469f0: 7374 7269 6275 7465 2076 6572 6261 7469 stribute verbati │ │ │ │ │ +00046a00: 6d20 636f 7069 6573 0a20 2020 2020 6f66 m copies. of │ │ │ │ │ +00046a10: 2074 6869 7320 6c69 6365 6e73 6520 646f this license do │ │ │ │ │ +00046a20: 6375 6d65 6e74 2c20 6275 7420 6368 616e cument, but chan │ │ │ │ │ +00046a30: 6769 6e67 2069 7420 6973 206e 6f74 2061 ging it is not a │ │ │ │ │ +00046a40: 6c6c 6f77 6564 2e0a 0a20 2030 2e20 5052 llowed... 0. PR │ │ │ │ │ +00046a50: 4541 4d42 4c45 0a0a 2020 2020 2054 6865 EAMBLE.. The │ │ │ │ │ +00046a60: 2070 7572 706f 7365 206f 6620 7468 6973 purpose of this │ │ │ │ │ +00046a70: 204c 6963 656e 7365 2069 7320 746f 206d License is to m │ │ │ │ │ +00046a80: 616b 6520 6120 6d61 6e75 616c 2c20 7465 ake a manual, te │ │ │ │ │ +00046a90: 7874 626f 6f6b 2c20 6f72 206f 7468 6572 xtbook, or other │ │ │ │ │ +00046aa0: 0a20 2020 2020 6675 6e63 7469 6f6e 616c . functional │ │ │ │ │ +00046ab0: 2061 6e64 2075 7365 6675 6c20 646f 6375 and useful docu │ │ │ │ │ +00046ac0: 6d65 6e74 2022 6672 6565 2220 696e 2074 ment "free" in t │ │ │ │ │ +00046ad0: 6865 2073 656e 7365 206f 6620 6672 6565 he sense of free │ │ │ │ │ +00046ae0: 646f 6d3a 2074 6f0a 2020 2020 2061 7373 dom: to. ass │ │ │ │ │ +00046af0: 7572 6520 6576 6572 796f 6e65 2074 6865 ure everyone the │ │ │ │ │ +00046b00: 2065 6666 6563 7469 7665 2066 7265 6564 effective freed │ │ │ │ │ +00046b10: 6f6d 2074 6f20 636f 7079 2061 6e64 2072 om to copy and r │ │ │ │ │ +00046b20: 6564 6973 7472 6962 7574 6520 6974 2c0a edistribute it,. │ │ │ │ │ +00046b30: 2020 2020 2077 6974 6820 6f72 2077 6974 with or wit │ │ │ │ │ +00046b40: 686f 7574 206d 6f64 6966 7969 6e67 2069 hout modifying i │ │ │ │ │ +00046b50: 742c 2065 6974 6865 7220 636f 6d6d 6572 t, either commer │ │ │ │ │ +00046b60: 6369 616c 6c79 206f 720a 2020 2020 206e cially or. n │ │ │ │ │ +00046b70: 6f6e 636f 6d6d 6572 6369 616c 6c79 2e20 oncommercially. │ │ │ │ │ +00046b80: 2053 6563 6f6e 6461 7269 6c79 2c20 7468 Secondarily, th │ │ │ │ │ +00046b90: 6973 204c 6963 656e 7365 2070 7265 7365 is License prese │ │ │ │ │ +00046ba0: 7276 6573 2066 6f72 2074 6865 0a20 2020 rves for the. │ │ │ │ │ +00046bb0: 2020 6175 7468 6f72 2061 6e64 2070 7562 author and pub │ │ │ │ │ +00046bc0: 6c69 7368 6572 2061 2077 6179 2074 6f20 lisher a way to │ │ │ │ │ +00046bd0: 6765 7420 6372 6564 6974 2066 6f72 2074 get credit for t │ │ │ │ │ +00046be0: 6865 6972 2077 6f72 6b2c 2077 6869 6c65 heir work, while │ │ │ │ │ +00046bf0: 206e 6f74 0a20 2020 2020 6265 696e 6720 not. being │ │ │ │ │ +00046c00: 636f 6e73 6964 6572 6564 2072 6573 706f considered respo │ │ │ │ │ +00046c10: 6e73 6962 6c65 2066 6f72 206d 6f64 6966 nsible for modif │ │ │ │ │ +00046c20: 6963 6174 696f 6e73 206d 6164 6520 6279 ications made by │ │ │ │ │ +00046c30: 206f 7468 6572 732e 0a0a 2020 2020 2054 others... T │ │ │ │ │ +00046c40: 6869 7320 4c69 6365 6e73 6520 6973 2061 his License is a │ │ │ │ │ +00046c50: 206b 696e 6420 6f66 2022 636f 7079 6c65 kind of "copyle │ │ │ │ │ +00046c60: 6674 222c 2077 6869 6368 206d 6561 6e73 ft", which means │ │ │ │ │ +00046c70: 2074 6861 7420 6465 7269 7661 7469 7665 that derivative │ │ │ │ │ +00046c80: 0a20 2020 2020 776f 726b 7320 6f66 2074 . works of t │ │ │ │ │ +00046c90: 6865 2064 6f63 756d 656e 7420 6d75 7374 he document must │ │ │ │ │ +00046ca0: 2074 6865 6d73 656c 7665 7320 6265 2066 themselves be f │ │ │ │ │ +00046cb0: 7265 6520 696e 2074 6865 2073 616d 6520 ree in the same │ │ │ │ │ +00046cc0: 7365 6e73 652e 0a20 2020 2020 4974 2063 sense.. It c │ │ │ │ │ +00046cd0: 6f6d 706c 656d 656e 7473 2074 6865 2047 omplements the G │ │ │ │ │ +00046ce0: 4e55 2047 656e 6572 616c 2050 7562 6c69 NU General Publi │ │ │ │ │ +00046cf0: 6320 4c69 6365 6e73 652c 2077 6869 6368 c License, which │ │ │ │ │ +00046d00: 2069 7320 6120 636f 7079 6c65 6674 0a20 is a copyleft. │ │ │ │ │ +00046d10: 2020 2020 6c69 6365 6e73 6520 6465 7369 license desi │ │ │ │ │ +00046d20: 676e 6564 2066 6f72 2066 7265 6520 736f gned for free so │ │ │ │ │ +00046d30: 6674 7761 7265 2e0a 0a20 2020 2020 5765 ftware... We │ │ │ │ │ +00046d40: 2068 6176 6520 6465 7369 676e 6564 2074 have designed t │ │ │ │ │ +00046d50: 6869 7320 4c69 6365 6e73 6520 696e 206f his License in o │ │ │ │ │ +00046d60: 7264 6572 2074 6f20 7573 6520 6974 2066 rder to use it f │ │ │ │ │ +00046d70: 6f72 206d 616e 7561 6c73 2066 6f72 0a20 or manuals for. │ │ │ │ │ +00046d80: 2020 2020 6672 6565 2073 6f66 7477 6172 free softwar │ │ │ │ │ +00046d90: 652c 2062 6563 6175 7365 2066 7265 6520 e, because free │ │ │ │ │ +00046da0: 736f 6674 7761 7265 206e 6565 6473 2066 software needs f │ │ │ │ │ +00046db0: 7265 6520 646f 6375 6d65 6e74 6174 696f ree documentatio │ │ │ │ │ +00046dc0: 6e3a 2061 0a20 2020 2020 6672 6565 2070 n: a. free p │ │ │ │ │ +00046dd0: 726f 6772 616d 2073 686f 756c 6420 636f rogram should co │ │ │ │ │ +00046de0: 6d65 2077 6974 6820 6d61 6e75 616c 7320 me with manuals │ │ │ │ │ +00046df0: 7072 6f76 6964 696e 6720 7468 6520 7361 providing the sa │ │ │ │ │ +00046e00: 6d65 2066 7265 6564 6f6d 730a 2020 2020 me freedoms. │ │ │ │ │ +00046e10: 2074 6861 7420 7468 6520 736f 6674 7761 that the softwa │ │ │ │ │ +00046e20: 7265 2064 6f65 732e 2020 4275 7420 7468 re does. But th │ │ │ │ │ +00046e30: 6973 204c 6963 656e 7365 2069 7320 6e6f is License is no │ │ │ │ │ +00046e40: 7420 6c69 6d69 7465 6420 746f 0a20 2020 t limited to. │ │ │ │ │ +00046e50: 2020 736f 6674 7761 7265 206d 616e 7561 software manua │ │ │ │ │ +00046e60: 6c73 3b20 6974 2063 616e 2062 6520 7573 ls; it can be us │ │ │ │ │ +00046e70: 6564 2066 6f72 2061 6e79 2074 6578 7475 ed for any textu │ │ │ │ │ +00046e80: 616c 2077 6f72 6b2c 2072 6567 6172 646c al work, regardl │ │ │ │ │ +00046e90: 6573 730a 2020 2020 206f 6620 7375 626a ess. of subj │ │ │ │ │ +00046ea0: 6563 7420 6d61 7474 6572 206f 7220 7768 ect matter or wh │ │ │ │ │ +00046eb0: 6574 6865 7220 6974 2069 7320 7075 626c ether it is publ │ │ │ │ │ +00046ec0: 6973 6865 6420 6173 2061 2070 7269 6e74 ished as a print │ │ │ │ │ +00046ed0: 6564 2062 6f6f 6b2e 2020 5765 0a20 2020 ed book. We. │ │ │ │ │ +00046ee0: 2020 7265 636f 6d6d 656e 6420 7468 6973 recommend this │ │ │ │ │ +00046ef0: 204c 6963 656e 7365 2070 7269 6e63 6970 License princip │ │ │ │ │ +00046f00: 616c 6c79 2066 6f72 2077 6f72 6b73 2077 ally for works w │ │ │ │ │ +00046f10: 686f 7365 2070 7572 706f 7365 2069 730a hose purpose is. │ │ │ │ │ +00046f20: 2020 2020 2069 6e73 7472 7563 7469 6f6e instruction │ │ │ │ │ +00046f30: 206f 7220 7265 6665 7265 6e63 652e 0a0a or reference... │ │ │ │ │ +00046f40: 2020 312e 2041 5050 4c49 4341 4249 4c49 1. APPLICABILI │ │ │ │ │ +00046f50: 5459 2041 4e44 2044 4546 494e 4954 494f TY AND DEFINITIO │ │ │ │ │ +00046f60: 4e53 0a0a 2020 2020 2054 6869 7320 4c69 NS.. This Li │ │ │ │ │ +00046f70: 6365 6e73 6520 6170 706c 6965 7320 746f cense applies to │ │ │ │ │ +00046f80: 2061 6e79 206d 616e 7561 6c20 6f72 206f any manual or o │ │ │ │ │ +00046f90: 7468 6572 2077 6f72 6b2c 2069 6e20 616e ther work, in an │ │ │ │ │ +00046fa0: 7920 6d65 6469 756d 2c0a 2020 2020 2074 y medium,. t │ │ │ │ │ +00046fb0: 6861 7420 636f 6e74 6169 6e73 2061 206e hat contains a n │ │ │ │ │ +00046fc0: 6f74 6963 6520 706c 6163 6564 2062 7920 otice placed by │ │ │ │ │ +00046fd0: 7468 6520 636f 7079 7269 6768 7420 686f the copyright ho │ │ │ │ │ +00046fe0: 6c64 6572 2073 6179 696e 6720 6974 2063 lder saying it c │ │ │ │ │ +00046ff0: 616e 0a20 2020 2020 6265 2064 6973 7472 an. be distr │ │ │ │ │ +00047000: 6962 7574 6564 2075 6e64 6572 2074 6865 ibuted under the │ │ │ │ │ +00047010: 2074 6572 6d73 206f 6620 7468 6973 204c terms of this L │ │ │ │ │ +00047020: 6963 656e 7365 2e20 2053 7563 6820 6120 icense. Such a │ │ │ │ │ +00047030: 6e6f 7469 6365 0a20 2020 2020 6772 616e notice. gran │ │ │ │ │ +00047040: 7473 2061 2077 6f72 6c64 2d77 6964 652c ts a world-wide, │ │ │ │ │ +00047050: 2072 6f79 616c 7479 2d66 7265 6520 6c69 royalty-free li │ │ │ │ │ +00047060: 6365 6e73 652c 2075 6e6c 696d 6974 6564 cense, unlimited │ │ │ │ │ +00047070: 2069 6e20 6475 7261 7469 6f6e 2c0a 2020 in duration,. │ │ │ │ │ +00047080: 2020 2074 6f20 7573 6520 7468 6174 2077 to use that w │ │ │ │ │ +00047090: 6f72 6b20 756e 6465 7220 7468 6520 636f ork under the co │ │ │ │ │ +000470a0: 6e64 6974 696f 6e73 2073 7461 7465 6420 nditions stated │ │ │ │ │ +000470b0: 6865 7265 696e 2e20 2054 6865 0a20 2020 herein. The. │ │ │ │ │ +000470c0: 2020 2244 6f63 756d 656e 7422 2c20 6265 "Document", be │ │ │ │ │ +000470d0: 6c6f 772c 2072 6566 6572 7320 746f 2061 low, refers to a │ │ │ │ │ +000470e0: 6e79 2073 7563 6820 6d61 6e75 616c 206f ny such manual o │ │ │ │ │ +000470f0: 7220 776f 726b 2e20 2041 6e79 206d 656d r work. Any mem │ │ │ │ │ +00047100: 6265 720a 2020 2020 206f 6620 7468 6520 ber. of the │ │ │ │ │ +00047110: 7075 626c 6963 2069 7320 6120 6c69 6365 public is a lice │ │ │ │ │ +00047120: 6e73 6565 2c20 616e 6420 6973 2061 6464 nsee, and is add │ │ │ │ │ +00047130: 7265 7373 6564 2061 7320 2279 6f75 222e ressed as "you". │ │ │ │ │ +00047140: 2020 596f 7520 6163 6365 7074 0a20 2020 You accept. │ │ │ │ │ +00047150: 2020 7468 6520 6c69 6365 6e73 6520 6966 the license if │ │ │ │ │ +00047160: 2079 6f75 2063 6f70 792c 206d 6f64 6966 you copy, modif │ │ │ │ │ +00047170: 7920 6f72 2064 6973 7472 6962 7574 6520 y or distribute │ │ │ │ │ +00047180: 7468 6520 776f 726b 2069 6e20 6120 7761 the work in a wa │ │ │ │ │ +00047190: 790a 2020 2020 2072 6571 7569 7269 6e67 y. requiring │ │ │ │ │ +000471a0: 2070 6572 6d69 7373 696f 6e20 756e 6465 permission unde │ │ │ │ │ +000471b0: 7220 636f 7079 7269 6768 7420 6c61 772e r copyright law. │ │ │ │ │ +000471c0: 0a0a 2020 2020 2041 2022 4d6f 6469 6669 .. A "Modifi │ │ │ │ │ +000471d0: 6564 2056 6572 7369 6f6e 2220 6f66 2074 ed Version" of t │ │ │ │ │ +000471e0: 6865 2044 6f63 756d 656e 7420 6d65 616e he Document mean │ │ │ │ │ +000471f0: 7320 616e 7920 776f 726b 2063 6f6e 7461 s any work conta │ │ │ │ │ +00047200: 696e 696e 6720 7468 650a 2020 2020 2044 ining the. D │ │ │ │ │ +00047210: 6f63 756d 656e 7420 6f72 2061 2070 6f72 ocument or a por │ │ │ │ │ +00047220: 7469 6f6e 206f 6620 6974 2c20 6569 7468 tion of it, eith │ │ │ │ │ +00047230: 6572 2063 6f70 6965 6420 7665 7262 6174 er copied verbat │ │ │ │ │ +00047240: 696d 2c20 6f72 2077 6974 680a 2020 2020 im, or with. │ │ │ │ │ +00047250: 206d 6f64 6966 6963 6174 696f 6e73 2061 modifications a │ │ │ │ │ +00047260: 6e64 2f6f 7220 7472 616e 736c 6174 6564 nd/or translated │ │ │ │ │ +00047270: 2069 6e74 6f20 616e 6f74 6865 7220 6c61 into another la │ │ │ │ │ +00047280: 6e67 7561 6765 2e0a 0a20 2020 2020 4120 nguage... A │ │ │ │ │ +00047290: 2253 6563 6f6e 6461 7279 2053 6563 7469 "Secondary Secti │ │ │ │ │ +000472a0: 6f6e 2220 6973 2061 206e 616d 6564 2061 on" is a named a │ │ │ │ │ +000472b0: 7070 656e 6469 7820 6f72 2061 2066 726f ppendix or a fro │ │ │ │ │ +000472c0: 6e74 2d6d 6174 7465 7220 7365 6374 696f nt-matter sectio │ │ │ │ │ +000472d0: 6e0a 2020 2020 206f 6620 7468 6520 446f n. of the Do │ │ │ │ │ +000472e0: 6375 6d65 6e74 2074 6861 7420 6465 616c cument that deal │ │ │ │ │ +000472f0: 7320 6578 636c 7573 6976 656c 7920 7769 s exclusively wi │ │ │ │ │ +00047300: 7468 2074 6865 2072 656c 6174 696f 6e73 th the relations │ │ │ │ │ +00047310: 6869 7020 6f66 2074 6865 0a20 2020 2020 hip of the. │ │ │ │ │ +00047320: 7075 626c 6973 6865 7273 206f 7220 6175 publishers or au │ │ │ │ │ +00047330: 7468 6f72 7320 6f66 2074 6865 2044 6f63 thors of the Doc │ │ │ │ │ +00047340: 756d 656e 7420 746f 2074 6865 2044 6f63 ument to the Doc │ │ │ │ │ +00047350: 756d 656e 7427 7320 6f76 6572 616c 6c0a ument's overall. │ │ │ │ │ +00047360: 2020 2020 2073 7562 6a65 6374 2028 6f72 subject (or │ │ │ │ │ +00047370: 2074 6f20 7265 6c61 7465 6420 6d61 7474 to related matt │ │ │ │ │ +00047380: 6572 7329 2061 6e64 2063 6f6e 7461 696e ers) and contain │ │ │ │ │ +00047390: 7320 6e6f 7468 696e 6720 7468 6174 2063 s nothing that c │ │ │ │ │ +000473a0: 6f75 6c64 0a20 2020 2020 6661 6c6c 2064 ould. fall d │ │ │ │ │ +000473b0: 6972 6563 746c 7920 7769 7468 696e 2074 irectly within t │ │ │ │ │ +000473c0: 6861 7420 6f76 6572 616c 6c20 7375 626a hat overall subj │ │ │ │ │ +000473d0: 6563 742e 2020 2854 6875 732c 2069 6620 ect. (Thus, if │ │ │ │ │ +000473e0: 7468 6520 446f 6375 6d65 6e74 0a20 2020 the Document. │ │ │ │ │ +000473f0: 2020 6973 2069 6e20 7061 7274 2061 2074 is in part a t │ │ │ │ │ +00047400: 6578 7462 6f6f 6b20 6f66 206d 6174 6865 extbook of mathe │ │ │ │ │ +00047410: 6d61 7469 6373 2c20 6120 5365 636f 6e64 matics, a Second │ │ │ │ │ +00047420: 6172 7920 5365 6374 696f 6e20 6d61 7920 ary Section may │ │ │ │ │ +00047430: 6e6f 740a 2020 2020 2065 7870 6c61 696e not. explain │ │ │ │ │ +00047440: 2061 6e79 206d 6174 6865 6d61 7469 6373 any mathematics │ │ │ │ │ +00047450: 2e29 2020 5468 6520 7265 6c61 7469 6f6e .) The relation │ │ │ │ │ +00047460: 7368 6970 2063 6f75 6c64 2062 6520 6120 ship could be a │ │ │ │ │ +00047470: 6d61 7474 6572 206f 660a 2020 2020 2068 matter of. h │ │ │ │ │ +00047480: 6973 746f 7269 6361 6c20 636f 6e6e 6563 istorical connec │ │ │ │ │ +00047490: 7469 6f6e 2077 6974 6820 7468 6520 7375 tion with the su │ │ │ │ │ +000474a0: 626a 6563 7420 6f72 2077 6974 6820 7265 bject or with re │ │ │ │ │ +000474b0: 6c61 7465 6420 6d61 7474 6572 732c 206f lated matters, o │ │ │ │ │ +000474c0: 720a 2020 2020 206f 6620 6c65 6761 6c2c r. of legal, │ │ │ │ │ +000474d0: 2063 6f6d 6d65 7263 6961 6c2c 2070 6869 commercial, phi │ │ │ │ │ +000474e0: 6c6f 736f 7068 6963 616c 2c20 6574 6869 losophical, ethi │ │ │ │ │ +000474f0: 6361 6c20 6f72 2070 6f6c 6974 6963 616c cal or political │ │ │ │ │ +00047500: 2070 6f73 6974 696f 6e0a 2020 2020 2072 position. r │ │ │ │ │ +00047510: 6567 6172 6469 6e67 2074 6865 6d2e 0a0a egarding them... │ │ │ │ │ +00047520: 2020 2020 2054 6865 2022 496e 7661 7269 The "Invari │ │ │ │ │ +00047530: 616e 7420 5365 6374 696f 6e73 2220 6172 ant Sections" ar │ │ │ │ │ +00047540: 6520 6365 7274 6169 6e20 5365 636f 6e64 e certain Second │ │ │ │ │ +00047550: 6172 7920 5365 6374 696f 6e73 2077 686f ary Sections who │ │ │ │ │ +00047560: 7365 0a20 2020 2020 7469 746c 6573 2061 se. titles a │ │ │ │ │ +00047570: 7265 2064 6573 6967 6e61 7465 642c 2061 re designated, a │ │ │ │ │ +00047580: 7320 6265 696e 6720 7468 6f73 6520 6f66 s being those of │ │ │ │ │ +00047590: 2049 6e76 6172 6961 6e74 2053 6563 7469 Invariant Secti │ │ │ │ │ +000475a0: 6f6e 732c 2069 6e20 7468 650a 2020 2020 ons, in the. │ │ │ │ │ +000475b0: 206e 6f74 6963 6520 7468 6174 2073 6179 notice that say │ │ │ │ │ +000475c0: 7320 7468 6174 2074 6865 2044 6f63 756d s that the Docum │ │ │ │ │ +000475d0: 656e 7420 6973 2072 656c 6561 7365 6420 ent is released │ │ │ │ │ +000475e0: 756e 6465 7220 7468 6973 204c 6963 656e under this Licen │ │ │ │ │ +000475f0: 7365 2e0a 2020 2020 2049 6620 6120 7365 se.. If a se │ │ │ │ │ +00047600: 6374 696f 6e20 646f 6573 206e 6f74 2066 ction does not f │ │ │ │ │ +00047610: 6974 2074 6865 2061 626f 7665 2064 6566 it the above def │ │ │ │ │ +00047620: 696e 6974 696f 6e20 6f66 2053 6563 6f6e inition of Secon │ │ │ │ │ +00047630: 6461 7279 2074 6865 6e20 6974 0a20 2020 dary then it. │ │ │ │ │ +00047640: 2020 6973 206e 6f74 2061 6c6c 6f77 6564 is not allowed │ │ │ │ │ +00047650: 2074 6f20 6265 2064 6573 6967 6e61 7465 to be designate │ │ │ │ │ +00047660: 6420 6173 2049 6e76 6172 6961 6e74 2e20 d as Invariant. │ │ │ │ │ +00047670: 2054 6865 2044 6f63 756d 656e 7420 6d61 The Document ma │ │ │ │ │ +00047680: 790a 2020 2020 2063 6f6e 7461 696e 207a y. contain z │ │ │ │ │ +00047690: 6572 6f20 496e 7661 7269 616e 7420 5365 ero Invariant Se │ │ │ │ │ +000476a0: 6374 696f 6e73 2e20 2049 6620 7468 6520 ctions. If the │ │ │ │ │ +000476b0: 446f 6375 6d65 6e74 2064 6f65 7320 6e6f Document does no │ │ │ │ │ +000476c0: 7420 6964 656e 7469 6679 0a20 2020 2020 t identify. │ │ │ │ │ +000476d0: 616e 7920 496e 7661 7269 616e 7420 5365 any Invariant Se │ │ │ │ │ +000476e0: 6374 696f 6e73 2074 6865 6e20 7468 6572 ctions then ther │ │ │ │ │ +000476f0: 6520 6172 6520 6e6f 6e65 2e0a 0a20 2020 e are none... │ │ │ │ │ +00047700: 2020 5468 6520 2243 6f76 6572 2054 6578 The "Cover Tex │ │ │ │ │ +00047710: 7473 2220 6172 6520 6365 7274 6169 6e20 ts" are certain │ │ │ │ │ +00047720: 7368 6f72 7420 7061 7373 6167 6573 206f short passages o │ │ │ │ │ +00047730: 6620 7465 7874 2074 6861 7420 6172 650a f text that are. │ │ │ │ │ +00047740: 2020 2020 206c 6973 7465 642c 2061 7320 listed, as │ │ │ │ │ +00047750: 4672 6f6e 742d 436f 7665 7220 5465 7874 Front-Cover Text │ │ │ │ │ +00047760: 7320 6f72 2042 6163 6b2d 436f 7665 7220 s or Back-Cover │ │ │ │ │ +00047770: 5465 7874 732c 2069 6e20 7468 6520 6e6f Texts, in the no │ │ │ │ │ +00047780: 7469 6365 0a20 2020 2020 7468 6174 2073 tice. that s │ │ │ │ │ +00047790: 6179 7320 7468 6174 2074 6865 2044 6f63 ays that the Doc │ │ │ │ │ +000477a0: 756d 656e 7420 6973 2072 656c 6561 7365 ument is release │ │ │ │ │ +000477b0: 6420 756e 6465 7220 7468 6973 204c 6963 d under this Lic │ │ │ │ │ +000477c0: 656e 7365 2e20 2041 0a20 2020 2020 4672 ense. A. Fr │ │ │ │ │ +000477d0: 6f6e 742d 436f 7665 7220 5465 7874 206d ont-Cover Text m │ │ │ │ │ +000477e0: 6179 2062 6520 6174 206d 6f73 7420 3520 ay be at most 5 │ │ │ │ │ +000477f0: 776f 7264 732c 2061 6e64 2061 2042 6163 words, and a Bac │ │ │ │ │ +00047800: 6b2d 436f 7665 7220 5465 7874 206d 6179 k-Cover Text may │ │ │ │ │ +00047810: 0a20 2020 2020 6265 2061 7420 6d6f 7374 . be at most │ │ │ │ │ +00047820: 2032 3520 776f 7264 732e 0a0a 2020 2020 25 words... │ │ │ │ │ +00047830: 2041 2022 5472 616e 7370 6172 656e 7422 A "Transparent" │ │ │ │ │ +00047840: 2063 6f70 7920 6f66 2074 6865 2044 6f63 copy of the Doc │ │ │ │ │ +00047850: 756d 656e 7420 6d65 616e 7320 6120 6d61 ument means a ma │ │ │ │ │ +00047860: 6368 696e 652d 7265 6164 6162 6c65 2063 chine-readable c │ │ │ │ │ +00047870: 6f70 792c 0a20 2020 2020 7265 7072 6573 opy,. repres │ │ │ │ │ +00047880: 656e 7465 6420 696e 2061 2066 6f72 6d61 ented in a forma │ │ │ │ │ +00047890: 7420 7768 6f73 6520 7370 6563 6966 6963 t whose specific │ │ │ │ │ +000478a0: 6174 696f 6e20 6973 2061 7661 696c 6162 ation is availab │ │ │ │ │ +000478b0: 6c65 2074 6f20 7468 650a 2020 2020 2067 le to the. g │ │ │ │ │ +000478c0: 656e 6572 616c 2070 7562 6c69 632c 2074 eneral public, t │ │ │ │ │ +000478d0: 6861 7420 6973 2073 7569 7461 626c 6520 hat is suitable │ │ │ │ │ +000478e0: 666f 7220 7265 7669 7369 6e67 2074 6865 for revising the │ │ │ │ │ +000478f0: 2064 6f63 756d 656e 740a 2020 2020 2073 document. s │ │ │ │ │ +00047900: 7472 6169 6768 7466 6f72 7761 7264 6c79 traightforwardly │ │ │ │ │ +00047910: 2077 6974 6820 6765 6e65 7269 6320 7465 with generic te │ │ │ │ │ +00047920: 7874 2065 6469 746f 7273 206f 7220 2866 xt editors or (f │ │ │ │ │ +00047930: 6f72 2069 6d61 6765 7320 636f 6d70 6f73 or images compos │ │ │ │ │ +00047940: 6564 0a20 2020 2020 6f66 2070 6978 656c ed. of pixel │ │ │ │ │ +00047950: 7329 2067 656e 6572 6963 2070 6169 6e74 s) generic paint │ │ │ │ │ +00047960: 2070 726f 6772 616d 7320 6f72 2028 666f programs or (fo │ │ │ │ │ +00047970: 7220 6472 6177 696e 6773 2920 736f 6d65 r drawings) some │ │ │ │ │ +00047980: 2077 6964 656c 790a 2020 2020 2061 7661 widely. ava │ │ │ │ │ +00047990: 696c 6162 6c65 2064 7261 7769 6e67 2065 ilable drawing e │ │ │ │ │ +000479a0: 6469 746f 722c 2061 6e64 2074 6861 7420 ditor, and that │ │ │ │ │ +000479b0: 6973 2073 7569 7461 626c 6520 666f 7220 is suitable for │ │ │ │ │ +000479c0: 696e 7075 7420 746f 2074 6578 740a 2020 input to text. │ │ │ │ │ +000479d0: 2020 2066 6f72 6d61 7474 6572 7320 6f72 formatters or │ │ │ │ │ +000479e0: 2066 6f72 2061 7574 6f6d 6174 6963 2074 for automatic t │ │ │ │ │ +000479f0: 7261 6e73 6c61 7469 6f6e 2074 6f20 6120 ranslation to a │ │ │ │ │ +00047a00: 7661 7269 6574 7920 6f66 2066 6f72 6d61 variety of forma │ │ │ │ │ +00047a10: 7473 0a20 2020 2020 7375 6974 6162 6c65 ts. suitable │ │ │ │ │ +00047a20: 2066 6f72 2069 6e70 7574 2074 6f20 7465 for input to te │ │ │ │ │ +00047a30: 7874 2066 6f72 6d61 7474 6572 732e 2020 xt formatters. │ │ │ │ │ +00047a40: 4120 636f 7079 206d 6164 6520 696e 2061 A copy made in a │ │ │ │ │ +00047a50: 6e20 6f74 6865 7277 6973 650a 2020 2020 n otherwise. │ │ │ │ │ +00047a60: 2054 7261 6e73 7061 7265 6e74 2066 696c Transparent fil │ │ │ │ │ +00047a70: 6520 666f 726d 6174 2077 686f 7365 206d e format whose m │ │ │ │ │ +00047a80: 6172 6b75 702c 206f 7220 6162 7365 6e63 arkup, or absenc │ │ │ │ │ +00047a90: 6520 6f66 206d 6172 6b75 702c 2068 6173 e of markup, has │ │ │ │ │ +00047aa0: 0a20 2020 2020 6265 656e 2061 7272 616e . been arran │ │ │ │ │ +00047ab0: 6765 6420 746f 2074 6877 6172 7420 6f72 ged to thwart or │ │ │ │ │ +00047ac0: 2064 6973 636f 7572 6167 6520 7375 6273 discourage subs │ │ │ │ │ +00047ad0: 6571 7565 6e74 206d 6f64 6966 6963 6174 equent modificat │ │ │ │ │ +00047ae0: 696f 6e20 6279 0a20 2020 2020 7265 6164 ion by. read │ │ │ │ │ +00047af0: 6572 7320 6973 206e 6f74 2054 7261 6e73 ers is not Trans │ │ │ │ │ +00047b00: 7061 7265 6e74 2e20 2041 6e20 696d 6167 parent. An imag │ │ │ │ │ +00047b10: 6520 666f 726d 6174 2069 7320 6e6f 7420 e format is not │ │ │ │ │ +00047b20: 5472 616e 7370 6172 656e 7420 6966 0a20 Transparent if. │ │ │ │ │ +00047b30: 2020 2020 7573 6564 2066 6f72 2061 6e79 used for any │ │ │ │ │ +00047b40: 2073 7562 7374 616e 7469 616c 2061 6d6f substantial amo │ │ │ │ │ +00047b50: 756e 7420 6f66 2074 6578 742e 2020 4120 unt of text. A │ │ │ │ │ +00047b60: 636f 7079 2074 6861 7420 6973 206e 6f74 copy that is not │ │ │ │ │ +00047b70: 0a20 2020 2020 2254 7261 6e73 7061 7265 . "Transpare │ │ │ │ │ +00047b80: 6e74 2220 6973 2063 616c 6c65 6420 224f nt" is called "O │ │ │ │ │ +00047b90: 7061 7175 6522 2e0a 0a20 2020 2020 4578 paque"... Ex │ │ │ │ │ +00047ba0: 616d 706c 6573 206f 6620 7375 6974 6162 amples of suitab │ │ │ │ │ +00047bb0: 6c65 2066 6f72 6d61 7473 2066 6f72 2054 le formats for T │ │ │ │ │ +00047bc0: 7261 6e73 7061 7265 6e74 2063 6f70 6965 ransparent copie │ │ │ │ │ +00047bd0: 7320 696e 636c 7564 6520 706c 6169 6e0a s include plain. │ │ │ │ │ +00047be0: 2020 2020 2041 5343 4949 2077 6974 686f ASCII witho │ │ │ │ │ +00047bf0: 7574 206d 6172 6b75 702c 2054 6578 696e ut markup, Texin │ │ │ │ │ +00047c00: 666f 2069 6e70 7574 2066 6f72 6d61 742c fo input format, │ │ │ │ │ +00047c10: 204c 6154 6558 2069 6e70 7574 2066 6f72 LaTeX input for │ │ │ │ │ +00047c20: 6d61 742c 0a20 2020 2020 5347 4d4c 206f mat,. SGML o │ │ │ │ │ +00047c30: 7220 584d 4c20 7573 696e 6720 6120 7075 r XML using a pu │ │ │ │ │ +00047c40: 626c 6963 6c79 2061 7661 696c 6162 6c65 blicly available │ │ │ │ │ +00047c50: 2044 5444 2c20 616e 6420 7374 616e 6461 DTD, and standa │ │ │ │ │ +00047c60: 7264 2d63 6f6e 666f 726d 696e 670a 2020 rd-conforming. │ │ │ │ │ +00047c70: 2020 2073 696d 706c 6520 4854 4d4c 2c20 simple HTML, │ │ │ │ │ +00047c80: 506f 7374 5363 7269 7074 206f 7220 5044 PostScript or PD │ │ │ │ │ +00047c90: 4620 6465 7369 676e 6564 2066 6f72 2068 F designed for h │ │ │ │ │ +00047ca0: 756d 616e 206d 6f64 6966 6963 6174 696f uman modificatio │ │ │ │ │ +00047cb0: 6e2e 0a20 2020 2020 4578 616d 706c 6573 n.. Examples │ │ │ │ │ +00047cc0: 206f 6620 7472 616e 7370 6172 656e 7420 of transparent │ │ │ │ │ +00047cd0: 696d 6167 6520 666f 726d 6174 7320 696e image formats in │ │ │ │ │ +00047ce0: 636c 7564 6520 504e 472c 2058 4346 2061 clude PNG, XCF a │ │ │ │ │ +00047cf0: 6e64 204a 5047 2e0a 2020 2020 204f 7061 nd JPG.. Opa │ │ │ │ │ +00047d00: 7175 6520 666f 726d 6174 7320 696e 636c que formats incl │ │ │ │ │ +00047d10: 7564 6520 7072 6f70 7269 6574 6172 7920 ude proprietary │ │ │ │ │ +00047d20: 666f 726d 6174 7320 7468 6174 2063 616e formats that can │ │ │ │ │ +00047d30: 2062 6520 7265 6164 2061 6e64 0a20 2020 be read and. │ │ │ │ │ +00047d40: 2020 6564 6974 6564 206f 6e6c 7920 6279 edited only by │ │ │ │ │ +00047d50: 2070 726f 7072 6965 7461 7279 2077 6f72 proprietary wor │ │ │ │ │ +00047d60: 6420 7072 6f63 6573 736f 7273 2c20 5347 d processors, SG │ │ │ │ │ +00047d70: 4d4c 206f 7220 584d 4c20 666f 7220 7768 ML or XML for wh │ │ │ │ │ +00047d80: 6963 680a 2020 2020 2074 6865 2044 5444 ich. the DTD │ │ │ │ │ +00047d90: 2061 6e64 2f6f 7220 7072 6f63 6573 7369 and/or processi │ │ │ │ │ +00047da0: 6e67 2074 6f6f 6c73 2061 7265 206e 6f74 ng tools are not │ │ │ │ │ +00047db0: 2067 656e 6572 616c 6c79 2061 7661 696c generally avail │ │ │ │ │ +00047dc0: 6162 6c65 2c20 616e 640a 2020 2020 2074 able, and. t │ │ │ │ │ +00047dd0: 6865 206d 6163 6869 6e65 2d67 656e 6572 he machine-gener │ │ │ │ │ +00047de0: 6174 6564 2048 544d 4c2c 2050 6f73 7453 ated HTML, PostS │ │ │ │ │ +00047df0: 6372 6970 7420 6f72 2050 4446 2070 726f cript or PDF pro │ │ │ │ │ +00047e00: 6475 6365 6420 6279 2073 6f6d 6520 776f duced by some wo │ │ │ │ │ +00047e10: 7264 0a20 2020 2020 7072 6f63 6573 736f rd. processo │ │ │ │ │ +00047e20: 7273 2066 6f72 206f 7574 7075 7420 7075 rs for output pu │ │ │ │ │ +00047e30: 7270 6f73 6573 206f 6e6c 792e 0a0a 2020 rposes only... │ │ │ │ │ +00047e40: 2020 2054 6865 2022 5469 746c 6520 5061 The "Title Pa │ │ │ │ │ +00047e50: 6765 2220 6d65 616e 732c 2066 6f72 2061 ge" means, for a │ │ │ │ │ +00047e60: 2070 7269 6e74 6564 2062 6f6f 6b2c 2074 printed book, t │ │ │ │ │ +00047e70: 6865 2074 6974 6c65 2070 6167 6520 6974 he title page it │ │ │ │ │ +00047e80: 7365 6c66 2c0a 2020 2020 2070 6c75 7320 self,. plus │ │ │ │ │ +00047e90: 7375 6368 2066 6f6c 6c6f 7769 6e67 2070 such following p │ │ │ │ │ +00047ea0: 6167 6573 2061 7320 6172 6520 6e65 6564 ages as are need │ │ │ │ │ +00047eb0: 6564 2074 6f20 686f 6c64 2c20 6c65 6769 ed to hold, legi │ │ │ │ │ +00047ec0: 626c 792c 2074 6865 0a20 2020 2020 6d61 bly, the. ma │ │ │ │ │ +00047ed0: 7465 7269 616c 2074 6869 7320 4c69 6365 terial this Lice │ │ │ │ │ +00047ee0: 6e73 6520 7265 7175 6972 6573 2074 6f20 nse requires to │ │ │ │ │ +00047ef0: 6170 7065 6172 2069 6e20 7468 6520 7469 appear in the ti │ │ │ │ │ +00047f00: 746c 6520 7061 6765 2e20 2046 6f72 0a20 tle page. For. │ │ │ │ │ +00047f10: 2020 2020 776f 726b 7320 696e 2066 6f72 works in for │ │ │ │ │ +00047f20: 6d61 7473 2077 6869 6368 2064 6f20 6e6f mats which do no │ │ │ │ │ +00047f30: 7420 6861 7665 2061 6e79 2074 6974 6c65 t have any title │ │ │ │ │ +00047f40: 2070 6167 6520 6173 2073 7563 682c 2022 page as such, " │ │ │ │ │ +00047f50: 5469 746c 650a 2020 2020 2050 6167 6522 Title. Page" │ │ │ │ │ +00047f60: 206d 6561 6e73 2074 6865 2074 6578 7420 means the text │ │ │ │ │ +00047f70: 6e65 6172 2074 6865 206d 6f73 7420 7072 near the most pr │ │ │ │ │ +00047f80: 6f6d 696e 656e 7420 6170 7065 6172 616e ominent appearan │ │ │ │ │ +00047f90: 6365 206f 6620 7468 650a 2020 2020 2077 ce of the. w │ │ │ │ │ +00047fa0: 6f72 6b27 7320 7469 746c 652c 2070 7265 ork's title, pre │ │ │ │ │ +00047fb0: 6365 6469 6e67 2074 6865 2062 6567 696e ceding the begin │ │ │ │ │ +00047fc0: 6e69 6e67 206f 6620 7468 6520 626f 6479 ning of the body │ │ │ │ │ +00047fd0: 206f 6620 7468 6520 7465 7874 2e0a 0a20 of the text... │ │ │ │ │ +00047fe0: 2020 2020 4120 7365 6374 696f 6e20 2245 A section "E │ │ │ │ │ +00047ff0: 6e74 6974 6c65 6420 5859 5a22 206d 6561 ntitled XYZ" mea │ │ │ │ │ +00048000: 6e73 2061 206e 616d 6564 2073 7562 756e ns a named subun │ │ │ │ │ +00048010: 6974 206f 6620 7468 6520 446f 6375 6d65 it of the Docume │ │ │ │ │ +00048020: 6e74 0a20 2020 2020 7768 6f73 6520 7469 nt. whose ti │ │ │ │ │ +00048030: 746c 6520 6569 7468 6572 2069 7320 7072 tle either is pr │ │ │ │ │ +00048040: 6563 6973 656c 7920 5859 5a20 6f72 2063 ecisely XYZ or c │ │ │ │ │ +00048050: 6f6e 7461 696e 7320 5859 5a20 696e 2070 ontains XYZ in p │ │ │ │ │ +00048060: 6172 656e 7468 6573 6573 0a20 2020 2020 arentheses. │ │ │ │ │ +00048070: 666f 6c6c 6f77 696e 6720 7465 7874 2074 following text t │ │ │ │ │ +00048080: 6861 7420 7472 616e 736c 6174 6573 2058 hat translates X │ │ │ │ │ +00048090: 595a 2069 6e20 616e 6f74 6865 7220 6c61 YZ in another la │ │ │ │ │ +000480a0: 6e67 7561 6765 2e20 2028 4865 7265 2058 nguage. (Here X │ │ │ │ │ +000480b0: 595a 0a20 2020 2020 7374 616e 6473 2066 YZ. stands f │ │ │ │ │ +000480c0: 6f72 2061 2073 7065 6369 6669 6320 7365 or a specific se │ │ │ │ │ +000480d0: 6374 696f 6e20 6e61 6d65 206d 656e 7469 ction name menti │ │ │ │ │ +000480e0: 6f6e 6564 2062 656c 6f77 2c20 7375 6368 oned below, such │ │ │ │ │ +000480f0: 2061 730a 2020 2020 2022 4163 6b6e 6f77 as. "Acknow │ │ │ │ │ +00048100: 6c65 6467 656d 656e 7473 222c 2022 4465 ledgements", "De │ │ │ │ │ +00048110: 6469 6361 7469 6f6e 7322 2c20 2245 6e64 dications", "End │ │ │ │ │ +00048120: 6f72 7365 6d65 6e74 7322 2c20 6f72 2022 orsements", or " │ │ │ │ │ +00048130: 4869 7374 6f72 7922 2e29 0a20 2020 2020 History".). │ │ │ │ │ +00048140: 546f 2022 5072 6573 6572 7665 2074 6865 To "Preserve the │ │ │ │ │ +00048150: 2054 6974 6c65 2220 6f66 2073 7563 6820 Title" of such │ │ │ │ │ +00048160: 6120 7365 6374 696f 6e20 7768 656e 2079 a section when y │ │ │ │ │ +00048170: 6f75 206d 6f64 6966 7920 7468 650a 2020 ou modify the. │ │ │ │ │ +00048180: 2020 2044 6f63 756d 656e 7420 6d65 616e Document mean │ │ │ │ │ +00048190: 7320 7468 6174 2069 7420 7265 6d61 696e s that it remain │ │ │ │ │ +000481a0: 7320 6120 7365 6374 696f 6e20 2245 6e74 s a section "Ent │ │ │ │ │ +000481b0: 6974 6c65 6420 5859 5a22 2061 6363 6f72 itled XYZ" accor │ │ │ │ │ +000481c0: 6469 6e67 0a20 2020 2020 746f 2074 6869 ding. to thi │ │ │ │ │ +000481d0: 7320 6465 6669 6e69 7469 6f6e 2e0a 0a20 s definition... │ │ │ │ │ +000481e0: 2020 2020 5468 6520 446f 6375 6d65 6e74 The Document │ │ │ │ │ +000481f0: 206d 6179 2069 6e63 6c75 6465 2057 6172 may include War │ │ │ │ │ +00048200: 7261 6e74 7920 4469 7363 6c61 696d 6572 ranty Disclaimer │ │ │ │ │ +00048210: 7320 6e65 7874 2074 6f20 7468 6520 6e6f s next to the no │ │ │ │ │ +00048220: 7469 6365 0a20 2020 2020 7768 6963 6820 tice. which │ │ │ │ │ +00048230: 7374 6174 6573 2074 6861 7420 7468 6973 states that this │ │ │ │ │ +00048240: 204c 6963 656e 7365 2061 7070 6c69 6573 License applies │ │ │ │ │ +00048250: 2074 6f20 7468 6520 446f 6375 6d65 6e74 to the Document │ │ │ │ │ +00048260: 2e20 2054 6865 7365 0a20 2020 2020 5761 . These. Wa │ │ │ │ │ +00048270: 7272 616e 7479 2044 6973 636c 6169 6d65 rranty Disclaime │ │ │ │ │ +00048280: 7273 2061 7265 2063 6f6e 7369 6465 7265 rs are considere │ │ │ │ │ +00048290: 6420 746f 2062 6520 696e 636c 7564 6564 d to be included │ │ │ │ │ +000482a0: 2062 7920 7265 6665 7265 6e63 6520 696e by reference in │ │ │ │ │ +000482b0: 0a20 2020 2020 7468 6973 204c 6963 656e . this Licen │ │ │ │ │ +000482c0: 7365 2c20 6275 7420 6f6e 6c79 2061 7320 se, but only as │ │ │ │ │ +000482d0: 7265 6761 7264 7320 6469 7363 6c61 696d regards disclaim │ │ │ │ │ +000482e0: 696e 6720 7761 7272 616e 7469 6573 3a20 ing warranties: │ │ │ │ │ +000482f0: 616e 7920 6f74 6865 720a 2020 2020 2069 any other. i │ │ │ │ │ +00048300: 6d70 6c69 6361 7469 6f6e 2074 6861 7420 mplication that │ │ │ │ │ +00048310: 7468 6573 6520 5761 7272 616e 7479 2044 these Warranty D │ │ │ │ │ +00048320: 6973 636c 6169 6d65 7273 206d 6179 2068 isclaimers may h │ │ │ │ │ +00048330: 6176 6520 6973 2076 6f69 6420 616e 640a ave is void and. │ │ │ │ │ +00048340: 2020 2020 2068 6173 206e 6f20 6566 6665 has no effe │ │ │ │ │ +00048350: 6374 206f 6e20 7468 6520 6d65 616e 696e ct on the meanin │ │ │ │ │ +00048360: 6720 6f66 2074 6869 7320 4c69 6365 6e73 g of this Licens │ │ │ │ │ +00048370: 652e 0a0a 2020 322e 2056 4552 4241 5449 e... 2. VERBATI │ │ │ │ │ +00048380: 4d20 434f 5059 494e 470a 0a20 2020 2020 M COPYING.. │ │ │ │ │ +00048390: 596f 7520 6d61 7920 636f 7079 2061 6e64 You may copy and │ │ │ │ │ +000483a0: 2064 6973 7472 6962 7574 6520 7468 6520 distribute the │ │ │ │ │ +000483b0: 446f 6375 6d65 6e74 2069 6e20 616e 7920 Document in any │ │ │ │ │ +000483c0: 6d65 6469 756d 2c20 6569 7468 6572 0a20 medium, either. │ │ │ │ │ +000483d0: 2020 2020 636f 6d6d 6572 6369 616c 6c79 commercially │ │ │ │ │ +000483e0: 206f 7220 6e6f 6e63 6f6d 6d65 7263 6961 or noncommercia │ │ │ │ │ +000483f0: 6c6c 792c 2070 726f 7669 6465 6420 7468 lly, provided th │ │ │ │ │ +00048400: 6174 2074 6869 7320 4c69 6365 6e73 652c at this License, │ │ │ │ │ +00048410: 2074 6865 0a20 2020 2020 636f 7079 7269 the. copyri │ │ │ │ │ +00048420: 6768 7420 6e6f 7469 6365 732c 2061 6e64 ght notices, and │ │ │ │ │ +00048430: 2074 6865 206c 6963 656e 7365 206e 6f74 the license not │ │ │ │ │ +00048440: 6963 6520 7361 7969 6e67 2074 6869 7320 ice saying this │ │ │ │ │ +00048450: 4c69 6365 6e73 650a 2020 2020 2061 7070 License. app │ │ │ │ │ +00048460: 6c69 6573 2074 6f20 7468 6520 446f 6375 lies to the Docu │ │ │ │ │ +00048470: 6d65 6e74 2061 7265 2072 6570 726f 6475 ment are reprodu │ │ │ │ │ +00048480: 6365 6420 696e 2061 6c6c 2063 6f70 6965 ced in all copie │ │ │ │ │ +00048490: 732c 2061 6e64 2074 6861 7420 796f 750a s, and that you. │ │ │ │ │ +000484a0: 2020 2020 2061 6464 206e 6f20 6f74 6865 add no othe │ │ │ │ │ +000484b0: 7220 636f 6e64 6974 696f 6e73 2077 6861 r conditions wha │ │ │ │ │ +000484c0: 7473 6f65 7665 7220 746f 2074 686f 7365 tsoever to those │ │ │ │ │ +000484d0: 206f 6620 7468 6973 204c 6963 656e 7365 of this License │ │ │ │ │ +000484e0: 2e20 2059 6f75 0a20 2020 2020 6d61 7920 . You. may │ │ │ │ │ +000484f0: 6e6f 7420 7573 6520 7465 6368 6e69 6361 not use technica │ │ │ │ │ +00048500: 6c20 6d65 6173 7572 6573 2074 6f20 6f62 l measures to ob │ │ │ │ │ +00048510: 7374 7275 6374 206f 7220 636f 6e74 726f struct or contro │ │ │ │ │ +00048520: 6c20 7468 6520 7265 6164 696e 670a 2020 l the reading. │ │ │ │ │ +00048530: 2020 206f 7220 6675 7274 6865 7220 636f or further co │ │ │ │ │ +00048540: 7079 696e 6720 6f66 2074 6865 2063 6f70 pying of the cop │ │ │ │ │ +00048550: 6965 7320 796f 7520 6d61 6b65 206f 7220 ies you make or │ │ │ │ │ +00048560: 6469 7374 7269 6275 7465 2e20 2048 6f77 distribute. How │ │ │ │ │ +00048570: 6576 6572 2c0a 2020 2020 2079 6f75 206d ever,. you m │ │ │ │ │ +00048580: 6179 2061 6363 6570 7420 636f 6d70 656e ay accept compen │ │ │ │ │ +00048590: 7361 7469 6f6e 2069 6e20 6578 6368 616e sation in exchan │ │ │ │ │ +000485a0: 6765 2066 6f72 2063 6f70 6965 732e 2020 ge for copies. │ │ │ │ │ +000485b0: 4966 2079 6f75 0a20 2020 2020 6469 7374 If you. dist │ │ │ │ │ +000485c0: 7269 6275 7465 2061 206c 6172 6765 2065 ribute a large e │ │ │ │ │ +000485d0: 6e6f 7567 6820 6e75 6d62 6572 206f 6620 nough number of │ │ │ │ │ +000485e0: 636f 7069 6573 2079 6f75 206d 7573 7420 copies you must │ │ │ │ │ +000485f0: 616c 736f 2066 6f6c 6c6f 7720 7468 650a also follow the. │ │ │ │ │ +00048600: 2020 2020 2063 6f6e 6469 7469 6f6e 7320 conditions │ │ │ │ │ +00048610: 696e 2073 6563 7469 6f6e 2033 2e0a 0a20 in section 3... │ │ │ │ │ +00048620: 2020 2020 596f 7520 6d61 7920 616c 736f You may also │ │ │ │ │ +00048630: 206c 656e 6420 636f 7069 6573 2c20 756e lend copies, un │ │ │ │ │ +00048640: 6465 7220 7468 6520 7361 6d65 2063 6f6e der the same con │ │ │ │ │ +00048650: 6469 7469 6f6e 7320 7374 6174 6564 2061 ditions stated a │ │ │ │ │ +00048660: 626f 7665 2c0a 2020 2020 2061 6e64 2079 bove,. and y │ │ │ │ │ +00048670: 6f75 206d 6179 2070 7562 6c69 636c 7920 ou may publicly │ │ │ │ │ +00048680: 6469 7370 6c61 7920 636f 7069 6573 2e0a display copies.. │ │ │ │ │ +00048690: 0a20 2033 2e20 434f 5059 494e 4720 494e . 3. COPYING IN │ │ │ │ │ +000486a0: 2051 5541 4e54 4954 590a 0a20 2020 2020 QUANTITY.. │ │ │ │ │ +000486b0: 4966 2079 6f75 2070 7562 6c69 7368 2070 If you publish p │ │ │ │ │ +000486c0: 7269 6e74 6564 2063 6f70 6965 7320 286f rinted copies (o │ │ │ │ │ +000486d0: 7220 636f 7069 6573 2069 6e20 6d65 6469 r copies in medi │ │ │ │ │ +000486e0: 6120 7468 6174 2063 6f6d 6d6f 6e6c 790a a that commonly. │ │ │ │ │ +000486f0: 2020 2020 2068 6176 6520 7072 696e 7465 have printe │ │ │ │ │ +00048700: 6420 636f 7665 7273 2920 6f66 2074 6865 d covers) of the │ │ │ │ │ +00048710: 2044 6f63 756d 656e 742c 206e 756d 6265 Document, numbe │ │ │ │ │ +00048720: 7269 6e67 206d 6f72 6520 7468 616e 2031 ring more than 1 │ │ │ │ │ +00048730: 3030 2c20 616e 640a 2020 2020 2074 6865 00, and. the │ │ │ │ │ +00048740: 2044 6f63 756d 656e 7427 7320 6c69 6365 Document's lice │ │ │ │ │ +00048750: 6e73 6520 6e6f 7469 6365 2072 6571 7569 nse notice requi │ │ │ │ │ +00048760: 7265 7320 436f 7665 7220 5465 7874 732c res Cover Texts, │ │ │ │ │ +00048770: 2079 6f75 206d 7573 740a 2020 2020 2065 you must. e │ │ │ │ │ +00048780: 6e63 6c6f 7365 2074 6865 2063 6f70 6965 nclose the copie │ │ │ │ │ +00048790: 7320 696e 2063 6f76 6572 7320 7468 6174 s in covers that │ │ │ │ │ +000487a0: 2063 6172 7279 2c20 636c 6561 726c 7920 carry, clearly │ │ │ │ │ +000487b0: 616e 6420 6c65 6769 626c 792c 2061 6c6c and legibly, all │ │ │ │ │ +000487c0: 0a20 2020 2020 7468 6573 6520 436f 7665 . these Cove │ │ │ │ │ +000487d0: 7220 5465 7874 733a 2046 726f 6e74 2d43 r Texts: Front-C │ │ │ │ │ +000487e0: 6f76 6572 2054 6578 7473 206f 6e20 7468 over Texts on th │ │ │ │ │ +000487f0: 6520 6672 6f6e 7420 636f 7665 722c 2061 e front cover, a │ │ │ │ │ +00048800: 6e64 0a20 2020 2020 4261 636b 2d43 6f76 nd. Back-Cov │ │ │ │ │ +00048810: 6572 2054 6578 7473 206f 6e20 7468 6520 er Texts on the │ │ │ │ │ +00048820: 6261 636b 2063 6f76 6572 2e20 2042 6f74 back cover. Bot │ │ │ │ │ +00048830: 6820 636f 7665 7273 206d 7573 7420 616c h covers must al │ │ │ │ │ +00048840: 736f 2063 6c65 6172 6c79 0a20 2020 2020 so clearly. │ │ │ │ │ +00048850: 616e 6420 6c65 6769 626c 7920 6964 656e and legibly iden │ │ │ │ │ +00048860: 7469 6679 2079 6f75 2061 7320 7468 6520 tify you as the │ │ │ │ │ +00048870: 7075 626c 6973 6865 7220 6f66 2074 6865 publisher of the │ │ │ │ │ +00048880: 7365 2063 6f70 6965 732e 2020 5468 650a se copies. The. │ │ │ │ │ +00048890: 2020 2020 2066 726f 6e74 2063 6f76 6572 front cover │ │ │ │ │ +000488a0: 206d 7573 7420 7072 6573 656e 7420 7468 must present th │ │ │ │ │ +000488b0: 6520 6675 6c6c 2074 6974 6c65 2077 6974 e full title wit │ │ │ │ │ +000488c0: 6820 616c 6c20 776f 7264 7320 6f66 2074 h all words of t │ │ │ │ │ +000488d0: 6865 2074 6974 6c65 0a20 2020 2020 6571 he title. eq │ │ │ │ │ +000488e0: 7561 6c6c 7920 7072 6f6d 696e 656e 7420 ually prominent │ │ │ │ │ +000488f0: 616e 6420 7669 7369 626c 652e 2020 596f and visible. Yo │ │ │ │ │ +00048900: 7520 6d61 7920 6164 6420 6f74 6865 7220 u may add other │ │ │ │ │ +00048910: 6d61 7465 7269 616c 206f 6e20 7468 650a material on the. │ │ │ │ │ +00048920: 2020 2020 2063 6f76 6572 7320 696e 2061 covers in a │ │ │ │ │ +00048930: 6464 6974 696f 6e2e 2020 436f 7079 696e ddition. Copyin │ │ │ │ │ +00048940: 6720 7769 7468 2063 6861 6e67 6573 206c g with changes l │ │ │ │ │ +00048950: 696d 6974 6564 2074 6f20 7468 6520 636f imited to the co │ │ │ │ │ +00048960: 7665 7273 2c20 6173 0a20 2020 2020 6c6f vers, as. lo │ │ │ │ │ +00048970: 6e67 2061 7320 7468 6579 2070 7265 7365 ng as they prese │ │ │ │ │ +00048980: 7276 6520 7468 6520 7469 746c 6520 6f66 rve the title of │ │ │ │ │ +00048990: 2074 6865 2044 6f63 756d 656e 7420 616e the Document an │ │ │ │ │ +000489a0: 6420 7361 7469 7366 7920 7468 6573 650a d satisfy these. │ │ │ │ │ +000489b0: 2020 2020 2063 6f6e 6469 7469 6f6e 732c conditions, │ │ │ │ │ +000489c0: 2063 616e 2062 6520 7472 6561 7465 6420 can be treated │ │ │ │ │ +000489d0: 6173 2076 6572 6261 7469 6d20 636f 7079 as verbatim copy │ │ │ │ │ +000489e0: 696e 6720 696e 206f 7468 6572 2072 6573 ing in other res │ │ │ │ │ +000489f0: 7065 6374 732e 0a0a 2020 2020 2049 6620 pects... If │ │ │ │ │ +00048a00: 7468 6520 7265 7175 6972 6564 2074 6578 the required tex │ │ │ │ │ +00048a10: 7473 2066 6f72 2065 6974 6865 7220 636f ts for either co │ │ │ │ │ +00048a20: 7665 7220 6172 6520 746f 6f20 766f 6c75 ver are too volu │ │ │ │ │ +00048a30: 6d69 6e6f 7573 2074 6f20 6669 740a 2020 minous to fit. │ │ │ │ │ +00048a40: 2020 206c 6567 6962 6c79 2c20 796f 7520 legibly, you │ │ │ │ │ +00048a50: 7368 6f75 6c64 2070 7574 2074 6865 2066 should put the f │ │ │ │ │ +00048a60: 6972 7374 206f 6e65 7320 6c69 7374 6564 irst ones listed │ │ │ │ │ +00048a70: 2028 6173 206d 616e 7920 6173 2066 6974 (as many as fit │ │ │ │ │ +00048a80: 0a20 2020 2020 7265 6173 6f6e 6162 6c79 . reasonably │ │ │ │ │ +00048a90: 2920 6f6e 2074 6865 2061 6374 7561 6c20 ) on the actual │ │ │ │ │ +00048aa0: 636f 7665 722c 2061 6e64 2063 6f6e 7469 cover, and conti │ │ │ │ │ +00048ab0: 6e75 6520 7468 6520 7265 7374 206f 6e74 nue the rest ont │ │ │ │ │ +00048ac0: 6f0a 2020 2020 2061 646a 6163 656e 7420 o. adjacent │ │ │ │ │ +00048ad0: 7061 6765 732e 0a0a 2020 2020 2049 6620 pages... If │ │ │ │ │ +00048ae0: 796f 7520 7075 626c 6973 6820 6f72 2064 you publish or d │ │ │ │ │ +00048af0: 6973 7472 6962 7574 6520 4f70 6171 7565 istribute Opaque │ │ │ │ │ +00048b00: 2063 6f70 6965 7320 6f66 2074 6865 2044 copies of the D │ │ │ │ │ +00048b10: 6f63 756d 656e 740a 2020 2020 206e 756d ocument. num │ │ │ │ │ +00048b20: 6265 7269 6e67 206d 6f72 6520 7468 616e bering more than │ │ │ │ │ +00048b30: 2031 3030 2c20 796f 7520 6d75 7374 2065 100, you must e │ │ │ │ │ +00048b40: 6974 6865 7220 696e 636c 7564 6520 6120 ither include a │ │ │ │ │ +00048b50: 6d61 6368 696e 652d 7265 6164 6162 6c65 machine-readable │ │ │ │ │ +00048b60: 0a20 2020 2020 5472 616e 7370 6172 656e . Transparen │ │ │ │ │ +00048b70: 7420 636f 7079 2061 6c6f 6e67 2077 6974 t copy along wit │ │ │ │ │ +00048b80: 6820 6561 6368 204f 7061 7175 6520 636f h each Opaque co │ │ │ │ │ +00048b90: 7079 2c20 6f72 2073 7461 7465 2069 6e20 py, or state in │ │ │ │ │ +00048ba0: 6f72 2077 6974 680a 2020 2020 2065 6163 or with. eac │ │ │ │ │ +00048bb0: 6820 4f70 6171 7565 2063 6f70 7920 6120 h Opaque copy a │ │ │ │ │ +00048bc0: 636f 6d70 7574 6572 2d6e 6574 776f 726b computer-network │ │ │ │ │ +00048bd0: 206c 6f63 6174 696f 6e20 6672 6f6d 2077 location from w │ │ │ │ │ +00048be0: 6869 6368 2074 6865 2067 656e 6572 616c hich the general │ │ │ │ │ +00048bf0: 0a20 2020 2020 6e65 7477 6f72 6b2d 7573 . network-us │ │ │ │ │ +00048c00: 696e 6720 7075 626c 6963 2068 6173 2061 ing public has a │ │ │ │ │ +00048c10: 6363 6573 7320 746f 2064 6f77 6e6c 6f61 ccess to downloa │ │ │ │ │ +00048c20: 6420 7573 696e 6720 7075 626c 6963 2d73 d using public-s │ │ │ │ │ +00048c30: 7461 6e64 6172 640a 2020 2020 206e 6574 tandard. net │ │ │ │ │ +00048c40: 776f 726b 2070 726f 746f 636f 6c73 2061 work protocols a │ │ │ │ │ +00048c50: 2063 6f6d 706c 6574 6520 5472 616e 7370 complete Transp │ │ │ │ │ +00048c60: 6172 656e 7420 636f 7079 206f 6620 7468 arent copy of th │ │ │ │ │ +00048c70: 6520 446f 6375 6d65 6e74 2c20 6672 6565 e Document, free │ │ │ │ │ +00048c80: 0a20 2020 2020 6f66 2061 6464 6564 206d . of added m │ │ │ │ │ +00048c90: 6174 6572 6961 6c2e 2020 4966 2079 6f75 aterial. If you │ │ │ │ │ +00048ca0: 2075 7365 2074 6865 206c 6174 7465 7220 use the latter │ │ │ │ │ +00048cb0: 6f70 7469 6f6e 2c20 796f 7520 6d75 7374 option, you must │ │ │ │ │ +00048cc0: 2074 616b 650a 2020 2020 2072 6561 736f take. reaso │ │ │ │ │ +00048cd0: 6e61 626c 7920 7072 7564 656e 7420 7374 nably prudent st │ │ │ │ │ +00048ce0: 6570 732c 2077 6865 6e20 796f 7520 6265 eps, when you be │ │ │ │ │ +00048cf0: 6769 6e20 6469 7374 7269 6275 7469 6f6e gin distribution │ │ │ │ │ +00048d00: 206f 6620 4f70 6171 7565 0a20 2020 2020 of Opaque. │ │ │ │ │ +00048d10: 636f 7069 6573 2069 6e20 7175 616e 7469 copies in quanti │ │ │ │ │ +00048d20: 7479 2c20 746f 2065 6e73 7572 6520 7468 ty, to ensure th │ │ │ │ │ +00048d30: 6174 2074 6869 7320 5472 616e 7370 6172 at this Transpar │ │ │ │ │ +00048d40: 656e 7420 636f 7079 2077 696c 6c0a 2020 ent copy will. │ │ │ │ │ +00048d50: 2020 2072 656d 6169 6e20 7468 7573 2061 remain thus a │ │ │ │ │ +00048d60: 6363 6573 7369 626c 6520 6174 2074 6865 ccessible at the │ │ │ │ │ +00048d70: 2073 7461 7465 6420 6c6f 6361 7469 6f6e stated location │ │ │ │ │ +00048d80: 2075 6e74 696c 2061 7420 6c65 6173 7420 until at least │ │ │ │ │ +00048d90: 6f6e 650a 2020 2020 2079 6561 7220 6166 one. year af │ │ │ │ │ +00048da0: 7465 7220 7468 6520 6c61 7374 2074 696d ter the last tim │ │ │ │ │ +00048db0: 6520 796f 7520 6469 7374 7269 6275 7465 e you distribute │ │ │ │ │ +00048dc0: 2061 6e20 4f70 6171 7565 2063 6f70 7920 an Opaque copy │ │ │ │ │ +00048dd0: 2864 6972 6563 746c 7920 6f72 0a20 2020 (directly or. │ │ │ │ │ +00048de0: 2020 7468 726f 7567 6820 796f 7572 2061 through your a │ │ │ │ │ +00048df0: 6765 6e74 7320 6f72 2072 6574 6169 6c65 gents or retaile │ │ │ │ │ +00048e00: 7273 2920 6f66 2074 6861 7420 6564 6974 rs) of that edit │ │ │ │ │ +00048e10: 696f 6e20 746f 2074 6865 2070 7562 6c69 ion to the publi │ │ │ │ │ +00048e20: 632e 0a0a 2020 2020 2049 7420 6973 2072 c... It is r │ │ │ │ │ +00048e30: 6571 7565 7374 6564 2c20 6275 7420 6e6f equested, but no │ │ │ │ │ +00048e40: 7420 7265 7175 6972 6564 2c20 7468 6174 t required, that │ │ │ │ │ +00048e50: 2079 6f75 2063 6f6e 7461 6374 2074 6865 you contact the │ │ │ │ │ +00048e60: 2061 7574 686f 7273 206f 660a 2020 2020 authors of. │ │ │ │ │ +00048e70: 2074 6865 2044 6f63 756d 656e 7420 7765 the Document we │ │ │ │ │ +00048e80: 6c6c 2062 6566 6f72 6520 7265 6469 7374 ll before redist │ │ │ │ │ +00048e90: 7269 6275 7469 6e67 2061 6e79 206c 6172 ributing any lar │ │ │ │ │ +00048ea0: 6765 206e 756d 6265 7220 6f66 2063 6f70 ge number of cop │ │ │ │ │ +00048eb0: 6965 732c 0a20 2020 2020 746f 2067 6976 ies,. to giv │ │ │ │ │ +00048ec0: 6520 7468 656d 2061 2063 6861 6e63 6520 e them a chance │ │ │ │ │ +00048ed0: 746f 2070 726f 7669 6465 2079 6f75 2077 to provide you w │ │ │ │ │ +00048ee0: 6974 6820 616e 2075 7064 6174 6564 2076 ith an updated v │ │ │ │ │ +00048ef0: 6572 7369 6f6e 206f 6620 7468 650a 2020 ersion of the. │ │ │ │ │ +00048f00: 2020 2044 6f63 756d 656e 742e 0a0a 2020 Document... │ │ │ │ │ +00048f10: 342e 204d 4f44 4946 4943 4154 494f 4e53 4. MODIFICATIONS │ │ │ │ │ +00048f20: 0a0a 2020 2020 2059 6f75 206d 6179 2063 .. You may c │ │ │ │ │ +00048f30: 6f70 7920 616e 6420 6469 7374 7269 6275 opy and distribu │ │ │ │ │ +00048f40: 7465 2061 204d 6f64 6966 6965 6420 5665 te a Modified Ve │ │ │ │ │ +00048f50: 7273 696f 6e20 6f66 2074 6865 2044 6f63 rsion of the Doc │ │ │ │ │ +00048f60: 756d 656e 740a 2020 2020 2075 6e64 6572 ument. under │ │ │ │ │ +00048f70: 2074 6865 2063 6f6e 6469 7469 6f6e 7320 the conditions │ │ │ │ │ +00048f80: 6f66 2073 6563 7469 6f6e 7320 3220 616e of sections 2 an │ │ │ │ │ +00048f90: 6420 3320 6162 6f76 652c 2070 726f 7669 d 3 above, provi │ │ │ │ │ +00048fa0: 6465 6420 7468 6174 2079 6f75 0a20 2020 ded that you. │ │ │ │ │ +00048fb0: 2020 7265 6c65 6173 6520 7468 6520 4d6f release the Mo │ │ │ │ │ +00048fc0: 6469 6669 6564 2056 6572 7369 6f6e 2075 dified Version u │ │ │ │ │ +00048fd0: 6e64 6572 2070 7265 6369 7365 6c79 2074 nder precisely t │ │ │ │ │ +00048fe0: 6869 7320 4c69 6365 6e73 652c 2077 6974 his License, wit │ │ │ │ │ +00048ff0: 6820 7468 650a 2020 2020 204d 6f64 6966 h the. Modif │ │ │ │ │ +00049000: 6965 6420 5665 7273 696f 6e20 6669 6c6c ied Version fill │ │ │ │ │ +00049010: 696e 6720 7468 6520 726f 6c65 206f 6620 ing the role of │ │ │ │ │ +00049020: 7468 6520 446f 6375 6d65 6e74 2c20 7468 the Document, th │ │ │ │ │ +00049030: 7573 206c 6963 656e 7369 6e67 0a20 2020 us licensing. │ │ │ │ │ +00049040: 2020 6469 7374 7269 6275 7469 6f6e 2061 distribution a │ │ │ │ │ +00049050: 6e64 206d 6f64 6966 6963 6174 696f 6e20 nd modification │ │ │ │ │ +00049060: 6f66 2074 6865 204d 6f64 6966 6965 6420 of the Modified │ │ │ │ │ +00049070: 5665 7273 696f 6e20 746f 2077 686f 6576 Version to whoev │ │ │ │ │ +00049080: 6572 0a20 2020 2020 706f 7373 6573 7365 er. possesse │ │ │ │ │ +00049090: 7320 6120 636f 7079 206f 6620 6974 2e20 s a copy of it. │ │ │ │ │ +000490a0: 2049 6e20 6164 6469 7469 6f6e 2c20 796f In addition, yo │ │ │ │ │ +000490b0: 7520 6d75 7374 2064 6f20 7468 6573 6520 u must do these │ │ │ │ │ +000490c0: 7468 696e 6773 2069 6e0a 2020 2020 2074 things in. t │ │ │ │ │ +000490d0: 6865 204d 6f64 6966 6965 6420 5665 7273 he Modified Vers │ │ │ │ │ +000490e0: 696f 6e3a 0a0a 2020 2020 2020 2041 2e20 ion:.. A. │ │ │ │ │ +000490f0: 5573 6520 696e 2074 6865 2054 6974 6c65 Use in the Title │ │ │ │ │ +00049100: 2050 6167 6520 2861 6e64 206f 6e20 7468 Page (and on th │ │ │ │ │ +00049110: 6520 636f 7665 7273 2c20 6966 2061 6e79 e covers, if any │ │ │ │ │ +00049120: 2920 6120 7469 746c 650a 2020 2020 2020 ) a title. │ │ │ │ │ +00049130: 2020 2020 6469 7374 696e 6374 2066 726f distinct fro │ │ │ │ │ +00049140: 6d20 7468 6174 206f 6620 7468 6520 446f m that of the Do │ │ │ │ │ +00049150: 6375 6d65 6e74 2c20 616e 6420 6672 6f6d cument, and from │ │ │ │ │ +00049160: 2074 686f 7365 206f 6620 7072 6576 696f those of previo │ │ │ │ │ +00049170: 7573 0a20 2020 2020 2020 2020 2076 6572 us. ver │ │ │ │ │ +00049180: 7369 6f6e 7320 2877 6869 6368 2073 686f sions (which sho │ │ │ │ │ +00049190: 756c 642c 2069 6620 7468 6572 6520 7765 uld, if there we │ │ │ │ │ +000491a0: 7265 2061 6e79 2c20 6265 206c 6973 7465 re any, be liste │ │ │ │ │ +000491b0: 6420 696e 2074 6865 0a20 2020 2020 2020 d in the. │ │ │ │ │ +000491c0: 2020 2048 6973 746f 7279 2073 6563 7469 History secti │ │ │ │ │ +000491d0: 6f6e 206f 6620 7468 6520 446f 6375 6d65 on of the Docume │ │ │ │ │ +000491e0: 6e74 292e 2020 596f 7520 6d61 7920 7573 nt). You may us │ │ │ │ │ +000491f0: 6520 7468 6520 7361 6d65 2074 6974 6c65 e the same title │ │ │ │ │ +00049200: 0a20 2020 2020 2020 2020 2061 7320 6120 . as a │ │ │ │ │ +00049210: 7072 6576 696f 7573 2076 6572 7369 6f6e previous version │ │ │ │ │ +00049220: 2069 6620 7468 6520 6f72 6967 696e 616c if the original │ │ │ │ │ +00049230: 2070 7562 6c69 7368 6572 206f 6620 7468 publisher of th │ │ │ │ │ +00049240: 6174 0a20 2020 2020 2020 2020 2076 6572 at. ver │ │ │ │ │ +00049250: 7369 6f6e 2067 6976 6573 2070 6572 6d69 sion gives permi │ │ │ │ │ +00049260: 7373 696f 6e2e 0a0a 2020 2020 2020 2042 ssion... B │ │ │ │ │ +00049270: 2e20 4c69 7374 206f 6e20 7468 6520 5469 . List on the Ti │ │ │ │ │ +00049280: 746c 6520 5061 6765 2c20 6173 2061 7574 tle Page, as aut │ │ │ │ │ +00049290: 686f 7273 2c20 6f6e 6520 6f72 206d 6f72 hors, one or mor │ │ │ │ │ +000492a0: 6520 7065 7273 6f6e 7320 6f72 0a20 2020 e persons or. │ │ │ │ │ +000492b0: 2020 2020 2020 2065 6e74 6974 6965 7320 entities │ │ │ │ │ +000492c0: 7265 7370 6f6e 7369 626c 6520 666f 7220 responsible for │ │ │ │ │ +000492d0: 6175 7468 6f72 7368 6970 206f 6620 7468 authorship of th │ │ │ │ │ +000492e0: 6520 6d6f 6469 6669 6361 7469 6f6e 7320 e modifications │ │ │ │ │ +000492f0: 696e 0a20 2020 2020 2020 2020 2074 6865 in. the │ │ │ │ │ +00049300: 204d 6f64 6966 6965 6420 5665 7273 696f Modified Versio │ │ │ │ │ +00049310: 6e2c 2074 6f67 6574 6865 7220 7769 7468 n, together with │ │ │ │ │ +00049320: 2061 7420 6c65 6173 7420 6669 7665 206f at least five o │ │ │ │ │ +00049330: 6620 7468 650a 2020 2020 2020 2020 2020 f the. │ │ │ │ │ +00049340: 7072 696e 6369 7061 6c20 6175 7468 6f72 principal author │ │ │ │ │ +00049350: 7320 6f66 2074 6865 2044 6f63 756d 656e s of the Documen │ │ │ │ │ +00049360: 7420 2861 6c6c 206f 6620 6974 7320 7072 t (all of its pr │ │ │ │ │ +00049370: 696e 6369 7061 6c0a 2020 2020 2020 2020 incipal. │ │ │ │ │ +00049380: 2020 6175 7468 6f72 732c 2069 6620 6974 authors, if it │ │ │ │ │ +00049390: 2068 6173 2066 6577 6572 2074 6861 6e20 has fewer than │ │ │ │ │ +000493a0: 6669 7665 292c 2075 6e6c 6573 7320 7468 five), unless th │ │ │ │ │ +000493b0: 6579 2072 656c 6561 7365 2079 6f75 0a20 ey release you. │ │ │ │ │ +000493c0: 2020 2020 2020 2020 2066 726f 6d20 7468 from th │ │ │ │ │ +000493d0: 6973 2072 6571 7569 7265 6d65 6e74 2e0a is requirement.. │ │ │ │ │ +000493e0: 0a20 2020 2020 2020 432e 2053 7461 7465 . C. State │ │ │ │ │ +000493f0: 206f 6e20 7468 6520 5469 746c 6520 7061 on the Title pa │ │ │ │ │ +00049400: 6765 2074 6865 206e 616d 6520 6f66 2074 ge the name of t │ │ │ │ │ +00049410: 6865 2070 7562 6c69 7368 6572 206f 6620 he publisher of │ │ │ │ │ +00049420: 7468 650a 2020 2020 2020 2020 2020 4d6f the. Mo │ │ │ │ │ +00049430: 6469 6669 6564 2056 6572 7369 6f6e 2c20 dified Version, │ │ │ │ │ +00049440: 6173 2074 6865 2070 7562 6c69 7368 6572 as the publisher │ │ │ │ │ +00049450: 2e0a 0a20 2020 2020 2020 442e 2050 7265 ... D. Pre │ │ │ │ │ +00049460: 7365 7276 6520 616c 6c20 7468 6520 636f serve all the co │ │ │ │ │ +00049470: 7079 7269 6768 7420 6e6f 7469 6365 7320 pyright notices │ │ │ │ │ +00049480: 6f66 2074 6865 2044 6f63 756d 656e 742e of the Document. │ │ │ │ │ +00049490: 0a0a 2020 2020 2020 2045 2e20 4164 6420 .. E. Add │ │ │ │ │ +000494a0: 616e 2061 7070 726f 7072 6961 7465 2063 an appropriate c │ │ │ │ │ +000494b0: 6f70 7972 6967 6874 206e 6f74 6963 6520 opyright notice │ │ │ │ │ +000494c0: 666f 7220 796f 7572 206d 6f64 6966 6963 for your modific │ │ │ │ │ +000494d0: 6174 696f 6e73 0a20 2020 2020 2020 2020 ations. │ │ │ │ │ +000494e0: 2061 646a 6163 656e 7420 746f 2074 6865 adjacent to the │ │ │ │ │ +000494f0: 206f 7468 6572 2063 6f70 7972 6967 6874 other copyright │ │ │ │ │ +00049500: 206e 6f74 6963 6573 2e0a 0a20 2020 2020 notices... │ │ │ │ │ +00049510: 2020 462e 2049 6e63 6c75 6465 2c20 696d F. Include, im │ │ │ │ │ +00049520: 6d65 6469 6174 656c 7920 6166 7465 7220 mediately after │ │ │ │ │ +00049530: 7468 6520 636f 7079 7269 6768 7420 6e6f the copyright no │ │ │ │ │ +00049540: 7469 6365 732c 2061 206c 6963 656e 7365 tices, a license │ │ │ │ │ +00049550: 0a20 2020 2020 2020 2020 206e 6f74 6963 . notic │ │ │ │ │ +00049560: 6520 6769 7669 6e67 2074 6865 2070 7562 e giving the pub │ │ │ │ │ +00049570: 6c69 6320 7065 726d 6973 7369 6f6e 2074 lic permission t │ │ │ │ │ +00049580: 6f20 7573 6520 7468 6520 4d6f 6469 6669 o use the Modifi │ │ │ │ │ +00049590: 6564 0a20 2020 2020 2020 2020 2056 6572 ed. Ver │ │ │ │ │ +000495a0: 7369 6f6e 2075 6e64 6572 2074 6865 2074 sion under the t │ │ │ │ │ +000495b0: 6572 6d73 206f 6620 7468 6973 204c 6963 erms of this Lic │ │ │ │ │ +000495c0: 656e 7365 2c20 696e 2074 6865 2066 6f72 ense, in the for │ │ │ │ │ +000495d0: 6d20 7368 6f77 6e20 696e 0a20 2020 2020 m shown in. │ │ │ │ │ +000495e0: 2020 2020 2074 6865 2041 6464 656e 6475 the Addendu │ │ │ │ │ +000495f0: 6d20 6265 6c6f 772e 0a0a 2020 2020 2020 m below... │ │ │ │ │ +00049600: 2047 2e20 5072 6573 6572 7665 2069 6e20 G. Preserve in │ │ │ │ │ +00049610: 7468 6174 206c 6963 656e 7365 206e 6f74 that license not │ │ │ │ │ +00049620: 6963 6520 7468 6520 6675 6c6c 206c 6973 ice the full lis │ │ │ │ │ +00049630: 7473 206f 6620 496e 7661 7269 616e 740a ts of Invariant. │ │ │ │ │ +00049640: 2020 2020 2020 2020 2020 5365 6374 696f Sectio │ │ │ │ │ +00049650: 6e73 2061 6e64 2072 6571 7569 7265 6420 ns and required │ │ │ │ │ +00049660: 436f 7665 7220 5465 7874 7320 6769 7665 Cover Texts give │ │ │ │ │ +00049670: 6e20 696e 2074 6865 2044 6f63 756d 656e n in the Documen │ │ │ │ │ +00049680: 7427 730a 2020 2020 2020 2020 2020 6c69 t's. li │ │ │ │ │ +00049690: 6365 6e73 6520 6e6f 7469 6365 2e0a 0a20 cense notice... │ │ │ │ │ +000496a0: 2020 2020 2020 482e 2049 6e63 6c75 6465 H. Include │ │ │ │ │ +000496b0: 2061 6e20 756e 616c 7465 7265 6420 636f an unaltered co │ │ │ │ │ +000496c0: 7079 206f 6620 7468 6973 204c 6963 656e py of this Licen │ │ │ │ │ +000496d0: 7365 2e0a 0a20 2020 2020 2020 492e 2050 se... I. P │ │ │ │ │ +000496e0: 7265 7365 7276 6520 7468 6520 7365 6374 reserve the sect │ │ │ │ │ +000496f0: 696f 6e20 456e 7469 746c 6564 2022 4869 ion Entitled "Hi │ │ │ │ │ +00049700: 7374 6f72 7922 2c20 5072 6573 6572 7665 story", Preserve │ │ │ │ │ +00049710: 2069 7473 2054 6974 6c65 2c0a 2020 2020 its Title,. │ │ │ │ │ +00049720: 2020 2020 2020 616e 6420 6164 6420 746f and add to │ │ │ │ │ +00049730: 2069 7420 616e 2069 7465 6d20 7374 6174 it an item stat │ │ │ │ │ +00049740: 696e 6720 6174 206c 6561 7374 2074 6865 ing at least the │ │ │ │ │ +00049750: 2074 6974 6c65 2c20 7965 6172 2c20 6e65 title, year, ne │ │ │ │ │ +00049760: 770a 2020 2020 2020 2020 2020 6175 7468 w. auth │ │ │ │ │ +00049770: 6f72 732c 2061 6e64 2070 7562 6c69 7368 ors, and publish │ │ │ │ │ +00049780: 6572 206f 6620 7468 6520 4d6f 6469 6669 er of the Modifi │ │ │ │ │ +00049790: 6564 2056 6572 7369 6f6e 2061 7320 6769 ed Version as gi │ │ │ │ │ +000497a0: 7665 6e20 6f6e 2074 6865 0a20 2020 2020 ven on the. │ │ │ │ │ +000497b0: 2020 2020 2054 6974 6c65 2050 6167 652e Title Page. │ │ │ │ │ +000497c0: 2020 4966 2074 6865 7265 2069 7320 6e6f If there is no │ │ │ │ │ +000497d0: 2073 6563 7469 6f6e 2045 6e74 6974 6c65 section Entitle │ │ │ │ │ +000497e0: 6420 2248 6973 746f 7279 2220 696e 2074 d "History" in t │ │ │ │ │ +000497f0: 6865 0a20 2020 2020 2020 2020 2044 6f63 he. Doc │ │ │ │ │ +00049800: 756d 656e 742c 2063 7265 6174 6520 6f6e ument, create on │ │ │ │ │ +00049810: 6520 7374 6174 696e 6720 7468 6520 7469 e stating the ti │ │ │ │ │ +00049820: 746c 652c 2079 6561 722c 2061 7574 686f tle, year, autho │ │ │ │ │ +00049830: 7273 2c20 616e 640a 2020 2020 2020 2020 rs, and. │ │ │ │ │ +00049840: 2020 7075 626c 6973 6865 7220 6f66 2074 publisher of t │ │ │ │ │ +00049850: 6865 2044 6f63 756d 656e 7420 6173 2067 he Document as g │ │ │ │ │ +00049860: 6976 656e 206f 6e20 6974 7320 5469 746c iven on its Titl │ │ │ │ │ +00049870: 6520 5061 6765 2c20 7468 656e 2061 6464 e Page, then add │ │ │ │ │ +00049880: 0a20 2020 2020 2020 2020 2061 6e20 6974 . an it │ │ │ │ │ +00049890: 656d 2064 6573 6372 6962 696e 6720 7468 em describing th │ │ │ │ │ +000498a0: 6520 4d6f 6469 6669 6564 2056 6572 7369 e Modified Versi │ │ │ │ │ +000498b0: 6f6e 2061 7320 7374 6174 6564 2069 6e20 on as stated in │ │ │ │ │ +000498c0: 7468 650a 2020 2020 2020 2020 2020 7072 the. pr │ │ │ │ │ +000498d0: 6576 696f 7573 2073 656e 7465 6e63 652e evious sentence. │ │ │ │ │ +000498e0: 0a0a 2020 2020 2020 204a 2e20 5072 6573 .. J. Pres │ │ │ │ │ +000498f0: 6572 7665 2074 6865 206e 6574 776f 726b erve the network │ │ │ │ │ +00049900: 206c 6f63 6174 696f 6e2c 2069 6620 616e location, if an │ │ │ │ │ +00049910: 792c 2067 6976 656e 2069 6e20 7468 6520 y, given in the │ │ │ │ │ +00049920: 446f 6375 6d65 6e74 0a20 2020 2020 2020 Document. │ │ │ │ │ +00049930: 2020 2066 6f72 2070 7562 6c69 6320 6163 for public ac │ │ │ │ │ +00049940: 6365 7373 2074 6f20 6120 5472 616e 7370 cess to a Transp │ │ │ │ │ +00049950: 6172 656e 7420 636f 7079 206f 6620 7468 arent copy of th │ │ │ │ │ +00049960: 6520 446f 6375 6d65 6e74 2c20 616e 640a e Document, and. │ │ │ │ │ +00049970: 2020 2020 2020 2020 2020 6c69 6b65 7769 likewi │ │ │ │ │ +00049980: 7365 2074 6865 206e 6574 776f 726b 206c se the network l │ │ │ │ │ +00049990: 6f63 6174 696f 6e73 2067 6976 656e 2069 ocations given i │ │ │ │ │ +000499a0: 6e20 7468 6520 446f 6375 6d65 6e74 2066 n the Document f │ │ │ │ │ +000499b0: 6f72 0a20 2020 2020 2020 2020 2070 7265 or. pre │ │ │ │ │ +000499c0: 7669 6f75 7320 7665 7273 696f 6e73 2069 vious versions i │ │ │ │ │ +000499d0: 7420 7761 7320 6261 7365 6420 6f6e 2e20 t was based on. │ │ │ │ │ +000499e0: 2054 6865 7365 206d 6179 2062 6520 706c These may be pl │ │ │ │ │ +000499f0: 6163 6564 2069 6e20 7468 650a 2020 2020 aced in the. │ │ │ │ │ +00049a00: 2020 2020 2020 2248 6973 746f 7279 2220 "History" │ │ │ │ │ +00049a10: 7365 6374 696f 6e2e 2020 596f 7520 6d61 section. You ma │ │ │ │ │ +00049a20: 7920 6f6d 6974 2061 206e 6574 776f 726b y omit a network │ │ │ │ │ +00049a30: 206c 6f63 6174 696f 6e20 666f 7220 6120 location for a │ │ │ │ │ +00049a40: 776f 726b 0a20 2020 2020 2020 2020 2074 work. t │ │ │ │ │ +00049a50: 6861 7420 7761 7320 7075 626c 6973 6865 hat was publishe │ │ │ │ │ +00049a60: 6420 6174 206c 6561 7374 2066 6f75 7220 d at least four │ │ │ │ │ +00049a70: 7965 6172 7320 6265 666f 7265 2074 6865 years before the │ │ │ │ │ +00049a80: 2044 6f63 756d 656e 740a 2020 2020 2020 Document. │ │ │ │ │ +00049a90: 2020 2020 6974 7365 6c66 2c20 6f72 2069 itself, or i │ │ │ │ │ +00049aa0: 6620 7468 6520 6f72 6967 696e 616c 2070 f the original p │ │ │ │ │ +00049ab0: 7562 6c69 7368 6572 206f 6620 7468 6520 ublisher of the │ │ │ │ │ +00049ac0: 7665 7273 696f 6e20 6974 2072 6566 6572 version it refer │ │ │ │ │ +00049ad0: 730a 2020 2020 2020 2020 2020 746f 2067 s. to g │ │ │ │ │ +00049ae0: 6976 6573 2070 6572 6d69 7373 696f 6e2e ives permission. │ │ │ │ │ +00049af0: 0a0a 2020 2020 2020 204b 2e20 466f 7220 .. K. For │ │ │ │ │ +00049b00: 616e 7920 7365 6374 696f 6e20 456e 7469 any section Enti │ │ │ │ │ +00049b10: 746c 6564 2022 4163 6b6e 6f77 6c65 6467 tled "Acknowledg │ │ │ │ │ +00049b20: 656d 656e 7473 2220 6f72 2022 4465 6469 ements" or "Dedi │ │ │ │ │ +00049b30: 6361 7469 6f6e 7322 2c0a 2020 2020 2020 cations",. │ │ │ │ │ +00049b40: 2020 2020 5072 6573 6572 7665 2074 6865 Preserve the │ │ │ │ │ +00049b50: 2054 6974 6c65 206f 6620 7468 6520 7365 Title of the se │ │ │ │ │ +00049b60: 6374 696f 6e2c 2061 6e64 2070 7265 7365 ction, and prese │ │ │ │ │ +00049b70: 7276 6520 696e 2074 6865 2073 6563 7469 rve in the secti │ │ │ │ │ +00049b80: 6f6e 0a20 2020 2020 2020 2020 2061 6c6c on. all │ │ │ │ │ +00049b90: 2074 6865 2073 7562 7374 616e 6365 2061 the substance a │ │ │ │ │ +00049ba0: 6e64 2074 6f6e 6520 6f66 2065 6163 6820 nd tone of each │ │ │ │ │ +00049bb0: 6f66 2074 6865 2063 6f6e 7472 6962 7574 of the contribut │ │ │ │ │ +00049bc0: 6f72 0a20 2020 2020 2020 2020 2061 636b or. ack │ │ │ │ │ +00049bd0: 6e6f 776c 6564 6765 6d65 6e74 7320 616e nowledgements an │ │ │ │ │ +00049be0: 642f 6f72 2064 6564 6963 6174 696f 6e73 d/or dedications │ │ │ │ │ +00049bf0: 2067 6976 656e 2074 6865 7265 696e 2e0a given therein.. │ │ │ │ │ +00049c00: 0a20 2020 2020 2020 4c2e 2050 7265 7365 . L. Prese │ │ │ │ │ +00049c10: 7276 6520 616c 6c20 7468 6520 496e 7661 rve all the Inva │ │ │ │ │ +00049c20: 7269 616e 7420 5365 6374 696f 6e73 206f riant Sections o │ │ │ │ │ +00049c30: 6620 7468 6520 446f 6375 6d65 6e74 2c20 f the Document, │ │ │ │ │ +00049c40: 756e 616c 7465 7265 640a 2020 2020 2020 unaltered. │ │ │ │ │ +00049c50: 2020 2020 696e 2074 6865 6972 2074 6578 in their tex │ │ │ │ │ +00049c60: 7420 616e 6420 696e 2074 6865 6972 2074 t and in their t │ │ │ │ │ +00049c70: 6974 6c65 732e 2020 5365 6374 696f 6e20 itles. Section │ │ │ │ │ +00049c80: 6e75 6d62 6572 7320 6f72 2074 6865 0a20 numbers or the. │ │ │ │ │ +00049c90: 2020 2020 2020 2020 2065 7175 6976 616c equival │ │ │ │ │ +00049ca0: 656e 7420 6172 6520 6e6f 7420 636f 6e73 ent are not cons │ │ │ │ │ +00049cb0: 6964 6572 6564 2070 6172 7420 6f66 2074 idered part of t │ │ │ │ │ +00049cc0: 6865 2073 6563 7469 6f6e 2074 6974 6c65 he section title │ │ │ │ │ +00049cd0: 732e 0a0a 2020 2020 2020 204d 2e20 4465 s... M. De │ │ │ │ │ +00049ce0: 6c65 7465 2061 6e79 2073 6563 7469 6f6e lete any section │ │ │ │ │ +00049cf0: 2045 6e74 6974 6c65 6420 2245 6e64 6f72 Entitled "Endor │ │ │ │ │ +00049d00: 7365 6d65 6e74 7322 2e20 2053 7563 6820 sements". Such │ │ │ │ │ +00049d10: 6120 7365 6374 696f 6e0a 2020 2020 2020 a section. │ │ │ │ │ +00049d20: 2020 2020 6d61 7920 6e6f 7420 6265 2069 may not be i │ │ │ │ │ +00049d30: 6e63 6c75 6465 6420 696e 2074 6865 204d ncluded in the M │ │ │ │ │ +00049d40: 6f64 6966 6965 6420 5665 7273 696f 6e2e odified Version. │ │ │ │ │ +00049d50: 0a0a 2020 2020 2020 204e 2e20 446f 206e .. N. Do n │ │ │ │ │ +00049d60: 6f74 2072 6574 6974 6c65 2061 6e79 2065 ot retitle any e │ │ │ │ │ +00049d70: 7869 7374 696e 6720 7365 6374 696f 6e20 xisting section │ │ │ │ │ +00049d80: 746f 2062 6520 456e 7469 746c 6564 0a20 to be Entitled. │ │ │ │ │ +00049d90: 2020 2020 2020 2020 2022 456e 646f 7273 "Endors │ │ │ │ │ +00049da0: 656d 656e 7473 2220 6f72 2074 6f20 636f ements" or to co │ │ │ │ │ +00049db0: 6e66 6c69 6374 2069 6e20 7469 746c 6520 nflict in title │ │ │ │ │ +00049dc0: 7769 7468 2061 6e79 2049 6e76 6172 6961 with any Invaria │ │ │ │ │ +00049dd0: 6e74 0a20 2020 2020 2020 2020 2053 6563 nt. Sec │ │ │ │ │ +00049de0: 7469 6f6e 2e0a 0a20 2020 2020 2020 4f2e tion... O. │ │ │ │ │ +00049df0: 2050 7265 7365 7276 6520 616e 7920 5761 Preserve any Wa │ │ │ │ │ +00049e00: 7272 616e 7479 2044 6973 636c 6169 6d65 rranty Disclaime │ │ │ │ │ +00049e10: 7273 2e0a 0a20 2020 2020 4966 2074 6865 rs... If the │ │ │ │ │ +00049e20: 204d 6f64 6966 6965 6420 5665 7273 696f Modified Versio │ │ │ │ │ +00049e30: 6e20 696e 636c 7564 6573 206e 6577 2066 n includes new f │ │ │ │ │ +00049e40: 726f 6e74 2d6d 6174 7465 7220 7365 6374 ront-matter sect │ │ │ │ │ +00049e50: 696f 6e73 206f 720a 2020 2020 2061 7070 ions or. app │ │ │ │ │ +00049e60: 656e 6469 6365 7320 7468 6174 2071 7561 endices that qua │ │ │ │ │ +00049e70: 6c69 6679 2061 7320 5365 636f 6e64 6172 lify as Secondar │ │ │ │ │ +00049e80: 7920 5365 6374 696f 6e73 2061 6e64 2063 y Sections and c │ │ │ │ │ +00049e90: 6f6e 7461 696e 206e 6f0a 2020 2020 206d ontain no. m │ │ │ │ │ +00049ea0: 6174 6572 6961 6c20 636f 7069 6564 2066 aterial copied f │ │ │ │ │ +00049eb0: 726f 6d20 7468 6520 446f 6375 6d65 6e74 rom the Document │ │ │ │ │ +00049ec0: 2c20 796f 7520 6d61 7920 6174 2079 6f75 , you may at you │ │ │ │ │ +00049ed0: 7220 6f70 7469 6f6e 2064 6573 6967 6e61 r option designa │ │ │ │ │ +00049ee0: 7465 0a20 2020 2020 736f 6d65 206f 7220 te. some or │ │ │ │ │ +00049ef0: 616c 6c20 6f66 2074 6865 7365 2073 6563 all of these sec │ │ │ │ │ +00049f00: 7469 6f6e 7320 6173 2069 6e76 6172 6961 tions as invaria │ │ │ │ │ +00049f10: 6e74 2e20 2054 6f20 646f 2074 6869 732c nt. To do this, │ │ │ │ │ +00049f20: 2061 6464 2074 6865 6972 0a20 2020 2020 add their. │ │ │ │ │ +00049f30: 7469 746c 6573 2074 6f20 7468 6520 6c69 titles to the li │ │ │ │ │ +00049f40: 7374 206f 6620 496e 7661 7269 616e 7420 st of Invariant │ │ │ │ │ +00049f50: 5365 6374 696f 6e73 2069 6e20 7468 6520 Sections in the │ │ │ │ │ +00049f60: 4d6f 6469 6669 6564 2056 6572 7369 6f6e Modified Version │ │ │ │ │ +00049f70: 2773 0a20 2020 2020 6c69 6365 6e73 6520 's. license │ │ │ │ │ +00049f80: 6e6f 7469 6365 2e20 2054 6865 7365 2074 notice. These t │ │ │ │ │ +00049f90: 6974 6c65 7320 6d75 7374 2062 6520 6469 itles must be di │ │ │ │ │ +00049fa0: 7374 696e 6374 2066 726f 6d20 616e 7920 stinct from any │ │ │ │ │ +00049fb0: 6f74 6865 720a 2020 2020 2073 6563 7469 other. secti │ │ │ │ │ +00049fc0: 6f6e 2074 6974 6c65 732e 0a0a 2020 2020 on titles... │ │ │ │ │ +00049fd0: 2059 6f75 206d 6179 2061 6464 2061 2073 You may add a s │ │ │ │ │ +00049fe0: 6563 7469 6f6e 2045 6e74 6974 6c65 6420 ection Entitled │ │ │ │ │ +00049ff0: 2245 6e64 6f72 7365 6d65 6e74 7322 2c20 "Endorsements", │ │ │ │ │ +0004a000: 7072 6f76 6964 6564 2069 7420 636f 6e74 provided it cont │ │ │ │ │ +0004a010: 6169 6e73 0a20 2020 2020 6e6f 7468 696e ains. nothin │ │ │ │ │ +0004a020: 6720 6275 7420 656e 646f 7273 656d 656e g but endorsemen │ │ │ │ │ +0004a030: 7473 206f 6620 796f 7572 204d 6f64 6966 ts of your Modif │ │ │ │ │ +0004a040: 6965 6420 5665 7273 696f 6e20 6279 2076 ied Version by v │ │ │ │ │ +0004a050: 6172 696f 7573 0a20 2020 2020 7061 7274 arious. part │ │ │ │ │ +0004a060: 6965 732d 2d66 6f72 2065 7861 6d70 6c65 ies--for example │ │ │ │ │ +0004a070: 2c20 7374 6174 656d 656e 7473 206f 6620 , statements of │ │ │ │ │ +0004a080: 7065 6572 2072 6576 6965 7720 6f72 2074 peer review or t │ │ │ │ │ +0004a090: 6861 7420 7468 6520 7465 7874 0a20 2020 hat the text. │ │ │ │ │ +0004a0a0: 2020 6861 7320 6265 656e 2061 7070 726f has been appro │ │ │ │ │ +0004a0b0: 7665 6420 6279 2061 6e20 6f72 6761 6e69 ved by an organi │ │ │ │ │ +0004a0c0: 7a61 7469 6f6e 2061 7320 7468 6520 6175 zation as the au │ │ │ │ │ +0004a0d0: 7468 6f72 6974 6174 6976 650a 2020 2020 thoritative. │ │ │ │ │ +0004a0e0: 2064 6566 696e 6974 696f 6e20 6f66 2061 definition of a │ │ │ │ │ +0004a0f0: 2073 7461 6e64 6172 642e 0a0a 2020 2020 standard... │ │ │ │ │ +0004a100: 2059 6f75 206d 6179 2061 6464 2061 2070 You may add a p │ │ │ │ │ +0004a110: 6173 7361 6765 206f 6620 7570 2074 6f20 assage of up to │ │ │ │ │ +0004a120: 6669 7665 2077 6f72 6473 2061 7320 6120 five words as a │ │ │ │ │ +0004a130: 4672 6f6e 742d 436f 7665 7220 5465 7874 Front-Cover Text │ │ │ │ │ +0004a140: 2c0a 2020 2020 2061 6e64 2061 2070 6173 ,. and a pas │ │ │ │ │ +0004a150: 7361 6765 206f 6620 7570 2074 6f20 3235 sage of up to 25 │ │ │ │ │ +0004a160: 2077 6f72 6473 2061 7320 6120 4261 636b words as a Back │ │ │ │ │ +0004a170: 2d43 6f76 6572 2054 6578 742c 2074 6f20 -Cover Text, to │ │ │ │ │ +0004a180: 7468 6520 656e 6420 6f66 0a20 2020 2020 the end of. │ │ │ │ │ +0004a190: 7468 6520 6c69 7374 206f 6620 436f 7665 the list of Cove │ │ │ │ │ +0004a1a0: 7220 5465 7874 7320 696e 2074 6865 204d r Texts in the M │ │ │ │ │ +0004a1b0: 6f64 6966 6965 6420 5665 7273 696f 6e2e odified Version. │ │ │ │ │ +0004a1c0: 2020 4f6e 6c79 206f 6e65 2070 6173 7361 Only one passa │ │ │ │ │ +0004a1d0: 6765 0a20 2020 2020 6f66 2046 726f 6e74 ge. of Front │ │ │ │ │ +0004a1e0: 2d43 6f76 6572 2054 6578 7420 616e 6420 -Cover Text and │ │ │ │ │ +0004a1f0: 6f6e 6520 6f66 2042 6163 6b2d 436f 7665 one of Back-Cove │ │ │ │ │ +0004a200: 7220 5465 7874 206d 6179 2062 6520 6164 r Text may be ad │ │ │ │ │ +0004a210: 6465 6420 6279 2028 6f72 0a20 2020 2020 ded by (or. │ │ │ │ │ +0004a220: 7468 726f 7567 6820 6172 7261 6e67 656d through arrangem │ │ │ │ │ +0004a230: 656e 7473 206d 6164 6520 6279 2920 616e ents made by) an │ │ │ │ │ +0004a240: 7920 6f6e 6520 656e 7469 7479 2e20 2049 y one entity. I │ │ │ │ │ +0004a250: 6620 7468 6520 446f 6375 6d65 6e74 0a20 f the Document. │ │ │ │ │ +0004a260: 2020 2020 616c 7265 6164 7920 696e 636c already incl │ │ │ │ │ +0004a270: 7564 6573 2061 2063 6f76 6572 2074 6578 udes a cover tex │ │ │ │ │ +0004a280: 7420 666f 7220 7468 6520 7361 6d65 2063 t for the same c │ │ │ │ │ +0004a290: 6f76 6572 2c20 7072 6576 696f 7573 6c79 over, previously │ │ │ │ │ +0004a2a0: 2061 6464 6564 0a20 2020 2020 6279 2079 added. by y │ │ │ │ │ +0004a2b0: 6f75 206f 7220 6279 2061 7272 616e 6765 ou or by arrange │ │ │ │ │ +0004a2c0: 6d65 6e74 206d 6164 6520 6279 2074 6865 ment made by the │ │ │ │ │ +0004a2d0: 2073 616d 6520 656e 7469 7479 2079 6f75 same entity you │ │ │ │ │ +0004a2e0: 2061 7265 2061 6374 696e 6720 6f6e 0a20 are acting on. │ │ │ │ │ +0004a2f0: 2020 2020 6265 6861 6c66 206f 662c 2079 behalf of, y │ │ │ │ │ +0004a300: 6f75 206d 6179 206e 6f74 2061 6464 2061 ou may not add a │ │ │ │ │ +0004a310: 6e6f 7468 6572 3b20 6275 7420 796f 7520 nother; but you │ │ │ │ │ +0004a320: 6d61 7920 7265 706c 6163 6520 7468 6520 may replace the │ │ │ │ │ +0004a330: 6f6c 640a 2020 2020 206f 6e65 2c20 6f6e old. one, on │ │ │ │ │ +0004a340: 2065 7870 6c69 6369 7420 7065 726d 6973 explicit permis │ │ │ │ │ +0004a350: 7369 6f6e 2066 726f 6d20 7468 6520 7072 sion from the pr │ │ │ │ │ +0004a360: 6576 696f 7573 2070 7562 6c69 7368 6572 evious publisher │ │ │ │ │ +0004a370: 2074 6861 7420 6164 6465 640a 2020 2020 that added. │ │ │ │ │ +0004a380: 2074 6865 206f 6c64 206f 6e65 2e0a 0a20 the old one... │ │ │ │ │ +0004a390: 2020 2020 5468 6520 6175 7468 6f72 2873 The author(s │ │ │ │ │ +0004a3a0: 2920 616e 6420 7075 626c 6973 6865 7228 ) and publisher( │ │ │ │ │ +0004a3b0: 7329 206f 6620 7468 6520 446f 6375 6d65 s) of the Docume │ │ │ │ │ +0004a3c0: 6e74 2064 6f20 6e6f 7420 6279 2074 6869 nt do not by thi │ │ │ │ │ +0004a3d0: 730a 2020 2020 204c 6963 656e 7365 2067 s. License g │ │ │ │ │ +0004a3e0: 6976 6520 7065 726d 6973 7369 6f6e 2074 ive permission t │ │ │ │ │ +0004a3f0: 6f20 7573 6520 7468 6569 7220 6e61 6d65 o use their name │ │ │ │ │ +0004a400: 7320 666f 7220 7075 626c 6963 6974 7920 s for publicity │ │ │ │ │ +0004a410: 666f 7220 6f72 2074 6f0a 2020 2020 2061 for or to. a │ │ │ │ │ +0004a420: 7373 6572 7420 6f72 2069 6d70 6c79 2065 ssert or imply e │ │ │ │ │ +0004a430: 6e64 6f72 7365 6d65 6e74 206f 6620 616e ndorsement of an │ │ │ │ │ +0004a440: 7920 4d6f 6469 6669 6564 2056 6572 7369 y Modified Versi │ │ │ │ │ +0004a450: 6f6e 2e0a 0a20 2035 2e20 434f 4d42 494e on... 5. COMBIN │ │ │ │ │ +0004a460: 494e 4720 444f 4355 4d45 4e54 530a 0a20 ING DOCUMENTS.. │ │ │ │ │ +0004a470: 2020 2020 596f 7520 6d61 7920 636f 6d62 You may comb │ │ │ │ │ +0004a480: 696e 6520 7468 6520 446f 6375 6d65 6e74 ine the Document │ │ │ │ │ +0004a490: 2077 6974 6820 6f74 6865 7220 646f 6375 with other docu │ │ │ │ │ +0004a4a0: 6d65 6e74 7320 7265 6c65 6173 6564 2075 ments released u │ │ │ │ │ +0004a4b0: 6e64 6572 0a20 2020 2020 7468 6973 204c nder. this L │ │ │ │ │ +0004a4c0: 6963 656e 7365 2c20 756e 6465 7220 7468 icense, under th │ │ │ │ │ +0004a4d0: 6520 7465 726d 7320 6465 6669 6e65 6420 e terms defined │ │ │ │ │ +0004a4e0: 696e 2073 6563 7469 6f6e 2034 2061 626f in section 4 abo │ │ │ │ │ +0004a4f0: 7665 2066 6f72 0a20 2020 2020 6d6f 6469 ve for. modi │ │ │ │ │ +0004a500: 6669 6564 2076 6572 7369 6f6e 732c 2070 fied versions, p │ │ │ │ │ +0004a510: 726f 7669 6465 6420 7468 6174 2079 6f75 rovided that you │ │ │ │ │ +0004a520: 2069 6e63 6c75 6465 2069 6e20 7468 6520 include in the │ │ │ │ │ +0004a530: 636f 6d62 696e 6174 696f 6e20 616c 6c0a combination all. │ │ │ │ │ +0004a540: 2020 2020 206f 6620 7468 6520 496e 7661 of the Inva │ │ │ │ │ +0004a550: 7269 616e 7420 5365 6374 696f 6e73 206f riant Sections o │ │ │ │ │ +0004a560: 6620 616c 6c20 6f66 2074 6865 206f 7269 f all of the ori │ │ │ │ │ +0004a570: 6769 6e61 6c20 646f 6375 6d65 6e74 732c ginal documents, │ │ │ │ │ +0004a580: 0a20 2020 2020 756e 6d6f 6469 6669 6564 . unmodified │ │ │ │ │ +0004a590: 2c20 616e 6420 6c69 7374 2074 6865 6d20 , and list them │ │ │ │ │ +0004a5a0: 616c 6c20 6173 2049 6e76 6172 6961 6e74 all as Invariant │ │ │ │ │ +0004a5b0: 2053 6563 7469 6f6e 7320 6f66 2079 6f75 Sections of you │ │ │ │ │ +0004a5c0: 720a 2020 2020 2063 6f6d 6269 6e65 6420 r. combined │ │ │ │ │ +0004a5d0: 776f 726b 2069 6e20 6974 7320 6c69 6365 work in its lice │ │ │ │ │ +0004a5e0: 6e73 6520 6e6f 7469 6365 2c20 616e 6420 nse notice, and │ │ │ │ │ +0004a5f0: 7468 6174 2079 6f75 2070 7265 7365 7276 that you preserv │ │ │ │ │ +0004a600: 6520 616c 6c0a 2020 2020 2074 6865 6972 e all. their │ │ │ │ │ +0004a610: 2057 6172 7261 6e74 7920 4469 7363 6c61 Warranty Discla │ │ │ │ │ +0004a620: 696d 6572 732e 0a0a 2020 2020 2054 6865 imers... The │ │ │ │ │ +0004a630: 2063 6f6d 6269 6e65 6420 776f 726b 206e combined work n │ │ │ │ │ +0004a640: 6565 6420 6f6e 6c79 2063 6f6e 7461 696e eed only contain │ │ │ │ │ +0004a650: 206f 6e65 2063 6f70 7920 6f66 2074 6869 one copy of thi │ │ │ │ │ +0004a660: 7320 4c69 6365 6e73 652c 2061 6e64 0a20 s License, and. │ │ │ │ │ +0004a670: 2020 2020 6d75 6c74 6970 6c65 2069 6465 multiple ide │ │ │ │ │ +0004a680: 6e74 6963 616c 2049 6e76 6172 6961 6e74 ntical Invariant │ │ │ │ │ +0004a690: 2053 6563 7469 6f6e 7320 6d61 7920 6265 Sections may be │ │ │ │ │ +0004a6a0: 2072 6570 6c61 6365 6420 7769 7468 2061 replaced with a │ │ │ │ │ +0004a6b0: 2073 696e 676c 650a 2020 2020 2063 6f70 single. cop │ │ │ │ │ +0004a6c0: 792e 2020 4966 2074 6865 7265 2061 7265 y. If there are │ │ │ │ │ +0004a6d0: 206d 756c 7469 706c 6520 496e 7661 7269 multiple Invari │ │ │ │ │ +0004a6e0: 616e 7420 5365 6374 696f 6e73 2077 6974 ant Sections wit │ │ │ │ │ +0004a6f0: 6820 7468 6520 7361 6d65 206e 616d 650a h the same name. │ │ │ │ │ +0004a700: 2020 2020 2062 7574 2064 6966 6665 7265 but differe │ │ │ │ │ +0004a710: 6e74 2063 6f6e 7465 6e74 732c 206d 616b nt contents, mak │ │ │ │ │ +0004a720: 6520 7468 6520 7469 746c 6520 6f66 2065 e the title of e │ │ │ │ │ +0004a730: 6163 6820 7375 6368 2073 6563 7469 6f6e ach such section │ │ │ │ │ +0004a740: 2075 6e69 7175 650a 2020 2020 2062 7920 unique. by │ │ │ │ │ +0004a750: 6164 6469 6e67 2061 7420 7468 6520 656e adding at the en │ │ │ │ │ +0004a760: 6420 6f66 2069 742c 2069 6e20 7061 7265 d of it, in pare │ │ │ │ │ +0004a770: 6e74 6865 7365 732c 2074 6865 206e 616d ntheses, the nam │ │ │ │ │ +0004a780: 6520 6f66 2074 6865 0a20 2020 2020 6f72 e of the. or │ │ │ │ │ +0004a790: 6967 696e 616c 2061 7574 686f 7220 6f72 iginal author or │ │ │ │ │ +0004a7a0: 2070 7562 6c69 7368 6572 206f 6620 7468 publisher of th │ │ │ │ │ +0004a7b0: 6174 2073 6563 7469 6f6e 2069 6620 6b6e at section if kn │ │ │ │ │ +0004a7c0: 6f77 6e2c 206f 7220 656c 7365 2061 0a20 own, or else a. │ │ │ │ │ +0004a7d0: 2020 2020 756e 6971 7565 206e 756d 6265 unique numbe │ │ │ │ │ +0004a7e0: 722e 2020 4d61 6b65 2074 6865 2073 616d r. Make the sam │ │ │ │ │ +0004a7f0: 6520 6164 6a75 7374 6d65 6e74 2074 6f20 e adjustment to │ │ │ │ │ +0004a800: 7468 6520 7365 6374 696f 6e20 7469 746c the section titl │ │ │ │ │ +0004a810: 6573 2069 6e0a 2020 2020 2074 6865 206c es in. the l │ │ │ │ │ +0004a820: 6973 7420 6f66 2049 6e76 6172 6961 6e74 ist of Invariant │ │ │ │ │ +0004a830: 2053 6563 7469 6f6e 7320 696e 2074 6865 Sections in the │ │ │ │ │ +0004a840: 206c 6963 656e 7365 206e 6f74 6963 6520 license notice │ │ │ │ │ +0004a850: 6f66 2074 6865 0a20 2020 2020 636f 6d62 of the. comb │ │ │ │ │ +0004a860: 696e 6564 2077 6f72 6b2e 0a0a 2020 2020 ined work... │ │ │ │ │ +0004a870: 2049 6e20 7468 6520 636f 6d62 696e 6174 In the combinat │ │ │ │ │ +0004a880: 696f 6e2c 2079 6f75 206d 7573 7420 636f ion, you must co │ │ │ │ │ +0004a890: 6d62 696e 6520 616e 7920 7365 6374 696f mbine any sectio │ │ │ │ │ +0004a8a0: 6e73 2045 6e74 6974 6c65 640a 2020 2020 ns Entitled. │ │ │ │ │ +0004a8b0: 2022 4869 7374 6f72 7922 2069 6e20 7468 "History" in th │ │ │ │ │ +0004a8c0: 6520 7661 7269 6f75 7320 6f72 6967 696e e various origin │ │ │ │ │ +0004a8d0: 616c 2064 6f63 756d 656e 7473 2c20 666f al documents, fo │ │ │ │ │ +0004a8e0: 726d 696e 6720 6f6e 6520 7365 6374 696f rming one sectio │ │ │ │ │ +0004a8f0: 6e0a 2020 2020 2045 6e74 6974 6c65 6420 n. Entitled │ │ │ │ │ +0004a900: 2248 6973 746f 7279 223b 206c 696b 6577 "History"; likew │ │ │ │ │ +0004a910: 6973 6520 636f 6d62 696e 6520 616e 7920 ise combine any │ │ │ │ │ +0004a920: 7365 6374 696f 6e73 2045 6e74 6974 6c65 sections Entitle │ │ │ │ │ +0004a930: 640a 2020 2020 2022 4163 6b6e 6f77 6c65 d. "Acknowle │ │ │ │ │ +0004a940: 6467 656d 656e 7473 222c 2061 6e64 2061 dgements", and a │ │ │ │ │ +0004a950: 6e79 2073 6563 7469 6f6e 7320 456e 7469 ny sections Enti │ │ │ │ │ +0004a960: 746c 6564 2022 4465 6469 6361 7469 6f6e tled "Dedication │ │ │ │ │ +0004a970: 7322 2e20 2059 6f75 0a20 2020 2020 6d75 s". You. mu │ │ │ │ │ +0004a980: 7374 2064 656c 6574 6520 616c 6c20 7365 st delete all se │ │ │ │ │ +0004a990: 6374 696f 6e73 2045 6e74 6974 6c65 6420 ctions Entitled │ │ │ │ │ +0004a9a0: 2245 6e64 6f72 7365 6d65 6e74 732e 220a "Endorsements.". │ │ │ │ │ +0004a9b0: 0a20 2036 2e20 434f 4c4c 4543 5449 4f4e . 6. COLLECTION │ │ │ │ │ +0004a9c0: 5320 4f46 2044 4f43 554d 454e 5453 0a0a S OF DOCUMENTS.. │ │ │ │ │ +0004a9d0: 2020 2020 2059 6f75 206d 6179 206d 616b You may mak │ │ │ │ │ +0004a9e0: 6520 6120 636f 6c6c 6563 7469 6f6e 2063 e a collection c │ │ │ │ │ +0004a9f0: 6f6e 7369 7374 696e 6720 6f66 2074 6865 onsisting of the │ │ │ │ │ +0004aa00: 2044 6f63 756d 656e 7420 616e 6420 6f74 Document and ot │ │ │ │ │ +0004aa10: 6865 720a 2020 2020 2064 6f63 756d 656e her. documen │ │ │ │ │ +0004aa20: 7473 2072 656c 6561 7365 6420 756e 6465 ts released unde │ │ │ │ │ +0004aa30: 7220 7468 6973 204c 6963 656e 7365 2c20 r this License, │ │ │ │ │ +0004aa40: 616e 6420 7265 706c 6163 6520 7468 6520 and replace the │ │ │ │ │ +0004aa50: 696e 6469 7669 6475 616c 0a20 2020 2020 individual. │ │ │ │ │ +0004aa60: 636f 7069 6573 206f 6620 7468 6973 204c copies of this L │ │ │ │ │ +0004aa70: 6963 656e 7365 2069 6e20 7468 6520 7661 icense in the va │ │ │ │ │ +0004aa80: 7269 6f75 7320 646f 6375 6d65 6e74 7320 rious documents │ │ │ │ │ +0004aa90: 7769 7468 2061 2073 696e 676c 6520 636f with a single co │ │ │ │ │ +0004aaa0: 7079 0a20 2020 2020 7468 6174 2069 7320 py. that is │ │ │ │ │ +0004aab0: 696e 636c 7564 6564 2069 6e20 7468 6520 included in the │ │ │ │ │ +0004aac0: 636f 6c6c 6563 7469 6f6e 2c20 7072 6f76 collection, prov │ │ │ │ │ +0004aad0: 6964 6564 2074 6861 7420 796f 7520 666f ided that you fo │ │ │ │ │ +0004aae0: 6c6c 6f77 2074 6865 0a20 2020 2020 7275 llow the. ru │ │ │ │ │ +0004aaf0: 6c65 7320 6f66 2074 6869 7320 4c69 6365 les of this Lice │ │ │ │ │ +0004ab00: 6e73 6520 666f 7220 7665 7262 6174 696d nse for verbatim │ │ │ │ │ +0004ab10: 2063 6f70 7969 6e67 206f 6620 6561 6368 copying of each │ │ │ │ │ +0004ab20: 206f 6620 7468 6520 646f 6375 6d65 6e74 of the document │ │ │ │ │ +0004ab30: 730a 2020 2020 2069 6e20 616c 6c20 6f74 s. in all ot │ │ │ │ │ +0004ab40: 6865 7220 7265 7370 6563 7473 2e0a 0a20 her respects... │ │ │ │ │ +0004ab50: 2020 2020 596f 7520 6d61 7920 6578 7472 You may extr │ │ │ │ │ +0004ab60: 6163 7420 6120 7369 6e67 6c65 2064 6f63 act a single doc │ │ │ │ │ +0004ab70: 756d 656e 7420 6672 6f6d 2073 7563 6820 ument from such │ │ │ │ │ +0004ab80: 6120 636f 6c6c 6563 7469 6f6e 2c20 616e a collection, an │ │ │ │ │ +0004ab90: 640a 2020 2020 2064 6973 7472 6962 7574 d. distribut │ │ │ │ │ +0004aba0: 6520 6974 2069 6e64 6976 6964 7561 6c6c e it individuall │ │ │ │ │ +0004abb0: 7920 756e 6465 7220 7468 6973 204c 6963 y under this Lic │ │ │ │ │ +0004abc0: 656e 7365 2c20 7072 6f76 6964 6564 2079 ense, provided y │ │ │ │ │ +0004abd0: 6f75 2069 6e73 6572 740a 2020 2020 2061 ou insert. a │ │ │ │ │ +0004abe0: 2063 6f70 7920 6f66 2074 6869 7320 4c69 copy of this Li │ │ │ │ │ +0004abf0: 6365 6e73 6520 696e 746f 2074 6865 2065 cense into the e │ │ │ │ │ +0004ac00: 7874 7261 6374 6564 2064 6f63 756d 656e xtracted documen │ │ │ │ │ +0004ac10: 742c 2061 6e64 2066 6f6c 6c6f 7720 7468 t, and follow th │ │ │ │ │ +0004ac20: 6973 0a20 2020 2020 4c69 6365 6e73 6520 is. License │ │ │ │ │ +0004ac30: 696e 2061 6c6c 206f 7468 6572 2072 6573 in all other res │ │ │ │ │ +0004ac40: 7065 6374 7320 7265 6761 7264 696e 6720 pects regarding │ │ │ │ │ +0004ac50: 7665 7262 6174 696d 2063 6f70 7969 6e67 verbatim copying │ │ │ │ │ +0004ac60: 206f 6620 7468 6174 0a20 2020 2020 646f of that. do │ │ │ │ │ +0004ac70: 6375 6d65 6e74 2e0a 0a20 2037 2e20 4147 cument... 7. AG │ │ │ │ │ +0004ac80: 4752 4547 4154 494f 4e20 5749 5448 2049 GREGATION WITH I │ │ │ │ │ +0004ac90: 4e44 4550 454e 4445 4e54 2057 4f52 4b53 NDEPENDENT WORKS │ │ │ │ │ +0004aca0: 0a0a 2020 2020 2041 2063 6f6d 7069 6c61 .. A compila │ │ │ │ │ +0004acb0: 7469 6f6e 206f 6620 7468 6520 446f 6375 tion of the Docu │ │ │ │ │ +0004acc0: 6d65 6e74 206f 7220 6974 7320 6465 7269 ment or its deri │ │ │ │ │ +0004acd0: 7661 7469 7665 7320 7769 7468 206f 7468 vatives with oth │ │ │ │ │ +0004ace0: 6572 0a20 2020 2020 7365 7061 7261 7465 er. separate │ │ │ │ │ +0004acf0: 2061 6e64 2069 6e64 6570 656e 6465 6e74 and independent │ │ │ │ │ +0004ad00: 2064 6f63 756d 656e 7473 206f 7220 776f documents or wo │ │ │ │ │ +0004ad10: 726b 732c 2069 6e20 6f72 206f 6e20 6120 rks, in or on a │ │ │ │ │ +0004ad20: 766f 6c75 6d65 206f 6620 610a 2020 2020 volume of a. │ │ │ │ │ +0004ad30: 2073 746f 7261 6765 206f 7220 6469 7374 storage or dist │ │ │ │ │ +0004ad40: 7269 6275 7469 6f6e 206d 6564 6975 6d2c ribution medium, │ │ │ │ │ +0004ad50: 2069 7320 6361 6c6c 6564 2061 6e20 2261 is called an "a │ │ │ │ │ +0004ad60: 6767 7265 6761 7465 2220 6966 2074 6865 ggregate" if the │ │ │ │ │ +0004ad70: 0a20 2020 2020 636f 7079 7269 6768 7420 . copyright │ │ │ │ │ +0004ad80: 7265 7375 6c74 696e 6720 6672 6f6d 2074 resulting from t │ │ │ │ │ +0004ad90: 6865 2063 6f6d 7069 6c61 7469 6f6e 2069 he compilation i │ │ │ │ │ +0004ada0: 7320 6e6f 7420 7573 6564 2074 6f20 6c69 s not used to li │ │ │ │ │ +0004adb0: 6d69 7420 7468 650a 2020 2020 206c 6567 mit the. leg │ │ │ │ │ +0004adc0: 616c 2072 6967 6874 7320 6f66 2074 6865 al rights of the │ │ │ │ │ +0004add0: 2063 6f6d 7069 6c61 7469 6f6e 2773 2075 compilation's u │ │ │ │ │ +0004ade0: 7365 7273 2062 6579 6f6e 6420 7768 6174 sers beyond what │ │ │ │ │ +0004adf0: 2074 6865 2069 6e64 6976 6964 7561 6c0a the individual. │ │ │ │ │ +0004ae00: 2020 2020 2077 6f72 6b73 2070 6572 6d69 works permi │ │ │ │ │ +0004ae10: 742e 2020 5768 656e 2074 6865 2044 6f63 t. When the Doc │ │ │ │ │ +0004ae20: 756d 656e 7420 6973 2069 6e63 6c75 6465 ument is include │ │ │ │ │ +0004ae30: 6420 696e 2061 6e20 6167 6772 6567 6174 d in an aggregat │ │ │ │ │ +0004ae40: 652c 2074 6869 730a 2020 2020 204c 6963 e, this. Lic │ │ │ │ │ +0004ae50: 656e 7365 2064 6f65 7320 6e6f 7420 6170 ense does not ap │ │ │ │ │ +0004ae60: 706c 7920 746f 2074 6865 206f 7468 6572 ply to the other │ │ │ │ │ +0004ae70: 2077 6f72 6b73 2069 6e20 7468 6520 6167 works in the ag │ │ │ │ │ +0004ae80: 6772 6567 6174 6520 7768 6963 680a 2020 gregate which. │ │ │ │ │ +0004ae90: 2020 2061 7265 206e 6f74 2074 6865 6d73 are not thems │ │ │ │ │ +0004aea0: 656c 7665 7320 6465 7269 7661 7469 7665 elves derivative │ │ │ │ │ +0004aeb0: 2077 6f72 6b73 206f 6620 7468 6520 446f works of the Do │ │ │ │ │ +0004aec0: 6375 6d65 6e74 2e0a 0a20 2020 2020 4966 cument... If │ │ │ │ │ +0004aed0: 2074 6865 2043 6f76 6572 2054 6578 7420 the Cover Text │ │ │ │ │ +0004aee0: 7265 7175 6972 656d 656e 7420 6f66 2073 requirement of s │ │ │ │ │ +0004aef0: 6563 7469 6f6e 2033 2069 7320 6170 706c ection 3 is appl │ │ │ │ │ +0004af00: 6963 6162 6c65 2074 6f20 7468 6573 650a icable to these. │ │ │ │ │ +0004af10: 2020 2020 2063 6f70 6965 7320 6f66 2074 copies of t │ │ │ │ │ +0004af20: 6865 2044 6f63 756d 656e 742c 2074 6865 he Document, the │ │ │ │ │ +0004af30: 6e20 6966 2074 6865 2044 6f63 756d 656e n if the Documen │ │ │ │ │ +0004af40: 7420 6973 206c 6573 7320 7468 616e 206f t is less than o │ │ │ │ │ +0004af50: 6e65 2068 616c 660a 2020 2020 206f 6620 ne half. of │ │ │ │ │ +0004af60: 7468 6520 656e 7469 7265 2061 6767 7265 the entire aggre │ │ │ │ │ +0004af70: 6761 7465 2c20 7468 6520 446f 6375 6d65 gate, the Docume │ │ │ │ │ +0004af80: 6e74 2773 2043 6f76 6572 2054 6578 7473 nt's Cover Texts │ │ │ │ │ +0004af90: 206d 6179 2062 6520 706c 6163 6564 0a20 may be placed. │ │ │ │ │ +0004afa0: 2020 2020 6f6e 2063 6f76 6572 7320 7468 on covers th │ │ │ │ │ +0004afb0: 6174 2062 7261 636b 6574 2074 6865 2044 at bracket the D │ │ │ │ │ +0004afc0: 6f63 756d 656e 7420 7769 7468 696e 2074 ocument within t │ │ │ │ │ +0004afd0: 6865 2061 6767 7265 6761 7465 2c20 6f72 he aggregate, or │ │ │ │ │ +0004afe0: 2074 6865 0a20 2020 2020 656c 6563 7472 the. electr │ │ │ │ │ +0004aff0: 6f6e 6963 2065 7175 6976 616c 656e 7420 onic equivalent │ │ │ │ │ +0004b000: 6f66 2063 6f76 6572 7320 6966 2074 6865 of covers if the │ │ │ │ │ +0004b010: 2044 6f63 756d 656e 7420 6973 2069 6e20 Document is in │ │ │ │ │ +0004b020: 656c 6563 7472 6f6e 6963 0a20 2020 2020 electronic. │ │ │ │ │ +0004b030: 666f 726d 2e20 204f 7468 6572 7769 7365 form. Otherwise │ │ │ │ │ +0004b040: 2074 6865 7920 6d75 7374 2061 7070 6561 they must appea │ │ │ │ │ +0004b050: 7220 6f6e 2070 7269 6e74 6564 2063 6f76 r on printed cov │ │ │ │ │ +0004b060: 6572 7320 7468 6174 2062 7261 636b 6574 ers that bracket │ │ │ │ │ +0004b070: 0a20 2020 2020 7468 6520 7768 6f6c 6520 . the whole │ │ │ │ │ +0004b080: 6167 6772 6567 6174 652e 0a0a 2020 382e aggregate... 8. │ │ │ │ │ +0004b090: 2054 5241 4e53 4c41 5449 4f4e 0a0a 2020 TRANSLATION.. │ │ │ │ │ +0004b0a0: 2020 2054 7261 6e73 6c61 7469 6f6e 2069 Translation i │ │ │ │ │ +0004b0b0: 7320 636f 6e73 6964 6572 6564 2061 206b s considered a k │ │ │ │ │ +0004b0c0: 696e 6420 6f66 206d 6f64 6966 6963 6174 ind of modificat │ │ │ │ │ +0004b0d0: 696f 6e2c 2073 6f20 796f 7520 6d61 790a ion, so you may. │ │ │ │ │ +0004b0e0: 2020 2020 2064 6973 7472 6962 7574 6520 distribute │ │ │ │ │ +0004b0f0: 7472 616e 736c 6174 696f 6e73 206f 6620 translations of │ │ │ │ │ +0004b100: 7468 6520 446f 6375 6d65 6e74 2075 6e64 the Document und │ │ │ │ │ +0004b110: 6572 2074 6865 2074 6572 6d73 206f 6620 er the terms of │ │ │ │ │ +0004b120: 7365 6374 696f 6e0a 2020 2020 2034 2e20 section. 4. │ │ │ │ │ +0004b130: 2052 6570 6c61 6369 6e67 2049 6e76 6172 Replacing Invar │ │ │ │ │ +0004b140: 6961 6e74 2053 6563 7469 6f6e 7320 7769 iant Sections wi │ │ │ │ │ +0004b150: 7468 2074 7261 6e73 6c61 7469 6f6e 7320 th translations │ │ │ │ │ +0004b160: 7265 7175 6972 6573 2073 7065 6369 616c requires special │ │ │ │ │ +0004b170: 0a20 2020 2020 7065 726d 6973 7369 6f6e . permission │ │ │ │ │ +0004b180: 2066 726f 6d20 7468 6569 7220 636f 7079 from their copy │ │ │ │ │ +0004b190: 7269 6768 7420 686f 6c64 6572 732c 2062 right holders, b │ │ │ │ │ +0004b1a0: 7574 2079 6f75 206d 6179 2069 6e63 6c75 ut you may inclu │ │ │ │ │ +0004b1b0: 6465 0a20 2020 2020 7472 616e 736c 6174 de. translat │ │ │ │ │ +0004b1c0: 696f 6e73 206f 6620 736f 6d65 206f 7220 ions of some or │ │ │ │ │ +0004b1d0: 616c 6c20 496e 7661 7269 616e 7420 5365 all Invariant Se │ │ │ │ │ +0004b1e0: 6374 696f 6e73 2069 6e20 6164 6469 7469 ctions in additi │ │ │ │ │ +0004b1f0: 6f6e 2074 6f20 7468 650a 2020 2020 206f on to the. o │ │ │ │ │ +0004b200: 7269 6769 6e61 6c20 7665 7273 696f 6e73 riginal versions │ │ │ │ │ +0004b210: 206f 6620 7468 6573 6520 496e 7661 7269 of these Invari │ │ │ │ │ +0004b220: 616e 7420 5365 6374 696f 6e73 2e20 2059 ant Sections. Y │ │ │ │ │ +0004b230: 6f75 206d 6179 2069 6e63 6c75 6465 2061 ou may include a │ │ │ │ │ +0004b240: 0a20 2020 2020 7472 616e 736c 6174 696f . translatio │ │ │ │ │ +0004b250: 6e20 6f66 2074 6869 7320 4c69 6365 6e73 n of this Licens │ │ │ │ │ +0004b260: 652c 2061 6e64 2061 6c6c 2074 6865 206c e, and all the l │ │ │ │ │ +0004b270: 6963 656e 7365 206e 6f74 6963 6573 2069 icense notices i │ │ │ │ │ +0004b280: 6e20 7468 650a 2020 2020 2044 6f63 756d n the. Docum │ │ │ │ │ +0004b290: 656e 742c 2061 6e64 2061 6e79 2057 6172 ent, and any War │ │ │ │ │ +0004b2a0: 7261 6e74 7920 4469 7363 6c61 696d 6572 ranty Disclaimer │ │ │ │ │ +0004b2b0: 732c 2070 726f 7669 6465 6420 7468 6174 s, provided that │ │ │ │ │ +0004b2c0: 2079 6f75 2061 6c73 6f0a 2020 2020 2069 you also. i │ │ │ │ │ +0004b2d0: 6e63 6c75 6465 2074 6865 206f 7269 6769 nclude the origi │ │ │ │ │ +0004b2e0: 6e61 6c20 456e 676c 6973 6820 7665 7273 nal English vers │ │ │ │ │ +0004b2f0: 696f 6e20 6f66 2074 6869 7320 4c69 6365 ion of this Lice │ │ │ │ │ +0004b300: 6e73 6520 616e 6420 7468 650a 2020 2020 nse and the. │ │ │ │ │ +0004b310: 206f 7269 6769 6e61 6c20 7665 7273 696f original versio │ │ │ │ │ +0004b320: 6e73 206f 6620 7468 6f73 6520 6e6f 7469 ns of those noti │ │ │ │ │ +0004b330: 6365 7320 616e 6420 6469 7363 6c61 696d ces and disclaim │ │ │ │ │ +0004b340: 6572 732e 2020 496e 2063 6173 6520 6f66 ers. In case of │ │ │ │ │ +0004b350: 2061 0a20 2020 2020 6469 7361 6772 6565 a. disagree │ │ │ │ │ +0004b360: 6d65 6e74 2062 6574 7765 656e 2074 6865 ment between the │ │ │ │ │ +0004b370: 2074 7261 6e73 6c61 7469 6f6e 2061 6e64 translation and │ │ │ │ │ +0004b380: 2074 6865 206f 7269 6769 6e61 6c20 7665 the original ve │ │ │ │ │ +0004b390: 7273 696f 6e20 6f66 0a20 2020 2020 7468 rsion of. th │ │ │ │ │ +0004b3a0: 6973 204c 6963 656e 7365 206f 7220 6120 is License or a │ │ │ │ │ +0004b3b0: 6e6f 7469 6365 206f 7220 6469 7363 6c61 notice or discla │ │ │ │ │ +0004b3c0: 696d 6572 2c20 7468 6520 6f72 6967 696e imer, the origin │ │ │ │ │ +0004b3d0: 616c 2076 6572 7369 6f6e 2077 696c 6c0a al version will. │ │ │ │ │ +0004b3e0: 2020 2020 2070 7265 7661 696c 2e0a 0a20 prevail... │ │ │ │ │ +0004b3f0: 2020 2020 4966 2061 2073 6563 7469 6f6e If a section │ │ │ │ │ +0004b400: 2069 6e20 7468 6520 446f 6375 6d65 6e74 in the Document │ │ │ │ │ +0004b410: 2069 7320 456e 7469 746c 6564 2022 4163 is Entitled "Ac │ │ │ │ │ +0004b420: 6b6e 6f77 6c65 6467 656d 656e 7473 222c knowledgements", │ │ │ │ │ +0004b430: 0a20 2020 2020 2244 6564 6963 6174 696f . "Dedicatio │ │ │ │ │ +0004b440: 6e73 222c 206f 7220 2248 6973 746f 7279 ns", or "History │ │ │ │ │ +0004b450: 222c 2074 6865 2072 6571 7569 7265 6d65 ", the requireme │ │ │ │ │ +0004b460: 6e74 2028 7365 6374 696f 6e20 3429 2074 nt (section 4) t │ │ │ │ │ +0004b470: 6f0a 2020 2020 2050 7265 7365 7276 6520 o. Preserve │ │ │ │ │ +0004b480: 6974 7320 5469 746c 6520 2873 6563 7469 its Title (secti │ │ │ │ │ +0004b490: 6f6e 2031 2920 7769 6c6c 2074 7970 6963 on 1) will typic │ │ │ │ │ +0004b4a0: 616c 6c79 2072 6571 7569 7265 2063 6861 ally require cha │ │ │ │ │ +0004b4b0: 6e67 696e 6720 7468 650a 2020 2020 2061 nging the. a │ │ │ │ │ +0004b4c0: 6374 7561 6c20 7469 746c 652e 0a0a 2020 ctual title... │ │ │ │ │ +0004b4d0: 392e 2054 4552 4d49 4e41 5449 4f4e 0a0a 9. TERMINATION.. │ │ │ │ │ +0004b4e0: 2020 2020 2059 6f75 206d 6179 206e 6f74 You may not │ │ │ │ │ +0004b4f0: 2063 6f70 792c 206d 6f64 6966 792c 2073 copy, modify, s │ │ │ │ │ +0004b500: 7562 6c69 6365 6e73 652c 206f 7220 6469 ublicense, or di │ │ │ │ │ +0004b510: 7374 7269 6275 7465 2074 6865 2044 6f63 stribute the Doc │ │ │ │ │ +0004b520: 756d 656e 740a 2020 2020 2065 7863 6570 ument. excep │ │ │ │ │ +0004b530: 7420 6173 2065 7870 7265 7373 6c79 2070 t as expressly p │ │ │ │ │ +0004b540: 726f 7669 6465 6420 666f 7220 756e 6465 rovided for unde │ │ │ │ │ +0004b550: 7220 7468 6973 204c 6963 656e 7365 2e20 r this License. │ │ │ │ │ +0004b560: 2041 6e79 206f 7468 6572 0a20 2020 2020 Any other. │ │ │ │ │ +0004b570: 6174 7465 6d70 7420 746f 2063 6f70 792c attempt to copy, │ │ │ │ │ +0004b580: 206d 6f64 6966 792c 2073 7562 6c69 6365 modify, sublice │ │ │ │ │ +0004b590: 6e73 6520 6f72 2064 6973 7472 6962 7574 nse or distribut │ │ │ │ │ +0004b5a0: 6520 7468 6520 446f 6375 6d65 6e74 2069 e the Document i │ │ │ │ │ +0004b5b0: 730a 2020 2020 2076 6f69 642c 2061 6e64 s. void, and │ │ │ │ │ +0004b5c0: 2077 696c 6c20 6175 746f 6d61 7469 6361 will automatica │ │ │ │ │ +0004b5d0: 6c6c 7920 7465 726d 696e 6174 6520 796f lly terminate yo │ │ │ │ │ +0004b5e0: 7572 2072 6967 6874 7320 756e 6465 7220 ur rights under │ │ │ │ │ +0004b5f0: 7468 6973 0a20 2020 2020 4c69 6365 6e73 this. Licens │ │ │ │ │ +0004b600: 652e 2020 486f 7765 7665 722c 2070 6172 e. However, par │ │ │ │ │ +0004b610: 7469 6573 2077 686f 2068 6176 6520 7265 ties who have re │ │ │ │ │ +0004b620: 6365 6976 6564 2063 6f70 6965 732c 206f ceived copies, o │ │ │ │ │ +0004b630: 7220 7269 6768 7473 2c0a 2020 2020 2066 r rights,. f │ │ │ │ │ +0004b640: 726f 6d20 796f 7520 756e 6465 7220 7468 rom you under th │ │ │ │ │ +0004b650: 6973 204c 6963 656e 7365 2077 696c 6c20 is License will │ │ │ │ │ +0004b660: 6e6f 7420 6861 7665 2074 6865 6972 206c not have their l │ │ │ │ │ +0004b670: 6963 656e 7365 7320 7465 726d 696e 6174 icenses terminat │ │ │ │ │ +0004b680: 6564 0a20 2020 2020 736f 206c 6f6e 6720 ed. so long │ │ │ │ │ +0004b690: 6173 2073 7563 6820 7061 7274 6965 7320 as such parties │ │ │ │ │ +0004b6a0: 7265 6d61 696e 2069 6e20 6675 6c6c 2063 remain in full c │ │ │ │ │ +0004b6b0: 6f6d 706c 6961 6e63 652e 0a0a 2020 3130 ompliance... 10 │ │ │ │ │ +0004b6c0: 2e20 4655 5455 5245 2052 4556 4953 494f . FUTURE REVISIO │ │ │ │ │ +0004b6d0: 4e53 204f 4620 5448 4953 204c 4943 454e NS OF THIS LICEN │ │ │ │ │ +0004b6e0: 5345 0a0a 2020 2020 2054 6865 2046 7265 SE.. The Fre │ │ │ │ │ +0004b6f0: 6520 536f 6674 7761 7265 2046 6f75 6e64 e Software Found │ │ │ │ │ +0004b700: 6174 696f 6e20 6d61 7920 7075 626c 6973 ation may publis │ │ │ │ │ +0004b710: 6820 6e65 772c 2072 6576 6973 6564 2076 h new, revised v │ │ │ │ │ +0004b720: 6572 7369 6f6e 7320 6f66 0a20 2020 2020 ersions of. │ │ │ │ │ +0004b730: 7468 6520 474e 5520 4672 6565 2044 6f63 the GNU Free Doc │ │ │ │ │ +0004b740: 756d 656e 7461 7469 6f6e 204c 6963 656e umentation Licen │ │ │ │ │ +0004b750: 7365 2066 726f 6d20 7469 6d65 2074 6f20 se from time to │ │ │ │ │ +0004b760: 7469 6d65 2e20 2053 7563 6820 6e65 770a time. Such new. │ │ │ │ │ +0004b770: 2020 2020 2076 6572 7369 6f6e 7320 7769 versions wi │ │ │ │ │ +0004b780: 6c6c 2062 6520 7369 6d69 6c61 7220 696e ll be similar in │ │ │ │ │ +0004b790: 2073 7069 7269 7420 746f 2074 6865 2070 spirit to the p │ │ │ │ │ +0004b7a0: 7265 7365 6e74 2076 6572 7369 6f6e 2c20 resent version, │ │ │ │ │ +0004b7b0: 6275 7420 6d61 790a 2020 2020 2064 6966 but may. dif │ │ │ │ │ +0004b7c0: 6665 7220 696e 2064 6574 6169 6c20 746f fer in detail to │ │ │ │ │ +0004b7d0: 2061 6464 7265 7373 206e 6577 2070 726f address new pro │ │ │ │ │ +0004b7e0: 626c 656d 7320 6f72 2063 6f6e 6365 726e blems or concern │ │ │ │ │ +0004b7f0: 732e 2020 5365 650a 2020 2020 203c 6874 s. See. ... │ │ │ │ │ +0004b820: 2020 2045 6163 6820 7665 7273 696f 6e20 Each version │ │ │ │ │ +0004b830: 6f66 2074 6865 204c 6963 656e 7365 2069 of the License i │ │ │ │ │ +0004b840: 7320 6769 7665 6e20 6120 6469 7374 696e s given a distin │ │ │ │ │ +0004b850: 6775 6973 6869 6e67 2076 6572 7369 6f6e guishing version │ │ │ │ │ +0004b860: 0a20 2020 2020 6e75 6d62 6572 2e20 2049 . number. I │ │ │ │ │ +0004b870: 6620 7468 6520 446f 6375 6d65 6e74 2073 f the Document s │ │ │ │ │ +0004b880: 7065 6369 6669 6573 2074 6861 7420 6120 pecifies that a │ │ │ │ │ +0004b890: 7061 7274 6963 756c 6172 206e 756d 6265 particular numbe │ │ │ │ │ +0004b8a0: 7265 640a 2020 2020 2076 6572 7369 6f6e red. version │ │ │ │ │ +0004b8b0: 206f 6620 7468 6973 204c 6963 656e 7365 of this License │ │ │ │ │ +0004b8c0: 2022 6f72 2061 6e79 206c 6174 6572 2076 "or any later v │ │ │ │ │ +0004b8d0: 6572 7369 6f6e 2220 6170 706c 6965 7320 ersion" applies │ │ │ │ │ +0004b8e0: 746f 2069 742c 2079 6f75 0a20 2020 2020 to it, you. │ │ │ │ │ +0004b8f0: 6861 7665 2074 6865 206f 7074 696f 6e20 have the option │ │ │ │ │ +0004b900: 6f66 2066 6f6c 6c6f 7769 6e67 2074 6865 of following the │ │ │ │ │ +0004b910: 2074 6572 6d73 2061 6e64 2063 6f6e 6469 terms and condi │ │ │ │ │ +0004b920: 7469 6f6e 7320 6569 7468 6572 206f 660a tions either of. │ │ │ │ │ +0004b930: 2020 2020 2074 6861 7420 7370 6563 6966 that specif │ │ │ │ │ +0004b940: 6965 6420 7665 7273 696f 6e20 6f72 206f ied version or o │ │ │ │ │ +0004b950: 6620 616e 7920 6c61 7465 7220 7665 7273 f any later vers │ │ │ │ │ +0004b960: 696f 6e20 7468 6174 2068 6173 2062 6565 ion that has bee │ │ │ │ │ +0004b970: 6e0a 2020 2020 2070 7562 6c69 7368 6564 n. published │ │ │ │ │ +0004b980: 2028 6e6f 7420 6173 2061 2064 7261 6674 (not as a draft │ │ │ │ │ +0004b990: 2920 6279 2074 6865 2046 7265 6520 536f ) by the Free So │ │ │ │ │ +0004b9a0: 6674 7761 7265 2046 6f75 6e64 6174 696f ftware Foundatio │ │ │ │ │ +0004b9b0: 6e2e 2020 4966 2074 6865 0a20 2020 2020 n. If the. │ │ │ │ │ +0004b9c0: 446f 6375 6d65 6e74 2064 6f65 7320 6e6f Document does no │ │ │ │ │ +0004b9d0: 7420 7370 6563 6966 7920 6120 7665 7273 t specify a vers │ │ │ │ │ +0004b9e0: 696f 6e20 6e75 6d62 6572 206f 6620 7468 ion number of th │ │ │ │ │ +0004b9f0: 6973 204c 6963 656e 7365 2c20 796f 7520 is License, you │ │ │ │ │ +0004ba00: 6d61 790a 2020 2020 2063 686f 6f73 6520 may. choose │ │ │ │ │ +0004ba10: 616e 7920 7665 7273 696f 6e20 6576 6572 any version ever │ │ │ │ │ +0004ba20: 2070 7562 6c69 7368 6564 2028 6e6f 7420 published (not │ │ │ │ │ +0004ba30: 6173 2061 2064 7261 6674 2920 6279 2074 as a draft) by t │ │ │ │ │ +0004ba40: 6865 2046 7265 650a 2020 2020 2053 6f66 he Free. Sof │ │ │ │ │ +0004ba50: 7477 6172 6520 466f 756e 6461 7469 6f6e tware Foundation │ │ │ │ │ +0004ba60: 2e0a 0a44 2e31 2e31 2041 4444 454e 4455 ...D.1.1 ADDENDU │ │ │ │ │ +0004ba70: 4d3a 2048 6f77 2074 6f20 7573 6520 7468 M: How to use th │ │ │ │ │ +0004ba80: 6973 204c 6963 656e 7365 2066 6f72 2079 is License for y │ │ │ │ │ +0004ba90: 6f75 7220 646f 6375 6d65 6e74 730a 2d2d our documents.-- │ │ │ │ │ 0004baa0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 0004bab0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 0004bac0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0004bad0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 546f 2075 ----------..To u │ │ │ │ │ -0004bae0: 7365 2074 6869 7320 4c69 6365 6e73 6520 se this License │ │ │ │ │ -0004baf0: 696e 2061 2064 6f63 756d 656e 7420 796f in a document yo │ │ │ │ │ -0004bb00: 7520 6861 7665 2077 7269 7474 656e 2c20 u have written, │ │ │ │ │ -0004bb10: 696e 636c 7564 6520 6120 636f 7079 206f include a copy o │ │ │ │ │ -0004bb20: 660a 7468 6520 4c69 6365 6e73 6520 696e f.the License in │ │ │ │ │ -0004bb30: 2074 6865 2064 6f63 756d 656e 7420 616e the document an │ │ │ │ │ -0004bb40: 6420 7075 7420 7468 6520 666f 6c6c 6f77 d put the follow │ │ │ │ │ -0004bb50: 696e 6720 636f 7079 7269 6768 7420 616e ing copyright an │ │ │ │ │ -0004bb60: 6420 6c69 6365 6e73 650a 6e6f 7469 6365 d license.notice │ │ │ │ │ -0004bb70: 7320 6a75 7374 2061 6674 6572 2074 6865 s just after the │ │ │ │ │ -0004bb80: 2074 6974 6c65 2070 6167 653a 0a0a 2020 title page:.. │ │ │ │ │ -0004bb90: 2020 2020 2043 6f70 7972 6967 6874 2028 Copyright ( │ │ │ │ │ -0004bba0: 4329 2020 5945 4152 2020 594f 5552 204e C) YEAR YOUR N │ │ │ │ │ -0004bbb0: 414d 452e 0a20 2020 2020 2020 5065 726d AME.. Perm │ │ │ │ │ -0004bbc0: 6973 7369 6f6e 2069 7320 6772 616e 7465 ission is grante │ │ │ │ │ -0004bbd0: 6420 746f 2063 6f70 792c 2064 6973 7472 d to copy, distr │ │ │ │ │ -0004bbe0: 6962 7574 6520 616e 642f 6f72 206d 6f64 ibute and/or mod │ │ │ │ │ -0004bbf0: 6966 7920 7468 6973 2064 6f63 756d 656e ify this documen │ │ │ │ │ -0004bc00: 740a 2020 2020 2020 2075 6e64 6572 2074 t. under t │ │ │ │ │ -0004bc10: 6865 2074 6572 6d73 206f 6620 7468 6520 he terms of the │ │ │ │ │ -0004bc20: 474e 5520 4672 6565 2044 6f63 756d 656e GNU Free Documen │ │ │ │ │ -0004bc30: 7461 7469 6f6e 204c 6963 656e 7365 2c20 tation License, │ │ │ │ │ -0004bc40: 5665 7273 696f 6e20 312e 320a 2020 2020 Version 1.2. │ │ │ │ │ -0004bc50: 2020 206f 7220 616e 7920 6c61 7465 7220 or any later │ │ │ │ │ -0004bc60: 7665 7273 696f 6e20 7075 626c 6973 6865 version publishe │ │ │ │ │ -0004bc70: 6420 6279 2074 6865 2046 7265 6520 536f d by the Free So │ │ │ │ │ -0004bc80: 6674 7761 7265 2046 6f75 6e64 6174 696f ftware Foundatio │ │ │ │ │ -0004bc90: 6e3b 0a20 2020 2020 2020 7769 7468 206e n;. with n │ │ │ │ │ -0004bca0: 6f20 496e 7661 7269 616e 7420 5365 6374 o Invariant Sect │ │ │ │ │ -0004bcb0: 696f 6e73 2c20 6e6f 2046 726f 6e74 2d43 ions, no Front-C │ │ │ │ │ -0004bcc0: 6f76 6572 2054 6578 7473 2c20 616e 6420 over Texts, and │ │ │ │ │ -0004bcd0: 6e6f 2042 6163 6b2d 436f 7665 720a 2020 no Back-Cover. │ │ │ │ │ -0004bce0: 2020 2020 2054 6578 7473 2e20 2041 2063 Texts. A c │ │ │ │ │ -0004bcf0: 6f70 7920 6f66 2074 6865 206c 6963 656e opy of the licen │ │ │ │ │ -0004bd00: 7365 2069 7320 696e 636c 7564 6564 2069 se is included i │ │ │ │ │ -0004bd10: 6e20 7468 6520 7365 6374 696f 6e20 656e n the section en │ │ │ │ │ -0004bd20: 7469 746c 6564 2060 6047 4e55 0a20 2020 titled ``GNU. │ │ │ │ │ -0004bd30: 2020 2020 4672 6565 2044 6f63 756d 656e Free Documen │ │ │ │ │ -0004bd40: 7461 7469 6f6e 204c 6963 656e 7365 2727 tation License'' │ │ │ │ │ -0004bd50: 2e0a 0a20 2020 4966 2079 6f75 2068 6176 ... If you hav │ │ │ │ │ -0004bd60: 6520 496e 7661 7269 616e 7420 5365 6374 e Invariant Sect │ │ │ │ │ -0004bd70: 696f 6e73 2c20 4672 6f6e 742d 436f 7665 ions, Front-Cove │ │ │ │ │ -0004bd80: 7220 5465 7874 7320 616e 6420 4261 636b r Texts and Back │ │ │ │ │ -0004bd90: 2d43 6f76 6572 0a54 6578 7473 2c20 7265 -Cover.Texts, re │ │ │ │ │ -0004bda0: 706c 6163 6520 7468 6520 2277 6974 682e place the "with. │ │ │ │ │ -0004bdb0: 2e2e 5465 7874 732e 2220 206c 696e 6520 ..Texts." line │ │ │ │ │ -0004bdc0: 7769 7468 2074 6869 733a 0a0a 2020 2020 with this:.. │ │ │ │ │ -0004bdd0: 2020 2020 2077 6974 6820 7468 6520 496e with the In │ │ │ │ │ -0004bde0: 7661 7269 616e 7420 5365 6374 696f 6e73 variant Sections │ │ │ │ │ -0004bdf0: 2062 6569 6e67 204c 4953 5420 5448 4549 being LIST THEI │ │ │ │ │ -0004be00: 5220 5449 544c 4553 2c20 7769 7468 0a20 R TITLES, with. │ │ │ │ │ -0004be10: 2020 2020 2020 2020 7468 6520 4672 6f6e the Fron │ │ │ │ │ -0004be20: 742d 436f 7665 7220 5465 7874 7320 6265 t-Cover Texts be │ │ │ │ │ -0004be30: 696e 6720 4c49 5354 2c20 616e 6420 7769 ing LIST, and wi │ │ │ │ │ -0004be40: 7468 2074 6865 2042 6163 6b2d 436f 7665 th the Back-Cove │ │ │ │ │ -0004be50: 7220 5465 7874 730a 2020 2020 2020 2020 r Texts. │ │ │ │ │ -0004be60: 2062 6569 6e67 204c 4953 542e 0a0a 2020 being LIST... │ │ │ │ │ -0004be70: 2049 6620 796f 7520 6861 7665 2049 6e76 If you have Inv │ │ │ │ │ -0004be80: 6172 6961 6e74 2053 6563 7469 6f6e 7320 ariant Sections │ │ │ │ │ -0004be90: 7769 7468 6f75 7420 436f 7665 7220 5465 without Cover Te │ │ │ │ │ -0004bea0: 7874 732c 206f 7220 736f 6d65 206f 7468 xts, or some oth │ │ │ │ │ -0004beb0: 6572 0a63 6f6d 6269 6e61 7469 6f6e 206f er.combination o │ │ │ │ │ -0004bec0: 6620 7468 6520 7468 7265 652c 206d 6572 f the three, mer │ │ │ │ │ -0004bed0: 6765 2074 686f 7365 2074 776f 2061 6c74 ge those two alt │ │ │ │ │ -0004bee0: 6572 6e61 7469 7665 7320 746f 2073 7569 ernatives to sui │ │ │ │ │ -0004bef0: 7420 7468 650a 7369 7475 6174 696f 6e2e t the.situation. │ │ │ │ │ -0004bf00: 0a0a 2020 2049 6620 796f 7572 2064 6f63 .. If your doc │ │ │ │ │ -0004bf10: 756d 656e 7420 636f 6e74 6169 6e73 206e ument contains n │ │ │ │ │ -0004bf20: 6f6e 7472 6976 6961 6c20 6578 616d 706c ontrivial exampl │ │ │ │ │ -0004bf30: 6573 206f 6620 7072 6f67 7261 6d20 636f es of program co │ │ │ │ │ -0004bf40: 6465 2c20 7765 0a72 6563 6f6d 6d65 6e64 de, we.recommend │ │ │ │ │ -0004bf50: 2072 656c 6561 7369 6e67 2074 6865 7365 releasing these │ │ │ │ │ -0004bf60: 2065 7861 6d70 6c65 7320 696e 2070 6172 examples in par │ │ │ │ │ -0004bf70: 616c 6c65 6c20 756e 6465 7220 796f 7572 allel under your │ │ │ │ │ -0004bf80: 2063 686f 6963 6520 6f66 2066 7265 650a choice of free. │ │ │ │ │ -0004bf90: 736f 6674 7761 7265 206c 6963 656e 7365 software license │ │ │ │ │ -0004bfa0: 2c20 7375 6368 2061 7320 7468 6520 474e , such as the GN │ │ │ │ │ -0004bfb0: 5520 4765 6e65 7261 6c20 5075 626c 6963 U General Public │ │ │ │ │ -0004bfc0: 204c 6963 656e 7365 2c20 746f 2070 6572 License, to per │ │ │ │ │ -0004bfd0: 6d69 740a 7468 6569 7220 7573 6520 696e mit.their use in │ │ │ │ │ -0004bfe0: 2066 7265 6520 736f 6674 7761 7265 2e0a free software.. │ │ │ │ │ -0004bff0: 0a . │ │ │ │ │ +0004bad0: 2d2d 2d2d 2d2d 2d2d 0a0a 546f 2075 7365 --------..To use │ │ │ │ │ +0004bae0: 2074 6869 7320 4c69 6365 6e73 6520 696e this License in │ │ │ │ │ +0004baf0: 2061 2064 6f63 756d 656e 7420 796f 7520 a document you │ │ │ │ │ +0004bb00: 6861 7665 2077 7269 7474 656e 2c20 696e have written, in │ │ │ │ │ +0004bb10: 636c 7564 6520 6120 636f 7079 206f 660a clude a copy of. │ │ │ │ │ +0004bb20: 7468 6520 4c69 6365 6e73 6520 696e 2074 the License in t │ │ │ │ │ +0004bb30: 6865 2064 6f63 756d 656e 7420 616e 6420 he document and │ │ │ │ │ +0004bb40: 7075 7420 7468 6520 666f 6c6c 6f77 696e put the followin │ │ │ │ │ +0004bb50: 6720 636f 7079 7269 6768 7420 616e 6420 g copyright and │ │ │ │ │ +0004bb60: 6c69 6365 6e73 650a 6e6f 7469 6365 7320 license.notices │ │ │ │ │ +0004bb70: 6a75 7374 2061 6674 6572 2074 6865 2074 just after the t │ │ │ │ │ +0004bb80: 6974 6c65 2070 6167 653a 0a0a 2020 2020 itle page:.. │ │ │ │ │ +0004bb90: 2020 2043 6f70 7972 6967 6874 2028 4329 Copyright (C) │ │ │ │ │ +0004bba0: 2020 5945 4152 2020 594f 5552 204e 414d YEAR YOUR NAM │ │ │ │ │ +0004bbb0: 452e 0a20 2020 2020 2020 5065 726d 6973 E.. Permis │ │ │ │ │ +0004bbc0: 7369 6f6e 2069 7320 6772 616e 7465 6420 sion is granted │ │ │ │ │ +0004bbd0: 746f 2063 6f70 792c 2064 6973 7472 6962 to copy, distrib │ │ │ │ │ +0004bbe0: 7574 6520 616e 642f 6f72 206d 6f64 6966 ute and/or modif │ │ │ │ │ +0004bbf0: 7920 7468 6973 2064 6f63 756d 656e 740a y this document. │ │ │ │ │ +0004bc00: 2020 2020 2020 2075 6e64 6572 2074 6865 under the │ │ │ │ │ +0004bc10: 2074 6572 6d73 206f 6620 7468 6520 474e terms of the GN │ │ │ │ │ +0004bc20: 5520 4672 6565 2044 6f63 756d 656e 7461 U Free Documenta │ │ │ │ │ +0004bc30: 7469 6f6e 204c 6963 656e 7365 2c20 5665 tion License, Ve │ │ │ │ │ +0004bc40: 7273 696f 6e20 312e 320a 2020 2020 2020 rsion 1.2. │ │ │ │ │ +0004bc50: 206f 7220 616e 7920 6c61 7465 7220 7665 or any later ve │ │ │ │ │ +0004bc60: 7273 696f 6e20 7075 626c 6973 6865 6420 rsion published │ │ │ │ │ +0004bc70: 6279 2074 6865 2046 7265 6520 536f 6674 by the Free Soft │ │ │ │ │ +0004bc80: 7761 7265 2046 6f75 6e64 6174 696f 6e3b ware Foundation; │ │ │ │ │ +0004bc90: 0a20 2020 2020 2020 7769 7468 206e 6f20 . with no │ │ │ │ │ +0004bca0: 496e 7661 7269 616e 7420 5365 6374 696f Invariant Sectio │ │ │ │ │ +0004bcb0: 6e73 2c20 6e6f 2046 726f 6e74 2d43 6f76 ns, no Front-Cov │ │ │ │ │ +0004bcc0: 6572 2054 6578 7473 2c20 616e 6420 6e6f er Texts, and no │ │ │ │ │ +0004bcd0: 2042 6163 6b2d 436f 7665 720a 2020 2020 Back-Cover. │ │ │ │ │ +0004bce0: 2020 2054 6578 7473 2e20 2041 2063 6f70 Texts. A cop │ │ │ │ │ +0004bcf0: 7920 6f66 2074 6865 206c 6963 656e 7365 y of the license │ │ │ │ │ +0004bd00: 2069 7320 696e 636c 7564 6564 2069 6e20 is included in │ │ │ │ │ +0004bd10: 7468 6520 7365 6374 696f 6e20 656e 7469 the section enti │ │ │ │ │ +0004bd20: 746c 6564 2060 6047 4e55 0a20 2020 2020 tled ``GNU. │ │ │ │ │ +0004bd30: 2020 4672 6565 2044 6f63 756d 656e 7461 Free Documenta │ │ │ │ │ +0004bd40: 7469 6f6e 204c 6963 656e 7365 2727 2e0a tion License''.. │ │ │ │ │ +0004bd50: 0a20 2020 4966 2079 6f75 2068 6176 6520 . If you have │ │ │ │ │ +0004bd60: 496e 7661 7269 616e 7420 5365 6374 696f Invariant Sectio │ │ │ │ │ +0004bd70: 6e73 2c20 4672 6f6e 742d 436f 7665 7220 ns, Front-Cover │ │ │ │ │ +0004bd80: 5465 7874 7320 616e 6420 4261 636b 2d43 Texts and Back-C │ │ │ │ │ +0004bd90: 6f76 6572 0a54 6578 7473 2c20 7265 706c over.Texts, repl │ │ │ │ │ +0004bda0: 6163 6520 7468 6520 2277 6974 682e 2e2e ace the "with... │ │ │ │ │ +0004bdb0: 5465 7874 732e 2220 206c 696e 6520 7769 Texts." line wi │ │ │ │ │ +0004bdc0: 7468 2074 6869 733a 0a0a 2020 2020 2020 th this:.. │ │ │ │ │ +0004bdd0: 2020 2077 6974 6820 7468 6520 496e 7661 with the Inva │ │ │ │ │ +0004bde0: 7269 616e 7420 5365 6374 696f 6e73 2062 riant Sections b │ │ │ │ │ +0004bdf0: 6569 6e67 204c 4953 5420 5448 4549 5220 eing LIST THEIR │ │ │ │ │ +0004be00: 5449 544c 4553 2c20 7769 7468 0a20 2020 TITLES, with. │ │ │ │ │ +0004be10: 2020 2020 2020 7468 6520 4672 6f6e 742d the Front- │ │ │ │ │ +0004be20: 436f 7665 7220 5465 7874 7320 6265 696e Cover Texts bein │ │ │ │ │ +0004be30: 6720 4c49 5354 2c20 616e 6420 7769 7468 g LIST, and with │ │ │ │ │ +0004be40: 2074 6865 2042 6163 6b2d 436f 7665 7220 the Back-Cover │ │ │ │ │ +0004be50: 5465 7874 730a 2020 2020 2020 2020 2062 Texts. b │ │ │ │ │ +0004be60: 6569 6e67 204c 4953 542e 0a0a 2020 2049 eing LIST... I │ │ │ │ │ +0004be70: 6620 796f 7520 6861 7665 2049 6e76 6172 f you have Invar │ │ │ │ │ +0004be80: 6961 6e74 2053 6563 7469 6f6e 7320 7769 iant Sections wi │ │ │ │ │ +0004be90: 7468 6f75 7420 436f 7665 7220 5465 7874 thout Cover Text │ │ │ │ │ +0004bea0: 732c 206f 7220 736f 6d65 206f 7468 6572 s, or some other │ │ │ │ │ +0004beb0: 0a63 6f6d 6269 6e61 7469 6f6e 206f 6620 .combination of │ │ │ │ │ +0004bec0: 7468 6520 7468 7265 652c 206d 6572 6765 the three, merge │ │ │ │ │ +0004bed0: 2074 686f 7365 2074 776f 2061 6c74 6572 those two alter │ │ │ │ │ +0004bee0: 6e61 7469 7665 7320 746f 2073 7569 7420 natives to suit │ │ │ │ │ +0004bef0: 7468 650a 7369 7475 6174 696f 6e2e 0a0a the.situation... │ │ │ │ │ +0004bf00: 2020 2049 6620 796f 7572 2064 6f63 756d If your docum │ │ │ │ │ +0004bf10: 656e 7420 636f 6e74 6169 6e73 206e 6f6e ent contains non │ │ │ │ │ +0004bf20: 7472 6976 6961 6c20 6578 616d 706c 6573 trivial examples │ │ │ │ │ +0004bf30: 206f 6620 7072 6f67 7261 6d20 636f 6465 of program code │ │ │ │ │ +0004bf40: 2c20 7765 0a72 6563 6f6d 6d65 6e64 2072 , we.recommend r │ │ │ │ │ +0004bf50: 656c 6561 7369 6e67 2074 6865 7365 2065 eleasing these e │ │ │ │ │ +0004bf60: 7861 6d70 6c65 7320 696e 2070 6172 616c xamples in paral │ │ │ │ │ +0004bf70: 6c65 6c20 756e 6465 7220 796f 7572 2063 lel under your c │ │ │ │ │ +0004bf80: 686f 6963 6520 6f66 2066 7265 650a 736f hoice of free.so │ │ │ │ │ +0004bf90: 6674 7761 7265 206c 6963 656e 7365 2c20 ftware license, │ │ │ │ │ +0004bfa0: 7375 6368 2061 7320 7468 6520 474e 5520 such as the GNU │ │ │ │ │ +0004bfb0: 4765 6e65 7261 6c20 5075 626c 6963 204c General Public L │ │ │ │ │ +0004bfc0: 6963 656e 7365 2c20 746f 2070 6572 6d69 icense, to permi │ │ │ │ │ +0004bfd0: 740a 7468 6569 7220 7573 6520 696e 2066 t.their use in f │ │ │ │ │ +0004bfe0: 7265 6520 736f 6674 7761 7265 2e0a 0a ree software... │ │ │ ├── ./usr/share/info/grub.info-2.gz │ │ │ │ ├── grub.info-2 │ │ │ │ │ @@ -1,558 +1,558 @@ │ │ │ │ │ 00000000: 5468 6973 2069 7320 6772 7562 2e69 6e66 This is grub.inf │ │ │ │ │ 00000010: 6f2c 2070 726f 6475 6365 6420 6279 206d o, produced by m │ │ │ │ │ 00000020: 616b 6569 6e66 6f20 7665 7273 696f 6e20 akeinfo version │ │ │ │ │ 00000030: 362e 3820 6672 6f6d 2067 7275 622e 7465 6.8 from grub.te │ │ │ │ │ 00000040: 7869 2e0a 0a54 6869 7320 6d61 6e75 616c xi...This manual │ │ │ │ │ 00000050: 2069 7320 666f 7220 474e 5520 4752 5542 is for GNU GRUB │ │ │ │ │ 00000060: 2028 7665 7273 696f 6e20 322e 3036 2c20 (version 2.06, │ │ │ │ │ -00000070: 3132 2046 6562 7275 6172 7920 3230 3235 12 February 2025 │ │ │ │ │ -00000080: 292e 0a0a 2020 2043 6f70 7972 6967 6874 )... Copyright │ │ │ │ │ -00000090: 2028 4329 0a31 3939 392c 3230 3030 2c32 (C).1999,2000,2 │ │ │ │ │ -000000a0: 3030 312c 3230 3032 2c32 3030 342c 3230 001,2002,2004,20 │ │ │ │ │ -000000b0: 3036 2c32 3030 382c 3230 3039 2c32 3031 06,2008,2009,201 │ │ │ │ │ -000000c0: 302c 3230 3131 2c32 3031 322c 3230 3133 0,2011,2012,2013 │ │ │ │ │ -000000d0: 2046 7265 650a 536f 6674 7761 7265 2046 Free.Software F │ │ │ │ │ -000000e0: 6f75 6e64 6174 696f 6e2c 2049 6e63 2e0a oundation, Inc.. │ │ │ │ │ -000000f0: 0a20 2020 2020 5065 726d 6973 7369 6f6e . Permission │ │ │ │ │ -00000100: 2069 7320 6772 616e 7465 6420 746f 2063 is granted to c │ │ │ │ │ -00000110: 6f70 792c 2064 6973 7472 6962 7574 6520 opy, distribute │ │ │ │ │ -00000120: 616e 642f 6f72 206d 6f64 6966 7920 7468 and/or modify th │ │ │ │ │ -00000130: 6973 0a20 2020 2020 646f 6375 6d65 6e74 is. document │ │ │ │ │ -00000140: 2075 6e64 6572 2074 6865 2074 6572 6d73 under the terms │ │ │ │ │ -00000150: 206f 6620 7468 6520 474e 5520 4672 6565 of the GNU Free │ │ │ │ │ -00000160: 2044 6f63 756d 656e 7461 7469 6f6e 204c Documentation L │ │ │ │ │ -00000170: 6963 656e 7365 2c0a 2020 2020 2056 6572 icense,. Ver │ │ │ │ │ -00000180: 7369 6f6e 2031 2e32 206f 7220 616e 7920 sion 1.2 or any │ │ │ │ │ -00000190: 6c61 7465 7220 7665 7273 696f 6e20 7075 later version pu │ │ │ │ │ -000001a0: 626c 6973 6865 6420 6279 2074 6865 2046 blished by the F │ │ │ │ │ -000001b0: 7265 6520 536f 6674 7761 7265 0a20 2020 ree Software. │ │ │ │ │ -000001c0: 2020 466f 756e 6461 7469 6f6e 3b20 7769 Foundation; wi │ │ │ │ │ -000001d0: 7468 206e 6f20 496e 7661 7269 616e 7420 th no Invariant │ │ │ │ │ -000001e0: 5365 6374 696f 6e73 2e0a 494e 464f 2d44 Sections..INFO-D │ │ │ │ │ -000001f0: 4952 2d53 4543 5449 4f4e 204b 6572 6e65 IR-SECTION Kerne │ │ │ │ │ -00000200: 6c0a 5354 4152 542d 494e 464f 2d44 4952 l.START-INFO-DIR │ │ │ │ │ -00000210: 2d45 4e54 5259 0a2a 2047 5255 423a 2028 -ENTRY.* GRUB: ( │ │ │ │ │ -00000220: 6772 7562 292e 2020 2020 2020 2020 2020 grub). │ │ │ │ │ -00000230: 2020 2020 2020 2054 6865 2047 5261 6e64 The GRand │ │ │ │ │ -00000240: 2055 6e69 6669 6564 2042 6f6f 746c 6f61 Unified Bootloa │ │ │ │ │ -00000250: 6465 720a 2a20 6772 7562 2d69 6e73 7461 der.* grub-insta │ │ │ │ │ -00000260: 6c6c 3a20 2867 7275 6229 496e 766f 6b69 ll: (grub)Invoki │ │ │ │ │ -00000270: 6e67 2067 7275 622d 696e 7374 616c 6c2e ng grub-install. │ │ │ │ │ -00000280: 2020 2020 496e 7374 616c 6c20 4752 5542 Install GRUB │ │ │ │ │ -00000290: 206f 6e20 796f 7572 2064 7269 7665 0a2a on your drive.* │ │ │ │ │ -000002a0: 2067 7275 622d 6d6b 636f 6e66 6967 3a20 grub-mkconfig: │ │ │ │ │ -000002b0: 2867 7275 6229 496e 766f 6b69 6e67 2067 (grub)Invoking g │ │ │ │ │ -000002c0: 7275 622d 6d6b 636f 6e66 6967 2e20 2047 rub-mkconfig. G │ │ │ │ │ -000002d0: 656e 6572 6174 6520 4752 5542 2063 6f6e enerate GRUB con │ │ │ │ │ -000002e0: 6669 6775 7261 7469 6f6e 0a2a 2067 7275 figuration.* gru │ │ │ │ │ -000002f0: 622d 6d6b 7061 7373 7764 2d70 626b 6466 b-mkpasswd-pbkdf │ │ │ │ │ -00000300: 323a 2028 6772 7562 2949 6e76 6f6b 696e 2: (grub)Invokin │ │ │ │ │ -00000310: 6720 6772 7562 2d6d 6b70 6173 7377 642d g grub-mkpasswd- │ │ │ │ │ -00000320: 7062 6b64 6632 2e0a 2a20 6772 7562 2d6d pbkdf2..* grub-m │ │ │ │ │ -00000330: 6b72 656c 7061 7468 3a20 2867 7275 6229 krelpath: (grub) │ │ │ │ │ -00000340: 496e 766f 6b69 6e67 2067 7275 622d 6d6b Invoking grub-mk │ │ │ │ │ -00000350: 7265 6c70 6174 682e 0a2a 2067 7275 622d relpath..* grub- │ │ │ │ │ -00000360: 6d6b 7265 7363 7565 3a20 2867 7275 6229 mkrescue: (grub) │ │ │ │ │ -00000370: 496e 766f 6b69 6e67 2067 7275 622d 6d6b Invoking grub-mk │ │ │ │ │ -00000380: 7265 7363 7565 2e20 204d 616b 6520 6120 rescue. Make a │ │ │ │ │ -00000390: 4752 5542 2072 6573 6375 6520 696d 6167 GRUB rescue imag │ │ │ │ │ -000003a0: 650a 2a20 6772 7562 2d6d 6f75 6e74 3a20 e.* grub-mount: │ │ │ │ │ -000003b0: 2867 7275 6229 496e 766f 6b69 6e67 2067 (grub)Invoking g │ │ │ │ │ -000003c0: 7275 622d 6d6f 756e 742e 2020 2020 2020 rub-mount. │ │ │ │ │ -000003d0: 2020 4d6f 756e 7420 6120 6669 6c65 2073 Mount a file s │ │ │ │ │ -000003e0: 7973 7465 6d20 7573 696e 6720 4752 5542 ystem using GRUB │ │ │ │ │ -000003f0: 0a2a 2067 7275 622d 7072 6f62 653a 2028 .* grub-probe: ( │ │ │ │ │ -00000400: 6772 7562 2949 6e76 6f6b 696e 6720 6772 grub)Invoking gr │ │ │ │ │ -00000410: 7562 2d70 726f 6265 2e20 2020 2020 2020 ub-probe. │ │ │ │ │ -00000420: 2050 726f 6265 2064 6576 6963 6520 696e Probe device in │ │ │ │ │ -00000430: 666f 726d 6174 696f 6e0a 2a20 6772 7562 formation.* grub │ │ │ │ │ -00000440: 2d73 6372 6970 742d 6368 6563 6b3a 2028 -script-check: ( │ │ │ │ │ -00000450: 6772 7562 2949 6e76 6f6b 696e 6720 6772 grub)Invoking gr │ │ │ │ │ -00000460: 7562 2d73 6372 6970 742d 6368 6563 6b2e ub-script-check. │ │ │ │ │ -00000470: 0a45 4e44 2d49 4e46 4f2d 4449 522d 454e .END-INFO-DIR-EN │ │ │ │ │ -00000480: 5452 590a 0a1f 0a46 696c 653a 2067 7275 TRY....File: gru │ │ │ │ │ -00000490: 622e 696e 666f 2c20 204e 6f64 653a 2049 b.info, Node: I │ │ │ │ │ -000004a0: 6e64 6578 2c20 2050 7265 763a 2043 6f70 ndex, Prev: Cop │ │ │ │ │ -000004b0: 7969 6e67 2054 6869 7320 4d61 6e75 616c ying This Manual │ │ │ │ │ -000004c0: 2c20 2055 703a 2054 6f70 0a0a 496e 6465 , Up: Top..Inde │ │ │ │ │ -000004d0: 780a 2a2a 2a2a 2a0a 0a00 085b 696e 6465 x.*****....[inde │ │ │ │ │ -000004e0: 7800 085d 0a2a 204d 656e 753a 0a0a 2a20 x..].* Menu:..* │ │ │ │ │ -000004f0: 5b3a 2020 2020 2020 2020 2020 2020 2020 [: │ │ │ │ │ +00000070: 3131 204a 616e 7561 7279 2032 3032 3429 11 January 2024) │ │ │ │ │ +00000080: 2e0a 0a20 2020 436f 7079 7269 6768 7420 ... Copyright │ │ │ │ │ +00000090: 2843 290a 3139 3939 2c32 3030 302c 3230 (C).1999,2000,20 │ │ │ │ │ +000000a0: 3031 2c32 3030 322c 3230 3034 2c32 3030 01,2002,2004,200 │ │ │ │ │ +000000b0: 362c 3230 3038 2c32 3030 392c 3230 3130 6,2008,2009,2010 │ │ │ │ │ +000000c0: 2c32 3031 312c 3230 3132 2c32 3031 3320 ,2011,2012,2013 │ │ │ │ │ +000000d0: 4672 6565 0a53 6f66 7477 6172 6520 466f Free.Software Fo │ │ │ │ │ +000000e0: 756e 6461 7469 6f6e 2c20 496e 632e 0a0a undation, Inc... │ │ │ │ │ +000000f0: 2020 2020 2050 6572 6d69 7373 696f 6e20 Permission │ │ │ │ │ +00000100: 6973 2067 7261 6e74 6564 2074 6f20 636f is granted to co │ │ │ │ │ +00000110: 7079 2c20 6469 7374 7269 6275 7465 2061 py, distribute a │ │ │ │ │ +00000120: 6e64 2f6f 7220 6d6f 6469 6679 2074 6869 nd/or modify thi │ │ │ │ │ +00000130: 730a 2020 2020 2064 6f63 756d 656e 7420 s. document │ │ │ │ │ +00000140: 756e 6465 7220 7468 6520 7465 726d 7320 under the terms │ │ │ │ │ +00000150: 6f66 2074 6865 2047 4e55 2046 7265 6520 of the GNU Free │ │ │ │ │ +00000160: 446f 6375 6d65 6e74 6174 696f 6e20 4c69 Documentation Li │ │ │ │ │ +00000170: 6365 6e73 652c 0a20 2020 2020 5665 7273 cense,. Vers │ │ │ │ │ +00000180: 696f 6e20 312e 3220 6f72 2061 6e79 206c ion 1.2 or any l │ │ │ │ │ +00000190: 6174 6572 2076 6572 7369 6f6e 2070 7562 ater version pub │ │ │ │ │ +000001a0: 6c69 7368 6564 2062 7920 7468 6520 4672 lished by the Fr │ │ │ │ │ +000001b0: 6565 2053 6f66 7477 6172 650a 2020 2020 ee Software. │ │ │ │ │ +000001c0: 2046 6f75 6e64 6174 696f 6e3b 2077 6974 Foundation; wit │ │ │ │ │ +000001d0: 6820 6e6f 2049 6e76 6172 6961 6e74 2053 h no Invariant S │ │ │ │ │ +000001e0: 6563 7469 6f6e 732e 0a49 4e46 4f2d 4449 ections..INFO-DI │ │ │ │ │ +000001f0: 522d 5345 4354 494f 4e20 4b65 726e 656c R-SECTION Kernel │ │ │ │ │ +00000200: 0a53 5441 5254 2d49 4e46 4f2d 4449 522d .START-INFO-DIR- │ │ │ │ │ +00000210: 454e 5452 590a 2a20 4752 5542 3a20 2867 ENTRY.* GRUB: (g │ │ │ │ │ +00000220: 7275 6229 2e20 2020 2020 2020 2020 2020 rub). │ │ │ │ │ +00000230: 2020 2020 2020 5468 6520 4752 616e 6420 The GRand │ │ │ │ │ +00000240: 556e 6966 6965 6420 426f 6f74 6c6f 6164 Unified Bootload │ │ │ │ │ +00000250: 6572 0a2a 2067 7275 622d 696e 7374 616c er.* grub-instal │ │ │ │ │ +00000260: 6c3a 2028 6772 7562 2949 6e76 6f6b 696e l: (grub)Invokin │ │ │ │ │ +00000270: 6720 6772 7562 2d69 6e73 7461 6c6c 2e20 g grub-install. │ │ │ │ │ +00000280: 2020 2049 6e73 7461 6c6c 2047 5255 4220 Install GRUB │ │ │ │ │ +00000290: 6f6e 2079 6f75 7220 6472 6976 650a 2a20 on your drive.* │ │ │ │ │ +000002a0: 6772 7562 2d6d 6b63 6f6e 6669 673a 2028 grub-mkconfig: ( │ │ │ │ │ +000002b0: 6772 7562 2949 6e76 6f6b 696e 6720 6772 grub)Invoking gr │ │ │ │ │ +000002c0: 7562 2d6d 6b63 6f6e 6669 672e 2020 4765 ub-mkconfig. Ge │ │ │ │ │ +000002d0: 6e65 7261 7465 2047 5255 4220 636f 6e66 nerate GRUB conf │ │ │ │ │ +000002e0: 6967 7572 6174 696f 6e0a 2a20 6772 7562 iguration.* grub │ │ │ │ │ +000002f0: 2d6d 6b70 6173 7377 642d 7062 6b64 6632 -mkpasswd-pbkdf2 │ │ │ │ │ +00000300: 3a20 2867 7275 6229 496e 766f 6b69 6e67 : (grub)Invoking │ │ │ │ │ +00000310: 2067 7275 622d 6d6b 7061 7373 7764 2d70 grub-mkpasswd-p │ │ │ │ │ +00000320: 626b 6466 322e 0a2a 2067 7275 622d 6d6b bkdf2..* grub-mk │ │ │ │ │ +00000330: 7265 6c70 6174 683a 2028 6772 7562 2949 relpath: (grub)I │ │ │ │ │ +00000340: 6e76 6f6b 696e 6720 6772 7562 2d6d 6b72 nvoking grub-mkr │ │ │ │ │ +00000350: 656c 7061 7468 2e0a 2a20 6772 7562 2d6d elpath..* grub-m │ │ │ │ │ +00000360: 6b72 6573 6375 653a 2028 6772 7562 2949 krescue: (grub)I │ │ │ │ │ +00000370: 6e76 6f6b 696e 6720 6772 7562 2d6d 6b72 nvoking grub-mkr │ │ │ │ │ +00000380: 6573 6375 652e 2020 4d61 6b65 2061 2047 escue. Make a G │ │ │ │ │ +00000390: 5255 4220 7265 7363 7565 2069 6d61 6765 RUB rescue image │ │ │ │ │ +000003a0: 0a2a 2067 7275 622d 6d6f 756e 743a 2028 .* grub-mount: ( │ │ │ │ │ +000003b0: 6772 7562 2949 6e76 6f6b 696e 6720 6772 grub)Invoking gr │ │ │ │ │ +000003c0: 7562 2d6d 6f75 6e74 2e20 2020 2020 2020 ub-mount. │ │ │ │ │ +000003d0: 204d 6f75 6e74 2061 2066 696c 6520 7379 Mount a file sy │ │ │ │ │ +000003e0: 7374 656d 2075 7369 6e67 2047 5255 420a stem using GRUB. │ │ │ │ │ +000003f0: 2a20 6772 7562 2d70 726f 6265 3a20 2867 * grub-probe: (g │ │ │ │ │ +00000400: 7275 6229 496e 766f 6b69 6e67 2067 7275 rub)Invoking gru │ │ │ │ │ +00000410: 622d 7072 6f62 652e 2020 2020 2020 2020 b-probe. │ │ │ │ │ +00000420: 5072 6f62 6520 6465 7669 6365 2069 6e66 Probe device inf │ │ │ │ │ +00000430: 6f72 6d61 7469 6f6e 0a2a 2067 7275 622d ormation.* grub- │ │ │ │ │ +00000440: 7363 7269 7074 2d63 6865 636b 3a20 2867 script-check: (g │ │ │ │ │ +00000450: 7275 6229 496e 766f 6b69 6e67 2067 7275 rub)Invoking gru │ │ │ │ │ +00000460: 622d 7363 7269 7074 2d63 6865 636b 2e0a b-script-check.. │ │ │ │ │ +00000470: 454e 442d 494e 464f 2d44 4952 2d45 4e54 END-INFO-DIR-ENT │ │ │ │ │ +00000480: 5259 0a0a 1f0a 4669 6c65 3a20 6772 7562 RY....File: grub │ │ │ │ │ +00000490: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 496e .info, Node: In │ │ │ │ │ +000004a0: 6465 782c 2020 5072 6576 3a20 436f 7079 dex, Prev: Copy │ │ │ │ │ +000004b0: 696e 6720 5468 6973 204d 616e 7561 6c2c ing This Manual, │ │ │ │ │ +000004c0: 2020 5570 3a20 546f 700a 0a49 6e64 6578 Up: Top..Index │ │ │ │ │ +000004d0: 0a2a 2a2a 2a2a 0a0a 0008 5b69 6e64 6578 .*****....[index │ │ │ │ │ +000004e0: 0008 5d0a 2a20 4d65 6e75 3a0a 0a2a 205b ..].* Menu:..* [ │ │ │ │ │ +000004f0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ 00000500: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000510: 2020 2020 2020 205b 2e20 2020 2020 2020 [. │ │ │ │ │ -00000520: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ -00000530: 696e 6520 3629 0a2a 2061 6370 693a 2020 ine 6).* acpi: │ │ │ │ │ +00000510: 2020 2020 2020 5b2e 2020 2020 2020 2020 [. │ │ │ │ │ +00000520: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ +00000530: 6e65 2036 290a 2a20 6163 7069 3a20 2020 ne 6).* acpi: │ │ │ │ │ 00000540: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000550: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000560: 6163 7069 2e20 2020 2020 2020 2020 2020 acpi. │ │ │ │ │ -00000570: 2020 2020 2020 2028 6c69 6e65 2036 290a (line 6). │ │ │ │ │ -00000580: 2a20 6175 7468 656e 7469 6361 7465 3a20 * authenticate: │ │ │ │ │ +00000550: 2020 2020 2020 2020 2020 2020 2020 2061 a │ │ │ │ │ +00000560: 6370 692e 2020 2020 2020 2020 2020 2020 cpi. │ │ │ │ │ +00000570: 2020 2020 2020 286c 696e 6520 3629 0a2a (line 6).* │ │ │ │ │ +00000580: 2061 7574 6865 6e74 6963 6174 653a 2020 authenticate: │ │ │ │ │ 00000590: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000005a0: 2020 2020 2020 2020 2061 7574 6865 6e74 authent │ │ │ │ │ -000005b0: 6963 6174 652e 2020 2020 2020 2020 2020 icate. │ │ │ │ │ -000005c0: 286c 696e 6520 3629 0a2a 2062 6163 6b67 (line 6).* backg │ │ │ │ │ -000005d0: 726f 756e 645f 636f 6c6f 723a 2020 2020 round_color: │ │ │ │ │ +000005a0: 2020 2020 2020 2020 6175 7468 656e 7469 authenti │ │ │ │ │ +000005b0: 6361 7465 2e20 2020 2020 2020 2020 2028 cate. ( │ │ │ │ │ +000005c0: 6c69 6e65 2036 290a 2a20 6261 636b 6772 line 6).* backgr │ │ │ │ │ +000005d0: 6f75 6e64 5f63 6f6c 6f72 3a20 2020 2020 ound_color: │ │ │ │ │ 000005e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000005f0: 2020 6261 636b 6772 6f75 6e64 5f63 6f6c background_col │ │ │ │ │ -00000600: 6f72 2e20 2020 2020 2028 6c69 6e65 2036 or. (line 6 │ │ │ │ │ -00000610: 290a 2a20 6261 636b 6772 6f75 6e64 5f69 ).* background_i │ │ │ │ │ -00000620: 6d61 6765 3a20 2020 2020 2020 2020 2020 mage: │ │ │ │ │ -00000630: 2020 2020 2020 2020 2020 2062 6163 6b67 backg │ │ │ │ │ -00000640: 726f 756e 645f 696d 6167 652e 2020 2020 round_image. │ │ │ │ │ -00000650: 2020 286c 696e 6520 3629 0a2a 2062 6164 (line 6).* bad │ │ │ │ │ -00000660: 7261 6d3a 2020 2020 2020 2020 2020 2020 ram: │ │ │ │ │ +000005f0: 2062 6163 6b67 726f 756e 645f 636f 6c6f background_colo │ │ │ │ │ +00000600: 722e 2020 2020 2020 286c 696e 6520 3629 r. (line 6) │ │ │ │ │ +00000610: 0a2a 2062 6163 6b67 726f 756e 645f 696d .* background_im │ │ │ │ │ +00000620: 6167 653a 2020 2020 2020 2020 2020 2020 age: │ │ │ │ │ +00000630: 2020 2020 2020 2020 2020 6261 636b 6772 backgr │ │ │ │ │ +00000640: 6f75 6e64 5f69 6d61 6765 2e20 2020 2020 ound_image. │ │ │ │ │ +00000650: 2028 6c69 6e65 2036 290a 2a20 6261 6472 (line 6).* badr │ │ │ │ │ +00000660: 616d 3a20 2020 2020 2020 2020 2020 2020 am: │ │ │ │ │ 00000670: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000680: 2020 2020 6261 6472 616d 2e20 2020 2020 badram. │ │ │ │ │ -00000690: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -000006a0: 2036 290a 2a20 626c 6f63 6b6c 6973 743a 6).* blocklist: │ │ │ │ │ +00000680: 2020 2062 6164 7261 6d2e 2020 2020 2020 badram. │ │ │ │ │ +00000690: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +000006a0: 3629 0a2a 2062 6c6f 636b 6c69 7374 3a20 6).* blocklist: │ │ │ │ │ 000006b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000006c0: 2020 2020 2020 2020 2020 2020 2062 6c6f blo │ │ │ │ │ -000006d0: 636b 6c69 7374 2e20 2020 2020 2020 2020 cklist. │ │ │ │ │ -000006e0: 2020 2020 286c 696e 6520 3629 0a2a 2062 (line 6).* b │ │ │ │ │ -000006f0: 6f6f 743a 2020 2020 2020 2020 2020 2020 oot: │ │ │ │ │ +000006c0: 2020 2020 2020 2020 2020 2020 626c 6f63 bloc │ │ │ │ │ +000006d0: 6b6c 6973 742e 2020 2020 2020 2020 2020 klist. │ │ │ │ │ +000006e0: 2020 2028 6c69 6e65 2036 290a 2a20 626f (line 6).* bo │ │ │ │ │ +000006f0: 6f74 3a20 2020 2020 2020 2020 2020 2020 ot: │ │ │ │ │ 00000700: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000710: 2020 2020 2020 626f 6f74 2e20 2020 2020 boot. │ │ │ │ │ -00000720: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -00000730: 6e65 2036 290a 2a20 6361 743a 2020 2020 ne 6).* cat: │ │ │ │ │ +00000710: 2020 2020 2062 6f6f 742e 2020 2020 2020 boot. │ │ │ │ │ +00000720: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +00000730: 6520 3629 0a2a 2063 6174 3a20 2020 2020 e 6).* cat: │ │ │ │ │ 00000740: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000750: 2020 2020 2020 2020 2020 2020 2020 2063 c │ │ │ │ │ -00000760: 6174 2e20 2020 2020 2020 2020 2020 2020 at. │ │ │ │ │ -00000770: 2020 2020 2020 286c 696e 6520 3629 0a2a (line 6).* │ │ │ │ │ -00000780: 2063 6861 696e 6c6f 6164 6572 3a20 2020 chainloader: │ │ │ │ │ +00000750: 2020 2020 2020 2020 2020 2020 2020 6361 ca │ │ │ │ │ +00000760: 742e 2020 2020 2020 2020 2020 2020 2020 t. │ │ │ │ │ +00000770: 2020 2020 2028 6c69 6e65 2036 290a 2a20 (line 6).* │ │ │ │ │ +00000780: 6368 6169 6e6c 6f61 6465 723a 2020 2020 chainloader: │ │ │ │ │ 00000790: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000007a0: 2020 2020 2020 2020 6368 6169 6e6c 6f61 chainloa │ │ │ │ │ -000007b0: 6465 722e 2020 2020 2020 2020 2020 2028 der. ( │ │ │ │ │ -000007c0: 6c69 6e65 2036 290a 2a20 636c 6561 723a line 6).* clear: │ │ │ │ │ +000007a0: 2020 2020 2020 2063 6861 696e 6c6f 6164 chainload │ │ │ │ │ +000007b0: 6572 2e20 2020 2020 2020 2020 2020 286c er. (l │ │ │ │ │ +000007c0: 696e 6520 3629 0a2a 2063 6c65 6172 3a20 ine 6).* clear: │ │ │ │ │ 000007d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000007e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000007f0: 2063 6c65 6172 2e20 2020 2020 2020 2020 clear. │ │ │ │ │ -00000800: 2020 2020 2020 2020 286c 696e 6520 3629 (line 6) │ │ │ │ │ -00000810: 0a2a 2043 4d4f 533a 2020 2020 2020 2020 .* CMOS: │ │ │ │ │ +000007f0: 636c 6561 722e 2020 2020 2020 2020 2020 clear. │ │ │ │ │ +00000800: 2020 2020 2020 2028 6c69 6e65 2036 290a (line 6). │ │ │ │ │ +00000810: 2a20 434d 4f53 3a20 2020 2020 2020 2020 * CMOS: │ │ │ │ │ 00000820: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000830: 2020 2020 2020 2020 2020 636d 6f73 6475 cmosdu │ │ │ │ │ -00000840: 6d70 2e20 2020 2020 2020 2020 2020 2020 mp. │ │ │ │ │ -00000850: 2028 6c69 6e65 2036 290a 2a20 636d 6f73 (line 6).* cmos │ │ │ │ │ -00000860: 636c 6561 6e3a 2020 2020 2020 2020 2020 clean: │ │ │ │ │ +00000830: 2020 2020 2020 2020 2063 6d6f 7364 756d cmosdum │ │ │ │ │ +00000840: 702e 2020 2020 2020 2020 2020 2020 2020 p. │ │ │ │ │ +00000850: 286c 696e 6520 3629 0a2a 2063 6d6f 7363 (line 6).* cmosc │ │ │ │ │ +00000860: 6c65 616e 3a20 2020 2020 2020 2020 2020 lean: │ │ │ │ │ 00000870: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000880: 2020 2063 6d6f 7363 6c65 616e 2e20 2020 cmosclean. │ │ │ │ │ -00000890: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -000008a0: 3629 0a2a 2063 6d6f 7374 6573 743a 2020 6).* cmostest: │ │ │ │ │ +00000880: 2020 636d 6f73 636c 6561 6e2e 2020 2020 cmosclean. │ │ │ │ │ +00000890: 2020 2020 2020 2020 2028 6c69 6e65 2036 (line 6 │ │ │ │ │ +000008a0: 290a 2a20 636d 6f73 7465 7374 3a20 2020 ).* cmostest: │ │ │ │ │ 000008b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000008c0: 2020 2020 2020 2020 2020 2020 636d 6f73 cmos │ │ │ │ │ -000008d0: 7465 7374 2e20 2020 2020 2020 2020 2020 test. │ │ │ │ │ -000008e0: 2020 2028 6c69 6e65 2036 290a 2a20 636d (line 6).* cm │ │ │ │ │ -000008f0: 703a 2020 2020 2020 2020 2020 2020 2020 p: │ │ │ │ │ +000008c0: 2020 2020 2020 2020 2020 2063 6d6f 7374 cmost │ │ │ │ │ +000008d0: 6573 742e 2020 2020 2020 2020 2020 2020 est. │ │ │ │ │ +000008e0: 2020 286c 696e 6520 3629 0a2a 2063 6d70 (line 6).* cmp │ │ │ │ │ +000008f0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ 00000900: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000910: 2020 2020 2063 6d70 2e20 2020 2020 2020 cmp. │ │ │ │ │ -00000920: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ -00000930: 6520 3629 0a2a 2063 6f6e 6669 6766 696c e 6).* configfil │ │ │ │ │ -00000940: 653a 2020 2020 2020 2020 2020 2020 2020 e: │ │ │ │ │ -00000950: 2020 2020 2020 2020 2020 2020 2020 636f co │ │ │ │ │ -00000960: 6e66 6967 6669 6c65 2e20 2020 2020 2020 nfigfile. │ │ │ │ │ -00000970: 2020 2020 2028 6c69 6e65 2036 290a 2a20 (line 6).* │ │ │ │ │ -00000980: 6370 7569 643a 2020 2020 2020 2020 2020 cpuid: │ │ │ │ │ +00000910: 2020 2020 636d 702e 2020 2020 2020 2020 cmp. │ │ │ │ │ +00000920: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +00000930: 2036 290a 2a20 636f 6e66 6967 6669 6c65 6).* configfile │ │ │ │ │ +00000940: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00000950: 2020 2020 2020 2020 2020 2020 2063 6f6e con │ │ │ │ │ +00000960: 6669 6766 696c 652e 2020 2020 2020 2020 figfile. │ │ │ │ │ +00000970: 2020 2020 286c 696e 6520 3629 0a2a 2063 (line 6).* c │ │ │ │ │ +00000980: 7075 6964 3a20 2020 2020 2020 2020 2020 puid: │ │ │ │ │ 00000990: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000009a0: 2020 2020 2020 2063 7075 6964 2e20 2020 cpuid. │ │ │ │ │ -000009b0: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ -000009c0: 696e 6520 3629 0a2a 2063 7263 3a20 2020 ine 6).* crc: │ │ │ │ │ +000009a0: 2020 2020 2020 6370 7569 642e 2020 2020 cpuid. │ │ │ │ │ +000009b0: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ +000009c0: 6e65 2036 290a 2a20 6372 633a 2020 2020 ne 6).* crc: │ │ │ │ │ 000009d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000009e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000009f0: 6372 632e 2020 2020 2020 2020 2020 2020 crc. │ │ │ │ │ -00000a00: 2020 2020 2020 2028 6c69 6e65 2036 290a (line 6). │ │ │ │ │ -00000a10: 2a20 6372 7970 746f 6d6f 756e 743a 2020 * cryptomount: │ │ │ │ │ +000009e0: 2020 2020 2020 2020 2020 2020 2020 2063 c │ │ │ │ │ +000009f0: 7263 2e20 2020 2020 2020 2020 2020 2020 rc. │ │ │ │ │ +00000a00: 2020 2020 2020 286c 696e 6520 3629 0a2a (line 6).* │ │ │ │ │ +00000a10: 2063 7279 7074 6f6d 6f75 6e74 3a20 2020 cryptomount: │ │ │ │ │ 00000a20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000a30: 2020 2020 2020 2020 2063 7279 7074 6f6d cryptom │ │ │ │ │ -00000a40: 6f75 6e74 2e20 2020 2020 2020 2020 2020 ount. │ │ │ │ │ -00000a50: 286c 696e 6520 3629 0a2a 2063 7574 6d65 (line 6).* cutme │ │ │ │ │ -00000a60: 6d3a 2020 2020 2020 2020 2020 2020 2020 m: │ │ │ │ │ +00000a30: 2020 2020 2020 2020 6372 7970 746f 6d6f cryptomo │ │ │ │ │ +00000a40: 756e 742e 2020 2020 2020 2020 2020 2028 unt. ( │ │ │ │ │ +00000a50: 6c69 6e65 2036 290a 2a20 6375 746d 656d line 6).* cutmem │ │ │ │ │ +00000a60: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ 00000a70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000a80: 2020 6375 746d 656d 2e20 2020 2020 2020 cutmem. │ │ │ │ │ -00000a90: 2020 2020 2020 2020 2028 6c69 6e65 2036 (line 6 │ │ │ │ │ -00000aa0: 290a 2a20 6461 7465 3a20 2020 2020 2020 ).* date: │ │ │ │ │ +00000a80: 2063 7574 6d65 6d2e 2020 2020 2020 2020 cutmem. │ │ │ │ │ +00000a90: 2020 2020 2020 2020 286c 696e 6520 3629 (line 6) │ │ │ │ │ +00000aa0: 0a2a 2064 6174 653a 2020 2020 2020 2020 .* date: │ │ │ │ │ 00000ab0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000ac0: 2020 2020 2020 2020 2020 2064 6174 652e date. │ │ │ │ │ +00000ac0: 2020 2020 2020 2020 2020 6461 7465 2e20 date. │ │ │ │ │ 00000ad0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000ae0: 2020 286c 696e 6520 3629 0a2a 2064 6576 (line 6).* dev │ │ │ │ │ -00000af0: 6963 6574 7265 653a 2020 2020 2020 2020 icetree: │ │ │ │ │ +00000ae0: 2028 6c69 6e65 2036 290a 2a20 6465 7669 (line 6).* devi │ │ │ │ │ +00000af0: 6365 7472 6565 3a20 2020 2020 2020 2020 cetree: │ │ │ │ │ 00000b00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000b10: 2020 2020 6465 7669 6365 7472 6565 2e20 devicetree. │ │ │ │ │ -00000b20: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -00000b30: 2036 290a 2a20 6469 7374 7275 7374 3a20 6).* distrust: │ │ │ │ │ +00000b10: 2020 2064 6576 6963 6574 7265 652e 2020 devicetree. │ │ │ │ │ +00000b20: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +00000b30: 3629 0a2a 2064 6973 7472 7573 743a 2020 6).* distrust: │ │ │ │ │ 00000b40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000b50: 2020 2020 2020 2020 2020 2020 2064 6973 dis │ │ │ │ │ -00000b60: 7472 7573 742e 2020 2020 2020 2020 2020 trust. │ │ │ │ │ -00000b70: 2020 2020 286c 696e 6520 3629 0a2a 2064 (line 6).* d │ │ │ │ │ -00000b80: 7269 7665 6d61 703a 2020 2020 2020 2020 rivemap: │ │ │ │ │ +00000b50: 2020 2020 2020 2020 2020 2020 6469 7374 dist │ │ │ │ │ +00000b60: 7275 7374 2e20 2020 2020 2020 2020 2020 rust. │ │ │ │ │ +00000b70: 2020 2028 6c69 6e65 2036 290a 2a20 6472 (line 6).* dr │ │ │ │ │ +00000b80: 6976 656d 6170 3a20 2020 2020 2020 2020 ivemap: │ │ │ │ │ 00000b90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000ba0: 2020 2020 2020 6472 6976 656d 6170 2e20 drivemap. │ │ │ │ │ -00000bb0: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -00000bc0: 6e65 2036 290a 2a20 6563 686f 3a20 2020 ne 6).* echo: │ │ │ │ │ +00000ba0: 2020 2020 2064 7269 7665 6d61 702e 2020 drivemap. │ │ │ │ │ +00000bb0: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +00000bc0: 6520 3629 0a2a 2065 6368 6f3a 2020 2020 e 6).* echo: │ │ │ │ │ 00000bd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000be0: 2020 2020 2020 2020 2020 2020 2020 2065 e │ │ │ │ │ -00000bf0: 6368 6f2e 2020 2020 2020 2020 2020 2020 cho. │ │ │ │ │ -00000c00: 2020 2020 2020 286c 696e 6520 3629 0a2a (line 6).* │ │ │ │ │ -00000c10: 2065 7661 6c3a 2020 2020 2020 2020 2020 eval: │ │ │ │ │ +00000be0: 2020 2020 2020 2020 2020 2020 2020 6563 ec │ │ │ │ │ +00000bf0: 686f 2e20 2020 2020 2020 2020 2020 2020 ho. │ │ │ │ │ +00000c00: 2020 2020 2028 6c69 6e65 2036 290a 2a20 (line 6).* │ │ │ │ │ +00000c10: 6576 616c 3a20 2020 2020 2020 2020 2020 eval: │ │ │ │ │ 00000c20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000c30: 2020 2020 2020 2020 6576 616c 2e20 2020 eval. │ │ │ │ │ -00000c40: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ │ -00000c50: 6c69 6e65 2036 290a 2a20 6578 706f 7274 line 6).* export │ │ │ │ │ -00000c60: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00000c30: 2020 2020 2020 2065 7661 6c2e 2020 2020 eval. │ │ │ │ │ +00000c40: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ +00000c50: 696e 6520 3629 0a2a 2065 7870 6f72 743a ine 6).* export: │ │ │ │ │ +00000c60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00000c70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000c80: 2065 7870 6f72 742e 2020 2020 2020 2020 export. │ │ │ │ │ -00000c90: 2020 2020 2020 2020 286c 696e 6520 3629 (line 6) │ │ │ │ │ -00000ca0: 0a2a 2066 616c 7365 3a20 2020 2020 2020 .* false: │ │ │ │ │ +00000c80: 6578 706f 7274 2e20 2020 2020 2020 2020 export. │ │ │ │ │ +00000c90: 2020 2020 2020 2028 6c69 6e65 2036 290a (line 6). │ │ │ │ │ +00000ca0: 2a20 6661 6c73 653a 2020 2020 2020 2020 * false: │ │ │ │ │ 00000cb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000cc0: 2020 2020 2020 2020 2020 6661 6c73 652e false. │ │ │ │ │ +00000cc0: 2020 2020 2020 2020 2066 616c 7365 2e20 false. │ │ │ │ │ 00000cd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000ce0: 2028 6c69 6e65 2036 290a 2a20 4644 4c2c (line 6).* FDL, │ │ │ │ │ -00000cf0: 2047 4e55 2046 7265 6520 446f 6375 6d65 GNU Free Docume │ │ │ │ │ -00000d00: 6e74 6174 696f 6e20 4c69 6365 6e73 653a ntation License: │ │ │ │ │ -00000d10: 2020 2047 4e55 2046 7265 6520 446f 6375 GNU Free Docu │ │ │ │ │ -00000d20: 6d65 6e74 6174 696f 6e20 4c69 6365 6e73 mentation Licens │ │ │ │ │ -00000d30: 652e 0a20 2020 2020 2020 2020 2020 2020 e.. │ │ │ │ │ +00000ce0: 286c 696e 6520 3629 0a2a 2046 444c 2c20 (line 6).* FDL, │ │ │ │ │ +00000cf0: 474e 5520 4672 6565 2044 6f63 756d 656e GNU Free Documen │ │ │ │ │ +00000d00: 7461 7469 6f6e 204c 6963 656e 7365 3a20 tation License: │ │ │ │ │ +00000d10: 2020 474e 5520 4672 6565 2044 6f63 756d GNU Free Docum │ │ │ │ │ +00000d20: 656e 7461 7469 6f6e 204c 6963 656e 7365 entation License │ │ │ │ │ +00000d30: 2e0a 2020 2020 2020 2020 2020 2020 2020 .. │ │ │ │ │ 00000d40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00000d50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00000d60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000d70: 2020 2028 6c69 6e65 2036 290a 2a20 6765 (line 6).* ge │ │ │ │ │ -00000d80: 7474 6578 743a 2020 2020 2020 2020 2020 ttext: │ │ │ │ │ +00000d70: 2020 286c 696e 6520 3629 0a2a 2067 6574 (line 6).* get │ │ │ │ │ +00000d80: 7465 7874 3a20 2020 2020 2020 2020 2020 text: │ │ │ │ │ 00000d90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000da0: 2020 2020 2067 6574 7465 7874 2e20 2020 gettext. │ │ │ │ │ -00000db0: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ -00000dc0: 6520 3629 0a2a 2067 7074 7379 6e63 3a20 e 6).* gptsync: │ │ │ │ │ +00000da0: 2020 2020 6765 7474 6578 742e 2020 2020 gettext. │ │ │ │ │ +00000db0: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +00000dc0: 2036 290a 2a20 6770 7473 796e 633a 2020 6).* gptsync: │ │ │ │ │ 00000dd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000de0: 2020 2020 2020 2020 2020 2020 2020 6770 gp │ │ │ │ │ -00000df0: 7473 796e 632e 2020 2020 2020 2020 2020 tsync. │ │ │ │ │ -00000e00: 2020 2020 2028 6c69 6e65 2036 290a 2a20 (line 6).* │ │ │ │ │ -00000e10: 6861 6c74 3a20 2020 2020 2020 2020 2020 halt: │ │ │ │ │ +00000de0: 2020 2020 2020 2020 2020 2020 2067 7074 gpt │ │ │ │ │ +00000df0: 7379 6e63 2e20 2020 2020 2020 2020 2020 sync. │ │ │ │ │ +00000e00: 2020 2020 286c 696e 6520 3629 0a2a 2068 (line 6).* h │ │ │ │ │ +00000e10: 616c 743a 2020 2020 2020 2020 2020 2020 alt: │ │ │ │ │ 00000e20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000e30: 2020 2020 2020 2068 616c 742e 2020 2020 halt. │ │ │ │ │ -00000e40: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ -00000e50: 696e 6520 3629 0a2a 2068 6173 6873 756d ine 6).* hashsum │ │ │ │ │ -00000e60: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -00000e70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000e80: 6861 7368 7375 6d2e 2020 2020 2020 2020 hashsum. │ │ │ │ │ -00000e90: 2020 2020 2020 2028 6c69 6e65 2036 290a (line 6). │ │ │ │ │ -00000ea0: 2a20 6865 6c70 3a20 2020 2020 2020 2020 * help: │ │ │ │ │ +00000e30: 2020 2020 2020 6861 6c74 2e20 2020 2020 halt. │ │ │ │ │ +00000e40: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ +00000e50: 6e65 2036 290a 2a20 6861 7368 7375 6d3a ne 6).* hashsum: │ │ │ │ │ +00000e60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00000e70: 2020 2020 2020 2020 2020 2020 2020 2068 h │ │ │ │ │ +00000e80: 6173 6873 756d 2e20 2020 2020 2020 2020 ashsum. │ │ │ │ │ +00000e90: 2020 2020 2020 286c 696e 6520 3629 0a2a (line 6).* │ │ │ │ │ +00000ea0: 2068 656c 703a 2020 2020 2020 2020 2020 help: │ │ │ │ │ 00000eb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000ec0: 2020 2020 2020 2020 2068 656c 702e 2020 help. │ │ │ │ │ -00000ed0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000ee0: 286c 696e 6520 3629 0a2a 2069 6e69 7472 (line 6).* initr │ │ │ │ │ -00000ef0: 643a 2020 2020 2020 2020 2020 2020 2020 d: │ │ │ │ │ +00000ec0: 2020 2020 2020 2020 6865 6c70 2e20 2020 help. │ │ │ │ │ +00000ed0: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ │ +00000ee0: 6c69 6e65 2036 290a 2a20 696e 6974 7264 line 6).* initrd │ │ │ │ │ +00000ef0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ 00000f00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000f10: 2020 696e 6974 7264 2e20 2020 2020 2020 initrd. │ │ │ │ │ -00000f20: 2020 2020 2020 2020 2028 6c69 6e65 2036 (line 6 │ │ │ │ │ -00000f30: 290a 2a20 696e 6974 7264 3136 3a20 2020 ).* initrd16: │ │ │ │ │ +00000f10: 2069 6e69 7472 642e 2020 2020 2020 2020 initrd. │ │ │ │ │ +00000f20: 2020 2020 2020 2020 286c 696e 6520 3629 (line 6) │ │ │ │ │ +00000f30: 0a2a 2069 6e69 7472 6431 363a 2020 2020 .* initrd16: │ │ │ │ │ 00000f40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000f50: 2020 2020 2020 2020 2020 2069 6e69 7472 initr │ │ │ │ │ -00000f60: 6431 362e 2020 2020 2020 2020 2020 2020 d16. │ │ │ │ │ -00000f70: 2020 286c 696e 6520 3629 0a2a 2069 6e73 (line 6).* ins │ │ │ │ │ -00000f80: 6d6f 643a 2020 2020 2020 2020 2020 2020 mod: │ │ │ │ │ +00000f50: 2020 2020 2020 2020 2020 696e 6974 7264 initrd │ │ │ │ │ +00000f60: 3136 2e20 2020 2020 2020 2020 2020 2020 16. │ │ │ │ │ +00000f70: 2028 6c69 6e65 2036 290a 2a20 696e 736d (line 6).* insm │ │ │ │ │ +00000f80: 6f64 3a20 2020 2020 2020 2020 2020 2020 od: │ │ │ │ │ 00000f90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000fa0: 2020 2020 696e 736d 6f64 2e20 2020 2020 insmod. │ │ │ │ │ -00000fb0: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -00000fc0: 2036 290a 2a20 6b65 7973 7461 7475 733a 6).* keystatus: │ │ │ │ │ +00000fa0: 2020 2069 6e73 6d6f 642e 2020 2020 2020 insmod. │ │ │ │ │ +00000fb0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +00000fc0: 3629 0a2a 206b 6579 7374 6174 7573 3a20 6).* keystatus: │ │ │ │ │ 00000fd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000fe0: 2020 2020 2020 2020 2020 2020 206b 6579 key │ │ │ │ │ -00000ff0: 7374 6174 7573 2e20 2020 2020 2020 2020 status. │ │ │ │ │ -00001000: 2020 2020 286c 696e 6520 3629 0a2a 206c (line 6).* l │ │ │ │ │ -00001010: 696e 7578 3a20 2020 2020 2020 2020 2020 inux: │ │ │ │ │ +00000fe0: 2020 2020 2020 2020 2020 2020 6b65 7973 keys │ │ │ │ │ +00000ff0: 7461 7475 732e 2020 2020 2020 2020 2020 tatus. │ │ │ │ │ +00001000: 2020 2028 6c69 6e65 2036 290a 2a20 6c69 (line 6).* li │ │ │ │ │ +00001010: 6e75 783a 2020 2020 2020 2020 2020 2020 nux: │ │ │ │ │ 00001020: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001030: 2020 2020 2020 6c69 6e75 782e 2020 2020 linux. │ │ │ │ │ -00001040: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -00001050: 6e65 2036 290a 2a20 6c69 6e75 7831 363a ne 6).* linux16: │ │ │ │ │ +00001030: 2020 2020 206c 696e 7578 2e20 2020 2020 linux. │ │ │ │ │ +00001040: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +00001050: 6520 3629 0a2a 206c 696e 7578 3136 3a20 e 6).* linux16: │ │ │ │ │ 00001060: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001070: 2020 2020 2020 2020 2020 2020 2020 206c l │ │ │ │ │ -00001080: 696e 7578 3136 2e20 2020 2020 2020 2020 inux16. │ │ │ │ │ -00001090: 2020 2020 2020 286c 696e 6520 3629 0a2a (line 6).* │ │ │ │ │ -000010a0: 206c 6973 745f 656e 763a 2020 2020 2020 list_env: │ │ │ │ │ +00001070: 2020 2020 2020 2020 2020 2020 2020 6c69 li │ │ │ │ │ +00001080: 6e75 7831 362e 2020 2020 2020 2020 2020 nux16. │ │ │ │ │ +00001090: 2020 2020 2028 6c69 6e65 2036 290a 2a20 (line 6).* │ │ │ │ │ +000010a0: 6c69 7374 5f65 6e76 3a20 2020 2020 2020 list_env: │ │ │ │ │ 000010b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000010c0: 2020 2020 2020 2020 6c69 7374 5f65 6e76 list_env │ │ │ │ │ -000010d0: 2e20 2020 2020 2020 2020 2020 2020 2028 . ( │ │ │ │ │ -000010e0: 6c69 6e65 2036 290a 2a20 6c69 7374 5f74 line 6).* list_t │ │ │ │ │ -000010f0: 7275 7374 6564 3a20 2020 2020 2020 2020 rusted: │ │ │ │ │ +000010c0: 2020 2020 2020 206c 6973 745f 656e 762e list_env. │ │ │ │ │ +000010d0: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ +000010e0: 696e 6520 3629 0a2a 206c 6973 745f 7472 ine 6).* list_tr │ │ │ │ │ +000010f0: 7573 7465 643a 2020 2020 2020 2020 2020 usted: │ │ │ │ │ 00001100: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001110: 206c 6973 745f 7472 7573 7465 642e 2020 list_trusted. │ │ │ │ │ -00001120: 2020 2020 2020 2020 286c 696e 6520 3629 (line 6) │ │ │ │ │ -00001130: 0a2a 206c 6f61 6466 6f6e 743a 2020 2020 .* loadfont: │ │ │ │ │ +00001110: 6c69 7374 5f74 7275 7374 6564 2e20 2020 list_trusted. │ │ │ │ │ +00001120: 2020 2020 2020 2028 6c69 6e65 2036 290a (line 6). │ │ │ │ │ +00001130: 2a20 6c6f 6164 666f 6e74 3a20 2020 2020 * loadfont: │ │ │ │ │ 00001140: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001150: 2020 2020 2020 2020 2020 6c6f 6164 666f loadfo │ │ │ │ │ -00001160: 6e74 2e20 2020 2020 2020 2020 2020 2020 nt. │ │ │ │ │ -00001170: 2028 6c69 6e65 2036 290a 2a20 6c6f 6164 (line 6).* load │ │ │ │ │ -00001180: 5f65 6e76 3a20 2020 2020 2020 2020 2020 _env: │ │ │ │ │ +00001150: 2020 2020 2020 2020 206c 6f61 6466 6f6e loadfon │ │ │ │ │ +00001160: 742e 2020 2020 2020 2020 2020 2020 2020 t. │ │ │ │ │ +00001170: 286c 696e 6520 3629 0a2a 206c 6f61 645f (line 6).* load_ │ │ │ │ │ +00001180: 656e 763a 2020 2020 2020 2020 2020 2020 env: │ │ │ │ │ 00001190: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000011a0: 2020 206c 6f61 645f 656e 762e 2020 2020 load_env. │ │ │ │ │ -000011b0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -000011c0: 3629 0a2a 206c 6f6f 7062 6163 6b3a 2020 6).* loopback: │ │ │ │ │ +000011a0: 2020 6c6f 6164 5f65 6e76 2e20 2020 2020 load_env. │ │ │ │ │ +000011b0: 2020 2020 2020 2020 2028 6c69 6e65 2036 (line 6 │ │ │ │ │ +000011c0: 290a 2a20 6c6f 6f70 6261 636b 3a20 2020 ).* loopback: │ │ │ │ │ 000011d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000011e0: 2020 2020 2020 2020 2020 2020 6c6f 6f70 loop │ │ │ │ │ -000011f0: 6261 636b 2e20 2020 2020 2020 2020 2020 back. │ │ │ │ │ -00001200: 2020 2028 6c69 6e65 2036 290a 2a20 6c73 (line 6).* ls │ │ │ │ │ -00001210: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +000011e0: 2020 2020 2020 2020 2020 206c 6f6f 7062 loopb │ │ │ │ │ +000011f0: 6163 6b2e 2020 2020 2020 2020 2020 2020 ack. │ │ │ │ │ +00001200: 2020 286c 696e 6520 3629 0a2a 206c 733a (line 6).* ls: │ │ │ │ │ +00001210: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00001220: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001230: 2020 2020 206c 732e 2020 2020 2020 2020 ls. │ │ │ │ │ -00001240: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ -00001250: 6520 3629 0a2a 206c 7366 6f6e 7473 3a20 e 6).* lsfonts: │ │ │ │ │ +00001230: 2020 2020 6c73 2e20 2020 2020 2020 2020 ls. │ │ │ │ │ +00001240: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +00001250: 2036 290a 2a20 6c73 666f 6e74 733a 2020 6).* lsfonts: │ │ │ │ │ 00001260: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001270: 2020 2020 2020 2020 2020 2020 2020 6c73 ls │ │ │ │ │ -00001280: 666f 6e74 732e 2020 2020 2020 2020 2020 fonts. │ │ │ │ │ -00001290: 2020 2020 2028 6c69 6e65 2036 290a 2a20 (line 6).* │ │ │ │ │ -000012a0: 6c73 6d6f 643a 2020 2020 2020 2020 2020 lsmod: │ │ │ │ │ +00001270: 2020 2020 2020 2020 2020 2020 206c 7366 lsf │ │ │ │ │ +00001280: 6f6e 7473 2e20 2020 2020 2020 2020 2020 onts. │ │ │ │ │ +00001290: 2020 2020 286c 696e 6520 3629 0a2a 206c (line 6).* l │ │ │ │ │ +000012a0: 736d 6f64 3a20 2020 2020 2020 2020 2020 smod: │ │ │ │ │ 000012b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000012c0: 2020 2020 2020 206c 736d 6f64 2e20 2020 lsmod. │ │ │ │ │ -000012d0: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ -000012e0: 696e 6520 3629 0a2a 206d 6435 7375 6d3a ine 6).* md5sum: │ │ │ │ │ +000012c0: 2020 2020 2020 6c73 6d6f 642e 2020 2020 lsmod. │ │ │ │ │ +000012d0: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ +000012e0: 6e65 2036 290a 2a20 6d64 3573 756d 3a20 ne 6).* md5sum: │ │ │ │ │ 000012f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001300: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001310: 6d64 3573 756d 2e20 2020 2020 2020 2020 md5sum. │ │ │ │ │ -00001320: 2020 2020 2020 2028 6c69 6e65 2036 290a (line 6). │ │ │ │ │ -00001330: 2a20 6d65 6e75 656e 7472 793a 2020 2020 * menuentry: │ │ │ │ │ +00001300: 2020 2020 2020 2020 2020 2020 2020 206d m │ │ │ │ │ +00001310: 6435 7375 6d2e 2020 2020 2020 2020 2020 d5sum. │ │ │ │ │ +00001320: 2020 2020 2020 286c 696e 6520 3629 0a2a (line 6).* │ │ │ │ │ +00001330: 206d 656e 7565 6e74 7279 3a20 2020 2020 menuentry: │ │ │ │ │ 00001340: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001350: 2020 2020 2020 2020 206d 656e 7565 6e74 menuent │ │ │ │ │ -00001360: 7279 2e20 2020 2020 2020 2020 2020 2020 ry. │ │ │ │ │ -00001370: 286c 696e 6520 3629 0a2a 206d 6f64 756c (line 6).* modul │ │ │ │ │ -00001380: 653a 2020 2020 2020 2020 2020 2020 2020 e: │ │ │ │ │ +00001350: 2020 2020 2020 2020 6d65 6e75 656e 7472 menuentr │ │ │ │ │ +00001360: 792e 2020 2020 2020 2020 2020 2020 2028 y. ( │ │ │ │ │ +00001370: 6c69 6e65 2036 290a 2a20 6d6f 6475 6c65 line 6).* module │ │ │ │ │ +00001380: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ 00001390: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000013a0: 2020 6d6f 6475 6c65 2e20 2020 2020 2020 module. │ │ │ │ │ -000013b0: 2020 2020 2020 2020 2028 6c69 6e65 2036 (line 6 │ │ │ │ │ -000013c0: 290a 2a20 6d75 6c74 6962 6f6f 743a 2020 ).* multiboot: │ │ │ │ │ +000013a0: 206d 6f64 756c 652e 2020 2020 2020 2020 module. │ │ │ │ │ +000013b0: 2020 2020 2020 2020 286c 696e 6520 3629 (line 6) │ │ │ │ │ +000013c0: 0a2a 206d 756c 7469 626f 6f74 3a20 2020 .* multiboot: │ │ │ │ │ 000013d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000013e0: 2020 2020 2020 2020 2020 206d 756c 7469 multi │ │ │ │ │ -000013f0: 626f 6f74 2e20 2020 2020 2020 2020 2020 boot. │ │ │ │ │ -00001400: 2020 286c 696e 6520 3629 0a2a 206e 6174 (line 6).* nat │ │ │ │ │ -00001410: 6976 6564 6973 6b3a 2020 2020 2020 2020 ivedisk: │ │ │ │ │ +000013e0: 2020 2020 2020 2020 2020 6d75 6c74 6962 multib │ │ │ │ │ +000013f0: 6f6f 742e 2020 2020 2020 2020 2020 2020 oot. │ │ │ │ │ +00001400: 2028 6c69 6e65 2036 290a 2a20 6e61 7469 (line 6).* nati │ │ │ │ │ +00001410: 7665 6469 736b 3a20 2020 2020 2020 2020 vedisk: │ │ │ │ │ 00001420: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001430: 2020 2020 6e61 7469 7665 6469 736b 2e20 nativedisk. │ │ │ │ │ -00001440: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -00001450: 2036 290a 2a20 6e65 745f 6164 645f 6164 6).* net_add_ad │ │ │ │ │ -00001460: 6472 3a20 2020 2020 2020 2020 2020 2020 dr: │ │ │ │ │ -00001470: 2020 2020 2020 2020 2020 2020 206e 6574 net │ │ │ │ │ -00001480: 5f61 6464 5f61 6464 722e 2020 2020 2020 _add_addr. │ │ │ │ │ -00001490: 2020 2020 286c 696e 6520 3629 0a2a 206e (line 6).* n │ │ │ │ │ -000014a0: 6574 5f61 6464 5f64 6e73 3a20 2020 2020 et_add_dns: │ │ │ │ │ +00001430: 2020 206e 6174 6976 6564 6973 6b2e 2020 nativedisk. │ │ │ │ │ +00001440: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +00001450: 3629 0a2a 206e 6574 5f61 6464 5f61 6464 6).* net_add_add │ │ │ │ │ +00001460: 723a 2020 2020 2020 2020 2020 2020 2020 r: │ │ │ │ │ +00001470: 2020 2020 2020 2020 2020 2020 6e65 745f net_ │ │ │ │ │ +00001480: 6164 645f 6164 6472 2e20 2020 2020 2020 add_addr. │ │ │ │ │ +00001490: 2020 2028 6c69 6e65 2036 290a 2a20 6e65 (line 6).* ne │ │ │ │ │ +000014a0: 745f 6164 645f 646e 733a 2020 2020 2020 t_add_dns: │ │ │ │ │ 000014b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000014c0: 2020 2020 2020 6e65 745f 6164 645f 646e net_add_dn │ │ │ │ │ -000014d0: 732e 2020 2020 2020 2020 2020 2028 6c69 s. (li │ │ │ │ │ -000014e0: 6e65 2036 290a 2a20 6e65 745f 6164 645f ne 6).* net_add_ │ │ │ │ │ -000014f0: 726f 7574 653a 2020 2020 2020 2020 2020 route: │ │ │ │ │ -00001500: 2020 2020 2020 2020 2020 2020 2020 206e n │ │ │ │ │ -00001510: 6574 5f61 6464 5f72 6f75 7465 2e20 2020 et_add_route. │ │ │ │ │ -00001520: 2020 2020 2020 286c 696e 6520 3629 0a2a (line 6).* │ │ │ │ │ -00001530: 206e 6574 5f62 6f6f 7470 3a20 2020 2020 net_bootp: │ │ │ │ │ +000014c0: 2020 2020 206e 6574 5f61 6464 5f64 6e73 net_add_dns │ │ │ │ │ +000014d0: 2e20 2020 2020 2020 2020 2020 286c 696e . (lin │ │ │ │ │ +000014e0: 6520 3629 0a2a 206e 6574 5f61 6464 5f72 e 6).* net_add_r │ │ │ │ │ +000014f0: 6f75 7465 3a20 2020 2020 2020 2020 2020 oute: │ │ │ │ │ +00001500: 2020 2020 2020 2020 2020 2020 2020 6e65 ne │ │ │ │ │ +00001510: 745f 6164 645f 726f 7574 652e 2020 2020 t_add_route. │ │ │ │ │ +00001520: 2020 2020 2028 6c69 6e65 2036 290a 2a20 (line 6).* │ │ │ │ │ +00001530: 6e65 745f 626f 6f74 703a 2020 2020 2020 net_bootp: │ │ │ │ │ 00001540: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001550: 2020 2020 2020 2020 6e65 745f 626f 6f74 net_boot │ │ │ │ │ -00001560: 702e 2020 2020 2020 2020 2020 2020 2028 p. ( │ │ │ │ │ -00001570: 6c69 6e65 2036 290a 2a20 6e65 745f 6465 line 6).* net_de │ │ │ │ │ -00001580: 6c5f 6164 6472 3a20 2020 2020 2020 2020 l_addr: │ │ │ │ │ +00001550: 2020 2020 2020 206e 6574 5f62 6f6f 7470 net_bootp │ │ │ │ │ +00001560: 2e20 2020 2020 2020 2020 2020 2020 286c . (l │ │ │ │ │ +00001570: 696e 6520 3629 0a2a 206e 6574 5f64 656c ine 6).* net_del │ │ │ │ │ +00001580: 5f61 6464 723a 2020 2020 2020 2020 2020 _addr: │ │ │ │ │ 00001590: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000015a0: 206e 6574 5f64 656c 5f61 6464 722e 2020 net_del_addr. │ │ │ │ │ -000015b0: 2020 2020 2020 2020 286c 696e 6520 3629 (line 6) │ │ │ │ │ -000015c0: 0a2a 206e 6574 5f64 656c 5f64 6e73 3a20 .* net_del_dns: │ │ │ │ │ +000015a0: 6e65 745f 6465 6c5f 6164 6472 2e20 2020 net_del_addr. │ │ │ │ │ +000015b0: 2020 2020 2020 2028 6c69 6e65 2036 290a (line 6). │ │ │ │ │ +000015c0: 2a20 6e65 745f 6465 6c5f 646e 733a 2020 * net_del_dns: │ │ │ │ │ 000015d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000015e0: 2020 2020 2020 2020 2020 6e65 745f 6465 net_de │ │ │ │ │ -000015f0: 6c5f 646e 732e 2020 2020 2020 2020 2020 l_dns. │ │ │ │ │ -00001600: 2028 6c69 6e65 2036 290a 2a20 6e65 745f (line 6).* net_ │ │ │ │ │ -00001610: 6465 6c5f 726f 7574 653a 2020 2020 2020 del_route: │ │ │ │ │ +000015e0: 2020 2020 2020 2020 206e 6574 5f64 656c net_del │ │ │ │ │ +000015f0: 5f64 6e73 2e20 2020 2020 2020 2020 2020 _dns. │ │ │ │ │ +00001600: 286c 696e 6520 3629 0a2a 206e 6574 5f64 (line 6).* net_d │ │ │ │ │ +00001610: 656c 5f72 6f75 7465 3a20 2020 2020 2020 el_route: │ │ │ │ │ 00001620: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001630: 2020 206e 6574 5f64 656c 5f72 6f75 7465 net_del_route │ │ │ │ │ -00001640: 2e20 2020 2020 2020 2020 286c 696e 6520 . (line │ │ │ │ │ -00001650: 3629 0a2a 206e 6574 5f64 6863 703a 2020 6).* net_dhcp: │ │ │ │ │ +00001630: 2020 6e65 745f 6465 6c5f 726f 7574 652e net_del_route. │ │ │ │ │ +00001640: 2020 2020 2020 2020 2028 6c69 6e65 2036 (line 6 │ │ │ │ │ +00001650: 290a 2a20 6e65 745f 6468 6370 3a20 2020 ).* net_dhcp: │ │ │ │ │ 00001660: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001670: 2020 2020 2020 2020 2020 2020 6e65 745f net_ │ │ │ │ │ -00001680: 6468 6370 2e20 2020 2020 2020 2020 2020 dhcp. │ │ │ │ │ -00001690: 2020 2028 6c69 6e65 2036 290a 2a20 6e65 (line 6).* ne │ │ │ │ │ -000016a0: 745f 6765 745f 6468 6370 5f6f 7074 696f t_get_dhcp_optio │ │ │ │ │ -000016b0: 6e3a 2020 2020 2020 2020 2020 2020 2020 n: │ │ │ │ │ -000016c0: 2020 2020 206e 6574 5f67 6574 5f64 6863 net_get_dhc │ │ │ │ │ -000016d0: 705f 6f70 7469 6f6e 2e20 2020 286c 696e p_option. (lin │ │ │ │ │ -000016e0: 6520 3629 0a2a 206e 6574 5f69 7076 365f e 6).* net_ipv6_ │ │ │ │ │ -000016f0: 6175 746f 636f 6e66 3a20 2020 2020 2020 autoconf: │ │ │ │ │ -00001700: 2020 2020 2020 2020 2020 2020 2020 6e65 ne │ │ │ │ │ -00001710: 745f 6970 7636 5f61 7574 6f63 6f6e 662e t_ipv6_autoconf. │ │ │ │ │ -00001720: 2020 2020 2028 6c69 6e65 2036 290a 2a20 (line 6).* │ │ │ │ │ -00001730: 6e65 745f 6c73 5f61 6464 723a 2020 2020 net_ls_addr: │ │ │ │ │ +00001670: 2020 2020 2020 2020 2020 206e 6574 5f64 net_d │ │ │ │ │ +00001680: 6863 702e 2020 2020 2020 2020 2020 2020 hcp. │ │ │ │ │ +00001690: 2020 286c 696e 6520 3629 0a2a 206e 6574 (line 6).* net │ │ │ │ │ +000016a0: 5f67 6574 5f64 6863 705f 6f70 7469 6f6e _get_dhcp_option │ │ │ │ │ +000016b0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +000016c0: 2020 2020 6e65 745f 6765 745f 6468 6370 net_get_dhcp │ │ │ │ │ +000016d0: 5f6f 7074 696f 6e2e 2020 2028 6c69 6e65 _option. (line │ │ │ │ │ +000016e0: 2036 290a 2a20 6e65 745f 6970 7636 5f61 6).* net_ipv6_a │ │ │ │ │ +000016f0: 7574 6f63 6f6e 663a 2020 2020 2020 2020 utoconf: │ │ │ │ │ +00001700: 2020 2020 2020 2020 2020 2020 206e 6574 net │ │ │ │ │ +00001710: 5f69 7076 365f 6175 746f 636f 6e66 2e20 _ipv6_autoconf. │ │ │ │ │ +00001720: 2020 2020 286c 696e 6520 3629 0a2a 206e (line 6).* n │ │ │ │ │ +00001730: 6574 5f6c 735f 6164 6472 3a20 2020 2020 et_ls_addr: │ │ │ │ │ 00001740: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001750: 2020 2020 2020 206e 6574 5f6c 735f 6164 net_ls_ad │ │ │ │ │ -00001760: 6472 2e20 2020 2020 2020 2020 2020 286c dr. (l │ │ │ │ │ -00001770: 696e 6520 3629 0a2a 206e 6574 5f6c 735f ine 6).* net_ls_ │ │ │ │ │ -00001780: 6361 7264 733a 2020 2020 2020 2020 2020 cards: │ │ │ │ │ -00001790: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000017a0: 6e65 745f 6c73 5f63 6172 6473 2e20 2020 net_ls_cards. │ │ │ │ │ -000017b0: 2020 2020 2020 2028 6c69 6e65 2036 290a (line 6). │ │ │ │ │ -000017c0: 2a20 6e65 745f 6c73 5f64 6e73 3a20 2020 * net_ls_dns: │ │ │ │ │ +00001750: 2020 2020 2020 6e65 745f 6c73 5f61 6464 net_ls_add │ │ │ │ │ +00001760: 722e 2020 2020 2020 2020 2020 2028 6c69 r. (li │ │ │ │ │ +00001770: 6e65 2036 290a 2a20 6e65 745f 6c73 5f63 ne 6).* net_ls_c │ │ │ │ │ +00001780: 6172 6473 3a20 2020 2020 2020 2020 2020 ards: │ │ │ │ │ +00001790: 2020 2020 2020 2020 2020 2020 2020 206e n │ │ │ │ │ +000017a0: 6574 5f6c 735f 6361 7264 732e 2020 2020 et_ls_cards. │ │ │ │ │ +000017b0: 2020 2020 2020 286c 696e 6520 3629 0a2a (line 6).* │ │ │ │ │ +000017c0: 206e 6574 5f6c 735f 646e 733a 2020 2020 net_ls_dns: │ │ │ │ │ 000017d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000017e0: 2020 2020 2020 2020 206e 6574 5f6c 735f net_ls_ │ │ │ │ │ -000017f0: 646e 732e 2020 2020 2020 2020 2020 2020 dns. │ │ │ │ │ -00001800: 286c 696e 6520 3629 0a2a 206e 6574 5f6c (line 6).* net_l │ │ │ │ │ -00001810: 735f 726f 7574 6573 3a20 2020 2020 2020 s_routes: │ │ │ │ │ +000017e0: 2020 2020 2020 2020 6e65 745f 6c73 5f64 net_ls_d │ │ │ │ │ +000017f0: 6e73 2e20 2020 2020 2020 2020 2020 2028 ns. ( │ │ │ │ │ +00001800: 6c69 6e65 2036 290a 2a20 6e65 745f 6c73 line 6).* net_ls │ │ │ │ │ +00001810: 5f72 6f75 7465 733a 2020 2020 2020 2020 _routes: │ │ │ │ │ 00001820: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001830: 2020 6e65 745f 6c73 5f72 6f75 7465 732e net_ls_routes. │ │ │ │ │ -00001840: 2020 2020 2020 2020 2028 6c69 6e65 2036 (line 6 │ │ │ │ │ -00001850: 290a 2a20 6e65 745f 6e73 6c6f 6f6b 7570 ).* net_nslookup │ │ │ │ │ -00001860: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -00001870: 2020 2020 2020 2020 2020 206e 6574 5f6e net_n │ │ │ │ │ -00001880: 736c 6f6f 6b75 702e 2020 2020 2020 2020 slookup. │ │ │ │ │ -00001890: 2020 286c 696e 6520 3629 0a2a 206e 6f72 (line 6).* nor │ │ │ │ │ -000018a0: 6d61 6c3a 2020 2020 2020 2020 2020 2020 mal: │ │ │ │ │ +00001830: 206e 6574 5f6c 735f 726f 7574 6573 2e20 net_ls_routes. │ │ │ │ │ +00001840: 2020 2020 2020 2020 286c 696e 6520 3629 (line 6) │ │ │ │ │ +00001850: 0a2a 206e 6574 5f6e 736c 6f6f 6b75 703a .* net_nslookup: │ │ │ │ │ +00001860: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00001870: 2020 2020 2020 2020 2020 6e65 745f 6e73 net_ns │ │ │ │ │ +00001880: 6c6f 6f6b 7570 2e20 2020 2020 2020 2020 lookup. │ │ │ │ │ +00001890: 2028 6c69 6e65 2036 290a 2a20 6e6f 726d (line 6).* norm │ │ │ │ │ +000018a0: 616c 3a20 2020 2020 2020 2020 2020 2020 al: │ │ │ │ │ 000018b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000018c0: 2020 2020 6e6f 726d 616c 2e20 2020 2020 normal. │ │ │ │ │ -000018d0: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -000018e0: 2036 290a 2a20 6e6f 726d 616c 5f65 7869 6).* normal_exi │ │ │ │ │ -000018f0: 743a 2020 2020 2020 2020 2020 2020 2020 t: │ │ │ │ │ -00001900: 2020 2020 2020 2020 2020 2020 206e 6f72 nor │ │ │ │ │ -00001910: 6d61 6c5f 6578 6974 2e20 2020 2020 2020 mal_exit. │ │ │ │ │ -00001920: 2020 2020 286c 696e 6520 3629 0a2a 2070 (line 6).* p │ │ │ │ │ -00001930: 6172 7474 6f6f 6c3a 2020 2020 2020 2020 arttool: │ │ │ │ │ +000018c0: 2020 206e 6f72 6d61 6c2e 2020 2020 2020 normal. │ │ │ │ │ +000018d0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +000018e0: 3629 0a2a 206e 6f72 6d61 6c5f 6578 6974 6).* normal_exit │ │ │ │ │ +000018f0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00001900: 2020 2020 2020 2020 2020 2020 6e6f 726d norm │ │ │ │ │ +00001910: 616c 5f65 7869 742e 2020 2020 2020 2020 al_exit. │ │ │ │ │ +00001920: 2020 2028 6c69 6e65 2036 290a 2a20 7061 (line 6).* pa │ │ │ │ │ +00001930: 7274 746f 6f6c 3a20 2020 2020 2020 2020 rttool: │ │ │ │ │ 00001940: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001950: 2020 2020 2020 7061 7274 746f 6f6c 2e20 parttool. │ │ │ │ │ -00001960: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -00001970: 6e65 2036 290a 2a20 7061 7373 776f 7264 ne 6).* password │ │ │ │ │ -00001980: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -00001990: 2020 2020 2020 2020 2020 2020 2020 2070 p │ │ │ │ │ -000019a0: 6173 7377 6f72 642e 2020 2020 2020 2020 assword. │ │ │ │ │ -000019b0: 2020 2020 2020 286c 696e 6520 3629 0a2a (line 6).* │ │ │ │ │ -000019c0: 2070 6173 7377 6f72 645f 7062 6b64 6632 password_pbkdf2 │ │ │ │ │ -000019d0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -000019e0: 2020 2020 2020 2020 7061 7373 776f 7264 password │ │ │ │ │ -000019f0: 5f70 626b 6466 322e 2020 2020 2020 2028 _pbkdf2. ( │ │ │ │ │ -00001a00: 6c69 6e65 2036 290a 2a20 706c 6179 3a20 line 6).* play: │ │ │ │ │ +00001950: 2020 2020 2070 6172 7474 6f6f 6c2e 2020 parttool. │ │ │ │ │ +00001960: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +00001970: 6520 3629 0a2a 2070 6173 7377 6f72 643a e 6).* password: │ │ │ │ │ +00001980: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00001990: 2020 2020 2020 2020 2020 2020 2020 7061 pa │ │ │ │ │ +000019a0: 7373 776f 7264 2e20 2020 2020 2020 2020 ssword. │ │ │ │ │ +000019b0: 2020 2020 2028 6c69 6e65 2036 290a 2a20 (line 6).* │ │ │ │ │ +000019c0: 7061 7373 776f 7264 5f70 626b 6466 323a password_pbkdf2: │ │ │ │ │ +000019d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +000019e0: 2020 2020 2020 2070 6173 7377 6f72 645f password_ │ │ │ │ │ +000019f0: 7062 6b64 6632 2e20 2020 2020 2020 286c pbkdf2. (l │ │ │ │ │ +00001a00: 696e 6520 3629 0a2a 2070 6c61 793a 2020 ine 6).* play: │ │ │ │ │ 00001a10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00001a20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001a30: 2070 6c61 792e 2020 2020 2020 2020 2020 play. │ │ │ │ │ -00001a40: 2020 2020 2020 2020 286c 696e 6520 3629 (line 6) │ │ │ │ │ -00001a50: 0a2a 2070 726f 6265 3a20 2020 2020 2020 .* probe: │ │ │ │ │ +00001a30: 706c 6179 2e20 2020 2020 2020 2020 2020 play. │ │ │ │ │ +00001a40: 2020 2020 2020 2028 6c69 6e65 2036 290a (line 6). │ │ │ │ │ +00001a50: 2a20 7072 6f62 653a 2020 2020 2020 2020 * probe: │ │ │ │ │ 00001a60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001a70: 2020 2020 2020 2020 2020 7072 6f62 652e probe. │ │ │ │ │ +00001a70: 2020 2020 2020 2020 2070 726f 6265 2e20 probe. │ │ │ │ │ 00001a80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001a90: 2028 6c69 6e65 2036 290a 2a20 7264 6d73 (line 6).* rdms │ │ │ │ │ -00001aa0: 723a 2020 2020 2020 2020 2020 2020 2020 r: │ │ │ │ │ +00001a90: 286c 696e 6520 3629 0a2a 2072 646d 7372 (line 6).* rdmsr │ │ │ │ │ +00001aa0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ 00001ab0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001ac0: 2020 2072 646d 7372 2e20 2020 2020 2020 rdmsr. │ │ │ │ │ -00001ad0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -00001ae0: 3629 0a2a 2072 6561 643a 2020 2020 2020 6).* read: │ │ │ │ │ +00001ac0: 2020 7264 6d73 722e 2020 2020 2020 2020 rdmsr. │ │ │ │ │ +00001ad0: 2020 2020 2020 2020 2028 6c69 6e65 2036 (line 6 │ │ │ │ │ +00001ae0: 290a 2a20 7265 6164 3a20 2020 2020 2020 ).* read: │ │ │ │ │ 00001af0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001b00: 2020 2020 2020 2020 2020 2020 7265 6164 read │ │ │ │ │ -00001b10: 2e20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ -00001b20: 2020 2028 6c69 6e65 2036 290a 2a20 7265 (line 6).* re │ │ │ │ │ -00001b30: 626f 6f74 3a20 2020 2020 2020 2020 2020 boot: │ │ │ │ │ +00001b00: 2020 2020 2020 2020 2020 2072 6561 642e read. │ │ │ │ │ +00001b10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00001b20: 2020 286c 696e 6520 3629 0a2a 2072 6562 (line 6).* reb │ │ │ │ │ +00001b30: 6f6f 743a 2020 2020 2020 2020 2020 2020 oot: │ │ │ │ │ 00001b40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001b50: 2020 2020 2072 6562 6f6f 742e 2020 2020 reboot. │ │ │ │ │ -00001b60: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ -00001b70: 6520 3629 0a2a 2072 6567 6578 703a 2020 e 6).* regexp: │ │ │ │ │ +00001b50: 2020 2020 7265 626f 6f74 2e20 2020 2020 reboot. │ │ │ │ │ +00001b60: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +00001b70: 2036 290a 2a20 7265 6765 7870 3a20 2020 6).* regexp: │ │ │ │ │ 00001b80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001b90: 2020 2020 2020 2020 2020 2020 2020 7265 re │ │ │ │ │ -00001ba0: 6765 7870 2e20 2020 2020 2020 2020 2020 gexp. │ │ │ │ │ -00001bb0: 2020 2020 2028 6c69 6e65 2036 290a 2a20 (line 6).* │ │ │ │ │ -00001bc0: 726d 6d6f 643a 2020 2020 2020 2020 2020 rmmod: │ │ │ │ │ +00001b90: 2020 2020 2020 2020 2020 2020 2072 6567 reg │ │ │ │ │ +00001ba0: 6578 702e 2020 2020 2020 2020 2020 2020 exp. │ │ │ │ │ +00001bb0: 2020 2020 286c 696e 6520 3629 0a2a 2072 (line 6).* r │ │ │ │ │ +00001bc0: 6d6d 6f64 3a20 2020 2020 2020 2020 2020 mmod: │ │ │ │ │ 00001bd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001be0: 2020 2020 2020 2072 6d6d 6f64 2e20 2020 rmmod. │ │ │ │ │ -00001bf0: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ -00001c00: 696e 6520 3629 0a2a 2073 6176 655f 656e ine 6).* save_en │ │ │ │ │ -00001c10: 763a 2020 2020 2020 2020 2020 2020 2020 v: │ │ │ │ │ -00001c20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001c30: 7361 7665 5f65 6e76 2e20 2020 2020 2020 save_env. │ │ │ │ │ -00001c40: 2020 2020 2020 2028 6c69 6e65 2036 290a (line 6). │ │ │ │ │ -00001c50: 2a20 7365 6172 6368 3a20 2020 2020 2020 * search: │ │ │ │ │ +00001be0: 2020 2020 2020 726d 6d6f 642e 2020 2020 rmmod. │ │ │ │ │ +00001bf0: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ +00001c00: 6e65 2036 290a 2a20 7361 7665 5f65 6e76 ne 6).* save_env │ │ │ │ │ +00001c10: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00001c20: 2020 2020 2020 2020 2020 2020 2020 2073 s │ │ │ │ │ +00001c30: 6176 655f 656e 762e 2020 2020 2020 2020 ave_env. │ │ │ │ │ +00001c40: 2020 2020 2020 286c 696e 6520 3629 0a2a (line 6).* │ │ │ │ │ +00001c50: 2073 6561 7263 683a 2020 2020 2020 2020 search: │ │ │ │ │ 00001c60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001c70: 2020 2020 2020 2020 2073 6561 7263 682e search. │ │ │ │ │ -00001c80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001c90: 286c 696e 6520 3629 0a2a 2073 656e 646b (line 6).* sendk │ │ │ │ │ -00001ca0: 6579 3a20 2020 2020 2020 2020 2020 2020 ey: │ │ │ │ │ +00001c70: 2020 2020 2020 2020 7365 6172 6368 2e20 search. │ │ │ │ │ +00001c80: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ │ +00001c90: 6c69 6e65 2036 290a 2a20 7365 6e64 6b65 line 6).* sendke │ │ │ │ │ +00001ca0: 793a 2020 2020 2020 2020 2020 2020 2020 y: │ │ │ │ │ 00001cb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001cc0: 2020 7365 6e64 6b65 792e 2020 2020 2020 sendkey. │ │ │ │ │ -00001cd0: 2020 2020 2020 2020 2028 6c69 6e65 2036 (line 6 │ │ │ │ │ -00001ce0: 290a 2a20 7365 7269 616c 3a20 2020 2020 ).* serial: │ │ │ │ │ +00001cc0: 2073 656e 646b 6579 2e20 2020 2020 2020 sendkey. │ │ │ │ │ +00001cd0: 2020 2020 2020 2020 286c 696e 6520 3629 (line 6) │ │ │ │ │ +00001ce0: 0a2a 2073 6572 6961 6c3a 2020 2020 2020 .* serial: │ │ │ │ │ 00001cf0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001d00: 2020 2020 2020 2020 2020 2073 6572 6961 seria │ │ │ │ │ -00001d10: 6c2e 2020 2020 2020 2020 2020 2020 2020 l. │ │ │ │ │ -00001d20: 2020 286c 696e 6520 3629 0a2a 2073 6574 (line 6).* set │ │ │ │ │ -00001d30: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00001d00: 2020 2020 2020 2020 2020 7365 7269 616c serial │ │ │ │ │ +00001d10: 2e20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +00001d20: 2028 6c69 6e65 2036 290a 2a20 7365 743a (line 6).* set: │ │ │ │ │ +00001d30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00001d40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001d50: 2020 2020 7365 742e 2020 2020 2020 2020 set. │ │ │ │ │ -00001d60: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -00001d70: 2036 290a 2a20 7368 6131 7375 6d3a 2020 6).* sha1sum: │ │ │ │ │ +00001d50: 2020 2073 6574 2e20 2020 2020 2020 2020 set. │ │ │ │ │ +00001d60: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +00001d70: 3629 0a2a 2073 6861 3173 756d 3a20 2020 6).* sha1sum: │ │ │ │ │ 00001d80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001d90: 2020 2020 2020 2020 2020 2020 2073 6861 sha │ │ │ │ │ -00001da0: 3173 756d 2e20 2020 2020 2020 2020 2020 1sum. │ │ │ │ │ -00001db0: 2020 2020 286c 696e 6520 3629 0a2a 2073 (line 6).* s │ │ │ │ │ -00001dc0: 6861 3235 3673 756d 3a20 2020 2020 2020 ha256sum: │ │ │ │ │ +00001d90: 2020 2020 2020 2020 2020 2020 7368 6131 sha1 │ │ │ │ │ +00001da0: 7375 6d2e 2020 2020 2020 2020 2020 2020 sum. │ │ │ │ │ +00001db0: 2020 2028 6c69 6e65 2036 290a 2a20 7368 (line 6).* sh │ │ │ │ │ +00001dc0: 6132 3536 7375 6d3a 2020 2020 2020 2020 a256sum: │ │ │ │ │ 00001dd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001de0: 2020 2020 2020 7368 6132 3536 7375 6d2e sha256sum. │ │ │ │ │ -00001df0: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -00001e00: 6e65 2036 290a 2a20 7368 6135 3132 7375 ne 6).* sha512su │ │ │ │ │ -00001e10: 6d3a 2020 2020 2020 2020 2020 2020 2020 m: │ │ │ │ │ -00001e20: 2020 2020 2020 2020 2020 2020 2020 2073 s │ │ │ │ │ -00001e30: 6861 3531 3273 756d 2e20 2020 2020 2020 ha512sum. │ │ │ │ │ -00001e40: 2020 2020 2020 286c 696e 6520 3629 0a2a (line 6).* │ │ │ │ │ -00001e50: 2073 6c65 6570 3a20 2020 2020 2020 2020 sleep: │ │ │ │ │ +00001de0: 2020 2020 2073 6861 3235 3673 756d 2e20 sha256sum. │ │ │ │ │ +00001df0: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +00001e00: 6520 3629 0a2a 2073 6861 3531 3273 756d e 6).* sha512sum │ │ │ │ │ +00001e10: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00001e20: 2020 2020 2020 2020 2020 2020 2020 7368 sh │ │ │ │ │ +00001e30: 6135 3132 7375 6d2e 2020 2020 2020 2020 a512sum. │ │ │ │ │ +00001e40: 2020 2020 2028 6c69 6e65 2036 290a 2a20 (line 6).* │ │ │ │ │ +00001e50: 736c 6565 703a 2020 2020 2020 2020 2020 sleep: │ │ │ │ │ 00001e60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001e70: 2020 2020 2020 2020 736c 6565 702e 2020 sleep. │ │ │ │ │ -00001e80: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ │ -00001e90: 6c69 6e65 2036 290a 2a20 736d 6269 6f73 line 6).* smbios │ │ │ │ │ -00001ea0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00001e70: 2020 2020 2020 2073 6c65 6570 2e20 2020 sleep. │ │ │ │ │ +00001e80: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ +00001e90: 696e 6520 3629 0a2a 2073 6d62 696f 733a ine 6).* smbios: │ │ │ │ │ +00001ea0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00001eb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001ec0: 2073 6d62 696f 732e 2020 2020 2020 2020 smbios. │ │ │ │ │ -00001ed0: 2020 2020 2020 2020 286c 696e 6520 3629 (line 6) │ │ │ │ │ -00001ee0: 0a2a 2073 6f75 7263 653a 2020 2020 2020 .* source: │ │ │ │ │ +00001ec0: 736d 6269 6f73 2e20 2020 2020 2020 2020 smbios. │ │ │ │ │ +00001ed0: 2020 2020 2020 2028 6c69 6e65 2036 290a (line 6). │ │ │ │ │ +00001ee0: 2a20 736f 7572 6365 3a20 2020 2020 2020 * source: │ │ │ │ │ 00001ef0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001f00: 2020 2020 2020 2020 2020 736f 7572 6365 source │ │ │ │ │ -00001f10: 2e20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ -00001f20: 2028 6c69 6e65 2036 290a 2a20 7375 626d (line 6).* subm │ │ │ │ │ -00001f30: 656e 753a 2020 2020 2020 2020 2020 2020 enu: │ │ │ │ │ +00001f00: 2020 2020 2020 2020 2073 6f75 7263 652e source. │ │ │ │ │ +00001f10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00001f20: 286c 696e 6520 3629 0a2a 2073 7562 6d65 (line 6).* subme │ │ │ │ │ +00001f30: 6e75 3a20 2020 2020 2020 2020 2020 2020 nu: │ │ │ │ │ 00001f40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001f50: 2020 2073 7562 6d65 6e75 2e20 2020 2020 submenu. │ │ │ │ │ -00001f60: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -00001f70: 3629 0a2a 2074 6572 6d69 6e61 6c5f 696e 6).* terminal_in │ │ │ │ │ -00001f80: 7075 743a 2020 2020 2020 2020 2020 2020 put: │ │ │ │ │ -00001f90: 2020 2020 2020 2020 2020 2020 7465 726d term │ │ │ │ │ -00001fa0: 696e 616c 5f69 6e70 7574 2e20 2020 2020 inal_input. │ │ │ │ │ -00001fb0: 2020 2028 6c69 6e65 2036 290a 2a20 7465 (line 6).* te │ │ │ │ │ -00001fc0: 726d 696e 616c 5f6f 7574 7075 743a 2020 rminal_output: │ │ │ │ │ +00001f50: 2020 7375 626d 656e 752e 2020 2020 2020 submenu. │ │ │ │ │ +00001f60: 2020 2020 2020 2020 2028 6c69 6e65 2036 (line 6 │ │ │ │ │ +00001f70: 290a 2a20 7465 726d 696e 616c 5f69 6e70 ).* terminal_inp │ │ │ │ │ +00001f80: 7574 3a20 2020 2020 2020 2020 2020 2020 ut: │ │ │ │ │ +00001f90: 2020 2020 2020 2020 2020 2074 6572 6d69 termi │ │ │ │ │ +00001fa0: 6e61 6c5f 696e 7075 742e 2020 2020 2020 nal_input. │ │ │ │ │ +00001fb0: 2020 286c 696e 6520 3629 0a2a 2074 6572 (line 6).* ter │ │ │ │ │ +00001fc0: 6d69 6e61 6c5f 6f75 7470 7574 3a20 2020 minal_output: │ │ │ │ │ 00001fd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001fe0: 2020 2020 2074 6572 6d69 6e61 6c5f 6f75 terminal_ou │ │ │ │ │ -00001ff0: 7470 7574 2e20 2020 2020 2020 286c 696e tput. (lin │ │ │ │ │ -00002000: 6520 3629 0a2a 2074 6572 6d69 6e66 6f3a e 6).* terminfo: │ │ │ │ │ +00001fe0: 2020 2020 7465 726d 696e 616c 5f6f 7574 terminal_out │ │ │ │ │ +00001ff0: 7075 742e 2020 2020 2020 2028 6c69 6e65 put. (line │ │ │ │ │ +00002000: 2036 290a 2a20 7465 726d 696e 666f 3a20 6).* terminfo: │ │ │ │ │ 00002010: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00002020: 2020 2020 2020 2020 2020 2020 2020 7465 te │ │ │ │ │ -00002030: 726d 696e 666f 2e20 2020 2020 2020 2020 rminfo. │ │ │ │ │ -00002040: 2020 2020 2028 6c69 6e65 2036 290a 2a20 (line 6).* │ │ │ │ │ -00002050: 7465 7374 3a20 2020 2020 2020 2020 2020 test: │ │ │ │ │ +00002020: 2020 2020 2020 2020 2020 2020 2074 6572 ter │ │ │ │ │ +00002030: 6d69 6e66 6f2e 2020 2020 2020 2020 2020 minfo. │ │ │ │ │ +00002040: 2020 2020 286c 696e 6520 3629 0a2a 2074 (line 6).* t │ │ │ │ │ +00002050: 6573 743a 2020 2020 2020 2020 2020 2020 est: │ │ │ │ │ 00002060: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00002070: 2020 2020 2020 2074 6573 742e 2020 2020 test. │ │ │ │ │ -00002080: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ -00002090: 696e 6520 3629 0a2a 2074 7275 653a 2020 ine 6).* true: │ │ │ │ │ +00002070: 2020 2020 2020 7465 7374 2e20 2020 2020 test. │ │ │ │ │ +00002080: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ +00002090: 6e65 2036 290a 2a20 7472 7565 3a20 2020 ne 6).* true: │ │ │ │ │ 000020a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000020b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000020c0: 7472 7565 2e20 2020 2020 2020 2020 2020 true. │ │ │ │ │ -000020d0: 2020 2020 2020 2028 6c69 6e65 2036 290a (line 6). │ │ │ │ │ -000020e0: 2a20 7472 7573 743a 2020 2020 2020 2020 * trust: │ │ │ │ │ +000020b0: 2020 2020 2020 2020 2020 2020 2020 2074 t │ │ │ │ │ +000020c0: 7275 652e 2020 2020 2020 2020 2020 2020 rue. │ │ │ │ │ +000020d0: 2020 2020 2020 286c 696e 6520 3629 0a2a (line 6).* │ │ │ │ │ +000020e0: 2074 7275 7374 3a20 2020 2020 2020 2020 trust: │ │ │ │ │ 000020f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00002100: 2020 2020 2020 2020 2074 7275 7374 2e20 trust. │ │ │ │ │ -00002110: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00002120: 286c 696e 6520 3629 0a2a 2075 6e73 6574 (line 6).* unset │ │ │ │ │ -00002130: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00002100: 2020 2020 2020 2020 7472 7573 742e 2020 trust. │ │ │ │ │ +00002110: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ │ +00002120: 6c69 6e65 2036 290a 2a20 756e 7365 743a line 6).* unset: │ │ │ │ │ +00002130: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00002140: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00002150: 2020 756e 7365 742e 2020 2020 2020 2020 unset. │ │ │ │ │ -00002160: 2020 2020 2020 2020 2028 6c69 6e65 2036 (line 6 │ │ │ │ │ -00002170: 290a 2a20 7665 7269 6679 5f64 6574 6163 ).* verify_detac │ │ │ │ │ -00002180: 6865 643a 2020 2020 2020 2020 2020 2020 hed: │ │ │ │ │ -00002190: 2020 2020 2020 2020 2020 2076 6572 6966 verif │ │ │ │ │ -000021a0: 795f 6465 7461 6368 6564 2e20 2020 2020 y_detached. │ │ │ │ │ -000021b0: 2020 286c 696e 6520 3629 0a2a 2076 6964 (line 6).* vid │ │ │ │ │ -000021c0: 656f 696e 666f 3a20 2020 2020 2020 2020 eoinfo: │ │ │ │ │ +00002150: 2075 6e73 6574 2e20 2020 2020 2020 2020 unset. │ │ │ │ │ +00002160: 2020 2020 2020 2020 286c 696e 6520 3629 (line 6) │ │ │ │ │ +00002170: 0a2a 2076 6572 6966 795f 6465 7461 6368 .* verify_detach │ │ │ │ │ +00002180: 6564 3a20 2020 2020 2020 2020 2020 2020 ed: │ │ │ │ │ +00002190: 2020 2020 2020 2020 2020 7665 7269 6679 verify │ │ │ │ │ +000021a0: 5f64 6574 6163 6865 642e 2020 2020 2020 _detached. │ │ │ │ │ +000021b0: 2028 6c69 6e65 2036 290a 2a20 7669 6465 (line 6).* vide │ │ │ │ │ +000021c0: 6f69 6e66 6f3a 2020 2020 2020 2020 2020 oinfo: │ │ │ │ │ 000021d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000021e0: 2020 2020 7669 6465 6f69 6e66 6f2e 2020 videoinfo. │ │ │ │ │ -000021f0: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -00002200: 2036 290a 2a20 7772 6d73 723a 2020 2020 6).* wrmsr: │ │ │ │ │ +000021e0: 2020 2076 6964 656f 696e 666f 2e20 2020 videoinfo. │ │ │ │ │ +000021f0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +00002200: 3629 0a2a 2077 726d 7372 3a20 2020 2020 6).* wrmsr: │ │ │ │ │ 00002210: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00002220: 2020 2020 2020 2020 2020 2020 2077 726d wrm │ │ │ │ │ -00002230: 7372 2e20 2020 2020 2020 2020 2020 2020 sr. │ │ │ │ │ -00002240: 2020 2020 286c 696e 6520 3629 0a2a 2078 (line 6).* x │ │ │ │ │ -00002250: 656e 5f68 7970 6572 7669 736f 723a 2020 en_hypervisor: │ │ │ │ │ +00002220: 2020 2020 2020 2020 2020 2020 7772 6d73 wrms │ │ │ │ │ +00002230: 722e 2020 2020 2020 2020 2020 2020 2020 r. │ │ │ │ │ +00002240: 2020 2028 6c69 6e65 2036 290a 2a20 7865 (line 6).* xe │ │ │ │ │ +00002250: 6e5f 6879 7065 7276 6973 6f72 3a20 2020 n_hypervisor: │ │ │ │ │ 00002260: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00002270: 2020 2020 2020 7865 6e5f 6879 7065 7276 xen_hyperv │ │ │ │ │ -00002280: 6973 6f72 2e20 2020 2020 2020 2028 6c69 isor. (li │ │ │ │ │ -00002290: 6e65 2036 290a 2a20 7865 6e5f 6d6f 6475 ne 6).* xen_modu │ │ │ │ │ -000022a0: 6c65 3a20 2020 2020 2020 2020 2020 2020 le: │ │ │ │ │ -000022b0: 2020 2020 2020 2020 2020 2020 2020 2078 x │ │ │ │ │ -000022c0: 656e 5f6d 6f64 756c 652e 2020 2020 2020 en_module. │ │ │ │ │ -000022d0: 2020 2020 2020 286c 696e 6520 3629 0a0a (line 6).. │ │ │ │ │ +00002270: 2020 2020 2078 656e 5f68 7970 6572 7669 xen_hypervi │ │ │ │ │ +00002280: 736f 722e 2020 2020 2020 2020 286c 696e sor. (lin │ │ │ │ │ +00002290: 6520 3629 0a2a 2078 656e 5f6d 6f64 756c e 6).* xen_modul │ │ │ │ │ +000022a0: 653a 2020 2020 2020 2020 2020 2020 2020 e: │ │ │ │ │ +000022b0: 2020 2020 2020 2020 2020 2020 2020 7865 xe │ │ │ │ │ +000022c0: 6e5f 6d6f 6475 6c65 2e20 2020 2020 2020 n_module. │ │ │ │ │ +000022d0: 2020 2020 2028 6c69 6e65 2036 290a 0a (line 6).. │ │ │ ├── ./usr/share/info/grub.info.gz │ │ │ │ ├── grub.info │ │ │ │ │ @@ -1,510 +1,510 @@ │ │ │ │ │ 00000000: 5468 6973 2069 7320 6772 7562 2e69 6e66 This is grub.inf │ │ │ │ │ 00000010: 6f2c 2070 726f 6475 6365 6420 6279 206d o, produced by m │ │ │ │ │ 00000020: 616b 6569 6e66 6f20 7665 7273 696f 6e20 akeinfo version │ │ │ │ │ 00000030: 362e 3820 6672 6f6d 2067 7275 622e 7465 6.8 from grub.te │ │ │ │ │ 00000040: 7869 2e0a 0a54 6869 7320 6d61 6e75 616c xi...This manual │ │ │ │ │ 00000050: 2069 7320 666f 7220 474e 5520 4752 5542 is for GNU GRUB │ │ │ │ │ 00000060: 2028 7665 7273 696f 6e20 322e 3036 2c20 (version 2.06, │ │ │ │ │ -00000070: 3132 2046 6562 7275 6172 7920 3230 3235 12 February 2025 │ │ │ │ │ -00000080: 292e 0a0a 2020 2043 6f70 7972 6967 6874 )... Copyright │ │ │ │ │ -00000090: 2028 4329 0a31 3939 392c 3230 3030 2c32 (C).1999,2000,2 │ │ │ │ │ -000000a0: 3030 312c 3230 3032 2c32 3030 342c 3230 001,2002,2004,20 │ │ │ │ │ -000000b0: 3036 2c32 3030 382c 3230 3039 2c32 3031 06,2008,2009,201 │ │ │ │ │ -000000c0: 302c 3230 3131 2c32 3031 322c 3230 3133 0,2011,2012,2013 │ │ │ │ │ -000000d0: 2046 7265 650a 536f 6674 7761 7265 2046 Free.Software F │ │ │ │ │ -000000e0: 6f75 6e64 6174 696f 6e2c 2049 6e63 2e0a oundation, Inc.. │ │ │ │ │ -000000f0: 0a20 2020 2020 5065 726d 6973 7369 6f6e . Permission │ │ │ │ │ -00000100: 2069 7320 6772 616e 7465 6420 746f 2063 is granted to c │ │ │ │ │ -00000110: 6f70 792c 2064 6973 7472 6962 7574 6520 opy, distribute │ │ │ │ │ -00000120: 616e 642f 6f72 206d 6f64 6966 7920 7468 and/or modify th │ │ │ │ │ -00000130: 6973 0a20 2020 2020 646f 6375 6d65 6e74 is. document │ │ │ │ │ -00000140: 2075 6e64 6572 2074 6865 2074 6572 6d73 under the terms │ │ │ │ │ -00000150: 206f 6620 7468 6520 474e 5520 4672 6565 of the GNU Free │ │ │ │ │ -00000160: 2044 6f63 756d 656e 7461 7469 6f6e 204c Documentation L │ │ │ │ │ -00000170: 6963 656e 7365 2c0a 2020 2020 2056 6572 icense,. Ver │ │ │ │ │ -00000180: 7369 6f6e 2031 2e32 206f 7220 616e 7920 sion 1.2 or any │ │ │ │ │ -00000190: 6c61 7465 7220 7665 7273 696f 6e20 7075 later version pu │ │ │ │ │ -000001a0: 626c 6973 6865 6420 6279 2074 6865 2046 blished by the F │ │ │ │ │ -000001b0: 7265 6520 536f 6674 7761 7265 0a20 2020 ree Software. │ │ │ │ │ -000001c0: 2020 466f 756e 6461 7469 6f6e 3b20 7769 Foundation; wi │ │ │ │ │ -000001d0: 7468 206e 6f20 496e 7661 7269 616e 7420 th no Invariant │ │ │ │ │ -000001e0: 5365 6374 696f 6e73 2e0a 494e 464f 2d44 Sections..INFO-D │ │ │ │ │ -000001f0: 4952 2d53 4543 5449 4f4e 204b 6572 6e65 IR-SECTION Kerne │ │ │ │ │ -00000200: 6c0a 5354 4152 542d 494e 464f 2d44 4952 l.START-INFO-DIR │ │ │ │ │ -00000210: 2d45 4e54 5259 0a2a 2047 5255 423a 2028 -ENTRY.* GRUB: ( │ │ │ │ │ -00000220: 6772 7562 292e 2020 2020 2020 2020 2020 grub). │ │ │ │ │ -00000230: 2020 2020 2020 2054 6865 2047 5261 6e64 The GRand │ │ │ │ │ -00000240: 2055 6e69 6669 6564 2042 6f6f 746c 6f61 Unified Bootloa │ │ │ │ │ -00000250: 6465 720a 2a20 6772 7562 2d69 6e73 7461 der.* grub-insta │ │ │ │ │ -00000260: 6c6c 3a20 2867 7275 6229 496e 766f 6b69 ll: (grub)Invoki │ │ │ │ │ -00000270: 6e67 2067 7275 622d 696e 7374 616c 6c2e ng grub-install. │ │ │ │ │ -00000280: 2020 2020 496e 7374 616c 6c20 4752 5542 Install GRUB │ │ │ │ │ -00000290: 206f 6e20 796f 7572 2064 7269 7665 0a2a on your drive.* │ │ │ │ │ -000002a0: 2067 7275 622d 6d6b 636f 6e66 6967 3a20 grub-mkconfig: │ │ │ │ │ -000002b0: 2867 7275 6229 496e 766f 6b69 6e67 2067 (grub)Invoking g │ │ │ │ │ -000002c0: 7275 622d 6d6b 636f 6e66 6967 2e20 2047 rub-mkconfig. G │ │ │ │ │ -000002d0: 656e 6572 6174 6520 4752 5542 2063 6f6e enerate GRUB con │ │ │ │ │ -000002e0: 6669 6775 7261 7469 6f6e 0a2a 2067 7275 figuration.* gru │ │ │ │ │ -000002f0: 622d 6d6b 7061 7373 7764 2d70 626b 6466 b-mkpasswd-pbkdf │ │ │ │ │ -00000300: 323a 2028 6772 7562 2949 6e76 6f6b 696e 2: (grub)Invokin │ │ │ │ │ -00000310: 6720 6772 7562 2d6d 6b70 6173 7377 642d g grub-mkpasswd- │ │ │ │ │ -00000320: 7062 6b64 6632 2e0a 2a20 6772 7562 2d6d pbkdf2..* grub-m │ │ │ │ │ -00000330: 6b72 656c 7061 7468 3a20 2867 7275 6229 krelpath: (grub) │ │ │ │ │ -00000340: 496e 766f 6b69 6e67 2067 7275 622d 6d6b Invoking grub-mk │ │ │ │ │ -00000350: 7265 6c70 6174 682e 0a2a 2067 7275 622d relpath..* grub- │ │ │ │ │ -00000360: 6d6b 7265 7363 7565 3a20 2867 7275 6229 mkrescue: (grub) │ │ │ │ │ -00000370: 496e 766f 6b69 6e67 2067 7275 622d 6d6b Invoking grub-mk │ │ │ │ │ -00000380: 7265 7363 7565 2e20 204d 616b 6520 6120 rescue. Make a │ │ │ │ │ -00000390: 4752 5542 2072 6573 6375 6520 696d 6167 GRUB rescue imag │ │ │ │ │ -000003a0: 650a 2a20 6772 7562 2d6d 6f75 6e74 3a20 e.* grub-mount: │ │ │ │ │ -000003b0: 2867 7275 6229 496e 766f 6b69 6e67 2067 (grub)Invoking g │ │ │ │ │ -000003c0: 7275 622d 6d6f 756e 742e 2020 2020 2020 rub-mount. │ │ │ │ │ -000003d0: 2020 4d6f 756e 7420 6120 6669 6c65 2073 Mount a file s │ │ │ │ │ -000003e0: 7973 7465 6d20 7573 696e 6720 4752 5542 ystem using GRUB │ │ │ │ │ -000003f0: 0a2a 2067 7275 622d 7072 6f62 653a 2028 .* grub-probe: ( │ │ │ │ │ -00000400: 6772 7562 2949 6e76 6f6b 696e 6720 6772 grub)Invoking gr │ │ │ │ │ -00000410: 7562 2d70 726f 6265 2e20 2020 2020 2020 ub-probe. │ │ │ │ │ -00000420: 2050 726f 6265 2064 6576 6963 6520 696e Probe device in │ │ │ │ │ -00000430: 666f 726d 6174 696f 6e0a 2a20 6772 7562 formation.* grub │ │ │ │ │ -00000440: 2d73 6372 6970 742d 6368 6563 6b3a 2028 -script-check: ( │ │ │ │ │ -00000450: 6772 7562 2949 6e76 6f6b 696e 6720 6772 grub)Invoking gr │ │ │ │ │ -00000460: 7562 2d73 6372 6970 742d 6368 6563 6b2e ub-script-check. │ │ │ │ │ -00000470: 0a45 4e44 2d49 4e46 4f2d 4449 522d 454e .END-INFO-DIR-EN │ │ │ │ │ -00000480: 5452 590a 0a1f 0a49 6e64 6972 6563 743a TRY....Indirect: │ │ │ │ │ -00000490: 0a67 7275 622e 696e 666f 2d31 3a20 3131 .grub.info-1: 11 │ │ │ │ │ -000004a0: 3537 0a67 7275 622e 696e 666f 2d32 3a20 57.grub.info-2: │ │ │ │ │ -000004b0: 3331 3234 3338 0a1f 0a54 6167 2054 6162 312438...Tag Tab │ │ │ │ │ -000004c0: 6c65 3a0a 2849 6e64 6972 6563 7429 0a4e le:.(Indirect).N │ │ │ │ │ -000004d0: 6f64 653a 2054 6f70 7f31 3135 370a 4e6f ode: Top.1157.No │ │ │ │ │ -000004e0: 6465 3a20 496e 7472 6f64 7563 7469 6f6e de: Introduction │ │ │ │ │ -000004f0: 7f34 3230 390a 4e6f 6465 3a20 4f76 6572 .4209.Node: Over │ │ │ │ │ -00000500: 7669 6577 7f34 3635 330a 4e6f 6465 3a20 view.4653.Node: │ │ │ │ │ -00000510: 4f76 6572 7669 6577 2d46 6f6f 746e 6f74 Overview-Footnot │ │ │ │ │ -00000520: 6573 7f36 3634 330a 5265 663a 204f 7665 es.6643.Ref: Ove │ │ │ │ │ -00000530: 7276 6965 772d 466f 6f74 6e6f 7465 2d31 rview-Footnote-1 │ │ │ │ │ -00000540: 7f36 3730 340a 4e6f 6465 3a20 4869 7374 .6704.Node: Hist │ │ │ │ │ -00000550: 6f72 797f 3638 3636 0a4e 6f64 653a 2043 ory.6866.Node: C │ │ │ │ │ -00000560: 6861 6e67 6573 2066 726f 6d20 4752 5542 hanges from GRUB │ │ │ │ │ -00000570: 204c 6567 6163 797f 3839 3536 0a4e 6f64 Legacy.8956.Nod │ │ │ │ │ -00000580: 653a 2046 6561 7475 7265 737f 3131 3433 e: Features.1143 │ │ │ │ │ -00000590: 320a 4e6f 6465 3a20 4665 6174 7572 6573 2.Node: Features │ │ │ │ │ -000005a0: 2d46 6f6f 746e 6f74 6573 7f31 3738 3539 -Footnotes.17859 │ │ │ │ │ -000005b0: 0a52 6566 3a20 4665 6174 7572 6573 2d46 .Ref: Features-F │ │ │ │ │ -000005c0: 6f6f 746e 6f74 652d 317f 3137 3932 300a ootnote-1.17920. │ │ │ │ │ -000005d0: 5265 663a 2046 6561 7475 7265 732d 466f Ref: Features-Fo │ │ │ │ │ -000005e0: 6f74 6e6f 7465 2d32 7f31 3830 3136 0a52 otnote-2.18016.R │ │ │ │ │ -000005f0: 6566 3a20 4665 6174 7572 6573 2d46 6f6f ef: Features-Foo │ │ │ │ │ -00000600: 746e 6f74 652d 337f 3138 3136 330a 4e6f tnote-3.18163.No │ │ │ │ │ -00000610: 6465 3a20 526f 6c65 206f 6620 6120 626f de: Role of a bo │ │ │ │ │ -00000620: 6f74 206c 6f61 6465 727f 3138 3330 380a ot loader.18308. │ │ │ │ │ -00000630: 4e6f 6465 3a20 526f 6c65 206f 6620 6120 Node: Role of a │ │ │ │ │ -00000640: 626f 6f74 206c 6f61 6465 722d 466f 6f74 boot loader-Foot │ │ │ │ │ -00000650: 6e6f 7465 737f 3139 3634 370a 5265 663a notes.19647.Ref: │ │ │ │ │ -00000660: 2052 6f6c 6520 6f66 2061 2062 6f6f 7420 Role of a boot │ │ │ │ │ -00000670: 6c6f 6164 6572 2d46 6f6f 746e 6f74 652d loader-Footnote- │ │ │ │ │ -00000680: 317f 3139 3733 340a 4e6f 6465 3a20 4e61 1.19734.Node: Na │ │ │ │ │ -00000690: 6d69 6e67 2063 6f6e 7665 6e74 696f 6e7f ming convention. │ │ │ │ │ -000006a0: 3139 3831 330a 4e6f 6465 3a20 4f53 2d73 19813.Node: OS-s │ │ │ │ │ -000006b0: 7065 6369 6669 6320 6e6f 7465 7320 6162 pecific notes ab │ │ │ │ │ -000006c0: 6f75 7420 6772 7562 2074 6f6f 6c73 7f32 out grub tools.2 │ │ │ │ │ -000006d0: 3237 3234 0a4e 6f64 653a 2049 6e73 7461 2724.Node: Insta │ │ │ │ │ -000006e0: 6c6c 6174 696f 6e7f 3233 3736 300a 4e6f llation.23760.No │ │ │ │ │ -000006f0: 6465 3a20 496e 7374 616c 6c69 6e67 2047 de: Installing G │ │ │ │ │ -00000700: 5255 4220 7573 696e 6720 6772 7562 2d69 RUB using grub-i │ │ │ │ │ -00000710: 6e73 7461 6c6c 7f32 3438 3832 0a4e 6f64 nstall.24882.Nod │ │ │ │ │ -00000720: 653a 204d 616b 696e 6720 6120 4752 5542 e: Making a GRUB │ │ │ │ │ -00000730: 2062 6f6f 7461 626c 6520 4344 2d52 4f4d bootable CD-ROM │ │ │ │ │ -00000740: 7f32 3731 3937 0a4e 6f64 653a 204d 616b .27197.Node: Mak │ │ │ │ │ -00000750: 696e 6720 6120 4752 5542 2062 6f6f 7461 ing a GRUB boota │ │ │ │ │ -00000760: 626c 6520 4344 2d52 4f4d 2d46 6f6f 746e ble CD-ROM-Footn │ │ │ │ │ -00000770: 6f74 6573 7f32 3930 3536 0a52 6566 3a20 otes.29056.Ref: │ │ │ │ │ -00000780: 4d61 6b69 6e67 2061 2047 5255 4220 626f Making a GRUB bo │ │ │ │ │ -00000790: 6f74 6162 6c65 2043 442d 524f 4d2d 466f otable CD-ROM-Fo │ │ │ │ │ -000007a0: 6f74 6e6f 7465 2d31 7f32 3931 3539 0a4e otnote-1.29159.N │ │ │ │ │ -000007b0: 6f64 653a 2044 6576 6963 6520 6d61 707f ode: Device map. │ │ │ │ │ -000007c0: 3239 3233 340a 4e6f 6465 3a20 4249 4f53 29234.Node: BIOS │ │ │ │ │ -000007d0: 2069 6e73 7461 6c6c 6174 696f 6e7f 3331 installation.31 │ │ │ │ │ -000007e0: 3230 310a 4e6f 6465 3a20 426f 6f74 696e 201.Node: Bootin │ │ │ │ │ -000007f0: 677f 3335 3635 320a 4e6f 6465 3a20 4765 g.35652.Node: Ge │ │ │ │ │ -00000800: 6e65 7261 6c20 626f 6f74 206d 6574 686f neral boot metho │ │ │ │ │ -00000810: 6473 7f33 3631 3837 0a4e 6f64 653a 204c ds.36187.Node: L │ │ │ │ │ -00000820: 6f61 6469 6e67 2061 6e20 6f70 6572 6174 oading an operat │ │ │ │ │ -00000830: 696e 6720 7379 7374 656d 2064 6972 6563 ing system direc │ │ │ │ │ -00000840: 746c 797f 3336 3933 300a 4e6f 6465 3a20 tly.36930.Node: │ │ │ │ │ -00000850: 4368 6169 6e2d 6c6f 6164 696e 677f 3337 Chain-loading.37 │ │ │ │ │ -00000860: 3636 310a 4e6f 6465 3a20 4c6f 6f70 6261 661.Node: Loopba │ │ │ │ │ -00000870: 636b 2062 6f6f 7469 6e67 7f33 3836 3332 ck booting.38632 │ │ │ │ │ -00000880: 0a4e 6f64 653a 204c 564d 2063 6163 6865 .Node: LVM cache │ │ │ │ │ -00000890: 2062 6f6f 7469 6e67 7f34 3033 3036 0a4e booting.40306.N │ │ │ │ │ -000008a0: 6f64 653a 204f 532d 7370 6563 6966 6963 ode: OS-specific │ │ │ │ │ -000008b0: 206e 6f74 6573 7f34 3135 3732 0a4e 6f64 notes.41572.Nod │ │ │ │ │ -000008c0: 653a 2047 4e55 2f48 7572 647f 3431 3836 e: GNU/Hurd.4186 │ │ │ │ │ -000008d0: 320a 4e6f 6465 3a20 474e 552f 4c69 6e75 2.Node: GNU/Linu │ │ │ │ │ -000008e0: 787f 3432 3938 350a 4e6f 6465 3a20 4e65 x.42985.Node: Ne │ │ │ │ │ -000008f0: 7442 5344 7f34 3433 3033 0a4e 6f64 653a tBSD.44303.Node: │ │ │ │ │ -00000900: 2044 4f53 2f57 696e 646f 7773 7f34 3537 DOS/Windows.457 │ │ │ │ │ -00000910: 3737 0a4e 6f64 653a 2043 6f6e 6669 6775 77.Node: Configu │ │ │ │ │ -00000920: 7261 7469 6f6e 7f34 3735 3535 0a4e 6f64 ration.47555.Nod │ │ │ │ │ -00000930: 653a 2053 696d 706c 6520 636f 6e66 6967 e: Simple config │ │ │ │ │ -00000940: 7572 6174 696f 6e7f 3438 3236 370a 4e6f uration.48267.No │ │ │ │ │ -00000950: 6465 3a20 526f 6f74 2049 6465 6e74 6966 de: Root Identif │ │ │ │ │ -00000960: 6361 7469 6f6e 2048 6575 7269 7374 6963 cation Heuristic │ │ │ │ │ -00000970: 737f 3635 3731 370a 4e6f 6465 3a20 5368 s.65717.Node: Sh │ │ │ │ │ -00000980: 656c 6c2d 6c69 6b65 2073 6372 6970 7469 ell-like scripti │ │ │ │ │ -00000990: 6e67 7f36 3837 3331 0a4e 6f64 653a 2053 ng.68731.Node: S │ │ │ │ │ -000009a0: 6865 6c6c 2d6c 696b 6520 7363 7269 7074 hell-like script │ │ │ │ │ -000009b0: 696e 672d 466f 6f74 6e6f 7465 737f 3736 ing-Footnotes.76 │ │ │ │ │ -000009c0: 3739 340a 5265 663a 2053 6865 6c6c 2d6c 794.Ref: Shell-l │ │ │ │ │ -000009d0: 696b 6520 7363 7269 7074 696e 672d 466f ike scripting-Fo │ │ │ │ │ -000009e0: 6f74 6e6f 7465 2d31 7f37 3638 3739 0a4e otnote-1.76879.N │ │ │ │ │ -000009f0: 6f64 653a 204d 756c 7469 2d62 6f6f 7420 ode: Multi-boot │ │ │ │ │ -00000a00: 6d61 6e75 616c 2063 6f6e 6669 677f 3737 manual config.77 │ │ │ │ │ -00000a10: 3030 360a 4e6f 6465 3a20 456d 6265 6464 006.Node: Embedd │ │ │ │ │ -00000a20: 6564 2063 6f6e 6669 6775 7261 7469 6f6e ed configuration │ │ │ │ │ -00000a30: 7f38 3036 3135 0a4e 6f64 653a 2054 6865 .80615.Node: The │ │ │ │ │ -00000a40: 6d65 2066 696c 6520 666f 726d 6174 7f38 me file format.8 │ │ │ │ │ -00000a50: 3334 3531 0a52 6566 3a20 5069 786d 6170 3451.Ref: Pixmap │ │ │ │ │ -00000a60: 2d73 7479 6c65 6420 7072 6f67 7265 7373 -styled progress │ │ │ │ │ -00000a70: 2062 6172 7f38 3439 3130 0a52 6566 3a20 bar.84910.Ref: │ │ │ │ │ -00000a80: 506c 6169 6e20 7072 6f67 7265 7373 2062 Plain progress b │ │ │ │ │ -00000a90: 6172 2c20 6472 6177 6e20 7769 7468 2073 ar, drawn with s │ │ │ │ │ -00000aa0: 6f6c 6964 2063 6f6c 6f72 2e7f 3834 3932 olid color..8492 │ │ │ │ │ -00000ab0: 320a 5265 663a 2041 6e20 6578 616d 706c 2.Ref: An exampl │ │ │ │ │ -00000ac0: 6520 6f66 2074 6865 2073 6c69 6365 7320 e of the slices │ │ │ │ │ -00000ad0: 2869 6e20 7265 6429 2075 7365 6420 666f (in red) used fo │ │ │ │ │ -00000ae0: 7220 6120 7465 726d 696e 616c 2077 696e r a terminal win │ │ │ │ │ -00000af0: 646f 772e 2054 6869 7320 6472 6177 696e dow. This drawin │ │ │ │ │ -00000b00: 6720 7761 7320 6372 6561 7465 6420 616e g was created an │ │ │ │ │ -00000b10: 6420 736c 6963 6564 2069 6e20 496e 6b73 d sliced in Inks │ │ │ │ │ -00000b20: 6361 7065 5f2c 2061 7320 7468 6520 6e65 cape_, as the ne │ │ │ │ │ -00000b30: 7874 2073 6563 7469 6f6e 2065 7870 6c61 xt section expla │ │ │ │ │ -00000b40: 696e 732e 7f38 3834 3134 0a4e 6f64 653a ins..88414.Node: │ │ │ │ │ -00000b50: 204e 6574 776f 726b 7f31 3038 3832 360a Network.108826. │ │ │ │ │ -00000b60: 4e6f 6465 3a20 5365 7269 616c 2074 6572 Node: Serial ter │ │ │ │ │ -00000b70: 6d69 6e61 6c7f 3131 3331 3430 0a4e 6f64 minal.113140.Nod │ │ │ │ │ -00000b80: 653a 2056 656e 646f 7220 706f 7765 722d e: Vendor power- │ │ │ │ │ -00000b90: 6f6e 206b 6579 737f 3131 3533 3737 0a4e on keys.115377.N │ │ │ │ │ -00000ba0: 6f64 653a 2049 6d61 6765 737f 3131 3733 ode: Images.1173 │ │ │ │ │ -00000bb0: 3132 0a4e 6f64 653a 2043 6f72 6520 696d 12.Node: Core im │ │ │ │ │ -00000bc0: 6167 6520 7369 7a65 206c 696d 6974 6174 age size limitat │ │ │ │ │ -00000bd0: 696f 6e7f 3132 3232 3837 0a4e 6f64 653a ion.122287.Node: │ │ │ │ │ -00000be0: 2046 696c 6573 7973 7465 6d7f 3132 3438 Filesystem.1248 │ │ │ │ │ -00000bf0: 3531 0a4e 6f64 653a 2044 6576 6963 6520 51.Node: Device │ │ │ │ │ -00000c00: 7379 6e74 6178 7f31 3235 3536 300a 4e6f syntax.125560.No │ │ │ │ │ -00000c10: 6465 3a20 4669 6c65 206e 616d 6520 7379 de: File name sy │ │ │ │ │ -00000c20: 6e74 6178 7f31 3238 3236 310a 4e6f 6465 ntax.128261.Node │ │ │ │ │ -00000c30: 3a20 426c 6f63 6b20 6c69 7374 2073 796e : Block list syn │ │ │ │ │ -00000c40: 7461 787f 3132 3933 3037 0a4e 6f64 653a tax.129307.Node: │ │ │ │ │ -00000c50: 2049 6e74 6572 6661 6365 7f31 3330 3034 Interface.13004 │ │ │ │ │ -00000c60: 310a 4e6f 6465 3a20 436f 6d6d 616e 642d 1.Node: Command- │ │ │ │ │ -00000c70: 6c69 6e65 2069 6e74 6572 6661 6365 7f31 line interface.1 │ │ │ │ │ -00000c80: 3330 3836 350a 4e6f 6465 3a20 436f 6d6d 30865.Node: Comm │ │ │ │ │ -00000c90: 616e 642d 6c69 6e65 2069 6e74 6572 6661 and-line interfa │ │ │ │ │ -00000ca0: 6365 2d46 6f6f 746e 6f74 6573 7f31 3332 ce-Footnotes.132 │ │ │ │ │ -00000cb0: 3830 390a 5265 663a 2043 6f6d 6d61 6e64 809.Ref: Command │ │ │ │ │ -00000cc0: 2d6c 696e 6520 696e 7465 7266 6163 652d -line interface- │ │ │ │ │ -00000cd0: 466f 6f74 6e6f 7465 2d31 7f31 3332 3839 Footnote-1.13289 │ │ │ │ │ -00000ce0: 380a 4e6f 6465 3a20 4d65 6e75 2069 6e74 8.Node: Menu int │ │ │ │ │ -00000cf0: 6572 6661 6365 7f31 3332 3939 330a 4e6f erface.132993.No │ │ │ │ │ -00000d00: 6465 3a20 4d65 6e75 2065 6e74 7279 2065 de: Menu entry e │ │ │ │ │ -00000d10: 6469 746f 727f 3133 3430 3035 0a4e 6f64 ditor.134005.Nod │ │ │ │ │ -00000d20: 653a 2045 6e76 6972 6f6e 6d65 6e74 7f31 e: Environment.1 │ │ │ │ │ -00000d30: 3334 3734 330a 4e6f 6465 3a20 5370 6563 34743.Node: Spec │ │ │ │ │ -00000d40: 6961 6c20 656e 7669 726f 6e6d 656e 7420 ial environment │ │ │ │ │ -00000d50: 7661 7269 6162 6c65 737f 3133 3534 3436 variables.135446 │ │ │ │ │ -00000d60: 0a4e 6f64 653a 2062 696f 736e 756d 7f31 .Node: biosnum.1 │ │ │ │ │ -00000d70: 3336 3530 300a 4e6f 6465 3a20 6368 6563 36500.Node: chec │ │ │ │ │ -00000d80: 6b5f 7369 676e 6174 7572 6573 7f31 3337 k_signatures.137 │ │ │ │ │ -00000d90: 3032 340a 4e6f 6465 3a20 6368 6f73 656e 024.Node: chosen │ │ │ │ │ -00000da0: 7f31 3337 3331 310a 4e6f 6465 3a20 636d .137311.Node: cm │ │ │ │ │ -00000db0: 6470 6174 687f 3133 3737 3534 0a4e 6f64 dpath.137754.Nod │ │ │ │ │ -00000dc0: 653a 2063 6f6c 6f72 5f68 6967 686c 6967 e: color_highlig │ │ │ │ │ -00000dd0: 6874 7f31 3338 3138 310a 4e6f 6465 3a20 ht.138181.Node: │ │ │ │ │ -00000de0: 636f 6c6f 725f 6e6f 726d 616c 7f31 3338 color_normal.138 │ │ │ │ │ -00000df0: 3539 330a 4e6f 6465 3a20 636f 6e66 6967 593.Node: config │ │ │ │ │ -00000e00: 5f64 6972 6563 746f 7279 7f31 3430 3235 _directory.14025 │ │ │ │ │ -00000e10: 360a 4e6f 6465 3a20 636f 6e66 6967 5f66 6.Node: config_f │ │ │ │ │ -00000e20: 696c 657f 3134 3035 3530 0a4e 6f64 653a ile.140550.Node: │ │ │ │ │ -00000e30: 2064 6562 7567 7f31 3430 3934 330a 4e6f debug.140943.No │ │ │ │ │ -00000e40: 6465 3a20 6465 6661 756c 747f 3134 3133 de: default.1413 │ │ │ │ │ -00000e50: 3832 0a4e 6f64 653a 2066 616c 6c62 6163 82.Node: fallbac │ │ │ │ │ -00000e60: 6b7f 3134 3238 3130 0a4e 6f64 653a 2067 k.142810.Node: g │ │ │ │ │ -00000e70: 6678 6d6f 6465 7f31 3433 3134 330a 4e6f fxmode.143143.No │ │ │ │ │ -00000e80: 6465 3a20 6766 7870 6179 6c6f 6164 7f31 de: gfxpayload.1 │ │ │ │ │ -00000e90: 3433 3934 310a 4e6f 6465 3a20 6766 7874 43941.Node: gfxt │ │ │ │ │ -00000ea0: 6572 6d5f 666f 6e74 7f31 3435 3039 350a erm_font.145095. │ │ │ │ │ -00000eb0: 4e6f 6465 3a20 6772 7562 5f63 7075 7f31 Node: grub_cpu.1 │ │ │ │ │ -00000ec0: 3435 3339 350a 4e6f 6465 3a20 6772 7562 45395.Node: grub │ │ │ │ │ -00000ed0: 5f70 6c61 7466 6f72 6d7f 3134 3536 3833 _platform.145683 │ │ │ │ │ -00000ee0: 0a4e 6f64 653a 2069 636f 6e64 6972 7f31 .Node: icondir.1 │ │ │ │ │ -00000ef0: 3435 3937 350a 4e6f 6465 3a20 6c61 6e67 45975.Node: lang │ │ │ │ │ -00000f00: 7f31 3436 3239 320a 4e6f 6465 3a20 6c6f .146292.Node: lo │ │ │ │ │ -00000f10: 6361 6c65 5f64 6972 7f31 3436 3736 310a cale_dir.146761. │ │ │ │ │ -00000f20: 4e6f 6465 3a20 6d65 6e75 5f63 6f6c 6f72 Node: menu_color │ │ │ │ │ -00000f30: 5f68 6967 686c 6967 6874 7f31 3437 3237 _highlight.14727 │ │ │ │ │ -00000f40: 300a 4e6f 6465 3a20 6d65 6e75 5f63 6f6c 0.Node: menu_col │ │ │ │ │ -00000f50: 6f72 5f6e 6f72 6d61 6c7f 3134 3737 3636 or_normal.147766 │ │ │ │ │ -00000f60: 0a4e 6f64 653a 206e 6574 5f3c 494e 5445 .Node: net__boot_file │ │ │ │ │ -00000f80: 7f31 3438 3236 370a 4e6f 6465 3a20 6e65 .148267.Node: ne │ │ │ │ │ -00000f90: 745f 3c49 4e54 4552 4641 4345 3e5f 6468 t__dh │ │ │ │ │ -00000fa0: 6370 5f73 6572 7665 725f 6e61 6d65 7f31 cp_server_name.1 │ │ │ │ │ -00000fb0: 3438 3531 300a 4e6f 6465 3a20 6e65 745f 48510.Node: net_ │ │ │ │ │ -00000fc0: 3c49 4e54 4552 4641 4345 3e5f 646f 6d61 _doma │ │ │ │ │ -00000fd0: 696e 7f31 3438 3737 320a 4e6f 6465 3a20 in.148772.Node: │ │ │ │ │ -00000fe0: 6e65 745f 3c49 4e54 4552 4641 4345 3e5f net__ │ │ │ │ │ -00000ff0: 6578 7465 6e73 696f 6e73 7061 7468 7f31 extensionspath.1 │ │ │ │ │ -00001000: 3439 3031 390a 4e6f 6465 3a20 6e65 745f 49019.Node: net_ │ │ │ │ │ -00001010: 3c49 4e54 4552 4641 4345 3e5f 686f 7374 _host │ │ │ │ │ -00001020: 6e61 6d65 7f31 3439 3237 340a 4e6f 6465 name.149274.Node │ │ │ │ │ -00001030: 3a20 6e65 745f 3c49 4e54 4552 4641 4345 : net__ip.149513.Node │ │ │ │ │ -00001050: 3a20 6e65 745f 3c49 4e54 4552 4641 4345 : net__mac.149729.Nod │ │ │ │ │ -00001070: 653a 206e 6574 5f3c 494e 5445 5246 4143 e: net__next_server.1 │ │ │ │ │ -00001090: 3439 3935 300a 4e6f 6465 3a20 6e65 745f 49950.Node: net_ │ │ │ │ │ -000010a0: 3c49 4e54 4552 4641 4345 3e5f 726f 6f74 _root │ │ │ │ │ -000010b0: 7061 7468 7f31 3530 3139 330a 4e6f 6465 path.150193.Node │ │ │ │ │ -000010c0: 3a20 6e65 745f 6465 6661 756c 745f 696e : net_default_in │ │ │ │ │ -000010d0: 7465 7266 6163 657f 3135 3034 3332 0a4e terface.150432.N │ │ │ │ │ -000010e0: 6f64 653a 206e 6574 5f64 6566 6175 6c74 ode: net_default │ │ │ │ │ -000010f0: 5f69 707f 3135 3036 3532 0a4e 6f64 653a _ip.150652.Node: │ │ │ │ │ -00001100: 206e 6574 5f64 6566 6175 6c74 5f6d 6163 net_default_mac │ │ │ │ │ -00001110: 7f31 3530 3834 390a 4e6f 6465 3a20 6e65 .150849.Node: ne │ │ │ │ │ -00001120: 745f 6465 6661 756c 745f 7365 7276 6572 t_default_server │ │ │ │ │ -00001130: 7f31 3531 3034 350a 4e6f 6465 3a20 7061 .151045.Node: pa │ │ │ │ │ -00001140: 6765 727f 3135 3132 3338 0a4e 6f64 653a ger.151238.Node: │ │ │ │ │ -00001150: 2070 7265 6669 787f 3135 3134 3934 0a4e prefix.151494.N │ │ │ │ │ -00001160: 6f64 653a 2070 7865 5f62 6c6b 7369 7a65 ode: pxe_blksize │ │ │ │ │ -00001170: 7f31 3531 3934 330a 4e6f 6465 3a20 7078 .151943.Node: px │ │ │ │ │ -00001180: 655f 6465 6661 756c 745f 6761 7465 7761 e_default_gatewa │ │ │ │ │ -00001190: 797f 3135 3231 3230 0a4e 6f64 653a 2070 y.152120.Node: p │ │ │ │ │ -000011a0: 7865 5f64 6566 6175 6c74 5f73 6572 7665 xe_default_serve │ │ │ │ │ -000011b0: 727f 3135 3233 3235 0a4e 6f64 653a 2072 r.152325.Node: r │ │ │ │ │ -000011c0: 6f6f 747f 3135 3235 3231 0a4e 6f64 653a oot.152521.Node: │ │ │ │ │ -000011d0: 2073 7570 6572 7573 6572 737f 3135 3330 superusers.1530 │ │ │ │ │ -000011e0: 3632 0a4e 6f64 653a 2074 6865 6d65 7f31 62.Node: theme.1 │ │ │ │ │ -000011f0: 3533 3331 300a 4e6f 6465 3a20 7469 6d65 53310.Node: time │ │ │ │ │ -00001200: 6f75 747f 3135 3336 3331 0a4e 6f64 653a out.153631.Node: │ │ │ │ │ -00001210: 2074 696d 656f 7574 5f73 7479 6c65 7f31 timeout_style.1 │ │ │ │ │ -00001220: 3534 3236 380a 4e6f 6465 3a20 456e 7669 54268.Node: Envi │ │ │ │ │ -00001230: 726f 6e6d 656e 7420 626c 6f63 6b7f 3135 ronment block.15 │ │ │ │ │ -00001240: 3436 3533 0a4e 6f64 653a 2043 6f6d 6d61 4653.Node: Comma │ │ │ │ │ -00001250: 6e64 737f 3135 3630 3835 0a4e 6f64 653a nds.156085.Node: │ │ │ │ │ -00001260: 204d 656e 752d 7370 6563 6966 6963 2063 Menu-specific c │ │ │ │ │ -00001270: 6f6d 6d61 6e64 737f 3135 3639 3535 0a4e ommands.156955.N │ │ │ │ │ -00001280: 6f64 653a 206d 656e 7565 6e74 7279 7f31 ode: menuentry.1 │ │ │ │ │ -00001290: 3537 3638 330a 4e6f 6465 3a20 7375 626d 57683.Node: subm │ │ │ │ │ -000012a0: 656e 757f 3135 3932 3234 0a4e 6f64 653a enu.159224.Node: │ │ │ │ │ -000012b0: 2047 656e 6572 616c 2063 6f6d 6d61 6e64 General command │ │ │ │ │ -000012c0: 737f 3135 3937 3533 0a4e 6f64 653a 2073 s.159753.Node: s │ │ │ │ │ -000012d0: 6572 6961 6c7f 3136 3032 3439 0a4e 6f64 erial.160249.Nod │ │ │ │ │ -000012e0: 653a 2074 6572 6d69 6e61 6c5f 696e 7075 e: terminal_inpu │ │ │ │ │ -000012f0: 747f 3136 3132 3838 0a4e 6f64 653a 2074 t.161288.Node: t │ │ │ │ │ -00001300: 6572 6d69 6e61 6c5f 6f75 7470 7574 7f31 erminal_output.1 │ │ │ │ │ -00001310: 3631 3935 300a 4e6f 6465 3a20 7465 726d 61950.Node: term │ │ │ │ │ -00001320: 696e 666f 7f31 3632 3631 330a 4e6f 6465 info.162613.Node │ │ │ │ │ -00001330: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ │ -00001340: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ │ -00001350: 6d6d 616e 6473 7f31 3633 3833 360a 4e6f mmands.163836.No │ │ │ │ │ -00001360: 6465 3a20 5b7f 3136 3931 3538 0a4e 6f64 de: [.169158.Nod │ │ │ │ │ -00001370: 653a 2061 6370 697f 3136 3933 3430 0a4e e: acpi.169340.N │ │ │ │ │ -00001380: 6f64 653a 2061 7574 6865 6e74 6963 6174 ode: authenticat │ │ │ │ │ -00001390: 657f 3137 3036 3233 0a4e 6f64 653a 2062 e.170623.Node: b │ │ │ │ │ -000013a0: 6163 6b67 726f 756e 645f 636f 6c6f 727f ackground_color. │ │ │ │ │ -000013b0: 3137 3130 3530 0a4e 6f64 653a 2062 6163 171050.Node: bac │ │ │ │ │ -000013c0: 6b67 726f 756e 645f 696d 6167 657f 3137 kground_image.17 │ │ │ │ │ -000013d0: 3137 3233 0a4e 6f64 653a 2062 6164 7261 1723.Node: badra │ │ │ │ │ -000013e0: 6d7f 3137 3232 3637 0a4e 6f64 653a 2062 m.172267.Node: b │ │ │ │ │ -000013f0: 6c6f 636b 6c69 7374 7f31 3733 3635 320a locklist.173652. │ │ │ │ │ -00001400: 4e6f 6465 3a20 626f 6f74 7f31 3733 3838 Node: boot.17388 │ │ │ │ │ -00001410: 360a 4e6f 6465 3a20 6361 747f 3137 3432 6.Node: cat.1742 │ │ │ │ │ -00001420: 3038 0a4e 6f64 653a 2063 6861 696e 6c6f 08.Node: chainlo │ │ │ │ │ -00001430: 6164 6572 7f31 3734 3834 320a 4e6f 6465 ader.174842.Node │ │ │ │ │ -00001440: 3a20 636c 6561 727f 3137 3534 3638 0a4e : clear.175468.N │ │ │ │ │ -00001450: 6f64 653a 2063 6d6f 7363 6c65 616e 7f31 ode: cmosclean.1 │ │ │ │ │ -00001460: 3735 3635 340a 4e6f 6465 3a20 636d 6f73 75654.Node: cmos │ │ │ │ │ -00001470: 6475 6d70 7f31 3735 3935 380a 4e6f 6465 dump.175958.Node │ │ │ │ │ -00001480: 3a20 636d 6f73 7465 7374 7f31 3736 3235 : cmostest.17625 │ │ │ │ │ -00001490: 330a 4e6f 6465 3a20 636d 707f 3137 3636 3.Node: cmp.1766 │ │ │ │ │ -000014a0: 3131 0a4e 6f64 653a 2063 6f6e 6669 6766 11.Node: configf │ │ │ │ │ -000014b0: 696c 657f 3137 3731 3632 0a4e 6f64 653a ile.177162.Node: │ │ │ │ │ -000014c0: 2063 7075 6964 7f31 3737 3538 370a 4e6f cpuid.177587.No │ │ │ │ │ -000014d0: 6465 3a20 6372 637f 3137 3831 3538 0a4e de: crc.178158.N │ │ │ │ │ -000014e0: 6f64 653a 2063 7279 7074 6f6d 6f75 6e74 ode: cryptomount │ │ │ │ │ -000014f0: 7f31 3738 3433 320a 4e6f 6465 3a20 6375 .178432.Node: cu │ │ │ │ │ -00001500: 746d 656d 7f31 3739 3432 300a 4e6f 6465 tmem.179420.Node │ │ │ │ │ -00001510: 3a20 6461 7465 7f31 3830 3239 390a 4e6f : date.180299.No │ │ │ │ │ -00001520: 6465 3a20 6465 7669 6365 7472 6565 7f31 de: devicetree.1 │ │ │ │ │ -00001530: 3830 3834 330a 4e6f 6465 3a20 6469 7374 80843.Node: dist │ │ │ │ │ -00001540: 7275 7374 7f31 3831 3338 350a 4e6f 6465 rust.181385.Node │ │ │ │ │ -00001550: 3a20 6472 6976 656d 6170 7f31 3832 3136 : drivemap.18216 │ │ │ │ │ -00001560: 360a 4e6f 6465 3a20 6563 686f 7f31 3832 6.Node: echo.182 │ │ │ │ │ -00001570: 3936 370a 4e6f 6465 3a20 6576 616c 7f31 967.Node: eval.1 │ │ │ │ │ -00001580: 3833 3930 360a 4e6f 6465 3a20 6578 706f 83906.Node: expo │ │ │ │ │ -00001590: 7274 7f31 3834 3138 390a 4e6f 6465 3a20 rt.184189.Node: │ │ │ │ │ -000015a0: 6661 6c73 657f 3138 3435 3030 0a4e 6f64 false.184500.Nod │ │ │ │ │ -000015b0: 653a 2067 6574 7465 7874 7f31 3834 3739 e: gettext.18479 │ │ │ │ │ -000015c0: 360a 4e6f 6465 3a20 6770 7473 796e 637f 6.Node: gptsync. │ │ │ │ │ -000015d0: 3138 3532 3433 0a4e 6f64 653a 2068 616c 185243.Node: hal │ │ │ │ │ -000015e0: 747f 3138 3631 3838 0a4e 6f64 653a 2068 t.186188.Node: h │ │ │ │ │ -000015f0: 6173 6873 756d 7f31 3836 3531 370a 4e6f ashsum.186517.No │ │ │ │ │ -00001600: 6465 3a20 6865 6c70 7f31 3837 3733 330a de: help.187733. │ │ │ │ │ -00001610: 4e6f 6465 3a20 696e 6974 7264 7f31 3838 Node: initrd.188 │ │ │ │ │ -00001620: 3230 300a 4e6f 6465 3a20 696e 6974 7264 200.Node: initrd │ │ │ │ │ -00001630: 3136 7f31 3838 3633 350a 4e6f 6465 3a20 16.188635.Node: │ │ │ │ │ -00001640: 696e 736d 6f64 7f31 3839 3136 390a 4e6f insmod.189169.No │ │ │ │ │ -00001650: 6465 3a20 6b65 7973 7461 7475 737f 3138 de: keystatus.18 │ │ │ │ │ -00001660: 3933 3931 0a4e 6f64 653a 206c 696e 7578 9391.Node: linux │ │ │ │ │ -00001670: 7f31 3930 3032 340a 4e6f 6465 3a20 6c69 .190024.Node: li │ │ │ │ │ -00001680: 6e75 7831 367f 3139 3039 3237 0a4e 6f64 nux16.190927.Nod │ │ │ │ │ -00001690: 653a 206c 6973 745f 656e 767f 3139 3136 e: list_env.1916 │ │ │ │ │ -000016a0: 3431 0a4e 6f64 653a 206c 6973 745f 7472 41.Node: list_tr │ │ │ │ │ -000016b0: 7573 7465 647f 3139 3230 3035 0a4e 6f64 usted.192005.Nod │ │ │ │ │ -000016c0: 653a 206c 6f61 645f 656e 767f 3139 3235 e: load_env.1925 │ │ │ │ │ -000016d0: 3838 0a4e 6f64 653a 206c 6f61 6466 6f6e 88.Node: loadfon │ │ │ │ │ -000016e0: 747f 3139 3432 3537 0a4e 6f64 653a 206c t.194257.Node: l │ │ │ │ │ -000016f0: 6f6f 7062 6163 6b7f 3139 3436 3238 0a4e oopback.194628.N │ │ │ │ │ -00001700: 6f64 653a 206c 737f 3139 3530 3734 0a4e ode: ls.195074.N │ │ │ │ │ -00001710: 6f64 653a 206c 7366 6f6e 7473 7f31 3935 ode: lsfonts.195 │ │ │ │ │ -00001720: 3631 360a 4e6f 6465 3a20 6c73 6d6f 647f 616.Node: lsmod. │ │ │ │ │ -00001730: 3139 3537 3938 0a4e 6f64 653a 206d 6435 195798.Node: md5 │ │ │ │ │ -00001740: 7375 6d7f 3139 3539 3838 0a4e 6f64 653a sum.195988.Node: │ │ │ │ │ -00001750: 206d 6f64 756c 657f 3139 3632 3637 0a4e module.196267.N │ │ │ │ │ -00001760: 6f64 653a 206d 756c 7469 626f 6f74 7f31 ode: multiboot.1 │ │ │ │ │ -00001770: 3936 3537 390a 4e6f 6465 3a20 6e61 7469 96579.Node: nati │ │ │ │ │ -00001780: 7665 6469 736b 7f31 3937 3638 380a 4e6f vedisk.197688.No │ │ │ │ │ -00001790: 6465 3a20 6e6f 726d 616c 7f31 3938 3038 de: normal.19808 │ │ │ │ │ -000017a0: 370a 4e6f 6465 3a20 6e6f 726d 616c 5f65 7.Node: normal_e │ │ │ │ │ -000017b0: 7869 747f 3139 3838 3534 0a4e 6f64 653a xit.198854.Node: │ │ │ │ │ -000017c0: 2070 6172 7474 6f6f 6c7f 3139 3931 3736 parttool.199176 │ │ │ │ │ -000017d0: 0a4e 6f64 653a 2070 6173 7377 6f72 647f .Node: password. │ │ │ │ │ -000017e0: 3230 3036 3832 0a4e 6f64 653a 2070 6173 200682.Node: pas │ │ │ │ │ -000017f0: 7377 6f72 645f 7062 6b64 6632 7f32 3030 sword_pbkdf2.200 │ │ │ │ │ -00001800: 3936 340a 4e6f 6465 3a20 706c 6179 7f32 964.Node: play.2 │ │ │ │ │ -00001810: 3031 3337 320a 4e6f 6465 3a20 7072 6f62 01372.Node: prob │ │ │ │ │ -00001820: 657f 3230 3231 3230 0a4e 6f64 653a 2072 e.202120.Node: r │ │ │ │ │ -00001830: 646d 7372 7f32 3032 3539 380a 4e6f 6465 dmsr.202598.Node │ │ │ │ │ -00001840: 3a20 7265 6164 7f32 3033 3338 310a 4e6f : read.203381.No │ │ │ │ │ -00001850: 6465 3a20 7265 626f 6f74 7f32 3033 3732 de: reboot.20372 │ │ │ │ │ -00001860: 350a 4e6f 6465 3a20 7265 6765 7870 7f32 5.Node: regexp.2 │ │ │ │ │ -00001870: 3033 3930 380a 4e6f 6465 3a20 726d 6d6f 03908.Node: rmmo │ │ │ │ │ -00001880: 647f 3230 3434 3433 0a4e 6f64 653a 2073 d.204443.Node: s │ │ │ │ │ -00001890: 6176 655f 656e 767f 3230 3436 3336 0a4e ave_env.204636.N │ │ │ │ │ -000018a0: 6f64 653a 2073 6561 7263 687f 3230 3536 ode: search.2056 │ │ │ │ │ -000018b0: 3536 0a4e 6f64 653a 2073 656e 646b 6579 56.Node: sendkey │ │ │ │ │ -000018c0: 7f32 3036 3432 340a 4e6f 6465 3a20 7365 .206424.Node: se │ │ │ │ │ -000018d0: 747f 3231 3238 3132 0a4e 6f64 653a 2073 t.212812.Node: s │ │ │ │ │ -000018e0: 6861 3173 756d 7f32 3133 3131 340a 4e6f ha1sum.213114.No │ │ │ │ │ -000018f0: 6465 3a20 7368 6132 3536 7375 6d7f 3231 de: sha256sum.21 │ │ │ │ │ -00001900: 3333 3939 0a4e 6f64 653a 2073 6861 3531 3399.Node: sha51 │ │ │ │ │ -00001910: 3273 756d 7f32 3133 3639 380a 4e6f 6465 2sum.213698.Node │ │ │ │ │ -00001920: 3a20 736c 6565 707f 3231 3339 3935 0a4e : sleep.213995.N │ │ │ │ │ -00001930: 6f64 653a 2073 6d62 696f 737f 3231 3435 ode: smbios.2145 │ │ │ │ │ -00001940: 3135 0a4e 6f64 653a 2073 6f75 7263 657f 15.Node: source. │ │ │ │ │ -00001950: 3231 3735 3238 0a4e 6f64 653a 2074 6573 217528.Node: tes │ │ │ │ │ -00001960: 747f 3231 3830 3831 0a4e 6f64 653a 2074 t.218081.Node: t │ │ │ │ │ -00001970: 7275 657f 3232 3038 3530 0a4e 6f64 653a rue.220850.Node: │ │ │ │ │ -00001980: 2074 7275 7374 7f32 3231 3133 360a 4e6f trust.221136.No │ │ │ │ │ -00001990: 6465 3a20 756e 7365 747f 3232 3139 3236 de: unset.221926 │ │ │ │ │ -000019a0: 0a4e 6f64 653a 2076 6572 6966 795f 6465 .Node: verify_de │ │ │ │ │ -000019b0: 7461 6368 6564 7f32 3232 3134 300a 4e6f tached.222140.No │ │ │ │ │ -000019c0: 6465 3a20 7669 6465 6f69 6e66 6f7f 3232 de: videoinfo.22 │ │ │ │ │ -000019d0: 3331 3833 0a4e 6f64 653a 2077 726d 7372 3183.Node: wrmsr │ │ │ │ │ -000019e0: 7f32 3233 3436 310a 4e6f 6465 3a20 7865 .223461.Node: xe │ │ │ │ │ -000019f0: 6e5f 6879 7065 7276 6973 6f72 7f32 3234 n_hypervisor.224 │ │ │ │ │ -00001a00: 3237 350a 4e6f 6465 3a20 7865 6e5f 6d6f 275.Node: xen_mo │ │ │ │ │ -00001a10: 6475 6c65 7f32 3234 3733 360a 4e6f 6465 dule.224736.Node │ │ │ │ │ -00001a20: 3a20 4e65 7477 6f72 6b69 6e67 2063 6f6d : Networking com │ │ │ │ │ -00001a30: 6d61 6e64 737f 3232 3532 3630 0a4e 6f64 mands.225260.Nod │ │ │ │ │ -00001a40: 653a 206e 6574 5f61 6464 5f61 6464 727f e: net_add_addr. │ │ │ │ │ -00001a50: 3232 3632 3832 0a4e 6f64 653a 206e 6574 226282.Node: net │ │ │ │ │ -00001a60: 5f61 6464 5f64 6e73 7f32 3236 3830 320a _add_dns.226802. │ │ │ │ │ -00001a70: 4e6f 6465 3a20 6e65 745f 6164 645f 726f Node: net_add_ro │ │ │ │ │ -00001a80: 7574 657f 3232 3730 3738 0a4e 6f64 653a ute.227078.Node: │ │ │ │ │ -00001a90: 206e 6574 5f62 6f6f 7470 7f32 3237 3630 net_bootp.22760 │ │ │ │ │ -00001aa0: 360a 4e6f 6465 3a20 6e65 745f 6465 6c5f 6.Node: net_del_ │ │ │ │ │ -00001ab0: 6164 6472 7f32 3237 3937 310a 4e6f 6465 addr.227971.Node │ │ │ │ │ -00001ac0: 3a20 6e65 745f 6465 6c5f 646e 737f 3232 : net_del_dns.22 │ │ │ │ │ -00001ad0: 3832 3131 0a4e 6f64 653a 206e 6574 5f64 8211.Node: net_d │ │ │ │ │ -00001ae0: 656c 5f72 6f75 7465 7f32 3238 3435 380a el_route.228458. │ │ │ │ │ -00001af0: 4e6f 6465 3a20 6e65 745f 6468 6370 7f32 Node: net_dhcp.2 │ │ │ │ │ -00001b00: 3238 3639 320a 4e6f 6465 3a20 6e65 745f 28692.Node: net_ │ │ │ │ │ -00001b10: 6765 745f 6468 6370 5f6f 7074 696f 6e7f get_dhcp_option. │ │ │ │ │ -00001b20: 3233 3036 3731 0a4e 6f64 653a 206e 6574 230671.Node: net │ │ │ │ │ -00001b30: 5f69 7076 365f 6175 746f 636f 6e66 7f32 _ipv6_autoconf.2 │ │ │ │ │ -00001b40: 3331 3135 320a 4e6f 6465 3a20 6e65 745f 31152.Node: net_ │ │ │ │ │ -00001b50: 6c73 5f61 6464 727f 3233 3135 3733 0a4e ls_addr.231573.N │ │ │ │ │ -00001b60: 6f64 653a 206e 6574 5f6c 735f 6361 7264 ode: net_ls_card │ │ │ │ │ -00001b70: 737f 3233 3138 3231 0a4e 6f64 653a 206e s.231821.Node: n │ │ │ │ │ -00001b80: 6574 5f6c 735f 646e 737f 3233 3230 3537 et_ls_dns.232057 │ │ │ │ │ -00001b90: 0a4e 6f64 653a 206e 6574 5f6c 735f 726f .Node: net_ls_ro │ │ │ │ │ -00001ba0: 7574 6573 7f32 3332 3238 380a 4e6f 6465 utes.232288.Node │ │ │ │ │ -00001bb0: 3a20 6e65 745f 6e73 6c6f 6f6b 7570 7f32 : net_nslookup.2 │ │ │ │ │ -00001bc0: 3332 3439 350a 4e6f 6465 3a20 496e 7465 32495.Node: Inte │ │ │ │ │ -00001bd0: 726e 6174 696f 6e61 6c69 7361 7469 6f6e rnationalisation │ │ │ │ │ -00001be0: 7f32 3332 3737 390a 4e6f 6465 3a20 5365 .232779.Node: Se │ │ │ │ │ -00001bf0: 6375 7269 7479 7f32 3339 3631 310a 4e6f curity.239611.No │ │ │ │ │ -00001c00: 6465 3a20 4175 7468 656e 7469 6361 7469 de: Authenticati │ │ │ │ │ -00001c10: 6f6e 2061 6e64 2061 7574 686f 7269 7361 on and authorisa │ │ │ │ │ -00001c20: 7469 6f6e 7f32 3430 3138 370a 4e6f 6465 tion.240187.Node │ │ │ │ │ -00001c30: 3a20 5573 696e 6720 6469 6769 7461 6c20 : Using digital │ │ │ │ │ -00001c40: 7369 676e 6174 7572 6573 7f32 3433 3330 signatures.24330 │ │ │ │ │ -00001c50: 330a 4e6f 6465 3a20 5545 4649 2073 6563 3.Node: UEFI sec │ │ │ │ │ -00001c60: 7572 6520 626f 6f74 2061 6e64 2073 6869 ure boot and shi │ │ │ │ │ -00001c70: 6d7f 3234 3635 3733 0a4e 6f64 653a 2053 m.246573.Node: S │ │ │ │ │ -00001c80: 6563 7572 6520 426f 6f74 2041 6476 616e ecure Boot Advan │ │ │ │ │ -00001c90: 6365 6420 5461 7267 6574 696e 677f 3234 ced Targeting.24 │ │ │ │ │ -00001ca0: 3737 3230 0a4e 6f64 653a 204d 6561 7375 7720.Node: Measu │ │ │ │ │ -00001cb0: 7265 6420 426f 6f74 7f32 3438 3735 310a red Boot.248751. │ │ │ │ │ -00001cc0: 4e6f 6465 3a20 4c6f 636b 646f 776e 7f32 Node: Lockdown.2 │ │ │ │ │ -00001cd0: 3530 3731 360a 4e6f 6465 3a20 506c 6174 50716.Node: Plat │ │ │ │ │ -00001ce0: 666f 726d 206c 696d 6974 6174 696f 6e73 form limitations │ │ │ │ │ -00001cf0: 7f32 3531 3230 390a 4e6f 6465 3a20 506c .251209.Node: Pl │ │ │ │ │ -00001d00: 6174 666f 726d 2d73 7065 6369 6669 6320 atform-specific │ │ │ │ │ -00001d10: 6f70 6572 6174 696f 6e73 7f32 3539 3231 operations.25921 │ │ │ │ │ -00001d20: 380a 4e6f 6465 3a20 5375 7070 6f72 7465 8.Node: Supporte │ │ │ │ │ -00001d30: 6420 6b65 726e 656c 737f 3236 3032 3833 d kernels.260283 │ │ │ │ │ -00001d40: 0a4e 6f64 653a 2054 726f 7562 6c65 7368 .Node: Troublesh │ │ │ │ │ -00001d50: 6f6f 7469 6e67 7f32 3637 3932 300a 4e6f ooting.267920.No │ │ │ │ │ -00001d60: 6465 3a20 4752 5542 206f 6e6c 7920 6f66 de: GRUB only of │ │ │ │ │ -00001d70: 6665 7273 2061 2072 6573 6375 6520 7368 fers a rescue sh │ │ │ │ │ -00001d80: 656c 6c7f 3236 3831 3930 0a4e 6f64 653a ell.268190.Node: │ │ │ │ │ -00001d90: 2046 6972 6d77 6172 6520 7374 616c 6c73 Firmware stalls │ │ │ │ │ -00001da0: 2069 6e73 7465 6164 206f 6620 626f 6f74 instead of boot │ │ │ │ │ -00001db0: 696e 6720 4752 5542 7f32 3731 3139 390a ing GRUB.271199. │ │ │ │ │ -00001dc0: 4e6f 6465 3a20 496e 766f 6b69 6e67 2067 Node: Invoking g │ │ │ │ │ -00001dd0: 7275 622d 696e 7374 616c 6c7f 3237 3138 rub-install.2718 │ │ │ │ │ -00001de0: 3330 0a4e 6f64 653a 2049 6e76 6f6b 696e 30.Node: Invokin │ │ │ │ │ -00001df0: 6720 6772 7562 2d6d 6b63 6f6e 6669 677f g grub-mkconfig. │ │ │ │ │ -00001e00: 3237 3430 3030 0a4e 6f64 653a 2049 6e76 274000.Node: Inv │ │ │ │ │ -00001e10: 6f6b 696e 6720 6772 7562 2d6d 6b70 6173 oking grub-mkpas │ │ │ │ │ -00001e20: 7377 642d 7062 6b64 6632 7f32 3734 3633 swd-pbkdf2.27463 │ │ │ │ │ -00001e30: 370a 4e6f 6465 3a20 496e 766f 6b69 6e67 7.Node: Invoking │ │ │ │ │ -00001e40: 2067 7275 622d 6d6b 7265 6c70 6174 687f grub-mkrelpath. │ │ │ │ │ -00001e50: 3237 3532 3936 0a4e 6f64 653a 2049 6e76 275296.Node: Inv │ │ │ │ │ -00001e60: 6f6b 696e 6720 6772 7562 2d6d 6b72 6573 oking grub-mkres │ │ │ │ │ -00001e70: 6375 657f 3237 3630 3639 0a4e 6f64 653a cue.276069.Node: │ │ │ │ │ -00001e80: 2049 6e76 6f6b 696e 6720 6772 7562 2d6d Invoking grub-m │ │ │ │ │ -00001e90: 6f75 6e74 7f32 3737 3831 380a 4e6f 6465 ount.277818.Node │ │ │ │ │ -00001ea0: 3a20 496e 766f 6b69 6e67 2067 7275 622d : Invoking grub- │ │ │ │ │ -00001eb0: 7072 6f62 657f 3238 3038 3637 0a4e 6f64 probe.280867.Nod │ │ │ │ │ -00001ec0: 653a 2049 6e76 6f6b 696e 6720 6772 7562 e: Invoking grub │ │ │ │ │ -00001ed0: 2d73 6372 6970 742d 6368 6563 6b7f 3238 -script-check.28 │ │ │ │ │ -00001ee0: 3334 3631 0a4e 6f64 653a 204f 6274 6169 3461.Node: Obtai │ │ │ │ │ -00001ef0: 6e69 6e67 2061 6e64 2042 7569 6c64 696e ning and Buildin │ │ │ │ │ -00001f00: 6720 4752 5542 7f32 3834 3230 350a 4e6f g GRUB.284205.No │ │ │ │ │ -00001f10: 6465 3a20 5265 706f 7274 696e 6720 6275 de: Reporting bu │ │ │ │ │ -00001f20: 6773 7f32 3835 3434 380a 4e6f 6465 3a20 gs.285448.Node: │ │ │ │ │ -00001f30: 4675 7475 7265 7f32 3838 3236 340a 4e6f Future.288264.No │ │ │ │ │ -00001f40: 6465 3a20 436f 7079 696e 6720 5468 6973 de: Copying This │ │ │ │ │ -00001f50: 204d 616e 7561 6c7f 3238 3836 3634 0a4e Manual.288664.N │ │ │ │ │ -00001f60: 6f64 653a 2047 4e55 2046 7265 6520 446f ode: GNU Free Do │ │ │ │ │ -00001f70: 6375 6d65 6e74 6174 696f 6e20 4c69 6365 cumentation Lice │ │ │ │ │ -00001f80: 6e73 657f 3238 3838 3932 0a4e 6f64 653a nse.288892.Node: │ │ │ │ │ -00001f90: 2049 6e64 6578 7f33 3132 3433 380a 1f0a Index.312438... │ │ │ │ │ -00001fa0: 456e 6420 5461 6720 5461 626c 650a 0a1f End Tag Table... │ │ │ │ │ -00001fb0: 0a4c 6f63 616c 2056 6172 6961 626c 6573 .Local Variables │ │ │ │ │ -00001fc0: 3a0a 636f 6469 6e67 3a20 7574 662d 380a :.coding: utf-8. │ │ │ │ │ -00001fd0: 456e 643a 0a End:. │ │ │ │ │ +00000070: 3131 204a 616e 7561 7279 2032 3032 3429 11 January 2024) │ │ │ │ │ +00000080: 2e0a 0a20 2020 436f 7079 7269 6768 7420 ... Copyright │ │ │ │ │ +00000090: 2843 290a 3139 3939 2c32 3030 302c 3230 (C).1999,2000,20 │ │ │ │ │ +000000a0: 3031 2c32 3030 322c 3230 3034 2c32 3030 01,2002,2004,200 │ │ │ │ │ +000000b0: 362c 3230 3038 2c32 3030 392c 3230 3130 6,2008,2009,2010 │ │ │ │ │ +000000c0: 2c32 3031 312c 3230 3132 2c32 3031 3320 ,2011,2012,2013 │ │ │ │ │ +000000d0: 4672 6565 0a53 6f66 7477 6172 6520 466f Free.Software Fo │ │ │ │ │ +000000e0: 756e 6461 7469 6f6e 2c20 496e 632e 0a0a undation, Inc... │ │ │ │ │ +000000f0: 2020 2020 2050 6572 6d69 7373 696f 6e20 Permission │ │ │ │ │ +00000100: 6973 2067 7261 6e74 6564 2074 6f20 636f is granted to co │ │ │ │ │ +00000110: 7079 2c20 6469 7374 7269 6275 7465 2061 py, distribute a │ │ │ │ │ +00000120: 6e64 2f6f 7220 6d6f 6469 6679 2074 6869 nd/or modify thi │ │ │ │ │ +00000130: 730a 2020 2020 2064 6f63 756d 656e 7420 s. document │ │ │ │ │ +00000140: 756e 6465 7220 7468 6520 7465 726d 7320 under the terms │ │ │ │ │ +00000150: 6f66 2074 6865 2047 4e55 2046 7265 6520 of the GNU Free │ │ │ │ │ +00000160: 446f 6375 6d65 6e74 6174 696f 6e20 4c69 Documentation Li │ │ │ │ │ +00000170: 6365 6e73 652c 0a20 2020 2020 5665 7273 cense,. Vers │ │ │ │ │ +00000180: 696f 6e20 312e 3220 6f72 2061 6e79 206c ion 1.2 or any l │ │ │ │ │ +00000190: 6174 6572 2076 6572 7369 6f6e 2070 7562 ater version pub │ │ │ │ │ +000001a0: 6c69 7368 6564 2062 7920 7468 6520 4672 lished by the Fr │ │ │ │ │ +000001b0: 6565 2053 6f66 7477 6172 650a 2020 2020 ee Software. │ │ │ │ │ +000001c0: 2046 6f75 6e64 6174 696f 6e3b 2077 6974 Foundation; wit │ │ │ │ │ +000001d0: 6820 6e6f 2049 6e76 6172 6961 6e74 2053 h no Invariant S │ │ │ │ │ +000001e0: 6563 7469 6f6e 732e 0a49 4e46 4f2d 4449 ections..INFO-DI │ │ │ │ │ +000001f0: 522d 5345 4354 494f 4e20 4b65 726e 656c R-SECTION Kernel │ │ │ │ │ +00000200: 0a53 5441 5254 2d49 4e46 4f2d 4449 522d .START-INFO-DIR- │ │ │ │ │ +00000210: 454e 5452 590a 2a20 4752 5542 3a20 2867 ENTRY.* GRUB: (g │ │ │ │ │ +00000220: 7275 6229 2e20 2020 2020 2020 2020 2020 rub). │ │ │ │ │ +00000230: 2020 2020 2020 5468 6520 4752 616e 6420 The GRand │ │ │ │ │ +00000240: 556e 6966 6965 6420 426f 6f74 6c6f 6164 Unified Bootload │ │ │ │ │ +00000250: 6572 0a2a 2067 7275 622d 696e 7374 616c er.* grub-instal │ │ │ │ │ +00000260: 6c3a 2028 6772 7562 2949 6e76 6f6b 696e l: (grub)Invokin │ │ │ │ │ +00000270: 6720 6772 7562 2d69 6e73 7461 6c6c 2e20 g grub-install. │ │ │ │ │ +00000280: 2020 2049 6e73 7461 6c6c 2047 5255 4220 Install GRUB │ │ │ │ │ +00000290: 6f6e 2079 6f75 7220 6472 6976 650a 2a20 on your drive.* │ │ │ │ │ +000002a0: 6772 7562 2d6d 6b63 6f6e 6669 673a 2028 grub-mkconfig: ( │ │ │ │ │ +000002b0: 6772 7562 2949 6e76 6f6b 696e 6720 6772 grub)Invoking gr │ │ │ │ │ +000002c0: 7562 2d6d 6b63 6f6e 6669 672e 2020 4765 ub-mkconfig. Ge │ │ │ │ │ +000002d0: 6e65 7261 7465 2047 5255 4220 636f 6e66 nerate GRUB conf │ │ │ │ │ +000002e0: 6967 7572 6174 696f 6e0a 2a20 6772 7562 iguration.* grub │ │ │ │ │ +000002f0: 2d6d 6b70 6173 7377 642d 7062 6b64 6632 -mkpasswd-pbkdf2 │ │ │ │ │ +00000300: 3a20 2867 7275 6229 496e 766f 6b69 6e67 : (grub)Invoking │ │ │ │ │ +00000310: 2067 7275 622d 6d6b 7061 7373 7764 2d70 grub-mkpasswd-p │ │ │ │ │ +00000320: 626b 6466 322e 0a2a 2067 7275 622d 6d6b bkdf2..* grub-mk │ │ │ │ │ +00000330: 7265 6c70 6174 683a 2028 6772 7562 2949 relpath: (grub)I │ │ │ │ │ +00000340: 6e76 6f6b 696e 6720 6772 7562 2d6d 6b72 nvoking grub-mkr │ │ │ │ │ +00000350: 656c 7061 7468 2e0a 2a20 6772 7562 2d6d elpath..* grub-m │ │ │ │ │ +00000360: 6b72 6573 6375 653a 2028 6772 7562 2949 krescue: (grub)I │ │ │ │ │ +00000370: 6e76 6f6b 696e 6720 6772 7562 2d6d 6b72 nvoking grub-mkr │ │ │ │ │ +00000380: 6573 6375 652e 2020 4d61 6b65 2061 2047 escue. Make a G │ │ │ │ │ +00000390: 5255 4220 7265 7363 7565 2069 6d61 6765 RUB rescue image │ │ │ │ │ +000003a0: 0a2a 2067 7275 622d 6d6f 756e 743a 2028 .* grub-mount: ( │ │ │ │ │ +000003b0: 6772 7562 2949 6e76 6f6b 696e 6720 6772 grub)Invoking gr │ │ │ │ │ +000003c0: 7562 2d6d 6f75 6e74 2e20 2020 2020 2020 ub-mount. │ │ │ │ │ +000003d0: 204d 6f75 6e74 2061 2066 696c 6520 7379 Mount a file sy │ │ │ │ │ +000003e0: 7374 656d 2075 7369 6e67 2047 5255 420a stem using GRUB. │ │ │ │ │ +000003f0: 2a20 6772 7562 2d70 726f 6265 3a20 2867 * grub-probe: (g │ │ │ │ │ +00000400: 7275 6229 496e 766f 6b69 6e67 2067 7275 rub)Invoking gru │ │ │ │ │ +00000410: 622d 7072 6f62 652e 2020 2020 2020 2020 b-probe. │ │ │ │ │ +00000420: 5072 6f62 6520 6465 7669 6365 2069 6e66 Probe device inf │ │ │ │ │ +00000430: 6f72 6d61 7469 6f6e 0a2a 2067 7275 622d ormation.* grub- │ │ │ │ │ +00000440: 7363 7269 7074 2d63 6865 636b 3a20 2867 script-check: (g │ │ │ │ │ +00000450: 7275 6229 496e 766f 6b69 6e67 2067 7275 rub)Invoking gru │ │ │ │ │ +00000460: 622d 7363 7269 7074 2d63 6865 636b 2e0a b-script-check.. │ │ │ │ │ +00000470: 454e 442d 494e 464f 2d44 4952 2d45 4e54 END-INFO-DIR-ENT │ │ │ │ │ +00000480: 5259 0a0a 1f0a 496e 6469 7265 6374 3a0a RY....Indirect:. │ │ │ │ │ +00000490: 6772 7562 2e69 6e66 6f2d 313a 2031 3135 grub.info-1: 115 │ │ │ │ │ +000004a0: 360a 6772 7562 2e69 6e66 6f2d 323a 2033 6.grub.info-2: 3 │ │ │ │ │ +000004b0: 3132 3433 350a 1f0a 5461 6720 5461 626c 12435...Tag Tabl │ │ │ │ │ +000004c0: 653a 0a28 496e 6469 7265 6374 290a 4e6f e:.(Indirect).No │ │ │ │ │ +000004d0: 6465 3a20 546f 707f 3131 3536 0a4e 6f64 de: Top.1156.Nod │ │ │ │ │ +000004e0: 653a 2049 6e74 726f 6475 6374 696f 6e7f e: Introduction. │ │ │ │ │ +000004f0: 3432 3037 0a4e 6f64 653a 204f 7665 7276 4207.Node: Overv │ │ │ │ │ +00000500: 6965 777f 3436 3531 0a4e 6f64 653a 204f iew.4651.Node: O │ │ │ │ │ +00000510: 7665 7276 6965 772d 466f 6f74 6e6f 7465 verview-Footnote │ │ │ │ │ +00000520: 737f 3636 3431 0a52 6566 3a20 4f76 6572 s.6641.Ref: Over │ │ │ │ │ +00000530: 7669 6577 2d46 6f6f 746e 6f74 652d 317f view-Footnote-1. │ │ │ │ │ +00000540: 3637 3032 0a4e 6f64 653a 2048 6973 746f 6702.Node: Histo │ │ │ │ │ +00000550: 7279 7f36 3836 340a 4e6f 6465 3a20 4368 ry.6864.Node: Ch │ │ │ │ │ +00000560: 616e 6765 7320 6672 6f6d 2047 5255 4220 anges from GRUB │ │ │ │ │ +00000570: 4c65 6761 6379 7f38 3935 340a 4e6f 6465 Legacy.8954.Node │ │ │ │ │ +00000580: 3a20 4665 6174 7572 6573 7f31 3134 3330 : Features.11430 │ │ │ │ │ +00000590: 0a4e 6f64 653a 2046 6561 7475 7265 732d .Node: Features- │ │ │ │ │ +000005a0: 466f 6f74 6e6f 7465 737f 3137 3835 370a Footnotes.17857. │ │ │ │ │ +000005b0: 5265 663a 2046 6561 7475 7265 732d 466f Ref: Features-Fo │ │ │ │ │ +000005c0: 6f74 6e6f 7465 2d31 7f31 3739 3138 0a52 otnote-1.17918.R │ │ │ │ │ +000005d0: 6566 3a20 4665 6174 7572 6573 2d46 6f6f ef: Features-Foo │ │ │ │ │ +000005e0: 746e 6f74 652d 327f 3138 3031 340a 5265 tnote-2.18014.Re │ │ │ │ │ +000005f0: 663a 2046 6561 7475 7265 732d 466f 6f74 f: Features-Foot │ │ │ │ │ +00000600: 6e6f 7465 2d33 7f31 3831 3631 0a4e 6f64 note-3.18161.Nod │ │ │ │ │ +00000610: 653a 2052 6f6c 6520 6f66 2061 2062 6f6f e: Role of a boo │ │ │ │ │ +00000620: 7420 6c6f 6164 6572 7f31 3833 3036 0a4e t loader.18306.N │ │ │ │ │ +00000630: 6f64 653a 2052 6f6c 6520 6f66 2061 2062 ode: Role of a b │ │ │ │ │ +00000640: 6f6f 7420 6c6f 6164 6572 2d46 6f6f 746e oot loader-Footn │ │ │ │ │ +00000650: 6f74 6573 7f31 3936 3435 0a52 6566 3a20 otes.19645.Ref: │ │ │ │ │ +00000660: 526f 6c65 206f 6620 6120 626f 6f74 206c Role of a boot l │ │ │ │ │ +00000670: 6f61 6465 722d 466f 6f74 6e6f 7465 2d31 oader-Footnote-1 │ │ │ │ │ +00000680: 7f31 3937 3332 0a4e 6f64 653a 204e 616d .19732.Node: Nam │ │ │ │ │ +00000690: 696e 6720 636f 6e76 656e 7469 6f6e 7f31 ing convention.1 │ │ │ │ │ +000006a0: 3938 3131 0a4e 6f64 653a 204f 532d 7370 9811.Node: OS-sp │ │ │ │ │ +000006b0: 6563 6966 6963 206e 6f74 6573 2061 626f ecific notes abo │ │ │ │ │ +000006c0: 7574 2067 7275 6220 746f 6f6c 737f 3232 ut grub tools.22 │ │ │ │ │ +000006d0: 3732 320a 4e6f 6465 3a20 496e 7374 616c 722.Node: Instal │ │ │ │ │ +000006e0: 6c61 7469 6f6e 7f32 3337 3538 0a4e 6f64 lation.23758.Nod │ │ │ │ │ +000006f0: 653a 2049 6e73 7461 6c6c 696e 6720 4752 e: Installing GR │ │ │ │ │ +00000700: 5542 2075 7369 6e67 2067 7275 622d 696e UB using grub-in │ │ │ │ │ +00000710: 7374 616c 6c7f 3234 3838 300a 4e6f 6465 stall.24880.Node │ │ │ │ │ +00000720: 3a20 4d61 6b69 6e67 2061 2047 5255 4220 : Making a GRUB │ │ │ │ │ +00000730: 626f 6f74 6162 6c65 2043 442d 524f 4d7f bootable CD-ROM. │ │ │ │ │ +00000740: 3237 3139 350a 4e6f 6465 3a20 4d61 6b69 27195.Node: Maki │ │ │ │ │ +00000750: 6e67 2061 2047 5255 4220 626f 6f74 6162 ng a GRUB bootab │ │ │ │ │ +00000760: 6c65 2043 442d 524f 4d2d 466f 6f74 6e6f le CD-ROM-Footno │ │ │ │ │ +00000770: 7465 737f 3239 3035 340a 5265 663a 204d tes.29054.Ref: M │ │ │ │ │ +00000780: 616b 696e 6720 6120 4752 5542 2062 6f6f aking a GRUB boo │ │ │ │ │ +00000790: 7461 626c 6520 4344 2d52 4f4d 2d46 6f6f table CD-ROM-Foo │ │ │ │ │ +000007a0: 746e 6f74 652d 317f 3239 3135 370a 4e6f tnote-1.29157.No │ │ │ │ │ +000007b0: 6465 3a20 4465 7669 6365 206d 6170 7f32 de: Device map.2 │ │ │ │ │ +000007c0: 3932 3332 0a4e 6f64 653a 2042 494f 5320 9232.Node: BIOS │ │ │ │ │ +000007d0: 696e 7374 616c 6c61 7469 6f6e 7f33 3131 installation.311 │ │ │ │ │ +000007e0: 3939 0a4e 6f64 653a 2042 6f6f 7469 6e67 99.Node: Booting │ │ │ │ │ +000007f0: 7f33 3536 3530 0a4e 6f64 653a 2047 656e .35650.Node: Gen │ │ │ │ │ +00000800: 6572 616c 2062 6f6f 7420 6d65 7468 6f64 eral boot method │ │ │ │ │ +00000810: 737f 3336 3138 350a 4e6f 6465 3a20 4c6f s.36185.Node: Lo │ │ │ │ │ +00000820: 6164 696e 6720 616e 206f 7065 7261 7469 ading an operati │ │ │ │ │ +00000830: 6e67 2073 7973 7465 6d20 6469 7265 6374 ng system direct │ │ │ │ │ +00000840: 6c79 7f33 3639 3238 0a4e 6f64 653a 2043 ly.36928.Node: C │ │ │ │ │ +00000850: 6861 696e 2d6c 6f61 6469 6e67 7f33 3736 hain-loading.376 │ │ │ │ │ +00000860: 3539 0a4e 6f64 653a 204c 6f6f 7062 6163 59.Node: Loopbac │ │ │ │ │ +00000870: 6b20 626f 6f74 696e 677f 3338 3633 300a k booting.38630. │ │ │ │ │ +00000880: 4e6f 6465 3a20 4c56 4d20 6361 6368 6520 Node: LVM cache │ │ │ │ │ +00000890: 626f 6f74 696e 677f 3430 3330 340a 4e6f booting.40304.No │ │ │ │ │ +000008a0: 6465 3a20 4f53 2d73 7065 6369 6669 6320 de: OS-specific │ │ │ │ │ +000008b0: 6e6f 7465 737f 3431 3537 300a 4e6f 6465 notes.41570.Node │ │ │ │ │ +000008c0: 3a20 474e 552f 4875 7264 7f34 3138 3630 : GNU/Hurd.41860 │ │ │ │ │ +000008d0: 0a4e 6f64 653a 2047 4e55 2f4c 696e 7578 .Node: GNU/Linux │ │ │ │ │ +000008e0: 7f34 3239 3833 0a4e 6f64 653a 204e 6574 .42983.Node: Net │ │ │ │ │ +000008f0: 4253 447f 3434 3330 310a 4e6f 6465 3a20 BSD.44301.Node: │ │ │ │ │ +00000900: 444f 532f 5769 6e64 6f77 737f 3435 3737 DOS/Windows.4577 │ │ │ │ │ +00000910: 350a 4e6f 6465 3a20 436f 6e66 6967 7572 5.Node: Configur │ │ │ │ │ +00000920: 6174 696f 6e7f 3437 3535 330a 4e6f 6465 ation.47553.Node │ │ │ │ │ +00000930: 3a20 5369 6d70 6c65 2063 6f6e 6669 6775 : Simple configu │ │ │ │ │ +00000940: 7261 7469 6f6e 7f34 3832 3635 0a4e 6f64 ration.48265.Nod │ │ │ │ │ +00000950: 653a 2052 6f6f 7420 4964 656e 7469 6663 e: Root Identifc │ │ │ │ │ +00000960: 6174 696f 6e20 4865 7572 6973 7469 6373 ation Heuristics │ │ │ │ │ +00000970: 7f36 3537 3135 0a4e 6f64 653a 2053 6865 .65715.Node: She │ │ │ │ │ +00000980: 6c6c 2d6c 696b 6520 7363 7269 7074 696e ll-like scriptin │ │ │ │ │ +00000990: 677f 3638 3732 390a 4e6f 6465 3a20 5368 g.68729.Node: Sh │ │ │ │ │ +000009a0: 656c 6c2d 6c69 6b65 2073 6372 6970 7469 ell-like scripti │ │ │ │ │ +000009b0: 6e67 2d46 6f6f 746e 6f74 6573 7f37 3637 ng-Footnotes.767 │ │ │ │ │ +000009c0: 3932 0a52 6566 3a20 5368 656c 6c2d 6c69 92.Ref: Shell-li │ │ │ │ │ +000009d0: 6b65 2073 6372 6970 7469 6e67 2d46 6f6f ke scripting-Foo │ │ │ │ │ +000009e0: 746e 6f74 652d 317f 3736 3837 370a 4e6f tnote-1.76877.No │ │ │ │ │ +000009f0: 6465 3a20 4d75 6c74 692d 626f 6f74 206d de: Multi-boot m │ │ │ │ │ +00000a00: 616e 7561 6c20 636f 6e66 6967 7f37 3730 anual config.770 │ │ │ │ │ +00000a10: 3034 0a4e 6f64 653a 2045 6d62 6564 6465 04.Node: Embedde │ │ │ │ │ +00000a20: 6420 636f 6e66 6967 7572 6174 696f 6e7f d configuration. │ │ │ │ │ +00000a30: 3830 3631 330a 4e6f 6465 3a20 5468 656d 80613.Node: Them │ │ │ │ │ +00000a40: 6520 6669 6c65 2066 6f72 6d61 747f 3833 e file format.83 │ │ │ │ │ +00000a50: 3434 390a 5265 663a 2050 6978 6d61 702d 449.Ref: Pixmap- │ │ │ │ │ +00000a60: 7374 796c 6564 2070 726f 6772 6573 7320 styled progress │ │ │ │ │ +00000a70: 6261 727f 3834 3930 380a 5265 663a 2050 bar.84908.Ref: P │ │ │ │ │ +00000a80: 6c61 696e 2070 726f 6772 6573 7320 6261 lain progress ba │ │ │ │ │ +00000a90: 722c 2064 7261 776e 2077 6974 6820 736f r, drawn with so │ │ │ │ │ +00000aa0: 6c69 6420 636f 6c6f 722e 7f38 3439 3230 lid color..84920 │ │ │ │ │ +00000ab0: 0a52 6566 3a20 416e 2065 7861 6d70 6c65 .Ref: An example │ │ │ │ │ +00000ac0: 206f 6620 7468 6520 736c 6963 6573 2028 of the slices ( │ │ │ │ │ +00000ad0: 696e 2072 6564 2920 7573 6564 2066 6f72 in red) used for │ │ │ │ │ +00000ae0: 2061 2074 6572 6d69 6e61 6c20 7769 6e64 a terminal wind │ │ │ │ │ +00000af0: 6f77 2e20 5468 6973 2064 7261 7769 6e67 ow. This drawing │ │ │ │ │ +00000b00: 2077 6173 2063 7265 6174 6564 2061 6e64 was created and │ │ │ │ │ +00000b10: 2073 6c69 6365 6420 696e 2049 6e6b 7363 sliced in Inksc │ │ │ │ │ +00000b20: 6170 655f 2c20 6173 2074 6865 206e 6578 ape_, as the nex │ │ │ │ │ +00000b30: 7420 7365 6374 696f 6e20 6578 706c 6169 t section explai │ │ │ │ │ +00000b40: 6e73 2e7f 3838 3431 320a 4e6f 6465 3a20 ns..88412.Node: │ │ │ │ │ +00000b50: 4e65 7477 6f72 6b7f 3130 3838 3234 0a4e Network.108824.N │ │ │ │ │ +00000b60: 6f64 653a 2053 6572 6961 6c20 7465 726d ode: Serial term │ │ │ │ │ +00000b70: 696e 616c 7f31 3133 3133 380a 4e6f 6465 inal.113138.Node │ │ │ │ │ +00000b80: 3a20 5665 6e64 6f72 2070 6f77 6572 2d6f : Vendor power-o │ │ │ │ │ +00000b90: 6e20 6b65 7973 7f31 3135 3337 350a 4e6f n keys.115375.No │ │ │ │ │ +00000ba0: 6465 3a20 496d 6167 6573 7f31 3137 3331 de: Images.11731 │ │ │ │ │ +00000bb0: 300a 4e6f 6465 3a20 436f 7265 2069 6d61 0.Node: Core ima │ │ │ │ │ +00000bc0: 6765 2073 697a 6520 6c69 6d69 7461 7469 ge size limitati │ │ │ │ │ +00000bd0: 6f6e 7f31 3232 3238 350a 4e6f 6465 3a20 on.122285.Node: │ │ │ │ │ +00000be0: 4669 6c65 7379 7374 656d 7f31 3234 3834 Filesystem.12484 │ │ │ │ │ +00000bf0: 390a 4e6f 6465 3a20 4465 7669 6365 2073 9.Node: Device s │ │ │ │ │ +00000c00: 796e 7461 787f 3132 3535 3538 0a4e 6f64 yntax.125558.Nod │ │ │ │ │ +00000c10: 653a 2046 696c 6520 6e61 6d65 2073 796e e: File name syn │ │ │ │ │ +00000c20: 7461 787f 3132 3832 3539 0a4e 6f64 653a tax.128259.Node: │ │ │ │ │ +00000c30: 2042 6c6f 636b 206c 6973 7420 7379 6e74 Block list synt │ │ │ │ │ +00000c40: 6178 7f31 3239 3330 350a 4e6f 6465 3a20 ax.129305.Node: │ │ │ │ │ +00000c50: 496e 7465 7266 6163 657f 3133 3030 3339 Interface.130039 │ │ │ │ │ +00000c60: 0a4e 6f64 653a 2043 6f6d 6d61 6e64 2d6c .Node: Command-l │ │ │ │ │ +00000c70: 696e 6520 696e 7465 7266 6163 657f 3133 ine interface.13 │ │ │ │ │ +00000c80: 3038 3633 0a4e 6f64 653a 2043 6f6d 6d61 0863.Node: Comma │ │ │ │ │ +00000c90: 6e64 2d6c 696e 6520 696e 7465 7266 6163 nd-line interfac │ │ │ │ │ +00000ca0: 652d 466f 6f74 6e6f 7465 737f 3133 3238 e-Footnotes.1328 │ │ │ │ │ +00000cb0: 3037 0a52 6566 3a20 436f 6d6d 616e 642d 07.Ref: Command- │ │ │ │ │ +00000cc0: 6c69 6e65 2069 6e74 6572 6661 6365 2d46 line interface-F │ │ │ │ │ +00000cd0: 6f6f 746e 6f74 652d 317f 3133 3238 3936 ootnote-1.132896 │ │ │ │ │ +00000ce0: 0a4e 6f64 653a 204d 656e 7520 696e 7465 .Node: Menu inte │ │ │ │ │ +00000cf0: 7266 6163 657f 3133 3239 3931 0a4e 6f64 rface.132991.Nod │ │ │ │ │ +00000d00: 653a 204d 656e 7520 656e 7472 7920 6564 e: Menu entry ed │ │ │ │ │ +00000d10: 6974 6f72 7f31 3334 3030 330a 4e6f 6465 itor.134003.Node │ │ │ │ │ +00000d20: 3a20 456e 7669 726f 6e6d 656e 747f 3133 : Environment.13 │ │ │ │ │ +00000d30: 3437 3431 0a4e 6f64 653a 2053 7065 6369 4741.Node: Speci │ │ │ │ │ +00000d40: 616c 2065 6e76 6972 6f6e 6d65 6e74 2076 al environment v │ │ │ │ │ +00000d50: 6172 6961 626c 6573 7f31 3335 3434 340a ariables.135444. │ │ │ │ │ +00000d60: 4e6f 6465 3a20 6269 6f73 6e75 6d7f 3133 Node: biosnum.13 │ │ │ │ │ +00000d70: 3634 3938 0a4e 6f64 653a 2063 6865 636b 6498.Node: check │ │ │ │ │ +00000d80: 5f73 6967 6e61 7475 7265 737f 3133 3730 _signatures.1370 │ │ │ │ │ +00000d90: 3232 0a4e 6f64 653a 2063 686f 7365 6e7f 22.Node: chosen. │ │ │ │ │ +00000da0: 3133 3733 3039 0a4e 6f64 653a 2063 6d64 137309.Node: cmd │ │ │ │ │ +00000db0: 7061 7468 7f31 3337 3735 320a 4e6f 6465 path.137752.Node │ │ │ │ │ +00000dc0: 3a20 636f 6c6f 725f 6869 6768 6c69 6768 : color_highligh │ │ │ │ │ +00000dd0: 747f 3133 3831 3739 0a4e 6f64 653a 2063 t.138179.Node: c │ │ │ │ │ +00000de0: 6f6c 6f72 5f6e 6f72 6d61 6c7f 3133 3835 olor_normal.1385 │ │ │ │ │ +00000df0: 3931 0a4e 6f64 653a 2063 6f6e 6669 675f 91.Node: config_ │ │ │ │ │ +00000e00: 6469 7265 6374 6f72 797f 3134 3032 3534 directory.140254 │ │ │ │ │ +00000e10: 0a4e 6f64 653a 2063 6f6e 6669 675f 6669 .Node: config_fi │ │ │ │ │ +00000e20: 6c65 7f31 3430 3534 380a 4e6f 6465 3a20 le.140548.Node: │ │ │ │ │ +00000e30: 6465 6275 677f 3134 3039 3431 0a4e 6f64 debug.140941.Nod │ │ │ │ │ +00000e40: 653a 2064 6566 6175 6c74 7f31 3431 3338 e: default.14138 │ │ │ │ │ +00000e50: 300a 4e6f 6465 3a20 6661 6c6c 6261 636b 0.Node: fallback │ │ │ │ │ +00000e60: 7f31 3432 3830 380a 4e6f 6465 3a20 6766 .142808.Node: gf │ │ │ │ │ +00000e70: 786d 6f64 657f 3134 3331 3431 0a4e 6f64 xmode.143141.Nod │ │ │ │ │ +00000e80: 653a 2067 6678 7061 796c 6f61 647f 3134 e: gfxpayload.14 │ │ │ │ │ +00000e90: 3339 3339 0a4e 6f64 653a 2067 6678 7465 3939.Node: gfxte │ │ │ │ │ +00000ea0: 726d 5f66 6f6e 747f 3134 3530 3933 0a4e rm_font.145093.N │ │ │ │ │ +00000eb0: 6f64 653a 2067 7275 625f 6370 757f 3134 ode: grub_cpu.14 │ │ │ │ │ +00000ec0: 3533 3933 0a4e 6f64 653a 2067 7275 625f 5393.Node: grub_ │ │ │ │ │ +00000ed0: 706c 6174 666f 726d 7f31 3435 3638 310a platform.145681. │ │ │ │ │ +00000ee0: 4e6f 6465 3a20 6963 6f6e 6469 727f 3134 Node: icondir.14 │ │ │ │ │ +00000ef0: 3539 3733 0a4e 6f64 653a 206c 616e 677f 5973.Node: lang. │ │ │ │ │ +00000f00: 3134 3632 3930 0a4e 6f64 653a 206c 6f63 146290.Node: loc │ │ │ │ │ +00000f10: 616c 655f 6469 727f 3134 3637 3539 0a4e ale_dir.146759.N │ │ │ │ │ +00000f20: 6f64 653a 206d 656e 755f 636f 6c6f 725f ode: menu_color_ │ │ │ │ │ +00000f30: 6869 6768 6c69 6768 747f 3134 3732 3638 highlight.147268 │ │ │ │ │ +00000f40: 0a4e 6f64 653a 206d 656e 755f 636f 6c6f .Node: menu_colo │ │ │ │ │ +00000f50: 725f 6e6f 726d 616c 7f31 3437 3736 340a r_normal.147764. │ │ │ │ │ +00000f60: 4e6f 6465 3a20 6e65 745f 3c49 4e54 4552 Node: net__boot_file. │ │ │ │ │ +00000f80: 3134 3832 3635 0a4e 6f64 653a 206e 6574 148265.Node: net │ │ │ │ │ +00000f90: 5f3c 494e 5445 5246 4143 453e 5f64 6863 __dhc │ │ │ │ │ +00000fa0: 705f 7365 7276 6572 5f6e 616d 657f 3134 p_server_name.14 │ │ │ │ │ +00000fb0: 3835 3038 0a4e 6f64 653a 206e 6574 5f3c 8508.Node: net_< │ │ │ │ │ +00000fc0: 494e 5445 5246 4143 453e 5f64 6f6d 6169 INTERFACE>_domai │ │ │ │ │ +00000fd0: 6e7f 3134 3837 3730 0a4e 6f64 653a 206e n.148770.Node: n │ │ │ │ │ +00000fe0: 6574 5f3c 494e 5445 5246 4143 453e 5f65 et__e │ │ │ │ │ +00000ff0: 7874 656e 7369 6f6e 7370 6174 687f 3134 xtensionspath.14 │ │ │ │ │ +00001000: 3930 3137 0a4e 6f64 653a 206e 6574 5f3c 9017.Node: net_< │ │ │ │ │ +00001010: 494e 5445 5246 4143 453e 5f68 6f73 746e INTERFACE>_hostn │ │ │ │ │ +00001020: 616d 657f 3134 3932 3732 0a4e 6f64 653a ame.149272.Node: │ │ │ │ │ +00001030: 206e 6574 5f3c 494e 5445 5246 4143 453e net_ │ │ │ │ │ +00001040: 5f69 707f 3134 3935 3131 0a4e 6f64 653a _ip.149511.Node: │ │ │ │ │ +00001050: 206e 6574 5f3c 494e 5445 5246 4143 453e net_ │ │ │ │ │ +00001060: 5f6d 6163 7f31 3439 3732 370a 4e6f 6465 _mac.149727.Node │ │ │ │ │ +00001070: 3a20 6e65 745f 3c49 4e54 4552 4641 4345 : net__next_server.14 │ │ │ │ │ +00001090: 3939 3438 0a4e 6f64 653a 206e 6574 5f3c 9948.Node: net_< │ │ │ │ │ +000010a0: 494e 5445 5246 4143 453e 5f72 6f6f 7470 INTERFACE>_rootp │ │ │ │ │ +000010b0: 6174 687f 3135 3031 3931 0a4e 6f64 653a ath.150191.Node: │ │ │ │ │ +000010c0: 206e 6574 5f64 6566 6175 6c74 5f69 6e74 net_default_int │ │ │ │ │ +000010d0: 6572 6661 6365 7f31 3530 3433 300a 4e6f erface.150430.No │ │ │ │ │ +000010e0: 6465 3a20 6e65 745f 6465 6661 756c 745f de: net_default_ │ │ │ │ │ +000010f0: 6970 7f31 3530 3635 300a 4e6f 6465 3a20 ip.150650.Node: │ │ │ │ │ +00001100: 6e65 745f 6465 6661 756c 745f 6d61 637f net_default_mac. │ │ │ │ │ +00001110: 3135 3038 3437 0a4e 6f64 653a 206e 6574 150847.Node: net │ │ │ │ │ +00001120: 5f64 6566 6175 6c74 5f73 6572 7665 727f _default_server. │ │ │ │ │ +00001130: 3135 3130 3433 0a4e 6f64 653a 2070 6167 151043.Node: pag │ │ │ │ │ +00001140: 6572 7f31 3531 3233 360a 4e6f 6465 3a20 er.151236.Node: │ │ │ │ │ +00001150: 7072 6566 6978 7f31 3531 3439 320a 4e6f prefix.151492.No │ │ │ │ │ +00001160: 6465 3a20 7078 655f 626c 6b73 697a 657f de: pxe_blksize. │ │ │ │ │ +00001170: 3135 3139 3431 0a4e 6f64 653a 2070 7865 151941.Node: pxe │ │ │ │ │ +00001180: 5f64 6566 6175 6c74 5f67 6174 6577 6179 _default_gateway │ │ │ │ │ +00001190: 7f31 3532 3131 380a 4e6f 6465 3a20 7078 .152118.Node: px │ │ │ │ │ +000011a0: 655f 6465 6661 756c 745f 7365 7276 6572 e_default_server │ │ │ │ │ +000011b0: 7f31 3532 3332 330a 4e6f 6465 3a20 726f .152323.Node: ro │ │ │ │ │ +000011c0: 6f74 7f31 3532 3531 390a 4e6f 6465 3a20 ot.152519.Node: │ │ │ │ │ +000011d0: 7375 7065 7275 7365 7273 7f31 3533 3036 superusers.15306 │ │ │ │ │ +000011e0: 300a 4e6f 6465 3a20 7468 656d 657f 3135 0.Node: theme.15 │ │ │ │ │ +000011f0: 3333 3038 0a4e 6f64 653a 2074 696d 656f 3308.Node: timeo │ │ │ │ │ +00001200: 7574 7f31 3533 3632 390a 4e6f 6465 3a20 ut.153629.Node: │ │ │ │ │ +00001210: 7469 6d65 6f75 745f 7374 796c 657f 3135 timeout_style.15 │ │ │ │ │ +00001220: 3432 3636 0a4e 6f64 653a 2045 6e76 6972 4266.Node: Envir │ │ │ │ │ +00001230: 6f6e 6d65 6e74 2062 6c6f 636b 7f31 3534 onment block.154 │ │ │ │ │ +00001240: 3635 310a 4e6f 6465 3a20 436f 6d6d 616e 651.Node: Comman │ │ │ │ │ +00001250: 6473 7f31 3536 3038 330a 4e6f 6465 3a20 ds.156083.Node: │ │ │ │ │ +00001260: 4d65 6e75 2d73 7065 6369 6669 6320 636f Menu-specific co │ │ │ │ │ +00001270: 6d6d 616e 6473 7f31 3536 3935 330a 4e6f mmands.156953.No │ │ │ │ │ +00001280: 6465 3a20 6d65 6e75 656e 7472 797f 3135 de: menuentry.15 │ │ │ │ │ +00001290: 3736 3831 0a4e 6f64 653a 2073 7562 6d65 7681.Node: subme │ │ │ │ │ +000012a0: 6e75 7f31 3539 3232 320a 4e6f 6465 3a20 nu.159222.Node: │ │ │ │ │ +000012b0: 4765 6e65 7261 6c20 636f 6d6d 616e 6473 General commands │ │ │ │ │ +000012c0: 7f31 3539 3735 310a 4e6f 6465 3a20 7365 .159751.Node: se │ │ │ │ │ +000012d0: 7269 616c 7f31 3630 3234 370a 4e6f 6465 rial.160247.Node │ │ │ │ │ +000012e0: 3a20 7465 726d 696e 616c 5f69 6e70 7574 : terminal_input │ │ │ │ │ +000012f0: 7f31 3631 3238 360a 4e6f 6465 3a20 7465 .161286.Node: te │ │ │ │ │ +00001300: 726d 696e 616c 5f6f 7574 7075 747f 3136 rminal_output.16 │ │ │ │ │ +00001310: 3139 3438 0a4e 6f64 653a 2074 6572 6d69 1948.Node: termi │ │ │ │ │ +00001320: 6e66 6f7f 3136 3236 3131 0a4e 6f64 653a nfo.162611.Node: │ │ │ │ │ +00001330: 2043 6f6d 6d61 6e64 2d6c 696e 6520 616e Command-line an │ │ │ │ │ +00001340: 6420 6d65 6e75 2065 6e74 7279 2063 6f6d d menu entry com │ │ │ │ │ +00001350: 6d61 6e64 737f 3136 3338 3334 0a4e 6f64 mands.163834.Nod │ │ │ │ │ +00001360: 653a 205b 7f31 3639 3135 360a 4e6f 6465 e: [.169156.Node │ │ │ │ │ +00001370: 3a20 6163 7069 7f31 3639 3333 380a 4e6f : acpi.169338.No │ │ │ │ │ +00001380: 6465 3a20 6175 7468 656e 7469 6361 7465 de: authenticate │ │ │ │ │ +00001390: 7f31 3730 3632 310a 4e6f 6465 3a20 6261 .170621.Node: ba │ │ │ │ │ +000013a0: 636b 6772 6f75 6e64 5f63 6f6c 6f72 7f31 ckground_color.1 │ │ │ │ │ +000013b0: 3731 3034 380a 4e6f 6465 3a20 6261 636b 71048.Node: back │ │ │ │ │ +000013c0: 6772 6f75 6e64 5f69 6d61 6765 7f31 3731 ground_image.171 │ │ │ │ │ +000013d0: 3732 310a 4e6f 6465 3a20 6261 6472 616d 721.Node: badram │ │ │ │ │ +000013e0: 7f31 3732 3236 350a 4e6f 6465 3a20 626c .172265.Node: bl │ │ │ │ │ +000013f0: 6f63 6b6c 6973 747f 3137 3336 3530 0a4e ocklist.173650.N │ │ │ │ │ +00001400: 6f64 653a 2062 6f6f 747f 3137 3338 3834 ode: boot.173884 │ │ │ │ │ +00001410: 0a4e 6f64 653a 2063 6174 7f31 3734 3230 .Node: cat.17420 │ │ │ │ │ +00001420: 360a 4e6f 6465 3a20 6368 6169 6e6c 6f61 6.Node: chainloa │ │ │ │ │ +00001430: 6465 727f 3137 3438 3430 0a4e 6f64 653a der.174840.Node: │ │ │ │ │ +00001440: 2063 6c65 6172 7f31 3735 3436 360a 4e6f clear.175466.No │ │ │ │ │ +00001450: 6465 3a20 636d 6f73 636c 6561 6e7f 3137 de: cmosclean.17 │ │ │ │ │ +00001460: 3536 3532 0a4e 6f64 653a 2063 6d6f 7364 5652.Node: cmosd │ │ │ │ │ +00001470: 756d 707f 3137 3539 3536 0a4e 6f64 653a ump.175956.Node: │ │ │ │ │ +00001480: 2063 6d6f 7374 6573 747f 3137 3632 3531 cmostest.176251 │ │ │ │ │ +00001490: 0a4e 6f64 653a 2063 6d70 7f31 3736 3630 .Node: cmp.17660 │ │ │ │ │ +000014a0: 390a 4e6f 6465 3a20 636f 6e66 6967 6669 9.Node: configfi │ │ │ │ │ +000014b0: 6c65 7f31 3737 3136 300a 4e6f 6465 3a20 le.177160.Node: │ │ │ │ │ +000014c0: 6370 7569 647f 3137 3735 3835 0a4e 6f64 cpuid.177585.Nod │ │ │ │ │ +000014d0: 653a 2063 7263 7f31 3738 3135 360a 4e6f e: crc.178156.No │ │ │ │ │ +000014e0: 6465 3a20 6372 7970 746f 6d6f 756e 747f de: cryptomount. │ │ │ │ │ +000014f0: 3137 3834 3330 0a4e 6f64 653a 2063 7574 178430.Node: cut │ │ │ │ │ +00001500: 6d65 6d7f 3137 3934 3138 0a4e 6f64 653a mem.179418.Node: │ │ │ │ │ +00001510: 2064 6174 657f 3138 3032 3937 0a4e 6f64 date.180297.Nod │ │ │ │ │ +00001520: 653a 2064 6576 6963 6574 7265 657f 3138 e: devicetree.18 │ │ │ │ │ +00001530: 3038 3431 0a4e 6f64 653a 2064 6973 7472 0841.Node: distr │ │ │ │ │ +00001540: 7573 747f 3138 3133 3833 0a4e 6f64 653a ust.181383.Node: │ │ │ │ │ +00001550: 2064 7269 7665 6d61 707f 3138 3231 3634 drivemap.182164 │ │ │ │ │ +00001560: 0a4e 6f64 653a 2065 6368 6f7f 3138 3239 .Node: echo.1829 │ │ │ │ │ +00001570: 3635 0a4e 6f64 653a 2065 7661 6c7f 3138 65.Node: eval.18 │ │ │ │ │ +00001580: 3339 3034 0a4e 6f64 653a 2065 7870 6f72 3904.Node: expor │ │ │ │ │ +00001590: 747f 3138 3431 3837 0a4e 6f64 653a 2066 t.184187.Node: f │ │ │ │ │ +000015a0: 616c 7365 7f31 3834 3439 380a 4e6f 6465 alse.184498.Node │ │ │ │ │ +000015b0: 3a20 6765 7474 6578 747f 3138 3437 3934 : gettext.184794 │ │ │ │ │ +000015c0: 0a4e 6f64 653a 2067 7074 7379 6e63 7f31 .Node: gptsync.1 │ │ │ │ │ +000015d0: 3835 3234 310a 4e6f 6465 3a20 6861 6c74 85241.Node: halt │ │ │ │ │ +000015e0: 7f31 3836 3138 360a 4e6f 6465 3a20 6861 .186186.Node: ha │ │ │ │ │ +000015f0: 7368 7375 6d7f 3138 3635 3135 0a4e 6f64 shsum.186515.Nod │ │ │ │ │ +00001600: 653a 2068 656c 707f 3138 3737 3331 0a4e e: help.187731.N │ │ │ │ │ +00001610: 6f64 653a 2069 6e69 7472 647f 3138 3831 ode: initrd.1881 │ │ │ │ │ +00001620: 3938 0a4e 6f64 653a 2069 6e69 7472 6431 98.Node: initrd1 │ │ │ │ │ +00001630: 367f 3138 3836 3333 0a4e 6f64 653a 2069 6.188633.Node: i │ │ │ │ │ +00001640: 6e73 6d6f 647f 3138 3931 3637 0a4e 6f64 nsmod.189167.Nod │ │ │ │ │ +00001650: 653a 206b 6579 7374 6174 7573 7f31 3839 e: keystatus.189 │ │ │ │ │ +00001660: 3338 390a 4e6f 6465 3a20 6c69 6e75 787f 389.Node: linux. │ │ │ │ │ +00001670: 3139 3030 3232 0a4e 6f64 653a 206c 696e 190022.Node: lin │ │ │ │ │ +00001680: 7578 3136 7f31 3930 3932 350a 4e6f 6465 ux16.190925.Node │ │ │ │ │ +00001690: 3a20 6c69 7374 5f65 6e76 7f31 3931 3633 : list_env.19163 │ │ │ │ │ +000016a0: 390a 4e6f 6465 3a20 6c69 7374 5f74 7275 9.Node: list_tru │ │ │ │ │ +000016b0: 7374 6564 7f31 3932 3030 330a 4e6f 6465 sted.192003.Node │ │ │ │ │ +000016c0: 3a20 6c6f 6164 5f65 6e76 7f31 3932 3538 : load_env.19258 │ │ │ │ │ +000016d0: 360a 4e6f 6465 3a20 6c6f 6164 666f 6e74 6.Node: loadfont │ │ │ │ │ +000016e0: 7f31 3934 3235 350a 4e6f 6465 3a20 6c6f .194255.Node: lo │ │ │ │ │ +000016f0: 6f70 6261 636b 7f31 3934 3632 360a 4e6f opback.194626.No │ │ │ │ │ +00001700: 6465 3a20 6c73 7f31 3935 3037 320a 4e6f de: ls.195072.No │ │ │ │ │ +00001710: 6465 3a20 6c73 666f 6e74 737f 3139 3536 de: lsfonts.1956 │ │ │ │ │ +00001720: 3134 0a4e 6f64 653a 206c 736d 6f64 7f31 14.Node: lsmod.1 │ │ │ │ │ +00001730: 3935 3739 360a 4e6f 6465 3a20 6d64 3573 95796.Node: md5s │ │ │ │ │ +00001740: 756d 7f31 3935 3938 360a 4e6f 6465 3a20 um.195986.Node: │ │ │ │ │ +00001750: 6d6f 6475 6c65 7f31 3936 3236 350a 4e6f module.196265.No │ │ │ │ │ +00001760: 6465 3a20 6d75 6c74 6962 6f6f 747f 3139 de: multiboot.19 │ │ │ │ │ +00001770: 3635 3737 0a4e 6f64 653a 206e 6174 6976 6577.Node: nativ │ │ │ │ │ +00001780: 6564 6973 6b7f 3139 3736 3836 0a4e 6f64 edisk.197686.Nod │ │ │ │ │ +00001790: 653a 206e 6f72 6d61 6c7f 3139 3830 3835 e: normal.198085 │ │ │ │ │ +000017a0: 0a4e 6f64 653a 206e 6f72 6d61 6c5f 6578 .Node: normal_ex │ │ │ │ │ +000017b0: 6974 7f31 3938 3835 320a 4e6f 6465 3a20 it.198852.Node: │ │ │ │ │ +000017c0: 7061 7274 746f 6f6c 7f31 3939 3137 340a parttool.199174. │ │ │ │ │ +000017d0: 4e6f 6465 3a20 7061 7373 776f 7264 7f32 Node: password.2 │ │ │ │ │ +000017e0: 3030 3638 300a 4e6f 6465 3a20 7061 7373 00680.Node: pass │ │ │ │ │ +000017f0: 776f 7264 5f70 626b 6466 327f 3230 3039 word_pbkdf2.2009 │ │ │ │ │ +00001800: 3632 0a4e 6f64 653a 2070 6c61 797f 3230 62.Node: play.20 │ │ │ │ │ +00001810: 3133 3730 0a4e 6f64 653a 2070 726f 6265 1370.Node: probe │ │ │ │ │ +00001820: 7f32 3032 3131 380a 4e6f 6465 3a20 7264 .202118.Node: rd │ │ │ │ │ +00001830: 6d73 727f 3230 3235 3936 0a4e 6f64 653a msr.202596.Node: │ │ │ │ │ +00001840: 2072 6561 647f 3230 3333 3739 0a4e 6f64 read.203379.Nod │ │ │ │ │ +00001850: 653a 2072 6562 6f6f 747f 3230 3337 3233 e: reboot.203723 │ │ │ │ │ +00001860: 0a4e 6f64 653a 2072 6567 6578 707f 3230 .Node: regexp.20 │ │ │ │ │ +00001870: 3339 3036 0a4e 6f64 653a 2072 6d6d 6f64 3906.Node: rmmod │ │ │ │ │ +00001880: 7f32 3034 3434 310a 4e6f 6465 3a20 7361 .204441.Node: sa │ │ │ │ │ +00001890: 7665 5f65 6e76 7f32 3034 3633 340a 4e6f ve_env.204634.No │ │ │ │ │ +000018a0: 6465 3a20 7365 6172 6368 7f32 3035 3635 de: search.20565 │ │ │ │ │ +000018b0: 340a 4e6f 6465 3a20 7365 6e64 6b65 797f 4.Node: sendkey. │ │ │ │ │ +000018c0: 3230 3634 3232 0a4e 6f64 653a 2073 6574 206422.Node: set │ │ │ │ │ +000018d0: 7f32 3132 3831 300a 4e6f 6465 3a20 7368 .212810.Node: sh │ │ │ │ │ +000018e0: 6131 7375 6d7f 3231 3331 3132 0a4e 6f64 a1sum.213112.Nod │ │ │ │ │ +000018f0: 653a 2073 6861 3235 3673 756d 7f32 3133 e: sha256sum.213 │ │ │ │ │ +00001900: 3339 370a 4e6f 6465 3a20 7368 6135 3132 397.Node: sha512 │ │ │ │ │ +00001910: 7375 6d7f 3231 3336 3936 0a4e 6f64 653a sum.213696.Node: │ │ │ │ │ +00001920: 2073 6c65 6570 7f32 3133 3939 330a 4e6f sleep.213993.No │ │ │ │ │ +00001930: 6465 3a20 736d 6269 6f73 7f32 3134 3531 de: smbios.21451 │ │ │ │ │ +00001940: 330a 4e6f 6465 3a20 736f 7572 6365 7f32 3.Node: source.2 │ │ │ │ │ +00001950: 3137 3532 360a 4e6f 6465 3a20 7465 7374 17526.Node: test │ │ │ │ │ +00001960: 7f32 3138 3037 390a 4e6f 6465 3a20 7472 .218079.Node: tr │ │ │ │ │ +00001970: 7565 7f32 3230 3834 380a 4e6f 6465 3a20 ue.220848.Node: │ │ │ │ │ +00001980: 7472 7573 747f 3232 3131 3334 0a4e 6f64 trust.221134.Nod │ │ │ │ │ +00001990: 653a 2075 6e73 6574 7f32 3231 3932 340a e: unset.221924. │ │ │ │ │ +000019a0: 4e6f 6465 3a20 7665 7269 6679 5f64 6574 Node: verify_det │ │ │ │ │ +000019b0: 6163 6865 647f 3232 3231 3338 0a4e 6f64 ached.222138.Nod │ │ │ │ │ +000019c0: 653a 2076 6964 656f 696e 666f 7f32 3233 e: videoinfo.223 │ │ │ │ │ +000019d0: 3138 310a 4e6f 6465 3a20 7772 6d73 727f 181.Node: wrmsr. │ │ │ │ │ +000019e0: 3232 3334 3539 0a4e 6f64 653a 2078 656e 223459.Node: xen │ │ │ │ │ +000019f0: 5f68 7970 6572 7669 736f 727f 3232 3432 _hypervisor.2242 │ │ │ │ │ +00001a00: 3733 0a4e 6f64 653a 2078 656e 5f6d 6f64 73.Node: xen_mod │ │ │ │ │ +00001a10: 756c 657f 3232 3437 3334 0a4e 6f64 653a ule.224734.Node: │ │ │ │ │ +00001a20: 204e 6574 776f 726b 696e 6720 636f 6d6d Networking comm │ │ │ │ │ +00001a30: 616e 6473 7f32 3235 3235 380a 4e6f 6465 ands.225258.Node │ │ │ │ │ +00001a40: 3a20 6e65 745f 6164 645f 6164 6472 7f32 : net_add_addr.2 │ │ │ │ │ +00001a50: 3236 3238 300a 4e6f 6465 3a20 6e65 745f 26280.Node: net_ │ │ │ │ │ +00001a60: 6164 645f 646e 737f 3232 3638 3030 0a4e add_dns.226800.N │ │ │ │ │ +00001a70: 6f64 653a 206e 6574 5f61 6464 5f72 6f75 ode: net_add_rou │ │ │ │ │ +00001a80: 7465 7f32 3237 3037 360a 4e6f 6465 3a20 te.227076.Node: │ │ │ │ │ +00001a90: 6e65 745f 626f 6f74 707f 3232 3736 3034 net_bootp.227604 │ │ │ │ │ +00001aa0: 0a4e 6f64 653a 206e 6574 5f64 656c 5f61 .Node: net_del_a │ │ │ │ │ +00001ab0: 6464 727f 3232 3739 3639 0a4e 6f64 653a ddr.227969.Node: │ │ │ │ │ +00001ac0: 206e 6574 5f64 656c 5f64 6e73 7f32 3238 net_del_dns.228 │ │ │ │ │ +00001ad0: 3230 390a 4e6f 6465 3a20 6e65 745f 6465 209.Node: net_de │ │ │ │ │ +00001ae0: 6c5f 726f 7574 657f 3232 3834 3536 0a4e l_route.228456.N │ │ │ │ │ +00001af0: 6f64 653a 206e 6574 5f64 6863 707f 3232 ode: net_dhcp.22 │ │ │ │ │ +00001b00: 3836 3930 0a4e 6f64 653a 206e 6574 5f67 8690.Node: net_g │ │ │ │ │ +00001b10: 6574 5f64 6863 705f 6f70 7469 6f6e 7f32 et_dhcp_option.2 │ │ │ │ │ +00001b20: 3330 3636 390a 4e6f 6465 3a20 6e65 745f 30669.Node: net_ │ │ │ │ │ +00001b30: 6970 7636 5f61 7574 6f63 6f6e 667f 3233 ipv6_autoconf.23 │ │ │ │ │ +00001b40: 3131 3530 0a4e 6f64 653a 206e 6574 5f6c 1150.Node: net_l │ │ │ │ │ +00001b50: 735f 6164 6472 7f32 3331 3537 310a 4e6f s_addr.231571.No │ │ │ │ │ +00001b60: 6465 3a20 6e65 745f 6c73 5f63 6172 6473 de: net_ls_cards │ │ │ │ │ +00001b70: 7f32 3331 3831 390a 4e6f 6465 3a20 6e65 .231819.Node: ne │ │ │ │ │ +00001b80: 745f 6c73 5f64 6e73 7f32 3332 3035 350a t_ls_dns.232055. │ │ │ │ │ +00001b90: 4e6f 6465 3a20 6e65 745f 6c73 5f72 6f75 Node: net_ls_rou │ │ │ │ │ +00001ba0: 7465 737f 3233 3232 3836 0a4e 6f64 653a tes.232286.Node: │ │ │ │ │ +00001bb0: 206e 6574 5f6e 736c 6f6f 6b75 707f 3233 net_nslookup.23 │ │ │ │ │ +00001bc0: 3234 3933 0a4e 6f64 653a 2049 6e74 6572 2493.Node: Inter │ │ │ │ │ +00001bd0: 6e61 7469 6f6e 616c 6973 6174 696f 6e7f nationalisation. │ │ │ │ │ +00001be0: 3233 3237 3737 0a4e 6f64 653a 2053 6563 232777.Node: Sec │ │ │ │ │ +00001bf0: 7572 6974 797f 3233 3936 3039 0a4e 6f64 urity.239609.Nod │ │ │ │ │ +00001c00: 653a 2041 7574 6865 6e74 6963 6174 696f e: Authenticatio │ │ │ │ │ +00001c10: 6e20 616e 6420 6175 7468 6f72 6973 6174 n and authorisat │ │ │ │ │ +00001c20: 696f 6e7f 3234 3031 3835 0a4e 6f64 653a ion.240185.Node: │ │ │ │ │ +00001c30: 2055 7369 6e67 2064 6967 6974 616c 2073 Using digital s │ │ │ │ │ +00001c40: 6967 6e61 7475 7265 737f 3234 3333 3031 ignatures.243301 │ │ │ │ │ +00001c50: 0a4e 6f64 653a 2055 4546 4920 7365 6375 .Node: UEFI secu │ │ │ │ │ +00001c60: 7265 2062 6f6f 7420 616e 6420 7368 696d re boot and shim │ │ │ │ │ +00001c70: 7f32 3436 3537 310a 4e6f 6465 3a20 5365 .246571.Node: Se │ │ │ │ │ +00001c80: 6375 7265 2042 6f6f 7420 4164 7661 6e63 cure Boot Advanc │ │ │ │ │ +00001c90: 6564 2054 6172 6765 7469 6e67 7f32 3437 ed Targeting.247 │ │ │ │ │ +00001ca0: 3731 380a 4e6f 6465 3a20 4d65 6173 7572 718.Node: Measur │ │ │ │ │ +00001cb0: 6564 2042 6f6f 747f 3234 3837 3439 0a4e ed Boot.248749.N │ │ │ │ │ +00001cc0: 6f64 653a 204c 6f63 6b64 6f77 6e7f 3235 ode: Lockdown.25 │ │ │ │ │ +00001cd0: 3037 3134 0a4e 6f64 653a 2050 6c61 7466 0714.Node: Platf │ │ │ │ │ +00001ce0: 6f72 6d20 6c69 6d69 7461 7469 6f6e 737f orm limitations. │ │ │ │ │ +00001cf0: 3235 3132 3037 0a4e 6f64 653a 2050 6c61 251207.Node: Pla │ │ │ │ │ +00001d00: 7466 6f72 6d2d 7370 6563 6966 6963 206f tform-specific o │ │ │ │ │ +00001d10: 7065 7261 7469 6f6e 737f 3235 3932 3136 perations.259216 │ │ │ │ │ +00001d20: 0a4e 6f64 653a 2053 7570 706f 7274 6564 .Node: Supported │ │ │ │ │ +00001d30: 206b 6572 6e65 6c73 7f32 3630 3238 310a kernels.260281. │ │ │ │ │ +00001d40: 4e6f 6465 3a20 5472 6f75 626c 6573 686f Node: Troublesho │ │ │ │ │ +00001d50: 6f74 696e 677f 3236 3739 3138 0a4e 6f64 oting.267918.Nod │ │ │ │ │ +00001d60: 653a 2047 5255 4220 6f6e 6c79 206f 6666 e: GRUB only off │ │ │ │ │ +00001d70: 6572 7320 6120 7265 7363 7565 2073 6865 ers a rescue she │ │ │ │ │ +00001d80: 6c6c 7f32 3638 3138 380a 4e6f 6465 3a20 ll.268188.Node: │ │ │ │ │ +00001d90: 4669 726d 7761 7265 2073 7461 6c6c 7320 Firmware stalls │ │ │ │ │ +00001da0: 696e 7374 6561 6420 6f66 2062 6f6f 7469 instead of booti │ │ │ │ │ +00001db0: 6e67 2047 5255 427f 3237 3131 3937 0a4e ng GRUB.271197.N │ │ │ │ │ +00001dc0: 6f64 653a 2049 6e76 6f6b 696e 6720 6772 ode: Invoking gr │ │ │ │ │ +00001dd0: 7562 2d69 6e73 7461 6c6c 7f32 3731 3832 ub-install.27182 │ │ │ │ │ +00001de0: 380a 4e6f 6465 3a20 496e 766f 6b69 6e67 8.Node: Invoking │ │ │ │ │ +00001df0: 2067 7275 622d 6d6b 636f 6e66 6967 7f32 grub-mkconfig.2 │ │ │ │ │ +00001e00: 3733 3939 380a 4e6f 6465 3a20 496e 766f 73998.Node: Invo │ │ │ │ │ +00001e10: 6b69 6e67 2067 7275 622d 6d6b 7061 7373 king grub-mkpass │ │ │ │ │ +00001e20: 7764 2d70 626b 6466 327f 3237 3436 3335 wd-pbkdf2.274635 │ │ │ │ │ +00001e30: 0a4e 6f64 653a 2049 6e76 6f6b 696e 6720 .Node: Invoking │ │ │ │ │ +00001e40: 6772 7562 2d6d 6b72 656c 7061 7468 7f32 grub-mkrelpath.2 │ │ │ │ │ +00001e50: 3735 3239 340a 4e6f 6465 3a20 496e 766f 75294.Node: Invo │ │ │ │ │ +00001e60: 6b69 6e67 2067 7275 622d 6d6b 7265 7363 king grub-mkresc │ │ │ │ │ +00001e70: 7565 7f32 3736 3036 370a 4e6f 6465 3a20 ue.276067.Node: │ │ │ │ │ +00001e80: 496e 766f 6b69 6e67 2067 7275 622d 6d6f Invoking grub-mo │ │ │ │ │ +00001e90: 756e 747f 3237 3738 3136 0a4e 6f64 653a unt.277816.Node: │ │ │ │ │ +00001ea0: 2049 6e76 6f6b 696e 6720 6772 7562 2d70 Invoking grub-p │ │ │ │ │ +00001eb0: 726f 6265 7f32 3830 3836 350a 4e6f 6465 robe.280865.Node │ │ │ │ │ +00001ec0: 3a20 496e 766f 6b69 6e67 2067 7275 622d : Invoking grub- │ │ │ │ │ +00001ed0: 7363 7269 7074 2d63 6865 636b 7f32 3833 script-check.283 │ │ │ │ │ +00001ee0: 3435 390a 4e6f 6465 3a20 4f62 7461 696e 459.Node: Obtain │ │ │ │ │ +00001ef0: 696e 6720 616e 6420 4275 696c 6469 6e67 ing and Building │ │ │ │ │ +00001f00: 2047 5255 427f 3238 3432 3033 0a4e 6f64 GRUB.284203.Nod │ │ │ │ │ +00001f10: 653a 2052 6570 6f72 7469 6e67 2062 7567 e: Reporting bug │ │ │ │ │ +00001f20: 737f 3238 3534 3436 0a4e 6f64 653a 2046 s.285446.Node: F │ │ │ │ │ +00001f30: 7574 7572 657f 3238 3832 3632 0a4e 6f64 uture.288262.Nod │ │ │ │ │ +00001f40: 653a 2043 6f70 7969 6e67 2054 6869 7320 e: Copying This │ │ │ │ │ +00001f50: 4d61 6e75 616c 7f32 3838 3636 320a 4e6f Manual.288662.No │ │ │ │ │ +00001f60: 6465 3a20 474e 5520 4672 6565 2044 6f63 de: GNU Free Doc │ │ │ │ │ +00001f70: 756d 656e 7461 7469 6f6e 204c 6963 656e umentation Licen │ │ │ │ │ +00001f80: 7365 7f32 3838 3839 300a 4e6f 6465 3a20 se.288890.Node: │ │ │ │ │ +00001f90: 496e 6465 787f 3331 3234 3335 0a1f 0a45 Index.312435...E │ │ │ │ │ +00001fa0: 6e64 2054 6167 2054 6162 6c65 0a0a 1f0a nd Tag Table.... │ │ │ │ │ +00001fb0: 4c6f 6361 6c20 5661 7269 6162 6c65 733a Local Variables: │ │ │ │ │ +00001fc0: 0a63 6f64 696e 673a 2075 7466 2d38 0a45 .coding: utf-8.E │ │ │ │ │ +00001fd0: 6e64 3a0a nd:.