Contents

ifnet_set_capabilities_enabled

Declaration

errno_t ifnet_set_capabilities_enabled(ifnet_t interface, u_int32_t new_caps, u_int32_t mask);

Parameters

  • interface:

    Interface to set the capabilities on.

  • new_caps:

    The value of the capabilities that should be set or unset. These flags are defined in net/if.h

  • mask:

    Which capabilities that should be affected. These flags are defined in net/if.h

Return Value

0 on success otherwise the errno error.

Discussion

Sets the interface capabilities to new_caps. This function lets you specify which capabilities you want to change using the mask. The kernel will effectively take the lock, then set the interface's flags to (if_capenable & ~mask) | (new_caps & mask).

This function is intended to be called by the driver. A kext must not call this function on an interface the kext does not own.

Typically this function is called by the driver when the interface is created to specify which of the supported capabilities are enabled by default. This function is also meant to be called when the driver handles the interface ioctl SIOCSIFCAP.

The driver should call ifnet_set_offlad() to indicate the corresponding hardware offload bits that will be used by the networking stack.

It is an error to enable a capability that is not marked as supported by the interface.

See Also

Network Kernel Extensions