Session Initiation Protocol Library Functions
                                        sipcopystartline(3SIP)



NAME
     sipcopystartline,                        sipcopyheader,
     sipcopyheaderbyname, sipcopyallheaders - copy headers
     from a SIP message

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

     int sipcopystartline(sipmsgt frommsg, sipmsgt tomsg);


     int sipcopyheader(sipmsgt sipmsg, sipheadert sipheader,
          char *param);


     int sipcopyheaderbyname(sipmsgt frommsg, sipmsgt tomsg,
          char *headername, char *param);


     int sipcopyallheaders(sipmsgt frommsg, sipmsgt tomsg);


DESCRIPTION
     The sipcopystartline() function copies the start line,  a
     request or a response line, from frommsg to tomsg.


     The sipcopyheader() function copies the SIP header  speci-
     fied  by  sipheader  to  the SIP message sipmsg. A new SIP
     header is created from sipheader and param, and is appended
     to sipmsg. The param can be non-null.


     The sipcopyheaderbyname()  function  copies  the  header
     specified  by headername (long or short form) from frommsg
     to tomsg. The new header is created using the header  value
     from  frommsg  and  param,  if  non-null,  and  appended to
     tomsg.


     The  sipcopyallheaders()  copies  all  the  headers  from
     frommsg to tomsg.

RETURN VALUES
     These functions return 0  on  success  and  the  appropriate
     error on failure.


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



SunOS 5.11          Last change: 25 Jan 2007                    1






Session Initiation Protocol Library Functions
                                        sipcopystartline(3SIP)



ERORS
     These functions can return one of the  following  errors  in
     case of failure:

     EINVAL    If the required input parameters are  NUL  or  if
               the  header  being  copied  does  not  exist or is
               deleted in source SIP message.


     ENOMEM    Error while allocating memory for creating the new
               header.


     EPERM     If the input SIP message cannot be modified.


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



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






















































SunOS 5.11          Last change: 25 Jan 2007                    3