IPXE - Revision history

SebastianRoth: /* Compile */

2021-11-14T21:46:38Z

‎Compile

SebastianRoth: /* Prerequisites */

2018-09-10T20:19:45Z

‎Prerequisites

SebastianRoth: /* rom-o-matic.eu */

2016-04-26T20:49:19Z

‎rom-o-matic.eu

SebastianRoth: /* rom-o-matic.eu */

2016-04-22T22:37:17Z

‎rom-o-matic.eu

SebastianRoth: /* rom-o-matic.eu */

2016-04-22T22:35:42Z

‎rom-o-matic.eu

SebastianRoth: /* rom-o-matic.eu */

2016-04-21T06:20:24Z

‎rom-o-matic.eu

SebastianRoth at 05:54, 21 April 2016

2016-04-21T05:54:29Z

SebastianRoth: /* Compile */

2015-11-13T19:15:06Z

‎Compile

SebastianRoth: /* Compile */

2015-11-13T18:47:38Z

‎Compile

SebastianRoth at 18:09, 13 November 2015

2015-11-13T18:09:24Z

@@ Line 106: / Line 106: @@
 ==Compile==
-FOG is using the most current iPXE source code to build many different PXE binaries, some being undionly and others specific for NICs made by intel or realtek - BIOS and UEFI compatible. But still you might want to build your own binary to suit your needs (be it a custom script or debugging enabled). Here you'll find some hints on how to build your own iPXE binary.
+Moved to the official docs, see here: https://docs.fogproject.org/en/latest/reference/compile_ipxe_binaries.html
 == rom-o-matic.eu ==

@@ Line 121: / Line 121: @@
   cd ipxe-bios/src/config
   rm console.h general.h settings.h
-  wget -O console.h "http://sourceforge.net/p/freeghost/code/HEAD/tree/trunk/src/ipxe/src/config/console.h?format=raw"
+  wget -O console.h "https://github.com/FOGProject/fogproject/raw/master/src/ipxe/src/config/console.h"
-  wget -O general.h "http://sourceforge.net/p/freeghost/code/HEAD/tree/trunk/src/ipxe/src/config/general.h?format=raw"
+  wget -O general.h "https://github.com/FOGProject/fogproject/raw/master/src/ipxe/src/config/general.h"
-  wget -O settings.h "http://sourceforge.net/p/freeghost/code/HEAD/tree/trunk/src/ipxe/src/config/settings.h?format=raw"
+  wget -O settings.h "https://github.com/FOGProject/fogproject/raw/master/src/ipxe/src/config/settings.h"
   cd ..
-  wget -O ipxescript "http://sourceforge.net/p/freeghost/code/HEAD/tree/trunk/src/ipxe/src/ipxescript?format=raw"
+  wget -O ipxescript "https://github.com/FOGProject/fogproject/raw/master/src/ipxe/src/ipxescript"
   cd ~/projects/ipxe
@@ Line 131: / Line 131: @@
   cd ipxe-efi/src/config
   rm console.h general.h settings.h
-  wget -O console.h "http://sourceforge.net/p/freeghost/code/HEAD/tree/trunk/src/ipxe-efi/src/config/console.h?format=raw"
+  wget -O console.h "https://github.com/FOGProject/fogproject/raw/master/src/ipxe/src-efi/config/console.h"
-  wget -O general.h "http://sourceforge.net/p/freeghost/code/HEAD/tree/trunk/src/ipxe-efi/src/config/general.h?format=raw"
+  wget -O general.h "https://github.com/FOGProject/fogproject/raw/master/src/ipxe/src-efi/config/general.h"
-  wget -O settings.h "http://sourceforge.net/p/freeghost/code/HEAD/tree/trunk/src/ipxe-efi/src/config/settings.h?format=raw"
+  wget -O settings.h "https://github.com/FOGProject/fogproject/raw/master/src/ipxe/src-efi/config/settings.h"
   cd ..
-  wget -O ipxescript "http://sourceforge.net/p/freeghost/code/HEAD/tree/trunk/src/ipxe-efi/src/ipxescript?format=raw"
+  wget -O ipxescript "https://github.com/FOGProject/fogproject/raw/master/src/ipxe/src-efi/ipxescript"
 ===Bake the cake===

@@ Line 180: / Line 180: @@
 Instead of compiling iPXE on your own machine you can use the online service at https://rom-o-matic.eu/ if you don't want to be bothered with installing compiler toolchain.
-Click "Advanced, for experienced users" to get the full options! Then choose an output format (undionly.kpxe would be "PXE bootstrap loader image [keep PXE stack method 1] (.kpxe)" plus NIC type "undionly". See the following listing for options we have included in the official FOG iPXE binaries:
+Click "Advanced, for experienced users" to get the full options! Then choose an output format (undionly.kpxe would be "PXE bootstrap loader image [keep PXE stack method 1] (.kpxe)" plus NIC type "undionly". See the following listing for options we have included in the official FOG iPXE binaries.
 === BIOS ===

← Older revision		Revision as of 22:37, 22 April 2016
Line 280:		Line 280:
	* DHCP timeout parameters (no change)		* DHCP timeout parameters (no change)
	* PXE Boot Server timeout parameters (no change)		* PXE Boot Server timeout parameters (no change)
		+
		+	If you find those settings are causing trouble for you or don't match what you have online then please let us know in the forums!

← Older revision		Revision as of 22:35, 22 April 2016
Line 235:		Line 235:

	=== UEFI ===		=== UEFI ===
−	~~coming soon...~~	+	* ISA options (no change)
		+	* VMware options
		+	** VMWARE_SETTINGS = YES
		+	* PCIAPI options (no change)
		+	* Serial options (no change)
		+	* Timer configuration (no change)
		+	* Network protocols (no change)
		+	* PXE support ('''no change - important!''')
		+	* Download protocols
		+	** DOWNLOAD_PROTO_HTTPS = YES
		+	** DOWNLOAD_PROTO_FTP = YES
		+	** DOWNLOAD_PROTO_NFS = YES
		+	* SAN boot protocols (no change)
		+	* HTTP extensions (no change)
		+	* Wireless Interface Options (no change)
		+	* Name resolution modules (no change)
		+	* Image types
		+	** IMAGE_PNG = YES
		+	* Command-line commands to include
		+	** IWMGMT_CMD = NO
		+	** NSLOOKUP_CMD = YES
		+	** TIME_CMD = YES
		+	** DIGEST_CMD = YES
		+	** LOTEST_CMD = YES
		+	** VLAN_CMD = YES
		+	** PXE_CMD = '''NO'''
		+	** REBOOT_CMD = YES
		+	** POWEROFF_CMD = YES
		+	** IMAGE_TRUST_CMD = YES
		+	** PCI_CMD = YES
		+	** PARAM_CMD = YES
		+	** NEIGHBOUR_CMD = YES
		+	** PING_CMD = YES
		+	** CONSOLE_CMD = YES
		+	** IPSTAT_CMD = YES
		+	* ROM-specific options (no change)
		+	* Virtual network devices (no change)
		+	* Error message tables to include (no change)
		+	* Debugger options (no change)
		+	* USB configuration (no change)
		+	* Console options
		+	** CONSOLE_FRAMEBUFFER = YES
		+	* Branding options (no change)
		+	* DHCP timeout parameters (no change)
		+	* PXE Boot Server timeout parameters (no change)

@@ Line 183: / Line 183: @@
 === BIOS ===
 * Console options
-** CONSOLE_FRAMEBUFFER
+** CONSOLE_FRAMEBUFFER = YES
 === UEFI ===
 coming soon...

← Older revision		Revision as of 05:54, 21 April 2016
Line 176:		Line 176:
	make ... DEBUG=undi		make ... DEBUG=undi
	...		...
		+
		+	== rom-o-matic.eu ==
		+	Instead of compiling iPXE on your own machine you can use the online service at https://rom-o-matic.eu/ if you don't want to be bothered with installing compiler toolchain.
		+
		+	Click "Advanced, for experienced users" to get the full options! Then choose an output format (undionly.kpxe would be "PXE bootstrap loader image [keep PXE stack method 1] (.kpxe)" plus NIC type "undionly". See the following listing for options we have included in the official FOG iPXE binaries:
		+
		+	=== BIOS ===
		+	* Console options
		+	** CONSOLE_FRAMEBUFFER
		+
		+	=== UEFI ===
		+	coming soon...

← Older revision		Revision as of 19:15, 13 November 2015
Line 136:		Line 136:
	cd ..		cd ..
	wget -O ipxescript "http://sourceforge.net/p/freeghost/code/HEAD/tree/trunk/src/ipxe-efi/src/ipxescript?format=raw"		wget -O ipxescript "http://sourceforge.net/p/freeghost/code/HEAD/tree/trunk/src/ipxe-efi/src/ipxescript?format=raw"
		+
		+	===Bake the cake===
		+	Now you are ready to build your (first) binary from source. But how do you do that? One simple call but it can be heavily customized with parameters.
		+
		+	# Build a simple BIOS binaries including an embedded script (executed right when iPXE comes up)
		+	cd ~/projects/ipxe/ipxe-bios/src
		+	make bin/undionly.kpxe EMBED=ipxescript
		+	make bin/ipxe.pxe EMBED=ipxescript
		+	make bin/undionly.kkpxe EMBED=ipxescript
		+	make bin/intel.pxe EMBED=ipxescript
		+	...
		+
		+	# simple 32 bit EFI binaries with embedded script
		+	cd ~/projects/ipxe/ipxe-efi/src
		+	make bin-i386-efi/ipxe.efi EMBED=ipxescript
		+	make bin-i386-efi/snponly.efi EMBED=ipxescript
		+	make bin-i386-efi/intel.efi EMBED=ipxescript
		+	...
		+
		+	# simple 64 bit EFI binaries
		+	cd ~/projects/ipxe/ipxe-efi/src
		+	make bin-x86_64-efi/ipxe.efi EMBED=ipxescript
		+	make bin-x86_64-efi/snponly.efi EMBED=ipxescript
		+	make bin-x86_64-efi/intel.efi EMBED=ipxescript
		+	...
		+
		+	Build whichever binary you want to have. Now we are getting to the interesting part of adding debug output to iPXE to be able to better find issues. Each and every c-file in the iPXE source can be compiled with debug enabled. Here is an example:
		+
		+	make bin/realtek.kpxe EMBED=ipxescript DEBUG=realtek
		+
		+	Most of the native drivers consist of just one source file. Have a look at src/drivers/net to see them - 3c509, bnx2, forcedeth, intel, pcnet32, realtek, rhine and many more.
		+
		+	The most commonly used binaries ipxe.pxe and ipxe.efi include UNDI interface as well as all the native drivers. You can add debugging selectively. Check out the source code. Here are some more examples:
		+
		+	make ... DEBUG=dhcp
		+	make ... DEBUG=device,efi_driver,efi_init,efi_pci,efi_snp
		+	make ... DEBUG=snp,snponly,snpnet,netdevice
		+	make ... DEBUG=intel:4
		+	make ... DEBUG=undi
		+	...

← Older revision		Revision as of 18:47, 13 November 2015
Line 106:		Line 106:

	==Compile==		==Compile==
−	FOG is using the most current iPXE source code to build many different PXE binaries, some being undionly and others specific for NICs made by intel or realtek - BIOS and UEFI compatible. But still you might want to build your own binary to suit your needs (be it a custom script or debugging enabled).	+	FOG is using the most current iPXE source code to build many different PXE binaries, some being undionly and others specific for NICs made by intel or realtek - BIOS and UEFI compatible. But still you might want to build your own binary to suit your needs (be it a custom script or debugging enabled). Here you'll find some hints on how to build your own iPXE binary.
		+
		+	===Prerequisites===
		+	To be able to build iPXE from source you need tools to checkout and compile source code.
		+
		+	debian/ubuntu# sudo apt-get install git build-essential zlib1g-dev binutils-dev
		+	fedora/centos# sudo yum install git gcc gcc-c++ make zlib-devel binutils-devel # this is untested so far as I don't have a system handy
		+
		+	Then checkout the code and download Tom's config header files from FOG SVN. The header files need to be a little different for BIOS and UEFI and therefore I usually checkout the source twice to have one ready for each platform.
		+
		+	mkdir ~/projects/ipxe
		+	cd ~/projects/ipxe
		+	git clone git://git.ipxe.org/ipxe.git ipxe-bios
		+	cd ipxe-bios/src/config
		+	rm console.h general.h settings.h
		+	wget -O console.h "http://sourceforge.net/p/freeghost/code/HEAD/tree/trunk/src/ipxe/src/config/console.h?format=raw"
		+	wget -O general.h "http://sourceforge.net/p/freeghost/code/HEAD/tree/trunk/src/ipxe/src/config/general.h?format=raw"
		+	wget -O settings.h "http://sourceforge.net/p/freeghost/code/HEAD/tree/trunk/src/ipxe/src/config/settings.h?format=raw"
		+	cd ..
		+	wget -O ipxescript "http://sourceforge.net/p/freeghost/code/HEAD/tree/trunk/src/ipxe/src/ipxescript?format=raw"
		+
		+	cd ~/projects/ipxe
		+	git clone git://git.ipxe.org/ipxe.git ipxe-efi
		+	cd ipxe-efi/src/config
		+	rm console.h general.h settings.h
		+	wget -O console.h "http://sourceforge.net/p/freeghost/code/HEAD/tree/trunk/src/ipxe-efi/src/config/console.h?format=raw"
		+	wget -O general.h "http://sourceforge.net/p/freeghost/code/HEAD/tree/trunk/src/ipxe-efi/src/config/general.h?format=raw"
		+	wget -O settings.h "http://sourceforge.net/p/freeghost/code/HEAD/tree/trunk/src/ipxe-efi/src/config/settings.h?format=raw"
		+	cd ..
		+	wget -O ipxescript "http://sourceforge.net/p/freeghost/code/HEAD/tree/trunk/src/ipxe-efi/src/ipxescript?format=raw"

← Older revision		Revision as of 18:09, 13 November 2015
Line 102:		Line 102:
	===More information on Spanning Tree Protocol===		===More information on Spanning Tree Protocol===
	http://en.wikipedia.org/wiki/Spanning_Tree_Protocol#Multiple_Spanning_Tree_Protocol		http://en.wikipedia.org/wiki/Spanning_Tree_Protocol#Multiple_Spanning_Tree_Protocol
		+
		+
		+
		+	==Compile==
		+	FOG is using the most current iPXE source code to build many different PXE binaries, some being undionly and others specific for NICs made by intel or realtek - BIOS and UEFI compatible. But still you might want to build your own binary to suit your needs (be it a custom script or debugging enabled).