Enum LinkKind 

pub enum LinkKind {
    Default,
    Static,
    WholeArchive,
}

Represents how a library should be linked.

The link kind determines what cargo metadata directive is emitted:

• Default → cargo:rustc-link-lib=name
• Static → cargo:rustc-link-lib=static:[-bundle]=name
• WholeArchive → cargo:rustc-link-lib=static:+whole-archive[,-bundle]=name

Variants

Default

Let the linker decide (typically finds .so first, then .a).

Used for system libraries like pthread, numa, lz4 where the .a file either doesn’t exist or is in a system directory.

Static

Static library without +whole-archive.

Used for libraries where a .a file exists in a non-system directory, but constructor functions don’t need to be preserved.

WholeArchive

Static library with +whole-archive.

Required for libraries using constructor functions (e.g., DPDK’s RTE_INIT macros) to ensure all symbols are included even if not directly referenced. Without this, the linker would discard “unused” constructor symbols.

Trait Implementations

impl Clone for LinkKind

fn clone(&self) -> LinkKind

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LinkKind

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

Formats the value using the given formatter.

impl PartialEq for LinkKind

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

impl Eq for LinkKind

impl StructuralPartialEq for LinkKind