---
name: "gnutls_psk_set_client_credentials"
section: "3"
platform: "linux"
package: "gnutls"
version: "3.8.13-3"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/gnutls_psk_set_client_credentials"
---

# gnutls\_psk\_set\_client\_credentials(3)

API function

## NAME

gnutls\_psk\_set\_client\_credentials - API function

## SYNOPSIS

**#include \<gnutls/gnutls.h\>**

**int gnutls\_psk\_set\_client\_credentials(gnutls\_psk\_client\_credentials\_t** *res***, const char \*** *username***, const gnutls\_datum\_t \*** *key***, gnutls\_psk\_key\_flags** *flags***);**

## ARGUMENTS

- gnutls\_psk\_client\_credentials\_t res

  is a **gnutls\_psk\_client\_credentials\_t** type.

- const char \* username

  is the user's zero-terminated userid

- const gnutls\_datum\_t \* key

  is the user's key

- gnutls\_psk\_key\_flags flags

  indicate the format of the key, either **GNUTLS\_PSK\_KEY\_RAW** or **GNUTLS\_PSK\_KEY\_HEX**.

## DESCRIPTION

This function sets the username and password, in a gnutls\_psk\_client\_credentials\_t type.  Those will be used in PSK authentication.   *username* should be an ASCII string or UTF-8 string. In case of a UTF-8 string it is recommended to be following the PRECIS framework for usernames (rfc8265). The key can be either in raw byte format or in Hex format (without the 0x prefix).

## RETURNS

On success, **GNUTLS\_E\_SUCCESS** (0) is returned, otherwise an error code is returned.

## REPORTING BUGS

Report bugs to \<bugs@gnutls.org\>.\
 Home page: https://www.gnutls.org

## COPYRIGHT

Copyright © 2001-2023 Free Software Foundation, Inc., and others.\
 Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved.

## SEE ALSO

The full documentation for **gnutls** is maintained as a Texinfo manual. If the /usr/share/doc/gnutls/ directory does not contain the HTML form visit

- https://www.gnutls.org/manual/