build(blake3): Assume aarch64 to be little-endian on CMake 3.18/3.19 (#1652)

The recently introduced detection of big-endian AArch64 uses the
CMAKE_C_BYTE_ORDER variable, which was introduced in 3.20, but ccache
currently only requires CMake 3.18.

To avoid using an undefined variable, simply assume AArch64 to be
little-endian on CMake versions that don't define the aforementioned
variable. This is okay because big-endian AArch64 has few users and the
subset of them that use CMake 3.18/3.19 is likely negligible.

Reported-by: @awawa-dev
Fixes: https://github.com/ccache/ccache/issues/1651

feat: Add msvc_utf8 config option to allow disabling /utf-8 for MSVC (#1650)

Add  option to avoid adding  to msvc command line for non-utf8 source code

chore: Mark some ThreadPool methods as noexcept

feat: Log errors and size changes when recompressing cache files

enhance: Let ThreadPool log failed tasks

enhance: Make logging system thread-safe

perf: Only wake up one worker thread when a task has been popped

fix: Handle util::TaskPool enqueue/shut_down called by different threads

enhance: Add util::parse_base16 function

enhance: Add util::Bytes::push_back method

enhance: Add util::Bytes::at method

docs: Update URLs in manual and news

fix: Correctly remove mismatching manifest file

This fixes a bug introduced in commit c7c0837a ("Refactor main primary
storage backend code into storage/primary").

perf: Avoid zero-filling in util::Bytes in all cases

enhance: Add more util::Bytes constructor and operator= variants

perf: Call Bytes::resize from Bytes constructors to avoid zero-filling

enhance: Add Bytes::erase

test: Use REQUIRE for Bytes::size when indexing bytes later

chore: Consistently use .reset() to reset m_data in Bytes

fix: Fix comparison of empty Bytes objects

feat: Add support for multi-line configuration values

fix: Pass unsigned char to std::is* and std::tolower

Passing (negative) char is technically undefined behavior.

docs: Mention that sloppiness values can be whitespace-separated

docs: Tweak Asciidoc markup

feat: Add support for -fcoverage-compilation-dir/-fcoverage-prefix-map (#1644)

chore: Update C++ standard in .clang-format (#1648)

chore: Add libstdc++-static to alma dockerfiles

docs: Improve installation guide

docs: Improve manual

feat: Support rewriting absolute path for -fsanitize-blacklist (#1647)

test: Fix `profiling_clang` test (#1642)

chore: Fix typo in CcacheVersion (#1645)

ci: Add missing dependency on build_documentation for build_release

docs: Fix `install.md` links after renaming (#1643)

docs: Improve documentation on statistics counters and --zero-stats

After discussion with Otto Kekäläinen in #1639.

Co-authored by: Otto Kekäläinen <otto@kekalainen.net>

docs: Reflow long line in manual

docs: Reconcile max-size suffixes in documentation (#1640)

* Use explicit 'GB' suffix in example.
* Fix misleading `max_size` description. Default suffix is GiB, not GB. And default value is 5GiB also.
* `max_size` description - use explicit suffixes.

fix: Link with libsocket on SunOS/Illumos

Closes #1638.

chore: Ignore local copilot instructions

chore: Improve util::FileLock

- Release current lock on move.
- Check for invalid file descriptor in acquire/release.
- Use UnlockFileEx on Windows for symmetry with LockFileEx.
- Added noexcept where applicable.

refactor: Use std::chrono instead of custom classes

chore: Update authors

(cherry picked from commit dd29ee832c5ba130d877c16c06e1c3b6dd55247a)

chore: Update NEWS

(cherry picked from commit acf9688b448844d931002c26e0cf5ee02f8f47ba)

chore: Update NEWS

(cherry picked from commit 058808b676ed0bde0dea5a91434fe5615af2113f)

chore: Update NEWS

(cherry picked from commit a50e311cbd4c756fdedf6acd50ee2e8753330587)

fix: Add missing return in copy_file_impl fallback code (#1630)

This fixes a compilation error with tl::expected ≥ 1.2.0 on non-Apple platforms where sendfile(2) is not available.

fix: Add missing doc files to Linux/macOS binary release packages

chore: Avoid false positive spelling warning with typos 1.37.0

fix: Use monotonic clock for spin locks in inode cache

docs: Rename documentation files to lowercase

Exception: Doc files at the top level keep their uppercase names by
convention.

docs: Generate documention in Markdown format as well

docs: Escape hash character in asciidoc file

Asciidoctor gets confused otherwise when generating docbook.

fix: Handle -Xarch_host/-Xarch_device except with other -Xarch_*

-Xarch_host and -Xarch_device appear to have different semantics than
other -Xarch_* options, so add special case code that allows only
-Xarch_host options or only -Xarch_device options while falling back to
the compiler for other combinations.

A future improvement would be to add multi-pass support for -Xarch_host
and -Xarch_device combinations as well.

Fixes #1632.

bump: Upgrade to fmt 12.0.0

refactor: Remove unnecessary explicit non::span constructor

fix: Don't crash thread pool thread if task throws

fix: Don't fail on ENOENT when trying to break a LockFile lock

chore: Handle empty argv in format_argv_as_win32_command_string

fix: Correct saving of current position in fallocate fallback code

ci: Fix GitHub release title

chore: Update NEWS

chore: Update AUTHORS

chore: Convert misc/update-authors to Python

chore: Update .mailmap

chore: Add alma-9 dockerfile

chore: Add debian-13 dockerfile

test: Simplify get_root()

docs: Document "Unsupported source encoding" statistics counter

test: Handle GetVolumePathName errors, prevent access violation (#1626)

For example GetVolumePathName returns `F:/git_projects` on my computer which
does not fit in a char[4]. As a result GetVolumePathName returns an error and
a std::string is initialized from uninitialized memory which may not contain
a '\0' resulting in out of bounds memory reads.

Co-authored-by: Leander Schulten <Leander.Schulten@tetys.de>

fix: Avoid expanding symlinks in relative path candidates

Commit 8223ed38abd9cf75ab75cb19dc2081c44bf568d0 changed
make_relative_path to also try matching real_path(path) against the
apparent/actual CWD, assuming that an absolute path p could be
substituted with real_path(p).

This assumption is incorrect for source files: if the source file
includes a file via a relative path, expanding symlinks may cause the
include file to be searched in the wrong directory.

Fix by reverting that change. The new test case "Symlink to source file,
longer symlink path" fails without this fix.

Note: this effectively reverts #724.

Fixes #1620.

chore: Touch up basedir.bash

fix: Hash specs file actually used by GCC

"gcc -specs=foo" (when "foo" doesn't include a slash) makes GCC search
in various system directories for the file, so ccache fails to hash the
file if it's found in such a directory.

Fix this by asking the compiler (using "-print-file-name") which file it
will actually read.

Fixes #1625.

feat: Add support for Clang --config= option

Clang >= 16 supports "--config=name" in addition to "--config name".

docs: Fix markup in NEWS file

refactor: Simplify HTTP logging slightly

chore: Update .mailmap

refactor: Simplify UTF-16LE to UTF-8 conversion in util::read_file

bump: Upgrade to tl-expected 1.3.1

build(blake3): Don't use NEON on aarch64_be (#1624)

ci: Fix version logic in prepare-release for PR workflows

ci: Fix ccache version for PR workflows

fix: Fix crash on HTTP request failure (#1628)

If the request fails and `result.error() != Error::Success` `result->` can return
a `nullptr` resulting in a null pointer dereference.

Co-authored-by: Leander Schulten <Leander.Schulten@tetys.de>

fix: Fix bad conversion from UTF-16 in util::read_file on Windows (#1627)

When interpreting a char* string that is null terminated as wchar* string
it is not guaranteed that the wchar* string is also null terminated. A char[3]
string/memeory region with the content ['a', '\0', '\0', 100] interpreted as
wchar* has no ending null character resulting in out of bounds memory reads
when trying to construct a std::wstring from it.

Co-authored-by: Leander Schulten <Leander.Schulten@tetys.de>

ci: Add jobs to build and create release

This includes new binary releases for Linux aarch64 and Windows aarch64.

Closes #1579. See also discussion #1310.

ci: Add artifact retention

ci: Verify llvm-mingw toolchain download

ci: Rename binary jobs to common "-binary" suffix

ci: Add traces to CI jobs to make debug cycle shorter

build: Improve installation of documentation

- Make HTML and man page part of "cmake --install".
- Make modifications of man page in-place to avoid leaving a .tmp file
  behind.

ci: Rename macOS to Darwin in CI context

ci: Rename macOS binary jobs to match others

ci: Add documentation build job

ci: Run on ubuntu-24.04 instead of ubuntu-latest

I prefer to avoid *-latest tags.

ci: Improve binary build jobs

For x86_64, build in an Alma Linux 8 container since RHEL 8 is the
oldest still active LTS mainstream Linux distribution to my knowledge.

For aarch64, cross compile in an x86_64 environment instead of in a
native aarch64 environment. This is because I want to be able to build
release binaries locally on my x86_64 machine if there is some problem
with the CI environment and it feels good to match that in CI. The build
is still on Ubuntu 22.04 – I made a quick attempt to get
cross-compilation working in Alma Linux 8 working but gave up.

ci: Bump to newer codespell and typos versions

build: Detect ccache version from GitHub Actions environment

refactor: Use std::array instead of const char* array (#1623)

feat: Add support for multiple directories in base_dir/CCACHE_BASEDIR

Closes #597.

enhance: Add util::join_path_list

enhance: Implement util::to_string(const fs::path&)