Struct BenchPlan 

pub struct BenchPlan {
    pub schema: String,
    pub kernel: String,
    pub entry: String,
    pub cc: String,
    pub allow_unsafe_reason: Option<String>,
    pub candidates: Vec<Candidate>,
}

A plan.v1 document: every candidate to measure, and how.

Fields

schema: String

Schema tag; always plan.v1.

kernel: String

The kernel being tuned.

entry: String

The #[kernel] entry point to launch, as named in the PTX.

cc: String

The capability the gate ran at, carried so the runner can refuse a plan built for a different target than the device it holds.

allow_unsafe_reason: Option<String>

Present iff the plan includes gate-refused candidates: the explicit, recorded reason the operator gave to –allow-unsafe (see the README). Never a default.

candidates: Vec<Candidate>

The candidates to measure, in plan order. A strategy visits them in its own order without reordering this list.

Implementations

impl BenchPlan

pub fn write(&self, path: &Path) -> Result<(), PlanError>

Write the plan as pretty JSON.

pub fn load(path: &Path) -> Result<Self, PlanError>

Read a plan, refusing any schema but plan.v1.

The schema check is not a formality: the runner launches whatever a plan tells it to, on a real device, so a document it half-understands is worse than one it rejects.

pub fn param_slots(candidate: &Candidate) -> usize

Number of .param slots this candidate’s args expand to (each ArgSpec is exactly one slot; slices appear as explicit ptr + len_of pairs). Used to validate against the PTX entry signature.

Trait Implementations

impl Clone for BenchPlan

fn clone(&self) -> BenchPlan

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BenchPlan

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for BenchPlan

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for BenchPlan

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

where __S: Serializer,

Serialize this value into the given Serde serializer.