base.c File Reference

Curl global initialisation. More...

#include <freeradius-devel/curl/base.h>
#include <freeradius-devel/curl/xlat.h>
#include <freeradius-devel/util/talloc.h>
#include <freeradius-devel/unlang/xlat_func.h>
#include "attrs.h"

Include dependency graph for base.c:

Go to the source code of this file.

Functions
static int	_curl_tmpl_handle (void *arg)
	Free the curl easy handle. More...
int	fr_curl_easy_tls_init (fr_curl_io_request_t *randle, fr_curl_tls_t const *conf)
static void	fr_curl_free (void)
static int	fr_curl_init (void)
	Initialise global curl options. More...
int	fr_curl_response_certinfo (request_t *request, fr_curl_io_request_t *randle)
CURL *	fr_curl_tmp_handle (void)
	Return a thread local curl easy handle. More...

Variables
fr_dict_attr_t const *	attr_tls_certificate
	Attribute definitions for lib curl. More...
fr_dict_attr_autoload_t	curl_attr []
static fr_dict_autoload_t	curl_dict []
static fr_dict_t const *	dict_freeradius
global_lib_autoinst_t	fr_curl_autoinst
conf_parser_t	fr_curl_conn_config []
static fr_table_num_sorted_t const	fr_curl_sslcode_table []
static size_t	fr_curl_sslcode_table_len = NUM_ELEMENTS(fr_curl_sslcode_table)
conf_parser_t	fr_curl_tls_config []
static conf_parser_t	reuse_curl_conn_config []

Detailed Description

Curl global initialisation.

Id

7428ff6b3783cd24315d43c52ce8bfa0bea90d82

Copyright

2020 Arran Cudbard-Bell (a.cud.nosp@m.bard.nosp@m.b@fre.nosp@m.erad.nosp@m.ius.o.nosp@m.rg)

Definition in file base.c.

Function Documentation

_curl_tmpl_handle()

static int _curl_tmpl_handle ( void *  arg )

static

Free the curl easy handle.

Parameters

[in]

arg

curl easy handle to free.

Definition at line 206 of file base.c.

Here is the caller graph for this function:

fr_curl_easy_tls_init()

int fr_curl_easy_tls_init	(	fr_curl_io_request_t *	randle,
		fr_curl_tls_t const *	conf
	)

Definition at line 90 of file base.c.

Here is the caller graph for this function:

fr_curl_free()

static void fr_curl_free ( void  )

static

Definition at line 325 of file base.c.

Here is the call graph for this function:

fr_curl_init()

static int fr_curl_init ( void  )

static

Initialise global curl options.

libcurl is meant to performa reference counting, but still seems to leak lots of memory if we call curl_global_init many times.

Definition at line 241 of file base.c.

Here is the call graph for this function:

fr_curl_response_certinfo()

int fr_curl_response_certinfo	(	request_t *	request,
		fr_curl_io_request_t *	randle
	)

Definition at line 114 of file base.c.

Here is the call graph for this function:

Here is the caller graph for this function:

fr_curl_tmp_handle()

CURL* fr_curl_tmp_handle

(

void

)

Return a thread local curl easy handle.

This should only be used for calls into libcurl functions which don't operate on an active request, like the escape/unescape functions.

Returns

• A thread local curl easy handle.
• NULL on failure.

Definition at line 222 of file base.c.

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

attr_tls_certificate

fr_dict_attr_t const* attr_tls_certificate

Attribute definitions for lib curl.

Copyright

2021 Arran Cudbard-Bell (a.cud.nosp@m.bard.nosp@m.b@fre.nosp@m.erad.nosp@m.ius.o.nosp@m.rg)

Definition at line 35 of file base.c.

curl_attr

fr_dict_attr_autoload_t curl_attr

Initial value:

= {
        { .out = &attr_tls_certificate, .name = "TLS-Certificate", .type = FR_TYPE_TLV, .dict = &dict_freeradius },
        { NULL }
}

Definition at line 39 of file base.c.

curl_dict

fr_dict_autoload_t curl_dict[]

static

Initial value:

= {
        { .out = &dict_freeradius, .proto = "freeradius" },
        { NULL }
}

Definition at line 44 of file base.c.

dict_freeradius

fr_dict_t const* dict_freeradius

static

Definition at line 36 of file base.c.

fr_curl_autoinst

global_lib_autoinst_t fr_curl_autoinst

Initial value:

= {
        .name = "curl",
        .init = fr_curl_init,
        .free = fr_curl_free
}

Definition at line 342 of file base.c.

fr_curl_conn_config

conf_parser_t fr_curl_conn_config[]

Initial value:

= {
        { FR_CONF_OFFSET_SUBSECTION("reuse", 0, fr_curl_conn_config_t, reuse, reuse_curl_conn_config) },
        { FR_CONF_OFFSET("connect_timeout", fr_curl_conn_config_t, connect_timeout), .dflt = "3.0" },
        CONF_PARSER_TERMINATOR
}

Definition at line 84 of file base.c.

fr_curl_sslcode_table

fr_table_num_sorted_t const fr_curl_sslcode_table[]

static

Initial value:

= {
        {L("allow"),     CURLUSESSL_TRY          },
        {L("demand"),    CURLUSESSL_ALL          },
        {L("never"),     CURLUSESSL_NONE         },
}

Definition at line 49 of file base.c.

fr_curl_sslcode_table_len

size_t fr_curl_sslcode_table_len = NUM_ELEMENTS(fr_curl_sslcode_table)

static

Definition at line 54 of file base.c.

fr_curl_tls_config

conf_parser_t fr_curl_tls_config[]

Initial value:

= {
        { FR_CONF_OFFSET_FLAGS("ca_file", CONF_FLAG_FILE_INPUT, fr_curl_tls_t, ca_file) },
        { FR_CONF_OFFSET_FLAGS("ca_issuer_file", CONF_FLAG_FILE_INPUT, fr_curl_tls_t, ca_issuer_file) },
        { FR_CONF_OFFSET_FLAGS("ca_path", CONF_FLAG_FILE_INPUT, fr_curl_tls_t, ca_path) },
        { FR_CONF_OFFSET_FLAGS("certificate_file", CONF_FLAG_FILE_INPUT, fr_curl_tls_t, certificate_file) },
        { FR_CONF_OFFSET_FLAGS("private_key_file", CONF_FLAG_FILE_INPUT, fr_curl_tls_t, private_key_file) },
        { FR_CONF_OFFSET_FLAGS("private_key_password", CONF_FLAG_SECRET, fr_curl_tls_t, private_key_password) },
        { FR_CONF_OFFSET("random_file", fr_curl_tls_t, random_file) },
        { FR_CONF_OFFSET_TYPE_FLAGS("require_cert", FR_TYPE_VOID, 0, fr_curl_tls_t, require_cert),
                .func = cf_table_parse_int,
                .uctx = &(cf_table_parse_ctx_t){
                        .table = fr_curl_sslcode_table,
                        .len = &fr_curl_sslcode_table_len
                },
                .dflt = "allow" },
        { FR_CONF_OFFSET("check_cert", fr_curl_tls_t, check_cert), .dflt = "yes" },
        { FR_CONF_OFFSET("check_cert_cn", fr_curl_tls_t, check_cert_cn), .dflt = "yes" },
        { FR_CONF_OFFSET("extract_cert_attrs", fr_curl_tls_t, extract_cert_attrs), .dflt = "no" },
        CONF_PARSER_TERMINATOR
}

Definition at line 56 of file base.c.

reuse_curl_conn_config

conf_parser_t reuse_curl_conn_config[]

static

Initial value:

= {
        { FR_CONF_OFFSET("min", fr_slab_config_t, min_elements), .dflt = "10" },
        { FR_CONF_OFFSET("max", fr_slab_config_t, max_elements), .dflt = "100" },
        { FR_CONF_OFFSET("cleanup_interval", fr_slab_config_t, interval), .dflt = "30s" },
        CONF_PARSER_TERMINATOR
}

Definition at line 77 of file base.c.