xref: /openbmc/linux/kernel/kcmp.c (revision 95e9fd10)
1 #include <linux/kernel.h>
2 #include <linux/syscalls.h>
3 #include <linux/fdtable.h>
4 #include <linux/string.h>
5 #include <linux/random.h>
6 #include <linux/module.h>
7 #include <linux/init.h>
8 #include <linux/errno.h>
9 #include <linux/cache.h>
10 #include <linux/bug.h>
11 #include <linux/err.h>
12 #include <linux/kcmp.h>
13 
14 #include <asm/unistd.h>
15 
16 /*
17  * We don't expose the real in-memory order of objects for security reasons.
18  * But still the comparison results should be suitable for sorting. So we
19  * obfuscate kernel pointers values and compare the production instead.
20  *
21  * The obfuscation is done in two steps. First we xor the kernel pointer with
22  * a random value, which puts pointer into a new position in a reordered space.
23  * Secondly we multiply the xor production with a large odd random number to
24  * permute its bits even more (the odd multiplier guarantees that the product
25  * is unique ever after the high bits are truncated, since any odd number is
26  * relative prime to 2^n).
27  *
28  * Note also that the obfuscation itself is invisible to userspace and if needed
29  * it can be changed to an alternate scheme.
30  */
31 static unsigned long cookies[KCMP_TYPES][2] __read_mostly;
32 
33 static long kptr_obfuscate(long v, int type)
34 {
35 	return (v ^ cookies[type][0]) * cookies[type][1];
36 }
37 
38 /*
39  * 0 - equal, i.e. v1 = v2
40  * 1 - less than, i.e. v1 < v2
41  * 2 - greater than, i.e. v1 > v2
42  * 3 - not equal but ordering unavailable (reserved for future)
43  */
44 static int kcmp_ptr(void *v1, void *v2, enum kcmp_type type)
45 {
46 	long ret;
47 
48 	ret = kptr_obfuscate((long)v1, type) - kptr_obfuscate((long)v2, type);
49 
50 	return (ret < 0) | ((ret > 0) << 1);
51 }
52 
53 /* The caller must have pinned the task */
54 static struct file *
55 get_file_raw_ptr(struct task_struct *task, unsigned int idx)
56 {
57 	struct file *file = NULL;
58 
59 	task_lock(task);
60 	rcu_read_lock();
61 
62 	if (task->files)
63 		file = fcheck_files(task->files, idx);
64 
65 	rcu_read_unlock();
66 	task_unlock(task);
67 
68 	return file;
69 }
70 
71 static void kcmp_unlock(struct mutex *m1, struct mutex *m2)
72 {
73 	if (likely(m2 != m1))
74 		mutex_unlock(m2);
75 	mutex_unlock(m1);
76 }
77 
78 static int kcmp_lock(struct mutex *m1, struct mutex *m2)
79 {
80 	int err;
81 
82 	if (m2 > m1)
83 		swap(m1, m2);
84 
85 	err = mutex_lock_killable(m1);
86 	if (!err && likely(m1 != m2)) {
87 		err = mutex_lock_killable_nested(m2, SINGLE_DEPTH_NESTING);
88 		if (err)
89 			mutex_unlock(m1);
90 	}
91 
92 	return err;
93 }
94 
95 SYSCALL_DEFINE5(kcmp, pid_t, pid1, pid_t, pid2, int, type,
96 		unsigned long, idx1, unsigned long, idx2)
97 {
98 	struct task_struct *task1, *task2;
99 	int ret;
100 
101 	rcu_read_lock();
102 
103 	/*
104 	 * Tasks are looked up in caller's PID namespace only.
105 	 */
106 	task1 = find_task_by_vpid(pid1);
107 	task2 = find_task_by_vpid(pid2);
108 	if (!task1 || !task2)
109 		goto err_no_task;
110 
111 	get_task_struct(task1);
112 	get_task_struct(task2);
113 
114 	rcu_read_unlock();
115 
116 	/*
117 	 * One should have enough rights to inspect task details.
118 	 */
119 	ret = kcmp_lock(&task1->signal->cred_guard_mutex,
120 			&task2->signal->cred_guard_mutex);
121 	if (ret)
122 		goto err;
123 	if (!ptrace_may_access(task1, PTRACE_MODE_READ) ||
124 	    !ptrace_may_access(task2, PTRACE_MODE_READ)) {
125 		ret = -EPERM;
126 		goto err_unlock;
127 	}
128 
129 	switch (type) {
130 	case KCMP_FILE: {
131 		struct file *filp1, *filp2;
132 
133 		filp1 = get_file_raw_ptr(task1, idx1);
134 		filp2 = get_file_raw_ptr(task2, idx2);
135 
136 		if (filp1 && filp2)
137 			ret = kcmp_ptr(filp1, filp2, KCMP_FILE);
138 		else
139 			ret = -EBADF;
140 		break;
141 	}
142 	case KCMP_VM:
143 		ret = kcmp_ptr(task1->mm, task2->mm, KCMP_VM);
144 		break;
145 	case KCMP_FILES:
146 		ret = kcmp_ptr(task1->files, task2->files, KCMP_FILES);
147 		break;
148 	case KCMP_FS:
149 		ret = kcmp_ptr(task1->fs, task2->fs, KCMP_FS);
150 		break;
151 	case KCMP_SIGHAND:
152 		ret = kcmp_ptr(task1->sighand, task2->sighand, KCMP_SIGHAND);
153 		break;
154 	case KCMP_IO:
155 		ret = kcmp_ptr(task1->io_context, task2->io_context, KCMP_IO);
156 		break;
157 	case KCMP_SYSVSEM:
158 #ifdef CONFIG_SYSVIPC
159 		ret = kcmp_ptr(task1->sysvsem.undo_list,
160 			       task2->sysvsem.undo_list,
161 			       KCMP_SYSVSEM);
162 #else
163 		ret = -EOPNOTSUPP;
164 #endif
165 		break;
166 	default:
167 		ret = -EINVAL;
168 		break;
169 	}
170 
171 err_unlock:
172 	kcmp_unlock(&task1->signal->cred_guard_mutex,
173 		    &task2->signal->cred_guard_mutex);
174 err:
175 	put_task_struct(task1);
176 	put_task_struct(task2);
177 
178 	return ret;
179 
180 err_no_task:
181 	rcu_read_unlock();
182 	return -ESRCH;
183 }
184 
185 static __init int kcmp_cookies_init(void)
186 {
187 	int i;
188 
189 	get_random_bytes(cookies, sizeof(cookies));
190 
191 	for (i = 0; i < KCMP_TYPES; i++)
192 		cookies[i][1] |= (~(~0UL >>  1) | 1);
193 
194 	return 0;
195 }
196 arch_initcall(kcmp_cookies_init);
197