Provided by: dpkg-cross_2.3.0.1_all bug

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 --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.

       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,  dpkg-
       cross 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/dpkg-
       cross/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.

                                                                 DPKG-CROSS(1)