MACIOC_GETRADDR(7mdi)

MACIOC_GETRADDR -- MDI return factory MAC address ioctl

Description

This ioctl requests that the MDI driver retrieve the factory MAC address from the controller. This will appear as an M_IOCTL(D7str) message with an associated M_DATA(D7str) block.

Drivers for MDI devices that do not use MAC addresses must use this primitive so that upper-layer calls will fail gracefully.

Parameters

The ioctl data contains space into which the MDI driver should copy its MAC address.

Data returned

The MDI driver should fill the ioctl data area with its MAC address. This address is the current in-use MAC address. The data is one of the following:

M_IOCACK(D7str): Acknowledge successful completion of the operation. Set ioc_rval set to zero and ioc_count set to the size of the MAC address in the associated M_DATA(D7str) block.
M_IOCNAK(D7str): Acknowledge unsuccessful completion of the operation. Set ioc_count to zero, ioc_rval to -1, and ioc_error set to EINVAL if the device does not use MAC addresses. For other error conditions, set ioc_error to an appropriate value from errnos(D5).

Version applicability

mdi: 1, 2, 2.1

References

Intro(MDI)

``MDI ioctls'' in HDK Technical Reference