Completing syslinux-udeb package contents.
[syslinux-debian/hramrach.git] / doc / building.txt
blobd0f5068052d6353512fe4f79bda063c2d9d1eca7
1                         Building Syslinux
3 From Syslinux 6.0 onwards there is support for three different
4 firmware backends, BIOS, 32-bit EFI and 64-bit EFI. To allow users the
5 flexibility to build only the firmware they need the Syslinux make
6 infrastructure has become more complex.
8 The Syslinux make infrastructure understands the following syntax,
10         make [firmware[,firwmware]] [target[,target]]
12 If no firmware is specified then any targets will be applied to all
13 three firmware backends. If no target is specified then the 'all'
14 target is implicitly built.
16 For example, to build the installers for BIOS, 32-bit EFI and 64-bit
17 EFI type,
19         make installer
21 TO build the BIOS and 64-bit EFI installers type,
23         make bios efi64 installer
25 To delete all object files and build the installer for 32-bit EFI
26 type,
28         make efi32 spotless installer
31       ++++ THE OBJECT DIRECTORY ++++
33 A custom top-level object directory can be specified on the make
34 command-line by using the O= variable, e.g.
36         make O=/tmp/syslinux-obj efi32
38 will build the 32-bit object files under /tmp/syslinux-obj/efi32. If
39 no object directory is specified then object files will be written to
40 an 'obj' directory in the top-level of the Syslinux source.