TAPETOOL(1) — USER COMMANDS

NAME

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

SYNOPSIS

tapetool [ generic-tool-arguments ]

AVAILABILITY

Although this command is available with the OpenWindows Application Environment software installation options. For information about installing OpenWindows, refer to the OpenWindows Installation and Start-Up Guide.

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 arguments described in xview(1).

USAGE

tapetool is part of the OpenWindows user environment. For a description of the basic concepts of OpenWindows, see the OpenWindows User’s Guide.

There are two windows associated with tapetool, the main window and the read window. 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 ReadSelected or Read Entire List.

List... Brings up a TapeContents window that lists the files on tape. 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 you know the exact names of the files, you may use ReadSelected that will bring up an empty TapeContents window. Use ReadFileTo to put in the file names and then do a Read Entire List. File names can be added using File To Read. File names can be deleted using the scrolling list pop-up menu .ReadFunctions

SelectAll Selects all the files listed in the window.

DeselectAll
Removes the highlight (deselects) all the files you have selected.

DeleteSelected
Removes all the files you have selected.

Read The TapeContents 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 path names.

Selected Reads the files selected in the TapeContents window.

EntireList Reads all the files listed in the TapeContents window.

EntireTape
Reads the entire tape.

Write Writes the file names listed in the main window to tape.

WriteFileTo
Adds file names to the main window scrolling list. This list has a pop-up menu for deleting files.

WriteFunctions

DeselectSelected
Deletes the files you have selected.

DeselectAll
Deletes all the files displayed in the window.

Destination:
Specifies the directory for the location of files read from tape. This field is only used when the files on the tape do not have absolute path names.

Props Property sheet for specifying tar(1) options.

Device:

/dev/rmtn Half inch magnetic tapes drives

/dev/rarn Quarter inch tape drives

/dev/rstn SCSI tape drives

TarOptions

Write:

NoSCCS F option to tar(1). Excludes all directories named SCCS from tarfile.

NoSCCS+ FF option to tar(1). Excludes all directories named SCCS, all files with .o as their suffix, and all files named errs, core, and a.out.

BlockI/O b option to tar(1). This is the blocking factor for tape records. The default blocking factor is 20 blocks. The block size is determined automatically when reading tapes. The 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.

SymLinks h option to tar(1). Follows symbolic links as if they were normal files or directories. Normally, tar does not follow symbolic links.

ShowErrs l option to tar(1). Displays 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). Suppresses information specifying owner and modes and modes of directories that tar(1) normally places in the archive.

Read:

NoCheck i option to tar(1). Ignores directory checksum errors.

ModTime m option to tar(1). Do not extract modification times of extracted files. The modification time will be the time of extraction.

OrigMode p option to tar(1). Restores 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.

DeleteDir: 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 specified and writes the filename left over.

Other:

ErrExit e option to tar(1). If any unexpected errors occur, tar aborts immediately with a positive exit status.

Exclude X option to tar(1). Specifies a file containing a list of named files or directories to be excluded when reading from tape. Only one file can be specified.

Apply Applies the options that have been set.

Reset Resets the options to 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 Half-inch magnetic tape interface

/dev/rarn Quarter-inch magnetic tape interface

/dev/rstn SCSI tape interface

BUGS

See bugs for tar(1).

Museum