1.\" Copyright (c) 2002 Murray Stokely <murray@FreeBSD.org> 2.\" All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 8 unchanged lines hidden (view full) --- 17.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 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 22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 23.\" SUCH DAMAGE. 24.\" |
25.\" $FreeBSD: head/share/man/man7/release.7 262810 2014-03-05 23:17:53Z gjb $ |
26.\" |
27.Dd March 5, 2014 |
28.Dt RELEASE 7 29.Os 30.Sh NAME 31.Nm release 32.Nd "release building infrastructure" 33.Sh DESCRIPTION 34.Fx 35provides a complete build environment suitable for users to make --- 97 unchanged lines hidden (view full) --- 133.Pa $CHROOTDIR/R . 134.Pp 135The optional 136.Fa release.conf 137configuration file supports the following variables: 138.Bl -tag -width Ev 139.It Va CHROOTDIR 140The directory within which the release will be built. |
141.It Va CHROOT_MAKEENV 142Additional 143.Xr make 1 144arguments to pass through, which directly affect the 145tuning of the build chroot. |
146.It Va SVNROOT 147The 148.Xr svn 1 149host used to check out the various trees. 150Defaults to 151.Pa svn://svn.FreeeBSD.org . 152.It Va SRCBRANCH 153The --- 95 unchanged lines hidden (view full) --- 249.It Va WITH_DVD 250Set to a non-empty value to include the 251.Cm dvdrom 252target. 253.It Va VCSCMD 254The command run to obtain the source trees. 255Defaults to 256.Qq Cm svn checkout . |
257.It Va CHROOTBUILD_SKIP 258If defined, the 259.Li buildworld , 260.Li installworld , 261and 262.Li distribution 263stages of the 264.Xr chroot 8 265build environment setup are skipped. 266This is intended solely for cases where the 267.Xr chroot 8 268userland are provided by alternate means. |
269.El |
270.Sh EMBEDDED BUILDS 271The following 272.Fa release.conf 273variables are relevant only to release builds for embedded systems: 274.Bl -tag -width Ev 275.It Va EMBEDDEDBUILD 276Set to a non-null value to enable functionality for embedded device 277release builds. 278.Pq This option is considered highly experimental. 279.Pp 280When set, 281.Va WITH_DVD 282is unset, and 283.Va NODOC 284is defined. 285Additionally, 286.Va XDEV 287and 288.Va XDEV_ARCH 289must also be defined. 290When the build environment is created, 291.Fa release.sh 292runs a separate build script located in an architecture-specific 293directory in 294.Pa src/release/${XDEV}/ . 295.It Va EMBEDDEDPORTS 296Set to the list of any ports that are required for the target device 297in the format of 298.Fa category/port . 299The 300.Fa devel/subversion 301port is built by default. 302.It Va CROCHETSRC 303Set to the source URL for the Crochet build tool. 304.It Va CROCHETBRANCH 305Set to the subversion branch from 306.Va ${CROCHETSRC} 307to use. 308Defaults to 309.Pa trunk . 310.It Va UBOOTSRC 311Set to the source URL of u-boot, if required. 312.It Va UBOOTBRANCH 313Set to the subversion branch from 314.Va ${UBOOTSRC} 315to use. 316Defaults to 317.Pa trunk . 318.It Va UBOOTDIR 319Set to the target directory within 320.Va ${CHROOTDIR} 321to check out 322.Va ${UBOOTSRC}/${UBOOTBRANCH} . 323.El |
324.Sh MAKEFILE TARGETS 325The release makefile 326.Pq Pa src/release/Makefile 327is fairly abstruse. 328Most developers will only be concerned with the 329.Cm release 330and 331.Cm install --- 294 unchanged lines hidden --- |