WARNING - OLD ARCHIVES

This is an archived copy of the Xen.org mailing list, which we have preserved to ensure that existing links to archives are not broken. The live archive, which contains the latest emails, can be found at http://lists.xen.org/

 Home Products Support Community News

xen-changelog

[Xen-changelog] [xen-unstable] Move the booting description out of the V

 To: xen-changelog@xxxxxxxxxxxxxxxxxxx [Xen-changelog] [xen-unstable] Move the booting description out of the VM class description into the VM Xen patchbot-unstable Fri, 09 Mar 2007 11:30:17 -0800 Fri, 09 Mar 2007 11:30:18 -0800 www-data@xxxxxxxxxxxxxxxxxx BK change log , , xen-devel@xxxxxxxxxxxxxxxxxxx xen-changelog-bounces@xxxxxxxxxxxxxxxxxxx
 # HG changeset patch # User Ewan Mellor # Date 1173402371 0 # Node ID acade5948a7534422c70355fe2225baaf05dac81 # Parent 038e9138acaee3debf827a113beb1b831bf65cb4 Move the booting description out of the VM class description into the VM Lifecycle section of the doc. Signed-off-by: Ewan Mellor --- docs/xen-api/vm-lifecycle.tex | 16 ++++++++++++++++ docs/xen-api/xenapi-datamodel.tex | 35 +---------------------------------- tools/libxen/include/xen_vm.h | 33 --------------------------------- 3 files changed, 17 insertions(+), 67 deletions(-) diff -r 038e9138acae -r acade5948a75 docs/xen-api/vm-lifecycle.tex --- a/docs/xen-api/vm-lifecycle.tex Fri Mar 09 00:46:50 2007 +0000 +++ b/docs/xen-api/vm-lifecycle.tex Fri Mar 09 01:06:11 2007 +0000 @@ -22,3 +22,19 @@ Figure~\ref{fig-vm-lifecycle} shows the states that a VM can be in and the API calls that can be used to move the VM between these states. + +\section{VM boot parameters} + +The VM class contains a number of fields that control the way in which the VM is booted. +With reference to the fields defined in the VM class (see later in this document), +this section outlines the boot options available and the mechanisms provided for controlling them. + +VM booting is controlled by setting one of the two mutually exclusive groups: PV'', and HVM''. If HVM.boot\_policy is the empty string, then paravirtual domain building and booting will be used; otherwise the VM will be loaded as an HVM domain, and booted using an emulated BIOS. + +When paravirtual booting is in use, the PV/bootloader field indicates the bootloader to use. It may be pygrub'', in which case the platform's default installation of pygrub will be used, or a full path within the control domain to some other bootloader. The other fields, PV/kernel, PV/ramdisk, PV/args and PV/bootloader\_args will be passed to the bootloader unmodified, and interpretation of those fields is then specific to the bootloader itself, including the possibility that the bootloader will ignore some or all of those given values. Finally the paths of all bootable disks are added to the bootloader commandline (a disk is bootable if its VBD has the bootable flag set). There may be zero, one or many bootable disks; the bootloader decides which disk (if any) to boot from. + +If the bootloader is pygrub, then the menu.lst is parsed if present in the guest's filesystem, otherwise the specified kernel and ramdisk are used, or an autodetected kernel is used if nothing is specified and autodetection is possible. PV/args is appended to the kernel command line, no matter which mechanism is used for finding the kernel. + +If PV/bootloader is empty but PV/kernel is specified, then the kernel and ramdisk values will be treated as paths within the control domain. If both PV/bootloader and PV/kernel are empty, then the behaviour is as if PV/bootloader was specified as pygrub''. + +When using HVM booting, HVM/boot\_policy and HVM/boot\_params specify the boot handling. Only one policy is currently defined: BIOS order''. In this case, HVM/boot\_params should contain one key-value pair order'' = N'' where N is the string that will be passed to QEMU. \ No newline at end of file diff -r 038e9138acae -r acade5948a75 docs/xen-api/xenapi-datamodel.tex --- a/docs/xen-api/xenapi-datamodel.tex Fri Mar 09 00:46:50 2007 +0000 +++ b/docs/xen-api/xenapi-datamodel.tex Fri Mar 09 01:06:11 2007 +0000 @@ -1022,40 +1022,7 @@ references to objects with match names \hline \multicolumn{1}{|l}{Name} & \multicolumn{3}{l|}{\bf VM} \\ \multicolumn{1}{|l}{Description} & \multicolumn{3}{l|}{\parbox{11cm}{\em A -virtual machine (or 'guest'). - -VM booting is controlled by setting one of the two mutually exclusive -groups: "PV", and "HVM". If HVM.boot\_policy is the empty string, then -paravirtual domain building and booting will be used; otherwise the VM will -be loaded as an HVM domain, and booted using an emulated BIOS. - -When paravirtual booting is in use, the PV/bootloader field indicates the -bootloader to use. It may be "pygrub", in which case the platform's -default installation of pygrub will be used, or a full path within the -control domain to some other bootloader. The other fields, PV/kernel, -PV/ramdisk, PV/args and PV/bootloader\_args will be passed to the -bootloader unmodified, and interpretation of those fields is then specific -to the bootloader itself, including the possibility that the bootloader -will ignore some or all of those given values. Finally the paths of all -bootable disks are added to the bootloader commandline (a disk is bootable -if its VBD has the bootable flag set). There may be zero, one or many -bootable disks; the bootloader decides which disk (if any) to boot from. - -If the bootloader is pygrub, then the menu.lst is parsed if present in the -guest's filesystem, otherwise the specified kernel and ramdisk are used, or -an autodetected kernel is used if nothing is specified and autodetection is -possible. PV/args is appended to the kernel command line, no matter which -mechanism is used for finding the kernel. - -If PV/bootloader is empty but PV/kernel is specified, then the kernel and -ramdisk values will be treated as paths within the control domain. If both -PV/bootloader and PV/kernel are empty, then the behaviour is as if -PV/bootloader was specified as "pygrub". - -When using HVM booting, HVM/boot\_policy and HVM/boot\_params specify the -boot handling. Only one policy is currently defined: "BIOS order". In -this case, HVM/boot\_params should contain one key-value pair "order" = "N" -where N is the string that will be passed to QEMU.}} \\ +virtual machine (or 'guest').}} \\ \hline Quals & Field & Type & Description \\ \hline diff -r 038e9138acae -r acade5948a75 tools/libxen/include/xen_vm.h --- a/tools/libxen/include/xen_vm.h Fri Mar 09 00:46:50 2007 +0000 +++ b/tools/libxen/include/xen_vm.h Fri Mar 09 01:06:11 2007 +0000 @@ -40,39 +40,6 @@ * The VM class. * * A virtual machine (or 'guest'). - * - * VM booting is controlled by setting one of the two mutually exclusive - * groups: "PV", and "HVM". If HVM.boot_policy is the empty string, then - * paravirtual domain building and booting will be used; otherwise the VM will - * be loaded as an HVM domain, and booted using an emulated BIOS. - * - * When paravirtual booting is in use, the PV/bootloader field indicates the - * bootloader to use. It may be "pygrub", in which case the platform's - * default installation of pygrub will be used, or a full path within the - * control domain to some other bootloader. The other fields, PV/kernel, - * PV/ramdisk, PV/args and PV/bootloader_args will be passed to the bootloader - * unmodified, and interpretation of those fields is then specific to the - * bootloader itself, including the possibility that the bootloader will - * ignore some or all of those given values. Finally the paths of all bootable - * disks are added to the bootloader commandline (a disk is bootable if its - * VBD has the bootable flag set). There may be zero, one or many bootable - * disks; the bootloader decides which disk (if any) to boot from. - * - * If the bootloader is pygrub, then the menu.lst is parsed if present in the - * guest's filesystem, otherwise the specified kernel and ramdisk are used, or - * an autodetected kernel is used if nothing is specified and autodetection is - * possible. PV/args is appended to the kernel command line, no matter which - * mechanism is used for finding the kernel. - * - * If PV/bootloader is empty but PV/kernel is specified, then the kernel and - * ramdisk values will be treated as paths within the control domain. If both - * PV/bootloader and PV/kernel are empty, then the behaviour is as if - * PV/bootloader was specified as "pygrub". - * - * When using HVM booting, HVM/boot_policy and HVM/boot_params specify the - * boot handling. Only one policy is currently defined: "BIOS order". In - * this case, HVM/boot_params should contain one key-value pair "order" = "N" - * where N is the string that will be passed to QEMU.. */ _______________________________________________ Xen-changelog mailing list Xen-changelog@xxxxxxxxxxxxxxxxxxx http://lists.xensource.com/xen-changelog 
 Current Thread [Xen-changelog] [xen-unstable] Move the booting description out of the VM class description into the VM, Xen patchbot-unstable <=