Name

gccross — a deprecated wrapper for GCC calls in a cross-compile aware manner

SYNOPSIS

gccross [[ any parameter will be forwarded to GCC ]]

DESCRIPTION

The purpose of this script is to be removed. It is already opt-in only and once Lenny is released, every package using the opt-in will be declared buggy in buildd.emdebian.org with a view to having a permanent fix in that package before Squeeze. In many cases, fixes to replace gccross will need patches to upstream code (and therefore NMU's in Debian). Support will be retained in emdebian-tools to assist with new packages but this is to remain an interim support step that should not be relied upon for a package in a stable Emdebian release after Emdebian 1.0.

gccross is a deprecated tool to change pathnames of GCC command line arguments -I, -L and any standalone full qualified file name, as defined in the cross-compile configuration file, until such time as a proper fix can be made in the relevant package.

The conversion rules are the same as used by dpkg-cross so in most cases use of gccross allows you to cross-build your package without changes to the Makefiles in order to fix other problems. The Makefile does still need to be fixed eventually.

gccross is now only implemented in builds using emdebuild from emdebian-tools and only if the debian/xcontrol file includes the [X-]Build-Cross-Libtool: yes opt-in. Using gccross means that the package is broken and needs to be fixed.

gccross searches in PATH for cross-compiler executable, skipping itself automatically.

When converting arguments, gccross does not modify any pathnames that point to GCC library directory /usr/lib/gcc-lib and its subdirectories, as well as directories that contain headers and libraries for the target.

FILES

/etc/dpkg-cross/cross-compile

SEE ALSO

dpkg-cross (1), emdebuild (1), http://www.emdebian.org/emdebian/intro.html#gccross.

AUTHORS

gccross was written by Raphael Bossek and adapted by Neil Williams