.TH feta 1 "February 16th, 2004" Debian "Front End To APT"
.SH NAME
feta \- a frontend to many Debian package-related tools
.SH SYNOPSIS
\fBfeta \fR[\fIoptions\fR] [\fIcommand\fR] [\fIpackages\fR|\fIfiles\fR|\fIurls\fR] ...
.SH DESCRIPTION
Feta takes the place of programs like dpkg, apt\-get, apt\-cache, and provides
one program name to remember for all those functions. It deals with about
a dozen different helper programs in the Debian packaging system for you.
.SH USAGE
Feta is executed with the name of a command (all of which are listed below),
and any parameters for that command. Usually, parameters will be package
names, search terms, or files; it depends on the command.
.PP
Feta allows you to 'chain' commands together using commas on the command
line; for example \fBfeta install libc6\-dev, remove less, info zgv\fR.
.PP
This manual page contains only a small overview of each of Feta's commands.
For more information on each command, you can try \fBfeta help \fIcommand\fR,
which may bring up more information about the command.
.SH OPTIONS
.IP \-h
Read this manual page.
.IP \-o
Use sudo for running commands, instead of su. This option can be cancelled
by using the \-O option.
.IP \-q
Turn on "quiet mode". Feta will print less than it usually does.
.IP \-t
Turn off "teaching mode". Normally, Feta displays the commands it is running.
Using \-t makes it not display them.
.IP \-u
Update the list of available packages before doing anything else.
.IP \-v
Display version and copyright information, and exit.
.IP \-x
Exit as soon an error is encountered. This is the recommended behavior
when running in scripts.
.IP \-y
Assume yes at most yes or no prompts. This is analogous to the apt\-get
\-\-assume\-yes option, and also affects yes and no prompts that are in
Feta.
.IP \-R
If no other options or commands are passed, run 'feta select'. If
anything else is passed, this is ignored. This is useful if you put it
in FETA_OPTS, because then running 'feta' will really run 'feta
select'.
.IP \-U
Assume no to any prompt to update the APT package list.
.IP \-V
Turn on "verbose" mode. When possible, more information will be printed
to the screen. This also replaces Feta's generic error message with one
that may be more informative, from the program that the error occurred in.
.PP
Some other command line options are expanded and turned into actions; see
below for that list.
.SH COMMANDS
Feta has a variety of commands to query and modify your local Debian package
database and packages. If a command is followed by [*], you will need to
be root to perform the command, and Feta will automatically run \fBsu\fR for
you.
.PP
This is only a short overview of each command. For a listing of all the
features of each one, use \fBfeta help \fIcommand\fR.
.IP add\-override\ [*]
Add a stat override to a file; this takes the same arguments as the
dpkg\-statoverride command. The concept behind a stat override is too
complicated to explain here, please read \fBdpkg\-statoverride\fR(8).
.IP alternatives\ [*]
Select an appropriate program for a 'generic' UNIX command (for example,
\fBeditor\fR or \fBpager\fR). For a complete list of alternatives you
can change, look in \fI/etc/alternatives\fR.
.IP apropos
Search the contents of all the Feta help files you have installed.
.IP apt\-sources\ [*]
Edit your \fI/etc/apt/sources.list\fR file, to add or remove different
package repositories.
.IP available
Display the currently installed version and available version of the packages
given.
.IP bug
Report bugs in packages to the Debian BTS. You can also use this command
to query the BTS for information on existing bugs or packages.
.IP build
Download, compile, and build all the packages given on the command line.
This requires APT to be configured to download source packages (which it
usually is).
.IP build\-depends,\ build\-dep
Download and install any packages you need to build the given packages.
The build command does this automatically.
.IP changes
Display the changelog.Debian, changelog, or NEWS file (checked in that
order) of an installed package within your default text pager.
.IP check\ [*]
Rebuild the APT sources.list cache file. Do this if you think it's been
corrupted in some, or if APT complains.
.IP checksums,\ sums
Verify that files have not been modified or corrupted using MD5 checksums.
If a binary or data file is reported as not having a correct checksum, you
may wish to consider reinstalling the package.
.IP clean\ [*]
Delete obsolete packages in /var/cache/apt/archives. If you run
\fBfeta clean all\fR, all packages will be deleted.
.IP commands
Display a list of Feta's commands. This is mostly useful in shell scripts.
.IP configure\ [*]
Reconfigure the packages given on the command line, if that is possible. If
there are no packages given, this configures all unconfigured packages.
.IP console
Use Feta in interactive console mode. See the section "The Feta Console"
below for more information on how to use it.
.IP contents,\ \-c
Display the contents of a package (either a filename, or an installed one).
.IP dist\-upgrade\ [*]
Perform a dist\-upgrade. This is like an "upgrade" (see below), except some
packages may be removed if they conflict.
.IP provides,\ find,\ \-S
Find the packages that contain the filenames (or wildcards) given on the
command line.
.IP force\-install\ [*]
Forcibly install packages (only off your hard drive), regardless of any
problems with them. This is a bad idea.
.IP force\-remove\ [*]
Forcibly remove packages from your system, regardless of any remaining
dependencies. This is also a bad idea.
.IP force\-purge\ [*]
Forcibly remove packages and their configuration files from your system,
regardless of any remaining dependencies. This, like the other forced
commands, is a bad idea.
.IP foster\ [*]
Verify that you want packages that nothing depends on, and remove them if you
don't want them.
.IP help
Without any arguments, Feta will display this manual page. If a command name
is given, Feta will display help on that command, if it is available.
.IP hold\ [*]
Place a package on hold. The package will not be upgraded during an upgrade
or dist\-upgrade command.
.IP info,\ show,\ \-s
Display a brief screen of information about a package or file.
.IP install,\ \-i\ [*]
Install packages from a filename, or download automatically from a URL
or the Debian package servers.
.IP install\-list\ [*]
Read in a text file and install all the packages in it (one per line). If
you use this with the \fBlist\-installed\fR command to create a (poor) copy
of your system.
.IP install\-tasks\ [*]
Install a set of packages known as a 'task'. You can view packages in
a task, or a list of all tasks, by using \fBlist\-tasks\fR.
.IP list
List all installed packages and their short descriptions. A wildcard pattern
(*something*) can be provided to display all packages, installed or not,
that match that wildcard.
.IP list\-installed
Display a list of all the currently installed/held packages. If a filename
is given, Feta will output to that filename instead. This can be used in
conjunction with \fBinstall\-list\fR to create a (poor) copy of your system.
.IP list\-overrides
List all the stat overrides you have created. This is too in-depth to
explain here; please read to \fBdpkg\-statoverride\fR(8).
.IP list\-tasks
List all the tasks that can be installed using the \fBtask install\fR
command. If one or more task names are also given, Feta will display all
the packages in those tasks.
.IP names
List the names of all the packages available, sorted. You can also
give a filter on the command line.
.IP overrides
Start an interactive and more helpful interface to add, remove, and view stat
overrides.
.IP orphan\ [*]
Track down unneeded libraries and remove them. This might affect you if you
have custom-compiled or proprietary software, but is generally safe.
.IP package\-sizes
Display the sizes of all installed packages, as well as the total size. The
switches \-r and \-s can be used \fBafter\fR the command time to sort by
size (rather than alphabetically), and reverse the display order.
.IP policy
Display information about your /etc/apt/preferences file, such as package
priorities and pins. If package names are given, detailed information about
those packages are printed out; otherwise, a summary of all package
priorities and pins are printed out.
.IP purge\-config\ [*]
Remove configuration files from uninstalled packages.
.IP prep\ [*]
Feta uses several other programs to manipulate the package database. If some
of these programs are missing, Feta works fine, but with reduced
functionality. The prep command will install those missing packages.
.IP purge,\ \-p\ [*]
Remove packages given, every package that depends on them, and their configuration
files.
.IP recommends\ [*]
Install packages that any given packages recommend. In the case of a
virtual package, or multiple options, you will be prompted for which package
you want to install (if any).
.IP reinstall\ [*]
Reinstall a package, even if it is the same version.
.IP remove,\ \-r\ [*]
Remove packages given and every package that depends on them.
.IP remove\-override\ [*]
Remove a stat override on a file; this takes the same arguments as the
dpkg\-statoverride command. The concept behind a stat override is too
complicated to explain here, please read \fBdpkg\-statoverride\fR(8).
.IP repackage
Attempt to put together a .deb file of an installed package. This can be
dangerous, because it uses system-local configuration files from /etc if
the package contained files in /etc.
.IP show\-package
Show basic information about the package. This output is probably more
useful for scripts than people; look at the "info" command for more readable
output.
.IP search
Search package descriptions for the text given on the command line.
.IP select
Run the `dselect' program, which lets you interactively edit your package
selections.
.IP source
Download the source for packages given on the command line. This requires
APT to be configured to download source packages (which it usually is).
.IP status
Display the status of the packages. This provides much of the same information
as the info command, but also displays whether the package is installed or
uninstalled.
.IP suggests\ [*]
Install packages that any given packages suggest. In the case of a
virtual package, or multiple options, you will be prompted for which package
you want to install (if any).
.IP to\-upgrade
Show a list of packages that need to be upgraded, the version currently
installed, and the version available to install.
.IP to\-install
List packages that are marked for install.
.IP to\-purge
List packages that are marked to be purged.
.IP unhold\ [*]
Remove a hold on a package. The package will be upgraded during an upgrade
or dist\-upgrade command.
.IP update,\ \-u\ [*]
Update the list of packages available from Debian and third-party servers.
upgrade and dist\-upgrade will prompt you to do this, as well.
.IP upgrade\ [*]
Upgrade all the packages given on the command line, or all the packages on
the system if no explicit packages are given.
.IP version
Display version and copyright information about Feta.
.IP what\-is
Get a short description of the package, its size, and available versions
from the packages.debian.org server. This only works on official packages.
.IP which\-package
Show a list of all files in the given package, and a list of all packages
containing a file with that name. Unlike the contents or provides command,
this command queries the packages.debian.org server.
.PP
For compatibility with other packaging tools, there are other command names
not documented here. The ones listed above are guaranteed to continue to work,
and the undocumented ones may change in later versions of Feta.
.SH MULTIPLE COMMANDS
It is possible to run multiple commands in Feta using the same command line,
To do this, place a comma between the two commands. For example,
.PP
$ feta install package1, remove package2
.br
$ feta build\-dep package, build package
.SH ADVANCED SEARCHING
It is possible, if you have grep\-dctrl installed, for Feta to search packages
based on a specific field (e.g. Maintainer, Depends, or Version), and to only display
certain information about those packages. To do this, place the field you wish to
search for after the "search" or "info" command, followed by a colon. To search for all
packages that depend on fileutils, for example, use
.PP
$ feta search Depends: fileutils
angband
.br
angband\-doc
.br
aub
.br
c2man
.br
caudium\-php4
.br
 ... and so on.
.PP
You may also tell Feta to only display a certain field, by passing it a second field name after the search phrase.
For example, if you want a list of all the maintainers of packages that depend on fileutils:
.PP
$ feta search Depends: fileutils Maintainer:
.br
Adrian Bunk <bunk@fs.tum.de>
.br
Benjamin Hill (Mako) <mako@debian.org>
.br
Debian Policy List <debian\-policy@lists.debian.org>
.br
Herbert Xu <herbert@debian.org>
 ...
.SH THE FETA CONSOLE
Feta also has a command console that can be used, if Feta is given the
command "console". On the command console, any other commands can be
typed in. For example:
.PP
# feta console
.br
This is the Feta command console. You may interactively run any Feta command
from here. Feta will exit automatically on the first error, or when you type
the commands `quit' or `exit'.
.PP
> install fileutils
.br
(Process of installing fileutils)
.br
> dist\-upgrade
.br
(Process of dist\-upgrading)
.br
> purge tetex\-base
.br
(Process of purging tetex\-base)
.br
> exit
.br
#
.PP
The command console is useful if you wish to perform many operations
as a batch, since Feta can read from stdin using this method.
.PP
# feta \-x console < things_to_do.txt
.SH OTHER OPTIONS
Feta has several other options that translate directly into options for its
child programs. These options are not treated consistently across Feta, and
so are documented in a separate section. It is recommended that you read
the man pages for the program they affect to fully understand what the
options do.
.IP \-d
Download files only. This is most useful in conjunction with an upgrade or
a dist\-upgrade you want to download overnight but not install until you can
monitor it. This is analogous to the apt\-get \-\-download\-only option.
.IP \-m
Do not actually do anything with APT. Instead, simulate what would happen
if it was run. This is analogous to the apt\-get \-\-simulate option and
the dpkg \-\-no\-act option.
.SH AUTHOR
Joe Wreschnig <piman@debian.org> is the main author. All bug reports and
feature requests should go to him (via the Debian BTS -- 'feta bug feta').
.PP
The AUTHORS file, included with Feta, includes a complete list of
everyone who has donated code or time to Feta. Thanks!
.SH LICENSE
Feta is licensed under the GNU GPL v2 or later. Much of Feta's functionality
is provided by separate programs available under different licenses. Please
see the copyright and/or copyright.gz files in /usr/share/doc/\fIpackagename\fR
for more information. Feta's plugins may also be covered under a different
license, although most are under the GNU GPL as well.
.SH FILES
.IP /usr/local/{lib,share}/feta,\ /usr/{lib,share}/feta
Places to put plugins.
.IP /etc/apt/feta.prep
Created after Feta is run once, as part of the preparation installation.
.SH ENVIRONMENT
.IP FETA_OPTS
The contents of this variable get parsed as additional options to Feta; for
example, the string "oV" will make Feta enable sudo and verbose modes, in
addition to any options you pass.
.IP FETA_SELECT
This affects the program run by the 'feta select' command, which is
by default dselect(8). You can set it to any other program to run.
.SH SEE ALSO
\fBalien\fR(1),
\fBapt\-cache\fR(8),
\fBapt\-get\fR(8),
\fBdebfoster\fR(8),
\fBdeborphan\fR(1),
\fBdebsums\fR(1),
\fBdpkg\fR(8),
\fBdpkg\-deb\fR(8),
\fBdpkg\-reconfigure\fR(8),
\fBdpkg\-repack\fR(8),
\fBdpkg\-statoverride\fR(8),
\fBgrep\-dctrl\fR(1),
\fBreportbug\fR(1),
\fBsu\fR(1),
\fBsudo\fR(8),
\fBwget\fR(1).