sysrm(1M)
NAME
sysrm − remove optional HP-UX products (filesets)
SYNOPSIS
/etc/sysrm [−S series] fileset ...
DESCRIPTION
sysrm removes all files associated with an optional product (fileset) from an HP-UX file system. This is usually done to recover mass storage space. Only the super-user can execute sysrm.
Note: sysrm functionality is subsumed by rmfn(1M) beginning with the 8.0 release of HP-UX. sysrm will continue to be supported temporarily.
fileset is the name of a file in the filesets directory that contains a list of files (path names) associated with the product being removed. sysrm processes these path names relative to the current working directory. Normally, each line in a fileset file is an absolute path name, so the present working directory is irrelevant.
sysrm does not remove files listed in the “noremove” file (see FILES below). Also, it does not remove any directories, nor any files in filesets required for a minimum system:
UX_CORE (7.0 release)
UX-CORE (8.0 release)
TOOL
CORE-SHLIBS (8.0 release)
After removing all removable files in a fileset, sysrm removes the fileset file itself.
sysrm cannot remove fileset packages loaded by updist(1M). To remove updist-package files, run rm −r on the package directories under the netdist source tree, and edit the central package definition file to comment out or delete the references to the package.
HP Clustered Environment Features
On clustered systems, the −S option is available:
−Sseries Specify Series 300/400 (−S300) or Series 700/800 (−S800) to remove the fileset for a system type (series) other than the one on which sysrm is run. This option is useful on the cluster server when the cluster contains systems having dissimilar architectures.
On a mixed-architecture-cluster server, the filesets directory is a context dependent file (CDF). If a fileset is present for more than one system type, only the files specific to that system type’s fileset are removed. Files shared between system types and CDF elements that appear in other system types’ versions of the fileset file are not removed. Normally, each line in a fileset file is an absolute path name with CDF elements explicitly stated. The −S option selects the fileset file; it does not select the elements of the files to remove.
For CDF elements, list in the “noremove” file the explicit path to the element, not the name of the entire CDF. Otherwise sysrm uses its process context, not the −S option, to distinguish the elements.
When sysrm removes the last element of a CDF, it also removes the CDF.
RETURN VALUE
sysrm returns 0 if it attempts to read any filesets and remove any files, whether or not it succeeds. It returns 1 if it detects any invocation errors, such as being run with no arguments or by other than the super-user.
DIAGNOSTICS
sysrm prints to standard output each file name to be removed before removing it. It prints to standard error a warning message in each case where it cannot open a specified fileset file.
EXAMPLES
Remove the AMERICAN and NETIPC filesets:
sysrm AMERICAN NETIPC
WARNINGS
None of the files being removed should be in use when sysrm is executed. To ensure this, put the system in single-user state first.
AUTHOR
sysrm was developed by HP.
FILES
/etc/filesets directory where fileset lists are kept
/etc/filesets/noremove optional file containing file names that must not be removed from the system
SEE ALSO
Hewlett-Packard Company — HP-UX Release 8.05: June 1991