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

       Solaris DDI specific (Solaris 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(5) for descriptions of the following attributes:

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

SEE ALSO

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

SunOS 5.11							    1 May 2008							 net_phylookup(9F)