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
|
/*
* keyid.h - Routines to calculate key IDs.
*
* Copyright 2002,2011 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 __KEYID_H__
#define __KEYID_H__
#include <inttypes.h>
#include "keystructs.h"
#include "onak.h"
/**
* fingerprint2keyid - convert a fingerprint to a keyid
* @fingerprint: The fingerprint structure to convert
* @returns: 64 bit keyid
*
* This function returns the key id for a given fingerprint. Currently
* only works for v4 fingerprints.
*/
uint64_t fingerprint2keyid(struct openpgp_fingerprint *fingerprint);
/**
* get_keyid - Given a public key returns the keyid.
* @publickey: The key to calculate the id for.
* @keeyid: The returned keyid
*
* This function returns the key id for a given public key.
*/
onak_status_t get_keyid(struct openpgp_publickey *publickey, uint64_t *keyid);
/**
* get_fingerprint - Given a public key returns the fingerprint.
* @publickey: The key to calculate the id for.
* @fingerprint: The fingerprint structure to store the result in
*
* This function returns the fingerprint for a given public key. As Type 3
* fingerprints are 16 bytes and Type 4 are 20 the len field indicates
* which we've returned.
*/
onak_status_t get_fingerprint(struct openpgp_packet *packet,
struct openpgp_fingerprint *fingerprint);
/**
* get_packetid - Given a PGP packet returns the keyid.
* @packet: The packet to calculate the id for.
* @keyid: The returned keyid
*
* This function returns the key id for a given PGP packet.
*/
onak_status_t get_packetid(struct openpgp_packet *packet, uint64_t *keyid);
/**
* get_skshash - Given a public key returns the SKS hash for it.
* @publickey: The key to calculate the hash for.
* @skshash: Hash structure to sort the result in.
*
* This function returns the SKS hash for a given public key. This
* is an MD5 hash over a sorted list of all of the packets that
* make up the key. The caller should allocate the memory for the
* hash.
*/
onak_status_t get_skshash(struct openpgp_publickey *publickey,
struct skshash *hash);
/**
* parse_skshash - Parse a string into an SKS hash structure.
* @search: The string representing the SKS hash.
* @hash: A pointer to the structure to store the hash in.
*
* Takes a string and tries to parse it as an SKS hash hex
* representation. Puts the hash into the supplied structure
* if successful. Returns 1 if we parsed something ok, 0 if
* we failed.
*/
int parse_skshash(char *search, struct skshash *hash);
#endif /* __KEYID_H__ */
|
