doc/manpages/gnutls_pkcs11_token_set_pin.3

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
   2 .TH "gnutls_pkcs11_token_set_pin" 3 "2.12.6.1" "gnutls" "gnutls"
   3 .SH NAME
   4 gnutls_pkcs11_token_set_pin \- API function
   5 .SH SYNOPSIS
   6 .B #include <gnutls/gnutls.h>
   7 .sp
   8 .BI "int gnutls_pkcs11_token_set_pin(const char * " token_url ", const char * " oldpin ", const char * " newpin ", unsigned int " flags ");"
   9 .SH ARGUMENTS
  10 .IP "const char * token_url" 12
  11 A PKCS \fB11\fP URL specifying a token
  12 .IP "const char * oldpin" 12
  13 old user's PIN
  14 .IP "const char * newpin" 12
  15 new user's PIN
  16 .IP "unsigned int flags" 12
  17 one of gnutls_pkcs11_pin_flag_t
  18 .SH "DESCRIPTION"
  19 This function will modify or set a user's PIN for the given token.
  20 If it is called to set a user pin for first time the oldpin must
  21 be NULL.
  22 .SH "RETURNS"
  23 On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a
  24 negative error value.
  25 .SH "REPORTING BUGS"
  26 Report bugs to <bug-gnutls@gnu.org>.
  27 GnuTLS home page: http://www.gnu.org/software/gnutls/
  28 General help using GNU software: http://www.gnu.org/gethelp/
  29 .SH COPYRIGHT
  30 Copyright \(co 2008 Free Software Foundation.
  31 .br
  32 Copying and distribution of this file, with or without modification,
  33 are permitted in any medium without royalty provided the copyright
  34 notice and this notice are preserved.
  35 .SH "SEE ALSO"
  36 The full documentation for
  37 .B gnutls
  38 is maintained as a Texinfo manual.  If the
  39 .B info
  40 and
  41 .B gnutls
  42 programs are properly installed at your site, the command
  43 .IP
  44 .B info gnutls
  45 .PP
  46 should give you access to the complete manual.