From 35549a7a45ef63f87f37b0a45a0a9fe1c2c59af0 Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Fri, 23 Feb 2018 11:23:35 -0800 Subject: dev-manual, concepts-manual: Moved x32 section I had split up the section on x32 into a concept piece and a "how-to" piece earlier in order to satisfy outside pressure to isolate all "how-to" stuff in the dev-manual. Doing this put a "conceptual" blurb about x32 in the new concepts-manual. It has been decided that x32 is not a concept. It really does not fit into the ref-manual either. So, I have re-combined the intro blurb of the x32 stuff back as the beginning piece of the "Usingt x32 psABI" section in the dev-manual. (From yocto-docs rev: 6e8240cc1a90a8d78ff456d3138c525eceea3ee3) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- .../dev-manual/dev-manual-common-tasks.xml | 56 ++++++++++++++++++++-- 1 file changed, 51 insertions(+), 5 deletions(-) (limited to 'documentation/dev-manual') diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml index 60af73d0ed..20a38322b1 100644 --- a/documentation/dev-manual/dev-manual-common-tasks.xml +++ b/documentation/dev-manual/dev-manual-common-tasks.xml @@ -4799,11 +4799,57 @@ is a native 32-bit processor-specific ABI for Intel 64 (x86-64) architectures. - - For more information on x32 psABI, see the - "x32 psABI" - section in the Yocto Project Concepts Manual. - + 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. + + + + + To use the x32 psABI, you need to edit your conf/local.conf configuration file as follows: -- cgit v1.2.3-54-g00ecf