.\" File automatically generated by doxy2man0.3
.\" Generation date: Thu Sep 3 2026
.TH radcli_ctx_new 3 2026-09-03 "radcli" "Radius client library"
.SH "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.
.SH SYNOPSIS
.nf
.B #include <radcli/>
.sp
\fBradcli_ctx * radcli_ctx_new\fP(
    \fBunsigned \fP\fIflags\fP
);
.fi
.SH DESCRIPTION
.PP 
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.
.SH PARAMETERS
.TP
.B flags
a bitwise OR of radcli_ctx_flags, or 0 for the common case. 

.SH RETURN VALUE
.PP
the new context, or NULL on allocation failure, an unknown flags bit, or a failure loading the built-in dictionary. 
.SH SEE ALSO
.PP
.nh
.ad l
\fIradcli_ctx_apply\fP(3), \fIradcli_ctx_free\fP(3), \fIradcli_ctx_get_opt_int\fP(3), \fIradcli_ctx_get_opt_str\fP(3), \fIradcli_ctx_read_config\fP(3), \fIradcli_ctx_read_dictionary\fP(3), \fIradcli_ctx_read_dictionary_from_buffer\fP(3), \fIradcli_ctx_set_opt_int\fP(3), \fIradcli_ctx_set_opt_str\fP(3), \fIradcli_ctx_set_secret\fP(3), \fIradcli_ctx_set_tls_psk\fP(3)
.ad
.hy