NAME
dpkg-www - program to remotely open a WWW Debian package browser
SYNOPSIS
dpkg-www [-s|--stdout] [-h|--host host] [query]
DESCRIPTION
dpkg-www is used to remotely control a WEB browser and open a dpkg URL
on the local host from an interactive shell or script.
If the command is invoked while running under X-window the script will
try to find an installed X browser to open the specified URL. If not
running under X it will try to use a text browser instead.
If Netscape is found and a Netscape instance is already running it will
be asked to open the dpkg URL on localhost with the optional query
supplied on the command line. If there is no browser running, it will
start automatically a new one.
The functionality provided by this program is identical to running a
web browser with the -remote openURL(http://localhost/cgi-bin/dpkg)
argument or opening the same URL from within the browser.
dpkg-www-installer is an helper application which can configured in the
WWW browser for web installation. It should never be invoked directly
by the user.
OPTIONS
-s, --stdout
Redirect output to stdout. Requires one of the text browsers
(lynx, lynx-ssl or links) installed.
-h, --host host
Send the query to a remote host, where dpkg-www must be
installed.
query Specifies an optional package name, an absolute pathname or a
query argument which is passed to the dpkg cgi-bin. See dpkg-
www(8) for more information about the use of the cgi.
FILES
/etc/dpkg-www.conf
~/.dpkg-www
Configuration files for dpkg-www. It is not necessary for these
files to exist, there are sensible defaults for everything, but
you can specify your preferred www browser with the
DPKG_WWW_BROWSER variable, for example: DPKG_WWW_BROWSER=mozilla
EXAMPLES
dpkg-www
This would open a dpkg URL on localhost listing all the
installed packages.
dpkg-www bash
This would open a dpkg URL asking info on the bash package.
dpkg-www -h pisolo bash
This would open a dpkg URL asking info on the bash package on
host pisolo.
dpkg-www ’dpkg*’
This would open a dpkg URL listing all packages matching dpkg*.
dpkg-www /bin/bash
This would open a dpkg URL asking info on the package(s) owning
the file /bin/bash .
dpkg-www depends=svgalib
This would open a dpkg URL listing all packages depending on
svgalib.
dpkg-www --stdout depends=awk | grep ^ii
This would list on stdout all packages depending on awk and grep
all lines of installed packages.
SEE ALSO
dpkg(8), dpkg-www(8)
AUTHOR
Massimo Dal Zotto <dz@debian.org>.
Bugs should be reported via the normal Debian bug reporting system.
LICENCE
dpkg-www is licensed under the GNU General Public License version 2.
September 1, 2004