aprender-cupti 0.31.1

Rust bindings for NVIDIA CUPTI profiling - ComputeBrick analysis
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97

//! Error types for trueno-cupti.

use std::fmt;

/// Result type for CUPTI operations.
pub type CuptiResult<T> = Result<T, CuptiError>;

/// Errors from CUPTI operations.
#[derive(Debug, Clone, PartialEq, Eq)]
pub enum CuptiError {
    /// CUPTI library not available on this system.
    NotAvailable,

    /// CUPTI initialization failed.
    InitializationFailed,

    /// Invalid parameter passed to CUPTI.
    InvalidParameter,

    /// CUPTI out of memory.
    OutOfMemory,

    /// Activity kind not supported.
    ActivityNotSupported,

    /// Metric not supported on this device.
    MetricNotSupported,

    /// Profiling is already active.
    AlreadyActive,

    /// Profiling is not active.
    NotActive,

    /// Buffer too small for requested data.
    BufferTooSmall,

    /// Hardware resource limit exceeded.
    HardwareLimitExceeded,

    /// CUDA driver error.
    CudaError(i32),

    /// Unknown CUPTI error code.
    Unknown(i32),
}

impl fmt::Display for CuptiError {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        match self {
            CuptiError::NotAvailable => write!(f, "CUPTI not available on this system"),
            CuptiError::InitializationFailed => write!(f, "CUPTI initialization failed"),
            CuptiError::InvalidParameter => write!(f, "Invalid parameter"),
            CuptiError::OutOfMemory => write!(f, "Out of memory"),
            CuptiError::ActivityNotSupported => write!(f, "Activity kind not supported"),
            CuptiError::MetricNotSupported => write!(f, "Metric not supported on this device"),
            CuptiError::AlreadyActive => write!(f, "Profiling is already active"),
            CuptiError::NotActive => write!(f, "Profiling is not active"),
            CuptiError::BufferTooSmall => write!(f, "Buffer too small"),
            CuptiError::HardwareLimitExceeded => write!(f, "Hardware resource limit exceeded"),
            CuptiError::CudaError(code) => write!(f, "CUDA driver error: {}", code),
            CuptiError::Unknown(code) => write!(f, "Unknown CUPTI error: {}", code),
        }
    }
}

impl std::error::Error for CuptiError {}

impl CuptiError {
    /// Create error from CUPTI result code.
    pub fn from_cupti_result(code: i32) -> CuptiResult<()> {
        match code {
            0 => Ok(()), // CUPTI_SUCCESS
            1 => Err(CuptiError::InvalidParameter),
            2 => Err(CuptiError::OutOfMemory),
            3 => Err(CuptiError::InitializationFailed),
            _ => Err(CuptiError::Unknown(code)),
        }
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_error_display() {
        let err = CuptiError::NotAvailable;
        assert_eq!(format!("{}", err), "CUPTI not available on this system");
    }

    #[test]
    fn test_from_cupti_result() {
        assert!(CuptiError::from_cupti_result(0).is_ok());
        assert!(CuptiError::from_cupti_result(1).is_err());
    }
}