aptitude(8)
| APTITUDE(8) | Command-Line Reference | APTITUDE(8) |
NAME
aptitude - high-level interface to the package manager
SYNOPSIS
aptitude [<options>...] {autoclean | clean | forget-new | keep-all | update | safe-upgrade}
aptitude [<options>...] {changelog | full-upgrade | download | forbid-version | hold | install | keep-all | markauto | purge | reinstall | remove | show | unhold | unmarkauto} <packages>...
aptitude [<options>...] search <patterns>...
aptitude [-S <fname>] [-i]
aptitude help
DESCRIPTION
aptitude is a text-based interface to the Debian GNU/Linux package system.
It allows the user to view the list of packages and to perform package management tasks such as installing, upgrading, and removing packages. Actions may be performed from a visual interface or from the command-line.
COMMAND-LINE ACTIONS
The first argument which does not begin with a hyphen (“-”) is considered to be an action that the program should perform. If an action is not specified on the command-line, aptitude will start up in visual mode.
The following actions are available:
install
To select a particular version of the package, append “=version” to the package name: for instance, “aptitude install apt=0.3.1”. Similarly, to select a package from a particular archive, append “/archive” to the package name: for instance, “aptitude install apt/experimental”.
Not every package listed on the command line has to be installed; you can tell aptitude to do something different with a package by appending an “override specifier” to the name of the package. For example, aptitude remove wesnoth+ will install wesnoth, not remove it. The following override specifiers are available:
<package>+
<package>+M
<package>-
<package>_
<package>=
<package>:
<package>&M
<package>&m
As a special case, “install” with no arguments will act on any stored/pending actions.
Note
Once you enter Y at the final confirmation prompt, the “install” command will modify aptitude's stored information about what actions to perform. Therefore, if you issue (e.g.) the command “aptitude install foo bar” and then abort the installation once aptitude has started downloading and installing packages, you will need to run “aptitude remove foo bar” to cancel that order.
remove, purge, hold, unhold, keep, reinstall
For instance, “aptitude remove '~ndeity'” will remove all packages whose name contains “deity”.
markauto, unmarkauto
For more information on automatically installed packages, see the section “Managing Automatically Installed Packages” in the aptitude reference manual.
forbid-version
This command is useful for avoiding broken versions of packages without having to set and clear manual holds. If you decide you really want the forbidden version after all, the “install” command will remove the ban.
update
safe-upgrade
It is sometimes necessary to remove or install one package in order to upgrade another; this command is not able to upgrade packages in such situations. Use the full-upgrade command to upgrade as many packages as possible.
full-upgrade
Note
This command was originally named dist-upgrade for historical reasons, and aptitude still recognizes dist-upgrade as a synonym for full-upgrade.
keep-all
forget-new
search
Unless you pass the -F option, the output of aptitude search will look something like this:
i apt - Advanced front-end for dpkg pi apt-build - frontend to apt to build, optimize and in cp apt-file - APT package searching utility -- command- ihA raptor-utils - Raptor RDF Parser utilities
Each search result is listed on a separate line. The first character of each line indicates the current state of the package: the most common states are p, meaning that no trace of the package exists on the system, c, meaning that the package was deleted but its configuration files remain on the system, i, meaning that the package is installed, and v, meaning that the package is virtual. The second character indicates the stored action (if any; otherwise a blank space is displayed) to be performed on the package, with the most common actions being i, meaning that the package will be installed, d, meaning that the package will be deleted, and p, meaning that the package and its configuration files will be removed. If the third character is A, the package was automatically installed.
For a complete list of the possible state and action flags, see the section “Accessing Package Information” in the aptitude reference guide.
show
If the verbosity level is 1 or greater (i.e., at least one -v is present on the command-line), information about all versions of the package is displayed. Otherwise, information about the “candidate version” (the version that “aptitude install” would download) is displayed.
You can display information about a different version of the package by appending =version to the package name; you can display the version from a particular archive by appending /archive to the package name. If either of these is present, then only the version you request will be displayed, regardless of the verbosity level.
If the verbosity level is 1 or greater, the package's architecture, compressed size, filename, and md5sum fields will be displayed. If the verbosity level is 2 or greater, the select version or versions will be displayed once for each archive in which they are found.
clean
autoclean
changelog
By default, the changelog for the version which would be installed with “aptitude install” is downloaded. You can select a particular version of a package by appending =version to the package name; you can select the version from a particular archive by appending /archive to the package name.
download
By default, the version which would be installed with “aptitude install” is downloaded. You can select a particular version of a package by appending =version to the package name; you can select the version from a particular archive by appending /archive to the package name.
help
OPTIONS
The following options may be used to modify the behavior of the actions described above. Note that while all options will be accepted for all commands, some options don't apply to particular commands and will be ignored by those commands.
-D, --show-deps
This corresponds to the configuration option Aptitude::CmdLine::Show-Deps.
-d, --download-only
This corresponds to the configuration option Aptitude::CmdLine::Download-Only.
-F <format>, --display-format <format>
This corresponds to the configuration option Aptitude::CmdLine::Package-Display-Format.
-f
This corresponds to the configuration item Aptitude::CmdLine::Fix-Broken.
-h, --help
--purge-unused
-P, --prompt
This corresponds to the configuration option Aptitude::CmdLine::Always-Prompt.
-R, --without-recommends
This corresponds to the pair of configuration options Aptitude::Recommends-Important and Aptitude::Keep-Recommends.
-r, --with-recommends
This corresponds to the configuration option Aptitude::Recommends-Important
-s, --simulate
This corresponds to the configuration option Aptitude::Simulate.
--schedule-only
For instance, aptitude --schedule-only install evolution will schedule the evolution package for later installation.
-t <release>, --target-release <release>
This corresponds to the configuration item APT::Default-Release.
-O <order>, --sort <order>
-o <key>=<value>
-q=n, --quiet=n
The optional =n may be used to directly set the amount of quietness (for instance, to override a setting in /etc/apt/apt.conf); it causes the program to behave as if -q had been passed exactly <n> times.
-V, --show-versions
This corresponds to the configuration option Aptitude::CmdLine::Show-Versions.
-v, --verbose
This corresponds to the configuration option Aptitude::CmdLine::Verbose.
--version
--visual-preview
-w <width>, --width <width>
This corresponds to the configuration option Aptitude::CmdLine::Package-Display-Width
-y, --assume-yes
This corresponds to the configuration option Aptitude::CmdLine::Assume-Yes.
-Z
This corresponds to the configuration option Aptitude::CmdLine::Show-Size-Changes.
The following options apply to the visual mode of the program, but are primarily for internal use; you generally won't need to use them yourself.
-S <fname>
-i
ENVIRONMENT
HOME
PAGER
TMP
TMPDIR
SEE ALSO
apt-get(8), apt(8), /usr/share/doc/aptitude/html/<lang>/index.html from the package aptitude-doc-<lang>
AUTHOR
Daniel Burrows <dburrows@debian.org>
COPYRIGHT
This manual page is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This manual page is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
| 07/25/2023 | [FIXME: source] |
