pkgrm(1M)

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, 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 an abbreviation for the package/set name. (The term ``package instance'' is used loosely: it refers to all instantiations of pkginst, even those that do not include instance identifiers.) See pkginfo(1) and 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.

To indicate all instances of a package, specify 'pkginst.*', 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.

/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)