Manual Pages for UNIX Operating System command usage for man sip_get_trans

Session Initiation Protocol Library Functions
                                              sip_get_trans(3SIP)



NAME
     sip_get_trans - lookup a transaction

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

     const struct sip_xaction *sip_get_trans(sip_msg_t sip_msg, int which,
          int *error);


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


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


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

RETURN VALUES
     The sip_get_trans() function returns the required  value  on
     success or NULL on failure.


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

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

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:










SunOS 5.11          Last change: 25 Jan 2007                    1






Session Initiation Protocol Library Functions
                                              sip_get_trans(3SIP)



______________________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE 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
                                              sip_get_trans(3SIP)






















































SunOS 5.11          Last change: 25 Jan 2007                    3