From e2060287db8093b53d2d18a217c0c463eb6b0c86 Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Tue, 9 Jan 2018 15:53:40 -0800 Subject: 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 Signed-off-by: Richard Purdie --- .../overview-manual/overview-concepts.xml | 78 ++++++++++++++++++++++ documentation/overview-manual/overview-manual.xml | 2 + 2 files changed, 80 insertions(+) create mode 100644 documentation/overview-manual/overview-concepts.xml (limited to 'documentation/overview-manual') 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 @@ + %poky; ] > + + +Yocto Project Concepts + + + This chapter presents key Yocto Project concepts. + + +
+ x32 psABI + + + x32 processor-specific Application Binary Interface + (x32 psABI) + is a native 32-bit processor-specific ABI for + Intel 64 (x86-64) + architectures. + An ABI defines the calling conventions between functions in a + processing environment. + The interface determines what registers are used and what the sizes are + for various C data types. + + + + Some processing environments prefer using 32-bit applications even when + running on Intel 64-bit platforms. + Consider the i386 psABI, which is a very old 32-bit ABI for Intel + 64-bit platforms. + The i386 psABI does not provide efficient use and access of the + Intel 64-bit processor resources, leaving the system underutilized. + Now consider the x86_64 psABI. + This ABI is newer and uses 64-bits for data sizes and program pointers. + The extra bits increase the footprint size of the programs, libraries, + and also increases the memory and file system size requirements. + Executing under the x32 psABI enables user programs to utilize CPU + and system resources more efficiently while keeping the memory + footprint of the applications low. + Extra bits are used for registers but not for addressing mechanisms. + + + + The Yocto Project supports the final specifications of x32 psABI + as follows: + + + You can create packages and images in x32 psABI format on + x86_64 architecture targets. + + + You can successfully build recipes with the x32 toolchain. + + + You can create and boot + core-image-minimal and + core-image-sato images. + + + RPM Package Manager (RPM) support exists for x32 binaries. + + + Support for large images exists. + + + + + + For steps on how to use x32 psABI, see the + "Using x32 psABI" + section in the Yocto Project Development Tasks Manual. + +
+ + 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 @@ + +