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 	u8 *digest;
39 	u32 s_size;		/* Number of bytes in signature */
40 	u32 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 *dest_keyring,
54 				      const struct key_type *type,
55 				      const union key_payload *payload,
56 				      struct key *trust_keyring);
57 
58 extern int restrict_link_by_key_or_keyring(struct key *dest_keyring,
59 					   const struct key_type *type,
60 					   const union key_payload *payload,
61 					   struct key *trusted);
62 
63 extern int restrict_link_by_key_or_keyring_chain(struct key *trust_keyring,
64 						 const struct key_type *type,
65 						 const union key_payload *payload,
66 						 struct key *trusted);
67 
68 extern int verify_signature(const struct key *key,
69 			    const struct public_key_signature *sig);
70 
71 int public_key_verify_signature(const struct public_key *pkey,
72 				const struct public_key_signature *sig);
73 
74 #endif /* _LINUX_PUBLIC_KEY_H */
75