Minix Man Pages

home | help
PKG_VIEW(1)               BSD General Commands Manual              PKG_VIEW(1)

NAME
     pkg_view -- add and delete instances of depoted packages in views

SYNOPSIS
     pkg_view [-nVv] [-d stowdir] [-i ignore] [-k pkg_dbdir] [-W viewbase]
              [-w view] command package ...

DESCRIPTION
     The pkg_view command is used to add and delete instances of depoted
     packages in stowdir in a view in the viewbase directory.

WARNING
     Since the pkg_view command may execute scripts or programs provided by a
     package file, your system may be susceptible to "Trojan horses" or other
     subtle attacks from miscreants who create dangerous package files.

     You are advised to verify the competence and identity of those who
     provide installable package files.  For extra protection, examine all the
     package control files in the package database directory
     (/usr/pkg/packages/_pkg-name_/).  Pay particular attention to any
     +INSTALL or +DEINSTALL files, and inspect the +CONTENTS file for @cwd,
     @mode (check for setuid), @dirrm, @exec, and @unexec directives, and/or
     use the pkg_info(1) command to examine the installed package control
     files.

OPTIONS
     The following command-line options are supported:

     -d stowdir
             Set stowdir as the directory in which the depoted packages can be
             found.  If this option isn't specified, then the stowdir is taken
             from the value of the environment variable DEPOTBASE if it's set,
             otherwise the default stowdir is the path to the packages
             directory under viewbase.

     -i ignore
             Add ignore to the list of files in package that should ignored
             when adding or removing the package instance from view.

     -k pkg_dbdir
             Override the value of the PKG_DBDIR configuration option with the
             value pkg_dbdir.  This is used as as the package database
             directory for the default (empty) view.

     -n      Don't actually execute the commands for manipulating the package
             instances.

     -V      Print the version number and exit.

     -v      Turn on verbose output.  Specifying -v multiple times increases
             the level of verbosity.

     -W viewbase
             Set viewbase as the directory in which all the views are managed.
             The default viewbase directory is /usr/pkg but may be overridden
             by the LOCALBASE environment variable.

     -w view
             Set view as the directory in viewbase in which the package
             instances should be added or deleted.  The default view is the
             empty view but may be overridden by the PKG_VIEW environment
             variable.

     The following commands are supported:

     add     Add the listed package instances into view.

     check   Check whether the listed package instances are present in view.
             If they are not present, then return 0, otherwise return 1.

     delete  Delete the listed package instances from view.

ENVIRONMENT
     DEPOTBASE
             This is the location of the stowdir directory inside which all
             depoted packages are kept.  The default stowdir is the packages
             directory under viewbase.

     LOCALBASE
             This is the location of the viewbase directory in which all the
             views are managed.  The default viewbase directory is /usr/pkg.

     PKG_DBDIR
             If the -k flag isn't given, then the value of the environment
             variable PKG_DBDIR is the package database directory for the
             default view, otherwise it defaults to /var/db/pkg.

     PLIST_IGNORE_FILES
             This can be used to specify files in package that should ignored
             when adding or removing the package instance from view.
             PLIST_IGNORE_FILES is a space-separated list of shell glob
             patterns that match files relative to the package depot
             directory, and it defaults to "info/dir *[~#] *.OLD *.orig *,v".
             This is overridden by any _PLIST_IGNORE_FILES setting in a
             package's build-info-file (see pkg_create(1)) if it exists.

     PKG_VIEW
             The default view can be specified in the PKG_VIEW environment
             variable.

FILES
     <pkg-dbdir>/<package>/+INSTALL
             If the package contains an install script (see pkg_create(1)),
             then after the package instance is added into a view, the script
             is executed with the following arguments:

             package  The name of the package instance being added.

             VIEW-INSTALL
                      Keyword denoting that the script is to perform any
                      actions needed after the package instance is added to a
                      view.

             If the install script exits with a non-zero status code, the
             installation is terminated.

     <pkg-dbdir>/<package>/+DEINSTALL
             If the package contains an deinstall script (see pkg_create(1)),
             then before the package instance is deleted from a view, the
             script is executed with the following arguments:

             package  The name of the package instance being deleted.

             VIEW-DEINSTALL
                      Keyword denoting that the script is to perform any
                      actions needed before the package instance is deleted
                      from a view.

             If the deinstall script exits with a non-zero status code, the
             de-installation is terminated.

     The install and deinstall scripts are called with the environment
     variable PKG_PREFIX set to the path to the view directory.

SEE ALSO
     linkfarm(1), pkg_delete(1)

AUTHORS
     The pkg_view utility was written by Alistair G. Crooks <agc@NetBSD.org>.

BSD                            September 8, 2003                           BSD
NAME | SYNOPSIS | DESCRIPTION | WARNING | OPTIONS | ENVIRONMENT | FILES | SEE ALSO | AUTHORS