1gnutls_pkcs11_token_set_pin(3)      gnutls      gnutls_pkcs11_token_set_pin(3)
2
3
4

NAME

6       gnutls_pkcs11_token_set_pin - API function
7

SYNOPSIS

9       #include <gnutls/pkcs11.h>
10
11       int  gnutls_pkcs11_token_set_pin(const  char  * token_url, const char *
12       oldpin, const char * newpin, unsigned int flags);
13

ARGUMENTS

15       const char * token_url
16                   A PKCS 11 URL specifying a token
17
18       const char * oldpin
19                   old user's PIN
20
21       const char * newpin
22                   new user's PIN
23
24       unsigned int flags
25                   one of gnutls_pin_flag_t.
26

DESCRIPTION

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

RETURNS

35       On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative  er‐
36       ror value.
37

REPORTING BUGS

39       Report bugs to <bugs@gnutls.org>.
40       Home page: https://www.gnutls.org
41
42
44       Copyright © 2001-2023 Free Software Foundation, Inc., and others.
45       Copying  and  distribution  of this file, with or without modification,
46       are permitted in any medium without royalty provided the copyright  no‐
47       tice and this notice are preserved.
48

SEE ALSO

50       The  full  documentation  for gnutls is maintained as a Texinfo manual.
51       If the /usr/share/doc/gnutls/ directory does not contain the HTML  form
52       visit
53
54       https://www.gnutls.org/manual/
55
56gnutls                               3.8.2      gnutls_pkcs11_token_set_pin(3)
Impressum