79 lines
2.1 KiB
C
79 lines
2.1 KiB
C
|
/*
|
||
|
|
* Asterisk -- An open source telephony toolkit.
|
||
|
|
*
|
||
|
|
* Copyright (C) 2020, Sangoma Technologies Corporation
|
||
|
|
*
|
||
|
|
* Ben Ford <bford@sangoma.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.
|
||
|
|
*/
|
||
|
|
#ifndef _STIR_SHAKEN_CURL_H
|
||
|
|
#define _STIR_SHAKEN_CURL_H
|
||
|
|
|
||
|
|
struct ast_acl_list;
|
||
|
|
|
||
|
|
/* Forward declaration for CURL callback data */
|
||
|
|
struct curl_cb_data;
|
||
|
|
|
||
|
|
/*!
|
||
|
|
* \brief Allocate memory for a curl_cb_data struct
|
||
|
|
*
|
||
|
|
* \note This will need to be freed by the consumer using curl_cb_data_free
|
||
|
|
*
|
||
|
|
* \retval NULL on failure
|
||
|
|
* \retval curl_cb_struct on success
|
||
|
|
*/
|
||
|
|
struct curl_cb_data *curl_cb_data_create(void);
|
||
|
|
|
||
|
|
/*!
|
||
|
|
* \brief Free a curl_cb_data struct
|
||
|
|
*
|
||
|
|
* \param data The curl_cb_data struct to free
|
||
|
|
*/
|
||
|
|
void curl_cb_data_free(struct curl_cb_data *data);
|
||
|
|
|
||
|
|
/*!
|
||
|
|
* \brief Get the cache_control field from a curl_cb_data struct
|
||
|
|
*
|
||
|
|
* \param data The curl_cb_data
|
||
|
|
*
|
||
|
|
* \retval cache_control on success
|
||
|
|
* \retval NULL otherwise
|
||
|
|
*/
|
||
|
|
char *curl_cb_data_get_cache_control(const struct curl_cb_data *data);
|
||
|
|
|
||
|
|
/*!
|
||
|
|
* \brief Get the expires field from a curl_cb_data struct
|
||
|
|
*
|
||
|
|
* \param data The curl_cb_data
|
||
|
|
*
|
||
|
|
* \retval expires on success
|
||
|
|
* \retval NULL otherwise
|
||
|
|
*/
|
||
|
|
char *curl_cb_data_get_expires(const struct curl_cb_data *data);
|
||
|
|
|
||
|
|
/*!
|
||
|
|
* \brief CURL the public key from the provided URL to the specified path
|
||
|
|
*
|
||
|
|
* \note The returned string will need to be freed by the caller
|
||
|
|
*
|
||
|
|
* \param public_cert_url The public cert URL
|
||
|
|
* \param path The path to download the file to
|
||
|
|
* \param data The curl_cb_data
|
||
|
|
* \param acl The ACL to use for cURL (if not NULL)
|
||
|
|
*
|
||
|
|
* \retval NULL on failure
|
||
|
|
* \retval full path filename on success
|
||
|
|
*/
|
||
|
|
char *curl_public_key(const char *public_cert_url, const char *path, struct curl_cb_data *data, const struct ast_acl_list *acl);
|
||
|
|
|
||
|
|
#endif /* _STIR_SHAKEN_CURL_H */
|