History log of /freebsd-11.0-release/share/man/man7/build.7
Revision Date Author Comments
(<<< Hide modified files)
(Show modified files >>>)
# 303975 11-Aug-2016 gjb

Copy stable/11@r303970 to releng/11.0 as part of the 11.0-RELEASE
cycle.

Prune svn:mergeinfo from the new branch, and rename it to RC1.

Update __FreeBSD_version.

Use the quarterly branch for the default FreeBSD.conf pkg(8) repo and
the dvd1.iso packages population.

Approved by: re (implicit)
Sponsored by: The FreeBSD Foundation

# 302408 08-Jul-2016 gjb

Copy head@r302406 to stable/11 as part of the 11.0-RELEASE cycle.
Prune svn:mergeinfo from the new branch, as nothing has been merged
here.

Additional commits post-branch will follow.

Approved by: re (implicit)
Sponsored by: The FreeBSD Foundation


# 298759 28-Apr-2016 wblock

Clarify build(7) instructions for alternate object directory.

PR: 209062
Submitted by: Shawn Debnath <sd@beastie.io>
MFC after: 1 week
Differential Revision: https://reviews.freebsd.org/D6106


# 298006 14-Apr-2016 bdrewery

META_MODE+filemon: Default -DNO_CLEAN enabled.

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


# 297434 31-Mar-2016 bdrewery

Remove the old depend (mkdep) code and make FAST_DEPEND the one true way.

Reviewed by: emaste, hselasky (partial), brooks (brief)
Discussed on: arch@
Sponsored by: EMC / Isilon Storage Division
Differential Revision: https://reviews.freebsd.org/D5742


# 296124 26-Feb-2016 bdrewery

Import bsd.clang-analyze.mk based on NetBSD's version.

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


# 295380 07-Feb-2016 ngie

Simplify running the FreeBSD test suite

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


# 289725 22-Oct-2015 bdrewery

Let SUBDIR_OVERRIDE with 'make buildworld' be more useful.

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


# 276673 05-Jan-2015 ngie

Bump .Dd again for the change done in r276483

Pointyhat to: me


# 276483 31-Dec-2014 ngie

The variable used with install(1) for stripping should be STRIPBIN, not
STRIP_CMD

MFC after: 3 days
Reported by: lev


# 276309 27-Dec-2014 ngie

Bump .Dd for change done in r275908


# 275908 18-Dec-2014 ngie

Document STRIP_CMD in build(7) and note its importance with LOCAL_ITOOLS

MFC after: 1 week
Phabric: D1335
Reviewed by: brueffer
Sponsored by: EMC / Isilon Storage Division


# 267866 25-Jun-2014 gavin

Drop references to updating over csup from build(7).

MFC after: 1 week


# 267776 23-Jun-2014 bapt

use .Mt to mark up email addresses consistently (part6)

PR: 191174
Submitted by: Franco Fichtner <franco at lastsummer.de>


# 267599 17-Jun-2014 bdrewery

- Add a LOCAL_ITOOLS to allow adding additional tools required for the
installworld and distributeworld targets

PR: 179562
Submitted by: Garrett Cooper <yaneurabeya@gmail.com>
MFC after: 1 week


# 263812 27-Mar-2014 bdrewery

Update build(7) with LOCAL_* vars

PR: docs/178286
Submitted by: Garrett Cooper <yaneurabeya@gmail.com>
Sponsored by: EMC / Isilon Storage Division
MFC after: 1 week


# 241396 10-Oct-2012 jhb

WITH_CTF is now a "normal" build option (WITHOUT_CTF is supported and
MK_CTF is used internally).

Reviewed by: fjoe


# 238008 02-Jul-2012 wblock

Add reference to portsnap(8).

Submitted by: Tim Kientzle
MFC after: 1 day


# 237655 27-Jun-2012 wblock

Point out that /usr/src, /usr/doc, and /usr/ports may be empty or not
exist until populated with csup(1) or svn(1).

PR: 169487
Submitted by: Moritz Wilhelmy
MFC after: 1 day


# 226172 09-Oct-2011 gjb

Bump .Dd to reflect the date of the last content change, so MFC content
makes sense.

Pointy-hat to: gjb (myself)


# 225859 29-Sep-2011 gjb

Whitespace cleanup in build(7).

MFC after: 1 week
Need-MFC: 225858


# 225858 29-Sep-2011 gjb

Document, and provide an example for, PORTS_MODULES in build(7).

PR: 161017
Submitted by: gcooper
MFC after: 1 week


# 223148 16-Jun-2011 ru

It's a bit odd, but "make update" in src/ can also update the ports/,
doc/, and now www/ trees, but only using the "cvsup" transport.

When "make update" is run using a tree's makefile, it can also use
"cvs" (except for www/) and "svn" (only src/).

Clean up documentation and code regarding "make update":

- Increase oddness by adding support for WWWSUPFILE and NO_WWWUPDATE to
Makefile.inc1 (analogous to PORTSSUPFILE/NO_PORTSUPDATE and
DOCSUPFILE/NO_DOCUPDATE; WWWSUPFILE already supported by www/Makefile).

- Document all trees that support CVS_UPDATE.

- Document all trees that support SUP_UPDATE.

- Document SVN_UPDATE.

- Document NO_WWWUPDATE.

- make.conf(5) mistakenly said that *SUPFILE* had defaults.

- Add an example entry for WWWSUPFILE.


# 219857 22-Mar-2011 nwhitehorn

Update release(7) and build(7) to reflect new release infrastructure for
the new installer.


# 218524 10-Feb-2011 jhb

- Add a new UNIVERSE_TARGET variable for 'make universe'. If it is set,
then that target is invoked for each architecture rather than the
default action of building world and kernels for each architecture.
- Add a 'make toolchains' wrapper which uses UNIVERSE_TARGET to build
toolchains for all architectures.
- Document JFLAG, MAKE_JUST_KERNELS, and MAKE_JUST_WORLDS variables for
'make universe'.

Reviewed by: bz
MFC after: 1 week


# 217815 25-Jan-2011 bz

Back out r217734. [1]

Properly document what `make targets` is supposed to list to avoid
further confusion given the place the target sits. Should have happened
with r217125.

Requested by: imp [1]
Reviewed by: rwatson


# 217733 22-Jan-2011 bz

Properly document what the top-level `make tinderbox` does.

Reviewed by: jmallett
MFC After: 3 days
X-MFC: build.7 only


# 214374 26-Oct-2010 gjb

Minor grammar fix.

Submitted by: arundel (via email)
Approved by: jkois (mentor)
Patch by: arundel
MFC after: 5 days


# 206082 02-Apr-2010 netchild

WITH_CTF can now be specified in src.conf (not recommended, there
are some problems with static executables), make.conf (would also
affect ports which do not use GNU make and do not override the
compile targets) or in the kernel config (via "makeoptions
WITH_CTF=yes").

Additional (related) changes:
- propagate WITH_CTF to module builds
- do not add -g to the linker flags, it's a noop there anyway
(at least according to the man page of ld)
- do not add -g to CFLAGS unconditionally
we need to have a look if it is really needed (IMO not) or if there
is a way to add it only when WITH_CTF is used

Note: ctfconvert / ctfmerge lines will not appear in the build output,
to protect the innocent (those which do not build with WITH_CTF would
see the shell-test and may think WITH_CTF is used).

Reviewed by: imp, jhb, scottl (earlier version)
Discussed on: arch@


# 205978 31-Mar-2010 keramida

Document DEBUG_FLAGS in a more visible place, in the build(7) manpage

Noticed by: Alexander Best <alexbestms.at.wwu.de>
Reviewed by: jhb
MFC after: 1 week


# 200599 16-Dec-2009 imp

Forgot to bump .Dd, so do it with this commit. Chose local time over
UTC time for the date...


# 200597 16-Dec-2009 imp

Docmuent NO_KERNEL{CLEAN,CONFIG,DEPEND,OBJ} as necessary. Update
documentation on KERNFAST meaning.


# 187638 23-Jan-2009 imp

Sort KERNFAST and KERNCONF into the list they are in.


# 187637 23-Jan-2009 imp

Document KERNCONF and KERNFAST. Note that TARGET is usually all one
needs to set for cross building.


# 186783 05-Jan-2009 keramida

Document the NO_XXX options supported by our Makefile.inc1.

Noticed by: simon
Reviewed by: imp
MFC after: 1 week


# 174566 13-Dec-2007 imp

BSDMAKE isn't really needed and was removed, so remove here


# 174542 11-Dec-2007 imp

Document BSDMAKE variable that was recently introduced. Also, since
RELENG_7, the way to do a cross build changed from specifying only
TARGET_ARCH (which has an ambigous mapping to TARGET) to specifying
only TARGET (which has a unique mapping to TARGET_ARCH). Update the
example to reflect this.

MFC After: 1 week (the example change only)


# 165208 14-Dec-2006 mpp

Spelling fixes.


# 162901 30-Sep-2006 ru

Markup glitch.


# 162898 30-Sep-2006 ru

Require rpc.lockd(8) only if make is running with the -j option.


# 159501 11-Jun-2006 jkoshy

Cross-reference src.conf(5).


# 158690 17-May-2006 maxim

o Replace alpha-specific DESTDIR to a sparc64 one.

Spotted by: Gennady Proskurin


# 158622 15-May-2006 maxim

o In the cross-build example replace alpha by sparc64.


# 156903 20-Mar-2006 ru

Document the requirement to run rpc.lockd(8) on both client
and server when installing onto an NFS file system.


# 153116 05-Dec-2005 jkoshy

Document the public targets and make variables supported by the
build system.

Reviewed by: ru (multiple passes)


# 152569 18-Nov-2005 ru

-mdoc sweep.


# 151202 10-Oct-2005 yar

Replace "/etc/make.conf" with references to make.conf(5)
where applicable. The main reason for this change is that
the location of make.conf is not constant and can be
modified via __MAKE_CONF. This change also improves
hyper-text linkage in our manpages.

MFC after: 2 weeks


# 148684 03-Aug-2005 ru

Add missing "not" in rev. 1.34.

Submitted by: Jeremie Le Hen


# 148683 03-Aug-2005 ru

Make delete-old* and friends useable for cross-builds.


# 148663 03-Aug-2005 obrien

Document 'kernel-toolchain'.

Submitted by: Jeremie Le Hen <jeremie@le-hen.org>


# 148543 29-Jul-2005 netchild

- Move recently added dir into the correct section.
- Add a note about the organisation of the sections.
- Expand shell globs (they worked in a previous version of the delete-old
target, but not in this one).
- Use the correct way of checking for a native environment. [1]
- Add some more obsolete files.
- Fix some bad english. [1]

Suggested by: ru [1]
Approved by: mentor (joerg)


# 148330 23-Jul-2005 netchild

Add delete-old and delete-old-libs targets:
- removes obsolete files/dirs or libraries.
- works in interactive (default) and batch mode
- respects DISTDIR
- documented in UPDATING and build(7)

The head of the file ObsoleteFiles.inc contains instructions how to add
obsolete files/dirs/libs to the list. Obviously one should add obsolete
files to this list, when he removes a file/dir/lib from the basesystem.

Additionally add check-old target:
- allows re@ to check if a file on the obsolete list resurfaces

Design goals:
- allows full control by the user (default interactive mode)
- possibility of scripted removal of obsolete files (batch mode)
- opt-in removal of files (explicit list of files)
- seperate removal of libs (2 delete targets)

Important design decissions:
- structured list of files to remove instead of a plain text file:
* allows to remove additional files if a NO_foo knob is specified
without the need to change the targets (no NO_foo knob is respected
yet)
- not using mtree like NetBSD does:
* mtree doesn't has an interactive mode

Discussed on: arch (long ago), current (this year)
Additional input from: re (hrs)
Approved by: mentor (joerg)


# 142412 25-Feb-2005 trhodes

Fix a few markup nits in previous commit.

Noticed by: ru, who else? :)


# 142360 24-Feb-2005 trhodes

To be more complete, discuss 'make kernel' since we do cover buildkernel.
Xref config.8.
Bump doc date.


# 133648 13-Aug-2004 ru

Replaced a way outdated and unsafe sequence of upgrading the system
from sources with the link to the relevant section in src/UPDATING.


# 133380 09-Aug-2004 ru

Remove another mention of "make world".


# 130582 16-Jun-2004 ru

Assorted markup, spelling, and grammar fixes.


# 122803 16-Nov-2003 simon

mdoc(7) janitor:
- Use .Aq macro instead of <foo>.
- Kill EOL whitespace.


# 122674 14-Nov-2003 imp

Amplify the reboot requirement


# 122645 14-Nov-2003 imp

Add required reboot into single-user mode step.
# mdoc janitors should make sure I did the markup right

Inspired by: recent problems in this area


# 117335 08-Jul-2003 smkelly

Bring build(7) in sync with src/Makefile by removing documentation
for targets that have been unsupported since April:
- upgrade
- aout-to-elf
- aout-to-elf-build
- aout-to-elf-install
- move-aout-libs

Approved by: imp


# 92798 20-Mar-2002 ru

mdoc(7) police: tidy up.


# 92503 17-Mar-2002 murray

Spell analogous properly.

Found by: ispell(1)


# 92380 15-Mar-2002 murray

Markup fix. Use .Va instead of .Ev. No content changes.


# 92379 15-Mar-2002 murray

Add a description of the TARGET variable, and add more information
about the TARGET_ARCH variable. (1)

Add information about the DESTDIR variable.

Add more examples for cross-building.

(1) Submitted by: ru
MFC after: 3 days


# 92264 14-Mar-2002 murray

Add an ENVIRONMENT section, and document TARGET_ARCH and NO_WERROR.
Add a cross-build example.


# 92215 13-Mar-2002 murray

Reference release(7) in SEE ALSO.


# 82953 04-Sep-2001 ru

mdoc(7) police: sort FILES.


# 82604 30-Aug-2001 alex

Move /etc/defaults/make.conf to /usr/share/examples/etc/make.conf as
discussed on the arch@ mailinglist (after repo-copy).

sys.mk will .error if it finds /etc/defaults/make.conf but include
it anyways (this is the same behaviour as with the make.conf.local
removal).

/usr/share/examples/etc/make.conf has BDEFLAGS commented out now,
since it's only an example file.

Adjust all textes that talk about make.conf or defaults/make.conf to
match the new situation.


# 79727 14-Jul-2001 schweikh

Removed whitespace at end-of-line; no content changes. I simply did
cd src/share; find man[1-9] -type f|xargs perl -pi -e 's/[ \t]+$//'

BTW, what editors are the culprits? I'm using vim and it shows
me whitespace at EOL in troff files with a thick blue block...

Reviewed by: Silence from cvs diff -b
MFC after: 7 days


# 79538 10-Jul-2001 ru

mdoc(7) police: removed HISTORY info from the .Os call.


# 76776 17-May-2001 jhb

Replace references to the KERNEL variable with KERNCONF.


# 75670 18-Apr-2001 ru

mdoc(7) police: normalize .Nd.


# 70466 29-Dec-2000 ru

Prepare for mdoc(7)NG.


# 70017 14-Dec-2000 ru

mdoc(7) police: removed duplicate .Os calls.


# 69860 11-Dec-2000 ru

mdoc(7) police: use canonical form of .Dd macro.


# 69111 24-Nov-2000 ben

Mention mergemaster(8).

Submitted by: obrien


# 69094 23-Nov-2000 ben

Use a more generic name for the compiler cross-reference. (cc instead of
gcc.)

Suggested by: sheldonh (not sholdonh)


# 69093 23-Nov-2000 ben

* Say that ps, top, etc, "may not work" with the new kernel, rather than
"will not work", as in many cases they will.

Suggested by: sholdonh

* Add cross-references to reboot(8) and shutdown(8)


# 69092 23-Nov-2000 ben

Add an example to explain the basic procedure to build the world.

Suggested by: obrien


# 69039 22-Nov-2000 ben

Add two new manual pages to document the various options available in
make.conf, and the /usr/src building process.

PR: 22676
Submitted by: Mike Meyer <mwm@mired.org>
Reviewed by: nik, sheldonh