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)