PKGRM(8) Maintenance Commands and Procedures PKGRM(8)

NAME

pkgrm - remove a package from the system

SYNOPSIS

pkgrm [-nv] [-a admin] [ [-A | -M] -R root_path]
[-V fs_file]
[pkginst... | -Y category[,category...]]


pkgrm -s spool
[pkginst... | -Y category[,category...]]

DESCRIPTION

pkgrm will remove a previously installed or partially installed
package from the system. A check is made to determine if any other
packages depend on the one being removed. If a dependency exists, the
action taken is defined in the admin file.


The default state for the command is in interactive mode, meaning
that prompt messages are given during processing to allow the
administrator to confirm the actions being taken. Non-interactive
mode can be requested with the -n option.


The -s option can be used to specify the directory from which spooled
packages should be removed.


Certain unbundled and third-party packages are no longer entirely
compatible with the latest version of pkgrm. These packages require
user interaction throughout the removal and not just at the very
beginning.


To remove these older packages (released prior to Solaris 2.4), set
the following environment variable:NONABI_SCRIPTS=TRUE pkgrm permits
keyboard interaction throughout the removal as long as this
environment variable is set.

OPTIONS

The following options are supported:

-a admin

Use the installation administration file, admin, in place of the
default admin file. pkgrm first looks in the current working
directory for the administration file. If the specified
administration file is not in the current working directory,
pkgrm looks in the /var/sadm/install/admin directory for the
administration file.


-A

Remove the package files from the client's file system,
absolutely. If a file is shared with other packages, the default
behavior is to not remove the file from the client's file system.


-M

Instruct pkgrm not to use the $root_path/etc/vfstab file for
determining the client's mount points. This option assumes the
mount points are correct on the server and it behaves
consistently with Solaris 2.5 and earlier releases.


-n

Non-interactive mode. If there is a need for interaction, the
command will exit.

Use of this option requires that at least one package instance be
named upon invocation of the command. Certain conditions must
exist for a package to be removed non-interactively or a non-
restrictive admin file needs to be used.


-R root_path

Defines the full path name of a directory to use as the
root_path. All files, including package system information files,
are relocated to a directory tree starting in the specified
root_path.

Note -

The root file system of any non-global zones must not be
referenced with the -R option. Doing so might damage the global
zone's file system, might compromise the security of the global
zone, and might damage the non-global zone's file system. See
zones(7).


-s spool

Remove the specified package(s) from the directory spool. The
default directory for spooled packages is /var/sadm/pkg.


-v

Trace all of the scripts that get executed by pkgrm, located in
the pkginst/install directory. This option is used for debugging
the procedural and non-procedural scripts.


-V fs_file

Specify an alternative fs_file to map the client's file systems.
Used in situations where the $root_path/etc/vfstab file is non-
existent or unreliable.


-Y category

Remove packages based on the value of the CATEGORY parameter
stored in the installed or spooled package's pkginfo(5) file. No
package with the CATEGORY value of system can removed from the
file system with this option.

OPERANDS

The following operand is supported:

pkginst

Specifies the package to be removed. The format pkginst.* can be
used to remove all instances of a package.

The asterisk character (*) is a special character to some shells
and may need to be escaped. In the C-Shell, "*" must be
surrounded by single quotes (') or preceded by a backslash (\).

EXAMPLES

Example 1: Removing All Instances of SUNWjunk from client1

The following example removes all instances of SUNWjunk from client1:


example% pkgrm -R /export/root/client1 SUNWjunk*


Note the caveat on the use of the -R option in the description of
that option, above.

EXIT STATUS

The following exit values are returned:

0

Successful completion.


1

Fatal error.


2

Warning.


3

Interruption.


4

Administration.


10

Reboot after removal of all packages.


20

Reboot after removal of this package.

SEE ALSO

pkginfo(1), pkgmk(1), pkgparam(1), pkgproto(1), pkgtrans(1),
admin(5), pkginfo(5), attributes(7), largefile(7), installf(8),
pkgadd(8), pkgask(8), pkgchk(8), removef(8)

NOTES

Package commands are largefile(7)-aware. They handle files larger
than 2 GB in the same way they handle smaller files. In their current
implementations, pkgadd(8), pkgtrans(1) and other package commands
can process a datastream of up to 4 GB.

October 30, 2007 PKGRM(8)