Enum `Ipv6MulticastScope`

enum Ipv6MulticastScope

Scope of an IPv6 multicast address as defined in IETF RFC 7346 section 2, which updates IETF RFC 4291 section 2.7.

Stability Guarantees

Scopes 0 and F are currently reserved by IETF, and may be assigned in the future. For this reason, the enum variants for those two scopes are not currently nameable. You can still check for them in your code using as casts.

Examples

#![feature(ip)]

use std::net::Ipv6Addr;
use std::net::Ipv6MulticastScope::*;

// An IPv6 multicast address with global scope (`ff0e::`).
let address = Ipv6Addr::new(0xff0e, 0, 0, 0, 0, 0, 0, 0);

// Will print "Global scope".
match address.multicast_scope() {
    Some(InterfaceLocal) => println!("Interface-Local scope"),
    Some(LinkLocal) => println!("Link-Local scope"),
    Some(RealmLocal) => println!("Realm-Local scope"),
    Some(AdminLocal) => println!("Admin-Local scope"),
    Some(SiteLocal) => println!("Site-Local scope"),
    Some(OrganizationLocal) => println!("Organization-Local scope"),
    Some(Global) => println!("Global scope"),
    Some(s) => {
        let snum = s as u8;
        if matches!(0x0 | 0xF, snum) {
            println!("Reserved scope {snum:X}")
        } else {
            println!("Unassigned scope {snum:X}")
        }
    }
    None => println!("Not a multicast address!")
}

Variants

InterfaceLocal: Interface-Local scope.
LinkLocal: Link-Local scope.
RealmLocal: Realm-Local scope.
AdminLocal: Admin-Local scope.
SiteLocal: Site-Local scope.
Unassigned6: Scope 6. Unassigned, available for administrators to define additional multicast regions.
Unassigned7: Scope 7. Unassigned, available for administrators to define additional multicast regions.
OrganizationLocal: Organization-Local scope.
Unassigned9: Scope 9. Unassigned, available for administrators to define additional multicast regions.
UnassignedA: Scope A. Unassigned, available for administrators to define additional multicast regions.
UnassignedB: Scope B. Unassigned, available for administrators to define additional multicast regions.
UnassignedC: Scope C. Unassigned, available for administrators to define additional multicast regions.
UnassignedD: Scope D. Unassigned, available for administrators to define additional multicast regions.
Global: Global scope.