devpath 1.0.1

UEFI Device Path parsing library
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

# devpath

[![CI](https://github.com/AMDEPYC/devpath/workflows/ci/badge.svg)](https://github.com/AMDEPYC/devpath/actions/workflows/ci.yml)
[![Crates.io](https://img.shields.io/crates/v/devpath.svg)](https://crates.io/crates/devpath)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Rust](https://img.shields.io/badge/rust-1.80%2B-blue.svg)](https://www.rust-lang.org)

A `no_std` Rust library for parsing and manipulating UEFI device paths as defined in the UEFI 2.11 specification.

## Usage

```bash
cargo add devpath
```

### Basic Example

```rust
use devpath::{Paths, FromBytes};

// Parse device paths from raw bytes
let raw_bytes = &[
    0x02, 0x01, 0x0c, 0x00,  // ACPI device path
    0xd0, 0x41, 0x03, 0x0a,  // HID: PNP0A03 (PCI Root Bridge)
    0x00, 0x00, 0x00, 0x00,  // UID: 0
    0x01, 0x01, 0x06, 0x00,  // PCI device path  
    0x00, 0x1f,              // Function: 0, Device: 31
    0x7f, 0xff, 0x04, 0x00,  // End of device path
];

let paths = Paths::from_bytes(raw_bytes)?;
println!("Parsed {} device path(s)", paths.len());
```

## Features

- **Complete UEFI 2.11 Support** - All device path types: Hardware, ACPI, Messaging, Media, and BIOS
- **Type-Safe Parsing** - Structured representation of device path nodes
- **no_std Compatible** - Works in embedded and firmware environments
- **Zero Unsafe Code** - Memory-safe parsing with comprehensive error handling

## Device Path Types

- **Hardware** - PCI, memory-mapped devices, controllers
- **ACPI** - ACPI namespace devices, _ADR devices  
- **Messaging** - USB, SATA, NVMe, network protocols, Bluetooth
- **Media** - Hard drives, file paths, CD-ROM, RAM disks
- **BIOS** - Legacy BIOS boot specification devices

## Documentation

Full API documentation is available on [docs.rs](https://docs.rs/devpath).

## License

This project is licensed under the [MIT License](LICENSE).