diff options
author | Scott Rifenbark <srifenbark@gmail.com> | 2018-01-09 15:53:40 -0800 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2018-02-14 15:25:27 +0000 |
commit | e2060287db8093b53d2d18a217c0c463eb6b0c86 (patch) | |
tree | 9ed8682dd6c1123cf0bc13587fd29260ce6d5781 /documentation/overview-manual | |
parent | 60cfd0785b2d64ec808e08ad9f716047542d8ba9 (diff) | |
download | poky-e2060287db8093b53d2d18a217c0c463eb6b0c86.tar.gz |
overview-manual, ref-manual, dev-manual: Moved x32 stuff
Fixes [YOCTO #12370]
The section on the x32 psABI topic was in the "technical details"
section of the reference manual. This section combined conceptual
and "how to" information for x32 psABI. I moved the conceptual
information to a new chapter in the overview-manual. I moved the
"how-to" information to a separate topic in the dev-manual. This
resulted in the mega-manual being updated to take on a new chapter
for the overview-manual (overview-concepts.xml). No links were
affected.
(From yocto-docs rev: 84da28a4ad0f3f89bfc865f410a5d06b57439beb)
Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/overview-manual')
-rw-r--r-- | documentation/overview-manual/overview-concepts.xml | 78 | ||||
-rw-r--r-- | documentation/overview-manual/overview-manual.xml | 2 |
2 files changed, 80 insertions, 0 deletions
diff --git a/documentation/overview-manual/overview-concepts.xml b/documentation/overview-manual/overview-concepts.xml new file mode 100644 index 0000000000..dea30bc907 --- /dev/null +++ b/documentation/overview-manual/overview-concepts.xml | |||
@@ -0,0 +1,78 @@ | |||
1 | <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" | ||
2 | "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" | ||
3 | [<!ENTITY % poky SYSTEM "../poky.ent"> %poky; ] > | ||
4 | |||
5 | <chapter id='overview-concepts'> | ||
6 | <title>Yocto Project Concepts</title> | ||
7 | |||
8 | <para> | ||
9 | This chapter presents key Yocto Project concepts. | ||
10 | </para> | ||
11 | |||
12 | <section id='x32'> | ||
13 | <title>x32 psABI</title> | ||
14 | |||
15 | <para> | ||
16 | x32 processor-specific Application Binary Interface | ||
17 | (<ulink url='https://software.intel.com/en-us/node/628948'>x32 psABI</ulink>) | ||
18 | is a native 32-bit processor-specific ABI for | ||
19 | <trademark class='registered'>Intel</trademark> 64 (x86-64) | ||
20 | architectures. | ||
21 | An ABI defines the calling conventions between functions in a | ||
22 | processing environment. | ||
23 | The interface determines what registers are used and what the sizes are | ||
24 | for various C data types. | ||
25 | </para> | ||
26 | |||
27 | <para> | ||
28 | Some processing environments prefer using 32-bit applications even when | ||
29 | running on Intel 64-bit platforms. | ||
30 | Consider the i386 psABI, which is a very old 32-bit ABI for Intel | ||
31 | 64-bit platforms. | ||
32 | The i386 psABI does not provide efficient use and access of the | ||
33 | Intel 64-bit processor resources, leaving the system underutilized. | ||
34 | Now consider the x86_64 psABI. | ||
35 | This ABI is newer and uses 64-bits for data sizes and program pointers. | ||
36 | The extra bits increase the footprint size of the programs, libraries, | ||
37 | and also increases the memory and file system size requirements. | ||
38 | Executing under the x32 psABI enables user programs to utilize CPU | ||
39 | and system resources more efficiently while keeping the memory | ||
40 | footprint of the applications low. | ||
41 | Extra bits are used for registers but not for addressing mechanisms. | ||
42 | </para> | ||
43 | |||
44 | <para> | ||
45 | The Yocto Project supports the final specifications of x32 psABI | ||
46 | as follows: | ||
47 | <itemizedlist> | ||
48 | <listitem><para> | ||
49 | You can create packages and images in x32 psABI format on | ||
50 | x86_64 architecture targets. | ||
51 | </para></listitem> | ||
52 | <listitem><para> | ||
53 | You can successfully build recipes with the x32 toolchain. | ||
54 | </para></listitem> | ||
55 | <listitem><para> | ||
56 | You can create and boot | ||
57 | <filename>core-image-minimal</filename> and | ||
58 | <filename>core-image-sato</filename> images. | ||
59 | </para></listitem> | ||
60 | <listitem><para> | ||
61 | RPM Package Manager (RPM) support exists for x32 binaries. | ||
62 | </para></listitem> | ||
63 | <listitem><para> | ||
64 | Support for large images exists. | ||
65 | </para></listitem> | ||
66 | </itemizedlist> | ||
67 | </para> | ||
68 | |||
69 | <para> | ||
70 | For steps on how to use x32 psABI, see the | ||
71 | "<ulink url='&YOCTO_DOCS_DEV_URL;#using-x32-psabi'>Using x32 psABI</ulink>" | ||
72 | section in the Yocto Project Development Tasks Manual. | ||
73 | </para> | ||
74 | </section> | ||
75 | </chapter> | ||
76 | <!-- | ||
77 | vim: expandtab tw=80 ts=4 | ||
78 | --> | ||
diff --git a/documentation/overview-manual/overview-manual.xml b/documentation/overview-manual/overview-manual.xml index 9af914a924..fe021073da 100644 --- a/documentation/overview-manual/overview-manual.xml +++ b/documentation/overview-manual/overview-manual.xml | |||
@@ -86,6 +86,8 @@ | |||
86 | 86 | ||
87 | <xi:include href="overview-development-environment.xml"/> | 87 | <xi:include href="overview-development-environment.xml"/> |
88 | 88 | ||
89 | <xi:include href="overview-concepts.xml"/> | ||
90 | |||
89 | </book> | 91 | </book> |
90 | <!-- | 92 | <!-- |
91 | vim: expandtab tw=80 ts=4 | 93 | vim: expandtab tw=80 ts=4 |