Enum NodeAddr

#[non_exhaustive]
pub enum NodeAddr {
    Translatable(SocketAddr),
    Untranslatable(SocketAddr),
}

This enum is introduced to support address translation only upon opening a connection, as well as to cope with a bug present in older Cassandra and ScyllaDB releases. The bug involves misconfiguration of rpc_address and/or broadcast_rpc_address in system.local to 0.0.0.0. Mitigation involves replacing the faulty address with connection’s address, but then that address must not be subject to AddressTranslator, so we carry that information using this enum. Address translation is never performed on Untranslatable variant.

Variants (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.

Translatable(SocketAddr)

Fetched in Metadata with query_peers() (broadcast by a node itself).

Untranslatable(SocketAddr)

Built from control connection’s address upon query_peers() in order to mitigate the bug described above.

Implementations

impl NodeAddr

pub fn ip(&self) -> IpAddr

IP address of the node.

Keep in mind that this discards the information about whether the address is translatable or not. Don’t be surprised if you get a Translatable address here and won’t be able to reach a node using it, because the node might be reachable through a different address, which must be obtained by translation.

pub fn port(&self) -> u16

Port of the node.

Trait Implementations

impl Clone for NodeAddr

fn clone(&self) -> NodeAddr

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NodeAddr

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

Formats the value using the given formatter.

impl Display for NodeAddr

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

Formats the value using the given formatter.

impl Hash for NodeAddr

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 Ord for NodeAddr

fn cmp(&self, other: &NodeAddr) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for NodeAddr

fn eq(&self, other: &NodeAddr) -> 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 PartialOrd for NodeAddr

fn partial_cmp(&self, other: &NodeAddr) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Copy for NodeAddr

impl Eq for NodeAddr

impl StructuralPartialEq for NodeAddr