[asterisk-commits] eliel: branch group/appdocsxml r146405 - /team/group/appdocsxml/funcs/
SVN commits to the Asterisk project
asterisk-commits at lists.digium.com
Sat Oct 4 16:05:53 CDT 2008
Author: eliel
Date: Sat Oct 4 16:05:53 2008
New Revision: 146405
URL: http://svn.digium.com/view/asterisk?view=rev&rev=146405
Log:
Introduce CHANNEL() and CHANNELS() functions XML documentation.
Modified:
team/group/appdocsxml/funcs/func_channel.c
team/group/appdocsxml/funcs/func_cut.c
Modified: team/group/appdocsxml/funcs/func_channel.c
URL: http://svn.digium.com/view/asterisk/team/group/appdocsxml/funcs/func_channel.c?view=diff&rev=146405&r1=146404&r2=146405
==============================================================================
--- team/group/appdocsxml/funcs/func_channel.c (original)
+++ team/group/appdocsxml/funcs/func_channel.c Sat Oct 4 16:05:53 2008
@@ -37,6 +37,107 @@
#include "asterisk/app.h"
#include "asterisk/indications.h"
#include "asterisk/stringfields.h"
+
+/*** DOCUMENTATION
+ <function name="CHANNELS" language="en_US">
+ <synopsis>
+ Gets the list of channels, optionally filtering by a regular expression.
+ </synopsis>
+ <syntax>
+ <parameter name="regular_expression" />
+ </syntax>
+ <description>
+ <para>Gets the list of channels, optionally filtering by a <replaceable>regular_expression</replaceable>. If
+ no argument is provided, all known channels are returned. The
+ <replaceable>regular_expression</replaceable> must correspond to
+ the POSIX.2 specification, as shown in <emphasis>regex(7)</emphasis>. The list returned
+ will be space-delimited.</para>
+ </description>
+ </function>
+ <function name="CHANNEL" language="en_US">
+ <synopsis>
+ Gets/sets various pieces of information about the channel.
+ </synopsis>
+ <syntax>
+ <parameter name="item" required="true">
+ <para>Standard items (provided by all channel technologies) are:</para>
+ <para>R/O <literal>audioreadformat</literal> format currently being read</para>
+ <para>R/O <literal>audionativeformat</literal> format used natively for audio</para>
+ <para>R/O <literal>audiowriteformat</literal> format currently being written</para>
+ <para>R/W <literal>callgroup</literal> call groups for call pickup</para>
+ <para>R/O <literal>channeltype</literal> technology used for channel</para>
+ <para>R/W <literal>language</literal> language for sounds played</para>
+ <para>R/W <literal>musicclass</literal> class (from musiconhold.conf) for hold music</para>
+ <para>R/W <literal>parkinglot</literal> parkinglot for parking</para>
+ <para>R/W <literal>rxgain</literal> set rxgain level on channel drivers that support it</para>
+ <para>R/O <literal>state</literal> state for channel</para>
+ <para>R/W <literal>tonezone</literal> zone for indications played</para>
+ <para>R/W <literal>txgain</literal> set txgain level on channel drivers that support it</para>
+ <para>R/O <literal>videonativeformat</literal> format used natively for video</para>
+ <para>R/W <literal>trace</literal> whether or not context tracing is enabled</para>
+ <para><emphasis>chan_sip</emphasis> provides the following additional options:</para>
+ <para>R/O <literal>peerip</literal> Get the IP address of the peer</para>
+ <para>R/O <literal>recvip</literal> Get the source IP address of the peer</para>
+ <para>R/O <literal>from</literal> Get the URI from the From: header</para>
+ <para>R/O <literal>uri</literal> Get the URI from the Contact: header</para>
+ <para>R/O <literal>useragent</literal> Get the useragent</para>
+ <para>R/O <literal>peername</literal> Get the name of the peer</para>
+ <para>R/O <literal>t38passthrough</literal> 1 if T38 is offered or enabled in this channel, otherwise 0</para>
+ <para>R/O <literal>rtpqos</literal> Get QOS information about the RTP stream</para>
+ <para> This option takes two additional arguments:</para>
+ <para> Argument 1:</para>
+ <para> <literal>audio</literal> Get data about the audio stream</para>
+ <para> <literal>video</literal> Get data about the video stream</para>
+ <para> <literal>text</literal> Get data about the text stream</para>
+ <para> Argument 2:</para>
+ <para> <literal>local_ssrc</literal> Local SSRC (stream ID)</para>
+ <para> <literal>local_lostpackets</literal> Local lost packets</para>
+ <para> <literal>local_jitter</literal> Local calculated jitter</para>
+ <para> <literal>local_maxjitter</literal> Local calculated jitter (maximum)</para>
+ <para> <literal>local_minjitter</literal> Local calculated jitter (minimum)</para>
+ <para> <literal>local_normdevjitter</literal>Local calculated jitter (normal deviation)</para>
+ <para> <literal>local_stdevjitter</literal> Local calculated jitter (standard deviation)</para>
+ <para> <literal>local_count</literal> Number of received packets</para>
+ <para> <literal>remote_ssrc</literal> Remote SSRC (stream ID)</para>
+ <para> <literal>remote_lostpackets</literal>Remote lost packets</para>
+ <para> <literal>remote_jitter</literal> Remote reported jitter</para>
+ <para> <literal>remote_maxjitter</literal> Remote calculated jitter (maximum)</para>
+ <para> <literal>remote_minjitter</literal> Remote calculated jitter (minimum)</para>
+ <para> <literal>remote_normdevjitter</literal>Remote calculated jitter (normal deviation)</para>
+ <para> <literal>remote_stdevjitter</literal>Remote calculated jitter (standard deviation)</para>
+ <para> <literal>remote_count</literal> Number of transmitted packets</para>
+ <para> <literal>remote_ssrc</literal> Remote SSRC (stream ID)</para>
+ <para> <literal>remote_lostpackets</literal>Remote lost packets</para>
+ <para> <literal>remote_jitter</literal> Remote reported jitter</para>
+ <para> <literal>remote_maxjitter</literal> Remote calculated jitter (maximum)</para>
+ <para> <literal>remote_minjitter</literal> Remote calculated jitter (minimum)</para>
+ <para> <literal>remote_normdevjitter</literal>Remote calculated jitter (normal deviation)</para>
+ <para> <literal>remote_stdevjitter</literal>Remote calculated jitter (standard deviation)</para>
+ <para> <literal>remote_count</literal> Number of transmitted packets</para>
+ <para> <literal>rtt</literal> Round trip time</para>
+ <para> <literal>maxrtt</literal> Round trip time (maximum)</para>
+ <para> <literal>minrtt</literal> Round trip time (minimum)</para>
+ <para> <literal>normdevrtt</literal> Round trip time (normal deviation)</para>
+ <para> <literal>stdevrtt</literal> Round trip time (standard deviation)</para>
+ <para> <literal>all</literal> All statistics (in a form suited to logging, but not for parsing)</para>
+ <para>R/O <literal>rtpdest</literal> Get remote RTP destination information</para>
+ <para> This option takes one additional argument:</para>
+ <para> Argument 1:</para>
+ <para> <literal>audio</literal> Get audio destination</para>
+ <para> <literal>video</literal> Get video destination</para>
+ <para><emphasis>chan_iax2</emphasis> provides the following additional options:</para>
+ <para>R/W <literal>osptoken</literal> Get or set the OSP token information for a call</para>
+ <para>R/O <literal>peerip</literal> Get the peer's ip address</para>
+ <para>R/O <literal>peername</literal> Get the peer's username</para>
+ </parameter>
+ </syntax>
+ <description>
+ <para>Gets/sets various pieces of information about the channel, additional <replaceable>item</replaceable> may
+ be available from the channel driver; see its documentation for details. Any <replaceable>item</replaceable>
+ requested that is not available on the current channel will return an empty string.</para>
+ </description>
+ </function>
+ ***/
#define locked_copy_string(chan, dest, source, len) \
do { \
@@ -168,80 +269,6 @@
static struct ast_custom_function channel_function = {
.name = "CHANNEL",
- .synopsis = "Gets/sets various pieces of information about the channel.",
- .syntax = "CHANNEL(item)",
- .desc = "Gets/set various pieces of information about the channel.\n"
- "Standard items (provided by all channel technologies) are:\n"
- "R/O audioreadformat format currently being read\n"
- "R/O audionativeformat format used natively for audio\n"
- "R/O audiowriteformat format currently being written\n"
- "R/W callgroup call groups for call pickup\n"
- "R/O channeltype technology used for channel\n"
- "R/W language language for sounds played\n"
- "R/W musicclass class (from musiconhold.conf) for hold music\n"
- "R/W parkinglot parkinglot for parking\n"
- "R/W rxgain set rxgain level on channel drivers that support it\n"
- "R/O state state for channel\n"
- "R/W tonezone zone for indications played\n"
- "R/W txgain set txgain level on channel drivers that support it\n"
- "R/O videonativeformat format used natively for video\n"
-#ifdef CHANNEL_TRACE
- "R/W trace whether or not context tracing is enabled\n"
-#endif
- "\n"
- "chan_sip provides the following additional options:\n"
- "R/O peerip Get the IP address of the peer\n"
- "R/O recvip Get the source IP address of the peer\n"
- "R/O from Get the URI from the From: header\n"
- "R/O uri Get the URI from the Contact: header\n"
- "R/O useragent Get the useragent\n"
- "R/O peername Get the name of the peer\n"
- "R/O t38passthrough 1 if T38 is offered or enabled in this channel, otherwise 0\n"
- "R/O rtpqos Get QOS information about the RTP stream\n"
- " This option takes two additional arguments:\n"
- " Argument 1:\n"
- " audio Get data about the audio stream\n"
- " video Get data about the video stream\n"
- " text Get data about the text stream\n"
- " Argument 2:\n"
- " local_ssrc Local SSRC (stream ID)\n"
- " local_lostpackets Local lost packets\n"
- " local_jitter Local calculated jitter\n"
- " local_maxjitter Local calculated jitter (maximum)\n"
- " local_minjitter Local calculated jitter (minimum)\n"
- " local_normdevjitter Local calculated jitter (normal deviation)\n"
- " local_stdevjitter Local calculated jitter (standard deviation)\n"
- " local_count Number of received packets\n"
- " remote_ssrc Remote SSRC (stream ID)\n"
- " remote_lostpackets Remote lost packets\n"
- " remote_jitter Remote reported jitter\n"
- " remote_maxjitter Remote calculated jitter (maximum)\n"
- " remote_minjitter Remote calculated jitter (minimum)\n"
- " remote_normdevjitter Remote calculated jitter (normal deviation)\n"
- " remote_stdevjitter Remote calculated jitter (standard deviation)\n"
- " remote_count Number of transmitted packets\n"
- " rtt Round trip time\n"
- " maxrtt Round trip time (maximum)\n"
- " minrtt Round trip time (minimum)\n"
- " normdevrtt Round trip time (normal deviation)\n"
- " stdevrtt Round trip time (standard deviation)\n"
- " all All statistics (in a form suited to logging, but not for parsing)\n"
- "R/O rtpdest Get remote RTP destination information\n"
- " This option takes one additional argument:\n"
- " Argument 1:\n"
- " audio Get audio destination\n"
- " video Get video destination\n"
- "\n"
- "chan_iax2 provides the following additional options:\n"
- "R/W osptoken Get or set the OSP token information for a call\n"
- "R/O peerip Get the peer's ip address\n"
- "R/O peername Get the peer's username\n"
- "\n"
- "Additional items may be available from the channel driver providing\n"
- "the channel; see its documentation for details.\n"
- "\n"
- "Any item requested that is not available on the current channel will\n"
- "return an empty string.\n",
.read = func_channel_read,
.write = func_channel_write,
};
@@ -288,13 +315,6 @@
static struct ast_custom_function channels_function = {
.name = "CHANNELS",
- .synopsis = "Gets the list of channels, optionally filtering by a regular expression.",
- .syntax = "CHANNEL([regular expression])",
- .desc =
-"Gets the list of channels, optionally filtering by a regular expression. If\n"
-"no argument is provided, all known channels are returned. The regular\n"
-"expression must correspond to the POSIX.2 specification, as shown in\n"
-"regex(7). The list returned will be space-delimited.\n",
.read = func_channels_read,
};
Modified: team/group/appdocsxml/funcs/func_cut.c
URL: http://svn.digium.com/view/asterisk/team/group/appdocsxml/funcs/func_cut.c?view=diff&rev=146405&r1=146404&r2=146405
==============================================================================
--- team/group/appdocsxml/funcs/func_cut.c (original)
+++ team/group/appdocsxml/funcs/func_cut.c Sat Oct 4 16:05:53 2008
@@ -35,7 +35,6 @@
#include "asterisk/app.h"
/*** DOCUMENTATION
-
<function name="SORT" language="en_US">
<synopsis>
Sorts a list of key/vals into a list of keys, based upon the vals.
More information about the asterisk-commits
mailing list