Enum rustls_pki_types::ServerName
source · #[non_exhaustive]pub enum ServerName<'a> {
DnsName(DnsName<'a>),
IpAddress(IpAddr),
}
Expand description
Encodes ways a client can know the expected name of the server.
This currently covers knowing the DNS name of the server, but
will be extended in the future to supporting privacy-preserving names
for the server (“ECH”). For this reason this enum is non_exhaustive
.
Making one
If you have a DNS name as a &str
, this type implements TryFrom<&str>
,
so you can do:
ServerName::try_from("example.com").expect("invalid DNS name");
// or, alternatively...
let x = "example.com".try_into().expect("invalid DNS name");
Variants (Non-exhaustive)§
This enum is marked as non-exhaustive
Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.
DnsName(DnsName<'a>)
The server is identified by a DNS name. The name is sent in the TLS Server Name Indication (SNI) extension.
IpAddress(IpAddr)
The server is identified by an IP address. SNI is not done.
Implementations§
source§impl<'a> ServerName<'a>
impl<'a> ServerName<'a>
sourcepub fn to_owned(&self) -> ServerName<'static>
Available on crate feature alloc
only.
pub fn to_owned(&self) -> ServerName<'static>
alloc
only.Produce an owned ServerName
from this (potentially borrowed) ServerName
.
Trait Implementations§
source§impl<'a> Clone for ServerName<'a>
impl<'a> Clone for ServerName<'a>
source§fn clone(&self) -> ServerName<'a>
fn clone(&self) -> ServerName<'a>
Returns a copy of the value. Read more
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from
source
. Read moresource§impl<'a> Debug for ServerName<'a>
impl<'a> Debug for ServerName<'a>
source§impl<'a> Hash for ServerName<'a>
impl<'a> Hash for ServerName<'a>
source§impl<'a> PartialEq for ServerName<'a>
impl<'a> PartialEq for ServerName<'a>
source§fn eq(&self, other: &ServerName<'a>) -> bool
fn eq(&self, other: &ServerName<'a>) -> bool
This method tests for
self
and other
values to be equal, and is used
by ==
.source§impl<'a> TryFrom<&'a [u8]> for ServerName<'a>
impl<'a> TryFrom<&'a [u8]> for ServerName<'a>
source§impl<'a> TryFrom<&'a str> for ServerName<'a>
impl<'a> TryFrom<&'a str> for ServerName<'a>
Attempt to make a ServerName from a string by parsing as a DNS name or IP address.
impl<'a> Eq for ServerName<'a>
impl<'a> StructuralEq for ServerName<'a>
impl<'a> StructuralPartialEq for ServerName<'a>
Auto Trait Implementations§
impl<'a> RefUnwindSafe for ServerName<'a>
impl<'a> Send for ServerName<'a>
impl<'a> Sync for ServerName<'a>
impl<'a> Unpin for ServerName<'a>
impl<'a> UnwindSafe for ServerName<'a>
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more