Session Initiation Protocol Library Functions
                                           sipcreateOKack(3SIP)



NAME
     sipcreateOKack  -  create  an  ACK  request  for  a  final
     response

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

     int sipcreateOKack(sipmsgt response,
          sipmsgt ackmsg, char *transport,
          char *sentby, int sentbyport,
          char *viaparams);


DESCRIPTION
     The sipcreateOKack() function constructs an ACK request in
     ackmsg  for the final 2X SIP response. The request line is
     created using  the  URI  in  the  CONTACT  header  from  the
     response.  The SIP-Version in the request line is "2.0". The
     VIA header for the ACK request is created  using  transport,
     sentby,  sentbyport  (if  non-zero),  and  viaparams (if
     non-null). The following headers are copied to ackmsg  from
     response:
       FROM
       TO
       CAL-ID
       MAXFORWARDS


     The CSEQ header is created using the method as ACK  and  the
     sequence number from the CSEQ header in response.

RETURN VALUES
     The sipcreateOKack() function returns 0 on success and the
     appropriate error value in case of failure.


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

ERORS
     On failure, the sipcreateOKack() function could return one
     of the following errors:

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

                The sipcreateOKack() function can  return  this
                error  if it does not find a CONTACT header or if
                it is unable to obtain the URI from  the  CONTACT
                header for the request line.



SunOS 5.11          Last change: 25 Jan 2007                    1






Session Initiation Protocol Library Functions
                                           sipcreateOKack(3SIP)



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






















































SunOS 5.11          Last change: 25 Jan 2007                    3