tools/build/options/WITH_CCACHE_BUILD

   1 .\" $FreeBSD$
   2 Set to use
   3 .Xr ccache 1
   4 for the build.
   5 No configuration is required except to install the
   6 .Sy devel/ccache
   7 package.
   8 When using with
   9 .Xr distcc 1 ,
  10 set
  11 .Sy CCACHE_PREFIX=/usr/local/bin/distcc .
  12 The default cache directory of
  13 .Pa $HOME/.ccache
  14 will be used, which can be overridden by setting
  15 .Sy CCACHE_DIR .
  16 The
  17 .Sy CCACHE_COMPILERCHECK
  18 option defaults to
  19 .Sy content
  20 when using the in-tree bootstrap compiler,
  21 and
  22 .Sy mtime
  23 when using an external compiler.
  24 The
  25 .Sy CCACHE_CPP2
  26 option is used for Clang but not GCC.
  27 .Pp
  28 Sharing a cache between multiple work directories requires using a layout
  29 similar to
  30 .Pa /some/prefix/src
  31 .Pa /some/prefix/obj
  32 and an environment such as:
  33 .Bd -literal -offset indent
  34 CCACHE_BASEDIR='${SRCTOP:H}' MAKEOBJDIRPREFIX='${SRCTOP:H}/obj'
  35 .Ed
  36 .Pp
  37 See
  38 .Xr ccache 1
  39 for more configuration options.