opensolaris man page for net_protocol_lookup

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

NAME
       net_protocol_lookup - locate an implementation of a network layer protocol

SYNOPSIS
       #include <sys/neti.h>

       net_data_t net_protocol_lookup(netid_t id, const char *protocol);

INTERFACE LEVEL
       Solaris DDI specific (Solaris DDI).

PARAMETERS
       id	 network instance identifier.

       family	 name of the network protocol to find.

DESCRIPTION
       The  net_protocol_lookup()  function attempts to locate a data structure that defines what capabilities it is exporting through this inter-
       face. The value returned by this call is guaranteed to be valid until it is passed into a call to net_protocol_release(9F), after which	it
       should no longer be treated as valid.

       The  protocol must be a registered name of a network protocol that has been registered. The symbols NHF_INET and NHF_INET6 should be passed
       to net_protocol_lookup() as the protocol name to gain access to either IPv4 or IPv6 respectively.

RETURN VALUES
       The net_protocol_lookup() function returns NULL if it does not find any knowledge about the  network  protocol  referenced.  Otherwise,	it
       returns a value that can be used with other calls in this framework.

CONTEXT
       The net_protocol_lookup() 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_protocol_release(9F), attributes(5)

SunOS 5.11							    1 May 2008						   net_protocol_lookup(9F)