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)