From: Joshua C. Colp <jcolp@sangoma.com>
Date: Mon, 16 Aug 2021 17:50:54 +0000 (-0300)
Subject: app_url: Remove deprecated module.
X-Git-Tag: 19.0.0-rc1~70
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=0b3a1490013a9a26450aad3eb1239fa88e323494;p=thirdparty%2Fasterisk.git

app_url: Remove deprecated module.

ASTERISK-29588

Change-Id: If846d40b37c5b646bcd7326111db280529a5971b
---

diff --git a/apps/app_url.c b/apps/app_url.c
deleted file mode 100644
index 08e1ec54c6..0000000000
--- a/apps/app_url.c
+++ /dev/null
@@ -1,182 +0,0 @@
-/*
- * Asterisk -- An open source telephony toolkit.
- *
- * Copyright (C) 1999 - 2005, Digium, Inc.
- *
- * Mark Spencer <markster@digium.com>
- *
- * See http://www.asterisk.org for more information about
- * the Asterisk project. Please do not directly contact
- * any of the maintainers of this project for assistance;
- * the project provides a web site, mailing lists and IRC
- * channels for your use.
- *
- * This program is free software, distributed under the terms of
- * the GNU General Public License Version 2. See the LICENSE file
- * at the top of the source tree.
- */
-
-/*! \file
- *
- * \brief App to transmit a URL
- *
- * \author Mark Spencer <markster@digium.com>
- *
- * \ingroup applications
- */
-
-/*** MODULEINFO
-	<support_level>deprecated</support_level>
-	<deprecated_in>16</deprecated_in>
-	<removed_in>19</removed_in>
- ***/
-
-#include "asterisk.h"
-
-#include "asterisk/pbx.h"
-#include "asterisk/module.h"
-#include "asterisk/app.h"
-#include "asterisk/channel.h"
-
-/*** DOCUMENTATION
-	<application name="SendURL" language="en_US">
-		<synopsis>
-			Send a URL.
-		</synopsis>
-		<syntax>
-			<parameter name="URL" required="true" />
-			<parameter name="option">
-				<optionlist>
-					<option name="w">
-						<para>Execution will wait for an acknowledgement that the
-						URL has been loaded before continuing.</para>
-					</option>
-				</optionlist>
-			</parameter>
-		</syntax>
-		<description>
-			<para>Requests client go to <replaceable>URL</replaceable> (IAX2) or sends the
-			URL to the client (other channels).</para>
-			<para>Result is returned in the <variable>SENDURLSTATUS</variable> channel variable:</para>
-			<variablelist>
-				<variable name="SENDURLSTATUS">
-					<value name="SUCCESS">
-						URL successfully sent to client.
-					</value>
-					<value name="FAILURE">
-						Failed to send URL.
-					</value>
-					<value name="NOLOAD">
-						Client failed to load URL (wait enabled).
-					</value>
-					<value name="UNSUPPORTED">
-						Channel does not support URL transport.
-					</value>
-				</variable>
-			</variablelist>
-			<para>SendURL continues normally if the URL was sent correctly or if the channel
-			does not support HTML transport.  Otherwise, the channel is hung up.</para>
-		</description>
-		<see-also>
-			<ref type="application">SendImage</ref>
-			<ref type="application">SendText</ref>
-		</see-also>
-	</application>
- ***/
-
-static char *app = "SendURL";
-
-enum option_flags {
-	OPTION_WAIT = (1 << 0),
-};
-
-AST_APP_OPTIONS(app_opts,{
-	AST_APP_OPTION('w', OPTION_WAIT),
-});
-
-static int sendurl_exec(struct ast_channel *chan, const char *data)
-{
-	int res = 0;
-	char *tmp;
-	struct ast_frame *f;
-	char *status = "FAILURE";
-	char *opts[0];
-	struct ast_flags flags = { 0 };
-	AST_DECLARE_APP_ARGS(args,
-		AST_APP_ARG(url);
-		AST_APP_ARG(options);
-	);
-
-	if (ast_strlen_zero(data)) {
-		ast_log(LOG_WARNING, "SendURL requires an argument (URL)\n");
-		pbx_builtin_setvar_helper(chan, "SENDURLSTATUS", status);
-		return -1;
-	}
-
-	tmp = ast_strdupa(data);
-
-	AST_STANDARD_APP_ARGS(args, tmp);
-	if (args.argc == 2)
-		ast_app_parse_options(app_opts, &flags, opts, args.options);
-
-	if (!ast_channel_supports_html(chan)) {
-		/* Does not support transport */
-		pbx_builtin_setvar_helper(chan, "SENDURLSTATUS", "UNSUPPORTED");
-		return 0;
-	}
-	res = ast_channel_sendurl(chan, args.url);
-	if (res == -1) {
-		pbx_builtin_setvar_helper(chan, "SENDURLSTATUS", "FAILURE");
-		return res;
-	}
-	status = "SUCCESS";
-	if (ast_test_flag(&flags, OPTION_WAIT)) {
-		for(;;) {
-			/* Wait for an event */
-			res = ast_waitfor(chan, -1);
-			if (res < 0)
-				break;
-			f = ast_read(chan);
-			if (!f) {
-				res = -1;
-				status = "FAILURE";
-				break;
-			}
-			if (f->frametype == AST_FRAME_HTML) {
-				switch (f->subclass.integer) {
-				case AST_HTML_LDCOMPLETE:
-					res = 0;
-					ast_frfree(f);
-					status = "NOLOAD";
-					goto out;
-					break;
-				case AST_HTML_NOSUPPORT:
-					/* Does not support transport */
-					status = "UNSUPPORTED";
-					res = 0;
-					ast_frfree(f);
-					goto out;
-					break;
-				default:
-					ast_log(LOG_WARNING, "Don't know what to do with HTML subclass %d\n", f->subclass.integer);
-				};
-			}
-			ast_frfree(f);
-		}
-	}
-out:
-	pbx_builtin_setvar_helper(chan, "SENDURLSTATUS", status);
-	return res;
-}
-
-static int unload_module(void)
-{
-	return ast_unregister_application(app);
-}
-
-static int load_module(void)
-{
-	return ast_register_application_xml(app, sendurl_exec);
-}
-
-AST_MODULE_INFO_STANDARD_DEPRECATED(ASTERISK_GPL_KEY, "Send URL Applications");
diff --git a/doc/UPGRADE-staging/app_url_removal.txt b/doc/UPGRADE-staging/app_url_removal.txt
new file mode 100644
index 0000000000..bf04380111
--- /dev/null
+++ b/doc/UPGRADE-staging/app_url_removal.txt
@@ -0,0 +1,6 @@
+Subject: app_url
+Master-Only: True
+
+This module was deprecated in Asterisk 16
+and is now being removed in accordance with
+the Asterisk Module Deprecation policy.