Session Initiation Protocol Library Functions
                                             sipaddheader(3SIP)



NAME
     sipaddheader - add a SIP header to the SIP message

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

     int sipaddheader(sipmsgt sipmsg, char *headerstring);


DESCRIPTION
     The  sipaddheader()  function   takes   the   SIP   header
     headerstring,  adds  a CRLF (carriage return/line feed) and
     appends it to the SIP message sipmsg. The  sipaddheader()
     function  is  typically  used  when adding a SIP header with
     multiple values.

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

ERORS
     On failure, the sipaddheader() function can return one  of
     the following error values:

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


     EPERM     The message cannot be modified.


     ENOMEM    Error    allocating    memory     for     creating
               headers/parameters.


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
















SunOS 5.11          Last change: 09 Feb 2007                    1






Session Initiation Protocol Library Functions
                                             sipaddheader(3SIP)




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


SEE ALSO
     libsip(3LIB)











































SunOS 5.11          Last change: 09 Feb 2007                    2






Session Initiation Protocol Library Functions
                                             sipaddheader(3SIP)






















































SunOS 5.11          Last change: 09 Feb 2007                    3