Session Initiation Protocol Library Functions
                                       sipregistersentby(3SIP)



NAME
     sipregistersentby,                sipunregistersentby,
     sipunregisterallsentby  -  allows  registering  and  un-
     registering sent-by values

SYNOPSIS
     cc [ flag ... ] file ... -lsip [ library ... ]
     #include 

     int sipregistersentby(char *val);


     void sipunregistersentby(char *val);


     void sipunregisterallsentby(int *error);


DESCRIPTION
     The sipregistersentby() function can be used to  register
     a list of hostnames or IP addresses that the application may
     add to the VIA headers. The val is a comma separated list of
     such  sent-by  values.  If  any  value  is  registered using
     sipregistersentby(), the  SIP  stack  validates  incoming
     responses  to  check if the sent-by parameter in the topmost
     VIA header is part of the  registered  list.  If  the  check
     fails,  the  response  is  dropped.  If there are no sent-by
     values registered,  there  is  no  check  done  on  incoming
     responses.


     The               sipunregistersentby()               and
     sipunregisterallsentby()   functions  are  used  to  un-
     register     sent-by      values.      The      val      for
     sipunregistersentby()  is a comma separated list of sent-
     by    values    that    need    to     be     un-registered.
     sipunregisterallsentby()  un-registers  all  the  values
     that have been registered.

RETURN VALUES
     The sipregistersentby() function returns 0 on success and
     the appropriate error value on failure.


     The value of errno is not changed  by  these  calls  in  the
     event of an error.

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




SunOS 5.11          Last change: 25 Jan 2007                    1






Session Initiation Protocol Library Functions
                                       sipregistersentby(3SIP)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Committed                   
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     libsip(3LIB)











































SunOS 5.11          Last change: 25 Jan 2007                    2






Session Initiation Protocol Library Functions
                                       sipregistersentby(3SIP)






















































SunOS 5.11          Last change: 25 Jan 2007                    3