summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/overview.txt65
1 files changed, 46 insertions, 19 deletions
diff --git a/docs/overview.txt b/docs/overview.txt
index 375c064..0c78e61 100644
--- a/docs/overview.txt
+++ b/docs/overview.txt
@@ -493,24 +493,15 @@ The "functions" file API:
the endianness suffixes
+ return value: 0 upon success, !0 upon failure
+ provides:
- - the environment variable CT_KERNEL_ARCH
- - optional
- - contains:
- the architecture name as understandable by the Linux kernel build
- system.
- Eg.: "arm" for an ARM
- "powerpc" for a PowerPC
- "i386" for an x86
- + provides:
- - the environment variable CT_TARGET_ARCH
- mandatory
+ - the environment variable CT_TARGET_ARCH
- contains:
the architecture part of the target tuple.
Eg.: "armeb" for big endian ARM
"i386" for an i386
+ provides:
- - the environment variable CT_TARGET_SYS
- optional
+ - the environment variable CT_TARGET_SYS
- contain:
the sytem part of the target tuple.
Eg.: "gnu" for glibc on most architectures
@@ -519,17 +510,53 @@ The "functions" file API:
- for glibc-based toolchain: "gnu"
- for uClibc-based toolchain: "uclibc"
+ provides:
- - the environment variable CT_ARCH_ENDIAN_OPT
- optional
+ - the environment variable CT_KERNEL_ARCH
- contains:
- the compiler option to set the endianness.
- Eg.: "-ml" for a Super-H little endian
- "-mbig-endian" for an ARM big endian
- /empty/ for x86 and x86_64
+ the architecture name as understandable by the Linux kernel build
+ system.
+ Eg.: "arm" for an ARM
+ "powerpc" for a PowerPC
+ "i386" for an x86
- defaults to:
- - for bi-endian big endian architectures: "-mbig-endian"
- - for bi-endian little endian architectures: "-mlittle-endian"
- - for single-endian architectures: /empty/
+ ${CT_ARCH}
+ + provides:
+ - optional
+ - the environment variables to configure the cross-gcc
+ - CT_ARCH_WITH_ARCH
+ - CT_ARCH_WITH_ABI
+ - CT_ARCH_WITH_CPU
+ - CT_ARCH_WITH_TUNE
+ - CT_ARCH_WITH_FPU
+ - CT_ARCH_WITH_FLOAT
+ - contain (defaults):
+ - CT_ARCH_WITH_ARCH : the gcc ./configure switch to select architecture level ( "--with-arch=${CT_ARCH_ARCH}" )
+ - CT_ARCH_WITH_ABI : the gcc ./configure switch to select ABI level ( "--with-abi=${CT_ARCH_ARCH}" )
+ - CT_ARCH_WITH_CPU : the gcc ./configure switch to select CPU instruction set ( "--with-cpu=${CT_ARCH_ARCH}" )
+ - CT_ARCH_WITH_TUNE : the gcc ./configure switch to select scheduling ( "--with-tune=${CT_ARCH_ARCH}" )
+ - CT_ARCH_WITH_FPU : the gcc ./configure switch to select FPU type ( "--with-fpu=${CT_ARCH_ARCH}" )
+ - CT_ARCH_WITH_FLOAT : the gcc ./configure switch to select floating point arithmetics ( "--with-float=soft" or /empty/ )
+ + provides:
+ - optional
+ - the environment variables to pass to the cross-gcc to build target binaries
+ - CT_ARCH_ARCH_CFLAG
+ - CT_ARCH_ABI_CFLAG
+ - CT_ARCH_CPU_CFLAG
+ - CT_ARCH_TUNE_CFLAG
+ - CT_ARCH_FPU_CFLAG
+ - CT_ARCH_FLOAT_CFLAG
+ - CT_ARCH_ENDIAN_CFLAG
+ - contain (defaults):
+ - CT_ARCH_ARCH_CFLAG : the gcc switch to select architecture level ( "-march=${CT_ARCH_ARCH}" )
+ - CT_ARCH_ABI_CFLAG : the gcc switch to select ABI level ( "-mabi=${CT_ARCH_AABI}" )
+ - CT_ARCH_CPU_CFLAG : the gcc switch to select CPU instruction set ( "-mcpu=${CT_ARCH_CPU}" )
+ - CT_ARCH_TUNE_CFLAG : the gcc switch to select scheduling ( "-mtune=${CT_ARCH_TUNE}" )
+ - CT_ARCH_FPU_CFLAG : the gcc switch to select FPU type ( "-mfpu=${CT_ARCH_FPU}" )
+ - CT_ARCH_FLOAT_CFLAG : the gcc switch to choose floating point arithmetics ( "-msoft-float" or /empty/ )
+ - CT_ARCH_ENDIAN_CFLAG : the gcc switch to choose big or little endian ( "-mbig-endian" or "-mlittle-endian" )
+ - default to:
+ see above.
+
Build scripts |
--------------*