Kernel functions			       hook_nic_event(9s)



NAME
     hook_nic_event - structure	describe events	related	 to  net-
     work interfaces

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

INTERFACE LEVEL
     Solaris DDI specific (Solaris DDI)

DESCRIPTION
     hook_nic_event 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  struc-
     ture.

     For each event, the following fields are set as follows:

     hne_family
	  is a valid reference for the network protocol	that owns
	  this	network	 interface  and	 can be	in calls to other
	  netinfo(9f) functions;

     hne_nic
	  represents the physical interface  to	 which	an  event
	  blongs to;

     hne_event
	  is a value  to  indicate  the	 respective  event.   The
	  current list of events available is:

	  NE_PLUMB
	       indicates that an interface has just been created

	  NE_UNPLUMB
	       indicates that an interface  has	 just  been  des-
	       troyed  and that	no more	events should be received
	       for it

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

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




SunOS 5.10	   Last	change:	DD Month 2007			1






Kernel functions			       hook_nic_event(9s)



	  NE_ADDRESS_CHANGE
	       indicates that an  address  on  an  interface  has
	       changed.	 hne_lif will refer to the logical inter-
	       face 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  net-
	       work address.

STRUCTURE MEMBERS
     net_data_t		 hne_family;
     phy_if_t		 hne_nic;
     lif_if_t		 hne_lif;
     nic_event_t	 hne_event;
     nic_event_data_t	 hne_data;
     size_t		 hne_datalen;

ATTRIBUTES
     See attributes(5) for descriptions	of the	following  attri-
     butes:
	  ____________________________________________________________
	 |	 ATTRIBUTE TYPE	       |       ATTRIBUTE VALUE	     |
	 |_____________________________|_____________________________|
	 | Interface Stability	       |	 Committed	     |
	 |_____________________________|_____________________________|

SEE ALSO
     netinfo(9f),




























SunOS 5.10	   Last	change:	DD Month 2007			2