NAME
auto-apt - on demand package installation tool
SYNOPSIS
auto-apt [options] [command] [args...]
DESCRIPTION
This manual page documents briefly the auto-apt commands.
auto-apt is a program that checks file access of programs running
within auto-apt environments. If a program will access a file of
uninstalled package, auto-apt will install the package containing the
file, by using apt-get.
OPTIONS
A summary of options is included below.
-h Usage.
-s No action, perform a simulation of action.
-y Automatic yes to prompt.
-q Quiet
-i Don’t install in background process.
-x Disable X interface.
-X Enable X interface. Run apt-get in another x-terminal-emulator
if you run in X environments.
-a [dist[,dist...]]
Select installable distribution from main,contrib,non-free,non-
US or none. If you set "-a none", it means almost same as "-s".
-p [hook[,hook...]]
Select hook functions from exec,open,access,stat or none If you
set "-p none", it means almost same as "-s".
-D [dbfile]
Change dbfile from default /var/cache/auto-apt/pkgcontents.db
-F [filedb]
Change filedb from default /var/cache/auto-apt/pkgfiles.db,
which is generated by auto-apt update-local commands. It is
used as default dbfile for commands with -local postfix. In
many cases, it is used with -L option to detect file access
-L [record.lists]
Append file access data to record.lists file.
COMMANDS
A summary of command is included below.
run [command]
Run command controlled by auto-apt. If command is not
specified, user’s shell will be used.
update [ -a ]
Recreate dbfile from sources.list information. dbfile can be
specified by -D option. With -a option, all files are stored in
dbfile. Note that dbfile become too big with -a option.
update-local [ -a ]
Generate filedb from installed package information. filedb can
be specified by -F option. With -a option, all files are stored
in dbfile. Note that dbfile become too big with -a option.
merge [ -a ]
Merge package,filename information to dbfile, which can be
specified by -D option. With -a option, all files are stored in
dbfile. Note that dbfile become too big with -a option.
del package
Delete file information of package from dbfile database.
check [-v] [-f] file
Check which package provides file, from dbfile database.
options: -v means verbose. -f uses Contents-*.gz file instead of
dbfile database.
install [-s] [-d] [-u] [-y] [-v] file
Try to install a package that provides file by using apt-get.
You need root privilege to run apt-get install.
list [-v] [-f]
List file information in dbfile database. options: -v means
verbose. -f uses Contents-*.gz file instead of dbfile database.
search [-v] [-f] pattern
Search file information by grep(1) pattern in dbfile database.
options: -v means verbose. -f uses Contents-*.gz file instead of
dbfile database.
debuild [debuildopts]
Run debuild(1) in auto-apt environments, and show Build-Depends:
estimation. Recommended to use with -s option of auto-apt.
status Show whether current environment is in auto-apt or not.
FILES
o /etc/auto-apt/paths.list path lists
o /var/cache/auto-apt cache/database directory
o /etc/auto-apt/sources.list sources.list for auto-apt. if not
found, symlink to apt-get’s sources.list will be created.
ENVIRONMENTS
o AUTO_APT_CACHEDIR override default cache/database directory
BUGS
Known bugs. See /usr/share/doc/auto-apt/BUGS. and/or
http://bugs.debian.org/auto-apt
AUTHOR
This program was written by Fumitoshi UKAI <ukai@debian.or.jp>,
inspired by idea/comments from Debian Guru (debian.gr.jp) and Project
Dice members.
29 Jun 2000 auto-apt(1)