xref: /linux/include/crypto/public_key.h (revision f3a8b6645dc2e60d11f20c1c23afd964ff4e55ae)
1 /* Asymmetric public-key algorithm definitions
2  *
3  * See Documentation/crypto/asymmetric-keys.txt
4  *
5  * Copyright (C) 2012 Red Hat, Inc. All Rights Reserved.
6  * Written by David Howells (dhowells@redhat.com)
7  *
8  * This program is free software; you can redistribute it and/or
9  * modify it under the terms of the GNU General Public Licence
10  * as published by the Free Software Foundation; either version
11  * 2 of the Licence, or (at your option) any later version.
12  */
13 
14 #ifndef _LINUX_PUBLIC_KEY_H
15 #define _LINUX_PUBLIC_KEY_H
16 
17 /*
18  * Cryptographic data for the public-key subtype of the asymmetric key type.
19  *
20  * Note that this may include private part of the key as well as the public
21  * part.
22  */
23 struct public_key {
24 	void *key;
25 	u32 keylen;
26 	const char *id_type;
27 	const char *pkey_algo;
28 };
29 
30 extern void public_key_free(struct public_key *key);
31 
32 /*
33  * Public key cryptography signature data
34  */
35 struct public_key_signature {
36 	struct asymmetric_key_id *auth_ids[2];
37 	u8 *s;			/* Signature */
38 	u32 s_size;		/* Number of bytes in signature */
39 	u8 *digest;
40 	u8 digest_size;		/* Number of bytes in digest */
41 	const char *pkey_algo;
42 	const char *hash_algo;
43 };
44 
45 extern void public_key_signature_free(struct public_key_signature *sig);
46 
47 extern struct asymmetric_key_subtype public_key_subtype;
48 
49 struct key;
50 struct key_type;
51 union key_payload;
52 
53 extern int restrict_link_by_signature(struct key *trust_keyring,
54 				      const struct key_type *type,
55 				      const union key_payload *payload);
56 
57 extern int verify_signature(const struct key *key,
58 			    const struct public_key_signature *sig);
59 
60 int public_key_verify_signature(const struct public_key *pkey,
61 				const struct public_key_signature *sig);
62 
63 #endif /* _LINUX_PUBLIC_KEY_H */
64