LXR linux/include/keys/asymmetric-parser.h

   1/* Asymmetric public-key cryptography data parser
   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_PARSER_H
  15#define _KEYS_ASYMMETRIC_PARSER_H
  16
  17/*
  18 * Key data parser.  Called during key instantiation.
  19 */
  20struct asymmetric_key_parser {
  21        struct list_head        link;
  22        struct module           *owner;
  23        const char              *name;
  24
  25        /* Attempt to parse a key from the data blob passed to add_key() or
  26         * keyctl_instantiate().  Should also generate a proposed description
  27         * that the caller can optionally use for the key.
  28         *
  29         * Return EBADMSG if not recognised.
  30         */
  31        int (*parse)(struct key_preparsed_payload *prep);
  32};
  33
  34extern int register_asymmetric_key_parser(struct asymmetric_key_parser *);
  35extern void unregister_asymmetric_key_parser(struct asymmetric_key_parser *);
  36
  37#endif /* _KEYS_ASYMMETRIC_PARSER_H */
  38