Skip to main content

DebugPtxInstrumenter

Struct DebugPtxInstrumenter 

Source
pub struct DebugPtxInstrumenter { /* private fields */ }
Expand description

Instruments PTX source code with debugging checks.

This instrumenter inserts additional PTX instructions for bounds checking, NaN detection, and printf buffer support. The instrumented code writes diagnostic data to a designated debug buffer that the host can read back after kernel execution.

Implementations§

Source§

impl DebugPtxInstrumenter

Source

pub fn new(config: &KernelDebugConfig) -> Self

Create an instrumenter from a debug configuration.

Source

pub fn instrument_bounds_checks(&self, ptx: &str) -> String

Insert bounds-checking instrumentation into PTX source.

Adds setp + trap sequences after every ld.global / st.global instruction to validate the address against the allocation size parameter.

Source

pub fn instrument_nan_checks(&self, ptx: &str) -> String

Insert NaN-detection instrumentation into PTX source.

After every floating-point arithmetic instruction (add.f32, mul.f64, etc.) a testp.nan check is inserted.

Source

pub fn instrument_printf(&self, ptx: &str) -> String

Insert printf buffer support into PTX source.

Adds a .param .u64 __oxicuda_printf_buf to each entry and inserts stub store sequences where // PRINTF markers appear.

Source

pub fn strip_debug(&self, ptx: &str) -> String

Remove all OxiCUDA debug instrumentation from PTX source.

Trait Implementations§

Source§

impl Debug for DebugPtxInstrumenter

Source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more