#pragma once ///@file #include "signature/local-keys.hh" #include "store-api.hh" #include "log-store.hh" #include "pool.hh" #include namespace nix { struct NarInfo; struct BinaryCacheStoreConfig : virtual StoreConfig { using StoreConfig::StoreConfig; const Setting compression{this, "xz", "compression", "NAR compression method (`xz`, `bzip2`, `gzip`, `zstd`, or `none`)."}; const Setting writeNARListing{this, false, "write-nar-listing", "Whether to write a JSON file that lists the files in each NAR."}; const Setting writeDebugInfo{this, false, "index-debug-info", R"( Whether to index DWARF debug info files by build ID. This allows [`dwarffs`](https://github.com/edolstra/dwarffs) to fetch debug info on demand )"}; const Setting secretKeyFile{this, "", "secret-key", "Path to the secret key used to sign the binary cache."}; const Setting localNarCache{this, "", "local-nar-cache", "Path to a local cache of NARs fetched from this binary cache, used by commands such as `nix store cat`."}; const Setting parallelCompression{this, false, "parallel-compression", "Enable multi-threaded compression of NARs. This is currently only available for `xz` and `zstd`."}; const Setting compressionLevel{this, -1, "compression-level", R"( The *preset level* to be used when compressing NARs. The meaning and accepted values depend on the compression method selected. `-1` specifies that the default compression level should be used. )"}; }; /** * @note subclasses must implement at least one of the two * virtual getFile() methods. */ class BinaryCacheStore : public virtual BinaryCacheStoreConfig, public virtual Store, public virtual LogStore { private: std::unique_ptr signer; protected: // The prefix under which realisation infos will be stored const std::string realisationsPrefix = "realisations"; BinaryCacheStore(const Params & params); public: virtual bool fileExists(const std::string & path) = 0; virtual void upsertFile(const std::string & path, std::shared_ptr> istream, const std::string & mimeType) = 0; void upsertFile(const std::string & path, // FIXME: use std::string_view std::string && data, const std::string & mimeType); /** * Dump the contents of the specified file to a sink. */ virtual void getFile(const std::string & path, Sink & sink); /** * Fetch the specified file and call the specified callback with * the result. A subclass may implement this asynchronously. */ virtual void getFile( const std::string & path, Callback> callback) noexcept; std::optional getFile(const std::string & path); public: virtual void init() override; private: std::string narMagic; std::string narInfoFileFor(const StorePath & storePath); void writeNarInfo(ref narInfo); ref addToStoreCommon( Source & narSource, RepairFlag repair, CheckSigsFlag checkSigs, std::function mkInfo); public: bool isValidPathUncached(const StorePath & path) override; void queryPathInfoUncached(const StorePath & path, Callback> callback) noexcept override; std::optional queryPathFromHashPart(const std::string & hashPart) override; void addToStore(const ValidPathInfo & info, Source & narSource, RepairFlag repair, CheckSigsFlag checkSigs) override; StorePath addToStoreFromDump( Source & dump, std::string_view name, FileSerialisationMethod dumpMethod, ContentAddressMethod hashMethod, HashAlgorithm hashAlgo, const StorePathSet & references, RepairFlag repair) override; StorePath addToStore( std::string_view name, SourceAccessor & accessor, const CanonPath & srcPath, ContentAddressMethod method, HashAlgorithm hashAlgo, const StorePathSet & references, PathFilter & filter, RepairFlag repair) override; void registerDrvOutput(const Realisation & info) override; void queryRealisationUncached(const DrvOutput &, Callback> callback) noexcept override; void narFromPath(const StorePath & path, Sink & sink) override; ref getFSAccessor(bool requireValidPath = true) override; void addSignatures(const StorePath & storePath, const StringSet & sigs) override; std::optional getBuildLogExact(const StorePath & path) override; void addBuildLog(const StorePath & drvPath, std::string_view log) override; }; MakeError(NoSuchBinaryCacheFile, Error); }