xref: /linux/kernel/user.c (revision 44f57d78)
1 // SPDX-License-Identifier: GPL-2.0-only
2 /*
3  * The "user cache".
4  *
5  * (C) Copyright 1991-2000 Linus Torvalds
6  *
7  * We have a per-user structure to keep track of how many
8  * processes, files etc the user has claimed, in order to be
9  * able to have per-user limits for system resources.
10  */
11 
12 #include <linux/init.h>
13 #include <linux/sched.h>
14 #include <linux/slab.h>
15 #include <linux/bitops.h>
16 #include <linux/key.h>
17 #include <linux/sched/user.h>
18 #include <linux/interrupt.h>
19 #include <linux/export.h>
20 #include <linux/user_namespace.h>
21 #include <linux/proc_ns.h>
22 
23 /*
24  * userns count is 1 for root user, 1 for init_uts_ns,
25  * and 1 for... ?
26  */
27 struct user_namespace init_user_ns = {
28 	.uid_map = {
29 		.nr_extents = 1,
30 		{
31 			.extent[0] = {
32 				.first = 0,
33 				.lower_first = 0,
34 				.count = 4294967295U,
35 			},
36 		},
37 	},
38 	.gid_map = {
39 		.nr_extents = 1,
40 		{
41 			.extent[0] = {
42 				.first = 0,
43 				.lower_first = 0,
44 				.count = 4294967295U,
45 			},
46 		},
47 	},
48 	.projid_map = {
49 		.nr_extents = 1,
50 		{
51 			.extent[0] = {
52 				.first = 0,
53 				.lower_first = 0,
54 				.count = 4294967295U,
55 			},
56 		},
57 	},
58 	.count = ATOMIC_INIT(3),
59 	.owner = GLOBAL_ROOT_UID,
60 	.group = GLOBAL_ROOT_GID,
61 	.ns.inum = PROC_USER_INIT_INO,
62 #ifdef CONFIG_USER_NS
63 	.ns.ops = &userns_operations,
64 #endif
65 	.flags = USERNS_INIT_FLAGS,
66 #ifdef CONFIG_PERSISTENT_KEYRINGS
67 	.persistent_keyring_register_sem =
68 	__RWSEM_INITIALIZER(init_user_ns.persistent_keyring_register_sem),
69 #endif
70 };
71 EXPORT_SYMBOL_GPL(init_user_ns);
72 
73 /*
74  * UID task count cache, to get fast user lookup in "alloc_uid"
75  * when changing user ID's (ie setuid() and friends).
76  */
77 
78 #define UIDHASH_BITS	(CONFIG_BASE_SMALL ? 3 : 7)
79 #define UIDHASH_SZ	(1 << UIDHASH_BITS)
80 #define UIDHASH_MASK		(UIDHASH_SZ - 1)
81 #define __uidhashfn(uid)	(((uid >> UIDHASH_BITS) + uid) & UIDHASH_MASK)
82 #define uidhashentry(uid)	(uidhash_table + __uidhashfn((__kuid_val(uid))))
83 
84 static struct kmem_cache *uid_cachep;
85 struct hlist_head uidhash_table[UIDHASH_SZ];
86 
87 /*
88  * The uidhash_lock is mostly taken from process context, but it is
89  * occasionally also taken from softirq/tasklet context, when
90  * task-structs get RCU-freed. Hence all locking must be softirq-safe.
91  * But free_uid() is also called with local interrupts disabled, and running
92  * local_bh_enable() with local interrupts disabled is an error - we'll run
93  * softirq callbacks, and they can unconditionally enable interrupts, and
94  * the caller of free_uid() didn't expect that..
95  */
96 static DEFINE_SPINLOCK(uidhash_lock);
97 
98 /* root_user.__count is 1, for init task cred */
99 struct user_struct root_user = {
100 	.__count	= REFCOUNT_INIT(1),
101 	.processes	= ATOMIC_INIT(1),
102 	.sigpending	= ATOMIC_INIT(0),
103 	.locked_shm     = 0,
104 	.uid		= GLOBAL_ROOT_UID,
105 	.ratelimit	= RATELIMIT_STATE_INIT(root_user.ratelimit, 0, 0),
106 };
107 
108 /*
109  * These routines must be called with the uidhash spinlock held!
110  */
111 static void uid_hash_insert(struct user_struct *up, struct hlist_head *hashent)
112 {
113 	hlist_add_head(&up->uidhash_node, hashent);
114 }
115 
116 static void uid_hash_remove(struct user_struct *up)
117 {
118 	hlist_del_init(&up->uidhash_node);
119 }
120 
121 static struct user_struct *uid_hash_find(kuid_t uid, struct hlist_head *hashent)
122 {
123 	struct user_struct *user;
124 
125 	hlist_for_each_entry(user, hashent, uidhash_node) {
126 		if (uid_eq(user->uid, uid)) {
127 			refcount_inc(&user->__count);
128 			return user;
129 		}
130 	}
131 
132 	return NULL;
133 }
134 
135 /* IRQs are disabled and uidhash_lock is held upon function entry.
136  * IRQ state (as stored in flags) is restored and uidhash_lock released
137  * upon function exit.
138  */
139 static void free_user(struct user_struct *up, unsigned long flags)
140 	__releases(&uidhash_lock)
141 {
142 	uid_hash_remove(up);
143 	spin_unlock_irqrestore(&uidhash_lock, flags);
144 	key_put(up->uid_keyring);
145 	key_put(up->session_keyring);
146 	kmem_cache_free(uid_cachep, up);
147 }
148 
149 /*
150  * Locate the user_struct for the passed UID.  If found, take a ref on it.  The
151  * caller must undo that ref with free_uid().
152  *
153  * If the user_struct could not be found, return NULL.
154  */
155 struct user_struct *find_user(kuid_t uid)
156 {
157 	struct user_struct *ret;
158 	unsigned long flags;
159 
160 	spin_lock_irqsave(&uidhash_lock, flags);
161 	ret = uid_hash_find(uid, uidhashentry(uid));
162 	spin_unlock_irqrestore(&uidhash_lock, flags);
163 	return ret;
164 }
165 
166 void free_uid(struct user_struct *up)
167 {
168 	unsigned long flags;
169 
170 	if (!up)
171 		return;
172 
173 	if (refcount_dec_and_lock_irqsave(&up->__count, &uidhash_lock, &flags))
174 		free_user(up, flags);
175 }
176 
177 struct user_struct *alloc_uid(kuid_t uid)
178 {
179 	struct hlist_head *hashent = uidhashentry(uid);
180 	struct user_struct *up, *new;
181 
182 	spin_lock_irq(&uidhash_lock);
183 	up = uid_hash_find(uid, hashent);
184 	spin_unlock_irq(&uidhash_lock);
185 
186 	if (!up) {
187 		new = kmem_cache_zalloc(uid_cachep, GFP_KERNEL);
188 		if (!new)
189 			return NULL;
190 
191 		new->uid = uid;
192 		refcount_set(&new->__count, 1);
193 		ratelimit_state_init(&new->ratelimit, HZ, 100);
194 		ratelimit_set_flags(&new->ratelimit, RATELIMIT_MSG_ON_RELEASE);
195 
196 		/*
197 		 * Before adding this, check whether we raced
198 		 * on adding the same user already..
199 		 */
200 		spin_lock_irq(&uidhash_lock);
201 		up = uid_hash_find(uid, hashent);
202 		if (up) {
203 			kmem_cache_free(uid_cachep, new);
204 		} else {
205 			uid_hash_insert(new, hashent);
206 			up = new;
207 		}
208 		spin_unlock_irq(&uidhash_lock);
209 	}
210 
211 	return up;
212 }
213 
214 static int __init uid_cache_init(void)
215 {
216 	int n;
217 
218 	uid_cachep = kmem_cache_create("uid_cache", sizeof(struct user_struct),
219 			0, SLAB_HWCACHE_ALIGN|SLAB_PANIC, NULL);
220 
221 	for(n = 0; n < UIDHASH_SZ; ++n)
222 		INIT_HLIST_HEAD(uidhash_table + n);
223 
224 	/* Insert the root user immediately (init already runs as root) */
225 	spin_lock_irq(&uidhash_lock);
226 	uid_hash_insert(&root_user, uidhashentry(GLOBAL_ROOT_UID));
227 	spin_unlock_irq(&uidhash_lock);
228 
229 	return 0;
230 }
231 subsys_initcall(uid_cache_init);
232