aptitude
の設定ファイルの基本形は、オプションとその値のリストです。ファイルの各行は、「オプション
値
;
」という形式になっているべきです。例えば、設定ファイルの次の行はオプション
Aptitude::Theme
を「Dselect
」と設定します。
Aptitude::Theme "Dselect";
オプションに別のオプションを「含める」ことも可能です。そうするには、次のように、オプションとその後のセミコロンとの間に中括弧を入れ、その中に別のオプションを書いてください。
Aptitude::UI { Package-Status-Format ""; Package-Display-Format ""; };
別のオプションを含んだオプションをグループと呼ぶことがあります。実は、オプション名に現れる二重コロンは、本当はオプションの包含関係の省略表現です。つまり、オプション
Aptitude::UI::Default-Grouping
はグループ
Aptitude::UI
に含まれており、Aptitude::UI
自体もグループ Aptitude
に含まれています。したがって、もしお望みであれば、このオプション
Aptitude::UI::Default-Grouping
は次のようにして
""
に設定できます。
Aptitude { UI { Default-Grouping ""; }; };
設定ファイルの書式についてさらに詳しく知りたければ、マニュアルページ apt.conf(5) を参照してください。
aptitude の設定は以下のソースから順に読まれます。
Configuration file options specified on the command-line.
ユーザの設定ファイル ~/.aptitude/config
。このファイルは、ユーザが「オプション」メニューの設定に変更を加えたときに上書きされます。
システムの設定ファイル /etc/apt/apt.conf
。
The system configuration fragment files,
/etc/apt/apt.conf.d/*
.
The file specified by the APT_CONFIG
environment variable
(if any).
/usr/share/aptitude/aptitude-defaults
内に格納されているデフォルト値。
Default values built into aptitude.
オプションを調べるときにこれらのソースは順に検索され、そのオプションに対して値を与えるソースのうち最初に見つかったものが使用されます。例えば、あるオプションを
/etc/apt/apt.conf
に設定すると、aptitude
のそのオプションのデフォルト値は上書きされますが、~/.aptitude/config
のユーザ設定は上書きされません。
The following configuration options are used by aptitude. Note that these
are not the only available configuration options; options used by the
underlying apt
system are not listed here. See the manual pages
apt(8)
and
apt.conf(5)
for information on apt
options.
APT::AutoRemove::RecommendsImportant
true
true
, then aptitude will not consider
packages to be unused (and thus will not automatically remove them) as long
as any installed package recommends them, even if APT::Install-Recommends
is false
. For more information, see 「自動的にインストールされたパッケージの管理」.
APT::AutoRemove::SuggestsImportant
true
true
, then aptitude will not consider
packages to be unused (and thus will not automatically remove them) as long
as any installed package suggests them. For more information, see 「自動的にインストールされたパッケージの管理」.
APT::Get::List-Cleanup
true
APT::List-Cleanup
. If
either of these options is set to false
, aptitude will
not delete old package list files after downloading a new set of package
lists.
APT::List-Cleanup
true
APT::Get::List-Cleanup
.
If either of these options is set to false
, aptitude
will not delete old package list files after downloading a new set of
package lists.
APT::Install-Recommends
true
true
and
Aptitude::Auto-Install
is true
, then
whenever you mark a package for installation, aptitude will also mark the
packages it recommends for installation. Furthermore, if this option is
true
, aptitude will not consider packages to be unused
(and thus will not automatically remove them) as long as any installed
package reommends them. For more information, see 「自動的にインストールされたパッケージの管理」 and 「Immediate dependency resolution」.
Aptitude::Allow-Null-Upgrade
false
true
, aptitude will continue to the
preview screen whenever there are upgradable packages, rather than
displaying a reminder about the → (U) command.
Aptitude::Always-Use-Safe-Resolver
false
true
, aptitude's command-line actions
will always use a 「safe」 dependency resolver, as if --safe-resolver
had
been passed on the command line.
Aptitude::Autoclean-After-Update
false
true
, aptitude will clean up obsolete
files (see ) every
time you update the package list. This option is similar to → Aptitude::Clean-After-Install
.
Aptitude::Auto-Fix-Broken
true
false
, aptitude will ask for
permission before attempting to fix any broken packages.
Aptitude::Auto-Install
true
true
, aptitude will automatically
attempt to fulfill the dependencies of a package when you mark a package to
be installed or upgraded.
Aptitude::Auto-Install-Remove-Ok
false
true
, aptitude will automatically
remove conflicting packages when you mark a package to be installed or
upgraded. Normally these conflicts are flagged and you must handle them
manually.
Aptitude::Auto-Upgrade
false
true
, aptitude will automatically
flag all upgradable packages for upgrade when the program starts, as if you
had issued the command U).
→ (Aptitude::Clean-After-Install
false
true
, aptitude will clean up all
files in the package cache directory (see ) after successful installation of
packages (or similar operations). This option is similar to → Aptitude::Autoclean-After-Update
.
Aptitude::CmdLine::Always-Prompt
false
-P
command-line
option.
Aptitude::CmdLine::Assume-Yes
false
true
, aptitude
will act as if the user had answered 「yes」 to every prompt,
causing most prompts to be skipped. This is equivalent to the
-y
command-line option.
Aptitude::CmdLine::Disable-Columns
false
aptitude search
) will not be formatted into
fixed-width columns or truncated to the screen width. This is equivalent to
the --disable-columns
command-line option.
Aptitude::CmdLine::Download-Only
false
true
, aptitude
will download package files but not install them. This is equivalent to the
-d
command-line option.
Aptitude::CmdLine::Fix-Broken
false
true
, aptitude
will be more aggressive when attempting to fix the dependencies of broken
packages. This is equivalent to the -f
command-line
option.
Aptitude::CmdLine::Versions-Group-By
auto
, none
,
package
, or source-package
to control
whether and how the output of aptitude versions
is
grouped. Equivalent to the command-line option --group-by
(see its
documentation for more description of what the values mean).
Aptitude::CmdLine::Ignore-Trust-Violations
false
APT::Get::AllowUnauthenticated
.
Aptitude::CmdLine::Package-Display-Format
%c%a%M %p# - %d#
-F
command-line option.
Aptitude::CmdLine::Package-Display-Width
""
), search results will be formatted for the current
terminal size, or for an 80-column display if the terminal size cannot be
determined.
Aptitude::CmdLine::Progress::Percent-On-Right
false
Aptitude::CmdLine::Progress::Retain-Completed
false
false
, then command-line progress
indicators will be deleted and overwritten once the task they represent is
completed. If it is true
, then they will be left on the
terminal. This option does not affect download progress indicators.
Aptitude::CmdLine::Request-Strictness
10000
Aptitude::CmdLine::Resolver-Debug
false
true
, aptitude
will print extremely verbose information while attempting to resolve broken
dependencies. As the name suggests, this option is primarily meant to aid
in debugging the problem resolver.
Aptitude::CmdLine::Resolver-Dump
Aptitude::CmdLine::Resolver-Show-Steps
false
true
, then a dependency solution will
be displayed as a sequence of resolutions of individual dependencies; for
instance, 「wesnoth depends upon wesnoth-data (= 1.2.4-1) ->
installing wesnoth-data 1.2.4-1 (unstable)
」. To toggle
between the two display modes, press o at the prompt
「Accept this solution?
」.
Aptitude::CmdLine::Show-Deps
false
true
, aptitude
will display a brief summary of the dependencies (if any) relating to a
package's state. This is equivalent to the -D
command-line option.
Aptitude::CmdLine::Show-Size-Changes
false
true
, aptitude
will display the expected change in the amount of space used by each
package. This is equivalent to the -Z
command-line
option.
Aptitude::CmdLine::Show-Summary
no-summary
--show-summary
.
See the documentation of --show-summary
for a list of the allowed values of this option and their meanings.
Aptitude::CmdLine::Show-Versions
false
true
, aptitude
will display the version of a package that is being installed or removed.
This is equivalent to the -V
command-line option.
Aptitude::CmdLine::Show-Why
false
true
, aptitude
will display the manually installed packages that require each automatically
installed package, or the manually installed packages that cause a conflict
with each automatically removed package. This is equivalent to the
-W
command-line option and displays the same information
you can access via aptitude why
or by pressing
i in a package list.
Aptitude::CmdLine::Version-Display-Format
%c%a%M %p# %t %i
aptitude
versions
. This is equivalent to the -F
command-line option.
Aptitude::CmdLine::Versions-Show-Package-Names
always
, auto
, or
never
to control when package names are displayed in the
output of aptitude
versions
. Equivalent to the command-line option --show-package-names
(see its documentation for more description of what the values mean).
Aptitude::Safe-Resolver::Show-Resolver-Actions
false
--safe-resolver
or
because the command-line action is safe-upgrade
, it will
display a summary of the actions taken by the resolver before showing the
installation preview. Equivalent to the command-line option --show-resolver-actions
.
Aptitude::Screenshot::IncrementalLoadLimit
16384
Aptitude::Screenshot::Cache-Max
4194304
Aptitude::CmdLine::Simulate
false
Aptitude::Simulate
instead. In command-line mode, causes aptitude to just display
the actions that would be performed (rather than actually performing them);
in the visual interface, causes aptitude to start in read-only mode
regardless of whether you are root
or not. This is equivalent to the
-s
command-line option.
Aptitude::CmdLine::Verbose
0
-v
command-line option adds 1 to this
value.
Aptitude::CmdLine::Visual-Preview
false
true
, aptitude will enter its visual
interface to display the preview of an installation run and to download
packages.
Aptitude::Delete-Unused
true
true
, automatically installed packages
which are no longer required will be automatically removed. For more
information, see 「自動的にインストールされたパッケージの管理」.
Aptitude::Delete-Unused-Pattern
Aptitude::Keep-Unused-Pattern
.
If Aptitude::Keep-Unused-Pattern
is unset or set to an
empty string, the value of this configuration option will override it.
Otherwise, Aptitude::Delete-Unused-Pattern
is ignored.
Aptitude::Display-Planned-Action
true
true
, aptitude will display a preview
screen before actually carrying out the actions you have requested.
Aptitude::Forget-New-On-Install
false
true
, aptitude will clear the list of
new packages whenever you install, upgrade, or remove packages, as if you
had issued the command → (f).
Aptitude::Forget-New-On-Update
false
true
, aptitude will clear the list of
new packages whenever the package list is updated, as if you had issued the
command → (f).
Aptitude::Get-Root-Command
su:/bin/su
root
user (see 「root
になる」). It has the form
protocol
:command
.
protocol
must be either su
or
sudo
; it determines how aptitude invokes the program
when it wants to gain root
privileges. If
protocol
is su
, then
「command
-c
arguments
」 is used to become
root
; otherwise, aptitude uses
「command
arguments
」. The first word in
command
is the name of the program that should be
invoked; remaining words are treated as arguments to that program.
Aptitude::Ignore-Old-Tmp
false
~/.aptitude/.tmp
which is no longer necessary. If the
directory exists and Aptitude::Ignore-Old-Tmp
is
true
, aptitude will ask you whether to remove this
directory. This option is automatically set to true
after you reply. On the other hand, if the directory does not exist, this
option is set to false
so that you will be notified if it
reappears.
Aptitude::Ignore-Recommends-Important
false
Aptitude::Recommends-Important
caused recommendations to
be installed automatically, the same way that APT::Install-Recommends
does today. If this option is set to false
and
Aptitude::Recommends-Important
is also set to
false
, aptitude will set APT::Install-Recommends
to false
and set
Aptitude::Ignore-Recommends-Important
to
true
on startup.
Aptitude::Keep-Recommends
false
APT::AutoRemove::RecommendsImportant
instead. Setting this option to true
has the same effect
as setting APT::AutoRemove::RecommendsImportant
to true
.
Aptitude::Keep-Suggests
false
APT::AutoRemove::SuggestsImportant
instead. Setting this option to true
has the same effect
as setting APT::AutoRemove::SuggestsImportant
to true
.
Aptitude::Keep-Unused-Pattern
Aptitude::Delete-Unused
is
true
, only unused packages which do not match this
pattern (see 「Search patterns」) will be removed. If this
option is set to an empty string (the default), all unused packages will be
removed.
Aptitude::LockFile
/var/lock/aptitude
Aptitude::Localize-Log
false
Aptitude::Log
/var/log/aptitude
Aptitude::Log
begins with a pipe character (ie,
「|
」), the remainder of its value is used as
the name of a command into which the log will be piped: for instance,
|mail -s 'Aptitude install run' root
will cause the log
to be emailed to root
. To log to multiple files or commands, you may set
this option to a list of log targets.
Aptitude::Logging::File
-
」 causes logging
messages to be printed to standard output. This differs from the setting
Aptitude::Log
: that file
is used to log installations and removals, whereas this file is used to log
program events, errors, and debugging messages (if enabled). This option is
equivalent to the command-line argument --log-file
. See
also Aptitude::Logging::Levels
.
Aptitude::Logging::Levels
level
」, to set the global log level
(the log level of the root logger) to the given
level
, or
「category
:level
」,
where category
is the category of messages to
modify (such as aptitude.resolver.hints.match
) and
level
is the lowest log level of messages in that
category that should be displayed. Valid log levels are
「fatal
」,
「error
」,
「warn
」,
「info
」,
「debug
」, and
「trace
」. The command-line option --log-level
can be
used to set or override any log level.
Aptitude::Parse-Description-Bullets
true
true
than when it is false
.
Aptitude::Pkg-Display-Limit
Aptitude::ProblemResolver::Allow-Break-Holds
false
true
, the problem resolver will
consider breaking package holds or installing forbidden versions in order to
resolve a dependency. If it is set to false
, these
actions will be rejected by default, although you can always enable them
manually (see 「Resolving Dependencies Interactively」).
Aptitude::ProblemResolver::BreakHoldScore
-300
Aptitude::ProblemResolver::Allow-Break-Holds
is set to true, the resolver will never break a hold or install a forbidden
version unless it has explicit permission from the user.
Aptitude::ProblemResolver::Break-Hold-Level
50000
Aptitude::ProblemResolver::BrokenScore
-100
Aptitude::ProblemResolver::CancelRemovalScore
-300
Aptitude::ProblemResolver::DefaultResolutionScore
400
apt-get install
」 or the 「immediate dependency
resolver」 would pick. The score is only applied for
dependencies and recommendations whose targets are not currently installed.
Aptitude::ProblemResolver::Discard-Null-Solution
true
true
, aptitude will never suggest
cancelling all of your proposed actions in order to resolve a dependency
problem.
Aptitude::ProblemResolver::EssentialRemoveScore
-100000
Aptitude::ProblemResolver::Remove-Essential-Level
60000
Aptitude::ProblemResolver::ExtraScore
0
Aptitude::ProblemResolver::FullReplacementScore
500
Aptitude::ProblemResolver::FutureHorizon
50
Aptitude::ProblemResolver::Hints
Aptitude::ProblemResolver::ImportantScore
4
Aptitude::ProblemResolver::Infinity
1000000
-Infinity
, it will be
discarded immediately.
Aptitude::ProblemResolver::InstallScore
-20
Aptitude::ProblemResolver::Keep-All-Level
10000
Aptitude::ProblemResolver::KeepScore
0
Aptitude::ProblemResolver::NonDefaultScore
-40
Aptitude::ProblemResolver::Non-Default-Level
50000
Aptitude::ProblemResolver::OptionalScore
1
Aptitude::ProblemResolver::PreserveAutoScore
0
Aptitude::ProblemResolver::PreserveManualScore
20
Aptitude::ProblemResolver::RemoveObsoleteScore
310
Aptitude::ProblemResolver::RemoveScore
-300
Aptitude::ProblemResolver::Remove-Level
10000
Aptitude::ProblemResolver::RequiredScore
8
Aptitude::ProblemResolver::ResolutionScore
50
Aptitude::ProblemResolver::Safe-Level
10000
aptitude
safe-upgrade
. See 「Safety costs」 for a description of
safety costs.
Aptitude::ProblemResolver::SolutionCost
safety,priority
Aptitude::ProblemResolver::StandardScore
2
Aptitude::ProblemResolver::StepLimit
5000
StepLimit
to 0 will disable the problem resolver
entirely. The default value is large enough to accomodate commonly
encountered situations, while preventing aptitude from 「blowing
up」 if an overly complicated problem is encountered. (note: this
applies only to command-line searches; in the visual interface, the resolver
will continue working until it reaches a solution)
Aptitude::ProblemResolver::StepScore
-10
Aptitude::ProblemResolver::Trace-Directory
Aptitude::ProblemResolver::Trace-File
is also set, the
same information will also be written to the trace file. Trace directories
are more transparent than trace files, and are more suitable for, e.g.,
including in source trees as test cases.
Aptitude::ProblemResolver::Trace-File
Aptitude::ProblemResolver::Trace-Directory
is also set,
the same information will also be written to the trace directory. A trace
file is simply a compressed archive of a trace directory; it will take less
space than the trace directory and is suitable for transmission over a
network.
Aptitude::ProblemResolver::UndoFullReplacementScore
-500
Aptitude::ProblemResolver::UnfixedSoftScore
-200
Aptitude::ProblemResolver::UpgradeScore
30
Aptitude::Purge-Unused
false
true
and Aptitude::Delete-Unused
is
also true
, then packages which are unused will be
purged from the system, removing their configuration
files and perhaps other important data. For more information about which
packages are considered to be 「unused」, see 「自動的にインストールされたパッケージの管理」. THIS OPTION CAN CAUSE DATA LOSS! DO
NOT ENABLE IT UNLESS YOU KNOW WHAT YOU ARE DOING!
Aptitude::Recommends-Important
true
APT::Install-Recommends
.
On startup, aptitude will copy
Aptitude::Recommends-Important
(if it exists) to
APT::Install-Recommends
and then clear
Aptitude::Recommends-Important
in your user configuration
file.
Aptitude::Safe-Resolver::No-New-Installs
false
true
, then when the 「safe」
dependency resolver has been activated via --safe-resolver
or
by using the safe-upgrade
command-line action, the resolver will not be allowed to install packages
that are not currently installed.
Aptitude::Safe-Resolver::No-New-Upgrades
false
--safe-resolver
or
by using the safe-upgrade
command-line action, the resolver will not be allowed to resolve
dependencies by upgrading packages.
Aptitude::Sections::Descriptions
$prefix/share/aptitude/section-descriptions
section
」
package hierarchy grouping policy. Descriptions are assigned to section
trees based on the last component of the name: for instance, a member of
this group named 「games
」 will be used to
describe the Sections 「games
」,
「non-free/games
」, and
「non-free/desktop/games
」. Within the text
of section descriptions, the string 「\n
」
will be replaced by a line-break, and the string
「''
」 will be replaced by a double-quote
character.
Aptitude::Sections::Top-Sections
"main"; "contrib"; "non-free"; "non-US";
topdir
」,
「subdir
」, and
「subdirs
」 grouping policies use this list to
interpret Section fields: if the first path element of a package's Section
is not contained in this list, or if its Section has
only one element, then the package will be grouped using the first member of
this list as its first path element. For example, if the first member of
Top-Sections
is 「main
」,
then a package whose Section is
「games/arcade
」 will be treated as if its
Section field were 「main/games/arcade
」.
Aptitude::Simulate
false
root
or not. This is equivalent to the
-s
command-line option.
Aptitude::Spin-Interval
500
Aptitude::Suggests-Important
false
APT::AutoRemove::SuggestsImportant
instead. Setting this option to true
has the same effect
as setting APT::AutoRemove::SuggestsImportant
to true
.
Aptitude::Suppress-Read-Only-Warning
false
false
, aptitude will display a
warning the first time that you attempt to modify package states while
aptitude is in read-only mode.
Aptitude::Track-Dselect-State
true
true
, aptitude will attempt to
detect when a change to a package's state has been made using dselect or
dpkg: for instance, if you remove a package using
dpkg, aptitude will not try to reinstall it. Note that
this may be somewhat buggy.
Aptitude::UI::Advance-On-Action
false
true
, changing a package's state
(for instance, marking it for installation) will cause aptitude to advance
the highlight to the next package in the current group.
Aptitude::UI::Auto-Show-Reasons
true
true
, selecting a package which
is broken or which appears to be causing other packages to be broken will
cause the information area to automatically display some reasons why the
breakage might be occuring.
Aptitude::UI::Default-Grouping
filter(missing),status,section(subdirs,passthrough),section(topdir)
Aptitude::UI::Default-Package-View
Aptitude::UI::Default-Preview-Grouping
action
Aptitude::UI::Default-Sorting
name
Aptitude::UI::Description-Visible-By-Default
true
true
and hidden if it is
false
.
Aptitude::UI::Exit-On-Last-Close
true
true
, closing all the active views will
quit aptitude; otherwise, aptitude will not exit until you issue the
command → (Q). See 「複数の画面を用いた作業」 for more
information.
Aptitude::UI::Fill-Text
false
true
, aptitude will format
descriptions so that each line is exactly the width of the screen.
Aptitude::UI::Flat-View-As-First-View
false
true
, aptitude will display a flat
view on startup instead of the default view.
Aptitude::UI::HelpBar
true
true
, a line of information about
important keystrokes will be displayed at the top of the screen.
Aptitude::UI::Incremental-Search
true
true
, aptitude will perform
「incremental」 searches: as you type the search pattern, it will
search for the next package matching what you have typed so far.
Aptitude::UI::InfoAreaTabs
false
true
, aptitude will display tabs at
the top of the information area (the pane at the bottom of the screen)
describing the different modes the area can be set to.
Aptitude::UI::Keybindings
Aptitude::UI::Menubar-Autohide
false
true
, the menu bar will be
hidden while it is not in use.
Aptitude::UI::Minibuf-Download-Bar
false
true
, aptitude will use a less
obtrusive mechanism to display the progress of downloads: a bar at the
bottom of the screen will appear which displays the current download
status. While the download is active, pressing q will
abort it.
Aptitude::UI::Minibuf-Prompts
false
true
, some prompts (such as yes/no and
multiple-choice prompts) will be displayed at the bottom of the screen
instead of in dialog boxes.
Aptitude::UI::New-Package-Commands
true
false
, commands such as
→ (+) will have the same deprecated behavior that they did in
antique versions of aptitude.
Aptitude::UI::Package-Display-Format
%c%a%M %p %Z %v %V
Aptitude::UI::Package-Header-Format
%N %n @ %H #%B %u %o
Aptitude::UI::Package-Status-Format
%d
Aptitude::UI::Pause-After-Download
OnlyIfError
true
, aptitude will display a message
after it finishes downloading packages, asking you if you want to continue
with the installation. If it is OnlyIfError
, a message
will only be displayed if a download failed. Otherwise, if the option is
set to false
, aptitude will immediately proceed to the
next screen after completing a download.
Aptitude::UI::Preview-Limit
Aptitude::UI::Prompt-On-Exit
true
true
, aptitude will display a
confirmation prompt before shutting down.
Aptitude::UI::Styles
Aptitude::UI::ViewTabs
true
false
, aptitude will not
display 「tabs」 describing the currently active views at the top
of the screen.
Aptitude::Warn-Not-Root
true
true
, aptitude will detect when you
need root
privileges to do something, and ask you whether you want to
switch to the root
account if you aren't root
already. See 「root
になる」 for more information.
DebTags::Vocabulary
/usr/share/debtags/vocabulary
debtags
vocabulary file; used to load
in the package tag metadata.