1 // SPDX-License-Identifier: GPL-2.0-or-later
3 * linux/mm/process_vm_access.c
5 * Copyright (C) 2010-2011 Christopher Yeoh <cyeoh@au1.ibm.com>, IBM Corp.
8 #include <linux/compat.h>
10 #include <linux/uio.h>
11 #include <linux/sched.h>
12 #include <linux/sched/mm.h>
13 #include <linux/highmem.h>
14 #include <linux/ptrace.h>
15 #include <linux/slab.h>
16 #include <linux/syscalls.h>
19 * process_vm_rw_pages - read/write pages from task specified
20 * @pages: array of pointers to pages we want to copy
21 * @offset: offset in page to start copying from/to
22 * @len: number of bytes to copy
23 * @iter: where to copy to/from locally
24 * @vm_write: 0 means copy from, 1 means copy to
25 * Returns 0 on success, error code otherwise
27 static int process_vm_rw_pages(struct page
**pages
,
30 struct iov_iter
*iter
,
33 /* Do the copy for each page */
34 while (len
&& iov_iter_count(iter
)) {
35 struct page
*page
= *pages
++;
36 size_t copy
= PAGE_SIZE
- offset
;
43 copied
= copy_page_from_iter(page
, offset
, copy
, iter
);
45 copied
= copy_page_to_iter(page
, offset
, copy
, iter
);
48 if (copied
< copy
&& iov_iter_count(iter
))
55 /* Maximum number of pages kmalloc'd to hold struct page's during copy */
56 #define PVM_MAX_KMALLOC_PAGES 2
58 /* Maximum number of pages that can be stored at a time */
59 #define PVM_MAX_USER_PAGES (PVM_MAX_KMALLOC_PAGES * PAGE_SIZE / sizeof(struct page *))
62 * process_vm_rw_single_vec - read/write pages from task specified
63 * @addr: start memory address of target process
64 * @len: size of area to copy to/from
65 * @iter: where to copy to/from locally
66 * @process_pages: struct pages area that can store at least
67 * nr_pages_to_copy struct page pointers
69 * @task: task to read/write from
70 * @vm_write: 0 means copy from, 1 means copy to
71 * Returns 0 on success or on failure error code
73 static int process_vm_rw_single_vec(unsigned long addr
,
75 struct iov_iter
*iter
,
76 struct page
**process_pages
,
78 struct task_struct
*task
,
81 unsigned long pa
= addr
& PAGE_MASK
;
82 unsigned long start_offset
= addr
- pa
;
83 unsigned long nr_pages
;
85 unsigned int flags
= 0;
87 /* Work out address and page range required */
90 nr_pages
= (addr
+ len
- 1) / PAGE_SIZE
- addr
/ PAGE_SIZE
+ 1;
95 while (!rc
&& nr_pages
&& iov_iter_count(iter
)) {
96 int pinned_pages
= min_t(unsigned long, nr_pages
, PVM_MAX_USER_PAGES
);
101 * Get the pages we're interested in. We must
102 * access remotely because task/mm might not
103 * current/current->mm
106 pinned_pages
= pin_user_pages_remote(mm
, pa
, pinned_pages
,
107 flags
, process_pages
,
110 mmap_read_unlock(mm
);
111 if (pinned_pages
<= 0)
114 bytes
= pinned_pages
* PAGE_SIZE
- start_offset
;
118 rc
= process_vm_rw_pages(process_pages
,
119 start_offset
, bytes
, iter
,
123 nr_pages
-= pinned_pages
;
124 pa
+= pinned_pages
* PAGE_SIZE
;
126 /* If vm_write is set, the pages need to be made dirty: */
127 unpin_user_pages_dirty_lock(process_pages
, pinned_pages
,
134 /* Maximum number of entries for process pages array
135 which lives on stack */
136 #define PVM_MAX_PP_ARRAY_COUNT 16
139 * process_vm_rw_core - core of reading/writing pages from task specified
140 * @pid: PID of process to read/write from/to
141 * @iter: where to copy to/from locally
142 * @rvec: iovec array specifying where to copy to/from in the other process
143 * @riovcnt: size of rvec array
144 * @flags: currently unused
145 * @vm_write: 0 if reading from other process, 1 if writing to other process
147 * Returns the number of bytes read/written or error code. May
148 * return less bytes than expected if an error occurs during the copying
151 static ssize_t
process_vm_rw_core(pid_t pid
, struct iov_iter
*iter
,
152 const struct iovec
*rvec
,
153 unsigned long riovcnt
,
154 unsigned long flags
, int vm_write
)
156 struct task_struct
*task
;
157 struct page
*pp_stack
[PVM_MAX_PP_ARRAY_COUNT
];
158 struct page
**process_pages
= pp_stack
;
159 struct mm_struct
*mm
;
162 unsigned long nr_pages
= 0;
163 unsigned long nr_pages_iov
;
165 size_t total_len
= iov_iter_count(iter
);
168 * Work out how many pages of struct pages we're going to need
169 * when eventually calling get_user_pages
171 for (i
= 0; i
< riovcnt
; i
++) {
172 iov_len
= rvec
[i
].iov_len
;
174 nr_pages_iov
= ((unsigned long)rvec
[i
].iov_base
176 / PAGE_SIZE
- (unsigned long)rvec
[i
].iov_base
178 nr_pages
= max(nr_pages
, nr_pages_iov
);
185 if (nr_pages
> PVM_MAX_PP_ARRAY_COUNT
) {
186 /* For reliability don't try to kmalloc more than
188 process_pages
= kmalloc(min_t(size_t, PVM_MAX_KMALLOC_PAGES
* PAGE_SIZE
,
189 sizeof(struct page
*)*nr_pages
),
196 /* Get process information */
197 task
= find_get_task_by_vpid(pid
);
200 goto free_proc_pages
;
203 mm
= mm_access(task
, PTRACE_MODE_ATTACH_REALCREDS
);
207 * Explicitly map EACCES to EPERM as EPERM is a more
208 * appropriate error code for process_vw_readv/writev
212 goto put_task_struct
;
215 for (i
= 0; i
< riovcnt
&& iov_iter_count(iter
) && !rc
; i
++)
216 rc
= process_vm_rw_single_vec(
217 (unsigned long)rvec
[i
].iov_base
, rvec
[i
].iov_len
,
218 iter
, process_pages
, mm
, task
, vm_write
);
220 /* copied = space before - space after */
221 total_len
-= iov_iter_count(iter
);
223 /* If we have managed to copy any data at all then
224 we return the number of bytes copied. Otherwise
225 we return the error code */
232 put_task_struct(task
);
235 if (process_pages
!= pp_stack
)
236 kfree(process_pages
);
241 * process_vm_rw - check iovecs before calling core routine
242 * @pid: PID of process to read/write from/to
243 * @lvec: iovec array specifying where to copy to/from locally
244 * @liovcnt: size of lvec array
245 * @rvec: iovec array specifying where to copy to/from in the other process
246 * @riovcnt: size of rvec array
247 * @flags: currently unused
248 * @vm_write: 0 if reading from other process, 1 if writing to other process
250 * Returns the number of bytes read/written or error code. May
251 * return less bytes than expected if an error occurs during the copying
254 static ssize_t
process_vm_rw(pid_t pid
,
255 const struct iovec __user
*lvec
,
256 unsigned long liovcnt
,
257 const struct iovec __user
*rvec
,
258 unsigned long riovcnt
,
259 unsigned long flags
, int vm_write
)
261 struct iovec iovstack_l
[UIO_FASTIOV
];
262 struct iovec iovstack_r
[UIO_FASTIOV
];
263 struct iovec
*iov_l
= iovstack_l
;
265 struct iov_iter iter
;
267 int dir
= vm_write
? ITER_SOURCE
: ITER_DEST
;
273 rc
= import_iovec(dir
, lvec
, liovcnt
, UIO_FASTIOV
, &iov_l
, &iter
);
276 if (!iov_iter_count(&iter
))
278 iov_r
= iovec_from_user(rvec
, riovcnt
, UIO_FASTIOV
, iovstack_r
,
279 in_compat_syscall());
284 rc
= process_vm_rw_core(pid
, &iter
, iov_r
, riovcnt
, flags
, vm_write
);
285 if (iov_r
!= iovstack_r
)
292 SYSCALL_DEFINE6(process_vm_readv
, pid_t
, pid
, const struct iovec __user
*, lvec
,
293 unsigned long, liovcnt
, const struct iovec __user
*, rvec
,
294 unsigned long, riovcnt
, unsigned long, flags
)
296 return process_vm_rw(pid
, lvec
, liovcnt
, rvec
, riovcnt
, flags
, 0);
299 SYSCALL_DEFINE6(process_vm_writev
, pid_t
, pid
,
300 const struct iovec __user
*, lvec
,
301 unsigned long, liovcnt
, const struct iovec __user
*, rvec
,
302 unsigned long, riovcnt
, unsigned long, flags
)
304 return process_vm_rw(pid
, lvec
, liovcnt
, rvec
, riovcnt
, flags
, 1);