Session Initiation Protocol Library Functions
                                        sipcreateresponse(3SIP)



NAME
     sipcreateresponse - create a response for a SIP request

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

     sipmsgt sipcreateresponse(sipmsgt siprequest,
          int responsecode, char *responsephase,
          char *totag, char *contacturi);


DESCRIPTION
     The sipcreateresponse() function creates and returns a SIP
     message  in  response  to  the  SIP request siprequest. The
     response line in the resulting SIP message is created  using
     the  response  code  in  responsecode  and  the  phrase  in
     responsephrase. The response line has  the  SIP-Version  of
     "2.0".  If  a non-null totag is specified, the resulting SIP
     response has a TO header with a tag  value  from  totag.  If
     totag  is  null and the responsecode is anything other than
     100 (TRYING), sipcreateresponse() adds a TO header with  a
     randomly  generated  tag  value. If the responsecode is 100
     and totag is null, the SIP response has a TO header  without
     a  tag  parameter.  If  contacturi  is  non-null, a CONTACT
     header is added to the SIP response with the  URI  specified
     in  contacturi.  The SIP response has the following headers
     copied from siprequest:
       All VIA headers
       FROM header
       TO header (with tag added, if required, as stated above)
       CAL-ID header
       CSEQ header
       All RECORD-ROUTE headers

RETURN VALUES
     The sipcreateresponse() function returns the resulting SIP
     message on success and NUL 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
                                        sipcreateresponse(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
                                        sipcreateresponse(3SIP)






















































SunOS 5.11          Last change: 25 Jan 2007                    3