mirror of
https://github.com/crosstool-ng/crosstool-ng.git
synced 2024-12-22 06:07:49 +00:00
9265403b8b
Homogenise the references to crosstool-NG: - the project is named "crosstool-NG" - the front-end is named "ct-ng" - don't use shortcuts (such as "ct-ng" to stand for "crosstool-NG") Default action is to print help. Don't speak of make rules when dumping help, just speak of actions.
171 lines
4.0 KiB
Groff
171 lines
4.0 KiB
Groff
." crosstool-NG man page
|
|
." Copyright 2007 Yann E. MORIN
|
|
." Licensed under the Creative Commons BY-SA, v2.5
|
|
."
|
|
." Beautifying URLs
|
|
.mso www.tmac
|
|
."
|
|
.TH crosstool-NG 1 "@@CT_DATE@@" "version @@CT_VERSION@@" "User Commands"
|
|
."
|
|
."
|
|
.SH NAME
|
|
ct-ng, crosstool-NG \- Build cross-toolchains
|
|
."
|
|
."
|
|
.SH SYNOPSIS
|
|
.B ct-ng ACTION
|
|
."
|
|
."
|
|
.SH DESCRIPTION
|
|
Building a cross-toolchain can be a real pain.
|
|
.PP
|
|
.B crosstool-NG
|
|
makes it easy to build cross-toolchains, and allows you to take all the juice
|
|
out of your target by configuring the differents components of the toolchain
|
|
accordingly to the targeted processor.
|
|
."
|
|
."
|
|
.SH ACTIONS
|
|
Here are the most commonly used actions. For other actions, please see
|
|
.I @@CT_DOCDIR@@/overview.txt
|
|
.TP
|
|
.B help
|
|
Prints a little help text.
|
|
."
|
|
.TP
|
|
.B menuconfig
|
|
Configures
|
|
.B crosstool-NG
|
|
using a configurator menu very similar to that of the Linux kernel.
|
|
."
|
|
.TP
|
|
.B oldconfig
|
|
Apply options found in an existing
|
|
.I .config
|
|
file, and ask for newer options if there are any.
|
|
."
|
|
.TP
|
|
.B saveconfig
|
|
Save the current
|
|
.B crosstool-NG
|
|
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
|
|
.I samples
|
|
sub-directory of the current directory.
|
|
If that was not clear:
|
|
.I `pwd`/samples/${CT_TARGET}/
|
|
|
|
Samples can be later recalled by calling
|
|
.B ct-ng
|
|
with the target triplet they represent.
|
|
."
|
|
.TP
|
|
.B build
|
|
Builds the configured toolchain.
|
|
."
|
|
.TP
|
|
.B liststeps
|
|
Lists all build steps available (see
|
|
.BR ENVIRONMENT,
|
|
below).
|
|
."
|
|
.TP
|
|
.B clean
|
|
Remove files generated by
|
|
.B crosstool-NG
|
|
for itself (these are mostly the configurators' binaries).
|
|
."
|
|
.TP
|
|
.B distclean
|
|
Same as
|
|
.B clean
|
|
, but also removes the toolchain build directory, the downloaded files and the
|
|
.I .config
|
|
configuration file. The generated toolchain is left untouched, as well as
|
|
samples which are not removed.
|
|
."
|
|
.TP
|
|
.B regtest
|
|
Calls the
|
|
.B crosstool-NG
|
|
regression test suite. All samples are build, and the regression test suite is
|
|
run against every one of them.
|
|
."
|
|
.TP
|
|
.B updatetools
|
|
Updates the
|
|
.I config.guess
|
|
and
|
|
.I config.sub
|
|
scripts. These scripts are used by
|
|
.B crosstool-NG
|
|
to canonicalise the machines' name (host, build and target machines).
|
|
.TP
|
|
.B tarball
|
|
Builds a tarball of the generated toolchain, also saving the scripts from
|
|
.B crosstool-NG
|
|
that are needed to rebuild the target, and also saving the tarballs of the
|
|
componnents that were used.
|
|
."
|
|
.SH ENVIRONMENT
|
|
.TP
|
|
.B STOP, START
|
|
Respectively stops and restarts the build just before this step. To restart a
|
|
step, a previous build should have run at least to that step, or further.
|
|
|
|
The list of steps is vailable with the action
|
|
.BR liststeps .
|
|
."
|
|
.SH EXIT VALUE
|
|
The
|
|
.B ct-ng
|
|
frontend is in fact a
|
|
.BR make (1)
|
|
script. See the man page for
|
|
.BR make (1)
|
|
to have the meaning of the exit values.
|
|
."
|
|
.SH BUGS
|
|
As of today (@@CT_DATE@@), building tarballs is broken. It is difficult to
|
|
foresee how every parts of
|
|
.B crosstool-NG
|
|
are going to be installed. Each parts is needed to build a tarball, as it
|
|
contains all that is needed to rebuild the toolchain from scratch: toolchain
|
|
components' sources,
|
|
.B crosstool-NG
|
|
configuration, but also all
|
|
.B crosstool-NG
|
|
scripts.
|
|
."
|
|
.SH SECURITY
|
|
.B Don't run as root!
|
|
Great care has been taken to avoid mistakes, but bug-free programs don't
|
|
exist. During normal operation,
|
|
.B crosstool-NG
|
|
removes entire directories. If you run as root, and there is a bug or you
|
|
mis-configured
|
|
.BR crosstool-NG ,
|
|
entire important directories could be removed (eg.
|
|
.IR /usr ),
|
|
although
|
|
.B crosstool-NG
|
|
will refuse to install in some well known critical directories.
|
|
."
|
|
.SH AUTHORS
|
|
.MTO "yann.morin.1998@anciens.enib.fr" "Yann E. MORIN" ""
|
|
.URL "http://ymorin.is-a-geek.org" "" ""
|
|
reordered
|
|
.B crosstool
|
|
(see section titled
|
|
.BR "SEE ALSO" )
|
|
scripts to be more easily maintainable, added the Kconfig configurator, some
|
|
patches.
|
|
|
|
Please consult the file
|
|
.I @@CT_DOCDIR@@/CREDITS
|
|
for a list of contributors.
|
|
."
|
|
.SH SEE ALSO
|
|
Please have a look at the
|
|
.URL "http://www.kegel.com/crosstool" "original crosstool" " by Daniel KEGEL"
|