Configuration file reference

設定ファイルの書式
設定ファイルの場所
Available configuration options

設定ファイルの書式

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 の設定は以下のソースから順に読まれます。

  1. ユーザの設定ファイル ~/.aptitude/config。このファイルは、ユーザが「オプション」メニューの設定に変更を加えたときに上書きされます。

  2. システムの設定ファイル /etc/apt/apt.conf

  3. /usr/share/aptitude/aptitude-defaults 内に格納されているデフォルト値。

  4. プログラムに組み込まれているデフォルト値。

オプションを調べるときにこれらのソースは順に検索され、そのオプションに対して値を与えるソースのうち最初に見つかったものが使用されます。例えば、あるオプションを /etc/apt/apt.conf に設定すると、aptitude のそのオプションのデフォルト値は上書きされますが、~/.aptitude/config のユーザ設定は上書きされません。

Available configuration options

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.

Option: Dir::Aptitude::state
デフォルト: /var/lib/aptitude
説明: The directory in which aptitude's persistent state information is stored.
Option: Aptitude::Allow-Null-Upgrade
デフォルト: false
説明: Normally, if you try to start an install run when no actions will be performed, aptitude will print a warning and return to the package list. If this option is true, aptitude will continue to the preview screen whenever there are upgradable packages, rather than displaying a reminder about the アクション更新可能パッケージという印を添付 (U) command.
Option: Aptitude::Autoclean-After-Update
デフォルト: false
説明: If this option is true, aptitude will clean up obsolete files (see アクション廃止されたファイルを一掃する) every time you update the package list.
Option: Aptitude::Auto-Install
デフォルト: true
説明: If this option is true, aptitude will automatically attempt to fulfill the dependencies of a package when you select it for installation.
Option: Aptitude::Auto-Fix-Broken
デフォルト: true
説明: If this option is false, aptitude will ask for permission before attempting to fix any broken packages.
Option: Aptitude::Auto-Upgrade
デフォルト: false
説明: If this option is true, aptitude will automatically flag all upgradable packages for upgrade when the program starts, as if you had issued the command アクション更新可能パッケージという印を添付 (U).
Option: Aptitude::CmdLine::Always-Prompt
デフォルト: false
説明: In command-line mode, if this is set, aptitude will always prompt before starting to install or remove packages, even if the prompt would normally be skipped. This is equivalent to the -P command-line option.
Option: Aptitude::CmdLine::Assume-Yes
デフォルト: false
説明: In command-line mode, if this option is 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.
Option: Aptitude::CmdLine::Ignore-Trust-Violations
デフォルト: false
説明: In command-line mode, causes the program to ignore the installation of untrusted packages. This is a synonym for Apt::Get::AllowUnauthenticated.
Option: Aptitude::CmdLine::Resolver-Debug
デフォルト: false
説明: In command-line mode, if this option is 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.
Option: Aptitude::CmdLine::Resolver-Dump
デフォルト:
説明: In command-line mode, if it is necessary to resolve broken dependencies and this option is set to the name of a writable file, the resolver state will be dumped to this file before any calculations are undertaken.
Option: Aptitude::CmdLine::Resolver-Show-Steps
デフォルト: false
説明: If this option is 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?」.
Option: Aptitude::CmdLine::Request-Strictness
デフォルト: 10000
説明: When run in command-line mode, if dependency problems are encountered, aptitude will add this value to the problem resolver score of each action that you explicitly request.
Option: Aptitude::CmdLine::Download-Only
デフォルト: false
説明: In command-line mode, if this option is true, aptitude will download package files but not install them. This is equivalent to the -d command-line option.
Option: Aptitude::CmdLine::Fix-Broken
デフォルト: false
説明: In command-line mode, if this option is true, aptitude will be more aggressive when attempting to fix the dependencies of broken packages. This is equivalent to the -f command-line option.
Option: Aptitude::CmdLine::Package-Display-Format
デフォルト: %c%a%M %p# - %d#
説明: This is a format string, as described in パッケージの表示方法のカスタマイズ項, which is used to display the results of a command-line search. This is equivalent to the -F command-line option.
Option: Aptitude::CmdLine::Package-Display-Width
デフォルト:
説明: This option gives the width in characters for which command-line search results should be formatted. If it is empty (the default; ie, ""), search results will be formatted for the current terminal size, or for an 80-column display if the terminal size cannot be determined.
Option: Aptitude::CmdLine::Show-Deps
デフォルト: false
説明: In command-line mode, if this option is 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.
Option: Aptitude::CmdLine::Show-Versions
デフォルト: false
説明: In command-line mode, if this option is true, aptitude will display the version of a package that is being installed or removed. This is equivalent to the -V command-line option.
Option: Aptitude::CmdLine::Show-Size-Changes
デフォルト: false
説明: In command-line mode, if this option is 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.
Option: Aptitude::CmdLine::Simulate
デフォルト: false
説明: This option is deprecated; use 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 the program to start in read-only mode regardless of whether you are root or not. This is equivalent to the -s command-line option.
Option: Aptitude::CmdLine::Visual-Preview
デフォルト: false
説明: If this option is true, aptitude will enter its visual mode to display the preview of an installation run and to download packages.
Option: Aptitude::CmdLine::Verbose
デフォルト: 0
説明: This controls how verbose the command-line mode of aptitude is. Every occurrence of the -v command-line option adds 1 to this value.
Option: Aptitude::Delete-Unused
デフォルト: true
説明: If this option is true, automatically installed packages which are no longer required will be automatically removed. For more information, see 自動的にインストールされたパッケージの管理項.
Option: Aptitude::Delete-Unused-Pattern
デフォルト:
説明: Deprecated alias for 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.
Option: Aptitude::Display-Planned-Action
デフォルト: true
説明: If this option is true, aptitude will display a preview screen before actually carrying out the actions you have requested.
Option: Aptitude::Forget-New-On-Update
デフォルト: false
説明: If this option is true, aptitude will clear the list of new packages whenever the package list is updated, as if you had issued the command アクション新規パッケージ一覧の消去 (f).
Option: Aptitude::Forget-New-On-Install
デフォルト: false
説明: If this option is true, aptitude will clear the list of new packages whenever you install, upgrade, or remove packages, as if you had issued the command アクション新規パッケージ一覧の消去 (f).
Option: Aptitude::Ignore-Old-Tmp
デフォルト: false
説明: Old versions of aptitude created a directory ~/.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.
Option: Aptitude::Keep-Recommends
デフォルト: false
説明: If this option is 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 Aptitude::Recommends-Important is false. For more information, see 自動的にインストールされたパッケージの管理項.
Option: Aptitude::Keep-Suggests
デフォルト: false
説明: If this option is 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 自動的にインストールされたパッケージの管理項.
Option: Aptitude::Keep-Unused-Pattern
デフォルト:
説明: If Aptitude::Delete-Unused is true, only unused packages which do not match this pattern (see 検索パターン項) will be removed. If this option is set to an empty string (the default), all unused packages will be removed.
Option: Aptitude::LockFile
デフォルト: /var/lock/aptitude
説明: A file that will be fcntl-locked to ensure that at most one aptitude process can modify the cache at once. In normal circumstances, you should never need to modify this; it may be useful for debugging. Note: if aptitude complains that it cannot acquire a lock, this is not because the lock file needs to be deleted. fcntl locks are managed by the kernel and will be destroyed when the program terminates; failure to acquire the lock means that another running program is using it!
Option: Aptitude::Log
デフォルト: /var/log/aptitude
説明: If this is set to a nonempty string, aptitude will log the package installations, removals, and upgrades that it performs. If the value of 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.
Option: Aptitude::Parse-Description-Bullets
デフォルト: false
説明: If this option is enabled, aptitude will attempt to automatically detect bulleted lists in package descriptions. This will generally improve how descriptions are displayed, but it is not entirely backwards-compatible; some descriptions might be formatted less attractively when this option is true than when it is false.
Option: Aptitude::Pkg-Display-Limit
デフォルト:
説明: The default filter applied to the package list; see 検索パターン項 for details about its format.
Option: Aptitude::Recommends-Important
デフォルト: true
説明: If this option is 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 自動的にインストールされたパッケージの管理項.
Option: Aptitude::ProblemResolver::BreakHoldScore
デフォルト: -300
説明: How much to reward or penalize solutions that change the state of a held package.
Option: Aptitude::ProblemResolver::BrokenScore
デフォルト: -100
説明: How much to reward or penalize prospective solutions based on the number of dependencies they break. For each dependency broken by a possible solution, this many points are added to its score; typically this should be a negative value.
Option: Aptitude::ProblemResolver::Discard-Null-Solution
デフォルト: true
説明: If this option is true, aptitude will never suggest cancelling all of your proposed actions in order to resolve a dependency problem.
Option: Aptitude::ProblemResolver::EssentialRemoveScore
デフォルト: -100000
説明: How much to reward or penalize solutions that remove an Essential package.
Option: Aptitude::ProblemResolver::ExtraScore
デフォルト: -1
説明: Any version of a package whose Priority is 「extra」 will have this many points added to its score.
Option: Aptitude::ProblemResolver::ImportantScore
デフォルト: 5
説明: Any version of a package whose Priority is 「important」 will have this many points added to its score.
Option: Aptitude::ProblemResolver::Infinity
デフォルト: 1000000
説明: A 「maximum」 score for potential solutions. If a set of actions has a score worse than -Infinity, it will be discarded immediately.
Option: Aptitude::ProblemResolver::InstallScore
デフォルト: -20
説明: How much weight the problem resolver should give to installing a package, if the package is not already going to be installed.
Option: Aptitude::ProblemResolver::KeepScore
デフォルト: 0
説明: How much weight the problem resolver should give to keeping a package in its current state, if that package is not already going to be kept in its current state.
Option: Aptitude::ProblemResolver::Max-Successors
デフォルト: 0
説明: When new possible solutions are being generated, this value controls how long the generation procedure lasts. Successors are generated in discrete bundles, and as soon as at least one and at most Max-Successors nodes have been generated, successor generation terminates. Turning this value up might cause the first few generated solutions to have higher scores; on the other hand, it might cause each resolver 「step」 to take a long time.
Option: Aptitude::ProblemResolver::NonDefaultScore
デフォルト: -40
説明: How much weight the problem resolver should give to installing a non-default version of the package (one that is not the current version and not the 「candidate version」).
Option: Aptitude::ProblemResolver::OptionalScore
デフォルト: 1
説明: Any version of a package whose Priority is 「optional」 will have this many points added to its score.
Option: Aptitude::ProblemResolver::PreserveAutoScore
デフォルト: 0
説明: How much weight the problem resolver should give to preserving automatic installations or removals.
Option: Aptitude::ProblemResolver::PreserveManualScore
デフォルト: 60
説明: How much weight the problem resolver should give to preserving explicit user selections.
Option: Aptitude::ProblemResolver::ResolutionScore
デフォルト: 50
説明: In addition to all other scoring factors, proposed solutions that actually resolve all unsatisfied dependencies are awarded this many extra points.
Option: Aptitude::ProblemResolver::RemoveScore
デフォルト: -300
説明: How much weight the problem resolver should give to removing a package (if it is not already marked for removal).
Option: Aptitude::ProblemResolver::RequiredScore
デフォルト: 4
説明: Any version of a package whose Priority is 「required」 will have this many points added to its score.
Option: Aptitude::ProblemResolver::StandardScore
デフォルト: 3
説明: Any version of a package whose Priority is 「standard」 will have this many points added to its score.
Option: Aptitude::ProblemResolver::StepLimit
デフォルト: 5000
説明: The maximum number of 「steps」 which should be performed by the problem resolver on each attempt to find a solution to a dependency problem. Decreasing this number will make the program 「give up」 sooner; increasing it will permit the search for a solution to consume much more time and memory before it is aborted. The default value is large enough to accomodate commonly encountered situations, while preventing the program 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)
Option: Aptitude::ProblemResolver::StepScore
デフォルト: 70
説明: How much to reward or penalize prospective solutions based on their length. For each action performed by a solution, this many points are added to its score. The larger this value is, the more the resolver tends to stick with its first choice rather than considering alternatives; this will cause it to produce a solution more quickly, but the solution might be of slightly lower quality than it would otherwise be.
Option: Aptitude::ProblemResolver::UnfixedSoftScore
デフォルト: -200
説明: How much to reward or penalize leaving a Recommends relationship unresolved. This should typically be less than RemoveScore, or aptitude will tend to remove packages rather than leaving their Recommendations unfixed. See 依存関係の問題の解決項 for details.
Option: Aptitude::ProblemResolver::UpgradeScore
デフォルト: 0
説明: How much weight the problem resolver should give to upgrading (or downgrading) a package to its candidate version, if the package was not already going to be upgraded.
Option: Aptitude::ProblemResolver::WaitSteps
デフォルト: 50
説明: The number of resolver steps to perform in the foreground before moving the resolution to the background thread. aptitude will be unresponsive while this computation takes place; decreasing this value will make the program more responsive, but may cause the progress indicator to appear unnecessarily.
Option: Aptitude::Purge-Unused
デフォルト: false
説明: If this option is 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!
Option: Aptitude::Simulate
デフォルト: false
説明: 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 the program to start in read-only mode regardless of whether you are root or not. This is equivalent to the -s command-line option.
Option: Aptitude::Suggests-Important
デフォルト: false
説明: This is an obsolete option; use Aptitude::Keep-Suggests instead. Setting this option to true has the same effect as setting Aptitude::Keep-Suggests to true.
Option: Aptitude::Theme
デフォルト:
説明: The theme that aptitude should use; see テーマ項 for more information.
Option: Aptitude::Spin-Interval
デフォルト: 500
説明: The number of milliseconds to delay in between updating the 「spinner」 that appears while the problem resolver is running.
Option: Aptitude::Track-Dselect-State
デフォルト: true
説明: If this option is set to 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.
Option: Aptitude::UI::Advance-On-Action
デフォルト: false
説明: If this option is set to 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.
Option: Aptitude::UI::Auto-Show-Reasons
デフォルト: true
説明: If this option is set to 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.
Option: Aptitude::UI::Default-Grouping
デフォルト: filter(missing),status,section(subdir,passthrough),section(topdir)
説明: Sets the default grouping policy used for package lists. See パッケージ階層構造のカスタマイズ項 for additional information on grouping policies.
Option: Aptitude::UI::Default-Preview-Grouping
デフォルト: action
説明: Sets the default grouping policy used for preview screens. See パッケージ階層構造のカスタマイズ項 for additional information on grouping policies.
Option: Aptitude::UI::Default-Sorting
デフォルト: name
説明: The default sorting policy of package views. See パッケージの並べ方のカスタマイズ項 for more information.
Option: Aptitude::UI::Description-Visible-By-Default
デフォルト: true
説明: When a package list is first displayed, the information area (which typically contains the long description of the current package) will be visible if this option is true and hidden if it is false.
Option: Aptitude::UI::Default-Package-View
デフォルト:
説明: This option is a group whose members define the default layout of aptitude's display. See Customizing the display layout項 for more information.
Option: Aptitude::UI::Download-Poll-Interval
デフォルト: 50000
説明: This option gives the interval in milliseconds at which the user interface will update its display and poll for new input while a download is being performed. Smaller values will make the program more responsive, but will consume a larger amount of CPU time.
Option: Aptitude::UI::Exit-On-Last-Close
デフォルト: true
説明: If this option is true, closing all the active views will quit aptitude; otherwise, aptitude will not exit until you issue the command アクション終了 (Q). See 複数の画面を用いた作業項 for more information.
Option: Aptitude::UI::Fill-Text
デフォルト: false
説明: If this option is true, aptitude will format descriptions so that each line is exactly the width of the screen.
Option: Aptitude::Get-Root-Command
デフォルト: su:/usr/bin/su
説明: This option sets the external command that aptitude will use to switch to the 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.
Option: Aptitude::UI::HelpBar
デフォルト: true
説明: If this option is true, a line of information about important keystrokes will be displayed at the top of the screen.
Option: Aptitude::UI::Incremental-Search
デフォルト: true
説明: If this option is 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.
Option: Aptitude::UI::Keybindings
デフォルト:
説明: This is a group whose members define the connections between keystrokes and commands in aptitude. For more information, see Customizing keybindings項.
Option: Aptitude::UI::Menubar-Autohide
デフォルト: false
説明: If this option is set to true, the menu bar will be hidden while it is not in use.
Option: Aptitude::UI::Minibuf-Download-Bar
デフォルト: false
説明: If this option is set to 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.
Option: Aptitude::UI::Minibuf-Prompts
デフォルト: false
説明: If this option is 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.
Option: Aptitude::UI::New-Package-Commands
デフォルト: true
説明: If this option is set to false, commands such as パッケージインストール (+) will have the same deprecated behavior that they did in antique versions of aptitude.
Option: Aptitude::UI::Package-Display-Format
デフォルト: %c%a%M %p %Z %v %V
説明: This option controls the format string used to display packages in package lists. For more information on format strings, see パッケージの表示方法のカスタマイズ項.
Option: Aptitude::UI::Package-Header-Format
デフォルト: %N %n #%B %u %o
説明: This option controls the format string used to display the header line of package lists (ie, the line that appears between the package list and the menu bar). For more information on format strings, see パッケージの表示方法のカスタマイズ項.
Option: Aptitude::UI::Package-Status-Format
デフォルト: %d
説明: This option controls the format string used to display the status line of package lists (ie, the line that appears between the package list and the information area). For more information on format strings, see パッケージの表示方法のカスタマイズ項.
Option: Aptitude::UI::Pause-After-Download
デフォルト: OnlyIfError
説明: If this option is 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.
Option: Aptitude::Preview-Limit
デフォルト:
説明: The default filter applied to the preview screen; see 検索パターン項 for details about its format.
Option: Aptitude::UI::Prompt-On-Exit
デフォルト: true
説明: If this option is true, aptitude will display a confirmation prompt before shutting down.
Option: Aptitude::UI::Styles
デフォルト:
説明: This is a configuration group whose contents define what textual styles aptitude uses to display information. For more information, see テキストの色とスタイルのカスタマイズ項.
Option: Aptitude::UI::ViewTabs
デフォルト: true
説明: If this option is set to false, aptitude will not display 「tabs」 describing the currently active views at the top of the screen.
Option: Aptitude::Suppress-Read-Only-Warning
デフォルト: false
説明: If this option is false, aptitude will display a warning the first time that you attempt to modify package states while the program is in read-only mode.
Option: Aptitude::Warn-Not-Root
デフォルト: true
説明: If this option is 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.
Option: DebTags::Vocabulary
デフォルト: /usr/share/debtags/vocabulary
説明: The location of the debtags vocabulary file; used to load in the package tag metadata.
Option: Quiet
デフォルト: 0
説明: This controls the quietness of the command-line mode. Setting it to a higher value will disable more progress indicators.