PKGIN(1) BSD General Commands Manual PKGIN(1)NAMEpkgin — A tool to manage pkgsrc binary packages.
SYNOPSISpkgin [-dfFhPvVyn] [-l limit_chars] [-c chroot_path] command
[package ...]
DESCRIPTION
The pkgin command is aimed at being an apt / yum like tool for managing
pkgsrc binary packages. It relies on pkg_summary(5) for installation,
removal and upgrade of packages and associated dependencies, using a
remote repository.
OPTIONS
The following command line arguments are supported:
-d Download only.
-f Force database update.
-F Force package reinstall.
-h Displays help for the command.
-P Displays packages versions instead of globs (sd, sfd, srd)
-v Displays pkgin version
-V Be verbose when (un)installing
-y Assumes "yes" as default answer, except for autoremove.
-n Assumes "no" as default answer.
-l limit_chars
Only include the packages with the specified status flags.
-c chroot_path
Enable chrooting pkgin in the given repository
The pkgin utility provides several commands:
autoremove Automatically removes orphan dependencies.
avail Lists all packages available in the repository.
clean Delete downloaded packages from the cache directory.
package.
full-upgrade
Upgrade all packages to their newer versions present in the
repository.
install package ...
Performs installation or upgrade of package. If more than
one packages are specified on the command-line, all will be
installed (or upgraded).
keep package ...
Marks 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 pkgin upgrade. More than
one package can be specified on the command-line, to mark
several packages as non-removable in a single command.
list Lists all packages installed locally on a system. If the l
modifier is added to this command, show only packages match‐
ing the status flag.
remove package ...
Removes package as well as all packages depending on it.
When more than one package are specified, they will all be
uninstalled. By default, it will prompt you to confirm
before package removals.
search pattern
Performs a regular expression search for a pattern in the
repository.
show-deps Displays all direct dependencies for
show-full-deps package
Displays all direct dependencies recursively for package.
show-keep Display "non auto-removable" packages.
show-rev-deps package
Displays all reverse direct dependencies for package. If
more than one package is specified, pkgin will show recur‐
sively reverse direct dependencies for all packages on the
command-line.
unkeep package ...
Marks package as "auto-removable". If no other package
depends on it, it will be removed when using the autoremove
modifier.
update Creates and populates the initial database. Must be run
after the variable
upgrade Upgrade keepable packages to their newer versions present in
the repository. If the installed dependencies match the
listed needed dependencies, don't upgrade them.
STATUS FLAGS
When using the l flag along with the list command, the following status
flag must be set:
= The installed version of the package is current.
< The installed version of the package is older than the current
version.
> The installed version of the package is newer than the current
version.
ENVIRONMENT
PKG_REPOS
The PKG_REPOS environment variable can be pointed to a suitable
repository or a list of space separated repositories in order to
override /usr/pkg/etc/pkgin/repositories.conf
FILES
/usr/pkg/etc/pkgin/repositories.conf
This file contains a list of repositories that pkgin will use.
EXAMPLES
Setup the initial database:
# echo ftp://ftp.fr.netbsd.org/pub/pkgsrc/packages/NetBSD/i386/5.0/All > /usr/pkg/etc/pkgin/repositories.conf
# pkgin update
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%
Listing all packages available in the repository:
# pkgin avail | 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
[...]
Install packages and their dependencies:
# pkgin install 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]
Remove packages and their reverse dependencies:
# pkgin remove links eterm
2 packages to delete: links-2.2nb1 eterm-0.9.4nb1
proceed ? [y/N]
Remove orphan dependencies:
# pkgin autoremove
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]
SEE ALSOpkg_add(1), pkg_info(1), pkg_summary(5), pkgsrc(7)AUTHORS
Emile “iMil” Heitor
Initial work and ongoing development.
CONTRIBUTORS
Jeremy C. Reed
Testing and refinements.
Arnaud Ysmal
Tests and patches
Claude Charpentier
SQLite schema, and SQL queries debugging.
Guillaume Lasmayous
Man page
Antonio Huete Jimenez
DragonFly port
Min Sik Kim
Darwin port
Filip Hajny
SunOS port
Baptiste Daroussin
FreeBSD port and patches
Gautam B.T.
MINIX port
BUGS
Probably many to be found.
BSD Dec 6, 2009 BSD
