Struct RemoteLocation 

pub struct RemoteLocation(/* private fields */);

A remote location as entered: either an already-canonical file, or an unresolved home-relative query on one endpoint.

Implementations

impl RemoteLocation

pub fn parse(value: &str) -> Result<Self, AddressError>

Admit one textual location. A raw ~ first component yields the unresolved home form; everything else must decode to a canonical absolute file. Pure: no filesystem, no subprocess, no home guessing.

pub fn endpoint(&self) -> &RemoteEndpoint

The endpoint this location addresses — the pooled-session identity even before the path is resolved.

pub fn absolute_file(&self) -> Option<&RemoteFile>

The canonical file, when this location is already absolute and resolved. A home query returns None: only a session that negotiated expand-path@openssh.com may publish its canonical identity.

pub fn home_relative(&self) -> Option<&Path>

The unresolved home-relative bytes (~/log), exactly as decoded.

Trait Implementations

impl Clone for RemoteLocation

fn clone(&self) -> RemoteLocation

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RemoteLocation

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RemoteLocation

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl Display for RemoteLocation

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

Formats the value using the given formatter.

impl Eq for RemoteLocation

impl From<RemoteFile> for RemoteLocation

fn from(file: RemoteFile) -> Self

Converts to this type from the input type.

impl Hash for RemoteLocation

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for RemoteLocation

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for RemoteLocation

Serde carries the canonical validated URI — one string, re-parsed on the way in, so stored values can never bypass admission.

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for RemoteLocation