Provided by: dpkg-dev_1.16.1.2ubuntu7_all bug

NAME

       dpkg-buildpackage - build binary or source packages from sources

SYNOPSIS

       dpkg-buildpackage [option...]

DESCRIPTION

       dpkg-buildpackage is a program that automates the process of building a Debian package. It
       consists of the following steps:

       1. It prepares the  build  environment  by  setting  various  environment  variables  (see
          ENVIRONMENT)  and  calls  dpkg-source  --before-build  (unless  -T or --target has been
          used).

       2. It checks that the build-dependencies and build-conflicts are satisfied (unless  -d  is
          specified).

       3. If  a  specific  target has been selected with the -T or --target option, it calls that
          target and stops here. Otherwise it calls fakeroot  debian/rules  clean  to  clean  the
          build-tree (unless -nc is specified).

       4. It  calls dpkg-source -b to generate the source package (unless a binary-only build has
          been requested with -b, -B or -A).

       5. It calls debian/rules build followed by fakeroot debian/rules binary-target  (unless  a
          source-only build has been requested with -S). Note that binary-target is either binary
          (default case, or  if  -b  is  specified)  or  binary-arch  (if  -B  is  specified)  or
          binary-indep (if -A is specified).

       6. It calls gpg to sign the .dsc file (if any, unless -us is specified).

       7. It  calls  dpkg-genchanges to generate a .changes file.  Many dpkg-buildpackage options
          are forwarded to dpkg-genchanges.

       8. It calls gpg to sign the .changes file (unless -uc is specified).

       9. If -tc is specified, it will call fakeroot debian/rules clean again. Finally  it  calls
          dpkg-source --after-build.

OPTIONS

       -b     Specifies  a binary-only build, no source files are to be built and/or distributed.
              Passed to dpkg-genchanges.

       -B     Specifies a binary-only build, limited to architecture dependent packages.   Passed
              to dpkg-genchanges.

       -A     Specifies a binary-only build, limited to architecture independent packages. Passed
              to dpkg-genchanges.

       -S     Specifies a source-only build, no binary packages  need  to  be  made.   Passed  to
              dpkg-genchanges.

       -F     Specifies  a  normal full build, binary and source packages will be built.  This is
              the same as the default case when no build option is specified.

       --target=target
       --target target
       -Ttarget
              Calls debian/rules target after having setup the build environment  and  stops  the
              package  build  process  here.  If  --as-root  is  also  given, then the command is
              executed as root (see -r). Note that official targets that are required to  be  run
              as root by the Debian policy do not need this option.

       --as-root
              Only  meaningful  together with --target. Requires that the target be run with root
              rights.

       -si
       -sa
       -sd
       -vversion
       -Cchangesdescription
       -mmaintaineraddress
       -emaintaineraddress
              Passed unchanged to dpkg-genchanges. See its manual page.

       -aarchitecture
              Specify the Debian architecture we build for. The architecture of  the  machine  we
              build on is determined automatically, and is also the default for the host machine.

       -tgnu-system-type
              Specify  the  GNU  system  type we build for. It can be used in place of -a or as a
              complement  to  override  the  default  GNU  system  type  of  the  target   Debian
              architecture.

       -jjobs Number  of  jobs allowed to be run simultaneously, equivalent to the make(1) option
              of the same name. Will add itself to  the  MAKEFLAGS  environment  variable,  which
              should  cause  all  subsequent  make  invocations  to inherit the option. Also adds
              parallel=jobs  to  the  DEB_BUILD_OPTIONS   environment   variable   which   allows
              debian/rules   files   to  use  this  information  for  their  own  purposes.   The
              parallel=jobs in DEB_BUILD_OPTIONS environment variable will override the -j  value
              if this option is given.

       -D     Check  build  dependencies and conflicts; abort if unsatisfied. This is the default
              behavior.

       -d     Do not check build dependencies and conflicts.

       -nc    Do not clean the source tree (implies -b if nothing else has  been  selected  among
              -B, -A or -S).

       -tc    Clean  the  source  tree  (using  gain-root-command  debian/rules  clean) after the
              package has been built.

       -rgain-root-command
              When dpkg-buildpackage needs to execute part of  the  build  process  as  root,  it
              prefixes  the command it executes with gain-root-command if one has been specified.
              Otherwise, if none has been specified, fakeroot will be used  by  default,  if  the
              command  is  present.  gain-root-command should start with the name of a program on
              the PATH and will get as arguments the name of the real  command  to  run  and  the
              arguments  it  should take.  gain-root-command can include parameters (they must be
              space-separated) but no shell metacharacters.  gain-root-command might typically be
              fakeroot,  sudo, super or really.  su is not suitable, since it can only invoke the
              user's shell with -c instead of passing arguments individually to the command to be
              run.

       -Rrules-file
              Building  a Debian package usually involves invoking debian/rules as a command with
              several standard parameters. With this option it's possible to use another  program
              invocation  to  build  the  package  (it  can  include space separated parameters).
              Alternatively it can be used to execute the standard rules file with  another  make
              program (for example by using /usr/local/bin/make -f debian/rules as rules-file).

       -psign-command
              When  dpkg-buildpackage needs to execute GPG or PGP to sign a source control (.dsc)
              file or a .changes file it will run sign-command (searching the PATH if  necessary)
              instead of gpg. sign-command will get all the arguments that pgp would have gotten.
              If sign-command takes its arguments in GPG rather than PGP style, you  should  give
              the  -sgpg  option.  sign-command  should  not  contain  spaces  or any other shell
              metacharacters.

       -kkey-id
              Specify a key-ID to use when signing packages.

       -us    Do not sign the source package.

       -uc    Do not sign the .changes file.

       -i[regexp]
       -I[pattern]
       -s[nsAkurKUR]
       -z, -Z
              Passed unchanged to dpkg-source. See its manual page.

       --source-option=opt
              Pass option opt to dpkg-source.

       --changes-option=opt
              Pass option opt to dpkg-genchanges.

       --admindir=dir
       --admindir dir
              Change the location of the dpkg database. The default location is /var/lib/dpkg.

       -h, --help
              Show the usage message and exit.

       --version
              Show the version and exit.

ENVIRONMENT

       Even if dpkg-buildpackage exports some variables, debian/rules should not  rely  on  their
       presence and should instead use the respective interface to retrieve the needed values.

   Variables set by dpkg-architecture
       dpkg-architecture  is called with the -a and -t parameters forwarded. Any variable that is
       output by its -s option is integrated in the build environment.

   Compiler flags
       The CFLAGS, CXXFLAGS, FFLAGS, CPPFLAGS and LDFLAGS environment variables are  set  to  the
       values that dpkg-buildflags returned. See its manual page for more information.

BUGS

       It  should be possible to specify spaces and shell metacharacters in and initial arguments
       for gain-root-command and sign-command.

SEE ALSO

       dpkg-source(1), dpkg-architecture(1), dpkg-buildflags(1), dpkg-genchanges(1), fakeroot(1),
       gpg(1).

AUTHORS

       Copyright © 1995-1996 Ian Jackson
       Copyright © 2000 Wichert Akkerman
       Copyright © 2007 Frank Lichtenheld
       Copyright © 2008-2010 Raphaël Hertzog

       This  is  free software; see the GNU General Public Licence version 2 or later for copying
       conditions. There is NO WARRANTY.