mirror snapshot list
Snapshot listing.
mirrorsarray of objectPer-mirror snapshot listings, sorted by mirror id.
mirror snapshot list: entries of mirrors
Snapshots of one mirror.
idstringMirror name.
latest-symlinkobject, optionalThe latest-snapshot symlink, if the mirror maintains one that points at a snapshot.
namesarray of objectAssigned names, sorted by name.
snapshotsarray of stringSnapshots, oldest first.
mirror snapshot list: entries of names
A name pinned to a snapshot.
namestringSnapshot name.
snapshotstringMirror snapshot timestamp in UTC, like 2025-03-05T14:30:45Z.
mirror snapshot list: latest-symlink
The latest-snapshot symlink, if the mirror maintains one that points at a snapshot.
namestringName of the latest-snapshot symlink.
snapshotstringMirror snapshot timestamp in UTC, like 2025-03-05T14:30:45Z.
mirror snapshot remove
Summary of a snapshot removal.
cleanup-errorsarray of string, optionalCleanup errors for a removed snapshot, such as failures to update the latest symlink or delete remaining files. Omitted if cleanup succeeded.
latest-symlinkstring, optionalNew target of the latest symlink, if the removal moved it.
latest-symlink-removedboolean, optionalWhether the latest symlink was removed because no older snapshot remains.
removed-namesarray of stringSnapshot names (pinned symlinks) removed together with their target snapshot.
snapshotstringMirror snapshot timestamp in UTC, like 2025-03-05T14:30:45Z.
mirror snapshot prune and prune-all
Prune summary. When garbage collection is requested, gc reports its outcome, including
failures. Dry runs omit gc.
dry-runbooleanWhether this was a dry run, in which case nothing was removed.
errorsintegerNumber of failed snapshot removals and failed cleanup steps, plus one for every mirror that could not be pruned at all. Garbage collection failures are counted in
gc.errors.gcobject, optionalGarbage collection summary.
keptintegerTotal number of snapshots selected for retention.
mirrorsarray of objectPer-mirror prune summaries, sorted by mirror id.
removedintegerTotal number of removed snapshots, or snapshots a dry run would remove.
mirror snapshot prune: entries of mirrors
Prune summary of one mirror.
idstringMirror name.
keptintegerNumber of snapshots selected for retention.
removedintegerNumber of removed snapshots, or snapshots a dry run would remove. Removals with cleanup errors still count toward this total; see
cleanup-errors.snapshotsarray of objectPer-snapshot prune decisions, newest first.
mirror snapshot prune: entries of snapshots
What pruning decided for a single snapshot.
cleanup-errorsarray of string, optionalCleanup errors for a removed snapshot, such as failures to update the latest symlink or delete remaining files. Omitted if cleanup succeeded.
errorstring, optionalWhy a snapshot selected for removal could not be removed.
keepbooleanWhether the snapshot was selected for retention rather than removal.
namesarray of stringNames pinned to the snapshot, sorted.
reasonstring, optionalReason for retaining the snapshot: named, latest-symlink, keep-last, keep-hourly, keep-daily, keep-weekly, keep-monthly, or keep-yearly. Omitted if the snapshot was selected for removal.
snapshotstringMirror snapshot timestamp in UTC, like 2025-03-05T14:30:45Z.
mirror gc
Garbage collection summary.
errorsintegerNumber of pools whose garbage collection failed.
mirrorsarray of objectPer-mirror summaries; a pool shared by multiple mirrors is collected and listed once.
removed-bytesintegerTotal size of the removed pool files in bytes.
removed-filesintegerTotal number of removed pool files.
mirror gc: entries of mirrors
Garbage collection summary of one mirror's pool.
idstringMirror name.
removed-bytesintegerTotal size of the removed pool files in bytes.
removed-filesintegerNumber of removed pool files.
mirror verify
Pool verification summary.
bytesintegerTotal size of the checked pool files in bytes.
errorsintegerNumber of pools that could not be verified.
failedintegerTotal number of pool files that failed verification.
poolsarray of objectPer-pool summaries; a pool shared by multiple mirrors is verified and listed once.
verifiedintegerTotal number of pool files that passed verification.
mirror verify: entries of pools
Verification summary of one mirror's pool.
base-dirstringBase directory of the verified pool.
bytesintegerTotal size of the checked pool files in bytes.
failedintegerNumber of pool files that failed verification.
idstringMirror name.
verifiedintegerNumber of pool files that passed verification.
mirror snapshot diff
File-level differences between two snapshots.
addedarray of objectFiles only present in the newer snapshot, sorted by path.
changedarray of objectFiles in both snapshots whose content differs, sorted by path.
removedarray of objectFiles only present in the older snapshot, sorted by path.
mirror snapshot diff: entries of added and removed
A stored file present in only one of two snapshots.
pathstringPath relative to the snapshot directory.
sizeintegerFile size in bytes.
mirror snapshot diff: entries of changed
A stored file present in both snapshots, but with differing content.
Only the size difference is reported: the diff compares stored files by inode, so a changed
file of the same size, like a re-signed Release file, reports a difference of zero.
pathstringPath relative to the snapshot directory.
size-differenceintegerAbsolute difference between the two file sizes, in bytes.
mirror snapshot diff --packages
Package-level differences between two snapshots, by package kind.
binaryobjectPackage-level differences between two snapshots, each list sorted by name.
sourceobjectPackage-level differences between two snapshots, each list sorted by name.
mirror snapshot diff --packages: binary and source
Package-level differences between two snapshots, each list sorted by name.
addedarray of objectPackages only present in the newer snapshot, sorted by name.
changedarray of objectPackages present in both snapshots with different versions, sorted by name.
removedarray of objectPackages only present in the older snapshot, sorted by name.
mirror snapshot diff --packages: package list entries
A single package (binary or source) that differs between two snapshots.
namestringPackage identity:
<name>:<arch>for binary packages, the plain name for source packages.new-versionsarray of stringVersions in the newer snapshot. Empty if the package was removed.
old-versionsarray of stringVersions in the older snapshot. Empty if the package was added.