]>
Commit | Line | Data |
---|---|---|
2874c5fd | 1 | /* SPDX-License-Identifier: GPL-2.0-or-later */ |
2aa349f6 DH |
2 | /* user-type.h: User-defined key type |
3 | * | |
4 | * Copyright (C) 2005 Red Hat, Inc. All Rights Reserved. | |
5 | * Written by David Howells (dhowells@redhat.com) | |
2aa349f6 DH |
6 | */ |
7 | ||
8 | #ifndef _KEYS_USER_TYPE_H | |
9 | #define _KEYS_USER_TYPE_H | |
10 | ||
11 | #include <linux/key.h> | |
12 | #include <linux/rcupdate.h> | |
13 | ||
146aa8b1 DH |
14 | #ifdef CONFIG_KEYS |
15 | ||
2aa349f6 DH |
16 | /*****************************************************************************/ |
17 | /* | |
9f6ed2ca | 18 | * the payload for a key of type "user" or "logon" |
2aa349f6 DH |
19 | * - once filled in and attached to a key: |
20 | * - the payload struct is invariant may not be changed, only replaced | |
21 | * - the payload must be read with RCU procedures or with the key semaphore | |
22 | * held | |
23 | * - the payload may only be replaced with the key semaphore write-locked | |
24 | * - the key's data length is the size of the actual data, not including the | |
25 | * payload wrapper | |
26 | */ | |
27 | struct user_key_payload { | |
28 | struct rcu_head rcu; /* RCU destructor */ | |
29 | unsigned short datalen; /* length of this data */ | |
cc1780fc | 30 | char data[0] __aligned(__alignof__(u64)); /* actual data */ |
2aa349f6 DH |
31 | }; |
32 | ||
33 | extern struct key_type key_type_user; | |
9f6ed2ca | 34 | extern struct key_type key_type_logon; |
2aa349f6 | 35 | |
cf7f601c DH |
36 | struct key_preparsed_payload; |
37 | ||
f9167789 DH |
38 | extern int user_preparse(struct key_preparsed_payload *prep); |
39 | extern void user_free_preparse(struct key_preparsed_payload *prep); | |
cf7f601c | 40 | extern int user_update(struct key *key, struct key_preparsed_payload *prep); |
31204ed9 | 41 | extern void user_revoke(struct key *key); |
2aa349f6 DH |
42 | extern void user_destroy(struct key *key); |
43 | extern void user_describe(const struct key *user, struct seq_file *m); | |
44 | extern long user_read(const struct key *key, | |
45 | char __user *buffer, size_t buflen); | |
46 | ||
0837e49a | 47 | static inline const struct user_key_payload *user_key_payload_rcu(const struct key *key) |
146aa8b1 | 48 | { |
0837e49a DH |
49 | return (struct user_key_payload *)dereference_key_rcu(key); |
50 | } | |
51 | ||
52 | static inline struct user_key_payload *user_key_payload_locked(const struct key *key) | |
53 | { | |
54 | return (struct user_key_payload *)dereference_key_locked((struct key *)key); | |
146aa8b1 DH |
55 | } |
56 | ||
57 | #endif /* CONFIG_KEYS */ | |
2aa349f6 DH |
58 | |
59 | #endif /* _KEYS_USER_TYPE_H */ |