funcs/func_enum.c

   1 /*
   2  * Asterisk -- An open source telephony toolkit.
   3  *
   4  * Copyright (C) 1999 - 2006
   5  *
   6  * Mark Spencer <markster@digium.com>
   7  * Oleksiy Krivoshey <oleksiyk@gmail.com>
   8  * Russell Bryant <russelb@clemson.edu>
   9  *
  10  * See http://www.asterisk.org for more information about
  11  * the Asterisk project. Please do not directly contact
  12  * any of the maintainers of this project for assistance;
  13  * the project provides a web site, mailing lists and IRC
  14  * channels for your use.
  15  *
  16  * This program is free software, distributed under the terms of
  17  * the GNU General Public License Version 2. See the LICENSE file
  18  * at the top of the source tree.
  19  */
  20
  21 /*! \file
  22  *
  23  * \brief ENUM Functions
  24  *
  25  * \author Mark Spencer <markster@digium.com>
  26  * \author Oleksiy Krivoshey <oleksiyk@gmail.com>
  27  * \author Russell Bryant <russelb@clemson.edu>
  28  *
  29  * \arg See also AstENUM
  30  */
  31
  32 #include "asterisk.h"
  33
  34 ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
  35
  36 #include <stdlib.h>
  37 #include <stdio.h>
  38
  39 #include "asterisk/module.h"
  40 #include "asterisk/channel.h"
  41 #include "asterisk/pbx.h"
  42 #include "asterisk/utils.h"
  43 #include "asterisk/lock.h"
  44 #include "asterisk/file.h"
  45 #include "asterisk/logger.h"
  46 #include "asterisk/pbx.h"
  47 #include "asterisk/options.h"
  48 #include "asterisk/enum.h"
  49 #include "asterisk/app.h"
  50
  51  static char *synopsis = "Syntax: ENUMLOOKUP(number[|Method-type[|options[|record#[|zone-suffix]]]])\n";
  52
  53 static int function_enum(struct ast_channel *chan, char *cmd, char *data,
  54                          char *buf, size_t len)
  55 {
  56         AST_DECLARE_APP_ARGS(args,
  57                 AST_APP_ARG(number);
  58                 AST_APP_ARG(tech);
  59                 AST_APP_ARG(options);
  60                 AST_APP_ARG(record);
  61                 AST_APP_ARG(zone);
  62         );
  63         int res = 0;
  64         char tech[80];
  65         char dest[256] = "", tmp[2] = "", num[AST_MAX_EXTENSION] = "";
  66         struct ast_module_user *u;
  67         char *s, *p;
  68         unsigned int record = 1;
  69
  70         buf[0] = '\0';
  71
  72         if (ast_strlen_zero(data)) {
  73                 ast_log(LOG_WARNING, synopsis);
  74                 return -1;
  75         }
  76
  77         AST_STANDARD_APP_ARGS(args, data);
  78
  79         if (args.argc < 1) {
  80                 ast_log(LOG_WARNING, synopsis);
  81                 return -1;
  82         }
  83
  84         u = ast_module_user_add(chan);
  85
  86         ast_copy_string(tech, args.tech ? args.tech : "sip", sizeof(tech));
  87
  88         if (!args.zone)
  89                 args.zone = "e164.arpa";
  90
  91         if (!args.options)
  92                 args.options = "";
  93
  94         if (args.record)
  95                 record = atoi(args.record);
  96
  97         /* strip any '-' signs from number */
  98         for (s = p = args.number; *s; s++) {
  99                 if (*s != '-') {
 100                         snprintf(tmp, sizeof(tmp), "%c", *s);
 101                         strncat(num, tmp, sizeof(num) - strlen(num) - 1);
 102                 }
 103
 104         }
 105
 106         res = ast_get_enum(chan, num, dest, sizeof(dest), tech, sizeof(tech), args.zone,
 107                            args.options, record);
 108
 109         p = strchr(dest, ':');
 110         if (p && strcasecmp(tech, "ALL"))
 111                 ast_copy_string(buf, p + 1, len);
 112         else
 113                 ast_copy_string(buf, dest, len);
 114
 115         ast_module_user_remove(u);
 116
 117         return 0;
 118 }
 119
 120 static struct ast_custom_function enum_function = {
 121         .name = "ENUMLOOKUP",
 122         .synopsis =
 123                 "ENUMLOOKUP allows for general or specific querying of NAPTR records"
 124                 " or counts of NAPTR types for ENUM or ENUM-like DNS pointers",
 125         .syntax =
 126                 "ENUMLOOKUP(number[|Method-type[|options[|record#[|zone-suffix]]]])",
 127         .desc =
 128                 "Option 'c' returns an integer count of the number of NAPTRs of a certain RR type.\n"
 129                 "Combination of 'c' and Method-type of 'ALL' will return a count of all NAPTRs for the record.\n"
 130                 "Defaults are: Method-type=sip, no options, record=1, zone-suffix=e164.arpa\n\n"
 131                 "For more information, see doc/enum.txt",
 132         .read = function_enum,
 133 };
 134
 135 static int function_txtcidname(struct ast_channel *chan, char *cmd,
 136                                char *data, char *buf, size_t len)
 137 {
 138         int res;
 139         char tech[80];
 140         char txt[256] = "";
 141         char dest[80];
 142         struct ast_module_user *u;
 143
 144         buf[0] = '\0';
 145
 146
 147         if (ast_strlen_zero(data)) {
 148                 ast_log(LOG_WARNING, "TXTCIDNAME requires an argument (number)\n");
 149                 return -1;
 150         }
 151
 152         u = ast_module_user_add(chan);
 153
 154         res = ast_get_txt(chan, data, dest, sizeof(dest), tech, sizeof(tech), txt,
 155                           sizeof(txt));
 156
 157         if (!ast_strlen_zero(txt))
 158                 ast_copy_string(buf, txt, len);
 159
 160         ast_module_user_remove(u);
 161
 162         return 0;
 163 }
 164
 165 static struct ast_custom_function txtcidname_function = {
 166         .name = "TXTCIDNAME",
 167         .synopsis = "TXTCIDNAME looks up a caller name via DNS",
 168         .syntax = "TXTCIDNAME(<number>)",
 169         .desc =
 170                 "This function looks up the given phone number in DNS to retrieve\n"
 171                 "the caller id name.  The result will either be blank or be the value\n"
 172                 "found in the TXT record in DNS.\n",
 173         .read = function_txtcidname,
 174 };
 175
 176 static int unload_module(void)
 177 {
 178         int res = 0;
 179
 180         res |= ast_custom_function_unregister(&enum_function);
 181         res |= ast_custom_function_unregister(&txtcidname_function);
 182
 183         ast_module_user_hangup_all();
 184
 185         return res;
 186 }
 187
 188 static int load_module(void)
 189 {
 190         int res = 0;
 191
 192         res |= ast_custom_function_register(&enum_function);
 193         res |= ast_custom_function_register(&txtcidname_function);
 194
 195         return res;
 196 }
 197
 198 AST_MODULE_INFO_STANDARD(ASTERISK_GPL_KEY, "ENUM related dialplan functions");