Session Initiation Protocol Library Functions   sipsendmsg(3SIP)



NAME
     sipsendmsg - send an outbound SIP message to the SIP  stack
     for processing

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

     int sipsendmsg(sipconnobjectt obj, sipmsgt sipmsg,
          sipdialogt dialog, uint32t flags);


DESCRIPTION
     The sipsendmsg() function is used to send an  outbound  SIP
     message sipmsg to the SIP stack on its way to the peer. The
     connection object for the SIP message is passed as obj.  The
     caller also provides the dialog associated with the message,
     if one exists. The value of flags is the result of ORing the
     following, as required:

     SIPSENDSTATEFUL     Send the request  or  response  state-
                           fully.   This  results  in  the  stack
                           creating and maintaining a transaction
                           for  this  request/response.  If  this
                           flag is not set transactions  are  not
                           created for the request/response.


     SIPDIALOGONFORK    When this flag is set, the  stack  may
                           create  multiple  dialogs for a dialog
                           completing response. This  may  result
                           due  to forking of the dialog creating
                           request. If this flag is not set,  the
                           first  response  to  a dialog creating
                           request creates a dialog,  but  subse-
                           quent ones do not. It is only meaning-
                           ful if  the  stack  is  configured  to
                           maintain dialogs.


RETURN VALUES
     The sipsendmsg() function returns  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.

ERORS
     The sipsendmsg() function can return one of  the  following
     errors on failure:




SunOS 5.11          Last change: 25 Jan 2007                    1






Session Initiation Protocol Library Functions   sipsendmsg(3SIP)



     EINVAL    If a message is  being  statefully  sent  and  the
               branchid in the VIA header does not conform to RFC
               3261 or when accessing CSEQ header while  creating
               a transaction.


     ENOENT    If a message is being statefully sent, error  get-
               ting the CSEQ header while creating a transaction.


     EPROTO    If a message is being statefully sent, error  get-
               ting the CSEQ value while creating a transaction.


     ENOMEM    If the message is  being  statefully  sent,  error
               allocating  memory  for creating or adding a tran-
               saction or during transaction related processing.


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