radcli_ctx_set_opt_str(3)    Radius client library   radcli_ctx_set_opt_str(3)

NAME
       radcli_ctx_set_opt_str - Set a string-typed configuration option.

SYNOPSIS
       #include <radcli/>

       int radcli_ctx_set_opt_str(
           radcli_ctx   *ctx,
           radcli_opt_id opt,
           const char   *val
       );

DESCRIPTION
       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.

PARAMETERS
       ctx    a context from radcli_ctx_new() or radcli_ctx_read_config().


       opt    the option to set.


       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.


RETURN VALUE
       0 on success, -1 on failure (NULL ctx, opt out of range, wrong type for
       opt, or an invalid val for opt's grammar).

SEE ALSO
       radcli_ctx_apply(3), radcli_ctx_free(3), radcli_ctx_get_opt_int(3),
       radcli_ctx_get_opt_str(3), radcli_ctx_new(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_secret(3), radcli_ctx_set_tls_psk(3)

radcli                            2026-09-03         radcli_ctx_set_opt_str(3)