gnutls_pkcs11_token_set_pin — API function


#include <gnutls/pkcs11.h>

int gnutls_pkcs11_token_set_pin(const char * token_url, const char * oldpin, const char * newpin, unsigned int flags);


const char * token_url

A PKCS 11 URL specifying a token

const char * oldpin

old user's PIN

const char * newpin

new user's PIN

unsigned int flags

one of gnutls_pin_flag_t.


This function will modify or set a user or administrator's PIN for the given token.  If it is called to set a PIN for first time the oldpin must be NULL. When setting the admin's PIN with the GNUTLS_PIN_SO flag, the  oldpin value must be provided (this requirement is relaxed after GnuTLS 3.6.5 since which the PIN will be requested if missing).


On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error value.

Reporting Bugs

Report bugs to <>.
Home page:

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


3.6.9 gnutls