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.