Command Reference Guide

__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man1/!!!intro.1
________________________________________________________________
___ ___
f
ftio(1) ftio(1)
NAME
ftio - faster tape I/O
SYNOPSIS
ftio -o-O [achpvxAELM][-B blksize][-D type][-e extarg][-K comment][-L filelist]
[-N datefile][-S script][-T tty][-Z nobufs] tapedev [pathnames][-F ignorenames]
ftio -i-I [cdfmptuvxAEMPR][-B blksize][-S script][-T tty][-Z nobufs] tapedev [patterns]
ftio -g [v] tapedev [patterns]
DESCRIPTION
ftio is a tool designed specifically for copying files to tape drives. It performs faster than either cpio or
tar in comparable situations(see cpio(1) and tar(1)). ftio uses multiple processes (to read/write the file
system and to write/read the tape device), with large amounts of memory sharing between processes as
well as a large block size for reading and writing to the tape.
ftio is compatible with cpio in that output from cpio is always readable by ftio, and output from
ftio is readable by cpio, except as explained in the "cpio Compatibility" section, later in the manpage.
ftio must be invoked with exactly one of the following options:
-o, -O, -i, -I,or-g. The -o and -O
options specify that ftio is writing "out" from file system to tape; the
-i and -I options specify that
ftio is writing "in" from tape to file system. The -o, -O,
-i, and -I options can be followed by modifiers
that must appear immediately after the option with no spaces between the option and the modifier, as in
ftio -idxE (see Modifiers section below).
tapedev specifies the name of a device special file for the tape device to which the output is written. A dev-
ice on a remote machine can be specified in the form
machine:device_special_file
ftio creates a server process from /usr/sbin/rmt
on the remote machine to access the tape device.
If
/usr/sbin/rmt does not exist on the remote system,
ftio creates a server process from
/etc/rmt, on the remote machine to access the tape device.
Options
ftio recognizes the following options:
-o Copy (out) files from the file system to tapedev, including path name and status infor-
mation. If pathnames are specified, ftio recursively descends pathnames looking
for files, and copies those files to tapedev.Ifpathnames are not specified,
ftio
reads the standard input to obtain a list of path names to copy. ftio can copy to
multiple tapes if required. For every tape used,
ftio generates a tape header con-
taining the current tape volume number, machine node name and type, operating sys-
tem name, release and version numbers (all from the uname() system call; see
uname(2)), username of the person issuing the ftio command, the time and date the
command was executed, the number of consecutive times the current media has been
used, a comment field, and other items used internally by ftio. The tape header is
separated from the main body of the tape archive by an end-of-file mark. The tape
header can be read by invoking cat with the device file name as the first argument
(see cat(1)). Note, character and block device special files written with the -o option
are not transportable to other
HP-UX implementations.
-O Copy out files in the same way as ftio -ocva, when no modifiers are used with the
-O. However, if the .ftiorc file exists in the user’s home directory,
ftio opens
this file and scans for lines preceded by
O=. Options defined on matching lines are
passed to ftio as if they had been specified on the command line. See EXAMPLES
section.
-i Extract (copy into the file system) files from tapedev, which is assumed to be a tape
and the product of a previous ftio -o operation. Only files with names that match
patterns, according to the rules of Pattern Matching Notation (see regexp(5)), are
selected. In addition, a leading ! within a pattern indicates that only those names
that do not match the remainder of the pattern should be selected. Multiple patterns
can be specified. If no patterns are specified, the default for patterns is
* (that is,
select all files). The extracted files are conditionally created and copied into the
current directory tree, based upon the options described below. The permissions of
Section 1290 1 HP-UX Release 11i: December 2000
___
___