gnutls_pkcs11_token_init — API function


#include <gnutls/pkcs11.h>

int gnutls_pkcs11_token_init(const char * token_url, const char * so_pin, const char * label);


const char * token_url

A PKCS 11 URL specifying a token

const char * so_pin

Security Officer's PIN

const char * label

A name to be used for the token


This function will initialize (format) a token. If the token is at a factory defaults state the security officer's PIN given will be set to be the default. Otherwise it should match the officer's PIN.


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