include/keys/asymmetric-subtype.h

   1 /* Asymmetric public-key cryptography key subtype
   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 _KEYS_ASYMMETRIC_SUBTYPE_H
  15 #define _KEYS_ASYMMETRIC_SUBTYPE_H
  16
  17 #include <linux/seq_file.h>
  18 #include <keys/asymmetric-type.h>
  19
  20 struct kernel_pkey_query;
  21 struct kernel_pkey_params;
  22 struct public_key_signature;
  23
  24 /*
  25  * Keys of this type declare a subtype that indicates the handlers and
  26  * capabilities.
  27  */
  28 struct asymmetric_key_subtype {
  29         struct module           *owner;
  30         const char              *name;
  31         unsigned short          name_len;       /* length of name */
  32
  33         /* Describe a key of this subtype for /proc/keys */
  34         void (*describe)(const struct key *key, struct seq_file *m);
  35
  36         /* Destroy a key of this subtype */
  37         void (*destroy)(void *payload_crypto, void *payload_auth);
  38
  39         int (*query)(const struct kernel_pkey_params *params,
  40                      struct kernel_pkey_query *info);
  41
  42         /* Encrypt/decrypt/sign data */
  43         int (*eds_op)(struct kernel_pkey_params *params,
  44                       const void *in, void *out);
  45
  46         /* Verify the signature on a key of this subtype (optional) */
  47         int (*verify_signature)(const struct key *key,
  48                                 const struct public_key_signature *sig);
  49 };
  50
  51 /**
  52  * asymmetric_key_subtype - Get the subtype from an asymmetric key
  53  * @key: The key of interest.
  54  *
  55  * Retrieves and returns the subtype pointer of the asymmetric key from the
  56  * type-specific data attached to the key.
  57  */
  58 static inline
  59 struct asymmetric_key_subtype *asymmetric_key_subtype(const struct key *key)
  60 {
  61         return key->payload.data[asym_subtype];
  62 }
  63
  64 #endif /* _KEYS_ASYMMETRIC_SUBTYPE_H */