Enum ProtocolVersion 

pub enum ProtocolVersion {
    V0,
    V1,
    V2(u32),
}

Protocol version. This can be extracted from the payload of the sync packet and will determine what features a connection supports.

Variants

V0

Protocol version 0

V1

Protocol version 1

V2(u32)

Protocol version 2 with a random 32-bit integer nonce

Implementations

impl ProtocolVersion

pub const LATEST: ProtocolVersion

The latest protocol version.

pub fn magic(&self) -> Vec<u8>

Magic sent in the sync packet of the USB protocol.

The format is a byte string of the form vsock:0, where the 0 indicates protocol version 0, and we expect the reply sync packet to have the exact same contents. As we version the protocol this may increment.

In version 2, the format is vsock:2:<nonce> where <nonce> is a random 32-bit unsigned integer (in hexadecimal).

To document the semantics, let’s say this header were “vsock:3”. The device could reply with a lower number, say “vsock:1”. This is the device requesting a downgrade, and if we accept we send the final sync with “vsock:1”. Otherwise we hang up.

pub fn from_magic(magic: &[u8]) -> Option<ProtocolVersion>

Derive the protocol version from the magic sent in the sync packet.

pub fn negotiate( &self, host_version: &ProtocolVersion, ) -> Option<ProtocolVersion>

Given self is the protocol version the target prefers and host_version is the protocol version sent in the magic as the host connects, find the protocol version that should be sent in the reply magic and used for the connection. If None, negotiation has broken down.

Trait Implementations

impl Clone for ProtocolVersion

fn clone(&self) -> ProtocolVersion

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ProtocolVersion

impl Debug for ProtocolVersion

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

Formats the value using the given formatter.

impl Display for ProtocolVersion

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

Formats the value using the given formatter.

impl Eq for ProtocolVersion

impl PartialEq for ProtocolVersion

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ProtocolVersion