Enum KernelSource 

#[non_exhaustive]
pub enum KernelSource {
    Tarball,
    Git {
        git_hash: Option<String>,
        git_ref: Option<String>,
    },
    Local {
        source_tree_path: Option<PathBuf>,
        git_hash: Option<String>,
    },
}

How a cached kernel’s source was acquired, with per-variant payload (git details for Git, source-tree path and git hash for Local).

Serialized as {"type": "tarball"}, {"type": "git", "git_hash": ..., "ref": ...}, or {"type": "local", "source_tree_path": ..., "git_hash": ...}. Every per-variant payload field is emitted explicitly — Option fields serialize as null when None rather than being skipped, so JSON consumers see stable keys across every variant regardless of which optional payload values are set.

On deserialize, serde_json treats absent Option keys as None, so an old metadata.json that drops git_hash, ref, or source_tree_path still round-trips. Cache-integrity enforcement (truncated metadata.json surfacing as ListedEntry::Corrupt via crate::cache::CacheDir::list) rides on the required non-Option fields of KernelMetadata, not on the optional payloads here.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Tarball

Downloaded tarball from kernel.org (version / prefix / EOL probe paths).

Git

Shallow clone of a git URL at a caller-specified ref.

Fields

git_hash: Option<String>

Git commit hash of the kernel source (short form).

git_ref: Option<String>

Git ref used for checkout (branch, tag, or ref spec).

Local

Build of a local on-disk kernel source tree.

Fields

source_tree_path: Option<PathBuf>

Path to the source tree on disk. None when the tree has been sanitized for remote cache transport or is otherwise unavailable.

git_hash: Option<String>

Git commit hash of the source tree at build time (short form). None when the tree is not a git repository, the hash could not be read, or the worktree is dirty — a HEAD hash does not describe a tree with uncommitted changes, so identifying it by that hash would mislead a reproducer.

Implementations

impl KernelSource

pub fn as_local_git_hash(&self) -> Option<&str>

Borrow the git_hash field on a KernelSource::Local variant. Returns None for any other variant or when the Local variant carries git_hash: None (dirty / non-git tree at acquire time).

Mainly used by crate::cli::kernel_build_pipeline’s post-build dirty re-check, which compares the post-build HEAD hash against the acquire-time hash to detect mid-build commits or branch flips. Borrows rather than clones so the caller does not pay an allocation when only comparing.

pub fn git(git_hash: impl Into<String>, git_ref: impl Into<String>) -> Self

Construct KernelSource::Git with both git_hash and git_ref populated. Use struct-literal syntax directly if either field should be None.

Trait Implementations

impl Clone for KernelSource

fn clone(&self) -> KernelSource

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for KernelSource

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for KernelSource

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for KernelSource

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

Formats the value using the given formatter.

impl PartialEq for KernelSource

fn eq(&self, other: &KernelSource) -> 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 KernelSource

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for KernelSource

impl StructuralPartialEq for KernelSource