From 38ee8ae87614f790cbdd79137451994c28b69b05 Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Thu, 20 Jul 2017 08:14:00 -0700 Subject: dev-manual: Added steps to set up native linux host Fixes [YOCTO #11630] Added content for steps to set up a native Linux host for using the Yocto Project. (From yocto-docs rev: d8a18d382c584dbdfa7f5f190a92cc7cde0f9601) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- documentation/dev-manual/dev-manual-start.xml | 77 +++++++++++++++++---------- 1 file changed, 48 insertions(+), 29 deletions(-) (limited to 'documentation/dev-manual/dev-manual-start.xml') diff --git a/documentation/dev-manual/dev-manual-start.xml b/documentation/dev-manual/dev-manual-start.xml index e70d79e424..1332a26416 100644 --- a/documentation/dev-manual/dev-manual-start.xml +++ b/documentation/dev-manual/dev-manual-start.xml @@ -20,30 +20,23 @@ This section provides procedures to set up your development host to use the Yocto Project. - For a Linux system to use the Yocto Project, you need to be sure - you are running a supported Linux distribution and have the proper - host packages installed. - If you are using - CROPS - that leverages + You can use the Yocto Project on a native Linux development host or + you can use + CROPS, + which leverages Docker Containers, - host setup differs from that of a native Linux machine. + to prepare any Linux, Mac, or Windows development host.
Setting Up a Native Linux Host - - Need text - Following is some basics for a Linux host system. - This information needs to be worked in. - - - Setup consists of making sure you have a supported operating system, - installing host packages, and Here is what you need to use the Yocto Project: - + Follow these steps to prepare a native Linux machine as your + Yocto Project development host: + - Host System: + Use a Supported Linux Distribution: You should have a reasonably current Linux-based host system. You will have the best results with a recent release of @@ -54,25 +47,51 @@ status, see the "Supported Linux Distributions" section in the Yocto Project Reference Manual and the wiki page at - Distribution Support. - - You should also have about 50 Gbytes of free disk space + Distribution Support. + + + Have Enough Free Memory: + You should have at least 50 Gbytes of free disk space for building images. - Packages: - The OpenEmbedded build system requires that certain - packages exist on your development system - (e.g. Python 2.7). + Meet Minimal Version Requirements: + The OpenEmbedded build system should be able to run on any + modern distribution that has the following versions for + Git, tar, and Python. + + + Git 1.8.3.1 or greater + + + tar 1.27 or greater + + + Python 3.4.0 or greater. + + + If your build host does not meet any of these three listed + version requirements, you can take steps to prepare the + system so that you can still use the Yocto Project. See the - "Build Host Packages" - section in the Yocto Project Quick Start and the + "Required Git, tar, and Python Versions" + section in the Yocto Project Reference Manual for + information. + + + Install Development Host Packages: + Required development host packages vary depending on your + build machine and what you want to do with the Yocto + Project. + Collectively, the number of required packages is large + if you want to be able to cover all cases. + + For lists of required packages for all scenarios, + see the "Required Packages for the Host Development System" - section in the Yocto Project Reference Manual for the - exact package requirements and the installation commands - to install them for the supported distributions. + section in the Yocto Project Reference Manual. - +
-- cgit v1.2.3-54-g00ecf