update copyright headers for 2005
[asterisk/asterisk.git] / apps / app_image.c
1 /*
2  * Asterisk -- A telephony toolkit for Linux.
3  *
4  * App to transmit an image
5  * 
6  * Copyright (C) 1999 - 2005, Digium, Inc.
7  *
8  * Mark Spencer <markster@digium.com>
9  *
10  * This program is free software, distributed under the terms of
11  * the GNU General Public License
12  */
13  
14 #include <asterisk/lock.h>
15 #include <asterisk/file.h>
16 #include <asterisk/logger.h>
17 #include <asterisk/channel.h>
18 #include <asterisk/pbx.h>
19 #include <asterisk/module.h>
20 #include <asterisk/translate.h>
21 #include <asterisk/image.h>
22 #include <string.h>
23 #include <stdlib.h>
24
25 static char *tdesc = "Image Transmission Application";
26
27 static char *app = "SendImage";
28
29 static char *synopsis = "Send an image file";
30
31 static char *descrip = 
32 "  SendImage(filename): Sends an image on a channel. If the channel\n"
33 "does not support  image transport, and there exists  a  step  with\n"
34 "priority n + 101, then  execution  will  continue  at  that  step.\n"
35 "Otherwise,  execution  will continue at  the  next priority level.\n"
36 "SendImage only  returns  0 if  the  image was sent correctly or if\n"
37 "the channel does not support image transport, and -1 otherwise.\n";
38
39 STANDARD_LOCAL_USER;
40
41 LOCAL_USER_DECL;
42
43 static int sendimage_exec(struct ast_channel *chan, void *data)
44 {
45         int res = 0;
46         struct localuser *u;
47         if (!data || !strlen((char *)data)) {
48                 ast_log(LOG_WARNING, "SendImage requires an argument (filename)\n");
49                 return -1;
50         }
51         LOCAL_USER_ADD(u);
52         if (!ast_supports_images(chan)) {
53                 /* Does not support transport */
54                 if (ast_exists_extension(chan, chan->context, chan->exten, chan->priority + 101, chan->cid.cid_num))
55                         chan->priority += 100;
56                 return 0;
57         }
58         res = ast_send_image(chan, data);
59         LOCAL_USER_REMOVE(u);
60         return res;
61 }
62
63 int unload_module(void)
64 {
65         STANDARD_HANGUP_LOCALUSERS;
66         return ast_unregister_application(app);
67 }
68
69 int load_module(void)
70 {
71         return ast_register_application(app, sendimage_exec, synopsis, descrip);
72 }
73
74 char *description(void)
75 {
76         return tdesc;
77 }
78
79 int usecount(void)
80 {
81         int res;
82         STANDARD_USECOUNT(res);
83         return res;
84 }
85
86 char *key()
87 {
88         return ASTERISK_GPL_KEY;
89 }