Fri Aug 17 00:17:20 2018

Asterisk developer's documentation


acl.h File Reference

Access Control of various sorts. More...

#include "asterisk/network.h"
#include "asterisk/netsock2.h"
#include "asterisk/io.h"

Go to the source code of this file.

Data Structures

struct  ast_ha
 internal representation of acl entries In principle user applications would have no need for this, but there is sometimes a need to extract individual items, e.g. to print them, and rather than defining iterators to navigate the list, and an externally visible 'struct ast_ha_entry', at least in the short term it is more convenient to make the whole thing public and let users play with them. More...

Defines

#define AST_SENSE_ALLOW   1
#define AST_SENSE_DENY   0

Functions

struct ast_haast_append_ha (const char *sense, const char *stuff, struct ast_ha *path, int *error)
 Add a new rule to a list of HAs.
int ast_apply_ha (const struct ast_ha *ha, const struct ast_sockaddr *addr)
 Apply a set of rules to a given IP address.
void ast_copy_ha (const struct ast_ha *from, struct ast_ha *to)
 Copy the contents of one HA to another.
struct ast_haast_duplicate_ha_list (struct ast_ha *original)
 Duplicate the contents of a list of host access rules.
int ast_find_ourip (struct ast_sockaddr *ourip, const struct ast_sockaddr *bindaddr, int family)
 Find our IP address.
void ast_free_ha (struct ast_ha *ha)
 Free a list of HAs.
int ast_get_ip (struct ast_sockaddr *addr, const char *hostname)
 Get the IP address given a hostname.
int ast_get_ip_or_srv (struct ast_sockaddr *addr, const char *hostname, const char *service)
 Get the IP address given a hostname and optional service.
int ast_lookup_iface (char *iface, struct ast_sockaddr *address)
 Find an IP address associated with a specific interface.
int ast_ouraddrfor (const struct ast_sockaddr *them, struct ast_sockaddr *us)
 Get our local IP address when contacting a remote host.
int ast_str2cos (const char *value, unsigned int *cos)
 Convert a string to the appropriate COS value.
int ast_str2tos (const char *value, unsigned int *tos)
 Convert a string to the appropriate TOS value.
const char * ast_tos2str (unsigned int tos)
 Convert a TOS value into its string representation.

Detailed Description

Access Control of various sorts.

Definition in file acl.h.


Define Documentation

#define AST_SENSE_ALLOW   1
#define AST_SENSE_DENY   0

Definition at line 35 of file acl.h.

Referenced by apply_directmedia_ha(), ast_append_ha(), and check_access().


Function Documentation

struct ast_ha* ast_append_ha ( const char *  sense,
const char *  stuff,
struct ast_ha path,
int *  error 
) [read]

Add a new rule to a list of HAs.

This adds the new host access rule to the end of the list whose head is specified by the path parameter. Rules are evaluated in a way such that if multiple rules apply to a single IP address/subnet mask, then the rule latest in the list will be used.

Parameters:
sense Either "permit" or "deny" (Actually any 'p' word will result in permission, and any other word will result in denial)
stuff The IP address and subnet mask, separated with a '/'. The subnet mask can either be in dotted-decimal format or in CIDR notation (i.e. 0-32).
path The head of the HA list to which we wish to append our new rule. If NULL is passed, then the new rule will become the head of the list
[out] error The integer error points to will be set non-zero if an error occurs
Returns:
The head of the HA list

Definition at line 399 of file acl.c.

References ast_ha::addr, apply_netmask(), ast_calloc, ast_debug, ast_free_ha(), ast_log(), AST_SENSE_ALLOW, AST_SENSE_DENY, ast_sockaddr_ipv4_mapped(), ast_sockaddr_is_ipv4(), ast_sockaddr_parse(), ast_sockaddr_stringify(), ast_strdupa, LOG_NOTICE, LOG_WARNING, ast_ha::netmask, ast_ha::next, parse_cidr_mask(), PARSE_PORT_FORBID, and ast_ha::sense.

Referenced by __init_manager(), add_calltoken_ignore(), build_callno_limits(), build_device(), build_gateway(), build_peer(), build_user(), config_parse_variables(), and reload_config().

00400 {
00401    struct ast_ha *ha;
00402    struct ast_ha *prev = NULL;
00403    struct ast_ha *ret;
00404    char *tmp = ast_strdupa(stuff);
00405    char *address = NULL, *mask = NULL;
00406    int addr_is_v4;
00407 
00408    ret = path;
00409    while (path) {
00410       prev = path;
00411       path = path->next;
00412    }
00413 
00414    if (!(ha = ast_calloc(1, sizeof(*ha)))) {
00415       if (error) {
00416          *error = 1;
00417       }
00418       return ret;
00419    }
00420 
00421    address = strsep(&tmp, "/");
00422    if (!address) {
00423       address = tmp;
00424    } else {
00425       mask = tmp;
00426    }
00427 
00428    if (!ast_sockaddr_parse(&ha->addr, address, PARSE_PORT_FORBID)) {
00429       ast_log(LOG_WARNING, "Invalid IP address: %s\n", address);
00430       ast_free_ha(ha);
00431       if (error) {
00432          *error = 1;
00433       }
00434       return ret;
00435    }
00436 
00437    /* If someone specifies an IPv4-mapped IPv6 address,
00438     * we just convert this to an IPv4 ACL
00439     */
00440    if (ast_sockaddr_ipv4_mapped(&ha->addr, &ha->addr)) {
00441       ast_log(LOG_NOTICE, "IPv4-mapped ACL network address specified. "
00442             "Converting to an IPv4 ACL network address.\n");
00443    }
00444 
00445    addr_is_v4 = ast_sockaddr_is_ipv4(&ha->addr);
00446 
00447    if (!mask) {
00448       parse_cidr_mask(&ha->netmask, addr_is_v4, addr_is_v4 ? "32" : "128");
00449    } else if (strchr(mask, ':') || strchr(mask, '.')) {
00450       int mask_is_v4;
00451       /* Mask is of x.x.x.x or x:x:x:x:x:x:x:x variety */
00452       if (!ast_sockaddr_parse(&ha->netmask, mask, PARSE_PORT_FORBID)) {
00453          ast_log(LOG_WARNING, "Invalid netmask: %s\n", mask);
00454          ast_free_ha(ha);
00455          if (error) {
00456             *error = 1;
00457          }
00458          return ret;
00459       }
00460       /* If someone specifies an IPv4-mapped IPv6 netmask,
00461        * we just convert this to an IPv4 ACL
00462        */
00463       if (ast_sockaddr_ipv4_mapped(&ha->netmask, &ha->netmask)) {
00464          ast_log(LOG_NOTICE, "IPv4-mapped ACL netmask specified. "
00465                "Converting to an IPv4 ACL netmask.\n");
00466       }
00467       mask_is_v4 = ast_sockaddr_is_ipv4(&ha->netmask);
00468       if (addr_is_v4 ^ mask_is_v4) {
00469          ast_log(LOG_WARNING, "Address and mask are not using same address scheme.\n");
00470          ast_free_ha(ha);
00471          if (error) {
00472             *error = 1;
00473          }
00474          return ret;
00475       }
00476    } else if (parse_cidr_mask(&ha->netmask, addr_is_v4, mask)) {
00477       ast_log(LOG_WARNING, "Invalid CIDR netmask: %s\n", mask);
00478       ast_free_ha(ha);
00479       if (error) {
00480          *error = 1;
00481       }
00482       return ret;
00483    }
00484 
00485    if (apply_netmask(&ha->addr, &ha->netmask, &ha->addr)) {
00486       /* This shouldn't happen because ast_sockaddr_parse would
00487        * have failed much earlier on an unsupported address scheme
00488        */
00489       char *failmask = ast_strdupa(ast_sockaddr_stringify(&ha->netmask));
00490       char *failaddr = ast_strdupa(ast_sockaddr_stringify(&ha->addr));
00491       ast_log(LOG_WARNING, "Unable to apply netmask %s to address %s\n", failmask, failaddr);
00492       ast_free_ha(ha);
00493       if (error) {
00494          *error = 1;
00495       }
00496       return ret;
00497    }
00498 
00499    ha->sense = strncasecmp(sense, "p", 1) ? AST_SENSE_DENY : AST_SENSE_ALLOW;
00500 
00501    ha->next = NULL;
00502    if (prev) {
00503       prev->next = ha;
00504    } else {
00505       ret = ha;
00506    }
00507 
00508    {
00509       const char *addr = ast_strdupa(ast_sockaddr_stringify(&ha->addr));
00510       const char *mask = ast_strdupa(ast_sockaddr_stringify(&ha->netmask));
00511 
00512       ast_debug(1, "%s/%s sense %d appended to acl for peer\n", addr, mask, ha->sense);
00513    }
00514 
00515    return ret;
00516 }

int ast_apply_ha ( const struct ast_ha ha,
const struct ast_sockaddr addr 
)

Apply a set of rules to a given IP address.

The list of host access rules is traversed, beginning with the input rule. If the IP address given matches a rule, the "sense" of that rule is used as the return value. Note that if an IP address matches multiple rules that the last one matched will be the one whose sense will be returned.

Parameters:
ha The head of the list of host access rules to follow
addr An ast_sockaddr whose address is considered when matching rules
Return values:
AST_SENSE_ALLOW The IP address passes our ACL
AST_SENSE_DENY The IP address fails our ACL

Definition at line 518 of file acl.c.

References ast_ha::addr, apply_netmask(), ast_copy_string(), ast_debug, ast_inet_ntoa(), ast_log(), AST_SENSE_ALLOW, ast_sockaddr_cmp_addr(), ast_sockaddr_ipv4_mapped(), ast_sockaddr_is_ipv4(), ast_sockaddr_is_ipv4_mapped(), ast_sockaddr_is_ipv6(), ast_sockaddr_stringify(), LOG_ERROR, ast_ha::netmask, ast_ha::next, and ast_ha::sense.

Referenced by apply_directmedia_ha(), ast_sip_ouraddrfor(), auth_http_callback(), authenticate(), check_access(), check_peer_ok(), parse_register_contact(), register_verify(), and skinny_register().

00519 {
00520    /* Start optimistic */
00521    int res = AST_SENSE_ALLOW;
00522    const struct ast_ha *current_ha;
00523 
00524    for (current_ha = ha; current_ha; current_ha = current_ha->next) {
00525       struct ast_sockaddr result;
00526       struct ast_sockaddr mapped_addr;
00527       const struct ast_sockaddr *addr_to_use;
00528 #if 0 /* debugging code */
00529       char iabuf[INET_ADDRSTRLEN];
00530       char iabuf2[INET_ADDRSTRLEN];
00531       /* DEBUG */
00532       ast_copy_string(iabuf, ast_inet_ntoa(sin->sin_addr), sizeof(iabuf));
00533       ast_copy_string(iabuf2, ast_inet_ntoa(ha->netaddr), sizeof(iabuf2));
00534       ast_debug(1, "##### Testing %s with %s\n", iabuf, iabuf2);
00535 #endif
00536       if (ast_sockaddr_is_ipv4(&current_ha->addr)) {
00537          if (ast_sockaddr_is_ipv6(addr)) {
00538             if (ast_sockaddr_is_ipv4_mapped(addr)) {
00539                /* IPv4 ACLs apply to IPv4-mapped addresses */
00540                if (!ast_sockaddr_ipv4_mapped(addr, &mapped_addr)) {
00541                   ast_log(LOG_ERROR, "%s provided to ast_sockaddr_ipv4_mapped could not be converted. That shouldn't be possible.\n",
00542                      ast_sockaddr_stringify(addr));
00543                   continue;
00544                }
00545                addr_to_use = &mapped_addr;
00546             } else {
00547                /* An IPv4 ACL does not apply to an IPv6 address */
00548                continue;
00549             }
00550          } else {
00551             /* Address is IPv4 and ACL is IPv4. No biggie */
00552             addr_to_use = addr;
00553          }
00554       } else {
00555          if (ast_sockaddr_is_ipv6(addr) && !ast_sockaddr_is_ipv4_mapped(addr)) {
00556             addr_to_use = addr;
00557          } else {
00558             /* Address is IPv4 or IPv4 mapped but ACL is IPv6. Skip */
00559             continue;
00560          }
00561       }
00562 
00563       /* For each rule, if this address and the netmask = the net address
00564          apply the current rule */
00565       if (apply_netmask(addr_to_use, &current_ha->netmask, &result)) {
00566          /* Unlikely to happen since we know the address to be IPv4 or IPv6 */
00567          continue;
00568       }
00569       if (!ast_sockaddr_cmp_addr(&result, &current_ha->addr)) {
00570          res = current_ha->sense;
00571       }
00572    }
00573    return res;
00574 }

void ast_copy_ha ( const struct ast_ha from,
struct ast_ha to 
)

Copy the contents of one HA to another.

This copies the internals of the 'from' HA to the 'to' HA. It is important that the 'to' HA has been allocated prior to calling this function

Parameters:
from Source HA to copy
to Destination HA to copy to
Return values:
void 

Definition at line 234 of file acl.c.

References ast_ha::addr, ast_sockaddr_copy(), ast_ha::netmask, and ast_ha::sense.

Referenced by add_calltoken_ignore(), ast_duplicate_ha(), and build_callno_limits().

00235 {
00236    ast_sockaddr_copy(&to->addr, &from->addr);
00237    ast_sockaddr_copy(&to->netmask, &from->netmask);
00238    to->sense = from->sense;
00239 }

struct ast_ha* ast_duplicate_ha_list ( struct ast_ha original  )  [read]

Duplicate the contents of a list of host access rules.

A deep copy of all ast_has in the list is made. The returned value is allocated on the heap and must be freed independently of the input parameter when finished.

Note:
This function is not actually used anywhere.
Parameters:
original The ast_ha to copy
Return values:
The head of the list of duplicated ast_has

Definition at line 256 of file acl.c.

References ast_duplicate_ha(), and ast_ha::next.

Referenced by create_addr_from_peer().

00257 {
00258    struct ast_ha *start = original;
00259    struct ast_ha *ret = NULL;
00260    struct ast_ha *current, *prev = NULL;
00261 
00262    while (start) {
00263       current = ast_duplicate_ha(start);  /* Create copy of this object */
00264       if (prev) {
00265          prev->next = current;           /* Link previous to this object */
00266       }
00267 
00268       if (!ret) {
00269          ret = current;                  /* Save starting point */
00270       }
00271 
00272       start = start->next;                /* Go to next object */
00273       prev = current;                     /* Save pointer to this object */
00274    }
00275    return ret;                             /* Return start of list */
00276 }

int ast_find_ourip ( struct ast_sockaddr ourip,
const struct ast_sockaddr bindaddr,
int  family 
)

Find our IP address.

This function goes through many iterations in an attempt to find our IP address. If any step along the way should fail, we move to the next item in the list. Here are the steps taken:

  • If bindaddr has a non-zero IP address, that is copied into ourip
  • We use a combination of gethostname and ast_gethostbyname to find our IP address.
  • We use ast_ouraddrfor with 198.41.0.4 as the destination IP address
  • We try some platform-specific socket operations to find the IP address
Parameters:
[out] ourip Our IP address is written here when it is found
bindaddr A hint used for finding our IP. See the steps above for more details
family Only addresses of the given family will be returned. Use 0 or AST_SOCKADDR_UNSPEC to get addresses of all families.
Return values:
0 Success
-1 Failure

Definition at line 744 of file acl.c.

References ast_debug, ast_log(), ast_ouraddrfor(), ast_sockaddr_copy(), ast_sockaddr_is_any(), ast_sockaddr_port, ast_sockaddr_set_port, get_local_address(), LOG_WARNING, MAXHOSTNAMELEN, ourhost, PARSE_PORT_FORBID, and resolve_first().

Referenced by __oh323_rtp_create(), gtalk_get_local_ip(), jingle_create_candidates(), load_module(), and reload_config().

00745 {
00746    char ourhost[MAXHOSTNAMELEN] = "";
00747    struct ast_sockaddr root;
00748    int res, port = ast_sockaddr_port(ourip);
00749 
00750    /* just use the bind address if it is nonzero */
00751    if (!ast_sockaddr_is_any(bindaddr)) {
00752       ast_sockaddr_copy(ourip, bindaddr);
00753       ast_debug(3, "Attached to given IP address\n");
00754       return 0;
00755    }
00756    /* try to use our hostname */
00757    if (gethostname(ourhost, sizeof(ourhost) - 1)) {
00758       ast_log(LOG_WARNING, "Unable to get hostname\n");
00759    } else {
00760       if (resolve_first(ourip, ourhost, PARSE_PORT_FORBID, family) == 0) {
00761          /* reset port since resolve_first wipes this out */
00762          ast_sockaddr_set_port(ourip, port);
00763          return 0;
00764       }
00765    }
00766    ast_debug(3, "Trying to check A.ROOT-SERVERS.NET and get our IP address for that connection\n");
00767    /* A.ROOT-SERVERS.NET. */
00768    if (!resolve_first(&root, "A.ROOT-SERVERS.NET", PARSE_PORT_FORBID, 0) &&
00769        !ast_ouraddrfor(&root, ourip)) {
00770       /* reset port since resolve_first wipes this out */
00771       ast_sockaddr_set_port(ourip, port);
00772       return 0;
00773    }
00774    res = get_local_address(ourip);
00775    ast_sockaddr_set_port(ourip, port);
00776    return res;
00777 }

void ast_free_ha ( struct ast_ha ha  ) 

Free a list of HAs.

Given the head of a list of HAs, it and all appended HAs are freed

Parameters:
ha The head of the list of HAs to free
Return values:
void 

Definition at line 223 of file acl.c.

References ast_free, and ast_ha::next.

Referenced by __init_manager(), __sip_destroy(), add_calltoken_ignore(), ast_append_ha(), build_callno_limits(), build_peer(), build_user(), destroy_gateway(), manager_free_user(), oh323_destroy_peer(), oh323_destroy_user(), peer_destructor(), reload_config(), sip_destroy_peer(), unload_module(), and user_destructor().

00224 {
00225    struct ast_ha *hal;
00226    while (ha) {
00227       hal = ha;
00228       ha = ha->next;
00229       ast_free(hal);
00230    }
00231 }

int ast_get_ip ( struct ast_sockaddr addr,
const char *  hostname 
)

Get the IP address given a hostname.

Similar in nature to ast_gethostbyname, except that instead of getting an entire hostent structure, you instead are given only the IP address inserted into a ast_sockaddr structure.

Parameters:
addr The IP address found. The address family is used as an input parameter to filter the returned addresses. If it is 0, both IPv4 and IPv6 addresses can be returned.
hostname The hostname to look up
Return values:
0 Success
-1 Failure

Definition at line 700 of file acl.c.

References ast_get_ip_or_srv().

Referenced by build_gateway(), build_peer(), build_user(), config_parse_variables(), peer_set_srcaddr(), setup_stunaddr(), and stun_monitor_request().

00701 {
00702    return ast_get_ip_or_srv(addr, hostname, NULL);
00703 }

int ast_get_ip_or_srv ( struct ast_sockaddr addr,
const char *  hostname,
const char *  service 
)

Get the IP address given a hostname and optional service.

If the service parameter is non-NULL, then an SRV lookup will be made by prepending the service to the hostname parameter, separated by a '.' For example, if hostname is "example.com" and service is "_sip._udp" then an SRV lookup will be done for "_sip._udp.example.com". If service is NULL, then this function acts exactly like a call to ast_get_ip.

Parameters:
addr The IP address found. The address family is used as an input parameter to filter the returned addresses. If it is 0, both IPv4 and IPv6 addresses can be returned.
hostname The hostname to look up
service A specific service provided by the host. A NULL service results in an A-record lookup instead of an SRV lookup
Return values:
0 Success
-1 Failure

Definition at line 597 of file acl.c.

References ast_get_srv(), ast_sockaddr_set_port, PARSE_PORT_FORBID, resolve_first(), and ast_sockaddr::ss.

Referenced by ast_get_ip(), create_addr(), dnsmgr_refresh(), internal_dnsmgr_lookup(), and proxy_update().

00598 {
00599    char srv[256];
00600    char host[256];
00601    int srv_ret = 0;
00602    int tportno;
00603 
00604    if (service) {
00605       snprintf(srv, sizeof(srv), "%s.%s", service, hostname);
00606       if ((srv_ret = ast_get_srv(NULL, host, sizeof(host), &tportno, srv)) > 0) {
00607          hostname = host;
00608       }
00609    }
00610 
00611    if (resolve_first(addr, hostname, PARSE_PORT_FORBID, addr->ss.ss_family) != 0) {
00612       return -1;
00613    }
00614 
00615    if (srv_ret > 0) {
00616       ast_sockaddr_set_port(addr, tportno);
00617    }
00618 
00619    return 0;
00620 }

int ast_lookup_iface ( char *  iface,
struct ast_sockaddr address 
)

Find an IP address associated with a specific interface.

Given an interface such as "eth0" we find the primary IP address associated with it using the SIOCGIFADDR ioctl. If the ioctl call should fail, we populate address with 0s.

Note:
This function is not actually used anywhere
Parameters:
iface The interface name whose IP address we wish to find
[out] address The interface's IP address is placed into this param
Return values:
-1 Failure. address is filled with 0s
0 Success
int ast_ouraddrfor ( const struct ast_sockaddr them,
struct ast_sockaddr us 
)

Get our local IP address when contacting a remote host.

This function will attempt to connect(2) to them over UDP using a source port of 5060. If the connect(2) call is successful, then we inspect the sockaddr_in output parameter of connect(2) to determine the IP address used to connect to them. This IP address is then copied into us.

Parameters:
them The IP address to which we wish to attempt to connect
[out] us The source IP address used to connect to them
Return values:
-1 Failure
0 Success

Definition at line 705 of file acl.c.

References ast_connect(), ast_debug, ast_getsockname(), ast_log(), ast_sockaddr_is_ipv6(), ast_sockaddr_port, ast_sockaddr_set_port, ast_sockaddr_stringify_addr(), ast_strdupa, LOG_ERROR, and LOG_WARNING.

Referenced by ast_find_ourip(), ast_sip_ouraddrfor(), build_gateway(), find_subchannel_and_lock(), gtalk_get_local_ip(), and sip_acf_channel_read().

00706 {
00707    int port;
00708    int s;
00709 
00710    port = ast_sockaddr_port(us);
00711 
00712    if ((s = socket(ast_sockaddr_is_ipv6(them) ? AF_INET6 : AF_INET,
00713          SOCK_DGRAM, 0)) < 0) {
00714       ast_log(LOG_ERROR, "Cannot create socket\n");
00715       return -1;
00716    }
00717 
00718    if (ast_connect(s, them)) {
00719       ast_log(LOG_WARNING, "Cannot connect\n");
00720       close(s);
00721       return -1;
00722    }
00723    if (ast_getsockname(s, us)) {
00724 
00725       ast_log(LOG_WARNING, "Cannot get socket name\n");
00726       close(s);
00727       return -1;
00728    }
00729    close(s);
00730 
00731    {
00732       const char *them_addr = ast_strdupa(ast_sockaddr_stringify_addr(them));
00733       const char *us_addr = ast_strdupa(ast_sockaddr_stringify_addr(us));
00734 
00735       ast_debug(3, "For destination '%s', our source address is '%s'.\n",
00736             them_addr, us_addr);
00737    }
00738 
00739    ast_sockaddr_set_port(us, port);
00740 
00741    return 0;
00742 }

int ast_str2cos ( const char *  value,
unsigned int *  cos 
)

Convert a string to the appropriate COS value.

Parameters:
value The COS string to convert
[out] cos The integer representation of that COS value
Return values:
-1 Failure
0 Success

Definition at line 653 of file acl.c.

Referenced by config_parse_variables(), reload_config(), and set_config().

00654 {
00655    int fval;
00656 
00657    if (sscanf(value, "%30d", &fval) == 1) {
00658       if (fval < 8) {
00659           *cos = fval;
00660           return 0;
00661       }
00662    }
00663 
00664    return -1;
00665 }

int ast_str2tos ( const char *  value,
unsigned int *  tos 
)

Convert a string to the appropriate TOS value.

Parameters:
value The TOS string to convert
[out] tos The integer representation of that TOS value
Return values:
-1 Failure
0 Success

Definition at line 667 of file acl.c.

References ARRAY_LEN, name, and dscp_codepoint::space.

Referenced by config_parse_variables(), iax_template_parse(), reload_config(), and set_config().

00668 {
00669    int fval;
00670    unsigned int x;
00671 
00672    if (sscanf(value, "%30i", &fval) == 1) {
00673       *tos = fval & 0xFF;
00674       return 0;
00675    }
00676 
00677    for (x = 0; x < ARRAY_LEN(dscp_pool1); x++) {
00678       if (!strcasecmp(value, dscp_pool1[x].name)) {
00679          *tos = dscp_pool1[x].space << 2;
00680          return 0;
00681       }
00682    }
00683 
00684    return -1;
00685 }

const char* ast_tos2str ( unsigned int  tos  ) 

Convert a TOS value into its string representation.

Parameters:
tos The TOS value to look up
Returns:
The string equivalent of the TOS value

Definition at line 687 of file acl.c.

References ARRAY_LEN, dscp_codepoint::name, and dscp_codepoint::space.

Referenced by sip_show_settings().

00688 {
00689    unsigned int x;
00690 
00691    for (x = 0; x < ARRAY_LEN(dscp_pool1); x++) {
00692       if (dscp_pool1[x].space == (tos >> 2)) {
00693          return dscp_pool1[x].name;
00694       }
00695    }
00696 
00697    return "unknown";
00698 }


Generated on 17 Aug 2018 for Asterisk - The Open Source Telephony Project by  doxygen 1.6.1