|
Packit |
aea12f |
.\" DO NOT MODIFY THIS FILE! It was generated by gdoc.
|
|
Packit Service |
991b93 |
.TH "gnutls_pkcs11_token_set_pin" 3 "3.6.14" "gnutls" "gnutls"
|
|
Packit |
aea12f |
.SH NAME
|
|
Packit |
aea12f |
gnutls_pkcs11_token_set_pin \- API function
|
|
Packit |
aea12f |
.SH SYNOPSIS
|
|
Packit |
aea12f |
.B #include <gnutls/pkcs11.h>
|
|
Packit |
aea12f |
.sp
|
|
Packit |
aea12f |
.BI "int gnutls_pkcs11_token_set_pin(const char * " token_url ", const char * " oldpin ", const char * " newpin ", unsigned int " flags ");"
|
|
Packit |
aea12f |
.SH ARGUMENTS
|
|
Packit |
aea12f |
.IP "const char * token_url" 12
|
|
Packit |
aea12f |
A PKCS \fB11\fP URL specifying a token
|
|
Packit |
aea12f |
.IP "const char * oldpin" 12
|
|
Packit |
aea12f |
old user's PIN
|
|
Packit |
aea12f |
.IP "const char * newpin" 12
|
|
Packit |
aea12f |
new user's PIN
|
|
Packit |
aea12f |
.IP "unsigned int flags" 12
|
|
Packit |
aea12f |
one of \fBgnutls_pin_flag_t\fP.
|
|
Packit |
aea12f |
.SH "DESCRIPTION"
|
|
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 \fBNULL\fP. When setting the admin's PIN with the
|
|
Packit |
aea12f |
\fBGNUTLS_PIN_SO\fP flag, the \fIoldpin\fP 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 |
.SH "RETURNS"
|
|
Packit |
aea12f |
On success, \fBGNUTLS_E_SUCCESS\fP (0) is returned, otherwise a
|
|
Packit |
aea12f |
negative error value.
|
|
Packit |
aea12f |
.SH "REPORTING BUGS"
|
|
Packit |
aea12f |
Report bugs to <bugs@gnutls.org>.
|
|
Packit |
aea12f |
.br
|
|
Packit |
aea12f |
Home page: https://www.gnutls.org
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
.SH COPYRIGHT
|
|
Packit Service |
991b93 |
Copyright \(co 2001- Free Software Foundation, Inc., and others.
|
|
Packit |
aea12f |
.br
|
|
Packit |
aea12f |
Copying and distribution of this file, with or without modification,
|
|
Packit |
aea12f |
are permitted in any medium without royalty provided the copyright
|
|
Packit |
aea12f |
notice and this notice are preserved.
|
|
Packit |
aea12f |
.SH "SEE ALSO"
|
|
Packit |
aea12f |
The full documentation for
|
|
Packit |
aea12f |
.B gnutls
|
|
Packit |
aea12f |
is maintained as a Texinfo manual.
|
|
Packit |
aea12f |
If the /usr/share/doc/gnutls/
|
|
Packit |
aea12f |
directory does not contain the HTML form visit
|
|
Packit |
aea12f |
.B
|
|
Packit |
aea12f |
.IP https://www.gnutls.org/manual/
|
|
Packit |
aea12f |
.PP
|