chore: Sort codespell allowlist

refactor: Make Util::is_absolute_path_with_prefix return optional

style: Tweak comments

chore: Improve hint in source code format error message

fix: Don’t increment direct_cache_miss for forced recache

fix: Make conversion to relative paths more reliable on Windows (#1011)

chore: Add Vili Väinölä to .mailmap

fix: Hash object file directory for MSVC compilers

The object file produced by MSVC includes the full path to the object
file even without debug flags.

bump: Upgrade to BLAKE3 1.3.1

docs: Tweak hard link config option description

fix: Respect umask when making hard linked files read only

Fixes #1007.

refactor: Extract get_umask function to Util

chore: Touch up Util::read_text_file code

fix: Support UTF-16LE .rsp files (#1005)

docs: Add documentation that compiler plugins are hashed too (#1006)

feat: Remove automatic enabling of ccache for ccache build

When enabling ccache using the standard recommended method (via PATH or
via masquerading symlinks), UseCcache.cmake will introduce double
invocations of ccache. I find this a bit annoying and I also think that
it should be up to the user to enable or not enable ccache and which
settings to use.

chore: Remove obsolete GCC 4.8 workarounds

fix: Ensure that raw filenames are static in length

PrimaryStorage::evict assumes that the entry number is encoded in the
filename as one character, so make sure that this precondition holds in
Result::{Reader,Writer} as well.

refactor: Clean up code related to -Fp/-Yu with concatenated path

fix: Fix clang-cl display name (#1003)

style: Improve names related to clang-cl

docs: Add missing documentation of compiler type “clang-cl”

fix: Don’t finalize ZstdCompressor twice

This fixes an issue with older libzstd versions, which don’t like when
you continue writing data to a stream after calling ZSTD_endStream.

feat: Add support for clang-cl (#993)

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

feat: Add option to use Bearer token with HTTP backend (#1001)

bump: Upgrade to cpp-httplib 0.10.2

feat: Enable HTTP keep-alive by default (#1000)

feat: Add --inspect option instead of --dump-manifest/--dump-result

“Inspect” sounds more appropriate than “dump” for viewing metadata of
cache files. Also, it’s convenient to have one option instead of two
different.

enhance: Add File::File(FILE*) constructor

fix: Do not handle -o<file> for MSVC (#994)

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

bump: Upgrade to BLAKE3 1.3.0

bump: Upgrade to fmt 8.1.1

bump: Upgrade to doctest 2.4.8

bump: Upgrade to zstd 1.5.2

feat: Detect MSVC compiler case insensitive and with exact match

feat: Make it possible to configure compiler type msvc

refactor: Rename compiler type cl to msvc

fix: Ensure existing directory before copying from secondary storage

Fixes #998.

doc: Fix typo and missing word

test: Verify -fsyntax-only handling without -c

refactor: Simplify -fsyntax-only logic

feat: Add support for MSVC's -Zs option (#995)

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

Fix upload-redis after cache entry format change (#973)

feat: Support MSVC /Yu option (compiling with PCH) (#991)

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

fix: Unconstify variable to allow automatic move

As suggested by Clang-Tidy.

fix: Make src/ccache.cpp cacheable by ccache itself

“.incbin” should not be present verbatim in the source code since that
makes ccache consider the code uncacheable.

Regression in 2d2de82bb9231b981b40486b093a2c0002200c40.

doc: Improve documentation of --config-path

See also discussion #986.

Fix stats output for secondary storage (#988)

fix: Check writability of /run/user/<UID>/ccache-tmp before using

Closes #984.

refactor: Decouple Manifest data structure from how it’s stored

Manifest is now a standalone data structure that knows how to serialize
and deserialize itself but not how it’s embedded in a cache entry.

bump: Upgrade to xxHash 0.8.1

bump: Upgrade to cpp-httplib 0.10.1

test: Improve code style

style: Avoid operator++ in expression

fix: Avoid .incbin false positive (#983)

fix: Remove duplicate -Xarch second argument (#981)

style: Add some comments and tweaks

fix: Fix copying of binary files on Windows (#979)

fix: Don’t run trim_dir test suite unless cleanup tests are enabled

Fixes #974.

refactor: Move conversion to slash option outside file test

refactor: Remove redundant conditions for MSVC options

fix: Handle stdout from distcc-pump when used as a prefix

The compiler guessing doesn’t work if pump is used as a
prefix/CCACHE_PREFIX, so let’s just not depend on such guesswork.

Also, since the distcc-pump wrapper isn’t really a compiler type, it
actually makes sense not to treat it as such.

feat: Support caching stdout for all compiler types

enhance: Add Result::write_data method

fix: MSVC's -link option is too hard (#972)

fix: Handle MSVC flags -MD[d], -MT[d] and -LT[d] properly (#971)

Fix and simplify handling of options for MSVC (#954)

Add support for caching stdout from MSVC (#962)

fix: Ignore CCACHE_NOCPP2=1 with MSVC (#970)

doc: Correct reference to the debug_dir option

refactor: Simplify code related to send_to_fd

fix: Correct error message in send_to_fd

Merge pull request #968 from jhnc-oss/fix-newline-on-windows

fix: handle newlines on Windows properly

fix: Use default object file extension .obj for MSVC (#964)

fix: Make AVX2 code work also with MSVC (#963)

chore: Improve language in NEWS

chore: Update NEWS

(cherry picked from commit 764dc83795d9a05c2a9d69f267ed86f61a253d09)

fix: Correct error handling for unconstructible storage backend

This fixes a crash when using a secondary storage backend that throws on
construction, for instance the Redis backend with an unreachable server.

Closes #966.

fix: Remove extraneous space in log message

fix: Correct entry_size field for result entries

The entry_size field in result entries created by ccache 4.5 are off by
one. Fix this by properly accounting for the new format_ver field in
result payload data.

Note: This bug only affects the recompression feature (-X/--recompress)
and not other ccache usage.

Closes #965.

fix: Store actual compression level in cache entry header

This detail got lost in e83ac28d74dcb60af9ceaa58d92e706ded089ea3.

feat: Visual C/C++ compiler support (#506)

chore: Update NEWS

chore: Update authors

doc: Tweak preposition

feat: Pretty-print entry type in --dump-{manifest,result}

feat: Add namespace support

If a namespace configured, the namespace string will be added to the
hashed data for each compilation. This will make the associated cache
entries logically separate from cache entries with other namespaces, but
they will still share the same storage space. Cache entries can also be
selectively removed from the primary cache with the command line option
--evict-namespace, potentially in combination with --evict-older-than.

Closes #870.

fix: Disable hard link and file clone with enabled secondary storage

refactor: Rename tag header field to namespace

feat: Support rewriting absolute path to Clang option --gcc-toolchain

Closes #889.

style: Add curly braces around if statement body

doc: Fix description of --checksum-file

fix: Correct debug dir handling on Windows (#955)

feat: Improve cache entry format

Cache entry header changes:

* Changed magic bytes to represent a generic “ccache entry” instead of a
  specific result/manifest entry.
* Added a payload type field (currently manifest or result) separate
  from the magic bytes. This allows code that only operates on the
  “container” (e.g. recompression) to be ignorant of payload types and
  changes to payload formats.
* Added a creation timestamp field. This can be useful when debugging,
  for instance to match the timestamp with a build start/end.
* Added a field for the ccache version that created the cache entry.
  This can be useful for debugging, and it also makes it possible for
  future ccache versions to refuse using results from previous buggy
  ccache versions.
* Added a tag field to be used by a future feature.

Cache entry epilogue changes:

* Use 128-bit XXH3 instead of 64-bit XXH3 for the checksum since those
  extra bits are computed by the algorithm anyway.

Manifest/result entry changes:

* Added manifest/result format version fields. This means that the
  payload version can be stepped without stepping the outer format
  version, thereby making it possible for older ccache versions to for
  instance recompress the cache even though the payload format has
  changed.

Other improvements:

* Added generic Reader and Writer interfaces to decouple code from using
  FILE* directly.
* Refactored checksum handling into ChecksummingReader and
  ChecksummingWriter.

enhance: Add util::XXH3_128

refactor: Rename Checksum to util::XXH3_64

bump: Upgrade to BLAKE3 1.2.0

bump: Upgrade to cpp-httplib 0.9.7

bump: Upgrade to optional-lite 3.5.0