Annotation of /tags/mkinitrd-6_1_6/isolinux/isolinux.doc
Parent Directory | Revision Log
Revision 532 -
(hide annotations)
(download)
(as text)
Sat Sep 1 22:45:15 2007 UTC (17 years ago) by niro
Original Path: trunk/mkinitrd-magellan/isolinux/isolinux.doc
File MIME type: application/msword
File size: 4975 byte(s)
Sat Sep 1 22:45:15 2007 UTC (17 years ago) by niro
Original Path: trunk/mkinitrd-magellan/isolinux/isolinux.doc
File MIME type: application/msword
File size: 4975 byte(s)
-import if magellan mkinitrd; it is a fork of redhats mkinitrd-5.0.8 with all magellan patches and features; deprecates magellan-src/mkinitrd
1 | niro | 532 | ISOLINUX |
2 | |||
3 | A bootloader for Linux using ISO 9660/El Torito CD-ROMs | ||
4 | |||
5 | Copyright (C) 1994-2003 H. Peter Anvin | ||
6 | |||
7 | This program is provided under the terms of the GNU General Public | ||
8 | License, version 2 or, at your option, any later version. There is no | ||
9 | warranty, neither expressed nor implied, to the function of this | ||
10 | program. Please see the included file COPYING for details. | ||
11 | |||
12 | ---------------------------------------------------------------------- | ||
13 | |||
14 | ISOLINUX is a boot loader for Linux/i386 that operates off ISO 9660/El | ||
15 | Torito CD-ROMs in "no emulation" mode. This avoids the need to create | ||
16 | an "emulation disk image" with limited space (for "floppy emulation") | ||
17 | or compatibility problems (for "hard disk emulation".) | ||
18 | |||
19 | This documentation isn't here yet, but here is enough that you should | ||
20 | be able to test it out: | ||
21 | |||
22 | Make sure you have a recent enough version of mkisofs. I recommend | ||
23 | mkisofs 1.13 (distributed with cdrecord 1.9), but 1.12 might work as | ||
24 | well (not tested.) | ||
25 | |||
26 | To create an image, create a directory called "isolinux" (or, if you | ||
27 | prefer, "boot/isolinux") underneath the root directory of your ISO | ||
28 | image master file tree. Copy isolinux.bin, a config file called | ||
29 | "isolinux.cfg" (see syslinux.doc for details on the configuration | ||
30 | file), and all necessary files (kernels, initrd, display files, etc.) | ||
31 | into this directory, then use the following command to create your ISO | ||
32 | image (add additional options as appropriate, such as -J or -R): | ||
33 | |||
34 | mkisofs -o <isoimage> \ | ||
35 | -b isolinux/isolinux.bin -c isolinux/boot.cat \ | ||
36 | -no-emul-boot -boot-load-size 4 -boot-info-table \ | ||
37 | <root-of-iso-tree> | ||
38 | |||
39 | (If you named the directory boot/isolinux that should of course be | ||
40 | -b boot/isolinux/isolinux.bin -c boot/isolinux/boot.cat.) | ||
41 | |||
42 | ISOLINUX resolves pathnames the following way: | ||
43 | |||
44 | - A pathname consists of names separated by slashes, Unix-style. | ||
45 | - A leading / means it searches from the root directory; otherwise the | ||
46 | search is from the isolinux directory (think of this as the "current | ||
47 | directory".) | ||
48 | - . and .. in pathname searches are not supported. | ||
49 | - The maximum length of any pathname is 255 characters. | ||
50 | |||
51 | Note that ISOLINUX only uses the "plain" ISO 9660 filenames, i.e. it | ||
52 | does not support Rock Ridge or Joliet filenames. It can still be used | ||
53 | on a disk which uses Rock Ridge and/or Joliet extensions, of course. | ||
54 | Under Linux, you can verify the plain filenames by mounting with the | ||
55 | "-o norock,nojoliet" option to the mount command. Note, however, that | ||
56 | ISOLINUX does support "long" (level 2) ISO 9660 plain filenames, so if | ||
57 | compatibility with short-names-only operating systems like MS-DOS is | ||
58 | not an issue, you can use the "-l" or "-iso-level 2" option to mkisofs | ||
59 | to generate long (up to 31 characters) plain filenames. | ||
60 | |||
61 | ISOLINUX does not support discontiguous files, interleaved mode, or | ||
62 | logical block and sector sizes other than 2048. This should normally | ||
63 | not be a problem. | ||
64 | |||
65 | ISOLINUX is by default built in two versions, one version with extra | ||
66 | debugging messages enabled. If you are having problems with ISOLINUX, | ||
67 | I would greatly appreciate if you could try out the debugging version | ||
68 | (isolinux-debug.bin) and let me know what it reports. | ||
69 | |||
70 | YOU MAY WANT TO CONSIDER USING THE DEBUGGING VERSION BY DEFAULT. | ||
71 | |||
72 | |||
73 | ++++ NOTE ON THE CONFIG FILE DIRECTORY ++++ | ||
74 | |||
75 | ISOLINUX will search for the config file directory in the order | ||
76 | /boot/isolinux, /isolinux, /. The first directory that exists is | ||
77 | used, even if it contains no files. Therefore, please make sure that | ||
78 | these directories don't exist if you don't want ISOLINUX to use them. | ||
79 | |||
80 | |||
81 | ++++ BOOTING DOS (OR OTHER SIMILAR OPERATING SYSTEMS) ++++ | ||
82 | |||
83 | WARNING: This feature depends on BIOS functionality which is | ||
84 | apparently broken in a very large number of BIOSes. Therefore, this | ||
85 | may not work on any particular system. No workaround is possible; if | ||
86 | you find that it doesn't work please complain to your vendor and | ||
87 | indicate that "BIOS INT 13h AX=4C00h fails." | ||
88 | |||
89 | To boot DOS, or other real-mode operating systems (protected-mode | ||
90 | operating systems may or may not work correctly), using ISOLINUX, you | ||
91 | need to prepare a disk image (usually a floppy image, but a hard disk | ||
92 | image can be used on *most* systems) with the relevant operating | ||
93 | system. This file should be included on the CD-ROM in the /isolinux | ||
94 | directory, and have a .img extension. The ".img" extension does not | ||
95 | have to be specified on the command line, but has to be explicitly | ||
96 | specified if used in a "kernel" statement in isolinux.cfg. | ||
97 | |||
98 | For a floppy image, the size of the image should be exactly one of the | ||
99 | following: | ||
100 | |||
101 | 1,228,800 bytes - For a 1200K floppy image | ||
102 | 1,474,560 bytes - For a 1440K floppy image | ||
103 | 2,949,120 bytes - For a 2880K floppy image | ||
104 | |||
105 | Any other size is assumed to be a hard disk image. In order to work | ||
106 | on as many systems as possible, a hard disk image should have exactly | ||
107 | one partition, marked active, that covers the entire size of the disk | ||
108 | image file. Even so, hard disk images are not supported on all | ||
109 | BIOSes. | ||
110 | |||
111 |