From mboxrd@z Thu Jan  1 00:00:00 1970
From: Ian Campbell <ian.campbell@citrix.com>
Subject: Re: [Minios-devel] [PATCH v2 0/15+5+5] Begin to
 disentangle libxenctrl and provide some stable libraries
Date: Thu, 24 Sep 2015 17:47:22 +0100
Message-ID: <1443113242.25250.31.camel@citrix.com>
References: <1436975173.32371.121.camel@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>
In-Reply-To: <1436975173.32371.121.camel@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: xen-devel <xen-devel@lists.xen.org>, David Vrabel <david.vrabel@citrix.com>
Cc: Ian Jackson <Ian.Jackson@eu.citrix.com>, Wei Liu <wei.liu2@citrix.com>, Stefano Stabellini <Stefano.Stabellini@eu.citrix.com>
List-Id: xen-devel@lists.xenproject.org

(dropping mini-os-devel and some cc's, adding David)

Hi David,

On Wed, 2015-07-15 at 16:46 +0100, Ian Campbell wrote:
> (this is clearly not 4.6 material, aiming for 4.7)
> 
> In <1431963008.4944.80.camel@citrix.com> I proposed stabilising some
> parts of the libxenctrl API/ABI by disaggregating into separate
> libraries.
> 
[...]
> Still to come would be libraries for specific out of tree purposes
> (device model, kexec),

For kexec I have ("S" column is "interface to the left is stable A(BP)I"):

Interface                          S Underlying Interface           S Other users
---------------------------------- - ------------------------------ - ---------------
`xc__hypercall_buffer_array_alloc`   Should use libxencall
`xc_hypercall_buffer_array_create`   Should use libxencall
`xc_hypercall_buffer_array_des...`   Should use libxencall
`xc_interface_close`
`xc_interface_open`
`xc_get_max_cpus`                  N `xc_physinfo=SYSCTL_physinfo`  N many
`xc_version`                       N `XENVER_capabilities`          Y libxl,others
`xc_get_machine_memory_map`        N `XENMEM_machine_memory_map`    Y libxl

`xc_kexec_exec`                    N `KEXEC_CMD_kexec`              Y None
`xc_kexec_get_range`               N `KEXEC_CMD_kexec_get_range`    Y None
`xc_kexec_load`                    N `KEXEC_CMD_kexec_load`         Y None
`xc_kexec_unload`                  N `KEXEC_CMD_kexec_unload`       Y None

It seems to me that there is not all that much utility to providing a
stable libxenkexec containing those last four, and that they might as well
be moved to kexec-tools where they can be implemented using the new
libxencall (which also includes the buffer allocation stuff for the first
3).

What do you think?

That would just leave xc_get_max_cpus, xc_version and
xc_get_machine_memory_map, which I'm still pondering.

Ian.