cookutils annotate doc/cross.txt @ rev 364

cross: improve doc
author Christophe Lincoln <pankso@slitaz.org>
date Wed May 09 23:05:01 2012 +0200 (2012-05-09)
parents e7e7979eb49d
children e31ed673ab5d
rev   line source
pankso@361 1
pankso@361 2 SYNOPSIS
pankso@361 3 cross [command|package] package
pankso@361 4
pankso@361 5 DESCRIPTION
pankso@361 6 Cross is a tool to build a cross toolchain on SliTaz GNU/Linux. The
pankso@361 7 ARM platform is actually supported and x86_64 toolchain is on the
pankso@361 8 stove
pankso@361 9
pankso@361 10 COMMANDS
pankso@361 11 Run: cross usage
pankso@361 12
pankso@361 13 OPTIONS
pankso@361 14 --log clean: Will also clean log files
pankso@361 15 --install check-env: Install needed packages
pankso@361 16
pankso@361 17 HOWTO:
pankso@361 18 When building a cross toolchain it's better to understand what is a
pankso@361 19 linker or or C compiler such as GCC. The configure option --target is
pankso@361 20 used by 'cross' to build cross-tools. When the toolchain is build on
pankso@364 21 your machine you can then build packages with cook and the wok. Cross
pankso@364 22 use by default the same source tarball's than cook by path can by
pankso@364 23 changed via the config file. Configuration is: cross.conf. Here is a
pankso@364 24 cmdline howto:
pankso@361 25
pankso@364 26 Create a chroot (use last tazdev)
pankso@364 27 ---------------------------------
pankso@361 28 # tazdev gen-chroot --arch=arm
pankso@361 29 # tazdev chroot
pankso@361 30
pankso@364 31 Clone cookutils to get last cook and cross
pankso@364 32 ------------------------------------------
pankso@361 33 # tazpkg -gi mercurial
pankso@361 34 # tazpkg -gi make
pankso@361 35 # cd && hg clone http://hg.slitaz.org/cookutils
pankso@361 36 # cd cookutils
pankso@361 37 # make install-cross
pankso@361 38
pankso@364 39 Setup the build environment and compile a cross toolchain
pankso@364 40 -------------------------------------------------------------
pankso@361 41 # cook setup
pankso@361 42 # cook arm-setup
pankso@361 43 # mkdir -p /home/slitaz/cross
pankso@361 44 # cd /home/slitaz/cross
pankso@361 45 # cp /etc/slitaz/cross.conf .
pankso@361 46 (vi/nano config)
pankso@361 47 # cross check-env --install
pankso@361 48 # cross compile
pankso@361 49
pankso@364 50 Test the cross toolchain
pankso@364 51 ------------------------
pankso@361 52 # cross testsuite
pankso@361 53
pankso@361 54 AUTHOR
pankso@361 55 Written by Christophe Lincoln