Commit | Line | Data |
---|---|---|
3e30148c | 1 | /* key-ui.h: key userspace interface stuff |
1da177e4 LT |
2 | * |
3 | * Copyright (C) 2004 Red Hat, Inc. All Rights Reserved. | |
4 | * Written by David Howells (dhowells@redhat.com) | |
5 | * | |
6 | * This program is free software; you can redistribute it and/or | |
7 | * modify it under the terms of the GNU General Public License | |
8 | * as published by the Free Software Foundation; either version | |
9 | * 2 of the License, or (at your option) any later version. | |
10 | */ | |
11 | ||
12 | #ifndef _LINUX_KEY_UI_H | |
13 | #define _LINUX_KEY_UI_H | |
14 | ||
15 | #include <linux/key.h> | |
16 | ||
17 | /* the key tree */ | |
18 | extern struct rb_root key_serial_tree; | |
19 | extern spinlock_t key_serial_lock; | |
20 | ||
21 | /* required permissions */ | |
22 | #define KEY_VIEW 0x01 /* require permission to view attributes */ | |
23 | #define KEY_READ 0x02 /* require permission to read content */ | |
24 | #define KEY_WRITE 0x04 /* require permission to update / modify */ | |
25 | #define KEY_SEARCH 0x08 /* require permission to search (keyring) or find (key) */ | |
26 | #define KEY_LINK 0x10 /* require permission to link */ | |
29db9190 DH |
27 | #define KEY_SETATTR 0x20 /* require permission to change attributes */ |
28 | #define KEY_ALL 0x3f /* all the above permissions */ | |
1da177e4 LT |
29 | |
30 | /* | |
31 | * the keyring payload contains a list of the keys to which the keyring is | |
32 | * subscribed | |
33 | */ | |
34 | struct keyring_list { | |
76d8aeab DH |
35 | struct rcu_head rcu; /* RCU deletion hook */ |
36 | unsigned short maxkeys; /* max keys this list can hold */ | |
37 | unsigned short nkeys; /* number of keys currently held */ | |
38 | unsigned short delkey; /* key to be unlinked by RCU */ | |
1da177e4 LT |
39 | struct key *keys[0]; |
40 | }; | |
41 | ||
1da177e4 LT |
42 | /* |
43 | * check to see whether permission is granted to use a key in the desired way | |
44 | */ | |
468ed2b0 DH |
45 | extern int key_task_permission(const key_ref_t key_ref, |
46 | struct task_struct *context, | |
47 | key_perm_t perm); | |
1da177e4 | 48 | |
468ed2b0 | 49 | static inline int key_permission(const key_ref_t key_ref, key_perm_t perm) |
3e30148c | 50 | { |
468ed2b0 | 51 | return key_task_permission(key_ref, current, perm); |
3e30148c | 52 | } |
1da177e4 | 53 | |
664cceb0 DH |
54 | extern key_ref_t lookup_user_key(struct task_struct *context, |
55 | key_serial_t id, int create, int partial, | |
56 | key_perm_t perm); | |
1da177e4 LT |
57 | |
58 | extern long join_session_keyring(const char *name); | |
59 | ||
60 | extern struct key_type *key_type_lookup(const char *type); | |
61 | extern void key_type_put(struct key_type *ktype); | |
62 | ||
63 | #define key_negative_timeout 60 /* default timeout on a negative key's existence */ | |
64 | ||
65 | ||
66 | #endif /* _LINUX_KEY_UI_H */ |