From mboxrd@z Thu Jan  1 00:00:00 1970
From: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com>
Subject: Re: RFC: very initial PVH design document
Date: Fri, 12 Sep 2014 16:38:20 -0400
Message-ID: <20140912203820.GA25403@laptop.dumpdata.com>
References: <53F759CC.7090406@citrix.com>
Mime-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: 7bit
Return-path: <xen-devel-bounces@lists.xen.org>
Content-Disposition: inline
In-Reply-To: <53F759CC.7090406@citrix.com>
List-Unsubscribe: <http://lists.xen.org/cgi-bin/mailman/options/xen-devel>,
	<mailto:xen-devel-request@lists.xen.org?subject=unsubscribe>
List-Post: <mailto:xen-devel@lists.xen.org>
List-Help: <mailto:xen-devel-request@lists.xen.org?subject=help>
List-Subscribe: <http://lists.xen.org/cgi-bin/mailman/listinfo/xen-devel>,
	<mailto:xen-devel-request@lists.xen.org?subject=subscribe>
Sender: xen-devel-bounces@lists.xen.org
Errors-To: xen-devel-bounces@lists.xen.org
To: Roger Pau =?iso-8859-1?Q?Monn=E9?= <roger.pau@citrix.com>
Cc: David Vrabel <david.vrabel@citrix.com>, Jan Beulich <JBeulich@suse.com>, xen-devel <xen-devel@lists.xen.org>
List-Id: xen-devel@lists.xenproject.org

> ## SMP discover and bring up ##
> 
> The process of bringing up secondary CPUs is obviously different from native,
> since PVH doesn't have a local APIC. The first thing to do is to figure out
> how many vCPUs the guest has. This is done using the `VCPUOP_is_up` hypercall,
> using for example this simple loop:
> 
>     for (i = 0; i < MAXCPU; i++) {
>         ret = HYPERVISOR_vcpu_op(VCPUOP_is_up, i, NULL);
>         if (ret >= 0)
>             /* vCPU#i is present */
>     }
> 
> Note than when running as Dom0, the ACPI tables might report a different number
> of available CPUs. This is because the value on the ACPI tables is the
> number of physical CPUs the host has, and it might bear no resemblance with the
> number of vCPUs Dom0 actually has so it should be ignored.
> 
> In order to bring up the secondary vCPUs they must be configured first. This is
> achieved using the `VCPUOP_initialise` hypercall. A valid context has to be
> passed to the vCPU in order to boot. The relevant fields for PVH guests are
> the following:
> 
>   * `flags`: contains VGCF_* flags (see `arch-x86/xen.h` public header).
>   * `user_regs`: struct that contains the register values that will be set on
>     the vCPU before booting. The most relevant ones are `rip` and `rsp` in order
>     to set the start address and the stack.

The OS can use 'rdi' and 'rsi' for their own purpose.

[Any other ones that are free to be used?]

>   * `ctrlreg[3]`: contains the address of the page tables that will be used by
>     the vCPU.

Other registers - if not set to zero will cause the hypercall to error with
-EINVAL.
> 
> After the vCPU is initialized with the proper values, it can be started by
> using the `VCPUOP_up` hypercall. The values of the other control registers of
> the vCPU will be the same as the ones described in the `control registers`
> section.
>