pkf

pkf file1 { file2 ... filen }

pkf prints a summary of the contents of the kf files file1... filen.

The output should be more or less self-documenting: all variables are listed by name, type (integer, real, character, logical) and size (number of array elements) and they are grouped together in named sections.

To put the results in an ASCII file for later inspection:

pkf file > ascii_result

Each section on the file contains an index of its variables and their associated values. All data are organized in blocks. Each section may have any number of index blocks and any number of data blocks (this depends simply on the amount of data to be stored in such a block). In addition there is one special section, the SuperIndex, which is an index of all sections on the file.

The output of pkf consists of:

• General information about the file (name of the file, internally used unit numbers during processing the file...)
• A summary of the SuperIndex: an index of blocks on the file and the sections they are associated with.
• A summary: total numbers of blocks associated with the different types of blocks.
• For each section a list of its variables with for each variable:
  • Its name.
  • Its length: the amount of space reserved on the file for the variable.
  • Its size ('used'): the amount of data associated with the variable; for reals, integers and logicals:
    the number of such elements; for strings: the number of characters.
  • The (logical) index of the data block it is stored on;
  • Off-set: its position within the data block in which it is stored;
  • Its value (for an array: the value of the first element);

Remark: 'length' and 'size' are usually the same, but not necessarily.