s390/kvm/gaccess.h

3  * access guest memory
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
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
52  * @psw: psw of the guest
53  * @ga: guest logical address
55  * Convert a guest logical address to an effective address by applying the
74  * kvm_s390_logical_to_effective - convert guest logical to effective address
75  * @vcpu: guest virtual cpu
76  * @ga: guest logical address
78  * Convert a guest vcpu logical address to a guest vcpu effective address by
93  * put_guest_lc, read_guest_lc and write_guest_lc are guest access functions
96  * guest memory access protection facilities, like key or low address
98  * At a later point guest vcpu lowcore access should happen via pinned
104  * put_guest_lc - write a simple variable to a guest vcpu's lowcore
106  * @x: value to copy to guest
107  * @gra: vcpu's destination guest real address
109  * Copies a simple value from kernel space to a guest vcpu's lowcore.
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.
132  * write_guest_lc - copy data from kernel space to guest vcpu's lowcore
134  * @gra: vcpu's source guest real address
138  * Copy data from kernel space to guest vcpu's lowcore. The entire range must
144  *	 the guest memory mapping is broken. In any case the best solution
145  *	 would be to terminate the guest.
146  *	 It is wrong to inject a guest exception.
158  * read_guest_lc - copy data from guest vcpu's lowcore to kernel space
160  * @gra: vcpu's source guest real address
164  * Copy data from guest vcpu's lowcore to kernel space. The entire range must
170  *	 the guest memory mapping is broken. In any case the best solution
171  *	 would be to terminate the guest.
172  *	 It is wrong to inject a guest exception.
213  * write_guest_with_key - copy data from kernel space to guest space
215  * @ga: guest address
221  * Copy @len bytes from @data (kernel space) to @ga (guest address).
222  * In order to copy data to guest space the PSW of the vcpu is inspected:
223  * If DAT is off data will be copied to guest real or absolute memory.
229  * if the to be copied data crosses page boundaries in guest address space.
236  * will inject a correct exception into the guest.
241  *	     - a negative value if e.g. the guest mapping is broken or in
243  *	       undefined. Also parts of @data may have been copied to guest
248  *	       guest. No data has been copied to guest space.
251  *	 guest space (this is also true, if the to be copied data would cross
252  *	 one or more page boundaries in guest space).
256  *	 if data has been changed in guest space in case of an exception.
267  * write_guest - copy data from kernel space to guest space
269  * @ga: guest address
287  * read_guest_with_key - copy data from guest space to kernel space
289  * @ga: guest address
295  * Copy @len bytes from @ga (guest address) to @data (kernel space).
298  * except that data will be copied from guest space to kernel space.
309  * read_guest - copy data from guest space to kernel space
311  * @ga: guest address
316  * Copy @len bytes from @ga (guest address) to @data (kernel space).
331  * read_guest_instr - copy instruction data from guest space to kernel space
333  * @ga: guest address
337  * Copy @len bytes from the given address (guest space) to @data (kernel
355  * write_guest_abs - copy data from kernel space to guest space absolute
357  * @gpa: guest physical (absolute) address
361  * Copy @len bytes from @data (kernel space) to @gpa (guest absolute address).
362  * It is up to the caller to ensure that the entire guest memory range is
364  * Guest low address and key protection are not checked.
368  * If an error occurs data may have been copied partially to guest memory.
378  * read_guest_abs - copy data from guest space absolute to kernel space
380  * @gpa: guest physical (absolute) address
384  * Copy @len bytes from @gpa (guest absolute address) to @data (kernel space).
385  * It is up to the caller to ensure that the entire guest memory range is
387  * Guest key protection is not checked.
401  * write_guest_real - copy data from kernel space to guest space real
403  * @gra: guest real address
407  * Copy @len bytes from @data (kernel space) to @gra (guest real address).
408  * Guest low address and key protection are not checked.
412  * is also stored to allow injecting into the guest (if applicable) using
415  * If an error occurs data may have been copied partially to guest memory.
425  * read_guest_real - copy data from guest space real to kernel space
427  * @gra: guest real address
431  * Copy @len bytes from @gra (guest real address) to @data (kernel space).
432  * Guest key protection is not checked.
436  * is also stored to allow injecting into the guest (if applicable) using