Session Initiation Protocol Library Functions
                                              sipgettrans(3SIP)



NAME
     sipgettrans - lookup a transaction

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

     const struct sipxaction *sipgettrans(sipmsgt sipmsg, int which,
          int *error);


DESCRIPTION
     The sipgettrans() transaction for the SIP message sipmsg.
     A  transaction  is  not freed if there are any references on
     it.


     The transaction type should be specified as one of the  fol-
     lowing:
       SIPCLIENTRANSACTON - lookup a client transaction
       SIPSERVERTRANSACTON - lookup a server transaction


     The sipgettrans() function matches a transaction to a mes-
     sage  as  specified in RFC 3261, sections 17.1.3 and 17.2.3.
     The  sipgettrans()  function  holds  a  reference  to  the
     returned transaction. The caller must release this reference
     after use.

RETURN VALUES
     The sipgettrans() function returns the required  value  on
     success or NUL on failure.


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

ERORS
     On success, the value of the location pointed to by error is
     set to 0.

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






















































SunOS 5.11          Last change: 25 Jan 2007                    3