NAME

fitset − determine if a subset fits on a system

SYNOPSIS

/usr/lbin/fitset [ −d ] [ root-path ]

DESCRIPTION

The fitset utility is used to determine if the 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 each record, fitset deducts one inode from the number available in the target file system.  For the space calculation, fitset deducts the file size specified by each record.  Only currently mounted UFS and NFS file systems are used in the computations. 

Space requirements for files already on the disk are adjusted 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 file space for all file systems affected and returns nonzero status if the remaining number of inodes or amount of free space for any of these file systems is overflowed.  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. 

FLAGS

−d Enable debugging.  This will make fitset print voluminous status information on standard output.  This information is 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. 

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/.smdb./OATDCB100.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/.smdb./ULTUUCP400.inv

ERRORS

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

fitset: cannot access path (error-message)
The 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 will be around nnn% full.
Installing the software specified will fill the path file system beyond 100%, thereby making it impossible for non-root users to write there.  This problem can have a serious impact on normal system operation. 

fitset:
file system path needs nnn Kbytes more to install the software specified. 
fitset:
file system path needs nnn more inodes to install the software specified. 
The file system path is out of space.  The message that is displayed indicates whether the error is insufficient space or a lack of available inodes.  If space is the issue, deleting files to make available barely the indicated amount of space might result in a “file system path will be around nnn% full” warning because the root user is permitted to fill a file system beyond 100%. 

fitset: file system path is not writable.
The mode of the file system named by path does not permit writing into the file system. 

FILES

/usr/.smdb./∗.inv Subset inventory files

/var/adm/smlogs/fitset.log
Log file

RELATED INFORMATION

Commands:  setld(8)

File formats:  stl_inv(4)

Programming Support Tools