Skip to main content

Module store

Module store 

Source
Expand description

One tenant’s vCons: a sealed object per kept version and a catalog row for it. The catalog is the truth: a version exists once its row is committed, and an object with no row is garbage. Every rule is here; the catalog and the objects are reached through the backend traits.

Structs§

Caller
Who is calling, for the audit record.
Copied
What backup_to copied.
Counts
What a tenant’s Store keeps, as removal checks it.
Cursor
Where a page ends: the last listed vCon’s first stored time and uuid. Clients get it as opaque text and send it back unchanged.
Examination
One Store as check found it.
Kept
What the purge rule reads of one version.
KeptVersion
A kept version as the export lists it.
Legal
A version as a legal read returns it, and whether its uuid is deleted.
ListQuery
What a list asks for: at most limit vCons, after cursor, first stored at or after since and before until.
Listed
A live vCon as the list shows it.
Listing
One page of a list, and the cursor of the next one, None on the last.
PurgeReport
What a purge did.
Store
One tenant’s vCons.
Stored
A version as get returns it.
VersionInfo
One kept version of a uuid, as the legal version list shows it.

Enums§

BackupError
Why a backup of a Store failed.
Created
What create did.
ExamineError
Why a Store could not be examined.
OpenError
Why a tenant’s Store did not open: kept apart so a key that does not open its catalog is never confused with files this process may not use.
StoreError
Why a Store call was refused or failed.

Constants§

TRIES
How many times the catalog is copied while versions in each copy are purged before their object files are copied.

Functions§

due
Whether version is due for purge at now under retention: it is hidden, its uuid has no hold, and retention has passed since it was stored, counted in calendar time in UTC. A period that ends past the last time this build can hold never passes. A version hidden after it reached that age is due at once.