diff options
author | Benny Prijono <bennylp@teluu.com> | 2006-11-11 16:16:04 +0000 |
---|---|---|
committer | Benny Prijono <bennylp@teluu.com> | 2006-11-11 16:16:04 +0000 |
commit | e6a5b770072500cf89a9cc10e4b99a972a6787b8 (patch) | |
tree | ec336215fc83344cec58d01dd30a74d7f6054e67 /pjsip/include/pjsip-ua/sip_xfer.h | |
parent | e4fa39f3acb0b969dd1f952e81b33b2dff671002 (diff) |
Attended call transfer implementation. The changes involves:
- Added support for SIP Replaces extension (RFC 3891)
- Added pjsua_call_xfer_replaces() to perform attended call
transfer.
- PJSUA checks and process Replaces header in incoming calls
- Added pjsip_ua_find_dialog() API.
- Added pjsip_endpt_has_capability() API.
- Added pjsip_endpt_send_response2() API.
- etc.
git-svn-id: http://svn.pjsip.org/repos/pjproject/trunk@797 74dad513-b988-da41-8d7b-12977e46ad98
Diffstat (limited to 'pjsip/include/pjsip-ua/sip_xfer.h')
-rw-r--r-- | pjsip/include/pjsip-ua/sip_xfer.h | 31 |
1 files changed, 23 insertions, 8 deletions
diff --git a/pjsip/include/pjsip-ua/sip_xfer.h b/pjsip/include/pjsip-ua/sip_xfer.h index 56809141..53d98e90 100644 --- a/pjsip/include/pjsip-ua/sip_xfer.h +++ b/pjsip/include/pjsip-ua/sip_xfer.h @@ -29,17 +29,32 @@ #include <pjsip/sip_msg.h> /** - * @defgroup PJSUA_XFER Call Transfer + * @defgroup PJSUA_XFER SIP REFER (RFC 3515) for Call Transfer etc. * @ingroup PJSIP_HIGH_UA - * @brief Provides call transfer functionality. + * @brief SIP REFER dialog usage (call transfer, etc.) * @{ * - * This implements call transfer functionality to INVITE sessions. The call - * transfer functionality uses SIP Event Subscription framework for - * managing call transfer status. - * - * Application must link with <b>pjsip-ua</b> AND <b>pjsip-simple</b> static - * libraries to use call transfer functionality. + * This describes a generic handling of SIP REFER request. The SIP REFER + * request is described in RFC 3515, and commonly used to perform call + * transfer functionality. Other types of SIP REFER usages are described + * in draft-worley-sip-many-refers-00 draft, for example: + * - Remote Dial: where UAC sends REFER to instruct REFER recipient to + * initiate an INVITE session to some target. + * + * A REFER request can be sent inside or outside existing dialog context, + * although for call transfer case, it is more common to send REFER inside + * existing INVITE session context. PJSIP supports both sending REFER request + * inside or outside dialog context. + * + * The REFER framework uses @ref PJSIP_EVENT_NOT to manage the event + * subscription created by the REFER request. Because of this, application + * must link with <b>pjsip-ua</b> AND <b>pjsip-simple</b> static libraries + * to use REFER functionality. + * + * Reference: + * - <A HREF="http://www.ietf.org/rfc/rfc3515.txt">RFC 3515: The Session + * Initiation Protocol (SIP) Refer Method</A> + * - @ref PJSIP_EVENT_NOT */ |