diff options
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 |