NAME

patchrm − remove a Solaris 2.x patch package and restore previously saved files

SYNOPSIS

patchrm [ −f ] [ −B backout_dir ]

[ −C net_install_image | −R client_root_path | −S service ] patch_id

DESCRIPTION

patchrm removes a patch package and restores previously saved files to a Solaris 2.x system.  patchrm cannot be used with Solaris 1.x patches.  patchrm must be run as root. 

OPTIONS

The following options are supported:

−f Forces the patch removal regardless of whether the patch was superseded by another patch. 

−B backout_dir
Removes a patch whose backout data has been saved to a directory other than the package database. This option is only needed if the original backout directory, supplied to the patchrm command at installation time, has been moved.  Specify backout_dir as an absolute path name. 

−R client_root_path
Locates all patch files generated by patchrm under the directory client_root_path. client_root_path is the directory that contains the bootable root of a client from the server’s perspective.  Specify client_root_path as the absolute path name to the beginning of the directory tree under which all patch files generated from patchrm will be located.  −R cannot be specified with the −S option.  See NOTES. 

−S service
Specifies an alternate service (for example,  Solaris_2.3). This service is part of the server and client model, and can only be used from the server’s console. Servers can contain shared /usr file systems that are created by Host Manager.  These service areas can then be made available to the clients they serve.  −S cannot be specified with the −R option.  See NOTES. 

−C net_install_image
Removes the patched files located on the mini root on a Net Install Image created by setup_install_server.  Specify net_install_image as the absolute path name to a Solaris 2.6 or later Net Install Image created by setup_install_server. 

OPERANDS

The following operands are supported:

patch_id The patch number of a given patch.  104945-02 is an example of a patch_id.

EXAMPLES

The examples in this section assume that patch 104945-02 has been installed to the system prior to removal.  All of the examples are relative to the /usr/sbin directory. 

The following example removes a patch from a standalone system:

example# patchrm 104945-02

The following example removes a patch from a client’s system from the server’s console:

example# patchrm −R /export/root/client1 104945-02

The following example removes a patch from a server’s service area:

example# patchrm −S Solaris_2.3 104945-02

The following example removes a patch from a Net Install Image:

example# patchrm −C /export/Solaris_2.6/Tools/Boot 104945-02

EXIT STATUS

The following exit values are returned:

0 Successful completion. 

>0 An error occurred. 

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

SEE ALSO

cpio(1), pkginfo(1), patchadd(1M), pkgadd(1M), pkgchk(1M), pkgrm(1M), showrev(1M), attributes(5)

SunOS 5.6  —  Last change: 7 Oct 1996