chain.c32: minor stylistic cleanup
[syslinux.git] / NEWS
bloba70bdaaaaa57abf3183e375dca163db1316ef667
1 Starting with 1.47, changes marked with SYSLINUX/PXELINUX/ISOLINUX
2 apply to that specific program only; other changes apply to all of
3 them.
5 Changes in 3.70:
6         * PXELINUX: Support enhanced capabilities when running on top
7           of gPXE (http://www.etherboot.org/).  In particular, support
8           URL-style syntax for filenames, and any protocol that gPXE
9           supports (except, currently, iSCSI and AoE.)  This feature
10           is currently highly experimental.
11         * Substantial infrastructure changes to support files whose
12           length aren't known at open time (typically network
13           connections.)  Please note that the semantics of some of the
14           comboot APIs have changed slightly; please see doc/comboot.doc.
15         * PXELINUX: We no longer require a TFTP server which supports
16           the tsize option for all transfers.
17         * PXELINUX: Integrate with the gPXE source base; unified image
18           now included as "gpxelinux.0".
19         * The source tree has been restructured; files that were
20           previously in the root have moved into the core, dos, gpxe,
21           and utils directories.
22         * "make install", "make netinstall", and "make extbootinstall"
23           have been updated massively.  "make install-all" now installs
24           all three.
25         * Change default dir for auxiliary files from
26           /usr/lib/syslinux to /usr/share/syslinux.
27         * SYSLINUX: VFAT long filename support.
28         * MEMDISK: Any image less than 4096K (4 MB) is treated as a
29           floppy disk.  The geometry-guessing code will recognize all
30           common extended formats, but it is still possible some very
31           exotic formats need geometry specification.  Large floppies
32           and very small harddisks still need explicit specification.
33         * chain.c32: option -swap to support swapping of BIOS drive
34           numbers.  This is necessary to boot certain operating systems
35           (DOS, Windows) from a secondary drive.
36         * chain.c32: option -file to support loading a boot file from
37           the SYSLINUX filesystem instead of loading the boot sector
38           from the drive.
39         * chain.c32: option -seg to control the load location.
40         * chain.c32: option -ntldr as a shorthand for "-seg 0x2000
41           -file"; use this to load one of WinNT's loaders:
43           chain.c32 hd0 1 -ntldr /MiniNT/setupldr.bin
45           Note that the file needs to be in the SYSLINUX filesystem.
47 Changes in 3.64:
48         * SYSLINUX/EXTLINUX: support "localboot" with the same feature
49           set as ISOLINUX.
50         * Add an experimental MBR for GPT partition tables.
51         * Use $(CC) when determining compile flags.
52         * chain.c32: fix booting from logical partitions (Sergey
53           Vlasov.)
55 Changes in 3.63:
56         * Fix errors in the PCI and DMI detection modules (Erwan Velu,
57           Sebastian Herbszt).
58         * Fix host dependencies and other issues in the build system.
59         * PXELINUX: Allow class E addresses as unicast.
60         * sdi.c32: module to load Microsoft System Deployment Images.
61           For additional information, please see:
62             http://msdn2.microsoft.com/en-us/library/ms838543.aspx
63         * EXTLINUX: Correct reading directories with deleted entries.
64         * Shuffle library: correct the handling of certain geometries
65           (an upward move with source material blocking the move); as
66           required by sdi.c32 but theoretically possible for other
67           formats as well.
68         * Add "make netinstall" to install /tftpboot.
69         * Fix some documentation files that didn't get moved/renamed.
71 Changes in 3.62:
72         * Clean up garbage after "aborted." message.
73         * Clean up memdump.com filenames.
74         * Support SHA256 and SHA512 encrypted passwords.
75         * The shuffle library now can generate chained descriptors,
76           thus allowing pretty much arbitrarily complex memory maps.
77         * Handle command lines up to 2047 characters, the current
78           Linux kernel limit.
79         * vesamenu: support systems without linear framebuffer support
80           (sigh, what is this, 1993?) and 15-bit RGB modes.
81         * Move the label storage (for the command-line interface) to
82           high memory, removing the size limit and freeing up 64K of
83           low memory.
84         * Get rid of 4096-entry limit in the simple menu system.
85         * New hierarchial submenu support: see MENU BEGIN, MENU END,
86           MENU GOTO in doc/menu.txt.
87         * MENU QUIT allows creating a menu entry for returning to the
88           command line.
89         * ISOLINUX: Work around bug in certain Adaptec BIOSes,
90           patch by Bruce Robson.
91         * pngtopnm dependency removed from samples/ directory.
92         * Text documentation files (in doc/) renamed *.doc -> *.txt.
94 Changes in 3.61:
95         * EXTLINUX: fix crash when accessing an empty file.
96         * elf.c32: If a PHDR segment is present, load it.
97         * Fix SHA-1 and MD5 passwords.
98         * ISOLINUX: fix booting when mastered without
99           mkisofs -boot-info-table (broken since 3.50, sigh...)
100         * Handle BIOSes which emit multiple contiguous valid
101           memory regions in the e820 map.
103 Changes in 3.60:
104         * Support for "auxilliary data vector", a small amount of
105           writable storage.  Currently only supported for EXTLINUX,
106           but the infrastructure is there for the other derivatives,
107           assuming a suitable storage location can be found.
108         * EXTLINUX: boot-once support (--once, --clear-once, and
109           --reset-adv).
110         * A command is now required to the EXTLINUX installer, i.e. at
111           least one of --install, --update, --once, --clear-once, or
112           --reset-adv.
114 Changes in 3.55:
115         * PXELINUX: as per RFC 5071, PXELINUX no longer requires the
116           use of the magic cookie option (208) for unencapsulated
117           options.  Currently it does not require it for
118           vendor-encapsulated options (vendor-option-space) either,
119           but that MAY be reverted in the future if it causes
120           problems.
121         * Documentation text files moved to a common "doc" directory;
122           man pages from the Debian project added to the "man"
123           directory.
124         * Correct bug with self-overlapping memory areas when using
125           the shuffle interface.
127 Changes in 3.54:
128         * Add "menu separator", "menu indent", "menu disabled"
129           (see README.menu).
130         * vesamenu: fix handing of VESA modes with noncontiguous
131           memory buffers.  In particular, Qemu/KVM sets up such a mode
132           when Cirrus Logic emulation is enabled (which is the
133           default.)
134         * Support for calling real mode functions using far calls,
135           with argument on the stack.  This was implemented to support
136           the BIOS BBS specification, but subsequent experiments show
137           that the at least one of the most common BIOS cores, Award,
138           passes the presence check but doesn't actually implement the
139           functionality.
141 Changes in 3.53:
142         * Fix bugs related to the $PnP BIOS functionality on some
143           platforms.
144         * PXELINUX: Fix the "naked" version of :: (suppress prefix.)
145         * elf.c32: better error messages.
146         * Faster operation under Intel VT virtualization.
147         * PXELINUX: Fix DHCP bootfile option.
148         * mkdiskimage: Support more than 1024 cylinders.
149         * (Hopefully) fix installer on non-x86 platforms.
150         * Fix shuffle_and_boot_rm, used by linux.c32.
151         * Fix shuffle_and_boot_pm on 386/486.
152         * ISOLINUX (at least): fix bss memory overwrite hang.
153         * MBR: Fix booting from logical partitions.
154         * Code cleanups.
156 Changes in 3.52:
157         * Handle capitalized F-key commands in the menu system.
158         * Fix padding error when loading multiple ramdisks.
159         * Workaround for VMware crashing when trying to print a
160           message during early kernel boot (does not seem to work,
161           consider deleting.)
162         * chain.c32: add the ability to search for a specific MBR
163           signature at runtime.
164         * Fall back to the server identity option if the siaddr field
165           in the DHCP header isn't set.  This seems to match the
166           behaviour of most PXE stacks.
167         * mkdiskimage: give the generated disk image an MBR signature.
168         * MEMDISK: Fix failures on some BIOSes.
169         * Simple menu system: new "MENU HIDDEN" option to not display
170           the menu unless the user presses a key.
171         * Simple menu system: support MD5-encrypted passwords (modern
172           Unix standard style, with "$1$" prefixes.)
173         * pcitest.c32: now functions as a full "lspci".  Thanks to
174           Erwan Velu for this work.
175         * MEMDISK: Make EDD actually work.
176         * ISOLINUX: Fix for certain broken CD-ROM BIOSes which
177           randomly corrupted register FS.
178         * Simple menu system: fix memory overwrite bug that caused
179           some systems to lock up or behave weirdly.
180         * Fix building on 64-bit systems without a 32-bit libc installed.
182 Changes in 3.51:
183         * EXTLINUX: Fix failure to find the configuration file.
185 Changes in 3.50:
186         * New keywords allow the type of file to be specified in the
187           configuration file.
188         * It is now supported to load a different configuration file
189           with the CONFIG keyword.
190         * Fix API call 0x0019 (Read Disk.)
191         * MENU AUTOBOOT, MENU TABMSG, MENU PASSPROMPT allows
192           internationalization of menu messages.
193         * A new feature, TEXT HELP, allows the administrator to set
194           a multi-line help message for individual selections.
195         * Fix API call 0x0012 (Cleanup, shuffle and boot.)
196         * New API call "Cleanup, shuffle and boot to flat protected mode"
197         * New API call "Cleanup, shuffle and boot to real mode",
198           similar to API call 0x0012 but allows arbitrary register setting.
199         * Introduce a library interface for loading arbitrary binary
200           formats with relatively easily understood code.  See
201           the elf.c32 module for an example on how to use it.
202         * New module "elf.c32", to load a protected-mode ELF kernel.
203         * MBR (old and new): Fix bug in CHS mode when LBA >
204           65535*sectors.
205         * vesamenu: fix decoding of palettized PNG images.
206         * Update the Linux kernel boot protocol.
207         * PXELINUX: Press Ctrl-N at the boot prompt to read out the
208           network info.
209         * Instead of the (non-existent) MAC, use the client identifier
210           for networks like Infiniband and Firewire/1394.
211         * Add a new INCLUDE command to the core syslinux parser.
212         * Allow binding help text to F11 and F12.
213         * F-key help now available in the simple menu system.
214         * Disabled the polling for ARP during idle.  It is simply too
215           slow on some (broken!) PXE stacks.
216         * PXELINUX: also try to fetch the config file based on UUID.
217         * SYSLINUX/EXTLINUX: New RAID mode (-r) which calls the BIOS
218           to load the next device (typically the next drive) on boot
219           failure.
221 Changes in 3.36:
222         * MEMDISK: Disable EDD by default on floppy disks.  EDD can be
223           enabled with the "edd" option and disabled with "noedd".
224           This (hopefully) should make Ghost work again.
225         * SYSLINUX: "unix" installer now uses Linux ioctls instead of
226           using libfat.
227         * New MBR which can boot from logical partitions.
228         * SYSLINUX: Fix bug in detecting special extensions which was
229           introduced in 3.35 :(
230         * PXELINUX: Unbreak chainbooting FreeBSD (and possibly others.)
232 Changes in 3.35:
233         * MEMDISK: New "safeint" mode.
234         * MEMDISK: Be more compliant with the PnP BIOS spec.
235         * MEMDISK: Turn on EDD support by default.
236         * MEMDISK: Try to work on some machines on which it would not
237           work when there was no floppy drive in the system.
238         * Simple menu system: fix serial console support (broken in
239           3.30).
240         * SYSLINUX: Support subdirectories.  Like ISOLINUX, the
241           "current directory" is the directory in which syslinux.cfg
242           is found; this is searched for in the sequence
243           /boot/syslinux, /syslinux, /.  As a side benefit, label names
244           like "linux-2.6.18" and "linux-2.6.19" are now supported.
246           To install ldlinux.sys in a subdirectory, pass the -d
247           directory option to the SYSLINUX installer.
249           This work was sponsored by slax.org (thanks, Tomas!)
250         * New API call: read disk.
251         * Invoke ONERROR on initrd load failure.
253 Changes in 3.31:
254         * The simple menu system (menu.c32 and vesamenu.c32) now
255           support loading more than one configuration file at a time,
256           using MENU INCLUDE or by specifying multiple filenames.
257         * The MENU COLOR statement can now control the shadowing mode.
259 Changes in 3.30:
260         * libcom32 extended to support graphics mode and graphical console.
261         * vesamenu.c32, new graphical version of the Simple
262           Menu System, see README.menu.
263         * New com32 modules by Erwan Velu do selection based on CPUID
264           or PCI devices present.
265         * RPM spec: add syslinux-tftpboot module; move syslinux by
266           default to the /usr/share/syslinux directory.
267         * RPM spec: extlinux is now a separate package.
269 Changes in 3.20:
270         * EXTLINUX: New options --install (-i) and --update (-U), to
271           make it clear if a boot loader should be installed or
272           updated.  For now, defaults to --install for compatibility;
273           a future version will require one of these options.
274         * New library functions to load and place files in memory.
275         * mboot.c32 bug fixes.
276         * Remove 8 MB kernel size restriction.
277         * Add "klibc" target for building unix/syslinux and
278           extlinux/extlinux with klcc (klibc-1.4.27 or later.)
279         * PXELINUX: Fail (and eventually reboot) if no configuration
280           file was found.
281         * COM32 module by Erwan Velu to make decisions based on DMI
282           info.
283         * Fix issue where going back and forth between menus a lot
284           would cause a hang.
285         * ISOLINUX: Fix bug which made "cd boot sectors" not work.
287 Changes in 3.11:
288         * MEMDISK: Fix bug by which accessing the real floppy disk
289           as B: in MS-DOS was broken.
290         * Simple menu system: allow tweaking of the screen layout.
291         * Simple menu system: better command-line editing, correctly
292           handle command lines above 256 characters.
293         * PXELINUX: revert memory allocation change that caused
294           problems on some network cards.
295         * MEMDISK: Try work around a bug on some BIOSes when no
296           physical floppy disk is present in the system.
297         * Enable the 16550A FIFOs, if present, when doing serial
298           console.
299         * New "totaltimeout" command establishes a timeout without
300           regard for any user input.
301         * Simple menu system: timeout behaviour now more in line with
302           user expectations.
303         * Simple menu system: "ontimeout" should now work correctly.
305 Changes in 3.10:
306         * gcc 4.0.1 compilation fixes.
307         * Add support for querying the PCI BIOS in libcom32
308           (used by ethersel et al.)
309         * Fix PCI handing (ethersel etc) on several old chipsets (and
310           VMWare.)
311         * Try to deal with systems with broken EBIOS.
312         * New API call to do "localboot".
313         * New API call to query features.
314         * New API call to run kernel image, a lower-level call than
315           "run command".  See comboot.doc.
316         * Fix for bug in EBIOS code discovered by Arwin Vosselman.
317         * NOESCAPE security fix.
318         * Comments are now recognized even without a space following #.
319         * Fix incorrect handling of mixes of entries with and without
320           MENU PASSWD.
321         * The idle API call now harmlessly returns failure if it is a
322           no-op.  That way the caller can decide whether or not to
323           bother invoking it again.
324         * Temporarily disable the idle API call on PXELINUX, due to
325           some platforms on which the idle API call seems to hang; this
326           problem has not yet been debugged.
327         * MEMDISK: the handling of DOSEMU-headered images was broken;
328           fix it.
329         * EXTLINUX: symlinks are now supported.
330         * Simple menu system: N and P now work correctly as hotkeys.
331         * MEMDISK: more BIOS bug workarounds.
333 Changes in 3.09:
334         * gcc4 compilation fix.
335         * <BEL> (Ctrl-G) in message files now causes a beep.
336         * Reduce the command line to 511 characters; 1023 caused
337           memory overflows.
339 Changes in 3.08:
340         * SYSLINUX: Fix performance regression (-s mode always
341           enabled.)
342         * Add API function for idle loop.
343         * libutil: Add do_idle() function for idle loop, make
344           get_key() use it.
345         * libutil: Add SHA-1 and base64 functions.
346         * Simple menu system: add password support.
347         * EXTLINUX: Sparse files now handled correctly.
348         * EXTLINUX: Large directories now handled correctly.
349         * ALL: At the prompt, Ctrl-X now forces text mode.
350         * Fix configuration file parsing error, that could cause
351           hangs.
352         * Rewritten advanced menuing system from Murali Ganapathy.
353         * MEMDISK: New "bigraw" mode to work around certain broken
354           BIOS flash programs.
355         * COM32 module to boot Multiboot systems, including Xen.  See
356           com32/modules/mboot.doc.
357         * Max command line changed to 1023 characters.  Note that the
358           kernel proper still can only handle 255 characters without
359           patching, and COM16 binaries can only handle 125 characters.
361 Changes in 3.07:
362         * Fix chainloading (chain.c32).
363         * Fix zlib build problem.
364         * Use a private copy of <linux/ext2_fs.h>.
366 Changes in 3.06:
367         * Fix typo that caused the ramdisk to load in the wrong place.
369 Changes in 3.05:
370         * New API function "shuffle and boot"; allows COM32 modules to
371           load or construct (almost) arbitrarily complex objects,
372           e.g. a kernel and its initrd/initramfs in pieces, and have
373           the API core reorganize memory for booting.  (A library API
374           for this function will be introduced in a later version.)
375         * The initrd= option now supports multiple filenames separated
376           by commas.  This is mostly useful for initramfs, which can
377           be composed of multiple separate cpio or cpio.gz archives.
378           (Note: all files except the last one are zero-padded to a 4K
379           page boundary.  This should not affect initramfs.)
380         * EXTLINUX: Fix API function 000Ah (get derivative-specific
381           info).
382         * libcom32/ethersel: Support PCI Config Mechanism #2 on
383           machines still infested with that hideous old hack.
384         * SYSLINUX: Fix directory-parsing bug.
386 Changes in 3.02:
387         * SYSLINUX: The "unix" installer now sets the MS-DOS
388           attributes (hidden, system, readonly.)
389         * COM32 library: build the .lnx (test modules for running
390           under Linux) as architecture native modules, in case
391           i386 devel libraries aren't installed.
392         * EXTLINUX: Hack for systems which don't have BLKGETSIZE64
393           defined in the standard header files.
394         * Simple menu system: minor aestetic improvements, and try to
395           work better over a serial console (speed, and readability on
396           monochrome terminal emulators.)
397         * New CONSOLE directive to control output on the video console
398           (useful for dealing with some broken serial-forwarding
399           BIOSes.)
400         * New com32 module "ethersel" for searching for an Ethernet
401           card and selecting the proper version of Etherboot.
402         * EXTLINUX: Allow the user to override the detected geometry.
403           Add help.
405 Changes in 3.01:
406         * EXTLINUX, SYSLINUX: Fix compile errors on some systems.
407         * EXTLINUX: Default to zipdrive geometry (64 heads, 32
408           sectors) if no other geometry can be detected.
410 Changes in 3.00:
411         * SYSLINUX: Support FAT32 and EDD.  As an unfortunate
412           consequence, LDLINUX.SYS is no longer an ordinary file; it
413           is block-mapped at install time, which means it can only be
414           written using the syslinux installers.
415         * SYSLINUX: Reorganize the source code for the installers;
416           each one of the installers (dos, win32, unix, mtools) is now
417           built in its own subdirectory.  In particular, "mtools" is
418           the unprivileged installer which uses mtools; "unix" is the
419           privileged installer which uses system calls.
420         * SYSLINUX: Completely rewritten DOS installer in C.
421         * ALL: "label" statement information is now stored in a
422           compressed format, which means that a lot more labels are
423           permitted (500-1000 in a typical configuration, but depends
424           on the complexity.)
425         * EXTLINUX: New derivative, which boots from an ext2/ext3
426           filesystem.
427         * SYSLINUX: The DOS and Win32 installers can now optionally
428           write the boot sector to a file instead of the real boot
429           sector.  This is not supported in the Linux installers,
430           however.
431         * ALL: New NOESCAPE command, disables the "hold down the Shift
432           key to display the prompt" behaviour.
433         * New simple menu system, as an alternative to the advanced
434           menu system already present.  See README.menu for details.
435         * PXELINUX: Filenames can now be prefixed with an IP address
436           or DNS name plus :: (e.g. 192.0.2.1::filename or
437           server.domain.com::filename), which downloads a file from an
438           alternate TFTP server, or just a :: (e.g. ::filename), which
439           suppresses the common pathname prefix.  See pxelinux.doc.
440         * SYSLINUX: Add an -m option to the DOS and Win32 installers
441           to write an MBR and -a to mark the partition SYSLINUX is
442           being installed on active.
443         * MEMDISK: Give a way to query the boot loader type while
444           running MEMDISK; see memdisk/memdisk.doc and
445           sample/mdiskchk.c.
446         * mkdiskimage: substantially improved mkdiskimage which, among
447           other things, can now be used to initialize USB keys as
448           zipdrives; see README.usbkey for more information.
450 Changes in 2.13:
451         * MEMDISK: Fix command-line parsing "brown paper bag" class
452           bug.
453         * MEMDISK: Add "raw" mode to support the DOS boot disk from
454           WinME/XP, which seems to deliberately crash the system
455           when someone uses the "INT 15h mover" highmem API.
456         * Make "make install" do something sane for the com32
457           development environment.
458         * In the spec file, create a separate -devel RPM for the com32
459           development environment.
461 Changes in 2.12:
462         * Simple C library, based on klibc, for writing COM32
463           programs.
464         * Fix the handling of file length in loading of COM32
465           programs.
466         * MEMDISK: Work around a linker bug by rearranging the code to
467           not use the linker for the 16-bit code.
468         * SYSLINUX: If we're building on a machine without a Win32
469           (mingw) compiler, just skip building syslinux.exe.
470         * ISOLINUX: Support non-mkisofs mastering programs, at least
471           as long as the image is single-session.  For best results,
472           ISOLINUX should be the only boot loader installed.
473         * MEMDISK: Allow the user to specify that the simulated disk
474           should be write-protected.
476 Changes in 2.11:
477         * ALL: Add an API call to get the configuration file name.
478         * SYSLINUX: Fix bug in 2.10 that prevented it from working
479           correctly for a lot of people.
480         * SYSLINUX: In the installer, make mtools a bit less fussy.
481         * Make the menu system compile with newer gcc's.
483 Changes in 2.10:
484         * MEMDISK: Handle images compressed with zip as well as with
485           gzip.  Some Windows-based image tools apparently generate
486           these kinds of images by default.  Patch by Patrick
487           LoPresti.
488         * Major menu improvement from Murali Ganapathy.
489         * ISOLINUX: Wonderfully sick and brilliant workaround for
490           severe bugs in certain Award BIOSes; from Knut Petersen.
491         * SYSLINUX: Fix for the nomtools installed, from Frederic
492           Pasteleurs.
493         * PXELINUX: Fix handling of IP numbers in the ranges
494           100-109 and 200-209.
495         * ALL: New option "allowoptions" (defaults to 1), which
496           controls if options are allowed on the command line or not.
497         * SYSLINUX: Support building under klibc (see the klibc
498           distribution for details.)
500 Changes in 2.09:
501         * SYSLINUX: Remove residual setuid crap from
502           syslinux-nomtools.
503         * Handle video pages correctly when using the API functions.
504         * Handle compiling on an x86-64 platform correctly.
505         * Menu system from Murali Krishnan Ganapathy; see the menu
506           directory for information.
507         * COMBOOT: Allow COMBOOT programs to change screen text mode.
508         * COMBOOT: Correct the documentation of how to detect
509           SYSLINUX from COMBOOT!!!!
510         * COMBOOT: Fix "get key without echo" API function.
511         * SYSLINUX: Fix bug that affected the API open function.
512         * ALL: Improve the E820 memory parser, to work around some
513           buggy BIOSes.
515 Changes in 2.08:
516         * Add new configuration command "ontimeout" to allow timeout
517           to have a different action than just pressing Enter.
518         * Add new configuration command "onerror" to allow a custom
519           command to be executed in case the kernel image is not found.
520         * Fix bugs in the COMBOOT/COM32 command-line parsing.  APPEND
521           now works with COMBOOT/COM32 images.
522         * PXELINUX: Poll for ARP requests while sitting at the
523           prompt.  This makes some boot servers a lot less unhappy.
524         * PXELINUX: Actually free sockets when we get a failure
525           (including file not found.)  This bug would cause us to run
526           out of sockets and thus "go deaf" after a while.
527         * MEMDISK: Add an API to query for the existence of MEMDISK.
528         * SYSLINUX: Fix loading boot sectors (.bs/.bss) from floppy
529           disk.
530         * .c32 is now one of the extensions searched for
531           automatically.
532         * PXELINUX: RFBG.exe seems to randomly overwrite memory
533           location 0x5700.  Thus, don't use it!
534         * PXELINUX: Change pathname length max from 63 to 127; change
535           max vkernels from 128 to 64.
536         * Support Ctrl-U -> kill entire command line input.
537         * The "samples" directory contains a (barely at all tested)
538           chain loading example, chain.c32, which may be used to
539           chainload local floppy disks and hard disks.  Use with
540           "chain fdN" or "chain hdN [partition]"; N = 0 for the first
541           drive of each type.
543 Changes in 2.07:
544         * MEMDISK: Workaround for BIOSes which go into a snit when
545           they get a RESET command for the floppy system when there is
546           no floppy in the system.
547         * PXELINUX: Add "ipappend 2", which passes the hardware
548           address of the boot interface to the kernel as a
549           command-line option.
550         * mkdiskimage: fix the generation of the end limit.
551         * PXELINUX: Fix multiple bugs in chainloading of other NBPs.
552         * MEMDISK: Fix bug that would occationally cause "ran out of
553           input data" when using compressed disk images.
554         * SYSLINUX: Updates for the win32 installer (from Lars Munch.)
555         * PXELINUX: PXELINUX-specific options are now recognized both
556           in a vendor-option-space (a.k.a. type 43 encapsulated) as
557           well as in a site-option-space (unencapsulated.)
558         * COM32: Don't crash when DS != 0.
559         * COMBOOT/COM32: Make file reading work correctly.  Thanks to
560           Phung Chi Kien for submitting a test program.
562 Changes in 2.06:
563         * ALL: Fix problem that would occationally cause a
564           boot failure, depending on the length of the kernel.
565         * ISOLINUX: Fix problem that would occationally cause a
566           boot failure, depending on the length of directories.
567         * SYSLINUX: Win32 installer now flushes buffers.
568         * ppmtolss16: Be fully compliant with the PNM spec;
569           actually process comments in the header and odd
570           alignments of the various parameters, as well as
571           "plain" (not raw) files and PBM and PGM files.
572         * PXELINUX: Lower the default MTU to 1472 in order to deal
573           with systems with slightly nonstandard MTUs, and PXE
574           stacks which don't defragment correctly.  Unfortunately this
575           is very hard to test dynamically.
577 Changes in 2.05:
578         * PXELINUX: Add a default query based on the hardware address
579           of the boot device.  This is in lower case hexadecimal form
580           separated by dashes and including the hardware type, for
581           example, the Ethernet (type 1) address 88:99:AA:BB:CC:DD
582           would query the file pxelinux.cfg/01-88-99-aa-bb-cc-dd.
583         * PXELINUX: Fix bug involving non-IP-based config file names.
584         * SYSLINUX: New installer for WinNT-based systems, from Lars
585           Munch.
586         * MEMDISK: Fix handling of memory region overlap when
587           decompressing.  Thanks to Mikhail Kupchik for identifying
588           the problem.
590 Changes in 2.04:
591         * ALL: Reclaim even more low memory by observing that
592           comboot_seg == real_mode_seg is perfectly fine, and by the
593           fact that the 1000h segment managed to get unused in all
594           derivatives...
595         * PXELINUX: Attempt to negotiate full Ethernet-sized blocks
596           (1468 bytes) using the blksize option.
597         * SYSLINUX: Resurrect the old no-mtools version of the
598           installer, although as a root-only tool.  Some distributors
599           have indicated that they need a small standalone installer.
600         * MEMDISK: Fix a memory offset computation error when
601           installing compressed disks which generally would cause
602           1 MB of memory to be wasted.
603         * MEMDISK: Fix installing the E820 memory map.  Calling
604           INT 15h AX=0E820h with MEMDISK 2.03 loaded would give a
605           completely corrupt memory map.
606         * SYSLINUX: Make libsyslinux a dynamic library, so that it can
607           be updated separately from client programs.  The whole idea,
608           after all, is to enable alternate programs to become
609           syslinux installers.
610         * Include an rpm spec file in the distribution, so rpmbuild
611           -ta works.
613 Changes in 2.03:
614         * Actually support comment lines in the configuration file.
615         * PXELINUX: Try to resolve some problems with stack switches.
616         * PXELINUX: Handle PXE stacks with broken routing.
617           With these workarounds, the remote install PXE boot floppy
618           (rbfg.exe) from Argon Technologies should work correctly.
619         * Fix problems with Perl scripts in UTF-8 locales.
620         * You probably need NASM 0.98.34 or later to compile this
621           version.  0.98.36 is recommended.
622         * MEMDISK: Now supports gzip compressed images.
624 Changes in 2.02:
625         * SYSLINUX: Security flaws have been found in the SYSLINUX
626           installer when running setuid root.  Rewrite the SYSLINUX
627           installer so it uses mtools instead.  It therefore now
628           requires mtools (specifically mcopy and mattrib) to exist on
629           your system, but it will not require root privileges and
630           SHOULD NOT be setuid.
632 Changes in 2.01:
633         * MEMDISK: Fix memory sizing bug when the ramdisk crosses the
634           16 MB boundary.
635         * MEMDISK: Add a "pause" option to stop immediately before
636           booting, to read off the messages.
637         * MEMDISK: Support disk images with DOSEMU headers.
638         * Update the mkdiskimage script to handle newer mtools
639           versions, and be able to generate disk images with DOSEMU
640           headers (controlled by the -d option).
641         * Fix the COM32 sample program.
642         * PXELINUX, ISOLINUX: Fix some COMBOOT API calls.
643         * PXELINUX: Doc fix.
644         * Build SYSLINUX into a small library for encapsulation into
645           other programs (however, please keep in mind this is a GPL'd
646           library.)
647         * SYSLINUX: Make installer work with "owner" in /etc/fstab.
648         * SYSLINUX: Fix issue with working on nonpartitioned hard disk
649           devices.  THIS CONFIGURATION IS NOT RECOMMENDED.
651 Changes in 2.00:
652         * ALL: Add support for "COM32" (32-bit COMBOOT) images.
653         * ALL: Add an API for COMBOOT/COM32 images.  See comboot.doc
654           for details.  There is a C development environment for
655           COM32 being created; it should be ready at some point in
656           the future.
657         * Fix mbr.asm so that it actually works.
658         * SYSLINUX: The syslinux installer *SHOULD* now be safe to
659           run setuid root.
660         * PXELINUX: Fix bug where PXELINUX would override random
661           chunks of the UNDI code segment!  Thanks to Kevin Tran for
662           finding this bug.
663         * ISOLINUX: Fix a bug related to slashes in pathnames.
664         * ISOLINUX: Fix a bug in handling initrds over 128 MB.
665         * ALL: Make the <Ctrl-V> key print out the version; this is
666           to help debugging.
667         * Add a small script, mkdiskimage, to create a DOS-formatted
668           hard disk image using mtools.  This may be useful in
669           conjunction with MEMDISK.
670         * ISOLINUX: Search for a /boot/isolinux directory as well as
671           /isolinux.
672         * ALL: Fix a bug related to very long configuration files.
673         * PXELINUX: Work around a NASM bug which would result in no
674           delay before reset if an error occurs.
676 Changes in 1.76:
677         * ISOLINUX: Remove code no longer used which caused hangs on
678           some Toshiba laptops.
680 Changes in 1.75:
681         * ALL: NASM 0.98.32 or later is now required to build
682           SYSLINUX from sources.
683         * SYSLINUX: put back in the workaround for the BIOS floppy
684           table.  This seems to be a requirement for "extended" floppy
685           formats to work correctly.
686         * SYSLINUX: No longer warn if one is trying to boot on a 286
687           or older.  The above BIOS workaround no longer fits if the
688           requirement to use only 8086-compatible code in the early
689           boot is maintained.  It made sense in 1994, but in 2002 a
690           286 or older is a museum object.
691         * SYSLINUX: Use a downright bizarre, stateful algorithm to try
692           to guess the maximum transfer size.  I am *hoping* this will
693           cut down on the number of systems for which -s is required
694           to work at any acceptable speed.
695         * ISOLINUX: Add a few more workarounds for various broken El
696           Torito BIOSes.
697         * Make sure .depend files aren't accidentally packed...
698         * ALL: Fix bugs in the extension-detect code; this caused
699           files like COMBOOT images and CD boot sectors to be
700           mis-identified as Linux kernels and rejected.
701         * ALL: Fix the return from COMBOOT.
702         * ALL: Do some of the early groundwork for supporting DOS
703           system calls in COMBOOT.
704         * Get rid of unnecessary "near" directives, making the code
705           bigger.
706         * PXELINUX: Put the PXE stack back in the init state before
707           invoking a chain-loaded NBP.
708         * PXELINUX: Actually found the combination of calls that
709           allows some (most?) PXE 2+ stacks to be unloaded from memory
710           properly.
711         * PXELINUX: Add "keeppxe" command-line option to disable
712           the standard unloading of the PXE stack.
714 Changes in 1.74:
715         * SYSLINUX: fix bug that would cause valid kernel images to be
716           labelled "invalid".
718 Changes in 1.73:
719         * Work on removing gratuitous differences between modules.
720         * Break up the source in common and module-specific files.
721         * PXELINUX: Allow chaining of other PXE NBPs.
722         * ISOLINUX: Allow loading "CD-ROM boot sectors".
723         * ALL: generalize the definition of a boot sector/NBP.
725 Changes in 1.72:
726         * PXELINUX, ISOLINUX: Fix bugs in the new core code.
728 Changes in 1.71:
729         * Fix a "brown paper bag" class bug in the new core code.
731 Changes in 1.70:
732         * Major code restructuring.
733         * Relax the conventional memory limits somewhat.
734         * MEMDISK: Set up the "version number string" pointer in the
735           header correctly.
736         * SYSLINUX: Fix, again, "the bug that won't die": the use of
737           the offset parameter with the SYSLINUX installer.
738         * SYSLINUX: Fix possible superblock corruption problem in the
739           SYSLINUX installer.
741 Changes in 1.67:
742         * Handle bug in the location of initrd.
744 Changes in 1.66:
745         * MEMDISK: Make compile with newer versions of gcc.
747 Changes in 1.65:
748         * ISOLINUX: Support booting disk image files (to boot DOS or
749           other non-Linux operating systems), *IF* the BIOS works
750           correctly; unfortunately many BIOSes apparently don't.
751         * Support Linux boot protocol version 2.03 (explicitly
752           specify the initrd address limit.)
753         * Handle small "pseudo-kernels"; images that use the Linux
754           kernel boot protocols but are less than 64K in size.
755         * MEMDISK: New subsystem; this is a driver which allows
756           legacy OSes to boot using an in-memory simulated disk.
757           See memdisk/memdisk.doc for more info.
758         * PXELINUX, ISOLINUX: Correctly handle files larger than 65535
759           blocks (32 MB for PXELINUX, 128 MB for ISOLINUX.)
760         * PXELINUX: Make a best-effort attempt at freeing all memory
761           claimed.  From the looks of it, it will fail on most PXE
762           stacks.
764 Changes in 1.64:
765         * Limited support for hardware flow control when using a
766           serial port console.
767         * Support specifying the serial port I/O address explicitly.
768         * Make DOS installer hopefully behave more nicely when used on
769           recent Windows versions.
770         * Fix returning to text mode when a font has been specified.
771         * Attempt to detect missing serial port hardware and disable
772           the serial port if there is nothing there.
774 Changes in 1.63:
775         * Make the ppmtolss16 program handle color conversion more
776           correctly.
777         * Clean up "make install" target, honour INSTALLROOT if it
778           exists.
779         * SYSLINUX: Fix stack-smash bug identified by Steffen
780           Winterfeldt.
781         * Hopefully fix return-to-text-mode on some graphics cards.
782         * ISOLINUX: Bug workaround for Award BIOS 4.51, and perhaps
783           other buggy BIOSes as well.
785 Changes in 1.62:
786         * PXELINUX: Allow the DHCP server to override the
787           configuration file name and pathname prefix, using
788           "site-specific" DHCP options.
789         * PXELINUX: Documentation fixes.
790         * PXELINUX: Fix the "ipappend" option; the last two values
791           were reversed vs. what the kernel expected.
792         * Introduce a way to return to text mode once we are already
793           in graphics mode.  This may be useful for F-key help
794           screens.
795         * Fix several bugs in the way return to text mode was handled.
797 Changes in 1.61:
798         * ISOLINUX: Support full pathname searches.  Max length for a
799           pathname is 255 characters.  As a result, only 64 "label"
800           statements are supported in ISOLINUX.
801         * PXELINUX: Max filename length extended to 63 characters.
803 Changes in 1.60:
804         * Add support for graphical splash screens.
805         * Add mode control characters, which allows you to control
806           message display output depending on output mode (text,
807           graphics, or serial port.)
808         * ISOLINUX: New program, which boots Linux from a CD-ROM
809           without using floppy emulation mode.  See isolinux.doc for
810           more details.
811         * PXELINUX: Don't search for boot sector file types, since
812           they don't work anyway.
813         * SYSLINUX: Document the LOCK command for Win9x, and the error
814           dialog box for WinNT/2K.
816 Changes in 1.54:
817         * PXELINUX: Fix code for finding !PXE from PXENV+.  This was
818           due to a spec bug; match the most recent spec since that
819           seems to be what implementations actually do.
820         * SYSLINUX: Add some smarts to the boot sector, which
821           hopefully should reduce the number of systems which require
822           stupid mode ("syslinux -s").
823         * PXELINUX: Document further some of the pathologies with old
824           PXE stacks.
825         * When specifying a "default" command line, no longer
826           automatically appent "auto".  See the "DEFAULT" command in
827           syslinux.doc for more information.
828         * PXELINUX: Clean up the allocation of local socket numbers.
830 Changes in 1.53:
831         * PXELINUX: Rename pxelinux.bin to pxelinux.0, to match what
832           most PXE servers seem to expect.
833         * PXELINUX: Update the DHCP/boot server setup documentation.
834         * PXELINUX: Support new "localboot" option for "label"
835           sections.
836         * PXELINUX: More robust parsing of DHCP/boot server packets.
837         * PXELINUX: Include a small utility program "gethostip" to
838           compute hexadecimal IP addresses.
840 Changes in 1.52:
841         * PXELINUX: Fix bugs introduced by new A20 code.  (SYSLINUX
842           has also been changed for code consistency reasons, but I'm
843           pretty sure the changes are don't care on SYSLINUX.)
844         * Documentation updates.
845         * PXELINUX: Add "ipappend" option to generate an ip= option to
846           the kernel.
848 Changes in 1.51:
849         * PXELINUX: Not all PXE stacks fill in the IP address for a
850           type 3 cached info query.  Use a type 2 cached info query
851           for this information (only.)
852         * Yet another attempt at A20 coding.  Now support BIOS call
853           15:2401 as well, and handle machines which always have A20
854           on separately.
855         * Support memory detection using INT 15h, AX=0E820h.  BIOS
856           manufacturers have apparently gotten sloppy about keeping
857           INT 15h, AX=0E801h working properly.
858         * Don't issue <CR><LF> onto the serial port when we're doing
859           screen wraparound.
861 Changes in 1.50:
862         * Yet another A20-code update.  It seems some "legacy-free"
863           machines and embedded gear simply don't have a KBC to talk
864           to, and that waiting for one will wait forever.  Sigh.
866 Changes in 1.49:
867         * SYSLINUX: Implement a hack for BIOS drivers which hog significant
868           chunks of low memory during boot.  (Note: PXELINUX already
869           had this modification.  SYSLINUX does still require that the
870           low 512K is available; PXELINUX requires 384K.  Machines
871           with a physical memory hole in the low 640K cannot boot
872           Linux no matter what.)  Depending what the reason is for the
873           memory hole, a new kernel (2.4.0-test3-pre3 or later) may be
874           required.
875         * SYSLINUX: Default installer binary now compiled against
876           glibc 2.1.  If this is inappropriate for your system and you
877           still want to use the offical version of SYSLINUX, please
878           follow the instructions in "distrib.doc" to rebuild the
879           installer.
880         * SYSLINUX: Linux installer program now supports -o <offset>
881           option which does a loopback mount with the
882           -o loop,offset=<> option.  Useful to run SYSLINUX on an
883           individual partition of a whole-harddisk image.
884         * Include the source code to a Master Boot Record (MBR)
885           functionally equivalent to the one installed DOS except it
886           includes EBIOS support, and should be resistant to geometry
887           changes.  The MBR code is public domain.
888         * PXELINUX: Fix "double p" bug: if the tftp prefix was null,
889           all filenames would get a "p" preprended, e.g.
890           "ppxelinux.cfg" and "pvmlinux".
892 Changes in 1.48:
893         * PXELINUX: Workaround for PXE ROMs based on the Intel PXE PDK
894           3.0 build 071 and earlier: missing !PXE structure pointer.
895         * PXELINUX: Handle larger BOOTP/DHCP packages.
896         * PXELINUX: The command line passing was broken; fix.
897         * PXELINUX: Make COMBOOT images work.
898         * PXELINUX: Documentation on how to make booting work using
899           the PDK 3.0-derived clients, which aren't so generous as to
900           allow booting with only "PXEClient" specified.
902 Changes in 1.47:
903         * PXELINUX: RFC 1123 states that a TFTP implementation MUST
904           use adaptive timeout, "at least an exponential backoff of
905           retransmission timeout is necessary."  Implement a very
906           simple exponential backoff for retransmits.
907         * PXELINUX: Updated documentation, including pointer to new
908           TFTP server.
909         * PXELINUX: When sending ERROR due to bad OACK, use the proper
910           destination port number (why are TFTP port numbers so odd?)
911         * PXELINUX: If the boot dies in the middle somewhere,
912           eventually give up and reset the machine (unattended
913           operation.)
915 Changes in 1.46:
916         * New program PXELINUX to do network booting using a
917           PXE-compliant (Pre-Execution Environment) network booting
918           PROM.  See pxelinux.doc for details.
920 Changes in 1.45:
921         * Serial console support.  See syslinux.doc for details.
923 Changes in 1.44:
924         * Change HIGHMEM_MAX to 38000000h to (hopefully) avoid the
925           kernel stepping on it; 3f000000h was apparently a higher
926           limit than the kernel used!
928 Changes in 1.43:
929         * Add sys2ansi.pl script to display the contents of a
930           colorized SYSLINUX file.
931         * Changed the io_delay once again, after a report that the
932           old delay port causes hangs on some systems.
934 Changes in 1.42:
935         * Frob the "fast A20 gate" port as well as the keyboard
936           controller; will this help systems with problems?
937         * Be even more paranoid about A20, unfortunately even this
938           seems to be not paranoid enough... what I don't understand
939           is that if there is hardware out there *this broken*, how
940           can it run Linux at all?  Report an error message rather
941           than hang forever if A20 is stuck.
942         * Include some intermediate files in the distribution, plus
943           provide a "make installer" target for distributors to relink
944           the install programs only.  I would prefer the syslinux boot
945           loader proper to be "binary clean" for debuggablity -- use
946           "make clean ; make installer" to rebuild the installers only.
948 Changes in 1.41:
949         * Don't get confused by directories, volume labels, or VFAT
950           long names.
951         * Use INT 15h, AX=0E801h to query memory size before trying
952           INT 15h, AH=88h.  This not only provides more headroom
953           between the kernel and the initrd on large-memory machines,
954           but it appears some recent BIOSes actually have started
955           returning garbage for the AH=88h (older) call.
956         * Trust high memory beyond the 15 MB mark if the user has
957           specified it, or if obtained with INT 15h, AH=0E801h (with
958           no memory holes above 1 MB.)
960 Changes in 1.40:
961         * Increase A20M delay and put in a test to avoid problems on
962           certain IBM Thinkpads (thanks to Donnie Barnes of RedHat
963           for vital info on this one.)
964         * Support COMBOOT style boot command images.
965         * Support chain loading (foreign operating systems, e.g. DOS).
966         * Include a new "copybs" DOS utility to copy a boot sector to
967           a file (under Linux, use "dd".)
968         * Fix the DOS installer to work for disks over 32 MB.
969         * SYSLINUX should now handle disks with more than 65536 tracks.
971 Changes in 1.37:
972         * Fix a bug that caused "label" statements in syslinux.cfg to
973           not be handled properly.
974         * Updated the documentation.  Among other things, we now allow
975           up to 128 "label" statements.
977 Changes in 1.36:
978         * Fix for booting old (pre-initrd) kernels.
979         * It seems at least some versions of OS/2 doesn't set up all
980           the fields in the superblock correctly.  Account for that.
981         * Fix bug that caused boot failure when using the mem= option.
983 Changes in 1.35:
984         * Loading from partitions now should work properly.  (Actually
985           tested, this time.  You should even be able to dd a floppy
986           to a partition and boot from it.)
987         * Removed large workaround code for an alleged ancient BIOS
988           bug I have never actually seen.  The -s option should work
989           on those machines, anyway.
990         * Support for simple keyboard remappings, same as used by
991           LILO (once again to support localization.)  The program
992           keytab-lilo.pl from the LILO distribution included to
993           generate such maps.
994         * Added a "safe, slow and stupid" (-s) option to the
995           installers.  This option will lobotomize the boot sector to
996           hopefully work on even very buggy BIOSes.
998 Changes in 1.34:
999         * Ability to load a VGA font on bootup (for localized Linux
1000           distributions.)
1002 Changes in 1.33:
1003         * Bug fix in the Linux installer.
1004         * Added a workaround for a bug in certain AMI/Intel BIOSes
1005           when booting from CD-ROM.
1006         * Documentation changes.
1008 Changes in 1.32:
1009         * FAT16 filesystems are now supported.
1011 Changes in 1.31:
1012         * Now compiles under Linux, using NASM, rather than using
1013           Turbo Assembler under DOS.  See http://www.cryogen.com/Nasm
1014           for information about NASM.
1015         * Linux-hosted SYSLINUX installer, as well as a
1016           rewritten DOS installer (now is written in assembler, so we
1017           don't need Turbo C.)
1019 Changes in 1.30:
1020         * Added support for loading bzImage and initrd loading, and made
1021           SYSLINUX new-setup-code aware (SYSLINUX 1.30 id=0x31).
1022         * Added LILO-style kernel labels; see the LABEL and IMPLICIT
1023           keywords in README file.
1024         * Added support for colorization of intro and help screens.
1025         * The vga= option is now handled correctly.
1026         * Massive rewrite of large chunks of the code in order to
1027           support the first two new features.
1029 Changes in 1.20:
1030         * Added simple online help at the "boot:" prompt.
1031         * Removed 2880K image as I no longer have access to such a
1032           floppy drive.  (Donations accepted!!)
1033         * Decided to distribute the source in a subdirectory rather
1034           than in a nested zipfile.
1036 Changes in 1.11:
1037         * Removed a sanity check which would cause booting to fail on
1038           Phoenix BIOS version 4.03.  Apparently this BIOS is buggy.
1040 Changes in 1.10:
1041         * Added configuration file SYSLINUX.CFG.  This file contains all
1042           configurable options, and can be edited from any OS which can
1043           access an MS-DOS filesystem; there is no longer a need to run
1044           SYSLINUX.EXE except to write the boot sector.
1045         * Default command line now given by "default" line in config
1046           file.
1047         * LINUXMSG.TXT and BOOTMSG.TXT hard-coded file names replaced by
1048           "display" and "prompt" lines in config file.
1049         * LILO-style option appending now supported ("append" line in
1050           config file).
1051         * Prompt timeout is now supported ("timeout" line in config
1052           file).  The timeout is cancelled when anything is typed on the
1053           command line.
1054         * Pressing <ESC> or <Ctrl-C> at the Loading... stage now aborts
1055           the kernel loading in progress and returns the user to the
1056           boot: prompt.
1057         * The installer now automatically sets the READONLY flag on
1058           LDLINUX.SYS.
1059         * Added 2880K disk image.
1061 Changes in 1.03:
1062         * Fixed bug that would prevent booting from double-density
1063           floppies and other DOS filesystems with multiple sectors per
1064           cluster.
1065         * Added 720K disk image.
1066         * Changed default kernel name on disk images to LINUX.
1068 Changes in 1.02:
1069         * Fixed bug that would garble the command line on recent kernels
1070           with more than 4 sectors of setup code (this wasn't really a
1071           *bug*; rather, a kernel change broke the code.  Unfortunately
1072           the Linux boot interface is still sorely undocumented).
1073         * Added BOOTMSG.TXT file support (message file which does not
1074           force display of the boot prompt).
1076 Changes in 1.01:
1077         * Fixed bug on some (most?) 386 BIOSes would require two boot
1078           attempts.