|author||H. Peter Anvin <email@example.com>||2008-03-26 16:25:35 -0700|
|committer||H. Peter Anvin <firstname.lastname@example.org>||2008-03-26 16:25:35 -0700|
Add gPXE into the source tree; build unified imagesyslinux-3.70-pre7
Diffstat (limited to 'gpxe/README')
1 files changed, 53 insertions, 0 deletions
diff --git a/gpxe/README b/gpxe/README
new file mode 100644
@@ -0,0 +1,53 @@
+gPXE README File
+gPXE is an implementation of the PXE specification for network
+booting, with extensions to allow additional features such as booting
+via HTTP, iSCSI, and AoE.
+In generally, gPXE is compatible with the industry-standard PXE
+specification, and also supports Etherboot .nbi file loading and some
+additional protocols and features.
+For more detailed information about gPXE, please visit our project
+website at: http://etherboot.org/
+BUILDING gPXE IMAGE FROM SOURCE
+If you don't want to install development tools, and have access to the
+Web, you can get gPXE and Etherboot ROM images made on demand from
+If you would like to compile gPXE images from source, here are some tips.
+We normally compile gPXE images on x86, 32-bit Linux machines. It is
+possible to also use x86-64 machines. We use gcc compiler options to
+create 32-bit output.
+It is important to have the necessary software packages installed. A gcc-based
+toolchain is required.
+The following packages (at least) are required:
+ - a gcc tool chain (gcc 3.x or gcc 4.x)
+ - binutils
+ - perl
+ - syslinux
+ - mtools
+To test your environment, cd to the "src" directory and type:
+You should see a lot of output, and when it stops, the "bin" directory
+should be populated with gPXE images and object files.
+To learn more about what to build and how to use gPXE, please visit our
+project website at http://etherboot.org/ , particularly the "howto" section.
+Pointers to our project mailing lists are on http://etherboot.org/
+Real-time help is often available on IRC on the #etherboot channel of