Session Initiation Protocol Library Functions
                                              sipaddparam(3SIP)



NAME
     sipaddparam - add a parameter to the SIP header

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

     sipheadert sipaddparam(sipheadert sipheader, char *param,
          int *error);


DESCRIPTION
     The sipaddparam() function adds the parameter provided  in
     param to the SIP header sipheader. The function returns the
     header with the parameter added. A new header is created  as
     a  result  of  adding  the  parameter  and the old header is
     marked deleted. Applications with multiple  threads  working
     on  the  same SIP header need to take note of this. If error
     is non-null, it (the location pointer by  the  variable)  is
     set  to  0  on  success  and  the appropriate error value on
     error.

RETURN VALUES
     The sipaddparam() function returns the new header on  suc-
     cess  and  null  on  failure. Further, if error is non-null,
     then on success the value in the location pointed  by  error
     is 0 and the appropriate error value on failure.

ERORS
     On failure, functions that return an error value may  return
     one of the following:

     EINVAL    Mandatory parameters are not provided, i.e. null.

               For sipaddparam(), the header to be modified  is
               marked deleted.


     EPERM     The message cannot be modified.


     ENOMEM    There is an error allocating memory  for  creating
               headers/parameters.


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
                                              sipaddparam(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
                                              sipaddparam(3SIP)






















































SunOS 5.11          Last change: 25 Jan 2007                    3