Blame doc/functions/gnutls_pkcs12_bag_enc_info

Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
@deftypefun {int} {gnutls_pkcs12_bag_enc_info} (gnutls_pkcs12_bag_t @var{bag}, unsigned int * @var{schema}, unsigned int * @var{cipher}, void * @var{salt}, unsigned int * @var{salt_size}, unsigned int * @var{iter_count}, char ** @var{oid})
Packit Service 4684c1
@var{bag}: The bag
Packit Service 4684c1
Packit Service 4684c1
@var{schema}: indicate the schema as one of @code{gnutls_pkcs_encrypt_flags_t} 
Packit Service 4684c1
Packit Service 4684c1
@var{cipher}: the cipher used as @code{gnutls_cipher_algorithm_t} 
Packit Service 4684c1
Packit Service 4684c1
@var{salt}: PBKDF2 salt (if non-NULL then  @code{salt_size} initially holds its size)
Packit Service 4684c1
Packit Service 4684c1
@var{salt_size}: PBKDF2 salt size
Packit Service 4684c1
Packit Service 4684c1
@var{iter_count}: PBKDF2 iteration count
Packit Service 4684c1
Packit Service 4684c1
@var{oid}: if non-NULL it will contain an allocated null-terminated variable with the OID
Packit Service 4684c1
Packit Service 4684c1
This function will provide information on the encryption algorithms used
Packit Service 4684c1
in an encrypted bag. If the structure algorithms
Packit Service 4684c1
are unknown the code @code{GNUTLS_E_UNKNOWN_CIPHER_TYPE}  will be returned,
Packit Service 4684c1
and only  @code{oid} , will be set. That is,  @code{oid} will be set on encrypted bags
Packit Service 4684c1
whether supported or not. It must be deinitialized using @code{gnutls_free()} .
Packit Service 4684c1
The other variables are only set on supported structures.
Packit Service 4684c1
Packit Service 4684c1
@strong{Returns:} @code{GNUTLS_E_INVALID_REQUEST}  if the provided bag isn't encrypted,
Packit Service 4684c1
@code{GNUTLS_E_UNKNOWN_CIPHER_TYPE}  if the structure's encryption isn't supported, or
Packit Service 4684c1
another negative error code in case of a failure. Zero on success.
Packit Service 4684c1
@end deftypefun