[GitHub/mt8127/android_kernel_alcatel_ttab.git] / include / linux / key-ui.h

/* key-ui.h: key userspace interface stuff
 *
 * Copyright (C) 2004 Red Hat, Inc. All Rights Reserved.
 * Written by David Howells (dhowells@redhat.com)
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License
 * as published by the Free Software Foundation; either version
 * 2 of the License, or (at your option) any later version.
 */

#ifndef _LINUX_KEY_UI_H
#define _LINUX_KEY_UI_H

#include <linux/key.h>

/* the key tree */
extern struct rb_root key_serial_tree;
extern spinlock_t key_serial_lock;

/* required permissions */
#define	KEY_VIEW	0x01	/* require permission to view attributes */
#define	KEY_READ	0x02	/* require permission to read content */
#define	KEY_WRITE	0x04	/* require permission to update / modify */
#define	KEY_SEARCH	0x08	/* require permission to search (keyring) or find (key) */
#define	KEY_LINK	0x10	/* require permission to link */
#define	KEY_SETATTR	0x20	/* require permission to change attributes */
#define	KEY_ALL		0x3f	/* all the above permissions */

/*
 * the keyring payload contains a list of the keys to which the keyring is
 * subscribed
 */
struct keyring_list {
	struct rcu_head	rcu;		/* RCU deletion hook */
	unsigned short	maxkeys;	/* max keys this list can hold */
	unsigned short	nkeys;		/* number of keys currently held */
	unsigned short	delkey;		/* key to be unlinked by RCU */
	struct key	*keys[0];
};

/*
 * check to see whether permission is granted to use a key in the desired way
 */
extern int key_task_permission(const key_ref_t key_ref,
			       struct task_struct *context,
			       key_perm_t perm);

static inline int key_permission(const key_ref_t key_ref, key_perm_t perm)
{
	return key_task_permission(key_ref, current, perm);
}

extern key_ref_t lookup_user_key(struct task_struct *context,
				 key_serial_t id, int create, int partial,
				 key_perm_t perm);

extern long join_session_keyring(const char *name);

extern struct key_type *key_type_lookup(const char *type);
extern void key_type_put(struct key_type *ktype);

#define key_negative_timeout	60	/* default timeout on a negative key's existence */


#endif /* _LINUX_KEY_UI_H */
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 */
29db9190 DH	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 */