home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd2.bin / dosutils / bootlin / bootlin.doc < prev    next >
Text File  |  1994-10-16  |  7KB  |  144 lines
  1.  
  2. SUBJECT: BootLinux v1.6b documentation
  3.  
  4. DATE:    october 16, 1994
  5. AUTHOR: Fabien COUTANT
  6. Email:    fabien@steria.fr
  7.  
  8. COMMAND:    bootlin.com
  9. SYNTAX:    
  10.     <path>bootlin[ -R <dev>][ -S <dev>][ -D <n>][ -V <video>][ -W][ <file>]
  11.     <path>    is the DOS path where BOOTLIN.COM is located. It is
  12.         necessary unless BOOTLIN.COM is in the root directory.
  13.     <file>    is the full name of the Linux boot image (relatively to
  14.         your boot drive root directory). If you specify nothing or
  15.         the name of a file that does not exist, you will be
  16.         prompted for a new name until the name you give is correct.
  17.     <dev>    is the description of a linux device for the root fs (-R)
  18.         and for the swap (-S). Recognized devices are currently
  19.         'fd0' (A:), 'fd1' (B:) as floppies, 'sd[a-g][1-8]' as SCSI
  20.         disk partitions and 'hd[ab][1-9]' as AT hard disk partitions.
  21.         Numbers [1-4] mean BIOS partitions, whereas [5-9] means
  22.         inside-DOS-extended partitions.
  23.     <n>    is a whole number giving the size of the ramdisk.
  24.         specifying 0 means keep the size given in the image.
  25.     <video>    is one of '80*25' (normal VGA), '80*50' (extended VGA),
  26.         'ASK' (LINUX asks the mode you want) or 'SVGA[1-9]', the
  27.         digit indicating the key you would press if you were asked
  28.         the mode you want by LINUX.
  29.     -W    specifies to print a message and wait for a key before
  30.         Linux is effectively launched.
  31.     NOTE that the case is insensitive so '-R' and '-r' are the same.
  32.     NOTE that only the first letter of options is taken into account,
  33.     so '-r' and '-root' are treated identically.    
  34.     NOTE that options and file name may be specified in any order.
  35.     NOTE that if an option or the file name is specified more than
  36.     once, only the last occurrence is taken into account.
  37.  
  38. DESCRIPTION:
  39.     The image file, which name is provided on the command line, is
  40. the one you "rawrite" to a disk to make it boot Linux: it must contain
  41. either the file Image or zImage produced by the compilation of the kernel.
  42.     BootLinux can be run two ways, but in either way it MUST be run
  43. in real mode, which means no Windows, no EMM386, no DesqView, no etc running
  44. at the moment BootLinux is run.
  45.     The first way, also the simplest, is to run it directly from the
  46. dos command prompt, probably with the help of a batch file. Here is the
  47. example of my version (I use text mode 100x40 on an ET/4000 video card):
  48.  
  49.     [LINUX.BAT]
  50.         @ECHO OFF
  51.         c:\linux\bootlin -v SVGA3 c:\linux\linux.img
  52.  
  53.     Inconvenient: you must have enough memory to load the image into
  54. memory, plus BootLinux and its data memory. Count 18K more than the image size.
  55. For example, if the Image is 236K, you must have at least 254K free memory.
  56.     The second way is to run it from the CONFIG.SYS. To achieve this,
  57. place a SHELL= line like this in your CONFIG.SYS:
  58.  
  59.     [CONFIG.SYS]
  60.         ...
  61.         SHELL=c:\linux\bootlin.com -v SVGA3 c:\linux\linux.img
  62.         ...
  63.  
  64. assuming that the bootlin.com and LINUX.IMG files are in c:\linux. The syntax
  65. of the command is the same whatever method you use.
  66.     Inconvenient: of course, you still want to be able to run DOS
  67. sometimes, so the idea is to use a CONFIG.SYS "multiplexer", e.g. something
  68. that shows you on boot a menu, in which you choose wether you want to boot
  69. DOS or Linux. MsDos 6 offers such a thing. I personnally use BOOT.SYS (since
  70. I don't have MsDos 6), which consumes nearly no memory and is very powerful;
  71. using this, a config.sys should look like:
  72.  
  73.     DEVICE=C:\UTIL\BOOT.SYS
  74.     DEVICE=BOOT.1 DOS
  75.       ...
  76.       here you put the usual config.sys
  77.       ...
  78.  
  79.     DEVICE=BOOT.2 Linux
  80.       SHELL=c:\etc\bootlin.com c:\etc\image
  81.  
  82.     DEVICE=BOOT.END
  83.  
  84.     If you are using DOS 5, it may tell you that it is trying to
  85. load BootLin high and that it fails... don't worry: apart from the
  86. message, it doesn't matter. BTW, I used to put a "DOS=LOW" line to
  87. remove the warning message, but then DOS was ALWAYS loading low, even
  88. if I had a "DOS=HIGH" in the first part of the config.sys ... It appears
  89. that to know if it has to load high or low, DOS rereads entirely the
  90. config.sys and looks for the last "DOS=".
  91.     The SHELL= line should be the only one in its section, firstly to
  92. minimize the number of DOS residents and have more memory, secondly because
  93. if you want to run LINUX, you don't need actually any DOS feature.
  94.  
  95.     BootLinux does a lot of checking on the image and on your machine:
  96. About your machine, a 386 or higher is required, with 640K base memory and
  97. 1M or more extended memory. About the image, it checks that the image is the
  98. image of a bootable disk, that it is not too short (missing kernel) or too
  99. big (more than 512K), and that there is enough memory to load it.
  100.     If an unexisting filename or no filename is given, it will ask for
  101. one until a correct one is supplied. If no root fs device is given, either
  102. in the image or on the command line, BootLinux asks for one in the following
  103. way:
  104.  
  105. |    Root device is not defined. Please choose one of:
  106. |
  107. |        FD[0-1]         floppies
  108. |        HD[A-B][1-9]    AT hard disks partitions
  109. |                        ([1-4] are BIOS, [5-9] are dos extended)
  110. |        SD[A-G][1-8]    SCSI hard disks partitions
  111. |
  112. |    root device -> fd0_
  113.  
  114.     You have to type in the device you want; fd0 is provided as
  115. default; if it is ok, just validate, else backspace on it and type the
  116. device you want, then validate. Currently you only have one try, so don't
  117. miss it, or you will have to do Ctrl-C and run it again (I assume this kind
  118. of feature is essentially used from DOS command line).
  119.  
  120.     Linux autodetects 5"1/4 or 3"1/2, DD or HD, so you just have to
  121. indicate the drive: fd0 or fd1.
  122.  
  123.     For those that want to use a ramdisk, here's the way to do:
  124.       1) specify as root device the _ramdisk_ support: -r fd0 for A: floppy
  125.       2) specify the ramdisk size: -d 1440 for 3"1/2 HD floppy
  126.       3) specify the -w flag
  127.       4) you can still specify other options of your own
  128.       5) validate your BootLinux command line
  129.       6) when it asks to press a key to run linux, insert the ramdisk
  130.       support appropriately, then press a key.
  131.     The -w flag is only necessary if BootLinux + linux image are on the
  132.     same floppy drive, i.e. when you want to make a set of linux startup
  133.     backup disks: one disk for BootLinux + linux image, one for the root
  134.     (will be in ramdisk) and one for usr or home or whatever.
  135.  
  136.  
  137. INFORMATIONS:
  138.     For those who want to use BOOT.SYS, it is shareware and can be
  139.     found at least on Simtel mirrors. I know more particularly the
  140.     following locations:
  141.         wuarchive.wustl.edu:/systems/msdos/[sS]imtel20/sysutl/boot142.zip
  142.         oak.oakland.edu:/pub/msdos/sysutl/boot142.zip
  143.  
  144.