tools/build/options/WITH_META_MODE

   1 .\" $FreeBSD$
   2 Create
   3 .Xr make 1
   4 meta files when building, which can provide a reliable incremental build when
   5 using
   6 .Xr filemon 4 .
   7 The meta file is created in OBJDIR as
   8 .Pa target.meta .
   9 These meta files track the command that was executed, its output, and the
  10 current directory.
  11 The
  12 .Xr filemon 4
  13 module is required unless
  14 .Va NO_FILEMON
  15 is defined.
  16 When the module is loaded, any files used by the commands executed are
  17 tracked as dependencies for the target in its meta file.
  18 The target is considered out-of-date and rebuilt if any of these
  19 conditions are true compared to the last build:
  20 .Bl -bullet -compact
  21 .It
  22 The command to execute changes.
  23 .It
  24 The current working directory changes.
  25 .It
  26 The target's meta file is missing.
  27 .It
  28 The target's meta file is missing filemon data when filemon is loaded
  29 and a previous run did not have it loaded.
  30 .It
  31 [requires
  32 .Xr filemon 4 ]
  33 Files read, executed or linked to are newer than the target.
  34 .It
  35 [requires
  36 .Xr filemon 4 ]
  37 Files read, written, executed or linked are missing.
  38 .El
  39 The meta files can also be useful for debugging.
  40 .Pp
  41 The build hides commands that are executed unless
  42 .Va NO_SILENT
  43 is defined.
  44 Errors cause
  45 .Xr make 1
  46 to show some of its environment for further debugging.
  47 .Pp
  48 The build operates as it normally would otherwise.
  49 This option originally invoked a different build system but that was renamed
  50 to
  51 .Va WITH_DIRDEPS_BUILD .