| build.7 (217815) | build.7 (218524) |
|---|---|
| 1.\" Copyright (c) 2000 2.\" Mike W. Meyer 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) 2000 2.\" Mike W. Meyer 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/build.7 217815 2011-01-25 08:13:31Z bz $ | 25.\" $FreeBSD: head/share/man/man7/build.7 218524 2011-02-10 18:54:52Z jhb $ |
| 26.\" | 26.\" |
| 27.Dd January 25, 2011 | 27.Dd February 10, 2011 |
| 28.Dt BUILD 7 29.Os 30.Sh NAME 31.Nm build 32.Nd information on how to build the system 33.Sh DESCRIPTION 34The sources for the 35.Fx --- 177 unchanged lines hidden (view full) --- 213is running on both client and server. 214See 215.Xr rc.conf 5 216on how to make it start at boot time. 217.It Cm toolchain 218Create the build toolchain needed to build the rest of the system. 219For cross-architecture builds, this step creates a cross-toolchain. 220.It Cm universe | 28.Dt BUILD 7 29.Os 30.Sh NAME 31.Nm build 32.Nd information on how to build the system 33.Sh DESCRIPTION 34The sources for the 35.Fx --- 177 unchanged lines hidden (view full) --- 213is running on both client and server. 214See 215.Xr rc.conf 5 216on how to make it start at boot time. 217.It Cm toolchain 218Create the build toolchain needed to build the rest of the system. 219For cross-architecture builds, this step creates a cross-toolchain. 220.It Cm universe |
| 221Execute a | 221For each architecture, 222execute a |
| 222.Cm buildworld | 223.Cm buildworld |
| 223and | 224followed by a |
| 224.Cm buildkernel | 225.Cm buildkernel |
| 225for all kernels including 226.Pa LINT , 227for each architecture supported by the build system. | 226for all kernels for that architecture, 227including 228.Pa LINT . |
| 228This command takes a long time. 229.It Cm update 230Get updated sources as configured in 231.Xr make.conf 5 . 232.It Cm targets 233Print a list of supported 234.Va TARGET 235/ 236.Va TARGET_ARCH 237pairs for world and kernel targets. 238.It Cm tinderbox 239Execute the same targets as 240.Cm universe . 241In addition print a summary of all failed targets at the end and 242exit with an error if there were any. | 229This command takes a long time. 230.It Cm update 231Get updated sources as configured in 232.Xr make.conf 5 . 233.It Cm targets 234Print a list of supported 235.Va TARGET 236/ 237.Va TARGET_ARCH 238pairs for world and kernel targets. 239.It Cm tinderbox 240Execute the same targets as 241.Cm universe . 242In addition print a summary of all failed targets at the end and 243exit with an error if there were any. |
| 244.It Cm toolchains 245Create a build toolchain for each architecture supported by the build system. |
|
| 243.El 244.Pp 245Kernel specific build targets in 246.Pa /usr/src 247are: 248.Bl -tag -width ".Cm reinstallkernel" 249.It Cm buildkernel 250Rebuild the kernel and the kernel modules. --- 252 unchanged lines hidden (view full) --- 503.Xr make 1 504variables: 505.Bl -tag -width ".Va DOC_LANG" 506.It Va DOC_LANG 507If set, restricts the documentation build to the language subdirectories 508specified as its content. 509The default action is to build documentation for all languages. 510.El | 246.El 247.Pp 248Kernel specific build targets in 249.Pa /usr/src 250are: 251.Bl -tag -width ".Cm reinstallkernel" 252.It Cm buildkernel 253Rebuild the kernel and the kernel modules. --- 252 unchanged lines hidden (view full) --- 506.Xr make 1 507variables: 508.Bl -tag -width ".Va DOC_LANG" 509.It Va DOC_LANG 510If set, restricts the documentation build to the language subdirectories 511specified as its content. 512The default action is to build documentation for all languages. 513.El |
| 514.Pp 515Builds using the 516.Cm universe 517target are influenced by the following 518.Xr make 1 519variables: 520.Bl -tag -width ".Va MAKE_JUST_KERNELS" 521.It Va JFLAG 522Pass the value of this variable to each 523.Xr make 1 524invocation used to build worlds and kernels. 525This can be used to enable multiple jobs within a single architecture's build 526while still building each architecture serially. 527.It Va MAKE_JUST_KERNELS 528Only build kernels for each supported architecture. 529.It Va MAKE_JUST_WORLDS 530Only build worlds for each supported architecture. 531.It Va UNIVERSE_TARGET 532Execute the specified 533.Xr make 1 534target for each supported architecture instead of the default action of 535building a world and one or more kernels. 536.El |
|
| 511.Sh FILES 512.Bl -tag -width ".Pa /usr/share/examples/etc/make.conf" -compact 513.It Pa /usr/doc/Makefile 514.It Pa /usr/doc/share/mk/doc.project.mk 515.It Pa /usr/ports/Mk/bsd.port.mk 516.It Pa /usr/ports/Mk/bsd.sites.mk 517.It Pa /usr/share/examples/etc/make.conf 518.It Pa /usr/src/Makefile --- 31 unchanged lines hidden --- | 537.Sh FILES 538.Bl -tag -width ".Pa /usr/share/examples/etc/make.conf" -compact 539.It Pa /usr/doc/Makefile 540.It Pa /usr/doc/share/mk/doc.project.mk 541.It Pa /usr/ports/Mk/bsd.port.mk 542.It Pa /usr/ports/Mk/bsd.sites.mk 543.It Pa /usr/share/examples/etc/make.conf 544.It Pa /usr/src/Makefile --- 31 unchanged lines hidden --- |