pkgrm(1M) pkgrm(1M)
NAME
pkgrm - remove a package or set from the system
SYNOPSIS
pkgrm [-n] [-a admin] [pkginst1 [pkginst2[. . .]]]
pkgrm -s spool [pkginst]
DESCRIPTION
pkgrm will remove a previously installed or partially
installed package/set from the system. A package is a
collection of related files and executables that can be
independently installed. A set is made up of a special-
purpose package, referred to as a Set Installation Package
(SIP), and a collection of one or more packages that are
members of the set.
pkgrm checks that all packages listed on the command line are
on the system. If any of the packages listed does not exist,
no changes are made to the system, that is, none of the listed
packages are removed.
A check is also made to determine if any other packages depend
on the one being removed. The action taken if a dependency
exists is defined in the admin file (see the -a option,
below).
The default state for the command is 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.
The options and arguments for this command are:
-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.
-a admin Defines an installation administration file,
admin, to be used in place of the default
administration file. [For a description of the
format of an admin file, see admin(4).] The
token none overrides the use of any admin file,
Copyright 1994 Novell, Inc. Page 1
pkgrm(1M) pkgrm(1M)
and thus forces interaction with the user.
Unless a full pathname is given, pkgrm looks in
the /var/sadm/install/admin directory for the
file. By default, the file default in that
directory is used.
-s spool Removes the specified package(s) from the
directory spool.
pkginst A short string used to designate a package/set.
It is composed of one or two parts: pkg (an
abbreviation for the package/set name) or, if
more than one instance of that package exists,
pkg plus inst (an instance identifier). (The
term ``package instance'' is used loosely: it
refers to all instantiations of pkginst, even
those that do not include instance identifiers.)
The package name abbreviation (pkg) is the
mandatory part of pkginst. [See pkginfo(1),
pkginfo(4).]
If pkginst specifies a SIP, all installed
packages which are members of the set, and the
SIP itself, are removed in reverse dependency
order.
The second part (inst), which is required only if
you have more than one instance of the package in
question, is a suffix that identifies the
instance. This suffix is either a number
(preceded by a period) or any short mnemonic
string you choose. If you don't assign your own
instance identifier when one is required, the
system assigns a numeric one by default. For
example, if you have three instances of the
Advanced Commands package and you don't create
your own mnemonic identifiers (such as old and
beta), the system adds the suffixes .2 and .3 to
the second and third packages, automatically.
To indicate all instances of a package, specify
enclosing the command line in single quotes, as
shown, to prevent the shell from interpreting the
* character. Use the token all to refer to all
packages available on the source medium.
Copyright 1994 Novell, Inc. Page 2
pkgrm(1M) pkgrm(1M)
/usr/lib/locale/locale/LC_MESSAGES/uxpkg
language-specific message file [See LANG on
environ(5).]
Exit Codes
0 Successful completion of script.
1 Fatal error. Installation process is terminated at this
point.
99 Internal error.
REFERENCES
admin(4), compver(4), copyright(4), depend(4), installf(1M),
pkgadd(1M), pkgask(1M), pkgchk(1M), pkginfo(1), pkginfo(4),
pkgmap(4), pkgmk(1), pkgparam(1), pkgproto(1), pkgtrans(1),
removef(1M), setinfo(4), space(4)
Copyright 1994 Novell, Inc. Page 3