Kernel Functions for Drivers                   netphygetnext(9F)



NAME
     netphygetnext - search through the current list of  network
     interfaces

SYNOPSIS
     #include 

     phyift netphygetnext(const netdatat net, const phyift ifp);


INTERFACE LEVEL
     Solaris DI specific (Solaris DI).

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


     ifp    value returned from a successful call to  this  func-
            tion or netphylookup(9F).


DESCRIPTION
     The netphygetnext() function searches through  all  of  the
     network  interfaces that a network protocol "owns". To start
     searching through all of the interfaces owned by a protocol,
     a  value  of 0 should be passed through as the value of ifp.
     When 0 is returned by this function, the last of the  inter-
     faces owned by this protocol has 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  interface.  This  value  is
     only  guaranteed to be unique for a name within the scope of
     the network protocol.

EXAMPLES
          netdatat net;
           phyift ifp;
           char buffer[32];

           net = netprotocollookup("inet");

           if (net != NUL) {
                for (ifp = netphygetnext(net, 0); ifp != 0;
                     ifp = netphygetnext(net, ifp)) {
                     /* Do something with ifp */
                     if (netgetifname(net, ifp, buffer,
                          sizeof(buffer) >= 0)
                           printf("Interface %s0, buffer);
                 }



SunOS 5.11           Last change: 1 May 2008                    1






Kernel Functions for Drivers                   netphygetnext(9F)



             }



RETURN VALUES
     The netphygetnext() function returns -1 if it is  not  sup-
     ported  by  the  network   protocol or 0 if an attempt to go
     beyond the last network  interface  is  made. Otherwise,  it
     returns  a  value representing a network interface.

CONTEXT
     The netphygetnext() function may be called from user,  ker-
     nel, or interrupt context.

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWcsu                     
    
     Interface Stability          Committed                   
    


SEE ALSO
     netphylookup(9F), netprotocollookup(9F), attributes(5)
























SunOS 5.11           Last change: 1 May 2008                    2