unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



fitset(8)							    fitset(8)



NAME

  fitset - determines if a software subset fits	on a system

SYNOPSIS

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

OPTIONS

  -c  This switch allows a file	containing inventory records to	be passed in
      as an argument in	addition to the	standard input.	 When this option is
      specified, fitset	takes the inventory records in the file	and reclaims
      the file system space and	inodes they take up.

  -d  Enables debugging.  This option makes 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.

DESCRIPTION

  The fitset utility is	used to	determine if the files in a software subset
  will fit on a	system.

  The fitset utility reads software subset inventory records from the stan-
  dard input and calculates the	number of inodes and the amount	of disk	space
  the software subset requires.	 For each record, fitset deducts one inode
  from the number available in the target file system. For the space calcula-
  tion,	fitset deducts the file	size specified by each record.	Only
  currently mounted file systems are included 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 software 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 software subsets before attempt-
  ing 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.







ERRORS

    +  fitset: root-path must be absolute

       Explanation:

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

    +  fitset: cannot access path (error-message)

       Explanation:

       The path	cannot be accessed.  The error message provides	more informa-
       tion.

    +  fitset: root-path is not	a directory.

       Explanation:

       Either root-path	is not a directory or it is a symbolic link to some-
       thing which is not a directory.

    +  fitset: <&lt;warning>&gt; path is a symbolic link to itself

       Explanation:

       The path	is a symbolic link that	involves cyclic	linking.

    +  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.

       Explanation:

       The file	system path is out of space.  The message that is displayed
       indicates whether the error is insufficient space or a lack of avail-
       able inodes.

    +  fitset: file system path	is not writable.

       Explanation:

       The mode	of the file system named by path does not permit writing into
       the file	system.

EXAMPLES

   1.  To determine if a particular software subset will fit on	the system,
       redirect	the contents of	the software subset inventory file into
       fitset. For example:
	    fitset <&lt; /usr/.smdb./OSFEMACS350.inv

   2.  To determine if the same	software subset	will fit in a hierarchy
       rooted at /var/tmp/root,	the command would be:
	    fitset /var/tmp/root <&lt; /usr/.smdb./OSFMANOP350.inv

   3.  To determine if a particular software subset will fit on	the system
       after the removal of another software subset, the command would be:
	    fitset -c /usr/.smdb./OSFMANOS350.inv <&lt; /usr/.smdb./OSFMANOP350.inv






FILES

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

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

SEE ALSO

  Commands: setld(8)

  Files: stl_inv(4)

  Guide	to Preparing Product Kits