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.