Loading...
1/*
2 * access.h - access guest memory
3 *
4 * Copyright IBM Corp. 2008,2009
5 *
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License (version 2 only)
8 * as published by the Free Software Foundation.
9 *
10 * Author(s): Carsten Otte <cotte@de.ibm.com>
11 */
12
13#ifndef __KVM_S390_GACCESS_H
14#define __KVM_S390_GACCESS_H
15
16#include <linux/compiler.h>
17#include <linux/kvm_host.h>
18#include <asm/uaccess.h>
19#include "kvm-s390.h"
20
21static inline void __user *__guestaddr_to_user(struct kvm_vcpu *vcpu,
22 unsigned long guestaddr)
23{
24 unsigned long prefix = vcpu->arch.sie_block->prefix;
25
26 if (guestaddr < 2 * PAGE_SIZE)
27 guestaddr += prefix;
28 else if ((guestaddr >= prefix) && (guestaddr < prefix + 2 * PAGE_SIZE))
29 guestaddr -= prefix;
30
31 return (void __user *) gmap_fault(guestaddr, vcpu->arch.gmap);
32}
33
34static inline int get_guest_u64(struct kvm_vcpu *vcpu, unsigned long guestaddr,
35 u64 *result)
36{
37 void __user *uptr = __guestaddr_to_user(vcpu, guestaddr);
38
39 BUG_ON(guestaddr & 7);
40
41 if (IS_ERR((void __force *) uptr))
42 return PTR_ERR((void __force *) uptr);
43
44 return get_user(*result, (unsigned long __user *) uptr);
45}
46
47static inline int get_guest_u32(struct kvm_vcpu *vcpu, unsigned long guestaddr,
48 u32 *result)
49{
50 void __user *uptr = __guestaddr_to_user(vcpu, guestaddr);
51
52 BUG_ON(guestaddr & 3);
53
54 if (IS_ERR((void __force *) uptr))
55 return PTR_ERR((void __force *) uptr);
56
57 return get_user(*result, (u32 __user *) uptr);
58}
59
60static inline int get_guest_u16(struct kvm_vcpu *vcpu, unsigned long guestaddr,
61 u16 *result)
62{
63 void __user *uptr = __guestaddr_to_user(vcpu, guestaddr);
64
65 BUG_ON(guestaddr & 1);
66
67 if (IS_ERR(uptr))
68 return PTR_ERR(uptr);
69
70 return get_user(*result, (u16 __user *) uptr);
71}
72
73static inline int get_guest_u8(struct kvm_vcpu *vcpu, unsigned long guestaddr,
74 u8 *result)
75{
76 void __user *uptr = __guestaddr_to_user(vcpu, guestaddr);
77
78 if (IS_ERR((void __force *) uptr))
79 return PTR_ERR((void __force *) uptr);
80
81 return get_user(*result, (u8 __user *) uptr);
82}
83
84static inline int put_guest_u64(struct kvm_vcpu *vcpu, unsigned long guestaddr,
85 u64 value)
86{
87 void __user *uptr = __guestaddr_to_user(vcpu, guestaddr);
88
89 BUG_ON(guestaddr & 7);
90
91 if (IS_ERR((void __force *) uptr))
92 return PTR_ERR((void __force *) uptr);
93
94 return put_user(value, (u64 __user *) uptr);
95}
96
97static inline int put_guest_u32(struct kvm_vcpu *vcpu, unsigned long guestaddr,
98 u32 value)
99{
100 void __user *uptr = __guestaddr_to_user(vcpu, guestaddr);
101
102 BUG_ON(guestaddr & 3);
103
104 if (IS_ERR((void __force *) uptr))
105 return PTR_ERR((void __force *) uptr);
106
107 return put_user(value, (u32 __user *) uptr);
108}
109
110static inline int put_guest_u16(struct kvm_vcpu *vcpu, unsigned long guestaddr,
111 u16 value)
112{
113 void __user *uptr = __guestaddr_to_user(vcpu, guestaddr);
114
115 BUG_ON(guestaddr & 1);
116
117 if (IS_ERR((void __force *) uptr))
118 return PTR_ERR((void __force *) uptr);
119
120 return put_user(value, (u16 __user *) uptr);
121}
122
123static inline int put_guest_u8(struct kvm_vcpu *vcpu, unsigned long guestaddr,
124 u8 value)
125{
126 void __user *uptr = __guestaddr_to_user(vcpu, guestaddr);
127
128 if (IS_ERR((void __force *) uptr))
129 return PTR_ERR((void __force *) uptr);
130
131 return put_user(value, (u8 __user *) uptr);
132}
133
134
135static inline int __copy_to_guest_slow(struct kvm_vcpu *vcpu,
136 unsigned long guestdest,
137 void *from, unsigned long n)
138{
139 int rc;
140 unsigned long i;
141 u8 *data = from;
142
143 for (i = 0; i < n; i++) {
144 rc = put_guest_u8(vcpu, guestdest++, *(data++));
145 if (rc < 0)
146 return rc;
147 }
148 return 0;
149}
150
151static inline int __copy_to_guest_fast(struct kvm_vcpu *vcpu,
152 unsigned long guestdest,
153 void *from, unsigned long n)
154{
155 int r;
156 void __user *uptr;
157 unsigned long size;
158
159 if (guestdest + n < guestdest)
160 return -EFAULT;
161
162 /* simple case: all within one segment table entry? */
163 if ((guestdest & PMD_MASK) == ((guestdest+n) & PMD_MASK)) {
164 uptr = (void __user *) gmap_fault(guestdest, vcpu->arch.gmap);
165
166 if (IS_ERR((void __force *) uptr))
167 return PTR_ERR((void __force *) uptr);
168
169 r = copy_to_user(uptr, from, n);
170
171 if (r)
172 r = -EFAULT;
173
174 goto out;
175 }
176
177 /* copy first segment */
178 uptr = (void __user *)gmap_fault(guestdest, vcpu->arch.gmap);
179
180 if (IS_ERR((void __force *) uptr))
181 return PTR_ERR((void __force *) uptr);
182
183 size = PMD_SIZE - (guestdest & ~PMD_MASK);
184
185 r = copy_to_user(uptr, from, size);
186
187 if (r) {
188 r = -EFAULT;
189 goto out;
190 }
191 from += size;
192 n -= size;
193 guestdest += size;
194
195 /* copy full segments */
196 while (n >= PMD_SIZE) {
197 uptr = (void __user *)gmap_fault(guestdest, vcpu->arch.gmap);
198
199 if (IS_ERR((void __force *) uptr))
200 return PTR_ERR((void __force *) uptr);
201
202 r = copy_to_user(uptr, from, PMD_SIZE);
203
204 if (r) {
205 r = -EFAULT;
206 goto out;
207 }
208 from += PMD_SIZE;
209 n -= PMD_SIZE;
210 guestdest += PMD_SIZE;
211 }
212
213 /* copy the tail segment */
214 if (n) {
215 uptr = (void __user *)gmap_fault(guestdest, vcpu->arch.gmap);
216
217 if (IS_ERR((void __force *) uptr))
218 return PTR_ERR((void __force *) uptr);
219
220 r = copy_to_user(uptr, from, n);
221
222 if (r)
223 r = -EFAULT;
224 }
225out:
226 return r;
227}
228
229static inline int copy_to_guest_absolute(struct kvm_vcpu *vcpu,
230 unsigned long guestdest,
231 void *from, unsigned long n)
232{
233 return __copy_to_guest_fast(vcpu, guestdest, from, n);
234}
235
236static inline int copy_to_guest(struct kvm_vcpu *vcpu, unsigned long guestdest,
237 void *from, unsigned long n)
238{
239 unsigned long prefix = vcpu->arch.sie_block->prefix;
240
241 if ((guestdest < 2 * PAGE_SIZE) && (guestdest + n > 2 * PAGE_SIZE))
242 goto slowpath;
243
244 if ((guestdest < prefix) && (guestdest + n > prefix))
245 goto slowpath;
246
247 if ((guestdest < prefix + 2 * PAGE_SIZE)
248 && (guestdest + n > prefix + 2 * PAGE_SIZE))
249 goto slowpath;
250
251 if (guestdest < 2 * PAGE_SIZE)
252 guestdest += prefix;
253 else if ((guestdest >= prefix) && (guestdest < prefix + 2 * PAGE_SIZE))
254 guestdest -= prefix;
255
256 return __copy_to_guest_fast(vcpu, guestdest, from, n);
257slowpath:
258 return __copy_to_guest_slow(vcpu, guestdest, from, n);
259}
260
261static inline int __copy_from_guest_slow(struct kvm_vcpu *vcpu, void *to,
262 unsigned long guestsrc,
263 unsigned long n)
264{
265 int rc;
266 unsigned long i;
267 u8 *data = to;
268
269 for (i = 0; i < n; i++) {
270 rc = get_guest_u8(vcpu, guestsrc++, data++);
271 if (rc < 0)
272 return rc;
273 }
274 return 0;
275}
276
277static inline int __copy_from_guest_fast(struct kvm_vcpu *vcpu, void *to,
278 unsigned long guestsrc,
279 unsigned long n)
280{
281 int r;
282 void __user *uptr;
283 unsigned long size;
284
285 if (guestsrc + n < guestsrc)
286 return -EFAULT;
287
288 /* simple case: all within one segment table entry? */
289 if ((guestsrc & PMD_MASK) == ((guestsrc+n) & PMD_MASK)) {
290 uptr = (void __user *) gmap_fault(guestsrc, vcpu->arch.gmap);
291
292 if (IS_ERR((void __force *) uptr))
293 return PTR_ERR((void __force *) uptr);
294
295 r = copy_from_user(to, uptr, n);
296
297 if (r)
298 r = -EFAULT;
299
300 goto out;
301 }
302
303 /* copy first segment */
304 uptr = (void __user *)gmap_fault(guestsrc, vcpu->arch.gmap);
305
306 if (IS_ERR((void __force *) uptr))
307 return PTR_ERR((void __force *) uptr);
308
309 size = PMD_SIZE - (guestsrc & ~PMD_MASK);
310
311 r = copy_from_user(to, uptr, size);
312
313 if (r) {
314 r = -EFAULT;
315 goto out;
316 }
317 to += size;
318 n -= size;
319 guestsrc += size;
320
321 /* copy full segments */
322 while (n >= PMD_SIZE) {
323 uptr = (void __user *)gmap_fault(guestsrc, vcpu->arch.gmap);
324
325 if (IS_ERR((void __force *) uptr))
326 return PTR_ERR((void __force *) uptr);
327
328 r = copy_from_user(to, uptr, PMD_SIZE);
329
330 if (r) {
331 r = -EFAULT;
332 goto out;
333 }
334 to += PMD_SIZE;
335 n -= PMD_SIZE;
336 guestsrc += PMD_SIZE;
337 }
338
339 /* copy the tail segment */
340 if (n) {
341 uptr = (void __user *)gmap_fault(guestsrc, vcpu->arch.gmap);
342
343 if (IS_ERR((void __force *) uptr))
344 return PTR_ERR((void __force *) uptr);
345
346 r = copy_from_user(to, uptr, n);
347
348 if (r)
349 r = -EFAULT;
350 }
351out:
352 return r;
353}
354
355static inline int copy_from_guest_absolute(struct kvm_vcpu *vcpu, void *to,
356 unsigned long guestsrc,
357 unsigned long n)
358{
359 return __copy_from_guest_fast(vcpu, to, guestsrc, n);
360}
361
362static inline int copy_from_guest(struct kvm_vcpu *vcpu, void *to,
363 unsigned long guestsrc, unsigned long n)
364{
365 unsigned long prefix = vcpu->arch.sie_block->prefix;
366
367 if ((guestsrc < 2 * PAGE_SIZE) && (guestsrc + n > 2 * PAGE_SIZE))
368 goto slowpath;
369
370 if ((guestsrc < prefix) && (guestsrc + n > prefix))
371 goto slowpath;
372
373 if ((guestsrc < prefix + 2 * PAGE_SIZE)
374 && (guestsrc + n > prefix + 2 * PAGE_SIZE))
375 goto slowpath;
376
377 if (guestsrc < 2 * PAGE_SIZE)
378 guestsrc += prefix;
379 else if ((guestsrc >= prefix) && (guestsrc < prefix + 2 * PAGE_SIZE))
380 guestsrc -= prefix;
381
382 return __copy_from_guest_fast(vcpu, to, guestsrc, n);
383slowpath:
384 return __copy_from_guest_slow(vcpu, to, guestsrc, n);
385}
386#endif
1/* SPDX-License-Identifier: GPL-2.0 */
2/*
3 * access guest memory
4 *
5 * Copyright IBM Corp. 2008, 2014
6 *
7 * Author(s): Carsten Otte <cotte@de.ibm.com>
8 */
9
10#ifndef __KVM_S390_GACCESS_H
11#define __KVM_S390_GACCESS_H
12
13#include <linux/compiler.h>
14#include <linux/kvm_host.h>
15#include <linux/uaccess.h>
16#include <linux/ptrace.h>
17#include "kvm-s390.h"
18
19/**
20 * kvm_s390_real_to_abs - convert guest real address to guest absolute address
21 * @vcpu - guest virtual cpu
22 * @gra - guest real address
23 *
24 * Returns the guest absolute address that corresponds to the passed guest real
25 * address @gra of a virtual guest cpu by applying its prefix.
26 */
27static inline unsigned long kvm_s390_real_to_abs(struct kvm_vcpu *vcpu,
28 unsigned long gra)
29{
30 unsigned long prefix = kvm_s390_get_prefix(vcpu);
31
32 if (gra < 2 * PAGE_SIZE)
33 gra += prefix;
34 else if (gra >= prefix && gra < prefix + 2 * PAGE_SIZE)
35 gra -= prefix;
36 return gra;
37}
38
39/**
40 * kvm_s390_logical_to_effective - convert guest logical to effective address
41 * @vcpu: guest virtual cpu
42 * @ga: guest logical address
43 *
44 * Convert a guest vcpu logical address to a guest vcpu effective address by
45 * applying the rules of the vcpu's addressing mode defined by PSW bits 31
46 * and 32 (extendended/basic addressing mode).
47 *
48 * Depending on the vcpu's addressing mode the upper 40 bits (24 bit addressing
49 * mode), 33 bits (31 bit addressing mode) or no bits (64 bit addressing mode)
50 * of @ga will be zeroed and the remaining bits will be returned.
51 */
52static inline unsigned long kvm_s390_logical_to_effective(struct kvm_vcpu *vcpu,
53 unsigned long ga)
54{
55 psw_t *psw = &vcpu->arch.sie_block->gpsw;
56
57 if (psw_bits(*psw).eaba == PSW_BITS_AMODE_64BIT)
58 return ga;
59 if (psw_bits(*psw).eaba == PSW_BITS_AMODE_31BIT)
60 return ga & ((1UL << 31) - 1);
61 return ga & ((1UL << 24) - 1);
62}
63
64/*
65 * put_guest_lc, read_guest_lc and write_guest_lc are guest access functions
66 * which shall only be used to access the lowcore of a vcpu.
67 * These functions should be used for e.g. interrupt handlers where no
68 * guest memory access protection facilities, like key or low address
69 * protection, are applicable.
70 * At a later point guest vcpu lowcore access should happen via pinned
71 * prefix pages, so that these pages can be accessed directly via the
72 * kernel mapping. All of these *_lc functions can be removed then.
73 */
74
75/**
76 * put_guest_lc - write a simple variable to a guest vcpu's lowcore
77 * @vcpu: virtual cpu
78 * @x: value to copy to guest
79 * @gra: vcpu's destination guest real address
80 *
81 * Copies a simple value from kernel space to a guest vcpu's lowcore.
82 * The size of the variable may be 1, 2, 4 or 8 bytes. The destination
83 * must be located in the vcpu's lowcore. Otherwise the result is undefined.
84 *
85 * Returns zero on success or -EFAULT on error.
86 *
87 * Note: an error indicates that either the kernel is out of memory or
88 * the guest memory mapping is broken. In any case the best solution
89 * would be to terminate the guest.
90 * It is wrong to inject a guest exception.
91 */
92#define put_guest_lc(vcpu, x, gra) \
93({ \
94 struct kvm_vcpu *__vcpu = (vcpu); \
95 __typeof__(*(gra)) __x = (x); \
96 unsigned long __gpa; \
97 \
98 __gpa = (unsigned long)(gra); \
99 __gpa += kvm_s390_get_prefix(__vcpu); \
100 kvm_write_guest(__vcpu->kvm, __gpa, &__x, sizeof(__x)); \
101})
102
103/**
104 * write_guest_lc - copy data from kernel space to guest vcpu's lowcore
105 * @vcpu: virtual cpu
106 * @gra: vcpu's source guest real address
107 * @data: source address in kernel space
108 * @len: number of bytes to copy
109 *
110 * Copy data from kernel space to guest vcpu's lowcore. The entire range must
111 * be located within the vcpu's lowcore, otherwise the result is undefined.
112 *
113 * Returns zero on success or -EFAULT on error.
114 *
115 * Note: an error indicates that either the kernel is out of memory or
116 * the guest memory mapping is broken. In any case the best solution
117 * would be to terminate the guest.
118 * It is wrong to inject a guest exception.
119 */
120static inline __must_check
121int write_guest_lc(struct kvm_vcpu *vcpu, unsigned long gra, void *data,
122 unsigned long len)
123{
124 unsigned long gpa = gra + kvm_s390_get_prefix(vcpu);
125
126 return kvm_write_guest(vcpu->kvm, gpa, data, len);
127}
128
129/**
130 * read_guest_lc - copy data from guest vcpu's lowcore to kernel space
131 * @vcpu: virtual cpu
132 * @gra: vcpu's source guest real address
133 * @data: destination address in kernel space
134 * @len: number of bytes to copy
135 *
136 * Copy data from guest vcpu's lowcore to kernel space. The entire range must
137 * be located within the vcpu's lowcore, otherwise the result is undefined.
138 *
139 * Returns zero on success or -EFAULT on error.
140 *
141 * Note: an error indicates that either the kernel is out of memory or
142 * the guest memory mapping is broken. In any case the best solution
143 * would be to terminate the guest.
144 * It is wrong to inject a guest exception.
145 */
146static inline __must_check
147int read_guest_lc(struct kvm_vcpu *vcpu, unsigned long gra, void *data,
148 unsigned long len)
149{
150 unsigned long gpa = gra + kvm_s390_get_prefix(vcpu);
151
152 return kvm_read_guest(vcpu->kvm, gpa, data, len);
153}
154
155enum gacc_mode {
156 GACC_FETCH,
157 GACC_STORE,
158 GACC_IFETCH,
159};
160
161int guest_translate_address(struct kvm_vcpu *vcpu, unsigned long gva,
162 u8 ar, unsigned long *gpa, enum gacc_mode mode);
163int check_gva_range(struct kvm_vcpu *vcpu, unsigned long gva, u8 ar,
164 unsigned long length, enum gacc_mode mode);
165
166int access_guest(struct kvm_vcpu *vcpu, unsigned long ga, u8 ar, void *data,
167 unsigned long len, enum gacc_mode mode);
168
169int access_guest_real(struct kvm_vcpu *vcpu, unsigned long gra,
170 void *data, unsigned long len, enum gacc_mode mode);
171
172/**
173 * write_guest - copy data from kernel space to guest space
174 * @vcpu: virtual cpu
175 * @ga: guest address
176 * @ar: access register
177 * @data: source address in kernel space
178 * @len: number of bytes to copy
179 *
180 * Copy @len bytes from @data (kernel space) to @ga (guest address).
181 * In order to copy data to guest space the PSW of the vcpu is inspected:
182 * If DAT is off data will be copied to guest real or absolute memory.
183 * If DAT is on data will be copied to the address space as specified by
184 * the address space bits of the PSW:
185 * Primary, secondary, home space or access register mode.
186 * The addressing mode of the PSW is also inspected, so that address wrap
187 * around is taken into account for 24-, 31- and 64-bit addressing mode,
188 * if the to be copied data crosses page boundaries in guest address space.
189 * In addition also low address and DAT protection are inspected before
190 * copying any data (key protection is currently not implemented).
191 *
192 * This function modifies the 'struct kvm_s390_pgm_info pgm' member of @vcpu.
193 * In case of an access exception (e.g. protection exception) pgm will contain
194 * all data necessary so that a subsequent call to 'kvm_s390_inject_prog_vcpu()'
195 * will inject a correct exception into the guest.
196 * If no access exception happened, the contents of pgm are undefined when
197 * this function returns.
198 *
199 * Returns: - zero on success
200 * - a negative value if e.g. the guest mapping is broken or in
201 * case of out-of-memory. In this case the contents of pgm are
202 * undefined. Also parts of @data may have been copied to guest
203 * space.
204 * - a positive value if an access exception happened. In this case
205 * the returned value is the program interruption code and the
206 * contents of pgm may be used to inject an exception into the
207 * guest. No data has been copied to guest space.
208 *
209 * Note: in case an access exception is recognized no data has been copied to
210 * guest space (this is also true, if the to be copied data would cross
211 * one or more page boundaries in guest space).
212 * Therefore this function may be used for nullifying and suppressing
213 * instruction emulation.
214 * It may also be used for terminating instructions, if it is undefined
215 * if data has been changed in guest space in case of an exception.
216 */
217static inline __must_check
218int write_guest(struct kvm_vcpu *vcpu, unsigned long ga, u8 ar, void *data,
219 unsigned long len)
220{
221 return access_guest(vcpu, ga, ar, data, len, GACC_STORE);
222}
223
224/**
225 * read_guest - copy data from guest space to kernel space
226 * @vcpu: virtual cpu
227 * @ga: guest address
228 * @ar: access register
229 * @data: destination address in kernel space
230 * @len: number of bytes to copy
231 *
232 * Copy @len bytes from @ga (guest address) to @data (kernel space).
233 *
234 * The behaviour of read_guest is identical to write_guest, except that
235 * data will be copied from guest space to kernel space.
236 */
237static inline __must_check
238int read_guest(struct kvm_vcpu *vcpu, unsigned long ga, u8 ar, void *data,
239 unsigned long len)
240{
241 return access_guest(vcpu, ga, ar, data, len, GACC_FETCH);
242}
243
244/**
245 * read_guest_instr - copy instruction data from guest space to kernel space
246 * @vcpu: virtual cpu
247 * @ga: guest address
248 * @data: destination address in kernel space
249 * @len: number of bytes to copy
250 *
251 * Copy @len bytes from the given address (guest space) to @data (kernel
252 * space).
253 *
254 * The behaviour of read_guest_instr is identical to read_guest, except that
255 * instruction data will be read from primary space when in home-space or
256 * address-space mode.
257 */
258static inline __must_check
259int read_guest_instr(struct kvm_vcpu *vcpu, unsigned long ga, void *data,
260 unsigned long len)
261{
262 return access_guest(vcpu, ga, 0, data, len, GACC_IFETCH);
263}
264
265/**
266 * write_guest_abs - copy data from kernel space to guest space absolute
267 * @vcpu: virtual cpu
268 * @gpa: guest physical (absolute) address
269 * @data: source address in kernel space
270 * @len: number of bytes to copy
271 *
272 * Copy @len bytes from @data (kernel space) to @gpa (guest absolute address).
273 * It is up to the caller to ensure that the entire guest memory range is
274 * valid memory before calling this function.
275 * Guest low address and key protection are not checked.
276 *
277 * Returns zero on success or -EFAULT on error.
278 *
279 * If an error occurs data may have been copied partially to guest memory.
280 */
281static inline __must_check
282int write_guest_abs(struct kvm_vcpu *vcpu, unsigned long gpa, void *data,
283 unsigned long len)
284{
285 return kvm_write_guest(vcpu->kvm, gpa, data, len);
286}
287
288/**
289 * read_guest_abs - copy data from guest space absolute to kernel space
290 * @vcpu: virtual cpu
291 * @gpa: guest physical (absolute) address
292 * @data: destination address in kernel space
293 * @len: number of bytes to copy
294 *
295 * Copy @len bytes from @gpa (guest absolute address) to @data (kernel space).
296 * It is up to the caller to ensure that the entire guest memory range is
297 * valid memory before calling this function.
298 * Guest key protection is not checked.
299 *
300 * Returns zero on success or -EFAULT on error.
301 *
302 * If an error occurs data may have been copied partially to kernel space.
303 */
304static inline __must_check
305int read_guest_abs(struct kvm_vcpu *vcpu, unsigned long gpa, void *data,
306 unsigned long len)
307{
308 return kvm_read_guest(vcpu->kvm, gpa, data, len);
309}
310
311/**
312 * write_guest_real - copy data from kernel space to guest space real
313 * @vcpu: virtual cpu
314 * @gra: guest real address
315 * @data: source address in kernel space
316 * @len: number of bytes to copy
317 *
318 * Copy @len bytes from @data (kernel space) to @gra (guest real address).
319 * It is up to the caller to ensure that the entire guest memory range is
320 * valid memory before calling this function.
321 * Guest low address and key protection are not checked.
322 *
323 * Returns zero on success or -EFAULT on error.
324 *
325 * If an error occurs data may have been copied partially to guest memory.
326 */
327static inline __must_check
328int write_guest_real(struct kvm_vcpu *vcpu, unsigned long gra, void *data,
329 unsigned long len)
330{
331 return access_guest_real(vcpu, gra, data, len, 1);
332}
333
334/**
335 * read_guest_real - copy data from guest space real to kernel space
336 * @vcpu: virtual cpu
337 * @gra: guest real address
338 * @data: destination address in kernel space
339 * @len: number of bytes to copy
340 *
341 * Copy @len bytes from @gra (guest real address) to @data (kernel space).
342 * It is up to the caller to ensure that the entire guest memory range is
343 * valid memory before calling this function.
344 * Guest key protection is not checked.
345 *
346 * Returns zero on success or -EFAULT on error.
347 *
348 * If an error occurs data may have been copied partially to kernel space.
349 */
350static inline __must_check
351int read_guest_real(struct kvm_vcpu *vcpu, unsigned long gra, void *data,
352 unsigned long len)
353{
354 return access_guest_real(vcpu, gra, data, len, 0);
355}
356
357void ipte_lock(struct kvm_vcpu *vcpu);
358void ipte_unlock(struct kvm_vcpu *vcpu);
359int ipte_lock_held(struct kvm_vcpu *vcpu);
360int kvm_s390_check_low_addr_prot_real(struct kvm_vcpu *vcpu, unsigned long gra);
361
362int kvm_s390_shadow_fault(struct kvm_vcpu *vcpu, struct gmap *shadow,
363 unsigned long saddr);
364
365#endif /* __KVM_S390_GACCESS_H */