/*** DOCUMENTATION
<application name="ADSIProg" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>0.1.12</version>
+ </since>
<synopsis>
Load Asterisk ADSI Scripts into phone
</synopsis>
/*** DOCUMENTATION
<application name="AgentLogin" language="en_US">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>
Login an agent.
</synopsis>
</see-also>
</application>
<application name="AgentRequest" language="en_US">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>
Request an agent to connect with the channel.
</synopsis>
</see-also>
</application>
<function name="AGENT" language="en_US">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>
Gets information about an Agent
</synopsis>
</manager>
<managerEvent language="en_US" name="Agents">
<managerEventInstance class="EVENT_FLAG_AGENT">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>
Response event in a series to the Agents AMI action containing
information about a defined agent.
</managerEvent>
<managerEvent language="en_US" name="AgentsComplete">
<managerEventInstance class="EVENT_FLAG_AGENT">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>
Final response event in a series of events to the Agents AMI action.
</synopsis>
<synopsis>Unused, but reserved.</synopsis>
</configObject>
<configObject name="agent-id">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Configure an agent for the pool.</synopsis>
<description>
<xi:include xpointer="xpointer(/docs/configInfo[@name='app_agent_pool']/description/note)" />
</description>
<configOption name="ackcall">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Enable to require the agent to acknowledge a call.</synopsis>
<description>
<para>Enable to require the agent to give a DTMF acknowledgement
</description>
</configOption>
<configOption name="acceptdtmf">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>DTMF key sequence the agent uses to acknowledge a call.</synopsis>
<description>
<note><para>The option is overridden by <variable>AGENTACCEPTDTMF</variable> on agent login.</para></note>
</description>
</configOption>
<configOption name="autologoff">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Time the agent has to acknowledge a call before being logged off.</synopsis>
<description>
<para>Set how many seconds a call for the agent has to wait for the
</description>
</configOption>
<configOption name="wrapuptime">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Minimum time the agent has between calls.</synopsis>
<description>
<para>Set the minimum amount of time in milliseconds after
</description>
</configOption>
<configOption name="musiconhold">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Music on hold class the agent listens to between calls.</synopsis>
<description>
<xi:include xpointer="xpointer(/docs/configInfo[@name='app_agent_pool']/description/note)" />
</description>
</configOption>
<configOption name="recordagentcalls">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Enable to automatically record calls the agent takes.</synopsis>
<description>
<para>Enable recording calls the agent takes automatically by
</description>
</configOption>
<configOption name="custom_beep">
- <since><version>12.4.0</version></since>
+ <since>
+ <version>12.4.0</version>
+ </since>
<synopsis>Sound file played to alert the agent when a call is present.</synopsis>
<description>
<xi:include xpointer="xpointer(/docs/configInfo[@name='app_agent_pool']/description/note)" />
</description>
</configOption>
<configOption name="fullname">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>A friendly name for the agent used in log messages.</synopsis>
<description>
<xi:include xpointer="xpointer(/docs/configInfo[@name='app_agent_pool']/description/note)" />
static const char app[] = "AlarmReceiver";
/*** DOCUMENTATION
<application name="AlarmReceiver" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.0.0</version>
+ </since>
<synopsis>
Provide support for receiving alarm reports from a burglar or fire alarm panel.
</synopsis>
/*** DOCUMENTATION
<application name="AMD" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.4.0</version>
+ </since>
<synopsis>
Attempt to detect answering machines.
</synopsis>
/*** DOCUMENTATION
<application name="AttendedTransfer" language="en_US">
- <since><version>13.28.0</version><version>16.5.0</version></since>
+ <since>
+ <version>13.28.0</version>
+ <version>16.5.0</version>
+ </since>
<synopsis>
Attended transfer to the extension provided and TRANSFER_CONTEXT
</synopsis>
/*** DOCUMENTATION
<application name="AudioSocket" language="en_US">
- <since><version>18.0.0</version></since>
+ <since>
+ <version>18.0.0</version>
+ </since>
<synopsis>
Transmit and receive audio between channel and TCP socket
</synopsis>
static const char app[] = "Authenticate";
/*** DOCUMENTATION
<application name="Authenticate" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>0.4.0</version>
+ </since>
<synopsis>
Authenticate a user
</synopsis>
/*** DOCUMENTATION
<application name="BlindTransfer" language="en_US">
- <since><version>13.28.0</version><version>16.5.0</version></since>
+ <since>
+ <version>13.28.0</version>
+ <version>16.5.0</version>
+ </since>
<synopsis>
Blind transfer channel(s) to the extension and context provided
</synopsis>
/*** DOCUMENTATION
<application name="BridgeAdd" language="en_US">
- <since><version>14.0.0</version></since>
+ <since>
+ <version>14.0.0</version>
+ </since>
<synopsis>
Join a bridge that contains the specified channel.
</synopsis>
/*** DOCUMENTATION
<application name="BridgeWait" language="en_US">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>
Put a call into the holding bridge.
</synopsis>
/*** DOCUMENTATION
<application name="Broadcast" language="en_US">
- <since><version>18.17.0</version><version>20.2.0</version></since>
+ <since>
+ <version>18.17.0</version>
+ <version>20.2.0</version>
+ </since>
<synopsis>
Transmit or receive audio to or from multiple channels simultaneously
</synopsis>
/*** DOCUMENTATION
<application name="ResetCDR" language="en_US">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>
Resets the Call Data Record.
</synopsis>
/*** DOCUMENTATION
<application name="CELGenUserEvent" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.8.0</version>
+ </since>
<synopsis>
Generates a CEL User Defined Event.
</synopsis>
/*** DOCUMENTATION
<application name="ChanIsAvail" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>0.4.0</version>
+ </since>
<synopsis>
Check channel availability
</synopsis>
/*** DOCUMENTATION
<application name="ChannelRedirect" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.4.0</version>
+ </since>
<synopsis>
Redirects given channel to a dialplan target
</synopsis>
/*** DOCUMENTATION
<application name="ChanSpy" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Listen to a channel, and optionally whisper into it.
</synopsis>
</see-also>
</application>
<application name="ExtenSpy" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.4.0</version>
+ </since>
<synopsis>
Listen to a channel, and optionally whisper into it.
</synopsis>
</see-also>
</application>
<application name="DAHDIScan" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.4.22</version>
+ </since>
<synopsis>
Scan DAHDI channels to monitor calls.
</synopsis>
/*** DOCUMENTATION
<application name="ConfBridge" language="en_US">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>
Conference bridge application.
</synopsis>
</see-also>
</application>
<function name="CONFBRIDGE" language="en_US">
- <since><version>10.0.0</version></since>
+ <since>
+ <version>10.0.0</version>
+ </since>
<synopsis>
Set a custom dynamic bridge, user, or menu profile on a channel for the
ConfBridge application using the same options available in confbridge.conf.
</description>
</function>
<function name="CONFBRIDGE_INFO" language="en_US">
- <since><version>10.0.0</version></since>
+ <since>
+ <version>10.0.0</version>
+ </since>
<synopsis>
Get information about a ConfBridge conference.
</synopsis>
</manager>
<managerEvent language="en_US" name="ConfbridgeList">
<managerEventInstance class="EVENT_FLAG_REPORTING">
- <since><version>13.20.0</version><version>15.3.0</version></since>
+ <since>
+ <version>13.20.0</version>
+ <version>15.3.0</version>
+ </since>
<synopsis>Raised as part of the ConfbridgeList action response list.</synopsis>
<syntax>
<parameter name="Conference">
</manager>
<managerEvent language="en_US" name="ConfbridgeListRooms">
<managerEventInstance class="EVENT_FLAG_REPORTING">
- <since><version>16.29.0</version><version>18.15.0</version><version>19.7.0</version></since>
+ <since>
+ <version>16.29.0</version>
+ <version>18.15.0</version>
+ <version>19.7.0</version>
+ </since>
<synopsis>Raised as part of the ConfbridgeListRooms action response list.</synopsis>
<syntax>
<parameter name="Conference">
/*** DOCUMENTATION
<application name="ControlPlayback" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.0.0</version>
+ </since>
<synopsis>
Play a file with fast forward and rewind.
</synopsis>
/*** DOCUMENTATION
<application name="DBdeltree" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>0.4.0</version>
+ </since>
<synopsis>
Delete a family or keytree from the asterisk database.
</synopsis>
/*** DOCUMENTATION
<application name="Dial" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>0.1.0</version>
+ </since>
<synopsis>
Attempt to connect to another device or endpoint and bridge the call.
</synopsis>
</see-also>
</application>
<application name="RetryDial" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Place a call, retrying on failure allowing an optional exit extension.
</synopsis>
/*** DOCUMENTATION
<application name="Dictate" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Virtual Dictation Machine.
</synopsis>
/*** DOCUMENTATION
<application name="Pickup" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Directed extension call pickup.
</synopsis>
</description>
</application>
<application name="PickupChan" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.0</version>
+ </since>
<synopsis>
Pickup a ringing channel.
</synopsis>
/*** DOCUMENTATION
<application name="Directory" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>0.1.0</version>
+ </since>
<synopsis>
Provide directory of voicemail extensions.
</synopsis>
/*** DOCUMENTATION
<application name="DISA" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>0.1.9</version>
+ </since>
<synopsis>
Direct Inward System Access.
</synopsis>
/*** DOCUMENTATION
<application name="DumpChan" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Dump Info About The Calling Channel.
</synopsis>
/*** DOCUMENTATION
<application name="Echo" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>0.1.2</version>
+ </since>
<synopsis>
Echo media, DTMF back to the calling party
</synopsis>
/*** DOCUMENTATION
<application name="Exec" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.0.0</version>
+ </since>
<synopsis>
Executes dialplan application.
</synopsis>
</description>
</application>
<application name="TryExec" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.4.0</version>
+ </since>
<synopsis>
Executes dialplan application, always returning.
</synopsis>
</description>
</application>
<application name="ExecIf" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Executes dialplan application, conditionally.
</synopsis>
/*** DOCUMENTATION
<application name="ExternalIVR" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Interfaces with an external IVR application.
</synopsis>
/*** DOCUMENTATION
<application name="Festival" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>0.2.0</version>
+ </since>
<synopsis>
Say text to the user.
</synopsis>
/*** DOCUMENTATION
<application name="Flash" language="en_US">
- <since><version>1.6.1.0</version></since>
+ <since>
+ <version>1.6.1.0</version>
+ </since>
<synopsis>
Flashes a DAHDI Trunk.
</synopsis>
/*** DOCUMENTATION
<application name="FollowMe" language="en_US">
- <since><version>1.6.1.0</version></since>
+ <since>
+ <version>1.6.1.0</version>
+ </since>
<synopsis>
Find-Me/Follow-Me application.
</synopsis>
/*** DOCUMENTATION
<application name="ForkCDR" language="en_US">
- <since><version>1.6.1.0</version></since>
+ <since>
+ <version>1.6.1.0</version>
+ </since>
<synopsis>
Forks the current Call Data Record for this channel.
</synopsis>
/*** DOCUMENTATION
<application name="GetCPEID" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>0.1.12</version>
+ </since>
<synopsis>
Get ADSI CPE ID.
</synopsis>
/*** DOCUMENTATION
<application name="If" language="en_US">
- <since><version>18.16.0</version><version>20.1.0</version></since>
+ <since>
+ <version>18.16.0</version>
+ <version>20.1.0</version>
+ </since>
<synopsis>
Start an if branch.
</synopsis>
</see-also>
</application>
<application name="ElseIf" language="en_US">
- <since><version>18.16.0</version><version>20.1.0</version></since>
+ <since>
+ <version>18.16.0</version>
+ <version>20.1.0</version>
+ </since>
<synopsis>
Start an else if branch.
</synopsis>
</see-also>
</application>
<application name="Else" language="en_US">
- <since><version>18.16.0</version><version>20.1.0</version></since>
+ <since>
+ <version>18.16.0</version>
+ <version>20.1.0</version>
+ </since>
<synopsis>
Define an optional else branch.
</synopsis>
</see-also>
</application>
<application name="EndIf" language="en_US">
- <since><version>18.16.0</version><version>20.1.0</version></since>
+ <since>
+ <version>18.16.0</version>
+ <version>20.1.0</version>
+ </since>
<synopsis>
End an if branch.
</synopsis>
</see-also>
</application>
<application name="ExitIf" language="en_US">
- <since><version>18.16.0</version><version>20.1.0</version></since>
+ <since>
+ <version>18.16.0</version>
+ <version>20.1.0</version>
+ </since>
<synopsis>
End an If branch.
</synopsis>
/*** DOCUMENTATION
<application name="IVRDemo" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
IVR Demo Application.
</synopsis>
" name. Use this option to specify a custom client name.\n"
/*** DOCUMENTATION
<application name="JACK" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.0</version>
+ </since>
<synopsis>
Jack Audio Connection Kit
</synopsis>
/*** DOCUMENTATION
<application name="MeetMe" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>0.1.12</version>
+ </since>
<synopsis>
MeetMe conference bridge.
</synopsis>
</see-also>
</application>
<application name="MeetMeCount" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>0.1.12</version>
+ </since>
<synopsis>
MeetMe participant count.
</synopsis>
</see-also>
</application>
<application name="MeetMeAdmin" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.0.0</version>
+ </since>
<synopsis>
MeetMe conference administration.
</synopsis>
</see-also>
</application>
<application name="MeetMeChannelAdmin" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.0</version>
+ </since>
<synopsis>
MeetMe conference Administration (channel specific).
</synopsis>
</description>
</application>
<function name="MEETME_INFO" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.1.0</version>
+ </since>
<synopsis>
Query a given conference of various properties.
</synopsis>
</manager>
<managerEvent language="en_US" name="MeetmeJoin">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a user joins a MeetMe conference.</synopsis>
<syntax>
<parameter name="Meetme">
</managerEvent>
<managerEvent language="en_US" name="MeetmeLeave">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a user leaves a MeetMe conference.</synopsis>
<syntax>
<xi:include xpointer="xpointer(/docs/managerEvent[@name='MeetmeJoin']/managerEventInstance/syntax/parameter)" />
</managerEvent>
<managerEvent language="en_US" name="MeetmeEnd">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a MeetMe conference ends.</synopsis>
<syntax>
<xi:include xpointer="xpointer(/docs/managerEvent[@name='MeetmeJoin']/managerEventInstance/syntax/parameter[@name='Meetme'])" />
</managerEvent>
<managerEvent language="en_US" name="MeetmeTalkRequest">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a MeetMe user has started talking.</synopsis>
<syntax>
<xi:include xpointer="xpointer(/docs/managerEvent[@name='MeetmeJoin']/managerEventInstance/syntax/parameter)" />
</managerEvent>
<managerEvent language="en_US" name="MeetmeTalking">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a MeetMe user begins or ends talking.</synopsis>
<syntax>
<xi:include xpointer="xpointer(/docs/managerEvent[@name='MeetmeJoin']/managerEventInstance/syntax/parameter)" />
</managerEvent>
<managerEvent language="en_US" name="MeetmeMute">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a MeetMe user is muted or unmuted.</synopsis>
<syntax>
<xi:include xpointer="xpointer(/docs/managerEvent[@name='MeetmeJoin']/managerEventInstance/syntax/parameter)" />
</managerEvent>
<managerEvent language="en_US" name="MeetmeList">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>16.29.0</version><version>18.15.0</version><version>19.7.0</version></since>
+ <since>
+ <version>16.29.0</version>
+ <version>18.15.0</version>
+ <version>19.7.0</version>
+ </since>
<synopsis>Raised in response to a MeetmeList command.</synopsis>
<syntax>
<parameter name="Conference">
</managerEvent>
<managerEvent language="en_US" name="MeetmeListRooms">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>16.29.0</version><version>18.15.0</version><version>19.7.0</version></since>
+ <since>
+ <version>16.29.0</version>
+ <version>18.15.0</version>
+ <version>19.7.0</version>
+ </since>
<synopsis>Raised in response to a MeetmeListRooms command.</synopsis>
<syntax>
<parameter name="Conference">
/*** DOCUMENTATION
<application name="Milliwatt" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>0.1.12</version>
+ </since>
<synopsis>
Generates a 1004 Hz test tone at 0dbm (mu-law).
</synopsis>
/*** DOCUMENTATION
<application name="MinivmRecord" language="en_US">
- <since><version>1.6.1.0</version></since>
+ <since>
+ <version>1.6.1.0</version>
+ </since>
<synopsis>
Receive Mini-Voicemail and forward via e-mail.
</synopsis>
</description>
</application>
<application name="MinivmGreet" language="en_US">
- <since><version>1.6.1.0</version></since>
+ <since>
+ <version>1.6.1.0</version>
+ </since>
<synopsis>
Play Mini-Voicemail prompts.
</synopsis>
</description>
</application>
<application name="MinivmNotify" language="en_US">
- <since><version>1.6.1.0</version></since>
+ <since>
+ <version>1.6.1.0</version>
+ </since>
<synopsis>
Notify voicemail owner about new messages.
</synopsis>
</description>
</application>
<application name="MinivmDelete" language="en_US">
- <since><version>1.6.1.0</version></since>
+ <since>
+ <version>1.6.1.0</version>
+ </since>
<synopsis>
Delete Mini-Voicemail voicemail messages.
</synopsis>
</application>
<application name="MinivmAccMess" language="en_US">
- <since><version>1.6.1.0</version></since>
+ <since>
+ <version>1.6.1.0</version>
+ </since>
<synopsis>
Record account specific messages.
</synopsis>
</description>
</application>
<application name="MinivmMWI" language="en_US">
- <since><version>1.6.1.0</version></since>
+ <since>
+ <version>1.6.1.0</version>
+ </since>
<synopsis>
Send Message Waiting Notification to subscriber(s) of mailbox.
</synopsis>
</description>
</application>
<function name="MINIVMCOUNTER" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.0</version>
+ </since>
<synopsis>
Reads or sets counters for MiniVoicemail message.
</synopsis>
</see-also>
</function>
<function name="MINIVMACCOUNT" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.0</version>
+ </since>
<synopsis>
Gets MiniVoicemail account information.
</synopsis>
</function>
<managerEvent language="en_US" name="MiniVoiceMail">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a notification is sent out by a MiniVoiceMail application</synopsis>
<syntax>
<channel_snapshot/>
/*** DOCUMENTATION
<application name="MixMonitor" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Record a call and mix the audio during the recording. Use of StopMixMonitor is required
to guarantee the audio file is available for processing during dialplan execution.
</see-also>
</application>
<application name="StopMixMonitor" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.4.0</version>
+ </since>
<synopsis>
Stop recording a call through MixMonitor, and free the recording's file handle.
</synopsis>
</description>
</manager>
<function name="MIXMONITOR" language="en_US">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>
Retrieve data pertaining to specific instances of MixMonitor on a channel.
</synopsis>
</function>
<managerEvent language="en_US" name="MixMonitorStart">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>16.17.0</version><version>18.3.0</version></since>
+ <since>
+ <version>16.17.0</version>
+ <version>18.3.0</version>
+ </since>
<synopsis>Raised when monitoring has started on a channel.</synopsis>
<syntax>
<channel_snapshot/>
</managerEvent>
<managerEvent language="en_US" name="MixMonitorStop">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>16.17.0</version><version>18.3.0</version></since>
+ <since>
+ <version>16.17.0</version>
+ <version>18.3.0</version>
+ </since>
<synopsis>Raised when monitoring has stopped on a channel.</synopsis>
<syntax>
<channel_snapshot/>
</managerEvent>
<managerEvent language="en_US" name="MixMonitorMute">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>16.17.0</version><version>18.3.0</version></since>
+ <since>
+ <version>16.17.0</version>
+ <version>18.3.0</version>
+ </since>
<synopsis>Raised when monitoring is muted or unmuted on a channel.</synopsis>
<syntax>
<channel_snapshot/>
/*** DOCUMENTATION
<application name="Morsecode" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.4.0</version>
+ </since>
<synopsis>
Plays morse code.
</synopsis>
/*** DOCUMENTATION
<application name="MP3Player" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>0.1.0</version>
+ </since>
<synopsis>
Play an MP3 file or M3U playlist file or stream.
</synopsis>
/*** DOCUMENTATION
<application name="Originate" language="en_US">
- <since><version>1.6.1.0</version></since>
+ <since>
+ <version>1.6.1.0</version>
+ </since>
<synopsis>
Originate a call.
</synopsis>
/*** DOCUMENTATION
<application name="Page" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Page series of phones
</synopsis>
/*** DOCUMENTATION
<application name="Playback" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>0.1.0</version>
+ </since>
<synopsis>
Play a file.
</synopsis>
/*** DOCUMENTATION
<application name="PlayTones" language="en_US">
- <since><version>1.6.1.0</version></since>
+ <since>
+ <version>1.6.1.0</version>
+ </since>
<synopsis>
Play a tone list.
</synopsis>
</see-also>
</application>
<application name="StopPlayTones" language="en_US">
- <since><version>1.6.1.0</version></since>
+ <since>
+ <version>1.6.1.0</version>
+ </since>
<synopsis>
Stop playing a tone list.
</synopsis>
/*** DOCUMENTATION
<application name="PrivacyManager" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>0.4.0</version>
+ </since>
<synopsis>
Require phone number to be entered, if no CallerID sent
</synopsis>
/*** DOCUMENTATION
<application name="Queue" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>0.2.0</version>
+ </since>
<synopsis>
Queue a call for a call queue.
</synopsis>
</see-also>
</application>
<application name="AddQueueMember" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>0.5.0</version>
+ </since>
<synopsis>
Dynamically adds queue members.
</synopsis>
</see-also>
</application>
<application name="RemoveQueueMember" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>0.5.0</version>
+ </since>
<synopsis>
Dynamically removes queue members.
</synopsis>
</see-also>
</application>
<application name="PauseQueueMember" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Pauses a queue member.
</synopsis>
</see-also>
</application>
<application name="UnpauseQueueMember" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Unpauses a queue member.
</synopsis>
</see-also>
</application>
<application name="QueueLog" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.4.0</version>
+ </since>
<synopsis>
Writes to the queue_log file.
</synopsis>
</see-also>
</application>
<application name="QueueUpdate" language="en_US">
- <since><version>15.0.0</version></since>
+ <since>
+ <version>15.0.0</version>
+ </since>
<synopsis>
Writes to the queue_log file for outbound calls and updates Realtime Data.
Is used at h extension to be able to have all the parameters.
</description>
</application>
<function name="QUEUE_VARIABLES" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.0</version>
+ </since>
<synopsis>
Return Queue information in variables.
</synopsis>
</see-also>
</function>
<function name="QUEUE_MEMBER" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.0</version>
+ </since>
<synopsis>
Provides a count of queue members based on the provided criteria, or updates a
queue member's settings.
</see-also>
</function>
<function name="QUEUE_MEMBER_COUNT" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.4.0</version>
+ </since>
<synopsis>
Count number of members answering a queue.
</synopsis>
</see-also>
</function>
<function name="QUEUE_EXISTS" language="en_US">
- <since><version>1.8.0</version></since>
+ <since>
+ <version>1.8.0</version>
+ </since>
<synopsis>
Check if a named queue exists on this server
</synopsis>
</see-also>
</function>
<function name="QUEUE_GET_CHANNEL" language="en_US">
- <since><version>14.0.0</version></since>
+ <since>
+ <version>14.0.0</version>
+ </since>
<synopsis>
Return caller at the specified position in a queue.
</synopsis>
</see-also>
</function>
<function name="QUEUE_WAITING_COUNT" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.4.0</version>
+ </since>
<synopsis>
Count number of calls currently waiting in a queue.
</synopsis>
</see-also>
</function>
<function name="QUEUE_MEMBER_LIST" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.4.0</version>
+ </since>
<synopsis>
Returns a list of interfaces on a queue.
</synopsis>
</see-also>
</function>
<function name="QUEUE_MEMBER_PENALTY" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.0</version>
+ </since>
<synopsis>
Gets or sets queue members penalty.
</synopsis>
<managerEvent language="en_US" name="QueueParams">
<managerEventInstance class="EVENT_FLAG_AGENT">
- <since><version>16.24.0</version><version>18.10.0</version><version>19.2.0</version></since>
+ <since>
+ <version>16.24.0</version>
+ <version>18.10.0</version>
+ <version>19.2.0</version>
+ </since>
<synopsis>Raised in response to the QueueStatus action.</synopsis>
<syntax>
<parameter name="Max">
</managerEvent>
<managerEvent language="en_US" name="QueueEntry">
<managerEventInstance class="EVENT_FLAG_AGENT">
- <since><version>16.24.0</version><version>18.10.0</version><version>19.2.0</version></since>
+ <since>
+ <version>16.24.0</version>
+ <version>18.10.0</version>
+ <version>19.2.0</version>
+ </since>
<synopsis>Raised in response to the QueueStatus action.</synopsis>
<syntax>
<parameter name="Queue">
</managerEvent>
<managerEvent language="en_US" name="QueueMemberStatus">
<managerEventInstance class="EVENT_FLAG_AGENT">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a Queue member's status has changed.</synopsis>
<syntax>
<parameter name="Queue">
</managerEvent>
<managerEvent language="en_US" name="QueueMemberAdded">
<managerEventInstance class="EVENT_FLAG_AGENT">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a member is added to the queue.</synopsis>
<syntax>
<xi:include xpointer="xpointer(/docs/managerEvent[@name='QueueMemberStatus']/managerEventInstance/syntax/parameter)" />
</managerEvent>
<managerEvent language="en_US" name="QueueMemberRemoved">
<managerEventInstance class="EVENT_FLAG_AGENT">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a member is removed from the queue.</synopsis>
<syntax>
<xi:include xpointer="xpointer(/docs/managerEvent[@name='QueueMemberStatus']/managerEventInstance/syntax/parameter)" />
</managerEvent>
<managerEvent language="en_US" name="QueueMemberPause">
<managerEventInstance class="EVENT_FLAG_AGENT">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>Raised when a member is paused/unpaused in the queue.</synopsis>
<syntax>
<xi:include xpointer="xpointer(/docs/managerEvent[@name='QueueMemberStatus']/managerEventInstance/syntax/parameter)" />
</managerEvent>
<managerEvent language="en_US" name="QueueMemberPenalty">
<managerEventInstance class="EVENT_FLAG_AGENT">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a member's penalty is changed.</synopsis>
<syntax>
<xi:include xpointer="xpointer(/docs/managerEvent[@name='QueueMemberStatus']/managerEventInstance/syntax/parameter)" />
</managerEvent>
<managerEvent language="en_US" name="QueueMemberRinginuse">
<managerEventInstance class="EVENT_FLAG_AGENT">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a member's ringinuse setting is changed.</synopsis>
<syntax>
<xi:include xpointer="xpointer(/docs/managerEvent[@name='QueueMemberStatus']/managerEventInstance/syntax/parameter)" />
</managerEvent>
<managerEvent language="en_US" name="QueueCallerJoin">
<managerEventInstance class="EVENT_FLAG_AGENT">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a caller joins a Queue.</synopsis>
<syntax>
<channel_snapshot/>
</managerEvent>
<managerEvent language="en_US" name="QueueCallerLeave">
<managerEventInstance class="EVENT_FLAG_AGENT">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a caller leaves a Queue.</synopsis>
<syntax>
<channel_snapshot/>
</managerEvent>
<managerEvent language="en_US" name="QueueCallerAbandon">
<managerEventInstance class="EVENT_FLAG_AGENT">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a caller abandons the queue.</synopsis>
<syntax>
<channel_snapshot/>
</managerEvent>
<managerEvent language="en_US" name="AgentCalled">
<managerEventInstance class="EVENT_FLAG_AGENT">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when an queue member is notified of a caller in the queue.</synopsis>
<syntax>
<channel_snapshot/>
</managerEvent>
<managerEvent language="en_US" name="AgentRingNoAnswer">
<managerEventInstance class="EVENT_FLAG_AGENT">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a queue member is notified of a caller in the queue and fails to answer.</synopsis>
<syntax>
<channel_snapshot/>
</managerEvent>
<managerEvent language="en_US" name="AgentComplete">
<managerEventInstance class="EVENT_FLAG_AGENT">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a queue member has finished servicing a caller in the queue.</synopsis>
<syntax>
<channel_snapshot/>
</managerEvent>
<managerEvent language="en_US" name="AgentDump">
<managerEventInstance class="EVENT_FLAG_AGENT">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a queue member hangs up on a caller in the queue.</synopsis>
<syntax>
<channel_snapshot/>
</managerEvent>
<managerEvent language="en_US" name="AgentConnect">
<managerEventInstance class="EVENT_FLAG_AGENT">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a queue member answers and is bridged to a caller in the queue.</synopsis>
<syntax>
<channel_snapshot/>
/*** DOCUMENTATION
<application name="Read" language="en_US">
- <since><version>1.6.1.0</version></since>
+ <since>
+ <version>1.6.1.0</version>
+ </since>
<synopsis>
Read a variable.
</synopsis>
/*** DOCUMENTATION
<application name="ReadExten" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.0</version>
+ </since>
<synopsis>
Read an extension into a variable.
</synopsis>
/*** DOCUMENTATION
<application name="Record" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>0.1.8</version>
+ </since>
<synopsis>
Record to a file.
</synopsis>
/*** DOCUMENTATION
<application name="SayCountedNoun" language="en_US">
- <since><version>1.8.0</version></since>
+ <since>
+ <version>1.8.0</version>
+ </since>
<synopsis>
Say a noun in declined form in order to count things
</synopsis>
</see-also>
</application>
<application name="SayCountedAdj" language="en_US">
- <since><version>1.8.0</version></since>
+ <since>
+ <version>1.8.0</version>
+ </since>
<synopsis>
Say a adjective in declined form in order to count things
</synopsis>
/*** DOCUMENTATION
<application name="SayUnixTime" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>0.7.0</version>
+ </since>
<synopsis>
Says a specified time in a custom format.
</synopsis>
</see-also>
</application>
<application name="DateTime" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>0.2.0</version>
+ </since>
<synopsis>
Says a specified time in a custom format.
</synopsis>
/*** DOCUMENTATION
<application name="SendDTMF" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>0.3.0</version>
+ </since>
<synopsis>
Sends arbitrary DTMF digits
</synopsis>
/*** DOCUMENTATION
<application name="SendText" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.0.0</version>
+ </since>
<synopsis>
Send a Text Message on a channel.
</synopsis>
/*** DOCUMENTATION
<application name="Signal" language="en_US">
- <since><version>18.17.0</version><version>20.2.0</version></since>
+ <since>
+ <version>18.17.0</version>
+ <version>20.2.0</version>
+ </since>
<synopsis>
Sends a signal to any waiting channels.
</synopsis>
</see-also>
</application>
<application name="WaitForSignal" language="en_US">
- <since><version>18.17.0</version><version>20.2.0</version></since>
+ <since>
+ <version>18.17.0</version>
+ <version>20.2.0</version>
+ </since>
<synopsis>
Waits for a named signal on a channel.
</synopsis>
/*** DOCUMENTATION
<application name="SkelGuessNumber" language="en_US">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>
An example number guessing game
</synopsis>
<configInfo name="app_skel" language="en_US">
<configFile name="app_skel.conf">
<configObject name="globals">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Options that apply globally to app_skel</synopsis>
<configOption name="games">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>The number of games a single execution of SkelGuessNumber will play</synopsis>
</configOption>
<configOption name="cheat">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Should the computer cheat?</synopsis>
<description><para>If enabled, the computer will ignore winning guesses.</para></description>
</configOption>
</configObject>
<configObject name="sounds">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Prompts for SkelGuessNumber to play</synopsis>
<configOption name="prompt" default="please-enter-your&number&queue-less-than">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>A prompt directing the user to enter a number less than the max number</synopsis>
</configOption>
<configOption name="wrong_guess" default="vm-pls-try-again">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>The sound file to play when a wrong guess is made</synopsis>
</configOption>
<configOption name="right_guess" default="auth-thankyou">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>The sound file to play when a correct guess is made</synopsis>
</configOption>
<configOption name="too_low">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>The sound file to play when a guess is too low</synopsis>
</configOption>
<configOption name="too_high">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>The sound file to play when a guess is too high</synopsis>
</configOption>
<configOption name="lose" default="vm-goodbye">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>The sound file to play when a player loses</synopsis>
</configOption>
</configObject>
<configObject name="level">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Defined levels for the SkelGuessNumber game</synopsis>
<configOption name="max_number">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>The maximum in the range of numbers to guess (1 is the implied minimum)</synopsis>
</configOption>
<configOption name="max_guesses">
- <since><version>11.22.0</version><version>13.9.0</version></since>
+ <since>
+ <version>11.22.0</version>
+ <version>13.9.0</version>
+ </since>
<synopsis>The maximum number of guesses before a game is considered lost</synopsis>
</configOption>
</configObject>
/*** DOCUMENTATION
<application name="SLAStation" language="en_US">
- <since><version>21.0.0</version></since>
+ <since>
+ <version>21.0.0</version>
+ </since>
<synopsis>
Shared Line Appearance Station.
</synopsis>
</description>
</application>
<application name="SLATrunk" language="en_US">
- <since><version>21.0.0</version></since>
+ <since>
+ <version>21.0.0</version>
+ </since>
<synopsis>
Shared Line Appearance Trunk.
</synopsis>
/*** DOCUMENTATION
<application name="SMS" language="en_US">
- <since><version>1.6.1.0</version></since>
+ <since>
+ <version>1.6.1.0</version>
+ </since>
<synopsis>
Communicates with SMS service centres and SMS capable analogue phones.
</synopsis>
/*** DOCUMENTATION
<application name="SoftHangup" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>0.4.0</version>
+ </since>
<synopsis>
Hangs up the requested channel.
</synopsis>
/*** DOCUMENTATION
<application name="SpeechCreate" language="en_US">
- <since><version>1.6.1.0</version></since>
+ <since>
+ <version>1.6.1.0</version>
+ </since>
<synopsis>
Create a Speech Structure.
</synopsis>
</description>
</application>
<application name="SpeechActivateGrammar" language="en_US">
- <since><version>1.6.1.0</version></since>
+ <since>
+ <version>1.6.1.0</version>
+ </since>
<synopsis>
Activate a grammar.
</synopsis>
</description>
</application>
<application name="SpeechStart" language="en_US">
- <since><version>1.6.1.0</version></since>
+ <since>
+ <version>1.6.1.0</version>
+ </since>
<synopsis>
Start recognizing voice in the audio stream.
</synopsis>
</description>
</application>
<application name="SpeechBackground" language="en_US">
- <since><version>1.6.1.0</version></since>
+ <since>
+ <version>1.6.1.0</version>
+ </since>
<synopsis>
Play a sound file and wait for speech to be recognized.
</synopsis>
</description>
</application>
<application name="SpeechDeactivateGrammar" language="en_US">
- <since><version>1.6.1.0</version></since>
+ <since>
+ <version>1.6.1.0</version>
+ </since>
<synopsis>
Deactivate a grammar.
</synopsis>
</description>
</application>
<application name="SpeechProcessingSound" language="en_US">
- <since><version>1.6.1.0</version></since>
+ <since>
+ <version>1.6.1.0</version>
+ </since>
<synopsis>
Change background processing sound.
</synopsis>
</description>
</application>
<application name="SpeechDestroy" language="en_US">
- <since><version>1.6.1.0</version></since>
+ <since>
+ <version>1.6.1.0</version>
+ </since>
<synopsis>
End speech recognition.
</synopsis>
</description>
</application>
<application name="SpeechLoadGrammar" language="en_US">
- <since><version>1.6.1.0</version></since>
+ <since>
+ <version>1.6.1.0</version>
+ </since>
<synopsis>
Load a grammar.
</synopsis>
</description>
</application>
<application name="SpeechUnloadGrammar" language="en_US">
- <since><version>1.6.1.0</version></since>
+ <since>
+ <version>1.6.1.0</version>
+ </since>
<synopsis>
Unload a grammar.
</synopsis>
</description>
</application>
<function name="SPEECH_SCORE" language="en_US">
- <since><version>1.6.1.0</version></since>
+ <since>
+ <version>1.6.1.0</version>
+ </since>
<synopsis>
Gets the confidence score of a result.
</synopsis>
</description>
</function>
<function name="SPEECH_TEXT" language="en_US">
- <since><version>1.6.1.0</version></since>
+ <since>
+ <version>1.6.1.0</version>
+ </since>
<synopsis>
Gets the recognized text of a result.
</synopsis>
</description>
</function>
<function name="SPEECH_GRAMMAR" language="en_US">
- <since><version>1.6.1.0</version></since>
+ <since>
+ <version>1.6.1.0</version>
+ </since>
<synopsis>
Gets the matched grammar of a result if available.
</synopsis>
</description>
</function>
<function name="SPEECH_ENGINE" language="en_US">
- <since><version>1.6.1.0</version></since>
+ <since>
+ <version>1.6.1.0</version>
+ </since>
<synopsis>
Get or change a speech engine specific attribute.
</synopsis>
</description>
</function>
<function name="SPEECH_RESULTS_TYPE" language="en_US">
- <since><version>1.6.1.0</version></since>
+ <since>
+ <version>1.6.1.0</version>
+ </since>
<synopsis>
Sets the type of results that will be returned.
</synopsis>
</description>
</function>
<function name="SPEECH" language="en_US">
- <since><version>1.6.1.0</version></since>
+ <since>
+ <version>1.6.1.0</version>
+ </since>
<synopsis>
Gets information about speech recognition results.
</synopsis>
/*** DOCUMENTATION
<application name="Gosub" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Jump to label, saving return address.
</synopsis>
</see-also>
</application>
<application name="GosubIf" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Conditionally jump to label, saving return address.
</synopsis>
</see-also>
</application>
<application name="Return" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Return from gosub routine.
</synopsis>
</see-also>
</application>
<application name="StackPop" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Remove one address from gosub stack.
</synopsis>
</see-also>
</application>
<function name="LOCAL" language="en_US">
- <since><version>1.6.1.0</version></since>
+ <since>
+ <version>1.6.1.0</version>
+ </since>
<synopsis>
Manage variables local to the gosub stack frame.
</synopsis>
</see-also>
</function>
<function name="LOCAL_PEEK" language="en_US">
- <since><version>1.6.1.0</version></since>
+ <since>
+ <version>1.6.1.0</version>
+ </since>
<synopsis>
Retrieve variables hidden by the local gosub stack frame.
</synopsis>
</see-also>
</function>
<function name="STACK_PEEK" language="en_US">
- <since><version>1.8.11.0</version><version>10.3.0</version></since>
+ <since>
+ <version>1.8.11.0</version>
+ <version>10.3.0</version>
+ </since>
<synopsis>
View info about the location which called Gosub
</synopsis>
</agi>
<managerEvent language="en_US" name="VarSet">
<managerEventInstance class="EVENT_FLAG_DIALPLAN">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a variable local to the gosub stack frame is set due to a subroutine call.</synopsis>
<syntax>
<channel_snapshot/>
/*** DOCUMENTATION
<application name="Stasis" language="en_US">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Invoke an external Stasis application.</synopsis>
<syntax>
<parameter name="app_name" required="true">
/*** DOCUMENTATION
<application name="StatsD" language="en_US">
- <since><version>13.20.0</version><version>15.3.0</version></since>
+ <since>
+ <version>13.20.0</version>
+ <version>15.3.0</version>
+ </since>
<synopsis>
Allow statistics to be passed to the StatsD server from the dialplan.
</synopsis>
/*** DOCUMENTATION
<application name="StreamEcho" language="en_US">
- <since><version>15.0.0</version></since>
+ <since>
+ <version>15.0.0</version>
+ </since>
<synopsis>
Echo media, up to 'N' streams of a type, and DTMF back to the calling party
</synopsis>
/*** DOCUMENTATION
<application name="System" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>0.1.2</version>
+ </since>
<synopsis>
Execute a system command.
</synopsis>
</description>
</application>
<application name="TrySystem" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.0.0</version>
+ </since>
<synopsis>
Try executing a system command.
</synopsis>
/*** DOCUMENTATION
<application name="BackgroundDetect" language="en_US">
- <since><version>1.6.1.0</version></since>
+ <since>
+ <version>1.6.1.0</version>
+ </since>
<synopsis>
Background a file with talk detect.
</synopsis>
/*** DOCUMENTATION
<application name="TestServer" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.0.0</version>
+ </since>
<synopsis>
Execute Interface Test Server.
</synopsis>
</see-also>
</application>
<application name="TestClient" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.0.0</version>
+ </since>
<synopsis>
Execute Interface Test Client.
</synopsis>
/*** DOCUMENTATION
<application name="Transfer" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>0.5.0</version>
+ </since>
<synopsis>
Transfer caller to remote extension.
</synopsis>
/*** DOCUMENTATION
<application name="UserEvent" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.0.0</version>
+ </since>
<synopsis>
Send an arbitrary user-defined event to parties interested in a channel (AMI users and relevant res_stasis applications).
</synopsis>
/*** DOCUMENTATION
<application name="Verbose" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.0.0</version>
+ </since>
<synopsis>
Send arbitrary text to verbose output.
</synopsis>
</description>
</application>
<application name="Log" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.4.0</version>
+ </since>
<synopsis>
Send arbitrary text to a selected log level.
</synopsis>
/*** DOCUMENTATION
<application name="VoiceMail" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>0.1.0</version>
+ </since>
<synopsis>
Leave a Voicemail message.
</synopsis>
</see-also>
</application>
<application name="VoiceMailMain" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>0.1.0</version>
+ </since>
<synopsis>
Check Voicemail messages.
</synopsis>
</see-also>
</application>
<application name="VMAuthenticate" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Authenticate with Voicemail passwords.
</synopsis>
</description>
</application>
<application name="VoiceMailPlayMsg" language="en_US">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>
Play a single voice mail msg from a mailbox by msg id.
</synopsis>
</description>
</application>
<application name="VMSayName" language="en_US">
- <since><version>1.8.0</version></since>
+ <since>
+ <version>1.8.0</version>
+ </since>
<synopsis>
Play the name of a voicemail user
</synopsis>
</description>
</application>
<function name="VM_INFO" language="en_US">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>
Returns the selected attribute from a mailbox.
</synopsis>
</manager>
<managerEvent language="en_US" name="VoicemailPasswordChange">
<managerEventInstance class="EVENT_FLAG_USER">
- <since><version>18.21.0</version><version>20.6.0</version><version>21.1.0</version></since>
+ <since>
+ <version>18.21.0</version>
+ <version>20.6.0</version>
+ <version>21.1.0</version>
+ </since>
<synopsis>Raised in response to a mailbox password change.</synopsis>
<syntax>
<parameter name="Context">
/*** DOCUMENTATION
<application name="WaitForRing" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>0.4.0</version>
+ </since>
<synopsis>
Wait for Ring Application.
</synopsis>
/*** DOCUMENTATION
<application name="WaitForSilence" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Waits for a specified amount of silence.
</synopsis>
</see-also>
</application>
<application name="WaitForNoise" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.1.0</version>
+ </since>
<synopsis>
Waits for a specified amount of noise.
</synopsis>
/*** DOCUMENTATION
<application name="WaitUntil" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.0</version>
+ </since>
<synopsis>
Wait (sleep) until the current time is the given epoch.
</synopsis>
/*** DOCUMENTATION
<application name="While" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Start a while loop.
</synopsis>
</see-also>
</application>
<application name="EndWhile" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
End a while loop.
</synopsis>
</see-also>
</application>
<application name="ExitWhile" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.4.0</version>
+ </since>
<synopsis>
End a While loop.
</synopsis>
</see-also>
</application>
<application name="ContinueWhile" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.4.0</version>
+ </since>
<synopsis>
Restart a While loop.
</synopsis>
/*** DOCUMENTATION
<application name="Zapateller" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>0.1.12</version>
+ </since>
<synopsis>
Block telemarketers with SIT.
</synopsis>
<synopsis>Unused, but reserved.</synopsis>
</configObject>
<configObject name="user_profile">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>A named profile to apply to specific callers.</synopsis>
<description><para>Callers in a ConfBridge have a profile associated with them
that determine their options. A configuration section is determined to be a
of <literal>user</literal>.
</para></description>
<configOption name="type">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Define this configuration category as a user profile.</synopsis>
<description><para>The type parameter determines how a context in the
configuration file is interpreted.</para>
</description>
</configOption>
<configOption name="admin">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Sets if the user is an admin or not</synopsis>
</configOption>
<configOption name="send_events" default="no">
- <since><version>15.5.0</version></since>
+ <since>
+ <version>15.5.0</version>
+ </since>
<synopsis>Sets if events are send to the user</synopsis>
<description><para>If events are enabled for this bridge and this option is
set, users will receive events like join, leave, talking, etc. via text
interface.</para></description>
</configOption>
<configOption name="echo_events" default="yes">
- <since><version>15.5.0</version></since>
+ <since>
+ <version>15.5.0</version>
+ </since>
<synopsis>Sets if events are echoed back to the user that
triggered them</synopsis>
<description><para>If events are enabled for this user and this option
</para></description>
</configOption>
<configOption name="marked">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Sets if this is a marked user or not</synopsis>
</configOption>
<configOption name="startmuted">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Sets if all users should start out muted</synopsis>
</configOption>
<configOption name="music_on_hold_when_empty">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Play MOH when user is alone or waiting on a marked user</synopsis>
</configOption>
<configOption name="quiet">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Silence enter/leave prompts and user intros for this user</synopsis>
</configOption>
<configOption name="hear_own_join_sound">
- <since><version>16.26.0</version><version>18.12.0</version><version>19.4.0</version></since>
+ <since>
+ <version>16.26.0</version>
+ <version>18.12.0</version>
+ <version>19.4.0</version>
+ </since>
<synopsis>Determines if the user also hears the join sound when they enter a conference</synopsis>
</configOption>
<configOption name="announce_user_count">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Sets if the number of users should be announced to the user</synopsis>
</configOption>
<configOption name="announce_user_count_all">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Announce user count to all the other users when this user joins</synopsis>
<description><para>Sets if the number of users should be announced to all the other users
in the conference when this user joins. This option can be either set to 'yes' or
</para></description>
</configOption>
<configOption name="announce_only_user">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Announce to a user when they join an empty conference</synopsis>
</configOption>
<configOption name="wait_marked">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Sets if the user must wait for a marked user to enter before joining a conference</synopsis>
</configOption>
<configOption name="end_marked">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Kick the user from the conference when the last marked user leaves</synopsis>
</configOption>
<configOption name="end_marked_any">
- <since><version>16.29.0</version><version>18.15.0</version><version>19.7.0</version></since>
+ <since>
+ <version>16.29.0</version>
+ <version>18.15.0</version>
+ <version>19.7.0</version>
+ </since>
<synopsis>Kick the user from the conference when any marked user leaves</synopsis>
</configOption>
<configOption name="talk_detection_events">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Set whether or not notifications of when a user begins and ends talking should be sent out as events over AMI</synopsis>
</configOption>
<configOption name="dtmf_passthrough">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Sets whether or not DTMF should pass through the conference</synopsis>
</configOption>
<configOption name="announce_join_leave">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Prompt user for their name when joining a conference and play it to the conference when they enter</synopsis>
</configOption>
<configOption name="announce_join_leave_review">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>Prompt user for their name when joining a conference and play it to the conference when they enter.
The user will be asked to review the recording of their name before entering the conference.</synopsis>
</configOption>
<configOption name="pin">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Sets a PIN the user must enter before joining the conference</synopsis>
</configOption>
<configOption name="music_on_hold_class">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>The MOH class to use for this user</synopsis>
</configOption>
<configOption name="announcement">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Sound file to play to the user when they join a conference</synopsis>
</configOption>
<configOption name="denoise">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Apply a denoise filter to the audio before mixing</synopsis>
<description><para>Sets whether or not a denoise filter should be applied
to the audio before mixing or not. Off by default. Requires
</para></description>
</configOption>
<configOption name="dsp_drop_silence">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Drop what Asterisk detects as silence from audio sent to the bridge</synopsis>
<description><para>
This option drops what Asterisk detects as silence from
</para></description>
</configOption>
<configOption name="dsp_silence_threshold">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>The number of milliseconds of silence necessary to declare talking stopped.</synopsis>
<description>
<para>The time in milliseconds of sound falling below the
</description>
</configOption>
<configOption name="dsp_talking_threshold">
- <since><version>11.10.0</version><version>12.3.0</version></since>
+ <since>
+ <version>11.10.0</version>
+ <version>12.3.0</version>
+ </since>
<synopsis>Average magnitude threshold to determine talking.</synopsis>
<description>
<para>The minimum average magnitude per sample in a frame
</description>
</configOption>
<configOption name="jitterbuffer">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Place a jitter buffer on the user's audio stream before audio mixing is performed</synopsis>
<description><para>
Enabling this option places a jitterbuffer on the user's audio stream
</para></description>
</configOption>
<configOption name="template">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>When using the CONFBRIDGE dialplan function, use a user profile as a template for creating a new temporary profile</synopsis>
</configOption>
<configOption name="timeout">
- <since><version>13.7.0</version></since>
+ <since>
+ <version>13.7.0</version>
+ </since>
<synopsis>Kick the user out of the conference after this many seconds. 0 means there is no timeout for the user.</synopsis>
</configOption>
<configOption name="text_messaging" default="yes">
- <since><version>16.10.0</version><version>17.4.0</version></since>
+ <since>
+ <version>16.10.0</version>
+ <version>17.4.0</version>
+ </since>
<synopsis>Sets if text messages are sent to the user.</synopsis>
<description><para>If text messaging is enabled for this user then
text messages will be sent to it. These may be events or from other
messages are sent to the user.</para></description>
</configOption>
<configOption name="answer_channel" default="yes">
- <since><version>16.19.0</version><version>18.5.0</version></since>
+ <since>
+ <version>16.19.0</version>
+ <version>18.5.0</version>
+ </since>
<synopsis>Sets if a user's channel should be answered if currently unanswered.</synopsis>
</configOption>
</configObject>
<configObject name="bridge_profile">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>A named profile to apply to specific bridges.</synopsis>
<description><para>ConfBridge bridges have a profile associated with them
that determine their options. A configuration section is determined to be a
of <literal>bridge</literal>.
</para></description>
<configOption name="type">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Define this configuration category as a bridge profile</synopsis>
<description><para>The type parameter determines how a context in the
configuration file is interpreted.</para>
</description>
</configOption>
<configOption name="jitterbuffer">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Place a jitter buffer on the conference's audio stream</synopsis>
</configOption>
<configOption name="internal_sample_rate">
- <since><version>18.22.0</version><version>20.7.0</version><version>21.2.0</version></since>
+ <since>
+ <version>18.22.0</version>
+ <version>20.7.0</version>
+ <version>21.2.0</version>
+ </since>
<synopsis>Set the internal native sample rate for mixing the conference</synopsis>
<description><para>
Sets the internal native sample rate the
</para></description>
</configOption>
<configOption name="maximum_sample_rate">
- <since><version>18.22.0</version><version>20.7.0</version><version>21.2.0</version></since>
+ <since>
+ <version>18.22.0</version>
+ <version>20.7.0</version>
+ <version>21.2.0</version>
+ </since>
<synopsis>Set the maximum native sample rate for mixing the conference</synopsis>
<description><para>
Sets the maximum native sample rate the
</para></description>
</configOption>
<configOption name="language" default="en">
- <since><version>11.7.0</version></since>
+ <since>
+ <version>11.7.0</version>
+ </since>
<synopsis>The language used for announcements to the conference.</synopsis>
<description><para>
By default, announcements to a conference use English. Which means
</para></description>
</configOption>
<configOption name="mixing_interval">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Sets the internal mixing interval in milliseconds for the bridge</synopsis>
<description><para>
Sets the internal mixing interval in milliseconds for the bridge. This
</para></description>
</configOption>
<configOption name="binaural_active">
- <since><version>15.0.0</version></since>
+ <since>
+ <version>15.0.0</version>
+ </since>
<synopsis>If true binaural conferencing with stereo audio is active</synopsis>
<description><para>
Activates binaural mixing for a conference bridge.
</para></description>
</configOption>
<configOption name="record_conference">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Record the conference starting with the first active user's entrance and ending with the last active user's exit</synopsis>
<description><para>
Records the conference call starting when the first user
</para></description>
</configOption>
<configOption name="record_file" default="confbridge-${name of conference bridge}-${start time}.wav">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>The filename of the conference recording</synopsis>
<description><para>
When <replaceable>record_conference</replaceable> is set to yes, the specific name of the
</para></description>
</configOption>
<configOption name="record_file_append" default="yes">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Append to record file when starting/stopping on same conference recording</synopsis>
<description><para>
When <replaceable>record_file_append</replaceable> is set to yes, stopping and starting recording on a
</para></description>
</configOption>
<configOption name="record_file_timestamp" default="yes">
- <since><version>14.0.0</version></since>
+ <since>
+ <version>14.0.0</version>
+ </since>
<synopsis>Append the start time to the record_file name so that it is unique.</synopsis>
<description><para>
When <replaceable>record_file_timestamp</replaceable> is set to yes, the start time is appended to
</para></description>
</configOption>
<configOption name="record_options" default="">
- <since><version>14.0.0</version></since>
+ <since>
+ <version>14.0.0</version>
+ </since>
<synopsis>Pass additional options to MixMonitor when recording</synopsis>
<description><para>
Pass additional options to MixMonitor when <replaceable>record_conference</replaceable> is set to yes.
</para></description>
</configOption>
<configOption name="record_command" default="">
- <since><version>14.0.0</version></since>
+ <since>
+ <version>14.0.0</version>
+ </since>
<synopsis>Execute a command after recording ends</synopsis>
<description><para>
Executes the specified command when recording ends. Any strings matching <literal>^{X}</literal> will be
</para></description>
</configOption>
<configOption name="regcontext">
- <since><version>13.10.0</version></since>
+ <since>
+ <version>13.10.0</version>
+ </since>
<synopsis>The name of the context into which to register the name of the conference bridge as NoOP() at priority 1</synopsis>
<description><para>
When set this will cause the name of the created conference to be registered
</para></description>
</configOption>
<configOption name="video_mode">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Sets how confbridge handles video distribution to the conference participants</synopsis>
<description><para>
Sets how confbridge handles video distribution to the conference participants.
</description>
</configOption>
<configOption name="max_members">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Limit the maximum number of participants for a single conference</synopsis>
<description><para>
This option limits the number of participants for a single
</para></description>
</configOption>
<configOption name="sound_">
- <since><version>13.19.0</version><version>15.2.0</version></since>
+ <since>
+ <version>13.19.0</version>
+ <version>15.2.0</version>
+ </since>
<synopsis>Override the various conference bridge sound files</synopsis>
<description><para>
All sounds in the conference are customizable using the bridge profile options below.
</description>
</configOption>
<configOption name="video_update_discard" default="2000">
- <since><version>15.0.0</version></since>
+ <since>
+ <version>15.0.0</version>
+ </since>
<synopsis>Sets the amount of time in milliseconds after sending a video update to discard subsequent video updates</synopsis>
<description><para>
Sets the amount of time in milliseconds after sending a video update request
</para></description>
</configOption>
<configOption name="remb_send_interval" default="0">
- <since><version>15.4.0</version></since>
+ <since>
+ <version>15.4.0</version>
+ </since>
<synopsis>Sets the interval in milliseconds that a combined REMB frame will be sent to video sources</synopsis>
<description><para>
Sets the interval in milliseconds that a combined REMB frame will be sent
</para></description>
</configOption>
<configOption name="remb_behavior" default="average">
- <since><version>15.4.0</version></since>
+ <since>
+ <version>15.4.0</version>
+ </since>
<synopsis>Sets how REMB reports are generated from multiple sources</synopsis>
<description><para>
Sets how REMB reports are combined from multiple sources to form one. A REMB report
<see-also><ref type="configOption">remb_estimated_bitrate</ref></see-also>
</configOption>
<configOption name="remb_estimated_bitrate">
- <since><version>16.15.0</version><version>17.9.0</version><version>18.1.0</version></since>
+ <since>
+ <version>16.15.0</version>
+ <version>17.9.0</version>
+ <version>18.1.0</version>
+ </since>
<synopsis>Sets the estimated bitrate sent to each participant in REMB reports</synopsis>
<description><para>
When <literal>remb_behavior</literal> is set to <literal>force</literal>,
<see-also><ref type="configOption">remb_behavior</ref></see-also>
</configOption>
<configOption name="enable_events" default="no">
- <since><version>15.5.0</version></since>
+ <since>
+ <version>15.5.0</version>
+ </since>
<synopsis>Enables events for this bridge</synopsis>
<description><para>
If enabled, recipients who joined the bridge via a channel driver
</description>
</configOption>
<configOption name="template">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>When using the CONFBRIDGE dialplan function, use a bridge profile as a template for creating a new temporary profile</synopsis>
</configOption>
</configObject>
<configObject name="menu">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>A conference user menu</synopsis>
<description>
<para>Conference users, as defined by a <replaceable>conf_user</replaceable>,
<literal>ConfBridge</literal> application.</para>
</description>
<configOption name="type">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Define this configuration category as a menu</synopsis>
<description><para>The type parameter determines how a context in the
configuration file is interpreted.</para>
</description>
</configOption>
<configOption name="template">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>When using the CONFBRIDGE dialplan function, use a menu profile as a template for creating a new temporary profile</synopsis>
</configOption>
<configOption name="^[0-9A-D*#]+$">
/*** DOCUMENTATION
<managerEvent language="en_US" name="ConfbridgeStart">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a conference starts.</synopsis>
<syntax>
<parameter name="Conference">
</managerEvent>
<managerEvent language="en_US" name="ConfbridgeEnd">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a conference ends.</synopsis>
<syntax>
<parameter name="Conference">
</managerEvent>
<managerEvent language="en_US" name="ConfbridgeJoin">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a channel joins a Confbridge conference.</synopsis>
<syntax>
<parameter name="Conference">
</managerEvent>
<managerEvent language="en_US" name="ConfbridgeLeave">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a channel leaves a Confbridge conference.</synopsis>
<syntax>
<parameter name="Conference">
</managerEvent>
<managerEvent language="en_US" name="ConfbridgeRecord">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a conference starts recording.</synopsis>
<syntax>
<parameter name="Conference">
</managerEvent>
<managerEvent language="en_US" name="ConfbridgeStopRecord">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a conference that was recording stops recording.</synopsis>
<syntax>
<parameter name="Conference">
</managerEvent>
<managerEvent language="en_US" name="ConfbridgeMute">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a Confbridge participant mutes.</synopsis>
<syntax>
<parameter name="Conference">
</managerEvent>
<managerEvent language="en_US" name="ConfbridgeUnmute">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a confbridge participant unmutes.</synopsis>
<syntax>
<parameter name="Conference">
</managerEvent>
<managerEvent language="en_US" name="ConfbridgeTalking">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a confbridge participant begins or ends talking.</synopsis>
<syntax>
<parameter name="Conference">
/*** DOCUMENTATION
<managerEvent language="en_US" name="Cdr">
<managerEventInstance class="EVENT_FLAG_CDR">
- <since><version>13.2.0</version></since>
+ <since>
+ <version>13.2.0</version>
+ </since>
<synopsis>Raised when a CDR is generated.</synopsis>
<syntax>
<parameter name="AccountCode">
/*** DOCUMENTATION
<managerEvent language="en_US" name="CEL">
<managerEventInstance class="EVENT_FLAG_CEL">
- <since><version>13.2.0</version></since>
+ <since>
+ <version>13.2.0</version>
+ </since>
<synopsis>Raised when a Channel Event Log is generated for a channel.</synopsis>
<syntax>
<parameter name="EventName">
/*** DOCUMENTATION
<application name="DAHDISendKeypadFacility" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.4.22</version>
+ </since>
<synopsis>
Send digits out of band over a PRI.
</synopsis>
</description>
</application>
<application name="DAHDISendCallreroutingFacility" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.2.0</version>
+ </since>
<synopsis>
Send an ISDN call rerouting/deflection facility message.
</synopsis>
</description>
</application>
<application name="DAHDIAcceptR2Call" language="en_US">
- <since><version>1.6.1.0</version></since>
+ <since>
+ <version>1.6.1.0</version>
+ </since>
<synopsis>
Accept an R2 call if its not already accepted (you still need to answer it)
</synopsis>
</description>
</application>
<function name="POLARITY" language="en_US">
- <since><version>16.28.0</version><version>18.14.0</version><version>19.6.0</version></since>
+ <since>
+ <version>16.28.0</version>
+ <version>18.14.0</version>
+ <version>19.6.0</version>
+ </since>
<synopsis>
Set or get the polarity of a DAHDI channel.
</synopsis>
</manager>
<managerEvent language="en_US" name="AlarmClear">
<managerEventInstance class="EVENT_FLAG_SYSTEM">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when an alarm is cleared on a DAHDI channel.</synopsis>
<syntax>
<parameter name="DAHDIChannel">
</managerEvent>
<managerEvent language="en_US" name="SpanAlarmClear">
<managerEventInstance class="EVENT_FLAG_SYSTEM">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when an alarm is cleared on a DAHDI span.</synopsis>
<syntax>
<parameter name="Span">
</managerEvent>
<managerEvent language="en_US" name="DNDState">
<managerEventInstance class="EVENT_FLAG_SYSTEM">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when the Do Not Disturb state is changed on a DAHDI channel.</synopsis>
<syntax>
<parameter name="DAHDIChannel">
</managerEvent>
<managerEvent language="en_US" name="Alarm">
<managerEventInstance class="EVENT_FLAG_SYSTEM">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when an alarm is set on a DAHDI channel.</synopsis>
<syntax>
<parameter name="DAHDIChannel">
</managerEvent>
<managerEvent language="en_US" name="SpanAlarm">
<managerEventInstance class="EVENT_FLAG_SYSTEM">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when an alarm is set on a DAHDI span.</synopsis>
<syntax>
<parameter name="Span">
</managerEvent>
<managerEvent language="en_US" name="DAHDIChannel">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a DAHDI channel is created or an underlying technology is associated with a DAHDI channel.</synopsis>
<syntax>
<channel_snapshot/>
/*** DOCUMENTATION
<application name="IAX2Provision" language="en_US">
- <since><version>1.6.1.0</version></since>
+ <since>
+ <version>1.6.1.0</version>
+ </since>
<synopsis>
Provision a calling IAXy with a given template.
</synopsis>
</description>
</application>
<function name="IAXPEER" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Gets IAX peer information.
</synopsis>
</description>
</function>
<function name="IAXVAR" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.0</version>
+ </since>
<synopsis>
Sets or retrieves a remote variable.
</synopsis>
</description>
<configFile name="motif.conf">
<configObject name="endpoint">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>The configuration for an endpoint.</synopsis>
<configOption name="context">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Default dialplan context that incoming sessions will be routed to</synopsis>
</configOption>
<configOption name="callgroup">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>A callgroup to assign to this endpoint.</synopsis>
</configOption>
<configOption name="pickupgroup">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>A pickup group to assign to this endpoint.</synopsis>
</configOption>
<configOption name="language">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>The default language for this endpoint.</synopsis>
</configOption>
<configOption name="musicclass">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Default music on hold class for this endpoint.</synopsis>
</configOption>
<configOption name="parkinglot">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Default parking lot for this endpoint.</synopsis>
</configOption>
<configOption name="accountcode">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Accout code for CDR purposes</synopsis>
</configOption>
<configOption name="allow">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>Codecs to allow</synopsis>
</configOption>
<configOption name="disallow">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>Codecs to disallow</synopsis>
</configOption>
<configOption name="connection">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Connection to accept traffic on and on which to send traffic out</synopsis>
</configOption>
<configOption name="transport">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>The transport to use for the endpoint.</synopsis>
<description>
<para>The default outbound transport for this endpoint. Inbound
</description>
</configOption>
<configOption name="maxicecandidates">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Maximum number of ICE candidates to offer</synopsis>
</configOption>
<configOption name="maxpayloads">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Maximum number of payloads to offer</synopsis>
</configOption>
</configObject>
<!DOCTYPE docs SYSTEM "appdocsxml.dtd">
<docs xmlns:xi="http://www.w3.org/2001/XInclude">
<application name="PJSIPHangup" language="en_US">
- <since><version>18.21.0</version><version>20.6.0</version><version>21.1.0</version></since>
+ <since>
+ <version>18.21.0</version>
+ <version>20.6.0</version>
+ <version>21.1.0</version>
+ </since>
<synopsis>
Hangup an incoming PJSIP channel with a SIP response code
</synopsis>
</application>
<application name="PJSIPNotify" language="en_US">
- <since><version>18.25.0</version><version>20.10.0</version><version>21.5.0</version></since>
+ <since>
+ <version>18.25.0</version>
+ <version>20.10.0</version>
+ <version>21.5.0</version>
+ </since>
<synopsis>
Send a NOTIFY to either an arbitrary URI, or inside a SIP dialog.
</synopsis>
</manager>
<function name="PJSIP_DIAL_CONTACTS" language="en_US">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>
Return a dial string for dialing all contacts on an AOR.
</synopsis>
</description>
</function>
<function name="PJSIP_MEDIA_OFFER" language="en_US">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>
Media and codec offerings to be set on an outbound SIP channel prior to dialing.
</synopsis>
</description>
</function>
<function name="PJSIP_MOH_PASSTHROUGH" language="en_US">
- <since><version>13.30.0</version><version>16.7.0</version><version>17.1.0</version></since>
+ <since>
+ <version>13.30.0</version>
+ <version>16.7.0</version>
+ <version>17.1.0</version>
+ </since>
<synopsis>
Get or change the on-hold behavior for a SIP call.
</synopsis>
/*** DOCUMENTATION
<managerEvent language="en_US" name="MCID">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Published when a malicious call ID request arrives.</synopsis>
<syntax>
<channel_snapshot/>
/*** DOCUMENTATION
<function name="AES_ENCRYPT" language="en_US">
- <since><version>1.6.1.0</version></since>
+ <since>
+ <version>1.6.1.0</version>
+ </since>
<synopsis>
Encrypt a string with AES given a 16 character key.
</synopsis>
</see-also>
</function>
<function name="AES_DECRYPT" language="en_US">
- <since><version>1.6.1.0</version></since>
+ <since>
+ <version>1.6.1.0</version>
+ </since>
<synopsis>
Decrypt a string encoded in base64 with AES given a 16 character key.
</synopsis>
/*** DOCUMENTATION
<function name="BASE64_ENCODE" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.4.0</version>
+ </since>
<synopsis>
Encode a string in base64.
</synopsis>
</see-also>
</function>
<function name="BASE64_DECODE" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.4.0</version>
+ </since>
<synopsis>
Decode a base64 string.
</synopsis>
/*** DOCUMENTATION
<function name="BLACKLIST" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.0</version>
+ </since>
<synopsis>
Check if the callerid is on the blacklist.
</synopsis>
/*** DOCUMENTATION
<function name="CALLCOMPLETION" language="en_US">
- <since><version>1.8.0</version></since>
+ <since>
+ <version>1.8.0</version>
+ </since>
<synopsis>
Get or set a call completion configuration parameter for a channel.
</synopsis>
*/
/*** DOCUMENTATION
<function name="CALLERID" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Gets or sets Caller*ID data on the channel.
</synopsis>
</description>
</function>
<function name="CONNECTEDLINE" language="en_US">
- <since><version>1.8.0</version></since>
+ <since>
+ <version>1.8.0</version>
+ </since>
<synopsis>
Gets or sets Connected Line data on the channel.
</synopsis>
</description>
</function>
<function name="REDIRECTING" language="en_US">
- <since><version>1.8.0</version></since>
+ <since>
+ <version>1.8.0</version>
+ </since>
<synopsis>
Gets or sets Redirecting data on the channel.
</synopsis>
/*** DOCUMENTATION
<function name="CDR" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Gets or sets a CDR variable.
</synopsis>
</description>
</function>
<function name="CDR_PROP" language="en_US">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>
Set a property on a channel's CDR.
</synopsis>
/*** DOCUMENTATION
<function name="CHANNELS" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.1.0</version>
+ </since>
<synopsis>
Gets the list of channels, optionally filtering by a regular expression.
</synopsis>
</description>
</function>
<function name="MASTER_CHANNEL" language="en_US">
- <since><version>1.8.0</version></since>
+ <since>
+ <version>1.8.0</version>
+ </since>
<synopsis>
Gets or sets variables on the master channel
</synopsis>
</description>
</function>
<function name="CHANNEL" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Gets/sets various pieces of information about the channel.
</synopsis>
/*** DOCUMENTATION
<function name="AST_CONFIG" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.1.0</version>
+ </since>
<synopsis>
Retrieve a variable from a configuration file.
</synopsis>
/*** DOCUMENTATION
<function name="CURL" language="en_US">
- <since><version>10.0.0</version></since>
+ <since>
+ <version>10.0.0</version>
+ </since>
<synopsis>
Retrieve content from a remote web or ftp server
</synopsis>
</see-also>
</function>
<function name="CURLOPT" language="en_US">
- <since><version>10.0.0</version></since>
+ <since>
+ <version>10.0.0</version>
+ </since>
<synopsis>
Sets various options for future invocations of CURL.
</synopsis>
/*** DOCUMENTATION
<function name="SORT" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Sorts a list of key/vals into a list of keys, based upon the vals.
</synopsis>
</description>
</function>
<function name="CUT" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Slices and dices strings, based upon a named delimiter.
</synopsis>
/*** DOCUMENTATION
<function name="DB" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Read from or write to the Asterisk database.
</synopsis>
</see-also>
</function>
<function name="DB_EXISTS" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Check to see if a key exists in the Asterisk database.
</synopsis>
</see-also>
</function>
<function name="DB_KEYS" language="en_US">
- <since><version>10.0.0</version></since>
+ <since>
+ <version>10.0.0</version>
+ </since>
<synopsis>
Obtain a list of keys within the Asterisk database.
</synopsis>
</see-also>
</function>
<function name="DB_KEYCOUNT" language="en_US">
- <since><version>16.26.0</version><version>18.12.0</version><version>19.4.0</version></since>
+ <since>
+ <version>16.26.0</version>
+ <version>18.12.0</version>
+ <version>19.4.0</version>
+ </since>
<synopsis>
Obtain the number of keys at a prefix within the Asterisk database.
</synopsis>
</see-also>
</function>
<function name="DB_DELETE" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.4.0</version>
+ </since>
<synopsis>
Return a value from the database and delete it.
</synopsis>
/*** DOCUMENTATION
<function name="DEVICE_STATE" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.0</version>
+ </since>
<synopsis>
Get or Set a device state.
</synopsis>
</description>
</function>
<function name="HINT" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.0</version>
+ </since>
<synopsis>
Get the devices set for a dialplan hint.
</synopsis>
/*** DOCUMENTATION
<function name="DIALGROUP" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.0</version>
+ </since>
<synopsis>
Manages a group of users for dialing.
</synopsis>
/*** DOCUMENTATION
<function name="DIALPLAN_EXISTS" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.0</version>
+ </since>
<synopsis>
Checks the existence of a dialplan target.
</synopsis>
</description>
</function>
<function name="VALID_EXTEN" language="en_US">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>
Determine whether an extension exists or not.
</synopsis>
/*** DOCUMENTATION
<function name="ENUMQUERY" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.0</version>
+ </since>
<synopsis>
Initiate an ENUM query.
</synopsis>
</description>
</function>
<function name="ENUMRESULT" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.0</version>
+ </since>
<synopsis>
Retrieve results from a ENUMQUERY.
</synopsis>
</description>
</function>
<function name="ENUMLOOKUP" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
General or specific querying of NAPTR records for ENUM or ENUM-like DNS pointers.
</synopsis>
</description>
</function>
<function name="TXTCIDNAME" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
TXTCIDNAME looks up a caller name via DNS.
</synopsis>
/*** DOCUMENTATION
<function name="ENV" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Gets or sets the environment variable specified.
</synopsis>
</description>
</function>
<function name="STAT" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.4.0</version>
+ </since>
<synopsis>
Does a check on the specified file.
</synopsis>
</description>
</function>
<function name="FILE" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.0</version>
+ </since>
<synopsis>
Read or write text file.
</synopsis>
</see-also>
</function>
<function name="FILE_COUNT_LINE" language="en_US">
- <since><version>1.8.0</version></since>
+ <since>
+ <version>1.8.0</version>
+ </since>
<synopsis>
Obtains the number of lines of a text file.
</synopsis>
</see-also>
</function>
<function name="FILE_FORMAT" language="en_US">
- <since><version>1.8.0</version></since>
+ <since>
+ <version>1.8.0</version>
+ </since>
<synopsis>
Return the newline format of a text file.
</synopsis>
/*** DOCUMENTATION
<function name="EVAL_EXTEN" language="en_US">
- <since><version>16.26.0</version><version>18.12.0</version><version>19.4.0</version></since>
+ <since>
+ <version>16.26.0</version>
+ <version>18.12.0</version>
+ <version>19.4.0</version>
+ </since>
<synopsis>
Evaluates the contents of a dialplan extension and returns it as a string.
</synopsis>
</see-also>
</function>
<function name="EVAL_SUB" language="en_US">
- <since><version>20.11.0</version><version>21.6.0</version><version>22.1.0</version></since>
+ <since>
+ <version>20.11.0</version>
+ <version>21.6.0</version>
+ <version>22.1.0</version>
+ </since>
<synopsis>
Executes a Gosub and provides its return value as a string
</synopsis>
/*** DOCUMENTATION
<function name="EXPORT" language="en_US">
- <since><version>16.30.0</version><version>18.16.0</version><version>19.8.0</version><version>20.1.0</version></since>
+ <since>
+ <version>16.30.0</version>
+ <version>18.16.0</version>
+ <version>19.8.0</version>
+ <version>20.1.0</version>
+ </since>
<synopsis>
Set variables or dialplan functions on any arbitrary channel that exists.
</synopsis>
/*** DOCUMENTATION
<function name="EXTENSION_STATE" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.0</version>
+ </since>
<synopsis>
Get an extension's state.
</synopsis>
/*** DOCUMENTATION
<function name="FRAME_TRACE" language="en_US">
- <since><version>10.0.0</version></since>
+ <since>
+ <version>10.0.0</version>
+ </since>
<synopsis>
View internal ast_frames as they are read and written on a channel.
</synopsis>
/*** DOCUMENTATION
<function name="GLOBAL" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.4.0</version>
+ </since>
<synopsis>
Gets or sets the global variable specified.
</synopsis>
</description>
</function>
<function name="GLOBAL_DELETE" language="en_US">
- <since><version>18.21.0</version><version>20.6.0</version><version>21.1.0</version></since>
+ <since>
+ <version>18.21.0</version>
+ <version>20.6.0</version>
+ <version>21.1.0</version>
+ </since>
<synopsis>
Deletes a specified global variable.
</synopsis>
</see-also>
</function>
<function name="GLOBAL_EXISTS" language="en_US">
- <since><version>18.21.0</version><version>20.6.0</version><version>21.1.0</version></since>
+ <since>
+ <version>18.21.0</version>
+ <version>20.6.0</version>
+ <version>21.1.0</version>
+ </since>
<synopsis>
Check if a global variable exists or not.
</synopsis>
</see-also>
</function>
<function name="SHARED" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.0</version>
+ </since>
<synopsis>
Gets or sets the shared variable specified.
</synopsis>
</function>
<managerEvent language="en_US" name="VarSet">
<managerEventInstance class="EVENT_FLAG_DIALPLAN">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a variable is shared between channels.</synopsis>
<syntax>
<channel_snapshot/>
/*** DOCUMENTATION
<function name="GROUP_COUNT" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Counts the number of channels in the specified group.
</synopsis>
</description>
</function>
<function name="GROUP_MATCH_COUNT" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Counts the number of channels in the groups matching the specified pattern.
</synopsis>
</description>
</function>
<function name="GROUP" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Gets or sets the channel group.
</synopsis>
</description>
</function>
<function name="GROUP_LIST" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Gets a list of the groups set on a channel.
</synopsis>
/*** DOCUMENTATION
<function name="HANGUPCAUSE" language="en_US">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>
Gets per-channel hangupcause information from the channel.
</synopsis>
</see-also>
</function>
<function name="HANGUPCAUSE_KEYS" language="en_US">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>
Gets the list of channels for which hangup causes are available.
</synopsis>
</see-also>
</function>
<application name="HangupCauseClear" language="en_US">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>
Clears hangup cause information from the channel that is available through HANGUPCAUSE.
</synopsis>
/*** DOCUMENTATION
<function name="HOLD_INTERCEPT" language="en_US">
- <since><version>13.7.0</version></since>
+ <since>
+ <version>13.7.0</version>
+ </since>
<synopsis>
Intercepts hold frames on a channel and raises an event instead of passing the frame on
</synopsis>
/*** DOCUMENTATION
<function name="ICONV" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.0</version>
+ </since>
<synopsis>
Converts charsets of strings.
</synopsis>
/*** DOCUMENTATION
<function name="JITTERBUFFER" language="en_US">
- <since><version>10.0.0</version></since>
+ <since>
+ <version>10.0.0</version>
+ </since>
<synopsis>
Add a Jitterbuffer to the Read side of the channel. This dejitters the audio stream before it reaches the Asterisk core. This is a write only function.
</synopsis>
/*** DOCUMENTATION
<function name="LOCK" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.0</version>
+ </since>
<synopsis>
Attempt to obtain a named mutex.
</synopsis>
</see-also>
</function>
<function name="TRYLOCK" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.0</version>
+ </since>
<synopsis>
Attempt to obtain a named mutex.
</synopsis>
</see-also>
</function>
<function name="UNLOCK" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.0</version>
+ </since>
<synopsis>
Unlocks a named mutex.
</synopsis>
/*** DOCUMENTATION
<function name="ISNULL" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Check if a value is NULL.
</synopsis>
</description>
</function>
<function name="SET" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
SET assigns a value to a channel variable.
</synopsis>
</description>
</function>
<function name="EXISTS" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Test the existence of a value.
</synopsis>
</description>
</function>
<function name="IF" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Check for an expression.
</synopsis>
</description>
</function>
<function name="IFTIME" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Temporal Conditional.
</synopsis>
</description>
</function>
<function name="IMPORT" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.0</version>
+ </since>
<synopsis>
Retrieve the value of a variable from another channel.
</synopsis>
</description>
</function>
<function name="DELETE" language="en_US">
- <since><version>18.21.0</version><version>20.6.0</version><version>21.1.0</version></since>
+ <since>
+ <version>18.21.0</version>
+ <version>20.6.0</version>
+ <version>21.1.0</version>
+ </since>
<synopsis>
Deletes a specified channel variable.
</synopsis>
</see-also>
</function>
<function name="VARIABLE_EXISTS" language="en_US">
- <since><version>18.21.0</version><version>20.6.0</version><version>21.1.0</version></since>
+ <since>
+ <version>18.21.0</version>
+ <version>20.6.0</version>
+ <version>21.1.0</version>
+ </since>
<synopsis>
Check if a dialplan variable exists or not.
</synopsis>
/*** DOCUMENTATION
<function name="MATH" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Performs Mathematical Functions.
</synopsis>
</description>
</function>
<function name="INC" language="en_US">
- <since><version>1.8.0</version></since>
+ <since>
+ <version>1.8.0</version>
+ </since>
<synopsis>
Increments the value of a variable, while returning the updated value to the dialplan
</synopsis>
</description>
</function>
<function name="DEC" language="en_US">
- <since><version>1.8.0</version></since>
+ <since>
+ <version>1.8.0</version>
+ </since>
<synopsis>
Decrements the value of a variable, while returning the updated value to the dialplan
</synopsis>
/*** DOCUMENTATION
<function name="MD5" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Computes an MD5 digest.
</synopsis>
/*** DOCUMENTATION
<function name="IFMODULE" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.0</version>
+ </since>
<synopsis>
Checks if an Asterisk module is loaded in memory.
</synopsis>
/*** DOCUMENTATION
<function name="ODBC_FETCH" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.0</version>
+ </since>
<synopsis>
Fetch a row from a multirow query.
</synopsis>
</description>
</function>
<application name="ODBCFinish" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.0</version>
+ </since>
<synopsis>
Clear the resultset of a sucessful multirow query.
</synopsis>
</description>
</application>
<function name="SQL_ESC" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.4.0</version>
+ </since>
<synopsis>
Escapes single ticks for use in SQL statements.
</synopsis>
</description>
</function>
<function name="SQL_ESC_BACKSLASHES" language="en_US">
- <since><version>16.26.0</version><version>18.12.0</version><version>19.4.0</version></since>
+ <since>
+ <version>16.26.0</version>
+ <version>18.12.0</version>
+ <version>19.4.0</version>
+ </since>
<synopsis>
Escapes backslashes for use in SQL statements.
</synopsis>
/*** DOCUMENTATION
<function name="PERIODIC_HOOK" language="en_US">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>
Execute a periodic dialplan hook into the audio of a call.
</synopsis>
/*** DOCUMENTATION
<function name="PITCH_SHIFT" language="en_US">
- <since><version>1.8.0</version></since>
+ <since>
+ <version>1.8.0</version>
+ </since>
<synopsis>
Pitch shift both tx and rx audio streams on a channel.
</synopsis>
/*** DOCUMENTATION
<function name="PJSIP_AOR" language="en_US">
- <since><version>13.2.0</version></since>
+ <since>
+ <version>13.2.0</version>
+ </since>
<synopsis>
Get information about a PJSIP AOR
</synopsis>
/*** DOCUMENTATION
<function name="PJSIP_CONTACT" language="en_US">
- <since><version>13.2.0</version></since>
+ <since>
+ <version>13.2.0</version>
+ </since>
<synopsis>
Get information about a PJSIP contact
</synopsis>
/*** DOCUMENTATION
<function name="PJSIP_ENDPOINT" language="en_US">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>
Get information about a PJSIP endpoint
</synopsis>
/*** DOCUMENTATION
<function name="PRESENCE_STATE" language="en_US">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>
Get or Set a presence state.
</synopsis>
/*** DOCUMENTATION
<function name="RAND" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.4.0</version>
+ </since>
<synopsis>
Choose a random number in a range.
</synopsis>
/*** DOCUMENTATION
<function name="REALTIME" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.4.0</version>
+ </since>
<synopsis>
RealTime Read/Write Functions.
</synopsis>
</see-also>
</function>
<function name="REALTIME_STORE" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.0</version>
+ </since>
<synopsis>
RealTime Store Function.
</synopsis>
</see-also>
</function>
<function name="REALTIME_DESTROY" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.0</version>
+ </since>
<synopsis>
RealTime Destroy Function.
</synopsis>
</see-also>
</function>
<function name="REALTIME_FIELD" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.2.0</version>
+ </since>
<synopsis>
RealTime query function.
</synopsis>
</see-also>
</function>
<function name="REALTIME_HASH" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.2.0</version>
+ </since>
<synopsis>
RealTime query function.
</synopsis>
/*** DOCUMENTATION
<function name="SHA1" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.4.0</version>
+ </since>
<synopsis>
Computes a SHA1 digest.
</synopsis>
/*** DOCUMENTATION
<function name="SHELL" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.0</version>
+ </since>
<synopsis>
Executes a command using the system shell and captures its output.
</synopsis>
/*** DOCUMENTATION
<function name="AST_SORCERY" language="en_US">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>
Get a field from a sorcery object
</synopsis>
/*** DOCUMENTATION
<function name="AGC" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.1.0</version>
+ </since>
<synopsis>
Apply automatic gain control to audio on a channel.
</synopsis>
</description>
</function>
<function name="DENOISE" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.1.0</version>
+ </since>
<synopsis>
Apply noise reduction to audio on a channel.
</synopsis>
/*** DOCUMENTATION
<function name="SPRINTF" language="en_US">
- <since><version>1.6.1.0</version></since>
+ <since>
+ <version>1.6.1.0</version>
+ </since>
<synopsis>
Format a variable according to a format string.
</synopsis>
/*** DOCUMENTATION
<function name="SRVQUERY" language="en_US">
- <since><version>1.8.0</version></since>
+ <since>
+ <version>1.8.0</version>
+ </since>
<synopsis>
Initiate an SRV query.
</synopsis>
</description>
</function>
<function name="SRVRESULT" language="en_US">
- <since><version>1.8.0</version></since>
+ <since>
+ <version>1.8.0</version>
+ </since>
<synopsis>
Retrieve results from an SRVQUERY.
</synopsis>
/*** DOCUMENTATION
<function name="FIELDQTY" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Count the fields with an arbitrary delimiter
</synopsis>
</description>
</function>
<function name="FIELDNUM" language="en_US">
- <since><version>10.0.0</version></since>
+ <since>
+ <version>10.0.0</version>
+ </since>
<synopsis>
Return the 1-based offset of a field in a list
</synopsis>
</description>
</function>
<function name="LISTFILTER" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.2.0</version>
+ </since>
<synopsis>Remove an item from a list, by name.</synopsis>
<syntax>
<parameter name="varname" required="true" />
</description>
</function>
<function name="FILTER" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.40</version>
+ </since>
<synopsis>
Filter the string to include only the allowed characters
</synopsis>
</description>
</function>
<function name="REPLACE" language="en_US">
- <since><version>1.8.0</version></since>
+ <since>
+ <version>1.8.0</version>
+ </since>
<synopsis>
Replace a set of characters in a given string with another character.
</synopsis>
</description>
</function>
<function name="STRREPLACE" language="en_US">
- <since><version>10.0.0</version></since>
+ <since>
+ <version>10.0.0</version>
+ </since>
<synopsis>
Replace instances of a substring within a string with another string.
</synopsis>
</description>
</function>
<function name="TRIM" language="en_US">
- <since><version>16.30.0</version><version>18.16.0</version><version>19.8.0</version><version>20.1.0</version></since>
+ <since>
+ <version>16.30.0</version>
+ <version>18.16.0</version>
+ <version>19.8.0</version>
+ <version>20.1.0</version>
+ </since>
<synopsis>
Trim leading and trailing whitespace in a string
</synopsis>
</see-also>
</function>
<function name="LTRIM" language="en_US">
- <since><version>16.30.0</version><version>18.16.0</version><version>19.8.0</version><version>20.1.0</version></since>
+ <since>
+ <version>16.30.0</version>
+ <version>18.16.0</version>
+ <version>19.8.0</version>
+ <version>20.1.0</version>
+ </since>
<synopsis>
Trim leading whitespace in a string
</synopsis>
</see-also>
</function>
<function name="RTRIM" language="en_US">
- <since><version>16.30.0</version><version>18.16.0</version><version>19.8.0</version><version>20.1.0</version></since>
+ <since>
+ <version>16.30.0</version>
+ <version>18.16.0</version>
+ <version>19.8.0</version>
+ <version>20.1.0</version>
+ </since>
<synopsis>
Trim trailing whitespace in a string
</synopsis>
</see-also>
</function>
<function name="PASSTHRU" language="en_US">
- <since><version>1.8.0</version></since>
+ <since>
+ <version>1.8.0</version>
+ </since>
<synopsis>
Pass the given argument back as a value.
</synopsis>
</description>
</function>
<function name="REGEX" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Check string against a regular expression.
</synopsis>
</description>
</function>
<application name="ClearHash" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.0</version>
+ </since>
<synopsis>
Clear the keys from a specified hashname.
</synopsis>
</description>
</application>
<function name="HASH" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.0</version>
+ </since>
<synopsis>
Implementation of a dialplan associative array
</synopsis>
</description>
</function>
<function name="HASHKEYS" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.0</version>
+ </since>
<synopsis>
Retrieve the keys of the HASH() function.
</synopsis>
</description>
</function>
<function name="KEYPADHASH" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.4.0</version>
+ </since>
<synopsis>
Hash the letters in string into equivalent keypad numbers.
</synopsis>
</description>
</function>
<function name="ARRAY" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.4.0</version>
+ </since>
<synopsis>
Allows setting multiple variables at once.
</synopsis>
</description>
</function>
<function name="STRPTIME" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.4.0</version>
+ </since>
<synopsis>
Returns the epoch of the arbitrary date/time string structured as described by the format.
</synopsis>
</description>
</function>
<function name="STRFTIME" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Returns the current date/time in the specified format.
</synopsis>
</see-also>
</function>
<function name="EVAL" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Evaluate stored variables
</synopsis>
</description>
</function>
<function name="TOUPPER" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.0</version>
+ </since>
<synopsis>
Convert string to all uppercase letters.
</synopsis>
</description>
</function>
<function name="TOLOWER" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.0</version>
+ </since>
<synopsis>
Convert string to all lowercase letters.
</synopsis>
</description>
</function>
<function name="LEN" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Return the length of the string given.
</synopsis>
</description>
</function>
<function name="QUOTE" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.4.0</version>
+ </since>
<synopsis>
Quotes a given string, escaping embedded quotes as necessary
</synopsis>
</description>
</function>
<function name="CSV_QUOTE" language="en_US">
- <since><version>1.8.0</version></since>
+ <since>
+ <version>1.8.0</version>
+ </since>
<synopsis>
Quotes a given string for use in a CSV file, escaping embedded quotes as necessary
</synopsis>
</description>
</function>
<function name="SHIFT" language="en_US">
- <since><version>1.8.0</version></since>
+ <since>
+ <version>1.8.0</version>
+ </since>
<synopsis>
Removes and returns the first item off of a variable containing delimited text
</synopsis>
</description>
</function>
<function name="POP" language="en_US">
- <since><version>1.8.0</version></since>
+ <since>
+ <version>1.8.0</version>
+ </since>
<synopsis>
Removes and returns the last item off of a variable containing delimited text
</synopsis>
</description>
</function>
<function name="PUSH" language="en_US">
- <since><version>1.8.0</version></since>
+ <since>
+ <version>1.8.0</version>
+ </since>
<synopsis>
Appends one or more values to the end of a variable containing delimited text
</synopsis>
</description>
</function>
<function name="UNSHIFT" language="en_US">
- <since><version>1.8.0</version></since>
+ <since>
+ <version>1.8.0</version>
+ </since>
<synopsis>
Inserts one or more values to the beginning of a variable containing delimited text
</synopsis>
/*** DOCUMENTATION
<function name="SYSINFO" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.0</version>
+ </since>
<synopsis>
Returns system information specified by parameter.
</synopsis>
/*** DOCUMENTATION
<function name="TIMEOUT" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Gets or sets timeouts on the channel. Timeout values are in seconds.
</synopsis>
/*** DOCUMENTATION
<function name="URIENCODE" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Encodes a string to URI-safe encoding according to RFC 2396.
</synopsis>
</description>
</function>
<function name="URIDECODE" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Decodes a URI-encoded string according to RFC 2396.
</synopsis>
/*** DOCUMENTATION
<function name="VERSION" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.0</version>
+ </since>
<synopsis>
Return the Version info for this Asterisk.
</synopsis>
/*** DOCUMENTATION
<function name="VMCOUNT" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Count the voicemails in a specified mailbox or mailboxes.
</synopsis>
/*** DOCUMENTATION
<function name="VOLUME" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.0</version>
+ </since>
<synopsis>
Set or get the TX or RX volume of a channel.
</synopsis>
/*** DOCUMENTATION
<managerEvent language="en_US" name="AOC-S">
<managerEventInstance class="EVENT_FLAG_AOC">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when an Advice of Charge message is sent at the beginning of a call.</synopsis>
<syntax>
<channel_snapshot/>
</managerEvent>
<managerEvent language="en_US" name="AOC-D">
<managerEventInstance class="EVENT_FLAG_AOC">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when an Advice of Charge message is sent during a call.</synopsis>
<syntax>
<channel_snapshot/>
</managerEvent>
<managerEvent language="en_US" name="AOC-E">
<managerEventInstance class="EVENT_FLAG_AOC">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when an Advice of Charge message is sent at the end of a call.</synopsis>
<syntax>
<channel_snapshot/>
/*** DOCUMENTATION
<managerEvent language="en_US" name="FullyBooted">
<managerEventInstance class="EVENT_FLAG_SYSTEM">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when all Asterisk initialization procedures have finished.</synopsis>
<syntax>
<parameter name="Status">
</managerEvent>
<managerEvent language="en_US" name="Shutdown">
<managerEventInstance class="EVENT_FLAG_SYSTEM">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when Asterisk is shutdown or restarted.</synopsis>
<syntax>
<parameter name="Shutdown">
/*** DOCUMENTATION
<application name="CallCompletionRequest" language="en_US">
- <since><version>1.8.0</version></since>
+ <since>
+ <version>1.8.0</version>
+ </since>
<synopsis>
Request call completion service for previous call
</synopsis>
</description>
</application>
<application name="CallCompletionCancel" language="en_US">
- <since><version>1.8.0</version></since>
+ <since>
+ <version>1.8.0</version>
+ </since>
<synopsis>
Cancel call completion service
</synopsis>
</description>
<configFile name="cdr.conf">
<configObject name="general">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Global settings applied to the CDR engine.</synopsis>
<configOption name="debug">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Enable/disable verbose CDR debugging.</synopsis>
<description><para>When set to <literal>True</literal>, verbose updates
of changes in CDR information will be logged. Note that this is only
</description>
</configOption>
<configOption name="enable" default="yes">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Enable/disable CDR logging.</synopsis>
<description><para>Define whether or not to use CDR logging. Setting this to "no" will override
any loading of backend CDR modules.</para>
</description>
</configOption>
<configOption name="channeldefaultenabled" default="yes">
- <since><version>16.24.0</version><version>18.10.0</version><version>19.2.0</version></since>
+ <since>
+ <version>16.24.0</version>
+ <version>18.10.0</version>
+ <version>19.2.0</version>
+ </since>
<synopsis>Whether CDR is enabled on a channel by default</synopsis>
<description><para>Define whether or not CDR should be enabled on a channel by default.
Setting this to "yes" will enable CDR on every channel unless it is explicitly disabled.
</description>
</configOption>
<configOption name="ignorestatechanges" default="no">
- <since><version>16.30.0</version><version>18.16.0</version><version>19.8.0</version><version>20.1.0</version></since>
+ <since>
+ <version>16.30.0</version>
+ <version>18.16.0</version>
+ <version>19.8.0</version>
+ <version>20.1.0</version>
+ </since>
<synopsis>Whether CDR is updated or forked by bridging changes.</synopsis>
<description><para>Define whether or not CDR should be updated by bridging changes.
This includes entering and leaving bridges and call parking.</para>
</description>
</configOption>
<configOption name="ignoredialchanges" default="no">
- <since><version>16.30.0</version><version>18.16.0</version><version>19.8.0</version><version>20.1.0</version></since>
+ <since>
+ <version>16.30.0</version>
+ <version>18.16.0</version>
+ <version>19.8.0</version>
+ <version>20.1.0</version>
+ </since>
<synopsis>Whether CDR is updated or forked by dial updates.</synopsis>
<description><para>Define whether or not CDR should be updated by dial updates.</para>
<para>If this is set to "no", a single CDR will be used for the channel, even if
</description>
</configOption>
<configOption name="unanswered">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Log calls that are never answered and don't set an outgoing party.</synopsis>
<description><para>
Define whether or not to log unanswered calls that don't involve an outgoing party. Setting
</description>
</configOption>
<configOption name="congestion">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Log congested calls.</synopsis>
<description><para>Define whether or not to log congested calls. Setting this to "yes" will
report each call that fails to complete due to congestion conditions.</para>
</description>
</configOption>
<configOption name="endbeforehexten">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Don't produce CDRs while executing hangup logic</synopsis>
<description>
<para>As each CDR for a channel is finished, its end time is updated
</description>
</configOption>
<configOption name="initiatedseconds">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Count microseconds for billsec purposes</synopsis>
<description><para>Normally, the <literal>billsec</literal> field logged to the CDR backends
is simply the end time (hangup time) minus the answer time in seconds. Internally,
</description>
</configOption>
<configOption name="batch">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Submit CDRs to the backends for processing in batches</synopsis>
<description><para>Define the CDR batch mode, where instead of posting the CDR at the end of
every call, the data will be stored in a buffer to help alleviate load on the
</description>
</configOption>
<configOption name="size">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>The maximum number of CDRs to accumulate before triggering a batch</synopsis>
<description><para>Define the maximum number of CDRs to accumulate in the buffer before posting
them to the backend engines. batch must be set to <literal>yes</literal>.</para>
</description>
</configOption>
<configOption name="time">
- <since><version>13.22.0</version><version>15.5.0</version></since>
+ <since>
+ <version>13.22.0</version>
+ <version>15.5.0</version>
+ </since>
<synopsis>The maximum time to accumulate CDRs before triggering a batch</synopsis>
<description><para>Define the maximum time to accumulate CDRs before posting them in a batch to the
backend engines. If this time limit is reached, then it will post the records, regardless of the value
</description>
</configOption>
<configOption name="scheduleronly">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Post batched CDRs on their own thread instead of the scheduler</synopsis>
<description><para>The CDR engine uses the internal asterisk scheduler to determine when to post
records. Posting can either occur inside the scheduler thread, or a new
</description>
</configOption>
<configOption name="safeshutdown">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Block shutdown of Asterisk until CDRs are submitted</synopsis>
<description><para>When shutting down asterisk, you can block until the CDRs are submitted. If
you don't, then data will likely be lost. You can always check the size of
<configInfo name="cel" language="en_US">
<configFile name="cel.conf">
<configObject name="general">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Options that apply globally to Channel Event Logging (CEL)</synopsis>
<configOption name="enable">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Determines whether CEL is enabled</synopsis>
</configOption>
<configOption name="dateformat">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>The format to be used for dates when logging</synopsis>
</configOption>
<configOption name="apps">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>List of apps for CEL to track</synopsis>
<description><para>A case-insensitive, comma-separated list of applications
to track when one or both of APP_START and APP_END events are flagged for
tracking</para></description>
</configOption>
<configOption name="events">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>List of events for CEL to track</synopsis>
<description><para>A case-sensitive, comma-separated list of event names
to track. These event names do not include the leading <literal>AST_CEL</literal>.
/*** DOCUMENTATION
<managerEvent language="en_US" name="Rename">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>16.24.0</version><version>18.10.0</version><version>19.2.0</version></since>
+ <since>
+ <version>16.24.0</version>
+ <version>18.10.0</version>
+ <version>19.2.0</version>
+ </since>
<synopsis>Raised when the name of a channel is changed.</synopsis>
</managerEventInstance>
</managerEvent>
</manager>
<managerEvent language="en_US" name="LocalBridge">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when two halves of a Local Channel form a bridge.</synopsis>
<syntax>
<channel_snapshot prefix="LocalOne"/>
</managerEvent>
<managerEvent language="en_US" name="LocalOptimizationBegin">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when two halves of a Local Channel begin to optimize
themselves out of the media path.</synopsis>
<syntax>
</managerEvent>
<managerEvent language="en_US" name="LocalOptimizationEnd">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when two halves of a Local Channel have finished optimizing
themselves out of the media path.</synopsis>
<syntax>
/*** DOCUMENTATION
<managerEvent language="en_US" name="DeviceStateChange">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>Raised when a device state changes</synopsis>
<syntax>
<parameter name="Device">
/*** DOCUMENTATION
<application name="Bridge" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.0</version>
+ </since>
<synopsis>
Bridge two channels.
</synopsis>
<synopsis>Features Configuration</synopsis>
<configFile name="features.conf">
<configObject name="globals">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>
</synopsis>
<configOption name="featuredigittimeout" default="1000">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Milliseconds allowed between digit presses when entering a feature code.</synopsis>
</configOption>
<configOption name="courtesytone">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Sound to play when automixmon is activated</synopsis>
</configOption>
<configOption name="recordingfailsound">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Sound to play when automixmon is attempted but fails to start</synopsis>
</configOption>
<configOption name="transferdigittimeout" default="3">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Seconds allowed between digit presses when dialing a transfer destination</synopsis>
</configOption>
<configOption name="atxfernoanswertimeout" default="15">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Seconds to wait for attended transfer destination to answer</synopsis>
</configOption>
<configOption name="atxferdropcall" default="no">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Hang up the call entirely if the attended transfer fails</synopsis>
<description>
<para>When this option is set to <literal>no</literal>, then Asterisk will attempt to
</description>
</configOption>
<configOption name="atxferloopdelay" default="10">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Seconds to wait between attempts to re-dial transfer destination</synopsis>
<see-also><ref type="configOption">atxferdropcall</ref></see-also>
</configOption>
<configOption name="atxfercallbackretries" default="2">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Number of times to re-attempt dialing a transfer destination</synopsis>
<see-also><ref type="configOption">atxferdropcall</ref></see-also>
</configOption>
<configOption name="xfersound" default="beep">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Sound to play to during transfer and transfer-like operations.</synopsis>
<description>
<para>This sound will play to the transferrer and transfer target channels when
</description>
</configOption>
<configOption name="xferfailsound" default="beeperr">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Sound to play to a transferee when a transfer fails</synopsis>
</configOption>
<configOption name="atxferabort" default="*1">
</description>
</configOption>
<configOption name="pickupsound">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Sound to play to picker when a call is picked up</synopsis>
</configOption>
<configOption name="pickupfailsound">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Sound to play to picker when a call cannot be picked up</synopsis>
</configOption>
<configOption name="transferdialattempts" default="3">
- <since><version>13.1.0</version></since>
+ <since>
+ <version>13.1.0</version>
+ </since>
<synopsis>Number of dial attempts allowed when attempting a transfer</synopsis>
</configOption>
<configOption name="transferretrysound" default="pbx-invalid">
- <since><version>13.1.0</version></since>
+ <since>
+ <version>13.1.0</version>
+ </since>
<synopsis>Sound that is played when an incorrect extension is dialed and the transferer should try again.</synopsis>
</configOption>
<configOption name="transferinvalidsound" default="privacy-incorrect">
- <since><version>13.1.0</version></since>
+ <since>
+ <version>13.1.0</version>
+ </since>
<synopsis>Sound that is played when an incorrect extension is dialed and the transferer has no attempts remaining.</synopsis>
</configOption>
<configOption name="transferannouncesound" default="pbx-transfer">
- <since><version>16.29.0</version><version>18.15.0</version><version>19.7.0</version></since>
+ <since>
+ <version>16.29.0</version>
+ <version>18.15.0</version>
+ <version>19.7.0</version>
+ </since>
<synopsis>Sound that is played to the transferer when a transfer is initiated. If empty, no sound will be played.</synopsis>
</configOption>
</configObject>
<configObject name="featuremap">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>DTMF options that can be triggered during bridged calls</synopsis>
<configOption name="atxfer">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>DTMF sequence to initiate an attended transfer</synopsis>
<description>
<para>The transferee parties will be placed on hold and the
</description>
</configOption>
<configOption name="blindxfer" default="#">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>DTMF sequence to initiate a blind transfer</synopsis>
<description>
<para>The transferee parties will be placed on hold and the
</description>
</configOption>
<configOption name="parkcall">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>DTMF sequence to park a call</synopsis>
<description>
<para>The parking lot used to park the call is determined by using either the
</description>
</configOption>
<configOption name="automixmon">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>DTMF sequence to start or stop MixMonitor on a call</synopsis>
<description>
<para>This will cause the channel that pressed the DTMF sequence
</configOption>
</configObject>
<configObject name="applicationmap">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Section for defining custom feature invocations during a call</synopsis>
<description>
<para>The applicationmap is an area where new custom features can be created. Items
</configOption>
</configObject>
<configObject name="featuregroup">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Groupings of items from the applicationmap</synopsis>
<description>
<para>Feature groups allow for multiple applicationmap items to be
</configFile>
</configInfo>
<function name="FEATURE" language="en_US">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>
Get or set a feature option on a channel.
</synopsis>
</see-also>
</function>
<function name="FEATUREMAP" language="en_US">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>
Get or set a feature map to a given value on a specific channel.
</synopsis>
/*** DOCUMENTATION
<managerEvent language="en_US" name="Reload">
<managerEventInstance class="EVENT_FLAG_SYSTEM">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a module has been reloaded in Asterisk.</synopsis>
<syntax>
<parameter name="Module">
</managerEvent>
<managerEvent language="en_US" name="Load">
<managerEventInstance class="EVENT_FLAG_SYSTEM">
- <since><version>16.0.0</version></since>
+ <since>
+ <version>16.0.0</version>
+ </since>
<synopsis>Raised when a module has been loaded in Asterisk.</synopsis>
<syntax>
<parameter name="Module">
</managerEvent>
<managerEvent language="en_US" name="Unload">
<managerEventInstance class="EVENT_FLAG_SYSTEM">
- <since><version>16.0.0</version></since>
+ <since>
+ <version>16.0.0</version>
+ </since>
<synopsis>Raised when a module has been unloaded in Asterisk.</synopsis>
<syntax>
<parameter name="Module">
/*** DOCUMENTATION
<managerEvent language="en_US" name="DeadlockStart">
<managerEventInstance class="EVENT_FLAG_SYSTEM">
- <since><version>16.29.0</version><version>18.15.0</version><version>19.7.0</version></since>
+ <since>
+ <version>16.29.0</version>
+ <version>18.15.0</version>
+ <version>19.7.0</version>
+ </since>
<synopsis>Raised when a probable deadlock has started.
Delivery of this event is attempted but not guaranteed,
and could fail for example if the manager itself is deadlocked.
<?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>
+ <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>
</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>
+ <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">
</syntax>
</managerEventInstance>
<managerEventInstance class="EVENT_FLAG_SYSTEM">
- <since><version>16.24.0</version><version>18.10.0</version><version>19.2.0</version></since>
+ <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">
/*** DOCUMENTATION
<managerEvent language="en_US" name="BridgeCreate">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a bridge is created.</synopsis>
<syntax>
<bridge_snapshot/>
</managerEvent>
<managerEvent language="en_US" name="BridgeDestroy">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a bridge is destroyed.</synopsis>
<syntax>
<bridge_snapshot/>
</managerEvent>
<managerEvent language="en_US" name="BridgeEnter">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a channel enters a bridge.</synopsis>
<syntax>
<bridge_snapshot/>
</managerEvent>
<managerEvent language="en_US" name="BridgeLeave">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a channel leaves a bridge.</synopsis>
<syntax>
<bridge_snapshot/>
</managerEvent>
<managerEvent language="en_US" name="BridgeVideoSourceUpdate">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>13.13.0</version><version>14.2.0</version></since>
+ <since>
+ <version>13.13.0</version>
+ <version>14.2.0</version>
+ </since>
<synopsis>Raised when the channel that is the source of video in a bridge changes.</synopsis>
<syntax>
<bridge_snapshot/>
<list-elements>
<managerEvent language="en_US" name="BridgeInfoChannel">
<managerEventInstance class="EVENT_FLAG_COMMAND">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>Information about a channel in a bridge.</synopsis>
<syntax>
<channel_snapshot/>
</list-elements>
<managerEvent language="en_US" name="BridgeInfoComplete">
<managerEventInstance class="EVENT_FLAG_COMMAND">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>Information about a bridge.</synopsis>
<syntax>
<bridge_snapshot/>
/*** DOCUMENTATION
<managerEvent language="en_US" name="BridgeMerge">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>16.24.0</version><version>18.10.0</version><version>19.2.0</version></since>
+ <since>
+ <version>16.24.0</version>
+ <version>18.10.0</version>
+ <version>19.2.0</version>
+ </since>
<synopsis>Raised when two bridges are merged.</synopsis>
<syntax>
<bridge_snapshot prefix="To"/>
/*** DOCUMENTATION
<managerEvent language="en_US" name="Newchannel">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a new channel is created.</synopsis>
<syntax>
<channel_snapshot/>
</managerEvent>
<managerEvent language="en_US" name="Newstate">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a channel's state changes.</synopsis>
<syntax>
<channel_snapshot/>
</managerEvent>
<managerEvent language="en_US" name="Hangup">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a channel is hung up.</synopsis>
<syntax>
<channel_snapshot/>
</managerEvent>
<managerEvent language="en_US" name="HangupRequest">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a hangup is requested.</synopsis>
<syntax>
<channel_snapshot/>
</managerEvent>
<managerEvent language="en_US" name="SoftHangupRequest">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a soft hangup is requested with a specific cause code.</synopsis>
<syntax>
<channel_snapshot/>
</managerEvent>
<managerEvent language="en_US" name="NewExten">
<managerEventInstance class="EVENT_FLAG_DIALPLAN">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a channel enters a new context, extension, priority.</synopsis>
<syntax>
<channel_snapshot/>
</managerEvent>
<managerEvent language="en_US" name="NewCallerid">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a channel receives new Caller ID information.</synopsis>
<syntax>
<channel_snapshot/>
</managerEvent>
<managerEvent language="en_US" name="NewConnectedLine">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>13.13.0</version><version>14.2.0</version></since>
+ <since>
+ <version>13.13.0</version>
+ <version>14.2.0</version>
+ </since>
<synopsis>Raised when a channel's connected line information is changed.</synopsis>
<syntax>
<channel_snapshot/>
</managerEvent>
<managerEvent language="en_US" name="NewAccountCode">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a Channel's AccountCode is changed.</synopsis>
<syntax>
<channel_snapshot/>
</managerEvent>
<managerEvent language="en_US" name="DialBegin">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a dial action has started.</synopsis>
<syntax>
<channel_snapshot/>
</managerEvent>
<managerEvent language="en_US" name="DialState">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>14.0.0</version></since>
+ <since>
+ <version>14.0.0</version>
+ </since>
<synopsis>Raised when dial status has changed.</synopsis>
<syntax>
<channel_snapshot/>
</managerEvent>
<managerEvent language="en_US" name="DialEnd">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a dial action has completed.</synopsis>
<syntax>
<channel_snapshot/>
</managerEvent>
<managerEvent language="en_US" name="Hold">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a channel goes on hold.</synopsis>
<syntax>
<channel_snapshot/>
</managerEvent>
<managerEvent language="en_US" name="Unhold">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a channel goes off hold.</synopsis>
<syntax>
<channel_snapshot/>
</managerEvent>
<managerEvent language="en_US" name="ChanSpyStart">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when one channel begins spying on another channel.</synopsis>
<syntax>
<channel_snapshot prefix="Spyer"/>
</managerEvent>
<managerEvent language="en_US" name="ChanSpyStop">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a channel has stopped spying.</synopsis>
<syntax>
<channel_snapshot prefix="Spyer"/>
</managerEvent>
<managerEvent language="en_US" name="HangupHandlerRun">
<managerEventInstance class="EVENT_FLAG_DIALPLAN">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a hangup handler is about to be called.</synopsis>
<syntax>
<channel_snapshot/>
</managerEvent>
<managerEvent language="en_US" name="HangupHandlerPop">
<managerEventInstance class="EVENT_FLAG_DIALPLAN">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>
Raised when a hangup handler is removed from the handler stack
by the CHANNEL() function.
</managerEvent>
<managerEvent language="en_US" name="HangupHandlerPush">
<managerEventInstance class="EVENT_FLAG_DIALPLAN">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>
Raised when a hangup handler is added to the handler stack by
the CHANNEL() function.
</managerEvent>
<managerEvent language="en_US" name="FAXStatus">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>
Raised periodically during a fax transmission.
</synopsis>
</managerEvent>
<managerEvent language="en_US" name="ReceiveFAX">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>
Raised when a receive fax operation has completed.
</synopsis>
</managerEvent>
<managerEvent language="en_US" name="SendFAX">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>
Raised when a send fax operation has completed.
</synopsis>
</managerEvent>
<managerEvent language="en_US" name="MusicOnHoldStart">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when music on hold has started on a channel.</synopsis>
<syntax>
<channel_snapshot/>
</managerEvent>
<managerEvent language="en_US" name="MusicOnHoldStop">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when music on hold has stopped on a channel.</synopsis>
<syntax>
<channel_snapshot/>
/*** DOCUMENTATION
<managerEvent language="en_US" name="DTMFBegin">
<managerEventInstance class="EVENT_FLAG_DTMF">
- <since><version>16.24.0</version><version>18.10.0</version><version>19.2.0</version></since>
+ <since>
+ <version>16.24.0</version>
+ <version>18.10.0</version>
+ <version>19.2.0</version>
+ </since>
<synopsis>Raised when a DTMF digit has started on a channel.</synopsis>
<syntax>
<channel_snapshot/>
/*** DOCUMENTATION
<managerEvent language="en_US" name="DTMFEnd">
<managerEventInstance class="EVENT_FLAG_DTMF">
- <since><version>16.24.0</version><version>18.10.0</version><version>19.2.0</version></since>
+ <since>
+ <version>16.24.0</version>
+ <version>18.10.0</version>
+ <version>19.2.0</version>
+ </since>
<synopsis>Raised when a DTMF digit has ended on a channel.</synopsis>
<syntax>
<channel_snapshot/>
/*** DOCUMENTATION
<managerEvent language="en_US" name="Flash">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>16.24.0</version><version>18.10.0</version><version>19.2.0</version></since>
+ <since>
+ <version>16.24.0</version>
+ <version>18.10.0</version>
+ <version>19.2.0</version>
+ </since>
<synopsis>Raised when a hook flash occurs on a channel.</synopsis>
<syntax>
<channel_snapshot/>
/*** DOCUMENTATION
<managerEvent language="en_US" name="Wink">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>16.24.0</version><version>18.10.0</version><version>19.2.0</version></since>
+ <since>
+ <version>16.24.0</version>
+ <version>18.10.0</version>
+ <version>19.2.0</version>
+ </since>
<synopsis>Raised when a wink occurs on a channel.</synopsis>
<syntax>
<channel_snapshot/>
</manager>
<managerEvent language="en_US" name="Status">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>18.26.0</version><version>20.11.0</version><version>21.6.0</version><version>22.1.0</version></since>
+ <since>
+ <version>18.26.0</version>
+ <version>20.11.0</version>
+ <version>21.6.0</version>
+ <version>22.1.0</version>
+ </since>
<synopsis>Raised in response to a Status command.</synopsis>
<syntax>
<parameter name="ActionID" required="false"/>
</managerEvent>
<managerEvent language="en_US" name="StatusComplete">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>18.26.0</version><version>20.11.0</version><version>21.6.0</version><version>22.1.0</version></since>
+ <since>
+ <version>18.26.0</version>
+ <version>20.11.0</version>
+ <version>21.6.0</version>
+ <version>22.1.0</version>
+ </since>
<synopsis>Raised in response to a Status command.</synopsis>
<syntax>
<parameter name="Items">
</manager>
<managerEvent language="en_US" name="OriginateResponse">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>18.26.0</version><version>20.11.0</version><version>21.6.0</version><version>22.1.0</version></since>
+ <since>
+ <version>18.26.0</version>
+ <version>20.11.0</version>
+ <version>21.6.0</version>
+ <version>22.1.0</version>
+ </since>
<synopsis>Raised in response to an Originate command.</synopsis>
<syntax>
<parameter name="ActionID" required="false"/>
</manager>
<managerEvent language="en_US" name="CoreShowChannel">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>18.26.0</version><version>20.11.0</version><version>21.6.0</version><version>22.1.0</version></since>
+ <since>
+ <version>18.26.0</version>
+ <version>20.11.0</version>
+ <version>21.6.0</version>
+ <version>22.1.0</version>
+ </since>
<synopsis>Raised in response to a CoreShowChannels command.</synopsis>
<syntax>
<xi:include xpointer="xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])" />
</managerEvent>
<managerEvent language="en_US" name="CoreShowChannelsComplete">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>18.26.0</version><version>20.11.0</version><version>21.6.0</version><version>22.1.0</version></since>
+ <since>
+ <version>18.26.0</version>
+ <version>20.11.0</version>
+ <version>21.6.0</version>
+ <version>22.1.0</version>
+ </since>
<synopsis>Raised at the end of the CoreShowChannel list produced by the CoreShowChannels command.</synopsis>
<syntax>
<xi:include xpointer="xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])" />
</manager>
<managerEvent language="en_US" name="CoreShowChannelMapComplete">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>18.26.0</version><version>20.11.0</version><version>21.6.0</version><version>22.1.0</version></since>
+ <since>
+ <version>18.26.0</version>
+ <version>20.11.0</version>
+ <version>21.6.0</version>
+ <version>22.1.0</version>
+ </since>
<synopsis>Raised at the end of the CoreShowChannelMap list produced by the CoreShowChannelMap command.</synopsis>
<syntax>
<parameter name="EventList">
</see-also>
</manager>
<function name="AMI_CLIENT" language="en_US">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>
Checks attributes of manager accounts
</synopsis>
</manager>
<managerEvent name="ExtensionStatus" language="en_US">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>18.26.0</version><version>20.11.0</version><version>21.6.0</version><version>22.1.0</version></since>
+ <since>
+ <version>18.26.0</version>
+ <version>20.11.0</version>
+ <version>21.6.0</version>
+ <version>22.1.0</version>
+ </since>
<synopsis>Raised when a hint changes due to a device state change.</synopsis>
<syntax>
<parameter name="Exten">
</managerEvent>
<managerEvent name="PresenceStatus" language="en_US">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>18.26.0</version><version>20.11.0</version><version>21.6.0</version><version>22.1.0</version></since>
+ <since>
+ <version>18.26.0</version>
+ <version>20.11.0</version>
+ <version>21.6.0</version>
+ <version>22.1.0</version>
+ </since>
<synopsis>Raised when a hint changes due to a presence state change.</synopsis>
<syntax>
<parameter name="Exten" />
/*** DOCUMENTATION
<managerEvent language="en_US" name="MessageWaiting">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>16.24.0</version><version>18.10.0</version><version>19.2.0</version></since>
+ <since>
+ <version>16.24.0</version>
+ <version>18.10.0</version>
+ <version>19.2.0</version>
+ </since>
<synopsis>Raised when the state of messages in a voicemail mailbox
has changed or when a channel has finished interacting with a
mailbox.</synopsis>
/*** DOCUMENTATION
<function name="MESSAGE" language="en_US">
- <since><version>10.0.0</version></since>
+ <since>
+ <version>10.0.0</version>
+ </since>
<synopsis>
Create a message or read fields from a message.
</synopsis>
</see-also>
</function>
<function name="MESSAGE_DATA" language="en_US">
- <since><version>10.0.0</version></since>
+ <since>
+ <version>10.0.0</version>
+ </since>
<synopsis>
Read or write custom data attached to a message.
</synopsis>
</see-also>
</function>
<application name="MessageSend" language="en_US">
- <since><version>10.0.0</version></since>
+ <since>
+ <version>10.0.0</version>
+ </since>
<synopsis>
Send a text message.
</synopsis>
<configInfo name="named_acl" language="en_US">
<configFile name="acl.conf">
<configObject name="named_acl">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Options for configuring a named ACL</synopsis>
<configOption name="permit">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>An address/subnet from which to allow access</synopsis>
</configOption>
<configOption name="deny">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>An address/subnet from which to disallow access</synopsis>
</configOption>
</configObject>
/*** DOCUMENTATION
<function name="EXCEPTION" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.0</version>
+ </since>
<synopsis>
Retrieve the details of the current dialplan exception.
</synopsis>
</see-also>
</function>
<function name="TESTTIME" language="en_US">
- <since><version>1.8.0</version></since>
+ <since>
+ <version>1.8.0</version>
+ </since>
<synopsis>
Sets a time to be used with the channel to test logical conditions.
</synopsis>
</list-elements>
<managerEvent name="ExtensionStateListComplete" language="en_US">
<managerEventInstance class="EVENT_FLAG_COMMAND">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>
Indicates the end of the list the current known extension states.
</synopsis>
/*** DOCUMENTATION
<application name="Answer" language="en_US">
- <since><version>13.8.0</version></since>
+ <since>
+ <version>13.8.0</version>
+ </since>
<synopsis>
Answer a channel if ringing.
</synopsis>
</see-also>
</application>
<application name="BackGround" language="en_US">
- <since><version>13.8.0</version></since>
+ <since>
+ <version>13.8.0</version>
+ </since>
<synopsis>
Play an audio file while waiting for digits of an extension to go to.
</synopsis>
</see-also>
</application>
<application name="Busy" language="en_US">
- <since><version>13.8.0</version></since>
+ <since>
+ <version>13.8.0</version>
+ </since>
<synopsis>
Indicate the Busy condition.
</synopsis>
</see-also>
</application>
<application name="Congestion" language="en_US">
- <since><version>13.8.0</version></since>
+ <since>
+ <version>13.8.0</version>
+ </since>
<synopsis>
Indicate the Congestion condition.
</synopsis>
</see-also>
</application>
<application name="ExecIfTime" language="en_US">
- <since><version>13.8.0</version></since>
+ <since>
+ <version>13.8.0</version>
+ </since>
<synopsis>
Conditional application execution based on the current time.
</synopsis>
</see-also>
</application>
<application name="Goto" language="en_US">
- <since><version>13.8.0</version></since>
+ <since>
+ <version>13.8.0</version>
+ </since>
<synopsis>
Jump to a particular priority, extension, or context.
</synopsis>
</see-also>
</application>
<application name="GotoIf" language="en_US">
- <since><version>13.8.0</version></since>
+ <since>
+ <version>13.8.0</version>
+ </since>
<synopsis>
Conditional goto.
</synopsis>
</see-also>
</application>
<application name="GotoIfTime" language="en_US">
- <since><version>13.8.0</version></since>
+ <since>
+ <version>13.8.0</version>
+ </since>
<synopsis>
Conditional Goto based on the current time.
</synopsis>
</see-also>
</application>
<application name="Hangup" language="en_US">
- <since><version>13.8.0</version></since>
+ <since>
+ <version>13.8.0</version>
+ </since>
<synopsis>
Hang up the calling channel.
</synopsis>
</see-also>
</application>
<application name="Incomplete" language="en_US">
- <since><version>13.8.0</version></since>
+ <since>
+ <version>13.8.0</version>
+ </since>
<synopsis>
Returns AST_PBX_INCOMPLETE value.
</synopsis>
</description>
</application>
<application name="NoOp" language="en_US">
- <since><version>13.8.0</version></since>
+ <since>
+ <version>13.8.0</version>
+ </since>
<synopsis>
Do Nothing (No Operation).
</synopsis>
</see-also>
</application>
<application name="Proceeding" language="en_US">
- <since><version>13.8.0</version></since>
+ <since>
+ <version>13.8.0</version>
+ </since>
<synopsis>
Indicate proceeding.
</synopsis>
</description>
</application>
<application name="Progress" language="en_US">
- <since><version>13.8.0</version></since>
+ <since>
+ <version>13.8.0</version>
+ </since>
<synopsis>
Indicate progress.
</synopsis>
</see-also>
</application>
<application name="RaiseException" language="en_US">
- <since><version>13.8.0</version></since>
+ <since>
+ <version>13.8.0</version>
+ </since>
<synopsis>
Handle an exceptional condition.
</synopsis>
</see-also>
</application>
<application name="Ringing" language="en_US">
- <since><version>13.8.0</version></since>
+ <since>
+ <version>13.8.0</version>
+ </since>
<synopsis>
Indicate ringing tone.
</synopsis>
</see-also>
</application>
<application name="SayAlpha" language="en_US">
- <since><version>13.8.0</version></since>
+ <since>
+ <version>13.8.0</version>
+ </since>
<synopsis>
Say Alpha.
</synopsis>
</see-also>
</application>
<application name="SayAlphaCase" language="en_US">
- <since><version>13.8.0</version></since>
+ <since>
+ <version>13.8.0</version>
+ </since>
<synopsis>
Say Alpha.
</synopsis>
</see-also>
</application>
<application name="SayDigits" language="en_US">
- <since><version>13.8.0</version></since>
+ <since>
+ <version>13.8.0</version>
+ </since>
<synopsis>
Say Digits.
</synopsis>
</see-also>
</application>
<application name="SayMoney" language="en_US">
- <since><version>16.21.0</version><version>18.7.0</version></since>
+ <since>
+ <version>16.21.0</version>
+ <version>18.7.0</version>
+ </since>
<synopsis>
Say Money.
</synopsis>
</see-also>
</application>
<application name="SayNumber" language="en_US">
- <since><version>13.8.0</version></since>
+ <since>
+ <version>13.8.0</version>
+ </since>
<synopsis>
Say Number.
</synopsis>
</see-also>
</application>
<application name="SayOrdinal" language="en_US">
- <since><version>16.21.0</version><version>18.7.0</version></since>
+ <since>
+ <version>16.21.0</version>
+ <version>18.7.0</version>
+ </since>
<synopsis>
Say Ordinal Number.
</synopsis>
</see-also>
</application>
<application name="SayPhonetic" language="en_US">
- <since><version>13.8.0</version></since>
+ <since>
+ <version>13.8.0</version>
+ </since>
<synopsis>
Say Phonetic.
</synopsis>
</see-also>
</application>
<application name="Wait" language="en_US">
- <since><version>13.8.0</version></since>
+ <since>
+ <version>13.8.0</version>
+ </since>
<synopsis>
Waits for some time.
</synopsis>
</description>
</application>
<application name="WaitDigit" language="en_US">
- <since><version>15.0.0</version></since>
+ <since>
+ <version>15.0.0</version>
+ </since>
<synopsis>
Waits for a digit to be entered.
</synopsis>
</see-also>
</application>
<application name="WaitExten" language="en_US">
- <since><version>13.8.0</version></since>
+ <since>
+ <version>13.8.0</version>
+ </since>
<synopsis>
Waits for an extension to be entered.
</synopsis>
/*** DOCUMENTATION
<application name="Set" language="en_US">
- <since><version>13.8.0</version></since>
+ <since>
+ <version>13.8.0</version>
+ </since>
<synopsis>
Set channel variable or function value.
</synopsis>
</see-also>
</application>
<application name="MSet" language="en_US">
- <since><version>13.8.0</version></since>
+ <since>
+ <version>13.8.0</version>
+ </since>
<synopsis>
Set channel variable(s) or function value(s).
</synopsis>
/*** DOCUMENTATION
<managerEvent language="en_US" name="Pickup">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a call pickup occurs.</synopsis>
<syntax>
<channel_snapshot/>
/*** DOCUMENTATION
<managerEvent language="en_US" name="PresenceStateChange">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>Raised when a presence state changes</synopsis>
<syntax>
<parameter name="Presentity">
/*** DOCUMENTATION
<managerEvent language="en_US" name="RTCPSent">
<managerEventInstance class="EVENT_FLAG_REPORTING">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when an RTCP packet is sent.</synopsis>
<syntax>
<channel_snapshot/>
</managerEvent>
<managerEvent language="en_US" name="RTCPReceived">
<managerEventInstance class="EVENT_FLAG_REPORTING">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when an RTCP packet is received.</synopsis>
<syntax>
<channel_snapshot/>
/*** DOCUMENTATION
<managerEvent language="en_US" name="FailedACL">
<managerEventInstance class="EVENT_FLAG_SECURITY">
- <since><version>12.1.0</version></since>
+ <since>
+ <version>12.1.0</version>
+ </since>
<synopsis>Raised when a request violates an ACL check.</synopsis>
<syntax>
<parameter name="EventTV">
</managerEvent>
<managerEvent language="en_US" name="InvalidAccountID">
<managerEventInstance class="EVENT_FLAG_SECURITY">
- <since><version>12.1.0</version></since>
+ <since>
+ <version>12.1.0</version>
+ </since>
<synopsis>Raised when a request fails an authentication check due to an invalid account ID.</synopsis>
<syntax>
<xi:include xpointer="xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventTV'])" />
</managerEvent>
<managerEvent language="en_US" name="SessionLimit">
<managerEventInstance class="EVENT_FLAG_SECURITY">
- <since><version>12.1.0</version></since>
+ <since>
+ <version>12.1.0</version>
+ </since>
<synopsis>Raised when a request fails due to exceeding the number of allowed concurrent sessions for that service.</synopsis>
<syntax>
<xi:include xpointer="xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventTV'])" />
</managerEvent>
<managerEvent language="en_US" name="MemoryLimit">
<managerEventInstance class="EVENT_FLAG_SECURITY">
- <since><version>12.1.0</version></since>
+ <since>
+ <version>12.1.0</version>
+ </since>
<synopsis>Raised when a request fails due to an internal memory allocation failure.</synopsis>
<syntax>
<xi:include xpointer="xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventTV'])" />
</managerEvent>
<managerEvent language="en_US" name="LoadAverageLimit">
<managerEventInstance class="EVENT_FLAG_SECURITY">
- <since><version>12.1.0</version></since>
+ <since>
+ <version>12.1.0</version>
+ </since>
<synopsis>Raised when a request fails because a configured load average limit has been reached.</synopsis>
<syntax>
<xi:include xpointer="xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventTV'])" />
</managerEvent>
<managerEvent language="en_US" name="RequestNotSupported">
<managerEventInstance class="EVENT_FLAG_SECURITY">
- <since><version>12.1.0</version></since>
+ <since>
+ <version>12.1.0</version>
+ </since>
<synopsis>Raised when a request fails due to some aspect of the requested item not being supported by the service.</synopsis>
<syntax>
<xi:include xpointer="xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventTV'])" />
</managerEvent>
<managerEvent language="en_US" name="RequestNotAllowed">
<managerEventInstance class="EVENT_FLAG_SECURITY">
- <since><version>12.1.0</version></since>
+ <since>
+ <version>12.1.0</version>
+ </since>
<synopsis>Raised when a request is not allowed by the service.</synopsis>
<syntax>
<xi:include xpointer="xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventTV'])" />
</managerEvent>
<managerEvent language="en_US" name="AuthMethodNotAllowed">
<managerEventInstance class="EVENT_FLAG_SECURITY">
- <since><version>12.1.0</version></since>
+ <since>
+ <version>12.1.0</version>
+ </since>
<synopsis>Raised when a request used an authentication method not allowed by the service.</synopsis>
<syntax>
<xi:include xpointer="xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventTV'])" />
</managerEvent>
<managerEvent language="en_US" name="RequestBadFormat">
<managerEventInstance class="EVENT_FLAG_SECURITY">
- <since><version>12.1.0</version></since>
+ <since>
+ <version>12.1.0</version>
+ </since>
<synopsis>Raised when a request is received with bad formatting.</synopsis>
<syntax>
<xi:include xpointer="xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventTV'])" />
</managerEvent>
<managerEvent language="en_US" name="SuccessfulAuth">
<managerEventInstance class="EVENT_FLAG_SECURITY">
- <since><version>12.1.0</version></since>
+ <since>
+ <version>12.1.0</version>
+ </since>
<synopsis>Raised when a request successfully authenticates with a service.</synopsis>
<syntax>
<xi:include xpointer="xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventTV'])" />
</managerEvent>
<managerEvent language="en_US" name="UnexpectedAddress">
<managerEventInstance class="EVENT_FLAG_SECURITY">
- <since><version>12.1.0</version></since>
+ <since>
+ <version>12.1.0</version>
+ </since>
<synopsis>Raised when a request has a different source address then what is expected for a session already in progress with a service.</synopsis>
<syntax>
<xi:include xpointer="xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventTV'])" />
</managerEvent>
<managerEvent language="en_US" name="ChallengeResponseFailed">
<managerEventInstance class="EVENT_FLAG_SECURITY">
- <since><version>12.1.0</version></since>
+ <since>
+ <version>12.1.0</version>
+ </since>
<synopsis>Raised when a request's attempt to authenticate has been challenged, and the request failed the authentication challenge.</synopsis>
<syntax>
<xi:include xpointer="xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventTV'])" />
</managerEvent>
<managerEvent language="en_US" name="InvalidPassword">
<managerEventInstance class="EVENT_FLAG_SECURITY">
- <since><version>12.1.0</version></since>
+ <since>
+ <version>12.1.0</version>
+ </since>
<synopsis>Raised when a request provides an invalid password during an authentication attempt.</synopsis>
<syntax>
<xi:include xpointer="xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventTV'])" />
</managerEvent>
<managerEvent language="en_US" name="ChallengeSent">
<managerEventInstance class="EVENT_FLAG_SECURITY">
- <since><version>12.1.0</version></since>
+ <since>
+ <version>12.1.0</version>
+ </since>
<synopsis>Raised when an Asterisk service sends an authentication challenge to a request.</synopsis>
<syntax>
<xi:include xpointer="xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventTV'])" />
</managerEvent>
<managerEvent language="en_US" name="InvalidTransport">
<managerEventInstance class="EVENT_FLAG_SECURITY">
- <since><version>12.1.0</version></since>
+ <since>
+ <version>12.1.0</version>
+ </since>
<synopsis>Raised when a request attempts to use a transport not allowed by the Asterisk service.</synopsis>
<syntax>
<xi:include xpointer="xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventTV'])" />
/*** DOCUMENTATION
<managerEvent language="en_US" name="UserEvent">
<managerEventInstance class="EVENT_FLAG_USER">
- <since><version>12.3.0</version></since>
+ <since>
+ <version>12.3.0</version>
+ </since>
<synopsis>A user defined event raised from the dialplan.</synopsis>
<syntax>
<channel_snapshot/>
<configInfo name="stasis" language="en_US">
<configFile name="stasis.conf">
<configObject name="threadpool">
- <since><version>12.8.0</version><version>13.1.0</version></since>
+ <since>
+ <version>12.8.0</version>
+ <version>13.1.0</version>
+ </since>
<synopsis>Settings that configure the threadpool Stasis uses to deliver some messages.</synopsis>
<configOption name="initial_size" default="5">
- <since><version>12.8.0</version><version>13.1.0</version></since>
+ <since>
+ <version>12.8.0</version>
+ <version>13.1.0</version>
+ </since>
<synopsis>Initial number of threads in the message bus threadpool.</synopsis>
</configOption>
<configOption name="idle_timeout_sec" default="20">
- <since><version>12.8.0</version><version>13.1.0</version></since>
+ <since>
+ <version>12.8.0</version>
+ <version>13.1.0</version>
+ </since>
<synopsis>Number of seconds before an idle thread is disposed of.</synopsis>
</configOption>
<configOption name="max_size" default="50">
- <since><version>12.8.0</version><version>13.1.0</version></since>
+ <since>
+ <version>12.8.0</version>
+ <version>13.1.0</version>
+ </since>
<synopsis>Maximum number of threads in the threadpool.</synopsis>
</configOption>
</configObject>
<configObject name="declined_message_types">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>Stasis message types for which to decline creation.</synopsis>
<configOption name="decline">
- <since><version>12.8.0</version><version>13.1.0</version></since>
+ <since>
+ <version>12.8.0</version>
+ <version>13.1.0</version>
+ </since>
<synopsis>The message type to decline.</synopsis>
<description>
<para>This configuration option defines the name of the Stasis
/*** DOCUMENTATION
<managerEvent language="en_US" name="BlindTransfer">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a blind transfer is complete.</synopsis>
<syntax>
<parameter name="Result">
</managerEvent>
<managerEvent language="en_US" name="AttendedTransfer">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when an attended transfer is complete.</synopsis>
<syntax>
<xi:include xpointer="xpointer(docs/managerEvent[@name='BlindTransfer']/managerEventInstance/syntax/parameter[@name='Result'])" />
/*** DOCUMENTATION
<managerEvent language="en_US" name="VarSet">
<managerEventInstance class="EVENT_FLAG_DIALPLAN">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a variable is set to a particular value.</synopsis>
<syntax>
<channel_snapshot/>
</managerEvent>
<managerEvent language="en_US" name="AgentLogin">
<managerEventInstance class="EVENT_FLAG_AGENT">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when an Agent has logged in.</synopsis>
<syntax>
<channel_snapshot/>
</managerEvent>
<managerEvent language="en_US" name="AgentLogoff">
<managerEventInstance class="EVENT_FLAG_AGENT">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when an Agent has logged off.</synopsis>
<syntax>
<xi:include xpointer="xpointer(/docs/managerEvent[@name='AgentLogin']/managerEventInstance/syntax/parameter)" />
</managerEvent>
<managerEvent language="en_US" name="ChannelTalkingStart">
<managerEventInstance class="EVENT_FLAG_CLASS">
- <since><version>12.4.0</version></since>
+ <since>
+ <version>12.4.0</version>
+ </since>
<synopsis>Raised when talking is detected on a channel.</synopsis>
<syntax>
<channel_snapshot/>
</managerEvent>
<managerEvent language="en_US" name="ChannelTalkingStop">
<managerEventInstance class="EVENT_FLAG_CLASS">
- <since><version>12.4.0</version></since>
+ <since>
+ <version>12.4.0</version>
+ </since>
<synopsis>Raised when talking is no longer detected on a channel.</synopsis>
<syntax>
<channel_snapshot/>
/*** DOCUMENTATION
<managerEvent language="en_US" name="PeerStatus">
<managerEventInstance class="EVENT_FLAG_SYSTEM">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when the state of a peer changes.</synopsis>
<syntax>
<parameter name="ChannelType">
</managerEvent>
<managerEvent language="en_US" name="ContactStatus">
<managerEventInstance class="EVENT_FLAG_SYSTEM">
- <since><version>13.5.0</version></since>
+ <since>
+ <version>13.5.0</version>
+ </since>
<synopsis>Raised when the state of a contact changes.</synopsis>
<syntax>
<parameter name="URI">
/*** DOCUMENTATION
<managerEvent language="en_US" name="Registry">
<managerEventInstance class="EVENT_FLAG_SYSTEM">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when an outbound registration completes.</synopsis>
<syntax>
<parameter name="ChannelType">
<configInfo name="udptl" language="en_US">
<configFile name="udptl.conf">
<configObject name="global">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Global options for configuring UDPTL</synopsis>
<configOption name="udptlstart">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>The start of the UDPTL port range</synopsis>
</configOption>
<configOption name="udptlend">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>The end of the UDPTL port range</synopsis>
</configOption>
<configOption name="udptlchecksums">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Whether to enable or disable UDP checksums on UDPTL traffic</synopsis>
</configOption>
<configOption name="udptlfecentries">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>The number of error correction entries in a UDPTL packet</synopsis>
</configOption>
<configOption name="udptlfecspan">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>The span over which parity is calculated for FEC in a UDPTL packet</synopsis>
</configOption>
<configOption name="use_even_ports">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Whether to only use even-numbered UDPTL ports</synopsis>
</configOption>
<configOption name="t38faxudpec">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Removed</synopsis>
</configOption>
<configOption name="t38faxmaxdatagram">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Removed</synopsis>
</configOption>
</configObject>
/*** DOCUMENTATION
<application name="AELSub" language="en_US">
- <since><version>10.0.0</version></since>
+ <since>
+ <version>10.0.0</version>
+ </since>
<synopsis>
Launch subroutine built with AEL
</synopsis>
/*** DOCUMENTATION
<function name="DUNDILOOKUP" language="en_US">
- <since><version>1.8.0</version></since>
+ <since>
+ <version>1.8.0</version>
+ </since>
<synopsis>
Do a DUNDi lookup of a phone number.
</synopsis>
<function name="DUNDIQUERY" language="en_US">
- <since><version>1.8.0</version></since>
+ <since>
+ <version>1.8.0</version>
+ </since>
<synopsis>
Initiate a DUNDi query.
</synopsis>
</function>
<function name="DUNDIRESULT" language="en_US">
- <since><version>1.8.0</version></since>
+ <since>
+ <version>1.8.0</version>
+ </since>
<synopsis>
Retrieve results from a DUNDIQUERY.
</synopsis>
/*** DOCUMENTATION
<application name="Park" language="en_US">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>
Park yourself.
</synopsis>
</application>
<application name="ParkedCall" language="en_US">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>
Retrieve a parked call.
</synopsis>
</application>
<application name="ParkAndAnnounce" language="en_US">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>
Park and Announce.
</synopsis>
/*** DOCUMENTATION
<function name="PARK_GET_CHANNEL" language="en_US">
- <since><version>16.0.0</version></since>
+ <since>
+ <version>16.0.0</version>
+ </since>
<synopsis>
Get the channel name of an occupied parking space in a parking lot.
</synopsis>
</manager>
<managerEvent language="en_US" name="ParkedCall">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a channel is parked.</synopsis>
<syntax>
<channel_snapshot prefix="Parkee"/>
</managerEvent>
<managerEvent language="en_US" name="ParkedCallTimeOut">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a channel leaves a parking lot due to reaching the time limit of being parked.</synopsis>
<syntax>
<channel_snapshot prefix="Parkee"/>
</managerEvent>
<managerEvent language="en_US" name="ParkedCallGiveUp">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a channel leaves a parking lot because it hung up without being answered.</synopsis>
<syntax>
<channel_snapshot prefix="Parkee"/>
</managerEvent>
<managerEvent language="en_US" name="UnParkedCall">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a channel leaves a parking lot because it was retrieved from the parking lot and reconnected.</synopsis>
<syntax>
<channel_snapshot prefix="Parkee"/>
</managerEvent>
<managerEvent language="en_US" name="ParkedCallSwap">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>13.5.0</version></since>
+ <since>
+ <version>13.5.0</version>
+ </since>
<synopsis>Raised when a channel takes the place of a previously parked channel</synopsis>
<syntax>
<channel_snapshot prefix="Parkee"/>
<synopsis>Asterisk External Application Protocol (AEAP) module for Asterisk</synopsis>
<configFile name="aeap.conf">
<configObject name="client">
- <since><version>18.12.0</version><version>19.4.0</version></since>
+ <since>
+ <version>18.12.0</version>
+ <version>19.4.0</version>
+ </since>
<synopsis>AEAP client options</synopsis>
<configOption name="type">
- <since><version>18.12.0</version><version>19.4.0</version></since>
+ <since>
+ <version>18.12.0</version>
+ <version>19.4.0</version>
+ </since>
<synopsis>Must be of type 'client'.</synopsis>
</configOption>
<configOption name="url">
- <since><version>18.12.0</version><version>19.4.0</version></since>
+ <since>
+ <version>18.12.0</version>
+ <version>19.4.0</version>
+ </since>
<synopsis>The URL of the server to connect to.</synopsis>
</configOption>
<configOption name="protocol">
- <since><version>18.12.0</version><version>19.4.0</version></since>
+ <since>
+ <version>18.12.0</version>
+ <version>19.4.0</version>
+ </since>
<synopsis>The application protocol.</synopsis>
</configOption>
<configOption name="codecs">
- <since><version>18.12.0</version><version>19.4.0</version></since>
+ <since>
+ <version>18.12.0</version>
+ <version>19.4.0</version>
+ </since>
<synopsis>Optional media codec(s)</synopsis>
<description><para>
If this is specified, Asterisk will use this for codec related negotiations
</see-also>
</agi>
<application name="AGI" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>0.1.9</version>
+ </since>
<synopsis>
Executes an AGI compliant application.
</synopsis>
</see-also>
</application>
<application name="EAGI" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>0.4.0</version>
+ </since>
<synopsis>
Executes an EAGI compliant application.
</synopsis>
</see-also>
</application>
<application name="DeadAGI" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.0.0</version>
+ </since>
<synopsis>
Executes AGI on a hungup channel.
</synopsis>
</manager>
<managerEvent language="en_US" name="AsyncAGIStart">
<managerEventInstance class="EVENT_FLAG_AGI">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a channel starts AsyncAGI command processing.</synopsis>
<syntax>
<channel_snapshot/>
</managerEvent>
<managerEvent language="en_US" name="AsyncAGIEnd">
<managerEventInstance class="EVENT_FLAG_AGI">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a channel stops AsyncAGI command processing.</synopsis>
<syntax>
<channel_snapshot/>
</managerEvent>
<managerEvent language="en_US" name="AsyncAGIExec">
<managerEventInstance class="EVENT_FLAG_AGI">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when AsyncAGI completes an AGI command.</synopsis>
<syntax>
<channel_snapshot/>
</managerEvent>
<managerEvent language="en_US" name="AGIExecStart">
<managerEventInstance class="EVENT_FLAG_AGI">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a received AGI command starts processing.</synopsis>
<syntax>
<channel_snapshot/>
</managerEvent>
<managerEvent language="en_US" name="AGIExecEnd">
<managerEventInstance class="EVENT_FLAG_AGI">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Raised when a received AGI command completes processing.</synopsis>
<syntax>
<channel_snapshot/>
<synopsis>HTTP binding for the Stasis API</synopsis>
<configFile name="ari.conf">
<configObject name="general">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>General configuration settings</synopsis>
<configOption name="enabled">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Enable/disable the ARI module</synopsis>
<description>
<para>This option enables or disables the ARI module.</para>
</see-also>
</configOption>
<configOption name="websocket_write_timeout" default="100">
- <since><version>11.11.0</version><version>12.4.0</version></since>
+ <since>
+ <version>11.11.0</version>
+ <version>12.4.0</version>
+ </since>
<synopsis>The timeout (in milliseconds) to set on WebSocket connections.</synopsis>
<description>
<para>If a websocket connection accepts input slowly, the timeout
</description>
</configOption>
<configOption name="pretty">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Responses from ARI are formatted to be human readable</synopsis>
</configOption>
<configOption name="auth_realm">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Realm to use for authentication. Defaults to Asterisk REST Interface.</synopsis>
</configOption>
<configOption name="allowed_origins">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Comma separated list of allowed origins, for Cross-Origin Resource Sharing. May be set to * to allow all origins.</synopsis>
</configOption>
<configOption name="channelvars">
- <since><version>14.2.0</version></since>
+ <since>
+ <version>14.2.0</version>
+ </since>
<synopsis>Comma separated list of channel variables to display in channel json.</synopsis>
</configOption>
</configObject>
<configObject name="user">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Per-user configuration settings</synopsis>
<configOption name="type">
- <since><version>13.30.0</version><version>16.7.0</version><version>17.1.0</version></since>
+ <since>
+ <version>13.30.0</version>
+ <version>16.7.0</version>
+ <version>17.1.0</version>
+ </since>
<synopsis>Define this configuration section as a user.</synopsis>
<description>
<enumlist>
</description>
</configOption>
<configOption name="read_only">
- <since><version>13.30.0</version><version>16.7.0</version><version>17.1.0</version></since>
+ <since>
+ <version>13.30.0</version>
+ <version>16.7.0</version>
+ <version>17.1.0</version>
+ </since>
<synopsis>When set to yes, user is only authorized for read-only requests</synopsis>
</configOption>
<configOption name="password">
- <since><version>13.30.0</version><version>16.7.0</version><version>17.1.0</version></since>
+ <since>
+ <version>13.30.0</version>
+ <version>16.7.0</version>
+ <version>17.1.0</version>
+ </since>
<synopsis>Crypted or plaintext password (see password_format)</synopsis>
</configOption>
<configOption name="password_format">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>password_format may be set to plain (the default) or crypt. When set to crypt, crypt(3) is used to validate the password. A crypted password can be generated using mkpasswd -m sha-512. When set to plain, the password is in plaintext</synopsis>
</configOption>
</configObject>
/*** DOCUMENTATION
<function name="CALENDAR_BUSY" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.8.0</version>
+ </since>
<synopsis>
Determine if the calendar is marked busy at this time.
</synopsis>
</see-also>
</function>
<function name="CALENDAR_EVENT" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.8.0</version>
+ </since>
<synopsis>
Get calendar event notification data from a notification call.
</synopsis>
</see-also>
</function>
<function name="CALENDAR_QUERY" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.8.0</version>
+ </since>
<synopsis>Query a calendar server and store the data on a channel
</synopsis>
<syntax>
</see-also>
</function>
<function name="CALENDAR_QUERY_RESULT" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.8.0</version>
+ </since>
<synopsis>
Retrieve data from a previously run CALENDAR_QUERY() call
</synopsis>
</see-also>
</function>
<function name="CALENDAR_WRITE" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.8.0</version>
+ </since>
<synopsis>Write an event to a calendar</synopsis>
<syntax>
<parameter name="calendar" required="true">
/*** DOCUMENTATION
<application name="ReceiveFAX" language="en_US" module="res_fax">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>
Receive a FAX and save as a TIFF/F file.
</synopsis>
</see-also>
</application>
<application name="SendFAX" language="en_US" module="res_fax">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>
Sends a specified TIFF/F file as a FAX.
</synopsis>
</see-also>
</application>
<function name="FAXOPT" language="en_US" module="res_fax">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>
Gets/sets various pieces of information about a fax session.
</synopsis>
</manager>
<managerEvent language="en_US" name="FAXSessionsEntry">
<managerEventInstance class="EVENT_FLAG_REPORTING">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>A single list item for the FAXSessions AMI command</synopsis>
<syntax>
<parameter name="ActionID" required="false"/>
</managerEvent>
<managerEvent language="en_US" name="FAXSessionsComplete">
<managerEventInstance class="EVENT_FLAG_CALL">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>Raised when all FAXSession events are completed for a FAXSessions command</synopsis>
<syntax>
<parameter name="ActionID" required="false"/>
</manager>
<managerEvent language="en_US" name="FAXSession">
<managerEventInstance class="EVENT_FLAG_REPORTING">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>Raised in response to FAXSession manager command</synopsis>
<syntax>
<parameter name="ActionID" required="false"/>
</manager>
<managerEvent language="en_US" name="FAXStats">
<managerEventInstance class="EVENT_FLAG_REPORTING">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>Raised in response to FAXStats manager command</synopsis>
<syntax>
<parameter name="ActionID" required="false"/>
<synopsis>Core Geolocation Support</synopsis>
<configFile name="geolocation.conf">
<configObject name="location">
- <since><version>16.29.0</version><version>18.15.0</version><version>19.7.0</version></since>
+ <since>
+ <version>16.29.0</version>
+ <version>18.15.0</version>
+ <version>19.7.0</version>
+ </since>
<synopsis>Location</synopsis>
<description>
<para>Parameters for defining a Location object</para>
</description>
<configOption name="type">
- <since><version>16.28.0</version><version>18.14.0</version><version>19.6.0</version></since>
+ <since>
+ <version>16.28.0</version>
+ <version>18.14.0</version>
+ <version>19.6.0</version>
+ </since>
<synopsis>Must be of type 'location'.</synopsis>
</configOption>
<configOption name="format" default="none">
- <since><version>16.28.0</version><version>18.14.0</version><version>19.6.0</version></since>
+ <since>
+ <version>16.28.0</version>
+ <version>18.14.0</version>
+ <version>19.6.0</version>
+ </since>
<synopsis>Location specification type</synopsis>
<description>
<enumlist>
</configOption>
<configOption name="location_info" default="none">
- <since><version>16.28.0</version><version>18.14.0</version><version>19.6.0</version></since>
+ <since>
+ <version>16.28.0</version>
+ <version>18.14.0</version>
+ <version>19.6.0</version>
+ </since>
<synopsis>Location information</synopsis>
<description>
<para>The contents of this parameter are specific to the
</configOption>
<configOption name="location_source" default="none">
- <since><version>16.28.0</version><version>18.14.0</version><version>19.6.0</version></since>
+ <since>
+ <version>16.28.0</version>
+ <version>18.14.0</version>
+ <version>19.6.0</version>
+ </since>
<synopsis>Fully qualified host name</synopsis>
<description>
<para>This parameter isn't required but if provided, RFC8787 says it MUST be a fully
</configOption>
<configOption name="method" default="none">
- <since><version>16.28.0</version><version>18.14.0</version><version>19.6.0</version></since>
+ <since>
+ <version>16.28.0</version>
+ <version>18.14.0</version>
+ <version>19.6.0</version>
+ </since>
<synopsis>Location determination method</synopsis>
<description>
<para>This is a rarely used field in the specification that would
</configOption>
<configOption name="confidence" default="none">
- <since><version>16.28.0</version><version>18.14.0</version><version>19.6.0</version></since>
+ <since>
+ <version>16.28.0</version>
+ <version>18.14.0</version>
+ <version>19.6.0</version>
+ </since>
<synopsis>Level of confidence</synopsis>
<description>
<para>This is a rarely used field in the specification that would
</configObject>
<configObject name="profile">
- <since><version>16.29.0</version><version>18.15.0</version><version>19.7.0</version></since>
+ <since>
+ <version>16.29.0</version>
+ <version>18.15.0</version>
+ <version>19.7.0</version>
+ </since>
<synopsis>Profile</synopsis>
<description>
<para>Parameters for defining a Profile object</para>
</description>
<configOption name="type">
- <since><version>16.28.0</version><version>18.14.0</version><version>19.6.0</version></since>
+ <since>
+ <version>16.28.0</version>
+ <version>18.14.0</version>
+ <version>19.6.0</version>
+ </since>
<synopsis>Must be of type 'profile'.</synopsis>
</configOption>
<configOption name="pidf_element" default="device">
- <since><version>16.28.0</version><version>18.14.0</version><version>19.6.0</version></since>
+ <since>
+ <version>16.28.0</version>
+ <version>18.14.0</version>
+ <version>19.6.0</version>
+ </since>
<synopsis>PIDF-LO element to place this profile in</synopsis>
<description>
<enumlist>
</configOption>
<configOption name="location_reference" default="none">
- <since><version>16.28.0</version><version>18.14.0</version><version>19.6.0</version></since>
+ <since>
+ <version>16.28.0</version>
+ <version>18.14.0</version>
+ <version>19.6.0</version>
+ </since>
<synopsis>Reference to a location object</synopsis>
</configOption>
<configOption name="location_info_refinement" default="none">
- <since><version>16.28.0</version><version>18.14.0</version><version>19.6.0</version></since>
+ <since>
+ <version>16.28.0</version>
+ <version>18.14.0</version>
+ <version>19.6.0</version>
+ </since>
<synopsis>Reference to a location object</synopsis>
</configOption>
<configOption name="location_variables" default="none">
- <since><version>16.28.0</version><version>18.14.0</version><version>19.6.0</version></since>
+ <since>
+ <version>16.28.0</version>
+ <version>18.14.0</version>
+ <version>19.6.0</version>
+ </since>
<synopsis>Reference to a location object</synopsis>
</configOption>
<configOption name="usage_rules" default="empty <usage_rules> element">
- <since><version>16.28.0</version><version>18.14.0</version><version>19.6.0</version></since>
+ <since>
+ <version>16.28.0</version>
+ <version>18.14.0</version>
+ <version>19.6.0</version>
+ </since>
<synopsis>location specification type</synopsis>
<description>
<para>xxxx</para>
</configOption>
<configOption name="notes" default="">
- <since><version>16.28.0</version><version>18.14.0</version><version>19.6.0</version></since>
+ <since>
+ <version>16.28.0</version>
+ <version>18.14.0</version>
+ <version>19.6.0</version>
+ </since>
<synopsis>Notes to be added to the outgoing PIDF-LO document</synopsis>
<description>
<para>The specification of this parameter will cause a
</configOption>
<configOption name="allow_routing_use" default="no">
- <since><version>16.28.0</version><version>18.14.0</version><version>19.6.0</version></since>
+ <since>
+ <version>16.28.0</version>
+ <version>18.14.0</version>
+ <version>19.6.0</version>
+ </since>
<synopsis>Sets the value of the Geolocation-Routing header.</synopsis>
</configOption>
<configOption name="suppress_empty_ca_elements" default="no">
- <since><version>16.29.0</version><version>18.15.0</version><version>19.7.0</version></since>
+ <since>
+ <version>16.29.0</version>
+ <version>18.15.0</version>
+ <version>19.7.0</version>
+ </since>
<synopsis>Sets if empty Civic Address elements should be suppressed
from the PIDF-LO document.</synopsis>
</configOption>
<configOption name="profile_precedence" default="discard_incoming">
- <since><version>16.28.0</version><version>18.14.0</version><version>19.6.0</version></since>
+ <since>
+ <version>16.28.0</version>
+ <version>18.14.0</version>
+ <version>19.6.0</version>
+ </since>
<synopsis>Determine which profile on a channel should be used</synopsis>
<description>
<enumlist>
</configFile>
</configInfo>
<function name="GEOLOC_PROFILE" language="en_US">
- <since><version>16.28.0</version><version>18.14.0</version><version>19.6.0</version></since>
+ <since>
+ <version>16.28.0</version>
+ <version>18.14.0</version>
+ <version>19.6.0</version>
+ </since>
<synopsis>
Get or Set a field in a geolocation profile
</synopsis>
<synopsis>Resource for integration with Homer using HEPv3</synopsis>
<configFile name="hep.conf">
<configObject name="general">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>General settings.</synopsis>
<description><para>
The <emphasis>general</emphasis> settings section contains information
</para>
</description>
<configOption name="enabled" default="yes">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>Enable or disable packet capturing.</synopsis>
<description>
<enumlist>
</description>
</configOption>
<configOption name="uuid_type" default="call-id">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>The preferred type of UUID to pass to Homer.</synopsis>
<description>
<enumlist>
</description>
</configOption>
<configOption name="capture_address">
- <since><version>13.16.0</version><version>14.5.0</version></since>
+ <since>
+ <version>13.16.0</version>
+ <version>14.5.0</version>
+ </since>
<synopsis>The address and port of the Homer server to send packets to.</synopsis>
</configOption>
<configOption name="capture_password">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>If set, the authentication password to send to Homer.</synopsis>
</configOption>
<configOption name="capture_id" default="0">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>The ID for this capture agent.</synopsis>
</configOption>
<configOption name="capture_name" default="">
- <since><version>18.16.0</version><version>20.1.0</version></since>
+ <since>
+ <version>18.16.0</version>
+ <version>20.1.0</version>
+ </since>
<synopsis>The name for this capture agent.</synopsis>
</configOption>
</configObject>
<synopsis>HTTP media cache</synopsis>
<configFile name="res_http_media_cache.conf">
<configObject name="general">
- <since><version>18.18.0</version><version>20.3.0</version></since>
+ <since>
+ <version>18.18.0</version>
+ <version>20.3.0</version>
+ </since>
<synopsis>General configuration</synopsis>
<configOption name="timeout_secs" default="180">
- <since><version>18.18.0</version><version>20.3.0</version></since>
+ <since>
+ <version>18.18.0</version>
+ <version>20.3.0</version>
+ </since>
<synopsis>The maximum time the transfer is allowed to complete in seconds. See https://curl.se/libcurl/c/CURLOPT_TIMEOUT.html for details.</synopsis>
</configOption>
<configOption name="user_agent">
- <since><version>18.18.0</version><version>20.3.0</version></since>
+ <since>
+ <version>18.18.0</version>
+ <version>20.3.0</version>
+ </since>
<synopsis>The HTTP User-Agent to use for requests. See https://curl.se/libcurl/c/CURLOPT_USERAGENT.html for details.</synopsis>
</configOption>
<configOption name="follow_location" default="1">
- <since><version>18.18.0</version><version>20.3.0</version></since>
+ <since>
+ <version>18.18.0</version>
+ <version>20.3.0</version>
+ </since>
<synopsis>Follow HTTP 3xx redirects on requests. See https://curl.se/libcurl/c/CURLOPT_FOLLOWLOCATION.html for details.</synopsis>
</configOption>
<configOption name="max_redirects" default="8">
- <since><version>18.18.0</version><version>20.3.0</version></since>
+ <since>
+ <version>18.18.0</version>
+ <version>20.3.0</version>
+ </since>
<synopsis>The maximum number of redirects to follow. See https://curl.se/libcurl/c/CURLOPT_MAXREDIRS.html for details.</synopsis>
</configOption>
<configOption name="proxy">
- <since><version>18.18.0</version><version>20.3.0</version></since>
+ <since>
+ <version>18.18.0</version>
+ <version>20.3.0</version>
+ </since>
<synopsis>The proxy to use for requests. See https://curl.se/libcurl/c/CURLOPT_PROXY.html for details.</synopsis>
</configOption>
<configOption name="protocols">
- <since><version>18.18.0</version><version>20.3.0</version></since>
+ <since>
+ <version>18.18.0</version>
+ <version>20.3.0</version>
+ </since>
<synopsis>The comma separated list of allowed protocols for the request. Available with cURL 7.85.0 or later. See https://curl.se/libcurl/c/CURLOPT_PROTOCOLS_STR.html for details.</synopsis>
</configOption>
<configOption name="redirect_protocols">
- <since><version>18.18.0</version><version>20.3.0</version></since>
+ <since>
+ <version>18.18.0</version>
+ <version>20.3.0</version>
+ </since>
<synopsis>The comma separated list of allowed protocols for redirects. Available with cURL 7.85.0 or later. See https://curl.se/libcurl/c/CURLOPT_REDIR_PROTOCOLS_STR.html for details.</synopsis>
</configOption>
<configOption name="dns_cache_timeout_secs" default="60">
- <since><version>18.18.0</version><version>20.3.0</version></since>
+ <since>
+ <version>18.18.0</version>
+ <version>20.3.0</version>
+ </since>
<synopsis>The life-time for DNS cache entries. See https://curl.se/libcurl/c/CURLOPT_DNS_CACHE_TIMEOUT.html for details.</synopsis>
</configOption>
</configObject>
</list-elements>
<managerEvent name="DeviceStateListComplete" language="en_US">
<managerEventInstance class="EVENT_FLAG_COMMAND">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>
Indicates the end of the list the current known extension states.
</synopsis>
</list-elements>
<managerEvent name="PresenceStateListComplete" language="en_US">
<managerEventInstance class="EVENT_FLAG_COMMAND">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>
Indicates the end of the list the current known extension states.
</synopsis>
/*** DOCUMENTATION
<application name="MusicOnHold" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>0.1.12</version>
+ </since>
<synopsis>
Play Music On Hold indefinitely.
</synopsis>
</description>
</application>
<application name="StartMusicOnHold" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Play Music On Hold.
</synopsis>
</description>
</application>
<application name="StopMusicOnHold" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.2.0</version>
+ </since>
<synopsis>
Stop playing Music On Hold.
</synopsis>
/*** DOCUMENTATION
<function name="MUTEAUDIO" language="en_US">
- <since><version>1.8.0</version></since>
+ <since>
+ <version>1.8.0</version>
+ </since>
<synopsis>
Muting audio streams in the channel
</synopsis>
</manager>
<managerEvent language="en_US" name="MWIGet">
<managerEventInstance class="EVENT_FLAG_REPORTING">
- <since><version>12.1.0</version></since>
+ <since>
+ <version>12.1.0</version>
+ </since>
<synopsis>
Raised in response to a MWIGet command.
</synopsis>
</managerEvent>
<managerEvent language="en_US" name="MWIGetComplete">
<managerEventInstance class="EVENT_FLAG_REPORTING">
- <since><version>12.1.0</version></since>
+ <since>
+ <version>12.1.0</version>
+ </since>
<synopsis>
Raised in response to a MWIGet command.
</synopsis>
/*** DOCUMENTATION
<function name="ODBC" language="en_US">
- <since><version>13.8.0</version></since>
+ <since>
+ <version>13.8.0</version>
+ </since>
<synopsis>
Controls ODBC transaction properties.
</synopsis>
</description>
</function>
<application name="ODBC_Commit" language="en_US">
- <since><version>13.8.0</version></since>
+ <since>
+ <version>13.8.0</version>
+ </since>
<synopsis>
Commits a currently open database transaction.
</synopsis>
</description>
</application>
<application name="ODBC_Rollback" language="en_US">
- <since><version>13.8.0</version></since>
+ <since>
+ <version>13.8.0</version>
+ </since>
<synopsis>
Rollback a currently open database transaction.
</synopsis>
<configInfo name="res_parking" language="en_US">
<configFile name="res_parking.conf">
<configObject name="globals">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Options that apply to every parking lot</synopsis>
<configOption name="parkeddynamic">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Enables dynamically created parkinglots.</synopsis>
<description>
<para>If the option is enabled then the following variables can
</configOption>
</configObject>
<configObject name="parking_lot">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Defined parking lots for res_parking to use to park calls on</synopsis>
<configOption name="context" default="parkedcalls">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>The name of the context where calls are parked and picked up from.</synopsis>
<description><para>This option is only used if parkext is set.</para></description>
</configOption>
<configOption name="parkext">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Extension to park calls to this parking lot.</synopsis>
<description>
<para>If this option is used, this extension will automatically
</description>
</configOption>
<configOption name="parkext_exclusive" default="no">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>If yes, the extension registered as parkext will park exclusively to this parking lot.</synopsis>
</configOption>
<configOption name="parkpos" default="701-750">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Numerical range of parking spaces which can be used to retrieve parked calls.</synopsis>
<description>
<para>If <literal>parkext</literal> is set, these extensions
</description>
</configOption>
<configOption name="parkinghints" default="no">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>If yes, this parking lot will add hints automatically for parking spaces.</synopsis>
</configOption>
<configOption name="parkingtime" default="45">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Amount of time a call will remain parked before giving up (in seconds).</synopsis>
</configOption>
<configOption name="parkedmusicclass">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Which music class to use for parked calls. They will use the default if unspecified.</synopsis>
</configOption>
<configOption name="comebacktoorigin" default="yes">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Determines what should be done with the parked channel if no one picks it up before it times out.</synopsis>
<description><para>Valid Options:</para>
<enumlist>
</description>
</configOption>
<configOption name="comebackdialtime" default="30">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Timeout for the Dial extension created to call back the parker when a parked call times out.</synopsis>
</configOption>
<configOption name="comebackcontext" default="parkedcallstimeout">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Context where parked calls will enter the PBX on timeout when comebacktoorigin=no</synopsis>
<description><para>The extension the call enters will prioritize the flattened peer name in this context.
If the flattened peer name extension is unavailable, then the 's' extension in this context will be
</description>
</configOption>
<configOption name="courtesytone">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>If the name of a sound file is provided, use this as the courtesy tone</synopsis>
<description><para>By default, this tone is only played to the caller of a parked call. Who receives the tone
can be changed using the <literal>parkedplay</literal> option.</para>
</description>
</configOption>
<configOption name="parkedplay" default="caller">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Who we should play the courtesytone to on the pickup of a parked call from this lot</synopsis>
<description>
<enumlist>
</description>
</configOption>
<configOption name="parkedcalltransfers" default="no">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Who to apply the DTMF transfer features to when parked calls are picked up or timeout.</synopsis>
<description>
<xi:include xpointer="xpointer(/docs/configInfo[@name='res_parking']/configFile[@name='res_parking.conf']/configObject[@name='parking_lot']/configOption[@name='parkedplay']/description/enumlist)" />
</description>
</configOption>
<configOption name="parkedcallreparking" default="no">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Who to apply the DTMF parking feature to when parked calls are picked up or timeout.</synopsis>
<description>
<xi:include xpointer="xpointer(/docs/configInfo[@name='res_parking']/configFile[@name='res_parking.conf']/configObject[@name='parking_lot']/configOption[@name='parkedplay']/description/enumlist)" />
</description>
</configOption>
<configOption name="parkedcallhangup" default="no">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Who to apply the DTMF hangup feature to when parked calls are picked up or timeout.</synopsis>
<description>
<xi:include xpointer="xpointer(/docs/configInfo[@name='res_parking']/configFile[@name='res_parking.conf']/configObject[@name='parking_lot']/configOption[@name='parkedplay']/description/enumlist)" />
</description>
</configOption>
<configOption name="parkedcallrecording" default="no">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Who to apply the DTMF MixMonitor recording feature to when parked calls are picked up or timeout.</synopsis>
<description>
<xi:include xpointer="xpointer(/docs/configInfo[@name='res_parking']/configFile[@name='res_parking.conf']/configObject[@name='parking_lot']/configOption[@name='parkedplay']/description/enumlist)" />
</description>
</configOption>
<configOption name="findslot" default="first">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Rule to use when trying to figure out which parking space a call should be parked with.</synopsis>
<description>
<enumlist>
/*** DOCUMENTATION
<function name="PP_EACH_EXTENSION" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.1.0</version>
+ </since>
<synopsis>
Execute specified template for each extension.
</synopsis>
</description>
</function>
<function name="PP_EACH_USER" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.6.0</version>
+ </since>
<synopsis>
Generate a string for each phoneprov user.
</synopsis>
</configOption>
</configObject>
<configObject name="log_mappings">
- <since><version>13.8.0</version></since>
+ <since>
+ <version>13.8.0</version>
+ </since>
<synopsis>PJPROJECT to Asterisk Log Level Mapping</synopsis>
<description><para>Warnings and errors in the pjproject libraries are generally handled
by Asterisk. In many cases, Asterisk wouldn't even consider them to
'log_mappings' or it won't be found.</para></note>
</description>
<configOption name="type">
- <since><version>13.8.0</version></since>
+ <since>
+ <version>13.8.0</version>
+ </since>
<synopsis>Must be of type 'log_mappings'.</synopsis>
</configOption>
<configOption name="asterisk_error" default="0,1">
- <since><version>13.8.0</version></since>
+ <since>
+ <version>13.8.0</version>
+ </since>
<synopsis>A comma separated list of pjproject log levels to map to Asterisk LOG_ERROR.</synopsis>
</configOption>
<configOption name="asterisk_warning" default="2">
- <since><version>13.8.0</version></since>
+ <since>
+ <version>13.8.0</version>
+ </since>
<synopsis>A comma separated list of pjproject log levels to map to Asterisk LOG_WARNING.</synopsis>
</configOption>
<configOption name="asterisk_notice" default="">
- <since><version>13.8.0</version></since>
+ <since>
+ <version>13.8.0</version>
+ </since>
<synopsis>A comma separated list of pjproject log levels to map to Asterisk LOG_NOTICE.</synopsis>
</configOption>
<configOption name="asterisk_verbose" default="">
- <since><version>13.8.0</version></since>
+ <since>
+ <version>13.8.0</version>
+ </since>
<synopsis>A comma separated list of pjproject log levels to map to Asterisk LOG_VERBOSE.</synopsis>
</configOption>
<configOption name="asterisk_debug" default="3,4">
- <since><version>13.8.0</version></since>
+ <since>
+ <version>13.8.0</version>
+ </since>
<synopsis>A comma separated list of pjproject log levels to map to Asterisk LOG_DEBUG.</synopsis>
</configOption>
<configOption name="asterisk_trace" default="5,6">
- <since><version>16.21.0</version><version>18.7.0</version></since>
+ <since>
+ <version>16.21.0</version>
+ <version>18.7.0</version>
+ </since>
<synopsis>A comma separated list of pjproject log levels to map to Asterisk LOG_TRACE.</synopsis>
</configOption>
</configObject>
<synopsis>SIP Resource using PJProject</synopsis>
<configFile name="pjsip.conf">
<configObject name="endpoint">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Endpoint</synopsis>
<description><para>
The <emphasis>Endpoint</emphasis> is the primary configuration object.
</para>
</description>
<configOption name="100rel" default="yes">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>Allow support for RFC3262 provisional ACK tags</synopsis>
<description>
<enumlist>
</description>
</configOption>
<configOption name="aggregate_mwi" default="yes">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Condense MWI notifications into a single NOTIFY.</synopsis>
<description><para>When enabled, <replaceable>aggregate_mwi</replaceable> condenses message
waiting notifications from multiple mailboxes into a single NOTIFY. If it is disabled,
individual NOTIFYs are sent for each mailbox.</para></description>
</configOption>
<configOption name="allow">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>Media Codec(s) to allow</synopsis>
</configOption>
<configOption name="codec_prefs_incoming_offer">
- <since><version>18.0.0</version></since>
+ <since>
+ <version>18.0.0</version>
+ </since>
<synopsis>Codec negotiation prefs for incoming offers.</synopsis>
<description>
<para>
</description>
</configOption>
<configOption name="codec_prefs_outgoing_offer">
- <since><version>18.0.0</version></since>
+ <since>
+ <version>18.0.0</version>
+ </since>
<synopsis>Codec negotiation prefs for outgoing offers.</synopsis>
<description>
<para>
</description>
</configOption>
<configOption name="codec_prefs_incoming_answer">
- <since><version>18.0.0</version></since>
+ <since>
+ <version>18.0.0</version>
+ </since>
<synopsis>Codec negotiation prefs for incoming answers.</synopsis>
<description>
<para>
</description>
</configOption>
<configOption name="codec_prefs_outgoing_answer">
- <since><version>18.0.0</version></since>
+ <since>
+ <version>18.0.0</version>
+ </since>
<synopsis>Codec negotiation prefs for outgoing answers.</synopsis>
<description>
<para>
</description>
</configOption>
<configOption name="allow_overlap" default="yes">
- <since><version>13.15.0</version><version>14.4.0</version></since>
+ <since>
+ <version>13.15.0</version>
+ <version>14.4.0</version>
+ </since>
<synopsis>Enable RFC3578 overlap dialing support.</synopsis>
</configOption>
<configOption name="overlap_context">
- <since><version>18.17.0</version><version>20.2.0</version></since>
+ <since>
+ <version>18.17.0</version>
+ <version>20.2.0</version>
+ </since>
<synopsis>Dialplan context to use for RFC3578 overlap dialing.</synopsis>
<description>
<para>Dialplan context to use for overlap dialing extension matching.
</description>
</configOption>
<configOption name="aors">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>AoR(s) to be used with the endpoint</synopsis>
<description><para>
List of comma separated AoRs that the endpoint should be associated with.
</para></description>
</configOption>
<configOption name="auth">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>Authentication Object(s) associated with the endpoint</synopsis>
<description><para>
This is a comma-delimited list of <replaceable>auth</replaceable> sections defined
</description>
</configOption>
<configOption name="callerid">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>CallerID information for the endpoint</synopsis>
<description><para>
Must be in the format <literal>Name <Number></literal>,
</para></description>
</configOption>
<configOption name="callerid_privacy">
- <since><version>12.7.0</version></since>
+ <since>
+ <version>12.7.0</version>
+ </since>
<synopsis>Default privacy level</synopsis>
<description>
<enumlist>
</description>
</configOption>
<configOption name="callerid_tag">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>Internal id_tag for the endpoint</synopsis>
</configOption>
<configOption name="context">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Dialplan context for inbound sessions</synopsis>
</configOption>
<configOption name="direct_media_glare_mitigation" default="none">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>Mitigation of direct media (re)INVITE glare</synopsis>
<description>
<para>
</description>
</configOption>
<configOption name="direct_media_method" default="invite">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>Direct Media method type</synopsis>
<description>
<para>Method for setting up Direct Media between endpoints.</para>
</description>
</configOption>
<configOption name="trust_connected_line">
- <since><version>13.24.0</version><version>16.1.0</version></since>
+ <since>
+ <version>13.24.0</version>
+ <version>16.1.0</version>
+ </since>
<synopsis>Accept Connected Line updates from this endpoint</synopsis>
</configOption>
<configOption name="send_connected_line">
- <since><version>13.24.0</version><version>16.1.0</version></since>
+ <since>
+ <version>13.24.0</version>
+ <version>16.1.0</version>
+ </since>
<synopsis>Send Connected Line updates to this endpoint</synopsis>
</configOption>
<configOption name="connected_line_method" default="invite">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>Connected line method type</synopsis>
<description>
<para>Method used when updating connected line information.</para>
</description>
</configOption>
<configOption name="direct_media" default="yes">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Determines whether media may flow directly between endpoints.</synopsis>
</configOption>
<configOption name="disable_direct_media_on_nat" default="no">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Disable direct media session refreshes when NAT obstructs the media session</synopsis>
</configOption>
<configOption name="disallow">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>Media Codec(s) to disallow</synopsis>
</configOption>
<configOption name="dtmf_mode" default="rfc4733">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>DTMF mode</synopsis>
<description>
<para>This setting allows to choose the DTMF mode for endpoint communication.</para>
</description>
</configOption>
<configOption name="media_address">
- <since><version>18.22.0</version><version>20.7.0</version><version>21.2.0</version></since>
+ <since>
+ <version>18.22.0</version>
+ <version>20.7.0</version>
+ <version>21.2.0</version>
+ </since>
<synopsis>IP address used in SDP for media handling</synopsis>
<description><para>
At the time of SDP creation, the IP address defined here will be used as
</description>
</configOption>
<configOption name="bind_rtp_to_media_address">
- <since><version>13.8.0</version></since>
+ <since>
+ <version>13.8.0</version>
+ </since>
<synopsis>Bind the RTP instance to the media_address</synopsis>
<description><para>
If media_address is specified, this option causes the RTP instance to be bound to the
</description>
</configOption>
<configOption name="force_rport" default="yes">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Force use of return port</synopsis>
</configOption>
<configOption name="ice_support" default="no">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Enable the ICE mechanism to help traverse NAT</synopsis>
</configOption>
<configOption name="identify_by">
- <since><version>13.19.0</version><version>15.2.0</version></since>
+ <since>
+ <version>13.19.0</version>
+ <version>15.2.0</version>
+ </since>
<synopsis>Way(s) for the endpoint to be identified</synopsis>
<description>
<para>Endpoints and AORs can be identified in multiple ways. This
</description>
</configOption>
<configOption name="redirect_method">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>How redirects received from an endpoint are handled</synopsis>
<description><para>
When a redirect is received from an endpoint there are multiple ways it can be handled.
</description>
</configOption>
<configOption name="mailboxes">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>NOTIFY the endpoint when state changes for any of the specified mailboxes</synopsis>
<description><para>
Asterisk will send unsolicited MWI NOTIFY messages to the endpoint when state
</para></description>
</configOption>
<configOption name="mwi_subscribe_replaces_unsolicited">
- <since><version>13.24.0</version><version>15.7.0</version></since>
+ <since>
+ <version>13.24.0</version>
+ <version>15.7.0</version>
+ </since>
<synopsis>An MWI subscribe will replace sending unsolicited NOTIFYs</synopsis>
</configOption>
<configOption name="voicemail_extension">
- <since><version>13.9.0</version></since>
+ <since>
+ <version>13.9.0</version>
+ </since>
<synopsis>The voicemail extension to send in the NOTIFY Message-Account header</synopsis>
</configOption>
<configOption name="moh_suggest" default="default">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Default Music On Hold class</synopsis>
</configOption>
<configOption name="outbound_auth">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>Authentication object(s) used for outbound requests</synopsis>
<description><para>
This is a comma-delimited list of <replaceable>auth</replaceable>
</description>
</configOption>
<configOption name="outbound_proxy">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Full SIP URI of the outbound proxy used to send requests</synopsis>
</configOption>
<configOption name="rewrite_contact">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Allow Contact header to be rewritten with the source IP address-port</synopsis>
<description><para>
On inbound SIP messages from this endpoint, the Contact header or an
</para></description>
</configOption>
<configOption name="rtp_ipv6" default="no">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Allow use of IPv6 for RTP traffic</synopsis>
</configOption>
<configOption name="rtp_symmetric" default="no">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Enforce that RTP must be symmetric</synopsis>
</configOption>
<configOption name="send_diversion" default="yes">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Send the Diversion header, conveying the diversion
information to the called user agent</synopsis>
</configOption>
<configOption name="send_history_info" default="no">
- <since><version>13.38.0</version><version>16.15.0</version><version>17.9.0</version><version>18.1.0</version></since>
+ <since>
+ <version>13.38.0</version>
+ <version>16.15.0</version>
+ <version>17.9.0</version>
+ <version>18.1.0</version>
+ </since>
<synopsis>Send the History-Info header, conveying the diversion
information to the called and calling user agents</synopsis>
</configOption>
<configOption name="send_pai" default="no">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Send the P-Asserted-Identity header</synopsis>
</configOption>
<configOption name="send_rpid" default="no">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Send the Remote-Party-ID header</synopsis>
</configOption>
<configOption name="rpid_immediate" default="no">
- <since><version>13.4.0</version></since>
+ <since>
+ <version>13.4.0</version>
+ </since>
<synopsis>Immediately send connected line updates on unanswered incoming calls.</synopsis>
<description>
<para>When enabled, immediately send <emphasis>180 Ringing</emphasis>
</description>
</configOption>
<configOption name="tenantid" default="">
- <since><version>18.25.0</version><version>20.10.0</version><version>21.5.0</version></since>
+ <since>
+ <version>18.25.0</version>
+ <version>20.10.0</version>
+ <version>21.5.0</version>
+ </since>
<synopsis>The tenant ID for this endpoint.</synopsis>
<description><para>
Sets the tenant ID for this endpoint. When a channel is created,
</para></description>
</configOption>
<configOption name="timers_min_se" default="90">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Minimum session timers expiration period</synopsis>
<description><para>
Minimum session timer expiration period. Time in seconds.
</para></description>
</configOption>
<configOption name="timers" default="yes">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>Session timers for SIP packets</synopsis>
<description>
<enumlist>
</description>
</configOption>
<configOption name="timers_sess_expires" default="1800">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Maximum session timer expiration period</synopsis>
<description><para>
Maximum session timer expiration period. Time in seconds.
</para></description>
</configOption>
<configOption name="transport">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Explicit transport configuration to use</synopsis>
<description>
<para>This will <emphasis>force</emphasis> the endpoint to use the
</description>
</configOption>
<configOption name="trust_id_inbound" default="no">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Accept identification information received from this endpoint</synopsis>
<description><para>This option determines whether Asterisk will accept
identification from the endpoint from headers such as P-Asserted-Identity
the endpoint.</para></description>
</configOption>
<configOption name="trust_id_outbound" default="no">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Send private identification details to the endpoint.</synopsis>
<description><para>This option determines whether res_pjsip will send private
identification information to the endpoint. If <literal>no</literal>,
provided in the request is private.</para></description>
</configOption>
<configOption name="type">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Must be of type 'endpoint'.</synopsis>
</configOption>
<configOption name="use_ptime" default="no">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Use Endpoint's requested packetization interval</synopsis>
</configOption>
<configOption name="use_avpf" default="no">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Determines whether res_pjsip will use and enforce usage of AVPF for this
endpoint.</synopsis>
<description><para>
</para></description>
</configOption>
<configOption name="force_avp" default="no">
- <since><version>12.4.0</version></since>
+ <since>
+ <version>12.4.0</version>
+ </since>
<synopsis>Determines whether res_pjsip will use and enforce usage of AVP,
regardless of the RTP profile in use for this endpoint.</synopsis>
<description><para>
</para></description>
</configOption>
<configOption name="media_use_received_transport" default="no">
- <since><version>12.4.0</version></since>
+ <since>
+ <version>12.4.0</version>
+ </since>
<synopsis>Determines whether res_pjsip will use the media transport received in the
offer SDP in the corresponding answer SDP.</synopsis>
<description><para>
</para></description>
</configOption>
<configOption name="media_encryption" default="no">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>Determines whether res_pjsip will use and enforce usage of media encryption
for this endpoint.</synopsis>
<description>
</description>
</configOption>
<configOption name="media_encryption_optimistic" default="no">
- <since><version>13.1.0</version></since>
+ <since>
+ <version>13.1.0</version>
+ </since>
<synopsis>Determines whether encryption should be used if possible but does not terminate the
session if not achieved.</synopsis>
<description><para>
</para></description>
</configOption>
<configOption name="g726_non_standard" default="no">
- <since><version>13.5.0</version></since>
+ <since>
+ <version>13.5.0</version>
+ </since>
<synopsis>Force g.726 to use AAL2 packing order when negotiating g.726 audio</synopsis>
<description><para>
When set to "yes" and an endpoint negotiates g.726 audio then use g.726 for AAL2
</para></description>
</configOption>
<configOption name="inband_progress" default="no">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Determines whether chan_pjsip will indicate ringing using inband
progress.</synopsis>
<description><para>
</para></description>
</configOption>
<configOption name="call_group">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>The numeric pickup groups for a channel.</synopsis>
<description><para>
Can be set to a comma separated list of numbers or ranges between the values
</para></description>
</configOption>
<configOption name="pickup_group">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>The numeric pickup groups that a channel can pickup.</synopsis>
<description><para>
Can be set to a comma separated list of numbers or ranges between the values
</para></description>
</configOption>
<configOption name="named_call_group">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>The named pickup groups for a channel.</synopsis>
<description><para>
Can be set to a comma separated list of case sensitive strings limited by
</para></description>
</configOption>
<configOption name="named_pickup_group">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>The named pickup groups that a channel can pickup.</synopsis>
<description><para>
Can be set to a comma separated list of case sensitive strings limited by
</para></description>
</configOption>
<configOption name="device_state_busy_at" default="0">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>The number of in-use channels which will cause busy to be returned as device state</synopsis>
<description><para>
When the number of in-use channels for the endpoint matches the devicestate_busy_at setting the
</para></description>
</configOption>
<configOption name="t38_udptl" default="no">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Whether T.38 UDPTL support is enabled or not</synopsis>
<description><para>
If set to yes T.38 UDPTL support will be enabled, and T.38 negotiation requests will be accepted
</para></description>
</configOption>
<configOption name="t38_udptl_ec" default="none">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>T.38 UDPTL error correction method</synopsis>
<description>
<enumlist>
</description>
</configOption>
<configOption name="t38_udptl_maxdatagram" default="0">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>T.38 UDPTL maximum datagram size</synopsis>
<description><para>
This option can be set to override the maximum datagram of a remote endpoint for broken
</para></description>
</configOption>
<configOption name="fax_detect" default="no">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Whether CNG tone detection is enabled</synopsis>
<description><para>
This option can be set to send the session to the fax extension when a CNG tone is
</para></description>
</configOption>
<configOption name="fax_detect_timeout">
- <since><version>13.11.0</version></since>
+ <since>
+ <version>13.11.0</version>
+ </since>
<synopsis>How long into a call before fax_detect is disabled for the call</synopsis>
<description><para>
The option determines how many seconds into a call before the
</para></description>
</configOption>
<configOption name="t38_udptl_nat" default="no">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Whether NAT support is enabled on UDPTL sessions</synopsis>
<description><para>
When enabled the UDPTL stack will send UDPTL packets to the source address of
</para></description>
</configOption>
<configOption name="t38_udptl_ipv6" default="no">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Whether IPv6 is used for UDPTL Sessions</synopsis>
<description><para>
When enabled the UDPTL stack will use IPv6.
</para></description>
</configOption>
<configOption name="t38_bind_udptl_to_media_address" default="no">
- <since><version>16.22.0</version><version>18.8.0</version></since>
+ <since>
+ <version>16.22.0</version>
+ <version>18.8.0</version>
+ </since>
<synopsis>Bind the UDPTL instance to the media_adress</synopsis>
<description><para>
If media_address is specified, this option causes the UDPTL instance to be bound to
</para></description>
</configOption>
<configOption name="tone_zone">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Set which country's indications to use for channels created for this endpoint.</synopsis>
</configOption>
<configOption name="language">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Set the default language to use for channels created for this endpoint.</synopsis>
</configOption>
<configOption name="one_touch_recording" default="no">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Determines whether one-touch recording is allowed for this endpoint.</synopsis>
<see-also>
<ref type="configOption">record_on_feature</ref>
</see-also>
</configOption>
<configOption name="record_on_feature" default="automixmon">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>The feature to enact when one-touch recording is turned on.</synopsis>
<description>
<para>When an INFO request for one-touch recording arrives with a Record header set to "on", this
</see-also>
</configOption>
<configOption name="record_off_feature" default="automixmon">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>The feature to enact when one-touch recording is turned off.</synopsis>
<description>
<para>When an INFO request for one-touch recording arrives with a Record header set to "off", this
</see-also>
</configOption>
<configOption name="rtp_engine" default="asterisk">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Name of the RTP engine to use for channels created for this endpoint</synopsis>
</configOption>
<configOption name="allow_transfer" default="yes">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Determines whether SIP REFER transfers are allowed for this endpoint</synopsis>
</configOption>
<configOption name="user_eq_phone" default="no">
- <since><version>13.2.0</version></since>
+ <since>
+ <version>13.2.0</version>
+ </since>
<synopsis>Determines whether a user=phone parameter is placed into the request URI if the user is determined to be a phone number</synopsis>
</configOption>
<configOption name="moh_passthrough" default="no">
- <since><version>13.30.0</version></since>
+ <since>
+ <version>13.30.0</version>
+ </since>
<synopsis>Determines whether hold and unhold will be passed through using re-INVITEs with recvonly and sendrecv to the remote side</synopsis>
</configOption>
<configOption name="sdp_owner" default="-">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>String placed as the username portion of an SDP origin (o=) line.</synopsis>
</configOption>
<configOption name="sdp_session" default="Asterisk">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>String used for the SDP session (s=) line.</synopsis>
</configOption>
<configOption name="tos_audio">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>DSCP TOS bits for audio streams</synopsis>
<description><para>
See https://docs.asterisk.org/Configuration/Channel-Drivers/IP-Quality-of-Service for more information about QoS settings
</para></description>
</configOption>
<configOption name="tos_video">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>DSCP TOS bits for video streams</synopsis>
<description><para>
See https://docs.asterisk.org/Configuration/Channel-Drivers/IP-Quality-of-Service for more information about QoS settings
</para></description>
</configOption>
<configOption name="cos_audio">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Priority for audio streams</synopsis>
<description><para>
See https://docs.asterisk.org/Configuration/Channel-Drivers/IP-Quality-of-Service for more information about QoS settings
</para></description>
</configOption>
<configOption name="cos_video">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Priority for video streams</synopsis>
<description><para>
See https://docs.asterisk.org/Configuration/Channel-Drivers/IP-Quality-of-Service for more information about QoS settings
</para></description>
</configOption>
<configOption name="allow_subscribe" default="yes">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Determines if endpoint is allowed to initiate subscriptions with Asterisk.</synopsis>
</configOption>
<configOption name="sub_min_expiry" default="60">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>The minimum allowed expiry time for subscriptions initiated by the endpoint.</synopsis>
</configOption>
<configOption name="from_user">
- <since><version>13.18.0</version><version>14.7.0</version></since>
+ <since>
+ <version>13.18.0</version>
+ <version>14.7.0</version>
+ </since>
<synopsis>Username to use in From header for requests to this endpoint.</synopsis>
</configOption>
<configOption name="mwi_from_user">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Username to use in From header for unsolicited MWI NOTIFYs to this endpoint.</synopsis>
</configOption>
<configOption name="from_domain">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Domain to use in From header for requests to this endpoint.</synopsis>
</configOption>
<configOption name="dtls_verify">
- <since><version>12.7.0</version></since>
+ <since>
+ <version>12.7.0</version>
+ </since>
<synopsis>Verify that the provided peer certificate is valid</synopsis>
<description><para>
This option only applies if <replaceable>media_encryption</replaceable> is
</description>
</configOption>
<configOption name="dtls_rekey">
- <since><version>12.7.0</version></since>
+ <since>
+ <version>12.7.0</version>
+ </since>
<synopsis>Interval at which to renegotiate the TLS session and rekey the SRTP session</synopsis>
<description><para>
This option only applies if <replaceable>media_encryption</replaceable> is
</para></description>
</configOption>
<configOption name="dtls_auto_generate_cert" default="no">
- <since><version>15.2.0</version></since>
+ <since>
+ <version>15.2.0</version>
+ </since>
<synopsis>Whether or not to automatically generate an ephemeral X.509 certificate</synopsis>
<description>
<para>
</description>
</configOption>
<configOption name="dtls_cert_file">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>Path to certificate file to present to peer</synopsis>
<description><para>
This option only applies if <replaceable>media_encryption</replaceable> is
</para></description>
</configOption>
<configOption name="dtls_private_key">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>Path to private key for certificate file</synopsis>
<description><para>
This option only applies if <replaceable>media_encryption</replaceable> is
</para></description>
</configOption>
<configOption name="dtls_cipher">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>Cipher to use for DTLS negotiation</synopsis>
<description><para>
This option only applies if <replaceable>media_encryption</replaceable> is
</para></description>
</configOption>
<configOption name="dtls_ca_file">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>Path to certificate authority certificate</synopsis>
<description><para>
This option only applies if <replaceable>media_encryption</replaceable> is
</para></description>
</configOption>
<configOption name="dtls_ca_path">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>Path to a directory containing certificate authority certificates</synopsis>
<description><para>
This option only applies if <replaceable>media_encryption</replaceable> is
</para></description>
</configOption>
<configOption name="dtls_setup">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>Whether we are willing to accept connections, connect to the other party, or both.</synopsis>
<description>
<para>
</description>
</configOption>
<configOption name="dtls_fingerprint">
- <since><version>12.7.0</version></since>
+ <since>
+ <version>12.7.0</version>
+ </since>
<synopsis>Type of hash to use for the DTLS fingerprint in the SDP.</synopsis>
<description>
<para>
</description>
</configOption>
<configOption name="srtp_tag_32">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Determines whether 32 byte tags should be used instead of 80 byte tags.</synopsis>
<description><para>
This option only applies if <replaceable>media_encryption</replaceable> is
</para></description>
</configOption>
<configOption name="set_var">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>Variable set on a channel involving the endpoint.</synopsis>
<description><para>
When a new channel is created using the endpoint set the specified
</para></description>
</configOption>
<configOption name="message_context">
- <since><version>13.5.0</version></since>
+ <since>
+ <version>13.5.0</version>
+ </since>
<synopsis>Context to route incoming MESSAGE requests to.</synopsis>
<description><para>
If specified, incoming MESSAGE requests will be routed to the indicated
</para></description>
</configOption>
<configOption name="accountcode">
- <since><version>13.5.0</version></since>
+ <since>
+ <version>13.5.0</version>
+ </since>
<synopsis>An accountcode to set automatically on any channels created for this endpoint.</synopsis>
<description><para>
If specified, any channel created for this endpoint will automatically
</para></description>
</configOption>
<configOption name="preferred_codec_only" default="no">
- <since><version>15.0.0</version></since>
+ <since>
+ <version>15.0.0</version>
+ </since>
<synopsis>Respond to a SIP invite with the single most preferred codec (DEPRECATED)</synopsis>
<description><para>Respond to a SIP invite with the single most preferred codec
rather than advertising all joint codec capabilities. This limits the other side's codec
</see-also>
</configOption>
<configOption name="incoming_call_offer_pref" default="local">
- <since><version>18.0.0</version></since>
+ <since>
+ <version>18.0.0</version>
+ </since>
<synopsis>Preferences for selecting codecs for an incoming call.</synopsis>
<description>
<para>Based on this setting, a joint list of preferred codecs between those
</description>
</configOption>
<configOption name="outgoing_call_offer_pref" default="remote_merge">
- <since><version>18.0.0</version></since>
+ <since>
+ <version>18.0.0</version>
+ </since>
<synopsis>Preferences for selecting codecs for an outgoing call.</synopsis>
<description>
<para>Based on this setting, a joint list of preferred codecs between
</description>
</configOption>
<configOption name="rtp_keepalive">
- <since><version>13.5.0</version></since>
+ <since>
+ <version>13.5.0</version>
+ </since>
<synopsis>Number of seconds between RTP comfort noise keepalive packets.</synopsis>
<description><para>
At the specified interval, Asterisk will send an RTP comfort noise frame. This may
</para></description>
</configOption>
<configOption name="rtp_timeout" default="0">
- <since><version>13.5.0</version></since>
+ <since>
+ <version>13.5.0</version>
+ </since>
<synopsis>Maximum number of seconds without receiving RTP (while off hold) before terminating call.</synopsis>
<description><para>
This option configures the number of seconds without RTP (while off hold) before
</para></description>
</configOption>
<configOption name="rtp_timeout_hold" default="0">
- <since><version>13.5.0</version></since>
+ <since>
+ <version>13.5.0</version>
+ </since>
<synopsis>Maximum number of seconds without receiving RTP (while on hold) before terminating call.</synopsis>
<description><para>
This option configures the number of seconds without RTP (while on hold) before
</para></description>
</configOption>
<configOption name="acl">
- <since><version>13.10.0</version></since>
+ <since>
+ <version>13.10.0</version>
+ </since>
<synopsis>List of IP ACL section names in acl.conf</synopsis>
<description><para>
This matches sections configured in <literal>acl.conf</literal>. The value is
</para></description>
</configOption>
<configOption name="deny">
- <since><version>13.10.0</version></since>
+ <since>
+ <version>13.10.0</version>
+ </since>
<synopsis>List of IP addresses to deny access from</synopsis>
<description><para>
The value is a comma-delimited list of IP addresses. IP addresses may
</para></description>
</configOption>
<configOption name="permit">
- <since><version>13.10.0</version></since>
+ <since>
+ <version>13.10.0</version>
+ </since>
<synopsis>List of IP addresses to permit access from</synopsis>
<description><para>
The value is a comma-delimited list of IP addresses. IP addresses may
</para></description>
</configOption>
<configOption name="contact_acl">
- <since><version>13.10.0</version></since>
+ <since>
+ <version>13.10.0</version>
+ </since>
<synopsis>List of Contact ACL section names in acl.conf</synopsis>
<description><para>
This matches sections configured in <literal>acl.conf</literal>. The value is
</para></description>
</configOption>
<configOption name="contact_deny">
- <since><version>13.10.0</version></since>
+ <since>
+ <version>13.10.0</version>
+ </since>
<synopsis>List of Contact header addresses to deny</synopsis>
<description><para>
The value is a comma-delimited list of IP addresses. IP addresses may
</para></description>
</configOption>
<configOption name="contact_permit">
- <since><version>13.10.0</version></since>
+ <since>
+ <version>13.10.0</version>
+ </since>
<synopsis>List of Contact header addresses to permit</synopsis>
<description><para>
The value is a comma-delimited list of IP addresses. IP addresses may
</para></description>
</configOption>
<configOption name="subscribe_context">
- <since><version>13.11.0</version></since>
+ <since>
+ <version>13.11.0</version>
+ </since>
<synopsis>Context for incoming MESSAGE requests.</synopsis>
<description><para>
If specified, incoming SUBSCRIBE requests will be searched for the matching
</para></description>
</configOption>
<configOption name="contact_user" default="">
- <since><version>13.12.0</version><version>14.1.0</version></since>
+ <since>
+ <version>13.12.0</version>
+ <version>14.1.0</version>
+ </since>
<synopsis>Force the user on the outgoing Contact header to this value.</synopsis>
<description><para>
On outbound requests, force the user portion of the Contact header to this value.
</para></description>
</configOption>
<configOption name="asymmetric_rtp_codec" default="no">
- <since><version>13.13.0</version><version>14.2.0</version></since>
+ <since>
+ <version>13.13.0</version>
+ <version>14.2.0</version>
+ </since>
<synopsis>Allow the sending and receiving RTP codec to differ</synopsis>
<description><para>
When set to "yes" the codec in use for sending will be allowed to differ from
</para></description>
</configOption>
<configOption name="rtcp_mux" default="no">
- <since><version>13.15.0</version><version>14.4.0</version></since>
+ <since>
+ <version>13.15.0</version>
+ <version>14.4.0</version>
+ </since>
<synopsis>Enable RFC 5761 RTCP multiplexing on the RTP port</synopsis>
<description><para>
With this option enabled, Asterisk will attempt to negotiate the use of the "rtcp-mux"
</para></description>
</configOption>
<configOption name="refer_blind_progress" default="yes">
- <since><version>13.17.0</version><version>14.6.0</version></since>
+ <since>
+ <version>13.17.0</version>
+ <version>14.6.0</version>
+ </since>
<synopsis>Whether to notifies all the progress details on blind transfer</synopsis>
<description><para>
Some SIP phones (Mitel/Aastra, Snom) expect a sip/frag "200 OK"
</para></description>
</configOption>
<configOption name="notify_early_inuse_ringing" default="no">
- <since><version>13.17.0</version><version>14.6.0</version></since>
+ <since>
+ <version>13.17.0</version>
+ <version>14.6.0</version>
+ </since>
<synopsis>Whether to notifies dialog-info 'early' on InUse&Ringing state</synopsis>
<description><para>
Control whether dialog-info subscriptions get 'early' state
</para></description>
</configOption>
<configOption name="max_audio_streams" default="1">
- <since><version>15.0.0</version></since>
+ <since>
+ <version>15.0.0</version>
+ </since>
<synopsis>The maximum number of allowed audio streams for the endpoint</synopsis>
<description><para>
This option enforces a limit on the maximum simultaneous negotiated audio
</para></description>
</configOption>
<configOption name="max_video_streams" default="1">
- <since><version>15.0.0</version></since>
+ <since>
+ <version>15.0.0</version>
+ </since>
<synopsis>The maximum number of allowed video streams for the endpoint</synopsis>
<description><para>
This option enforces a limit on the maximum simultaneous negotiated video
</para></description>
</configOption>
<configOption name="bundle" default="no">
- <since><version>15.0.0</version></since>
+ <since>
+ <version>15.0.0</version>
+ </since>
<synopsis>Enable RTP bundling</synopsis>
<description><para>
With this option enabled, Asterisk will attempt to negotiate the use of bundle.
</para></description>
</configOption>
<configOption name="webrtc" default="no">
- <since><version>15.0.0</version></since>
+ <since>
+ <version>15.0.0</version>
+ </since>
<synopsis>Defaults and enables some options that are relevant to WebRTC</synopsis>
<description><para>
When set to "yes" this also enables the following values that are needed in
</description>
</configOption>
<configOption name="incoming_mwi_mailbox">
- <since><version>13.18.0</version><version>14.7.0</version><version>15.1.0</version></since>
+ <since>
+ <version>13.18.0</version>
+ <version>14.7.0</version>
+ <version>15.1.0</version>
+ </since>
<synopsis>Mailbox name to use when incoming MWI NOTIFYs are received</synopsis>
<description><para>
If an MWI NOTIFY is received <emphasis>from</emphasis> this endpoint,
</para></description>
</configOption>
<configOption name="follow_early_media_fork">
- <since><version>13.22.0</version><version>15.5.0</version></since>
+ <since>
+ <version>13.22.0</version>
+ <version>15.5.0</version>
+ </since>
<synopsis>Follow SDP forked media when To tag is different</synopsis>
<description><para>
On outgoing calls, if the UAS responds with different SDP attributes
</description>
</configOption>
<configOption name="accept_multiple_sdp_answers" default="no">
- <since><version>13.22.0</version><version>15.5.0</version></since>
+ <since>
+ <version>13.22.0</version>
+ <version>15.5.0</version>
+ </since>
<synopsis>Accept multiple SDP answers on non-100rel responses</synopsis>
<description><para>
On outgoing calls, if the UAS responds with different SDP attributes
</description>
</configOption>
<configOption name="suppress_q850_reason_headers" default="no">
- <since><version>13.23.0</version><version>15.6.0</version></since>
+ <since>
+ <version>13.23.0</version>
+ <version>15.6.0</version>
+ </since>
<synopsis>Suppress Q.850 Reason headers for this endpoint</synopsis>
<description><para>
Some devices can't accept multiple Reason headers and get confused
</description>
</configOption>
<configOption name="ignore_183_without_sdp" default="no">
- <since><version>13.26.0</version><version>16.3.0</version></since>
+ <since>
+ <version>13.26.0</version>
+ <version>16.3.0</version>
+ </since>
<synopsis>Do not forward 183 when it doesn't contain SDP</synopsis>
<description><para>
Certain SS7 internetworking scenarios can result in a 183
</description>
</configOption>
<configOption name="stir_shaken" default="no">
- <since><version>18.22.0</version><version>20.7.0</version><version>21.2.0</version></since>
+ <since>
+ <version>18.22.0</version>
+ <version>20.7.0</version>
+ <version>21.2.0</version>
+ </since>
<synopsis>Enable STIR/SHAKEN support on this endpoint</synopsis>
<description><para>
Enable STIR/SHAKEN support on this endpoint. On incoming INVITEs,
</description>
</configOption>
<configOption name="stir_shaken_profile" default="">
- <since><version>16.26.0</version><version>18.12.0</version><version>19.4.0</version></since>
+ <since>
+ <version>16.26.0</version>
+ <version>18.12.0</version>
+ <version>19.4.0</version>
+ </since>
<synopsis>STIR/SHAKEN profile containing additional configuration options</synopsis>
<description><para>
A STIR/SHAKEN profile that is defined in stir_shaken.conf. Contains
</description>
</configOption>
<configOption name="allow_unauthenticated_options" default="no">
- <since><version>16.18.0</version><version>18.4.0</version></since>
+ <since>
+ <version>16.18.0</version>
+ <version>18.4.0</version>
+ </since>
<synopsis>Skip authentication when receiving OPTIONS requests</synopsis>
<description><para>
RFC 3261 says that the response to an OPTIONS request MUST be the
</description>
</configOption>
<configOption name="security_negotiation" default="no">
- <since><version>21.0.0</version></since>
+ <since>
+ <version>21.0.0</version>
+ </since>
<synopsis>The kind of security agreement negotiation to use. Currently, only mediasec is supported.</synopsis>
<description>
<enumlist>
</description>
</configOption>
<configOption name="security_mechanisms">
- <since><version>21.0.0</version></since>
+ <since>
+ <version>21.0.0</version>
+ </since>
<synopsis>List of security mechanisms supported.</synopsis>
<description><para>
This is a comma-delimited list of security mechanisms to use. Each security mechanism
</para></description>
</configOption>
<configOption name="geoloc_incoming_call_profile" default="">
- <since><version>16.28.0</version><version>18.14.0</version><version>19.6.0</version></since>
+ <since>
+ <version>16.28.0</version>
+ <version>18.14.0</version>
+ <version>19.6.0</version>
+ </since>
<synopsis>Geolocation profile to apply to incoming calls</synopsis>
<description><para>
This geolocation profile will be applied to all calls received
</description>
</configOption>
<configOption name="geoloc_outgoing_call_profile" default="">
- <since><version>16.28.0</version><version>18.14.0</version><version>19.6.0</version></since>
+ <since>
+ <version>16.28.0</version>
+ <version>18.14.0</version>
+ <version>19.6.0</version>
+ </since>
<synopsis>Geolocation profile to apply to outgoing calls</synopsis>
<description><para>
This geolocation profile will be applied to all calls received
</description>
</configOption>
<configOption name="send_aoc" default="no">
- <since><version>18.16.0</version><version>20.1.0</version></since>
+ <since>
+ <version>18.16.0</version>
+ <version>20.1.0</version>
+ </since>
<synopsis>Send Advice-of-Charge messages</synopsis>
</configOption>
<configOption name="suppress_moh_on_sendonly" default="no">
- <since><version>20.11.0</version><version>21.6.0</version><version>22.1.0</version></since>
+ <since>
+ <version>20.11.0</version>
+ <version>21.6.0</version>
+ <version>22.1.0</version>
+ </since>
<synopsis>Suppress playing MOH to party A if party B sends
"sendonly" or "inactive" in an SDP</synopsis>
<description><para>
</configOption>
</configObject>
<configObject name="auth">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<!--
Be sure to update the following documentation page when making changes to this object:
https://docs.asterisk.org/Configuration/Channel-Drivers/SIP/Configuring-res_pjsip/PJSIP-Authentication
<ref type="link">https://docs.asterisk.org/Configuration/Channel-Drivers/SIP/Configuring-res_pjsip/PJSIP-Authentication</ref>
</see-also>
<configOption name="auth_type" default="digest">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Authentication type</synopsis>
<description><para>
If set to <literal>google_oauth</literal> then we'll read from the
</description>
</configOption>
<configOption name="username">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Username to use for account</synopsis>
</configOption>
<configOption name="password">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Plain text password used for authentication.</synopsis>
<description><para>Only used when auth_type is <literal>digest</literal>.</para></description>
</configOption>
<configOption name="password_digest" default="">
- <since><version>20.12.0</version><version>21.7.0</version><version>22.2.0</version></since>
+ <since>
+ <version>20.12.0</version>
+ <version>21.7.0</version>
+ <version>22.2.0</version>
+ </since>
<synopsis>One or more pre-computed hashes used for authentication.</synopsis>
<description><para>Only used when auth_type is <literal>digest</literal>.
As an alternative to specifying a plain text password,
</description>
</configOption>
<configOption name="md5_cred" default="">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>MD5 Hash used for authentication. (deprecated)</synopsis>
<description><para>Use the <literal>password_digest</literal> parameter instead.
If supplied, a <literal>password_digest</literal> parameter will be created
</para></description>
</configOption>
<configOption name="supported_algorithms_uac">
- <since><version>20.12.0</version><version>21.7.0</version><version>22.2.0</version></since>
+ <since>
+ <version>20.12.0</version>
+ <version>21.7.0</version>
+ <version>22.2.0</version>
+ </since>
<synopsis>Comma separated list of algorithms to support when this auth is used as a UAC</synopsis>
<description><para>Valid values:</para>
<enumlist>
</description>
</configOption>
<configOption name="supported_algorithms_uas">
- <since><version>20.12.0</version><version>21.7.0</version><version>22.2.0</version></since>
+ <since>
+ <version>20.12.0</version>
+ <version>21.7.0</version>
+ <version>22.2.0</version>
+ </since>
<synopsis>Comma separated list of algorithms to support when this auth is used as a UAS</synopsis>
<description><para>Valid values:</para>
<enumlist>
</description>
</configOption>
<configOption name="refresh_token">
- <since><version>17.0.0</version></since>
+ <since>
+ <version>17.0.0</version>
+ </since>
<synopsis>OAuth 2.0 refresh token</synopsis>
</configOption>
<configOption name="oauth_clientid">
- <since><version>17.0.0</version></since>
+ <since>
+ <version>17.0.0</version>
+ </since>
<synopsis>OAuth 2.0 application's client id</synopsis>
</configOption>
<configOption name="oauth_secret">
- <since><version>17.0.0</version></since>
+ <since>
+ <version>17.0.0</version>
+ </since>
<synopsis>OAuth 2.0 application's secret</synopsis>
</configOption>
<configOption name="realm" default="">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>SIP realm for endpoint</synopsis>
<description><para>
For incoming authentication (asterisk is the UAS),
</description>
</configOption>
<configOption name="nonce_lifetime" default="32">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Lifetime of a nonce associated with this authentication config.</synopsis>
</configOption>
<configOption name="type">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Must be 'auth'</synopsis>
</configOption>
</configObject>
<configObject name="domain_alias">
- <since><version>13.20.0</version><version>15.3.0</version></since>
+ <since>
+ <version>13.20.0</version>
+ <version>15.3.0</version>
+ </since>
<synopsis>Domain Alias</synopsis>
<description><para>
Signifies that a domain is an alias. If the domain on a session is
config option is provided to specify the domain to be aliased.
</para></description>
<configOption name="type">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Must be of type 'domain_alias'.</synopsis>
</configOption>
<configOption name="domain">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Domain to be aliased</synopsis>
</configOption>
</configObject>
<configObject name="transport">
- <since><version>13.8.0</version></since>
+ <since>
+ <version>13.8.0</version>
+ </since>
<synopsis>SIP Transport</synopsis>
<description><para>
<emphasis>Transports</emphasis>
will not suffice.</para></note>
</description>
<configOption name="async_operations" default="1">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Number of simultaneous Asynchronous Operations, can no longer be set, always set to 1</synopsis>
</configOption>
<configOption name="bind">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>IP Address and optional port to bind to for this transport</synopsis>
</configOption>
<configOption name="ca_list_file">
- <since><version>13.8.0</version></since>
+ <since>
+ <version>13.8.0</version>
+ </since>
<synopsis>File containing a list of certificates to read (TLS ONLY, not WSS)</synopsis>
</configOption>
<configOption name="ca_list_path">
- <since><version>13.8.0</version></since>
+ <since>
+ <version>13.8.0</version>
+ </since>
<synopsis>Path to directory containing a list of certificates to read (TLS ONLY, not WSS)</synopsis>
</configOption>
<configOption name="cert_file">
- <since><version>13.8.0</version></since>
+ <since>
+ <version>13.8.0</version>
+ </since>
<synopsis>Certificate file for endpoint (TLS ONLY, not WSS)</synopsis>
<description><para>
A path to a .crt or .pem file can be provided. However, only
</para></description>
</configOption>
<configOption name="cipher">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>Preferred cryptography cipher names (TLS ONLY, not WSS)</synopsis>
<description>
<para>Comma separated list of cipher names or numeric equivalents.
</description>
</configOption>
<configOption name="domain">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Domain the transport comes from</synopsis>
</configOption>
<configOption name="external_media_address">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>External IP address to use in RTP handling</synopsis>
<description><para>
When a request or response is sent out, if the destination of the
</para></description>
</configOption>
<configOption name="external_signaling_address">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>External address for SIP signalling</synopsis>
</configOption>
<configOption name="external_signaling_port" default="0">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>External port for SIP signalling</synopsis>
</configOption>
<configOption name="method">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>Method of SSL transport (TLS ONLY, not WSS)</synopsis>
<description>
<para>The availability of each of these options is dependent on the
</description>
</configOption>
<configOption name="local_net">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>Network to consider local (used for NAT purposes).</synopsis>
<description><para>This must be in CIDR or dotted decimal format with the IP
and mask separated with a slash ('/').</para></description>
</configOption>
<configOption name="password">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Password required for transport</synopsis>
</configOption>
<configOption name="priv_key_file">
- <since><version>13.8.0</version></since>
+ <since>
+ <version>13.8.0</version>
+ </since>
<synopsis>Private key file (TLS ONLY, not WSS)</synopsis>
<description><para>
A path to a key file can be provided. The private key file
</para></description>
</configOption>
<configOption name="protocol" default="udp">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>Protocol to use for SIP traffic</synopsis>
<description>
<enumlist>
</description>
</configOption>
<configOption name="require_client_cert" default="false">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>Require client certificate (TLS ONLY, not WSS)</synopsis>
</configOption>
<configOption name="tcp_keepalive_enable" default="no">
- <since><version>18.23.0</version><version>20.8.0</version><version>21.3.0</version></since>
+ <since>
+ <version>18.23.0</version>
+ <version>20.8.0</version>
+ <version>21.3.0</version>
+ </since>
<synopsis>Enable TCP keepalive</synopsis>
<description><para>
When set to 'yes', TCP keepalive messages are sent to verify that the endpoint is still reachable. This can help detect dead TCP connections in environments where connections may be silently dropped (e.g., NAT timeouts).
</para></description>
</configOption>
<configOption name="tcp_keepalive_idle_time" default="30">
- <since><version>18.23.0</version><version>20.8.0</version><version>21.3.0</version></since>
+ <since>
+ <version>18.23.0</version>
+ <version>20.8.0</version>
+ <version>21.3.0</version>
+ </since>
<synopsis>Idle time before the first TCP keepalive probe is sent</synopsis>
<description><para>
Specifies the amount of time in seconds that the connection must be idle before the first TCP keepalive probe is sent. An idle connection is defined as a connection in which no data has been sent or received by the application.
</para></description>
</configOption>
<configOption name="tcp_keepalive_interval_time" default="10">
- <since><version>18.23.0</version><version>20.8.0</version><version>21.3.0</version></since>
+ <since>
+ <version>18.23.0</version>
+ <version>20.8.0</version>
+ <version>21.3.0</version>
+ </since>
<synopsis>Interval between TCP keepalive probes</synopsis>
<description><para>
Specifies the interval in seconds between individual TCP keepalive probes, once the first probe is sent. This interval is used for subsequent probes if the peer does not respond to the previous probe.
</para></description>
</configOption>
<configOption name="tcp_keepalive_probe_count" default="5">
- <since><version>18.23.0</version><version>20.8.0</version><version>21.3.0</version></since>
+ <since>
+ <version>18.23.0</version>
+ <version>20.8.0</version>
+ <version>21.3.0</version>
+ </since>
<synopsis>Maximum number of TCP keepalive probes</synopsis>
<description><para>
Specifies the maximum number of TCP keepalive probes to send before considering the connection dead and notifying the application. If the peer does not respond after this many probes, the connection is considered broken.
</para></description>
</configOption>
<configOption name="type">
- <since><version>13.8.0</version></since>
+ <since>
+ <version>13.8.0</version>
+ </since>
<synopsis>Must be of type 'transport'.</synopsis>
</configOption>
<configOption name="verify_client" default="false">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>Require verification of client certificate (TLS ONLY, not WSS)</synopsis>
</configOption>
<configOption name="verify_server" default="false">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>Require verification of server certificate (TLS ONLY, not WSS)</synopsis>
</configOption>
<configOption name="tos" default="false">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>Enable TOS for the signalling sent over this transport</synopsis>
<description>
<para>See <literal>https://docs.asterisk.org/Configuration/Channel-Drivers/IP-Quality-of-Service</literal>
</description>
</configOption>
<configOption name="cos" default="false">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Enable COS for the signalling sent over this transport</synopsis>
<description>
<para>See <literal>https://docs.asterisk.org/Configuration/Channel-Drivers/IP-Quality-of-Service</literal>
</description>
</configOption>
<configOption name="websocket_write_timeout" default="100">
- <since><version>11.11.0</version><version>12.4.0</version></since>
+ <since>
+ <version>11.11.0</version>
+ <version>12.4.0</version>
+ </since>
<synopsis>The timeout (in milliseconds) to set on WebSocket connections.</synopsis>
<description>
<para>If a websocket connection accepts input slowly, the timeout
</description>
</configOption>
<configOption name="allow_reload" default="no">
- <since><version>13.8.0</version></since>
+ <since>
+ <version>13.8.0</version>
+ </since>
<synopsis>Allow this transport to be reloaded.</synopsis>
<description>
<para>Allow this transport to be reloaded when res_pjsip is reloaded.
</description>
</configOption>
<configOption name="allow_wildcard_certs" default="false">
- <since><version>16.28.0</version><version>18.14.0</version><version>19.6.0</version></since>
+ <since>
+ <version>16.28.0</version>
+ <version>18.14.0</version>
+ <version>19.6.0</version>
+ </since>
<synopsis>Allow use of wildcards in certificates (TLS ONLY)</synopsis>
<description>
<para>In combination with verify_server, when enabled allow use of wildcards,
</description>
</configOption>
<configOption name="symmetric_transport" default="no">
- <since><version>13.15.0</version><version>14.4.0</version></since>
+ <since>
+ <version>13.15.0</version>
+ <version>14.4.0</version>
+ </since>
<synopsis>Use the same transport for outgoing requests as incoming ones.</synopsis>
<description>
<para>When a request from a dynamic contact
</configOption>
</configObject>
<configObject name="aor">
- <since><version>13.35.0</version><version>16.12.0</version><version>17.6.0</version></since>
+ <since>
+ <version>13.35.0</version>
+ <version>16.12.0</version>
+ <version>17.6.0</version>
+ </since>
<synopsis>The configuration for a location of an endpoint</synopsis>
<description><para>
An AoR is what allows Asterisk to contact an endpoint via res_pjsip. If no
to the "user name" set in your hard or soft phones configuration.
</para></description>
<configOption name="contact">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>Permanent contacts assigned to AoR</synopsis>
<description><para>
Contacts specified will be called whenever referenced
</para></description>
</configOption>
<configOption name="default_expiration" default="3600">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Default expiration time in seconds for contacts that are dynamically bound to an AoR.</synopsis>
</configOption>
<configOption name="mailboxes">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Allow subscriptions for the specified mailbox(es)</synopsis>
<description><para>This option applies when an external entity subscribes to an AoR
for Message Waiting Indications. The mailboxes specified will be subscribed to.
</para></description>
</configOption>
<configOption name="voicemail_extension">
- <since><version>13.9.0</version></since>
+ <since>
+ <version>13.9.0</version>
+ </since>
<synopsis>The voicemail extension to send in the NOTIFY Message-Account header</synopsis>
</configOption>
<configOption name="maximum_expiration" default="7200">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Maximum time to keep an AoR</synopsis>
<description><para>
Maximum time to keep a peer with explicit expiration. Time in seconds.
</para></description>
</configOption>
<configOption name="max_contacts" default="0">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Maximum number of contacts that can bind to an AoR</synopsis>
<description><para>
Maximum number of contacts that can associate with this AoR. This value does
</description>
</configOption>
<configOption name="minimum_expiration" default="60">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Minimum keep alive time for an AoR</synopsis>
<description><para>
Minimum time to keep a peer with an explicit expiration. Time in seconds.
</para></description>
</configOption>
<configOption name="remove_existing" default="no">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Determines whether new contacts replace existing ones.</synopsis>
<description><para>
On receiving a new registration to the AoR should it remove enough
</description>
</configOption>
<configOption name="remove_unavailable" default="no">
- <since><version>16.22.0</version><version>18.8.0</version></since>
+ <since>
+ <version>16.22.0</version>
+ <version>18.8.0</version>
+ </since>
<synopsis>Determines whether new contacts should replace unavailable ones.</synopsis>
<description><para>
The effect of this setting depends on the setting of
</description>
</configOption>
<configOption name="type">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Must be of type 'aor'.</synopsis>
</configOption>
<configOption name="qualify_frequency" default="0">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Interval at which to qualify an AoR</synopsis>
<description><para>
Interval between attempts to qualify the AoR for reachability.
</para></description>
</configOption>
<configOption name="qualify_timeout" default="3.0">
- <since><version>13.4.0</version></since>
+ <since>
+ <version>13.4.0</version>
+ </since>
<synopsis>Timeout for qualify</synopsis>
<description><para>
If the contact doesn't respond to the OPTIONS request before the timeout,
</para></description>
</configOption>
<configOption name="qualify_2xx_only">
- <since><version>20.12.0</version><version>21.7.0</version><version>22.2.0</version></since>
+ <since>
+ <version>20.12.0</version>
+ <version>21.7.0</version>
+ <version>22.2.0</version>
+ </since>
<synopsis>Only qualify contact if OPTIONS request returns 2XX</synopsis>
<description>
<para>If true only mark a contact as available if the qualify OPTIONS
</description>
</configOption>
<configOption name="authenticate_qualify">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Authenticates a qualify challenge response if needed</synopsis>
<description>
<para>If true and a qualify request receives a challenge response then
</description>
</configOption>
<configOption name="outbound_proxy">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Outbound proxy used when sending OPTIONS request</synopsis>
<description><para>
If set the provided URI will be used as the outbound proxy when an
</para></description>
</configOption>
<configOption name="support_path">
- <since><version>12.1.0</version></since>
+ <since>
+ <version>12.1.0</version>
+ </since>
<synopsis>Enables Path support for REGISTER requests and Route support for other requests.</synopsis>
<description><para>
When this option is enabled, the Path headers in register requests will be saved
</configOption>
</configObject>
<configObject name="system">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>Options that apply to the SIP stack as well as other system-wide settings</synopsis>
<description><para>
The settings in this section are global. In addition to being global, the values will
restart Asterisk, or unload res_pjsip.so and then load it again.
</para></description>
<configOption name="timer_t1" default="500">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Set transaction timer T1 value (milliseconds).</synopsis>
<description><para>
Timer T1 is the base for determining how long to wait before retransmitting
</para></description>
</configOption>
<configOption name="timer_b" default="32000">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Set transaction timer B value (milliseconds).</synopsis>
<description><para>
Timer B determines the maximum amount of time to wait after sending an INVITE
</para></description>
</configOption>
<configOption name="compact_headers" default="no">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Use the short forms of common SIP header names.</synopsis>
</configOption>
<configOption name="threadpool_initial_size" default="0">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Initial number of threads in the res_pjsip threadpool.</synopsis>
</configOption>
<configOption name="threadpool_auto_increment" default="5">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>The amount by which the number of threads is incremented when necessary.</synopsis>
</configOption>
<configOption name="threadpool_idle_timeout" default="60">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Number of seconds before an idle thread should be disposed of.</synopsis>
</configOption>
<configOption name="threadpool_max_size" default="0">
- <since><version>13.7.0</version></since>
+ <since>
+ <version>13.7.0</version>
+ </since>
<synopsis>Maximum number of threads in the res_pjsip threadpool.
A value of 0 indicates no maximum.</synopsis>
</configOption>
<configOption name="disable_tcp_switch" default="yes">
- <since><version>13.1.0</version></since>
+ <since>
+ <version>13.1.0</version>
+ </since>
<synopsis>Disable automatic switching from UDP to TCP transports.</synopsis>
<description><para>
Disable automatic switching from UDP to TCP transports if outgoing
</para></description>
</configOption>
<configOption name="follow_early_media_fork">
- <since><version>13.22.0</version><version>15.5.0</version></since>
+ <since>
+ <version>13.22.0</version>
+ <version>15.5.0</version>
+ </since>
<synopsis>Follow SDP forked media when To tag is different</synopsis>
<description><para>
On outgoing calls, if the UAS responds with different SDP attributes
</description>
</configOption>
<configOption name="accept_multiple_sdp_answers">
- <since><version>13.22.0</version><version>15.5.0</version></since>
+ <since>
+ <version>13.22.0</version>
+ <version>15.5.0</version>
+ </since>
<synopsis>Follow SDP forked media when To tag is the same</synopsis>
<description><para>
On outgoing calls, if the UAS responds with different SDP attributes
</description>
</configOption>
<configOption name="disable_rport" default="no">
- <since><version>13.35.0</version><version>16.12.0</version><version>17.6.0</version></since>
+ <since>
+ <version>13.35.0</version>
+ <version>16.12.0</version>
+ <version>17.6.0</version>
+ </since>
<synopsis>Disable the use of rport in outgoing requests.</synopsis>
<description><para>
Remove "rport" parameter from the outgoing requests.
</para></description>
</configOption>
<configOption name="type">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Must be of type 'system' UNLESS the object name is 'system'.</synopsis>
</configOption>
</configObject>
<configObject name="global">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Options that apply globally to all SIP communications</synopsis>
<description><para>
The settings in this section are global. Unlike options in the <literal>system</literal>
section, these options can be refreshed by performing a reload.
</para></description>
<configOption name="max_forwards" default="70">
- <since><version>13.3.0</version></since>
+ <since>
+ <version>13.3.0</version>
+ </since>
<synopsis>Value used in Max-Forwards header for SIP requests.</synopsis>
</configOption>
<configOption name="keep_alive_interval" default="90">
- <since><version>13.3.0</version></since>
+ <since>
+ <version>13.3.0</version>
+ </since>
<synopsis>The interval (in seconds) to send keepalives to active connection-oriented transports.</synopsis>
</configOption>
<configOption name="contact_expiration_check_interval" default="30">
- <since><version>13.9.0</version></since>
+ <since>
+ <version>13.9.0</version>
+ </since>
<synopsis>The interval (in seconds) to check for expired contacts.</synopsis>
</configOption>
<configOption name="disable_multi_domain" default="no">
- <since><version>13.12.0</version><version>14.1.0</version></since>
+ <since>
+ <version>13.12.0</version>
+ <version>14.1.0</version>
+ </since>
<synopsis>Disable Multi Domain support</synopsis>
<description><para>
If disabled it can improve realtime performance by reducing the number of database requests.
</para></description>
</configOption>
<configOption name="max_initial_qualify_time" default="0">
- <since><version>13.4.0</version></since>
+ <since>
+ <version>13.4.0</version>
+ </since>
<synopsis>The maximum amount of time from startup that qualifies should be attempted on all contacts.
If greater than the qualify_frequency for an aor, qualify_frequency will be used instead.</synopsis>
</configOption>
<configOption name="unidentified_request_period" default="5">
- <since><version>13.10.0</version></since>
+ <since>
+ <version>13.10.0</version>
+ </since>
<synopsis>The number of seconds over which to accumulate unidentified requests.</synopsis>
<description><para>
If <literal>unidentified_request_count</literal> unidentified requests are received
</para></description>
</configOption>
<configOption name="unidentified_request_count" default="5">
- <since><version>13.10.0</version></since>
+ <since>
+ <version>13.10.0</version>
+ </since>
<synopsis>The number of unidentified requests from a single IP to allow.</synopsis>
<description><para>
If <literal>unidentified_request_count</literal> unidentified requests are received
</para></description>
</configOption>
<configOption name="unidentified_request_prune_interval" default="30">
- <since><version>13.10.0</version></since>
+ <since>
+ <version>13.10.0</version>
+ </since>
<synopsis>The interval at which unidentified requests are older than
twice the unidentified_request_period are pruned.</synopsis>
</configOption>
<configOption name="type">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Must be of type 'global' UNLESS the object name is 'global'.</synopsis>
</configOption>
<configOption name="user_agent" default="Asterisk <Asterisk Version>">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Value used in User-Agent header for SIP requests and Server header for SIP responses.</synopsis>
</configOption>
<configOption name="regcontext" default="">
- <since><version>13.8.0</version></since>
+ <since>
+ <version>13.8.0</version>
+ </since>
<synopsis>When set, Asterisk will dynamically create and destroy a NoOp priority 1 extension for a given
peer who registers or unregisters with us.</synopsis>
</configOption>
<configOption name="default_outbound_endpoint" default="default_outbound_endpoint">
- <since><version>13.3.0</version></since>
+ <since>
+ <version>13.3.0</version>
+ </since>
<synopsis>Endpoint to use when sending an outbound request to a URI without a specified endpoint.</synopsis>
</configOption>
<configOption name="default_voicemail_extension">
- <since><version>13.9.0</version></since>
+ <since>
+ <version>13.9.0</version>
+ </since>
<synopsis>The voicemail extension to send in the NOTIFY Message-Account header if not specified on endpoint or aor</synopsis>
</configOption>
<configOption name="debug" default="no">
- <since><version>13.3.0</version></since>
+ <since>
+ <version>13.3.0</version>
+ </since>
<synopsis>Enable/Disable SIP debug logging. Valid options include yes, no, or
a host address</synopsis>
</configOption>
<configOption name="endpoint_identifier_order">
- <since><version>13.3.0</version></since>
+ <since>
+ <version>13.3.0</version>
+ </since>
<synopsis>The order by which endpoint identifiers are processed and checked.
Identifier names are usually derived from and can be found in the endpoint
identifier module itself (res_pjsip_endpoint_identifier_*).
</description>
</configOption>
<configOption name="default_from_user" default="asterisk">
- <since><version>13.6.0</version></since>
+ <since>
+ <version>13.6.0</version>
+ </since>
<synopsis>When Asterisk generates an outgoing SIP request, the From header username will be
set to this value if there is no better option (such as CallerID) to be
used.</synopsis>
</configOption>
<configOption name="default_realm" default="asterisk">
- <since><version>13.10.0</version></since>
+ <since>
+ <version>13.10.0</version>
+ </since>
<synopsis>When Asterisk generates a challenge, the digest realm will be
set to this value if there is no better option (such as auth/realm) to be
used.</synopsis>
</configOption>
<configOption name="mwi_tps_queue_high" default="500">
- <since><version>13.12.0</version><version>14.1.0</version></since>
+ <since>
+ <version>13.12.0</version>
+ <version>14.1.0</version>
+ </since>
<synopsis>MWI taskprocessor high water alert trigger level.</synopsis>
<description>
<para>On a heavily loaded system you may need to adjust the
</description>
</configOption>
<configOption name="mwi_tps_queue_low" default="-1">
- <since><version>13.12.0</version><version>14.1.0</version></since>
+ <since>
+ <version>13.12.0</version>
+ <version>14.1.0</version>
+ </since>
<synopsis>MWI taskprocessor low water clear alert level.</synopsis>
<description>
<para>On a heavily loaded system you may need to adjust the
</description>
</configOption>
<configOption name="mwi_disable_initial_unsolicited" default="no">
- <since><version>13.12.0</version><version>14.1.0</version></since>
+ <since>
+ <version>13.12.0</version>
+ <version>14.1.0</version>
+ </since>
<synopsis>Enable/Disable sending unsolicited MWI to all endpoints on startup.</synopsis>
<description>
<para>When the initial unsolicited MWI notification are
</description>
</configOption>
<configOption name="ignore_uri_user_options">
- <since><version>13.12.0</version><version>14.1.0</version></since>
+ <since>
+ <version>13.12.0</version>
+ <version>14.1.0</version>
+ </since>
<synopsis>Enable/Disable ignoring SIP URI user field options.</synopsis>
<description>
<para>If you have this option enabled and there are semicolons
</description>
</configOption>
<configOption name="use_callerid_contact" default="no">
- <since><version>13.24.0</version><version>16.1.0</version></since>
+ <since>
+ <version>13.24.0</version>
+ <version>16.1.0</version>
+ </since>
<synopsis>Place caller-id information into Contact header</synopsis>
<description><para>
This option will cause Asterisk to place caller-id information into
</description>
</configOption>
<configOption name="send_contact_status_on_update_registration" default="no">
- <since><version>16.2.0</version></since>
+ <since>
+ <version>16.2.0</version>
+ </since>
<synopsis>Enable sending AMI ContactStatus event when a device refreshes its registration.</synopsis>
</configOption>
<configOption name="taskprocessor_overload_trigger">
- <since><version>13.26.0</version><version>16.3.0</version></since>
+ <since>
+ <version>13.26.0</version>
+ <version>16.3.0</version>
+ </since>
<synopsis>Trigger scope for taskprocessor overloads</synopsis>
<description><para>
This option specifies the trigger the distributor will use for
</description>
</configOption>
<configOption name="norefersub" default="yes">
- <since><version>13.27.0</version><version>16.4.0</version></since>
+ <since>
+ <version>13.27.0</version>
+ <version>16.4.0</version>
+ </since>
<synopsis>Advertise support for RFC4488 REFER subscription suppression</synopsis>
</configOption>
<configOption name="allow_sending_180_after_183" default="no">
- <since><version>16.26.0</version><version>18.12.0</version><version>19.4.0</version></since>
+ <since>
+ <version>16.26.0</version>
+ <version>18.12.0</version>
+ <version>19.4.0</version>
+ </since>
<synopsis>Allow 180 after 183</synopsis>
<description><para>
Allow Asterisk to send 180 Ringing to an endpoint
</description>
</configOption>
<configOption name="all_codecs_on_empty_reinvite" default="no">
- <since><version>16.30.0</version><version>18.16.0</version><version>19.8.0</version><version>20.1.0</version></since>
+ <since>
+ <version>16.30.0</version>
+ <version>18.16.0</version>
+ <version>19.8.0</version>
+ <version>20.1.0</version>
+ </since>
<synopsis>If we should return all codecs on re-INVITE without SDP</synopsis>
<description><para>
On reception of a re-INVITE without SDP Asterisk will send an SDP
</para></description>
</configOption>
<configOption name="default_auth_algorithms_uas" default="no">
- <since><version>20.12.0</version><version>21.7.0</version><version>22.2.0</version></since>
+ <since>
+ <version>20.12.0</version>
+ <version>21.7.0</version>
+ <version>22.2.0</version>
+ </since>
<synopsis>List of default authentication algorithms to support when Asterisk is UAS</synopsis>
<description><para>Valid values:</para>
<enumlist>
</description>
</configOption>
<configOption name="default_auth_algorithms_uac" default="no">
- <since><version>20.12.0</version><version>21.7.0</version><version>22.2.0</version></since>
+ <since>
+ <version>20.12.0</version>
+ <version>21.7.0</version>
+ <version>22.2.0</version>
+ </since>
<synopsis>List of default authentication algorithms to support when Asterisk is UAC</synopsis>
<description><para>Valid values:</para>
<enumlist>
</manager>
<managerEvent language="en_US" name="IdentifyDetail">
<managerEventInstance class="EVENT_FLAG_COMMAND">
- <since><version>13.20.0</version><version>15.3.0</version></since>
+ <since>
+ <version>13.20.0</version>
+ <version>15.3.0</version>
+ </since>
<synopsis>Provide details about an identify section.</synopsis>
<syntax>
<parameter name="ObjectType">
</managerEvent>
<managerEvent language="en_US" name="AorDetail">
<managerEventInstance class="EVENT_FLAG_COMMAND">
- <since><version>13.12.0</version><version>14.1.0</version></since>
+ <since>
+ <version>13.12.0</version>
+ <version>14.1.0</version>
+ </since>
<synopsis>Provide details about an Address of Record (AoR) section.</synopsis>
<syntax>
<parameter name="ObjectType">
</managerEvent>
<managerEvent language="en_US" name="AuthDetail">
<managerEventInstance class="EVENT_FLAG_COMMAND">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Provide details about an authentication section.</synopsis>
<syntax>
<parameter name="ObjectType">
</managerEvent>
<managerEvent language="en_US" name="TransportDetail">
<managerEventInstance class="EVENT_FLAG_COMMAND">
- <since><version>12.6.0</version></since>
+ <since>
+ <version>12.6.0</version>
+ </since>
<synopsis>Provide details about an authentication section.</synopsis>
<syntax>
<parameter name="ObjectType">
</managerEvent>
<managerEvent language="en_US" name="EndpointDetail">
<managerEventInstance class="EVENT_FLAG_COMMAND">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Provide details about an endpoint section.</synopsis>
<syntax>
<parameter name="ObjectType">
</managerEvent>
<managerEvent language="en_US" name="AorList">
<managerEventInstance class="EVENT_FLAG_COMMAND">
- <since><version>16.0.0</version></since>
+ <since>
+ <version>16.0.0</version>
+ </since>
<synopsis>Provide details about an Address of Record (AoR) section.</synopsis>
<syntax>
<parameter name="ObjectType">
</managerEvent>
<managerEvent language="en_US" name="AuthList">
<managerEventInstance class="EVENT_FLAG_COMMAND">
- <since><version>16.0.0</version></since>
+ <since>
+ <version>16.0.0</version>
+ </since>
<synopsis>Provide details about an Address of Record (Auth) section.</synopsis>
<syntax>
<parameter name="ObjectType">
</managerEvent>
<managerEvent language="en_US" name="ContactList">
<managerEventInstance class="EVENT_FLAG_COMMAND">
- <since><version>16.0.0</version></since>
+ <since>
+ <version>16.0.0</version>
+ </since>
<synopsis>Provide details about a contact section.</synopsis>
<syntax>
<parameter name="ObjectType">
</managerEvent>
<managerEvent language="en_US" name="ContactStatusDetail">
<managerEventInstance class="EVENT_FLAG_COMMAND">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>Provide details about a contact's status.</synopsis>
<syntax>
<parameter name="AOR">
</managerEvent>
<managerEvent language="en_US" name="EndpointList">
<managerEventInstance class="EVENT_FLAG_COMMAND">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Provide details about a contact's status.</synopsis>
<syntax>
<parameter name="ObjectType">
</list-elements>
<managerEvent language="en_US" name="EndpointListComplete">
<managerEventInstance class="EVENT_FLAG_COMMAND">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Provide final information about an endpoint list.</synopsis>
<syntax>
<parameter name="EventList"/>
</list-elements>
<managerEvent language="en_US" name="EndpointDetailComplete">
<managerEventInstance class="EVENT_FLAG_COMMAND">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Provide final information about endpoint details.</synopsis>
<syntax>
<parameter name="EventList"/>
</list-elements>
<managerEvent language="en_US" name="AorListComplete">
<managerEventInstance class="EVENT_FLAG_COMMAND">
- <since><version>16.0.0</version></since>
+ <since>
+ <version>16.0.0</version>
+ </since>
<synopsis>Provide final information about an aor list.</synopsis>
<syntax>
<parameter name="EventList"/>
</list-elements>
<managerEvent language="en_US" name="AuthListComplete">
<managerEventInstance class="EVENT_FLAG_COMMAND">
- <since><version>16.0.0</version></since>
+ <since>
+ <version>16.0.0</version>
+ </since>
<synopsis>Provide final information about an auth list.</synopsis>
<syntax>
<parameter name="EventList"/>
</list-elements>
<managerEvent language="en_US" name="ContactListComplete">
<managerEventInstance class="EVENT_FLAG_COMMAND">
- <since><version>16.0.0</version></since>
+ <since>
+ <version>16.0.0</version>
+ </since>
<synopsis>Provide final information about a contact list.</synopsis>
<syntax>
<parameter name="EventList"/>
</para></description>
<configFile name="pjsip.conf">
<configObject name="acl">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Access Control List</synopsis>
<configOption name="acl">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>List of IP ACL section names in acl.conf</synopsis>
<description><para>
This matches sections configured in <literal>acl.conf</literal>. The value is
</para></description>
</configOption>
<configOption name="contact_acl">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>List of Contact ACL section names in acl.conf</synopsis>
<description><para>
This matches sections configured in <literal>acl.conf</literal>. The value is
</para></description>
</configOption>
<configOption name="contact_deny">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>List of Contact header addresses to deny</synopsis>
<description><para>
The value is a comma-delimited list of IP addresses. IP addresses may
</para></description>
</configOption>
<configOption name="contact_permit">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>List of Contact header addresses to permit</synopsis>
<description><para>
The value is a comma-delimited list of IP addresses. IP addresses may
</para></description>
</configOption>
<configOption name="deny">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>List of IP addresses to deny access from</synopsis>
<description><para>
The value is a comma-delimited list of IP addresses. IP addresses may
</para></description>
</configOption>
<configOption name="permit">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>List of IP addresses to permit access from</synopsis>
<description><para>
The value is a comma-delimited list of IP addresses. IP addresses may
</para></description>
</configOption>
<configOption name="type">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Must be of type 'acl'.</synopsis>
</configOption>
</configObject>
<synopsis>Module that identifies endpoints</synopsis>
<configFile name="pjsip.conf">
<configObject name="identify">
- <since><version>13.14.0</version><version>14.3.0</version></since>
+ <since>
+ <version>13.14.0</version>
+ <version>14.3.0</version>
+ </since>
<synopsis>Identifies endpoints via some criteria.</synopsis>
<description>
<para>This module provides alternatives to matching inbound requests to
<emphasis>any</emphasis> of the criteria.</para></note>
</description>
<configOption name="endpoint">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Name of endpoint identified</synopsis>
</configOption>
<configOption name="match">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>IP addresses or networks to match against.</synopsis>
<description>
<para>The value is a comma-delimited list of IP addresses or
</description>
</configOption>
<configOption name="srv_lookups" default="yes">
- <since><version>13.14.0</version><version>14.3.0</version></since>
+ <since>
+ <version>13.14.0</version>
+ <version>14.3.0</version>
+ </since>
<synopsis>Perform SRV lookups for provided hostnames.</synopsis>
<description>
<para>When enabled, <replaceable>srv_lookups</replaceable> will
</description>
</configOption>
<configOption name="match_header">
- <since><version>13.15.0</version><version>14.4.0</version></since>
+ <since>
+ <version>13.15.0</version>
+ <version>14.4.0</version>
+ </since>
<synopsis>Header/value pair to match against.</synopsis>
<description>
<para>A SIP header whose value is used to match against. SIP
</description>
</configOption>
<configOption name="match_request_uri">
- <since><version>18.23.0</version><version>20.8.0</version><version>21.3.0</version></since>
+ <since>
+ <version>18.23.0</version>
+ <version>20.8.0</version>
+ <version>21.3.0</version>
+ </since>
<synopsis>Request URI to match against.</synopsis>
<description>
<para>The SIP request URI is used to match against.
</description>
</configOption>
<configOption name="type">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Must be of type 'identify'.</synopsis>
</configOption>
</configObject>
/*** DOCUMENTATION
<function name="PJSIP_HEADER" language="en_US">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>
Gets headers from an inbound PJSIP channel. Adds, updates or removes the
specified SIP header from an outbound PJSIP channel.
</see-also>
</function>
<function name="PJSIP_RESPONSE_HEADER" language="en_US">
- <since><version>16.28.0</version><version>18.14.0</version><version>19.6.0</version></since>
+ <since>
+ <version>16.28.0</version>
+ <version>18.14.0</version>
+ <version>19.6.0</version>
+ </since>
<synopsis>
Gets headers of 200 response from an outbound PJSIP channel.
</synopsis>
</see-also>
</function>
<function name="PJSIP_RESPONSE_HEADERS" language="en_US">
- <since><version>16.28.0</version><version>18.14.0</version><version>19.6.0</version></since>
+ <since>
+ <version>16.28.0</version>
+ <version>18.14.0</version>
+ <version>19.6.0</version>
+ </since>
<synopsis>
Gets the list of SIP header names from the 200 response of INVITE message.
</synopsis>
</see-also>
</function>
<function name="PJSIP_HEADER_PARAM" language="en_US">
- <since><version>18.16.0</version><version>20.1.0</version></since>
+ <since>
+ <version>18.16.0</version>
+ <version>20.1.0</version>
+ </since>
<synopsis>
Get or set header/URI parameters on a PJSIP channel.
</synopsis>
<synopsis>Unused, but reserved.</synopsis>
</configObject>
<configObject name="notify">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Configuration of a NOTIFY request.</synopsis>
<description>
<para>Each key-value pair in a <literal>notify</literal>
</description>
<configFile name="pjsip.conf">
<configObject name="outbound-publish">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>The configuration for outbound publish</synopsis>
<description><para>
Publish is <emphasis>COMPLETELY</emphasis> separate from the rest of
setting a <literal>server_uri</literal> and <literal>event</literal>.
</para></description>
<configOption name="expiration" default="3600">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>Expiration time for publications in seconds</synopsis>
</configOption>
<configOption name="outbound_auth" default="">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>Authentication object(s) to be used for outbound publishes.</synopsis>
<description><para>
This is a comma-delimited list of <replaceable>auth</replaceable>
</description>
</configOption>
<configOption name="outbound_proxy" default="">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>Full SIP URI of the outbound proxy used to send publishes</synopsis>
</configOption>
<configOption name="server_uri">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>SIP URI of the server and entity to publish to</synopsis>
<description><para>
This is the URI at which to find the entity and server to send the outbound PUBLISH to.
</para></description>
</configOption>
<configOption name="from_uri">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>SIP URI to use in the From header</synopsis>
<description><para>
This is the URI that will be placed into the From header of outgoing PUBLISH
</para></description>
</configOption>
<configOption name="to_uri">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>SIP URI to use in the To header</synopsis>
<description><para>
This is the URI that will be placed into the To header of outgoing PUBLISH
</para></description>
</configOption>
<configOption name="event" default="">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>Event type of the PUBLISH.</synopsis>
</configOption>
<configOption name="max_auth_attempts" default="5">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>Maximum number of authentication attempts before stopping the publication.</synopsis>
</configOption>
<configOption name="transport">
- <since><version>13.9.0</version></since>
+ <since>
+ <version>13.9.0</version>
+ </since>
<synopsis>Transport used for outbound publish</synopsis>
<description>
<note><para>A <replaceable>transport</replaceable> configured in
</description>
</configOption>
<configOption name="multi_user" default="no">
- <since><version>14.0.0</version></since>
+ <since>
+ <version>14.0.0</version>
+ </since>
<synopsis>Enable multi-user support</synopsis>
<description><para>When enabled the user portion of the server uri is replaced by a dynamically created user</para></description>
</configOption>
<configOption name="type">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>Must be of type 'outbound-publish'.</synopsis>
</configOption>
</configObject>
</description>
<configFile name="pjsip.conf">
<configObject name="registration">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>The configuration for outbound registration</synopsis>
<description><para>
Registration is <emphasis>COMPLETELY</emphasis> separate from the rest of
setting a <literal>server_uri</literal> and a <literal>client_uri</literal>.
</para></description>
<configOption name="auth_rejection_permanent" default="yes">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Determines whether failed authentication challenges are treated
as permanent failures.</synopsis>
<description><para>If this option is enabled and an authentication challenge fails,
registration will not be attempted again until the configuration is reloaded.</para></description>
</configOption>
<configOption name="client_uri">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Client SIP URI used when attemping outbound registration</synopsis>
<description><para>
This is the address-of-record for the outbound registration (i.e. the URI in
</para></description>
</configOption>
<configOption name="contact_user" default="s">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Contact User to use in request. If this value is not set, this defaults to 's'</synopsis>
</configOption>
<configOption name="contact_header_params">
- <since><version>17.0.0</version></since>
+ <since>
+ <version>17.0.0</version>
+ </since>
<synopsis>Header parameters to place in the Contact header</synopsis>
</configOption>
<configOption name="expiration" default="3600">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Expiration time for registrations in seconds</synopsis>
</configOption>
<configOption name="max_retries" default="10">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Maximum number of registration attempts.</synopsis>
<description><para>
This sets the maximum number of registration attempts that are made before
</para></description>
</configOption>
<configOption name="security_negotiation" default="no">
- <since><version>21.0.0</version></since>
+ <since>
+ <version>21.0.0</version>
+ </since>
<synopsis>The kind of security agreement negotiation to use. Currently, only mediasec is supported.</synopsis>
<description>
<enumlist>
</description>
</configOption>
<configOption name="security_mechanisms">
- <since><version>21.0.0</version></since>
+ <since>
+ <version>21.0.0</version>
+ </since>
<synopsis>List of security mechanisms supported.</synopsis>
<description><para>
This is a comma-delimited list of security mechanisms to use. Each security mechanism
</para></description>
</configOption>
<configOption name="outbound_auth" default="">
- <since><version>12.2.0</version></since>
+ <since>
+ <version>12.2.0</version>
+ </since>
<synopsis>Authentication object(s) to be used for outbound registrations.</synopsis>
<description><para>
This is a comma-delimited list of <replaceable>auth</replaceable>
</description>
</configOption>
<configOption name="outbound_proxy" default="">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Full SIP URI of the outbound proxy used to send registrations</synopsis>
</configOption>
<configOption name="max_random_initial_delay" default="10">
- <since><version>16.27.0</version><version>18.13.0</version><version>19.5.0</version></since>
+ <since>
+ <version>16.27.0</version>
+ <version>18.13.0</version>
+ <version>19.5.0</version>
+ </since>
<synopsis>Maximum interval in seconds for which an initial registration may be randomly delayed</synopsis>
<description>
<para>By default, registrations are randomly delayed by a small amount to prevent
</description>
</configOption>
<configOption name="retry_interval" default="60">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Interval in seconds between retries if outbound registration is unsuccessful</synopsis>
</configOption>
<configOption name="forbidden_retry_interval" default="0">
- <since><version>11.7.0</version></since>
+ <since>
+ <version>11.7.0</version>
+ </since>
<synopsis>Interval used when receiving a 403 Forbidden response.</synopsis>
<description><para>
If a 403 Forbidden is received, chan_pjsip will wait
</para></description>
</configOption>
<configOption name="fatal_retry_interval" default="0">
- <since><version>13.7.0</version></since>
+ <since>
+ <version>13.7.0</version>
+ </since>
<synopsis>Interval used when receiving a Fatal response.</synopsis>
<description><para>
If a fatal response is received, chan_pjsip will wait
</description>
</configOption>
<configOption name="server_uri">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>SIP URI of the server to register against</synopsis>
<description><para>
This is the URI at which to find the registrar to send the outbound REGISTER. This URI
</para></description>
</configOption>
<configOption name="transport">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Transport used for outbound authentication</synopsis>
<description>
<note><para>A <replaceable>transport</replaceable> configured in
</description>
</configOption>
<configOption name="line">
- <since><version>13.4.0</version></since>
+ <since>
+ <version>13.4.0</version>
+ </since>
<synopsis>Whether to add a 'line' parameter to the Contact for inbound call matching</synopsis>
<description><para>
When enabled this option will cause a 'line' parameter to be added to the Contact
</para></description>
</configOption>
<configOption name="endpoint">
- <since><version>13.4.0</version></since>
+ <since>
+ <version>13.4.0</version>
+ </since>
<synopsis>Endpoint to use for incoming related calls</synopsis>
<description><para>
When line support is enabled this configured endpoint name is used for incoming calls
</para></description>
</configOption>
<configOption name="type">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Must be of type 'registration'.</synopsis>
</configOption>
<configOption name="support_path">
- <since><version>12.1.0</version></since>
+ <since>
+ <version>12.1.0</version>
+ </since>
<synopsis>Enables advertising SIP Path support for outbound REGISTER requests.</synopsis>
<description><para>
When this option is enabled, outbound REGISTER requests will advertise
</para></description>
</configOption>
<configOption name="support_outbound">
- <since><version>17.0.0</version></since>
+ <since>
+ <version>17.0.0</version>
+ </since>
<synopsis>Enables advertising SIP Outbound support (RFC5626) for outbound REGISTER requests.</synopsis>
</configOption>
<configOption name="user_agent">
- <since><version>21.2.0</version></since>
+ <since>
+ <version>21.2.0</version>
+ </since>
<synopsis>Overrides the User-Agent header that should be used for outbound REGISTER requests.</synopsis>
</configOption>
</configObject>
<configFile name="pjsip.conf">
<configObject name="phoneprov">
- <since><version>12.7.0</version></since>
+ <since>
+ <version>12.7.0</version>
+ </since>
<synopsis>Provides variables for each user.</synopsis>
<configOption name="type">
- <since><version>13.2.0</version></since>
+ <since>
+ <version>13.2.0</version>
+ </since>
<synopsis>Must be of type 'phoneprov'.</synopsis>
</configOption>
<configOption name="endpoint">
</description>
<configFile name="pjsip.conf">
<configObject name="asterisk-publication">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>The configuration for inbound Asterisk event publication</synopsis>
<description><para>
Publish is <emphasis>COMPLETELY</emphasis> separate from the rest of
<literal>pjsip.conf</literal>.
</para></description>
<configOption name="devicestate_publish">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>Optional name of a publish item that can be used to publish a request for full device state information.</synopsis>
</configOption>
<configOption name="mailboxstate_publish">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>Optional name of a publish item that can be used to publish a request for full mailbox state information.</synopsis>
</configOption>
<configOption name="device_state" default="no">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>Whether we should permit incoming device state events.</synopsis>
</configOption>
<configOption name="device_state_filter">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>Optional regular expression used to filter what devices we accept events for.</synopsis>
</configOption>
<configOption name="mailbox_state" default="no">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>Whether we should permit incoming mailbox state events.</synopsis>
</configOption>
<configOption name="mailbox_state_filter">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>Optional regular expression used to filter what mailboxes we accept events for.</synopsis>
</configOption>
<configOption name="type">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>Must be of type 'asterisk-publication'.</synopsis>
</configOption>
</configObject>
</configOption>
</configObject>
<configObject name="resource_list">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>Resource list configuration parameters.</synopsis>
<description>
<para>This configuration object allows for RFC 4662 resource list subscriptions
</note>
</description>
<configOption name="type">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>Must be of type 'resource_list'</synopsis>
</configOption>
<configOption name="event">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>The SIP event package that the list resource belong to.</synopsis>
<description><para>
The SIP event package describes the types of resources that Asterisk reports
</description>
</configOption>
<configOption name="list_item">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>The name of a resource to report state on</synopsis>
<description>
<para>In general Asterisk looks up list items in the following way:</para>
</description>
</configOption>
<configOption name="full_state" default="no">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>Indicates if the entire list's state should be sent out.</synopsis>
<description>
<para>If this option is enabled, and a resource changes state, then Asterisk will construct
</description>
</configOption>
<configOption name="notification_batch_interval" default="0">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>Time Asterisk should wait, in milliseconds, before sending notifications.</synopsis>
<description>
<para>When a resource's state changes, it may be desired to wait a certain amount before Asterisk
</description>
</configOption>
<configOption name="resource_display_name" default="no">
- <since><version>16.25.0</version><version>18.11.0</version><version>19.3.0</version></since>
+ <since>
+ <version>16.25.0</version>
+ <version>18.11.0</version>
+ <version>19.3.0</version>
+ </since>
<synopsis>Indicates whether display name of resource or the resource name being reported.</synopsis>
<description>
<para>If this option is enabled, the Display Name will be reported as resource name.
</configOption>
</configObject>
<configObject name="inbound-publication">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>The configuration for inbound publications</synopsis>
<configOption name="endpoint" default="">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>Optional name of an endpoint that is only allowed to publish to this resource</synopsis>
</configOption>
<configOption name="type">
- <since><version>13.0.0</version></since>
+ <since>
+ <version>13.0.0</version>
+ </since>
<synopsis>Must be of type 'inbound-publication'.</synopsis>
</configOption>
</configObject>
<synopsis>Resource for integration with Prometheus</synopsis>
<configFile name="prometheus.conf">
<configObject name="general">
- <since><version>17.0.0</version></since>
+ <since>
+ <version>17.0.0</version>
+ </since>
<synopsis>General settings.</synopsis>
<description>
<para>
</note>
</description>
<configOption name="enabled" default="no">
- <since><version>17.0.0</version></since>
+ <since>
+ <version>17.0.0</version>
+ </since>
<synopsis>Enable or disable Prometheus statistics.</synopsis>
<description>
<enumlist>
</description>
</configOption>
<configOption name="core_metrics_enabled" default="yes">
- <since><version>17.0.0</version></since>
+ <since>
+ <version>17.0.0</version>
+ </since>
<synopsis>Enable or disable core metrics.</synopsis>
<description>
<para>
</description>
</configOption>
<configOption name="uri" default="metrics">
- <since><version>17.0.0</version></since>
+ <since>
+ <version>17.0.0</version>
+ </since>
<synopsis>The HTTP URI to serve metrics up on.</synopsis>
</configOption>
<configOption name="auth_username">
- <since><version>17.0.0</version></since>
+ <since>
+ <version>17.0.0</version>
+ </since>
<synopsis>Username to use for Basic Auth.</synopsis>
<description>
<para>
</description>
</configOption>
<configOption name="auth_password">
- <since><version>17.0.0</version></since>
+ <since>
+ <version>17.0.0</version>
+ </since>
<synopsis>Password to use for Basic Auth.</synopsis>
<description>
<para>
</description>
</configOption>
<configOption name="auth_realm" default="Asterisk Prometheus Metrics">
- <since><version>17.0.0</version></since>
+ <since>
+ <version>17.0.0</version>
+ </since>
<synopsis>Auth realm used in challenge responses</synopsis>
</configOption>
</configObject>
<configInfo name="res_resolver_unbound" language="en_US">
<configFile name="resolver_unbound.conf">
<configObject name="general">
- <since><version>14.1.0</version></since>
+ <since>
+ <version>14.1.0</version>
+ </since>
<synopsis>General options for res_resolver_unbound</synopsis>
<configOption name="hosts">
- <since><version>14.0.0</version></since>
+ <since>
+ <version>14.0.0</version>
+ </since>
<synopsis>Full path to an optional hosts file</synopsis>
<description><para>Hosts specified in a hosts file will be resolved within the resolver itself. If a value
of system is provided the system-specific file will be used.</para></description>
</configOption>
<configOption name="resolv">
- <since><version>14.0.0</version></since>
+ <since>
+ <version>14.0.0</version>
+ </since>
<synopsis>Full path to an optional resolv.conf file</synopsis>
<description><para>The resolv.conf file specifies the nameservers to contact when resolving queries. If a
value of system is provided the system-specific file will be used. If provided alongside explicit nameservers the
nameservers contained within the resolv.conf file will be used after all others.</para></description>
</configOption>
<configOption name="nameserver">
- <since><version>14.0.0</version></since>
+ <since>
+ <version>14.0.0</version>
+ </since>
<synopsis>Nameserver to use for queries</synopsis>
<description><para>An explicit nameserver can be specified which is used for resolving queries. If multiple
nameserver lines are specified the first will be the primary with failover occurring, in order, to the other
used before all others.</para></description>
</configOption>
<configOption name="debug">
- <since><version>14.0.0</version></since>
+ <since>
+ <version>14.0.0</version>
+ </since>
<synopsis>Unbound debug level</synopsis>
<description><para>The debugging level for the unbound resolver. While there is no explicit range generally
the higher the number the more debug is output.</para></description>
</configOption>
<configOption name="ta_file">
- <since><version>14.0.0</version></since>
+ <since>
+ <version>14.0.0</version>
+ </since>
<synopsis>Trust anchor file</synopsis>
<description><para>Full path to a file with DS and DNSKEY records in zone file format. This file is provided
to unbound and is used as a source for trust anchors.</para></description>
/*** DOCUMENTATION
<function name="SMDI_MSG_RETRIEVE" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.4.19</version>
+ </since>
<synopsis>
Retrieve an SMDI message.
</synopsis>
</see-also>
</function>
<function name="SMDI_MSG" language="en_US">
- <since><version>1.6.2.0</version></since>
+ <since>
+ <version>1.4.19</version>
+ </since>
<synopsis>
Retrieve details about an SMDI message.
</synopsis>
</description>
<configFile name="statsd.conf">
<configObject name="global">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Global configuration settings</synopsis>
<configOption name="enabled">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Enable/disable the StatsD module</synopsis>
</configOption>
<configOption name="server">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Address of the StatsD server</synopsis>
</configOption>
<configOption name="prefix">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Prefix to prepend to every metric</synopsis>
</configOption>
<configOption name="add_newline">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Append a newline to every event. This is useful if
you want to fake out a server using netcat
(nc -lu 8125)</synopsis>
</configOption>
<configOption name="meter_support">
- <since><version>16.20.0</version><version>18.6.0</version></since>
+ <since>
+ <version>16.20.0</version>
+ <version>18.6.0</version>
+ </since>
<synopsis>Enable/disable the non-standard StatsD Meter type,
if disabled falls back to counter and will append a "_meter" suffix to the metric name</synopsis>
</configOption>
<synopsis>STIR/SHAKEN module for Asterisk</synopsis>
<configFile name="stir_shaken.conf">
<configObject name="attestation">
- <since><version>18.22.0</version><version>20.7.0</version><version>21.2.0</version></since>
+ <since>
+ <version>18.22.0</version>
+ <version>20.7.0</version>
+ <version>21.2.0</version>
+ </since>
<synopsis>STIR/SHAKEN attestation options</synopsis>
<configOption name="global_disable" default="false">
- <since><version>18.22.0</version><version>20.7.0</version><version>21.2.0</version></since>
+ <since>
+ <version>18.22.0</version>
+ <version>20.7.0</version>
+ <version>21.2.0</version>
+ </since>
<synopsis>Globally disable verification</synopsis>
</configOption>
<configOption name="private_key_file" default="">
- <since><version>18.22.0</version><version>20.7.0</version><version>21.2.0</version></since>
+ <since>
+ <version>18.22.0</version>
+ <version>20.7.0</version>
+ <version>21.2.0</version>
+ </since>
<synopsis>File path to a certificate</synopsis>
</configOption>
<configOption name="public_cert_url" default="">
- <since><version>18.22.0</version><version>20.7.0</version><version>21.2.0</version></since>
+ <since>
+ <version>18.22.0</version>
+ <version>20.7.0</version>
+ <version>21.2.0</version>
+ </since>
<synopsis>URL to the public certificate</synopsis>
<description><para>
Must be a valid http, or https, URL.
</para></description>
</configOption>
<configOption name="attest_level">
- <since><version>18.22.0</version><version>20.7.0</version><version>21.2.0</version></since>
+ <since>
+ <version>18.22.0</version>
+ <version>20.7.0</version>
+ <version>21.2.0</version>
+ </since>
<synopsis>Attestation level</synopsis>
</configOption>
<configOption name="unknown_tn_attest_level">
- <since><version>20.12.0</version><version>21.7.0</version><version>22.2.0</version></since>
+ <since>
+ <version>20.12.0</version>
+ <version>21.7.0</version>
+ <version>22.2.0</version>
+ </since>
<synopsis>Attestation level to use for unknown TNs</synopsis>
<description><para>
Normally if a callerid TN isn't configured in stir_shaken.conf
</para></description>
</configOption>
<configOption name="check_tn_cert_public_url" default="false">
- <since><version>18.22.0</version><version>20.7.0</version><version>21.2.0</version></since>
+ <since>
+ <version>18.22.0</version>
+ <version>20.7.0</version>
+ <version>21.2.0</version>
+ </since>
<synopsis>On load, Retrieve all TN's certificates and validate their dates</synopsis>
</configOption>
<configOption name="send_mky" default="no">
- <since><version>18.22.0</version><version>20.7.0</version><version>21.2.0</version></since>
+ <since>
+ <version>18.22.0</version>
+ <version>20.7.0</version>
+ <version>21.2.0</version>
+ </since>
<synopsis>Send a media key (mky) grant in the attestation for DTLS calls.
(not common)</synopsis>
</configOption>
</configObject>
<configObject name="tn">
- <since><version>18.22.0</version><version>20.7.0</version><version>21.2.0</version></since>
+ <since>
+ <version>18.22.0</version>
+ <version>20.7.0</version>
+ <version>21.2.0</version>
+ </since>
<synopsis>STIR/SHAKEN TN options</synopsis>
<configOption name="type">
- <since><version>18.22.0</version><version>20.7.0</version><version>21.2.0</version></since>
+ <since>
+ <version>18.22.0</version>
+ <version>20.7.0</version>
+ <version>21.2.0</version>
+ </since>
<synopsis>Must be of type 'tn'.</synopsis>
</configOption>
<configOption name="private_key_file" default="">
- <since><version>18.22.0</version><version>20.7.0</version><version>21.2.0</version></since>
+ <since>
+ <version>18.22.0</version>
+ <version>20.7.0</version>
+ <version>21.2.0</version>
+ </since>
<synopsis>File path to a certificate</synopsis>
</configOption>
<configOption name="public_cert_url" default="">
- <since><version>18.22.0</version><version>20.7.0</version><version>21.2.0</version></since>
+ <since>
+ <version>18.22.0</version>
+ <version>20.7.0</version>
+ <version>21.2.0</version>
+ </since>
<synopsis>URL to the public certificate</synopsis>
<description><para>
Must be a valid http, or https, URL.
</para></description>
</configOption>
<configOption name="attest_level">
- <since><version>18.22.0</version><version>20.7.0</version><version>21.2.0</version></since>
+ <since>
+ <version>18.22.0</version>
+ <version>20.7.0</version>
+ <version>21.2.0</version>
+ </since>
<synopsis>Attestation level</synopsis>
</configOption>
<configOption name="check_tn_cert_public_url" default="false">
- <since><version>18.22.0</version><version>20.7.0</version><version>21.2.0</version></since>
+ <since>
+ <version>18.22.0</version>
+ <version>20.7.0</version>
+ <version>21.2.0</version>
+ </since>
<synopsis>On load, Retrieve all TN's certificates and validate their dates</synopsis>
</configOption>
<configOption name="send_mky" default="no">
- <since><version>18.22.0</version><version>20.7.0</version><version>21.2.0</version></since>
+ <since>
+ <version>18.22.0</version>
+ <version>20.7.0</version>
+ <version>21.2.0</version>
+ </since>
<synopsis>Send a media key (mky) grant in the attestation for DTLS calls.
(not common)</synopsis>
</configOption>
</configObject>
<configObject name="verification">
- <since><version>18.22.0</version><version>20.7.0</version><version>21.2.0</version></since>
+ <since>
+ <version>18.22.0</version>
+ <version>20.7.0</version>
+ <version>21.2.0</version>
+ </since>
<synopsis>STIR/SHAKEN verification options</synopsis>
<configOption name="global_disable" default="false">
- <since><version>18.22.0</version><version>20.7.0</version><version>21.2.0</version></since>
+ <since>
+ <version>18.22.0</version>
+ <version>20.7.0</version>
+ <version>21.2.0</version>
+ </since>
<synopsis>Globally disable verification</synopsis>
</configOption>
<configOption name="load_system_certs" default="">
- <since><version>18.22.0</version><version>20.7.0</version><version>21.2.0</version></since>
+ <since>
+ <version>18.22.0</version>
+ <version>20.7.0</version>
+ <version>21.2.0</version>
+ </since>
<synopsis>A boolean indicating whether trusted CA certificates should be loaded from the system</synopsis>
</configOption>
<configOption name="ca_file" default="">
- <since><version>18.22.0</version><version>20.7.0</version><version>21.2.0</version></since>
+ <since>
+ <version>18.22.0</version>
+ <version>20.7.0</version>
+ <version>21.2.0</version>
+ </since>
<synopsis>Path to a file containing one or more CA certs in PEM format</synopsis>
<description>
<para>These certs are used to verify the chain of trust for the
</description>
</configOption>
<configOption name="ca_path" default="">
- <since><version>18.22.0</version><version>20.7.0</version><version>21.2.0</version></since>
+ <since>
+ <version>18.22.0</version>
+ <version>20.7.0</version>
+ <version>21.2.0</version>
+ </since>
<synopsis>Path to a directory containing one or more hashed CA certs</synopsis>
<description>
<xi:include xpointer="xpointer(/docs/configInfo[@name='res_stir_shaken']/configFile[@name='stir_shaken.conf']/configObject[@name='verification']/configOption[@name='ca_file']/description/node())" />
</description>
</configOption>
<configOption name="crl_file" default="">
- <since><version>18.22.0</version><version>20.7.0</version><version>21.2.0</version></since>
+ <since>
+ <version>18.22.0</version>
+ <version>20.7.0</version>
+ <version>21.2.0</version>
+ </since>
<synopsis>Path to a file containing one or more CRLs in PEM format</synopsis>
<description>
<para>If you with to check if the certificate in the X5U Identity header
</description>
</configOption>
<configOption name="crl_path" default="">
- <since><version>18.22.0</version><version>20.7.0</version><version>21.2.0</version></since>
+ <since>
+ <version>18.22.0</version>
+ <version>20.7.0</version>
+ <version>21.2.0</version>
+ </since>
<synopsis>Path to a directory containing one or more hashed CRLs</synopsis>
<description>
<xi:include xpointer="xpointer(/docs/configInfo[@name='res_stir_shaken']/configFile[@name='stir_shaken.conf']/configObject[@name='verification']/configOption[@name='crl_file']/description/node())" />
</description>
</configOption>
<configOption name="untrusted_cert_file" default="">
- <since><version>18.22.0</version><version>20.7.0</version><version>21.2.0</version></since>
+ <since>
+ <version>18.22.0</version>
+ <version>20.7.0</version>
+ <version>21.2.0</version>
+ </since>
<synopsis>Path to a file containing one or more untrusted cert in PEM format used to verify CRLs</synopsis>
<description>
<para>If you with to check if the certificate in the X5U Identity header
</description>
</configOption>
<configOption name="untrusted_cert_path" default="">
- <since><version>18.22.0</version><version>20.7.0</version><version>21.2.0</version></since>
+ <since>
+ <version>18.22.0</version>
+ <version>20.7.0</version>
+ <version>21.2.0</version>
+ </since>
<synopsis>Path to a directory containing one or more hashed untrusted certs used to verify CRLs</synopsis>
<description>
<xi:include xpointer="xpointer(/docs/configInfo[@name='res_stir_shaken']/configFile[@name='stir_shaken.conf']/configObject[@name='verification']/configOption[@name='untrusted_cert_file']/description/node())" />
</description>
</configOption>
<configOption name="cert_cache_dir" default="">
- <since><version>18.22.0</version><version>20.7.0</version><version>21.2.0</version></since>
+ <since>
+ <version>18.22.0</version>
+ <version>20.7.0</version>
+ <version>21.2.0</version>
+ </since>
<synopsis>Directory to cache retrieved verification certs</synopsis>
</configOption>
<configOption name="curl_timeout" default="2">
- <since><version>18.22.0</version><version>20.7.0</version><version>21.2.0</version></since>
+ <since>
+ <version>18.22.0</version>
+ <version>20.7.0</version>
+ <version>21.2.0</version>
+ </since>
<synopsis>Maximum time to wait to CURL certificates</synopsis>
</configOption>
<configOption name="max_cache_entry_age" default="60">
- <since><version>18.22.0</version><version>20.7.0</version><version>21.2.0</version></since>
+ <since>
+ <version>18.22.0</version>
+ <version>20.7.0</version>
+ <version>21.2.0</version>
+ </since>
<synopsis>Number of seconds a cache entry may be behind current time</synopsis>
</configOption>
<configOption name="max_cache_size" default="1000">
- <since><version>18.22.0</version><version>20.7.0</version><version>21.2.0</version></since>
+ <since>
+ <version>18.22.0</version>
+ <version>20.7.0</version>
+ <version>21.2.0</version>
+ </since>
<synopsis>Maximum size to use for caching public keys</synopsis>
</configOption>
<configOption name="max_iat_age" default="15">
- <since><version>18.22.0</version><version>20.7.0</version><version>21.2.0</version></since>
+ <since>
+ <version>18.22.0</version>
+ <version>20.7.0</version>
+ <version>21.2.0</version>
+ </since>
<synopsis>Number of seconds an iat grant may be behind current time</synopsis>
</configOption>
<configOption name="max_date_header_age" default="15">
- <since><version>18.22.0</version><version>20.7.0</version><version>21.2.0</version></since>
+ <since>
+ <version>18.22.0</version>
+ <version>20.7.0</version>
+ <version>21.2.0</version>
+ </since>
<synopsis>Number of seconds a SIP Date header may be behind current time</synopsis>
</configOption>
<configOption name="failure_action" default="continue">
- <since><version>18.22.0</version><version>20.7.0</version><version>21.2.0</version></since>
+ <since>
+ <version>18.22.0</version>
+ <version>20.7.0</version>
+ <version>21.2.0</version>
+ </since>
<synopsis>The default failure action when not set on a profile</synopsis>
<description>
<enumlist>
</description>
</configOption>
<configOption name="use_rfc9410_responses" default="no">
- <since><version>18.22.0</version><version>20.7.0</version><version>21.2.0</version></since>
+ <since>
+ <version>18.22.0</version>
+ <version>20.7.0</version>
+ <version>21.2.0</version>
+ </since>
<synopsis>RFC9410 uses the STIR protocol on Reason headers
instead of the SIP protocol</synopsis>
</configOption>
<configOption name="relax_x5u_port_scheme_restrictions" default="no">
- <since><version>18.22.0</version><version>20.7.0</version><version>21.2.0</version></since>
+ <since>
+ <version>18.22.0</version>
+ <version>20.7.0</version>
+ <version>21.2.0</version>
+ </since>
<synopsis>Relaxes check for "https" and port 443 or 8443
in incoming Identity header x5u URLs.</synopsis>
</configOption>
<configOption name="relax_x5u_path_restrictions" default="no">
- <since><version>18.22.0</version><version>20.7.0</version><version>21.2.0</version></since>
+ <since>
+ <version>18.22.0</version>
+ <version>20.7.0</version>
+ <version>21.2.0</version>
+ </since>
<synopsis>Relaxes check for query parameters, user/password, etc.
in incoming Identity header x5u URLs.</synopsis>
</configOption>
<configOption name="x5u_acl" default="">
- <since><version>18.22.0</version><version>20.7.0</version><version>21.2.0</version></since>
+ <since>
+ <version>18.22.0</version>
+ <version>20.7.0</version>
+ <version>21.2.0</version>
+ </since>
<synopsis>An existing ACL from acl.conf to use when checking
hostnames in incoming Identity header x5u URLs.</synopsis>
</configOption>
<configOption name="x5u_permit" default="">
- <since><version>18.22.0</version><version>20.7.0</version><version>21.2.0</version></since>
+ <since>
+ <version>18.22.0</version>
+ <version>20.7.0</version>
+ <version>21.2.0</version>
+ </since>
<synopsis>An IP or subnet to permit when checking
hostnames in incoming Identity header x5u URLs.</synopsis>
</configOption>
<configOption name="x5u_deny" default="">
- <since><version>18.22.0</version><version>20.7.0</version><version>21.2.0</version></since>
+ <since>
+ <version>18.22.0</version>
+ <version>20.7.0</version>
+ <version>21.2.0</version>
+ </since>
<synopsis>An IP or subnet to deny checking
hostnames in incoming Identity header x5u URLs.</synopsis>
</configOption>
</configObject>
<configObject name="profile">
- <since><version>18.22.0</version><version>20.7.0</version><version>21.2.0</version></since>
+ <since>
+ <version>18.22.0</version>
+ <version>20.7.0</version>
+ <version>21.2.0</version>
+ </since>
<synopsis>STIR/SHAKEN profile configuration options</synopsis>
<configOption name="type">
- <since><version>18.22.0</version><version>20.7.0</version><version>21.2.0</version></since>
+ <since>
+ <version>18.22.0</version>
+ <version>20.7.0</version>
+ <version>21.2.0</version>
+ </since>
<synopsis>Must be of type 'profile'.</synopsis>
</configOption>
<xi:include xpointer="xpointer(/docs/configInfo[@name='res_stir_shaken']/configFile[@name='stir_shaken.conf']/configObject[@name='verification']/configOption[@name='load_system_certs'])" />
<xi:include xpointer="xpointer(/docs/configInfo[@name='res_stir_shaken']/configFile[@name='stir_shaken.conf']/configObject[@name='attestation']/configOption[@name='unknown_tn_attest_level'])" />
<xi:include xpointer="xpointer(/docs/configInfo[@name='res_stir_shaken']/configFile[@name='stir_shaken.conf']/configObject[@name='attestation']/configOption[@name='send_mky'])" />
<configOption name="endpoint_behavior" default="off">
- <since><version>18.22.0</version><version>20.7.0</version><version>21.2.0</version></since>
+ <since>
+ <version>18.22.0</version>
+ <version>20.7.0</version>
+ <version>21.2.0</version>
+ </since>
<synopsis>Actions performed when an endpoint references this profile</synopsis>
<description>
<enumlist>
</configFile>
</configInfo>
<function name="STIR_SHAKEN" language="en_US">
- <since><version>16.15.0</version></since>
+ <since>
+ <version>16.15.0</version>
+ </since>
<synopsis>
Gets the number of STIR/SHAKEN results or a specific STIR/SHAKEN value from a result on the channel.
</synopsis>
/*** DOCUMENTATION
<application name="JabberSend" language="en_US" module="res_xmpp">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>
Sends an XMPP message to a buddy.
</synopsis>
</see-also>
</application>
<function name="JABBER_RECEIVE" language="en_US" module="res_xmpp">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>
Reads XMPP messages.
</synopsis>
</see-also>
</function>
<function name="JABBER_STATUS" language="en_US" module="res_xmpp">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>
Retrieves a buddy's status.
</synopsis>
</see-also>
</function>
<application name="JabberSendGroup" language="en_US" module="res_xmpp">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>
Send a Jabber Message to a specified chat room
</synopsis>
</description>
</application>
<application name="JabberJoin" language="en_US" module="res_xmpp">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>
Join a chat room
</synopsis>
</description>
</application>
<application name="JabberLeave" language="en_US" module="res_xmpp">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>
Leave a chat room
</synopsis>
<synopsis>XMPP Messaging</synopsis>
<configFile name="xmpp.conf">
<configObject name="global">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Global configuration settings</synopsis>
<configOption name="debug">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Enable/disable XMPP message debugging</synopsis>
</configOption>
<configOption name="autoprune">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Auto-remove users from buddy list.</synopsis>
<description><para>Auto-remove users from buddy list. Depending on the setup
(e.g., using your personal Gtalk account for a test) this could cause loss of
</para></description>
</configOption>
<configOption name="autoregister">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Auto-register users from buddy list</synopsis>
</configOption>
<configOption name="collection_nodes">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Enable support for XEP-0248 for use with distributed device state</synopsis>
</configOption>
<configOption name="pubsub_autocreate">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Whether or not the PubSub server supports/is using auto-create for nodes</synopsis>
</configOption>
<configOption name="auth_policy">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Whether to automatically accept or deny users' subscription requests</synopsis>
</configOption>
</configObject>
<configObject name="client">
- <since><version>12.0.0</version></since>
+ <since>
+ <version>12.0.0</version>
+ </since>
<synopsis>Configuration options for an XMPP client</synopsis>
<configOption name="username">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>XMPP username with optional resource</synopsis>
</configOption>
<configOption name="secret">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>XMPP password</synopsis>
</configOption>
<configOption name="refresh_token">
- <since><version>13.18.0</version><version>14.7.0</version><version>15.1.0</version></since>
+ <since>
+ <version>13.18.0</version>
+ <version>14.7.0</version>
+ <version>15.1.0</version>
+ </since>
<synopsis>Google OAuth 2.0 refresh token</synopsis>
</configOption>
<configOption name="oauth_clientid">
- <since><version>13.18.0</version><version>14.7.0</version><version>15.1.0</version></since>
+ <since>
+ <version>13.18.0</version>
+ <version>14.7.0</version>
+ <version>15.1.0</version>
+ </since>
<synopsis>Google OAuth 2.0 application's client id</synopsis>
</configOption>
<configOption name="oauth_secret">
- <since><version>13.18.0</version><version>14.7.0</version><version>15.1.0</version></since>
+ <since>
+ <version>13.18.0</version>
+ <version>14.7.0</version>
+ <version>15.1.0</version>
+ </since>
<synopsis>Google OAuth 2.0 application's secret</synopsis>
</configOption>
<configOption name="serverhost">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Route to server, e.g. talk.google.com</synopsis>
</configOption>
<configOption name="statusmessage">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Custom status message</synopsis>
</configOption>
<configOption name="pubsub_node">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Node for publishing events via PubSub</synopsis>
</configOption>
<configOption name="context">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Dialplan context to send incoming messages to</synopsis>
</configOption>
<configOption name="priority">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>XMPP resource priority</synopsis>
</configOption>
<configOption name="port">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>XMPP server port</synopsis>
</configOption>
<configOption name="timeout">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Timeout in seconds to hold incoming messages</synopsis>
<description><para>Timeout (in seconds) on the message stack. Messages stored longer
than this value will be deleted by Asterisk. This option applies to incoming messages only
</para></description>
</configOption>
<configOption name="debug">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Enable debugging</synopsis>
</configOption>
<configOption name="type">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Connection is either a client or a component</synopsis>
</configOption>
<configOption name="distribute_events">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Whether or not to distribute events using this connection</synopsis>
</configOption>
<configOption name="usetls">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Whether to use TLS for the connection or not</synopsis>
</configOption>
<configOption name="usesasl">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Whether to use SASL for the connection or not</synopsis>
</configOption>
<configOption name="forceoldssl">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Force the use of old-style SSL for the connection</synopsis>
</configOption>
<configOption name="keepalive">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>If enabled, periodically send an XMPP message from this client with an empty message</synopsis>
</configOption>
<configOption name="autoprune">
- <since><version>11.18.0</version><version>13.4.0</version></since>
+ <since>
+ <version>11.18.0</version>
+ <version>13.4.0</version>
+ </since>
<synopsis>Auto-remove users from buddy list.</synopsis>
<description><para>Auto-remove users from buddy list. Depending on the setup
(e.g., using your personal Gtalk account for a test) this could cause loss of
</para></description>
</configOption>
<configOption name="autoregister">
- <since><version>11.18.0</version><version>13.4.0</version></since>
+ <since>
+ <version>11.18.0</version>
+ <version>13.4.0</version>
+ </since>
<synopsis>Auto-register users bfrom buddy list</synopsis>
</configOption>
<configOption name="auth_policy">
- <since><version>11.18.0</version><version>13.4.0</version></since>
+ <since>
+ <version>11.18.0</version>
+ <version>13.4.0</version>
+ </since>
<synopsis>Whether to automatically accept or deny users' subscription requests</synopsis>
</configOption>
<configOption name="sendtodialplan">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Send incoming messages into the dialplan</synopsis>
</configOption>
<configOption name="status">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Default XMPP status for the client</synopsis>
<description><para>Can be one of the following XMPP statuses:</para>
<enumlist>
</description>
</configOption>
<configOption name="buddy">
- <since><version>11.0.0</version></since>
+ <since>
+ <version>11.0.0</version>
+ </since>
<synopsis>Manual addition of buddy to list</synopsis>
<description><para>
Manual addition of buddy to the buddy list. For distributed events, these buddies are