Provided by: dpkg-cross_1.26_all bug

NAME

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

SYNOPSIS

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

DESCRIPTION

       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.

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

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>

VERSION

       $Revision: 1.3 $

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)