git: ba54c352da - main - Handbook - Advanced networking - Improve Diskless Operation with PXE

From: Cheng Cui <>
Date: Mon, 04 Dec 2023 22:26:52 UTC
The branch main has been updated by cc:


commit ba54c352dabab58cc28f8b085caa472ec05cc27a
Author:     Cheng Cui <>
AuthorDate: 2023-11-24 17:03:51 +0000
Commit:     Cheng Cui <>
CommitDate: 2023-12-04 17:26:38 +0000

    Handbook - Advanced networking - Improve Diskless Operation with PXE
    Summary: PR:            274976
    Reviewed by: carlavilla
    Test Plan: see PR 274976
    Differential Revision:
 .../en/books/handbook/advanced-networking/_index.adoc   | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

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