ax-task 0.6.9

ArceOS task management module
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

//! Lock dependency graph, diagnostics, and runtime capability boundary.

mod backend;
#[cfg(feature = "multitask")]
pub(crate) mod mutex;
mod state;
mod trace;
mod types;

pub(crate) use self::trace::*;
pub use self::{state::*, types::*};

#[cfg(all(test, feature = "lockdep", feature = "smp"))]
pub(crate) const TEST_MAX_HELD_LOCKS: usize = types::MAX_HELD_LOCKS;

/// Enables or disables lockdep trace recording.
pub fn set_lockdep_trace_enabled(enabled: bool) {
    set_trace_enabled(enabled);
}

/// Dumps the current lockdep trace buffer through the lockdep runtime console.
pub fn dump_lockdep_trace() {
    dump_trace_buffer();
}

#[derive(Clone, Copy)]
pub(crate) struct Lockdep {
    addr: usize,
    is_try: bool,
    kind: &'static str,
    detail: Option<&'static str>,
}

impl Lockdep {
    #[inline(always)]
    pub(crate) fn prepare(
        kind: &'static str,
        addr: usize,
        is_try: bool,
        detail: Option<&'static str>,
    ) -> Self {
        trace::trace_lock_begin(kind, addr, is_try, detail);
        Self {
            addr,
            is_try,
            kind,
            detail,
        }
    }

    #[inline(always)]
    pub(crate) fn finish(&self, acquired: bool) {
        trace::trace_lock_finish(self.kind, self.addr, self.is_try, acquired, self.detail);
    }

    #[inline(always)]
    pub(crate) fn release(kind: &'static str, addr: usize, detail: Option<&'static str>) {
        trace::trace_unlock(kind, addr, detail);
    }
}