diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index f04846ae36..58bb6012ce 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -4531,6 +4531,38 @@
+
+ Using x32 psABI
+
+
+ x32 processor-specific Application Binary Interface
+ (x32 psABI)
+ 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 Overview Manual.
+
+ To use the x32 psABI, you need to edit your
+ conf/local.conf configuration file as
+ follows:
+
+ MACHINE = "qemux86-64"
+ DEFAULTTUNE = "x86-64-x32"
+ baselib = "${@d.getVar('BASE_LIB_tune-' + (d.getVar('DEFAULTTUNE', True) \
+ or 'INVALID'), True) or 'lib'}"
+
+ Once you have set up your configuration file, use BitBake to
+ build an image that supports the x32 psABI.
+ Here is an example:
+
+ $ bitbake core-image-sato
+
+
+
+
Enabling GObject Introspection Support
diff --git a/documentation/mega-manual/mega-manual.xml b/documentation/mega-manual/mega-manual.xml
index efefa17032..c0838970e5 100644
--- a/documentation/mega-manual/mega-manual.xml
+++ b/documentation/mega-manual/mega-manual.xml
@@ -141,6 +141,9 @@
+
+
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 @@
+
+