Struct PathReference 

pub struct PathReference {
    pub location: PartitionReference,
    pub path: String,
}

URI-style path reference for locating files across partitions

Supports two addressing modes:

• boot():/path - The partition where bootloader was loaded from
• guid:PARTUUID:/path - Partition identified by GPT PARTUUID

Fields

location: PartitionReference

Which partition contains the file

path: String

Absolute path within that partition (must start with /)

Implementations

impl PathReference

pub fn parse(s: &str) -> Result<Self, PathRefParseError>

Parse a URI-style path reference

Rules

• Resource and path separated by :

Examples

PathReference::parse("boot():/vmlinuz-linux")?;
PathReference::parse("boot():/EFI/BOOT/BOOTX64.EFI")?;
PathReference::parse("guid(550e8400-e29b-41d4-a716-446655440000)/vmlinuz")?;
PathReference::parse("iso(myfile.iso)/vmlinuz")?; // with feature 'iso'

Errors

• MissingDelimiter - No : found
• InvalidPath - Path doesn’t start with / or is empty after :
• UnknownResource - Resource type not recognized
• InvalidGuid - GUID format incorrect (wrong length, invalid hex, missing hyphens)
• InvalidSyntax - boot() has unexpected content in parens

pub fn to_uri(&self) -> String

Convert back to canonical URI string

Example

let uri = path_ref.to_uri();
assert_eq!(uri, "boot():/vmlinuz");

Trait Implementations

impl Clone for PathReference

fn clone(&self) -> PathReference

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PathReference

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for PathReference

fn eq(&self, other: &PathReference) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for PathReference

impl StructuralPartialEq for PathReference