|MAC_RING_INFO(9S)||Data Structures for Drivers||MAC_RING_INFO(9S)|
MAC_CAPAB_RINGScapability. For more background on the MAC framework, please see mac(9E) and for an introduction to the
When a device driver declares that it supports the
MAC_CAPAB_RINGS capability and fills out the
structure as described in
indicates that it supports a number of rings for transmitting and receiving.
For each ring that it supports, the driver's
mr_rget(9E) entry point will be
called, during which it will have to fill out the
mac_ring_info_t structure defined here.
typedef int (*mac_ring_start_t)(mac_ring_driver_t, uint64_t); typedef void (*mac_ring_stop_t)(mac_ring_driver_t); typedef mblk_t *(*mac_ring_send_t)(mac_ring_driver_t, mblk_t *); typedef mblk_t *(*mac_ring_poll_t)(mac_ring_driver_t, int); typedef int (*mac_ring_stat_t)(mac_ring_driver_t, uint_t, uint64_t *);
mac_ring_driver_t mri_driver; mac_ring_start_t mri_start; mac_ring_stop_t mri_stop; mac_intr_t mri_intr; mac_ring_send_t mri_tx; mac_ring_poll_t mri_poll; mac_ring_stat_t mri_stat;
The mri_driver member should be set to a driver-specific value that represents the data structure that corresponds to the ring. The driver will receive this value in all of the callback functions that are defined in this structure and discussed below.
The mri_start member is a required entry point that is used to start the ring. While the device driver may not need to do any work with hardware to start the use of the ring, it must record the ring's generation number. For more information, see mri_start(9E).
The mri_stop member is an optional entry point that will be called when the ring is being stopped. For more information, see mri_stop(9E).
The mri_intr member contains information about the interrupt associated with the ring. For more information on filling it out, see mac_intr(9S).
The mri_tx member should only be set on transmit rings. It must not be set on receive rings. The mri_tx member should be set to a function that will transmit a given frame on the specified ring. For more information, see mri_tx(9E).
The mri_poll member should only be set on receive rings. It must not be set on transmit rings. The mri_poll member should be set to a function which will poll the specified ring. For more information, see mri_poll(9E).
The mri_stat member should be set to a function which will retrieve statistics about the specified ring. For more information, see mri_stat(9E).
For transmit rings, the mri_tx member is required.
For receive rings, the mri_poll member is required.
|July 2, 2022||OmniOS|