dpkg-cross(1)
NAME
dpkg-cross -- a tool to manage debian cross-compile environment
SYNOPSIS
dpkg-cross [-v | --verbose ] [-q | --quiet ] [-A | --convert-anyway ] [-X | --exclude ] [-k | --keep-temp ] { [-i | --install ] | [-b | --build ] | [-r | --remove | --purge ] | [-s --status ] | [-l | --list ] | [-L | --list-files ] | [-u --update ] | [-Q | --query ] } {-a | --arch architecture} package [package ... ]
DESCRIPTION
dpkg-cross is a tool to install and manage libraries and header files
for cross compiling. dpkg-cross converts native Debian packages for the
target architecture to cross compiling support 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 --fsystarfile.
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/crosscompile; see cross-compile(5) for more information.
dpkg-cross has a very limited future. Some functionality has already been migrated into dpkg, some functionality has been dropped during the rewrite to support dpkg and the rewritten apt-cross. Eventually, dpkgcross will merge into dpkg and apt-cross is likely to merge into apt.
OPTIONS
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 using the -X|--exclude option.
- -X|--exclude
- Removes the specified package from the dependencies of the current package. Typically used to drop dependencies on packages that are not required within a cross-build environment, e.g. packages containing only executables or architecture independent files.
- dpkg-cross can only check the current package and information about a dependency is not available. By default, dpkg-cross converts all dependencies to specify the cross version of the dependency package. If you know that a particular dependency should not be converted (it provides no useful files or is architecture independent), that dependency can be excluded and dpkg-cross will remove that package from the dependency information.
- -X|--exclude PACKAGE needs to be repeated for each package to be excluded.
- -k|--keep-temp
- Keep the built and installed package instead of deleting it. Useful with apt-cross -k. Requires --install.
- -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.
FILES
/etc/dpkg-cross/cross-compile
SEE ALSO
dpkg-cross(1), cross-compile(5), /usr/share/doc/dpkgcross/README.Debian.gz
AUTHOR
Roman Hodek <roman@hodek.net>
Rewritten for 2.0.0 by Neil Williams codehelp@debian.org.
VERSION
Version: 2.0.0
COPYRIGHT
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.