Skip to main content

Crate mbx_cache_store

Crate mbx_cache_store 

Source
Expand description

Store inspection and garbage collection.

The store holds six trees: cas/v1 for content-addressed objects, action-results/v1 for the results that reference them, task-manifests/v1 for the prediction index, checkouts/v1 for the checkouts that have built each identity, build-receipts/v1 for exact completed build closures, and sessions/v1 for per-build event streams. Only the first two are collected for size; manifests and receipts are small, checkout records expire with their checkout claims, and session streams are bounded by age and count because they are history rather than cache content.

Structs§

ExportAdditions
Extra CAS roots carried by a cache export for a higher-level transport.
GcOutcome
ImportOutcome
A cache import together with named higher-level CAS roots it carried.
LargestEntry
ProjectUsage
RemoveProjectOutcome
StoreStats
TransferOutcome
VerifyOutcome
WorkspaceTarget
One Cargo workspace and the target directory recorded for its build.

Enums§

ExportForm
How an export is laid out on disk.

Functions§

checkout_is_live
Whether a checkout is still on disk, corroborating absence through its immediate parent.
checkout_is_live_on
Whether the checkout a record names is still on disk.
checkout_workspace_target
Return the target directory recorded for this checkout’s latest build.
claim_sweep
Claim a due sweep before doing work, including interrupted attempts.
export_checkout
Export the complete local cache closure of this checkout’s most recent build.
export_checkout_as
Export one checkout’s closure in the requested form.
export_checkout_with
Export one checkout’s closure together with higher-level CAS attachments.
export_group
Export the union of every completed build recorded under one CI group.
export_group_as
Export a grouped closure in the requested form.
export_group_with
Export a grouped closure together with higher-level CAS attachments.
gc
Evict objects until the store fits within max_bytes.
gc_dry_run
Describe the collection gc would perform without changing the store.
gc_dry_run_after_stale
Describe what gc_stale_compilers followed by gc_dry_run would remove, counting nothing twice and measuring the budget after the stale pass.
gc_stale_compilers
Drop cached compilations for Rust compiler versions that have gone unused.
group_workspace_targets
Return every Cargo target represented by the pending receipts in a group.
import_archive
Validate a cache export in isolation, then publish its objects and actions.
import_archive_with_attachments
Import a cache archive and return its named higher-level CAS roots.
largest
Return the largest blobs and action-result records in descending order.
live_project_cache_bytes
The reusable cache bytes of each live workspace, as projects counts them.
projects
Attribute cache and target bytes to each recorded workspace.
record_build_receipt
Record an exact completed build for checkout and grouped exports.
record_checkout
Record that workspace_root built identity.
record_sweep
Record a finished sweep at the current time.
remove_project
Remove checkout claims belonging to exactly one workspace.
same_filesystem_paths
Whether two existing paths sit on the same filesystem, so a rename can carry a directory from one to the other.
stats
Summarize what the store currently holds.
sweep_if_due
Sweep the store if interval has passed since the last attempt.
sweep_is_due
Whether the interval since the last recorded sweep has passed.
verify
Verify every addressable CAS object and action-result record.