manpages.info - online man pages   

SunOS man pages : pkgrm (1)

Maintenance Commands                                    pkgrm(1M)

NAME

pkgrm - remove a package from the system

SYNOPSIS

pkgrm [ -nv ] [ -a admin ] [ [ -A | -M ] -R root_path ] [ -V fs_file ] [ pkginst ... ] pkgrm -s spool [ pkginst ... ]

DESCRIPTION

pkgrm will remove a previously installed or partially installed package from the system. A check is made to deter- mine 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 will permit keyboard interaction throughout the remo- val 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 administra- tion file. -A Remove the package files from the client's file sys- tem, absolutely. If a file is shared with other SunOS 5.8 Last change: 4 Feb 1999 1 Maintenance Commands pkgrm(1M) 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 interac- tion, the command will exit. Use of this option requires that at least one package instance be named upon invocation of the command. -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. -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 unreli- able.

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. SunOS 5.8 Last change: 4 Feb 1999 2 Maintenance Commands pkgrm(1M) The following example removes all instances of SUNWjunk from client1: example% pkgrm -R /export/root/client1 SUNWjunk*

EXIT STATUS

The following exit values are returned: 0 Successful execution. 1 Fatal error. 2 Warning. 3 Interruption. 4 Administration. 10 Reboot after removal of all packages. 20 Reboot after removal of this package.

ATTRIBUTES

See attributes(5) for descriptions of the following attri- butes: ____________________________________________________________ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | |_____________________________|_____________________________| | Availability | SUNWcsu | |_____________________________|_____________________________|

SEE ALSO

pkginfo(1), pkgmk(1), pkgparam(1), pkgproto(1), pkgtrans(1), installf(1M), pkgadd(1M), pkgask(1M), pkgchk(1M), removef(1M), admin(4),attributes(5) Application Packaging Developer's Guide SunOS 5.8 Last change: 4 Feb 1999 3