Struct HttpObjectsConfig 

#[non_exhaustive]
pub struct HttpObjectsConfig {
    pub max_walk_objects: usize,
    pub admit_reads: bool,
    pub redirect_public_refs: bool,
    pub read_deadline: Duration,
    pub read_reconcile_grace: Duration,
    pub reachability_lag_ms: u64,
    pub reach_cache_entries: usize,
    pub max_inline_object_bytes: u64,
    pub http_decode_budget: u64,
    pub max_proof_content_bytes: u64,
    pub max_proof_bundle_bytes: u64,
}

Limits of opt-in HTTP object serving.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

max_walk_objects: usize

Most objects one reachability walk decides, and most ref rows scanned (including excluded refs and shard prefetch). Enumeration also has a page budget of this limit divided by the configured page size, rounded up. Exhaustion is 404 and METRIC_HTTP_REACH_CAPPED.

admit_reads: bool

Run the Admission hook for GET and HEAD at step 11. Default off.

redirect_public_refs: bool

Opt-in public ref redirects after all earlier checks; disabled with admission.

read_deadline: Duration

Maximum paid transmission time from reservation creation.

read_reconcile_grace: Duration

Time reserved for completion persistence before abandonment (default 60 s).

reachability_lag_ms: u64

How long a reachability proof is trusted, in milliseconds: a rewind or ref deletion is visible within it (§4 reachability_lag).

reach_cache_entries: usize

Most rows of the positive reachability cache.

max_inline_object_bytes: u64

Largest object served from its pack entry rather than an extracted copy, at least extract_min_bytes + 10. Larger is 503.

http_decode_budget: u64

Decode bytes one request may spend on resolution and the reachability walk; at least max_inline_object_bytes. The inline byte source has its own max_inline_object_bytes allowance on top.

max_proof_content_bytes: u64

Maximum requested proof range content (checked before encoded size).

max_proof_bundle_bytes: u64

Maximum encoded proof, at most SPEC-DISCLOSURE’s 64 MiB cap.

Implementations

impl HttpObjectsConfig

pub fn validate(&self, extract_min_bytes: u64) -> Result<(), ServerError>

Check the limits against the indexed configuration they run under.

Errors

invalid_argument for a zero limit, an inline cap below extract_min_bytes + 10, or a decode budget below the inline cap.

Trait Implementations

impl Clone for HttpObjectsConfig

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for HttpObjectsConfig

impl Debug for HttpObjectsConfig

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

Formats the value using the given formatter.

impl Default for HttpObjectsConfig

fn default() -> Self

Returns the “default value” for a type.

impl Eq for HttpObjectsConfig

impl PartialEq for HttpObjectsConfig

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for HttpObjectsConfig