dpkg-cross - a tool to manage debian cross-compile environment

dpkg-cross [-v | --verbose ] [-q | --quiet ] [-A | --convert-anyway ] { [-i | --install ] | [-b | --build ] | [-r | --remove | --purge ] | [-s | --status ] | [-l | --list ] | [-L | --list-files ] | [-u | --update ] | [-Q | --query ] } {-a | --arch architecture} package [package ... ]

dpkg-cross is a tool to install and manage libraries and header files for cross compiling. On installation, it converts native Debian packages for the target architecture to cross compiling packages that can be installed on any architecture, but in different paths to avoid conflicts. It then calls dpkg to install the converted package. The conversion step alone can be done with the --build option. Other options are wrappers around corresponding dpkg functionality.

dpkg-cross is intended to make it easier for you to keep your cross compiling libraries up-to-date, as it works directly on Debian packages. It saves you copying the libs and headers from a machine with your target architecture, or extracting them via dpkg-deb --fsys-tarfile.

dpkg-cross also collects and install the .shlibs files in -dev packages, which are needed by dpkg-shlibdeps.

dpkg-cross works in the directories defined in /etc/dpkg-cross/cross-compile; see cross-compile(5) for more information.

The program follows the usual GNU command line syntax, with long options starting with two dashes (`-').

-h, --help

Show summary of options.

-v, --verbose

Be more verbose.

-q, --quiet

Be more quiet.

-a, --arch architecture

Install for architecture architecture.

-i, --install

Install Debian packages (.deb) named on the command line. Only files in the directories /lib, /usr/lib, /usr/X11R6/lib, /usr/include and /usr/X11R6/include are extracted, since only they can be relevant for cross compiling. In the lib directories, also no subdirectories are extracted.

-A, --convert-anyway

Convert Debian package even if it does not provide any files useful for cross-compile environment. This option may be used to create dummy packages that satisfy dependences of other packages. Note that in many cases need for such dummy packages may be avoided by tuning removedeps value in cross-compile(5) file.

-b, --build

Just build the converted Debian package, but do not install it with dpkg.

-r, --remove

Remove the cross compiling packages named on the command line.

-s, --status

Print status of the named packages.

-l, --list

Print short version of status of named packages or package name patterns.

-L, --list-files

List files belonging to the named packages.

-u, --update

Update current cross-installation with Debian packages found in/under the paths given as arguments. Will check all packages there if they're installed already as cross-compiling packages and if they're really updates. Those packages will be installed as with -i.

-Q, --query

Much like --update, but just prints available update packages and does not install them.

/etc/dpkg-cross/cross-compile

dpkg-cross(1), cross-compile(5), /usr/share/doc/dpkg-cross/README.Debian.gz

Roman Hodek <roman@hodek.net>

$Revision: 1.3 $

Copyright © 1997 Roman Hodek This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.