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