Lines Matching +full:build +full:- +full:in

4 .\" Redistribution and use in source and binary forms, with or without
9 .\" 2. Redistributions in binary form must reproduce the above copyright
10 .\"    notice, this list of conditions and the following disclaimer in the
16 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE
20 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
33 provides a complete build environment suitable for users to make
37 All of the tools necessary to build a release are available from the
39 source code repository in
42 including the creation of ISO images suitable for burning to CD-ROM,
48 build environment, with no local modifications to the source tree or to
59 Before attempting to build a release, the user is expected to be
61 .Xr build 7 ,
64 The release build process requires that
77 If the target release build is for a different architecture or machine type,
89 (memory disk) device driver be present in the kernel
90 .Pq either by being compiled in or available as a module .
97 are produced in a clean environment to
130 environment and places the result in
136 .Bl -tag -width Ev
143 tuning of the build chroot.
167 The target machine type for cross-building a release.
169 The target machine architecture for cross-building a release.
177 as documented in
178 .Xr build 7 .
189 to use for the release build.
196 to use for the release build.
212 .Pq Ar -j
213 to the number of CPUs available on a SMP-capable system.
223 .Pq Ar -j
224 to half the number of CPUs available on a SMP-capable system.
226 Set to a non-empty value to skip the
235 Set to a non-empty value to include the
239 Set to a non-empty value to compress the release images with
265 build environment setup are skipped.
270 Set to a non-empty value to prevent checkout or update of
278 Set to a non-empty value to prevent checkout or update of
290 .Bl -tag -width Ev
292 Set to a non-null value to enable functionality for embedded device
303 When the build environment is created,
305 runs a separate build script located in an architecture-specific
306 directory in
318 to cross build the target userland.
325 to cross build the target userland.
331 .Bl -tag -width Ev
333 Set to a non-null value to build virtual machine disk images as part
334 of the release build.
339 Set to a non-null value to compress the virtual machine disk images with
368 Set to specify which of the filesystem(s) listed in
370 is linked to the historical non-filesystem-labelled file name.
378 Set to specify the list of file system types to build images for.
402 .Bd -literal -offset indent
404 make -C release list-vmtargets
409 release build tools support building virtual machine images for various
416 .Bl -tag -width Ev
418 Set to a list of one or more cloud hosting providers, enclosed in quotes.
423 Set to a non-empty value to enable building virtual machine images
436 and used in conjunction with
442 .Bd -literal -offset indent
444 make -C release list-cloudware
449 release build tools have experimental support for building
454 .Bl -tag -width Ev
456 Set to a non-null value to build OCI base images.
468 .Bl -tag -width ".Cm packagesystem"
470 Meta-target to build all release media and distributions applicable to this
476 Builds installation CD-ROM images.
479 (memory disk) device driver be present in the kernel
480 (either by being compiled in or available as a module).
487 Builds installation DVD-ROM images.
490 (memory disk) device driver be present in the kernel
491 (either by being compiled in or available as a module).
502 device driver be present in the kernel
503 .Pq either by being compiled in or available as a module .
504 .It Cm mini-memstick
512 containing the distribution files used in network installations
514 .It Cm vm-image
515 Creates virtual machine disk images in various formats.
517 .Cm vm-image
521 environment variable to be set to a non-null value.
522 .It Cm vm-cloudware
529 .It Cm list-cloudware
533 .It Cm list-vmtargets
542 .Bl -tag -width ".Cm packagesystem"
569 .Bl -tag -width ".Ev TARGET_ARCH"
574 .Pq e.g., FreeBSD-12.1-RELEASE-amd64 .
576 .Ic `uname -s`-`uname -r`-`uname -p`
587 If it is unset or cannot be found, ports will not be included in the release.
591 If set, do not include system source code in the release.
597 This is necessary to cross-build some target architectures.
598 For example, cross-building for ARM64 machines requires
610 Set this to cross-build for a different architecture.
615 is also set, in which case it defaults to the appropriate
621 .Bl -tag -compact -width Pa
637 The following sequence of commands can be used to build a
638 .Dq "-CURRENT snapshot":
639 .Bd -literal -offset indent
641 git clone -b main https://git.freebsd.org/src.git src
647 make install DESTDIR=/var/freebsd-snapshot
651 for FTP, CD-ROM images, etc.) are available in the
652 .Pa /var/freebsd-snapshot
655 The following sequence of commands can be used to build a
656 .Dq "-CURRENT snapshot"
658 .Bd -literal -offset indent
663 Optionally, a configuration file can be used to customize the release build:
664 .Bd -literal -offset indent
666 sh release.sh -c $HOME/release.conf
670 the Raspberry Pi, exist in the directory corresponding to the
674 For example, to build an image for the Raspberry Pi:
675 .Bd -literal -offset indent
677 sh release.sh -c arm/RPI-B.conf
680 To build an image for the Raspberry Pi 3:
681 .Bd -literal -offset indent
683 sh release.sh -c arm64/RPI3.conf
686 After running these commands, all prepared release files are available in the
691 variable in
694 The reldoc target was removed in commit f61e92ca5a23, and
710 .Xr build 7 ,
717 .%U https://docs.freebsd.org/en/articles/freebsd-releng/
721 .%U https://docs.freebsd.org/en/books/developers-handbook/
738 of building a release in a sterile environment.
745 .Pa src/release/generate-release.sh
752 was introduced to support per-build configuration files.
755 .Pa src/release/generate-release.sh
767 .An -nosplit
771 .An Poul-Henning Kamp .
779 .Fa generate-release.sh