Module tvix_castore::directoryservice

source Β·

Modules§

Structs§

  • Provides a DirectoryService implementation using Bigtable as an underlying K/V store.
  • Represents configuration of BigtableDirectoryService. This currently conflates both connect parameters and data model/client behaviour parameters.
  • Asks near first, if not found, asks far. If found in there, returns it, and inserts it into near. Specifically, it always obtains the entire directory closure from far and inserts it into near, which is useful when far does not support accessing intermediate directories (but near does). There is no negative cache. Inserts and listings are not implemented for now.
  • This can be used to validate and/or re-order a Directory closure (DAG of connected Directories), and their insertion order.
  • Connects to a (remote) tvix-store DirectoryService over gRPC.
  • Validates that newly uploaded directories only reference directories which have already been introduced. Commonly used when uploading a directory closure to a store.
  • Stores directory closures in an object store. Notably, this makes use of the option to disallow accessing child directories except when fetching them recursively via the top-level directory, since all batched writes (using put_multiple_start) are stored in a single object. Directories are stored in a length-delimited format with a 1MiB limit. The length field is a u32 and the directories are stored in root-to-leaves topological order, the same way they will be returned to the client in get_recursive.
  • Validates that newly introduced directories are already referenced from the root via existing directories. Commonly used when receiving a directory closure from a store.
  • This is an implementation of DirectoryPutter that simply inserts individual Directory messages one by one, on close, after they successfully validated.

Traits§

Functions§