rmfn(1M)

NAME

rmfn − remove HP-UX functionality (partitions and filesets)

SYNOPSIS

/etc/rmfn [-y] [-s series] [-l partition_or_fileset_list] [-o pre-Release_8.0_fileset_list] [-f file]

DESCRIPTION

rmfn is used to interactively or non-interactively remove functionality from a system in units of filesets or partitions.

If no options are specified, rmfn runs interactively, providing help screens to aid in selecting rmfn softkey options. If one or more options are specified, rmfn runs non-interactively as specified by the options given.

rmfn can only be executed by the super-user. It can be used while the system is running in multi-user mode, but only one instance of rmfn can be running on the system at a time.

In an HP Clustered environment, rmfn can only be run on the cluster server.

rmfn understands dependencies between filesets. It does not remove a fileset if it contains functions required by other filesets on the system that have not been selected for removal or cannot be removed.

During the removal process, if a file cannot be removed because it is busy (ETXTBSY), rmfn moves the file to #file and the user should remove this #file later.

Options

rmfn supports the following options when invoked non-interactively:

-l partition_or_fileset_list
Remove the partitions and/or filesets listed in the partition/fileset list. If two or more partitions and/or filesets are specified for removal, the entire list must be enclosed within a pair of double quotes ("). Each item in the list should have one of the following formats:

partition.fileset removes a fileset within a partition

partition removes all the filesets in a partition

fileset removes an individual fileset

-f file Read the list of filesets or partitions to be removed from the specified file, rather than from the command line (see -l option for the list format).

Blank lines and comments (lines beginning with #) in file are ignored.

-y Give rmfn permission to remove filesets that depend on filesets listed in the -l or -f options. rmfn removes filesets specified in the -l or -f options and all filesets that depend on them. If -y is not specified, rmfn checks dependencies for each fileset listed in the -l or -f options, and does not remove the fileset if it is required by any other filesets on the system that either are not also listed for removal or cannot be removed.

-s series Specify the system type (300 (for Series 300 or 400), 700, or 800) for the filesets listed in the -l or -f options. If -s is not specified, the default is the type of the system on which rmfn is run.

-o fileset_list Remove pre-Release-8.0 filesets specified in the fileset list. Filesets prior to HP-UX Release 8.0 did not contain any dependency information. To accommodate filesets that may have been installed prior to 8.0, this option prevents rmfn from checking dependencies on pre-8.0 filesets before removal. However, rmfn is not allowed to remove fileset UX_CORE and fileset TOOL. If two or more partitions and/or filesets are specified for removal, the entire list must be enclosed within a pair of double quotes ("). The format is:

fileset remove an individual fileset

\* remove all pre-8.0 filesets

NOTE: The * must be escaped in the command line to prevent its expansion by the shell.

Mounted Volumes and Symbolic Links

rmfn does not remove files under directories on read-only file systems or remotely mounted file systems. rmfn requires that all the disks listed in /etc/checklist be mounted (disks must be listed in /etc/mnttab).

rmfn does not produce any error messages if an attempt is made to remove remote files.

rmfn does not follow symbolic links. If an entry in an /etc/filesets file is a symbolic link, rmfn removes the symbolic link but leaves the link target intact. If an entry in the fileset file is an ordinary file or a hard link, the file or link is removed but any symbolic links to the file or hard link, if they exist, are left unresolved.

HP Clustered Environment

In a heterogeneous cluster (containing systems of dissimilar architecture), when removing a fileset from the server for a given architecture, if the fileset contains files that are also used by the other architecture but the corresponding fileset for the other architecture is being left on the system, then rmfn does not remove those shared files.

rmfn removes empty context-dependent file (CDF) directories.

Kernel Reconfiguration

If a removed fileset contains a piece of the kernel, a message warning the user to reconfigure the kernel is displayed and also recorded in the log file. However, rmfn does not modify any of the kernel generation files.

Recovering Removed Functionality

To recover functionality that was previously removed, use update (see update(1M)).

Index File

Any fileset being removed by rmfn must have entries in the /system and /etc/filesets directories. A fileset whose index file resides in directory /system/fileset can be removed interactively or non-interactively by specifying the -l or -f option in the command line. A fileset that does not have an index file in directory /system/fileset is treated as a pre-Release-8.0 fileset. It can be removed by using the -o command line option for non-interactive execution.

RETURN VALUE

rmfn returns the following values:

0 rmfn ran successfully to completion.

1 an error occurred and no files were removed.

2 an error occurred and some filesets might have been removed; review the log file for details (see FILES below)

DIAGNOSTICS

Messages displayed during interactive execution and error messages resulting from invalid non-interactive invocation are self-explanatory. For information about any failures encountered while removing filesets, inspect the log file (see FILES below).

EXAMPLES

Remove filesets ARABIC and CHINESE from the system.

rmfn -l ARABIC CHINESE

Remove all Series 300 system filesets listed in file /tmp/remove.in.

rmfn -s 300 -f /tmp/remove.in

Remove Series 800 system fileset NLIO-MIN and all other filesets on the system that depend on it.

rmfn -s 800 -l NLIO-MIN -y

Remove Release 7.0 fileset FORTRAN from the system.

rmfn -o FORTRAN

Remove all Series 300 Release 7.0 filesets on the system.

rmfn -o \* -s 300

WARNINGS

Always review the log file after a removal for relevant warnings, errors, and messages.

In the interactive mode, rmfn displays the size of each fileset on the system. rmfn also reports the amount of disk space freed after each fileset has been removed, and the total amount of disk space freed when the removal is completed. The size information is approximate.

Do not press the Print/Enter key and the Extend char key while running rmfn. Pressing these keys may cause unexpected results.

rmfn removes files, hard links, and symbolic links as they are encountered in the fileset file in /etc/filesets. However, if a fileset file created by an independent (non- HP ) party contains the names of one or more directories, the behavior of rmfn with respect to those directories is undefined.

Do not modify the /etc/filesets/fileset file at any time, and do not create, modify, or remove any files in directory /system/fileset. rmfn extracts fileset information from /etc/filesets/fileset files and uses the files in /system/fileset to ensure correct fileset removal.

AUTHOR

rmfn was developed by HP.

FILES

/etc/rmfn executable file

/tmp/rmfn.log log file describing the events that occurred during the rmfn process, including errors, warnings, notes, and messages

/etc/checklist list of volumes that should be mounted

/etc/mnttab list of volumes currently mounted

/etc/filesets/fileset files containing list of files for each fileset

/system/fileset directories containing files related to each fileset

Museum

Related Articles