| 1 |
62 |
marcus.erl |
/* 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 */
|
