1 /* SPDX-License-Identifier: GPL-2.0-or-later */ 2 /* Asymmetric public-key cryptography key subtype 3 * 4 * See Documentation/crypto/asymmetric-keys.rst 5 * 6 * Copyright (C) 2012 Red Hat, Inc. All Rights Reserved. 7 * Written by David Howells (dhowells@redhat.com) 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 16 struct kernel_pkey_query; 17 struct kernel_pkey_params; 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 */ 33 void (*destroy)(void *payload_crypto, void *payload_auth); 34 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 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 { 57 return key->payload.data[asym_subtype]; 58 } 59 60 #endif /* _KEYS_ASYMMETRIC_SUBTYPE_H */ 61