auto-apt(1)

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.