-v --verbose
Causes some commands (for instance, show) to display extra information. multiple times increases verbosity.
Aptitude::CmdLine::Verbose.
--visual-preview
When installing or removing packages from the command line, start the visual interface and display preview screen.
| --add-user-tag tag
For full-upgrade, safe-upgrade, forbid-version, hold, install, keep-all, markauto, unmarkauto, purge, reinstall, remove,
unhold, and unmarkauto : add the user tag tag to all packages that are installed, removed, or
upgraded by this command as if with the add-user-tag command.
| --add-user-tag-to tag,pattern
For full-upgrade, safe-upgrade, forbid-version, hold, install, keep-all, markauto, unmarkauto, purge, reinstall, remove,
unhold, and unmarkauto : add tag to all packages that match pattern as if with add-user-tag .
pattern is a search pattern
For instance, aptitude safe-upgrade --add-user-tag-to new-installs,?action(install) will
add the tag new-installs to all the packages installed by safe-upgrade .
| --allow-new-upgrades
When the safe resolver is being used (i.e. --safe-resolver was passed, the action is safe-upgrade , or
Aptitude::Always-Use-Safe-Resolver is true),
allow the dependency resolver to install upgrades for packages regardless
of the value of Aptitude::Safe-Resolver::No-New-Upgrades.
| --allow-new-installs
Allow safe-upgrade to install new packages; when the safe resolver is being used (i.e.--safe-resolver was
passed, the action is safe-upgrade or Aptitude::Always-Use-Safe-Resolver is true),
allow the dependency resolver to
install new packages. This takes effect regardless of Aptitude::Safe-Resolver::No-New-Installs .
| --allow-untrusted
Install packages from untrusted sources without prompting. Only use this if you know what you are doing, as it
could easily compromise your system's security.
| --disable-columns
Causes search and versions to output results without formatting. In
particular: whitespace is added or search results are truncated to fit its results into vertical
"columns".
Each line will be formed by replacing format escapes in the format with the corresponding text; column widths will be ignored.
For instance, the first few lines of output from
aptitude search -F '%p %V' --disable-columns libedataserver
might be:
disksearch 1.2.1-3
hp-search-mac 0.1.3
libbsearch-ruby 1.5-5
libbsearch-ruby1.8 1.5-5
libclass-dbi-abstractsearch-perl 0.07-2
libdbix-fulltextsearch-perl 0.73-10
--disable-columns is useful in combination with a custom display format set with
-F .
code>Aptitude::CmdLine::Disable-Columns.
| -D --show-deps
For commands that install or remove packages (install, full-upgrade, … ),
show brief explanations of automatic installations and removals.
code>Aptitude::CmdLine::Show-Deps.
| -d --download-only
Download packages to the package cache, but do not install or remove anything. By default, the package cache is
/var/cache/apt/archives.
Aptitude::CmdLine::Download-Only.
-F format --display-format format
For search and versions .
For instance, %p %v %V
displays package name, its installed version and its candidate version (see
Customizing how packages are displayed
The command-line --disable-columns is useful with -F .
For search,
Aptitude::CmdLine::Package-Display-Format ;
For versions, Aptitude::CmdLine::Version-Display-Format.
-f
Fix the dependencies of broken packages, even if it means ignoring the actions requested on the command line.
Aptitude::CmdLine::Fix-Broken.
--full-resolver
When package dependency problems are encountered, use the default "full" resolver.
Unlike the "safe" resolver activated by --safe-resolver , the full resolver will remove packages to fulfill dependencies. It can resolve more
situations than the safe algorithm, but its solutions are more likely to be undesirable.
Force the use of the full resolver with Aptitude::Always-Use-Safe-Resolver
--group-by grouping-mode
Control how the versions command groups output
archive to group packages by the archive they occur in ("stable", "unstable", etc). If a package occurs in several
archives, it will be displayed in each of them.
| auto by their package unless there is exactly one argument and it is not a search pattern.
| package by their package.
| source-package by their source package.
| source-version by their source package and source version.
| none a single list
| | | | | | |
Aptitude::CmdLine::Versions-Group-By.
--log-file=[-]file
if file> is "-", the messages will be written to standard output
This does not affect the log of installations that aptitude has performed (/var/log/aptitude); the log messages written using
this configuration include internal program events, errors, and debugging messages. See the command-line option --log-level
to get more control over what gets logged.
Aptitude::Logging::File.
--log-level=level
--log-level=category:level
only log messages whose level is level or higher. For instance, setting the log
level to error will cause only messages at the log levels error and fatal to be displayed; all others will be hidden.
off, fatal, error, warn, info, debug, and trace . The default warn .
| --log-level=category:level Messages in category to be logged if their level is level or higher.
May appear multiple times; the most specifi and last setting takes effect,
Does not affect the log of installations that aptitude has performed (/var/log/aptitude); the log messages written using
this configuration include internal program events, errors, and debugging messages. See --log-file
Aptitude::Logging::Levels.
--log-resolver
Set log levels to produce logging output for processing.
Equivalent to --log-level=aptitude.resolver.search:trace
--log-level=aptitude.resolver.search.tiers:info.
--no-new-installs
Prevent safe-upgrade from installing new packages
when the safe resolver is being used (i.e., --safe-resolver was passed
or Aptitude::Always-Use-Safe-Resolver is set to true),
forbid the dependency resolver from installing new packages.
takes effect regardless of the value of .
mimics apt-get upgrade.
--no-new-upgrades
When the safe resolver is being used …
Do NOT install upgrades regardless of Aptitude::Safe-Resolver::No-New-Upgrades.
| --no-show-resolver-actions
Do not display the actions performed by the "safe" resolver, overriding configuration or
--show-resolver-actions.
-O order
--sort order
order output is displayed. For instance, passing
installsize lists packages according to size when installed (see"Customizing
how packages are sorted"
Prepending the order keyword
The default sort order is name,version.
| -o key=value
Set a configuration option ; example:, -o Aptitude::=/tmp/my-log
See Configuration
| -P --prompt
Always display a prompt before downloading, installing or removing packages,
Aptitude::CmdLine::Always-Prompt.
| --purge-unused
If Aptitude::Delete-Unused is "true" (default),
also purge them, removing configuration files and other
data. see "Managing Automatically Installed Packages"
CAN CAUSE DATA LOSS!
Aptitude::Purge-Unused.
| -q[=n] --quiet[=n]
Suppress progress indicators
Multiple times makes the program quieter,
n sets the amount of quietness
/etc/apt/apt.conf ; causes the program to behave as if -q had been passed n times.
| -R --without-recommends
Do not treat recommendations as dependencies when installing new packages (overrides /etc/apt/apt.conf and
~/.aptitude/config.
Packages previously installed due to recommendations will not be removed.
APT::Install-Recommends and APT::AutoRemove::RecommendsImportant.
| -r --with-recommends
Treat recommendations as dependencies hen installing new packages (overrides /etc/apt/apt.conf and
~/.aptitude/config ).
APT::Install-Recommends
| --remove-user-tag tag
For full-upgrade, safe-upgrade forbid-version, hold, install, keep-all, markauto, unmarkauto, purge, reinstall, remove,
unhold, and unmarkauto :
remove the user tag from packages that are installed, removed, or upgraded
as if with the add-user-tag
--remove-user-tag-from tag ,pattern
For full-upgrade, … (as with --remove-user-tag ) :from packages that match
pattern described in the "Search Patterns" in the aptitude reference manual.
For instance, aptitude safe-upgrade --remove-user-tag-from "not-upgraded,?action(upgrade)" removes
the not-upgraded tag from packages that safe-upgrade is able to upgrade.
| -s --simulate
don't perform actions display what would be poerformed .
Does not require root privileges.
In the visual interface, open cache in read-only mode.
Aptitude::Simulate.
--safe-resolver
When package dependency problems are encountered, use a "safe" algorithm to solve them.
This resolver attempts to preserve as
many choices as possible;
it will not remove a package or install a version other than the package's
default candidate version.
It is the same algorithm used in safe-upgrade; aptitude --safe-resolver full-upgrade
Aptitude::Always-Use-Safe-Resolver true.
--schedule-only
For commands that modify package states, schedule operations to be performed.
Execute scheduled actions by running aptitude install with no arguments.
Equivalent to making the corresponding selections in visual mode, then exiting.
Example: aptitude --schedule-only install evolution
| --show-package-names when
Controls when the versions command shows package names.
always
| auto if the output is not grouped by package, and there is a
pattern-matching argument or more than one argument.
| never
| | | |
Aptitude::CmdLine::Versions-Show-Package-Names.
--show-resolver-actions
Display actions performed by "safe" resolver and safe-upgrade.
Displays a summary of the actions performed by the resolver before oputputing the preview.
Aptitude::Safe-Resolver::Show-Resolver-Actions.
--show-summary [=mode]
"aptitude why" summarizes dependency chain
With mode> is not "no-summary", chains that contain Suggests dependencies will not be
displayed: combine --show-summary with -v to see a summary of all the reasons for the target package to be installed.
no-summary don't show a summary (the default behavior if --show-summary is not present).
| first-package display the first package in each chain. This is the default value of MODE> if it is not present.
| first-package-and-type display the first package in each chain, along with the strength of the weakest dependency in the
chain.
| all-packages briefly display each chain of dependencies leading to the target package.
|
all-packages-with-dep-versions briefly display each chain of dependencies leading to the target package, including the
target version of each dependency.
| | | | | |
Aptitude::CmdLine::Show-Summary ; if --show-summary is present on the command-line,
Example 12. Usage of --show-summary --show-summary used with -v to display all the reasons a package is installed:
$ aptitude -v --show-summary why foomatic-db
Packages requiring foomatic-db:
cupsys-driver-gutenprint
foomatic-db-engine
foomatic-db-gutenprint
foomatic-db-hpijs
foomatic-filters-ppds
foomatic-gui
kde
printconf
wine
$ aptitude -v --show-summary=first-package-and-type why foomatic-db
Packages requiring foomatic-db:
[Depends] cupsys-driver-gutenprint
[Depends] foomatic-db-engine
[Depends] foomatic-db-gutenprint
[Depends] foomatic-db-hpijs
[Depends] foomatic-filters-ppds
[Depends] foomatic-gui
[Depends] kde
[Depends] printconf
[Depends] wine
$ aptitude -v --show-summary=all-packages why foomatic-db
Packages requiring foomatic-db:
cupsys-driver-gutenprint D: cups-driver-gutenprint D: cups R: foomatic-filters R: foomatic-db-engine D: foomatic-db
foomatic-filters-ppds D: foomatic-filters R: foomatic-db-engine D: foomatic-db
kde D: kdeadmin R: system-config-printer-kde D: system-config-printer R: hal-cups-utils D: cups R: foomatic-filters R: foomatic-db-engine D: foomatic-db
wine D: libwine-print D: cups-bsd R: cups R: foomatic-filters R: foomatic-db-engine D: foomatic-db
foomatic-db-engine D: foomatic-db
foomatic-db-gutenprint D: foomatic-db
foomatic-db-hpijs D: foomatic-db
foomatic-gui D: python-foomatic D: foomatic-db-engine D: foomatic-db
printconf D: foomatic-db
$ aptitude -v --show-summary=all-packages-with-dep-versions why foomatic-db
Packages requiring foomatic-db:
cupsys-driver-gutenprint D: cups-driver-gutenprint (>= 5.0.2-4) D: cups (>= 1.3.0) R: foomatic-filters (>= 4.0) R: foomatic-db-engine (>= 4.0) D: foomatic-db (>= 20090301)
foomatic-filters-ppds D: foomatic-filters R: foomatic-db-engine (>= 4.0) D: foomatic-db (>= 20090301)
kde D: kdeadmin (>= 4:3.5.5) R: system-config-printer-kde (>= 4:4.2.2-1) D: system-config-printer (>= 1.0.0) R: hal-cups-utils D: cups R: foomatic-filters (>= 4.0) R: foomatic-db-engine (>= 4.0) D: foomatic-db (>= 20090301)
wine D: libwine-print (= 1.1.15-1) D: cups-bsd R: cups R: foomatic-filters (>= 4.0) R: foomatic-db-engine (>= 4.0) D: foomatic-db (>= 20090301)
foomatic-db-engine D: foomatic-db
foomatic-db-gutenprint D: foomatic-db
foomatic-db-hpijs D: foomatic-db
foomatic-gui D: python-foomatic (>= 0.7.9.2) D: foomatic-db-engine D: foomatic-db (>= 20090301)
printconf D: foomatic-db
--show-summary used to list a chain on one line:
$ aptitude --show-summary=all-packages why aptitude-gtk libglib2.0-data
Packages requiring libglib2.0-data:
aptitude-gtk D: libglib2.0-0 R: libglib2.0-data
-t release --target-release release>
Set the release
For instance, "aptitude -t experimental ..." will install packages from the experimental distribution
Affects the default candidate version according to the rules described in apt_preferences(5).
APT::Default-Release.
-W --show-why
In the preview displayed before packages are installed or removed, show which manually installed package requires each
automatically installed package. For instance:
$ aptitude --show-why install mediawiki
…
The following NEW packages will be installed:
libapache2-mod-php5{a} (for mediawiki) mediawiki php5{a} (for mediawiki)
php5-cli{a} (for mediawiki) php5-common{a} (for mediawiki)
php5-mysql{a} (for mediawiki)
With -verbose or a non-zero value for Aptitude::CmdLine::Verbose , displays the entire chain of dependencies that
lead each package to be installed.
Describes why packages are being removed, .
In this example, libdb4.2-dev conflicts with libdb-dev , which is provided by llibdb-dev.
$ aptitude -v --show-why install libdb4.2-dev
The following NEW packages will be installed:
libdb4.2{a} (libdb4.2-dev D: libdb4.2) libdb4.2-dev
The following packages will be REMOVED:
libdb4.4-dev{a} (libdb4.2-dev C: libdb-dev P- libdb-dev)
Aptitude::CmdLine::Show-Why
| -w width --width width
display width used for output from the search and versions (in the command line).M
By default and with a terminal, the terminal width is used.
When output is redirected "unlimited" line width is used,
Aptitude::CmdLine::Package-Display-Width
-y --assume-yes
Suppresses the prompt when installing, upgrading, or removing packages.
Always prompts for dangerous actions, such as removing essential packages, overrides -P .
Aptitude::CmdLine::Assume-Yes.
-Z Displays disk space to be used .
| -h --help Display a help
| --version
| -V --show-versions Aptitude::CmdLine::Show-Versions.
code>Aptitude::CmdLine::Show-Size-Changes.
--autoclean-on-startup Deletes downloaded files when starting.
Conflicts with "--clean-on-startup", "-i", or "-u" at the same time.
| --clean-on-startup Cleans the package cache when starting.
Conflicts with "--autoclean-on-startup", "-i", or "-u"
| -i
Displays a download preview when starting (equivalent to starting the program and immediately pressing "g").
Conflicts with "--autoclean-on-startup", "--clean-on-startup", or "-u"
| -S fname
Loads the extended state information from fname
| -u
Begins updating the package lists when starting.
Conflicts with "--autoclean-on-startup", "--clean-on-startup", or "-i" at the same time.
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |