Interface Level

Parameters

Description

The net_phygetnext() function searches through all of the network interfaces that a
network protocol “owns”. To start searching through all of the interfaces owned
by a protocol, a value of 0 should be passed through as
the value of ifp. When 0 is returned by this function, the
last of the interfaces owned by this protocol has been reached.

When called successfully, the value returned represents a network interface that exists,
at the time of the call, within the scope of the network
interface. This value is only guaranteed to be unique for a name
within the scope of the network protocol.

Return Values

The net_phygetnext() function returns -1 if it is not supported by the
network protocol or 0 if an attempt to go beyond the
last network interface is made. Otherwise, it returns
a value representing a network interface.

Context

The net_phygetnext() function may be called from user, kernel, or interrupt
context.