Blame doc/functions/gnutls_pkcs11_token_set_pin
|
Packit |
aea12f |
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
@deftypefun {int} {gnutls_pkcs11_token_set_pin} (const char * @var{token_url}, const char * @var{oldpin}, const char * @var{newpin}, unsigned int @var{flags})
|
|
Packit |
aea12f |
@var{token_url}: A PKCS @code{11} URL specifying a token
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
@var{oldpin}: old user's PIN
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
@var{newpin}: new user's PIN
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
@var{flags}: one of @code{gnutls_pin_flag_t} .
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
This function will modify or set a user or administrator's PIN for
|
|
Packit |
aea12f |
the given token. If it is called to set a PIN for first time
|
|
Packit |
aea12f |
the oldpin must be @code{NULL} . When setting the admin's PIN with the
|
|
Packit |
aea12f |
@code{GNUTLS_PIN_SO} flag, the @code{oldpin} value must be provided (this requirement
|
|
Packit |
aea12f |
is relaxed after GnuTLS 3.6.5 since which the PIN will be requested if missing).
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
@strong{Returns:} On success, @code{GNUTLS_E_SUCCESS} (0) is returned, otherwise a
|
|
Packit |
aea12f |
negative error value.
|
|
Packit |
aea12f |
@end deftypefun
|