pjsip_configuration.c

Go to the documentation of this file.

/*
 * Asterisk -- An open source telephony toolkit.
 *
 * Copyright (C) 2013, Digium, Inc.
 *
 * Matt Jordan <mjordan@digium.com>
 *
 * See http://www.asterisk.org for more information about
 * the Asterisk project. Please do not directly contact
 * any of the maintainers of this project for assistance;
 * the project provides a web site, mailing lists and IRC
 * channels for your use.
 *
 * This program is free software, distributed under the terms of
 * the GNU General Public License Version 2. See the LICENSE file
 * at the top of the source tree.
 */
 
#include "asterisk.h"
 
#include <pjsip.h>
#include <pjsip_ua.h>
 
#include "asterisk/res_geolocation.h"
#include "asterisk/res_pjsip.h"
#include "include/res_pjsip_private.h"
#include "asterisk/res_pjsip_cli.h"
#include "asterisk/acl.h"
#include "asterisk/manager.h"
#include "asterisk/astobj2.h"
#include "asterisk/utils.h"
#include "asterisk/sorcery.h"
#include "asterisk/callerid.h"
#include "asterisk/test.h"
#include "asterisk/statsd.h"
#include "asterisk/pbx.h"
#include "asterisk/stream.h"
#include "asterisk/stasis.h"
#include "asterisk/security_events.h"
#include "asterisk/res_stir_shaken.h"
 
/*! \brief Number of buckets for persistent endpoint information */
#define PERSISTENT_BUCKETS 53
 
/*! \brief Persistent endpoint information */
struct sip_persistent_endpoint {
    /*! \brief Asterisk endpoint itself */
    struct ast_endpoint *endpoint;
};
 
/*! \brief Container for persistent endpoint information */
static struct ao2_container *persistent_endpoints;
 
static struct ast_sorcery *sip_sorcery;
 
static struct stasis_subscription *acl_change_sub;
 
/*! \brief Hashing function for persistent endpoint information */
static int persistent_endpoint_hash(const void *obj, const int flags)
{
    const struct sip_persistent_endpoint *persistent = obj;
    const char *id = (flags & OBJ_KEY ? obj : ast_endpoint_get_resource(persistent->endpoint));
 
    return ast_str_hash(id);
}
 
/*! \brief Comparison function for persistent endpoint information */
static int persistent_endpoint_cmp(void *obj, void *arg, int flags)
{
    const struct sip_persistent_endpoint *persistent1 = obj;
    const struct sip_persistent_endpoint *persistent2 = arg;
    const char *id = (flags & OBJ_KEY ? arg : ast_endpoint_get_resource(persistent2->endpoint));
 
    return !strcmp(ast_endpoint_get_resource(persistent1->endpoint), id) ? CMP_MATCH | CMP_STOP : 0;
}
 
static void endpoint_deleted_observer(const void *object)
{
    const struct ast_sip_endpoint *endpoint = object;
 
    ao2_find(persistent_endpoints, ast_endpoint_get_resource(endpoint->persistent),
        OBJ_SEARCH_KEY | OBJ_UNLINK | OBJ_NODATA);
}
 
static const struct ast_sorcery_observer endpoint_observers = {
    .deleted = endpoint_deleted_observer,
};
 
static int endpoint_acl_handler(const struct aco_option *opt, struct ast_variable *var, void *obj)
{
    struct ast_sip_endpoint *endpoint = obj;
    int error = 0;
    int ignore;
 
    if (ast_strlen_zero(var->value)) return 0;
 
    if (!strncmp(var->name, "contact_", 8)) {
        ast_append_acl(var->name + 8, var->value, &endpoint->contact_acl, &error, &ignore);
    } else {
        ast_append_acl(var->name, var->value, &endpoint->acl, &error, &ignore);
    }
 
    return error;
}
 
static int acl_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
    struct ast_acl_list *acl_list;
    struct ast_acl *first_acl;
 
    if (endpoint && !ast_acl_list_is_empty(acl_list=endpoint->acl)) {
        AST_LIST_LOCK(acl_list);
        first_acl = AST_LIST_FIRST(acl_list);
        if (ast_strlen_zero(first_acl->name)) {
            *buf = "deny/permit";
        } else {
            *buf = first_acl->name;
        }
        AST_LIST_UNLOCK(acl_list);
    }
 
    *buf = ast_strdup(*buf);
    return 0;
}
 
static int contact_acl_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
    struct ast_acl_list *acl_list;
    struct ast_acl *first_acl;
 
    if (endpoint && !ast_acl_list_is_empty(acl_list=endpoint->contact_acl)) {
        AST_LIST_LOCK(acl_list);
        first_acl = AST_LIST_FIRST(acl_list);
        if (ast_strlen_zero(first_acl->name)) {
            *buf = "deny/permit";
        } else {
            *buf = first_acl->name;
        }
        AST_LIST_UNLOCK(acl_list);
    }
 
    *buf = ast_strdup(*buf);
    return 0;
}
 
static int dtmf_handler(const struct aco_option *opt, struct ast_variable *var, void *obj)
{
    struct ast_sip_endpoint *endpoint = obj;
    int dtmf = ast_sip_str_to_dtmf(var->value);
 
    if (dtmf == -1) {
        return -1;
    }
 
    endpoint->dtmf = dtmf;
    return 0;
}
 
static int dtmf_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
    char dtmf_str[20];
    int result = -1;
 
    result = ast_sip_dtmf_to_str(endpoint->dtmf, dtmf_str, sizeof(dtmf_str));
 
    if (result == 0) {
        *buf = ast_strdup(dtmf_str);
    } else {
        *buf = ast_strdup("none");
    }
    return 0;
}
 
static int prack_handler(const struct aco_option *opt, struct ast_variable *var, void *obj)
{
    struct ast_sip_endpoint *endpoint = obj;
 
    /* clear all */
    endpoint->extensions.flags &= ~(PJSIP_INV_SUPPORT_100REL | PJSIP_INV_REQUIRE_100REL);
 
    if (ast_true(var->value)) {
        endpoint->extensions.flags |= PJSIP_INV_SUPPORT_100REL;
        endpoint->rel100 = AST_SIP_100REL_SUPPORTED;
    } else if (!strcasecmp(var->value, "peer_supported")) {
        endpoint->extensions.flags |= PJSIP_INV_SUPPORT_100REL;
        endpoint->rel100 = AST_SIP_100REL_PEER_SUPPORTED;
    } else if (!strcasecmp(var->value, "required")) {
        endpoint->extensions.flags |= PJSIP_INV_REQUIRE_100REL;
        endpoint->rel100 = AST_SIP_100REL_REQUIRED;
    } else if (ast_false(var->value)) {
        endpoint->rel100 = AST_SIP_100REL_UNSUPPORTED;
    } else {
        return -1;
    }
 
    return 0;
}
 
static int prack_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
 
    if (endpoint->rel100 == AST_SIP_100REL_SUPPORTED) {
        *buf = "yes";
    } else if (endpoint->rel100 == AST_SIP_100REL_PEER_SUPPORTED) {
        *buf = "peer_supported";
    } else if (endpoint->rel100 == AST_SIP_100REL_REQUIRED) {
        *buf = "required";
    } else {
        *buf = "no";
    }
 
    *buf = ast_strdup(*buf);
    return 0;
}
 
static int timers_handler(const struct aco_option *opt, struct ast_variable *var, void *obj)
{
    struct ast_sip_endpoint *endpoint = obj;
 
    /* clear all */
    endpoint->extensions.flags &= ~(PJSIP_INV_SUPPORT_TIMER | PJSIP_INV_REQUIRE_TIMER
                    | PJSIP_INV_ALWAYS_USE_TIMER);
 
    /* set only the specified flag and let pjsip normalize if needed */
    if (ast_true(var->value)) {
        endpoint->extensions.flags |= PJSIP_INV_SUPPORT_TIMER;
    } else if (!strcasecmp(var->value, "required")) {
        endpoint->extensions.flags |= PJSIP_INV_REQUIRE_TIMER;
    } else if (!strcasecmp(var->value, "always") || !strcasecmp(var->value, "forced")) {
        endpoint->extensions.flags |= (PJSIP_INV_SUPPORT_TIMER | PJSIP_INV_ALWAYS_USE_TIMER);
    } else if (!ast_false(var->value)) {
        return -1;
    }
 
    return 0;
}
 
static int timers_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
 
    if (endpoint->extensions.flags & PJSIP_INV_ALWAYS_USE_TIMER) {
        *buf = "always";
    } else if (endpoint->extensions.flags & PJSIP_INV_REQUIRE_TIMER) {
        *buf = "required";
    } else if (endpoint->extensions.flags & PJSIP_INV_SUPPORT_TIMER) {
        *buf = "yes";
    } else {
        *buf = "no";
    }
 
    *buf = ast_strdup(*buf);
    return 0;
}
 
static int security_mechanism_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
 
    return ast_sip_security_mechanisms_to_str(&endpoint->security_mechanisms, 0, buf);
}
 
static int security_mechanism_handler(const struct aco_option *opt, struct ast_variable *var, void *obj)
{
    struct ast_sip_endpoint *endpoint = obj;
 
    return ast_sip_security_mechanism_vector_init(&endpoint->security_mechanisms, var->value);
}
 
static const char *security_negotiation_map[] = {
    [AST_SIP_SECURITY_NEG_NONE] = "no",
    [AST_SIP_SECURITY_NEG_MEDIASEC] = "mediasec",
};
 
static int security_negotiation_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
    if (ARRAY_IN_BOUNDS(endpoint->security_negotiation, security_negotiation_map)) {
        *buf = ast_strdup(security_negotiation_map[endpoint->security_negotiation]);
    }
    return 0;
}
 
int ast_sip_set_security_negotiation(enum ast_sip_security_negotiation *security_negotiation, const char *val) {
    if (!strcasecmp("no", val)) {
        *security_negotiation = AST_SIP_SECURITY_NEG_NONE;
    } else if (!strcasecmp("mediasec", val)) {
        *security_negotiation = AST_SIP_SECURITY_NEG_MEDIASEC;
    } else {
        return -1;
    }
    return 0;
}
 
static int security_negotiation_handler(const struct aco_option *opt, struct ast_variable *var, void *obj)
{
    struct ast_sip_endpoint *endpoint = obj;
 
    return ast_sip_set_security_negotiation(&endpoint->security_negotiation, var->value);
}
 
void ast_sip_auth_vector_destroy(struct ast_sip_auth_vector *auths)
{
    int i;
    size_t size;
 
    if (!auths) {
        return;
    }
 
    size = AST_VECTOR_SIZE(auths);
 
    for (i = 0; i < size; ++i) {
        const char *name = AST_VECTOR_REMOVE_UNORDERED(auths, 0);
        ast_free((char *) name);
    }
    AST_VECTOR_FREE(auths);
}
 
int ast_sip_auth_vector_init(struct ast_sip_auth_vector *auths, const char *value)
{
    char *auth_names = ast_strdupa(value);
    char *val;
 
    ast_assert(auths != NULL);
 
    if (AST_VECTOR_SIZE(auths)) {
        ast_sip_auth_vector_destroy(auths);
    }
    if (AST_VECTOR_INIT(auths, 1)) {
        return -1;
    }
 
    while ((val = ast_strip(strsep(&auth_names, ",")))) {
        if (ast_strlen_zero(val)) {
            continue;
        }
 
        val = ast_strdup(val);
        if (!val) {
            goto failure;
        }
        if (AST_VECTOR_APPEND(auths, val)) {
            ast_free(val);
 
            goto failure;
        }
    }
    return 0;
 
failure:
    ast_sip_auth_vector_destroy(auths);
    return -1;
}
 
static int inbound_auth_handler(const struct aco_option *opt, struct ast_variable *var, void *obj)
{
    struct ast_sip_endpoint *endpoint = obj;
 
    return ast_sip_auth_vector_init(&endpoint->inbound_auths, var->value);
}
 
static int outbound_auth_handler(const struct aco_option *opt, struct ast_variable *var, void *obj)
{
    struct ast_sip_endpoint *endpoint = obj;
 
    return ast_sip_auth_vector_init(&endpoint->outbound_auths, var->value);
}
 
int ast_sip_auths_to_str(const struct ast_sip_auth_vector *auths, char **buf)
{
    if (!auths || !AST_VECTOR_SIZE(auths)) {
        return 0;
    }
 
    if (!(*buf = ast_calloc(MAX_OBJECT_FIELD, sizeof(char)))) {
        return -1;
    }
 
    /* I feel like accessing the vector's elem array directly is cheating...*/
    ast_join_delim(*buf, MAX_OBJECT_FIELD, auths->elems, AST_VECTOR_SIZE(auths), ',');
    return 0;
}
 
static int inbound_auths_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
    return ast_sip_auths_to_str(&endpoint->inbound_auths, buf);
}
 
static int outbound_auths_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
    return ast_sip_auths_to_str(&endpoint->outbound_auths, buf);
}
 
/*!
 * \internal
 * \brief Convert identify_by method to string.
 *
 * \param method Method value to convert to string
 *
 * \return String representation.
 */
static const char *sip_endpoint_identifier_type2str(enum ast_sip_endpoint_identifier_type method)
{
    const char *str = "<unknown>";
 
    switch (method) {
    case AST_SIP_ENDPOINT_IDENTIFY_BY_USERNAME:
        str = "username";
        break;
    case AST_SIP_ENDPOINT_IDENTIFY_BY_AUTH_USERNAME:
        str = "auth_username";
        break;
    case AST_SIP_ENDPOINT_IDENTIFY_BY_IP:
        str = "ip";
        break;
    case AST_SIP_ENDPOINT_IDENTIFY_BY_HEADER:
        str = "header";
        break;
    case AST_SIP_ENDPOINT_IDENTIFY_BY_REQUEST_URI:
        str = "request_uri";
        break;
    }
    return str;
}
 
/*!
 * \internal
 * \brief Convert string to an endpoint identifier token.
 *
 * \param str String to convert
 *
 * \retval enum ast_sip_endpoint_identifier_type token value on success.
 * \retval -1 on failure.
 */
static int sip_endpoint_identifier_str2type(const char *str)
{
    int method;
 
    if (!strcasecmp(str, "username")) {
        method = AST_SIP_ENDPOINT_IDENTIFY_BY_USERNAME;
    } else if (!strcasecmp(str, "auth_username")) {
        method = AST_SIP_ENDPOINT_IDENTIFY_BY_AUTH_USERNAME;
    } else if (!strcasecmp(str, "ip")) {
        method = AST_SIP_ENDPOINT_IDENTIFY_BY_IP;
    } else if (!strcasecmp(str, "header")) {
        method = AST_SIP_ENDPOINT_IDENTIFY_BY_HEADER;
    } else if (!strcasecmp(str, "request_uri")) {
        method = AST_SIP_ENDPOINT_IDENTIFY_BY_REQUEST_URI;
    } else {
        method = -1;
    }
    return method;
}
 
static int ident_handler(const struct aco_option *opt, struct ast_variable *var, void *obj)
{
    struct ast_sip_endpoint *endpoint = obj;
    char *idents = ast_strdupa(var->value);
    char *val;
    int method;
 
    /*
     * If there's already something in the vector when we get here,
     * it's the default value so we need to clean it out.
     */
    if (AST_VECTOR_SIZE(&endpoint->ident_method_order)) {
        AST_VECTOR_RESET(&endpoint->ident_method_order, AST_VECTOR_ELEM_CLEANUP_NOOP);
        endpoint->ident_method = 0;
    }
 
    while ((val = ast_strip(strsep(&idents, ",")))) {
        if (ast_strlen_zero(val)) {
            continue;
        }
 
        method = sip_endpoint_identifier_str2type(val);
        if (method == -1) {
            ast_log(LOG_ERROR, "Unrecognized identification method %s specified for endpoint %s\n",
                    val, ast_sorcery_object_get_id(endpoint));
            AST_VECTOR_RESET(&endpoint->ident_method_order, AST_VECTOR_ELEM_CLEANUP_NOOP);
            endpoint->ident_method = 0;
            return -1;
        }
        if (endpoint->ident_method & method) {
            /* We are already identifying by this method.  No need to do it again. */
            continue;
        }
 
        endpoint->ident_method |= method;
        AST_VECTOR_APPEND(&endpoint->ident_method_order, method);
    }
 
    return 0;
}
 
static int ident_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
    int methods;
    int idx;
    int buf_used = 0;
    int buf_size = MAX_OBJECT_FIELD;
 
    methods = AST_VECTOR_SIZE(&endpoint->ident_method_order);
    if (!methods) {
        return 0;
    }
 
    *buf = ast_malloc(buf_size);
    if (!*buf) {
        return -1;
    }
 
    for (idx = 0; idx < methods; ++idx) {
        enum ast_sip_endpoint_identifier_type method;
        const char *method_str;
 
        method = AST_VECTOR_GET(&endpoint->ident_method_order, idx);
        method_str = sip_endpoint_identifier_type2str(method);
 
        /* Should never have an "<unknown>" method string */
        ast_assert(strcmp(method_str, "<unknown>"));
        if (!strcmp(method_str, "<unknown>")) {
            continue;
        }
 
        buf_used += snprintf(*buf + buf_used, buf_size - buf_used, "%s%s",
            method_str, idx < methods - 1 ? "," : "");
        if (buf_size <= buf_used) {
            /* Need more room than available, truncating. */
            *(*buf + (buf_size - 1)) = '\0';
            ast_log(LOG_WARNING, "Truncated identify_by string: %s\n", *buf);
            break;
        }
    }
 
    return 0;
}
 
static int media_address_handler(const struct aco_option *opt, struct ast_variable *var, void *obj)
{
    struct ast_sip_endpoint *endpoint = obj;
    struct ast_sockaddr addr;
 
    if (ast_sockaddr_parse(&addr, var->value, 0)) {
        /* If we're able to parse as an IP, ensure it's formatted correctly for later */
        ast_string_field_set(endpoint, media.address, ast_sockaddr_stringify_addr_remote(&addr));
    } else {
        /* If we weren't able to parse it as an IP, just assume it's a hostname */
        ast_string_field_set(endpoint, media.address, var->value);
    }
 
    return 0;
}
 
static int media_address_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
    *buf = ast_strdup(endpoint->media.address);
    return 0;
}
 
static int redirect_method_handler(const struct aco_option *opt, struct ast_variable *var, void *obj)
{
    struct ast_sip_endpoint *endpoint = obj;
 
    if (!strcasecmp(var->value, "user")) {
        endpoint->redirect_method = AST_SIP_REDIRECT_USER;
    } else if (!strcasecmp(var->value, "uri_core")) {
        endpoint->redirect_method = AST_SIP_REDIRECT_URI_CORE;
    } else if (!strcasecmp(var->value, "uri_pjsip")) {
        endpoint->redirect_method = AST_SIP_REDIRECT_URI_PJSIP;
    } else {
        ast_log(LOG_ERROR, "Unrecognized redirect method %s specified for endpoint %s\n",
            var->value, ast_sorcery_object_get_id(endpoint));
        return -1;
    }
 
    return 0;
}
 
static const char *redirect_method_map[] = {
    [AST_SIP_REDIRECT_USER] = "user",
    [AST_SIP_REDIRECT_URI_CORE] = "uri_core",
    [AST_SIP_REDIRECT_URI_PJSIP] = "uri_pjsip",
};
 
static int redirect_method_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
    if (ARRAY_IN_BOUNDS(endpoint->redirect_method, redirect_method_map)) {
        *buf = ast_strdup(redirect_method_map[endpoint->redirect_method]);
    }
    return 0;
}
 
/*!
 * \brief Mapping of SIP method names to their corresponding redirect flags
 */
struct redirect_method_map {
    const char *method_name;
    enum ast_sip_redirect_method flag;
};
 
static const struct redirect_method_map redirect_method_mappings[] = {
    { "message", AST_SIP_REDIRECT_METHOD_MESSAGE },
};
 
static int follow_redirect_methods_handler(const struct aco_option *opt, struct ast_variable *var, void *obj)
{
    struct ast_sip_endpoint *endpoint = obj;
    char *methods;
    char *method;
    int i;
 
    /* Clear any existing flags */
    ast_clear_flag(&endpoint->follow_redirect_methods, ~0);
 
    if (ast_strlen_zero(var->value)) {
        return 0;
    }
 
    methods = ast_strdupa(var->value);
    while ((method = ast_strsep(&methods, ',', AST_STRSEP_TRIM))) {
        int found = 0;
 
        /* Look up the method in our mapping table */
        for (i = 0; i < ARRAY_LEN(redirect_method_mappings); i++) {
            if (!strcasecmp(method, redirect_method_mappings[i].method_name)) {
                ast_set_flag(&endpoint->follow_redirect_methods, redirect_method_mappings[i].flag);
                found = 1;
                break;
            }
        }
 
        if (!found) {
            ast_log(LOG_ERROR, "Unrecognized SIP method '%s' for follow_redirect_methods on endpoint %s\n",
                method, ast_sorcery_object_get_id(endpoint));
            return -1;
        }
    }
 
    return 0;
}
 
static int follow_redirect_methods_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
    struct ast_str *str = ast_str_create(64);
    int first = 1;
    int i;
 
    if (!str) {
        return -1;
    }
 
    /* Iterate through all supported methods and append if flag is set */
    for (i = 0; i < ARRAY_LEN(redirect_method_mappings); i++) {
        if (ast_test_flag(&endpoint->follow_redirect_methods, redirect_method_mappings[i].flag)) {
            ast_str_append(&str, 0, "%s%s", first ? "" : ",", redirect_method_mappings[i].method_name);
            first = 0;
        }
    }
 
    *buf = ast_strdup(ast_str_buffer(str));
    ast_free(str);
 
    return 0;
}
 
static int direct_media_method_handler(const struct aco_option *opt, struct ast_variable *var, void *obj)
{
    struct ast_sip_endpoint *endpoint = obj;
 
    if (!strcasecmp(var->value, "invite") || !strcasecmp(var->value, "reinvite")) {
        endpoint->media.direct_media.method = AST_SIP_SESSION_REFRESH_METHOD_INVITE;
    } else if (!strcasecmp(var->value, "update")) {
        endpoint->media.direct_media.method = AST_SIP_SESSION_REFRESH_METHOD_UPDATE;
    } else {
        ast_log(LOG_NOTICE, "Unrecognized option value %s for %s on endpoint %s\n",
                var->value, var->name, ast_sorcery_object_get_id(endpoint));
        return -1;
    }
    return 0;
}
 
static const char *id_configuration_refresh_methods[] = {
    [AST_SIP_SESSION_REFRESH_METHOD_INVITE] = "invite",
    [AST_SIP_SESSION_REFRESH_METHOD_UPDATE] = "update"
};
 
static int direct_media_method_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
    if (ARRAY_IN_BOUNDS(endpoint->id.refresh_method, id_configuration_refresh_methods)) {
        *buf = ast_strdup(id_configuration_refresh_methods[endpoint->id.refresh_method]);
    }
    return 0;
}
 
static int connected_line_method_handler(const struct aco_option *opt, struct ast_variable *var, void *obj)
{
    struct ast_sip_endpoint *endpoint = obj;
 
    if (!strcasecmp(var->value, "invite") || !strcasecmp(var->value, "reinvite")) {
        endpoint->id.refresh_method = AST_SIP_SESSION_REFRESH_METHOD_INVITE;
    } else if (!strcasecmp(var->value, "update")) {
        endpoint->id.refresh_method = AST_SIP_SESSION_REFRESH_METHOD_UPDATE;
    } else {
        ast_log(LOG_NOTICE, "Unrecognized option value %s for %s on endpoint %s\n",
                var->value, var->name, ast_sorcery_object_get_id(endpoint));
        return -1;
    }
    return 0;
}
 
static int connected_line_method_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
    *buf = ast_strdup(id_configuration_refresh_methods[endpoint->id.refresh_method]);
    return 0;
}
 
static int direct_media_glare_mitigation_handler(const struct aco_option *opt, struct ast_variable *var, void *obj)
{
    struct ast_sip_endpoint *endpoint = obj;
 
    if (!strcasecmp(var->value, "none")) {
        endpoint->media.direct_media.glare_mitigation = AST_SIP_DIRECT_MEDIA_GLARE_MITIGATION_NONE;
    } else if (!strcasecmp(var->value, "outgoing")) {
        endpoint->media.direct_media.glare_mitigation = AST_SIP_DIRECT_MEDIA_GLARE_MITIGATION_OUTGOING;
    } else if (!strcasecmp(var->value, "incoming")) {
        endpoint->media.direct_media.glare_mitigation = AST_SIP_DIRECT_MEDIA_GLARE_MITIGATION_INCOMING;
    } else {
        ast_log(LOG_NOTICE, "Unrecognized option value %s for %s on endpoint %s\n",
                var->value, var->name, ast_sorcery_object_get_id(endpoint));
        return -1;
    }
 
    return 0;
}
 
static const char *direct_media_glare_mitigation_map[] = {
    [AST_SIP_DIRECT_MEDIA_GLARE_MITIGATION_NONE] = "none",
    [AST_SIP_DIRECT_MEDIA_GLARE_MITIGATION_OUTGOING] = "outgoing",
    [AST_SIP_DIRECT_MEDIA_GLARE_MITIGATION_INCOMING] = "incoming"
};
 
static int direct_media_glare_mitigation_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
    if (ARRAY_IN_BOUNDS(endpoint->media.direct_media.glare_mitigation, direct_media_glare_mitigation_map)) {
        *buf = ast_strdup(direct_media_glare_mitigation_map[endpoint->media.direct_media.glare_mitigation]);
    }
 
    return 0;
}
 
static int caller_id_handler(const struct aco_option *opt, struct ast_variable *var, void *obj)
{
    struct ast_sip_endpoint *endpoint = obj;
    char cid_name[80] = { '\0' };
    char cid_num[80] = { '\0' };
 
    ast_free(endpoint->id.self.name.str);
    endpoint->id.self.name.str = NULL;
    endpoint->id.self.name.valid = 0;
    ast_free(endpoint->id.self.number.str);
    endpoint->id.self.number.str = NULL;
    endpoint->id.self.number.valid = 0;
 
    ast_callerid_split(var->value, cid_name, sizeof(cid_name), cid_num, sizeof(cid_num));
    if (!ast_strlen_zero(cid_name)) {
        endpoint->id.self.name.str = ast_strdup(cid_name);
        if (!endpoint->id.self.name.str) {
            return -1;
        }
        endpoint->id.self.name.valid = 1;
    }
    if (!ast_strlen_zero(cid_num)) {
        endpoint->id.self.number.str = ast_strdup(cid_num);
        if (!endpoint->id.self.number.str) {
            return -1;
        }
        endpoint->id.self.number.valid = 1;
    }
    return 0;
}
 
static int caller_id_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
    const char *name = S_COR(endpoint->id.self.name.valid,
                 endpoint->id.self.name.str, NULL);
    const char *number = S_COR(endpoint->id.self.number.valid,
                   endpoint->id.self.number.str, NULL);
 
    /* make sure size is at least 10 - that should cover the "<unknown>"
       case as well as any additional formatting characters added in
       the name and/or number case. */
    int size = 10;
    size += name ? strlen(name) : 0;
    size += number ? strlen(number) : 0;
 
    if (!(*buf = ast_calloc(size + 1, sizeof(char)))) {
        return -1;
    }
 
    ast_callerid_merge(*buf, size + 1, name, number, NULL);
    return 0;
}
 
static int caller_id_privacy_handler(const struct aco_option *opt, struct ast_variable *var, void *obj)
{
    struct ast_sip_endpoint *endpoint = obj;
    int callingpres = ast_parse_caller_presentation(var->value);
    if (callingpres == -1 && sscanf(var->value, "%d", &callingpres) != 1) {
        return -1;
    }
    endpoint->id.self.number.presentation = callingpres;
    endpoint->id.self.name.presentation = callingpres;
    return 0;
}
 
static int caller_id_privacy_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
    const char *presentation = ast_named_caller_presentation(
        endpoint->id.self.name.presentation);
 
    *buf = ast_strdup(presentation);
    return 0;
}
 
static int caller_id_tag_handler(const struct aco_option *opt, struct ast_variable *var, void *obj)
{
    struct ast_sip_endpoint *endpoint = obj;
 
    ast_free(endpoint->id.self.tag);
    endpoint->id.self.tag = ast_strdup(var->value);
 
    return endpoint->id.self.tag ? 0 : -1;
}
 
static int caller_id_tag_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
    *buf = ast_strdup(endpoint->id.self.tag);
    return 0;
}
 
static int media_encryption_handler(const struct aco_option *opt, struct ast_variable *var, void *obj)
{
    struct ast_sip_endpoint *endpoint = obj;
 
    if (!strcasecmp("no", var->value)) {
        endpoint->media.rtp.encryption = AST_SIP_MEDIA_ENCRYPT_NONE;
    } else if (!strcasecmp("sdes", var->value)) {
        endpoint->media.rtp.encryption = AST_SIP_MEDIA_ENCRYPT_SDES;
    } else if (!strcasecmp("dtls", var->value)) {
        endpoint->media.rtp.encryption = AST_SIP_MEDIA_ENCRYPT_DTLS;
        return ast_rtp_dtls_cfg_parse(&endpoint->media.rtp.dtls_cfg, "dtlsenable", "yes");
    } else {
        return -1;
    }
 
    return 0;
}
 
static const char *media_encryption_map[] = {
    [AST_SIP_MEDIA_TRANSPORT_INVALID] = "invalid",
    [AST_SIP_MEDIA_ENCRYPT_NONE] = "no",
    [AST_SIP_MEDIA_ENCRYPT_SDES] = "sdes",
    [AST_SIP_MEDIA_ENCRYPT_DTLS] = "dtls",
};
 
static int media_encryption_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
    if (ARRAY_IN_BOUNDS(endpoint->media.rtp.encryption, media_encryption_map)) {
        *buf = ast_strdup(media_encryption_map[
                      endpoint->media.rtp.encryption]);
    }
    return 0;
}
 
static int stir_shaken_handler(const struct aco_option *opt, struct ast_variable *var, void *obj)
{
    struct ast_sip_endpoint *endpoint = obj;
 
    ast_log(LOG_WARNING, "Endpoint %s: Option 'stir_shaken' is no longer supported.  Use 'stir_shaken_profile' instead.\n",
        ast_sorcery_object_get_id(endpoint));
    endpoint->stir_shaken = 0;
 
    return 0;
}
 
static int stir_shaken_to_str(const void *obj, const intptr_t *args, char **buf)
{
    *buf = ast_strdup("no");
 
    return 0;
}
 
static int group_handler(const struct aco_option *opt,
             struct ast_variable *var, void *obj)
{
    struct ast_sip_endpoint *endpoint = obj;
 
    if (!strncmp(var->name, "call_group", 10)) {
        endpoint->pickup.callgroup = ast_get_group(var->value);
    } else if (!strncmp(var->name, "pickup_group", 12)) {
        endpoint->pickup.pickupgroup = ast_get_group(var->value);
    } else {
        return -1;
    }
 
    return 0;
}
 
static int callgroup_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
 
    if (!(*buf = ast_calloc(MAX_OBJECT_FIELD, sizeof(char)))) {
        return -1;
    }
 
    ast_print_group(*buf, MAX_OBJECT_FIELD, endpoint->pickup.callgroup);
    return 0;
}
 
static int pickupgroup_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
 
    if (!(*buf = ast_calloc(MAX_OBJECT_FIELD, sizeof(char)))) {
        return -1;
    }
 
    ast_print_group(*buf, MAX_OBJECT_FIELD, endpoint->pickup.pickupgroup);
    return 0;
}
 
static int named_groups_handler(const struct aco_option *opt,
                struct ast_variable *var, void *obj)
{
    struct ast_sip_endpoint *endpoint = obj;
 
    if (!strncmp(var->name, "named_call_group", 16)) {
        if (ast_strlen_zero(var->value)) {
            endpoint->pickup.named_callgroups =
                ast_unref_namedgroups(endpoint->pickup.named_callgroups);
        } else if (!(endpoint->pickup.named_callgroups =
              ast_get_namedgroups(var->value))) {
            return -1;
        }
    } else if (!strncmp(var->name, "named_pickup_group", 18)) {
        if (ast_strlen_zero(var->value)) {
            endpoint->pickup.named_pickupgroups =
                ast_unref_namedgroups(endpoint->pickup.named_pickupgroups);
        } else if (!(endpoint->pickup.named_pickupgroups =
              ast_get_namedgroups(var->value))) {
            return -1;
        }
    } else {
        return -1;
    }
 
    return 0;
}
 
static int named_callgroups_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
    RAII_VAR(struct ast_str *, str, ast_str_create(MAX_OBJECT_FIELD), ast_free);
 
    ast_print_namedgroups(&str, endpoint->pickup.named_callgroups);
    *buf = ast_strdup(ast_str_buffer(str));
    return 0;
}
 
static int named_pickupgroups_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
    RAII_VAR(struct ast_str *, str, ast_str_create(MAX_OBJECT_FIELD), ast_free);
 
    ast_print_namedgroups(&str, endpoint->pickup.named_pickupgroups);
    *buf = ast_strdup(ast_str_buffer(str));
    return 0;
}
 
static int dtls_handler(const struct aco_option *opt,
             struct ast_variable *var, void *obj)
{
    struct ast_sip_endpoint *endpoint = obj;
    char *name = ast_strdupa(var->name);
    char *front = NULL;
    char *back = NULL;
    char *buf = name;
 
    /* strip out underscores in the name */
    front = strtok_r(buf, "_", &back);
    while (front) {
        int size = strlen(front);
        ast_copy_string(buf, front, size + 1);
        buf += size;
        front = strtok_r(NULL, "_", &back);
    }
 
    return ast_rtp_dtls_cfg_parse(&endpoint->media.rtp.dtls_cfg, name, var->value);
}
 
static int dtlsverify_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
    if (endpoint->media.rtp.dtls_cfg.verify == AST_RTP_DTLS_VERIFY_NONE) {
        *buf = ast_strdup("No");
    } else if (endpoint->media.rtp.dtls_cfg.verify == AST_RTP_DTLS_VERIFY_FINGERPRINT) {
        *buf = ast_strdup("Fingerprint");
    } else if (endpoint->media.rtp.dtls_cfg.verify == AST_RTP_DTLS_VERIFY_CERTIFICATE) {
        *buf = ast_strdup("Certificate");
    } else if (endpoint->media.rtp.dtls_cfg.verify == (AST_RTP_DTLS_VERIFY_FINGERPRINT|AST_RTP_DTLS_VERIFY_CERTIFICATE)) {
        *buf = ast_strdup("Yes");
    } else {
        *buf = NULL;
        ast_assert(0);
        return 1;
    }
    return 0;
}
 
static int dtlsrekey_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
 
    return ast_asprintf(
        buf, "%u", endpoint->media.rtp.dtls_cfg.rekey) >=0 ? 0 : -1;
}
 
static int dtlsautogeneratecert_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
    *buf = ast_strdup(AST_YESNO(endpoint->media.rtp.dtls_cfg.ephemeral_cert));
    return 0;
}
 
static int dtlscertfile_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
    *buf = ast_strdup(endpoint->media.rtp.dtls_cfg.certfile);
    return 0;
}
 
static int dtlsprivatekey_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
    *buf = ast_strdup(endpoint->media.rtp.dtls_cfg.pvtfile);
    return 0;
}
 
static int dtlscipher_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
    *buf = ast_strdup(endpoint->media.rtp.dtls_cfg.cipher);
    return 0;
}
 
static int dtlscafile_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
    *buf = ast_strdup(endpoint->media.rtp.dtls_cfg.cafile);
    return 0;
}
 
static int dtlscapath_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
    *buf = ast_strdup(endpoint->media.rtp.dtls_cfg.capath);
    return 0;
}
 
static const char *ast_rtp_dtls_setup_map[] = {
    [AST_RTP_DTLS_SETUP_ACTIVE] = "active",
    [AST_RTP_DTLS_SETUP_PASSIVE] = "passive",
    [AST_RTP_DTLS_SETUP_ACTPASS] = "actpass",
    [AST_RTP_DTLS_SETUP_HOLDCONN] = "holdconn",
};
 
static int dtlssetup_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
    if (ARRAY_IN_BOUNDS(endpoint->media.rtp.dtls_cfg.default_setup, ast_rtp_dtls_setup_map)) {
        *buf = ast_strdup(ast_rtp_dtls_setup_map[endpoint->media.rtp.dtls_cfg.default_setup]);
    }
    return 0;
}
 
static const char *ast_rtp_dtls_fingerprint_map[] = {
    [AST_RTP_DTLS_HASH_SHA256] = "SHA-256",
    [AST_RTP_DTLS_HASH_SHA1] = "SHA-1",
};
 
static int dtlsfingerprint_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
    if (ARRAY_IN_BOUNDS(endpoint->media.rtp.dtls_cfg.hash, ast_rtp_dtls_fingerprint_map)) {
        *buf = ast_strdup(ast_rtp_dtls_fingerprint_map[endpoint->media.rtp.dtls_cfg.hash]);
    }
    return 0;
}
 
static int t38udptl_ec_handler(const struct aco_option *opt,
    struct ast_variable *var, void *obj)
{
    struct ast_sip_endpoint *endpoint = obj;
 
    if (!strcmp(var->value, "none")) {
        endpoint->media.t38.error_correction = UDPTL_ERROR_CORRECTION_NONE;
    } else if (!strcmp(var->value, "fec")) {
        endpoint->media.t38.error_correction = UDPTL_ERROR_CORRECTION_FEC;
    } else if (!strcmp(var->value, "redundancy")) {
        endpoint->media.t38.error_correction = UDPTL_ERROR_CORRECTION_REDUNDANCY;
    } else {
        return -1;
    }
 
    return 0;
}
 
static const char *ast_t38_ec_modes_map[] = {
    [UDPTL_ERROR_CORRECTION_NONE] = "none",
    [UDPTL_ERROR_CORRECTION_FEC] = "fec",
    [UDPTL_ERROR_CORRECTION_REDUNDANCY] = "redundancy"
};
 
static int t38udptl_ec_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
    if (ARRAY_IN_BOUNDS(endpoint->media.t38.error_correction, ast_t38_ec_modes_map)) {
        *buf = ast_strdup(ast_t38_ec_modes_map[
                      endpoint->media.t38.error_correction]);
    }
    return 0;
}
 
static int tos_handler(const struct aco_option *opt,
    struct ast_variable *var, void *obj)
{
    struct ast_sip_endpoint *endpoint = obj;
    unsigned int value;
 
    if (ast_str2tos(var->value, &value)) {
        ast_log(LOG_ERROR, "Error configuring endpoint '%s' - Could not "
            "interpret '%s' value '%s'\n",
            ast_sorcery_object_get_id(endpoint), var->name, var->value);
        return -1;
    }
 
    if (!strcmp(var->name, "tos_audio")) {
        endpoint->media.tos_audio = value;
    } else if (!strcmp(var->name, "tos_video")) {
        endpoint->media.tos_video = value;
    } else {
        /* If we reach this point, someone called the tos_handler when they shouldn't have. */
        ast_assert(0);
        return -1;
    }
    return 0;
}
 
static int tos_audio_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
 
    if (ast_asprintf(buf, "%u", endpoint->media.tos_audio) == -1) {
        return -1;
    }
    return 0;
}
 
static int tos_video_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
 
    if (ast_asprintf(buf, "%u", endpoint->media.tos_video) == -1) {
        return -1;
    }
    return 0;
}
 
static int from_user_handler(const struct aco_option *opt,
    struct ast_variable *var, void *obj)
{
    struct ast_sip_endpoint *endpoint = obj;
    /* Valid non-alphanumeric characters for URI */
    char *valid_uri_marks = "-._~%!$&'()*+,;=:";
    const char *val;
 
    for (val = var->value; *val; val++) {
        if (!isalpha(*val) && !isdigit(*val) && !strchr(valid_uri_marks, *val)) {
            ast_log(LOG_ERROR, "Error configuring endpoint '%s' - '%s' field "
            "contains invalid character '%c'\n",
            ast_sorcery_object_get_id(endpoint), var->name, *val);
            return -1;
        }
    }
 
    ast_string_field_set(endpoint, fromuser, var->value);
 
    return 0;
}
 
static int from_user_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
 
    *buf = ast_strdup(endpoint->fromuser);
 
    return 0;
}
 
static int set_var_handler(const struct aco_option *opt,
    struct ast_variable *var, void *obj)
{
    struct ast_sip_endpoint *endpoint = obj;
    struct ast_variable *new_var;
    char *name;
    char *val;
 
    if (ast_strlen_zero(var->value)) {
        return 0;
    }
 
    name = ast_strdupa(var->value);
    val = strchr(name, '=');
 
    if (!val) {
        return -1;
    }
 
    *val++ = '\0';
 
    if (!(new_var = ast_variable_new(name, val, ""))) {
        return -1;
    }
 
    if (ast_variable_list_replace(&endpoint->channel_vars, new_var)) {
        ast_variable_list_append(&endpoint->channel_vars, new_var);
    }
 
    return 0;
}
 
static int set_var_to_str(const void *obj, const intptr_t *args, char **buf)
{
    struct ast_str *str = ast_str_create(MAX_OBJECT_FIELD);
    const struct ast_sip_endpoint *endpoint = obj;
    struct ast_variable *var;
 
    for (var = endpoint->channel_vars; var; var = var->next) {
        ast_str_append(&str, 0, "%s=%s,", var->name, var->value);
    }
 
    *buf = ast_strdup(ast_str_truncate(str, -1));
    ast_free(str);
    return 0;
}
 
static int set_var_to_vl(const void *obj, struct ast_variable **fields)
{
    const struct ast_sip_endpoint *endpoint = obj;
    if (endpoint->channel_vars) {
        *fields = ast_variables_dup(endpoint->channel_vars);
    }
    return 0;
}
 
static int voicemail_extension_handler(const struct aco_option *opt, struct ast_variable *var, void *obj)
{
    struct ast_sip_endpoint *endpoint = obj;
 
    ast_free(endpoint->subscription.mwi.voicemail_extension);
    endpoint->subscription.mwi.voicemail_extension = ast_strdup(var->value);
 
    return endpoint->subscription.mwi.voicemail_extension ? 0 : -1;
}
 
static int voicemail_extension_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
 
    *buf = ast_strdup(endpoint->subscription.mwi.voicemail_extension);
 
    return 0;
}
 
static int contact_user_handler(const struct aco_option *opt,
    struct ast_variable *var, void *obj)
{
    struct ast_sip_endpoint *endpoint = obj;
 
    ast_free(endpoint->contact_user);
    endpoint->contact_user = ast_strdup(var->value);
 
    return endpoint->contact_user ? 0 : -1;
}
 
static int contact_user_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
 
    *buf = ast_strdup(endpoint->contact_user);
    if (!(*buf)) {
        return -1;
    }
 
    return 0;
}
 
static int call_offer_pref_handler(const struct aco_option *opt,
    struct ast_variable *var, void *obj)
{
    struct ast_sip_endpoint *endpoint = obj;
    struct ast_flags pref = { 0, };
    int outgoing = strcmp(var->name, "outgoing_call_offer_pref") == 0;
 
    int res = ast_sip_call_codec_str_to_pref(&pref, var->value, outgoing);
    if (res != 0) {
        return -1;
    }
 
    if (outgoing) {
        endpoint->media.outgoing_call_offer_pref = pref;
    } else {
        endpoint->media.incoming_call_offer_pref = pref;
    }
 
    return 0;
}
 
static int incoming_call_offer_pref_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
 
    *buf = ast_strdup(ast_sip_call_codec_pref_to_str(endpoint->media.incoming_call_offer_pref));
    if (!(*buf)) {
        return -1;
    }
 
    return 0;
}
 
static int outgoing_call_offer_pref_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
 
    *buf = ast_strdup(ast_sip_call_codec_pref_to_str(endpoint->media.outgoing_call_offer_pref));
    if (!(*buf)) {
        return -1;
    }
 
    return 0;
}
 
static int codec_prefs_handler(const struct aco_option *opt,
    struct ast_variable *var, void *obj)
{
    struct ast_sip_endpoint *endpoint = obj;
    struct ast_stream_codec_negotiation_prefs *option_prefs;
    struct ast_stream_codec_negotiation_prefs prefs;
    struct ast_str *error_message = ast_str_create(128);
    enum ast_stream_codec_negotiation_prefs_prefer_values default_prefer;
    enum ast_stream_codec_negotiation_prefs_operation_values default_operation;
    int res = 0;
 
    res = ast_stream_codec_prefs_parse(var->value, &prefs, &error_message);
    if (res < 0) {
        ast_log(LOG_ERROR, "Endpoint '%s': %s for option '%s'\n",
            ast_sorcery_object_get_id(endpoint), ast_str_buffer(error_message), var->name);
        ast_free(error_message);
        return -1;
    }
    ast_free(error_message);
 
    if (strcmp(var->name, "codec_prefs_incoming_offer") == 0) {
        if (prefs.operation == CODEC_NEGOTIATION_OPERATION_UNION) {
            ast_log(LOG_ERROR, "Endpoint '%s': Codec preference '%s' has invalid value '%s' for option: '%s'",
                ast_sorcery_object_get_id(endpoint),
                ast_stream_codec_param_to_str(CODEC_NEGOTIATION_PARAM_OPERATION),
                ast_stream_codec_operation_to_str(CODEC_NEGOTIATION_OPERATION_UNION),
                var->name);
            return -1;
        }
        option_prefs = &endpoint->media.codec_prefs_incoming_offer;
        default_prefer = CODEC_NEGOTIATION_PREFER_PENDING;
        default_operation = CODEC_NEGOTIATION_OPERATION_INTERSECT;
    } else if (strcmp(var->name, "codec_prefs_outgoing_offer") == 0) {
        option_prefs = &endpoint->media.codec_prefs_outgoing_offer;
        default_prefer = CODEC_NEGOTIATION_PREFER_PENDING;
        default_operation = CODEC_NEGOTIATION_OPERATION_UNION;
    } else if (strcmp(var->name, "codec_prefs_incoming_answer") == 0) {
        option_prefs = &endpoint->media.codec_prefs_incoming_answer;
        default_prefer = CODEC_NEGOTIATION_PREFER_PENDING;
        default_operation = CODEC_NEGOTIATION_OPERATION_INTERSECT;
    } else if (strcmp(var->name, "codec_prefs_outgoing_answer") == 0) {
        option_prefs = &endpoint->media.codec_prefs_outgoing_answer;
        default_prefer = CODEC_NEGOTIATION_PREFER_PENDING;
        default_operation = CODEC_NEGOTIATION_OPERATION_INTERSECT;
    } else {
        ast_log(LOG_ERROR, "Endpoint '%s': Unsupported option '%s'\n",
            ast_sorcery_object_get_id(endpoint),
            var->name);
        return -1;
    }
 
    if (prefs.prefer == CODEC_NEGOTIATION_PREFER_UNSPECIFIED) {
        prefs.prefer = default_prefer;
    }
 
    if (prefs.operation == CODEC_NEGOTIATION_OPERATION_UNSPECIFIED) {
        prefs.operation = default_operation;
    }
 
    if (prefs.keep == CODEC_NEGOTIATION_KEEP_UNSPECIFIED) {
        prefs.keep = CODEC_NEGOTIATION_KEEP_ALL;
    }
 
    if (prefs.transcode == CODEC_NEGOTIATION_TRANSCODE_UNSPECIFIED) {
        prefs.transcode = CODEC_NEGOTIATION_TRANSCODE_ALLOW;
    }
 
    /* Now that defaults have been applied as needed we apply the full codec
     * preference configuration to the option.
     */
    *option_prefs = prefs;
 
    return 0;
}
 
static int codec_prefs_to_str(const struct ast_stream_codec_negotiation_prefs *prefs,
    const void *obj, const intptr_t *args, char **buf)
{
    struct ast_str *codecs = ast_str_create(AST_STREAM_MAX_CODEC_PREFS_LENGTH);
 
    if (!codecs) {
        return -1;
    }
 
    *buf = ast_strdup(ast_stream_codec_prefs_to_str(prefs, &codecs));
    ast_free(codecs);
 
    return 0;
}
 
static int incoming_offer_codec_prefs_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
    return codec_prefs_to_str(&endpoint->media.codec_prefs_incoming_offer, obj, args, buf);
}
 
static int outgoing_offer_codec_prefs_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
    return codec_prefs_to_str(&endpoint->media.codec_prefs_outgoing_offer, obj, args, buf);
}
 
static int incoming_answer_codec_prefs_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
    return codec_prefs_to_str(&endpoint->media.codec_prefs_incoming_answer, obj, args, buf);
}
 
static int outgoing_answer_codec_prefs_to_str(const void *obj, const intptr_t *args, char **buf)
{
    const struct ast_sip_endpoint *endpoint = obj;
    return codec_prefs_to_str(&endpoint->media.codec_prefs_outgoing_answer, obj, args, buf);
}
 
static void *sip_nat_hook_alloc(const char *name)
{
    return ast_sorcery_generic_alloc(sizeof(struct ast_sip_nat_hook), NULL);
}
 
/*! \brief Destructor function for persistent endpoint information */
static void persistent_endpoint_destroy(void *obj)
{
    struct sip_persistent_endpoint *persistent = obj;
 
    ast_endpoint_shutdown(persistent->endpoint);
}
 
static int add_to_regcontext(void *obj, void *arg, int flags)
{
    struct sip_persistent_endpoint *persistent = obj;
    const char *regcontext = arg;
 
    if (ast_endpoint_get_state(persistent->endpoint) == AST_ENDPOINT_ONLINE) {
        if (!ast_exists_extension(NULL, regcontext, ast_endpoint_get_resource(
                persistent->endpoint), 1, NULL)) {
            ast_add_extension(regcontext, 1, ast_endpoint_get_resource(persistent->endpoint), 1, NULL, NULL,
                "Noop", ast_strdup(ast_endpoint_get_resource(persistent->endpoint)), ast_free_ptr, "PJSIP");
        }
    }
 
    return 0;
}
 
int ast_sip_persistent_endpoint_add_to_regcontext(const char *regcontext)
{
    if (ast_strlen_zero(regcontext)) {
        return 0;
    }
 
    /* Make sure the regcontext exists */
    if (!ast_context_find_or_create(NULL, NULL, regcontext, "PJSIP")) {
        ast_log(LOG_ERROR, "Failed to create regcontext '%s'\n", regcontext);
        return -1;
    }
 
    /* Add any online endpoints */
    ao2_callback(persistent_endpoints, OBJ_NODATA, add_to_regcontext, (void *)regcontext);
    return 0;
}
 
int ast_sip_persistent_endpoint_update_state(const char *endpoint_name, enum ast_endpoint_state state)
{
    struct sip_persistent_endpoint *persistent;
    struct ast_json *blob;
    char *regcontext;
 
    persistent = ao2_find(persistent_endpoints, endpoint_name, OBJ_SEARCH_KEY);
    if (!persistent) {
        return -1;
    }
 
    /* If there was no state change, don't publish anything. */
    if (ast_endpoint_get_state(persistent->endpoint) == state) {
        ao2_ref(persistent, -1);
        return 0;
    }
 
    regcontext = ast_sip_get_regcontext();
 
    if (state == AST_ENDPOINT_ONLINE) {
        ast_endpoint_set_state(persistent->endpoint, AST_ENDPOINT_ONLINE);
        blob = ast_json_pack("{s: s}", "peer_status", "Reachable");
 
        if (!ast_strlen_zero(regcontext)) {
            if (!ast_exists_extension(NULL, regcontext, ast_endpoint_get_resource(persistent->endpoint), 1, NULL)) {
                ast_add_extension(regcontext, 1, ast_endpoint_get_resource(persistent->endpoint), 1, NULL, NULL,
                    "Noop", ast_strdup(ast_endpoint_get_resource(persistent->endpoint)), ast_free_ptr, "PJSIP");
            }
        }
 
        ast_verb(2, "Endpoint %s is now Reachable\n", ast_endpoint_get_resource(persistent->endpoint));
    } else {
        ast_endpoint_set_state(persistent->endpoint, AST_ENDPOINT_OFFLINE);
        blob = ast_json_pack("{s: s}", "peer_status", "Unreachable");
 
        if (!ast_strlen_zero(regcontext)) {
            struct pbx_find_info q = { .stacklen = 0 };
 
            if (pbx_find_extension(NULL, NULL, &q, regcontext, ast_endpoint_get_resource(persistent->endpoint), 1, NULL, "", E_MATCH)) {
                ast_context_remove_extension(regcontext, ast_endpoint_get_resource(persistent->endpoint), 1, NULL);
            }
        }
 
        ast_verb(2, "Endpoint %s is now Unreachable\n", ast_endpoint_get_resource(persistent->endpoint));
    }
 
    ast_free(regcontext);
 
    ast_endpoint_blob_publish(persistent->endpoint, ast_endpoint_state_type(), blob);
    ast_json_unref(blob);
    ast_devstate_changed(AST_DEVICE_UNKNOWN, AST_DEVSTATE_CACHABLE, "PJSIP/%s", ast_endpoint_get_resource(persistent->endpoint));
 
    ao2_ref(persistent, -1);
 
    return 0;
}
 
void ast_sip_persistent_endpoint_publish_contact_state(const char *endpoint_name, const struct ast_sip_contact_status *contact_status)
{
    struct sip_persistent_endpoint *persistent;
    struct ast_json *blob;
    char rtt[32];
 
    persistent = ao2_find(persistent_endpoints, endpoint_name, OBJ_SEARCH_KEY);
    if (!persistent) {
        return;
    }
 
    snprintf(rtt, sizeof(rtt), "%" PRId64, contact_status->rtt);
    blob = ast_json_pack("{s: s, s: s, s: s, s: s, s: s}",
        "contact_status", ast_sip_get_contact_status_label(contact_status->status),
        "aor", contact_status->aor,
        "uri", contact_status->uri,
        "roundtrip_usec", rtt,
        "endpoint_name", ast_endpoint_get_resource(persistent->endpoint));
    if (blob) {
        ast_endpoint_blob_publish(persistent->endpoint, ast_endpoint_contact_state_type(), blob);
        ast_json_unref(blob);
    }
 
    ao2_ref(persistent, -1);
}
 
/*! \brief Internal function which finds (or creates) persistent endpoint information */
static struct ast_endpoint *persistent_endpoint_find_or_create(const struct ast_sip_endpoint *endpoint)
{
    RAII_VAR(struct sip_persistent_endpoint *, persistent, NULL, ao2_cleanup);
    SCOPED_AO2LOCK(lock, persistent_endpoints);
 
    persistent = ao2_find(persistent_endpoints, ast_sorcery_object_get_id(endpoint),
        OBJ_SEARCH_KEY | OBJ_NOLOCK);
    if (!persistent) {
        persistent = ao2_alloc_options(sizeof(*persistent), persistent_endpoint_destroy,
            AO2_ALLOC_OPT_LOCK_NOLOCK);
        if (!persistent) {
            return NULL;
        }
 
        persistent->endpoint = ast_endpoint_create("PJSIP",
            ast_sorcery_object_get_id(endpoint));
        if (!persistent->endpoint) {
            return NULL;
        }
 
        ast_endpoint_set_state(persistent->endpoint, AST_ENDPOINT_OFFLINE);
 
        ao2_link_flags(persistent_endpoints, persistent, OBJ_NOLOCK);
    }
 
    ao2_ref(persistent->endpoint, +1);
    return persistent->endpoint;
}
 
/*! \brief Callback function for when an object is finalized */
static int sip_endpoint_apply_handler(const struct ast_sorcery *sorcery, void *obj)
{
    struct ast_sip_endpoint *endpoint = obj;
 
    if (!(endpoint->persistent = persistent_endpoint_find_or_create(endpoint))) {
        return -1;
    }
 
    if (endpoint->extensions.timer.min_se < 90) {
        ast_log(LOG_ERROR, "Session timer minimum expires time must be 90 or greater on endpoint '%s'\n",
            ast_sorcery_object_get_id(endpoint));
        return -1;
    } else if (endpoint->extensions.timer.sess_expires < endpoint->extensions.timer.min_se) {
        ast_log(LOG_ERROR, "Session timer expires must be greater than minimum session expires time on endpoint '%s'\n",
            ast_sorcery_object_get_id(endpoint));
        return -1;
    }
 
    if (ast_strlen_zero(endpoint->media.sdpsession) || !*ast_skip_blanks(endpoint->media.sdpsession)) {
        ast_log(LOG_WARNING, "SDP session was set to empty on endpoint '%s'. Not permitted as per RFC8866. SDP session set to '-'. \n",
            ast_sorcery_object_get_id(endpoint));
        ast_string_field_set(endpoint, media.sdpsession, "-");
    }
 
    if (ast_strlen_zero(endpoint->media.sdpowner) || *ast_skip_nonblanks(ast_skip_blanks(endpoint->media.sdpowner))) {
        ast_log(LOG_WARNING, "SDP origin username on endpoint '%s' is empty or contains spaces ('%s'). Not permitted as per RFC8866. Setting to '-'.\n",
            ast_sorcery_object_get_id(endpoint), endpoint->media.sdpowner);
        ast_string_field_set(endpoint, media.sdpowner, "-");
    }
 
    if (ast_rtp_dtls_cfg_validate(&endpoint->media.rtp.dtls_cfg)) {
        return -1;
    }
 
    if (endpoint->media.rtp.port_start || endpoint->media.rtp.port_end) {
        if (!endpoint->media.rtp.port_start || !endpoint->media.rtp.port_end) {
            ast_log(LOG_ERROR, "Endpoint '%s': Both rtp_port_start and rtp_port_end must be set together\n",
                ast_sorcery_object_get_id(endpoint));
            return -1;
        }
        if (endpoint->media.rtp.port_start < 1024 || endpoint->media.rtp.port_end < 1024) {
            ast_log(LOG_ERROR, "Endpoint '%s': rtp_port_start and rtp_port_end must be at least 1024\n",
                ast_sorcery_object_get_id(endpoint));
            return -1;
        }
        if (endpoint->media.rtp.port_end <= endpoint->media.rtp.port_start) {
            ast_log(LOG_ERROR, "Endpoint '%s': rtp_port_end (%u) must be greater than rtp_port_start (%u)\n",
                ast_sorcery_object_get_id(endpoint),
                endpoint->media.rtp.port_end,
                endpoint->media.rtp.port_start);
            return -1;
        }
        ast_debug(1, "Endpoint '%s': Using per-endpoint RTP port range %u-%u\n",
            ast_sorcery_object_get_id(endpoint),
            endpoint->media.rtp.port_start,
            endpoint->media.rtp.port_end);
    }
 
    if (endpoint->preferred_codec_only) {
        if (endpoint->media.incoming_call_offer_pref.flags != (AST_SIP_CALL_CODEC_PREF_LOCAL | AST_SIP_CALL_CODEC_PREF_INTERSECT | AST_SIP_CALL_CODEC_PREF_ALL)) {
            ast_log(LOG_ERROR, "Setting both preferred_codec_only and incoming_call_offer_pref is not supported on endpoint '%s'\n",
                ast_sorcery_object_get_id(endpoint));
            return -1;
        }
        ast_clear_flag(&endpoint->media.incoming_call_offer_pref, AST_SIP_CALL_CODEC_PREF_ALL);
        ast_set_flag(&endpoint->media.incoming_call_offer_pref, AST_SIP_CALL_CODEC_PREF_FIRST);
    }
 
    endpoint->media.topology = ast_stream_topology_create_from_format_cap(endpoint->media.codecs);
    if (!endpoint->media.topology) {
        return -1;
    }
 
    endpoint->media.rtcp_mux |= endpoint->media.bundle;
 
    /*
     * If webrtc has been enabled then enable those attributes, and default
     * some, that are needed in order for webrtc to work.
     */
    endpoint->media.bundle |= endpoint->media.webrtc;
    endpoint->media.rtcp_mux |= endpoint->media.webrtc;
    endpoint->media.rtp.use_avpf |= endpoint->media.webrtc;
    endpoint->media.rtp.ice_support |= endpoint->media.webrtc;
    endpoint->media.rtp.use_received_transport |= endpoint->media.webrtc;
 
    if (endpoint->media.webrtc) {
        endpoint->media.rtp.encryption = AST_SIP_MEDIA_ENCRYPT_DTLS;
        endpoint->media.rtp.dtls_cfg.enabled = 1;
        endpoint->media.rtp.dtls_cfg.default_setup = AST_RTP_DTLS_SETUP_ACTPASS;
        endpoint->media.rtp.dtls_cfg.verify = AST_RTP_DTLS_VERIFY_FINGERPRINT;
 
        /* RFC8827 says: Implementations MUST NOT implement DTLS renegotiation
         * and MUST reject it with a "no_renegotiation" alert if offered. */
        if (endpoint->media.rtp.dtls_cfg.rekey) {
            ast_log(LOG_WARNING, "DTLS renegotiation is not supported with WebRTC. Disabling dtls_rekey.\n");
            endpoint->media.rtp.dtls_cfg.rekey = 0;
        }
 
        if (ast_strlen_zero(endpoint->media.rtp.dtls_cfg.certfile)) {
            /* If no certificate has been specified, try to automatically create one */
            endpoint->media.rtp.dtls_cfg.ephemeral_cert = 1;
        }
    }
 
    if (!ast_strlen_zero(endpoint->geoloc_incoming_call_profile) ||
        !ast_strlen_zero(endpoint->geoloc_outgoing_call_profile)) {
 
        if (!ast_geoloc_is_loaded()) {
            ast_log(LOG_ERROR, "A geoloc incoming and/or outgoing call_profile was specified on endpoint '%s'"
                " but res_geolocation is not loaded.\n", ast_sorcery_object_get_id(endpoint));
            return -1;
        }
 
        if (!ast_strlen_zero(endpoint->geoloc_incoming_call_profile)) {
            struct ast_geoloc_profile *profile = ast_geoloc_get_profile(endpoint->geoloc_incoming_call_profile);
            if (!profile) {
                ast_log(LOG_ERROR, "geoloc_incoming_call_profile '%s' on endpoint '%s' doesn't exist\n",
                    endpoint->geoloc_incoming_call_profile, ast_sorcery_object_get_id(endpoint));
                return -1;
            }
            ao2_cleanup(profile);
        }
 
        if (!ast_strlen_zero(endpoint->geoloc_outgoing_call_profile)) {
            struct ast_geoloc_profile *profile = ast_geoloc_get_profile(endpoint->geoloc_outgoing_call_profile);
            if (!profile) {
                ast_log(LOG_ERROR, "geoloc_outgoing_call_profile '%s' on endpoint '%s' doesn't exist\n",
                    endpoint->geoloc_outgoing_call_profile, ast_sorcery_object_get_id(endpoint));
                return -1;
            }
            ao2_cleanup(profile);
        }
    }
 
    return 0;
}
 
const char *ast_sip_get_device_state(const struct ast_sip_endpoint *endpoint)
{
    char device[MAX_OBJECT_FIELD];
 
    snprintf(device, MAX_OBJECT_FIELD, "PJSIP/%s", ast_sorcery_object_get_id(endpoint));
    return ast_devstate2str(ast_device_state(device));
}
 
struct ast_endpoint_snapshot *ast_sip_get_endpoint_snapshot(
    const struct ast_sip_endpoint *endpoint)
{
    return ast_endpoint_latest_snapshot(
        ast_endpoint_get_tech(endpoint->persistent),
        ast_endpoint_get_resource(endpoint->persistent));
}
 
int ast_sip_for_each_channel_snapshot(
    const struct ast_endpoint_snapshot *endpoint_snapshot,
    ao2_callback_fn on_channel_snapshot, void *arg)
{
    int num, num_channels = endpoint_snapshot->num_channels;
 
    if (!on_channel_snapshot || !num_channels) {
        return 0;
    }
 
    for (num = 0; num < num_channels; ++num) {
        RAII_VAR(struct ast_channel_snapshot *, snapshot, NULL, ao2_cleanup);
        int res;
 
        snapshot = ast_channel_snapshot_get_latest(endpoint_snapshot->channel_ids[num]);
        if (!snapshot) {
            continue;
        }
 
        res = on_channel_snapshot(snapshot, arg, 0);
        if (res) {
            return -1;
        }
    }
    return 0;
}
 
int ast_sip_for_each_channel(
    const struct ast_sip_endpoint *endpoint,
    ao2_callback_fn on_channel_snapshot, void *arg)
{
    RAII_VAR(struct ast_endpoint_snapshot *, endpoint_snapshot, ast_sip_get_endpoint_snapshot(endpoint), ao2_cleanup);
    return ast_sip_for_each_channel_snapshot(endpoint_snapshot, on_channel_snapshot, arg);
}
 
static void active_channels_to_str(const struct ast_sip_endpoint *endpoint,
                   struct ast_str **str)
{
 
    RAII_VAR(struct ast_endpoint_snapshot *, endpoint_snapshot,
         ast_sip_get_endpoint_snapshot(endpoint), ao2_cleanup);
 
    ast_str_append(str, 0, "%d",
        endpoint_snapshot ? endpoint_snapshot->num_channels : 0);
}
 
#define AMI_DEFAULT_STR_SIZE 512
 
struct ast_str *ast_sip_create_ami_event(const char *event, struct ast_sip_ami *ami)
{
    struct ast_str *buf = ast_str_create(AMI_DEFAULT_STR_SIZE);
 
    if (!(buf)) {
        astman_send_error_va(ami->s, ami->m, "Unable create event "
                     "for %s\n", event);
        return NULL;
    }
 
    ast_str_set(&buf, 0, "Event: %s\r\n", event);
    if (!ast_strlen_zero(ami->action_id)) {
        ast_str_append(&buf, 0, "ActionID: %s\r\n", ami->action_id);
    }
    return buf;
}
 
static void sip_sorcery_object_ami_set_type_name(const void *obj, struct ast_str **buf)
{
    ast_str_append(buf, 0, "ObjectType: %s\r\n",
               ast_sorcery_object_get_type(obj));
    ast_str_append(buf, 0, "ObjectName: %s\r\n",
               ast_sorcery_object_get_id(obj));
}
 
int ast_sip_sorcery_object_to_ami(const void *obj, struct ast_str **buf)
{
    RAII_VAR(struct ast_variable *, objset, ast_sorcery_objectset_create2(
             ast_sip_get_sorcery(), obj, AST_HANDLER_ONLY_STRING), ast_variables_destroy);
    struct ast_variable *i;
 
    if (!objset) {
        return -1;
    }
 
    sip_sorcery_object_ami_set_type_name(obj, buf);
 
    for (i = objset; i; i = i->next) {
        RAII_VAR(char *, camel, ast_to_camel_case(i->name), ast_free);
        ast_str_append(buf, 0, "%s: %s\r\n", camel, i->value);
    }
 
    return 0;
}
 
static int sip_endpoints_aors_ami(void *obj, void *arg, int flags)
{
    struct ast_sip_aor *aor = obj;
    struct ast_str **buf = arg;
 
    ast_str_append(buf, 0, "Contacts: ");
    ast_sip_for_each_contact(aor, ast_sip_contact_to_str, arg);
    ast_str_append(buf, 0, "\r\n");
 
    return 0;
}
 
static int sip_endpoint_to_ami(const struct ast_sip_endpoint *endpoint,
                   struct ast_str **buf)
{
    if (ast_sip_sorcery_object_to_ami(endpoint, buf)) {
        return -1;
    }
 
    ast_str_append(buf, 0, "DeviceState: %s\r\n",
               ast_sip_get_device_state(endpoint));
 
    ast_str_append(buf, 0, "ActiveChannels: ");
    active_channels_to_str(endpoint, buf);
    ast_str_append(buf, 0, "\r\n");
 
    return 0;
}
 
static int format_ami_endpoint(const struct ast_sip_endpoint *endpoint,
                   struct ast_sip_ami *ami)
{
    RAII_VAR(struct ast_str *, buf,
         ast_sip_create_ami_event("EndpointDetail", ami), ast_free);
 
    if (!buf) {
        return -1;
    }
 
    sip_endpoint_to_ami(endpoint, &buf);
    astman_append(ami->s, "%s\r\n", ast_str_buffer(buf));
    return 0;
}
 
#define AMI_SHOW_ENDPOINTS "PJSIPShowEndpoints"
#define AMI_SHOW_ENDPOINT "PJSIPShowEndpoint"
 
static int ami_show_endpoint(struct mansession *s, const struct message *m)
{
    struct ast_sip_ami ami = { .s = s, .m = m, .action_id = astman_get_header(m, "ActionID"),
        .count = 0, };
    RAII_VAR(struct ast_sip_endpoint *, endpoint, NULL, ao2_cleanup);
    const char *endpoint_name = astman_get_header(m, "Endpoint");
    int count = 0;
 
    if (ast_strlen_zero(endpoint_name)) {
        astman_send_error_va(s, m, "%s requires an endpoint name\n",
            AMI_SHOW_ENDPOINT);
        return 0;
    }
 
    if (!strncasecmp(endpoint_name, "pjsip/", 6)) {
        endpoint_name += 6;
    }
 
    if (!(endpoint = ast_sorcery_retrieve_by_id(
              ast_sip_get_sorcery(), "endpoint", endpoint_name))) {
        astman_send_error_va(s, m, "Unable to retrieve endpoint %s\n",
            endpoint_name);
        return 0;
    }
 
    astman_send_listack(s, m, "Following are Events for each object associated with the Endpoint",
        "start");
 
    /* the endpoint detail needs to always come first so apply as such */
    if (format_ami_endpoint(endpoint, &ami) ||
        ast_sip_format_endpoint_ami(endpoint, &ami, &count)) {
        astman_send_error_va(s, m, "Unable to format endpoint %s\n",
            endpoint_name);
    }
 
    astman_send_list_complete_start(s, m, "EndpointDetailComplete", ami.count + 1);
    astman_send_list_complete_end(s);
 
    return 0;
}
 
static int format_str_append_auth(const struct ast_sip_auth_vector *auths,
                  struct ast_str **buf)
{
    char *str = NULL;
    if (ast_sip_auths_to_str(auths, &str)) {
        return -1;
    }
    ast_str_append(buf, 0, "%s", str ? str : "");
    ast_free(str);
    return 0;
}
 
static int format_ami_endpoints(void *obj, void *arg, int flags)
{
 
    struct ast_sip_endpoint *endpoint = obj;
    struct ast_sip_ami *ami = arg;
    RAII_VAR(struct ast_str *, buf,
         ast_sip_create_ami_event("EndpointList", ami), ast_free);
 
    if (!buf) {
        return CMP_STOP;
    }
 
    sip_sorcery_object_ami_set_type_name(endpoint, &buf);
    ast_str_append(&buf, 0, "Transport: %s\r\n",
               endpoint->transport);
    ast_str_append(&buf, 0, "Aor: %s\r\n",
               endpoint->aors);
 
    ast_str_append(&buf, 0, "Auths: ");
    format_str_append_auth(&endpoint->inbound_auths, &buf);
    ast_str_append(&buf, 0, "\r\n");
 
    ast_str_append(&buf, 0, "OutboundAuths: ");
    format_str_append_auth(&endpoint->outbound_auths, &buf);
    ast_str_append(&buf, 0, "\r\n");
 
    ast_sip_for_each_aor(endpoint->aors,
                 sip_endpoints_aors_ami, &buf);
 
    ast_str_append(&buf, 0, "DeviceState: %s\r\n",
               ast_sip_get_device_state(endpoint));
 
    ast_str_append(&buf, 0, "ActiveChannels: ");
    active_channels_to_str(endpoint, &buf);
    ast_str_append(&buf, 0, "\r\n");
 
    astman_append(ami->s, "%s\r\n", ast_str_buffer(buf));
    return 0;
}
 
static int ami_show_endpoints(struct mansession *s, const struct message *m)
{
    struct ast_sip_ami ami = { .s = s, .m = m, .action_id = astman_get_header(m, "ActionID"), };
    RAII_VAR(struct ao2_container *, endpoints, NULL, ao2_cleanup);
    int num;
 
    endpoints = ast_sip_get_endpoints();
    if (!endpoints) {
        astman_send_error(s, m, "Could not get endpoints\n");
        return 0;
    }
 
    if (!(num = ao2_container_count(endpoints))) {
        astman_send_error(s, m, "No endpoints found\n");
        return 0;
    }
 
    astman_send_listack(s, m, "A listing of Endpoints follows, presented as EndpointList events",
        "start");
 
    ao2_callback(endpoints, OBJ_NODATA, format_ami_endpoints, &ami);
 
    astman_send_list_complete_start(s, m, "EndpointListComplete", num);
    astman_send_list_complete_end(s);
    return 0;
}
 
static struct ao2_container *cli_endpoint_get_container(const char *regex)
{
    RAII_VAR(struct ao2_container *, container, NULL, ao2_cleanup);
    struct ao2_container *s_container;
 
    container = ast_sorcery_retrieve_by_regex(sip_sorcery, "endpoint", regex);
    if (!container) {
        return NULL;
    }
 
    s_container = ao2_container_alloc_list(AO2_ALLOC_OPT_LOCK_NOLOCK, 0,
        (void *)ast_sorcery_object_id_sort, (void *)ast_sorcery_object_id_compare);
    if (!s_container) {
        return NULL;
    }
 
    if (ao2_container_dup(s_container, container, 0)) {
        ao2_ref(s_container, -1);
        return NULL;
    }
 
    return s_container;
}
 
static int cli_endpoint_iterate(void *obj, ao2_callback_fn callback, void *args)
{
    ao2_callback(obj, OBJ_NODATA, callback, args);
 
    return 0;
}
 
static void *cli_endpoint_retrieve_by_id(const char *id)
{
    return ast_sorcery_retrieve_by_id(ast_sip_get_sorcery(), "endpoint", id);
}
 
static void cli_endpoint_print_child_header(char *type, struct ast_sip_cli_context *context)
{
    RAII_VAR(struct ast_sip_cli_formatter_entry *, formatter_entry, NULL, ao2_cleanup);
 
    formatter_entry = ast_sip_lookup_cli_formatter(type);
    if (formatter_entry) {
        formatter_entry->print_header(NULL, context, 0);
    }
}
 
static int cli_endpoint_print_header(void *obj, void *arg, int flags)
{
    struct ast_sip_cli_context *context = arg;
 
    ast_assert(context->output_buffer != NULL);
 
    ast_str_append(&context->output_buffer, 0,
            " Endpoint:  <Endpoint/CID.....................................>  <State.....>  <Channels.>\n");
 
    if (context->recurse) {
        context->indent_level++;
        cli_endpoint_print_child_header("auth", context);
        cli_endpoint_print_child_header("aor", context);
        cli_endpoint_print_child_header("transport", context);
        cli_endpoint_print_child_header("identify", context);
        cli_endpoint_print_child_header("channel", context);
        context->indent_level--;
    }
 
    return 0;
}
 
static void cli_endpoint_print_child_body(char *type, const void *obj, struct ast_sip_cli_context *context)
{
    RAII_VAR(struct ast_sip_cli_formatter_entry *, formatter_entry, NULL, ao2_cleanup);
 
    formatter_entry = ast_sip_lookup_cli_formatter(type);
    if (formatter_entry) {
        formatter_entry->iterate((void *)obj, formatter_entry->print_body, context);
    }
}
 
static int cli_endpoint_print_body(void *obj, void *arg, int flags)
{
    struct ast_sip_endpoint *endpoint = obj;
    RAII_VAR(struct ast_endpoint_snapshot *, endpoint_snapshot, ast_sip_get_endpoint_snapshot(endpoint), ao2_cleanup);
    struct ast_sip_cli_context *context = arg;
    const char *id = ast_sorcery_object_get_id(endpoint);
    char *print_name = NULL;
    int print_name_len;
    char *number = S_COR(endpoint->id.self.number.valid,
        endpoint->id.self.number.str, NULL);
    int indent;
    int flexwidth;
 
    ast_assert(context->output_buffer != NULL);
 
    if (number) {
        print_name_len = strlen(id) + strlen(number) + 2;
        print_name = ast_alloca(print_name_len);
        snprintf(print_name, print_name_len, "%s/%s", id, number);
    }
 
    indent = CLI_INDENT_TO_SPACES(context->indent_level);
    flexwidth = CLI_LAST_TABSTOP - indent - 2;
 
    ast_str_append(&context->output_buffer, 0, "%*s:  %-*.*s  %-12.12s  %d of %.0f\n",
        indent, "Endpoint",
        flexwidth, flexwidth, print_name ? print_name : id,
        ast_sip_get_device_state(endpoint),
        endpoint_snapshot->num_channels,
        (double) endpoint->devicestate_busy_at ? endpoint->devicestate_busy_at :
                                                        INFINITY
                                                        );
 
    if (context->recurse) {
        context->indent_level++;
 
        context->auth_direction = "Out";
        cli_endpoint_print_child_body("auth", &endpoint->outbound_auths, context);
        context->auth_direction = "In";
        cli_endpoint_print_child_body("auth", &endpoint->inbound_auths, context);
 
        cli_endpoint_print_child_body("aor", endpoint->aors, context);
        cli_endpoint_print_child_body("transport", endpoint, context);
        cli_endpoint_print_child_body("identify", endpoint, context);
        cli_endpoint_print_child_body("channel", endpoint, context);
 
        context->indent_level--;
 
        if (context->indent_level == 0) {
            ast_str_append(&context->output_buffer, 0, "\n");
        }
    }
 
    if (context->show_details || (context->show_details_only_level_0 && context->indent_level == 0)) {
        ast_str_append(&context->output_buffer, 0, "\n");
        ast_sip_cli_print_sorcery_objectset(endpoint, context, 0);
    }
 
    return 0;
}
 
static struct ast_cli_entry cli_commands[] = {
    AST_CLI_DEFINE(ast_sip_cli_traverse_objects, "List PJSIP Endpoints",
        .command = "pjsip list endpoints",
        .usage = "Usage: pjsip list endpoints [ like <pattern> ]\n"
                "       List the configured PJSIP endpoints\n"
                "       Optional regular expression pattern is used to filter the list.\n"),
    AST_CLI_DEFINE(ast_sip_cli_traverse_objects, "Show PJSIP Endpoints",
        .command = "pjsip show endpoints",
        .usage = "Usage: pjsip show endpoints [ like <pattern> ]\n"
                "       List(detailed) the configured PJSIP endpoints\n"
                "       Optional regular expression pattern is used to filter the list.\n"),
    AST_CLI_DEFINE(ast_sip_cli_traverse_objects, "Show PJSIP Endpoint",
        .command = "pjsip show endpoint",
        .usage = "Usage: pjsip show endpoint <id>\n"
                 "       Show the configured PJSIP endpoint\n"),
};
 
struct ast_sip_cli_formatter_entry *channel_formatter;
struct ast_sip_cli_formatter_entry *endpoint_formatter;
 
static void load_all_endpoints(void)
{
    struct ao2_container *endpoints;
 
    endpoints = ast_sorcery_retrieve_by_fields(sip_sorcery, "endpoint", AST_RETRIEVE_FLAG_MULTIPLE | AST_RETRIEVE_FLAG_ALL, NULL);
    ao2_cleanup(endpoints);
}
 
static void acl_change_stasis_cb(void *data, struct stasis_subscription *sub,
    struct stasis_message *message)
{
    if (stasis_message_type(message) != ast_named_acl_change_type()) {
        return;
    }
 
    ast_sorcery_force_reload_object(sip_sorcery, "endpoint");
}
 
int ast_res_pjsip_initialize_configuration(void)
{
    if (ast_manager_register_xml(AMI_SHOW_ENDPOINTS, EVENT_FLAG_SYSTEM, ami_show_endpoints) ||
        ast_manager_register_xml(AMI_SHOW_ENDPOINT, EVENT_FLAG_SYSTEM, ami_show_endpoint)) {
        return -1;
    }
 
    persistent_endpoints = ao2_container_alloc_hash(AO2_ALLOC_OPT_LOCK_MUTEX, 0,
        PERSISTENT_BUCKETS, persistent_endpoint_hash, NULL, persistent_endpoint_cmp);
    if (!persistent_endpoints) {
        return -1;
    }
 
    if (!(sip_sorcery = ast_sorcery_open())) {
        ast_log(LOG_ERROR, "Failed to open SIP sorcery failed to open\n");
        return -1;
    }
 
    ast_sip_initialize_cli();
 
    if (ast_sip_initialize_sorcery_auth()) {
        ast_log(LOG_ERROR, "Failed to register SIP authentication support\n");
        ast_sorcery_unref(sip_sorcery);
        sip_sorcery = NULL;
        return -1;
    }
 
    ast_sorcery_apply_default(sip_sorcery, "endpoint", "config", "pjsip.conf,criteria=type=endpoint");
    ast_sorcery_apply_default(sip_sorcery, "nat_hook", "memory", NULL);
 
    if (ast_sorcery_object_register(sip_sorcery, "endpoint", ast_sip_endpoint_alloc, NULL, sip_endpoint_apply_handler)) {
        ast_log(LOG_ERROR, "Failed to register SIP endpoint object with sorcery\n");
        ast_sorcery_unref(sip_sorcery);
        sip_sorcery = NULL;
        return -1;
    }
 
    if (ast_sorcery_internal_object_register(sip_sorcery, "nat_hook", sip_nat_hook_alloc, NULL, NULL)) {
        ast_log(LOG_ERROR, "Failed to register nat_hook\n");
    }
 
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "type", "", OPT_NOOP_T, 0, 0);
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "context", "default", OPT_STRINGFIELD_T, 0, STRFLDSET(struct ast_sip_endpoint, context));
    ast_sorcery_object_field_register_alias(sip_sorcery, "endpoint", "disallow", "", OPT_CODEC_T, 0, FLDSET(struct ast_sip_endpoint, media.codecs));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "allow", "", OPT_CODEC_T, 1, FLDSET(struct ast_sip_endpoint, media.codecs));
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "dtmf_mode", "rfc4733", dtmf_handler, dtmf_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "rtp_ipv6", "no", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, media.rtp.ipv6));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "rtp_symmetric", "no", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, media.rtp.symmetric));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "ice_support", "no", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, media.rtp.ice_support));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "use_ptime", "no", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, media.rtp.use_ptime));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "force_rport", "yes", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, nat.force_rport));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "rewrite_contact", "no", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, nat.rewrite_contact));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "transport", "", OPT_STRINGFIELD_T, 0, STRFLDSET(struct ast_sip_endpoint, transport));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "outbound_proxy", "", OPT_STRINGFIELD_T, 0, STRFLDSET(struct ast_sip_endpoint, outbound_proxy));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "moh_suggest", "default", OPT_STRINGFIELD_T, 0, STRFLDSET(struct ast_sip_endpoint, mohsuggest));
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "100rel", "yes", prack_handler, prack_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "timers", "yes", timers_handler, timers_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "timers_min_se", "90", OPT_UINT_T, 0, FLDSET(struct ast_sip_endpoint, extensions.timer.min_se));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "timers_sess_expires", "1800", OPT_UINT_T, 0, FLDSET(struct ast_sip_endpoint, extensions.timer.sess_expires));
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "auth", "", inbound_auth_handler, inbound_auths_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "outbound_auth", "", outbound_auth_handler, outbound_auths_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "aors", "", OPT_STRINGFIELD_T, 0, STRFLDSET(struct ast_sip_endpoint, aors));
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "media_address", "", media_address_handler, media_address_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "bind_rtp_to_media_address", "no", OPT_BOOL_T, 1, STRFLDSET(struct ast_sip_endpoint, media.bind_rtp_to_media_address));
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "identify_by", "username,ip", ident_handler, ident_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "direct_media", "yes", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, media.direct_media.enabled));
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "direct_media_method", "invite", direct_media_method_handler, direct_media_method_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "trust_connected_line", "yes", OPT_YESNO_T, 1, FLDSET(struct ast_sip_endpoint, id.trust_connected_line));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "send_connected_line", "yes", OPT_YESNO_T, 1, FLDSET(struct ast_sip_endpoint, id.send_connected_line));
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "connected_line_method", "invite", connected_line_method_handler, connected_line_method_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "direct_media_glare_mitigation", "none", direct_media_glare_mitigation_handler, direct_media_glare_mitigation_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "disable_direct_media_on_nat", "no", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, media.direct_media.disable_on_nat));
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "callerid", "", caller_id_handler, caller_id_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "callerid_privacy", "allowed_not_screened", caller_id_privacy_handler, caller_id_privacy_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "callerid_tag", "", caller_id_tag_handler, caller_id_tag_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "trust_id_inbound", "no", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, id.trust_inbound));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "trust_id_outbound", "no", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, id.trust_outbound));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "send_pai", "no", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, id.send_pai));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "send_rpid", "no", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, id.send_rpid));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "rpid_immediate", "no", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, id.rpid_immediate));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "send_diversion", "yes", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, id.send_diversion));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "send_history_info", "no", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, id.send_history_info));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "mailboxes", "", OPT_STRINGFIELD_T, 0, STRFLDSET(struct ast_sip_endpoint, subscription.mwi.mailboxes));
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "voicemail_extension", "", voicemail_extension_handler, voicemail_extension_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "aggregate_mwi", "yes", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, subscription.mwi.aggregate));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "mwi_subscribe_replaces_unsolicited", "no", OPT_YESNO_T, 1, FLDSET(struct ast_sip_endpoint, subscription.mwi.subscribe_replaces_unsolicited));
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "media_encryption", "no", media_encryption_handler, media_encryption_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "use_avpf", "no", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, media.rtp.use_avpf));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "force_avp", "no", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, media.rtp.force_avp));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "media_use_received_transport", "no", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, media.rtp.use_received_transport));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "rtp_keepalive", "0", OPT_UINT_T, 0, FLDSET(struct ast_sip_endpoint, media.rtp.keepalive));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "rtp_timeout", "0", OPT_UINT_T, 0, FLDSET(struct ast_sip_endpoint, media.rtp.timeout));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "rtp_timeout_hold", "0", OPT_UINT_T, 0, FLDSET(struct ast_sip_endpoint, media.rtp.timeout_hold));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "rtp_port_start", "0", OPT_UINT_T, PARSE_IN_RANGE, FLDSET(struct ast_sip_endpoint, media.rtp.port_start), 0, 65535);
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "rtp_port_end", "0", OPT_UINT_T, PARSE_IN_RANGE, FLDSET(struct ast_sip_endpoint, media.rtp.port_end), 0, 65535);
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "one_touch_recording", "no", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, info.recording.enabled));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "inband_progress", "no", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, inband_progress));
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "call_group", "", group_handler, callgroup_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "pickup_group", "", group_handler, pickupgroup_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "named_call_group", "", named_groups_handler, named_callgroups_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "named_pickup_group", "", named_groups_handler, named_pickupgroups_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "device_state_busy_at", "0", OPT_UINT_T, 0, FLDSET(struct ast_sip_endpoint, devicestate_busy_at));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "t38_udptl", "no", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, media.t38.enabled));
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "t38_udptl_ec", "none", t38udptl_ec_handler, t38udptl_ec_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "t38_udptl_maxdatagram", "0", OPT_UINT_T, 0, FLDSET(struct ast_sip_endpoint, media.t38.maxdatagram));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "fax_detect", "no", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, faxdetect));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "fax_detect_timeout", "0", OPT_UINT_T, 0, FLDSET(struct ast_sip_endpoint, faxdetect_timeout));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "t38_udptl_nat", "no", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, media.t38.nat));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "t38_udptl_ipv6", "no", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, media.t38.ipv6));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "t38_bind_udptl_to_media_address", "no", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, media.t38.bind_udptl_to_media_address));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "tone_zone", "", OPT_STRINGFIELD_T, 0, STRFLDSET(struct ast_sip_endpoint, zone));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "language", "", OPT_STRINGFIELD_T, 0, STRFLDSET(struct ast_sip_endpoint, language));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "record_on_feature", "automixmon", OPT_STRINGFIELD_T, 0, STRFLDSET(struct ast_sip_endpoint, info.recording.onfeature));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "record_off_feature", "automixmon", OPT_STRINGFIELD_T, 0, STRFLDSET(struct ast_sip_endpoint, info.recording.offfeature));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "allow_transfer", "yes", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, allowtransfer));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "user_eq_phone", "no", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, usereqphone));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "moh_passthrough", "no", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, moh_passthrough));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "sdp_owner", "-", OPT_STRINGFIELD_T, 0, STRFLDSET(struct ast_sip_endpoint, media.sdpowner));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "sdp_session", "Asterisk", OPT_STRINGFIELD_T, 0, STRFLDSET(struct ast_sip_endpoint, media.sdpsession));
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "tos_audio", "0", tos_handler, tos_audio_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "tos_video", "0", tos_handler, tos_video_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "cos_audio", "0", OPT_UINT_T, 0, FLDSET(struct ast_sip_endpoint, media.cos_audio));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "cos_video", "0", OPT_UINT_T, 0, FLDSET(struct ast_sip_endpoint, media.cos_video));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "allow_subscribe", "yes", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, subscription.allow));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "sub_min_expiry", "0", OPT_UINT_T, 0, FLDSET(struct ast_sip_endpoint, subscription.minexpiry));
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "from_user", "", from_user_handler, from_user_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "from_domain", "", OPT_STRINGFIELD_T, 0, STRFLDSET(struct ast_sip_endpoint, fromdomain));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "mwi_from_user", "", OPT_STRINGFIELD_T, 0, STRFLDSET(struct ast_sip_endpoint, subscription.mwi.fromuser));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "rtp_engine", "asterisk", OPT_STRINGFIELD_T, 0, STRFLDSET(struct ast_sip_endpoint, media.rtp.engine));
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "dtls_verify", "no", dtls_handler, dtlsverify_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "dtls_rekey", "0", dtls_handler, dtlsrekey_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "dtls_auto_generate_cert", "no", dtls_handler, dtlsautogeneratecert_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "dtls_cert_file", "", dtls_handler, dtlscertfile_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "dtls_private_key", "", dtls_handler, dtlsprivatekey_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "dtls_cipher", "", dtls_handler, dtlscipher_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "dtls_ca_file", "", dtls_handler, dtlscafile_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "dtls_ca_path", "", dtls_handler, dtlscapath_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "dtls_setup", "", dtls_handler, dtlssetup_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "dtls_fingerprint", "", dtls_handler, dtlsfingerprint_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "srtp_tag_32", "no", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, media.rtp.srtp_tag_32));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "media_encryption_optimistic", "no", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, media.rtp.encryption_optimistic));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "g726_non_standard", "no", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, media.g726_non_standard));
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "redirect_method", "user", redirect_method_handler, redirect_method_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "follow_redirect_methods", "", follow_redirect_methods_handler, follow_redirect_methods_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "set_var", "", set_var_handler, set_var_to_str, set_var_to_vl, 0, 0);
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "message_context", "", OPT_STRINGFIELD_T, 0, STRFLDSET(struct ast_sip_endpoint, message_context));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "accountcode", "", OPT_STRINGFIELD_T, 0, STRFLDSET(struct ast_sip_endpoint, accountcode));
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "deny", "", endpoint_acl_handler, NULL, NULL, 0, 0);
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "permit", "", endpoint_acl_handler, NULL, NULL, 0, 0);
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "acl", "", endpoint_acl_handler, acl_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "contact_deny", "", endpoint_acl_handler, NULL, NULL, 0, 0);
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "contact_permit", "", endpoint_acl_handler, NULL, NULL, 0, 0);
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "contact_acl", "", endpoint_acl_handler, contact_acl_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "subscribe_context", "", OPT_CHAR_ARRAY_T, 0, CHARFLDSET(struct ast_sip_endpoint, subscription.context));
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "contact_user", "", contact_user_handler, contact_user_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "preferred_codec_only", "no", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, preferred_codec_only));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "asymmetric_rtp_codec", "no", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, asymmetric_rtp_codec));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "rtcp_mux", "no", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, media.rtcp_mux));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "allow_overlap", "yes", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, allow_overlap));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "overlap_context", "", OPT_STRINGFIELD_T, 0, STRFLDSET(struct ast_sip_endpoint, overlap_context));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "refer_blind_progress", "yes", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, refer_blind_progress));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "notify_early_inuse_ringing", "no", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, notify_early_inuse_ringing));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "max_audio_streams", "1", OPT_UINT_T, 0, FLDSET(struct ast_sip_endpoint, media.max_audio_streams));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "max_video_streams", "1", OPT_UINT_T, 0, FLDSET(struct ast_sip_endpoint, media.max_video_streams));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "bundle", "no", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, media.bundle));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "webrtc", "no", OPT_YESNO_T, 1, FLDSET(struct ast_sip_endpoint, media.webrtc));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "incoming_mwi_mailbox", "", OPT_STRINGFIELD_T, 0, STRFLDSET(struct ast_sip_endpoint, incoming_mwi_mailbox));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "follow_early_media_fork", "yes", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, media.rtp.follow_early_media_fork));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "accept_multiple_sdp_answers", "no", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, media.rtp.accept_multiple_sdp_answers));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "suppress_q850_reason_headers", "no", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, suppress_q850_reason_headers));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "ignore_183_without_sdp", "no", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, ignore_183_without_sdp));
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "incoming_call_offer_pref", "local",
        call_offer_pref_handler, incoming_call_offer_pref_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "outgoing_call_offer_pref", "remote_merge",
        call_offer_pref_handler, outgoing_call_offer_pref_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "codec_prefs_incoming_offer",
        "prefer: pending, operation: intersect, keep: all, transcode: allow",
        codec_prefs_handler, incoming_offer_codec_prefs_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "codec_prefs_outgoing_offer",
        "prefer: pending, operation: union, keep: all, transcode: allow",
        codec_prefs_handler, outgoing_offer_codec_prefs_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "codec_prefs_incoming_answer",
        "prefer: pending, operation: intersect, keep: all",
        codec_prefs_handler, incoming_answer_codec_prefs_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "codec_prefs_outgoing_answer",
        "prefer: pending, operation: intersect, keep: all",
        codec_prefs_handler, outgoing_answer_codec_prefs_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint",
        "stir_shaken", 0, stir_shaken_handler, stir_shaken_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "stir_shaken_profile", "", OPT_STRINGFIELD_T, 0, STRFLDSET(struct ast_sip_endpoint, stir_shaken_profile));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "allow_unauthenticated_options", "no", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, allow_unauthenticated_options));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "geoloc_incoming_call_profile", "", OPT_STRINGFIELD_T, 0, STRFLDSET(struct ast_sip_endpoint, geoloc_incoming_call_profile));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "geoloc_outgoing_call_profile", "", OPT_STRINGFIELD_T, 0, STRFLDSET(struct ast_sip_endpoint, geoloc_outgoing_call_profile));
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "security_mechanisms", "", security_mechanism_handler, security_mechanism_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register_custom(sip_sorcery, "endpoint", "security_negotiation", "no", security_negotiation_handler, security_negotiation_to_str, NULL, 0, 0);
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "send_aoc", "no", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, send_aoc));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "tenantid", "", OPT_STRINGFIELD_T, 0, STRFLDSET(struct ast_sip_endpoint, tenantid));
    ast_sorcery_object_field_register(sip_sorcery, "endpoint", "suppress_moh_on_sendonly",
        "no", OPT_BOOL_T, 1, FLDSET(struct ast_sip_endpoint, suppress_moh_on_sendonly));
 
    if (ast_sip_initialize_sorcery_transport()) {
        ast_log(LOG_ERROR, "Failed to register SIP transport support with sorcery\n");
        ast_sorcery_unref(sip_sorcery);
        sip_sorcery = NULL;
        return -1;
    }
 
    if (ast_sip_initialize_sorcery_location()) {
        ast_log(LOG_ERROR, "Failed to register SIP location support with sorcery\n");
        ast_sorcery_unref(sip_sorcery);
        sip_sorcery = NULL;
        return -1;
    }
 
    ast_sorcery_observer_add(sip_sorcery, "endpoint", &endpoint_observers);
 
    if (ast_sip_initialize_sorcery_domain_alias()) {
        ast_log(LOG_ERROR, "Failed to register SIP domain aliases support with sorcery\n");
        ast_sorcery_unref(sip_sorcery);
        sip_sorcery = NULL;
        return -1;
    }
 
    if (ast_sip_initialize_sorcery_global()) {
        ast_log(LOG_ERROR, "Failed to register SIP Global support\n");
        ast_sorcery_unref(sip_sorcery);
        sip_sorcery = NULL;
        return -1;
    }
 
    endpoint_formatter = ao2_alloc(sizeof(struct ast_sip_cli_formatter_entry), NULL);
    if (!endpoint_formatter) {
        ast_log(LOG_ERROR, "Unable to allocate memory for endpoint_formatter\n");
        ast_sorcery_unref(sip_sorcery);
        sip_sorcery = NULL;
        return -1;
    }
    endpoint_formatter->name = "endpoint";
    endpoint_formatter->print_header = cli_endpoint_print_header;
    endpoint_formatter->print_body = cli_endpoint_print_body;
    endpoint_formatter->get_container = cli_endpoint_get_container;
    endpoint_formatter->iterate = cli_endpoint_iterate;
    endpoint_formatter->retrieve_by_id = cli_endpoint_retrieve_by_id;
    endpoint_formatter->get_id = ast_sorcery_object_get_id;
 
    ast_sip_register_cli_formatter(endpoint_formatter);
    ast_cli_register_multiple(cli_commands, ARRAY_LEN(cli_commands));
 
    ast_sorcery_load(sip_sorcery);
 
    load_all_endpoints();
 
    acl_change_sub = stasis_subscribe(ast_security_topic(), acl_change_stasis_cb, NULL);
    stasis_subscription_accept_message_type(acl_change_sub, ast_named_acl_change_type());
    stasis_subscription_set_filter(acl_change_sub, STASIS_SUBSCRIPTION_FILTER_SELECTIVE);
 
    return 0;
}
 
void ast_res_pjsip_destroy_configuration(void)
{
    if (!sip_sorcery) {
        return;
    }
 
    acl_change_sub = stasis_unsubscribe_and_join(acl_change_sub);
    ast_sip_destroy_sorcery_global();
    ast_sip_destroy_sorcery_location();
    ast_sip_destroy_sorcery_auth();
    ast_sip_destroy_sorcery_transport();
    ast_sorcery_unref(sip_sorcery);
    sip_sorcery = NULL;
    ast_manager_unregister(AMI_SHOW_ENDPOINT);
    ast_manager_unregister(AMI_SHOW_ENDPOINTS);
    ast_cli_unregister_multiple(cli_commands, ARRAY_LEN(cli_commands));
    ast_sip_unregister_cli_formatter(endpoint_formatter);
    ast_sip_destroy_cli();
    ao2_cleanup(persistent_endpoints);
    persistent_endpoints = NULL;
}
 
int ast_res_pjsip_reload_configuration(void)
{
    if (sip_sorcery) {
        ast_sorcery_reload(sip_sorcery);
    }
    return 0;
}
 
static void subscription_configuration_destroy(struct ast_sip_endpoint_subscription_configuration *subscription)
{
    ast_string_field_free_memory(&subscription->mwi);
    ast_free(subscription->mwi.voicemail_extension);
}
 
static void info_configuration_destroy(struct ast_sip_endpoint_info_configuration *info)
{
    ast_string_field_free_memory(&info->recording);
}
 
static void media_configuration_destroy(struct ast_sip_endpoint_media_configuration *media)
{
    ast_rtp_dtls_cfg_free(&media->rtp.dtls_cfg);
    ast_string_field_free_memory(&media->rtp);
    ast_string_field_free_memory(media);
}
 
static void endpoint_destructor(void* obj)
{
    struct ast_sip_endpoint *endpoint = obj;
 
    ast_string_field_free_memory(endpoint);
 
    ao2_cleanup(endpoint->media.codecs);
    ast_stream_topology_free(endpoint->media.topology);
    subscription_configuration_destroy(&endpoint->subscription);
    info_configuration_destroy(&endpoint->info);
    media_configuration_destroy(&endpoint->media);
    ast_sip_auth_vector_destroy(&endpoint->inbound_auths);
    ast_sip_auth_vector_destroy(&endpoint->outbound_auths);
    ast_party_id_free(&endpoint->id.self);
    endpoint->pickup.named_callgroups = ast_unref_namedgroups(endpoint->pickup.named_callgroups);
    endpoint->pickup.named_pickupgroups = ast_unref_namedgroups(endpoint->pickup.named_pickupgroups);
    ao2_cleanup(endpoint->persistent);
    ast_variables_destroy(endpoint->channel_vars);
    AST_VECTOR_FREE(&endpoint->ident_method_order);
    ast_free(endpoint->contact_user);
    ast_free_acl_list(endpoint->contact_acl);
    ast_free_acl_list(endpoint->acl);
    ast_sip_security_mechanisms_vector_destroy(&endpoint->security_mechanisms);
}
 
static int init_subscription_configuration(struct ast_sip_endpoint_subscription_configuration *subscription)
{
    return ast_string_field_init(&subscription->mwi, 64);
}
 
static int init_info_configuration(struct ast_sip_endpoint_info_configuration *info)
{
    return ast_string_field_init(&info->recording, 32);
}
 
static int init_media_configuration(struct ast_sip_endpoint_media_configuration *media)
{
    return ast_string_field_init(media, 64) || ast_string_field_init(&media->rtp, 32);
}
 
void *ast_sip_endpoint_alloc(const char *name)
{
    struct ast_sip_endpoint *endpoint = ast_sorcery_generic_alloc(sizeof(*endpoint), endpoint_destructor);
    if (!endpoint) {
        return NULL;
    }
    if (ast_string_field_init(endpoint, 128)) {
        ao2_cleanup(endpoint);
        return NULL;
    }
 
    if (ast_string_field_init_extended(endpoint, geoloc_incoming_call_profile) ||
        ast_string_field_init_extended(endpoint, geoloc_outgoing_call_profile)) {
        ao2_cleanup(endpoint);
        return NULL;
    }
    if (ast_string_field_init_extended(endpoint, overlap_context)) {
        ao2_cleanup(endpoint);
        return NULL;
    }
    if (ast_string_field_init_extended(endpoint, tenantid)) {
        ao2_cleanup(endpoint);
        return NULL;
    }
 
    if (!(endpoint->media.codecs = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT))) {
        ao2_cleanup(endpoint);
        return NULL;
    }
    if (init_subscription_configuration(&endpoint->subscription)) {
        ao2_cleanup(endpoint);
        return NULL;
    }
    if (init_info_configuration(&endpoint->info)) {
        ao2_cleanup(endpoint);
        return NULL;
    }
    if (init_media_configuration(&endpoint->media)) {
        ao2_cleanup(endpoint);
        return NULL;
    }
 
    ast_party_id_init(&endpoint->id.self);
    endpoint->id.self.tag = ast_strdup("");
 
    if (AST_VECTOR_INIT(&endpoint->ident_method_order, 1)) {
        return NULL;
    }
 
    return endpoint;
}
 
struct ao2_container *ast_sip_get_endpoints(void)
{
    struct ao2_container *endpoints;
 
    endpoints = ast_sorcery_retrieve_by_fields(sip_sorcery, "endpoint", AST_RETRIEVE_FLAG_MULTIPLE | AST_RETRIEVE_FLAG_ALL, NULL);
 
    return endpoints;
}
 
struct ast_sip_endpoint *ast_sip_default_outbound_endpoint(void)
{
    RAII_VAR(char *, name, ast_sip_global_default_outbound_endpoint(), ast_free);
    return ast_strlen_zero(name) ? NULL : ast_sorcery_retrieve_by_id(
        sip_sorcery, "endpoint", name);
}
 
int ast_sip_retrieve_auths(const struct ast_sip_auth_vector *auths, struct ast_sip_auth **out)
{
    int i;
 
    for (i = 0; i < AST_VECTOR_SIZE(auths); ++i) {
        /* Using AST_VECTOR_GET is safe since the vector is immutable */
        const char *name = AST_VECTOR_GET(auths, i);
        out[i] = ast_sorcery_retrieve_by_id(ast_sip_get_sorcery(), SIP_SORCERY_AUTH_TYPE, name);
        if (!out[i]) {
            ast_log(LOG_NOTICE, "Couldn't find auth '%s'. Cannot authenticate\n", name);
            return -1;
        }
    }
 
    return 0;
}
 
void ast_sip_cleanup_auths(struct ast_sip_auth *auths[], size_t num_auths)
{
    int i;
    for (i = 0; i < num_auths; ++i) {
        ao2_cleanup(auths[i]);
    }
}
 
int ast_sip_retrieve_auths_vector(const struct ast_sip_auth_vector *auth_ids,
    struct ast_sip_auth_objects_vector *auth_objects)
{
    int i;
 
    for (i = 0; i < AST_VECTOR_SIZE(auth_ids); ++i) {
        /* Using AST_VECTOR_GET is safe since the vector is immutable */
        const char *name = AST_VECTOR_GET(auth_ids, i);
        struct ast_sip_auth *auth_object = ast_sorcery_retrieve_by_id(ast_sip_get_sorcery(), SIP_SORCERY_AUTH_TYPE, name);
        if (!auth_object) {
            ast_log(LOG_WARNING, "Auth object '%s' could not be found\n", name);
        } else {
            AST_VECTOR_APPEND(auth_objects, auth_object);
        }
    }
 
    return AST_VECTOR_SIZE(auth_objects) == AST_VECTOR_SIZE(auth_ids) ? 0 : -1;
}
 
struct ast_sorcery *ast_sip_get_sorcery(void)
{
    return sip_sorcery;
}