aboutsummaryrefslogtreecommitdiffstats
path: root/apps
diff options
context:
space:
mode:
authorfile <file@f38db490-d61c-443f-a65b-d21fe96a405b>2009-11-13 17:19:59 +0000
committerfile <file@f38db490-d61c-443f-a65b-d21fe96a405b>2009-11-13 17:19:59 +0000
commit393351fa2ca92301c969a34e8affd750a443c529 (patch)
treeb3ca8f03e9d087f3d72e98b961f7f261d99ddb6e /apps
parent453e484c25fe19aa44d94182f8fb2feb8670f372 (diff)
Document a limitation in the AVAILSTATUS variable from ChanIsAvail and provide
a workaround for it that does not change existing behavior. (closes issue #14426) Reported by: macli git-svn-id: http://svn.digium.com/svn/asterisk/branches/1.4@229965 f38db490-d61c-443f-a65b-d21fe96a405b
Diffstat (limited to 'apps')
-rw-r--r--apps/app_chanisavail.c7
1 files changed, 6 insertions, 1 deletions
diff --git a/apps/app_chanisavail.c b/apps/app_chanisavail.c
index c6931d8db..f089392ea 100644
--- a/apps/app_chanisavail.c
+++ b/apps/app_chanisavail.c
@@ -55,7 +55,12 @@ static char *synopsis = "Check channel availability";
static char *descrip =
" ChanIsAvail(Technology/resource[&Technology2/resource2...][|options]): \n"
"This application will check to see if any of the specified channels are\n"
-"available. The following variables will be set by this application:\n"
+"available. Note that the AVAILSTATUS variable is used for both device state\n"
+"and cause code. It is therefore possible for it to give a value that may\n"
+"indicate a device is available when it is not. It is suggested that the\n"
+"AVAILORIGCHAN variable is used instead to see whether a device is available\n"
+"or not.\n"
+"The following variables will be set by this application:\n"
" ${AVAILCHAN} - the name of the available channel, if one exists\n"
" ${AVAILORIGCHAN} - the canonical channel name that was used to create the channel\n"
" ${AVAILSTATUS} - the status code for the available channel\n"