README.md: Fix and improve links to installation instructions

Closes #633.

Add new absolute_paths_in_stderr (CCACHE_ABSSTDERR) feature

Motivation for the feature: When using the “Unix Makefiles” generator
with CMake, the compiler is executed in a different CWD than the “make”
command. This works well since absolute paths are passed to the
compiler. But combined with ccache’s base_dir feature the paths in
compiler error or warning messages will be incorrect since they will be
relative to the CWD of the compiler, not the CWD where the user or IDE
ran “make”. absolute_paths_in_stderr helps with this problem by
rewriting relative paths to absolute paths in the compiler’s stderr
output so that the user or IDE will see valid paths.

Util::send_to_stderr: Refactor to take Context parameter

Make testdir/failed symlink correct

Regression in d575526c91a8.

Avoid reading outside input in expand_environment_variables

The edge case of an input “$” without a following variable name was not
ported correctly in ab3c68b266d0d2d24c46dd1ef32e74e35ec388d6.

Use XDG base directories by default

ccache will now follow the XDG Base Directory Specification
(https://specifications.freedesktop.org/basedir-spec/) by default so
that:

- the cache directory is $XDG_CACHE_HOME/ccache (or $HOME/.cache/ccache
  if XDG_CACHE_HOME is not set), and
- the (primary) configuration file is
  $XDG_CONFIG_HOME/ccache/ccache.conf (or
  $HOME/.config/ccache/ccache.conf if XDG_CONFIG_HOME is not set).

On macOS, the fallback cache directory is $HOME/Library/Caches/ccache
and the fallback configuration file is
$HOME/Library/Preferences/ccache/ccache.conf. On Windows, the fallback
cache directory is %APPDATA%/ccache and the fallback configuration file
is %APPDATA%/ccache/ccache.conf.

Exceptions:

1. If CCACHE_CONFIGPATH is set, use that path for the configuration
   file.
2. If CCACHE_DIR is set (or ccache_dir in the secondary configuration),
   use that path for the cache directory and $CCACHE_DIR/ccache.conf for
   the configuration file.
3. If the legacy $HOME/.ccache directory exists, use that cache
   directory and $HOME/.ccache/ccache.conf for the configuration file.

Closes #191.

Upgrade to fmt 7.0.3

Add -d/--directory option

The option makes subsequent command line options operate on the given
cache directory instead of the default.

Add --checksum-file option for debugging/evaluating checksums

Add and use Util::read_fd helper function

Remove unused typedefs

Pretty-print binary data in .ccache-input-text files

This happens when the i-node cache is enabled.

Upgrade to zstd 1.4.5

Fixes #631.

Use nullptr instead of NULL

Remove superfluous include of cstdint/stdint.h

It’s included implicitly by cinttypes.

Improve name of add_extra_arg function

Upgrade to BLAKE3 0.3.6

Improve building via Docker

- Simplified names (e.g. ubuntu-14-trusty -> ubuntu-14.04,
  debian-9-stretch -> debian-9).
- Enabled debian-9 in misc/test-all-systems since it works.
- Renamed centos to centos-7.
- Added centos-8 and fedora-32.
- Updated dockerfiles/README to match reality after the conversion to
  CMake.
- Cleaned up Dockerfiles.
- Improved misc/test-all-systems.
- Removed unsupported Clang build for alpine-3.4, centos-7 and
  ubuntu-14.04.

Upgrade to fmt 7.0.2

color_diagnostics test: Fix race conditions on some platforms

script(1) returns early on some platforms (leaving a child process
living for a short while) and the output may therefore still be pending.
Work around this by sleeping until the output file has content.

CCACHE_PREFIX test: Fix failure for GCC <4.9

The CCACHE_PREFIX test logs execution of prefixes. After
1c6ccf18c2e04459b1ac76ede4580b3ddcd27bbe (#596) the compiler and
prefixes can be run twice if GCC doesn’t support -fdiagnostics-color and
the test case is not prepared for that. Fix this by letting prefix-a
truncate the log file.

ci/build: Make it possible to specify CC for tests

Don’t look up or store tmp stderr files in i-node cache

The tmp.cpp_stderr file produced by the preprocessor is looked up and
stored in the i-node cache, which is wasted effort since it’s a
temporary file.

Don’t depend on which(1) to detect commands

Only define clone_file when it’s supported

This avoids warnings that the function can be marked [[noreturn]] in the
!FILE_CLONING_SUPPORTED case.

Improve Clang modules test suite

- Backdate modified header so that the test actually tests content and
  not bails out early due to too new header timestamp.
- Verify that modifications to module.modulemap are detected, which is
  key to how the modules support works.

Remove unnecessary compiler behavior test in modules test suite

The “preprocessor output” test in the modules test suite only tests
compiler behavior, and the string it looks for in the preprocessed
output is different for older and newer Clang versions. It seems like a
kind of a probing call, but I don’t see why we would want to probe the
compiler behavior in this case so I’ll just remove it.

Fixes #601.

Work around missing std::is_trivially_copyable in GCC < 5

Retrieve non-const pointer to std::string data without casting

Replace failed function with throwing Failure exception explicitly

I think that this improves code readability since it’s more clear what
the code flow is.

Clean up system.hpp

Clean up ccache.hpp

Fix comment to match reality regarding process_preprocessed_file

Let Error constructor forward arguments to fmt::format

Replace fatal function with throwing FatalError exception explicitly

I think that this improves code readability since it’s more clear what
the code flow is.

Use fmt::print instead of (f)printf

Remove superfluous .c_str() calls

C++-ify path_max

Convert cc_log calls to Logging::log

C++-ify logging routines

- Simplified and C++-ified logging code.
- Added Logging::log and Logging::bulk_log functions corresponding to
  the old cc_log and cc_bulklog functions. The new functions pass their
  arguments to fmt::format.
- Replacements:
  * init_log → Logging::init
  * cc_log → Logging::log
  * cc_bulklog → Logging::bulk_log
  * cc_log_argv → Logging::log plus Util::format_argv_for_logging
  * cc_dump_debug_log_buffer -> Logging::dump_log
- A legacy cc_log implementation is still available so that logging can
  be converted gradually to the new functionality.

Add missing “Util::” test case prefix

Move logging.cpp’s print_command to Util

Let CCACHE_UMASK apply only to files/directories in the cache directory

Ever since the CCACHE_UMASK setting was added in
75dd382407a36b3ebab36bb1027eb43a07498bec it has applied to all files
created by ccache, including files such as the object files and
executables created when ccache is called for linking. This was
presumably the easy thing to do, but it affects the observable output
from the compiler. There are also two related bugs:

1. CCACHE_UMASK is not used when creating the initial configuration file.
2. CCACHE_UMASK is used when creating the log file.

Fix this by:

- saving the original umask in Context,
- introducing a UmaskScope class,
- using UmaskScope objects to set the original umask when calling the
  compiler and when copying result files from the cache, and
- setting the umask after creating the log file but before creating the
  initial configuration file.

Closes #628.

ResultRetriever: Clear m_dest_data between entries

m_dest_data accidentally keeps its data between result entries so if an
entry has both stderr and dependency file data the stderr data will end
up in the dependency file as well. Fix this by clearing m_dest_data
properly.

Regression in 1cbaa89d1175c906bea48e40eb8f5e8c56b5afe4.

Fixes #629.

Remove now empty legacy_util.[hc]pp files

Move time_seconds function to MiniTrace.cpp where it’s used

Move set_cloexec_flag to Util

C++-ify x_rename

Remove unnecessary x_exit function

It’s no longer necessary to use it after
91aa70754c3816537b080fef1c6630313b400721.

C++-ify update_mtime

C++-ify is_full_path

Convert FATAL macro to a function

C++-ify get_home_directory

Inline Util::{starts,ends}_with

Remove now unused str_eq, str_startswith and str_endswith macros

Remove last usage of legacy str_startswith macro

Remove superfluous includes of ccache.hpp

Fix fmt::format error

Introduced in ed21c1feb83f62b9a2d04e959e9a3abd4eac2879.

Add Util::localtime, abstracting localtime_r

Fix cherry-pick mistake in 71edf04aa2c7

Remove redundant check in parse_duration after f93c55832ee3

C++-ify x_unsetenv

C++-ify x_setenv

Move get_hostname to Util

C++-ify parts of ccache.cpp

C++-ify hashutil functions

Use std::string in InodeCache APIs

C++-ify is_precompiled_header and move to Util

Remove superfluous hash_from_int function

C++-ify, and clean up usage of, add_exe_ext_if_no_to_fullpath

C++-ify win32argvtos

Rename win32compat to Win32Util

C++-ify execute functions

Tweak function comment

Remove obsolete struct pending_tmp_file declaration

Convert fatal() function to macro that forwards to fmt::format

C++-ify {copy,write}_fd

Add .mailmap entry for Arne Hasselbring

Fix comments to match reality

Remove now unused legacy format function

Remove last usages of the legacy format function

C++-ify same_executable_name

Use more natural order of ColorDiagnostics enum values

Remove now unused legacy x_strdup function

C++-ify {clone,copy,move}_file

Fix build with Clang 10

Clang 10 says “error: explicitly defaulted move constructor is
implicitly deleted [...] note: move constructor of 'TemporaryFile' is
implicitly deleted because base class 'NonCopyable' has a deleted move
constructor”, so we’ll just have to do without NonCopyable. The effect
will be the same in pracice due to the “Fd fd” member not being
copyable.

Remove now unused legacy x_strndup function

C++-ify parsing of ccache options

Remove now unused legacy reformat function

C++-ify parse_size_with_suffix

C++-ify subst_env_in_string

Add missing curly braces

Simplify and clean up parse_duration_with_suffix_to_seconds

Move and convert parse_unsigned to Util::parse_uint32

Keep argument lists and function implementations sorted

Improve documentation of --evict-older-than

C++-ify stats functions

C++-ify format_{human_readable_size,parsable_size_with_suffix}

Add --evict-older-than (#605)

The argument adds another mechanism to control contents of cache directory. And
is based on the LRU tracking behaviour.

As of now there is no way for ccache to eliminate files which were
are no longer needed. As a result these files stay and are kept around until
either max_files/max_size is reached.

If a particular project is being built regularly but for some reason is allowed
to grow in size, then under such circumstances using the LRU mechanism to control
cache size, lends as perfect solution.

The argument takes a parameter N and performs a cleanup.
While performing cleanup the oldest file in ccache can
only be N seconds old. However this cleanup will not take max_files and
max_old into consideration

Let ResultRetriever collect and operate on the full dependency data

When rewriting the dependency target (#592) the target can in theory
span chunk boundaries, so let ResultRetriever collect and operate on the
full data, just like the stderr output.