Kernel functions			       net_phygetnext(9F)



NAME
     net_phygetnext - iterate through the current list of network
     interfaces

SYNOPSIS
     #include <sys/neti.h>

     phy_if_t net_phygetnext(const net_data_t net, const phy_if_t
     ifp);

INTERFACE LEVEL
     Solaris DDI specific (Solaris DDI)

PARAMETERS
     net

	 value	 returned   from    a	 successful    call    to
	 net_protocol_lookup.



     ifp
	 value returned	from a successful call	to  net_phylookup
	 or net_phygetnext.



DESCRIPTION
     This function can be used to enumerate through  all  of  the
     network interfaces	that a network protocol	"owns".	 To start
     walking through all of the	interfaces owned by a protocol,	0
     should  be	 passed	 through  as the value of ifp.	When 0 is
     returned by this function,	the last of the	interfaces  owned
     by	this protocol will have	been reached.

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

EXAMPLES
	  net_data_t net;
	  phy_if_t ifp;
	  char buffer[32];

	  net =	net_protocol_lookup("inet");

	  if (net != NULL) {
	       for (ifp	= net_phygetnext(net, 0); ifp != 0;
		    ifp	= net_phygetnext(net, ifp)) {
		    /* Do something with ifp */



SunOS 5.10	   Last	change:	25 March 2008			1






Kernel functions			       net_phygetnext(9F)



		    if (net_getifname(net, ifp,	buffer,
			sizeof(buffer) >= 0)
			 printf("Interface %s0,	buffer);
	       }
	  }

RETURN VALUES
     This interface returns "-1" if it is not support by the net-
     work  protocol, "0" if an attempt to go beyond the	last net-
     work  interface  is  made	and  otherwise	returns	 a  value
     representing a network interface.

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

SEE ALSO
     net_phylookup(9f)
































SunOS 5.10	   Last	change:	25 March 2008			2