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
|
/**
* @file keystructs.h
* @brief Structures for OpenPGP keys
*
* Copyright 2002 Jonathan McDowell <noodles@earth.li>
*
* 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; version 2 of the License.
*
* 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 <https://www.gnu.org/licenses/>.
*/
#ifndef __KEYSTRUCTS_H__
#define __KEYSTRUCTS_H__
#include <inttypes.h>
#include <stdbool.h>
#include <stdlib.h>
#include "ll.h"
/*
* Fingerprint lengths
*
* v3 MD5 fingerprint is 16 bytes
* v4 SHA-1 fingerprint is 20
* v5 SHA2-256 fingerprint is 32
*/
#define FINGERPRINT_V3_LEN 16
#define FINGERPRINT_V4_LEN 20
#define FINGERPRINT_V5_LEN 32
#define MAX_FINGERPRINT_LEN 32
/**
* @brief Stores the fingerprint of an OpenPGP key
*/
struct openpgp_fingerprint {
/** Length of fingerprint. 16 bytes for v3, 20 for v4 */
size_t length;
/** Fingerprint data. Only the first length bytes are valid */
uint8_t fp[MAX_FINGERPRINT_LEN];
};
/**
* @brief Stores an OpenPGP packet.
*
* This structure holds any form of OpenPGP packet with minimum common
* details decoded out.
*/
struct openpgp_packet {
/** The packet tag (i.e. type). */
unsigned int tag;
/** Indicates if this is a new format packet. */
bool newformat;
/** The length of the packet. */
size_t length;
/** The actual packet data. */
unsigned char *data;
};
/**
* @brief A linked list of OpenPGP packets.
*
* This structure is used to hold a linked list of packets, for example
* all the signatures of a public key's UID.
*/
struct openpgp_packet_list {
/** The actual packet structure. */
struct openpgp_packet *packet;
/** A pointer to the next packet in the list. */
struct openpgp_packet_list *next;
};
/**
* @brief A packet with signatures.
*
* This structure holds an OpenPGP packet along with signatures that are
* over this packet. It also links to the next signed packet. It's usually
* used to hold a UID or subkey with their associated signatures.
*/
struct openpgp_signedpacket_list {
/** The OpenPGP packet that's signed. */
struct openpgp_packet *packet;
/** A linked list of sigs for the packet. */
struct openpgp_packet_list *sigs;
/** Pointer to the last sig in the sigs linked list */
struct openpgp_packet_list *last_sig;
/** A pointer to the next packet with signatures. */
struct openpgp_signedpacket_list *next;
};
/**
* @brief An OpenPGP public key complete with sigs.
*/
struct openpgp_publickey {
/** The OpenPGP packet for the public key. */
struct openpgp_packet *publickey;
/** True if the key is revoked. */
bool revoked;
/** Any signatures directly on the @a publickey packet. */
struct openpgp_packet_list *sigs;
/** Pointer to the end of the @a sigs list */
struct openpgp_packet_list *last_sig;
/** The list of UIDs with signatures for this key. */
struct openpgp_signedpacket_list *uids;
/** Pointer to the end of the @a uids list */
struct openpgp_signedpacket_list *last_uid;
/** The list of subkeys with signatures for this key. */
struct openpgp_signedpacket_list *subkeys;
/** Pointer to the end of the @a subkey list */
struct openpgp_signedpacket_list *last_subkey;
/** The next public key. */
struct openpgp_publickey *next;
};
/**
* @brief Holds an SKS key hash (md5 over sorted packet list)
*/
struct skshash {
/** The 128 bit MD5 hash of the sorted packet list from the key */
uint8_t hash[16];
};
#endif /* __KEYSTRUCTS_H__ */
|
