.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.ie \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.el \{\
.    de IX
..
.\}
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "EMBUILDDEPS 1"
.TH EMBUILDDEPS 1 "2012-09-26" "perl v5.14.2" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
embuilddeps \- handle native and cross build\-dependency installation.
.SH "Usage"
.IX Header "Usage"
.Vb 1
\& embuilddeps [\-a|\-\-arch] [\-\-use\-sudo]
\&
\& embuilddeps \-?|\-h|\-\-help|\-\-version
.Ve
.SH "Options"
.IX Header "Options"
.Vb 9
\& \-a|\-\-arch:          Install cross packages for the specified arch.
\& \-d|\-\-dir DIR:       Location of the unpacked source (./debian/control)
\&    \-\-dsc DSCFILE:   Path to a .dsc file for the package.
\& \-m|\-\-multiarch:     Make dpkg\-cross convert Multi\-Arch packages.
\& \-k|\-\-preserve:      Pass the \-k option down to xapt.
\& \-v|\-\-verbose:       Make the output more verbose
\& \-q|\-\-quiet:         Make the output less verbose
\& \-n|\-\-dry\-run:       Only output the commands which would be used.
\& \-\-use\-sudo:         Call apt\-get using sudo.
.Ve
.SH "Description"
.IX Header "Description"
\&\f(CW\*(C`embuilddeps\*(C'\fR is a simple build dependency checker for cross-building.
Native build dependencies are checked using the \fIdebian/control\fR file
in the source package being built and installed with \f(CW\*(C`apt\-get\*(C'\fR.
.PP
Cross build dependencies are checked using a \fIdebian/xcontrol\fR file
or the \fIdebian/control\fR file if no xcontrol file exists.
.PP
\&\f(CW\*(C`embuilddeps\*(C'\fR uses \f(CW\*(C`xapt\*(C'\fR to install cross build dependencies.
.SH "Output"
.IX Header "Output"
To see more about what is going on (and to check the results of parsing
the dependencies and architecture limits.
.PP
See also Term::ANSIColor (3) for information on \s-1ANSI_COLORS_DISABLED\s0.
.SH "pbuilder"
.IX Header "pbuilder"
\&\f(CW\*(C`embuilddeps\*(C'\fR can be used as a native and cross-dependency resolver
in a pbuilder chroot using \f(CW\*(C`pbuilder\*(C'\fR, \f(CW\*(C`pdebuild\*(C'\fR or \f(CW\*(C`pdebuild\-cross\*(C'\fR
and supports pbuilder options to locate the chroot and execute
calls within the chroot.
.PP
.Vb 4
\& \-\-control indicates the location of the .dsc file
\& \-\-internal\-chrootexec indicates the command to execute inside the chroot
\& \-\-chroot indicates the location of the chroot
\& \-\-binary\-all is supported as a no\-op by C<embuilddeps>.
.Ve
.PP
If other build tools need particular options to be supported, please
file a wishlist bug against \f(CW\*(C`xapt\*(C'\fR and describe the exact options
which are necessary.
.PP
\&\f(CW\*(C`embuilddeps\*(C'\fR does require that \f(CW\*(C`xapt\*(C'\fR is installed inside the
chroot \- it will try to install it for you but it is much easier if
you install it once and for all. \f(CW\*(C`pdebuild\-cross\*(C'\fR will add \f(CW\*(C`xapt\*(C'\fR
when creating a new chroot. See pdebuild-cross (1) for more
information on how to manipulate a pdebuild-cross chroot after
creation.
.SH "Source packages and dsc files"
.IX Header "Source packages and dsc files"
\&\f(CW\*(C`embuilddeps\*(C'\fR can also parse the build dependencies of a package via
the \fI.dsc\fR file. The rest of the source package (the files listed in
the \fI.dsc\fR) do \fBnot\fR need to exist and the source does not need to
have been unpacked. Use the \f(CW\*(C`embuilddeps \-\-dsc FILE\*(C'\fR option.
.PP
The alternative method is to parse the \fI./debian/control\fR file at
the location specified by the \f(CW\*(C`\-\-dir\*(C'\fR option which defaults to the
current working directory.
.SH "Multi-Arch transition"
.IX Header "Multi-Arch transition"
Some packages already have multi-arch paths which dpkg-cross does not
normally convert. This can cause missing dependencies when trying to
install the converted packages. Use the \f(CW\*(C`\-\-multiarch\*(C'\fR option to
\&\f(CW\*(C`embuilddeps\*(C'\fR to pass this down to \f(CW\*(C`xapt\*(C'\fR and hence to \f(CW\*(C`dpkg\-cross\*(C'\fR.
.SH "Retaining downloaded binaries"
.IX Header "Retaining downloaded binaries"
\&\f(CW\*(C`embuilddeps\*(C'\fR can pass the \f(CW\*(C`\-k\*(C'\fR option to \f(CW\*(C`xapt\*(C'\fR to retain the
foreign architecture packages downloaded by \f(CW\*(C`xapt\*(C'\fR and the packages
built using \f(CW\*(C`dpkg\-cross\*(C'\fR.
.PP
Note that \f(CW\*(C`xapt\*(C'\fR should be asked to clean up the downloaded files
once these lists have been handled by calling the \f(CW\*(C`xapt \-c\*(C'\fR option
which removes the contents of \fI/var/lib/xapt/*\fR.