man pages section 9: DDI and DKI Kernel Functions

Exit Print View

Updated: July 2014
 
 

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 interface. 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
system/core-os
Interface Stability
Committed

See Also

net_protocol_release(9F), attributes(5)