Blame doc/functions/gnutls_x509_crq_get_key_id
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@deftypefun {int} {gnutls_x509_crq_get_key_id} (gnutls_x509_crq_t @var{crq}, unsigned int @var{flags}, unsigned char * @var{output_data}, size_t * @var{output_data_size})
|
|
Packit Service |
4684c1 |
@var{crq}: a certificate of type @code{gnutls_x509_crq_t}
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@var{flags}: should be one of the flags from @code{gnutls_keyid_flags_t}
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@var{output_data}: will contain the key ID
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@var{output_data_size}: holds the size of output_data (and will be
|
|
Packit Service |
4684c1 |
replaced by the actual size of parameters)
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
This function will return a unique ID that depends on the public key
|
|
Packit Service |
4684c1 |
parameters. This ID can be used in checking whether a certificate
|
|
Packit Service |
4684c1 |
corresponds to the given private key.
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
If the buffer provided is not long enough to hold the output, then
|
|
Packit Service |
4684c1 |
* @code{output_data_size} is updated and GNUTLS_E_SHORT_MEMORY_BUFFER will
|
|
Packit Service |
4684c1 |
be returned. The output will normally be a SHA-1 hash output,
|
|
Packit Service |
4684c1 |
which is 20 bytes.
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@strong{Returns:} In case of failure a negative error code will be
|
|
Packit Service |
4684c1 |
returned, and 0 on success.
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@strong{Since:} 2.8.0
|
|
Packit Service |
4684c1 |
@end deftypefun
|