nettle-types.h 3.46 KB
Newer Older
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
/* nettle-types.h

   Copyright (C) 2005, 2014 Niels Möller

   This file is part of GNU Nettle.

   GNU Nettle is free software: you can redistribute it and/or
   modify it under the terms of either:

     * the GNU Lesser General Public License as published by the Free
       Software Foundation; either version 3 of the License, or (at your
       option) any later version.

   or

     * the GNU General Public License as published by the Free
       Software Foundation; either version 2 of the License, or (at your
       option) any later version.

   or both in parallel, as here.

   GNU Nettle 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 copies of the GNU General Public License and
   the GNU Lesser General Public License along with this program.  If
   not, see http://www.gnu.org/licenses/.
*/
31 32 33 34

#ifndef NETTLE_TYPES_H
#define NETTLE_TYPES_H

35 36
/* For size_t */
#include <stddef.h>
Niels Möller's avatar
Niels Möller committed
37
#include <stdint.h>
38

39 40 41
/* Attributes we want to use in installed header files, and hence
   can't rely on config.h. */
#ifdef __GNUC__
Niels Möller's avatar
Niels Möller committed
42

43
#define _NETTLE_ATTRIBUTE_PURE __attribute__((pure))
Niels Möller's avatar
Niels Möller committed
44 45 46 47 48
#ifndef _NETTLE_ATTRIBUTE_DEPRECATED
/* Variant without message is supported since gcc-3.1 or so. */
#define _NETTLE_ATTRIBUTE_DEPRECATED __attribute__((deprecated))
#endif

49
#else /* !__GNUC__ */
Niels Möller's avatar
Niels Möller committed
50

51
#define _NETTLE_ATTRIBUTE_PURE
Niels Möller's avatar
Niels Möller committed
52 53
#define _NETTLE_ATTRIBUTE_DEPRECATED

54
#endif /* !__GNUC__ */
Niels Möller's avatar
Niels Möller committed
55

Niels Möller's avatar
Niels Möller committed
56 57 58 59
#ifdef __cplusplus
extern "C" {
#endif

Niels Möller's avatar
Niels Möller committed
60 61 62 63 64
/* An aligned 16-byte block. */
union nettle_block16
{
  uint8_t b[16];
  unsigned long w[16 / sizeof(unsigned long)];
65
  uint64_t u64[2];
Niels Möller's avatar
Niels Möller committed
66 67
};

68
/* Randomness. Used by key generation and dsa signature creation. */
69
typedef void nettle_random_func(void *ctx,
70
				size_t length, uint8_t *dst);
71 72

/* Progress report function, mainly for key generation. */
73 74 75
typedef void nettle_progress_func(void *ctx, int c);

/* Realloc function, used by struct nettle_buffer. */
76
typedef void *nettle_realloc_func(void *ctx, void *p, size_t length);
77 78

/* Ciphers */
79
typedef void nettle_set_key_func(void *ctx, const uint8_t *key);
80

81 82 83 84
/* For block ciphers, const context. */
typedef void nettle_cipher_func(const void *ctx,
				size_t length, uint8_t *dst,
				const uint8_t *src);
85 86


87 88
/* Uses a void * for cipher contexts. Used for crypt operations where
   the internal state changes during the encryption. */
89
typedef void nettle_crypt_func(void *ctx,
90
			       size_t length, uint8_t *dst,
91
			       const uint8_t *src);
92 93

/* Hash algorithms */
94 95
typedef void nettle_hash_init_func(void *ctx);
typedef void nettle_hash_update_func(void *ctx,
96
				     size_t length,
97 98
				     const uint8_t *src);
typedef void nettle_hash_digest_func(void *ctx,
99
				     size_t length, uint8_t *dst);
100 101 102

/* ASCII armor codecs. NOTE: Experimental and subject to change. */

103
typedef size_t nettle_armor_length_func(size_t length);
104
typedef void nettle_armor_init_func(void *ctx);
105

106
typedef size_t nettle_armor_encode_update_func(void *ctx,
107
					       char *dst,
108 109
					       size_t src_length,
					       const uint8_t *src);
110

111
typedef size_t nettle_armor_encode_final_func(void *ctx, char *dst);
112

113
typedef int nettle_armor_decode_update_func(void *ctx,
114
					    size_t *dst_length,
115
					    uint8_t *dst,
116
					    size_t src_length,
117
					    const char *src);
118

119
typedef int nettle_armor_decode_final_func(void *ctx);
120

Niels Möller's avatar
Niels Möller committed
121 122 123
#ifdef __cplusplus
}
#endif
124

Niels Möller's avatar
Niels Möller committed
125
#endif /* NETTLE_TYPES_H */