From 373df1415042cfdb539d7df39f1aa9bb6ffd25bd Mon Sep 17 00:00:00 2001 From: Ben Gras Date: Mon, 19 Jul 2010 10:47:11 +0000 Subject: [PATCH] pkg_install: these manpages were moved to man. --- commands/pkg_install/lib/pkg_install.conf.5 | 215 --------------- commands/pkg_install/lib/pkg_summary.5 | 133 ---------- commands/pkg_install/lib/pkgsrc.7 | 54 ---- commands/pkg_install/view/linkfarm.1 | 148 ----------- commands/pkg_install/view/pkg_view.1 | 276 -------------------- 5 files changed, 826 deletions(-) delete mode 100644 commands/pkg_install/lib/pkg_install.conf.5 delete mode 100644 commands/pkg_install/lib/pkg_summary.5 delete mode 100644 commands/pkg_install/lib/pkgsrc.7 delete mode 100644 commands/pkg_install/view/linkfarm.1 delete mode 100644 commands/pkg_install/view/pkg_view.1 diff --git a/commands/pkg_install/lib/pkg_install.conf.5 b/commands/pkg_install/lib/pkg_install.conf.5 deleted file mode 100644 index 5cc6b5719..000000000 --- a/commands/pkg_install/lib/pkg_install.conf.5 +++ /dev/null @@ -1,215 +0,0 @@ -.\" $NetBSD: pkg_install.conf.5.in,v 1.14 2010/06/16 23:02:49 joerg Exp $ -.\" -.\" Copyright (c) 2008, 2009 The NetBSD Foundation, Inc. -.\" All rights reserved. -.\" -.\" This code is derived from software contributed to The NetBSD Foundation -.\" by Thomas Klausner. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS -.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED -.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR -.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS -.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR -.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF -.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS -.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN -.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) -.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE -.\" POSSIBILITY OF SUCH DAMAGE. -.\" -.Dd June 16, 2010 -.Dt PKG_INSTALL.CONF 5 -.Os -.Sh NAME -.Nm pkg_install.conf -.Nd configuration file for package installation tools -.Sh DESCRIPTION -The file -.Nm -contains system defaults for the package installation tools -as a list of variable-value pairs. -Each line has the format -.Ev VARIABLE=VALUE . -If the value consists of more than one line, each line is prefixed with -.Ev VARIABLE= . -.Pp -The current value of a variable can be checked by running -.Dl Ic pkg_admin config-var VARIABLE -.Pp -Some variables are overriden by environmental variables of the same name. -Those are marked by (*). -.Pp -The following variables are supported: -.Bl -tag -width indent -.It Dv ACCEPTABLE_LICENSES -List of licenses packages are allowed to carry. -License names are case-sensitive. -.It Dv ACTIVE_FTP -Force the use of active FTP. -.It Dv CACHE_INDEX -Cache directory listenings in memory. -This avoids retransfers of the large directory index for HTTP and is -enabled by default. -.It Dv CERTIFICATE_ANCHOR_PKGS -Path to the file containing the certificates used for validating -binary packages. -A package is trusted when a certificate chain ends in one of the -certificates contained in this file. -The certificates must be PEM-encoded. -.It Dv CERTIFICATE_ANCHOR_PKGVULN -Analogous to -.Dv CERTIFICATE_ANCHOR_PKGS . -The -.Pa pkg-vulnerabilities -is trusted when a certificate chain ends in one of the certificates -contained in this file. -.It Dv CERTIFICATE_CHAIN -Path to a file containing additional certificates that can be used -for completing certificate chains when validating binary packages or -pkg-vulnerabilities files. -.It Dv CHECK_LICENSE -Check the license conditions of packages before installing them. -Supported values are: -.Bl -tag -width interactiveXX -.It Dv no -The check is not performed. -.It Dv yes -The check is performed if the package has license conditions set. -.It Dv always -Passing the license check is required. -Missing license conditions are considered an error. -.El -.It Dv CHECK_END_OF_FILE -During vulnerability checks, consider packages that have reached end-of-life -as vulnerable. -This option is enabled by default. -.It Dv CHECK_VULNERABILITIES -Check for vulnerabilities when installing packages. -Supported values are: -.Bl -tag -width interactiveXX -.It Dv never -No check is performed. -.It Dv always -Passing the vulnerability check is required. -A missing pkg-vulnerabilities file is considered an error. -.It Dv interactive -The user is always asked to confirm installation of vulnerable packages. -.El -.It Dv CONFIG_CACHE_CONNECTIONS -Limit the global connection cache to this value. -For FTP this is the number of sessions without active command. -For HTTP this is the number of connections open with keep-alive. -.It Dv CONFIG_CACHE_CONNECTIONS_HOST -Like -.Dv CONFIG_CACHE_CONNECTIONS , -but limit the number of connections to the host as well. -See -.Xr fetch 3 -for further details -.It Dv DEFAULT_ACCEPTABLE_LICENSES -List of common Free and Open Source licenses packages are allowed to carry. -The default value contains all OSI approved licenses in pkgsrc on the date -pkg_install was released. -License names are case-sensitive. -.It Dv GPG -Path to -.Xr gpg 1 , -which can be used to verify the signature in the -.Pa pkg-vulnerabilities -file when running -.Dl Ic pkg_admin check-pkg-vulnerabilities -s -or -.Dl Ic pkg_admin fetch-pkg-vulnerabilities -s -It can also be used to verify and sign binary packages. -.It Dv GPG_KEYRING_PKGVULN -Non-default keyring to use for verifying GPG signatures of -.Pa pkg-vulnerabilities . -.It Dv GPG_KEYRING_SIGN -Non-default keyring to use for signing packages with GPG. -.It Dv GPG_KEYRING_VERIFY -Non-default keyring to use for verifying GPG signature of packages. -.It Dv GPG_SIGN_AS -User-id to use for signing packages. -.It Dv IGNORE_PROXY -Use direct connections and ignore -.Ev FTP_PROXY -and -.Ev HTTP_PROXY . -.It Dv IGNORE_URL -One line per advisory which should be ignored when running -.Dl Ic pkg_admin audit -The URL from the -.Pa pkg-vulnerabilities -file should be used as value. -.It Dv PKG_DBDIR (*) -Location of the packages database. -This option is always overriden by the argument of the -.Fl K -option. -.It Dv PKG_PATH (*) -Search path for packages. -The entries are separated by semicolon. -Each entry specifies a directory or URL to search for packages. -.It Dv PKG_REFCOUNT_DBDIR (*) -Location of the package reference counts database directory. -The default value is -.Pa ${PKG_DBDIR}.refcount . -.It Dv PKGVULNDIR -Directory name in which the -.Pa pkg-vulnerabilities -file resides. -Default is -.Pa ${PKG_DBDIR} . -.It Dv PKGVULNURL -URL which is used for updating the local -.Pa pkg-vulnerabilities -file when running -.Dl Ic pkg_admin fetch-pkg-vulnerabilities -The default location is ftp.NetBSD.org using HTTP. -.Em Note : -Usually, only the compression type should be changed. -Currently supported are uncompressed files and files compressed by -.Xr bzip2 1 -.Pq Pa .bz2 -or -.Xr gzip 1 -.Pq Pa .gz . -.It Dv VERBOSE_NETIO -Log details of network IO to stderr. -.It Dv VERIFIED_INSTALLATION -Set trust level used when installation. -Supported values are: -.Bl -tag -width interactiveXX -.It Dv never -No signature checks are performed. -.It Dv always -A valid signature is required. -If the binary package can not be verified, the installation is terminated -.It Dv trusted -A valid signature is required. -If the binary package can not be verified, the user is asked interactively. -.It Dv interactive -The user is always asked interactively when installing a package. -.El -.El -.Sh FILES -.Bl -tag -width ".Pa /etc/pkg_install.conf" -.It Pa /etc/pkg_install.conf -Default location for the file described in this manual page. -.El -.Sh SEE ALSO -.Xr pkg_add 1 , -.Xr pkg_admin 1 -.Xr pkg_create 1 , -.Xr pkg_delete 1 , -.Xr pkg_info 1 diff --git a/commands/pkg_install/lib/pkg_summary.5 b/commands/pkg_install/lib/pkg_summary.5 deleted file mode 100644 index 08aece1c2..000000000 --- a/commands/pkg_install/lib/pkg_summary.5 +++ /dev/null @@ -1,133 +0,0 @@ -.\" $NetBSD: pkg_summary.5,v 1.9 2009/05/02 16:14:37 reed Exp $ -.\" -.\" Copyright (c) 2006 The NetBSD Foundation -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. Neither the name of the NetBSD Foundation nor the names of its -.\" contributors may be used to endorse or promote products derived from -.\" this software without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION AND ITS CONTRIBUTORS -.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT -.\" NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND -.\" FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT -.\" SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, -.\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES -.\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.Dd April 11, 2009 -.Dt PKG_SUMMARY 5 -.Os -.Sh NAME -.Nm pkg_summary -.Nd summary of binary package repository -.Sh DESCRIPTION -The file -.Nm -contains information about each package in a binary package -repository as a list of variable-value pairs. -The variables describing different packages are separated by one empty -line. -Each line has the format -.Ev VARIABLE=VALUE . -If the value consists of more than one line, each line is prefixed with -.Ev VARIABLE= . -Multi-line variables are guaranteed to be in consecutive lines. -.Pp -The following variables are used: -.Bl -tag -width indent -.It Ev BUILD_DATE -(required) The date and time when the package was built. -.It Ev CATEGORIES -(required) A list of categories which this package fits in, separated by -space. -.It Ev COMMENT -(required) A one-line description of the package. -.It Ev CONFLICTS -(optional) A list of dewey patterns of packages the package conflicts -with, one per line. -If missing, this package has no conflicts. -.It Ev DEPENDS -(optional) A list of dewey patterns of packages the package depends -on, one per line. -If missing, this package has no dependencies. -.It Ev DESCRIPTION -(required) A more detailed description of the package. -.\" DIGEST -.It Ev FILE_NAME -(optional) The name of the binary package file. -If not given, -.Pa PKGNAME.tgz -can be assumed. -.It Ev FILE_SIZE -(optional) The size of the binary package file, in bytes. -.It Ev HOMEPAGE -(optional) A URL where more information about the package can be found. -.It Ev LICENSE -(optional) The type of license this package is distributed under. -If empty or missing, it is OSI-approved. -.It Ev MACHINE_ARCH -(required) The architecture on which the package was compiled. -.It Ev OPSYS -(required) The operating system on which the package was compiled. -.It Ev OS_VERSION -(required) The version of the operating system on which the package -was compiled. -.It Ev PKG_OPTIONS -(optional) Any options selected to compile this package. -If missing, the package does not support options. -.It Ev PKGNAME -(required) The name of the package. -.It Ev PKGPATH -(required) The path of the package directory within pkgsrc. -.It Ev PKGTOOLS_VERSION -(required) The version of the package tools used to create the package. -.It Ev PREV_PKGPATH -(optional) The previous path of the package directory within pkgsrc when -a package was moved. -(See -.Ev SUPERSEDES -below for a renamed package.) -.It Ev PROVIDES -(optional) A list of shared libraries provided by the package, -including major version number, one per line. -If missing, this package does not provide shared libraries. -.It Ev REQUIRES -(optional) A list of shared libraries needed by the package, including -major version number, one per line. -If missing, this package does not require shared libraries. -.It Ev SIZE_PKG -(required) The size of the package when installed, in bytes. -.It Ev SUPERSEDES -(optional) A list of dewey patterns of previous packages this -package replaces, one per line. -This is used for package renaming. -.El -.Pp -The -.Nm pkg_summary -file can be generated using the -.Xr pkg_info 1 -.Fl X -option. -For example, the following will list this data for all installed packages: -.Pp -.Dl "pkg_info -X -a" -.Sh SEE ALSO -.Xr pkg_info 1 -.Sh HISTORY -The -.Nm pkg_summary -format was first officially documented in April 2006. diff --git a/commands/pkg_install/lib/pkgsrc.7 b/commands/pkg_install/lib/pkgsrc.7 deleted file mode 100644 index 86d3408b7..000000000 --- a/commands/pkg_install/lib/pkgsrc.7 +++ /dev/null @@ -1,54 +0,0 @@ -.\" $NetBSD: pkgsrc.7,v 1.2 2007/10/07 12:59:14 kano Exp $ -.\" -.\" Copyright (c) 2007 The NetBSD Foundation, Inc. -.\" All rights reserved. -.\" -.\" This code is derived from software contributed to The NetBSD Foundation -.\" by Thomas Klausner. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS -.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED -.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR -.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS -.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR -.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF -.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS -.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN -.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) -.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE -.\" POSSIBILITY OF SUCH DAMAGE. -.\" -.Dd March 2, 2007 -.Dt PKGSRC 7 -.Os -.Sh NAME -.Nm pkgsrc -.Nd NetBSD packages collection (framework for third-party software) -.Sh DESCRIPTION -The -.Nx -Packages Collection (pkgsrc) is a framework for building and -maintaining third-party software on -.Nx -and other -.Ux Ns -like -systems. -It is used to enable freely available software to be configured -and built easily on supported platforms. -.Pp -Tools are available to install ready-to-use packages and to perform -various administrative tasks for the package system. -.Sh SEE ALSO -.Xr pkg_add 1 , -.Xr pkg_delete 1 , -.Xr pkg_info 1 , -.Pa http://www.netbsd.org/docs/pkgsrc/ diff --git a/commands/pkg_install/view/linkfarm.1 b/commands/pkg_install/view/linkfarm.1 deleted file mode 100644 index a219670bd..000000000 --- a/commands/pkg_install/view/linkfarm.1 +++ /dev/null @@ -1,148 +0,0 @@ -.\" $NetBSD: linkfarm.1,v 1.6 2009/02/08 23:11:56 wiz Exp $ -.\" -.\" Copyright (c) 2003 The NetBSD Foundation, Inc. -.\" All rights reserved. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the NetBSD -.\" Foundation, Inc. and its contributors. -.\" 4. Neither the name of The NetBSD Foundation nor the names of its -.\" contributors may be used to endorse or promote products derived -.\" from this software without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS -.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED -.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR -.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS -.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR -.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF -.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS -.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN -.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) -.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE -.\" POSSIBILITY OF SUCH DAMAGE. -.\" -.Dd September 2, 2003 -.Dt LINKFARM 1 -.Os -.Sh NAME -.Nm linkfarm -.Nd manage symbolic links to package files -.Sh SYNOPSIS -.Nm -.Op Fl cDnRVv -.Op Fl d Ar stowdir -.Op Fl s Ar subdir -.Op Fl t Ar target -.Ar package -.Sh DESCRIPTION -The -.Nm -command is used to manage a "linkfarm", a directory tree of symbolic links in -.Ar target -to the files in the -.Ar package -sub-directory of -.Ar stowdir . -The default action is to create a linkfarm to a package. -.Pp -The following command-line options are supported: -.Bl -tag -width indent -.It Fl c -Check whether a package contains a linkfarm in -.Ar target . -If -.Ar package -has no symbolic links in -.Ar target -that correspond to its files, then return 0, otherwise return 1. -.It Fl D -Delete the linkfarm for -.Ar package . -.It Fl d Ar stowdir -Set -.Ar stowdir -as the directory in which -.Ar package -can be found. -The default -.Ar stowdir -is the -.Pa packages -sub-directory in the default -.Ar target -directory. -.It Fl n -Don't actually execute the commands for removing and creating the symbolic -links and directories. -.It Fl R -Delete and re-create the linkfarm for -.Ar package . -.It Fl s Ar subdir -The root of the package hierarchy for the linkfarm is the -.Ar subdir -sub-directory in the package. -By default, assume the root of the package hierarchy is simply the -.Ar package -directory. -.It Fl t Ar target -Set -.Ar target -as the directory in which to create and delete the linkfarm for -.Ar package . -The default -.Ar target -directory is -.Pa /usr/pkg -but may be overridden by the -.Ev LOCALBASE -environment variable. -.It Fl V -Print version number and exit. -.It Fl v -Turn on verbose output. -Specifying -.Fl v -multiple times increases the level of verbosity. -.El -.Sh ENVIRONMENT -.Bl -tag -width indent -.It Ev LOCALBASE -The standard packages directory, -.Pa /usr/pkg , -can be overridden by specifying an alternative directory in the -.Ev LOCALBASE -environment variable. -This affects the default -.Ar target -and -.Ar stowdir -directories. -.It Ev PLIST_IGNORE_FILES -This can be used to specify files in -.Ar package -that should ignored when creating and deleting symbolic links in -.Ar target . -.Ev PLIST_IGNORE_FILES -is a space-separated list of shell glob patterns that match files relative -to the -.Ar package -directory, and it defaults to "info/dir *[~#] *.OLD *.orig *,v". -.El -.Sh SEE ALSO -.Xr lndir 1 , -.Xr pkg_view 1 -.Sh AUTHORS -The -.Nm -utility was written by -.An Alistair G. Crooks Aq agc@NetBSD.org . diff --git a/commands/pkg_install/view/pkg_view.1 b/commands/pkg_install/view/pkg_view.1 deleted file mode 100644 index 376dd79a1..000000000 --- a/commands/pkg_install/view/pkg_view.1 +++ /dev/null @@ -1,276 +0,0 @@ -.\" $NetBSD: pkg_view.1,v 1.13 2010/01/22 13:30:42 joerg Exp $ -.\" -.\" Copyright (c) 2003 The NetBSD Foundation, Inc. -.\" All rights reserved. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the NetBSD -.\" Foundation, Inc. and its contributors. -.\" 4. Neither the name of The NetBSD Foundation nor the names of its -.\" contributors may be used to endorse or promote products derived -.\" from this software without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS -.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED -.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR -.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS -.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR -.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF -.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS -.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN -.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) -.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE -.\" POSSIBILITY OF SUCH DAMAGE. -.\" -.Dd September 8, 2003 -.Dt PKG_VIEW 1 -.Os -.Sh NAME -.Nm pkg_view -.Nd add and delete instances of depoted packages in views -.Sh SYNOPSIS -.Nm -.Op Fl nVv -.Op Fl d Ar stowdir -.Op Fl i Ar ignore -.Op Fl k Ar pkg_dbdir -.Op Fl W Ar viewbase -.Op Fl w Ar view -.Ar command -.Ar package ... -.Sh DESCRIPTION -The -.Nm -command is used to add and delete instances of depoted packages in -.Ar stowdir -in a -.Ar view -in the -.Ar viewbase -directory. -.Sh WARNING -.Bf -emphasis -Since the -.Nm -command may execute scripts or programs provided by a package file, -your system may be susceptible to -.Dq Trojan horses -or other subtle -attacks from miscreants who create dangerous package files. -.Pp -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 -.Pa ( /usr/pkg/packages/\*[Lt]pkg-name\*[Gt]/ ) . -Pay particular attention to any -.Pa +INSTALL -or -.Pa +DEINSTALL -files, and inspect the -.Pa +CONTENTS -file for -.Cm @cwd , -.Cm @mode -(check for setuid), -.Cm @dirrm , -.Cm @exec , -and -.Cm @unexec -directives, and/or use the -.Xr pkg_info 1 -command to examine the installed package control files. -.Ef -.Sh OPTIONS -The following command-line options are supported: -.Bl -tag -width indent -.It Fl d Ar stowdir -Set -.Ar stowdir -as the directory in which the depoted packages can be found. -If this option isn't specified, then the -.Ar stowdir -is taken from the value of the environment variable -.Ev DEPOTBASE -if it's set, otherwise the default -.Ar stowdir -is the path to the -.Pa packages -directory under -.Ar viewbase . -.It Fl i Ar ignore -Add -.Ar ignore -to the list of files in -.Ar package -that should ignored when adding or removing the package instance from -.Ar view . -.It Fl k Ar pkg_dbdir -Override the value of the -.Dv PKG_DBDIR -configuration option with the value -.Ar pkg_dbdir . -This is used as as the package database directory for the -default (empty) view. -.It Fl n -Don't actually execute the commands for manipulating the package instances. -.It Fl V -Print the version number and exit. -.It Fl v -Turn on verbose output. -Specifying -.Fl v -multiple times increases the level of verbosity. -.It Fl W Ar viewbase -Set -.Ar viewbase -as the directory in which all the views are managed. -The default -.Ar viewbase -directory is -.Pa /usr/pkg -but may be overridden by the -.Ev LOCALBASE -environment variable. -.It Fl w Ar view -Set -.Ar view -as the directory in -.Ar viewbase -in which the package instances should be added or deleted. -The default -.Ar view -is the empty view but may be overridden by the -.Ev PKG_VIEW -environment variable. -.El -.Pp -The following commands are supported: -.Bl -tag -width indent -.It Cm add -Add the listed package instances into -.Ar view . -.It Cm check -Check whether the listed package instances are present in -.Ar view . -If they are not present, then return 0, otherwise return 1. -.It Cm delete -Delete the listed package instances from -.Ar view . -.El -.Sh ENVIRONMENT -.Bl -tag -width indent -.It Ev DEPOTBASE -This is the location of the -.Ar stowdir -directory inside which all depoted packages are kept. -The default -.Ar stowdir -is the -.Pa packages -directory under -.Ar viewbase . -.It Ev LOCALBASE -This is the location of the -.Ar viewbase -directory in which all the views are managed. -The default -.Ar viewbase -directory is -.Pa /usr/pkg . -.It Ev PKG_DBDIR -If the -.Fl k -flag isn't given, then the value of the environment variable -.Ev PKG_DBDIR -is the package database directory for the default view, -otherwise it defaults to -.Pa /var/db/pkg . -.It Ev PLIST_IGNORE_FILES -This can be used to specify files in -.Ar package -that should ignored when adding or removing the package instance from -.Ar view . -.Ev PLIST_IGNORE_FILES -is a space-separated list of shell glob patterns that match files relative -to the -.Ar package -depot directory, and it defaults to "info/dir *[~#] *.OLD *.orig *,v". -This is overridden by any -.Ev _PLIST_IGNORE_FILES -setting in a package's -.Ar build-info-file -(see -.Xr pkg_create 1 ) -if it exists. -.It Ev PKG_VIEW -The default view can be specified in the -.Ev PKG_VIEW -environment variable. -.El -.Sh FILES -.Bl -tag -width indent -.It Pa \*[Lt]pkg-dbdir\*[Gt]/\*[Lt]package\*[Gt]/+INSTALL -If the package contains an -.Ar install -script (see -.Xr pkg_create 1 ) , -then after the package instance is added into a view, the script is -executed with the following arguments: -.Bl -tag -width package -.It Ar package -The name of the package instance being added. -.It Cm VIEW-INSTALL -Keyword denoting that the script is to perform any actions needed after -the package instance is added to a view. -.El -.Pp -If the -.Ar install -script exits with a non-zero status code, the installation is terminated. -.It Pa \*[Lt]pkg-dbdir\*[Gt]/\*[Lt]package\*[Gt]/+DEINSTALL -If the package contains an -.Ar deinstall -script (see -.Xr pkg_create 1 ) , -then before the package instance is deleted from a view, the script is -executed with the following arguments: -.Bl -tag -width package -.It Ar package -The name of the package instance being deleted. -.It Cm VIEW-DEINSTALL -Keyword denoting that the script is to perform any actions needed before -the package instance is deleted from a view. -.El -.Pp -If the -.Ar deinstall -script exits with a non-zero status code, the de-installation is terminated. -.El -.Pp -The -.Ar install -and -.Ar deinstall -scripts are called with the environment variable -.Ev PKG_PREFIX -set to the path to the -.Ar view -directory. -.Sh SEE ALSO -.Xr linkfarm 1 , -.Xr pkg_delete 1 -.Sh AUTHORS -The -.Nm -utility was written by -.An Alistair G. Crooks Aq agc@NetBSD.org . -- 2.44.0