mirror of
https://github.com/opnsense/src.git
synced 2026-04-06 01:45:12 -04:00
29f227c144
This will print a set of variables from make on error using MAKE_PRINT_VAR_ON_ERROR. It is already enabled for the DIRDEPS_BUILD. It may make sense to enable this in the non-meta mode as well once people are more used to its more verbose error output. This makes it much simpler to see which .meta file is used when a command files so that it may be inspected for the build command. Suggested by: sjg Approved by: re (implicit) Sponsored by: EMC / Isilon Storage Division
54 lines
1.4 KiB
Text
54 lines
1.4 KiB
Text
.\" $FreeBSD$
|
|
Creates
|
|
.Xr make 1
|
|
meta files when building, which can provide a reliable incremental build when
|
|
using
|
|
.Xr filemon 4 .
|
|
The meta file is created in the OBJDIR as
|
|
.Pa target.meta .
|
|
These meta files track the command ran, its output, and the current directory.
|
|
The
|
|
.Xr filemon 4
|
|
module is required unless
|
|
.Va NO_FILEMON
|
|
is defined.
|
|
When the module is loaded, any files used by the commands executed will be
|
|
tracked as
|
|
dependencies for the target in its meta file.
|
|
The target will be considered out-of-date and rebuilt if any of the following
|
|
are true compared to the last build:
|
|
.Bl -bullet -compact
|
|
.It
|
|
The command to execute changes.
|
|
.It
|
|
The current working directory changes.
|
|
.It
|
|
The target's meta file is missing.
|
|
.It
|
|
The target's meta file is missing filemon data when filemon is loaded
|
|
and a previous run did not have it loaded.
|
|
.It
|
|
[requires
|
|
.Xr filemon 4 ]
|
|
Files read, executed or linked to are newer than the target.
|
|
.It
|
|
[requires
|
|
.Xr filemon 4 ]
|
|
Files read, written, executed or linked are missing.
|
|
.El
|
|
The meta files can also be useful for debugging.
|
|
.Pp
|
|
The build will hide commands ran unless
|
|
.Va NO_SILENT
|
|
is defined.
|
|
Errors will cause
|
|
.Xr make 1
|
|
to show some of its environment for further debugging.
|
|
.Pp
|
|
The build operates as it normally would otherwise.
|
|
This option originally invoked a different build system but that was renamed
|
|
to
|
|
.Va WITH_DIRDEPS_BUILD .
|
|
.Pp
|
|
Currently this also enforces
|
|
.Va WITHOUT_SYSTEM_COMPILER .
|