diff options
Diffstat (limited to 'doc/manpages/gnutls_pkcs12_mac_info.3')
| -rw-r--r-- | doc/manpages/gnutls_pkcs12_mac_info.3 | 52 |
1 files changed, 52 insertions, 0 deletions
diff --git a/doc/manpages/gnutls_pkcs12_mac_info.3 b/doc/manpages/gnutls_pkcs12_mac_info.3 new file mode 100644 index 0000000..8657c0f --- /dev/null +++ b/doc/manpages/gnutls_pkcs12_mac_info.3 @@ -0,0 +1,52 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. +.TH "gnutls_pkcs12_mac_info" 3 "3.7.9" "gnutls" "gnutls" +.SH NAME +gnutls_pkcs12_mac_info \- API function +.SH SYNOPSIS +.B #include <gnutls/pkcs12.h> +.sp +.BI "int gnutls_pkcs12_mac_info(gnutls_pkcs12_t " pkcs12 ", unsigned int * " mac ", void * " salt ", unsigned int * " salt_size ", unsigned int * " iter_count ", char ** " oid ");" +.SH ARGUMENTS +.IP "gnutls_pkcs12_t pkcs12" 12 +A pkcs12 type +.IP "unsigned int * mac" 12 +the MAC algorithm used as \fBgnutls_mac_algorithm_t\fP +.IP "void * salt" 12 +the salt used for string to key (if non\-NULL then \fIsalt_size\fP initially holds its size) +.IP "unsigned int * salt_size" 12 +string to key salt size +.IP "unsigned int * iter_count" 12 +string to key iteration count +.IP "char ** oid" 12 +if non\-NULL it will contain an allocated null\-terminated variable with the OID +.SH "DESCRIPTION" +This function will provide information on the MAC algorithm used +in a PKCS \fB12\fP structure. If the structure algorithms +are unknown the code \fBGNUTLS_E_UNKNOWN_HASH_ALGORITHM\fP will be returned, +and only \fIoid\fP , will be set. That is, \fIoid\fP will be set on structures +with a MAC whether supported or not. It must be deinitialized using \fBgnutls_free()\fP. +The other variables are only set on supported structures. +.SH "RETURNS" +\fBGNUTLS_E_INVALID_REQUEST\fP if the provided structure doesn't contain a MAC, +\fBGNUTLS_E_UNKNOWN_HASH_ALGORITHM\fP if the structure's MAC isn't supported, or +another negative error code in case of a failure. Zero on success. +.SH "REPORTING BUGS" +Report bugs to <bugs@gnutls.org>. +.br +Home page: https://www.gnutls.org + +.SH COPYRIGHT +Copyright \(co 2001- Free Software Foundation, Inc., and others. +.br +Copying and distribution of this file, with or without modification, +are permitted in any medium without royalty provided the copyright +notice and this notice are preserved. +.SH "SEE ALSO" +The full documentation for +.B gnutls +is maintained as a Texinfo manual. +If the /usr/share/doc/gnutls/ +directory does not contain the HTML form visit +.B +.IP https://www.gnutls.org/manual/ +.PP |