ftio(1)

ftio(1)

cpio Compatibility

ftio uses the same archive format as cpio. However, by default ftio creates tape headers and uses a tape block size of 16KB. cpio by default uses 512-byte blocks. When used with the -Boption, cpio uses 5120 byte blocks. To achieve full compatibility with cpio in either input or output mode, the user should specify the M modi®er. ftio -oMcreates a single- or multi-tape archive that has no tape headers, and, by default, the same block size as cpio -[o⏐i]B. An archive created by a cpio -oBcommand can be restored using ftio -iM. If the M modi®er of ftio is combined with a -B 512 block-size speci®cation, full compatibility with cpio -[o⏐i] (no -B) is achieved.

EXTERNAL INFLUENCES

Environment Variables

LC_COLLATE determines the collating sequence used in evaluating pattern matching notation for ®le name generation.

LC_CTYPE determines the characters matched by character class expressions in pattern matching nota- tion.

LC_TIME determines the format and contents of date and time strings.

LANG determines the language in which messages are displayed.

If LC_COLLATE, LC_CTYPE, or LC_TIME is not speci®ed in the environment or is set to the empty string, the value of LANG is used as a default for each unspeci®ed or empty variable. If LANG is not speci®ed or is set to the empty string, a default of C (see lang(5)) is used instead of LANG. If any internationalization variable contains an invalid setting, ftio behaves as if all internationalization variables are set to C. See environ(5).

International Code Set Support

Single-byte character code sets are supported.

EXAMPLES

Copy the entire contents of the ®le system (including special ®les) onto tape drive /dev/rmt/c0t0d0BEST:

ftio -ox /dev/rmt/c0t0d0BEST /

Restore all the ®les on /dev/rmt/c0t0d0BEST, relative to the current directory:

ftio -idxE /dev/rmt/c0t0d0BEST

List the contents of a backup set created using ftio -o. Note that use of the v modi®er gives a more detailed listing, and displays the contents of tape headers.

ftio -itv /dev/rmt/c0t0d0BEST

Show how to use the .ftiorc ®le:

Assume a .ftiorc ®le exists in the user's home directory and contains the following:

# Sample .ftiorc file.

I= cdmuvEpp -B 16k -S /usr/local/bin/ftio.change

O= cavEpp -Z 8 -B 16k -S /usr/local/bin/ftio.change

Invoke ftio with the following command line to back up the user's home directory and the operating system commands directory:

ftio -O /dev/rmt/c0t0d0BEST /home/my_home /usr/sbin

Specifying the -Ooption causes ftio to check the .ftiorc ®le for additional options. In this case, character headers are generated, access times are reset, a listing of the ®les copied are printed to standard output, all ®le names are copied to /dev/rmt/c0t0d0BEST with path names relative to /, performance data is printed when the backup is complete (and at every tape change), and, if the backup goes beyond one media the script, /usr/local/bin/ftio.change is invoked by ftio after each media is completed.

WARNINGS

Because of industry standards and interoperability goals, ftio does not support the archival of ®les larger than 2GB or ®les that have user/group IDs greater than 60K. Files with user/group IDs greater than 60K are archived and restored under the user/group ID of the current process.

HP-UX Release 11i: December 2000

− 4 −

Section 1−293

f