mirror of
https://github.com/asterisk/asterisk.git
synced 2025-09-02 11:06:31 +00:00
a80179bfe7
* Do a git blame on the embedded XML application or function element.
* From the commit hash, grab the summary line.
* Do a git log --grep <summary> to find the cherry-pick commits in all
branches that match.
* Do a git patch-id to ensure the commits are all related and didn't get
a false match on the summary.
* Do a git tag --contains <commit> to find the tags that contain each
commit.
* Weed out all tags not ..0.
* Sort and discard any .0.0 and following tags where the commit
appeared in an earlier branch.
* The result is a single tag for each branch where the application or function
was defined.
The applications and functions defined in the following files were done by
hand because the XML was extracted from the C source file relatively recently.
* channels/pjsip/dialplan_functions_doc.xml
* main/logger_doc.xml
* main/manager_doc.xml
* res/res_geolocation/geoloc_doc.xml
* res/res_stir_shaken/stir_shaken_doc.xml
(cherry picked from commit 85a4ab8390)
59 lines
2.7 KiB
XML
59 lines
2.7 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!DOCTYPE docs SYSTEM "appdocsxml.dtd">
|
|
<?xml-stylesheet type="text/xsl" href="appdocsxml.xslt"?>
|
|
<docs xmlns:xi="http://www.w3.org/2001/XInclude">
|
|
<function name="LOG_GROUP" language="en_US">
|
|
<since><version>18.21.0</version><version>20.6.0</version><version>21.1.0</version></since>
|
|
<synopsis>
|
|
Set the channel group name for log filtering on this channel
|
|
</synopsis>
|
|
<syntax>
|
|
<parameter name="group" required="false">
|
|
<para>Channel log group name. Leave empty to remove any existing group membership.</para>
|
|
<para>You can use any arbitrary alphanumeric name that can then be used by the
|
|
"logger filter changroup" CLI command to filter dialplan output by group name.</para>
|
|
</parameter>
|
|
</syntax>
|
|
<description>
|
|
<para>Assign a channel to a group for log filtering.</para>
|
|
<para>Because this application can result in dialplan execution logs
|
|
being suppressed (or unsuppressed) from the CLI if filtering is active,
|
|
it is recommended to call this as soon as possible when dialplan execution begins.</para>
|
|
<para>Calling this multiple times will replace any previous group assignment.</para>
|
|
<example title="Associate channel with group test">
|
|
exten => s,1,Set(LOG_GROUP()=test)
|
|
same => n,NoOp() ; if a logging call ID group filter name is enabled but test is not included, you will not see this
|
|
</example>
|
|
<example title="Associate channel with group important">
|
|
exten => s,1,Set(LOG_GROUP()=important)
|
|
same => n,Set(foo=bar) ; do some important things to show on the CLI (assuming it is filtered with important enabled)
|
|
same => n,Set(LOG_GROUP()=) ; remove from group important to stop showing execution on the CLI
|
|
same => n,Wait(5) ; do some unimportant stuff
|
|
</example>
|
|
</description>
|
|
<see-also>
|
|
<ref type="application">Log</ref>
|
|
</see-also>
|
|
</function>
|
|
<managerEvent language="en_US" name="LogChannel">
|
|
<managerEventInstance class="EVENT_FLAG_SYSTEM">
|
|
<since><version>16.24.0</version><version>18.10.0</version><version>19.2.0</version></since>
|
|
<synopsis>Raised when a logging channel is re-enabled after a reload operation.</synopsis>
|
|
<syntax>
|
|
<parameter name="Channel">
|
|
<para>The name of the logging channel.</para>
|
|
</parameter>
|
|
</syntax>
|
|
</managerEventInstance>
|
|
<managerEventInstance class="EVENT_FLAG_SYSTEM">
|
|
<since><version>16.24.0</version><version>18.10.0</version><version>19.2.0</version></since>
|
|
<synopsis>Raised when a logging channel is disabled.</synopsis>
|
|
<syntax>
|
|
<parameter name="Channel">
|
|
<para>The name of the logging channel.</para>
|
|
</parameter>
|
|
</syntax>
|
|
</managerEventInstance>
|
|
</managerEvent>
|
|
</docs>
|