gnutls_pkcs11_token_set_pin man page

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's PIN for the given token.  If it is called to set a user pin for first time the oldpin must be NULL.


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.2 gnutls