enhance: Only keep atime if needed

- For the --recompress case, only reset timestamps if mtime has changed
  since local cache LRU cleanup always uses mtime.
- For the --trim-dir/--trim-recompress case, always reset timestamps
  since atime may be used for LRU cleanup.

feat: Add --trim-recompress and --trim-recompress-threads

Note: Reading the header to check the current compression level affects
atime, so we need to restore atime even when recompression is not
performed.

refactor: Extract file recompression code to a class

enhance: Add Util::format_human_readable_diff

feat: Improve Util::format_human_readable_size for small sizes

feat: Add --recompress-threads option

fix: Fix edge case where a non-temporal identifier is misidentified (#1227)

If a non-temporal identifier, that ends with a temporal macro, happens
to be at the end of the buffer with the temporal suffix starting on the
avx boundary, then it would be incorrectly classified as a temporal
macro. This since the helper function lacks the context to see that the
data before the match is something that invalidates the match.

chore: Update NEWS

chore: Fix typo

bump: Upgrade to hiredis 1.1.0

fix: Avoid race condition in inode cache for quick updates

The inode cache has a race condition that consists of these events:

1. A file is written with content C1, size S and timestamp (ctime/mtime)
   T.
2. Ccache hashes the file content and asks the inode cache to store the
   digest with a hash of S and T (and some other data) as the key.
3. The file is quickly thereafter written with content C2 without
   changing size S and timestamp T. The timestamp is not updated since
   the file writes are made within a time interval smaller than the
   granularity of the clock used for file system timestamps. At the time
   of writing, a common granularity on a Linux system is 0.004 s (250
   Hz).
4. The inode cache is asked for the file digest and the inode cache
   delivers a digest of C1 even though the file's content is C2.

To avoid the race condition, the inode cache now only caches inodes
whose timestamp was updated more than two seconds ago. This conservative
value is chosen since not all file systems have subsecond resolution.

Fixes #1215.

fix: Fall back to emulation for unsupported posix_fallocate (#1222)

posix_fallocate can return EINVAL if filesystem doesn't support it. Fall back to emulation in this case.

E.g. ZFS does so on FreeBSD (haven't tested with ZFS on linux).

This fixes Utill::fallocate unit tests on ZFS.

fix: Use $XDG_RUNTIME_DIR/ccache-tmp as the default temporary directory

See discussion in #1221.

test: Test TimePoint::nsec_decimal_part

fix: Fix bug in Duration arithmetic operators

The bug only affected LongLivedLockFile, which is not used yet.

perf: Optimize util::write_file for empty data

fix: Do not create /run directory on systems that don't have it (#1221)

doc: Don't mention removed compiler type "pump"

The implementation was removed in
2044fea84b86001b2976ecde946d3d6d0e88ec0a.

doc: Add hint about using -fno-pch-timestamp for PCH with Clang

doc: Improve description of header file handling after 24cfb7998c27

fix: Don't consider temporary files incompressible

fix: Properly wait for recompression jobs if there is no f subdir

enhance: Make subsequent calls to ThreadPool::shut_down NOPs

doc: Remove superfluous right parenthesis

refactor: Avoid changing loop variable in body of for loop

This is to please CodeQL's "For loop variable changed in body" check.

refactor: Remove empty if clause

This is to please CodeQL's "Futile condition" check.

fix: Avoid duplicate magic header in --inspect

chore: Sort file list

chore: Improve inode cache logging

doc: Fix indentation

fix(http-storage): Report connection timeout properly

ci: Don't run CodeQL on unit tests

Too many annoying false positives, like "Unused static function" for all
unit tests.

ci: Refactor ci/build script

chore: Update NEWS

doc: Mention the default value of keep_comments_cpp

chore: Fix grammar in comment

feat: Include I_MPI_CC/I_MPI_CXX in the input hash

The I_MPI_CC and I_MPI_CXX variables affect which underlying compiler
ICC uses. Reference:
<https://www.intel.com/content/www/us/en/develop/documentation/
mpi-developer-reference-windows/top/environment-variable-reference/
compilation-environment-variables.html>.

Closes #1210.

chore: Improve inode cache logging

- Only log inode cache hits/misses in debug mode.
- Always log accumulated inode statistics at program exit.

feat: Support -Wp,-M[M]D with -o without -MMD/-MQ/-MT for GCC and Clang

Closes #1203.

test: Silence progress messages from CCACHE_UMASK test

test: Silence Clang warnings about unused arguments during compilation

test: Remove left-over fi statement

fix: Fix parsing of sloppiness with trailing delimiter

fix: Avoid redundant slash in HTTP storage URLs with subdirs

fix: Hash variables that affect Clang version on macOS

Fixes #1205.

chore: Tweak comments

chore: Improve logging of file read failures

chore: Update authors

chore: Update NEWS

fix: Process the argument following a -Xarch argument (#1199)

Since there are already checks enforcing that all -Xarch arguments match
each other and -arch, we can assume that the compiler would also
interpret the following argument, so ccache should interpret it too.

Fixes #1198.

fix: Use configured umask for command line operations like --zero-stats

Closes #1197.

test: Disable flaky Windows profiling tests

build: Include limits.h for PATH_MAX

Note: The C++ climits header does not guarantee to define PATH_MAX.

Fixes #1193.

fix: Use separate 32-bit and 64-bit inode cache files

The memory layout of the shared region differs between 32-bit and 64-bit
ccache binaries, so use different inode cache files.

build: Apply standard settings and warnings to lockfile test (#1195)

This ensures the required include of `config.h` to get `mode_t` defined on Windows.

chore: Correct contributor in NEWS

chore: Update NEWS

ci: Avoid using deprecated GitHub set-output command

Reference:
<https://github.blog/changelog/
2022-10-11-github-actions-deprecating-save-state-and-set-output-commands/>

ci: Add GCC 8 and GCC 9 jobs

build: Remove unneeded C++11 flag in libatomic test (#1191)

The required C++ is 17 anyway.

build: Support compilation with GCC 8 (#1190)

See https://discourse.cmake.org/t/correct-way-to-link-std-filesystem-with-gcc-8/4121

fix: Handle -MD/-MMD when compiling assembler file

When compiling an assembler file, -MD and -MMD don't produce any
dependency file, so don't expect one.

Also, make sure to fall back to running the real compiler in case an
expected output file is missing instead of exiting with an error.

Fixes #1189.

chore: Remove unused no-response bot config

doc: Fix markup in NEWS

chore: Update NEWS

doc: Improve manual

doc: Fixed markup of __NAME__ macros

refactor: Avoid an extra data copy when rewriting stdout

test: Simplify util::read_file_part test

enhance: Add more util::Bytes::insert variants

refactor: Rename ShowIncludesParser to MsvcShowIncludesOutput

I think that this is more in line with what the namespace represents. I
also renamed ShowIncludesParser::tokenize to
MsvcShowIncludesOutput::get_includes since it's not returning generic
tokens but specifically includes files.

chore: Tweak code related to auto depend mode for MSVC

doc: Tweak manual and comments related to /showIncludes

chore: Add news for version 4.6.3

chore: Tweak README

chore: Update authors

ci: Remove Ubuntu 18.04 jobs and add GCC 12 job (#1180)

It is deprecated.

See https://github.blog/changelog/2022-08-09-github-actions-the-ubuntu-18-04-actions-runner-image-is-being-deprecated-and-will-be-removed-by-12-1-22/

Add GCC 12 on Ubuntu 22.04.

build: Add headers to CMake project files (#1178)

Useful for listing them in the IDE project tree, for IDEs that use
CMake file api (like Qt Creator).

feat: Support auto depend mode for MSVC without /showIncludes (#1176)

If MSVC is executed *without* /showIncludes, and ccache is configured with
depend mode, add /showIncludes and strip the extra output from stdout.

ci: Remove clang64 msys target from ci (#1179)

It frequently fails to install packages.

test: Make the integration tests work under Windows (#1133)

Adapted the integration test scripts to be able to run on Windows.

- Added the ".sh" extension to most shell scripts. It looks like Windows needs
  this to run the scripts.
- Added special handling of carriage return characters.
- Tests that fail are deactivated for the moment.
- Added additional runners in different Msys2 environments.
- Disabled the remote_http tests "Basic auth required" and "Basic auth failed"
  due to intermittent failures.
- Disabled PCH tests for MSYS/Clang.

Co-authored-by: R. Voggenauer <rvogg@users.noreply.github.com>

build: Add missing source file extension

feat: Support depend mode for MSVC (#992)

Based on -showIncludes, which prints included files on stdout with a
certain text prefix. Otherwise pretty similar to depend mode handling
for GCC.

This makes MSVC building way faster.

Co-authored-by: Luboš Luňák <l.lunak@centrum.cz>

chore: Clean up code slightly

fix: Remove usage of deprecated codecvt header (#1172)

Based on https://stackoverflow.com/a/69410299/764870.

refactor: Store compiler output as bytes

As discussed in #1173.

enhance: Add util::to_string instantiations for Bytes and span

test: Add tests for util::to_string and util::to_string_view

fix: Handle spaces between target and colon in dependency files (#1166)

Support dependency files that are generated with spaces between the target and
the colon sign.

test: Add another depend mode test (#1174)

The first test exercises a relative path only identical generation.

The second test exhibits a known limitation when the same test case is done with
an absolute path (depend file is wrong).

fix: Retain line CRLF in compiler output on Windows (#1173)

When the cached data is read, the output to fd is binary
(Util::send_to_fd), so in order to maintain the original
line endings, the output must be stored as binary too.

Revert "feat: Support auto depend mode for MSVC without /showIncludes (#1158)"

This reverts commit 8b65880b5ad817156b58c58b5133aafc99b0a264.

See <https://github.com/ccache/ccache/pull/1158#issuecomment-1268748557>.

feat: Support auto depend mode for MSVC without /showIncludes (#1158)

Co-authored-by: Luboš Luňák <l.lunak@centrum.cz>

build: Use pkgconfig for zstd search (#1169)

fix: Capture MSVC stdout/stderr when running from Visual Studio (#1170)

fix: Fix implementation of unsetenv on Windows (#1171)

doc: Sort sloppiness values by name

feat: Improve handling of -frandom-seed and description of sloppiness

I should not be necessary to distinguish between existence and
non-existence of -frandom-seed if random_seed sloppiness is requested,
so don't hash the "-frandom-seed=" part either.

feat: Add sloppiness for -frandom-seed (#1168)

feat: Improve statistics for remote hits/misses

ccache collects statistics about local and remote storage layer get/put
operations and describes them as "local/remote hits/misses" in the
output of "ccache -s". However, since "hits" and "misses" mean "result
hit/miss" in the "cacheable calls" section, it's easy to think that they
measure the same thing.

This commit improves the situation by:

- Adding new "local/remote hits/misses" counters that mean "result
  hit/miss". These are shown if remote storage is used (since they
  otherwise are redundant and equal to the normal "hits/misses"
  counters) or if the -v/--verbose option is given.
- Presenting the previous "local/remote hits/misses" counters as
  "local/remote reads". Only shown in verbose mode.
- Adding "local/remote writes" counters. Only shown in verbose mode.

Closes #1016.