Doxygen update
[asterisk/asterisk.git] / funcs / func_md5.c
1 /*
2  * Asterisk -- An open source telephony toolkit.
3  *
4  * Copyright (C) 2005-2006, Digium, Inc.
5  * Copyright (C) 2005, Olle E. Johansson, Edvina.net
6  * Copyright (C) 2005, Russell Bryant <russelb@clemson.edu> 
7  *
8  * See http://www.asterisk.org for more information about
9  * the Asterisk project. Please do not directly contact
10  * any of the maintainers of this project for assistance;
11  * the project provides a web site, mailing lists and IRC
12  * channels for your use.
13  *
14  * This program is free software, distributed under the terms of
15  * the GNU General Public License Version 2. See the LICENSE file
16  * at the top of the source tree.
17  */
18
19 /*! \file
20  *
21  * \brief MD5 digest related dialplan functions
22  * 
23  * \author Olle E. Johansson <oej@edvina.net>
24  * \author Russell Bryant <russelb@clemson.edu>
25  *
26  * \ingroup functions
27  */
28
29 #include "asterisk.h"
30
31 ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
32
33 #include <stdio.h>
34 #include <stdlib.h>
35 #include <string.h>
36 #include <sys/types.h>
37
38 #include "asterisk/module.h"
39 #include "asterisk/channel.h"
40 #include "asterisk/pbx.h"
41 #include "asterisk/logger.h"
42 #include "asterisk/utils.h"
43 #include "asterisk/app.h"
44
45 static int md5(struct ast_channel *chan, const char *cmd, char *data,
46                char *buf, size_t len)
47 {
48         if (ast_strlen_zero(data)) {
49                 ast_log(LOG_WARNING, "Syntax: MD5(<data>) - missing argument!\n");
50                 return -1;
51         }
52
53         ast_md5_hash(buf, data);
54         buf[32] = '\0';
55
56         return 0;
57 }
58
59 static struct ast_custom_function md5_function = {
60         .name = "MD5",
61         .synopsis = "Computes an MD5 digest",
62         .syntax = "MD5(<data>)",
63         .read = md5,
64 };
65
66 static int unload_module(void)
67 {
68         return ast_custom_function_unregister(&md5_function);
69 }
70
71 static int load_module(void)
72 {
73         return ast_custom_function_register(&md5_function);
74 }
75
76 AST_MODULE_INFO_STANDARD(ASTERISK_GPL_KEY, "MD5 digest dialplan functions");