HOOK_NIC_EVENT(9S) Data Structures for Drivers HOOK_NIC_EVENT(9S)

NAME

hook_nic_event - data structure describing events related to network
interfaces

SYNOPSIS

#include <sys/neti.h>
#include <sys/hook.h>
#include <sys/hook_event.h>

INTERFACE LEVEL

illumos DDI specific (illumos DDI).

DESCRIPTION

The hook_nic_event structure contains fields that relate to an event that
has occurred and belongs to a network interface. This structure is passed
through to callbacks for NE_PLUMB, NE_UNPLUMB, NE_UP, NE_DOWN and
NE_ADDRESS_CHANGE events.


A callback may not alter any of the fields in this structure.

STRUCTURE MEMBERS

net_data_t hne_family;
phy_if_t pkt_private;
lif_if_t hne_lif;
nic_event_t hne_event;
nic_event_data_t hne_data;
size_t hne_datalen;


The following fields are set for each event:

hne_family
A valid reference for the network protocol that owns this
network interface and can be in calls to other netinfo(9F)
functions.


hne_nic
The physical interface to which an event belongs.


hne_event
A value that indicates the respective event. The current
list of available events is:

NE_PLUMB
an interface has just been created.


NE_UNPLUMB
an interface has just been destroyed
and no more events should be received
for it.


NE_UP
an interface has changed the state to
"up" and may now generate packet
events.


NE_DOWN
an interface has changed the state to
"down" and will no longer generate
packet events.


NE_ADDRESS_CHANGE
an address on an interface has
changed. hne_lif refers to the logical
interface for which the change is
occurring, hne_data is a pointer to a
sockaddr structure that is hne_datalen
bytes long and contains the new
network address.

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Committed |
+--------------------+-----------------+

SEE ALSO

netinfo(9F)

May 1, 2008 HOOK_NIC_EVENT(9S)