ca49b3342d
Implement a subset of the multiboot specification in order to boot Xen and a FreeBSD Dom0 from the FreeBSD bootloader. This multiboot implementation is tailored to boot Xen and FreeBSD Dom0, and it will most surely fail to boot any other multiboot compilant kernel. In order to detect and boot the Xen microkernel, two new file formats are added to the bootloader, multiboot and multiboot_obj. Multiboot support must be tested before regular ELF support, since Xen is a multiboot kernel that also uses ELF. After a multiboot kernel is detected, all the other loaded kernels/modules are parsed by the multiboot_obj format. The layout of the loaded objects in memory is the following; first the Xen kernel is loaded as a 32bit ELF into memory (Xen will switch to long mode by itself), after that the FreeBSD kernel is loaded as a RAW file (Xen will parse and load it using it's internal ELF loader), and finally the metadata and the modules are loaded using the native FreeBSD way. After everything is loaded we jump into Xen's entry point using a small trampoline. The order of the multiboot modules passed to Xen is the following, the first module is the RAW FreeBSD kernel, and the second module is the metadata and the FreeBSD modules. Since Xen will relocate the memory position of the second multiboot module (the one that contains the metadata and native FreeBSD modules), we need to stash the original modulep address inside of the metadata itself in order to recalculate its position once booted. This also means the metadata must come before the loaded modules, so after loading the FreeBSD kernel a portion of memory is reserved in order to place the metadata before booting. In order to tell the loader to boot Xen and then the FreeBSD kernel the following has to be added to the /boot/loader.conf file: xen_cmdline="dom0_mem=1024M dom0_max_vcpus=2 dom0pvh=1 console=com1,vga" xen_kernel="/boot/xen" The first argument contains the command line that will be passed to the Xen kernel, while the second argument is the path to the Xen kernel itself. This can also be done manually from the loader command line, by for example typing the following set of commands: OK unload OK load /boot/xen dom0_mem=1024M dom0_max_vcpus=2 dom0pvh=1 console=com1,vga OK load kernel OK load zfs OK load if_tap OK load ... OK boot Sponsored by: Citrix Systems R&D Reviewed by: jhb Differential Revision: https://reviews.freebsd.org/D517 For the Forth bits: Submitted by: Julien Grall <julien.grall AT citrix.com>
130 lines
4.6 KiB
C
130 lines
4.6 KiB
C
/*-
|
|
* Copyright (c) 1998 Michael Smith <msmith@freebsd.org>
|
|
* All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions
|
|
* are met:
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer.
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in the
|
|
* documentation and/or other materials provided with the distribution.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
|
|
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
* ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
|
|
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
* SUCH DAMAGE.
|
|
*
|
|
* $FreeBSD$
|
|
*/
|
|
|
|
|
|
/*
|
|
* i386 fully-qualified device descriptor.
|
|
* Note, this must match the 'struct devdesc' declaration
|
|
* in bootstrap.h and also with struct zfs_devdesc for zfs
|
|
* support.
|
|
*/
|
|
struct i386_devdesc
|
|
{
|
|
struct devsw *d_dev;
|
|
int d_type;
|
|
int d_unit;
|
|
union
|
|
{
|
|
struct
|
|
{
|
|
void *data;
|
|
int slice;
|
|
int partition;
|
|
off_t offset;
|
|
} biosdisk;
|
|
struct
|
|
{
|
|
void *data;
|
|
} bioscd;
|
|
struct
|
|
{
|
|
void *data;
|
|
uint64_t pool_guid;
|
|
uint64_t root_guid;
|
|
} zfs;
|
|
} d_kind;
|
|
};
|
|
|
|
int i386_getdev(void **vdev, const char *devspec, const char **path);
|
|
char *i386_fmtdev(void *vdev);
|
|
int i386_setcurrdev(struct env_var *ev, int flags, const void *value);
|
|
|
|
extern struct devdesc currdev; /* our current device */
|
|
|
|
#define MAXDEV 31 /* maximum number of distinct devices */
|
|
#define MAXBDDEV MAXDEV
|
|
|
|
/* exported devices XXX rename? */
|
|
extern struct devsw bioscd;
|
|
extern struct devsw biosdisk;
|
|
extern struct devsw pxedisk;
|
|
extern struct fs_ops pxe_fsops;
|
|
|
|
int bc_add(int biosdev); /* Register CD booted from. */
|
|
int bc_getdev(struct i386_devdesc *dev); /* return dev_t for (dev) */
|
|
int bc_bios2unit(int biosdev); /* xlate BIOS device -> bioscd unit */
|
|
int bc_unit2bios(int unit); /* xlate bioscd unit -> BIOS device */
|
|
uint32_t bd_getbigeom(int bunit); /* return geometry in bootinfo format */
|
|
int bd_bios2unit(int biosdev); /* xlate BIOS device -> biosdisk unit */
|
|
int bd_unit2bios(int unit); /* xlate biosdisk unit -> BIOS device */
|
|
int bd_getdev(struct i386_devdesc *dev); /* return dev_t for (dev) */
|
|
|
|
ssize_t i386_copyin(const void *src, vm_offset_t dest, const size_t len);
|
|
ssize_t i386_copyout(const vm_offset_t src, void *dest, const size_t len);
|
|
ssize_t i386_readin(const int fd, vm_offset_t dest, const size_t len);
|
|
|
|
struct preloaded_file;
|
|
void bios_addsmapdata(struct preloaded_file *);
|
|
void bios_getsmap(void);
|
|
|
|
void bios_getmem(void);
|
|
extern uint32_t bios_basemem; /* base memory in bytes */
|
|
extern uint32_t bios_extmem; /* extended memory in bytes */
|
|
extern vm_offset_t memtop; /* last address of physical memory + 1 */
|
|
extern vm_offset_t memtop_copyin; /* memtop less heap size for the cases */
|
|
/* when heap is at the top of */
|
|
/* extended memory; for other cases */
|
|
/* just the same as memtop */
|
|
extern uint32_t high_heap_size; /* extended memory region available */
|
|
extern vm_offset_t high_heap_base; /* for use as the heap */
|
|
|
|
void biospci_detect(void);
|
|
int biospci_count_device_type(uint32_t devid);
|
|
int biospci_find_devclass(uint32_t class, int index, uint32_t *locator);
|
|
int biospci_find_device(uint32_t devid, int index, uint32_t *locator);
|
|
int biospci_write_config(uint32_t locator, int offset, int width, uint32_t val);
|
|
int biospci_read_config(uint32_t locator, int offset, int width, uint32_t *val);
|
|
uint32_t biospci_locator(int8_t bus, uint8_t device, uint8_t function);
|
|
|
|
void biosacpi_detect(void);
|
|
|
|
void smbios_detect(void);
|
|
|
|
int i386_autoload(void);
|
|
|
|
int bi_getboothowto(char *kargs);
|
|
void bi_setboothowto(int howto);
|
|
vm_offset_t bi_copyenv(vm_offset_t addr);
|
|
int bi_load32(char *args, int *howtop, int *bootdevp, vm_offset_t *bip,
|
|
vm_offset_t *modulep, vm_offset_t *kernend);
|
|
int bi_load64(char *args, vm_offset_t addr, vm_offset_t *modulep,
|
|
vm_offset_t *kernend, int add_smap);
|
|
|
|
char *pxe_default_rc(void);
|
|
void pxe_enable(void *pxeinfo);
|