mirrors/poky
1
0
Fork 0
mirror of https://git.yoctoproject.org/poky synced 2026-05-05 20:27:58 +02:00
Code Issues Packages Projects Releases Wiki Activity

dev-manual: Added steps to set up native linux host

Browse Source 
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 <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark
2017-07-20 08:14:00 -07:00
committed by Richard Purdie
parent aec9e9b1dc
commit 38ee8ae876
1 changed files with 49 additions and 30 deletions
Download Patch File Download Diff File Expand all files Collapse all files

79
documentation/dev-manual/dev-manual-start.xml
View File

@@ -20,30 +20,23 @@
<para>
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
<ulink url='https://git.yoctoproject.org/cgit/cgit.cgi/crops/about/'>CROPS</ulink>
that leverages
You can use the Yocto Project on a native Linux development host or
you can use
<ulink url='https://git.yoctoproject.org/cgit/cgit.cgi/crops/about/'>CROPS</ulink>,
which leverages
<ulink url='https://www.docker.com/'>Docker Containers</ulink>,
host setup differs from that of a native Linux machine.
to prepare any Linux, Mac, or Windows development host.
</para>
<section id='setting-up-a-native-linux-host'>
<title>Setting Up a Native Linux Host</title>
<para role='writernotes'>
Need text - Following is some basics for a Linux host system.
This information needs to be worked in.
</para>
<para>
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:
<itemizedlist>
Follow these steps to prepare a native Linux machine as your
Yocto Project development host:
<orderedlist>
<listitem><para>
<emphasis>Host System:</emphasis>
<emphasis>Use a Supported Linux Distribution:</emphasis>
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
"<ulink url='&YOCTO_DOCS_REF_URL;#detailed-supported-distros'>Supported Linux Distributions</ulink>" section
in the Yocto Project Reference Manual and the wiki page at
<ulink url='&YOCTO_WIKI_URL;/wiki/Distribution_Support'>Distribution Support</ulink>.</para>
<para>
You should also have about 50 Gbytes of free disk space
<ulink url='&YOCTO_WIKI_URL;/wiki/Distribution_Support'>Distribution Support</ulink>.
</para></listitem>
<listitem><para>
<emphasis>Have Enough Free Memory:</emphasis>
You should have at least 50 Gbytes of free disk space
for building images.
</para></listitem>
<listitem><para>
<emphasis>Packages:</emphasis>
The OpenEmbedded build system requires that certain
packages exist on your development system
(e.g. Python 2.7).
<emphasis>Meet Minimal Version Requirements:</emphasis>
The OpenEmbedded build system should be able to run on any
modern distribution that has the following versions for
Git, tar, and Python.
<itemizedlist>
<listitem><para>
Git 1.8.3.1 or greater
</para></listitem>
<listitem><para>
tar 1.27 or greater
</para></listitem>
<listitem><para>
Python 3.4.0 or greater.
</para></listitem>
</itemizedlist>
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
"<ulink url='&YOCTO_DOCS_QS_URL;#packages'>Build Host Packages</ulink>"
section in the Yocto Project Quick Start and the
"<ulink url='&YOCTO_DOCS_REF_URL;#required-packages-for-the-host-development-system'>Required Packages for the Host Development System</ulink>"
section in the Yocto Project Reference Manual for the
exact package requirements and the installation commands
to install them for the supported distributions.
"<ulink url='&YOCTO_DOCS_REF_URL;#required-git-tar-and-python-versions'>Required Git, tar, and Python Versions</ulink>"
section in the Yocto Project Reference Manual for
information.
</para></listitem>
</itemizedlist>
<listitem><para>
<emphasis>Install Development Host Packages:</emphasis>
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.</para>
<para>For lists of required packages for all scenarios,
see the
"<ulink url='&YOCTO_DOCS_REF_URL;#required-packages-for-the-host-development-system'>Required Packages for the Host Development System</ulink>"
section in the Yocto Project Reference Manual.
</para></listitem>
</orderedlist>
</para>
</section>