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