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 superuser can execute sysrm.

A fileset argument 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:

KERN_BLD
UX_CORE
TOOL
C_MIN
PROG_MIN

After removing all removable files in a fileset, sysrm removes the fileset file itself. 

HP Clustered Environment Features

In clustered systems, the −S option is available:

−S series Specify Series 300 (−S300) or Series 800 (−S800) to remove the fileset for an architecture other than the one on which sysrm is run.  This option is useful on the cluster server of a mixed-architecture diskless cluster. 

On a mixed-architecture-cluster server, the filesets directory is a context dependent file (CDF).  If a fileset is present for more than one architecture type (Series), only the files specific to that architecture’s fileset are removed.  Files shared between architectures, and CDF elements which appear in other architectures’ versions of the fileset file, are not removed. 

For CDF elements, list in the “noremove” file the explicit path to the element, not the name of the whole 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 superuser. 

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 NAMERICA and PC filesets:

sysrm NAMERICA PC

WARNINGS

The system should be in single-user mode when sysrm is executed.  Ensure that only init, sh, and other required processes are running.

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

update(1M). 

Hewlett-Packard Company  —  HP-UX Release 7.0: Sept 1989