NAME¶
aptitude-robot - automate package choice management
SYNOPSIS¶
aptitude-robot [options]
aptitude-robot --help
DESCRIPTION¶
aptitude-robot uses configuration files to install and remove Debian software
packages automatically. This allows hands-off setup and maintenance of
workstations and servers. Create package lists in a development environment
and copy the package lists over to the production machines. aptitude-robot
will then make sure that the packages mentioned in the lists are installed or
removed as indicated.
OPTIONS¶
- --force-install
- give priority to install(+), remove(-), and purge(_) actions over keep(:)
and hold(=)
- --config-dir /path/to/config/dir
- specify an alternate configuration directory. Defaults to
/etc/aptitude-robot
- --show-cmdline
- only show the command that would be executed
- --help
- Prints this page.
- other options
- any option not recognized by aptitude-robot itself is passed through to
aptitude. The options -q and -s are likely to be used
occasionally. See aptitude(8) for details.
CONFIGURATION¶
The configuration directory given by the "--config-dir" (or
/etc/aptitude-robot by default) must contain a directory named
pkglist.d. This directory may have several package list files that are
chosen according to the criteria of
run-parts(8). They are concatenated
in the order given by
run-parts(8).
Each line shall contain an action and a package name separated by white space.
The actions are those used by the "aptitude" command line interface
(see aptitude documentation). Typically they are:
+ package # install package
+M package # install package and mark it as automatically installed
- package # remove package
_ package # purge package
: package # keep package at current version
= package # mark a package as "hold", i.e., prevent automatic
updates
If a package is mentioned several times the last entry will determine the
action. If the "--force-install" option is given the keep(:) and
hold(=) actions are given lower priority, i.e., the appear only when no other
action for the package is specified.
A "#" character starts a comment extending to the end of line. Empty
lines or extra white space at the beginning or end of line is ignored.
Optionally the configuration directory may contain a file name
options
containing extra options given to aptitude in the form of one option per line.
Optionally the configuration directory may contain two directories
triggers.pre and
triggers.post with scripts that are executed by
run-parts(8) before and after aptitude respectively.
SEE ALSO¶
aptitude(8),
aptitude-robot-session(8)
AUTHORS¶
Elmar S. Heeb <elmar@heebs.ch> and Axel Beckert
<abe@debian.org>