.\" .RE
.SH SEE ALSO
.BR deb (5),
-.BR dpkg (8),
+.BR dpkg (1),
.BR dpkg-deb (1).
-.TH DPKG-ARCHITECTURE 1 "2005-01-10" "Debian GNU/Linux"
+.TH DPKG-ARCHITECTURE 1 "2006-01-23" "Debian GNU/Linux"
.SH "NAME"
dpkg\-architecture \- set and determine the architecture for package building
.SH "SYNOPSIS"
\&\fB\-f\fR
.PP
Valid actions:
-\&\fB\-l\fR, \fB\-q\fRVariable\-Name, \fB\-s\fR, \fB\-u\fR, \fB\-c\fR Command,
-\fB\-L\fR
+\&\fB\-l\fR, \fB\-e\fRDebian\-Architecture, \fB\-i\fRArchitecture\-Alias,
+\fB\-q\fRVariable\-Name, \fB\-s\fR, \fB\-u\fR, \fB\-c\fR Command, \fB\-L\fR
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
dpkg-architecture does provide a facility to determine and set the build and
will warn you if your choice doesn't match the default.
.PP
The default action is \fB\-l\fR, which prints the environment variables, one each line,
-in the format VARIABLE=value. If you are only interested in the value of a
-single variable, you can use \fB\-q\fR. If you specify \fB\-s\fR, it will output an export
+in the format VARIABLE=value. If you want to check for equality between two
+Debian Architectures, you can use \fB\-e\fR, by default it will compare against
+the currect Debian Architecture, being it the host. If you want to check for
+identity of the current Debian Architecture against an Architecture Alias, you
+can use \fB\-i\fR. If you are only interested in the value of a single variable,
+you can use \fB\-q\fR. If you specify \fB\-s\fR, it will output an export
command. This can be used to set the environment variables using eval. \fB\-u\fR
does return a similar command to unset all variables. \fB\-c\fR does execute a
command in an environment which has all variables set to the determined
The machine the package is built for.
.IP "Debian Architecture" 4
.IX Item "Debian Architecture"
-The Debian archietcture string, which specifies the binary tree in the \s-1FTP\s0
+The Debian architecture string, which specifies the binary tree in the \s-1FTP\s0
archive. Examples: i386, sparc, hurd\-i386.
+.IP "Architecture Alias" 4
+.IX Item "Architecture Alias"
+An architecture alias is a wildcard architecture that will match any real
+architecture being part of it. The general form is <kernel>\-<cpu>.
+Examples: linux\-any, linux\-alpha, any\-i386, hurd\-any.
.IP "\s-1GNU\s0 System Type" 4
.IX Item "GNU System Type"
An architecture specification string consisting of two parts,
.SH "BACKWARD COMPATIBILITY"
.IX Header "BACKWARD COMPATIBILITY"
The DEB_HOST_ARCH_CPU and DEB_HOST_ARCH_OS variables were only introduced
-in relatively versions of \fIdpkg-architecture\fR (since dpkg 1.13.2),
+in relatively recent versions of \fIdpkg-architecture\fR (since dpkg 1.13.2),
before this \fIdebian/rules\fR files tended to check the values of the
DEB_HOST_GNU_CPU or DEB_HOST_GNU_TYPE variables which have been subject
to change.
And similarly for DEB_BUILD_ARCH_CPU and DEB_BUILD_ARCH_OS.
.PP
If you still wish to support versions of dpkg-dev that did not include
-\fIdpkg-architetcure\fR, the following does the job:
+\fIdpkg-architecture\fR, the following does the job:
.IP
.nf
\&\s-1DEB_BUILD_ARCH\s0 := $(shell dpkg \-\-print\-architecture)
.I archive
.br
.B dpkg\-deb
+.BR \-W | \-\-show
+.RB " [" \-\-showformat\fR=\fIformat "]"
+.I archive
+.br
+.B dpkg\-deb
.BR \-x | \-\-extract | \-X | \-\-vextract
.I archive directory
.br
+.B dpkg\-deb
+.BR \-e | \-\-control
+.I archive directory
+.br
.B dpkg\-deb \-\-fsys\-tarfile
.I archive
-.br
-.B dpkg\-deb \-\-control
-.I archive directory
.SH DESCRIPTION
.B dpkg\-deb
packs, unpacks and provides information about Debian archives.
components weren't present it will print an error message to stderr
about each one and exit with status 2.
.TP
+.BR \-\-show ", " \-W
+Provides information about a binary package archive in the format
+specified by the
+.B \-\-showformat
+argument.
+
+This argument is a string that may reference any status field using the
+"${\fIfield-name\fR}" form, a list of the valid fields can be easily
+produced using
+.B -I
+on the same package.
+
+The default for this field is "${Package}\\t${Version}\\n".
+.TP
.BR \-\-field ", " \-f
Extracts control file information from a binary package archive.
.SH SEE ALSO
.BR deb (5),
.BR deb\-control (5),
-.BR dpkg (8),
-.BR dselect (8).
+.BR dpkg (1),
+.BR dselect (1).
.SH AUTHOR
.B dpkg\-deb
and this manpage were written by Ian Jackson. They are
Note: dpkg\-divert preserves the old copy of this file, with extension
"\-old", before replacing it with the new one.
.SH SEE ALSO
-.BR dpkg (8).
+.BR dpkg (1).
.SH AUTHOR
Copyright (C) 1995 Ian Jackson.
.sp
.SH SEE ALSO
.BR deb (5),
.BR deb\-control (5),
-.BR dpkg (8),
+.BR dpkg (1),
.BR dpkg\-deb (1),
.BR find (1),
.BR xargs (1).
-.TH DPKG\-QUERY 1 "August 2001" "Debian Project" "dpkg suite"
+.TH dpkg\-query 1 "2006-01-26" "Debian Project" "dpkg suite"
.SH NAME
dpkg\-query \- a tool to query the dpkg database
shell wildchars are allowed in \fIpackage-name-pattern\fP. Please note
you will probably have to quote \fIpackage-name-pattern\fP to prevent
the shell from performing filename expansion. For example this will
-list all package names starting with \*(lqlibc5\*(rq:
+list all package names starting with \*(lqlibc6\*(rq:
.T
.nf
- \fBdpkg\-query \-l 'libc5*'\fP
+ \fBdpkg\-query \-l 'libc6*'\fP
.fi
+
+The output format of this option is not configurable, but varies
+automatically to fit the terminal width. It is intended for human
+readers, and is not easily machine-readable. See \fB\-W\fP (\fB\-\-show\fP)
+and \fB\-\-showformat\fP for a way to configure the output format.
.TP
\fB\-W\fP | \fB\-\-show\fP \fIpackage-name-pattern\fP ...
Just like the \fB\-\-list\fP option this will list all packages matching
the given pattern. However the output can be customized using the
\fB\-\-showformat\fP option.
+The default output format gives one line per matching package, each line
+having the name and installed version of the package, separated by a tab.
.TP
\fB\-s\fP | \fB\-\-status\fP \fIpackage-name\fP ...
Report status of specified package. This just displays the entry in
\fB-f\fP | \fB\-\-showformat=\fP\fIformat\fR
This option is used to specify the format of the output \fB\-\-show\fP
will produce. The format is a string that will be output for each package
-listed. It can include the standard escape sequences \en (newline), \er
-(carriage return) or \e\e (plain backslash). Package information can be
-included by inserting variable references to package fields using the
-${var[;width]} syntax. Fields are printed be right-aligned unless the
-width is negative in which case left alignment will be used.
+listed.
+
+In the format string, \(lq\fB\e\fP\(rq introduces escapes:
+
+.T
+.nf
+ \fB\en\fP newline
+ \fB\er\fP carriage return
+ \fB\et\fP tab
+.fi
+
+\(lq\fB\e\fP\(rq before any other character suppresses any special
+meaning of the following character, which is useful for \(lq\fB\e\fP\(rq
+and \(lq\fB$\fP\(rq.
+
+Package information can be included by inserting
+variable references to package fields using the syntax
+\(lq\fB${\fP\fIfield\fR[\fB;\fP\fIwidth\fR]\fB}\fP\(rq. Fields are
+printed right-aligned unless the width is negative in which case left
+alignment will be used. The following \fIfield\fRs are recognised:
+
+.T
+.nf
+ \fBArchitecture\fP
+ \fBBugs\fP
+ \fBConffiles\fP
+ \fBConfig\-Version\fP
+ \fBConflicts\fP
+ \fBDepends\fP
+ \fBDescription\fP
+ \fBEnhances\fP
+ \fBEssential\fP
+ \fBFilename\fP
+ \fBInstalled\-Size\fP
+ \fBMD5sum\fP
+ \fBMSDOS\-Filename\fP
+ \fBMaintainer\fP
+ \fBOrigin\fP
+ \fBPackage\fP
+ \fBPre\-Depends\fP
+ \fBPriority\fP
+ \fBProvides\fP
+ \fBRecommends\fP
+ \fBReplaces\fP
+ \fBRevision\fP
+ \fBSection\fP
+ \fBSize\fP
+ \fBSource\fP
+ \fBStatus\fP
+ \fBSuggests\fP
+ \fBVersion\fP
+.fi
+
+The default format string is \(lq\fB${Package}\et${Version}\en\fP\(rq.
.SH ENVIRONMENT
.TP
.SH SEE ALSO
-.BR dpkg (8)
+.BR dpkg (1)
.B dpkg\-scanpackages
.RI [ \-u ]
.RI [ \-a<arch> ]
+.RI [ \-m ]
.I binarydir
.I overridefile
.RI [ pathprefix ]
.B dpkg\-scanpackages
sorts through a tree of Debian binary packages and creates a Packages
file, used by
-.BR dselect (8),
+.BR dselect (1),
etc, to tell the user what packages are available for installation. These
Packages files are the same as those found on Debian archive sites
and CD-ROMs. You might use
.PP
When \-a\fI<arch>\fP is specified, then instead of scanning for all debs,
a pattern consisting of *_all.deb and *_arch.deb is used.
+.PP
+If more than one version of a package is found only the newest one
+is included in the output. If they have the same version and only
+differ in architecture only the first one found is used. You can override
+this behaviour with the \fI\-m\fP switch. If given, all found packages
+are included in the output.
.
.SH THE OVERRIDE FILE
While most information about a package can be found in the control file,
maintainer substitutions which do not take effect.
.
.SH SEE ALSO
-.BR dpkg (8),
-.BR dselect (8),
+.BR dpkg (1),
+.BR dselect (1),
.BR dpkg\-scansources (1).
.IX Item "-s, --source-override file"
Use \fIfile\fR as the source override file. The default is the name of the
override file you specified with \fI.src\fR appended.
-.sp
+.Sp
The source override file is in a different format from the binary override
file. It contains only two whitespace separated fields, the first is the
source package name and the second is the section. Blank lines and comment
ensures that the original source is neither copied to the current
directory nor unpacked. Any original source tree that was in the
current directory is still removed.
+.PP
+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 \-L localshlibsfile
Causes
-.B dpkg\-shlibs
+.B dpkg\-shlibdeps
to read overriding shared library dependency information from
.I localshlibsfile
instead of
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.
machine we build on is determined automatically, and is also the default
for the host machine.
.TP
-.B \-i [<regexp>]
+.B \-i[<regexp>]
Passed unchanged to
.BR dpkg\-source .
.TP
-.B \-I <filename>
+.B \-I<filename>
Passed unchanged to
.BR dpkg\-source .
May be repeated multiple times.
.IR gain-root-command " and " sign-command .
.SH SEE ALSO
.BR dpkg\-deb (1),
-.BR dpkg (8),
-.BR dselect (8),
+.BR dpkg (1),
+.BR dselect (1),
.BR gpg (1),
.BR pgp (1).
.SH AUTHOR
.BR deb (5),
.BR deb\-control (5),
.BR dpkg\-deb (1),
-.BR dpkg (8)
+.BR dpkg (1)
.SH AUTHOR
.B dpkg\-split
and this manpage were written by Ian Jackson. They are
-.TH DPKG-STATOVERRIDE 8 "November 2000" "Debian project" "dpkg utililties"
+.TH DPKG-STATOVERRIDE 8 "2006-01-26" "Debian project" "dpkg utililties"
.SH NAME
dpkg\-statoverride - override ownership and mode of files
.SH SYNOPSIS
set to the new owner and mode.
.TP
.I \-\-remove <file>
-Remove an override for \fB<file>\fR, the status of \fB<file\fR is left
+Remove an override for \fB<file>\fR, the status of \fB<file>\fR is left
unchanged by this command.
.TP
.I \-\-list [<glob-pattern>]
Note: dpkg\-statoverride preserves the old copy of this file, with
extension "-old", before replacing it with the new one.
.SH SEE ALSO
-.BR dpkg (8)
+.BR dpkg (1)
.SH AUTHOR
Copyright 2000 Wichert Akkerman
.UR mailto:wakkerma@debian.org
-.TH DPKG 1 "April 12, 1998" "Debian Project" "dpkg suite"
+.TH DPKG 1 "2006-01-26" "Debian Project" "dpkg suite"
.SH NAME
dpkg - package manager for Debian
.SH DESCRIPTION
\fBdpkg\fP is a tool to install, build, remove and manage
Debian packages. The primary and more user-friendly
-front-end for \fBdpkg\fP is \fBdselect\fP(8). \fBdpkg\fP itself is
+front-end for \fBdpkg\fP is \fBdselect\fP(1). \fBdpkg\fP itself is
controlled entirely via command line parameters, which consist of exactly
one action and zero or more options. The action-parameter tells dpkg
what to do and options control the behavior of the action in some way.
upgrade, remove, purge; and `YYYY-MM-DD HH:MM:SS conffile <filename>
<decision>' for conffile changes where \fI<decision\fP is either install
or keep.
+.TP
+\fB\-\-no\-debsig\fP
+Do not try to verify package signatures.
.SH FILES
.TP
.I /etc/dpkg/dpkg.cfg
other application to actually download and install the requested
packages. For example, run \fBdselect\fP and choose "Install".
-Ordinarily, you will find that \fBdselect\fP(8) provides a more
+Ordinarily, you will find that \fBdselect\fP(1) provides a more
convenient way to modify the package selection states.
.br
.SH ADDITIONAL FUNCTIONALITY
following packages: \fIapt\fR, \fIaptitude\fR and \fIdebsums\fR.
.SH SEE ALSO
-\fBdselect\fP(8),
+\fBdselect\fP(1),
\fBdpkg\-deb\fP(1),
\fBdeb\fP(5),
\fBdeb\-control\fP(5),
See \fB/usr/share/doc/dpkg/THANKS\fP for the list of people who have
contributed to \fBdpkg\fP .
.SH SEE ALSO
-.BR dpkg (8)
+.BR dpkg (1)
-.TH DSELECT 1 "July 2001" "Debian Project" "Debian"
+.TH DSELECT 1 "2006-01-26" "Debian Project" "Debian"
.SH NAME
dselect \- Debian package management frontend
.SH SYNOPSIS
\- Install new packages or upgrade to newer versions.
.PP
.B dselect
-operates as a front-end to \fBdpkg(8)\fP, the low-level debian package
+operates as a front-end to \fBdpkg(1)\fP, the low-level debian package
handling tool. It features a full-screen package selections manager
-with package depends and conflicts resolver. When run with adminitrator
-priviledges, packages can be installed, upgraded and removed. Various
+with package depends and conflicts resolver. When run with administrator
+privileges, packages can be installed, upgraded and removed. Various
access methods can be configured to retrieve available package version
information and installable packages from package repositories.
Depending on the used access method, these repositories can be public
Details of the install action depend on the access method's implementation.
The user's attention and input may be required during installation,
configuration or removal of packages. This depends on the maintainer
-scripts in the package. Some packages make use of the \fBdebconf(8)\fP
+scripts in the package. Some packages make use of the \fBdebconf(1)\fP
library, allowing for more flexible or even automated installation
setups.
.sp
.SS quit
Quit \fBdselect\fP
.sp
-Exits the program with zero (succesful) errorcode.
+Exits the program with zero (successful) errorcode.
.sp
.SH Package selections management
.sp
in doing so and can not be assumed to be a sufficient substitute for
administrator skill and understanding. The user is required to
be familiar with the concepts underlying the Debian packaging system.
-In case of doubt, consult the \fBdpkg(8)\fP manpage and the Debian
+In case of doubt, consult the \fBdpkg(1)\fP manpage and the Debian
Policy manual, contained in the
.B debian-policy
package.
In a dependency resolution screen, there is also the possibility of
viewing the specific unresolved depends or conflicts related to the
package and causing it to be listed.
-.sp
+.sh
.SS Packages status list
.sp
The main select screen displays a list of all packages known to the debian
By pressing \fBenter\fP, the currently displayed set of selections
is accepted. If \fBdselect\fP detects no unresolved depends as a result
of the requested selections, the new selections will be set.
-However, if there are any unresolveded depends, \fBdselect\fP will again
+However, if there are any unresolved depends, \fBdselect\fP will again
prompt the user with a dependency resolution screen.
.sp
To alter a set of selections that creates unresolved depends or
standards. Use the access method provided by apt, it is not only not
broken, it is also much more flexible than the built in access methods.
.SH SEE ALSO
-.BR dpkg (8),
+.BR dpkg (1),
.BR apt-get (8),
.BR sources.list (5),
.BR deb (5).
See \fB/usr/share/doc/dpkg/THANKS\fP for the list of people who have
contributed to \fBdselect\fP .
.SH SEE ALSO
-.BR dselect (8)
+.BR dselect (1)
-.\" update\-alternatives.8
+C.\" update\-alternatives.8
.\" This man page is copyright 1997 Charles Briscoe-Smith
.\" This is free documentation; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published