Struct RetainedCandidates 

pub struct RetainedCandidates {
    pub referenced: u64,
    pub within_grace_window: u64,
    pub no_provider_timestamp: u64,
    pub no_reference_manifest: u64,
    pub degraded_roots: u64,
    pub unrecognized_key: u64,
    pub checkpoint_not_releasable: u64,
    pub upload_session_window: u64,
    pub upload_session_undecided: u64,
    pub content_scan_deferred: u64,
}

Candidates inspected but not deleted by one GC pass.

Every field is present, including zero counts. The fields sum to retained_candidates in GcResponse.

An object inspected by multiple passes is counted once per pass.

Fields

referenced: u64

Candidates found reachable during the final check before deletion.

within_grace_window: u64

Unreachable, but younger than the grace window by the object’s own provider timestamp. A later pass deletes it.

no_provider_timestamp: u64

Unreachable candidates with no provider timestamp. Their age is unknown, so the pass keeps them.

no_reference_manifest: u64

Unreachable candidates that cannot be checked against a manifest old enough to cover the grace window.

degraded_roots: u64

Candidates kept because root resolution failed. The response also sets retention_degraded.

unrecognized_key: u64

Unrecognized keys in a family scanned by GC. These keys are never deleted.

checkpoint_not_releasable: u64

Checkpoint records that could not be safely released or deleted.

upload_session_window: u64

Upload sessions still protected by a lease or grace window.

upload_session_undecided: u64

Upload sessions kept because the pass could not determine whether they were safe to delete.

content_scan_deferred: u64

Completed sessions skipped because the reference scan exceeded max_objects. The response also sets content_reclamation_deferred.

Implementations

impl RetainedCandidates

pub fn by_reason(&self) -> [(&'static str, u64); 10]

Returns every reason and count in a fixed order.

pub fn add(&mut self, other: &Self)

Adds counts from another pass.

pub fn top_reason(&self) -> Option<(&'static str, u64)>

The reason with the highest count, and that count. None when nothing was retained. Ties go to the first in Self::by_reason order, so one pass’s report is stable.

Trait Implementations

impl Clone for RetainedCandidates

fn clone(&self) -> RetainedCandidates

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for RetainedCandidates

impl Debug for RetainedCandidates

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for RetainedCandidates

fn default() -> RetainedCandidates

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for RetainedCandidates

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for RetainedCandidates

impl PartialEq for RetainedCandidates

fn eq(&self, other: &RetainedCandidates) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for RetainedCandidates

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for RetainedCandidates