Struct ServerVersionPolicy 

pub struct ServerVersionPolicy { /* private fields */ }

Available on crate feature quic only.

How a server negotiates versions (RFC 9368 §2.3, §5).

The acceptable versions are the endpoint’s supported set; this policy adds what a Version Negotiation packet offers, what the server reports as fully deployed, and which compatible version it prefers. By default it offers and reports everything it accepts and keeps the client’s choice.

Implementations

impl ServerVersionPolicy

pub fn new() -> ServerVersionPolicy

Offer and report everything the endpoint accepts, keep the client’s choice, and grease the advertised list with a reserved version.

pub fn try_with_offered( self, offered: Vec<Version>, ) -> Result<ServerVersionPolicy, VersionPolicyError>

The versions a Version Negotiation packet lists, when narrower than the acceptable set (RFC 9368 §5, “Offered Versions”).

pub fn try_with_fully_deployed( self, fully_deployed: Vec<Version>, ) -> Result<ServerVersionPolicy, VersionPolicyError>

The versions reported in version_information, when narrower than the acceptable set (RFC 9368 §5, “Fully Deployed Versions”). May be empty during a rollout.

pub fn try_with_preference( self, preference: VersionPreference, ) -> Result<ServerVersionPolicy, VersionPolicyError>

Which compatible version to move a connection to when the client offers a choice.

pub fn with_reserved_version_grease(self, grease: bool) -> ServerVersionPolicy

Whether to add a reserved version to the reported list. On by default.

pub fn set_reserved_version_grease( &mut self, grease: bool, ) -> &mut ServerVersionPolicy

Whether to add a reserved version to the reported list. On by default.

pub fn preference(&self) -> &VersionPreference

Which compatible version this server moves a connection to.

pub fn may_switch(&self) -> bool

Whether this policy can ever pick a version other than the client’s.

pub fn offered<'a>(&'a self, acceptable: &'a [Version]) -> &'a [Version]

The versions a Version Negotiation packet lists.

pub fn negotiate( &self, chosen: Version, client_available: Option<&[Version]>, acceptable: &[Version], ) -> Version

The version to continue in, given the client’s first flight version and what it says that flight is compatible with (RFC 9368 §2.3, RFC 9369 §4.1).

pub fn information( &self, negotiated: Version, acceptable: &[Version], grease: Version, ) -> VersionInformation

What the server advertises: the negotiated version and its fully deployed set.

Trait Implementations

impl Clone for ServerVersionPolicy

fn clone(&self) -> ServerVersionPolicy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ServerVersionPolicy

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

Formats the value using the given formatter.

impl Default for ServerVersionPolicy

fn default() -> ServerVersionPolicy

Returns the “default value” for a type.

impl Eq for ServerVersionPolicy

impl PartialEq for ServerVersionPolicy

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ServerVersionPolicy