diff options
authorCheng Cui <cc@FreeBSD.org>2023-11-24 17:03:51 +0000
committerCheng Cui <cc@FreeBSD.org>2023-12-04 17:26:38 +0000
commitba54c352dabab58cc28f8b085caa472ec05cc27a (patch)
parentf3dbb1eab3fb230affb581c1ff19673c49c851f8 (diff)
Handbook - Advanced networking - Improve Diskless Operation with PXE
Summary: PR: 274976 Reviewed by: carlavilla Test Plan: see PR 274976 Differential Revision: https://reviews.freebsd.org/D42766
1 files changed, 16 insertions, 1 deletions
diff --git a/documentation/content/en/books/handbook/advanced-networking/_index.adoc b/documentation/content/en/books/handbook/advanced-networking/_index.adoc
index b9194449cd..1a6e239cf7 100644
--- a/documentation/content/en/books/handbook/advanced-networking/_index.adoc
+++ b/documentation/content/en/books/handbook/advanced-networking/_index.adoc
@@ -1961,6 +1961,12 @@ After the host computer receives this information, it downloads the boot loader
In FreeBSD, the boot loader file is [.filename]#/boot/pxeboot#.
After [.filename]#/boot/pxeboot# executes, the FreeBSD kernel is loaded and the rest of the FreeBSD bootup sequence proceeds, as described in crossref:boot[boot,The FreeBSD Booting Process].
+For UEFI PXE based boot, the actual boot loader file to use is [.filename]#/boot/loader.efi#.
+See the below section crossref:advanced-networking[_debugging_pxe_problems,Debugging PXE Problems] on how to use [.filename]#/boot/loader.efi#.
This section describes how to configure these services on a FreeBSD system so that other systems can PXE boot into FreeBSD.
Refer to man:diskless[8] for more information.
@@ -2025,11 +2031,12 @@ inetd_enable="YES"
-tftp dgram udp wait root /usr/libexec/tftpd tftpd -l -s /b/tftpboot
+tftp dgram udp wait root /usr/libexec/tftpd tftpd blocksize 1468 -l -s /b/tftpboot
+The specified tftp blocksize, e.g. 1468 bytes, replaces the default size 512 bytes.
Some PXE versions require the TCP version of TFTP.
In this case, uncomment the second `tftp` line which contains `stream tcp`.
@@ -2180,6 +2187,14 @@ The `BUGS` sections in man:tftpd[8] and man:tftp[1] document some limitations wi
# mount -t nfs /mnt
+. For UEFI PXE based booting, replace the [.filename]#boot/pxeboot# file with the [.filename]#boot/loader.efi# file:
+# chroot ${NFSROOTDIR}
+# mv boot/pxeboot boot/pxeboot.original
+# cp boot/loader.efi boot/pxeboot