#include "asterisk.h"
#include "asterisk/sip_api.h"
#include "asterisk/logger.h"

Include dependency graph for sip_api.c:

Functions
int	ast_sip_api_provider_register (const struct ast_sip_api_tech *provider)
	Register a SIP API provider. More...

void	ast_sip_api_provider_unregister (void)
	Unregister a SIP API provider. More...

int	ast_sipinfo_send (struct ast_channel chan, struct ast_variable headers, const char content_type, const char content, const char *useragent_filter)
	Send a customized SIP INFO request. More...

Variables
static const struct ast_sip_api_tech *	api_provider

Function Documentation

◆ ast_sip_api_provider_register()

int ast_sip_api_provider_register ( const struct ast_sip_api_tech * provider )

Register a SIP API provider.

This will fail if a provider has already registered or if the provider is using an incorrect version.

Parameters

provider The provider to register

Return values

0	Success
-1	Failure

Definition at line 39 of file sip_api.c.

{
    if (api_provider) {
        ast_log(LOG_WARNING, "SIP provider %s has already registered. Not registering provider %s\n",
                api_provider->name, provider->name);
        return -1;
    }
 
    if (provider->version != AST_SIP_API_VERSION) {
        ast_log(LOG_WARNING, "SIP API provider version mismatch: Current version is %d but provider "
                "uses version %d\n", AST_SIP_API_VERSION, provider->version);
        return -1;
    }
 
    api_provider = provider;
    return 0;
}

References api_provider, ast_log, AST_SIP_API_VERSION, LOG_WARNING, prometheus_metrics_provider::name, ast_sip_api_tech::name, and provider.

◆ ast_sip_api_provider_unregister()

void ast_sip_api_provider_unregister ( void )

Unregister a SIP API provider.

Definition at line 57 of file sip_api.c.

{
    api_provider = NULL;
}

References api_provider, and NULL.

◆ ast_sipinfo_send()

int ast_sipinfo_send	(	struct ast_channel *	chan,
		struct ast_variable *	headers,
		const char *	content_type,
		const char *	content,
		const char *	useragent_filter
	)

Send a customized SIP INFO request.

Parameters

chan	Channel
headers	The headers to add to the INFO request
content_type	The content type header to add
content	The body of the INFO request
useragent_filter	If non-NULL, only send the INFO if the recipient's User-Agent contains useragent_filter as a substring

Return values

0	Success
non-zero	Failure

Definition at line 25 of file sip_api.c.

{
    if (!api_provider) {
        ast_log(LOG_WARNING, "Unable to send custom SIP INFO. No API provider registered\n");
        return -1;
    }
 
    return api_provider->sipinfo_send(chan, headers, content_type, content, useragent_filter);
}

References api_provider, ast_log, LOG_WARNING, and ast_sip_api_tech::sipinfo_send.

Variable Documentation

◆ api_provider

const struct ast_sip_api_tech* api_provider

static

Definition at line 23 of file sip_api.c.

Referenced by ast_sip_api_provider_register(), ast_sip_api_provider_unregister(), and ast_sipinfo_send().