hook_nic_event(9s) [opensolaris man page]

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

       Solaris DDI specific (Solaris 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)  func-
		     tions.

       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(5) for descriptions of the following attributes:

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

SEE ALSO

       netinfo(9F)

SunOS 5.11							    1 May 2008							hook_nic_event(9S)

Check Out this Related Man Page

net_phylookup(9F)					   Kernel Functions for Drivers 					 net_phylookup(9F)

NAME

       net_phylookup - determine if a network interface name exists for a network protocol

SYNOPSIS

       #include <sys/neti.h>

       phy_if_t net_phylookup(const net_data_t net, const char *name);

INTERFACE LEVEL

       Solaris DDI specific (Solaris DDI).

PARAMETERS

       net     value returned from a successful call to net_protocol_lookup(9F).

       name    name of the network interface to find.

DESCRIPTION

       The net_phylookup() function attempts to resolve the interface name passed in with the network protocol.

       When  called  successfully, the value returned represents a network interface that exists, at the time of the call, within the scope of the
       network interface. This value is only guaranteed to be unique for a name within the scope of the network protocol.

RETURN VALUES

       The net_phylookup() function returns -1 if it is not supported by the network  protocol,  and 0 if the named  network  interface  does  not
       exist  (or is otherwise	unknown).  Otherwise, it returns  a  value  greater  than 0 representing a network interface that currently exists
       within the scope of this network protocol.

CONTEXT

       The net_phylookup() function may be called from user,  kernel, or interrupt context.

ATTRIBUTES

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

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

SEE ALSO

       net_getifname(9F), net_phygetnext(9F), net_protocol_lookup(9F), attributes(5)

SunOS 5.11							    1 May 2008							 net_phylookup(9F)

Linux and UNIX Man Pages

hook_nic_event(9s) [opensolaris man page]

Check Out this Related Man Page