.\" File automatically generated by doxy2man0.3
.\" Generation date: Thu Sep 3 2026
.TH radcli_ctx_set_opt_str 3 2026-09-03 "radcli" "Radius client library"
.SH "NAME"
radcli_ctx_set_opt_str \- Set a string-typed configuration option.
.SH SYNOPSIS
.nf
.B #include <radcli/>
.sp
\fBint radcli_ctx_set_opt_str\fP(
    \fBradcli_ctx   *\fP\fIctx\fP,
    \fBradcli_opt_id \fP\fIopt\fP,
    \fBconst char   *\fP\fIval\fP
);
.fi
.SH DESCRIPTION
.PP 
Stores val for opt on ctx, validating it against opt's own grammar (e.g. #RADCLI_OPT_AUTHSERVER accepts the "host[:port[:secret]]" form a config file's authserver line does). Valid for any radcli_opt_id whose RC_OPTION_TABLE type is RADCLI_OPT_TYPE_STR or RADCLI_OPT_TYPE_SRV; use radcli_ctx_set_opt_int() for an RADCLI_OPT_TYPE_INT option instead.
.SH PARAMETERS
.TP
.B ctx
a context from radcli_ctx_new() or radcli_ctx_read_config(). 

.TP
.B opt
the option to set. 

.TP
.B val
the value; for #RADCLI_OPT_AUTHSERVER/#RADCLI_OPT_ACCTSERVER, the shared secret is better set with radcli_ctx_set_secret() than embedded in this string. 

.SH RETURN VALUE
.PP
0 on success, -1 on failure (NULL ctx, opt out of range, wrong type for opt, or an invalid val for opt's grammar). 
.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\fP(3), \fIradcli_ctx_read_dictionary_from_buffer\fP(3), \fIradcli_ctx_set_opt_int\fP(3), \fIradcli_ctx_set_secret\fP(3), \fIradcli_ctx_set_tls_psk\fP(3)
.ad
.hy