2 .\" SPDX-License-Identifier: BSD-2-Clause-FreeBSD
4 .\" Copyright (c) 2018 Mateusz Piotrowski <0mp@FreeBSD.org>
6 .\" Redistribution and use in source and binary forms, with or without
7 .\" modification, are permitted provided that the following conditions
9 .\" 1. Redistributions of source code must retain the above copyright
10 .\" notice, this list of conditions and the following disclaimer.
11 .\" 2. Redistributions in binary form must reproduce the above copyright
12 .\" notice, this list of conditions and the following disclaimer in the
13 .\" documentation and/or other materials provided with the distribution.
15 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
16 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
17 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
18 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
19 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
20 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
21 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
22 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
23 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
24 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
33 .Nd "install a boot environment using the current FreeBSD source tree"
39 installs a boot environment using the current
43 also automatically performs
53 automatically in the new boot environment sandbox.
55 Upon successful completion, the system will be ready to boot into the new boot
57 Upon failure, the target boot environment will be destroyed.
58 In all cases, the running system is left untouched
59 and a reboot into a partially updated system
60 (due to install or hardware failure) cannot happen.
61 Additionally, the full installation process requires
62 only one reboot as it is performed
63 in a new boot environment.
66 requires a fully built world and kernel.
71 which are not present in the base system and have to be installed manually.
77 are world and kernel flags like
82 User modifiable variables.
83 Set these in the environment if desired:
84 .Bl -tag -width indent
85 .It Ev CONFIG_UPDATER Pq default: Dq Li "etcupdate"
91 Set to an empty string to skip.
92 .It Ev ETCUPDATE_FLAGS Pq default: Dq Li "-F"
96 .It Ev MERGEMASTER_FLAGS Pq default: Dq Li "-iFU"
100 .It Ev NO_PKG_UPGRADE Pq default: Dq Li ""
106 .Bl -tag -width indent
107 .It Sy src/ Ns Pa tools/build/beinstall.sh
110 lives in the src tree.
121 is inspired by and similar in function to
122 Solaris/illumos-style upgrades.
126 manual page first appeared in
131 script was implemented by
132 .An Will Andrews Aq Mt will@FreeBSD.org .
133 This manual page was written by
134 .An Mateusz Piotrowski Aq Mt 0mp@FreeBSD.org .