.\" File automatically generated by doxy2man0.3
.\" Generation date: Thu Sep 3 2026
.TH radcli_ctx_read_dictionary 3 2026-09-03 "radcli" "Radius client library"
.SH "NAME"
radcli_ctx_read_dictionary \- Load an additional attribute dictionary.
.SH SYNOPSIS
.nf
.B #include <radcli/>
.sp
\fBint radcli_ctx_read_dictionary\fP(
    \fBradcli_ctx  *\fP\fIctx\fP,
    \fBconst char  *\fP\fIpath\fP
);
.fi
.SH DESCRIPTION
.PP 
Parses path (ATTRIBUTE/VALUE/VENDOR lines, radcli's dictionary grammar) into ctx's dictionary. Not needed for the common case: radcli_ctx_read_config() already loads the file's own dictionary= option. Useful for the programmatic ("backup") construction path, or to load more than one supplemental dictionary.
.SH PARAMETERS
.TP
.B ctx
a context from radcli_ctx_new() or radcli_ctx_read_config(). 

.TP
.B path
path to the dictionary file. 

.SH RETURN VALUE
.PP
0 on success, -1 on failure (unreadable file, or a parse error  including a conflicting redefinition of an already-loaded attribute). 
.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_new\fP(3), \fIradcli_ctx_read_config\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