NAME

tapetool - OpenWindows tool for reading files from tape or archiving files to tape

SYNOPSIS

tapetool [ generic-tool-arguments ]

AVAILABILITY

This command is available with the OpenWindows environment. All OpenWindows standard tools use the Graphical User Interface ( GUI ).

DESCRIPTION

tapetool is an OpenWindows based XView application that uses the tar(1) command to write files to tape, extract files from tape or list the contents of a tape.

OPTIONS

generic-tool-arguments

tapetool accepts the generic tool arugments described in xview(7).

USAGE

tapetool is part of the OpenWindows user environment.

There are two windows associated with tapetool. The main window that appears when the tool is initially brought up is for writing files to tape. The read window appears when you `List' the contents of a tape or choose either `Read Selected' or `Read Entire List'.

`List...' panel-button brings up a `Tape Contents' window that lists the files on tape. Filenames can be added using the `File To Read' button. Filenames can be deleted using the scrolling list popup menu. It may take some time listing the entire contents of a tape if it contains many files. If you want to extract just a few files and know the exact names of the files you may want to do a `Read Selected' that will bring up an empty `Tape Contents' window. Then add the filenames to the list using the `File To Read' button and do a `Read Entire List'.

There are three ways to read files:

Read Selected
           Reads the files selected in the `Tape Contents' window.

Read Entire List

Reads all the files listed in the `Tape Contents' window.

Read Entire Tape

Reads the entire tape. The `Tape Contents' window does not have to be showing to do this. The files are put into the directory specified by the `Destination' field if they do not contain fully qualified pathnames.

To write files to tape, add filenames to the main scrolling list using the `File To Write' menu button. The main scrolling list has a popup menu for deleting selected files. `Write' writes the filenames listed in this window to tape.

Props gives a property sheet for specifying tar(1) options.

Device:
           /dev/rmt/n      SCSI tape drives
Host Name:

Specifies the name of host system where the reading or archiving of

files will be applied. The default is the current host name.

Tar Options
Write:
           No SCCS         F option to tar(1), exclude all directories named SCCS
                           from tarfile.
           No SCCS +       FF option to tar(1), exclude all directories named
                           SCCS, all files with .o as their suffix, and all files
                           named errs, core, and a.out .
           Block I/0       b option to tar(1), blocking factor for tape records.

The default blocking factor is 20 blocks. The block

size is determined automatically when reading

tapes. This determination of the blocking factor may

be fooled when reading from a pipe or a socket. The

maximum blocking factor is determined only by the

amount of memory available to tar when it is run.

Larger blocking factors result in better throughput,

longer blocks on nine-track tapes, and better media

utilization.

Sym Links

h option to tar(1), follow symbolic links as if they

were normal files or directories. Normally, tar does

not follow symbolic links.

Show Errs

l option to tar(1), Display error messages if all links

to archived files cannot be resolved. If not used, no

error messages are printed.

Suppress

o option to tar(1), Suppress information specifying

owner and modes of directories that tar normally

places in the archive.

Read:
           No Check        i option to tar(1), Ignore directory checksum errors.
           Mod Time        m option to tar(1), Do not extract modification times

of extracted files. The modification time will be the

time of extraction.

Orig Mode

p option to tar(1), Restore the named files to their

original modes, ignoring the present umask(2).

SetUID and sticky information are also extracted if

you are the super-user.

Delete Dir:

For writing files to tape

`NONE'

retains filename path exactly as specified.

`ALL '

Extracts the entire path from filename and

writes just the filename.

`PATTERN'

extracts the pattern specifed and writes the

filename left over.

Other:
           Err Exit              e option to tar(1), If any unexpected errors

occur tar aborts immediately with a positive

exit status.

Exclude

X option to tar(1), Specify a file containing a list

of named files (or directories) to be excluded

when reading from tape. Only one file can be

specified.

Apply

Menu button that applies the options that have been set.

Reset

Menu button that resets the defaults.

You may drag and drop files from filemgr(1) onto the tapetool write window for writing files to tape. You can also drop files onto the tapetool icon for writing.

FILES

/dev/rmt/n SCSI tape interface

BUGS

See bugs for tar(1)

SEE ALSO

tar(1), filemgr(1)

OpenWindows user documentation

"About Tape Tool" in the Help Handbook available through the Help option on the Workspace menu.