NET_PHYLOOKUP(9F) Kernel Functions for Drivers NET_PHYLOOKUP(9F)

NAME


net_phylookup - determine if a network interface name exists for a
network protocol

SYNOPSIS


#include <sys/neti.h>

phy_if_t net_phylookup(const net_data_t net, const char *name);


INTERFACE LEVEL


illumos DDI specific (illumos DDI).

PARAMETERS


net
value returned from a successful call to net_protocol_lookup(9F).


name
name of the network interface to find.


DESCRIPTION


The net_phylookup() function attempts to resolve the interface name
passed in with the network protocol.


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_phylookup() function returns -1 if it is not supported by the
network protocol, and 0 if the named network interface does not exist
(or is otherwise unknown). Otherwise, it returns a value greater
than 0 representing a network interface that currently exists within the
scope of this network protocol.

CONTEXT


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

ATTRIBUTES


See attributes(7) for descriptions of the following attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Committed |
+--------------------+-----------------+

SEE ALSO


attributes(7), net_getifname(9F), net_phygetnext(9F),
net_protocol_lookup(9F)

illumos May 1, 2008 NET_PHYLOOKUP(9F)