1gnutls_pkcs12_mac_info(3)           gnutls           gnutls_pkcs12_mac_info(3)
2
3
4

NAME

6       gnutls_pkcs12_mac_info - API function
7

SYNOPSIS

9       #include <gnutls/pkcs12.h>
10
11       int  gnutls_pkcs12_mac_info(gnutls_pkcs12_t pkcs12, unsigned int * mac,
12       void * salt, unsigned int * salt_size, unsigned int * iter_count,  char
13       ** oid);
14

ARGUMENTS

16       gnutls_pkcs12_t pkcs12
17                   A pkcs12 type
18
19       unsigned int * mac
20                   the MAC algorithm used as gnutls_mac_algorithm_t
21
22       void * salt the   salt  used  for  string  to  key  (if  non-NULL  then
23                   salt_size initially holds its size)
24
25       unsigned int * salt_size
26                   string to key salt size
27
28       unsigned int * iter_count
29                   string to key iteration count
30
31       char ** oid if non-NULL it will contain  an  allocated  null-terminated
32                   variable with the OID
33

DESCRIPTION

35       This  function  will provide information on the MAC algorithm used in a
36       PKCS 12 structure. If the structure algorithms  are  unknown  the  code
37       GNUTLS_E_UNKNOWN_HASH_ALGORITHM  will be returned, and only  oid , will
38       be set. That is,  oid will be set on structures with a MAC whether sup‐
39       ported or not. It must be deinitialized using gnutls_free().  The other
40       variables are only set on supported structures.
41

RETURNS

43       GNUTLS_E_INVALID_REQUEST if the provided structure  doesn't  contain  a
44       MAC,  GNUTLS_E_UNKNOWN_HASH_ALGORITHM if the structure's MAC isn't sup‐
45       ported, or another negative error code in case of a  failure.  Zero  on
46       success.
47

REPORTING BUGS

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

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

SEE ALSO

60       The  full  documentation  for gnutls is maintained as a Texinfo manual.
61       If the /usr/share/doc/gnutls/ directory does not contain the HTML  form
62       visit
63
64       https://www.gnutls.org/manual/
65
66gnutls                              3.6.15           gnutls_pkcs12_mac_info(3)
Impressum