<br />

Added: 7

## **PROTOCOLS**

## Device

*Defined in [fuchsia.hardware.network/device.fidl](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/device.fidl;l=85)*

A Network Device.
Added: HEAD

<br />

### Clone

Establishes a new connection to this device.

- request `device` the server end for the new connection.

#### Request

| Name | Type |
|---|---|
| `device` | `server_end:https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#Device` |

### GetInfo

Obtain information about device

- response `info` device information.

#### Request

\<EMPTY\>

#### Response

| Name | Type |
|---|---|
| `info` | `https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#DeviceInfo` |

### GetPort

Connects to a port the given `id`.

- request `id` port to connect to.
- request `port` server end of port channel.

`port` is closed with a `ZX_ERR_NOT_FOUND` epitaph if no port with `id`
exists.

#### Request

| Name | Type |
|---|---|
| `id` | `https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#PortId` |
| `port` | `server_end:https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#Port` |

### GetPortWatcher

Connects a [PortWatcher](https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#PortWatcher) to this device.

- request `watcher` server end of watcher channel.

#### Request

| Name | Type |
|---|---|
| `watcher` | `server_end:https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#PortWatcher` |

### OpenSession

Opens a new session with the network device.

- request `session_name` is used as a debugging label attached to this session.
- request `session_info` contains the necessary information to setup the session's data exchange.

<!-- -->

- response `session` a handle to control the session.
- response `fifos` data-plane FIFOs attached to the session.

<!-- -->

- error `ZX_ERR_NOT_SUPPORTED` if `session_info` contains not supported frame types or descriptors set up.
- error `ZX_ERR_INVALID_ARGS` if `session_info` is missing fields or contains invalid information.
- error `ZX_ERR_INTERNAL` if the data VMO is rejected by the underlying device.

#### Request

| Name | Type |
|---|---|
| `session_name` | `string:64` |
| `session_info` | `https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#SessionInfo` |

#### Response

| Name | Type |
|---|---|
| `payload` | `https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#Device_OpenSession_Result` |

## Diagnostics

*Defined in [fuchsia.hardware.network/diagnostics.fidl](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/diagnostics.fidl;l=10)*

Provides two way communications between device and upper layers to exchange
device health information.
Added: HEAD

<br />

### LogDebugInfoToSyslog

Requests that the device produces debugging information in the system
logs.

The call returns once device debug information has been produced.

#### Request

\<EMPTY\>

#### Response

\<EMPTY\>

## MacAddressing

*Defined in [fuchsia.hardware.network/mac.fidl](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/mac.fidl;l=24)*
Added: HEAD

<br />

### 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.
- response `status` `ZX_ERR_NO_RESOURCES` if there are more than `MAX_MAC_FILTER` addresses installed.

#### Request

| Name | Type |
|---|---|
| `address` | `https://fuchsia.dev/reference/fuchsia.net//https://fuchsia.dev/reference/fuchsia.net#MacAddress` |

#### Response

| Name | Type |
|---|---|
| `status` | `https://fuchsia.dev/reference/zx//https://fuchsia.dev/reference/zx#Result` |

### 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.

#### Request

\<EMPTY\>

#### Response

| Name | Type |
|---|---|
| `address` | `https://fuchsia.dev/reference/fuchsia.net//https://fuchsia.dev/reference/fuchsia.net#MacAddress` |

### 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.

#### Request

| Name | Type |
|---|---|
| `address` | `https://fuchsia.dev/reference/fuchsia.net//https://fuchsia.dev/reference/fuchsia.net#MacAddress` |

#### Response

| Name | Type |
|---|---|
| `status` | `https://fuchsia.dev/reference/zx//https://fuchsia.dev/reference/zx#Result` |

### 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.

#### Request

| Name | Type |
|---|---|
| `mode` | `https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#MacFilterMode` |

#### Response

| Name | Type |
|---|---|
| `status` | `https://fuchsia.dev/reference/zx//https://fuchsia.dev/reference/zx#Result` |

## Port

*Defined in [fuchsia.hardware.network/port.fidl](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/port.fidl;l=125)*

A logical port belonging to a [Device](https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#Device).
Added: HEAD

<br />

### Clone

Establishes a new connection to this port.

- request `port` the server end for the new connection.

#### Request

| Name | Type |
|---|---|
| `port` | `server_end:https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#Port` |

### GetCounters

Retrieves a snapshot of traffic counters on this port.

#### Request

\<EMPTY\>

#### Response

| Name | Type |
|---|---|
| `payload` | `https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#PortGetCountersResponse` |

### GetDevice

Connects to the [Device](https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#Device) this port belongs to.

- request `device` grants access to the parent device.

#### Request

| Name | Type |
|---|---|
| `device` | `server_end:https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#Device` |

### GetDiagnostics

Grants access to [Diagnostics](https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#Diagnostics) for this port.

- request `diagnostics` grants access to diagnostics information.

#### Request

| Name | Type |
|---|---|
| `diagnostics` | `server_end:https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#Diagnostics` |

### GetIdentity

Retrieves a unique event handle that is always associated only with
this port.

This event may be used to uniquely identify a specific port instance
across different APIs in the system.

#### Request

\<EMPTY\>

#### Response

| Name | Type |
|---|---|
| `event` | `handle<event>` |

### GetInfo

Obtain information about port.

- response `info` port information.

#### Request

\<EMPTY\>

#### Response

| Name | Type |
|---|---|
| `info` | `https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#PortInfo` |

### GetMac

Connects to a [MacAddressing](https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#MacAddressing) associated with the port.

- request `mac` mac handle. Closed with `ZX_ERR_NOT_SUPPORTED` if this port does not support mac addressing.

#### Request

| Name | Type |
|---|---|
| `mac` | `server_end:https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#MacAddressing` |

### GetPowerDependencyToken

Gets the Power Broker dependency token for this port's power element.

The token exposes two levels: `0` (off) and `1` (on). Clients lease
level `1` whenever the port's datapath is required and hold the lease
for as long as it is required. Drivers are free to internally
power-manage a leased-but-idle port so long as it's invisible to upper
layers.

The token is fixed for the lifetime of the port.

- response `token` absent if this port does not participate in power management.
- response `token` must have `zx.Rights.DUPLICATE`.

#### Request

\<EMPTY\>

#### Response

| Name | Type |
|---|---|
| `token` | `https://fuchsia.dev/reference/fuchsia.power.broker//https://fuchsia.dev/reference/fuchsia.power.broker#DependencyToken` |

### GetStatus

Obtain the operating port status.

- response `status` snapshot of port's current status.

#### Request

\<EMPTY\>

#### Response

| Name | Type |
|---|---|
| `status` | `https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#PortStatus` |

### GetStatusWatcher

Connects to a [StatusWatcher](https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#StatusWatcher) to observe port status changes.

- request `watcher` handle to the status watcher.
- request `buffer` the number of status changes that the client requests to be stored by `StatusWatcher`. Values are capped at [MAX_STATUS_BUFFER](https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#MAX_STATUS_BUFFER). A value of 0 or 1 causes the `StatusWatcher` to not keep any buffers on status changed. Clients that need to observe all changes to status (as opposed to only the current state) are encouraged to set a buffer value larger than 1, so that all edges can be observed. If `StatusWatcher`'s internal queue is filled and new status changes occur, the oldest samples will be dropped to make room for new ones.

#### Request

| Name | Type |
|---|---|
| `watcher` | `server_end:https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#StatusWatcher` |
| `buffer` | `uint32` |

## PortWatcher

*Defined in [fuchsia.hardware.network/device.fidl](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/device.fidl;l=148)*

Provides iteration over and updates for ports attached to a device.
Added: HEAD

<br />

### Watch

Get the next port event.

The first N calls return [DevicePortEvent.existing](https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#DevicePortEvent.existing) where N is the
number of ports present on the device at the time of the watcher's
creation. The next call returns [DevicePortEvent.idle](https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#DevicePortEvent.idle) to indicate the
end of existing ports. Subsequent calls block until a port is added
([DevicePortEvent.added](https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#DevicePortEvent.added)) or removed ([DevicePortEvent.removed](https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#DevicePortEvent.removed)).

The server closes the `PortWatcher` channel with `ZX_ERR_CANCELED` if
the number of unread events reaches a server-selected limit that is at
least two times [MAX_PORTS](https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#MAX_PORTS). Clients are encouraged to maintain a
hanging call to `Watch` at all times to avoid triggering this condition.

- response `event` next port event.

#### Request

\<EMPTY\>

#### Response

| Name | Type |
|---|---|
| `event` | `https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#DevicePortEvent` |

## Session

*Defined in [fuchsia.hardware.network/session.fidl](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/session.fidl;l=35)*

Represents a session with a Network device.

A session has a data plane and a control plane. The `Session` protocol
represents the control plane of the session and the FIFOs and VMOs exchanged
during the [Device.OpenSession](https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#Device.OpenSession) call are the data plane. Lifetime of the
session is controlled by a `Session` protocol handle.

Sessions must attach to ports of interest to start receiving and sending
data. Sessions are always created with no ports attached.

If a port is destroyed from the underlying device, it is automatically
detached from the session.

Inbound traffic is dispatched to all open sessions. Devices typically
operate with a single primary session, see [SessionFlags.PRIMARY](https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#SessionFlags.PRIMARY). Each
additional open session to the same device causes data copy overhead on the
device's data path.

The session is closed with an error epitaph if an invalid buffer descriptor
is sent over either the tx or rx FIFOs. Invalid descriptors include:
- Descriptor index larger than [SessionInfo.descriptor_count](https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#SessionInfo.descriptor_count).
- Descriptor chains larger than [MAX_DESCRIPTOR_CHAIN](https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#MAX_DESCRIPTOR_CHAIN).
- rx buffers smaller than [Info.min_rx_buffer_length](https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#Info.min_rx_buffer_length).
- tx buffers smaller than [Info.min_tx_buffer_length](https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#Info.min_tx_buffer_length).
- tx buffers not respecting [Info.min_tx_buffer_head](https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#Info.min_tx_buffer_head) or
[Info.min_tx_buffer_tail](https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#Info.min_tx_buffer_tail).
Added: HEAD

<br />

### Attach

Attaches the session to `port`.

Once attached, the session starts to receive the subscribed frames over
the data FIFOs and it may send frames destined to the specified `port`.

- request `port` port to subscribe to.
- request `rx_frames` Frame types of interest on the port.

<!-- -->

- error `ZX_ERR_NOT_FOUND` if `port` is not valid.
- error `ZX_ERR_INVALID_ARGS` if `rx_frames` is not a subset of the port's supported frames.
- error `ZX_ERR_ALREADY_BOUND` if `port` is already attached.

#### Request

| Name | Type |
|---|---|
| `port` | `https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#PortId` |
| `rx_frames` | `vector<https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#FrameType>:4` |

#### Response

| Name | Type |
|---|---|
| `payload` | `https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#Session_Attach_Result` |

### Close

Cleanly closes a session.

This will cause the session to send a `ZX_ERR_CANCELLED` epitaph and
proceed to close the Session channel. Clients may only assume that they
own all the buffers that are currently owned by the session (sent over
either the rx or tx FIFOs) once the epitaph is received. Closing the rx
or tx FIFO is equivalent to calling `Close`.

#### Request

\<EMPTY\>

### Detach

Detaches the session from `port`.

Once detached, the session stops receiving frames from `port`. Frames
sent to a detached port may be returned with an error. It is not
necessary to call `Detach` on ports that are removed from the device,
doing so causes `ZX_ERR_NOT_FOUND` to be returned.

- request `port` port to subscribe to.

<!-- -->

- error `ZX_ERR_NOT_FOUND` if the session is not currently attached to the port.

#### Request

| Name | Type |
|---|---|
| `port` | `https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#PortId` |

#### Response

| Name | Type |
|---|---|
| `payload` | `https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#Session_Detach_Result` |

### RegisterForTx

Asks the network device to register the VMO for Tx.

The network device prepares the VMOs in order and stops at the first
error if any. It returns how many VMOs have been prepared alongside with
the first error encountered. Note that network-device itself does not
try to release earlier VMOs for a later error. It is up to the client
how to recover from an error.

- error `ZX_ERR_NOT_FOUND` if any of the VmoId is unknown.
- error other zx status that can be reported by the driver.

#### Request

| Name | Type |
|---|---|
| `vmos` | `vector<https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#VmoId>:32` |

#### Response

| Name | Type |
|---|---|
| `successful` | `uint8` |
| `status` | `https://fuchsia.dev/reference/zx//https://fuchsia.dev/reference/zx#Result` |

### UnregisterForTx

Tells the device that the client will no longer use the VMO for Tx,
if the VMO is also unused for Rx, the device is free to release it
at the implementation driver.

The network device processes the VMOs in order and stops at the first
error if any. It returns how many VMOs have been marked as unused for Tx
alongside with the first error encountered. Note that network-device
itself does not try to re-register earlier VMOs for a later error. It is
up to the client how to recover from an error.

- error `ZX_ERR_NOT_FOUND` if any of the VmoId is unknown.
- error other zx status that can be reported by the driver.

#### Request

| Name | Type |
|---|---|
| `vmos` | `vector<https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#VmoId>:32` |

#### Response

| Name | Type |
|---|---|
| `successful` | `uint8` |
| `status` | `https://fuchsia.dev/reference/zx//https://fuchsia.dev/reference/zx#Result` |

### WatchDelegatedRxLease

Watchers for delegated receive wakeup leases.

Calls block until a lease is delegated by the device. If a call to
`WatchDelegatedRxLease` is made while a previous call is blocking, the
session is closed with `ZX_ERR_BAD_STATE`. Will never yield any values
for sessions created without [SessionFlags.RECEIVE_RX_POWER_LEASES](https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#SessionFlags.RECEIVE_RX_POWER_LEASES).

Given a single lease is assumed sufficient to keep the system awake, the
server only keeps a single lease in its buffer. If a new delegated lease
becomes available and the client hasn't popped the previous one with a
call to `WatchDelegatedRxLease`, the server drops the previously pending
lease.

See [DelegatedRxLease](https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#DelegatedRxLease) for how to handle delegated leases.

#### Request

\<EMPTY\>

#### Response

| Name | Type |
|---|---|
| `lease` | `https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#DelegatedRxLease` |

## StatusWatcher

*Defined in [fuchsia.hardware.network/port.fidl](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/port.fidl;l=73)*

Provides a way to receive updates on port status changes.
Added: HEAD

<br />

### WatchStatus

`WatchStatus` blocks until the port's status has changed.

The first call to `WatchStatus` returns immediately with the current
port status, subsequent calls complete when the port status differs from
the last one that was returned through this `StatusWatcher`.

If `StatusWatcher` was created with a buffer value larger than 1,
`WatchStatus` may return a queued status change, depending on how many
status changed happened since the last call to `WatchStatus`.

- response `device_status` the most recent port status.

#### Request

\<EMPTY\>

#### Response

| Name | Type |
|---|---|
| `port_status` | `https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#PortStatus` |

## **STRUCTS**

### Device_OpenSession_Response [resource](https://fuchsia.dev/fuchsia-src/reference/fidl/language/language#value-vs-resource)

*Defined in [fuchsia.hardware.network/device.fidl](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/device.fidl;l=109)*

| Field | Type | Description | Default |
|---|---|---|---|
| `session` | `client_end:https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#Session` |   | No default |
| `fifos` | `https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#Fifos` |   | No default |

### Empty

*Defined in [fuchsia.hardware.network/device.fidl](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/device.fidl;l=170)*
Added: HEAD

<br />

\<EMPTY\>

### Fifos [resource](https://fuchsia.dev/fuchsia-src/reference/fidl/language/language#value-vs-resource)

*Defined in [fuchsia.hardware.network/session.fidl](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/session.fidl;l=148)*

Data-plane FIFOs.
Added: HEAD

<br />

| Field | Type | Description | Default |
|---|---|---|---|
| `rx` | `handle<fifo>` | Handle for the rx FIFO. Clients must write 16-bit descriptor indexes to this FIFO to be able to receive frames. | No default |
| `tx` | `handle<fifo>` | Handle for the tx FIFO. Clients write 16-bit descriptor indexes to this FIFO to enqueue outgoing frames. | No default |

### FrameTypeSupport

*Defined in [fuchsia.hardware.network/frames.fidl](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/frames.fidl;l=55)*

Specifies a frame type and features and supported flags associated with that
type.

This is used by clients to read the supported frames on the tx path for a
given Network Device.

Some Network Devices may parse outgoing frames to perform frame
transformation or specific hardware support. Each frame type has an
associated [FrameTypeSupport.features](https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#FrameTypeSupport.features) bits enumeration that lists
FrameType-specific features that may or may not be supported. Devices that
do not perform parsing are encouraged to just use the [FRAME_FEATURES_RAW](https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#FRAME_FEATURES_RAW)
bit in `features`, which informs the client that all frame features are
allowed.
Added: HEAD

<br />

| Field | Type | Description | Default |
|---|---|---|---|
| `type` | `https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#FrameType` | The frame type this support entry refers to. | No default |
| `features` | `uint32` | The frame type-specific features supported. | No default |
| `supported_flags` | `https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#TxFlags` | The flags supported for the given frame type. | No default |

### PortId

*Defined in [fuchsia.hardware.network/port.fidl](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/port.fidl;l=25)*

A device port identifier.
Added: HEAD

<br />

| Field | Type | Description | Default |
|---|---|---|---|
| `base` | `https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#BasePortId` | The base identifier for the port. Generally identifies a port instance in hardware. | No default |
| `salt` | `uint8` | An implementation-defined identifier that is guaranteed to change on every instantiation of the identified port. | No default |

### Session_Attach_Response

*Defined in [fuchsia.hardware.network/session.fidl](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/session.fidl;l=50)*

\<EMPTY\>

### Session_Detach_Response

*Defined in [fuchsia.hardware.network/session.fidl](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/session.fidl;l=63)*

\<EMPTY\>

## **ENUMS**

### FrameType [flexible](https://fuchsia.dev/fuchsia-src/reference/fidl/language/language#strict-vs-flexible)

Type: `uint8`

*Defined in [fuchsia.hardware.network/frames.fidl](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/frames.fidl;l=8)*

Types of frames.
Added: HEAD

<br />

| Name | Value | Description |
|---|---|---|
| ### ETHERNET | `1` |   |
| ### IPV4 | `2` |   |
| ### IPV6 | `3` |   |

### MacFilterMode [flexible](https://fuchsia.dev/fuchsia-src/reference/fidl/language/language#strict-vs-flexible)

Type: `uint32`

*Defined in [fuchsia.hardware.network/mac.fidl](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/mac.fidl;l=12)*

The address filtering mode supported by MAC devices.
Added: HEAD

<br />

| Name | Value | Description |
|---|---|---|
| ### MULTICAST_FILTER | `0` | Device accepts only unicast frames addressed to its own unicast address, or multicast frames that are part of the multicast address filter list. |
| ### MULTICAST_PROMISCUOUS | `1` | Device accepts unicast frames addressed to its own unicast address, or any multicast frames. |
| ### PROMISCUOUS | `2` | Device accepts all frames. |

### PortClass [flexible](https://fuchsia.dev/fuchsia-src/reference/fidl/language/language#strict-vs-flexible)

Type: `uint16`

*Defined in [fuchsia.hardware.network/port.fidl](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/port.fidl;l=41)*

Network port class.

*Note*: Device implementers are encouraged to propose additions to this
enumeration to avoid using ill-fitting variants if there's not a good match
available.
Added: 22

<br />

| Name | Value | Description |
|---|---|---|
| ### ETHERNET | `1` |   |
| ### WLAN_CLIENT | `2` |   |
| ### PPP | `3` |   |
| ### BRIDGE | `4` |   |
| ### WLAN_AP | `5` |   |
| ### VIRTUAL | `6` |   |
| ### LOWPAN | `7` |   |

## **TABLES**

### DataVmo [resource](https://fuchsia.dev/fuchsia-src/reference/fidl/language/language#value-vs-resource)

*Defined in [fuchsia.hardware.network/session.fidl](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/session.fidl;l=176)*

A VMO that can be used for data-plane operations.
Added: HEAD

<br />

| Ordinal | Field | Type | Description |
|---|---|---|---|
| ### 1 | `id` | `https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#VmoId` |   |
| ### 2 | `vmo` | `handle<vmo>` |   |
| ### 3 | `num_rx_buffers` | `uint16` | Netdevice needs this information to decide when to safely unregister and decommit. |

### DelegatedRxLease [resource](https://fuchsia.dev/fuchsia-src/reference/fidl/language/language#value-vs-resource)

*Defined in [fuchsia.hardware.network/session.fidl](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/session.fidl;l=222)*

An acquired lease that is propagated up to applications.
Added: HEAD

<br />

| Ordinal | Field | Type | Description |
|---|---|---|---|
| ### 1 | `hold_until_frame` | `uint64` | The frame after which the lease in `handle` can be released. Agents observing leases must keep track of received frames with an increasing counter to be able to properly relinquish leases after the frame `hold_until_frame` is fully processed. This value can be interpreted as either the 1-based index of a given frame or as the total number of exchanged frames so far, which are mathematically equivalent. This mechanism allows for wake lease handles from received frames to be passed up and keep the system from suspension until the frame is fully processed. Required. |
| ### 2 | `handle` | `https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#DelegatedRxLeaseHandle` | A handle representing the held lease. Required. |

### DeviceBaseInfo

*Defined in [fuchsia.hardware.network/device.fidl](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/device.fidl;l=22)*

Network device base info.
Added: HEAD

<br />

| Ordinal | Field | Type | Description |
|---|---|---|---|
| ### 1 | `rx_depth` | `uint16` | Maximum number of items in rx FIFO (per session). Required. `rx_depth` is calculated based on the size of the actual backing hardware rx queue. |
| ### 2 | `tx_depth` | `uint16` | Maximum number of items in tx FIFO (per session). Required. `tx_depth` is calculated based on the size of the actual backing hardware tx queue. |
| ### 3 | `buffer_alignment` | `uint32` | Alignment requirement for buffers in the data VMO. All buffers in the data VMO *must* be aligned to `buffer_alignment` relative to the start of the VMO. `buffer_alignment == 0` is never reported. Required. |
| ### 4 | `max_buffer_length` | `uint32` | Maximum supported length of buffers in the data VMO, in bytes. Absent if no maximum buffer length is defined. Must be nonzero. |
| ### 5 | `min_rx_buffer_length` | `uint32` | The minimum rx buffer length required for device. Required. |
| ### 6 | `min_tx_buffer_length` | `uint32` | The minimum tx buffer length required for the device. Required. This value accounts only for tx payload length, `min_tx_buffer_head` and `min_tx_buffer_tail` are not part of this value. Clients must zero pad outgoing frames to meet the required minimum length. |
| ### 7 | `min_tx_buffer_head` | `uint16` | The number of bytes the device requests be free as `head` space in a tx buffer. Required. |
| ### 8 | `min_tx_buffer_tail` | `uint16` | The amount of bytes the device requests be free as `tail` space in a tx buffer. Required. |
| ### 9 | `max_buffer_parts` | `uint8` | Maximum descriptor chain length accepted by the device. Required. |
| ### 12 | `min_rx_buffers` | `uint16` | Minimum amount of Rx buffers the client needs to prepare for the network device. Client should use this information to select its VMO sizes if using multi-VMO support. |

### DeviceInfo

*Defined in [fuchsia.hardware.network/device.fidl](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/device.fidl;l=69)*

Network device information.
Added: HEAD

<br />

| Ordinal | Field | Type | Description |
|---|---|---|---|
| ### 1 | `min_descriptor_length` | `uint8` | Minimum descriptor length, in 64-bit words. Required. The minimum length that each buffer descriptor must have for correct operation with this device. Devices that support extra frame metadata inform larger minimum descriptor lengths that reflect the minimum space needed to be able to store frame metadata. |
| ### 2 | `descriptor_version` | `uint8` | Accepted descriptor version. Required. |
| ### 3 | `base_info` | `https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#DeviceBaseInfo` | Device base info. Required. |

### PortBaseInfo

*Defined in [fuchsia.hardware.network/port.fidl](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/port.fidl;l=92)*

Port base info.
Added: HEAD

<br />

| Ordinal | Field | Type | Description |
|---|---|---|---|
| ### 1 | `port_class` | `https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#PortClass` | Port's class. Required. |
| ### 2 | `rx_types` | `vector<https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#FrameType>:4` | Supported rx frame types on this port. Required. Clients may open sessions subscribing to a subset of `rx_types` frame types on this port. |
| ### 3 | `tx_types` | `vector<https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#FrameTypeSupport>:4` | Supported tx frame types on this port. Required. Frames destined to this port whose frame type is not in `tx_types` are returned with an error. Some network devices may need to perform partial frame parsing and serialization and, for that reason, `tx_types` is a vector of [FrameTypeSupport](https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#FrameTypeSupport) which includes specific features per frame type. For example, a device that supports Ethernet frames but needs to convert the Ethernet header may only support standard Ethernet II frames, and not any "raw" Ethernet frame. |

### PortGetCountersResponse

*Defined in [fuchsia.hardware.network/port.fidl](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/port.fidl;l=173)*

| Ordinal | Field | Type | Description |
|---|---|---|---|
| ### 1 | `rx_frames` | `uint64` | The total number of ingress frames on this port. |
| ### 2 | `rx_bytes` | `uint64` | The total number of ingress bytes on this port. |
| ### 3 | `tx_frames` | `uint64` | The total number of egress frames on this port. |
| ### 4 | `tx_bytes` | `uint64` | The total number of egress bytes on this port. |

### PortInfo

*Defined in [fuchsia.hardware.network/port.fidl](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/port.fidl;l=116)*

Logical port information.
Added: HEAD

<br />

| Ordinal | Field | Type | Description |
|---|---|---|---|
| ### 1 | `id` | `https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#PortId` | Port's identifier. Required. |
| ### 2 | `base_info` | `https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#PortBaseInfo` |   |

### PortStatus

*Defined in [fuchsia.hardware.network/port.fidl](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/port.fidl;l=61)*

Dynamic port information.
Added: HEAD

<br />

| Ordinal | Field | Type | Description |
|---|---|---|---|
| ### 1 | `flags` | `https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#StatusFlags` | Port status flags. |
| ### 2 | `mtu` | `uint32` | Maximum transmit unit for this port, in bytes. The reported MTU is the size of an entire frame, including any header and trailer bytes for whatever protocols this port supports. |

### SessionInfo [resource](https://fuchsia.dev/fuchsia-src/reference/fidl/language/language#value-vs-resource)

*Defined in [fuchsia.hardware.network/session.fidl](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/session.fidl;l=187)*

Session configuration.
Added: HEAD

<br />

| Ordinal | Field | Type | Description |
|---|---|---|---|
| ### 1 | `descriptors` | `handle<vmo>` | VMO containing the descriptors. Required. 16-bit indices transmitted over the FIFOs index a descriptor in this VMO (byte offset = descriptor_length \* 8 \* index). |
| ### 2 | `data` | `vector<https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#DataVmo>:32` | VMOs containing frame data. Required. Descriptors contain byte-offsets and vmo ids that are used to index regions in data VMOs. For Rx VMOs managed by the device interface, VMOs are committed in ID order. |
| ### 3 | `descriptor_version` | `uint8` | Requested descriptor version. Required. If the network device does not support the requested descriptor version, [Device.OpenSession](https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#Device.OpenSession) fails with `ZX_ERR_NOT_SUPPORTED`. |
| ### 4 | `descriptor_length` | `uint8` | Descriptor length, in 64-bit words. Required. The length of each descriptor in the `descriptors` VMO. This is used as a multiplier to find byte offsets in `descriptors` given a descriptor index passed through the rx or tx FIFOs. |
| ### 5 | `descriptor_count` | `uint16` | Total number of descriptors that can be used by this session. Required. Descriptor indices transferred through either the rx or tx FIFO must be in the range \[0, `descriptor_count`). |
| ### 6 | `options` | `https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#SessionFlags` | Extra options. Interpreted as empty bitmask if absent. |

## **UNIONS**

### DelegatedRxLeaseHandle [flexible](https://fuchsia.dev/fuchsia-src/reference/fidl/language/language#strict-vs-flexible) [resource](https://fuchsia.dev/fuchsia-src/reference/fidl/language/language#value-vs-resource)

*Defined in [fuchsia.hardware.network/session.fidl](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/session.fidl;l=244)*

| Ordinal | Variant | Type | Description |
|---|---|---|---|
| ### 1 | `channel` | `handle<channel>` | An untyped channel representing a lease. Close the channel to release the lease. |
| ### 2 | `eventpair` | `handle<eventpair>` | An eventpair representing a lease. Close the eventpair to release the lease. |

<br />

### DevicePortEvent [strict](https://fuchsia.dev/fuchsia-src/reference/fidl/language/language#strict-vs-flexible)

*Defined in [fuchsia.hardware.network/device.fidl](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/device.fidl;l=176)*

Port creation and destruction events.
Added: HEAD

| Ordinal | Variant | Type | Description |
|---|---|---|---|
| ### 1 | `existing` | `https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#PortId` | Port existed when watcher was created. |
| ### 2 | `added` | `https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#PortId` | New port was added to device. |
| ### 3 | `removed` | `https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#PortId` | Port was removed from the device. |
| ### 4 | `idle` | `https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#Empty` | Exhausted list of existing ports. |

<br />

### Device_OpenSession_Result [strict](https://fuchsia.dev/fuchsia-src/reference/fidl/language/language#strict-vs-flexible) [resource](https://fuchsia.dev/fuchsia-src/reference/fidl/language/language#value-vs-resource)

*Defined in [fuchsia.hardware.network/device.fidl](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/device.fidl;l=109)*

| Ordinal | Variant | Type | Description |
|---|---|---|---|
| ### 1 | `response` | `https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#Device_OpenSession_Response` |   |
| ### 2 | `err` | `https://fuchsia.dev/reference/zx//https://fuchsia.dev/reference/zx#Status` |   |

<br />

### Session_Attach_Result [strict](https://fuchsia.dev/fuchsia-src/reference/fidl/language/language#strict-vs-flexible)

*Defined in [fuchsia.hardware.network/session.fidl](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/session.fidl;l=50)*

| Ordinal | Variant | Type | Description |
|---|---|---|---|
| ### 1 | `response` | `https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#Session_Attach_Response` |   |
| ### 2 | `err` | `https://fuchsia.dev/reference/zx//https://fuchsia.dev/reference/zx#Status` |   |

<br />

### Session_Detach_Result [strict](https://fuchsia.dev/fuchsia-src/reference/fidl/language/language#strict-vs-flexible)

*Defined in [fuchsia.hardware.network/session.fidl](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/session.fidl;l=63)*

| Ordinal | Variant | Type | Description |
|---|---|---|---|
| ### 1 | `response` | `https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#Session_Detach_Response` |   |
| ### 2 | `err` | `https://fuchsia.dev/reference/zx//https://fuchsia.dev/reference/zx#Status` |   |

<br />

## **BITS**

### EthernetFeatures [strict](https://fuchsia.dev/fuchsia-src/reference/fidl/language/language#strict-vs-flexible)

Type: `uint32`

*Defined in [fuchsia.hardware.network/frames.fidl](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/frames.fidl;l=23)*

Ethernet frame sub-types and features.
Added: HEAD

<br />

| Name | Value | Description |
|---|---|---|
| ### RAW | 1 | Device supports any type of ethernet frame. Same as specifying all other flags. Used by devices that do not inspect or parse outbound traffic. |
| ### ETHERNET_II | 2 | Device supports EthernetII frames. |
| ### E_802_1_Q | 4 | Device supports 802.1q VLAN additions. |
| ### E_802_1_Q_IN_Q | 8 | Device supports 802.1 q-in-q Multiple VLAN tagging additions. Only meaningful if `E_802_1_Q` is also present. |
| ### E_802_3_LLC_SNAP | 16 | Device supports 802.3 LLC + SNAP Ethernet frame format. |

### RxFlags [strict](https://fuchsia.dev/fuchsia-src/reference/fidl/language/language#strict-vs-flexible)

Type: `uint32`

*Defined in [fuchsia.hardware.network/frames.fidl](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/frames.fidl;l=74)*

Flags set by a Device when handing a buffer to a client on the rx path.

Set by devices on the `inbound_flags` field of an rx descriptor.
Added: HEAD

<br />

| Name | Value | Description |
|---|---|---|
| ### FULL_CHECKSUMS_VERIFIED | 1 | The device verified one or more "full" checksums (meaning an Internet Checksum over the full contents of e.g. a UDP or TCP packet). The number of verified checksums, minus one, is indicated by the `rx_full_csums_verified` field of the `accel_metadata` field of the rx descriptor. |
| ### RX_OVERRUN | 536870912 | Device experienced a hardware rx overrun. Rx overruns are typically set by hardware controllers when a frame event was detected but the frame data couldn't be captured. Devices should clear the controller flag once this is set on an inbound frame, so future overruns can be detected and reported. |
| ### RX_VALIDATION_ERROR | 1073741824 | This bit is set if frame validation is performed (such as by hardware acceleration features) and fails. It's important to note that some devices may simply discard frames for which validation fails and never notify the client. Rx frames that failed validation are only transmitted to the client if the `SessionFlags::REPORT_INVALID_RX` option is selected when creating a session. |

### SessionFlags [strict](https://fuchsia.dev/fuchsia-src/reference/fidl/language/language#strict-vs-flexible)

Type: `uint16`

*Defined in [fuchsia.hardware.network/session.fidl](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/session.fidl;l=127)*

Additional session options.
Added: HEAD

<br />

| Name | Value | Description |
|---|---|---|
| ### REPORT_INVALID_RX | 1 | Receive invalid rx frames. Sessions marked with `REPORT_INVALID_RX` are interested in receiving frames that were rejected by internal device checks or payload validation performed by hardware. Due to the nature of some hardware platforms, sessions marked with `REPORT_INVALID_RX` may still not receive frames that fail validation if the hardware implementation simply drops the frame and doesn't expose it to the software stack. Sessions NOT marked with `REPORT_INVALID_RX`, in contrast, will NEVER receive an rx frame with the `RX_VALIDATION_ERROR` flag set. |
| ### RECEIVE_RX_POWER_LEASES | 2 | Receive rx power leases. Sessions marked with `RECEIVE_RX_POWER_LEASES` receive [DelegatedRxLease](https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#DelegatedRxLease)s through [Session.WatchDelegatedRxLease](https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#Session.WatchDelegatedRxLease) calls. |

### StatusFlags [strict](https://fuchsia.dev/fuchsia-src/reference/fidl/language/language#strict-vs-flexible)

Type: `uint32`

*Defined in [fuchsia.hardware.network/port.fidl](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/port.fidl;l=53)*

Port status bits, reported in [PortStatus.flags](https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#PortStatus.flags).
Added: HEAD

<br />

| Name | Value | Description |
|---|---|---|
| ### ONLINE | 1 | Port is online, i.e., data path is open and any ongoing sessions may send and receive frames. |

### TxFlags [flexible](https://fuchsia.dev/fuchsia-src/reference/fidl/language/language#strict-vs-flexible)

Type: `uint32`

*Defined in [fuchsia.hardware.network/frames.fidl](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/frames.fidl;l=105)*

Flags set by a Client when handing a buffer to a device on the tx path.

Set by Clients on the `inbound_flags` field of a tx descriptor.
Added: HEAD

<br />

| Name | Value | Description |
|---|---|---|
| ### COMPUTE_GENERIC_CHECKSUM | 1 | Requests that the device compute a generic Internet Checksum based on a starting byte index relative to the start of the frame and a byte offset indicating the the offset from the starting index to the checksum field where the result must be placed. The starting offset and the offset to the checksum field are indicated by the `tx_partial_csum` field of the `accel_metadata` field of the tx descriptor. |

### TxReturnFlags [flexible](https://fuchsia.dev/fuchsia-src/reference/fidl/language/language#strict-vs-flexible)

Type: `uint32`

*Defined in [fuchsia.hardware.network/frames.fidl](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/frames.fidl;l=121)*

Flags set by a Device when returning a tx buffer back to a client.

Set by Devices on the `return_flags` field of a tx descriptor.
Added: HEAD

<br />

| Name | Value | Description |
|---|---|---|
| ### TX_RET_NOT_SUPPORTED | 1 | Requested operation in `inbound_flags` is not supported; the frame was not sent. Always set in conjunction with `TX_RET_ERROR`. |
| ### TX_RET_OUT_OF_RESOURCES | 2 | Could not allocate resources to send frame. Always set in conjunction with `TX_RET_ERROR`. |
| ### TX_RET_NOT_AVAILABLE | 4 | Device is not available (offline or disconnected); the frame was not sent. Always set in conjunction with `TX_RET_ERROR`. |
| ### TX_RET_ERROR | 2147483648 | An error occurred sending this frame. |

## **CONSTANTS**

| Name | Value | Type | Description |
|---|---|---|---|
| [FRAME_FEATURES_RAW](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/frames.fidl;l=19) | `1` | `uint32` | Blanket definition for raw frames. Devices that do not perform any sort of parsing of outbound traffic should define `FRAME_FEATURES_RAW` in the [FrameTypeSupport](https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#FrameTypeSupport) entry. Added: HEAD |
| [MAX_DATA_VMOS](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/session.fidl;l=163) | `32` | `uint8` | The maximum number of Data VMOs that may exist. Added: HEAD |
| [MAX_DESCRIPTOR_CHAIN](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/frames.fidl;l=68) | `4` | `uint8` | Maximum number of chained descriptors that describe a single frame. Added: HEAD |
| [MAX_FRAME_TYPES](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/device.fidl;l=14) | `4` | `uint32` | Maximum numbers of supported frame types for rx or tx. Added: HEAD |
| [MAX_PORTS](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/port.fidl;l=16) | `32` | `uint8` | The maximum number of ports attached to a device at a given time. Added: HEAD |
| [MAX_SESSION_NAME](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/device.fidl;l=18) | `64` | `uint32` | Maximum length of session label. Added: HEAD |
| [MAX_STATUS_BUFFER](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/port.fidl;l=12) | `50` | `uint32` | The maximum number of status samples that can be buffered by a [StatusWatcher](https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#StatusWatcher). Added: HEAD |

## **ALIASES**

| Name | Value | Description |
|---|---|---|
| [BasePortId](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/port.fidl;l=21) | `uint8` | The base identifier of a port within a device. Always less than [MAX_PORTS](https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#MAX_PORTS). Added: HEAD |
| [VmoId](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/session.fidl;l=172) | `uint8` | VMO identifier. VMO identifiers are always in the range \[0, [MAX_DATA_VMOS](https://fuchsia.dev/reference/fidl/fuchsia.hardware.network#MAX_DATA_VMOS)). VMO identifiers are reported to device implementations and used to locate buffers. Added: HEAD |

## **SERVICES**

### Service

*Defined in [fuchsia.hardware.network/device.fidl](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/device.fidl;l=139)*

| Name | Type | Transport |
|---|---|---|
| [device](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/device.fidl;l=140) | `fuchsia.hardware.network/Device` | Channel |
| [device_topology](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.hardware.network/device.fidl;l=143) | `fuchsia.device.fs/TopologicalPath` | Channel |

<br />