summaryrefslogtreecommitdiff
path: root/pkgtools/pkg_install
diff options
context:
space:
mode:
authorjoerg <joerg@pkgsrc.org>2010-01-30 21:35:08 +0000
committerjoerg <joerg@pkgsrc.org>2010-01-30 21:35:08 +0000
commitffb3760dc894528292dbe6bf22da4c12bf5d21fa (patch)
treecbf56f09dae476829dfb6fc8904afa3d8e8df57c /pkgtools/pkg_install
parent79700365000ec2d5dd648cbee5b5bc2e197f4e08 (diff)
downloadpkgsrc-ffb3760dc894528292dbe6bf22da4c12bf5d21fa.tar.gz
G/C left over.
Diffstat (limited to 'pkgtools/pkg_install')
-rw-r--r--pkgtools/pkg_install/files/delete/pkg_delete.1.in316
1 files changed, 0 insertions, 316 deletions
diff --git a/pkgtools/pkg_install/files/delete/pkg_delete.1.in b/pkgtools/pkg_install/files/delete/pkg_delete.1.in
deleted file mode 100644
index a5da620da20..00000000000
--- a/pkgtools/pkg_install/files/delete/pkg_delete.1.in
+++ /dev/null
@@ -1,316 +0,0 @@
-.\" $NetBSD: pkg_delete.1.in,v 1.1 2010/01/21 21:58:06 jmmv Exp $
-.\"
-.\" FreeBSD install - a package for the installation and maintenance
-.\" of non-core utilities.
-.\"
-.\" 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.
-.\"
-.\" Jordan K. Hubbard
-.\"
-.\"
-.\" from FreeBSD: @(#)pkg_delete.1
-.\"
-.Dd January 20, 2010
-.Dt PKG_DELETE 1
-.Os
-.Sh NAME
-.Nm pkg_delete
-.Nd a utility for deleting previously installed software package distributions
-.Sh SYNOPSIS
-.Nm
-.Op Fl ADFfkNnORrVv
-.Bk -words
-.Op Fl K Ar pkg_dbdir
-.Ek
-.Bk -words
-.Op Fl P Ar destdir
-.Op Fl p Ar prefix
-.Ek
-.Ar pkg-name ...
-.Sh DESCRIPTION
-The
-.Nm
-command is used to delete packages that have been previously installed
-with the
-.Xr pkg_add 1
-command.
-The given packages are sorted, so that the dependencies of a package
-are deleted after the package.
-Before any action is executed,
-.Nm
-checks for packages that are marked as
-.Cm preserved
-or have depending packages left.
-If the
-.Fl k
-flag is given, preserved packages are removed from the list of packages
-to remove.
-Unless the
-.Fl f
-flag is given,
-.Nm
-stops on the first error.
-.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 record directory
-.Pa ( @pkgdbdir@/\*[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 Ar pkg-name ...
-The named packages are deinstalled, wildcards can be used, see
-.Xr pkg_info 1 .
-If no version is given, the one currently installed
-will be removed.
-If the
-.Fl F
-flag is given, one or more (absolute) filenames may be specified and
-the Package Database will be consulted for the package to which the
-given file belongs.
-These packages are then deinstalled.
-.It Fl A
-Recursively remove all automatically installed packages that were needed
-by the given packages and are no longer required.
-See also the
-.Fl R
-flag.
-.It Fl D
-If a deinstallation script exists for a given package, do not execute it.
-.It Fl F
-Any pkg-name given will be interpreted as pathname which is
-subsequently transformed in a (real) package name via the Package
-Database.
-That way, packages can be deleted by giving a filename
-instead of the package-name.
-.It Fl f
-Force removal of the package, even if a dependency is recorded or the
-deinstall script fails.
-.It Fl ff
-Force removal of the package, even if the package is marked as a
-.Cm preserved
-package.
-Note that this is a dangerous operation.
-See also the
-.Fl k
-option.
-.It Fl K Ar pkg_dbdir
-Set
-.Ar pkg_dbdir
-as the package database directory.
-See the
-.Sx ENVIRONMENT
-section below for details on how the default value is calculated.
-.It Fl k
-Silently skip all packages that are marked as
-.Cm preserved .
-.It Fl N
-Remove the package's registration and its entries from the package database,
-but leave the files installed.
-Don't run any deinstall scripts or @unexec lines either.
-.It Fl n
-Don't actually deinstall a package, just report the steps that
-would be taken if it were.
-.It Fl O
-Only delete the package's entries from the package database, do not
-touch the package or its files itself.
-.It Fl p Ar destdir
-Prefix all file and directory names with
-.Ar destdir .
-For packages without install scripts this has the same behavior as
-using chroot.
-.It Fl p Ar prefix
-Set
-.Ar prefix
-as the directory in which to delete files from any installed packages
-which do not explicitly set theirs.
-For most packages, the prefix will
-be set automatically to the installed location by
-.Xr pkg_add 1 .
-.It Fl R
-Recursively remove all packages that were needed by the given packages
-and that have no other dependencies left.
-This option overrides the
-.Fl A
-flag.
-.It Fl r
-Recursively remove all packages that require one of the packages given.
-.It Fl V
-Print version number and exit.
-.It Fl v
-Turn on verbose output.
-.El
-.Sh TECHNICAL DETAILS
-.Nm
-does pretty much what it says.
-It examines installed package records in
-.Pa @pkgdbdir@/\*[Lt]pkg-name\*[Gt] ,
-deletes the package contents, and finally removes the package records
-(if an alternate package database directory is specified, then it
-overrides the
-.Pa @pkgdbdir@
-path shown above).
-.Pp
-If a package is required by other installed packages,
-.Nm
-will list those dependent packages and refuse to delete the package
-(unless the
-.Fl f
-option is given).
-.Pp
-If a package has been marked as a
-.Cm preserved
-package, it will not be able to be deleted
-(unless more than one occurrence of the
-.Fl f
-option is given).
-.Pp
-If a filename is given instead of a package name, the package of which
-the given file belongs to can be deleted if the
-.Fl F
-Flag is given.
-The filename needs to be absolute, see the output produced by the pkg_info
-.Fl aF
-command.
-.Pp
-If a
-.Cm deinstall
-script exists for the package, it is executed before and after
-any files are removed.
-It is this script's responsibility to clean up any additional messy details
-around the package's installation, since all
-.Nm
-knows how to do is delete the files created in the original distribution.
-The
-.Ic deinstall
-script is called as:
-.Bd -filled -offset indent -compact
-.Cm deinstall
-.Aq Ar pkg-name
-.Ar VIEW-DEINSTALL
-.Ed
-before removing the package from a view, and as:
-.Bd -filled -offset indent -compact
-.Cm deinstall
-.Aq Ar pkg-name
-.Ar DEINSTALL
-.Ed
-before deleting all files and as:
-.Bd -filled -offset indent -compact
-.Cm deinstall
-.Aq Ar pkg-name
-.Ar POST-DEINSTALL
-.Ed
-after deleting them.
-Passing the keywords
-.Ar VIEW-DEINSTALL ,
-.Ar DEINSTALL
-and
-.Ar POST-DEINSTALL
-lets you potentially write only one program/script that handles all
-aspects of installation and deletion.
-.Pp
-All scripts are called with the environment variable
-.Ev PKG_PREFIX
-set to the installation prefix (see the
-.Fl p
-option above).
-This allows a package author to write a script
-that reliably performs some action on the directory where the package
-is installed, even if the user might have changed it by specifying the
-.Fl p
-option when running
-.Nm
-or
-.Xr pkg_add 1 .
-The scripts are also called with the
-.Ev PKG_METADATA_DIR
-environment variable set to the location of the
-.Pa +*
-meta-data files, and with the
-.Ev PKG_REFCOUNT_DBDIR
-environment variable set to the location of the package reference counts
-database directory.
-If the
-.Fl P
-flag was given to
-.Nm ,
-.Ev PKG_DESTDIR
-will be set to
-.Ar destdir .
-.Sh ENVIRONMENT
-.Bl -tag -width PKG_DBDIR
-.It Ev PKG_DBDIR
-If the
-.Fl K
-flag isn't given, then the value of the
-.Ev PKG_DBDIR
-variable overrides the
-.Xr pkg_install.conf 5
-variable of the same name.
-If all of this fails to locate a value, then it typically defaults to
-.Pa @pkgdbdir@ .
-.It Ev PKG_REFCOUNT_DBDIR
-Location of the package reference counts database directory.
-The default location is the path to the package database directory with
-.Dq .refcount
-appended to the path, e.g.
-.Pa @pkgdbdir@.refcount .
-.El
-.Sh SEE ALSO
-.Xr pkg_add 1 ,
-.Xr pkg_admin 1 ,
-.Xr pkg_create 1 ,
-.Xr pkg_info 1 ,
-.Xr pkgsrc 7
-.Sh AUTHORS
-.Bl -tag -width indent -compact
-.It "Jordan Hubbard"
-most of the work
-.It "John Kohl"
-refined it for
-.Nx
-.It "Hubert Feyrer"
-.Nx
-wildcard dependency processing, pkgdb, recursive "down"
-delete, etc.
-.It Joerg Sonnenberger
-Rewrote most of the code to compute correct order of deinstallation
-and to improve error handling.
-.El