chore: Add missing #includes

refactor: Use util::Bytes::insert for span<const uint8_t>

enhance: Add util::Bytes::insert for span<const uint8_t>

refactor: Avoid raw fmt::format call in TextTable

chore: Clean up usage of #include in headers

chore: Tweak formatting and comments

ci: Add new compilers and update actions (#1402)

feat: Add support for -fcallgraph-info (#1401)

fix: Mark -fcallgraph-info as too hard

-fcallgraph-info generates a .ci file which ccache currently doesn't
know how to store and restore.

Fixes #1400.

feat: Port the inode cache to Windows (#1388)

This PR ports the existing InodeCache to make it work under Windows.
This speeds up ccache a lot, both in the hit and miss cases, when a lot
of headers files are included in several compilation units. In our case
this makes the difference between ccache being worth using or not.

The logic of the InodeCache itself is unchanged. I introduced a
MemoryMap helper class that does the platform specific calls to
mmap/MapViewOfFile. Despite its generic name, I've implemented what was
needed for the InodeCache, it only supports mapping a file (no anonymous
mmap) in a shared fashion with read/write access.
Due to differences in behavior between unix and Windows regarding
unlinking a file that is opened, I am not convinced that it will work
correctly in every situation (for example if a process hold a bucket
lock for more than 5 seconds, the cache is dropped and recreated, under
Windows that won't work as the unlink will fail). That being said it
seems to work well enough when nothing unexpected happens.

I made a small change to the unit test because under Windows, we can't
open() a directory so instead I try to open a temp file in that
directory. After that change the unit tests pass unmodified.
For the bash based test, only the symbolic link test fails. This is
quite strange, when I try to run the test, the call to `ln -fs test1.c
test2.c` fails, but when run manually the same command succeeds. I tried
to run the test manually and it fails anyway but I haven't done anything
to fix it, this looks like more an issue from the DirEntry side than the
InodeCache side. Because of that I've left the bash based test disabled
for Windows, maybe we want to change that to only disable the symbolic
link test?

chore: Use brace initialization for integer literals

chore: Bail out on too large files on 32-bit systems

chore: Improve log messages for selected compression level

perf: Avoid value initialization of data in util::Bytes

fix: Fix reading of files larger than 2^31 bytes

For some kernels read(2) makes a short read for counts larger than 2^31,
even for files on 64-bit architectures. Other kernels seem to not like
large counts at all, returning a failure.

Fix this by limiting the read buffer to a smaller value. This also
removes a short read optimization which should have been removed in
cff3bf417420ea88fe53e7267ae2a356898ae326.

chore: Further improve /Tc and /Tp handling

- Remember if /Tc or /Tp was used and prepend it to the source file sent
  to the preprocessor and compiler.
- Mark non-concatenated versions of /Tc and /Tp as too hard for now.

chore: Fix grammar in NEWS

chore: Update NEWS

(cherry picked from commit ec510e9b0f333b8e97aee98108de3e0858340d59)

chore: Update copyright years

fix: Fix MSVC crash when using /Zi /Fddebug.pdb

With /Zi, MSVC starts a long-lived mspdbsrv.exe background process. The
implementation of #1274 kills all processes created by ccache including
mspdbsrv.exe, which can make cl.exe crash with this error message:

    fatal error C1090: PDB API call failed, error code '23': (0x000006BA)

Fix this by setting JOB_OBJECT_LIMIT_SILENT_BREAKAWAY_OK to only kill
the compiler and not processes that the compiler creates.

Fixes #1386 in a better way.

chore: Undo revert in "Fix MSVC crash when using /Zi /Fddebug.pdb"

In preparation for solving #1386 while keeping the essence of #1274.

This reverts commit a2bf2956d78599b2397081a9e7b253a569c7c932.

fix: Don't crash on full disk when recompressing the cache

chore: Make implementation of /Tc and /Tp actually work

In addition to 7b8aaf562feb.

fix: Detect bad remote storage URLs gracefully again

Regression in 829f93c48f21.

Fixes #1394.

feat: Add support for MSVC /Tc and /Tp options

Closes #1387.

bump: Upgrade to fmt 10.2.1

refactor: Simplify Statistics::format_machine_readable slightly

bump: Upgrade to cpp-httplib 0.15.2

fix: Fix MSVC crash when using /Zi /Fddebug.pdb

This commit reverts 8e3ada3f830ad0e7d3ddf4eaf2b16e695bd084e4 (#1274).

Fixes #1386.

feat: Let --inspect retain atime if possible

For storage that relies on atime for LRU cleanup purposes, it makes
sense not to affect atime when inspecting cache entries.

perf: Remove now unnecessary fs::path::string calls

refactor: fs::path-ify core::CacheEntry::Header

perf: Use util::PathString instead of fs::path copy

enhance: Add util::PathString

chore: Remove obsolete section from LICENSE.adoc

chore: Fix some clang-tidy warnings

feat: Add support for MSVC /Yc option (precompiled headers) (#1384)

feat: Add `--print-stats` format selection, JSON format (#1382)

feat: Add `--print-log-stats` (#1381)

This adds a "machine readable" variant of `--show-log-stats`, similar to
`--print-stats` as a variant of `--show-stats`.

chore: Remove left-over debug comment

fix: Disable caching for modified source/include files

On a cache miss, ccache opts out of the direct mode when a "too new"
include file is found. This is done to avoid a race condition in the
direct mode when a header file if modified after ccache is invoked but
before the compiler is executed. Modifying the main source code file is
not a race condition when "run_second_cpp = false", which was the case
at the time the direct mode was introduced. However, the default of
run_second_cpp was changed to true in ccache 3.3, and the potiential
race condition then exists for both the source and the include files.

Fix this by disabling caching completely (not only the direct mode) when
modification of a source/include file is detected.

Closes #1378.

feat: Allow any prefix in prefix_command(_cpp) options

The prefix_command and prefix_command_cpp configuration options require
that the prefixes can be found in PATH.

This commit relaxes this requirement so that a relative prefix can be
used and a prefix program can have arguments.

refactor: fs::path-ify util::is_dev_null_path

enhance: Add Args::push_back(std::string&& arg)

chore: Remove time_of_compilation in favor of time_of_invocation

We can compare source/include files against time of invocation just as
well; source files shouldn't be modified when ccache has started anyway.

refactor: Move Util::is_absolute_path_with_prefix to util

refactor: Use std::string_view in compopt functions

fix: Avoid crash for -arch as last compiler option

The bug has been present since 89aa39f394e0fa4935e6cadd7184e372a37f9506
(ccache 3.3).

Fixes #1377.

refactor: Convert usage of Util::remove_extension to std::filesystem

refactor: Convert usage of Util::dir_name to std::filesystem

enhance: Add wrapper of std::filesystem::equivalent

refactor: Convert usage of Util::change_extension to std::filesystem

refactor: Convert usage of Util::get_extension to std::filesystem

refactor: Convert usage of util::real_path to std::filesystem

test: Add test of core::rewrite_stderr_to_absolute_paths

refactor: Convert usage of Util::base_name to std::filesystem

enhance: Add wrapper of std::filesystem::is_regular_file

refactor: fs::path-ify TestUtil

chore: Update authors

chore: Update NEWS

ci: Add typos job

ci: Bump to codespell 2.2.6

feat: Add support for undocumented GCC/Clang --include option

Note: Clang accepts a concatenated argument (--includefoo.h) but GCC
does not.

Closes #1324.

bump: Upgrade to cpp-httplib 0.14.3

chore: Remove unused local variable

chore: Add debug log when finding -frecord-gcc-switches

build: Set both C/CXX launchers if either is set (#1343)

Add cmake/EnableCcache.cmake and load it from the main file.

Make the standard cmake variables CMAKE_CXX_COMPILER_LAUNCHER and
CMAKE_C_COMPILER_LAUNCHER consistent with each other if either is not
set.

Signed-off-by: Rafael Kitover <rkitover@gmail.com>

feat: Support st_Xtimensec fields in struct stat

This increases file timestamp precision on some BSD-based OSes.

Closes #1369.

fix: Generalize expansion of remote storage URLs with sharding

Fixes #1321.

fix: Correct util::LockFile sleep time constants

Regression in 930d3b67a49f.

refactor: Replace util::is_absolute_path with fs::path::is_absolute

chore: Fix some -Wconversion warnings

fix: Handle -Xclang -ast-dump et al correctly

Fixes #1356.

feat: Improve processing of input file arguments

Instead of checking if a non-option argument has a known file extension,
switch to the better heuristic of checking if the file exists or not: if
it doesn't exist it isn't an input argument.

fix: Use MSVC logic for clang-cl when handling precompiled header (#1365)

chore: Improve typos configuration (#1358)

ci: Remove matrix.config from build.yaml (#1360)

ci: Split dependency installation step into two (#1359)

test: Fix regex in direct.bash (#1357)

fix: Detect compiler from unresolved symlink with fallback

This is a generalization of the fix in PR #1348 for issue #1347.

chore: Remove obsolete Util::is_dir_separator

chore: Remove superfluous #includes

fix: Detect symlink called clang-cl as clang-cl (#1348)

Fixes #1347.

feat: Add support for clang --analyze (#1345)

fix: Devmode unused function warnings on new MSVC (#1342)

MSVC apparently has overrides for the two definitions of operator== in
unittest/test_util_string.cpp in the <utility> header, raising a warning
about them being local unused functions:

https://learn.microsoft.com/en-us/cpp/error-messages/compiler-warnings/compiler-warning-level-4-c4505?view=msvc-170

Disable this warning type in cmake/DevModeWarnings.cmake for MSVC.

Signed-off-by: Rafael Kitover <rkitover@gmail.com>

feat: cmake -DOFFLINE=TRUE for offline builds (#1341)

Add the cmake option OFFLINE, defaulting to the value of the standard
variable FETCHCONTENT_FULLY_DISCONNECTED, which is OFF by default, to
disable downloading anything from the internet.

When ON, set FETCHCONTENT_FULLY_DISCONNECTED to ON, ZSTD_FROM_INTERNET
to OFF and HIREDIS_FROM_INTERNET to OFF.

When downloading is OFF and either library is not found, throw an error
using find_package_handle_standard_args().

Add the option to INSTALL.md doc.

Signed-off-by: Rafael Kitover <rkitover@gmail.com>

fix: cmake -DSTATIC_LINK=ON on Linux/macOS (#1340)

Make linking dependent libraries as static a hard requirement when
STATIC_LINK is ON, as opposed to the previous behavior of falling back
to dynamic libraries.

A side-effect of this is that if only a dynamic zstd/hiredis is
available on a system, it will not be found, and the download and build
code will be invoked to build a static version from the internet.

Add a general case to handle Linux, macOS and similar by linking
libgcc/libstdc++ statically on gcc/clang.

Move the code into cmake/StaticLinkSupport.cmake and include it from the
main file.

Fix #1330

Signed-off-by: Rafael Kitover <rkitover@gmail.com>

fix: Mark -wrapper as too hard

See also #1339.

docs: Improve language

refactor: Use fs::weakly_canonical in prepare_debug_path

fix: Make handling of Clang config options more robust

Closes #1335.

fix: Fix Windows is_absolute_path() crash on drive letter (#1338)

fix: Fix sign-compare warning src/InodeCache.cpp on FreeBSD (#1331)

As on FreeBSD 13.2 statfs.f_bavail is signed, InodeCache.cpp cannot be compiled
but gets a sign-compare warning:

  src/InodeCache.cpp:409:30: error: comparison of integers of different signs:
    'long' and 'unsigned long' [-Werror,-Wsign-compare]
      if (buf.f_bavail * 512 < k_min_fs_mib_left * 1024 * 1024) {
          ~~~~~~~~~~~~~~~~~~ ^ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1 error generated.

The problem is avoided by using static_cast to uint64_t.

fix: Let DirEntry::size_on_disk return likely size on disk

st_blocks in struct stat cannot be trusted for some filesystems that do
transparent compression or deduplication. For instance, ZFS can adjust
the block count some time in the future when compression is finished.

The only reasonable fix for this seems to be to just guess how much
space the file will take using st_size.

Fixes #1332.

fix: Bail out on too hard options -fmodules-ts and -fmodule-header

Fixes #1333.

chore: Add entries to codespell allow list

refactor: Move Logging to util

refactor: Move Win32Util::error_message to util

refactor: Move Win32Util::argv_to_string to util

refactor: Move Win32Util::add_exe_suffix to util