aboutsummaryrefslogtreecommitdiff
path: root/share/man/man7/build.7
Commit message (Collapse)AuthorAgeFilesLines
* build.7: Document several toolchain make variables.John Baldwin2024-11-301-3/+27
| | | | | | | | Document CROSS_TOOLCHAIN, UNIVERSE_TOOLCHAIN, and USE_GCC_TOOLCHAINS. Differential Revision: https://reviews.freebsd.org/D40778 (cherry picked from commit 21ef3591b6119f6972896e6c00cbf9ffb759646e)
* build.7: remove documentation of "make update"Ceri Davies2024-11-301-18/+3
| | | | | | update target was removed in e290182bcf3895ca659dff111bca6a077c4708b1 (cherry picked from commit 1f7d11e636abf68d92b052fefe63b687d84c966a)
* build: Note paths that must be absoluteEd Maste2024-11-161-1/+6
| | | | | | | | | | PR: 282711 PR: 282737 Sponsored by: The FreeBSD Foundation (cherry picked from commit 75af1320f4b57fb568ec4f6df6171a0343953f4f) (cherry picked from commit 02dc158215a69c6439e5a0809e5f9c79e62c5fd1) (cherry picked from commit 54efa38e255184f7f7862294666b017acb093a08)
* Remove $FreeBSD$: two-line nroff patternWarner Losh2023-08-231-2/+0
| | | | | | | Remove /^\.\\"\n\.\\"\s*\$FreeBSD\$$\n/ Similar commit in main: (cherry picked from commit fa9896e082a1)
* Revert "build(7): fix references to svn(1) and svnlite(1)"Ed Maste2022-07-171-1/+1
| | | | | | | | This reverts commit 830d566254d3f4e5204f849cb2d2c70d9afffb8f. The content change was already cherry-picked, and 830d566254d3 served only to introduce a typo. Reported by: mhorne
* build(7): fix references to svn(1) and svnlite(1)Dmitry Morozovsky2022-07-081-1/+1
| | | | | | | | | | Replace them with references to Git. PR: 254937 Reported by: m.bueker@berlin.de Differential Revision: https://reviews.freebsd.org/D29949 (cherry picked from commit e444a4c677ee3e86038ba2179c4838f5f4b778cd)
* build(7): fix references to svn(1) and svnlite(1)Fernando Apesteguía2022-06-101-5/+6
| | | | | | | | | | | Replace them with references to Git. PR: 254937 Reported by: m.bueker@berlin.de Approved by: 0mp (mentor) Differential Revision: https://reviews.freebsd.org/D29949 (cherry picked from commit e444a4c677ee3e86038ba2179c4838f5f4b778cd)
* build.7: Describe the default value for LOCAL_MODULESMark Johnston2021-08-171-0/+2
| | | | | | Suggested by: jhb (cherry picked from commit 805c3af898a8fed6a92caa069011c0ce7fa542ef)
* build.7: Document LOCAL_MODULES and LOCAL_MODULES_DIRMark Johnston2021-08-171-1/+14
| | | | | | | Reviewed by: 0mp, imp Sponsored by: The FreeBSD Foundation (cherry picked from commit e7a13643b17c3ec7357b26324986587dab810da5)
* build(7): use a more relevant example for PORTS_MODULESMitchell Horne2021-05-271-2/+2
| | | | | | | | | emulators/kqemu-kmod no longer exists in the ports tree. Reviewed by: imp, bcr Differential Revision: https://reviews.freebsd.org/D30261 (cherry picked from commit 7fbc0c98a8efaef86d72759372ec7746d929302e)
* Rename NO_WERROR -> MK_WERROR=noAlex Richardson2021-01-071-1/+1
| | | | | | | | As suggested in D27598. This also supports MK_WERROR.clang=no and MK_WERROR.gcc=no to support the existing NO_WERROR.<compiler> uses. Reviewed By: brooks Differential Revision: https://reviews.freebsd.org/D27601
* Add lists for customizing legacy and bootstrap-tools.Bryan Drewery2020-11-201-1/+11
| | | | | | | | | Reviewed by: arichardson Sponsored by: Dell EMC Differential Revision: https://reviews.freebsd.org/D27200 Notes: svn path=/head/; revision=367910
* build.7: Mention etcupdate(8) alongside mergemaster(8)Mateusz Piotrowski2020-11-031-1/+2
| | | | | | | MFC after: 3 days Notes: svn path=/head/; revision=367300
* Improvements for the src.conf(5) and build(7) man pagesGordon Bergling2020-09-111-6/+21
| | | | | | | | | | | | PR: 203863 (based on) Submitted by: Russell Haley <russ dot haley at gmail dot com> Reviewed by: bcr, imp Approved by: imp MFC after: 1 week Differential Revision: https://reviews.freebsd.org/D26343 Notes: svn path=/head/; revision=365640
* Do not describe portsnap(8) as a way to manage /usr/portsMateusz Piotrowski2020-08-051-6/+3
| | | | Notes: svn path=/head/; revision=363903
* Add HISTORY sections to build(7), crypto(7),Benedict Reuschling2020-05-031-1/+6
| | | | | | | | | | | ffs(7), growfs(7), and diskless(8). Submitted by: Gordon Bergling gbergling_gmail.com Approved by: bcr Differential Revision: https://reviews.freebsd.org/D24271 Notes: svn path=/head/; revision=360602
* Document universe betterWarner Losh2020-03-311-1/+22
| | | | | | | | | | | | Document the kernels and worlds targets. Document the TARGETS and EXTRA_TARGETS variables. Reviewed by: brooks, bdrewery, emaste (LGTM) MFC After: 3 days Differential Revision: https://reviews.freebsd.org/D24212 Notes: svn path=/head/; revision=359496
* Make universe configuration more consistent with rest of systemWarner Losh2020-03-311-1/+7
| | | | | | | | | | | | | | | Add 'WITHOUT_WORLDS' and 'WITHOUT_KERNELS' as aliases for the inconsistently named MAKE_JUST_KERNELS and MAKE_JUST_WORLDS respectively. I always forget the MAKE_ part (or is it BUILD_), and it's inconsistent with everything else. Document the new things, but leave speculation of any eventual MAKE_JUST_* deprecation out of the manuals and comments. Reviewed by: brooks, bdrewery, emaste (LGTM) MFC After: 3 days Differential Revision: https://reviews.freebsd.org/D24212 Notes: svn path=/head/; revision=359494
* Use less misleading directory name.Edward Tomasz Napierala2018-12-031-2/+2
| | | | | | | | MFC after: 2 weeks Sponsored by: DARPA, AFRL Notes: svn path=/head/; revision=341425
* build(7): clarify buildenv target can be used for non-cross buildsEd Maste2018-11-101-5/+5
| | | | | | | | | | | | | | make buildenv can be used for building for the same architecture as the host (perhaps this is a degenerate case of cross-building). TARGET and TARGET_ARCH do not need to be set in this case. Reviewed by: bdrewery MFC after: 1 week Sponsored by: The FreeBSD Foundation Differential Revision: https://reviews.freebsd.org/D10759 Notes: svn path=/head/; revision=340329
* Document LOADER_DEFAULT_INTERP.Warner Losh2018-08-191-0/+12
| | | | | | | | | This controls what interpreter the default boot loader in /boot/loader{,.efi} is, and which one we compile into userboot by default. Notes: svn path=/head/; revision=338043
* build(7): Document KERNCONFDIR - directory in which KERNCONF residesKyle Evans2018-08-161-1/+9
| | | | | | | MFC after: 1 week Notes: svn path=/head/; revision=337906
* Add svnlite to places where svn is mentioned.Alexander Leidinger2018-08-111-1/+4
| | | | | | | | | | | | | | The Makefile part in the PR is solved already differently, so this part is skipped form the PR The man page change change is slightly changed to adapt to the way the Makefile works and to the spirit of what is intended here. Submitted by: Juan Ramón Molina Menor <info@juanmolina.eu> PR: 194910 Sponsored by: Essen Hackathon Notes: svn path=/head/; revision=337621
* Allow use of .WAIT in the LOCAL_DIRS and LOCAL_LIB_DIRS lists.Ian Lepore2017-12-311-1/+19
| | | | | | | | | | | | | | A comment in Makefile.inc1 has long stated that LOCAL_DIRS are built last, after the base system. Incremental improvements in parallel building over the years have led to LOCAL_DIRS being built in parallel with base system directories. This change allows the .WAIT directive to appear in LOCAL_DIRS and LOCAL_LIB_DIRS lists to give the user some control over parallel building of local additions. Differential Revision: https://reviews.freebsd.org/D13622 Notes: svn path=/head/; revision=327439
* Follow-up r318105: Don't use NO_OBJ at top-level, use NO_OBJWALK.Bryan Drewery2017-11-031-3/+3
| | | | | | | | | | | | | NO_OBJ has a very specific meaning in sub-directories in that no object directory will be made. If a user wanted to skip the 'make obj' phase then passing -DNO_OBJ would break all sub-directories from building properly. Using NO_OBJ internally also causes issue with NO_OBJ handling being added in share/mk/bsd.init.mk soon. Sponsored by: Dell EMC Isilon Notes: svn path=/head/; revision=325374
* Add a 'make cleanuniverse'.Bryan Drewery2017-11-011-2/+9
| | | | | | | | | | This will remove all build files for the source directory when MK_UNIFIED_OBJDIR is enabled. Sponsored by: Dell EMC Isilon Notes: svn path=/head/; revision=325289
* Add option UNIFIED_OBJDIR, on by default, which moves the default build OBJDIR.Bryan Drewery2017-11-011-16/+17
| | | | | | | | | | | | | | | | | | | | | | This changes the build OBJDIR from the older style of /usr/obj/<srcdir> for native builds, and /usr/obj/<target>.<target_arch>/<srcdir> for cross builds to a new simpler format of /usr/obj/<srcdir>/<target>.<target_arch>. This new format is used regardless of cross or native build. It allows easier management of multiple source tree object directories. The UNIFIED_OBJDIR option will be removed and its feature made permanent for the 12.0 release. Relnotes: yes (don't note UNIFIED_OBJDIR option since it will be removed) Prior work: D3711 D874 Reviewed by: gjb, sjg Discussed at: https://lists.freebsd.org/pipermail/freebsd-arch/2016-May/017805.html Discussed with: emaste Sponsored by: Dell EMC Isilon Differential Revision: https://reviews.freebsd.org/D12840 Notes: svn path=/head/; revision=325288
* Change native-xtools to not install by default; add a native-xtools-install.Bryan Drewery2017-10-291-0/+11
| | | | | | | | | | | | | | | Without this the user has to mess with 'make -f Makefile.inc1 ...' to figure out where the files are installed in the OBJDIR and then they need to copy them to where they really wanted them. Using DESTDIR may be problematic after r325001 as well. The files will be installed to DESTDIR/NXTP where NXTP defaults to /nxb-bin. MFC after: 2 weeks Sponsored by: Dell EMC Isilon Notes: svn path=/head/; revision=325082
* build(7): Document xdev targets.Bryan Drewery2017-10-291-0/+37
| | | | | | | | MFC after: 2 weeks Sponsored by: Dell EMC Isilon Notes: svn path=/head/; revision=325081
* build(7): Document native-xtools.Bryan Drewery2017-10-291-0/+12
| | | | | | | | MFC after: 2 weeks Sponsored by: Dell EMC Isilon Notes: svn path=/head/; revision=325080
* Improve build(7): add missing "buildkernel" and "installkernel"Edward Tomasz Napierala2017-05-111-5/+9
| | | | | | | | | | | | to the example, change the architectures to something more common, and improve description of defaults for TARGET. Reviewed by: bdrewery, ngie, imp (older revisions) MFC after: 2 weeks Differential Revision: https://reviews.freebsd.org/D10654 Notes: svn path=/head/; revision=318182
* SUBDIR_OVERRIDE: Note how to restore historical behavior pre-r289725.Bryan Drewery2017-05-101-0/+5
| | | | | | | Sponsored by: Dell EMC Isilon Notes: svn path=/head/; revision=318123
* Add a -DNO_LIBS to skip building the libraries phase as well.Bryan Drewery2017-05-091-0/+2
| | | | | | | | | This is useful for cases where -DWORLDFAST is useful. Sponsored by: Dell EMC Isilon Notes: svn path=/head/; revision=318122
* Support -DWORLDFAST to skip all build steps up to 'libraries' and 'everything'.Bryan Drewery2017-05-091-0/+10
| | | | | | | | | | | | | This allows for building the world against the already-created host/sysroot environment. It is not overly useful outside of cases of large-impact changes such as a testing a new compiler. It will allow quickly getting back to an error in the target-phases of the build where a new compiler is being used. Sponsored by: Dell EMC Isilon Notes: svn path=/head/; revision=318106
* Support skipping 'make obj' tree-walk.Bryan Drewery2017-05-091-0/+4
| | | | | | | | | | This is part of a larger effort for WITH_AUTO_OBJ and a WORLDFAST option. Sponsored by: Dell EMC Isilon Notes: svn path=/head/; revision=318105
* build(7): sort SEE ALSO sectionEnji Cooper2017-03-231-3/+3
| | | | | | | | | | | tests(7) should be grouped in the man section 7 group, not the section 8 group. MFC after: 1 week Reported by: make manlint Sponsored by: Dell EMC Isilon Notes: svn path=/head/; revision=315788
* Update TARGET/TARGET_ARCH examples to use arm64/aarch64 instead of i386/pc98Enji Cooper2017-01-281-4/+4
| | | | | | | pc98 support was removed in r312910 Notes: svn path=/head/; revision=312938
* Add LOCAL_XTOOL_DIRS to add into cross-tools.Bryan Drewery2016-07-211-1/+6
| | | | | | | Sponsored by: EMC / Isilon Storage Division Notes: svn path=/head/; revision=303130
* Clarify build(7) instructions for alternate object directory.Warren Block2016-04-281-3/+15
| | | | | | | | | | PR: 209062 Submitted by: Shawn Debnath <sd@beastie.io> MFC after: 1 week Differential Revision: https://reviews.freebsd.org/D6106 Notes: svn path=/head/; revision=298759
* META_MODE+filemon: Default -DNO_CLEAN enabled.Bryan Drewery2016-04-141-1/+9
| | | | | | | | | | | | When using meta mode with filemon, the build is reliably incremental safe. Bmake will use the meta files, along with filemon information, to rebuild targets when their dependencies change, commands change, or files they generate are missing. Sponsored by: EMC / Isilon Storage Division Notes: svn path=/head/; revision=298006
* Remove the old depend (mkdep) code and make FAST_DEPEND the one true way.Bryan Drewery2016-03-301-13/+10
| | | | | | | | | | Reviewed by: emaste, hselasky (partial), brooks (brief) Discussed on: arch@ Sponsored by: EMC / Isilon Storage Division Differential Revision: https://reviews.freebsd.org/D5742 Notes: svn path=/head/; revision=297434
* Import bsd.clang-analyze.mk based on NetBSD's version.Bryan Drewery2016-02-261-1/+3
| | | | | | | | | | | | This allows 'make analyze' or 'make OBJ.clang-analyzer' to run the Clang static analyzer and present results on stdout. Obtained from: NetBSD (CVS Rev. 1.3) Sponsored by: EMC / Isilon Storage Division Differential Revision: https://reviews.freebsd.org/D5449 Notes: svn path=/head/; revision=296124
* Simplify running the FreeBSD test suiteEnji Cooper2016-02-071-1/+12
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Replace `make regress` (legacy test make target) and `make test` (incomplete test make target added with the FreeBSD test suite) with make check as it's consistent with other open source projects. `make check` defaults to running tests from `.OBJDIR`, but can be overridden with the `CHECKDIR` variable. Add `make checkworld` target to simplify running the FreeBSD test suite from `TESTSBASE` (i.e. the top-level tests directory), similar to buildworld. Document `make check` and `make checkworld` in build(7). Other minor changes: - Rename intermediate file (`Kyuafile.auto`) to `Kyuafile` to simplify `make check`. - Remove terse warnings attached to `beforetest`/`aftertest`. - Add kyua binary check to check target in suite.test.mk; error out if it's not found The MFC is [partly] contingent on other build related changes being MFCed. Differential Revision: https://reviews.freebsd.org/D4406 MFC after: 2 months X-MFC to: stable/10 Relnotes: yes Reviewed by: bdrewery, Evan Cramer <eccramer@gmail.com> Sponsored by: EMC / Isilon Storage Division Notes: svn path=/head/; revision=295380
* Let SUBDIR_OVERRIDE with 'make buildworld' be more useful.Bryan Drewery2015-10-221-2/+14
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Now it can be used to effectively "build in a subdir". It will use the 'cross-tools', 'libraries', and 'includes' phases of 'buildworld' to properly setup a WORLDTMP to use. Then it will build 'everything' only in the listed SUBDIR_OVERRIDE directories. It is still required to list custom library directories in LOCAL_LIB_DIRS if SUBDIR_OVERRIDE is something that contains libraries outside of the normal area (such as SUBDIR_OVERRIDE=contrib/ofed needing LOCAL_LIB_DIRS=contrib/ofed/usr.lib) Without these changes, SUBDIR_OVERRIDE with buildworld was broken or hit obscure failures due to missing libraries, includes, or cross compiler. SUBDIR_OVERRIDE with 'make <target that is not buildworld>' will continue to work as it did before although its usefulness is questionable. With a fully populated WORLDTMP, building with a SUBDIR_OVERRIDE with -DNO_CLEAN only takes a few minutes to start building the target directories. This is still much better than building unneeded things via 'everything' when testing small subset changes. A BUILDFAST or SKIPWORLDTMP might make sense for this as well. - Add in '_worldtmp' as we still need to create WORLDTMP as later targets, such as '_libraries' and '_includes' use it. This probably was avoiding calling '_worldtmp' to not remove WORLDTMP for debugging purposes, but -DNO_CLEAN can be used for that. - '_legacy' must be included since '_build-tools' uses -legacy. The SUBDIR_OVERRIDE change came in r95509, while -legacy being part of build-tools came in r113136. - 'bootstrap-tools' is still skipped as this feature is not for upgrades. - Fix buildworld combined with SUBDIR_OVERRIDE not installing all includes. The original change for SUBDIR_OVERRIDE in r95509 kept '_includes' and '_libraries' as building everything possible as the SUBDIR_OVERRIDE could need anything from them. However in r96462 the real 'includes' target was changed from manual sub-makes to just recursing 'includes' on SUBDIR, thus not all includes have been installed into WORLDTMP since then when combined with 'buildworld'. This is not done unless calling 'make buildworld' as it would be unexpected to have it go into all directories when doing 'make SUBDIR_OVERRIDE=mydir includes'. - Also need to build the cross-compiler so it is used with --sysroot. If this is burdensome then telling the build to use the local compiler as an external compiler (thus using a proper --sysroot to WORLDTMP) is possible by setting CC=/usr/bin/cc, CXX=/usr/bin/c++, etc. - Don't build the lib32 distribution with SUBDIR_OVERRIDE in buildworld since it won't contain anything related to SUBDIR_OVERRIDE. Testing of the lib32 build can be done with 'make build32'. - Document these changes in build.7 Sponsored by: EMC / Isilon Storage Division MFC after: 2 weeks Notes: svn path=/head/; revision=289725
* Bump .Dd again for the change done in r276483Enji Cooper2015-01-051-1/+1
| | | | | | | Pointyhat to: me Notes: svn path=/head/; revision=276673
* The variable used with install(1) for stripping should be STRIPBIN, notEnji Cooper2014-12-311-2/+2
| | | | | | | | | | STRIP_CMD MFC after: 3 days Reported by: lev Notes: svn path=/head/; revision=276483
* Bump .Dd for change done in r275908Enji Cooper2014-12-271-1/+1
| | | | Notes: svn path=/head/; revision=276309
* Document STRIP_CMD in build(7) and note its importance with LOCAL_ITOOLSEnji Cooper2014-12-181-0/+15
| | | | | | | | | | MFC after: 1 week Phabric: D1335 Reviewed by: brueffer Sponsored by: EMC / Isilon Storage Division Notes: svn path=/head/; revision=275908
* Drop references to updating over csup from build(7).Gavin Atkinson2014-06-251-4/+2
| | | | | | | MFC after: 1 week Notes: svn path=/head/; revision=267866
* use .Mt to mark up email addresses consistently (part6)Baptiste Daroussin2014-06-231-1/+1
| | | | | | | | PR: 191174 Submitted by: Franco Fichtner <franco at lastsummer.de> Notes: svn path=/head/; revision=267776
generated by cgit v1.2.3 (git 2.25.1) at 2025-02-27 03:46:58 +0000