Page MenuHomeFreeBSD
Files F152449716

D54079.id174978.diff
No OneTemporary
Actions

D54079.id174978.diff
View Options

diff --git a/share/man/man7/build.7 b/share/man/man7/build.7
--- a/share/man/man7/build.7
+++ b/share/man/man7/build.7
@@ -25,7 +25,7 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd September 25, 2025
+.Dd April 6, 2026
.Dt BUILD 7
.Os
.Sh NAME
@@ -1018,17 +1018,21 @@
.Pp
For major version upgrades, boot into single-user mode.
After restarting, install userspace, and merge configurations.
-After verifying that you do not need them, delete old files
-and libraries:
+After verifying that you do not need them, delete old files:
.Bd -literal -offset indent
cd /usr/src
etcupdate -p
make installworld
etcupdate -B
-make delete-old delete-old-libs
+make delete-old
shutdown -r now
.Ed
-.Ss Example 2: Build and upgrade a custom kernel in place
+.Pp
+After testing the new system and verifying that your applications do not
+depend on them, delete the old libraries:
+.Pp
+.Dl make delete-old-libs
+.Ss Example 2: Build and upgrade a custom kernel
Create a custom kernel configuration,
.Va MYKERNEL ,
by including an existing configuration and using
@@ -1046,7 +1050,7 @@
.Ed
.Pp
After creating the new kernel configuration, build a fresh toolchain,
-build the kernel, and install it, moving the old kernel to
+build the kernel, and install it directly, moving the old kernel to
.Pa /boot/kernel.old/ :
.Bd -literal -offset indent
make kernel-toolchain
@@ -1055,7 +1059,17 @@
shutdown -r now
.Ed
.Pp
-To build the kernel to an alternate location, use the
+To package the kernel into a
+.Xr freebsd-base 7
+package instead of installing it directly, use
+.Cm update-packages
+instead of
+.Cm installkernel :
+.Bd -literal -offset indent
+make buildkernel KERNCONF=MYKERNEL update-packages
+.Ed
+.Pp
+To install the kernel directly to an alternate location, use the
.Va INSTKERNNAME
variable and boot it once to test via
.Xr nextboot 8 :
@@ -1103,21 +1117,21 @@
.Bd -literal -offset indent
cd /usr/src
make TARGET_ARCH=aarch64 buildworld buildkernel
-make TARGET_ARCH=aarch64 DESTDIR=/armclient installworld installkernel
+make TARGET_ARCH=aarch64 DESTDIR=/client installworld installkernel
.Ed
.Pp
Afterwards, to build and install a single piece of userspace, use:
.Bd -literal -offset indent
cd src/bin/ls
make buildenv TARGET_ARCH=aarch64
-make clean all install DESTDIR=/armclient
+make clean all install DESTDIR=/client
.Ed
.Pp
Likewise, to quickly rebuild and reinstall the kernel, use:
.Bd -literal -offset indent
cd src
make buildenv TARGET_ARCH=aarch64
-make kernel KERNFAST=1 DESTDIR=/armclient
+make kernel KERNFAST=1 DESTDIR=/client
.Ed
.Sh DIAGNOSTICS
.Bl -diag

File Metadata

Mime Type
text/plain
Expires
Thu, Apr 16, 1:13 AM (5 h, 53 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
31042101
Default Alt Text
D54079.id174978.diff (2 KB)

Event Timeline