blob: 21407815d9c3a0aa603428733cd246d017f18a1d [file] [log] [blame]
Thomas Gleixnerb4d0d232019-05-20 19:08:01 +02001/* SPDX-License-Identifier: GPL-2.0-or-later */
David Howells964f3b32012-09-13 15:17:21 +01002/* Asymmetric public-key cryptography key subtype
3 *
Mauro Carvalho Chehab5fb94e92018-05-08 15:14:57 -03004 * See Documentation/crypto/asymmetric-keys.txt
David Howells964f3b32012-09-13 15:17:21 +01005 *
6 * Copyright (C) 2012 Red Hat, Inc. All Rights Reserved.
7 * Written by David Howells (dhowells@redhat.com)
David Howells964f3b32012-09-13 15:17:21 +01008 */
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 Howells5a307712018-10-09 17:47:07 +010016struct kernel_pkey_query;
17struct kernel_pkey_params;
David Howells964f3b32012-09-13 15:17:21 +010018struct public_key_signature;
19
20/*
21 * Keys of this type declare a subtype that indicates the handlers and
22 * capabilities.
23 */
24struct 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 Howells3b764562016-04-06 16:13:33 +010033 void (*destroy)(void *payload_crypto, void *payload_auth);
David Howells964f3b32012-09-13 15:17:21 +010034
David Howells5a307712018-10-09 17:47:07 +010035 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 Howells964f3b32012-09-13 15:17:21 +010042 /* 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 */
54static inline
55struct asymmetric_key_subtype *asymmetric_key_subtype(const struct key *key)
56{
David Howells146aa8b2015-10-21 14:04:48 +010057 return key->payload.data[asym_subtype];
David Howells964f3b32012-09-13 15:17:21 +010058}
59
60#endif /* _KEYS_ASYMMETRIC_SUBTYPE_H */