|
|
@@ -1,283 +1,34 @@
|
|
|
.\" Authors: Ian Jackson
|
|
|
-.TH dpkg\-source 1 "2007-02-28" "Debian Project" "dpkg utilities"
|
|
|
+.TH dpkg\-source 1 "2007-03-07" "Debian Project" "dpkg utilities"
|
|
|
.SH NAME
|
|
|
-dpkg\-source, dpkg\-gencontrol, dpkg\-shlibdeps, dpkg\-genchanges,
|
|
|
-dpkg\-buildpackage, dpkg\-distaddfile, dpkg\-parsechangelog
|
|
|
+dpkg\-source,
|
|
|
\- Debian source package tools
|
|
|
.
|
|
|
.SH SYNOPSIS
|
|
|
.B dpkg\-source
|
|
|
-.BI "\-x " filename .dsc
|
|
|
-.RI [ output-directory ]
|
|
|
-.br
|
|
|
-.B dpkg\-source \-b
|
|
|
-.RI [ options "] " directory " [" orig-directory | orig-targz |'']
|
|
|
-.br
|
|
|
-.B dpkg\-gencontrol
|
|
|
-.RI [ options ]
|
|
|
-.br
|
|
|
-.B dpkg\-shlibdeps
|
|
|
-.IR options
|
|
|
-.br
|
|
|
-.B dpkg\-genchanges
|
|
|
-.RI [ options ]
|
|
|
-.br
|
|
|
-.B dpkg\-buildpackage
|
|
|
-.RI [ options ]
|
|
|
-.br
|
|
|
-.B dpkg\-distaddfile
|
|
|
-.RI [ options ] " filename section priority"
|
|
|
-.br
|
|
|
-.B dpkg\-parsechangelog
|
|
|
.RI [ options ]
|
|
|
+.I command
|
|
|
+.
|
|
|
.SH DESCRIPTION
|
|
|
.B dpkg\-source
|
|
|
packs and unpacks Debian source archives.
|
|
|
|
|
|
-.B dpkg\-gencontrol
|
|
|
-reads information from an unpacked Debian source tree and generates a
|
|
|
-binary package control file (which defaults to debian/tmp/DEBIAN/control);
|
|
|
-it also adds an entry for the binary package to
|
|
|
-.BR debian/files .
|
|
|
-
|
|
|
-.B dpkg\-shlibdeps
|
|
|
-calculates shared library dependencies for executables named in its
|
|
|
-arguments. The dependencies are added to the substitution
|
|
|
-variables file
|
|
|
-.B debian/substvars
|
|
|
-as variable names
|
|
|
-.BI shlibs: dependencyfield
|
|
|
-where
|
|
|
-.I dependencyfield
|
|
|
-is a dependency field name. Any other variables starting
|
|
|
-.I shlibs:
|
|
|
-are removed from the file.
|
|
|
-.B dpkg\-shlibdeps
|
|
|
-will read shared library dependency information from
|
|
|
-.BR debian/shlibs.local ,
|
|
|
-.BR /etc/dpkg/shlibs.override ,
|
|
|
-the
|
|
|
-.B shlibs
|
|
|
-control area file of the package containing the file which
|
|
|
-.B objdump
|
|
|
-reports as satisfying the library dependency, or
|
|
|
-.BR /etc/dpkg/shlibs.default .
|
|
|
-The first match will be used.
|
|
|
-The format for a shared library dependency information entry in these
|
|
|
-files is (see the Debian Policy Manual for details):
|
|
|
-.br
|
|
|
-<library name> <version/soname> <dependencies>
|
|
|
-
|
|
|
-.B dpkg\-genchanges
|
|
|
-reads information from an unpacked and built Debian source tree and
|
|
|
-from the files it has generated and generates a Debian upload control
|
|
|
-file
|
|
|
-.RB ( .changes " file)."
|
|
|
-
|
|
|
-.B dpkg\-buildpackage
|
|
|
-is a control script which can be used to help automate the building of
|
|
|
-a package.
|
|
|
-
|
|
|
-.B dpkg\-distaddfile
|
|
|
-adds an entry for a named file to
|
|
|
-.BR debian/files .
|
|
|
-
|
|
|
-.B dpkg\-parsechangelog
|
|
|
-reads and parses the changelog of an unpacked Debian source tree and
|
|
|
-outputs the information in it to standard output in a machine-readable
|
|
|
-form.
|
|
|
-
|
|
|
None of these commands allow multiple options to be combined into one,
|
|
|
and they do not allow the value for an option to be specified in a
|
|
|
separate argument.
|
|
|
-.SH COMMON OPTIONS
|
|
|
-Many of these programs share options; these are described here,
|
|
|
-together with the programs that accept them.
|
|
|
-.TP
|
|
|
-.BR \-h , \-\-help
|
|
|
-Display the particular program's usage message, including a synopsis of
|
|
|
-the options it understands.
|
|
|
-This option is understood by all the source package tools.
|
|
|
-.TP
|
|
|
-.BR \-\-version
|
|
|
-Display the particular program's version, including copyright and license
|
|
|
-information.
|
|
|
-This option is understood by all the source package tools.
|
|
|
-.TP
|
|
|
-.BI \-\-admindir= dir
|
|
|
-In
|
|
|
-.BR dpkg\-buildpackage " and " dpkg\-shlibdeps
|
|
|
-change the location of the \fBdpkg\fR database. The default location is
|
|
|
-\fI/var/lib/dpkg\fP.
|
|
|
-.TP
|
|
|
-.BI \-v version
|
|
|
-In
|
|
|
-.BR dpkg\-buildpackage ", " dpkg\-genchanges " and " dpkg\-parsechangelog
|
|
|
-this causes changelog information from all versions strictly later
|
|
|
-than
|
|
|
-.I version
|
|
|
-to be used.
|
|
|
-
|
|
|
-In
|
|
|
-.BR dpkg\-gencontrol
|
|
|
-it sets the version number of the binary package which will be
|
|
|
-generated.
|
|
|
-.TP
|
|
|
-.BI \-C changesdescription
|
|
|
-Read the description of the changes from the file
|
|
|
-.I changesdescription
|
|
|
-rather than using the information from the source tree's changelog
|
|
|
-file. This is understood by
|
|
|
-.BR dpkg\-buildpackage " and " dpkg\-genchanges .
|
|
|
-.TP
|
|
|
-.BI \-m maintaineraddress
|
|
|
-Use
|
|
|
-.I maintaineraddress
|
|
|
-as the name and email address of the maintainer for this package,
|
|
|
-rather than using the information from the source tree's control file.
|
|
|
-This is understood by
|
|
|
-.BR dpkg\-buildpackage " and " dpkg\-genchanges .
|
|
|
-.TP
|
|
|
-.BI \-e maintaineraddress
|
|
|
-Use
|
|
|
-.I maintaineraddress
|
|
|
-as the name and email address of the maintainer for this upload,
|
|
|
-rather than using the information from the source tree's changelog.
|
|
|
-This is understood by
|
|
|
-.BR dpkg\-buildpackage " and " dpkg\-genchanges .
|
|
|
-.TP
|
|
|
-.BR \-si ", " \-sa ", " \-sd
|
|
|
-These options control whether the original source archive is included
|
|
|
-in the upload generated by
|
|
|
-.BR dpkg\-buildpackage " or " dpkg\-genchanges
|
|
|
-if any source is being generated (i.e.,
|
|
|
-.BR \-b " or " \-B
|
|
|
-haven't been used).
|
|
|
-
|
|
|
-By default, or if
|
|
|
-.B \-si
|
|
|
-is specified, the original source will be included if the version
|
|
|
-number ends in
|
|
|
-.BR \-0 " or " \-1 ,
|
|
|
-i.e. if the Debian revision part of the version number is
|
|
|
-.BR 0 " or " 1 .
|
|
|
-
|
|
|
-.B \-sa
|
|
|
-forces the inclusion of the original source;
|
|
|
-.B \-sd
|
|
|
-forces its exclusion and includes only the diff.
|
|
|
-.TP
|
|
|
-.BI \-V name = value
|
|
|
-Set an output substitution variable.
|
|
|
-This option is understood by
|
|
|
-.BR dpkg\-source ", " dpkg\-gencontrol " and " dpkg\-genchanges .
|
|
|
-See below for a discussion of output substitution.
|
|
|
-.TP
|
|
|
-.BI \-T substvarsfile
|
|
|
-Read (or, for
|
|
|
-.BR dpkg\-shlibdeps ,
|
|
|
-write) substitution variables in
|
|
|
-.IR substvarsfile ;
|
|
|
-the default is
|
|
|
-.BR debian/substvars .
|
|
|
-This option is understood by
|
|
|
-.BR dpkg\-source ", " dpkg\-gencontrol ", " dpkg\-shlibdeps " and " dpkg\-genchanges .
|
|
|
-.TP
|
|
|
-.BI \-D field = value
|
|
|
-Override or add an output control file field.
|
|
|
-This option is understood by
|
|
|
-.BR dpkg\-source ", " dpkg\-gencontrol " and " dpkg\-genchanges .
|
|
|
-.TP
|
|
|
-.BI \-U field
|
|
|
-Remove an output control file field.
|
|
|
-This option is understood by
|
|
|
-.BR dpkg\-source ", " dpkg\-gencontrol " and " dpkg\-genchanges .
|
|
|
-.TP
|
|
|
-.BR \-b | \-B | \-S
|
|
|
-For
|
|
|
-.BR dpkg\-genchanges " and " dpkg\-buildpackage
|
|
|
-.BR \-b " and " \-B
|
|
|
-specify that a binary-only build is taking place.
|
|
|
-.B \-b
|
|
|
-indicates that no source files are to be built and/or distributed, and
|
|
|
-.B \-B
|
|
|
-that no architecture-independent binary package files are to be
|
|
|
-distributed either.
|
|
|
-.B \-S
|
|
|
-specifies that only the source should be uploaded and no binary packages
|
|
|
-need to be made. The distinction between
|
|
|
-.BR \-b " and " \-B
|
|
|
-is only used by
|
|
|
-.BR dpkg\-buildpackage ;
|
|
|
-.B dpkg\-genchanges
|
|
|
-just produces a
|
|
|
-.B .changes
|
|
|
-file for whatever files were produced by the
|
|
|
-.B binary\-*
|
|
|
-target(s) of the package being built.
|
|
|
-
|
|
|
-.B \-b
|
|
|
-tells
|
|
|
-.B dpkg\-source
|
|
|
-to build a source package (rather than to extract one) - see below.
|
|
|
-.TP
|
|
|
-.BI \-c controlfile
|
|
|
-Specifies the main source control file to read information from. The
|
|
|
-default is
|
|
|
-.BR debian/control .
|
|
|
-This option is understood by
|
|
|
-.BR dpkg\-source ", " dpkg\-gencontrol " and " dpkg\-genchanges .
|
|
|
-.TP
|
|
|
-.BI \-l changelogfile
|
|
|
-Specifies the change log file to read information from. The
|
|
|
-default is
|
|
|
-.BR debian/changelog .
|
|
|
-This option is understood by
|
|
|
-.BR dpkg\-source ", " dpkg\-gencontrol " and " dpkg\-genchanges .
|
|
|
-.TP
|
|
|
-.BI \-f fileslistfile
|
|
|
-Read or write the list of files to be uploaded here, rather than using
|
|
|
-.BR debian/files .
|
|
|
-This option is understood by
|
|
|
-.BR dpkg\-gencontrol ", " dpkg\-genchanges " and " dpkg\-distaddfile .
|
|
|
-.TP
|
|
|
-.BI \-F changelogformat
|
|
|
-Specifies the format of the changelog. By default the format is read
|
|
|
-from a special line near the bottom of the changelog or failing that
|
|
|
-defaults to the debian standard format.
|
|
|
-This option is understood by
|
|
|
-.BR dpkg\-source ", " dpkg\-gencontrol " and " dpkg\-genchanges .
|
|
|
-.TP
|
|
|
-.BI \-W
|
|
|
-This option turns certain errors into warnings. Only dpkg\-source uses
|
|
|
-this, but
|
|
|
-.BR dpkg\-buildpackage
|
|
|
-recognizes it, and passes it thru to
|
|
|
-.BR dpkg\-source "."
|
|
|
-.TP
|
|
|
-.BI \-E
|
|
|
-This option negates a previously set
|
|
|
-.BR \-W "."
|
|
|
-It is currently only understood by
|
|
|
-.BR dpkg\-buildpackage " and " dpkg\-source "."
|
|
|
-.SH dpkg\-SOURCE OPTIONS
|
|
|
-When the common options
|
|
|
-.BR \-c " and " \-l
|
|
|
-are given with relative pathnames these are interpreted starting at
|
|
|
-the source tree's top level directory.
|
|
|
+.
|
|
|
+.SH COMMANDS
|
|
|
.TP
|
|
|
-.B \-x
|
|
|
+.BI "\-x " filename ".dsc " \fR[\fPoutput-directory\fR]\fP
|
|
|
Extract a source package. One non-option argument must be supplied,
|
|
|
the name of the Debian source control file
|
|
|
.RB ( .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 \fIsource\fR-\fIversion-\fR under the current working
|
|
|
+a directory named \fIsource\fR-\fIversion\fR under the current working
|
|
|
directory.
|
|
|
|
|
|
-No options are useful with
|
|
|
-.BR "dpkg\-source \-x" .
|
|
|
.B 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
|
|
|
@@ -292,8 +43,8 @@ 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.
|
|
|
.TP
|
|
|
-.B \-b
|
|
|
-Build: pack up a source tree. One or two non-option arguments should
|
|
|
+.RI "\fB\-b\fP [" options "] " directory " [" orig-directory | orig-targz |'']
|
|
|
+Build a source package. One or two non-option arguments should
|
|
|
be supplied. The first is taken as the name of the directory
|
|
|
containing the unpacked source tree. If a second argument is supplied
|
|
|
it should be the name of the original source directory or tarfile or
|
|
|
@@ -307,7 +58,57 @@ or the original source directory
|
|
|
or the empty string (no original source, and so no diff) depending on
|
|
|
the arguments.
|
|
|
.TP
|
|
|
-.B \-i[<regexp>]
|
|
|
+.BR \-h ", " \-\-help
|
|
|
+Show the usage message and exit.
|
|
|
+.TP
|
|
|
+.BR \-\-version
|
|
|
+Show the version and exit.
|
|
|
+.
|
|
|
+.SH OPTIONS
|
|
|
+.TP
|
|
|
+.BI \-c controlfile
|
|
|
+Specifies the main source control file to read information from. The
|
|
|
+default is
|
|
|
+.BR debian/control .
|
|
|
+If given with relative pathname this is interpreted starting at
|
|
|
+the source tree's top level directory.
|
|
|
+.TP
|
|
|
+.BI \-l changelogfile
|
|
|
+Specifies the change log file to read information from. The
|
|
|
+default is
|
|
|
+.BR debian/changelog .
|
|
|
+If given with relative pathname this is interpreted starting at
|
|
|
+the source tree's top level directory.
|
|
|
+.TP
|
|
|
+.BI \-F changelogformat
|
|
|
+Specifies the format of the changelog. By default the format is read
|
|
|
+from a special line near the bottom of the changelog or failing that
|
|
|
+defaults to the debian standard format.
|
|
|
+.TP
|
|
|
+.BI \-V name = value
|
|
|
+Set an output substitution variable.
|
|
|
+See \fBdpkg\-substvars\fP(5) for a discussion of output substitution.
|
|
|
+.TP
|
|
|
+.BI \-T substvarsfile
|
|
|
+Read substitution variables in
|
|
|
+.IR substvarsfile ;
|
|
|
+the default is
|
|
|
+.BR debian/substvars .
|
|
|
+.TP
|
|
|
+.BI \-D field = value
|
|
|
+Override or add an output control file field.
|
|
|
+.TP
|
|
|
+.BI \-U field
|
|
|
+Remove an output control file field.
|
|
|
+.TP
|
|
|
+.BI \-W
|
|
|
+This option turns certain errors into warnings.
|
|
|
+.TP
|
|
|
+.BI \-E
|
|
|
+This option negates a previously set
|
|
|
+.BR \-W "."
|
|
|
+.TP
|
|
|
+.BR \-i [\fIregexp\fP]
|
|
|
You may specify a perl regular expression to match files you want
|
|
|
filtered out of the list of files for the diff. (This list is
|
|
|
generated by a find command.) \fB\-i\fR by itself enables the option,
|
|
|
@@ -327,13 +128,34 @@ from the ones in your working directory, thus causing them to be
|
|
|
unnecessarily included in every .diff.gz, unless you use the \fB\-i\fR
|
|
|
switch.
|
|
|
.TP
|
|
|
-.B \-I<filename>
|
|
|
+.BI \-I filename
|
|
|
If this option is specified, the filename will be passed to tar's \-\-exclude
|
|
|
option when it is called to generate a .orig.tar.gz or .tar.gz file. For
|
|
|
example, \-ICVS will make tar skip over CVS directories when generating
|
|
|
a .tar.gz file. The option may be repeated multiple times to list multiple
|
|
|
filenames to exclude.
|
|
|
.TP
|
|
|
+.BR \-si ", " \-sa ", " \-sd
|
|
|
+These options control whether the original source archive is included
|
|
|
+in the upload generated by
|
|
|
+.BR dpkg\-buildpackage
|
|
|
+if any source is being generated (i.e.,
|
|
|
+.BR \-b " or " \-B
|
|
|
+haven't been used).
|
|
|
+
|
|
|
+By default, or if
|
|
|
+.B \-si
|
|
|
+is specified, the original source will be included if the version
|
|
|
+number ends in
|
|
|
+.BR \-0 " or " \-1 ,
|
|
|
+i.e. if the Debian revision part of the version number is
|
|
|
+.BR 0 " or " 1 .
|
|
|
+
|
|
|
+.B \-sa
|
|
|
+forces the inclusion of the original source;
|
|
|
+.B \-sd
|
|
|
+forces its exclusion and includes only the diff.
|
|
|
+.TP
|
|
|
.BR \-sa , \-sp , \-su , \-sk , \-sA , \-sP , \-sU , \-sK , \-ss " with " \-b
|
|
|
If
|
|
|
.BR \-sk " or " \-sp
|
|
|
@@ -438,396 +260,7 @@ All the
|
|
|
.B \-sX
|
|
|
options are mutually exclusive. If you specify more than one only the
|
|
|
last one will be used.
|
|
|
-.SH dpkg\-GENCONTROL OPTIONS
|
|
|
-.B dpkg\-gencontrol
|
|
|
-does not take any non-option arguments.
|
|
|
-.TP
|
|
|
-.BI \-p package
|
|
|
-Generate information for the binary package
|
|
|
-.IR package .
|
|
|
-If the source control file lists only one binary package then this
|
|
|
-option may be omitted; otherwise it is essential to select which
|
|
|
-binary package's information to generate.
|
|
|
-.TP
|
|
|
-.BI \-n filename
|
|
|
-Assume the filename of the package will be
|
|
|
-.I filename
|
|
|
-instead of the normal package_version_arch.deb filename.
|
|
|
-.TP
|
|
|
-.BR \-is ", " \-ip ", " \-isp
|
|
|
-These options are ignored for compatibility with older versions of
|
|
|
-dpkg-dev but are now deprecated. Previously they were used to tell
|
|
|
-dpkg-gencontrol to include the Section and Priority fields in the
|
|
|
-control file. This is now the default behaviour. If you want to
|
|
|
-get the old behaviour you can use the
|
|
|
-.B \-U
|
|
|
-option to delete the fields from the control file.
|
|
|
-.TP
|
|
|
-.BI \-P packagebuilddir
|
|
|
-Tells
|
|
|
-.B dpkg\-source
|
|
|
-that the package is being built in
|
|
|
-.I packagebuilddir
|
|
|
-instead of
|
|
|
-.BR debian/tmp .
|
|
|
-This value is used to find the default value of the
|
|
|
-.B Installed\-Size
|
|
|
-substitution variable and control file field (using
|
|
|
-.BR du ),
|
|
|
-and for the default location of the output file.
|
|
|
-.TP
|
|
|
-.B \-O
|
|
|
-Causes the control file to be printed to standard output, rather than
|
|
|
-to
|
|
|
-.B debian/tmp/DEBIAN/control
|
|
|
-(or
|
|
|
-.IB packagebuilddir /DEBIAN/control
|
|
|
-if
|
|
|
-.B \-P
|
|
|
-was used).
|
|
|
-.SH dpkg\-SHLIBDEPS OPTIONS
|
|
|
-.B dpkg\-shlibdeps
|
|
|
-interprets non-option arguments as executable names, just as if they'd
|
|
|
-been supplied as
|
|
|
-.BI \-e executable\fR.
|
|
|
-.TP
|
|
|
-.BI \-e executable
|
|
|
-Include dependencies appropriate for the shared libraries required by
|
|
|
-.IR executable .
|
|
|
-.TP
|
|
|
-.BI \-d dependencyfield
|
|
|
-Add dependencies to be added to the control file dependency field
|
|
|
-.IR dependencyfield .
|
|
|
-(The dependencies for this field are placed in the variable
|
|
|
-.BI shlibs: dependencyfield\fR.)
|
|
|
-
|
|
|
-The
|
|
|
-.BI \-d dependencyfield
|
|
|
-option takes effect for all executables after the option, until the
|
|
|
-next
|
|
|
-.BI \-d dependencyfield\fR.
|
|
|
-The default
|
|
|
-.I dependencyfield
|
|
|
-is
|
|
|
-.BR Depends .
|
|
|
-
|
|
|
-If the same dependency entry (or set of alternatives) appears in more
|
|
|
-than one of the recognised dependency field names
|
|
|
-.BR Pre\-Depends ", " Depends ", " Recommends ", " Enhances " or " Suggests
|
|
|
-then
|
|
|
-.B dpkg\-shlibdeps
|
|
|
-will automatically remove the dependency from all fields except the
|
|
|
-one representing the most important dependencies.
|
|
|
-.TP
|
|
|
-.BI \-p varnameprefix
|
|
|
-Causes substitution variables to start with
|
|
|
-.IB varnameprefix :
|
|
|
-instead of
|
|
|
-.BR shlibs: .
|
|
|
-Likewise, any existing substitution variables starting with
|
|
|
-.IB varnameprefix :
|
|
|
-(rather than
|
|
|
-.BR shlibs: )
|
|
|
-are removed from the the substitution variables file.
|
|
|
-.TP
|
|
|
-.BI \-L localshlibsfile
|
|
|
-Causes
|
|
|
-.B dpkg\-shlibdeps
|
|
|
-to read overriding shared library dependency information from
|
|
|
-.I localshlibsfile
|
|
|
-instead of
|
|
|
-.BR debian/shlibs.local .
|
|
|
-.TP
|
|
|
-.B \-O
|
|
|
-Causes the substitution variable settings to be printed to standard
|
|
|
-output, rather than being added to the substitution variables file
|
|
|
-.RB ( debian/substvars
|
|
|
-by default).
|
|
|
-.TP
|
|
|
-.BI \-t type
|
|
|
-Causes
|
|
|
-.B dpkg\-shlibdeps
|
|
|
-to prefer shared library dependency information tagged for the given
|
|
|
-package type. If no tagged information is available, falls back to untagged
|
|
|
-information. The default package type is "deb". Shared library dependency
|
|
|
-information is tagged for a given type by prefixing it with the name of the
|
|
|
-type, a colon, and whitespace.
|
|
|
-.SH dpkg\-GENCHANGES OPTIONS
|
|
|
-.B dpkg\-genchanges
|
|
|
-does not take any non-option arguments.
|
|
|
-.TP
|
|
|
-.BI \-u uploadfilesdir
|
|
|
-Look for the files to be uploaded in
|
|
|
-.I uploadfilesdir
|
|
|
-rather than
|
|
|
-.B ..
|
|
|
-.RB ( dpkg\-genchanges
|
|
|
-needs to find these files so that it can include their sizes and
|
|
|
-checksums in the
|
|
|
-.B .changes
|
|
|
-file).
|
|
|
-.TP
|
|
|
-.B \-q
|
|
|
-Usually
|
|
|
-.B dpkg\-genchanges
|
|
|
-will produce informative messages on standard error, for example about
|
|
|
-how many of the package's source files are being uploaded.
|
|
|
-.B \-q
|
|
|
-suppresses these messages.
|
|
|
-.SH dpkg\-BUILDPACKAGE OPTIONS
|
|
|
-.B dpkg\-buildpackage
|
|
|
-does not take any non-option arguments.
|
|
|
-.TP
|
|
|
-.BI \-k key-id
|
|
|
-Specify a key-ID to use when signing packages.
|
|
|
-.TP
|
|
|
-.BI \-r gain-root-command
|
|
|
-When
|
|
|
-.B dpkg\-buildpackage
|
|
|
-needs to execute part of the build process as root, it prefixes the
|
|
|
-command it executes with
|
|
|
-.I gain-root-command
|
|
|
-if one has been specified.
|
|
|
-.I gain-root-command
|
|
|
-should be the name of a program on the
|
|
|
-.B PATH
|
|
|
-and will get as arguments the name of the real command to run and the
|
|
|
-arguments it should take.
|
|
|
-.I gain-root-command
|
|
|
-should not contain spaces or any other shell metacharacters.
|
|
|
-.\" what happens, if it contains spaces? (hs)
|
|
|
-.I gain-root-command
|
|
|
-might typically be
|
|
|
-.BR fakeroot ", " sudo ", " super " or " really .
|
|
|
-.B su
|
|
|
-is not suitable, since it requires a
|
|
|
-.B \-c
|
|
|
-option to run a command and even then it can only invoke the user's
|
|
|
-shell with
|
|
|
-.B \-c
|
|
|
-instead of passing arguments individually to the command to be run.
|
|
|
-.TP
|
|
|
-.BI \-p sign-command
|
|
|
-When
|
|
|
-.B dpkg\-buildpackage
|
|
|
-needs to execute GPG or PGP to sign a source control
|
|
|
-.RB ( .dsc )
|
|
|
-file or a
|
|
|
-.B .changes
|
|
|
-file it will run
|
|
|
-.I sign-command
|
|
|
-(searching the
|
|
|
-.B PATH
|
|
|
-if necessary) instead of
|
|
|
-.BR pgp .
|
|
|
-.I sign-command
|
|
|
-will get all the arguments that
|
|
|
-.B pgp
|
|
|
-would have gotten. If
|
|
|
-.I sign-command
|
|
|
-takes its arguments in GPG rather than PGP style, you should give
|
|
|
-the
|
|
|
-.B \-sgpg
|
|
|
-option.
|
|
|
-.I sign-command
|
|
|
-should not contain spaces or any other shell metacharacters.
|
|
|
-.TP
|
|
|
-.B \-tc
|
|
|
-Clean the source tree (using
|
|
|
-.I gain-root-command
|
|
|
-.BR "debian/rules clean" )
|
|
|
-after the package has been built.
|
|
|
-.TP
|
|
|
-.BR \-us ", " \-uc
|
|
|
-Do not sign the source package or the .changes file, respectively.
|
|
|
-.TP
|
|
|
-.BI \-a architecture
|
|
|
-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.
|
|
|
-.TP
|
|
|
-.B \-i[<regexp>]
|
|
|
-Passed unchanged to
|
|
|
-.BR dpkg\-source .
|
|
|
-.TP
|
|
|
-.B \-I<filename>
|
|
|
-Passed unchanged to
|
|
|
-.BR dpkg\-source .
|
|
|
-May be repeated multiple times.
|
|
|
-.TP
|
|
|
-.B \-D
|
|
|
-Check build dependencies and conflicts; abort if unsatisfied.
|
|
|
-.TP
|
|
|
-.B \-d
|
|
|
-Do not check build dependencies and conflicts.
|
|
|
-.TP
|
|
|
-.B \-nc
|
|
|
-Do not clean the source tree(implies \-b).
|
|
|
-.SH dpkg\-DISTADDFILE ARGUMENTS
|
|
|
-.B dpkg\-distaddfile
|
|
|
-does not take any non-common options. It takes three non-option
|
|
|
-arguments, the filename and the section and priority for the
|
|
|
-.B .changes
|
|
|
-file.
|
|
|
-
|
|
|
-The filename should be specified relative to the directory where
|
|
|
-.B dpkg\-genchanges
|
|
|
-will expect to find the files, usually
|
|
|
-.BR .. ,
|
|
|
-rather than being a pathname relative to the current directory when
|
|
|
-.B dpkg\-distaddfile
|
|
|
-is run.
|
|
|
-.SH dpkg\-PARSECHANGELOG ARGUMENTS
|
|
|
-.B dpkg\-parsechangelog
|
|
|
-does not take any non-common options or non-option arguments.
|
|
|
-.SH VARIABLE SUBSTITUTION
|
|
|
-Before
|
|
|
-.BR dpkg\-source ", " dpkg\-gencontrol " and " dpkg\-genchanges
|
|
|
-write their control information (to the source control file
|
|
|
-.B .dsc
|
|
|
-for
|
|
|
-.B dpkg\-source
|
|
|
-and to standard output for
|
|
|
-.BR dpkg\-gencontrol " and " dpkg\-genchanges )
|
|
|
-they perform some variable substitutions on the output file.
|
|
|
-
|
|
|
-A variable substitution has the form
|
|
|
-.BI ${ variable-name }\fR.
|
|
|
-Variable names consist of alphanumerics, hyphens and colons and start
|
|
|
-with an alphanumeric. Variable substitutions are performed repeatedly
|
|
|
-until none are left; the full text of the field after the substitution
|
|
|
-is rescanned to look for more substitutions.
|
|
|
-
|
|
|
-After all the substitutions have been done each occurrence of the
|
|
|
-string
|
|
|
-.B ${}
|
|
|
-(which is not a legal substitution) is replaced with a
|
|
|
-.B $
|
|
|
-sign.
|
|
|
-
|
|
|
-Variables can be set using the
|
|
|
-.B \-V
|
|
|
-common option. They can be also specified in the file
|
|
|
-.B debian/substvars
|
|
|
-(or whatever other file is specified using the
|
|
|
-.B \-T
|
|
|
-option). This file consists of lines of the form
|
|
|
-.IB name = value\fR.
|
|
|
-Trailing whitespace on each line, blank lines, and
|
|
|
-lines starting with a
|
|
|
-.B #
|
|
|
-symbol (comments) are ignored.
|
|
|
-
|
|
|
-Additionally, the following standard variables are available:
|
|
|
-.TP
|
|
|
-.BI Arch
|
|
|
-The current build architecture (from
|
|
|
-.BR "dpkg \-\-print\-architecture" ).
|
|
|
-.TP
|
|
|
-.B source:Version
|
|
|
-The source package version.
|
|
|
-.TP
|
|
|
-.B source:Upstream\-Version
|
|
|
-The upstream source package version, including the Debian version epoch if
|
|
|
-any.
|
|
|
-.TP
|
|
|
-.B binary:Version
|
|
|
-The binary package version (which may differ from source:Version in a binNMU
|
|
|
-for example).
|
|
|
-.TP
|
|
|
-.B Source\-Version
|
|
|
-The source package version (from the changelog file). This variable is now
|
|
|
-\fBdeprecated\fP as its meaning is different from its function, please use
|
|
|
-the \fBsource:Version\fP or \fBbinary:Version\fP as appropriate.
|
|
|
-.TP
|
|
|
-.B Installed\-Size
|
|
|
-The total size of the package's installed files. This value is copied
|
|
|
-into the corresponding control file field; setting it will modify the
|
|
|
-value of that field. If this variable isn't set
|
|
|
-.B dpkg\-gencontrol
|
|
|
-will use
|
|
|
-.B du \-k debian/tmp
|
|
|
-to find the default value.
|
|
|
-.TP
|
|
|
-.B Extra\-Size
|
|
|
-Additional disk space used when the package is installed. If this
|
|
|
-variable is set its value is added to that of the
|
|
|
-.B Installed\-Size
|
|
|
-variable (whether set explicitly or using the default value) before it
|
|
|
-is copied into the
|
|
|
-.B Installed\-Size
|
|
|
-control file field.
|
|
|
-.TP
|
|
|
-.BI F: fieldname
|
|
|
-The value of the output field
|
|
|
-.IR fieldname
|
|
|
-(which must be given in the canonical capitalisation). Setting these
|
|
|
-variables has no effect other than on places where they are expanded
|
|
|
-explicitly.
|
|
|
-.TP
|
|
|
-.B Format
|
|
|
-The
|
|
|
-.B .changes
|
|
|
-file format version generated by this version of the source packaging
|
|
|
-scripts. If you set this variable the contents of the
|
|
|
-.B Format
|
|
|
-field in the
|
|
|
-.B .changes
|
|
|
-file will change too.
|
|
|
-.TP
|
|
|
-.BR Newline ", " Space ", " Tab
|
|
|
-These variables each hold the corresponding character.
|
|
|
-.TP
|
|
|
-.BI shlibs: dependencyfield
|
|
|
-Variable settings with names of this form are generated by
|
|
|
-.B dpkg\-shlibdeps
|
|
|
-- see above.
|
|
|
-.TP
|
|
|
-.B dpkg:Upstream\-Version
|
|
|
-The upstream version of dpkg.
|
|
|
-.TP
|
|
|
-.B dpkg:Version
|
|
|
-The full version of dpkg.
|
|
|
-.LP
|
|
|
-If a variable is referred to but not defined it generates a warning
|
|
|
-and an empty value is assumed.
|
|
|
-.SH FILES
|
|
|
-.TP
|
|
|
-.B debian/control
|
|
|
-The main source control information file, giving version-independent
|
|
|
-information about the source package and the binary packages it can
|
|
|
-produce.
|
|
|
-.TP
|
|
|
-.B debian/changelog
|
|
|
-The changelog file, used to obtain version-dependent information about
|
|
|
-the source package, such as the urgency and distribution of an upload,
|
|
|
-the changes made since a particular release, and the source version
|
|
|
-number itself.
|
|
|
-.TP
|
|
|
-.B debian/files
|
|
|
-The list of generated files which are part of the upload being
|
|
|
-prepared.
|
|
|
-.B dpkg\-gencontrol
|
|
|
-adds the presumed filenames of binary packages whose control files it
|
|
|
-generates here;
|
|
|
-.B dpkg\-distaddfile
|
|
|
-can be used to add additional files.
|
|
|
-.B dpkg\-genchanges
|
|
|
-reads the data here when producing a
|
|
|
-.B .changes
|
|
|
-file.
|
|
|
-.TP
|
|
|
-.B debian/substvars
|
|
|
-List of substitution variables and values.
|
|
|
-.TP
|
|
|
-.B debian/shlibs.local
|
|
|
-Package-local overriding shared library dependency information.
|
|
|
-.TP
|
|
|
-.B /etc/dpkg/shlibs.override
|
|
|
-Per-system overriding shared library dependency information.
|
|
|
-.TP
|
|
|
-.B /etc/dpkg/shlibs.default
|
|
|
-Per-system default shared library dependency information.
|
|
|
+.
|
|
|
.SH BUGS
|
|
|
The point at which field overriding occurs compared to certain
|
|
|
standard output field settings is rather confused.
|
|
|
@@ -838,26 +271,16 @@ file will be passed through variable substitution twice. This should
|
|
|
not matter, since
|
|
|
.BR $ ", " { " and " }
|
|
|
are not legal in package names or version numbers.
|
|
|
-
|
|
|
-It should be possible to specify spaces and shell metacharacters in
|
|
|
-and initial arguments for
|
|
|
-.IR gain-root-command " and " sign-command .
|
|
|
+.
|
|
|
.SH SEE ALSO
|
|
|
.BR dpkg\-deb (1),
|
|
|
.BR dpkg (1),
|
|
|
-.BR dselect (1),
|
|
|
-.BR gpg (1),
|
|
|
-.BR pgp (1).
|
|
|
-.SH AUTHOR
|
|
|
-The utilities and this manpage were written by Ian Jackson.
|
|
|
-.SH COPYRIGHT
|
|
|
+.BR dselect (1).
|
|
|
+.
|
|
|
+.SH AUTHORS
|
|
|
Copyright (C) 1995-1996 Ian Jackson
|
|
|
.br
|
|
|
Copyright (C) 2000 Wichert Akkerman
|
|
|
-.br
|
|
|
+.sp
|
|
|
This is free software; see the GNU General Public Licence version 2 or later
|
|
|
-for copying conditions. There is NO WARRANTY. See
|
|
|
-.B /usr/share/doc/dpkg/copyright
|
|
|
-and
|
|
|
-.B /usr/share/common\-licenses/GPL
|
|
|
-for details.
|
|
|
+for copying conditions. There is NO WARRANTY.
|
Guillem Jover