1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
|
/*
Copyright (C) 2006-2007 Werner Dittmann
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
/**
* Functions to compute SHA384 digest.
*
* @author: Werner Dittmann <Werner.Dittmann@t-online.de>
*/
#ifndef _SHA384_H
#define _SHA384_H
/**
* @file sha384.h
* @brief Function that provide SHA384 support
*
* @ingroup GNU_ZRTP
* @{
*/
#include <stdint.h>
#ifndef SHA384_DIGEST_LENGTH
#define SHA384_DIGEST_LENGTH 48
#endif
/**
* Compute SHA384 digest.
*
* This functions takes one data chunk and computes its SHA384 digest. This
* function creates and deletes an own SHA384 context to perform the SHA384
* operations.
*
* @param data
* Points to the data chunk.
* @param data_length
* Length of the data in bytes
* @param digest
* Points to a buffer that receives the computed digest. This
* buffer must have a size of at least 48 bytes (SHA384_DIGEST_LENGTH).
*/
void sha384(unsigned char *data,
unsigned int data_length,
unsigned char *digest);
/**
* Compute SHA384 digest over several data cunks.
*
* This functions takes several data chunks and computes the SHA384 digest.
* This function creates and deletes an own SHA384 context to perform the
* SHA384 operations.
*
* @param data
* Points to an array of pointers that point to the data chunks. A NULL
* pointer in an array element terminates the data chunks.
* @param data_length
* Points to an array of integers that hold the length of each data chunk.
* @param digest
* Points to a buffer that receives the computed digest. This
* buffer must have a size of at least 48 bytes (SHA384_DIGEST_LENGTH).
*/
void sha384(unsigned char *data[],
unsigned int data_length[],
unsigned char *digest);
/**
* Create and initialize a SHA384 context.
*
* An application uses this context to hash several data into one SHA384
* digest. See also sha384Ctx(...) and closeSha384Context(...).
*
* @return Returns a pointer to the initialized SHA384 context
*/
void* createSha384Context();
/**
* Compute a digest and close the SHA384 digest.
*
* An application uses this function to compute the SHA384 digest and to
* close the SHA384 context.
*
* @param ctx
* Points to the SHA384 context.
* @param digest
* If this pointer is not NULL then it must point to a byte array that
* is big enough to hold the SHA384 digest (384 bit = 48 Bytes). If this
* pointer is NULL then the functions does not compute the digest but
* closes the context only. The context cannot be used anymore.
*/
void closeSha384Context(void* ctx,
unsigned char* digest);
/**
* Update the SHA384 context with data.
*
* This functions updates the SHA384 context with some data.
* See also CloseSha384Context(...) how to get the digest.
*
* @param ctx
* Points to the SHA384 context.
* @param data
* Points to the data to update the context.
* @param dataLength
* The length of the data in bytes.
*/
void sha384Ctx(void* ctx, unsigned char* data,
unsigned int dataLength);
/**
* Update the SHA384 context with several data chunks.
*
* This functions updates the SHA384 context with some data.
* See also CloseSha384Context(...) how to get the digest.
*
* @param ctx
* Points to the SHA384 context.
* @param dataChunks
* Points to an array of pointers that point to the data chunks. A NULL
* pointer in an array element terminates the data chunks.
* @param dataChunkLength
* Points to an array of integers that hold the length of each data chunk.
*
*/
void sha384Ctx(void* ctx, unsigned char* dataChunks[],
unsigned int dataChunkLength[]);
/**
* @}
*/
#endif
|
