-x, --extract filename.dsc [output-directory]
Extract a source package (--extract since dpkg 1.17.14).
One non-option argument must be supplied, the name of the
Debian source control file (.dsc). An optional second
non-option argument may be supplied to specify the
directory to extract the source package to, this must not
exist. If no output directory is specified, the source
package is extracted into a directory named source-version
under the current working directory.
dpkg-source will read the names of the other file(s)
making up the source package from the control file; they
are assumed to be in the same directory as the .dsc.
The files in the extracted package will have their
permissions and ownerships set to those which would have
been expected if the files and directories had simply been
created - directories and executable files will be 0777
and plain files will be 0666, both modified by the
extractors' umask; if the parent directory is setgid then
the extracted directories will be too, and all the files
and directories will inherit its group ownership.
If the source package uses a non-standard format
(currently this means all formats except '1.0'), its name
will be stored in debian/source/format so that the
following builds of the source package use the same format
by default.
-b, --build directory [format-specific-parameters]
Build a source package (--build since dpkg 1.17.14). The
first non-option argument is taken as the name of the
directory containing the debianized source tree (i.e. with
a debian sub-directory and maybe changes to the original
files). Depending on the source package format used to
build the package, additional parameters might be
accepted.
dpkg-source will build the source package with the first
format found in this ordered list: the format indicated
with the --format command line option, the format
indicated in debian/source/format, '1.0'. The fallback to
'1.0' is deprecated and will be removed at some point in
the future, you should always document the desired source
format in debian/source/format. See section SOURCE PACKAGE
FORMATS for an extensive description of the various source
package formats.
--print-format directory
Print the source format that would be used to build the
source package if dpkg-source --build directory was called
(in the same conditions and with the same parameters;
since dpkg 1.15.5).
--before-build directory
Run the corresponding hook of the source package format
(since dpkg 1.15.8). This hook is called before any build
of the package (dpkg-buildpackage calls it very early even
before debian/rules clean). This command is idempotent and
can be called multiple times. Not all source formats
implement something in this hook, and those that do
usually prepare the source tree for the build for example
by ensuring that the Debian patches are applied.
--after-build directory
Run the corresponding hook of the source package format
(since dpkg 1.15.8). This hook is called after any build
of the package (dpkg-buildpackage calls it last). This
command is idempotent and can be called multiple times.
Not all source formats implement something in this hook,
and those that do usually use it to undo what
--before-build has done.
--commit [directory] ...
Record changes in the source tree unpacked in directory
(since dpkg 1.16.1). This command can take supplementary
parameters depending on the source format. It will error
out for formats where this operation doesn't mean
anything.
-?, --help
Show the usage message and exit. The format specific
build and extract options can be shown by using the
--format option.
--version
Show the version and exit.
