Override the dpkg-cross default architecture.

emsetup tries to determine the current default architecture setting of dpkg-cross - managed by debconf in dpkg-cross (>= 1.33). Prior to version 1.33, dpkg-cross used ~/.dpkg-cross/cross-compile, copied from /etc/dpkg-cross/cross-compile and manually edited to update the default_arch:

# default architecture for dpkg-cross (to avoid always typing the -a option
# if you do cross installations only for one architecture)
# default_arch =

Summarise the changes required to enable cross-building for your selected architecture on this system without making any changes, then exit. emsetup will run through each of the checks and determine if you need an additional source in /etc/apt/sources.list. If you choose to add this source manually, ensure you run 'sudo apt-get update' before restarting emsetup. Next, emsetup will output a list of toolchain packages that are needed to build your chosen architecture on this system. If these packages are not available in the current emdebian toolchain repository, emsetup will output a hint about using emchain. Packages that are available but not installed can be checked for installability using the --report option to emsetup.

-s is ignored if --report is used.

Proceed with the toolchain installation without getting a prompt from the apt-agent (either apt-get or aptitude according to debconf or ~/.apt-cross/emsource preferences).

View the status of packages that emsetup has either installed or checked to support cross-building for the default or specified architecture. If the required packages are not installed, emsetup prints a list of the package names that were checked and runs edos-debcheck to test that the toolchain packages are installable on your system. If edos-debcheck reports that any toolchain packages fail, please ask for help on the debian-embedded mailing list: http://lists.debian.org/debian-embedded/ <debian-embedded@lists.debian.org>, attaching the emsetup report.

Sometimes, the Emdebian toolchains get behind the version of gcc in Debian itself and problems in the later version of gcc could mean that it does not build cleanly so emchain cannot fill the gap. In this situation, there will be a delay in providing an updated Emdebian toolchain for the new version but emsetup will not be able to install the old one on new installations. This can be a complicated situation but it may be possible to force the installation of the toolchain using dpkg --force-depends.

Download tries to help you, a little bit. VERSION specifies the version of gcc that you want to be able to use, e.g. for gcc-4.2, specify 4.2. The relevant gcc packages for your selected architecture are downloaded from the Emdebian repository. Supporting packages are downloaded using apt-cross. Packages that are already installed are omitted.

With the necessary files available, emsetup can do no more for you - see dpkg-cross (1) for information on how to build suitable cross packages from the foreign binaries. Use dpkg --force-depends on the packages that have the correct architecture. (e.g. to build for ARM on amd64, use dpkg-cross on the ARM packages and dpkg --force-depends on the amd64 packages.)

It is best to use dpkg-cross -b not dpkg-cross -i because it is very likely that you will need to use sudo dpkg --force-depends -i to actually install most (all?) of the toolchain packages. This part of the process needs to be done manually because if an automated method was likely to work, --download would be unnecessary. Other packages may also be necessary, these should be downloaded using apt-cross, using --force if an old version is already installed.

If this method still fails, ensure that you use:

$ sudo apt-get -f install
        

to try to tidy up the mess left behind.

Even if the installation succeeds, it is worth checking the installation with the above command or you may come up against problems with installing other packages.

be verbose. -v can be repeated to increase verbosity, up to a maximum of three times. When running emsetup directly, it is recommended to use at least one -v option.

be quiet (default) - can also be used to reduce verbosity set using -v.