wok diff syslinux/stuff/iso2exe/README @ rev 13691

syslinux: add iso2exe
author Pascal Bellard <pascal.bellard@slitaz.org>
date Thu Dec 13 14:33:27 2012 +0100 (2012-12-13)
parents
children 87a217af01ea
line diff
     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/syslinux/stuff/iso2exe/README	Thu Dec 13 14:33:27 2012 +0100
     1.3 @@ -0,0 +1,84 @@
     1.4 +The iso2exe tool inserts a DOS .EXE header in an ISO image.
     1.5 +The ISO image can be launched by DOS :
     1.6 +
     1.7 +C:\> ren slitaz-5.0.iso slitaz.exe
     1.8 +C:\> slitaz
     1.9 +
    1.10 +
    1.11 +Why ?
    1.12 +
    1.13 +According to the SliTaz forum, some new users have problems to burn CD-ROM,
    1.14 +create USB Keys, and boot these devices with the BIOS. Others are lost during 
    1.15 +installation process or partitionning.
    1.16 +
    1.17 +The slitaz.exe program boots the SliTaz ISO image with a text menu:
    1.18 +
    1.19 +- to start SliTaz in RAM (live) in graphic mode or text mode.
    1.20 +
    1.21 +- to install SliTaz "a la UMSDOS" in the \slitaz\ subdirectory. The simplest
    1.22 +  way install to SliTaz. No partionning. No questions.
    1.23 +
    1.24 +
    1.25 +Usage:
    1.26 +
    1.27 +  C:\> progname [mode]
    1.28 +
    1.29 +Default mode is menu. mode can be:
    1.30 +
    1.31 +- menu	  	start with an interactive menu
    1.32 +- live    	launch SliTaz in RAM with graphics
    1.33 +- text    	launch SliTaz in RAM with text mode
    1.34 +- install 	SliTaz UMSDOS like installation
    1.35 +
    1.36 +If the progname name includes one of the supported mode, the according mode is
    1.37 +assumed. Example 'C:\> slitazlive.exe' starts SliTaz in RAM with graphics.
    1.38 +
    1.39 +
    1.40 +Implementation:
    1.41 +
    1.42 +ISO9660 format begins with 32Kb unused (16 sectors). Some programs may use it:
    1.43 +
    1.44 +- isolinux uses the first 512 bytes for hybrid iso boot (ISO image in a 
    1.45 +  partition).
    1.46 +- tazlito stores flavor extra infos at the 2nd Kb for 'tazlito iso2flavor'.
    1.47 +
    1.48 +The iso2exe tool moves the isolinux boot sector, installs its own boot sector 
    1.49 +with a DOS .EXE header, and adds a DOS .COM Linux loader and an initramfs in 
    1.50 +the end of the first 32Kb.
    1.51 +
    1.52 +    +-----------------+
    1.53 +    |    untouched    | ISO9660 files including /boot/bzImage and /boot/rootfs*
    1.54 +32K +-----------------+
    1.55 +    |  ISO initramfs  | Live loader and UMSDOS like install script
    1.56 +    +-----------------+
    1.57 +    | DOS .COM loader | Load bzImage, the last rootfs*.gz and the ISO initramfs
    1.58 +    +-----------------+
    1.59 +           unused
    1.60 +    +-----------------+
    1.61 +    |  tazlito info   | Flavor missing datas for 'tazlito iso2flavor'
    1.62 + 1K +-----------------+
    1.63 +    | isohybrid boot  | Starts isolinux.bin
    1.64 +512 +-----------------+
    1.65 +    |  iso2exe boot   |	Boot starts isohybrid (*), .EXE starts DOS .COM loader
    1.66 +  0 +-----------------+
    1.67 +
    1.68 +* Eltorito boot (i.e. bootable CD-ROM by BIOS) is not concerned by iso2exe.
    1.69 +
    1.70 +
    1.71 +Limitations:
    1.72 +
    1.73 +- Real mode support only. VM86 is not (yet?) supported
    1.74 +
    1.75 +- Image/zImage format not supported. bzImage only. Can't boot memtest or gpxe.
    1.76 +
    1.77 +- The tiny Linux loader can't load more than 15Mb of files. (not really a 
    1.78 +  problem since many-in-1 ISO format).
    1.79 +
    1.80 +- The DOS Linux loader and the ISO initramfs must fit in ~30Kb.
    1.81 +
    1.82 +- Old Linux kernels don't support multiple initramfs load. They will not
    1.83 +  find the /init.exe file. As workaround, you can add the "text" argument:
    1.84 +	C:\> slitaz.exe text
    1.85 +
    1.86 +- The ISO image must include the files /boot/bzImage and /boot/rootfs*
    1.87 +