Page MenuHomeFreeBSD
Files F166690927

D34169.id102706.diff
No OneTemporary
Actions

D34169.id102706.diff
View Options

Index: share/man/man5/freebsd-update.conf.5
===================================================================
--- share/man/man5/freebsd-update.conf.5
+++ share/man/man5/freebsd-update.conf.5
@@ -25,7 +25,7 @@
.\"
.\" $FreeBSD$
.\"
-.Dd August 19, 2009
+.Dd February 13, 2022
.Dt FREEBSD-UPDATE.CONF 5
.Os FreeBSD
.Sh NAME
@@ -218,6 +218,58 @@
.Cm freebsd-update
rollback command will recreate the symbol files along with the old
kernel.
+.It Cm CreateBootEnv
+The single parameter following this keyword must be
+.Dq yes
+or
+.Dq no
+and specifies whether
+.Cm freebsd-update
+will create a new boot environment using
+.Xr bectl 8
+when installing patches.
+.Pp
+The name of the new boot environment consists of the current
+.Fx
+kernel version
+and a timestamp
+separated by a single dash, e.g.:
+.Bd -literal -offset indent
+12.0-RELEASE-p10_2019-10-03_185233
+.Ed
+.Pp
+The implementation of the name generation is equivalent to the following
+.Xr sh 1
+one-liner:
+.Bd -literal -offset indent
+$(freebsd-version -k)-$(date +"%Y-%m-%d_%H%M%S")
+.Ed
+.Pp
+.Cm freebsd-update
+does not attempt to create a boot environment
+if any of the following applies:
+.Pp
+.Bl -dash -compact
+.It
+ZFS is not used.
+.It
+The ZFS root is not set up for boot environments
+.Po see the check command of
+.Xr bectl 8
+for details
+.Pc .
+.It
+.Cm freebsd-update
+is running in a
+.Xr jail 8 .
+.It
+.Cm freebsd-update
+is updating a root directory selected via
+the basedir
+.Pq Fl b
+or jail
+.Pq Fl j
+flags.
.El
.Sh FILES
.Bl -tag -width "/etc/freebsd-update.conf"
@@ -228,6 +280,7 @@
.El
.Sh SEE ALSO
.Xr sha256 1 ,
+.Xr bectl 8 ,
.Xr freebsd-update 8
.Sh AUTHORS
.An Colin Percival Aq Mt cperciva@FreeBSD.org

File Metadata

Mime Type
text/plain
Expires
Sun, Aug 16, 3:08 PM (13 h, 12 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
36826795
Default Alt Text
D34169.id102706.diff (1 KB)

Event Timeline