Struct EvictArgs 

pub struct EvictArgs {
    pub hash: String,
    pub dry_run: bool,
    pub admin_url: Option<String>,
    pub config: Option<PathBuf>,
    pub json: bool,
    pub timeout_ms: u64,
}

decdn node evict — forcibly remove a blob from the local cache via admin_v1_evict (issue #279).

The eviction is logical: the iroh-blobs store still holds the bytes until the next periodic GC sweep reclaims them (#518; cadence controlled by cache.gc_interval_sec). The takedown is persisted to <cache_dir>/evicted.log so it survives restarts even if the next sweep hasn’t run yet. Operators using this for DMCA takedowns can rely on the takedown being durable across decdn-node run invocations.

Pass --dry-run (issue #379) to preview what the evict would touch — blob size, last-access elapsed time, pin status, and already- evicted flag — without mutating any cache state. Useful as a pre-flight check before a DMCA takedown so operators can confirm the right blob and notice cases like “this hash is pinned” or “this is an idempotent re-run”.

Fields

hash: String

BLAKE3 hash of the blob to evict, encoded as 64 hex characters. Optional 0x / 0X prefix is tolerated; mixed case is accepted. Operators paste this from access logs / takedown notices.

dry_run: bool

Report what would be evicted (blob size, last-access elapsed time, pin status, already-evicted flag) without mutating cache state (issue #379). Use this as a pre-flight check before running the real takedown — operators want to confirm the right blob and spot cases like “this hash is pinned” or “this is an idempotent re-run” before committing to the durable eviction.

admin_url: Option<String>

Base URL of the node’s admin HTTP surface. See health --admin-url for resolution precedence (flag → env → config → default).

config: Option<PathBuf>

Path to the TOML config file used to derive the admin URL when --admin-url / DECDN_ADMIN_URL are unset.

json: bool

Emit the admin response body as JSON instead of a human-readable line.

timeout_ms: u64

Roundtrip timeout in milliseconds.

Trait Implementations

impl Args for EvictArgs

fn group_id() -> Option<Id>

Report the ArgGroup::id for this set of arguments

fn augment_args<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate Self via FromArgMatches::from_arg_matches_mut

fn augment_args_for_update<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate self via FromArgMatches::update_from_arg_matches_mut

impl Debug for EvictArgs

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

Formats the value using the given formatter.

impl FromArgMatches for EvictArgs

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.