From nobody Mon Dec 04 22:26:52 2023 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4SkdZ44lDqz52v26 for ; Mon, 4 Dec 2023 22:26:52 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4SkdZ426Kgz4Pvv; Mon, 4 Dec 2023 22:26:52 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1701728812; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=CAJhREo9XLIdOm+qELCajCcjbfO73H54P/eyPopRA6E=; b=absKZYWYMHtWj9JLsyo1bWTwiywTKGu4RN+PMan2ud8xY8+JSMC6O9CrWsWobRWg/zugp8 oE2Q/obdriFvJjiQxsMRF24pnQY77HSfFbYY4q/eXijzG4lKLXK6liRAjSaWYflKMLXRH9 zg+0QGBbVGcAW18rsfCcxQcW0JPPbJth2VZSDzQBQjTYbbYzXo6ReNrOY2Xojd/3HANuLm YgCfv2XZyugogGrZy4K9T33RI5mlGH9/sJKEM4xIJL0oNqi/h8aK1urD8TMQZtavQX+TaF OwL2HoSCS/Rkr1Jq3t6vILEXhGnOFTpf6Hl1aTxeRpAXKG3O6yLzzWDyeSijhg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1701728812; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=CAJhREo9XLIdOm+qELCajCcjbfO73H54P/eyPopRA6E=; b=vn5fK5B9sHs3FLInY4qhrnT3GkAGJYfWy15K18+LL4wZcS3x80n5Vzwx1I1QeAELFyd/bc 8jQ6WRaSi/3Mm0MNmzovZDx5rizpMQ1jLfRq9yeHiOUmnyjUrrRCSN0zwZHhc00BQzsR9/ M1khfI46t+WzGWQP0QwIQDA7egkPP3zzSX+y4dfC8UTdlh8frGEk0awDYDarCQHqYreHqT Ox+3jFdK4gfxfGPlIWtSgPs2UBQZ0+Mt/hW7glQ6E8olo5fHIcooxgGjUssH/Nwdm4+FlV O3nnvDy0PjQl+pC3jqRttlEk9xF4qbnIBNBaS4FHJ4ja6/Ysk55XD53GowtMyg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1701728812; a=rsa-sha256; cv=none; b=L8CnXawgG/M6GPVjHICmZUNfwC41tMxjODJbQPw6YzvxrhGnuqYTyRBduYJ64WfmcARc0w tdlGyTT+suC892z7FKuJESrz86S92ri+EQa8Xtbz8YacXH3Wf6StESXtqiD7U0pL5DLja6 ocpmM66KcsgltEMMcG693UoqmZZKC+jKJRobexxfTkLDkZo8CdqR+/64QHZ1fL7MMwJ5A5 Klzs0kISWmyD030HgkpbXdpDcIpISAWteJqtjeogYEcn5f9OSuFJAzoXt7YYyhacLvmAuC PDLKuOO9oZjC8Fur5Se18hp1sgGKkyDGPSRq7gKvQSV4NmTE1x9Z1+guFAvBEw== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4SkdZ419TzzkJy; Mon, 4 Dec 2023 22:26:52 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.17.1/8.17.1) with ESMTP id 3B4MQqXC096433; Mon, 4 Dec 2023 22:26:52 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.17.1/8.17.1/Submit) id 3B4MQqpD096430; Mon, 4 Dec 2023 22:26:52 GMT (envelope-from git) Date: Mon, 4 Dec 2023 22:26:52 GMT Message-Id: <202312042226.3B4MQqpD096430@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Cheng Cui Subject: git: ba54c352da - main - Handbook - Advanced networking - Improve Diskless Operation with PXE List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: cc X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: ba54c352dabab58cc28f8b085caa472ec05cc27a Auto-Submitted: auto-generated The branch main has been updated by cc: URL: https://cgit.FreeBSD.org/doc/commit/?id=ba54c352dabab58cc28f8b085caa472ec05cc27a 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: https://reviews.freebsd.org/D42766 --- .../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]. +[NOTE] +==== +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" + [.programlisting] .... -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 .... + [NOTE] ==== +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 192.168.0.1:/b/tftpboot/FreeBSD/install /mnt .... ++ +. For UEFI PXE based booting, replace the [.filename]#boot/pxeboot# file with the [.filename]#boot/loader.efi# file: +[source,shell] +.... +# chroot ${NFSROOTDIR} +# mv boot/pxeboot boot/pxeboot.original +# cp boot/loader.efi boot/pxeboot +.... **** [[carp]]