Enum Request 

pub enum Request {
    Ping,
    Shutdown,
    Status,
    Lookup {
        cache_key: String,
    },
    Store {
        cache_key: String,
        artifact: ArtifactData,
    },
    SessionStart {
        client_pid: u32,
        working_dir: PathBuf,
        log_file: Option<PathBuf>,
        track_stats: bool,
        journal_path: Option<PathBuf>,
    },
    Compile {
        session_id: String,
        args: Vec<String>,
        cwd: PathBuf,
        compiler: PathBuf,
        env: Option<Vec<(String, String)>>,
    },
    SessionEnd {
        session_id: String,
    },
    Clear,
    CompileEphemeral {
        client_pid: u32,
        working_dir: PathBuf,
        compiler: PathBuf,
        args: Vec<String>,
        cwd: PathBuf,
        env: Option<Vec<(String, String)>>,
    },
    LinkEphemeral {
        client_pid: u32,
        tool: PathBuf,
        args: Vec<String>,
        cwd: PathBuf,
        env: Option<Vec<(String, String)>>,
    },
    SessionStats {
        session_id: String,
    },
    FingerprintCheck {
        cache_file: PathBuf,
        cache_type: String,
        root: PathBuf,
        extensions: Vec<String>,
        include_globs: Vec<String>,
        exclude: Vec<String>,
    },
    FingerprintMarkSuccess {
        cache_file: PathBuf,
    },
    FingerprintMarkFailure {
        cache_file: PathBuf,
    },
    FingerprintInvalidate {
        cache_file: PathBuf,
    },
}

A request from client to daemon.

Variants

Ping

Health check.

Shutdown

Request daemon shutdown.

Status

Request daemon status/statistics.

Lookup

Look up a cached artifact by cache key.

Fields

cache_key: String

Hex-encoded cache key.

Store

Store a compilation artifact.

Fields

cache_key: String

Hex-encoded cache key.

artifact: ArtifactData

The artifact data to store.

SessionStart

Start a new session with the daemon.

Fields

client_pid: u32

Client process ID.

working_dir: PathBuf

Client working directory.

log_file: Option<PathBuf>

Optional path to a log file for this session.

track_stats: bool

Whether to track per-session statistics.

journal_path: Option<PathBuf>

Path for per-session JSONL compile journal (must end in .jsonl).

Compile

Compile a source file within an existing session.

Fields

session_id: String

Session ID from a prior SessionStart (UUID string).

args: Vec<String>

Compiler arguments (e.g., [“-c”, “hello.cpp”, “-o”, “hello.o”]).

cwd: PathBuf

Working directory for the compilation.

compiler: PathBuf

Path to the compiler executable (required).

env: Option<Vec<(String, String)>>

Client environment variables to pass to the compiler process. If None, the daemon’s own environment is inherited (backward compat). If Some, the compiler process uses exactly these env vars.

SessionEnd

End a session.

Fields

session_id: String

Session ID to end (UUID string).

Clear

Clear all caches (artifacts, metadata, dep graph).

CompileEphemeral

Single-roundtrip ephemeral compile: session start + compile + session end in one message. Used by the CLI in drop-in wrapper mode to avoid 3 IPC roundtrips per invocation.

Fields

client_pid: u32

Client process ID.

working_dir: PathBuf

Client working directory.

compiler: PathBuf

Path to the compiler executable.

args: Vec<String>

Compiler arguments (e.g., [“-c”, “hello.cpp”, “-o”, “hello.o”]).

cwd: PathBuf

Working directory for the compilation.

env: Option<Vec<(String, String)>>

Client environment variables to pass to the compiler process.

LinkEphemeral

Single-roundtrip ephemeral link/archive: used for zccache ar ... or zccache ld ... in drop-in wrapper mode.

Fields

client_pid: u32

Client process ID.

tool: PathBuf

Path to the linker/archiver tool (ar, ld, lib.exe, link.exe, etc.).

args: Vec<String>

Tool arguments (e.g., [“rcs”, “libfoo.a”, “a.o”, “b.o”]).

cwd: PathBuf

Working directory for the link operation.

env: Option<Vec<(String, String)>>

Client environment variables.

SessionStats

Query per-session statistics without ending the session. NOTE: Appended at end to preserve bincode variant indices.

Fields

session_id: String

Session ID to query (UUID string).

FingerprintCheck

Check if files have changed since last successful fingerprint. NOTE: Appended at end to preserve bincode variant indices.

Fields

cache_file: PathBuf

Path to the cache file (e.g., .cache/lint.json).

cache_type: String

Cache algorithm: “hash” or “two-layer”.

root: PathBuf

Root directory to scan.

extensions: Vec<String>

File extensions to include (without dot, e.g., “rs”, “cpp”). Empty = all files. Conflicts with include_globs.

include_globs: Vec<String>

Glob patterns for files to include (e.g., “**/*.rs”). Empty = use extensions filter.

exclude: Vec<String>

Patterns or directory names to exclude.

FingerprintMarkSuccess

Mark the previous fingerprint check as successful.

Fields

cache_file: PathBuf

Path to the cache file.

FingerprintMarkFailure

Mark the previous fingerprint check as failed.

Fields

cache_file: PathBuf

Path to the cache file.

FingerprintInvalidate

Invalidate a fingerprint cache (delete all state).

Fields

cache_file: PathBuf

Path to the cache file.

Trait Implementations

impl Clone for Request

fn clone(&self) -> Request

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Request

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Request

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Request

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Request

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 Request