mirror of
https://github.com/projectacrn/acrn-hypervisor.git
synced 2025-05-12 02:18:40 +00:00
3e54c70d0f
commit 026ae83bd5 ("hv: include: fix 'Unused procedure parameter'")
removed the then unused parameter handler_private_data from
hv_mem_io_handler_t because MISRA-C requires that there should be no
unused parameters in functions.
This patch removes vcpu from the parameter list as well since this may
not be used by all users. Also it brings back handler_private_data which
is more flexible. For example, vioapic_mmio_access_handler() can use it
to pass vcpu pointer.
Tracked-On: #861
Signed-off-by: dongshen <dongsheng.x.zhang@intel.com>
Signed-off-by: Zide Chen <zide.chen@intel.com>
Reviewed-by: Li, Fei1 <fei1.li@intel.com>
Acked-by: Anthony Xu <anthony.xu@intel.com>
134 lines
3.8 KiB
C
134 lines
3.8 KiB
C
/*
|
|
* Copyright (C) 2018 Intel Corporation. All rights reserved.
|
|
*
|
|
* SPDX-License-Identifier: BSD-3-Clause
|
|
*/
|
|
|
|
#ifndef IOREQ_H
|
|
#define IOREQ_H
|
|
|
|
#include <types.h>
|
|
#include <acrn_common.h>
|
|
|
|
/* The return value of emulate_io() indicating the I/O request is delivered to
|
|
* VHM but not finished yet. */
|
|
#define IOREQ_PENDING 1
|
|
|
|
/* Internal representation of a I/O request. */
|
|
struct io_request {
|
|
/** Type of the request (PIO, MMIO, etc). Refer to vhm_request. */
|
|
uint32_t type;
|
|
|
|
/** Details of this request in the same format as vhm_request. */
|
|
union vhm_io_request reqs;
|
|
};
|
|
|
|
/* Definition of a IO port range */
|
|
struct vm_io_range {
|
|
uint16_t base; /* IO port base */
|
|
uint16_t len; /* IO port range */
|
|
uint32_t flags; /* IO port attributes */
|
|
};
|
|
|
|
struct vm_io_handler;
|
|
struct vm;
|
|
struct vcpu;
|
|
|
|
typedef
|
|
uint32_t (*io_read_fn_t)(struct vm *vm, uint16_t port, size_t size);
|
|
|
|
typedef
|
|
void (*io_write_fn_t)(struct vm *vm, uint16_t port, size_t size, uint32_t val);
|
|
|
|
/* Describes a single IO handler description entry. */
|
|
struct vm_io_handler_desc {
|
|
|
|
/** The base address of the IO range for this description. */
|
|
uint16_t addr;
|
|
/** The number of bytes covered by this description. */
|
|
size_t len;
|
|
|
|
/** A pointer to the "read" function.
|
|
*
|
|
* The read function is called from the hypervisor whenever
|
|
* a read access to a range described in "ranges" occur.
|
|
* The arguments to the callback are:
|
|
*
|
|
* - The address of the port to read from.
|
|
* - The width of the read operation (1,2 or 4).
|
|
*
|
|
* The implementation must return the ports content as
|
|
* byte, word or doubleword (depending on the width).
|
|
*
|
|
* If the pointer is null, a read of 1's is assumed.
|
|
*/
|
|
|
|
io_read_fn_t io_read;
|
|
/** A pointer to the "write" function.
|
|
*
|
|
* The write function is called from the hypervisor code
|
|
* whenever a write access to a range described in "ranges"
|
|
* occur. The arguments to the callback are:
|
|
*
|
|
* - The address of the port to write to.
|
|
* - The width of the write operation (1,2 or 4).
|
|
* - The value to write as byte, word or doubleword
|
|
* (depending on the width)
|
|
*
|
|
* The implementation must write the value to the port.
|
|
*
|
|
* If the pointer is null, the write access is ignored.
|
|
*/
|
|
|
|
io_write_fn_t io_write;
|
|
};
|
|
|
|
struct vm_io_handler {
|
|
struct vm_io_handler *next;
|
|
struct vm_io_handler_desc desc;
|
|
};
|
|
|
|
#define IO_ATTR_R 0U
|
|
#define IO_ATTR_RW 1U
|
|
#define IO_ATTR_NO_ACCESS 2U
|
|
|
|
/* Typedef for MMIO handler and range check routine */
|
|
struct mmio_request;
|
|
typedef int (*hv_mem_io_handler_t)(struct io_request *io_req, void *handler_private_data);
|
|
|
|
/* Structure for MMIO handler node */
|
|
struct mem_io_node {
|
|
hv_mem_io_handler_t read_write;
|
|
void *handler_private_data;
|
|
struct list_head list;
|
|
uint64_t range_start;
|
|
uint64_t range_end;
|
|
};
|
|
|
|
/* External Interfaces */
|
|
int32_t pio_instr_vmexit_handler(struct vcpu *vcpu);
|
|
void setup_io_bitmap(struct vm *vm);
|
|
void free_io_emulation_resource(struct vm *vm);
|
|
void allow_guest_pio_access(struct vm *vm, uint16_t port_address,
|
|
uint32_t nbytes);
|
|
void register_io_emulation_handler(struct vm *vm, const struct vm_io_range *range,
|
|
io_read_fn_t io_read_fn_ptr,
|
|
io_write_fn_t io_write_fn_ptr);
|
|
|
|
int register_mmio_emulation_handler(struct vm *vm,
|
|
hv_mem_io_handler_t read_write, uint64_t start,
|
|
uint64_t end, void *handler_private_data);
|
|
void unregister_mmio_emulation_handler(struct vm *vm, uint64_t start,
|
|
uint64_t end);
|
|
void emulate_mmio_post(const struct vcpu *vcpu, const struct io_request *io_req);
|
|
void dm_emulate_mmio_post(struct vcpu *vcpu);
|
|
|
|
int32_t emulate_io(struct vcpu *vcpu, struct io_request *io_req);
|
|
void emulate_io_post(struct vcpu *vcpu);
|
|
/*
|
|
* @pre vcpu != NULL && io_req != NULL
|
|
*/
|
|
int32_t acrn_insert_request_wait(struct vcpu *vcpu, const struct io_request *io_req);
|
|
|
|
#endif /* IOREQ_H */
|