From 147ceef8c47a163b8ac88b2485f44bb330585896 Mon Sep 17 00:00:00 2001 From: "H. Peter Anvin" Date: Tue, 14 Oct 2008 17:53:44 -0700 Subject: [PATCH] SYSLINUX -> Syslinux Adopt the moniker "The Syslinux Project", ordinary proper noun capitalization, to refer to the project as a whole. This leaves the all-caps SYSLINUX to refer to the FAT loader only. Signed-off-by: H. Peter Anvin --- doc/SubmittingPatches.txt | 4 +-- doc/comboot.txt | 68 +++++++++++++++++++++++------------------------ doc/distrib.txt | 8 +++--- doc/extlinux.txt | 20 +++++++------- doc/keytab-lilo.txt | 2 +- doc/mboot.txt | 6 ++--- doc/memdisk.txt | 2 +- doc/menu.txt | 10 +++---- doc/pxelinux.txt | 8 +++--- doc/sdi.txt | 2 +- doc/syslinux.txt | 58 +++++++++++++++++++++------------------- 11 files changed, 96 insertions(+), 92 deletions(-) diff --git a/doc/SubmittingPatches.txt b/doc/SubmittingPatches.txt index d8c6be3..dd764a7 100644 --- a/doc/SubmittingPatches.txt +++ b/doc/SubmittingPatches.txt @@ -1,6 +1,6 @@ -I don't have specific submission guidelines for SYSLINUX, but the ones +I don't have specific submission guidelines for Syslinux, but the ones that appropriate to the Linux kernel are certainly good enough for -SYSLINUX. +Syslinux. In particular, however, I appreciate if patches sent follow the standard Linux submission format, as I can automatically import them diff --git a/doc/comboot.txt b/doc/comboot.txt index 8c4a868..ceee93a 100644 --- a/doc/comboot.txt +++ b/doc/comboot.txt @@ -2,7 +2,7 @@ COMBOOT and COM32 files -SYSLINUX supports simple standalone programs, using a file format +Syslinux supports simple standalone programs, using a file format similar to DOS ".com" files. A 32-bit version, called COM32, is also provided. A simple API provides access to a limited set of filesystem and console functions. @@ -18,7 +18,7 @@ A COMBOOT image can be written to be compatible with MS-DOS. Such a file will usually have extension ".com". A COMBOOT file which is not compatible with MS-DOS will usually have extension ".cbt". -Before running the program, SYSLINUX sets up the following fields in +Before running the program, Syslinux sets up the following fields in the Program Segment Prefix (PSP), a structure at offset 0 in the program segment: @@ -37,18 +37,18 @@ paragraph value given at offset 2. On startup, SP is set up to point to the end of the 64K segment, at 0xfffe. Under DOS it is possible for SP to contain a smaller -value if memory is very tight; this is never the case under SYSLINUX. +value if memory is very tight; this is never the case under Syslinux. The program should make no assumptions about what segment address it will be loaded at; instead it should look at the segment registers on -program startup. Both DOS and SYSLINUX will guarantee CS == DS == ES +program startup. Both DOS and Syslinux will guarantee CS == DS == ES == SS on program start; the program should not assume anything about the values of FS or GS. To exit, a program can either execute a near RET (which will jump to offset 0 which contains an INT 20h instruction, terminating the program), or execute INT 20h or INT 21h AH=00h or INT 21h AH=4Ch. -If compatiblity with SYSLINUX 1.xx is desired, use INT 20h. +If compatiblity with Syslinux 1.xx is desired, use INT 20h. ++++ COM32 file format ++++ @@ -56,7 +56,7 @@ If compatiblity with SYSLINUX 1.xx is desired, use INT 20h. A COM32 file is a raw binary file containing 32-bit code. It should be linked to run at address 0x101000, and should not contain any segment references. It will be run in flat-memory 32-bit protected -mode. Under SYSLINUX, it will be run in CPL 0, however, since it may +mode. Under Syslinux, it will be run in CPL 0, however, since it may be possible to create a COM32 execution engine that would run under something like Linux DOSEMU, it is recommended that the code does not assume CPL 0 unless absolutely necessary. @@ -100,7 +100,7 @@ int _start(unsigned int __nargs, int (*__cfarcall)(uint32_t, void *, size_t) ); -The intcall helper function can be used to issue BIOS or SYSLINUX API +The intcall helper function can be used to issue BIOS or Syslinux API calls, and takes the interrupt number as first argument. The second argument is a pointer to the input register definition, an instance of the following structure (available in ): @@ -133,7 +133,7 @@ The third argument is a pointer to the output register definition, an instance of the same structure. The third argument can also be zero (NULL). -Since BIOS or SYSLINUX API calls can generally only manipulate data +Since BIOS or Syslinux API calls can generally only manipulate data below address 0x100000, a "bounce buffer" in low memory, at least 64K in size, is available, to copy data in and out. @@ -148,9 +148,9 @@ frame, a size of that stack frame, and returns the return value of EAX ++++ SYSLINUX API CALLS +++ -SYSLINUX provides the following API calls. SYSLINUX 1.xx only +Syslinux provides the following API calls. Syslinux 1.xx only supported INT 20h - terminate program. [] indicates the first version -of SYSLINUX which supported this feature (correctly.) +of Syslinux which supported this feature (correctly.) NOTE: Most of the API functionality is still experimental. Expect to find bugs. @@ -212,20 +212,20 @@ INT 21h AH=30h [2.00] Check DOS Version EAX=59530000h EBX=4C530000h ECX=4E490000h EDX=58550000h This function can thus be used to distinguish running on - SYSLINUX from running on DOS. + Syslinux from running on DOS. ++++ SYSLINUX-SPECIFIC API CALLS ++++ -SYSLINUX-specific API calls are executed using INT 22h, with a +Syslinux-specific API calls are executed using INT 22h, with a function number in AX. INT 22h is used by DOS for internal purposes; do not execute INT 22h under DOS. DOS-compatible function INT 21h, AH=30h can be used to detect if the -SYSLINUX API calls are available. +Syslinux API calls are available. Any register not specifically listed as modified is preserved; -however, future versions of SYSLINUX may add additional output +however, future versions of Syslinux may add additional output registers to existing calls. All calls return CF=0 on success, CF=1 on failure. The noted outputs @@ -238,13 +238,13 @@ AX=0001h [2.00] Get Version Input: AX 0001h Output: AX number of INT 22h API functions available - CH SYSLINUX major version number - CL SYSLINUX minor version number - DL SYSLINUX derivative ID (e.g. 32h = PXELINUX) - ES:SI SYSLINUX version string - ES:DI SYSLINUX copyright string + CH Syslinux major version number + CL Syslinux minor version number + DL Syslinux derivative ID (e.g. 32h = PXELINUX) + ES:SI Syslinux version string + ES:DI Syslinux copyright string - This API call returns the SYSLINUX version and API + This API call returns the Syslinux version and API information. @@ -264,7 +264,7 @@ AX=0003h [2.01] Run command Output: Does not return This API call terminates the program and executes the command - string as if the user had entered it at the SYSLINUX command + string as if the user had entered it at the Syslinux command line. This API call does not return. @@ -275,7 +275,7 @@ AX=0004h [2.01] Run default command This API call terminates the program and executes the default command string as if the user had pressed Enter alone on the - SYSLINUX command line. This API call does not return. + Syslinux command line. This API call does not return. AX=0005h [2.00] Force text mode @@ -297,12 +297,12 @@ AX=0006h [2.08] Open file CX file block size Open a file for reading. The exact syntax of the filenames - allowed depends on the particular SYSLINUX derivative. + allowed depends on the particular Syslinux derivative. - The SYSLINUX file system is block-oriented. The size of a + The Syslinux file system is block-oriented. The size of a block will always be a power of two and no greater than 16K. - Note: SYSLINUX considers a zero-length file to be nonexistent. + Note: Syslinux considers a zero-length file to be nonexistent. In 3.70 or later, EAX can contain -1 indicating that the file length is unknown. @@ -328,7 +328,7 @@ AX=0007h [2.08] Read file reached. The address of the buffer (ES:BX) should be at least 512-byte - aligned. SYSLINUX guarantees at least this alignment for the + aligned. Syslinux guarantees at least this alignment for the COMBOOT load segment or the COM32 bounce buffer. Keep in mind that a "file" may be a TFTP connection, and that @@ -454,7 +454,7 @@ AX=000Ah [2.00] Get Derivative-Specific Information AX=4B01h to obtain the spec packet directly from the BIOS if necessary. - This call gives information specific to a particular SYSLINUX + This call gives information specific to a particular Syslinux derivative. The value returned in AL is the same as is returned in DL by INT 22h AX=0001h. @@ -502,7 +502,7 @@ AX=000Ch [2.00] Perform final cleanup EXTLINUX: 0000h Normal cleanup All other values are undefined, and may have different - meanings in future versions of SYSLINUX. + meanings in future versions of Syslinux. AX=000Dh [2.08] Cleanup and replace bootstrap code @@ -644,7 +644,7 @@ AX=0013h [3.08] Idle loop call Starting with version 3.10, this API call harmlessly returns failure (CF=1) if invoked on a platform which does not need idle calls. Additionally, it's safe to call this API call on - previous SYSLINUX versions (2.00 or later); it will just + previous Syslinux versions (2.00 or later); it will just harmlessly fail. Thus, if this call returns failure (CF=1), it means that there is no technical reason to call this function again, although doing so is of course safe. @@ -667,7 +667,7 @@ AX=0015h [3.10] Get feature flags Output: ES:BX pointer to flags in memory CX number of flag bytes - This function reports whether or not this SYSLINUX version and + This function reports whether or not this Syslinux version and derivative supports specific features. Keep in mind that future versions might have more bits; remember to treat any bits beyond the end of the array (as defined by the value in @@ -735,15 +735,15 @@ AX=0017h [3.30] Report video mode change Output: None This function is used to report video mode changes to - SYSLINUX. It does NOT actually change the video mode, but - rather, allows SYSLINUX to take appropriate action in response + Syslinux. It does NOT actually change the video mode, but + rather, allows Syslinux to take appropriate action in response to a video mode change. Modes that cannot be exited either with the conventional BIOS mode set command (INT 10h, AH=00h) or the VESA VBE mode set command (INT 10h, AX=4F02h) should not be used. This function returns with a failure if BX contains any bits - which are undefined in the current version of SYSLINUX. + which are undefined in the current version of Syslinux. The following bits in BX are currently defined: @@ -767,7 +767,7 @@ AX=0017h [3.30] Report video mode change This indicates that the BIOS text output functions (INT 10h, AH=02h, 03h, 06h, 09h, 0Eh, 11h) don't work. - If this bit is set, SYSLINUX will reset the mode + If this bit is set, Syslinux will reset the mode before printing any characters on the screen. This is common for VESA modes. diff --git a/doc/distrib.txt b/doc/distrib.txt index 5e71017..fa10a04 100644 --- a/doc/distrib.txt +++ b/doc/distrib.txt @@ -1,9 +1,9 @@ For creators of Linux distributions: -SYSLINUX is a notoriously hard program to debug, since it runs outside +Syslinux is a notoriously hard program to debug, since it runs outside of any operating system, and has a tendency to expose BIOS and hardware bugs on various systems. Therefore, I would appreciate if -you would resist the temptation of recompiling the SYSLINUX bootloader +you would resist the temptation of recompiling the Syslinux bootloader itself (ldlinux.asm) if at all possible. If you do that, I will have to refer any bug reports I receive back to the respective distributor. @@ -12,10 +12,10 @@ programs, and in fact, with both libc 5 and libc 6 in common use in the Linux world today I understand if you wish to relink the Linux-based installer against your system version of libc. Therefore a special makefile targets "make installer" has been included with the -SYSLINUX distribution, starting with version 1.42. +Syslinux distribution, starting with version 1.42. To rebuild the installer programs *only*, starting from a freshly -untarred distribution copy of SYSLINUX, do: +untarred distribution copy of Syslinux, do: make clean make installer diff --git a/doc/extlinux.txt b/doc/extlinux.txt index 3604a29..cb26fad 100644 --- a/doc/extlinux.txt +++ b/doc/extlinux.txt @@ -1,7 +1,8 @@ -EXTLINUX is a new syslinux derivative, which boots from a Linux +EXTLINUX is a new Syslinux derivative, which boots from a Linux ext2/ext3 filesystem. -It works the same way as SYSLINUX, with a few slight modifications. +It works the same way as SYSLINUX (see doc/syslinux.txt), with a few +slight modifications. 1. The installer is run on a *mounted* filesystem. Run the extlinux installer on the directory in which you want extlinux installed: @@ -53,7 +54,7 @@ It works the same way as SYSLINUX, with a few slight modifications. extlinux --once 'command' /boot/extlinux - where 'command' is any command you could enter at the SYSLINUX + where 'command' is any command you could enter at the Syslinux command line. It will be executed on the next boot and then erased. @@ -78,7 +79,7 @@ It works the same way as SYSLINUX, with a few slight modifications. Note that EXTLINUX installs in the filesystem partition like a well-behaved bootloader :) Thus, it needs a master boot record in the -partition table; the mbr.bin shipped with SYSLINUX should work well. +partition table; the mbr.bin shipped with Syslinux should work well. To install it just do: cat mbr.bin > /dev/XXX @@ -112,11 +113,11 @@ extlinux. The "sync" command does not flush the log on the ext3 filesystem. -The SYSLINUX series boot loaders support chain loading other operating -systems via a separate module, chain.c32 (located in +The Syslinux Project boot loaders support chain loading other +operating systems via a separate module, chain.c32 (located in com32/modules/chain.c32). To use it, specify a LABEL in the -configuration file with KERNEL chain.c32 and -APPEND [hd|fd] [] +configuration file with KERNEL chain.c32 and APPEND [hd|fd] +[] For example: @@ -127,4 +128,5 @@ LABEL cement KERNEL chain.c32 APPEND hd0 2 -See also README.menu. +See also doc/menu.txt. + diff --git a/doc/keytab-lilo.txt b/doc/keytab-lilo.txt index df9a1d9..cdbea0f 100644 --- a/doc/keytab-lilo.txt +++ b/doc/keytab-lilo.txt @@ -13,7 +13,7 @@ author may not be used to endorse or promote products derived from this software without specific prior written permission. This work is provided "as is" and without any express or implied warranties. -To use a LILO keyboard table with SYSLINUX, specify the KBDMAP command +To use a LILO keyboard table with Syslinux, specify the KBDMAP command in syslinux.cfg, for example: kbdmap de.ktl diff --git a/doc/mboot.txt b/doc/mboot.txt index 5b4c1f3..ef00ca5 100644 --- a/doc/mboot.txt +++ b/doc/mboot.txt @@ -2,12 +2,12 @@ mboot.c32 --------- -mboot.c32 is a 32-bit comboot module that allows SYSLINUX and its +mboot.c32 is a 32-bit comboot module that allows Syslinux and its variants to load and boot kernels that use the Multiboot standard (e.g. the Xen virtual machine monitor, and the Fiasco and GNU Mach microkernels). -To load a multiboot kernel and modules in SYSLINUX, put mboot.c32 (from +To load a multiboot kernel and modules in Syslinux, put mboot.c32 (from com32/modules) in the boot directory, and load it as the "kernel" in the configuration file. The command-line to pass to mboot.c32 is the kernel command-line, followed by all the module command lines, separated with @@ -21,6 +21,6 @@ LABEL Xen KERNEL mboot.c32 APPEND xen.gz dom0_mem=15000 nosmp noacpi --- linux.gz console=tty0 root=/dev/hda1 --- initrd.img -mboot.c32 requires version 2.12 or later of SYSLINUX. +mboot.c32 requires version 2.12 or later of Syslinux. Tim Deegan, May 2005 diff --git a/doc/memdisk.txt b/doc/memdisk.txt index 6c994f9..79d7640 100644 --- a/doc/memdisk.txt +++ b/doc/memdisk.txt @@ -9,7 +9,7 @@ disk and a (very small - 2K typical) chunk of low (DOS) memory for the driver itself, then hooking the INT 13h (disk driver) and INT 15h (memory query) BIOS interrupts. -To use it, type on the SYSLINUX command line: +To use it, type on the Syslinux command line: memdisk initrd=diskimg.img diff --git a/doc/menu.txt b/doc/menu.txt index aa161bc..a03c72a 100644 --- a/doc/menu.txt +++ b/doc/menu.txt @@ -1,4 +1,4 @@ -There are two menu systems included with SYSLINUX, the advanced menu +There are two menu systems included with Syslinux, the advanced menu system, and the simple menu system. @@ -20,7 +20,7 @@ See menu/README for more information. The simple menu system is a single module located at com32/modules/vesamenu.c32 (graphical) or com32/modules/menu.c32 (text mode only). It uses the same configuration file as the regular -SYSLINUX command line, and displays all the LABEL statements. +Syslinux command line, and displays all the LABEL statements. To use the menu system, simply make sure [vesa]menu.c32 is in the appropriate location for your boot medium (the same directory as the @@ -33,7 +33,7 @@ PROMPT 0 There are a few menu additions to the command line, all starting with -the keywords MENU or TEXT; like the rest of the SYSLINUX config file +the keywords MENU or TEXT; like the rest of the Syslinux config file language, it is case insensitive: MENU TITLE title @@ -168,7 +168,7 @@ MENU PASSWD passwd Use the included Perl scripts "sha1pass" or "md5pass" to encrypt passwords. MD5 passwords are compatible with most Unix password file utilities; SHA-1 passwords are probably - unique to SYSLINUX. Obviously, if you don't encrypt your + unique to Syslinux. Obviously, if you don't encrypt your passwords they will not be very secure at all. If you are using passwords, you want to make sure you also use @@ -433,7 +433,7 @@ it will execute the ONTIMEOUT command if one exists, otherwise it will pick the default menu option. Normally, the user can press [Tab] to edit the menu entry, and [Esc] -to return to the SYSLINUX command line. However, if the configuration +to return to the Syslinux command line. However, if the configuration file specifies ALLOWOPTIONS 0, these keys will be disabled, and if MENU MASTER PASSWD is set, they require the master password. diff --git a/doc/pxelinux.txt b/doc/pxelinux.txt index 6658fa5..8d0792f 100644 --- a/doc/pxelinux.txt +++ b/doc/pxelinux.txt @@ -11,7 +11,7 @@ program. Please see the included file COPYING for details. ---------------------------------------------------------------------- -PXELINUX is a SYSLINUX derivative, for booting Linux off a network +PXELINUX is a Syslinux derivative, for booting Linux off a network server, using a network ROM conforming to the Intel PXE (Pre-Execution Environment) specification. PXELINUX is *not* a program that is intended to be flashed or burned into a PROM on the network card; if @@ -29,7 +29,7 @@ explains the differences. On the TFTP server, create the directory "/tftpboot", and copy the following files to it: - pxelinux.0 - from the SYSLINUX distribution + pxelinux.0 - from the Syslinux distribution any kernel or initrd images you want to boot @@ -345,7 +345,7 @@ IP address::filename (e.g. 192.0.2.1::filename) :: was chosen because it is unlikely to conflict with operating system usage. However, if you happen to have an environment for which the -special treatment of :: is a problem, please contact the SYSLINUX +special treatment of :: is a problem, please contact the Syslinux mailing list. @@ -412,5 +412,5 @@ The following problems are known with PXELINUX, so far: entry loop, so that we answer ARP requests. + Boot sectors/disk images are not supported yet. -If you have additional problems, please contact the SYSLINUX mailing +If you have additional problems, please contact the Syslinux mailing list (see syslinux.txt for the address.) diff --git a/doc/sdi.txt b/doc/sdi.txt index f727974..cf9b73f 100644 --- a/doc/sdi.txt +++ b/doc/sdi.txt @@ -1,7 +1,7 @@ SDI files -PXELINUX, ISOLINUX and SYSLINUX support SDI files ( *.sdi ). +Syslinux supports SDI files ( *.sdi ). Features: * Support for gzipped SDI images diff --git a/doc/syslinux.txt b/doc/syslinux.txt index dd7608e..285be8b 100644 --- a/doc/syslinux.txt +++ b/doc/syslinux.txt @@ -1,4 +1,4 @@ - SYSLINUX + The Syslinux Project A suite of bootloaders for Linux @@ -11,11 +11,11 @@ program. Please see the included file COPYING for details. ---------------------------------------------------------------------- - SYSLINUX now has a home page at http://syslinux.zytor.com/ + Syslinux now has a home page at http://syslinux.zytor.com/ ---------------------------------------------------------------------- -The SYSLINUX suite contains the following boot loaders +The Syslinux suite contains the following boot loaders ("derivatives"), for their respective boot media: SYSLINUX - MS-DOS/Windows FAT filesystem @@ -24,8 +24,10 @@ The SYSLINUX suite contains the following boot loaders EXTLINUX - Linux ext2/ext3 filesystem For historical reasons, some of the sections in this document applies -to the FAT loader only; see pxelinux.txt, isolinux.txt and -extlinux.txt for what differs in these versions. +to the FAT loader (SYSLINUX) only; see pxelinux.txt, isolinux.txt and +extlinux.txt for what differs in these versions. The all-caps term +"SYSLINUX" generally refers to the FAT loader, whereas "Syslinux" +refers to the project as a whole. Help with cleaning up the docs would be greatly appreciated. @@ -86,12 +88,12 @@ specific partition active. On boot time, by default, the kernel will be loaded from the image named LINUX on the boot floppy. This default can be changed, see the section -on the SYSLINUX config file. +on the Syslinux config file. If the Shift or Alt keys are held down during boot, or the Caps or Scroll -locks are set, SYSLINUX will display a LILO-style "boot:" prompt. The +locks are set, Syslinux will display a LILO-style "boot:" prompt. The user can then type a kernel file name followed by any kernel parameters. -The SYSLINUX loader does not need to know about the kernel file in +The Syslinux loader does not need to know about the kernel file in advance; all that is required is that it is a file located in the root directory on the disk. @@ -130,14 +132,14 @@ INCLUDE filename will be supported in the future. DEFAULT kernel options... - Sets the default command line. If SYSLINUX boots automatically, + Sets the default command line. If Syslinux boots automatically, it will act just as if the entries after DEFAULT had been typed in at the "boot:" prompt. If no configuration file is present, or no DEFAULT entry is present in the config file, the default is "linux auto". - NOTE: Earlier versions of SYSLINUX used to automatically + NOTE: Earlier versions of Syslinux used to automatically append the string "auto" to whatever the user specified using the DEFAULT command. As of version 1.54, this is no longer true, as it caused problems when using a shell as a substitute @@ -183,7 +185,7 @@ LABEL label APPEND options... IPAPPEND flag_val [PXELINUX only] Indicates that if "label" is entered as the kernel to boot, - SYSLINUX should instead boot "image", and the specified APPEND + Syslinux should instead boot "image", and the specified APPEND and IPAPPEND options should be used instead of the ones specified in the global section of the file (before the first LABEL command.) The default for "image" is the same as @@ -198,7 +200,7 @@ LABEL label label = mylabel append = "myoptions" - ... whereas SYSLINUX uses the syntax: + ... whereas Syslinux uses the syntax: label mylabel kernel mykernel append myoptions @@ -307,7 +309,7 @@ ONERROR kernel options... foo bar baz - ... SYSLINUX will execute the following as if entered by the + ... Syslinux will execute the following as if entered by the user: xyzzy plugh foo bar baz @@ -361,7 +363,7 @@ CONSOLE flag_val FONT filename Load a font in .psf format before displaying any output (except the copyright line, which is output as ldlinux.sys - itself is loaded.) SYSLINUX only loads the font onto the + itself is loaded.) Syslinux only loads the font onto the video card; if the .psf file contains a Unicode table it is ignored. This only works on EGA and VGA cards; hopefully it should do nothing on others. @@ -425,7 +427,7 @@ Blank lines are ignored. Note that the configuration file is not completely decoded. Syntax different from the one described above may still work correctly in this -version of SYSLINUX, but may break in a future one. +version of Syslinux, but may break in a future one. ++++ DISPLAY FILE FORMAT ++++ @@ -474,7 +476,7 @@ are interpreted: Color indicies 0 and 7, in particular, should be chosen with care: 0 is the background color, and 7 is the color used for - the text printed by SYSLINUX itself. + the text printed by Syslinux itself. = = ASCII 25 If we are currently in graphics mode, return to text mode. @@ -517,7 +519,7 @@ The command line prompt supports the following keystrokes: boot specified command line erase one character erase the whole line - display the current SYSLINUX version + display the current Syslinux version erase one word force text mode .. help screens (if configured) @@ -528,7 +530,7 @@ The command line prompt supports the following keystrokes: ++++ COMBOOT IMAGES AND OTHER OPERATING SYSTEMS ++++ -This version of SYSLINUX supports chain loading of other operating +This version of Syslinux supports chain loading of other operating systems (such as MS-DOS and its derivatives, including Windows 95/98), as well as COMBOOT-style standalone executables (a subset of DOS .COM files; see separate section below.) @@ -536,7 +538,7 @@ files; see separate section below.) Chain loading requires the boot sector of the foreign operating system to be stored in a file in the root directory of the filesystem. Because neither Linux kernels, boot sector images, nor COMBOOT files -have reliable magic numbers, SYSLINUX will look at the file extension. +have reliable magic numbers, Syslinux will look at the file extension. The following extensions are recognized (case insensitive): none or other Linux kernel image @@ -549,7 +551,7 @@ The following extensions are recognized (case insensitive): .com COMBOOT image (runnable from DOS) .img Disk image [ISOLINUX only] -For filenames given on the command line, SYSLINUX will search for the +For filenames given on the command line, Syslinux will search for the file by adding extensions in the order listed above if the plain filename is not found. Filenames in KERNEL statements must be fully qualified. @@ -607,7 +609,7 @@ appropriate drive designator. ---- DOS/Windows procedure ---- To make this installation in DOS only, you need the utility copybs.com -(included with SYSLINUX) as well as the syslinux.com installer. If +(included with Syslinux) as well as the syslinux.com installer. If you are on an WinNT-based system (WinNT, Win2k, WinXP or later), use syslinux.exe instead. @@ -637,7 +639,7 @@ syslinux.exe instead. ++++ COMBOOT EXECUTABLES ++++ -SYSLINUX supports simple standalone programs, using a file format +Syslinux supports simple standalone programs, using a file format similar to DOS ".com" files. A 32-bit version, called COM32, is also provided. A simple API provides access to a limited set of filesystem and console functions. @@ -648,7 +650,7 @@ programs. ++++ NOVICE PROTECTION ++++ -SYSLINUX will attempt to detect booting on a machine with too little +Syslinux will attempt to detect booting on a machine with too little memory, which means the Linux boot sequence cannot complete. If so, a message is displayed and the boot sequence aborted. Holding down the Ctrl key while booting disables this feature. @@ -725,8 +727,8 @@ A list of problems, and workarounds (if known), is maintained at: ++++ BOOT LOADER IDS USED ++++ The Linux boot protocol supports a "boot loader ID", a single byte -where the upper nybble specifies a boot loader family (3 = SYSLINUX) -and the lower nybble is version or, in the case of SYSLINUX, media: +where the upper nybble specifies a boot loader family (3 = Syslinux) +and the lower nybble is version or, in the case of Syslinux, media: 0x31 (49) = SYSLINUX 0x32 (50) = PXELINUX @@ -739,8 +741,8 @@ In recent versions of Linux, this ID is available as ++++ BUG REPORTS ++++ -I would appreciate hearing of any problems you have with SYSLINUX. I -would also like to hear from you if you have successfully used SYSLINUX, +I would appreciate hearing of any problems you have with Syslinux. I +would also like to hear from you if you have successfully used Syslinux, *especially* if you are using it for a distribution. If you are reporting problems, please include all possible information @@ -748,7 +750,7 @@ about your system and your BIOS; the vast majority of all problems reported turn out to be BIOS or hardware bugs, and I need as much information as possible in order to diagnose the problems. -There is a mailing list for discussion among SYSLINUX users and for +There is a mailing list for discussion among Syslinux users and for announcements of new and test versions. To join, or to browse the archive, go to: -- 2.7.4