FreeBSD install - a package for the installation and maintainance
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
@(#)pkg_delete.1
The following command line options are supported.
-v Turns on verbose output. "Optional."
-D If an de-installation script exists for a given package, do not execute it. "Optional."
-n Don't actually de-install a package, just report the steps that would be taken if it was. "Optional."
"-p " prefix Sets prefix as the directory in which to delete files from any installed packages which do not explicitly set theirs. "Optional."
If the package contains a require file (see pkg_create ), then this is executed first with the flags
<script> pkg-name DEINSTALL
to see whether or not de-installation should continue (a non-zero exit status means no).
If a de-install script exists for the package, it is executed before any files are removed. It is this script's responsibility to clean up any additional messy details around the package's installation, since all pkg_delete knows how to do is delete the files created in the original distribution. The de-install script is called with the flags
<script> pkg-name DEINSTALL
Where pkg-name is the name of the package in question and DEINSTALL is a keyword denoting that this is a deinstallation. Passing the keyword lets you potentially write only one program/script that handles all aspects of installation and deletion.
All scripts are called with the environment variable PKG_PREFIX set to the installation prefix (see the -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 -p when pkg_add or pkg_delete is run.