[thirdparty/kernel/linux.git] / include / keys / asymmetric-parser.h

/* SPDX-License-Identifier: GPL-2.0-or-later */
/* Asymmetric public-key cryptography data parser
 *
 * See Documentation/crypto/asymmetric-keys.rst
 *
 * Copyright (C) 2012 Red Hat, Inc. All Rights Reserved.
 * Written by David Howells (dhowells@redhat.com)
 */

#ifndef _KEYS_ASYMMETRIC_PARSER_H
#define _KEYS_ASYMMETRIC_PARSER_H

struct key_preparsed_payload;

/*
 * Key data parser.  Called during key instantiation.
 */
struct asymmetric_key_parser {
	struct list_head	link;
	struct module		*owner;
	const char		*name;

	/* Attempt to parse a key from the data blob passed to add_key() or
	 * keyctl_instantiate().  Should also generate a proposed description
	 * that the caller can optionally use for the key.
	 *
	 * Return EBADMSG if not recognised.
	 */
	int (*parse)(struct key_preparsed_payload *prep);
};

extern int register_asymmetric_key_parser(struct asymmetric_key_parser *);
extern void unregister_asymmetric_key_parser(struct asymmetric_key_parser *);

#endif /* _KEYS_ASYMMETRIC_PARSER_H */
Commit	Line	Data
b4d0d230	1	/* SPDX-License-Identifier: GPL-2.0-or-later */
46c6f177 DH	2	/* Asymmetric public-key cryptography data parser
46c6f177 DH	3	*
0efaaa86	4	* See Documentation/crypto/asymmetric-keys.rst
46c6f177 DH	5	*
	6	* Copyright (C) 2012 Red Hat, Inc. All Rights Reserved.
	7	* Written by David Howells (dhowells@redhat.com)
46c6f177 DH	8	*/
	9
	10	#ifndef _KEYS_ASYMMETRIC_PARSER_H
	11	#define _KEYS_ASYMMETRIC_PARSER_H
	12
b6d0695b HX	13	struct key_preparsed_payload;
b6d0695b HX	14
46c6f177 DH	15	/*
	16	* Key data parser. Called during key instantiation.
	17	*/
	18	struct asymmetric_key_parser {
	19	struct list_head link;
	20	struct module *owner;
	21	const char *name;
	22
	23	/* Attempt to parse a key from the data blob passed to add_key() or
	24	* keyctl_instantiate(). Should also generate a proposed description
	25	* that the caller can optionally use for the key.
	26	*
	27	* Return EBADMSG if not recognised.
	28	*/
	29	int (parse)(struct key_preparsed_payload prep);
	30	};
	31
	32	extern int register_asymmetric_key_parser(struct asymmetric_key_parser *);
	33	extern void unregister_asymmetric_key_parser(struct asymmetric_key_parser *);
	34
	35	#endif /* _KEYS_ASYMMETRIC_PARSER_H */