.\" $NetBSD: pkg_dry.1,v 1.0 2009/04/24 18:49:08 guigui2 Exp $
.\"
.\" View with following command: nroff -msafer -man pkg_dry.1 | more
.\"
.Dd April 24, 2009
.Dt PKG_DRY 1
.Os
.Sh NAME
.Nm pkg_dry
.Nd A tool to manage NetBSD binary packages.
.Sh SYNOPSIS
.Nm
.Op Fl hlaugGmcy
.Op Fl irkK Ar package Ar ...
.Op Fl sdtT Ar package
.Sh DESCRIPTION
The
.Nm
command (dry, as in "without pkgsrc") is aimed at being an apt / yum like tool for managing NetBSD binary packages. It relies on pkg_summary(5) for installation, removal and upgrade of packages and associated dependencies, using a remote repository.
.Sh OPTIONS
.Bl -tag -width indent
The following command line arguments are supported:
.It Fl h
Displays help for the command
.It Fl u
Creates and populates the initial database.
Must be run after the variable PKG_REPOS is valued to the appropriate repository.
.It Fl l
Lists all packages installed locally on a system.
.It Fl a
Lists all packages available in the repository.
.It Fl m
Automatically removes orphan dependencies.
.It Fl c
Delete downloaded packages from the cache directory.
.It Fl g
Upgrade keepable packages to their newer versions present in the repository. If the installed dependencies match the listed needed dependencies, don't upgrade them.
.It Fl G
Upgrade all packages to their newer versions present in the repository.
.It Fl y
Assumes "yes" as default answer, except for autoremove.
.It Fl s Ar package
Search for a package in the repository.
.It Fl d Ar package 
Displays all direct dependencies for
.Ar package . 
.It Fl t Ar package
Displays all direct dependencies recursively for
.Ar package .
.It Fl T Ar package 
Displays all reverse direct dependencies for 
.Ar package .
If more than one package is specified,
.Nm
will show recursively reverse direct dependencies for all packages on the command-line. 
.It Fl i Ar package Ar ...
Performs installation or upgrade of
.Ar package .
If more than one packages are specified on the command-line, all will be installed.
.It Fl r Ar package Ar ...
Removes
.Ar package
as well as all packages depending on it. When more than one package are specified, they will all be uninstalled.
.It Fl k Ar package Ar ...
Marks
.Ar package
as "non auto-removable". This means that a package that has, for instance, been compiled manually from pkgsrc, can't be removed through a 
.Nm
upgrade. More than one package can be specified on the command-line, to mark several packages as non-removable in a single command.
.It Fl K Ar package Ar ...
Marks
.Ar package
as "auto-removable". If no other package depends on it, it will be removed when using the autoremove modifier.
.El
.Sh ENVIRONMENT
.Bl -tag -width indent
.It Ev PKG_REPOS
The 
.Ev PKG_REPOS environment variable must be pointed to a suitable repository (where
.Nm
can find a pkg_summary file).
For instance, before using 
.Nm , 
do
.Bd -literal
export PKG_REPOS=ftp://ftp.fr.netbsd.org/pub/pkgsrc/packages/NetBSD/i386/5.0_2009Q1/All/
.Ed
.Ed
.Sh EXAMPLES
.Pp
Setup the initial database
.Bd -literal
# PKG_REPOS=ftp://ftp.fr.netbsd.org/pub/pkgsrc/packages/NetBSD/i386/5.0/All
# export PKG_REPOS
# pkg_dry -u
processing local summary...
updating database: 100%
downloading pkg_summary.bz2: 100%
processing remote summary (ftp://ftp.fr.netbsd.org/pub/pkgsrc/packages/NetBSD/i386/5.0/All)...
updating database: 100%
.Ed
.Pp
Listing all packages available in the repository: 
.Bd -literal
# pkg_dry -a | more
[...]
autoconf-2.63        Generates automatic source code configuration scripts
aumix-gtk-2.8nb3     Set mix levels (ncurses and GTK+ 2.0 interfaces)
aumix-2.8nb7         Set mix levels (ncurses interface only)
august-0.63b         Simple Tk-based HTML editor
audacity-1.2.6nb3    Audio editor
[...]
.Ed
.Pp
Install packages and their dependencies:
.Bd -literal
# pkg_dry -i links eterm
nothing to upgrade.
11 packages to be installed: tiff-3.8.2nb4 png-1.2.35 libungif-4.1.4nb1 libltdl-1.5.26 jpeg-6bnb4 pcre-7.8 perl-5.10.0nb5 libast-0.6.1nb3 imlib2-1.4.2nb1 links-2.2nb1 eterm-0.9.4nb1 (25M to download, 64M to install)
proceed ? [y/N]
.Ed
.Pp
Remove packages and their reverse dependencies:
.Bd -literal
# pkg_dry -r links eterm
2 packages to delete: links-2.2nb1 eterm-0.9.4nb1
proceed ? [y/N]
.Ed
.Pp
Remove orphan dependencies:
.Bd -literal
# pkg_dry -m
in order to remove packages from the autoremove list, flag those with the -k modifier.
9 packages to be autoremoved: libast-0.6.1nb3 pcre-7.8 imlib2-1.4.2nb1 tiff-3.8.2nb4 png-1.2.35 libungif-4.1.4nb1 libltdl-1.5.26 perl-5.10.0nb5 jpeg-6bnb4
proceed ? [y/N]
.Ed
.Pp
.Sh SEE ALSO
.Xr pkg_add 1 ,
.Xr pkg_info 1 ,
.Xr pkg_summary 5 ,
.Xr pkgsrc 7
.Sh AUTHORS
.Bl -tag -width indent -compact
.It Emile "iMil" Heitor
Initial work and ongoing development.
.El
.Sh CONTRIBUTORS
.Bl -tag -width indent -compact
.It Jeremy C Reed
Testing and refinements.
.It Arnaud Ysmal
Testing, testing, testing
.It Claude Charpentier
SQLite schema, and SQL queries debugging.
.It Guillaume Lasmayous
Man page
.It Antonio Huete Jimenez
DragonFly port
.It Min Sik Kim
Darwin port
.El
.Sh BUGS
Still many to be found.