Scroll to navigation

radcli_ctx_set_tls_psk(3) Radius client library radcli_ctx_set_tls_psk(3)

NAME

radcli_ctx_set_tls_psk - Set the RFC 6614/7360 TLS-transport Pre-Shared Key credentials for the configured authserver.

SYNOPSIS

#include <radcli/>

int radcli_ctx_set_tls_psk(

radcli_ctx *ctx,
const void *identity,
size_t identity_len,
const uint8_t *key,
size_t keylen );

DESCRIPTION

The equivalent, for the new API, of the legacy authserver host:port:psk@username@hexkey inline form but with identity and key as independent byte buffers instead of a delimited string, so a username containing @ cannot be misparsed (the legacy form splits on the first @ after the psk@ prefix) and the key never needs to be hex-encoded by the caller. Only meaningful when #RADCLI_OPT_SERV_TYPE is tls or dtls; takes priority over any psk@username@hexkey embedded in #RADCLI_OPT_AUTHSERVER's value, should both somehow be set.

PARAMETERS

a context, before radcli_ctx_apply().

the PSK identity; GnuTLS treats this as a NUL-terminated string once passed on, so an identity containing an embedded NUL byte is truncated there a GnuTLS API constraint, not an ambiguity this function introduces.

identity's length in bytes.

the raw PSK key bytes (not hex-encoded text).

key's length in bytes.

RETURN VALUE

0 on success, -1 on failure (NULL ctx/identity/key, or keylen 0).

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_opt_str(3), radcli_ctx_set_secret(3)

2026-11-15 radcli