Session Initiation Protocol Library Functions
                                      sipcreatedialogreq(3SIP)



NAME
     sipcreatedialogreq,   sipcreatedialogreqnocontact   -
     create an in-dialog request

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

     sipmsgt sipcreatedialogreq(sipmethodt method,
          sipdialogt dialog, char *transport, char *sentby,
          int sentbyport, char *viaparam, uint32t smaxforward,
          int cseq);


     sipmsgt sipcreatedialogreqnocontact(sipmethodt method,
          sipdialogt dialog, char *transport, char *sentby,
          int sentbyport, char *viaparam, uint32t smaxforward,
          int cseq);


DESCRIPTION
     The sipcreatedialogreq() function creates and  returns  a
     SIP  request with the state information contained in dialog.
     The method in the resulting  request  is  from  method.  The
     method can be one of the following:
       INVITE
       ACK
       OPTIONS
       BYE
       CANCEL
       REGISTER
       REFER
       INFO
       SUBSCRIBE
       NOTIFY
       PRACK


     The resulting request line in the SIP message has  the  SIP-
     Version  of  "2.0".  The URI in the request line is from the
     remote target in the dialog or from the  route  set  in  the
     dialog, if present. See RFC 3261 (section 12.2) for details.
     The FROM, TO, and CAL-ID headers are added from the dialog.
     The  MAX-FORWARDS header is added using the value in maxfor-
     ward. The CSEQ header is  added  using  the  SIP  method  in
     method and the sequence number value in cseq. If cseq is -1,
     the sequence number is  obtained  from  the  local  sequence
     number  in the dialog. The local sequence number in the dia-
     log is incremented and is used in the CSEQ header.  The  VIA
     header  added  is  created  using  the  transport,  sentby,
     sentbyport (if  non-zero),  and  viaparam  (if  any).  If



SunOS 5.11           Last change: 6 Aug 2007                    1






Session Initiation Protocol Library Functions
                                      sipcreatedialogreq(3SIP)



     dialog  has a non-empty route set, the resulting SIP request
     has the route set from the dialog.


     The sipcreatedialogreqnocontact() function is similar to
     sipcreatedialogreq(),  except  that  it  does not add the
     contact header.

RETURN VALUES
     The               sipcreatedialogreq()                and
     sipcreatedialogreqnocontact()   functions   return   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:



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


SEE ALSO
     libsip(3LIB), attributes(5)




















SunOS 5.11           Last change: 6 Aug 2007                    2






Session Initiation Protocol Library Functions
                                      sipcreatedialogreq(3SIP)






















































SunOS 5.11           Last change: 6 Aug 2007                    3