arm_vgic 0.5.4

ARM Virtual Generic Interrupt Controller (VGIC) implementation.
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

use std::{fs, path::Path};

use arm_vgic::VgicError;
use axdevice_base::{AccessWidth, DeviceError};

#[test]
fn crate_uses_typed_errors_without_errno_contracts() {
    let crate_dir = Path::new(env!("CARGO_MANIFEST_DIR"));
    let manifest = fs::read_to_string(crate_dir.join("Cargo.toml")).unwrap();
    assert!(!manifest.contains(&["ax", "errno"].join("-")));
    assert_directory_excludes(&crate_dir.join("src"), &["ax", "errno"].join("_"));
}

#[test]
fn invalid_vgic_access_converts_to_device_input_error() {
    let error = VgicError::InvalidAccess {
        operation: "read",
        offset: 0x80,
        width: AccessWidth::Qword,
    };
    let device: DeviceError = error.into();

    assert!(matches!(device, DeviceError::InvalidInput { .. }));
    assert!(device.to_string().contains("0x80"));
}

#[cfg(feature = "vgicv3")]
#[test]
fn vgic_rejects_out_of_range_irq_without_panicking() {
    assert!(matches!(
        arm_vgic::v3::vgicd::VGicD::validate_irq(1024),
        Err(VgicError::InvalidIrq {
            irq: 1024,
            max: 1024,
        })
    ));
}

fn assert_directory_excludes(directory: &Path, forbidden: &str) {
    for entry in fs::read_dir(directory).unwrap() {
        let path = entry.unwrap().path();
        if path.is_dir() {
            assert_directory_excludes(&path, forbidden);
        } else if path.extension().is_some_and(|extension| extension == "rs") {
            let source = fs::read_to_string(&path).unwrap();
            assert!(!source.contains(forbidden), "{}", path.display());
        }
    }
}