Session Initiation Protocol Library Functions
                                       sipaddrequestline(3SIP)



NAME
     sipaddrequestline,   sipaddresponseline   -   add    a
     request/response line to a SIP message

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

     int sipaddrequestline(sipmsgt siprequest,
          sipmethodt method, char *requesturi);


     int sipaddresponseline(sipmsgt sipresponse,
          int responsecode, char *responsephase);


DESCRIPTION
     The sipaddrequestline() function adds a request  line  to
     the  SIP  message  siprequest.  The request line is created
     using the SIP method specified in  method  and  the  URI  in
     requesturi. The SIP method can be one of the following:
       INVITE
       ACK
       OPTIONS
       BYE
       CANCEL
       REGISTER
       REFER
       SUBSCRIBE
       NOTIFY
       PRACK
       INFO


     The resulting request line has the SIP-Version of "2.0".


     The sipaddresponseline() function adds a response line to
     the  SIP  message sipresponse. The response line is created
     using the response code  responsecode  and  the  phrase  in
     responsephrase.  If the responsecode is one that is listed
     in RFC 3261, sipgetrespdesc() can  be  used  to  get  the
     response phase for the responsecode. The resulting response
     line has the SIP-Version of "2.0".

RETURN VALUES
     The sipaddresponseline() and sipaddrequestline() func-
     tions return 0 on success and the appropriate error value in
     case of failure.





SunOS 5.11          Last change: 25 Jan 2007                    1






Session Initiation Protocol Library Functions
                                       sipaddrequestline(3SIP)



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

ERORS
     On     failure,     the     sipaddresponseline()      and
     sipaddrequestline()  functions  could  return  one of the
     following errors:

     EINVAL     If mandatory input is  not  provided  or  if  the
                input is invalid.


     ENOTSUP    If the input SIP message cannot be modified.


     ENOMEM     If memory  allocation  fails  when  creating  the
                request/response line or when creating headers in
                the ACK request.


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






















































SunOS 5.11          Last change: 25 Jan 2007                    3