xref: /freebsd/crypto/krb5/doc/html/_sources/appdev/refs/api/krb5_c_verify_checksum_iov.rst.txt (revision 7f2fe78b9dd5f51c821d771b63d2e096f6fd49e9)
1krb5_c_verify_checksum_iov -  Validate a checksum element in IOV array (operates on keyblock).
2===============================================================================================
3
4..
5
6.. c:function:: krb5_error_code krb5_c_verify_checksum_iov(krb5_context context, krb5_cksumtype cksumtype, const krb5_keyblock * key, krb5_keyusage usage, const krb5_crypto_iov * data, size_t num_data, krb5_boolean * valid)
7
8..
9
10
11:param:
12
13	          **[in]** **context** - Library context
14
15	          **[in]** **cksumtype** - Checksum type (0 for mandatory type)
16
17	          **[in]** **key** - Encryption key for a keyed checksum
18
19	          **[in]** **usage** - Key usage (see KRB5_KEYUSAGE macros)
20
21	          **[in]** **data** - IOV array
22
23	          **[in]** **num_data** - Size of *data*
24
25	          **[out]** **valid** - Non-zero for success, zero for failure
26
27
28..
29
30
31:retval:
32         -   0   Success; otherwise - Kerberos error codes
33
34
35..
36
37
38
39
40
41
42
43Confirm that the checksum in the #KRB5_CRYPTO_TYPE_CHECKSUM element is a valid checksum of the #KRB5_CRYPTO_TYPE_DATA and #KRB5_CRYPTO_TYPE_SIGN_ONLY regions in the iov.
44
45
46
47
48
49
50
51
52
53
54..
55
56.. seealso::
57         krb5_c_make_checksum_iov()
58
59
60
61
62
63
64.. note::
65
66	 This function is similar to krb5_k_verify_checksum_iov(), but operates on keyblock *key* .
67
68
69
70
71