chan_sip: Access incoming REFER headers in dialplan
authorkkm <kkm@smartaction.com>
Sun, 30 Jul 2017 01:03:02 +0000 (18:03 -0700)
committerJoshua Colp <jcolp@digium.com>
Mon, 7 Aug 2017 11:17:39 +0000 (11:17 +0000)
commit4b58609c331c013845a0a61d946cbbc82092170e
treec793b39e5dd2ce12f4826a97f767708860d3ff45
parent2ba29df200f924f34d47371b83d0371c824bc76c
chan_sip: Access incoming REFER headers in dialplan

This adds a way to access information passed along with SIP headers in
a REFER message that initiates a transfer. Headers matching a dialplan
variable GET_TRANSFERRER_DATA in the transferrer channel are added to
a HASH object TRANSFER_DATA to be accessed with functions HASHKEY and HASH.

The variable GET_TRANSFERRER_DATA is interpreted to be a prefix for
headers that should be put into the hash. If not set, no headers are
included. If set to a string (perhaps 'X-' in a typical case), all headers
starting this string are added. Empty string matches all headers.

If there are multiple of the same header, only the latest occurrence in
the REFER message is available in the hash.

Obviously, the variable GET_TRANSFERRER_DATA must be inherited by the
referrer channel, and should be set with the '_' or '__' prefix.

I avoided a specific reference to SIP or REFER, as in my mind the mechanism
can be generalized to other channel techs.

ASTERISK-27162

Change-Id: I73d7a1e95981693bc59aa0d5093c074b555f708e
CHANGES
channels/chan_sip.c