net_protocol_lookup(9f)

1net_protocol_lookup(9F)  Kernel Functions for Drivers  net_protocol_lookup(9F)
2
3
4

NAME

6       net_protocol_lookup  - locate an implementation of a network layer pro‐
7       tocol
8

SYNOPSIS

10       #include <sys/neti.h>
11
12       net_data_t net_protocol_lookup(netid_t id, const char *protocol);
13
14

INTERFACE LEVEL

16       Solaris DDI specific (Solaris DDI).
17

PARAMETERS

19       id        network instance identifier.
20
21
22       family    name of the network protocol to find.
23
24

DESCRIPTION

26       The net_protocol_lookup() function attempts to locate a data  structure
27       that  defines what capabilities it is exporting through this interface.
28       The value returned by this call is guaranteed to be valid until  it  is
29       passed  into  a call to net_protocol_release(9F), after which it should
30       no longer be treated as valid.
31
32
33       The protocol must be a registered name of a network protocol  that  has
34       been registered. The symbols NHF_INET and NHF_INET6 should be passed to
35       net_protocol_lookup() as the protocol name to  gain  access  to  either
36       IPv4 or IPv6 respectively.
37

RETURN VALUES

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

CONTEXT

44       The net_protocol_lookup() function may be called from user,  kernel, or
45       interrupt context.
46

ATTRIBUTES

48       See attributes(5) for descriptions of the following attributes:
49
50
51
52
53       ┌─────────────────────────────┬─────────────────────────────┐
54       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
55       ├─────────────────────────────┼─────────────────────────────┤
56       │Availability                 │SUNWcsu                      │
57       ├─────────────────────────────┼─────────────────────────────┤
58       │Interface Stability          │Committed                    │
59       └─────────────────────────────┴─────────────────────────────┘
60