Table of Contents
Debian is a volunteer organization which builds consistent distributions of pre-compiled binary packages of free software and distributes them from its archive.
The Debian archive is offered by many remote mirror sites for access through HTTP and FTP methods. It is also available as CD-ROM/DVD.
The Debian package management system, when used properly, offers the user to install consistent sets of binary packages to the system from the archive. Currently, there are 23720 packages available for the amd64 architecture.
The Debian package management system has a rich history and many choices for the front end user program and back end archive access method to be used. Currently, we recommend aptitude
as the main front end program for the Debian package management activity.
Table 3.1. List of the Debian package management tools
package |
popcon |
size |
description |
---|---|---|---|
|
V:21, I:98 |
8976 |
terminal-based package manager (current standard, front-end for |
|
V:85, I:99 |
5180 |
Advanced Packaging Tool, front-end for dpkg providing "http", "ftp", and "file" archive access methods ( |
|
V:5, I:93 |
884 |
tool for selecting tasks for installation on Debian system (front-end for |
|
V:7, I:89 |
2176 |
terminal-based package manager (previous standard, front-end for |
|
V:86, I:99 |
6920 |
package maintenance system for Debian |
|
V:0.12, I:0.6 |
136 |
older ftp method for dselect |
|
V:20, I:53 |
5844 |
graphical package manager (Gnome front-end for |
|
V:0.2, I:1.2 |
604 |
graphical package manager (Gnome front-end for |
|
V:5, I:15 |
1496 |
graphical package manager (KDE front-end for |
|
V:51, I:99 |
456 |
APT utility programs: |
|
V:3, I:6 |
241 |
package change history notification tool |
|
V:1.7, I:2 |
428 |
lists critical bugs before each APT installation |
|
V:1.9, I:8 |
140 |
APT package searching utility -- command-line interface |
|
V:0.18, I:0.9 |
92 |
recursively lists package dependencies |
![]() |
Note |
---|---|
The annoying bug #411123 for the mixed use of |
Here are some key points for package configuration on the Debian system:
The manual configuration by the system administrator is respected. In other words, the package configuration system makes no intrusive configuration for the sake of convenience.
Each package comes with its own configuration script with standardized user interface called debconf
(7) to help initial installation process of the package.
Debian Developers try their best to make your upgrade experience flawless with package configuration scripts.
Full functionalities of packaged software are available to the system administrator. But ones with security risks are disabled in the default installation.
If you manually activate a service with some security risks, you are responsible for the risk containment.
Esoteric configuration may be manually enabled by the system administrator. This may creates interference with popular generic helper programs for the system configuration.
![]() |
Warning |
---|---|
Do not install packages from random mixture of suites. It will likely break the package consistency which requires deep system management knowledge, such as compiler ABI, library version, interpreter features, etc. |
The newbie Debian system administrator should stay with the stable
release of Debian while applying only security updates. I mean that some of the valid actions are better avoided, as a precaution, until you understand the Debian system very well:
Do not include testing
or unstable
in /etc/apt/sources.list
,
Do not mix standard Debian with other non-Debian archives such as Ubuntu in /etc/apt/sources.list
,
Do not create /etc/apt/preferences
,
Do not change default behavior of package management tools through configuration files without knowing their full impacts,
Do not install random packages by "dpkg -i <random_package>
",
Do not ever install random packages by "dpkg --force-all -i <random_package>
",
Do not erase or alter files in /var/lib/dpkg/
, or
Do not overwrite system files by installing software programs directly compiled from source. (Install them into /usr/local
or /opt
.)
The non-compatible effects caused by above actions to the Debian package management system may leave your system unusable.
The serious Debian system administrator who runs mission critical servers, should use extra precautions:
Do not install any packages including security updates from Debian without thoroughly testing them with your particular configuration under safe conditions. (Although Debian has been offering an extremely stable system for a long time, you as the system administrator are responsible for your system in the end.)
Despite my warnings above, I know many readers of this document wish to run the "testing
" or "unstable
" suites of Debian as their main Desktop system since they work very well for self-administered Desktop environments. Because they are updated frequently, they offer the latest features.
![]() |
Caution |
---|---|
For your production server, the " |
It takes no more than simply setting the distribution string in the /etc/apt/sources.list
to the suite: "testing
" or "unstable
"; or the codename: "lenny
" or "sid
". This will let you live the life of eternal upgrades.
The use of "testing
" or "unstable
" is a lot of fun but comes with some risks. Even though the "unstable
" suite of Debian system looks very stable for most of the times, there have been some package problems on the "testing
" and "unstable
" suite of Debian system and a few of them were not so trivial to resolve. It may be quite painful for you. Sometimes, you may have a broken package or missing functionality for a few weeks.
Here are some ideas to ensure quick and easy recovery from bugs in Debian packages:
make the system dual bootable by installing the "stable
" suite of Debian system to another partition.
make the installation CD handy for the rescue boot.
consider installing apt-listbugs
to check the Debian Bug Tracking System (BTS) information before the upgrade.
learn the package system infrastructure enough to work around the problem.
create a chroot or similar environment and run the latest system in it in advance. (optional)
(If you can not do any one of these precautionary actions, you are probably not ready for the "testing
" and "unstable
" suites.)
Enlightenment with the following will save a person from the eternal karmic struggle of upgrade hell and let him reach Debian nirvana.
Let's look into the Debian archive from a system user's perspective. For the typical HTTP access, the archive is specified in the /etc/apt/sources.list
file as, e.g. for the current "stable
" == "etch
" system:
deb http://ftp.us.debian.org/debian/ etch main contrib non-free deb-src http://ftp.us.debian.org/debian/ etch main contrib non-free deb http://security.debian.org/ etch/updates main contrib deb-src http://security.debian.org/ etch/updates main contrib
Here, I tend to use codename "etch
" instead of suite name "stable
" to avoid surprises when the next "stable
" is released.
The meaning of this is described in "man 5 sources.list
" and key points are:
The "deb
" line defines for the binary packages.
The "deb-src
" line defines for the source packages.
The 1st argument is the root URL of the Debian archive.
The 2nd argument is the distribution: either the suite name or the codename.
The 3rd and following arguments are the list of valid archive component names of the Debian archive.
The "deb-src
" lines can safely be omitted (or commented out by placing "#" at the start of the line) if it is just for aptitude
which does not access source related meta data. It will speed up the updates of the archive meta data. The URL can be "http://
", "ftp://
", "file://
", ....
![]() |
Tip |
---|---|
If " |
Here are the lists of URL of the Debian archive sites and suite or codename used in the configuration file:
Table 3.2. Lists of Debian archive sites.
archive URL |
suite (codename) |
purpose |
---|---|---|
|
stable (etch) release |
|
|
testing (lenny) release |
|
|
unstable (sid) release |
|
|
experimental pre-release (optional, only for developer) |
|
|
Updates for the next stable point release (optional) |
|
|
Security updates for stable release (important) |
|
|
Security updates for testing release (important) |
|
|
Compatible updates for spam filter and IM clients, etc. |
|
|
Non-compatible updates for spam filter, IM clients, etc. |
|
|
Newer backported packages for etch. (non-official, optional) |
![]() |
Tip |
---|---|
For the Debian system with the " |
![]() |
Caution |
---|---|
Only pure |
![]() |
Caution |
---|---|
You should basically list only one of " |
Each Debian archive consists of 3 components. Components are alternatively called categories in "Debian Policy" or areas in "Debian Social Contract". The component is grouped by the compliance to "The Debian Free Software Guidelines " (DFSG):
Table 3.3. The lists of Debian archive components.
component |
number of packages |
criteria |
---|---|---|
|
23071 |
The package is fully compliant to DSFG and does not depend the |
|
293 |
The package is compliant to the DSFG but depends on the |
|
356 |
The package is not compliant to the DSFG but distributable and useful. |
Here the number of packages in the above is for the amd64 architecture. Strictly speaking, only the main
component archive shall be considered the Debian system.
The Debian archive organization can be studied best by pointing your browser to the each archive URL appended with dists
or pool
.
The distribution is referred by two ways, the suite or codename. The word distribution is alternatively used as the synonym to the suite in many documentation. The relationship between the suite and the codename can be summarized as:
Table 3.4. The relationship between suite and codename.
Timing |
suite = " |
suite =" |
suite =" |
---|---|---|---|
current (as of 2008-08-31 13:52:02 UTC) |
codename = " |
codename = " |
codename = " |
after the " |
codename = " |
codename = " |
codename = " |
The history of codenames are described in Debian FAQ: 6.3.1 Which other codenames have been used in the past?
In the stricter Debian archive terminology, the word "section" is specifically used for the categorization of packages by the application area. (Although, the word "main section" may sometimes be used to describe the Debian archive section which provides the main component.)
Every time a new upload is done by the Debian developer (DD) to the "unstable
" archive (via incoming processing), DD is required to ensure uploaded packages to be compatible with the latest set of packages in the latest "unstable
" archive.
If DD breaks this compatibility intentionally for important library upgrade etc, there is usually announcement to the debian-devel mailing list etc.
Before a set of packages are moved by the Debian archive maintenance script from the "unstable
" archive to the "testing
" archive, the archive maintenance script not only checks the maturity (about 10 days old) and the status of the RC bug reports for the packages but also tries to ensure them to be compatible with the latest set of packages in the "testing
" archive. This process makes the "testing
" archive very current and usable.
Through the gradual archive freeze process led by the release team, the "testing
" archive will be matured to make it completely consistent and bug free with some manual interventions. Then the new "stable
" release is created by assigning the codename for the old "testing
" archive to the new "stable
" archive and creating the new codename for the new "testing
" archive. The initial contents of the new "testing
" archive is exactly the same as that of the newly released "stable
" archive.
Both the "unstable
" and the "testing
" archives may suffer temporary glitches due to:
broken package upload to the archive (mostly for "unstable
"),
delay of accepting the new packages to the archive (mostly for "unstable
"),
archive synchronization timing issue (both for "testing
" and "unstable
"),
manual intervention to the archive such as package removal (more for "testing
"), etc.
So if you ever decide to use these archives, you should be able to fix or work around these kinds of glitches.
![]() |
Tip |
---|---|
When tracking the " |
See Debian Policy Manual for definition of:
"Sections",
"Priorities",
"Base system", and
The Debian system offers a consistent set binary packages through its versioned binary dependency declaration mechanism through the control file fields. Here is a bit over simplified definition for them.
Table 3.5. List of package dependencies.
dependency |
meaning |
---|---|
Depends |
This declares an absolute dependency and all of the packages listed in this field must be installed at the same time or in advance. |
Pre-Depends |
This is like Depends, except that it requires completed installation of the listed packages in advance. |
Recommends |
This declares a strong, but not absolute, dependency. Most users would not want the package unless all of the packages listed in this field are installed. |
Suggests |
This declares a weak dependency. Many users of this package may benefit from installing packages listed in this field but can have reasonable functions without them. |
Enhances |
This declares a week dependency like Suggests but works in the opposite direction. |
Conflicts |
This declares an absolute incompatibility. All of the packages listed in this field must be removed to install this package. |
Replaces |
This is declared when files installed by this package replace files in the listed packages. |
Provides |
This is declared when this package provide all of the files and functionality in the listed packages. |
![]() |
Note |
---|---|
Please note that defining, Provides, Conflicts and Replaces simultaneously to an virtual package is the sane configuration. This ensures that only one real package providing this virtual package can be installed at any one time. |
The official definition including source dependency can be found in the Policy Manual: Chapter 7 - Declaring relationships between packages.
The simplified event flow of the upgrade and the install are:
The local copy of the package archive information is updated (fetch data -> reconstruct meta data).
APT system makes decision on candidate version which is usually the latest available version. (See Section 3.4.3, “Tweaking candidate version”} for exception.)
The system administrator makes choice such as upgrade of the entire system or install several new packages with candidate version.
Selected binary packages are processed as (fetch -> unpack -> preinst -> install -> postinst).
The package removal process has 2 distinct stages and the simplified event flow of them are:
remove : remove all installed files except configuration files as (prerm -> remove -> postrm).
purge : purge all installed files completely including configuration files as (prerm -> purge -> postrm).
Here, I intentionally skipped technical details for the sake of big picture.
Aptitude is the current preferred package management tool for the Debian system. It can be used as the commandline alternative to apt-get
/apt-cache
and also as the full screen menu-driven tool alternative to dselect
.
The selection of a package in aptitude
not only pulls in packages which are defined in its "Depends:
" list but also defined in the "Recommends:
" list if the menu "F10
-> Options -> Dependency handling" is set accordingly. These auto installed packages are removed automatically if they are no longer needed under aptitude
.
![]() |
Note |
---|---|
Before the " |
For the package management, you start aptitude
interactive mode from the console shell prompt as:
$ sudo aptitude -u Password:
This will update the local copy of the archive information and display the package list in the full screen with menu. Aptitude places its configuration at $HOME/.aptitude/config
.
![]() |
Tip |
---|---|
If you want to use root's configuration instead of user's one, use " |
Notable key strokes to browse status of packages and to set "planned action" on them in this full screen mode are:
Table 3.6. List of key bindings for aptitude.
key |
key binding |
---|---|
|
Menu |
|
Display help for keystroke (more complete listing) |
|
Display User's Manual |
|
Update package archive information |
|
Mark the package for the upgrade or the install |
|
Mark the package for the remove (keep conffiles) |
|
Mark the package for the purge (remove conffiles) |
|
Place the package on hold |
|
Mark all upgradable packages (function as dist-upgrade) |
|
Start downloading and installing selected packages |
|
Quit current screen and save changes |
|
Quit current screen and discard changes |
|
View information about a package |
|
View a package's changelog |
|
Change the limit for the displayed packages |
|
Search for the first match |
|
Repeat the last search |
The file name specification of the command line and the menu prompt after pressing "l
" and "/
" take the aptitude regex as described below. For the input to the menu prompt and argument to "aptitude search
" command, "~n
" is prepended to match the package name with the pattern if the input does not start with "~
" character.
![]() |
Tip |
---|---|
You need to press " |
In the interactive full screen mode of aptitude
(8), packages in the package list are displayed like this by default:
idA libsmbclient -2220kB 3.0.25a-1 3.0.25a-2
Here, this line means from the left as:
The "current state" flag (the first letter)
The "planned action" flag (the second letter)
The "automatic" flag (the third letter)
The package name
The change in disk space usage attributed to "planned action".
The current version of the package.
The candidate version of the package.
![]() |
Tip |
---|---|
The full list of flags are given at the bottom of Help screen shown by pressing " |
The candidate version is chosen according to the current local policy and preferences (see apt_preferences
(5)).
Several types of package views are available under the menu "Views":
Table 3.7. Views for aptitude.
view |
categorization |
status |
---|---|---|
Package View |
See Table 3.8, “The categorization of standard aptitude views. ”. (default) |
Good |
Audit Recommendations |
Packages which are recommended by some installed packages but not yet installed are listed. |
Good. |
Flat Package List |
Packages are listed without categorization (for use with regex). |
Good |
Debtags Browser |
Packages are categorized according to their debtags entries. |
Very usable |
Categorical Browser |
Packages are categorized according to their category. |
Deprecated (Use debtags!) |
![]() |
Note |
---|---|
Please help us improving tagging packages with debtags! |
The standard "Package View" categorizes packages somewhat like dselect
with few extra features. For switching distribution to a newer one can be achieved basically by
Table 3.8. The categorization of standard aptitude views.
category |
organization |
---|---|
"Upgradable Packages" |
Organized as section --> component --> package |
"New Packages" |
, , |
"Installed Packages" |
, , |
"Not Installed Packages" |
, , |
"Obsolete and Locally Created Packages" |
, , |
"Virtual Packages" |
You can pick a particular package from a set of packages with the same function. |
"Tasks" |
You can cherry pick particular packages from a set of packages of a task. |
If you are migrating from the apt-get
/apt-cache
usage, here is the rough guide for the aptitude
equivalents:
Table 3.9. The comparative commands for aptitude and apt-get/apt-cache.
New |
Old |
---|---|
|
|
|
|
|
|
|
N/A |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
N/A (See below) |
|
N/A |
You may lose the advantage of aptitude
keeping track of which packages you have deliberately installed if other package tools are used. Although it is now safe to mix different package tools on the Debian system, it is best to continue using aptitude
as much as possible.
The difference between upgrade
and dist-upgrade
only appears when new versions of packages stand in different dependency relationships from old versions of those packages. The "aptitude upgrade
" command will never install new packages nor remove installed packages.
The "aptitude why <regex>
" can list more information by "aptitude -v why <regex>
". Similar information can be obtained by "apt-cache rdepends <package>
".
When aptitude
command is started in the commandline mode and faces some issues such as package conflicts, you can switch to the full screen mode by pressing "e
"-key later at the prompt.
You may provide command options right after "aptitude
".
Table 3.10. Notable command options for "aptitude".
command option |
effects |
---|---|
|
simulate the result of the command. |
|
download only but no install/upgrade. |
|
show brief explanations before the automatic installations and removals. |
See aptitude
(8) and the "User's Manual" /usr/share/doc/aptitude/README
for more.
The aptitude regex formula is mutt-like extended ERE (see: Section 2.6.2, “Regular expressions”) and the meanings of the aptitude
specific special match rule extensions are as below:
Table 3.11. List of the aptitude regex formula.
meaning of the extended match rule |
regex formula |
---|---|
match on package name |
|
match on description |
|
match on task name |
|
match on debtag |
|
match on maintainer |
|
match on package section |
|
match on package version |
|
match archive |
|
match origin |
|
match priority |
|
match essential packages |
|
match virtual packages |
|
match new packages |
|
match with pending action |
|
match installed packages |
|
match installed packages with A-mark (auto installed package) |
|
match installed packages without A-mark (administrator selected package) |
|
match installed and upgradable packages |
|
match removed but not purged packages |
|
match removed, purged or can-be-removed packages |
|
match with broken relation |
|
match broken depends/predepends/conflict packages |
|
match packages whose control files define relation <type> to the <term> package |
|
match packages whose control files define broken relation <type> to the <term> package |
|
match packages to which the <term> package defines relation <type> |
|
match packages to which the <term> package defines broken relation <type> |
|
match packages to which some other installed packages depend on |
|
match packages to which no other installed packages depend on |
|
match packages to which some other installed packages depend or recommend on |
|
match <term> package with filtered version |
|
match all packages (true) |
|
match no packages (false) |
|
Here,
regex part is the same ERE as the one used in typical Unix-like text tools using "^
", ".*
", "$
" etc. as in egrep
, awk
and perl
.
relation <type> is one of (depends, predepends, recommends, suggests, conflicts, replaces, provides).
the default relation type is "depends".
![]() |
Tip |
---|---|
When <regex_pattern> is a null string, place " |
Short cuts:
"~P<term>
" == "~Dprovides:<term>
"
"~C<term>
" == "~Dconflicts:<term>
"
"...~W term
" == "(...|term)
"
Users familiar with mutt
will pick up quickly, as mutt was the inspiration for the expression syntax. See "SEARCHING, LIMITING, AND EXPRESSIONS" in the "User's Manual" /usr/share/doc/aptitude/README
.
Aptitude offers several options for you to search packages using its regex formula:
"aptitude search '<aptitude_regex>'
" to list their installation status, package name and short description.
"aptitude show '<package_name>'
" to list their installation detailed description.
limit view to matching packages: Type "l
" in the full screen mode.
search the first found package: type "/
" in the full screen mode. "n
" for find-next, "\
" for backward search.
Here, the string for <package_name> is treated as the exact string match to the package name unless it is started explicitly with "~
" to be the regex formula.
Here are few examples of using aptitude.
The following command lists packages with regex matching names.
$ aptitude search '~n(pam|nss).*ldap' p libnss-ldap - NSS module for using LDAP as a naming service p libpam-ldap - Pluggable Authentication Module allowing LDAP interfaces
This is quite handy for you to find the exact name of a package.
The regex "~dipv6
" in the "New Flat Package List" view with "l" prompt, highlights packages with the matching description and let you browse their information interactively.
Here is how I tidy auto/manual install status for packages (after using non-aptitude package installer etc.):
Start aptitude
in interactive mode as root.
Type "u
", "U
", "f
" and "g
" to update and upgrade package list and packages.
Type "l
" to enter the package tree limit as "~i(~R~i|~Rrecommends:~i)
" and type "M
" over "Installed Packages
" as auto installed.
Type "l
" to enter the package tree limit as "~prequired|~pimportant|~pstandard|~E
" and type "m
" over "Installed Packages
" as manual installed.
Type "l
" to enter the package tree limit as "~i!~M
" and remove unused package by typing "-
" over each of them after exposing them by typing "[
" over "Installed Packages
".
Type "l
" to enter the package tree limit as "~i
" and type "m
" over "Tasks
" as manual installed.
Exit aptitude
.
Start "apt-get -s autoremove|less
" as root to check what are not used.
Restart aptitude
in interactive mode and mark needed packages as "m
".
Restart "apt-get -s autoremove|less
" as root to recheck REMOVED contain only expected packages.
Start "apt-get autoremove|less
" as root to autoremove unused packages.
The "m
" action over "Tasks
" is an optional one to prevent mass package removal situation in future.
You can purge all remaining configuration files of removed packages:
# aptitude search '~c'
check results
# aptitude purge '~c'
You may want to do the similar in the interactive mode so you can have a bit more fine grained control over the action to exclude "Obsolete and Locally Created Packages" to be purged.
You can perform system wide upgrade to a newer release by changing contents of the /etc/apt/sources.list
file pointing to a new release and running the "aptitude update; aptitude dist-upgrade
" command.
To upgrade from "stable
" to "testing
" or "unstable
", you replace "etch
" in the /etc/apt/sources.list
example of Section 3.1.4, “Debian archive basics” with "lenny
" or "sid
".
In reality, you may face some complications due to some package transition issues, mostly due to package dependencies. The larger the difference of the upgrade, the more likely you face larger troubles. For the transition from the old "stable
" archive to the new "stable
" after its release, you can read its new Release Notes and follow the exact procedure described in it to minimize troubles.
When you decide to move from "stable
" to "testing
" before its formal release, there are no Release Notes to help you. The difference between "stable
" and "testing
" could have grown quite large after the previous "stable
" release and makes upgrade situation complicated.
You should make some precautionary moves while gathering latest information from mailing list and using common senses:
read previous "Release Notes".
back up entire system (especially data and configuration information).
have bootable media handy for broken bootloader.
inform users on the system well in advance.
record upgrade activity with the script
(1) command.
apply "unmarkauto" to essential packages, e.g., "aptitude unmarkauto vim
", to prevent removal.
minimize installed packages to reduce chance of package conflicts, e.g., remove desktop task packages.
remove the /etc/apt/preferences
file. (disable apt-pinning)
try to upgrade step wise: "oldstable
" --> "stable
" --> "testing
" --> "unstable
".
update the /etc/apt/sources.list
file to point to new archive only and run "aptitude update
".
install, optionally, new core packages first, e.g., "aptitude install perl
".
run the "aptitude dist-upgrade -s
" command to assess impact.
run the "aptitude dist-upgrade
" command.
![]() |
Caution |
---|---|
It is not wise to skip major Debian release when upgrading between " |
![]() |
Caution |
---|---|
In previous "Release Notes", GCC, Linux Kernel, initrd-tools, Glibc, Perl, APT tool chain, etc. have required some special attention for system wide upgrade. |
For daily upgrade in "unstable
", see Section 3.1.16, “Safeguard for package problems”.
Aptitude has advantages over other APT based packaging systems (apt-get, apt-cache, synaptic, ...):
aptitude
removes unused auto installed packages automatically using its own extra layer of package state file (/var/lib/aptitude/pkgstates
). (For new lenny, other APT does the same.)
aptitude
makes it easy to resolve package conflicts and to add recommended packages.
aptitude
makes it easy to keep track of obsolete software by listing under "Obsolete and Locally Created Packages".
aptitude
gives a log of its history in /var/log/aptitude
.
aptitude
offers access to all versions of the package if available.
aptitude
includes a fairly powerful regex based system for searching particular packages and limiting the package display.
aptitude
in the full screen mode has su
functionality embedded and can be run from normal user until you really need administrative privileges.
For the old etch release version, synaptic
also gives you the history log; apt-get
did not but you can rely on the log of dpkg
.
Anyway, aptitude
is nice for interactive console use.
You can check package activity history in the log files.
Table 3.12. The log files for package activities.
file |
content |
---|---|
|
Log of |
|
Log of |
Here are list of low-level package maintenance tasks for which aptitude
is too high-level, plus the suggested tool.
Table 3.13. List of safe low level system maintenance commands.
action |
command |
---|---|
list status of an installed package for the bug report. |
|
list the contents of an installed package. |
|
list the manpages for an installed package. |
|
list installed packages which have matching file name. |
|
list packages in archive which have matching file name. |
|
list the contents of matching packages in archive. |
|
reconfigure the exact package . |
|
reconfigure the exact package with the most detailed question. |
|
reconfigure packages from the full screen menu. |
|
audit system for partially installed packages. |
|
configures all partially installed packages. |
|
show available version, priority, and archive information of a binary package. |
|
show available version, archive information of a package. |
|
show source package information of a binary package. |
|
Please note:
Unlike aptitude
which uses regex (see: Section 2.6.2, “Regular expressions”), these commands in the above use pattern like shell glob (see: Section 2.5.3, “Shell glob”).
apt-file
commands require apt-file
package and run "apt-file update
" in advance.
configure-debian
command requires configure-debian
package and runs dpkg-reconfigure
as its backend.
dpkg-reconfigure
command runs package scripts using debconf
as its backend.
The grep-dctrl
(1), grep-status
(1), and grep-available
(1) commands can be used to search any file which has the general format of a Debian package control file.
The "dpkg -S <file_name_pattern>
" can be used search package names which contain files with the matching name installed by dpkg
. But this overlooks files created by the maintainer scripts.
If you need to make more elaborate search on the dpkg meta data, you need to run "grep -e regex_pattern *
" command in the /var/lib/dpkg/info/
directory. This will let you identify:
the package name which installs, creates or modifies particular file which match pattern.
the package name which asks the installation query words which match pattern.
If you wish to look up package dependency recursively, you should use apt-rdepends
(8).
Here are list of tasks for the advanced system maintenance such as creating and installing the backported and customized packages on the target system itself. For this kind of tasks, aptitude
is not much of help and other lower level package and porting tools should be carefully used by the expert.
Table 3.14. List of advanced low level system maintenance commands.
install required packages to build package. |
|
---|---|
download a source. (from standard archive) |
|
download a source and rebuild package(s) locally. |
|
download a source packages. (from other archive) |
|
build a source tree from a set of source packages (*.tar.gz *.diff.gz). |
|
build package(s) from a local source tree. |
|
build a kernel package from a kernel source tree. |
|
build a kernel package from a kernel source tree with initramfs enabled. |
|
install a local package to the system. |
|
install local package(s) to the system. |
|
save |
|
set |
|
Please note:
"apt-get build-dep
", "apt-get source
" and "apt-cache showsrc
" commands require deb-src
entry in /etc/apt/sources.list
.
dget
, debuild
, and debi
commands require devscripts
package.
make-kpkg
command requires kernel-package
package.
All system configuration and installation commands require to be run from root.
![]() |
Tip |
---|---|
See Section 13.9, “Making Debian package” for general packaging. |
The installation of debsums
package enables verification of installed package files against MD5sum values in the Packages
file with debsums
(1) command. See: Section 11.3.5, “The MD5 sum” for how MD5sum works.
Many user prefer to follow the unstable release of the Debian system for its new features and packages. This makes the system more prone to be hit by the critical package bugs.
The installation of the apt-listbugs
package will provide safeguard to the critical bugs by checking Debian BTS automatically for critical bugs when upgrading with APT system.
The installation of the apt-listchanges
package will provide important news in NEWS.Debian when upgrading with APT system.
You should read the fine official documentation. The first document to read is the Debian specific /usr/share/doc/<package_name>/README.Debian
. Other documentation in /usr/share/doc/<package_name>/
should be consulted too. If you set shell as previously discussed, type:
$ cd <package_name> $ pager README.Debian $ mc
You may need to install the corresponding documentation package named with "-doc
" suffix for detailed information.
If you are experiencing problems with a specific package, make sure to check out these sites first:
Table 3.15. List of key web site to resolving problems with a specific package.
site |
command |
---|---|
Home page of the Debian bug tracking system (BTS) |
|
The bug report of a known package name. |
|
The bug report of known bug number. |
|
Search Google with search words including "site:debian.org".
When you file a bug report, please use reportbug
command.
Downgrading from a later release of a package to an earlier one is not officially supported in Debian (see: Section 3.4.3, “Tweaking candidate version”). However, you may find that you have to downgrade a specific package in order to re-install a version of a package that works when a new version malfunctions. You may find these previous package files locally in /var/cache/apt/archives/
or remotely at http://snapshot.debian.net/. You need to make sure the consistency are kept.
Let's learn how the Debian package management system works internally. This should help you to create your own solution to some package problems.
The meta data files are stored under the dist/
on each Debian mirror sites, e.g., ftp://ftp.us.debian.org/debian/
. Its archive structure can be browsed by the web browser. There are 6 types of key meta data:
Table 3.16. The content of the Debian archive meta data.
file |
location |
content |
---|---|---|
|
top of distribution |
archive description and integrity information |
|
top of distribution |
signature file for |
|
top of distribution |
list of all files for all the packages in the pertinent archive |
|
top of each distribution/component/architecture combination |
archive description |
|
top of each distribution/component/binary-architecture combination |
concatenated |
|
top of each distribution/component/source combination |
concatenated |
In the recent archive, these meta data are stored as the compressed and differential files to reduce network traffic.
Each suites of the Debian archive has a top level Release file, e.g., ftp://ftp.us.debian.org/debian/dists/unstable/Release
:
Origin: Debian Label: Debian Suite: unstable Codename: sid Date: Sat, 26 Jan 2008 20:13:58 UTC Architectures: alpha amd64 arm hppa hurd-i386 i386 ia64 m68k mips mipsel powerpc s390 sparc Components: main contrib non-free Description: Debian x.y Unstable - Not Released MD5Sum: e9f11bc50b12af7927d6583de0a3bd06 22788722 main/binary-alpha/Packages 43524d07f7fa21b10f472c426db66168 6561398 main/binary-alpha/Packages.gz ...
![]() |
Note |
---|---|
Here, you can find my rationale to use the "suite", "codeneme", and "components" in Section 3.1.4, “Debian archive basics”. The "distribution" is used when referring to both "suite" and "codeneme". |
The integrity of the top level Release
file is verified by cryptographic infrastructure called the secure apt.
The cryptographic signature file Release.gpg
is created from the authentic top level Release
file and the secret Debian archive key.
The public Debian archive signing key can be seeded into /etc/apt/trusted.gpg
:
automatically by installing the keyring with the latest base-files
package, or
manually by gpg
or apt-key
tool with the latest public archive key posted on the ftp-master.debian.org .
The secure APT system verifies the integrity of the downloaded top level Release
file cryptographically by this Release.gpg
file and the public Debian archive key in /etc/apt/trusted.gpg
.
The integrity of all the Packages
and Sources
files are verified by using MD5sum values in its top level Release
file. The integrity of all package files are verified by using MD5sum values in the Packages
and Sources
files. See debsums
(1) and Section 3.1.15, “Verify installed package files”.
Since the cryptographic signature verification is very CPU intensive process than the MD5sum value calculation, use of MD5sum value for each package while using cryptographic signature for the top level Release
file provides the good security with the performance (see: Section 11.3, “Data security infrastructure”).
![]() |
Tip |
---|---|
The archive level Release files are used for the rule of |
There are archive level Release files for all archive locations specified by "deb:
" line in /etc/apt/sources.list
, such as "ftp://ftp.us.debian.org/debian/dists/unstable/main/binary-amd64/Release
" or "ftp://ftp.us.debian.org/debian/dists/sid/main/binary-amd64/Release
":
Archive: unstable Component: main Origin: Debian Label: Debian Architecture: amd64
![]() |
Caution |
---|---|
For Archive stanza, suite names (" |
For some archives, such as "experimental
", "volatile-sloppy
", and "etch-backports
", which contain packages which should not be installed automatically, there is an extra line, e.g., "ftp://ftp.us.debian.org/debian/dists/experimental/main/binary-amd64/Release
":
Archive: experimental Component: main Origin: Debian Label: Debian NotAutomatic: yes Architecture: amd64
Please note that for normal archives without "NotAutomatic: yes
", the default Pin-Priority value is 500, while for special archives with "NotAutomatic: yes
", the default Pin-Priority value is 1 (see apt_preferences
(5) and Section 3.4.3, “Tweaking candidate version”).
When APT tools, such as aptitude
, apt-get
, synaptic
, apt-file
, auto-apt
..., are used, we need to update the local copies of the meta data containing the Debian archive information. These local copies have file names corresponding to the specified distribution
component
and architecture
names in the /etc/apt/sources.list
(see: Section 3.1.4, “Debian archive basics”) under the /var/lib/apt/lists
directory as:
ftp.us.debian.org_debian_dists_<distribution>_Release
ftp.us.debian.org_debian_dists_<distribution>_Release.gpg
ftp.us.debian.org_debian_dists_<distribution>_<section>_binary-<architecture>_Packages
ftp.us.debian.org_debian_dists_<distribution>_<section>_source_Sources
/var/cache/apt/apt-file/ftp.us.debian.org_debian_dists_<distribution>_Contents-<architecture>.gz
(for apt-file
)
First 4 are shared by all the pertinent APT commands and updated from command line by "apt-get update
" and "aptitude update
". The Packages
meta data are updated if there is the deb
line in /etc/apt/sources.list
. The Sources
meta data are updated if there is the deb-src
line in /etc/apt/sources.list
.
The Packages
and Sources
meta data contain "Filename:
" stanza pointing to the file location of the binary and source packages. Currently, they are located under the pool/
directory tree for the improved transition over the releases.
The local copies of Packages
meta data can be interactively searched with the help of aptitude
. The specialized search command grep-dctrl
(1) can search the local copies of Packages
and Sources
meta data.
The local copyies of Contents-<architecture> files can be updated by "apt-file update
" and location is different from other 4 files. See apt-file
(1). (The auto-apt
uses different location for local caching of Contents-<architecture>.gz
as default.)
In addition to the remotely fetched meta data, the APT tool after "lenny
" stores its locally generated installation state information in the /var/lib/apt/extended_states
which is used only by all APT tools to track all auto installed packages.
All the remotely fetched packages via APT mechanism are stored in the /var/cache/apt/packages
until they are cleaned.
The Debian package files has particular name structures:
Table 3.17. The name structures of the Debian packages.
entity |
name structure |
---|---|
The binary package (a.k.a deb) |
<package-name>_<epoch>:<upstream-version>-<debian.version>-<architecture>.deb |
The binary package for the debian-installer (a.k.a udeb) |
<package-name>_<epoch>:<upstream-version>-<debian.version>-<architecture>.udeb |
The source package (upstream source) |
<package-name>_<epoch>:<upstream-version>-<debian.version>.tar.gz |
The source package (Debian changes) |
<package-name>_<epoch>:<upstream-version>-<debian.version>.diff.gz |
The source package (description) |
<package-name>_<epoch>:<upstream-version>-<debian.version>.dsc |
where,
Table 3.18. The usable characters for each component in the Debian package names.
component |
usable characters (regex) |
required |
---|---|---|
<package-name> |
|
required |
<epoch>: |
|
optional |
<upstream-version> |
|
required |
<debian.version> |
|
optional |
![]() |
Note |
---|---|
You can check package version order by |
![]() |
Note |
---|---|
The debian-installer (d-i) uses |
The dpkg
is the lowest level tool for the Debian package management. This is very powerful and this need to be used with care.
The fetched package is processed by dpkg
in the following order:
unpack the deb file ("ar -x
" equivalent)
preinst using debconf
install the package content to the system ("tar -x
" equivalent)
postinst using debconf
The debconf
system provides standardized user interaction with i18n and l17n supports.
Here dpkg
creates following files under /var/lib/dpkg/info/
directory : While installing package called <package_name>
, dpkg
creates several files and execute scripts.
Table 3.19. The notable files for dpkg.
file |
contents |
---|---|
|
list of user modifiable files. |
|
list of files and directories installed by the package. |
|
list of MD5 hash values for files installed by the package. |
|
package script run before the package installation. |
|
package script run after the package installation. |
|
package script run before the package removal. |
|
package script run after the package removal. |
|
package script for |
|
the alternative information used by the |
|
the availability information for all the package. |
|
the diversions information used by the |
|
the status information for all the packages. |
|
the first-generation backup of the |
|
the second-generation backup and older ones of the |
The last file status
is also used by the tools such as "dpkg
", "select update
" and "apt-get -u dselect-upgrade
".
The specialized search command grep-dctrl
(1) can search the local copies of status
and available
meta data.
![]() |
Tip |
---|---|
In the debian-installer environment, the |
The Debian system has mechanism to install somewhat overlapping programs peacefully using update-alternatives
(8). For example, to make the command vi
select to run vim
while installing both vim
and nvi
:
$ ls -l $(type -p vi) lrwxrwxrwx 1 root root 20 2007-03-24 19:05 /usr/bin/vi -> /etc/alternatives/vi $ sudo update-alternatives --display vi ... $ sudo update-alternatives --config vi Selection Command ----------------------------------------------- 1 /usr/bin/vim *+ 2 /usr/bin/nvi Enter to keep the default[*], or type selection number: 1
The Debian alternatives system keeps its selection as symlinks in /etc/alternatives/
. The selection process uses corresponding file in /var/lib/dpkg/alternatives/
.
Stat overrides provided by the dpkg-statoverride
(8) command are a way to tell dpkg
(1) to use a different owner or mode for a file when a package is installed. If "--update
" is specified and file exists, it is immediately set to the new owner and mode.
![]() |
Note |
---|---|
I use the word file here, but in reality this can be any filesystem object that |
![]() |
Caution |
---|---|
The direct alteration of owner or mode for a file owned by the package using |
File diversions provided by the dpkg-divert
(8) command are a way of forcing dpkg
(1) not to install a file into its default location, but to a diverted location. The use of dpkg-divert
is meant for the package maintenance scripts. Its use by the system administrator is deprecated.
When running "unstable
" system, the administrator is expected to recover from broken package management situation.
![]() |
Caution |
---|---|
Some methods described here are high risk actions. You have been warned! |
If a desktop GUI program experienced instability after significant upstream version upgrade, you should suspect interferences with old local configuration files created by it. If it is stable under newly created user account, this hypothesis is confirmed. (This is a bug of packaging and usually avoided by the packager.)
To recover stability, you should move corresponding local configuration files and restart the GUI program. You may need to read old configuration file contents to recover configuration information later. (Do not erase them too quickly.)
The archive level package management systems, such as aptitude
(8) or apt-get
(1), will not even try to install packages with overlapped files using package dependencies (see Section 3.1.5, “Package dependencies”).
Errors by the package maintainer or deployment of inconsistently mixed source of archives (see Section 3.4.2, “Packages from mixed source of archives”) by the system administrator may create situation with incorrectly defined package dependencies. When you install a package with overlapped files using aptitude
(8) or apt-get
(1) under such situation, dpkg
(1) which unpacks package ensures to return error to the calling program without overwriting existing files.
![]() |
Caution |
---|---|
The use of third party packages introduces significant system risks via maintainer scripts which are run with root privilege and can do anything to your system. The |
You can work around such broken installation by removing the old offending package, <old-package>
, first:
$ sudo dpkg -P <old-package>
When a command in the package script returns error for some reason and the script exits with error, the package management system aborts their action and ends up with partially installed packages. When a package contains bugs in its removal scripts, the package may become impossible to remove and quite nasty.
For the package script problem of "<package_name>
", you should look for:
/var/lib/dpkg/info/<package_name>.preinst
/var/lib/dpkg/info/<package_name>.postinst
/var/lib/dpkg/info/<package_name>.prerm
/var/lib/dpkg/info/<package_name>.postrm
You edit the offending part of the script from the root:
to prepend with ": #
" or,
to append with "|true
".
Then configures all partially installed packages by:
# dpkg --configure -a
Since dpkg
is very low level package tool, it can function under the very bad situation such as unbootable system without network connection. Let's assume foo
package was broken and needs to be replaced.
You may still find cached copies of older version of foo
package in /var/cache/apt/archives/
which is bug free or you may be able to download a bug free foo
package to other functioning machine. If you can boot the system, you may install it by:
# dpkg -i /path/to/foo_<old_version>_<arch>.deb
![]() |
Tip |
---|---|
If system breakage is minor, you may alternatively downgrade the whole system as Section 3.4.5, “Emergency downgrading” using the higher level APT system. |
If your system is unbootable and if you are booting from the rescue CD while mounting the system to /target
, you may then alternatively install it by:
# dpkg --root /target -i /path/to/foo_<old_version>_<arch>.deb
This second example should work even if the dpkg
command on the system is broken.
If attempting to install a package this way fails due to some dependency violations and you really need to do this as the last resort, you can override dependency using dpkg
's --ignore-depends
, --force-depends
and other options. If you do this, you need to make serious effort to restore proper dependency later. See dpkg
(8) for details.
If /var/lib/dpkg/status
becomes corrupt for any reason, the Debian system loses package selection data and suffers severely. Look for the old /var/lib/dpkg/status
file at /var/lib/dpkg/status-old
or /var/backups/dpkg.status.*
.
Keeping /var/backups/
in a separate partition may be a good idea since this directory contains lots of important system data.
If everything is gone, I recommend to make fresh re-install after making backup of the system in such serious breakage though. You can still recover some information from directories in /usr/share/doc/
to guide your new installation.
... reinstall minimal (desktop) system ... place old system at /path/to/old/system/ # cd /path/to/old/system/usr/share/doc # ls -1 >~/ls1.txt # cd /usr/share/doc # ls -1 >>~/ls1.txt # cd # sort ls1.txt | uniq | less
Then you will be presented with missing package names. (There may be some non-package names such as "texmf
".)
You can seek packages which satisfy your needs with aptitude
from the package description or from the list under "Tasks".
When you encounter more than 2 similar packages and wonder which one to install without "trial and error" efforts, you can use some common sense. I consider following points are good indications of preferred packages.
essential: yes > no
component: main > contrib > non-free
priorities: required > important > standard > optional > extra
task: package listed in task such as desktop
package selected by the dependency package (e.g., python2.4
by python
)
popcon: higher in the vote and install number
changelog: regular updates by the maintainer
BTS: No RC bugs (no critical, no grave, and no serious bugs)
BTS: responsive maintainer to bug reports
BTS: higher number of the recently fixed bugs
BTS: lower number of remaining non-wishlist bugs
Debian being a volunteer project with distributed development model, its archive contains many packages with different focus and quality. You must make your own decision what to do with them.
![]() |
Caution |
---|---|
Installing packages from mixed source of archives is not supported by the official Debian distribution except for officially supported particular combinations of archives such as " |
Here is an example of operations to include specific newer upstream version packages found in "unstable
" while tracking "testing
" for single occasion:
change the /etc/apt/sources.list
file temporarily to single "unstable
" entry
run "aptitude update
"
run "aptitude install <package-name>
"
recover the original /etc/apt/sources.list
file for "testing
"
run "aptitude update
"
You do not create the /etc/apt/preferences
file nor need to worry about apt-pinning with this manual approach. But this is very cumbersome.
![]() |
Caution |
---|---|
When using mixed source of archives, you must ensure compatibility of packages by yourself since the Debian does not guarantee it. If package incompatibility exists, you may break system. You must be able to judge these technical requirements. The use of mixed source of random archives is completely optional operation and its use is not something I encourage you to use. |
General rules for installing packages from different archives are:
non-binary packages ("Architecture: all
") are safer to install.
documentation packages: no special requirements
interpreter program packages: compatible interpreter must be available
completely statically linked binary packages are safe to install.
binary packages (non "Architecture: all
") usually face many road blocks and unsafe to install.
![]() |
Note |
---|---|
Except to avoid broken package for a short term, installing binary packages from officially unsupported archives is generally bad idea. This is true even if you use apt-pinning (see Section 3.4.3, “Tweaking candidate version”). You should consider chroot or similar techniques (see Section 10.6, “The chroot”) to run programs from different archives. |
Without the /etc/apt/preferences
file, APT system choses the latest available version as the candidate version using the version string. This is the normal state and most recommended usage of APT system. All officially supported combinations of archives do not require the /etc/apt/preferences
file since some archives which should not be used as the automatic source of upgrades are marked as NotAutomatic and dealt properly.
![]() |
Tip |
---|---|
The version string comparison rule can be verified with, e.g., " |
When you install packages from mixed source of archives (see Section 3.4.2, “Packages from mixed source of archives”) regularly, you can automate these complicated operations by creating the /etc/apt/preferences
file with proper entries and tweaking the package selection rule for candidate version as described in apt_preferences
(5). This is called apt-pinning.
![]() |
Warning |
---|---|
Use of apt-pinning by a novice user is sure call for major troubles. You must avoid using apt-pinning except when you absolutely need it. |
![]() |
Caution |
---|---|
When using apt-pinning, you must ensure compatibility of packages by yourself since the Debian does not guarantee it. The apt-pinning is completely optional operation and its use is not something I encourage you to use. |
![]() |
Caution |
---|---|
Archive level Release files (see Section 3.2.3, “Archive level Release files”) are used for the rule of |
![]() |
Note |
---|---|
Even if you do not create the |
Here is a simplified explanation of apt-pinning technique. Each package has its Pin-Priority value based on the entries in the /etc/apt/preferences
file or the default values.
Table 3.20. List of essential default Pin-Priority values.
Pin-Priority |
description |
---|---|
990 |
default value for package from the target release archive |
500 |
default value for package from the normal archive |
100 |
default value for package from the installed package |
1 |
default value for package from the NotAutomatic archive |
APT system normally choses highest Pin-Priority upgrading package from the available resources defined in the /etc/apt/sources.list
file as the candidate version. This version restriction for upgrading is dropped to enable downgrading if the Pin-Priority of package is larger than 1000 (see Section 3.4.5, “Emergency downgrading”).
The target release can be set:
by /etc/apt/apt.conf
, e.g., "APT::Default-Release "stable";
" line in it, or
by "-t
" option argument, e.g., "apt-get install -t testing some-package
".
The archive level Release file (see Section 3.2.3, “Archive level Release files”) of NotAutomatic archive contains "NotAutomatic: yes
".
![]() |
Caution |
---|---|
Although cryptic to read, you should test Pin-Priority situation of your |
The Pin-Priority values of <package> from multiple sources are shown by the output of "apt-cache policy <package>
":
a line started with "Package pin:
" lists the package version of pin if association just with <package> is defined, e.g., "Package pin: 0.190
",
no line with "Package pin:
" exists if no association just with <package> is defined,
the Pin-Priority value associated just with <package> is listed right side of all version strings, e.g., "0.181 700
",
0 is listed right side of all version strings if no association just with <package> is defined, e.g., "0.181 0
", and
the Pin-Priority values of archives (defined as "Package: *
" in the /etc/apt/preferences
file) are listed left side of all archive paths, e.g., "200 http://backports.org etch-backports/main Packages
".
Here is an example of apt-pinning technique to include specific newer upstream version packages found in "unstable
" regularly upgraded while tracking "testing
". You list all required archives in the /etc/apt/sources.list
file as:
deb http://ftp.us.debian.org/debian/ testing main contrib non-free deb http://ftp.us.debian.org/debian/ unstable main contrib non-free deb http://security.debian.org/ testing/updates main contrib
and set the /etc/apt/preferences
file as:
Package: * Pin: release a=testing Pin-Priority: 500 Package: * Pin: release a=unstable Pin-Priority: 200
When you wish to install a package named "<package-name>
" with its dependencies from "unstable
" archive under this configuration, you issue the following command which switches target release with "-t
" option (Pin-Priority of "unstable
" becomes 990.):
$ sudo aptitude install -t unstable <package-name>
With this configuration, usual execution of "aptitude upgrade
" and "aptitude dist-upgrade
" will upgrade packages which were installed from "testing
" archive using current "testing
" archive and packages which were installed from "unstable
" archive using current "unstable
" archive.
![]() |
Caution |
---|---|
Be careful not to remove " |
![]() |
Tip |
---|---|
I usually edit the |
![]() |
Tip |
---|---|
If " |
If you wish to track particular packages in "unstable
" automatically without initial "-t unstable
" installation, you must create the /etc/apt/preferences
file and explicitly lists all those packages at the top of it as:
Package: <package-1> Pin: release a=unstable Pin-Priority: 700 Package: <package-2> Pin: release a=unstable Pin-Priority: 700 ...
These will set Pin-Priority value for each specific package. For example, in order to track the latest "unstable
" version of this "Debian Reference" in English, you should have following entries in the /etc/apt/preferences
file:
Package: debian-reference-en Pin: release a=unstable Pin-Priority: 700 Package: debian-reference-common Pin: release a=unstable Pin-Priority: 700
![]() |
Tip |
---|---|
This apt-pinning technique is valid even when you are tracking " |
Here is another example of apt-pinning technique to include specific newer upstream version packages found in "experimental
" while tracking "unstable
". You list all required archives in the /etc/apt/sources.list
file as:
deb http://ftp.us.debian.org/debian/ unstable main contrib non-free deb http://ftp.us.debian.org/debian/ experimental main contrib non-free deb http://security.debian.org/ testing/updates main contrib
The default Pin-Priority value for "experimental
" archive is always 1 since it is NotAutomatic archive (see Section 3.2.3, “Archive level Release files”). There is no need to set Pin-Priority value in the /etc/apt/preferences
file to use experimental archive unless you wish to track particular packages automatically.
There are The debian-volatile Project and http://backports.org archives which provide updgrade packages for "stable
".
![]() |
Warning |
---|---|
Do not use all packages available in the NotAutomatic archives such as " |
![]() |
Caution |
---|---|
http://backports.org is a non-Debian archive, although its packages are signed by Debian developers. |
![]() |
Caution |
---|---|
Archive level Release files (see Section 3.2.3, “Archive level Release files”) are used for the rule of |
Here is an example of apt-pinning technique to include specific newer upstream version packages found in "etch-backports
" while tracking "etch
" and "volatile
". You list all required archives in the /etc/apt/sources.list
file as:
deb http://ftp.us.debian.org/debian/ etch main contrib non-free deb http://security.debian.org/ etch/updates main contrib deb http://volatile.debian.org/debian-volatile/ etch/volatile main contrib non-free deb http://volatile.debian.org/debian-volatile/ etch/volatile-sloppy main contrib non-free deb http://backports.org/debian/ etch-backports main contrib non-free
The default Pin-Priority value for http://backports.org archive and "volatile-sloppy
" are always 1 since they are NotAutomatic archive (see Section 3.2.3, “Archive level Release files”). There is no need to set Pin-Priority value explicitly in the /etc/apt/preferences
file just to use for http://backports.org and "volatile-sloppy
" archive unless you wish to track packages automatically for next upgrading.
So whenever you wish to install a package named "<package-name>
" with its dependency from "etch-backports
" archive, you use following command while switching target release with "-t
" option:
$ sudo aptitude install -t etch-backports <package-name>
If you wish to upgrade particular packages, you must create the /etc/apt/preferences
file and explicitly lists all packages in it as:
Package: <package-1> Pin: release o=Backports.org archive Pin-Priority: 700 Package: <package-2> Pin: release o=volatile.debian.org Pin-Priority: 700 ...
Alternatively, with the /etc/apt/preferences
file as:
Package: * Pin: release a=stable , o=Debian Pin-Priority: 500 Package: * Pin: release a=etch, o=volatile.debian.org Pin-Priority: 500 Package: * Pin: release a=etch-backports, o=Backports.org archive Pin-Priority: 200 Package: * Pin: release a=etch-sloppy, o=volatile.debian.org Pin-Priority: 200
execution of "aptitude upgrade
" and "aptitude dist-upgrade
" will upgrade packages which were installed from "stable
" archive using current "stable
" archive and packages which were installed from other archives using current corresponding archive for all archives in the /etc/apt/sources.list
file.
![]() |
Caution |
---|---|
Downgrading is not officially supported by the Debian by design. It should be done only as a part of emergency recovery process. Despite of this situation, it is known to work well in many incidents. For critical systems, You should backup all important data on the system after the recovery operation and re-install the new system from the scratch. |
You may be lucky to downgrade from newer archive to older archive to recover from broken system upgrade. This is lazy alternative to tedious actions of many "dpkg -i <broken-package>_<old-version>.deb
" commands (see Section 3.3.4, “Rescue using the dpkg command”).
For downgrading system tracking "unstable
" to "testing
", change the /etc/apt/sources.list
file from:
deb http://ftp.us.debian.org/debian/ sid main contrib non-free
to:
deb http://ftp.us.debian.org/debian/ lenny main contrib
and set the /etc/apt/preferences
file as:
Package: * Pin: release a=testing Pin-Priority: 1010
Then run "aptitude dist-upgrade
" to force downgrading of packages across the system. You should remove this special /etc/apt/preferences
file after the downgrading.
Although the maintainer name listed in /var/lib/dpkg/available
and /usr/share/doc/package_name/changelog
provide some information on "who is behind the packaging activity", the actual uploader of the package is somewhat obscure. The who-uploads
(1) in devscripts
package identifies the actual uploader of Debian source packages.
If you are to compile a program from source to replace the Debian package, it is best to make it into a real local debianized package (*.deb
) and use private archive.
If you chose to compile a program from source and to install them under /usr/local
instead, you may need to use equivs
as a last resort to satisfy the missing package dependency.
Package: equivs Priority: extra Section: admin Description: Circumventing Debian package dependencies This is a dummy package which can be used to create Debian packages, which only contain dependency information.
For partial upgrades of the "stable
" system, rebuilding a package within its environment using the source package is desirable. This avoids massive package upgrades due to their dependencies. First, add the following entries to the /etc/apt/sources.list
of a "stable
" system:
deb-src http://http.us.debian.org/debian unstable main contrib non-free
Then get the required packages and the source to be downloaded and compiled by:
# aptitude update # aptitude dist-upgrade # aptitude install fakeroot devscripts build-essential # apt-get build-dep foo # apt-get source -b foo
Here is an example for creating a small public package archive compatible with the modern secure APT system (see Section 3.2.2, “Top level Release file and authenticity”). Let's assume few things:
Account name: foo
Host name: www.example.com
Required packages: apt-utils
, gnupg
, and other packages.
URL: http://www.example.com/~foo/
displays /home/foo/public_html/index.html
Architecture of packages: amd64
One time setup of APT archive on your server system:
Create Foo's archive key on server system:
$ ssh foo@www.example.com $ gpg --gen-key ... $ gpg -K ... sec 1024D/3A3CB5A6 2008-08-14 uid Foo Bar (ARCHIVE KEY) <foo@www.example.com> ssb 2048g/6856F4A7 2008-08-14 $ gpg --export -a 3A3CB5A6 >foo.public.key
New Foo's archive key is 3A3CB5A6
Publish foo.public.key
file.
Create Foo's archive skeleton:
$ umask 022 $ mkdir -p ~/public_html/debian/pool/main $ mkdir -p ~/public_html/debian/dists/unstable/main/binary-amd64 $ mkdir -p ~/public_html/debian/dists/unstable/main/source $ cd ~/public_html/debian $ cat > dists/unstable/main/binary-amd64/Release << EOF Archive: unstable Version: 4.0 Component: main Origin: Foo Label: Foo Architecture: amd64 EOF $ cat > dists/unstable/main/source/Release << EOF Archive: unstable Version: 4.0 Component: main Origin: Foo Label: Foo Architecture: source EOF $ cat >aptftp.conf <<EOF APT::FTPArchive::Release { Origin "Foo"; Label "Foo"; Suite "unstable"; Codename "sid"; Architectures "amd64"; Components "main"; Description "Foo's public archive"; }; EOF $ cat >aptgenerate.conf <<EOF Dir::ArchiveDir "."; Dir::CacheDir "."; TreeDefault::Directory "pool/"; TreeDefault::SrcDirectory "pool/"; Default::Packages::Extensions ".deb"; Default::Packages::Compress ". gzip bzip2"; Default::Sources::Compress "gzip bzip2"; Default::Contents::Compress "gzip bzip2"; BinDirectory "dists/unstable/main/binary-amd64" { Packages "dists/unstable/main/binary-amd64/Packages"; Contents "dists/unstable/Contents-amd64"; SrcPackages "dists/unstable/main/source/Sources"; }; Tree "dists/unstable" { Sections "main"; Architectures "amd64 source"; }; EOF
Repetitive update of APT archive contents on your server system:
Place all package files into ~foo/public_html/debian/pool/main/
by executing "dupload -t foo changes_file
" in client while having ~/.dupload.conf
containing:
$cfg{'foo'} = { fqdn => "www.example.com", method => "scpb", incoming => "/home/foo/public_html/debian/pool/main", # The dinstall on ftp-master sends emails itself dinstall_runs => 1, }; $cfg{'foo'}{postupload}{'changes'} = " echo 'cd public_html/debian ; apt-ftparchive generate -c=aptftp.conf aptgenerate.conf; apt-ftparchive release -c=aptftp.conf dists/unstable >dists/unstable/Release ; rm -f dists/unstable/Release.gpg ; gpg -u 3A3CB5A6 -bao dists/unstable/Release.gpg dists/unstable/Release'| ssh foo@www.example.com 2>/dev/null ; echo 'Package archive created!'";
The postupload hook script initiated by dupload
(1) creates updated archive files for each upload.
You can add this small public archive to the apt-line of your client system:
$ sudo bash # echo "deb http://www.example.com/~foo/debian/ unstable main" \ >> /etc/apt/sources.list # apt-key add foo.public.key
![]() |
Tip |
---|---|
If the archive is located on the local file system, you can use " |
To make a local copy of the package and debconf selection states:
# dpkg --get-selections '*' > selection.dpkg # debconf-get-selections > selection.debconf
Here, '*' makes selection.dpkg
to include package entries for "purge" too.
You can transfer these 2 files to another computer, and install there with:
# dselect update # debconf-set-selections < myselection.debconf # dpkg --set-selections < myselection.dpkg # apt-get -u dselect-upgrade # or dselect install
If you are thinking about managing many cluster of servers with practically the same configuration, you should consider to use specialized package such as fai
to manage the whole system.
The alien
command enables the conversion of binary packages provided in Red Hat rpm
, Stampede slp
, Slackware tgz
, and Solaris pkg
file formats into a Debian deb
package. If you want to use a package from another Linux distribution than the one you have installed on your system, you can use alien
to convert it to your preferred package format and install it. alien
also supports LSB packages.
The original package needs to be statically linked or its library dependency needs to be satisfied manually. So use this command with great care.
The current .deb
package contents can be extracted without using the dpkg
command on any unix-like environment using standard ar
and tar
commands.
# ar x /path/to/dpkg_<version>_<arch>.deb # ls total 24 -rw-r--r-- 1 osamu osamu 1320 2007-05-07 00:11 control.tar.gz -rw-r--r-- 1 osamu osamu 12837 2007-05-07 00:11 data.tar.gz -rw-r--r-- 1 osamu osamu 4 2007-05-07 00:11 debian-binary # mkdir control # mkdir data # tar xvzf control.tar.gz -C control # tar xvzf data.tar.gz -C data
You can also browse package content using the mc
command.
You should read:
manpages for aptitude
(8), "dpkg
", "man 8 tasksel
", "man 8 apt-get
", "man 8 apt-config
", "man 8 apt-key
", "man 5 sources.list
", "man 5 apt.conf
", and "man 5 apt_preferences
";
"/usr/share/doc/apt-doc/guide.html/index.html
" and "/usr/share/doc/apt-doc/offline.html/index.html
" from the apt-doc
package;
Read /usr/share/doc/aptitude/html/en/index.html
from the aptitude-doc-en
package.
The official and detailed secondary information on the Debian archive are given by:
The tutorial for building of a Debian package for the common Debian user is given by: