1 /* key-ui.h: key userspace interface stuff |
|
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 */ |
|
27 #define KEY_SETATTR 0x20 /* require permission to change attributes */ |
|
28 #define KEY_ALL 0x3f /* all the above permissions */ |
|
29 |
|
30 /* |
|
31 * the keyring payload contains a list of the keys to which the keyring is |
|
32 * subscribed |
|
33 */ |
|
34 struct keyring_list { |
|
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 */ |
|
39 struct key *keys[0]; |
|
40 }; |
|
41 |
|
42 /* |
|
43 * check to see whether permission is granted to use a key in the desired way |
|
44 */ |
|
45 extern int key_task_permission(const key_ref_t key_ref, |
|
46 struct task_struct *context, |
|
47 key_perm_t perm); |
|
48 |
|
49 static inline int key_permission(const key_ref_t key_ref, key_perm_t perm) |
|
50 { |
|
51 return key_task_permission(key_ref, current, perm); |
|
52 } |
|
53 |
|
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); |
|
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 */ |
|