NAME

radcli_ctx_new - Create an empty context, ready for radcli_ctx_set_opt_str()/ _set_opt_int() and radcli_ctx_apply() the fully programmatic ("backup") way to configure radcli without a config file on disk.

SYNOPSIS

#include <radcli/>

radcli_ctx * radcli_ctx_new(
    unsigned flags
);

DESCRIPTION

Allocates a context with no server, secret, or transport configured yet radcli_ctx_apply() must succeed before it is usable for a request. Also loads the built-in RFC 2865/2866/2869 dictionary, the same one radcli_ctx_read_config() always loads, unless RADCLI_CTX_NO_BUILTIN_DICT is set in flags so radcli_dict_lookup_num() is non-NULL for well-known attributes right away, without a separate radcli_ctx_read_dictionary() call.

PARAMETERS

flags

a bitwise OR of radcli_ctx_flags, or 0 for the common case.

RETURN VALUE

the new context, or NULL on allocation failure, an unknown flags bit, or a failure loading the built-in dictionary.

SEE ALSO

radcli_ctx_apply(3), radcli_ctx_free(3), radcli_ctx_get_opt_int(3), radcli_ctx_get_opt_str(3), radcli_ctx_read_config(3), radcli_ctx_read_dictionary(3), radcli_ctx_read_dictionary_from_buffer(3), radcli_ctx_set_opt_int(3), radcli_ctx_set_opt_str(3), radcli_ctx_set_secret(3), radcli_ctx_set_tls_psk(3)