chan_sip: option 'notifyringing' change and doc fix
authorWard van Wanrooij <ward@ward.nu>
Sat, 26 Dec 2015 15:24:09 +0000 (16:24 +0100)
committerWard van Wanrooij <ward@ward.nu>
Sat, 26 Dec 2015 15:24:09 +0000 (16:24 +0100)
commitd4b10cfb3e41e7635385866b7f96968c6b1e9cb1
tree9e044a3e1d8a4ceb82b839cd91edcef208f6b51f
parente90bb44b76d1c34817b5ad7db34c1c595c644702
chan_sip: option 'notifyringing' change and doc fix

In the sample sip.conf this is written with regard to notifyringing:
;notifyringing = no ; Control whether subscriptions already INUSE get sent
RINGING when another call is sent (default: yes)

However, this setting changes whether or not any RINGING indications are sent
to subscriptions. There is no separate configurable setting that allows
to control whether INUSE subscriptions also get sent RINGING. This is however
a useful option, to see (using BLF) if somebody else is able to handle an
incoming call or if everybody is busy.

This patch corrects the documentation for notifyringing (so the documentation
matches the functionality) and make notifyringing a tri-state option, by adding
the value 'notinuse' (in addition to 'yes' and 'no'). When notifyringing =
notinuse, only subscriptions that are not INUSE are sent the RINGING signal.

The default setting for notifyringing remains set to yes, so the default
behaviour is not affected.

ASTERISK-25558

Change-Id: I88f7036ee084bb3f43b74f15612695c6708f74aa
channels/chan_sip.c
channels/sip/include/sip.h
configs/samples/sip.conf.sample