in→docs

docs/public/grub/index.rst

@@ -0,0 +1,7 @@
+grub
+====
+
+.. toctree::
+
+   modules
+   standalone

docs/public/grub/modules.rst

@@ -0,0 +1,405 @@
+.. _grub_modules:
+
+Modules
+=======
+
+Included
+--------
+
+======= ==
+memdisk | 
+tar     | 
+======= ==
+
+Mandatory
+---------
+
+====== ==
+normal | 
+====== ==
+
+dependencies
+^^^^^^^^^^^^
+
+======== ==
+boot     | 
+bufio    | 
+crypto   | 
+extcmd   | 
+gettext  | 
+terminal | 
+======== ==
+
+Useful
+------
+
+core
+^^^^
+
+========== ==
+date       | 
+echo       | 
+eval       | 
+help       | 
+keylayouts | 
+ls         | 
+sleep      | 
+test       | 
+true       | 
+========== ==
+
+hw
+^^
+
+========= ==
+cpuid     | 
+lspci     | 
+terminfo  | 
+videoinfo | 
+========= ==
+
+part
+^^^^
+
+========== ==
+lvm        | 
+mdraid1x   | 
+part_bsd   | 
+part_dfly  | 
+part_gpt   | 
+part_msdos | 
+raid5rec   | 
+========== ==
+
+fs
+^^
+
+=========== ==
+btrfs       | 
+exfat       | 
+ext2        | 
+fat         | 
+hfs         | 
+hfspluscomp | 
+iso9660     | 
+ntfscomp    | 
+squash4     | 
+udf         | 
+xfs         | 
+zfs         | 
+=========== ==
+
+file
+^^^^
+
+======== ==
+cat      | 
+cmp      | 
+file     | 
+hexdump  | 
+loadenv  | 
+loopback | 
+probe    | 
+regexp   | 
+search   | 
+======== ==
+
+hash
+^^^^
+
+=========== ==
+hashsum     | 
+gcry_sha1   | 
+gcry_sha256 | 
+gcry_sha512 | 
+=========== ==
+
+action
+^^^^^^
+
+========== ==
+bsd        | 
+configfile | 
+halt       | 
+keystatus  | 
+linux      | 
+read       | 
+reboot     | 
+========== ==
+
+gfx
+^^^
+
+================== ==
+gfxterm_background | 
+jpeg               | 
+png                | 
+================== ==
+
+bench
+^^^^^
+
+========= ==
+progress  | 
+testspeed | 
+========= ==
+
+i386-pc
+^^^^^^^
+
+======== =================================
+biosdisk | detect disks through bios
+drivemap | map drives for windows bullshit
+ntldr    | load windows bootmgr or ntldr
+======== =================================
+
+Useless
+-------
+
+============ ==
+at_keyboard  | 
+gcry_crc     | 
+gcry_md4     | 
+gcry_md5     | 
+mdraid09     | 
+mdraid09_be  | 
+memrw        | 
+random       | 
+tga          | 
+time         | 
+usb_keyboard | 
+usbtest      | 
+videotest    | 
+============ ==
+
+i386-pc
+^^^^^^^
+
+= ==
+? | 
+= ==
+
+Untested
+--------
+
+========== ==
+part_acorn | 
+part_amiga | 
+part_apple | 
+part_dvh   | 
+part_plan  | 
+part_sun   | 
+part_sunpc | 
+========== ==
+
+========= ==
+affs      | 
+afs       | 
+bfs       | 
+cbfs      | 
+cpio      | 
+cpio_be   | 
+hfsplus   | 
+jfs       | 
+minix     | 
+minix_be  | 
+minix2    | 
+minix2_be | 
+minix3    | 
+minix3_be | 
+nilfs2    | 
+ntfs      | 
+procfs    | 
+reiserfs  | 
+romfs     | 
+sfs       | 
+ufs1      | 
+ufs1_be   | 
+ufs2      | 
+========= ==
+
+============== ==
+adler32        | 
+crc64          | 
+gcry_arcfour   | 
+gcry_blowfish  | 
+gcry_camellia  | 
+gcry_cast5     | 
+gcry_des       | 
+gcry_dsa       | 
+gcry_idea      | 
+gcry_rfc2268   | 
+gcry_rijndael  | 
+gcry_rmd160    | 
+gcry_rsa       | 
+gcry_seed      | 
+gcry_serpent   | 
+gcry_tiger     | 
+gcry_twofish   | 
+gcry_whirlpool | 
+============== ==
+
+==================== ==
+acpi
+ahci
+all_video
+aout
+archelp
+ata
+backtrace
+bitmap
+bitmap_scale
+blocklist
+bswap_test
+cbls
+cbmemc
+cbtable
+cbtime
+chain
+cmdline_cat_test
+cmp_test
+cryptodisk
+cs5536
+ctz_test
+datehook
+datetime
+disk
+diskfilter
+div
+div_test
+dm_nv
+ehci
+elf
+exfctest
+font
+fshelp
+functional_test
+geli
+gfxmenu
+gfxterm
+gfxterm_menu
+gptsync
+gzio
+hdparm
+hello
+http
+iorw
+ldm
+legacycfg
+legacy_password_test
+linux16
+lsacpi
+lsmmap
+luks
+lzopio
+macbless
+macho
+memrw
+minicmd
+mmap
+morse
+mpi
+msdospart
+mul_test
+multiboot
+multiboot2
+nativedisk
+net
+newc
+odc
+offsetio
+ohci
+parttool
+password
+password_pbkdf2
+pata
+pbkdf2
+pbkdf2_test
+pcidump
+play
+priority_queue
+
+raid6rec
+relocator
+scsi
+search_fs_file
+search_fs_uuid
+search_label
+serial
+setjmp
+setjmp_test
+setpci
+shift_test
+signature_test
+sleep_test
+spkmodem
+syslinuxcfg
+test_blockarg
+testload
+tftp
+trig
+tr
+uhci
+usb
+usbms
+usbserial_common
+usbserial_ftdi
+usbserial_pl2303
+usbserial_usbdebug
+verify
+video_bochs
+video_cirrus
+video_colors
+video_fb
+video
+videotest_checksum
+xnu
+xnu_uuid
+xnu_uuid_test
+xzio
+zfscrypt
+zfsinfo
+zfs
+==================== ==
+
+x86_64-efi
+^^^^^^^^^^
+
+=========== ==
+appleldr    | 
+efifwsetup  | 
+efi_gop     | 
+efinet      | 
+efi_uga     | 
+fixvideo    | 
+linuxefi    | 
+loadbios    | 
+lsefimmap   | 
+lsefi       | 
+lsefisystab | 
+lssal       | 
+=========== ==
+
+i386-pc
+^^^^^^^
+
+============= ==
+915resolution | 
+cmosdump      | 
+cmostest      | 
+efiemu        | 
+freedos       | 
+gdb           | 
+hwmatch       | 
+lsapm         | 
+mda_text      | 
+pci           | 
+plan9         | 
+pxechain      | 
+pxe           | 
+sendkey       | 
+truecrypt     | 
+vbe           | 
+vga           | 
+vga_text      | 
+============= ==

docs/public/grub/standalone.rst

@@ -0,0 +1,316 @@
+************************
+Prepare a boot directory
+************************
+
+Choose useful modules
+=====================
+
+Commented list: :ref:`grub_modules`
+
+Download packages
+=================
+
+current
+-------
+
+================== ===================================
+grub2-common       fichiers v2 communs
+grub-common        fichiers v2 et v1 communs
+grub-efi-amd64     architecture EFI avec installation
+grub-efi-amd64-bin architecture EFI sans installation
+grub-pc            architecture BIOS avec installation
+grub-pc-bin        architecture BIOS avec installation
+================== ===================================
+
+legacy
+------
+
+=========== ============
+grub-efi    transitional
+grub-legacy maintenance
+=========== ============
+
+Put up a functional directory
+=============================
+
+boot/grub/grub.cfg
+
+.. code:: shell
+
+  search --set --fs-uuid "YYYY-MM-DD-hh-mm-ss-cc"
+
+Or at worst:
+
+.. code:: shell
+
+  search --set --label "LA_BEL"
+
+Generate a modular image
+========================
+
+/bin/tar
+
+.. code:: shell
+
+  tar
+  --create
+  --dereference
+  --file='grub.tar'
+  --verbose
+  boot
+
+* moddep.lst
+* kernel.img
+* lzma_decompress.img
+* diskboot.img
+* \*.mod
+
+/usr/bin/grub-mkimage
+
+.. code:: shell
+
+  grub-mkimage
+  --directory='i386-pc'
+  --format='i386-pc'
+  --memdisk='grub.tar'
+  --output='i386-pc/core.img'
+  modules…
+
+i386-pc-eltorito for ISO encapsulation
+
+Make a device bootable
+======================
+
+* boot.img
+* core.img
+
+/usr/sbin/grub-bios-setup
+
+.. code:: shell
+
+  grub-bios-setup \
+  --directory="i386-pc" \
+  /dev/sd?
+
+Prepare a boot menu
+===================
+
+available colors
+----------------
+
+========= ============= =========== ==========
+black     blue          green       cyan
+red       magenta       brown       light-gray
+dark-gray light-blue    light-green light-cyan
+light-red light-magenta yellow      white
+========= ============= =========== ==========
+
+* black backgrounds are actually transparent!
+
+available environment variables
+-------------------------------
+
+==================== =============================
+chosen               4
+color_highlight      black/light-gray
+color_normal         light-gray/black
+default              "${id}"
+gfxmode              1024x768
+gfxpayload           keep
+gfxterm_font         unicode
+lang                 en_US
+locale_dir
+menu_color_highlight white/blue
+menu_color_normal    cyan/blue
+pager                1
+prefix               (hd?,msdos?)/live/boot/2.02-2
+root                 hd?,msdos?
+theme                …/.txt
+timeout              -1
+==================== =============================
+
+======= =====
+cmdpath (hd?)
+======= =====
+
+persistent environment variables file
+-------------------------------------
+
+* /usr/bin/grub-editenv
+
+.. code:: shell
+
+  grub-editenv file create
+  grub-editenv file set variable=value
+  grub-editenv file unset variable
+
+boot a prepared system
+----------------------
+
+.. warning::
+
+  Violent kernel crashes are to be expected if:
+
+  1. the live-media-path has no .squashfs file
+  #. the image basename:
+
+     * doesn't end with .squashfs
+     * is just .squashfs
+     * contains ,
+
+----
+
+* /live/name.squashfs
+
+.. code:: shell
+
+  linux /live/subdir/vmlinuz boot="live" toram="subdir/name.squashfs"
+  initrd /live/subdir/initrd.img
+
+.. code:: shell
+
+  loopback loop /live/dir/name.squashfs
+  linux (loop)/vmlinuz boot="live" toram="dir/name.squashfs"
+  initrd (loop)/initrd.img
+
+* Debian installed
+
+.. code:: shell
+
+  unset path
+  uuid="????????-????-????-????-????????????"
+  search --set="path" --fs-uuid "${uuid}"
+  if [ "${path}" ]; then
+      path="(${path})"
+      linux "${path}/vmlinuz" \
+          elevator=deadline \
+          root=UUID=${uuid}
+      initrd "${path}/initrd.img"
+  fi
+
+* Debian Installer
+
+.. code:: shell
+
+  linux "/path/to/vmlinuz" priority="low"
+
+.. code:: shell
+
+  linux "/path/to/vmlinuz" auto="true" \
+  file="/hd-media/path/to/preseed"
+
+----
+
+.. code:: shell
+
+  initrd /path/to/gtk/initrd.gz
+
+----
+
+* iso-scan's first pass goes only 1 subdirectories level down!
+
+.. todo::
+
+  Test if iso-scan/filename really works
+
+.. code:: shell
+
+  iso-scan/ask_second_pass="true" iso-scan/filename="/path/to/file.iso"
+
+* Debian Live
+
+.. code:: shell
+
+  file="/path/to.iso"
+  loopback loop "${file}"
+  path="(loop)/live"
+  linux "${path}/vmlinuz" boot="live" findiso="${file}" components
+  initrd "${path}/initrd.img"
+
+* PartedMagic
+
+.. code:: shell
+
+  file="/path/to.iso"
+  loopback loop ${file}
+  path="(loop)/pmagic"
+  linux "${path}/bzImage64" iso_filename="${file}" load_ramdisk=1
+  initrd "${path}/initrd.img" "${path}/fu.img" "${path}/m64.img"
+
+* Windows
+
+.. code:: shell
+
+  menuentry "Windows" {
+      drivemap -s (hd0) (hd1)
+      chainloader (hd0,msdos2)+1
+  }
+
+* CloneZilla
+
+.. code:: shell
+
+  file="/path/to/file.iso"
+  loopback loop "${file}"
+  path="(loop)/live"
+  linux "${path}/vmlinuz" findiso="${file}" \
+  boot="live" union="overlay" \
+  username="user" config components \
+  toram="filesystem.squashfs" ip="" \
+  locales="en_US.UTF-8" keyboard-layouts="fr-latin9" \
+
+----
+
+.. code:: shell
+
+  ocs_live_batch="yes" \
+  ocs_prerun="mount /dev/disk/by-uuid/${cz_home} /mnt" \
+  ocs_prerun1="mount --bind /mnt/${cz_partimag} /home/partimag" \
+  ocs_live_run="ocs-live-restore" \
+
+.. code:: shell
+
+  ocs_live_extra_param="\
+  -e1 auto -e2 -t -r -j2 -cs -k \
+  -p reboot restoreparts ask_user ${cz_target}"
+
+.. code:: shell
+
+  ocs_live_extra_param="\
+  -q2 -j2 -rm-win-swap-hib -gs -z1p -i 1000000 -fsck-y \
+  -p reboot saveparts ask_user ${cz_target}"
+
+----
+
+.. code:: shell
+
+  ocs_live_batch="no" \
+  ocs_live_run="ocs-live-general" \
+
+----
+
+.. code:: shell
+
+  initrd "${path}/initrd.img"
+
+* ISO
+
+.. code:: shell
+
+  xorrisofs \
+  \
+  -output live-grub.iso \
+  \
+  -volid "LIVE_GRUB" \
+  -boot-info-table \
+  -no-emul-boot \
+  --modification-date="YYYYMMDDhhmmsscc" \
+  -eltorito-boot live/boot/grub/2.02-2/i386-pc/core.img \
+  -eltorito-catalog "boot.cat" \
+  --boot-catalog-hide \
+  \
+  -exclude live/sources \
+  -exclude live/boot/debian.squashfs/debootstrap \
+  -exclude live/boot/debian.squashfs/live \
+  -root "live" \
+  "live"