From 6ebdfedbbfa55eaa15c5178c164c4dbfff88ea34 Mon Sep 17 00:00:00 2001 From: Geoffroy Van Cutsem Date: Thu, 15 Mar 2018 10:03:20 -0700 Subject: [PATCH] Getting Started Guide: add instructions for other OSs Add instructions on how to build the hypervisor and device model on other operating systems such as Ubuntu/Debian, Fedora/Redhat and CentOS. Signed-off-by: Geoffroy Van Cutsem --- getting_started/index.rst | 63 +++++++++++++++++++++++++++++++-------- 1 file changed, 50 insertions(+), 13 deletions(-) diff --git a/getting_started/index.rst b/getting_started/index.rst index 9024fabb0..82bd5ac5e 100644 --- a/getting_started/index.rst +++ b/getting_started/index.rst @@ -281,32 +281,69 @@ Build ACRN from Source ********************** If you would like to build ACRN hypervisor and device model from source, -follow these steps, using your NUC as a development system: +follow these steps. -#. On your Clear Linux system, install the os-clr-on-clr bundle to get - the necessary tools. +Install build tools and dependencies +==================================== - .. code-block:: none +ARCN development is supported on popular Linux distributions, +each with their own way to install development tools: - # swupd bundle-add os-clr-on-clr +* On a Clear Linux development system, install the ``os-clr-on-clr`` bundle to get + the necessary tools: + + .. code-block:: console + + $ sudo swupd bundle-add os-clr-on-clr + +* On a Ubuntu/Debian development system: + + .. code-block:: console + + $ sudo apt install git \ + gnu-efi \ + libssl-dev \ + libpciaccess-dev \ + uuid-dev + +* On a Fedora/Redhat development system: + + .. code-block:: console + + $ sudo dnf install gcc \ + libuuid-devel \ + openssl-devel \ + libpciaccess-devel + +* On a CentOS development system: + + .. code-block:: console + + $ sudo yum install gcc \ + libuuid-devel \ + openssl-devel \ + libpciaccess-devel + +Build the hypervisor and device model +===================================== #. Download the ACRN hypervisor and build it. - .. code-block:: none + .. code-block:: console - # git clone https://github.com/projectacrn/acrn-hypervisor - # cd acrn-hypervisor - # make PLATFORM=uefi + $ git clone https://github.com/projectacrn/acrn-hypervisor + $ cd acrn-hypervisor + $ make PLATFORM=uefi The build results are found in the ``build`` directory. #. Download the ACRN device model and build it. - .. code-block:: none + .. code-block:: console - # git clone https://github.com/projectacrn/acrn-devicemodel - # cd acrn-devicemodel - # make + $ git clone https://github.com/projectacrn/acrn-devicemodel + $ cd acrn-devicemodel + $ make The build results are found in the ``build`` directory.