f

ftio(1)

ftio(1)

-Znobufs 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 performance 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)).

Modi®ers

The following modi®ers can be used with certain options as indicated in the SYNOPSIS:

aAfter ®les are copied to tape, reset their access time to appear as though the ®les were not accessed by ftio.

cWrite header information in ASCII character form, for portability.

dWhen restoring ®les, create directories as needed.

fCopy in all ®les except those that match patterns.

hArchive the ®les to which symbolic links point, as if they were normal ®les or directories. By default, ftio archives the link itself.

mRetain previous ®le modi®cation time and ownership of ®le. Restoring modi®cation time does not apply to directories that are being restored.

pAt 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 ®gures. These values are printed at the end of each tape if p is speci®ed twice.

tPrint only a table of contents of the input. No ®les are created, read, or copied.

uCopy unconditionally (by default, ftio does not replace a newer ®le with a older ®le of the same name).

vBe verbose. Print a list of ®le names and tape headers. When used with the t modi®er, the table of contents looks the same as the output of the ls -l(ell) command (see ls(1)).

xSave or restore device special ®les. ftio uses mknod(2) to recreate these ®les during a restore operation. Thus, this modi®er is restricted to users with appropriate privileges. This is intended for intrasystem (backup) use. Restoring device ®les onto a different system can be very dangerous.

AIf copying from tape (-ior -Ioption), print all ®le names found on the tape archive, noting which ®les have been restored. This is useful when the user restores selected ®les, but wants to know which (if any) ®les are on the tape.

If copying to tape (-oor -Ooption), the A modi®er suppresses warning messages regarding optional access control list entries. ftio(1) does not back up optional access control list entries in a ®le's access control list (see acl(5)). Normally, a warning message is printed for each ®le that has optional access control list entries.

EWhen archiving, store all ®les 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 ®les in the archive that had an absolute path name before archiving are restored relative to the current directory.

LSame as the -Loption, except that the ®le list is left in the current directory as the ®le ftio.list, instead of the ®le named in ®lelist.

POn restoration, use prealloc() to allocate disk space beforehand for the ®le (see preal- loc(2)). This vastly improves the localization of ®le fragments.

When end-of-tape is reached, ftio invokes script if the -Soption was speci®ed, 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