pkg_delete.1 revision 327

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

pkg_delete 1 "July 18, 1993" "" "FreeBSD"
NAME
pkg_delete - a utility for deleting previously installed software package distributions.
SYNOPSIS
pkg_delete [options] "pkg-name [.. pkg-name]"
DESCRIPTION
The pkg_delete command is used to delete packages that have been previously installed with the pkg_add command.
OPTIONS

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."

"TECHNICAL DETAILS"
pkg_delete does pretty much what it says. It looks for a package in /var/db/pkg and sets about deleting the files that make up the package and, finally, the record of the package itself.

If the package contains a require file (see pkg_create ), then this is executed first with the flag 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.

BUGS
Sure to be some.
"SEE ALSO"
pkg_create "(" 1 ")," pkg_info "(" 1 ")," pkg_add "(" 1 "),"
AUTHORS
Jordan Hubbard