opensolaris man page for net_phylookup

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)