Enum fidl_fuchsia_hardware_network::MacAddressingRequest

pub enum MacAddressingRequest {
    GetUnicastAddress {
        responder: MacAddressingGetUnicastAddressResponder,
    },
    SetMode {
        mode: MacFilterMode,
        responder: MacAddressingSetModeResponder,
    },
    AddMulticastAddress {
        address: MacAddress,
        responder: MacAddressingAddMulticastAddressResponder,
    },
    RemoveMulticastAddress {
        address: MacAddress,
        responder: MacAddressingRemoveMulticastAddressResponder,
    },
}

Variants

GetUnicastAddress

Gets the Device’s current unicast MAC address.

Implementers of this API do not need to return a uniquely identifiable MAC; the unicast address returned is the one that is currently in use to filter unicast frames, or that identifies the device on a link it’s currently on. Users of this API must not rely on the stability or uniqueness of the returned value to identify or disambiguate device instances.

• response address device’s unicast MAC address.

Fields

responder: MacAddressingGetUnicastAddressResponder

SetMode

Sets requested operating mode of this device to mode.

The requested mode is attached to the current client connection to the device. Because multiple clients can be attached to the same device at once, the mode with the least restrictions is the one actively put into effect into the underlying device implementation.

If the device does not support the requested mode, but supports a mode that is more open than the requested one, SetMode succeeds regardless. Otherwise, if the device only supports more restrictive modes than the one requested, SetMode returns ZX_ERR_NOT_SUPPORTED.

Clients must be aware that the resource being accessed is shared, and that the device may be effectively operating at a more open level than the one that was requested (although never at one more restrictive).

• request mode request mode to attach to.

• response status ZX_ERR_NOT_SUPPORTED it the device only supports mode more restrictive than the one requested.

Fields

mode: MacFilterMode

responder: MacAddressingSetModeResponder

AddMulticastAddress

Adds multicast address to the list of multicast groups.

The list of multicast addresses kept is untouched by calls to SetMode. If the device’s mode is not MULTICAST_FILTER, the list of multicast addresses is ignored.

• request address multicast address to add to the list.

• response status ZX_ERR_INVALID_ARGS if address is not a multicast address.

Fields

address: MacAddress

responder: MacAddressingAddMulticastAddressResponder

RemoveMulticastAddress

Removes multicast address from the list of multicast groups.

• request address multicast address to remove from the list.

• response status ZX_ERR_INVALID_ARGS if address is not a multicast address.

Fields

address: MacAddress

responder: MacAddressingRemoveMulticastAddressResponder

Implementations

impl MacAddressingRequest

pub fn into_get_unicast_address( self ) -> Option<MacAddressingGetUnicastAddressResponder>

pub fn into_set_mode( self ) -> Option<(MacFilterMode, MacAddressingSetModeResponder)>

pub fn into_add_multicast_address( self ) -> Option<(MacAddress, MacAddressingAddMulticastAddressResponder)>

pub fn into_remove_multicast_address( self ) -> Option<(MacAddress, MacAddressingRemoveMulticastAddressResponder)>

pub fn method_name(&self) -> &'static str

Name of the method defined in FIDL

Trait Implementations

impl Debug for MacAddressingRequest

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

Formats the value using the given formatter.