The preferred method to booting Linux on the POWER10 Functional Simulator is 
using the supported skiboot, kernel and disk image.  We will cover this process below.

-------------------------------------------------------------------------------
skiboot

When booting Linux using skiboot you will need three things:
1. a suitable disk image
2. a suitable powerpc kernel
3. a suitable skiboot lid

=== Quickstart ===

We have provided four scripts to get users up and running quickly:
* fetch_fedora_disk_image.sh  - downloads and decompresses the Fedora 32 LE disk image
* fetch_disk_image.sh         - downloads and decompresses the Ubuntu1804 LE disk image
* fetch_vmlinux.sh            - downloads the powerpc kernel (vmlinux)
* fetch_skiboot.sh            - downloads the skiboot lid

As part of the Simulator Development Toolkit for PowerLinux, a little endian
disk image based on Debian and Fedora is provided. For the Debian disk image, 
fetch_disk_image.sh will download and decompress, which will inflate to ~10G. You can resize this
image using the following steps (here we resize it to 5GB):
  1. e2fsck -f debian-ppc64le-p10.img
  2. resize2fs debian-ppc64le-p10.img 5G

NOTE: The root user's password for this disk image is "mambo".

A pre-compiled little-endian Linux kernel that has been patched to include supported 
simulator-specific out-of-tree kernel drivers known as pmem and bogus_net. 
Download this pre-compiled kernel with fetch_vmlinux.sh.

The last piece of the puzzle, the skiboot lid, is also thoughtfully provided
by the POWER-Linux team. Download it using fetch_skiboot.sh.

Once you have all three components in place you can use the provided
boot-linux-le-skiboot-p10.tcl from run/p10/linux/ to boot your simulated POWER10
system. This tcl script expects the disk image to be called disk.img in the /opt/ibm/systemsim-p10/images 
directory, so you'll need to either rename your disk image to be disk.img or create a
symlink to it called disk.img. Note, make sure "xterm" is installed on your host machine.  
Example to boot linux on the simulator e.g.
	> cd /opt/ibm/systemsim-p10/run/p10/linux
	> ../powerp10 -f boot-linux-le-skiboot-p10.tcl

-------------------------------------------------------------------------------
