gnutls_pkcs11_copy_pubkey(3)

1gnutls_pkcs11_copy_pubkey(3)        gnutls        gnutls_pkcs11_copy_pubkey(3)
2
3
4

NAME

6       gnutls_pkcs11_copy_pubkey - API function
7

SYNOPSIS

9       #include <gnutls/pkcs11.h>
10
11       int  gnutls_pkcs11_copy_pubkey(const  char * token_url, gnutls_pubkey_t
12       pubkey, const char * label, const gnutls_datum_t *  cid,  unsigned  int
13       key_usage, unsigned int flags);
14

ARGUMENTS

16       const char * token_url
17                   A PKCS 11 URL specifying a token
18
19       gnutls_pubkey_t pubkey
20                   The public key to copy
21
22       const char * label
23                   The name to be used for the stored data
24
25       const gnutls_datum_t * cid
26                   The  CKA_ID  to set for the object -if NULL, the ID will be
27                   derived from the public key
28
29       unsigned int key_usage
30                   One of GNUTLS_KEY_*
31
32       unsigned int flags
33                   One of GNUTLS_PKCS11_OBJ_FLAG_*
34

DESCRIPTION

36       This function will copy a public key object into a PKCS 11 token speci‐
37       fied     by    a    URL.    Valid    flags    to    mark    the    key:
38       GNUTLS_PKCS11_OBJ_FLAG_MARK_TRUSTED,   GNUTLS_PKCS11_OBJ_FLAG_MARK_PRI‐
39       VATE,                                   GNUTLS_PKCS11_OBJ_FLAG_MARK_CA,
40       GNUTLS_PKCS11_OBJ_FLAG_MARK_ALWAYS_AUTH.
41

RETURNS

43       On success, GNUTLS_E_SUCCESS (0)  is  returned,  otherwise  a  negative
44       error value.
45

SINCE

47       3.4.6
48

REPORTING BUGS

50       Report bugs to <bugs@gnutls.org>.
51       Home page: https://www.gnutls.org
52
53

COPYRIGHT

55       Copyright © 2001-2020 Free Software Foundation, Inc., and others.
56       Copying  and  distribution  of this file, with or without modification,
57       are permitted in any medium  without  royalty  provided  the  copyright
58       notice and this notice are preserved.
59