1 /* SPDX-License-Identifier: GPL-2.0 */
17 #include "kvm-s390.h"
20  * kvm_s390_real_to_abs - convert guest real address to guest absolute address
21  * @prefix - guest prefix
22  * @gra - guest real address
24  * Returns the guest absolute address that corresponds to the passed guest real
25  * address @gra of by applying the given prefix.
32 		gra -= prefix;  in _kvm_s390_real_to_abs()
37  * kvm_s390_real_to_abs - convert guest real address to guest absolute address
38  * @vcpu - guest virtual cpu
39  * @gra - guest real address
41  * Returns the guest absolute address that corresponds to the passed guest real
42  * address @gra of a virtual guest cpu by applying its prefix.
51  * _kvm_s390_logical_to_effective - convert guest logical to effective address
53  * @ga: guest logical address
55  * Convert a guest logical address to an effective address by applying the
69 		return ga & ((1UL << 31) - 1);  in _kvm_s390_logical_to_effective()
70 	return ga & ((1UL << 24) - 1);  in _kvm_s390_logical_to_effective()
74  * kvm_s390_logical_to_effective - convert guest logical to effective address
76  * @ga: guest logical address
78  * Convert a guest vcpu logical address to a guest vcpu effective address by
89 	return _kvm_s390_logical_to_effective(&vcpu->arch.sie_block->gpsw, ga);  in kvm_s390_logical_to_effective()
96  * guest memory access protection facilities, like key or low address
104  * put_guest_lc - write a simple variable to a guest vcpu's lowcore
107  * @gra: vcpu's destination guest real address
113  * Returns zero on success or -EFAULT on error.
128 	kvm_write_guest(__vcpu->kvm, __gpa, &__x, sizeof(__x));	\
132  * write_guest_lc - copy data from kernel space to guest vcpu's lowcore
134  * @gra: vcpu's source guest real address
135  * @data: source address in kernel space
138  * Copy data from kernel space to guest vcpu's lowcore. The entire range must
141  * Returns zero on success or -EFAULT on error.
149 int write_guest_lc(struct kvm_vcpu *vcpu, unsigned long gra, void *data,  in write_guest_lc()  argument
154 	return kvm_write_guest(vcpu->kvm, gpa, data, len);  in write_guest_lc()
158  * read_guest_lc - copy data from guest vcpu's lowcore to kernel space
160  * @gra: vcpu's source guest real address
161  * @data: destination address in kernel space
164  * Copy data from guest vcpu's lowcore to kernel space. The entire range must
167  * Returns zero on success or -EFAULT on error.
175 int read_guest_lc(struct kvm_vcpu *vcpu, unsigned long gra, void *data,  in read_guest_lc()  argument
180 	return kvm_read_guest(vcpu->kvm, gpa, data, len);  in read_guest_lc()
194 int access_guest(struct kvm_vcpu *vcpu, unsigned long ga, u8 ar, void *data,
198 		      void *data, unsigned long len, enum gacc_mode mode);
201  * write_guest - copy data from kernel space to guest space
203  * @ga: guest address
205  * @data: source address in kernel space
208  * Copy @len bytes from @data (kernel space) to @ga (guest address).
209  * In order to copy data to guest space the PSW of the vcpu is inspected:
210  * If DAT is off data will be copied to guest real or absolute memory.
211  * If DAT is on data will be copied to the address space as specified by
212  * the address space bits of the PSW:
214  * The addressing mode of the PSW is also inspected, so that address wrap
215  * around is taken into account for 24-, 31- and 64-bit addressing mode,
216  * if the to be copied data crosses page boundaries in guest address space.
217  * In addition also low address and DAT protection are inspected before
218  * copying any data (key protection is currently not implemented).
222  * all data necessary so that a subsequent call to 'kvm_s390_inject_prog_vcpu()'
227  * Returns:  - zero on success
228  *	     - a negative value if e.g. the guest mapping is broken or in
229  *	       case of out-of-memory. In this case the contents of pgm are
230  *	       undefined. Also parts of @data may have been copied to guest
232  *	     - a positive value if an access exception happened. In this case
235  *	       guest. No data has been copied to guest space.
237  * Note: in case an access exception is recognized no data has been copied to
238  *	 guest space (this is also true, if the to be copied data would cross
243  *	 if data has been changed in guest space in case of an exception.
246 int write_guest(struct kvm_vcpu *vcpu, unsigned long ga, u8 ar, void *data,  in write_guest()  argument
249 	return access_guest(vcpu, ga, ar, data, len, GACC_STORE);  in write_guest()
253  * read_guest - copy data from guest space to kernel space
255  * @ga: guest address
257  * @data: destination address in kernel space
260  * Copy @len bytes from @ga (guest address) to @data (kernel space).
263  * data will be copied from guest space to kernel space.
266 int read_guest(struct kvm_vcpu *vcpu, unsigned long ga, u8 ar, void *data,  in read_guest()  argument
269 	return access_guest(vcpu, ga, ar, data, len, GACC_FETCH);  in read_guest()
273  * read_guest_instr - copy instruction data from guest space to kernel space
275  * @ga: guest address
276  * @data: destination address in kernel space
279  * Copy @len bytes from the given address (guest space) to @data (kernel
283  * instruction data will be read from primary space when in home-space or
284  * address-space mode.
287 int read_guest_instr(struct kvm_vcpu *vcpu, unsigned long ga, void *data,  in read_guest_instr()  argument
290 	return access_guest(vcpu, ga, 0, data, len, GACC_IFETCH);  in read_guest_instr()
294  * write_guest_abs - copy data from kernel space to guest space absolute
296  * @gpa: guest physical (absolute) address
297  * @data: source address in kernel space
300  * Copy @len bytes from @data (kernel space) to @gpa (guest absolute address).
303  * Guest low address and key protection are not checked.
305  * Returns zero on success or -EFAULT on error.
307  * If an error occurs data may have been copied partially to guest memory.
310 int write_guest_abs(struct kvm_vcpu *vcpu, unsigned long gpa, void *data,  in write_guest_abs()  argument
313 	return kvm_write_guest(vcpu->kvm, gpa, data, len);  in write_guest_abs()
317  * read_guest_abs - copy data from guest space absolute to kernel space
319  * @gpa: guest physical (absolute) address
320  * @data: destination address in kernel space
323  * Copy @len bytes from @gpa (guest absolute address) to @data (kernel space).
328  * Returns zero on success or -EFAULT on error.
330  * If an error occurs data may have been copied partially to kernel space.
333 int read_guest_abs(struct kvm_vcpu *vcpu, unsigned long gpa, void *data,  in read_guest_abs()  argument
336 	return kvm_read_guest(vcpu->kvm, gpa, data, len);  in read_guest_abs()
340  * write_guest_real - copy data from kernel space to guest space real
342  * @gra: guest real address
343  * @data: source address in kernel space
346  * Copy @len bytes from @data (kernel space) to @gra (guest real address).
349  * Guest low address and key protection are not checked.
351  * Returns zero on success or -EFAULT on error.
353  * If an error occurs data may have been copied partially to guest memory.
356 int write_guest_real(struct kvm_vcpu *vcpu, unsigned long gra, void *data,  in write_guest_real()  argument
359 	return access_guest_real(vcpu, gra, data, len, 1);  in write_guest_real()
363  * read_guest_real - copy data from guest space real to kernel space
365  * @gra: guest real address
366  * @data: destination address in kernel space
369  * Copy @len bytes from @gra (guest real address) to @data (kernel space).
374  * Returns zero on success or -EFAULT on error.
376  * If an error occurs data may have been copied partially to kernel space.
379 int read_guest_real(struct kvm_vcpu *vcpu, unsigned long gra, void *data,  in read_guest_real()  argument
382 	return access_guest_real(vcpu, gra, data, len, 0);  in read_guest_real()