release.7 (273080) | release.7 (278985) |
---|---|
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.\" | 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: stable/10/share/man/man7/release.7 273080 2014-10-14 12:23:44Z gjb $ | 25.\" $FreeBSD: stable/10/share/man/man7/release.7 278985 2015-02-19 03:57:47Z gjb $ |
26.\" | 26.\" |
27.Dd October 2, 2014 | 27.Dd January 28, 2015 |
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 --- 365 unchanged lines hidden (view full) --- 401and 402.Va raw 403formats are created. 404See 405.Xr mkimg 1 406for valid format values 407.Pq requires version 20140927 or later . 408.El | 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 --- 365 unchanged lines hidden (view full) --- 401and 402.Va raw 403formats are created. 404See 405.Xr mkimg 1 406for valid format values 407.Pq requires version 20140927 or later . 408.El |
409.Pp 410For a list of supported 411.Va VMFORMATS 412values 413.Pq including cloud hosting provider formats 414along with a brief description, run: 415.Bd -literal -offset indent 416cd /usr/src 417make -C release list-vmtargets 418.Ed 419.Sh CLOUD HOSTING MACHINE IMAGES 420The 421.Fx 422release build tools support building virtual machine images for various 423cloud hosting providers, each with their own specific configuration to 424include support for each hosting provider by default. 425.Pp 426The following 427.Xr make 1 428environment variables are supported: 429.Pp 430.Bl -tag -width Ev 431.It Va CLOUDWARE 432Set to a list of one or more cloud hosting providers, enclosed in quotes. 433Requires 434.Va WITH_CLOUDWARE 435to also be set. 436.It Va WITH_CLOUDWARE 437Set to a non-empty value to enable building virtual machine images 438for various cloud hosting providers. 439Requires 440.Va CLOUDWARE 441to also be set. 442.El 443.Pp 444Additionally, the 445.Va CLOUDWARE 446and 447.Va WITH_CLOUDWARE 448variables can be added to 449.Pa release.conf , 450and used in conjunction with 451.Pa release.sh . 452.Pp 453For a list of supported 454.Va CLOUDWARE 455values, run: 456.Bd -literal -offset indent 457cd /usr/src 458make -C release list-cloudware 459.Ed |
|
409.Sh MAKEFILE TARGETS 410The release makefile 411.Pq Pa src/release/Makefile 412is fairly abstruse. 413Most developers will only be concerned with the 414.Cm release 415and 416.Cm install --- 48 unchanged lines hidden (view full) --- 465.It Cm vm-image 466Creates virtual machine disk images in various formats. 467The 468.Cm vm-image 469target requires the 470.Va WITH_VMIMAGES 471.Xr make 1 472envirionment variable to be set to a non-null value. | 460.Sh MAKEFILE TARGETS 461The release makefile 462.Pq Pa src/release/Makefile 463is fairly abstruse. 464Most developers will only be concerned with the 465.Cm release 466and 467.Cm install --- 48 unchanged lines hidden (view full) --- 516.It Cm vm-image 517Creates virtual machine disk images in various formats. 518The 519.Cm vm-image 520target requires the 521.Va WITH_VMIMAGES 522.Xr make 1 523envirionment variable to be set to a non-null value. |
524.It Cm vm-cloudware 525Builds 526.Fx 527virtual machine images for various cloud hosting providers. 528See 529.Qq CLOUD HOSTING MACHINE IMAGES 530for implementation details. 531.It Cm list-cloudware 532Displays the list of valid 533.Va CLOUDWARE 534values. 535.It Cm list-vmtargets 536Displays the list of valid 537.Va VMFORMAT 538and 539.Va CLOUDWARE 540values. |
|
473.El 474.Pp 475Major subtargets called by targets above: 476.Bl -tag -width ".Cm packagesystem" 477.It Cm packagesystem 478Generates all the distribution archives 479.Pq base, kernel, ports, doc 480applicable on this platform. | 541.El 542.Pp 543Major subtargets called by targets above: 544.Bl -tag -width ".Cm packagesystem" 545.It Cm packagesystem 546Generates all the distribution archives 547.Pq base, kernel, ports, doc 548applicable on this platform. |
481.It Cm system | 549.It Cm disc1 |
482Builds a bootable installation system containing all the distribution files 483packaged by the 484.Cm packagesystem 485target, and suitable for imaging by the 486.Cm cdrom , 487.Cm dvdrom 488and 489.Cm memstick --- 81 unchanged lines hidden (view full) --- 571.It Pa /usr/doc/Makefile 572.It Pa /usr/doc/share/mk/doc.project.mk 573.It Pa /usr/ports/Mk/bsd.port.mk 574.It Pa /usr/ports/Mk/bsd.sites.mk 575.It Pa /usr/share/examples/etc/make.conf 576.It Pa /usr/src/Makefile 577.It Pa /usr/src/Makefile.inc1 578.It Pa /usr/src/release/Makefile | 550Builds a bootable installation system containing all the distribution files 551packaged by the 552.Cm packagesystem 553target, and suitable for imaging by the 554.Cm cdrom , 555.Cm dvdrom 556and 557.Cm memstick --- 81 unchanged lines hidden (view full) --- 639.It Pa /usr/doc/Makefile 640.It Pa /usr/doc/share/mk/doc.project.mk 641.It Pa /usr/ports/Mk/bsd.port.mk 642.It Pa /usr/ports/Mk/bsd.sites.mk 643.It Pa /usr/share/examples/etc/make.conf 644.It Pa /usr/src/Makefile 645.It Pa /usr/src/Makefile.inc1 646.It Pa /usr/src/release/Makefile |
647.It Pa /usr/src/release/Makefile.vm |
|
579.It Pa /usr/src/release/release.sh 580.It Pa /usr/src/release/release.conf.sample | 648.It Pa /usr/src/release/release.sh 649.It Pa /usr/src/release/release.conf.sample |
650.It Pa /usr/src/release/tools/*.conf 651.It Pa /usr/src/release/tools/vmimage.subr |
|
581.El 582.Sh EXAMPLES 583The following sequence of commands can be used to build a 584.Dq "-CURRENT snapshot": 585.Bd -literal -offset indent 586cd /usr 587svn co svn://svn.freebsd.org/base/head src 588cd src --- 130 unchanged lines hidden --- | 652.El 653.Sh EXAMPLES 654The following sequence of commands can be used to build a 655.Dq "-CURRENT snapshot": 656.Bd -literal -offset indent 657cd /usr 658svn co svn://svn.freebsd.org/base/head src 659cd src --- 130 unchanged lines hidden --- |