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

refactor: Move Win32Util::get_last_ntstatus to util::DirEntry

util::DirEntry is the sole user of Win32Util::get_last_ntstatus.

refactor: Move File to util::FileStream

refactor: Move NonCopyable to util

refactor: Move fmtmacros to util

refactor: Move Finalizer to util

refactor: Move assertions to util

bump: Upgrade to BLAKE3 1.5.0

chore: Prepare for version 4.8.3

(cherry picked from commit 044558e647b49dbc8fc89b810a7d22f526101e6b)

bump: Upgrade to fmt 10.1.1

fix: Exit more gracefully on invalid sharded remote storage URL

As mentioned in #1321.

chore: Avoid linting suppression for Storage::~Storage

bump: Upgrade to cpp-httplib 0.14.0

docs: Mention that system_headers sloppiness is not supported for MSVC

Closes #1224.

fix: Fix bookkeeping of raw files

Ccache 4.8-4.8.2 notes the size and count of raw files (written to the
cache if hard link or file clone mode is enabled) to a level 2 stats
file. However, the new cleanup algorithm (also introduced in 4.8)
assumes that all size/count statistics are placed in a level 1 stats
file. After a "ccache -c", the raw files will be "rediscovered" and
noted in level 1 stats files, thus duplicating bookkeeping in level 2
stats files, resulting in a too high cache size figure in "ccache -s".

To fix this, ccache will now:

- Note size/count of raw files in the proper level 1 stats file.
- When storing an entry on a cache miss, detect if the corresponding
  level 2 stats file has non-zero size/count statistics and propagate
  them to the level 1 stats file if so.
- Zero out files/count statistics for level 2 stats file on "ccache -c".

This means that the reported cache size will gradually correct itself
automatically. Alternatively, the user can run "ccache -c" to fix all
counters immediately.

Fixes #1320.

enhance: Support updating stats file only if values have changed

refactor: Improve name of LocalStorage::increment_level_2_counters

refactor: Use LocalStorage::get_stats_file

chore: Fix grammar in comments

chore: Avoid ccache:disable strings in ccache source code

A verbatim ccache:disable string disables ccache when compiling some
ccache sources, which is unnecessary.

bump: Upgrade to fmt 10.1.0

refactor: Move AtomicFile to core

refactor: Move ThreadPool to util

refactor: fs::path-ify util::traverse_directory

refactor: fs::path-ify LockFile

refactor: fs::path-ify LongLivedLockFileManager

refactor: Move Fd to util

refactor: Remove use of mkdir(2)

refactor: Move TemporaryFile to util

ci: Time out jobs after 30 minutes

The default is 360 minutes.

refactor: fs::path-ify some util file functions

refactor: fs::path-ify TemporaryFile

refactor: fs::path-ify core::ensure_dir_exists

test: Fix DirEntry unit tests for Windows mingw64

chore: Fix unit test build after d8b654a30ca8

feat: Rewrite path after -Xclang -include to relative (#1318)

cmake may generate both -include and -include-pch. Example:

c++ ... -Xclang -include-pch -Xclang /abs/path/cmake_pch.hxx.pch
        -Xclang -include -Xclang /abs/path/cmake_pch.hxx ...

Both paths needs to be converted to relative path if CCACHE_BASEDIR is
set for better cache hit rate in some CI systems.

refactor: Remove dependency on core from util

feat: Include maximum size/files in --print-stats

New output:

- max_cache_size_kibibyte: maximum size of local storage in KiB (0 for
  no limit)
- max_files_in_cache: maximum number of files in local storage (0 for no
  limit)

Closes #1315.

refactor: fs::path-ify ignore_header_paths and related functions

bump: Upgrade to fmt 8a4bec5cf53387356738a06ba0cf4fdf086241ae (10.0.0+)

refactor: fs::path-ify is_ccache_executable

refactor: Rename and improve Stat class to util::DirEntry

refactor: Move core/wincompat.hpp to util

refactor: Remove Stat::OnError::throw_error

This is in preparation for moving the Stat class to util where we don't
want to know about core::Error.

refactor: Move Util::traverse to util

refactor: Move Util::send_to_fd to core

chore: Tweak documentation related to debug level

feat: Allow specifying debug level (#1312)

Allow specifying debug level via a debug_level option or CCACHE_DEBUGLEVEL
environment variable.

With debug_level=2 (default), ccache behavior's in debug mode is not changed.

With debug_level=1, ccache will only dump *.ccache-log files (and not the
*input* ones). This is useful for getting per-file caching results.

fix: Work around GCC 12.3 bug 109241

See also #1289.

refactor: Remove superfluous util:: qualifications

bump: Upgrade to xxHash 0.8.2

Closes #1085.

refactor: Improve util::write_fd usage

refactor: Improve util::read_file usage

refactor: Improve util::read_fd usage

enhance: Add util::read_fd variant that returns all data at once

refactor: Switch to tl::expected instead of nonstd::expected

refactor: Use util::{throw_on_error,value_or_throw}

fix: Properly signal error on copy failure

Restores behavior before 73a4585a58d5ab818a864485708d706532dfa3b4.

refactor: Move util::rename to util::filesystem

refactor: Move Util::get_hostname to util

refactor: Move Util::get_home_directory to Config

refactor: Move Util::ensure_dir_exists to util

refactor: Move Util::unlink_* to util

refactor: Let util::rename return std::error_code

refactor: Move Util::is_ccache_executable to ccache

chore: Clean up config.h

refactor: Move Util::localtime to util

chore: Improve code style

refactor: Move Util::is_precompiled_header to argprocessing

refactor: Move Util::to_lowercase to util

chore: Add note about using util::rename instead of fs::rename

refactor: Use std::filesystem::current_path

refactor: Improve std::filesystem wrappers

I couldn't figure out how to make the templated versions support both

    path current_path();

and

    void current_path(const path& p);

so using preprocessor macros instead.

refactor: Use std::filesystem::remove_all

chore: Improve util::format_argv_for_logging

refactor: Move Util::format_argv_for_logging to util

refactor: Move Util::get_{actual,apparent}_cwd to util

refactor: Use std::filesystem::create_director{ies,y}

refactor: Move Util::split_into_* to util

refactor: Move Util::size_change_kibibyte to LocalStorage

refactor: Move Util::set_cloexec_flag to util

refactor: Create util::filesystem wrappers returning nonstd::expected

refactor: Move Util::fallocate to util

chore: Fix grammar in comment

refactor: Move UmaskScope to util

refactor: Move Util::{g,s}et_umask to util

refactor: Use fs alias for std::filesystem

fix: Pass error code to fs::temp_directory_path as intended

As noted by Thibault Odorico.

refactor: Move Util::parse_duration to util

refactor: Use std::filesystem::current_path

refactor: Use std::filesystem::canonical

refactor: Use std::filesystem::temp_directory_path

chore: Tweak code style

bump: Upgrade to hiredis 1.2.0