HP-UX Reference (11i v1 00/12) - 1 User Commands A-M (vol 1)

__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man1/!!!intro.1
________________________________________________________________
___ ___
f
ftio(1) ftio(1)
-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 perfor-
mance 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, noting
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 regarding
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 archiving 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−−292 − 3 − HP-UX Release 11i: December 2000
___
___