Thomas Gleixner | b4d0d23 | 2019-05-20 19:08:01 +0200 | [diff] [blame] | 1 | /* SPDX-License-Identifier: GPL-2.0-or-later */ |
David Howells | 964f3b3 | 2012-09-13 15:17:21 +0100 | [diff] [blame] | 2 | /* Asymmetric public-key cryptography key subtype |
| 3 | * |
Mauro Carvalho Chehab | 5fb94e9 | 2018-05-08 15:14:57 -0300 | [diff] [blame] | 4 | * See Documentation/crypto/asymmetric-keys.txt |
David Howells | 964f3b3 | 2012-09-13 15:17:21 +0100 | [diff] [blame] | 5 | * |
| 6 | * Copyright (C) 2012 Red Hat, Inc. All Rights Reserved. |
| 7 | * Written by David Howells (dhowells@redhat.com) |
David Howells | 964f3b3 | 2012-09-13 15:17:21 +0100 | [diff] [blame] | 8 | */ |
| 9 | |
| 10 | #ifndef _KEYS_ASYMMETRIC_SUBTYPE_H |
| 11 | #define _KEYS_ASYMMETRIC_SUBTYPE_H |
| 12 | |
| 13 | #include <linux/seq_file.h> |
| 14 | #include <keys/asymmetric-type.h> |
| 15 | |
David Howells | 5a30771 | 2018-10-09 17:47:07 +0100 | [diff] [blame] | 16 | struct kernel_pkey_query; |
| 17 | struct kernel_pkey_params; |
David Howells | 964f3b3 | 2012-09-13 15:17:21 +0100 | [diff] [blame] | 18 | struct public_key_signature; |
| 19 | |
| 20 | /* |
| 21 | * Keys of this type declare a subtype that indicates the handlers and |
| 22 | * capabilities. |
| 23 | */ |
| 24 | struct asymmetric_key_subtype { |
| 25 | struct module *owner; |
| 26 | const char *name; |
| 27 | unsigned short name_len; /* length of name */ |
| 28 | |
| 29 | /* Describe a key of this subtype for /proc/keys */ |
| 30 | void (*describe)(const struct key *key, struct seq_file *m); |
| 31 | |
| 32 | /* Destroy a key of this subtype */ |
David Howells | 3b76456 | 2016-04-06 16:13:33 +0100 | [diff] [blame] | 33 | void (*destroy)(void *payload_crypto, void *payload_auth); |
David Howells | 964f3b3 | 2012-09-13 15:17:21 +0100 | [diff] [blame] | 34 | |
David Howells | 5a30771 | 2018-10-09 17:47:07 +0100 | [diff] [blame] | 35 | int (*query)(const struct kernel_pkey_params *params, |
| 36 | struct kernel_pkey_query *info); |
| 37 | |
| 38 | /* Encrypt/decrypt/sign data */ |
| 39 | int (*eds_op)(struct kernel_pkey_params *params, |
| 40 | const void *in, void *out); |
| 41 | |
David Howells | 964f3b3 | 2012-09-13 15:17:21 +0100 | [diff] [blame] | 42 | /* Verify the signature on a key of this subtype (optional) */ |
| 43 | int (*verify_signature)(const struct key *key, |
| 44 | const struct public_key_signature *sig); |
| 45 | }; |
| 46 | |
| 47 | /** |
| 48 | * asymmetric_key_subtype - Get the subtype from an asymmetric key |
| 49 | * @key: The key of interest. |
| 50 | * |
| 51 | * Retrieves and returns the subtype pointer of the asymmetric key from the |
| 52 | * type-specific data attached to the key. |
| 53 | */ |
| 54 | static inline |
| 55 | struct asymmetric_key_subtype *asymmetric_key_subtype(const struct key *key) |
| 56 | { |
David Howells | 146aa8b | 2015-10-21 14:04:48 +0100 | [diff] [blame] | 57 | return key->payload.data[asym_subtype]; |
David Howells | 964f3b3 | 2012-09-13 15:17:21 +0100 | [diff] [blame] | 58 | } |
| 59 | |
| 60 | #endif /* _KEYS_ASYMMETRIC_SUBTYPE_H */ |