Lines Matching +full:sets +full:- +full:of +full:- +full:ports
2 .\" SPDX-License-Identifier: BSD-2-Clause
10 .\" 1. Redistributions of source code must retain the above copyright
11 .\" notice, this list of conditions and the following disclaimer.
13 .\" notice, this list of conditions and the following disclaimer in the
18 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
37 full releases of the
40 All of the tools necessary to build a release are available from the
45 including the creation of ISO images suitable for burning to CD-ROM,
53 and with clean checkouts of specific versions of the doc, src, and ports
63 familiar with the contents of
69 be populated with the output of
96 assurance, or other aspects of the release engineering process.
98 Official releases of
101 ensure consistency between the versions of the src, ports, and doc trees
117 .Li ports/ ,
139 .Bl -tag -width Ev
148 tuning of the build chroot.
167 .Li ports/
172 The target machine type for cross-building a release.
174 The target machine architecture for cross-building a release.
176 For the supported list of
180 combinations, consult the output of
214 Defaults to setting the number of
217 .Pq Ar -j
218 to the number of CPUs available on a SMP-capable system.
225 Defaults to setting the number of
228 .Pq Ar -j
229 to half the number of CPUs available on a SMP-capable system.
231 Set to a non-empty value to skip the
232 .Li ports/
237 .Fa ports.txz
240 Set to a non-empty value to include the
244 Set to a non-empty value to compress the release images with
250 Set to the number of threads
268 stages of the
275 Set to a non-empty value to prevent checkout or update of
283 Set to a non-empty value to prevent checkout or update of
284 .Fa /usr/ports
288 .Fa /usr/ports
291 Include legacy tarball distribution sets for use on the install media,
292 instead of base system packages.
296 executable to use when installing packages in release images as a non-root user.
302 images as a non-root user.
304 The name of the repository configuration to use when installing packages in
305 release images as a non-root user.
311 .Bl -tag -width Ev
313 Set to a non-null value to enable functionality for embedded device
326 runs a separate build script located in an architecture-specific
330 Set to the list of any ports that are required for the target device
331 in the format of
338 .Pq value of Cm uname Fl m
345 .Pq value of Cm uname Fl p
352 .Bl -tag -width Ev
354 Set to a non-null value to build virtual machine disk images as part
360 Set to a non-null value to compress the virtual machine disk images with
362 as part of the
369 Set to change the name of the resulting virtual machine disk image file.
373 Set to change the size of the virtual machine disk capacity.
385 compress to roughly the same size, regardless of the specified disk image
389 Set to specify which of the filesystem(s) listed in
391 is linked to the historical non-filesystem-labelled file name.
399 Set to specify the list of file system types to build images for.
400 Valid values are one or both of
418 For a list of supported
423 .Bd -literal -offset indent
425 make -C release list-vmtargets
437 .Bl -tag -width Ev
439 Set to a list of one or more cloud hosting providers, enclosed in quotes.
444 Set to a non-empty value to enable building virtual machine images
460 For a list of supported
463 .Bd -literal -offset indent
465 make -C release list-cloudware
475 .Bl -tag -width Ev
477 Set to a non-null value to build OCI base images.
488 .\" XXX: Some sort of introduction to this list? All the others have one.
489 .Bl -tag -width ".Cm packagesystem"
491 Meta-target to build all release media and distributions applicable to this
497 Builds installation CD-ROM images.
508 Builds installation DVD-ROM images.
525 .It Cm mini-memstick
528 with the exception that the installation distribution sets
535 .It Cm vm-image
538 .Cm vm-image
542 environment variable to be set to a non-null value.
543 .It Cm vm-cloudware
550 .It Cm list-cloudware
551 Displays the list of valid
554 .It Cm list-vmtargets
555 Displays the list of valid
563 .Bl -tag -width ".Cm packagesystem"
566 .Pq base, kernel, ports, doc
590 .Bl -tag -width ".Ev TARGET_ARCH"
595 .Pq e.g., FreeBSD-12.1-RELEASE-amd64 .
596 Defaults to the output of
597 .Ic `uname -s`-`uname -r`-`uname -p`
600 Location of a directory containing the src tree.
605 Location of a directory containing the ports tree.
607 .Pa /usr/ports .
608 If it is unset or cannot be found, ports will not be included in the release.
610 If defined, the Ports Collection will be omitted from the release.
618 This is necessary to cross-build some target architectures.
619 For example, cross-building for ARM64 machines requires
631 Set this to cross-build for a different architecture.
642 .Bl -tag -compact -width Pa
646 .It Pa /usr/ports/Mk/bsd.port.mk
647 .It Pa /usr/ports/Mk/bsd.sites.mk
659 The following sequence of commands can be used to build a
660 .Dq "-CURRENT snapshot":
661 .Bd -literal -offset indent
663 git clone -b main https://git.freebsd.org/src.git src
669 make install DESTDIR=/var/freebsd-snapshot
673 for FTP, CD-ROM images, etc.) are available in the
674 .Pa /var/freebsd-snapshot
677 The following sequence of commands can be used to build a
678 .Dq "-CURRENT snapshot"
679 in a clean environment, including ports and documentation:
680 .Bd -literal -offset indent
686 .Bd -literal -offset indent
688 sh release.sh -c $HOME/release.conf
696 For example, to build an image for 64-bit Raspberry Pis:
697 .Bd -literal -offset indent
699 sh release.sh -c arm64/RPI.conf
719 .Xr git 1 Pq Pa ports/devel/git ,
727 .Xr ports 7 ,
733 .%U https://docs.freebsd.org/en/articles/freebsd-releng/
737 .%U https://docs.freebsd.org/en/books/developers-handbook/
745 Apart from being incomplete, the list put a lot of specific demands on
748 As part of the
753 into a shape where it could at least automate most of the tediousness
761 .Pa src/release/generate-release.sh
762 introduced to support the introduction of a new installer.
768 was introduced to support per-build configuration files.
771 .Pa src/release/generate-release.sh
776 log of
778 contains a vivid historical record of some
783 .An -nosplit
787 .An Poul-Henning Kamp .
795 .Fa generate-release.sh