wok annotate syslinux/stuff/iso2exe/README @ rev 14257

syslinux/iso2exe: check kernel version, add floppy bootstrap stub
author Pascal Bellard <pascal.bellard@slitaz.org>
date Thu Mar 28 11:51:42 2013 +0100 (2013-03-28)
parents 4bb9acf2b1b4
children 5ed4d6b2d690
rev   line source
pascal@13697 1 (c) GPLv2, Pascal Bellard <pascal.bellard@slitaz.org>
pascal@13697 2
pascal@14247 3 The iso2exe tool inserts a DOS/WIN32 .EXE header in an ISO image.
pascal@14247 4 The ISO image can be launched by DOS or Windows :
pascal@13691 5
pascal@13691 6 C:\> ren slitaz-5.0.iso slitaz.exe
pascal@13691 7 C:\> slitaz
pascal@13691 8
pascal@13691 9
pascal@13691 10 Why ?
pascal@13691 11
paul@13692 12 According to the SliTaz forum, some new users have problems burning CD-ROMs,
pascal@13697 13 creating USB Keys and booting these devices with the BIOS. Others are lost
paul@13692 14 during the installation process or partitioning.
pascal@13691 15
pascal@13691 16 The slitaz.exe program boots the SliTaz ISO image with a text menu:
pascal@13691 17
paul@13692 18 - to start SliTaz in RAM (live) in graphics mode or text mode.
pascal@13691 19
pascal@13697 20 - to install SliTaz "a la UMSDOS" in the \slitaz\ subdirectory. The easiest
pascal@13699 21 way to install SliTaz. No partitioning. No questions.
pascal@13691 22
pascal@13756 23 - to create a SliTaz USB Key.
pascal@13756 24
pascal@14247 25 When the slitaz.exe program can't boot SliTaz directly it will prompt to create
pascal@14247 26 a bootable image on a removeable media (Memory card, USB stick or ... floppy).
pascal@13691 27
pascal@13691 28 Usage:
pascal@13691 29
pascal@13691 30 C:\> progname [mode]
pascal@13691 31
paul@13692 32 Default mode is menu. Mode can be:
pascal@13691 33
pascal@13697 34 - menu start with an interactive menu
pascal@13697 35 - live launch SliTaz in RAM with graphics
pascal@13697 36 - text launch SliTaz in RAM with text mode
pascal@13697 37 - install SliTaz UMSDOS like installation
pascal@13691 38
pascal@13756 39 If the prognam name includes one of the supported modes, the according mode is
pascal@13691 40 assumed. Example 'C:\> slitazlive.exe' starts SliTaz in RAM with graphics.
pascal@13691 41
pascal@13691 42
pascal@13691 43 Implementation:
pascal@13691 44
pascal@13691 45 ISO9660 format begins with 32Kb unused (16 sectors). Some programs may use it:
pascal@13691 46
pascal@13691 47 - isolinux uses the first 512 bytes for hybrid iso boot (ISO image in a
pascal@13691 48 partition).
paul@13692 49 - tazlito stores extra flavor info at the 2nd Kb for 'tazlito iso2flavor'.
pascal@13691 50
pascal@13691 51 The iso2exe tool moves the isolinux boot sector, installs its own boot sector
pascal@13972 52 with a DOS .EXE header, and adds a WIN32 .EXE installer, a DOS .COM Linux
pascal@13972 53 loader and an initramfs in the end of the first 32Kb.
pascal@13691 54
pascal@13691 55 +-----------------+
pascal@13691 56 | untouched | ISO9660 files including /boot/bzImage and /boot/rootfs*
pascal@13691 57 32K +-----------------+
pascal@13691 58 | ISO initramfs | Live loader and UMSDOS like install script
pascal@13691 59 +-----------------+
pascal@13691 60 | DOS .COM loader | Load bzImage, the last rootfs*.gz and the ISO initramfs
pascal@13691 61 +-----------------+
pascal@14257 62 | WIN32 PE .exe | NT+ boot device creator / Win9x DOS .COM launcher.
pascal@14257 63 +-----------------+
pascal@14257 64 | floppy bootstrap| CD-ROM emulation boot driver for hard disk ISO image
pascal@13972 65 +-----------------+
pascal@13691 66 unused
pascal@13691 67 +-----------------+
paul@13692 68 | tazlito info | Flavor missing data for 'tazlito iso2flavor'
pascal@13691 69 1K +-----------------+
pascal@13691 70 | isohybrid boot | Starts isolinux.bin
pascal@13691 71 512 +-----------------+
pascal@13697 72 | iso2exe boot | Boot starts isohybrid (*), .EXE starts DOS .COM loader
pascal@14247 73 0 +-----------------+ or 32 bits Windows boot device creator
pascal@13691 74
pascal@13691 75 * Eltorito boot (i.e. bootable CD-ROM by BIOS) is not concerned by iso2exe.
pascal@13691 76
pascal@13691 77
pascal@13691 78 Limitations:
pascal@13691 79
pascal@13699 80 - Only DOS 3, 4 and 6 supported. Checked with http://www.allbootdisks.com/
pascal@13699 81
pascal@14247 82 - Real mode support only. VM86 is not supported. Will not boot directly, but
pascal@14247 83 a removable boot media is created.
pascal@13691 84
paul@13692 85 - Image/zImage format not supported, bzImage only. Can't boot memtest or gpxe.
pascal@13691 86
pascal@13691 87 - The tiny Linux loader can't load more than 15Mb of files. (not really a
pascal@13691 88 problem since many-in-1 ISO format).
pascal@13691 89
pascal@13691 90 - The DOS Linux loader and the ISO initramfs must fit in ~30Kb.
pascal@13691 91
pascal@14247 92 - Linux kernels before version 2.6.30 don't support multiple initramfs load.
pascal@14247 93 They will not find the /init.exe file. The "text" mode will be forced:
pascal@13691 94 C:\> slitaz.exe text
pascal@13691 95
paul@13692 96 - The ISO image must include the files /boot/bzImage and /boot/rootfs*.
pascal@13691 97
pascal@14247 98 TODO:
pascal@14247 99
pascal@14247 100 - Add Windows boot device creator
pascal@14247 101
pascal@14247 102 - Add XMM and VCPI (VM86) support.
pascal@14247 103
pascal@14247 104 - floppy bootstrap
pascal@14247 105
pascal@14247 106 - zImage support ?
pascal@14247 107