Change "triplet" (target triplet) to "tuple". That sounds better!

Document overriding the number of // jobs.
Some small documentation fixes.
This commit is contained in:
Yann E. MORIN" 2007-08-15 16:18:35 +00:00
parent ecab7e451f
commit 09f0dcc66f
7 changed files with 41 additions and 26 deletions

View File

@ -74,9 +74,9 @@ config TARGET_VENDOR
prompt "Vendor string" prompt "Vendor string"
default "unknown" default "unknown"
help help
Vendor part of the machine triplet. Vendor part of the target tuple.
A triplet is of the form arch-vendor-kernel-system. A tuple is of the form arch-vendor-kernel-system.
You can set the second part, vendor, to whatever you see fit. You can set the second part, vendor, to whatever you see fit.
Use a single word, or use underscores "_" to separate words. Use a single word, or use underscores "_" to separate words.
@ -88,7 +88,7 @@ config TARGET_ALIAS_SED_EXPR
default "" default ""
help help
Normaly, you'd call your toolchain components (especially gcc) by Normaly, you'd call your toolchain components (especially gcc) by
prefixing the target triplet followed by a dash and the component name prefixing the target tuple followed by a dash and the component name
(eg. armeb-unknown-linux-uclibc-gcc). (eg. armeb-unknown-linux-uclibc-gcc).
You can enter here a sed expression to be applied to ${CT_TARGET} to You can enter here a sed expression to be applied to ${CT_TARGET} to
@ -107,7 +107,7 @@ config TARGET_ALIAS
default "" default ""
help help
Normaly, you'd call your toolchain components (especially gcc) by Normaly, you'd call your toolchain components (especially gcc) by
prefixing the target triplet followed by a dash and the component name prefixing the target tuple followed by a dash and the component name
(eg. armeb-unknown-linux-uclibc-gcc). (eg. armeb-unknown-linux-uclibc-gcc).
You can enter a shortcut here. This string will be used to create You can enter a shortcut here. This string will be used to create
@ -167,7 +167,7 @@ config TOOLCHAIN_TYPE
config BUILD config BUILD
string string
prompt "Build system triplet" prompt "Build system tuple"
default "" default ""
help help
Canonical name of the machine building the toolchain. Canonical name of the machine building the toolchain.
@ -187,7 +187,7 @@ config CC_NATIVE
config HOST config HOST
string string
prompt "Host system triplet" prompt "Host system tuple"
default "" default ""
depends on NATIVE || CANADIAN depends on NATIVE || CANADIAN
help help

View File

@ -49,7 +49,7 @@ file, and ask for newer options if there are any.
Save the current Save the current
.B crosstool-NG .B crosstool-NG
configuration, and associated components' config files, into a sample. Samples configuration, and associated components' config files, into a sample. Samples
are saved in their own sub-directory, named after the target's triplet, in the are saved in their own sub-directory, named after the target's tuple, in the
.I samples .I samples
sub-directory of the current directory. sub-directory of the current directory.
If that was not clear: If that was not clear:
@ -57,7 +57,7 @@ If that was not clear:
Samples can be later recalled by calling Samples can be later recalled by calling
.B ct-ng .B ct-ng
with the target triplet they represent. with the target tuple they represent.
." ."
.TP .TP
.B build .B build
@ -149,7 +149,7 @@ entire important directories could be removed (eg.
.IR /usr ), .IR /usr ),
although although
.B crosstool-NG .B crosstool-NG
will refuse to install in some well known critical directories. will refuse to install toolchains in some well known critical directories.
." ."
.SH AUTHORS .SH AUTHORS
.MTO "yann.morin.1998@anciens.enib.fr" "Yann E. MORIN" "" .MTO "yann.morin.1998@anciens.enib.fr" "Yann E. MORIN" ""

View File

@ -164,7 +164,7 @@ There are three environment variables that are computed by crosstool-NG, and
that you can use: that you can use:
CT_TARGET: CT_TARGET:
It represents the target triplet you are building for. You can use it for It represents the target tuple you are building for. You can use it for
example in the installation/prefix directory, such as: example in the installation/prefix directory, such as:
/opt/x-tools/${CT_TARGET} /opt/x-tools/${CT_TARGET}
@ -190,13 +190,13 @@ CT_LOCAL_TARBALLS_DIR:
CT_PREFIX_DIR: CT_PREFIX_DIR:
This is where the toolchain will be installed in (and for now, where it This is where the toolchain will be installed in (and for now, where it
will run from). Common use it to add the target triplet in the directory will run from). Common use it to add the target tuple in the directory
path, such as (see above): path, such as (see above):
/opt/x-tools/${CT_TARGET} /opt/x-tools/${CT_TARGET}
CT_TARGET_VENDOR: CT_TARGET_VENDOR:
An identifier for your toolchain, will take place in the vendor part of the An identifier for your toolchain, will take place in the vendor part of the
target triplet. It shall *not* contain spaces or dashes. Usually, keep it target tuple. It shall *not* contain spaces or dashes. Usually, keep it
to a one-word string, or use underscores to separate words if you need. to a one-word string, or use underscores to separate words if you need.
Avoid dots, commas, and special characters. Avoid dots, commas, and special characters.
@ -297,6 +297,21 @@ Testing all toolchains at once |
You can test-build all samples; simply call: You can test-build all samples; simply call:
ct-ng regtest ct-ng regtest
Overriding the number of // jobs |
---------------------------------*
If you want to override the number of jobs to run in // (the -j option to
make), you can either re-enter the menuconfig, or simply add it on the command
line, as such:
ct-ng build.4
which tells crosstool-NG to override the number of // jobs to 4.
You can see the actions that support overriding the number of // jobs in
the help menu. Those are the ones with [.#] after them (eg. build[.#] or
regtest[.#], and so on...).
_______________________ _______________________
/ /
Using the toolchain / Using the toolchain /
@ -306,19 +321,19 @@ Using the toolchain is as simple as adding the toolchain's bin directory in
your PATH, such as: your PATH, such as:
export PATH="${PATH}:/your/toolchain/path/bin" export PATH="${PATH}:/your/toolchain/path/bin"
and then using the target triplet to tell the build systems to use your and then using the target tuple to tell the build systems to use your
toolchain: toolchain:
./configure --target=your-target-triplet ./configure --target=your-target-tuple
or or
make CC=your-target-triplet-gcc make CC=your-target-tuple-gcc
or or
make CROSS_COMPILE=your-target-triplet- make CROSS_COMPILE=your-target-tuple-
and so on... and so on...
When your root directory is ready, it is still missing some important bits: the When your root directory is ready, it is still missing some important bits: the
toolchain's libraries. To populate your root directory with those libs, just toolchain's libraries. To populate your root directory with those libs, just
run: run:
your-target-triplet-populate -s /your/root -d /your/root-populated your-target-tuple-populate -s /your/root -d /your/root-populated
This will copy /your/root into /your/root-populated, and put the needed and only This will copy /your/root into /your/root-populated, and put the needed and only
the needed libraries there. Thus you don't polute /your/root with any cruft that the needed libraries there. Thus you don't polute /your/root with any cruft that

View File

@ -72,8 +72,8 @@ CT_HasOrAbort lynx
CT_DoLog INFO "Building environment variables" CT_DoLog INFO "Building environment variables"
# Target triplet: CT_TARGET needs a little love: # Target tuple: CT_TARGET needs a little love:
CT_DoBuildTargetTriplet CT_DoBuildTargetTuple
# Kludge: If any of the configured options needs CT_TARGET, # Kludge: If any of the configured options needs CT_TARGET,
# then rescan the options file now: # then rescan the options file now:

View File

@ -480,12 +480,12 @@ CT_DoConfigSub() {
fi fi
} }
# Compute the target triplet from what is provided by the user # Compute the target tuple from what is provided by the user
# Usage: CT_DoBuildTargetTriplet # Usage: CT_DoBuildTargetTuple
# In fact this function takes the environment variables to build the target # In fact this function takes the environment variables to build the target
# triplet. It is needed both by the normal build sequence, as well as the # tuple. It is needed both by the normal build sequence, as well as the
# sample saving sequence. # sample saving sequence.
CT_DoBuildTargetTriplet() { CT_DoBuildTargetTuple() {
case "${CT_ARCH_BE},${CT_ARCH_LE}" in case "${CT_ARCH_BE},${CT_ARCH_LE}" in
y,) target_endian_eb=eb; target_endian_el=;; y,) target_endian_eb=eb; target_endian_el=;;
,y) target_endian_eb=; target_endian_el=el;; ,y) target_endian_eb=; target_endian_el=el;;

View File

@ -18,8 +18,8 @@ rm -f "${tmp_log_file}"
CT_TestOrAbort "Configuration file not found. Please create one." -f "${CT_TOP_DIR}/.config" CT_TestOrAbort "Configuration file not found. Please create one." -f "${CT_TOP_DIR}/.config"
. "${CT_TOP_DIR}/.config" . "${CT_TOP_DIR}/.config"
# Target triplet: CT_TARGET needs a little love: # Target tuple: CT_TARGET needs a little love:
CT_DoBuildTargetTriplet CT_DoBuildTargetTuple
# Kludge: if any of the config options needs either CT_TARGET or CT_TOP_DIR, # Kludge: if any of the config options needs either CT_TARGET or CT_TOP_DIR,
# re-parse them: # re-parse them:

View File

@ -16,7 +16,7 @@ rm -f "${tmp_log_file}"
# Parse the configuration file: # Parse the configuration file:
. ${CT_TOP_DIR}/.config . ${CT_TOP_DIR}/.config
CT_DoBuildTargetTriplet CT_DoBuildTargetTuple
# Kludge: if any of the config options needs either CT_TARGET or CT_TOP_DIR, # Kludge: if any of the config options needs either CT_TARGET or CT_TOP_DIR,
# re-parse them: # re-parse them: