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 both the SunView and the OpenWindows Application Environment software installation options, its appearance is not the same for both options. This man page you are viewing refers to the tapetool that is available with OpenWindows. The primary difference between this and the SunView tapetool application is the user interface. All OpenWindows standard tools use the Graphical User Interface ( GUI ). For more information about the OPEN LOOK UI, refer to the OpenWindows User’s Guide . 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
printtool accepts the generic tool arugments described in sunview(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 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/rmtn Half inch magnetic tapes drives
/dev/rarn Quarter inch tape drives
/dev/rstn 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/rmtn
Half-inch magnetic tape interface
/dev/rarn
Quarter-inch magnetic tape interface
/dev/rstn
SCSI tape interface
BUGS
See bugs for tar(1)
SEE ALSO
Solbourne Computer, Inc. — 1 September 1989