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
use sbi_spec::binary::{HartMask, SbiRet};
/// Inter-processor interrupt support.
pub trait Ipi {
/// Send an inter-processor interrupt to all the harts defined in `hart_mask`.
///
/// Inter-processor interrupts manifest at the receiving harts as the supervisor software interrupts.
///
/// # Return value
///
/// The possible return error codes returned in `SbiRet.error` are shown in the table below:
///
/// | Return code | Description
/// |:--------------------------|:----------------------------------------------
/// | `SbiRet::success()` | IPI was sent to all the targeted harts successfully.
/// | `SbiRet::invalid_param()` | At least one hartid constructed from `hart_mask`, is not valid, i.e. either the hartid is not enabled by the platform or is not available to the supervisor.
/// | `SbiRet::failed()` | The request failed for unspecified or unknown other reasons.
fn send_ipi(&self, hart_mask: HartMask) -> SbiRet;
/// Function internal to macros. Do not use.
#[doc(hidden)]
#[inline]
fn _rustsbi_probe(&self) -> usize {
sbi_spec::base::UNAVAILABLE_EXTENSION.wrapping_add(1)
}
}
impl<T: Ipi> Ipi for &T {
#[inline]
fn send_ipi(&self, hart_mask: HartMask) -> SbiRet {
T::send_ipi(self, hart_mask)
}
}
impl<T: Ipi> Ipi for Option<T> {
#[inline]
fn send_ipi(&self, hart_mask: HartMask) -> SbiRet {
self.as_ref().map_or(SbiRet::not_supported(), |inner| {
T::send_ipi(inner, hart_mask)
})
}
#[inline]
fn _rustsbi_probe(&self) -> usize {
match self {
Some(_) => sbi_spec::base::UNAVAILABLE_EXTENSION.wrapping_add(1),
None => sbi_spec::base::UNAVAILABLE_EXTENSION,
}
}
}