Content-type: text/html Manpage of PROFILETAPE

PROFILETAPE

Section: Misc. Reference Manual Pages (1L)
Updated: 24 July 1991
Index Return to Main Contents

NAME

profiletape - profile files on a tape (ao)

SYNOPSIS

profiletape [ -l label ] [ -i inputtape ] [ -o outputfile ] [ -m monrecs ]

DESCRIPTION

profiletape is a program to read a tape and output the record lengths and number of records for each file on the tape. The tape is read until two consecutive eofs are found. The program queries the user for the device name for the input tape (unless the -i option is used). The output is sent to stdout (or the file specified by the -o option).

The output consists of the current date and optional tape label followed by the information from each file on tape. For each file, the length of each record is printed out. Contiguous records with the same record length will be output as one line with the record count and record length.

OPTIONS

-l: xxxxxx
will print xxxxxx on the output header.
-i: inputtape
Read from tape device inputtape. If this option is not used, the program will prompt the user for the tape device name.
-o: outputfile
Send output to outputfile instead of to stdout.
-m: monrecs
If many records of the same length are being read, output an update of the current number of records in the file every monrecs records. The output will overwrite itself so you don't scroll off the page. If this option is not used, you will have to wait till the record length changes, or the end of the file before any output appears. This option will work best when the output is sent to the terminal. Overwriting a line to a disc file will not do what you want it to.

EXAMPLES

To profile a tape on /dev/nrmt8, send the output to junk.out, and print AO2345 as the tape name on the header use:

: profiletape -i /dev/nrmt8 -o junk.out -l AO2345

To profile a tape where the program prompts for the tape name and the output goes to the screen use:

: profiletape

FILES

~phil/util/profiletape.c location of source code

DIAGNOSTICS

Each read error on the tape will be printed on a separate line on the output.

BUGS

The program can read a maximum record length of 64k-1 bytes. You may have problems with the idiosyncracies of certain unix tape drives (exabyte, cartridge).

This document was created by man2html, using the manual pages.
Time: 21:00:09 GMT, November 03, 2010