mirror of
https://git.freebsd.org/ports.git
synced 2025-07-04 19:09:16 -04:00
c7564382f2
filesystem or disk image. This FreeBSD port can additionally operate on plain files containing a FAT image, thus requiring no special privilege. The program relies on mtools to perform the manipulation of the FAT filesystem. WWW: http://syslinux.zytor.com/
68 lines
2.6 KiB
Groff
68 lines
2.6 KiB
Groff
--- man/syslinux.1 2008-09-26 01:46:02.000000000 +0200
|
|
+++ ../../files/syslinux.1 2008-11-25 15:38:02.000000000 +0100
|
|
@@ -9,20 +9,22 @@
|
|
.I device
|
|
.SH DESCRIPTION
|
|
\fBSyslinux\fP is a boot loader for the Linux operating system which
|
|
-operates off an MS-DOS/Windows FAT filesystem. It is intended to
|
|
+operates off a FAT filesystem. It is intended to
|
|
simplify first-time installation of Linux, and for creation of rescue
|
|
and other special-purpose boot disks.
|
|
.PP
|
|
-In order to create a bootable Linux floppy using \fBSyslinux\fP, prepare a
|
|
-normal MS-DOS formatted floppy. Copy one or more Linux kernel files to
|
|
-it, then execute the command:
|
|
+In order to create a bootable Linux disk using \fBSyslinux\fP, prepare a
|
|
+normal FAT formatted disk (or file image), and
|
|
+execute the command:
|
|
.IP
|
|
.B syslinux /dev/fd0
|
|
.PP
|
|
-This will alter the boot sector on the disk and copy a file named
|
|
-LDLINUX.SYS into its root directory.
|
|
+This will copy a file named LDLINUX.SYS into the root directory of
|
|
+the disk, install a suitable boot code in the boot sector, and patch the
|
|
+boot sector and LDLINUX.SYS (see \fBNOTES\fP).
|
|
.PP
|
|
-On boot time, by default, the kernel will be loaded from the image named
|
|
+On boot time, by default, the boot loader will try to load a linux
|
|
+kernel from the image named
|
|
LINUX on the boot floppy. This default can be changed, see the section
|
|
on the \fBsyslinux\fP configuration file.
|
|
.PP
|
|
@@ -36,6 +38,21 @@
|
|
.PP
|
|
\fBSyslinux\fP supports the loading of initial ramdisks (initrd) and the
|
|
bzImage kernel format.
|
|
+.SH NOTES
|
|
+The boot sector and LDLINUX.SYS rely heavily on the operation of
|
|
+the \fBsyslinux\fP program to run correctly. In particular,
|
|
+\fBsyslinux\fP patches the boot sector with the exact location on
|
|
+the disk of the first sector of LDLINUX.SYS, and also it patches
|
|
+the file LDLINUX.SYS with the exact location on the disk of each
|
|
+additional sector of LDLINUX.SYS itself.
|
|
+.PP
|
|
+This means that if you want to prepare a new bootable disk, it is
|
|
+not enough to duplicate the boot sector and LDLINUX.SYS, but you
|
|
+really need to run \fBsyslinux\fP to update the sectors addresses.
|
|
+.PP
|
|
+The version of \fBsyslinux\fP used on FreeBSD makes use of the
|
|
+\fBmtools\fP port to modify the FAT filesystem.
|
|
+
|
|
.SH OPTIONS
|
|
.TP
|
|
.B \-s
|
|
@@ -380,9 +397,11 @@
|
|
.BR lilo (8),
|
|
.BR keytab-lilo.pl (8),
|
|
.BR fdisk (8),
|
|
-.BR mkfs (8),
|
|
+.BR newfs_msdos (8),
|
|
+.BR mtools (1),
|
|
.BR superformat (1).
|
|
.SH AUTHOR
|
|
This manual page is a modified version of the original \fBsyslinux\fP
|
|
documentation by H. Peter Anvin <hpa@zytor.com>. The conversion to a manpage
|
|
-was made by Arthur Korn <arthur@korn.ch>.
|
|
+was made by Arthur Korn <arthur@korn.ch>. FreeBSD-specific notes
|
|
+added by Luigi Rizzo.
|