HP-UX Reference (11i v2 04/09) - 1 User Commands A-M (vol 1)

f
ftio(1) ftio(1)
-T tty Specify alternative to /dev/tty. Normally
/dev/tty is opened by ftio when
terminal interaction is required.
-Z nobufs Specify the number of blksize chunks of memory to use as buffer space between the
two processes, where blksize is the size of blocks written to the tape. More chunks
is usually better, but a point is reached where no improvement is gained, and per-
formance might deteriorate as buffer space is swapped out of main memory. A
default value of 16 is set for nobufs, but using 32 or 64 might improve performance
if your system is not heavily loaded. Best results are obtained when backups are
performed with the system in single-user mode (see shutdown(1M)).
Modifiers
The following modifiers can be used with certain options as indicated in the
SYNOPSIS:
a After files are copied to tape, reset their access time to appear as though the files were not
accessed by ftio.
c Write header information in
ASCII character form, for portability.
d When restoring files, create directories as needed.
f Copy in all files except those that match patterns .
h Archive the files to which symbolic links point, as if they were normal files or directories.
By default, ftio archives the link itself.
m Retain previous file modification time and ownership of file. Restoring modification time
does not apply to directories that are being restored.
p At the end of the backup, print the number of blocks transferred, the total time taken
(excluding tape rewind and reel-change time), and the effective transfer rate calculated
from these figures. These values are printed at the end of each tape if p
is specified twice.
t Print only a table of contents of the input. No files are created, read, or copied.
u Copy unconditionally (by default,
ftio does not replace a newer file with a older file of the
same name).
v Be verbose. Print a list of file names and tape headers. When used with the
t modifier,
the table of contents looks the same as the output of the
ls -l (ell) command (see ls(1)).
x Save or restore device special files. ftio uses mknod(2) to recreate these files during a
restore operation. Thus, this modifier is restricted to users with appropriate privileges.
This is intended for intrasystem (backup) use. Restoring device files onto a different system
can be very dangerous.
A If copying from tape (-i or -I option), print all file names found on the tape archive, not-
ing which files have been restored. This is useful when the user restores selected files, but
wants to know which (if any) files are on the tape.
If copying to tape (
-o or -O option), the A modifier suppresses warning messages regard-
ing optional access control list entries. ftio(1) does not back up optional access control list
entries in a file’s access control list (see acl(5)). Normally, a warning message is printed for
each file that has optional access control list entries.
E When archiving, store all files having absolute path names (that is, path names beginning
with /) with path names relative to the root directory (in other words, remove the leading
/). On restoration, any files in the archive that had an absolute path name before archiv-
ing are restored relative to the current directory.
L Same as the -L option, except that the file list is left in the current directory as the file
ftio.list, instead of the file named in filelist .
P On restoration, use prealloc() to allocate disk space beforehand for the file (see preal-
loc(2)). This vastly improves the localization of file fragments.
When end-of-tape is reached,
ftio invokes script if the -S option was specified, rewinds the current
tape, then asks the user to mount the next tape.
To pass one or more metacharacters to
ftio without having the shell expand them, protect them either
by preceding each of them with a backslash (as in /usr\*), or enclosing them in protective single quotes
(as in ’/usr*’).
Section 1−−320 Hewlett-Packard Company − 3 − HP-UX 11i Version 2: September 2004