NOTES.txt - gigaboot20x6 - Git at Google


 uefi_call_wrapper()
 -------------------
 gnu-efi provides this macro thing as a workaround for older compilers that
 don't support the right attributes to handle the fact that the EFI calling
 conventions are different than the standard gcc ones.

 If HAVE_USE_MS_ABI is defined (as the Makefile here does) and you have a
 compiler that's not a fairly ancient, everything Just Works(tm) and the
 code is much more readable.


 Intel Visual BIOS (on NUC) and netboot
 --------------------------------------
 This will netboot EFI apps, provided you have a DHCP server which is
 setup to give the BIOS the IP of a tftp server and a filename to grab
 from there.

 You must disable legacy boot for the EFI netboot option to appear.  If
 you check the "keep retrying forever" option, when your app exits, the
 BIOS will try to download it from the tftp server again, making for a
 quick build/download/test cycle


 Making tftpd work on Ubuntu with IPv4
 -------------------------------------
 sudo apt-get install tftpd-hpa

 Optionally make it easy to copy files to the server without sudo:
 sudo chown `who` /var/lib/tftpdboot

 Edit /etc/default/tftpd-hpa so it looks more like:
 TFTP_USERNAME="tftp"
 TFTP_DIRECTORY="/var/lib/tftpboot"
 TFTP_ADDRESS=":69"
 TFTP_OPTIONS="--secure -4 -v -v -v"

 Removing the [::] and adding the -4 make it work reliably on IPv4 for me.
 The several -v's make it chattier in syslog which is handy if you're not
 sure the test machine is actually trying to grab files.

 QEMU Tips
 -------------------------------------
 USB-ETH Adapters:
 - For ASIX chipset usb adapters if you have permission issues copy the udev rules in scripts/ to /etc/udev/rules.d/

 E1000 local networking bridge:
 - You can create a network interface using the Linux tun/tap network device named “qemu” for the
   qemu-e1000 target. Qemu does not need to be run with any special privileges for this, but you need
   to create a persistent tun/tap device ahead of time (which does require you be root):

   sudo apt-get install uml-utilities
   sudo tunctl -u $USER -t qemu
   sudo ifconfig qemu up

	uefi_call_wrapper()
	-------------------
	gnu-efi provides this macro thing as a workaround for older compilers that
	don't support the right attributes to handle the fact that the EFI calling
	conventions are different than the standard gcc ones.

	If HAVE_USE_MS_ABI is defined (as the Makefile here does) and you have a
	compiler that's not a fairly ancient, everything Just Works(tm) and the
	code is much more readable.


	Intel Visual BIOS (on NUC) and netboot
	--------------------------------------
	This will netboot EFI apps, provided you have a DHCP server which is
	setup to give the BIOS the IP of a tftp server and a filename to grab
	from there.

	You must disable legacy boot for the EFI netboot option to appear. If
	you check the "keep retrying forever" option, when your app exits, the
	BIOS will try to download it from the tftp server again, making for a
	quick build/download/test cycle


	Making tftpd work on Ubuntu with IPv4
	-------------------------------------
	sudo apt-get install tftpd-hpa

	Optionally make it easy to copy files to the server without sudo:
	sudo chown `who` /var/lib/tftpdboot

	Edit /etc/default/tftpd-hpa so it looks more like:
	TFTP_USERNAME="tftp"
	TFTP_DIRECTORY="/var/lib/tftpboot"
	TFTP_ADDRESS=":69"
	TFTP_OPTIONS="--secure -4 -v -v -v"

	Removing the [::] and adding the -4 make it work reliably on IPv4 for me.
	The several -v's make it chattier in syslog which is handy if you're not
	sure the test machine is actually trying to grab files.

	QEMU Tips
	-------------------------------------
	USB-ETH Adapters:
	- For ASIX chipset usb adapters if you have permission issues copy the udev rules in scripts/ to /etc/udev/rules.d/

	E1000 local networking bridge:
	- You can create a network interface using the Linux tun/tap network device named “qemu” for the
	qemu-e1000 target. Qemu does not need to be run with any special privileges for this, but you need
	to create a persistent tun/tap device ahead of time (which does require you be root):

	sudo apt-get install uml-utilities
	sudo tunctl -u $USER -t qemu
	sudo ifconfig qemu up