Coverage Report

Created: 2025-03-18 06:55

/src/gnutls/lib/fingerprint.c
Line
Count
Source (jump to first uncovered line)
1
/*
2
 * Copyright (C) 2001-2012 Free Software Foundation, Inc.
3
 *
4
 * Author: Nikos Mavrogiannopoulos
5
 *
6
 * This file is part of GnuTLS.
7
 *
8
 * The GnuTLS is free software; you can redistribute it and/or
9
 * modify it under the terms of the GNU Lesser General Public License
10
 * as published by the Free Software Foundation; either version 2.1 of
11
 * the License, or (at your option) any later version.
12
 *
13
 * This library is distributed in the hope that it will be useful, but
14
 * WITHOUT ANY WARRANTY; without even the implied warranty of
15
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
16
 * Lesser General Public License for more details.
17
 *
18
 * You should have received a copy of the GNU Lesser General Public License
19
 * along with this program.  If not, see <https://www.gnu.org/licenses/>
20
 *
21
 */
22
23
#include "gnutls_int.h"
24
#include "auth/srp_kx.h"
25
#include "auth/anon.h"
26
#include "auth/cert.h"
27
#include "auth/psk.h"
28
#include "errors.h"
29
#include "auth.h"
30
#include "state.h"
31
#include "datum.h"
32
#include "algorithms.h"
33
34
/**
35
 * gnutls_fingerprint:
36
 * @algo: is a digest algorithm
37
 * @data: is the data
38
 * @result: is the place where the result will be copied (may be null).
39
 * @result_size: should hold the size of the result. The actual size
40
 * of the returned result will also be copied there.
41
 *
42
 * This function will calculate a fingerprint (actually a hash), of
43
 * the given data.  The result is not printable data.  You should
44
 * convert it to hex, or to something else printable.
45
 *
46
 * This is the usual way to calculate a fingerprint of an X.509 DER
47
 * encoded certificate.  Note however that the fingerprint of an
48
 * OpenPGP certificate is not just a hash and cannot be calculated with this
49
 * function.
50
 *
51
 * Returns: On success, %GNUTLS_E_SUCCESS (0) is returned, otherwise
52
 *   an error code is returned.
53
 **/
54
int gnutls_fingerprint(gnutls_digest_algorithm_t algo,
55
           const gnutls_datum_t *data, void *result,
56
           size_t *result_size)
57
0
{
58
0
  int ret;
59
0
  int hash_len = _gnutls_hash_get_algo_len(hash_to_entry(algo));
60
61
0
  if (hash_len < 0 || (unsigned)hash_len > *result_size ||
62
0
      result == NULL) {
63
0
    *result_size = hash_len;
64
0
    return GNUTLS_E_SHORT_MEMORY_BUFFER;
65
0
  }
66
0
  *result_size = hash_len;
67
68
0
  if (result) {
69
0
    ret = _gnutls_hash_fast(algo, data->data, data->size, result);
70
0
    if (ret < 0)
71
0
      return gnutls_assert_val(ret);
72
0
  }
73
74
0
  return 0;
75
0
}