1hook_nic_event(9S)        Data Structures for Drivers       hook_nic_event(9S)
2
3
4

NAME

6       hook_nic_event  -  data  structure describing events related to network
7       interfaces
8

SYNOPSIS

10       #include <sys/neti.h>
11       #include <sys/hook.h>
12       #include <sys/hook_event.h>
13
14

INTERFACE LEVEL

16       Solaris DDI specific (Solaris DDI).
17

DESCRIPTION

19       The hook_nic_event structure contains fields that relate  to  an  event
20       that has occurred and belongs to a network interface. This structure is
21       passed through to callbacks for NE_PLUMB,  NE_UNPLUMB,  NE_UP,  NE_DOWN
22       and NE_ADDRESS_CHANGE events.
23
24
25       A callback may not alter any of the fields in this structure.
26

STRUCTURE MEMBERS

28         net_data_t           hne_family;
29         phy_if_t             pkt_private;
30         lif_if_t             hne_lif;
31         nic_event_t          hne_event;
32         nic_event_data_t     hne_data;
33         size_t               hne_datalen;
34
35
36
37
38       The following fields are set for each event:
39
40       hne_family    A valid reference for the network protocol that owns this
41                     network interface and can  be  in  calls  to  other  net‐
42                     info(9F) functions.
43
44
45       hne_nic       The physical interface to which an event belongs.
46
47
48       hne_event     A  value that indicates the respective event. The current
49                     list of available events is:
50
51                     NE_PLUMB             an interface has just been created.
52
53
54                     NE_UNPLUMB           an interface has just been destroyed
55                                          and   no   more   events  should  be
56                                          received for it.
57
58
59                     NE_UP                an interface has changed  the  state
60                                          to  "up" and may now generate packet
61                                          events.
62
63
64                     NE_DOWN              an interface has changed  the  state
65                                          to  "down" and will no longer gener‐
66                                          ate packet events.
67
68
69                     NE_ADDRESS_CHANGE    an  address  on  an  interface   has
70                                          changed. hne_lif refers to the logi‐
71                                          cal interface for which  the  change
72                                          is  occurring, hne_data is a pointer
73                                          to  a  sockaddr  structure  that  is
74                                          hne_datalen  bytes long and contains
75                                          the new network address.
76
77
78

ATTRIBUTES

80       See attributes(5) for descriptions of the following attributes:
81
82
83
84
85       ┌─────────────────────────────┬─────────────────────────────┐
86       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
87       ├─────────────────────────────┼─────────────────────────────┤
88       │Interface Stability          │Committed                    │
89       └─────────────────────────────┴─────────────────────────────┘
90

SEE ALSO

92       netinfo(9F)
93
94
95
96SunOS 5.11                        1 May 2008                hook_nic_event(9S)
Impressum