gnutls_pkcs11_obj_get_info(3)

1gnutls_pkcs11_obj_get_info(3)       gnutls       gnutls_pkcs11_obj_get_info(3)
2
3
4

NAME

6       gnutls_pkcs11_obj_get_info - API function
7

SYNOPSIS

9       #include <gnutls/pkcs11.h>
10
11       int         gnutls_pkcs11_obj_get_info(gnutls_pkcs11_obj_t         obj,
12       gnutls_pkcs11_obj_info_t itype, void * output, size_t * output_size);
13

ARGUMENTS

15       gnutls_pkcs11_obj_t obj
16                   should contain a gnutls_pkcs11_obj_t type
17
18       gnutls_pkcs11_obj_info_t itype
19                   Denotes the type of information requested
20
21       void * output
22                   where output will be stored
23
24       size_t * output_size
25                   contains the maximum size of the output and will  be  over‐
26                   written with actual
27

DESCRIPTION

29       This function will return information about the PKCS11 certificate such
30       as the label, id as well as token information where the key is  stored.
31       When  output  is  text it returns null terminated string although  out‐
32       put_size contains the size of the actual data only.
33
34       In versions previously to 3.6.0 this function included the null  termi‐
35       nator to  output_size . After 3.6.0 the output size doesn't include the
36       terminator character.
37

RETURNS

39       GNUTLS_E_SUCCESS (0) on success or a negative error code on error.
40

SINCE

42       2.12.0
43

REPORTING BUGS

45       Report bugs to <bugs@gnutls.org>.
46       Home page: http://www.gnutls.org
47
48

COPYRIGHT

50       Copyright © 2001-2018 Free Software Foundation, Inc., and others.
51       Copying and distribution of this file, with  or  without  modification,
52       are  permitted  in  any  medium  without royalty provided the copyright
53       notice and this notice are preserved.
54