Name

fitset − determine if subset fits on a system

Syntax

/etc/stl/fitset [ −d ] [ root-path ]

Description

The fitset utility determines if files in a software subset will fit on a system.

The fitset utility reads subset inventory records from the standard input and calculates the number of inodes and the amount of disk space the subset requires.  For the inode calculation, fitset deducts one inode from the number available in the target file system for each inventory record.  For the disk space calculation, fitset deducts the file size specified by each inventory record. Only currently mounted UFS and NFS file systems are used in the computations.

The fitset utility adjusts space requirements for files already on the disk by using the difference between the specified size and the size of the file that is already present.

A given subset can include files that are to be installed in several file systems.  The fitset utility tracks inodes and disk space of all file systems affected and returns nonzero status if the required number of inodes or free space overflows those remaining. If there is no overflow, fitset returns a status of zero.

The setld utility uses fitset to size all subsets before attempting to install them. The root-path argument is the pathname of the top directory for the hierarchy into which the files are going to be installed. If no root-path is specified, the directory ’/’ is assumed. 

Options

−d Enable debugging. Directs fitset to print voluminous status information on the standard output. This information contains the initial file system statistics, the file system location of the file from each input record, and the statistics for the file system after the space required to install the file has been deducted.

Restrictions

If there are not enough free inodes in an NFS-mounted file system, fitset does not report a problem.  As a result, a subset can fail to install.

Examples

To determine if a particular subset will fit on the system, redirect the contents of the subset inventory file into fitset. For example:

fitset < /usr/etc/subsets/ULTUUCP400.inv

To determine if the same subset will fit in a hierarchy rooted at /var/tmp/root, the command would be:

fitset /var/tmp/root < /usr/etc/subsets/ULTUUCP400.inv

Diagnostics

fitset: root path must be absolute
A relative pathname was specified for root-path.  This path must be absolute. 

fitset: cannot stat root-path (error message)
The root-path cannot be accessed. The error message provides more information. 

fitset: root-path is not a directory. 
Either root-path is not a directory or it is a symbolic link to something which is not a directory. 

fitset: <WARNING> path is a symbolic link to itself
The path is a symbolic link that involves cyclic linking.

fitset: file system path is out of space, blocks (1024) = xxx, inodes = yyy. 
The file system path is out of space. The numbers of remaining 1024-byte blocks and inodes are shown as xxx and yyy respectively. 

fitset: file system path is not writable
The file system path is an NFS-mounted file system that allows no write access.

Files

/usr/etc/subsets/*.inv

See Also

setld(8)
Guide to Preparing Software for Distribution on ULTRIX Systems