Sockets Library Functions                   icmp6filter(3SOCKET)



NAME
     icmp6filter - Variable allocation datatype

SYNOPSIS
     void ICMP6FILTERSETPASAL (struct icmp6filter *);


     void ICMP6FILTERSETBLOCKAL (struct icmp6filter *);


     void ICMP6FILTERSETPAS (int, struct icmp6filter *);


     void ICMP6FILTERSETBLOCK (int, struct icmp6filter *);


     int ICMP6FILTERWILPAS (int, const struct icmp6filter *);


     int ICMP6FILTERWILBLOCK (int, const struct icmp6filter *);


DESCRIPTION
     The icmp6filter structure is similar to the fdset datatype
     used  with  the  select()  function  in the sockets API. The
     icmp6filter structure is an opaque datatype and the  appli-
     cation  should  not care how it is implemented. The applica-
     tion allocates a  variable  of  this  type,  then  passes  a
     pointer  to  it.  Next  it passes a pointer to a variable of
     this type to getsockopt() and setsockopt() and operates on a
     variable of this type using the six macros defined below.


     The SETPASAL  and  SETBLOCKAL  functions  enable  you  to
     specify  that all ICMPv6 messages are passed to the applica-
     tion or that all ICMPv6  messages  are  blocked  from  being
     passed.


     The SETPAS and SETBLOCKAL functions enable you to  specify
     that messages of a given ICMPv6 type should be passed to the
     application or not passed to the application (blocked).


     The WILPAS and WILBLOCK return true  or  false  depending
     whether the specified message type is passed to the applica-
     tion or blocked from being passed to the application by  the
     filter pointed to by the second argument.


     The pointer argument to all six  icmp6filter  macros  is  a
     pointer  to  a  filter  that  is  modified by the first four



SunOS 5.11          Last change: 13 Dec 2003                    1






Sockets Library Functions                   icmp6filter(3SOCKET)



     macros  and  is  examined   by   ICMP6FILTERSETBLOCK   and
     ICMP6FILTERWILBLOCK. The first argument, (an integer), to
     the       ICMP6FILTERBLOCKAL,       ICMP6FILTERSETPAS,
     ICMP6FILTERSETBLOCK,  and ICMP6FILTERWILBLOCK macros is
     an ICMPv6 message type, between 0 and 255.


     The current filter is fetched and stored using  getsockopt()
     and  setsockopt()  with  a  level  of  IPROTOICMPV6 and an
     option name of ICMP6FILTER.

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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     Safe                        
    
     Interface Stability          Standard                    
    































SunOS 5.11          Last change: 13 Dec 2003                    2