IOUserNetworkEthernet
The object you use to manage the setup, configuration, and teardown of your networking driver.
Declaration
class IOUserNetworkEthernet;Overview
Subclass IOUserNetworkEthernet and override the methods you need to implement your driver’s behavior. Your subclass manages your driver’s overall life cycle, and facilitates communication between the hardware and the rest of the system. Use the Start method to establish a link to your hardware and to create the data structures needed to manage incoming and outgoing data packets. Use the Stop method to clean up the data structures you create in your Start method.
Override other methods of this class, and of the IOService parent class, as needed to enable your interface and implement other network-related behaviors. For example, you might want to override the inherited setPowerState method to respond to power-level changes.
Specify the Driver’s Personality Information
When you subclass IOUserNetworkEthernet, update the IOKitPersonalities key of your driver extension’s Info.plist file with information to match your driver to appropriate hardware. For this class, always include the keys and values in the following table.
Key | Discussion |
|---|---|
| The value Iousernetworkethernet. |
| The provider class information. For USB-based network interfaces, specify Iousbhostinterface. |
| The name of your custom subclass. |
The bundle identifier of your driver. | |
| The value |
You may add other keys to assist with the matching process. For example, you might include the bInterfaceClass, bInterfaceProtocol, and bInterfaceSubClass keys to match against specific USB device attributes. The USB specification defines which keys to include when matching your driver to a USB device. For information about the specific key combinations, see Universal Serial Bus Common Class Specification at https://www.usb.org.
Topics
Configuring the Driver Service
Declaring the Supported Media Types
Enabling Your Service
Configuring Link Attributes
SetTxPacketHeadroomSetTxPacketTailroomSetSoftwareVlanSupportSetMulticastAddressesSetAllMulticastModeEnableSetPromiscuousModeEnableSetWakeOnMagicPacketSupportSetWakeOnMagicPacketEnableIOUserNetworkMACAddress
Reporting the Connection Status
ReportLinkStatusReportLinkQualityReportDataBandwidthsIOUserNetworkLinkStatusIOUserNetworkLinkQuality
Instance Methods
GetHardwareAssistsGetMaxTransferUnitRegisterEthernetInterfaceReportNicProxyLimitsSetHardwareAssistsSetMTUaddHardwareCountsWithInterfaceStatisticsbpfAttachbpfTapbpfTapInputPacketbpfTapOutputPacketgetBSDNamegetBSDNamePrefixgetBSDUnitNumbergetFeatureFlagsgetHardwareAddressgetHardwareAssistsgetInitialMediagetInterfaceSubFamilygetMaxTransferUnitgetSupportedMediaArraygetTSOOptionsgetTxDataOffsethandleChosenMediahwConfigNicProxyDatahwConfigNicProxyDataprocessInterfaceCommandregisterEthernetInterfaceregisterEthernetInterfacereportDataBandwidthsreportLinkQualityreportLinkStatusreportNicProxyLimitssetAllMulticastModeEnablesetHardwareAddresssetHardwareAssistssetHardwareAssistssetInterfaceEnablesetMaxTransferUnitsetMulticastAddressessetPowerStatesetPromiscuousModeEnablestartstopupdateInterfaceDescriptor