ContentsIndexPreviousNext

Examining File Information

The "-info" function of vutil returns basic information about Vision indexed files. The command syntax is:

vutil  -info  [-kpqx]  [files]

Without files, standard input is read. If the "-p" option is used, then vutil pauses between files and prompts the user for a "return" key. Otherwise all the reports are run together. The "-k" option prints full details about each key, including the exact layout of a multi-segment, or split, key. The "q" option causes vutil to exit if user interaction is required. Each segment is expressed as a pair of numbers--segment size (sz) and the offset (of). The "-x" option causes vutil to report additional information.

This is the basic information provided by "-info":

* comment

* Vision version #

* # of records

* # of deleted records

* file size of segment (name of segment) (Version 4 only)

* total file size of all segments combined (Version 4 only)

* segment (size) (Version 4 only)

* record size (min/max)

* # of keys

* user count

If you request extended information with the "-x" option, you also see:

* for each key: key size (total size and # of segments, if split); key offsets; are duplicates allowed

* block size

* blocks per granule

* tree height (max/min/avg)

* # of nodes

* # of deleted nodes

* total node space

* node space used