/*
 * \brief  VM-session interface
 * \author Stefan Kalkowski
 * \author Alexander Böttcher
 * \author Christian Helmuth
 * \date   2012-10-02
 */

/*
 * Copyright (C) 2012-2021 Genode Labs GmbH
 *
 * This file is part of the Genode OS framework, which is distributed
 * under the terms of the GNU Affero General Public License version 3.
 */

#ifndef _INCLUDE__VM_SESSION__VM_SESSION_H_
#define _INCLUDE__VM_SESSION__VM_SESSION_H_

/* Genode includes */
#include <base/rpc_args.h>
#include <base/signal.h>
#include <base/ram_allocator.h>
#include <cpu_session/cpu_session.h>
#include <session/session.h>

namespace Genode { struct Vm_session; }

struct Genode::Vm_session : Session
{
	static const char *service_name() { return "VM"; }

	struct Attach_attr
	{
		addr_t offset;
		addr_t size;
		bool executable;
		bool writeable;
	};

	enum { CAP_QUOTA = 3 };

	class Invalid_dataspace : Exception { };
	class Region_conflict   : Exception { };

	/**
	 * Attach dataspace to the guest-physical memory address space
	 *
	 * \param ds       dataspace to be attached
	 * \param vm_addr  address in guest-physical memory address space
	 */
	virtual void attach(Dataspace_capability ds, addr_t, Attach_attr) = 0;

	/**
	 * Invalidate region of the guest-physical memory address space
	 *
	 * \param vm_addr  address in guest-physical memory address space
	 * \param size     size of the region to invalidate
	 */
	virtual void detach(addr_t vm_addr, size_t size) = 0;

	/**
	 * Attach cpu-local interrupt-controller's interface to
	 * guest-physical memory address space.
	 *
	 * \param vm_addr  address in guest-physical memory address space
	 *
	 * Note: this is currently only support for ARM interrupt-controller
	 *       hardware virtualization
	 */
	virtual void attach_pic(addr_t vm_addr) = 0;

	/*****************************************
	 ** Access to kernel-specific interface **
	 *****************************************/

	/**
	 * Common base class of kernel-specific CPU interfaces
	 */
	struct Native_vcpu;

	/*********************
	 ** RPC declaration **
	 *********************/

	GENODE_RPC_THROW(Rpc_attach, void, attach,
	                 GENODE_TYPE_LIST(Out_of_ram, Out_of_caps, Region_conflict,
	                                  Invalid_dataspace),
	                 Dataspace_capability, addr_t, Attach_attr);
	GENODE_RPC(Rpc_detach, void, detach, addr_t, size_t);
	GENODE_RPC(Rpc_attach_pic, void, attach_pic, addr_t);

	/**
	 * Create a new virtual CPU in the VM
	 *
	 * The vCPU inherits the affinity location (i.e., CPU) from the handler
	 * thread passed as parameter.
	 */
	GENODE_RPC_THROW(Rpc_create_vcpu, Capability<Native_vcpu>, create_vcpu,
	                 GENODE_TYPE_LIST(Out_of_ram, Out_of_caps),
	                 Thread_capability);

	GENODE_RPC_INTERFACE(Rpc_attach, Rpc_detach, Rpc_attach_pic, Rpc_create_vcpu);
};

#endif /* _INCLUDE__VM_SESSION__VM_SESSION_H_ */