share/man/man7/release.7

   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.
   9 .\" 2. Redistributions in binary form must reproduce the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer in the
  11 .\"    documentation and/or other materials provided with the distribution.
  12 .\"
  13 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND
  14 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  15 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  16 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE
  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$
  26 .\"
  27 .Dd May 20, 2021
  28 .Dt RELEASE 7
  29 .Os
  30 .Sh NAME
  31 .Nm release
  32 .Nd "release building infrastructure"
  33 .Sh DESCRIPTION
  34 .Fx
  35 provides a complete build environment suitable for users to make
  36 full releases of the
  37 .Fx
  38 operating system.
  39 All of the tools necessary to build a release are available from the
  40 .Fx
  41 source code repository in
  42 .Pa src/release .
  43 A complete release can be built with only a single command,
  44 including the creation of ISO images suitable for burning to CD-ROM,
  45 memory stick images, and a network install directory.
  46 This command is aptly named
  47 .Dq Li "make release" .
  48 .Pp
  49 For some users, it may be desirable to provide an absolutely clean
  50 build environment, with no local modifications to the source tree or to
  51 .Xr make.conf 5 ,
  52 and with clean checkouts of specific versions of the doc, src, and ports
  53 trees.
  54 For this purpose, a script
  55 .Pq Pa src/release/release.sh
  56 is provided to automate these checkouts and then execute
  57 .Dq Li "make release"
  58 in a clean
  59 .Xr chroot 8 .
  60 .Pp
  61 Before attempting to build a release, the user is expected to be
  62 familiar with the contents of
  63 .Xr build 7 ,
  64 and should have experience upgrading systems from source.
  65 .Pp
  66 The release build process requires that
  67 .Pa /usr/obj
  68 be populated with the output of
  69 .Dq Li "make buildworld"
  70 and
  71 .Dq Li "make buildkernel" .
  72 This is necessary to provide the object files for the release or, when
  73 using
  74 .Pa release.sh ,
  75 so that the object files for a complete system can be installed into a clean
  76 .Xr chroot 8
  77 environment.
  78 .Pp
  79 If the target release build is for a different architecture or machine type,
  80 the
  81 .Va TARGET
  82 and
  83 .Va TARGET_ARCH
  84 variables must be used.
  85 See the supported
  86 .Fa release.conf
  87 variables for more information.
  88 .Pp
  89 The release procedure on some architectures may also require that the
  90 .Xr md 4
  91 (memory disk) device driver be present in the kernel
  92 .Pq either by being compiled in or available as a module .
  93 .Pp
  94 This document does not cover source code management, quality
  95 assurance, or other aspects of the release engineering process.
  96 .Sh CLEAN RELEASE GENERATION
  97 Official releases of
  98 .Fx
  99 are produced in a clean environment to
 100 ensure consistency between the versions of the src, ports, and doc trees
 101 and to avoid contamination from the host system
 102 .Po such as local patches, changes
 103 to
 104 .Xr make.conf 5 ,
 105 etc.
 106 .Pc .
 107 This is accomplished using the wrapper script
 108 .Pa src/release/release.sh .
 109 .Pp
 110 .Ic release.sh
 111 .Op Fl c Ar release.conf
 112 .Pp
 113 .Ic release.sh
 114 checks out the
 115 .Li src/ ,
 116 .Li ports/ ,
 117 and
 118 .Li doc/
 119 trees to
 120 .Va CHROOTDIR ,
 121 then calls
 122 .Dq Li "make buildworld"
 123 and
 124 .Dq Li "make installworld"
 125 to generate a
 126 .Xr chroot 8
 127 environment.
 128 Next,
 129 .Dq Li "make release"
 130 is run within the
 131 .Xr chroot 8
 132 environment and places the result in
 133 .Pa $CHROOTDIR/R .
 134 .Pp
 135 The optional
 136 .Fa release.conf
 137 configuration file supports the following variables:
 138 .Bl -tag -width Ev
 139 .It Va CHROOTDIR
 140 The directory within which the release will be built.
 141 .It Va CHROOT_MAKEENV
 142 Additional
 143 .Xr make 1
 144 arguments to pass through, which directly affect the
 145 tuning of the build chroot.
 146 .It Va NOGIT
 147 Do not explicitly require the
 148 .Xr git 1
 149 port to be installed.
 150 .It Va GITROOT
 151 The
 152 .Xr git 1
 153 host used to check out the various trees.
 154 Defaults to
 155 .Pa https://git.FreeeBSD.org .
 156 .It Va SRCBRANCH
 157 The
 158 .Li src/
 159 branch to use.
 160 Defaults to
 161 .Fl b Va main .
 162 .It Va PORTBRANCH
 163 The
 164 .Li ports/
 165 branch to use.
 166 Defaults to
 167 .Va head/@rHEAD .
 168 .It Va TARGET
 169 The target machine type for cross-building a release.
 170 .It Va TARGET_ARCH
 171 The target machine architecture for cross-building a release.
 172 .Pp
 173 For the supported list of
 174 .Va TARGET
 175 and
 176 .Va TARGET_ARCH
 177 combinations, consult the output of
 178 .Dq make targets
 179 as documented in
 180 .Xr build 7 .
 181 .It Va KERNEL
 182 The target kernel configuration to use.
 183 Defaults to
 184 .Va GENERIC .
 185 Multiple
 186 .Va KERNEL
 187 entries may be specified.
 188 .It Va MAKE_CONF
 189 The
 190 .Xr make.conf 5
 191 to use for the release build.
 192 Defaults to
 193 .Fa /dev/null
 194 to prevent polluting the release with local system changes.
 195 .It Va SRC_CONF
 196 The
 197 .Xr src.conf 5
 198 to use for the release build.
 199 Defaults to
 200 .Fa /dev/null
 201 to prevent polluting the release with local system changes.
 202 .It Va MAKE_FLAGS
 203 Additional flags to pass to
 204 .Xr make 1 .
 205 .It Va WORLD_FLAGS
 206 Additional flags to pass to
 207 .Xr make 1
 208 during the
 209 .Dq buildworld
 210 phase.
 211 Defaults to setting the number of
 212 .Xr make 1
 213 jobs
 214 .Pq Ar -j
 215 to the number of CPUs available on a SMP-capable system.
 216 .It Va KERNEL_FLAGS
 217 Additional flags to pass to
 218 .Xr make 1
 219 during the
 220 .Dq buildkernel
 221 phase.
 222 Defaults to setting the number of
 223 .Xr make 1
 224 jobs
 225 .Pq Ar -j
 226 to half the number of CPUs available on a SMP-capable system.
 227 .It Va NOPORTS
 228 Set to a non-empty value to skip the
 229 .Li ports/
 230 tree checkout.
 231 When set,
 232 .Va NOPORTS
 233 will prevent the
 234 .Fa ports.txz
 235 distribution package from being created.
 236 .It Va WITH_DVD
 237 Set to a non-empty value to include the
 238 .Cm dvdrom
 239 target.
 240 .It Va WITH_COMPRESSED_IMAGES
 241 Set to a non-empty value to compress the release images with
 242 .Xr xz 1 .
 243 The original
 244 .Pq uncompressed
 245 images are not removed.
 246 .It Va XZ_THREADS Pq Vt int
 247 Set to the number of threads
 248 .Xr xz 1
 249 should use when compressing images.
 250 By default,
 251 .Va XZ_THREADS
 252 is set to
 253 .Va 0 ,
 254 which uses all available cores on the system.
 255 .It Va VCSCMD
 256 The command run to obtain the source trees.
 257 Defaults to
 258 .Qq Cm git clone Fl q .
 259 .It Va CHROOTBUILD_SKIP
 260 If defined, the
 261 .Li buildworld ,
 262 .Li installworld ,
 263 and
 264 .Li distribution
 265 stages of the
 266 .Xr chroot 8
 267 build environment setup are skipped.
 268 This is intended solely for cases where the
 269 .Xr chroot 8
 270 userland are provided by alternate means.
 271 .It Va SRC_UPDATE_SKIP
 272 Set to a non-empty value to prevent checkout or update of
 273 .Fa /usr/src
 274 within the
 275 .Xr chroot 8 .
 276 This is intended for use only when
 277 .Fa /usr/src
 278 is expected to exist by alternative means.
 279 .It Va PORTS_UPDATE_SKIP
 280 Set to a non-empty value to prevent checkout or update of
 281 .Fa /usr/ports
 282 within the
 283 .Xr chroot 8 .
 284 This is intended for use only when
 285 .Fa /usr/ports
 286 is expected to exist by alternative means.
 287 .El
 288 .Sh EMBEDDED BUILDS
 289 The following
 290 .Fa release.conf
 291 variables are relevant only to release builds for embedded systems:
 292 .Bl -tag -width Ev
 293 .It Va EMBEDDEDBUILD
 294 Set to a non-null value to enable functionality for embedded device
 295 release builds.
 296 .Pp
 297 When set,
 298 .Va WITH_DVD
 299 is unset.
 300 Additionally,
 301 .Va EMBEDDED_TARGET
 302 and
 303 .Va EMBEDDED_TARGET_ARCH
 304 must also be defined.
 305 When the build environment is created,
 306 .Fa release.sh
 307 runs a separate build script located in an architecture-specific
 308 directory in
 309 .Pa src/release/${EMBEDDED_TARGET}/ .
 310 .It Va EMBEDDEDPORTS
 311 Set to the list of any ports that are required for the target device
 312 in the format of
 313 .Fa category/port .
 314 The
 315 .Fa devel/subversion
 316 port is built by default.
 317 .It Va EMBEDDED_TARGET
 318 When set, its value is passed to
 319 .Xr make 1
 320 to set the
 321 .Va TARGET
 322 .Pq value of Cm uname Fl m
 323 to cross build the target userland.
 324 .It Va EMBEDDED_TARGET_ARCH
 325 When set, its value is passed to
 326 .Xr make 1
 327 to set the
 328 .Va TARGET_ARCH
 329 .Pq value of Cm uname Fl p
 330 to cross build the target userland.
 331 .El
 332 .Sh VIRTUAL MACHINE DISK IMAGES
 333 The following
 334 .Fa release.conf
 335 variables are relevant only to virtual machine disk image builds:
 336 .Bl -tag -width Ev
 337 .It Va WITH_VMIMAGES
 338 Set to a non-null value to build virtual machine disk images as part
 339 of the release build.
 340 .Va WITH_VMIMAGES
 341 may also be specified as an environment variable passed to
 342 .Xr make 1 .
 343 .Pp
 344 The option requires
 345 .Xr mkimg 1
 346 version 20140927 or later.
 347 .It Va WITH_COMPRESSED_VMIMAGES
 348 Set to a non-null value to compress the virtual machine disk images with
 349 .Xr xz 1
 350 as part of the
 351 .Cm install
 352 .Xr make 1
 353 target.
 354 Note that compressing virtual machine disk images may take a very long
 355 time on some systems.
 356 .It Va VMBASE
 357 Set to change the name of the resulting virtual machine disk image file.
 358 The default value is
 359 .Va vm .
 360 .It Va VMSIZE
 361 Set to change the size of the virtual machine disk capacity.
 362 The default value is
 363 .Va 20g .
 364 See
 365 .Xr makefs 8
 366 for valid values.
 367 .Pp
 368 Virtual machine disk images are, by default, created as sparse images.
 369 When
 370 .Va WITH_COMPRESSED_VMIMAGES
 371 is used, the resulting files compressed with
 372 .Xr xz 1
 373 compress to roughly the same size, regardless of the specified disk image
 374 size.
 375 .It Va VMFORMATS
 376 Set to the target virtual disk image format(s) to create.
 377 By default, the
 378 .Va vhdf , Va vmdk , Va qcow2 ,
 379 and
 380 .Va raw
 381 formats are created.
 382 See
 383 .Xr mkimg 1
 384 for valid format values
 385 .Pq requires version 20140927 or later .
 386 .El
 387 .Pp
 388 For a list of supported
 389 .Va VMFORMATS
 390 values
 391 .Pq including cloud hosting provider formats
 392 along with a brief description, run:
 393 .Bd -literal -offset indent
 394 cd /usr/src
 395 make -C release list-vmtargets
 396 .Ed
 397 .Sh CLOUD HOSTING MACHINE IMAGES
 398 The
 399 .Fx
 400 release build tools support building virtual machine images for various
 401 cloud hosting providers, each with their own specific configuration to
 402 include support for each hosting provider by default.
 403 .Pp
 404 The following
 405 .Xr make 1
 406 environment variables are supported:
 407 .Bl -tag -width Ev
 408 .It Va CLOUDWARE
 409 Set to a list of one or more cloud hosting providers, enclosed in quotes.
 410 Requires
 411 .Va WITH_CLOUDWARE
 412 to also be set.
 413 .It Va WITH_CLOUDWARE
 414 Set to a non-empty value to enable building virtual machine images
 415 for various cloud hosting providers.
 416 Requires
 417 .Va CLOUDWARE
 418 to also be set.
 419 .El
 420 .Pp
 421 Additionally, the
 422 .Va CLOUDWARE
 423 and
 424 .Va WITH_CLOUDWARE
 425 variables can be added to
 426 .Pa release.conf ,
 427 and used in conjunction with
 428 .Pa release.sh .
 429 .Pp
 430 For a list of supported
 431 .Va CLOUDWARE
 432 values, run:
 433 .Bd -literal -offset indent
 434 cd /usr/src
 435 make -C release list-cloudware
 436 .Ed
 437 .Sh MAKEFILE TARGETS
 438 The release makefile
 439 .Pq Pa src/release/Makefile
 440 is fairly abstruse.
 441 Most developers will only be concerned with the
 442 .Cm release
 443 and
 444 .Cm install
 445 targets.
 446 .\" XXX: Some sort of introduction to this list?  All the others have one.
 447 .Bl -tag -width ".Cm packagesystem"
 448 .It Cm release
 449 Meta-target to build all release media and distributions applicable to this
 450 platform.
 451 .It Cm install
 452 Copy all produced release media to
 453 .Pa ${DESTDIR} .
 454 .It Cm cdrom
 455 Builds installation CD-ROM images.
 456 This may require the
 457 .Xr md 4
 458 (memory disk) device driver be present in the kernel
 459 (either by being compiled in or available as a module).
 460 This target produces files called
 461 .Pa disc1.iso
 462 and
 463 .Pa bootonly.iso
 464 as its output.
 465 .It Cm dvdrom
 466 Builds installation DVD-ROM images.
 467 This may require the
 468 .Xr md 4
 469 (memory disk) device driver be present in the kernel
 470 (either by being compiled in or available as a module).
 471 This target produces the
 472 .Pa dvd1.iso
 473 file as its output.
 474 .It Cm memstick
 475 Builds an installation memory stick image named
 476 .Pa memstick.img .
 477 Not applicable on all platforms.
 478 Requires that the
 479 .Xr md 4
 480 .Pq memory disk
 481 device driver be present in the kernel
 482 .Pq either by being compiled in or available as a module .
 483 .It Cm mini-memstick
 484 Similar to
 485 .Cm memstick ,
 486 with the exception that the installation distribution sets
 487 are not included.
 488 .It Cm ftp
 489 Creates a directory named
 490 .Pa ftp
 491 containing the distribution files used in network installations
 492 and suitable for upload to an FTP mirror.
 493 .It Cm vm-image
 494 Creates virtual machine disk images in various formats.
 495 The
 496 .Cm vm-image
 497 target requires the
 498 .Va WITH_VMIMAGES
 499 .Xr make 1
 500 environment variable to be set to a non-null value.
 501 .It Cm vm-cloudware
 502 Builds
 503 .Fx
 504 virtual machine images for various cloud hosting providers.
 505 See
 506 .Qq CLOUD HOSTING MACHINE IMAGES
 507 for implementation details.
 508 .It Cm list-cloudware
 509 Displays the list of valid
 510 .Va CLOUDWARE
 511 values.
 512 .It Cm list-vmtargets
 513 Displays the list of valid
 514 .Va VMFORMAT
 515 and
 516 .Va CLOUDWARE
 517 values.
 518 .El
 519 .Pp
 520 Major subtargets called by targets above:
 521 .Bl -tag -width ".Cm packagesystem"
 522 .It Cm packagesystem
 523 Generates all the distribution archives
 524 .Pq base, kernel, ports, doc
 525 applicable on this platform.
 526 .It Cm disc1
 527 Builds a bootable installation system containing all the distribution files
 528 packaged by the
 529 .Cm packagesystem
 530 target, and suitable for imaging by the
 531 .Cm cdrom ,
 532 .Cm dvdrom
 533 and
 534 .Cm memstick
 535 targets.
 536 .It Cm reldoc
 537 Builds the release documentation.
 538 This includes the release notes,
 539 hardware guide, and installation instructions.
 540 Other documentation, such as the Handbook,
 541 is built during the
 542 .Cm base.txz
 543 target invoked by
 544 .Cm packagesystem .
 545 .El
 546 .Sh ENVIRONMENT
 547 Optional variables:
 548 .Bl -tag -width ".Ev TARGET_ARCH"
 549 .It Ev OSRELEASE
 550 Optional base name for generated media images when invoking the
 551 .Cm install
 552 target
 553 .Pq e.g., FreeBSD-12.1-RELEASE-amd64 .
 554 Defaults to the output of
 555 .Ic `uname -s`-`uname -r`-`uname -p`
 556 within the chroot.
 557 .It Ev WORLDDIR
 558 Location of a directory containing the src tree.
 559 By default, the directory
 560 above the one containing the makefile
 561 .Pq Pa src .
 562 .It Ev PORTSDIR
 563 Location of a directory containing the ports tree.
 564 By default,
 565 .Pa /usr/ports .
 566 If it is unset or cannot be found, ports will not be included in the release.
 567 .It Ev NOPORTS
 568 If defined, the Ports Collection will be omitted from the release.
 569 .It Ev NOSRC
 570 If set, do not include system source code in the release.
 571 .It Ev TARGET
 572 The target hardware platform.
 573 This is analogous to the
 574 .Dq Nm uname Fl m
 575 output.
 576 This is necessary to cross-build some target architectures.
 577 For example, cross-building for ARM64 machines requires
 578 .Ev TARGET_ARCH Ns = Ns Li aarch64
 579 and
 580 .Ev TARGET Ns = Ns Li arm64 .
 581 If not set,
 582 .Ev TARGET
 583 defaults to the current hardware platform.
 584 .It Ev TARGET_ARCH
 585 The target machine processor architecture.
 586 This is analogous to the
 587 .Dq Nm uname Fl p
 588 output.
 589 Set this to cross-build for a different architecture.
 590 If not set,
 591 .Ev TARGET_ARCH
 592 defaults to the current machine architecture, unless
 593 .Ev TARGET
 594 is also set, in which case it defaults to the appropriate
 595 value for that platform.
 596 Typically, one only needs to set
 597 .Ev TARGET .
 598 .El
 599 .Sh FILES
 600 .Bl -tag -compact -width Pa
 601 .It Pa /usr/doc/Makefile
 602 .It Pa /usr/doc/share/mk/doc.project.mk
 603 .It Pa /usr/ports/Mk/bsd.port.mk
 604 .It Pa /usr/ports/Mk/bsd.sites.mk
 605 .It Pa /usr/share/examples/etc/make.conf
 606 .It Pa /usr/src/Makefile
 607 .It Pa /usr/src/Makefile.inc1
 608 .It Pa /usr/src/release/Makefile
 609 .It Pa /usr/src/release/Makefile.vm
 610 .It Pa /usr/src/release/release.sh
 611 .It Pa /usr/src/release/release.conf.sample
 612 .It Pa /usr/src/release/tools/*.conf
 613 .It Pa /usr/src/release/tools/vmimage.subr
 614 .El
 615 .Sh EXAMPLES
 616 The following sequence of commands can be used to build a
 617 .Dq "-CURRENT snapshot":
 618 .Bd -literal -offset indent
 619 cd /usr
 620 git clone -b main https://git.freebsd.org/src.git src
 621 cd src
 622 make buildworld buildkernel
 623 cd release
 624 make obj
 625 make release
 626 make install DESTDIR=/var/freebsd-snapshot
 627 .Ed
 628 .Pp
 629 After running these commands, all produced distribution files (tarballs
 630 for FTP, CD-ROM images, etc.) are available in the
 631 .Pa /var/freebsd-snapshot
 632 directory.
 633 .Pp
 634 The following sequence of commands can be used to build a
 635 .Dq "-CURRENT snapshot"
 636 in a clean environment, including ports and documentation:
 637 .Bd -literal -offset indent
 638 cd /usr/src/release
 639 sh release.sh
 640 .Ed
 641 .Pp
 642 Optionally, a configuration file can be used customize the release build,
 643 such as the subversion revision to use, the branch of the subversion tree for
 644 .Li src/ ,
 645 .Li ports/ ,
 646 and
 647 .Li doc/ .
 648 .Bd -literal -offset indent
 649 cd /usr/src/release
 650 sh release.sh -c $HOME/release.conf
 651 .Ed
 652 .Pp
 653 Configuration files specific to various supported embedded systems, such as
 654 the Raspberry Pi, exist in the directory corresponding to the
 655 .Va TARGET
 656 .Xr make 1
 657 variable.
 658 For example, to build an image for the Raspberry Pi:
 659 .Bd -literal -offset indent
 660 cd /usr/src/release
 661 sh release.sh -c arm/RPI-B.conf
 662 .Ed
 663 .Pp
 664 To build an image for the Raspberry Pi 3:
 665 .Bd -literal -offset indent
 666 cd /usr/src/release
 667 sh release.sh -c arm64/RPI3.conf
 668 .Ed
 669 .Pp
 670 After running these commands, all prepared release files are available in the
 671 .Pa /scratch
 672 directory.
 673 The target directory can be changed by specifying the
 674 .Va CHROOTDIR
 675 variable in
 676 .Li release.conf .
 677 .Sh COMPATIBILITY
 678 The reldoc target was removed in commit f61e92ca5a23, and
 679 .Ev DOCDIR ,
 680 .Ev DOCBRANCH ,
 681 .Ev DOC_UPDATE_SKIP ,
 682 and
 683 .Ev NODOC
 684 are therefore no longer supported.
 685 .Sh SEE ALSO
 686 .Xr cc 1 ,
 687 .Xr git 1 Pq Pa ports/devel/git ,
 688 .Xr install 1 ,
 689 .Xr make 1 ,
 690 .Xr uname 1 ,
 691 .Xr md 4 ,
 692 .Xr make.conf 5 ,
 693 .Xr build 7 ,
 694 .Xr ports 7 ,
 695 .Xr chroot 8 ,
 696 .Xr mtree 8 ,
 697 .Xr sysctl 8
 698 .Rs
 699 .%T "FreeBSD Release Engineering"
 700 .%U https://docs.freebsd.org/en/articles/freebsd-releng/
 701 .Re
 702 .Rs
 703 .%T "FreeBSD Developers' Handbook"
 704 .%U https://docs.freebsd.org/en/books/developers-handbook/
 705 .Re
 706 .Sh HISTORY
 707 .Fx
 708 1.x
 709 used a manual checklist, compiled by
 710 .An Rod Grimes ,
 711 to produce a release.
 712 Apart from being incomplete, the list put a lot of specific demands on
 713 available file systems and was quite torturous to execute.
 714 .Pp
 715 As part of the
 716 .Fx 2.0
 717 release engineering effort, significant
 718 effort was spent getting
 719 .Pa src/release/Makefile
 720 into a shape where it could at least automate most of the tediousness
 721 of building a release in a sterile environment.
 722 .Pp
 723 For the
 724 .Fx 9.0
 725 release,
 726 .Pa src/release/Makefile
 727 was overhauled and the wrapper script
 728 .Pa src/release/generate-release.sh
 729 introduced to support the introduction of a new installer.
 730 .Pp
 731 For the
 732 .Fx 9.2
 733 release,
 734 .Pa src/release/release.sh
 735 was introduced to support per-build configuration files.
 736 .Pa src/release/release.sh
 737 is heavily based on the
 738 .Pa src/release/generate-release.sh
 739 script.
 740 .Pp
 741 At near 1000 revisions spread over multiple branches, the
 742 .Xr git 1
 743 log of
 744 .Pa src/release/Makefile
 745 contains a vivid historical record of some
 746 of the hardships release engineers go through.
 747 .Sh AUTHORS
 748 .Pa src/release/Makefile
 749 was originally written by
 750 .An -nosplit
 751 .An Rod Grimes ,
 752 .An Jordan Hubbard ,
 753 and
 754 .An Poul-Henning Kamp .
 755 .Pp
 756 This manual page was originally written by
 757 .An Murray Stokely Aq Mt murray@FreeBSD.org .
 758 .Pp
 759 It was updated by
 760 .An Nathan Whitehorn Aq Mt nwhitehorn@FreeBSD.org
 761 to include the
 762 .Fa generate-release.sh
 763 script used for the
 764 .Fx 9.0
 765 release cycle.
 766 .Pp
 767 It was later updated by
 768 .An Glen Barber Aq Mt gjb@FreeBSD.org
 769 to include the
 770 .Fa release.sh
 771 script used for the
 772 .Fx 9.2
 773 release cycle.