Fri Jul 24 00:40:37 2009

Asterisk developer's documentation


acl.h

Go to the documentation of this file.
00001 /*
00002  * Asterisk -- An open source telephony toolkit.
00003  *
00004  * Copyright (C) 1999 - 2006, Digium, Inc.
00005  *
00006  * Mark Spencer <markster@digium.com>
00007  *
00008  * See http://www.asterisk.org for more information about
00009  * the Asterisk project. Please do not directly contact
00010  * any of the maintainers of this project for assistance;
00011  * the project provides a web site, mailing lists and IRC
00012  * channels for your use.
00013  *
00014  * This program is free software, distributed under the terms of
00015  * the GNU General Public License Version 2. See the LICENSE file
00016  * at the top of the source tree.
00017  */
00018 
00019 /*! \file
00020  * \brief Access Control of various sorts
00021  */
00022 
00023 #ifndef _ASTERISK_ACL_H
00024 #define _ASTERISK_ACL_H
00025 
00026 
00027 #if defined(__cplusplus) || defined(c_plusplus)
00028 extern "C" {
00029 #endif
00030 
00031 #include "asterisk/network.h"
00032 #include "asterisk/io.h"
00033 
00034 #define AST_SENSE_DENY                  0
00035 #define AST_SENSE_ALLOW                 1
00036 
00037 /* Host based access control */
00038 
00039 /*! \brief internal representation of acl entries
00040  * In principle user applications would have no need for this,
00041  * but there is sometimes a need to extract individual items,
00042  * e.g. to print them, and rather than defining iterators to
00043  * navigate the list, and an externally visible 'struct ast_ha_entry',
00044  * at least in the short term it is more convenient to make the whole
00045  * thing public and let users play with them.
00046  */
00047 struct ast_ha {
00048         /* Host access rule */
00049         struct in_addr netaddr;  
00050         struct in_addr netmask;
00051         int sense;
00052         struct ast_ha *next;
00053 };
00054 
00055 /*! \brief Free host access list */
00056 void ast_free_ha(struct ast_ha *ha);
00057 
00058 /*! \brief Append ACL entry to host access list. */
00059 struct ast_ha *ast_append_ha(const char *sense, const char *stuff, struct ast_ha *path, int *error);
00060 
00061 /*! \brief Check IP address with host access list */
00062 int ast_apply_ha(struct ast_ha *ha, struct sockaddr_in *sin);
00063 
00064 /*! \brief Copy host access list */
00065 struct ast_ha *ast_duplicate_ha_list(struct ast_ha *original);
00066 
00067 int ast_get_ip(struct sockaddr_in *sin, const char *value);
00068 
00069 int ast_get_ip_or_srv(struct sockaddr_in *sin, const char *value, const char *service);
00070 
00071 int ast_ouraddrfor(struct in_addr *them, struct in_addr *us);
00072 
00073 int ast_find_ourip(struct in_addr *ourip, struct sockaddr_in bindaddr);
00074 
00075 int ast_str2cos(const char *value, unsigned int *cos);
00076 
00077 int ast_str2tos(const char *value, unsigned int *tos);
00078 const char *ast_tos2str(unsigned int tos);
00079 
00080 #if defined(__cplusplus) || defined(c_plusplus)
00081 }
00082 #endif
00083 
00084 #endif /* _ASTERISK_ACL_H */

Generated on Fri Jul 24 00:40:37 2009 for Asterisk - the Open Source PBX by  doxygen 1.4.7