PKG_SELECT(1)

NAME
pkg_select - curses based pkgsrc system browser / manager

SYNOPSIS
pkg_select [-b pkgsrcdir] [-K pkg_dbdir] [-c conf file] [-l] [-m] [-u NetBSD ftp mirror] [-d download url] [-s]

DESCRIPTION
pkg_select will display a curses file browser for the pkg system. You can browse pkgsrc and gather various informations about packages, like available version, installed version, comment and homepage. A simple paging system lets you read information files. You can browse both installed and uninstalled packages, as well as dependencies list and perform various administrative tasks to them. A package finder system helps you to easily locate a package by its name. pkg_select can handle either source or binary installations from local pkgsrc, local binary packages directory (see PACKAGES environment variable below), or binary only when using the pkgsrc-over-ftp feature.

Also, if no pkgsrc is installed, pkg_select offers ability fo fetch it by FTP, CVS or directory copy. It is also possible to update an existing pkgsrc via the interface.

pkg_select user interface is quite self explainatory, every available shortcut is shown and annotated.

OPTIONS
The following options are available:

-b pkgsrcdir
    Set pkgsrcdir as the pkgsrc base directory. Default is set to /usr/pkgsrc

-K pkg_dbdir
    Set pkg_dbdir as the package database directory. Default is set to /usr/pkg/pkgdb

-c conf file
    Set conf file as the configuration file. Default is set to /usr/pkg/etc/pkg_select.conf

-l  Enable pkgsrc over FTP (don't need pkgsrc to be installed)

-m  Do not read Makefiles when browsing pkgsrc over FTP

-u NetBSD ftp mirror
    Defines a NetBSD ftp mirror for live pkgsrc-over-FTP

-d url
    Set url as the pkgsrc tree download url. url can be one of

    ftp://ftp.mirror.NetBSD.org/pub/NetBSD
    cvs://[:pserver:]anoncvs@anoncvs.mirror.NetBSD.org:/cvsroot
    file:///some/path

-s  Force shell output instead of curses progress bars

ENVIRONMENT
PKGSRCDIR
    If set, this variable changes pkgsrc base directory to PKGSRCDIR. Default is set to /usr/pkgsrc
PKG_DBDIR
    If set, this variable changes the package database directory path. Default is set to /usr/pkg/pkgdb
PACKAGES
    If set, pkg_select fallback to binary mode, pkgsrc hierarchy will be build from packages found in PACKAGES. In binary mode, it is also possible to install system base archives, just copy archives (base.tgz, comp.tgz...) to PACKAGES and a new system category will appear on the category list.

FILES
/usr/pkg/etc/pkg_select.conf
/usr/pkg/share/examples/pkg_select/pkg_select.conf.example
/usr/pkg/share/pkg_select/mirrors.ftp
/usr/pkg/share/pkg_select/mirrors.cvs

NOTES
When manipulating packages, pkg_select obviously needs to be ran as root.

SEE ALSO
pkg_add(1), pkg_delete(1), packages(7), and make(1)

AUTHOR
iMil <imil@gcu.info>