asterisk/doc
Naveen Albert 2b930d7c3b cdr: Allow bridging and dial state changes to be ignored.
Allows bridging, parking, and dial messages to be globally
ignored for all CDRs such that only a single CDR record
is generated per channel.

This is useful when CDRs should endure for the lifetime of
an entire channel and bridging and dial updates in the
dialplan should not result in multiple CDR records being
created for the call. With the ignore bridging option,
bridging changes have no impact on the channel's CDRs.
With the ignore dial state option, multiple Dials and their
outcomes have no impact on the channel's CDRs. The
last disposition on the channel is preserved in the CDR,
so the actual disposition of the call remains available.

These two options can reduce the amount of "CDR hacks" that
have hitherto been necessary to ensure that CDR was not
"spoiled" by these messages if that was undesired, such as
putting a dummy optimization-disabled local channel between
the caller and the actual call and putting the CDR on the channel
in the middle to ensure that CDR would persist for the entire
call and properly record start, answer, and end times.
Enabling these options is desirable when calls correspond
to the entire lifetime of channels and the CDR should
reflect that.

Current default behavior remains unchanged.

ASTERISK-30091 #close

Change-Id: I393981af42732ec5ac3ff9266444abb453b7c832
2022-10-10 12:07:03 -05:00
..
CHANGES-staging cdr: Allow bridging and dial state changes to be ignored. 2022-10-10 12:07:03 -05:00
UPGRADE-staging res_crypto: Don't load non-regular files in keys directory 2022-09-12 07:55:46 -05:00
lang doc/lang/language-criteria.txt: Link to wiki. 2018-02-20 04:32:44 -06:00
.gitignore progdocs: Update Makefile. 2021-12-08 17:23:51 +01:00
CODING-GUIDELINES Restore CODING-GUIDELINES to doc folder 2012-08-30 12:50:03 +00:00
Doxyfile.in progdocs: Update Makefile. 2021-12-08 17:23:51 +01:00
IAX2-security.pdf Merged revisions 216008 via svnmerge from 2009-09-03 18:45:54 +00:00
IAX2-security.txt Merged revisions 216263 via svnmerge from 2009-09-04 10:48:44 +00:00
Makefile Remove as much trailing whitespace as possible. 2017-12-22 09:23:22 -05:00
README.txt Remove as much trailing whitespace as possible. 2017-12-22 09:23:22 -05:00
aelparse.8 doc: Add a manpage for the aelparse utility 2014-08-29 19:35:43 +00:00
appdocsxml.dtd res_geolocation: Allow location parameters on the profile object 2022-09-10 12:50:52 -05:00
appdocsxml.xslt xmldoc: Avoid whitespace around value for parameter/required. 2021-12-13 09:11:25 -06:00
astdb2bdb.8 Remove as much trailing whitespace as possible. 2017-12-22 09:23:22 -05:00
astdb2sqlite3.8 Remove as much trailing whitespace as possible. 2017-12-22 09:23:22 -05:00
asterisk.8 asterisk.c: Warn of incompatibilities with remote console. 2022-04-27 12:38:20 -05:00
asterisk.sgml Remove as much trailing whitespace as possible. 2017-12-22 09:23:22 -05:00
smsq.8 doc: Add a manpage for the smsq utility 2014-08-29 19:40:34 +00:00

README.txt

The vast majority of the Asterisk project documentation has been moved to the
project wiki:

    https://wiki.asterisk.org/

Asterisk release tarballs contain an export of the wiki in PDF and plain text
form, which you can find in:

    doc/AST.pdf
    doc/AST.txt

Asterisk uses the Doxygen documentation software.  Run "make progdocs" and open
the resulting documentation index at doc/api/index.html in a webbrowser or copy
the directory to a directory served by a webserver for remote access.